@pygmalionjs/pygmalion 0.17.0 → 0.18.0

package/README.md

@@ -529,6 +529,56 @@ 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.
+
+These snapshots do not yet drive Workspace selection handles, parent layout or
+the built-in multiline exporter. Callers must preserve the captured lifetime and
+apply scene transforms and clips when consuming them. Measurement never rewrites
+canonical width/height, adds an undo entry or changes source files.
+
 ## Local development
 
 ```bash