@nowline/browser 0.4.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Lolay, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/diagnostic-row.d.ts

@@ -0,0 +1,68 @@
+import type { ResolveDiagnostic } from '@nowline/core';
+/**
+ * JSON-friendly diagnostic shape consumed by browser preview surfaces.
+ *
+ * Single source of truth shared by the VS Code preview's webview table,
+ * the embed's error path, and any other browser tool that wants
+ * structured Nowline diagnostics. Field semantics mirror VS Code's
+ * Problems panel: `line` and `column` are 1-based (the editor displays
+ * "Ln 12, Col 5"); `file` is an absolute fs path (or a synthetic
+ * embed-side path) so callers can map back to a source location.
+ */
+export interface DiagnosticRow {
+    severity: 'error' | 'warning';
+    code: string;
+    message: string;
+    suggestion?: string;
+    file: string;
+    line: number;
+    column: number;
+}
+/** Minimal LSP-style diagnostic shape. Mirrors `LangiumLikeDiagnostic` in the CLI. */
+export interface LangiumLikeDiagnostic {
+    message: string;
+    severity?: number;
+    code?: string | number;
+    range?: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+}
+interface ChevrotainParserError {
+    message: string;
+    token?: {
+        startLine?: number;
+        startColumn?: number;
+    };
+}
+interface ChevrotainLexerError {
+    message: string;
+    line?: number;
+    column?: number;
+}
+export declare function fromLangiumDiagnostic(diag: LangiumLikeDiagnostic, file: string): DiagnosticRow;
+export declare function fromParserError(err: ChevrotainParserError, file: string): DiagnosticRow;
+export declare function fromLexerError(err: ChevrotainLexerError, file: string): DiagnosticRow;
+/**
+ * Adapt a `ResolveDiagnostic` (cross-file include resolution). The line
+ * is 0-based in the resolver (it comes from a CST range) and may be
+ * undefined for whole-file diagnostics like circular include — fall
+ * back to line 1 so a click-to-jump still puts the cursor near the top
+ * of the offending file.
+ */
+export declare function fromResolveDiagnostic(diag: ResolveDiagnostic): DiagnosticRow;
+/**
+ * Adapt a render-time warning message into a diagnostic row. Renderer
+ * warnings are bare strings without a source location, so callers
+ * supply the source `file`; in `strict` mode the caller upgrades
+ * severity to `error` before passing the result on.
+ */
+export declare function fromRenderWarning(message: string, file: string, severity?: DiagnosticRow['severity']): DiagnosticRow;
+export {};
+//# sourceMappingURL=diagnostic-row.d.ts.map

package/dist/diagnostic-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-row.d.ts","sourceRoot":"","sources":["../src/diagnostic-row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,sFAAsF;AACtF,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE;QACJ,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5C,CAAC;CACL;AAED,UAAU,qBAAqB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAED,UAAU,oBAAoB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAU9F;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CASvF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CASrF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAS5E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,aAAa,CAAC,UAAU,CAAa,GAChD,aAAa,CASf"}

package/dist/diagnostic-row.js

@@ -0,0 +1,95 @@
+const DID_YOU_MEAN_RE = /did you mean ['"]?([^'"?]+)['"]?\??/i;
+export function fromLangiumDiagnostic(diag, file) {
+    return {
+        severity: diag.severity === 2 ? 'warning' : 'error',
+        code: diagnosticCode(diag),
+        message: diag.message,
+        suggestion: extractSuggestion(diag.message),
+        file,
+        line: (diag.range?.start.line ?? 0) + 1,
+        column: (diag.range?.start.character ?? 0) + 1,
+    };
+}
+export function fromParserError(err, file) {
+    return {
+        severity: 'error',
+        code: 'parse-error',
+        message: err.message,
+        file,
+        line: err.token?.startLine ?? 1,
+        column: err.token?.startColumn ?? 1,
+    };
+}
+export function fromLexerError(err, file) {
+    return {
+        severity: 'error',
+        code: 'lex-error',
+        message: err.message,
+        file,
+        line: err.line ?? 1,
+        column: err.column ?? 1,
+    };
+}
+/**
+ * Adapt a `ResolveDiagnostic` (cross-file include resolution). The line
+ * is 0-based in the resolver (it comes from a CST range) and may be
+ * undefined for whole-file diagnostics like circular include — fall
+ * back to line 1 so a click-to-jump still puts the cursor near the top
+ * of the offending file.
+ */
+export function fromResolveDiagnostic(diag) {
+    return {
+        severity: diag.severity,
+        code: 'include',
+        message: diag.message,
+        file: diag.sourcePath,
+        line: diag.line !== undefined ? diag.line + 1 : 1,
+        column: 1,
+    };
+}
+/**
+ * Adapt a render-time warning message into a diagnostic row. Renderer
+ * warnings are bare strings without a source location, so callers
+ * supply the source `file`; in `strict` mode the caller upgrades
+ * severity to `error` before passing the result on.
+ */
+export function fromRenderWarning(message, file, severity = 'warning') {
+    return {
+        severity,
+        code: 'render.warning',
+        message,
+        file,
+        line: 1,
+        column: 1,
+    };
+}
+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';
+}
+function extractSuggestion(message) {
+    const match = message.match(DID_YOU_MEAN_RE);
+    return match ? match[1].trim() : undefined;
+}
+//# sourceMappingURL=diagnostic-row.js.map

package/dist/diagnostic-row.js.map

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

package/dist/generated/showcase.d.ts

