@nowline/embed 0.0.0-dev.20260601071750.g04bdff9

package/dist/pipeline.d.ts

@@ -0,0 +1,28 @@
+import { type ParseResult } from '@nowline/browser';
+import type { ThemeName } from '@nowline/layout';
+export interface EmbedRenderOptions {
+    theme?: ThemeName;
+    today?: Date;
+    locale?: string;
+    width?: number;
+    /**
+     * Override the deterministic id prefix used for in-SVG `<style>`
+     * scoping. Each block on a page should use a unique prefix so two
+     * roadmaps cannot bleed styles into each other; the auto-scan path
+     * generates a per-block prefix and threads it here.
+     */
+    idPrefix?: string;
+}
+export interface EmbedParseResult {
+    ast: ParseResult['ast'];
+    /** Lexer + parser + Langium validation diagnostics, normalized to strings. */
+    errors: string[];
+}
+export declare function parseSource(source: string): Promise<EmbedParseResult>;
+export declare function renderSource(source: string, options?: EmbedRenderOptions): Promise<string>;
+export declare class EmbedRenderError extends Error {
+    readonly details: string[];
+    constructor(message: string, details: string[]);
+}
+export declare function __resetEmbedPipelineForTests(): void;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAcA,OAAO,EAMH,KAAK,WAAW,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,WAAW,kBAAkB;IAC/B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACxB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAID,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU3E;AAED,wBAAsB,YAAY,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAGnB,OAAO,EAAE,MAAM,EAAE;gBADjC,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,MAAM,EAAE;CAKxC;AAKD,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD"}

package/dist/pipeline.js

