@decaf-ts/ui-decorators 0.20.6 → 0.20.8

package/lib/types/dashboard/registry.d.mts

@@ -0,0 +1,29 @@
+/**
+ * @module ui-decorators/dashboard/registry
+ * @summary Dashboard-selectable component registry.
+ * @description Module-level registry that tracks every `@dashcomponent`-
+ * decorated constructor. The `@dashcomponent` decorator calls
+ * {@link registerDashComponent} as a side-effect; consumers discover all
+ * decorated classes via {@link dashComponents}.
+ *
+ * This follows the same pattern as the `graph` submodule's node registry and
+ * the `InjectablesRegistry` in `injectable-decorators` — a private `Set`
+ * rather than the `Metadata` internal helpers.
+ */
+import type { Constructor } from "@decaf-ts/decoration";
+/**
+ * Appends a constructor to the dashboard component registry. Called by the
+ * `@dashcomponent` decorator. Idempotent — re-decorating the same class does
+ * not duplicate the entry.
+ * @param ctor The `@dashcomponent`-decorated constructor.
+ */
+export declare function registerDashComponent(ctor: Constructor): void;
+/**
+ * Returns all `@dashcomponent`-decorated constructors.
+ * @returns A fresh array of constructors (mutable; does not expose the internal set).
+ */
+export declare function dashComponents(): Constructor[];
+/**
+ * Clears the dashboard component registry. Intended for tests only.
+ */
+export declare function resetDashComponentRegistry(): void;

package/lib/types/dashboard/types.d.cts