@@ -0,0 +1,2 @@
+export declare const showcaseSource = "nowline v1\n\nroadmap showcase \"Nowline Showcase\" start:2026-01-05 scale:1m author:\"Nowline\"\n\nanchor kickoff date:2026-01-05\n\nswimlane engineering \"Engineering\"\n  item design \"Design spec\" duration:2w after:kickoff status:done\n  parallel after:design\n    group build \"Build\"\n      item api \"API surface\" duration:3w status:in-progress remaining:1w\n      item ui \"Web client\" duration:3w status:in-progress remaining:2w\n    item integrate \"Integration tests\" duration:2w\n  item ship \"Ship\" duration:1w after:integrate\n\nswimlane marketing \"Marketing\"\n  item brief \"Launch brief\" duration:1w after:kickoff status:done\n  item assets \"Launch assets\" duration:3w after:brief\n  item announce \"Announcement\" duration:1w after:ship\n\nmilestone launch \"Launch\" after:[ship, announce]\n";
+//# sourceMappingURL=showcase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"showcase.d.ts","sourceRoot":"","sources":["../../src/generated/showcase.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,yzBAAyzB,CAAC"}

package/dist/generated/showcase.js

@@ -0,0 +1,5 @@
+// AUTO-GENERATED by `packages/browser/scripts/bundle-showcase.mjs`.
+// Do not edit by hand; this file is regenerated from
+// `examples/showcase.nowline` on every build / test run.
+export const showcaseSource = "nowline v1\n\nroadmap showcase \"Nowline Showcase\" start:2026-01-05 scale:1m author:\"Nowline\"\n\nanchor kickoff date:2026-01-05\n\nswimlane engineering \"Engineering\"\n  item design \"Design spec\" duration:2w after:kickoff status:done\n  parallel after:design\n    group build \"Build\"\n      item api \"API surface\" duration:3w status:in-progress remaining:1w\n      item ui \"Web client\" duration:3w status:in-progress remaining:2w\n    item integrate \"Integration tests\" duration:2w\n  item ship \"Ship\" duration:1w after:integrate\n\nswimlane marketing \"Marketing\"\n  item brief \"Launch brief\" duration:1w after:kickoff status:done\n  item assets \"Launch assets\" duration:3w after:brief\n  item announce \"Announcement\" duration:1w after:ship\n\nmilestone launch \"Launch\" after:[ship, announce]\n";
+//# sourceMappingURL=showcase.js.map

package/dist/generated/showcase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase.js","sourceRoot":"","sources":["../../src/generated/showcase.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,qDAAqD;AACrD,yDAAyD;AAEzD,MAAM,CAAC,MAAM,cAAc,GAAG,szBAAszB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { type DiagnosticRow, fromLangiumDiagnostic, fromLexerError, fromParserError, fromRenderWarning, fromResolveDiagnostic, type LangiumLikeDiagnostic, } from './diagnostic-row.js';
+export { showcaseSource } from './generated/showcase.js';
+export { isNoOpIncludeDiagnosticMessage, NOWLINE_BROWSER_NOOP_INCLUDE_TAG, noOpIncludeReadFile, type SkippedInclude, } from './no-op-include-resolver.js';
+export { __resetBrowserPipelineForTests, DEFAULT_SYNTHETIC_PATH, type ParseOptions, type ParseResult, parseSource, type RenderOptions, type RenderResult, renderSource, } from './pipeline.js';
+//# 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":"AASA,OAAO,EACH,KAAK,aAAa,EAClB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,qBAAqB,GAC7B,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EACH,8BAA8B,EAC9B,gCAAgC,EAChC,mBAAmB,EACnB,KAAK,cAAc,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,8BAA8B,EAC9B,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,YAAY,GACf,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// Public API for `@nowline/browser`.
+//
+// The package's job is to give every browser-side surface (the embed
+// CDN bundle, the VS Code preview, the Free SPA, and any third-party
+// tool) the same parse → resolveIncludes → layout → render pipeline so
+// behaviour cannot drift between them. Surface-specific concerns (DOM
+// auto-scan, postMessage transport, save/copy commands) belong in the
+// consumer; this package stays a pure data transform.
+export { fromLangiumDiagnostic, fromLexerError, fromParserError, fromRenderWarning, fromResolveDiagnostic, } from './diagnostic-row.js';
+// Showcase source string is generated from `examples/showcase.nowline`
+// by `scripts/bundle-showcase.mjs` (m4.7 slice F) and re-exported here
+// for empty-state content in browser SPAs.
+export { showcaseSource } from './generated/showcase.js';
+export { isNoOpIncludeDiagnosticMessage, NOWLINE_BROWSER_NOOP_INCLUDE_TAG, noOpIncludeReadFile, } from './no-op-include-resolver.js';
+export { __resetBrowserPipelineForTests, DEFAULT_SYNTHETIC_PATH, parseSource, renderSource, } from './pipeline.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,EAAE;AACF,qEAAqE;AACrE,qEAAqE;AACrE,uEAAuE;AACvE,sEAAsE;AACtE,sEAAsE;AACtE,sDAAsD;AAEtD,OAAO,EAEH,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,qBAAqB,GAExB,MAAM,qBAAqB,CAAC;AAC7B,uEAAuE;AACvE,uEAAuE;AACvE,2CAA2C;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EACH,8BAA8B,EAC9B,gCAAgC,EAChC,mBAAmB,GAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,8BAA8B,EAC9B,sBAAsB,EAGtB,WAAW,EAGX,YAAY,GACf,MAAM,eAAe,CAAC"}

