@object-ui/plugin-dashboard 17.5.0 → 17.7.0

package/dist/measureRefusal.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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.
+ */
+/**
+ * objectui#8894 — what the widget door says about a widget's MEASURES.
+ *
+ * Returns the message of the `custom` issue objectui's authoring door raises at
+ * `values` for this type, these measures and these dimensions, or `undefined`
+ * when the door accepts them. The door is `DashboardWidgetSchema` from
+ * `@object-ui/types/zod`, which re-attaches the spec's own object-level checks,
+ * so its verdict and its message are the spec's (pinned by
+ * `packages/types/src/__tests__/dashboard-widget-metric-measure-door-8894.test.ts`).
+ *
+ * The door is ASKED, never restated: no widget-type list lives here. Whichever
+ * types the spec refuses a second measure on — the metric family since
+ * `@objectstack/spec` 17.5.0 (`checkDashboardWidgetMetricMeasureArity`), and
+ * any further shape once a spec release refuses it and the mirror re-attaches
+ * that check (objectstack#20958 is the pending one) — the authoring pickers that
+ * read this follow without an edit here.
+ *
+ * Only the keys a measure rule reads go into the probe — `id` (the message
+ * names it), `type`, `values` and `dimensions` — each kept to a shape the door
+ * accepts. zod skips object-level checks once a field-level issue aborts the
+ * parse, and a draft in an editor is half-written by nature: measured on the
+ * mirror, a numeric `id`, a non-string dimension or a malformed `title`
+ * anywhere in the document each hide the measure verdict completely, which
+ * would read as "accepted". The probe keeps those faults out of the question it
+ * asks.
+ *
+ * Module-private to this package (not re-exported from its index).
+ */
+export declare function measureRefusal(widget: {
+    id?: unknown;
+    type?: unknown;
+    values?: unknown;
+    dimensions?: unknown;
+}): string | undefined;
+/**
+ * A stand-in for "one more measure", used to ask the door whether a picker may
+ * offer another one before the author has chosen which. The door's measure
+ * rules judge how many measures a widget declares, not their names (whether a
+ * measure exists in the bound dataset is out of the widget schema's reach), so
+ * any name the widget does not already carry asks the same question.
+ */
+export declare const NEXT_MEASURE_PROBE = "__next_measure__";
+//# sourceMappingURL=measureRefusal.d.ts.map

package/dist/measureRefusal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measureRefusal.d.ts","sourceRoot":"","sources":["../src/measureRefusal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,GAAG,SAAS,CAgBrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,qBAAqB,CAAC"}

package/dist/recordFields.d.ts

@@ -8,6 +8,74 @@ export declare const SYSTEM_FIELDS: Set<string>;
 export declare function isSystemField(name: string, def?: any): boolean;
 /** Numeric-flavoured field types (right-aligned in tables). */
 export declare const NUMERIC_FIELD_TYPES: Set<string>;
