@pygmalionjs/pygmalion 0.17.0 → 0.19.0

package/README.md

@@ -529,6 +529,77 @@ stored typography and library origin. This metadata browser neither discovers
 installed fonts nor downloads faces; selecting a layer retains the existing
 style application and editing controls.
 
+### Paste layers with styles and prototype connections
+
+Workspace copy includes the selected graph, its referenced component definitions
+and variant sets, and the styles and prototype declarations that graph uses.
+Pasting creates new local identities automatically when all relationships fit.
+Name conflicts and connections outside the copied graph open a dialog before
+changing the document. Resolve names, choose whether to keep copied flow starts,
+and select existing destination screens. Internal IDs do not need manual editing.
+An existing style may be reused only through an explicit selection that matches
+its complete value and library origin. Target presentation settings are retained.
+Copied flow starts can be explicitly omitted; keeping a starting screen below a
+nested container is refused.
+
+Programmatic consumers use `copyDesignSubtreesWithRelationships(document,
+selection, { flowPolicy: 'selected-starts' | 'none' })`, the matching serialization
+and parsing functions, and `pasteDesignSubtreesWithRelationships`. The paste
+options require complete `styles` and `prototype` relationship maps for a version
+2 envelope. The resulting plan contains every node, asset and owned sidecar;
+`applyDesignTransferPaste(transaction, currentDocument, plan)` checks the target
+fingerprint before replacing it in one undoable transaction. Changes to the
+document, page, source or mode invalidate an open Workspace paste.
+
+Plain content still emits version 1. The original version 1 APIs keep their
+existing relationship refusal behavior. Both formats preserve component override
+addresses through the existing structural codec. Variable-library bindings,
+data/source bindings and unknown document sidecars still require their own
+explicit adapters. Clipboard transfer does not write a token library, fetch a
+remote asset or apply implementation source.
+
+### Measure an authored plain-text occurrence
+
+`createTextLayoutPlan` captures one visible resolved text occurrence with an
+explicit document revision key and instance/row address. `createTextLayoutRuntime`
+uses the exact font preparation and registered face resolver to measure that
+plan in a browser. It returns immutable local CSS-pixel bounds, line baselines,
+UTF-16 grapheme ranges and face/environment identity. Fixed, auto-width and
+auto-height modes follow the existing text surface. Native shaping remains on
+the complete paragraph; character ranges only observe the resulting geometry.
+
+Each acquisition rechecks face registration, including cache hits. Concurrent
+readers share work, cancellation respects remaining readers, and successful
+entries use a bounded cache. Dispose the runtime when its font environment ends.
+Mixed text, bidi, connected/repeated content, unresolved typography and
+source-rendered text return named diagnostics in this first measurement API.
+
+When both font capabilities are supplied, Workspace shares a disposable measured
+scene between the canvas, selection handles, snapping, guides, alignment and
+prototype wiring. Auto-height text keeps its authored minimum height when its
+width changes; auto-width text owns both dimensions. Inspector sizes follow the
+measured scene and derived dimensions cannot be overwritten by resize controls.
+Pending or unavailable derived bounds stay unavailable to geometry commands.
+Changing the document, page, source, mode or font registration cancels stale
+geometry work and gestures. Late measurements never reset a camera the user moved.
+
+This integration supports plain text under the existing bounded layout solver.
+Non-start constraints under text-resized ancestors, mixed text and dynamic
+prototype playback still need additional geometry integration. The built-in
+multiline exporter is also separate work. Measurement never rewrites canonical
+width/height, adds an undo entry or changes source files.
+
+### Inspect an existing variable binding
+
+`resolveVariableModeForNode` and `resolveVariableModeForInstance` return the
+requested collection mode and the scope that supplied it. Instance addresses
+use the existing opaque override address; consumers do not reconstruct paths.
+`planVariableOccurrence` captures one actual bound occurrence, its token
+resolution (including the authored mode), scalar value and literal patch without
+refreshing unrelated nodes. `projectVariableScalar` exposes the same validation
+and own-node or sparse-override projection used by refresh. These reads do not
+write either document or enable variable-library clipboard transfer.
+
 ## Local development
 
 ```bash

package/dist-lib/{CameraLayer-Clqgdcjb.js → CameraLayer-Bv1TqRim.js}

@@ -1,5 +1,5 @@
 import { jsx as p } from "react/jsx-runtime";
-import { n as C, R as g, aM as P, ck as R, cl as k, Y as E, cm as I, a7 as m, a4 as b } from "./runtime-B8Qu1ung.js";
+import { n as C, R as g, aM as P, ck as R, cl as k, Y as E, cm as I, a7 as m, a4 as b } from "./runtime-DlZpODq8.js";
 import { useRef as L, useLayoutEffect as h } from "react";
 function v(n) {
   return `translate(${n.panX}px, ${n.panY}px) scale(${n.zoom})`;