@templatical/template-tools 0.46.0 → 0.48.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/bin.js CHANGED
@@ -1,10 +1,11 @@
1
1
  #!/usr/bin/env node
2
- import { a as validateTemplate, i as schema, r as runQualityLint, t as applyOperation } from "./src-De5svMDM.js";
2
+ import { a as buildSpecimenTemplate, c as runRecipe, d as schema, f as validateTemplate, i as buildSpecimen, l as validateCustomBlockDefinition, n as renderSpecimenMjml, r as SPECIMEN_STATES, s as checkRecipe, t as checkCustomBlock, u as runQualityLint } from "./custom-block-CsZN9qMM.js";
3
+ import { t as applyOperation } from "./src-SZZkttBC.js";
3
4
  import { DEFAULT_PORT, WORKING_DIR, listWorkingFiles, openBrowser, pidfilePath, processAlive, readPidfile, readWorkingFile, startBridgePreferring } from "./live/index.js";
5
+ import { renderToMjml } from "@templatical/renderer";
4
6
  import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs";
5
7
  import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
6
8
  import { fileURLToPath, pathToFileURL } from "node:url";
7
- import { renderToMjml } from "@templatical/renderer";
8
9
  //#region src/cli/args.ts
9
10
  /** Flags that consume the next argv entry as their value. */
