@docen/docx 0.3.0 → 0.3.1

package/README.md

@@ -6,6 +6,8 @@
 
 > DOCX editor and converter powered by @office-open/docx with Tiptap editing layer, supporting bidirectional conversion between DOCX, HTML, and Markdown.
 
+> Need a ready-made visual editor? [`@docen/editor`](../editor/README.md) wraps this engine in a Fluent UI shell with the turnkey `<docen-document>` super-component.
+
 ## Features
 
 - 📝 **Tiptap Editor** — Full-featured WYSIWYG editor with DOCX-aware extensions
@@ -142,9 +144,6 @@ Standalone Functions (core)
         ↕ used by
 Tiptap Extension Commands (thin wrappers)
   editor.commands.importDocx() / exportDocx()
-        ↕ used by
-@docen/ui (Fluent UI Web Components)
-  <docx-editor> toolbar / ribbon / menus
 ```
 
 - **Runtime model**: Tiptap JSON with DOCX-rich attributes via custom extensions

package/dist/blockquote-Ky9xD_Q-.mjs

@@ -0,0 +1,31 @@
+import "./tiptap-D7pl4I5U.mjs";
+//#region src/extensions/blockquote.ts
+/**
+* Blockquote extension — owns the DOCX expression of a blockquote.
+*
+* DOCX has no blockquote element; the convention is a left indent plus a left
+* border on each contained paragraph. This module owns that signature; the
+* DocxManager walks the blockquote's child paragraphs and applies it to each.
+*/
+/** Left indent (twips, ~0.5 inch) marking a blockquote. */
+const BLOCKQUOTE_INDENT_LEFT = 720;
+/** Left border marking a blockquote. */
+const BLOCKQUOTE_BORDER = {
+	style: "single",
+	size: 18,
+	space: 12,
+	color: "CCCCCC"
+};
+/** Apply the blockquote signature (left indent + left border) to paragraph opts. */
+function applyBlockquoteStyle(paraObj) {
+	paraObj.indent = {
+		...paraObj.indent ?? {},
+		left: 720
+	};
+	paraObj.border = {
+		...paraObj.border ?? {},
+		left: BLOCKQUOTE_BORDER
+	};
+}
+//#endregion
+export { BLOCKQUOTE_INDENT_LEFT as n, applyBlockquoteStyle as r, BLOCKQUOTE_BORDER as t };

package/dist/code-block-BgNjhADy.mjs

@@ -0,0 +1,23 @@
+import { a as CodeBlockLowlight } from "./tiptap-D7pl4I5U.mjs";
+//#region src/extensions/code-block.ts
+/**
+* CodeBlock extension — CodeBlockLowlight with a DOCX renderDocx.
+*
+* DOCX has no dedicated code-block element. A code block maps to a single
+* paragraph styled "Code" with a monospace run font. Inline marks (syntax-
+* highlight tokens) and line breaks (`\n` → `<w:br/>`) are handled by
+* DocxManager's shared inline-content compilation; resolveCodeBlock reassembles
+* the text. This module owns only the paragraph-level style.
+*
+* `language` has no OOXML carrier and is intentionally dropped (known lossy).
+*/
+/** codeBlock node → paragraph properties (style "Code" + monospace font). */
+function renderDocx(_node) {
+	return {
+		style: "Code",
+		run: { font: "Consolas" }
+	};
+}
+const CodeBlock = CodeBlockLowlight.extend({ renderDocx });
+//#endregion
+export { renderDocx as n, CodeBlock as t };

package/dist/converters/docx.d.mts

@@ -1,110 +1,2 @@
-import { a as JSONContent } from "../core-omBKMRtl.mjs";
-import { PrepareStep } from "./prepare.mjs";
-import { DocumentOptions, OutputByType, OutputType, PackerOptions, parseDocument } from "@office-open/docx";
-
-//#region src/converters/docx.d.ts
-/**
- * Manages DOCX serialization (Tiptap JSON ↔ DocumentOptions).
- *
- * Each extension provides renderDocx/parseDocx for its own attrs mapping.
- * DocxManager handles tree walking, child assembly, and dispatching.
- */
-declare class DocxManager {
-  compile(json: JSONContent): DocumentOptions;
-  resolve(docOpts: DocumentOptions): JSONContent;
-  private compileSectionChild;
-  private compileParagraphNode;
-  private compileHeadingNode;
-  private compileCodeBlock;
-  /** Simple text optimization: merge plain runs into text field */
-  private simplifyParagraph;
-  private compileTableNode;
-  /** Count grid columns from the first table row (summing colspan). */
-  private getTableColumnCount;
-  /**
-   * Compute tblGrid column widths (twips) from first-row cell colwidth attrs.
-   * Returns columnWidths array and the appropriate tableWidth.
-   */
-  private computeColumnWidths;
-  private compileTableCellNode;
-  private compileListFromNode;
-  private compileInlineContent;
-  private compileTextNode;
-  private resolveSectionChild;
-  private resolveParagraph;
-  private resolveListItem;
-  private resolveTable;
-  /**
-   * Resolve a paragraph's inline content. @office-open collapses a plain-text
-   * paragraph (a single run with no properties) to a bare string or a `{ text }`
-   * object with no `children` — recover that text here so it round-trips back to
-   * a text node instead of being dropped.
-   */
-  private resolveInlineContent;
-  private resolveParagraphChildren;
-  private resolveParagraphChild;
-  private resolveRun;
-  private resolveMarks;
-  private resolveImage;
-  private resolveHyperlink;
-}
-/**
- * Parse a DOCX file into Tiptap JSON (runtime model).
- *
- * Combines @office-open/docx's `parseDocument` (DOCX binary → DocumentOptions)
- * with `DocxManager.resolve` (DocumentOptions → Tiptap JSON).
- */
-declare function parseDOCX(data: Parameters<typeof parseDocument>[0]): JSONContent;
-/**
- * Options for {@link generateDOCX} / {@link generateDOCXStream}.
- */
-interface DocxGenerateOptions<T extends OutputType = "nodebuffer"> {
-  /**
-   * Pre-compilation steps run on the JSON in place (default: `prepareImages()`).
-   * - `true` / `undefined`: default image pre-fetch (http(s) → embedded data URL)
-   * - `false`: skip preparation
-   * - `PrepareStep[]`: custom steps
-   *
-   * Required for http image URLs — image `renderDocx` drops images without
-   * embedded data (see extensions/image.ts). Mutates the JSON, like `prepareDocument`.
-   */
-  prepare?: boolean | PrepareStep[];
-  /** Packer options; `type` controls the output format (default `"nodebuffer"` → Buffer). */
-  packer?: PackerOptions<T>;
-}
-/**
- * Generate a DOCX file from Tiptap JSON (runtime model), asynchronously.
- *
- * Pipeline: `prepareDocument` (default: fetch http images, in place) →
- * `DocxManager.compile` → @office-open/docx's `generateDocument`. `packer.type`
- * controls the output format (default: `"nodebuffer"` → Buffer). Non-blocking
- * (fflate Web Workers). With the default `prepare`, the input `json` is mutated
- * in place (http image URLs become embedded data URLs).
- */
-declare function generateDOCX<T extends OutputType = "nodebuffer">(json: JSONContent, options?: DocxGenerateOptions<T>): Promise<OutputByType[T]>;
-/**
- * Generate a DOCX file synchronously — fastest throughput, blocks the event loop.
- *
- * Pipeline: `DocxManager.compile` → `generateDocumentSync`. Does **not** run
- * `prepareDocument` (it is async); call `await prepareDocument(json)` first
- * when http images need embedding.
- */
-declare function generateDOCXSync<T extends OutputType = "nodebuffer">(json: JSONContent, packerOptions?: PackerOptions<T>): OutputByType[T];
-/**
- * Generate a DOCX file as a `ReadableStream<Uint8Array>` — for large documents
- * or streaming HTTP responses.
- *
- * Pipeline: `prepareDocument` (default: fetch http images, in place) →
- * `DocxManager.compile` → `generateDocumentStream`. Async due to preparation.
- */
-declare function generateDOCXStream(json: JSONContent, options?: DocxGenerateOptions): Promise<ReadableStream<Uint8Array>>;
-/**
- * Convert DocumentOptions (persistence model) to Tiptap JSON (runtime model).
- */
-declare function resolveDocument(docOpts: DocumentOptions): JSONContent;
-/**
- * Convert Tiptap JSON (runtime model) to DocumentOptions (persistence model).
- */
-declare function compileDocument(json: JSONContent): DocumentOptions;
-//#endregion
+import { a as generateDOCX, c as parseDOCX, i as compileDocument, l as resolveDocument, n as DocxGenerateOptions, o as generateDOCXStream, r as DocxManager, s as generateDOCXSync, t as DocumentOptions } from "../docx-C5wyjI-0.mjs";
 export { type DocumentOptions, DocxGenerateOptions, DocxManager, compileDocument, generateDOCX, generateDOCXStream, generateDOCXSync, parseDOCX, resolveDocument };