@sanity-labs/slides 0.0.0

package/dist/cli.js

@@ -0,0 +1,386 @@
+#!/usr/bin/env node
+/**
+ * `slidesctl` — the CLI bin shipped with `@sanity-labs/slides`.
+ *
+ * Subcommands:
+ *
+ *   serve     --template <path-or-specifier> [--output <dir>] [--name <id>]
+ *               Start an MCP server over stdio. Exposes `slides_list`,
+ *               `slides_add_<type>`, and `slides_create` derived from the
+ *               loaded template.
+ *
+ *   generate  --template <path-or-specifier> [--output <dir>]
+ *               Read `{ title, slides: [...] }` JSON from stdin and write
+ *               the resulting `.pptx`. Prints the absolute path on stdout.
+ *
+ *   list      --template <path-or-specifier>
+ *               Print every slide type the template exposes, with
+ *               descriptions. Useful for humans inspecting a template
+ *               without an MCP client.
+ *
+ *   scaffold  <dir> [--name <slug>]
+ *               Scaffold a new template into <dir>. Replaces the old
+ *               `npm create react-pptx-template` flow.
+ *
+ *   skill     [--path]
+ *               Print the bundled `SKILL.md` to stdout (or its absolute
+ *               path with `--path`). Paste into a Claude project to teach
+ *               the model how to drive any react-pptx MCP server.
+ *
+ * The `--template` flag accepts:
+ *   - A bare package specifier resolved from the current directory
+ *     (e.g. `@acme/slide-template`).
+ *   - A path to a built JS file (`./dist/index.js`).
+ *   - A path to a directory containing `package.json` (the bin reads
+ *     `main` / `exports['.']`).
+ */
+import { readFileSync, realpathSync, statSync } from 'node:fs';
+import { dirname, resolve as resolvePath } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { PptxSlidesRuntime } from './core/index.js';
+import { renderSlides } from './mcp/render.js';
+import { createSlideServer } from './mcp/server.js';
+import { defaultName, scaffoldTemplate, validateName } from './scaffold/index.js';
+const USAGE = `Usage: slidesctl <command> [options]
+
+Commands:
+  serve     Start an MCP server over stdio.
+  generate  Read { title, slides } JSON from stdin, write a .pptx file.
+  list      Print the slide types a template exposes.
+  scaffold  Scaffold a new template into <dir>.
+  skill     Print the bundled SKILL.md.
+
+Options (serve / generate / list):
+  --template, -t <path>   Template to load. Accepts a package name, a file
+                          path, or a directory.
+  --output,   -o <dir>    Output directory for generated .pptx files
+                          (serve/generate only; defaults to cwd).
+  --name,         <id>    MCP server name override (serve only).
+
+Options (scaffold):
+  --name      <slug>      Template name (default: inferred from <dir>).
+
+Options (skill):
+  --path                  Print SKILL.md's absolute path only.
+
+Global:
+  --help, -h              Show this message.
+`;
+const parseArgs = (argv) => {
+    const args = {
+        command: undefined,
+        positional: [],
+        template: undefined,
+        output: undefined,
+        name: undefined,
+        path: false,
+        help: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--help':
+            case '-h':
+                args.help = true;
+                break;
+            case '--template':
+            case '-t':
+                args.template = argv[++i];
+                break;
+            case '--output':
+            case '-o':
+                args.output = argv[++i];
+                break;
+            case '--name':
+                args.name = argv[++i];
+                break;
+            case '--path':
+                args.path = true;
+                break;
+            default:
+                if (arg === undefined)
+                    break;
+                if (arg.startsWith('-'))
+                    throw new CliError(`Unknown flag: ${arg}`);
+                if (args.command === undefined) {
+                    args.command = arg;
+                }
+                else {
+                    args.positional.push(arg);
+                }
+        }
+    }
+    return args;
+};
+class CliError extends Error {
+    exitCode;
+    constructor(message, exitCode = 2) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = 'CliError';
+    }
+}
+/**
+ * Resolve a `--template` argument to a Template instance.
+ *
+ * The template is the default export of the resolved module, or any named
+ * export that matches the Template shape (`name`, `components`, `canvas`).
+ */
+const loadTemplate = async (spec) => {
+    const cwd = process.cwd();
+    let importTarget;
+    if (isAbsoluteOrRelative(spec)) {
+        const abs = resolvePath(cwd, spec);
+        let resolved;
+        try {
+            const stat = statSync(abs);
+            resolved = stat.isDirectory() ? resolveDirEntry(abs) : abs;
+        }
+        catch (err) {
+            throw new CliError(`Cannot read --template path "${spec}" (resolved to "${abs}"): ${describeError(err)}`);
+        }
+        importTarget = pathToFileURL(resolved).href;
+    }
+    else {
+        importTarget = resolveBareSpecifier(spec, cwd);
+    }
+    let mod;
+    try {
+        mod = await import(importTarget);
+    }
+    catch (err) {
+        throw new CliError(`Failed to import template "${spec}": ${describeError(err)}`);
+    }
+    const template = pickTemplate(mod);
+    if (!template) {
+        throw new CliError(`Module at "${spec}" does not export a Template (need an object with name + components).`);
+    }
+    return template;
+};
+const isAbsoluteOrRelative = (spec) => spec.startsWith('.') || spec.startsWith('/') || /^[A-Z]:\\/i.test(spec);
+const resolveDirEntry = (dir) => {
+    const pkgPath = resolvePath(dir, 'package.json');
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    }
+    catch (err) {
+        throw new CliError(`Template directory "${dir}" has no readable package.json: ${describeError(err)}`);
+    }
+    const entry = pkg.module ?? pkg.main ?? exportsDefault(pkg.exports);
+    if (!entry) {
+        throw new CliError(`Template directory "${dir}" has no main/module/exports entry to import.`);
+    }
+    return resolvePath(dir, entry);
+};
+const exportsDefault = (exportsField) => {
+    if (typeof exportsField === 'string')
+        return exportsField;
+    if (exportsField && typeof exportsField === 'object') {
+        const dot = exportsField['.'];
+        if (typeof dot === 'string')
+            return dot;
+        if (dot && typeof dot === 'object') {
+            const sub = dot;
+            const candidate = sub['import'] ?? sub['default'] ?? sub['node'];
+            if (typeof candidate === 'string')
+                return candidate;
+        }
+    }
+    return undefined;
+};
+const resolveBareSpecifier = (spec, cwd) => {
+    // ESM resolution honours `exports.import` and other conditions that
+    // require.resolve() doesn't, which matters for templates that ship
+    // conditional exports. Anchor resolution at the user's cwd via a synthetic
+    // package.json URL so we look in their node_modules.
+    const parentUrl = pathToFileURL(resolvePath(cwd, 'package.json')).href;
+    try {
+        return import.meta.resolve(spec, parentUrl);
+    }
+    catch (err) {
+        throw new CliError(`Cannot resolve template "${spec}" from ${cwd}: ${describeError(err)}. ` +
+            `Install it as a dependency or pass a path with --template.`);
+    }
+};
+const pickTemplate = (mod) => {
+    if (!mod || typeof mod !== 'object')
+        return undefined;
+    const candidates = [];
+    const m = mod;
+    if (m['default'])
+        candidates.push(m['default']);
+    for (const [key, value] of Object.entries(m)) {
+        if (key === 'default')
+            continue;
+        candidates.push(value);
+    }
+    for (const c of candidates) {
+        if (isTemplate(c))
+            return c;
+    }
+    return undefined;
+};
+const isTemplate = (value) => {
+    if (!value || typeof value !== 'object')
+        return false;
+    const v = value;
+    return typeof v['name'] === 'string' && typeof v['components'] === 'object';
+};
+const newRuntime = (output) => new PptxSlidesRuntime({ outputDir: output ?? process.cwd() });
+const runServe = async (args) => {
+    if (!args.template)
+        throw new CliError('serve requires --template <path-or-specifier>.');
+    const template = await loadTemplate(args.template);
+    const runtime = newRuntime(args.output);
+    const server = createSlideServer({
+        template,
+        runtime,
+        ...(args.name ? { serverInfo: { name: args.name, version: '0.1.0' } } : {}),
+    });
+    await server.start({ transport: 'stdio' });
+};
+const runList = async (args) => {
+    if (!args.template)
+        throw new CliError('list requires --template <path-or-specifier>.');
+    const template = await loadTemplate(args.template);
+    const lines = [`Template: ${template.name}`, '', 'Slide types:'];
+    for (const [name, tc] of Object.entries(template.components)) {
+        lines.push(`  • ${name} — ${tc.description ?? '(no description)'}`);
+    }
+    process.stdout.write(lines.join('\n') + '\n');
+};
+const runGenerate = async (args) => {
+    if (!args.template)
+        throw new CliError('generate requires --template <path-or-specifier>.');
+    const template = await loadTemplate(args.template);
+    const runtime = newRuntime(args.output);
+    const raw = await readStdin();
+    if (raw.trim().length === 0) {
+        throw new CliError('generate: no input on stdin. Pipe JSON of { title, slides: [{ component, props }] }.');
+    }
+    let input;
+    try {
+        input = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new CliError(`generate: invalid JSON on stdin: ${describeError(err)}`);
+    }
+    if (typeof input.title !== 'string' || !Array.isArray(input.slides)) {
+        throw new CliError('generate: input must be { title: string, slides: array }.');
+    }
+    const result = await renderSlides({
+        template,
+        runtime,
+        title: input.title,
+        slides: input.slides,
+    });
+    if (result.ok) {
+        process.stdout.write(`${result.filePath}\n`);
+        return;
+    }
+    throw new CliError(result.message, result.code === 'unknown_component' ? 3 : 2);
+};
+const runSkill = (args) => {
+    const skillPath = resolveSkillPath();
+    if (args.path) {
+        process.stdout.write(`${skillPath}\n`);
+        return;
+    }
+    process.stdout.write(readFileSync(skillPath, 'utf8'));
+};
+const runScaffold = (args) => {
+    const [target] = args.positional;
+    if (!target) {
+        throw new CliError('scaffold requires a target directory: `slidesctl scaffold my-template`.');
+    }
+    const name = args.name ?? defaultName(target);
+    const nameError = validateName(name);
+    if (nameError) {
+        throw new CliError(`Invalid template name "${name}": ${nameError}. ` + `Pass --name <slug> with a valid name.`);
+    }
+    const result = scaffoldTemplate({ target, name });
+    process.stdout.write(`Scaffolded ${result.fileCount} files into ${result.targetPath}\n`);
+    process.stdout.write(`\nNext steps:\n  cd ${target}\n  pnpm install\n  pnpm dev   # open the viewer\n  pnpm build # emit dist/ so slidesctl can serve it\n`);
+};
+const resolveSkillPath = () => {
+    // SKILL.md ships at the package root, one level above dist/cli.js.
+    // From src/cli.ts the same relative path resolves correctly because
+    // we run from dist/ in production.
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolvePath(here, '..', 'SKILL.md');
+};
+const readStdin = () => {
+    const chunks = [];
+    return new Promise((resolve, reject) => {
+        process.stdin.on('data', (chunk) => {
+            chunks.push(typeof chunk === 'string' ? Buffer.from(chunk, 'utf8') : chunk);
+        });
+        process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        process.stdin.on('error', (err) => reject(err));
+    });
+};
+const describeError = (err) => (err instanceof Error ? err.message : String(err));
+export const main = async (argv) => {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+        process.stderr.write(USAGE);
+        process.exit(2);
+    }
+    if (args.help || args.command === undefined) {
+        process.stdout.write(USAGE);
+        process.exit(args.help ? 0 : 1);
+    }
+    try {
+        switch (args.command) {
+            case 'serve':
+                await runServe(args);
+                return;
+            case 'list':
+                await runList(args);
+                return;
+            case 'generate':
+                await runGenerate(args);
+                return;
+            case 'scaffold':
+                runScaffold(args);
+                return;
+            case 'skill':
+                runSkill(args);
+                return;
+            default:
+                process.stderr.write(`Unknown command: ${args.command}\n`);
+                process.stderr.write(USAGE);
+                process.exit(2);
+        }
+    }
+    catch (err) {
+        if (err instanceof CliError) {
+            process.stderr.write(`${err.message}\n`);
+            process.exit(err.exitCode);
+        }
+        process.stderr.write(`slidesctl failed: ${describeError(err)}\n`);
+        process.exit(1);
+    }
+};
+// pnpm's content-addressed install layout means `process.argv[1]` is the
+// `.bin` symlink while `import.meta.url` is the realpath under `.pnpm/`.
+// Use realpathSync on both sides so direct invocation and
+// `node_modules/.bin/slidesctl` both detect this file as the entrypoint.
+const argvPath = process.argv[1];
+if (argvPath !== undefined) {
+    try {
+        const argvReal = realpathSync(argvPath);
+        const selfReal = fileURLToPath(import.meta.url);
+        if (argvReal === selfReal)
+            void main(process.argv.slice(2));
+    }
+    catch {
+        // not invoked as a script — module being imported, ignore.
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAElF,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBb,CAAC;AAYF,MAAM,SAAS,GAAG,CAAC,IAAuB,EAAc,EAAE;IACxD,MAAM,IAAI,GAQN;QACF,OAAO,EAAE,SAAS;QAClB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,KAAK;KACZ,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACjB,MAAM;YACR,KAAK,YAAY,CAAC;YAClB,KAAK,IAAI;gBACP,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1B,MAAM;YACR,KAAK,UAAU,CAAC;YAChB,KAAK,IAAI;gBACP,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACtB,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACjB,MAAM;YACR;gBACE,IAAI,GAAG,KAAK,SAAS;oBAAE,MAAM;gBAC7B,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,MAAM,IAAI,QAAQ,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC;gBACpE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC/B,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;gBACrB,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5B,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,QAAS,SAAQ,KAAK;IAGf;IAFX,YACE,OAAe,EACN,WAAW,CAAC;QAErB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,aAAQ,GAAR,QAAQ,CAAI;QAGrB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,YAAY,GAAG,KAAK,EAAE,IAAY,EAAqB,EAAE;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,YAAoB,CAAC;IAEzB,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC3B,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAChB,gCAAgC,IAAI,mBAAmB,GAAG,OAAO,aAAa,CAAC,GAAG,CAAC,EAAE,CACtF,CAAC;QACJ,CAAC;QACD,YAAY,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAAC,8BAA8B,IAAI,MAAM,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,QAAQ,CAChB,cAAc,IAAI,uEAAuE,CAC1F,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAW,EAAE,CACrD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1E,MAAM,eAAe,GAAG,CAAC,GAAW,EAAU,EAAE;IAC9C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACjD,IAAI,GAA0D,CAAC;IAC/D,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAe,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAChB,uBAAuB,GAAG,mCAAmC,aAAa,CAAC,GAAG,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAAC,uBAAuB,GAAG,+CAA+C,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,YAAqB,EAAsB,EAAE;IACnE,IAAI,OAAO,YAAY,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC;IAC1D,IAAI,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,GAAG,GAAI,YAAwC,CAAC,GAAG,CAAC,CAAC;QAC3D,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC;QACxC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,GAA8B,CAAC;YAC3C,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;YACjE,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,GAAW,EAAU,EAAE;IACjE,oEAAoE;IACpE,mEAAmE;IACnE,2EAA2E;IAC3E,qDAAqD;IACrD,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAChB,4BAA4B,IAAI,UAAU,GAAG,KAAK,aAAa,CAAC,GAAG,CAAC,IAAI;YACtE,4DAA4D,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,GAAY,EAAwB,EAAE;IAC1D,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,UAAU,GAAc,EAAE,CAAC;IACjC,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,IAAI,CAAC,CAAC,SAAS,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,KAAc,EAAqB,EAAE;IACvD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC;AAC9E,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,MAA0B,EAAiB,EAAE,CAC/D,IAAI,iBAAiB,CAAC,EAAE,SAAS,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAEhE,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAgB,EAAiB,EAAE;IACzD,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,gDAAgD,CAAC,CAAC;IACzF,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,iBAAiB,CAAC;QAC/B,QAAQ;QACR,OAAO;QACP,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5E,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,KAAK,EAAE,IAAgB,EAAiB,EAAE;IACxD,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,+CAA+C,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,CAAC,aAAa,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,CAAC;IACjE,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC,WAAW,IAAI,kBAAkB,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,KAAK,EAAE,IAAgB,EAAiB,EAAE;IAC5D,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,mDAAmD,CAAC,CAAC;IAC5F,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC;IAC9B,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAChB,sFAAsF,CACvF,CAAC;IACJ,CAAC;IACD,IAAI,KAA4C,CAAC;IACjD,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAAC,oCAAoC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,QAAQ,CAAC,2DAA2D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,QAAQ;QACR,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAsE;KACrF,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,IAAgB,EAAQ,EAAE;IAC1C,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AACxD,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,IAAgB,EAAQ,EAAE;IAC7C,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;IACjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAAC,yEAAyE,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,QAAQ,CAChB,0BAA0B,IAAI,MAAM,SAAS,IAAI,GAAG,uCAAuC,CAC5F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,MAAM,CAAC,SAAS,eAAe,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IACzF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uBAAuB,MAAM,yGAAyG,CACvI,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,GAAW,EAAE;IACpC,mEAAmE;IACnE,oEAAoE;IACpE,mCAAmC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,GAAoB,EAAE;IACtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;YAClD,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,GAAY,EAAU,EAAE,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAEnG,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE,IAAuB,EAAiB,EAAE;IACnE,IAAI,IAAgB,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,OAAO;gBACV,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACrB,OAAO;YACT,KAAK,MAAM;gBACT,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;gBACpB,OAAO;YACT,KAAK,UAAU;gBACb,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;gBACxB,OAAO;YACT,KAAK,UAAU;gBACb,WAAW,CAAC,IAAI,CAAC,CAAC;gBAClB,OAAO;YACT,KAAK,OAAO;gBACV,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACf,OAAO;YACT;gBACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;gBAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAEF,yEAAyE;AACzE,yEAAyE;AACzE,0DAA0D;AAC1D,yEAAyE;AACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,QAAQ,KAAK,QAAQ;YAAE,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;AACH,CAAC"}

package/dist/core/components.d.ts

@@ -0,0 +1,179 @@
+/**
+ * The minimal JSX primitive surface the reconciler walks.
+ *
+ * **This is intentionally a small, lower-case set.** High-level brand
+ * components (`<Cover/>`, `<TwoColumn/>`, etc.) live in brand packages
+ * (e.g., `@sanity-labs/slides`) and *compose* these primitives. The substrate
+ * exports just enough to render an arbitrary slide tree.
+ *
+ * Why hand-rolled host elements rather than `<div>`-style intrinsic elements:
+ * we want the reconciler to recognize these by *type identity*, not by string
+ * tag names. Type identity removes a class of bugs ("did you mean 'box' or
+ * 'Box'?") and gives the type-checker something concrete to enforce.
+ *
+ * These don't render to the DOM — they're inert markers the reconciler walks.
+ * They return `null` so they're harmless if accidentally rendered through
+ * react-dom (e.g., during Storybook prototyping).
+ */
+import type { ReactNode } from 'react';
+import type { Rect } from './geometry.js';
+import type { ArtifactRef, SlotId } from './manifest.js';
+import type { HexColor, ParagraphStyle, TextStyle } from './runtime.js';
+/**
+ * A single slide in the deck.
+ *
+ * Every `<Slide>` becomes a `createSlide` op. Children are rendered into the
+ * slide's coordinate space.
+ */
+export interface SlideProps {
+    /** Children: `<Box>` and `<Image>` shapes laid out inside the slide. */
+    children?: ReactNode;
+}
+/**
+ * A discriminated union describing a `<Box>`'s background fill.
+ *
+ * Shaped as a tagged union — *not* a flat `fill?: HexColor` — so future fill
+ * kinds (texture, image-as-background, gradient) can be added without
+ * sprouting parallel optional props. The discriminator is load-bearing:
+ * off-brand fills are inexpressible at the type level when a brand component
+ * narrows what kinds it accepts.
+ *
+ * Today only `'solid'` is supported. Image fills (full-bleed photos) are
+ * authored as `<Image>` siblings of `<Box>` rather than nested inside a
+ * Box's fill.
+ */
+export type BoxFill = {
+    kind: 'solid';
+    color: HexColor;
+};
+/**
+ * A rectangular text box on the slide canvas.
+ *
+ * Becomes a `createShape` op with shape `TEXT_BOX` (the only shape this
+ * primitive set produces; other shape kinds are reserved for the future).
+ * Children are concatenated into a single text run with style spans.
+ */
+export interface BoxProps {
+    /** The shape's rect in *points*. The reconciler converts to EMU at the boundary. */
+    rect: Rect;
+    /**
+     * Optional slot ID, encoded into the shape's alt-text. Required for any text
+     * box that re-fill should target. Format: `<componentName>:<slotName>`,
+     * e.g., `"cover:title"`. See `manifest.ts` for encoding details.
+     */
+    slotId?: SlotId;
+    /**
+     * Optional background fill. When set, the reconciler emits an
+     * `updateShapeProperties` op immediately after the shape is created,
+     * before any text or text-style ops. An empty Box (no children) with a
+     * `fill` is a valid full-bleed colored background.
+     */
+    fill?: BoxFill;
+    /** Default text style applied to the shape's contents. */
+    textStyle?: TextStyle;
+    /** Default paragraph style. */
+    paragraphStyle?: ParagraphStyle;
+    /** Children: `<Text>` runs and/or raw strings. */
+    children?: ReactNode;
+}
+/**
+ * A styled text run inside a `<Box>`.
+ *
+ * Multiple `<Text>` children of the same `<Box>` are concatenated; each
+ * run's style is applied to its character range via `updateTextStyle` ops.
+ * Raw string children of `<Box>` are equivalent to `<Text>{text}</Text>`
+ * with no style override.
+ *
+ * The intent of carrying `textStyle` here (rather than mandating a typography
+ * token) is: high-level brand components compose this primitive *and* enforce
+ * brand-token discipline at *their* layer. The substrate stays brand-agnostic.
+ */
+export interface TextProps {
+    /** Style applied to this run only. Merges over `<Box>`'s `textStyle`. */
+    textStyle?: TextStyle;
+    /** Children: text content. Nested elements are flattened to their text. */
+    children?: ReactNode;
+}
+/**
+ * A wrapper that sets the foreground color of its children.
+ *
+ * A thin convenience over `<Text textStyle={{foregroundColor}}/>` so
+ * brand components can read more declaratively. The reconciler treats this
+ * identically to a `<Text>` with the same style.
+ */
+export interface ColorProps {
+    /** The color to apply, as a 24-bit hex. (`#RRGGBB`.) */
+    color: HexColor;
+    /** Children: text or `<Text>` runs. */
+    children?: ReactNode;
+}
+/**
+ * A reference to a brand-resolved image, including its provenance.
+ *
+ * The `artifact` field is **required**: every image rendered through the
+ * substrate is recorded in the generation manifest's `artifacts` list, so
+ * downstream tooling can detect 404s and verify content integrity. An
+ * `<Image>` without a `ArtifactRef` is impossible to construct —
+ * type-level enforcement of the manifest contract.
+ */
+export interface ImageRef {
+    /** Resolved URL the runtime will fetch the image bytes from. */
+    readonly url: string;
+    /** Template-artifact provenance — recorded in manifest.artifacts. Required. */
+    readonly artifact: ArtifactRef;
+}
+/**
+ * A bitmap image placed on a slide, rendered as a `createImage` op.
+ *
+ * Sibling of `<Box>` inside a `<Slide>`. Used for full-bleed background
+ * photos, dot-grid texture overlays, brand logos, and any other rasterized
+ * brand artifact. Vector content (lines, rectangles, etc.) goes through
+ * `<Box>` and the (future) shape-kind extension to its fill prop.
+ */
+export interface ImageProps {
+    /** The image's rect in *points*. The reconciler converts to EMU at the boundary. */
+    rect: Rect;
+    /**
+     * The image to render, including its brand-artifact provenance. Required —
+     * an `<Image>` without an `ImageRef` is unconstructable, by design.
+     */
+    image: ImageRef;
+    /**
+     * Optional slot ID. When set, the reconciler records `SlotId → imageId` in
+     * the manifest's slot registry.
+     */
+    slotId?: SlotId;
+    /**
+     * Accessibility alt-text shown to assistive tech.
+     *
+     * Carried through to the `createImage` op's `altText` field.
+     */
+    altText?: string;
+}
+/** A unique brand for each primitive's React component. */
+type Marker<TProps> = ((props: TProps) => null) & {
+    readonly __rgsKind: string;
+};
+export declare const Slide: Marker<SlideProps>;
+export declare const Box: Marker<BoxProps>;
+export declare const Text: Marker<TextProps>;
+export declare const Color: Marker<ColorProps>;
+export declare const Image: Marker<ImageProps>;
+/**
+ * The set of primitive React components the reconciler recognizes.
+ *
+ * Used internally for type identity checks (see `reconciler.ts`). Exposed for
+ * downstream packages that want to detect "is this a substrate primitive?"
+ * without importing each one individually.
+ */
+export declare const PRIMITIVES: {
+    readonly Slide: Marker<SlideProps>;
+    readonly Box: Marker<BoxProps>;
+    readonly Text: Marker<TextProps>;
+    readonly Color: Marker<ColorProps>;
+    readonly Image: Marker<ImageProps>;
+};
+/** Type guard: is this React element type one of our primitives? */
+export declare const isPrimitive: (type: unknown) => type is (typeof PRIMITIVES)[keyof typeof PRIMITIVES];
+export {};
+//# sourceMappingURL=components.d.ts.map

package/dist/core/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/core/components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAExE;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,oFAAoF;IACpF,IAAI,EAAE,IAAI,CAAC;IAEX;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,0DAA0D;IAC1D,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,KAAK,EAAE,QAAQ,CAAC;IAChB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,IAAI,EAAE,IAAI,CAAC;IAEX;;;OAGG;IACH,KAAK,EAAE,QAAQ,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2DAA2D;AAC3D,KAAK,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AASjF,eAAO,MAAM,KAAK,oBAAkC,CAAC;AACrD,eAAO,MAAM,GAAG,kBAA8B,CAAC;AAC/C,eAAO,MAAM,IAAI,mBAAgC,CAAC;AAClD,eAAO,MAAM,KAAK,oBAAkC,CAAC;AACrD,eAAO,MAAM,KAAK,oBAAkC,CAAC;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;;;;;;CAA8C,CAAC;AAItE,oEAAoE;AACpE,eAAO,MAAM,WAAW,GAAI,MAAM,OAAO,KAAG,IAAI,IAAI,CAAC,OAAO,UAAU,EAAE,MAAM,OAAO,UAAU,CACtE,CAAC"}

package/dist/core/components.js

@@ -0,0 +1,40 @@
+/**
+ * The minimal JSX primitive surface the reconciler walks.
+ *
+ * **This is intentionally a small, lower-case set.** High-level brand
+ * components (`<Cover/>`, `<TwoColumn/>`, etc.) live in brand packages
+ * (e.g., `@sanity-labs/slides`) and *compose* these primitives. The substrate
+ * exports just enough to render an arbitrary slide tree.
+ *
+ * Why hand-rolled host elements rather than `<div>`-style intrinsic elements:
+ * we want the reconciler to recognize these by *type identity*, not by string
+ * tag names. Type identity removes a class of bugs ("did you mean 'box' or
+ * 'Box'?") and gives the type-checker something concrete to enforce.
+ *
+ * These don't render to the DOM — they're inert markers the reconciler walks.
+ * They return `null` so they're harmless if accidentally rendered through
+ * react-dom (e.g., during Storybook prototyping).
+ */
+const makeMarker = (kind) => {
+    const component = (_props) => null;
+    // Display name aids debugging in React DevTools and assertion messages.
+    Object.defineProperty(component, 'name', { value: kind });
+    return Object.assign(component, { __rgsKind: kind });
+};
+export const Slide = makeMarker('Slide');
+export const Box = makeMarker('Box');
+export const Text = makeMarker('Text');
+export const Color = makeMarker('Color');
+export const Image = makeMarker('Image');
+/**
+ * The set of primitive React components the reconciler recognizes.
+ *
+ * Used internally for type identity checks (see `reconciler.ts`). Exposed for
+ * downstream packages that want to detect "is this a substrate primitive?"
+ * without importing each one individually.
+ */
+export const PRIMITIVES = { Slide, Box, Text, Color, Image };
+const PRIMITIVE_SET = new Set(Object.values(PRIMITIVES));
+/** Type guard: is this React element type one of our primitives? */
+export const isPrimitive = (type) => PRIMITIVE_SET.has(type);
+//# sourceMappingURL=components.js.map

package/dist/core/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../src/core/components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyJH,MAAM,UAAU,GAAG,CAAS,IAAY,EAAkB,EAAE;IAC1D,MAAM,SAAS,GAAG,CAAC,MAAc,EAAQ,EAAE,CAAC,IAAI,CAAC;IACjD,wEAAwE;IACxE,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAW,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAAa,OAAO,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,GAAG,GAAG,UAAU,CAAW,KAAK,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAY,MAAM,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAAa,OAAO,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAAa,OAAO,CAAC,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAW,CAAC;AAEtE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAU,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;AAElE,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAa,EAAwD,EAAE,CACjG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC"}