@@ -0,0 +1,65 @@
+// Thin shim around `@nowline/browser`'s pipeline. The browser package
+// owns parse / resolveIncludes / layout / render; the embed layers two
+// embed-specific behaviours on top:
+//
+//  - Throws `EmbedRenderError` on failure instead of returning a
+//    discriminated union. The Mermaid-compatible `nowline.render(source)`
+//    surface promises a string; throwing matches the documented v1
+//    contract and keeps the auto-scan path's per-block error handling
+//    simple.
+//  - Latches a once-per-page-load `console.warn` the first time an
+//    `include` directive is encountered. The browser pipeline emits a
+//    structured callback for each skip; the embed converts that into a
+//    single, deduped user-visible message.
+import { __resetBrowserPipelineForTests, parseSource as browserParseSource, renderSource as browserRenderSource, } from '@nowline/browser';
+const EMBED_SOURCE_PATH = '/embed.nowline';
+let includeWarningEmitted = false;
+export async function parseSource(source) {
+    const { ast, diagnostics } = await browserParseSource(source, {
+        filePath: EMBED_SOURCE_PATH,
+    });
+    return {
+        ast,
+        errors: diagnostics
+            .filter((d) => d.severity === 'error')
+            .map((d) => d.message),
+    };
+}
+export async function renderSource(source, options = {}) {
+    const browserOptions = {
+        filePath: EMBED_SOURCE_PATH,
+        theme: options.theme,
+        today: options.today,
+        locale: options.locale,
+        width: options.width,
+        idPrefix: options.idPrefix,
+        onSkippedInclude: () => {
+            if (!includeWarningEmitted) {
+                includeWarningEmitted = true;
+                console.warn('nowline: `include` directives are skipped in the browser embed (single-file mode). ' +
+                    'Render multi-file roadmaps with the CLI or the GitHub Action.');
+            }
+        },
+    };
+    const result = await browserRenderSource(source, browserOptions);
+    if (result.kind === 'svg')
+        return result.svg;
+    const messages = result.diagnostics.filter((d) => d.severity === 'error').map((d) => d.message);
+    throw new EmbedRenderError(`Failed to render Nowline source: ${messages.join('; ')}`, messages);
+}
+export class EmbedRenderError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = 'EmbedRenderError';
+    }
+}
+// Test-only escape hatch. The console.warn is intentionally emitted at
+// most once per page load; tests that exercise the warning path need to
+// reset the latch between cases.
+export function __resetEmbedPipelineForTests() {
+    includeWarningEmitted = false;
+    __resetBrowserPipelineForTests();
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,uEAAuE;AACvE,oCAAoC;AACpC,EAAE;AACF,iEAAiE;AACjE,0EAA0E;AAC1E,mEAAmE;AACnE,sEAAsE;AACtE,aAAa;AACb,mEAAmE;AACnE,sEAAsE;AACtE,uEAAuE;AACvE,2CAA2C;AAE3C,OAAO,EACH,8BAA8B,EAE9B,WAAW,IAAI,kBAAkB,EACjC,YAAY,IAAI,mBAAmB,GAGtC,MAAM,kBAAkB,CAAC;AAG1B,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAsB3C,IAAI,qBAAqB,GAAG,KAAK,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc;IAC5C,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE;QAC1D,QAAQ,EAAE,iBAAiB;KAC9B,CAAC,CAAC;IACH,OAAO;QACH,GAAG;QACH,MAAM,EAAE,WAAW;aACd,MAAM,CAAC,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;aACpD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KAC7B,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,MAAc,EACd,UAA8B,EAAE;IAEhC,MAAM,cAAc,GAAyB;QACzC,QAAQ,EAAE,iBAAiB;QAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,gBAAgB,EAAE,GAAG,EAAE;YACnB,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBACzB,qBAAqB,GAAG,IAAI,CAAC;gBAC7B,OAAO,CAAC,IAAI,CACR,qFAAqF;oBACjF,+DAA+D,CACtE,CAAC;YACN,CAAC;QACL,CAAC;KACJ,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACjE,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAE7C,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAChG,MAAM,IAAI,gBAAgB,CAAC,oCAAoC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGnB;IAFpB,YACI,OAAe,EACC,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ;AAED,uEAAuE;AACvE,wEAAwE;AACxE,iCAAiC;AACjC,MAAM,UAAU,4BAA4B;IACxC,qBAAqB,GAAG,KAAK,CAAC;IAC9B,8BAA8B,EAAE,CAAC;AACrC,CAAC"}

package/dist/share.d.ts

@@ -0,0 +1,45 @@
+export declare const DEFAULT_SHARE_BASE = "https://free.nowline.io/open";
+/**
+ * The `share` initialize option selects where share links point.
+ *
+ * - `true` — use DEFAULT_SHARE_BASE (the default).
+ * - `string` — a base URL with optional path; built via the URL API so
+ *   `https://foo.com/open` → `https://foo.com/open#text=…`.
+ * - `false` / `'none'` — disable the share anchor entirely.
+ * - `{ textUrl, remoteUrl }` — escape hatch for non-hash URL shapes;
+ *   `{text}` substituted with the base64url payload, `{url}` with the
+ *   percent-encoded source URL.
+ */
+export type ShareOption = boolean | 'none' | string | {
+    textUrl: string;
+    remoteUrl: string;
+};
+/**
+ * Encode source text → `#text=<base64url(zlib(utf8(source)))>`.
+ *
+ * The return value includes the `#text=` key so callers can use it
+ * directly as a URL fragment.
+ *
+ * Sync, single code path, no feature-detect.
+ */
+export declare function encodeText(source: string): string;
+export interface BuildShareLinkOptions {
+    /** The roadmap source text (used to build the #text= fragment). */
+    source: string;
+    /**
+     * Resolved source URL for the block (per-block → global → undefined).
+     * Only `https:` URLs are emitted as `#url=`; anything else falls
+     * back to the inline `#text=` encoding.
+     */
+    sourceUrl?: string | undefined;
+    /** The `share` option from InitializeOptions. */
+    share: ShareOption;
+}
+/**
+ * Build the full "Share on Nowline" URL for a rendered block.
+ *
+ * Returns `null` when `share` is `false` or `'none'`, signalling that
+ * no anchor should be rendered.
+ */
+export declare function buildShareLink({ source, sourceUrl, share }: BuildShareLinkOptions): string | null;
+//# sourceMappingURL=share.d.ts.map

package/dist/share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7F;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAgBD,MAAM,WAAW,qBAAqB;IAClC,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iDAAiD;IACjD,KAAK,EAAE,WAAW,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAwBjG"}

package/dist/share.js

@@ -0,0 +1,75 @@
+// Share-link generation for the "Share on Nowline" anchor that the
+// auto-scan loop appends after each rendered SVG.
+//
+// Encoding grammar (normative — defined in specs/embed.md):
+//   #text=base64url(zlib(utf8(source)))
+//   #url=<https-url>
+//
+// zlib = RFC 1950 via fflate zlibSync (byte-compatible with native
+// CompressionStream('deflate')); base64url strips padding and maps
+// +→- /→_.
+//
+// Sync, works on every browser, no feature-detect.
+import { zlibSync } from 'fflate';
+export const DEFAULT_SHARE_BASE = 'https://free.nowline.io/open';
+/**
+ * Encode source text → `#text=<base64url(zlib(utf8(source)))>`.
+ *
+ * The return value includes the `#text=` key so callers can use it
+ * directly as a URL fragment.
+ *
+ * Sync, single code path, no feature-detect.
+ */
+export function encodeText(source) {
+    return `#text=${_encodePayload(source)}`;
+}
+/** base64url(zlib(utf8(source))) without the `#text=` prefix. */
+function _encodePayload(source) {
+    const bytes = new TextEncoder().encode(source);
+    const compressed = zlibSync(bytes);
+    // Convert Uint8Array to binary string for btoa. Chunked to avoid
+    // call-stack limits on large payloads.
+    const chunk = 0x8000; // 32 KB — safe below JS engine stack limits
+    let bin = '';
+    for (let i = 0; i < compressed.length; i += chunk) {
+        bin += String.fromCharCode(...compressed.subarray(i, i + chunk));
+    }
+    return btoa(bin).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+/**
+ * Build the full "Share on Nowline" URL for a rendered block.
+ *
+ * Returns `null` when `share` is `false` or `'none'`, signalling that
+ * no anchor should be rendered.
+ */
+export function buildShareLink({ source, sourceUrl, share }) {
+    if (share === false || share === 'none') {
+        return null;
+    }
+    if (typeof share === 'object') {
+        // Template mode: { textUrl, remoteUrl }
+        if (sourceUrl !== undefined && _isHttps(sourceUrl)) {
+            return share.remoteUrl.replace('{url}', encodeURIComponent(sourceUrl));
+        }
+        return share.textUrl.replace('{text}', _encodePayload(source));
+    }
+    // share === true → DEFAULT_SHARE_BASE; share is a string → custom base URL
+    const base = share === true ? DEFAULT_SHARE_BASE : share;
+    const url = new URL(base);
+    if (sourceUrl !== undefined && _isHttps(sourceUrl)) {
+        url.hash = `url=${encodeURIComponent(sourceUrl)}`;
+    }
+    else {
+        url.hash = `text=${_encodePayload(source)}`;
+    }
+    return url.toString();
+}
+function _isHttps(url) {
+    try {
+        return new URL(url).protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=share.js.map

package/dist/share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,kDAAkD;AAClD,EAAE;AACF,4DAA4D;AAC5D,wCAAwC;AACxC,qBAAqB;AACrB,EAAE;AACF,mEAAmE;AACnE,mEAAmE;AACnE,WAAW;AACX,EAAE;AACF,mDAAmD;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,MAAM,CAAC,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAejE;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACrC,OAAO,SAAS,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7C,CAAC;AAED,iEAAiE;AACjE,SAAS,cAAc,CAAC,MAAc;IAClC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,iEAAiE;IACjE,uCAAuC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,4CAA4C;IAClE,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAChD,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC;AAeD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAyB;IAC9E,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,wCAAwC;QACxC,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,2EAA2E;IAC3E,MAAM,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC;IACzD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAE1B,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,IAAI,GAAG,OAAO,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;IACtD,CAAC;SAAM,CAAC;QACJ,GAAG,CAAC,IAAI,GAAG,QAAQ,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IACzB,IAAI,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC"}

package/dist/theme.d.ts

@@ -0,0 +1,5 @@
+import { type ThemeName } from '@nowline/layout';
+export type EmbedTheme = ThemeName | 'greyscale' | 'auto';
+export declare function resolveSystemTheme(): 'light' | 'dark';
+export declare function effectiveTheme(theme: EmbedTheme | undefined, systemTheme: ThemeName): ThemeName;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAeA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGrE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAE1D,wBAAgB,kBAAkB,IAAI,OAAO,GAAG,MAAM,CASrD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE,WAAW,EAAE,SAAS,GAAG,SAAS,CAG/F"}

package/dist/theme.js

@@ -0,0 +1,34 @@
+// Theme resolution for the embed.
+//
+// Precedence (highest to lowest):
+//   1. `initialize({ theme })` flag (light / dark / grayscale / auto;
+//      `greyscale` is accepted and canonicalized to `grayscale`).
+//   2. The file's own `nowline v1 theme:` directive — handled inside
+//      layout, so we just don't override it when the embed config says
+//      `'auto'` and we have no system preference reading.
+//   3. The browser's `prefers-color-scheme` media query.
+//
+// `prefers-color-scheme` is read **once on init**, not reactively, so
+// flipping the OS theme mid-session does not cause every embedded
+// roadmap on the page to repaint. This matches Mermaid's posture and
+// keeps the embed deterministic for screenshot tools.
+import { normalizeThemeName } from '@nowline/layout';
+export function resolveSystemTheme() {
+    if (typeof globalThis === 'undefined')
+        return 'light';
+    const win = globalThis.matchMedia;
+    if (typeof win !== 'function')
+        return 'light';
+    try {
+        return win('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+    }
+    catch {
+        return 'light';
+    }
+}
+export function effectiveTheme(theme, systemTheme) {
+    if (theme && theme !== 'auto')
+        return normalizeThemeName(theme) ?? systemTheme;
+    return systemTheme;
+}
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,EAAE;AACF,kCAAkC;AAClC,sEAAsE;AACtE,kEAAkE;AAClE,qEAAqE;AACrE,uEAAuE;AACvE,0DAA0D;AAC1D,yDAAyD;AACzD,EAAE;AACF,sEAAsE;AACtE,kEAAkE;AAClE,qEAAqE;AACrE,sDAAsD;AAEtD,OAAO,EAAE,kBAAkB,EAAkB,MAAM,iBAAiB,CAAC;AAKrE,MAAM,UAAU,kBAAkB;IAC9B,IAAI,OAAO,UAAU,KAAK,WAAW;QAAE,OAAO,OAAO,CAAC;IACtD,MAAM,GAAG,GAAI,UAAmE,CAAC,UAAU,CAAC;IAC5F,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,CAAC;QACD,OAAO,GAAG,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,OAAO,CAAC;IACnB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAA6B,EAAE,WAAsB;IAChF,IAAI,KAAK,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC;IAC/E,OAAO,WAAW,CAAC;AACvB,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@nowline/embed",
+  "version": "0.0.0-dev.20260601071750.g04bdff9",
+  "description": "Browser embed bundle for Nowline. Drop a <script> tag and ```nowline``` blocks render in place.",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22",
+    "pnpm": ">=11"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lolay/nowline.git",
+    "directory": "packages/embed"
+  },
+  "homepage": "https://github.com/lolay/nowline",
+  "bugs": {
+    "url": "https://github.com/lolay/nowline/issues"
+  },
+  "keywords": [
+    "nowline",
+    "roadmap",
+    "gantt",
+    "embed",
+    "browser",
+    "cdn"
+  ],
+  "dependencies": {
+    "fflate": "^0.8.3",
+    "langium": "~4.2.4",
+    "@nowline/browser": "0.0.0-dev.20260601071750.g04bdff9",
+    "@nowline/core": "0.0.0-dev.20260601071750.g04bdff9",
+    "@nowline/layout": "0.0.0-dev.20260601071750.g04bdff9",
+    "@nowline/renderer": "0.0.0-dev.20260601071750.g04bdff9"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "esbuild": "^0.28.0",
+    "happy-dom": "^20.9.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json && node scripts/bundle.mjs",
+    "watch": "tsc -b tsconfig.json --watch",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "bundle": "node scripts/bundle.mjs",
+    "check-size": "node scripts/check-size.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/auto-scan.ts

@@ -0,0 +1,149 @@
+// DOM scanner that finds `<pre><code class="language-nowline">…</code></pre>`
+// blocks (or whatever selector the caller registered) and replaces each
+// with its rendered SVG. Each block gets a unique `idPrefix` so two
+// roadmaps on the same page never share `<style>` ids.
+
+import type { ThemeName } from '@nowline/layout';
+import { type EmbedRenderOptions, renderSource } from './pipeline.js';
+import { buildShareLink, type ShareOption } from './share.js';
+
+export interface AutoScanInputs {
+    selector: string;
+    theme?: ThemeName;
+    locale?: string;
+    width?: number;
+    today?: Date;
+    /**
+     * Controls the "Share on Nowline" anchor appended after each rendered
+     * SVG. Defaults to `true` when omitted (mirrors the config default).
+     */
+    share?: ShareOption;
+    /**
+     * Global source URL for all blocks. Per-block `data-nowline-source-url`
+     * overrides this for individual blocks.
+     */
+    sourceUrl?: string;
+    /**
+     * Document to scan. Defaults to `globalThis.document`. Tests inject
+     * a happy-dom document; the IIFE running on a real page picks up
+     * the live document.
+     */
+    document?: Document;
+}
+
+export interface AutoScanResult {
+    /** Number of code blocks that were successfully replaced with SVG. */
+    rendered: number;
+    /** Number of blocks that failed to render (logged to console.error). */
+    failed: number;
+}
+
+let runCounter = 0;
+
+export async function runAutoScan(inputs: AutoScanInputs): Promise<AutoScanResult> {
+    const doc = inputs.document ?? (globalThis as { document?: Document }).document;
+    if (!doc) {
+        return { rendered: 0, failed: 0 };
+    }
+
+    const blocks = doc.querySelectorAll<HTMLElement>(inputs.selector);
+    let rendered = 0;
+    let failed = 0;
+    const baseRunId = ++runCounter;
+
+    // share defaults to true when omitted (mirrors config.share default)
+    const share: ShareOption = inputs.share ?? true;
+
+    const tasks: Array<Promise<void>> = [];
+    let blockIndex = 0;
+    for (const code of Array.from(blocks)) {
+        const target = pickReplacementTarget(code);
+        if (!target) {
+            continue;
+        }
+        const source = readBlockSource(code);
+        const idPrefix = `nl-r${baseRunId}-${blockIndex++}`;
+        const opts: EmbedRenderOptions = {
+            theme: inputs.theme,
+            locale: inputs.locale,
+            width: inputs.width,
+            today: inputs.today,
+            idPrefix,
+        };
+
+        // Capture DOM position before the async render. outerHTML replacement
+        // detaches `target` from the tree, so parent and nextSibling must be
+        // read now. The share anchor is inserted at the saved nextSibling
+        // position, which lands it as the immediate next sibling of the SVG.
+        const parent = target.parentElement;
+        const nextSibling = target.nextSibling;
+
+        // Per-block resolution order: data-nowline-source-url → global sourceUrl
+        const perBlockUrl = code.getAttribute('data-nowline-source-url') ?? undefined;
+        const resolvedSourceUrl = perBlockUrl ?? inputs.sourceUrl;
+
+        tasks.push(
+            renderSource(source, opts).then(
+                (svg) => {
+                    replaceWithSvg(target, svg);
+                    rendered++;
+                    if (parent !== null) {
+                        const href = buildShareLink({
+                            source,
+                            sourceUrl: resolvedSourceUrl,
+                            share,
+                        });
+                        if (href !== null) {
+                            const a = doc.createElement('a');
+                            a.className = 'nowline-share';
+                            a.href = href;
+                            a.target = '_blank';
+                            a.rel = 'noopener noreferrer';
+                            a.textContent = 'Share on Nowline';
+                            parent.insertBefore(a, nextSibling);
+                        }
+                    }
+                },
+                (err: unknown) => {
+                    failed++;
+                    console.error('nowline: render failed', err);
+                },
+            ),
+        );
+    }
+
+    await Promise.all(tasks);
+    return { rendered, failed };
+}
+
+// Markdown-rendered Nowline blocks usually look like
+// `<pre><code class="language-nowline">…</code></pre>`. We replace the
+// outer `<pre>` so the spacing the markdown processor reserved for the
+// fenced block is reused by the SVG. When the matched element has no
+// `<pre>` ancestor (custom hosting) we replace the matched element
+// itself.
+function pickReplacementTarget(matched: HTMLElement): HTMLElement | null {
+    const parent = matched.parentElement;
+    if (parent && parent.tagName.toUpperCase() === 'PRE') {
+        return parent;
+    }
+    return matched;
+}
+
+function readBlockSource(code: HTMLElement): string {
+    // `textContent` preserves whitespace and newlines; `innerText` would
+    // collapse them per CSS, which would corrupt indentation-sensitive
+    // .nowline source.
+    return code.textContent ?? '';
+}
+
+function replaceWithSvg(target: HTMLElement, svg: string): void {
+    // `outerHTML` parses the SVG string into a real `<svg>` element and
+    // swaps it into the DOM, preserving each render's per-`idPrefix`
+    // `<style>` scope so two blocks on the page can never bleed styles.
+    target.outerHTML = svg;
+}
+
+export function __resetAutoScanForTests(): void {
+    runCounter = 0;
+}