@12ui/design 0.2.71 → 0.2.73

package/dist/slate-edit-prompt.js

@@ -0,0 +1,41 @@
+import { sha256Hex } from './slate-ids.js';
+/**
+ * Turn an edit instruction and the strokes' bounding box into the text the
+ * local image call gets. No path takes a mask, so the box is words, and the
+ * strokes themselves travel as a second image (`slate-annotate.ts`) that the
+ * prompt tells the model to use only to locate the change.
+ */
+const ZONE_ROWS = ['top', 'middle', 'bottom'];
+const ZONE_COLUMNS = ['left', 'center', 'right'];
+const third = (permille) => (permille < 334 ? 0 : permille < 667 ? 1 : 2);
+export const regionZone = (region) => {
+    const row = third(region.y + region.h / 2);
+    const column = third(region.x + region.w / 2);
+    if (row === 1 && column === 1)
+        return 'center';
+    if (row === 1)
+        return ZONE_COLUMNS[column];
+    if (column === 1)
+        return ZONE_ROWS[row];
+    return `${ZONE_ROWS[row]} ${ZONE_COLUMNS[column]}`;
+};
+const percent = (permille) => Math.round(permille / 10);
+export const regionRanges = (region) => ({
+    left: percent(region.x),
+    right: percent(region.x + region.w),
+    top: percent(region.y),
+    bottom: percent(region.y + region.h),
+});
+export const assembleEditPrompt = (args) => {
+    const parts = ['Edit the first attached image. Preserve everything else exactly: layout, text, colours, identity.'];
+    if (args.region && args.colorName) {
+        const ranges = regionRanges(args.region);
+        parts.push(`The second attached image is the same design with the requested area marked by freehand ${args.colorName} strokes. `
+            + 'Use the marks only to locate the change; do not draw them in the result. '
+            + `The change belongs in the ${regionZone(args.region)} area, roughly ${ranges.left}% to ${ranges.right}% across and ${ranges.top}% to ${ranges.bottom}% down.`);
+    }
+    parts.push('Return the complete edited image at the original size.', `Requested change: ${args.prompt}`);
+    const sentPrompt = parts.join(' ');
+    return { sentPrompt, sentPromptSha256: sha256Hex(sentPrompt) };
+};
+//# sourceMappingURL=slate-edit-prompt.js.map

package/dist/slate-edit-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-edit-prompt.js","sourceRoot":"","sources":["../src/slate-edit-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;;;;GAKG;AAEH,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AACvD,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAE1D,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAa,EAAE,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAmB,EAAU,EAAE;IACxD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC,MAAM,CAAE,CAAC;IAC5C,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,GAAG,CAAE,CAAC;IACzC,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAmB,EAAgE,EAAE,CAAC,CAAC;IAClH,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IACnC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAKlC,EAAoD,EAAE;IACrD,MAAM,KAAK,GAAG,CAAC,mGAAmG,CAAC,CAAC;IACpH,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CACR,2FAA2F,IAAI,CAAC,SAAS,YAAY;cACnH,2EAA2E;cAC3E,6BAA6B,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,MAAM,CAAC,IAAI,QAAQ,MAAM,CAAC,KAAK,gBAAgB,MAAM,CAAC,GAAG,QAAQ,MAAM,CAAC,MAAM,SAAS,CAChK,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,wDAAwD,EAAE,qBAAqB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzG,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;AACjE,CAAC,CAAC"}

package/dist/slate-edit-runner.d.ts

@@ -0,0 +1,4 @@
+import { type Outcome, type RunnerEnv } from './slate-runner-context.js';
+import type { SlateOp } from './slate-workspace-types.js';
+export declare const runEdit: (env: RunnerEnv, op: SlateOp) => Promise<Outcome>;
+//# sourceMappingURL=slate-edit-runner.d.ts.map

package/dist/slate-edit-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-edit-runner.d.ts","sourceRoot":"","sources":["../src/slate-edit-runner.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,SAAS,EACf,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAmB,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAe3E,eAAO,MAAM,OAAO,GAAU,KAAK,SAAS,EAAE,IAAI,OAAO,KAAG,OAAO,CAAC,OAAO,CAmE1E,CAAC"}

package/dist/slate-edit-runner.js

