@12ui/design 0.2.71 → 0.2.73

package/dist/scene/spec-expression.js

@@ -0,0 +1,234 @@
+/**
+ * A safe compiler for the maths a camera spec writes in its world coordinates.
+ *
+ * Specs written for the Python solver use Python expression syntax ("D/2",
+ * "-0.5*cos(t)+D/2*sin(t)", "W**2"), which Python evaluated with `eval`. This
+ * accepts exactly the arithmetic subset: numbers, the spec's free names, the
+ * constants pi e tau inf nan, `+ - * / // % **`, unary signs, parentheses, and
+ * calls to the math functions below. Anything else (attribute access, strings,
+ * subscripts, unknown names) is refused with the landmark and the offending
+ * token named, before any solve starts.
+ */
+export class SpecExpressionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SpecExpressionError';
+    }
+}
+const pythonMod = (a, b) => {
+    if (b === 0)
+        return Number.NaN;
+    const r = a % b;
+    return r !== 0 && (r < 0) !== (b < 0) ? r + b : r;
+};
+const MATH_FUNCTIONS = {
+    sin: { arity: [1, 1], apply: Math.sin },
+    cos: { arity: [1, 1], apply: Math.cos },
+    tan: { arity: [1, 1], apply: Math.tan },
+    asin: { arity: [1, 1], apply: Math.asin },
+    acos: { arity: [1, 1], apply: Math.acos },
+    atan: { arity: [1, 1], apply: Math.atan },
+    atan2: { arity: [2, 2], apply: Math.atan2 },
+    sinh: { arity: [1, 1], apply: Math.sinh },
+    cosh: { arity: [1, 1], apply: Math.cosh },
+    tanh: { arity: [1, 1], apply: Math.tanh },
+    asinh: { arity: [1, 1], apply: Math.asinh },
+    acosh: { arity: [1, 1], apply: Math.acosh },
+    atanh: { arity: [1, 1], apply: Math.atanh },
+    exp: { arity: [1, 1], apply: Math.exp },
+    exp2: { arity: [1, 1], apply: (x) => 2 ** x },
+    expm1: { arity: [1, 1], apply: Math.expm1 },
+    log: { arity: [1, 2], apply: (x, base) => (base === undefined ? Math.log(x) : Math.log(x) / Math.log(base)) },
+    log10: { arity: [1, 1], apply: Math.log10 },
+    log2: { arity: [1, 1], apply: Math.log2 },
+    log1p: { arity: [1, 1], apply: Math.log1p },
+    sqrt: { arity: [1, 1], apply: Math.sqrt },
+    cbrt: { arity: [1, 1], apply: Math.cbrt },
+    pow: { arity: [2, 2], apply: (x, y) => x ** y },
+    fabs: { arity: [1, 1], apply: Math.abs },
+    floor: { arity: [1, 1], apply: Math.floor },
+    ceil: { arity: [1, 1], apply: Math.ceil },
+    trunc: { arity: [1, 1], apply: Math.trunc },
+    degrees: { arity: [1, 1], apply: (x) => (x * 180) / Math.PI },
+    radians: { arity: [1, 1], apply: (x) => (x * Math.PI) / 180 },
+    hypot: { arity: [1, 64], apply: Math.hypot },
+    copysign: { arity: [2, 2], apply: (x, y) => (Object.is(Math.sign(y), -0) || y < 0 ? -Math.abs(x) : Math.abs(x)) },
+    fmod: { arity: [2, 2], apply: (x, y) => x % y },
+};
+const CONSTANTS = {
+    pi: Math.PI,
+    e: Math.E,
+    tau: 2 * Math.PI,
+    inf: Number.POSITIVE_INFINITY,
+    nan: Number.NaN,
+};
+export const SPEC_MATH_FUNCTIONS = Object.keys(MATH_FUNCTIONS);
+const tokenize = (source, where) => {
+    const tokens = [];
+    let index = 0;
+    while (index < source.length) {
+        const rest = source.slice(index);
+        const space = /^\s+/u.exec(rest);
+        if (space) {
+            index += space[0].length;
+            continue;
+        }
+        const number = /^(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?/u.exec(rest);
+        if (number) {
+            tokens.push({ kind: 'number', value: Number(number[0]), text: number[0] });
+            index += number[0].length;
+            continue;
+        }
+        const name = /^[A-Za-z_][A-Za-z0-9_]*/u.exec(rest);
+        if (name) {
+            tokens.push({ kind: 'name', text: name[0] });
+            index += name[0].length;
+            continue;
+        }
+        const op = /^(?:\*\*|\/\/|[-+*/%(),])/u.exec(rest);
+        if (op) {
+            tokens.push({ kind: 'op', text: op[0] });
+            index += op[0].length;
+            continue;
+        }
+        throw new SpecExpressionError(`${where}: "${source}" uses ${JSON.stringify(rest[0])}, which a spec expression cannot contain.`
+            + ' Use numbers, the free names, + - * / // % **, parentheses and math functions.');
+    }
+    return tokens;
+};
+/**
+ * Compiles one coordinate expression. `names` are the spec's free names in the
+ * order the solver passes their values; a free name shadows a constant or
+ * function of the same spelling, as it did in the Python evaluator.
+ */
+export const compileSpecExpression = (source, names, where) => {
+    const tokens = tokenize(source, where);
+    let position = 0;
+    const peek = () => tokens[position];
+    const isOp = (text) => {
+        const token = peek();
+        return token?.kind === 'op' && token.text === text;
+    };
+    const fail = (detail) => {
+        throw new SpecExpressionError(`${where}: "${source}" ${detail}`);
+    };
+    const expect = (text) => {
+        if (!isOp(text))
+            fail(`expects ${JSON.stringify(text)} at ${describe(peek())}`);
+        position += 1;
+    };
+    const describe = (token) => (token ? JSON.stringify(token.text) : 'the end');
+    const expression = () => {
+        let left = term();
+        while (isOp('+') || isOp('-')) {
+            const op = peek().text;
+            position += 1;
+            const right = term();
+            const l = left;
+            left = op === '+' ? (v) => l(v) + right(v) : (v) => l(v) - right(v);
+        }
+        return left;
+    };
+    const term = () => {
+        let left = unary();
+        while (isOp('*') || isOp('/') || isOp('//') || isOp('%')) {
+            const op = peek().text;
+            position += 1;
+            const right = unary();
+            const l = left;
+            left = op === '*' ? (v) => l(v) * right(v)
+                : op === '/' ? (v) => l(v) / right(v)
+                    : op === '//' ? (v) => Math.floor(l(v) / right(v))
+                        : (v) => pythonMod(l(v), right(v));
+        }
+        return left;
+    };
+    const unary = () => {
+        if (isOp('-')) {
+            position += 1;
+            const operand = unary();
+            return (v) => -operand(v);
+        }
+        if (isOp('+')) {
+            position += 1;
+            return unary();
+        }
+        return power();
+    };
+    // Python: power ::= primary ["**" u_expr], so -2**2 is -4 and 2**-1 is 0.5.
+    const power = () => {
+        const base = atom();
+        if (!isOp('**'))
+            return base;
+        position += 1;
+        const exponent = unary();
+        return (v) => base(v) ** exponent(v);
+    };
+    const atom = () => {
+        const token = peek();
+        if (!token)
+            return fail('ends where a value is expected');
+        if (token.kind === 'number') {
+            position += 1;
+            const value = token.value;
+            return () => value;
+        }
+        if (isOp('(')) {
+            position += 1;
+            const inner = expression();
+            expect(')');
+            return inner;
+        }
+        if (token.kind === 'name') {
+            position += 1;
+            const freeIndex = names.indexOf(token.text);
+            if (freeIndex >= 0) {
+                if (isOp('('))
+                    fail(`calls the free name ${JSON.stringify(token.text)} as a function`);
+                return (v) => v[freeIndex];
+            }
+            const fn = Object.hasOwn(MATH_FUNCTIONS, token.text) ? MATH_FUNCTIONS[token.text] : undefined;
+            if (fn) {
+                if (!isOp('('))
+                    fail(`uses the function ${JSON.stringify(token.text)} without calling it`);
+                position += 1;
+                const args = [];
+                if (!isOp(')')) {
+                    args.push(expression());
+                    while (isOp(',')) {
+                        position += 1;
+                        if (isOp(')'))
+                            break;
+                        args.push(expression());
+                    }
+                }
+                expect(')');
+                const [min, max] = fn.arity;
+                if (args.length < min || args.length > max) {
+                    fail(`calls ${token.text} with ${args.length} argument(s)`);
+                }
+                return (v) => fn.apply(...args.map((arg) => arg(v)));
+            }
+            if (Object.hasOwn(CONSTANTS, token.text)) {
+                const value = CONSTANTS[token.text];
+                return () => value;
+            }
+            return fail(`names ${JSON.stringify(token.text)}, which is neither a free name`
+                + ` (${names.length ? names.join(', ') : 'none declared'}) nor a math function or constant.`);
+        }
+        return fail(`has ${describe(token)} where a value is expected`);
+    };
+    const compiled = expression();
+    if (position < tokens.length)
+        fail(`has an unexpected ${describe(peek())}`);
+    return compiled;
+};
+/** A spec coordinate: a JSON number, or an expression string. */
+export const compileSpecCoordinate = (value, names, where) => {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return () => value;
+    if (typeof value === 'string')
+        return compileSpecExpression(value, names, where);
+    throw new SpecExpressionError(`${where}: ${JSON.stringify(value)} is not a number or an expression string`);
+};
+//# sourceMappingURL=spec-expression.js.map

package/dist/scene/spec-expression.js.map

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

package/dist/scene/static-server.d.ts

@@ -0,0 +1,13 @@
+export declare const contentTypeFor: (file: string) => string;
+/** The file a request path names inside `root`, or null when it would leave the folder. */
+export declare const resolveInsideRoot: (root: string, requestPath: string) => string | null;
+export type StaticServer = {
+    url: string;
+    port: number;
+    close: () => Promise<void>;
+};
+export declare const startStaticServer: (args: {
+    directory: string;
+    port: number;
+}) => Promise<StaticServer>;
+//# sourceMappingURL=static-server.d.ts.map

package/dist/scene/static-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-server.d.ts","sourceRoot":"","sources":["../../src/scene/static-server.ts"],"names":[],"mappings":"AAgCA,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MAE7C,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,aAAa,MAAM,KAAG,MAAM,GAAG,IAW9E,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAErF,eAAO,MAAM,iBAAiB,GAAU,MAAM;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,YAAY,CA8CvG,CAAC"}

package/dist/scene/static-server.js

@@ -0,0 +1,99 @@
+import { createReadStream } from 'node:fs';
+import { realpath, stat } from 'node:fs/promises';
+import http from 'node:http';
+import path from 'node:path';
+/**
+ * A static file server for one scene folder, bound to 127.0.0.1 only. It
+ * serves nothing outside the folder (a `..` or a symlink out of it is a 403)
+ * and never caches, so every capture sees the files as they are now.
+ */
+const CONTENT_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.json': 'application/json',
+    '.glb': 'model/gltf-binary',
+    '.gltf': 'model/gltf+json',
+    '.bin': 'application/octet-stream',
+    '.ttf': 'font/ttf',
+    '.otf': 'font/otf',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+};
+export const contentTypeFor = (file) => (CONTENT_TYPES[path.extname(file).toLowerCase()] ?? 'application/octet-stream');
+/** The file a request path names inside `root`, or null when it would leave the folder. */
+export const resolveInsideRoot = (root, requestPath) => {
+    let decoded;
+    try {
+        decoded = decodeURIComponent(requestPath.split('?')[0].split('#')[0]);
+    }
+    catch {
+        return null;
+    }
+    if (decoded.includes('\0'))
+        return null;
+    const resolved = path.resolve(root, `.${path.posix.normalize(`/${decoded}`)}`);
+    const withIndex = decoded.endsWith('/') ? path.join(resolved, 'index.html') : resolved;
+    return withIndex === root || withIndex.startsWith(`${root}${path.sep}`) ? withIndex : null;
+};
+export const startStaticServer = async (args) => {
+    const root = await realpath(path.resolve(args.directory));
+    const server = http.createServer((request, response) => {
+        const refuse = (status) => {
+            response.writeHead(status, { 'cache-control': 'no-store' });
+            response.end();
+        };
+        if (request.method !== 'GET' && request.method !== 'HEAD')
+            return refuse(405);
+        const candidate = resolveInsideRoot(root, request.url ?? '/');
+        if (!candidate)
+            return refuse(403);
+        void (async () => {
+            let file = candidate;
+            try {
+                if ((await stat(file)).isDirectory())
+                    file = path.join(file, 'index.html');
+                const real = await realpath(file);
+                if (real !== root && !real.startsWith(`${root}${path.sep}`))
+                    return refuse(403);
+                const info = await stat(real);
+                if (!info.isFile())
+                    return refuse(404);
+                response.writeHead(200, {
+                    'content-type': contentTypeFor(real),
+                    'content-length': info.size,
+                    'cache-control': 'no-store',
+                });
+                if (request.method === 'HEAD')
+                    return response.end();
+                createReadStream(real).on('error', () => response.destroy()).pipe(response);
+            }
+            catch {
+                refuse(404);
+            }
+        })();
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(args.port, '127.0.0.1', () => {
+            server.off('error', reject);
+            resolve();
+        });
+    });
+    const port = server.address().port;
+    return {
+        url: `http://127.0.0.1:${port}/`,
+        port,
+        close: () => new Promise((resolve) => {
+            server.close(() => resolve());
+            server.closeAllConnections();
+        }),
+    };
+};
+//# sourceMappingURL=static-server.js.map

