plainb 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Trung Le Duc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+# plainb
+
+Convert plain-text notebook files to [Jupyter nbformat 4](https://nbformat.readthedocs.io/) JSON — in the browser or in Node.
+
+## Supported formats
+
+| Format             | Description                                                                                              |
+| ------------------ | -------------------------------------------------------------------------------------------------------- |
+| **`.py` percent**  | VS Code / Spyder / Jupytext percent format — cells delimited by `# %%`                                   |
+| **`.md` classic**  | Markdown file where fenced code blocks with a language tag become code cells                             |
+| **`.md` MyST**     | [MyST Notebook](https://myst-nb.readthedocs.io/) format — `{code-cell}` directives and `+++` cell breaks |
+| **Sphinx Gallery** | [Sphinx-Gallery](https://sphinx-gallery.github.io/) `.py` scripts — RST docstring + `# %%` sections      |
+
+## Install
+
+```sh
+npm install plainb
+```
+
+## Usage
+
+```ts
+import { parse, parsePy, parseMd, parseSphinxGallery } from "plainb";
+
+// Auto-dispatch by format
+const notebook = parse(source, "py"); // or 'md' | 'sphinx-gallery'
+
+// Or call parsers directly
+const nb1 = parsePy(source); // .py percent format
+const nb2 = parseMd(source); // .md classic or MyST (auto-detected)
+const nb3 = parseSphinxGallery(source); // Sphinx Gallery
+```
+
+The returned object is a valid `nbformat.INotebookContent` (nbformat 4.5) — ready to save as `.ipynb` or pass to any Jupyter rendering library.
+
+## `.py` percent format
+
+```python
+# %% [markdown]
+# # Introduction
+# Some **markdown** text.
+
+# %%
+import numpy as np
+x = np.linspace(0, 1, 100)
+
+# %% My cell name tags='["hide-input"]'
+print(x)
+```
+
+- Cell type: `[markdown]`, `[md]`, `[raw]`, or omitted (defaults to code)
+- Cell name: free text after the type tag → stored in `metadata.name`
+- Tags: `tags='["tag1","tag2"]'` → stored in `metadata.tags`
+- Markdown content: line-comment prefix (`# `) or triple-quoted string (`"""`)
+
+## `.md` classic
+
+````markdown
+# My Notebook
+
+Some prose text becomes a **markdown cell**.
+
+```python
+x = 1 + 1
+```
+
+Only fenced blocks with a language identifier become code cells.
+Untagged fences stay as markdown.
+````
+
+## `.md` MyST
+
+````markdown
+---
+kernelspec: python3
+---
+
+# Title
+
++++ {"tags": ["hide-input"]}
+
+Markdown cell content.
+
+```{code-cell} ipython3
+:tags: ["parameters"]
+x = 42
+```
+````
+
+Supports `{code-cell}`, `{raw-cell}`, `{markdown-cell}` directives and `+++` cell breaks.
+
+## Sphinx Gallery
+
+```python
+"""
+================
+My Gallery Script
+================
+
+Module docstring becomes the first markdown cell.
+RST headings are converted to Markdown.
+"""
+
+# Authors: ...  ← stripped
+# SPDX-...      ← stripped
+
+# %%
+# Section heading
+# ---------------
+# Comment block becomes a markdown cell.
+
+import numpy as np   # code follows
+```
+
+## API
+
+```ts
+parse(text: string, format: 'py' | 'md' | 'sphinx-gallery'): Notebook
+
+parsePy(text: string): Notebook
+parseMd(text: string): Notebook          // auto-detects classic vs MyST
+parseSphinxGallery(text: string): Notebook
+
+// Types (re-exported from the package)
+interface Notebook   { nbformat: 4; nbformat_minor: 5; metadata: …; cells: Cell[] }
+type Cell            = CodeCell | MarkdownCell | RawCell
+```
+
+## Demo
+
+```sh
+git clone https://github.com/trungleduc/plainb
+cd plainb
+npm install
+npm run demo
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { parsePy } from "./parsePy.js";
+export { parseMd } from "./parseMd.js";
+export { parseSphinxGallery } from "./parseSphinxGallery.js";
+export type { Notebook, Cell, CodeCell, MarkdownCell, RawCell } from "./notebook.js";
+import type { Notebook } from "./notebook.js";
+export declare function parse(text: string, format: "py" | "md" | "sphinx-gallery"): Notebook;
+//# 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":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAKrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,gBAAgB,GAAG,QAAQ,CAKpF"}

package/dist/index.js

@@ -0,0 +1,16 @@
+export { parsePy } from "./parsePy.js";
+export { parseMd } from "./parseMd.js";
+export { parseSphinxGallery } from "./parseSphinxGallery.js";
+import { parsePy } from "./parsePy.js";
+import { parseMd } from "./parseMd.js";
+import { parseSphinxGallery } from "./parseSphinxGallery.js";
+export function parse(text, format) {
+    if (format === "py")
+        return parsePy(text);
+    if (format === "md")
+        return parseMd(text);
+    if (format === "sphinx-gallery")
+        return parseSphinxGallery(text);
+    throw new Error(`Unknown format: "${format}". Expected "py", "md", or "sphinx-gallery".`);
+}
+//# 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,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,MAAsC;IACxE,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,MAAM,KAAK,gBAAgB;QAAE,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,8CAA8C,CAAC,CAAC;AAC5F,CAAC"}

package/dist/notebook.d.ts

@@ -0,0 +1,34 @@
+export interface CodeCell {
+    cell_type: "code";
+    id: string;
+    metadata: Record<string, unknown>;
+    source: string[];
+    outputs: [];
+    execution_count: null;
+}
+export interface MarkdownCell {
+    cell_type: "markdown";
+    id: string;
+    metadata: Record<string, unknown>;
+    source: string[];
+}
+export interface RawCell {
+    cell_type: "raw";
+    id: string;
+    metadata: Record<string, unknown>;
+    source: string[];
+}
+export type Cell = CodeCell | MarkdownCell | RawCell;
+export interface Notebook {
+    nbformat: 4;
+    nbformat_minor: 5;
+    metadata: Record<string, unknown>;
+    cells: Cell[];
+}
+/** Convert a raw string into nbformat source array (lines with \n except last). */
+export declare function toSource(text: string): string[];
+export declare function codeCell(source: string, metadata?: Record<string, unknown>, used?: Set<string>): CodeCell;
+export declare function markdownCell(source: string, metadata?: Record<string, unknown>, used?: Set<string>): MarkdownCell;
+export declare function rawCell(source: string, metadata?: Record<string, unknown>, used?: Set<string>): RawCell;
+export declare function makeNotebook(cells: Cell[], metadata?: Record<string, unknown>): Notebook;
+//# sourceMappingURL=notebook.d.ts.map

package/dist/notebook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook.d.ts","sourceRoot":"","sources":["../src/notebook.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,EAAE,CAAC;IACZ,eAAe,EAAE,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,UAAU,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,KAAK,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,CAAC,CAAC;IACZ,cAAc,EAAE,CAAC,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAmBD,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAO/C;AAMD,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACtC,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,QAAQ,CASV;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACtC,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,YAAY,CAOd;AAED,wBAAgB,OAAO,CACrB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACtC,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,OAAO,CAOT;AAMD,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,QAAQ,CAE5F"}

package/dist/notebook.js

@@ -0,0 +1,62 @@
+// nbformat 4 types and factory helpers
+// ---------------------------------------------------------------------------
+// ID generation — no crypto, browser-safe
+// ---------------------------------------------------------------------------
+function makeId(used) {
+    let id;
+    do {
+        id = Math.random().toString(36).slice(2, 10).padEnd(8, "0");
+    } while (used.has(id));
+    used.add(id);
+    return id;
+}
+// ---------------------------------------------------------------------------
+// Source normalization
+// ---------------------------------------------------------------------------
+/** Convert a raw string into nbformat source array (lines with \n except last). */
+export function toSource(text) {
+    if (!text)
+        return [];
+    // Strip single trailing newline that separates cells (not part of content)
+    const stripped = text.endsWith("\n") ? text.slice(0, -1) : text;
+    if (!stripped)
+        return [];
+    const lines = stripped.split("\n");
+    return lines.map((line, i) => (i < lines.length - 1 ? line + "\n" : line));
+}
+// ---------------------------------------------------------------------------
+// Cell factories
+// ---------------------------------------------------------------------------
+export function codeCell(source, metadata = {}, used = new Set()) {
+    return {
+        cell_type: "code",
+        id: makeId(used),
+        metadata,
+        source: toSource(source),
+        outputs: [],
+        execution_count: null,
+    };
+}
+export function markdownCell(source, metadata = {}, used = new Set()) {
+    return {
+        cell_type: "markdown",
+        id: makeId(used),
+        metadata,
+        source: toSource(source),
+    };
+}
+export function rawCell(source, metadata = {}, used = new Set()) {
+    return {
+        cell_type: "raw",
+        id: makeId(used),
+        metadata,
+        source: toSource(source),
+    };
+}
+// ---------------------------------------------------------------------------
+// Notebook factory
+// ---------------------------------------------------------------------------
+export function makeNotebook(cells, metadata = {}) {
+    return { nbformat: 4, nbformat_minor: 5, metadata, cells };
+}
+//# sourceMappingURL=notebook.js.map

package/dist/notebook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook.js","sourceRoot":"","sources":["../src/notebook.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAkCvC,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,SAAS,MAAM,CAAC,IAAiB;IAC/B,IAAI,EAAU,CAAC;IACf,GAAG,CAAC;QACF,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;IACvB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACb,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,2EAA2E;IAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,UAAU,QAAQ,CACtB,MAAc,EACd,WAAoC,EAAE,EACtC,OAAoB,IAAI,GAAG,EAAE;IAE7B,OAAO;QACL,SAAS,EAAE,MAAM;QACjB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC;QAChB,QAAQ;QACR,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;QACxB,OAAO,EAAE,EAAE;QACX,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,WAAoC,EAAE,EACtC,OAAoB,IAAI,GAAG,EAAE;IAE7B,OAAO;QACL,SAAS,EAAE,UAAU;QACrB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC;QAChB,QAAQ;QACR,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,WAAoC,EAAE,EACtC,OAAoB,IAAI,GAAG,EAAE;IAE7B,OAAO;QACL,SAAS,EAAE,KAAK;QAChB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC;QAChB,QAAQ;QACR,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,WAAoC,EAAE;IAChF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7D,CAAC"}

package/dist/parseClassicMd.d.ts

@@ -0,0 +1,3 @@
+import { type Notebook } from "./notebook.js";
+export declare function parseClassicMd(text: string): Notebook;
+//# sourceMappingURL=parseClassicMd.d.ts.map

package/dist/parseClassicMd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseClassicMd.d.ts","sourceRoot":"","sources":["../src/parseClassicMd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAgB/F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA4CrD"}

package/dist/parseClassicMd.js

@@ -0,0 +1,55 @@
+import { codeCell, markdownCell, makeNotebook } from "./notebook.js";
+// ---------------------------------------------------------------------------
+// Classic markdown parser
+// Two states: MARKDOWN | IN_FENCE
+// Only language-tagged fences (```python, ```js, etc.) become code cells.
+// Untagged fences stay as markdown text.
+// ---------------------------------------------------------------------------
+// Opening fence with a required language identifier
+const OPENING_FENCE_RE = /^(`{3,})(\w[\w.-]*)\s*$/;
+// Generic fence close (same or longer fence)
+function isClosingFence(line, fence) {
+    return line.startsWith(fence) && line.slice(fence.length).trim() === "";
+}
+export function parseClassicMd(text) {
+    const lines = text.replace(/\r\n/g, "\n").split("\n");
+    const cells = [];
+    const used = new Set();
+    const mdLines = [];
+    function flushMarkdown() {
+        const trimmed = mdLines.join("\n").trim();
+        if (trimmed)
+            cells.push(markdownCell(trimmed, {}, used));
+        mdLines.length = 0;
+    }
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const fenceMatch = line.match(OPENING_FENCE_RE);
+        if (fenceMatch) {
+            const fence = fenceMatch[1]; // e.g. "```"
+            flushMarkdown();
+            // Collect code lines until closing fence
+            i++;
+            const codeLines = [];
+            while (i < lines.length && !isClosingFence(lines[i], fence)) {
+                codeLines.push(lines[i]);
+                i++;
+            }
+            i++; // skip closing fence (or EOF)
+            // Strip trailing blank lines from code
+            let end = codeLines.length;
+            while (end > 0 && codeLines[end - 1].trim() === "")
+                end--;
+            const source = codeLines.slice(0, end).join("\n");
+            cells.push(codeCell(source, {}, used));
+        }
+        else {
+            mdLines.push(line);
+            i++;
+        }
+    }
+    flushMarkdown();
+    return makeNotebook(cells);
+}
+//# sourceMappingURL=parseClassicMd.js.map

package/dist/parseClassicMd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseClassicMd.js","sourceRoot":"","sources":["../src/parseClassicMd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAA4B,MAAM,eAAe,CAAC;AAE/F,8EAA8E;AAC9E,0BAA0B;AAC1B,kCAAkC;AAClC,0EAA0E;AAC1E,yCAAyC;AACzC,8EAA8E;AAE9E,oDAAoD;AACpD,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AACnD,6CAA6C;AAC7C,SAAS,cAAc,CAAC,IAAY,EAAE,KAAa;IACjD,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,SAAS,aAAa;QACpB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAEhD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa;YAC1C,aAAa,EAAE,CAAC;YAEhB,yCAAyC;YACzC,CAAC,EAAE,CAAC;YACJ,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;gBAC5D,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzB,CAAC,EAAE,CAAC;YACN,CAAC;YACD,CAAC,EAAE,CAAC,CAAC,8BAA8B;YAEnC,uCAAuC;YACvC,IAAI,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;YAC3B,OAAO,GAAG,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,GAAG,EAAE,CAAC;YAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,aAAa,EAAE,CAAC;IAChB,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/parseMd.d.ts

@@ -0,0 +1,3 @@
+import type { Notebook } from "./notebook.js";
+export declare function parseMd(text: string): Notebook;
+//# sourceMappingURL=parseMd.d.ts.map

package/dist/parseMd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseMd.d.ts","sourceRoot":"","sources":["../src/parseMd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAc9C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE9C"}

package/dist/parseMd.js

@@ -0,0 +1,19 @@
+import { parseClassicMd } from "./parseClassicMd.js";
+import { parseMystMd } from "./parseMystMd.js";
+/** Detect MyST notebook format by scanning for {code-cell}/{raw-cell} directives or +++ breaks. */
+function isMyST(text) {
+    const lines = text.split("\n");
+    const limit = Math.min(lines.length, 100);
+    for (let i = 0; i < limit; i++) {
+        const line = lines[i];
+        if (/^```\{(?:code-cell|raw-cell|markdown-cell)\}/.test(line))
+            return true;
+        if (/^\+\+\+/.test(line))
+            return true;
+    }
+    return false;
+}
+export function parseMd(text) {
+    return isMyST(text) ? parseMystMd(text) : parseClassicMd(text);
+}
+//# sourceMappingURL=parseMd.js.map

package/dist/parseMd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseMd.js","sourceRoot":"","sources":["../src/parseMd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,mGAAmG;AACnG,SAAS,MAAM,CAAC,IAAY;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,8CAA8C,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3E,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC"}

package/dist/parseMystMd.d.ts

@@ -0,0 +1,3 @@
+import { type Notebook } from "./notebook.js";
+export declare function parseMystMd(text: string): Notebook;
+//# sourceMappingURL=parseMystMd.d.ts.map

package/dist/parseMystMd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseMystMd.d.ts","sourceRoot":"","sources":["../src/parseMystMd.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AAuFvB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAmIlD"}

package/dist/parseMystMd.js

@@ -0,0 +1,205 @@
+import { codeCell, markdownCell, rawCell, makeNotebook, } from "./notebook.js";
+// ---------------------------------------------------------------------------
+// MyST notebook format parser
+// Handles {code-cell}, {raw-cell}, {markdown-cell} directives
+// and +++ cell-break syntax
+// ---------------------------------------------------------------------------
+// ```{code-cell} ipython3   or   ```{raw-cell}
+const DIRECTIVE_OPEN_RE = /^(`{3,})\{([\w-]+)\}(?:\s+(\S+))?\s*$/;
+// +++ or +++ {"tags": [...]}
+const CELL_BREAK_RE = /^\+\+\+(?:\s+(\{.*\}))?\s*$/;
+// YAML shorthand option :key: value
+const SHORTHAND_RE = /^:([\w-]+):\s*(.*)/;
+const CELL_DIRECTIVES = new Set(["code-cell", "raw-cell", "markdown-cell"]);
+/** Extract the human-readable label from a MyST role content string.
+ *  ~some.dotted.path → last segment
+ *  label <target>    → label
+ *  plain text        → plain text
+ */
+function roleLabel(content) {
+    const angleMatch = content.match(/^(.+?)\s*<[^>]+>$/);
+    if (angleMatch)
+        return angleMatch[1].trim();
+    if (content.startsWith("~")) {
+        const parts = content.slice(1).split(".");
+        return parts[parts.length - 1];
+    }
+    return content;
+}
+/** Substitute MyST inline syntax into readable plain Markdown. */
+function substituteInlineRoles(line) {
+    // {math}`expr` → $expr$  (must run before the catch-all below)
+    line = line.replace(/\{math\}`([^`]*)`/g, (_, expr) => `$${expr}$`);
+    // {cite}`label` → remove (bibliography references add no value in a notebook)
+    line = line.replace(/\{cite\}`[^`]*`/g, "");
+    // {{ var }} → var  (substitution references — values not available)
+    line = line.replace(/\{\{\s*([\w.-]+)\s*\}\}/g, (_, name) => name);
+    // All remaining inline roles → plain display text
+    line = line.replace(/\{[\w-]+\}`([^`]*)`/g, (_, content) => roleLabel(content));
+    return line;
+}
+/** Minimal YAML/JSON option parser for cell metadata.
+ *  Handles flat key:value and key: [flow, list] only. */
+function parseOptions(lines) {
+    const result = {};
+    for (const line of lines) {
+        const m = line.match(/^([\w-]+):\s*(.*)/);
+        if (!m)
+            continue;
+        const key = m[1];
+        const val = m[2].trim();
+        if (val.startsWith("[") || val.startsWith("{")) {
+            try {
+                result[key] = JSON.parse(val);
+            }
+            catch {
+                result[key] = val;
+            }
+        }
+        else {
+            result[key] = val;
+        }
+    }
+    return result;
+}
+/** Parse notebook-level YAML front matter (---...---) into a plain object.
+ *  Only handles flat key: value pairs — sufficient for kernelspec. */
+function parseFrontMatter(yamlLines) {
+    const result = {};
+    for (const line of yamlLines) {
+        const m = line.match(/^([\w-]+):\s*(.*)/);
+        if (m)
+            result[m[1]] = m[2].trim();
+    }
+    return result;
+}
+function stripTrailingBlank(lines) {
+    let end = lines.length;
+    while (end > 0 && lines[end - 1].trim() === "")
+        end--;
+    return lines.slice(0, end);
+}
+export function parseMystMd(text) {
+    const lines = text.replace(/\r\n/g, "\n").split("\n");
+    const cells = [];
+    const used = new Set();
+    let notebookMeta = {};
+    const mdLines = [];
+    let pendingMeta = {};
+    function flushMarkdown() {
+        const trimmed = mdLines.join("\n").trim();
+        if (trimmed)
+            cells.push(markdownCell(trimmed, pendingMeta, used));
+        mdLines.length = 0;
+        pendingMeta = {};
+    }
+    let i = 0;
+    // Strip notebook-level front matter (---...---)
+    if (lines[0] === "---") {
+        i = 1;
+        const fmLines = [];
+        while (i < lines.length && lines[i] !== "---") {
+            fmLines.push(lines[i]);
+            i++;
+        }
+        i++; // skip closing ---
+        notebookMeta = parseFrontMatter(fmLines);
+    }
+    while (i < lines.length) {
+        const line = lines[i];
+        // +++ cell break
+        const breakMatch = line.match(CELL_BREAK_RE);
+        if (breakMatch) {
+            // Flush current markdown with its (empty) metadata, then set pending
+            // metadata for the NEXT cell that accumulates after this break
+            flushMarkdown();
+            if (breakMatch[1]) {
+                try {
+                    pendingMeta = JSON.parse(breakMatch[1]);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            i++;
+            continue;
+        }
+        // ```{directive} ...
+        const dirMatch = line.match(DIRECTIVE_OPEN_RE);
+        if (dirMatch) {
+            const fence = dirMatch[1];
+            const directive = dirMatch[2];
+            // {math} block → convert to $$ display math
+            if (directive === "math") {
+                i++;
+                const mathLines = [];
+                while (i < lines.length && !isClosingFence(lines[i], fence)) {
+                    mathLines.push(lines[i]);
+                    i++;
+                }
+                i++; // skip closing fence
+                const inner = stripTrailingBlank(mathLines).join("\n");
+                mdLines.push("$$");
+                if (inner)
+                    mdLines.push(inner);
+                mdLines.push("$$");
+                continue;
+            }
+            // Other non-cell directives ({note}, {try_on_binder}, etc.) stay as markdown text
+            if (!CELL_DIRECTIVES.has(directive)) {
+                mdLines.push(line);
+                i++;
+                continue;
+            }
+            flushMarkdown();
+            i++;
+            // Collect shorthand options (:key: value) or YAML block (---...---)
+            const optionLines = [];
+            if (lines[i] === "---") {
+                i++;
+                while (i < lines.length && lines[i] !== "---") {
+                    optionLines.push(lines[i]);
+                    i++;
+                }
+                i++; // skip closing ---
+            }
+            else {
+                while (i < lines.length && SHORTHAND_RE.test(lines[i])) {
+                    const m = lines[i].match(SHORTHAND_RE);
+                    optionLines.push(`${m[1]}: ${m[2]}`);
+                    i++;
+                }
+            }
+            const cellMeta = parseOptions(optionLines);
+            // Skip blank line after options
+            if (i < lines.length && lines[i].trim() === "")
+                i++;
+            // Collect content until closing fence
+            const contentLines = [];
+            while (i < lines.length && !isClosingFence(lines[i], fence)) {
+                contentLines.push(lines[i]);
+                i++;
+            }
+            i++; // skip closing fence
+            const source = stripTrailingBlank(contentLines).join("\n");
+            if (directive === "code-cell") {
+                cells.push(codeCell(source, cellMeta, used));
+            }
+            else if (directive === "raw-cell") {
+                cells.push(rawCell(source, cellMeta, used));
+            }
+            else {
+                cells.push(markdownCell(source, cellMeta, used));
+            }
+            continue;
+        }
+        mdLines.push(substituteInlineRoles(line));
+        i++;
+    }
+    flushMarkdown();
+    return makeNotebook(cells, notebookMeta);
+}
+function isClosingFence(line, fence) {
+    return line.startsWith(fence) && line.slice(fence.length).trim() === "";
+}
+//# sourceMappingURL=parseMystMd.js.map