@@ -0,0 +1,90 @@
+import sharp from 'sharp';
+import { sha256Hex } from './slate-ids.js';
+import { editAnnotatedFile, editSourceFile, readWorkspaceFile, versionImageFile } from './slate-paths.js';
+import { errorFromRunner, failure, ledger, patchOp, setPhase, } from './slate-runner-context.js';
+import { imageFailureMessage } from './slate-runner-failure.js';
+import { writeImageOnce } from './slate-versions.js';
+import { findCandidate } from './slate-workspace-store.js';
+/**
+ * Edit: one native image call with the parent and, when the user drew, the
+ * annotated copy, both read from the files the click committed and checked
+ * against the digests frozen in `op.params`. The parent version is never
+ * touched; the new image is written once under `versions/` and registered as
+ * the option's next version. The call id is `slate-<opId>`.
+ */
+const readFrozen = async (env, file, sha256) => {
+    const read = await readWorkspaceFile(env.root, file);
+    return read.state === 'ok' && read.sha256 === sha256 ? read.bytes : null;
+};
+export const runEdit = async (env, op) => {
+    const params = op.params;
+    const source = await readFrozen(env, editSourceFile(env.root, env.opId), params.sourceSha256);
+    if (!source)
+        return failure('source_changed', 'The image this edit was started from is missing or changed.');
+    let annotated = null;
+    if (params.annotatedSha256) {
+        annotated = await readFrozen(env, editAnnotatedFile(env.root, env.opId), params.annotatedSha256);
+        if (!annotated)
+            return failure('source_changed', 'The marked copy of the image is missing or changed.');
+    }
+    const callId = `slate-${env.opId}`;
+    await setPhase(env, 'drawing');
+    let png;
+    let reused;
+    try {
+        await ledger(env, { event: 'call_started', callId });
+        const result = await env.executor.generate({
+            callId,
+            prompt: params.sentPrompt,
+            images: annotated ? [source, annotated] : [source],
+            expected: { width: params.width, height: params.height },
+        });
+        png = await sharp(result.png, { animated: false, failOn: 'warning' }).png().toBuffer();
+        reused = result.reused;
+    }
+    catch (error) {
+        const cause = error?.cause;
+        await env.log({
+            event: 'call_failed',
+            code: error?.code ?? null,
+            message: error instanceof Error ? error.message.slice(0, 300) : String(error).slice(0, 300),
+            ...(cause instanceof Error ? { cause: cause.message.slice(0, 300) } : {}),
+        });
+        return failure('edit_failed', imageFailureMessage(error), { retryable: true });
+    }
+    try {
+        const facts = await sharp(png).metadata();
+        const sha256 = sha256Hex(png);
+        await writeImageOnce(versionImageFile(env.root, params.newVersionId), png, sha256);
+        await ledger(env, { event: 'call_finished', callId, sha256, reused });
+        await patchOp(env, (current, workspace) => {
+            if (workspace.versions.some((entry) => entry.versionId === params.newVersionId))
+                return;
+            const candidate = findCandidate(workspace, params.candidateId);
+            workspace.versions.push({
+                versionId: params.newVersionId,
+                candidateId: params.candidateId,
+                n: params.n,
+                kind: 'edit',
+                parentVersionId: params.parentVersionId,
+                opId: env.opId,
+                prompt: params.prompt,
+                sentPromptSha256: params.sentPromptSha256,
+                marks: params.region ? { strokes: params.strokeCount, region: params.region } : null,
+                sha256,
+                width: facts.width ?? params.width,
+                height: facts.height ?? params.height,
+                createdAt: env.clock.now().toISOString(),
+            });
+            candidate.versionIds.push(params.newVersionId);
+            current.resultVersionIds = [params.newVersionId];
+        });
+        await env.log({ event: 'collected', sha256, reused });
+    }
+    catch (error) {
+        // The image is on disk (or the record write failed): a Resume registers it without another call.
+        return { state: 'failed', error: { ...errorFromRunner(error), resumable: true } };
+    }
+    return { state: 'succeeded' };
+};
+//# sourceMappingURL=slate-edit-runner.js.map

package/dist/slate-edit-runner.js.map

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

package/dist/slate-editability.d.ts

@@ -0,0 +1,20 @@
+import type { SlateErrorCode } from './slate-errors.js';
+import type { SlateCandidate, SlateOp, SlateRound, SlateWorkspace } from './slate-workspace-types.js';
+/**
+ * Whether an option can take another action, decided from the record alone
+ * (no file reads, no network), so the view and `run` agree.
+ */
+export type Blocker = {
+    code: SlateErrorCode;
+    message: string;
+};
+/** An op keeps its option busy while it runs, is interrupted, or ended in a state a free Resume continues. */
+export declare const opHoldsOption: (op: SlateOp) => boolean;
+export declare const optionOf: (workspace: SlateWorkspace, candidateId: string) => {
+    candidate: SlateCandidate;
+    round: SlateRound;
+} | undefined;
+export declare const busyOp: (workspace: SlateWorkspace, candidate: SlateCandidate) => SlateOp | undefined;
+/** `null` when the option can take an edit now. */
+export declare const editBlocker: (workspace: SlateWorkspace, candidate: SlateCandidate) => Blocker | null;
+//# sourceMappingURL=slate-editability.d.ts.map