package/dist/scene/static-server.js.map

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

package/dist/server.d.ts

@@ -1,6 +1,26 @@
-import type { ConversionConfig } from './config.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { type ConversionConfig, type CorpusConfig } from './config.js';
+import { type SlateToolContext } from './mcp-slate-tools.js';
 export type McpServerOptions = {
-    config: ConversionConfig;
+    /**
+     * The 12ui service configuration, or a function that reads it. A function is
+     * called when a hosted tool is first used, so the server can start, and serve
+     * the local workflow and slate tools, on a machine that has no 12ui
+     * credentials yet; hosted tools then fail with the missing-credential error
+     * instead of the server refusing to start. Nothing paid runs without a
+     * configuration.
+     */
+    config: ConversionConfig | (() => ConversionConfig);
+    /** Separate optional-auth resolver: public corpus tools never resolve hosted auth. */
+    corpusConfig?: CorpusConfig | (() => CorpusConfig);
+    /**
+     * Where the workspace looks for the most recent draft run, where per-user
+     * state lives, the runner launcher, the free corpus and the local image
+     * readiness probe. Tests inject fixtures. The workspace uses no 12ui account.
+     */
+    slate?: SlateToolContext;
 };
+/** Construct the transport without reading credentials; local workflow and slate tools need none. */
+export declare const createMcpServer: (options: McpServerOptions) => Server;
 export declare function startMcpServer(options: McpServerOptions): Promise<void>;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD,MAAM,MAAM,gBAAgB,GAAG;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE5D,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe7E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAWnE,OAAO,EAAoB,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAWzF,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;;;;;OAOG;IACH,MAAM,EAAE,gBAAgB,GAAG,CAAC,MAAM,gBAAgB,CAAC,CAAC;IACpD,sFAAsF;IACtF,YAAY,CAAC,EAAE,YAAY,GAAG,CAAC,MAAM,YAAY,CAAC,CAAC;IACnD;;;;OAIG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,qGAAqG;AACrG,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,MA4C3D,CAAC;AAEF,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7E"}

