@decaf-ts/ui-decorators 0.21.0 → 0.21.1

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

@@ -1,37 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.cts";
-export type GraphWorkflowViewport = {
-    x: number;
-    y: number;
-    zoom: number;
-};
-export type GraphNodeUiState = {
-    position: {
-        x: number;
-        y: number;
-    };
-    size?: {
-        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;
-};
-export type GraphEdgeUiState = {
-    points?: Array<{
-        x: number;
-        y: number;
-    }>;
-};
-export type GraphWorkflowUiState = {
-    viewport?: GraphWorkflowViewport;
-} & {
-    [key: string]: GraphJsonValue | undefined;
-};

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

@@ -1,37 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.mts";
-export type GraphWorkflowViewport = {
-    x: number;
-    y: number;
-    zoom: number;
-};
-export type GraphNodeUiState = {
-    position: {
-        x: number;
-        y: number;
-    };
-    size?: {
-        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;
-};
-export type GraphEdgeUiState = {
-    points?: Array<{
-        x: number;
-        y: number;
-    }>;
-};
-export type GraphWorkflowUiState = {
-    viewport?: GraphWorkflowViewport;
-} & {
-    [key: string]: GraphJsonValue | undefined;
-};

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

@@ -1,12 +0,0 @@
-export * from "./GraphDecoratedWorkflowCompiler.d.cts";
-export * from "./GraphEdgeInstance.d.cts";
-export * from "./GraphEndpoint.d.cts";
-export * from "./GraphJsonValue.d.cts";
-export * from "./GraphLoopConfiguration.d.cts";
-export * from "./GraphNodeBinding.d.cts";
-export * from "./GraphNodeInstance.d.cts";
-export * from "./GraphWorkflowDocument.d.cts";
-export * from "./GraphWorkflowDocumentBuilder.d.cts";
-export * from "./GraphWorkflowDocumentReader.d.cts";
-export * from "./GraphWorkflowDocumentSerializer.d.cts";
-export * from "./GraphWorkflowUiState.d.cts";

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

@@ -1,12 +0,0 @@
-export * from "./GraphDecoratedWorkflowCompiler.d.mts";
-export * from "./GraphEdgeInstance.d.mts";
-export * from "./GraphEndpoint.d.mts";
-export * from "./GraphJsonValue.d.mts";
-export * from "./GraphLoopConfiguration.d.mts";
-export * from "./GraphNodeBinding.d.mts";
-export * from "./GraphNodeInstance.d.mts";
-export * from "./GraphWorkflowDocument.d.mts";
-export * from "./GraphWorkflowDocumentBuilder.d.mts";
-export * from "./GraphWorkflowDocumentReader.d.mts";
-export * from "./GraphWorkflowDocumentSerializer.d.mts";
-export * from "./GraphWorkflowUiState.d.mts";

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

@@ -1,15 +0,0 @@
-import "../overrides";
-import "./overrides";
-export * from "./constants.d.cts";
-export * from "./decorators.d.cts";
-export * from "./registry.d.cts";
-export * from "./overrides/index.d.cts";
-export * from "./snapshot.d.cts";
-export * from "./reader.d.cts";
-export * from "./document/index.d.cts";
-export * from "./catalog/index.d.cts";
-export * from "./types.d.cts";
-export * from "./GraphExecutionStateMapper.d.cts";
-export * from "./GraphResolution.d.cts";
-export * from "./category-styles.d.cts";
-export * from "./overrides/index.d.cts";

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

@@ -1,15 +0,0 @@
-import "../overrides";
-import "./overrides";
-export * from "./constants.d.mts";
-export * from "./decorators.d.mts";
-export * from "./registry.d.mts";
-export * from "./overrides/index.d.mts";
-export * from "./snapshot.d.mts";
-export * from "./reader.d.mts";
-export * from "./document/index.d.mts";
-export * from "./catalog/index.d.mts";
-export * from "./types.d.mts";
-export * from "./GraphExecutionStateMapper.d.mts";
-export * from "./GraphResolution.d.mts";
-export * from "./category-styles.d.mts";
-export * from "./overrides/index.d.mts";

package/lib/types/graph/overrides/Metadata.d.cts

@@ -1,43 +0,0 @@
-/**
- * @module ui-decorators/graph/overrides/Metadata
- * @summary Metadata namespace augmentation for graph nodes and workflows.
- * @description Extends the `Metadata` class from `@decaf-ts/decoration` with
- * `Metadata.nodes()` and `Metadata.workflows()` accessors that return all
- * `@node`-decorated and `@graph`-decorated constructors respectively.
- *
- * This follows the existing override pattern used by `core` (`core/src/overrides/`)
- * and `decorator-validation` (`decorator-validation/src/overrides/`):
- * 1. This file declares the new static methods on the `Metadata` namespace via
- *    `declare module` (TypeScript declaration merging).
- * 2. The companion `overrides.ts` attaches the implementations to the
- *    `Metadata` class at runtime via `(Metadata as any).fn = ...`.
- * 3. The `index.ts` of this folder side-effect-imports `overrides.ts` so the
- *    attachments run whenever the graph module is loaded.
- * 4. The package's `sideEffects` array in `package.json` includes the compiled
- *    overrides entry points so bundlers preserve the side-effect imports.
- */
-import "@decaf-ts/decoration";
-import type { Constructor } from "@decaf-ts/decoration";
-declare module "@decaf-ts/decoration" {
-    namespace Metadata {
-        /**
-         * Returns all `@node`-decorated constructors.
-         *
-         * The list is populated as a side-effect of the `@node` decorator — every
-         * class decorated with `@node(...)` is appended to the node registry at
-         * decoration time. Consumers (e.g. the for-angular graph palette, CRUD form
-         * builders, executor registries) call this to discover all available node
-         * kinds without a hand-maintained array.
-         * @returns A fresh array of `@node`-decorated constructors.
-         */
-        function nodes(): Constructor[];
-        /**
-         * Returns all `@graph`-decorated constructors (workflow roots).
-         *
-         * Analogous to {@link nodes} but for `@graph`-decorated workflow-root
-         * classes. Populated as a side-effect of the `@graph` decorator.
-         * @returns A fresh array of `@graph`-decorated constructors.
-         */
-        function workflows(): Constructor[];
-    }
-}

package/lib/types/graph/overrides/Metadata.d.mts

@@ -1,43 +0,0 @@
-/**
- * @module ui-decorators/graph/overrides/Metadata
- * @summary Metadata namespace augmentation for graph nodes and workflows.
- * @description Extends the `Metadata` class from `@decaf-ts/decoration` with
- * `Metadata.nodes()` and `Metadata.workflows()` accessors that return all
- * `@node`-decorated and `@graph`-decorated constructors respectively.
- *
- * This follows the existing override pattern used by `core` (`core/src/overrides/`)
- * and `decorator-validation` (`decorator-validation/src/overrides/`):
- * 1. This file declares the new static methods on the `Metadata` namespace via
- *    `declare module` (TypeScript declaration merging).
- * 2. The companion `overrides.ts` attaches the implementations to the
- *    `Metadata` class at runtime via `(Metadata as any).fn = ...`.
- * 3. The `index.ts` of this folder side-effect-imports `overrides.ts` so the
- *    attachments run whenever the graph module is loaded.
- * 4. The package's `sideEffects` array in `package.json` includes the compiled
- *    overrides entry points so bundlers preserve the side-effect imports.
- */
-import "@decaf-ts/decoration";
-import type { Constructor } from "@decaf-ts/decoration";
-declare module "@decaf-ts/decoration" {
-    namespace Metadata {
-        /**
-         * Returns all `@node`-decorated constructors.
-         *
-         * The list is populated as a side-effect of the `@node` decorator — every
-         * class decorated with `@node(...)` is appended to the node registry at
-         * decoration time. Consumers (e.g. the for-angular graph palette, CRUD form
-         * builders, executor registries) call this to discover all available node
-         * kinds without a hand-maintained array.
-         * @returns A fresh array of `@node`-decorated constructors.
-         */
-        function nodes(): Constructor[];
-        /**
-         * Returns all `@graph`-decorated constructors (workflow roots).
-         *
-         * Analogous to {@link nodes} but for `@graph`-decorated workflow-root
-         * classes. Populated as a side-effect of the `@graph` decorator.
-         * @returns A fresh array of `@graph`-decorated constructors.
-         */
-        function workflows(): Constructor[];
-    }
-}

package/lib/types/graph/overrides/Rendering.d.cts

@@ -1,5 +0,0 @@
-import type { FieldDefinition } from "../../ui/types.d.cts";
-import type { Model } from "@decaf-ts/decorator-validation";
-export interface RenderingEngine<T = void, R = FieldDefinition<T>> {
-    renderAsNode<M extends Model>(model: M, globalProps: Record<string, unknown>, ...args: any[]): R;
-}

package/lib/types/graph/overrides/Rendering.d.mts

@@ -1,5 +0,0 @@
-import type { FieldDefinition } from "../../ui/types.d.mts";
-import type { Model } from "@decaf-ts/decorator-validation";
-export interface RenderingEngine<T = void, R = FieldDefinition<T>> {
-    renderAsNode<M extends Model>(model: M, globalProps: Record<string, unknown>, ...args: any[]): R;
-}

package/lib/types/graph/overrides/index.d.cts

@@ -1,3 +0,0 @@
-import "./Rendering";
-export * from "./overrides.d.cts";
-export * from "./Metadata.d.cts";

package/lib/types/graph/overrides/index.d.mts

@@ -1,3 +0,0 @@
-import "./Rendering";
-export * from "./overrides.d.mts";
-export * from "./Metadata.d.mts";

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

@@ -1 +0,0 @@
-import "./Rendering";

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

@@ -1 +0,0 @@
-import "./Rendering";

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

@@ -1,28 +0,0 @@
-import { Constructor } from "@decaf-ts/decoration";
-import { Model } from "@decaf-ts/decorator-validation";
-import type { GraphNodeDefinition, GraphNodeMetadata, GraphPortDefinition, GraphPortMetadata, GraphWorkflowDefinition, GraphWorkflowMetadata } from "./constants.d.cts";
-import "../model/overrides";
-type GraphModelLike<M extends Model = Model> = Constructor<M> | M;
-export declare function graphNodeMetadataOf<M extends Model>(model: GraphModelLike<M>): GraphNodeMetadata | undefined;
-export declare function graphWorkflowMetadataOf<M extends Model>(model: GraphModelLike<M>): GraphWorkflowMetadata | undefined;
-export declare function graphPortMetadataOf<M extends Model>(model: GraphModelLike<M>, property: keyof M | string): GraphPortMetadata | undefined;
-export declare function graphPortDefinitionOf<M extends Model>(model: GraphModelLike<M>, property: keyof M | string): GraphPortDefinition | undefined;
-export declare function graphPortsOf<M extends Model>(model: GraphModelLike<M>): GraphPortDefinition[];
-export declare function graphLeafPortsOf(ports: GraphPortDefinition[]): GraphPortDefinition[];
-export declare function graphWorkflowInputLeafPortsOf<M extends Model>(model: GraphModelLike<M>): GraphPortDefinition[];
-export declare function graphWorkflowOutputLeafPortsOf<M extends Model>(model: GraphModelLike<M>): GraphPortDefinition[];
-export declare function graphDefinitionOf<M extends Model>(model: GraphModelLike<M>): GraphNodeDefinition;
-/**
- * Detects an already-resolved {@link GraphWorkflowDefinition} — the plain-object
- * shape returned by {@link graphWorkflowDefinitionOf}, as opposed to a decorated
- * workflow class or model instance.
- *
- * Resolved definitions are values, not models: `resolveModel` maps them to
- * `Object`, so without this guard `graphWorkflowDefinitionOf` would rebuild an
- * empty definition and silently drop `nodes`/`relations`. Loop bodies already
- * resolved by the caller (e.g. `for-angular`'s `metadata.loop.body`) rely on
- * this round-trip.
- */
-export declare function isGraphWorkflowDefinition(value: unknown): value is GraphWorkflowDefinition;
-export declare function graphWorkflowDefinitionOf<M extends Model>(model: GraphModelLike<M>): GraphWorkflowDefinition;
-export {};

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

@@ -1,28 +0,0 @@
-import { Constructor } from "@decaf-ts/decoration";
-import { Model } from "@decaf-ts/decorator-validation";
-import type { GraphNodeDefinition, GraphNodeMetadata, GraphPortDefinition, GraphPortMetadata, GraphWorkflowDefinition, GraphWorkflowMetadata } from "./constants.d.mts";
-import "../model/overrides";
-type GraphModelLike<M extends Model = Model> = Constructor<M> | M;
-export declare function graphNodeMetadataOf<M extends Model>(model: GraphModelLike<M>): GraphNodeMetadata | undefined;
-export declare function graphWorkflowMetadataOf<M extends Model>(model: GraphModelLike<M>): GraphWorkflowMetadata | undefined;
-export declare function graphPortMetadataOf<M extends Model>(model: GraphModelLike<M>, property: keyof M | string): GraphPortMetadata | undefined;
-export declare function graphPortDefinitionOf<M extends Model>(model: GraphModelLike<M>, property: keyof M | string): GraphPortDefinition | undefined;
-export declare function graphPortsOf<M extends Model>(model: GraphModelLike<M>): GraphPortDefinition[];
-export declare function graphLeafPortsOf(ports: GraphPortDefinition[]): GraphPortDefinition[];
-export declare function graphWorkflowInputLeafPortsOf<M extends Model>(model: GraphModelLike<M>): GraphPortDefinition[];
-export declare function graphWorkflowOutputLeafPortsOf<M extends Model>(model: GraphModelLike<M>): GraphPortDefinition[];
-export declare function graphDefinitionOf<M extends Model>(model: GraphModelLike<M>): GraphNodeDefinition;
-/**
- * Detects an already-resolved {@link GraphWorkflowDefinition} — the plain-object
- * shape returned by {@link graphWorkflowDefinitionOf}, as opposed to a decorated
- * workflow class or model instance.
- *
- * Resolved definitions are values, not models: `resolveModel` maps them to
- * `Object`, so without this guard `graphWorkflowDefinitionOf` would rebuild an
- * empty definition and silently drop `nodes`/`relations`. Loop bodies already
- * resolved by the caller (e.g. `for-angular`'s `metadata.loop.body`) rely on
- * this round-trip.
- */
-export declare function isGraphWorkflowDefinition(value: unknown): value is GraphWorkflowDefinition;
-export declare function graphWorkflowDefinitionOf<M extends Model>(model: GraphModelLike<M>): GraphWorkflowDefinition;
-export {};

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

@@ -1,40 +0,0 @@
-/**
- * @module ui-decorators/graph/registry
- * @summary Node and workflow class registries.
- * @description Module-level registries that track every `@node`-decorated and
- * `@graph`-decorated constructor. The `@node` and `@graph` decorators call
- * {@link registerNode} / {@link registerWorkflow} as a side-effect; consumers
- * discover all decorated classes via {@link graphNodes} / {@link graphWorkflows}
- * or the `Metadata.nodes()` / `Metadata.workflows()` accessors.
- *
- * This follows the same pattern as `Injectables` (`injectable-decorators`)
- * which maintains its own `InjectablesRegistry` rather than using the private
- * `Metadata.innerGet`/`innerSet` helpers.
- */
-import type { Constructor } from "@decaf-ts/decoration";
-/**
- * Appends a constructor to the node registry. Called by the `@node` decorator.
- * Idempotent — re-decorating the same class does not duplicate the entry.
- * @param ctor The `@node`-decorated constructor.
- */
-export declare function registerNode(ctor: Constructor): void;
-/**
- * Appends a constructor to the workflow registry. Called by the `@graph`
- * decorator. Idempotent.
- * @param ctor The `@graph`-decorated constructor.
- */
-export declare function registerWorkflow(ctor: Constructor): void;
-/**
- * Returns all `@node`-decorated constructors.
- * @returns A fresh array of constructors (mutable; does not expose the internal set).
- */
-export declare function graphNodes(): Constructor[];
-/**
- * Returns all `@graph`-decorated constructors.
- * @returns A fresh array of constructors.
- */
-export declare function graphWorkflows(): Constructor[];
-/**
- * Clears both registries. Intended for tests only.
- */
-export declare function resetGraphRegistries(): void;

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

@@ -1,40 +0,0 @@
-/**
- * @module ui-decorators/graph/registry
- * @summary Node and workflow class registries.
- * @description Module-level registries that track every `@node`-decorated and
- * `@graph`-decorated constructor. The `@node` and `@graph` decorators call
- * {@link registerNode} / {@link registerWorkflow} as a side-effect; consumers
- * discover all decorated classes via {@link graphNodes} / {@link graphWorkflows}
- * or the `Metadata.nodes()` / `Metadata.workflows()` accessors.
- *
- * This follows the same pattern as `Injectables` (`injectable-decorators`)
- * which maintains its own `InjectablesRegistry` rather than using the private
- * `Metadata.innerGet`/`innerSet` helpers.
- */
-import type { Constructor } from "@decaf-ts/decoration";
-/**
- * Appends a constructor to the node registry. Called by the `@node` decorator.
- * Idempotent — re-decorating the same class does not duplicate the entry.
- * @param ctor The `@node`-decorated constructor.
- */
-export declare function registerNode(ctor: Constructor): void;
-/**
- * Appends a constructor to the workflow registry. Called by the `@graph`
- * decorator. Idempotent.
- * @param ctor The `@graph`-decorated constructor.
- */
-export declare function registerWorkflow(ctor: Constructor): void;
-/**
- * Returns all `@node`-decorated constructors.
- * @returns A fresh array of constructors (mutable; does not expose the internal set).
- */
-export declare function graphNodes(): Constructor[];
-/**
- * Returns all `@graph`-decorated constructors.
- * @returns A fresh array of constructors.
- */
-export declare function graphWorkflows(): Constructor[];
-/**
- * Clears both registries. Intended for tests only.
- */
-export declare function resetGraphRegistries(): void;

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

@@ -1,36 +0,0 @@
-import type { GraphWorkflowDocument } from "./document/GraphWorkflowDocument.d.cts";
-import type { GraphJsonValue } from "./document/GraphJsonValue.d.cts";
-/**
- * Editor-only state that the canonical {@link GraphWorkflowDocument} cannot
- * express (layout beyond node positions, config-store values, per-port modes,
- * workflow boundary values, and duplicate counts). Stored as JSON-safe values
- * only; constructors and `modelClass`/`sourceClass` references are dropped.
- */
-export type GraphSnapshotEditorState = {
-    viewport?: {
-        x: number;
-        y: number;
-        scale: number;
-    };
-    duplicateCounts?: Record<string, number>;
-    boundaryInputValues?: Record<string, GraphJsonValue>;
-    boundaryOutputValues?: Record<string, GraphJsonValue>;
-    nodePorts?: Record<string, Record<string, GraphJsonValue>>;
-    nodeConfigs?: Record<string, GraphJsonValue>;
-    diagramMetadata?: Record<string, GraphJsonValue>;
-    definitionDisplay?: Record<string, GraphJsonValue>;
-} & {
-    [key: string]: GraphJsonValue | undefined;
-};
-/**
- * Canonical document-first snapshot. `document` is the executable semantic
- * truth; `editor` preserves editor-only UI state. This is the only persisted and
- * executed snapshot form (DECAF-50 §4.26 R2-2): the engine ships as its first
- * version with no backward compatibility, so the former
- * `{ definition, state }` legacy snapshot and its conversion helpers are gone.
- */
-export type GraphWorkflowSnapshot = {
-    document: GraphWorkflowDocument;
-    editor?: GraphSnapshotEditorState;
-    metadata?: Record<string, GraphJsonValue>;
-};

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

@@ -1,36 +0,0 @@
-import type { GraphWorkflowDocument } from "./document/GraphWorkflowDocument.d.mts";
-import type { GraphJsonValue } from "./document/GraphJsonValue.d.mts";
-/**
- * Editor-only state that the canonical {@link GraphWorkflowDocument} cannot
- * express (layout beyond node positions, config-store values, per-port modes,
- * workflow boundary values, and duplicate counts). Stored as JSON-safe values
- * only; constructors and `modelClass`/`sourceClass` references are dropped.
- */
-export type GraphSnapshotEditorState = {
-    viewport?: {
-        x: number;
-        y: number;
-        scale: number;
-    };
-    duplicateCounts?: Record<string, number>;
-    boundaryInputValues?: Record<string, GraphJsonValue>;
-    boundaryOutputValues?: Record<string, GraphJsonValue>;
-    nodePorts?: Record<string, Record<string, GraphJsonValue>>;
-    nodeConfigs?: Record<string, GraphJsonValue>;
-    diagramMetadata?: Record<string, GraphJsonValue>;
-    definitionDisplay?: Record<string, GraphJsonValue>;
-} & {
-    [key: string]: GraphJsonValue | undefined;
-};
-/**
- * Canonical document-first snapshot. `document` is the executable semantic
- * truth; `editor` preserves editor-only UI state. This is the only persisted and
- * executed snapshot form (DECAF-50 §4.26 R2-2): the engine ships as its first
- * version with no backward compatibility, so the former
- * `{ definition, state }` legacy snapshot and its conversion helpers are gone.
- */
-export type GraphWorkflowSnapshot = {
-    document: GraphWorkflowDocument;
-    editor?: GraphSnapshotEditorState;
-    metadata?: Record<string, GraphJsonValue>;
-};