plainb 1.1.0 → 1.2.0

package/README.md

@@ -133,7 +133,7 @@ type Cell            = CodeCell | MarkdownCell | RawCell
 ## Demo
 
 ```sh
-git clone https://github.com/trungleduc/plainb
+git clone https://github.com/notebook-link/plainb
 cd plainb
 npm install
 npm run demo

package/dist/index.d.ts

@@ -4,6 +4,11 @@ export * from "./parseClassicMd";
 export * from "./parseMystMd";
 export * from "./parseSphinxGallery";
 export * from "./notebook";
+export * from "./toPy";
+export * from "./toClassicMd";
+export * from "./toMystMd";
+export * from "./toSphinxGallery";
 import type { Notebook } from "./notebook";
 export declare function parse(text: string, format: "py" | "md" | "sphinx-gallery"): Notebook;
+export declare function serialize(notebook: Notebook, format: "py" | "md" | "sphinx-gallery"): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAK3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,gBAAgB,GAAG,QAAQ,CAKpF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAQlC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,gBAAgB,GAAG,QAAQ,CAKpF;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,gBAAgB,GAAG,MAAM,CAK5F"}

package/dist/index.js

@@ -4,9 +4,16 @@ export * from "./parseClassicMd";
 export * from "./parseMystMd";
 export * from "./parseSphinxGallery";
 export * from "./notebook";
+export * from "./toPy";
+export * from "./toClassicMd";
+export * from "./toMystMd";
+export * from "./toSphinxGallery";
 import { parsePy } from "./parsePy";
 import { parseMd } from "./parseMd";
 import { parseSphinxGallery } from "./parseSphinxGallery";
+import { toPy } from "./toPy";
+import { toMystMd } from "./toMystMd";
+import { toSphinxGallery } from "./toSphinxGallery";
 export function parse(text, format) {
     if (format === "py")
         return parsePy(text);
@@ -16,4 +23,13 @@ export function parse(text, format) {
         return parseSphinxGallery(text);
     throw new Error(`Unknown format: "${format}". Expected "py", "md", or "sphinx-gallery".`);
 }
+export function serialize(notebook, format) {
+    if (format === "py")
+        return toPy(notebook);
+    if (format === "md")
+        return toMystMd(notebook);
+    if (format === "sphinx-gallery")
+        return toSphinxGallery(notebook);
+    throw new Error(`Unknown format: "${format}". Expected "py", "md", or "sphinx-gallery".`);
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,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;AAED,MAAM,UAAU,SAAS,CAAC,QAAkB,EAAE,MAAsC;IAClF,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,MAAM,KAAK,gBAAgB;QAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClE,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,8CAA8C,CAAC,CAAC;AAC5F,CAAC"}

package/dist/toClassicMd.d.ts

@@ -0,0 +1,14 @@
+import type { Notebook } from "./notebook";
+/**
+ * Serialize a `Notebook` to classic Markdown format.
+ *
+ * - Markdown cells → raw text
+ * - Code cells → fenced code block (`` ```language ```)
+ * - Raw cells are omitted (no representation in classic Markdown)
+ *
+ * Cell metadata is not preserved — the classic format carries no metadata.
+ *
+ * @param language Fence language tag for code cells. Defaults to `"python"`.
+ */
+export declare function toClassicMd(notebook: Notebook, language?: string): string;
+//# sourceMappingURL=toClassicMd.d.ts.map

package/dist/toClassicMd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toClassicMd.d.ts","sourceRoot":"","sources":["../src/toClassicMd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAU3C;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,SAAW,GAAG,MAAM,CAe3E"}

package/dist/toClassicMd.js

@@ -0,0 +1,34 @@
+// ---------------------------------------------------------------------------
+// Notebook → Classic Markdown serializer
+// ---------------------------------------------------------------------------
+function joinSource(source) {
+    return source.join("");
+}
+/**
+ * Serialize a `Notebook` to classic Markdown format.
+ *
+ * - Markdown cells → raw text
+ * - Code cells → fenced code block (`` ```language ```)
+ * - Raw cells are omitted (no representation in classic Markdown)
+ *
+ * Cell metadata is not preserved — the classic format carries no metadata.
+ *
+ * @param language Fence language tag for code cells. Defaults to `"python"`.
+ */
+export function toClassicMd(notebook, language = "python") {
+    const parts = [];
+    for (const cell of notebook.cells) {
+        if (cell.cell_type === "markdown") {
+            const src = joinSource(cell.source);
+            if (src)
+                parts.push(src);
+        }
+        else if (cell.cell_type === "code") {
+            const src = joinSource(cell.source);
+            parts.push(`\`\`\`${language}\n${src}\n\`\`\``);
+        }
+        // raw cells: no representation in classic Markdown
+    }
+    return parts.join("\n\n") + "\n";
+}
+//# sourceMappingURL=toClassicMd.js.map