package/dist/no-op-include-resolver.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Browser-side `readFile` that always rejects with a stable, sniff-able
+ * error tag. The pipeline catches matching include diagnostics and
+ * surfaces them through the `onSkippedInclude` callback so callers can
+ * implement their own warn-once-per-page behaviour without inheriting
+ * a `console.warn` side effect from this package.
+ *
+ * A real HTTP-fetch resolver is intentionally out of scope here (see
+ * `specs/handoffs/handoff-m4-embed.md`): CORS, relative-URL semantics,
+ * and waterfall performance each warrant their own decision and are
+ * best handled behind an opt-in flag in a follow-up.
+ */
+export declare const NOWLINE_BROWSER_NOOP_INCLUDE_TAG = "__nowline_browser_noop_include__";
+export declare function noOpIncludeReadFile(absPath: string): Promise<string>;
+export declare function isNoOpIncludeDiagnosticMessage(message: string): boolean;
+export interface SkippedInclude {
+    /** Absolute path of the include that was skipped. */
+    sourcePath: string;
+    /** The diagnostic message verbatim, including the sniff tag. */
+    message: string;
+}
+//# sourceMappingURL=no-op-include-resolver.d.ts.map

package/dist/no-op-include-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op-include-resolver.d.ts","sourceRoot":"","sources":["../src/no-op-include-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AAEnF,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1E;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,MAAM,WAAW,cAAc;IAC3B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;CACnB"}

package/dist/no-op-include-resolver.js

@@ -0,0 +1,20 @@
+/**
+ * Browser-side `readFile` that always rejects with a stable, sniff-able
+ * error tag. The pipeline catches matching include diagnostics and
+ * surfaces them through the `onSkippedInclude` callback so callers can
+ * implement their own warn-once-per-page behaviour without inheriting
+ * a `console.warn` side effect from this package.
+ *
+ * A real HTTP-fetch resolver is intentionally out of scope here (see
+ * `specs/handoffs/handoff-m4-embed.md`): CORS, relative-URL semantics,
+ * and waterfall performance each warrant their own decision and are
+ * best handled behind an opt-in flag in a follow-up.
+ */
+export const NOWLINE_BROWSER_NOOP_INCLUDE_TAG = '__nowline_browser_noop_include__';
+export async function noOpIncludeReadFile(absPath) {
+    throw new Error(`${NOWLINE_BROWSER_NOOP_INCLUDE_TAG}: include "${absPath}" was skipped — running in single-file mode.`);
+}
+export function isNoOpIncludeDiagnosticMessage(message) {
+    return message.includes(NOWLINE_BROWSER_NOOP_INCLUDE_TAG);
+}
+//# sourceMappingURL=no-op-include-resolver.js.map

package/dist/no-op-include-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op-include-resolver.js","sourceRoot":"","sources":["../src/no-op-include-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,kCAAkC,CAAC;AAEnF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAe;IACrD,MAAM,IAAI,KAAK,CACX,GAAG,gCAAgC,cAAc,OAAO,8CAA8C,CACzG,CAAC;AACN,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAAe;IAC1D,OAAO,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,96 @@
+import { type NowlineFile } from '@nowline/core';
+import { type ThemeName } from '@nowline/layout';
+import { type AssetResolver } from '@nowline/renderer';
+import { type DiagnosticRow } from './diagnostic-row.js';
+import { type SkippedInclude } from './no-op-include-resolver.js';
+/**
+ * Synthetic path stamped on diagnostics that have no real source file
+ * (the embed renders strings, not files). Consumers can re-key it to
+ * a more user-meaningful label by setting `filePath`.
+ */
+export declare const DEFAULT_SYNTHETIC_PATH = "/browser-source.nowline";
+export interface ParseOptions {
+    /**
+     * Absolute path (or synthetic path) used to seed include resolution
+     * and tag parse/validation diagnostics. Defaults to a synthetic
+     * `/browser-source.nowline` so embedded blocks have a stable label.
+     */
+    filePath?: string;
+    /**
+     * Callback that resolves an `include "..."` directive to file
+     * contents. When omitted, falls back to `noOpIncludeReadFile`
+     * (every include is skipped and surfaced via `onSkippedInclude`).
+     * VS Code passes a Node `fs.readFile` shim; the embed passes
+     * nothing.
+     */
+    readFile?: (absPath: string) => Promise<string>;
+    /**
+     * Fires once per skipped include when the noop reader rejects it.
+     * Use this to surface a single page-level warning without coupling
+     * the pipeline to `console.warn`.
+     */
+    onSkippedInclude?: (info: SkippedInclude) => void;
+}
+export interface ParseResult {
+    ast: NowlineFile;
+    diagnostics: DiagnosticRow[];
+}
+export interface RenderOptions extends ParseOptions {
+    theme?: ThemeName;
+    /**
+     * "Today" override threaded into the layout engine. Pass an
+     * explicit `Date` for deterministic snapshots; pass `null` to
+     * suppress the now-line entirely (mirrors the CLI's `--now -`);
+     * leave undefined to use `new Date()` per render.
+     */
+    today?: Date | null;
+    /** BCP-47 locale forwarded to the layout engine for axis labels. */
+    locale?: string;
+    /** Total canvas width in px. Layout's default is 1280. */
+    width?: number;
+    /**
+     * Override the deterministic id prefix used for in-SVG `<style>`
+     * scoping. Multi-block surfaces (auto-scan) supply a fresh prefix
+     * per block so two roadmaps cannot bleed styles into each other.
+     */
+    idPrefix?: string;
+    /** Inverse of the CLI's `--no-links`. When false, link icons are dropped. */
+    showLinks?: boolean;
+    /** Promote renderer warnings to errors in the diagnostic table. */
+    strict?: boolean;
+    /**
+     * Asset resolver invoked by the renderer for image references
+     * (`icon:` declarations, etc.). When omitted, image assets are
+     * silently dropped — match the embed's "no filesystem" posture.
+     */
+    assetResolver?: AssetResolver;
+}
+export type RenderResult = {
+    kind: 'svg';
+    svg: string;
+    warnings: DiagnosticRow[];
+} | {
+    kind: 'diagnostics';
+    diagnostics: DiagnosticRow[];
+};
+/**
+ * Parse + validate the source. Returns the AST plus any diagnostics
+ * normalized to the shared {@link DiagnosticRow} shape. Does not run
+ * include resolution, layout, or rendering — useful for editor
+ * experiences that want diagnostics without paying the render cost.
+ */
+export declare function parseSource(source: string, options?: ParseOptions): Promise<ParseResult>;
+/**
+ * Run the full pipeline (parse + validate + resolveIncludes + layout
+ * + render) and return either the SVG or a list of diagnostics. The
+ * `RenderResult` discriminated union mirrors the CLI's success/failure
+ * split so callers can render either path without try/catch plumbing.
+ */
+export declare function renderSource(source: string, options?: RenderOptions): Promise<RenderResult>;
+/**
+ * Test-only escape hatch. Resets cached Langium services and the
+ * URI counter between cases so a `parseSource` failure in one test
+ * doesn't poison the next one's document builder.
+ */
+export declare function __resetBrowserPipelineForTests(): 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":"AAmBA,OAAO,EAEH,KAAK,WAAW,EAGnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,mBAAmB,CAAC;AAElE,OAAO,EACH,KAAK,aAAa,EAOrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGH,KAAK,cAAc,EACtB,MAAM,6BAA6B,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE,MAAM,WAAW,YAAY;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,aAAa,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IAC/C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC;AAqB5D;;;;;GAKG;AACH,wBAAsB,WAAW,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAiB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAkBtB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,aAAkB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAyDvB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD"}