package/dist/slate-editability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-editability.d.ts","sourceRoot":"","sources":["../src/slate-editability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEtG;;;GAGG;AAEH,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,8GAA8G;AAC9G,eAAO,MAAM,aAAa,GAAI,IAAI,OAAO,KAAG,OAE3C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,WAAW,cAAc,EAAE,aAAa,MAAM,KAAG;IACxE,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,SAIH,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,WAAW,cAAc,EAAE,WAAW,cAAc,KAAG,OAAO,GAAG,SAMvF,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,WAAW,GAAI,WAAW,cAAc,EAAE,WAAW,cAAc,KAAG,OAAO,GAAG,IAI5F,CAAC"}

package/dist/slate-editability.js

@@ -0,0 +1,19 @@
+/** An op keeps its option busy while it runs, is interrupted, or ended in a state a free Resume continues. */
+export const opHoldsOption = (op) => (op.state === 'running' || (op.state === 'failed' && op.error?.resumable === true));
+export const optionOf = (workspace, candidateId) => {
+    const candidate = workspace.candidates.find((entry) => entry.candidateId === candidateId);
+    const round = candidate && workspace.rounds.find((entry) => entry.roundId === candidate.roundId);
+    return candidate && round ? { candidate, round } : undefined;
+};
+export const busyOp = (workspace, candidate) => (workspace.ops.find((op) => {
+    if (!opHoldsOption(op))
+        return false;
+    if (op.params.kind === 'round')
+        return op.params.candidateIds.includes(candidate.candidateId);
+    return op.target.candidateId === candidate.candidateId;
+}));
+/** `null` when the option can take an edit now. */
+export const editBlocker = (workspace, candidate) => (busyOp(workspace, candidate)
+    ? { code: 'candidate_busy', message: `${candidate.label} is busy with work that has not finished.` }
+    : null);
+//# sourceMappingURL=slate-editability.js.map

package/dist/slate-editability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-editability.js","sourceRoot":"","sources":["../src/slate-editability.ts"],"names":[],"mappings":"AAUA,8GAA8G;AAC9G,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAW,EAAW,EAAE,CAAC,CACrD,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,EAAE,CAAC,KAAK,KAAK,QAAQ,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC,CAClF,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,SAAyB,EAAE,WAAmB,EAGzD,EAAE;IACd,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC;IACjG,OAAO,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,SAAyB,EAAE,SAAyB,EAAuB,EAAE,CAAC,CACnG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;IACxB,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC9F,OAAO,EAAE,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW,CAAC;AACzD,CAAC,CAAC,CACH,CAAC;AAEF,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAyB,EAAE,SAAyB,EAAkB,EAAE,CAAC,CACnG,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC;IAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,KAAK,2CAA2C,EAAE;IACpG,CAAC,CAAC,IAAI,CACT,CAAC"}

package/dist/slate-errors.d.ts

@@ -0,0 +1,15 @@
+/** Errors the design workspace tools return as `{ code, message, retryable }`. */
+export type SlateErrorCode = 'intent_conflict' | 'candidate_busy' | 'no_fresh_references' | 'local_unavailable' | 'source_missing' | 'invalid_input' | 'workspace_busy' | 'state_invalid' | 'approval_missing' | 'approval_mismatch' | 'not_resumable' | 'superseded' | 'file_missing' | 'file_changed' | 'not_found' | 'unknown_reference' | 'rate_limited' | 'corpus_unavailable' | 'too_large';
+export declare class SlateError extends Error {
+    readonly code: SlateErrorCode;
+    readonly retryable: boolean;
+    readonly retryAfterSeconds: number | undefined;
+    constructor(code: SlateErrorCode, message: string, options?: {
+        retryAfterSeconds?: number;
+    });
+}
+/** A record on disk failed strict validation. Never repaired silently. */
+export declare class SlateStateInvalidError extends SlateError {
+    constructor(file: string, detail: string);
+}
+//# sourceMappingURL=slate-errors.d.ts.map

package/dist/slate-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-errors.d.ts","sourceRoot":"","sources":["../src/slate-errors.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,GACrB,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,cAAc,GACd,cAAc,GACd,WAAW,GACX,mBAAmB,GACnB,cAAc,GACd,oBAAoB,GACpB,WAAW,CAAC;AAIhB,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEnC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO;CAOhG;AAED,0EAA0E;AAC1E,qBAAa,sBAAuB,SAAQ,UAAU;gBACxC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAGzC"}

