ooxml-core 1.19.2 → 1.21.0

package/README.md

@@ -72,6 +72,16 @@ SVG curve flattening is available from `geometry`. See the
 [PowerPoint reuse audit](../../docs/pptx-shared-logic-audit.md) for extraction evidence
 and remaining candidates.
 
+CSV import (`csvToWorkbook`, or `loadWorkbook(bytes, { csv })` from `ooxml-core/xlsx/load`)
+types fields the way typing them into a cell does, which approximates Excel opening a CSV: a
+number past 15 significant digits keeps the nearest double where Excel keeps the first 15
+digits, and General columns read numeric dates month first. It takes Excel's own controls to
+change that: the automatic data conversion switches (`conversions: { leadingZeros: false }`
+keeps `00123`), and the Text Import Wizard's column formats
+(`columns: { 0: 'text', 2: 'DMY', 5: 'skip' }`), decimal and thousands separators and trailing
+minus. Each column whose data a conversion changed gets one entry in `workbook.warnings`, with a
+count and the first cell.
+
 ## Install
 
 ```bash
@@ -99,11 +109,47 @@ import { PptxHandler } from 'ooxml-core/pptx';
 
 const { handler, data, createSlide } = await PptxHandler.create({ title: 'Quarterly Review' });
 data.slides.push(
-	createSlide().addText('Hello World', { x: 100, y: 100, width: 600, height: 80 }).build(),
+	createSlide('Title Slide')
+		.addPlaceholder('ctrTitle', 'Quarterly Review')
+		.addPlaceholder('subTitle', 'Results and next steps')
+		.build(),
 );
 const bytes = await handler.save(data.slides); // a valid .pptx
 ```
 
