@office-open/core 0.10.12 → 0.10.13

package/dist/util-Tq9PSjK0.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"util-Tq9PSjK0.mjs","names":[],"sources":["../src/opc/output.ts","../src/opc/zip-native.ts","../src/opc/packer.ts","../src/util/compile.ts","../src/util/crypto.ts","../src/util/placeholder.ts","../src/util/values.ts"],"sourcesContent":["/**\n * Output type definitions for OOXML document export.\n *\n * @module\n */\n\nimport { strFromU8 } from \"fflate\";\n\nimport { encodeBase64 } from \"../util/base64\";\n\nexport interface OutputByType {\n  base64: string;\n  string: string;\n  text: string;\n  binarystring: string;\n  array: readonly number[];\n  uint8array: Uint8Array;\n  arraybuffer: ArrayBuffer;\n  blob: Blob;\n  nodebuffer: Buffer;\n}\n\nexport type OutputType = keyof OutputByType;\n\n/* V8 ignore start */\nexport const OoxmlMimeType = {\n  DOCX: \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n  PPTX: \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n  XLSX: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n} as const;\n\nexport const convertOutput = <T extends OutputType>(\n  data: Uint8Array,\n  type: T,\n  mimeType: string = OoxmlMimeType.DOCX,\n): OutputByType[T] => {\n  switch (type) {\n    case \"nodebuffer\":\n      // Zero-copy: wrap the zip output's underlying ArrayBuffer as a Buffer\n      // view instead of copying it (~11MB for an image-heavy file) on every\n      // generate(). Safe because the source buffer is freshly allocated and\n      // never mutated after this point.\n      return Buffer.from(data.buffer, data.byteOffset, data.byteLength) as OutputByType[T];\n    case \"blob\":\n      return new Blob(\n        [(data.buffer as ArrayBuffer).slice(data.byteOffset, data.byteOffset + data.byteLength)],\n        { type: mimeType },\n      ) as OutputByType[T];\n    case \"arraybuffer\":\n      return data.buffer.slice(\n        data.byteOffset,\n        data.byteOffset + data.byteLength,\n      ) as OutputByType[T];\n    case \"uint8array\":\n      return data as OutputByType[T];\n    case \"base64\":\n      return encodeBase64(data) as OutputByType[T];\n    case \"string\":\n    case \"text\":\n    case \"binarystring\":\n      return strFromU8(data, true) as OutputByType[T];\n    case \"array\":\n      return [...data] as unknown as OutputByType[T];\n    /* V8 ignore next */\n    default:\n      return data as unknown as OutputByType[T];\n  }\n};\n/* V8 ignore stop */\n","/**\n * Native ZIP reader/writer with automatic fallback to fflate.\n *\n * `node:zlib` resolves in Node and Bun (via its Node compat layer), giving\n * `deflateRawSync` / `inflateRawSync` for DEFLATE/INFLATE and `zlib.crc32`\n * for CRC-32 — ~2-3x faster than fflate's pure-JS implementation. Browsers\n * and Deno lack a resolvable `node:zlib`, so the dynamic import rejects and\n * packer.ts falls back to fflate. We probe via the import itself rather than\n * `process.versions.node`: core's `shims: true` swaps `process` for a browser\n * stub that drops `versions.node`, which would silently disable native zlib\n * in any package consuming core's polyfilled build.\n *\n * @module\n */\n\nimport type { Zippable, ZipOptions } from \"fflate\";\n\n// ── CRC-32 lookup table ──\n\nconst CRC_TABLE = new Int32Array(256);\nfor (let i = 0; i < 256; i++) {\n  let c = i;\n  for (let k = 0; k < 8; k++) c = c & 1 ? (c >>> 1) ^ -306674912 : c >>> 1;\n  CRC_TABLE[i] = c;\n}\n\nfunction computeCrc32(data: Uint8Array): number {\n  let crc = -1;\n  // CRC_TABLE is a fixed 256-entry lookup; the index is masked to [0,255], so the\n  // access is guaranteed in-bounds — the `!` is a compile-time narrow, not a runtime check.\n  for (const byte of data) {\n    crc = CRC_TABLE[(crc ^ byte) & 0xff]! ^ (crc >>> 8);\n  }\n  return ~crc;\n}\n\n// ── Native zlib detection (Node.js ESM) ──\n\ntype DeflateFn = (data: Uint8Array, level: number) => Uint8Array;\ntype AsyncDeflateFn = (data: Uint8Array, level: number) => Promise<Uint8Array>;\ntype InflateFn = (data: Uint8Array) => Uint8Array;\ntype Crc32Fn = (data: Uint8Array) => number;\n\nlet _nativeDeflate: DeflateFn | undefined;\nlet _nativeDeflateAsync: AsyncDeflateFn | undefined;\nlet _nativeInflate: InflateFn | undefined;\nlet _nativeCrc32: Crc32Fn | undefined;\n\n// `node:zlib` resolves in Node and Bun (via its Node compat layer); in\n// browsers and Deno the dynamic import rejects, so we fall back to fflate.\n// The import itself is the probe — do NOT gate on `process.versions.node`:\n// core's `shims: true` swaps `process` for a browser stub that drops\n// `versions.node`, which would silently disable native zlib in any package\n// that consumes core's polyfilled build.\ntry {\n  // top-level await — ESM standard. Resolves to zlib with deflateRawSync;\n  // rejects (or yields a stub without it) on incomplete polyfills.\n  const zlib = await import(\"node:zlib\");\n  if (typeof zlib.deflateRawSync !== \"function\") throw new Error(\"no native deflate\");\n  _nativeDeflate = (data: Uint8Array, level: number): Uint8Array =>\n    zlib.deflateRawSync(data, { level });\n  _nativeDeflateAsync = (data: Uint8Array, level: number): Promise<Uint8Array> =>\n    new Promise<Uint8Array>((resolve, reject) =>\n      zlib.deflateRaw(data, { level }, (err, result) => {\n        if (err) reject(err);\n        else resolve(result);\n      }),\n    );\n  _nativeCrc32 =\n    typeof zlib.crc32 === \"function\" ? (data: Uint8Array) => zlib.crc32(data) : computeCrc32;\n  // Inflate is optional (deflate presence doesn't guarantee it), so probe\n  // separately — nativeUnzip only becomes available when this resolves.\n  if (typeof zlib.inflateRawSync === \"function\") {\n    _nativeInflate = (data: Uint8Array): Uint8Array => zlib.inflateRawSync(data);\n  }\n} catch {\n  // Browser/Deno or Node-like runtime without usable zlib — fflate fallback\n}\n\nexport const hasNativeDeflate = (): boolean => _nativeDeflate !== undefined;\n\nexport const hasNativeInflate = (): boolean => _nativeInflate !== undefined;\n\n// ── LE write helpers ──\n\nfunction wU16(b: Uint8Array, o: number, v: number): void {\n  b[o] = v & 0xff;\n  b[o + 1] = (v >> 8) & 0xff;\n}\n\nfunction wU32(b: Uint8Array, o: number, v: number): void {\n  b[o] = v & 0xff;\n  b[o + 1] = (v >> 8) & 0xff;\n  b[o + 2] = (v >> 16) & 0xff;\n  b[o + 3] = (v >> 24) & 0xff;\n}\n\n// ── Per-entry metadata ──\n\ninterface Entry {\n  filename: Uint8Array;\n  data: Uint8Array;\n  uncompressedSize: number;\n  crc: number;\n  method: number; // 0 = STORE, 8 = DEFLATE\n  localOffset: number;\n}\n\n// ── Phase 1 helpers ──\n\nfunction resolveEntryData(\n  raw: Zippable[string],\n  defaultLevel: number,\n): { data: Uint8Array; level: number } {\n  if (Array.isArray(raw)) {\n    return { data: raw[0] as Uint8Array, level: (raw[1] as ZipOptions).level ?? defaultLevel };\n  }\n  return { data: raw as Uint8Array, level: defaultLevel };\n}\n\nfunction compressOne(\n  data: Uint8Array,\n  level: number,\n  deflate: DeflateFn,\n): { compressed: Uint8Array; method: number } {\n  if (level === 0) return { compressed: data, method: 0 };\n  const compressed = deflate(data, level);\n  if (compressed.length >= data.length) return { compressed: data, method: 0 };\n  return { compressed, method: 8 };\n}\n\nasync function compressOneAsync(\n  data: Uint8Array,\n  level: number,\n  deflate: AsyncDeflateFn,\n): Promise<{ compressed: Uint8Array; method: number }> {\n  if (level === 0) return { compressed: data, method: 0 };\n  const compressed = await deflate(data, level);\n  if (compressed.length >= data.length) return { compressed: data, method: 0 };\n  return { compressed, method: 8 };\n}\n\n// ── Phase 2+3: calculate sizes + write ZIP buffer ──\n\nfunction writeZipBuffer(entries: Entry[]): Uint8Array {\n  let totalSize = 0;\n  for (const e of entries) {\n    totalSize += 30 + e.filename.length + e.data.length;\n  }\n  const cdOffset = totalSize;\n  let cdSize = 0;\n  for (const e of entries) {\n    cdSize += 46 + e.filename.length;\n  }\n  totalSize += cdSize + 22;\n\n  const buf = new Uint8Array(totalSize);\n  let offset = 0;\n\n  // Local file headers + data\n  for (const e of entries) {\n    e.localOffset = offset;\n    wU32(buf, offset, 0x04034b50); // signature\n    wU16(buf, offset + 4, 20); // version needed\n    wU16(buf, offset + 6, 0); // flags\n    wU16(buf, offset + 8, e.method); // compression method\n    wU16(buf, offset + 10, 0); // mod time\n    wU16(buf, offset + 12, 0); // mod date\n    wU32(buf, offset + 14, e.crc);\n    wU32(buf, offset + 18, e.data.length); // compressed size\n    wU32(buf, offset + 22, e.uncompressedSize);\n    wU16(buf, offset + 26, e.filename.length);\n    wU16(buf, offset + 28, 0); // extra field length\n    offset += 30;\n\n    buf.set(e.filename, offset);\n    offset += e.filename.length;\n\n    buf.set(e.data, offset);\n    offset += e.data.length;\n  }\n\n  // Central directory\n  for (const e of entries) {\n    wU32(buf, offset, 0x02014b50); // signature\n    wU16(buf, offset + 4, 20); // version made by\n    wU16(buf, offset + 6, 20); // version needed\n    wU16(buf, offset + 8, 0); // flags\n    wU16(buf, offset + 10, e.method);\n    wU16(buf, offset + 12, 0); // mod time\n    wU16(buf, offset + 14, 0); // mod date\n    wU32(buf, offset + 16, e.crc);\n    wU32(buf, offset + 20, e.data.length);\n    wU32(buf, offset + 24, e.uncompressedSize);\n    wU16(buf, offset + 28, e.filename.length);\n    wU16(buf, offset + 30, 0); // extra field length\n    wU16(buf, offset + 32, 0); // comment length\n    wU16(buf, offset + 34, 0); // disk number start\n    wU16(buf, offset + 36, 0); // internal attrs\n    wU32(buf, offset + 38, 0); // external attrs\n    wU32(buf, offset + 42, e.localOffset);\n    offset += 46;\n\n    buf.set(e.filename, offset);\n    offset += e.filename.length;\n  }\n\n  // End of Central Directory Record\n  wU32(buf, offset, 0x06054b50);\n  wU16(buf, offset + 4, 0); // disk number\n  wU16(buf, offset + 6, 0); // CD disk\n  wU16(buf, offset + 8, entries.length);\n  wU16(buf, offset + 10, entries.length);\n  wU32(buf, offset + 12, cdSize);\n  wU32(buf, offset + 16, cdOffset);\n  wU16(buf, offset + 20, 0); // comment length\n\n  return buf;\n}\n\n// ── Public API ──\n\nconst textEncoder = new TextEncoder();\nconst textDecoder = new TextDecoder();\n\nexport function nativeZip(files: Zippable, level: number = 6): Uint8Array {\n  if (!_nativeDeflate) throw new Error(\"Native deflate not available\");\n  const crc = _nativeCrc32 ?? computeCrc32;\n  const entries: Entry[] = [];\n\n  for (const key of Object.keys(files)) {\n    const raw = files[key];\n    if (raw === undefined) continue; // Object.keys guarantees presence; guard narrows the type\n    const { data, level: entryLevel } = resolveEntryData(raw, level);\n    const c = crc(data);\n    const { compressed, method } = compressOne(data, entryLevel, _nativeDeflate);\n    entries.push({\n      filename: textEncoder.encode(key),\n      data: compressed,\n      uncompressedSize: data.length,\n      crc: c,\n      method,\n      localOffset: 0,\n    });\n  }\n\n  return writeZipBuffer(entries);\n}\n\nexport async function nativeZipAsync(files: Zippable, level: number = 6): Promise<Uint8Array> {\n  if (!_nativeDeflateAsync) throw new Error(\"Native async deflate not available\");\n  const crc = _nativeCrc32 ?? computeCrc32;\n  const entries: Entry[] = [];\n\n  for (const key of Object.keys(files)) {\n    const raw = files[key];\n    if (raw === undefined) continue; // Object.keys guarantees presence; guard narrows the type\n    const { data, level: entryLevel } = resolveEntryData(raw, level);\n    const c = crc(data);\n    const { compressed, method } = await compressOneAsync(data, entryLevel, _nativeDeflateAsync);\n    entries.push({\n      filename: textEncoder.encode(key),\n      data: compressed,\n      uncompressedSize: data.length,\n      crc: c,\n      method,\n      localOffset: 0,\n    });\n  }\n\n  return writeZipBuffer(entries);\n}\n\n// ── LE read helpers (ZIP parsing) ──\n\nfunction rU16(b: Uint8Array, o: number): number {\n  return b[o]! | (b[o + 1]! << 8);\n}\n\nfunction rU32(b: Uint8Array, o: number): number {\n  return (b[o]! | (b[o + 1]! << 8) | (b[o + 2]! << 16) | (b[o + 3]! << 24)) >>> 0;\n}\n\n// ── ZIP central-directory parsing ──\n\nconst EOCD_MAGIC = 0x06054b50;\nconst CD_MAGIC = 0x02014b50;\n\ninterface ZipEntryMeta {\n  name: string;\n  method: number;\n  compSize: number;\n  crc: number;\n  dataStart: number;\n}\n\n/** Locate the End-of-Central-Directory record (within a 64 KB comment window). */\nfunction findEocd(b: Uint8Array): number {\n  const min = Math.max(0, b.length - 65557); // 22-byte EOCD + up to 65535-byte comment\n  for (let i = b.length - 22; i >= min; i--) {\n    if (rU32(b, i) === EOCD_MAGIC) return i;\n  }\n  throw new Error(\"ZIP EOCD record not found\");\n}\n\n/** Walk the central directory and resolve each entry's payload offset. */\nfunction readCentralDirectory(buf: Uint8Array): ZipEntryMeta[] {\n  const eocd = findEocd(buf);\n  const count = rU16(buf, eocd + 10);\n  const cdOffset = rU32(buf, eocd + 16);\n  const entries: ZipEntryMeta[] = [];\n  let p = cdOffset;\n  for (let i = 0; i < count; i++) {\n    if (rU32(buf, p) !== CD_MAGIC) throw new Error(`ZIP central directory corrupt at offset ${p}`);\n    const method = rU16(buf, p + 10);\n    const crc = rU32(buf, p + 16);\n    const compSize = rU32(buf, p + 20);\n    const nameLen = rU16(buf, p + 28);\n    const extraLen = rU16(buf, p + 30);\n    const cmtLen = rU16(buf, p + 32);\n    const localOff = rU32(buf, p + 42);\n    // Uint8Array.toString() yields \"120,46,...\" (comma-joined bytes), not the\n    // UTF-8 string — decode explicitly so entry names are real paths.\n    const name = textDecoder.decode(buf.subarray(p + 46, p + 46 + nameLen));\n    // The local header carries its own name/extra lengths, which can differ\n    // from the CD's; read them to locate the entry's payload precisely.\n    const lNameLen = rU16(buf, localOff + 26);\n    const lExtraLen = rU16(buf, localOff + 28);\n    entries.push({\n      name,\n      method,\n      compSize,\n      crc,\n      dataStart: localOff + 30 + lNameLen + lExtraLen,\n    });\n    p += 46 + nameLen + extraLen + cmtLen;\n  }\n  return entries;\n}\n\n/**\n * Decompress a ZIP archive via `node:zlib` `inflateRawSync`, mirroring fflate's\n * `unzipSync` signature and CRC-32 integrity check. Node/Bun only — callers\n * gate on {@link hasNativeInflate} and fall back to fflate `unzipSync` elsewhere.\n * Measured ~2x faster than fflate on large OOXML packages.\n */\nexport function nativeUnzip(buf: Uint8Array): Record<string, Uint8Array> {\n  if (!_nativeInflate) throw new Error(\"Native inflate not available\");\n  const inflate = _nativeInflate;\n  const crc = _nativeCrc32 ?? computeCrc32;\n  const out: Record<string, Uint8Array> = {};\n  for (const e of readCentralDirectory(buf)) {\n    const raw = buf.subarray(e.dataStart, e.dataStart + e.compSize);\n    const dec = e.method === 0 ? raw.slice() : inflate(raw);\n    // >>> 0 normalizes the signed CRC_TABLE accumulation against zlib's unsigned crc32.\n    if (crc(dec) >>> 0 !== e.crc) throw new Error(`ZIP CRC-32 mismatch: ${e.name}`);\n    out[e.name] = dec;\n  }\n  return out;\n}\n","/**\n * Shared packer utilities for OOXML document generation.\n *\n * @module\n */\n\nimport {\n  type AsyncZippable,\n  type ZipOptions,\n  type Zippable,\n  AsyncZipDeflate,\n  Zip,\n  ZipPassThrough,\n  zip,\n  zipSync,\n} from \"fflate\";\n\nimport { convertOutput } from \"./output\";\nimport type { OutputByType, OutputType } from \"./output\";\nimport { hasNativeDeflate, nativeZip, nativeZipAsync } from \"./zip-native\";\n\nexport type { Zippable, ZipOptions } from \"fflate\";\nexport { strFromU8, unzipSync } from \"fflate\";\n\nexport interface XmlifyedFile {\n  path: string;\n  data: string | Uint8Array;\n}\n\n/** Default DEFLATE level for XML entries (SuperFast, matching MS Office). */\nexport const ZIP_DEFLATE_LEVEL = 1;\n\n/** Default DEFLATE level for compressible media (EMF/WMF/BMP/TIFF/SVG). MS\n *  Office uses CompressionOption.Normal (~zlib 6); SuperFast (1) inflates EMF\n *  output ~15% (measured against a real Office-generated package). */\nexport const ZIP_MEDIA_LEVEL = 6;\n\n/** Level for already-compressed media — STORE (no compression). */\nexport const ZIP_STORED_LEVEL = 0;\n\n/**\n * Media formats already compressed internally (DEFLATE for PNG, DCT for JPEG,\n * LZW for GIF). Re-compressing via zip DEFLATE wastes CPU and often inflates\n * the data, so MS Office STORE-s these (CompressionOption.NotCompressed → zip\n * method 0). Everything else (EMF/WMF/BMP/TIFF/SVG/…) is compressible → DEFLATE.\n */\nconst PRECOMPRESSED_MEDIA_EXT = new Set([\"jpg\", \"jpeg\", \"png\", \"gif\"]);\n\n/**\n * Resolve the ZIP level for a media entry by file-name extension, matching MS\n * Office: already-compressed raster formats → STORE (0), everything else →\n * DEFLATE (`mediaLevel`, default Normal). A `compression.media` override\n * therefore applies only to compressible formats, never forcing DEFLATE onto\n * pre-compressed assets.\n */\nexport const levelForMediaName = (fileName: string, mediaLevel: number): number => {\n  const dot = fileName.lastIndexOf(\".\");\n  const ext = dot < 0 ? \"\" : fileName.slice(dot + 1).toLowerCase();\n  return PRECOMPRESSED_MEDIA_EXT.has(ext) ? ZIP_STORED_LEVEL : mediaLevel;\n};\n\n/** Compression options for ZIP output (zlib levels 0-9, matching fflate). */\nexport interface CompressionOptions {\n  /** DEFLATE level for XML files. Default: 1 (SuperFast, matching MS Office). */\n  xml?: number;\n  /**\n   * DEFLATE level for compressible media (EMF/WMF/BMP/TIFF/…). Already-compressed\n   * formats (PNG/JPEG/GIF) are always STOREd regardless, matching MS Office.\n   * Default: 6 (Normal, matching MS Office for EMF/WMF).\n   */\n  media?: number;\n}\n\n/** Options for Packer output methods. */\nexport interface PackerOptions<T extends OutputType = \"nodebuffer\"> {\n  /** Output format. Defaults to `\"nodebuffer\"` (Node.js Buffer). */\n  type?: T;\n  /** Custom XML/ZIP file overrides. */\n  overrides?: XmlifyedFile[];\n  /** Compression levels for ZIP entries. */\n  compression?: CompressionOptions;\n}\n\n/**\n * Asynchronously compress files and convert to the requested output format.\n *\n * Uses fflate Web Workers for non-blocking DEFLATE compression.\n * XML entries use DEFLATE level 1 (SuperFast) by default. Media entries are\n * split by type, matching MS Office: already-compressed formats (PNG/JPEG/GIF)\n * are STOREd, everything else uses the `media` level (default Normal).\n * Set `{ media: ZIP_STORED_LEVEL }` to STORE all compressible media too.\n */\nexport const zipAndConvert = async <T extends OutputType>(\n  files: Zippable,\n  type: T,\n  mimeType: string,\n  level: number = ZIP_DEFLATE_LEVEL,\n): Promise<OutputByType[T]> => {\n  const zipped = hasNativeDeflate()\n    ? await nativeZipAsync(files, level)\n    : await new Promise<Uint8Array>((resolve, reject) => {\n        zip(\n          files as AsyncZippable,\n          { level: level as ZipOptions[\"level\"], consume: true },\n          (err, data) => {\n            if (err) reject(err);\n            else resolve(data);\n          },\n        );\n      });\n  return convertOutput(zipped, type, mimeType);\n};\n\n/**\n * Synchronously compress files and convert to the requested output format.\n *\n * Uses synchronous DEFLATE compression for maximum throughput.\n * Blocks the event loop — prefer {@link zipAndConvert} in server contexts.\n */\nexport const zipSyncAndConvert = <T extends OutputType>(\n  files: Zippable,\n  type: T,\n  mimeType: string,\n  level: number = ZIP_DEFLATE_LEVEL,\n): OutputByType[T] => {\n  const zipped = hasNativeDeflate()\n    ? nativeZip(files, level)\n    : zipSync(files, { level: level as ZipOptions[\"level\"] });\n  return convertOutput(zipped, type, mimeType);\n};\n\n/**\n * Create a `ReadableStream<Uint8Array>` from compressed file entries.\n *\n * Uses fflate's `AsyncZipDeflate` for non-blocking DEFLATE compression.\n * `STORED` entries (media) pass through synchronously.\n * Works in both Node.js and browsers (Web Streams API).\n */\nexport const createZipStream = (\n  files: Zippable,\n  defaultLevel: number = ZIP_DEFLATE_LEVEL,\n): ReadableStream<Uint8Array> => {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      try {\n        const zip = new Zip((err, chunk, _final) => {\n          if (err) {\n            controller.error(err);\n            return;\n          }\n          controller.enqueue(chunk);\n          if (_final) {\n            controller.close();\n          }\n        });\n\n        for (const [name, data] of Object.entries(files)) {\n          const raw = Array.isArray(data) ? (data[0] as Uint8Array) : (data as Uint8Array);\n          const level = Array.isArray(data)\n            ? ((data[1] as ZipOptions).level ?? defaultLevel)\n            : defaultLevel;\n          const entry =\n            level === ZIP_STORED_LEVEL\n              ? new ZipPassThrough(name)\n              : new AsyncZipDeflate(name, { level: level as ZipOptions[\"level\"] });\n          zip.add(entry);\n          entry.push(raw, true);\n        }\n\n        zip.end();\n      } catch (err) {\n        controller.error(err instanceof Error ? err : new Error(String(err)));\n      }\n    },\n  });\n};\n\n// ── Factory function ──\n\n/**\n * Compile function provided by each package to convert a file object into a Zippable map.\n */\nexport type CompileFn<TFile> = (\n  file: TFile,\n  overrides?: XmlifyedFile[],\n  mediaLevel?: number,\n) => Zippable;\n\n/**\n * Packer interface returned by {@link createPacker}.\n *\n * Async methods use fflate Web Workers for non-blocking compression.\n * Sync methods use synchronous compression for maximum throughput in\n * CLI scripts and build tools.\n */\nexport interface Packer<TFile> {\n  /** Compile file to Zippable map (synchronous). */\n  compile: CompileFn<TFile>;\n\n  /** Generic async output — returns the requested OutputType. */\n  pack<T extends OutputType = \"nodebuffer\">(\n    file: TFile,\n    options?: PackerOptions<T>,\n  ): Promise<OutputByType[T]>;\n  /** Generic sync output — returns the requested OutputType. */\n  packSync<T extends OutputType = \"nodebuffer\">(\n    file: TFile,\n    options?: PackerOptions<T>,\n  ): OutputByType[T];\n\n  /** Async → `Promise<Uint8Array>` (like `Response.bytes()`). */\n  toBytes(file: TFile, options?: PackerOptions): Promise<Uint8Array>;\n  /** Sync → `Uint8Array`. */\n  toBytesSync(file: TFile, options?: PackerOptions): Uint8Array;\n\n  /** Async → `Promise<string>` (raw ZIP content as string). */\n  toString(file: TFile, options?: PackerOptions): Promise<string>;\n  /** Sync → `string`. */\n  toStringSync(file: TFile, options?: PackerOptions): string;\n\n  /** Async → `Promise<Buffer>` (Node.js). */\n  toBuffer(file: TFile, options?: PackerOptions): Promise<Buffer>;\n  /** Sync → `Buffer` (Node.js). */\n  toBufferSync(file: TFile, options?: PackerOptions): Buffer;\n\n  /** Async → `Promise<string>` (base64-encoded). */\n  toBase64(file: TFile, options?: PackerOptions): Promise<string>;\n  /** Sync → `string` (base64-encoded). */\n  toBase64Sync(file: TFile, options?: PackerOptions): string;\n\n  /** Async → `Promise<Blob>` (browser). */\n  toBlob(file: TFile, options?: PackerOptions): Promise<Blob>;\n  /** Sync → `Blob`. */\n  toBlobSync(file: TFile, options?: PackerOptions): Blob;\n\n  /** Async → `Promise<ArrayBuffer>`. */\n  toArrayBuffer(file: TFile, options?: PackerOptions): Promise<ArrayBuffer>;\n  /** Sync → `ArrayBuffer`. */\n  toArrayBufferSync(file: TFile, options?: PackerOptions): ArrayBuffer;\n\n  /** Streaming output via `ReadableStream<Uint8Array>` (cross-platform, uses Web Workers). */\n  toStream(file: TFile, options?: PackerOptions): ReadableStream<Uint8Array>;\n}\n\n/**\n * Create a Packer object with all output format methods.\n *\n * Centralises the ZIP → convert pipeline and the streaming implementation\n * so that each OOXML package only needs to provide a `compile` function and\n * a MIME type.\n */\nexport const createPacker = <TFile>(options: {\n  compile: CompileFn<TFile>;\n  mimeType: string;\n}): Packer<TFile> => {\n  const { compile, mimeType } = options;\n\n  const pack = async <T extends OutputType = \"nodebuffer\">(\n    file: TFile,\n    opts?: PackerOptions<T>,\n  ): Promise<OutputByType[T]> => {\n    const type = opts?.type ?? (\"nodebuffer\" as T);\n    const files = compile(file, opts?.overrides ?? [], opts?.compression?.media ?? ZIP_MEDIA_LEVEL);\n    return zipAndConvert(files, type, mimeType, opts?.compression?.xml ?? ZIP_DEFLATE_LEVEL);\n  };\n\n  const toBytes = (file: TFile, opts?: PackerOptions) =>\n    pack(file, { ...opts, type: \"uint8array\" });\n  const toString = (file: TFile, opts?: PackerOptions) => pack(file, { ...opts, type: \"string\" });\n  const toBuffer = (file: TFile, opts?: PackerOptions) =>\n    pack(file, { ...opts, type: \"nodebuffer\" });\n  const toBase64 = (file: TFile, opts?: PackerOptions) => pack(file, { ...opts, type: \"base64\" });\n  const toBlob = (file: TFile, opts?: PackerOptions) => pack(file, { ...opts, type: \"blob\" });\n  const toArrayBuffer = (file: TFile, opts?: PackerOptions) =>\n    pack(file, { ...opts, type: \"arraybuffer\" });\n\n  // ── Sync methods (zipSync, maximum throughput) ──\n\n  const packSync = <T extends OutputType = \"nodebuffer\">(\n    file: TFile,\n    opts?: PackerOptions<T>,\n  ): OutputByType[T] => {\n    const type = opts?.type ?? (\"nodebuffer\" as T);\n    const files = compile(file, opts?.overrides ?? [], opts?.compression?.media ?? ZIP_MEDIA_LEVEL);\n    return zipSyncAndConvert(files, type, mimeType, opts?.compression?.xml ?? ZIP_DEFLATE_LEVEL);\n  };\n\n  const toBytesSync = (file: TFile, opts?: PackerOptions) =>\n    packSync(file, { ...opts, type: \"uint8array\" });\n  const toStringSync = (file: TFile, opts?: PackerOptions) =>\n    packSync(file, { ...opts, type: \"string\" });\n  const toBufferSync = (file: TFile, opts?: PackerOptions) =>\n    packSync(file, { ...opts, type: \"nodebuffer\" });\n  const toBase64Sync = (file: TFile, opts?: PackerOptions) =>\n    packSync(file, { ...opts, type: \"base64\" });\n  const toBlobSync = (file: TFile, opts?: PackerOptions) =>\n    packSync(file, { ...opts, type: \"blob\" });\n  const toArrayBufferSync = (file: TFile, opts?: PackerOptions) =>\n    packSync(file, { ...opts, type: \"arraybuffer\" });\n\n  // ── Stream ──\n\n  const toStream = (file: TFile, opts?: PackerOptions) => {\n    const mediaLevel = opts?.compression?.media ?? ZIP_MEDIA_LEVEL;\n    let files: Zippable;\n    try {\n      files = compile(file, opts?.overrides ?? [], mediaLevel);\n    } catch (err) {\n      return new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.error(err instanceof Error ? err : new Error(String(err)));\n        },\n      });\n    }\n    return createZipStream(files, opts?.compression?.xml ?? ZIP_DEFLATE_LEVEL);\n  };\n\n  return {\n    compile,\n    pack,\n    packSync,\n    toBytes,\n    toBytesSync,\n    toString,\n    toStringSync,\n    toBuffer,\n    toBufferSync,\n    toBase64,\n    toBase64Sync,\n    toBlob,\n    toBlobSync,\n    toArrayBuffer,\n    toArrayBufferSync,\n    toStream,\n  };\n};\n","/**\n * Shared compiler utilities for OOXML document generation.\n *\n * @module\n */\n\nimport { levelForMediaName } from \"../opc/packer\";\nimport type { XmlifyedFile, ZipOptions, Zippable } from \"../opc/packer\";\n\n/** Reusable TextEncoder instance (stateless, safe to share). */\nconst encoder = new TextEncoder();\n\n/**\n * Convert a mapping of XML files + overrides + media into a Zippable structure.\n *\n * Centralises the mapping→Zippable conversion shared by all three compilers.\n */\nexport function compileMapping(\n  mapping: Record<string, { data: string; path: string }>,\n  overrides?: XmlifyedFile[],\n  media?: { data: Uint8Array; path: string }[],\n  mediaLevel: number = 0,\n): Zippable {\n  const files: Zippable = {};\n  for (const entry of Object.values(mapping)) {\n    files[entry.path] = encoder.encode(entry.data);\n  }\n  if (overrides) {\n    for (const o of overrides) {\n      files[o.path] = typeof o.data === \"string\" ? encoder.encode(o.data) : o.data;\n    }\n  }\n  if (media) {\n    for (const m of media) {\n      // Already-compressed formats (PNG/JPEG/GIF) → STORE, else the media level.\n      // Matches MS Office, which STORE-s pre-compressed assets and DEFLATE-s the rest.\n      files[m.path] = [\n        m.data,\n        { level: levelForMediaName(m.path, mediaLevel) as ZipOptions[\"level\"] },\n      ];\n    }\n  }\n  return files;\n}\n","/**\n * Password hashing utilities for OOXML document protection.\n *\n * Implements ECMA-376 Agile Encryption password derivation.\n * Passwords are encoded as UTF-16LE per the OOXML specification.\n *\n * Uses @noble/hashes for SHA-512 — audited, cross-platform,\n * and comparable in speed to node:crypto for this workload.\n *\n * @module\n */\n\nimport { sha512 } from \"@noble/hashes/sha2.js\";\n\nimport { encodeBase64 } from \"./base64\";\n\n// ── Helpers ──\n\nfunction utf16leEncode(str: string): Uint8Array {\n  const bytes = new Uint8Array(str.length * 2);\n  for (let i = 0; i < str.length; i++) {\n    const code = str.charCodeAt(i);\n    bytes[i * 2] = code & 0xff;\n    bytes[i * 2 + 1] = (code >> 8) & 0xff;\n  }\n  return bytes;\n}\n\n// ── Public API ──\n\nexport function randomBytes(length: number): Uint8Array {\n  const bytes = new Uint8Array(length);\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (typeof crypto !== \"undefined\" && crypto.getRandomValues) {\n    crypto.getRandomValues(bytes);\n  } else {\n    for (let i = 0; i < length; i++) {\n      bytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n  return bytes;\n}\n\n/**\n * Computes the ECMA-376 Agile Encryption hash for a password.\n *\n * Algorithm: SHA-512(salt + UTF-16LE(password)), then iterate\n * SHA-512(hash + i.toUint32LE()) spinCount times.\n */\nexport function hashPasswordAgile(password: string, salt: Uint8Array, spinCount: number): string {\n  const pwBytes = utf16leEncode(password);\n\n  // h = SHA-512(salt + password_utf16le)\n  const initial = new Uint8Array(salt.length + pwBytes.length);\n  initial.set(salt, 0);\n  initial.set(pwBytes, salt.length);\n\n  let h = sha512(initial);\n  for (let i = 0; i < spinCount; i++) {\n    const buf = new Uint8Array(h.length + 4);\n    buf.set(h, 0);\n    buf[h.length] = i & 0xff;\n    buf[h.length + 1] = (i >> 8) & 0xff;\n    buf[h.length + 2] = (i >> 16) & 0xff;\n    buf[h.length + 3] = (i >> 24) & 0xff;\n    h = sha512(buf);\n  }\n\n  return encodeBase64(new Uint8Array(h));\n}\n\n/**\n * Derives a password hash for OOXML document protection.\n *\n * Returns base64-encoded hashValue, saltValue, spinCount, and algorithmName\n * suitable for direct use in document protection options.\n */\nexport function derivePasswordHash(\n  password: string,\n  spinCount = 100000,\n): { hashValue: string; saltValue: string; spinCount: number; algorithmName: string } {\n  const salt = randomBytes(16);\n  const hashValue = hashPasswordAgile(password, salt, spinCount);\n  return {\n    hashValue,\n    saltValue: encodeBase64(salt),\n    spinCount,\n    algorithmName: \"SHA-512\",\n  };\n}\n","/**\n * Placeholder detection and replacement utilities for compiler post-processing.\n *\n * Both DOCX and PPTX compilers use placeholder tokens (e.g. `{chart:key}`)\n * in XML strings to defer relationship ID assignment. This module provides\n * fast pre-check utilities and shared replacement functions.\n */\n\nexport type IdFormat = \"rId\" | \"plain\";\n\nexport const formatId = (offset: number, index: number, style: IdFormat): string =>\n  style === \"rId\" ? `rId${offset + index}` : `${offset + index}`;\n\n/** Single-pass regex replacement for `{key}` placeholders using a Map lookup. */\nconst PLACEHOLDER_RE = /\\{([^{}]+)\\}/g;\n\nfunction replacePlaceholders(xml: string, map: Map<string, string>): string {\n  const parts: string[] = [];\n  let last = 0;\n  for (const m of xml.matchAll(PLACEHOLDER_RE)) {\n    const key = m[1];\n    if (key === undefined) continue;\n    const replacement = map.get(key);\n    if (replacement !== undefined) {\n      parts.push(xml.substring(last, m.index!), replacement);\n      last = m.index! + m[0].length;\n    }\n  }\n  if (last === 0) return xml;\n  parts.push(xml.substring(last));\n  return parts.join(\"\");\n}\n\nexport function hasPlaceholders(xml: string): boolean {\n  return xml.includes(\"{\");\n}\n\nexport function collectPlaceholderKeys(xml: string, prefix: string): string[] {\n  const keys = new Set<string>();\n  const search = `{${prefix}`;\n  let pos = 0;\n\n  while ((pos = xml.indexOf(search, pos)) !== -1) {\n    const keyStart = pos + search.length;\n    const keyEnd = xml.indexOf(\"}\", keyStart);\n    if (keyEnd === -1) break;\n\n    const key = xml.substring(keyStart, keyEnd);\n    if (key.length > 0) keys.add(key);\n    pos = keyEnd + 1;\n  }\n\n  return [...keys];\n}\n\nexport function replaceImagePlaceholders(\n  xml: string,\n  mediaData: { fileName: string }[],\n  offset: number,\n  idFormat: IdFormat = \"rId\",\n): string {\n  if (mediaData.length === 0) return xml;\n  const map = new Map<string, string>();\n  for (const [i, item] of mediaData.entries()) {\n    map.set(item.fileName, formatId(offset, i, idFormat));\n  }\n  return replacePlaceholders(xml, map);\n}\n\nexport function getReferencedMedia(\n  xml: string,\n  mediaArray: { fileName: string }[],\n): { fileName: string }[] {\n  return mediaArray.filter((image) => xml.includes(`{${image.fileName}}`));\n}\n\n/**\n * Combined find + replace for image placeholders in a single pass.\n *\n * Scans XML for `{fileName}` placeholders, replaces them with formatted IDs,\n * and returns the list of referenced media items for relationship registration.\n * More efficient than calling getReferencedMedia() + replaceImagePlaceholders() separately.\n */\nexport function findAndReplaceImagePlaceholders(\n  xml: string,\n  mediaArray: { fileName: string }[],\n  offset: number,\n  idFormat: IdFormat = \"rId\",\n): { xml: string; referenced: { fileName: string }[] } {\n  if (mediaArray.length === 0 || !hasPlaceholders(xml)) {\n    return { xml, referenced: [] };\n  }\n  // Build fileName → mediaItem lookup\n  const itemMap = new Map<string, { fileName: string }>();\n  for (const item of mediaArray) {\n    itemMap.set(item.fileName, item);\n  }\n\n  const referenced: { fileName: string }[] = [];\n  const replaceMap = new Map<string, string>();\n  const parts: string[] = [];\n  let last = 0;\n\n  for (const m of xml.matchAll(PLACEHOLDER_RE)) {\n    const key = m[1];\n    if (key === undefined) continue;\n    const item = itemMap.get(key);\n    if (item !== undefined) {\n      if (!replaceMap.has(key)) {\n        // Use the referenced-local position (not the global media index) so the\n        // generated IDs align with the caller's per-part addRelationship(offset+i)\n        // loop. Using the global index desyncs the body's r:embed from the part's\n        // .rels when a part references only a subset of the global media array\n        // (e.g. headers/footers, whose images sit at high global indices).\n        replaceMap.set(key, formatId(offset, referenced.length, idFormat));\n        referenced.push(item);\n      }\n      parts.push(xml.substring(last, m.index!), replaceMap.get(key)!);\n      last = m.index! + m[0].length;\n    }\n  }\n\n  if (last === 0) return { xml, referenced: [] };\n  parts.push(xml.substring(last));\n  return { xml: parts.join(\"\"), referenced };\n}\n\n/**\n * Replace all placeholder types in a single pass.\n *\n * Combines image, chart, smartart, and arbitrary key-value replacements\n * into one regex scan of the XML string. Used by compilers to avoid\n * multiple full-string passes on large documents.\n */\nexport function replaceAllPlaceholders(\n  xml: string,\n  entries: Array<{ prefix?: string; key: string; value: string }>,\n): string {\n  if (entries.length === 0 || !hasPlaceholders(xml)) return xml;\n  const map = new Map<string, string>();\n  for (const { prefix, key, value } of entries) {\n    map.set(prefix ? `${prefix}${key}` : key, value);\n  }\n  return replacePlaceholders(xml, map);\n}\n\nexport function replaceChartPlaceholders(\n  xml: string,\n  chartKeys: string[],\n  offset: number,\n  idFormat: IdFormat = \"rId\",\n): string {\n  if (chartKeys.length === 0) return xml;\n  const map = new Map<string, string>();\n  for (let i = 0; i < chartKeys.length; i++) {\n    map.set(`chart:${chartKeys[i]}`, formatId(offset, i, idFormat));\n  }\n  return replacePlaceholders(xml, map);\n}\n\nimport type { RelationshipType } from \"../opc/relationships\";\n\nexport interface SmartArtRelOptions {\n  pathPrefix: string;\n  styleRelType: RelationshipType;\n}\n\nexport function replaceSmartArtPlaceholders(\n  xml: string,\n  keys: string[],\n  dataOffset: number,\n  idFormat: IdFormat = \"rId\",\n): string {\n  if (keys.length === 0) return xml;\n  const count = keys.length;\n  const loOffset = dataOffset + count;\n  const qsOffset = loOffset + count;\n  const csOffset = qsOffset + count;\n\n  const map = new Map<string, string>();\n  for (let i = 0; i < count; i++) {\n    map.set(`smartart:${keys[i]}`, formatId(dataOffset, i, idFormat));\n    map.set(`smartart-lo:${keys[i]}`, formatId(loOffset, i, idFormat));\n    map.set(`smartart-qs:${keys[i]}`, formatId(qsOffset, i, idFormat));\n    map.set(`smartart-cs:${keys[i]}`, formatId(csOffset, i, idFormat));\n  }\n  return replacePlaceholders(xml, map);\n}\n\nexport function addSmartArtRelationships(\n  keys: string[],\n  addRel: (id: number, type: RelationshipType, target: string, targetMode?: string) => void,\n  baseOffset: number,\n  globalStartIndex: number,\n  options: SmartArtRelOptions,\n): void {\n  const { pathPrefix, styleRelType } = options;\n  const count = keys.length;\n  const loOffset = baseOffset + count;\n  const qsOffset = loOffset + count;\n  const csOffset = qsOffset + count;\n\n  for (let i = 0; i < keys.length; i++) {\n    const gi = globalStartIndex + i;\n    addRel(\n      baseOffset + i,\n      \"http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramData\",\n      `${pathPrefix}diagrams/data${gi + 1}.xml`,\n    );\n    addRel(\n      loOffset + i,\n      \"http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramLayout\",\n      `${pathPrefix}diagrams/layout${gi + 1}.xml`,\n    );\n    addRel(qsOffset + i, styleRelType, `${pathPrefix}diagrams/quickStyle${gi + 1}.xml`);\n    addRel(\n      csOffset + i,\n      \"http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramColors\",\n      `${pathPrefix}diagrams/colors${gi + 1}.xml`,\n    );\n    const drOffset = csOffset + count;\n    addRel(\n      drOffset + i,\n      \"http://schemas.microsoft.com/office/2007/relationships/diagramDrawing\",\n      `${pathPrefix}diagrams/drawing${gi + 1}.xml`,\n    );\n  }\n}\n\n// ── Numbering placeholders (DOCX) ──\n\n/** Replace `{reference-instance}` placeholders with numId values. */\nexport function replaceNumberingPlaceholders(\n  xml: string,\n  concreteNumberings: readonly { reference: string; instance: number; numId: number }[],\n): string {\n  if (concreteNumberings.length === 0) return xml;\n  const map = new Map<string, string>();\n  for (const { reference, instance, numId } of concreteNumberings) {\n    map.set(`${reference}-${instance}`, numId.toString());\n  }\n  return replacePlaceholders(xml, map);\n}\n\n// ── Media/Video placeholders (PPTX) ──\n\n/** Replace `{media:fileName}` placeholders with relationship IDs. */\nexport function replaceMediaPlaceholders(\n  xml: string,\n  mediaData: { fileName: string }[],\n  offset: number,\n): string {\n  if (mediaData.length === 0) return xml;\n  const map = new Map<string, string>();\n  for (const [i, item] of mediaData.entries()) {\n    map.set(`media:${item.fileName}`, formatId(offset, i, \"rId\"));\n  }\n  return replacePlaceholders(xml, map);\n}\n\n/** Replace `{video:fileName}` placeholders with relationship IDs. */\nexport function replaceVideoPlaceholders(\n  xml: string,\n  mediaData: { fileName: string }[],\n  offset: number,\n): string {\n  if (mediaData.length === 0) return xml;\n  const map = new Map<string, string>();\n  for (const [i, item] of mediaData.entries()) {\n    map.set(`video:${item.fileName}`, formatId(offset, i, \"rId\"));\n  }\n  return replacePlaceholders(xml, map);\n}\n\n/** Collect media items referenced by `{media:...}` placeholders in XML. */\nexport function getMediaRefs(\n  xml: string,\n  mediaArray: { fileName: string }[],\n): { fileName: string }[] {\n  return collectPrefixedRefs(xml, \"media:\", mediaArray);\n}\n\n/** Collect media items referenced by `{video:...}` placeholders in XML. */\nexport function getVideoRefs(\n  xml: string,\n  mediaArray: { fileName: string }[],\n): { fileName: string }[] {\n  return collectPrefixedRefs(xml, \"video:\", mediaArray);\n}\n\nfunction collectPrefixedRefs(\n  xml: string,\n  prefix: string,\n  mediaArray: { fileName: string }[],\n): { fileName: string }[] {\n  const keys = new Set<string>();\n  const search = `{${prefix}`;\n  let pos = 0;\n  while ((pos = xml.indexOf(search, pos)) !== -1) {\n    const keyStart = pos + search.length;\n    const keyEnd = xml.indexOf(\"}\", keyStart);\n    if (keyEnd === -1) break;\n    keys.add(xml.substring(keyStart, keyEnd));\n    pos = keyEnd + 1;\n  }\n  return mediaArray.filter((m) => keys.has(m.fileName));\n}\n\n// ── Hyperlink placeholders (PPTX) ──\n\n/** Replace `{hlink:key}` placeholders with relationship IDs. */\nexport function replaceHyperlinkPlaceholders(\n  xml: string,\n  hyperlinks: { key: string }[],\n  offset: number,\n): string {\n  if (hyperlinks.length === 0) return xml;\n  const map = new Map<string, string>();\n  for (const [i, h] of hyperlinks.entries()) {\n    map.set(`hlink:${h.key}`, formatId(offset, i, \"rId\"));\n  }\n  return replacePlaceholders(xml, map);\n}\n","/**\n * Runtime validation and type conversion functions for OOXML specification values.\n *\n * This module provides runtime checks and cleanup for value types in the OOXML spec\n * that aren't easily expressed through the TypeScript type system alone. These\n * validators help prevent silent failures and corrupted documents by enforcing\n * spec-compliant values at runtime.\n *\n * @module\n */\n\n/**\n * A measurement value with optional sign and unit suffix.\n *\n * Supports units: mm (millimeters), cm (centimeters), in (inches), pt (points),\n * pc (picas), pi (picas), and a project-only px (96 DPI pixels).\n *\n * px is NOT part of OOXML's ST_UniversalMeasure (whose pattern is\n * `-?[0-9]+(\\.[0-9]+)?(mm|cm|in|pt|pc|pi)`); it is a project extension so\n * geometry APIs can accept `\"200px\"` alongside `\"5cm\"`. px is converted to EMU\n * (or TWIP) on input and never written to XML verbatim. Note: Word line spacing\n * with lineRule=\"auto\" uses a bare multiple (240ths of a line), not a measure,\n * so px is irrelevant there; spacing before/after and indents accept px and\n * convert it to twips (1px = 15twip).\n *\n * @example\n * ```typescript\n * const measure: UniversalMeasure = \"10.5mm\";\n * const px: UniversalMeasure = \"200px\";\n * const negative: UniversalMeasure = \"-5pt\";\n * ```\n */\nexport type UniversalMeasure =\n  `${\"-\" | \"\"}${number}${\"mm\" | \"cm\" | \"in\" | \"pt\" | \"pc\" | \"pi\" | \"px\"}`;\n\n/**\n * A positive measurement value with unit suffix.\n *\n * Same as UniversalMeasure but restricted to positive values only.\n *\n * Reference: ST_PositiveUniversalMeasure in OOXML specification\n *\n * @example\n * ```typescript\n * const measure: PositiveUniversalMeasure = \"10.5mm\";\n * ```\n */\nexport type PositiveUniversalMeasure = `${number}${\"mm\" | \"cm\" | \"in\" | \"pt\" | \"pc\" | \"pi\"}`;\n\n/**\n * A percentage value with optional sign.\n *\n * Pattern: `-?[0-9]+(\\.[0-9]+)?%`\n *\n * Reference: ST_Percentage in OOXML specification\n *\n * @example\n * ```typescript\n * const percent: Percentage = \"50%\";\n * const negative: Percentage = \"-10.5%\";\n * ```\n */\nexport type Percentage = `${\"-\" | \"\"}${number}%`;\n\n/**\n * A positive percentage value.\n *\n * Same as Percentage but restricted to positive values only.\n *\n * Reference: ST_PositivePercentage in OOXML specification\n *\n * @example\n * ```typescript\n * const percent: PositivePercentage = \"50%\";\n * ```\n */\nexport type PositivePercentage = `${number}%`;\n\n/**\n * A relative measurement value using em or ex units.\n *\n * Used in VML text boxes for font-relative measurements.\n *\n * @example\n * ```typescript\n * const measure: RelativeMeasure = \"2em\";\n * const negative: RelativeMeasure = \"-0.5ex\";\n * ```\n */\nexport type RelativeMeasure = `${\"-\" | \"\"}${number}${\"em\" | \"ex\"}`;\n\n/**\n * Validates and converts a number to an integer (decimal number).\n *\n * Reference: ST_DecimalNumber in OOXML specification\n *\n * @param val - The number to validate and convert\n * @returns The floored integer value\n * @throws Error if the value is NaN\n *\n * @example\n * ```typescript\n * const num = decimalNumber(10.7); // Returns 10\n * const negative = decimalNumber(-5.3); // Returns -5\n * ```\n */\nexport const decimalNumber = (val: number): number => {\n  if (!Number.isFinite(val)) {\n    throw new Error(`Invalid value '${val}' specified. Must be a finite number.`);\n  }\n  return Math.floor(val);\n};\n\n/**\n * Validates and converts a number to a positive integer (unsigned decimal number).\n *\n * Reference: ST_UnsignedDecimalNumber in OOXML specification\n *\n * @param val - The number to validate and convert\n * @returns The floored positive integer value\n * @throws Error if the value is NaN or negative\n *\n * @example\n * ```typescript\n * const num = unsignedDecimalNumber(10.7); // Returns 10\n * const invalid = unsignedDecimalNumber(-5); // Throws Error\n * ```\n */\nexport const unsignedDecimalNumber = (val: number): number => {\n  const value = decimalNumber(val);\n  if (value < 0) {\n    throw new Error(`Invalid value '${val}' specified. Must be a positive integer.`);\n  }\n  return value;\n};\n\n/**\n * Validates and normalizes a hexadecimal binary value.\n *\n * The xsd:hexBinary type represents binary data as a sequence of binary octets\n * using hexadecimal encoding, where each binary octet is a two-character\n * hexadecimal number. Both lowercase and uppercase letters A-F are permitted.\n *\n * @param val - The hexadecimal string to validate\n * @param length - The expected length in bytes (not characters)\n * @returns The validated hexadecimal string\n * @throws Error if the value is not a valid hex string of the expected length\n *\n * @example\n * ```typescript\n * hexBinary(\"0FB8\", 2); // Valid: 2 bytes = 4 characters\n * hexBinary(\"ABC\", 2); // Invalid: wrong length\n * ```\n */\nexport const hexBinary = (val: string, length: number): string => {\n  const expectedLength = length * 2;\n  if (val.length !== expectedLength || isNaN(Number(`0x${val}`))) {\n    throw new Error(`Invalid hex value '${val}'. Expected ${expectedLength} digit hex value`);\n  }\n  return val;\n};\n\n/**\n * Validates a long hexadecimal number (4 bytes / 8 characters).\n *\n * Reference: ST_LongHexNumber in OOXML specification\n *\n * @param val - The hexadecimal string to validate\n * @returns The validated hexadecimal string\n * @throws Error if the value is not a valid 8-character hex string\n *\n * @example\n * ```typescript\n * const hex = longHexNumber(\"ABCD1234\"); // Valid\n * ```\n */\nexport const longHexNumber = (val: string): string => hexBinary(val, 4);\n\n/**\n * Validates a short hexadecimal number (2 bytes / 4 characters).\n *\n * Reference: ST_ShortHexNumber in OOXML specification\n *\n * @param val - The hexadecimal string to validate\n * @returns The validated hexadecimal string\n * @throws Error if the value is not a valid 4-character hex string\n *\n * @example\n * ```typescript\n * const hex = shortHexNumber(\"AB12\"); // Valid\n * ```\n */\nexport const shortHexNumber = (val: string): string => hexBinary(val, 2);\n\n/**\n * Validates a single-byte hexadecimal number (1 byte / 2 characters).\n *\n * Reference: ST_UcharHexNumber in OOXML specification\n *\n * @param val - The hexadecimal string to validate\n * @returns The validated hexadecimal string\n * @throws Error if the value is not a valid 2-character hex string\n *\n * @example\n * ```typescript\n * const hex = uCharHexNumber(\"FF\"); // Valid\n * ```\n */\nexport const uCharHexNumber = (val: string): string => hexBinary(val, 1);\n\n/**\n * Normalizes a universal measure value by parsing and reformatting.\n *\n * Ensures the numeric portion is properly formatted while preserving the unit.\n *\n * Reference: ST_UniversalMeasure in OOXML specification\n *\n * @param val - The universal measure string to normalize\n * @returns The normalized universal measure\n *\n * @example\n * ```typescript\n * const measure = universalMeasureValue(\"10.500mm\"); // Returns \"10.5mm\"\n * ```\n */\nexport const universalMeasureValue = (val: UniversalMeasure): UniversalMeasure => {\n  const unit = val.slice(-2);\n  const amount = val.substring(0, val.length - 2);\n  return `${Number(amount)}${unit}` as UniversalMeasure;\n};\n\n/**\n * Validates and normalizes a positive universal measure value.\n *\n * Reference: ST_PositiveUniversalMeasure in OOXML specification\n *\n * @param val - The positive universal measure string to validate\n * @returns The normalized positive universal measure\n * @throws Error if the value is negative\n *\n * @example\n * ```typescript\n * const measure = positiveUniversalMeasureValue(\"10.5mm\"); // Valid\n * const invalid = positiveUniversalMeasureValue(\"-5mm\"); // Throws Error\n * ```\n */\nexport const positiveUniversalMeasureValue = (\n  val: PositiveUniversalMeasure,\n): PositiveUniversalMeasure => {\n  const value = universalMeasureValue(val);\n  if (parseFloat(value) < 0) {\n    throw new Error(`Invalid value '${value}' specified. Expected a positive number.`);\n  }\n  return value as PositiveUniversalMeasure;\n};\n\n/**\n * Validates and normalizes a hexadecimal color value.\n *\n * Accepts either \"auto\" or a 6-character RGB hex value (with or without # prefix).\n * The # prefix is commonly used but technically invalid in OOXML, so it is stripped\n * for strict compliance.\n *\n * Reference: ST_HexColor in OOXML specification\n *\n * @param val - The color value to validate (\"auto\" or hex color)\n * @returns The normalized color value\n * @throws Error if the hex color is invalid\n *\n * @example\n * ```typescript\n * const color1 = hexColorValue(\"auto\"); // Returns \"auto\"\n * const color2 = hexColorValue(\"FF0000\"); // Returns \"FF0000\"\n * const color3 = hexColorValue(\"#00FF00\"); // Returns \"00FF00\" (# stripped)\n * ```\n */\nexport const hexColorValue = (val: string): string => {\n  if (val === \"auto\") {\n    return val;\n  }\n  // It's super common to see colors prefixed with a pound, but technically invalid here.\n  // Most clients work with it, but strip it off anyway for strict compliance.\n  const color = val.charAt(0) === \"#\" ? val.substring(1) : val;\n  return hexBinary(color, 3);\n};\n\n/**\n * Validates a signed TWIP measurement value.\n *\n * Accepts either a universal measure string or a numeric TWIP value.\n *\n * Reference: ST_SignedTwipsMeasure in OOXML specification\n *\n * @param val - The measurement value (universal measure or number)\n * @returns The normalized measurement value\n *\n * @example\n * ```typescript\n * const measure1 = signedTwipsMeasureValue(\"10mm\");\n * const measure2 = signedTwipsMeasureValue(1440); // 1 inch in TWIP\n * ```\n */\nexport const signedTwipsMeasureValue = (\n  val: UniversalMeasure | number,\n): UniversalMeasure | number =>\n  typeof val === \"string\" ? universalMeasureValue(val) : decimalNumber(val);\n\n/**\n * Validates a half-point (HPS) measurement value.\n *\n * Accepts either a positive universal measure string or a positive number.\n * HPS (half-points) are commonly used for font sizes.\n *\n * Reference: ST_HpsMeasure in OOXML specification\n *\n * @param val - The measurement value (positive universal measure or number)\n * @returns The normalized measurement value\n *\n * @example\n * ```typescript\n * const fontSize1 = hpsMeasureValue(\"12pt\");\n * const fontSize2 = hpsMeasureValue(24); // 12pt in half-points\n * ```\n */\nexport const hpsMeasureValue = (val: PositiveUniversalMeasure | number): string | number =>\n  typeof val === \"string\" ? positiveUniversalMeasureValue(val) : unsignedDecimalNumber(val);\n\n/**\n * Validates a signed half-point (HPS) measurement value.\n *\n * Accepts either a universal measure string or a numeric value.\n *\n * Reference: ST_SignedHpsMeasure in OOXML specification\n *\n * @param val - The measurement value (universal measure or number)\n * @returns The normalized measurement value\n *\n * @example\n * ```typescript\n * const spacing1 = signedHpsMeasureValue(\"6pt\");\n * const spacing2 = signedHpsMeasureValue(-12); // Negative spacing\n * ```\n */\nexport const signedHpsMeasureValue = (val: UniversalMeasure | number): string | number =>\n  typeof val === \"string\" ? universalMeasureValue(val) : decimalNumber(val);\n\n/**\n * Validates a positive TWIP measurement value.\n *\n * Accepts either a positive universal measure string or a positive number.\n *\n * Reference: ST_TwipsMeasure in OOXML specification\n *\n * @param val - The measurement value (positive universal measure or number)\n * @returns The normalized measurement value\n *\n * @example\n * ```typescript\n * const width1 = twipsMeasureValue(\"25.4mm\");\n * const width2 = twipsMeasureValue(1440); // 1 inch in TWIP\n * ```\n */\nexport const twipsMeasureValue = (\n  val: PositiveUniversalMeasure | number,\n): PositiveUniversalMeasure | number =>\n  typeof val === \"string\" ? positiveUniversalMeasureValue(val) : unsignedDecimalNumber(val);\n\n/**\n * Normalizes a percentage value by parsing and reformatting.\n *\n * Reference: ST_Percentage in OOXML specification\n *\n * @param val - The percentage string to normalize\n * @returns The normalized percentage\n *\n * @example\n * ```typescript\n * const percent = percentageValue(\"50.000%\"); // Returns \"50%\"\n * ```\n */\nexport const percentageValue = (val: Percentage): Percentage => {\n  const percent = val.substring(0, val.length - 1);\n  return `${Number(percent)}%`;\n};\n\n/**\n * Validates a measurement value that can be expressed as a number, percentage, or universal measure.\n *\n * Reference: ST_MeasurementOrPercent in OOXML specification\n *\n * @param val - The measurement value (number, percentage, or universal measure)\n * @returns The normalized measurement value\n *\n * @example\n * ```typescript\n * const measure1 = measurementOrPercentValue(100); // Unqualified number\n * const measure2 = measurementOrPercentValue(\"50%\"); // Percentage\n * const measure3 = measurementOrPercentValue(\"10mm\"); // Universal measure\n * ```\n */\nexport const measurementOrPercentValue = (\n  val: number | Percentage | UniversalMeasure,\n): number | UniversalMeasure | Percentage => {\n  if (typeof val === \"number\") {\n    return decimalNumber(val);\n  }\n  if (val.slice(-1) === \"%\") {\n    return percentageValue(val as Percentage);\n  }\n  return universalMeasureValue(val as UniversalMeasure);\n};\n\n/**\n * Validates an eighth-point measurement value.\n *\n * Eighth-points are used for fine-grained measurements in text formatting.\n *\n * Reference: ST_EighthPointMeasure in OOXML specification\n *\n * @param val - The measurement value in eighth-points\n * @returns The validated positive integer value\n *\n * @example\n * ```typescript\n * const measure = eighthPointMeasureValue(16); // 2 points\n * ```\n */\nexport const eighthPointMeasureValue = unsignedDecimalNumber;\n\n/**\n * Validates a point measurement value.\n *\n * Reference: ST_PointMeasure in OOXML specification\n *\n * @param val - The measurement value in points\n * @returns The validated positive integer value\n *\n * @example\n * ```typescript\n * const fontSize = pointMeasureValue(12); // 12pt\n * ```\n */\nexport const pointMeasureValue = unsignedDecimalNumber;\n\n// Cspell:words CCYY\n/**\n * Converts a JavaScript Date object to an ISO 8601 date-time string.\n *\n * The format is CCYY-MM-DDThh:mm:ss.sssZ where T is a literal and Z indicates UTC.\n * This matches the xsd:dateTime format required by OOXML.\n *\n * Reference: ST_DateTime in OOXML specification\n *\n * @param val - The Date object to convert\n * @returns An ISO 8601 formatted date-time string\n *\n * @example\n * ```typescript\n * const now = new Date();\n * const timestamp = dateTimeValue(now); // Returns \"2024-01-15T10:30:00.000Z\"\n * ```\n */\nexport const dateTimeValue = (val: Date): string => val.toISOString();\n\n/**\n * Theme color values used throughout OOXML for referencing document theme colors.\n *\n * Reference: ST_ThemeColor in OOXML specification\n *\n * @publicApi\n */\nexport const ThemeColor = {\n  DARK1: \"dark1\",\n  LIGHT1: \"light1\",\n  DARK2: \"dark2\",\n  LIGHT2: \"light2\",\n  ACCENT1: \"accent1\",\n  ACCENT2: \"accent2\",\n  ACCENT3: \"accent3\",\n  ACCENT4: \"accent4\",\n  ACCENT5: \"accent5\",\n  ACCENT6: \"accent6\",\n  HYPERLINK: \"hyperlink\",\n  FOLLOWED_HYPERLINK: \"followedHyperlink\",\n  NONE: \"none\",\n  BACKGROUND1: \"background1\",\n  TEXT1: \"text1\",\n  BACKGROUND2: \"background2\",\n  TEXT2: \"text2\",\n} as const;\n\n/**\n * Theme font values used for referencing document theme fonts.\n *\n * Reference: ST_Theme in OOXML specification\n *\n * @publicApi\n */\nexport const ThemeFont = {\n  MAJOR_EAST_ASIA: \"majorEastAsia\",\n  MAJOR_BIDI: \"majorBidi\",\n  MAJOR_ASCII: \"majorAscii\",\n  MAJOR_H_ANSI: \"majorHAnsi\",\n  MINOR_EAST_ASIA: \"minorEastAsia\",\n  MINOR_BIDI: \"minorBidi\",\n  MINOR_ASCII: \"minorAscii\",\n  MINOR_H_ANSI: \"minorHAnsi\",\n} as const;\n"],"mappings":"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"}

