@nowline/cli 0.2.0

package/dist/diagnostics/adapt.js

@@ -0,0 +1,109 @@
+export function adaptLangiumDiagnostic(diag, file) {
+    const severity = mapSeverity(diag.severity);
+    const line = (diag.range?.start.line ?? 0) + 1;
+    const column = (diag.range?.start.character ?? 0) + 1;
+    const data = extractMessageData(diag.data);
+    return {
+        file,
+        line,
+        column,
+        severity,
+        // Localized validator data carries the stable message code; prefer it
+        // over the heuristic message-substring inference below.
+        code: data?.code ?? diagnosticCode(diag),
+        message: diag.message,
+        span: diag.range
+            ? {
+                start: { line, column },
+                end: {
+                    line: (diag.range.end.line ?? 0) + 1,
+                    column: (diag.range.end.character ?? 0) + 1,
+                },
+            }
+            : undefined,
+        suggestion: extractSuggestion(diag.message),
+        data,
+    };
+}
+/**
+ * Validate the shape of `diag.data`. Validator-emitted diagnostics
+ * stash `{ code: MessageCode, args: MessageArgs<K> }` (where `args` is
+ * the spread tuple `[]` or `[{...}]`). Anything else (vscode code
+ * actions, third-party data, etc.) is ignored.
+ */
+function extractMessageData(data) {
+    if (!data || typeof data !== 'object')
+        return undefined;
+    const obj = data;
+    if (typeof obj.code !== 'string')
+        return undefined;
+    if (!Array.isArray(obj.args))
+        return undefined;
+    return { code: obj.code, args: obj.args };
+}
+export function adaptParserError(err, file) {
+    const line = err.token?.startLine ?? 1;
+    const column = err.token?.startColumn ?? 1;
+    const endLine = err.token?.endLine ?? line;
+    const endColumn = (err.token?.endColumn ?? column) + 1;
+    return {
+        file,
+        line,
+        column,
+        severity: 'error',
+        code: 'parse-error',
+        message: err.message,
+        span: { start: { line, column }, end: { line: endLine, column: endColumn } },
+    };
+}
+export function adaptLexerError(err, file) {
+    const line = err.line ?? 1;
+    const column = err.column ?? 1;
+    const length = err.length ?? 1;
+    return {
+        file,
+        line,
+        column,
+        severity: 'error',
+        code: 'lex-error',
+        message: err.message,
+        span: {
+            start: { line, column },
+            end: { line, column: column + Math.max(length, 1) },
+        },
+    };
+}
+function mapSeverity(severity) {
+    return severity === 2 ? 'warning' : 'error';
+}
+function diagnosticCode(diag) {
+    if (typeof diag.code === 'string' && diag.code !== '')
+        return diag.code;
+    if (typeof diag.code === 'number')
+        return String(diag.code);
+    return inferCodeFromMessage(diag.message);
+}
+function inferCodeFromMessage(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes('duplicate identifier'))
+        return 'duplicate-identifier';
+    if (lower.includes('unknown reference') || lower.includes('did you mean'))
+        return 'unknown-reference';
+    if (lower.includes('circular'))
+        return 'circular-dependency';
+    if (lower.includes('requires') && lower.includes('date:'))
+        return 'missing-date';
+    if (lower.includes('duration'))
+        return 'duration';
+    if (lower.includes('include'))
+        return 'include';
+    if (lower.includes('indent'))
+        return 'indentation';
+    return 'validation';
+}
+const DID_YOU_MEAN_RE = /did you mean ['"]?([^'"?]+)['"]?\??/i;
+function extractSuggestion(message) {
+    const match = message.match(DID_YOU_MEAN_RE);
+    return match ? match[1].trim() : undefined;
+}
+//# sourceMappingURL=adapt.js.map

package/dist/diagnostics/adapt.js.map

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

package/dist/diagnostics/format.d.ts

