@nowline/cli 0.2.0

package/dist/cli/args.js

@@ -0,0 +1,165 @@
+import { parseArgs } from 'node:util';
+import { CliError, ExitCode } from '../io/exit-codes.js';
+/**
+ * Pure argument parser. Walks `argv` once, identifies mode flags, applies
+ * mutual-exclusivity rules, and returns a fully-resolved `ParsedArgs`. Throws
+ * `CliError(ExitCode.InputError)` for usage errors.
+ *
+ * Help / version short-circuit any other flag combinations.
+ */
+export function parseArgv(argv) {
+    if (argv.length === 0) {
+        return {
+            mode: 'help',
+            dryRun: false,
+            logLevel: 'normal',
+            noLinks: false,
+            strict: false,
+            open: false,
+            headless: false,
+        };
+    }
+    const config = {
+        args: argv,
+        allowPositionals: true,
+        strict: true,
+        options: {
+            help: { type: 'boolean', short: 'h' },
+            version: { type: 'boolean', short: 'V' },
+            verbose: { type: 'boolean', short: 'v' },
+            quiet: { type: 'boolean', short: 'q' },
+            output: { type: 'string', short: 'o' },
+            format: { type: 'string', short: 'f' },
+            'input-format': { type: 'string' },
+            serve: { type: 'boolean' },
+            init: { type: 'boolean' },
+            'dry-run': { type: 'boolean', short: 'n' },
+            theme: { type: 'string', short: 't' },
+            // `--now <date>` overrides the now-line position; without it, the
+            // CLI defaults to today's calendar date. Use `--now -` to
+            // suppress the now-line entirely (Unix-`-` sentinel; same idea
+            // as `-o -` for stdout).
+            now: { type: 'string' },
+            'no-links': { type: 'boolean' },
+            scale: { type: 'string', short: 's' },
+            strict: { type: 'boolean' },
+            width: { type: 'string', short: 'w' },
+            'asset-root': { type: 'string' },
+            port: { type: 'string', short: 'p' },
+            host: { type: 'string' },
+            open: { type: 'boolean' },
+            'diagnostic-format': { type: 'string' },
+            template: { type: 'string' },
+            // Format-specific (m2c)
+            'page-size': { type: 'string' },
+            orientation: { type: 'string' },
+            margin: { type: 'string' },
+            'font-sans': { type: 'string' },
+            'font-mono': { type: 'string' },
+            headless: { type: 'boolean' },
+            start: { type: 'string' },
+            // Localization (m-loc-b)
+            locale: { type: 'string' },
+        },
+    };
+    let parsed;
+    try {
+        parsed = parseArgs(config);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new CliError(ExitCode.InputError, formatUsageError(message));
+    }
+    const values = parsed.values;
+    const positionals = parsed.positionals;
+    if (values.help === true) {
+        return {
+            mode: 'help',
+            dryRun: false,
+            logLevel: 'normal',
+            noLinks: false,
+            strict: false,
+            open: false,
+            headless: false,
+        };
+    }
+    if (values.version === true) {
+        return {
+            mode: 'version',
+            dryRun: false,
+            logLevel: 'normal',
+            noLinks: false,
+            strict: false,
+            open: false,
+            headless: false,
+        };
+    }
+    if (values.verbose === true && values.quiet === true) {
+        throw new CliError(ExitCode.InputError, 'nowline: --verbose and --quiet are mutually exclusive.');
+    }
+    const modes = [];
+    if (values.serve === true)
+        modes.push('serve');
+    if (values.init === true)
+        modes.push('init');
+    if (modes.length > 1) {
+        throw new CliError(ExitCode.InputError, `nowline: --${modes[0]} and --${modes[1]} are mutually exclusive.`);
+    }
+    const dryRun = values['dry-run'] === true;
+    const mode = modes[0] ?? 'render';
+    if (dryRun && (mode === 'serve' || mode === 'init')) {
+        throw new CliError(ExitCode.InputError, `nowline: --dry-run cannot be combined with --${mode}.`);
+    }
+    if (positionals.length > 1) {
+        const extras = positionals
+            .slice(1)
+            .map((p) => JSON.stringify(p))
+            .join(' ');
+        throw new CliError(ExitCode.InputError, `nowline: unexpected extra arguments: ${extras}.`);
+    }
+    const logLevel = values.verbose === true ? 'verbose' : values.quiet === true ? 'quiet' : 'normal';
+    return {
+        mode,
+        positional: positionals[0],
+        dryRun,
+        logLevel,
+        output: stringOrUndefined(values.output),
+        format: stringOrUndefined(values.format),
+        inputFormat: stringOrUndefined(values['input-format']),
+        theme: stringOrUndefined(values.theme),
+        now: stringOrUndefined(values.now),
+        noLinks: values['no-links'] === true,
+        scale: stringOrUndefined(values.scale),
+        strict: values.strict === true,
+        width: stringOrUndefined(values.width),
+        assetRoot: stringOrUndefined(values['asset-root']),
+        port: stringOrUndefined(values.port),
+        host: stringOrUndefined(values.host),
+        open: values.open === true,
+        diagnosticFormat: stringOrUndefined(values['diagnostic-format']),
+        template: stringOrUndefined(values.template),
+        pageSize: stringOrUndefined(values['page-size']),
+        orientation: stringOrUndefined(values.orientation),
+        margin: stringOrUndefined(values.margin),
+        fontSans: stringOrUndefined(values['font-sans']),
+        fontMono: stringOrUndefined(values['font-mono']),
+        headless: values.headless === true,
+        start: stringOrUndefined(values.start),
+        locale: stringOrUndefined(values.locale),
+    };
+}
+function stringOrUndefined(value) {
+    if (typeof value === 'string')
+        return value;
+    return undefined;
+}
+function formatUsageError(message) {
+    if (message.startsWith('Unknown option')) {
+        return `nowline: ${message}. Try --help for usage.`;
+    }
+    if (message.includes('expected')) {
+        return `nowline: ${message}. Try --help for usage.`;
+    }
+    return `nowline: ${message}`;
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

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

package/dist/cli/formats.d.ts

@@ -0,0 +1,61 @@
+export type OutputFormat = 'svg' | 'png' | 'pdf' | 'html' | 'mermaid' | 'xlsx' | 'msproj' | 'json' | 'nowline';
+export type InputFormat = 'nowline' | 'json';
+export declare const ALL_OUTPUT_FORMATS: readonly OutputFormat[];
+export declare function isOutputFormat(value: string): value is OutputFormat;
+export declare function normalizeFormatAlias(raw: string): string;
+export declare function isInputFormat(value: string): value is InputFormat;
+export declare function isBinaryFormat(format: OutputFormat): boolean;
+export declare function isTextFormat(format: OutputFormat): boolean;
+/**
+ * Maps a recognized output extension to its canonical format.
+ *
+ * `.xml` is intentionally absent — it is ambiguous (MS Project XML vs generic
+ * XML) and requires `-f msproj` to disambiguate.
+ */
+export declare function formatFromExtension(extension: string): OutputFormat | undefined;
+export declare function canonicalExtension(format: OutputFormat): string;
+export interface FormatResolutionInputs {
+    /** `-f / --format` flag value (already lower-cased). */
+    flagFormat?: string;
+    /** `-o / --output` path; the literal string the user wrote. */
+    outputPath?: string;
+    /** `defaultFormat` from `.nowlinerc`. */
+    configFormat?: string;
+    /** True when output is `-` (stdout); skips extension inference. */
+    isStdout?: boolean;
+}
+export interface FormatResolution {
+    format: OutputFormat;
+    /** Where the format came from. Useful for `-v` diagnostics. */
+    source: 'flag' | 'output-extension' | 'config' | 'fallback';
+}
+/**
+ * Resolves the output format using the documented precedence chain:
+ *
+ *   1. `-f / --format` flag
+ *   2. `-o <path>` recognized extension (skipped for `-` / stdout)
+ *   3. `.nowlinerc` `defaultFormat`
+ *   4. Built-in fallback `svg`
+ *
+ * Returns the resolved format and the precedence step that produced it. May
+ * throw a `FormatResolutionError` for unsupported / ambiguous inputs (caller
+ * is expected to surface this as an exit-2 usage error).
+ */
+export declare function resolveFormat(inputs: FormatResolutionInputs): FormatResolution;
+/**
+ * Applies the documented output-extension auto-add rule:
+ *
+ * - If `<path>` ends in no extension, append the canonical extension for the
+ *   resolved format (`-o report -f pdf` → `report.pdf`).
+ * - If `<path>` ends in the canonical extension for the resolved format, leave
+ *   it alone.
+ * - If `<path>` ends in any *other* extension, leave it alone (no auto-rename).
+ *   The user wrote literal bytes; we trust them.
+ *
+ * Stdout (`-`) is never rewritten; callers should bypass this helper for stdout.
+ */
+export declare function autoAddExtension(outputPath: string, format: OutputFormat): string;
+export declare class FormatResolutionError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=formats.d.ts.map

package/dist/cli/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/cli/formats.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAClB,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,SAAS,GACT,MAAM,GACN,QAAQ,GACR,MAAM,GACN,SAAS,CAAC;AAEhB,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAa7C,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAUrD,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE;AAiBD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE5D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE1D;AA2BD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE/E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE/D;AAED,MAAM,WAAW,sBAAsB;IACnC,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,QAAQ,GAAG,UAAU,CAAC;CAC/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,CAqC9E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAMjF;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI9B"}

package/dist/cli/formats.js

@@ -0,0 +1,153 @@
+import * as path from 'node:path';
+const TEXT_FORMATS = new Set([
+    'svg',
+    'html',
+    'mermaid',
+    'msproj',
+    'json',
+    'nowline',
+]);
+const BINARY_FORMATS = new Set(['png', 'pdf', 'xlsx']);
+export const ALL_OUTPUT_FORMATS = [
+    'svg',
+    'png',
+    'pdf',
+    'html',
+    'mermaid',
+    'xlsx',
+    'msproj',
+    'json',
+    'nowline',
+];
+export function isOutputFormat(value) {
+    return ALL_OUTPUT_FORMATS.includes(value);
+}
+/**
+ * User-facing format aliases. The canonical token is `msproj` (matches the
+ * package name `@nowline/export-msproj`); `ms-project` and `mspx` are
+ * accepted shorthands documented in `specs/handoffs/m2c.md` § 8.
+ */
+const FORMAT_ALIASES = {
+    'ms-project': 'msproj',
+    msproject: 'msproj',
+    mspx: 'msproj',
+    md: 'mermaid',
+    markdown: 'mermaid',
+    excel: 'xlsx',
+    'ms-excel': 'xlsx',
+};
+export function normalizeFormatAlias(raw) {
+    const lower = raw.toLowerCase();
+    return FORMAT_ALIASES[lower] ?? lower;
+}
+export function isInputFormat(value) {
+    return value === 'nowline' || value === 'json';
+}
+export function isBinaryFormat(format) {
+    return BINARY_FORMATS.has(format);
+}
+export function isTextFormat(format) {
+    return TEXT_FORMATS.has(format);
+}
+const EXTENSION_MAP = new Map([
+    ['.svg', 'svg'],
+    ['.png', 'png'],
+    ['.pdf', 'pdf'],
+    ['.html', 'html'],
+    ['.htm', 'html'],
+    ['.md', 'mermaid'],
+    ['.markdown', 'mermaid'],
+    ['.xlsx', 'xlsx'],
+    ['.json', 'json'],
+    ['.nowline', 'nowline'],
+]);
+const CANONICAL_EXTENSION = {
+    svg: '.svg',
+    png: '.png',
+    pdf: '.pdf',
+    html: '.html',
+    mermaid: '.md',
+    xlsx: '.xlsx',
+    msproj: '.xml',
+    json: '.json',
+    nowline: '.nowline',
+};
+/**
+ * Maps a recognized output extension to its canonical format.
+ *
+ * `.xml` is intentionally absent — it is ambiguous (MS Project XML vs generic
+ * XML) and requires `-f msproj` to disambiguate.
+ */
+export function formatFromExtension(extension) {
+    return EXTENSION_MAP.get(extension.toLowerCase());
+}
+export function canonicalExtension(format) {
+    return CANONICAL_EXTENSION[format];
+}
+/**
+ * Resolves the output format using the documented precedence chain:
+ *
+ *   1. `-f / --format` flag
+ *   2. `-o <path>` recognized extension (skipped for `-` / stdout)
+ *   3. `.nowlinerc` `defaultFormat`
+ *   4. Built-in fallback `svg`
+ *
+ * Returns the resolved format and the precedence step that produced it. May
+ * throw a `FormatResolutionError` for unsupported / ambiguous inputs (caller
+ * is expected to surface this as an exit-2 usage error).
+ */
+export function resolveFormat(inputs) {
+    if (inputs.flagFormat) {
+        const flag = normalizeFormatAlias(inputs.flagFormat);
+        if (!isOutputFormat(flag)) {
+            throw new FormatResolutionError(`Unknown --format "${inputs.flagFormat}". Expected one of: ${ALL_OUTPUT_FORMATS.join(', ')}.`);
+        }
+        return { format: flag, source: 'flag' };
+    }
+    if (!inputs.isStdout && inputs.outputPath) {
+        const ext = path.extname(inputs.outputPath);
+        if (ext) {
+            if (ext.toLowerCase() === '.xml') {
+                throw new FormatResolutionError('Cannot infer format from .xml extension; use -f msproj for MS Project XML output.');
+            }
+            const inferred = formatFromExtension(ext);
+            if (inferred) {
+                return { format: inferred, source: 'output-extension' };
+            }
+        }
+    }
+    if (inputs.configFormat) {
+        const cfg = normalizeFormatAlias(inputs.configFormat);
+        if (!isOutputFormat(cfg)) {
+            throw new FormatResolutionError(`Invalid .nowlinerc defaultFormat "${inputs.configFormat}". Expected one of: ${ALL_OUTPUT_FORMATS.join(', ')}.`);
+        }
+        return { format: cfg, source: 'config' };
+    }
+    return { format: 'svg', source: 'fallback' };
+}
+/**
+ * Applies the documented output-extension auto-add rule:
+ *
+ * - If `<path>` ends in no extension, append the canonical extension for the
+ *   resolved format (`-o report -f pdf` → `report.pdf`).
+ * - If `<path>` ends in the canonical extension for the resolved format, leave
+ *   it alone.
+ * - If `<path>` ends in any *other* extension, leave it alone (no auto-rename).
+ *   The user wrote literal bytes; we trust them.
+ *
+ * Stdout (`-`) is never rewritten; callers should bypass this helper for stdout.
+ */
+export function autoAddExtension(outputPath, format) {
+    const ext = path.extname(outputPath);
+    if (!ext) {
+        return outputPath + canonicalExtension(format);
+    }
+    return outputPath;
+}
+export class FormatResolutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FormatResolutionError';
+    }
+}
+//# sourceMappingURL=formats.js.map

