@pygmalionjs/pygmalion 0.15.0 → 0.17.0

package/README.md

@@ -476,6 +476,59 @@ Process-group cleanup supports macOS and Linux. Catalog generation callbacks
 receive an isolated archive for the exact requested commit; cancelling one
 catalog request does not cancel generation shared with another caller.
 
+### Prepare declared text faces
+
+An optional `WorkspaceTargetConfiguration.textFontPreparation` capability can
+prepare fonts for the visible page and selected text layer. Create it with
+`createTextFontPreparationRuntime(resolver)` and reuse it for the lifetime of
+the declared font environment. The resolver receives the original family
+expression, numeric weight, normal/italic style, exact text sample and an abort
+signal. A ready result identifies the actual face and attests to that sample's
+coverage; otherwise it returns a named unavailable or failed result.
+
+The SDK shares identical pending requests, cancels abandoned readers, caches
+successful results and offers retry without editing the document. Page changes
+exclude hidden pages, and resolved component overrides retain their own font
+requirements. Connected or source-rendered text needs an explicit rendered
+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 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.
+
 ## Local development
 
 ```bash

package/dist-lib/{CameraLayer-CWrlA9D-.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-7no5RTHJ.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})`;