@nowline/cli 0.2.0

package/dist/commands/init.d.ts

@@ -0,0 +1,20 @@
+import type { ParsedArgs } from '../cli/args.js';
+export interface InitHandlerOptions {
+    args: ParsedArgs;
+    /** Test seam: cwd override. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * `--init` mode handler. Scaffolds a starter `.nowline` file in cwd.
+ *
+ * Positional argument is the project *name*, not a file path:
+ *   - No extension      → append `.nowline`.
+ *   - `.nowline`        → use literal.
+ *   - Other extension   → exit 2.
+ *   - Missing positional → default name "roadmap".
+ *
+ * `-o` overrides the resolved path. Existing files are silently overwritten.
+ */
+export declare function initHandler(options: InitHandlerOptions): Promise<void>;
+export declare function applyName(template: string, name: string | undefined): string;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMjD,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B5E;AA6BD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAU5E"}

package/dist/commands/init.js

@@ -0,0 +1,80 @@
+import { defaultInitOutputPath, initNameHasIncompatibleExtension } from '../cli/output-path.js';
+import { TEMPLATE_NAMES, TEMPLATES } from '../generated/templates.js';
+import { CliError, ExitCode } from '../io/exit-codes.js';
+import { writeOutput } from '../io/write.js';
+/**
+ * `--init` mode handler. Scaffolds a starter `.nowline` file in cwd.
+ *
+ * Positional argument is the project *name*, not a file path:
+ *   - No extension      → append `.nowline`.
+ *   - `.nowline`        → use literal.
+ *   - Other extension   → exit 2.
+ *   - Missing positional → default name "roadmap".
+ *
+ * `-o` overrides the resolved path. Existing files are silently overwritten.
+ */
+export async function initHandler(options) {
+    const { args } = options;
+    const cwd = options.cwd ?? process.cwd();
+    const template = parseTemplateName(args.template);
+    const positional = args.positional;
+    if (positional !== undefined &&
+        positional !== '' &&
+        initNameHasIncompatibleExtension(positional)) {
+        throw new CliError(ExitCode.InputError, `nowline: --init only scaffolds .nowline files; got "${positional}".`);
+    }
+    const projectName = projectNameFor(positional);
+    const titleName = titleFor(positional);
+    const templateText = TEMPLATES[template];
+    const rendered = applyName(templateText, titleName);
+    const outputPath = args.output ?? defaultInitOutputPath({ name: projectName, cwd });
+    await writeOutput(outputPath, rendered, 'text', { cwd });
+    if (args.logLevel === 'verbose') {
+        process.stderr.write(`nowline: wrote ${outputPath}\n`);
+    }
+}
+function parseTemplateName(raw) {
+    const value = (raw ?? '').toLowerCase();
+    if (value === '')
+        return 'minimal';
+    if (TEMPLATE_NAMES.includes(value)) {
+        return value;
+    }
+    throw new CliError(ExitCode.InputError, `nowline: unknown --template "${raw}". Choose one of: ${TEMPLATE_NAMES.join(', ')}.`);
+}
+function projectNameFor(positional) {
+    if (!positional)
+        return undefined;
+    return positional;
+}
+/**
+ * Returns the title to substitute into the roadmap declaration. When the user
+ * passes a positional we use it as-is; trailing `.nowline` is stripped so the
+ * title isn't `My Plan.nowline`.
+ */
+function titleFor(positional) {
+    if (!positional)
+        return undefined;
+    return positional.endsWith('.nowline') ? positional.slice(0, -'.nowline'.length) : positional;
+}
+export function applyName(template, name) {
+    if (!name)
+        return template;
+    const lines = template.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!/^\s*roadmap\b/.test(line))
+            continue;
+        lines[i] = rewriteRoadmapTitle(line, name);
+        break;
+    }
+    return lines.join('\n');
+}
+function rewriteRoadmapTitle(line, name) {
+    const match = line.match(/^(\s*roadmap\s+[A-Za-z_][A-Za-z0-9_-]*)(\s+"[^"]*")?(.*)$/);
+    if (!match)
+        return line;
+    const [, head, , tail] = match;
+    return `${head} ${JSON.stringify(name)}${tail}`;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,SAAS,EAAqB,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQ7C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IACzD,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAEnC,IACI,UAAU,KAAK,SAAS;QACxB,UAAU,KAAK,EAAE;QACjB,gCAAgC,CAAC,UAAU,CAAC,EAC9C,CAAC;QACC,MAAM,IAAI,QAAQ,CACd,QAAQ,CAAC,UAAU,EACnB,uDAAuD,UAAU,IAAI,CACxE,CAAC;IACN,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAEpD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IAEpF,MAAM,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAEzD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,UAAU,IAAI,CAAC,CAAC;IAC3D,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAuB;IAC9C,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACnC,IAAK,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,KAAqB,CAAC;IACjC,CAAC;IACD,MAAM,IAAI,QAAQ,CACd,QAAQ,CAAC,UAAU,EACnB,gCAAgC,GAAG,qBAAqB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACvF,CAAC;AACN,CAAC;AAED,SAAS,cAAc,CAAC,UAA8B;IAClD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,UAAU,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,UAA8B;IAC5C,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAwB;IAChE,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAC1C,KAAK,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM;IACV,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,IAAY;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IACtF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,IAAI,EAAE,AAAD,EAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IAC/B,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;AACpD,CAAC"}

package/dist/commands/render.d.ts

@@ -0,0 +1,15 @@
+import { type AssetResolver } from '@nowline/renderer';
+import type { ParsedArgs } from '../cli/args.js';
+export interface RenderHandlerOptions {
+    args: ParsedArgs;
+    /** Test seam: cwd override. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * Default render handler. Produces output in the resolved format and writes
+ * it to the resolved path (file or stdout). Honors `--dry-run` (skip write
+ * step), `--input-format`, and `.json` AST input.
+ */
+export declare function renderHandler(options: RenderHandlerOptions): Promise<void>;
+export declare function createAssetResolver(assetRoot: string): AssetResolver;
+//# sourceMappingURL=render.d.ts.map

package/dist/commands/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/commands/render.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAwBjD,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4FhF;AA4ZD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAWpE"}

package/dist/commands/render.js

@@ -0,0 +1,435 @@
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { resolveIncludes } from '@nowline/core';
+import { lengthToPoints, parseLength } from '@nowline/export-core';
+import { layoutRoadmap } from '@nowline/layout';
+import { renderSvg } from '@nowline/renderer';
+import { FormatResolutionError, isInputFormat, resolveFormat, } from '../cli/formats.js';
+import { resolveRenderOutputPath } from '../cli/output-path.js';
+import { parseNowlineJson } from '../convert/parse-json.js';
+import { printNowlineFile } from '../convert/printer.js';
+import { serializeToJson } from '../convert/schema.js';
+import { getServices, parseSource } from '../core/parse.js';
+import { formatDiagnostics } from '../diagnostics/index.js';
+import { describeContentLocaleSource, operatorLocale, readDirectiveLocale, resolveLocaleOverride, } from '../i18n/locale.js';
+import { loadConfig } from '../io/config.js';
+import { CliError, ExitCode } from '../io/exit-codes.js';
+import { readInput } from '../io/read.js';
+import { writeOutput } from '../io/write.js';
+/**
+ * Default render handler. Produces output in the resolved format and writes
+ * it to the resolved path (file or stdout). Honors `--dry-run` (skip write
+ * step), `--input-format`, and `.json` AST input.
+ */
+export async function renderHandler(options) {
+    const { args } = options;
+    const cwd = options.cwd ?? process.cwd();
+    if (!args.positional) {
+        throw new CliError(ExitCode.InputError, 'nowline: missing input file. Pass a path, "-" for stdin, or run `nowline --help`.');
+    }
+    const isStdoutOutput = args.output === '-';
+    const config = await loadConfigFor(args.positional, cwd);
+    const format = resolveFormatOrThrow({
+        flag: args.format,
+        outputPath: args.output,
+        configFormat: typeof config?.defaultFormat === 'string' ? config.defaultFormat : undefined,
+        isStdout: isStdoutOutput,
+    });
+    if (args.logLevel === 'verbose') {
+        process.stderr.write(`nowline: format=${format} (resolved)\n`);
+    }
+    const resolvedOutput = resolveRenderOutputPath({
+        outputArg: args.output,
+        isStdout: isStdoutOutput,
+        inputArg: args.positional,
+        isStdin: args.positional === '-',
+        format,
+        cwd,
+    });
+    const inputFormat = resolveInputFormat(args.positional, args.inputFormat);
+    const input = await readInput(args.positional, { cwd });
+    const resolved = resolveLocaleOverride({
+        flag: args.locale,
+        env: process.env,
+        rc: stringFromConfig(config, 'locale'),
+    });
+    const locale = resolved.tag;
+    const opLocale = operatorLocale(resolved);
+    const { rendered, isBinary } = await produce({
+        format,
+        inputFormat,
+        contents: input.contents,
+        displayPath: input.displayPath,
+        absInputPath: input.isStdin ? path.resolve(cwd, 'stdin.nowline') : input.path,
+        isStdin: input.isStdin,
+        theme: parseTheme(args.theme),
+        today: resolveNowArg(args),
+        width: parseWidthArg(args.width),
+        noLinks: args.noLinks,
+        strict: args.strict,
+        assetRoot: args.assetRoot,
+        // m2c format-specific options. Strings get parsed inside the format
+        // dispatch; the CLI just passes them through.
+        pageSize: args.pageSize ?? stringFromConfig(config, 'pdfPageSize'),
+        orientation: args.orientation ?? stringFromConfig(config, 'pdfOrientation'),
+        margin: args.margin ?? stringFromConfig(config, 'pdfMargin'),
+        fontSans: args.fontSans ?? stringFromConfig(config, 'fontSans'),
+        fontMono: args.fontMono ?? stringFromConfig(config, 'fontMono'),
+        headless: args.headless || boolFromConfig(config, 'headlessFonts'),
+        scale: args.scale,
+        start: args.start,
+        locale,
+        operatorLocale: opLocale,
+        resolvedLocale: resolved,
+        verbose: args.logLevel === 'verbose',
+    });
+    if (args.dryRun) {
+        if (args.logLevel === 'verbose') {
+            process.stderr.write('nowline: --dry-run; skipping write\n');
+        }
+        return;
+    }
+    await writeOutput(resolvedOutput.isStdout ? '-' : resolvedOutput.path, rendered, isBinary ? 'binary' : 'text', { cwd });
+    if (args.logLevel === 'verbose' && !resolvedOutput.isStdout) {
+        process.stderr.write(`nowline: wrote ${resolvedOutput.path}\n`);
+    }
+}
+function resolveFormatOrThrow(inputs) {
+    try {
+        return resolveFormat({
+            flagFormat: inputs.flag,
+            outputPath: inputs.outputPath,
+            configFormat: inputs.configFormat,
+            isStdout: inputs.isStdout,
+        }).format;
+    }
+    catch (err) {
+        if (err instanceof FormatResolutionError) {
+            throw new CliError(ExitCode.InputError, `nowline: ${err.message}`);
+        }
+        throw err;
+    }
+}
+function resolveInputFormat(inputArg, override) {
+    if (override) {
+        const lower = override.toLowerCase();
+        if (!isInputFormat(lower)) {
+            throw new CliError(ExitCode.InputError, `nowline: invalid --input-format "${override}". Expected nowline or json.`);
+        }
+        return lower;
+    }
+    if (inputArg === '-')
+        return 'nowline';
+    const ext = path.extname(inputArg).toLowerCase();
+    if (ext === '.json')
+        return 'json';
+    return 'nowline';
+}
+async function produce(args) {
+    if (args.format === 'json') {
+        return { rendered: await produceJson(args), isBinary: false };
+    }
+    if (args.format === 'nowline') {
+        return { rendered: await produceCanonicalNowline(args), isBinary: false };
+    }
+    // The remaining formats all start from a positioned model + (sometimes) an
+    // SVG. Build them once and dispatch to the format-specific exporter via
+    // dynamic import — keeps each exporter's heavy deps off cold paths and
+    // leaves room to re-extract a package later if a future build profile
+    // wants to slim down.
+    const stage = await stageRoadmap(args);
+    if (args.format === 'svg') {
+        return { rendered: stage.svg, isBinary: false };
+    }
+    try {
+        if (args.format === 'html') {
+            const mod = await import('@nowline/export-html');
+            const html = await mod.exportHtml(stage.exportInputs, stage.svg);
+            return { rendered: html, isBinary: false };
+        }
+        if (args.format === 'mermaid') {
+            const mod = await import('@nowline/export-mermaid');
+            const md = mod.exportMermaid(stage.exportInputs);
+            return { rendered: md, isBinary: false };
+        }
+        if (args.format === 'msproj') {
+            const mod = await import('@nowline/export-msproj');
+            const xml = mod.exportMsProjXml(stage.exportInputs, {
+                startDate: args.start,
+            });
+            return { rendered: xml, isBinary: false };
+        }
+        if (args.format === 'png') {
+            const fonts = await stage.fontPair();
+            const mod = await import('@nowline/export-png');
+            const png = await mod.exportPng(stage.exportInputs, stage.svg, {
+                scale: parseScale(args.scale),
+                fonts,
+            });
+            return { rendered: png, isBinary: true };
+        }
+        if (args.format === 'pdf') {
+            const fonts = await stage.fontPair();
+            const mod = await import('@nowline/export-pdf');
+            const pdf = await mod.exportPdf(stage.exportInputs, stage.svg, {
+                pageSize: args.pageSize,
+                orientation: parseOrientation(args.orientation),
+                marginPt: parseMargin(args.margin),
+                fonts,
+            });
+            return { rendered: pdf, isBinary: true };
+        }
+        if (args.format === 'xlsx') {
+            const mod = await import('@nowline/export-xlsx');
+            const xlsx = await mod.exportXlsx(stage.exportInputs, {
+                generated: args.today,
+            });
+            return { rendered: xlsx, isBinary: true };
+        }
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        const message = err instanceof Error ? err.message : String(err);
+        throw new CliError(ExitCode.OutputError, `nowline: ${args.format} export failed: ${message}`);
+    }
+    throw new CliError(ExitCode.InputError, `nowline: unsupported format "${args.format}".`);
+}
+async function produceJson(args) {
+    if (args.inputFormat === 'json') {
+        // Re-parse JSON → DSL → JSON to canonicalize through @nowline/core.
+        const { ast } = parseNowlineJson(args.contents, args.displayPath);
+        const text = printNowlineFile(ast);
+        const parsed = await parseAndValidate(text, args);
+        return JSON.stringify(serializeToJson(parsed.document, text), null, 2);
+    }
+    const parsed = await parseAndValidate(args.contents, args);
+    return JSON.stringify(serializeToJson(parsed.document, args.contents), null, 2);
+}
+async function produceCanonicalNowline(args) {
+    if (args.inputFormat === 'json') {
+        const { ast } = parseNowlineJson(args.contents, args.displayPath);
+        return printNowlineFile(ast);
+    }
+    const parsed = await parseAndValidate(args.contents, args);
+    const doc = serializeToJson(parsed.document, args.contents);
+    return printNowlineFile(doc.ast);
+}
+async function stageRoadmap(args) {
+    const parsed = await parseAndValidate(args.inputFormat === 'json'
+        ? jsonToNowlineText(args.contents, args.displayPath)
+        : args.contents, args);
+    const resolved = await resolveIncludes(parsed.ast, args.absInputPath, {
+        services: getServices().Nowline,
+    });
+    for (const diag of resolved.diagnostics) {
+        if (diag.severity === 'error') {
+            process.stderr.write(`${diag.sourcePath}: ${diag.message}\n`);
+        }
+    }
+    if (resolved.diagnostics.some((d) => d.severity === 'error')) {
+        throw new CliError(ExitCode.ValidationError, '');
+    }
+    const model = layoutRoadmap(parsed.ast, resolved, {
+        theme: args.theme,
+        today: args.today,
+        width: args.width,
+        locale: args.locale,
+    });
+    const assetRoot = args.assetRoot
+        ? path.resolve(args.assetRoot)
+        : path.dirname(args.absInputPath);
+    const resolver = createAssetResolver(assetRoot);
+    const warnings = [];
+    const svg = await renderSvg(model, {
+        assetResolver: resolver,
+        noLinks: args.noLinks,
+        strict: args.strict,
+        warn: (msg) => warnings.push(msg),
+    });
+    for (const w of warnings) {
+        process.stderr.write(`warning: ${w}\n`);
+    }
+    let cachedFonts;
+    const fontPair = async () => {
+        if (cachedFonts)
+            return cachedFonts;
+        const mod = await import('@nowline/export-core');
+        const result = await mod.resolveFonts({
+            fontSans: args.fontSans,
+            fontMono: args.fontMono,
+            headless: args.headless,
+        });
+        if (args.strict) {
+            if (result.sansFellBackToBundled) {
+                process.stderr.write('warning: sans font fell back to bundled DejaVu (no platform font found)\n');
+            }
+            if (result.monoFellBackToBundled) {
+                process.stderr.write('warning: mono font fell back to bundled DejaVu (no platform font found)\n');
+            }
+        }
+        cachedFonts = { sans: result.sans, mono: result.mono };
+        return cachedFonts;
+    };
+    return {
+        svg,
+        exportInputs: {
+            ast: parsed.ast,
+            resolved,
+            model,
+            sourcePath: args.displayPath,
+            today: args.today,
+        },
+        fontPair,
+    };
+}
+function jsonToNowlineText(contents, displayPath) {
+    const { ast } = parseNowlineJson(contents, displayPath);
+    return printNowlineFile(ast);
+}
+async function parseAndValidate(contents, args) {
+    const result = await parseSource(contents, args.displayPath, { validate: true });
+    if (result.hasErrors) {
+        emitDiagnostics(result.diagnostics, result.source, args.displayPath, args.operatorLocale);
+        throw new CliError(ExitCode.ValidationError, '');
+    }
+    if (args.verbose) {
+        const directive = readDirectiveLocale(result.ast);
+        const { tag, source } = describeContentLocaleSource(directive, args.resolvedLocale);
+        process.stderr.write(`nowline: locale=${tag} (${source})\n`);
+    }
+    return result;
+}
+async function loadConfigFor(inputArg, cwd) {
+    try {
+        if (inputArg === '-') {
+            const { config } = await loadConfig(cwd);
+            return config;
+        }
+        const abs = path.resolve(cwd, inputArg);
+        const dir = path.dirname(abs);
+        const { config } = await loadConfig(dir);
+        return config;
+    }
+    catch {
+        return null;
+    }
+}
+function parseTheme(raw) {
+    if (!raw)
+        return 'light';
+    const lower = raw.toLowerCase();
+    if (lower !== 'light' && lower !== 'dark') {
+        throw new CliError(ExitCode.InputError, `nowline: invalid --theme "${raw}". Expected light or dark.`);
+    }
+    return lower;
+}
+// Resolve the now-line date from the CLI flag.
+//
+// Precedence:
+//   1. `--now -`            → undefined  (suppresses the now-line)
+//   2. `--now <YYYY-MM-DD>` → that date
+//   3. flag omitted          → today (UTC calendar date)
+//
+// The "default to today" behavior matches what the tool's name promises —
+// you should see a "now" line by default. Use `--now -` to opt out (Unix
+// `-` sentinel, mirroring `-o -` for stdout), or `--now <date>` for
+// deterministic snapshots / planning a hypothetical date.
+function resolveNowArg(args) {
+    if (args.now === '-')
+        return undefined;
+    if (args.now) {
+        const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(args.now);
+        if (!m) {
+            throw new CliError(ExitCode.InputError, `nowline: invalid --now "${args.now}". Expected YYYY-MM-DD or "-".`);
+        }
+        return new Date(Date.UTC(parseInt(m[1], 10), parseInt(m[2], 10) - 1, parseInt(m[3], 10)));
+    }
+    const today = new Date();
+    return new Date(Date.UTC(today.getUTCFullYear(), today.getUTCMonth(), today.getUTCDate()));
+}
+function parseScale(raw) {
+    if (!raw)
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new CliError(ExitCode.InputError, `nowline: invalid --scale "${raw}". Must be a positive number.`);
+    }
+    return value;
+}
+function parseOrientation(raw) {
+    if (!raw)
+        return undefined;
+    const lower = raw.toLowerCase();
+    if (lower === 'portrait' || lower === 'landscape' || lower === 'auto')
+        return lower;
+    throw new CliError(ExitCode.InputError, `nowline: invalid --orientation "${raw}". Expected portrait, landscape, or auto.`);
+}
+function parseMargin(raw) {
+    if (!raw)
+        return undefined;
+    if (/^\d+(?:\.\d+)?$/.test(raw))
+        return Number(raw); // bare number → points
+    try {
+        return lengthToPoints(parseLength(raw));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new CliError(ExitCode.InputError, `nowline: invalid --margin "${raw}": ${message}`);
+    }
+}
+function stringFromConfig(config, key) {
+    if (!config)
+        return undefined;
+    const value = config[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function boolFromConfig(config, key) {
+    if (!config)
+        return false;
+    const value = config[key];
+    return value === true;
+}
+function parseWidthArg(raw) {
+    if (!raw)
+        return undefined;
+    const value = parseInt(raw, 10);
+    if (!Number.isFinite(value) || value < 320) {
+        throw new CliError(ExitCode.InputError, `nowline: invalid --width "${raw}". Must be an integer ≥ 320.`);
+    }
+    return value;
+}
+function emitDiagnostics(diagnostics, source, displayPath, operatorLocale) {
+    const sources = new Map([[displayPath, source]]);
+    const rendered = formatDiagnostics(diagnostics, 'text', sources, {
+        color: process.stderr.isTTY === true,
+        operatorLocale,
+    });
+    if (rendered)
+        process.stderr.write(`${rendered}\n`);
+}
+export function createAssetResolver(assetRoot) {
+    const root = path.resolve(assetRoot);
+    return async (ref) => {
+        const absPath = path.resolve(root, ref);
+        if (!absPath.startsWith(root + path.sep) && absPath !== root) {
+            throw new Error(`Asset ${ref} escapes asset-root ${assetRoot}`);
+        }
+        const bytes = await fs.readFile(absPath);
+        const mime = guessMime(absPath);
+        return { bytes: new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength), mime };
+    };
+}
+function guessMime(p) {
+    const ext = path.extname(p).toLowerCase();
+    if (ext === '.svg')
+        return 'image/svg+xml';
+    if (ext === '.png')
+        return 'image/png';
+    if (ext === '.jpg' || ext === '.jpeg')
+        return 'image/jpeg';
+    if (ext === '.webp')
+        return 'image/webp';
+    return 'application/octet-stream';
+}
+//# sourceMappingURL=render.js.map

package/dist/commands/render.js.map

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

package/dist/commands/serve.d.ts

@@ -0,0 +1,16 @@
+import type { ParsedArgs } from '../cli/args.js';
+export interface ServeHandlerOptions {
+    args: ParsedArgs;
+    /** Test seam: cwd override. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * `--serve` mode handler. Starts a local HTTP server that watches the input
+ * file and live-reloads the rendered SVG via Server-Sent Events.
+ *
+ * If `-o <path>` is provided, also writes the rendered SVG to that path on
+ * each successful rebuild. `-o -` (stdout) is rejected with exit 2 — serving
+ * to stdout is meaningless in this mode.
+ */
+export declare function serveHandler(options: ServeHandlerOptions): Promise<void>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAYjD,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0K9E"}