@pygmalionjs/pygmalion 0.17.0 → 0.19.0

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

@@ -1,6 +1,7 @@
 import type { DataProjection } from '../../binding/preview.js';
 import type { DesignDocument, DocumentTransaction } from '../../document/contracts.js';
 import { type PrototypeAction, type PrototypeInteraction } from '../../document/prototype.js';
+import { type ProjectedDocumentNode } from './projection.js';
 export type PrototypeActionPath = readonly (number | 'branches' | 'actions' | 'otherwise')[];
 export interface PrototypeConnectionSelection {
     nodeId: string;
@@ -35,7 +36,7 @@ export declare const connectionKey: (value: PrototypeConnectionSelection) => str
 /** Only explicit destination actions become wires. No flow or action is inferred. */
 export declare function prototypeConnections(document: DesignDocument): PrototypeConnection[];
 /** Canonical, uniquely placed layers only; projected rows and instance leaves cannot acquire shared actions accidentally. */
-export declare function planPrototypeWiring(document: DesignDocument, projection: DataProjection | null, selected?: readonly string[], visibleRootIds?: readonly string[]): PrototypeWiringPlan;
+export declare function planPrototypeWiring(document: DesignDocument, projection: DataProjection | null, selected?: readonly string[], visibleRootIds?: readonly string[], scene?: ProjectedDocumentNode): PrototypeWiringPlan;
 /** Builds a complete detached edit before the caller opens its single history transaction. */
 export declare function preparePrototypeConnection(document: DesignDocument, sourceId: string, destinationId: string | null, selection?: PrototypeConnectionSelection, interactionId?: string): PrototypeInteraction[];
 export declare function writePrototypeConnection(transaction: DocumentTransaction, document: DesignDocument, sourceId: string, interactions: readonly PrototypeInteraction[]): void;

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

@@ -1,16 +1,9 @@
 import { type RasterExportRequest } from '../../document/exportSettings.js';
 import { type TextFontFaceRequest } from '../../document/richText.js';
 import type { TextFontPreparationRuntime } from './textFontRuntime.js';
-export interface PreparedTextRasterFaceReference {
-    readonly environmentId: string;
-    readonly faceId: string;
-    readonly family: string;
-    readonly weight: number;
-    readonly style: 'normal' | 'italic';
-    readonly sample: string;
-}
-/** The owner maps its exact prepared identity to the same FontFace object registered for drawing. */
-export type TextRasterFaceResolver = (reference: PreparedTextRasterFaceReference) => FontFace | undefined;
+import { type PreparedTextFaceResolver } from './preparedTextFace.js';
+export { supportsPreparedTextFace as supportsStaticTextFace, preparedTextFaceCoversSample as staticTextFaceCoversSample } from './preparedTextFace.js';
+export type { PreparedTextFaceReference as PreparedTextRasterFaceReference, PreparedTextFaceResolver as TextRasterFaceResolver } from './preparedTextFace.js';
 export interface StaticTextRasterPlan {
     readonly nodeId: string;
     readonly width: number;
@@ -28,10 +21,6 @@ export interface StaticTextRasterPlan {
 export declare function createStaticTextRasterPlan(request: RasterExportRequest, options?: {
     sourceMapped?: boolean;
 }): StaticTextRasterPlan;
-/** Registered face descriptors must support the requested style and weight without synthesis. */
-export declare function supportsStaticTextFace(face: Pick<FontFace, 'family' | 'style' | 'weight' | 'stretch' | 'status'>, family: string, request: TextFontFaceRequest): boolean;
-/** Registered unicode-range restrictions are distinct from the provider's glyph-coverage attestation. */
-export declare function staticTextFaceCoversSample(unicodeRange: string, sample: string): boolean;
 /** Matches the SVG renderer's default xMidYMid meet behavior after output dimension rounding. */
 export declare function staticTextRasterViewport(plan: Pick<StaticTextRasterPlan, 'width' | 'height' | 'outputWidth' | 'outputHeight'>): {
     scale: number;
@@ -46,5 +35,5 @@ export declare function measureStaticTextRaster(plan: StaticTextRasterPlan, fami
 /** A ready explicit provider plus a registered browser face is required; platform fallback checks are insufficient. */
 export declare function renderStaticTextRaster(request: RasterExportRequest, runtime: TextFontPreparationRuntime, options?: {
     sourceMapped?: boolean;
-    resolvePreparedFace?: TextRasterFaceResolver;
+    resolvePreparedFace?: PreparedTextFaceResolver;
 }): Promise<Uint8Array>;

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

@@ -0,0 +1,3 @@
+import { type TextLayoutGeometry, type TextLayoutPlan } from '../../document/textLayout.js';
+/** Reads a fully shaped native paragraph. No character is drawn or laid out independently. */
+export declare function measureBrowserTextLayout(plan: TextLayoutPlan, family: string, owner: Document, signal?: AbortSignal): TextLayoutGeometry;

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

@@ -0,0 +1,12 @@
+import type { DesignDocument } from '../../document/contracts.js';
+import { type TextLayoutAddress, type TextLayoutPlan } from '../../document/textLayout.js';
+import { type ProjectedDocumentNode } from './projection.js';
+export interface TextLayoutPlanOptions {
+    readonly revisionKey: string;
+    readonly address: TextLayoutAddress;
+    readonly scene?: ProjectedDocumentNode;
+    readonly visibleRootIds?: readonly string[];
+    readonly sourceMapped?: boolean;
+}
+/** Selects one visible effective occurrence without changing canonical geometry or rewriting IDs. */
+export declare function createTextLayoutPlan(document: DesignDocument, options: TextLayoutPlanOptions): TextLayoutPlan;

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

@@ -0,0 +1,28 @@
+import type { DataProjection } from '../../binding/preview.js';
+import type { DesignDocument, DocumentDiagnostic } from '../../document/contracts.js';
+import { type ProjectedDocumentNode, type ProjectedTextLayout } from './projection.js';
+import type { TextLayoutRuntime } from './textLayoutRuntime.js';
+export interface TextLayoutSceneOptions {
+    readonly scene: ProjectedDocumentNode;
+    readonly revisionKey: string;
+    readonly visibleRootIds?: readonly string[];
+    readonly projection?: DataProjection | null;
+    readonly sourceMapped?: boolean;
+}
+export interface TextLayoutScene {
+    readonly scene: ProjectedDocumentNode;
+    readonly status: ProjectedTextLayout['status'];
+    readonly diagnostics: readonly DocumentDiagnostic[];
+}
+/** Carries unresolved derived axes to ancestors before any asynchronous work starts. */
+export declare function prepareTextLayoutScene(document: DesignDocument, options: TextLayoutSceneOptions, available?: boolean): TextLayoutScene;
+/** One bounded disposable layout, shared by rendering and every geometry reader. */
+export declare function measureTextLayoutScene(document: DesignDocument, options: TextLayoutSceneOptions & {
+    runtime: TextLayoutRuntime;
+    signal?: AbortSignal;
+    retry?: boolean;
+}): Promise<TextLayoutScene>;
+/** Position-only candidate validation. The caller must also retain the original scene lifetime guard. */
+export declare function reuseTextLayoutScene(document: DesignDocument, options: TextLayoutSceneOptions & {
+    measuredScene: ProjectedDocumentNode;
+}): TextLayoutScene;

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

@@ -0,0 +1,20 @@
+import { type TextLayoutPlan, type TextLayoutSnapshot } from '../../document/textLayout.js';
+import { type PreparedTextFaceResolver } from './preparedTextFace.js';
+import type { TextFontPreparationRuntime } from './textFontRuntime.js';
+export interface TextLayoutRuntime {
+    readonly environmentId: string;
+    measure(plan: TextLayoutPlan, options?: {
+        signal?: AbortSignal;
+        retry?: boolean;
+    }): Promise<TextLayoutSnapshot>;
+    /** Invalidates this measurement cache; the injected font runtime keeps its own lifetime. */
+    clear(): void;
+    dispose(): void;
+}
+/** One runtime belongs to one browser font environment. Cached geometry still revalidates actual faces. */
+export declare function createTextLayoutRuntime(options: {
+    textFontPreparation: TextFontPreparationRuntime;
+    resolvePreparedFace?: PreparedTextFaceResolver;
+    ownerDocument?: Document;
+    maxEntries?: number;
+}): TextLayoutRuntime;

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

@@ -0,0 +1,19 @@
+import type { DocumentEngine } from '../../document/contracts.js';
+import { type DesignTransferPasteResult } from './clipboardTransfer.js';
+interface ClipboardPasteOptions {
+    engine: DocumentEngine;
+    parentId: string;
+    pageId?: string;
+    allocateId: (sourceId: string) => string;
+    onApply: (plan: DesignTransferPasteResult) => boolean;
+    onError: (message: string) => void;
+    lifetimeKey?: string;
+    subscribeLifetime?: (invalidate: () => void) => () => void;
+    disabled?: boolean;
+}
+/** The mapping dialog is a pending operation, never a partial document mutation. */
+export declare function useDesignClipboardPaste({ engine, parentId, pageId, allocateId, onApply, onError, lifetimeKey, subscribeLifetime, disabled }: ClipboardPasteOptions): {
+    paste: (text: string) => void;
+    dialog: import("react").JSX.Element | null;
+};
+export {};

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

@@ -0,0 +1,19 @@
+import type { DocumentEngine } from '../../document/contracts.js';
+import { type TextLayoutScene, type TextLayoutSceneOptions } from './textLayoutProjection.js';
+import type { TextLayoutRuntime } from './textLayoutRuntime.js';
+export interface UseTextLayoutOptions extends TextLayoutSceneOptions {
+    readonly engine: DocumentEngine;
+    readonly runtime?: TextLayoutRuntime | null;
+    readonly lifetimeKey: string;
+    /** Fires synchronously for target, mode, page or provider transitions, including batched round trips. */
+    readonly subscribeLifetime?: (invalidate: () => void) => () => void;
+    readonly ownerDocument?: Document;
+}
+export interface TextLayoutState extends TextLayoutScene {
+    readonly geometryKey: string;
+    /** Capture this function at gesture start; a later render cannot revive that geometry. */
+    readonly isCurrent: () => boolean;
+    readonly retry: () => void;
+}
+/** One subscription owns the disposable scene and its synchronous invalidation epoch. */
+export declare function useTextLayout(options: UseTextLayoutOptions): TextLayoutState;

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

@@ -1,8 +1,8 @@
 import type { DataProjection } from '../../binding/preview.js';
 import type { DesignDocument, DocumentDiagnostic, DocumentMatrix, DocumentNode, DocumentNodePatch, DocumentTransaction } from '../../document/contracts.js';
 import { booleanVectorPrecision, type VectorAnchor, type VectorAnchorAddress, type VectorBooleanOperation, type VectorFillRule, type VectorPoint, type VectorProperties, type VectorShape, type VectorStroke } from '../../document/vector.js';
-import { type LayerGeometry } from './geometryHandles.js';
-import type { ProjectedDocumentNode } from './projection.js';
+import { type LayerGeometry, type SnapCandidateOptions } from './geometryHandles.js';
+import { type ProjectedDocumentNode } from './projection.js';
 /**
  * Pure editing model for `vector` layers. The document stores path data under
  * `node.properties.vector` in the layer's own space; the layer box is the geometry's
@@ -91,7 +91,9 @@ export declare function vectorGeometryPatch(node: DocumentNode, next: VectorProp
 /** Changes paint and corner keys without touching geometry; an `undefined` value removes the key. */
 export declare function vectorStylePatch(node: DocumentNode, style: Partial<VectorStyle>): DocumentNodePatch;
 /** Canvas placement of a layer: the world transform with the root's own transform removed, as the canvas renders it. */
-export declare function renderedWorldTransform(document: DesignDocument, nodeId: string): DocumentMatrix;
+export declare function renderedWorldTransform(document: DesignDocument, nodeId: string, options?: SnapCandidateOptions & {
+    projection?: DataProjection | null;
+}): DocumentMatrix;
 /** New layers join the selected container, or the root; the rule matches text insertion. */
 export declare function vectorInsertParent(document: DesignDocument, selection: readonly string[]): string;
 /** A default-sized shape placed inside the parent, offset by the number of existing children so repeated inserts stay visible. */
@@ -105,13 +107,15 @@ export declare function penPathNode(points: readonly VectorAnchor[], closed: boo
  * selection handles use, so an auto layout child, a source layout fragment, or a repeated
  * row is refused with the same diagnostic instead of a guessed box.
  */
-export declare function planVectorEdit(document: DesignDocument, selection: readonly string[], projection: DataProjection | null): VectorEditPlan;
+export declare function planVectorEdit(document: DesignDocument, selection: readonly string[], projection: DataProjection | null, options?: SnapCandidateOptions): VectorEditPlan;
 /** Anchor operations the current anchor selection allows. */
 export declare function vectorAnchorActions(vector: VectorProperties, anchors: readonly VectorAnchorAddress[]): VectorAnchorActions;
 /** Applies one anchor action to the box geometry; the caller commits the result as one transaction. */
 export declare function applyVectorAnchorAction(vector: VectorProperties, anchors: readonly VectorAnchorAddress[], action: VectorAnchorAction): VectorAnchorActionResult;
 /** Two vector layers sharing a parent; the lower layer (earlier in the parent order) is the base of a subtraction. */
-export declare function planVectorBoolean(document: DesignDocument, selection: readonly string[]): VectorBooleanPlan;
+export declare function planVectorBoolean(document: DesignDocument, selection: readonly string[], options?: SnapCandidateOptions & {
+    projection?: DataProjection | null;
+}): VectorBooleanPlan;
 /** The combined layer, in the parent's space, with the lower layer's paint. Throws when the result has no shape. */
 export declare function vectorBooleanNode(plan: Extract<VectorBooleanPlan, {
     status: 'ready';

package/package.json

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