@12ui/design 0.2.72 → 0.2.74

package/dist/slate-handoff-options.js

@@ -0,0 +1,117 @@
+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; 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 (value.explanation !== undefined && value.explanation !== null && typeof value.explanation !== 'string')
+        return no('options.explanation must be text');
+    const explanation = cleanExplanation(value.explanation ?? '');
+    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', '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('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`;
+    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`;
+    if (options.output === 'react')
+        return 'React (whole-page JSX and CSS) from the local Codex engine';
+    if (options.output === 'assets')
+        return 'image assets (the cut-out files) from the local Codex engine';
+    return 'HTML from the local Codex engine';
+};
+//# 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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"}

package/dist/slate-image-executor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * How the runner draws an image: one call to the local Codex CLI's native
+ * image tool, through the repo's own headless executor
+ * (`packages/codex-conversion/src/images/native.mjs`, shipped in the CLI's
+ * `runtime/`). It runs on the user's ChatGPT plan, never with an API key, in an
+ * isolated `CODEX_HOME` that links only `auth.json`.
+ *
+ * The call store makes each call id a durable identity: an id whose call
+ * already produced an image returns it without another call, and an id whose
+ * call died after dispatch is recovered from its own rollout or refused, never
+ * dispatched twice. The runner names calls `slate-<opId>-<slot>` and
+ * `slate-<opId>`, so a resumed op replays the same ids.
+ */
+export type SlateImageCall = {
+    callId: string;
+    /** The image prompt, sent verbatim. */
+    prompt: string;
+    /** Attached images in order; the first is the primary. */
+    images: Buffer[];
+    /** The frame the result is stretched to exactly. */
+    expected: {
+        width: number;
+        height: number;
+    };
+};
+export type SlateImageResult = {
+    png: Buffer;
+    reused: boolean;
+};
+export type SlateImageExecutor = {
+    generate: (call: SlateImageCall) => Promise<SlateImageResult>;
+};
+/** One image call may run this long before it is stopped. */
+export declare const IMAGE_CALL_TIMEOUT_MS: number;
+export declare const createNativeImageExecutor: (args: {
+    root: string;
+    env?: NodeJS.ProcessEnv;
+}) => SlateImageExecutor;
+//# sourceMappingURL=slate-image-executor.d.ts.map

package/dist/slate-image-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-image-executor.d.ts","sourceRoot":"","sources":["../src/slate-image-executor.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAAE,CAAC;AAEnG,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,QAAc,CAAC;AAmBjD,eAAO,MAAM,yBAAyB,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAAG,kBAoC3F,CAAC"}

package/dist/slate-image-executor.js

@@ -0,0 +1,52 @@
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { resolveCodexBinary } from './slate-local-image.js';
+/** One image call may run this long before it is stopped. */
+export const IMAGE_CALL_TIMEOUT_MS = 15 * 60_000;
+const importRuntime = async () => {
+    const base = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'runtime', 'codex-conversion', 'src');
+    const load = async (file) => await import(pathToFileURL(path.join(base, file)).href);
+    const [store, native] = await Promise.all([load('run-store.mjs'), load('images/native.mjs')]);
+    return { ...store, ...native };
+};
+const sha256 = (bytes) => createHash('sha256').update(bytes).digest('hex');
+export const createNativeImageExecutor = (args) => {
+    const env = args.env ?? process.env;
+    return {
+        generate: async (call) => {
+            const runtime = await importRuntime();
+            // The store keeps one folder per call id under `<root>/calls/`.
+            const store = runtime.createStore(args.root);
+            const request = {
+                backend: 'native',
+                model: 'gpt-6-astra',
+                effort: 'medium',
+                imageModel: null,
+                normalization: 'exact-stretch-lanczos3',
+                expected: call.expected,
+                prompt: call.prompt,
+                inputSha256: call.images.map(sha256),
+            };
+            const result = await runtime.executeNativeCall({
+                request,
+                input: call.images,
+                callId: call.callId,
+                store,
+                codexBinary: resolveCodexBinary(env),
+                ...(env.CODEX_HOME?.trim() ? { codexHome: env.CODEX_HOME.trim() } : {}),
+                timeoutMs: IMAGE_CALL_TIMEOUT_MS,
+            });
+            try {
+                const decoded = await runtime.decodeNativeResponse(result.bytes);
+                return { png: decoded.png, reused: result.reused };
+            }
+            catch (cause) {
+                // The call ended without one usable image. The store already holds its outcome, so a replay
+                // answers the same way: the id needs a person's inspection, never a second dispatch.
+                throw Object.assign(new Error(`Call ${call.callId} returned no usable image and needs reconciliation`), { code: 'NEEDS_RECONCILIATION', cause });
+            }
+        },
+    };
+};
+//# sourceMappingURL=slate-image-executor.js.map

package/dist/slate-image-executor.js.map

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

package/dist/slate-inspiration.d.ts

@@ -0,0 +1,22 @@
+import type { SlateRuntime } from './slate-runtime.js';
+import type { SlateSearch } from './slate-workspace-types.js';
+/**
+ * Inspiration: a free corpus search and a local selection. The search asks the
+ * public tier (balanced mode, at most 24 references, no account); the
+ * selection is a list of at most eight reference ids the next round is
+ * drawn from. Neither starts any work.
+ */
+export declare const DEFAULT_SEARCH_COUNT = 12;
+export declare const runSearch: (args: {
+    runtime: SlateRuntime;
+    root: string;
+    query: unknown;
+    count: unknown;
+}) => Promise<SlateSearch>;
+/** Replace the whole selection: two views can never diverge by racing toggles. */
+export declare const setSelection: (args: {
+    runtime: SlateRuntime;
+    root: string;
+    referenceIds: unknown;
+}) => Promise<string[]>;
+//# sourceMappingURL=slate-inspiration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slate-inspiration.d.ts","sourceRoot":"","sources":["../src/slate-inspiration.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;GAKG;AAEH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAyBvC,eAAO,MAAM,SAAS,GAAU,MAAM;IACpC,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,KAAG,OAAO,CAAC,WAAW,CAiDtB,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,YAAY,GAAU,MAAM;IACvC,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;CACvB,KAAG,OAAO,CAAC,MAAM,EAAE,CAmBnB,CAAC"}

package/dist/slate-inspiration.js

@@ -0,0 +1,112 @@
+import { PUBLIC_CORPUS_MAX_COUNT } from './corpus-access.js';
+import { cleanUserText } from './slate-actions.js';
+import { corpusFailure } from './slate-corpus.js';
+import { SlateError } from './slate-errors.js';
+import { REFERENCE_ID_PATTERN, sha256Hex } from './slate-ids.js';
+import { appendLedger } from './slate-ledger.js';
+import { namedReferenceIds } from './slate-reference-ids.js';
+import { metaFromItem } from './slate-round-search.js';
+import { SEARCH_QUERY_MAX_CHARACTERS, WORKSPACE_MAX_SEARCHES, WORKSPACE_MAX_SELECTED, } from './slate-workspace-parse.js';
+import { NoWrite, loadWorkspaceAt, mutateWorkspace } from './slate-workspace-store.js';
+/**
+ * Inspiration: a free corpus search and a local selection. The search asks the
+ * public tier (balanced mode, at most 24 references, no account); the
+ * selection is a list of at most eight reference ids the next round is
+ * drawn from. Neither starts any work.
+ */
+export const DEFAULT_SEARCH_COUNT = 12;
+const normalizeQuery = (value) => {
+    if (typeof value !== 'string')
+        throw new SlateError('invalid_input', 'query must be text');
+    const query = cleanUserText(value).replace(/\s+/gu, ' ');
+    if (!query)
+        throw new SlateError('invalid_input', 'Type something to search for.');
+    if ([...query].length > SEARCH_QUERY_MAX_CHARACTERS) {
+        throw new SlateError('invalid_input', `A search can be at most ${SEARCH_QUERY_MAX_CHARACTERS} characters.`);
+    }
+    return query;
+};
+const normalizeCount = (value) => {
+    if (value === undefined || value === null)
+        return DEFAULT_SEARCH_COUNT;
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 1 || value > PUBLIC_CORPUS_MAX_COUNT) {
+        throw new SlateError('invalid_input', `count must be an integer from 1 to ${PUBLIC_CORPUS_MAX_COUNT}`);
+    }
+    return value;
+};
+/** One identical search is one corpus query: its key is derived from the workspace, the words and the count. */
+const searchDigest = (workspaceId, query, count) => (sha256Hex(`${workspaceId}|${query.toLowerCase()}|${count}`));
+export const runSearch = async (args) => {
+    const query = normalizeQuery(args.query);
+    const count = normalizeCount(args.count);
+    const { workspace } = await loadWorkspaceAt(args.root, args.runtime.now);
+    const digest = searchDigest(workspace.workspaceId, query, count);
+    const searchId = digest.slice(0, 16);
+    // An identical search is answered from the record: no request, none of the daily allowance.
+    const stored = workspace.inspiration.searches.find((entry) => entry.searchId === searchId);
+    if (stored) {
+        if (workspace.inspiration.searches.at(-1)?.searchId !== searchId) {
+            await mutateWorkspace(args.root, (ws) => {
+                const index = ws.inspiration.searches.findIndex((entry) => entry.searchId === searchId);
+                if (index < 0 || index === ws.inspiration.searches.length - 1)
+                    return new NoWrite(undefined);
+                ws.inspiration.searches.push(...ws.inspiration.searches.splice(index, 1));
+                return undefined;
+            }, { now: args.runtime.now });
+        }
+        return stored;
+    }
+    let items;
+    try {
+        items = (await args.runtime.corpus().inspire({ q: query, mode: 'balanced', k: count }, { idempotencyKey: `slate-search-${digest}` })).items;
+    }
+    catch (error) {
+        throw corpusFailure(error);
+    }
+    const usable = items.filter((item, index) => REFERENCE_ID_PATTERN.test(item.id) && items.findIndex((other) => other.id === item.id) === index);
+    return mutateWorkspace(args.root, async (ws, context) => {
+        const existing = ws.inspiration.searches.find((entry) => entry.searchId === searchId);
+        if (existing)
+            return new NoWrite(existing);
+        const search = {
+            searchId,
+            query,
+            mode: 'balanced',
+            at: context.now.toISOString(),
+            referenceIds: usable.map((item) => item.id),
+        };
+        ws.inspiration.searches.push(search);
+        if (ws.inspiration.searches.length > WORKSPACE_MAX_SEARCHES) {
+            ws.inspiration.searches.splice(0, ws.inspiration.searches.length - WORKSPACE_MAX_SEARCHES);
+        }
+        for (const item of usable)
+            ws.references[item.id] = metaFromItem(item);
+        await appendLedger(args.root, { event: 'search', searchId, count, found: usable.length, at: search.at });
+        return search;
+    }, { now: args.runtime.now });
+};
+/** Replace the whole selection: two views can never diverge by racing toggles. */
+export const setSelection = async (args) => {
+    const ids = args.referenceIds;
+    if (!Array.isArray(ids) || ids.some((id) => typeof id !== 'string' || !REFERENCE_ID_PATTERN.test(id))) {
+        throw new SlateError('invalid_input', 'referenceIds must be a list of reference ids');
+    }
+    const wanted = ids;
+    if (new Set(wanted).size !== wanted.length)
+        throw new SlateError('invalid_input', 'referenceIds must not repeat');
+    if (wanted.length > WORKSPACE_MAX_SELECTED)
+        throw new SlateError('invalid_input', `At most ${WORKSPACE_MAX_SELECTED} references can be selected.`);
+    return mutateWorkspace(args.root, async (ws, context) => {
+        const named = new Set(namedReferenceIds(ws));
+        const unknown = wanted.find((id) => !named.has(id));
+        if (unknown)
+            throw new SlateError('unknown_reference', `${unknown} is not in a round, a search or the selection of this workspace.`);
+        if (ws.inspiration.selected.length === wanted.length && ws.inspiration.selected.every((id, index) => id === wanted[index])) {
+            return new NoWrite([...ws.inspiration.selected]);
+        }
+        ws.inspiration.selected = wanted;
+        await appendLedger(args.root, { event: 'inspiration', selected: wanted.length, at: context.now.toISOString() });
+        return [...wanted];
+    }, { now: args.runtime.now });
+};
+//# sourceMappingURL=slate-inspiration.js.map

package/dist/slate-inspiration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-inspiration.js","sourceRoot":"","sources":["../src/slate-inspiration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGvF;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAU,EAAE;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;IAC3F,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,+BAA+B,CAAC,CAAC;IACnF,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,GAAG,2BAA2B,EAAE,CAAC;QACpD,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,2BAA2B,2BAA2B,cAAc,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,KAAc,EAAU,EAAE;IAChD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,oBAAoB,CAAC;IACvE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,uBAAuB,EAAE,CAAC;QAC9G,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,sCAAsC,uBAAuB,EAAE,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,gHAAgH;AAChH,MAAM,YAAY,GAAG,CAAC,WAAmB,EAAE,KAAa,EAAE,KAAa,EAAU,EAAE,CAAC,CAClF,SAAS,CAAC,GAAG,WAAW,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC,CAC5D,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,IAK/B,EAAwB,EAAE;IACzB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAErC,4FAA4F;IAC5F,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC3F,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjE,MAAM,eAAe,CAAO,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;gBAC5C,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;gBACxF,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC7F,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1E,OAAO,SAAS,CAAC;YACnB,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO,CAC1C,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,EACxC,EAAE,cAAc,EAAE,gBAAgB,MAAM,EAAE,EAAE,CAC7C,CAAC,CAAC,KAAK,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC;IAC/I,OAAO,eAAe,CAAc,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;QACnE,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACtF,IAAI,QAAQ;YAAE,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAgB;YAC1B,QAAQ;YACR,KAAK;YACL,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE;YAC7B,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5C,CAAC;QACF,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;YAC5D,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,GAAG,sBAAsB,CAAC,CAAC;QAC7F,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,MAAM;YAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACzG,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,IAIlC,EAAqB,EAAE;IACtB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACtG,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,8CAA8C,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,MAAM,GAAG,GAAe,CAAC;IAC/B,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,8BAA8B,CAAC,CAAC;IAClH,IAAI,MAAM,CAAC,MAAM,GAAG,sBAAsB;QAAE,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,WAAW,sBAAsB,8BAA8B,CAAC,CAAC;IACnJ,OAAO,eAAe,CAAW,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,OAAO;YAAE,MAAM,IAAI,UAAU,CAAC,mBAAmB,EAAE,GAAG,OAAO,kEAAkE,CAAC,CAAC;QACrI,IAAI,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC3H,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,EAAE,CAAC,WAAW,CAAC,QAAQ,GAAG,MAAM,CAAC;QACjC,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAChH,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IACrB,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAChC,CAAC,CAAC"}

package/dist/slate-labels.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Option and version labels. Options are lettered in allocation order across
+ * rounds, A to Z and then AA, AB, ... (spreadsheet column order); labels are
+ * never reused. A version label is the option label plus its number above 1.
+ */
+export declare const optionLabelFor: (index: number) => string;
+export declare const optionIndexOf: (label: string) => number;
+/** The next `count` labels after the highest one ever allocated. */
+export declare const nextOptionLabels: (existing: readonly string[], count: number) => string[];
+export declare const versionLabelFor: (optionLabel: string, n: number) => string;
+//# sourceMappingURL=slate-labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slate-labels.d.ts","sourceRoot":"","sources":["../src/slate-labels.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAU9C,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAK7C,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,GAAI,UAAU,SAAS,MAAM,EAAE,EAAE,OAAO,MAAM,KAAG,MAAM,EAGnF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,EAAE,GAAG,MAAM,KAAG,MAEhE,CAAC"}

package/dist/slate-labels.js

@@ -0,0 +1,32 @@
+/**
+ * Option and version labels. Options are lettered in allocation order across
+ * rounds, A to Z and then AA, AB, ... (spreadsheet column order); labels are
+ * never reused. A version label is the option label plus its number above 1.
+ */
+export const optionLabelFor = (index) => {
+    if (!Number.isInteger(index) || index < 0)
+        throw new Error(`option index ${index} is not a non-negative integer`);
+    let remaining = index + 1;
+    let label = '';
+    while (remaining > 0) {
+        const digit = (remaining - 1) % 26;
+        label = String.fromCharCode(65 + digit) + label;
+        remaining = Math.floor((remaining - 1) / 26);
+    }
+    return label;
+};
+export const optionIndexOf = (label) => {
+    if (!/^[A-Z]{1,3}$/u.test(label))
+        throw new Error(`${JSON.stringify(label)} is not an option label`);
+    let value = 0;
+    for (const character of label)
+        value = value * 26 + (character.charCodeAt(0) - 64);
+    return value - 1;
+};
+/** The next `count` labels after the highest one ever allocated. */
+export const nextOptionLabels = (existing, count) => {
+    const next = existing.reduce((highest, label) => Math.max(highest, optionIndexOf(label) + 1), 0);
+    return Array.from({ length: count }, (_unused, offset) => optionLabelFor(next + offset));
+};
+export const versionLabelFor = (optionLabel, n) => (n > 1 ? `${optionLabel}${n}` : optionLabel);
+//# sourceMappingURL=slate-labels.js.map

package/dist/slate-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-labels.js","sourceRoot":"","sources":["../src/slate-labels.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE;IACtD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,gCAAgC,CAAC,CAAC;IAClH,IAAI,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,OAAO,SAAS,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QACnC,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;QAChD,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE;IACrD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACrG,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,SAAS,IAAI,KAAK;QAAE,KAAK,GAAG,KAAK,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACnF,OAAO,KAAK,GAAG,CAAC,CAAC;AACnB,CAAC,CAAC;AAEF,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAA2B,EAAE,KAAa,EAAY,EAAE;IACvF,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjG,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC;AAC3F,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,WAAmB,EAAE,CAAS,EAAU,EAAE,CAAC,CACzE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAC3C,CAAC"}