@nowline/export-mermaid 0.2.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/README.md

@@ -0,0 +1,96 @@
+# @nowline/export-mermaid
+
+Markdown + Mermaid `gantt` export. Transpiles a Nowline AST into a Markdown
+page that renders in any Mermaid-aware viewer (GitHub, GitLab, Obsidian,
+mermaid.live, etc.). Pure strings — no Node-only dependencies.
+
+**License:** Apache 2.0
+**Part of:** [`lolay/nowline`](../../) monorepo
+**Spec:** [`specs/handoffs/m2c.md`](../../specs/handoffs/m2c.md) § 6
+
+## Install
+
+```bash
+pnpm add @nowline/export-mermaid @nowline/export-core
+```
+
+## Usage
+
+```ts
+import { exportMermaid } from '@nowline/export-mermaid';
+
+const md = exportMermaid(inputs, {
+    lossyComment: true,           // default; emits the trailing `%%` comment
+});
+
+// `md` is a Markdown string. Write to disk as roadmap.md, or stdin → stdout.
+```
+
+CLI:
+
+```bash
+nowline roadmap.nowline -f mermaid -o roadmap.md
+nowline roadmap.nowline -f md      -o -          # alias; stdout
+nowline roadmap.nowline -o roadmap.md            # extension-inferred
+```
+
+`md` and `markdown` are CLI aliases for `mermaid`.
+
+## Output shape
+
+```markdown
+# <Roadmap title>
+
+<description paragraph if any>
+
+```mermaid
+gantt
+    title <title>
+    dateFormat YYYY-MM-DD
+    axisFormat %b %d
+    section <swimlane>
+    Item one : done, item-one, 2026-01-06, 5d
+    Item two : active, item-two, after item-one, 10d
+```
+
+%% Lossy export — Mermaid does not support: labels (3), footnotes (1)
+```
+
+The first line of the Markdown is the roadmap title. The fenced
+```` ```mermaid ```` block contains a valid `gantt` diagram; the trailing
+`%%` comment line lists Nowline features that don't have a Mermaid
+equivalent and have been dropped.
+
+## Lossy export policy
+
+Mermaid `gantt` is intentionally a much simpler model than Nowline. The
+following Nowline features are dropped (silently inside the gantt block,
+named in the trailing `%%` comment):
+
+- `label`, `style` declarations
+- `footnote` annotations
+- `description` directives on items
+- Custom `status` definitions beyond Mermaid's `done` / `active` /
+  `crit`
+- Per-`person` / `team` ownership styling
+
+Per spec Resolution 4, `--strict` does *not* escalate these drops to
+errors. The export succeeds on any valid AST and the comment makes the
+loss visible to the reader.
+
+## Options
+
+| Option         | Default | Notes |
+|----------------|---------|-------|
+| `lossyComment` | `true`  | Append the trailing `%%` comment listing dropped features. Set `false` to omit (e.g., for snapshots in environments where Mermaid is the canonical view). |
+
+## Determinism
+
+- No `new Date()`, no random.
+- Item ordering follows AST order (already deterministic from
+  `@nowline/core`).
+- Snapshots in `test/__snapshots__/` regenerate via `vitest -u`.
+
+## License
+
+Apache-2.0.

package/dist/duration.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Convert a duration literal to a Mermaid token (`5d`, `2w`, …).
+ * Returns `undefined` when the literal is missing — caller emits no duration
+ * and Mermaid uses its default 1d.
+ */
+export declare function durationToMermaid(literal: string | undefined): string | undefined;
+//# sourceMappingURL=duration.d.ts.map

package/dist/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAwBjF"}

package/dist/duration.js

@@ -0,0 +1,49 @@
+// Convert Nowline duration tokens (e.g. `2w`, `1m`, `xl`) into Mermaid's
+// duration syntax. Mermaid `gantt` accepts day / week / hour units.
+//
+// Spec: specs/handoffs/m2c.md § 6 + the bridge rules in
+// specs/rendering.md § Markdown+Mermaid Bridge.
+const SIZE_BUCKET_DAYS = {
+    xs: 1,
+    sm: 3,
+    s: 3,
+    md: 5,
+    m: 5,
+    lg: 10,
+    l: 10,
+    xl: 15,
+};
+const NUMERIC_RE = /^(\d+(?:\.\d+)?)\s*(d|w|m|y)?$/i;
+/**
+ * Convert a duration literal to a Mermaid token (`5d`, `2w`, …).
+ * Returns `undefined` when the literal is missing — caller emits no duration
+ * and Mermaid uses its default 1d.
+ */
+export function durationToMermaid(literal) {
+    if (!literal)
+        return undefined;
+    const trimmed = literal.trim().toLowerCase();
+    if (!trimmed)
+        return undefined;
+    // Size buckets resolve to working-day counts.
+    if (trimmed in SIZE_BUCKET_DAYS) {
+        return `${SIZE_BUCKET_DAYS[trimmed]}d`;
+    }
+    const match = NUMERIC_RE.exec(trimmed);
+    if (!match)
+        return undefined;
+    const value = match[1];
+    const unit = (match[2] ?? 'd').toLowerCase();
+    if (unit === 'd' || unit === 'w')
+        return `${value}${unit}`;
+    if (unit === 'm') {
+        const days = Math.round(Number(value) * 22);
+        return `${days}d`;
+    }
+    if (unit === 'y') {
+        const days = Math.round(Number(value) * 252);
+        return `${days}d`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=duration.js.map

package/dist/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,oEAAoE;AACpE,EAAE;AACF,wDAAwD;AACxD,gDAAgD;AAEhD,MAAM,gBAAgB,GAAqC;IACvD,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,CAAC,EAAE,CAAC;IACJ,EAAE,EAAE,CAAC;IACL,CAAC,EAAE,CAAC;IACJ,EAAE,EAAE,EAAE;IACN,CAAC,EAAE,EAAE;IACL,EAAE,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,UAAU,GAAG,iCAAiC,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IACzD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,8CAA8C;IAC9C,IAAI,OAAO,IAAI,gBAAgB,EAAE,CAAC;QAC9B,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC;IAC3D,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5C,OAAO,GAAG,IAAI,GAAG,CAAC;IACtB,CAAC;IACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QAC7C,OAAO,GAAG,IAAI,GAAG,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type { ExportInputs } from '@nowline/export-core';
+export interface MermaidOptions {
+    /** Append the trailing `%%` lossy comment. Defaults to true. */
+    lossyComment?: boolean;
+}
+export declare function exportMermaid(inputs: ExportInputs, options?: MermaidOptions): string;
+//# 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":"AAmCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKzD,MAAM,WAAW,cAAc;IAC3B,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AA8BD,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAmExF"}

package/dist/index.js

@@ -0,0 +1,253 @@
+// Markdown+Mermaid exporter.
+//
+// Spec: specs/handoffs/m2c.md § 6 "Markdown+Mermaid".
+// Decisions:
+//   - Resolution 4 (Mermaid loss discipline): drops are silent in the gantt
+//     block; a trailing `%%` comment enumerates dropped features with stable
+//     counts; `--strict` does NOT escalate.
+//   - Lossy export policy: succeeds on any valid AST regardless of `--strict`.
+//
+// Output shape:
+//   # <Roadmap title>
+//
+//   <description paragraph if any>
+//
+//   ```mermaid
+//   gantt
+//       title <title>
+//       dateFormat YYYY-MM-DD
+//       axisFormat ...
+//       section <swimlane>
+//       <Task name>: <status>, <id>, <after-or-date>, <duration>
+//   ```
+//
+//   <%% lossy comment %%>
+import { displayLabel, getProp, getProps, hasProp, roadmapTitle } from '@nowline/export-core';
+import { durationToMermaid } from './duration.js';
+function emptyCounts() {
+    return {
+        labels: 0,
+        footnote: 0,
+        remaining: 0,
+        owner: 0,
+        before: 0,
+        parallel: 0,
+        group: 0,
+        nestedSwimlanes: 0,
+        description: 0,
+        style: 0,
+    };
+}
+export function exportMermaid(inputs, options = {}) {
+    const ast = inputs.ast;
+    const title = roadmapTitle(ast.roadmapDecl ?? undefined);
+    const drops = emptyCounts();
+    const out = [];
+    out.push(`# ${title}`);
+    out.push('');
+    out.push('```mermaid');
+    out.push('gantt');
+    out.push(`    title ${escapeMermaidText(title)}`);
+    out.push('    dateFormat YYYY-MM-DD');
+    // Footnotes are file-level; counted once.
+    drops.footnote += ast.roadmapEntries.filter((e) => e.$type === 'FootnoteDeclaration').length;
+    // Anchors → milestone entries (Mermaid doesn't support standalone anchors).
+    const anchors = ast.roadmapEntries.filter((e) => e.$type === 'AnchorDeclaration');
+    if (anchors.length > 0) {
+        out.push('    section Anchors');
+        for (const anchor of anchors) {
+            const date = getProp(anchor, 'date');
+            const id = anchor.name ?? slugify(displayLabel(anchor));
+            if (date) {
+                out.push(`    ${escapeTaskName(displayLabel(anchor))} :milestone, ${id}, ${date}, 0d`);
+            }
+            else {
+                out.push(`    ${escapeTaskName(displayLabel(anchor))} :milestone, ${id}, after , 0d`);
+            }
+        }
+    }
+    // Swimlanes → sections; their items become tasks.
+    const swimlanes = ast.roadmapEntries.filter((e) => e.$type === 'SwimlaneDeclaration');
+    for (const lane of swimlanes) {
+        emitSwimlane(lane, [lane.name ?? slugify(displayLabel(lane))], drops, out);
+    }
+    // Top-level milestones.
+    const milestones = ast.roadmapEntries.filter((e) => e.$type === 'MilestoneDeclaration');
+    if (milestones.length > 0) {
+        out.push('    section Milestones');
+        for (const m of milestones) {
+            emitMilestone(m, drops, out);
+        }
+    }
+    out.push('```');
+    if (options.lossyComment !== false) {
+        const summary = formatDrops(drops);
+        if (summary) {
+            out.push('');
+            out.push(summary);
+        }
+    }
+    return out.join('\n');
+}
+function emitSwimlane(lane, breadcrumb, drops, out) {
+    const sectionLabel = breadcrumb.join('.');
+    out.push(`    section ${escapeMermaidText(sectionLabel)}`);
+    for (const child of lane.content) {
+        emitSwimlaneChild(child, breadcrumb, drops, out);
+    }
+    // Nested swimlanes — count for the lossy report.
+    // SwimlaneContent doesn't include nested swimlanes per the grammar, so
+    // there's nothing to recurse into here. If `nested` lives on the
+    // roadmap-level layout model, that's a separate count tracked elsewhere.
+}
+function emitSwimlaneChild(child, breadcrumb, drops, out) {
+    if (child.$type === 'ItemDeclaration') {
+        emitItem(child, drops, out);
+        return;
+    }
+    if (child.$type === 'GroupBlock') {
+        drops.group += 1;
+        emitGroup(child, breadcrumb, drops, out);
+        return;
+    }
+    if (child.$type === 'ParallelBlock') {
+        drops.parallel += 1;
+        emitParallel(child, breadcrumb, drops, out);
+        return;
+    }
+    if (child.$type === 'DescriptionDirective') {
+        drops.description += 1;
+        return;
+    }
+}
+function emitGroup(group, breadcrumb, drops, out) {
+    for (const child of group.content) {
+        if (child.$type === 'ItemDeclaration') {
+            emitItem(child, drops, out);
+        }
+        else if (child.$type === 'GroupBlock') {
+            drops.group += 1;
+            emitGroup(child, breadcrumb, drops, out);
+        }
+        else if (child.$type === 'ParallelBlock') {
+            drops.parallel += 1;
+            emitParallel(child, breadcrumb, drops, out);
+        }
+        else if (child.$type === 'DescriptionDirective') {
+            drops.description += 1;
+        }
+    }
+}
+function emitParallel(parallel, breadcrumb, drops, out) {
+    for (const child of parallel.content) {
+        if (child.$type === 'ItemDeclaration') {
+            emitItem(child, drops, out);
+        }
+        else if (child.$type === 'GroupBlock') {
+            drops.group += 1;
+            emitGroup(child, breadcrumb, drops, out);
+        }
+        else if (child.$type === 'DescriptionDirective') {
+            drops.description += 1;
+        }
+    }
+}
+function emitItem(item, drops, out) {
+    countDrops(item, drops);
+    const id = item.name ?? slugify(displayLabel(item));
+    const status = mapStatus(getProp(item, 'status'));
+    const after = getProps(item, 'after');
+    const duration = durationToMermaid(getProp(item, 'duration') ?? getProp(item, 'size')) ?? '1d';
+    const _ref = after.length > 0 ? `after ${after.join(' ')}` : 'after , 0d'.replace(', 0d', '');
+    const meta = [status, id, after.length > 0 ? `after ${after.join(' ')}` : '', duration]
+        .filter((s) => s !== '')
+        .join(', ');
+    out.push(`    ${escapeTaskName(displayLabel(item))} :${meta}`);
+}
+function emitMilestone(milestone, drops, out) {
+    const id = milestone.name ?? slugify(displayLabel(milestone));
+    const date = getProp(milestone, 'date');
+    if (date) {
+        out.push(`    ${escapeTaskName(displayLabel(milestone))} :milestone, ${id}, ${date}, 0d`);
+    }
+    else {
+        const after = getProps(milestone, 'depends');
+        if (after.length > 0) {
+            out.push(`    ${escapeTaskName(displayLabel(milestone))} :milestone, ${id}, after ${after.join(' ')}, 0d`);
+        }
+        else {
+            out.push(`    ${escapeTaskName(displayLabel(milestone))} :milestone, ${id}, 0d`);
+        }
+    }
+    if (hasProp(milestone, 'style'))
+        drops.style += 1;
+}
+function countDrops(item, drops) {
+    if (getProps(item, 'labels').length > 0)
+        drops.labels += 1;
+    if (hasProp(item, 'remaining'))
+        drops.remaining += 1;
+    if (hasProp(item, 'owner'))
+        drops.owner += 1;
+    if (getProps(item, 'before').length > 0)
+        drops.before += 1;
+    if (hasProp(item, 'style'))
+        drops.style += 1;
+    if (item.description)
+        drops.description += 1;
+}
+function mapStatus(status) {
+    switch (status) {
+        case 'done':
+            return 'done';
+        case 'in-progress':
+            return 'active';
+        case 'blocked':
+        case 'at-risk':
+            return 'crit';
+        default:
+            return '';
+    }
+}
+function slugify(s) {
+    return (s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'item');
+}
+function escapeMermaidText(s) {
+    return s.replace(/[\r\n]+/g, ' ').replace(/"/g, '\u201c');
+}
+function escapeTaskName(s) {
+    // Mermaid splits the task line on `:` and `,` — strip them from the name.
+    return s.replace(/[\r\n]+/g, ' ').replace(/[:,]+/g, ' ');
+}
+function formatDrops(drops) {
+    const order = [
+        'labels',
+        'footnote',
+        'remaining',
+        'owner',
+        'before',
+        'parallel',
+        'group',
+        'nestedSwimlanes',
+        'description',
+        'style',
+    ];
+    const parts = order
+        .filter((key) => drops[key] > 0)
+        .map((key) => `${formatDropKey(key)} (${drops[key]})`);
+    if (parts.length === 0)
+        return null;
+    const lines = [];
+    lines.push('%% Mermaid lossy export — Nowline features dropped:');
+    lines.push(`%% ${parts.join(', ')}`);
+    return lines.join('\n');
+}
+function formatDropKey(key) {
+    if (key === 'nestedSwimlanes')
+        return 'nested-swimlanes';
+    return key;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@nowline/export-mermaid",
+  "version": "0.2.0",
+  "description": "Nowline Mermaid exporter — Markdown+Mermaid gantt transpilation",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "dependencies": {
+    "@nowline/core": "0.2.0",
+    "@nowline/export-core": "0.2.0",
+    "@nowline/layout": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "langium": "~4.2.2",
+    "typescript": "~5.7.0",
+    "vitest": "^3.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "watch": "tsc -b tsconfig.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/duration.ts

@@ -0,0 +1,49 @@
+// Convert Nowline duration tokens (e.g. `2w`, `1m`, `xl`) into Mermaid's
+// duration syntax. Mermaid `gantt` accepts day / week / hour units.
+//
+// Spec: specs/handoffs/m2c.md § 6 + the bridge rules in
+// specs/rendering.md § Markdown+Mermaid Bridge.
+
+const SIZE_BUCKET_DAYS: Readonly<Record<string, number>> = {
+    xs: 1,
+    sm: 3,
+    s: 3,
+    md: 5,
+    m: 5,
+    lg: 10,
+    l: 10,
+    xl: 15,
+};
+
+const NUMERIC_RE = /^(\d+(?:\.\d+)?)\s*(d|w|m|y)?$/i;
+
+/**
+ * Convert a duration literal to a Mermaid token (`5d`, `2w`, …).
+ * Returns `undefined` when the literal is missing — caller emits no duration
+ * and Mermaid uses its default 1d.
+ */
+export function durationToMermaid(literal: string | undefined): string | undefined {
+    if (!literal) return undefined;
+    const trimmed = literal.trim().toLowerCase();
+    if (!trimmed) return undefined;
+
+    // Size buckets resolve to working-day counts.
+    if (trimmed in SIZE_BUCKET_DAYS) {
+        return `${SIZE_BUCKET_DAYS[trimmed]}d`;
+    }
+
+    const match = NUMERIC_RE.exec(trimmed);
+    if (!match) return undefined;
+    const value = match[1];
+    const unit = (match[2] ?? 'd').toLowerCase();
+    if (unit === 'd' || unit === 'w') return `${value}${unit}`;
+    if (unit === 'm') {
+        const days = Math.round(Number(value) * 22);
+        return `${days}d`;
+    }
+    if (unit === 'y') {
+        const days = Math.round(Number(value) * 252);
+        return `${days}d`;
+    }
+    return undefined;
+}

package/src/index.ts

@@ -0,0 +1,324 @@
+// Markdown+Mermaid exporter.
+//
+// Spec: specs/handoffs/m2c.md § 6 "Markdown+Mermaid".
+// Decisions:
+//   - Resolution 4 (Mermaid loss discipline): drops are silent in the gantt
+//     block; a trailing `%%` comment enumerates dropped features with stable
+//     counts; `--strict` does NOT escalate.
+//   - Lossy export policy: succeeds on any valid AST regardless of `--strict`.
+//
+// Output shape:
+//   # <Roadmap title>
+//
+//   <description paragraph if any>
+//
+//   ```mermaid
+//   gantt
+//       title <title>
+//       dateFormat YYYY-MM-DD
+//       axisFormat ...
+//       section <swimlane>
+//       <Task name>: <status>, <id>, <after-or-date>, <duration>
+//   ```
+//
+//   <%% lossy comment %%>
+
+import type {
+    AnchorDeclaration,
+    GroupBlock,
+    GroupContent,
+    ItemDeclaration,
+    MilestoneDeclaration,
+    ParallelBlock,
+    SwimlaneContent,
+    SwimlaneDeclaration,
+} from '@nowline/core';
+import type { ExportInputs } from '@nowline/export-core';
+import { displayLabel, getProp, getProps, hasProp, roadmapTitle } from '@nowline/export-core';
+
+import { durationToMermaid } from './duration.js';
+
+export interface MermaidOptions {
+    /** Append the trailing `%%` lossy comment. Defaults to true. */
+    lossyComment?: boolean;
+}
+
+interface DropCounts {
+    labels: number;
+    footnote: number;
+    remaining: number;
+    owner: number;
+    before: number;
+    parallel: number;
+    group: number;
+    nestedSwimlanes: number;
+    description: number;
+    style: number;
+}
+
+function emptyCounts(): DropCounts {
+    return {
+        labels: 0,
+        footnote: 0,
+        remaining: 0,
+        owner: 0,
+        before: 0,
+        parallel: 0,
+        group: 0,
+        nestedSwimlanes: 0,
+        description: 0,
+        style: 0,
+    };
+}
+
+export function exportMermaid(inputs: ExportInputs, options: MermaidOptions = {}): string {
+    const ast = inputs.ast;
+    const title = roadmapTitle(ast.roadmapDecl ?? undefined);
+    const drops = emptyCounts();
+
+    const out: string[] = [];
+    out.push(`# ${title}`);
+    out.push('');
+    out.push('```mermaid');
+    out.push('gantt');
+    out.push(`    title ${escapeMermaidText(title)}`);
+    out.push('    dateFormat YYYY-MM-DD');
+
+    // Footnotes are file-level; counted once.
+    drops.footnote += ast.roadmapEntries.filter((e) => e.$type === 'FootnoteDeclaration').length;
+
+    // Anchors → milestone entries (Mermaid doesn't support standalone anchors).
+    const anchors = ast.roadmapEntries.filter(
+        (e): e is AnchorDeclaration => e.$type === 'AnchorDeclaration',
+    );
+    if (anchors.length > 0) {
+        out.push('    section Anchors');
+        for (const anchor of anchors) {
+            const date = getProp(anchor, 'date');
+            const id = anchor.name ?? slugify(displayLabel(anchor));
+            if (date) {
+                out.push(
+                    `    ${escapeTaskName(displayLabel(anchor))} :milestone, ${id}, ${date}, 0d`,
+                );
+            } else {
+                out.push(
+                    `    ${escapeTaskName(displayLabel(anchor))} :milestone, ${id}, after , 0d`,
+                );
+            }
+        }
+    }
+
+    // Swimlanes → sections; their items become tasks.
+    const swimlanes = ast.roadmapEntries.filter(
+        (e): e is SwimlaneDeclaration => e.$type === 'SwimlaneDeclaration',
+    );
+    for (const lane of swimlanes) {
+        emitSwimlane(lane, [lane.name ?? slugify(displayLabel(lane))], drops, out);
+    }
+
+    // Top-level milestones.
+    const milestones = ast.roadmapEntries.filter(
+        (e): e is MilestoneDeclaration => e.$type === 'MilestoneDeclaration',
+    );
+    if (milestones.length > 0) {
+        out.push('    section Milestones');
+        for (const m of milestones) {
+            emitMilestone(m, drops, out);
+        }
+    }
+
+    out.push('```');
+
+    if (options.lossyComment !== false) {
+        const summary = formatDrops(drops);
+        if (summary) {
+            out.push('');
+            out.push(summary);
+        }
+    }
+
+    return out.join('\n');
+}
+
+function emitSwimlane(
+    lane: SwimlaneDeclaration,
+    breadcrumb: readonly string[],
+    drops: DropCounts,
+    out: string[],
+): void {
+    const sectionLabel = breadcrumb.join('.');
+    out.push(`    section ${escapeMermaidText(sectionLabel)}`);
+    for (const child of lane.content) {
+        emitSwimlaneChild(child, breadcrumb, drops, out);
+    }
+    // Nested swimlanes — count for the lossy report.
+    // SwimlaneContent doesn't include nested swimlanes per the grammar, so
+    // there's nothing to recurse into here. If `nested` lives on the
+    // roadmap-level layout model, that's a separate count tracked elsewhere.
+}
+
+function emitSwimlaneChild(
+    child: SwimlaneContent,
+    breadcrumb: readonly string[],
+    drops: DropCounts,
+    out: string[],
+): void {
+    if (child.$type === 'ItemDeclaration') {
+        emitItem(child, drops, out);
+        return;
+    }
+    if (child.$type === 'GroupBlock') {
+        drops.group += 1;
+        emitGroup(child, breadcrumb, drops, out);
+        return;
+    }
+    if (child.$type === 'ParallelBlock') {
+        drops.parallel += 1;
+        emitParallel(child, breadcrumb, drops, out);
+        return;
+    }
+    if (child.$type === 'DescriptionDirective') {
+        drops.description += 1;
+        return;
+    }
+}
+
+function emitGroup(
+    group: GroupBlock,
+    breadcrumb: readonly string[],
+    drops: DropCounts,
+    out: string[],
+): void {
+    for (const child of group.content as GroupContent[]) {
+        if (child.$type === 'ItemDeclaration') {
+            emitItem(child, drops, out);
+        } else if (child.$type === 'GroupBlock') {
+            drops.group += 1;
+            emitGroup(child, breadcrumb, drops, out);
+        } else if (child.$type === 'ParallelBlock') {
+            drops.parallel += 1;
+            emitParallel(child, breadcrumb, drops, out);
+        } else if (child.$type === 'DescriptionDirective') {
+            drops.description += 1;
+        }
+    }
+}
+
+function emitParallel(
+    parallel: ParallelBlock,
+    breadcrumb: readonly string[],
+    drops: DropCounts,
+    out: string[],
+): void {
+    for (const child of parallel.content) {
+        if (child.$type === 'ItemDeclaration') {
+            emitItem(child, drops, out);
+        } else if (child.$type === 'GroupBlock') {
+            drops.group += 1;
+            emitGroup(child, breadcrumb, drops, out);
+        } else if (child.$type === 'DescriptionDirective') {
+            drops.description += 1;
+        }
+    }
+}
+
+function emitItem(item: ItemDeclaration, drops: DropCounts, out: string[]): void {
+    countDrops(item, drops);
+    const id = item.name ?? slugify(displayLabel(item));
+    const status = mapStatus(getProp(item, 'status'));
+    const after = getProps(item, 'after');
+    const duration = durationToMermaid(getProp(item, 'duration') ?? getProp(item, 'size')) ?? '1d';
+    const _ref = after.length > 0 ? `after ${after.join(' ')}` : 'after , 0d'.replace(', 0d', '');
+
+    const meta = [status, id, after.length > 0 ? `after ${after.join(' ')}` : '', duration]
+        .filter((s) => s !== '')
+        .join(', ');
+    out.push(`    ${escapeTaskName(displayLabel(item))} :${meta}`);
+}
+
+function emitMilestone(milestone: MilestoneDeclaration, drops: DropCounts, out: string[]): void {
+    const id = milestone.name ?? slugify(displayLabel(milestone));
+    const date = getProp(milestone, 'date');
+    if (date) {
+        out.push(`    ${escapeTaskName(displayLabel(milestone))} :milestone, ${id}, ${date}, 0d`);
+    } else {
+        const after = getProps(milestone, 'depends');
+        if (after.length > 0) {
+            out.push(
+                `    ${escapeTaskName(displayLabel(milestone))} :milestone, ${id}, after ${after.join(' ')}, 0d`,
+            );
+        } else {
+            out.push(`    ${escapeTaskName(displayLabel(milestone))} :milestone, ${id}, 0d`);
+        }
+    }
+    if (hasProp(milestone, 'style')) drops.style += 1;
+}
+
+function countDrops(item: ItemDeclaration, drops: DropCounts): void {
+    if (getProps(item, 'labels').length > 0) drops.labels += 1;
+    if (hasProp(item, 'remaining')) drops.remaining += 1;
+    if (hasProp(item, 'owner')) drops.owner += 1;
+    if (getProps(item, 'before').length > 0) drops.before += 1;
+    if (hasProp(item, 'style')) drops.style += 1;
+    if (item.description) drops.description += 1;
+}
+
+function mapStatus(status: string | undefined): string {
+    switch (status) {
+        case 'done':
+            return 'done';
+        case 'in-progress':
+            return 'active';
+        case 'blocked':
+        case 'at-risk':
+            return 'crit';
+        default:
+            return '';
+    }
+}
+
+function slugify(s: string): string {
+    return (
+        s
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '') || 'item'
+    );
+}
+
+function escapeMermaidText(s: string): string {
+    return s.replace(/[\r\n]+/g, ' ').replace(/"/g, '\u201c');
+}
+
+function escapeTaskName(s: string): string {
+    // Mermaid splits the task line on `:` and `,` — strip them from the name.
+    return s.replace(/[\r\n]+/g, ' ').replace(/[:,]+/g, ' ');
+}
+
+function formatDrops(drops: DropCounts): string | null {
+    const order: (keyof DropCounts)[] = [
+        'labels',
+        'footnote',
+        'remaining',
+        'owner',
+        'before',
+        'parallel',
+        'group',
+        'nestedSwimlanes',
+        'description',
+        'style',
+    ];
+    const parts = order
+        .filter((key) => drops[key] > 0)
+        .map((key) => `${formatDropKey(key)} (${drops[key]})`);
+    if (parts.length === 0) return null;
+    const lines: string[] = [];
+    lines.push('%% Mermaid lossy export — Nowline features dropped:');
+    lines.push(`%% ${parts.join(', ')}`);
+    return lines.join('\n');
+}
+
+function formatDropKey(key: keyof DropCounts): string {
+    if (key === 'nestedSwimlanes') return 'nested-swimlanes';
+    return key;
+}