@decaf-ts/ui-decorators 0.17.3 → 0.17.4

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/index.d.cts

@@ -22,12 +22,12 @@ export declare const VERSION = "0.17.3";
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "04f33f3";
+export declare const COMMIT = "ff23f4a";
 /**
  * @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.3-ff23f4a";
 export declare const PACKAGE_NAME = "@decaf-ts/ui-decorators";

package/lib/types/index.d.mts

@@ -22,12 +22,12 @@ export declare const VERSION = "0.17.3";
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "04f33f3";
+export declare const COMMIT = "ff23f4a";
 /**
  * @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.3-ff23f4a";
 export declare const PACKAGE_NAME = "@decaf-ts/ui-decorators";

package/package.json

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