package/dist/values-8di32lIe.d.mts

@@ -0,0 +1,56 @@
+//#region src/util/values.d.ts
+type UniversalMeasure = `${"-" | ""}${number}${"mm" | "cm" | "in" | "pt" | "pc" | "pi" | "px"}`;
+type PositiveUniversalMeasure = `${number}${"mm" | "cm" | "in" | "pt" | "pc" | "pi"}`;
+type Percentage = `${"-" | ""}${number}%`;
+type PositivePercentage = `${number}%`;
+type RelativeMeasure = `${"-" | ""}${number}${"em" | "ex"}`;
+declare const decimalNumber: (val: number) => number;
+declare const unsignedDecimalNumber: (val: number) => number;
+declare const hexBinary: (val: string, length: number) => string;
+declare const longHexNumber: (val: string) => string;
+declare const shortHexNumber: (val: string) => string;
+declare const uCharHexNumber: (val: string) => string;
+declare const universalMeasureValue: (val: UniversalMeasure) => UniversalMeasure;
+declare const positiveUniversalMeasureValue: (val: PositiveUniversalMeasure) => PositiveUniversalMeasure;
+declare const hexColorValue: (val: string) => string;
+declare const signedTwipsMeasureValue: (val: UniversalMeasure | number) => UniversalMeasure | number;
+declare const hpsMeasureValue: (val: PositiveUniversalMeasure | number) => string | number;
+declare const signedHpsMeasureValue: (val: UniversalMeasure | number) => string | number;
+declare const twipsMeasureValue: (val: PositiveUniversalMeasure | number) => PositiveUniversalMeasure | number;
+declare const percentageValue: (val: Percentage) => Percentage;
+declare const measurementOrPercentValue: (val: number | Percentage | UniversalMeasure) => number | UniversalMeasure | Percentage;
+declare const eighthPointMeasureValue: (val: number) => number;
+declare const pointMeasureValue: (val: number) => number;
+declare const dateTimeValue: (val: Date) => string;
+declare const ThemeColor: {
+  readonly DARK1: "dark1";
+  readonly LIGHT1: "light1";
+  readonly DARK2: "dark2";
+  readonly LIGHT2: "light2";
+  readonly ACCENT1: "accent1";
+  readonly ACCENT2: "accent2";
+  readonly ACCENT3: "accent3";
+  readonly ACCENT4: "accent4";
+  readonly ACCENT5: "accent5";
+  readonly ACCENT6: "accent6";
+  readonly HYPERLINK: "hyperlink";
+  readonly FOLLOWED_HYPERLINK: "followedHyperlink";
+  readonly NONE: "none";
+  readonly BACKGROUND1: "background1";
+  readonly TEXT1: "text1";
+  readonly BACKGROUND2: "background2";
+  readonly TEXT2: "text2";
+};
+declare const ThemeFont: {
+  readonly MAJOR_EAST_ASIA: "majorEastAsia";
+  readonly MAJOR_BIDI: "majorBidi";
+  readonly MAJOR_ASCII: "majorAscii";
+  readonly MAJOR_H_ANSI: "majorHAnsi";
+  readonly MINOR_EAST_ASIA: "minorEastAsia";
+  readonly MINOR_BIDI: "minorBidi";
+  readonly MINOR_ASCII: "minorAscii";
+  readonly MINOR_H_ANSI: "minorHAnsi";
+};
+//#endregion
+export { uCharHexNumber as C, twipsMeasureValue as S, unsignedDecimalNumber as T, pointMeasureValue as _, ThemeColor as a, signedHpsMeasureValue as b, dateTimeValue as c, hexBinary as d, hexColorValue as f, percentageValue as g, measurementOrPercentValue as h, RelativeMeasure as i, decimalNumber as l, longHexNumber as m, PositivePercentage as n, ThemeFont as o, hpsMeasureValue as p, PositiveUniversalMeasure as r, UniversalMeasure as s, Percentage as t, eighthPointMeasureValue as u, positiveUniversalMeasureValue as v, universalMeasureValue as w, signedTwipsMeasureValue as x, shortHexNumber as y };
+//# sourceMappingURL=values-8di32lIe.d.mts.map