@@ -0,0 +1,18 @@
+import type { CliDiagnostic, DiagnosticSource } from './model.js';
+export type DiagnosticFormat = 'text' | 'json';
+export interface FormatDiagnosticsOptions {
+    color?: boolean;
+    /**
+     * Operator locale (BCP-47) used to re-format validator messages
+     * that carry `data: { code, args }`. Validator messages without
+     * `data` and parser/lexer errors pass through unchanged.
+     *
+     * Defaults to en-US: an unset operator locale produces the same
+     * canonical English text the validator stashed at parse time.
+     * See `specs/localization.md` for the two-chain model.
+     */
+    operatorLocale?: string;
+}
+export declare function isDiagnosticFormat(value: unknown): value is DiagnosticFormat;
+export declare function formatDiagnostics(diagnostics: CliDiagnostic[], format: DiagnosticFormat, sources: Map<string, DiagnosticSource>, options?: FormatDiagnosticsOptions): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/diagnostics/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/diagnostics/format.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGlE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,wBAAwB;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,wBAAgB,iBAAiB,CAC7B,WAAW,EAAE,aAAa,EAAE,EAC5B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACtC,OAAO,GAAE,wBAA6B,GACvC,MAAM,CAIR"}

package/dist/diagnostics/format.js

@@ -0,0 +1,41 @@
+import { tr } from '@nowline/core';
+import { renderJson } from './json.js';
+import { renderText } from './text.js';
+export function isDiagnosticFormat(value) {
+    return value === 'text' || value === 'json';
+}
+export function formatDiagnostics(diagnostics, format, sources, options = {}) {
+    const localized = relocalizeDiagnostics(diagnostics, options.operatorLocale);
+    if (format === 'json')
+        return renderJson(localized);
+    return renderText(localized, sources, { color: options.color });
+}
+/**
+ * Re-format any diagnostic carrying `data.{code,args}` in the operator
+ * locale. Diagnostics without `data` (literal-English validator
+ * strings, parser/lexer errors, include-resolution errors) pass
+ * through verbatim.
+ *
+ * No-op when `operatorLocale` is undefined or `'en-US'`: the messages
+ * stashed by the validator are already en-US, so we avoid the work
+ * and the allocation in the common case.
+ */
+function relocalizeDiagnostics(diagnostics, operatorLocale) {
+    if (!operatorLocale || operatorLocale === 'en-US')
+        return diagnostics;
+    return diagnostics.map((d) => {
+        if (!d.data)
+            return d;
+        // The validator stashes args as the verbatim spread tuple it received,
+        // typed strongly per-code in `@nowline/core/i18n`. By the time it
+        // reaches us through `unknown` it has lost that tagged shape; we cast
+        // back here because the only producer is the validator and the
+        // `code` half of the pair pins the expected arity.
+        const args = d.data.args;
+        const message = tr(operatorLocale, d.data.code, ...args);
+        if (message === d.message)
+            return d;
+        return { ...d, message };
+    });
+}
+//# sourceMappingURL=format.js.map

package/dist/diagnostics/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/diagnostics/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,EAAE,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAkBvC,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC7C,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC7B,WAA4B,EAC5B,MAAwB,EACxB,OAAsC,EACtC,UAAoC,EAAE;IAEtC,MAAM,SAAS,GAAG,qBAAqB,CAAC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7E,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,qBAAqB,CAC1B,WAA4B,EAC5B,cAAkC;IAElC,IAAI,CAAC,cAAc,IAAI,cAAc,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC;IACtE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC;QACtB,uEAAuE;QACvE,kEAAkE;QAClE,sEAAsE;QACtE,+DAA+D;QAC/D,mDAAmD;QACnD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAMT,CAAC;QACZ,MAAM,OAAO,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,IAAmB,EAAE,GAAG,IAAI,CAAC,CAAC;QACxE,IAAI,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC;QACpC,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/diagnostics/index.d.ts

