@pygmalionjs/pygmalion 0.16.0 → 0.17.0

package/dist-lib/types/document/exportSettings.d.ts

@@ -34,6 +34,7 @@ export interface RasterExportRequest {
     height: number;
     scale: number;
     contentsOnly: boolean;
+    signal?: AbortSignal;
 }
 export type RasterExportRenderer = (request: RasterExportRequest) => Promise<Uint8Array>;
 export interface DesignExportArtifact {
@@ -42,4 +43,6 @@ export interface DesignExportArtifact {
     bytes: Uint8Array;
 }
 /** Raster bytes come only from an explicit host renderer; no hidden capture or network access. */
-export declare function exportDesignNode(document: DesignDocument, nodeId: string, setting: ExportSetting, renderer?: RasterExportRenderer): Promise<DesignExportArtifact>;
+export declare function exportDesignNode(document: DesignDocument, nodeId: string, setting: ExportSetting, renderer?: RasterExportRenderer, options?: {
+    signal?: AbortSignal;
+}): Promise<DesignExportArtifact>;

package/dist-lib/types/lib.d.ts

@@ -445,4 +445,5 @@ export type { PrototypeInputFrame } from './workspace/view/prototypeInputFrame.j
 export { createPrototypeProjectionContext } from './workspace/edit/prototypeProjection.js';
 export type { PrototypeProjectionContext } from './workspace/edit/prototypeProjection.js';
 export * from './workspace/edit/rasterExport.js';
+export type { PreparedTextRasterFaceReference, TextRasterFaceResolver } from './workspace/edit/staticTextRaster.js';
 export * from './document/imagePaintGeometry.js';

package/dist-lib/types/workspace/configuration.d.ts

@@ -5,6 +5,7 @@ import type { WorkspaceSourceCapabilities } from './source/flowContracts.js';
 import type { WorkspaceTarget } from './contracts.js';
 import type { WorkspaceTokenLibraryCapabilities } from './tokens/contracts.js';
 import type { TextFontPreparationRuntime } from './edit/textFontRuntime.js';
+import type { TextRasterFaceResolver } from './edit/staticTextRaster.js';
 /** One target's source, data, rendering, and persistence capabilities travel together. */
 export interface WorkspaceTargetConfiguration {
     data?: HostDataCapabilities;
@@ -12,6 +13,8 @@ export interface WorkspaceTargetConfiguration {
     duplicateMetadata?: DocumentDuplicateMetadataRemapper;
     /** Explicit font face and sample preparation; browser fallback rendering is not exact readiness. */
     textFontPreparation?: TextFontPreparationRuntime;
+    /** Bind a prepared face identity to its exact registered browser FontFace for static text output. */
+    textRasterFaceResolver?: TextRasterFaceResolver;
     loadDocument?(target: WorkspaceTarget, options: {
         signal: AbortSignal;
     }): Promise<DesignDocument>;

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

@@ -10,8 +10,10 @@ export interface AssetsPanelProps {
     onSelect?: (nodeId: string) => void;
     onExport?: (artifact: DesignExportArtifact) => void | Promise<void>;
     rasterRenderer?: RasterExportRenderer;
+    lifetimeKey?: string;
+    subscribeLifetime?: (invalidate: () => void) => () => void;
     disabled?: boolean;
 }
-export declare function AssetsPanel({ engine, pageId, parentId, selectedNodeId, allocateId, onSelect, onExport, rasterRenderer, disabled }: AssetsPanelProps): import("react").JSX.Element;
+export declare function AssetsPanel({ engine, pageId, parentId, selectedNodeId, allocateId, onSelect, onExport, rasterRenderer, lifetimeKey, subscribeLifetime, disabled }: AssetsPanelProps): import("react").JSX.Element;
 /** Explicit local download callback for the panel; raster output still needs a separate host renderer. */
 export declare function downloadDesignArtifact(artifact: DesignExportArtifact): void;

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

@@ -1,10 +1,12 @@
 import type { DocumentEngine } from '../../document/contracts.js';
 import { type DesignExportArtifact, type RasterExportRenderer } from '../../document/exportSettings.js';
 /** The inspector and asset browser share one persisted export-settings editor. */
-export declare function NodeExportPanel({ engine, nodeId, onExport, rasterRenderer, disabled }: {
+export declare function NodeExportPanel({ engine, nodeId, onExport, rasterRenderer, disabled, lifetimeKey, subscribeLifetime }: {
     engine: DocumentEngine;
     nodeId?: string;
     onExport?(artifact: DesignExportArtifact): void | Promise<void>;
     rasterRenderer?: RasterExportRenderer;
     disabled?: boolean;
+    lifetimeKey?: string;
+    subscribeLifetime?: (invalidate: () => void) => () => void;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,6 @@
+import type { DesignDocument } from '../../document/contracts.js';
+
+/** Browse authored style metadata without selecting a layer or requesting fonts. */
+export declare function TextStyleCatalog({ document }: {
+    document: DesignDocument;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,6 @@
+import type { RasterExportRequest } from '../../document/exportSettings.js';
+export declare function assertRasterActive(signal?: AbortSignal): void;
+export declare function validateRasterSize(request: Pick<RasterExportRequest, 'width' | 'height'>): void;
+/** Cancellation ends this reader even if a browser decode or encode cannot be interrupted internally. */
+export declare function awaitRasterActive<T>(work: Promise<T>, signal?: AbortSignal): Promise<T>;
+export declare function encodeRasterCanvas(canvas: HTMLCanvasElement, format: RasterExportRequest['format'], signal?: AbortSignal): Promise<Uint8Array>;

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

@@ -1,5 +1,13 @@
+import { type TextRasterFaceResolver } from './staticTextRaster.js';
+import type { TextFontPreparationRuntime } from './textFontRuntime.js';
 import { type RasterExportRenderer, type RasterExportRequest } from '../../document/exportSettings.js';
 /** The same supported SVG geometry supplies browser raster output; unsupported visuals stay explicit. */
 export declare function rasterExportSvg(request: RasterExportRequest): string;
-/** Explicit browser renderer for supported geometry. It never captures a page or fetches external resources. */
+/** Adds bounded authored text output only when an explicit exact-face provider is available. */
+export declare function createDesignRasterRenderer(options?: {
+    textFontPreparation?: TextFontPreparationRuntime;
+    sourceMapped?: boolean;
+    resolvePreparedFace?: TextRasterFaceResolver;
+}): RasterExportRenderer;
+/** Backward-compatible geometry renderer. Exact text output is explicitly enabled through the factory. */
 export declare const renderDesignRaster: RasterExportRenderer;

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

@@ -0,0 +1,50 @@
+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;
+export interface StaticTextRasterPlan {
+    readonly nodeId: string;
+    readonly width: number;
+    readonly height: number;
+    readonly outputWidth: number;
+    readonly outputHeight: number;
+    readonly font: TextFontFaceRequest;
+    readonly fontSize: number;
+    readonly lineHeight: number;
+    readonly align: 'start' | 'center' | 'end';
+    readonly color: string;
+    readonly opacity: number;
+}
+/** The first text raster slice is a single authored, fixed-size, undecorated line with explicit typography. */
+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;
+    x: number;
+    y: number;
+};
+/** Measures the same pre-wrap line box as TextNodeSurface, using a zero-height inline baseline marker. */
+export declare function measureStaticTextRaster(plan: StaticTextRasterPlan, family: string, owner: Document): {
+    x: number;
+    baseline: number;
+};
+/** 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;
+}): Promise<Uint8Array>;

package/package.json

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