package/dist/values-8di32lIe.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values-8di32lIe.d.mts","names":[],"sources":["../src/util/values.ts"],"mappings":";KAgCY,gBAAA;AAAA,KAeA,wBAAA;AAAA,KAeA,UAAA;AAAA,KAcA,kBAAA;AAAA,KAaA,eAAA;AAAA,cAiBC,aAAA,GAAiB,GAAW;AAAA,cAsB5B,qBAAA,GAAyB,GAAW;AAAA,cA0BpC,SAAA,GAAa,GAAA,UAAa,MAAc;AAAA,cAsBxC,aAAA,GAAiB,GAAW;AAAA,cAgB5B,cAAA,GAAkB,GAAW;AAAA,cAgB7B,cAAA,GAAkB,GAAW;AAAA,cAiB7B,qBAAA,GAAyB,GAAA,EAAK,gBAAA,KAAmB,gBAI7D;AAAA,cAiBY,6BAAA,GACX,GAAA,EAAK,wBAAA,KACJ,wBAMF;AAAA,cAsBY,aAAA,GAAiB,GAAW;AAAA,cA0B5B,uBAAA,GACX,GAAA,EAAK,gBAAA,cACJ,gBAAgB;AAAA,cAoBN,eAAA,GAAmB,GAAsC,EAAjC,wBAAwB;AAAA,cAmBhD,qBAAA,GAAyB,GAA8B,EAAzB,gBAAgB;AAAA,cAmB9C,iBAAA,GACX,GAAA,EAAK,wBAAA,cACJ,wBAAwB;AAAA,cAgBd,eAAA,GAAmB,GAAA,EAAK,UAAA,KAAa,UAGjD;AAAA,cAiBY,yBAAA,GACX,GAAA,WAAc,UAAA,GAAa,gBAAA,cACjB,gBAAA,GAAmB,UAAA;AAAA,cAyBlB,uBAAA,GAAuB,GA3Sa;AAAA,cA0TpC,iBAAA,GAAiB,GA1TmB;AAAA,cA8UpC,aAAA,GAAiB,GAAS,EAAJ,IAAI;AAAA,cAS1B,UAAA;EAAA;;;;;;;;;;;;;;;;;;cA2BA,SAAA;EAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@office-open/core",
-  "version": "0.10.12",
+  "version": "0.10.13",
   "description": "Shared OOXML infrastructure — XML components, validators, converters, charts, and SmartArt",
   "keywords": [
     "core",
@@ -27,6 +27,7 @@
     "dist"
   ],
   "type": "module",
