ooxml-core 1.13.0 → 1.15.0

package/dist/digest/index.mjs

@@ -1759,9 +1759,21 @@ function digestSync(name, data) {
   return digestFunction(name)?.(data);
 }
 
+// digest/timing-safe.ts
+function timingSafeEqual(a, b) {
+  if (a.length !== b.length) return false;
+  let difference = 0;
+  for (let i2 = 0; i2 < a.length; i2++) difference |= a[i2] ^ b[i2];
+  return difference === 0;
+}
+
 // digest/password-hash.ts
 var MAX_SPIN_COUNT = 1e7;
-var validSpinCount = (spinCount) => spinCount === void 0 || Number.isInteger(spinCount) && spinCount >= 0 && spinCount <= MAX_SPIN_COUNT;
+var DEFAULT_MAX_SPIN_COUNT = 1e6;
+function isValidSpinCount(spinCount, maxSpinCount = DEFAULT_MAX_SPIN_COUNT) {
+  const limit = Math.min(maxSpinCount, MAX_SPIN_COUNT);
+  return spinCount === void 0 || Number.isInteger(spinCount) && spinCount >= 0 && spinCount <= limit;
+}
 function spinPasswordHash(password, salt, spinCount, digest) {
   const input = new Uint8Array(salt.length + password.length * 2);
   input.set(salt);
@@ -1780,24 +1792,21 @@ function spinPasswordHash(password, salt, spinCount, digest) {
   }
   return value;
 }
