@nowline/cli 0.2.0

package/dist/commands/serve.js

@@ -0,0 +1,287 @@
+import { promises as fs, watch as fsWatch } from 'node:fs';
+import * as http from 'node:http';
+import * as path from 'node:path';
+import { resolveIncludes } from '@nowline/core';
+import { layoutRoadmap } from '@nowline/layout';
+import { renderSvg } from '@nowline/renderer';
+import { getServices, parseSource } from '../core/parse.js';
+import { formatDiagnostics } from '../diagnostics/index.js';
+import { describeContentLocaleSource, operatorLocale, readDirectiveLocale, resolveLocaleOverride, } from '../i18n/locale.js';
+import { CliError, ExitCode } from '../io/exit-codes.js';
+import { createAssetResolver } from './render.js';
+/**
+ * `--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 async function serveHandler(options) {
+    const { args } = options;
+    const cwd = options.cwd ?? process.cwd();
+    if (!args.positional) {
+        throw new CliError(ExitCode.InputError, 'nowline: --serve requires an input file. Pass a path or run `nowline --help`.');
+    }
+    if (args.positional === '-') {
+        throw new CliError(ExitCode.InputError, 'nowline: --serve cannot read from stdin. Pass a file path.');
+    }
+    if (args.output === '-') {
+        throw new CliError(ExitCode.InputError, 'nowline: --serve does not support -o - (stdout). Use a file path or omit -o.');
+    }
+    const port = parsePort(args.port);
+    const host = args.host ?? '127.0.0.1';
+    const theme = parseTheme(args.theme);
+    const today = resolveNowArg(args);
+    const resolvedLocale = resolveLocaleOverride({ flag: args.locale, env: process.env });
+    const locale = resolvedLocale.tag;
+    const opLocale = operatorLocale(resolvedLocale);
+    const inputPath = path.resolve(cwd, args.positional);
+    try {
+        await fs.access(inputPath);
+    }
+    catch {
+        throw new CliError(ExitCode.InputError, `nowline: file not found: ${args.positional}`);
+    }
+    const assetRoot = args.assetRoot ? path.resolve(cwd, args.assetRoot) : path.dirname(inputPath);
+    const fileSink = args.output ? path.resolve(cwd, args.output) : undefined;
+    const clients = new Set();
+    let lastPayload = {
+        kind: 'svg',
+        body: '',
+    };
+    const rebuild = async () => {
+        try {
+            const text = await fs.readFile(inputPath, 'utf-8');
+            const parse = await parseSource(text, inputPath, { validate: true });
+            if (parse.hasErrors) {
+                const sources = new Map([[inputPath, parse.source]]);
+                const rendered = formatDiagnostics(parse.diagnostics, 'text', sources, {
+                    color: false,
+                    operatorLocale: opLocale,
+                });
+                lastPayload = { kind: 'error', body: rendered };
+                process.stderr.write(`${rendered}\n`);
+                broadcast(clients, 'error', rendered);
+                return;
+            }
+            if (args.logLevel === 'verbose') {
+                const directive = readDirectiveLocale(parse.ast);
+                const { tag, source } = describeContentLocaleSource(directive, resolvedLocale);
+                process.stderr.write(`nowline: locale=${tag} (${source})\n`);
+            }
+            const resolved = await resolveIncludes(parse.ast, inputPath, {
+                services: getServices().Nowline,
+            });
+            if (resolved.diagnostics.some((d) => d.severity === 'error')) {
+                const msg = resolved.diagnostics
+                    .filter((d) => d.severity === 'error')
+                    .map((d) => `${d.sourcePath}: ${d.message}`)
+                    .join('\n');
+                lastPayload = { kind: 'error', body: msg };
+                broadcast(clients, 'error', msg);
+                return;
+            }
+            const model = layoutRoadmap(parse.ast, resolved, { theme, today, locale });
+            const svg = await renderSvg(model, {
+                assetResolver: createAssetResolver(assetRoot),
+                warn: (m) => process.stderr.write(`warning: ${m}\n`),
+            });
+            lastPayload = { kind: 'svg', body: svg };
+            if (fileSink) {
+                try {
+                    await fs.writeFile(fileSink, svg);
+                    if (args.logLevel === 'verbose') {
+                        process.stderr.write(`nowline: wrote ${fileSink}\n`);
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    process.stderr.write(`nowline: failed to write ${fileSink}: ${msg}\n`);
+                }
+            }
+            broadcast(clients, 'update', svg);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            lastPayload = { kind: 'error', body: msg };
+            process.stderr.write(`error: ${msg}\n`);
+            broadcast(clients, 'error', msg);
+        }
+    };
+    await rebuild();
+    const watcher = watchFile(inputPath, rebuild);
+    const server = http.createServer((req, res) => {
+        const url = req.url ?? '/';
+        if (url === '/' || url === '/index.html') {
+            res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
+            res.end(shellHtml(theme));
+            return;
+        }
+        if (url === '/svg') {
+            res.writeHead(200, { 'content-type': 'image/svg+xml; charset=utf-8' });
+            res.end(lastPayload.kind === 'svg' ? lastPayload.body : emptySvg);
+            return;
+        }
+        if (url === '/events') {
+            res.writeHead(200, {
+                'content-type': 'text/event-stream',
+                'cache-control': 'no-cache, no-transform',
+                connection: 'keep-alive',
+            });
+            clients.add(res);
+            res.write(`event: hello\ndata: connected\n\n`);
+            const initialEvent = lastPayload.kind === 'svg' ? 'update' : 'error';
+            sendEvent(res, initialEvent, lastPayload.body);
+            req.on('close', () => {
+                clients.delete(res);
+            });
+            return;
+        }
+        res.writeHead(404);
+        res.end('not found');
+    });
+    await new Promise((resolve) => {
+        server.listen(port, host, () => resolve());
+    });
+    process.stdout.write(`nowline serve: http://${host}:${port}\n`);
+    if (args.open) {
+        await openBrowser(`http://${host}:${port}`);
+    }
+    const shutdown = async () => {
+        watcher.close();
+        for (const c of clients) {
+            try {
+                c.end();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        clients.clear();
+        server.close();
+    };
+    process.once('SIGINT', () => {
+        void shutdown().then(() => process.exit(0));
+    });
+    process.once('SIGTERM', () => {
+        void shutdown().then(() => process.exit(0));
+    });
+    // Keep the process alive until a signal.
+    await new Promise(() => { });
+}
+function parsePort(raw) {
+    const port = parseInt(raw ?? '4318', 10);
+    if (!Number.isFinite(port) || port <= 0 || port >= 65536) {
+        throw new CliError(ExitCode.InputError, `nowline: invalid --port "${raw}".`);
+    }
+    return port;
+}
+function parseTheme(raw) {
+    const lower = (raw ?? 'light').toLowerCase();
+    if (lower !== 'light' && lower !== 'dark') {
+        throw new CliError(ExitCode.InputError, `nowline: invalid --theme "${raw}".`);
+    }
+    return lower;
+}
+// Mirrors render.ts: `--now -` disables the line, `--now <date>` overrides
+// it, and the default is today's UTC calendar 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}".`);
+        return new Date(Date.UTC(parseInt(m[1], 10), parseInt(m[2], 10) - 1, parseInt(m[3], 10)));
+    }
+    const t = new Date();
+    return new Date(Date.UTC(t.getUTCFullYear(), t.getUTCMonth(), t.getUTCDate()));
+}
+function sendEvent(res, event, data) {
+    const lines = data
+        .split('\n')
+        .map((l) => `data: ${l}`)
+        .join('\n');
+    res.write(`event: ${event}\n${lines}\n\n`);
+}
+function broadcast(clients, event, data) {
+    for (const c of clients) {
+        try {
+            sendEvent(c, event, data);
+        }
+        catch {
+            clients.delete(c);
+        }
+    }
+}
+function watchFile(target, onChange) {
+    let timer;
+    const w = fsWatch(target, { persistent: true }, () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            void onChange();
+        }, 75);
+    });
+    return w;
+}
+async function openBrowser(url) {
+    const { spawn } = await import('node:child_process');
+    const platform = process.platform;
+    const command = platform === 'darwin' ? 'open' : platform === 'win32' ? 'cmd' : 'xdg-open';
+    const argList = platform === 'win32' ? ['/c', 'start', '', url] : [url];
+    try {
+        const child = spawn(command, argList, { stdio: 'ignore', detached: true });
+        child.unref();
+    }
+    catch {
+        process.stderr.write(`nowline: warning — failed to open browser; visit ${url} manually.\n`);
+    }
+}
+const emptySvg = '<svg xmlns="http://www.w3.org/2000/svg" width="400" height="60"><text x="10" y="30" font-family="system-ui" font-size="14" fill="#999">no output yet</text></svg>';
+function shellHtml(theme) {
+    const bg = theme === 'dark' ? '#121212' : '#ffffff';
+    const fg = theme === 'dark' ? '#e0e0e0' : '#212121';
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8"/>
+<title>nowline serve</title>
+<style>
+  html, body { margin: 0; padding: 0; height: 100%; background: ${bg}; color: ${fg}; font-family: system-ui, -apple-system, sans-serif; }
+  #root { padding: 12px; }
+  #error { display: none; position: fixed; bottom: 0; left: 0; right: 0; padding: 12px; background: rgba(183,28,28,0.9); color: white; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; white-space: pre-wrap; max-height: 40%; overflow: auto; }
+  #error.show { display: block; }
+  #root svg { max-width: 100%; height: auto; display: block; }
+</style>
+</head>
+<body>
+<div id="root"></div>
+<pre id="error"></pre>
+<script>
+(function(){
+  var root = document.getElementById('root');
+  var errBox = document.getElementById('error');
+  function show(svg){
+    root.innerHTML = svg;
+    errBox.className = '';
+    errBox.textContent = '';
+  }
+  function err(msg){
+    errBox.textContent = msg;
+    errBox.className = 'show';
+  }
+  fetch('/svg').then(function(r){ return r.text(); }).then(show).catch(function(e){ err(String(e)); });
+  var ev = new EventSource('/events');
+  ev.addEventListener('update', function(e){ show(e.data); });
+  ev.addEventListener('error', function(e){
+    if (e.data) err(e.data);
+  });
+})();
+</script>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

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

package/dist/convert/parse-json.d.ts

@@ -0,0 +1,7 @@
+import { type JsonAstNode, type NowlineDocument } from './schema.js';
+export interface ParseJsonResult {
+    document: NowlineDocument;
+    ast: JsonAstNode;
+}
+export declare function parseNowlineJson(text: string, filePath: string): ParseJsonResult;
+//# sourceMappingURL=parse-json.d.ts.map

package/dist/convert/parse-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json.d.ts","sourceRoot":"","sources":["../../src/convert/parse-json.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAA0B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7F,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,GAAG,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CA4ChF"}

package/dist/convert/parse-json.js

@@ -0,0 +1,34 @@
+import { CliError, ExitCode } from '../io/exit-codes.js';
+import { NOWLINE_SCHEMA_VERSION } from './schema.js';
+export function parseNowlineJson(text, filePath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (err) {
+        throw new CliError(ExitCode.ValidationError, `${filePath}: invalid JSON — ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const doc = parsed;
+    if (!isRecord(doc)) {
+        throw new CliError(ExitCode.ValidationError, `${filePath}: JSON root must be an object with $nowlineSchema and ast.`);
+    }
+    const schema = doc.$nowlineSchema;
+    if (typeof schema !== 'string') {
+        throw new CliError(ExitCode.ValidationError, `${filePath}: missing "$nowlineSchema" at document root.`);
+    }
+    if (schema !== NOWLINE_SCHEMA_VERSION) {
+        throw new CliError(ExitCode.ValidationError, `${filePath}: unsupported $nowlineSchema "${schema}" (this CLI supports "${NOWLINE_SCHEMA_VERSION}").`);
+    }
+    const ast = doc.ast;
+    if (!isRecord(ast) || typeof ast.$type !== 'string') {
+        throw new CliError(ExitCode.ValidationError, `${filePath}: document.ast must be an object with a "$type" field.`);
+    }
+    if (ast.$type !== 'NowlineFile') {
+        throw new CliError(ExitCode.ValidationError, `${filePath}: document.ast.$type must be "NowlineFile" (got "${String(ast.$type)}").`);
+    }
+    return { document: doc, ast: ast };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=parse-json.js.map

package/dist/convert/parse-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json.js","sourceRoot":"","sources":["../../src/convert/parse-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAoB,sBAAsB,EAAwB,MAAM,aAAa,CAAC;AAO7F,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB;IAC3D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CACd,QAAQ,CAAC,eAAe,EACxB,GAAG,QAAQ,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpF,CAAC;IACN,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC;IACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,QAAQ,CACd,QAAQ,CAAC,eAAe,EACxB,GAAG,QAAQ,4DAA4D,CAC1E,CAAC;IACN,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC;IAClC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,QAAQ,CACd,QAAQ,CAAC,eAAe,EACxB,GAAG,QAAQ,8CAA8C,CAC5D,CAAC;IACN,CAAC;IACD,IAAI,MAAM,KAAK,sBAAsB,EAAE,CAAC;QACpC,MAAM,IAAI,QAAQ,CACd,QAAQ,CAAC,eAAe,EACxB,GAAG,QAAQ,iCAAiC,MAAM,yBAAyB,sBAAsB,KAAK,CACzG,CAAC;IACN,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,QAAQ,CACd,QAAQ,CAAC,eAAe,EACxB,GAAG,QAAQ,wDAAwD,CACtE,CAAC;IACN,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;QAC9B,MAAM,IAAI,QAAQ,CACd,QAAQ,CAAC,eAAe,EACxB,GAAG,QAAQ,oDAAoD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CACxF,CAAC;IACN,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,GAAiC,EAAE,GAAG,EAAE,GAA6B,EAAE,CAAC;AAC/F,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC"}

package/dist/convert/printer.d.ts

@@ -0,0 +1,6 @@
+import type { JsonAstNode } from './schema.js';
+export interface PrintOptions {
+    indent?: string;
+}
+export declare function printNowlineFile(ast: JsonAstNode, options?: PrintOptions): string;
+//# sourceMappingURL=printer.d.ts.map

package/dist/convert/printer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"printer.d.ts","sourceRoot":"","sources":["../../src/convert/printer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA4B/C,MAAM,WAAW,YAAY;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAIrF"}