@@ -0,0 +1,5 @@
+export * from './adapt.js';
+export * from './format.js';
+export { DIAGNOSTICS_SCHEMA_VERSION, type DiagnosticsDocument } from './json.js';
+export * from './model.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/diagnostics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diagnostics/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,0BAA0B,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACjF,cAAc,YAAY,CAAC"}

package/dist/diagnostics/index.js

@@ -0,0 +1,5 @@
+export * from './adapt.js';
+export * from './format.js';
+export { DIAGNOSTICS_SCHEMA_VERSION } from './json.js';
+export * from './model.js';
+//# sourceMappingURL=index.js.map

package/dist/diagnostics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/diagnostics/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,0BAA0B,EAA4B,MAAM,WAAW,CAAC;AACjF,cAAc,YAAY,CAAC"}

package/dist/diagnostics/json.d.ts

@@ -0,0 +1,8 @@
+import type { CliDiagnostic } from './model.js';
+export declare const DIAGNOSTICS_SCHEMA_VERSION = "1";
+export interface DiagnosticsDocument {
+    $nowlineDiagnostics: string;
+    diagnostics: CliDiagnostic[];
+}
+export declare function renderJson(diagnostics: CliDiagnostic[]): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/diagnostics/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/diagnostics/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,aAAa,EAAE,CAAC;CAChC;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,aAAa,EAAE,GAAG,MAAM,CAM/D"}

package/dist/diagnostics/json.js

@@ -0,0 +1,24 @@
+export const DIAGNOSTICS_SCHEMA_VERSION = '1';
+export function renderJson(diagnostics) {
+    const doc = {
+        $nowlineDiagnostics: DIAGNOSTICS_SCHEMA_VERSION,
+        diagnostics: diagnostics.map(normalize),
+    };
+    return JSON.stringify(doc, null, 2);
+}
+function normalize(d) {
+    const out = {
+        file: d.file,
+        line: d.line,
+        column: d.column,
+        severity: d.severity,
+        code: d.code,
+        message: d.message,
+    };
+    if (d.suggestion)
+        out.suggestion = d.suggestion;
+    if (d.span)
+        out.span = d.span;
+    return out;
+}
+//# sourceMappingURL=json.js.map

package/dist/diagnostics/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/diagnostics/json.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAO9C,MAAM,UAAU,UAAU,CAAC,WAA4B;IACnD,MAAM,GAAG,GAAwB;QAC7B,mBAAmB,EAAE,0BAA0B;QAC/C,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC;KAC1C,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,SAAS,CAAC,CAAgB;IAC/B,MAAM,GAAG,GAAkB;QACvB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;KACrB,CAAC;IACF,IAAI,CAAC,CAAC,UAAU;QAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;IAChD,IAAI,CAAC,CAAC,IAAI;QAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IAC9B,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/diagnostics/model.d.ts

