@object-ui/plugin-dashboard 17.6.0 → 18.0.0

package/dist/DashboardConfigPanel.d.ts

@@ -1,5 +1,5 @@
 import { ConfigPanelSchema } from '@object-ui/components';
-import { ConfigPanelTranslate } from './useConfigPanelTranslation';
+import { ConfigPanelTranslate } from './useConfigPanelTranslation.js';
 /**
  * ObjectUI
  * Copyright (c) 2024-present ObjectStack Inc.

package/dist/DashboardFilterBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DashboardFilterBar.d.ts","sourceRoot":"","sources":["../src/DashboardFilterBar.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AAEH,OAAO,KAAuC,MAAM,OAAO,CAAC;AAiB5D,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,iBAAiB,CAAC;AAoCzB,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgTD,wBAAgB,kBAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,uBAAuB,4BAyCrH"}
+{"version":3,"file":"DashboardFilterBar.d.ts","sourceRoot":"","sources":["../src/DashboardFilterBar.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AAEH,OAAO,KAA+C,MAAM,OAAO,CAAC;AAkBpE,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,iBAAiB,CAAC;AA6DzB,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2cD,wBAAgB,kBAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,uBAAuB,4BAyCrH"}

package/dist/DashboardGridLayout.d.ts

@@ -9,26 +9,28 @@ export interface DashboardGridLayoutProps {
      * `DatasetWidget` for ADR-0021 dataset-bound widgets (objectui#4614).
      *
      * Typed `unknown`, not `any`. The sibling declares `dataSource?: any`
-     * (`DashboardRenderer.tsx:198`) for a reason that is explicitly historical —
+     * (`DashboardRendererProps.dataSource`) for a reason that is explicitly historical —
      * "that is precisely what it resolved to before", via the index signature that
      * used to answer for it — and this is a NEW declaration with no prior
      * resolution to preserve. `unknown` is what the consumer itself declares
-     * (`DatasetWidget.tsx:655`, `dataSource: unknown`), so the value is forwarded
+     * (`DatasetWidget`'s own parameter, `dataSource: unknown`), so the value is forwarded
      * to exactly the type that receives it, and no call site is held to anything
      * new: every value is assignable to `unknown`. Narrowing it further to a real
      * adapter type is a separate change with its own consumer sweep, on both
      * surfaces at once.
      *
      * Optional, and the omitted case is a SUPPORTED one rather than an oversight:
-     * `dashboard-grid`'s SDUI registration declares only `title` / `className`
-     * inputs, so schema-driven hosts render this component with no adapter at all.
+     * a host may mount this component with no adapter at all (until objectui#10859
+     * batch 8 retired the `dashboard-grid` node key, its SDUI registration declared
+     * only `title` / `className` inputs, so schema-driven hosts always did).
      * A dataset-bound widget arriving that way renders `DatasetWidget`'s own
      * no-capability diagnostic — a visible state, never a blank tile.
      *
-     * `SchemaRenderer` forwards this as a React prop (its `...props` spread, last:
-     * `SchemaRenderer.tsx:632`). It cannot be shadowed by the spec's per-element
-     * `dataSource` BINDING, which is stripped from the schema before that spread
-     * for exactly this reason (`SchemaRenderer.tsx:564-575`, objectstack#5576).
+     * `SchemaRenderer` forwards this as a React prop (its `...props` spread,
+     * last). It cannot be shadowed by the spec's per-element `dataSource`
+     * BINDING, which is stripped from the schema before that spread for exactly
+     * this reason (the `dataSource: _dataSource` strip in `SchemaRenderer`'s
+     * destructure, objectstack#5576).
      */
     dataSource?: unknown;
     /**

package/dist/DashboardGridLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DashboardGridLayout.d.ts","sourceRoot":"","sources":["../src/DashboardGridLayout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAA2C,KAAK,UAAU,IAAI,SAAS,EAAuC,MAAM,mBAAmB,CAAC;AAC/I,OAAO,kCAAkC,CAAC;AAK1C,OAAO,KAAK,EAAc,wBAAwB,EAAyB,MAAM,kBAAkB,CAAC;AA8BpG,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IAC/C;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAC5D,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,SAAS,EAAE,GAClB,wBAAwB,CAa1B;AAcD,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA+blE,CAAC"}
+{"version":3,"file":"DashboardGridLayout.d.ts","sourceRoot":"","sources":["../src/DashboardGridLayout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAA2C,KAAK,UAAU,IAAI,SAAS,EAAuC,MAAM,mBAAmB,CAAC;AAC/I,OAAO,kCAAkC,CAAC;AAK1C,OAAO,KAAK,EAAE,wBAAwB,EAAuC,MAAM,kBAAkB,CAAC;AA4CtG,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IAC/C;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAC5D,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,SAAS,EAAE,GAClB,wBAAwB,CAa1B;AAiBD,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAklBlE,CAAC"}

package/dist/DashboardRenderer.d.ts

@@ -1,6 +1,7 @@
-import { DashboardComponentSchema, DashboardWidgetSchema } from '@object-ui/types';
+import { DashboardComponentSchema } from '@object-ui/types';
 import { ActionDef, ActionResult, ActionContext, ModalHandler, SduiDomPassThroughKey } from '@object-ui/core';
 import { HTMLAttributes } from 'react';
+import { DashboardAutoRefresh } from './useDashboardAutoRefresh.js';
 /**
  * The dashboard renderer's props.
  *
@@ -44,6 +45,10 @@ export interface DashboardRendererProps extends Pick<HTMLAttributes<HTMLDivEleme
      * is precisely what it resolved to before, so declaring it changes what is
      * DECLARED without changing what any call site is held to. Narrowing it to a
      * real adapter type is a separate change with its own consumer sweep.
+     *
+     * Optional: when it is omitted, the adapter of the enclosing
+     * `SchemaRendererProvider` is used, which is how a `dashboard` block held on
+     * a page gets one (objectui#10815).
      */
     dataSource?: any;
     /** Callback invoked when dashboard refresh is triggered (manual or auto) */
