docx-kit 0.2.0 → 0.3.0

package/dist/browser.js

@@ -1,2306 +1,65 @@
-import { n as dataUrlToUint8Array$1, t as createImageRun } from "./image-CdfLh9GO.js";
-import { n as ERROR_CODES, t as DocxKitError } from "./errors-c9CC63Ti.js";
-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-BuKdtuxB.js");
-		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-u3tMQYCL.js");
-		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-u3tMQYCL.js");
-		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-Vy7rz9_8.js");
-		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-u3tMQYCL.js");
-		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
+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
 /**
-* Meeting Minutes plugin — structured meeting notes with header, meta info,
-* and an agenda table.
+* Normalize image data for `ImageRun` — converts `Blob` to `Uint8Array`.
 *
-* Renders a title paragraph, a date/attendees summary line, and a 4-column
-* agenda table (Topic | Discussion | Decision | Owner).
+* In the browser, image data often arrives as a `Blob` (e.g. from
+* `<input type="file">` or `fetch()`). `ImageRun` expects raw bytes,
+* so we convert via `Blob.arrayBuffer()`.
 *
-* @module plugins/meeting-minutes
+* @param data - — The raw image data (Blob, Uint8Array, ArrayBuffer, string)
+* @returns Normalized data suitable for `ImageRun`
 *
 * @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
+* import { normalizeImageData } from 'docx-kit/browser'
 *
-* @example
-* ```ts
-* const doc = createDocx()
-*   .use(signatureBlockPlugin())
-*   .plugin('signatureBlock', {
-*     parties: [
-*       { label: '甲方（盖章）', date: '2026年  月  日' },
-*       { label: '乙方（盖章）', date: '2026年  月  日' },
-*     ],
-*     columns: 2,
-*   })
-*   .save('signature.docx')
+* const file = document.querySelector('input[type=file]').files[0]
+* const data = await normalizeImageData(file) // Blob → Uint8Array
 * ```
 */
-/**
-* 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
-				}
-			});
-		}
-	});
+async function normalizeImageData(data) {
+	if (typeof Blob !== "undefined" && data instanceof Blob) return new Uint8Array(await data.arrayBuffer());
+	return data;
 }
 //#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
+//#region src/browser.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'
+* docx-kit — Browser platform entry (default).
 *
-* // 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:
+* Re-exports all APIs from @docxkit/core plus built-in plugins,
+* presets, and themes. This is the default import target.
 *
-* ```ts
-* import { usePreset } from 'docx-kit'
-*
-* const preset = usePreset('modern')
-* const doc = createDocx(preset!.config)
-* ```
+* For Node.js–only APIs (filesystem save), import from 'docx-kit/node'.
 *
-* @module presets
+* @module docx-kit
+* @packageDocumentation
 */
 /** All built-in presets, keyed by ID. */
 const BUILTIN_PRESETS = new Map([
@@ -2314,73 +73,25 @@ const PRESET_LIST = [
 	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)
-* ```
-*/
+/** Look up a built-in preset by ID. */
 function usePreset(id) {
 	return BUILTIN_PRESETS.get(id);
 }
-//#endregion
-//#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
-* `<input type="file">` or `fetch()`). `ImageRun` expects raw bytes,
-* so we convert via `Blob.arrayBuffer()`.
-*
-* @param data - — The raw image data (Blob, Uint8Array, ArrayBuffer, string)
-* @returns Normalized data suitable for `ImageRun`
-*
-* @example
-* ```ts
-* import { normalizeImageData } from 'docx-kit/browser'
-*
-* const file = document.querySelector('input[type=file]').files[0]
-* const data = await normalizeImageData(file) // Blob → Uint8Array
-* ```
-*/
-async function normalizeImageData(data) {
-	if (typeof Blob !== "undefined" && data instanceof Blob) return new Uint8Array(await data.arrayBuffer());
-	return data;
+/** 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 { DocxBuilder, DocxKitError, ERROR_CODES, PRESET_LIST, academicPreset, calloutPlugin, classicPreset, codeBlockPlugin, coverPagePlugin, createDocx, dataTablePlugin, dataUrlToUint8Array, definePlugin, defineStyles, echartsPlugin, meetingMinutesPlugin, modernPreset, normalizeImageData, pageNumberPlugin, propertyTablePlugin, qrcodePlugin, renderDocx, signatureBlockPlugin, timelinePlugin, usePreset, watermarkPlugin };
+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 };