package/dist/slate-errors.js

@@ -0,0 +1,21 @@
+/** Errors the design workspace tools return as `{ code, message, retryable }`. */
+const RETRYABLE = new Set(['workspace_busy', 'rate_limited', 'corpus_unavailable']);
+export class SlateError extends Error {
+    code;
+    retryable;
+    retryAfterSeconds;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = 'SlateError';
+        this.code = code;
+        this.retryable = RETRYABLE.has(code);
+        this.retryAfterSeconds = options.retryAfterSeconds;
+    }
+}
+/** A record on disk failed strict validation. Never repaired silently. */
+export class SlateStateInvalidError extends SlateError {
+    constructor(file, detail) {
+        super('state_invalid', `${file} is not a valid 12ui workspace record: ${detail}`);
+    }
+}
+//# sourceMappingURL=slate-errors.js.map

package/dist/slate-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-errors.js","sourceRoot":"","sources":["../src/slate-errors.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAuBlF,MAAM,SAAS,GAAgC,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAEjH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IACrB,SAAS,CAAU;IACnB,iBAAiB,CAAqB;IAE/C,YAAY,IAAoB,EAAE,OAAe,EAAE,UAA0C,EAAE;QAC7F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACrD,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IACpD,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,eAAe,EAAE,GAAG,IAAI,0CAA0C,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;CACF"}

package/dist/slate-handoff-options.d.ts

@@ -0,0 +1,40 @@
+import type { SlateHandoffRecord } from './slate-view-contract.js';
+/**
+ * What a Branch or Convert hand-off may carry, decided in one place: the
+ * record parser, the `handoff` tool and the text the agent reads all use it.
+ * The combinations are the CLI's own (`12ui convert`): local formats are HTML,
+ * React and Assets with `--clean-assets`; every other format is the 12ui
+ * service and takes `--model`, `--width` and, for responsive HTML only,
+ * `--responsive-quality`.
+ */
+export declare const BRANCH_EXPLANATION_MAX_CHARACTERS = 2000;
+export declare const LOCAL_CONVERT_OUTPUTS: readonly ["html", "react", "assets"];
+export declare const SERVICE_CONVERT_OUTPUTS: readonly ["html", "layerdoc", "html_fixed", "svg", "png", "jpg", "webp", "pdf", "psd", "pptx", "sketch"];
+type BranchOptions = Extract<SlateHandoffRecord, {
+    kind: 'branch';
+}>['options'];
+type ConvertOptions = Extract<SlateHandoffRecord, {
+    kind: 'convert';
+}>['options'];
+export type HandoffOptionsResult<T> = {
+    ok: true;
+    options: T;
+} | {
+    ok: false;
+    message: string;
+};
+/** Control characters are stripped except tab and newline; the rest is the user's text, verbatim. */
+export declare const cleanExplanation: (value: string) => string;
+export declare const parseBranchOptions: (value: unknown) => HandoffOptionsResult<BranchOptions>;
+export declare const parseConvertOptions: (value: unknown) => HandoffOptionsResult<ConvertOptions>;
+export declare const parseHandoffOptions: (kind: unknown, value: unknown) => HandoffOptionsResult<SlateHandoffRecord["options"]>;
+/** The command lines an agent runs for a recorded Convert, with the image path filled in. */
+export declare const convertCommands: (options: ConvertOptions, imagePath: string) => string[];
+/**
+ * The choice in words an agent maps to the commands above: a local format is
+ * the free Codex engine's HTML run, and React and Assets are derived from that
+ * run by `12ui export`; a service format is one `12ui convert --engine api`.
+ */
+export declare const convertChoiceWords: (options: ConvertOptions) => string;
+export {};
+//# sourceMappingURL=slate-handoff-options.d.ts.map

package/dist/slate-handoff-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-handoff-options.d.ts","sourceRoot":"","sources":["../src/slate-handoff-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEvF;;;;;;;GAOG;AAEH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD,eAAO,MAAM,qBAAqB,sCAAuC,CAAC;AAC1E,eAAO,MAAM,uBAAuB,0GAEc,CAAC;AAEnD,KAAK,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC,SAAS,CAAC,CAAC;AAChF,KAAK,cAAc,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC,SAAS,CAAC,CAAC;AAClF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAShG,qGAAqG;AACrG,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,MAGhD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,oBAAoB,CAAC,aAAa,CAWrF,CAAC;AAIF,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,oBAAoB,CAAC,cAAc,CAoCvF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAM,OAAO,EAAE,OAAO,OAAO,KAAG,oBAAoB,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAIrH,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,eAAe,GAAI,SAAS,cAAc,EAAE,WAAW,MAAM,KAAG,MAAM,EAelF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,cAAc,KAAG,MAM5D,CAAC"}

