@object-ui/plugin-dashboard 17.7.0 → 18.0.0

package/dist/legacyRetiredWidget.d.ts

@@ -38,6 +38,29 @@ export declare const LEGACY_RETIRED_WIDGET_SCHEMA: {
  * terms for any surface that has no such fork.
  */
 export declare function isLegacyRetiredWidget(widget: DashboardWidgetSlotEntry | null | undefined): boolean;
-/** Is `node`, read from a widget's `component` envelope, a retired node type? */
+/**
+ * Is `node`, read from a widget's legacy `component` envelope
+ * (`{ id, component, layout }`, objectui's own format, which the spec's widget
+ * has no member for), a node the surfaces no longer draw? True for every node
+ * but a `metric-card` (objectui#12254).
+ *
+ * The envelope takes a `metric-card` and nothing else: the 2026-08-14 slot
+ * ruling (objectstack#8593) allowed that one node, and since objectui#12163
+ * (ruling C) both zod faces and `DashboardWidgetSchema['component']` refuse any
+ * other node by name. objectui#12254 retires the draw to match, after a census
+ * of stored use found no producer. So the accept set is the authoring one, read
+ * from the same closed list, `DASHBOARD_COMPONENT_WIDGET_TYPES`: a node whose
+ * `type` is a member draws as before, and anything else in the envelope (a
+ * node of another type, a node with no `type`, a string or a number) draws
+ * {@link LEGACY_RETIRED_WIDGET_SCHEMA}, the rebind prompt the metric and pivot
+ * arms return, and sends no query. The `object-metric` node objectui#11466
+ * retired here first is one case of the rule.
+ *
+ * An empty envelope (`component` absent, or a falsy value) holds no node, so
+ * this answers false and the widget draws by its family, as before.
+ *
+ * ⛔ Read only at the envelope: the same node types authored on a page, or a
+ * `metric-card` placed directly in `widgets[]`, are not judged here.
+ */
 export declare function isRetiredEnvelopeNode(node: unknown): boolean;
 //# sourceMappingURL=legacyRetiredWidget.d.ts.map

package/dist/legacyRetiredWidget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacyRetiredWidget.d.ts","sourceRoot":"","sources":["../src/legacyRetiredWidget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B;;;;;;CAM/B,CAAC;AAoBX;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAMlG;AA0BD,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAQ5D"}
+{"version":3,"file":"legacyRetiredWidget.d.ts","sourceRoot":"","sources":["../src/legacyRetiredWidget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuDH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B;;;;;;CAM/B,CAAC;AAoBX;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAMlG;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAI5D"}

package/dist/metricTile.d.ts

@@ -0,0 +1,87 @@
+/**
+ * The metric tile's layout rule — ONE home, read by every metric tile in this
+ * package: the plain cards (`MetricCard`, `MetricWidget`, and through it
+ * `ObjectMetricWidget` and every `object-metric` page block) and the
+ * dataset-bound tile (`DatasetWidget`) (objectui#12623).
+ *
+ *  - The title owns the first line: 13 px / 500, up to two lines, an ellipsis
+ *    on the second. Nothing shares its line but the plain card's icon chip.
+ *  - The value never wraps, and it scales before it would clip
+ *    (objectui#12942). A short value is one step smaller (20 px) in a tile
+ *    narrower than 160 px, 24 px from 160 px up. A longer one — a seven-digit
+ *    money figure with cents — takes a size ladder from 14 px to 24 px whose
+ *    steps start where that size fits (`metricTileValueClass`).
+ *  - The measure label (dataset-bound tile only) is an 11 px muted line under
+ *    the value, dropped below 160 px. The title's tooltip carries it, so it is
+ *    still there at every width.
+ *
+ * Width rules key off the TILE's own box (`@container` on the tile, `@[160px]:`
+ * variants), never the viewport: a dashboard grid, a page block and the
+ * Studio's folded canvas each size the same tile differently.
+ *
+ * Class strings stay static literals so Tailwind's content scanner sees them
+ * (`apps/console/src/index.css` sources this package's `src/**`).
+ */
+/** Put on the tile's root: the box the width rules below are measured against. */
+export declare const METRIC_TILE_CONTAINER_CLASS = "@container";
+/** The title: owns the first line, at most two lines, an ellipsis on the second. */
+export declare const METRIC_TILE_TITLE_CLASS = "min-w-0 line-clamp-2 break-words text-[13px] font-medium leading-snug text-foreground";
+/**
+ * The value: never wraps; 20 px below a 160 px tile, 24 px from 160 px up. The
+ * short value's face on a plain tile, and the dataset-bound tile's value at
+ * every length: that tile has no Card inset, so its value has the container's
+ * whole width and the ladder below, measured against a Card, does not apply.
+ */
+export declare const METRIC_TILE_VALUE_CLASS = "max-w-full overflow-hidden text-ellipsis whitespace-nowrap tabular-nums text-xl @[160px]:text-2xl";
+/**
+ * The value's size ladder, chosen by how wide the value is (objectui#12942).
+ *
+ * A plain tile (`MetricCard`, `MetricWidget`: a `Card`, 1 px border, the value
+ * in `CardContent`'s 24 px side padding) gives its value the container's width
+ * less {@link METRIC_TILE_VALUE_INSET} px — the container query reads the
+ * Card's content box, inside the border. A value `em` wide fits at a size of
+ * `px` from a container `INSET + em * px` wide, so each `@[N px]:` step below
+ * starts at `ceil(INSET + maxEm * px)` for its rung's widest value. The
+ * `metricTileValueScale-12942` test re-derives every step from that formula.
+ *
+ * The first rung is the short value's face, {@link METRIC_TILE_VALUE_CLASS}'s
+ * sizes unchanged. Every later rung starts at 14 px; past the last one, 14 px
+ * at every width. A value still wider than its tile at 14 px keeps the
+ * ellipsis, and the value node carries the full figure as its tooltip.
+ *
+ * Literals only: Tailwind's content scanner must see every class.
+ */
+export declare const METRIC_TILE_VALUE_INSET = 48;
+export declare const METRIC_TILE_VALUE_LADDER: ReadonlyArray<{
+    readonly maxEm: number;
+    readonly sizes: string;
+}>;
+/** Past the ladder's last rung: 14 px at every width. */
+export declare const METRIC_TILE_VALUE_FINAL_SIZES = "text-sm";
+/**
+ * How wide `text` draws, in em, at the tile's bold tabular figures — an upper
+ * bound read off Inter, the console's face: a digit is 0.65 em, a digit
+ * separator (`,` `.` `'` or a space) 0.27 em, a sign or currency symbol 0.7 em,
+ * and any other character a full em (letters, CJK).
+ */
+export declare function metricTileValueEm(text: string): number;
+/**
+ * The value node's class for `value`: the rung of {@link METRIC_TILE_VALUE_LADDER}
+ * its width falls in, or the 14 px final face past the last rung.
+ */
+export declare function metricTileValueClass(value: string | number): string;
+/** The measure label: an 11 px muted line under the value, dropped below 160 px. */
+export declare const METRIC_TILE_MEASURE_LABEL_CLASS = "hidden max-w-full truncate text-[11px] text-muted-foreground @[160px]:block";
+/**
+ * The title's tooltip: the description when one is authored, else the title,
+ * then the measure label on its own line — the one place the label survives in
+ * a tile too narrow to draw it.
+ */
+export declare function metricTileTooltip(title: string | undefined, description?: string, measureLabel?: string): string | undefined;
+/**
+ * The value node's tooltip: the full figure, for a value past the short rung —
+ * the one place it survives in a tile too narrow even for 14 px. A short value
+ * draws none, as before.
+ */
+export declare function metricTileValueTitle(value: string | number): string | undefined;
+//# sourceMappingURL=metricTile.d.ts.map

package/dist/metricTile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricTile.d.ts","sourceRoot":"","sources":["../src/metricTile.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,kFAAkF;AAClF,eAAO,MAAM,2BAA2B,eAAe,CAAC;AAExD,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,0FAA0F,CAAC;AAE/H;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,sGAAsG,CAAC;AAE3I;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAOtG,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,6BAA6B,YAAY,CAAC;AAIvD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAInE;AAED,oFAAoF;AACpF,eAAO,MAAM,+BAA+B,gFAAgF,CAAC;AAE7H;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5H;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/E"}

package/dist/schemaHostProps.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 { DomProps } from '@object-ui/core';
 /**
  * The props `SchemaRenderer` hands a widget that are NOT DOM attributes
  * (objectui#4357).
@@ -43,10 +37,21 @@
  *
  * The line this type draws is **"is the key an HTML attribute name"**. None of
  * the seven is (the two dashed `aria-*` forms the renderer emits itself are, and
- * they keep flowing). Everything that IS one stays in the spread and reaches the
- * DOM exactly as before: `id`, `name`, `role`, `disabled`, `aria-*`, `data-*`,
- * `className`. Removing the spread instead would have been the wrong fix — it is
- * the component's only accessibility passthrough.
+ * they keep flowing). Removing the spread instead would have been the wrong fix —
+ * it is the component's only accessibility passthrough.
+ *
+ * ⚠️ That line was a DENY-LIST, and on the renderer's door it is no longer the
+ * judge. It stripped every one of the seven and the leak gate
+ * (`packages/app-shell/src/__tests__/widget-dom-leak-sweep.test.tsx`) still
+ * found the OPEN TAIL on both components — an authored key neither declares
+ * (`zzcanary`, `reference_to`, a `props: { colorVariant }` on `metric-card`, a
+ * `label` on `metric-card`) and `name` all landed as attributes, because a
+ * deny-list can only name what already exists. Per objectui#4425's phase-2
+ * ruling, what a component reached through `SchemaRenderer` may put on its
+ * element is decided by `toDomProps`' WHITELIST — see {@link hostDomProps}
+ * below. The seven are still destructured by name: they are this type's keys,
+ * and on the direct React door (below) the destructure is still what keeps them
+ * off the element.
  *
  * The renderer strips its own schema metadata (`type` / `children` / `visible` /
  * the schema's `dataSource` binding / …) before spreading, so those never
@@ -77,4 +82,43 @@ export interface SchemaHostProps {
      */
     dataSource?: unknown;
 }
+/**
+ * What a KPI card may spread onto its host element, decided by the DOOR the
+ * render came through (objectui#4425, phase-2 ruling: "a registered SDUI
+ * widget's host element receives only what passes the `toDomProps` whitelist").
+ *
+ * Both metric components have two doors, and they hand the component two
+ * different populations:
+ *
+ *   - **The renderer's door.** `SchemaRenderer` — the registry render path, and
+ *     so also an app that registers the exported component under a key of its
+ *     own — hands the component the authored node's own keys, the contents of
+ *     its `props` container, the runtime props it injects and its host's
+ *     trailing props. That set is unbounded, so only the whitelist may decide
+ *     what reaches the element: `toDomProps` keeps the SDUI contract's declared
+ *     pass-through set (`SDUI_DOM_PASS_THROUGH_KEYS`) and the `aria-*` /
+ *     `data-*` families, and drops everything else — `name`, `disabled`, the
+ *     injected adapter, every authored key neither component declares. One
+ *     executor, `@object-ui/core`'s, the
+ *     one `DashboardRenderer`'s grid container and `plugin-chatbot`'s
+ *     registrations already use — not a third list.
+ *   - **The direct React door.** A host rendering the exported component passes
+ *     typed props, and both props interfaces DECLARE `React.HTMLAttributes` as
+ *     their DOM pass-through (objectui#4426). That declaration is the
+ *     objectui#4435 pattern the ruling keeps available, so this door stays as it
+ *     was: narrowing it at runtime while the exported interface still extends
+ *     `HTMLAttributes` would type-check a `title` or an `onMouseEnter` and drop
+ *     it — declared but not delivered. Narrowing the interface itself is a
+ *     public prop-surface change, which this card's fence excludes.
+ *
+ * The discriminator is `schema`: the one key `SchemaRenderer` injects on EVERY
+ * render (the table above), declared on this type as the renderer's private
+ * door and never on either exported props interface. A direct consumer that
+ * passes it anyway has chosen the renderer's door and gets the whitelist, so a
+ * mistaken reading DROPS an attribute and never leaks one. If the renderer ever
+ * stopped injecting it, every canary the leak gate plants would reach the DOM
+ * again and the gate would go red — that sweep is what holds this function to
+ * its claim, alongside `__tests__/MetricWidget.domProps.test.tsx`.
+ */
+export declare function hostDomProps<P extends object>(schema: unknown, rest: P): P | DomProps<P>;
 //# sourceMappingURL=schemaHostProps.d.ts.map

package/dist/schemaHostProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemaHostProps.d.ts","sourceRoot":"","sources":["../src/schemaHostProps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"schemaHostProps.d.ts","sourceRoot":"","sources":["../src/schemaHostProps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAExF"}

package/dist/utils.d.ts

@@ -77,6 +77,19 @@ export declare function deriveStaticTableColumns(rows: unknown): Array<{
 }>;
 export { resolveDateMacros, resolveFilterPlaceholders } from '@object-ui/core';
 export { shiftFilterByCompareTo, compareToTrendLabelKey, type CompareToConfig, } from '@object-ui/core';
+/**
+ * A period-over-period delta as `computeMetricDelta` returns it.
+ *
+ * `value` is the absolute percentage change, or `null` when the change has no
+ * percentage: a zero baseline with a non-zero current value (objectui#12677).
+ * Going from 0 to 10 is not a 100% increase — a percent change from zero is
+ * undefined — so the delta keeps its direction and states no number. Every
+ * reader draws it through {@link formatMetricDeltaPercent}.
+ */
+export interface MetricDelta {
+    value: number | null;
+    direction: 'up' | 'down' | 'neutral';
+}
 /**
  * Compute a percentage delta between the current and previous metric values.
  *
@@ -85,13 +98,18 @@ export { shiftFilterByCompareTo, compareToTrendLabelKey, type CompareToConfig, }
  * - previousValue is null / undefined (no comparison data)
  *
  * Edge cases:
- * - both 0 → neutral
- * - previous is 0 and current ≠ 0 → 100% in current's direction
+ * - both 0 → neutral, `value: 0`
+ * - previous is 0 and current ≠ 0 → current's direction, `value: null` (no
+ *   percentage is defined from a zero baseline; objectui#12677)
  * - previous is negative → uses |previous| as denominator so that "less
  *   negative" reads as a positive (up) delta.
  */
-export declare function computeMetricDelta(current: number | null | undefined, previous: number | null | undefined): {
-    value: number;
-    direction: 'up' | 'down' | 'neutral';
-} | null;
+export declare function computeMetricDelta(current: number | null | undefined, previous: number | null | undefined): MetricDelta | null;
+/**
+ * The text a delta badge draws for {@link MetricDelta.value}: `20%` for a
+ * defined percentage, and an em dash — never a number — when there is none
+ * (a zero baseline, objectui#12677). A symbol, not a word, so no locale pack
+ * carries it. The direction arrow beside it still says which way it moved.
+ */
+export declare function formatMetricDeltaPercent(value: number | null): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;CACtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,WAAW,GAAG,IAAI,CAkBpB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAErE"}

package/dist/widgetDispatch.d.ts

@@ -10,6 +10,14 @@ import { MetricWidgetProps } from './MetricWidget.js';
  * (objectui#11514). The widget arm, `DashboardWidgetSchema`, is not a read type
  * for an entry: since objectui#11483's closure its `type` names the widget
  * vocabulary only, so the component arm is not assignable to it.
+ *
+ * ⛔ A widget key (`dataset`, `options`, `chartConfig`, `filter`, `component`,
+ * …) is read on the widget arm alone: narrow the entry with
+ * {@link isSlotComponentEntry} first (objectui#11598, N2 A), the read rule
+ * `DashboardComponentSchema.widgets` states. The component arm declares none
+ * of them, and a component node in the slot draws itself whatever else it
+ * carries; reading one off the entry whichever arm it was compiled only through
+ * `BaseSchema`'s index signature, which objectui#8347 removed.
  */
 export type DashboardWidgetSlotEntry = DashboardComponentSchema['widgets'][number];
 export declare function specDefaultWidgetType(): DashboardWidgetTypeName;
@@ -31,11 +39,15 @@ export declare function specDefaultWidgetType(): DashboardWidgetTypeName;
 export declare function resolveWidgetType(entry: DashboardWidgetSlotEntry): DashboardWidgetSlotEntry['type'];
 /**
  * The node an entry's legacy `component` envelope holds, typed as the widget
- * arm declares that member (`DashboardWidgetSchema['component']`). Read off the
- * entry whichever arm it is, as the surfaces always read it. The component arm
- * declares no `component`, so a bare `entry.component` on the slot entry reads
- * through `BaseSchema`'s index signature and is `any` — which made each
- * surface's whole `getComponentSchema` return `any` (objectui#11514).
+ * arm declares that member (`DashboardWidgetSchema['component']`), or
+ * `undefined` for a component node in the slot.
+ *
+ * `component` is a widget key, so it is read on the widget arm alone
+ * (objectui#11598, N2 A). It used to be read off the entry whichever arm it
+ * was: the component arm declares no `component`, so that read went through
+ * `BaseSchema`'s index signature, and a `metric-card` entry carrying one (a
+ * document the strict face refuses) drew the envelope's node in the card's
+ * place.
  */
 export declare function entryComponent(entry: DashboardWidgetSlotEntry): DashboardWidgetSchema['component'];
 /**
@@ -106,7 +118,11 @@ export type WidgetDispatchFamily =
  | 'table'
 /** Cross-tab — dataset-bound only; a non-dataset pivot is stale metadata. */
  | 'pivot'
-/** Author-supplied component schema required. */
+/**
+ * objectui's legacy `custom` widget. Its `component` envelope draws a
+ * `metric-card` and nothing else (objectui#12254); with no `component` it
+ * draws the labelled placeholder `unsupported` draws.
+ */
  | 'custom'
 /** Known family, no renderer — labelled placeholder. */
  | 'unsupported'
@@ -187,6 +203,20 @@ declare module '@object-ui/types' {
         'plugin-dashboard:metric': DashboardMetricNodeSchema;
     }
 }
+/**
+ * A stored inline metric widget's `options`, without the retired sub-caption
+ * key `description` (objectui#11389, ruling C).
+ *
+ * Both surfaces' metric arms spread a dataset-less widget's `options` onto the
+ * {@link DashboardMetricNodeSchema} node, and `MetricWidget` draws the node's
+ * `description` as the line under the value. So the spread alone would keep
+ * drawing a stored `options.description` as a sub-caption after every read that
+ * named it was removed. Both arms drop it here, so the two surfaces cannot
+ * disagree about it. The node's own `description` member stays: it is
+ * `MetricWidget`'s prop, which a node sets directly, not a key of a dashboard
+ * widget's options bag.
+ */
+export declare function withoutRetiredSubCaption<T extends Record<string, unknown>>(options: T): Omit<T, 'description'>;
 /**
  * `node` with its `type` moved onto the namespaced key {@link
  * DASHBOARD_NODE_TYPES} names, or `node` itself when the type has no row.

package/dist/widgetDispatch.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/plugin-dashboard",
-  "version": "17.7.0",
+  "version": "18.0.0",
   "type": "module",
   "license": "MIT",
   "description": "Dashboard plugin for Object UI",
@@ -18,15 +18,15 @@
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
-    "@objectstack/spec": "^17.5.0",
+    "@objectstack/spec": "^18.0.0",
     "lucide-react": "^1.43.0",
-    "@object-ui/components": "17.7.0",
-    "@object-ui/core": "17.7.0",
-    "@object-ui/fields": "17.7.0",
-    "@object-ui/i18n": "17.7.0",
-    "@object-ui/permissions": "17.7.0",
-    "@object-ui/react": "17.7.0",
-    "@object-ui/types": "17.7.0"
+    "@object-ui/components": "18.0.0",
+    "@object-ui/fields": "18.0.0",
+    "@object-ui/core": "18.0.0",
+    "@object-ui/i18n": "18.0.0",
+    "@object-ui/permissions": "18.0.0",
+    "@object-ui/types": "18.0.0",
+    "@object-ui/react": "18.0.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -41,8 +41,8 @@
     "typescript": "^6.0.3",
     "vite": "^8.2.1",
     "vite-plugin-dts": "^5.0.3",
-    "@object-ui/plugin-charts": "17.7.0",
-    "@object-ui/sdui-parser": "17.7.0",
+    "@object-ui/plugin-charts": "18.0.0",
+    "@object-ui/sdui-parser": "18.0.0",
     "@object-ui/test-support": "17.4.0"
   },
   "keywords": [

package/dist/widgetSubCaption.d.ts

@@ -1,40 +0,0 @@
-/**
- * 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.
- */
-/**
- * The structural minimum this resolution reads. Deliberately not
- * `DashboardWidgetSchema`: the two surfaces hold their widgets at two different
- * static types (the grid holds the `DashboardWidgetSlotComponentSchema |
- * DashboardWidgetSchema` union its `widgets` slot declares), and both satisfy
- * this shape. `options` is `unknown` because that is what
- * `DashboardWidgetSchema` declares it as.
- */
-export interface SubCaptionWidget {
-    id?: string;
-    options?: unknown;
-}
-/**
- * Resolve a dataset/metric widget's sub-caption for the active UI language.
- *
- * `dashName` is the dashboard schema's `name` — the segment every convention
- * key on this surface is built from. Without it (or without a widget `id`)
- * there is no key to look up, so the authored limb answers alone; that is the
- * same silent degradation `tWidgetTitle` / `tWidgetDescription` perform, not a
- * new one.
- *
- * `localized` is the host's word that the document was served already
- * translated (`DashboardRendererProps.localized`): the authored limb then
- * answers alone, because the served value IS the translation.
- *
- * Provider-safe: `useObjectLabel` and `useObjectTranslation` both degrade to a
- * no-instance stand-in when no `I18nProvider` is mounted (objectui#5564), which
- * `DashboardGridLayout` depends on — it is a separately exported component a
- * host mounts standalone (its `dashboard-grid` node key was retired by
- * objectui#10859 batch 8).
- */
-export declare function useWidgetSubCaption(dashName: string | undefined, localized?: boolean): (widget: SubCaptionWidget) => string | undefined;
-//# sourceMappingURL=widgetSubCaption.d.ts.map

package/dist/widgetSubCaption.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"widgetSubCaption.d.ts","sourceRoot":"","sources":["../src/widgetSubCaption.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4EH;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,SAAS,UAAQ,GAChB,CAAC,MAAM,EAAE,gBAAgB,KAAK,MAAM,GAAG,SAAS,CAalD"}