+/**
+ * The override vocabulary this package's two field surfaces share.
+ *
+ * ⚠️ This type is a DERIVATION SOURCE, not only a shape: `ObjectDataTable`'s
+ * two column bands are both `Exclude<keyof FieldMeta, …>` — `EnrichedColumn`'s
+ * write-side tombstones (objectui#6373) and `AuthoredColumnOverrides`' read-side
+ * refusal band (objectui#6425). So a member REMOVED here silently leaves both
+ * bands, and any refusal that rode on its membership stops enforcing with
+ * nothing going red. A member being retired must therefore be re-refused
+ * explicitly at that seam before it leaves this type — see
+ * `ObjectDataTableRetiredDecimalsTombstone` in `ObjectDataTable.tsx`, which is
+ * what `decimals` left behind.
+ *
+ * ⛔ `decimals` was RETIRED from this type by objectui#6625 — written from the
+ * schema def on every call and read by nothing (zero `.decimals` member reads
+ * across `@object-ui/fields`, `@object-ui/i18n`, `@object-ui/components`,
+ * `@object-ui/core` and this package, measured against a `.scale` positive
+ * control that hits `NumberField.tsx` / `GridField.tsx` / `index.tsx`). If a
+ * reader is ever wanted here it reads `scale` — the field def's decimal-places
+ * key, which is what the retired write resolved to anyway and what
+ * `NumberCellRenderer` already reads (`precision` is the total digit count, a
+ * different question — objectui#2131). ⛔ Do not resurrect `decimals`.
+ *
+ * ⛔ `referenceTo` was RETIRED from this type by objectui#6597 (enforce-or-remove,
+ * withdraw branch — maintainer's standing startup-stage rule, 2026-08-27: no
+ * measured demand retires immediately). It was documented by this package's
+ * README as an author-facing column override, but the promise was never kept:
+ * `LookupCellRenderer` (`@object-ui/fields`) resolves its lookup target from
+ * `field.reference_to` / `field.reference` — never `field.referenceTo` — and
+ * `computeLookupExpand` (`ObjectDataTable.tsx`) builds `$expand` from the OBJECT
+ * SCHEMA's field types, never from an authored override. Measured with the
+ * `referenceTo`-vs-`options` positive control in
+ * `ObjectDataTable.overrideSource-6425.test.tsx`: `options` (a live override)
+ * separates two equal-valued columns, `referenceTo` does not — an authored
+ * override renders byte-identical to its absence. No authoring story survived
+ * the search either: the sibling `ObjectGrid` producer's own relational-meta
+ * pass-through (`applyRelationalMeta`, `plugin-grid/src/ObjectGrid.tsx`) copies
+ * `reference_to` / `reference` from the SCHEMA field def only, never from an
+ * authored column override, and no example/doc/fixture in this repo shows a
+ * table column pinning a lookup's target to something other than what its
+ * schema field already says. If a reader for the resolved reference target is
+ * ever wanted here, it reads `reference_to` / `reference` off the schema field
+ * def directly — the spelling `LookupCellRenderer` and `computeLookupExpand`
+ * actually use. ⛔ Do not resurrect `referenceTo`.
+ *
+ * ⭐ That reader ARRIVED (objectui#6694): `reference` / `displayField` below
+ * (with `reference_to` beside them until objectui#11070 round 4 retired it,
+ * and `display_field` until objectui#11070's text-family round did), copied
+ * from the SCHEMA field def by {@link buildFieldMeta} and justified per key on
+ * `CELL_RELATIONAL_META_KEYS`.
+ * They are the "future reader" both retirement notes predicted, in the spelling
+ * they named, and they change neither verdict — the source is the schema field
+ * def, never an authored column override, which is the exact distinction
+ * objectui#6597 measured and withdrew on.
+ *
+ * ⚠️ Being `FieldMeta` members they GROW both derived bands in
+ * `ObjectDataTable.tsx` — `EnrichedColumn`'s emit tombstones and
+ * `UnheldFieldMetaOverrideKey`'s read-side refusal. `reference_to` left the
+ * type in objectui#11070 round 4 and `display_field` in its text-family round,
+ * so — by the rule at the top of this docblock — each one's refusal is
+ * re-stated by hand there (`ObjectDataTableRetiredReferenceToSnakeTombstone`,
+ * `ObjectDataTableRetiredDisplayFieldSnakeTombstone`). That is the intended
+ * verdict rather than a side effect: an AUTHORED column may not source a
+ * lookup's reference target (objectui#6597 measured no authoring story for
+ * one), while the schema-derived write is reached by neither band. They landed
+ * in both without anyone editing a list — the property this derivation exists
+ * for.
+ */
 export interface FieldMeta {
     name: string;
     label: string;
@@ -17,10 +85,34 @@ export interface FieldMeta {
         label: string;
         color?: string;
     }>;
-    referenceTo?: unknown;
     format?: string;
     currency?: string;
-    decimals?: number;
+    /**
+     * The field def's declared upper bound, which on a `percent` field is its
+     * STORAGE statement: the spec's `percentScaleOf` reads a fraction unless
+     * `max` is above 1 (objectui#11475). Copied from the SCHEMA field def by
+     * {@link buildFieldMeta} so the percent cell and the `%` branch of
+     * {@link renderFieldValue} read the field's storage rather than guess it
+     * from the value. Never an authored column override: as a `FieldMeta`
+     * member it lands in `ObjectDataTable`'s read-side refusal band, which is
+     * the intended verdict — a column may not restate how its field stores.
+     */
+    max?: number;
+    /**
+     * Lookup target object — the spelling `@objectstack/spec`'s `FieldSchema`
+     * declares and the only one `LookupCellRenderer` reads. Its snake_case twin
+     * `reference_to` was RETIRED from this type by objectui#11070 round 4.
+     */
+    reference?: string;
+    /**
+     * Author-declared display field on the lookup, in the SPEC spelling
+     * (`FieldSchema.displayField`) — it beats every resolver in the cell. The
+     * first leg of `LookupCellRenderer`'s `displayField || reference_field`
+     * chain, and the only leg a spec-compliant producer can emit
+     * (objectui#6875). Its snake_case twin `display_field` was RETIRED from this
+     * type by objectui#11070's text-family round: no reader read it.
+     */
+    displayField?: string;
 }
 /**
  * Normalize an object schema's `fields` into a `{ name → def }` map. Accepts
@@ -37,20 +129,39 @@ export interface BuildFieldMetaParams {
     objectName?: string;
     /** Translator for per-option labels (from `useSafeFieldLabel`). */
     fieldOptionLabel?: (objectName: string, field: string, value: string, fallback: string) => string;
