domotion-svg 0.28.2 → 0.29.0

package/README.md

@@ -200,7 +200,16 @@ const page = await browser.newPage();
 await page.setContent(`<div style="padding:20px;color:white;background:#0d1117">Hello</div>`);
 
 const tree = await captureElementTree(page, "body", { x: 0, y: 0, width: 800, height: 200 });
-const svg = elementTreeToSvg(tree, 800, 200);
+const svg = elementTreeToSvg(tree, 800, 200, {
+  // Optional: searchable/selectable text when this SVG is embedded inline.
+  // This cannot expose text through <img src="…">.
+  realTextLayer: true,
+  // Optional: how text is emitted. Default "embedded-font" is self-contained
+  // and pixel-faithful. "system-font" instead emits authored <text> painted
+  // by the VIEWER's installed fonts — smaller output, but not pixel-faithful
+  // and only correct where the fonts are present (CLI: --text-mode system-font).
+  // renderTextMode: "system-font",
+});
 
 console.log(svg);
 await browser.close();

package/dist/animation/overlay-schema.d.ts

@@ -28,10 +28,10 @@ import { z } from "zod";
  */
 export declare const overlaySlideSchema: z.ZodObject<{
     from: z.ZodEnum<{
-        left: "left";
-        right: "right";
         top: "top";
+        right: "right";
         bottom: "bottom";
+        left: "left";
     }>;
     duration: z.ZodNumber;
     easing: z.ZodOptional<z.ZodString>;
@@ -139,10 +139,10 @@ export declare const svgOverlaySchema: z.ZodObject<{
     animId: z.ZodString;
     enter: z.ZodOptional<z.ZodObject<{
         from: z.ZodEnum<{
-            left: "left";
-            right: "right";
             top: "top";
+            right: "right";
             bottom: "bottom";
+            left: "left";
         }>;
         duration: z.ZodNumber;
         easing: z.ZodOptional<z.ZodString>;
@@ -150,10 +150,10 @@ export declare const svgOverlaySchema: z.ZodObject<{
     }, z.core.$strip>>;
     exit: z.ZodOptional<z.ZodObject<{
         from: z.ZodEnum<{
-            left: "left";
-            right: "right";
             top: "top";
+            right: "right";
             bottom: "bottom";
+            left: "left";
         }>;
         duration: z.ZodNumber;
         easing: z.ZodOptional<z.ZodString>;
@@ -315,10 +315,10 @@ export declare const animationOverlaySchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     animId: z.ZodString;
     enter: z.ZodOptional<z.ZodObject<{
         from: z.ZodEnum<{
-            left: "left";
-            right: "right";
             top: "top";
+            right: "right";
             bottom: "bottom";
+            left: "left";
         }>;
         duration: z.ZodNumber;
         easing: z.ZodOptional<z.ZodString>;
@@ -326,10 +326,10 @@ export declare const animationOverlaySchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     }, z.core.$strip>>;
     exit: z.ZodOptional<z.ZodObject<{
         from: z.ZodEnum<{
-            left: "left";
-            right: "right";
             top: "top";
+            right: "right";
             bottom: "bottom";
+            left: "left";
         }>;
         duration: z.ZodNumber;
         easing: z.ZodOptional<z.ZodString>;
@@ -403,11 +403,11 @@ export type AnimationOverlay = z.infer<typeof animationOverlaySchema>;
 export declare const intraFrameAnimationSchema: z.ZodObject<{
     animId: z.ZodString;
     property: z.ZodEnum<{
-        width: "width";
-        height: "height";
         opacity: "opacity";
         transform: "transform";
         clipPath: "clipPath";
+        width: "width";
+        height: "height";
         scale: "scale";
         translateX: "translateX";
         translateY: "translateY";
@@ -427,11 +427,11 @@ export declare const intraFrameAnimationSchema: z.ZodObject<{
     alternate: z.ZodOptional<z.ZodBoolean>;
     fuse: z.ZodOptional<z.ZodArray<z.ZodObject<{
         property: z.ZodEnum<{
-            width: "width";
-            height: "height";
             opacity: "opacity";
             transform: "transform";
             clipPath: "clipPath";
+            width: "width";
+            height: "height";
             scale: "scale";
             translateX: "translateX";
             translateY: "translateY";

package/dist/animation/transition-schema.d.ts

@@ -104,8 +104,8 @@ export declare const transitionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     easing: z.ZodOptional<z.ZodString>;
     push: z.ZodUnion<readonly [z.ZodObject<{
         direction: z.ZodDefault<z.ZodEnum<{
-            left: "left";
             right: "right";
+            left: "left";
             up: "up";
             down: "down";
         }>>;
@@ -264,8 +264,8 @@ export declare const storyboardTransitionSchema: z.ZodUnion<(z.ZodObject<{
     easing: z.ZodOptional<z.ZodString>;
     push: z.ZodUnion<readonly [z.ZodObject<{
         direction: z.ZodDefault<z.ZodEnum<{
-            left: "left";
             right: "right";
+            left: "left";
             up: "up";
             down: "down";
         }>>;

package/dist/capture/paged-capture-bundle-json-schema.d.ts

@@ -0,0 +1,4 @@
+/** Generate the published JSON Schema for the paged-capture bundle manifest. */
+export declare const PAGED_CAPTURE_BUNDLE_SCHEMA_ID = "https://raw.githubusercontent.com/brianwestphal/domotion/main/schemas/paged-capture-bundle.schema.json";
+export declare function buildPagedCaptureBundleJsonSchema(): Record<string, unknown>;
+export declare function pagedCaptureBundleJsonSchemaText(): string;

package/dist/capture/paged-capture-bundle-json-schema.js

@@ -0,0 +1,21 @@
+/** Generate the published JSON Schema for the paged-capture bundle manifest. */
+import { z } from "zod";
+import { pagedCaptureBundleManifestSchema } from "./paged-capture-bundle.js";
+export const PAGED_CAPTURE_BUNDLE_SCHEMA_ID = "https://raw.githubusercontent.com/brianwestphal/domotion/main/schemas/paged-capture-bundle.schema.json";
+export function buildPagedCaptureBundleJsonSchema() {
+    const schema = z.toJSONSchema(pagedCaptureBundleManifestSchema, {
+        target: "draft-2020-12",
+        io: "input",
+    });
+    return {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        $id: PAGED_CAPTURE_BUNDLE_SCHEMA_ID,
+        title: "Domotion paged-capture bundle manifest",
+        description: "Versioned authenticated/unavailable manifest for an opt-in paged-media capture bundle. " +
+            "Runtime validation additionally enforces consecutive pages, deterministic relative SVG paths, and content digests.",
+        ...schema,
+    };
+}
+export function pagedCaptureBundleJsonSchemaText() {
+    return `${JSON.stringify(buildPagedCaptureBundleJsonSchema(), null, 2)}\n`;
+}

package/dist/capture/paged-capture-bundle.d.ts

@@ -0,0 +1,295 @@
+/**
+ * Versioned manifest contract for opt-in paged-media capture bundles.
+ *
+ * Chromium 7d859f271c exposes only PDF bytes/a stream through public
+ * Page.printToPDF. Authenticated manifests therefore require the separately
+ * supplied Blink-private PrintBegin-to-PrintEnd transport; PDF/vector/raster
+ * output is never accepted as logical page evidence. See docs/255.
+ */
+import { z } from "zod";
+export declare const PAGED_CAPTURE_BUNDLE_SCHEMA_VERSION: 1;
+export declare const PAGED_CAPTURE_BUNDLE_ABI: "domotion-paged-capture-bundle-v1";
+export declare const PAGED_CAPTURE_HELPER_ABI: "domotion-paged-capture-combined-v2";
+export declare const PAGED_CAPTURE_SKIA_REVISION: "62efacd37737505732dbe3d8daa62abd679626a1";
+export declare const PAGED_CAPTURE_HELPER_PATCH_SHA256: "a94cda690cb1b0b5d78438ed195b8f4b1df161054b9e8172e6fa26500b87bcba";
+export declare const PAGED_CAPTURE_HELPER_SKIA_PATCH_SHA256: "c4a8ab1e0c6832a7bbde849e54d26cf9c396adbedec60a7bfba5bb24209b6792";
+declare const authenticatedManifestSchema: z.ZodObject<{
+    status: z.ZodLiteral<"authenticated">;
+    helper: z.ZodObject<{
+        bundleManifestSha256: z.ZodString;
+        executableSha256: z.ZodString;
+        runtimeDependenciesSha256: z.ZodString;
+        browserProcessId: z.ZodNumber;
+        rendererProcessId: z.ZodNumber;
+        browserVersion: z.ZodString;
+        protocolVersion: z.ZodString;
+    }, z.core.$strict>;
+    printEpoch: z.ZodObject<{
+        epochId: z.ZodString;
+        frameId: z.ZodString;
+        documentLoaderId: z.ZodString;
+        printParametersSha256: z.ZodString;
+        lifecycle: z.ZodLiteral<"PrintBegin-to-PrintEnd">;
+        logicalTransport: z.ZodLiteral<"blink-private-paged-capture-physical-fragment-tree-v1">;
+        logicalFactsDerivedFromPdfVectorOrRaster: z.ZodLiteral<false>;
+        sourceRestoredExactly: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+    pages: z.ZodArray<z.ZodObject<{
+        selectionIndex: z.ZodNumber;
+        pageIndex: z.ZodNumber;
+        pageNumber: z.ZodNumber;
+        pageName: z.ZodNullable<z.ZodString>;
+        emptyKind: z.ZodEnum<{
+            none: "none";
+            "forced-blank": "forced-blank";
+            "terminal-empty": "terminal-empty";
+        }>;
+        media: z.ZodLiteral<"print">;
+        widthCssPx: z.ZodNumber;
+        heightCssPx: z.ZodNumber;
+        pageRecordSha256: z.ZodString;
+        collapsedBorderConsistencySha256: z.ZodString;
+        svg: z.ZodObject<{
+            path: z.ZodString;
+            byteLength: z.ZodNumber;
+            sha256: z.ZodString;
+            selfContained: z.ZodLiteral<true>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    bundleSha256: z.ZodString;
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    abi: z.ZodLiteral<"domotion-paged-capture-bundle-v1">;
+    bundleStem: z.ZodString;
+    source: z.ZodObject<{
+        url: z.ZodString;
+        root: z.ZodObject<{
+            selector: z.ZodString;
+            identitySha256: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    request: z.ZodObject<{
+        paper: z.ZodObject<{
+            widthInches: z.ZodNumber;
+            heightInches: z.ZodNumber;
+            landscape: z.ZodBoolean;
+        }, z.core.$strict>;
+        marginInches: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strict>;
+        pageRanges: z.ZodString;
+        scale: z.ZodNumber;
+        displayHeaderFooter: z.ZodLiteral<false>;
+        printBackground: z.ZodBoolean;
+        preferCSSPageSize: z.ZodBoolean;
+    }, z.core.$strict>;
+    sourcePins: z.ZodObject<{
+        chromiumRevision: z.ZodLiteral<"7d859f271cbda744098ac69f44978d4edfa62be3">;
+        skiaRevision: z.ZodLiteral<"62efacd37737505732dbe3d8daa62abd679626a1">;
+        helperAbi: z.ZodLiteral<"domotion-paged-capture-combined-v2">;
+        helperPatchSha256: z.ZodLiteral<"a94cda690cb1b0b5d78438ed195b8f4b1df161054b9e8172e6fa26500b87bcba">;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const unavailableManifestSchema: z.ZodObject<{
+    status: z.ZodLiteral<"unavailable">;
+    reasonCode: z.ZodEnum<{
+        "stock-chromium": "stock-chromium";
+        "helper-mismatch": "helper-mismatch";
+        "sidecar-invalid": "sidecar-invalid";
+        "page-records-unavailable": "page-records-unavailable";
+        "source-restoration-failed": "source-restoration-failed";
+        "unsupported-paint": "unsupported-paint";
+    }>;
+    detail: z.ZodString;
+    missingCapabilities: z.ZodArray<z.ZodString>;
+    observedRuntime: z.ZodOptional<z.ZodObject<{
+        product: z.ZodString;
+        revision: z.ZodString;
+        protocolVersion: z.ZodString;
+        helperAbi: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    abi: z.ZodLiteral<"domotion-paged-capture-bundle-v1">;
+    bundleStem: z.ZodString;
+    source: z.ZodObject<{
+        url: z.ZodString;
+        root: z.ZodObject<{
+            selector: z.ZodString;
+            identitySha256: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    request: z.ZodObject<{
+        paper: z.ZodObject<{
+            widthInches: z.ZodNumber;
+            heightInches: z.ZodNumber;
+            landscape: z.ZodBoolean;
+        }, z.core.$strict>;
+        marginInches: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strict>;
+        pageRanges: z.ZodString;
+        scale: z.ZodNumber;
+        displayHeaderFooter: z.ZodLiteral<false>;
+        printBackground: z.ZodBoolean;
+        preferCSSPageSize: z.ZodBoolean;
+    }, z.core.$strict>;
+    sourcePins: z.ZodObject<{
+        chromiumRevision: z.ZodLiteral<"7d859f271cbda744098ac69f44978d4edfa62be3">;
+        skiaRevision: z.ZodLiteral<"62efacd37737505732dbe3d8daa62abd679626a1">;
+        helperAbi: z.ZodLiteral<"domotion-paged-capture-combined-v2">;
+        helperPatchSha256: z.ZodLiteral<"a94cda690cb1b0b5d78438ed195b8f4b1df161054b9e8172e6fa26500b87bcba">;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare function pagedCaptureBundleDigest(manifest: Omit<AuthenticatedPagedCaptureBundleManifest, "bundleSha256">): string;
+export declare const pagedCaptureBundleManifestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"authenticated">;
+    helper: z.ZodObject<{
+        bundleManifestSha256: z.ZodString;
+        executableSha256: z.ZodString;
+        runtimeDependenciesSha256: z.ZodString;
+        browserProcessId: z.ZodNumber;
+        rendererProcessId: z.ZodNumber;
+        browserVersion: z.ZodString;
+        protocolVersion: z.ZodString;
+    }, z.core.$strict>;
+    printEpoch: z.ZodObject<{
+        epochId: z.ZodString;
+        frameId: z.ZodString;
+        documentLoaderId: z.ZodString;
+        printParametersSha256: z.ZodString;
+        lifecycle: z.ZodLiteral<"PrintBegin-to-PrintEnd">;
+        logicalTransport: z.ZodLiteral<"blink-private-paged-capture-physical-fragment-tree-v1">;
+        logicalFactsDerivedFromPdfVectorOrRaster: z.ZodLiteral<false>;
+        sourceRestoredExactly: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+    pages: z.ZodArray<z.ZodObject<{
+        selectionIndex: z.ZodNumber;
+        pageIndex: z.ZodNumber;
+        pageNumber: z.ZodNumber;
+        pageName: z.ZodNullable<z.ZodString>;
+        emptyKind: z.ZodEnum<{
+            none: "none";
+            "forced-blank": "forced-blank";
+            "terminal-empty": "terminal-empty";
+        }>;
+        media: z.ZodLiteral<"print">;
+        widthCssPx: z.ZodNumber;
+        heightCssPx: z.ZodNumber;
+        pageRecordSha256: z.ZodString;
+        collapsedBorderConsistencySha256: z.ZodString;
+        svg: z.ZodObject<{
+            path: z.ZodString;
+            byteLength: z.ZodNumber;
+            sha256: z.ZodString;
+            selfContained: z.ZodLiteral<true>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    bundleSha256: z.ZodString;
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    abi: z.ZodLiteral<"domotion-paged-capture-bundle-v1">;
+    bundleStem: z.ZodString;
+    source: z.ZodObject<{
+        url: z.ZodString;
+        root: z.ZodObject<{
+            selector: z.ZodString;
+            identitySha256: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    request: z.ZodObject<{
+        paper: z.ZodObject<{
+            widthInches: z.ZodNumber;
+            heightInches: z.ZodNumber;
+            landscape: z.ZodBoolean;
+        }, z.core.$strict>;
+        marginInches: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strict>;
+        pageRanges: z.ZodString;
+        scale: z.ZodNumber;
+        displayHeaderFooter: z.ZodLiteral<false>;
+        printBackground: z.ZodBoolean;
+        preferCSSPageSize: z.ZodBoolean;
+    }, z.core.$strict>;
+    sourcePins: z.ZodObject<{
+        chromiumRevision: z.ZodLiteral<"7d859f271cbda744098ac69f44978d4edfa62be3">;
+        skiaRevision: z.ZodLiteral<"62efacd37737505732dbe3d8daa62abd679626a1">;
+        helperAbi: z.ZodLiteral<"domotion-paged-capture-combined-v2">;
+        helperPatchSha256: z.ZodLiteral<"a94cda690cb1b0b5d78438ed195b8f4b1df161054b9e8172e6fa26500b87bcba">;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"unavailable">;
+    reasonCode: z.ZodEnum<{
+        "stock-chromium": "stock-chromium";
+        "helper-mismatch": "helper-mismatch";
+        "sidecar-invalid": "sidecar-invalid";
+        "page-records-unavailable": "page-records-unavailable";
+        "source-restoration-failed": "source-restoration-failed";
+        "unsupported-paint": "unsupported-paint";
+    }>;
+    detail: z.ZodString;
+    missingCapabilities: z.ZodArray<z.ZodString>;
+    observedRuntime: z.ZodOptional<z.ZodObject<{
+        product: z.ZodString;
+        revision: z.ZodString;
+        protocolVersion: z.ZodString;
+        helperAbi: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    abi: z.ZodLiteral<"domotion-paged-capture-bundle-v1">;
+    bundleStem: z.ZodString;
+    source: z.ZodObject<{
+        url: z.ZodString;
+        root: z.ZodObject<{
+            selector: z.ZodString;
+            identitySha256: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    request: z.ZodObject<{
+        paper: z.ZodObject<{
+            widthInches: z.ZodNumber;
+            heightInches: z.ZodNumber;
+            landscape: z.ZodBoolean;
+        }, z.core.$strict>;
+        marginInches: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strict>;
+        pageRanges: z.ZodString;
+        scale: z.ZodNumber;
+        displayHeaderFooter: z.ZodLiteral<false>;
+        printBackground: z.ZodBoolean;
+        preferCSSPageSize: z.ZodBoolean;
+    }, z.core.$strict>;
+    sourcePins: z.ZodObject<{
+        chromiumRevision: z.ZodLiteral<"7d859f271cbda744098ac69f44978d4edfa62be3">;
+        skiaRevision: z.ZodLiteral<"62efacd37737505732dbe3d8daa62abd679626a1">;
+        helperAbi: z.ZodLiteral<"domotion-paged-capture-combined-v2">;
+        helperPatchSha256: z.ZodLiteral<"a94cda690cb1b0b5d78438ed195b8f4b1df161054b9e8172e6fa26500b87bcba">;
+    }, z.core.$strict>;
+}, z.core.$strict>], "status">;
+export type PagedCaptureBundleManifest = z.infer<typeof pagedCaptureBundleManifestSchema>;
+export type AuthenticatedPagedCaptureBundleManifest = z.infer<typeof authenticatedManifestSchema>;
+export type UnavailablePagedCaptureBundleManifest = z.infer<typeof unavailableManifestSchema>;
+export type AuthenticatedPagedCaptureBundleInput = Omit<AuthenticatedPagedCaptureBundleManifest, "bundleSha256">;
+export declare function buildAuthenticatedPagedCaptureBundleManifest(input: AuthenticatedPagedCaptureBundleInput): AuthenticatedPagedCaptureBundleManifest;
+export declare function parsePagedCaptureBundleManifest(input: unknown): PagedCaptureBundleManifest;
+export interface PagedCaptureBundleAssetReader {
+    (relativePath: string): Uint8Array | string | null | undefined | Promise<Uint8Array | string | null | undefined>;
+}
+/** Verify that every declared SVG exists, re-hashes, and is self-contained. */
+export declare function verifyPagedCaptureBundleAssets(input: unknown, readAsset: PagedCaptureBundleAssetReader): Promise<string[]>;
+export {};