@@ -67,8 +72,13 @@ export interface DashboardRendererProps extends Pick<HTMLAttributes<HTMLDivEleme
      * Receives the next widgets array (with positions swapped). The parent
      * is expected to persist via its data adapter. When omitted, drag-and-
      * drop affordances are disabled even in design mode.
+     *
+     * Typed by the slot itself, `DashboardComponentSchema['widgets']`: the array
+     * is `schema.widgets` reordered, so each entry is a widget or a component node
+     * placed directly in the slot (objectui#11514; it read `DashboardWidgetSchema[]`
+     * while the component arm was assignable to the widget arm).
      */
-    onWidgetsReorder?: (widgets: DashboardWidgetSchema[]) => void;
+    onWidgetsReorder?: (widgets: DashboardComponentSchema['widgets']) => void;
     /** Optional handler for actionType="modal" header actions. Receives a schema and ActionContext. */
     modalHandler?: ModalHandler;
     /** Optional named handlers for actionType="script" header actions, keyed by action name (actionUrl). */
@@ -80,6 +90,54 @@ export interface DashboardRendererProps extends Pick<HTMLAttributes<HTMLDivEleme
      * title/subtitle so we don't display them twice.
      */
     hideHeaderText?: boolean;
+    /**
+     * The host draws the "Refresh All" control, in its own chrome, and this is
+     * how it learns what to draw (objectui#12554). Set it and the renderer draws
+     * no refresh button of its own; leave it unset and the renderer draws one
+     * whenever `onRefresh` is wired, exactly as before.
+     *
+     * The auto-refresh timer is untouched: it stays this renderer's, armed by
+     * `onRefresh` and the authored `refreshIntervalSeconds`, so a host that
+     * draws the button runs no timer of its own. What the renderer hands over is
+     * the state of that one refresh implementation (`useDashboardAutoRefresh`):
+     *
+     * - `refreshing`, true while a run is in flight, manual or timed: spin the
+     *   icon and disable the button on it, as the renderer's own control does;
+     * - `handleRefresh`, the run the renderer's button calls: wire the host's
+     *   button to it, so a click shows the same indicator and calls `onRefresh`.
+     *
+     * It is called on mount, again each time `refreshing` changes, and with
+     * `null` when there is nothing to draw: no `onRefresh` is wired, or the
+     * renderer unmounted. The renderer reads it through a ref, so a host may
+     * pass a new function on every render (a `useState` setter is enough).
+     *
+     * The record-count badge (`recordCount`) is not part of the hand-over; it
+     * stays where the renderer draws it. The console's dashboard page
+     * (`DashboardView`) sets this, and draws the button among its page header's
+     * actions.
+     */
+    onRefreshStateChange?: (state: DashboardAutoRefresh | null) => void;
+    /**
+     * The document arrives already translated for the active language: the host
+     * read it from the server's `/meta` route, which resolves the packaged
+     * catalog per request locale and keeps a published edit over it (an explicit
+     * override beats the packaged default — `translateDashboard` in
+     * `@objectstack/spec`). The console's dashboard page (`DashboardView`) sets
+     * it.
+     *
+     * When true, the texts the server translated — the dashboard `label` and
+     * `description`, and each widget's `title` and `description` — are drawn as
+     * given: an inline per-locale map is
+     * still collapsed to the active language, but no client bundle lookup runs
+     * over them. A second pass over a served value is what let the packaged
+     * catalog win again, client-side, over a published edit (objectui#11295).
+     *
+     * Leave it unset for a document the server never translated — an inline
+     * block, a preview, a design surface: the client bundle is then its one
+     * translation pass, exactly as before. Header-action labels keep their bundle
+     * lookup either way: the server does not translate them.
+     */
+    localized?: boolean;
 }
 /**
  * DashboardRenderer — the public dashboard renderer.

package/dist/DashboardRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DashboardRenderer.d.ts","sourceRoot":"","sources":["../src/DashboardRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAc,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGpG,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAUnH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAmI5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,sBACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACnE,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACrE,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uDAAuD;IACvD,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,EAAE,KAAK,IAAI,CAAC;IAC9D,mGAAmG;IACnG,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,wGAAwG;IACxG,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,CAAC;IACrH;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAq8BD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,mHAiB7B,CAAC"}
+{"version":3,"file":"DashboardRenderer.d.ts","sourceRoot":"","sources":["../src/DashboardRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAc,wBAAwB,EAAwD,MAAM,kBAAkB,CAAC;AAGnI,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAanH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAuB5C,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAyJ/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,sBACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACnE,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACrE,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uDAAuD;IACvD,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IAC1E,mGAAmG;IACnG,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,wGAAwG;IACxG,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,CAAC;IACrH;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,KAAK,IAAI,CAAC;IACpE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AA4pCD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,mHAiB7B,CAAC"}

package/dist/DashboardWithConfig.d.ts

@@ -1,5 +1,5 @@
 import { DashboardComponentSchema } from '@object-ui/types';
-import { WidgetDatasetCatalogEntry } from './dataset-catalog';
+import { WidgetDatasetCatalogEntry } from './dataset-catalog.js';
 /**
  * ObjectUI
  * Copyright (c) 2024-present ObjectStack Inc.

package/dist/DashboardWithConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DashboardWithConfig.d.ts","sourceRoot":"","sources":["../src/DashboardWithConfig.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,wBAAwB,EAAyB,MAAM,kBAAkB,CAAC;AAKxF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAMnE,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,MAAM,EAAE,wBAAwB,CAAC;IACjC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,6DAA6D;IAC7D,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IACpD,iEAAiE;IACjE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IACvE,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACvC,oDAAoD;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,iBAAyB,EACzB,SAAS,EACT,QAAQ,EACR,eAAe,GAChB,EAAE,wBAAwB,qBAuK1B"}
+{"version":3,"file":"DashboardWithConfig.d.ts","sourceRoot":"","sources":["../src/DashboardWithConfig.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAOjE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAMnE,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,MAAM,EAAE,wBAAwB,CAAC;IACjC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,6DAA6D;IAC7D,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IACpD,iEAAiE;IACjE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IACvE,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACvC,oDAAoD;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,iBAAyB,EACzB,SAAS,EACT,QAAQ,EACR,eAAe,GAChB,EAAE,wBAAwB,qBAmM1B"}

package/dist/DatasetWidget.d.ts

@@ -86,24 +86,51 @@ export declare function extractDateWindows(filter: unknown): {
     rest: Record<string, unknown> | undefined;
 };
 /**
- * The authored chart CHROME and the series/axis presentation merge, both of
- * which now live in `@object-ui/core`'s `chart-presentation` beside
- * `buildChartSeries` — the derivation they are merged onto (objectui#4877).
+ * The authored chart CHROME, which now lives in `@object-ui/core`'s
+ * `chart-presentation` beside `buildChartSeries` — the derivation it is lowered
+ * onto (objectui#4877).
  *
- * They were written here (#3135 → objectstack#7016 → #4229) and moved when the
- * report renderer's embedded chart turned out to need the SAME merge over the
- * same spec keys: `ReportChartSchema` and `ChartConfigSchema` declare one
- * vocabulary, and a second copy of the split beside this one is precisely the
- * duplication objectui#4389 filed as a defect. The doctrine — the two
- * admission criteria, the data/presentation ruling, why `aria` stays
- * unforwarded — travelled with the code; see that module's header.
+ * It was written here (#3135 → objectstack#7016 → #4229) and moved when the
+ * report renderer's embedded chart turned out to need the SAME lowering over
+ * the same spec keys, and a second copy of the split beside this one is
+ * precisely the duplication objectui#4389 filed as a defect. The doctrine — the
+ * two admission criteria, the data/presentation ruling, why `aria` stays
+ * unforwarded — travelled with the code; see that module's header and
+ * `chartConfigPresentation`'s docblock.
  *
- * Re-exported under their original names so this module's public surface is
- * unchanged.
+ * Re-exported under its original name. The series/axis presentation merge
+ * (`mergeAuthoredPresentation`) was re-exported here too until objectui#11315:
+ * a dashboard widget's `chartConfig` no longer carries the `series` / `xAxis` /
+ * `yAxis` it read (spec 17.5.0), so this widget stopped calling it, and
+ * objectui#11372 then removed it from `@object-ui/core`.
  */
