npm - @bendyline/squisq-formats - Versions diffs - 1.3.0 → 1.4.0 - Mend

@bendyline/squisq-formats 1.3.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (224) hide show

package/dist/chunk-6M7Z25LA.js +46 -0
package/dist/chunk-6M7Z25LA.js.map +1 -0
package/dist/{chunk-S3Y7H2BK.js → chunk-APSIAEXL.js} +9 -8
package/dist/chunk-APSIAEXL.js.map +1 -0
package/dist/{chunk-UDS45KUJ.js → chunk-BJQIJ4S4.js} +36 -52
package/dist/chunk-BJQIJ4S4.js.map +1 -0
package/dist/{chunk-33YRFXZZ.js → chunk-CRTC6DEX.js} +259 -13
package/dist/chunk-CRTC6DEX.js.map +1 -0
package/dist/chunk-FMOIGA5T.js +201 -0
package/dist/chunk-FMOIGA5T.js.map +1 -0
package/dist/{chunk-VN2KEOYB.js → chunk-I2GFTEOV.js} +321 -91
package/dist/chunk-I2GFTEOV.js.map +1 -0
package/dist/chunk-JBNVE2GV.js +116 -0
package/dist/chunk-JBNVE2GV.js.map +1 -0
package/dist/chunk-L53YIGYS.js +141 -0
package/dist/chunk-L53YIGYS.js.map +1 -0
package/dist/{chunk-ERZ627GR.js → chunk-ON232HJR.js} +11 -26
package/dist/chunk-ON232HJR.js.map +1 -0
package/dist/chunk-PN52A5AA.js +32 -0
package/dist/chunk-PN52A5AA.js.map +1 -0
package/dist/{chunk-7DEUGIOO.js → chunk-QSE7EWE7.js} +12 -87
package/dist/chunk-QSE7EWE7.js.map +1 -0
package/dist/container/index.d.ts +7 -5
package/dist/container/index.js +39 -70
package/dist/container/index.js.map +1 -1
package/dist/csv/index.d.ts +37 -0
package/dist/csv/index.js +13 -0
package/dist/csv/index.js.map +1 -0
package/dist/docx/index.d.ts +128 -15
package/dist/docx/index.js +19 -22
package/dist/docx/index.js.map +1 -1
package/dist/epub/index.d.ts +66 -11
package/dist/epub/index.js +11 -18
package/dist/epub/index.js.map +1 -1
package/dist/html/index.d.ts +315 -15
package/dist/html/index.js +32 -165
package/dist/html/index.js.map +1 -1
package/dist/index.d.ts +10 -38
package/dist/index.js +80 -37
package/dist/index.js.map +1 -1
package/dist/ooxml/index.d.ts +353 -14
package/dist/ooxml/index.js +116 -22
package/dist/ooxml/index.js.map +1 -1
package/dist/pdf/index.d.ts +143 -17
package/dist/pdf/index.js +16 -25
package/dist/pdf/index.js.map +1 -1
package/dist/pptx/index.d.ts +98 -21
package/dist/pptx/index.js +18 -34
package/dist/pptx/index.js.map +1 -1
package/dist/xlsx/index.d.ts +29 -25
package/dist/xlsx/index.js +13 -44
package/dist/xlsx/index.js.map +1 -1
package/package.json +7 -2
package/src/__tests__/csvImport.test.ts +51 -0
package/src/__tests__/exportThemeReconciliation.test.ts +87 -0
package/src/__tests__/htmlImport.test.ts +57 -0
package/src/__tests__/plainHtml.test.ts +31 -0
package/src/__tests__/pptxExport.test.ts +138 -0
package/src/__tests__/pptxImport.test.ts +70 -0
package/src/__tests__/roundTripMatrix.fixtures.ts +86 -0
package/src/__tests__/roundTripMatrix.helpers.ts +154 -0
package/src/__tests__/roundTripMatrix.test.ts +136 -0
package/src/__tests__/xlsxImport.test.ts +80 -0
package/src/csv/index.ts +165 -0
package/src/docx/export.ts +27 -44
package/src/docx/import.ts +1 -2
package/src/epub/export.ts +10 -27
package/src/html/import.ts +297 -0
package/src/html/index.ts +4 -0
package/src/html/plainHtml.ts +66 -16
package/src/index.ts +10 -3
package/src/ooxml/namespaces.ts +3 -0
package/src/pdf/export.ts +10 -5
package/src/pdf/import.ts +1 -1
package/src/pptx/export.ts +225 -85
package/src/pptx/import.ts +156 -0
package/src/pptx/index.ts +10 -28
package/src/shared/inlineRuns.ts +99 -0
package/src/shared/text.ts +41 -0
package/src/xlsx/import.ts +159 -0
package/src/xlsx/index.ts +11 -28
package/dist/__tests__/container.test.d.ts +0 -8
package/dist/__tests__/container.test.d.ts.map +0 -1
package/dist/__tests__/container.test.js +0 -147
package/dist/__tests__/container.test.js.map +0 -1
package/dist/__tests__/docxExport.test.d.ts +0 -8
package/dist/__tests__/docxExport.test.d.ts.map +0 -1
package/dist/__tests__/docxExport.test.js +0 -383
package/dist/__tests__/docxExport.test.js.map +0 -1
package/dist/__tests__/docxImport.test.d.ts +0 -8
package/dist/__tests__/docxImport.test.d.ts.map +0 -1
package/dist/__tests__/docxImport.test.js +0 -309
package/dist/__tests__/docxImport.test.js.map +0 -1
package/dist/__tests__/epub.test.d.ts +0 -8
package/dist/__tests__/epub.test.d.ts.map +0 -1
package/dist/__tests__/epub.test.js +0 -472
package/dist/__tests__/epub.test.js.map +0 -1
package/dist/__tests__/html.test.d.ts +0 -8
package/dist/__tests__/html.test.d.ts.map +0 -1
package/dist/__tests__/html.test.js +0 -317
package/dist/__tests__/html.test.js.map +0 -1
package/dist/__tests__/ooxml.test.d.ts +0 -5
package/dist/__tests__/ooxml.test.d.ts.map +0 -1
package/dist/__tests__/ooxml.test.js +0 -152
package/dist/__tests__/ooxml.test.js.map +0 -1
package/dist/__tests__/pdfExport.test.d.ts +0 -8
package/dist/__tests__/pdfExport.test.d.ts.map +0 -1
package/dist/__tests__/pdfExport.test.js +0 -275
package/dist/__tests__/pdfExport.test.js.map +0 -1
package/dist/__tests__/pdfImport.test.d.ts +0 -11
package/dist/__tests__/pdfImport.test.d.ts.map +0 -1
package/dist/__tests__/pdfImport.test.js +0 -254
package/dist/__tests__/pdfImport.test.js.map +0 -1
package/dist/__tests__/plainHtml.test.d.ts +0 -5
package/dist/__tests__/plainHtml.test.d.ts.map +0 -1
package/dist/__tests__/plainHtml.test.js +0 -327
package/dist/__tests__/plainHtml.test.js.map +0 -1
package/dist/__tests__/plainHtmlBundle.test.d.ts +0 -11
package/dist/__tests__/plainHtmlBundle.test.d.ts.map +0 -1
package/dist/__tests__/plainHtmlBundle.test.js +0 -210
package/dist/__tests__/plainHtmlBundle.test.js.map +0 -1
package/dist/__tests__/roundTrip.test.d.ts +0 -7
package/dist/__tests__/roundTrip.test.d.ts.map +0 -1
package/dist/__tests__/roundTrip.test.js +0 -173
package/dist/__tests__/roundTrip.test.js.map +0 -1
package/dist/chunk-33YRFXZZ.js.map +0 -1
package/dist/chunk-67KIJHV2.js +0 -21
package/dist/chunk-67KIJHV2.js.map +0 -1
package/dist/chunk-7DEUGIOO.js.map +0 -1
package/dist/chunk-ERZ627GR.js.map +0 -1
package/dist/chunk-S3Y7H2BK.js.map +0 -1
package/dist/chunk-UDS45KUJ.js.map +0 -1
package/dist/chunk-VN2KEOYB.js.map +0 -1
package/dist/chunk-YN5HFCEW.js +0 -120
package/dist/chunk-YN5HFCEW.js.map +0 -1
package/dist/container/index.d.ts.map +0 -1
package/dist/docx/export.d.ts +0 -69
package/dist/docx/export.d.ts.map +0 -1
package/dist/docx/export.js +0 -985
package/dist/docx/export.js.map +0 -1
package/dist/docx/import.d.ts +0 -65
package/dist/docx/import.d.ts.map +0 -1
package/dist/docx/import.js +0 -779
package/dist/docx/import.js.map +0 -1
package/dist/docx/index.d.ts.map +0 -1
package/dist/docx/styles.d.ts +0 -68
package/dist/docx/styles.d.ts.map +0 -1
package/dist/docx/styles.js +0 -125
package/dist/docx/styles.js.map +0 -1
package/dist/epub/export.d.ts +0 -72
package/dist/epub/export.d.ts.map +0 -1
package/dist/epub/export.js +0 -698
package/dist/epub/export.js.map +0 -1
package/dist/epub/index.d.ts.map +0 -1
package/dist/html/docsHtmlBundle.d.ts +0 -53
package/dist/html/docsHtmlBundle.d.ts.map +0 -1
package/dist/html/docsHtmlBundle.js +0 -299
package/dist/html/docsHtmlBundle.js.map +0 -1
package/dist/html/htmlTemplate.d.ts +0 -70
package/dist/html/htmlTemplate.d.ts.map +0 -1
package/dist/html/htmlTemplate.js +0 -282
package/dist/html/htmlTemplate.js.map +0 -1
package/dist/html/imageUtils.d.ts +0 -29
package/dist/html/imageUtils.d.ts.map +0 -1
package/dist/html/imageUtils.js +0 -63
package/dist/html/imageUtils.js.map +0 -1
package/dist/html/index.d.ts.map +0 -1
package/dist/html/plainHtml.d.ts +0 -79
package/dist/html/plainHtml.d.ts.map +0 -1
package/dist/html/plainHtml.js +0 -614
package/dist/html/plainHtml.js.map +0 -1
package/dist/html/plainHtmlBundle.d.ts +0 -93
package/dist/html/plainHtmlBundle.d.ts.map +0 -1
package/dist/html/plainHtmlBundle.js +0 -357
package/dist/html/plainHtmlBundle.js.map +0 -1
package/dist/index.d.ts.map +0 -1
package/dist/ooxml/index.d.ts.map +0 -1
package/dist/ooxml/namespaces.d.ts +0 -77
package/dist/ooxml/namespaces.d.ts.map +0 -1
package/dist/ooxml/namespaces.js +0 -104
package/dist/ooxml/namespaces.js.map +0 -1
package/dist/ooxml/reader.d.ts +0 -52
package/dist/ooxml/reader.d.ts.map +0 -1
package/dist/ooxml/reader.js +0 -190
package/dist/ooxml/reader.js.map +0 -1
package/dist/ooxml/types.d.ts +0 -82
package/dist/ooxml/types.d.ts.map +0 -1
package/dist/ooxml/types.js +0 -9
package/dist/ooxml/types.js.map +0 -1
package/dist/ooxml/writer.d.ts +0 -71
package/dist/ooxml/writer.d.ts.map +0 -1
package/dist/ooxml/writer.js +0 -200
package/dist/ooxml/writer.js.map +0 -1
package/dist/ooxml/xmlUtils.d.ts +0 -76
package/dist/ooxml/xmlUtils.d.ts.map +0 -1
package/dist/ooxml/xmlUtils.js +0 -108
package/dist/ooxml/xmlUtils.js.map +0 -1
package/dist/pdf/export.d.ts +0 -56
package/dist/pdf/export.d.ts.map +0 -1
package/dist/pdf/export.js +0 -768
package/dist/pdf/export.js.map +0 -1
package/dist/pdf/import.d.ts +0 -94
package/dist/pdf/import.d.ts.map +0 -1
package/dist/pdf/import.js +0 -796
package/dist/pdf/import.js.map +0 -1
package/dist/pdf/index.d.ts.map +0 -1
package/dist/pdf/styles.d.ts +0 -142
package/dist/pdf/styles.d.ts.map +0 -1
package/dist/pdf/styles.js +0 -145
package/dist/pdf/styles.js.map +0 -1
package/dist/pptx/export.d.ts +0 -75
package/dist/pptx/export.d.ts.map +0 -1
package/dist/pptx/export.js +0 -724
package/dist/pptx/export.js.map +0 -1
package/dist/pptx/index.d.ts.map +0 -1
package/dist/pptx/styles.d.ts +0 -54
package/dist/pptx/styles.d.ts.map +0 -1
package/dist/pptx/styles.js +0 -73
package/dist/pptx/styles.js.map +0 -1
package/dist/pptx/templates.d.ts +0 -24
package/dist/pptx/templates.d.ts.map +0 -1
package/dist/pptx/templates.js +0 -158
package/dist/pptx/templates.js.map +0 -1
package/dist/xlsx/index.d.ts.map +0 -1