package/dist/toClassicMd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toClassicMd.js","sourceRoot":"","sources":["../src/toClassicMd.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,SAAS,UAAU,CAAC,MAAgB;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,QAAkB,EAAE,QAAQ,GAAG,QAAQ;IACjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,KAAK,GAAG,UAAU,CAAC,CAAC;QAClD,CAAC;QACD,mDAAmD;IACrD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AACnC,CAAC"}

package/dist/toMystMd.d.ts

@@ -0,0 +1,11 @@
+import type { Notebook } from "./notebook";
+/**
+ * Serialize a `Notebook` to MyST Notebook Markdown.
+ *
+ * - Notebook metadata → YAML front matter (`---...---`)
+ * - Markdown cells → plain text separated by `+++` (with JSON metadata inline)
+ * - Code cells → ` ```{code-cell} ` directive with shorthand options
+ * - Raw cells  → ` ```{raw-cell} ` directive with shorthand options
+ */
+export declare function toMystMd(notebook: Notebook): string;
+//# sourceMappingURL=toMystMd.d.ts.map

package/dist/toMystMd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toMystMd.d.ts","sourceRoot":"","sources":["../src/toMystMd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAgB3C;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA+BnD"}

package/dist/toMystMd.js

@@ -0,0 +1,51 @@
+// ---------------------------------------------------------------------------
+// Notebook → MyST Markdown serializer
+// ---------------------------------------------------------------------------
+function joinSource(source) {
+    return source.join("");
+}
+function serializeOptions(meta) {
+    return Object.entries(meta).map(([key, val]) => typeof val === "string" ? `:${key}: ${val}` : `:${key}: ${JSON.stringify(val)}`);
+}
+/**
+ * Serialize a `Notebook` to MyST Notebook Markdown.
+ *
+ * - Notebook metadata → YAML front matter (`---...---`)
+ * - Markdown cells → plain text separated by `+++` (with JSON metadata inline)
+ * - Code cells → ` ```{code-cell} ` directive with shorthand options
+ * - Raw cells  → ` ```{raw-cell} ` directive with shorthand options
+ */
+export function toMystMd(notebook) {
+    const parts = [];
+    if (Object.keys(notebook.metadata).length > 0) {
+        const lines = Object.entries(notebook.metadata).map(([k, v]) => `${k}: ${v}`);
+        parts.push(`---\n${lines.join("\n")}\n---`);
+    }
+    for (const cell of notebook.cells) {
+        if (cell.cell_type === "markdown") {
+            const hasMeta = Object.keys(cell.metadata).length > 0;
+            if (parts.length > 0 || hasMeta) {
+                const metaStr = hasMeta ? ` ${JSON.stringify(cell.metadata)}` : "";
+                parts.push(`+++${metaStr}`);
+            }
+            const src = joinSource(cell.source);
+            if (src)
+                parts.push(src);
+        }
+        else {
+            const directive = cell.cell_type === "code" ? "code-cell" : "raw-cell";
+            const lines = [`\`\`\`{${directive}}`];
+            const optionLines = serializeOptions(cell.metadata);
+            lines.push(...optionLines);
+            if (optionLines.length > 0)
+                lines.push("");
+            const src = joinSource(cell.source);
+            if (src)
+                lines.push(src);
+            lines.push("```");
+            parts.push(lines.join("\n"));
+        }
+    }
+    return parts.join("\n\n") + "\n";
+}
+//# sourceMappingURL=toMystMd.js.map