package/dist/server.js

@@ -1,16 +1,52 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { PACKAGE_NAME, packageIdentity } from './client-version.js';
+import { readCorpusConfig } from './config.js';
 import { MCP_TOOL_DEFINITIONS } from './mcp-tool-definitions.js';
-import { callMcpTool, createMcpToolDependencies } from './mcp-tool-handler.js';
-export async function startMcpServer(options) {
-    const dependencies = createMcpToolDependencies(options.config);
-    const server = new Server({ name: PACKAGE_NAME, version: packageIdentity().version }, { capabilities: { tools: {} } });
+import { callMcpTool, createMcpCorpusDependencies, createMcpToolDependencies, } from './mcp-tool-handler.js';
+import { lazyCorpus } from './slate-corpus.js';
+import { listSlateResources, readSlateResource } from './mcp-slate-resource.js';
+import { SLATE_TOOL_DEFINITIONS, createSlateToolHandler, isSlateTool, } from './mcp-slate-tools.js';
+/** Construct the transport without reading credentials; local workflow and slate tools need none. */
+export const createMcpServer = (options) => {
+    let dependencies;
+    let corpus;
+    const resolveConfig = () => (typeof options.config === 'function' ? options.config() : options.config);
+    const resolveCorpusConfig = () => {
+        const config = options.corpusConfig ?? (typeof options.config === 'object' ? options.config : undefined);
+        return config ? (typeof config === 'function' ? config() : config) : readCorpusConfig();
+    };
+    const corpusDependencies = () => {
+        corpus ??= createMcpCorpusDependencies(resolveCorpusConfig());
+        return corpus;
+    };
+    const hostedDependencies = () => {
+        dependencies ??= createMcpToolDependencies(resolveConfig());
+        return dependencies;
+    };
+    const slateTools = createSlateToolHandler({
+        // The workspace's free reference search reads the same optional-auth corpus configuration, lazily.
+        corpus: lazyCorpus(resolveCorpusConfig),
+        ...options.slate,
+    });
+    const server = new Server({ name: PACKAGE_NAME, version: packageIdentity().version }, { capabilities: { tools: {}, resources: {} } });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: MCP_TOOL_DEFINITIONS,
+        tools: [...MCP_TOOL_DEFINITIONS, ...SLATE_TOOL_DEFINITIONS],
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        if (isSlateTool(name))
+            return slateTools(name, args);
+        return await callMcpTool(name, args, hostedDependencies, undefined, corpusDependencies);
+    });
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: listSlateResources(),
     }));
