docx-kit 0.1.0 → 0.2.0

package/dist/node.mjs

@@ -0,0 +1,2362 @@
+import { n as saveDocument } from "./fs-DF8ug9Wi.mjs";
+import { n as dataUrlToUint8Array$1, t as createImageRun } from "./image-CdfLh9GO.mjs";
+import { n as ERROR_CODES, t as DocxKitError } from "./errors-c9CC63Ti.mjs";
+import { AlignmentType, BorderStyle, HeadingLevel, PageNumber, Paragraph, ShadingType, Table, TableCell, TableRow, TextRun, WidthType } from "docx";
+//#region src/types/style.ts
+/**
+* Define a type-safe stylesheet.
+*
+* `fontSize` defaults to pt when passed as a bare number.
+*
+* @param styles - — The stylesheet object
+* @returns The same stylesheet with `const` type inference
+*
+* @example
+* ```ts
+* const styles = defineStyles({
+*   title: { fontSize: 28, fontWeight: 'bold' },
+*   body:  { fontSize: 12, lineHeight: 1.5 },
+* })
+* ```
+*/
+function defineStyles(styles) {
+	return styles;
+}
+//#endregion
+//#region src/types/plugin.ts
+/**
+* Define a type-safe plugin with full inference.
+*
+* @param plugin - — The plugin definition object
+* @returns The same plugin with `const` type inference
+*
+* @example
+* ```ts
+* const myPlugin = definePlugin<'badge', { text: string }>({
+*   name: 'badge',
+*   render: async (opts, ctx) => {
+*     // ... render logic
+*     return new Paragraph({ text: opts.text })
+*   },
+* })
+* ```
+*/
+function definePlugin(plugin) {
+	return plugin;
+}
+//#endregion
+//#region src/plugins/qrcode/index.ts
+/**
+* QR Code plugin — embeds a QR code image in the document.
+*
+* Uses the `qrcode` package (peer dependency) to generate
+* a QR code PNG and renders it as an inline `ImageRun`.
+*
+* @module plugins/qrcode
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(qrcodePlugin())
+*   .h1('Scan Me')
+*   .plugin('qrcode', { text: 'https://example.com', caption: 'Visit us' })
+*   .save('qrcode.docx')
+* ```
+*/
+/**
+* Create a QRCode plugin instance.
+*
+* The plugin dynamically imports the `qrcode` package at render time,
+* keeping it an optional peer dependency of docx-kit core.
+*
+* @returns A configured DocxPlugin for `'qrcode'`
+*
+* @example
+* ```ts
+* import { createDocx, qrcodePlugin } from 'docx-kit'
+*
+* const doc = createDocx()
+*   .use(qrcodePlugin())
+*   .plugin('qrcode', {
+*     text: 'https://example.com',
+*     size: 256,
+*     errorCorrectionLevel: 'H',
+*     caption: 'Scan to visit',
+*   })
+* ```
+*/
+function qrcodePlugin() {
+	return definePlugin({
+		name: "qrcode",
+		async render(options) {
+			const QRCode = (await import("qrcode")).default ?? await import("qrcode");
+			const size = options.size ?? 128;
+			const paragraphs = [new Paragraph({ children: [createImageRun({
+				data: await dataUrlToUint8Array$1(await QRCode.toDataURL(options.text, {
+					errorCorrectionLevel: options.errorCorrectionLevel ?? "M",
+					margin: options.margin ?? 1,
+					width: size
+				})),
+				height: size,
+				type: "png",
+				width: size
+			})] })];
+			if (options.caption) paragraphs.push(new Paragraph({ text: options.caption }));
+			return paragraphs;
+		}
+	});
+}
+//#endregion
+//#region src/plugins/callout/index.ts
+/**
+* Callout plugin — colored info / warning / success / danger boxes.
+*
+* Renders a single `Paragraph` with a prominent left border, a tinted
+* background, an emoji icon, an optional bold title, and body text.
+*
+* @module plugins/callout
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(calloutPlugin())
+*   .plugin('callout', {
+*     type: 'warning',
+*     title: '注意',
+*     content: '此操作不可撤销，请确认后再提交。',
+*   })
+*   .save('callout.docx')
+* ```
+*/
+const CALLOUT_PRESETS = {
+	danger: {
+		bg: "FCE4D6",
+		border: "FF0000",
+		icon: "⚠️"
+	},
+	info: {
+		bg: "D6E4F0",
+		border: "4472C4",
+		icon: "ℹ️"
+	},
+	success: {
+		bg: "E2F0D9",
+		border: "70AD47",
+		icon: "✅"
+	},
+	warning: {
+		bg: "FFF2CC",
+		border: "FFC000",
+		icon: "⚠️"
+	}
+};
+/**
+* Create a Callout plugin instance.
+*
+* @returns A configured DocxPlugin for `'callout'`
+*
+* @example
+* ```ts
+* import { createDocx, calloutPlugin } from 'docx-kit'
+*
+* const doc = createDocx()
+*   .use(calloutPlugin())
+*   .plugin('callout', { type: 'info', content: '系统将在今晚 22:00 升级。' })
+* ```
+*/
+function calloutPlugin() {
+	return definePlugin({
+		name: "callout",
+		render(options) {
+			const preset = CALLOUT_PRESETS[options.type];
+			const runs = [new TextRun({ text: `${preset.icon}  ` })];
+			if (options.title) runs.push(new TextRun({
+				bold: true,
+				text: `${options.title}\n`
+			}));
+			runs.push(new TextRun({ text: options.content }));
+			return new Paragraph({
+				children: runs,
+				spacing: {
+					after: 120,
+					before: 120
+				},
+				border: { left: {
+					color: preset.border,
+					size: 12,
+					space: 8,
+					style: BorderStyle.SINGLE
+				} },
+				shading: {
+					fill: preset.bg,
+					type: ShadingType.CLEAR
+				}
+			});
+		}
+	});
+}
+//#endregion
+//#region src/plugins/echarts/index.ts
+/**
+* ECharts plugin — embeds interactive ECharts charts as static images.
+*
+* Renders charts in the browser via the DOM. For Node.js rendering,
+* a custom canvas/SVG implementation is needed (not built-in).
+*
+* @module plugins/echarts
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(echartsPlugin())
+*   .h1('Sales Chart')
+*   .plugin('echarts', {
+*     option: {
+*       title: { text: 'Monthly Sales' },
+*       xAxis: { data: ['Jan', 'Feb', 'Mar'] },
+*       yAxis: {},
+*       series: [{ type: 'bar', data: [120, 200, 150] }],
+*     },
+*     width: 640,
+*     height: 360,
+*     caption: 'Figure 1: Monthly sales data',
+*   })
+*   .save('chart.docx')
+* ```
+*/
+/**
+* Create an ECharts plugin instance.
+*
+* The plugin renders charts using the browser DOM. In Node.js
+* environments, it throws an error prompting the user to provide
+* a server-side canvas implementation.
+*
+* @returns A configured DocxPlugin for `'echarts'`
+*
+* @example
+* ```ts
+* import { createDocx, echartsPlugin } from 'docx-kit'
+*
+* const doc = createDocx()
+*   .use(echartsPlugin())
+*   .plugin('echarts', {
+*     option: {
+*       title: { text: 'Revenue' },
+*       xAxis: { type: 'category', data: ['Q1', 'Q2', 'Q3', 'Q4'] },
+*       yAxis: { type: 'value' },
+*       series: [{ data: [820, 932, 901, 1347], type: 'line' }],
+*     },
+*     caption: 'Quarterly revenue trend',
+*   })
+* ```
+*/
+function echartsPlugin() {
+	return definePlugin({
+		name: "echarts",
+		async render(options) {
+			const width = options.width ?? 640;
+			const height = options.height ?? 360;
+			const imageType = options.imageType ?? "png";
+			const renderer = options.renderer ?? "canvas";
+			const image = await renderEChartsToImage(options.option, {
+				height,
+				imageType,
+				renderer,
+				width
+			});
+			const paragraphs = [new Paragraph({ children: [createImageRun({
+				data: image.data,
+				height,
+				type: image.type,
+				width
+			})] })];
+			if (options.caption) paragraphs.push(new Paragraph({ text: options.caption }));
+			return paragraphs;
+		}
+	});
+}
+/**
+* Render an ECharts option to an image.
+*
+* Automatically selects browser or Node.js rendering based on
+* whether the `window` global is available.
+*
+* @param option - — Full ECharts option object
+* @param config - — Render dimensions and format
+* @returns Rendered image data and type
+*/
+async function renderEChartsToImage(option, config) {
+	if (typeof window !== "undefined") return renderInBrowser(option, config);
+	return renderInNode(option, config);
+}
+/**
+* Browser-side ECharts rendering.
+*
+* Creates a hidden DOM container, renders the chart, and extracts
+* the image as a base64 data-URL.
+*/
+async function renderInBrowser(option, config) {
+	const echarts = await import("echarts");
+	const container = document.createElement("div");
+	container.style.cssText = `width:${config.width}px;height:${config.height}px;position:fixed;left:-99999px;`;
+	document.body.append(container);
+	const chart = echarts.init(container, void 0, {
+		height: config.height,
+		renderer: config.renderer,
+		width: config.width
+	});
+	chart.setOption(option);
+	const dataUrl = chart.getDataURL({
+		backgroundColor: "#ffffff",
+		pixelRatio: 2,
+		type: config.imageType === "svg" ? "svg" : "png"
+	});
+	chart.dispose();
+	container.remove();
+	return {
+		data: await dataUrlToUint8Array$1(dataUrl),
+		type: config.imageType
+	};
+}
+/**
+* Node.js-side ECharts rendering (not built-in).
+*
+* Requires a server-side canvas or SVG DOM implementation
+* (e.g. `node-canvas` + `echarts`). Throws an error prompting
+* the user to provide a custom render function when used
+* outside the browser.
+*/
+async function renderInNode(_option, _config) {
+	throw new DocxKitError(ERROR_CODES.PLUGIN_RENDER_FAILED, "ECharts Node renderer is not built-in. Use a server-side canvas implementation (e.g. node-canvas + echarts) and provide a custom render function. See https://github.com/ntnyq/docx-kit for alternatives.");
+}
+//#endregion
+//#region src/builder/DocxBuilder.ts
+/**
+* Fluent document builder.
+*
+* Use `createDocx()` to instantiate, then chain `.h1()`, `.p()`, `.table()`,
+* etc. to build content. Call `.save()`, `.toBlob()`, `.toBuffer()`, or
+* `.toBase64()` to export the document.
+*
+* @template TStyles — Inferred stylesheet type from `config.styles`
+* @template TPlugins — Accumulated plugin registry (built via `.use()`)
+*/
+var DocxBuilder = class {
+	config;
+	nodes = [];
+	pendingSetups = [];
+	pluginMap = /* @__PURE__ */ new Map();
+	constructor(config = {}) {
+		this.config = config;
+	}
+	/**
+	* Add a raw DSL node to the document.
+	*
+	* @param node - — Any block-level node
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* doc.add({ type: 'heading', level: 2, text: 'Section' })
+	* doc.add({ type: 'pageBreak' })
+	* ```
+	*/
+	add(node) {
+		this.nodes.push(node);
+		return this;
+	}
+	/**
+	* Add a bullet (unordered) list.
+	*
+	* @param items - — List items (strings or structured items)
+	* @param options - — Optional bullet character, className, style, level
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* doc.bulletList(['Item 1', 'Item 2', 'Item 3'])
+	* doc.bulletList([
+	*   'Simple item',
+	*   { text: 'Rich item', className: 'highlight' },
+	* ], { bullet: '\u25CB' })
+	* ```
+	*/
+	bulletList(items, options = {}) {
+		return this.add({
+			items,
+			type: "bulletList",
+			...options
+		});
+	}
+	/**
+	* Add a level-1 heading.
+	*
+	* @param text - — Heading text
+	* @param options - — Optional style overrides (className, id, style)
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* doc.h1('Introduction', { className: 'title' })
+	* ```
+	*/
+	h1(text, options = {}) {
+		return this.add({
+			level: 1,
+			text,
+			type: "heading",
+			...options
+		});
+	}
+	/**
+	* Add a level-2 heading.
+	*
+	* @param text - — Heading text
+	* @param options - — Optional style overrides
+	* @returns The builder (for chaining)
+	*/
+	h2(text, options = {}) {
+		return this.add({
+			level: 2,
+			text,
+			type: "heading",
+			...options
+		});
+	}
+	/**
+	* Add a level-3 heading.
+	*
+	* @param text - — Heading text
+	* @param options - — Optional style overrides
+	* @returns The builder (for chaining)
+	*/
+	h3(text, options = {}) {
+		return this.add({
+			level: 3,
+			text,
+			type: "heading",
+			...options
+		});
+	}
+	/**
+	* Add a level-4 heading.
+	*
+	* @param text - — Heading text
+	* @param options - — Optional style overrides
+	* @returns The builder (for chaining)
+	*/
+	h4(text, options = {}) {
+		return this.add({
+			level: 4,
+			text,
+			type: "heading",
+			...options
+		});
+	}
+	/**
+	* Add a level-5 heading.
+	*
+	* @param text - — Heading text
+	* @param options - — Optional style overrides
+	* @returns The builder (for chaining)
+	*/
+	h5(text, options = {}) {
+		return this.add({
+			level: 5,
+			text,
+			type: "heading",
+			...options
+		});
+	}
+	/**
+	* Add a level-6 heading.
+	*
+	* @param text - — Heading text
+	* @param options - — Optional style overrides
+	* @returns The builder (for chaining)
+	*/
+	h6(text, options = {}) {
+		return this.add({
+			level: 6,
+			text,
+			type: "heading",
+			...options
+		});
+	}
+	/**
+	* Add a hyperlink.
+	*
+	* @param url - — Target URL
+	* @param text - — Display text
+	* @param options - — Optional style overrides
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* doc.hyperlink('https://example.com', 'Click here')
+	* ```
+	*/
+	hyperlink(url, text, options = {}) {
+		return this.add({
+			children: [text],
+			type: "hyperlink",
+			url,
+			...options
+		});
+	}
+	/**
+	* Add an image node.
+	*
+	* @param options - — Image node options (data, width, height, etc.)
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* doc.image({ data: imageBytes, width: 400, height: 300 })
+	* ```
+	*/
+	image(options) {
+		return this.add({
+			type: "image",
+			...options
+		});
+	}
+	/**
+	* Add a numbered (ordered) list.
+	*
+	* @param items - — List items
+	* @param options - — Optional numbering format, start, className, style, level
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* doc.numberedList(['First', 'Second', 'Third'])
+	* doc.numberedList(
+	*   [{ text: 'Intro' }, { text: 'Body' }],
+	*   { numberingFormat: 'upperRoman', start: 1 },
+	* )
+	* ```
+	*/
+	numberedList(items, options = {}) {
+		return this.add({
+			items,
+			type: "numberedList",
+			...options
+		});
+	}
+	/**
+	* Add a paragraph.
+	*
+	* @param text - — Paragraph text content
+	* @param options - — Optional style overrides (className, id, style)
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* doc.p('Hello world', { className: 'body', style: { textAlign: 'center' } })
+	* ```
+	*/
+	p(text, options = {}) {
+		return this.add({
+			text,
+			type: "paragraph",
+			...options
+		});
+	}
+	/**
+	* Add a forced page break.
+	*
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* doc.h1('Chapter 1').pageBreak().h1('Chapter 2')
+	* ```
+	*/
+	pageBreak() {
+		return this.add({ type: "pageBreak" });
+	}
+	/**
+	* Invoke a registered plugin.
+	*
+	* @param name - — Plugin name (must match a previously registered plugin)
+	* @param options - — Plugin-specific options
+	* @param style - — Optional inline style for the plugin's container
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* doc.use(qrcodePlugin()).plugin('qrcode', { text: 'https://example.com' })
+	* ```
+	*/
+	plugin(name, options, style) {
+		return this.add({
+			name,
+			options,
+			style,
+			type: "plugin"
+		});
+	}
+	/**
+	* Save the document to a file (Node.js only).
+	*
+	* **⚠️ Not available in browser environments.**
+	* Use {@link toBlob} and trigger a download instead.
+	*
+	* @param filename - — Output file path (e.g. `"report.docx"`)
+	*
+	* @example
+	* ```ts
+	* await doc.save('output.docx')
+	* ```
+	*/
+	async save(filename) {
+		const { saveDocument } = await import("./fs-DF8ug9Wi.mjs").then((n) => n.t);
+		return saveDocument(await this.toDocument(), filename);
+	}
+	/**
+	* Start a new document section.
+	*
+	* Each section can have its own page size, orientation, margins,
+	* headers, and footers. Content added after this call belongs to
+	* the new section.
+	*
+	* @param config - — Optional section-level page/header/footer overrides
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* // Simple section break
+	* doc.p('Section 1 content').section().p('Section 2 content')
+	*
+	* // Section with custom page setup
+	* doc.section({ page: { size: 'A3', orientation: 'landscape' } })
+	*    .h1('Wide table')
+	*    .table({ columns: [...], data: [...] })
+	*
+	* // Section with header and footer
+	* doc.section({
+	*   header: { default: { children: ['Chapter 2', 'Confidential'] } },
+	*   footer: { default: { children: ['Page 2'] } },
+	* })
+	* ```
+	*/
+	section(config) {
+		this.nodes.push({
+			config,
+			type: "sectionBreak"
+		});
+		return this;
+	}
+	/**
+	* Add a table.
+	*
+	* @param options - — Table node options (columns, data, style, etc.)
+	* @returns The builder (for chaining)
+	*
+	* @example
+	* ```ts
+	* doc.table({
+	*   columns: [
+	*     { key: 'name', title: 'Name' },
+	*     { key: 'value', title: 'Value', align: 'right' },
+	*   ],
+	*   data: [{ name: 'Revenue', value: '$1.2M' }],
+	*   headerCellStyle: { fontWeight: 'bold' },
+	* })
+	* ```
+	*/
+	table(options) {
+		return this.add({
+			type: "table",
+			...options
+		});
+	}
+	/**
+	* Export the document as a base64-encoded string.
+	*
+	* @returns Base64-encoded .docx data
+	*
+	* @example
+	* ```ts
+	* const b64 = await doc.toBase64()
+	* // Send b64 over HTTP or store in a database
+	* ```
+	*/
+	async toBase64() {
+		const { packToBase64String } = await import("./pack-Bkdfq0_u.mjs");
+		return packToBase64String(await this.toDocument());
+	}
+	/**
+	* Export the document as a `Blob` (browser-friendly).
+	*
+	* @returns A `Blob` containing the .docx binary
+	*
+	* @example
+	* ```ts
+	* const blob = await doc.toBlob()
+	* const url = URL.createObjectURL(blob)
+	* ```
+	*/
+	async toBlob() {
+		const { packToBlob } = await import("./pack-Bkdfq0_u.mjs");
+		return packToBlob(await this.toDocument());
+	}
+	/**
+	* Export the document as a `Uint8Array` (alias for {@link toUint8Array}).
+	*
+	* **Note:** Despite the name, this returns a standard `Uint8Array`,
+	* not a Node.js `Buffer`. Prefer using {@link toUint8Array} for clarity.
+	*
+	* @returns Raw .docx bytes
+	*
+	* @example
+	* ```ts
+	* const bytes = await doc.toBuffer()
+	* fs.writeFileSync('output.docx', bytes)
+	* ```
+	*/
+	async toBuffer() {
+		return this.toUint8Array();
+	}
+	/**
+	* Compile and return the internal `docx` {@link Document} instance.
+	*
+	* Useful if you need to further manipulate the document with the
+	* raw `docx` library before packaging.
+	*
+	* @returns A `docx` `Document` object
+	*/
+	async toDocument() {
+		await Promise.all(this.pendingSetups);
+		this.pendingSetups.length = 0;
+		const { compileDocument } = await import("./compileDocument-DIFdjo67.mjs");
+		return compileDocument({
+			config: this.config,
+			nodes: this.nodes,
+			plugins: this.pluginMap
+		});
+	}
+	/**
+	* Serialize the builder state to a JSON-friendly object.
+	*
+	* Useful for debugging, serialization, or AI-driven document generation.
+	*
+	* @returns The config + content node array as a plain object
+	*/
+	toJSON() {
+		return {
+			...this.config,
+			content: this.nodes
+		};
+	}
+	/**
+	* Export the document as a `Uint8Array` (browser & Node.js).
+	*
+	* This is the preferred cross-platform export method.
+	*
+	* @returns Raw .docx bytes
+	*
+	* @example
+	* ```ts
+	* const bytes = await doc.toUint8Array()
+	* // In Node.js: import { writeFileSync } from 'node:fs'
+	* // In browser: trigger a download
+	* ```
+	*/
+	async toUint8Array() {
+		const { packToBuffer } = await import("./pack-Bkdfq0_u.mjs");
+		return packToBuffer(await this.toDocument());
+	}
+	/**
+	* Register a plugin.
+	*
+	* The plugin's name and options type are accumulated into the builder's
+	* type-level plugin registry, enabling type-safe `.plugin()` calls.
+	*
+	* @param plugin - — The plugin definition returned by `definePlugin()`
+	* @returns The builder with the plugin type merged into `TPlugins`
+	*
+	* @example
+	* ```ts
+	* const doc = createDocx()
+	*   .use(qrcodePlugin())
+	*   .plugin('qrcode', { text: 'https://example.com' })
+	* ```
+	*/
+	use(plugin) {
+		this.pluginMap.set(plugin.name, plugin);
+		if (plugin.setup) this.pendingSetups.push(Promise.resolve(plugin.setup()));
+		return this;
+	}
+};
+//#endregion
+//#region src/plugins/timeline/index.ts
+/**
+* Timeline plugin — renders a chronological timeline as a styled table.
+*
+* Each event occupies one table row: a date cell, a visual connector
+* cell, and a content cell (title + optional description).
+*
+* @module plugins/timeline
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(timelinePlugin())
+*   .plugin('timeline', {
+*     events: [
+*       { date: '2026-01', title: '项目立项', description: '完成需求评审' },
+*       { date: '2026-03', title: 'MVP 发布', description: '核心功能上线' },
+*     ],
+*   })
+*   .save('timeline.docx')
+* ```
+*/
+/** Default table column widths (in DXA, twips). */
+const COL_WIDTHS = {
+	connector: 600,
+	content: 6400,
+	date: 1800
+};
+/**
+* Create a Timeline plugin instance.
+*
+* @returns A configured DocxPlugin for `'timeline'`
+*
+* @example
+* ```ts
+* import { createDocx, timelinePlugin } from 'docx-kit'
+*
+* const doc = createDocx()
+*   .use(timelinePlugin())
+*   .plugin('timeline', {
+*     events: [
+*       { date: '2026-01', title: '项目启动', description: '团队组建完成' },
+*       { date: '2026-04', title: 'Beta 测试', description: '收集用户反馈' },
+*       { date: '2026-06', title: '正式发布' },
+*     ],
+*   })
+* ```
+*/
+function timelinePlugin() {
+	return definePlugin({
+		name: "timeline",
+		render(options) {
+			const { accentColor = "4472C4", events, layout = "alternating" } = options;
+			if (events.length === 0) return new Paragraph({ text: "(No events)" });
+			const emptyCell = (width) => new TableCell({
+				children: [new Paragraph({ children: [] })],
+				width: {
+					size: width,
+					type: WidthType.DXA
+				},
+				borders: {
+					bottom: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					left: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					right: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					top: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					}
+				}
+			});
+			const connectorCell = () => new TableCell({
+				width: {
+					size: COL_WIDTHS.connector,
+					type: WidthType.DXA
+				},
+				borders: {
+					bottom: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					left: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					right: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					top: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					}
+				},
+				children: [new Paragraph({
+					alignment: AlignmentType.CENTER,
+					children: [new TextRun({
+						color: accentColor,
+						font: "Arial",
+						size: 24,
+						text: "●"
+					})]
+				})]
+			});
+			const dateCell = (date) => new TableCell({
+				width: {
+					size: COL_WIDTHS.date,
+					type: WidthType.DXA
+				},
+				borders: {
+					bottom: {
+						color: accentColor,
+						size: 1,
+						style: BorderStyle.SINGLE
+					},
+					left: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					right: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					top: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					}
+				},
+				children: [new Paragraph({
+					alignment: AlignmentType.RIGHT,
+					children: [new TextRun({
+						bold: true,
+						color: accentColor,
+						font: "Arial",
+						size: 22,
+						text: date
+					})]
+				})],
+				shading: {
+					fill: "F0F5FF",
+					type: ShadingType.CLEAR
+				}
+			});
+			const contentCell = (title, description) => {
+				const runs = [new TextRun({
+					bold: true,
+					font: "Arial",
+					size: 24,
+					text: title
+				})];
+				if (description) runs.push(new TextRun({
+					break: 1,
+					color: "555555",
+					font: "Arial",
+					size: 20,
+					text: description
+				}));
+				return new TableCell({
+					children: [new Paragraph({ children: runs })],
+					width: {
+						size: COL_WIDTHS.content,
+						type: WidthType.DXA
+					},
+					borders: {
+						left: {
+							color: "FFFFFF",
+							size: 0,
+							style: BorderStyle.NONE
+						},
+						right: {
+							color: "FFFFFF",
+							size: 0,
+							style: BorderStyle.NONE
+						},
+						top: {
+							color: "FFFFFF",
+							size: 0,
+							style: BorderStyle.NONE
+						},
+						bottom: {
+							color: "DDDDDD",
+							size: 1,
+							style: BorderStyle.SINGLE
+						}
+					}
+				});
+			};
+			return new Table({
+				rows: events.map((event, index) => {
+					if (layout === "left" ? true : layout === "right" ? false : index % 2 === 0) return new TableRow({ children: [
+						dateCell(event.date),
+						connectorCell(),
+						contentCell(event.title, event.description)
+					] });
+					return new TableRow({ children: [
+						emptyCell(COL_WIDTHS.date),
+						connectorCell(),
+						contentCell(event.title, event.description)
+					] });
+				}),
+				width: {
+					size: 100,
+					type: WidthType.PERCENTAGE
+				},
+				borders: {
+					bottom: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					left: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					right: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					top: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					},
+					insideHorizontal: {
+						color: "FFFFFF",
+						size: 0,
+						style: BorderStyle.NONE
+					}
+				}
+			});
+		}
+	});
+}
+//#endregion
+//#region src/plugins/watermark/index.ts
+/**
+* Watermark plugin — text watermark rendered as a styled paragraph.
+*
+* Renders a large, semi-transparent (gray) text paragraph that can be
+* placed in a section header or footer to simulate a watermark.
+*
+* @module plugins/watermark
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(watermarkPlugin())
+*   .plugin('watermark', { text: 'CONFIDENTIAL', color: 'FF0000' })
+*   .save('watermark.docx')
+* ```
+*/
+/**
+* Create a Watermark plugin instance.
+*
+* @returns A configured DocxPlugin for `'watermark'`
+*
+* @example
+* ```ts
+* import { createDocx, watermarkPlugin } from 'docx-kit'
+*
+* const doc = createDocx()
+*   .use(watermarkPlugin())
+*   .plugin('watermark', { text: 'DRAFT', color: 'FF0000' })
+* ```
+*/
+function watermarkPlugin() {
+	return definePlugin({
+		name: "watermark",
+		render(options) {
+			return new Paragraph({
+				alignment: options.alignment ?? AlignmentType.CENTER,
+				spacing: {
+					after: 0,
+					before: 0
+				},
+				children: [new TextRun({
+					bold: true,
+					color: options.color ?? "BFBFBF",
+					font: "Arial",
+					size: options.fontSize ?? 48,
+					text: options.text
+				})]
+			});
+		}
+	});
+}
+//#endregion
+//#region src/plugins/code-block/index.ts
+/**
+* Code Block plugin — renders source code with monospaced font and
+* optional line numbers and syntax highlighting.
+*
+* Syntax highlighting requires `highlight.js` as an optional peer dependency.
+* When unavailable (or when `language` is not provided), the plugin falls
+* back to plain monospaced rendering.
+*
+* @module plugins/code-block
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(codeBlockPlugin())
+*   .plugin('codeBlock', {
+*     code: `export function hello() {\n  return "world"\n}`,
+*     language: 'typescript',
+*     showLineNumbers: true,
+*   })
+*   .save('code.docx')
+* ```
+*/
+/** Highlight.js token → `TextRun` color mapping for common token types. */
+const TOKEN_COLORS = {
+	attr: "D4D4D4",
+	built_in: "4EC9B0",
+	comment: "6A9955",
+	function: "DCDCAA",
+	keyword: "569CD6",
+	literal: "B5CEA8",
+	meta: "9B9B9B",
+	number: "B5CEA8",
+	params: "D4D4D4",
+	property: "9CDCFE",
+	regexp: "D16969",
+	string: "CE9178",
+	title: "DCDCAA",
+	type: "4EC9B0",
+	variable: "9CDCFE"
+};
+const CODE_BG = "F5F5F5";
+const LINE_NO_COLOR = "999999";
+const MONO_FONT = "Courier New";
+const FONT_SIZE = 16;
+/**
+* Create a CodeBlock plugin instance.
+*
+* @returns A configured DocxPlugin for `'codeBlock'`
+*/
+function codeBlockPlugin() {
+	return definePlugin({
+		name: "codeBlock",
+		async render(options) {
+			const lines = options.code.split("\n");
+			if (options.language) try {
+				return tokensToParagraphs((await import("highlight.js")).default.highlight(options.code, { language: options.language }).value || options.code, options.showLineNumbers);
+			} catch {}
+			return linesToParagraphs(lines, options.showLineNumbers);
+		}
+	});
+}
+/** Render plain (unhighlighted) code lines as Paragraphs. */
+function linesToParagraphs(lines, showLineNumbers) {
+	const maxDigits = showLineNumbers ? String(lines.length).length : 0;
+	return lines.map((line, i) => new Paragraph({
+		shading: {
+			fill: CODE_BG,
+			type: ShadingType.CLEAR
+		},
+		spacing: {
+			after: 0,
+			before: 0
+		},
+		children: [...showLineNumbers ? [new TextRun({
+			color: LINE_NO_COLOR,
+			font: MONO_FONT,
+			size: FONT_SIZE,
+			text: `${String(i + 1).padStart(maxDigits, " ")} \u2502 `
+		})] : [], new TextRun({
+			font: MONO_FONT,
+			size: FONT_SIZE,
+			text: line
+		})]
+	}));
+}
+/** Parse a single line of Highlight.js HTML into TextRun tokens. */
+function parseHighlightHtml(html) {
+	const results = [];
+	const regex = /<span\s+class="hljs-(\w+)">(.*?)<\/span>/g;
+	let lastIndex = 0;
+	let match = regex.exec(html);
+	while (match !== null) {
+		if (match.index > lastIndex) {
+			const before = html.slice(lastIndex, match.index);
+			if (before) results.push(new TextRun({
+				font: MONO_FONT,
+				size: FONT_SIZE,
+				text: before
+			}));
+		}
+		const type = match[1];
+		const text = match[2];
+		const color = TOKEN_COLORS[type] ?? "D4D4D4";
+		results.push(new TextRun({
+			color,
+			font: MONO_FONT,
+			size: FONT_SIZE,
+			text
+		}));
+		lastIndex = match.index + match[0].length;
+		match = regex.exec(html);
+	}
+	if (lastIndex < html.length) {
+		const after = html.slice(lastIndex);
+		if (after) results.push(new TextRun({
+			font: MONO_FONT,
+			size: FONT_SIZE,
+			text: after
+		}));
+	}
+	if (results.length === 0 && html) results.push(new TextRun({
+		font: MONO_FONT,
+		size: FONT_SIZE,
+		text: html
+	}));
+	return results;
+}
+/**
+* Convert Highlight.js HTML token output back to styled Paragraphs.
+*
+* Parses `<span class="hljs-xxx">…</span>` markup emitted by
+* `hljs.highlight().value`.
+*/
+function tokensToParagraphs(html, showLineNumbers) {
+	const lineStrings = html.split("\n");
+	const maxDigits = showLineNumbers ? String(lineStrings.length).length : 0;
+	return lineStrings.map((lineHtml, i) => {
+		const runs = parseHighlightHtml(lineHtml);
+		return new Paragraph({
+			shading: {
+				fill: CODE_BG,
+				type: ShadingType.CLEAR
+			},
+			spacing: {
+				after: 0,
+				before: 0
+			},
+			children: [...showLineNumbers ? [new TextRun({
+				color: LINE_NO_COLOR,
+				font: MONO_FONT,
+				size: FONT_SIZE,
+				text: `${String(i + 1).padStart(maxDigits, " ")} \u2502 `
+			})] : [], ...runs]
+		});
+	});
+}
+//#endregion
+//#region src/plugins/cover-page/index.ts
+/**
+* Cover Page plugin — generates a professional title page.
+*
+* Renders a centered block with title, subtitle, author, date,
+* organization, and an optional decorative horizontal rule.
+*
+* @module plugins/cover-page
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(coverPagePlugin())
+*   .plugin('coverPage', {
+*     title: 'Q3 运营报告',
+*     subtitle: '数据驱动 · 智能决策',
+*     author: '数据分析部',
+*   })
+*   .save('report.docx')
+* ```
+*/
+/**
+* Create a Cover Page plugin instance.
+*
+* @returns A configured DocxPlugin for `'coverPage'`
+*
+* @example
+* ```ts
+* import { coverPagePlugin, createDocx } from 'docx-kit'
+*
+* const doc = createDocx()
+*   .use(coverPagePlugin())
+*   .plugin('coverPage', {
+*     title: '年度报告',
+*     subtitle: '2026',
+*     author: '战略发展部',
+*     organization: 'XX 科技集团',
+*   })
+* ```
+*/
+function coverPagePlugin() {
+	return definePlugin({
+		name: "coverPage",
+		render(options) {
+			const alignment = options.alignment ?? AlignmentType.CENTER;
+			const showRule = options.showRule !== false;
+			const titlePara = new Paragraph({
+				alignment,
+				spacing: { after: 200 },
+				children: [new TextRun({
+					bold: true,
+					font: "Arial",
+					size: 56,
+					text: options.title
+				})],
+				...options.backgroundColor ? { shading: {
+					fill: options.backgroundColor,
+					type: ShadingType.CLEAR
+				} } : {}
+			});
+			return [
+				new Paragraph({
+					children: [],
+					spacing: { before: 2400 }
+				}),
+				titlePara,
+				...options.subtitle ? [new Paragraph({
+					alignment,
+					spacing: { after: 400 },
+					children: [new TextRun({
+						color: "555555",
+						font: "Arial",
+						size: 32,
+						text: options.subtitle
+					})]
+				})] : [],
+				...showRule ? [new Paragraph({
+					alignment,
+					children: [],
+					spacing: { after: 400 },
+					border: { bottom: {
+						color: "4472C4",
+						size: 6,
+						space: 1,
+						style: BorderStyle.SINGLE
+					} }
+				})] : [],
+				...options.author ? [new Paragraph({
+					alignment,
+					spacing: { after: 120 },
+					children: [new TextRun({
+						font: "Arial",
+						size: 28,
+						text: options.author
+					})]
+				})] : [],
+				...options.organization ? [new Paragraph({
+					alignment,
+					spacing: { after: 120 },
+					children: [new TextRun({
+						color: "333333",
+						font: "Arial",
+						size: 24,
+						text: options.organization
+					})]
+				})] : [],
+				...options.date ? [new Paragraph({
+					alignment,
+					spacing: { after: 0 },
+					children: [new TextRun({
+						color: "777777",
+						font: "Arial",
+						size: 24,
+						text: options.date
+					})]
+				})] : []
+			];
+		}
+	});
+}
+//#endregion
+//#region src/plugins/data-table/index.ts
+/**
+* Data Table plugin — renders an array of objects as a styled table.
+*
+* Columns are auto-inferred from the first object’s keys.  Column headers
+* can be localised via `labels`, value formatting is controlled by `format`,
+* and per-column alignment is controlled by `align`.
+*
+* @module plugins/data-table
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(dataTablePlugin())
+*   .plugin('dataTable', {
+*     data: [
+*       { name: 'Alice', age: 30, salary: 85000 },
+*       { name: 'Bob',   age: 25, salary: 62000 },
+*     ],
+*     labels: { name: '姓名', age: '年龄', salary: '薪资' },
+*     format: { salary: 'currency' },
+*     striped: true,
+*   })
+*   .save('table.docx')
+* ```
+*/
+const HEADER_SHADING$1 = {
+	fill: "4472C4",
+	type: ShadingType.CLEAR
+};
+const STRIPE_SHADING = {
+	fill: "F2F2F2",
+	type: ShadingType.CLEAR
+};
+/**
+* Create a DataTable plugin instance.
+*
+* @returns A configured DocxPlugin for `'dataTable'`
+*/
+function dataTablePlugin() {
+	return definePlugin({
+		name: "dataTable",
+		render(options) {
+			const { align, bordered, data, format, labels, striped } = options;
+			if (!data.length) return new Paragraph({
+				alignment: AlignmentType.CENTER,
+				children: [new TextRun({
+					color: "999999",
+					text: "(no data)"
+				})]
+			});
+			const columns = Object.keys(data[0]);
+			const displayedBordered = bordered !== false;
+			const borderOptions = displayedBordered ? {
+				bottom: {
+					color: "CCCCCC",
+					size: 1,
+					style: BorderStyle.SINGLE
+				},
+				left: {
+					color: "CCCCCC",
+					size: 1,
+					style: BorderStyle.SINGLE
+				},
+				right: {
+					color: "CCCCCC",
+					size: 1,
+					style: BorderStyle.SINGLE
+				},
+				top: {
+					color: "CCCCCC",
+					size: 1,
+					style: BorderStyle.SINGLE
+				}
+			} : {};
+			const rows = [new TableRow({ children: columns.map((col) => {
+				const label = labels?.[col] ?? col;
+				return new TableCell({
+					shading: HEADER_SHADING$1,
+					children: [new Paragraph({
+						alignment: AlignmentType.CENTER,
+						children: [new TextRun({
+							bold: true,
+							color: "FFFFFF",
+							text: label
+						})]
+					})],
+					...displayedBordered ? { borders: borderOptions } : {}
+				});
+			}) })];
+			for (let i = 0; i < data.length; i++) {
+				const row = data[i];
+				const cells = columns.map((col) => {
+					const colAlign = align?.[col] ?? inferAlignment(col, data);
+					const val = formatValue(row[col], format?.[col]);
+					return new TableCell({
+						shading: striped && i % 2 === 1 ? STRIPE_SHADING : void 0,
+						children: [new Paragraph({
+							alignment: alignmentToDocx(colAlign),
+							children: [new TextRun({ text: val })]
+						})],
+						...displayedBordered ? { borders: borderOptions } : {}
+					});
+				});
+				rows.push(new TableRow({ children: cells }));
+			}
+			return new Table({
+				rows,
+				width: {
+					size: 100,
+					type: WidthType.PERCENTAGE
+				}
+			});
+		}
+	});
+}
+function alignmentToDocx(a) {
+	return a === "right" ? AlignmentType.RIGHT : a === "center" ? AlignmentType.CENTER : AlignmentType.LEFT;
+}
+function formatValue(value, fmt) {
+	if (value == null) return "";
+	if (fmt === "currency") {
+		const n = typeof value === "number" ? value : Number(value);
+		return Number.isFinite(n) ? `\u00A5${n.toLocaleString("zh-CN", {
+			maximumFractionDigits: 2,
+			minimumFractionDigits: 2
+		})}` : String(value);
+	}
+	if (fmt === "number") {
+		const n = typeof value === "number" ? value : Number(value);
+		return Number.isFinite(n) ? n.toLocaleString("zh-CN") : String(value);
+	}
+	if (fmt === "percent") {
+		const n = typeof value === "number" ? value : Number(value);
+		return Number.isFinite(n) ? `${(n * 100).toFixed(1)}%` : String(value);
+	}
+	if (fmt === "date") {
+		if (value instanceof Date) return `${value.getFullYear()}-${String(value.getMonth() + 1).padStart(2, "0")}-${String(value.getDate()).padStart(2, "0")}`;
+		const d = new Date(String(value));
+		return Number.isNaN(d.getTime()) ? String(value) : `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+	}
+	return String(value);
+}
+function inferAlignment(col, data) {
+	return isColumnNumeric(col, data) ? "right" : "left";
+}
+function isColumnNumeric(col, data) {
+	let hasNumeric = false;
+	for (const row of data) {
+		const v = row[col];
+		if (v == null || v === "") continue;
+		if (typeof v === "number") hasNumeric = true;
+		else if (typeof v === "string" && Number.isFinite(Number(v))) hasNumeric = true;
+		else return false;
+	}
+	return hasNumeric;
+}
+//#endregion
+//#region src/plugins/page-number/index.ts
+/**
+* Page Number plugin — generates a `Paragraph` containing a page number
+* field for placement inside section headers or footers.
+*
+* The paragraph can be inserted into a `Header` or `Footer` definition
+* and will render the current page number.
+*
+* @module plugins/page-number
+*
+* @example
+* ```ts
+* const pn = doc.plugin('pageNumber', { format: 'roman' })
+* doc.section({ footers: { default: [pn] } })
+* ```
+*/
+/**
+* Create a Page Number plugin instance.
+*
+* @returns A configured DocxPlugin for `'pageNumber'`
+*
+* @example
+* ```ts
+* import { createDocx, pageNumberPlugin } from 'docx-kit'
+*
+* const doc = createDocx()
+*   .use(pageNumberPlugin())
+*   // Use the page number content in a footer
+*   const pn = doc.plugin('pageNumber', { alignment: 'center' })
+* ```
+*/
+function pageNumberPlugin() {
+	return definePlugin({
+		name: "pageNumber",
+		render(options) {
+			const alignment = options.alignment ?? AlignmentType.CENTER;
+			const fontSize = options.fontSize ?? 20;
+			if (options.showTotal) return new Paragraph({
+				alignment,
+				spacing: {
+					after: 0,
+					before: 0
+				},
+				children: [
+					new TextRun({
+						font: "Arial",
+						size: fontSize,
+						text: "Page "
+					}),
+					new TextRun({
+						children: [PageNumber.CURRENT],
+						font: "Arial",
+						size: fontSize
+					}),
+					new TextRun({
+						font: "Arial",
+						size: fontSize,
+						text: " of "
+					}),
+					new TextRun({
+						children: [PageNumber.TOTAL_PAGES],
+						font: "Arial",
+						size: fontSize
+					})
+				]
+			});
+			return new Paragraph({
+				alignment,
+				spacing: {
+					after: 0,
+					before: 0
+				},
+				children: [new TextRun({
+					children: [PageNumber.CURRENT],
+					font: "Arial",
+					size: fontSize
+				})]
+			});
+		}
+	});
+}
+//#endregion
+//#region src/builder/createDocx.ts
+/**
+* Factory functions for creating `DocxBuilder` instances.
+*
+* Two entry points are provided:
+* - `createDocx()` — Fluent builder API with chaining
+* - `renderDocx()` — JSON-schema driven (AI-friendly / serializable)
+*
+* @module builder/createDocx
+*/
+/**
+* Create a new DocxBuilder with optional configuration.
+*
+* This is the primary entry point for the fluent builder API.
+* Chain `.h1()`, `.p()`, `.table()`, etc. and call `.save()`
+* or `.toBlob()` to export.
+*
+* @param config - — Document configuration (page, styles, metadata, theme, defaults)
+* @returns A new `DocxBuilder` instance
+*
+* @example
+* ```ts
+* const styles = defineStyles({
+*   title: { fontSize: 28, fontWeight: 'bold' },
+*   body:  { fontSize: 12, lineHeight: 1.5 },
+* })
+*
+* const doc = createDocx({
+*   styles,
+*   page: { size: 'A4', margin: '20mm' },
+*   metadata: { title: 'Report', creator: 'docx-kit' },
+* })
+*
+* await doc
+*   .h1('Annual Report', { className: 'title' })
+*   .p('Lorem ipsum...', { className: 'body' })
+*   .save('report.docx')
+* ```
+*/
+function createDocx(config = {}) {
+	return new DocxBuilder(config);
+}
+/**
+* Render a document from a JSON schema (AI-friendly / serializable DSL).
+*
+* Unlike `createDocx()`, this accepts a single JSON-serializable object
+* with `content` (node array), optional `styles`, and optional `page` config.
+* Ideal for AI-driven document generation or API integrations.
+*
+* @param schema - — The `DocxSchema` object
+* @returns A `DocxBuilder` instance (ready to export)
+*
+* @example
+* ```ts
+* const blob = await renderDocx({
+*   page: { size: 'A4', margin: '20mm' },
+*   styles: {
+*     h1: { fontSize: 24, fontWeight: 'bold' },
+*     p:  { fontSize: 12 },
+*   },
+*   content: [
+*     { type: 'heading',  level: 1, text: 'Report', className: 'h1' },
+*     { type: 'paragraph', text: 'This is a report generated via JSON DSL.', className: 'p' },
+*     { type: 'pageBreak' },
+*     {
+*       type: 'table',
+*       columns: [{ key: 'name', title: 'Name' }, { key: 'value', title: 'Value' }],
+*       data: [{ name: 'Revenue', value: '$1.2M' }],
+*     },
+*   ],
+* }).toBlob()
+* ```
+*/
+function renderDocx(schema) {
+	const { content, ...config } = schema;
+	const builder = new DocxBuilder(config);
+	for (const node of content) builder.add(node);
+	return builder;
+}
+//#endregion
+//#region src/plugins/property-table/index.ts
+/**
+* Property Table plugin — renders key-value pairs as a styled 2-column table.
+*
+* The key column is right-aligned with gray background; the value column
+* is left-aligned.  Ideal for config tables, parameter docs, and spec sheets.
+*
+* @module plugins/property-table
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(propertyTablePlugin())
+*   .plugin('propertyTable', {
+*     items: [
+*       { key: '项目名称', value: 'XX管理系统' },
+*       { key: '技术栈',   value: 'React + Node.js + PostgreSQL' },
+*     ],
+*     keyBold: true,
+*   })
+*   .save('props.docx')
+* ```
+*/
+const KEY_SHADING = {
+	fill: "F2F2F2",
+	type: ShadingType.CLEAR
+};
+const VALUE_SHADING = {
+	fill: "F2F2F2",
+	type: ShadingType.CLEAR
+};
+/**
+* Create a PropertyTable plugin instance.
+*
+* @returns A configured DocxPlugin for `'propertyTable'`
+*/
+function propertyTablePlugin() {
+	return definePlugin({
+		name: "propertyTable",
+		render(options) {
+			const { items, keyBold = true, striped = true } = options;
+			if (!items.length) return new Paragraph({
+				alignment: AlignmentType.CENTER,
+				children: [new TextRun({
+					color: "999999",
+					text: "(no items)"
+				})]
+			});
+			return new Table({
+				rows: items.map((item, i) => {
+					const isEven = i % 2 === 1;
+					const cellShading = striped && isEven ? VALUE_SHADING : void 0;
+					return new TableRow({ children: [new TableCell({
+						shading: striped && isEven ? KEY_SHADING : void 0,
+						width: {
+							size: 3500,
+							type: WidthType.DXA
+						},
+						children: [new Paragraph({
+							alignment: AlignmentType.RIGHT,
+							children: [new TextRun({
+								bold: keyBold,
+								text: item.key
+							})]
+						})]
+					}), new TableCell({
+						shading: cellShading,
+						children: [new Paragraph({ children: [new TextRun({ text: item.value })] })]
+					})] });
+				}),
+				width: {
+					size: 100,
+					type: WidthType.PERCENTAGE
+				}
+			});
+		}
+	});
+}
+//#endregion
+//#region src/plugins/meeting-minutes/index.ts
+/**
+* Meeting Minutes plugin — structured meeting notes with header, meta info,
+* and an agenda table.
+*
+* Renders a title paragraph, a date/attendees summary line, and a 4-column
+* agenda table (Topic | Discussion | Decision | Owner).
+*
+* @module plugins/meeting-minutes
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(meetingMinutesPlugin())
+*   .plugin('meetingMinutes', {
+*     title: '项目周会纪要',
+*     date: '2026-06-11',
+*     attendees: ['张三', '李四', '王五'],
+*     agenda: [
+*       { topic: '项目进度', discussion: '模块A已完成80%', decision: '下周一上线', owner: '张三' },
+*       { topic: '风险项', discussion: '第三方API不稳定', decision: '增加重试机制', owner: '李四' },
+*     ],
+*   })
+*   .save('minutes.docx')
+* ```
+*/
+const HEADER_SHADING = {
+	fill: "4472C4",
+	type: ShadingType.CLEAR
+};
+const BORDER = {
+	bottom: {
+		color: "CCCCCC",
+		size: 1,
+		style: BorderStyle.SINGLE
+	},
+	left: {
+		color: "CCCCCC",
+		size: 1,
+		style: BorderStyle.SINGLE
+	},
+	right: {
+		color: "CCCCCC",
+		size: 1,
+		style: BorderStyle.SINGLE
+	},
+	top: {
+		color: "CCCCCC",
+		size: 1,
+		style: BorderStyle.SINGLE
+	}
+};
+const AGENDA_COLUMNS = [
+	"议题",
+	"讨论",
+	"决议",
+	"负责人"
+];
+/**
+* Create a MeetingMinutes plugin instance.
+*
+* @returns A configured DocxPlugin for `'meetingMinutes'`
+*/
+function meetingMinutesPlugin() {
+	return definePlugin({
+		name: "meetingMinutes",
+		render(options) {
+			const titlePara = new Paragraph({
+				children: [new TextRun({
+					bold: true,
+					size: 32,
+					text: options.title
+				})],
+				heading: HeadingLevel.HEADING_1,
+				spacing: { after: 200 }
+			});
+			const metaPara = new Paragraph({
+				spacing: { after: 300 },
+				children: [
+					new TextRun({
+						bold: true,
+						text: "日期："
+					}),
+					new TextRun({ text: options.date }),
+					new TextRun({ text: "    " }),
+					new TextRun({
+						bold: true,
+						text: "参会人员："
+					}),
+					new TextRun({ text: options.attendees.join("、") })
+				]
+			});
+			if (options.agenda.length === 0) return [titlePara, metaPara];
+			const headerCells = AGENDA_COLUMNS.map((col) => new TableCell({
+				borders: BORDER,
+				shading: HEADER_SHADING,
+				children: [new Paragraph({
+					alignment: AlignmentType.CENTER,
+					children: [new TextRun({
+						bold: true,
+						color: "FFFFFF",
+						text: col
+					})]
+				})]
+			}));
+			const agendaRows = options.agenda.map((item) => {
+				return new TableRow({ children: [
+					item.topic,
+					item.discussion,
+					item.decision ?? "",
+					item.owner ?? ""
+				].map((val) => new TableCell({
+					borders: BORDER,
+					children: [new Paragraph({ children: [new TextRun({ text: val })] })]
+				})) });
+			});
+			return [
+				titlePara,
+				metaPara,
+				new Table({
+					rows: [new TableRow({ children: headerCells }), ...agendaRows],
+					width: {
+						size: 100,
+						type: WidthType.PERCENTAGE
+					}
+				})
+			];
+		}
+	});
+}
+//#endregion
+//#region src/plugins/signature-block/index.ts
+/**
+* Signature Block plugin — renders signature lines for contracts and approvals.
+*
+* Each party gets a cell in a borderless table with a bold label,
+* a signature line (underlined placeholder), and an optional date.
+*
+* @module plugins/signature-block
+*
+* @example
+* ```ts
+* const doc = createDocx()
+*   .use(signatureBlockPlugin())
+*   .plugin('signatureBlock', {
+*     parties: [
+*       { label: '甲方（盖章）', date: '2026年  月  日' },
+*       { label: '乙方（盖章）', date: '2026年  月  日' },
+*     ],
+*     columns: 2,
+*   })
+*   .save('signature.docx')
+* ```
+*/
+/**
+* Create a SignatureBlock plugin instance.
+*
+* @returns A configured DocxPlugin for `'signatureBlock'`
+*/
+function signatureBlockPlugin() {
+	return definePlugin({
+		name: "signatureBlock",
+		render(options) {
+			const { columns = 2, parties } = options;
+			if (!parties.length) return new Paragraph({
+				alignment: AlignmentType.CENTER,
+				children: [new TextRun({
+					color: "999999",
+					text: "(no signatures)"
+				})]
+			});
+			function buildPartyCell(party) {
+				return new TableCell({ children: [
+					new Paragraph({
+						children: [new TextRun({
+							bold: true,
+							text: party.label
+						})],
+						spacing: { after: 200 }
+					}),
+					party.name ? new Paragraph({
+						children: [new TextRun({
+							text: party.name,
+							underline: {}
+						})],
+						spacing: { after: 80 }
+					}) : new Paragraph({
+						spacing: { after: 80 },
+						children: [new TextRun({
+							text: "_____________________________",
+							underline: {}
+						})]
+					}),
+					new Paragraph({ children: [new TextRun({
+						color: "666666",
+						size: 18,
+						text: party.date ?? ""
+					})] })
+				] });
+			}
+			const partyRows = [];
+			for (let i = 0; i < parties.length; i += columns) partyRows[partyRows.length] = parties.slice(i, i + columns);
+			return new Table({
+				rows: partyRows.map((rowParties) => {
+					let rowCells = rowParties.map(buildPartyCell);
+					if (rowCells.length < columns) {
+						const emptyCell = new TableCell({ children: [new Paragraph("")] });
+						const padCount = columns - rowCells.length;
+						const padding = Array.from({ length: padCount }).map(() => emptyCell);
+						rowCells = [...rowCells, ...padding];
+					}
+					return new TableRow({ children: rowCells });
+				}),
+				width: {
+					size: 100,
+					type: WidthType.PERCENTAGE
+				}
+			});
+		}
+	});
+}
+//#endregion
+//#region src/presets/academic.ts
+const academicPreset = {
+	id: "academic",
+	name: "Academic",
+	config: {
+		defaults: {
+			image: {
+				marginBottom: 12,
+				marginTop: 12,
+				textAlign: "center"
+			},
+			paragraph: {
+				fontFamily: "Times New Roman",
+				fontSize: 12,
+				lineHeight: 2,
+				marginBottom: 0,
+				marginTop: 0,
+				textAlign: "justify",
+				textIndent: "24pt"
+			}
+		},
+		styles: {
+			h1: {
+				color: "#000000",
+				fontFamily: "Times New Roman",
+				fontSize: 16,
+				fontWeight: "bold",
+				lineHeight: 1.5,
+				marginBottom: 12,
+				marginTop: 24,
+				textAlign: "center"
+			},
+			h2: {
+				color: "#000000",
+				fontFamily: "Times New Roman",
+				fontSize: 14,
+				fontWeight: "bold",
+				lineHeight: 1.5,
+				marginBottom: 8,
+				marginTop: 18
+			},
+			h3: {
+				color: "#000000",
+				fontFamily: "Times New Roman",
+				fontSize: 12,
+				fontWeight: "bold",
+				lineHeight: 1.5,
+				marginBottom: 6,
+				marginTop: 14
+			},
+			h4: {
+				color: "#000000",
+				fontFamily: "Times New Roman",
+				fontSize: 12,
+				fontStyle: "italic",
+				fontWeight: "bold",
+				lineHeight: 1.5,
+				marginBottom: 5,
+				marginTop: 12
+			},
+			h5: {
+				color: "#000000",
+				fontFamily: "Times New Roman",
+				fontSize: 11,
+				fontWeight: "bold",
+				lineHeight: 1.5,
+				marginBottom: 4,
+				marginTop: 10
+			},
+			h6: {
+				color: "#333333",
+				fontFamily: "Times New Roman",
+				fontSize: 10,
+				fontWeight: "bold",
+				lineHeight: 1.5,
+				marginBottom: 4,
+				marginTop: 8
+			},
+			p: {
+				fontFamily: "Times New Roman",
+				fontSize: 12,
+				lineHeight: 2,
+				marginBottom: 0,
+				marginTop: 0,
+				textAlign: "justify",
+				textIndent: "24pt"
+			}
+		}
+	},
+	description: "Formal academic style with Times New Roman, double spacing, and justified text."
+};
+//#endregion
+//#region src/presets/classic.ts
+const classicPreset = {
+	id: "classic",
+	name: "Classic",
+	config: {
+		defaults: {
+			image: {
+				marginBottom: 8,
+				marginTop: 8,
+				textAlign: "center"
+			},
+			paragraph: {
+				fontFamily: "SimSun",
+				fontSize: 14,
+				lineHeight: 1.5,
+				marginBottom: 6,
+				marginTop: 0,
+				textIndent: "28pt"
+			}
+		},
+		styles: {
+			h1: {
+				color: "#000000",
+				fontFamily: "SimHei",
+				fontSize: 22,
+				fontWeight: "bold",
+				lineHeight: 1.5,
+				marginBottom: 12,
+				marginTop: 20,
+				textAlign: "center"
+			},
+			h2: {
+				color: "#000000",
+				fontFamily: "SimHei",
+				fontSize: 16,
+				fontWeight: "bold",
+				lineHeight: 1.5,
+				marginBottom: 8,
+				marginTop: 16
+			},
+			h3: {
+				color: "#000000",
+				fontFamily: "KaiTi",
+				fontSize: 16,
+				fontWeight: "bold",
+				lineHeight: 1.5,
+				marginBottom: 6,
+				marginTop: 12
+			},
+			h4: {
+				color: "#000000",
+				fontFamily: "KaiTi",
+				fontSize: 14,
+				fontWeight: "bold",
+				lineHeight: 1.4,
+				marginBottom: 5,
+				marginTop: 10
+			},
+			h5: {
+				color: "#000000",
+				fontFamily: "SimSun",
+				fontSize: 14,
+				fontWeight: "bold",
+				lineHeight: 1.4,
+				marginBottom: 4,
+				marginTop: 8
+			},
+			h6: {
+				color: "#000000",
+				fontFamily: "SimSun",
+				fontSize: 12,
+				fontWeight: "bold",
+				lineHeight: 1.4,
+				marginBottom: 4,
+				marginTop: 8
+			},
+			p: {
+				fontFamily: "SimSun",
+				fontSize: 14,
+				lineHeight: 1.5,
+				marginBottom: 6,
+				marginTop: 0,
+				textIndent: "28pt"
+			}
+		}
+	},
+	description: "Formal official-document style with SimHei headings, SimSun body, and two-character indent."
+};
+//#endregion
+//#region src/presets/modern.ts
+const modernPreset = {
+	id: "modern",
+	name: "Modern",
+	config: {
+		defaults: {
+			image: {
+				marginBottom: 10,
+				marginTop: 10,
+				textAlign: "center"
+			},
+			paragraph: {
+				fontFamily: "Calibri",
+				fontSize: 11,
+				lineHeight: 1.5,
+				marginBottom: 8,
+				marginTop: 0
+			}
+		},
+		styles: {
+			h1: {
+				borderBottom: {
+					color: "#2E75B6",
+					style: "single",
+					width: "1.5pt"
+				},
+				color: "#1B2A4A",
+				fontFamily: "Calibri",
+				fontSize: 26,
+				fontWeight: "bold",
+				lineHeight: 1.3,
+				marginBottom: 12,
+				marginTop: 24
+			},
+			h2: {
+				color: "#2E75B6",
+				fontFamily: "Calibri",
+				fontSize: 20,
+				fontWeight: "bold",
+				lineHeight: 1.3,
+				marginBottom: 10,
+				marginTop: 20
+			},
+			h3: {
+				color: "#2E75B6",
+				fontFamily: "Calibri",
+				fontSize: 16,
+				fontWeight: "bold",
+				lineHeight: 1.35,
+				marginBottom: 8,
+				marginTop: 16
+			},
+			h4: {
+				color: "#404040",
+				fontFamily: "Calibri",
+				fontSize: 14,
+				fontWeight: "bold",
+				lineHeight: 1.35,
+				marginBottom: 6,
+				marginTop: 12
+			},
+			h5: {
+				color: "#404040",
+				fontFamily: "Calibri",
+				fontSize: 12,
+				fontWeight: "bold",
+				lineHeight: 1.35,
+				marginBottom: 5,
+				marginTop: 10
+			},
+			h6: {
+				color: "#666666",
+				fontFamily: "Calibri",
+				fontSize: 11,
+				fontWeight: "bold",
+				lineHeight: 1.35,
+				marginBottom: 4,
+				marginTop: 8
+			},
+			p: {
+				fontFamily: "Calibri",
+				fontSize: 11,
+				lineHeight: 1.5,
+				marginBottom: 8,
+				marginTop: 0
+			}
+		}
+	},
+	description: "Clean business style with Calibri, blue accent headings, and generous spacing."
+};
+//#endregion
+//#region src/presets/index.ts
+/**
+* Style presets — reusable `DocxKitConfig` fragments for instant styling.
+*
+* Three built-in presets are provided:
+* - **Classic** — Formal official-document style (SimHei / SimSun)
+* - **Modern** — Clean business style with blue accents (Calibri)
+* - **Academic** — Formal thesis / paper style (Times New Roman)
+*
+* ## Usage
+*
+* ```ts
+* import { createDocx, modernPreset } from 'docx-kit'
+*
+* // Spread a preset into createDocx — user config wins on conflict
+* const doc = createDocx({
+*   ...modernPreset.config,
+*   metadata: { title: 'Quarterly Report' },
+* })
+* ```
+*
+* Or use `usePreset()` for lookup by ID:
+*
+* ```ts
+* import { usePreset } from 'docx-kit'
+*
+* const preset = usePreset('modern')
+* const doc = createDocx(preset!.config)
+* ```
+*
+* @module presets
+*/
+/** 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.
+*
+* @param id - — Preset identifier (`"classic"`, `"modern"`, or `"academic"`)
+* @returns The matching preset, or `undefined` if not found
+*
+* @example
+* ```ts
+* const preset = usePreset('modern')
+* const doc = createDocx(preset!.config)
+* ```
+*/
+function usePreset(id) {
+	return BUILTIN_PRESETS.get(id);
+}
+//#endregion
+//#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 { DocxBuilder, DocxKitError, ERROR_CODES, PRESET_LIST, academicPreset, calloutPlugin, classicPreset, codeBlockPlugin, coverPagePlugin, createDocx, dataTablePlugin, dataUrlToUint8Array, definePlugin, defineStyles, echartsPlugin, meetingMinutesPlugin, modernPreset, pageNumberPlugin, propertyTablePlugin, qrcodePlugin, renderDocx, saveDocument, signatureBlockPlugin, timelinePlugin, usePreset, watermarkPlugin };