@adminiumjs/widgets 0.1.0-rc.1

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/format.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Metric formatting shared by the KPI + charts families (annex §1 config:
+ * `format` currency/percent/duration/compact; research/widget-registry.md
+ * Conventions — numbers/dates via `Intl`). Pure module: no React, no DOM.
+ */
+import type { WidgetSharedConfig } from '../registry/shared-config.js';
+export type MetricFormat = 'plain' | 'compact' | 'currency' | 'percent' | 'duration';
+export interface MetricFormatOptions {
+    /** BCP-47 locale; defaults to the runtime locale. */
+    locale?: string | undefined;
+    /** ISO 4217 code for `currency` (default USD). */
+    currency?: string | undefined;
+}
+/**
+ * Pull format options from the shared per-widget config overrides. Empty /
+ * whitespace-only `locale` and `currency` are normalized to `undefined` so the
+ * runtime defaults apply — an empty BCP-47 locale or ISO-4217 code is accepted
+ * by the (free-string) config schema but makes `Intl` throw "Incorrect locale
+ * information provided", which would crash the widget on an otherwise-valid
+ * stored config (surfaced by the 04-T17 config-schema fuzz).
+ */
+export declare function formatOptionsOf(config: Pick<WidgetSharedConfig, 'format'>): MetricFormatOptions;
+/**
+ * Format one metric value. `percent` treats the value as a fraction
+ * (0.74 → "74%"); `duration` treats it as seconds.
+ */
+export declare function formatMetricValue(value: number, format?: MetricFormat, opts?: MetricFormatOptions): string;
+export type DeltaMode = 'none' | 'pct' | 'abs';
+export interface DeltaInfo {
+    trend: 'up' | 'down' | 'flat';
+    /** Signed formatted text, e.g. "+12.4%" or "-$1,204". */
+    text: string;
+    /** Signed fraction, e.g. 0.124. */
+    pct: number;
+}
+/**
+ * Compute the delta-pill payload from a `metric+delta` envelope. Returns
+ * null when there is nothing to compare (`deltaMode: 'none'`, no prior).
+ * Tone/inversion (`invertDeltaGood`) is DeltaPill's job — this only decides
+ * direction and text.
+ */
+export declare function computeDelta(data: {
+    value: number;
+    prior?: number | undefined;
+    deltaPct?: number | undefined;
+}, mode: DeltaMode, format?: MetricFormat, opts?: MetricFormatOptions): DeltaInfo | null;
+//# sourceMappingURL=format.d.ts.map

package/dist/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAErF,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAAG,mBAAmB,CAO/F;AAeD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,YAAsB,EAC9B,IAAI,GAAE,mBAAwB,GAC7B,MAAM,CAuBR;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;CACb;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAClF,IAAI,EAAE,SAAS,EACf,MAAM,GAAE,YAAsB,EAC9B,IAAI,GAAE,mBAAwB,GAC7B,SAAS,GAAG,IAAI,CAoBlB"}

package/dist/lib/format.js

