@decaf-ts/ui-decorators 0.20.1 → 0.20.3

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

@@ -85,6 +85,8 @@ export type GraphWorkflowSnapshotState = {
     ui: Record<string, unknown>;
     metadata: Record<string, unknown>;
 };
+/** Snapshot schema version literal type ({@link GRAPH_WORKFLOW_SNAPSHOT_VERSION}). */
+export type GraphWorkflowSnapshotVersion = typeof GRAPH_WORKFLOW_SNAPSHOT_VERSION;
 /**
  * Legacy persisted snapshot (`{ version, definition, state }`). Kept only for
  * loading/compatibility of persisted data; the canonical snapshot is
@@ -93,7 +95,7 @@ export type GraphWorkflowSnapshotState = {
  * {@link graphWorkflowSnapshotToLegacy}.
  */
 export type LegacyGraphWorkflowSnapshot = {
-    version: typeof GRAPH_WORKFLOW_SNAPSHOT_VERSION;
+    version: GraphWorkflowSnapshotVersion;
     definition: GraphWorkflowSnapshotDefinition;
     state: GraphWorkflowSnapshotState;
 };
@@ -146,7 +148,14 @@ export type GraphWorkflowSnapshot = {
     metadata?: Record<string, GraphJsonValue>;
 };
 export type GraphWorkflowSnapshotLike = LegacyGraphWorkflowSnapshot | GraphWorkflowSnapshot;
-/** Maps a legacy snapshot to the canonical {@link GraphWorkflowDocument}. */
+/**
+ * Maps a legacy (pre-P7) canvas snapshot to the canonical
+ * {@link GraphWorkflowDocument} (DECAF-50 §4.4.6): legacy `node.data` becomes
+ * instance `parameters`, legacy `node.metadata` becomes instance `metadata`,
+ * workflow boundary badges (`input-{port}`) fold back onto their workflow
+ * ports, and edge labels missing from cloned edge rows are restored from the
+ * decorated definition's relation labels (§4.4.7).
+ */
 export declare function graphWorkflowDocumentFromLegacySnapshot(snapshot: LegacyGraphWorkflowSnapshot): GraphWorkflowDocument;
 /**
  * Converts a legacy persisted snapshot into the canonical wrapper. The canonical

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

@@ -85,6 +85,8 @@ export type GraphWorkflowSnapshotState = {
     ui: Record<string, unknown>;
     metadata: Record<string, unknown>;
 };
+/** Snapshot schema version literal type ({@link GRAPH_WORKFLOW_SNAPSHOT_VERSION}). */
+export type GraphWorkflowSnapshotVersion = typeof GRAPH_WORKFLOW_SNAPSHOT_VERSION;
 /**
  * Legacy persisted snapshot (`{ version, definition, state }`). Kept only for
  * loading/compatibility of persisted data; the canonical snapshot is
@@ -93,7 +95,7 @@ export type GraphWorkflowSnapshotState = {
  * {@link graphWorkflowSnapshotToLegacy}.
  */
 export type LegacyGraphWorkflowSnapshot = {
-    version: typeof GRAPH_WORKFLOW_SNAPSHOT_VERSION;
+    version: GraphWorkflowSnapshotVersion;
     definition: GraphWorkflowSnapshotDefinition;
     state: GraphWorkflowSnapshotState;
 };
@@ -146,7 +148,14 @@ export type GraphWorkflowSnapshot = {
     metadata?: Record<string, GraphJsonValue>;
 };
 export type GraphWorkflowSnapshotLike = LegacyGraphWorkflowSnapshot | GraphWorkflowSnapshot;
-/** Maps a legacy snapshot to the canonical {@link GraphWorkflowDocument}. */
+/**
+ * Maps a legacy (pre-P7) canvas snapshot to the canonical
+ * {@link GraphWorkflowDocument} (DECAF-50 §4.4.6): legacy `node.data` becomes
+ * instance `parameters`, legacy `node.metadata` becomes instance `metadata`,
+ * workflow boundary badges (`input-{port}`) fold back onto their workflow
+ * ports, and edge labels missing from cloned edge rows are restored from the
+ * decorated definition's relation labels (§4.4.7).
+ */
 export declare function graphWorkflowDocumentFromLegacySnapshot(snapshot: LegacyGraphWorkflowSnapshot): GraphWorkflowDocument;
 /**
  * Converts a legacy persisted snapshot into the canonical wrapper. The canonical

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.20.1";
+export declare const VERSION = "0.20.3";
 /**
  * @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 = "4873fcd";
+export declare const COMMIT = "9f3f8bd";
 /**
  * @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.1-4873fcd";
+export declare const FULL_VERSION = "0.20.3-9f3f8bd";
 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.20.1";
+export declare const VERSION = "0.20.3";
 /**
  * @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 = "4873fcd";
+export declare const COMMIT = "9f3f8bd";
 /**
  * @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.1-4873fcd";
+export declare const FULL_VERSION = "0.20.3-9f3f8bd";
 export declare const PACKAGE_NAME = "@decaf-ts/ui-decorators";

package/lib/types/user-requests/UserRequestHandler.d.cts

@@ -69,7 +69,7 @@ export declare abstract class UserRequestHandler<T = unknown, C extends Context<
      * decorator under `USER_REQUEST_KEY`.
      * @param {string} reference The request id/type the handler is registered
      * for.
-     * @return {.Constructor<UserRequestHandler> | undefined}
+     * @return {Constructor<UserRequestHandler> | undefined}
      * The registered handler constructor, or `undefined` when unknown.
      */
     static getHandler(reference: string): Constructor<UserRequestHandler> | undefined;

package/lib/types/user-requests/UserRequestHandler.d.mts

@@ -69,7 +69,7 @@ export declare abstract class UserRequestHandler<T = unknown, C extends Context<
      * decorator under `USER_REQUEST_KEY`.
      * @param {string} reference The request id/type the handler is registered
      * for.
-     * @return {.Constructor<UserRequestHandler> | undefined}
+     * @return {Constructor<UserRequestHandler> | undefined}
      * The registered handler constructor, or `undefined` when unknown.
      */
     static getHandler(reference: string): Constructor<UserRequestHandler> | undefined;

package/package.json

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