package/dist/pipeline.js

@@ -0,0 +1,131 @@
+// Browser-safe render pipeline shared by every browser surface that
+// needs to turn `.nowline` source into SVG. Consolidates two prior
+// implementations:
+//
+//  - `packages/embed/src/pipeline.ts` (single-file, no Node, throws on
+//    error, fires a console.warn the first time an include is skipped).
+//  - `packages/vscode-extension/src/preview/render-pipeline.ts` (full
+//    options matrix incl. Node-backed include resolver + asset resolver,
+//    returns a discriminated union instead of throwing).
+//
+// The seam between them is dependency injection. Callers that have
+// access to a filesystem (VS Code, future Node browsers) supply a
+// `readFile` callback and an `assetResolver`; callers that don't (embed,
+// Free SPA) omit both, get the noop include reader, and receive a
+// `SkippedInclude` callback when an `include` directive is encountered.
+//
+// The package itself imports zero `node:*` modules so the embed esbuild
+// bundle stays free of any Node literal even before tree-shaking.
+import { createNowlineServices, resolveIncludes, } from '@nowline/core';
+import { layoutRoadmap } from '@nowline/layout';
+import { renderSvg } from '@nowline/renderer';
+import { URI } from 'langium';
+import { fromLangiumDiagnostic, fromLexerError, fromParserError, fromRenderWarning, fromResolveDiagnostic, } from './diagnostic-row.js';
+import { isNoOpIncludeDiagnosticMessage, noOpIncludeReadFile, } from './no-op-include-resolver.js';
+/**
+ * Synthetic path stamped on diagnostics that have no real source file
+ * (the embed renders strings, not files). Consumers can re-key it to
+ * a more user-meaningful label by setting `filePath`.
+ */
+export const DEFAULT_SYNTHETIC_PATH = '/browser-source.nowline';
+let cachedServices;
+let docCounter = 0;
+function getServices() {
+    if (!cachedServices)
+        cachedServices = createNowlineServices();
+    return cachedServices;
+}
+function freshUri() {
+    // Each render mints a fresh URI; reusing one would let Langium's
+    // DocumentBuilder mutate the prior document under us.
+    return URI.parse(`memory:///nowline-browser-${++docCounter}.nowline`);
+}
+/**
+ * Parse + validate the source. Returns the AST plus any diagnostics
+ * normalized to the shared {@link DiagnosticRow} shape. Does not run
+ * include resolution, layout, or rendering — useful for editor
+ * experiences that want diagnostics without paying the render cost.
+ */
+export async function parseSource(source, options = {}) {
+    const filePath = options.filePath ?? DEFAULT_SYNTHETIC_PATH;
+    const services = getServices();
+    const docFactory = services.shared.workspace.LangiumDocumentFactory;
+    const doc = docFactory.fromString(source, freshUri());
+    await services.shared.workspace.DocumentBuilder.build([doc], { validation: true });
+    const diagnostics = [];
+    for (const err of doc.parseResult.lexerErrors) {
+        diagnostics.push(fromLexerError(err, filePath));
+    }
+    for (const err of doc.parseResult.parserErrors) {
+        diagnostics.push(fromParserError(err, filePath));
+    }
+    for (const diag of doc.diagnostics ?? []) {
+        diagnostics.push(fromLangiumDiagnostic(diag, filePath));
+    }
+    return { ast: doc.parseResult.value, diagnostics };
+}
+/**
+ * Run the full pipeline (parse + validate + resolveIncludes + layout
+ * + render) and return either the SVG or a list of diagnostics. The
+ * `RenderResult` discriminated union mirrors the CLI's success/failure
+ * split so callers can render either path without try/catch plumbing.
+ */
+export async function renderSource(source, options = {}) {
+    const filePath = options.filePath ?? DEFAULT_SYNTHETIC_PATH;
+    const parsed = await parseSource(source, { filePath });
+    if (parsed.diagnostics.some((d) => d.severity === 'error')) {
+        return { kind: 'diagnostics', diagnostics: parsed.diagnostics };
+    }
+    const services = getServices();
+    const readFile = options.readFile ?? noOpIncludeReadFile;
+    const resolved = await resolveIncludes(parsed.ast, filePath, {
+        services: services.Nowline,
+        readFile,
+    });
+    const rows = [...parsed.diagnostics];
+    for (const diag of resolved.diagnostics) {
+        if (diag.severity === 'error' && isNoOpIncludeDiagnosticMessage(diag.message)) {
+            options.onSkippedInclude?.({
+                sourcePath: diag.sourcePath,
+                message: diag.message,
+            });
+            continue;
+        }
+        rows.push(fromResolveDiagnostic(diag));
+    }
+    if (rows.some((r) => r.severity === 'error')) {
+        return { kind: 'diagnostics', diagnostics: rows };
+    }
+    const today = options.today === null ? undefined : options.today;
+    const model = layoutRoadmap(parsed.ast, resolved, {
+        theme: options.theme,
+        today,
+        locale: options.locale,
+        width: options.width,
+    });
+    const showLinks = options.showLinks !== false;
+    const strict = options.strict === true;
+    const warnMessages = [];
+    const svg = await renderSvg(model, {
+        idPrefix: options.idPrefix,
+        assetResolver: options.assetResolver,
+        noLinks: !showLinks,
+        strict,
+        warn: (msg) => warnMessages.push(msg),
+    });
+    const warnings = warnMessages.map((m) => fromRenderWarning(m, filePath, strict ? 'error' : 'warning'));
+    if (strict && warnings.length > 0) {
+        return { kind: 'diagnostics', diagnostics: [...rows, ...warnings] };
+    }
+    return { kind: 'svg', svg, warnings };
+}
+/**
+ * Test-only escape hatch. Resets cached Langium services and the
+ * URI counter between cases so a `parseSource` failure in one test
+ * doesn't poison the next one's document builder.
+ */
+export function __resetBrowserPipelineForTests() {
+    cachedServices = undefined;
+    docCounter = 0;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@nowline/browser",
+  "version": "0.4.0",
+  "description": "Browser-safe Nowline pipeline: parse + validate + resolve includes + layout + render with pluggable I/O hooks. Consumed by @nowline/embed, the VS Code preview, and any third-party browser tool.",
+  "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/browser"
+  },
+  "homepage": "https://github.com/lolay/nowline",
+  "bugs": {
+    "url": "https://github.com/lolay/nowline/issues"
+  },
+  "keywords": [
+    "nowline",
+    "roadmap",
+    "gantt",
+    "browser",
+    "pipeline"
+  ],
+  "dependencies": {
+    "langium": "~4.2.4",
+    "@nowline/core": "0.4.0",
+    "@nowline/layout": "0.4.0",
+    "@nowline/renderer": "0.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "happy-dom": "^20.9.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  },
+  "scripts": {
+    "prebuild": "node scripts/bundle-showcase.mjs",
+    "build": "tsc -b tsconfig.json",
+    "watch": "tsc -b tsconfig.json --watch",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "pretest": "node scripts/bundle-showcase.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "bundle-showcase": "node scripts/bundle-showcase.mjs"
+  }
+}