package/dist/cli/formats.js.map

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

package/dist/cli/help.d.ts

@@ -0,0 +1,3 @@
+export declare function renderHelp(): string;
+export declare function renderVersion(): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAqFA,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/cli/help.js

@@ -0,0 +1,90 @@
+import { fullVersionString } from '../version.js';
+// Use the dev-aware string here too: a contributor running `pnpm dev`
+// against a feature branch should see e.g. `0.1.0+abc1234.dirty` in
+// `--help` so it's obvious which build they're looking at.
+const HELP_TEXT = `nowline ${fullVersionString()} — render, validate, and serve .nowline roadmaps.
+
+USAGE
+  nowline <input> [options]
+  nowline --serve <input> [options]
+  nowline --init [<name>]
+  nowline --version
+  nowline --help
+
+INPUT
+  <input>                 Path to .nowline or .json, or '-' for stdin.
+                          Required for render, --serve, and --dry-run.
+
+I/O OPTIONS
+  -f, --format <fmt>      Output format: svg, png, pdf, html, mermaid, xlsx,
+                          msproj, json, nowline. Default: inferred from -o
+                          extension, else .nowlinerc 'defaultFormat', else svg.
+  -o, --output <path>     Output file path. Use '-' for stdout (Unix dash).
+                          Default: <cwd>/<input-base>.<format>.
+                          Existing files are silently overwritten.
+      --input-format <f>  Force input format: nowline | json. Default: by
+                          extension; stdin defaults to nowline.
+
+MODE FLAGS (mutually exclusive)
+      --serve             Live HTTP preview server. -o opt-in writes the
+                          rendered output to disk on each rebuild.
+      --init [<name>]     Scaffold a starter .nowline file in cwd. Positional
+                          becomes project name; .nowline appended if missing.
+  -n, --dry-run           Run the full pipeline (parse + validate + layout +
+                          format) but skip the write step. Subsumes the old
+                          'validate' verb. Exit 0 on success, 1 on errors.
+
+RENDER OPTIONS
+  -t, --theme <name>      light | dark
+      --now <YYYY-MM-DD>  Date for the now-line. Default: today.
+                          Use --now - to suppress the now-line.
+      --no-links          Omit link icons from rendered items.
+  -s, --scale <n>         Raster scale factor (PNG only; default 1).
+      --strict            Promote asset / sanitizer warnings to errors.
+  -w, --width <px>        Canvas width in pixels (default: 1280).
+      --asset-root <dir>  Root for logo / image assets (default: input dir).
+      --locale <bcp47>    BCP-47 locale (e.g. fr, fr-CA) for CLI message
+                          output (validator diagnostics, --help, errors).
+                          Used as a fallback for the rendered drawing only
+                          when the file does not declare its own
+                          'nowline v1 locale:' directive — the file always
+                          wins for content. Falls back to LC_ALL /
+                          LC_MESSAGES / LANG, then en-US.
+
+SERVE OPTIONS
+  -p, --port <n>          Port (default: 4318).
+      --host <host>       Bind address (default: 127.0.0.1).
+      --open              Open the browser on start.
+
+LOGGING (mutually exclusive)
+  -v, --verbose           Print extra diagnostics to stderr.
+  -q, --quiet             Suppress non-error stderr.
+
+STANDARD
+  -h, --help              Print this help and exit 0.
+  -V, --version           Print version and exit 0.
+
+EXAMPLES
+  nowline roadmap.nowline                   # writes ./roadmap.svg
+  nowline roadmap.nowline -f pdf            # writes ./roadmap.pdf
+  nowline roadmap.nowline -o roadmap.pdf    # format inferred from extension
+  nowline roadmap.nowline -o -              # SVG to stdout
+  cat foo.nowline | nowline -               # stdin → ./roadmap.svg
+  nowline roadmap.nowline -f json -o -      # JSON AST to stdout
+  nowline roadmap.nowline --dry-run         # validate-only
+  nowline roadmap.nowline --serve -p 8080   # live preview
+  nowline --init my-project                 # scaffold ./my-project.nowline
+
+EXIT CODES
+  0  Success
+  1  Validation error
+  2  Usage error (missing input, bad flags, format unavailable)
+  3  Output error (cannot write to destination)
+`;
+export function renderHelp() {
+    return HELP_TEXT;
+}
+export function renderVersion() {
+    return `${fullVersionString()}\n`;
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,sEAAsE;AACtE,oEAAoE;AACpE,2DAA2D;AAC3D,MAAM,SAAS,GAAG,WAAW,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8E/C,CAAC;AAEF,MAAM,UAAU,UAAU;IACtB,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,aAAa;IACzB,OAAO,GAAG,iBAAiB,EAAE,IAAI,CAAC;AACtC,CAAC"}

package/dist/cli/output-path.d.ts

@@ -0,0 +1,57 @@
+import { type OutputFormat } from './formats.js';
+export interface DefaultOutputInputs {
+    /** Original input argument: file path or `-` for stdin. */
+    inputArg: string;
+    /** True when input is `-` (stdin). */
+    isStdin: boolean;
+    /** Resolved output format. */
+    format: OutputFormat;
+    /** Current working directory; defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * Resolves the default output path for render operations when `-o` is absent.
+ *
+ * Rules:
+ * - Default-named outputs land in **cwd**, never next to the input.
+ * - File input: `<cwd>/<input-base>.<format>` (input directory is ignored).
+ * - Stdin input: `<cwd>/roadmap.<format>`.
+ */
+export declare function defaultRenderOutputPath(inputs: DefaultOutputInputs): string;
+export interface InitOutputInputs {
+    /** Positional argument from `--init` (project name); undefined → default `roadmap`. */
+    name?: string;
+    /** Current working directory; defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * Resolves the output path for `--init`. The positional is treated as a project
+ * *name*, not a file path:
+ *
+ *  - No extension (`my-project`) → append `.nowline`.
+ *  - Already `.nowline` → use literal.
+ *  - Other extension → caller should reject as a usage error (exit 2).
+ *  - Missing → default name `roadmap`.
+ */
+export declare function defaultInitOutputPath(inputs: InitOutputInputs): string;
+/**
+ * Returns true when an `--init` positional has an extension other than
+ * `.nowline`. Caller should reject this with an exit-2 usage error.
+ */
+export declare function initNameHasIncompatibleExtension(name: string): boolean;
+/**
+ * Resolves the final output path for render operations, applying the
+ * extension-auto-add rule when `-o` is provided and has no extension.
+ */
+export declare function resolveRenderOutputPath(args: {
+    outputArg: string | undefined;
+    isStdout: boolean;
+    inputArg: string;
+    isStdin: boolean;
+    format: OutputFormat;
+    cwd?: string;
+}): {
+    path: string;
+    isStdout: boolean;
+};
+//# sourceMappingURL=output-path.d.ts.map

package/dist/cli/output-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-path.d.ts","sourceRoot":"","sources":["../../src/cli/output-path.ts"],"names":[],"mappings":"AACA,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEvF,MAAM,WAAW,mBAAmB;IAChC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAQ3E;AAED,MAAM,WAAW,gBAAgB;IAC7B,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAQtE;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC1C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAmBtC"}

package/dist/cli/output-path.js

@@ -0,0 +1,70 @@
+import * as path from 'node:path';
+import { autoAddExtension, canonicalExtension } from './formats.js';
+/**
+ * Resolves the default output path for render operations when `-o` is absent.
+ *
+ * Rules:
+ * - Default-named outputs land in **cwd**, never next to the input.
+ * - File input: `<cwd>/<input-base>.<format>` (input directory is ignored).
+ * - Stdin input: `<cwd>/roadmap.<format>`.
+ */
+export function defaultRenderOutputPath(inputs) {
+    const cwd = inputs.cwd ?? process.cwd();
+    const ext = canonicalExtension(inputs.format);
+    if (inputs.isStdin) {
+        return path.join(cwd, `roadmap${ext}`);
+    }
+    const base = path.basename(inputs.inputArg, path.extname(inputs.inputArg)) || 'roadmap';
+    return path.join(cwd, `${base}${ext}`);
+}
+/**
+ * Resolves the output path for `--init`. The positional is treated as a project
+ * *name*, not a file path:
+ *
+ *  - No extension (`my-project`) → append `.nowline`.
+ *  - Already `.nowline` → use literal.
+ *  - Other extension → caller should reject as a usage error (exit 2).
+ *  - Missing → default name `roadmap`.
+ */
+export function defaultInitOutputPath(inputs) {
+    const cwd = inputs.cwd ?? process.cwd();
+    const name = inputs.name ?? 'roadmap';
+    const ext = path.extname(name);
+    if (!ext) {
+        return path.join(cwd, `${name}.nowline`);
+    }
+    return path.join(cwd, name);
+}
+/**
+ * Returns true when an `--init` positional has an extension other than
+ * `.nowline`. Caller should reject this with an exit-2 usage error.
+ */
+export function initNameHasIncompatibleExtension(name) {
+    const ext = path.extname(name).toLowerCase();
+    return ext !== '' && ext !== '.nowline';
+}
+/**
+ * Resolves the final output path for render operations, applying the
+ * extension-auto-add rule when `-o` is provided and has no extension.
+ */
+export function resolveRenderOutputPath(args) {
+    if (args.isStdout) {
+        return { path: '-', isStdout: true };
+    }
+    if (args.outputArg !== undefined) {
+        return {
+            path: autoAddExtension(args.outputArg, args.format),
+            isStdout: false,
+        };
+    }
+    return {
+        path: defaultRenderOutputPath({
+            inputArg: args.inputArg,
+            isStdin: args.isStdin,
+            format: args.format,
+            cwd: args.cwd,
+        }),
+        isStdout: false,
+    };
+}
+//# sourceMappingURL=output-path.js.map

package/dist/cli/output-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-path.js","sourceRoot":"","sources":["../../src/cli/output-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC;AAavF;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA2B;IAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxC,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,SAAS,CAAC;IACxF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;AAC3C,CAAC;AASD;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAwB;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,UAAU,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,IAAY;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,UAAU,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAOvC;IACG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;YACH,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;YACnD,QAAQ,EAAE,KAAK;SAClB,CAAC;IACN,CAAC;IACD,OAAO;QACH,IAAI,EAAE,uBAAuB,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG;SAChB,CAAC;QACF,QAAQ,EAAE,KAAK;KAClB,CAAC;AACN,CAAC"}