-    server.setRequestHandler(CallToolRequestSchema, async (request) => (await callMcpTool(request.params.name, request.params.arguments, dependencies)));
-    await server.connect(new StdioServerTransport());
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => (readSlateResource(request.params.uri)));
+    return server;
+};
+export async function startMcpServer(options) {
+    await createMcpServer(options).connect(new StdioServerTransport());
 }
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEnG,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAI/E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAyB;IAC5D,MAAM,YAAY,GAAG,yBAAyB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,OAAO,EAAE,EAC1D,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,oBAAoB;KAC5B,CAAC,CAAC,CAAC;IACJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CACjE,MAAM,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAC/E,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/slate-actions.d.ts

@@ -0,0 +1,38 @@
+import type { SlateStroke } from './slate-view-contract.js';
+/**
+ * The actions a click can commit, validated and normalized. The same function
+ * runs at `run`, so the intent digest is over exactly what the runner gets.
+ */
+/** How many options a round can draw, and how many it draws when the click does not say. */
+export declare const ROUND_OPTION_COUNTS: readonly [2, 4, 6, 8];
+export type RoundOptionCount = (typeof ROUND_OPTION_COUNTS)[number];
+export declare const DEFAULT_ROUND_OPTION_COUNT: RoundOptionCount;
+export declare const NOTE_MAX_CHARACTERS = 600;
+export declare const EDIT_PROMPT_MAX_BYTES = 6000;
+export declare const STROKE_LIMITS: {
+    readonly strokes: 24;
+    readonly pointsPerStroke: 400;
+    readonly pointsTotal: 3000;
+};
+export type RoundAction = {
+    kind: 'round';
+    mode: 'new' | 'like';
+    note: string | null;
+    fromVersionId: string | null;
+    count: RoundOptionCount;
+};
+export type EditAction = {
+    kind: 'edit';
+    versionId: string;
+    prompt: string;
+    strokes: SlateStroke[];
+};
+export type SlateWorkAction = RoundAction | EditAction;
+/** Control characters are stripped except tab and newline; the rest is the user's text. */
+export declare const cleanUserText: (value: string) => string;
+/** Freehand strokes as integer permille points; anything outside the limits is refused, never trimmed. */
+export declare const normalizeStrokes: (value: unknown) => SlateStroke[];
+/** A missing count is the default; anything but 2, 4, 6 or 8 is refused, never rounded. */
+export declare const normalizeRoundCount: (value: unknown) => RoundOptionCount;
+export declare const normalizeAction: (input: unknown) => SlateWorkAction;
+//# sourceMappingURL=slate-actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slate-actions.d.ts","sourceRoot":"","sources":["../src/slate-actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;GAGG;AAEH,4FAA4F;AAC5F,eAAO,MAAM,mBAAmB,uBAAwB,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AACpE,eAAO,MAAM,0BAA0B,EAAE,gBAAoB,CAAC;AAC9D,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAC3C,eAAO,MAAM,aAAa;;;;CAAqE,CAAC;AAEhG,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AACF,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AACrG,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,CAAC;AAQvD,2FAA2F;AAC3F,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAG7C,CAAC;AAEF,0GAA0G;AAC1G,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,WAAW,EAsB5D,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,gBAKpD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,eA8BhD,CAAC"}