-    /** Per-column overrides (table columns may pin type/format/options). */
+    /**
+     * Per-column overrides (table columns may pin type/format/options).
+     *
+     * A subset of {@link FieldMeta}, which is what makes that type the pool
+     * `ObjectDataTable`'s refusal band derives from. `decimals` left with the
+     * member (objectui#6625): its last feeder went when objectui#6425's ruling
+     * removed the authored read from `ObjectDataTable.enrich()`, and
+     * `RecordDetailDrawer` — the only other caller — passes no overrides at all.
+     * `referenceTo` left the same way (objectui#6597): `ObjectDataTable.enrich()`
+     * no longer reads it off the authored column, and `RecordDetailDrawer` never
+     * did.
+     */
     overrides?: {
         type?: string;
         format?: string;
         options?: any;
-        referenceTo?: unknown;
         currency?: string;
-        decimals?: number;
     };
 }
 /**
- * Build the `FieldMeta` for a single field, resolving `referenceTo`, currency
- * and decimals from the schema field def and translating select options.
- * Column-level overrides win over schema-derived values.
+ * Build the `FieldMeta` for a single field, resolving currency from the
+ * schema field def and translating select options. Column-level overrides
+ * win over schema-derived values.
+ *
+ * The field def's currency goes through `resolveFieldCurrency`
+ * (`@object-ui/i18n`) rather than a chain of this helper's own (objectui#10463).
+ * The resolver is what reads `currencyConfig`, the spec's one fixed-currency
+ * declaration, and only under `currencyMode: 'fixed'`. The chain it replaced
+ * read the flat `currency` / `defaultCurrency` spellings only, so a fixed
+ * field painted in the tenant currency in both the table cell and the record
+ * drawer. The call passes NO tenant default: `renderFieldValue` backstops with
+ * the tenant only after the symbol it infers from a `format`, and a tenant code
+ * resolved here would jump ahead of that symbol.
  */
 export declare function buildFieldMeta(params: BuildFieldMetaParams): FieldMeta;
 /** Whether a `FieldMeta` should be right-aligned (numeric / currency / percent). */