package/dist/toMystMd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toMystMd.js","sourceRoot":"","sources":["../src/toMystMd.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAE9E,SAAS,UAAU,CAAC,MAAgB;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA6B;IACrD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAC7C,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAChF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAkB;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YACtD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;gBAChC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;YAC9B,CAAC;YACD,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;YACvE,MAAM,KAAK,GAAa,CAAC,UAAU,SAAS,GAAG,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YAC3B,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AACnC,CAAC"}

package/dist/toPy.d.ts

@@ -0,0 +1,11 @@
+import type { Notebook } from "./notebook";
+/**
+ * Serialize a `Notebook` to the Python percent format (VS Code / Spyder / Jupytext).
+ *
+ * - Code cells → `# %%` delimiter + bare source
+ * - Markdown cells → `# %% [markdown]` delimiter + `# `-prefixed lines
+ * - Raw cells → `# %% [raw]` delimiter + `# `-prefixed lines
+ * - Cell name and tags from metadata are encoded in the delimiter line
+ */
+export declare function toPy(notebook: Notebook): string;
+//# sourceMappingURL=toPy.d.ts.map

package/dist/toPy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toPy.d.ts","sourceRoot":"","sources":["../src/toPy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA6B3C;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAe/C"}

package/dist/toPy.js

@@ -0,0 +1,49 @@
+// ---------------------------------------------------------------------------
+// Notebook → Python percent format serializer
+// ---------------------------------------------------------------------------
+function joinSource(source) {
+    return source.join("");
+}
+/** Prefix each line with `# ` (empty lines become bare `#`). */
+function commentLines(text) {
+    return text
+        .split("\n")
+        .map((line) => (line === "" ? "#" : `# ${line}`))
+        .join("\n");
+}
+function buildDelimiter(cellType, meta) {
+    const parts = ["# %%"];
+    if (cellType === "markdown")
+        parts.push("[markdown]");
+    else if (cellType === "raw")
+        parts.push("[raw]");
+    if (typeof meta.name === "string" && meta.name)
+        parts.push(meta.name);
+    if (Array.isArray(meta.tags) && meta.tags.length > 0) {
+        parts.push(`tags='${JSON.stringify(meta.tags)}'`);
+    }
+    return parts.join(" ");
+}
+/**
+ * Serialize a `Notebook` to the Python percent format (VS Code / Spyder / Jupytext).
+ *
+ * - Code cells → `# %%` delimiter + bare source
+ * - Markdown cells → `# %% [markdown]` delimiter + `# `-prefixed lines
+ * - Raw cells → `# %% [raw]` delimiter + `# `-prefixed lines
+ * - Cell name and tags from metadata are encoded in the delimiter line
+ */
+export function toPy(notebook) {
+    const parts = [];
+    for (const cell of notebook.cells) {
+        const delimiter = buildDelimiter(cell.cell_type, cell.metadata);
+        const src = joinSource(cell.source);
+        if (cell.cell_type === "code") {
+            parts.push(src ? `${delimiter}\n${src}` : delimiter);
+        }
+        else {
+            parts.push(src ? `${delimiter}\n${commentLines(src)}` : delimiter);
+        }
+    }
+    return parts.join("\n\n") + "\n";
+}
+//# sourceMappingURL=toPy.js.map

package/dist/toPy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toPy.js","sourceRoot":"","sources":["../src/toPy.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,SAAS,UAAU,CAAC,MAAgB;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,gEAAgE;AAChE,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;SAChD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,IAA6B;IACrE,MAAM,KAAK,GAAa,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,QAAQ,KAAK,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;SACjD,IAAI,QAAQ,KAAK,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAAC,QAAkB;IACrC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpC,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AACnC,CAAC"}

package/dist/toSphinxGallery.d.ts

