) => {
+ const dataSource = makeDataSource() as any;
+ render(
+
+
+ ,
+ );
+ const trigger = screen.queryByTestId('view-switcher-dropdown');
+ if (trigger) fireEvent.click(trigger);
+ };
+
+ /**
+ * Find a visualization option by accessible name, in either switcher form —
+ * the inline segmented control exposes `role="tab"`, the collapsed dropdown
+ * plain buttons. Mirrors `ListView.test.tsx`'s helper.
+ */
+ const queryViewOption = (name: string) =>
+ screen.queryByRole('tab', { name }) ?? screen.queryByRole('button', { name });
+
+ it('offers `map` when the binding is in the view-level block', () => {
+ renderSwitcher({
+ appearance: { allowedVisualizations: ['grid', 'map'] },
+ map: { locationField: 'geo' },
+ });
+
+ expect(queryViewOption('Map')).toBeTruthy();
+ });
+
+ it('CONTROL: `options.map` alone still resolves the capability', () => {
+ renderSwitcher({
+ appearance: { allowedVisualizations: ['grid', 'map'] },
+ options: { map: { locationField: 'geo' } },
+ });
+
+ expect(queryViewOption('Map')).toBeTruthy();
+ });
+
+ it('CONTROL: no binding anywhere leaves `map` unresolvable', () => {
+ renderSwitcher({ appearance: { allowedVisualizations: ['grid', 'map'] } });
+
+ expect(queryViewOption('Map')).toBeNull();
+ });
+
+ it('resolves a binding SPLIT across the two sources, the way it will render', () => {
+ // The gate asks the merged config, so a split lat/lng pair is judged the
+ // same way the render seam resolves it. Asking `options.map` alone said
+ // "not resolvable" while the seam would have rendered it fine.
+ renderSwitcher({
+ appearance: { allowedVisualizations: ['grid', 'map'] },
+ options: { map: { latitudeField: 'lat' } },
+ map: { longitudeField: 'lng' },
+ });
+
+ expect(queryViewOption('Map')).toBeTruthy();
+ });
+});
diff --git a/packages/plugin-map/package.json b/packages/plugin-map/package.json
index c4d6e79a56..8411170892 100644
--- a/packages/plugin-map/package.json
+++ b/packages/plugin-map/package.json
@@ -46,6 +46,7 @@
"react-dom": "^18.0.0 || ^19.0.0"
},
"devDependencies": {
+ "@object-ui/plugin-list": "workspace:*",
"@types/react": "19.2.18",
"@types/react-dom": "19.2.4",
"@vitejs/plugin-react": "^6.0.5",
diff --git a/packages/plugin-map/src/ObjectMap.listViewMapConfigReach.test.tsx b/packages/plugin-map/src/ObjectMap.listViewMapConfigReach.test.tsx
new file mode 100644
index 0000000000..2ef89a5879
--- /dev/null
+++ b/packages/plugin-map/src/ObjectMap.listViewMapConfigReach.test.tsx
@@ -0,0 +1,211 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * objectui#5042 — the END of the chain: a view-level `map` block authored on a
+ * list view reaches `getMapConfig` intact and drives its reads.
+ *
+ * `ListView.mapViewLevelConfig.test.tsx` (plugin-list) pins the forward itself,
+ * against a spy. A spy can only ever show that a prop was PASSED, and this card
+ * is not about a prop — the reported symptom was `undefined` marker titles, one
+ * read site downstream of a config that never arrived. So this file drives the
+ * real `ListView` into the real `ObjectMap` and asserts what an author would
+ * see: the markers, their titles, and the camera.
+ *
+ * Two things make that seam worth its own test rather than an assumed join:
+ *
+ * - `getMapConfig` reaches the flat form ONLY through
+ * `if (schema.locationField || schema.latitudeField)`. `ListView` satisfies
+ * that gate today via its `locationField: … || 'location'` default; drop the
+ * default and every other flat key — `titleField` included — is silently
+ * ignored, with no type error and no failing unit test on either side.
+ * - The two packages agree on the FLAT spelling, and nothing but a test
+ * holds them to it: a nested `map` key would win outright here
+ * (objectui#5018) and quietly change the precedence the forward implements.
+ *
+ * `@object-ui/plugin-list` is a devDependency of this package for exactly this
+ * file — dev-only (no runtime source here imports it) and acyclic
+ * (`plugin-list` does not depend on `plugin-map`). The alternative homes cannot
+ * host it: `plugin-list` cannot resolve `react-map-gl` to mock it, and
+ * `apps/console`, which declares both plugins, cannot either.
+ */
+
+import React from 'react';
+import { render, screen, waitFor, fireEvent } from '@testing-library/react';
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { ComponentRegistry } from '@object-ui/core';
+import { SchemaRendererProvider } from '@object-ui/react';
+import { ListView } from '@object-ui/plugin-list';
+import { ObjectMap } from './ObjectMap';
+import { FIT_MAX_ZOOM, FIT_PADDING_PX } from './camera';
+
+let capturedProps: any = null;
+
+vi.mock('react-map-gl/maplibre', () => ({
+ default: (props: any) => {
+ capturedProps = props;
+ return {props.children}
;
+ },
+ Map: ({ children }: any) => {children}
,
+ NavigationControl: () => ,
+ Marker: ({ children, longitude, latitude, onClick }: any) => (
+ onClick?.({ originalEvent: { stopPropagation() {} } })}
+ >
+ {children}
+
+ ),
+ Popup: ({ children }: any) => {children}
,
+}));
+
+// The real renderer, under the tag `ListView`'s `case 'map'` emits.
+ComponentRegistry.register('object-map', ObjectMap as any, {
+ namespace: 'test',
+ label: 'Object Map',
+ category: 'view',
+});
+
+/**
+ * Showcase-shaped records: the platform's `location` value is `{ lat, lng }`,
+ * and the marker text field is `title` — the pair the card names.
+ */
+const records = [
+ { id: '1', title: 'Install rooftop unit', blurb: 'Bldg A', location: { lat: 47.6062, lng: -122.3321 } },
+ { id: '2', title: 'Replace filters', blurb: 'Bldg B', location: { lat: 37.7749, lng: -122.4194 } },
+];
+
+const makeDataSource = () => ({
+ find: vi.fn().mockResolvedValue(records),
+ findOne: vi.fn(),
+ create: vi.fn(),
+ update: vi.fn(),
+ delete: vi.fn(),
+ getObjectSchema: vi.fn().mockResolvedValue({
+ name: 'showcase_task',
+ fields: {
+ title: { type: 'text' },
+ blurb: { type: 'text' },
+ location: { type: 'location' },
+ },
+ }),
+});
+
+/** Mount a `map` list view and settle both the ListView fetch and the map. */
+async function renderListViewMap(view: Record) {
+ capturedProps = null;
+ const dataSource = makeDataSource() as any;
+ render(
+
+
+ ,
+ );
+ await waitFor(() => expect(screen.queryByLabelText('Map')).not.toBeNull());
+ await waitFor(() => expect(capturedProps).not.toBeNull());
+}
+
+describe('a view-level `map` block reaches getMapConfig through ListView (objectui#5042)', () => {
+ beforeEach(() => {
+ capturedProps = null;
+ });
+
+ // THE DISCRIMINATING ARM — `titleField`, the card's own symptom.
+ it('renders marker titles from the declared `titleField`', async () => {
+ await renderListViewMap({ map: { locationField: 'location', titleField: 'title' } });
+
+ await waitFor(() => expect(screen.getAllByTestId('map-marker').length).toBe(2));
+
+ // The title is a real read, not a forwarded prop: `getMapConfig` resolves
+ // `titleField`, the marker transform reads `record[titleField]`, and the
+ // popup renders it. Before the forward landed this read `'Marker'` — the
+ // literal `getMapConfig` falls back to — which is the `undefined`/placeholder
+ // marker-title symptom the card was filed for.
+ fireEvent.click(screen.getAllByTestId('map-marker')[0]);
+ await waitFor(() => expect(screen.queryByTestId('map-popup')).not.toBeNull());
+ expect(screen.getByText('Install rooftop unit')).toBeTruthy();
+ });
+
+ it('renders the marker description from the declared `descriptionField`', async () => {
+ await renderListViewMap({
+ map: { locationField: 'location', titleField: 'title', descriptionField: 'blurb' },
+ });
+
+ await waitFor(() => expect(screen.getAllByTestId('map-marker').length).toBe(2));
+ fireEvent.click(screen.getAllByTestId('map-marker')[0]);
+ await waitFor(() => expect(screen.queryByTestId('map-popup')).not.toBeNull());
+ expect(screen.getByText('Bldg A')).toBeTruthy();
+ });
+
+ it('honours a declared camera — the declaration suppresses the fit', async () => {
+ await renderListViewMap({
+ map: { locationField: 'location', titleField: 'title', zoom: 12, center: [40.7128, -74.006] },
+ });
+
+ const { bounds, zoom, longitude, latitude } = capturedProps.initialViewState;
+
+ // `center` is `[lat, lng]` (ObjectMapConfigSchema's own description).
+ expect(latitude).toBe(40.7128);
+ expect(longitude).toBe(-74.006);
+ expect(zoom).toBe(12);
+ // The whole point of carrying no spec default for `zoom`/`center`
+ // (objectui#5000): a DECLARED camera opts out of the fit. If the block had
+ // not reached here, `bounds` would be set and these three would be the
+ // fitted values instead.
+ expect(bounds).toBeUndefined();
+ });
+
+ it('CONTROL: with no camera declared, the map still fits the queried records', async () => {
+ await renderListViewMap({ map: { locationField: 'location', titleField: 'title' } });
+
+ const { bounds, fitBoundsOptions } = capturedProps.initialViewState;
+
+ expect(bounds).toBeDefined();
+ expect(fitBoundsOptions).toEqual({ padding: FIT_PADDING_PX, maxZoom: FIT_MAX_ZOOM });
+ });
+
+ it('CONTROL: the legacy `options.map` bag still reaches the same reads', async () => {
+ await renderListViewMap({ options: { map: { locationField: 'location', titleField: 'title' } } });
+
+ await waitFor(() => expect(screen.getAllByTestId('map-marker').length).toBe(2));
+ fireEvent.click(screen.getAllByTestId('map-marker')[0]);
+ await waitFor(() => expect(screen.queryByTestId('map-popup')).not.toBeNull());
+ expect(screen.getByText('Install rooftop unit')).toBeTruthy();
+ });
+
+ it('precedence: the view-level block wins over the bag at the READ site', async () => {
+ // Both name a marker-title field; the records carry distinct values, so the
+ // rendered popup says which config actually drove the read.
+ await renderListViewMap({
+ options: { map: { locationField: 'location', titleField: 'blurb' } },
+ map: { titleField: 'title' },
+ });
+
+ await waitFor(() => expect(screen.getAllByTestId('map-marker').length).toBe(2));
+ fireEvent.click(screen.getAllByTestId('map-marker')[0]);
+ await waitFor(() => expect(screen.queryByTestId('map-popup')).not.toBeNull());
+
+ expect(screen.getByText('Install rooftop unit')).toBeTruthy();
+ // …and the coordinate binding the bag alone supplied still worked, which is
+ // what makes this a per-key merge rather than a replacement: markers exist
+ // at all only because `locationField` survived from the bag.
+ expect(screen.getAllByTestId('map-marker').length).toBe(2);
+ });
+});
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index b7437cb1ce..dc8e5f92a4 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -2324,6 +2324,9 @@ importers:
specifier: ^4.4.3
version: 4.4.3
devDependencies:
+ '@object-ui/plugin-list':
+ specifier: workspace:*
+ version: link:../plugin-list
'@types/react':
specifier: 19.2.18
version: 19.2.18