+  "sideEffects": false,
   "main": "dist/index.mjs",
   "types": "dist/index.d.mts",
   "exports": {
@@ -34,10 +35,6 @@
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs"
     },
-    "./util/values": {
-      "types": "./dist/util/values.d.mts",
-      "import": "./dist/util/values.mjs"
-    },
     "./smartart": {
       "types": "./dist/smartart/index.d.mts",
       "import": "./dist/smartart/index.mjs"
@@ -61,12 +58,16 @@
     "./theme": {
       "types": "./dist/theme/index.d.mts",
       "import": "./dist/theme/index.mjs"
+    },
+    "./util": {
+      "types": "./dist/util/index.d.mts",
+      "import": "./dist/util/index.mjs"
     }
   },
   "dependencies": {
     "@noble/hashes": "2.2.0",
     "fflate": "0.8.3",
-    "@office-open/xml": "0.10.12"
+    "@office-open/xml": "0.10.13"
   },
   "scripts": {
     "dev": "basis build --stub",

package/dist/index-CHGFwCCQ.d.mts

@@ -1,266 +0,0 @@
-import { Element } from "@office-open/xml";
-import { Buffer } from "\u0000polyfill-node.buffer";
-
-//#region src/util/data-type.d.ts
-/** Supported binary input shapes. */
-type DataType = ArrayBufferLike | Blob | DataView | number[] | ReadableStream | string | Uint8Array;
-/** Test whether a string is a base64 data URL (`data:[mime];base64,...`). */
-declare function isBase64DataURL(input: string): boolean;
-/** Options for {@link toUint8Array}. */
-interface ToUint8ArrayOptions {
-  /**
-   * How to interpret a plain (non-data-URL) string input. Data URLs
-   * (`data:...;base64,...`) and binary inputs (Buffer/Uint8Array/ArrayBuffer/
-   * DataView/number[]) are auto-detected and ignore this hint.
-   *
-   * - `"utf8"` (default): UTF-8 text.
-   * - `"base64"`: base64-encoded binary — e.g. an image supplied via
-   *   `readFileSync(...).toString("base64")`.
-   */
-  encoding?: "utf8" | "base64";
-}
-/** Normalize any supported binary input to a `Uint8Array`. */
-declare function toUint8Array(data: DataType, options?: ToUint8ArrayOptions): Uint8Array;
-//#endregion
-//#region src/opc/output.d.ts
-/**
- * Output type definitions for OOXML document export.
- *
- * @module
- */
-interface OutputByType {
-  base64: string;
-  string: string;
-  text: string;
-  binarystring: string;
-  array: readonly number[];
-  uint8array: Uint8Array;
-  arraybuffer: ArrayBuffer;
-  blob: Blob;
-  nodebuffer: Buffer;
-}
-type OutputType = keyof OutputByType;
-declare const OoxmlMimeType: {
-  readonly DOCX: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-  readonly PPTX: "application/vnd.openxmlformats-officedocument.presentationml.presentation";
-  readonly XLSX: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
-};
-declare const convertOutput: <T extends OutputType>(data: Uint8Array, type: T, mimeType?: string) => OutputByType[T];
-//#endregion
-//#region src/opc/core.d.ts
-type IXmlableObject = Readonly<Record<string, unknown>>;
-/**
- * Core document properties (docProps/core.xml).
- *
- * Shared across docx/pptx/xlsx: each format's top-level Options extends this,
- * parse emits the same shape, and patch overrides it — read/write symmetry
- * (CONTRIBUTING §Property Naming). Field names follow the OPC core-properties
- * XSD element local names (`creator` = dc:creator, … — never `author`).
- */
-interface CorePropertiesOptions {
-  title?: string;
-  subject?: string;
-  creator?: string;
-  keywords?: string;
-  description?: string;
-  lastModifiedBy?: string;
-  revision?: number;
-  lastPrinted?: string;
-  /** Creation timestamp (W3CDTF), round-tripped from dcterms:created. */
-  created?: string;
-  /** Last modified timestamp (W3CDTF), round-tripped from dcterms:modified. */
-  modified?: string;
-}
-/**
- * Parse core properties from an already-parsed XML element.
- * Shared by docx/pptx/xlsx to extract Dublin Core metadata into the unified
- * {@link CorePropertiesOptions} shape.
- */
-declare function parseCorePropsElement(el: Element | undefined): CorePropertiesOptions;
-/**
- * Build a cp:coreProperties XML object from metadata.
- *
- * Shared by docx and pptx to avoid duplicating namespace declarations
- * and Dublin Core property construction.
- */
-declare function buildCorePropertiesXml(opts: {
-  title?: string;
-  subject?: string;
-  creator?: string;
-  keywords?: string;
-  description?: string;
-  lastModifiedBy?: string;
-  revision?: number;
-}): IXmlableObject;
-/**
- * Build a cp:coreProperties XML string directly (fast path).
- *
- * Shared by pptx and xlsx to bypass the toXml() → xml() pipeline.
- * created/modified default to now when not supplied; all other fields emit
- * only when present.
- */
-declare function buildCorePropertiesXmlString(opts: CorePropertiesOptions): string;
-//#endregion
-//#region src/patch/xml-namespace.d.ts
-/**
- * Namespace configuration for XML patch operations.
- *
- * Parameterises element names so the same patch algorithm works for both
- * DOCX (`w:*`) and PPTX (`a:*`) documents.
- */
-interface XmlNamespaceConfig {
-  paragraph: string;
-  run: string;
-  text: string;
-  runProperties: string;
-}
-declare const DOCX_NS: XmlNamespaceConfig;
-declare const PPTX_NS: XmlNamespaceConfig;
-//#endregion
-//#region src/patch/xml-replacer.d.ts
-interface ReplacerConfig {
-  ns: XmlNamespaceConfig;
-  formatChild: (child: unknown, context: unknown) => Element[];
-  preserveSpace?: boolean;
-}
-interface ReplacerResult {
-  element: Element;
-  didFindOccurrence: boolean;
-}
-declare function createReplacer(config: ReplacerConfig): ({
-  json,
-  patch,
-  patchText,
-  context,
-  keepOriginalStyles
-}: {
-  json: Element;
-  patch: {
-    type: string;
-    children: readonly unknown[];
-  };
-  patchText: string;
-  context: unknown;
-  keepOriginalStyles?: boolean;
-}) => ReplacerResult;
-//#endregion
-//#region src/patch/run-renderer.d.ts
-interface ElementWrapper {
-  element: Element;
-  index: number;
-  parent: ElementWrapper | undefined;
-}
-interface RenderedParagraphNode {
-  text: string;
-  runs: readonly RenderedRunNode[];
-  index: number;
-  pathToParagraph: readonly number[];
-}
-interface StartAndEnd {
-  start: number;
-  end: number;
-}
-type IParts = {
-  text: string;
-  index: number;
-} & StartAndEnd;
-type RenderedRunNode = {
-  text: string;
-  parts: readonly IParts[];
-  index: number;
-} & StartAndEnd;
-declare function createRunRenderer(ns: XmlNamespaceConfig): (node: ElementWrapper) => RenderedParagraphNode;
-//#endregion
-//#region src/patch/xml-traverser.d.ts
-declare function createTraverser(ns: XmlNamespaceConfig): {
-  traverse: (node: Element) => readonly RenderedParagraphNode[];
-  findLocationOfText: (node: Element, text: string) => readonly RenderedParagraphNode[];
-};
-//#endregion
-//#region src/patch/paragraph-token-replacer.d.ts
-declare function createTokenReplacer(createTextElementContents: (text: string) => Element[], options?: {
-  readonly preserveSpace?: boolean;
-}): ({
-  paragraphElement,
-  renderedParagraph,
-  originalText,
-  replacementText
-}: {
-  paragraphElement: Element;
-  renderedParagraph: RenderedParagraphNode;
-  originalText: string;
-  replacementText: string;
-}) => Element;
-//#endregion
-//#region src/patch/paragraph-split-inject.d.ts
-declare class TokenNotFoundError extends Error {
-  constructor(token: string);
-}
-declare function createSplitInject(ns: XmlNamespaceConfig, createTextElementContents: (text: string) => Element[], options?: {
-  readonly preserveSpace?: boolean;
-}): {
-  findRunElementIndexWithToken: (paragraphElement: Element, token: string) => number;
-  splitRunElement: (runElement: Element, token: string) => {
-    readonly left: Element;
-    readonly right: Element;
-  };
-};
-//#endregion
-//#region src/patch/xml-patch-utils.d.ts
-declare const toJson: (xmlData: string) => Element;
-/**
- * Creates the inner content of a text element (`w:t` / `a:t`).
- *
- * Returns `[{ type: "text", text }]` for non-empty text, `[]` for empty.
- * The `xml:space` attribute is handled separately by `patchSpaceAttribute`.
- */
-declare const createTextElementContents: (text: string) => Element[];
-declare const patchSpaceAttribute: (element: Element) => Element;
-declare const getFirstLevelElements: (relationships: Element, id: string) => Element[];
-/**
- * Next sequential numeric id: the largest `attr` value among direct children
- * named `childName`, plus one. `seed` is the floor — e.g. PPTX `<p:sldId>`
- * values start at 255, so the first appended id is at least 256.
- *
- * Unifies the per-package `maxCommentId` / `maxSldId` / `maxSheetId` helpers.
- */
-declare const nextNumericId: (parent: Element | undefined, childName: string, attr: string, seed?: number) => number;
-//#endregion
-//#region src/patch/content-types-manager.d.ts
-declare const appendContentType: (element: Element, contentType: string, extension: string) => void;
-/**
- * Append an `<Override>` element to a `[Content_Types].xml` root, deduped by
- * `PartName`. Sibling to {@link appendContentType} (which handles `<Default>`):
- * unifies the per-package Override-dedup blocks in docx/pptx/xlsx patchers.
- */
-declare const appendOverride: (element: Element, partName: string, contentType: string) => void;
-//#endregion
-//#region src/patch/relationship-manager.d.ts
-declare const getNextRelationshipIndex: (relationships: Element) => number;
-declare const appendRelationship: (relationships: Element, id: number | string, type: string, target: string, targetMode?: string) => readonly Element[];
-//#endregion
-//#region src/patch/core-properties-override.d.ts
-declare function applyCorePropertiesOverride(corePropsDoc: Element, overrides: Partial<CorePropertiesOptions>): string;
-//#endregion
-//#region src/patch/types.d.ts
-/** Placeholder delimiter pair surrounding a patch key (e.g. `{{` / `}}`). */
-interface PlaceholderDelimiters {
-  start: string;
-  end: string;
-}
-/**
- * Shared base options for patch operations.
- *
- * Format-specific patch functions extend this with their `patches` field
- * (and any format-specific options like `keepOriginalStyles`).
- */
-interface BasePatchOptions<T extends OutputType = OutputType> {
-  /** Source document bytes (Buffer / Uint8Array / ArrayBuffer / base64 data URL / …). */
-  data: DataType;
-  /** Output container type — controls the return type via OutputByType. */
-  outputType: T;
-  /** Custom placeholder delimiters (default `{{` / `}}`). */
-  placeholderDelimiters?: PlaceholderDelimiters;
-}
-//#endregion
-export { OutputType as A, XmlNamespaceConfig as C, parseCorePropsElement as D, buildCorePropertiesXmlString as E, toUint8Array as F, DataType as M, ToUint8ArrayOptions as N, OoxmlMimeType as O, isBase64DataURL as P, PPTX_NS as S, buildCorePropertiesXml as T, RenderedParagraphNode as _, getNextRelationshipIndex as a, createReplacer as b, createTextElementContents as c, patchSpaceAttribute as d, toJson as f, createTraverser as g, createTokenReplacer as h, appendRelationship as i, convertOutput as j, OutputByType as k, getFirstLevelElements as l, createSplitInject as m, PlaceholderDelimiters as n, appendContentType as o, TokenNotFoundError as p, applyCorePropertiesOverride as r, appendOverride as s, BasePatchOptions as t, nextNumericId as u, createRunRenderer as v, CorePropertiesOptions as w, DOCX_NS as x, ReplacerConfig as y };