@aiaiai-pt/design-system 0.46.1 → 0.46.2

package/components/ActionFormRenderer.svelte

@@ -54,6 +54,7 @@
     dateToDateOnly,
     geoJsonPointToLonLat,
     lonLatToGeoJsonPoint,
+    mapInitialCenter,
     storedFileDescriptor,
     widgetKind,
   } from "./action-form-renderer-widgets";
@@ -1007,6 +1008,7 @@
       {onoutofbounds}
       error={fieldError ?? hydrated.error ?? geoError}
       label={String(parameter.label ?? key)}
+      center={mapInitialCenter(parameter)}
       value={hydrated.coords ?? undefined}
       onchange={(coords: [number, number]) => setValue(key, lonLatToGeoJsonPoint(coords))}
     />
@@ -1027,9 +1029,10 @@
       {onoutofbounds}
       error={fieldError ?? geoError}
       label={String(parameter.label ?? key)}
-      center={Array.isArray(parameter.default_value)
-        ? (parameter.default_value as [number, number])
-        : undefined}
+      center={mapInitialCenter(parameter) ??
+        (Array.isArray(parameter.default_value)
+          ? (parameter.default_value as [number, number])
+          : undefined)}
       value={Array.isArray(values[key])
         ? (values[key] as [number, number])
         : undefined}

package/components/action-form-renderer-widgets.d.ts

@@ -27,6 +27,17 @@ export declare function geoJsonPointToLonLat(value: unknown): {
 };
 /** #39 — serialize a placed pin back onto the GeoJSON wire shape. */
 export declare function lonLatToGeoJsonPoint(coords: [number, number]): GeoJsonPoint;
+/** #46 — the map picker's INITIAL CENTRE, from its declared home:
+ *  `ui_schema.map.initial_center` ([lon, lat]). A viewport hint is
+ *  presentation, not a value — it lives in ui_schema so `default_value`
+ *  keeps its one meaning (the initial VALUE). Malformed/absent → undefined
+ *  (the picker keeps its own default). Consumers still passing a bare
+ *  [lon, lat] `default_value` on a legacy geo param keep working via the
+ *  renderer's fallback (deprecated; removed next minor). */
+export declare function mapInitialCenter(parameter: {
+    ui_schema?: unknown;
+    [key: string]: unknown;
+}): [number, number] | undefined;
 export type StoredFile = {
     name: string;
     url?: string;

package/components/action-form-renderer-widgets.ts

@@ -95,6 +95,37 @@ export function lonLatToGeoJsonPoint(coords: [number, number]): GeoJsonPoint {
   return { type: "Point", coordinates: [coords[0], coords[1]] };
 }
 
+/** #46 — the map picker's INITIAL CENTRE, from its declared home:
+ *  `ui_schema.map.initial_center` ([lon, lat]). A viewport hint is
+ *  presentation, not a value — it lives in ui_schema so `default_value`
+ *  keeps its one meaning (the initial VALUE). Malformed/absent → undefined
+ *  (the picker keeps its own default). Consumers still passing a bare
+ *  [lon, lat] `default_value` on a legacy geo param keep working via the
+ *  renderer's fallback (deprecated; removed next minor). */
+export function mapInitialCenter(parameter: {
+  ui_schema?: unknown;
+  [key: string]: unknown;
+}): [number, number] | undefined {
+  const ui =
+    parameter.ui_schema && typeof parameter.ui_schema === "object"
+      ? (parameter.ui_schema as Record<string, unknown>)
+      : null;
+  const map =
+    ui?.map && typeof ui.map === "object"
+      ? (ui.map as Record<string, unknown>)
+      : null;
+  const c = map?.initial_center;
+  if (
+    Array.isArray(c) &&
+    c.length >= 2 &&
+    typeof c[0] === "number" &&
+    typeof c[1] === "number"
+  ) {
+    return [c[0], c[1]];
+  }
+  return undefined;
+}
+
 export type StoredFile = { name: string; url?: string };
 
 /** #40 — normalize a file param's stored-current value (the edit form's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiaiai-pt/design-system",
-  "version": "0.46.1",
+  "version": "0.46.2",
   "description": "Design system tokens and Svelte components for aiaiai products",
   "license": "MIT",
   "type": "module",