package/src/diagnostic-row.ts

@@ -0,0 +1,145 @@
+import type { ResolveDiagnostic } from '@nowline/core';
+
+/**
+ * JSON-friendly diagnostic shape consumed by browser preview surfaces.
+ *
+ * Single source of truth shared by the VS Code preview's webview table,
+ * the embed's error path, and any other browser tool that wants
+ * structured Nowline diagnostics. Field semantics mirror VS Code's
+ * Problems panel: `line` and `column` are 1-based (the editor displays
+ * "Ln 12, Col 5"); `file` is an absolute fs path (or a synthetic
+ * embed-side path) so callers can map back to a source location.
+ */
+export interface DiagnosticRow {
+    severity: 'error' | 'warning';
+    code: string;
+    message: string;
+    suggestion?: string;
+    file: string;
+    line: number;
+    column: number;
+}
+
+/** Minimal LSP-style diagnostic shape. Mirrors `LangiumLikeDiagnostic` in the CLI. */
+export interface LangiumLikeDiagnostic {
+    message: string;
+    severity?: number;
+    code?: string | number;
+    range?: {
+        start: { line: number; character: number };
+        end: { line: number; character: number };
+    };
+}
+
+interface ChevrotainParserError {
+    message: string;
+    token?: {
+        startLine?: number;
+        startColumn?: number;
+    };
+}
+
+interface ChevrotainLexerError {
+    message: string;
+    line?: number;
+    column?: number;
+}
+
+const DID_YOU_MEAN_RE = /did you mean ['"]?([^'"?]+)['"]?\??/i;
+
+export function fromLangiumDiagnostic(diag: LangiumLikeDiagnostic, file: string): DiagnosticRow {
+    return {
+        severity: diag.severity === 2 ? 'warning' : 'error',
+        code: diagnosticCode(diag),
+        message: diag.message,
+        suggestion: extractSuggestion(diag.message),
+        file,
+        line: (diag.range?.start.line ?? 0) + 1,
+        column: (diag.range?.start.character ?? 0) + 1,
+    };
+}
+
+export function fromParserError(err: ChevrotainParserError, file: string): DiagnosticRow {
+    return {
+        severity: 'error',
+        code: 'parse-error',
+        message: err.message,
+        file,
+        line: err.token?.startLine ?? 1,
+        column: err.token?.startColumn ?? 1,
+    };
+}
+
+export function fromLexerError(err: ChevrotainLexerError, file: string): DiagnosticRow {
+    return {
+        severity: 'error',
+        code: 'lex-error',
+        message: err.message,
+        file,
+        line: err.line ?? 1,
+        column: err.column ?? 1,
+    };
+}
+
+/**
+ * Adapt a `ResolveDiagnostic` (cross-file include resolution). The line
+ * is 0-based in the resolver (it comes from a CST range) and may be
+ * undefined for whole-file diagnostics like circular include — fall
+ * back to line 1 so a click-to-jump still puts the cursor near the top
+ * of the offending file.
+ */
+export function fromResolveDiagnostic(diag: ResolveDiagnostic): DiagnosticRow {
+    return {
+        severity: diag.severity,
+        code: 'include',
+        message: diag.message,
+        file: diag.sourcePath,
+        line: diag.line !== undefined ? diag.line + 1 : 1,
+        column: 1,
+    };
+}
+
+/**
+ * Adapt a render-time warning message into a diagnostic row. Renderer
+ * warnings are bare strings without a source location, so callers
+ * supply the source `file`; in `strict` mode the caller upgrades
+ * severity to `error` before passing the result on.
+ */
+export function fromRenderWarning(
+    message: string,
+    file: string,
+    severity: DiagnosticRow['severity'] = 'warning',
+): DiagnosticRow {
+    return {
+        severity,
+        code: 'render.warning',
+        message,
+        file,
+        line: 1,
+        column: 1,
+    };
+}
+
+function diagnosticCode(diag: LangiumLikeDiagnostic): string {
+    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: string): string {
+    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';
+}
+
+function extractSuggestion(message: string): string | undefined {
+    const match = message.match(DID_YOU_MEAN_RE);
+    return match ? match[1].trim() : undefined;
+}