package/dist/slate-actions.js

@@ -0,0 +1,102 @@
+import { SlateError } from './slate-errors.js';
+import { VERSION_ID_PATTERN } from './slate-ids.js';
+/**
+ * The actions a click can commit, validated and normalized. The same function
+ * runs at `run`, so the intent digest is over exactly what the runner gets.
+ */
+/** How many options a round can draw, and how many it draws when the click does not say. */
+export const ROUND_OPTION_COUNTS = [2, 4, 6, 8];
+export const DEFAULT_ROUND_OPTION_COUNT = 4;
+export const NOTE_MAX_CHARACTERS = 600;
+export const EDIT_PROMPT_MAX_BYTES = 6_000;
+export const STROKE_LIMITS = { strokes: 24, pointsPerStroke: 400, pointsTotal: 3_000 };
+const isRecord = (value) => (!!value && typeof value === 'object' && !Array.isArray(value));
+const invalid = (message) => { throw new SlateError('invalid_input', message); };
+/** Control characters are stripped except tab and newline; the rest is the user's text. */
+export const cleanUserText = (value) => (
+// eslint-disable-next-line no-control-regex
+value.replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/gu, '').trim());
+/** Freehand strokes as integer permille points; anything outside the limits is refused, never trimmed. */
+export const normalizeStrokes = (value) => {
+    if (value === undefined || value === null)
+        return [];
+    if (!Array.isArray(value))
+        return invalid('strokes must be a list of strokes');
+    if (value.length > STROKE_LIMITS.strokes)
+        return invalid(`At most ${STROKE_LIMITS.strokes} strokes can be sent.`);
+    let total = 0;
+    return value.map((stroke, strokeIndex) => {
+        if (!Array.isArray(stroke) || stroke.length === 0)
+            return invalid(`stroke ${strokeIndex + 1} must hold at least one point`);
+        if (stroke.length > STROKE_LIMITS.pointsPerStroke)
+            return invalid(`A stroke can hold at most ${STROKE_LIMITS.pointsPerStroke} points.`);
+        total += stroke.length;
+        if (total > STROKE_LIMITS.pointsTotal)
+            return invalid(`Strokes can hold at most ${STROKE_LIMITS.pointsTotal} points in all.`);
+        return stroke.map((point, pointIndex) => {
+            if (!Array.isArray(point) || point.length !== 2)
+                return invalid(`stroke ${strokeIndex + 1} point ${pointIndex + 1} must be [x, y]`);
+            const [x, y] = point;
+            if (typeof x !== 'number' || typeof y !== 'number' || !Number.isFinite(x) || !Number.isFinite(y)) {
+                return invalid(`stroke ${strokeIndex + 1} point ${pointIndex + 1} must be numbers`);
+            }
+            const px = Math.round(x);
+            const py = Math.round(y);
+            if (px < 0 || px > 1000 || py < 0 || py > 1000)
+                return invalid('stroke points are thousandths of the image, 0 to 1000');
+            return [px, py];
+        });
+    });
+};
+/** A missing count is the default; anything but 2, 4, 6 or 8 is refused, never rounded. */
+export const normalizeRoundCount = (value) => {
+    if (value === undefined || value === null)
+        return DEFAULT_ROUND_OPTION_COUNT;
+    const allowed = ROUND_OPTION_COUNTS.find((count) => count === value);
+    if (allowed === undefined)
+        return invalid(`count must be one of ${ROUND_OPTION_COUNTS.join(', ')}`);
+    return allowed;
+};
+export const normalizeAction = (input) => {
+    if (!isRecord(input))
+        return invalid('action must be an object');
+    if (input.kind === 'round') {
+        if (input.mode !== 'new' && input.mode !== 'like')
+            return invalid('mode must be new or like');
+        let note = null;
+        if (input.note !== undefined && input.note !== null) {
+            if (typeof input.note !== 'string')
+                return invalid('note must be text');
+            const cleaned = cleanUserText(input.note).replace(/\s+/gu, ' ');
+            if ([...cleaned].length > NOTE_MAX_CHARACTERS)
+                return invalid(`A steer note can be at most ${NOTE_MAX_CHARACTERS} characters.`);
+            note = cleaned || null;
+        }
+        let fromVersionId = null;
+        if (input.fromVersionId !== undefined && input.fromVersionId !== null) {
+            if (typeof input.fromVersionId !== 'string' || !VERSION_ID_PATTERN.test(input.fromVersionId))
+                return invalid('fromVersionId is not a version id');
+            fromVersionId = input.fromVersionId;
+        }
+        if (input.mode === 'like' && fromVersionId === null)
+            return invalid('More like this needs the version to stay close to (fromVersionId).');
+        if (input.mode === 'new' && fromVersionId !== null)
+            return invalid('New options do not start from a version.');
+        return { kind: 'round', mode: input.mode, note, fromVersionId, count: normalizeRoundCount(input.count) };
+    }
+    if (input.kind === 'edit') {
+        const versionId = input.versionId;
+        if (typeof versionId !== 'string' || !VERSION_ID_PATTERN.test(versionId))
+            return invalid('versionId is not a version id');
+        if (typeof input.prompt !== 'string')
+            return invalid('prompt must be text');
+        const prompt = cleanUserText(input.prompt);
+        if (!prompt)
+            return invalid('Say what should change.');
+        if (Buffer.byteLength(prompt) > EDIT_PROMPT_MAX_BYTES)
+            return invalid(`An edit instruction can be at most ${EDIT_PROMPT_MAX_BYTES} bytes.`);
+        return { kind: 'edit', versionId, prompt, strokes: normalizeStrokes(input.strokes) };
+    }
+    return invalid('action.kind must be round or edit');
+};
+//# sourceMappingURL=slate-actions.js.map