package/dist/slate-handoff-options.js

@@ -0,0 +1,127 @@
+import { CONVERSION_OUTPUT_FORMATS } from './conversion-outputs.js';
+import { MAX_IMAGE_OUTPUT_WIDTH } from './image-output-width.js';
+/**
+ * What a Branch or Convert hand-off may carry, decided in one place: the
+ * record parser, the `handoff` tool and the text the agent reads all use it.
+ * The combinations are the CLI's own (`12ui convert`): local formats are HTML,
+ * React and Assets with `--clean-assets`; every other format is the 12ui
+ * service and takes `--model`, `--width` and, for responsive HTML only,
+ * `--responsive-quality`.
+ */
+export const BRANCH_EXPLANATION_MAX_CHARACTERS = 2_000;
+export const LOCAL_CONVERT_OUTPUTS = ['html', 'react', 'assets'];
+export const SERVICE_CONVERT_OUTPUTS = [
+    'html', 'layerdoc', 'html_fixed', 'svg', 'png', 'jpg', 'webp', 'pdf', 'psd', 'pptx', 'sketch',
+];
+const isRecord = (value) => (!!value && typeof value === 'object' && !Array.isArray(value));
+const ok = (options) => ({ ok: true, options });
+const no = (message) => ({ ok: false, message });
+/** Control characters are stripped except tab and newline; the rest is the user's text, verbatim. */
+export const cleanExplanation = (value) => (
+// eslint-disable-next-line no-control-regex
+value.replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/gu, '').trim());
+export const parseBranchOptions = (value) => {
+    if (!isRecord(value))
+        return no('options must be an object');
+    const extra = Object.keys(value).filter((key) => key !== 'explanation');
+    if (extra.length > 0)
+        return no(`Branch takes only an explanation, not ${extra.join(', ')}.`);
+    if (typeof value.explanation !== 'string')
+        return no('options.explanation must be text');
+    const explanation = cleanExplanation(value.explanation);
+    if (!explanation)
+        return no('Say what should be built.');
+    if ([...explanation].length > BRANCH_EXPLANATION_MAX_CHARACTERS) {
+        return no(`An explanation can be at most ${BRANCH_EXPLANATION_MAX_CHARACTERS} characters.`);
+    }
+    return ok({ explanation });
+};
+const CONVERT_KEYS = new Set(['engine', 'output', 'cleanAssets', 'model', 'width', 'responsiveQuality']);
+export const parseConvertOptions = (value) => {
+    if (!isRecord(value))
+        return no('options must be an object');
+    const extra = Object.keys(value).filter((key) => !CONVERT_KEYS.has(key));
+    if (extra.length > 0)
+        return no(`Convert does not take ${extra.join(', ')}.`);
+    const { engine, output } = value;
+    if (engine !== 'local' && engine !== 'service')
+        return no('engine must be local or service');
+    const allowed = engine === 'local' ? LOCAL_CONVERT_OUTPUTS : SERVICE_CONVERT_OUTPUTS;
+    if (typeof output !== 'string' || !allowed.includes(output)) {
+        return no(`${engine === 'local' ? 'A local' : 'A service'} conversion outputs one of ${allowed.join(', ')}.`);
+    }
+    const options = { engine, output: output };
+    const present = (key) => value[key] !== undefined && value[key] !== null;
+    if (present('cleanAssets')) {
+        if (engine !== 'local')
+            return no('cleanAssets applies only to a local conversion.');
+        if (value.cleanAssets !== 'crop' && value.cleanAssets !== 'enhance')
+            return no('cleanAssets must be crop or enhance');
+        options.cleanAssets = value.cleanAssets;
+    }
+    if (present('model')) {
+        if (engine !== 'service')
+            return no('model applies only to a service conversion.');
+        if (value.model !== 'fast' && value.model !== 'standard' && value.model !== 'pro')
+            return no('model must be fast, standard or pro');
+        options.model = value.model;
+    }
+    if (present('width')) {
+        if (engine !== 'service')
+            return no('width applies only to a service conversion.');
+        const width = value.width;
+        if (typeof width !== 'number' || !Number.isSafeInteger(width) || width < 1 || width > MAX_IMAGE_OUTPUT_WIDTH) {
+            return no(`width must be an integer from 1 to ${MAX_IMAGE_OUTPUT_WIDTH}`);
+        }
+        options.width = width;
+    }
+    if (present('responsiveQuality')) {
+        if (engine !== 'service' || output !== 'html')
+            return no('responsiveQuality applies only to Responsive HTML.');
+        if (value.responsiveQuality !== 'standard' && value.responsiveQuality !== 'pro')
+            return no('responsiveQuality must be standard or pro');
+        options.responsiveQuality = value.responsiveQuality;
+    }
+    return ok(options);
+};
+export const parseHandoffOptions = (kind, value) => {
+    if (kind === 'branch')
+        return parseBranchOptions(value);
+    if (kind === 'convert')
+        return parseConvertOptions(value);
+    return no('kind must be convert or branch');
+};
+/** The command lines an agent runs for a recorded Convert, with the image path filled in. */
+export const convertCommands = (options, imagePath) => {
+    const image = JSON.stringify(imagePath);
+    if (options.engine === 'service') {
+        const flags = [
+            `--output ${options.output}`,
+            '--engine api',
+            ...(options.model ? [`--model ${options.model}`] : []),
+            ...(options.width ? [`--width ${options.width}`] : []),
+            ...(options.responsiveQuality ? [`--responsive-quality ${options.responsiveQuality}`] : []),
+        ];
+        return [`12ui convert ${image} ${flags.join(' ')}`];
+    }
+    const local = `12ui convert ${image} --output html --engine codex --image-backend native --clean-assets ${options.cleanAssets ?? 'enhance'}`;
+    if (options.output === 'html')
+        return [local];
+    return [local, `12ui export <the local run directory the convert printed> --output ${options.output} --out-dir <directory>`];
+};
+/**
+ * The choice in words an agent maps to the commands above: a local format is
+ * the free Codex engine's HTML run, and React and Assets are derived from that
+ * run by `12ui export`; a service format is one `12ui convert --engine api`.
+ */
+export const convertChoiceWords = (options) => {
+    if (options.engine === 'service')
+        return `${CONVERSION_OUTPUT_FORMATS[options.output]?.label ?? options.output} from the 12ui service`;
+    const clean = `asset cleanup ${options.cleanAssets ?? 'enhance'}`;
+    if (options.output === 'react')
+        return `React (whole-page JSX and CSS) from the local Codex engine, ${clean}`;
+    if (options.output === 'assets')
+        return `image assets (the cut-out files) from the local Codex engine, ${clean}`;
+    return `HTML from the local Codex engine, ${clean}`;
+};
+//# sourceMappingURL=slate-handoff-options.js.map