package/src/__tests__/roundTripMatrix.test.ts ADDED Viewed

@@ -0,0 +1,136 @@
+import { describe, expect, it } from 'vitest';
+import JSZip from 'jszip';
+import { markdownToDoc } from '@bendyline/squisq/doc';
+import { markdownDocToDocx } from '../docx/export';
+import { docxToMarkdownDoc } from '../docx/import';
+import { markdownDocToPptx } from '../pptx/export';
+import { pptxToMarkdownDoc } from '../pptx/import';
+import { markdownDocToPdf } from '../pdf/export';
+import { pdfToMarkdownDoc } from '../pdf/import';
+import { markdownDocToCsv, csvToMarkdownDoc } from '../csv/index';
+import { markdownDocToEpub } from '../epub/export';
+import { docToHtml } from '../html/index';
+import { markdownDocToXlsx } from '../xlsx/index';
+import { assertHybridRoundTrip, extractNormalizedText } from './roundTripMatrix.helpers';
+import { ROUNDTRIP_FIXTURES } from './roundTripMatrix.fixtures';
+const MOCK_PLAYER_SCRIPT = 'var SquisqPlayer={mount:function(){}};';
+describe('format content-flow matrix', () => {
+  it('round-trips markdown through DOCX with hybrid equivalence', async () => {
+    const source = ROUNDTRIP_FIXTURES.story;
+    const docx = await markdownDocToDocx(source.doc);
+    const roundTrip = await docxToMarkdownDoc(docx);
+    assertHybridRoundTrip({
+      source: source.doc,
+      roundTrip,
+      keyPhrases: source.keyPhrases,
+      headingTexts: source.headingTexts,
+      requireHeadingOrder: true,
+      requireListSurvival: true,
+      minRetainRatio: 0.65,
+    });
+  });
+  it('round-trips markdown through PPTX with hybrid equivalence', async () => {
+    const source = ROUNDTRIP_FIXTURES.mixed;
+    const pptx = await markdownDocToPptx(source.doc);
+    const roundTrip = await pptxToMarkdownDoc(pptx);
+    assertHybridRoundTrip({
+      source: source.doc,
+      roundTrip,
+      keyPhrases: source.keyPhrases,
+      headingTexts: source.headingTexts,
+      requireHeadingOrder: true,
+      minRetainRatio: 0.5,
+    });
+  });
+  it('round-trips markdown through PDF with hybrid equivalence', async () => {
+    const source = ROUNDTRIP_FIXTURES.mixed;
+    const pdf = await markdownDocToPdf(source.doc, { title: 'Ops Weekly' });
+    const roundTrip = await pdfToMarkdownDoc(pdf, { bodyFontSize: 11 });
+    assertHybridRoundTrip({
+      source: source.doc,
+      roundTrip,
+      keyPhrases: ['ops weekly', 'launch readiness', 'rollback script', 'support tickets declined'],
+      minRetainRatio: 0.4,
+    });
+  });
+  it('round-trips markdown through CSV for table-centric content', async () => {
+    const source = ROUNDTRIP_FIXTURES.table;
+    const csv = markdownDocToCsv(source.doc);
+    const roundTrip = await csvToMarkdownDoc(csv);
+    assertHybridRoundTrip({
+      source: source.doc,
+      roundTrip,
+      keyPhrases: ['throughput', '120 req/s', 'error rate', 'p95'],
+      requireTableSurvival: true,
+      minRetainRatio: 0.7,
+    });
+  });
+  it('exports markdown to HTML as one-way smoke coverage', async () => {
+    const source = ROUNDTRIP_FIXTURES.story;
+    const doc = markdownToDoc(source.doc, { articleId: 'matrix-story' });
+    const html = docToHtml(doc, {
+      playerScript: MOCK_PLAYER_SCRIPT,
+      title: 'Matrix Story',
+    });
+    expect(html).toContain('<!DOCTYPE html>');
+    const normalizedHtml = html.toLowerCase();
+    expect(normalizedHtml).toContain('river journal');
+    expect(normalizedHtml).toContain('north bank');
+    expect(normalizedHtml).toContain('full report');
+  });
+  it('exports markdown to EPUB as one-way smoke coverage', async () => {
+    const source = ROUNDTRIP_FIXTURES.story;
+    const epub = await markdownDocToEpub(source.doc, {
+      title: 'River Journal',
+      author: 'Squisq Test',
+    });
+    const zip = await JSZip.loadAsync(epub);
+    expect(zip.file('OEBPS/content.opf')).toBeTruthy();
+    const chapter = await zip.file('OEBPS/chapters/chapter-001.xhtml')?.async('string');
+    expect(chapter).toBeTruthy();
+    const normalized = (chapter ?? '').toLowerCase();
+    expect(normalized).toContain('river journal');
+    expect(normalized).toContain('north bank');
+  });
+  it('keeps high-value text through all bidirectional formats', async () => {
+    const source = ROUNDTRIP_FIXTURES.story;
+    const docxRoundTrip = await docxToMarkdownDoc(await markdownDocToDocx(source.doc));
+    const pptxRoundTrip = await pptxToMarkdownDoc(await markdownDocToPptx(source.doc));
+    const pdfRoundTrip = await pdfToMarkdownDoc(await markdownDocToPdf(source.doc));
+    const csvRoundTrip = await csvToMarkdownDoc(markdownDocToCsv(ROUNDTRIP_FIXTURES.table.doc));
+    const docxText = extractNormalizedText(docxRoundTrip);
+    const pptxText = extractNormalizedText(pptxRoundTrip);
+    const pdfText = extractNormalizedText(pdfRoundTrip);
+    const csvText = extractNormalizedText(csvRoundTrip);
+    expect(docxText).toContain('river journal');
+    expect(pptxText).toContain('river journal');
+    expect(pdfText).toContain('river journal');
+    expect(csvText).toContain('throughput');
+  });
+  it('asserts current XLSX export stub behavior', async () => {
+    await expect(markdownDocToXlsx(ROUNDTRIP_FIXTURES.table.doc)).rejects.toThrow(
+      'XLSX export is not yet implemented',
+    );
+  });
+});