package/dist/parseMystMd.js.map

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

package/dist/parsePy.d.ts

@@ -0,0 +1,3 @@
+import { type Notebook } from "./notebook.js";
+export declare function parsePy(text: string): Notebook;
+//# sourceMappingURL=parsePy.d.ts.map

package/dist/parsePy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsePy.d.ts","sourceRoot":"","sources":["../src/parsePy.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AA4EvB,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA2C9C"}

package/dist/parsePy.js

@@ -0,0 +1,109 @@
+import { codeCell, markdownCell, rawCell, makeNotebook, } from "./notebook.js";
+// ---------------------------------------------------------------------------
+// Percent format parser
+// ---------------------------------------------------------------------------
+// Matches: # %% optional-rest
+const DELIMITER_RE = /^# %%(.*)$/;
+// Matches cell type tag: [markdown], [md], [raw]
+const TYPE_TAG_RE = /\[(\w+)\]/;
+function parseCellHeader(rest) {
+    let s = rest.trim();
+    let cellType = "code";
+    const typeMatch = s.match(TYPE_TAG_RE);
+    if (typeMatch) {
+        const t = typeMatch[1].toLowerCase();
+        if (t === "markdown" || t === "md")
+            cellType = "markdown";
+        else if (t === "raw")
+            cellType = "raw";
+        s = s.replace(TYPE_TAG_RE, "").trim();
+    }
+    const metadata = {};
+    // Parse tags="[...]" or tags=['...']
+    const tagsMatch = s.match(/\btags\s*=\s*(['"])\[(.+?)\]\1/);
+    if (tagsMatch) {
+        try {
+            metadata.tags = JSON.parse("[" + tagsMatch[2] + "]");
+        }
+        catch {
+            // ignore malformed tags
+        }
+        s = s.replace(tagsMatch[0], "").trim();
+    }
+    // Remaining text is the cell title/name
+    if (s)
+        metadata.name = s;
+    return { cellType, metadata };
+}
+/** Strip leading `# ` (or bare `#`) comment prefix from markdown/raw cell lines. */
+function uncomment(lines) {
+    return lines
+        .map((line) => {
+        if (line === "#")
+            return "";
+        if (line.startsWith("# "))
+            return line.slice(2);
+        return line;
+    })
+        .join("\n");
+}
+/** Strip triple-quote wrappers from markdown cell content. */
+function stripTripleQuotes(lines) {
+    let start = 0;
+    let end = lines.length;
+    if (lines[0]?.trim() === '"""')
+        start = 1;
+    if (lines[end - 1]?.trim() === '"""')
+        end -= 1;
+    return lines.slice(start, end).join("\n");
+}
+function stripTrailingBlank(lines) {
+    let end = lines.length;
+    while (end > 0 && lines[end - 1].trim() === "")
+        end--;
+    return lines.slice(0, end);
+}
+export function parsePy(text) {
+    // Normalize line endings
+    const lines = text.replace(/\r\n/g, "\n").split("\n");
+    const cells = [];
+    const used = new Set();
+    // Find all delimiter positions
+    const delimiters = [];
+    for (let i = 0; i < lines.length; i++) {
+        const m = lines[i].match(DELIMITER_RE);
+        if (m)
+            delimiters.push({ idx: i, rest: m[1] });
+    }
+    if (delimiters.length === 0) {
+        // No delimiters — entire file is one code cell
+        const source = lines.join("\n");
+        if (source.trim())
+            cells.push(codeCell(source, {}, used));
+        return makeNotebook(cells);
+    }
+    for (let d = 0; d < delimiters.length; d++) {
+        const start = delimiters[d].idx + 1;
+        const end = d + 1 < delimiters.length ? delimiters[d + 1].idx : lines.length;
+        const { cellType, metadata } = parseCellHeader(delimiters[d].rest);
+        const rawLines = stripTrailingBlank(lines.slice(start, end));
+        if (cellType === "code") {
+            const source = rawLines.join("\n");
+            if (source.trim())
+                cells.push(codeCell(source, metadata, used));
+        }
+        else {
+            // markdown or raw
+            const isTripleQuote = rawLines[0]?.trim() === '"""';
+            const source = isTripleQuote ? stripTripleQuotes(rawLines) : uncomment(rawLines);
+            if (cellType === "markdown") {
+                cells.push(markdownCell(source, metadata, used));
+            }
+            else {
+                cells.push(rawCell(source, metadata, used));
+            }
+        }
+    }
+    return makeNotebook(cells);
+}
+//# sourceMappingURL=parsePy.js.map

package/dist/parsePy.js.map

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

package/dist/parseSphinxGallery.d.ts

@@ -0,0 +1,3 @@
+import { type Notebook } from "./notebook.js";
+export declare function parseSphinxGallery(text: string): Notebook;
+//# sourceMappingURL=parseSphinxGallery.d.ts.map

package/dist/parseSphinxGallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSphinxGallery.d.ts","sourceRoot":"","sources":["../src/parseSphinxGallery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAkH/F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAwDzD"}

package/dist/parseSphinxGallery.js

@@ -0,0 +1,153 @@
+import { codeCell, markdownCell, makeNotebook } from "./notebook.js";
+// ---------------------------------------------------------------------------
+// RST helpers
+// ---------------------------------------------------------------------------
+// RST underline character → markdown heading prefix
+const RST_HEADING = {
+    "=": "#",
+    "-": "##",
+    "^": "###",
+    "~": "####",
+    '"': "#####",
+};
+function isRstUnderline(s) {
+    return s.length >= 2 && /^([-=^~"*+#`'!])\1+$/.test(s);
+}
+/** Convert RST overline/underline headings to Markdown headings (in-place). */
+function rstHeadingsToMd(lines) {
+    const out = [];
+    let i = 0;
+    while (i < lines.length) {
+        const cur = lines[i];
+        const nxt = lines[i + 1] ?? "";
+        const aft = lines[i + 2] ?? "";
+        // Overline + title + underline (===\nTitle\n===)
+        if (isRstUnderline(cur) && nxt.trim() && isRstUnderline(aft) && cur[0] === aft[0]) {
+            out.push(`${RST_HEADING[cur[0]] ?? "#"} ${nxt.trim()}`);
+            i += 3;
+            continue;
+        }
+        // Title + underline (Title\n---)
+        if (cur.trim() && isRstUnderline(nxt)) {
+            out.push(`${RST_HEADING[nxt[0]] ?? "##"} ${cur.trim()}`);
+            i += 2;
+            continue;
+        }
+        out.push(cur);
+        i++;
+    }
+    return out;
+}
+/** Extract display label from RST role content string. */
+function rstRoleLabel(content) {
+    // `label <target>`_ or label <target>
+    const angleMatch = content.match(/^(.+?)\s*<[^>]+>`?_?$/);
+    if (angleMatch)
+        return angleMatch[1].trim().replace(/^`/, "");
+    // ~some.dotted.path → last segment
+    if (content.startsWith("~")) {
+        const parts = content.slice(1).split(".");
+        return parts[parts.length - 1];
+    }
+    return content;
+}
+/** Strip RST inline roles (:role:`content`) to plain readable text. */
+function substituteRstRoles(line) {
+    return line.replace(/:[\w-]+:`([^`]*)`/g, (_, content) => rstRoleLabel(content));
+}
+// ---------------------------------------------------------------------------
+// Comment/docstring stripping
+// ---------------------------------------------------------------------------
+function uncomment(lines) {
+    return lines.map((l) => (l === "#" ? "" : l.startsWith("# ") ? l.slice(2) : l));
+}
+function stripTrailingBlank(lines) {
+    let end = lines.length;
+    while (end > 0 && lines[end - 1].trim() === "")
+        end--;
+    return lines.slice(0, end);
+}
+function stripLeadingBlank(lines) {
+    let start = 0;
+    while (start < lines.length && lines[start].trim() === "")
+        start++;
+    return lines.slice(start);
+}
+/** Extract the module-level triple-quoted docstring. */
+function extractDocstring(lines) {
+    if (!lines[0]?.startsWith('"""'))
+        return null;
+    const afterOpen = lines[0].slice(3);
+    const sameLineClose = afterOpen.indexOf('"""');
+    if (sameLineClose >= 0) {
+        return { content: afterOpen.slice(0, sameLineClose), end: 1 };
+    }
+    const contentLines = afterOpen ? [afterOpen] : [];
+    for (let i = 1; i < lines.length; i++) {
+        const ci = lines[i].indexOf('"""');
+        if (ci >= 0) {
+            if (ci > 0)
+                contentLines.push(lines[i].slice(0, ci));
+            return { content: contentLines.join("\n"), end: i + 1 };
+        }
+        contentLines.push(lines[i]);
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Main parser
+// ---------------------------------------------------------------------------
+const DELIMITER_RE = /^# %%(.*)$/;
+export function parseSphinxGallery(text) {
+    const lines = text.replace(/\r\n/g, "\n").split("\n");
+    const cells = [];
+    const used = new Set();
+    let i = 0;
+    // 1. Module docstring → first markdown cell
+    const ds = extractDocstring(lines);
+    if (ds) {
+        const raw = ds.content.split("\n");
+        const converted = rstHeadingsToMd(raw).map(substituteRstRoles);
+        const trimmed = stripTrailingBlank(stripLeadingBlank(converted)).join("\n");
+        if (trimmed)
+            cells.push(markdownCell(trimmed, {}, used));
+        i = ds.end;
+    }
+    // 2. Skip lines before first # %% (authors, SPDX, blanks)
+    while (i < lines.length && !DELIMITER_RE.test(lines[i]))
+        i++;
+    // 3. Collect delimiter positions
+    const delimiters = [];
+    for (let j = i; j < lines.length; j++) {
+        if (DELIMITER_RE.test(lines[j]))
+            delimiters.push(j);
+    }
+    // 4. Process each section
+    for (let d = 0; d < delimiters.length; d++) {
+        const start = delimiters[d] + 1;
+        const end = d + 1 < delimiters.length ? delimiters[d + 1] : lines.length;
+        const section = lines.slice(start, end);
+        // Split: leading comment lines → markdown, rest → code
+        let split = 0;
+        while (split < section.length && section[split].startsWith("#"))
+            split++;
+        const commentLines = section.slice(0, split);
+        // Skip blank separator between comment block and code
+        let codeStart = split;
+        while (codeStart < section.length && section[codeStart].trim() === "")
+            codeStart++;
+        const codeLines = stripTrailingBlank(section.slice(codeStart));
+        if (commentLines.length > 0) {
+            const raw = uncomment(commentLines);
+            const converted = rstHeadingsToMd(raw).map(substituteRstRoles);
+            const mdText = stripTrailingBlank(converted).join("\n").trim();
+            if (mdText)
+                cells.push(markdownCell(mdText, {}, used));
+        }
+        if (codeLines.length > 0) {
+            cells.push(codeCell(codeLines.join("\n"), {}, used));
+        }
+    }
+    return makeNotebook(cells);
+}
+//# sourceMappingURL=parseSphinxGallery.js.map

package/dist/parseSphinxGallery.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "plainb",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Convert plain text (.py percent format, .md classic/MyST) to Jupyter nbformat 4 JSON",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/trungleduc/plainb"
+  },
+  "homepage": "https://github.com/trungleduc/plainb",
+  "license": "MIT",
+  "scripts": {
+    "prepublishOnly": "npm run build && npm test",
+    "build": "tsc",
+    "test": "node --test --import tsx test/*.test.ts",
+    "lint": "eslint src",
+    "format": "prettier --write src",
+    "demo": "npm run --prefix demo dev",
+    "demo:build": "npm run --prefix demo build"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.0.3",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0",
+    "typescript-eslint": "^8.57.0"
+  }
+}