@aiaiai-pt/design-system 0.46.0 → 0.46.1

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.1",
   "description": "Design system tokens and Svelte components for aiaiai products",
   "license": "MIT",
   "type": "module",