@decaf-ts/ui-decorators 0.17.3 → 0.17.5

package/lib/esm/graph/reader.js

@@ -69,20 +69,52 @@ export function graphPortMetadataOf(model, property) {
 export function graphPortDefinitionOf(model, property) {
     return graphPortDefinitionOfInternal(resolveModel(model), String(property));
 }
+/**
+ * Returns the flattened ports of a Schema-typed `@input` / `@output` property
+ * (a "Schema port group"). The Schema's own `@input` / `@output` properties
+ * whose direction matches `direction` are spliced into the result UNPREFIXED
+ * (no `<schemaProp>.` prefix). The carrier property itself is not a port.
+ *
+ * Returns `undefined` when the property is not a Schema group (not
+ * `graph.schema`, or not Schema-typed), so the caller falls back to the legacy
+ * single-port / composite expansion path.
+ */
+function schemaGroupPorts(resolved, propertyKey, direction, visited = new Set()) {
+    const graph = graphPortMetadataOf(resolved, propertyKey);
+    if (!graph?.schema)
+        return undefined;
+    const validation = Metadata.validationFor(resolved, propertyKey);
+    const nestedModel = resolveNestedModelConstructor(resolved, propertyKey, validation);
+    if (!nestedModel)
+        return undefined;
+    if (visited.has(nestedModel))
+        return []; // cycle guard — stop recursing
+    const nextVisited = new Set(visited);
+    nextVisited.add(resolved);
+    nextVisited.add(nestedModel);
+    const childPorts = graphPortsOfInternal(nestedModel, nextVisited);
+    return childPorts.filter((child) => child.direction === direction);
+}
 function graphPortDefinitionOfInternal(resolved, propertyKey, visited = new Set()) {
     const graph = graphPortMetadataOf(resolved, propertyKey);
     if (!graph)
         return undefined;
+    // Schema port group (@input / @output on a Schema-typed property): the
+    // carrier is not a port — its Schema's matching-direction ports are spliced
+    // into the parent by graphPortsOfInternal. The singular reader returns
+    // undefined for the carrier.
+    const validation = Metadata.validationFor(resolved, propertyKey);
+    const nestedModel = resolveNestedModelConstructor(resolved, propertyKey, validation);
+    if (graph.schema && nestedModel)
+        return undefined;
     const element = (Model.uiElementOf(resolved, propertyKey) ||
         undefined);
     const uiProp = Model.uiDecorationOf(resolved, propertyKey, UIKeys.PROP);
-    const validation = Metadata.validationFor(resolved, propertyKey);
     const designType = Metadata.type(resolved, propertyKey);
     const typeName = asString(validation?.[ValidationKeys.TYPE]?.customTypes?.[0]?.name ??
         element?.props?.type ??
         uiProp?.type ??
         designType?.name);
-    const nestedModel = resolveNestedModelConstructor(resolved, propertyKey, validation);
     const shouldExpand = !!graph.expand || (!!nestedModel && !visited.has(nestedModel));
     const children = shouldExpand && nestedModel
         ? (() => {
@@ -117,9 +149,24 @@ export function graphPortsOf(model) {
 }
 function graphPortsOfInternal(resolved, visited = new Set()) {
     const properties = Metadata.properties(resolved) || [];
-    return properties
-        .map((property) => graphPortDefinitionOfInternal(resolved, String(property), visited))
-        .filter((property) => !!property);
+    const result = [];
+    for (const property of properties) {
+        const key = String(property);
+        const graph = graphPortMetadataOf(resolved, key);
+        // Schema port group: splice the Schema's matching-direction ports
+        // (unprefixed) instead of emitting the carrier.
+        if (graph?.schema) {
+            const groupPorts = schemaGroupPorts(resolved, key, graph.direction, visited);
+            if (groupPorts) {
+                result.push(...groupPorts);
+                continue;
+            }
+        }
+        const port = graphPortDefinitionOfInternal(resolved, key, visited);
+        if (port)
+            result.push(port);
+    }
+    return result;
 }
 export function graphLeafPortsOf(ports) {
     return ports.flatMap((port) => port.children && port.children.length ? graphLeafPortsOf(port.children) : [port]);
@@ -136,6 +183,7 @@ export function graphDefinitionOf(model) {
     const graph = graphNodeMetadataOf(resolved) || {};
     const tag = ui?.tag || resolved.name;
     const ports = graphPortsOf(resolved);
+    const portGroups = resolvePortGroups(resolved, graph);
     return {
         name: resolved.name,
         tag,
@@ -153,8 +201,43 @@ export function graphDefinitionOf(model) {
         ui,
         graph,
         ports,
+        portGroups,
     };
 }
+/**
+ * Builds the effective `portGroups` list for a node: starts from the declared
+ * `GraphNodeMetadata.portGroups` and ensures every Schema-typed `@input` /
+ * `@output` property not explicitly listed gets a default
+ * `{ property, toggle: "all" }` entry. Non-Schema-typed `@input` / `@output`
+ * properties are not groups and are ignored.
+ */
+function resolvePortGroups(resolved, graph) {
+    const declared = graph.portGroups || [];
+    const declaredByProperty = new Map(declared.map((g) => [g.property, g]));
+    const groups = [];
+    const properties = Metadata.properties(resolved) || [];
+    for (const property of properties) {
+        const key = String(property);
+        const portMeta = graphPortMetadataOf(resolved, key);
+        if (!portMeta?.schema)
+            continue;
+        const validation = Metadata.validationFor(resolved, key);
+        const nestedModel = resolveNestedModelConstructor(resolved, key, validation);
+        if (!nestedModel)
+            continue; // not Schema-typed — not a group
+        const declaredGroup = declaredByProperty.get(key);
+        groups.push(declaredGroup
+            ? { ...declaredGroup, toggle: declaredGroup.toggle ?? "all" }
+            : { property: key, toggle: "all" });
+    }
+    // also keep declared groups that don't correspond to a Schema property
+    // (defensive — lets callers carry labels for future groups)
+    for (const g of declared) {
+        if (!groups.some((x) => x.property === g.property))
+            groups.push(g);
+    }
+    return groups.length ? groups : undefined;
+}
 export function graphWorkflowDefinitionOf(model) {
     const resolved = resolveModel(model);
     const workflow = graphWorkflowMetadataOf(resolved) || {};

package/lib/esm/graph/reader.js.map

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

package/lib/esm/index.js

@@ -16,21 +16,21 @@ export * from "./ui/index.js";
  * @const VERSION
  * @memberOf module:ui-decorators
  */
-export const VERSION = "0.17.3";
+export const VERSION = "0.17.4";
 /**
  * @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 const COMMIT = "04f33f3";
+export const COMMIT = "b222476";
 /**
  * @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 const FULL_VERSION = "0.17.3-04f33f3";
+export const FULL_VERSION = "0.17.4-b222476";
 export const PACKAGE_NAME = "@decaf-ts/ui-decorators";
 Metadata.registerLibrary(PACKAGE_NAME, VERSION);
 //# sourceMappingURL=index.js.map

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

@@ -31,6 +31,11 @@ export type GraphNodeMetadata = {
     width?: number;
     connectionRules?: GraphConnectionRule;
     metadata?: Record<string, unknown>;
+    /**
+     * Per-group rendering choice for Schema-typed `@input` / `@output` properties
+     * (the one-vs-all toggle). See {@link GraphPortGroupMetadata}.
+     */
+    portGroups?: GraphPortGroupMetadata[];
 };
 export type GraphWorkflowNodeMetadata = {
     id: string;
@@ -61,6 +66,41 @@ export type GraphPortMetadata = {
     handle?: string;
     expand?: boolean;
     metadata?: Record<string, unknown>;
+    /**
+     * Marks this port as a "Schema port" declared via `@input` / `@output`.
+     *
+     * When `true` AND the property type is a Decaf `Model` (a "Schema"), the
+     * reader flattens the Schema's own `@input` / `@output` properties into the
+     * parent node's port list (unprefixed — no `<schemaProp>.` prefix), instead
+     * of producing a composite port with prefixed children. A `@input` Schema
+     * contributes only the Schema's `@input` properties; a `@output` Schema
+     * contributes only the Schema's `@output` properties. The carrier property
+     * itself (e.g. `inputSchema`) is not emitted as a port — it is the group
+     * carrier.
+     *
+     * Set automatically by `@input` / `@output`; NOT set by `@port`, so
+     * `@port`-decorated Schema-typed properties keep the legacy composite
+     * expansion (prefixed children).
+     */
+    schema?: boolean;
+};
+/**
+ * Metadata for a Schema port group — the one-vs-all rendering choice for a
+ * `@input` / `@output` Schema-typed property.
+ *
+ * `toggle: "all"` (default) renders each Schema property as its own connectable
+ * port on the canvas. `toggle: "single"` renders one grouped port that receives
+ * the whole object and maps it to the right place. The per-instance
+ * manual-fill (hide a port because its value is supplied via the CRUD field)
+ * is NOT carried here — that is the editor's port-toggle state in `node.data`.
+ */
+export type GraphPortGroupMetadata = {
+    /** The Schema-typed `@input` / `@output` property name that owns this group. */
+    property: string;
+    /** Render choice for this group. Defaults to `"all"`. */
+    toggle?: "single" | "all";
+    /** Optional label for the grouped port when `toggle === "single"`. */
+    label?: string;
 };
 export type GraphPortDefinition = {
     property: string;
@@ -98,6 +138,13 @@ export type GraphNodeDefinition = {
     ui?: Record<string, any>;
     graph?: GraphNodeMetadata;
     ports: GraphPortDefinition[];
+    /**
+     * Per-group rendering choice for Schema-typed `@input` / `@output` properties
+     * (the one-vs-all toggle). Derived from {@link GraphNodeMetadata.portGroups};
+     * every Schema-typed `@input` / `@output` property not listed defaults to
+     * `toggle: "all"`.
+     */
+    portGroups?: GraphPortGroupMetadata[];
 };
 export type GraphWorkflowDefinition = GraphNodeDefinition & {
     inputs: GraphPortDefinition[];

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

@@ -31,6 +31,11 @@ export type GraphNodeMetadata = {
     width?: number;
     connectionRules?: GraphConnectionRule;
     metadata?: Record<string, unknown>;
+    /**
+     * Per-group rendering choice for Schema-typed `@input` / `@output` properties
+     * (the one-vs-all toggle). See {@link GraphPortGroupMetadata}.
+     */
+    portGroups?: GraphPortGroupMetadata[];
 };
 export type GraphWorkflowNodeMetadata = {
     id: string;
@@ -61,6 +66,41 @@ export type GraphPortMetadata = {
     handle?: string;
     expand?: boolean;
     metadata?: Record<string, unknown>;
+    /**
+     * Marks this port as a "Schema port" declared via `@input` / `@output`.
+     *
+     * When `true` AND the property type is a Decaf `Model` (a "Schema"), the
+     * reader flattens the Schema's own `@input` / `@output` properties into the
+     * parent node's port list (unprefixed — no `<schemaProp>.` prefix), instead
+     * of producing a composite port with prefixed children. A `@input` Schema
+     * contributes only the Schema's `@input` properties; a `@output` Schema
+     * contributes only the Schema's `@output` properties. The carrier property
+     * itself (e.g. `inputSchema`) is not emitted as a port — it is the group
+     * carrier.
+     *
+     * Set automatically by `@input` / `@output`; NOT set by `@port`, so
+     * `@port`-decorated Schema-typed properties keep the legacy composite
+     * expansion (prefixed children).
+     */
+    schema?: boolean;
+};
+/**
+ * Metadata for a Schema port group — the one-vs-all rendering choice for a
+ * `@input` / `@output` Schema-typed property.
+ *
+ * `toggle: "all"` (default) renders each Schema property as its own connectable
+ * port on the canvas. `toggle: "single"` renders one grouped port that receives
+ * the whole object and maps it to the right place. The per-instance
+ * manual-fill (hide a port because its value is supplied via the CRUD field)
+ * is NOT carried here — that is the editor's port-toggle state in `node.data`.
+ */
+export type GraphPortGroupMetadata = {
+    /** The Schema-typed `@input` / `@output` property name that owns this group. */
+    property: string;
+    /** Render choice for this group. Defaults to `"all"`. */
+    toggle?: "single" | "all";
+    /** Optional label for the grouped port when `toggle === "single"`. */
+    label?: string;
 };
 export type GraphPortDefinition = {
     property: string;
@@ -98,6 +138,13 @@ export type GraphNodeDefinition = {
     ui?: Record<string, any>;
     graph?: GraphNodeMetadata;
     ports: GraphPortDefinition[];
+    /**
+     * Per-group rendering choice for Schema-typed `@input` / `@output` properties
+     * (the one-vs-all toggle). Derived from {@link GraphNodeMetadata.portGroups};
+     * every Schema-typed `@input` / `@output` property not listed defaults to
+     * `toggle: "all"`.
+     */
+    portGroups?: GraphPortGroupMetadata[];
 };
 export type GraphWorkflowDefinition = GraphNodeDefinition & {
     inputs: GraphPortDefinition[];

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

@@ -5,3 +5,37 @@ export declare function graph(tag?: string, graph?: GraphWorkflowMetadata, props
 export declare function port(direction: PortDirection, graph?: Partial<Omit<GraphPortMetadata, "direction">>): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;
 export declare function input(graph?: Partial<Omit<GraphPortMetadata, "direction">>): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;
 export declare function output(graph?: Partial<Omit<GraphPortMetadata, "direction">>): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;
+/**
+ * Options for the `@pinnable()` decorator.
+ */
+export interface GraphPinnableOptions {
+    enabled?: boolean;
+    ttlMs?: number;
+    strategy?: "manual" | "automatic" | "disabled";
+    includeDependencies?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Pinning metadata stored on a node via `@pinnable()`.
+ */
+export interface GraphPinningMetadata {
+    enabled: boolean;
+    ttlMs?: number;
+    strategy: "manual" | "automatic" | "disabled";
+    includeDependencies: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Class decorator that marks a graph node as pinnable.
+ *
+ * The metadata is stored in the node's `graph.metadata.pinnable` field so the
+ * Angular renderer and the core pinning policy can read it.
+ *
+ * Usage:
+ * ```ts
+ * @node("ai.expensiveCompletion", { kind: "ai.expensiveCompletion" })
+ * @pinnable({ strategy: "manual", includeDependencies: true })
+ * export class ExpensiveCompletionNode extends Model { ... }
+ * ```
+ */
+export declare function pinnable(options?: GraphPinnableOptions): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;

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

@@ -5,3 +5,37 @@ export declare function graph(tag?: string, graph?: GraphWorkflowMetadata, props
 export declare function port(direction: PortDirection, graph?: Partial<Omit<GraphPortMetadata, "direction">>): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;
 export declare function input(graph?: Partial<Omit<GraphPortMetadata, "direction">>): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;
 export declare function output(graph?: Partial<Omit<GraphPortMetadata, "direction">>): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;
+/**
+ * Options for the `@pinnable()` decorator.
+ */
+export interface GraphPinnableOptions {
+    enabled?: boolean;
+    ttlMs?: number;
+    strategy?: "manual" | "automatic" | "disabled";
+    includeDependencies?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Pinning metadata stored on a node via `@pinnable()`.
+ */
+export interface GraphPinningMetadata {
+    enabled: boolean;
+    ttlMs?: number;
+    strategy: "manual" | "automatic" | "disabled";
+    includeDependencies: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Class decorator that marks a graph node as pinnable.
+ *
+ * The metadata is stored in the node's `graph.metadata.pinnable` field so the
+ * Angular renderer and the core pinning policy can read it.
+ *
+ * Usage:
+ * ```ts
+ * @node("ai.expensiveCompletion", { kind: "ai.expensiveCompletion" })
+ * @pinnable({ strategy: "manual", includeDependencies: true })
+ * export class ExpensiveCompletionNode extends Model { ... }
+ * ```
+ */
+export declare function pinnable(options?: GraphPinnableOptions): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;

package/lib/types/index.d.cts

@@ -15,19 +15,19 @@ export * from "./ui/index.d.cts";
  * @const VERSION
  * @memberOf module:ui-decorators
  */
-export declare const VERSION = "0.17.3";
+export declare const VERSION = "0.17.4";
 /**
  * @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 = "04f33f3";
+export declare const COMMIT = "b222476";
 /**
  * @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.17.3-04f33f3";
+export declare const FULL_VERSION = "0.17.4-b222476";
 export declare const PACKAGE_NAME = "@decaf-ts/ui-decorators";

package/lib/types/index.d.mts

@@ -15,19 +15,19 @@ export * from "./ui/index.d.mts";
  * @const VERSION
  * @memberOf module:ui-decorators
  */
-export declare const VERSION = "0.17.3";
+export declare const VERSION = "0.17.4";
 /**
  * @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 = "04f33f3";
+export declare const COMMIT = "b222476";
 /**
  * @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.17.3-04f33f3";
+export declare const FULL_VERSION = "0.17.4-b222476";
 export declare const PACKAGE_NAME = "@decaf-ts/ui-decorators";

package/lib/types/model/decorators.d.cts

@@ -75,7 +75,7 @@ export declare function uimodel(tag?: string, props?: Record<string, any>): (ori
  *   Model->>RenderingEngine: uses specified engine
  *   RenderingEngine->>System: renders with custom engine
  */
-export declare function renderedBy(engine: string): (target: object, propertyKey?: string | symbol | unknown, descriptor?: PropertyDescriptor | number) => void;
+export declare function renderedBy(engine: string): any;
 /**
  * @description Decorator that tags a model as a list item for UI rendering
  * @summary Specifies how a model should be rendered when displayed in a list context

package/lib/types/model/decorators.d.mts

@@ -75,7 +75,7 @@ export declare function uimodel(tag?: string, props?: Record<string, any>): (ori
  *   Model->>RenderingEngine: uses specified engine
  *   RenderingEngine->>System: renders with custom engine
  */
-export declare function renderedBy(engine: string): (target: object, propertyKey?: string | symbol | unknown, descriptor?: PropertyDescriptor | number) => void;
+export declare function renderedBy(engine: string): any;
 /**
  * @description Decorator that tags a model as a list item for UI rendering
  * @summary Specifies how a model should be rendered when displayed in a list context

package/lib/types/ui/decorators.d.cts

@@ -35,7 +35,7 @@ import { CrudOperationKeys, UIEventHandler, UIEventName, UIFunctionLike, UILayou
  *   Model->>RenderingEngine: Return hidden operations
  *   RenderingEngine->>UI: Render or hide based on current operation
  */
-export declare function hideOn(...operations: CrudOperationKeys[]): (object: any, propertyKey?: any) => void;
+export declare function hideOn(...operations: CrudOperationKeys[]): (object: any, propertyKey?: any) => any;
 /**
  * @description Decorator that sets the order of a UI element
  * @summary Specifies the rendering order for UI components
@@ -65,7 +65,7 @@ export declare function hideOn(...operations: CrudOperationKeys[]): (object: any
  *   uiorder->>property: sets order metadata
  *   uiorder->>System: returns decorated property
  */
-export declare function uiorder(order?: number | typeof UIKeys.FIRST | typeof UIKeys.LAST): (object: any, propertyKey?: any) => void;
+export declare function uiorder(order?: number | typeof UIKeys.FIRST | typeof UIKeys.LAST): (object: any, propertyKey?: any) => any;
 /**
  * @description Decorator that completely hides a property in all UI operations
  * @summary Makes a property invisible in all CRUD operations
@@ -101,7 +101,7 @@ export declare function uiorder(order?: number | typeof UIKeys.FIRST | typeof UI
  *   Model->>RenderingEngine: Return all operations
  *   RenderingEngine->>UI: Always hide property
  */
-export declare function hidden(): (object: any, propertyKey?: any) => void;
+export declare function hidden(): (object: any, propertyKey?: any) => any;
 /**
  * @description Decorator that specifies how a property should be rendered as a UI element
  * @summary Maps a model property to a specific UI element with custom properties
@@ -144,7 +144,7 @@ export declare function hidden(): (object: any, propertyKey?: any) => void;
  *   Model->>RenderingEngine: Return tag and props
  *   RenderingEngine->>UI: Render with specified element
  */
-export declare function uielement(tag: string | Record<string, any>, props?: Record<string, any>, serialize?: boolean): (original: any, propertyKey?: any) => void;
+export declare function uielement(tag: string | Record<string, any>, props?: Record<string, any>, serialize?: boolean): (original: any, propertyKey?: any) => any;
 /**
  * @description Decorator that maps a model property to a UI component property
  * @summary Specifies how a property should be passed to a UI component
@@ -405,7 +405,7 @@ export declare function uilayoutprop(col?: UILayoutCol, row?: number): (target:
  *   RenderingEngine->>PaginationController: Group properties by page
  *   PaginationController->>UI: Render current page properties
  */
-export declare function uipageprop(page?: number): (original: any, propertyKey?: any) => void;
+export declare function uipageprop(page?: number): (original: any, propertyKey?: any) => any;
 /**
  * A decorator factory that binds a UI event to a specified handler function.
  * This is used to attach event handlers to specific lifecycle events of a `DecafComponent`,

package/lib/types/ui/decorators.d.mts

@@ -35,7 +35,7 @@ import { CrudOperationKeys, UIEventHandler, UIEventName, UIFunctionLike, UILayou
  *   Model->>RenderingEngine: Return hidden operations
  *   RenderingEngine->>UI: Render or hide based on current operation
  */
-export declare function hideOn(...operations: CrudOperationKeys[]): (object: any, propertyKey?: any) => void;
+export declare function hideOn(...operations: CrudOperationKeys[]): (object: any, propertyKey?: any) => any;
 /**
  * @description Decorator that sets the order of a UI element
  * @summary Specifies the rendering order for UI components
@@ -65,7 +65,7 @@ export declare function hideOn(...operations: CrudOperationKeys[]): (object: any
  *   uiorder->>property: sets order metadata
  *   uiorder->>System: returns decorated property
  */
-export declare function uiorder(order?: number | typeof UIKeys.FIRST | typeof UIKeys.LAST): (object: any, propertyKey?: any) => void;
+export declare function uiorder(order?: number | typeof UIKeys.FIRST | typeof UIKeys.LAST): (object: any, propertyKey?: any) => any;
 /**
  * @description Decorator that completely hides a property in all UI operations
  * @summary Makes a property invisible in all CRUD operations
@@ -101,7 +101,7 @@ export declare function uiorder(order?: number | typeof UIKeys.FIRST | typeof UI
  *   Model->>RenderingEngine: Return all operations
  *   RenderingEngine->>UI: Always hide property
  */
-export declare function hidden(): (object: any, propertyKey?: any) => void;
+export declare function hidden(): (object: any, propertyKey?: any) => any;
 /**
  * @description Decorator that specifies how a property should be rendered as a UI element
  * @summary Maps a model property to a specific UI element with custom properties
@@ -144,7 +144,7 @@ export declare function hidden(): (object: any, propertyKey?: any) => void;
  *   Model->>RenderingEngine: Return tag and props
  *   RenderingEngine->>UI: Render with specified element
  */
-export declare function uielement(tag: string | Record<string, any>, props?: Record<string, any>, serialize?: boolean): (original: any, propertyKey?: any) => void;
+export declare function uielement(tag: string | Record<string, any>, props?: Record<string, any>, serialize?: boolean): (original: any, propertyKey?: any) => any;
 /**
  * @description Decorator that maps a model property to a UI component property
  * @summary Specifies how a property should be passed to a UI component
@@ -405,7 +405,7 @@ export declare function uilayoutprop(col?: UILayoutCol, row?: number): (target:
  *   RenderingEngine->>PaginationController: Group properties by page
  *   PaginationController->>UI: Render current page properties
  */
-export declare function uipageprop(page?: number): (original: any, propertyKey?: any) => void;
+export declare function uipageprop(page?: number): (original: any, propertyKey?: any) => any;
 /**
  * A decorator factory that binds a UI event to a specified handler function.
  * This is used to attach event handlers to specific lifecycle events of a `DecafComponent`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/ui-decorators",
-  "version": "0.17.3",
+  "version": "0.17.5",
   "description": "Extension of decorator validation to ui elements to allow for web integration",
   "type": "module",
   "exports": {