@docen/docx 0.3.0 → 0.3.1

package/dist/core-fBMCCj4D.d.mts

@@ -0,0 +1,97 @@
+import { AnyExtension, Editor, Extension, Extensions, JSONContent as JSONContent$1, Mark, Node } from "@tiptap/core";
+import { TextAlign } from "@tiptap/extension-text-align";
+
+//#region src/extensions/image.d.ts
+type CropRect = {
+  left?: number;
+  top?: number;
+  right?: number;
+  bottom?: number;
+};
+/**
+ * Tiptap JSON image node → CoreImageOptions-shaped object.
+ *
+ * Returns `{ image: ImageOptions }` (structural wrapper) or null when no
+ * embedded image data is available (external URLs need pre-fetching).
+ * rotation is carried via transformation.rotation (not dropped).
+ */
+declare function renderDocx(node: JSONContent$1): Record<string, unknown> | null;
+/**
+ * ImageOptions-shaped object → Tiptap attrs.
+ *
+ * Near-identity unpack: transformation → width/height/rotation, altText → alt/title,
+ * floating/srcRect(→crop)/outline passed through verbatim. src is reconstructed by
+ * DocxManager from the image data bytes (kept out of parseDocx).
+ */
+declare function parseDocx(imageOpts: Record<string, unknown>): Record<string, unknown>;
+/** Dimensions + source needed to size the background image to the extent box. */
+interface CropRenderContext {
+  width?: number;
+  height?: number;
+  src?: string;
+}
+/**
+ * Render crop as background-image styles for byte-accurate four-sided srcRect.
+ *
+ * object-fit:cover scales uniformly, so it only matches single-axis crops; for
+ * two-sided crops it shrinks the whole image and shows too much. background-size
+ * scales each axis independently (W/visibleW × H/visibleH), so the visible
+ * srcRect region always maps exactly onto the extent box. background-position
+ * then shifts the original so the cropped-left/top region falls outside the box.
+ *
+ * Requires a div[role=img] host (see Image.renderHTML) — an <img> cannot
+ * background-crop itself, since its src is always painted in the foreground.
+ */
+declare function renderCropAttrs(crop: Record<string, unknown> | CropRect, ctx?: CropRenderContext): {
+  style: string;
+};
+declare const Image: import("@tiptap/core").Node<import("@tiptap/extension-image").ImageOptions, any>;
+//#endregion
+//#region src/extensions/passthrough.d.ts
+/**
+ * Passthrough — block atom carrying an opaque {@link SectionChild} that has
+ * no native Tiptap representation (rawXml, bookmarkStart/End, toc, textbox,
+ * altChunk, subDoc, customXml).
+ *
+ * The full SectionChild is stored as JSON in `attrs.data` so the DOCX→JSON→DOCX
+ * round-trip stays byte-faithful: office-open's stringify handles the inner
+ * structure verbatim (including a textbox's nested children, which remain as
+ * structured ParagraphOptions inside the blob rather than editable Tiptap
+ * nodes). The node is not editable — it renders a read-only placeholder in HTML.
+ *
+ * DOCX serialization is inlined in DocxManager (compile/resolve read/write
+ * `attrs.data` directly), so no renderDocx/parseDocx is needed here.
+ */
+declare const Passthrough: Node<any, any>;
+//#endregion
+//#region src/extensions/extensions.d.ts
+declare const tiptapNodeExtensions: AnyExtension[];
+declare const tiptapMarkExtensions: AnyExtension[];
+declare const docxExtensions: AnyExtension[];
+interface DocxKitOptions {
+  bold?: Record<string, any> | false;
+  blockquote?: Record<string, any> | false;
+  bulletList?: Record<string, any> | false;
+  code?: Record<string, any> | false;
+  codeBlock?: Record<string, any> | false;
+  document?: false;
+  dropcursor?: Record<string, any> | false;
+  gapcursor?: false;
+  hardBreak?: Record<string, any> | false;
+  heading?: Record<string, any> | false;
+  undoRedo?: Record<string, any> | false;
+  horizontalRule?: Record<string, any> | false;
+  italic?: Record<string, any> | false;
+  listItem?: Record<string, any> | false;
+  listKeymap?: Record<string, any> | false;
+  link?: Record<string, any> | false;
+  orderedList?: Record<string, any> | false;
+  paragraph?: Record<string, any> | false;
+  strike?: Record<string, any> | false;
+  text?: false;
+  underline?: Record<string, any> | false;
+  trailingNode?: Record<string, any> | false;
+}
+declare const DocxKit: Extension<DocxKitOptions, any>;
+//#endregion
+export { parseDocx as _, JSONContent$1 as a, DocxKit as c, docxExtensions as d, tiptapMarkExtensions as f, Image as g, CropRenderContext as h, Extensions as i, DocxKitOptions as l, Passthrough as m, Editor as n, Mark as o, tiptapNodeExtensions as p, Extension as r, Node as s, AnyExtension as t, TextAlign as u, renderCropAttrs as v, renderDocx as y };

package/dist/core.d.mts

@@ -1,2 +1,2 @@
-import { a as JSONContent, d as docxExtensions, i as Extensions, n as Editor, o as Mark, r as Extension, s as Node, t as AnyExtension } from "./core-omBKMRtl.mjs";
+import { a as JSONContent, d as docxExtensions, i as Extensions, n as Editor, o as Mark, r as Extension, s as Node, t as AnyExtension } from "./core-fBMCCj4D.mjs";
 export { type AnyExtension, Editor, Extension, type Extensions, type JSONContent, Mark, Node, docxExtensions };

package/dist/core.mjs

@@ -1,2 +1,2 @@
-import { i as Node, n as Extension, r as Mark, s as docxExtensions, t as Editor } from "./core-CFIQVRfx.mjs";
+import { i as Node, n as Extension, r as Mark, s as docxExtensions, t as Editor } from "./core-DEqBHRzE.mjs";
 export { Editor, Extension, Mark, Node, docxExtensions };

package/dist/details-Dh8luWb2.mjs

@@ -0,0 +1,18 @@
+import "./tiptap-D7pl4I5U.mjs";
+//#region src/extensions/details.ts
+/**
+* Details extension — owns the DOCX expression of a collapsible details block.
+*
+* DOCX has no native collapsible region, but a block-level group-SDT is a
+* reversible container. The details maps to one group-SDT tagged "docen-
+* details"; the summary paragraph is marked with a fixed style so resolve can
+* split it back out from the content paragraphs. Structure round-trips fully
+* (summary + content); Word shows it expanded (no collapse) — an inherent
+* DOCX limitation, not data loss.
+*/
+/** SDT tag marking a details group content control. */
+const DETAILS_TAG = "docen-details";
+/** Paragraph style marking the summary line within a details group-SDT. */
+const DETAILS_SUMMARY_STYLE = "DocenDetailsSummary";
+//#endregion
+export { DETAILS_TAG as n, DETAILS_SUMMARY_STYLE as t };