@pygmalionjs/pygmalion 0.11.0 → 0.12.0

package/dist-lib/types/workspace/edit/clipboard.d.ts

@@ -22,7 +22,7 @@ export interface PasteDesignResult {
     nodeIds: Record<string, string>;
 }
 /** Pure paste plan; commit the returned same-identity snapshot as one undoable transaction. */
-export declare function pasteDesignSubtrees(target: DesignDocument, payload: DesignClipboard, options: {
+export declare function pasteDesignSubtrees(targetInput: DesignDocument, payloadInput: DesignClipboard, options: {
     parentId: string;
     allocateId: (sourceId: string) => string;
     offset?: {

package/dist-lib/types/workspace/edit/projection.d.ts

@@ -4,6 +4,8 @@ import type { DesignDocument, DocumentNode, DocumentResolveOptions } from '../..
 export interface ProjectedDocumentNode {
     sourceNodeId: string;
     instanceId?: string;
+    /** Runtime presentation may attach the canonical enclosing instance path. */
+    instancePath?: readonly string[];
     rowPath: BindingRuntimeScope['rowPath'];
     node: DocumentNode;
     children: ProjectedDocumentNode[];

package/dist-lib/types/workspace/view/prototypeMotionDom.d.ts

@@ -0,0 +1,5 @@
+import type { PrototypeMotionLayer } from '../../document/prototypeMotion.js';
+/** Collect both incoming and inert outgoing scenes without traversing outside the supplied scene.
+ * Legacy renderers can recover kinds from their source document. Unresolved or malformed
+ * identities remain invalid descriptors so they crossfade without being paired. */
+export declare function collectPrototypeMotionLayers(scene: HTMLElement, resolveKind?: (sourceNodeId: string) => string | undefined): PrototypeMotionLayer<HTMLElement>[];

package/dist-lib/types/workspace/view/prototypePlayback.d.ts

@@ -1,5 +1,6 @@
 import type { DesignDocument, DocumentNode, ResolvedDocumentNode } from '../../document/contracts.js';
 import { type PrototypeEffect, type PrototypeEvent, type PrototypeRuntimeContext, type PrototypeStartOptions, type PrototypeState } from '../../document/prototype.js';
+import { type PrototypeDragFinishInput, type PrototypeDragStartInput } from '../../document/prototypeDrag.js';
 export interface PrototypeClock {
     now(): number;
     schedule(callback: () => void, delayMs: number): unknown;
@@ -10,6 +11,13 @@ export interface PrototypePlayerSnapshot {
     previous: PrototypeState | null;
     effects: readonly PrototypeEffect[];
     playing: boolean;
+    drag: {
+        id: number;
+        phase: 'dragging' | 'settling';
+        progress: number;
+        velocity: number;
+        outcome: 'commit' | 'cancel' | null;
+    } | null;
 }
 export interface PrototypePlayerOptions extends PrototypeStartOptions {
     clock: PrototypeClock;
@@ -20,6 +28,9 @@ export interface PrototypePlayerController {
     getSnapshot(): PrototypePlayerSnapshot;
     subscribe(listener: () => void): () => void;
     dispatch(event: PrototypeEvent): void;
+    beginDrag(input: Omit<PrototypeDragStartInput, 'now'>): boolean;
+    updateDrag(input: Pick<PrototypeDragStartInput, 'pointerId' | 'point'>): void;
+    endDrag(input: Omit<PrototypeDragFinishInput, 'now'>): void;
     pause(): void;
     resume(): void;
     dispose(): void;

package/jsx-source-reconciler.d.ts

@@ -8,6 +8,9 @@ export interface ReconcileSourceProjection { anchors: JsxStructureAnchor[]; node
 export interface JsxSourceReconcilerOptions {
   file: string;
   identityFile: string;
+  /** Additional nullable inputs, captured at construction. Each requires an own input key and proof on both sides.
+   * Names must be unique, nonblank, and different from file. identityFile is always included and may appear once. Default: []. */
+  optionalInputFiles?: readonly string[];
   rootId: string;
   definitionId: string;
   screenId: string;

package/node/jsx-source-reconciler.mjs

@@ -19,7 +19,7 @@ const sourceLayout = layout => layout ? { direction: layout.direction, gap: layo
 export function createJsxSourceReconciler({
   file, identityFile, rootId, definitionId, screenId, documentId, opaqueNodeIds,
   projectSource, resolveWrapper = () => undefined, compileDocumentSource,
-  allowUnchangedIslandRelocation = false,
+  allowUnchangedIslandRelocation = false, optionalInputFiles = [],
 }) {
   if ([file, identityFile, rootId, definitionId, screenId, documentId].some(value => typeof value !== 'string' || !value)
     || file === identityFile || !Array.isArray(opaqueNodeIds) || new Set(opaqueNodeIds).size !== opaqueNodeIds.length
@@ -27,13 +27,19 @@ export function createJsxSourceReconciler({
     || ![projectSource, resolveWrapper, compileDocumentSource].every(value => typeof value === 'function')) {
     throw new TypeError('A source reconciler requires explicit files, node identities, and projection/compiler callbacks.');
   }
+  const optionalInputs = Array.isArray(optionalInputFiles) ? [...optionalInputFiles] : null;
+  if (!optionalInputs || new Set(optionalInputs).size !== optionalInputs.length
+    || optionalInputs.some(value => typeof value !== 'string' || !value.trim() || value === file)) {
+    throw new TypeError('Optional source inputs must be unique nonempty file names excluding the main source file.');
+  }
+  const nullableInputs = new Set([identityFile, ...optionalInputs]);
   opaqueNodeIds = [...opaqueNodeIds];
   function capturedInputs(value) {
-    if (!record(value) || Object.keys(value).length > 500 || !Object.hasOwn(value, identityFile)
-      || typeof value[file] !== 'string' || !value[file]) fail('inputs-invalid', 'Complete source and identity inputs are required.');
+    if (!record(value) || Object.keys(value).length > 500 || [...nullableInputs].some(inputFile => !Object.hasOwn(value, inputFile))
+      || typeof value[file] !== 'string' || !value[file]) fail('inputs-invalid', 'Complete source, identity, and declared optional inputs are required.');
     let size = 0;
     for (const [inputFile, content] of Object.entries(value)) {
-      if (content === null && inputFile === identityFile) continue;
+      if (content === null && nullableInputs.has(inputFile)) continue;
       if (typeof content !== 'string' || Buffer.from(content).toString('utf8') !== content) fail('inputs-invalid', 'Source inputs must be UTF-8 strings.', inputFile);
       size += Buffer.byteLength(content);
     }
@@ -92,7 +98,9 @@ export function createJsxSourceReconciler({
       }
       seen.add(proof.file);
     }
-    if (!seen.has(file) || !seen.has(identityFile)) fail('proofs-invalid', 'Source and identity proofs are both required.');
+    if (!seen.has(file) || [...nullableInputs].some(inputFile => !seen.has(inputFile))) {
+      fail('proofs-invalid', 'Source, identity, and declared optional input proofs are required.');
+    }
   }
   function verifyProjection(document, projection) {
     for (const node of projection.nodes) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pygmalionjs/pygmalion",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Code-backed DOM design sandbox and visual QA editor",
   "license": "Apache-2.0",
   "repository": {