package/dist/slate-handoff-options.js.map

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

package/dist/slate-handoff.d.ts

@@ -0,0 +1,11 @@
+import type { SlateRuntime } from './slate-runtime.js';
+import type { SlateHandoffRecord } from './slate-workspace-types.js';
+export declare const recordHandoff: (args: {
+    runtime: SlateRuntime;
+    root: string;
+    handoffId: unknown;
+    kind: unknown;
+    versionId: unknown;
+    options: unknown;
+}) => Promise<SlateHandoffRecord>;
+//# sourceMappingURL=slate-handoff.d.ts.map

package/dist/slate-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-handoff.d.ts","sourceRoot":"","sources":["../src/slate-handoff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAerE,eAAO,MAAM,aAAa,GAAU,MAAM;IACxC,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB,KAAG,OAAO,CAAC,kBAAkB,CAkC7B,CAAC"}

package/dist/slate-handoff.js

@@ -0,0 +1,56 @@
+import { SlateError } from './slate-errors.js';
+import { parseHandoffOptions } from './slate-handoff-options.js';
+import { HANDOFF_ID_PATTERN, VERSION_ID_PATTERN, digestOf } from './slate-ids.js';
+import { appendLedger } from './slate-ledger.js';
+import { handoffImagePath } from './slate-view.js';
+import { readVersionBytes, writeImageOnce } from './slate-versions.js';
+import { WORKSPACE_MAX_HANDOFFS } from './slate-workspace-parse.js';
+import { NoWrite, findVersion, mutateWorkspace } from './slate-workspace-store.js';
+/**
+ * Branch and Convert hand-offs: a durable record of what the user asked the
+ * agent to do, with a verified copy of the image it is about. Nothing here
+ * starts work or changes the pick; the agent reads the record through
+ * `design.slate.data` and carries it out (asking before anything that costs
+ * money). The user's own words are stored verbatim and never put in the
+ * message the app sends.
+ */
+const contentDigest = (record) => (digestOf({ kind: record.kind, versionId: record.versionId, sha256: record.sha256, options: record.options }));
+export const recordHandoff = async (args) => {
+    if (typeof args.handoffId !== 'string' || !HANDOFF_ID_PATTERN.test(args.handoffId)) {
+        throw new SlateError('invalid_input', 'handoffId must be a UUID v4 minted when the dialog opened.');
+    }
+    if (typeof args.versionId !== 'string' || !VERSION_ID_PATTERN.test(args.versionId)) {
+        throw new SlateError('invalid_input', 'versionId is not a version id');
+    }
+    const kind = args.kind;
+    if (kind !== 'convert' && kind !== 'branch')
+        throw new SlateError('invalid_input', 'kind must be convert or branch');
+    const options = parseHandoffOptions(kind, args.options);
+    if (!options.ok)
+        throw new SlateError('invalid_input', options.message);
+    const { handoffId, versionId } = args;
+    return mutateWorkspace(args.root, async (ws, context) => {
+        const version = findVersion(ws, versionId);
+        const existing = ws.handoffs.find((entry) => entry.handoffId === handoffId);
+        const wanted = { kind, versionId: version.versionId, sha256: version.sha256, options: options.options };
+        if (existing) {
+            if (contentDigest(existing) !== contentDigest(wanted)) {
+                throw new SlateError('intent_conflict', 'This hand-off id was already used for a different request.');
+            }
+            return new NoWrite(existing);
+        }
+        // Explicit errors for a missing or changed file: only a verified image is handed off.
+        const bytes = await readVersionBytes(args.root, ws, version);
+        const newest = ws.handoffs.at(-1);
+        if (newest && contentDigest(newest) === contentDigest(wanted))
+            return new NoWrite(newest);
+        await writeImageOnce(handoffImagePath(args.runtime.stateRoot, ws.workspaceId, handoffId, version.sha256), bytes, version.sha256);
+        const record = { ...wanted, handoffId, requestedAt: context.now.toISOString() };
+        ws.handoffs.push(record);
+        if (ws.handoffs.length > WORKSPACE_MAX_HANDOFFS)
+            ws.handoffs.splice(0, ws.handoffs.length - WORKSPACE_MAX_HANDOFFS);
+        await appendLedger(args.root, { event: 'handoff', kind, versionId: version.versionId, handoffId, at: context.now.toISOString() });
+        return record;
+    }, { now: args.runtime.now });
+};
+//# sourceMappingURL=slate-handoff.js.map