package/src/generated/showcase.ts

@@ -0,0 +1,5 @@
+// AUTO-GENERATED by `packages/browser/scripts/bundle-showcase.mjs`.
+// Do not edit by hand; this file is regenerated from
+// `examples/showcase.nowline` on every build / test run.
+
+export const showcaseSource = "nowline v1\n\nroadmap showcase \"Nowline Showcase\" start:2026-01-05 scale:1m author:\"Nowline\"\n\nanchor kickoff date:2026-01-05\n\nswimlane engineering \"Engineering\"\n  item design \"Design spec\" duration:2w after:kickoff status:done\n  parallel after:design\n    group build \"Build\"\n      item api \"API surface\" duration:3w status:in-progress remaining:1w\n      item ui \"Web client\" duration:3w status:in-progress remaining:2w\n    item integrate \"Integration tests\" duration:2w\n  item ship \"Ship\" duration:1w after:integrate\n\nswimlane marketing \"Marketing\"\n  item brief \"Launch brief\" duration:1w after:kickoff status:done\n  item assets \"Launch assets\" duration:3w after:brief\n  item announce \"Announcement\" duration:1w after:ship\n\nmilestone launch \"Launch\" after:[ship, announce]\n";

package/src/index.ts

@@ -0,0 +1,38 @@
+// Public API for `@nowline/browser`.
+//
+// The package's job is to give every browser-side surface (the embed
+// CDN bundle, the VS Code preview, the Free SPA, and any third-party
+// tool) the same parse → resolveIncludes → layout → render pipeline so
+// behaviour cannot drift between them. Surface-specific concerns (DOM
+// auto-scan, postMessage transport, save/copy commands) belong in the
+// consumer; this package stays a pure data transform.
+
+export {
+    type DiagnosticRow,
+    fromLangiumDiagnostic,
+    fromLexerError,
+    fromParserError,
+    fromRenderWarning,
+    fromResolveDiagnostic,
+    type LangiumLikeDiagnostic,
+} from './diagnostic-row.js';
+// Showcase source string is generated from `examples/showcase.nowline`
+// by `scripts/bundle-showcase.mjs` (m4.7 slice F) and re-exported here
+// for empty-state content in browser SPAs.
+export { showcaseSource } from './generated/showcase.js';
+export {
+    isNoOpIncludeDiagnosticMessage,
+    NOWLINE_BROWSER_NOOP_INCLUDE_TAG,
+    noOpIncludeReadFile,
+    type SkippedInclude,
+} from './no-op-include-resolver.js';
+export {
+    __resetBrowserPipelineForTests,
+    DEFAULT_SYNTHETIC_PATH,
+    type ParseOptions,
+    type ParseResult,
+    parseSource,
+    type RenderOptions,
+    type RenderResult,
+    renderSource,
+} from './pipeline.js';