@@ -0,0 +1,44 @@
+export type DiagnosticSeverity = 'error' | 'warning';
+export interface SourcePosition {
+    line: number;
+    column: number;
+    offset?: number;
+}
+export interface SourceSpan {
+    start: SourcePosition;
+    end: SourcePosition;
+}
+/**
+ * Carries the validator's stable message code plus the named-argument
+ * record it was formatted from, so the CLI can re-format the human
+ * message in the operator's locale at print time. See
+ * `specs/localization.md` for the two-chain precedence model.
+ */
+export interface LocalizedMessageData {
+    code: string;
+    args: ReadonlyArray<unknown>;
+}
+export interface CliDiagnostic {
+    file: string;
+    line: number;
+    column: number;
+    severity: DiagnosticSeverity;
+    code: string;
+    message: string;
+    suggestion?: string;
+    span?: SourceSpan;
+    /**
+     * Stable code + args as captured by the validator. Present on
+     * messages that flow through the `tr()` registry; absent for
+     * literal-English validator strings, parser/lexer errors, and
+     * include-resolution diagnostics. The CLI re-formats `message`
+     * from this when an operator locale is supplied to
+     * `formatDiagnostics`.
+     */
+    data?: LocalizedMessageData;
+}
+export interface DiagnosticSource {
+    file: string;
+    contents: string;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/diagnostics/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/diagnostics/model.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,cAAc,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB"}

package/dist/diagnostics/model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model.js.map

package/dist/diagnostics/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/diagnostics/model.ts"],"names":[],"mappings":""}

package/dist/diagnostics/text.d.ts

@@ -0,0 +1,6 @@
+import type { CliDiagnostic, DiagnosticSource } from './model.js';
+export interface RenderTextOptions {
+    color?: boolean;
+}
+export declare function renderText(diagnostics: CliDiagnostic[], sources: Map<string, DiagnosticSource>, options?: RenderTextOptions): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/diagnostics/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/diagnostics/text.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,UAAU,CACtB,WAAW,EAAE,aAAa,EAAE,EAC5B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACtC,OAAO,GAAE,iBAAsB,GAChC,MAAM,CAIR"}

package/dist/diagnostics/text.js

@@ -0,0 +1,43 @@
+import { codeFrameColumns } from '@babel/code-frame';
+import chalk from 'chalk';
+export function renderText(diagnostics, sources, options = {}) {
+    const useColor = options.color ?? chalk.level > 0;
+    const parts = diagnostics.map((d) => renderOne(d, sources.get(d.file), useColor));
+    return parts.join('\n\n');
+}
+function renderOne(diag, source, useColor) {
+    const header = renderHeader(diag, useColor);
+    if (!source)
+        return header;
+    const frame = codeFrameColumns(source.contents, {
+        start: { line: diag.line, column: diag.column },
+        end: diag.span ? { line: diag.span.end.line, column: diag.span.end.column } : undefined,
+    }, {
+        highlightCode: useColor,
+        linesAbove: 2,
+        linesBelow: 1,
+        forceColor: useColor,
+    });
+    return `${header}\n${frame}`;
+}
+function renderHeader(diag, useColor) {
+    const loc = `${diag.file}:${diag.line}:${diag.column}`;
+    const severityWord = diag.severity === 'error' ? 'error' : 'warning';
+    if (!useColor) {
+        const suffix = diag.suggestion ? ` — did you mean '${diag.suggestion}'?` : '';
+        return `${loc} ${severityWord}: ${stripSuggestion(diag.message, diag.suggestion)}${suffix}`;
+    }
+    const coloredLoc = chalk.cyan(loc);
+    const coloredSeverity = diag.severity === 'error' ? chalk.red.bold(severityWord) : chalk.yellow.bold(severityWord);
+    const message = stripSuggestion(diag.message, diag.suggestion);
+    const suggestion = diag.suggestion
+        ? ` ${chalk.dim('—')} did you mean ${chalk.green(`'${diag.suggestion}'`)}?`
+        : '';
+    return `${coloredLoc} ${coloredSeverity}: ${message}${suggestion}`;
+}
+function stripSuggestion(message, suggestion) {
+    if (!suggestion)
+        return message;
+    return message.replace(/ —\s*did you mean ['"]?[^'"?]+['"]?\??/i, '').trimEnd();
+}
+//# sourceMappingURL=text.js.map

package/dist/diagnostics/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/diagnostics/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,MAAM,UAAU,UAAU,CACtB,WAA4B,EAC5B,OAAsC,EACtC,UAA6B,EAAE;IAE/B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,SAAS,CACd,IAAmB,EACnB,MAAoC,EACpC,QAAiB;IAEjB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAC3B,MAAM,KAAK,GAAG,gBAAgB,CAC1B,MAAM,CAAC,QAAQ,EACf;QACI,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;QAC/C,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;KAC1F,EACD;QACI,aAAa,EAAE,QAAQ;QACvB,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,QAAQ;KACvB,CACJ,CAAC;IACF,OAAO,GAAG,MAAM,KAAK,KAAK,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,YAAY,CAAC,IAAmB,EAAE,QAAiB;IACxD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;IACvD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,OAAO,GAAG,GAAG,IAAI,YAAY,KAAK,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,EAAE,CAAC;IAChG,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,eAAe,GACjB,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU;QAC9B,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,GAAG;QAC3E,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,GAAG,UAAU,IAAI,eAAe,KAAK,OAAO,GAAG,UAAU,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,UAA8B;IACpE,IAAI,CAAC,UAAU;QAAE,OAAO,OAAO,CAAC;IAChC,OAAO,OAAO,CAAC,OAAO,CAAC,yCAAyC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;AACpF,CAAC"}

package/dist/generated/templates.d.ts

@@ -0,0 +1,4 @@
+export type TemplateName = 'minimal' | 'teams' | 'product';
+export declare const TEMPLATE_NAMES: readonly TemplateName[];
+export declare const TEMPLATES: Record<TemplateName, string>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/generated/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/generated/templates.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3D,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAoC,CAAC;AAEvF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAIlD,CAAC"}

package/dist/generated/templates.js

@@ -0,0 +1,9 @@
+// Auto-generated by scripts/bundle-templates.mjs. Do not edit by hand.
+// Run `pnpm run bundle-templates` to regenerate.
+export const TEMPLATE_NAMES = ['minimal', 'teams', 'product'];
+export const TEMPLATES = {
+    "minimal": "nowline v1\n\nroadmap minimal \"Starter\" start:2026-01-05 scale:2w author:\"Jane Doe\"\n\nswimlane engineering \"Engineering\"\n  parallel concurrent-block style:concurrent\n    group research-group \"Research\"\n      item research \"Research\"  duration:3w status:done\n      item design   \"Design\"    duration:2w status:in-progress remaining:5d\n      item build    \"Build\"     duration:3w status:planned\n    group release-group \"Release\"\n      item release  \"Release\"   duration:1w status:planned\n      item deploy   \"Deploy\"    duration:1w status:planned\n",
+    "teams": "nowline v1\n\nroadmap teams-2026 \"Teams Roadmap 2026\" start:2026-01-05\n\nperson sam \"Sam Chen\" link:https://github.com/samchen\nperson jen \"Jennifer Wu\"\nperson alex \"Alex Rivera\"\n\nteam engineering \"Engineering\"\n  team platform-team \"Platform Team\"\n    person sam\n    person jen\n  team mobile-team \"Mobile Team\"\n    person alex\n\nanchor kickoff date:2026-01-06\nanchor mid-year date:2026-07-01\nanchor eoy \"End of Year\" date:2026-12-15\n\nswimlane platform owner:platform-team\n  item auth \"Auth refactor\" duration:1m after:kickoff owner:sam status:done\n  item api-v2 \"API v2\" duration:2w owner:jen status:in-progress remaining:40%\n\nswimlane mobile owner:mobile-team\n  item offline \"Offline mode\" duration:1m after:kickoff owner:alex status:at-risk remaining:60%\n  item push \"Push notifications\" duration:2w owner:alex\n\nmilestone beta \"Beta\" after:[auth, api-v2]\nmilestone ga \"GA\" date:2026-12-01 after:[offline, push]\n\nfootnote eng-capacity \"Mobile team capacity risk\" on:mobile-team\n  description \"Mobile team is understaffed through Q2.\"\n\nfootnote vendor-dep \"Vendor dependency\" on:[auth, api-v2]\n  description \"Blocked until vendor contract is signed.\"\n",
+    "product": "nowline v1\n\nconfig\n\nscale\n  name: weeks\n  label-every: 2\n  label: \"W{n}\"\n\ncalendar\n  days-per-week: 5\n  days-per-month: 22\n  days-per-quarter: 65\n  days-per-year: 260\n\nstyle enterprise-style \"Enterprise readiness\"\n  bg: blue\n  fg: navy\n  text: white\n  border: solid\n\nstyle risky\n  border: dashed\n  fg: orange\n\nstyle subtle\n  bg: gray\n\ndefault item shadow:subtle\ndefault swimlane padding:sm spacing:none\ndefault roadmap padding:md header-height:md font:sans\ndefault parallel bracket:none\n\nroadmap platform-2026 \"Platform 2026\" author:\"Acme Engineering\" start:2026-01-05 calendar:custom\n\nperson sam \"Sam Chen\"\nperson jen \"Jennifer Wu\"\n\nsize xs effort:1d\nsize sm effort:3d\nsize md effort:1w\nsize lg effort:2w\nsize xl effort:1m\n\nstatus awaiting-review\nstatus in-review\n\nlabel enterprise \"Enterprise readiness\" style:enterprise-style\nlabel security \"Security hardening\" style:enterprise-style\nlabel low-confidence style:risky\n\nanchor kickoff date:2026-01-06\nanchor code-freeze \"Code Freeze\" date:2026-05-01\nanchor ga-date \"GA Date\" date:2026-06-01\n\nswimlane platform\n  item auth-refactor \"Auth refactor\" size:lg after:kickoff status:done owner:sam labels:enterprise link:https://github.com/acme/platform/issues/123\n  parallel after:auth-refactor\n    group audit-track \"Audit Track\" labels:security\n      item audit-log \"Audit log v2\" size:xl before:code-freeze remaining:30% labels:[enterprise, security]\n        description \"Comprehensive audit trail for all admin actions\"\n      item audit-ui \"Audit UI\" size:md\n    item sso \"SSO plugins\" size:md labels:[enterprise, low-confidence]\n  item platform-qa \"Platform QA\" size:sm\n\nswimlane mobile\n  item offline \"Offline mode\" size:lg after:kickoff owner:jen status:at-risk remaining:60% link:https://github.com/acme/mobile/pull/87\n  item push-v2 \"Push notifications v2\" size:md\n\nmilestone beta \"Beta\" after:auth-refactor\nmilestone ga-launch \"GA launch\" date:2026-06-01 after:[auth-refactor, audit-log]\n\nfootnote vendor-footnote \"Vendor dependency\" on:audit-log\n  description \"Blocked until vendor contract is signed. Expected March resolution.\"\n"
+};
+//# sourceMappingURL=templates.js.map

package/dist/generated/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/generated/templates.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,iDAAiD;AAIjD,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAEvF,MAAM,CAAC,MAAM,SAAS,GAAiC;IACnD,SAAS,EAAE,ikBAAikB;IAC5kB,OAAO,EAAE,msCAAmsC;IAC5sC,SAAS,EAAE,iqEAAiqE;CAC/qE,CAAC"}

package/dist/generated/version.d.ts

@@ -0,0 +1,11 @@
+export declare const CLI_VERSION = "0.2.0";
+export interface CliBuild {
+    /** Short git SHA at build time, or empty when not in a git checkout. */
+    readonly sha: string;
+    /** True when HEAD is the tag matching `v${CLI_VERSION}`. */
+    readonly isRelease: boolean;
+    /** True when the working tree had uncommitted changes at build time. */
+    readonly isDirty: boolean;
+}
+export declare const CLI_BUILD: CliBuild;
+//# sourceMappingURL=version.d.ts.map

package/dist/generated/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,MAAM,WAAW,QAAQ;IACrB,wEAAwE;IACxE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,SAAS,EAAE,QAIvB,CAAC"}

package/dist/generated/version.js

@@ -0,0 +1,8 @@
+// Auto-generated by scripts/bundle-templates.mjs. Do not edit by hand.
+export const CLI_VERSION = "0.2.0";
+export const CLI_BUILD = {
+    "sha": "c51e2a4",
+    "isRelease": true,
+    "isDirty": false
+};
+//# sourceMappingURL=version.js.map

package/dist/generated/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAWnC,MAAM,CAAC,MAAM,SAAS,GAAa;IAC/B,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,KAAK;CACnB,CAAC"}

package/dist/i18n/locale.d.ts

@@ -0,0 +1,56 @@
+import type { NowlineFile } from '@nowline/core';
+declare const ENV_VARS: readonly ["LC_ALL", "LC_MESSAGES", "LANG"];
+type EnvVar = (typeof ENV_VARS)[number];
+export type LocaleSource = 'flag' | 'env' | 'rc';
+export interface ResolvedLocale {
+    /** BCP-47 tag, or undefined when no source produced one. */
+    tag: string | undefined;
+    /** Which input chain produced `tag`. Undefined iff `tag` is undefined. */
+    source: LocaleSource | undefined;
+    /** When `source === 'env'`, the specific variable that contributed. */
+    envVar?: EnvVar;
+}
+export interface ResolveLocaleInputs {
+    /** Value of the `--locale` flag, or undefined. */
+    flag: string | undefined;
+    /** Process environment, parameterized for testability. */
+    env: NodeJS.ProcessEnv;
+    /** Optional `.nowlinerc` `locale` key. Slots below env vars. */
+    rc?: string | undefined;
+}
+/**
+ * Resolve the operator's locale override.
+ *
+ * Precedence (highest wins): `--locale` flag > env vars > `.nowlinerc`.
+ * POSIX `C` / `POSIX` env values mean "no localization" and are skipped.
+ *
+ * Returns `{ tag: undefined, source: undefined }` when nothing is set —
+ * `operatorLocale` then defaults to `en-US`, while the layout's content
+ * chain falls back to whatever the file's `locale:` directive declares.
+ */
+export declare function resolveLocaleOverride({ flag, env, rc }: ResolveLocaleInputs): ResolvedLocale;
+/**
+ * Resolve the operator-facing locale used to format CLI message output.
+ * `en-US` when the operator has no signal in the environment.
+ */
+export declare function operatorLocale(resolved: ResolvedLocale): string;
+/**
+ * Describe which locale governs the rendered artifact and where the
+ * value came from. Used by the `--verbose` log line so an operator can
+ * see at a glance whether the file or the operator chain is winning.
+ *
+ * Precedence mirrors the layout's `resolveLocale`:
+ *   file directive > CLI flag > env > `.nowlinerc` > en-US (default).
+ */
+export declare function describeContentLocaleSource(directive: string | undefined, resolved: ResolvedLocale): {
+    tag: string;
+    source: string;
+};
+/**
+ * Read the optional `locale:` property from a parsed file's
+ * `nowline v1` directive. Returns undefined when the directive is
+ * absent, malformed, or omits the property.
+ */
+export declare function readDirectiveLocale(file: NowlineFile | undefined): string | undefined;
+export {};
+//# sourceMappingURL=locale.d.ts.map

package/dist/i18n/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/i18n/locale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAYjD,QAAA,MAAM,QAAQ,4CAA6C,CAAC;AAC5D,KAAK,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC3B,4DAA4D;IAC5D,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,0EAA0E;IAC1E,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IACjC,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,mBAAmB,GAAG,cAAc,CAe5F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,cAAc,GACzB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAajC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGrF"}

package/dist/i18n/locale.js

@@ -0,0 +1,107 @@
+// Resolve the operator-locale override from CLI flag, environment, and
+// `.nowlinerc`. See `specs/localization.md` for the two-chain model.
+//
+// Operator locale governs CLI message output: validator diagnostics on
+// stderr, `--help`, format errors, verbose logs. It is independent from
+// the file's `locale:` directive, which governs the rendered artifact.
+//
+// Returns the resolved tag plus the source it came from, so verbose
+// logging can describe the chain without re-walking it.
+const ENV_VARS = ['LC_ALL', 'LC_MESSAGES', 'LANG'];
+/**
+ * Resolve the operator's locale override.
+ *
+ * Precedence (highest wins): `--locale` flag > env vars > `.nowlinerc`.
+ * POSIX `C` / `POSIX` env values mean "no localization" and are skipped.
+ *
+ * Returns `{ tag: undefined, source: undefined }` when nothing is set —
+ * `operatorLocale` then defaults to `en-US`, while the layout's content
+ * chain falls back to whatever the file's `locale:` directive declares.
+ */
+export function resolveLocaleOverride({ flag, env, rc }) {
+    if (flag)
+        return { tag: flag, source: 'flag' };
+    for (const name of ENV_VARS) {
+        const raw = env[name];
+        if (!raw)
+            continue;
+        const stripped = stripPosixSuffix(raw);
+        if (!stripped || stripped === 'C' || stripped === 'POSIX') {
+            // POSIX `C` / `POSIX` locale means "no localization." Skip and
+            // let the next env var or the rc file take over.
+            continue;
+        }
+        return { tag: normalizePosixToBcp47(stripped), source: 'env', envVar: name };
+    }
+    if (rc)
+        return { tag: rc, source: 'rc' };
+    return { tag: undefined, source: undefined };
+}
+/**
+ * Resolve the operator-facing locale used to format CLI message output.
+ * `en-US` when the operator has no signal in the environment.
+ */
+export function operatorLocale(resolved) {
+    return resolved.tag ?? 'en-US';
+}
+/**
+ * Describe which locale governs the rendered artifact and where the
+ * value came from. Used by the `--verbose` log line so an operator can
+ * see at a glance whether the file or the operator chain is winning.
+ *
+ * Precedence mirrors the layout's `resolveLocale`:
+ *   file directive > CLI flag > env > `.nowlinerc` > en-US (default).
+ */
+export function describeContentLocaleSource(directive, resolved) {
+    if (directive)
+        return { tag: directive, source: 'from file directive' };
+    if (resolved.tag === undefined)
+        return { tag: 'en-US', source: 'default' };
+    switch (resolved.source) {
+        case 'flag':
+            return { tag: resolved.tag, source: 'from --locale' };
+        case 'env':
+            return { tag: resolved.tag, source: `from ${resolved.envVar} env var` };
+        case 'rc':
+            return { tag: resolved.tag, source: 'from .nowlinerc' };
+        default:
+            return { tag: resolved.tag, source: 'from operator chain' };
+    }
+}
+/**
+ * Read the optional `locale:` property from a parsed file's
+ * `nowline v1` directive. Returns undefined when the directive is
+ * absent, malformed, or omits the property.
+ */
+export function readDirectiveLocale(file) {
+    const prop = file?.directive?.properties.find((p) => stripColon(p.key) === 'locale');
+    return prop?.value || undefined;
+}
+function stripColon(key) {
+    return key.endsWith(':') ? key.slice(0, -1) : key;
+}
+/**
+ * POSIX `LANG` values look like `en_US.UTF-8` or `fr_CA@euro`. Strip
+ * everything from `.` or `@` onward — Nowline only cares about the
+ * language and region.
+ */
+function stripPosixSuffix(value) {
+    const dot = value.indexOf('.');
+    const at = value.indexOf('@');
+    let end = value.length;
+    if (dot !== -1 && dot < end)
+        end = dot;
+    if (at !== -1 && at < end)
+        end = at;
+    return value.slice(0, end).trim();
+}
+/**
+ * Normalize `fr_CA` to `fr-CA`. POSIX uses `_`; BCP-47 uses `-`.
+ * Casing follows BCP-47 conventions: language lowercase, region
+ * uppercase 2-letter, but the layout's BCP-47 walker normalizes again
+ * defensively, so this is best-effort.
+ */
+function normalizePosixToBcp47(value) {
+    return value.replace('_', '-');
+}
+//# sourceMappingURL=locale.js.map

package/dist/i18n/locale.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}