@templatical/template-tools 0.47.0 → 0.49.0

package/README.md

@@ -49,12 +49,12 @@ Install them wherever you run the command; they are resolved from your working d
 import {
   validateTemplate,
   runQualityLint,
-  applyOperation,
+  applyOperations,
   checkCustomBlock,
 } from "@templatical/template-tools";
 import { startBridge } from "@templatical/template-tools/live";
 ```
 
-`checkCustomBlock` runs the same checks as `custom-block validate`, on a JSON working file or the object a definition module exports; `validateCustomBlockDefinition` runs only the structural check. The JSON Schema for a custom block definition is at `@templatical/template-tools/custom-block-schema.json`.
+`applyOperations` is the operation engine `edit` runs, re-exported from `@templatical/types` with `OperationError` and `getColumnCount`. `checkCustomBlock` runs the same checks as `custom-block validate`, on a JSON working file or the object a definition module exports; `validateCustomBlockDefinition` runs only the structural check. The JSON Schema for a custom block definition is at `@templatical/template-tools/custom-block-schema.json`.
 
 MIT.

package/dist/bin.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-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-sAM61QPU.js";
-import { t as applyOperation } from "./src-Ce1Oh8m_.js";
+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";
+import "./index.js";
 import { DEFAULT_PORT, WORKING_DIR, listWorkingFiles, openBrowser, pidfilePath, processAlive, readPidfile, readWorkingFile, startBridgePreferring } from "./live/index.js";
+import { OperationError, applyOperations } from "@templatical/types";
 import { renderToMjml } from "@templatical/renderer";
 import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
@@ -275,20 +276,25 @@ function parseOperations(args, cwd) {
 	}
 	throw new UsageError("edit needs --op '<json>' for one operation or --ops <file> for a batch.");
 }
+/** An object written in the old vocabulary: `{"operation": …, "data": …}`. */
+function isOldVocabulary(input) {
+	return typeof input === "object" && input !== null && "operation" in input && !("op" in input);
+}
 function runEdit(args) {
 	const file = args.positional[0];
 	if (!file) throw new UsageError("edit needs a template file.");
 	const cwd = flagValue(args, "cwd") ?? process.cwd();
 	const operations = parseOperations(args, cwd);
-	let content = readTemplateFile(file, cwd);
-	for (const [index, input] of operations.entries()) {
-		const result = applyOperation(content, {
-			operation: input.operation,
-			data: input.data ?? {},
-			timestamp: Date.now()
-		});
-		if (!result.ok) throw new UsageError(`Operation ${index + 1} (${String(input.operation)}) was rejected: ${result.error}`);
-		content = result.content;
+	const oldIndex = operations.findIndex(isOldVocabulary);
+	if (oldIndex !== -1) throw new UsageError(`Operation ${oldIndex + 1} uses the old {"operation", "data"} form. Write {"op": "updateBlock", "blockId": …, "set": {…}} and the like: see the operations reference.`);
+	const before = readTemplateFile(file, cwd);
+	let content;
+	try {
+		content = applyOperations(before, operations);
+	} catch (error) {
+		if (!(error instanceof OperationError)) throw error;
+		const refused = operations[error.opIndex];
+		throw new UsageError(`Operation ${error.opIndex + 1} (${String(refused?.op)}) was refused: ${error.code} — ${error.message}`);
 	}
 	const { valid, errors } = validateTemplate(content);
 	if (!valid) throw new InvalidTemplateError(`The edited template is not structurally valid (${errors.length} error(s)); ${file} was not written.`, errors);

package/dist/bin.js.map

@@ -1 +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":";;;;;;;;;;AAIA,MAAM,8BAAc,IAAI,IAAI;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAUD,SAAgB,UAAU,MAA4B;CACpD,MAAM,aAAuB,CAAC;CAC9B,MAAM,QAAuC,CAAC;CAC9C,IAAI,OAAO;CAEX,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,KAAK;EACjB,IAAI,CAAC,IAAI,WAAW,GAAG,GAAG;GACxB,WAAW,KAAK,GAAG;GACnB;EACF;EAEA,MAAM,OAAO,IAAI,QAAQ,QAAQ,EAAE;EACnC,MAAM,KAAK,KAAK,QAAQ,GAAG;EAC3B,IAAI,OAAO,IAAI;GACb,MAAM,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,MAAM,KAAK,CAAC;GAC5C;EACF;EACA,IAAI,SAAS,QAAQ;GACnB,OAAO;GACP;EACF;EAGA,MAAM,QACJ,YAAY,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,SAAS,KAAK,EAAE,KAAK;CAC/D;CAEA,OAAO;EAAE,SAAS,WAAW,MAAM;EAAG;EAAY;EAAM;CAAM;AAChE;;AAGA,SAAgB,UACd,MACA,GAAG,OACiB;CACpB,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,IAAI,KAAK,MAAM;EACrB,IAAI,OAAO,MAAM,UAAU,OAAO;CACpC;AAEF;;;AC5DA,IAAI,WAAW;AAEf,SAAgB,YAAY,IAAmB;CAC7C,WAAW;AACb;;;;;;AAWA,SAAgB,KAAK,SAAkB,OAA2B;CAChE,QAAQ,OAAO,MACb,WAAW,GAAG,KAAK,UAAU,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GACzD;AACF;;AAGA,SAAgB,KAAK,SAAuB;CAC1C,QAAQ,OAAO,MAAM,GAAG,QAAQ,GAAG;AACrC;;;AC3BA,MAAa,OAAO;CAClB,IAAI;;CAEJ,SAAS;;CAET,OAAO;;CAEP,YAAY;AACd;AAEA,IAAa,aAAb,cAAgC,MAAM,CAAC;AAEvC,IAAa,uBAAb,cAA0C,MAAM;CAGnC;CAFX,YACE,SACA,SAA4B,CAAC,GAC7B;EACA,MAAM,OAAO;EAFJ,KAAA,SAAA;CAGX;AACF;AAEA,IAAa,yBAAb,cAA4C,MAAM;CAErC;CADX,YACE,KACA,SACA;EACA,MAAM,OAAO;EAHJ,KAAA,MAAA;CAIX;AACF;AAEA,SAAgB,YAAY,MAAc,MAAM,QAAQ,IAAI,GAAW;CACrE,OAAO,WAAW,IAAI,IAAI,OAAO,QAAQ,KAAK,IAAI;AACpD;AAEA,SAAgB,iBAAiB,MAAc,MAAM,QAAQ,IAAI,GAAY;CAC3E,MAAM,OAAO,YAAY,MAAM,GAAG;CAClC,IAAI;CACJ,IAAI;EACF,MAAM,aAAa,MAAM,MAAM;CACjC,QAAQ;EACN,MAAM,IAAI,WAAW,kBAAkB,MAAM;CAC/C;CACA,IAAI;EACF,OAAO,KAAK,MAAM,GAAG;CACvB,SAAS,KAAK;EACZ,MAAM,IAAI,WACR,GAAG,KAAK,sBAAuB,IAAc,SAC/C;CACF;AACF;;AAGA,SAAgB,kBACd,MACA,SACA,MAAM,QAAQ,IAAI,GACV;CACR,MAAM,OAAO,YAAY,MAAM,GAAG;CAClC,UAAU,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;CAC5C,cAAc,MAAM,GAAG,KAAK,UAAU,SAAS,MAAM,CAAC,EAAE,KAAK,MAAM;CACnE,OAAO;AACT;;;AC7DA,SAAgB,UAAU,MAA0B;CAClD,MAAM,MAAM,UAAU,MAAM,OAAO,GAAG;CACtC,IAAI,KAAK;EAMP,KAAK,SAHQ,kBAAkB,KAAK,MAGtB,GAAM;EACpB,OAAO,KAAK;CACd;CACA,KAAK,cAAc,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;CAClD,OAAO,KAAK;AACd;;;ACbA,SAAgB,YAAY,MAA0B;CACpD,MAAM,OAAO,KAAK,WAAW;CAC7B,IAAI,CAAC,MAAM,MAAM,IAAI,WAAW,iCAAiC;CAGjE,MAAM,OAAO,iBAAiB,MAFlB,UAAU,MAAM,KAAK,KAAK,QAAQ,IAAI,CAEX;CACvC,MAAM,EAAE,OAAO,WAAW,iBAAiB,IAAI;CAE/C,IAAI,CAAC,OAAO;EACV,KAAK;GAAE,OAAO;GAAO;GAAQ,QAAQ,CAAC;EAAE,SACtC,CACE,mCAAmC,OAAO,OAAO,KACjD,GAAG,OAAO,KAAK,MAAM,OAAO,GAAG,CACjC,CAAC,CAAC,KAAK,IAAI,CACb;EACA,OAAO,KAAK;CACd;CAGA,MAAM,UAAU,eAAe,IAAI;CACnC,IAAI,QAAQ,OACV,KAAK,+BAA+B,QAAQ,OAAO;CAGrD,MAAM,SAAS,QAAQ;CACvB,MAAM,WAAW,OAAO,QAAQ,MAAM,EAAE,aAAa,OAAO;CAE5D,KAAK;EAAE,OAAO;EAAM,QAAQ,CAAC;EAAG;CAAO,SAAS;EAC9C,IAAI,OAAO,WAAW,GAAG,OAAO;EAChC,MAAM,QAAQ,OAAO,KAClB,MAAM,QAAQ,EAAE,SAAS,IAAI,EAAE,OAAO,IAAI,EAAE,SAC/C;EACA,OAAO,CACL,0BAA0B,OAAO,OAAO,qBACxC,GAAG,KACL,CAAC,CAAC,KAAK,IAAI;CACb,CAAC;CAID,OAAO,SAAS,SAAS,IAAI,KAAK,UAAU,KAAK;AACnD;;;;;;;;;;;;AC0BA,SAAS,eAAe,WAAmB,KAA4B;CACrE,IAAI,UAAU,QAAQ,GAAG;CACzB,SAAS;EACP,MAAM,YAAY,KAAK,SAAS,gBAAgB,SAAS;EACzD,IAAI,WAAW,KAAK,WAAW,cAAc,CAAC,GAAG,OAAO;EACxD,MAAM,SAAS,QAAQ,OAAO;EAC9B,IAAI,WAAW,SAAS,OAAO;EAC/B,UAAU;CACZ;AACF;;;;;;;AAQA,SAAS,aAAa,QAAwB;CAC5C,MAAM,WAAW,KAAK,MACpB,aAAa,KAAK,QAAQ,cAAc,GAAG,MAAM,CACnD;CAEA,MAAM,MACJ,SAAS,WAAW,OAAO,SAAS,YAAY,WAC5C,SAAS,QAAQ,OACjB,KAAA;CACN,MAAM,aAAa,OAAO,OAAO,QAAQ,WAAW,MAAM,KAAA;CAG1D,MAAM,cACJ,OAAO,SAAS,YAAY,WAAW,SAAS,UAAU,KAAA;CAE5D,MAAM,QACJ,YAAY,WACX,OAAO,QAAQ,WAAW,MAAM,KAAA,MACjC,YAAY,WACZ,eACA,SAAS,UACT,SAAS;CAOX,IAAI,CAAC,SAAS,OAAO,UAAU,UAC7B,MAAM,IAAI,MACR,GAAG,OAAO,sDACZ;CAEF,OAAO,KAAK,QAAQ,KAAK;AAC3B;AAEA,eAAsB,gBACpB,WACA,MAAc,QAAQ,IAAI,GACP;CACnB,MAAM,UAAU,CAAC,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC,CAAC;CAE7D,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,SAAS,eAAe,WAAW,MAAM;EAC/C,IAAI,CAAC,QAAQ;EAGb,MAAM,WAAW,aAAa,MAAM;EACpC,IAAI;GACF,OAAQ,MAAM,OAAO,cAAc,QAAQ,CAAC,CAAC;EAC/C,QAAQ;GAMN;EACF;CACF;CACA,OAAO;AACT;;;ACtIA,eAAsB,SAAS,KAAwC;CACrE,MAAM,MAAM,MAAM,gBAAwC,QAAQ,GAAG;CACrE,OAAO,MAAM,IAAI,UAAU;AAC7B;AAEA,eAAsB,YACpB,KACA,SACoB;CACpB,MAAM,OAAO,MAAM,SAAS,GAAG;CAC/B,IAAI,CAAC,MACH,MAAM,IAAI,uBACR,QACA,GAAG,QAAQ,iFACb;CAEF,OAAO;AACT;;;AChBA,MAAMA,4BAAU,IAAI,IAAI,CAAC,QAAQ,MAAM,CAAC;AAExC,eAAsB,UAAU,MAAmC;CACjE,MAAM,OAAO,KAAK,WAAW;CAC7B,IAAI,CAAC,MAAM,MAAM,IAAI,WAAW,+BAA+B;CAE/D,MAAM,SAAS,UAAU,MAAM,QAAQ,KAAK;CAC5C,IAAI,CAACA,UAAQ,IAAI,MAAM,GACrB,MAAM,IAAI,WAAW,qBAAqB,OAAO,qBAAqB;CAGxE,MAAM,MAAM,UAAU,MAAM,KAAK,KAAK,QAAQ,IAAI;CAClD,MAAM,OAAO,iBAAiB,MAAM,GAAG;CAKvC,MAAM,EAAE,OAAO,WAAW,iBAAiB,IAAI;CAC/C,IAAI,CAAC,OACH,MAAM,IAAI,qBACR,GAAG,KAAK,8BAA8B,OAAO,OAAO,cACpD,MACF;CAIF,MAAM,OAAO,MAAM,aAAaC,IAAO;CAEvC,IAAI,SAAS;CACb,IAAI,WAAW,QAEb,UAAU,OAAM,MADM,YAAY,KAAK,gBAAgB,EAAA,CAC/B,MAAM,EAAE,iBAAiB,OAAO,CAAC,EAAA,CAAG;CAG9D,MAAM,MAAM,UAAU,MAAM,OAAO,GAAG;CACtC,IAAI,KAAK;EACP,MAAM,OAAO,YAAY,KAAK,GAAG;EAGjC,UAAU,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;EAC5C,cAAc,MAAM,QAAQ,MAAM;EAClC,KAAK,SAAS,MAAM;EACpB,OAAO,KAAK;CACd;CAEA,KAAK;EAAE;EAAQ;CAAO,SAAS,MAAM;CACrC,OAAO,KAAK;AACd;;;AC1CA,SAAS,gBAAgB,MAAkB,KAA+B;CACxE,MAAM,SAAS,UAAU,MAAM,IAAI;CACnC,MAAM,YAAY,UAAU,MAAM,KAAK;CAIvC,IAAI,WAAW,KAAA,KAAa,cAAc,KAAA,GACxC,MAAM,IAAI,WAAW,sCAAsC;CAE7D,IAAI,QACF,IAAI;EACF,OAAO,CAAC,KAAK,MAAM,MAAM,CAAmB;CAC9C,SAAS,KAAK;EACZ,MAAM,IAAI,WAAW,2BAA4B,IAAc,SAAS;CAC1E;CAEF,IAAI,WAAW;EACb,MAAM,SAAS,iBAAiB,WAAW,GAAG;EAC9C,IAAI,CAAC,MAAM,QAAQ,MAAM,GACvB,MAAM,IAAI,WAAW,iDAAiD;EAExE,OAAO;CACT;CACA,MAAM,IAAI,WACR,yEACF;AACF;AAEA,SAAgB,QAAQ,MAA0B;CAChD,MAAM,OAAO,KAAK,WAAW;CAC7B,IAAI,CAAC,MAAM,MAAM,IAAI,WAAW,6BAA6B;CAC7D,MAAM,MAAM,UAAU,MAAM,KAAK,KAAK,QAAQ,IAAI;CAElD,MAAM,aAAa,gBAAgB,MAAM,GAAG;CAC5C,IAAI,UAAU,iBAAiB,MAAM,GAAG;CAKxC,KAAK,MAAM,CAAC,OAAO,UAAU,WAAW,QAAQ,GAAG;EACjD,MAAM,SAAS,eAAe,SAAS;GACrC,WAAW,MAAM;GACjB,MAAM,MAAM,QAAQ,CAAC;GACrB,WAAW,KAAK,IAAI;EACtB,CAAC;EACD,IAAI,CAAC,OAAO,IACV,MAAM,IAAI,WACR,aAAa,QAAQ,EAAE,IAAI,OAAO,MAAM,SAAS,EAAE,kBAAkB,OAAO,OAC9E;EAEF,UAAU,OAAO;CACnB;CAIA,MAAM,EAAE,OAAO,WAAW,iBAAiB,OAAO;CAClD,IAAI,CAAC,OACH,MAAM,IAAI,qBACR,kDAAkD,OAAO,OAAO,cAAc,KAAK,oBACnF,MACF;CAGF,MAAM,OAAO,kBAAkB,MAAM,SAAS,GAAG;CACjD,KACE;EAAE,SAAS,WAAW;EAAQ,MAAM;CAAK,SACnC,WAAW,WAAW,OAAO,mBAAmB,MACxD;CACA,OAAO,KAAK;AACd;;;AC3DA,MAAa,UAAsC;CACjD,SAAS;EACP,KAAK;EACL,IAAI;EACJ,OAAO;CACT;CACA,SAAS;EACP,KAAK;EACL,IAAI;EACJ,OAAO;CACT;CACA,QAAQ;EACN,KAAK;EACL,IAAI;EACJ,OAAO;CACT;CACA,OAAO;EACL,KAAK;EACL,IAAI;EACJ,OAAO;CACT;CACA,YAAY;EACV,KAAK;EACL,IAAI;EACJ,OAAO;CACT;CACA,kBAAkB;EAChB,KAAK;EACL,IAAI;EACJ,OAAO;CACT;CACA,MAAM;EACJ,KAAK;EACL,IAAI;EACJ,OAAO;CACT;CACA,MAAM;EACJ,KAAK;EACL,IAAI;EACJ,OAAO;CACT;AACF;;AAGA,SAAS,gBAAgB,MAAc,KAAqB;CAC1D,MAAM,OAAO,IAAI;CACjB,MAAM,QAAQ,KAAK;CACnB,MAAM,QAAQ,KAAK,YAAY;CAC/B,IAAI,MAAM;CACV,IAAI,MAAM;CACV,OAAO,MAAM,KAAK,QAAQ;EACxB,MAAM,QAAQ,MAAM,QAAQ,MAAM,GAAG;EACrC,IAAI,UAAU,IAAI;GAChB,OAAO,KAAK,MAAM,GAAG;GACrB;EACF;EACA,MAAM,OAAO,MAAM,QAAQ,KAAK;EAEhC,IAAI,SAAS,KAAA,KAAa,YAAY,KAAK,IAAI,GAAG;GAChD,OAAO,KAAK,MAAM,KAAK,QAAQ,KAAK,MAAM;GAC1C,MAAM,QAAQ,KAAK;GACnB;EACF;EACA,OAAO,KAAK,MAAM,KAAK,KAAK;EAC5B,MAAM,KAAK,KAAK,QAAQ,KAAK,KAAK;EAClC,IAAI,OAAO,IAAI;EACf,MAAM,UAAU,MAAM,QAAQ,OAAO,KAAK,CAAC;EAC3C,IAAI,YAAY,IAAI;EACpB,MAAM,UAAU,KAAK,QAAQ,KAAK,OAAO;EACzC,IAAI,YAAY,IAAI;EACpB,OAAO;EACP,MAAM,UAAU;CAClB;CACA,OAAO;AACT;;AAGA,SAAS,kBAAkB,MAAwB;CACjD,MAAM,WAAW,gBAAgB,gBAAgB,MAAM,OAAO,GAAG,QAAQ;CACzE,MAAM,SAAmB,CAAC;CAC1B,MAAM,KAAK;CACX,IAAI;CACJ,OAAQ,IAAI,GAAG,KAAK,QAAQ,GAC1B,OAAO,KAAK,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC;CAEzD,OAAO;AACT;;AAGA,SAAS,oBAAoB,MAAwB;CACnD,IAAI,OAAO,SAAS,YAAY,KAAK,KAAK,CAAC,CAAC,WAAW,GAAG,OAAO;CACjE,MAAM,SAAS,kBAAkB,IAAI;CACrC,IACE,OAAO,MACJ,MACC,MAAM,gBACN,MAAM,mBACN,MAAM,yBACN,EAAE,WAAW,YAAY,CAC7B,GAEA,OAAO;CAET,OAAO,OAAO,MACX,MACC,MAAM,gBAAgB,MAAM,qBAAqB,MAAM,gBAC3D;AACF;;AAGA,SAAS,gBAAgB,MAAwB;CAC/C,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU,OAAO;CAC9C,MAAM,IAAI;CACV,IAAI,OAAO,EAAE,SAAS,YAAY,EAAE,KAAK,WAAW,WAAW,GAAG,OAAO;CACzE,IAAI,MAAM,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAAE,SAAS,KAAK,eAAe;CACrE,OAAO;AACT;;AAGA,SAAgB,aAAa,UAAkB,SAAgC;CAC7E,MAAM,MAAM,QAAQ,QAAQ,CAAC,CAAC,YAAY;CAC1C,MAAM,UAAU,QAAQ,UAAU;CAKlC,IAAI,QAAQ,SAAS,OAAO;CAC5B,IAAI,uCAAuC,KAAK,OAAO,GAAG,OAAO;CACjE,IAAI,qBAAqB,KAAK,OAAO,GAAG,OAAO;CAK/C,IAAI,oBAAoB,OAAO,GAAG,OAAO;CAEzC,IAAI,QAAQ,WAAW,QAAQ,QAAQ,OAAO;CAC9C,IAAI,QAAQ,WAAW,GAAG,GAAG,OAAO;CACpC,IAAI,QAAQ,WAAW,GAAG,GAAG;EAC3B,IAAI;EAQJ,IAAI;GACF,MAAM,KAAK,MAAM,OAAO;EAC1B,QAAQ;GACN,OAAO;EACT;EAEA,IAAI,KAAK,MAAM,MAAM,OAAO;EAE5B,IAAI,KAAK,MAAM,MAAM,OAAO;EAE5B,IAAI,KAAK,YAAY,mBAAmB,OAAO;EAG/C,IAAI,KAAK,MAAM,SAAS,QAAQ,OAAO;EAGvC,MAAM,OACJ,KAAK,SAAS,SAAS,SACnB,IAAI,UACJ,KAAK,SAAS,SACZ,MACA;EACR,IAAI,QAAQ,gBAAgB,IAAI,GAAG,OAAO;EAE1C,IAAI,OAAO,KAAK,SAAS,YAAY,oBAAoB,IAAI,IAAI,GAC/D,OAAO;EAET,OAAO;CACT;CACA,OAAO;AACT;;AAGA,SAAgB,mBAAmB,QAGjC;CAEA,IADgB,OAAO,UACb,CAAC,CAAC,WAAW,GAAG,GACxB,IAAI;EACF,MAAM,MAAM,KAAK,MAAM,MAAM;EAC7B,IAAI,OAAO,KAAK,SAAS,UACvB,OAAO;GACL,MAAM,IAAI;GACV,KAAK,OAAO,IAAI,QAAQ,WAAW,IAAI,MAAM,KAAA;EAC/C;CAEJ,QAAQ,CAER;CAEF,OAAO,EAAE,MAAM,OAAO;AACxB;;AAGA,SAAS,WAAW,YAAoB,QAAoC;CAE1E,IAAI,OAAO,UAAU,CAAC,CAAC,WAAW,GAAG,GAAG,OAAO,KAAA;CAC/C,MAAM,UAAU,WAAW,QAAQ,YAAY,MAAM;CACrD,IAAI,YAAY,cAAc,CAAC,WAAW,OAAO,GAAG,OAAO,KAAA;CAC3D,OAAO,aAAa,SAAS,MAAM;AACrC;;;;;;AAgBA,SAAgB,gBAAgB,QAA+B;CAC7D,MAAM,IAAI;CAEV,MAAM,SAAuB;EAC3B,OAAO;EACP,WAAW;EACX,cAAc;EACd,cAAc;EACd,SAAS;EACT,UAAU,GAAG,YAAY,CAAC;CAC5B;CACA,KAAK,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG;EAChC,OAAO;EACP,IAAI,EAAE,WAAW,aAAa,OAAO;OAChC,IAAI,EAAE,WAAW,gBAAgB,OAAO;OACxC,IAAI,EAAE,WAAW,iBAAiB,OAAO;OACzC,IAAI,EAAE,WAAW,WAAW,OAAO;CAC1C;CACA,OAAO;AACT;AAEA,eAAe,YAAY,KAA8B;CACvD,MAAM,UAID,CAAC;CACN,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,OAAO,GACjD,QAAQ,KAAK;EACX;EACA,SAAS,KAAK;EACd,WAAY,MAAM,gBAAgB,KAAK,KAAK,GAAG,MAAO;CACxD,CAAC;CAEH,KAAK,EAAE,QAAQ,SACb,QACG,KACE,MACC,KAAK,EAAE,OAAO,OAAO,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,YAAY,KAAK,qBAC/D,CAAC,CACA,KAAK,IAAI,CACd;CACA,OAAO,KAAK;AACd;AAEA,eAAsB,UAAU,MAAmC;CACjE,MAAM,MAAM,UAAU,MAAM,KAAK,KAAK,QAAQ,IAAI;CAClD,IAAI,KAAK,MAAM,iBAAiB,OAAO,YAAY,GAAG;CAEtD,MAAM,OAAO,KAAK,WAAW;CAC7B,IAAI,CAAC,MAAM,MAAM,IAAI,WAAW,6BAA6B;CAC7D,MAAM,OAAO,YAAY,MAAM,GAAG;CAElC,IAAI;CACJ,IAAI;EACF,SAAS,aAAa,MAAM,MAAM;CACpC,QAAQ;EACN,MAAM,IAAI,WAAW,kBAAkB,MAAM;CAC/C;CAEA,MAAM,QAAQ,OAAO,KAAK,OAAO,CAAC,CAAC,KAAK,IAAI;CAC5C,MAAM,YAAY,UAAU,MAAM,QAAQ;CAC1C,IAAI,aAAa,CAAC,QAAQ,YACxB,MAAM,IAAI,WACR,qBAAqB,UAAU,oBAAoB,MAAM,EAC3D;CAEF,MAAM,SAAS,aAAa,aAAa,MAAM,MAAM;CACrD,IAAI,CAAC,QACH,MAAM,IAAI,WACR,kCAAkC,KAAK,+BAA+B,MAAM,EAC9E;CAGF,MAAM,OAAO,QAAQ;CACrB,MAAM,MAAM,MAAM,gBAAyC,KAAK,KAAK,GAAG;CACxE,IAAI,CAAC,KACH,MAAM,IAAI,uBACR,KAAK,KACL,aAAa,OAAO,SAAS,KAAK,IAAI,0CAA0C,KAAK,KACvF;CAEF,MAAM,UAAU,IAAI,KAAK;CAQzB,IAAI;CACJ,IAAI;CACJ,IAAI,KAAK,UAAU,UAAU;EAK3B,MAAM,WAAW,mBAAmB,MAAM;EAC1C,MAAM,MAAM,SAAS,OAAO,WAAW,MAAM,MAAM;EACnD,CAAC,CAAE,SAAS,UAAW,QAAQ,SAAS,MAAM,MAAM,EAAE,IAAI,IAAI,KAAA,CAAS;CACzE,OAAO;EACL,MAAM,QAAQ,KAAK,UAAU,SAAS,KAAK,MAAM,MAAM,IAAI;EAC3D,CAAC,CAAE,SAAS,UAAW,QAAQ,KAAK;CACtC;CAEA,MAAM,UAAU,UAAU,MAAM,KAAK,KAAK,SAAS,MAAM,QAAQ,IAAI,CAAC;CACtE,MAAM,UAAU,kBACd,GAAG,YAAY,GAAG,QAAQ,QAC1B,SACA,GACF;CAEA,MAAM,SAAS,gBAAgB,MAAM;CACrC,MAAM,QAAQ,OAAO,eAAe,OAAO,UAAU;CACrD,KAAK;EAAE;EAAQ,MAAM;EAAS,QAAQ;CAAO,SAC3C;EACE,YAAY,OAAO,MAAM;EACzB,KAAK,OAAO,UAAU,cAAc,OAAO,aAAa,iBAAiB,OAAO,aAAa,kBAAkB,OAAO,QAAQ;EAC9H,GAAG,OAAO,SAAS,KAAK,MAAM,OAAO,GAAG;EACxC,QACI,4EACA;CACN,CAAC,CACE,OAAO,OAAO,CAAC,CACf,KAAK,IAAI,CACd;CACA,OAAO,KAAK;AACd;;;ACnWA,MAAMC,UACJ;AAEF,SAAS,aAAa,QAAoC;CACxD,OAAO,OACJ,KACE,MACC,QAAQ,EAAE,SAAS,IAAI,EAAE,SAAS,EAAE,OAAO,IAAI,EAAE,SAAS,GAAG,IAAI,EAAE,SACvE,CAAC,CACA,KAAK,IAAI;AACd;;AAGA,SAAgB,gBACd,KACyB;CACzB,IAAI,QAAQ,KAAA,GAAW,OAAO,CAAC;CAC/B,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,GAAG;CACzB,QAAQ;EACN,MAAM,IAAI,WAAW,iCAAiC;CACxD;CACA,IAAI,WAAW,QAAQ,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,GACvE,MAAM,IAAI,WAAW,iCAAiC;CAExD,OAAO;AACT;AAEA,SAAS,UAAU,MAAc,KAAqC;CACpE,MAAM,OAAO,iBAAiB,MAAM,GAAG;CACvC,MAAM,IAAI,8BAA8B,IAAI;CAC5C,IAAI,CAAC,EAAE,OACL,MAAM,IAAI,qBACR,GAAG,KAAK,2CACR,EAAE,OAAO,QAAQ,MAAM,EAAE,aAAa,OAAO,CAAC,CAAC,KAAK,MAAM,EAAE,OAAO,CACrE;CAEF,OAAO;AACT;AAEA,eAAsB,eAAe,MAAmC;CACtE,MAAM,MAAM,KAAK,WAAW;CAC5B,MAAM,OAAO,KAAK,WAAW;CAC7B,IAAI,QAAQ,cAAc,QAAQ,YAAY,QAAQ,SACpD,MAAM,IAAI,WAAW,yBAAyB,OAAO,GAAG,KAAKA,SAAO;CAEtE,IAAI,CAAC,MACH,MAAM,IAAI,WAAW,gBAAgB,IAAI,0BAA0B;CACrE,MAAM,MAAM,UAAU,MAAM,KAAK,KAAK,QAAQ,IAAI;CAElD,IAAI,QAAQ,YAAY;EACtB,MAAM,OAAO,MAAM,SAAS,GAAG;EAC/B,MAAM,SAAS,MAAM,iBAAiB,iBAAiB,MAAM,GAAG,GAAG,EACjE,aAAa,OACT,OAAO,OAAO,EACZ,SAAS,MAAM,KAAK,GAAG,EAAE,iBAAiB,OAAO,CAAC,EAAA,CAAG,OACvD,KACA,KAAA,EACN,CAAC;EACD,IAAI,CAAC,MACH,KAAK,gEAAgE;EACvE,KAAK,cACH,OAAO,OAAO,WAAW,IACrB,qCACA,GAAG,OAAO,QAAQ,YAAY,YAAY,KAAK,OAAO,OAAO,OAAO,cAAc,aAAa,OAAO,MAAM,GAClH;EACA,OAAO,OAAO,QAAQ,KAAK,KAAK,KAAK;CACvC;CAEA,MAAM,MAAM,UAAU,MAAM,GAAG;CAE/B,IAAI,QAAQ,UAAU;EACpB,MAAM,QAAQ,UAAU,MAAM,OAAO;EACrC,IACE,UAAU,KAAA,KACV,CAAE,gBAAsC,SAAS,KAAK,GAEtD,MAAM,IAAI,WACR,oBAAoB,MAAM,iBAAiB,gBAAgB,KAAK,IAAI,EAAE,EACxE;EAIF,IAAI,UAAU,KAAA,GAAW;GACvB,MAAM,SAAS,cAAc,GAAG,CAAC,CAAC,KAAK,MAAM,EAAE,KAAK;GACpD,IAAI,CAAE,OAAoB,SAAS,KAAK,GACtC,MAAM,IAAI,WACR,GAAG,KAAK,WAAW,MAAM,qBAAqB,UAAU,YAAY,YAAY,aAAa,sBAAsB,OAAO,KAAK,IAAI,EAAE,EACvI;EAEJ;EACA,MAAM,SAAS,UAAU,MAAM,QAAQ,KAAK;EAC5C,IAAI,WAAW,UAAU,WAAW,QAClC,MAAM,IAAI,WAAW,qBAAqB,OAAO,qBAAqB;EACxE,IAAI;EACJ,IAAI;GACF,SAAS,MAAM,mBACb,KACA,sBACE,KACA,KAAA,GACA,KACF,CACF;EACF,SAAS,KAAK;GACZ,MAAM,IAAI,qBAAqB,GAAG,KAAK,oBAAoB,CACxD,IAAc,OACjB,CAAC;EACH;EACA,IAAI,WAAW,QACb,UACE,OACE,MAAM,YAAY,KAAK,gBAAgB,EAAA,CACvC,QAAQ,EAAE,iBAAiB,OAAO,CAAC,EAAA,CACrC;EACJ,MAAM,MAAM,UAAU,MAAM,OAAO,GAAG;EACtC,IAAI,KAAK;GACP,MAAM,OAAO,YAAY,KAAK,GAAG;GACjC,UAAU,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;GAC5C,cAAc,MAAM,QAAQ,MAAM;GAClC,KAAK,SAAS,MAAM;GACpB,OAAO,KAAK;EACd;EACA,KAAK;GAAE;GAAQ;EAAO,SAAS,MAAM;EACrC,OAAO,KAAK;CACd;CAGA,IAAI,CAAC,IAAI,mBACP,MAAM,IAAI,WAAW,GAAG,KAAK,sCAAsC;CACrE,MAAM,eAAe,YAAY,GAAG,CAAC,CAAC,QAAQ,MAAM,EAAE,aAAa,OAAO;CAC1E,IAAI,aAAa,SAAS,GACxB,MAAM,IAAI,qBACR,GAAG,KAAK,2DACR,aAAa,KAAK,MAAM,GAAG,EAAE,OAAO,IAAI,EAAE,SAAS,CACrD;CAEF,MAAM,YAAY,gBAAgB,UAAU,MAAM,QAAQ,CAAC;CAC3D,MAAM,WAAW,cAAc,GAAG,CAAC,CAAC,EAAE,CAAC;CACvC,MAAM,SAAS,MAAM,UAAU,IAAI,mBAAmB;EACpD,GAAG;EACH,GAAG;CACL,CAAC;CACD,KAAK,cACH,OAAO,KACH,KAAK,OAAO,OAAO,KAAK,KAAK,UAAU,OAAO,QAAQ,MAAM,CAAC,IAAI,OAAO,SAAS,SAAS,eAAe,OAAO,SAAS,KAAK,IAAI,MAAM,OACxI,KAAK,OAAO,OAClB;CACA,OAAO,OAAO,KAAK,KAAK,KAAK,KAAK;AACpC;;;;;;;;;;;;;ACjJA,SAAS,UAAU,SAAiC;CAClD,OAAO,UAAW,SAAkC,MAAM;AAC5D;AAEA,SAAS,UAAU,QAAgC;CACjD,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO;CACnC,KAAK,MAAM,SAAS,QAIhB;EACF,IAAI,OAAO,SAAS,WAAW,OAAO,MAAM,YAAY,UACtD,OAAO,MAAM;EAEf,IAAI,OAAO,SAAS,aAAa,MAAM,QAAQ,MAAM,QAAQ,GAC3D,KAAK,MAAM,UAAU,MAAM,UAAU;GACnC,MAAM,MAAM,UAAU,MAAM;GAC5B,IAAI,KAAK,OAAO;EAClB;CAEJ;CACA,OAAO;AACT;AAEA,SAAgB,QAAQ,MAA0B;CAChD,MAAM,MAAM,UAAU,MAAM,KAAK,KAAK,QAAQ,IAAI;CAClD,MAAM,YAAY,iBAAiB,GAAG,CAAC,CAAC,KAAK,UAAU;EACrD;EACA,OAAO,UAAU,gBAAgB,KAAK,KAAK,aAAa,IAAI,CAAC,CAAC;CAChE,EAAE;CACF,KAAK,EAAE,UAAU,SACf,UAAU,WAAW,IACjB,mBAAmB,YAAY,KAC/B,UACG,KAAK,MAAM,KAAK,EAAE,OAAO,EAAE,QAAQ,MAAM,EAAE,UAAU,IAAI,CAAC,CAC1D,KAAK,IAAI,CAClB;CACA,OAAO,KAAK;AACd;AAEA,eAAe,OACb,MACA,MACA,MACmB;CACnB,OAAO,MAAM,oBAAoB,OAAO,QAAQ;EAC9C,QAAQ;EACR,SAAS,EAAE,gBAAgB,mBAAmB;EAC9C,MAAM,SAAS,KAAA,IAAY,KAAA,IAAY,KAAK,UAAU,IAAI;CAC5D,CAAC;AACH;;AAGA,SAAS,UAAU,OAA6B;CAC9C,IAAI,CAAC,MAAM,IAAI,OAAO,sCAAsC,MAAM;CAClE,OAAO,MAAM,SAAS,SAAS,IAC3B,4DAA4D,MAAM,SAAS,KAAK,IAAI,EAAE,KACtF;AACN;AAEA,eAAsB,QAAQ,MAAmC;CAC/D,MAAM,MAAM,KAAK,WAAW;CAC5B,MAAM,MAAM,YAAY,UAAU,MAAM,KAAK,KAAK,KAAK,QAAQ,IAAI,CAAC;CAEpE,IAAI,QAAQ,YAAY,QAAQ,QAAQ;EACtC,MAAM,OAAO,YAAY,GAAG;EAC5B,IAAI,CAAC,QAAQ,CAAC,aAAa,KAAK,GAAG,GACjC,MAAM,IAAI,WACR,sDAAsD,YAAY,mBACpE;EAEF,IAAI,QAAQ,UAAU;GACpB,MAAM,qBAAqB,KAAK,MAAM,2BAA2B;GACjE,MAAM,MAAM,MAAM,OAChB,KAAK,MACL,WACA,qBAAqB,EAAE,oBAAoB,KAAK,IAAI,KAAA,CACtD;GACA,MAAM,OAAQ,MAAM,IAAI,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE;GAQ/C,MAAM,UAAU,KAAK,WAAW;GAChC,MAAM,WAAW,KAAK,aAAa;GAGnC,IAAI,IAAI,UAAU,OAAO,KAAK,OAAO,OAAO;IAM1C,MAAM,QAAQ,GAJZ,KAAK,UACJ,IAAI,UAAU,MACX,uCAAuC,IAAI,OAAO,MAClD,6CACkB;IACxB,KACE;KAAE,UAAU;KAAO,IAAI;KAAO;KAAS;KAAU;IAAM,SACjD,KACR;IACA,OAAO,KAAK;GACd;GACA,MAAM,QAAQ,KAAK;GACnB,KACE;IACE,UAAU;IACV,IAAI;IACJ;IACA;IACA,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;GAC3B,SAEE,CACE,KAAK,SAAS,iBACV,8BAA8B,QAAQ,aACtC,8BAA8B,QAAQ,sBAC1C,QAAQ,UAAU,KAAK,IAAI,EAC7B,CAAC,CACE,OAAO,OAAO,CAAC,CACf,KAAK,IAAI,CAChB;GACA,OAAO,KAAK;EACd;EACA,IAAI;GACF,QAAQ,KAAK,KAAK,KAAK,SAAS;EAClC,QAAQ,CAER;EACA,OAAO,YAAY,GAAG,GAAG,EAAE,OAAO,KAAK,CAAC;EACxC,KAAK,EAAE,SAAS,KAAK,SAAS,0BAA0B;EACxD,OAAO,KAAK;CACd;CAEA,IAAI,QAAQ,KAAA,GACV,MAAM,IAAI,WACR,iBAAiB,IAAI,mDACvB;CAIF,MAAM,WAAW,UAAU,MAAM,MAAM;CACvC,MAAM,gBAAgB,WAAW,OAAO,QAAQ,IAAI;CACpD,MAAM,OAAO,UAAU,MAAM,MAAM;CACnC,MAAM,cAAc,UAAU,MAAM,cAAc;CAClD,MAAM,OAAO,UAAU,MAAM,MAAM;CACnC,IAAI,eAAe,MACjB,MAAM,IAAI,WAAW,iDAAiD;CAExE,IAAI,QAAQ,CAAC,aACX,MAAM,IAAI,WAAW,0CAA0C;CAEjE,MAAM,UAAU,KAAK,MAAM,UAAU;CACrC,IAAI,WAAW,CAAC,aACd,MAAM,IAAI,WAAW,2CAA2C;CAElE,MAAM,YAAY,UAAU,MAAM,QAAQ;CAC1C,IAAI,cAAc,KAAA,KAAa,CAAC,SAC9B,MAAM,IAAI,WAAW,qCAAqC;CAE5D,MAAM,cAAc,UAAU,gBAAgB,SAAS,IAAI,KAAA;CAC3D,MAAM,OAAO,MAAe,WAAW,CAAC,IAAI,IAAI,QAAQ,KAAK,CAAC;CAC9D,MAAM,YACkC;EACtC,MAAM,cAAc,iBAAiB;EACrC,MAAM,IAAI,eAAe,QAAQ,KAAA,gBAAkB,eAAe,CAAC;EACnE,GAAI,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,IAAI,CAAC;EAClC,GAAI,cAAc,EAAE,OAAO,YAAY,IAAI,CAAC;CAC9C;CAEA,MAAM,WAAW,YAAY,GAAG;CAChC,IAAI,YAAY,aAAa,SAAS,GAAG,GAAG;EAG1C,MAAM,OAAO,SAAS,QAAQ;EAC9B,IACE,SAAS,UAAU,QAClB,SAAS,SAAS,KAAA,KAAa,SAAS,SAAS,UAAU,QAC3D,SAAS,mBACP,SAAS,SAAS,UAAU,QAC3B,KAAK,UAAU,SAAS,KAAK,MAAM,KAAK,UAAU,UAAU,KAAK,IAErE,MAAM,IAAI,WACR,wCAAwC,SAAS,QAAQ,eAAe,IAAI,KAAK,wCACnF;EAEF,KACE;GACE,KAAK,oBAAoB,SAAS,KAAK;GACvC,KAAK,SAAS;GACd,gBAAgB;EAClB,SAEE,oCAAoC,SAAS,IAAI,wBAAwB,SAAS,KAAK,EAC3F;EACA,OAAO,KAAK;CACd;CACA,IAAI,UAAU,OAAO,YAAY,GAAG,GAAG,EAAE,OAAO,KAAK,CAAC;CAEtD,MAAM,SAAS,MAAM,sBAAsB;EACzC;EACA;EACA;EACA;EACA;EACA,GAAI,cAAc,EAAE,OAAO,EAAE,QAAQ,YAAY,EAAE,IAAI,CAAC;CAC1D,CAAC;CAED,UAAU,QAAQ,YAAY,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,CAAC;CACxD,cACE,YAAY,GAAG,GACf,KAAK,UAAU;EACb,KAAK,QAAQ;EACb,MAAM,OAAO;EACb,GAAG;EACH,MAAM,OAAO;CACf,CAAuB,GACvB,MACF;CAEA,MAAM,gBAAgB;EACpB,OAAO,YAAY,GAAG,GAAG,EAAE,OAAO,KAAK,CAAC;EACxC,OAAO,MAAM,CAAC,CAAC,cAAc,QAAQ,KAAK,KAAK,EAAE,CAAC;CACpD;CACA,QAAQ,GAAG,UAAU,OAAO;CAC5B,QAAQ,GAAG,WAAW,OAAO;CAI7B,MAAM,QAAQ,OAAO,UAAU;CAC/B,KACE;EACE,KAAK,OAAO;EACZ,MAAM,OAAO;EACb;EACA,UAAU,OAAO;EACjB,aAAa,OAAO;EACpB,aAAa,cAAc,OAAO,cAAc,KAAA;EAChD,OAAO,SAAS,KAAA;CAClB,SAEE;EACE,uCAAuC,OAAO;EAC9C,OAAO,WACH,SAAS,cAAc,oBAAoB,OAAO,KAAK,KACvD;EACJ,GAAG,cAAc,iBAAiB,eAAe,IAAI,OAAO;EAC5D,QAAQ,UAAU,KAAK,IAAI;CAC7B,CAAC,CACE,OAAO,OAAO,CAAC,CACf,KAAK,IAAI,CAChB;CAEA,IAAI,KAAK,MAAM,YACb,KAAK,QAAQ,OAAO,IAAI,eAAe;MAClC;EACL,KAAK,WAAW,OAAO,IAAI,4BAA4B;EACvD,YAAY,OAAO,GAAG;CACxB;CACA,KAAK,8DAA8D;CAGnE,OAAO,IAAI,cAAsB,CAAC,CAAC;AACrC;;;AC7QA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;AAoBd,eAAsB,KAAK,MAAiC;CAC1D,MAAM,OAAO,UAAU,IAAI;CAC3B,YAAY,KAAK,IAAI;CAErB,QAAQ,KAAK,SAAb;EACE,KAAK,YACH,OAAO,YAAY,IAAI;EACzB,KAAK,UACH,OAAO,UAAU,IAAI;EACvB,KAAK,UACH,OAAO,MAAM,UAAU,IAAI;EAC7B,KAAK,QACH,OAAO,QAAQ,IAAI;EACrB,KAAK,UACH,OAAO,MAAM,UAAU,IAAI;EAC7B,KAAK,QACH,OAAO,MAAM,QAAQ,IAAI;EAC3B,KAAK,QACH,OAAO,QAAQ,IAAI;EACrB,KAAK,gBACH,OAAO,MAAM,eAAe,IAAI;EAClC,KAAK;GACH,KAAK,KAAK;GACV,OAAO,KAAK;EACd,KAAK,KAAA;GAIH,IAAI,KAAK,MAAM,SAAS,QAAQ,KAAK,MAAM,MAAM,MAAM;IACrD,KAAK,KAAK;IACV,OAAO,KAAK;GACd;GACA,KAAK,KAAK;GACV,OAAO,KAAK;EACd;GACE,KAAK,oBAAoB,KAAK,QAAQ,QAAQ,OAAO;GACrD,OAAO,KAAK;CAChB;AACF;AAaA,SAAgB,eAAwB;CACtC,MAAM,QAAQ,QAAQ,KAAK;CAC3B,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI;EACF,OAAO,cAAc,aAAa,KAAK,CAAC,CAAC,CAAC,SAAS,YAAY;CACjE,QAAQ;EAIN,OAAO;CACT;AACF;AAEA,IAAI,aAAa,GACf,KAAK,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,CACxB,MAAM,SAAS,QAAQ,KAAK,IAAI,CAAC,CAAC,CAClC,OAAO,QAAiB;CACvB,IAAI,eAAe,sBAAsB;EACvC,KAAK,IAAI,OAAO;EAChB,KAAK,MAAM,KAAK,IAAI,QAAQ,KAAK,OAAO,GAAG;EAC3C,QAAQ,KAAK,KAAK,OAAO;CAC3B;CACA,IAAI,eAAe,wBAAwB;EACzC,KAAK,IAAI,OAAO;EAChB,QAAQ,KAAK,KAAK,UAAU;CAC9B;CACA,IAAI,eAAe,YAAY;EAC7B,KAAK,IAAI,OAAO;EAChB,QAAQ,KAAK,KAAK,KAAK;CACzB;CACA,KAAK,qBAAsB,KAAe,WAAW,OAAO,GAAG,GAAG;CAClE,QAAQ,KAAK,KAAK,KAAK;AACzB,CAAC"}
+{"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 { Operation, TemplateContent } from \"@templatical/types\";\nimport { applyOperations, OperationError } 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 { validateTemplate } from \"../../index\";\n\nfunction parseOperations(args: ParsedArgs, cwd: string): unknown[] {\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 unknown];\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;\n  }\n  throw new UsageError(\n    \"edit needs --op '<json>' for one operation or --ops <file> for a batch.\",\n  );\n}\n\n/** An object written in the old vocabulary: `{\"operation\": …, \"data\": …}`. */\nfunction isOldVocabulary(input: unknown): boolean {\n  return (\n    typeof input === \"object\" &&\n    input !== null &&\n    \"operation\" in input &&\n    !(\"op\" in input)\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  const oldIndex = operations.findIndex(isOldVocabulary);\n  if (oldIndex !== -1) {\n    throw new UsageError(\n      `Operation ${oldIndex + 1} uses the old {\"operation\", \"data\"} form. ` +\n        'Write {\"op\": \"updateBlock\", \"blockId\": …, \"set\": {…}} and the like: ' +\n        \"see the operations reference.\",\n    );\n  }\n  const before = readTemplateFile(file, cwd) as TemplateContent;\n\n  // All or nothing: the engine throws at the first refused operation and\n  // nothing is written. A working file has one writer, so there are no locks.\n  let content: TemplateContent;\n  try {\n    content = applyOperations(before, operations as Operation[]);\n  } catch (error) {\n    if (!(error instanceof OperationError)) throw error;\n    const refused = operations[error.opIndex] as { op?: unknown } | undefined;\n    throw new UsageError(\n      `Operation ${error.opIndex + 1} (${String(refused?.op)}) was refused: ${error.code} — ${error.message}`,\n    );\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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"}