@@ -65,6 +176,45 @@ export declare function isNumericFieldMeta(fieldMeta: Pick<FieldMeta, 'type' | '
  * cell and the record-detail drawer honor the tenant default.
  */
 export declare function renderFieldValue(value: any, fieldMeta: FieldMeta, tenantCurrency?: string, displayLocale?: string): React.ReactNode;
-/** Whether a field is a relation/lookup (used to drive `$expand`). */
+/**
+ * Whether a field is a relation/lookup (used to drive `$expand`).
+ *
+ * THE GATE (objectui#4914, ruling B) runs ahead of the membership test.
+ * Measured before the ruling: `isLookupType('owner')` was `true` — a retired
+ * spelling holding first-class relation status. It answers `false` now, and
+ * says why once.
+ *
+ * The membership half is no longer a private table (objectui#5692). It used to
+ * be `new Set(['lookup', 'reference', 'master_detail', 'user'])`, one of TWO
+ * copies this package held — the other inline in `computeLookupExpand` — and
+ * neither derived from nor pinned against {@link EXPANDABLE_FIELD_TYPES}, the
+ * family `@object-ui/core` publishes for exactly this question. 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.
+ *
+ * The convergence moved membership in two directions, each decided by
+ * measurement rather than by preference (objectui#5692):
+ *
+ *  - `tree` is GAINED. A self-referencing hierarchy field is reference-bearing,
+ *    it is a member of the spec's closed `FieldType`, and the form / grid road
+ *    already `$expand`s it. The dashboard road giving it the same treatment is
+ *    family behaviour restored, not a new decision.
+ *  - `reference` is DROPPED, and dropping it is a no-op on spec-compliant data.
+ *    The spelling is absent from `@objectstack/spec`'s closed `FieldType`
+ *    vocabulary and is refused by `FieldSchema.safeParse` — measured with
+ *    `lookup` / `master_detail` / `user` / `tree` as live controls and the
+ *    retired `owner` plus a nonsense spelling as dead ones — so no
+ *    spec-compliant object schema can declare a field whose stored type is
+ *    `reference`. Where the spelling IS live it is a legacy DIALECT alias on the
+ *    action-param surface, folded to `lookup` before any field-type data is read
+ *    (`PARAM_TYPE_ALIASES` in `app-shell/src/utils/paramToField.ts`). Keeping it
+ *    here would be a lenient renderer-side alias for off-spec metadata, which is
+ *    what AGENTS.md #0.1 bans.
+ *
+ * Extending this surface later: OR in a second, surface-local set, the way the
+ * object form's `needsDataSourceWiring` does. Never
+ * `new Set([...EXPANDABLE_FIELD_TYPES, …])` — a copy re-forks the table, which
+ * is the defect this change removed, and the identity pin fails on it by design.
+ */
 export declare function isLookupType(t: unknown): boolean;
 //# sourceMappingURL=recordFields.d.ts.map

package/dist/recordFields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recordFields.d.ts","sourceRoot":"","sources":["../src/recordFields.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B;;;GAGG;AACH,eAAO,MAAM,aAAa,aAIxB,CAAC;AAEH,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAG9D;AAKD,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,aAE9B,CAAC;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAUxE;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAClG,wEAAwE;IACxE,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC;QACd,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAoCtE;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,OAAO,CAKzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,SAAS,EACpB,cAAc,CAAC,EAAE,MAAM,EAKvB,aAAa,CAAC,EAAE,MAAM,GACrB,KAAK,CAAC,SAAS,CAqBjB;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAEhD"}
+{"version":3,"file":"recordFields.d.ts","sourceRoot":"","sources":["../src/recordFields.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAyB1B;;;GAGG;AACH,eAAO,MAAM,aAAa,aAIxB,CAAC;AAEH,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAG9D;AAKD,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,aAE9B,CAAC;AAyIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAUxE;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAClG;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CA8CtE;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,OAAO,CAKzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,SAAS,EACpB,cAAc,CAAC,EAAE,MAAM,EAKvB,aAAa,CAAC,EAAE,MAAM,GACrB,KAAK,CAAC,SAAS,CA4EjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAMhD"}

package/dist/retired-node-types.d.ts

@@ -0,0 +1,29 @@
+import { default as React } from 'react';
+/**
+ * The bare name of every retired spelling, mapped to the refusal text the
+ * tombstone renders and logs. Keyed by the BARE name because that is what
+ * `ComponentRegistry.register` takes; the namespace is spelled at the call.
+ *
+ * The message names BOTH halves deliberately — the spelling that was written
+ * and the spelling that replaces it. A refusal that only says "unknown" is the
+ * one this table exists to stop being.
+ */
+export declare const RETIRED_DASHBOARD_NODE_TYPES: Readonly<Record<string, string>>;
+/**
+ * Log a retired node-type spelling once. Exported for the pin test, which has
+ * to be able to observe a SECOND occurrence being suppressed without inventing
+ * its own copy of the set.
+ */
+export declare function reportRetiredDashboardNodeType(spelling: string): void;
+/** Test seam: forget what has been reported, so a pin can measure the first one. */
+export declare function resetRetiredDashboardNodeTypeReports(): void;
+/**
+ * The widget a RETIRED dashboard node-type spelling renders.
+ *
+ * The rendered text and the logged text are the SAME string, read from
+ * {@link RETIRED_DASHBOARD_NODE_TYPES}. A pin that asserts only "nothing
+ * rendered" cannot tell this refusal apart from the key having been deleted
+ * outright, which is why the text is part of the contract and not decoration.
+ */
+export declare const RetiredDashboardNodeTombstone: React.FC<Record<string, unknown>>;
+//# sourceMappingURL=retired-node-types.d.ts.map

package/dist/retired-node-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retired-node-types.d.ts","sourceRoot":"","sources":["../src/retired-node-types.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxE,CAAC;AAKH;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOrE;AAED,oFAAoF;AACpF,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwB3E,CAAC"}

package/dist/useConfigPanelTranslation.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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.
+ */
+/**
+ * Default English translations for the dashboard config panels.
+ *
+ * Used as the fallback when no `I18nProvider` is available (standalone embeds,
+ * the preview gallery, this package's own unit tests). Every row's key exists
+ * in all ten packs and every row's value equals the `en` pack's.
+ */
+export declare const CONFIG_PANEL_DEFAULT_TRANSLATIONS: Record<string, string>;
+/**
+ * Safe translation hook for the dashboard config panels.
+ *
+ * Falls back to {@link CONFIG_PANEL_DEFAULT_TRANSLATIONS} when no
+ * `I18nProvider` is mounted. The name matches the repo's `use*Translation`
+ * convention, which is what `scripts/check-i18n-call-site-keys.mjs` classifies
+ * as a pack-backed translator — so every key the panels ask for is checked
+ * against the `en` pack, and `scripts/check-i18n-dead-keys.mjs` sees the
+ * namespace as read.
+ */
+export declare const useConfigPanelTranslation: () => {
+    t: (key: string, options?: Record<string, unknown>) => string;
+    language: string;
+} | {
+    t: import('i18next').TFunction<string, undefined>;
+    language: string;
+};
+/** The translate function the schema builders receive. */
+export type ConfigPanelTranslate = (key: string, options?: Record<string, unknown>) => string;
+//# sourceMappingURL=useConfigPanelTranslation.d.ts.map

package/dist/useConfigPanelTranslation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConfigPanelTranslation.d.ts","sourceRoot":"","sources":["../src/useConfigPanelTranslation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+CH;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAuHpE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;4BA1LrC,CAAC;;;;;CA6LD,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAAG,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC"}

package/dist/useDashboardAutoRefresh.d.ts

@@ -0,0 +1,47 @@
+import { DashboardComponentSchema } from '@object-ui/types';
+/**
+ * The dashboard auto-refresh timer: ONE implementation, two mount points
+ * (objectui#8820).
+ *
+ * `DashboardGridLayout` and `DashboardRenderer` each used to carry their own
+ * copy of the same three things: a `refreshing` flag, a `handleRefresh`
+ * callback shared by the manual "Refresh All" button and the timer, and an
+ * effect that read the authored period and drove `setInterval`. The copies were
+ * identical in logic, and two copies of one rule is two places to change and
+ * one place to forget: the `refreshInterval` to `refreshIntervalSeconds` rename
+ * (objectui#7783) had to be made twice, and a copy that drifted would still
+ * pass its own component's tests.
+ *
+ * This hook is that logic, moved here. Both surfaces call it, so the authored
+ * period is read in exactly one place.
+ *
+ * - The period is `refreshIntervalSeconds`, in seconds, and nothing else. The
+ *   retired `refreshInterval` spelling is refused by the spec's
+ *   `DashboardSchema`, so no fallback reads it (AGENTS.md #0.1).
+ * - The timer runs only when the host wired `onRefresh` AND the period is
+ *   greater than zero: an absent period, `0` and a negative value all mean
+ *   "off".
+ * - The interval is armed on VALUES only: the period and whether a handler is
+ *   wired. The handler itself is read through a ref when a run happens, so a
+ *   new handler identity, from the host or from React discarding a memo, never
+ *   re-arms the interval or moves its phase, and the run still calls the
+ *   CURRENT handler (AGENTS.md #10, objectui#11004).
+ * - The indicator clears itself 600ms after each run, manual or timed.
+ *
+ * `__tests__/dashboardAutoRefreshTimer.test.tsx` mounts both surfaces and
+ * counts `onRefresh` calls under fake timers. It pins the first three points,
+ * the third under a forced memo discard; nothing pins the 600ms indicator.
+ */
+/** What a dashboard surface needs to drive its refresh affordance. */
+export interface DashboardAutoRefresh {
+    /** True while a refresh is in flight; drives the spinner and disables the button. */
+    refreshing: boolean;
+    /** Run a refresh now. Wired to both the manual button and the timer. */
+    handleRefresh: () => void;
+}
+/**
+ * Owns the refresh indicator, the manual refresh handler, and the auto-refresh
+ * interval for one dashboard surface.
+ */
+export declare function useDashboardAutoRefresh(schema: DashboardComponentSchema, onRefresh?: () => void): DashboardAutoRefresh;
+//# sourceMappingURL=useDashboardAutoRefresh.d.ts.map

package/dist/useDashboardAutoRefresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDashboardAutoRefresh.d.ts","sourceRoot":"","sources":["../src/useDashboardAutoRefresh.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,UAAU,EAAE,OAAO,CAAC;IACpB,wEAAwE;IACxE,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAoBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,wBAAwB,EAChC,SAAS,CAAC,EAAE,MAAM,IAAI,GACrB,oBAAoB,CAsCtB"}

package/dist/utils.d.ts

@@ -1,10 +1,4 @@
-/**
- * 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.
- */
+import { useObjectLabel, useObjectTranslation } from '@object-ui/i18n';
 /** Returns true when the widget data config uses provider: 'object' (async data source). */
 export declare function isObjectProvider(widgetData: unknown): widgetData is {
     provider: 'object';
@@ -21,6 +15,41 @@ export declare function isObjectProvider(widgetData: unknown): widgetData is {
  * path derives headers with it when no columns were declared at all.
  */
 export declare function humanizeFieldKey(key: string): string;
+/**
+ * Resolve a chart series label — the SINGLE authority both dashboard relays
+ * (`DashboardRenderer`, `DashboardGridLayout`) call, so the three-arm decision
+ * below lives once instead of as two copies that could drift.
+ *
+ * Originated as a `DashboardRenderer`-local `useCallback` (objectui#9055,
+ * which fixed arms 2 and 3 there). `DashboardGridLayout` composed
+ * `series: [{ dataKey }]` with no `label` key on either of its branches — the
+ * legend and tooltip rendered the raw field key while the sibling relay's
+ * chart for the same widget rendered the humanized one (objectui#9172). That
+ * card is what moved this here rather than growing a second copy of the
+ * three-arm logic: a helper duplicated across the two relays is exactly the
+ * "one value, two spellings" class `56f4e34c0` ruled out.
+ *
+ * ⭐ THREE ARMS, and only the last two derive a display string from a FIELD
+ * KEY:
+ *
+ *   arm 1  synthetic y-field ('value' / 'count' / '') + an aggregate function
+ *          -> an i18n'd aggregate name (Count / Sum / Average …), so a
+ *          fieldless count aggregate doesn't leak the placeholder 'value' /
+ *          'count' string into the legend / tooltip.
+ *   arm 2  a real object + a real field -> `fieldLabel`'s bundle lookup, with
+ *          the HUMANIZED key (not the raw one) as its fallback.
+ *   arm 3  no object name at all (a static-data chart) -> the humanized key
+ *          outright.
+ *
+ * `t` and `fieldLabel` are injected rather than the hooks themselves, so this
+ * stays a plain function callable from either relay's own
+ * `useObjectTranslation()` / `useObjectLabel()` instances — no shared hook
+ * identity to manage, and each relay keeps memoizing its own `useCallback`
+ * wrapper over this (objectui#10's caution against depending on a memo's
+ * IDENTITY is about correctness, not about composing plain functions like
+ * this one).
+ */
+export declare function composeSeriesLabel(t: ReturnType<typeof useObjectTranslation>['t'], fieldLabel: ReturnType<typeof useObjectLabel>['fieldLabel'], objectName: string | undefined, yField: string, aggFn: string | undefined): string;
 /**
  * Columns for a STATIC (inline `options.data`) table widget whose author
  * declared none — objectui#4618.

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,IAAI;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,GAAG,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAA;CAAE,CAO1I;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAOtG;AAUD,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,IAAI,CAkBhE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5E,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,IAAI;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,GAAG,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAA;CAAE,CAO1I;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,GAAG,CAAC,EAC/C,UAAU,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,YAAY,CAAC,EAC3D,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,CAUR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAOtG;AAUD,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,IAAI,CAkBhE"}