@@ -0,0 +1,13 @@
+import type { Notebook } from "./notebook";
+/**
+ * Serialize a `Notebook` to Sphinx Gallery Python script format.
+ *
+ * - First markdown cell → module-level triple-quoted docstring
+ * - Remaining markdown cells → `# %%` section with `# `-prefixed comment block
+ * - Code cells → `# %%` section with bare source
+ * - Adjacent [markdown, code] pairs are merged into a single `# %%` section
+ *   (comment block above the code), matching how `parseSphinxGallery` splits them
+ * - Raw cells are omitted
+ */
+export declare function toSphinxGallery(notebook: Notebook): string;
+//# sourceMappingURL=toSphinxGallery.d.ts.map

package/dist/toSphinxGallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toSphinxGallery.d.ts","sourceRoot":"","sources":["../src/toSphinxGallery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkB3C;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAsC1D"}

package/dist/toSphinxGallery.js

@@ -0,0 +1,60 @@
+// ---------------------------------------------------------------------------
+// Notebook → Sphinx Gallery format serializer
+// ---------------------------------------------------------------------------
+function joinSource(source) {
+    return source.join("");
+}
+/** Prefix each line with `# ` (empty lines become bare `#`). */
+function commentLines(text) {
+    return text
+        .split("\n")
+        .map((line) => (line === "" ? "#" : `# ${line}`))
+        .join("\n");
+}
+/**
+ * Serialize a `Notebook` to Sphinx Gallery Python script format.
+ *
+ * - First markdown cell → module-level triple-quoted docstring
+ * - Remaining markdown cells → `# %%` section with `# `-prefixed comment block
+ * - Code cells → `# %%` section with bare source
+ * - Adjacent [markdown, code] pairs are merged into a single `# %%` section
+ *   (comment block above the code), matching how `parseSphinxGallery` splits them
+ * - Raw cells are omitted
+ */
+export function toSphinxGallery(notebook) {
+    const parts = [];
+    const cells = notebook.cells.filter((c) => c.cell_type !== "raw");
+    let i = 0;
+    // First markdown cell → docstring
+    if (cells[0]?.cell_type === "markdown") {
+        const src = joinSource(cells[0].source);
+        parts.push(`"""\n${src}\n"""`);
+        i = 1;
+    }
+    while (i < cells.length) {
+        const cell = cells[i];
+        if (cell.cell_type === "markdown") {
+            const mdSrc = joinSource(cell.source);
+            const next = cells[i + 1];
+            if (next?.cell_type === "code") {
+                // Merge adjacent [markdown, code] into one section
+                const codeSrc = joinSource(next.source);
+                const section = `# %%\n${commentLines(mdSrc)}`;
+                parts.push(codeSrc ? `${section}\n\n${codeSrc}` : section);
+                i += 2;
+            }
+            else {
+                parts.push(`# %%\n${commentLines(mdSrc)}`);
+                i++;
+            }
+        }
+        else {
+            // code cell
+            const src = joinSource(cell.source);
+            parts.push(`# %%\n${src}`);
+            i++;
+        }
+    }
+    return parts.join("\n\n") + "\n";
+}
+//# sourceMappingURL=toSphinxGallery.js.map

package/dist/toSphinxGallery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toSphinxGallery.js","sourceRoot":"","sources":["../src/toSphinxGallery.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,SAAS,UAAU,CAAC,MAAgB;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,gEAAgE;AAChE,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;SAChD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,QAAkB;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,kCAAkC;IAClC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,KAAK,UAAU,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;QAC/B,CAAC,GAAG,CAAC,CAAC;IACR,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,IAAI,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAE1B,IAAI,IAAI,EAAE,SAAS,KAAK,MAAM,EAAE,CAAC;gBAC/B,mDAAmD;gBACnD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxC,MAAM,OAAO,GAAG,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC3D,CAAC,IAAI,CAAC,CAAC;YACT,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC3C,CAAC,EAAE,CAAC;YACN,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY;YACZ,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;YAC3B,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AACnC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plainb",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Convert plain text (.py percent format, .md classic/MyST) to Jupyter nbformat 4 JSON",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -10,9 +10,9 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/trungleduc/plainb"
+    "url": "https://github.com/notebook-link/plainb"
   },
-  "homepage": "https://github.com/trungleduc/plainb",
+  "homepage": "https://github.com/notebook-link/plainb",
   "license": "MIT",
   "scripts": {
     "build": "tsc",