@aiaiai-pt/design-system 0.46.0 → 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/components/renderer/display.d.ts

@@ -38,15 +38,27 @@ export declare function isIsoTimestamp(value: unknown): value is string;
 /** Locale date for an ISO timestamp (date-only, UTC-stable so SSR == hydrate);
  *  the raw string when unparseable. */
 export declare function formatTimestamp(value: string, locale: string): string;
+/** Locale date+time for an ISO timestamp (UTC-stable so SSR == hydrate); the
+ *  raw string when unparseable. Unlike `formatTimestamp` (date-only), this keeps
+ *  the time — for a schema `datetime` field the staff admin renders the full
+ *  instant (incl. 00:00), since a datetime's time is meaningful data (SLA
+ *  stamps, acknowledgements). A `date`-typed field uses `formatTimestamp`. */
+export declare function formatDateTime(value: string, locale: string): string;
 /**
  * The single display boundary for list cells / detail values. Formats a value
- * as a locale date when it's a timestamp — either because `opts.treatAsDate`
- * forces it (the admin, from the schema field type) or because the value itself
- * looks like an ISO timestamp (the portal, value-shape). Everything else goes
- * through `formatScalar` (with the host's object-fallback policy).
+ * as a locale date/datetime when it's a timestamp — the caller drives which
+ * from the schema FIELD TYPE (not a value-shape guess):
+ *   - `treatAsDate`      → date-only  (a `date`-typed field)
+ *   - `treatAsDateTime`  → date+time  (a `datetime`-typed field; time is data)
+ *   - neither            → value-shape: an ISO-timestamp STRING renders
+ *                          date-only (the portal, whose public schema strips
+ *                          typed created_at/updated_at). Unchanged.
+ * Everything else goes through `formatScalar` (with the host's object policy).
+ * `treatAsDate` wins if a caller mistakenly sets both.
  */
 export declare function displayCell(value: unknown, locale: string, opts?: {
     treatAsDate?: boolean;
+    treatAsDateTime?: boolean;
     objectFallback?: ObjectFallback;
 }): string;
 /** Operator copy for a status value (falls back to the raw value). `labels` is

package/components/renderer/display.ts

@@ -92,20 +92,49 @@ export function formatTimestamp(value: string, locale: string): string {
   }
 }
 
+/** Locale date+time for an ISO timestamp (UTC-stable so SSR == hydrate); the
+ *  raw string when unparseable. Unlike `formatTimestamp` (date-only), this keeps
+ *  the time — for a schema `datetime` field the staff admin renders the full
+ *  instant (incl. 00:00), since a datetime's time is meaningful data (SLA
+ *  stamps, acknowledgements). A `date`-typed field uses `formatTimestamp`. */
+export function formatDateTime(value: string, locale: string): string {
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) return value;
+  try {
+    return new Intl.DateTimeFormat(locale || "en", {
+      dateStyle: "medium",
+      timeStyle: "short",
+      timeZone: "UTC",
+    }).format(parsed);
+  } catch {
+    return value;
+  }
+}
+
 /**
  * The single display boundary for list cells / detail values. Formats a value
- * as a locale date when it's a timestamp — either because `opts.treatAsDate`
- * forces it (the admin, from the schema field type) or because the value itself
- * looks like an ISO timestamp (the portal, value-shape). Everything else goes
- * through `formatScalar` (with the host's object-fallback policy).
+ * as a locale date/datetime when it's a timestamp — the caller drives which
+ * from the schema FIELD TYPE (not a value-shape guess):
+ *   - `treatAsDate`      → date-only  (a `date`-typed field)
+ *   - `treatAsDateTime`  → date+time  (a `datetime`-typed field; time is data)
+ *   - neither            → value-shape: an ISO-timestamp STRING renders
+ *                          date-only (the portal, whose public schema strips
+ *                          typed created_at/updated_at). Unchanged.
+ * Everything else goes through `formatScalar` (with the host's object policy).
+ * `treatAsDate` wins if a caller mistakenly sets both.
  */
 export function displayCell(
   value: unknown,
   locale: string,
-  opts: { treatAsDate?: boolean; objectFallback?: ObjectFallback } = {},
+  opts: {
+    treatAsDate?: boolean;
+    treatAsDateTime?: boolean;
+    objectFallback?: ObjectFallback;
+  } = {},
 ): string {
-  if (opts.treatAsDate && typeof value === "string" && value) {
-    return formatTimestamp(value, locale);
+  if (typeof value === "string" && value) {
+    if (opts.treatAsDate) return formatTimestamp(value, locale);
+    if (opts.treatAsDateTime) return formatDateTime(value, locale);
   }
   if (isIsoTimestamp(value)) return formatTimestamp(value, locale);
   return formatScalar(value, { objectFallback: opts.objectFallback });

package/package.json

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