@standardbeagle/edit-db 0.4.448 → 0.4.450

package/dist/lib/format-value-render.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/format-value.d.ts

@@ -0,0 +1,53 @@
+import { ReactNode } from 'react';
+import { Column } from '../types/schema';
+/**
+ * Per-column display formatting for grid/detail cells.
+ *
+ * Raw DB values — especially SQL Server datetimes like
+ * `2026-05-11T22:17:47.7636626` — are unreadable. This formats values into
+ * concise, locale-aware forms, driven by a `display-format` column metadata key
+ * with a sensible default inferred from the column type when none is set.
+ *
+ * Supported `display-format` values:
+ *   date      — locale date              (e.g. "May 11, 2026")
+ *   datetime  — locale date + time       (e.g. "May 11, 2026, 10:17 PM")
+ *   time      — locale time              (e.g. "10:17 PM")
+ *   relative  — humanized relative time  (e.g. "4 hours ago"), hover shows exact
+ *   number    — grouped locale number    (e.g. "1,234,567")
+ *   percent   — locale percent           (0.42 -> "42%")
+ *   raw       — no formatting (escape hatch)
+ *
+ * Any formatted cell keeps the exact value in a `title` so hovering reveals the
+ * precise underlying data.
+ */
+export declare const DISPLAY_FORMAT_KEY = "display-format";
+/**
+ * Secondary, context-specific format template (used by compact surfaces like FK
+ * preview popovers). When a column doesn't set it, formatting falls back to the
+ * main `display-format`, so the preview matches the grid by default.
+ */
+export declare const DISPLAY_FORMAT_PREVIEW_KEY = "display-format-preview";
+export type DisplayFormat = 'date' | 'datetime' | 'time' | 'relative' | 'number' | 'percent' | 'raw';
+/** Options for {@link formatColumnValue}. */
+export interface FormatOptions {
+    /**
+     * Metadata key to read the format from before falling back to the main
+     * `display-format`. Lets a context override the template while defaulting to
+     * the main one when the column doesn't set the override key.
+     */
+    formatKey?: string;
+}
+/**
+ * Resolve the effective format: an explicit override key wins, then the main
+ * `display-format` metadata, else inferred from the column type. Passing
+ * `formatKey` lets a context default to the main template when its own is unset.
+ */
+export declare function resolveDisplayFormat(column: Column, formatKey?: string): DisplayFormat | null;
+/** "4 hours ago" / "in 3 days" via Intl.RelativeTimeFormat. */
+export declare function formatRelative(date: Date, now?: Date): string;
+/**
+ * Format a scalar value for display, given its column. Returns a muted
+ * placeholder for null/empty, a locale-formatted node for known formats (with a
+ * `title` revealing the exact value), or the plain string otherwise.
+ */
+export declare function formatColumnValue(value: unknown, column: Column, options?: FormatOptions): ReactNode;

package/dist/lib/format-value.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@standardbeagle/edit-db",
   "private": false,
-  "version": "0.4.448",
+  "version": "0.4.450",
   "type": "module",
   "dependencies": {
     "@radix-ui/react-slot": "^1.2.4",