@@ -0,0 +1,67 @@
+/**
+ * @module ui-decorators/dashboard/types
+ * @summary Type definitions for dashboard-selectable components.
+ * @description Flavor-neutral types describing the palette metadata attached
+ * by `@dashcomponent()` and the resolved definition consumed by a palette
+ * service. No Angular or framework imports.
+ */
+import type { Constructor } from "@decaf-ts/decoration";
+/**
+ * @description Grid footprint of a dashboard component.
+ * @summary A component's default footprint on the dashboard grid, expressed
+ * in grid units (columns and rows).
+ * @typedef DashComponentSize
+ * @memberOf module:ui-decorators/dashboard/types
+ * @property {number} cols - Number of grid columns occupied.
+ * @property {number} rows - Number of grid rows occupied.
+ */
+export type DashComponentSize = {
+    cols: number;
+    rows: number;
+};
+/**
+ * @description Palette metadata attached to a dashboard-selectable component.
+ * @summary The metadata object stored on a `@dashcomponent`-decorated class.
+ * Carries the translation label key, the default grid size, and an optional
+ * reference to the configuration model used by the component's own CRUD flow.
+ * @typedef DashComponentMetadata
+ * @memberOf module:ui-decorators/dashboard/types
+ * @property {string} [tag] - Component tag resolved for rendering.
+ * @property {string} [label] - Translation label key for the palette.
+ * @property {DashComponentSize} [defaultSize] - Default grid footprint.
+ * @property {Constructor} [model] - Configuration model constructor reference.
+ * @property {Record<string, any>} [props] - Ad-hoc props for the component.
+ * @property {Record<string, unknown>} [metadata] - Free-form extension points.
+ */
+export type DashComponentMetadata = {
+    tag?: string;
+    label?: string;
+    defaultSize?: DashComponentSize;
+    model?: Constructor;
+    props?: Record<string, any>;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * @description Resolved definition of a dashboard-selectable component.
+ * @summary The normalized shape a palette or rendering service consumes from
+ * the registry. Defaults are applied so consumers never resolve undefined
+ * footprint values.
+ * @typedef DashComponentDefinition
+ * @memberOf module:ui-decorators/dashboard/types
+ * @property {string} name - Class name of the decorated component.
+ * @property {string} tag - Component tag resolved for rendering.
+ * @property {string} [label] - Translation label key for the palette.
+ * @property {DashComponentSize} defaultSize - Default grid footprint.
+ * @property {Constructor} [model] - Configuration model constructor reference.
+ * @property {Record<string, any>} [props] - Ad-hoc props for the component.
+ * @property {Record<string, unknown>} [metadata] - Free-form extension points.
+ */
+export type DashComponentDefinition = {
+    name: string;
+    tag: string;
+    label?: string;
+    defaultSize: DashComponentSize;
+    model?: Constructor;
+    props?: Record<string, any>;
+    metadata?: Record<string, unknown>;
+};

package/lib/types/dashboard/types.d.mts

@@ -0,0 +1,67 @@
+/**
+ * @module ui-decorators/dashboard/types
+ * @summary Type definitions for dashboard-selectable components.
+ * @description Flavor-neutral types describing the palette metadata attached
+ * by `@dashcomponent()` and the resolved definition consumed by a palette
+ * service. No Angular or framework imports.
+ */
+import type { Constructor } from "@decaf-ts/decoration";
+/**
+ * @description Grid footprint of a dashboard component.
+ * @summary A component's default footprint on the dashboard grid, expressed
+ * in grid units (columns and rows).
+ * @typedef DashComponentSize
+ * @memberOf module:ui-decorators/dashboard/types
+ * @property {number} cols - Number of grid columns occupied.
+ * @property {number} rows - Number of grid rows occupied.
+ */
+export type DashComponentSize = {
+    cols: number;
+    rows: number;
+};
+/**
+ * @description Palette metadata attached to a dashboard-selectable component.
+ * @summary The metadata object stored on a `@dashcomponent`-decorated class.
+ * Carries the translation label key, the default grid size, and an optional
+ * reference to the configuration model used by the component's own CRUD flow.
+ * @typedef DashComponentMetadata
+ * @memberOf module:ui-decorators/dashboard/types
+ * @property {string} [tag] - Component tag resolved for rendering.
+ * @property {string} [label] - Translation label key for the palette.
+ * @property {DashComponentSize} [defaultSize] - Default grid footprint.
+ * @property {Constructor} [model] - Configuration model constructor reference.
+ * @property {Record<string, any>} [props] - Ad-hoc props for the component.
+ * @property {Record<string, unknown>} [metadata] - Free-form extension points.
+ */
+export type DashComponentMetadata = {
+    tag?: string;
+    label?: string;
+    defaultSize?: DashComponentSize;
+    model?: Constructor;
+    props?: Record<string, any>;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * @description Resolved definition of a dashboard-selectable component.
+ * @summary The normalized shape a palette or rendering service consumes from
+ * the registry. Defaults are applied so consumers never resolve undefined
+ * footprint values.
+ * @typedef DashComponentDefinition
+ * @memberOf module:ui-decorators/dashboard/types
+ * @property {string} name - Class name of the decorated component.
+ * @property {string} tag - Component tag resolved for rendering.
+ * @property {string} [label] - Translation label key for the palette.
+ * @property {DashComponentSize} defaultSize - Default grid footprint.
+ * @property {Constructor} [model] - Configuration model constructor reference.
+ * @property {Record<string, any>} [props] - Ad-hoc props for the component.
+ * @property {Record<string, unknown>} [metadata] - Free-form extension points.
+ */
+export type DashComponentDefinition = {
+    name: string;
+    tag: string;
+    label?: string;
+    defaultSize: DashComponentSize;
+    model?: Constructor;
+    props?: Record<string, any>;
+    metadata?: Record<string, unknown>;
+};

package/lib/types/graph/catalog/GraphNodeDisplayManifest.d.cts

@@ -1,4 +1,5 @@
 import type { GraphJsonValue } from "../document/GraphJsonValue.d.cts";
+import type { GraphNodeShape, GraphNodeSizeRule } from "../constants.d.cts";
 import type { GraphIconReference } from "./GraphIconReference.d.cts";
 export interface GraphNodeDisplayManifest {
     name: string;
@@ -11,6 +12,22 @@ export interface GraphNodeDisplayManifest {
     width?: number;
     minWidth?: number;
     height?: number;
+    /**
+     * Node face silhouette (D1, DECAF-50 §4.5). Manifest-authoritative; the
+     * projected node renders this shape instead of a template CSS default.
+     */
+    shape?: GraphNodeShape;
+    /**
+     * Node corner radius in pixels (D1, DECAF-50 §4.5). Manifest-authoritative;
+     * the projected node renders this radius instead of a template CSS default.
+     */
+    cornerRadius?: number;
+    /**
+     * Manifest-declared, value-driven display rules (D1, DECAF-50 §4.5) evaluated
+     * from node-instance parameters — content growth never comes from hardcoded
+     * formulas or direct DOM style writes.
+     */
+    sizeRules?: GraphNodeSizeRule[];
     metadata?: Record<string, GraphJsonValue>;
 }
 export declare function isGraphNodeDisplayManifest(value: unknown): value is GraphNodeDisplayManifest;

package/lib/types/graph/catalog/GraphNodeDisplayManifest.d.mts

@@ -1,4 +1,5 @@
 import type { GraphJsonValue } from "../document/GraphJsonValue.d.mts";
+import type { GraphNodeShape, GraphNodeSizeRule } from "../constants.d.mts";
 import type { GraphIconReference } from "./GraphIconReference.d.mts";
 export interface GraphNodeDisplayManifest {
     name: string;
@@ -11,6 +12,22 @@ export interface GraphNodeDisplayManifest {
     width?: number;
     minWidth?: number;
     height?: number;
+    /**
+     * Node face silhouette (D1, DECAF-50 §4.5). Manifest-authoritative; the
+     * projected node renders this shape instead of a template CSS default.
+     */
+    shape?: GraphNodeShape;
+    /**
+     * Node corner radius in pixels (D1, DECAF-50 §4.5). Manifest-authoritative;
+     * the projected node renders this radius instead of a template CSS default.
+     */
+    cornerRadius?: number;
+    /**
+     * Manifest-declared, value-driven display rules (D1, DECAF-50 §4.5) evaluated
+     * from node-instance parameters — content growth never comes from hardcoded
+     * formulas or direct DOM style writes.
+     */
+    sizeRules?: GraphNodeSizeRule[];
     metadata?: Record<string, GraphJsonValue>;
 }
 export declare function isGraphNodeDisplayManifest(value: unknown): value is GraphNodeDisplayManifest;

package/lib/types/graph/constants.d.cts

@@ -10,6 +10,28 @@ export declare enum PortDirection {
     CONNECTION = "connection"
 }
 export type GraphNodeKind = string;
+/**
+ * Node face silhouette (D1, DECAF-50 §4.5). Manifest-authoritative: the
+ * projected node geometry renders this shape and its corner radius instead of a
+ * hardcoded template CSS value.
+ */
+export type GraphNodeShape = "rounded" | "square" | "pill";
+/**
+ * Manifest-declared, value-driven display rule (D1, DECAF-50 §4.5). The manifest
+ * `display` metadata is the single authority for node geometry; content-driven
+ * growth is expressed here and evaluated from the node instance's parameters —
+ * never as a hardcoded per-node formula or a direct DOM style write.
+ */
+export type GraphNodeSizeRule = {
+    /** Rule kind. Only `parameterCount` is defined: growth tracks an array parameter's length. */
+    type: "parameterCount";
+    /** Node-instance parameter whose item count drives the growth (e.g. `cases`). */
+    parameter: string;
+    /** Dimension that grows. */
+    dimension: "height" | "width";
+    /** Increment added per parameter item. */
+    perItem: number;
+};
 export type GraphConnectionRule = {
     allowSelf?: boolean;
     allowMultiple?: boolean;
@@ -30,6 +52,22 @@ export type GraphNodeMetadata = {
     maxChildren?: number;
     minWidth?: number;
     width?: number;
+    /**
+     * Node face silhouette (D1, DECAF-50 §4.5). Manifest-authoritative;
+     * folded into the manifest display fields by the D1 revision.
+     */
+    shape?: GraphNodeShape;
+    /**
+     * Node corner radius in pixels (D1, DECAF-50 §4.5). Manifest-authoritative;
+     * folded into the manifest display fields by the D1 revision.
+     */
+    cornerRadius?: number;
+    /**
+     * Manifest-declared, value-driven display rules (D1, DECAF-50 §4.5). Content
+     * growth (e.g. Switch case count) is expressed here and evaluated from the
+     * node instance's parameters — never hardcoded per-node formulas.
+     */
+    sizeRules?: GraphNodeSizeRule[];
     connectionRules?: GraphConnectionRule;
     metadata?: Record<string, unknown>;
     /**
@@ -222,6 +260,21 @@ export type GraphNodeDefinition = {
     ui?: Record<string, any>;
     graph?: GraphNodeMetadata;
     ports: GraphPortDefinition[];
+    /**
+     * Node face silhouette (D1, DECAF-50 §4.5), copied from
+     * {@link GraphNodeMetadata.shape} by `graphDefinitionOf`.
+     */
+    shape?: GraphNodeShape;
+    /**
+     * Node corner radius in pixels (D1, DECAF-50 §4.5), copied from
+     * {@link GraphNodeMetadata.cornerRadius} by `graphDefinitionOf`.
+     */
+    cornerRadius?: number;
+    /**
+     * Manifest-declared, value-driven display rules (D1, DECAF-50 §4.5), copied
+     * from {@link GraphNodeMetadata.sizeRules} by `graphDefinitionOf`.
+     */
+    sizeRules?: GraphNodeSizeRule[];
     /**
      * Effective color resolved from the category registry (or the node's
      * explicit `color` override). Computed by `graphDefinitionOf`.
@@ -262,6 +315,33 @@ export interface GraphCategoryStyle {
  * color/icon is set on the node.
  */
 export declare const GRAPH_DEFAULT_CATEGORY_STYLE: GraphCategoryStyle;
+/**
+ * Fallback node size in pixels when a manifest declares no `width`/`height`
+ * (D1, DECAF-50 §4.5). The manifest display remains the authority; this value
+ * only fills an absent manifest dimension, never overriding a declared one.
+ */
+export declare const GRAPH_DEFAULT_NODE_SIZE = 96;
+/**
+ * Default node corner radius in pixels (D1, DECAF-50 §4.5) applied only when the
+ * manifest declares no `cornerRadius`. Folded into the manifest display fields by
+ * the D1 revision; no template CSS pins the radius.
+ */
+export declare const GRAPH_DEFAULT_NODE_CORNER_RADIUS = 18;
+/**
+ * Evaluates a node definition's manifest-declared, value-driven display rules
+ * (D1, DECAF-50 §4.5) against per-parameter item counts. Content growth is
+ * driven by the manifest, never by hardcoded per-node formulas: each matching
+ * `parameterCount` rule adds `perItem * count` to its dimension. Falls back to the
+ * manifest `width`/`height` when no rule applies.
+ *
+ * @param definition - The manifest definition carrying `width`/`height`/`sizeRules`.
+ * @param parameterCounts - Item counts keyed by parameter id (e.g. `cases`).
+ * @returns The resolved `{ width, height }` in pixels.
+ */
+export declare function graphNodeSizeOf(definition: Pick<GraphNodeDefinition, "width" | "height" | "sizeRules">, parameterCounts?: Record<string, number>): {
+    width: number;
+    height: number;
+};
 /**
  * Registers a category style (color + optional icon) in the global registry.
  * Call this at module init time (e.g. in the engine's node declarations) to
@@ -273,15 +353,30 @@ export declare function registerGraphCategoryStyle(category: string, style: Grap
  */
 export declare function graphCategoryStyleOf(category?: string): GraphCategoryStyle;
 /**
- * Resolves the effective color for a node: explicit `color` overrides the
- * category color, which overrides the default.
+ * Resolves the effective color for a node (D7/G3-22, DECAF-50 §4.5).
+ *
+ * The **category base colour is authoritative**: every node of a registered
+ * category renders that one base colour, so same-category nodes never diverge.
+ * An explicit per-node `color` is an override applied at this single precedence
+ * point — it only wins when the category has no registered base style.
+ *
+ * @param explicitColor - The node's explicit per-node colour override, when any.
+ * @param category - The node's display category.
+ * @param override - A user-applied per-node colour override; wins over everything.
+ * @returns The resolved colour.
  */
-export declare function resolveEffectiveColor(explicitColor?: string, category?: string): string;
+export declare function resolveEffectiveColor(explicitColor?: string, category?: string, override?: string): string;
 /**
- * Resolves the effective icon for a node: explicit `icon` overrides the
- * category icon, which overrides the default.
+ * Resolves the effective icon for a node (D7/G3-22, DECAF-50 §4.5). The
+ * **category base icon is authoritative**; an explicit per-node `icon` is an
+ * override applied at this single precedence point.
+ *
+ * @param explicitIcon - The node's explicit per-node icon override, when any.
+ * @param category - The node's display category.
+ * @param override - A user-applied per-node icon override; wins over everything.
+ * @returns The resolved icon name.
  */
-export declare function resolveEffectiveIcon(explicitIcon?: string, category?: string): string;
+export declare function resolveEffectiveIcon(explicitIcon?: string, category?: string, override?: string): string;
 import type { GraphRunStatus } from "./types.d.cts";
 /**
  * Disabled-node execution semantics (DECAF-50 §4.9).

package/lib/types/graph/constants.d.mts

@@ -10,6 +10,28 @@ export declare enum PortDirection {
     CONNECTION = "connection"
 }
 export type GraphNodeKind = string;
+/**
+ * Node face silhouette (D1, DECAF-50 §4.5). Manifest-authoritative: the
+ * projected node geometry renders this shape and its corner radius instead of a
+ * hardcoded template CSS value.
+ */
+export type GraphNodeShape = "rounded" | "square" | "pill";
+/**
+ * Manifest-declared, value-driven display rule (D1, DECAF-50 §4.5). The manifest
+ * `display` metadata is the single authority for node geometry; content-driven
+ * growth is expressed here and evaluated from the node instance's parameters —
+ * never as a hardcoded per-node formula or a direct DOM style write.
+ */
+export type GraphNodeSizeRule = {
+    /** Rule kind. Only `parameterCount` is defined: growth tracks an array parameter's length. */
+    type: "parameterCount";
+    /** Node-instance parameter whose item count drives the growth (e.g. `cases`). */
+    parameter: string;
+    /** Dimension that grows. */
+    dimension: "height" | "width";
+    /** Increment added per parameter item. */
+    perItem: number;
+};
 export type GraphConnectionRule = {
     allowSelf?: boolean;
     allowMultiple?: boolean;
@@ -30,6 +52,22 @@ export type GraphNodeMetadata = {
     maxChildren?: number;
     minWidth?: number;
     width?: number;
+    /**
+     * Node face silhouette (D1, DECAF-50 §4.5). Manifest-authoritative;
+     * folded into the manifest display fields by the D1 revision.
+     */
+    shape?: GraphNodeShape;
+    /**
+     * Node corner radius in pixels (D1, DECAF-50 §4.5). Manifest-authoritative;
+     * folded into the manifest display fields by the D1 revision.
+     */
+    cornerRadius?: number;
+    /**
+     * Manifest-declared, value-driven display rules (D1, DECAF-50 §4.5). Content
+     * growth (e.g. Switch case count) is expressed here and evaluated from the
+     * node instance's parameters — never hardcoded per-node formulas.
+     */
+    sizeRules?: GraphNodeSizeRule[];
     connectionRules?: GraphConnectionRule;
     metadata?: Record<string, unknown>;
     /**
@@ -222,6 +260,21 @@ export type GraphNodeDefinition = {
     ui?: Record<string, any>;
     graph?: GraphNodeMetadata;
     ports: GraphPortDefinition[];
+    /**
+     * Node face silhouette (D1, DECAF-50 §4.5), copied from
+     * {@link GraphNodeMetadata.shape} by `graphDefinitionOf`.
+     */
+    shape?: GraphNodeShape;
+    /**
+     * Node corner radius in pixels (D1, DECAF-50 §4.5), copied from
+     * {@link GraphNodeMetadata.cornerRadius} by `graphDefinitionOf`.
+     */
+    cornerRadius?: number;
+    /**
+     * Manifest-declared, value-driven display rules (D1, DECAF-50 §4.5), copied
+     * from {@link GraphNodeMetadata.sizeRules} by `graphDefinitionOf`.
+     */
+    sizeRules?: GraphNodeSizeRule[];
     /**
      * Effective color resolved from the category registry (or the node's
      * explicit `color` override). Computed by `graphDefinitionOf`.
@@ -262,6 +315,33 @@ export interface GraphCategoryStyle {
  * color/icon is set on the node.
  */
 export declare const GRAPH_DEFAULT_CATEGORY_STYLE: GraphCategoryStyle;
+/**
+ * Fallback node size in pixels when a manifest declares no `width`/`height`
+ * (D1, DECAF-50 §4.5). The manifest display remains the authority; this value
+ * only fills an absent manifest dimension, never overriding a declared one.
+ */
+export declare const GRAPH_DEFAULT_NODE_SIZE = 96;
+/**
+ * Default node corner radius in pixels (D1, DECAF-50 §4.5) applied only when the
+ * manifest declares no `cornerRadius`. Folded into the manifest display fields by
+ * the D1 revision; no template CSS pins the radius.
+ */
+export declare const GRAPH_DEFAULT_NODE_CORNER_RADIUS = 18;
+/**
+ * Evaluates a node definition's manifest-declared, value-driven display rules
+ * (D1, DECAF-50 §4.5) against per-parameter item counts. Content growth is
+ * driven by the manifest, never by hardcoded per-node formulas: each matching
+ * `parameterCount` rule adds `perItem * count` to its dimension. Falls back to the
+ * manifest `width`/`height` when no rule applies.
+ *
+ * @param definition - The manifest definition carrying `width`/`height`/`sizeRules`.
+ * @param parameterCounts - Item counts keyed by parameter id (e.g. `cases`).
+ * @returns The resolved `{ width, height }` in pixels.
+ */
+export declare function graphNodeSizeOf(definition: Pick<GraphNodeDefinition, "width" | "height" | "sizeRules">, parameterCounts?: Record<string, number>): {
+    width: number;
+    height: number;
+};
 /**
  * Registers a category style (color + optional icon) in the global registry.
  * Call this at module init time (e.g. in the engine's node declarations) to
@@ -273,15 +353,30 @@ export declare function registerGraphCategoryStyle(category: string, style: Grap
  */
 export declare function graphCategoryStyleOf(category?: string): GraphCategoryStyle;
 /**
- * Resolves the effective color for a node: explicit `color` overrides the
- * category color, which overrides the default.
+ * Resolves the effective color for a node (D7/G3-22, DECAF-50 §4.5).
+ *
+ * The **category base colour is authoritative**: every node of a registered
+ * category renders that one base colour, so same-category nodes never diverge.
+ * An explicit per-node `color` is an override applied at this single precedence
+ * point — it only wins when the category has no registered base style.
+ *
+ * @param explicitColor - The node's explicit per-node colour override, when any.
+ * @param category - The node's display category.
+ * @param override - A user-applied per-node colour override; wins over everything.
+ * @returns The resolved colour.
  */
-export declare function resolveEffectiveColor(explicitColor?: string, category?: string): string;
+export declare function resolveEffectiveColor(explicitColor?: string, category?: string, override?: string): string;
 /**
- * Resolves the effective icon for a node: explicit `icon` overrides the
- * category icon, which overrides the default.
+ * Resolves the effective icon for a node (D7/G3-22, DECAF-50 §4.5). The
+ * **category base icon is authoritative**; an explicit per-node `icon` is an
+ * override applied at this single precedence point.
+ *
+ * @param explicitIcon - The node's explicit per-node icon override, when any.
+ * @param category - The node's display category.
+ * @param override - A user-applied per-node icon override; wins over everything.
+ * @returns The resolved icon name.
  */
-export declare function resolveEffectiveIcon(explicitIcon?: string, category?: string): string;
+export declare function resolveEffectiveIcon(explicitIcon?: string, category?: string, override?: string): string;
 import type { GraphRunStatus } from "./types.d.mts";
 /**
  * Disabled-node execution semantics (DECAF-50 §4.9).

package/lib/types/graph/document/GraphWorkflowUiState.d.cts

@@ -13,6 +13,14 @@ export type GraphNodeUiState = {
         width?: number;
         height?: number;
     };
+    /**
+     * Explicit user resize flag (D1, DECAF-50 §4.5). Only a genuine user resize
+     * sets this; a carried default or template CSS never wins over the manifest
+     * display. `ui.size` is honoured by projection only when this is `true`.
+     */
+    resized?: boolean;
+    /** Explicit user per-node colour override (D7, DECAF-50 §4.5), when any. */
+    color?: string;
     expanded?: boolean;
     selectedTab?: string;
 };

package/lib/types/graph/document/GraphWorkflowUiState.d.mts

@@ -13,6 +13,14 @@ export type GraphNodeUiState = {
         width?: number;
         height?: number;
     };
+    /**
+     * Explicit user resize flag (D1, DECAF-50 §4.5). Only a genuine user resize
+     * sets this; a carried default or template CSS never wins over the manifest
+     * display. `ui.size` is honoured by projection only when this is `true`.
+     */
+    resized?: boolean;
+    /** Explicit user per-node colour override (D7, DECAF-50 §4.5), when any. */
+    color?: string;
     expanded?: boolean;
     selectedTab?: string;
 };

package/lib/types/index.d.cts

@@ -9,25 +9,26 @@ import "./overrides";
 export * from "./overrides/index.d.cts";
 export * from "./model/index.d.cts";
 export * from "./ui/index.d.cts";
+export * from "./dashboard/index.d.cts";
 /**
  * @description Current package version string
  * @summary Stores the current package version for reference
  * @const VERSION
  * @memberOf module:ui-decorators
  */
-export declare const VERSION = "0.20.5";
+export declare const VERSION = "0.20.7";
 /**
  * @description Represents the current commit hash of the module build.
  * @summary Stores the current git commit hash for the package. The build replaces
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "4e03aa0";
+export declare const COMMIT = "d286514";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export declare const FULL_VERSION = "0.20.5-4e03aa0";
+export declare const FULL_VERSION = "0.20.7-d286514";
 export declare const PACKAGE_NAME = "@decaf-ts/ui-decorators";

package/lib/types/index.d.mts

@@ -9,25 +9,26 @@ import "./overrides";
 export * from "./overrides/index.d.mts";
 export * from "./model/index.d.mts";
 export * from "./ui/index.d.mts";
+export * from "./dashboard/index.d.mts";
 /**
  * @description Current package version string
  * @summary Stores the current package version for reference
  * @const VERSION
  * @memberOf module:ui-decorators
  */
-export declare const VERSION = "0.20.5";
+export declare const VERSION = "0.20.7";
 /**
  * @description Represents the current commit hash of the module build.
  * @summary Stores the current git commit hash for the package. The build replaces
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "4e03aa0";
+export declare const COMMIT = "d286514";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export declare const FULL_VERSION = "0.20.5-4e03aa0";
+export declare const FULL_VERSION = "0.20.7-d286514";
 export declare const PACKAGE_NAME = "@decaf-ts/ui-decorators";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/ui-decorators",
-  "version": "0.20.6",
+  "version": "0.20.8",
   "description": "Extension of decorator validation to ui elements to allow for web integration",
   "type": "module",
   "exports": {
@@ -128,6 +128,8 @@
   "main": "./lib/cjs/index.cjs",
   "module": "./lib/esm/index.js",
   "sideEffects": [
+    "./lib/esm/index.js",
+    "./lib/cjs/index.cjs",
     "./lib/esm/overrides/index.js",
     "./lib/esm/graph/overrides/index.js",
     "./lib/esm/graph/overrides/overrides.js",