package/src/no-op-include-resolver.ts

@@ -0,0 +1,30 @@
+/**
+ * Browser-side `readFile` that always rejects with a stable, sniff-able
+ * error tag. The pipeline catches matching include diagnostics and
+ * surfaces them through the `onSkippedInclude` callback so callers can
+ * implement their own warn-once-per-page behaviour without inheriting
+ * a `console.warn` side effect from this package.
+ *
+ * A real HTTP-fetch resolver is intentionally out of scope here (see
+ * `specs/handoffs/handoff-m4-embed.md`): CORS, relative-URL semantics,
+ * and waterfall performance each warrant their own decision and are
+ * best handled behind an opt-in flag in a follow-up.
+ */
+export const NOWLINE_BROWSER_NOOP_INCLUDE_TAG = '__nowline_browser_noop_include__';
+
+export async function noOpIncludeReadFile(absPath: string): Promise<string> {
+    throw new Error(
+        `${NOWLINE_BROWSER_NOOP_INCLUDE_TAG}: include "${absPath}" was skipped — running in single-file mode.`,
+    );
+}
+
+export function isNoOpIncludeDiagnosticMessage(message: string): boolean {
+    return message.includes(NOWLINE_BROWSER_NOOP_INCLUDE_TAG);
+}
+
+export interface SkippedInclude {
+    /** Absolute path of the include that was skipped. */
+    sourcePath: string;
+    /** The diagnostic message verbatim, including the sniff tag. */
+    message: string;
+}

package/src/pipeline.ts

