docx-kit 0.1.0 → 0.2.0

package/dist/node.d.ts

@@ -1,77 +0,0 @@
-import { Document } from "docx";
-
-//#region src/node/fs.d.ts
-/**
- * Save a compiled document to a file on disk.
- *
- * Uses `Packer.toBuffer()` to produce the .docx binary, then
- * writes via `node:fs/promises`. This function is **Node.js only**.
- *
- * @param doc - — A compiled `docx` `Document` instance
- * @param filename - — Output file path (e.g. `"report.docx"`)
- *
- * @example
- * ```ts
- * import { saveDocument } from 'docx-kit/node'
- *
- * const doc = await compileDocument({ ... })
- * await saveDocument(doc, 'report.docx')
- * ```
- */
-declare function saveDocument(doc: Document, filename: string): Promise<void>;
-//#endregion
-//#region src/node/dataUrl.d.ts
-/**
- * Node.js base64 data-URL decoder (uses `Buffer` from `node:buffer`).
- *
- * @module node/dataUrl
- */
-/**
- * Decode a base64 data-URL to raw bytes using Node.js `Buffer`.
- *
- * Strips the `"data:*;base64,"` prefix and decodes via
- * `Buffer.from(base64, 'base64')`.
- *
- * @param dataUrl - — A base64 data-URI string (e.g. `"data:image/png;base64,iVBO..."`)
- * @returns Raw bytes as `Uint8Array`
- *
- * @example
- * ```ts
- * import { dataUrlToUint8Array } from 'docx-kit/node'
- *
- * const bytes = await dataUrlToUint8Array('data:image/png;base64,iVBORw...')
- * ```
- */
-declare function dataUrlToUint8Array(dataUrl: string): Promise<Uint8Array>;
-//#endregion
-//#region src/node.d.ts
-/**
- * ### ❌ `echartsPlugin()` — Not available in Node.js
- *
- * The ECharts plugin requires a browser `window` and `document` to
- * render charts into a DOM container. Node.js has no native DOM.
- *
- * **Workarounds:**
- * - Use a server-side canvas library (e.g. `node-canvas` + `echarts`)
- * - Pre-render charts on the client and pass the image data to docx-kit
- *
- * @deprecated This API is not available in Node.js. See workarounds above.
- */
-declare const echartsPlugin: never;
-/**
- * ### ❌ `normalizeImageData()` — Not built-in for Node.js
- *
- * This utility converts `Blob` instances to `Uint8Array`. While `Blob`
- * is available in Node.js ≥ 18, it is rarely the carrier for image data
- * in Node workflows (most users work with `Buffer` or file paths directly).
- *
- * If you need Blob→Uint8Array in Node.js, use:
- * ```ts
- * const bytes = new Uint8Array(await blob.arrayBuffer())
- * ```
- *
- * @deprecated Use inline `new Uint8Array(await blob.arrayBuffer())` instead.
- */
-declare const normalizeImageData: never;
-//#endregion
-export { dataUrlToUint8Array, echartsPlugin, normalizeImageData, saveDocument };

package/dist/node.js

@@ -1,30 +0,0 @@
-import { n as saveDocument } from "./fs-DF8ug9Wi.js";
-//#region src/node/dataUrl.ts
-/**
-* Node.js base64 data-URL decoder (uses `Buffer` from `node:buffer`).
-*
-* @module node/dataUrl
-*/
-/**
-* Decode a base64 data-URL to raw bytes using Node.js `Buffer`.
-*
-* Strips the `"data:*;base64,"` prefix and decodes via
-* `Buffer.from(base64, 'base64')`.
-*
-* @param dataUrl - — A base64 data-URI string (e.g. `"data:image/png;base64,iVBO..."`)
-* @returns Raw bytes as `Uint8Array`
-*
-* @example
-* ```ts
-* import { dataUrlToUint8Array } from 'docx-kit/node'
-*
-* const bytes = await dataUrlToUint8Array('data:image/png;base64,iVBORw...')
-* ```
-*/
-async function dataUrlToUint8Array(dataUrl) {
-	const { Buffer } = await import("node:buffer");
-	const base64 = dataUrl.split(",")[1];
-	return new Uint8Array(Buffer.from(base64, "base64"));
-}
-//#endregion
-export { dataUrlToUint8Array, saveDocument };