hoomanjs 1.47.0 → 1.55.0

package/dist/core/utils/export-figma.js

@@ -0,0 +1,189 @@
+/**
+ * Screenshot-backed Figma Design (.fig) and Slides (.deck) writers.
+ * Same idea as PPTX: one full-bleed image per frame / slide.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createEmptyFigDoc, parseFig, } from "openfig-core";
+import { createPlaceholderThumbnail, encodeFigArchive, FIG_BASE, figImagePaint, IDENTITY, maxLocalId, rebuildFigMaps, siblingPosition, } from "./fig-archive.js";
+const FIGMA_SLIDES_WIDTH = 1920;
+const FIGMA_SLIDES_HEIGHT = 1080;
+const FRAME_GAP = 80;
+function seedDeckPath() {
+    return join(dirname(fileURLToPath(import.meta.url)), "seeds", "empty-slides.deck");
+}
+function ensureMessageEnvelope(doc) {
+    const msg = doc.message;
+    msg.sessionID = msg.sessionID ?? 0;
+    msg.ackID = msg.ackID ?? 0;
+    msg.blobs = msg.blobs ?? [];
+}
+async function loadEmptyDeckDoc(title) {
+    const path = seedDeckPath();
+    if (!existsSync(path)) {
+        throw new Error(`Missing Figma Slides seed at ${path}. Rebuild with copy-bundled-assets.`);
+    }
+    const doc = await parseFig(readFileSync(path));
+    doc.header = { ...doc.header, prelude: "fig-deck" };
+    ensureMessageEnvelope(doc);
+    doc.meta = {
+        ...(doc.meta ?? {}),
+        file_name: title,
+    };
+    doc.thumbnail = createPlaceholderThumbnail();
+    if (!doc.images) {
+        doc.images = new Map();
+    }
+    rebuildFigMaps(doc);
+    return doc;
+}
+/**
+ * Screenshot pages → simple Design `.fig` (one frame per page, image fill).
+ */
+export async function buildScreenshotFig(images, opts = {}) {
+    if (images.length === 0) {
+        throw new Error("no pages to export");
+    }
+    const title = opts.title ?? "Untitled";
+    const doc = createEmptyFigDoc();
+    ensureMessageEnvelope(doc);
+    doc.meta = { file_name: title, version: 0 };
+    doc.thumbnail = createPlaceholderThumbnail();
+    doc.images = new Map();
+    const pageGuid = { sessionID: 0, localID: 1 };
+    let nextLocal = maxLocalId(doc) + 1;
+    let offsetX = 0;
+    for (let i = 0; i < images.length; i++) {
+        const img = images[i];
+        const paint = figImagePaint(doc, new Uint8Array(img.buffer), img.width, img.height);
+        doc.message.nodeChanges.push({
+            ...FIG_BASE,
+            guid: { sessionID: 1, localID: nextLocal++ },
+            type: "FRAME",
+            name: images.length === 1 ? title : `Page ${i + 1}`,
+            parentIndex: { guid: pageGuid, position: siblingPosition(i) },
+            size: { x: img.width, y: img.height },
+            transform: { ...IDENTITY, m02: offsetX, m12: 0 },
+            fillPaints: [paint],
+            frameMaskDisabled: false,
+            proportionsConstrained: true,
+        });
+        offsetX += img.width + FRAME_GAP;
+    }
+    rebuildFigMaps(doc);
+    const bytes = await encodeFigArchive(doc, {
+        prelude: "fig-kiwi",
+        fileName: title,
+        thumbnail: doc.thumbnail,
+    });
+    return Buffer.from(bytes);
+}
+/**
+ * Screenshot pages → simple Slides `.deck` (one slide per page, full-bleed image).
+ */
+export async function buildScreenshotDeck(images, opts = {}) {
+    if (images.length === 0) {
+        throw new Error("no slides to export");
+    }
+    const title = opts.title ?? "Untitled";
+    const doc = await loadEmptyDeckDoc(title);
+    const slideW = FIGMA_SLIDES_WIDTH;
+    const slideH = FIGMA_SLIDES_HEIGHT;
+    const gridPadding = 240;
+    const rowGap = slideW + 240;
+    let nodes = doc.message.nodeChanges;
+    const row = nodes.find((n) => n.type === "SLIDE_ROW");
+    if (!row) {
+        throw new Error("buildScreenshotDeck: seed missing SLIDE_ROW");
+    }
+    const rowGuid = { ...row.guid };
+    const placeholder = nodes.find((n) => n.type === "SLIDE");
+    const themeID = placeholder?.themeID;
+    const sourceLibraryKey = placeholder?.sourceLibraryKey;
+    const placeholderKey = placeholder
+        ? `${placeholder.guid.sessionID}:${placeholder.guid.localID}`
+        : null;
+    if (placeholderKey) {
+        const [ps, pl] = placeholderKey.split(":").map(Number);
+        nodes = nodes.filter((n) => !(n.guid.sessionID === ps && n.guid.localID === pl) &&
+            !(n.parentIndex?.guid?.sessionID === ps &&
+                n.parentIndex?.guid?.localID === pl));
+        doc.message.nodeChanges = nodes;
+    }
+    const slideCount = images.length;
+    const gridW = slideCount * slideW + (slideCount - 1) * 240 + gridPadding * 2;
+    const gridH = slideH + gridPadding * 2;
+    const grid = nodes.find((n) => n.type === "SLIDE_GRID");
+    if (grid) {
+        grid.size = { x: gridW, y: gridH };
+    }
+    row.size = {
+        x: slideCount * slideW + (slideCount - 1) * 240,
+        y: slideH,
+    };
+    if (doc.meta && typeof doc.meta === "object") {
+        const meta = doc.meta;
+        const clientMeta = meta.client_meta;
+        if (clientMeta?.render_coordinates) {
+            clientMeta.render_coordinates = {
+                x: 0,
+                y: 0,
+                width: gridW,
+                height: gridH,
+            };
+        }
+        meta.file_name = title;
+    }
+    let nextLocal = maxLocalId(doc) + 1;
+    for (let i = 0; i < images.length; i++) {
+        const img = images[i];
+        const slideGuid = { sessionID: 1, localID: nextLocal++ };
+        const imageGuid = { sessionID: 1, localID: nextLocal++ };
+        const paint = figImagePaint(doc, new Uint8Array(img.buffer), img.width, img.height);
+        nodes.push({
+            ...FIG_BASE,
+            guid: slideGuid,
+            type: "SLIDE",
+            name: String(i + 1),
+            parentIndex: { guid: rowGuid, position: siblingPosition(i) },
+            size: { x: slideW, y: slideH },
+            transform: { ...IDENTITY, m02: i * rowGap },
+            strokeWeight: 1,
+            strokeAlign: "INSIDE",
+            strokeJoin: "MITER",
+            fillPaints: [
+                {
+                    type: "SOLID",
+                    color: { r: 1, g: 1, b: 1, a: 1 },
+                    opacity: 1,
+                    visible: true,
+                    blendMode: "NORMAL",
+                },
+            ],
+            frameMaskDisabled: false,
+            themeID,
+            sourceLibraryKey,
+        });
+        nodes.push({
+            ...FIG_BASE,
+            guid: imageGuid,
+            type: "ROUNDED_RECTANGLE",
+            name: "Screenshot",
+            parentIndex: { guid: slideGuid, position: "!" },
+            size: { x: slideW, y: slideH },
+            transform: { ...IDENTITY },
+            proportionsConstrained: true,
+            fillPaints: [{ ...paint, imageScaleMode: "FILL" }],
+        });
+    }
+    rebuildFigMaps(doc);
+    const bytes = await encodeFigArchive(doc, {
+        prelude: "fig-deck",
+        fileName: title,
+        thumbnail: doc.thumbnail ?? createPlaceholderThumbnail(),
+        includeImagesDir: true,
+    });
+    return Buffer.from(bytes);
+}
+//# sourceMappingURL=export-figma.js.map