+`addPlaceholder(type, text, { idx? })` binds text to the selected layout and inherits
+its position, size, and text styles. Use `{ idx: 1 }` or `{ idx: 2 }` for repeated
+content slots in Two Content. Optional `x`, `y`, `width`, and `height` override the
+inherited frame. If a template's master frame needs a compatible-role fallback,
+only the newly created placeholder receives an explicit frame. A missing slot
+requires a complete explicit frame; otherwise the builder throws. Standalone `new SlideBuilder(number, layoutPath, name, handler)`
+requires a loaded handler for this method. Use `addText` for a free text box.
+
+**Open a very large workbook**
+
+```ts
+import { DEFAULT_XLSX_LOAD_LIMITS, isWorkbookTooLargeError, loadXlsx } from 'ooxml-core/xlsx';
+
+// The default limits guard against zip bombs; raise only what the expected files need.
+const workbook = await loadXlsx(bytes, {
+	limits: { maxTotalBytes: 4 * DEFAULT_XLSX_LOAD_LIMITS.maxTotalBytes, maxXmlElements: 20_000_000 },
+});
+// Over a limit, loading throws an error that isWorkbookTooLargeError(error) recognises (code
+// 'workbook-too-large'): `limit` names the limit and `maximum` is its value. loadWorkbook
+// ('ooxml-core/xlsx/load') takes `limits` too.
+```
+
+**Compare two versions of a workbook**
+
+```ts
+import { compareWorkbooks, comparisonText, loadXlsx } from 'ooxml-core/xlsx';
+
+const result = compareWorkbooks(await loadXlsx(v1), await loadXlsx(v2));
+console.log(comparisonText(result)); // values, formulas, formats, sheets, names
+```
+
+Cells are matched by address; see [workbook comparison](../../docs/xlsx-compare.md) for the categories and limits.
+
 **Work at the package level**
 
 ```ts

package/dist/{PptxHandler-6TNIQ7S5.cjs → PptxHandler-DNSXWTQV.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkR5FIHHGB_cjs = require('./chunk-R5FIHHGB.cjs');
-require('./chunk-NYTR4UZ5.cjs');
+var chunkHL3FBJ6X_cjs = require('./chunk-HL3FBJ6X.cjs');
+require('./chunk-4LZIUJI3.cjs');
 require('./chunk-XZPZHXV4.cjs');
 require('./chunk-5W2QL4SB.cjs');
 
@@ -9,5 +9,5 @@ require('./chunk-5W2QL4SB.cjs');
 
 Object.defineProperty(exports, "PptxHandler", {
   enumerable: true,
-  get: function () { return chunkR5FIHHGB_cjs.PptxHandler; }
+  get: function () { return chunkHL3FBJ6X_cjs.PptxHandler; }
 });

package/dist/{PptxHandler-2V4PQL6O.mjs → PptxHandler-FSKKPZZC.mjs}

@@ -1,6 +1,6 @@
-export { PptxHandler } from './chunk-4FTUAD2B.mjs';
-import './chunk-SLNQNVQM.mjs';
-import './chunk-M4XLF4R7.mjs';
+export { PptxHandler } from './chunk-Q5PKBQXH.mjs';
+import './chunk-4QPOJCJG.mjs';
+import './chunk-GBKBR4CX.mjs';
 import './chunk-3GXV5MPC.mjs';
 import './chunk-54S5A5PZ.mjs';
 import './chunk-KII4AAYH.mjs';

package/dist/PptxHandler-H7MEWJJJ.mjs

@@ -0,0 +1,4 @@
+export { PptxHandler } from './chunk-LF5E5ZOH.mjs';
+import './chunk-6IIMI5RS.mjs';
+import './chunk-GXHKNSZX.mjs';
+import './chunk-CA7KCNL3.mjs';

package/dist/{PresentationBuilder-G7MPEGXJ.mjs → PresentationBuilder-7TSENZTX.mjs}

@@ -1,4 +1,4 @@
-export { PresentationBuilder, STANDARD_LAYOUTS, buildBlankPresentationArchive } from './chunk-ZJ2OKIJN.mjs';
-import './chunk-XTSHZGSM.mjs';
+export { PresentationBuilder, STANDARD_LAYOUTS, buildBlankPresentationArchive } from './chunk-LF5E5ZOH.mjs';
+import './chunk-6IIMI5RS.mjs';
 import './chunk-GXHKNSZX.mjs';
 import './chunk-CA7KCNL3.mjs';

package/dist/{PresentationBuilder-RM52LCVN.cjs → PresentationBuilder-A5NI35VN.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkR5FIHHGB_cjs = require('./chunk-R5FIHHGB.cjs');
-require('./chunk-NYTR4UZ5.cjs');
+var chunkHL3FBJ6X_cjs = require('./chunk-HL3FBJ6X.cjs');
+require('./chunk-4LZIUJI3.cjs');
 require('./chunk-XZPZHXV4.cjs');
 require('./chunk-5W2QL4SB.cjs');
 
@@ -9,13 +9,13 @@ require('./chunk-5W2QL4SB.cjs');
 
 Object.defineProperty(exports, "PresentationBuilder", {
   enumerable: true,
-  get: function () { return chunkR5FIHHGB_cjs.PresentationBuilder; }
+  get: function () { return chunkHL3FBJ6X_cjs.PresentationBuilder; }
 });
 Object.defineProperty(exports, "STANDARD_LAYOUTS", {
   enumerable: true,
-  get: function () { return chunkR5FIHHGB_cjs.STANDARD_LAYOUTS; }
+  get: function () { return chunkHL3FBJ6X_cjs.STANDARD_LAYOUTS; }
 });
 Object.defineProperty(exports, "buildBlankPresentationArchive", {
   enumerable: true,
-  get: function () { return chunkR5FIHHGB_cjs.buildBlankPresentationArchive; }
+  get: function () { return chunkHL3FBJ6X_cjs.buildBlankPresentationArchive; }
 });

package/dist/{PresentationBuilder-HQ6C7L4V.mjs → PresentationBuilder-RIJWQSEU.mjs}

@@ -1,6 +1,6 @@
-export { PresentationBuilder, STANDARD_LAYOUTS, buildBlankPresentationArchive } from './chunk-4FTUAD2B.mjs';
-import './chunk-SLNQNVQM.mjs';
-import './chunk-M4XLF4R7.mjs';
+export { PresentationBuilder, STANDARD_LAYOUTS, buildBlankPresentationArchive } from './chunk-Q5PKBQXH.mjs';
+import './chunk-4QPOJCJG.mjs';
+import './chunk-GBKBR4CX.mjs';
 import './chunk-3GXV5MPC.mjs';
 import './chunk-54S5A5PZ.mjs';
 import './chunk-KII4AAYH.mjs';

package/dist/automation/docx-forms.d.ts

@@ -0,0 +1,26 @@
+import type { DocumentProtection } from '../docx/form-field-model.js';
+import { type FormFieldInfo } from '../docx/form-fill-fields.js';
+import type { FormFieldValue } from '../docx/form-fill-values.js';
+import { type FormFillOptions, type FormFillResult } from '../docx/form-fill-write.js';
+/** Headless form filling for Word documents, shared by MCP and other automation adapters. */
+export declare function listDocxFormFields(bytes: Uint8Array): Promise<{
+    fields: FormFieldInfo[];
+    /** `w:documentProtection`, when the document restricts editing (for example to forms). */
+    protection?: DocumentProtection;
+    warnings: string[];
+}>;
+export interface DocxFormFillOptions extends FormFillOptions {
+    /** Write the values that fit even when others are refused (by default nothing is written). */
+    partial?: boolean;
+}
+/**
+ * Sets form fields by the ids `listDocxFormFields` gives and returns the saved document. Values
+ * are checked against their fields; when one is refused nothing is written (unless `partial`),
+ * and the error lists every refusal. Parts the values do not reach are kept byte for byte.
+ */
+export declare function fillDocxFormFields(bytes: Uint8Array, values: Readonly<Record<string, FormFieldValue>>, options?: DocxFormFillOptions): Promise<{
+    bytes: Uint8Array;
+    results: FormFillResult[];
+    warnings: string[];
+}>;
+//# sourceMappingURL=docx-forms.d.ts.map

package/dist/automation/docx-forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-forms.d.ts","sourceRoot":"","sources":["../../automation/docx-forms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAkB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGpG,6FAA6F;AAC7F,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IACpE,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC,CAOD;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC3D,8FAA8F;IAC9F,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EAChD,OAAO,GAAE,mBAAwB,GAC/B,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAY/E"}