package/src/__tests__/xlsxImport.test.ts ADDED Viewed

@@ -0,0 +1,80 @@
+/**
+ * Tests for XLSX import: xlsxToMarkdownDoc. Builds a minimal .xlsx fixture
+ * with the shared OOXML writer (dogfooding), then imports it.
+ */
+import { describe, expect, it } from 'vitest';
+import type { MarkdownHeading, MarkdownTable, MarkdownText } from '@bendyline/squisq/markdown';
+import { NS_R, NS_SML, REL_OFFICE_DOCUMENT } from '../ooxml/namespaces';
+import { createPackage } from '../ooxml/writer';
+import { xmlDeclaration } from '../ooxml/xmlUtils';
+import { xlsxToMarkdownDoc } from '../xlsx/import';
+const REL_WORKSHEET =
+  'http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet';
+const REL_SHARED_STRINGS =
+  'http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings';
+async function buildTestXlsx(): Promise<ArrayBuffer> {
+  const pkg = createPackage();
+  pkg.addPart(
+    'xl/workbook.xml',
+    `${xmlDeclaration()}<workbook xmlns="${NS_SML}" xmlns:r="${NS_R}">` +
+      `<sheets><sheet name="Data" sheetId="1" r:id="rId1"/></sheets></workbook>`,
+    'application/xml',
+  );
+  pkg.addPart(
+    'xl/sharedStrings.xml',
+    `${xmlDeclaration()}<sst xmlns="${NS_SML}">` +
+      `<si><t>Name</t></si><si><t>Age</t></si><si><t>Alice</t></si></sst>`,
+    'application/xml',
+  );
+  pkg.addPart(
+    'xl/worksheets/sheet1.xml',
+    `${xmlDeclaration()}<worksheet xmlns="${NS_SML}"><sheetData>` +
+      `<row r="1"><c r="A1" t="s"><v>0</v></c><c r="B1" t="s"><v>1</v></c></row>` +
+      `<row r="2"><c r="A2" t="s"><v>2</v></c><c r="B2"><v>30</v></c></row>` +
+      `</sheetData></worksheet>`,
+    'application/xml',
+  );
+  pkg.addRelationship('', { id: 'rId1', type: REL_OFFICE_DOCUMENT, target: 'xl/workbook.xml' });
+  pkg.addRelationship('xl/workbook.xml', {
+    id: 'rId1',
+    type: REL_WORKSHEET,
+    target: 'worksheets/sheet1.xml',
+  });
+  pkg.addRelationship('xl/workbook.xml', {
+    id: 'rId2',
+    type: REL_SHARED_STRINGS,
+    target: 'sharedStrings.xml',
+  });
+  return pkg.toArrayBuffer();
+}
+describe('xlsxToMarkdownDoc', () => {
+  it('imports a sheet as a heading + table, resolving shared strings', async () => {
+    const doc = await xlsxToMarkdownDoc(await buildTestXlsx());
+    expect(doc.type).toBe('document');
+    const heading = doc.children[0] as MarkdownHeading;
+    expect(heading.type).toBe('heading');
+    expect((heading.children[0] as MarkdownText).value).toBe('Data');
+    const table = doc.children[1] as MarkdownTable;
+    expect(table.type).toBe('table');
+    expect(table.children).toHaveLength(2);
+    const headerCell = table.children[0]!.children[0]!;
+    expect(headerCell.isHeader).toBe(true);
+    expect((headerCell.children[0] as MarkdownText).value).toBe('Name');
+    expect((table.children[1]!.children[0]!.children[0] as MarkdownText).value).toBe('Alice');
+    expect((table.children[1]!.children[1]!.children[0] as MarkdownText).value).toBe('30');
+  });
+  it('selects a single sheet by name without a heading', async () => {
+    const doc = await xlsxToMarkdownDoc(await buildTestXlsx(), { sheet: 'Data' });
+    expect(doc.children[0]!.type).toBe('table');
+  });
+});