@@ -0,0 +1,95 @@
+/**
+ * Metric formatting shared by the KPI + charts families (annex §1 config:
+ * `format` currency/percent/duration/compact; research/widget-registry.md
+ * Conventions — numbers/dates via `Intl`). Pure module: no React, no DOM.
+ */
+import { getFormatters } from '@adminium/i18n';
+/**
+ * Pull format options from the shared per-widget config overrides. Empty /
+ * whitespace-only `locale` and `currency` are normalized to `undefined` so the
+ * runtime defaults apply — an empty BCP-47 locale or ISO-4217 code is accepted
+ * by the (free-string) config schema but makes `Intl` throw "Incorrect locale
+ * information provided", which would crash the widget on an otherwise-valid
+ * stored config (surfaced by the 04-T17 config-schema fuzz).
+ */
+export function formatOptionsOf(config) {
+    const locale = config.format?.locale?.trim();
+    const currency = config.format?.currency?.trim();
+    return {
+        locale: locale ? locale : undefined,
+        currency: currency ? currency : undefined,
+    };
+}
+/** Seconds → compact human duration ("45s", "3m 20s", "2h 14m", "3d 4h"). */
+function formatDuration(seconds) {
+    const sign = seconds < 0 ? '-' : '';
+    const s = Math.round(Math.abs(seconds));
+    if (s < 60)
+        return `${sign}${s}s`;
+    const minutes = Math.floor(s / 60);
+    if (minutes < 60)
+        return `${sign}${minutes}m${s % 60 === 0 ? '' : ` ${s % 60}s`}`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${sign}${hours}h${minutes % 60 === 0 ? '' : ` ${minutes % 60}m`}`;
+    const days = Math.floor(hours / 24);
+    return `${sign}${days}d${hours % 24 === 0 ? '' : ` ${hours % 24}h`}`;
+}
+/**
+ * Format one metric value. `percent` treats the value as a fraction
+ * (0.74 → "74%"); `duration` treats it as seconds.
+ */
+export function formatMetricValue(value, format = 'plain', opts = {}) {
+    // Metric values are mono/KPI cells → data context (latn digits, aligned in
+    // every locale incl. ar_EG) via the @adminium/i18n format layer (§4.2).
+    const fmt = getFormatters(opts.locale ?? 'en-US');
+    switch (format) {
+        case 'compact':
+            return fmt.number(value, { notation: 'compact', maximumFractionDigits: 1 });
+        case 'currency': {
+            const compact = Math.abs(value) >= 100_000;
+            return fmt.number(value, {
+                style: 'currency',
+                currency: opts.currency ?? 'USD',
+                notation: compact ? 'compact' : 'standard',
+                maximumFractionDigits: compact ? 1 : Math.abs(value) >= 1000 ? 0 : 2,
+            });
+        }
+        case 'percent':
+            return fmt.number(value, { style: 'percent', maximumFractionDigits: 1 });
+        case 'duration':
+            return formatDuration(value);
+        case 'plain':
+            return fmt.number(value, { maximumFractionDigits: 2 });
+    }
+}
+const FLAT_EPSILON = 0.0005;
+/**
+ * Compute the delta-pill payload from a `metric+delta` envelope. Returns
+ * null when there is nothing to compare (`deltaMode: 'none'`, no prior).
+ * Tone/inversion (`invertDeltaGood`) is DeltaPill's job — this only decides
+ * direction and text.
+ */
+export function computeDelta(data, mode, format = 'plain', opts = {}) {
+    if (mode === 'none')
+        return null;
+    const pct = data.deltaPct ??
+        (data.prior === undefined || data.prior === 0
+            ? undefined
+            : (data.value - data.prior) / Math.abs(data.prior));
+    if (pct === undefined)
+        return null;
+    const trend = Math.abs(pct) < FLAT_EPSILON ? 'flat' : pct > 0 ? 'up' : 'down';
+    if (mode === 'pct') {
+        const text = getFormatters(opts.locale ?? 'en-US').number(pct, {
+            style: 'percent',
+            maximumFractionDigits: 1,
+            signDisplay: 'exceptZero',
+        });
+        return { trend, text, pct };
+    }
+    const diff = data.prior === undefined ? data.value * pct : data.value - data.prior;
+    const sign = diff > 0 ? '+' : '';
+    return { trend, text: `${sign}${formatMetricValue(diff, format, opts)}`, pct };
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAa/C;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0C;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QACnC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KAC1C,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACnC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,IAAI,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,GAAG,IAAI,GAAG,KAAK,IAAI,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,EAAE,GAAG,EAAE,CAAC;IAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,IAAI,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,SAAuB,OAAO,EAC9B,OAA4B,EAAE;IAE9B,2EAA2E;IAC3E,wEAAwE;IACxE,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC;IAClD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9E,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC;YAC3C,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE;gBACvB,KAAK,EAAE,UAAU;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;gBAChC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;gBAC1C,qBAAqB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACrE,CAAC,CAAC;QACL,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,KAAK,UAAU;YACb,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,OAAO;YACV,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAYD,MAAM,YAAY,GAAG,MAAM,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAkF,EAClF,IAAe,EACf,SAAuB,OAAO,EAC9B,OAA4B,EAAE;IAE9B,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,GAAG,GACP,IAAI,CAAC,QAAQ;QACb,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;YAC3C,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAuB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAClG,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE;YAC7D,KAAK,EAAE,SAAS;YAChB,qBAAqB,EAAE,CAAC;YACxB,WAAW,EAAE,YAAY;SAC1B,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAC9B,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACnF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;AACjF,CAAC"}

package/dist/lib/shapes.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Lenient payload narrowing for the §3 canonical envelopes (04 §3). Widget
+ * components receive `data: unknown` from WidgetHost (already known to be
+ * non-empty per the definition's `isEmpty` predicate) and narrow it here —
+ * a malformed payload returns null and the component renders its own
+ * fallback instead of throwing into the error boundary.
+ */
+export interface TsPointData {
+    /** ISO 8601. */
+    t: string;
+    v: number;
+}
+export interface TimeseriesData {
+    points: TsPointData[];
+    compare?: TsPointData[] | undefined;
+}
+export interface MetricDeltaData {
+    value: number;
+    prior?: number | undefined;
+    deltaPct?: number | undefined;
+    spark?: number[] | undefined;
+}
+export interface SingleMetricData {
+    value: number;
+    unit?: string | undefined;
+}
+export interface CategoricalItemData {
+    key: string;
+    label: string;
+    value: number;
+    tone?: string | undefined;
+}
+export interface CategoricalData {
+    items: CategoricalItemData[];
+    total?: number | undefined;
+}
+export declare function asTimeseries(data: unknown): TimeseriesData | null;
+/** Accepts `metric+delta` and plain `single-metric` payloads (kpi cards take both). */
+export declare function asMetricDelta(data: unknown): MetricDeltaData | null;
+export declare function asSingleMetric(data: unknown): SingleMetricData | null;
+export declare function asCategorical(data: unknown): CategoricalData | null;
+/** Timeseries y-values for sparkline embedding. */
+export declare function timeseriesValues(data: TimeseriesData): number[];
+//# sourceMappingURL=shapes.d.ts.map

package/dist/lib/shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.d.ts","sourceRoot":"","sources":["../../src/lib/shapes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAcD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAOjE;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAanE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAKrE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAiBnE;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAE/D"}

package/dist/lib/shapes.js

@@ -0,0 +1,91 @@
+/**
+ * Lenient payload narrowing for the §3 canonical envelopes (04 §3). Widget
+ * components receive `data: unknown` from WidgetHost (already known to be
+ * non-empty per the definition's `isEmpty` predicate) and narrow it here —
+ * a malformed payload returns null and the component renders its own
+ * fallback instead of throwing into the error boundary.
+ */
+function rec(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : null;
+}
+function num(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim() !== '') {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+function pointsOf(value) {
+    if (!Array.isArray(value))
+        return null;
+    const out = [];
+    for (const entry of value) {
+        const r = rec(entry);
+        const v = num(r?.v);
+        if (r === null || typeof r.t !== 'string' || v === undefined)
+            return null;
+        out.push({ t: r.t, v });
+    }
+    return out;
+}
+export function asTimeseries(data) {
+    const r = rec(data);
+    if (r === null)
+        return null;
+    const points = pointsOf(r.points);
+    if (points === null)
+        return null;
+    const compare = r.compare === undefined ? undefined : (pointsOf(r.compare) ?? undefined);
+    return compare === undefined ? { points } : { points, compare };
+}
+/** Accepts `metric+delta` and plain `single-metric` payloads (kpi cards take both). */
+export function asMetricDelta(data) {
+    const r = rec(data);
+    const value = num(r?.value);
+    if (r === null || value === undefined)
+        return null;
+    const spark = Array.isArray(r.spark)
+        ? r.spark.map(num).filter((v) => v !== undefined)
+        : undefined;
+    return {
+        value,
+        prior: num(r.prior),
+        deltaPct: num(r.deltaPct),
+        spark: spark !== undefined && spark.length > 0 ? spark : undefined,
+    };
+}
+export function asSingleMetric(data) {
+    const r = rec(data);
+    const value = num(r?.value);
+    if (r === null || value === undefined)
+        return null;
+    return { value, unit: typeof r.unit === 'string' ? r.unit : undefined };
+}
+export function asCategorical(data) {
+    const r = rec(data);
+    if (r === null || !Array.isArray(r.items))
+        return null;
+    const items = [];
+    for (const entry of r.items) {
+        const item = rec(entry);
+        const value = num(item?.value);
+        if (item === null || value === undefined)
+            return null;
+        const label = typeof item.label === 'string' ? item.label : String(item.key ?? '');
+        items.push({
+            key: typeof item.key === 'string' ? item.key : label,
+            label,
+            value,
+            tone: typeof item.tone === 'string' ? item.tone : undefined,
+        });
+    }
+    return { items, total: num(r.total) };
+}
+/** Timeseries y-values for sparkline embedding. */
+export function timeseriesValues(data) {
+    return data.points.map((point) => point.v);
+}
+//# sourceMappingURL=shapes.js.map

package/dist/lib/shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.js","sourceRoot":"","sources":["../../src/lib/shapes.ts"],"names":[],"mappings":"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"}

package/dist/page-config/data-shapes.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+/**
+ * The eighteen canonical data-contract shapes (04-widget-registry.md §3).
+ * Server payloads and widget data contracts discriminate on these keys.
+ */
+export declare const DATA_SHAPES: readonly ["single-metric", "metric+delta", "timeseries", "multi-timeseries", "categorical", "record-list", "record", "matrix", "hierarchy/tree", "calendar-events", "geo-points", "flows", "ohlc", "distribution", "boolean-map", "stream", "form-state", "static"];
+export declare const dataShapeSchema: z.ZodEnum<{
+    "single-metric": "single-metric";
+    "metric+delta": "metric+delta";
+    timeseries: "timeseries";
+    "multi-timeseries": "multi-timeseries";
+    categorical: "categorical";
+    "record-list": "record-list";
+    record: "record";
+    matrix: "matrix";
+    "hierarchy/tree": "hierarchy/tree";
+    "calendar-events": "calendar-events";
+    "geo-points": "geo-points";
+    flows: "flows";
+    ohlc: "ohlc";
+    distribution: "distribution";
+    "boolean-map": "boolean-map";
+    stream: "stream";
+    "form-state": "form-state";
+    static: "static";
+}>;
+export type DataShape = z.infer<typeof dataShapeSchema>;
+//# sourceMappingURL=data-shapes.d.ts.map

package/dist/page-config/data-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-shapes.d.ts","sourceRoot":"","sources":["../../src/page-config/data-shapes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,WAAW,qQAmBd,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;EAAsB,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/page-config/data-shapes.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+/**
+ * The eighteen canonical data-contract shapes (04-widget-registry.md §3).
+ * Server payloads and widget data contracts discriminate on these keys.
+ */
+export const DATA_SHAPES = [
+    'single-metric',
+    'metric+delta',
+    'timeseries',
+    'multi-timeseries',
+    'categorical',
+    'record-list',
+    'record',
+    'matrix',
+    'hierarchy/tree',
+    'calendar-events',
+    'geo-points',
+    'flows',
+    'ohlc',
+    'distribution',
+    'boolean-map',
+    'stream',
+    'form-state',
+    'static',
+];
+export const dataShapeSchema = z.enum(DATA_SHAPES);
+//# sourceMappingURL=data-shapes.js.map

package/dist/page-config/data-shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-shapes.js","sourceRoot":"","sources":["../../src/page-config/data-shapes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe;IACf,cAAc;IACd,YAAY;IACZ,kBAAkB;IAClB,aAAa;IACb,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,gBAAgB;IAChB,iBAAiB;IACjB,YAAY;IACZ,OAAO;IACP,MAAM;IACN,cAAc;IACd,aAAa;IACb,QAAQ;IACR,YAAY;IACZ,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC"}

package/dist/page-config/grid-column-spec.d.ts

@@ -0,0 +1,135 @@
+import { z } from 'zod';
+/**
+ * Column-spec vocabulary for the `page-crud` config body — the typed
+ * `config.columns[]` contract (research/widget-registry.md §3 "column defs
+ * generated from schema"; 01-architecture.md §6.1 `config.columns`).
+ *
+ * Lives in the page-config leaf (not `families/tables`) because it is a stored
+ * config-body schema, not component code: the generator leaf's crud-body
+ * composer (`../generate/crud-body.ts`) emits these specs and may import only
+ * zod + this leaf, and `@adminium/engine/config` bundles this leaf for the
+ * server. `families/tables/column-spec.ts` re-exports everything here — the
+ * renderers and their i18n-backed cell formatters stay there — so there is ONE
+ * schema and ONE type on both sides of the boundary.
+ *
+ * These mirror the Engine snapshot's `ColumnModel` + `ColumnSemantics`
+ * vocabulary (packages/engine/src/schema-model.ts) WITHOUT importing the
+ * engine — @adminium/widgets may only touch the browser-safe
+ * `@adminium/engine/config` leaf, and that leaf itself imports widgets'
+ * page-config, so the spec types live here and the interpreter (dashboard)
+ * projects snapshot columns into them.
+ */
+/** Logical column types the cell/form renderers branch on (engine §6 subset). */
+export declare const GRID_LOGICAL_TYPES: readonly ["text", "varchar", "integer", "bigint", "decimal", "float", "boolean", "date", "time", "timestamp", "timestamptz", "interval", "uuid", "json", "binary", "enum", "geometry", "inet", "unknown"];
+export declare const gridLogicalTypeSchema: z.ZodEnum<{
+    bigint: "bigint";
+    boolean: "boolean";
+    unknown: "unknown";
+    date: "date";
+    enum: "enum";
+    text: "text";
+    varchar: "varchar";
+    integer: "integer";
+    decimal: "decimal";
+    float: "float";
+    time: "time";
+    timestamp: "timestamp";
+    timestamptz: "timestamptz";
+    interval: "interval";
+    uuid: "uuid";
+    json: "json";
+    binary: "binary";
+    geometry: "geometry";
+    inet: "inet";
+}>;
+export type GridLogicalType = z.infer<typeof gridLogicalTypeSchema>;
+/**
+ * Column semantics the renderers act on (engine §7.1 SEMANTIC_TAGS — kept as
+ * an open string so classifier additions never break stored configs; the
+ * known ids below get dedicated treatments, everything else renders as text).
+ */
+export declare const GRID_SEMANTICS: readonly ["pk-id", "fk", "money", "percent", "score", "status-workflow", "category-enum", "created-at", "updated-at", "event-timestamp", "duration", "person-name", "email", "phone", "image-url", "file-ref", "url", "boolean-flag", "color", "tags", "slug", "ip-address", "json-config", "external-id", "free-text", "plain"];
+export type GridSemantic = (typeof GRID_SEMANTICS)[number] | (string & {});
+/**
+ * The `@adminium/ui` tone vocabulary plus `'muted'` — the fallback tone the
+ * crud generator and the LLM contract emit for enum values outside the §7.1
+ * rule-7 keyword map ("inactive / draft / neutral"). Renderers map `'muted'`
+ * onto the neutral treatment (`families/tables/cells.tsx`).
+ */
+export declare const gridToneSchema: z.ZodEnum<{
+    neutral: "neutral";
+    accent: "accent";
+    pos: "pos";
+    warn: "warn";
+    danger: "danger";
+    info: "info";
+    muted: "muted";
+}>;
+export type GridTone = z.infer<typeof gridToneSchema>;
+/**
+ * One column definition — the `config.columns[]` entry of `page-crud`
+ * (01 §6.1) and the column contract of `data-grid`/`detail-key-value`/
+ * `mini-table` (annex §3: `{key, label, type, mono, align, pill?, fk?}`).
+ */
+export declare const gridColumnSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    logicalType: z.ZodDefault<z.ZodEnum<{
+        bigint: "bigint";
+        boolean: "boolean";
+        unknown: "unknown";
+        date: "date";
+        enum: "enum";
+        text: "text";
+        varchar: "varchar";
+        integer: "integer";
+        decimal: "decimal";
+        float: "float";
+        time: "time";
+        timestamp: "timestamp";
+        timestamptz: "timestamptz";
+        interval: "interval";
+        uuid: "uuid";
+        json: "json";
+        binary: "binary";
+        geometry: "geometry";
+        inet: "inet";
+    }>>;
+    semantic: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    format: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    currency: z.ZodOptional<z.ZodString>;
+    enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enumTones: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        neutral: "neutral";
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>>;
+    fk: z.ZodOptional<z.ZodObject<{
+        table: z.ZodString;
+        column: z.ZodString;
+        displayKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    pii: z.ZodDefault<z.ZodBoolean>;
+    mono: z.ZodDefault<z.ZodBoolean>;
+    align: z.ZodOptional<z.ZodEnum<{
+        start: "start";
+        end: "end";
+    }>>;
+    sortable: z.ZodDefault<z.ZodBoolean>;
+    hidden: z.ZodDefault<z.ZodBoolean>;
+    primaryKey: z.ZodDefault<z.ZodBoolean>;
+    nullable: z.ZodDefault<z.ZodBoolean>;
+    hasDefault: z.ZodDefault<z.ZodBoolean>;
+    unique: z.ZodDefault<z.ZodBoolean>;
+    readOnly: z.ZodDefault<z.ZodBoolean>;
+    maxLength: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    isDisplay: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GridColumnSpec = z.infer<typeof gridColumnSpecSchema>;
+export type GridColumnSpecInput = z.input<typeof gridColumnSpecSchema>;
+export type GridRow = Record<string, unknown>;
+//# sourceMappingURL=grid-column-spec.d.ts.map

package/dist/page-config/grid-column-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-column-spec.d.ts","sourceRoot":"","sources":["../../src/page-config/grid-column-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,2MAoBrB,CAAC;AACX,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;EAA6B,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,cAAc,kUA2BjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;EAA0E,CAAC;AACtG,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmD/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}