-function hashBytes(password, { algorithmName, saltValue, spinCount }) {
+function hashBytes(password, { algorithmName, saltValue, spinCount }, limits) {
   const digest = digestFunction(algorithmName);
   const salt = decodeBase64(saltValue);
-  if (!digest || !salt || !validSpinCount(spinCount)) return void 0;
+  if (!digest || !salt || !isValidSpinCount(spinCount, limits.maxSpinCount)) return void 0;
   return spinPasswordHash(password, salt, spinCount ?? 0, digest);
 }
-function hashPassword(password, options) {
-  const bytes = hashBytes(password, options);
+function hashPassword(password, options, limits = {}) {
+  const bytes = hashBytes(password, options, limits);
   return bytes && encodeBase64(bytes);
 }
-function verifyPasswordHash(password, hash) {
+function verifyPasswordHash(password, hash, limits = {}) {
   if (!digestFunction(hash.algorithmName)) return void 0;
   const expected = decodeBase64(hash.hashValue);
-  const actual = expected && hashBytes(password, hash);
-  if (!expected || !actual || actual.length !== expected.length) return false;
-  let difference = 0;
-  for (let i2 = 0; i2 < actual.length; i2++) difference |= actual[i2] ^ expected[i2];
-  return difference === 0;
+  const actual = expected && hashBytes(password, hash, limits);
+  return !!expected && !!actual && timingSafeEqual(actual, expected);
 }
 
-export { MAX_SPIN_COUNT, decodeBase64, digestFunction, digestSync, encodeBase64, hashPassword, md2, md4, md5, normalizeDigestAlgorithmName, ripemd128, ripemd160, sha1, sha256, sha384, sha512, spinPasswordHash, verifyPasswordHash, whirlpool };
+export { DEFAULT_MAX_SPIN_COUNT, MAX_SPIN_COUNT, decodeBase64, digestFunction, digestSync, encodeBase64, hashPassword, isValidSpinCount, md2, md4, md5, normalizeDigestAlgorithmName, ripemd128, ripemd160, sha1, sha256, sha384, sha512, spinPasswordHash, timingSafeEqual, verifyPasswordHash, whirlpool };

package/dist/digest/password-hash.d.ts

@@ -11,10 +11,24 @@ export interface PasswordHash {
     spinCount?: number;
 }
 /**
- * The largest `spinCount` honoured. Excel writes 100,000; anything far beyond that is a
- * malformed or hostile file, and hashing it would freeze the thread.
+ * The hard ceiling of `spinCount` the spec allows (10,000,000). A caller may raise its limit up
+ * to this value with the `maxSpinCount` option; nothing above it is ever honoured.
  */
 export declare const MAX_SPIN_COUNT = 10000000;
+/**
+ * The `spinCount` limit applied by default to untrusted files. Office writes 100,000 and real
+ * files never approach 1,000,000; the spin is synchronous, so a hostile file naming 10,000,000
+ * rounds would freeze the thread for seconds. Pass `maxSpinCount` (at most {@link MAX_SPIN_COUNT})
+ * to accept more.
+ */
+export declare const DEFAULT_MAX_SPIN_COUNT = 1000000;
+/** Limits a caller may relax for a trusted file. */
+export interface SpinLimits {
+    /** The largest accepted spin count (default {@link DEFAULT_MAX_SPIN_COUNT}, at most {@link MAX_SPIN_COUNT}). */
+    maxSpinCount?: number;
+}
+/** Whether `spinCount` is an integer from 0 up to the effective limit (absent counts as 0). */
+export declare function isValidSpinCount(spinCount: number | undefined, maxSpinCount?: number): boolean;
 /**
  * The ECMA-376 / [MS-OFFCRYPTO] 2.3.7.1 password spin: H(salt + password as UTF-16LE), then
  * `spinCount` rounds of H(previous + round as uint32 LE). `salt` may be empty (a salt-less
@@ -25,13 +39,13 @@ export declare function spinPasswordHash(password: string, salt: Uint8Array, spi
  * The base64 ECMA-376 agile hash of `password` for the given salt, spin count and digest, as
  * Excel, Word and PowerPoint store it. `undefined` when the digest is not one {@link digestSync}
  * computes, the salt is not base64, or the spin count is negative, fractional, non-finite or
- * above {@link MAX_SPIN_COUNT}.
+ * above the limit ({@link DEFAULT_MAX_SPIN_COUNT} unless `limits.maxSpinCount` raises it).
  */
-export declare function hashPassword(password: string, options: Omit<PasswordHash, 'hashValue'>): string | undefined;
+export declare function hashPassword(password: string, options: Omit<PasswordHash, 'hashValue'>, limits?: SpinLimits): string | undefined;
 /**
  * Whether `password` matches `hash`, comparing decoded bytes (so white space or missing base64
  * padding in the file does not matter). `undefined` when the digest is not one this module
  * computes; `false` (never a throw) for a malformed salt, hash or spin count.
  */
-export declare function verifyPasswordHash(password: string, hash: PasswordHash): boolean | undefined;
+export declare function verifyPasswordHash(password: string, hash: PasswordHash, limits?: SpinLimits): boolean | undefined;
 //# sourceMappingURL=password-hash.d.ts.map

package/dist/digest/password-hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"password-hash.d.ts","sourceRoot":"","sources":["../../digest/password-hash.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,WAAa,CAAC;AAMzC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACpB,UAAU,CAiBZ;AAaD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GACtC,MAAM,GAAG,SAAS,CAGpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,CAQ5F"}
+{"version":3,"file":"password-hash.d.ts","sourceRoot":"","sources":["../../digest/password-hash.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,WAAa,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,UAAY,CAAC;AAEhD,oDAAoD;AACpD,MAAM,WAAW,UAAU;IAC1B,gHAAgH;IAChH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,GAAE,MAA+B,GAC3C,OAAO,CAKT;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACpB,UAAU,CAiBZ;AAcD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EACxC,MAAM,GAAE,UAAe,GACrB,MAAM,GAAG,SAAS,CAGpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,EAClB,MAAM,GAAE,UAAe,GACrB,OAAO,GAAG,SAAS,CAKrB"}

package/dist/digest/timing-safe.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Constant-time byte comparison for password verifiers, MACs and digests. A length mismatch
+ * fails at once (lengths are not secret); equal-length inputs are always scanned in full, so
+ * the running time does not reveal how many leading bytes matched.
+ */
+export declare function timingSafeEqual(a: Uint8Array, b: Uint8Array): boolean;
+//# sourceMappingURL=timing-safe.d.ts.map

package/dist/digest/timing-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing-safe.d.ts","sourceRoot":"","sources":["../../digest/timing-safe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAKrE"}

package/dist/docx/block-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-parser.d.ts","sourceRoot":"","sources":["../../docx/block-parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAY,KAAK,EAAW,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAwD,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAM9F,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAG9D,OAAO,EAAyC,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAwI/F,iBAAS,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAqF7F;AAED,iBAAS,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAIrF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,UAAU,EACrB,QAAQ,SAAK,EACb,OAAO,CAAC,EAAE,cAAc,GACtB,KAAK,EAAE,CAcT;AAaD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"block-parser.d.ts","sourceRoot":"","sources":["../../docx/block-parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAY,KAAK,EAAW,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAwD,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAM9F,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAG9D,OAAO,EAAyC,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAyI/F,iBAAS,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAiG7F;AAED,iBAAS,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAIrF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,UAAU,EACrB,QAAQ,SAAK,EACb,OAAO,CAAC,EAAE,cAAc,GACtB,KAAK,EAAE,CAcT;AAgBD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC"}

package/dist/docx/chart-paint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-paint.d.ts","sourceRoot":"","sources":["../../docx/chart-paint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;CACd;AAED,sEAAsE;AACtE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,gBAAgB,CAQzF;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAC7B,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,YAAY,GAClB,cAAc,CAsBhB"}
+{"version":3,"file":"chart-paint.d.ts","sourceRoot":"","sources":["../../docx/chart-paint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;CACd;AAED,sEAAsE;AACtE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,gBAAgB,CAQzF;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAC7B,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,YAAY,GAClB,cAAc,CAyBhB"}

package/dist/docx/chart.d.ts

@@ -1,9 +1,11 @@
-import { type ChartParseIssue, type ChartSpace, type ChartStyleDefinition } from '../chart/index.js';
+import { type ChartParseIssue, type ChartSpace, type ChartStyleDefinition, type ChartSummary } from '../chart/index.js';
 import type { Block } from './model.js';
 import type { Relationship } from './package-parts.js';
 import { type XmlElement } from './xml.js';
 /** The `a:graphicData/@uri` of a chart. */
 export declare const CHART_GRAPHIC_URI = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+/** The `a:graphicData/@uri` of an extended chart (waterfall, histogram...). */
+export declare const CHARTEX_GRAPHIC_URI = "http://schemas.microsoft.com/office/drawing/2014/chartex";
 /** A chart (`c:chart` in a `w:drawing`). The chart part is read-only and preserved on save. */
 export interface DocxChart {
     /** `inline` (`wp:inline`) or `anchor` (`wp:anchor`, floating). */
@@ -17,6 +19,12 @@ export interface DocxChart {
     partName?: string;
     /** The parsed chart part (`c:chartSpace`); absent when the part could not be read. */
     chartSpace?: ChartSpace;
+    /**
+     * An extended chart (`cx:chartSpace`): `layoutId` names its family and `chartEx` is the summary
+     * of the families the painter draws (waterfall, histogram, treemap, sunburst). `chartSpace` is absent for these.
+     */
+    layoutId?: string;
+    chartEx?: ChartSummary;
     /** Direct formatting read from the chart part (`readChartFormatting`), for painting. */
     formatting?: ChartStyleDefinition;
     /** The Office colour style id of the part's `chartColorStyle` relationship, when present. */
@@ -31,7 +39,7 @@ export interface DocxChart {
     issues: ChartParseIssue[];
 }
 /** The honest status shown with every chart. */
-export declare const CHART_NOTICE = "The chart is drawn from the values cached in its part (bar, column, line, area, pie, doughnut, scatter and radar charts; other kinds show a labelled frame). It is not editable, and the chart part and its workbook are preserved unchanged on save.";
+export declare const CHART_NOTICE = "The chart is drawn from the values cached in its part (bar, column, line, area, pie, doughnut, scatter, bubble, stock and radar charts, bar and line combinations with a secondary axis, waterfalls, histograms, treemaps and sunbursts; other kinds show a labelled frame). It is not editable, and the chart part and its workbook are preserved unchanged on save.";
 /** Reads the host side of a chart graphic. Synchronous: resolves the relationship, reads no part. */
 export declare function parseChartGraphic(graphicData: XmlElement, docPr: XmlElement | undefined, rels: ReadonlyMap<string, Relationship>, isAnchor: boolean): DocxChart;
 /** Reads the chart part (and its relationships) into the model. Never throws; problems go to `issues`. */

package/dist/docx/chart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../docx/chart.ts"],"names":[],"mappings":"AAMA,OAAO,EAIN,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAEzD,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,2DAA2D,CAAC;AAM1F,+FAA+F;AAC/F,MAAM,WAAW,SAAS;IACzB,kEAAkE;IAClE,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,wFAAwF;IACxF,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,kGAAkG;IAClG,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,gDAAgD;AAChD,eAAO,MAAM,YAAY,0PAC+N,CAAC;AAEzP,qGAAqG;AACrG,wBAAgB,iBAAiB,CAChC,WAAW,EAAE,UAAU,EACvB,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,EACvC,QAAQ,EAAE,OAAO,GACf,SAAS,CAqCX;AAED,0GAA0G;AAC1G,wBAAsB,gBAAgB,CACrC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,CAMrD;AAED,oGAAoG;AACpG,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAEf"}
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../docx/chart.ts"],"names":[],"mappings":"AAMA,OAAO,EAKN,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAEzD,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,2DAA2D,CAAC;AAC1F,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,6DAA6D,CAAC;AAO9F,+FAA+F;AAC/F,MAAM,WAAW,SAAS;IACzB,kEAAkE;IAClE,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,wFAAwF;IACxF,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,kGAAkG;IAClG,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,gDAAgD;AAChD,eAAO,MAAM,YAAY,0WAC+U,CAAC;AAEzW,qGAAqG;AACrG,wBAAgB,iBAAiB,CAChC,WAAW,EAAE,UAAU,EACvB,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,EACvC,QAAQ,EAAE,OAAO,GACf,SAAS,CAqCX;AAED,0GAA0G;AAC1G,wBAAsB,gBAAgB,CACrC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,CAMrD;AAED,oGAAoG;AACpG,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/docx/content-control-edit.d.ts

@@ -0,0 +1,26 @@
+import { type ContentControl } from './content-control-model.js';
+/** A control's new state and the text (with an optional font) its content should now show. */
+export interface ControlChange {
+    control: ContentControl;
+    text: string;
+    font?: string;
+}
+/** Whether the user may type in, toggle or pick for this control. */
+export declare const canEditControlContent: (control: ContentControl | undefined) => boolean;
+/** Whether the control itself may be deleted (with its content). */
+export declare const canDeleteControl: (control: ContentControl | undefined) => boolean;
+export declare function checkboxState(control: ContentControl, checked: boolean): ControlChange;
+export declare const toggleCheckbox: (control: ContentControl) => ControlChange;
+/** Choosing entry `index` of a drop-down list or combo box. */
+export declare function selectListItem(control: ContentControl, index: number): ControlChange | undefined;
+/** The date the control holds, from `w:fullDate`. */
+export declare function controlDate(control: ContentControl): Date | undefined;
+/** `w:fullDate` for a calendar day: local midnight written as UTC-less ISO, as Word does. */
+export declare const fullDateOf: (date: Date) => string;
+/** Choosing `date` in the calendar: shown with the control's date format. */
+export declare function setControlDate(control: ContentControl, date: Date): ControlChange;
+/** The placeholder text Word shows for an empty control of this kind. */
+export declare function defaultPlaceholder(control: ContentControl): string;
+/** Typed text replaces a placeholder: the control no longer shows one. */
+export declare function withValue(control: ContentControl): ContentControl;
+//# sourceMappingURL=content-control-edit.d.ts.map

package/dist/docx/content-control-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-control-edit.d.ts","sourceRoot":"","sources":["../../docx/content-control-edit.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEtF,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAQD,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,YAAa,cAAc,GAAG,SAAS,KAAG,OAChC,CAAC;AAC7C,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,YAAa,cAAc,GAAG,SAAS,KAAG,OAC3B,CAAC;AAE7C,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAStF;AAED,eAAO,MAAM,cAAc,YAAa,cAAc,KAAG,aAChB,CAAC;AAE1C,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAKhG;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,CAKrE;AAED,6FAA6F;AAC7F,eAAO,MAAM,UAAU,SAAU,IAAI,KAAG,MAC8G,CAAC;AAEvJ,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,GAAG,aAAa,CAMjF;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAYlE;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAGjE"}

package/dist/docx/content-control-model.d.ts

@@ -0,0 +1,51 @@
+export type ContentControlKind = 'richText' | 'text' | 'checkbox' | 'dropDownList' | 'comboBox' | 'date' | 'picture' | 'group' | 'equation' | 'citation' | 'bibliography' | 'docPartObj' | 'docPartList' | 'repeatingSection' | 'unknown';
+/** Where the `w:sdt` sits: around runs, around paragraphs/tables, around a row, or around a cell. */
+export type ContentControlLevel = 'inline' | 'block' | 'row' | 'cell';
+/** `w:lock`: `sdtLocked` cannot be deleted, `contentLocked` cannot be edited, both together. */
+export type ContentControlLock = 'sdtLocked' | 'contentLocked' | 'sdtContentLocked';
+export interface ContentControlListItem {
+    display: string;
+    value: string;
+}
+/** A checkbox state glyph (`w14:checkedState`/`w14:uncheckedState`): a hex code point and font. */
+export interface ContentControlGlyph {
+    /** Hexadecimal code point, e.g. `2612`. */
+    code: string;
+    font?: string;
+}
+export interface ContentControl {
+    /** `w:sdtPr/w:id`, or a generated id when the file has none. Shared by every run in the control. */
+    id: string;
+    level: ContentControlLevel;
+    kind: ContentControlKind;
+    /** `w:alias`, the title Word shows on the control's tab. */
+    alias?: string;
+    /** `w:tag`. */
+    tag?: string;
+    lock?: ContentControlLock;
+    /** `w:showingPlcHdr`: the content is the placeholder, not a value. */
+    showingPlaceholder?: boolean;
+    /** `w:text/@w:multiLine`. */
+    multiLine?: boolean;
+    /** `w14:checkbox/w14:checked`. */
+    checked?: boolean;
+    checkedGlyph?: ContentControlGlyph;
+    uncheckedGlyph?: ContentControlGlyph;
+    /** `w:dropDownList`/`w:comboBox` `w:listItem` entries, in order. */
+    items?: ContentControlListItem[];
+    /** `w:date/w:dateFormat`, a Word date picture such as `dd MMMM yyyy`. */
+    dateFormat?: string;
+    /** `w:date/w:lid`, a language tag such as `en-US`. */
+    dateLocale?: string;
+    /** `w:date/@w:fullDate`, an ISO date-time. */
+    fullDate?: string;
+    /** The control carries `w:dataBinding`: kept verbatim, its custom XML part is not synchronized. */
+    dataBound?: boolean;
+    /** `w:temporary`: Word removes the control once the user edits it. */
+    temporary?: boolean;
+    /** Verbatim `w:sdtPr`, used to recreate the control and to keep what is not modeled. */
+    sourceXml?: string;
+}
+/** A content control surrounding a row or cell is read and preserved; the model keeps its fields. */
+export declare const isContentControlLocked: (control: ContentControl | undefined, scope: 'content' | 'control') => boolean;
+//# sourceMappingURL=content-control-model.d.ts.map

package/dist/docx/content-control-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-control-model.d.ts","sourceRoot":"","sources":["../../docx/content-control-model.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAC3B,UAAU,GACV,MAAM,GACN,UAAU,GACV,cAAc,GACd,UAAU,GACV,MAAM,GACN,SAAS,GACT,OAAO,GACP,UAAU,GACV,UAAU,GACV,cAAc,GACd,YAAY,GACZ,aAAa,GACb,kBAAkB,GAClB,SAAS,CAAC;AAEb,qGAAqG;AACrG,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEtE,gGAAgG;AAChG,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAEpF,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,mGAAmG;AACnG,MAAM,WAAW,mBAAmB;IACnC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC9B,oGAAoG;IACpG,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,EAAE,kBAAkB,CAAC;IACzB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,oEAAoE;IACpE,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACjC,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qGAAqG;AACrG,eAAO,MAAM,sBAAsB,YACzB,cAAc,GAAG,SAAS,SAC5B,SAAS,GAAG,SAAS,KAC1B,OAKF,CAAC"}

package/dist/docx/content-control.d.ts

@@ -0,0 +1,9 @@
+import type { ContentControl, ContentControlLevel } from './content-control-model.js';
+import { type XmlElement } from './xml.js';
+export declare const WORD_2012_NS = "http://schemas.microsoft.com/office/word/2012/wordml";
+/** The direct `w:sdtContent` of a `w:sdt`. */
+export declare const sdtContent: (sdt: XmlElement) => XmlElement | undefined;
+export declare const isSdt: (element: XmlElement | null | undefined) => element is XmlElement;
+/** Reads `w:sdtPr` into the control model. `level` is where the `w:sdt` sits. */
+export declare function parseContentControl(sdt: XmlElement, level: ContentControlLevel): ContentControl;
+//# sourceMappingURL=content-control.d.ts.map

package/dist/docx/content-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-control.d.ts","sourceRoot":"","sources":["../../docx/content-control.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,cAAc,EAGd,mBAAmB,EAEnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAoD,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAG1F,eAAO,MAAM,YAAY,yDAAyD,CAAC;AAEnF,8CAA8C;AAC9C,eAAO,MAAM,UAAU,QAAS,UAAU,KAAG,UAAU,GAAG,SAAqC,CAAC;AAChG,eAAO,MAAM,KAAK,YAAa,UAAU,GAAG,IAAI,GAAG,SAAS,KAAG,OAAO,IAAI,UACpD,CAAC;AAyCvB,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAsD/F"}

package/dist/docx/default-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-styles.d.ts","sourceRoot":"","sources":["../../docx/default-styles.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA0B7C,kGAAkG;AAClG,eAAO,MAAM,kBAAkB,QAkBjB,CAAC;AAIf,+EAA+E;AAC/E,wBAAgB,oBAAoB,IAAI,QAAQ,CAC/C,IAAI,CAAC,aAAa,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,aAAa,CAAC,CAC1E,CAOA;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAS9D"}
+{"version":3,"file":"default-styles.d.ts","sourceRoot":"","sources":["../../docx/default-styles.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA0B7C,kGAAkG;AAClG,eAAO,MAAM,kBAAkB,QAmBjB,CAAC;AAIf,+EAA+E;AAC/E,wBAAgB,oBAAoB,IAAI,QAAQ,CAC/C,IAAI,CAAC,aAAa,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,aAAa,CAAC,CAC1E,CAOA;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAS9D"}

package/dist/docx/drawing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drawing.d.ts","sourceRoot":"","sources":["../../docx/drawing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,SAAS,CAAC;AAC7D,OAAO,EAGN,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAYzD,+CAA+C;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChC;AAqOD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,WAAW,CAInF"}
+{"version":3,"file":"drawing.d.ts","sourceRoot":"","sources":["../../docx/drawing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,SAAS,CAAC;AAC7D,OAAO,EAGN,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAYzD,+CAA+C;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChC;AAwOD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,WAAW,CAInF"}