10
11
  const VALUE_FLAGS = /* @__PURE__ */ new Set([
@@ -15,7 +16,11 @@ const VALUE_FLAGS = /* @__PURE__ */ new Set([
15
16
  "ops",
16
17
  "file",
17
18
  "port",
18
- "cwd"
19
+ "cwd",
20
+ "state",
21
+ "values",
22
+ "custom-block",
23
+ "host"
19
24
  ]);
20
25
  function parseArgs(argv) {
21
26
  const positional = [];
@@ -213,6 +218,17 @@ async function resolveOptional(specifier, cwd = process.cwd()) {
213
218
  return null;
214
219
  }
215
220
  //#endregion
221
+ //#region src/cli/mjml.ts
222
+ async function loadMjml(cwd) {
223
+ const mod = await resolveOptional("mjml", cwd);
224
+ return mod ? mod.default : null;
225
+ }
226
+ async function requireMjml(cwd, purpose) {
227
+ const mjml = await loadMjml(cwd);
228
+ if (!mjml) throw new MissingDependencyError("mjml", `${purpose} needs the optional \`mjml\` package, which isn't installed.\n npm install mjml`);
229
+ return mjml;
230
+ }
231
+ //#endregion
216
232
  //#region src/cli/commands/render.ts
217
233
  const FORMATS$1 = /* @__PURE__ */ new Set(["mjml", "html"]);
218
234
  async function runRender(args) {
@@ -226,11 +242,7 @@ async function runRender(args) {
226
242
  if (!valid) throw new InvalidTemplateError(`${file} is not structurally valid (${errors.length} error(s)).`, errors);
227
243
  const mjml = await renderToMjml(data);
228
244
  let output = mjml;
229
- if (format === "html") {
230
- const mod = await resolveOptional("mjml", cwd);
231
- if (!mod) throw new MissingDependencyError("mjml", "Rendering HTML needs the optional `mjml` package, which isn't installed.\n npm install mjml");
232
- output = (await mod.default(mjml, { validationLevel: "soft" })).html;
233
- }
245
+ if (format === "html") output = (await (await requireMjml(cwd, "Rendering HTML"))(mjml, { validationLevel: "soft" })).html;
234
246
  const out = flagValue(args, "out", "o");
235
247
  if (out) {
236
248
  const path = resolveFrom(out, cwd);
@@ -514,6 +526,86 @@ async function runImport(args) {
514
526
  return EXIT.ok;
515
527
  }
516
528
  //#endregion
529
+ //#region src/cli/commands/custom-block.ts
530
+ const USAGE$1 = "Use `custom-block validate <file>`, `custom-block render <file>` or `custom-block fetch <file>`.";
531
+ function formatIssues(issues) {
532
+ return issues.map((i) => ` - [${i.severity}] ${i.ruleId}${i.path ? ` ${i.path}` : ""}: ${i.message}`).join("\n");
533
+ }
534
+ /** `--values '<json>'`: field values a recipe runs with, over the defaults. */
535
+ function parseValuesFlag(raw) {
536
+ if (raw === void 0) return {};
537
+ let parsed;
538
+ try {
539
+ parsed = JSON.parse(raw);
540
+ } catch {
541
+ throw new UsageError("--values must be a JSON object.");
542
+ }
543
+ if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new UsageError("--values must be a JSON object.");
544
+ return parsed;
545
+ }
546
+ function loadValid(file, cwd) {
547
+ const data = readTemplateFile(file, cwd);
548
+ const r = validateCustomBlockDefinition(data);
549
+ if (!r.valid) throw new InvalidTemplateError(`${file} is not a valid custom block definition.`, r.issues.filter((i) => i.severity === "error").map((i) => i.message));
550
+ return data;
551
+ }
552
+ async function runCustomBlock(args) {
553
+ const sub = args.positional[0];
554
+ const file = args.positional[1];
555
+ if (sub !== "validate" && sub !== "render" && sub !== "fetch") throw new UsageError(`Unknown "custom-block ${sub ?? ""}". ${USAGE$1}`);
556
+ if (!file) throw new UsageError(`custom-block ${sub} needs a definition file.`);
557
+ const cwd = flagValue(args, "cwd") ?? process.cwd();
558
+ if (sub === "validate") {
559
+ const mjml = await loadMjml(cwd);
560
+ const result = await checkCustomBlock(readTemplateFile(file, cwd), { compileMjml: mjml ? async (m) => ({ errors: (await mjml(m, { validationLevel: "soft" })).errors }) : void 0 });
561
+ if (!mjml) note("`mjml` isn't installed, so the HTML compile check was skipped.");
562
+ emit(result, () => result.issues.length === 0 ? "✓ Valid custom block — no issues" : `${result.valid ? "✓ Valid" : "✗ Invalid"} · ${result.issues.length} issue(s):\n${formatIssues(result.issues)}`);
563
+ return result.valid ? EXIT.ok : EXIT.invalid;
564
+ }
565
+ const def = loadValid(file, cwd);
566
+ if (sub === "render") {
567
+ const state = flagValue(args, "state");
568
+ if (state !== void 0 && !SPECIMEN_STATES.includes(state)) throw new UsageError(`Unknown --state "${state}". Use one of: ${SPECIMEN_STATES.join(", ")}.`);
569
+ if (state !== void 0) {
570
+ const states = buildSpecimen(def).map((i) => i.state);
571
+ if (!states.includes(state)) throw new UsageError(`${file} has no "${state}" state: it has no ${state === "flipped" ? "boolean" : "repeatable"} field. Its states: ${states.join(", ")}.`);
572
+ }
573
+ const format = flagValue(args, "format") ?? "mjml";
574
+ if (format !== "mjml" && format !== "html") throw new UsageError(`Unknown --format "${format}". Use mjml or html.`);
575
+ let output;
576
+ try {
577
+ output = await renderSpecimenMjml(def, buildSpecimenTemplate(def, void 0, state));
578
+ } catch (err) {
579
+ throw new InvalidTemplateError(`${file} does not render.`, [err.message]);
580
+ }
581
+ if (format === "html") output = (await (await requireMjml(cwd, "Rendering HTML"))(output, { validationLevel: "soft" })).html;
582
+ const out = flagValue(args, "out", "o");
583
+ if (out) {
584
+ const path = resolveFrom(out, cwd);
585
+ mkdirSync(dirname(path), { recursive: true });
586
+ writeFileSync(path, output, "utf8");
587
+ note(`Wrote ${path}`);
588
+ return EXIT.ok;
589
+ }
590
+ emit({
591
+ format,
592
+ output
593
+ }, () => output);
594
+ return EXIT.ok;
595
+ }
596
+ if (!def.dataSourcePreview) throw new UsageError(`${file} has no \`dataSourcePreview\` to run.`);
597
+ const recipeErrors = checkRecipe(def).filter((i) => i.severity === "error");
598
+ if (recipeErrors.length > 0) throw new InvalidTemplateError(`${file} has a dataSourcePreview the bridge would refuse to run.`, recipeErrors.map((i) => `${i.ruleId}: ${i.message}`));
599
+ const overrides = parseValuesFlag(flagValue(args, "values"));
600
+ const defaults = buildSpecimen(def)[0].fieldValues;
601
+ const result = await runRecipe(def.dataSourcePreview, {
602
+ ...defaults,
603
+ ...overrides
604
+ });
605
+ emit(result, () => result.ok ? `✓ ${result.status} · ${JSON.stringify(result.values, null, 2)}${result.unmapped.length ? `\nUnmapped: ${result.unmapped.join(", ")}` : ""}` : `✗ ${result.error}`);
606
+ return result.ok ? EXIT.ok : EXIT.invalid;
607
+ }
608
+ //#endregion
517
609
  //#region src/cli/commands/live.ts
518
610
  /**
519
611
  * The first title block's text in document order, as a hint for `list`.
@@ -555,6 +647,11 @@ async function postTo(port, path, body) {
555
647
  body: body === void 0 ? void 0 : JSON.stringify(body)
556
648
  });
557
649
  }
650
+ /** The fetched state's outcome, as one line of reload or start output. */
651
+ function fetchLine(fetch) {
652
+ if (!fetch.ok) return `Fetched state: the request failed. ${fetch.error}`;
653
+ return fetch.unmapped.length > 0 ? `Fetched state: filled from the API; not in the response: ${fetch.unmapped.join(", ")}.` : "Fetched state: filled from the API.";
654
+ }
558
655
  async function runLive(args) {
559
656
  const sub = args.positional[0];
560
657
  const cwd = resolveFrom(flagValue(args, "cwd") ?? ".", process.cwd());
@@ -563,12 +660,29 @@ async function runLive(args) {
563
660
  if (!info || !processAlive(info.pid)) throw new UsageError(`No live server is running here (no live pidfile at ${WORKING_DIR}/live-server.pid).`);
564
661
  if (sub === "reload") {
565
662
  const consumeAnnotations = args.flags["consume-annotations"] === true;
566
- const body = await (await postTo(info.port, "/reload", consumeAnnotations ? { consumeAnnotations: true } : void 0)).json().catch(() => ({}));
663
+ const res = await postTo(info.port, "/reload", consumeAnnotations ? { consumeAnnotations: true } : void 0);
664
+ const body = await res.json().catch(() => ({}));
665
+ const clients = body.clients ?? 0;
666
+ const consumed = body.consumed === true;
667
+ if (res.status >= 400 || body.ok === false) {
668
+ const error = `${body.error ?? (res.status >= 400 ? `The live server refused the reload (${res.status}).` : "The live server reported a failed reload.")} Nothing was pushed.`;
669
+ emit({
670
+ reloaded: false,
671
+ ok: false,
672
+ clients,
673
+ consumed,
674
+ error
675
+ }, () => error);
676
+ return EXIT.invalid;
677
+ }
678
+ const fetch = body.fetch;
567
679
  emit({
568
680
  reloaded: true,
569
- clients: body.clients ?? 0,
570
- consumed: body.consumed === true
571
- }, () => `Pushed the working file to ${body.clients ?? 0} connected page(s).`);
681
+ ok: true,
682
+ clients,
683
+ consumed,
684
+ ...fetch ? { fetch } : {}
685
+ }, () => [body.mode === "custom-block" ? `Pushed the custom block to ${clients} page(s).` : `Pushed the working file to ${clients} connected page(s).`, fetch ? fetchLine(fetch) : ""].filter(Boolean).join("\n"));
572
686
  return EXIT.ok;
573
687
  }
574
688
  try {
@@ -581,8 +695,27 @@ async function runLive(args) {
581
695
  if (sub !== void 0) throw new UsageError(`Unknown "live ${sub}". Use \`live\`, \`live reload\` or \`live stop\`.`);
582
696
  const portFlag = flagValue(args, "port");
583
697
  const preferredPort = portFlag ? Number(portFlag) : DEFAULT_PORT;
698
+ const file = flagValue(args, "file");
699
+ const customBlock = flagValue(args, "custom-block");
700
+ const host = flagValue(args, "host");
701
+ if (customBlock && file) throw new UsageError("Pass either --file or --custom-block, not both.");
702
+ if (host && !customBlock) throw new UsageError("--host only applies with --custom-block.");
703
+ const fetchOn = args.flags.fetch === true;
704
+ if (fetchOn && !customBlock) throw new UsageError("--fetch only applies with --custom-block.");
705
+ const valuesRaw = flagValue(args, "values");
706
+ if (valuesRaw !== void 0 && !fetchOn) throw new UsageError("--values only applies with --fetch.");
707
+ const fetchValues = fetchOn ? parseValuesFlag(valuesRaw) : void 0;
708
+ const abs = (p) => isAbsolute(p) ? p : resolve(cwd, p);
709
+ const requested = {
710
+ mode: customBlock ? "custom-block" : "template",
711
+ path: abs(customBlock ?? file ?? join(".templatical", "template.json")),
712
+ ...host ? { host: abs(host) } : {},
713
+ ...fetchValues ? { fetch: fetchValues } : {}
714
+ };
584
715
  const existing = readPidfile(cwd);
585
716
  if (existing && processAlive(existing.pid)) {
717
+ const mode = existing.mode ?? "template";
718
+ if (mode !== requested.mode || existing.path !== void 0 && existing.path !== requested.path || mode === "custom-block" && (existing.host !== requested.host || JSON.stringify(existing.fetch) !== JSON.stringify(requested.fetch))) throw new UsageError(`A live server is already running for ${existing.path ?? "another file"} (${mode}). Run \`templatical live stop\` first.`);
586
719
  emit({
587
720
  url: `http://localhost:${existing.port}/`,
588
721
  pid: existing.pid,
@@ -591,16 +724,20 @@ async function runLive(args) {
591
724
  return EXIT.ok;
592
725
  }
593
726
  if (existing) rmSync(pidfilePath(cwd), { force: true });
594
- const file = flagValue(args, "file");
595
727
  const handle = await startBridgePreferring({
596
728
  cwd,
597
729
  preferredPort,
598
- file
730
+ file,
731
+ customBlock,
732
+ host,
733
+ ...fetchValues ? { fetch: { values: fetchValues } } : {}
599
734
  });
600
735
  mkdirSync(dirname(pidfilePath(cwd)), { recursive: true });
601
736
  writeFileSync(pidfilePath(cwd), JSON.stringify({
602
737
  pid: process.pid,
603
- port: handle.port
738
+ port: handle.port,
739
+ ...requested,
740
+ path: handle.workingPath
604
741
  }), "utf8");
605
742
  const cleanup = () => {
606
743
  rmSync(pidfilePath(cwd), { force: true });
@@ -608,16 +745,20 @@ async function runLive(args) {
608
745
  };
609
746
  process.on("SIGINT", cleanup);
610
747
  process.on("SIGTERM", cleanup);
748
+ const fetch = handle.lastFetch();
611
749
  emit({
612
750
  url: handle.url,
613
751
  port: handle.port,
614
752
  preferredPort,
615
753
  fellBack: handle.fellBack,
616
- workingFile: handle.workingPath
754
+ workingFile: handle.workingPath,
755
+ customBlock: customBlock ? handle.workingPath : void 0,
756
+ fetch: fetch ?? void 0
617
757
  }, () => [
618
758
  `Templatical live preview running at ${handle.url}`,
619
759
  handle.fellBack ? `(port ${preferredPort} was busy - using ${handle.port})` : "",
620
- `Working file: ${handle.workingPath}`
760
+ `${customBlock ? "Custom block" : "Working file"}: ${handle.workingPath}`,
761
+ fetch ? fetchLine(fetch) : ""
621
762
  ].filter(Boolean).join("\n"));
622
763
  if (args.flags["no-open"]) note(`Open ${handle.url} in a browser.`);
623
764
  else {
@@ -638,6 +779,11 @@ const USAGE = `templatical <command> [options]
638
779
  import <file> [--format <fmt>] | --list-formats convert a design to Templatical JSON
639
780
  live [--file <f>] [--port <n>] [--cwd <d>] [--no-open]
640
781
  live reload | live stop
782
+ custom-block validate <file> check a custom block definition
783
+ custom-block render <file> [--state <s>] [--format mjml|html] [-o <file>]
784
+ custom-block fetch <file> [--values '<json>'] run its dataSourcePreview once
785
+ live --custom-block <file> [--host <template>] [--fetch [--values '<json>']]
786
+ preview a custom block
641
787
  list working files in .templatical/
642
788
 
643
789
  Options:
@@ -654,6 +800,7 @@ async function main(argv) {
654
800
  case "import": return await runImport(args);
655
801
  case "live": return await runLive(args);
656
802
  case "list": return runList(args);
803
+ case "custom-block": return await runCustomBlock(args);
657
804
  case "help":
658
805
  note(USAGE);
659
806
  return EXIT.ok;
package/dist/bin.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"bin.js","names":["FORMATS","content"],"sources":["../src/cli/args.ts","../src/cli/output.ts","../src/cli/io.ts","../src/cli/commands/schema.ts","../src/cli/commands/validate.ts","../src/cli/resolve-optional.ts","../src/cli/commands/render.ts","../src/cli/commands/edit.ts","../src/cli/commands/import.ts","../src/cli/commands/live.ts","../src/bin.ts"],"sourcesContent":["// Argv parsing for the CLI. Deliberately hand-rolled: the package has no\n// runtime dependency for this, and the surface is a dozen flags.\n\n/** Flags that consume the next argv entry as their value. */\nconst VALUE_FLAGS = new Set([\n \"format\",\n \"out\",\n \"o\",\n \"op\",\n \"ops\",\n \"file\",\n \"port\",\n \"cwd\",\n]);\n\nexport interface ParsedArgs {\n command?: string;\n /** Everything that is not the command and not a flag — including subcommands. */\n positional: string[];\n json: boolean;\n flags: Record<string, string | true>;\n}\n\nexport function parseArgs(argv: string[]): ParsedArgs {\n const positional: string[] = [];\n const flags: Record<string, string | true> = {};\n let json = false;\n\n for (let i = 0; i < argv.length; i++) {\n const arg = argv[i];\n if (!arg.startsWith(\"-\")) {\n positional.push(arg);\n continue;\n }\n\n const bare = arg.replace(/^--?/, \"\");\n const eq = bare.indexOf(\"=\");\n if (eq !== -1) {\n flags[bare.slice(0, eq)] = bare.slice(eq + 1);\n continue;\n }\n if (bare === \"json\") {\n json = true;\n continue;\n }\n // A value flag at the end of argv has no value; record it as present so the\n // command reports a useful usage error rather than reading `undefined`.\n flags[bare] =\n VALUE_FLAGS.has(bare) && i + 1 < argv.length ? argv[++i] : true;\n }\n\n return { command: positional.shift(), positional, json, flags };\n}\n\n/** Read a value flag as a string, or undefined when absent or valueless. */\nexport function flagValue(\n args: ParsedArgs,\n ...names: string[]\n): string | undefined {\n for (const name of names) {\n const v = args.flags[name];\n if (typeof v === \"string\") return v;\n }\n return undefined;\n}\n","// The ONLY module in this package that writes to stdout.\n//\n// `--json` promises callers exactly one parseable document on stdout, and a\n// future stdio-based caller — an MCP server reserving stdout for JSON-RPC —\n// would need that to hold just as strictly. Either way a second writer\n// breaks the contract. tests/cli-output-discipline.test.ts asserts no other\n// source file touches stdout.\n\nlet jsonMode = false;\n\nexport function setJsonMode(on: boolean): void {\n jsonMode = on;\n}\n\nexport function isJsonMode(): boolean {\n return jsonMode;\n}\n\n/**\n * Emit a command's result. Under `--json` the payload is serialized; otherwise\n * `human()` is called for the readable form — as a thunk, so building the\n * pretty output costs nothing in JSON mode.\n */\nexport function emit(payload: unknown, human: () => string): void {\n process.stdout.write(\n jsonMode ? `${JSON.stringify(payload)}\\n` : `${human()}\\n`,\n );\n}\n\n/** Diagnostics, progress and errors. Always stderr, in both modes. */\nexport function note(message: string): void {\n process.stderr.write(`${message}\\n`);\n}\n","// Shared file IO and the error→exit-code contract.\n\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, resolve } from \"node:path\";\n\nexport const EXIT = {\n ok: 0,\n /** Structural errors, or quality issues of severity \"error\". */\n invalid: 1,\n /** Bad flags, missing arguments, unreadable input. */\n usage: 2,\n /** An optional dependency is not installed; the message names the install. */\n missingDep: 3,\n} as const;\n\nexport class UsageError extends Error {}\n\nexport class InvalidTemplateError extends Error {\n constructor(\n message: string,\n readonly errors: string[] = [],\n ) {\n super(message);\n }\n}\n\nexport class MissingDependencyError extends Error {\n constructor(\n readonly pkg: string,\n message: string,\n ) {\n super(message);\n }\n}\n\nexport function resolveFrom(file: string, cwd = process.cwd()): string {\n return isAbsolute(file) ? file : resolve(cwd, file);\n}\n\nexport function readTemplateFile(file: string, cwd = process.cwd()): unknown {\n const path = resolveFrom(file, cwd);\n let raw: string;\n try {\n raw = readFileSync(path, \"utf8\");\n } catch {\n throw new UsageError(`Could not read ${file}`);\n }\n try {\n return JSON.parse(raw);\n } catch (err) {\n throw new UsageError(\n `${file} is not valid JSON: ${(err as Error).message}`,\n );\n }\n}\n\n/** Write a template, creating the parent directory. Returns the path written. */\nexport function writeTemplateFile(\n file: string,\n content: unknown,\n cwd = process.cwd(),\n): string {\n const path = resolveFrom(file, cwd);\n mkdirSync(dirname(path), { recursive: true });\n writeFileSync(path, `${JSON.stringify(content, null, 2)}\\n`, \"utf8\");\n return path;\n}\n","import { flagValue, type ParsedArgs } from \"../args\";\nimport { emit, note } from \"../output\";\nimport { EXIT, writeTemplateFile } from \"../io\";\nimport { schema } from \"../../index\";\n\nexport function runSchema(args: ParsedArgs): number {\n const out = flagValue(args, \"out\", \"o\");\n if (out) {\n // writeTemplateFile JSON-stringifies with the same shape this command\n // wrote by hand, and creates the parent directory as a side effect.\n const path = writeTemplateFile(out, schema);\n // stdout stays empty: the caller asked for a file, and under --json a path\n // string would not be the document they are parsing for.\n note(`Wrote ${path}`);\n return EXIT.ok;\n }\n emit(schema, () => JSON.stringify(schema, null, 2));\n return EXIT.ok;\n}\n","import { flagValue, type ParsedArgs } from \"../args\";\nimport { emit, note } from \"../output\";\nimport { EXIT, readTemplateFile, UsageError } from \"../io\";\nimport { runQualityLint, validateTemplate } from \"../../index\";\n\nexport function runValidate(args: ParsedArgs): number {\n const file = args.positional[0];\n if (!file) throw new UsageError(\"validate needs a template file.\");\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n\n const data = readTemplateFile(file, cwd);\n const { valid, errors } = validateTemplate(data);\n\n if (!valid) {\n emit({ valid: false, errors, issues: [] }, () =>\n [\n `✗ Structural validation failed (${errors.length}):`,\n ...errors.map((e) => ` - ${e}`),\n ].join(\"\\n\"),\n );\n return EXIT.invalid;\n }\n\n // The linter assumes a structurally-valid template, so it runs only here.\n const quality = runQualityLint(data);\n if (quality.error) {\n note(`Quality lint could not run: ${quality.error}`);\n }\n\n const issues = quality.issues;\n const blocking = issues.filter((i) => i.severity === \"error\");\n\n emit({ valid: true, errors: [], issues }, () => {\n if (issues.length === 0) return \"✓ Valid — no quality issues\";\n const lines = issues.map(\n (i) => ` - [${i.severity}] ${i.ruleId}: ${i.message}`,\n );\n return [\n `✓ Structurally valid · ${issues.length} quality issue(s):`,\n ...lines,\n ].join(\"\\n\");\n });\n\n // A severity-\"error\" issue is a real defect, not advice, so it fails the\n // command — matching the script this replaces. Warnings and info do not.\n return blocking.length > 0 ? EXIT.invalid : EXIT.ok;\n}\n","//\n// Optional dependencies must resolve from the CONSUMER'S cwd, not from this\n// module's location. When the CLI runs via npx it lives in npm's cache, so a\n// package the user installs in their own project is invisible to the CLI's own\n// resolution — and the remediation message (\"npm install mjml\") would be\n// impossible to satisfy. Anchoring the walk at the cwd fixes that; the CLI's\n// own directory is tried second, as a fallback — not for ajv (a hard\n// `dependencies` entry, imported statically in src/validate.ts, so it never\n// passes through this function at all), but for a global install (`npm\n// install -g mjml` places the optional peer as a sibling of this package\n// under one shared global node_modules that only this anchor can reach) and\n// for this package's own tests, which anchor at a throwaway cwd outside the\n// repo and rely on this anchor climbing from inside the repo tree up to the\n// root node_modules holding the @templatical/import-* converters as root\n// devDependencies.\n//\n// Resolution deliberately does NOT go through require.resolve()/createRequire.\n// That API performs Node's CJS-invoked exports resolution, which checks the\n// condition list [\"require\", \"node\", \"default\"] and never \"import\" — so it\n// throws ERR_PACKAGE_PATH_NOT_EXPORTED for any package whose exports map\n// declares only \"import\", which is every first-party package in this monorepo\n// (ESM-only: `exports` exposes only the \"import\" condition, never \"require\"\n// or \"main\"). That map also omits \"./package.json\", so\n// require.resolve can't even read the manifest to look further. The result\n// under the old createRequire-based resolution: every @templatical/import-*\n// converter reported as \"not installed\" even when built and present on disk.\n// The ESM-native alternative, import.meta.resolve(specifier, parentURL),\n// would honor the right condition set and resolve this cwd-anchored — but its\n// second (parentURL) parameter, the one needed to anchor anywhere other than\n// this module's own URL, is documented as requiring the\n// --experimental-import-meta-resolve flag, and a published CLI that must run\n// un-flagged on Node 20 and 22 cannot bet a core resolution path on that.\n//\n// The fix walks node_modules directories by hand (findPackageDir) — a plain\n// filesystem read bypasses the exports map entirely — then reads the found\n// package's own package.json and picks its entry file directly\n// (entryFileFor), honoring exports[\".\"].import, a string exports[\".\"],\n// exports[\".\"].default, a root-string exports field, \"module\", then \"main\",\n// in that order.\n//\n// Returning null instead of throwing lets callers distinguish \"not installed\"\n// (exit 3, name the install command) from \"installed but broken\" (a real error\n// worth surfacing). Same discipline as tryLoadRenderer() in\n// packages/editor/src/utils/toMjml.ts: findPackageDir returning null is the\n// only thing that continues to the next anchor — a found package's own entry\n// resolution or import() is never caught, so a genuinely broken install\n// propagates as a real error rather than a misleading install hint.\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\n\ninterface ExportsConditions {\n import?: string;\n default?: string;\n}\n\ninterface PackageManifest {\n exports?: string | Record<string, string | ExportsConditions>;\n module?: string;\n main?: string;\n}\n\n/**\n * Walk up from `dir` through every ancestor's node_modules looking for\n * <specifier>/package.json — the same directory-walk Node's own resolver uses\n * to locate a package, without then asking Node to apply exports-map\n * resolution. `dir` is normalized to an absolute path via `resolve()` before\n * the walk starts, so a relative anchor (e.g. \".\") climbs real ancestors —\n * unnormalized, `dirname(\".\")` is \".\" forever and the walk would give up\n * after the first miss.\n */\nfunction findPackageDir(specifier: string, dir: string): string | null {\n let current = resolve(dir);\n for (;;) {\n const candidate = join(current, \"node_modules\", specifier);\n if (existsSync(join(candidate, \"package.json\"))) return candidate;\n const parent = dirname(current);\n if (parent === current) return null;\n current = parent;\n }\n}\n\n/**\n * Pick a found package's entry file straight from its own manifest, honoring\n * exports[\".\"].import, a string exports[\".\"], exports[\".\"].default, a\n * root-string exports field, \"module\", then \"main\" — the fields an ESM\n * consumer needs, read without Node's exports-map gating.\n */\nfunction entryFileFor(pkgDir: string): string {\n const manifest = JSON.parse(\n readFileSync(join(pkgDir, \"package.json\"), \"utf8\"),\n ) as PackageManifest;\n\n const dot =\n manifest.exports && typeof manifest.exports === \"object\"\n ? manifest.exports[\".\"]\n : undefined;\n const conditions = dot && typeof dot === \"object\" ? dot : undefined;\n // \"exports\": \"./dist/index.js\" — no \".\" key at all. PackageManifest already\n // types this shape; the code just never read it.\n const rootExports =\n typeof manifest.exports === \"string\" ? manifest.exports : undefined;\n\n const entry =\n conditions?.import ??\n (typeof dot === \"string\" ? dot : undefined) ??\n conditions?.default ??\n rootExports ??\n manifest.module ??\n manifest.main;\n\n // typeof, not just truthiness: the tsup/tsdown types-first shape nests\n // exports[\".\"].import as a further conditions object ({ types, default }),\n // not a string. Without this check that object flows into join() below and\n // throws a raw `TypeError: The \"path\" argument must be of type string`\n // instead of this function's own, actionable error.\n if (!entry || typeof entry !== \"string\") {\n throw new Error(\n `${pkgDir} has no resolvable entry point (exports/module/main).`,\n );\n }\n return join(pkgDir, entry);\n}\n\nexport async function resolveOptional<T>(\n specifier: string,\n cwd: string = process.cwd(),\n): Promise<T | null> {\n const anchors = [cwd, dirname(fileURLToPath(import.meta.url))];\n\n for (const anchor of anchors) {\n const pkgDir = findPackageDir(specifier, anchor);\n if (!pkgDir) continue; // not found from this anchor — try the next\n // Deliberately outside the try below: a manifest that names no usable\n // entry is a packaging fault the caller can act on, and it keeps throwing.\n const resolved = entryFileFor(pkgDir);\n try {\n return (await import(pathToFileURL(resolved).href)) as T;\n } catch {\n // The manifest is fine but the file it names isn't there — a workspace\n // package whose dist/ hasn't been built is the everyday case. \"Optional\"\n // has to cover this, or `import --list-formats`, whose whole job is to\n // report which converters resolve, crashes on the first one that doesn't.\n // Keep looking: a later anchor may hold a complete copy.\n continue;\n }\n }\n return null;\n}\n","import { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { renderToMjml } from \"@templatical/renderer\";\nimport type { TemplateContent } from \"@templatical/types\";\nimport { flagValue, type ParsedArgs } from \"../args\";\nimport { emit, note } from \"../output\";\nimport {\n EXIT,\n InvalidTemplateError,\n MissingDependencyError,\n readTemplateFile,\n resolveFrom,\n UsageError,\n} from \"../io\";\nimport { resolveOptional } from \"../resolve-optional\";\nimport { validateTemplate } from \"../../index\";\n\n// The mjml npm package's own top-level function (lib/index.js) is declared\n// `async`, so it always returns a Promise even though mjml-core's underlying\n// compile is synchronous — calling it without awaiting silently hands back a\n// pending Promise instead of { html, errors }.\ntype Mjml2Html = (\n mjml: string,\n options?: Record<string, unknown>,\n) => Promise<{ html: string; errors: unknown[] }>;\n\nconst FORMATS = new Set([\"mjml\", \"html\"]);\n\nexport async function runRender(args: ParsedArgs): Promise<number> {\n const file = args.positional[0];\n if (!file) throw new UsageError(\"render needs a template file.\");\n\n const format = flagValue(args, \"format\") ?? \"mjml\";\n if (!FORMATS.has(format)) {\n throw new UsageError(`Unknown --format \"${format}\". Use mjml or html.`);\n }\n\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n const data = readTemplateFile(file, cwd);\n\n // A structurally invalid template must fail with the error list (exit 1),\n // not surface as a renderer-internals crash (exit 2) — edit.ts validates\n // for the same reason before it writes.\n const { valid, errors } = validateTemplate(data);\n if (!valid) {\n throw new InvalidTemplateError(\n `${file} is not structurally valid (${errors.length} error(s)).`,\n errors,\n );\n }\n\n const content = data as TemplateContent;\n const mjml = await renderToMjml(content);\n\n let output = mjml;\n if (format === \"html\") {\n // The SDK bundles no MJML compiler by design, so there is no fallback to\n // reach for: a missing peer is a hard stop with an actionable message.\n const mod = await resolveOptional<{ default: Mjml2Html }>(\"mjml\", cwd);\n if (!mod) {\n throw new MissingDependencyError(\n \"mjml\",\n \"Rendering HTML needs the optional `mjml` package, which isn't installed.\\n npm install mjml\",\n );\n }\n output = (await mod.default(mjml, { validationLevel: \"soft\" })).html;\n }\n\n const out = flagValue(args, \"out\", \"o\");\n if (out) {\n const path = resolveFrom(out, cwd);\n // render writes raw text, not JSON, so it can't reuse writeTemplateFile —\n // create the parent directory directly instead.\n mkdirSync(dirname(path), { recursive: true });\n writeFileSync(path, output, \"utf8\");\n note(`Wrote ${path}`);\n return EXIT.ok;\n }\n\n emit({ format, output }, () => output);\n return EXIT.ok;\n}\n","import type {\n TemplateContent,\n TemplateOperationPayload,\n} from \"@templatical/types\";\nimport { flagValue, type ParsedArgs } from \"../args\";\nimport { emit } from \"../output\";\nimport {\n EXIT,\n InvalidTemplateError,\n readTemplateFile,\n UsageError,\n writeTemplateFile,\n} from \"../io\";\nimport { applyOperation, validateTemplate } from \"../../index\";\n\n/** What a caller supplies; `timestamp` is ours to fill. */\ninterface OperationInput {\n operation: TemplateOperationPayload[\"operation\"];\n data?: Record<string, unknown>;\n}\n\nfunction parseOperations(args: ParsedArgs, cwd: string): OperationInput[] {\n const inline = flagValue(args, \"op\");\n const batchFile = flagValue(args, \"ops\");\n // !== undefined, not truthy: flagValue returns \"\" for an explicitly-empty\n // flag, and a truthy check would let --op \"\" --ops <file> silently run the\n // batch instead of reporting that both were passed.\n if (inline !== undefined && batchFile !== undefined) {\n throw new UsageError(\"Pass either --op or --ops, not both.\");\n }\n if (inline) {\n try {\n return [JSON.parse(inline) as OperationInput];\n } catch (err) {\n throw new UsageError(`--op is not valid JSON: ${(err as Error).message}`);\n }\n }\n if (batchFile) {\n const parsed = readTemplateFile(batchFile, cwd);\n if (!Array.isArray(parsed)) {\n throw new UsageError(\"--ops must point at a JSON array of operations.\");\n }\n return parsed as OperationInput[];\n }\n throw new UsageError(\n \"edit needs --op '<json>' for one operation or --ops <file> for a batch.\",\n );\n}\n\nexport function runEdit(args: ParsedArgs): number {\n const file = args.positional[0];\n if (!file) throw new UsageError(\"edit needs a template file.\");\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n\n const operations = parseOperations(args, cwd);\n let content = readTemplateFile(file, cwd) as TemplateContent;\n\n // All-or-nothing: applyOperation returns the unchanged input on rejection, so\n // stopping at the first failure and discarding needs no rollback. Nothing is\n // written until every operation has succeeded.\n for (const [index, input] of operations.entries()) {\n const result = applyOperation(content, {\n operation: input.operation,\n data: input.data ?? {},\n timestamp: Date.now(),\n });\n if (!result.ok) {\n throw new UsageError(\n `Operation ${index + 1} (${String(input.operation)}) was rejected: ${result.error}`,\n );\n }\n content = result.content;\n }\n\n // An operation can produce a structurally invalid document, so validate\n // before writing: the working file must always be valid.\n const { valid, errors } = validateTemplate(content);\n if (!valid) {\n throw new InvalidTemplateError(\n `The edited template is not structurally valid (${errors.length} error(s)); ${file} was not written.`,\n errors,\n );\n }\n\n const path = writeTemplateFile(file, content, cwd);\n emit(\n { applied: operations.length, file: path },\n () => `Applied ${operations.length} operation(s) to ${path}`,\n );\n return EXIT.ok;\n}\n","// The format registry. A new @templatical/import-* converter is ONE entry here\n// and nothing else: reference/import.md documents the routing rule rather than\n// the list, and `--list-formats` answers what is resolvable at runtime. That is\n// what lets a new importer ship without a skill edit.\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { basename, extname } from \"node:path\";\nimport { flagValue, type ParsedArgs } from \"../args\";\nimport { emit } from \"../output\";\nimport {\n EXIT,\n MissingDependencyError,\n resolveFrom,\n UsageError,\n writeTemplateFile,\n} from \"../io\";\nimport { resolveOptional } from \"../resolve-optional\";\nimport { WORKING_DIR } from \"../../live/index\";\n\ninterface FormatSpec {\n pkg: string;\n /** The converter's exported function name. */\n fn: string;\n /**\n * What the converter is handed. `json` parses the source first, `text` passes\n * it through, and `stripo` unpacks a `{ html, css }` envelope — Stripo is the\n * one format whose export may arrive as either shape.\n */\n input: \"json\" | \"text\" | \"stripo\";\n}\n\nexport const FORMATS: Record<string, FormatSpec> = {\n unlayer: {\n pkg: \"@templatical/import-unlayer\",\n fn: \"convertUnlayerTemplate\",\n input: \"json\",\n },\n beefree: {\n pkg: \"@templatical/import-beefree\",\n fn: \"convertBeeFreeTemplate\",\n input: \"json\",\n },\n stripo: {\n pkg: \"@templatical/import-stripo\",\n fn: \"convertStripoTemplate\",\n input: \"stripo\",\n },\n topol: {\n pkg: \"@templatical/import-topol\",\n fn: \"convertTopolTemplate\",\n input: \"json\",\n },\n chamaileon: {\n pkg: \"@templatical/import-chamaileon\",\n fn: \"convertChamaileonTemplate\",\n input: \"json\",\n },\n \"easy-email-pro\": {\n pkg: \"@templatical/import-easy-email-pro\",\n fn: \"convertEasyEmailProTemplate\",\n input: \"json\",\n },\n mjml: {\n pkg: \"@templatical/import-mjml\",\n fn: \"convertMjmlTemplate\",\n input: \"text\",\n },\n html: {\n pkg: \"@templatical/import-html\",\n fn: \"convertHtmlTemplate\",\n input: \"text\",\n },\n};\n\n/** Strip a tag and its contents, so class scanning never reads CSS or script. */\nfunction withoutElements(html: string, tag: string): string {\n const open = `<${tag}`;\n const close = `</${tag}`;\n const lower = html.toLowerCase();\n let out = \"\";\n let pos = 0;\n while (pos < html.length) {\n const start = lower.indexOf(open, pos);\n if (start === -1) {\n out += html.slice(pos);\n break;\n }\n const next = lower[start + open.length];\n // `<style` matches `<styles>` too unless the next char ends the tag name.\n if (next !== undefined && /[a-z0-9-]/.test(next)) {\n out += html.slice(pos, start + open.length);\n pos = start + open.length;\n continue;\n }\n out += html.slice(pos, start);\n const gt = html.indexOf(\">\", start);\n if (gt === -1) break;\n const closeAt = lower.indexOf(close, gt + 1);\n if (closeAt === -1) break;\n const closeGt = html.indexOf(\">\", closeAt);\n if (closeGt === -1) break;\n out += \" \";\n pos = closeGt + 1;\n }\n return out;\n}\n\n/** Every class token in the markup, ignoring <style> and <script> contents. */\nfunction markupClassTokens(html: string): string[] {\n const stripped = withoutElements(withoutElements(html, \"style\"), \"script\");\n const tokens: string[] = [];\n const re = /\\bclass\\s*=\\s*([\"'])([^\"']*)\\1/gi;\n let m: RegExpExecArray | null;\n while ((m = re.exec(stripped))) {\n tokens.push(...m[2].trim().split(/\\s+/).filter(Boolean));\n }\n return tokens;\n}\n\n/** Stripo's own class prefixes, which survive both of its export shapes. */\nfunction looksLikeStripoHtml(html: unknown): boolean {\n if (typeof html !== \"string\" || html.trim().length === 0) return false;\n const tokens = markupClassTokens(html);\n if (\n tokens.some(\n (t) =>\n t === \"esd-stripe\" ||\n t === \"esd-structure\" ||\n t === \"esd-container-frame\" ||\n t.startsWith(\"esd-block-\"),\n )\n ) {\n return true;\n }\n return tokens.some(\n (t) =>\n t === \"es-wrapper\" || t === \"es-content-body\" || t === \"es-header-body\",\n );\n}\n\n/** Easy Email Pro marks its own nodes `standard-*`; OSS Easy Email does not. */\nfunction hasStandardType(node: unknown): boolean {\n if (!node || typeof node !== \"object\") return false;\n const n = node as { type?: unknown; children?: unknown };\n if (typeof n.type === \"string\" && n.type.startsWith(\"standard-\")) return true;\n if (Array.isArray(n.children)) return n.children.some(hasStandardType);\n return false;\n}\n\n/** Guess the source format, or null when the caller must pass --format. */\nexport function detectFormat(fileName: string, content: string): string | null {\n const ext = extname(fileName).toLowerCase();\n const trimmed = content.trimStart();\n\n // MJML is decided before both the extension check and the generic `<` branch:\n // an MJML document saved as .html is still MJML, and reading it as HTML\n // silently produces a table-soup import that looks like a bad converter.\n if (ext === \".mjml\") return \"mjml\";\n if (/^<(\\?xml[^>]*\\?>\\s*)?<?\\s*mjml[\\s>]/i.test(trimmed)) return \"mjml\";\n if (/^<\\s*mj-body[\\s>]/i.test(trimmed)) return \"mjml\";\n\n // Stripo's compiled File→HTML and its plugin storage are both `.html` (or a\n // JSON `{ html, css }` blob), so the class check must run before the generic\n // html branch or every Stripo export imports as table soup.\n if (looksLikeStripoHtml(content)) return \"stripo\";\n\n if (ext === \".html\" || ext === \".htm\") return \"html\";\n if (trimmed.startsWith(\"<\")) return \"html\";\n if (trimmed.startsWith(\"{\")) {\n let obj: {\n body?: { rows?: unknown; type?: unknown };\n page?: { rows?: unknown };\n tagName?: unknown;\n content?: { type?: unknown };\n type?: unknown;\n html?: unknown;\n };\n try {\n obj = JSON.parse(content);\n } catch {\n return null;\n }\n // Unlayer designs come from editor.saveDesign(): { body: { rows } }.\n if (obj?.body?.rows) return \"unlayer\";\n // BeeFree templates: { page: { rows } }.\n if (obj?.page?.rows) return \"beefree\";\n // Topol designs are an MJML-shaped tree rooted at the global style.\n if (obj?.tagName === \"mj-global-style\") return \"topol\";\n // Chamaileon getDocument(): { body: { type: \"body\" } }. Unlayer's\n // { body: { rows } } is matched above, so the order between them matters.\n if (obj?.body?.type === \"body\") return \"chamaileon\";\n // Easy Email Pro persist: { content: { type: \"page\" } } or a bare page,\n // distinguished from OSS Easy Email by its `standard-*` node types.\n const page =\n obj?.content?.type === \"page\"\n ? obj.content\n : obj?.type === \"page\"\n ? obj\n : null;\n if (page && hasStandardType(page)) return \"easy-email-pro\";\n // A plugin host often persists the whole getTemplateData() object.\n if (typeof obj?.html === \"string\" && looksLikeStripoHtml(obj.html)) {\n return \"stripo\";\n }\n return null;\n }\n return null;\n}\n\n/** Split a Stripo source into html + css, whichever shape it arrived in. */\nexport function unpackStripoSource(source: string): {\n html: string;\n css?: string;\n} {\n const trimmed = source.trimStart();\n if (trimmed.startsWith(\"{\")) {\n try {\n const obj = JSON.parse(source) as { html?: unknown; css?: unknown };\n if (typeof obj?.html === \"string\") {\n return {\n html: obj.html,\n css: typeof obj.css === \"string\" ? obj.css : undefined,\n };\n }\n } catch {\n // Not an envelope after all — treat the whole thing as markup.\n }\n }\n return { html: source };\n}\n\n/** The stylesheet a plugin host wrote beside an HTML export, if there is one. */\nfunction siblingCss(sourcePath: string, source: string): string | undefined {\n // A JSON envelope carries its own css; only a bare .html file has a sibling.\n if (source.trimStart().startsWith(\"{\")) return undefined;\n const cssPath = sourcePath.replace(/\\.[^.]+$/, \".css\");\n if (cssPath === sourcePath || !existsSync(cssPath)) return undefined;\n return readFileSync(cssPath, \"utf8\");\n}\n\nexport interface ReportCounts {\n total: number;\n converted: number;\n approximated: number;\n htmlFallback: number;\n skipped: number;\n warnings: string[];\n}\n\n/**\n * Status counts from a converter's report. Derived from `report.entries` (every\n * entry carries a `status`) rather than each package's own `summary` shape, so\n * it works identically across all three converters and any future one.\n */\nexport function summarizeReport(report: unknown): ReportCounts {\n const r = report as\n { entries?: Array<{ status?: string }>; warnings?: string[] } | undefined;\n const counts: ReportCounts = {\n total: 0,\n converted: 0,\n approximated: 0,\n htmlFallback: 0,\n skipped: 0,\n warnings: r?.warnings ?? [],\n };\n for (const e of r?.entries ?? []) {\n counts.total++;\n if (e.status === \"converted\") counts.converted++;\n else if (e.status === \"approximated\") counts.approximated++;\n else if (e.status === \"html-fallback\") counts.htmlFallback++;\n else if (e.status === \"skipped\") counts.skipped++;\n }\n return counts;\n}\n\nasync function listFormats(cwd: string): Promise<number> {\n const formats: Array<{\n format: string;\n package: string;\n available: boolean;\n }> = [];\n for (const [format, spec] of Object.entries(FORMATS)) {\n formats.push({\n format,\n package: spec.pkg,\n available: (await resolveOptional(spec.pkg, cwd)) !== null,\n });\n }\n emit({ formats }, () =>\n formats\n .map(\n (f) =>\n ` ${f.format.padEnd(14)} ${f.package}${f.available ? \"\" : \" (not installed)\"}`,\n )\n .join(\"\\n\"),\n );\n return EXIT.ok;\n}\n\nexport async function runImport(args: ParsedArgs): Promise<number> {\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n if (args.flags[\"list-formats\"]) return listFormats(cwd);\n\n const file = args.positional[0];\n if (!file) throw new UsageError(\"import needs a source file.\");\n const path = resolveFrom(file, cwd);\n\n let source: string;\n try {\n source = readFileSync(path, \"utf8\");\n } catch {\n throw new UsageError(`Could not read ${file}`);\n }\n\n const known = Object.keys(FORMATS).join(\", \");\n const requested = flagValue(args, \"format\");\n if (requested && !FORMATS[requested]) {\n throw new UsageError(\n `Unknown --format \"${requested}\". Known formats: ${known}.`,\n );\n }\n const format = requested ?? detectFormat(path, source);\n if (!format) {\n throw new UsageError(\n `Could not detect the format of ${file}. Pass --format with one of: ${known}.`,\n );\n }\n\n const spec = FORMATS[format];\n const mod = await resolveOptional<Record<string, unknown>>(spec.pkg, cwd);\n if (!mod) {\n throw new MissingDependencyError(\n spec.pkg,\n `Importing ${format} needs ${spec.pkg}, which isn't installed.\\n npm install ${spec.pkg}`,\n );\n }\n const convert = mod[spec.fn] as (\n input: unknown,\n options?: unknown,\n ) => {\n content: unknown;\n report: unknown;\n };\n\n let content: unknown;\n let report: unknown;\n if (spec.input === \"stripo\") {\n // Plugin storage keeps the stylesheet out of the markup — either beside the\n // html in one JSON envelope, or as a sibling .css file the host wrote next\n // to it. Without the CSS every block imports unstyled, which reads as a\n // broken converter rather than a missing file.\n const unpacked = unpackStripoSource(source);\n const css = unpacked.css ?? siblingCss(path, source);\n ({ content, report } = convert(unpacked.html, css ? { css } : undefined));\n } else {\n const input = spec.input === \"json\" ? JSON.parse(source) : source;\n ({ content, report } = convert(input));\n }\n\n const outName = flagValue(args, \"out\") ?? basename(path, extname(path));\n const written = writeTemplateFile(\n `${WORKING_DIR}/${outName}.json`,\n content,\n cwd,\n );\n\n const counts = summarizeReport(report);\n const lossy = counts.htmlFallback + counts.skipped > 0;\n emit({ format, file: written, report: counts }, () =>\n [\n `Imported ${format} to ${written}`,\n ` ${counts.converted} converted, ${counts.approximated} approximated, ${counts.htmlFallback} html fallback, ${counts.skipped} skipped`,\n ...counts.warnings.map((w) => ` ! ${w}`),\n lossy\n ? \" Import is lossy. Open it in live mode and refine the fallback blocks.\"\n : \"\",\n ]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n return EXIT.ok;\n}\n","import { mkdirSync, rmSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { flagValue, type ParsedArgs } from \"../args\";\nimport { emit, note } from \"../output\";\nimport { EXIT, resolveFrom, UsageError } from \"../io\";\nimport {\n DEFAULT_PORT,\n listWorkingFiles,\n openBrowser,\n pidfilePath,\n processAlive,\n readPidfile,\n readWorkingFile,\n startBridgePreferring,\n WORKING_DIR,\n} from \"../../live/index\";\n\n/**\n * The first title block's text in document order, as a hint for `list`.\n *\n * It must descend into a section's columns, not scan top-level blocks only:\n * templates put their content inside sections (that is the documented\n * structure), so a top-level scan finds nothing for a real template. Measured\n * across all five of the templatical skill's examples — event-invite, newsletter,\n * product-sale, receipt, welcome — none has a top-level title block, so a\n * shallow version of this returns null every time and the hint is dead code.\n */\nfunction titleHint(content: unknown): string | null {\n return findTitle((content as { blocks?: unknown })?.blocks);\n}\n\nfunction findTitle(blocks: unknown): string | null {\n if (!Array.isArray(blocks)) return null;\n for (const block of blocks as Array<{\n type?: string;\n content?: string;\n children?: unknown[];\n }>) {\n if (block?.type === \"title\" && typeof block.content === \"string\") {\n return block.content;\n }\n if (block?.type === \"section\" && Array.isArray(block.children)) {\n for (const column of block.children) {\n const hit = findTitle(column);\n if (hit) return hit;\n }\n }\n }\n return null;\n}\n\nexport function runList(args: ParsedArgs): number {\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n const templates = listWorkingFiles(cwd).map((name) => ({\n name,\n title: titleHint(readWorkingFile(join(cwd, WORKING_DIR, name))),\n }));\n emit({ templates }, () =>\n templates.length === 0\n ? `No templates in ${WORKING_DIR}/`\n : templates\n .map((t) => ` ${t.name}${t.title ? ` - ${t.title}` : \"\"}`)\n .join(\"\\n\"),\n );\n return EXIT.ok;\n}\n\nasync function postTo(\n port: number,\n path: string,\n body?: unknown,\n): Promise<Response> {\n return fetch(`http://localhost:${port}${path}`, {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\" },\n body: body === undefined ? undefined : JSON.stringify(body),\n });\n}\n\nexport async function runLive(args: ParsedArgs): Promise<number> {\n const sub = args.positional[0];\n const cwd = resolveFrom(flagValue(args, \"cwd\") ?? \".\", process.cwd());\n\n if (sub === \"reload\" || sub === \"stop\") {\n const info = readPidfile(cwd);\n if (!info || !processAlive(info.pid)) {\n throw new UsageError(\n `No live server is running here (no live pidfile at ${WORKING_DIR}/live-server.pid).`,\n );\n }\n if (sub === \"reload\") {\n const consumeAnnotations = args.flags[\"consume-annotations\"] === true;\n const res = await postTo(\n info.port,\n \"/reload\",\n consumeAnnotations ? { consumeAnnotations: true } : undefined,\n );\n const body = (await res.json().catch(() => ({}))) as {\n clients?: number;\n consumed?: boolean;\n };\n emit(\n {\n reloaded: true,\n clients: body.clients ?? 0,\n consumed: body.consumed === true,\n },\n () =>\n `Pushed the working file to ${body.clients ?? 0} connected page(s).`,\n );\n return EXIT.ok;\n }\n try {\n process.kill(info.pid, \"SIGTERM\");\n } catch {\n /* already gone */\n }\n rmSync(pidfilePath(cwd), { force: true });\n emit({ stopped: true }, () => \"Stopped the live server.\");\n return EXIT.ok;\n }\n\n if (sub !== undefined) {\n throw new UsageError(\n `Unknown \"live ${sub}\". Use \\`live\\`, \\`live reload\\` or \\`live stop\\`.`,\n );\n }\n\n // start\n const portFlag = flagValue(args, \"port\");\n const preferredPort = portFlag ? Number(portFlag) : DEFAULT_PORT;\n const existing = readPidfile(cwd);\n if (existing && processAlive(existing.pid)) {\n emit(\n {\n url: `http://localhost:${existing.port}/`,\n pid: existing.pid,\n alreadyRunning: true,\n },\n () =>\n `Live server already running (pid ${existing.pid}) at http://localhost:${existing.port}/`,\n );\n return EXIT.ok;\n }\n if (existing) rmSync(pidfilePath(cwd), { force: true }); // stale\n\n const file = flagValue(args, \"file\");\n const handle = await startBridgePreferring({ cwd, preferredPort, file });\n\n mkdirSync(dirname(pidfilePath(cwd)), { recursive: true });\n writeFileSync(\n pidfilePath(cwd),\n JSON.stringify({ pid: process.pid, port: handle.port }),\n \"utf8\",\n );\n\n const cleanup = () => {\n rmSync(pidfilePath(cwd), { force: true });\n handle.close().finally(() => process.exit(EXIT.ok));\n };\n process.on(\"SIGINT\", cleanup);\n process.on(\"SIGTERM\", cleanup);\n\n // Emit before blocking: the caller needs the URL and the working path now,\n // not when the server shuts down.\n emit(\n {\n url: handle.url,\n port: handle.port,\n preferredPort,\n fellBack: handle.fellBack,\n workingFile: handle.workingPath,\n },\n () =>\n [\n `Templatical live preview running at ${handle.url}`,\n handle.fellBack\n ? `(port ${preferredPort} was busy - using ${handle.port})`\n : \"\",\n `Working file: ${handle.workingPath}`,\n ]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n\n if (args.flags[\"no-open\"]) {\n note(`Open ${handle.url} in a browser.`);\n } else {\n note(`Opening ${handle.url} in your default browser...`);\n openBrowser(handle.url);\n }\n note(\"After writing the working file, run: templatical live reload\");\n\n // Block: the bridge owns the process until a signal arrives.\n return new Promise<number>(() => {});\n}\n","#!/usr/bin/env node\n// The CLI entry point.\n//\n// Every command is a thin shell over this package's library functions; the\n// dispatch below owns argument handling, the error→exit-code mapping, and\n// nothing else. Human-facing output goes through cli/output.ts.\n\nimport { realpathSync } from \"node:fs\";\nimport { pathToFileURL } from \"node:url\";\nimport { parseArgs } from \"./cli/args\";\nimport { note, setJsonMode } from \"./cli/output\";\nimport {\n EXIT,\n InvalidTemplateError,\n MissingDependencyError,\n UsageError,\n} from \"./cli/io\";\nimport { runSchema } from \"./cli/commands/schema\";\nimport { runValidate } from \"./cli/commands/validate\";\nimport { runRender } from \"./cli/commands/render\";\nimport { runEdit } from \"./cli/commands/edit\";\nimport { runImport } from \"./cli/commands/import\";\nimport { runList, runLive } from \"./cli/commands/live\";\n\nconst USAGE = `templatical <command> [options]\n\n validate <file> structural + quality lint\n schema [--out <file>] print the block JSON Schema\n render <file> [--format mjml|html] [-o <file>] render to MJML or HTML\n edit <file> --op '<json>' | --ops <file> apply operations, write the result\n import <file> [--format <fmt>] | --list-formats convert a design to Templatical JSON\n live [--file <f>] [--port <n>] [--cwd <d>] [--no-open]\n live reload | live stop\n list working files in .templatical/\n\nOptions:\n --json machine-readable output on stdout\n`;\n\nexport async function main(argv: string[]): Promise<number> {\n const args = parseArgs(argv);\n setJsonMode(args.json);\n\n switch (args.command) {\n case \"validate\":\n return runValidate(args);\n case \"schema\":\n return runSchema(args);\n case \"render\":\n return await runRender(args);\n case \"edit\":\n return runEdit(args);\n case \"import\":\n return await runImport(args);\n case \"live\":\n return await runLive(args);\n case \"list\":\n return runList(args);\n case \"help\":\n note(USAGE);\n return EXIT.ok;\n case undefined:\n // parseArgs strips leading dashes into flags, so `--help`/`-h` never\n // reach args.command — they land here, not on a (dead) case \"--help\".\n // Asking for help is not a usage error; a bare invocation still is.\n if (args.flags.help === true || args.flags.h === true) {\n note(USAGE);\n return EXIT.ok;\n }\n note(USAGE);\n return EXIT.usage;\n default:\n note(`Unknown command \"${args.command}\".\\n\\n${USAGE}`);\n return EXIT.usage;\n }\n}\n\n// Only self-invoke when run as the CLI entry point, not when imported — this\n// package's own tests import `main` directly to exercise the dispatch above\n// without spawning a subprocess.\n//\n// import.meta.url is always a realpath, but process.argv[1] is not: npm's\n// `bin` field links a real symlink into the consumer's node_modules/.bin\n// (e.g. node_modules/.bin/templatical -> ../@templatical/template-tools/dist/bin.js),\n// and Node leaves argv[1] as that symlink path instead of resolving it.\n// Comparing them directly is false for every consumer who runs the published\n// binary, so main() would silently never run. realpathSync(argv[1]) resolves\n// the symlink so both sides name the same file.\nexport function isEntryPoint(): boolean {\n const argv1 = process.argv[1];\n if (!argv1) return false;\n try {\n return pathToFileURL(realpathSync(argv1)).href === import.meta.url;\n } catch {\n // realpathSync throws (e.g. ENOENT) if argv[1] doesn't exist or can't be\n // read. This guard runs at module load, so failing open into a crash\n // would be worse than just not self-invoking.\n return false;\n }\n}\n\nif (isEntryPoint()) {\n main(process.argv.slice(2))\n .then((code) => process.exit(code))\n .catch((err: unknown) => {\n if (err instanceof InvalidTemplateError) {\n note(err.message);\n for (const e of err.errors) note(` - ${e}`);\n process.exit(EXIT.invalid);\n }\n if (err instanceof MissingDependencyError) {\n note(err.message);\n process.exit(EXIT.missingDep);\n }\n if (err instanceof UsageError) {\n note(err.message);\n process.exit(EXIT.usage);\n }\n note(`Unexpected error: ${(err as Error)?.message ?? String(err)}`);\n process.exit(EXIT.usage);\n });\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"bin.js","names":["FORMATS","content","USAGE"],"sources":["../src/cli/args.ts","../src/cli/output.ts","../src/cli/io.ts","../src/cli/commands/schema.ts","../src/cli/commands/validate.ts","../src/cli/resolve-optional.ts","../src/cli/mjml.ts","../src/cli/commands/render.ts","../src/cli/commands/edit.ts","../src/cli/commands/import.ts","../src/cli/commands/custom-block.ts","../src/cli/commands/live.ts","../src/bin.ts"],"sourcesContent":["// Argv parsing for the CLI. Deliberately hand-rolled: the package has no\n// runtime dependency for this, and the surface is a dozen flags.\n\n/** Flags that consume the next argv entry as their value. */\nconst VALUE_FLAGS = new Set([\n \"format\",\n \"out\",\n \"o\",\n \"op\",\n \"ops\",\n \"file\",\n \"port\",\n \"cwd\",\n \"state\",\n \"values\",\n \"custom-block\",\n \"host\",\n]);\n\nexport interface ParsedArgs {\n command?: string;\n /** Everything that is not the command and not a flag — including subcommands. */\n positional: string[];\n json: boolean;\n flags: Record<string, string | true>;\n}\n\nexport function parseArgs(argv: string[]): ParsedArgs {\n const positional: string[] = [];\n const flags: Record<string, string | true> = {};\n let json = false;\n\n for (let i = 0; i < argv.length; i++) {\n const arg = argv[i];\n if (!arg.startsWith(\"-\")) {\n positional.push(arg);\n continue;\n }\n\n const bare = arg.replace(/^--?/, \"\");\n const eq = bare.indexOf(\"=\");\n if (eq !== -1) {\n flags[bare.slice(0, eq)] = bare.slice(eq + 1);\n continue;\n }\n if (bare === \"json\") {\n json = true;\n continue;\n }\n // A value flag at the end of argv has no value; record it as present so the\n // command reports a useful usage error rather than reading `undefined`.\n flags[bare] =\n VALUE_FLAGS.has(bare) && i + 1 < argv.length ? argv[++i] : true;\n }\n\n return { command: positional.shift(), positional, json, flags };\n}\n\n/** Read a value flag as a string, or undefined when absent or valueless. */\nexport function flagValue(\n args: ParsedArgs,\n ...names: string[]\n): string | undefined {\n for (const name of names) {\n const v = args.flags[name];\n if (typeof v === \"string\") return v;\n }\n return undefined;\n}\n","// The ONLY module in this package that writes to stdout.\n//\n// `--json` promises callers exactly one parseable document on stdout, and a\n// future stdio-based caller — an MCP server reserving stdout for JSON-RPC —\n// would need that to hold just as strictly. Either way a second writer\n// breaks the contract. tests/cli-output-discipline.test.ts asserts no other\n// source file touches stdout.\n\nlet jsonMode = false;\n\nexport function setJsonMode(on: boolean): void {\n jsonMode = on;\n}\n\nexport function isJsonMode(): boolean {\n return jsonMode;\n}\n\n/**\n * Emit a command's result. Under `--json` the payload is serialized; otherwise\n * `human()` is called for the readable form — as a thunk, so building the\n * pretty output costs nothing in JSON mode.\n */\nexport function emit(payload: unknown, human: () => string): void {\n process.stdout.write(\n jsonMode ? `${JSON.stringify(payload)}\\n` : `${human()}\\n`,\n );\n}\n\n/** Diagnostics, progress and errors. Always stderr, in both modes. */\nexport function note(message: string): void {\n process.stderr.write(`${message}\\n`);\n}\n","// Shared file IO and the error→exit-code contract.\n\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, resolve } from \"node:path\";\n\nexport const EXIT = {\n ok: 0,\n /** Structural errors, or quality issues of severity \"error\". */\n invalid: 1,\n /** Bad flags, missing arguments, unreadable input. */\n usage: 2,\n /** An optional dependency is not installed; the message names the install. */\n missingDep: 3,\n} as const;\n\nexport class UsageError extends Error {}\n\nexport class InvalidTemplateError extends Error {\n constructor(\n message: string,\n readonly errors: string[] = [],\n ) {\n super(message);\n }\n}\n\nexport class MissingDependencyError extends Error {\n constructor(\n readonly pkg: string,\n message: string,\n ) {\n super(message);\n }\n}\n\nexport function resolveFrom(file: string, cwd = process.cwd()): string {\n return isAbsolute(file) ? file : resolve(cwd, file);\n}\n\nexport function readTemplateFile(file: string, cwd = process.cwd()): unknown {\n const path = resolveFrom(file, cwd);\n let raw: string;\n try {\n raw = readFileSync(path, \"utf8\");\n } catch {\n throw new UsageError(`Could not read ${file}`);\n }\n try {\n return JSON.parse(raw);\n } catch (err) {\n throw new UsageError(\n `${file} is not valid JSON: ${(err as Error).message}`,\n );\n }\n}\n\n/** Write a template, creating the parent directory. Returns the path written. */\nexport function writeTemplateFile(\n file: string,\n content: unknown,\n cwd = process.cwd(),\n): string {\n const path = resolveFrom(file, cwd);\n mkdirSync(dirname(path), { recursive: true });\n writeFileSync(path, `${JSON.stringify(content, null, 2)}\\n`, \"utf8\");\n return path;\n}\n","import { flagValue, type ParsedArgs } from \"../args\";\nimport { emit, note } from \"../output\";\nimport { EXIT, writeTemplateFile } from \"../io\";\nimport { schema } from \"../../index\";\n\nexport function runSchema(args: ParsedArgs): number {\n const out = flagValue(args, \"out\", \"o\");\n if (out) {\n // writeTemplateFile JSON-stringifies with the same shape this command\n // wrote by hand, and creates the parent directory as a side effect.\n const path = writeTemplateFile(out, schema);\n // stdout stays empty: the caller asked for a file, and under --json a path\n // string would not be the document they are parsing for.\n note(`Wrote ${path}`);\n return EXIT.ok;\n }\n emit(schema, () => JSON.stringify(schema, null, 2));\n return EXIT.ok;\n}\n","import { flagValue, type ParsedArgs } from \"../args\";\nimport { emit, note } from \"../output\";\nimport { EXIT, readTemplateFile, UsageError } from \"../io\";\nimport { runQualityLint, validateTemplate } from \"../../index\";\n\nexport function runValidate(args: ParsedArgs): number {\n const file = args.positional[0];\n if (!file) throw new UsageError(\"validate needs a template file.\");\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n\n const data = readTemplateFile(file, cwd);\n const { valid, errors } = validateTemplate(data);\n\n if (!valid) {\n emit({ valid: false, errors, issues: [] }, () =>\n [\n `✗ Structural validation failed (${errors.length}):`,\n ...errors.map((e) => ` - ${e}`),\n ].join(\"\\n\"),\n );\n return EXIT.invalid;\n }\n\n // The linter assumes a structurally-valid template, so it runs only here.\n const quality = runQualityLint(data);\n if (quality.error) {\n note(`Quality lint could not run: ${quality.error}`);\n }\n\n const issues = quality.issues;\n const blocking = issues.filter((i) => i.severity === \"error\");\n\n emit({ valid: true, errors: [], issues }, () => {\n if (issues.length === 0) return \"✓ Valid — no quality issues\";\n const lines = issues.map(\n (i) => ` - [${i.severity}] ${i.ruleId}: ${i.message}`,\n );\n return [\n `✓ Structurally valid · ${issues.length} quality issue(s):`,\n ...lines,\n ].join(\"\\n\");\n });\n\n // A severity-\"error\" issue is a real defect, not advice, so it fails the\n // command — matching the script this replaces. Warnings and info do not.\n return blocking.length > 0 ? EXIT.invalid : EXIT.ok;\n}\n","//\n// Optional dependencies must resolve from the CONSUMER'S cwd, not from this\n// module's location. When the CLI runs via npx it lives in npm's cache, so a\n// package the user installs in their own project is invisible to the CLI's own\n// resolution — and the remediation message (\"npm install mjml\") would be\n// impossible to satisfy. Anchoring the walk at the cwd fixes that; the CLI's\n// own directory is tried second, as a fallback — not for ajv (a hard\n// `dependencies` entry, imported statically in src/validate.ts, so it never\n// passes through this function at all), but for a global install (`npm\n// install -g mjml` places the optional peer as a sibling of this package\n// under one shared global node_modules that only this anchor can reach) and\n// for this package's own tests, which anchor at a throwaway cwd outside the\n// repo and rely on this anchor climbing from inside the repo tree up to the\n// root node_modules holding the @templatical/import-* converters as root\n// devDependencies.\n//\n// Resolution deliberately does NOT go through require.resolve()/createRequire.\n// That API performs Node's CJS-invoked exports resolution, which checks the\n// condition list [\"require\", \"node\", \"default\"] and never \"import\" — so it\n// throws ERR_PACKAGE_PATH_NOT_EXPORTED for any package whose exports map\n// declares only \"import\", which is every first-party package in this monorepo\n// (ESM-only: `exports` exposes only the \"import\" condition, never \"require\"\n// or \"main\"). That map also omits \"./package.json\", so\n// require.resolve can't even read the manifest to look further. The result\n// under the old createRequire-based resolution: every @templatical/import-*\n// converter reported as \"not installed\" even when built and present on disk.\n// The ESM-native alternative, import.meta.resolve(specifier, parentURL),\n// would honor the right condition set and resolve this cwd-anchored — but its\n// second (parentURL) parameter, the one needed to anchor anywhere other than\n// this module's own URL, is documented as requiring the\n// --experimental-import-meta-resolve flag, and a published CLI that must run\n// un-flagged on Node 20 and 22 cannot bet a core resolution path on that.\n//\n// The fix walks node_modules directories by hand (findPackageDir) — a plain\n// filesystem read bypasses the exports map entirely — then reads the found\n// package's own package.json and picks its entry file directly\n// (entryFileFor), honoring exports[\".\"].import, a string exports[\".\"],\n// exports[\".\"].default, a root-string exports field, \"module\", then \"main\",\n// in that order.\n//\n// Returning null instead of throwing lets callers distinguish \"not installed\"\n// (exit 3, name the install command) from \"installed but broken\" (a real error\n// worth surfacing). Same discipline as tryLoadRenderer() in\n// packages/editor/src/utils/toMjml.ts: findPackageDir returning null is the\n// only thing that continues to the next anchor — a found package's own entry\n// resolution or import() is never caught, so a genuinely broken install\n// propagates as a real error rather than a misleading install hint.\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\n\ninterface ExportsConditions {\n import?: string;\n default?: string;\n}\n\ninterface PackageManifest {\n exports?: string | Record<string, string | ExportsConditions>;\n module?: string;\n main?: string;\n}\n\n/**\n * Walk up from `dir` through every ancestor's node_modules looking for\n * <specifier>/package.json — the same directory-walk Node's own resolver uses\n * to locate a package, without then asking Node to apply exports-map\n * resolution. `dir` is normalized to an absolute path via `resolve()` before\n * the walk starts, so a relative anchor (e.g. \".\") climbs real ancestors —\n * unnormalized, `dirname(\".\")` is \".\" forever and the walk would give up\n * after the first miss.\n */\nfunction findPackageDir(specifier: string, dir: string): string | null {\n let current = resolve(dir);\n for (;;) {\n const candidate = join(current, \"node_modules\", specifier);\n if (existsSync(join(candidate, \"package.json\"))) return candidate;\n const parent = dirname(current);\n if (parent === current) return null;\n current = parent;\n }\n}\n\n/**\n * Pick a found package's entry file straight from its own manifest, honoring\n * exports[\".\"].import, a string exports[\".\"], exports[\".\"].default, a\n * root-string exports field, \"module\", then \"main\" — the fields an ESM\n * consumer needs, read without Node's exports-map gating.\n */\nfunction entryFileFor(pkgDir: string): string {\n const manifest = JSON.parse(\n readFileSync(join(pkgDir, \"package.json\"), \"utf8\"),\n ) as PackageManifest;\n\n const dot =\n manifest.exports && typeof manifest.exports === \"object\"\n ? manifest.exports[\".\"]\n : undefined;\n const conditions = dot && typeof dot === \"object\" ? dot : undefined;\n // \"exports\": \"./dist/index.js\" — no \".\" key at all. PackageManifest already\n // types this shape; the code just never read it.\n const rootExports =\n typeof manifest.exports === \"string\" ? manifest.exports : undefined;\n\n const entry =\n conditions?.import ??\n (typeof dot === \"string\" ? dot : undefined) ??\n conditions?.default ??\n rootExports ??\n manifest.module ??\n manifest.main;\n\n // typeof, not just truthiness: the tsup/tsdown types-first shape nests\n // exports[\".\"].import as a further conditions object ({ types, default }),\n // not a string. Without this check that object flows into join() below and\n // throws a raw `TypeError: The \"path\" argument must be of type string`\n // instead of this function's own, actionable error.\n if (!entry || typeof entry !== \"string\") {\n throw new Error(\n `${pkgDir} has no resolvable entry point (exports/module/main).`,\n );\n }\n return join(pkgDir, entry);\n}\n\nexport async function resolveOptional<T>(\n specifier: string,\n cwd: string = process.cwd(),\n): Promise<T | null> {\n const anchors = [cwd, dirname(fileURLToPath(import.meta.url))];\n\n for (const anchor of anchors) {\n const pkgDir = findPackageDir(specifier, anchor);\n if (!pkgDir) continue; // not found from this anchor — try the next\n // Deliberately outside the try below: a manifest that names no usable\n // entry is a packaging fault the caller can act on, and it keeps throwing.\n const resolved = entryFileFor(pkgDir);\n try {\n return (await import(pathToFileURL(resolved).href)) as T;\n } catch {\n // The manifest is fine but the file it names isn't there — a workspace\n // package whose dist/ hasn't been built is the everyday case. \"Optional\"\n // has to cover this, or `import --list-formats`, whose whole job is to\n // report which converters resolve, crashes on the first one that doesn't.\n // Keep looking: a later anchor may hold a complete copy.\n continue;\n }\n }\n return null;\n}\n","// The optional `mjml` peer, resolved from the user's cwd first. The SDK\n// bundles no MJML compiler by design, so a missing peer is either skipped\n// (validate) or a hard stop with an install hint (render --format html).\n//\n// The mjml package's top-level function is `async`, so it always returns a\n// Promise even though the underlying compile is synchronous.\n\nimport { MissingDependencyError } from \"./io\";\nimport { resolveOptional } from \"./resolve-optional\";\n\nexport type Mjml2Html = (\n mjml: string,\n options?: Record<string, unknown>,\n) => Promise<{ html: string; errors: unknown[] }>;\n\nexport async function loadMjml(cwd: string): Promise<Mjml2Html | null> {\n const mod = await resolveOptional<{ default: Mjml2Html }>(\"mjml\", cwd);\n return mod ? mod.default : null;\n}\n\nexport async function requireMjml(\n cwd: string,\n purpose: string,\n): Promise<Mjml2Html> {\n const mjml = await loadMjml(cwd);\n if (!mjml) {\n throw new MissingDependencyError(\n \"mjml\",\n `${purpose} needs the optional \\`mjml\\` package, which isn't installed.\\n npm install mjml`,\n );\n }\n return mjml;\n}\n","import { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { renderToMjml } from \"@templatical/renderer\";\nimport type { TemplateContent } from \"@templatical/types\";\nimport { flagValue, type ParsedArgs } from \"../args\";\nimport { emit, note } from \"../output\";\nimport {\n EXIT,\n InvalidTemplateError,\n readTemplateFile,\n resolveFrom,\n UsageError,\n} from \"../io\";\nimport { requireMjml } from \"../mjml\";\nimport { validateTemplate } from \"../../index\";\n\nconst FORMATS = new Set([\"mjml\", \"html\"]);\n\nexport async function runRender(args: ParsedArgs): Promise<number> {\n const file = args.positional[0];\n if (!file) throw new UsageError(\"render needs a template file.\");\n\n const format = flagValue(args, \"format\") ?? \"mjml\";\n if (!FORMATS.has(format)) {\n throw new UsageError(`Unknown --format \"${format}\". Use mjml or html.`);\n }\n\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n const data = readTemplateFile(file, cwd);\n\n // A structurally invalid template must fail with the error list (exit 1),\n // not surface as a renderer-internals crash (exit 2) — edit.ts validates\n // for the same reason before it writes.\n const { valid, errors } = validateTemplate(data);\n if (!valid) {\n throw new InvalidTemplateError(\n `${file} is not structurally valid (${errors.length} error(s)).`,\n errors,\n );\n }\n\n const content = data as TemplateContent;\n const mjml = await renderToMjml(content);\n\n let output = mjml;\n if (format === \"html\") {\n const compile = await requireMjml(cwd, \"Rendering HTML\");\n output = (await compile(mjml, { validationLevel: \"soft\" })).html;\n }\n\n const out = flagValue(args, \"out\", \"o\");\n if (out) {\n const path = resolveFrom(out, cwd);\n // render writes raw text, not JSON, so it can't reuse writeTemplateFile —\n // create the parent directory directly instead.\n mkdirSync(dirname(path), { recursive: true });\n writeFileSync(path, output, \"utf8\");\n note(`Wrote ${path}`);\n return EXIT.ok;\n }\n\n emit({ format, output }, () => output);\n return EXIT.ok;\n}\n","import type {\n TemplateContent,\n TemplateOperationPayload,\n} from \"@templatical/types\";\nimport { flagValue, type ParsedArgs } from \"../args\";\nimport { emit } from \"../output\";\nimport {\n EXIT,\n InvalidTemplateError,\n readTemplateFile,\n UsageError,\n writeTemplateFile,\n} from \"../io\";\nimport { applyOperation, validateTemplate } from \"../../index\";\n\n/** What a caller supplies; `timestamp` is ours to fill. */\ninterface OperationInput {\n operation: TemplateOperationPayload[\"operation\"];\n data?: Record<string, unknown>;\n}\n\nfunction parseOperations(args: ParsedArgs, cwd: string): OperationInput[] {\n const inline = flagValue(args, \"op\");\n const batchFile = flagValue(args, \"ops\");\n // !== undefined, not truthy: flagValue returns \"\" for an explicitly-empty\n // flag, and a truthy check would let --op \"\" --ops <file> silently run the\n // batch instead of reporting that both were passed.\n if (inline !== undefined && batchFile !== undefined) {\n throw new UsageError(\"Pass either --op or --ops, not both.\");\n }\n if (inline) {\n try {\n return [JSON.parse(inline) as OperationInput];\n } catch (err) {\n throw new UsageError(`--op is not valid JSON: ${(err as Error).message}`);\n }\n }\n if (batchFile) {\n const parsed = readTemplateFile(batchFile, cwd);\n if (!Array.isArray(parsed)) {\n throw new UsageError(\"--ops must point at a JSON array of operations.\");\n }\n return parsed as OperationInput[];\n }\n throw new UsageError(\n \"edit needs --op '<json>' for one operation or --ops <file> for a batch.\",\n );\n}\n\nexport function runEdit(args: ParsedArgs): number {\n const file = args.positional[0];\n if (!file) throw new UsageError(\"edit needs a template file.\");\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n\n const operations = parseOperations(args, cwd);\n let content = readTemplateFile(file, cwd) as TemplateContent;\n\n // All-or-nothing: applyOperation returns the unchanged input on rejection, so\n // stopping at the first failure and discarding needs no rollback. Nothing is\n // written until every operation has succeeded.\n for (const [index, input] of operations.entries()) {\n const result = applyOperation(content, {\n operation: input.operation,\n data: input.data ?? {},\n timestamp: Date.now(),\n });\n if (!result.ok) {\n throw new UsageError(\n `Operation ${index + 1} (${String(input.operation)}) was rejected: ${result.error}`,\n );\n }\n content = result.content;\n }\n\n // An operation can produce a structurally invalid document, so validate\n // before writing: the working file must always be valid.\n const { valid, errors } = validateTemplate(content);\n if (!valid) {\n throw new InvalidTemplateError(\n `The edited template is not structurally valid (${errors.length} error(s)); ${file} was not written.`,\n errors,\n );\n }\n\n const path = writeTemplateFile(file, content, cwd);\n emit(\n { applied: operations.length, file: path },\n () => `Applied ${operations.length} operation(s) to ${path}`,\n );\n return EXIT.ok;\n}\n","// The format registry. A new @templatical/import-* converter is ONE entry here\n// and nothing else: reference/import.md documents the routing rule rather than\n// the list, and `--list-formats` answers what is resolvable at runtime. That is\n// what lets a new importer ship without a skill edit.\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { basename, extname } from \"node:path\";\nimport { flagValue, type ParsedArgs } from \"../args\";\nimport { emit } from \"../output\";\nimport {\n EXIT,\n MissingDependencyError,\n resolveFrom,\n UsageError,\n writeTemplateFile,\n} from \"../io\";\nimport { resolveOptional } from \"../resolve-optional\";\nimport { WORKING_DIR } from \"../../live/index\";\n\ninterface FormatSpec {\n pkg: string;\n /** The converter's exported function name. */\n fn: string;\n /**\n * What the converter is handed. `json` parses the source first, `text` passes\n * it through, and `stripo` unpacks a `{ html, css }` envelope — Stripo is the\n * one format whose export may arrive as either shape.\n */\n input: \"json\" | \"text\" | \"stripo\";\n}\n\nexport const FORMATS: Record<string, FormatSpec> = {\n unlayer: {\n pkg: \"@templatical/import-unlayer\",\n fn: \"convertUnlayerTemplate\",\n input: \"json\",\n },\n beefree: {\n pkg: \"@templatical/import-beefree\",\n fn: \"convertBeeFreeTemplate\",\n input: \"json\",\n },\n stripo: {\n pkg: \"@templatical/import-stripo\",\n fn: \"convertStripoTemplate\",\n input: \"stripo\",\n },\n topol: {\n pkg: \"@templatical/import-topol\",\n fn: \"convertTopolTemplate\",\n input: \"json\",\n },\n chamaileon: {\n pkg: \"@templatical/import-chamaileon\",\n fn: \"convertChamaileonTemplate\",\n input: \"json\",\n },\n \"easy-email-pro\": {\n pkg: \"@templatical/import-easy-email-pro\",\n fn: \"convertEasyEmailProTemplate\",\n input: \"json\",\n },\n mjml: {\n pkg: \"@templatical/import-mjml\",\n fn: \"convertMjmlTemplate\",\n input: \"text\",\n },\n html: {\n pkg: \"@templatical/import-html\",\n fn: \"convertHtmlTemplate\",\n input: \"text\",\n },\n};\n\n/** Strip a tag and its contents, so class scanning never reads CSS or script. */\nfunction withoutElements(html: string, tag: string): string {\n const open = `<${tag}`;\n const close = `</${tag}`;\n const lower = html.toLowerCase();\n let out = \"\";\n let pos = 0;\n while (pos < html.length) {\n const start = lower.indexOf(open, pos);\n if (start === -1) {\n out += html.slice(pos);\n break;\n }\n const next = lower[start + open.length];\n // `<style` matches `<styles>` too unless the next char ends the tag name.\n if (next !== undefined && /[a-z0-9-]/.test(next)) {\n out += html.slice(pos, start + open.length);\n pos = start + open.length;\n continue;\n }\n out += html.slice(pos, start);\n const gt = html.indexOf(\">\", start);\n if (gt === -1) break;\n const closeAt = lower.indexOf(close, gt + 1);\n if (closeAt === -1) break;\n const closeGt = html.indexOf(\">\", closeAt);\n if (closeGt === -1) break;\n out += \" \";\n pos = closeGt + 1;\n }\n return out;\n}\n\n/** Every class token in the markup, ignoring <style> and <script> contents. */\nfunction markupClassTokens(html: string): string[] {\n const stripped = withoutElements(withoutElements(html, \"style\"), \"script\");\n const tokens: string[] = [];\n const re = /\\bclass\\s*=\\s*([\"'])([^\"']*)\\1/gi;\n let m: RegExpExecArray | null;\n while ((m = re.exec(stripped))) {\n tokens.push(...m[2].trim().split(/\\s+/).filter(Boolean));\n }\n return tokens;\n}\n\n/** Stripo's own class prefixes, which survive both of its export shapes. */\nfunction looksLikeStripoHtml(html: unknown): boolean {\n if (typeof html !== \"string\" || html.trim().length === 0) return false;\n const tokens = markupClassTokens(html);\n if (\n tokens.some(\n (t) =>\n t === \"esd-stripe\" ||\n t === \"esd-structure\" ||\n t === \"esd-container-frame\" ||\n t.startsWith(\"esd-block-\"),\n )\n ) {\n return true;\n }\n return tokens.some(\n (t) =>\n t === \"es-wrapper\" || t === \"es-content-body\" || t === \"es-header-body\",\n );\n}\n\n/** Easy Email Pro marks its own nodes `standard-*`; OSS Easy Email does not. */\nfunction hasStandardType(node: unknown): boolean {\n if (!node || typeof node !== \"object\") return false;\n const n = node as { type?: unknown; children?: unknown };\n if (typeof n.type === \"string\" && n.type.startsWith(\"standard-\")) return true;\n if (Array.isArray(n.children)) return n.children.some(hasStandardType);\n return false;\n}\n\n/** Guess the source format, or null when the caller must pass --format. */\nexport function detectFormat(fileName: string, content: string): string | null {\n const ext = extname(fileName).toLowerCase();\n const trimmed = content.trimStart();\n\n // MJML is decided before both the extension check and the generic `<` branch:\n // an MJML document saved as .html is still MJML, and reading it as HTML\n // silently produces a table-soup import that looks like a bad converter.\n if (ext === \".mjml\") return \"mjml\";\n if (/^<(\\?xml[^>]*\\?>\\s*)?<?\\s*mjml[\\s>]/i.test(trimmed)) return \"mjml\";\n if (/^<\\s*mj-body[\\s>]/i.test(trimmed)) return \"mjml\";\n\n // Stripo's compiled File→HTML and its plugin storage are both `.html` (or a\n // JSON `{ html, css }` blob), so the class check must run before the generic\n // html branch or every Stripo export imports as table soup.\n if (looksLikeStripoHtml(content)) return \"stripo\";\n\n if (ext === \".html\" || ext === \".htm\") return \"html\";\n if (trimmed.startsWith(\"<\")) return \"html\";\n if (trimmed.startsWith(\"{\")) {\n let obj: {\n body?: { rows?: unknown; type?: unknown };\n page?: { rows?: unknown };\n tagName?: unknown;\n content?: { type?: unknown };\n type?: unknown;\n html?: unknown;\n };\n try {\n obj = JSON.parse(content);\n } catch {\n return null;\n }\n // Unlayer designs come from editor.saveDesign(): { body: { rows } }.\n if (obj?.body?.rows) return \"unlayer\";\n // BeeFree templates: { page: { rows } }.\n if (obj?.page?.rows) return \"beefree\";\n // Topol designs are an MJML-shaped tree rooted at the global style.\n if (obj?.tagName === \"mj-global-style\") return \"topol\";\n // Chamaileon getDocument(): { body: { type: \"body\" } }. Unlayer's\n // { body: { rows } } is matched above, so the order between them matters.\n if (obj?.body?.type === \"body\") return \"chamaileon\";\n // Easy Email Pro persist: { content: { type: \"page\" } } or a bare page,\n // distinguished from OSS Easy Email by its `standard-*` node types.\n const page =\n obj?.content?.type === \"page\"\n ? obj.content\n : obj?.type === \"page\"\n ? obj\n : null;\n if (page && hasStandardType(page)) return \"easy-email-pro\";\n // A plugin host often persists the whole getTemplateData() object.\n if (typeof obj?.html === \"string\" && looksLikeStripoHtml(obj.html)) {\n return \"stripo\";\n }\n return null;\n }\n return null;\n}\n\n/** Split a Stripo source into html + css, whichever shape it arrived in. */\nexport function unpackStripoSource(source: string): {\n html: string;\n css?: string;\n} {\n const trimmed = source.trimStart();\n if (trimmed.startsWith(\"{\")) {\n try {\n const obj = JSON.parse(source) as { html?: unknown; css?: unknown };\n if (typeof obj?.html === \"string\") {\n return {\n html: obj.html,\n css: typeof obj.css === \"string\" ? obj.css : undefined,\n };\n }\n } catch {\n // Not an envelope after all — treat the whole thing as markup.\n }\n }\n return { html: source };\n}\n\n/** The stylesheet a plugin host wrote beside an HTML export, if there is one. */\nfunction siblingCss(sourcePath: string, source: string): string | undefined {\n // A JSON envelope carries its own css; only a bare .html file has a sibling.\n if (source.trimStart().startsWith(\"{\")) return undefined;\n const cssPath = sourcePath.replace(/\\.[^.]+$/, \".css\");\n if (cssPath === sourcePath || !existsSync(cssPath)) return undefined;\n return readFileSync(cssPath, \"utf8\");\n}\n\nexport interface ReportCounts {\n total: number;\n converted: number;\n approximated: number;\n htmlFallback: number;\n skipped: number;\n warnings: string[];\n}\n\n/**\n * Status counts from a converter's report. Derived from `report.entries` (every\n * entry carries a `status`) rather than each package's own `summary` shape, so\n * it works identically across all three converters and any future one.\n */\nexport function summarizeReport(report: unknown): ReportCounts {\n const r = report as\n { entries?: Array<{ status?: string }>; warnings?: string[] } | undefined;\n const counts: ReportCounts = {\n total: 0,\n converted: 0,\n approximated: 0,\n htmlFallback: 0,\n skipped: 0,\n warnings: r?.warnings ?? [],\n };\n for (const e of r?.entries ?? []) {\n counts.total++;\n if (e.status === \"converted\") counts.converted++;\n else if (e.status === \"approximated\") counts.approximated++;\n else if (e.status === \"html-fallback\") counts.htmlFallback++;\n else if (e.status === \"skipped\") counts.skipped++;\n }\n return counts;\n}\n\nasync function listFormats(cwd: string): Promise<number> {\n const formats: Array<{\n format: string;\n package: string;\n available: boolean;\n }> = [];\n for (const [format, spec] of Object.entries(FORMATS)) {\n formats.push({\n format,\n package: spec.pkg,\n available: (await resolveOptional(spec.pkg, cwd)) !== null,\n });\n }\n emit({ formats }, () =>\n formats\n .map(\n (f) =>\n ` ${f.format.padEnd(14)} ${f.package}${f.available ? \"\" : \" (not installed)\"}`,\n )\n .join(\"\\n\"),\n );\n return EXIT.ok;\n}\n\nexport async function runImport(args: ParsedArgs): Promise<number> {\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n if (args.flags[\"list-formats\"]) return listFormats(cwd);\n\n const file = args.positional[0];\n if (!file) throw new UsageError(\"import needs a source file.\");\n const path = resolveFrom(file, cwd);\n\n let source: string;\n try {\n source = readFileSync(path, \"utf8\");\n } catch {\n throw new UsageError(`Could not read ${file}`);\n }\n\n const known = Object.keys(FORMATS).join(\", \");\n const requested = flagValue(args, \"format\");\n if (requested && !FORMATS[requested]) {\n throw new UsageError(\n `Unknown --format \"${requested}\". Known formats: ${known}.`,\n );\n }\n const format = requested ?? detectFormat(path, source);\n if (!format) {\n throw new UsageError(\n `Could not detect the format of ${file}. Pass --format with one of: ${known}.`,\n );\n }\n\n const spec = FORMATS[format];\n const mod = await resolveOptional<Record<string, unknown>>(spec.pkg, cwd);\n if (!mod) {\n throw new MissingDependencyError(\n spec.pkg,\n `Importing ${format} needs ${spec.pkg}, which isn't installed.\\n npm install ${spec.pkg}`,\n );\n }\n const convert = mod[spec.fn] as (\n input: unknown,\n options?: unknown,\n ) => {\n content: unknown;\n report: unknown;\n };\n\n let content: unknown;\n let report: unknown;\n if (spec.input === \"stripo\") {\n // Plugin storage keeps the stylesheet out of the markup — either beside the\n // html in one JSON envelope, or as a sibling .css file the host wrote next\n // to it. Without the CSS every block imports unstyled, which reads as a\n // broken converter rather than a missing file.\n const unpacked = unpackStripoSource(source);\n const css = unpacked.css ?? siblingCss(path, source);\n ({ content, report } = convert(unpacked.html, css ? { css } : undefined));\n } else {\n const input = spec.input === \"json\" ? JSON.parse(source) : source;\n ({ content, report } = convert(input));\n }\n\n const outName = flagValue(args, \"out\") ?? basename(path, extname(path));\n const written = writeTemplateFile(\n `${WORKING_DIR}/${outName}.json`,\n content,\n cwd,\n );\n\n const counts = summarizeReport(report);\n const lossy = counts.htmlFallback + counts.skipped > 0;\n emit({ format, file: written, report: counts }, () =>\n [\n `Imported ${format} to ${written}`,\n ` ${counts.converted} converted, ${counts.approximated} approximated, ${counts.htmlFallback} html fallback, ${counts.skipped} skipped`,\n ...counts.warnings.map((w) => ` ! ${w}`),\n lossy\n ? \" Import is lossy. Open it in live mode and refine the fallback blocks.\"\n : \"\",\n ]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n return EXIT.ok;\n}\n","import { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { flagValue, type ParsedArgs } from \"../args\";\nimport { emit, note } from \"../output\";\nimport {\n EXIT,\n InvalidTemplateError,\n readTemplateFile,\n resolveFrom,\n UsageError,\n} from \"../io\";\nimport { loadMjml, requireMjml } from \"../mjml\";\nimport {\n buildSpecimen,\n buildSpecimenTemplate,\n checkCustomBlock,\n checkRecipe,\n renderSpecimenMjml,\n runRecipe,\n SPECIMEN_STATES,\n validateCustomBlockDefinition,\n type CustomBlockIssue,\n type CustomBlockWorkingFile,\n type SpecimenState,\n} from \"../../custom-block\";\n\nconst USAGE =\n \"Use `custom-block validate <file>`, `custom-block render <file>` or `custom-block fetch <file>`.\";\n\nfunction formatIssues(issues: CustomBlockIssue[]): string {\n return issues\n .map(\n (i) =>\n ` - [${i.severity}] ${i.ruleId}${i.path ? ` ${i.path}` : \"\"}: ${i.message}`,\n )\n .join(\"\\n\");\n}\n\n/** `--values '<json>'`: field values a recipe runs with, over the defaults. */\nexport function parseValuesFlag(\n raw: string | undefined,\n): Record<string, unknown> {\n if (raw === undefined) return {};\n let parsed: unknown;\n try {\n parsed = JSON.parse(raw);\n } catch {\n throw new UsageError(\"--values must be a JSON object.\");\n }\n if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n throw new UsageError(\"--values must be a JSON object.\");\n }\n return parsed as Record<string, unknown>;\n}\n\nfunction loadValid(file: string, cwd: string): CustomBlockWorkingFile {\n const data = readTemplateFile(file, cwd);\n const r = validateCustomBlockDefinition(data);\n if (!r.valid) {\n throw new InvalidTemplateError(\n `${file} is not a valid custom block definition.`,\n r.issues.filter((i) => i.severity === \"error\").map((i) => i.message),\n );\n }\n return data as CustomBlockWorkingFile;\n}\n\nexport async function runCustomBlock(args: ParsedArgs): Promise<number> {\n const sub = args.positional[0];\n const file = args.positional[1];\n if (sub !== \"validate\" && sub !== \"render\" && sub !== \"fetch\") {\n throw new UsageError(`Unknown \"custom-block ${sub ?? \"\"}\". ${USAGE}`);\n }\n if (!file)\n throw new UsageError(`custom-block ${sub} needs a definition file.`);\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n\n if (sub === \"validate\") {\n const mjml = await loadMjml(cwd);\n const result = await checkCustomBlock(readTemplateFile(file, cwd), {\n compileMjml: mjml\n ? async (m) => ({\n errors: (await mjml(m, { validationLevel: \"soft\" })).errors,\n })\n : undefined,\n });\n if (!mjml)\n note(\"`mjml` isn't installed, so the HTML compile check was skipped.\");\n emit(result, () =>\n result.issues.length === 0\n ? \"✓ Valid custom block — no issues\"\n : `${result.valid ? \"✓ Valid\" : \"✗ Invalid\"} · ${result.issues.length} issue(s):\\n${formatIssues(result.issues)}`,\n );\n return result.valid ? EXIT.ok : EXIT.invalid;\n }\n\n const def = loadValid(file, cwd);\n\n if (sub === \"render\") {\n const state = flagValue(args, \"state\");\n if (\n state !== undefined &&\n !(SPECIMEN_STATES as readonly string[]).includes(state)\n ) {\n throw new UsageError(\n `Unknown --state \"${state}\". Use one of: ${SPECIMEN_STATES.join(\", \")}.`,\n );\n }\n // A state the definition doesn't produce would render a sheet without the\n // block, which reads as a block that renders nothing.\n if (state !== undefined) {\n const states = buildSpecimen(def).map((i) => i.state);\n if (!(states as string[]).includes(state)) {\n throw new UsageError(\n `${file} has no \"${state}\" state: it has no ${state === \"flipped\" ? \"boolean\" : \"repeatable\"} field. Its states: ${states.join(\", \")}.`,\n );\n }\n }\n const format = flagValue(args, \"format\") ?? \"mjml\";\n if (format !== \"mjml\" && format !== \"html\")\n throw new UsageError(`Unknown --format \"${format}\". Use mjml or html.`);\n let output: string;\n try {\n output = await renderSpecimenMjml(\n def,\n buildSpecimenTemplate(\n def,\n undefined,\n state as SpecimenState | undefined,\n ),\n );\n } catch (err) {\n throw new InvalidTemplateError(`${file} does not render.`, [\n (err as Error).message,\n ]);\n }\n if (format === \"html\")\n output = (\n await (\n await requireMjml(cwd, \"Rendering HTML\")\n )(output, { validationLevel: \"soft\" })\n ).html;\n const out = flagValue(args, \"out\", \"o\");\n if (out) {\n const path = resolveFrom(out, cwd);\n mkdirSync(dirname(path), { recursive: true });\n writeFileSync(path, output, \"utf8\");\n note(`Wrote ${path}`);\n return EXIT.ok;\n }\n emit({ format, output }, () => output);\n return EXIT.ok;\n }\n\n // sub === \"fetch\"\n if (!def.dataSourcePreview)\n throw new UsageError(`${file} has no \\`dataSourcePreview\\` to run.`);\n const recipeErrors = checkRecipe(def).filter((i) => i.severity === \"error\");\n if (recipeErrors.length > 0) {\n throw new InvalidTemplateError(\n `${file} has a dataSourcePreview the bridge would refuse to run.`,\n recipeErrors.map((i) => `${i.ruleId}: ${i.message}`),\n );\n }\n const overrides = parseValuesFlag(flagValue(args, \"values\"));\n const defaults = buildSpecimen(def)[0].fieldValues;\n const result = await runRecipe(def.dataSourcePreview, {\n ...defaults,\n ...overrides,\n });\n emit(result, () =>\n result.ok\n ? `✓ ${result.status} · ${JSON.stringify(result.values, null, 2)}${result.unmapped.length ? `\\nUnmapped: ${result.unmapped.join(\", \")}` : \"\"}`\n : `✗ ${result.error}`,\n );\n return result.ok ? EXIT.ok : EXIT.invalid;\n}\n","import { mkdirSync, rmSync, writeFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, resolve } from \"node:path\";\nimport { flagValue, type ParsedArgs } from \"../args\";\nimport { emit, note } from \"../output\";\nimport { EXIT, resolveFrom, UsageError } from \"../io\";\nimport { parseValuesFlag } from \"./custom-block\";\nimport {\n DEFAULT_PORT,\n listWorkingFiles,\n type FetchSummary,\n type LiveMode,\n type PidfileInfo,\n openBrowser,\n pidfilePath,\n processAlive,\n readPidfile,\n readWorkingFile,\n startBridgePreferring,\n WORKING_DIR,\n} from \"../../live/index\";\n\n/**\n * The first title block's text in document order, as a hint for `list`.\n *\n * It must descend into a section's columns, not scan top-level blocks only:\n * templates put their content inside sections (that is the documented\n * structure), so a top-level scan finds nothing for a real template. Measured\n * across all five of the templatical skill's examples — event-invite, newsletter,\n * product-sale, receipt, welcome — none has a top-level title block, so a\n * shallow version of this returns null every time and the hint is dead code.\n */\nfunction titleHint(content: unknown): string | null {\n return findTitle((content as { blocks?: unknown })?.blocks);\n}\n\nfunction findTitle(blocks: unknown): string | null {\n if (!Array.isArray(blocks)) return null;\n for (const block of blocks as Array<{\n type?: string;\n content?: string;\n children?: unknown[];\n }>) {\n if (block?.type === \"title\" && typeof block.content === \"string\") {\n return block.content;\n }\n if (block?.type === \"section\" && Array.isArray(block.children)) {\n for (const column of block.children) {\n const hit = findTitle(column);\n if (hit) return hit;\n }\n }\n }\n return null;\n}\n\nexport function runList(args: ParsedArgs): number {\n const cwd = flagValue(args, \"cwd\") ?? process.cwd();\n const templates = listWorkingFiles(cwd).map((name) => ({\n name,\n title: titleHint(readWorkingFile(join(cwd, WORKING_DIR, name))),\n }));\n emit({ templates }, () =>\n templates.length === 0\n ? `No templates in ${WORKING_DIR}/`\n : templates\n .map((t) => ` ${t.name}${t.title ? ` - ${t.title}` : \"\"}`)\n .join(\"\\n\"),\n );\n return EXIT.ok;\n}\n\nasync function postTo(\n port: number,\n path: string,\n body?: unknown,\n): Promise<Response> {\n return fetch(`http://localhost:${port}${path}`, {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\" },\n body: body === undefined ? undefined : JSON.stringify(body),\n });\n}\n\n/** The fetched state's outcome, as one line of reload or start output. */\nfunction fetchLine(fetch: FetchSummary): string {\n if (!fetch.ok) return `Fetched state: the request failed. ${fetch.error}`;\n return fetch.unmapped.length > 0\n ? `Fetched state: filled from the API; not in the response: ${fetch.unmapped.join(\", \")}.`\n : \"Fetched state: filled from the API.\";\n}\n\nexport async function runLive(args: ParsedArgs): Promise<number> {\n const sub = args.positional[0];\n const cwd = resolveFrom(flagValue(args, \"cwd\") ?? \".\", process.cwd());\n\n if (sub === \"reload\" || sub === \"stop\") {\n const info = readPidfile(cwd);\n if (!info || !processAlive(info.pid)) {\n throw new UsageError(\n `No live server is running here (no live pidfile at ${WORKING_DIR}/live-server.pid).`,\n );\n }\n if (sub === \"reload\") {\n const consumeAnnotations = args.flags[\"consume-annotations\"] === true;\n const res = await postTo(\n info.port,\n \"/reload\",\n consumeAnnotations ? { consumeAnnotations: true } : undefined,\n );\n const body = (await res.json().catch(() => ({}))) as {\n ok?: boolean;\n clients?: number;\n consumed?: boolean;\n mode?: LiveMode;\n error?: string;\n fetch?: FetchSummary;\n };\n const clients = body.clients ?? 0;\n const consumed = body.consumed === true;\n // The bridge's error already names what failed and what to run; a\n // refused request (a 403 from a rewritten Host, say) has no body at all.\n if (res.status >= 400 || body.ok === false) {\n const reason =\n body.error ??\n (res.status >= 400\n ? `The live server refused the reload (${res.status}).`\n : \"The live server reported a failed reload.\");\n const error = `${reason} Nothing was pushed.`;\n emit(\n { reloaded: false, ok: false, clients, consumed, error },\n () => error,\n );\n return EXIT.invalid;\n }\n const fetch = body.fetch;\n emit(\n {\n reloaded: true,\n ok: true,\n clients,\n consumed,\n ...(fetch ? { fetch } : {}),\n },\n () =>\n [\n body.mode === \"custom-block\"\n ? `Pushed the custom block to ${clients} page(s).`\n : `Pushed the working file to ${clients} connected page(s).`,\n fetch ? fetchLine(fetch) : \"\",\n ]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n return EXIT.ok;\n }\n try {\n process.kill(info.pid, \"SIGTERM\");\n } catch {\n /* already gone */\n }\n rmSync(pidfilePath(cwd), { force: true });\n emit({ stopped: true }, () => \"Stopped the live server.\");\n return EXIT.ok;\n }\n\n if (sub !== undefined) {\n throw new UsageError(\n `Unknown \"live ${sub}\". Use \\`live\\`, \\`live reload\\` or \\`live stop\\`.`,\n );\n }\n\n // start\n const portFlag = flagValue(args, \"port\");\n const preferredPort = portFlag ? Number(portFlag) : DEFAULT_PORT;\n const file = flagValue(args, \"file\");\n const customBlock = flagValue(args, \"custom-block\");\n const host = flagValue(args, \"host\");\n if (customBlock && file) {\n throw new UsageError(\"Pass either --file or --custom-block, not both.\");\n }\n if (host && !customBlock) {\n throw new UsageError(\"--host only applies with --custom-block.\");\n }\n const fetchOn = args.flags.fetch === true;\n if (fetchOn && !customBlock) {\n throw new UsageError(\"--fetch only applies with --custom-block.\");\n }\n const valuesRaw = flagValue(args, \"values\");\n if (valuesRaw !== undefined && !fetchOn) {\n throw new UsageError(\"--values only applies with --fetch.\");\n }\n const fetchValues = fetchOn ? parseValuesFlag(valuesRaw) : undefined;\n const abs = (p: string) => (isAbsolute(p) ? p : resolve(cwd, p));\n const requested: Required<Pick<PidfileInfo, \"mode\" | \"path\">> &\n Pick<PidfileInfo, \"host\" | \"fetch\"> = {\n mode: customBlock ? \"custom-block\" : \"template\",\n path: abs(customBlock ?? file ?? join(WORKING_DIR, \"template.json\")),\n ...(host ? { host: abs(host) } : {}),\n ...(fetchValues ? { fetch: fetchValues } : {}),\n };\n\n const existing = readPidfile(cwd);\n if (existing && processAlive(existing.pid)) {\n // A pidfile without `mode` came from a template-only bridge; one without\n // `path` can't be compared, so only its mode is.\n const mode = existing.mode ?? \"template\";\n if (\n mode !== requested.mode ||\n (existing.path !== undefined && existing.path !== requested.path) ||\n (mode === \"custom-block\" &&\n (existing.host !== requested.host ||\n JSON.stringify(existing.fetch) !== JSON.stringify(requested.fetch)))\n ) {\n throw new UsageError(\n `A live server is already running for ${existing.path ?? \"another file\"} (${mode}). Run \\`templatical live stop\\` first.`,\n );\n }\n emit(\n {\n url: `http://localhost:${existing.port}/`,\n pid: existing.pid,\n alreadyRunning: true,\n },\n () =>\n `Live server already running (pid ${existing.pid}) at http://localhost:${existing.port}/`,\n );\n return EXIT.ok;\n }\n if (existing) rmSync(pidfilePath(cwd), { force: true }); // stale\n\n const handle = await startBridgePreferring({\n cwd,\n preferredPort,\n file,\n customBlock,\n host,\n ...(fetchValues ? { fetch: { values: fetchValues } } : {}),\n });\n\n mkdirSync(dirname(pidfilePath(cwd)), { recursive: true });\n writeFileSync(\n pidfilePath(cwd),\n JSON.stringify({\n pid: process.pid,\n port: handle.port,\n ...requested,\n path: handle.workingPath,\n } satisfies PidfileInfo),\n \"utf8\",\n );\n\n const cleanup = () => {\n rmSync(pidfilePath(cwd), { force: true });\n handle.close().finally(() => process.exit(EXIT.ok));\n };\n process.on(\"SIGINT\", cleanup);\n process.on(\"SIGTERM\", cleanup);\n\n // Emit before blocking: the caller needs the URL and the working path now,\n // not when the server shuts down.\n const fetch = handle.lastFetch();\n emit(\n {\n url: handle.url,\n port: handle.port,\n preferredPort,\n fellBack: handle.fellBack,\n workingFile: handle.workingPath,\n customBlock: customBlock ? handle.workingPath : undefined,\n fetch: fetch ?? undefined,\n },\n () =>\n [\n `Templatical live preview running at ${handle.url}`,\n handle.fellBack\n ? `(port ${preferredPort} was busy - using ${handle.port})`\n : \"\",\n `${customBlock ? \"Custom block\" : \"Working file\"}: ${handle.workingPath}`,\n fetch ? fetchLine(fetch) : \"\",\n ]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n\n if (args.flags[\"no-open\"]) {\n note(`Open ${handle.url} in a browser.`);\n } else {\n note(`Opening ${handle.url} in your default browser...`);\n openBrowser(handle.url);\n }\n note(\"After writing the working file, run: templatical live reload\");\n\n // Block: the bridge owns the process until a signal arrives.\n return new Promise<number>(() => {});\n}\n","#!/usr/bin/env node\n// The CLI entry point.\n//\n// Every command is a thin shell over this package's library functions; the\n// dispatch below owns argument handling, the error→exit-code mapping, and\n// nothing else. Human-facing output goes through cli/output.ts.\n\nimport { realpathSync } from \"node:fs\";\nimport { pathToFileURL } from \"node:url\";\nimport { parseArgs } from \"./cli/args\";\nimport { note, setJsonMode } from \"./cli/output\";\nimport {\n EXIT,\n InvalidTemplateError,\n MissingDependencyError,\n UsageError,\n} from \"./cli/io\";\nimport { runSchema } from \"./cli/commands/schema\";\nimport { runValidate } from \"./cli/commands/validate\";\nimport { runRender } from \"./cli/commands/render\";\nimport { runEdit } from \"./cli/commands/edit\";\nimport { runImport } from \"./cli/commands/import\";\nimport { runCustomBlock } from \"./cli/commands/custom-block\";\nimport { runList, runLive } from \"./cli/commands/live\";\n\nconst USAGE = `templatical <command> [options]\n\n validate <file> structural + quality lint\n schema [--out <file>] print the block JSON Schema\n render <file> [--format mjml|html] [-o <file>] render to MJML or HTML\n edit <file> --op '<json>' | --ops <file> apply operations, write the result\n import <file> [--format <fmt>] | --list-formats convert a design to Templatical JSON\n live [--file <f>] [--port <n>] [--cwd <d>] [--no-open]\n live reload | live stop\n custom-block validate <file> check a custom block definition\n custom-block render <file> [--state <s>] [--format mjml|html] [-o <file>]\n custom-block fetch <file> [--values '<json>'] run its dataSourcePreview once\n live --custom-block <file> [--host <template>] [--fetch [--values '<json>']]\n preview a custom block\n list working files in .templatical/\n\nOptions:\n --json machine-readable output on stdout\n`;\n\nexport async function main(argv: string[]): Promise<number> {\n const args = parseArgs(argv);\n setJsonMode(args.json);\n\n switch (args.command) {\n case \"validate\":\n return runValidate(args);\n case \"schema\":\n return runSchema(args);\n case \"render\":\n return await runRender(args);\n case \"edit\":\n return runEdit(args);\n case \"import\":\n return await runImport(args);\n case \"live\":\n return await runLive(args);\n case \"list\":\n return runList(args);\n case \"custom-block\":\n return await runCustomBlock(args);\n case \"help\":\n note(USAGE);\n return EXIT.ok;\n case undefined:\n // parseArgs strips leading dashes into flags, so `--help`/`-h` never\n // reach args.command — they land here, not on a (dead) case \"--help\".\n // Asking for help is not a usage error; a bare invocation still is.\n if (args.flags.help === true || args.flags.h === true) {\n note(USAGE);\n return EXIT.ok;\n }\n note(USAGE);\n return EXIT.usage;\n default:\n note(`Unknown command \"${args.command}\".\\n\\n${USAGE}`);\n return EXIT.usage;\n }\n}\n\n// Only self-invoke when run as the CLI entry point, not when imported — this\n// package's own tests import `main` directly to exercise the dispatch above\n// without spawning a subprocess.\n//\n// import.meta.url is always a realpath, but process.argv[1] is not: npm's\n// `bin` field links a real symlink into the consumer's node_modules/.bin\n// (e.g. node_modules/.bin/templatical -> ../@templatical/template-tools/dist/bin.js),\n// and Node leaves argv[1] as that symlink path instead of resolving it.\n// Comparing them directly is false for every consumer who runs the published\n// binary, so main() would silently never run. realpathSync(argv[1]) resolves\n// the symlink so both sides name the same file.\nexport function isEntryPoint(): boolean {\n const argv1 = process.argv[1];\n if (!argv1) return false;\n try {\n return pathToFileURL(realpathSync(argv1)).href === import.meta.url;\n } catch {\n // realpathSync throws (e.g. ENOENT) if argv[1] doesn't exist or can't be\n // read. This guard runs at module load, so failing open into a crash\n // would be worse than just not self-invoking.\n return false;\n }\n}\n\nif (isEntryPoint()) {\n main(process.argv.slice(2))\n .then((code) => process.exit(code))\n .catch((err: unknown) => {\n if (err instanceof InvalidTemplateError) {\n note(err.message);\n for (const e of err.errors) note(` - ${e}`);\n process.exit(EXIT.invalid);\n }\n if (err instanceof MissingDependencyError) {\n note(err.message);\n process.exit(EXIT.missingDep);\n }\n if (err instanceof UsageError) {\n note(err.message);\n process.exit(EXIT.usage);\n }\n note(`Unexpected error: ${(err as Error)?.message ?? String(err)}`);\n process.exit(EXIT.usage);\n });\n}\n"],"mappings":"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"}