@aiaiai-pt/design-system 0.46.1 → 0.46.3

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/components/renderer/display.d.ts

@@ -22,15 +22,24 @@
  * Everything here is PURE and dependency-free.
  */
 export type ObjectFallback = "redact" | "json";
+/** How a boolean renders: "raw" (default) → "true"/"false" (both hosts'
+ *  historical output); "yes-no" → "Yes"/"No" (the staff admin's cell copy —
+ *  #748 lifts it here so the admin's private renderCell fork can retire). */
+export type BooleanDisplay = "raw" | "yes-no";
 /**
- * Pure value → display string. Scalars stringify; arrays join their non-empty
- * formatted members; a disclosed relationship object ({id,label}|{name}|{title})
- * renders its human label then its id. An UNKNOWN object renders per
- * `objectFallback`: "redact" (default) → "" (never dumps internals — the public
- * security boundary); "json" → pretty JSON (the admin operator view).
+ * Pure value → display string. Scalars stringify (booleans per
+ * `booleanDisplay`); arrays join their non-empty formatted members; a
+ * disclosed relationship object renders its human handle
+ * (label→name→display_name→title→code) then its id — `display_name`/`code`
+ * joined the order in #748 so an expanded rel carrying only those (ontology
+ * rows commonly do) renders its handle, not its UUID. An UNKNOWN object
+ * renders per `objectFallback`: "redact" (default) → "" (never dumps
+ * internals — the public security boundary); "json" → pretty JSON (the admin
+ * operator view).
  */
 export declare function formatScalar(value: unknown, opts?: {
     objectFallback?: ObjectFallback;
+    booleanDisplay?: BooleanDisplay;
 }): string;
 /** True for an ISO-8601 timestamp STRING (not a bare date). Value-shape
  *  detection — used where the schema can't tell us the field is a datetime. */
@@ -60,6 +69,7 @@ export declare function displayCell(value: unknown, locale: string, opts?: {
     treatAsDate?: boolean;
     treatAsDateTime?: boolean;
     objectFallback?: ObjectFallback;
+    booleanDisplay?: BooleanDisplay;
 }): string;
 /** Operator copy for a status value (falls back to the raw value). `labels` is
  *  untrusted DATA — a non-object/array is ignored. */

package/components/renderer/display.ts

@@ -24,21 +24,37 @@
 
 export type ObjectFallback = "redact" | "json";
 
+/** How a boolean renders: "raw" (default) → "true"/"false" (both hosts'
+ *  historical output); "yes-no" → "Yes"/"No" (the staff admin's cell copy —
+ *  #748 lifts it here so the admin's private renderCell fork can retire). */
+export type BooleanDisplay = "raw" | "yes-no";
+
 /**
- * Pure value → display string. Scalars stringify; arrays join their non-empty
- * formatted members; a disclosed relationship object ({id,label}|{name}|{title})
- * renders its human label then its id. An UNKNOWN object renders per
- * `objectFallback`: "redact" (default) → "" (never dumps internals — the public
- * security boundary); "json" → pretty JSON (the admin operator view).
+ * Pure value → display string. Scalars stringify (booleans per
+ * `booleanDisplay`); arrays join their non-empty formatted members; a
+ * disclosed relationship object renders its human handle
+ * (label→name→display_name→title→code) then its id — `display_name`/`code`
+ * joined the order in #748 so an expanded rel carrying only those (ontology
+ * rows commonly do) renders its handle, not its UUID. An UNKNOWN object
+ * renders per `objectFallback`: "redact" (default) → "" (never dumps
+ * internals — the public security boundary); "json" → pretty JSON (the admin
+ * operator view).
  */
 export function formatScalar(
   value: unknown,
-  opts: { objectFallback?: ObjectFallback } = {},
+  opts: {
+    objectFallback?: ObjectFallback;
+    booleanDisplay?: BooleanDisplay;
+  } = {},
 ): string {
   // `== null` catches both null and undefined.
   if (value == null) return "";
   if (typeof value === "string") return value;
-  if (typeof value === "number" || typeof value === "boolean") {
+  if (typeof value === "boolean") {
+    if (opts.booleanDisplay === "yes-no") return value ? "Yes" : "No";
+    return String(value);
+  }
+  if (typeof value === "number") {
     return String(value);
   }
   if (Array.isArray(value)) {
@@ -49,7 +65,7 @@ export function formatScalar(
   }
   if (typeof value === "object") {
     const o = value as Record<string, unknown>;
-    for (const k of ["label", "name", "title"]) {
+    for (const k of ["label", "name", "display_name", "title", "code"]) {
       const v = o[k];
       if (typeof v === "string" && v) return v;
     }
@@ -130,6 +146,7 @@ export function displayCell(
     treatAsDate?: boolean;
     treatAsDateTime?: boolean;
     objectFallback?: ObjectFallback;
+    booleanDisplay?: BooleanDisplay;
   } = {},
 ): string {
   if (typeof value === "string" && value) {
@@ -137,7 +154,10 @@ export function displayCell(
     if (opts.treatAsDateTime) return formatDateTime(value, locale);
   }
   if (isIsoTimestamp(value)) return formatTimestamp(value, locale);
-  return formatScalar(value, { objectFallback: opts.objectFallback });
+  return formatScalar(value, {
+    objectFallback: opts.objectFallback,
+    booleanDisplay: opts.booleanDisplay,
+  });
 }
 
 /** Operator copy for a status value (falls back to the raw value). `labels` is

package/package.json

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