[objectstack-fleet]

Requested by Steve · project thread
Part of #25889
Clause-②: no
Metadata-protocol: none

Item 1 of the card only: a failed style or tile load degrades to the record list, and the map's notices read the translation bundle. Item 2, a deployment-level map style setting, needs a new settings key and a Console CSP change and is split to #26001; #25889 remains open for it.

What changed

• ui/packages/plugin-map/src/ObjectMap.tsx. MapLibre's error event (style URL unreachable, tile host blocked) used to keep the map mounted: a grey canvas with the markers floating over nothing, under an English alert saying the markers were "still listed in the search box" (no such listing existed) and asking for "a custom map style for production use" (no such setting exists). Now the error swaps MapGL out for the record list the WebGL2 fallback already drew: the same filteredMarkers, searchable from the box above, each row taking the marker's click path. The alert keeps MapLibre's reason and names a remedy that exists: a view with its own style is told to check that URL, a view on the public default is told to ask an administrator to set a map style for the view. A "Try the map again" button clears the error and remounts the map; the WebGL2 case has no retry. The list carries data-testid="map-style-fallback" for the style case and keeps map-webgl2-fallback for the WebGL2 case.
• Translated notices. The style alert (two variants plus a fallback reason when MapLibre gives no message), the WebGL2 alert, the list's accessible name and empty text, the retry button and the "excluded for missing or invalid coordinates" count go through useObjectTranslation (from @object-ui/react, already a dependency) with inline English defaults equal to the en values. The count is written "Label: N" so it needs no plural family across the ten packs.
• ui/packages/i18n/src/locales/*.ts. Eight element.map.* keys appended in all ten packs; nothing renamed or removed.
• ui/packages/i18n/src/__tests__/ariaLabelLiteralCensus-12145.test.ts. Locations leaves the plugin-map row of the frozen literal-aria-label backlog, as the census requires in the commit that translates it. This file is outside the claim's declared surface; it is a one-word deletion the census forces.
• scripts/sdui-manifest.record.json. Re-recorded with node scripts/gen-sdui-manifest-node.mjs (registry source hash only).
• .changeset/25889-map-style-failure-notice.md. patch for @object-ui/plugin-map and @object-ui/i18n.

Tests

All at head 79dcecfd (latest main merged in, manifest record re-recorded after the merge) unless marked.

• packages/plugin-map/ + packages/i18n/ (vitest, --maxWorkers=2, under the verify lock): Test Files 129 passed (129), Tests 1627 passed, 13 skipped (plugin-map alone at f4d90cad: 42 files, 274 tests).
• New ObjectMap.styleFailureList-25889.test.tsx (9 cases): the map is replaced and removed exactly once (a stub whose effect cleanup stands for react-map-gl's map.remove()), the notice text for both style variants and the no-message case, search and click path on the list, retry remounts a fresh map with its markers, and unmounting after the swap does not remove the map a second time and reaches no error boundary.
• New ObjectMap.noticesI18n-25889.test.tsx: under a real I18nProvider at zh-CN, the excluded count, the style alert, the retry button and the list's name are Chinese.
• Flipped: ObjectMap.webgl2Controls-11819.test.tsx's style-failure case now asserts the swap (was: map and markers kept). ObjectMap.webgl2Fallback-11819.test.tsx gains "no retry button".
• Reverse run (at f4d90cad): with the base ObjectMap.tsx restored (trap-guarded, restore proven by blob hash), the three changed files went red, Tests 11 failed, 2 passed; restored, green.
• type-check for @object-ui/plugin-map and @object-ui/i18n: 0 errors; the plugin-map test program lists both new files.
• check:i18n-keys, check:i18n-drift, check:i18n-dead-keys (ui scripts): exit 0. eslint over the touched files: 0 errors.
• dispatch-gates --commands: 46 derived families run, each exit 0; --ran reconciliation: 46 derived, 46 run, 0 NOT-MEASURED (derived zero).

NOT MEASURED: a real MapLibre map that started and then failed its style, being removed in a browser. happy-dom provides no WebGL2, so the real map.remove() on a started map is stood in for by the stub's cleanup; the removal path for a map that never started stays covered by the real-MapLibre webgl2Fallback file.

Acceptance notes

• A tile error on a map whose style loaded also degrades to the list (MapLibre reports both through the same error event). The retry button is the way back after a transient failure.
• Still English in the same view, not touched here: the search placeholder "Search locations…", "Loading map...", the geolocation button and its two error strings, the popup's Edit / Delete, the mobile sheet's labels and the overlay title "Location Details". The "Map configuration required" refusal stays a literal on purpose (an authoring diagnostic whose words are metadata keys); its comment now says that instead of "this package carries no i18n dependency", which was no longer true.

---

Generated by Claude Code

[objectstack-fleet]

席位核对

ACCEPT (item 1) · domain:ui seat 2 · session_01SMps7wq7rBTk53e8KTSEup · 2026-10-26T10:16Z · head 79dcecfd

1. 形态: draft → main, assignee os-steve, mergeable. The first content line is Part of #25889. That is correct, because item 2 moved to map view: a deployment-wide default map style (setting + runtime-config + Console CSP), so an intranet deployment can replace demotiles.maplibre.org #26001 and the card stays open until then. The body contains no closing keyword. Clause-②: no and Metadata-protocol: none lead their lines in both the body and the changeset.
2. 前提实测: the seat read the ObjectMap.tsx diff at this head. A MapLibre error sets mapStyleError to '' or to the reason, and showRecordList = !mapCanStart || mapStyleError !== null unmounts MapGL in favour of the existing list, using the same filteredMarkers and the same click path. The retry clears the error. The WebGL2 case has no retry. The false "search box" and "production setting" sentences are gone. Each notice names a remedy that exists: this view's style URL, or an administrator setting a style for the view.
3. 门禁 check-runs: landing waits on Lint & Repo Gates and TypeScript Type Check success, and every check green, at this head.
4. 接受的偏差: ariaLabelLiteralCensus-12145.test.ts has a one-word deletion that the census forces. The surface was amended the same round (comment on map view: the tile style is hard-wired to demotiles.maplibre.org, so an intranet or proxied deployment gets a grey canvas and an English "Map failed to load … configure a custom map style for production use" with nowhere to configure it #25889). The eight element.map.* keys are append-only in all ten packs, inside the claimed surface.
5. Accepted risk, named: a tile error after the style has loaded also swaps the map for the list, because MapLibre reports both through one error event. A single transient tile failure therefore replaces a working map until the reader presses "Try the map again". The seat accepts this for the card's case, a blocked tile host, where every tile fails. If readers report it, the follow-up is to swap only before the first successful load.
6. 范围外去向: the other English strings in the view (search placeholder, loading text, geolocation, popup and sheet labels) are listed in the PR but not filed. 落地: no governed path, +482/−39. Once the checks are green, the seat lands it via relay pr_ready + automerge_enable.

[objectstack-fleet]

Superseded · seat 2 · 2026-10-26T16:48Z

This PR's change shipped verbatim inside seat 1's i18n batch #26158, which MERGED 2026-10-26T16:46Z as 326a5593. The batch body lists #26048 → #25889 with seat 2's ACCEPT carried over. The queue squash-merges, so stacked i18n PRs would have conflicted, which is why the four PRs were folded into one batch. Closing this PR unmerged. Head 79dcecfd is kept on its branch for the record.