@penpair/core 0.2.0 → 0.3.1

package/dist/export.js

@@ -1,3 +1,4 @@
+import { withPageSession } from "./page-session.js";
 import { waitForStableLayout } from "./layout.js";
 import { PenpairError } from "./errors.js";
 import { commandSleep } from "./command-result.js";
@@ -19,34 +20,76 @@ const afterShape = penpot.currentPage.getShapeById(CFG.id);
 if (penpot.currentFile.id !== capture.fileId || penpot.currentPage.id !== capture.pageId || penpot.currentFile.revn !== capture.revision || !afterShape || afterShape.id !== capture.frameId || JSON.stringify([afterShape.x,afterShape.y,afterShape.width,afterShape.height]) !== geometry)
  return {ok:false, message:"Export source changed during capture"};
 let bin = ""; for (let i = 0; i < bytes.length; i += 8192) bin += String.fromCharCode.apply(null, bytes.subarray(i, i + 8192));
-return { ok: true, base64: btoa(bin), length: bytes.length, capture };`, { id: shapeId, scale, page }, "read");
+return { ok: true, base64: btoa(bin), length: bytes.length, capture };`, {
+    id: shapeId,
+    scale,
+    page,
+}, "read");
 const defaultSleep = commandSleep;
 /** Exports one shape as PNG. A first call can fail once and then work; this retries, and by default waits for a stable render. */
 export async function exportShapePng(client, shapeId, options = {}) {
-    const { page, scale = 1, attempts = 3, stable = true, maxExports = 4, sleep = defaultSleep } = options;
-    if (!Number.isFinite(scale) || scale <= 0 || scale > 8 || !Number.isInteger(attempts) || attempts < 1 || attempts > 10 || !Number.isInteger(maxExports) || maxExports < (stable ? 2 : 1) || maxExports > 20)
+    return withPageSession(client, () => exportInSession(client, shapeId, options));
+}
+async function exportInSession(client, shapeId, options) {
+    const { page, scale = 1, attempts = 3, stable = true, maxExports = 4, sleep = defaultSleep, } = options;
+    if (!Number.isFinite(scale) ||
+        scale <= 0 ||
+        scale > 8 ||
+        !Number.isInteger(attempts) ||
+        attempts < 1 ||
+        attempts > 10 ||
+        !Number.isInteger(maxExports) ||
+        maxExports < (stable ? 2 : 1) ||
+        maxExports > 20) {
         throw new Error("Invalid export scale/attempt limits");
+    }
     const once = async () => {
         for (let attempt = 1;; attempt++) {
             try {
                 const record = await runOnPage(client, exportSnippet(shapeId, scale, page), page, options);
                 const capture = record.capture;
-                if (!capture || typeof capture.fileId !== "string" || !capture.fileId || typeof capture.pageId !== "string" || !capture.pageId || capture.frameId !== shapeId || !Number.isInteger(capture.revision) || capture.scale !== scale || !Array.isArray(capture.activeThemes))
+                if (!capture ||
+                    typeof capture.fileId !== "string" ||
+                    !capture.fileId ||
+                    typeof capture.pageId !== "string" ||
+                    !capture.pageId ||
+                    capture.frameId !== shapeId ||
+                    !Number.isInteger(capture.revision) ||
+                    capture.scale !== scale ||
+                    !Array.isArray(capture.activeThemes)) {
                     throw new Error("Export did not return target provenance");
-                if (capture.designSize && (![capture.designSize.width, capture.designSize.height].every(value => Number.isFinite(value) && value >= 0)))
+                }
+                if (capture.designSize &&
+                    ![
+                        capture.designSize.width,
+                        capture.designSize.height,
+                    ].every((value) => Number.isFinite(value) && value >= 0)) {
                     throw new Error("Export has malformed design dimensions");
-                if (capture.activeThemeIds !== undefined && capture.activeThemeIds !== null && (!Array.isArray(capture.activeThemeIds) || capture.activeThemeIds.some(id => typeof id !== "string" || !id) || new Set(capture.activeThemeIds).size !== capture.activeThemeIds.length))
+                }
+                if (capture.activeThemeIds !== undefined &&
+                    capture.activeThemeIds !== null &&
+                    (!Array.isArray(capture.activeThemeIds) ||
+                        capture.activeThemeIds.some((id) => typeof id !== "string" || !id) ||
+                        new Set(capture.activeThemeIds).size !== capture.activeThemeIds.length)) {
                     throw new Error("Export has malformed active theme identity");
-                if (typeof record.base64 !== "string" || !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(record.base64))
+                }
+                if (typeof record.base64 !== "string" ||
+                    !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(record.base64)) {
                     throw new Error("Invalid export byte encoding");
+                }
                 const png = Buffer.from(record.base64, "base64");
-                if (!png.length || png.length !== record.length)
+                if (!png.length || png.length !== record.length) {
                     throw new Error("Export byte length does not match its evidence");
-                return { png, capture };
+                }
+                return {
+                    png,
+                    capture,
+                };
             }
             catch (error) {
-                if (attempt >= attempts)
+                if (attempt >= attempts) {
                     throw error;
+                }
                 await sleep(5_000);
             }
         }
@@ -54,22 +97,47 @@ export async function exportShapePng(client, shapeId, options = {}) {
     let previous = await once();
     let layout;
     if (options.layout !== false) {
-        layout = await waitForStableLayout(client, { shapeId, sleep, ...options.layout });
-        if (!layout.stable)
+        layout = await waitForStableLayout(client, {
+            shapeId,
+            sleep,
+            ...options.layout,
+        });
+        if (!layout.stable) {
             throw new PenpairError("incomplete-output", `Layout did not settle before export: ${layout.reason ?? "unknown reason"}`);
+        }
+    }
+    if (!stable) {
+        return {
+            layout,
+            ...previous,
+            stable: false,
+            exports: 1,
+        };
     }
-    if (!stable)
-        return { layout, ...previous, stable: false, exports: 1 };
     const hash = (buffer) => createHash("sha256").update(buffer).digest("hex");
     for (let count = 2; count <= maxExports; count++) {
         await sleep(2_000);
         const next = await once();
         const identity = ({ designSize: _size, ...value }) => value;
-        if (JSON.stringify(identity(next.capture)) !== JSON.stringify(identity(previous.capture)))
+        if (JSON.stringify(identity(next.capture)) !== JSON.stringify(identity(previous.capture))) {
             throw new Error("Export identity, revision or render environment changed between captures");
-        if (JSON.stringify(next.capture.designSize ?? null) === JSON.stringify(previous.capture.designSize ?? null) && hash(next.png) === hash(previous.png))
-            return { layout, ...next, stable: true, exports: count };
+        }
+        if (JSON.stringify(next.capture.designSize ?? null) ===
+            JSON.stringify(previous.capture.designSize ?? null) &&
+            hash(next.png) === hash(previous.png)) {
+            return {
+                layout,
+                ...next,
+                stable: true,
+                exports: count,
+            };
+        }
         previous = next;
     }
-    return { layout, ...previous, stable: false, exports: maxExports };
+    return {
+        layout,
+        ...previous,
+        stable: false,
+        exports: maxExports,
+    };
 }

package/dist/file-archive.js

@@ -4,8 +4,9 @@ import { redactEndpoint } from "./endpoint.js";
 /** Full-fidelity recovery is established by import/readback, not by receiving archive bytes. */
 export async function exportFileArchive(client, options = {}) {
     const maxBytes = options.maxBytes ?? 512 * 1024;
-    if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0 || maxBytes > 16 * 1024 * 1024)
+    if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0 || maxBytes > 16 * 1024 * 1024) {
         throw new Error("Archive budget must be positive and at most 16 MiB");
+    }
     const result = await runSnippet(client, snippet("file-archive", `
 const file = penpot.currentFile, fileId = file.id, revn = file.revn;
 if (typeof file.export !== "function") return { ok: true, status: "unsupported", message: "File export is unavailable; use Penpot's File export menu" };
@@ -17,16 +18,41 @@ if (!bytes || !Number.isSafeInteger(bytes.length) || bytes.length === 0) return
 if (bytes.length > CFG.maxBytes) return { ok: true, status: "too-large", message: "Archive exceeds the configured response budget; export it manually" };
 let binary = "";
 for (let i = 0; i < bytes.length; i += 8192) binary += String.fromCharCode.apply(null, bytes.subarray(i, i + 8192));
-return { ok: true, status: "exported", fileId, revn, length: bytes.length, base64: btoa(binary) };`, { maxBytes }, "read"));
+return { ok: true, status: "exported", fileId, revn, length: bytes.length, base64: btoa(binary) };`, {
+        maxBytes,
+    }, "read"));
     if (result.status !== "exported") {
-        if (!["unsupported", "failed", "too-large", "changed"].includes(String(result.status)) || typeof result.message !== "string")
+        if (![
+            "unsupported",
+            "failed",
+            "too-large",
+            "changed",
+        ].includes(String(result.status)) ||
+            typeof result.message !== "string") {
             throw new Error("Archive response contained no valid outcome");
-        return { status: result.status, message: redactEndpoint(result.message) };
+        }
+        return {
+            status: result.status,
+            message: redactEndpoint(result.message),
+        };
     }
-    if (result.ok !== true || typeof result.fileId !== "string" || !Number.isInteger(result.revn) || typeof result.base64 !== "string" || !/^[A-Za-z0-9+/]*={0,2}$/.test(result.base64))
+    if (result.ok !== true ||
+        typeof result.fileId !== "string" ||
+        !Number.isInteger(result.revn) ||
+        typeof result.base64 !== "string" ||
+        !/^[A-Za-z0-9+/]*={0,2}$/.test(result.base64)) {
         throw new Error("Archive response contained incomplete metadata");
+    }
     const bytes = Buffer.from(result.base64, "base64");
-    if (bytes.length === 0 || bytes.length > maxBytes || bytes.length !== result.length)
+    if (bytes.length === 0 || bytes.length > maxBytes || bytes.length !== result.length) {
         throw new Error("Archive response was empty, truncated or over budget");
-    return { status: "exported", bytes, fileId: result.fileId, revn: Number(result.revn), sha256: createHash("sha256").update(bytes).digest("hex"), restoreVerified: false };
+    }
+    return {
+        status: "exported",
+        bytes,
+        fileId: result.fileId,
+        revn: Number(result.revn),
+        sha256: createHash("sha256").update(bytes).digest("hex"),
+        restoreVerified: false,
+    };
 }

package/dist/file-guard.js

@@ -1,40 +1,58 @@
+import { inheritPageSession } from "./page-session.js";
 import { executionEnvelope, maxSnippetBytes } from "./client.js";
 import { PenpairError } from "./errors.js";
 /** A guard in the delivered execution closes the gap between a connection check and a later batch. */
 export function guardFile(client, expected, options = {}) {
     if (!expected || options.anyFile) {
-        options.warn?.(options.anyFile ? "--any-file overrides the project's file guard for this run." : "No file ID is pinned. Run `penpair connect --pin-file` to protect this project's file.");
+        options.warn?.(options.anyFile
+            ? "--any-file overrides the project's file guard for this run."
+            : "No file ID is pinned. Run `penpair connect --pin-file` to protect this project's file.");
         return client;
     }
     const warningPrefix = "penpair-file-warning: ";
-    return {
+    return inheritPageSession({
         ...client,
         close: () => client.close(),
-        ...(client.listTools ? { listTools: () => client.listTools() } : {}),
+        ...(client.listTools
+            ? {
+                listTools: () => client.listTools(),
+            }
+            : {}),
         async callTool(name, args, callOptions) {
-            if (name !== "execute_code" || typeof args.code !== "string")
+            if (name !== "execute_code" || typeof args.code !== "string") {
                 throw new PenpairError("file-mismatch", "The file guard only permits guarded execute_code calls.");
+            }
             const guard = `{ const __penpairExpectedFile = ${JSON.stringify(expected)};
 const __penpairActualFile = penpot.currentFile;
 if (!__penpairActualFile || __penpairActualFile.id !== __penpairExpectedFile.id) {
   const message = "Expected file " + (__penpairExpectedFile.name || __penpairExpectedFile.id) + " (" + __penpairExpectedFile.id + "), connected to " + (__penpairActualFile ? __penpairActualFile.name + " (" + __penpairActualFile.id + ")" : "no file") + ". Open the expected file and reconnect, or explicitly use --any-file.";
-  ${options.mode === "warn" ? `console.warn(${JSON.stringify(warningPrefix)} + message);` : 'return { ok: false, fileMismatch: true, message };'}
+  ${options.mode === "warn" ? `console.warn(${JSON.stringify(warningPrefix)} + message);` : "return { ok: false, fileMismatch: true, message };"}
 } }
 `;
             const code = guard + args.code;
-            if (Buffer.byteLength(code, "utf8") > maxSnippetBytes)
+            if (Buffer.byteLength(code, "utf8") > maxSnippetBytes) {
                 throw new PenpairError("snippet-too-large", "The snippet including its file guard exceeds 90 KB");
-            const outcome = await client.callTool(name, { ...args, code }, callOptions);
+            }
+            const outcome = await client.callTool(name, {
+                ...args,
+                code,
+            }, callOptions);
             const envelope = executionEnvelope(outcome);
             const result = envelope?.result;
-            if (typeof result === "object" && result !== null && "fileMismatch" in result && result.fileMismatch === true)
+            if (typeof result === "object" &&
+                result !== null &&
+                "fileMismatch" in result &&
+                result.fileMismatch === true) {
                 throw new PenpairError("file-mismatch", String("message" in result ? result.message : "The connected file changed"));
+            }
             if (typeof envelope?.log === "string") {
-                for (const line of envelope.log.split("\n"))
-                    if (line.includes(warningPrefix))
+                for (const line of envelope.log.split("\n")) {
+                    if (line.includes(warningPrefix)) {
                         options.warn?.(line.slice(line.indexOf(warningPrefix) + warningPrefix.length));
+                    }
+                }
             }
             return outcome;
         },
-    };
+    }, client);
 }

package/dist/formats.js

@@ -1,28 +1,229 @@
 import { projectConfigSchema } from "./instance/config-schema.js";
 import { validateProjectConfig } from "./instance/config.js";
 import { commandResultSchema } from "./command-result.js";
-const string = { type: "string" }, array = { type: "array" };
-const schema = (name, version, kind, properties, required = Object.keys(properties)) => ({ $schema: "https://json-schema.org/draft/2020-12/schema", $id: `urn:penpair:schema:v${version}:${name}`, title: `${name} v${version}`, type: "object", required: ["schemaVersion", ...(kind ? ["kind"] : []), ...required], properties: { schemaVersion: { const: version }, ...(kind ? { kind: { const: kind } } : {}), ...properties }, additionalProperties: true });
+const string = {
+    type: "string",
+};
+const array = {
+    type: "array",
+};
+const schema = (name, version, kind, properties, required = Object.keys(properties)) => ({
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: `urn:penpair:schema:v${version}:${name}`,
+    title: `${name} v${version}`,
+    type: "object",
+    required: [
+        "schemaVersion",
+        ...(kind
+            ? [
+                "kind",
+            ]
+            : []),
+        ...required,
+    ],
+    properties: {
+        schemaVersion: {
+            const: version,
+        },
+        ...(kind
+            ? {
+                kind: {
+                    const: kind,
+                },
+            }
+            : {}),
+        ...properties,
+    },
+    additionalProperties: true,
+});
 /** Public envelope schemas; runtime validators additionally enforce hashes, identities, hierarchy and budgets. */
 export const artifactSchemas = {
-    "project-config": { ...projectConfigSchema, $id: "urn:penpair:schema:v1:project-config" },
-    "command-result": { $schema: "https://json-schema.org/draft/2020-12/schema", $id: "urn:penpair:schema:v1:command-result", ...commandResultSchema },
-    "inspection": schema("inspection", 1, undefined, { kind: { enum: ["shape-inspection", "token-inspection"] }, fileId: string, pageId: { type: ["string", "null"] }, revision: { type: "integer", minimum: 0 }, complete: { type: "boolean" }, counts: { type: "object" }, reasons: array, producer: { type: "object" } }),
-    "component-map": schema("component-map", 1, undefined, { components: { type: "array", maxItems: 1000, items: { type: "object", required: ["libraryId", "componentId", "codeComponent"], properties: { libraryId: string, componentId: string, codeComponent: string, props: { type: "object" }, textProps: { type: "object", additionalProperties: string } } } } }),
-    "design-spec": schema("design-spec", 1, "design-spec", { source: { type: "object" }, mappingHash: string, nodes: array, unknowns: array }),
-    "approvals": schema("approvals", 1, "design-approvals", { records: { type: "array", maxItems: 10000 } }),
-    "structural-manifest": schema("structural-manifest", 1, "structural-snapshot-manifest", { fileId: string, revision: { type: "integer" }, producer: string, fidelity: { const: "review-only" }, pages: { type: "array", minItems: 1, maxItems: 100 }, tokens: { type: "object" }, hash: string }),
-    "baseline-manifest": schema("baseline-manifest", 2, undefined, { complete: { type: "boolean" }, fileId: string, pageId: string, captureId: string, frames: { type: "array", maxItems: 1000 } }),
-    "portable-tokens": schema("portable-tokens", 1, "portable-tokens", { format: { const: "dtcg-2025.10-subset" }, tokens: { type: "array", minItems: 1, maxItems: 10000, items: { type: "object", required: ["path", "type", "value"], properties: { path: { type: "array", minItems: 1, maxItems: 32, items: string }, type: { enum: ["color", "dimension", "number", "fontFamily", "fontWeight", "typography"] }, value: {}, description: string, extensions: { type: "object" } } } }, groups: { type: "object" }, losses: { type: "array", maxItems: 0 } }),
+    "project-config": {
+        ...projectConfigSchema,
+        $id: "urn:penpair:schema:v1:project-config",
+    },
+    "command-result": {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        $id: "urn:penpair:schema:v1:command-result",
+        ...commandResultSchema,
+    },
+    inspection: schema("inspection", 1, undefined, {
+        kind: {
+            enum: [
+                "shape-inspection",
+                "token-inspection",
+            ],
+        },
+        fileId: string,
+        pageId: {
+            type: [
+                "string",
+                "null",
+            ],
+        },
+        revision: {
+            type: "integer",
+            minimum: 0,
+        },
+        complete: {
+            type: "boolean",
+        },
+        counts: {
+            type: "object",
+        },
+        reasons: array,
+        producer: {
+            type: "object",
+        },
+    }),
+    "component-map": schema("component-map", 1, undefined, {
+        components: {
+            type: "array",
+            maxItems: 1000,
+            items: {
+                type: "object",
+                required: [
+                    "libraryId",
+                    "componentId",
+                    "codeComponent",
+                ],
+                properties: {
+                    libraryId: string,
+                    componentId: string,
+                    codeComponent: string,
+                    props: {
+                        type: "object",
+                    },
+                    textProps: {
+                        type: "object",
+                        additionalProperties: string,
+                    },
+                },
+            },
+        },
+    }),
+    "design-spec": schema("design-spec", 1, "design-spec", {
+        source: {
+            type: "object",
+        },
+        mappingHash: string,
+        nodes: array,
+        unknowns: array,
+    }),
+    approvals: schema("approvals", 1, "design-approvals", {
+        records: {
+            type: "array",
+            maxItems: 10000,
+        },
+    }),
+    "structural-manifest": schema("structural-manifest", 1, "structural-snapshot-manifest", {
+        fileId: string,
+        revision: {
+            type: "integer",
+        },
+        producer: string,
+        fidelity: {
+            const: "review-only",
+        },
+        pages: {
+            type: "array",
+            minItems: 1,
+            maxItems: 100,
+        },
+        tokens: {
+            type: "object",
+        },
+        hash: string,
+    }),
+    "baseline-manifest": schema("baseline-manifest", 2, undefined, {
+        complete: {
+            type: "boolean",
+        },
+        fileId: string,
+        pageId: string,
+        captureId: string,
+        frames: {
+            type: "array",
+            maxItems: 1000,
+        },
+    }),
+    "projected-theme-preview": schema("projected-theme-preview", 1, "projected-theme-preview", {
+        sourceHash: string,
+        theme: {
+            type: "object",
+        },
+        sets: array,
+        resolved: array,
+        unknowns: array,
+        complete: {
+            type: "boolean",
+        },
+        nativeBindings: {
+            const: false,
+        },
+    }),
+    "portable-tokens": schema("portable-tokens", 1, "portable-tokens", {
+        format: {
+            const: "dtcg-2025.10-subset",
+        },
+        tokens: {
+            type: "array",
+            minItems: 1,
+            maxItems: 10000,
+            items: {
+                type: "object",
+                required: [
+                    "path",
+                    "type",
+                    "value",
+                ],
+                properties: {
+                    path: {
+                        type: "array",
+                        minItems: 1,
+                        maxItems: 32,
+                        items: string,
+                    },
+                    type: {
+                        enum: [
+                            "color",
+                            "dimension",
+                            "number",
+                            "fontFamily",
+                            "fontWeight",
+                            "typography",
+                        ],
+                    },
+                    value: {},
+                    description: string,
+                    extensions: {
+                        type: "object",
+                    },
+                },
+            },
+        },
+        groups: {
+            type: "object",
+        },
+        losses: {
+            type: "array",
+            maxItems: 0,
+        },
+    }),
 };
 /** Legacy unversioned config is v1; preserve every extension block and require explicit new output for persistence. */
 export function migrateProjectConfig(raw) {
-    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
         throw new Error("Config migration requires a JSON object");
+    }
     const v = raw;
-    if (v.schemaVersion !== undefined && v.schemaVersion !== 1)
+    if (v.schemaVersion !== undefined && v.schemaVersion !== 1) {
         throw new Error("Unsupported project config major version; use the producer's documented migration before opening it");
-    const migrated = { ...structuredClone(v), schemaVersion: 1 };
+    }
+    const migrated = {
+        ...structuredClone(v),
+        schemaVersion: 1,
+    };
     validateProjectConfig(migrated);
     return migrated;
 }

package/dist/index.d.ts

@@ -31,21 +31,21 @@ export * from "./instance/gitignore.js";
 export { defaultInstanceName, init } from "./instance/init.js";
 export type { InitOptions, InitResult } from "./instance/init.js";
 export * from "./instance/runner.js";
-export { writeCoordinator, guardRevision, type WriteLease, type CoordinationOptions } from "./coordination.js";
+export { writeCoordinator, guardRevision, type WriteLease, type CoordinationOptions, } from "./coordination.js";
 export { onboardingChecklist } from "./onboard.js";
 export { atomicWriteFile } from "./atomic-output.js";
-export { commandSleep, withCleanupDeadline, commandResultSchema, collectCommand, commandOutput, type CommandResult, type CommandFailure, type CommandOutput } from "./command-result.js";
+export { commandSleep, withCleanupDeadline, commandResultSchema, collectCommand, commandOutput, type CommandResult, type CommandFailure, type CommandOutput, } from "./command-result.js";
 export { resolveProjectInput, resolveProjectOutput, designDataBlock } from "./project-input.js";
-export { planSkillInstructions, applySkillInstructions, type InstructionReport } from "./skill-instructions.js";
+export { planSkillInstructions, applySkillInstructions, type InstructionReport, } from "./skill-instructions.js";
 export { parseCommandArgs, CommandArgumentError } from "./cli-arguments.js";
-export { findShapesByName, exportShapeByName, captureShots, type ShapeLookup, type ShapeMatch, type ShotsReport } from "./shots.js";
+export { findShapesByName, exportShapeByName, captureShots, type ShapeLookup, type ShapeMatch, type ShotsReport, } from "./shots.js";
 export * from "./inspection.js";
-export { tokenTypes, validateEditableToken, validateTokenEdit, planTokenEdit, tokenEditOperation, type EditableToken, type TokenEdit, type TokenEditState, type TokenEditPlan } from "./token-edit.js";
+export { tokenTypes, validateEditableToken, validateTokenEdit, planTokenEdit, tokenEditOperation, type EditableToken, type TokenEdit, type TokenEditState, type TokenEditPlan, } from "./token-edit.js";
 export { ensureGitignoreEntry } from "./instance/gitignore.js";
-export { prepareFileScript, runFileScript, type FileScriptOptions, type PreparedFileScript } from "./run-file.js";
+export { prepareFileScript, runFileScript, type FileScriptOptions, type PreparedFileScript, } from "./run-file.js";
 export { kit, coreKit, checkKits, loadKits, type BuildKit, type RecipeInfo } from "./kit.js";
 export { runKitSmoke, kitSmokeOperation } from "./kit-smoke.js";
-export { baselineCoverage, readBaselineCoverage, designCaseKey, type BaselineCoverage, type CoverageRow } from "./baseline-coverage.js";
+export { baselineCoverage, readBaselineCoverage, designCaseKey, type BaselineCoverage, type CoverageRow, } from "./baseline-coverage.js";
 export * from "./design-spec.js";
 export * from "./mcp-server.js";
 export * from "./approvals.js";
@@ -55,3 +55,4 @@ export * from "./formats.js";
 export * from "./project-status.js";
 export * from "./audit-rules.js";
 export * from "./credentials.js";
+export * from "./token-projection.js";

package/dist/index.js

@@ -30,21 +30,21 @@ export * from "./instance/connection.js";
 export * from "./instance/gitignore.js";
 export { defaultInstanceName, init } from "./instance/init.js";
 export * from "./instance/runner.js";
-export { writeCoordinator, guardRevision } from "./coordination.js";
+export { writeCoordinator, guardRevision, } from "./coordination.js";
 export { onboardingChecklist } from "./onboard.js";
 export { atomicWriteFile } from "./atomic-output.js";
-export { commandSleep, withCleanupDeadline, commandResultSchema, collectCommand, commandOutput } from "./command-result.js";
+export { commandSleep, withCleanupDeadline, commandResultSchema, collectCommand, commandOutput, } from "./command-result.js";
 export { resolveProjectInput, resolveProjectOutput, designDataBlock } from "./project-input.js";
-export { planSkillInstructions, applySkillInstructions } from "./skill-instructions.js";
+export { planSkillInstructions, applySkillInstructions, } from "./skill-instructions.js";
 export { parseCommandArgs, CommandArgumentError } from "./cli-arguments.js";
-export { findShapesByName, exportShapeByName, captureShots } from "./shots.js";
+export { findShapesByName, exportShapeByName, captureShots, } from "./shots.js";
 export * from "./inspection.js";
-export { tokenTypes, validateEditableToken, validateTokenEdit, planTokenEdit, tokenEditOperation } from "./token-edit.js";
+export { tokenTypes, validateEditableToken, validateTokenEdit, planTokenEdit, tokenEditOperation, } from "./token-edit.js";
 export { ensureGitignoreEntry } from "./instance/gitignore.js";
-export { prepareFileScript, runFileScript } from "./run-file.js";
+export { prepareFileScript, runFileScript, } from "./run-file.js";
 export { kit, coreKit, checkKits, loadKits } from "./kit.js";
 export { runKitSmoke, kitSmokeOperation } from "./kit-smoke.js";
-export { baselineCoverage, readBaselineCoverage, designCaseKey } from "./baseline-coverage.js";
+export { baselineCoverage, readBaselineCoverage, designCaseKey, } from "./baseline-coverage.js";
 export * from "./design-spec.js";
 export * from "./mcp-server.js";
 export * from "./approvals.js";
@@ -54,3 +54,4 @@ export * from "./formats.js";
 export * from "./project-status.js";
 export * from "./audit-rules.js";
 export * from "./credentials.js";
+export * from "./token-projection.js";

package/dist/inspection.d.ts

@@ -1,6 +1,6 @@
 import { type ExecutionMetrics, type PenpotToolClient } from "./client.js";
 export declare const inspectionFields: readonly ["geometry", "text", "layout", "component", "tokens", "style", "metadata"];
-export type InspectionField = typeof inspectionFields[number];
+export type InspectionField = (typeof inspectionFields)[number];
 export interface InspectionQuery {
     kind?: "shape" | "tokens";
     shapeId?: string;