@@ -0,0 +1,238 @@
+// Browser-safe render pipeline shared by every browser surface that
+// needs to turn `.nowline` source into SVG. Consolidates two prior
+// implementations:
+//
+//  - `packages/embed/src/pipeline.ts` (single-file, no Node, throws on
+//    error, fires a console.warn the first time an include is skipped).
+//  - `packages/vscode-extension/src/preview/render-pipeline.ts` (full
+//    options matrix incl. Node-backed include resolver + asset resolver,
+//    returns a discriminated union instead of throwing).
+//
+// The seam between them is dependency injection. Callers that have
+// access to a filesystem (VS Code, future Node browsers) supply a
+// `readFile` callback and an `assetResolver`; callers that don't (embed,
+// Free SPA) omit both, get the noop include reader, and receive a
+// `SkippedInclude` callback when an `include` directive is encountered.
+//
+// The package itself imports zero `node:*` modules so the embed esbuild
+// bundle stays free of any Node literal even before tree-shaking.
+
+import {
+    createNowlineServices,
+    type NowlineFile,
+    type NowlineServices,
+    resolveIncludes,
+} from '@nowline/core';
+import { layoutRoadmap, type ThemeName } from '@nowline/layout';
+import { type AssetResolver, renderSvg } from '@nowline/renderer';
+import { URI } from 'langium';
+import {
+    type DiagnosticRow,
+    fromLangiumDiagnostic,
+    fromLexerError,
+    fromParserError,
+    fromRenderWarning,
+    fromResolveDiagnostic,
+    type LangiumLikeDiagnostic,
+} from './diagnostic-row.js';
+import {
+    isNoOpIncludeDiagnosticMessage,
+    noOpIncludeReadFile,
+    type SkippedInclude,
+} from './no-op-include-resolver.js';
+
+/**
+ * Synthetic path stamped on diagnostics that have no real source file
+ * (the embed renders strings, not files). Consumers can re-key it to
+ * a more user-meaningful label by setting `filePath`.
+ */
+export const DEFAULT_SYNTHETIC_PATH = '/browser-source.nowline';
+
+export interface ParseOptions {
+    /**
+     * Absolute path (or synthetic path) used to seed include resolution
+     * and tag parse/validation diagnostics. Defaults to a synthetic
+     * `/browser-source.nowline` so embedded blocks have a stable label.
+     */
+    filePath?: string;
+    /**
+     * Callback that resolves an `include "..."` directive to file
+     * contents. When omitted, falls back to `noOpIncludeReadFile`
+     * (every include is skipped and surfaced via `onSkippedInclude`).
+     * VS Code passes a Node `fs.readFile` shim; the embed passes
+     * nothing.
+     */
+    readFile?: (absPath: string) => Promise<string>;
+    /**
+     * Fires once per skipped include when the noop reader rejects it.
+     * Use this to surface a single page-level warning without coupling
+     * the pipeline to `console.warn`.
+     */
+    onSkippedInclude?: (info: SkippedInclude) => void;
+}
+
+export interface ParseResult {
+    ast: NowlineFile;
+    diagnostics: DiagnosticRow[];
+}
+
+export interface RenderOptions extends ParseOptions {
+    theme?: ThemeName;
+    /**
+     * "Today" override threaded into the layout engine. Pass an
+     * explicit `Date` for deterministic snapshots; pass `null` to
+     * suppress the now-line entirely (mirrors the CLI's `--now -`);
+     * leave undefined to use `new Date()` per render.
+     */
+    today?: Date | null;
+    /** BCP-47 locale forwarded to the layout engine for axis labels. */
+    locale?: string;
+    /** Total canvas width in px. Layout's default is 1280. */
+    width?: number;
+    /**
+     * Override the deterministic id prefix used for in-SVG `<style>`
+     * scoping. Multi-block surfaces (auto-scan) supply a fresh prefix
+     * per block so two roadmaps cannot bleed styles into each other.
+     */
+    idPrefix?: string;
+    /** Inverse of the CLI's `--no-links`. When false, link icons are dropped. */
+    showLinks?: boolean;
+    /** Promote renderer warnings to errors in the diagnostic table. */
+    strict?: boolean;
+    /**
+     * Asset resolver invoked by the renderer for image references
+     * (`icon:` declarations, etc.). When omitted, image assets are
+     * silently dropped — match the embed's "no filesystem" posture.
+     */
+    assetResolver?: AssetResolver;
+}
+
+export type RenderResult =
+    | { kind: 'svg'; svg: string; warnings: DiagnosticRow[] }
+    | { kind: 'diagnostics'; diagnostics: DiagnosticRow[] };
+
+interface CachedServices {
+    shared: ReturnType<typeof createNowlineServices>['shared'];
+    Nowline: NowlineServices;
+}
+
+let cachedServices: CachedServices | undefined;
+let docCounter = 0;
+
+function getServices(): CachedServices {
+    if (!cachedServices) cachedServices = createNowlineServices();
+    return cachedServices;
+}
+
+function freshUri(): URI {
+    // Each render mints a fresh URI; reusing one would let Langium's
+    // DocumentBuilder mutate the prior document under us.
+    return URI.parse(`memory:///nowline-browser-${++docCounter}.nowline`);
+}
+
+/**
+ * Parse + validate the source. Returns the AST plus any diagnostics
+ * normalized to the shared {@link DiagnosticRow} shape. Does not run
+ * include resolution, layout, or rendering — useful for editor
+ * experiences that want diagnostics without paying the render cost.
+ */
+export async function parseSource(
+    source: string,
+    options: ParseOptions = {},
+): Promise<ParseResult> {
+    const filePath = options.filePath ?? DEFAULT_SYNTHETIC_PATH;
+    const services = getServices();
+    const docFactory = services.shared.workspace.LangiumDocumentFactory;
+    const doc = docFactory.fromString<NowlineFile>(source, freshUri());
+    await services.shared.workspace.DocumentBuilder.build([doc], { validation: true });
+
+    const diagnostics: DiagnosticRow[] = [];
+    for (const err of doc.parseResult.lexerErrors) {
+        diagnostics.push(fromLexerError(err, filePath));
+    }
+    for (const err of doc.parseResult.parserErrors) {
+        diagnostics.push(fromParserError(err, filePath));
+    }
+    for (const diag of doc.diagnostics ?? []) {
+        diagnostics.push(fromLangiumDiagnostic(diag as LangiumLikeDiagnostic, filePath));
+    }
+    return { ast: doc.parseResult.value, diagnostics };
+}
+
+/**
+ * Run the full pipeline (parse + validate + resolveIncludes + layout
+ * + render) and return either the SVG or a list of diagnostics. The
+ * `RenderResult` discriminated union mirrors the CLI's success/failure
+ * split so callers can render either path without try/catch plumbing.
+ */
+export async function renderSource(
+    source: string,
+    options: RenderOptions = {},
+): Promise<RenderResult> {
+    const filePath = options.filePath ?? DEFAULT_SYNTHETIC_PATH;
+    const parsed = await parseSource(source, { filePath });
+    if (parsed.diagnostics.some((d) => d.severity === 'error')) {
+        return { kind: 'diagnostics', diagnostics: parsed.diagnostics };
+    }
+
+    const services = getServices();
+    const readFile = options.readFile ?? noOpIncludeReadFile;
+    const resolved = await resolveIncludes(parsed.ast, filePath, {
+        services: services.Nowline,
+        readFile,
+    });
+
+    const rows: DiagnosticRow[] = [...parsed.diagnostics];
+    for (const diag of resolved.diagnostics) {
+        if (diag.severity === 'error' && isNoOpIncludeDiagnosticMessage(diag.message)) {
+            options.onSkippedInclude?.({
+                sourcePath: diag.sourcePath,
+                message: diag.message,
+            });
+            continue;
+        }
+        rows.push(fromResolveDiagnostic(diag));
+    }
+    if (rows.some((r) => r.severity === 'error')) {
+        return { kind: 'diagnostics', diagnostics: rows };
+    }
+
+    const today = options.today === null ? undefined : options.today;
+    const model = layoutRoadmap(parsed.ast, resolved, {
+        theme: options.theme,
+        today,
+        locale: options.locale,
+        width: options.width,
+    });
+
+    const showLinks = options.showLinks !== false;
+    const strict = options.strict === true;
+    const warnMessages: string[] = [];
+
+    const svg = await renderSvg(model, {
+        idPrefix: options.idPrefix,
+        assetResolver: options.assetResolver,
+        noLinks: !showLinks,
+        strict,
+        warn: (msg) => warnMessages.push(msg),
+    });
+
+    const warnings = warnMessages.map((m) =>
+        fromRenderWarning(m, filePath, strict ? 'error' : 'warning'),
+    );
+    if (strict && warnings.length > 0) {
+        return { kind: 'diagnostics', diagnostics: [...rows, ...warnings] };
+    }
+
+    return { kind: 'svg', svg, warnings };
+}
+
+/**
+ * Test-only escape hatch. Resets cached Langium services and the
+ * URI counter between cases so a `parseSource` failure in one test
+ * doesn't poison the next one's document builder.
+ */
+export function __resetBrowserPipelineForTests(): void {
+    cachedServices = undefined;
+    docCounter = 0;
+}