-export { chartConfigPresentation, mergeAuthoredPresentation, type AuthoredSeriesPresentation, type MergedChartSeries, } from '@object-ui/core';
-export declare function DatasetWidget({ widget, dataSource }: {
+export { chartConfigPresentation } from '@object-ui/core';
+/**
+ * A dataset-bound widget: a metric tile, a table / pivot, or a chart, drawn
+ * from one dataset query.
+ *
+ * ⛔ No sub-caption prop, and no read of a `description` key in the options
+ * bag: the metric sub-caption is retired at both ends (objectui#11389, ruling
+ * C, after objectstack's half in `@objectstack/spec` 17.7.0). A widget keeps
+ * one authored description, `widget.description`, which the dashboard surface
+ * draws as the card-header subtitle. If a caption under a metric's value
+ * returns, it returns as a declared widget-level key outside the options bag,
+ * never as a key inside it. The options census in `@object-ui/sdui-parser`
+ * reads this file's text, comments included, which is why this note does not
+ * spell the bag's member access.
+ */
+/**
+ * [objectui#12528] The heading a dashboard surface hands a dataset-bound
+ * metric tile instead of drawing its own card header: the widget's resolved
+ * title, and its resolved description, which becomes the title's tooltip.
+ */
+export interface DatasetMetricHeading {
+    title: string;
+    description?: string;
+}
+export declare function DatasetWidget({ widget, dataSource, heading }: {
     widget: any;
     dataSource: unknown;
+    heading?: DatasetMetricHeading;
 }): import("react").JSX.Element;
 //# sourceMappingURL=DatasetWidget.d.ts.map

package/dist/DatasetWidget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatasetWidget.d.ts","sourceRoot":"","sources":["../src/DatasetWidget.tsx"],"names":[],"mappings":"AAoCA,OAAO,EAYL,uBAAuB,EAUvB,YAAY,EAkBb,MAAM,iBAAiB,CAAC;AAgBzB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,gCAA0B,CAAC;AAExD;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,UAAU,mDAAgB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AAEpC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACpC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd;IACD,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpD,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAsBA;AASD,8DAA8D;AAC9D,wBAAgB,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,MAAM,CAEpF;AA6CD,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG;IACnD,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C,CA4DA;AA6CD;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,+BAsjCzF"}
+{"version":3,"file":"DatasetWidget.d.ts","sourceRoot":"","sources":["../src/DatasetWidget.tsx"],"names":[],"mappings":"AA2CA,OAAO,EAaL,uBAAuB,EAWvB,YAAY,EAmBb,MAAM,iBAAiB,CAAC;AA+BzB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,gCAA0B,CAAC;AAExD;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,UAAU,mDAAgB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AAEpC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACpC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd;IACD,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpD,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAsBA;AASD,8DAA8D;AAC9D,wBAAgB,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,MAAM,CAEpF;AA0ED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG;IACnD,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C,CA4DA;AAuID;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuBD,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,oBAAoB,CAAA;CAAE,+BAu8ClI"}

package/dist/DrillDownDrawer.d.ts

@@ -24,11 +24,20 @@ export interface DrillDownDrawerProps {
     /** Optional className on the inner container. */
     className?: string;
     /**
-     * M3: drill into an analytical `SpecReport` instead of the raw record list.
-     * When provided the drawer body renders a `spec-report` schema via
-     * `SchemaRenderer`. The widget's `filter` is merged in as an `$and` so the
-     * metric's scope flows into the report. The report itself can drill
-     * further (into a list / record) via its own row-click protocol.
+     * M3: drill into an analytical report instead of the raw record list.
+     * When the value is a dataset-bound report (ADR-0021: a `dataset`, or a
+     * `joined` report whose blocks bind one; see {@link isDatasetBoundReport})
+     * the drawer body renders a `report` node wrapping it
+     * (`{ type: 'report', report }`) via `SchemaRenderer` (objectui#11440; the
+     * retired `spec-report` alias carried the same wrapper). The widget's
+     * `filter` is joined to the report's own `runtimeFilter` with `$and` and
+     * written as the report's `runtimeFilter`, the one filter key the dataset
+     * renderer applies (objectui#5137, objectui#11506), so the metric's scope
+     * flows into the report. The report itself can drill further (into a list /
+     * record) via its own row-click protocol. Any other value lists the records,
+     * the two retired forms the authoring faces refuse by name among them: a
+     * `{ name }` reference (objectui#11517) and the pre-9.0 `objectName` form
+     * (objectui#11506).
      */
     report?: Record<string, unknown>;
 }

package/dist/DrillDownDrawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DrillDownDrawer.d.ts","sourceRoot":"","sources":["../src/DrillDownDrawer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1C,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAoG1D,CAAC"}
+{"version":3,"file":"DrillDownDrawer.d.ts","sourceRoot":"","sources":["../src/DrillDownDrawer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1C,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AA+BD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA+G1D,CAAC"}

package/dist/MetricCard.d.ts

@@ -1,6 +1,6 @@
 import { default as React } from 'react';
 import { I18nLabel } from '@object-ui/types';
-import { SchemaHostProps } from './schemaHostProps';
+import { SchemaHostProps } from './schemaHostProps.js';
 /**
  * DOM PASS-THROUGH (objectui#4426) — see `MetricWidget.tsx`'s interface header
  * for the full argument; this is the same widening on the same spread, onto the
@@ -18,6 +18,12 @@ import { SchemaHostProps } from './schemaHostProps';
  * whole. The repo's spelling for this carve-out is `ComboboxProps`
  * (`extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "value" | "onChange">`),
  * omitted there for the same reason: the component's own contract owns the name.
+ *
+ * This declaration is the DIRECT React door's. Rendered through
+ * `SchemaRenderer`, the card's element receives only what `toDomProps` passes
+ * (objectui#4425, phase 2) — see `hostDomProps` in `./schemaHostProps`. That is
+ * also why an authored `label` stops at the component: it is not this card's
+ * heading (`title` is) and not an attribute either.
  */
 export interface MetricCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
     /**

package/dist/MetricCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MetricCard.d.ts","sourceRoot":"","sources":["../src/MetricCard.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC1F;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,GAAG,eAAe,CA6ElE,CAAC"}
+{"version":3,"file":"MetricCard.d.ts","sourceRoot":"","sources":["../src/MetricCard.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC1F;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,GAAG,eAAe,CAkFlE,CAAC"}

package/dist/MetricWidget.d.ts

@@ -1,7 +1,33 @@
 import { default as React } from 'react';
 import { I18nLabel } from '@object-ui/types';
-import { MetricColorVariant } from './colorVariants';
-import { SchemaHostProps } from './schemaHostProps';
+import { MetricColorVariant } from './colorVariants.js';
+import { SchemaHostProps } from './schemaHostProps.js';
+import { MetricDelta } from './utils.js';
+/**
+ * Lightweight numeric formatter for metric widgets.
+ *
+ * Honors a numeral.js-style `format` pattern:
+ * - `'0,0'` / `'0,0.00'` → thousands separators with explicit decimals
+ * - leading `$/¥/€/£` or `currency` prop → currency formatting
+ * - trailing `%` → percent, handed WHOLE to `formatPercent`
+ *   (`@object-ui/fields`) at the storage the PATTERN states: numeral's `%`
+ *   multiplies by 100, so the value is a fraction. `formatPercent` owns the
+ *   scaling and the locale's percent convention — see the branch's own note
+ *   (objectui#9165, objectui#11475). A host that holds the field the value was
+ *   aggregated from renders the percent itself at that field's storage
+ *   (`ObjectMetricWidget`), the way it renders a currency.
+ *
+ * When no format is given but the value is a finite number, defaults to
+ * thousands separators with no decimals — that's what users expect for
+ * KPI cards (`1,930,000` not `1930000`).
+ */
+/**
+ * The decimal places a numeral.js-style pattern fixes (`'0,0.00'` → 2,
+ * `'0.0%'` → 1, `'0,0'` → 0) — the one parse this tile's formatter makes, read
+ * by `ObjectMetricWidget` too when it renders a percent aggregate itself, so the
+ * two never read one authored pattern at two widths.
+ */
+export declare function metricPatternDecimals(format: string | undefined): number;
 /**
  * The variant vocabulary and its two class tables now live in
  * `./colorVariants` — the dataset-bound KPI (`DatasetWidget`, objectui#3359)
@@ -43,9 +69,15 @@ export type { MetricColorVariant };
  * 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.
+ * (`toDomProps`) in both directions, and this declaration is the DIRECT React
+ * door's, which keeps no whitelist.
+ *
+ * The renderer's door does (objectui#4425, phase 2): rendered through
+ * `SchemaRenderer`, this component's element receives only what `toDomProps`
+ * passes, so an authored key it does not declare — or `name`, or an authored
+ * `title` — no longer reaches the `Card`. This declaration governs the direct
+ * door only, and what it promises still arrives there. Both doors, and how the
+ * component tells them apart, are `hostDomProps` in `./schemaHostProps`.
  */
 export interface MetricWidgetProps extends React.HTMLAttributes<HTMLDivElement> {
     /**
@@ -66,6 +98,16 @@ export interface MetricWidgetProps extends React.HTMLAttributes<HTMLDivElement>
         label?: string | I18nLabel;
         direction?: 'up' | 'down' | 'neutral';
     };
+    /**
+     * The `compareTo`-derived trend a host computed with `computeMetricDelta`
+     * (`ObjectMetricWidget`); it replaces `trend` outright when set. Host state,
+     * ⛔ not a node key: its `value` may be `null` — a zero baseline, which has
+     * no percentage and draws as a dash (objectui#12677) — while the authored
+     * `trend.value` stays the number the spec declares.
+     */
+    derivedTrend?: MetricDelta & {
+        label?: string;
+    };
     icon?: React.ReactNode | string;
     className?: string;
     description?: string | I18nLabel;
@@ -108,5 +150,5 @@ export interface MetricWidgetProps extends React.HTMLAttributes<HTMLDivElement>
      */
     variant?: 'card' | 'bare';
 }
-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;
+export declare const MetricWidget: ({ label, value, trend, derivedTrend, 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;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"}
+{"version":3,"file":"MetricWidget.d.ts","sourceRoot":"","sources":["../src/MetricWidget.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAiBvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAA8C,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACtG,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEvE,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AA2CrE;;;;;;;;;;;;;;;;;GAiBG;AACH;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGxE;AA+GD;;;;;;GAMG;AACH,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;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;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,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,wTA+B1B,iBAAiB,GAAG,eAAe,sBAsJrC,CAAC"}