package/dist/slate-handoff.js.map

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

package/dist/slate-ids.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Id grammar for the design workspace. Every id read from `workspace.json` is
+ * matched against these patterns before it is used to build a path or a
+ * request: the file is untrusted input (see `slate-workspace-parse.ts`).
+ */
+export declare const OP_ID_PATTERN: RegExp;
+export declare const ROUND_ID_PATTERN: RegExp;
+export declare const SLOT_PATTERN: RegExp;
+export declare const LOCAL_SLOT_PATTERN: RegExp;
+export declare const CANDIDATE_ID_PATTERN: RegExp;
+export declare const VERSION_ID_PATTERN: RegExp;
+/** A UUID v4 minted by the app: hand-off ids use the same grammar as op ids. */
+export declare const HANDOFF_ID_PATTERN: RegExp;
+/** A corpus reference id (`PR6:corpus-client.ts` `download`). */
+export declare const REFERENCE_ID_PATTERN: RegExp;
+export declare const SEARCH_ID_PATTERN: RegExp;
+export declare const WORKSPACE_ID_PATTERN: RegExp;
+export declare const SHA256_PATTERN: RegExp;
+export declare const sha256Hex: (value: string | Uint8Array) => string;
+/** The workspace id: stable across restarts, not a secret and not an authority. */
+export declare const workspaceIdFor: (rootRunId: string) => string;
+export declare const roundIdFor: (index: number) => string;
+export declare const candidateIdFor: (roundId: string, slot: string) => string;
+export declare const generationVersionId: (roundId: string, slot: string) => string;
+/** The slot letter an option id ends with: `r3_c` is slot `c`. */
+export declare const slotOfCandidate: (candidateId: string) => string;
+/** An edit version id is derived from its op, so a resumed op recomputes the same id and file name. */
+export declare const editVersionId: (opId: string) => string;
+export declare const slotFor: (index: number) => string;
+/** Canonical JSON: sorted keys, so a digest does not depend on property order. */
+export declare const canonicalJson: (value: unknown) => string;
+export declare const digestOf: (value: unknown) => string;
+//# sourceMappingURL=slate-ids.d.ts.map

