@object-ui/plugin-dashboard 17.5.0 → 17.7.0

package/dist/DashboardConfigPanel.d.ts

@@ -1,3 +1,5 @@
+import { ConfigPanelSchema } from '@object-ui/components';
+import { ConfigPanelTranslate } from './useConfigPanelTranslation.js';
 /**
  * ObjectUI
  * Copyright (c) 2024-present ObjectStack Inc.
@@ -6,6 +8,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import * as React from 'react';
+export declare function buildDashboardSchema(t: ConfigPanelTranslate): ConfigPanelSchema;
 export interface DashboardConfigPanelProps {
     /** Whether the panel is open */
     open: boolean;

package/dist/DashboardConfigPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DashboardConfigPanel.d.ts","sourceRoot":"","sources":["../src/DashboardConfigPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkH/B,MAAM,WAAW,yBAAyB;IACxC,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,iCAAiC;IACjC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC9C,oCAAoC;IACpC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACrD;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,OAAO,EACP,MAAM,EACN,MAAM,EACN,aAAa,GACd,EAAE,yBAAyB,qBAiB3B"}
+{"version":3,"file":"DashboardConfigPanel.d.ts","sourceRoot":"","sources":["../src/DashboardConfigPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AA2CrC,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,oBAAoB,GAAG,iBAAiB,CA0F/E;AAMD,MAAM,WAAW,yBAAyB;IACxC,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,iCAAiC;IACjC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC9C,oCAAoC;IACpC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACrD;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,OAAO,EACP,MAAM,EACN,MAAM,EACN,aAAa,GACd,EAAE,yBAAyB,qBAoB3B"}

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;AAkSD,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

@@ -20,8 +20,9 @@ export interface DashboardGridLayoutProps {
      * 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.
      *

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;AA2CtG,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;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,CAqlBlE,CAAC"}

package/dist/DashboardRenderer.d.ts

@@ -1,4 +1,4 @@
-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';
 /**
@@ -44,6 +44,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 +71,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 +89,27 @@ export interface DashboardRendererProps extends Pick<HTMLAttributes<HTMLDivEleme
      * title/subtitle so we don't display them twice.
      */
     hideHeaderText?: boolean;
+    /**
+     * 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`, `description` and sub-caption
+     * (`options.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;AAg3BD;;;;;;;;;;;;;;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;AA+K5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAumCD;;;;;;;;;;;;;;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,qBA6L1B"}

package/dist/DatasetWidget.d.ts

@@ -1,4 +1,4 @@
-import { buildDatasetDrillFilter, pivotCellKey, ChartSeriesBinding } from '@object-ui/core';
+import { buildDatasetDrillFilter, pivotCellKey } from '@object-ui/core';
 /**
  * Build the record-list filter for a drilled row. Re-exported for back-compat;
  * the implementation now lives in `@object-ui/core` (`buildDatasetDrillFilter`)
@@ -86,128 +86,52 @@ export declare function extractDateWindows(filter: unknown): {
     rest: Record<string, unknown> | undefined;
 };
 /**
- * Lower a dashboard widget's declared `chartConfig` (spec `ChartConfigSchema` —
- * the same shape a report block and a react `<ObjectChart>` parse) onto the
- * chart schema this widget hands to the renderer.
- *
- * ## Why this is a whitelist and not a spread
- *
- * Until #3135 NONE of `chartConfig` reached the renderer: this widget read
- * `options` and nothing else, so an author who wrote `showLegend: false` still
- * got a legend and one who wrote `true` only got one because "on" is the
- * renderer's default. #3135 lowered that single flag and left the rest declared
- * and inert. objectstack#7016 lowers the rest of the keys that are actually
- * DELIVERED, admitting a key only when both of these hold:
- *
- *  1. **The chart block draws it end to end on this path.** `{ type: 'chart' }`
- *     resolves to `ChartRenderer` → `AdvancedChartImpl`, which draws
- *     `title`/`subtitle` in its ChartFrame, turns `description` into the chart
- *     container's `role="img"` + `aria-label`, applies `height` as that
- *     container's inline height, reads `colors` as the positional palette,
- *     prints `showDataLabels` as a Recharts `LabelList`, draws `annotations` as
- *     ReferenceLine/ReferenceArea and honours `interaction` as the tooltip
- *     toggle plus `Brush`. Forwarding a key the renderer ignores would only
- *     move declared-but-not-delivered one layer down, which is the failure this
- *     change exists to remove.
- *  2. **It does not fight the dataset derivation.** `type` stays out: the
- *     widget's own `type` already picks the family through `CHART_TYPE_MAP`,
- *     which is the dataset path's chart-family channel.
- *
- * ## Where `xAxis` / `yAxis` / `series` go — the ruled split (#4229)
- *
- * Those three used to be refused here under the same criterion 2, on the
- * grounds that they are "DERIVED from the dataset selection". That belief was
- * **half right, and the half it got wrong silently dropped authored intent**:
- * a widget authoring the spec's own combo shape — `series[].type` plus
- * `series[].yAxis: 'left'|'right'` and two `yAxis` entries — rendered as
- * grouped bars on one axis, because the per-series mark and the axis binding
- * never left this function (#4229, measured in the DOM: 2 bars / 0 lines / 1
- * axis where 1 bar + 1 line + 2 axes were authored).
- *
- * The ruling: **the dataset owns DATA, the author owns PRESENTATION.**
- *
- *  - **Data (derived, never forwarded)** — series MEMBERSHIP (which columns
- *    become series, which rows, which buckets) and the column each binding
- *    reads. Concretely: `buildChartSeries`'s `dataKey`s, `xAxisKey`, and the
- *    spec's two binding keys `series[].name` and `ChartAxis.field`.
- *  - **Presentation (authored, merged forward)** — everything else on those
- *    same objects: `series[].type` (the per-series mark), `series[].yAxis`
- *    (which axis it binds to), `label`/`color`/`stack`/`variant`/`dashArray`/
- *    `opacity`, and the axis definitions' `title`/`format`/`min`/`max`/
- *    `stepSize`/`showGridLines`/`position`/`logarithmic`.
- *
- * This is #2880's S2 rule — dual axes are `yAxis[].position` plus
- * `series[].yAxis`, and a combo assigns its axes by EXPLICIT binding first,
- * falling back to the per-series-type guess only where the author bound
- * nothing — extended from `ObjectChart` (where PR #2883 landed it) to the
- * dataset path, which never carried it over. {@link mergeAuthoredPresentation}
- * is the ONE place that merge happens; see it for the match rule and for why
- * membership is safe.
- *
- * `aria` is the one declared key with **no reader at all** on this path:
- * `AdvancedChartImpl` has no `aria` prop, and `SchemaRenderer`'s ARIA injection
- * reads the FLAT `ariaLabel`/`ariaDescribedBy`/`role`, never a nested `aria`
- * object. It is therefore left unforwarded on purpose (criterion 1) and
- * reported back to objectstack#5175's narrowing half rather than papered over
- * with a dashboard-only flattening that would also collide with the accessible
- * name `description` already sets.
- *
- * @param raw the widget's `chartConfig` as authored (anything, incl. absent)
- * @param fieldCategoryColors per-category colours resolved from the category
- *   dimension's own select/lookup option colours, merged UNDER an explicit
- *   author map (see the `colors` note below)
- * @returns only the keys that resolved, so the caller can spread it over the
- *   derived chart schema and every undeclared key keeps the renderer's default
+ * The authored chart CHROME, which now lives in `@object-ui/core`'s
+ * `chart-presentation` beside `buildChartSeries` — the derivation it is lowered
+ * onto (objectui#4877).
+ *
+ * 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 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 declare function chartConfigPresentation(raw: unknown, fieldCategoryColors?: Record<string, string> | null): Record<string, unknown>;
-/** Authored spec `ChartSeries` presentation, in the renderer's internal spelling. */
-export interface AuthoredSeriesPresentation {
-    label?: string;
-    /** Spec `ChartSeries.type`, narrowed — see {@link seriesPresentation}. */
-    chartType?: 'bar' | 'line' | 'area';
-    yAxis?: 'left' | 'right';
-    color?: string;
-    stack?: string;
-    variant?: 'primary' | 'comparison';
-    dashArray?: string;
-    opacity?: number;
-}
-/** A derived series binding with the author's presentation merged onto it. */
-export type MergedChartSeries = ChartSeriesBinding & AuthoredSeriesPresentation;
+export { chartConfigPresentation } from '@object-ui/core';
 /**
- * Merge the authored `chartConfig`'s PRESENTATION onto the series and axes the
- * dataset selection derived — the one place that happens (#4229).
- *
- * The match rule is **by name/key**: an authored `series[].name` is paired with
- * the derived binding whose `dataKey` it equals, and the pairing decides
- * nothing but presentation:
- *
- *  - an authored entry naming a measure that is NOT in the dataset selection is
- *    **ignored** — membership belongs to the dataset, so an author cannot add,
- *    remove or re-point a series from `chartConfig`;
- *  - a derived series with no authored entry keeps the family default, so every
- *    dashboard that never wrote `chartConfig.series` renders byte-for-byte as
- *    before;
- *  - where both exist the **explicit binding wins** (#2880 S2), which is the
- *    whole point: `type: 'line'` + `yAxis: 'right'` is how the spec says "this
- *    measure is a line on the secondary axis".
- *
- * Matching on `name` only is deliberate: `name` is the spec's authorable key
- * for a series (`dataKey` is a declared ALIAS of it, resolved where the
- * metadata is parsed), so reading a second spelling here would fossilize a
- * dialect this renderer has no business accepting (AGENTS.md #0.1).
- *
- * @param derived the bindings `buildChartSeries` produced from the selection
- * @param raw the widget's `chartConfig` as authored (anything, incl. absent)
- * @returns the merged series, plus the presentation-only axes to spread onto
- *   the chart schema (absent when the author declared none)
+ * The sub-caption a dashboard surface already resolved for this tile
+ * (objectui#8889). Three states, and the difference between two of them is
+ * load-bearing:
+ *
+ *  - **omitted (`undefined`)** — nobody upstream resolved it. This component is
+ *    rendering outside a dashboard surface (a standalone host, a preview, a
+ *    test), so there is no dashboard `name` in existence and therefore no
+ *    bundle key to look up. The AUTHORED limb is resolved locally, which is
+ *    exactly what objectui#7293 landed and what keeps rendering.
+ *  - **a string** — that is the answer; render it.
+ *  - **`null`** — a surface DID resolve it, to nothing. Render nothing, and in
+ *    particular do NOT fall back to the authored value: a bundle entry that
+ *    resolves to empty is the bundle winning, and the inline arms of
+ *    `getComponentSchema()` render nothing in that same case. Falling back here
+ *    is how the two surfaces would start to disagree.
+ *
+ * ⛔ Never widened to "the dashboard name" or "the widget's translation node".
+ * Handing this component the INPUTS would put a second copy of the
+ * authored-vs-bundle composition inside it, and the field's own invariant — "a
+ * bundle entry always wins over an inline map and the two channels can never
+ * disagree" — needs a single decision point to be true. That point is
+ * `useWidgetSubCaption`; what arrives here is its answer.
  */
-export declare function mergeAuthoredPresentation(derived: ChartSeriesBinding[], raw: unknown): {
-    series: MergedChartSeries[];
-    axes: Record<string, unknown>;
-};
-export declare function DatasetWidget({ widget, dataSource }: {
+export declare function DatasetWidget({ widget, dataSource, subCaption }: {
     widget: any;
     dataSource: unknown;
+    subCaption?: string | null;
 }): 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":"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"}
+{"version":3,"file":"DatasetWidget.d.ts","sourceRoot":"","sources":["../src/DatasetWidget.tsx"],"names":[],"mappings":"AA2CA,OAAO,EAYL,uBAAuB,EAWvB,YAAY,EAoBb,MAAM,iBAAiB,CAAC;AAuBzB;;;;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;AAsHD;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,+BAg7CjI"}

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

package/dist/MetricWidget.d.ts

@@ -1,7 +1,32 @@
 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';
+/**
+ * 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)

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,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA2CzD;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}