package/dist/{custom-block-sAM61QPU.js → custom-block-CsZN9qMM.js}

@@ -92,6 +92,10 @@ const schema = {
 					"$ref": "#/definitions/BackgroundImage",
 					"description": "Image behind the section's columns, rendered as `background-url` (plus size, position and repeat) on the `mj-section`. `styles.backgroundColor` is its fallback."
 				},
+				"hero": {
+					"$ref": "#/definitions/SectionHero",
+					"description": "Draws a one-column section with a background image as an `mj-hero`: the image fills the box and the content sits on top. Ignored (the section renders as a regular one, and the `structure` linter says why) with more than one column, without an image, or with `height: \"image\"` and no image size."
+				},
 				"wrapper": {
 					"$ref": "#/definitions/SectionWrapper",
 					"description": "Optional outer frame (rendered as an `mj-wrapper` around the section)."
@@ -231,6 +235,14 @@ const schema = {
 				"repeat": {
 					"type": "boolean",
 					"description": "`false` paints the image once; `true` tiles it."
+				},
+				"naturalWidth": {
+					"type": "number",
+					"description": "The image file's own width in px, when known: given by the media library, measured by the editor when the author sets the URL, or read by an importer (from MJML, the hero's `background-width`, which may be the box's size rather than the file's). Only the ratio with `naturalHeight` is used: a section hero with `height: \"image\"` keeps its box at that shape. Both or neither; one without the other reads as unknown."
+				},
+				"naturalHeight": {
+					"type": "number",
+					"description": "The image file's own height in px, when known; it pairs with `naturalWidth`, and only their ratio is used. Both or neither."
 				}
 			},
 			"required": [
@@ -267,6 +279,31 @@ const schema = {
 				"bottom"
 			]
 		},
+		"SectionHero": {
+			"type": "object",
+			"properties": {
+				"height": {
+					"anyOf": [{
+						"type": "string",
+						"const": "image"
+					}, { "type": "number" }],
+					"description": "`\"image\"` makes the box as tall as the image drawn across its desktop width, and needs the image's size on `backgroundImage.naturalWidth` / `naturalHeight`; a phone keeps that height and crops the image's sides. A number is the box's fixed height in px, padding included."
+				},
+				"verticalAlign": { "$ref": "#/definitions/HeroVerticalAlign" }
+			},
+			"required": ["height", "verticalAlign"],
+			"additionalProperties": false,
+			"description": "Draws a one-column section as an MJML `mj-hero`: its background image fills the box (always `cover`, never tiled) and the content sits on top of it. A hero applies only to a one-column section with a background image; otherwise the section renders as a regular one."
+		},
+		"HeroVerticalAlign": {
+			"type": "string",
+			"enum": [
+				"top",
+				"middle",
+				"bottom"
+			],
+			"description": "Where a hero's content sits in its box."
+		},
 		"SectionWrapper": {
 			"type": "object",
 			"properties": {
@@ -421,6 +458,11 @@ const schema = {
 					"type": "number",
 					"description": "Height in pixels. Absent means the height is derived from the width, so the image keeps its aspect ratio — setting both stretches it, since email clients don't support `object-fit`."
 				},
+				"naturalWidth": {
+					"type": "number",
+					"description": "The image file's own size in px, when known: given by the media library, read by an importer, or measured in the editor during an edit. Both or neither; one without the other reads as unknown. It drives the editor's aspect-ratio lock and is never rendered. Cleared when `src` changes without a new size alongside it."
+				},
+				"naturalHeight": { "type": "number" },
 				"align": {
 					"type": "string",
 					"enum": [
@@ -2625,4 +2667,4 @@ async function checkCustomBlock(data, { compileMjml } = {}) {
 //#endregion
 export { buildSpecimenTemplate as a, runRecipe as c, schema as d, validateTemplate as f, buildSpecimen as i, validateCustomBlockDefinition as l, renderSpecimenMjml as n, fetchedSpecimenBlocks as o, SPECIMEN_STATES as r, checkRecipe as s, checkCustomBlock as t, runQualityLint as u };
 
-//# sourceMappingURL=custom-block-sAM61QPU.js.map
+//# sourceMappingURL=custom-block-CsZN9qMM.js.map