@object-ui/plugin-dashboard 17.3.0 → 17.6.0

package/dist/MetricWidget.d.ts

@@ -1,25 +1,74 @@
 import { default as React } from 'react';
-export type MetricColorVariant = 'default' | 'blue' | 'teal' | 'orange' | 'purple' | 'success' | 'warning' | 'danger';
-export interface MetricWidgetProps {
-    label: string | {
-        key?: string;
-        defaultValue?: string;
-    };
+import { I18nLabel } from '@object-ui/types';
+import { MetricColorVariant } from './colorVariants';
+import { SchemaHostProps } from './schemaHostProps';
+/**
+ * The variant vocabulary and its two class tables now live in
+ * `./colorVariants` — the dataset-bound KPI (`DatasetWidget`, objectui#3359)
+ * paints the SAME accents, and two copies of a palette is how a
+ * declared-but-unenforced key becomes two disagreeing declarations. Re-exported
+ * here because this module was the type's original home.
+ */
+export type { MetricColorVariant };
+/**
+ * DOM PASS-THROUGH (objectui#4426). `MetricWidget` ends its prop list with a
+ * `...domProps` spread onto the Shadcn `Card` — a `div` — so `id`, `role`,
+ * `aria-*`, `data-*`, `tabIndex`, `title` and the DOM event handlers reach the
+ * element. objectui#4357 (PR #4428) deliberately KEPT that spread: it is the
+ * component's only accessibility passthrough, and removing it would delete the
+ * only way a host can put an `id` or an `aria-label` on a KPI card.
+ *
+ * Until now the type refused what the runtime accepted. A TypeScript consumer
+ * importing the component directly could not write `<MetricWidget id="revenue"
+ * role="region" aria-label="Revenue KPI" … />` without a cast, while a JS
+ * consumer and every SDUI author going through `SchemaRenderer` (untyped at
+ * that boundary) got the passthrough for free. This `extends` is that
+ * declaration — the mirror image of #4357, closing the same question from the
+ * other side: renderer metadata was reaching the DOM because the spread is
+ * open; DOM attributes were unreachable because the type was closed.
+ *
+ * Measured convention, not an invented spelling: an exported `*Props` interface
+ * that spreads onto a host element extends `React.HTMLAttributes<HTMLDivElement>`
+ * here — `PageHeaderComponentProps` (whose own doc says "it extends
+ * `HTMLAttributes` so every DOM prop rides along"), `ChatbotProps`,
+ * `ChatbotEnhancedProps`, `TypingIndicatorProps`, `RefreshIndicatorProps`,
+ * `FieldProps`, and shadcn's own `BadgeProps`.
+ *
+ * What this does NOT declare, deliberately: the schema-shaped keys
+ * `SchemaRenderer` injects (`schema` / `bind` / `events` / `props` /
+ * `ariaLabel` / `ariaDescribedBy` / `dataSource`). None of them is an HTML
+ * attribute name, all seven are destructured out and never reach the DOM, and
+ * declaring them here would re-assert as a public contract exactly what #4357
+ * stripped. They stay in `SchemaHostProps`, intersected in at the component's
+ * own signature — the renderer's private door, not the consumer's front door.
+ * The narrower `FieldWidgetDomProps` shape (objectui#3221) is the other spelling
+ * in this repo, but it exists to be bound key-by-key to a runtime whitelist
+ * (`toDomProps`) in both directions; this component has no such whitelist, and
+ * inventing a half of one here would declare a set the spread does not enforce.
+ * Whether plugin widgets should get that whitelist is objectui#4425.
+ */
+export interface MetricWidgetProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * The KPI's heading, in @objectstack/spec's `I18nLabel` vocabulary — a plain
+     * string or an inline per-locale map (`{ en: 'Revenue', 'zh-CN': '收入' }`).
+     *
+     * Was `string | { key?, defaultValue? }` — the key-reference form
+     * objectstack#5055 RETIRED. It is not accepted here any more because the spec
+     * rejects it at authoring time, and because reading it was never the point:
+     * the private resolver behind it ended `defaultValue || key` and never
+     * consulted a bundle, so the escape hatch was declared and inert
+     * (objectui#4032).
+     */
+    label: string | I18nLabel;
     value: string | number;
     trend?: {
         value: number;
-        label?: string | {
-            key?: string;
-            defaultValue?: string;
-        };
+        label?: string | I18nLabel;
         direction?: 'up' | 'down' | 'neutral';
     };
     icon?: React.ReactNode | string;
     className?: string;
-    description?: string | {
-        key?: string;
-        defaultValue?: string;
-    };
+    description?: string | I18nLabel;
     /** When true, the widget is in a loading state (fetching data from server). */
     loading?: boolean;
     /** Error message from a failed data fetch. When set, the widget shows an error state. */
@@ -30,11 +79,27 @@ export interface MetricWidgetProps {
     format?: string;
     /** ISO currency code (e.g. `'USD'`); enables currency formatting on numeric values. */
     currency?: string;
-    /** Static prefix appended in front of the formatted value (e.g. `'$'`, `'¥'`). */
+    /**
+     * Static prefix appended in front of the formatted value (e.g. `'$'`, `'¥'`).
+     *
+     * Same name, same `string` type as the inherited RDFa `prefix` attribute, and
+     * this declaration wins: the component reads it and destructures it out, so
+     * it never reaches the DOM. That is the accurate contract — it was already
+     * true before this interface declared its passthrough.
+     */
     prefix?: string;
     /** Static suffix appended after the formatted value (e.g. `' /mo'`). */
     suffix?: string;
-    /** When set, the entire card becomes clickable and emits this handler. */
+    /**
+     * When set, the entire card becomes clickable and emits this handler.
+     *
+     * Deliberately NARROWER than the inherited `MouseEventHandler<HTMLDivElement>`:
+     * the KPI card treats a click as "the tile was activated" and wires the same
+     * handler to Enter/Space, where there is no mouse event to hand over. A
+     * zero-arg function is assignable to the inherited signature, so consumers
+     * already passing `(e) => …` keep compiling; this only stops the component
+     * from promising an event object its keyboard path cannot produce.
+     */
     onClick?: () => void;
     /**
      * Layout variant. `'card'` (default) is the bordered KPI card; `'bare'` drops
@@ -43,5 +108,5 @@ export interface MetricWidgetProps {
      */
     variant?: 'card' | 'bare';
 }
-export declare const MetricWidget: ({ label, value, trend, icon, className, description, loading, error, colorVariant, format, currency, prefix, suffix, onClick, variant, ...props }: MetricWidgetProps) => React.JSX.Element;
+export declare const MetricWidget: ({ label, value, trend, icon, className, description, loading, error, colorVariant, format, currency, prefix, suffix, onClick, variant, schema: _schema, bind: _bind, events: _events, props: _propsBag, ariaLabel: _ariaLabel, ariaDescribedBy: _ariaDescribedBy, dataSource: _dataSource, ...domProps }: MetricWidgetProps & SchemaHostProps) => React.JSX.Element;
 //# sourceMappingURL=MetricWidget.d.ts.map

package/dist/MetricWidget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MetricWidget.d.ts","sourceRoot":"","sources":["../src/MetricWidget.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AA2HvC,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GACjD,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAgCrC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,GAAG;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACzD,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;KACvC,CAAC;IACF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sFAAsF;IACtF,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,YAAY,GAAI,mJAiB1B,iBAAiB,sBAoInB,CAAC"}
+{"version":3,"file":"MetricWidget.d.ts","sourceRoot":"","sources":["../src/MetricWidget.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAWvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAA8C,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACtG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAgIzD;;;;;;GAMG;AACH,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC7E;;;;;;;;;;OAUG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;KACvC,CAAC;IACF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sFAAsF;IACtF,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,YAAY,GAAI,0SA6B1B,iBAAiB,GAAG,eAAe,sBA6IrC,CAAC"}

package/dist/ObjectDataTable.d.ts

@@ -30,7 +30,40 @@ interface NormalizedColumn {
  *
  * - `string[]` entries are converted to `{ header, accessorKey }` objects,
  *   handling both snake_case and camelCase for header generation.
- * - Object entries are returned as-is.
+ * - Object entries have their field identity AND their display text RESOLVED
+ *   here, at the producer, and stamped onto the data-table adapter's own keys
+ *   (`accessorKey` / `header`). The adapter reads only those two, and no longer
+ *   falls back to `name` / `label` (objectui#5120, objectui#5351).
+ *
+ * Object entries used to be returned raw (objectui#5120). `accessorKey` is the
+ * table LIBRARY's column key — `column-identity.ts` names it
+ * `TABLE_ADAPTER_COLUMN_KEY` and deliberately holds the metadata-identity fold
+ * away from it — so a column authored in the spec-canonical spelling
+ * (`{ field: 'stage' }`) reached the adapter carrying no `accessorKey` at all
+ * and rendered a header over `row[undefined]`: blank cells, no warning. The
+ * `$expand` whitelist in `computeLookupExpand` missed it for the same reason,
+ * so a `field`-spelled lookup column also lost its related record.
+ *
+ * Resolving it HERE is the move objectui#5022 made in `RelatedList` and
+ * objectui#5068 generalized in `ObjectGrid`: metadata vocabulary in, adapter
+ * vocabulary out, one translation in one place. The adapter stays monolingual;
+ * the producer owns the translation.
+ *
+ * Mirror, don't move — the same three rules `RelatedList` states:
+ *  - an author-supplied `accessorKey` is NEVER overwritten; a deliberate
+ *    divergence between the table slot and the metadata key belongs to the
+ *    author;
+ *  - the authored spelling is left in place, so a host reading `field` / `name`
+ *    back off these columns keeps working;
+ *  - an entry with neither a resolvable identity nor any display text is
+ *    returned UNTOUCHED — nothing is invented for it. It behaves exactly as it
+ *    does today: a header over empty cells, silently. Whether that silence
+ *    deserves a dev-time diagnostic is objectui#5349's question, and is
+ *    deliberately NOT answered here.
+ *
+ * Returning the INPUT entry by reference when there is nothing to add is load
+ * bearing: data-table re-seeds its column state whenever the list is a new
+ * object (objectui#4618), and this widget rebuilds its node on every render.
  */
 export declare function normalizeColumns(columns: (string | Record<string, any>)[]): NormalizedColumn[];
 /**
@@ -52,9 +85,41 @@ export declare function normalizeColumns(columns: (string | Record<string, any>)
 /**
  * Compute the list of lookup-typed accessors that should be expanded when
  * fetching rows. Returns column accessors whose object schema field type is
- * a relation (lookup/reference/master_detail/user/owner). Used by the
- * dashboard table widget to ask the data adapter to populate referenced
+ * a relation. Which types those are is NOT restated here: it is
+ * {@link EXPANDABLE_FIELD_TYPES}, the family `@object-ui/core` publishes. Used
+ * by the dashboard table widget to ask the data adapter to populate referenced
  * records (e.g. `account: { id, name }`) so cells don't show raw FK ids.
+ *
+ * THE GATE (objectui#4914, ruling B) runs ahead of the relation test. Measured
+ * before the ruling: a `record_owner: { type: 'owner' }` column was ACTIVELY
+ * requested for `$expand` — the retired spelling got the full relational read
+ * path while the same field's editor answered with a tombstone. It is refused
+ * now, loudly and once, and the cell shows the raw id it was always going to
+ * show once the spelling stopped being a relation. That the author is TOLD is
+ * the whole difference between this and the mechanical deletion the
+ * measurement rejected.
+ *
+ * ## The relation test is core's object, not a private copy (objectui#5692)
+ *
+ * It used to be the inline literal
+ * `t === 'lookup' || t === 'reference' || t === 'master_detail' || t === 'user'`
+ * — one of TWO copies this package held (the other `LOOKUP_TYPES` in
+ * `recordFields.tsx`), neither deriving from nor pinned against the family core
+ * publishes. objectui#5312's claim to have converted "the LAST private copy"
+ * was false by these two; they predate that sweep and were outside its file
+ * surface.
+ *
+ * This is the LIVE half of that convergence — `computeLookupExpand` drives a
+ * real `$expand` on every dashboard table fetch — so both membership deltas are
+ * observable here, and both were decided by measurement (see `isLookupType` in
+ * `recordFields.tsx` for the full record):
+ *
+ *  - a `tree` column now GETS `$expand`-ed, the same treatment the form / grid
+ *    road already gives it;
+ *  - a `reference` column no longer does, and that is a no-op on spec-compliant
+ *    data: the spelling is absent from `@objectstack/spec`'s closed `FieldType`
+ *    and refused by `FieldSchema.safeParse`, so no object schema can declare a
+ *    field whose stored type is `reference`.
  */
 export declare function computeLookupExpand(schema: {
     columns?: any[];

package/dist/ObjectDataTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectDataTable.d.ts","sourceRoot":"","sources":["../src/ObjectDataTable.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAgE,MAAM,OAAO,CAAC;AAerF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACrD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6EAA6E;AAC7E,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,gBAAgB,EAAE,CAiB9F;AAED;;;;;;;;;;;;;;;GAeG;AACH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAChD,YAAY,EAAE,GAAG,GAChB,MAAM,EAAE,CAgCV;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAwT1D,CAAC"}
+{"version":3,"file":"ObjectDataTable.d.ts","sourceRoot":"","sources":["../src/ObjectDataTable.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAgE,MAAM,OAAO,CAAC;AA2BrF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACrD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6EAA6E;AAC7E,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAyBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,gBAAgB,EAAE,CAkC9F;AAED;;;;;;;;;;;;;;;GAeG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAChD,YAAY,EAAE,GAAG,GAChB,MAAM,EAAE,CA+CV;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA+U1D,CAAC"}

package/dist/ObjectMetricWidget.d.ts

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { DrillDownConfig } from '@object-ui/types';
+import { DrillDownConfig, I18nLabel } from '@object-ui/types';
 import { CompareToConfig } from './utils';
 /**
  * ObjectMetricWidget — Data-bound metric widget.
@@ -27,31 +27,40 @@ export interface ObjectMetricWidgetProps {
     };
     /** Filter conditions */
     filter?: any;
-    /** Static label for the metric */
-    label: string | {
-        key?: string;
-        defaultValue?: string;
-    };
+    /**
+     * The KPI's heading, in @objectstack/spec's `I18nLabel` vocabulary — a plain
+     * string or an inline per-locale map (`{ en: 'Revenue', 'zh-CN': '收入' }`).
+     *
+     * Was `string | { key?, defaultValue? }` — the key-reference form
+     * objectstack#5055 RETIRED at rc.6. The sibling `MetricWidgetProps` was
+     * migrated for this reason in objectui#4358; this interface was missed in
+     * that pass, and the omission was not inert (objectui#5264). This component
+     * forwards `label` straight to `MetricWidget`, which resolves it with
+     * `pickLocalized`. The retired object hits no locale limb, so resolution
+     * falls through to the last resort — the FIRST string property in insertion
+     * order — and `{ key, defaultValue }` written in that natural order paints
+     * the raw dotted translation key onto the card as its visible label.
+     *
+     * The producer side already says so: `ObjectMetricPropsSchema.label` in
+     * `@objectstack/spec/ui` is `I18nLabelSchema`, and its inline-map key regex
+     * rejects `key`/`defaultValue` by name. This declaration now agrees with it.
+     */
+    label: string | I18nLabel;
     /** Fallback static value (used when no dataSource or in demo mode) */
     fallbackValue?: string | number;
     /** Trend info */
     trend?: {
         value: number;
-        label?: string | {
-            key?: string;
-            defaultValue?: string;
-        };
+        /** Trend caption, same `I18nLabel` vocabulary as {@link ObjectMetricWidgetProps.label}. */
+        label?: string | I18nLabel;
         direction?: 'up' | 'down' | 'neutral';
     };
     /** Icon name or ReactNode */
     icon?: React.ReactNode | string;
     /** Additional CSS class */
     className?: string;
-    /** Description */
-    description?: string | {
-        key?: string;
-        defaultValue?: string;
-    };
+    /** Sub-caption under the value, same `I18nLabel` vocabulary as {@link ObjectMetricWidgetProps.label}. */
+    description?: string | I18nLabel;
     /** External data source (overrides context) */
     dataSource?: any;
     /** Visual color variant for the icon container */
@@ -77,22 +86,27 @@ export interface ObjectMetricWidgetProps {
      * to this metric, filtered by the same `filter` used for aggregation.
      */
     drillDown?: DrillDownConfig;
-    /** Title for the drill-down panel; defaults to the metric label. */
-    title?: string | {
-        key?: string;
-        defaultValue?: string;
-    };
     /**
-     * Period-over-period comparison configuration. When set, the widget
-     * issues a parallel aggregate for the comparison window and derives a
+     * Title for the drill-down panel; defaults to the metric label. Same
+     * `I18nLabel` vocabulary as {@link ObjectMetricWidgetProps.label}, and
+     * resolved through the same `pickLocalized` — see `drawerTitle` below, which
+     * used to read the retired form's `defaultValue` limb directly.
+     */
+    title?: string | I18nLabel;
+    /**
+     * Period-over-period comparison configuration — the executor's own
+     * `{ kind, dimension? }` contract since objectstack#5011. When set, the
+     * widget issues a parallel aggregate for the comparison window and derives a
      * trend (% delta + direction + i18n label like "vs last quarter").
      *
-     * - `'previousPeriod'`: same window length immediately before the current.
-     * - `'previousYear'`: same window shifted back one year.
-     * - `{ offset: '7d' }`: sliding window shifted back by N days/weeks.
+     * - `{ kind: 'previousPeriod' }`: same window length immediately before the current.
+     * - `{ kind: 'previousYear' }`: same window shifted back one year.
      *
-     * Has no effect when no `filter` (or no date filter) is provided — the
-     * shift uses the filter's date range to compute the comparison window.
+     * `dimension` is not read on this inline path — it names the dataset time
+     * dimension the EXECUTOR shifts, and this path shifts the widget's own
+     * `filter` instead. Has no effect when no `filter` (or no date filter) is
+     * provided — the shift uses the filter's date range to compute the
+     * comparison window.
      */
     compareTo?: CompareToConfig;
     /** Optional i18n translator used to localize the trend label. */

package/dist/ObjectMetricWidget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectMetricWidget.d.ts","sourceRoot":"","sources":["../src/ObjectMetricWidget.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAgE,MAAM,OAAO,CAAC;AAIrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIxD,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,uBAAuB;IACtC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,wBAAwB;IACxB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,iBAAiB;IACjB,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,GAAG;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACzD,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;KACvC,CAAC;IACF,6BAA6B;IAC7B,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC;IAChC,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,+CAA+C;IAC/C,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpG,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,iEAAiE;IACjE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAuVhE,CAAC"}
+{"version":3,"file":"ObjectMetricWidget.d.ts","sourceRoot":"","sources":["../src/ObjectMetricWidget.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAgE,MAAM,OAAO,CAAC;AAIrF,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAInE,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,uBAAuB;IACtC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,wBAAwB;IACxB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,iBAAiB;IACjB,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,2FAA2F;QAC3F,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;KACvC,CAAC;IACF,6BAA6B;IAC7B,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC;IAChC,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yGAAyG;IACzG,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,+CAA+C;IAC/C,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpG,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,iEAAiE;IACjE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAmWhE,CAAC"}

package/dist/ObjectPivotTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectPivotTable.d.ts","sourceRoot":"","sources":["../src/ObjectPivotTable.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAkD,MAAM,OAAO,CAAC;AAQvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gBAAgB,GAAG;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACrD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,GAAG,CAAC;KACd,CAAC;IACF,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAoO5D,CAAC"}
+{"version":3,"file":"ObjectPivotTable.d.ts","sourceRoot":"","sources":["../src/ObjectPivotTable.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAA0C,MAAM,OAAO,CAAC;AAQ/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAwBzD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gBAAgB,GAAG;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACrD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,GAAG,CAAC;KACd,CAAC;IACF,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAyO5D,CAAC"}

package/dist/PivotTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PivotTable.d.ts","sourceRoot":"","sources":["../src/PivotTable.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAWlE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CAC3C;AAyDD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAkD,CAAC;AAwBtG;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAgRhD,CAAC"}
+{"version":3,"file":"PivotTable.d.ts","sourceRoot":"","sources":["../src/PivotTable.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAWlE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CAC3C;AAiFD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAkD,CAAC;AAwBtG;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAoRhD,CAAC"}

package/dist/RecordDetailDrawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecordDetailDrawer.d.ts","sourceRoot":"","sources":["../src/RecordDetailDrawer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAkB,MAAM,OAAO,CAAC;AAcvC,MAAM,WAAW,uBAAuB;IACtC,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACnC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,gDAAgD;IAChD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAgBD,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAgFhE,CAAC"}
+{"version":3,"file":"RecordDetailDrawer.d.ts","sourceRoot":"","sources":["../src/RecordDetailDrawer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAkB,MAAM,OAAO,CAAC;AAcvC,MAAM,WAAW,uBAAuB;IACtC,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACnC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,gDAAgD;IAChD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAgBD,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAkFhE,CAAC"}

package/dist/WidgetConfigPanel.d.ts

@@ -1,4 +1,6 @@
+import { ConfigPanelSchema } from '@object-ui/components';
 import { WidgetDatasetCatalogEntry } from './dataset-catalog';
+import { ConfigPanelTranslate } from './useConfigPanelTranslation';
 /**
  * ObjectUI
  * Copyright (c) 2024-present ObjectStack Inc.
@@ -8,6 +10,7 @@ import { WidgetDatasetCatalogEntry } from './dataset-catalog';
  */
 import * as React from 'react';
 export declare function supportsDrillDown(t: string | undefined): boolean;
+export declare function buildWidgetSchema(t: ConfigPanelTranslate, datasets: WidgetDatasetCatalogEntry[] | undefined, widgetType?: string): ConfigPanelSchema;
 export interface WidgetConfigPanelProps {
     /** Whether the panel is open */
     open: boolean;
@@ -31,6 +34,31 @@ export interface WidgetConfigPanelProps {
     /** Whether the dataset catalog is still loading (reserved for future UX). */
     datasetsLoading?: boolean;
 }
+/**
+ * Put the `I18nLabel` keys of a draft back into the shape they were stored in.
+ *
+ * The draft carries ONE string per label key — the active locale's, which is
+ * what the text input can hold. Persisting that string as the whole value is
+ * the data loss this card is about, so before a save each label key is mapped
+ * back against the value the panel was handed:
+ *
+ * - stored value is a plain string (or absent): nothing was ever collapsed, so
+ *   the draft's string is already the correct whole value — passed through.
+ * - stored value is a map and the draft's string still equals what the panel
+ *   DISPLAYED: the author never touched this field, so the **original object is
+ *   returned by reference**. An untouched title survives an unrelated config
+ *   edit byte-identically — the round trip the ruling requires, and the reason
+ *   this is an identity restore rather than a rebuild that would happen to
+ *   produce an equal object (a rebuild would add an entry for the active locale
+ *   to a map that never had one).
+ * - stored value is a map and the string differs: the edit lands in the active
+ *   locale's entry via `setLocalized`, every other locale preserved.
+ *
+ * Exported for direct unit testing — the panel path reaches it only through
+ * `useConfigDraft`, so a component test alone would be asserting that hook's
+ * behaviour as much as this rule.
+ */
+export declare function restoreI18nLabels(draft: Record<string, any>, source: Record<string, any>, language: string | undefined): Record<string, any>;
 export declare function sanitizeDraftForType(draft: Record<string, any>): Record<string, any>;
 export declare function WidgetConfigPanel({ open, onClose, config, onSave, onFieldChange, headerExtra, datasets, datasetsLoading: _datasetsLoading, }: WidgetConfigPanelProps): React.JSX.Element;
 //# sourceMappingURL=WidgetConfigPanel.d.ts.map

package/dist/WidgetConfigPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetConfigPanel.d.ts","sourceRoot":"","sources":["../src/WidgetConfigPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AA4DnE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEhE;AAoVD,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,wCAAwC;IACxC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC9C,oCAAoC;IACpC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACpD,oEAAoE;IACpE,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACvC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAgCD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAMpF;AAED,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,OAAO,EACP,MAAM,EACN,MAAM,EACN,aAAa,EACb,WAAW,EACX,QAAQ,EACR,eAAe,EAAE,gBAAgB,GAClC,EAAE,sBAAsB,qBA8BxB"}
+{"version":3,"file":"WidgetConfigPanel.d.ts","sourceRoot":"","sources":["../src/WidgetConfigPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,OAAO,KAAK,EAAE,iBAAiB,EAAe,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AA8ErC,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEhE;AA4ID,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,oBAAoB,EACvB,QAAQ,EAAE,yBAAyB,EAAE,GAAG,SAAS,EACjD,UAAU,CAAC,EAAE,MAAM,GAClB,iBAAiB,CAmNnB;AAMD,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,wCAAwC;IACxC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC9C,oCAAoC;IACpC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACpD,oEAAoE;IACpE,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACvC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA+CD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgBrB;AA4BD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAOpF;AAED,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,OAAO,EACP,MAAM,EACN,MAAM,EACN,aAAa,EACb,WAAW,EACX,QAAQ,EACR,eAAe,EAAE,gBAAgB,GAClC,EAAE,sBAAsB,qBAiExB"}

package/dist/colorVariants.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The dashboard renderer's `colorVariant` tokens — ONE table, shared by every
+ * surface that paints a KPI accent.
+ *
+ * The vocabulary is `@objectstack/spec`'s `WidgetColorVariantSchema` enum
+ * (`packages/spec/src/ui/dashboard.zod.ts`), mirrored by the designer's swatch
+ * picker (`app-shell/.../color-variant-field.tsx` — "Canonical semantic
+ * palette"). Those three lists must state the same eight tokens; a renderer
+ * that invented a ninth variant, or dropped one, would turn a
+ * declared-but-unenforced key into the harder bug: two disagreeing
+ * declarations. The picker carries three EXTRA display-only aliases
+ * (`green`/`red`/`amber`) so a swatch can still be drawn for an off-spec
+ * stored value — deliberately NOT honoured here (see `metricAccentTextClass`).
+ *
+ * Class strings stay static literals so Tailwind's content scanner sees them
+ * (`apps/console/src/index.css` sources this package's `src/**`).
+ */
+export type MetricColorVariant = 'default' | 'blue' | 'teal' | 'orange' | 'purple' | 'success' | 'warning' | 'danger';
+/**
+ * Icon-chip classes per variant — a soft background + bold foreground that
+ * tints the icon container while the rest of the card stays in the neutral
+ * Shadcn palette. Used by the card-chrome KPI layout (`MetricWidget`).
+ */
+export declare const VARIANT_ICON_CLASSES: Record<MetricColorVariant, string>;
+/** Text-colour per variant — tints the big number on the chrome-less
+ *  (`bare` / dataset-bound) KPI layouts, which have no icon chip to carry the
+ *  accent. */
+export declare const VARIANT_TEXT_CLASSES: Record<MetricColorVariant, string>;
+/**
+ * Resolve a widget's declared `colorVariant` to the accent text class for a
+ * KPI that already renders in the ambient foreground colour, or `undefined`
+ * when there is no accent to add.
+ *
+ * `undefined` is returned for three distinct inputs, and the caller wants the
+ * same thing in all three — emit no extra class at all:
+ *
+ *  - **not declared** — the widget said nothing, so its markup must not change
+ *    (objectui#3359 pins this byte-for-byte);
+ *  - **`'default'`** — the enum's own name for "no accent". Painting the
+ *    explicit `text-foreground` here would be a no-op on a surface that
+ *    already inherits it, and would make `colorVariant: 'default'` differ from
+ *    omitting the key purely in class-attribute bytes;
+ *  - **off-spec token** (`'chartreuse'`, or the picker's display-only
+ *    `'green'`/`'red'`/`'amber'` aliases) — deliberately no accent and no
+ *    aliasing. The spec enum rejects these where the metadata is authored and
+ *    published; teaching the renderer to accept a second spelling would
+ *    fossilize a dialect the contract does not have (AGENTS.md #0.1). A
+ *    cosmetic key is also the wrong place to fail a widget's whole render,
+ *    hence "no accent" rather than an error.
+ *
+ * `MetricWidget`'s own layouts keep indexing `VARIANT_TEXT_CLASSES` /
+ * `VARIANT_ICON_CLASSES` directly — they take a defaulted prop, so `'default'`
+ * genuinely resolves to a class there.
+ */
+export declare function metricAccentTextClass(value: unknown): string | undefined;
+//# sourceMappingURL=colorVariants.d.ts.map

package/dist/colorVariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorVariants.d.ts","sourceRoot":"","sources":["../src/colorVariants.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GACjD,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CASnE,CAAC;AAEF;;cAEc;AACd,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CASnE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGxE"}

package/dist/domPassthroughPins.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export {};
+//# sourceMappingURL=domPassthroughPins.d.ts.map

package/dist/domPassthroughPins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domPassthroughPins.d.ts","sourceRoot":"","sources":["../src/domPassthroughPins.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsHH,OAAO,EAAE,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { default as React } from 'react';
 import { DashboardRenderer } from './DashboardRenderer';
 import { DashboardGridLayout } from './DashboardGridLayout';
 import { MetricWidget } from './MetricWidget';
@@ -12,18 +13,22 @@ import { DashboardWithConfig } from './DashboardWithConfig';
 import { DrillDownDrawer } from './DrillDownDrawer';
 export { DashboardRenderer, DashboardGridLayout, MetricWidget, MetricCard, ObjectMetricWidget, PivotTable, ObjectPivotTable, ObjectDataTable, DashboardConfigPanel, WidgetConfigPanel, DashboardWithConfig, DrillDownDrawer };
 export type { WidgetConfigPanelProps } from './WidgetConfigPanel';
+export { CONFIG_PANEL_DEFAULT_TRANSLATIONS, useConfigPanelTranslation, type ConfigPanelTranslate, } from './useConfigPanelTranslation';
 export type { WidgetDatasetCatalogEntry, WidgetDatasetDimension, WidgetDatasetMeasure, } from './dataset-catalog';
 export declare const dashboardComponents: {
-    DashboardRenderer: import('react').ForwardRefExoticComponent<Omit<import('./DashboardRenderer').DashboardRendererProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
-    DashboardGridLayout: import('react').FC<import('./DashboardGridLayout').DashboardGridLayoutProps>;
-    MetricWidget: ({ label, value, trend, icon, className, description, loading, error, colorVariant, format, currency, prefix, suffix, onClick, variant, ...props }: import('./MetricWidget').MetricWidgetProps) => import("react").JSX.Element;
-    MetricCard: import('react').FC<import('./MetricCard').MetricCardProps>;
-    ObjectMetricWidget: import('react').FC<import('./ObjectMetricWidget').ObjectMetricWidgetProps>;
-    PivotTable: import('react').FC<import('./PivotTable').PivotTableProps>;
-    ObjectPivotTable: import('react').FC<import('./ObjectPivotTable').ObjectPivotTableProps>;
-    ObjectDataTable: import('react').FC<import('./ObjectDataTable').ObjectDataTableProps>;
-    DashboardConfigPanel: typeof DashboardConfigPanel;
-    WidgetConfigPanel: typeof WidgetConfigPanel;
-    DashboardWithConfig: typeof DashboardWithConfig;
+    dashboard: React.ForwardRefExoticComponent<import('./DashboardRenderer').DashboardRendererProps & React.RefAttributes<HTMLDivElement>>;
+    metric: ({ label, value, trend, icon, className, description, loading, error, colorVariant, format, currency, prefix, suffix, onClick, variant, schema: _schema, bind: _bind, events: _events, props: _propsBag, ariaLabel: _ariaLabel, ariaDescribedBy: _ariaDescribedBy, dataSource: _dataSource, ...domProps }: import('./MetricWidget').MetricWidgetProps & import('./schemaHostProps').SchemaHostProps) => React.JSX.Element;
+    'metric-card': React.FC<import('./MetricCard').MetricCardProps & import('./schemaHostProps').SchemaHostProps>;
+    'object-metric': React.FC<{
+        [key: string]: any;
+        schema?: any;
+    }>;
+    pivot: React.FC<import('./PivotTable').PivotTableProps>;
+    'object-pivot': React.FC<{
+        [key: string]: any;
+        schema?: any;
+    }>;
+    'dashboard-grid': React.FC<import('./DashboardGridLayout').DashboardGridLayoutProps>;
+    'object-data-table': React.FC<import('./ObjectDataTable').ObjectDataTableProps>;
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAC;AAC9N,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EACV,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAwM3B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;CAY/B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAC;AAC9N,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAKlE,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAyV3B,eAAO,MAAM,mBAAmB;;;;;;iBAnNa,GAAG;;;;;iBAmHJ,GAAG;;;;CAyG9C,CAAC"}