@pygmalionjs/pygmalion 0.16.0 → 0.18.0

package/README.md

@@ -494,9 +494,90 @@ sample; the SDK does not guess that sample from a canonical placeholder.
 
 The existing family/weight `TextFontLoader` API remains available. Browser
 `document.fonts.check()` success alone does not establish an exact face or glyph
-coverage. The preparation capability does not download fonts implicitly, change
-text geometry, or enable text raster/SVG output; those output boundaries remain
-explicit. Dispose the runtime when its font environment is no longer used.
+coverage. The preparation capability does not download fonts implicitly or change
+text geometry. Dispose the runtime when its font environment is no longer used.
+
+### Export authored text and inspect file styles
+
+The browser `createDesignRasterRenderer({ textFontPreparation, resolvePreparedFace })`
+factory reuses that explicit preparation runtime for a selected static text
+layer. The face resolver maps the prepared environment and face identity to its
+exact registered `FontFace` object. Missing, replaced or ambiguous registrations
+are refused. Workspace connects `textFontPreparation` and
+`textRasterFaceResolver` to its inspector and asset export controls. Text
+requires a fixed positive box, one unwrapped paragraph, explicit family, size,
+weight, line height and zero letter spacing, one solid color, and a registered
+browser face matching the declared style and weight. The provider attests exact
+face identity and sample coverage; browser fallback or synthesized styling is
+not accepted as that evidence.
+
+PNG, JPG and WebP retain the layer box and existing output size limits. Text
+with mixed runs, automatic sizing, layout-dependent placement, source/bound
+content, decorations, effects or unresolved colors is refused. SVG text and
+frames containing text remain unsupported by the built-in exporter. The
+existing `renderDesignRaster` geometry renderer remains available without a
+font provider. Raster success never enables a source writer.
+
+`exportDesignNode` accepts an optional fifth `{ signal }` argument. Workspace
+cancels pending output when the layer, document, target, page or mode changes,
+including a rapid departure and return before a render. Export never adds a
+history entry or applies implementation source.
+
+With no layer selected, the properties sidebar lists the file's authored text
+styles, grouped by their slash-separated names. Expanding a style displays its
+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
 

package/dist-lib/{CameraLayer-BNw26sgR.js → CameraLayer-Clqgdcjb.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-Bo5tncK_.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-B8Qu1ung.js";
 import { useRef as L, useLayoutEffect as h } from "react";
 function v(n) {
   return `translate(${n.panX}px, ${n.panY}px) scale(${n.zoom})`;