package/dist/slate-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-ids.d.ts","sourceRoot":"","sources":["../src/slate-ids.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,eAAO,MAAM,aAAa,QAA2E,CAAC;AACtG,eAAO,MAAM,gBAAgB,QAAwB,CAAC;AACtD,eAAO,MAAM,YAAY,QAAa,CAAC;AACvC,eAAO,MAAM,kBAAkB,QAAa,CAAC;AAC7C,eAAO,MAAM,oBAAoB,QAA8B,CAAC;AAChE,eAAO,MAAM,kBAAkB,QAAkD,CAAC;AAClF,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,QAAgB,CAAC;AAChD,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,QAA8C,CAAC;AAChF,eAAO,MAAM,iBAAiB,QAAoB,CAAC;AACnD,eAAO,MAAM,oBAAoB,QAAoB,CAAC;AACtD,eAAO,MAAM,cAAc,QAAoB,CAAC;AAEhD,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,GAAG,UAAU,KAAG,MAEtD,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,KAAG,MAA2C,CAAC;AAE/F,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAAqB,CAAC;AACjE,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,MAAM,MAAM,KAAG,MAA8B,CAAC;AAC9F,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,EAAE,MAAM,MAAM,KAAG,MAAgC,CAAC;AACrG,kEAAkE;AAClE,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,KAAG,MAA6D,CAAC;AACpH,uGAAuG;AACvG,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAA8C,CAAC;AAE5F,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,KAAG,MAAwD,CAAC;AAEjG,kFAAkF;AAClF,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,MAc9C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,MAAyC,CAAC"}

package/dist/slate-ids.js

@@ -0,0 +1,47 @@
+import { createHash } from 'node:crypto';
+/**
+ * Id grammar for the design workspace. Every id read from `workspace.json` is
+ * matched against these patterns before it is used to build a path or a
+ * request: the file is untrusted input (see `slate-workspace-parse.ts`).
+ */
+export const OP_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u;
+export const ROUND_ID_PATTERN = /^r[1-9][0-9]{0,2}$/u;
+export const SLOT_PATTERN = /^[a-p]$/u;
+export const LOCAL_SLOT_PATTERN = /^[A-P]$/u;
+export const CANDIDATE_ID_PATTERN = /^r[1-9][0-9]{0,2}_[a-p]$/u;
+export const VERSION_ID_PATTERN = /^v_(?:r[1-9][0-9]{0,2}_[a-p]|e[0-9a-f]{12})$/u;
+/** A UUID v4 minted by the app: hand-off ids use the same grammar as op ids. */
+export const HANDOFF_ID_PATTERN = OP_ID_PATTERN;
+/** A corpus reference id (`PR6:corpus-client.ts` `download`). */
+export const REFERENCE_ID_PATTERN = /^(?:gen|logo-gen)-[A-Za-z0-9._-]{1,120}$/u;
+export const SEARCH_ID_PATTERN = /^[0-9a-f]{16}$/u;
+export const WORKSPACE_ID_PATTERN = /^[0-9a-f]{16}$/u;
+export const SHA256_PATTERN = /^[0-9a-f]{64}$/u;
+export const sha256Hex = (value) => (createHash('sha256').update(value).digest('hex'));
+/** The workspace id: stable across restarts, not a secret and not an authority. */
+export const workspaceIdFor = (rootRunId) => sha256Hex(rootRunId).slice(0, 16);
+export const roundIdFor = (index) => `r${index}`;
+export const candidateIdFor = (roundId, slot) => `${roundId}_${slot}`;
+export const generationVersionId = (roundId, slot) => `v_${roundId}_${slot}`;
+/** The slot letter an option id ends with: `r3_c` is slot `c`. */
+export const slotOfCandidate = (candidateId) => candidateId.slice(candidateId.lastIndexOf('_') + 1);
+/** An edit version id is derived from its op, so a resumed op recomputes the same id and file name. */
+export const editVersionId = (opId) => `v_e${sha256Hex(opId).slice(0, 12)}`;
+export const slotFor = (index) => String.fromCharCode('a'.charCodeAt(0) + index);
+/** Canonical JSON: sorted keys, so a digest does not depend on property order. */
+export const canonicalJson = (value) => {
+    const visit = (node) => {
+        if (Array.isArray(node))
+            return node.map(visit);
+        if (node && typeof node === 'object') {
+            return Object.fromEntries(Object.entries(node)
+                .filter(([, entry]) => entry !== undefined)
+                .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+                .map(([key, entry]) => [key, visit(entry)]));
+        }
+        return node;
+    };
+    return JSON.stringify(visit(value));
+};
+export const digestOf = (value) => sha256Hex(canonicalJson(value));
+//# sourceMappingURL=slate-ids.js.map

package/dist/slate-ids.js.map

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