@maudecode/talaria-web 0.0.0

package/dist/spa.js

@@ -0,0 +1,145 @@
+/**
+ * The production SPA shell from `static/dist` (Python `api/spa_shell.py`):
+ * route allowlist, placeholder substitution, hashed assets with ETag/gzip.
+ */
+import { gzipSync } from 'node:zlib';
+import { readFileSync, statSync } from 'node:fs';
+import { extname, relative, resolve, isAbsolute } from 'node:path';
+export const SPA_EXACT_PATHS = new Set([
+    '/', '/index.html', '/sessions', '/tasks', '/kanban', '/skills', '/memory', '/workspaces', '/profiles', '/todos', '/insights', '/logs',
+    '/settings', '/onboarding', '/login', '/share',
+]);
+export const SPA_PREFIX_PATHS = ['/session/', '/tasks/', '/kanban/', '/skills/', '/memory/', '/workspaces/', '/profiles/', '/settings/', '/ext/', '/share/'];
+export const SERVER_OWNED_PREFIXES = ['/api/', '/assets/', '/static/', '/extensions/', '/plugins/', '/dashboard-plugins/', '/session/static/'];
+export const SERVER_OWNED_EXACT = new Set(['/health', '/sw.js', '/manifest.json', '/manifest.webmanifest', '/favicon.ico', '/search', '/session/manifest.json', '/session/manifest.webmanifest']);
+export const SPA_PUBLIC_EXACT = new Set(['/login', '/share']);
+export const SPA_PUBLIC_PREFIXES = ['/share/'];
+const ASSET_MIME = {
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.html': 'text/html; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.webmanifest': 'application/manifest+json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.ico': 'image/x-icon',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.woff2': 'font/woff2',
+    '.woff': 'font/woff',
+    '.txt': 'text/plain; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.wasm': 'application/wasm',
+};
+const COMPRESSIBLE = new Set(['.js', '.mjs', '.css', '.html', '.json', '.webmanifest', '.svg', '.txt', '.map']);
+export function isServerOwned(path) {
+    return SERVER_OWNED_EXACT.has(path) || SERVER_OWNED_PREFIXES.some((p) => path.startsWith(p));
+}
+export function isSpaPath(path) {
+    if (isServerOwned(path))
+        return false;
+    if (SPA_EXACT_PATHS.has(path))
+        return true;
+    return SPA_PREFIX_PATHS.some((p) => path.startsWith(p));
+}
+export function isPublicSpaPath(path) {
+    return SPA_PUBLIC_EXACT.has(path) || SPA_PUBLIC_PREFIXES.some((p) => path.startsWith(p));
+}
+/** `/` and `/settings` -> `./`; `/session/abc` -> `../`. */
+export function baseHrefFor(path) {
+    const depth = Math.max(0, path.split('/').filter(Boolean).length - 1);
+    return depth ? '../'.repeat(depth) : './';
+}
+/** Percent-encode like Python `urllib.parse.quote(value, safe='')`. */
+export function quoteAll(value) {
+    return encodeURIComponent(value).replace(/[!'()*~]/g, (c) => '%' + c.charCodeAt(0).toString(16).toUpperCase()).replace(/%7E/g, '~');
+}
+/** Cached files under one root: raw bytes, gzip twin for compressible types over 1 KiB, weak ETag from (size, mtime_ns). */
+export class AssetCache {
+    root;
+    entries = new Map();
+    constructor(root) {
+        this.root = resolve(root);
+    }
+    /** Resolve `<root>/<rel>`; null when missing, not a file, or escaping the root. */
+    get(rel) {
+        const file = resolve(this.root, rel);
+        const inside = relative(this.root, file);
+        if (!inside || inside.startsWith('..') || isAbsolute(inside))
+            return null;
+        let st;
+        try {
+            st = statSync(file, { bigint: true });
+        }
+        catch {
+            return null;
+        }
+        if (!st.isFile())
+            return null;
+        const sig = `${st.size}:${st.mtimeNs}`;
+        const cached = this.entries.get(file);
+        if (cached?.sig === sig)
+            return cached.asset;
+        const body = readFileSync(file);
+        const ext = extname(file).toLowerCase();
+        const gz = COMPRESSIBLE.has(ext) && body.length > 1024 ? gzipSync(body, { level: 6 }) : null;
+        const etag = `W/"${st.size.toString(16)}-${st.mtimeNs.toString(16)}"`;
+        const asset = { body, gz, etag, contentType: ASSET_MIME[ext] ?? 'application/octet-stream' };
+        this.entries.set(file, { sig, asset });
+        return asset;
+    }
+}
+export class SpaShell {
+    distRoot;
+    assets;
+    shell = null;
+    constructor(distRoot) {
+        this.distRoot = resolve(distRoot);
+        this.assets = new AssetCache(this.distRoot);
+    }
+    available() {
+        try {
+            return statSync(resolve(this.distRoot, 'index.html')).isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    readTemplate() {
+        const file = resolve(this.distRoot, 'index.html');
+        const st = statSync(file, { bigint: true });
+        const sig = `${st.size}:${st.mtimeNs}`;
+        if (this.shell?.sig === sig)
+            return this.shell.text;
+        const text = readFileSync(file, 'utf8');
+        this.shell = { sig, text };
+        return text;
+    }
+    renderShell(path, opts) {
+        const lang = opts.lang ?? 'en';
+        const safeLang = lang && /^[A-Za-z0-9-]+$/.test(lang) && /[A-Za-z0-9]/.test(lang) && lang.length <= 16 ? lang : 'en';
+        return this.readTemplate()
+            .replaceAll('__BASE_HREF__', baseHrefFor(path))
+            .replaceAll('__LANG__', safeLang)
+            .replaceAll('__WEBUI_VERSION__', quoteAll(opts.version));
+    }
+    /** Resolve `static/dist/<rel>` inside the root; null when missing or escaping. */
+    asset(rel) {
+        return this.assets.get(rel);
+    }
+    serviceWorker(version) {
+        const file = resolve(this.distRoot, 'sw.js');
+        try {
+            if (!statSync(file).isFile())
+                return null;
+        }
+        catch {
+            return null;
+        }
+        return Buffer.from(readFileSync(file, 'utf8').replaceAll('__WEBUI_VERSION__', quoteAll(version)), 'utf8');
+    }
+}
+//# sourceMappingURL=spa.js.map

package/dist/spa.js.map

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

package/dist/startup.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Startup readiness gate (Python `api/startup.py`). Starts ready; the server
+ * arms it before deferred recovery and releases it when recovery settles.
+ * `/api/` requests wait a bounded time, with a bounded number of waiters.
+ */
+export declare const STARTUP_WAIT_SECONDS = 10;
+export declare const STARTUP_WAIT_SLOT_COUNT = 8;
+export declare const STARTUP_RECOVERY_CONDITION = "startup_recovery";
+export declare const STARTUP_IMMEDIATE_PATHS: Set<string>;
+export declare class StartupGate {
+    ready: boolean;
+    phase: string;
+    private waiters;
+    private resolvers;
+    arm(phase?: string): void;
+    release(): void;
+    /** `true` when the request may proceed; `false` when it should get the startup 503. */
+    wait(timeoutMs?: number): Promise<boolean>;
+}

package/dist/startup.js

@@ -0,0 +1,44 @@
+/**
+ * Startup readiness gate (Python `api/startup.py`). Starts ready; the server
+ * arms it before deferred recovery and releases it when recovery settles.
+ * `/api/` requests wait a bounded time, with a bounded number of waiters.
+ */
+export const STARTUP_WAIT_SECONDS = 10;
+export const STARTUP_WAIT_SLOT_COUNT = 8;
+export const STARTUP_RECOVERY_CONDITION = 'startup_recovery';
+export const STARTUP_IMMEDIATE_PATHS = new Set(['/api/health/restart', '/api/csp-report']);
+export class StartupGate {
+    ready = true;
+    phase = 'session recovery';
+    waiters = 0;
+    resolvers = [];
+    arm(phase = 'session recovery') {
+        this.ready = false;
+        this.phase = phase;
+    }
+    release() {
+        this.ready = true;
+        const pending = this.resolvers;
+        this.resolvers = [];
+        for (const resolve of pending)
+            resolve();
+    }
+    /** `true` when the request may proceed; `false` when it should get the startup 503. */
+    async wait(timeoutMs = STARTUP_WAIT_SECONDS * 1000) {
+        if (this.ready)
+            return true;
+        if (this.waiters >= STARTUP_WAIT_SLOT_COUNT)
+            return false;
+        this.waiters += 1;
+        try {
+            return await new Promise((resolve) => {
+                const timer = setTimeout(() => { resolve(this.ready); }, timeoutMs);
+                this.resolvers.push(() => { clearTimeout(timer); resolve(true); });
+            });
+        }
+        finally {
+            this.waiters -= 1;
+        }
+    }
+}
+//# sourceMappingURL=startup.js.map

package/dist/startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.js","sourceRoot":"","sources":["../src/startup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAA;AACtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AACxC,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAA;AAC5D,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAC,CAAA;AAE1F,MAAM,OAAO,WAAW;IACtB,KAAK,GAAG,IAAI,CAAA;IACZ,KAAK,GAAG,kBAAkB,CAAA;IAClB,OAAO,GAAG,CAAC,CAAA;IACX,SAAS,GAAmB,EAAE,CAAA;IAEtC,GAAG,CAAC,KAAK,GAAG,kBAAkB;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAA;QAC9B,IAAI,CAAC,SAAS,GAAG,EAAE,CAAA;QACnB,KAAK,MAAM,OAAO,IAAI,OAAO;YAAE,OAAO,EAAE,CAAA;IAC1C,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,oBAAoB,GAAG,IAAI;QAChD,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QAC3B,IAAI,IAAI,CAAC,OAAO,IAAI,uBAAuB;YAAE,OAAO,KAAK,CAAA;QACzD,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;QACjB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;gBAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;gBAClE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;YACnE,CAAC,CAAC,CAAA;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/test/harness.d.ts

@@ -0,0 +1,41 @@
+import type { Env } from '../config.js';
+import type { AppDeps } from '../http/context.js';
+import { type RunningServer } from '../server.js';
+import type { SidecarLike } from '../sidecar/client.js';
+export declare const WEB_ROOT: string;
+export interface TestServer {
+    deps: AppDeps;
+    running: RunningServer;
+    base: string;
+    state: string;
+    logs: string[];
+    /** `fetch` that never follows redirects. */
+    get: (path: string, init?: RequestInit) => Promise<Response>;
+    /** Raw HTTP/1.0 GET so the request target is sent verbatim (no WHATWG URL normalisation). */
+    rawStatus: (target: string) => Promise<number>;
+    close: () => Promise<void>;
+    /** Open an SSE endpoint and collect frames until `until(event)` returns true, the stream closes, or the timeout elapses. */
+    sse: (path: string, until: (event: SseFrame) => boolean, opts?: {
+        headers?: Record<string, string>;
+        timeoutMs?: number;
+    }) => Promise<SseFrame[]>;
+}
+export interface SseFrame {
+    event: string;
+    data: unknown;
+    id: string | null;
+    raw: string;
+}
+export declare function parseSseChunk(buffer: string): {
+    frames: SseFrame[];
+    rest: string;
+};
+export interface BootOptions {
+    env?: Env;
+    now?: () => number;
+    deps?: (deps: AppDeps) => void;
+    sidecar?: SidecarLike | null;
+    gatewayPollMs?: number;
+}
+export declare function bootTestServer(opts?: BootOptions): Promise<TestServer>;
+export declare function cookieHeader(setCookies: string[], name: string): string | undefined;

package/dist/test/harness.js

@@ -0,0 +1,123 @@
+/** Boot one isolated server on an ephemeral port with a temp state directory. */
+import { mkdtempSync, rmSync } from 'node:fs';
+import { connect } from 'node:net';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { createApp } from '../app.js';
+import { createDeps } from '../runtime.js';
+import { startServer } from '../server.js';
+export const WEB_ROOT = resolve(import.meta.dirname, '../../../..');
+export function parseSseChunk(buffer) {
+    const frames = [];
+    let rest = buffer;
+    for (;;) {
+        const idx = rest.indexOf('\n\n');
+        if (idx < 0)
+            break;
+        const block = rest.slice(0, idx);
+        rest = rest.slice(idx + 2);
+        if (!block.trim() || block.startsWith(':'))
+            continue;
+        let event = 'message';
+        let id = null;
+        const dataLines = [];
+        for (const line of block.split('\n')) {
+            if (line.startsWith('event:'))
+                event = line.slice(6).trim();
+            else if (line.startsWith('id:'))
+                id = line.slice(3).trim();
+            else if (line.startsWith('data:'))
+                dataLines.push(line.slice(5).trimStart());
+        }
+        const dataText = dataLines.join('\n');
+        let data = dataText;
+        try {
+            data = dataText ? JSON.parse(dataText) : {};
+        }
+        catch {
+            data = dataText;
+        }
+        frames.push({ event, data, id, raw: block });
+    }
+    return { frames, rest };
+}
+export async function bootTestServer(opts = {}) {
+    const state = mkdtempSync(join(tmpdir(), 'talaria-server-test-'));
+    const logs = [];
+    const env = {
+        PATH: process.env.PATH,
+        HOME: process.env.HOME,
+        HERMES_HOME: state,
+        HERMES_WEBUI_STATE_DIR: state,
+        HERMES_WEBUI_DEFAULT_WORKSPACE: join(state, 'workspace'),
+        HERMES_WEBUI_HOST: '127.0.0.1',
+        HERMES_WEBUI_PORT: '0',
+        ...opts.env,
+    };
+    const deps = createDeps({ env, webRoot: WEB_ROOT, log: (line) => logs.push(line), version: 'web-v0.0.0-test', ...(opts.now ? { now: opts.now } : {}), ...(opts.sidecar !== undefined ? { sidecar: opts.sidecar } : {}), ...(opts.gatewayPollMs !== undefined ? { gatewayPollMs: opts.gatewayPollMs } : {}) });
+    opts.deps?.(deps);
+    const running = await startServer(createApp(deps), deps.config, { log: (line) => logs.push(line), signals: false });
+    const base = `http://127.0.0.1:${running.port}`;
+    return {
+        deps,
+        running,
+        base,
+        state,
+        logs,
+        get: (path, init) => fetch(base + path, { redirect: 'manual', ...init }),
+        sse: async (path, until, sseOpts = {}) => {
+            const controller = new AbortController();
+            const timer = setTimeout(() => { controller.abort(); }, sseOpts.timeoutMs ?? 10_000);
+            const frames = [];
+            try {
+                const res = await fetch(base + path, { headers: sseOpts.headers ?? {}, signal: controller.signal });
+                if (res.status !== 200 || !res.body)
+                    throw new Error(`SSE ${path} answered ${String(res.status)}: ${await res.text()}`);
+                const reader = res.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = '';
+                for (;;) {
+                    const chunk = await reader.read();
+                    if (chunk.done)
+                        break;
+                    buffer += decoder.decode(chunk.value, { stream: true });
+                    const parsed = parseSseChunk(buffer);
+                    buffer = parsed.rest;
+                    let stop = false;
+                    for (const frame of parsed.frames) {
+                        frames.push(frame);
+                        if (until(frame))
+                            stop = true;
+                    }
+                    if (stop) {
+                        controller.abort();
+                        break;
+                    }
+                }
+            }
+            catch (error) {
+                if (!(error instanceof Error && error.name === 'AbortError'))
+                    throw error;
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            return frames;
+        },
+        rawStatus: (target) => new Promise((resolve, reject) => {
+            const socket = connect({ host: '127.0.0.1', port: running.port }, () => { socket.write(`GET ${target} HTTP/1.0\r\nHost: localhost\r\n\r\n`); });
+            let data = '';
+            socket.on('data', (chunk) => { data += chunk.toString('latin1'); });
+            socket.on('error', reject);
+            socket.on('close', () => { resolve(Number(data.split(' ')[1])); });
+        }),
+        close: async () => {
+            await running.close();
+            rmSync(state, { recursive: true, force: true });
+        },
+    };
+}
+export function cookieHeader(setCookies, name) {
+    return setCookies.map((c) => c.split(';')[0] ?? '').find((c) => c.startsWith(`${name}=`));
+}
+//# sourceMappingURL=harness.js.map

package/dist/test/harness.js.map

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

package/dist/text/diff.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Unified diff in the shape Python's `difflib.unified_diff(..., lineterm="")`
+ * emits: `---`/`+++` headers, `@@` hunks with 3 lines of context, and lines
+ * that keep their own line endings (callers pass `splitlines(keepends=True)`).
+ */
+interface Op {
+    tag: 'equal' | 'replace' | 'delete' | 'insert';
+    i1: number;
+    i2: number;
+    j1: number;
+    j2: number;
+}
+/** Longest-common-subsequence opcodes (Myers would be smaller; this is O(n·m) but the inputs are small files). */
+export declare function opcodes(a: string[], b: string[]): Op[];
+export declare function unifiedDiff(a: string[], b: string[], fromFile: string, toFile: string, context?: number): string[];
+export {};

package/dist/text/diff.js

@@ -0,0 +1,122 @@
+/**
+ * Unified diff in the shape Python's `difflib.unified_diff(..., lineterm="")`
+ * emits: `---`/`+++` headers, `@@` hunks with 3 lines of context, and lines
+ * that keep their own line endings (callers pass `splitlines(keepends=True)`).
+ */
+/** Longest-common-subsequence opcodes (Myers would be smaller; this is O(n·m) but the inputs are small files). */
+export function opcodes(a, b) {
+    const n = a.length;
+    const m = b.length;
+    // ponytail: O(n*m) LCS table; switch to Myers if rollback diffs of large files show up in profiles.
+    const table = [];
+    for (let i = 0; i <= n; i += 1)
+        table.push(new Uint32Array(m + 1));
+    for (let i = n - 1; i >= 0; i -= 1) {
+        const row = table[i];
+        const next = table[i + 1];
+        for (let j = m - 1; j >= 0; j -= 1) {
+            row[j] = a[i] === b[j] ? (next[j + 1] ?? 0) + 1 : Math.max(next[j] ?? 0, row[j + 1] ?? 0);
+        }
+    }
+    const ops = [];
+    let i = 0;
+    let j = 0;
+    const push = (tag, i1, i2, j1, j2) => {
+        const last = ops[ops.length - 1];
+        if (last?.tag === tag && last.i2 === i1 && last.j2 === j1) {
+            last.i2 = i2;
+            last.j2 = j2;
+            return;
+        }
+        ops.push({ tag, i1, i2, j1, j2 });
+    };
+    while (i < n || j < m) {
+        if (i < n && j < m && a[i] === b[j]) {
+            push('equal', i, i + 1, j, j + 1);
+            i += 1;
+            j += 1;
+        }
+        else if (j < m && (i >= n || ((table[i])[j + 1] ?? 0) >= ((table[i + 1])?.[j] ?? 0))) {
+            push('insert', i, i, j, j + 1);
+            j += 1;
+        }
+        else {
+            push('delete', i, i + 1, j, j);
+            i += 1;
+        }
+    }
+    // Merge adjacent delete+insert pairs into replace blocks like difflib does.
+    const merged = [];
+    for (const op of ops) {
+        const last = merged[merged.length - 1];
+        if (last && ((last.tag === 'delete' && op.tag === 'insert') || (last.tag === 'insert' && op.tag === 'delete')) && last.i2 === op.i1 && last.j2 === op.j1) {
+            merged[merged.length - 1] = { tag: 'replace', i1: last.i1, i2: op.i2, j1: last.j1, j2: op.j2 };
+            continue;
+        }
+        merged.push({ ...op });
+    }
+    return merged;
+}
+function formatRange(start, stop) {
+    const beginning = start + 1;
+    const length = stop - start;
+    if (length === 1)
+        return String(beginning);
+    return `${String(length ? beginning : beginning - 1)},${String(length)}`;
+}
+export function unifiedDiff(a, b, fromFile, toFile, context = 3) {
+    const ops = opcodes(a, b);
+    const groups = [];
+    // difflib.SequenceMatcher.get_grouped_opcodes
+    let codes = ops.map((o) => ({ ...o }));
+    if (!codes.length)
+        codes = [{ tag: 'equal', i1: 0, i2: 1, j1: 0, j2: 1 }];
+    const first = codes[0];
+    if (first?.tag === 'equal')
+        Object.assign(first, { i1: Math.max(first.i1, first.i2 - context), j1: Math.max(first.j1, first.j2 - context) });
+    const last = codes[codes.length - 1];
+    if (last?.tag === 'equal')
+        Object.assign(last, { i2: Math.min(last.i2, last.i1 + context), j2: Math.min(last.j2, last.j1 + context) });
+    const nn = context + context;
+    let group = [];
+    for (const op of codes) {
+        let { i1, j1 } = op;
+        const { i2, j2, tag } = op;
+        if (tag === 'equal' && i2 - i1 > nn) {
+            group.push({ tag, i1, i2: Math.min(i2, i1 + context), j1, j2: Math.min(j2, j1 + context) });
+            groups.push(group);
+            group = [];
+            i1 = Math.max(i1, i2 - context);
+            j1 = Math.max(j1, j2 - context);
+        }
+        group.push({ tag, i1, i2, j1, j2 });
+    }
+    if (group.length && !(group.length === 1 && group[0]?.tag === 'equal'))
+        groups.push(group);
+    const out = [];
+    let started = false;
+    for (const g of groups) {
+        if (!started) {
+            started = true;
+            out.push(`--- ${fromFile}`, `+++ ${toFile}`);
+        }
+        const gFirst = g[0];
+        const gLast = g[g.length - 1];
+        out.push(`@@ -${formatRange(gFirst.i1, gLast.i2)} +${formatRange(gFirst.j1, gLast.j2)} @@`);
+        for (const op of g) {
+            if (op.tag === 'equal') {
+                for (const line of a.slice(op.i1, op.i2))
+                    out.push(` ${line}`);
+                continue;
+            }
+            if (op.tag === 'replace' || op.tag === 'delete')
+                for (const line of a.slice(op.i1, op.i2))
+                    out.push(`-${line}`);
+            if (op.tag === 'replace' || op.tag === 'insert')
+                for (const line of b.slice(op.j1, op.j2))
+                    out.push(`+${line}`);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=diff.js.map

package/dist/text/diff.js.map

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

package/dist/text/markdown.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A small CommonMark-ish renderer for the HTML export (headings, paragraphs,
+ * fenced code, inline code, emphasis, links, images, lists, blockquotes,
+ * tables, rules). Output is escaped; raw HTML in the source is never emitted.
+ */
+export declare function escapeHtml(text: string): string;
+export declare function renderInline(text: string): string;
+export declare function renderMarkdown(text: string): string;