docx-kit 0.1.0 → 0.3.0

package/README.md

@@ -1,26 +1,24 @@
 # docx-kit
 
-[![CI](https://github.com/ntnyq/docx-kit/workflows/CI/badge.svg)](https://github.com/ntnyq/docx-kit/actions)
-[![NPM VERSION](https://img.shields.io/npm/v/docx-kit.svg)](https://www.npmjs.com/package/docx-kit)
-[![NPM DOWNLOADS](https://img.shields.io/npm/dy/docx-kit.svg)](https://www.npmjs.com/package/docx-kit)
-[![LICENSE](https://img.shields.io/github/license/ntnyq/docx-kit.svg)](https://github.com/ntnyq/docx-kit/blob/main/LICENSE)
+CSS-like DOCX API Kit — a type-safe, plugin-extensible DOCX generation library built on [dolanmiu/docx](https://github.com/dolanmiu/docx).
 
-TypeScript library for generating Word (.docx) documents easily with rich content, styles, and intuitive, customizable API.
+This is the umbrella package that re-exports all core APIs, built-in plugins, presets, and themes.
 
-## Install
+## Installation
 
-```shell
+```bash
 npm install docx-kit
 ```
 
-```shell
-yarn add docx-kit
-```
+## Usage
 
-```shell
-pnpm add docx-kit
-```
+```ts
+import { createDocx } from 'docx-kit'
 
-## License
+const docx = createDocx()
+  .paragraph('Hello, world!')
+  .build()
 
-[MIT](./LICENSE) License © 2025-PRESENT [ntnyq](https://github.com/ntnyq)
+// Use built-in plugins
+import { calloutPlugin, codeBlockPlugin } from 'docx-kit'
+```

package/dist/browser.d.ts

@@ -1,27 +1,56 @@
+import { academicPreset } from "@docxkit/preset-academic";
+import { classicPreset } from "@docxkit/preset-classic";
+import { modernPreset } from "@docxkit/preset-modern";
+import { minimalTheme } from "@docxkit/theme-minimal";
+import { oceanTheme } from "@docxkit/theme-ocean";
+import { warmTheme } from "@docxkit/theme-warm";
+import { DocxPreset, DocxTheme } from "@docxkit/core";
+import { TocOptions, TocOptions as TocOptions$1, tocPlugin } from "@docxkit/plugin-toc";
+import { BadgeOptions, BadgeOptions as BadgeOptions$1, badgePlugin } from "@docxkit/plugin-badge";
+import { QRCodePluginOptions, QRCodePluginOptions as QRCodePluginOptions$1, qrcodePlugin } from "@docxkit/plugin-qrcode";
+import { CalloutOptions, CalloutOptions as CalloutOptions$1, calloutPlugin } from "@docxkit/plugin-callout";
+import { DividerOptions, DividerOptions as DividerOptions$1, dividerPlugin } from "@docxkit/plugin-divider";
+import { EChartsPluginOptions, EChartsPluginOptions as EChartsPluginOptions$1, echartsPlugin } from "@docxkit/plugin-echarts";
+import { InvoiceLineItem, InvoiceOptions, InvoiceOptions as InvoiceOptions$1, InvoiceParty, invoicePlugin } from "@docxkit/plugin-invoice";
+import { TimelineEvent, TimelineOptions, TimelineOptions as TimelineOptions$1, timelinePlugin } from "@docxkit/plugin-timeline";
+import { ChangelogEntry, ChangelogOptions, ChangelogOptions as ChangelogOptions$1, changelogPlugin } from "@docxkit/plugin-changelog";
+import { WatermarkOptions, WatermarkOptions as WatermarkOptions$1, watermarkPlugin } from "@docxkit/plugin-watermark";
+import { CodeBlockOptions, CodeBlockOptions as CodeBlockOptions$1, codeBlockPlugin } from "@docxkit/plugin-code-block";
+import { CoverPageOptions, CoverPageOptions as CoverPageOptions$1, coverPagePlugin } from "@docxkit/plugin-cover-page";
+import { ColAlign, ColFormat, DataTableOptions, DataTableOptions as DataTableOptions$1, dataTablePlugin } from "@docxkit/plugin-data-table";
+import { LetterheadOptions, LetterheadOptions as LetterheadOptions$1, letterheadPlugin } from "@docxkit/plugin-letterhead";
+import { PageNumberOptions, PageNumberOptions as PageNumberOptions$1, pageNumberPlugin } from "@docxkit/plugin-page-number";
+import { PropertyItem, PropertyTableOptions, PropertyTableOptions as PropertyTableOptions$1, propertyTablePlugin } from "@docxkit/plugin-property-table";
+import { AgendaItem, MeetingMinutesOptions, MeetingMinutesOptions as MeetingMinutesOptions$1, meetingMinutesPlugin } from "@docxkit/plugin-meeting-minutes";
+import { SignatureBlockOptions, SignatureBlockOptions as SignatureBlockOptions$1, SignatureParty, signatureBlockPlugin } from "@docxkit/plugin-signature-block";
+import { DocxInput, DocxPreview, DocxPreviewOptions, PREVIEW_ERROR_CODES, PreviewErrorCode, RendererKind, createDocxPreview } from "@docxkit/renderer";
+export * from "@docxkit/core";
+
+//#region src/types/plugin-map.d.ts
+declare module '@docxkit/core' {
+  interface BuiltinPluginMap {
+    badge: BadgeOptions$1;
+    callout: CalloutOptions$1;
+    changelog: ChangelogOptions$1;
+    codeBlock: CodeBlockOptions$1;
+    coverPage: CoverPageOptions$1;
+    dataTable: DataTableOptions$1;
+    divider: DividerOptions$1;
+    echarts: EChartsPluginOptions$1;
+    invoice: InvoiceOptions$1;
+    letterhead: LetterheadOptions$1;
+    meetingMinutes: MeetingMinutesOptions$1;
+    pageNumber: PageNumberOptions$1;
+    propertyTable: PropertyTableOptions$1;
+    qrcode: QRCodePluginOptions$1;
+    signatureBlock: SignatureBlockOptions$1;
+    timeline: TimelineOptions$1;
+    toc: TocOptions$1;
+    watermark: WatermarkOptions$1;
+  }
+}
+//#endregion
 //#region src/browser/dom.d.ts
-/**
- * Browser DOM utilities — base64 decoding and Blob/image handling.
- *
- * @module browser/dom
- */
-/**
- * Decode a base64 data-URL to raw bytes using the browser `atob` API.
- *
- * Strips the `"data:*;base64,"` prefix, decodes the base64 string
- * via `atob()`, and populates a `Uint8Array` from each character's
- * code point.
- *
- * @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/browser'
- *
- * const bytes = await dataUrlToUint8Array('data:image/png;base64,iVBORw...')
- * ```
- */
-declare function dataUrlToUint8Array(dataUrl: string): Promise<Uint8Array>;
 /**
  * Normalize image data for `ImageRun` — converts `Blob` to `Uint8Array`.
  *
@@ -43,25 +72,17 @@ declare function dataUrlToUint8Array(dataUrl: string): Promise<Uint8Array>;
 declare function normalizeImageData(data: unknown): Promise<string | ArrayBuffer | Uint8Array>;
 //#endregion
 //#region src/browser.d.ts
-/**
- * ### ❌ `saveDocument()` — Not available in browsers
- *
- * Browsers do not provide direct filesystem access for security reasons.
- * To trigger a file download in the browser, use `doc.toBlob()` with
- * `URL.createObjectURL()` and a temporary `<a>` element:
- *
- * ```ts
- * const blob = await doc.toBlob()
- * const url = URL.createObjectURL(blob)
- * const a = document.createElement('a')
- * a.href = url
- * a.download = 'output.docx'
- * a.click()
- * URL.revokeObjectURL(url)
- * ```
- *
- * @deprecated This API is not available in browsers. Use `doc.toBlob()` instead.
- */
-declare const saveDocument: never;
+/** All built-in presets, keyed by ID. */
+declare const BUILTIN_PRESETS: ReadonlyMap<string, DocxPreset>;
+/** Ordered list of built-in presets (for UI selectors). */
+declare const PRESET_LIST: readonly DocxPreset[];
+/** Look up a built-in preset by ID. */
+declare function usePreset(id: string): DocxPreset | undefined;
+/** All built-in themes, keyed by ID. */
+declare const BUILTIN_THEMES: ReadonlyMap<string, DocxTheme>;
+/** Ordered list of built-in themes (for UI selectors). */
+declare const THEME_LIST: readonly DocxTheme[];
+/** Look up a built-in theme by ID. */
+declare function useTheme(id: string): DocxTheme | undefined;
 //#endregion
-export { dataUrlToUint8Array, normalizeImageData, saveDocument };
+export { type AgendaItem, BUILTIN_PRESETS, BUILTIN_THEMES, type BadgeOptions, type CalloutOptions, type ChangelogEntry, type ChangelogOptions, type CodeBlockOptions, type ColAlign, type ColFormat, type CoverPageOptions, type DataTableOptions, type DividerOptions, type DocxInput, type DocxPreview, type DocxPreviewOptions, type EChartsPluginOptions, type InvoiceLineItem, type InvoiceOptions, type InvoiceParty, type LetterheadOptions, type MeetingMinutesOptions, PRESET_LIST, PREVIEW_ERROR_CODES, type PageNumberOptions, type PreviewErrorCode, type PropertyItem, type PropertyTableOptions, type QRCodePluginOptions, type RendererKind, type SignatureBlockOptions, type SignatureParty, THEME_LIST, type TimelineEvent, type TimelineOptions, type TocOptions, type WatermarkOptions, academicPreset, badgePlugin, calloutPlugin, changelogPlugin, classicPreset, codeBlockPlugin, coverPagePlugin, createDocxPreview, dataTablePlugin, dividerPlugin, echartsPlugin, invoicePlugin, letterheadPlugin, meetingMinutesPlugin, minimalTheme, modernPreset, normalizeImageData, oceanTheme, pageNumberPlugin, propertyTablePlugin, qrcodePlugin, signatureBlockPlugin, timelinePlugin, tocPlugin, usePreset, useTheme, warmTheme, watermarkPlugin };

package/dist/browser.js

@@ -1,34 +1,32 @@
+import { academicPreset } from "@docxkit/preset-academic";
+import { classicPreset } from "@docxkit/preset-classic";
+import { modernPreset } from "@docxkit/preset-modern";
+import { minimalTheme } from "@docxkit/theme-minimal";
+import { oceanTheme } from "@docxkit/theme-ocean";
+import { warmTheme } from "@docxkit/theme-warm";
+import "@docxkit/core";
+import { tocPlugin } from "@docxkit/plugin-toc";
+import { badgePlugin } from "@docxkit/plugin-badge";
+import { qrcodePlugin } from "@docxkit/plugin-qrcode";
+import { calloutPlugin } from "@docxkit/plugin-callout";
+import { dividerPlugin } from "@docxkit/plugin-divider";
+import { echartsPlugin } from "@docxkit/plugin-echarts";
+import { invoicePlugin } from "@docxkit/plugin-invoice";
+import { timelinePlugin } from "@docxkit/plugin-timeline";
+import { changelogPlugin } from "@docxkit/plugin-changelog";
+import { watermarkPlugin } from "@docxkit/plugin-watermark";
+import { codeBlockPlugin } from "@docxkit/plugin-code-block";
+import { coverPagePlugin } from "@docxkit/plugin-cover-page";
+import { dataTablePlugin } from "@docxkit/plugin-data-table";
+import { letterheadPlugin } from "@docxkit/plugin-letterhead";
+import { pageNumberPlugin } from "@docxkit/plugin-page-number";
+import { propertyTablePlugin } from "@docxkit/plugin-property-table";
+import { meetingMinutesPlugin } from "@docxkit/plugin-meeting-minutes";
+import { signatureBlockPlugin } from "@docxkit/plugin-signature-block";
+import { PREVIEW_ERROR_CODES, createDocxPreview } from "@docxkit/renderer";
+export * from "@docxkit/core";
 //#region src/browser/dom.ts
 /**
-* Browser DOM utilities — base64 decoding and Blob/image handling.
-*
-* @module browser/dom
-*/
-/**
-* Decode a base64 data-URL to raw bytes using the browser `atob` API.
-*
-* Strips the `"data:*;base64,"` prefix, decodes the base64 string
-* via `atob()`, and populates a `Uint8Array` from each character's
-* code point.
-*
-* @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/browser'
-*
-* const bytes = await dataUrlToUint8Array('data:image/png;base64,iVBORw...')
-* ```
-*/
-async function dataUrlToUint8Array(dataUrl) {
-	const base64 = dataUrl.split(",")[1];
-	const binary = atob(base64);
-	const bytes = new Uint8Array(binary.length);
-	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
-	return bytes;
-}
-/**
 * Normalize image data for `ImageRun` — converts `Blob` to `Uint8Array`.
 *
 * In the browser, image data often arrives as a `Blob` (e.g. from
@@ -51,4 +49,49 @@ async function normalizeImageData(data) {
 	return data;
 }
 //#endregion
-export { dataUrlToUint8Array, normalizeImageData };
+//#region src/browser.ts
+/**
+* docx-kit — Browser platform entry (default).
+*
+* Re-exports all APIs from @docxkit/core plus built-in plugins,
+* presets, and themes. This is the default import target.
+*
+* For Node.js–only APIs (filesystem save), import from 'docx-kit/node'.
+*
+* @module docx-kit
+* @packageDocumentation
+*/
+/** All built-in presets, keyed by ID. */
+const BUILTIN_PRESETS = new Map([
+	[academicPreset.id, academicPreset],
+	[classicPreset.id, classicPreset],
+	[modernPreset.id, modernPreset]
+]);
+/** Ordered list of built-in presets (for UI selectors). */
+const PRESET_LIST = [
+	classicPreset,
+	modernPreset,
+	academicPreset
+];
+/** Look up a built-in preset by ID. */
+function usePreset(id) {
+	return BUILTIN_PRESETS.get(id);
+}
+/** All built-in themes, keyed by ID. */
+const BUILTIN_THEMES = new Map([
+	[minimalTheme.id, minimalTheme],
+	[oceanTheme.id, oceanTheme],
+	[warmTheme.id, warmTheme]
+]);
+/** Ordered list of built-in themes (for UI selectors). */
+const THEME_LIST = [
+	minimalTheme,
+	oceanTheme,
+	warmTheme
+];
+/** Look up a built-in theme by ID. */
+function useTheme(id) {
+	return BUILTIN_THEMES.get(id);
+}
+//#endregion
+export { BUILTIN_PRESETS, BUILTIN_THEMES, PRESET_LIST, PREVIEW_ERROR_CODES, THEME_LIST, academicPreset, badgePlugin, calloutPlugin, changelogPlugin, classicPreset, codeBlockPlugin, coverPagePlugin, createDocxPreview, dataTablePlugin, dividerPlugin, echartsPlugin, invoicePlugin, letterheadPlugin, meetingMinutesPlugin, minimalTheme, modernPreset, normalizeImageData, oceanTheme, pageNumberPlugin, propertyTablePlugin, qrcodePlugin, signatureBlockPlugin, timelinePlugin, tocPlugin, usePreset, useTheme, warmTheme, watermarkPlugin };

package/dist/node.d.ts

@@ -1,5 +1,55 @@
+import { academicPreset } from "@docxkit/preset-academic";
+import { classicPreset } from "@docxkit/preset-classic";
+import { modernPreset } from "@docxkit/preset-modern";
+import { minimalTheme } from "@docxkit/theme-minimal";
+import { oceanTheme } from "@docxkit/theme-ocean";
+import { warmTheme } from "@docxkit/theme-warm";
+import { DocxPreset, DocxTheme, dataUrlToUint8Array } from "@docxkit/core";
+import { TocOptions, TocOptions as TocOptions$1, tocPlugin } from "@docxkit/plugin-toc";
+import { BadgeOptions, BadgeOptions as BadgeOptions$1, badgePlugin } from "@docxkit/plugin-badge";
+import { QRCodePluginOptions, QRCodePluginOptions as QRCodePluginOptions$1, qrcodePlugin } from "@docxkit/plugin-qrcode";
+import { CalloutOptions, CalloutOptions as CalloutOptions$1, calloutPlugin } from "@docxkit/plugin-callout";
+import { DividerOptions, DividerOptions as DividerOptions$1, dividerPlugin } from "@docxkit/plugin-divider";
+import { InvoiceLineItem, InvoiceOptions, InvoiceOptions as InvoiceOptions$1, InvoiceParty, invoicePlugin } from "@docxkit/plugin-invoice";
+import { TimelineEvent, TimelineOptions, TimelineOptions as TimelineOptions$1, timelinePlugin } from "@docxkit/plugin-timeline";
+import { ChangelogEntry, ChangelogOptions, ChangelogOptions as ChangelogOptions$1, changelogPlugin } from "@docxkit/plugin-changelog";
+import { WatermarkOptions, WatermarkOptions as WatermarkOptions$1, watermarkPlugin } from "@docxkit/plugin-watermark";
+import { CodeBlockOptions, CodeBlockOptions as CodeBlockOptions$1, codeBlockPlugin } from "@docxkit/plugin-code-block";
+import { CoverPageOptions, CoverPageOptions as CoverPageOptions$1, coverPagePlugin } from "@docxkit/plugin-cover-page";
+import { ColAlign, ColFormat, DataTableOptions, DataTableOptions as DataTableOptions$1, dataTablePlugin } from "@docxkit/plugin-data-table";
+import { LetterheadOptions, LetterheadOptions as LetterheadOptions$1, letterheadPlugin } from "@docxkit/plugin-letterhead";
+import { PageNumberOptions, PageNumberOptions as PageNumberOptions$1, pageNumberPlugin } from "@docxkit/plugin-page-number";
 import { Document } from "docx";
+import { PropertyItem, PropertyTableOptions, PropertyTableOptions as PropertyTableOptions$1, propertyTablePlugin } from "@docxkit/plugin-property-table";
+import { AgendaItem, MeetingMinutesOptions, MeetingMinutesOptions as MeetingMinutesOptions$1, meetingMinutesPlugin } from "@docxkit/plugin-meeting-minutes";
+import { SignatureBlockOptions, SignatureBlockOptions as SignatureBlockOptions$1, SignatureParty, signatureBlockPlugin } from "@docxkit/plugin-signature-block";
+import { EChartsPluginOptions } from "@docxkit/plugin-echarts";
+export * from "@docxkit/core";
 
+//#region src/types/plugin-map.d.ts
+declare module '@docxkit/core' {
+  interface BuiltinPluginMap {
+    badge: BadgeOptions$1;
+    callout: CalloutOptions$1;
+    changelog: ChangelogOptions$1;
+    codeBlock: CodeBlockOptions$1;
+    coverPage: CoverPageOptions$1;
+    dataTable: DataTableOptions$1;
+    divider: DividerOptions$1;
+    echarts: EChartsPluginOptions;
+    invoice: InvoiceOptions$1;
+    letterhead: LetterheadOptions$1;
+    meetingMinutes: MeetingMinutesOptions$1;
+    pageNumber: PageNumberOptions$1;
+    propertyTable: PropertyTableOptions$1;
+    qrcode: QRCodePluginOptions$1;
+    signatureBlock: SignatureBlockOptions$1;
+    timeline: TimelineOptions$1;
+    toc: TocOptions$1;
+    watermark: WatermarkOptions$1;
+  }
+}
+//#endregion
 //#region src/node/fs.d.ts
 /**
  * Save a compiled document to a file on disk.
@@ -9,6 +59,7 @@ import { Document } from "docx";
  *
  * @param doc - — A compiled `docx` `Document` instance
  * @param filename - — Output file path (e.g. `"report.docx"`)
+ * @returns A promise that resolves when the file has been written
  *
  * @example
  * ```ts
@@ -20,58 +71,12 @@ import { Document } from "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;
+declare const BUILTIN_PRESETS: ReadonlyMap<string, DocxPreset>;
+declare const PRESET_LIST: readonly DocxPreset[];
+declare function usePreset(id: string): DocxPreset | undefined;
+declare const BUILTIN_THEMES: ReadonlyMap<string, DocxTheme>;
+declare const THEME_LIST: readonly DocxTheme[];
+declare function useTheme(id: string): DocxTheme | undefined;
 //#endregion
-export { dataUrlToUint8Array, echartsPlugin, normalizeImageData, saveDocument };
+export { type AgendaItem, BUILTIN_PRESETS, BUILTIN_THEMES, type BadgeOptions, type CalloutOptions, type ChangelogEntry, type ChangelogOptions, type CodeBlockOptions, type ColAlign, type ColFormat, type CoverPageOptions, type DataTableOptions, type DividerOptions, type InvoiceLineItem, type InvoiceOptions, type InvoiceParty, type LetterheadOptions, type MeetingMinutesOptions, PRESET_LIST, type PageNumberOptions, type PropertyItem, type PropertyTableOptions, type QRCodePluginOptions, type SignatureBlockOptions, type SignatureParty, THEME_LIST, type TimelineEvent, type TimelineOptions, type TocOptions, type WatermarkOptions, academicPreset, badgePlugin, calloutPlugin, changelogPlugin, classicPreset, codeBlockPlugin, coverPagePlugin, dataTablePlugin, dataUrlToUint8Array, dividerPlugin, invoicePlugin, letterheadPlugin, meetingMinutesPlugin, minimalTheme, modernPreset, oceanTheme, pageNumberPlugin, propertyTablePlugin, qrcodePlugin, saveDocument, signatureBlockPlugin, timelinePlugin, tocPlugin, usePreset, useTheme, warmTheme, watermarkPlugin };

package/dist/node.js

@@ -1,30 +1,92 @@
-import { n as saveDocument } from "./fs-DF8ug9Wi.js";
-//#region src/node/dataUrl.ts
+import { academicPreset } from "@docxkit/preset-academic";
+import { classicPreset } from "@docxkit/preset-classic";
+import { modernPreset } from "@docxkit/preset-modern";
+import { minimalTheme } from "@docxkit/theme-minimal";
+import { oceanTheme } from "@docxkit/theme-ocean";
+import { warmTheme } from "@docxkit/theme-warm";
+import { dataUrlToUint8Array } from "@docxkit/core";
+import { tocPlugin } from "@docxkit/plugin-toc";
+import { badgePlugin } from "@docxkit/plugin-badge";
+import { qrcodePlugin } from "@docxkit/plugin-qrcode";
+import { calloutPlugin } from "@docxkit/plugin-callout";
+import { dividerPlugin } from "@docxkit/plugin-divider";
+import { invoicePlugin } from "@docxkit/plugin-invoice";
+import { timelinePlugin } from "@docxkit/plugin-timeline";
+import { changelogPlugin } from "@docxkit/plugin-changelog";
+import { watermarkPlugin } from "@docxkit/plugin-watermark";
+import { codeBlockPlugin } from "@docxkit/plugin-code-block";
+import { coverPagePlugin } from "@docxkit/plugin-cover-page";
+import { dataTablePlugin } from "@docxkit/plugin-data-table";
+import { letterheadPlugin } from "@docxkit/plugin-letterhead";
+import { pageNumberPlugin } from "@docxkit/plugin-page-number";
+import { Packer } from "docx";
+import { propertyTablePlugin } from "@docxkit/plugin-property-table";
+import { meetingMinutesPlugin } from "@docxkit/plugin-meeting-minutes";
+import { signatureBlockPlugin } from "@docxkit/plugin-signature-block";
+export * from "@docxkit/core";
+//#region src/node/fs.ts
 /**
-* Node.js base64 data-URL decoder (uses `Buffer` from `node:buffer`).
+* Node.js filesystem utilities for saving documents to disk.
 *
-* @module node/dataUrl
+* @module node/fs
 */
 /**
-* Decode a base64 data-URL to raw bytes using Node.js `Buffer`.
+* Save a compiled document to a file on disk.
 *
-* Strips the `"data:*;base64,"` prefix and decodes via
-* `Buffer.from(base64, 'base64')`.
+* Uses `Packer.toBuffer()` to produce the .docx binary, then
+* writes via `node:fs/promises`. This function is **Node.js only**.
 *
-* @param dataUrl - — A base64 data-URI string (e.g. `"data:image/png;base64,iVBO..."`)
-* @returns Raw bytes as `Uint8Array`
+* @param doc - — A compiled `docx` `Document` instance
+* @param filename - — Output file path (e.g. `"report.docx"`)
+* @returns A promise that resolves when the file has been written
 *
 * @example
 * ```ts
-* import { dataUrlToUint8Array } from 'docx-kit/node'
+* import { saveDocument } from 'docx-kit/node'
 *
-* const bytes = await dataUrlToUint8Array('data:image/png;base64,iVBORw...')
+* const doc = await compileDocument({ ... })
+* await saveDocument(doc, 'report.docx')
 * ```
 */
-async function dataUrlToUint8Array(dataUrl) {
-	const { Buffer } = await import("node:buffer");
-	const base64 = dataUrl.split(",")[1];
-	return new Uint8Array(Buffer.from(base64, "base64"));
+async function saveDocument(doc, filename) {
+	const { writeFile } = await import("node:fs/promises");
+	await writeFile(filename, await Packer.toBuffer(doc));
 }
 //#endregion
-export { dataUrlToUint8Array, saveDocument };
+//#region src/node.ts
+/**
+* docx-kit — Node.js platform entry.
+*
+* Import from 'docx-kit/node'.
+*
+* @module docx-kit/node
+* @packageDocumentation
+*/
+const BUILTIN_PRESETS = new Map([
+	[academicPreset.id, academicPreset],
+	[classicPreset.id, classicPreset],
+	[modernPreset.id, modernPreset]
+]);
+const PRESET_LIST = [
+	classicPreset,
+	modernPreset,
+	academicPreset
+];
+function usePreset(id) {
+	return BUILTIN_PRESETS.get(id);
+}
+const BUILTIN_THEMES = new Map([
+	[minimalTheme.id, minimalTheme],
+	[oceanTheme.id, oceanTheme],
+	[warmTheme.id, warmTheme]
+]);
+const THEME_LIST = [
+	minimalTheme,
+	oceanTheme,
+	warmTheme
+];
+function useTheme(id) {
+	return BUILTIN_THEMES.get(id);
+}
+//#endregion
+export { BUILTIN_PRESETS, BUILTIN_THEMES, PRESET_LIST, THEME_LIST, academicPreset, badgePlugin, calloutPlugin, changelogPlugin, classicPreset, codeBlockPlugin, coverPagePlugin, dataTablePlugin, dataUrlToUint8Array, dividerPlugin, invoicePlugin, letterheadPlugin, meetingMinutesPlugin, minimalTheme, modernPreset, oceanTheme, pageNumberPlugin, propertyTablePlugin, qrcodePlugin, saveDocument, signatureBlockPlugin, timelinePlugin, tocPlugin, usePreset, useTheme, warmTheme, watermarkPlugin };