package/src/csv/index.ts ADDED Viewed

@@ -0,0 +1,165 @@
+/**
+ * @bendyline/squisq-formats CSV Module
+ *
+ * Bridges CSV ↔ the squisq markdown table model. CSV isn't OOXML, so this
+ * module is self-contained (no jszip / DOMParser): a small RFC-4180 parser on
+ * the import side and a serializer on the export side. The first row is treated
+ * as the table header by default.
+ *
+ * @example
+ * ```ts
+ * import { csvToMarkdownDoc, markdownDocToCsv } from '@bendyline/squisq-formats/csv';
+ * ```
+ */
+import { markdownToDoc } from '@bendyline/squisq/doc';
+import type {
+  MarkdownDocument,
+  MarkdownTable,
+  MarkdownTableCell,
+  MarkdownTableRow,
+} from '@bendyline/squisq/markdown';
+import type { Doc } from '@bendyline/squisq/schemas';
+export interface CsvImportOptions {
+  /** Field delimiter. Default `,`. */
+  delimiter?: string;
+  /** Treat the first row as a header row. Default true. */
+  hasHeader?: boolean;
+}
+export interface CsvExportOptions {
+  /** Field delimiter. Default `,`. */
+  delimiter?: string;
+}
+async function toText(data: ArrayBuffer | Blob | string): Promise<string> {
+  if (typeof data === 'string') return data;
+  if (typeof Blob !== 'undefined' && data instanceof Blob) return data.text();
+  return new TextDecoder().decode(new Uint8Array(data as ArrayBuffer));
+}
+/** Parse CSV text into a grid of string cells (RFC 4180: quotes, escaped quotes). */
+export function parseCsv(text: string, delimiter = ','): string[][] {
+  const rows: string[][] = [];
+  let row: string[] = [];
+  let field = '';
+  let inQuotes = false;
+  let sawAny = false;
+  const pushField = () => {
+    row.push(field);
+    field = '';
+  };
+  const pushRow = () => {
+    pushField();
+    rows.push(row);
+    row = [];
+  };
+  for (let i = 0; i < text.length; i++) {
+    const ch = text[i]!;
+    if (inQuotes) {
+      if (ch === '"') {
+        if (text[i + 1] === '"') {
+          field += '"';
+          i++;
+        } else {
+          inQuotes = false;
+        }
+      } else {
+        field += ch;
+      }
+      continue;
+    }
+    if (ch === '"') {
+      inQuotes = true;
+      sawAny = true;
+      continue;
+    }
+    if (ch === delimiter) {
+      sawAny = true;
+      pushField();
+      continue;
+    }
+    if (ch === '\n' || ch === '\r') {
+      if (ch === '\r' && text[i + 1] === '\n') i++;
+      pushRow();
+      sawAny = false;
+      continue;
+    }
+    sawAny = true;
+    field += ch;
+  }
+  // Flush a trailing field/row only if the last line wasn't terminated.
+  if (field !== '' || row.length > 0 || sawAny) pushRow();
+  return rows;
+}
+function rowsToTable(rows: string[][], hasHeader: boolean): MarkdownTable {
+  const maxCols = rows.reduce((m, r) => Math.max(m, r.length), 1);
+  const mdRows: MarkdownTableRow[] = rows.map((cells, rowIdx) => {
+    const children: MarkdownTableCell[] = [];
+    for (let c = 0; c < maxCols; c++) {
+      const value = cells[c] ?? '';
+      children.push({
+        type: 'tableCell',
+        ...(hasHeader && rowIdx === 0 ? { isHeader: true } : {}),
+        children: value ? [{ type: 'text', value }] : [],
+      });
+    }
+    return { type: 'tableRow', children };
+  });
+  return { type: 'table', children: mdRows };
+}
+/** Convert CSV to a MarkdownDocument containing a single table. */
+export async function csvToMarkdownDoc(
+  data: ArrayBuffer | Blob | string,
+  options: CsvImportOptions = {},
+): Promise<MarkdownDocument> {
+  const text = await toText(data);
+  const rows = parseCsv(text, options.delimiter ?? ',');
+  const hasHeader = options.hasHeader ?? true;
+  const children = rows.length > 0 ? [rowsToTable(rows, hasHeader)] : [];
+  return { type: 'document', children };
+}
+/** Convert CSV to a squisq Doc. */
+export async function csvToDoc(
+  data: ArrayBuffer | Blob | string,
+  options: CsvImportOptions = {},
+): Promise<Doc> {
+  return markdownToDoc(await csvToMarkdownDoc(data, options));
+}
+function escapeCsvField(value: string, delimiter: string): string {
+  if (value.includes('"') || value.includes(delimiter) || /[\r\n]/.test(value)) {
+    return `"${value.replace(/"/g, '""')}"`;
+  }
+  return value;
+}
+function cellText(cell: MarkdownTableCell): string {
+  // Flatten inline children to plain text (CSV has no formatting).
+  const walk = (nodes: unknown[]): string =>
+    nodes
+      .map((n) => {
+        const node = n as { type?: string; value?: string; children?: unknown[] };
+        if (node.value !== undefined) return node.value;
+        if (Array.isArray(node.children)) return walk(node.children);
+        return '';
+      })
+      .join('');
+  return walk(cell.children);
+}
+/** Serialize the first table in a MarkdownDocument to CSV text. */
+export function markdownDocToCsv(doc: MarkdownDocument, options: CsvExportOptions = {}): string {
+  const delimiter = options.delimiter ?? ',';
+  const table = doc.children.find((n) => n.type === 'table') as MarkdownTable | undefined;
+  if (!table) return '';
+  return table.children
+    .map((row) =>
+      row.children.map((cell) => escapeCsvField(cellText(cell), delimiter)).join(delimiter),
+    )
+    .join('\r\n');
+}