package/dist/core/utils/export-figma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-figma.js","sourceRoot":"","sources":["../../../src/core/utils/export-figma.ts"],"names":[],"mappings":"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"}

package/dist/core/utils/export-sketch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Screenshot-backed Sketch (.sketch) writer.
+ * Same idea as PPTX: one full-bleed artboard per page with a pattern image fill.
+ */
+import type { RenderedPage } from "./export-design.js";
+/**
+ * Screenshot pages → simple `.sketch` (one artboard per page, image pattern fill).
+ */
+export declare function buildScreenshotSketch(images: RenderedPage[], opts?: {
+    title?: string;
+}): Buffer;

package/dist/core/utils/export-sketch.js

@@ -0,0 +1,456 @@
+/**
+ * Screenshot-backed Sketch (.sketch) writer.
+ * Same idea as PPTX: one full-bleed artboard per page with a pattern image fill.
+ */
+import { createHash, randomUUID } from "node:crypto";
+import { zipSync } from "fflate";
+import * as FileFormat from "@sketch-hq/sketch-file-format-ts/dist/esm/types.js";
+import { deflateSync } from "node:zlib";
+function sketchId() {
+    return randomUUID().toUpperCase();
+}
+function createPlaceholderPng(width = 400, height = 260, rgb = [0xf5, 0xf7, 0xfa]) {
+    const row = Buffer.alloc(1 + width * 3);
+    row[0] = 0;
+    for (let x = 0; x < width; x++) {
+        const o = 1 + x * 3;
+        row[o] = rgb[0];
+        row[o + 1] = rgb[1];
+        row[o + 2] = rgb[2];
+    }
+    const raw = Buffer.alloc(height * row.length);
+    for (let i = 0; i < height; i++) {
+        row.copy(raw, i * row.length);
+    }
+    const idat = deflateSync(raw);
+    const crcTable = new Uint32Array(256);
+    for (let n = 0; n < 256; n++) {
+        let c = n;
+        for (let k = 0; k < 8; k++) {
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        }
+        crcTable[n] = c >>> 0;
+    }
+    const crc32 = (buf) => {
+        let c = 0xffffffff;
+        for (const b of buf) {
+            c = (crcTable[(c ^ b) & 0xff] ^ (c >>> 8)) >>> 0;
+        }
+        return (c ^ 0xffffffff) >>> 0;
+    };
+    const chunk = (type, data) => {
+        const len = Buffer.alloc(4);
+        len.writeUInt32BE(data.length, 0);
+        const t = Buffer.from(type, "ascii");
+        const crc = Buffer.alloc(4);
+        crc.writeUInt32BE(crc32(Buffer.concat([t, data])), 0);
+        return Buffer.concat([len, t, data, crc]);
+    };
+    const sig = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+    const ihdr = Buffer.alloc(13);
+    ihdr.writeUInt32BE(width, 0);
+    ihdr.writeUInt32BE(height, 4);
+    ihdr[8] = 8;
+    ihdr[9] = 2;
+    return new Uint8Array(Buffer.concat([
+        sig,
+        chunk("IHDR", ihdr),
+        chunk("IDAT", idat),
+        chunk("IEND", Buffer.alloc(0)),
+    ]));
+}
+const DEFAULT_EXPORT_OPTIONS = {
+    _class: "exportOptions",
+    includedLayerIds: [],
+    layerOptions: 0,
+    shouldTrim: false,
+    exportFormats: [],
+};
+const DEFAULT_RULER = {
+    _class: "rulerData",
+    base: 0,
+    guides: [],
+};
+function emptyStyle(opacity = 1) {
+    return {
+        _class: "style",
+        do_objectID: sketchId(),
+        endMarkerType: FileFormat.MarkerType.OpenArrow,
+        miterLimit: 10,
+        startMarkerType: FileFormat.MarkerType.OpenArrow,
+        windingRule: FileFormat.WindingRule.EvenOdd,
+        blur: {
+            _class: "blur",
+            isEnabled: false,
+            center: "{0.5, 0.5}",
+            motionAngle: 0,
+            radius: 10,
+            saturation: 1,
+            type: FileFormat.BlurType.Gaussian,
+        },
+        borderOptions: {
+            _class: "borderOptions",
+            isEnabled: true,
+            dashPattern: [],
+            lineCapStyle: FileFormat.LineCapStyle.Butt,
+            lineJoinStyle: FileFormat.LineJoinStyle.Miter,
+        },
+        borders: [],
+        colorControls: {
+            _class: "colorControls",
+            isEnabled: false,
+            brightness: 0,
+            contrast: 1,
+            hue: 0,
+            saturation: 1,
+        },
+        contextSettings: {
+            _class: "graphicsContextSettings",
+            blendMode: FileFormat.BlendMode.Normal,
+            opacity,
+        },
+        fills: [],
+        innerShadows: [],
+        shadows: [],
+    };
+}
+function emptyGradient() {
+    return {
+        _class: "gradient",
+        elipseLength: 0,
+        from: "{0.5, 0}",
+        gradientType: FileFormat.GradientType.Linear,
+        to: "{0.5, 1}",
+        stops: [
+            {
+                _class: "gradientStop",
+                position: 0,
+                color: {
+                    _class: "color",
+                    red: 0,
+                    green: 0,
+                    blue: 0,
+                    alpha: 1,
+                },
+            },
+            {
+                _class: "gradientStop",
+                position: 1,
+                color: {
+                    _class: "color",
+                    red: 0,
+                    green: 0,
+                    blue: 0,
+                    alpha: 1,
+                },
+            },
+        ],
+    };
+}
+function cornerPoints(_w, _h) {
+    return [
+        {
+            _class: "curvePoint",
+            cornerRadius: 0,
+            cornerStyle: FileFormat.CornerStyle.Rounded,
+            curveFrom: "{0, 0}",
+            curveTo: "{0, 0}",
+            hasCurveFrom: false,
+            hasCurveTo: false,
+            point: "{0, 0}",
+        },
+        {
+            _class: "curvePoint",
+            cornerRadius: 0,
+            cornerStyle: FileFormat.CornerStyle.Rounded,
+            curveFrom: "{1, 0}",
+            curveTo: "{1, 0}",
+            hasCurveFrom: false,
+            hasCurveTo: false,
+            point: "{1, 0}",
+        },
+        {
+            _class: "curvePoint",
+            cornerRadius: 0,
+            cornerStyle: FileFormat.CornerStyle.Rounded,
+            curveFrom: "{1, 1}",
+            curveTo: "{1, 1}",
+            hasCurveFrom: false,
+            hasCurveTo: false,
+            point: "{1, 1}",
+        },
+        {
+            _class: "curvePoint",
+            cornerRadius: 0,
+            cornerStyle: FileFormat.CornerStyle.Rounded,
+            curveFrom: "{0, 1}",
+            curveTo: "{0, 1}",
+            hasCurveFrom: false,
+            hasCurveTo: false,
+            point: "{0, 1}",
+        },
+    ];
+}
+/**
+ * Screenshot pages → simple `.sketch` (one artboard per page, image pattern fill).
+ */
+export function buildScreenshotSketch(images, opts = {}) {
+    if (images.length === 0) {
+        throw new Error("no pages to export");
+    }
+    const title = opts.title ?? "Untitled";
+    const pageId = sketchId();
+    const documentId = sketchId();
+    const imagesMap = new Map();
+    const artboards = [];
+    const artboardMeta = {};
+    let cursorX = 0;
+    const gap = 80;
+    for (let i = 0; i < images.length; i++) {
+        const img = images[i];
+        const bytes = new Uint8Array(img.buffer);
+        const sha1 = createHash("sha1").update(bytes).digest("hex");
+        imagesMap.set(sha1, bytes);
+        const imageRef = {
+            _class: "MSJSONFileReference",
+            _ref_class: "MSImageData",
+            _ref: `images/${sha1}`,
+        };
+        const fillStyle = emptyStyle(1);
+        fillStyle.fills = [
+            {
+                _class: "fill",
+                isEnabled: true,
+                fillType: FileFormat.FillType.Pattern,
+                color: {
+                    _class: "color",
+                    red: 0,
+                    green: 0,
+                    blue: 0,
+                    alpha: 1,
+                },
+                contextSettings: {
+                    _class: "graphicsContextSettings",
+                    blendMode: FileFormat.BlendMode.Normal,
+                    opacity: 1,
+                },
+                gradient: emptyGradient(),
+                image: imageRef,
+                noiseIndex: 0,
+                noiseIntensity: 0,
+                patternFillType: FileFormat.PatternFillType.Fill,
+                patternTileScale: 1,
+            },
+        ];
+        const rect = {
+            _class: "rectangle",
+            do_objectID: sketchId(),
+            booleanOperation: FileFormat.BooleanOperation.None,
+            isFixedToViewport: false,
+            isFlippedHorizontal: false,
+            isFlippedVertical: false,
+            isLocked: false,
+            isTemplate: false,
+            isVisible: true,
+            layerListExpandedType: FileFormat.LayerListExpanded.Undecided,
+            name: "Screenshot",
+            nameIsFixed: true,
+            resizingConstraint: 63,
+            resizingType: FileFormat.ResizeType.Stretch,
+            rotation: 0,
+            shouldBreakMaskChain: false,
+            exportOptions: { ...DEFAULT_EXPORT_OPTIONS },
+            frame: {
+                _class: "rect",
+                constrainProportions: false,
+                height: img.height,
+                width: img.width,
+                x: 0,
+                y: 0,
+            },
+            clippingMaskMode: 0,
+            hasClippingMask: false,
+            style: fillStyle,
+            edited: false,
+            isClosed: true,
+            pointRadiusBehaviour: FileFormat.PointsRadiusBehaviour.Rounded,
+            points: cornerPoints(img.width, img.height),
+            fixedRadius: 0,
+            needsConvertionToNewRoundCorners: false,
+            hasConvertedToNewRoundCorners: true,
+        };
+        const artboardId = sketchId();
+        const name = images.length === 1 ? title : `Page ${i + 1}`;
+        artboards.push({
+            _class: "artboard",
+            do_objectID: artboardId,
+            booleanOperation: FileFormat.BooleanOperation.None,
+            isFixedToViewport: false,
+            isFlippedHorizontal: false,
+            isFlippedVertical: false,
+            isLocked: false,
+            isTemplate: false,
+            isVisible: true,
+            layerListExpandedType: FileFormat.LayerListExpanded.Expanded,
+            name,
+            nameIsFixed: true,
+            resizingConstraint: 63,
+            resizingType: FileFormat.ResizeType.Stretch,
+            rotation: 0,
+            shouldBreakMaskChain: false,
+            exportOptions: { ...DEFAULT_EXPORT_OPTIONS },
+            frame: {
+                _class: "rect",
+                constrainProportions: false,
+                height: img.height,
+                width: img.width,
+                x: cursorX,
+                y: 0,
+            },
+            clippingMaskMode: 0,
+            hasClippingMask: false,
+            style: emptyStyle(1),
+            hasClickThrough: true,
+            groupLayout: { _class: "MSImmutableFreeformGroupLayout" },
+            layers: [rect],
+            horizontalRulerData: { ...DEFAULT_RULER },
+            verticalRulerData: { ...DEFAULT_RULER },
+            isFlowHome: false,
+            resizesContent: false,
+            backgroundColor: {
+                _class: "color",
+                red: 1,
+                green: 1,
+                blue: 1,
+                alpha: 1,
+            },
+            hasBackgroundColor: false,
+            includeBackgroundColorInExport: false,
+            includeBackgroundColorInInstance: false,
+        });
+        artboardMeta[artboardId] = { name };
+        cursorX += img.width + gap;
+    }
+    const page = {
+        _class: "page",
+        do_objectID: pageId,
+        booleanOperation: FileFormat.BooleanOperation.None,
+        isFixedToViewport: false,
+        isFlippedHorizontal: false,
+        isFlippedVertical: false,
+        isLocked: false,
+        isTemplate: false,
+        isVisible: true,
+        layerListExpandedType: FileFormat.LayerListExpanded.Undecided,
+        name: "Page 1",
+        nameIsFixed: false,
+        resizingConstraint: 63,
+        resizingType: FileFormat.ResizeType.Stretch,
+        rotation: 0,
+        shouldBreakMaskChain: false,
+        exportOptions: { ...DEFAULT_EXPORT_OPTIONS },
+        frame: {
+            _class: "rect",
+            constrainProportions: false,
+            height: 0,
+            width: 0,
+            x: 0,
+            y: 0,
+        },
+        clippingMaskMode: 0,
+        hasClippingMask: false,
+        style: emptyStyle(),
+        hasClickThrough: true,
+        groupLayout: { _class: "MSImmutableFreeformGroupLayout" },
+        layers: artboards,
+        horizontalRulerData: { ...DEFAULT_RULER },
+        verticalRulerData: { ...DEFAULT_RULER },
+    };
+    const document = {
+        _class: "document",
+        do_objectID: documentId,
+        colorSpace: FileFormat.ColorSpace.Unmanaged,
+        currentPageIndex: 0,
+        assets: {
+            _class: "assetCollection",
+            do_objectID: sketchId(),
+            images: [],
+            colorAssets: [],
+            exportPresets: [],
+            gradientAssets: [],
+            colors: [],
+            gradients: [],
+        },
+        foreignLayerStyles: [],
+        foreignSymbols: [],
+        foreignTextStyles: [],
+        foreignSwatches: [],
+        layerStyles: { _class: "sharedStyleContainer", objects: [] },
+        layerSymbols: { _class: "symbolContainer", objects: [] },
+        layerTextStyles: {
+            _class: "sharedTextStyleContainer",
+            objects: [],
+        },
+        sharedSwatches: { _class: "swatchContainer", objects: [] },
+        perDocumentLibraries: [],
+        pages: [
+            {
+                _class: "MSJSONFileReference",
+                _ref_class: "MSImmutablePage",
+                _ref: `pages/${pageId}`,
+            },
+        ],
+    };
+    const meta = {
+        commit: "0000000000000000000000000000000000000000",
+        pagesAndArtboards: {
+            [pageId]: {
+                name: "Page 1",
+                artboards: artboardMeta,
+            },
+        },
+        version: 134,
+        fonts: [],
+        compatibilityVersion: 99,
+        app: FileFormat.BundleId.PublicRelease,
+        autosaved: 0,
+        variant: "NONAPPSTORE",
+        created: {
+            commit: "0000000000000000000000000000000000000000",
+            appVersion: "99",
+            build: 0,
+            app: FileFormat.BundleId.PublicRelease,
+            compatibilityVersion: 99,
+            version: 134,
+            variant: "NONAPPSTORE",
+        },
+        saveHistory: ["NONAPPSTORE.0"],
+        appVersion: "99",
+        build: 0,
+    };
+    const user = {
+        document: {
+            pageListHeight: 85,
+            pageListCollapsed: 0,
+        },
+        [pageId]: {
+            scrollOrigin: "{0, 0}",
+            zoomValue: 1,
+        },
+    };
+    const enc = new TextEncoder();
+    const files = {
+        [`pages/${pageId}.json`]: enc.encode(JSON.stringify(page)),
+        "document.json": enc.encode(JSON.stringify(document)),
+        "meta.json": enc.encode(JSON.stringify(meta)),
+        "user.json": enc.encode(JSON.stringify(user)),
+        "previews/preview.png": images[0] != null
+            ? new Uint8Array(images[0].buffer)
+            : createPlaceholderPng(),
+    };
+    for (const [sha1, bytes] of imagesMap) {
+        files[`images/${sha1}`] = bytes;
+    }
+    return Buffer.from(zipSync(files, { level: 6 }));
+}
+//# sourceMappingURL=export-sketch.js.map