package/src/docx/export.ts CHANGED Viewed

@@ -18,8 +18,8 @@
  */
 import type { Doc, Theme } from '@bendyline/squisq/schemas';
-import { resolveTheme, resolveFontFamily } from '@bendyline/squisq/schemas';
-import { docToMarkdown } from '@bendyline/squisq/doc';
+import { resolveFontFamily } from '@bendyline/squisq/schemas';
+import { docToMarkdown, resolveThemeForDoc } from '@bendyline/squisq/doc';
 import type {
   MarkdownDocument,
   MarkdownBlockNode,
@@ -44,6 +44,12 @@ import { readFrontmatterThemeId } from '@bendyline/squisq/markdown';
 import { createPackage } from '../ooxml/writer.js';
 import { xmlDeclaration, escapeXml } from '../ooxml/xmlUtils.js';
+import { stripHtmlTags } from '../shared/text.js';
+import {
+  inlineNodesToRuns,
+  inlineNodeToRuns,
+  type InlineRunHandlers,
+} from '../shared/inlineRuns.js';
 import {
   NS_WML,
   NS_R,
@@ -126,7 +132,7 @@ export async function markdownDocToDocx(
     options.themeId !== undefined
       ? options
       : { ...options, themeId: readFrontmatterThemeId(doc.frontmatter) };
-  const ctx = new ExportContext(resolvedOptions);
+  const ctx = new ExportContext(resolvedOptions, doc);
   const bodyXml = convertBlocks(doc.children, ctx);
   return buildDocxPackage(bodyXml, ctx, resolvedOptions);
 }
@@ -206,7 +212,7 @@ class ExportContext {
   private nextDocPrId = 1;
-  constructor(options: DocxExportOptions) {
+  constructor(options: DocxExportOptions, doc?: MarkdownDocument) {
     let themeFont: string | undefined;
     let themeTitleFont: string | undefined;
     let themeHeadingColor: string | undefined;
@@ -215,7 +221,7 @@ class ExportContext {
     let themeBackgroundColor: string | undefined;
     if (options.themeId) {
-      const theme: Theme = resolveTheme(options.themeId);
+      const theme: Theme = resolveThemeForDoc(doc, options.themeId);
       // Theme fonts arrive as CSS stacks (e.g. `"Oswald", Impact,
       // "Arial Black", sans-serif`). Word's `w:ascii` attribute is a
       // single font name — passing the whole stack is treated as a
@@ -631,46 +637,30 @@ interface InlineFormat {
   color?: string;
 }
+/**
+ * DOCX leaf handlers for the shared run-based inline walker. The traversal
+ * (format threading) lives in `shared/inlineRuns.ts`; these emit WordprocessingML.
+ */
+function docxRunHandlers(ctx: ExportContext): InlineRunHandlers {
+  return {
+    run: (text, format) => makeRun(text, format),
+    link: (node, format) => convertLink(node, ctx, format),
+    image: (node) => convertImage(node, ctx),
+    lineBreak: () => `<w:r><w:br/></w:r>`,
+    footnoteRef: (node) => convertFootnoteRef(node, ctx),
+  };
+}
 function convertInlines(
   nodes: MarkdownInlineNode[],
   ctx: ExportContext,
   format: InlineFormat = {},
 ): string {
-  const parts: string[] = [];
-  for (const node of nodes) {
-    parts.push(convertInline(node, ctx, format));
-  }
-  return parts.join('');
+  return inlineNodesToRuns(nodes, docxRunHandlers(ctx), format);
 }
 function convertInline(node: MarkdownInlineNode, ctx: ExportContext, format: InlineFormat): string {
-  switch (node.type) {
-    case 'text':
-      return makeRun(node.value, format);
-    case 'strong':
-      return convertInlines(node.children, ctx, { ...format, bold: true });
-    case 'emphasis':
-      return convertInlines(node.children, ctx, { ...format, italic: true });
-    case 'delete':
-      return convertInlines(node.children, ctx, { ...format, strike: true });
-    case 'inlineCode':
-      return makeRun(node.value, { ...format, code: true });
-    case 'link':
-      return convertLink(node, ctx, format);
-    case 'image':
-      return convertImage(node, ctx);
-    case 'break':
-      return `<w:r><w:br/></w:r>`;
-    case 'htmlInline':
-      return makeRun(stripHtmlTags(node.rawHtml), format);
-    case 'inlineMath':
-      return makeRun(node.value, { ...format, code: true });
-    case 'footnoteReference':
-      return convertFootnoteRef(node, ctx);
-    default:
-      // linkReference, imageReference, textDirective — skip or emit plain
-      return '';
-  }
+  return inlineNodeToRuns(node, docxRunHandlers(ctx), format);
 }
 function makeRun(text: string, format: InlineFormat): string {
@@ -1273,10 +1263,3 @@ function buildFootnotesXml(ctx: ExportContext): string {
 // ============================================
 // Helpers
 // ============================================
-/**
- * Strip HTML tags from a string, keeping only text content.
- */
-function stripHtmlTags(html: string): string {
-  return html.replace(/<[^>]*>/g, '');
-}

package/src/docx/import.ts CHANGED Viewed

@@ -21,6 +21,7 @@
 import type { Doc } from '@bendyline/squisq/schemas';
 import { markdownToDoc } from '@bendyline/squisq/doc';
+import { stringifyMarkdown } from '@bendyline/squisq/markdown';
 import type {
   MarkdownDocument,
   MarkdownBlockNode,
@@ -156,8 +157,6 @@ export async function docxToContainer(
   const blocks = await convertBody(body, ctx);
   const markdownDoc: MarkdownDocument = { type: 'document', children: blocks };
-  // Serialize to markdown
-  const { stringifyMarkdown } = await import('@bendyline/squisq/markdown');
   const markdown = stringifyMarkdown(markdownDoc);
   // Build container with markdown + images

package/src/epub/export.ts CHANGED Viewed

@@ -23,7 +23,8 @@
 import JSZip from 'jszip';
 import type { Doc, AudioSegment } from '@bendyline/squisq/schemas';
-import { resolveTheme, resolveFontFamily } from '@bendyline/squisq/schemas';
+import { resolveFontFamily } from '@bendyline/squisq/schemas';
+import { resolveThemeForDoc } from '@bendyline/squisq/doc';
 import type {
   MarkdownDocument,
   MarkdownBlockNode,
@@ -35,8 +36,10 @@ import type {
   MarkdownTableRow,
   MarkdownTableCell,
 } from '@bendyline/squisq/markdown';
+import { readFrontmatterThemeId } from '@bendyline/squisq/markdown';
 import { escapeXml } from '../ooxml/xmlUtils.js';
 import { inferMimeType, extractFilename } from '../html/imageUtils.js';
+import { extractPlainText } from '../shared/text.js';
 // ── Public API ────────────────────────────────────────────────────
@@ -119,8 +122,9 @@ export async function markdownDocToEpub(
     }
   }
-  // Generate theme CSS
-  const css = generateStylesheet(options.themeId);
+  // Generate theme CSS — honor an explicit themeId, else the doc's frontmatter
+  // theme (`squisq-theme` / legacy), mirroring the other export formats.
+  const css = generateStylesheet(options.themeId ?? readFrontmatterThemeId(doc.frontmatter), doc);
   // Build the ZIP
   const zip = new JSZip();
@@ -360,28 +364,7 @@ function splitIntoChapters(nodes: MarkdownBlockNode[]): Chapter[] {
 }
 function extractHeadingText(heading: MarkdownHeading): string {
-  return heading.children.map(inlineToText).join('');
-}
-function inlineToText(node: MarkdownInlineNode): string {
-  switch (node.type) {
-    case 'text':
-      return node.value;
-    case 'emphasis':
-    case 'strong':
-    case 'delete':
-      return node.children.map(inlineToText).join('');
-    case 'inlineCode':
-      return node.value;
-    case 'link':
-      return node.children.map(inlineToText).join('');
-    case 'image':
-      return node.alt ?? '';
-    case 'break':
-      return ' ';
-    default:
-      return '';
-  }
+  return extractPlainText(heading.children);
 }
 // ── Image Collection ──────────────────────────────────────────────
@@ -795,10 +778,10 @@ ${navItems}
 // ── Stylesheet ────────────────────────────────────────────────────
-function generateStylesheet(themeId?: string): string {
+function generateStylesheet(themeId: string | undefined, doc?: MarkdownDocument): string {
   let themeVars = '';
   if (themeId) {
-    const theme = resolveTheme(themeId);
+    const theme = resolveThemeForDoc(doc, themeId);
     themeVars = `
   --epub-bg: ${theme.colors.background};
   --epub-text: ${theme.colors.text};