@office-kit/xlsx 0.11.1 → 0.13.0

package/dist/{drawing-BxzLuryn.mjs.map → drawing-ZJ3h4VHD.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"drawing-BxzLuryn.mjs","names":[],"sources":["../src/drawing/image.ts","../src/drawing/anchor.ts","../src/drawing/drawing.ts"],"sourcesContent":["// Image embedding.\n//\n// `XlsxImage` is the workbook-level handle for any image referenced from a\n// worksheet drawing (or chart `<a:blipFill>`). Bytes are kept verbatim so\n// re-saving never re-encodes; format / width / height are detected from the\n// file header so callers don't have to specify them.\n\nimport { OpenXmlIoError } from '../utils/exceptions.js';\n\nexport type XlsxImageFormat = 'png' | 'jpeg' | 'gif' | 'bmp' | 'webp' | 'tiff' | 'svg' | 'emf' | 'wmf';\n\n/**\n * Map from image format to the Content-Types Default extension that Excel uses\n * in `[Content_Types].xml`. SVG / EMF / WMF use the same extension as the\n * format string; PNG/JPEG/GIF/BMP do too. WebP and TIFF use their canonical\n * short names.\n */\nexport const IMAGE_FORMAT_EXTENSION: Readonly<Record<XlsxImageFormat, string>> = {\n  png: 'png',\n  jpeg: 'jpeg',\n  gif: 'gif',\n  bmp: 'bmp',\n  webp: 'webp',\n  tiff: 'tiff',\n  svg: 'svg',\n  emf: 'emf',\n  wmf: 'wmf',\n};\n\n/** Map from image format to its IANA `image/*` MIME type. */\nexport const IMAGE_FORMAT_MIME: Readonly<Record<XlsxImageFormat, string>> = {\n  png: 'image/png',\n  jpeg: 'image/jpeg',\n  gif: 'image/gif',\n  bmp: 'image/bmp',\n  webp: 'image/webp',\n  tiff: 'image/tiff',\n  svg: 'image/svg+xml',\n  emf: 'image/x-emf',\n  wmf: 'image/x-wmf',\n};\n\nexport interface XlsxImage {\n  bytes: Uint8Array;\n  format: XlsxImageFormat;\n  /** Pixel width. Zero when dimensions can't be determined for the format. */\n  width: number;\n  /** Pixel height. Zero when dimensions can't be determined for the format. */\n  height: number;\n  /** ZIP archive path, e.g. `xl/media/image3.png`. Set by the writer. */\n  path?: string;\n  /** rels-resolved id used by `<a:blip r:embed=\"...\">`. Set by the loader. */\n  rId?: string;\n}\n\n// ---- Magic-byte format detection ------------------------------------------\n\nconst startsWith = (bytes: Uint8Array, sig: ReadonlyArray<number>, offset = 0): boolean => {\n  if (bytes.length < offset + sig.length) return false;\n  for (let i = 0; i < sig.length; i++) {\n    if (bytes[offset + i] !== sig[i]) return false;\n  }\n  return true;\n};\n\nconst PNG_SIG = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];\nconst JPEG_SIG = [0xff, 0xd8, 0xff];\nconst GIF87 = [0x47, 0x49, 0x46, 0x38, 0x37, 0x61];\nconst GIF89 = [0x47, 0x49, 0x46, 0x38, 0x39, 0x61];\nconst BMP_SIG = [0x42, 0x4d];\nconst RIFF_SIG = [0x52, 0x49, 0x46, 0x46];\nconst WEBP_TAG = [0x57, 0x45, 0x42, 0x50];\nconst TIFF_LE = [0x49, 0x49, 0x2a, 0x00];\nconst TIFF_BE = [0x4d, 0x4d, 0x00, 0x2a];\nconst EMF_SIG = [0x01, 0x00, 0x00, 0x00];\nconst EMF_TAG = [0x20, 0x45, 0x4d, 0x46]; // ' EMF' at offset 40\nconst WMF_SIG_PLACEABLE = [0xd7, 0xcd, 0xc6, 0x9a];\nconst WMF_SIG_BARE = [0x01, 0x00, 0x09, 0x00];\n\nconst isSvg = (bytes: Uint8Array): boolean => {\n  // Inspect the first ~512 bytes for an `<svg` tag (with optional XML / DOCTYPE\n  // preamble).\n  const head = new TextDecoder('utf-8', { fatal: false }).decode(bytes.subarray(0, Math.min(bytes.length, 512)));\n  return /<svg\\b/i.test(head);\n};\n\nexport function detectImageFormat(bytes: Uint8Array): XlsxImageFormat | undefined {\n  if (startsWith(bytes, PNG_SIG)) return 'png';\n  if (startsWith(bytes, JPEG_SIG)) return 'jpeg';\n  if (startsWith(bytes, GIF87) || startsWith(bytes, GIF89)) return 'gif';\n  if (startsWith(bytes, BMP_SIG)) return 'bmp';\n  if (startsWith(bytes, RIFF_SIG) && startsWith(bytes, WEBP_TAG, 8)) return 'webp';\n  if (startsWith(bytes, TIFF_LE) || startsWith(bytes, TIFF_BE)) return 'tiff';\n  if (startsWith(bytes, EMF_SIG) && startsWith(bytes, EMF_TAG, 40)) return 'emf';\n  if (startsWith(bytes, WMF_SIG_PLACEABLE) || startsWith(bytes, WMF_SIG_BARE)) return 'wmf';\n  if (isSvg(bytes)) return 'svg';\n  return undefined;\n}\n\n// ---- Per-format dimension extraction --------------------------------------\n\nconst readU32BE = (bytes: Uint8Array, offset: number): number =>\n  ((bytes[offset] ?? 0) << 24) |\n  ((bytes[offset + 1] ?? 0) << 16) |\n  ((bytes[offset + 2] ?? 0) << 8) |\n  (bytes[offset + 3] ?? 0);\n\nconst readU16LE = (bytes: Uint8Array, offset: number): number => (bytes[offset] ?? 0) | ((bytes[offset + 1] ?? 0) << 8);\n\nconst readU16BE = (bytes: Uint8Array, offset: number): number => ((bytes[offset] ?? 0) << 8) | (bytes[offset + 1] ?? 0);\n\ninterface Dimensions {\n  width: number;\n  height: number;\n}\n\nconst pngDimensions = (bytes: Uint8Array): Dimensions | undefined => {\n  // PNG: 8-byte signature, 4-byte chunk-length, 4-byte type (\"IHDR\"), then\n  // 4-byte width, 4-byte height (both big-endian).\n  if (bytes.length < 24) return undefined;\n  if (bytes[12] !== 0x49 || bytes[13] !== 0x48 || bytes[14] !== 0x44 || bytes[15] !== 0x52) {\n    return undefined;\n  }\n  return { width: readU32BE(bytes, 16), height: readU32BE(bytes, 20) };\n};\n\nconst gifDimensions = (bytes: Uint8Array): Dimensions | undefined => {\n  if (bytes.length < 10) return undefined;\n  return { width: readU16LE(bytes, 6), height: readU16LE(bytes, 8) };\n};\n\nconst bmpDimensions = (bytes: Uint8Array): Dimensions | undefined => {\n  if (bytes.length < 26) return undefined;\n  // BITMAPINFOHEADER: width (LE int32) at offset 18, height at offset 22.\n  // Height can be negative for top-down bitmaps; we report absolute pixels.\n  const w = (bytes[18] ?? 0) | ((bytes[19] ?? 0) << 8) | ((bytes[20] ?? 0) << 16) | ((bytes[21] ?? 0) << 24);\n  const hRaw = (bytes[22] ?? 0) | ((bytes[23] ?? 0) << 8) | ((bytes[24] ?? 0) << 16) | ((bytes[25] ?? 0) << 24);\n  // Treat width as signed; for height take absolute value (top-down bitmaps\n  // store negative).\n  const wSigned = (w | 0) >>> 0 > 0x7fffffff ? (w | 0) - 0x100000000 : w;\n  const hSigned = (hRaw | 0) >>> 0 > 0x7fffffff ? (hRaw | 0) - 0x100000000 : hRaw;\n  return { width: wSigned, height: Math.abs(hSigned) };\n};\n\nconst jpegDimensions = (bytes: Uint8Array): Dimensions | undefined => {\n  // Walk the marker stream until an SOFn (FFC0..FFCF, excluding FFC4/C8/CC).\n  let i = 2; // skip SOI (FFD8)\n  while (i + 9 < bytes.length) {\n    if (bytes[i] !== 0xff) return undefined;\n    let marker = bytes[i + 1] ?? 0;\n    while (marker === 0xff) {\n      // Padding bytes. Advance to the next non-FF.\n      i += 1;\n      marker = bytes[i + 1] ?? 0;\n    }\n    i += 2;\n    const isSof = marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc;\n    const len = readU16BE(bytes, i);\n    if (isSof) {\n      // SOF segment: 2 bytes length, 1 byte precision, 2 bytes height, 2 bytes\n      // width.\n      if (i + 7 > bytes.length) return undefined;\n      const height = readU16BE(bytes, i + 3);\n      const width = readU16BE(bytes, i + 5);\n      return { width, height };\n    }\n    i += len;\n  }\n  return undefined;\n};\n\nconst webpDimensions = (bytes: Uint8Array): Dimensions | undefined => {\n  // RIFF header is 12 bytes; chunk type is at offset 12.\n  if (bytes.length < 30) return undefined;\n  // VP8 (lossy): \"VP8 \" chunk; width / height at offset 26 / 28 (LE 14-bit each\n  // + 2 unused bits).\n  if (\n    bytes[12] === 0x56 && // V\n    bytes[13] === 0x50 && // P\n    bytes[14] === 0x38 && // 8\n    bytes[15] === 0x20 // space\n  ) {\n    const w = readU16LE(bytes, 26) & 0x3fff;\n    const h = readU16LE(bytes, 28) & 0x3fff;\n    return { width: w, height: h };\n  }\n  // VP8L (lossless): 14-bit width-1 / height-1 packed little-endian starting at\n  // offset 21.\n  if (\n    bytes[12] === 0x56 &&\n    bytes[13] === 0x50 &&\n    bytes[14] === 0x38 &&\n    bytes[15] === 0x4c // L\n  ) {\n    if (bytes.length < 25) return undefined;\n    const b0 = bytes[21] ?? 0;\n    const b1 = bytes[22] ?? 0;\n    const b2 = bytes[23] ?? 0;\n    const b3 = bytes[24] ?? 0;\n    const w = (b0 | (b1 << 8)) & 0x3fff;\n    const h = ((b1 >> 6) | (b2 << 2) | ((b3 & 0x0f) << 10)) & 0x3fff;\n    return { width: w + 1, height: h + 1 };\n  }\n  // VP8X (extended): width-1 (24 bits) / height-1 (24 bits) at offset 24 / 27.\n  if (\n    bytes[12] === 0x56 &&\n    bytes[13] === 0x50 &&\n    bytes[14] === 0x38 &&\n    bytes[15] === 0x58 // X\n  ) {\n    if (bytes.length < 30) return undefined;\n    const w = (bytes[24] ?? 0) | ((bytes[25] ?? 0) << 8) | ((bytes[26] ?? 0) << 16);\n    const h = (bytes[27] ?? 0) | ((bytes[28] ?? 0) << 8) | ((bytes[29] ?? 0) << 16);\n    return { width: w + 1, height: h + 1 };\n  }\n  return undefined;\n};\n\nexport function detectImageDimensions(bytes: Uint8Array, format: XlsxImageFormat): Dimensions {\n  let dims: Dimensions | undefined;\n  switch (format) {\n    case 'png':\n      dims = pngDimensions(bytes);\n      break;\n    case 'jpeg':\n      dims = jpegDimensions(bytes);\n      break;\n    case 'gif':\n      dims = gifDimensions(bytes);\n      break;\n    case 'bmp':\n      dims = bmpDimensions(bytes);\n      break;\n    case 'webp':\n      dims = webpDimensions(bytes);\n      break;\n    default:\n      // tiff / svg / emf / wmf — readers can fall back to 0 and Excel will\n      // assign defaults.\n      dims = undefined;\n  }\n  return dims ?? { width: 0, height: 0 };\n}\n\n// ---- Public factory --------------------------------------------------------\n\n/**\n * Build an `XlsxImage` from raw bytes. Detects the format and dimensions\n * automatically. Caller may pass an explicit `format` to override detection\n * (e.g. when bytes were read from a `data:` URL with a known MIME type) or\n * `width`/`height` to skip the parser.\n */\nexport function loadImage(\n  bytes: Uint8Array,\n  opts: { format?: XlsxImageFormat; width?: number; height?: number } = {},\n): XlsxImage {\n  const format = opts.format ?? detectImageFormat(bytes);\n  if (!format) {\n    throw new OpenXmlIoError('loadImage: could not determine image format from bytes');\n  }\n  const dims =\n    opts.width !== undefined && opts.height !== undefined\n      ? { width: opts.width, height: opts.height }\n      : detectImageDimensions(bytes, format);\n  return { bytes, format, width: dims.width, height: dims.height };\n}\n","// DrawingML anchors.\n//\n// An anchor positions a drawing (chart / image / shape) inside a worksheet.\n// ECMA-376 §20.5.2 defines three kinds:\n//\n// absolute — fixed (x, y) and (cx, cy) in EMU; ignores cell layout. oneCell —\n// pinned at `from` cell, fixed extent. Resizes with the\n//               cell only on its top-left corner.\n// twoCell — anchored to `from` and `to` cells. Resizes / moves with\n//               both corners depending on `editAs`.\n//\n// Coordinates are EMU (English Metric Units). 1 inch = 914400 EMU, 1 cm =\n// 360000 EMU, 1 px = 9525 EMU at 96 dpi.\n\nimport { columnIndexFromLetter } from '../utils/coordinate.js';\nimport { OpenXmlSchemaError } from '../utils/exceptions.js';\nimport { emuFromPx } from '../utils/units.js';\n\n/** EMU = English Metric Units. Drawing coordinates are stored in EMU on the wire. */\nexport interface Point2D {\n  /** Horizontal offset in EMU. */\n  x: number;\n  /** Vertical offset in EMU. */\n  y: number;\n}\n\nexport interface PositiveSize2D {\n  cx: number;\n  cy: number;\n}\n\n/**\n * `from` / `to` corners reference a cell by 0-based column + row index plus an\n * EMU offset within the cell. Excel's wire format is 0-based here even though\n * cell references in formulas / sheetData are 1-based.\n */\nexport interface AnchorMarker {\n  col: number;\n  colOff: number;\n  row: number;\n  rowOff: number;\n}\n\nexport type DrawingAnchor =\n  | { kind: 'absolute'; pos: Point2D; ext: PositiveSize2D }\n  | { kind: 'oneCell'; from: AnchorMarker; ext: PositiveSize2D }\n  | { kind: 'twoCell'; from: AnchorMarker; to: AnchorMarker; editAs?: 'twoCell' | 'oneCell' | 'absolute' };\n\nconst A1_RE = /^([A-Za-z]{1,3})([1-9][0-9]*)$/;\n\n/**\n * Convert a cell ref (\"A1\", \"C5\") to a 0-based AnchorMarker with `colOff =\n * rowOff = 0`. Throws on malformed refs.\n */\nexport function anchorMarkerFromCellRef(ref: string): AnchorMarker {\n  const m = A1_RE.exec(ref);\n  if (!m || m[1] === undefined || m[2] === undefined) {\n    throw new OpenXmlSchemaError(`anchorMarkerFromCellRef: invalid coordinate \"${ref}\"`);\n  }\n  const col = columnIndexFromLetter(m[1]) - 1; // 0-based\n  const row = Number.parseInt(m[2], 10) - 1; // 0-based\n  return { col, colOff: 0, row, rowOff: 0 };\n}\n\n/** Build an absolute anchor from an (x, y, cx, cy) EMU bundle. */\nexport function makeAbsoluteAnchor(opts: { x: number; y: number; cx: number; cy: number }): DrawingAnchor {\n  return { kind: 'absolute', pos: { x: opts.x, y: opts.y }, ext: { cx: opts.cx, cy: opts.cy } };\n}\n\n/** Build a one-cell anchor pinned at `from` with an explicit pixel extent. */\nexport function makeOneCellAnchor(opts: {\n  from: string | AnchorMarker;\n  widthPx: number;\n  heightPx: number;\n}): DrawingAnchor {\n  const from = typeof opts.from === 'string' ? anchorMarkerFromCellRef(opts.from) : opts.from;\n  return {\n    kind: 'oneCell',\n    from,\n    ext: { cx: emuFromPx(opts.widthPx), cy: emuFromPx(opts.heightPx) },\n  };\n}\n\n/**\n * Build a two-cell anchor from cell-ref pairs (or pre-built markers). Defaults\n * to `editAs='twoCell'` — drag both corners with the cells.\n */\nexport function makeTwoCellAnchor(opts: {\n  from: string | AnchorMarker;\n  to: string | AnchorMarker;\n  editAs?: 'twoCell' | 'oneCell' | 'absolute';\n}): DrawingAnchor {\n  const from = typeof opts.from === 'string' ? anchorMarkerFromCellRef(opts.from) : opts.from;\n  const to = typeof opts.to === 'string' ? anchorMarkerFromCellRef(opts.to) : opts.to;\n  return {\n    kind: 'twoCell',\n    from,\n    to,\n    ...(opts.editAs !== undefined ? { editAs: opts.editAs } : {}),\n  };\n}\n","// Spreadsheet drawing data model.\n//\n// A `Drawing` is the per-worksheet `xl/drawings/drawingN.xml` part — a list of\n// anchor entries, each carrying a content variant (chart, picture, shape,\n// connector, group). Charts and pictures are modeled; everything else is kept\n// as the verbatim source XML so it survives a round-trip untouched.\n\nimport type { ChartSpace } from '../chart/chart.js';\nimport type { CxChartSpace } from '../chart/cx/chartex.js';\nimport type { DrawingAnchor } from './anchor.js';\nimport type { ShapeProperties } from './dml/shape-properties.js';\nimport type { XlsxImage } from './image.js';\n\n/** Reference to a chart part — the chart's drawing-rels rId resolves to xl/charts/chartN.xml. */\nexport interface ChartReference {\n  /** Drawing-rels rId pointing at the chart part. Populated on read; the writer assigns its own. */\n  rId?: string;\n  /**\n   * Legacy ECMA-376 chart payload (`c:chartSpace`). Stage-1 supports BarChart\n   * end-to-end; other chart kinds populate this field as their parsers /\n   * writers land.\n   */\n  space?: ChartSpace;\n  /**\n   * Excel-2016 chartex payload (`cx:chartSpace`). Mutually exclusive with\n   * {@link space} for any given drawing item; the parser sniffs the root\n   * element and populates whichever is appropriate.\n   */\n  cxSpace?: CxChartSpace;\n  /**\n   * `true` when the resolved chart part is a chartex (`cx:`) chart. Set by the\n   * package writer so the drawing emitter knows to use the chartex\n   * `<a:graphicData uri>` instead of the legacy chart URI — Excel rejects the\n   * workbook when the URI doesn't match the chart's actual root namespace.\n   */\n  isCx?: boolean;\n}\n\n/** Reference to an embedded picture inside a worksheet drawing. */\nexport interface PictureReference {\n  /** Drawing-rels rId pointing at the embedded image. Populated on read; the writer assigns its own. */\n  rId?: string;\n  /** Resolved image bytes + metadata. Populated on read; the writer reads it back. */\n  image?: XlsxImage;\n  /** Picture display name (`<xdr:cNvPr name=\"...\">`). */\n  name?: string;\n  /** Optional alt-text description. */\n  descr?: string;\n  /** Hidden flag (`<xdr:cNvPr hidden=\"1\"/>`). */\n  hidden?: boolean;\n  /** Per-picture shape properties (extra fill / line / rotation). */\n  spPr?: ShapeProperties;\n}\n\nexport interface DrawingItem {\n  anchor: DrawingAnchor;\n  content:\n    | { kind: 'chart'; chart: ChartReference }\n    | { kind: 'picture'; picture: PictureReference }\n    | { kind: 'unsupported'; rawTag: string };\n  /**\n   * The whole source anchor element, captured verbatim. Set by the reader for\n   * `unsupported` content — a plain shape, a group, a connector — because the\n   * model has no slot for its geometry, text or `<xdr:clientData>` attributes.\n   * When present the writer emits it as-is instead of rebuilding the anchor\n   * from {@link anchor} + {@link content}.\n   */\n  raw?: import('../xml/tree.js').XmlNode;\n}\n\nexport interface Drawing {\n  items: DrawingItem[];\n  /**\n   * `<xdr:wsDr>` children that aren't anchors — in practice Excel's\n   * `<mc:AlternateContent>` wrapper around an anchor that needs a newer\n   * feature. Kept verbatim together with the `items` index they sat before, so\n   * document order (which is z-order) survives a round-trip.\n   */\n  rawChildren?: Array<{ beforeItem: number; node: import('../xml/tree.js').XmlNode }>;\n  /**\n   * Drawing-rels entries the verbatim nodes above reference (`r:embed` on a\n   * picture inside a group, `r:id` on a shape's hyperlink, …). Carried over\n   * from the source part under their original ids so those references still\n   * resolve after a re-save; the writer allocates its own ids around them.\n   */\n  rawRels?: import('../packaging/relationships.js').Relationships;\n}\n\nexport function makeDrawing(items: DrawingItem[] = []): Drawing {\n  return { items };\n}\n\nexport function makeChartDrawingItem(anchor: DrawingAnchor, chart: ChartReference = {}): DrawingItem {\n  return { anchor, content: { kind: 'chart', chart } };\n}\n\nexport function makePictureDrawingItem(anchor: DrawingAnchor, picture: PictureReference | XlsxImage): DrawingItem {\n  // Distinguish raw image bytes from a full PictureReference by checking the\n  // discriminator: XlsxImage carries `format`, PictureReference doesn't.\n  const ref: PictureReference = 'format' in picture ? { image: picture as XlsxImage } : (picture as PictureReference);\n  return { anchor, content: { kind: 'picture', picture: ref } };\n}\n\n// ---- Worksheet ergonomic helpers ----------------------------------------\n\nimport { loadImage } from './image.js';\nimport { makeOneCellAnchor } from './anchor.js';\nimport type { Worksheet } from '../worksheet/worksheet.js';\n\n/**\n * Drop an image onto a worksheet at a single-cell anchor. Lazy-allocates\n * `ws.drawing` (as `makeDrawing([])`) on first call and appends a picture\n * DrawingItem.\n *\n * `image` accepts either an `XlsxImage` (already loaded via `loadImage`) or raw\n * image bytes — in the bytes case, this helper sniffs the format with\n * `loadImage` itself.\n *\n * `at` is a cell ref like `\"C3\"`. Override `widthPx` / `heightPx` to scale;\n * otherwise the helper uses 96×96 defaults that look fine for typical icons.\n */\nexport const addImageAt = (\n  ws: Worksheet,\n  at: string,\n  image: XlsxImage | Uint8Array,\n  opts: { widthPx?: number; heightPx?: number } = {},\n): DrawingItem => {\n  const xlsxImage: XlsxImage = image instanceof Uint8Array ? loadImage(image) : image;\n  const anchor = makeOneCellAnchor({\n    from: at,\n    widthPx: opts.widthPx ?? 96,\n    heightPx: opts.heightPx ?? 96,\n  });\n  const item = makePictureDrawingItem(anchor, xlsxImage);\n  if (!ws.drawing) ws.drawing = makeDrawing([]);\n  ws.drawing.items.push(item);\n  return item;\n};\n\n/**\n * Anchor a chart to a worksheet at a single-cell ref. Lazy-allocates\n * `ws.drawing`. `chart` is the same `ChartReference` shape `makeChart\n * DrawingItem` accepts (`{ space }` for legacy chart, `{ cxSpace }` for\n * chartex).\n */\nexport const addChartAt = (\n  ws: Worksheet,\n  at: string,\n  chart: ChartReference,\n  opts: { widthPx?: number; heightPx?: number } = {},\n): DrawingItem => {\n  const anchor = makeOneCellAnchor({\n    from: at,\n    widthPx: opts.widthPx ?? 480,\n    heightPx: opts.heightPx ?? 320,\n  });\n  const item = makeChartDrawingItem(anchor, chart);\n  if (!ws.drawing) ws.drawing = makeDrawing([]);\n  ws.drawing.items.push(item);\n  return item;\n};\n\n/**\n * Read-only snapshot of every picture DrawingItem on the sheet. Returns the\n * matching items (each with its anchor + picture reference). Empty array when\n * the sheet has no drawing or only non-picture items.\n */\nexport const listImagesOnSheet = (ws: Worksheet): ReadonlyArray<DrawingItem> => {\n  if (!ws.drawing) return [];\n  return ws.drawing.items.filter((it) => it.content.kind === 'picture');\n};\n\n/**\n * Read-only snapshot of every chart DrawingItem on the sheet. Each item has its\n * anchor + chart reference.\n */\nexport const listChartsOnSheet = (ws: Worksheet): ReadonlyArray<DrawingItem> => {\n  if (!ws.drawing) return [];\n  return ws.drawing.items.filter((it) => it.content.kind === 'chart');\n};\n\n/**\n * Drop every DrawingItem from the worksheet. Returns the count removed. The\n * `ws.drawing` field itself is left in place (empty) so subsequent `addImageAt`\n * / `addChartAt` calls don't have to re-allocate.\n */\nexport const removeAllDrawingItems = (ws: Worksheet): number => {\n  if (!ws.drawing) return 0;\n  const n = ws.drawing.items.length;\n  ws.drawing.items = [];\n  return n;\n};\n\n/**\n * Drop every picture DrawingItem from the worksheet, leaving charts and any\n * other content kinds untouched. Returns the count removed.\n */\nexport const removeAllImages = (ws: Worksheet): number => {\n  if (!ws.drawing) return 0;\n  const before = ws.drawing.items.length;\n  ws.drawing.items = ws.drawing.items.filter((it) => it.content.kind !== 'picture');\n  return before - ws.drawing.items.length;\n};\n\n/**\n * Drop every chart DrawingItem from the worksheet, leaving pictures and any\n * other content kinds untouched. Returns the count removed.\n */\nexport const removeAllCharts = (ws: Worksheet): number => {\n  if (!ws.drawing) return 0;\n  const before = ws.drawing.items.length;\n  ws.drawing.items = ws.drawing.items.filter((it) => it.content.kind !== 'chart');\n  return before - ws.drawing.items.length;\n};\n"],"mappings":"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"}
+{"version":3,"file":"drawing-ZJ3h4VHD.mjs","names":[],"sources":["../src/drawing/image.ts","../src/drawing/anchor.ts","../src/drawing/drawing.ts"],"sourcesContent":["// Image embedding.\n//\n// `XlsxImage` is the workbook-level handle for any image referenced from a\n// worksheet drawing (or chart `<a:blipFill>`). Bytes are kept verbatim so\n// re-saving never re-encodes; format / width / height are detected from the\n// file header so callers don't have to specify them.\n\nimport { OpenXmlIoError } from '../utils/exceptions.js';\n\nexport type XlsxImageFormat = 'png' | 'jpeg' | 'gif' | 'bmp' | 'webp' | 'tiff' | 'svg' | 'emf' | 'wmf';\n\n/**\n * Map from image format to the Content-Types Default extension that Excel uses\n * in `[Content_Types].xml`. SVG / EMF / WMF use the same extension as the\n * format string; PNG/JPEG/GIF/BMP do too. WebP and TIFF use their canonical\n * short names.\n */\nexport const IMAGE_FORMAT_EXTENSION: Readonly<Record<XlsxImageFormat, string>> = {\n  png: 'png',\n  jpeg: 'jpeg',\n  gif: 'gif',\n  bmp: 'bmp',\n  webp: 'webp',\n  tiff: 'tiff',\n  svg: 'svg',\n  emf: 'emf',\n  wmf: 'wmf',\n};\n\n/** Map from image format to its IANA `image/*` MIME type. */\nexport const IMAGE_FORMAT_MIME: Readonly<Record<XlsxImageFormat, string>> = {\n  png: 'image/png',\n  jpeg: 'image/jpeg',\n  gif: 'image/gif',\n  bmp: 'image/bmp',\n  webp: 'image/webp',\n  tiff: 'image/tiff',\n  svg: 'image/svg+xml',\n  emf: 'image/x-emf',\n  wmf: 'image/x-wmf',\n};\n\nexport interface XlsxImage {\n  bytes: Uint8Array;\n  format: XlsxImageFormat;\n  /** Pixel width. Zero when dimensions can't be determined for the format. */\n  width: number;\n  /** Pixel height. Zero when dimensions can't be determined for the format. */\n  height: number;\n  /** ZIP archive path, e.g. `xl/media/image3.png`. Set by the writer. */\n  path?: string;\n  /** rels-resolved id used by `<a:blip r:embed=\"...\">`. Set by the loader. */\n  rId?: string;\n}\n\n// ---- Magic-byte format detection ------------------------------------------\n\nconst startsWith = (bytes: Uint8Array, sig: ReadonlyArray<number>, offset = 0): boolean => {\n  if (bytes.length < offset + sig.length) return false;\n  for (let i = 0; i < sig.length; i++) {\n    if (bytes[offset + i] !== sig[i]) return false;\n  }\n  return true;\n};\n\nconst PNG_SIG = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];\nconst JPEG_SIG = [0xff, 0xd8, 0xff];\nconst GIF87 = [0x47, 0x49, 0x46, 0x38, 0x37, 0x61];\nconst GIF89 = [0x47, 0x49, 0x46, 0x38, 0x39, 0x61];\nconst BMP_SIG = [0x42, 0x4d];\nconst RIFF_SIG = [0x52, 0x49, 0x46, 0x46];\nconst WEBP_TAG = [0x57, 0x45, 0x42, 0x50];\nconst TIFF_LE = [0x49, 0x49, 0x2a, 0x00];\nconst TIFF_BE = [0x4d, 0x4d, 0x00, 0x2a];\nconst EMF_SIG = [0x01, 0x00, 0x00, 0x00];\nconst EMF_TAG = [0x20, 0x45, 0x4d, 0x46]; // ' EMF' at offset 40\nconst WMF_SIG_PLACEABLE = [0xd7, 0xcd, 0xc6, 0x9a];\nconst WMF_SIG_BARE = [0x01, 0x00, 0x09, 0x00];\n\nconst isSvg = (bytes: Uint8Array): boolean => {\n  // Inspect the first ~512 bytes for an `<svg` tag (with optional XML / DOCTYPE\n  // preamble).\n  const head = new TextDecoder('utf-8', { fatal: false }).decode(bytes.subarray(0, Math.min(bytes.length, 512)));\n  return /<svg\\b/i.test(head);\n};\n\nexport function detectImageFormat(bytes: Uint8Array): XlsxImageFormat | undefined {\n  if (startsWith(bytes, PNG_SIG)) return 'png';\n  if (startsWith(bytes, JPEG_SIG)) return 'jpeg';\n  if (startsWith(bytes, GIF87) || startsWith(bytes, GIF89)) return 'gif';\n  if (startsWith(bytes, BMP_SIG)) return 'bmp';\n  if (startsWith(bytes, RIFF_SIG) && startsWith(bytes, WEBP_TAG, 8)) return 'webp';\n  if (startsWith(bytes, TIFF_LE) || startsWith(bytes, TIFF_BE)) return 'tiff';\n  if (startsWith(bytes, EMF_SIG) && startsWith(bytes, EMF_TAG, 40)) return 'emf';\n  if (startsWith(bytes, WMF_SIG_PLACEABLE) || startsWith(bytes, WMF_SIG_BARE)) return 'wmf';\n  if (isSvg(bytes)) return 'svg';\n  return undefined;\n}\n\n// ---- Per-format dimension extraction --------------------------------------\n\nconst readU32BE = (bytes: Uint8Array, offset: number): number =>\n  ((bytes[offset] ?? 0) << 24) |\n  ((bytes[offset + 1] ?? 0) << 16) |\n  ((bytes[offset + 2] ?? 0) << 8) |\n  (bytes[offset + 3] ?? 0);\n\nconst readU16LE = (bytes: Uint8Array, offset: number): number => (bytes[offset] ?? 0) | ((bytes[offset + 1] ?? 0) << 8);\n\nconst readU16BE = (bytes: Uint8Array, offset: number): number => ((bytes[offset] ?? 0) << 8) | (bytes[offset + 1] ?? 0);\n\ninterface Dimensions {\n  width: number;\n  height: number;\n}\n\nconst pngDimensions = (bytes: Uint8Array): Dimensions | undefined => {\n  // PNG: 8-byte signature, 4-byte chunk-length, 4-byte type (\"IHDR\"), then\n  // 4-byte width, 4-byte height (both big-endian).\n  if (bytes.length < 24) return undefined;\n  if (bytes[12] !== 0x49 || bytes[13] !== 0x48 || bytes[14] !== 0x44 || bytes[15] !== 0x52) {\n    return undefined;\n  }\n  return { width: readU32BE(bytes, 16), height: readU32BE(bytes, 20) };\n};\n\nconst gifDimensions = (bytes: Uint8Array): Dimensions | undefined => {\n  if (bytes.length < 10) return undefined;\n  return { width: readU16LE(bytes, 6), height: readU16LE(bytes, 8) };\n};\n\nconst bmpDimensions = (bytes: Uint8Array): Dimensions | undefined => {\n  if (bytes.length < 26) return undefined;\n  // BITMAPINFOHEADER: width (LE int32) at offset 18, height at offset 22.\n  // Height can be negative for top-down bitmaps; we report absolute pixels.\n  const w = (bytes[18] ?? 0) | ((bytes[19] ?? 0) << 8) | ((bytes[20] ?? 0) << 16) | ((bytes[21] ?? 0) << 24);\n  const hRaw = (bytes[22] ?? 0) | ((bytes[23] ?? 0) << 8) | ((bytes[24] ?? 0) << 16) | ((bytes[25] ?? 0) << 24);\n  // Treat width as signed; for height take absolute value (top-down bitmaps\n  // store negative).\n  const wSigned = (w | 0) >>> 0 > 0x7fffffff ? (w | 0) - 0x100000000 : w;\n  const hSigned = (hRaw | 0) >>> 0 > 0x7fffffff ? (hRaw | 0) - 0x100000000 : hRaw;\n  return { width: wSigned, height: Math.abs(hSigned) };\n};\n\nconst jpegDimensions = (bytes: Uint8Array): Dimensions | undefined => {\n  // Walk the marker stream until an SOFn (FFC0..FFCF, excluding FFC4/C8/CC).\n  let i = 2; // skip SOI (FFD8)\n  while (i + 9 < bytes.length) {\n    if (bytes[i] !== 0xff) return undefined;\n    let marker = bytes[i + 1] ?? 0;\n    while (marker === 0xff) {\n      // Padding bytes. Advance to the next non-FF.\n      i += 1;\n      marker = bytes[i + 1] ?? 0;\n    }\n    i += 2;\n    const isSof = marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc;\n    const len = readU16BE(bytes, i);\n    if (isSof) {\n      // SOF segment: 2 bytes length, 1 byte precision, 2 bytes height, 2 bytes\n      // width.\n      if (i + 7 > bytes.length) return undefined;\n      const height = readU16BE(bytes, i + 3);\n      const width = readU16BE(bytes, i + 5);\n      return { width, height };\n    }\n    i += len;\n  }\n  return undefined;\n};\n\nconst webpDimensions = (bytes: Uint8Array): Dimensions | undefined => {\n  // RIFF header is 12 bytes; chunk type is at offset 12.\n  if (bytes.length < 30) return undefined;\n  // VP8 (lossy): \"VP8 \" chunk; width / height at offset 26 / 28 (LE 14-bit each\n  // + 2 unused bits).\n  if (\n    bytes[12] === 0x56 && // V\n    bytes[13] === 0x50 && // P\n    bytes[14] === 0x38 && // 8\n    bytes[15] === 0x20 // space\n  ) {\n    const w = readU16LE(bytes, 26) & 0x3fff;\n    const h = readU16LE(bytes, 28) & 0x3fff;\n    return { width: w, height: h };\n  }\n  // VP8L (lossless): 14-bit width-1 / height-1 packed little-endian starting at\n  // offset 21.\n  if (\n    bytes[12] === 0x56 &&\n    bytes[13] === 0x50 &&\n    bytes[14] === 0x38 &&\n    bytes[15] === 0x4c // L\n  ) {\n    if (bytes.length < 25) return undefined;\n    const b0 = bytes[21] ?? 0;\n    const b1 = bytes[22] ?? 0;\n    const b2 = bytes[23] ?? 0;\n    const b3 = bytes[24] ?? 0;\n    const w = (b0 | (b1 << 8)) & 0x3fff;\n    const h = ((b1 >> 6) | (b2 << 2) | ((b3 & 0x0f) << 10)) & 0x3fff;\n    return { width: w + 1, height: h + 1 };\n  }\n  // VP8X (extended): width-1 (24 bits) / height-1 (24 bits) at offset 24 / 27.\n  if (\n    bytes[12] === 0x56 &&\n    bytes[13] === 0x50 &&\n    bytes[14] === 0x38 &&\n    bytes[15] === 0x58 // X\n  ) {\n    if (bytes.length < 30) return undefined;\n    const w = (bytes[24] ?? 0) | ((bytes[25] ?? 0) << 8) | ((bytes[26] ?? 0) << 16);\n    const h = (bytes[27] ?? 0) | ((bytes[28] ?? 0) << 8) | ((bytes[29] ?? 0) << 16);\n    return { width: w + 1, height: h + 1 };\n  }\n  return undefined;\n};\n\nexport function detectImageDimensions(bytes: Uint8Array, format: XlsxImageFormat): Dimensions {\n  let dims: Dimensions | undefined;\n  switch (format) {\n    case 'png':\n      dims = pngDimensions(bytes);\n      break;\n    case 'jpeg':\n      dims = jpegDimensions(bytes);\n      break;\n    case 'gif':\n      dims = gifDimensions(bytes);\n      break;\n    case 'bmp':\n      dims = bmpDimensions(bytes);\n      break;\n    case 'webp':\n      dims = webpDimensions(bytes);\n      break;\n    default:\n      // tiff / svg / emf / wmf — readers can fall back to 0 and Excel will\n      // assign defaults.\n      dims = undefined;\n  }\n  return dims ?? { width: 0, height: 0 };\n}\n\n// ---- Public factory --------------------------------------------------------\n\n/**\n * Build an `XlsxImage` from raw bytes. Detects the format and dimensions\n * automatically. Caller may pass an explicit `format` to override detection\n * (e.g. when bytes were read from a `data:` URL with a known MIME type) or\n * `width`/`height` to skip the parser.\n */\nexport function loadImage(\n  bytes: Uint8Array,\n  opts: { format?: XlsxImageFormat; width?: number; height?: number } = {},\n): XlsxImage {\n  const format = opts.format ?? detectImageFormat(bytes);\n  if (!format) {\n    throw new OpenXmlIoError('loadImage: could not determine image format from bytes');\n  }\n  const dims =\n    opts.width !== undefined && opts.height !== undefined\n      ? { width: opts.width, height: opts.height }\n      : detectImageDimensions(bytes, format);\n  return { bytes, format, width: dims.width, height: dims.height };\n}\n","// DrawingML anchors.\n//\n// An anchor positions a drawing (chart / image / shape) inside a worksheet.\n// ECMA-376 §20.5.2 defines three kinds:\n//\n// absolute — fixed (x, y) and (cx, cy) in EMU; ignores cell layout. oneCell —\n// pinned at `from` cell, fixed extent. Resizes with the\n//               cell only on its top-left corner.\n// twoCell — anchored to `from` and `to` cells. Resizes / moves with\n//               both corners depending on `editAs`.\n//\n// Coordinates are EMU (English Metric Units). 1 inch = 914400 EMU, 1 cm =\n// 360000 EMU, 1 px = 9525 EMU at 96 dpi.\n\nimport { columnIndexFromLetter } from '../utils/coordinate.js';\nimport { OpenXmlSchemaError } from '../utils/exceptions.js';\nimport { emuFromPx } from '../utils/units.js';\n\n/** EMU = English Metric Units. Drawing coordinates are stored in EMU on the wire. */\nexport interface Point2D {\n  /** Horizontal offset in EMU. */\n  x: number;\n  /** Vertical offset in EMU. */\n  y: number;\n}\n\nexport interface PositiveSize2D {\n  cx: number;\n  cy: number;\n}\n\n/**\n * `from` / `to` corners reference a cell by 0-based column + row index plus an\n * EMU offset within the cell. Excel's wire format is 0-based here even though\n * cell references in formulas / sheetData are 1-based.\n */\nexport interface AnchorMarker {\n  col: number;\n  colOff: number;\n  row: number;\n  rowOff: number;\n}\n\nexport type DrawingAnchor =\n  | { kind: 'absolute'; pos: Point2D; ext: PositiveSize2D }\n  | { kind: 'oneCell'; from: AnchorMarker; ext: PositiveSize2D }\n  | { kind: 'twoCell'; from: AnchorMarker; to: AnchorMarker; editAs?: 'twoCell' | 'oneCell' | 'absolute' };\n\nconst A1_RE = /^([A-Za-z]{1,3})([1-9][0-9]*)$/;\n\n/**\n * Convert a cell ref (\"A1\", \"C5\") to a 0-based AnchorMarker with `colOff =\n * rowOff = 0`. Throws on malformed refs.\n */\nexport function anchorMarkerFromCellRef(ref: string): AnchorMarker {\n  const m = A1_RE.exec(ref);\n  if (!m || m[1] === undefined || m[2] === undefined) {\n    throw new OpenXmlSchemaError(`anchorMarkerFromCellRef: invalid coordinate \"${ref}\"`);\n  }\n  const col = columnIndexFromLetter(m[1]) - 1; // 0-based\n  const row = Number.parseInt(m[2], 10) - 1; // 0-based\n  return { col, colOff: 0, row, rowOff: 0 };\n}\n\n/** Build an absolute anchor from an (x, y, cx, cy) EMU bundle. */\nexport function makeAbsoluteAnchor(opts: { x: number; y: number; cx: number; cy: number }): DrawingAnchor {\n  return { kind: 'absolute', pos: { x: opts.x, y: opts.y }, ext: { cx: opts.cx, cy: opts.cy } };\n}\n\n/** Build a one-cell anchor pinned at `from` with an explicit pixel extent. */\nexport function makeOneCellAnchor(opts: {\n  from: string | AnchorMarker;\n  widthPx: number;\n  heightPx: number;\n}): DrawingAnchor {\n  const from = typeof opts.from === 'string' ? anchorMarkerFromCellRef(opts.from) : opts.from;\n  return {\n    kind: 'oneCell',\n    from,\n    ext: { cx: emuFromPx(opts.widthPx), cy: emuFromPx(opts.heightPx) },\n  };\n}\n\n/**\n * Build a two-cell anchor from cell-ref pairs (or pre-built markers). Defaults\n * to `editAs='twoCell'` — drag both corners with the cells.\n */\nexport function makeTwoCellAnchor(opts: {\n  from: string | AnchorMarker;\n  to: string | AnchorMarker;\n  editAs?: 'twoCell' | 'oneCell' | 'absolute';\n}): DrawingAnchor {\n  const from = typeof opts.from === 'string' ? anchorMarkerFromCellRef(opts.from) : opts.from;\n  const to = typeof opts.to === 'string' ? anchorMarkerFromCellRef(opts.to) : opts.to;\n  return {\n    kind: 'twoCell',\n    from,\n    to,\n    ...(opts.editAs !== undefined ? { editAs: opts.editAs } : {}),\n  };\n}\n","// Spreadsheet drawing data model.\n//\n// A `Drawing` is the per-worksheet `xl/drawings/drawingN.xml` part — a list of\n// anchor entries, each carrying a content variant (chart, picture, shape,\n// connector, group). Charts and pictures are modeled; everything else is kept\n// as the verbatim source XML so it survives a round-trip untouched.\n\nimport type { ChartSpace } from '../chart/chart.js';\nimport type { CxChartSpace } from '../chart/cx/chartex.js';\nimport type { DrawingAnchor } from './anchor.js';\nimport type { ShapeProperties } from './dml/shape-properties.js';\nimport type { XlsxImage } from './image.js';\n\n/** Reference to a chart part — the chart's drawing-rels rId resolves to xl/charts/chartN.xml. */\nexport interface ChartReference {\n  /** Drawing-rels rId pointing at the chart part. Populated on read; the writer assigns its own. */\n  rId?: string;\n  /**\n   * Legacy ECMA-376 chart payload (`c:chartSpace`). Stage-1 supports BarChart\n   * end-to-end; other chart kinds populate this field as their parsers /\n   * writers land.\n   */\n  space?: ChartSpace;\n  /**\n   * Excel-2016 chartex payload (`cx:chartSpace`). Mutually exclusive with\n   * {@link space} for any given drawing item; the parser sniffs the root\n   * element and populates whichever is appropriate.\n   */\n  cxSpace?: CxChartSpace;\n  /**\n   * `true` when the resolved chart part is a chartex (`cx:`) chart. Set by the\n   * package writer so the drawing emitter knows to use the chartex\n   * `<a:graphicData uri>` instead of the legacy chart URI — Excel rejects the\n   * workbook when the URI doesn't match the chart's actual root namespace.\n   */\n  isCx?: boolean;\n}\n\n/** Reference to an embedded picture inside a worksheet drawing. */\nexport interface PictureReference {\n  /** Drawing-rels rId pointing at the embedded image. Populated on read; the writer assigns its own. */\n  rId?: string;\n  /** Resolved image bytes + metadata. Populated on read; the writer reads it back. */\n  image?: XlsxImage;\n  /** Picture display name (`<xdr:cNvPr name=\"...\">`). */\n  name?: string;\n  /** Optional alt-text description. */\n  descr?: string;\n  /** Hidden flag (`<xdr:cNvPr hidden=\"1\"/>`). */\n  hidden?: boolean;\n  /** Per-picture shape properties (extra fill / line / rotation). */\n  spPr?: ShapeProperties;\n}\n\nexport interface DrawingItem {\n  anchor: DrawingAnchor;\n  content:\n    | { kind: 'chart'; chart: ChartReference }\n    | { kind: 'picture'; picture: PictureReference }\n    | { kind: 'unsupported'; rawTag: string };\n  /**\n   * The whole source anchor element, captured verbatim. Set by the reader for\n   * `unsupported` content — a plain shape, a group, a connector — because the\n   * model has no slot for its geometry, text or `<xdr:clientData>` attributes.\n   * When present the writer emits it as-is instead of rebuilding the anchor\n   * from {@link anchor} + {@link content}.\n   */\n  raw?: import('../xml/tree.js').XmlNode;\n}\n\nexport interface Drawing {\n  items: DrawingItem[];\n  /**\n   * `<xdr:wsDr>` children that aren't anchors — in practice Excel's\n   * `<mc:AlternateContent>` wrapper around an anchor that needs a newer\n   * feature. Kept verbatim together with the `items` index they sat before, so\n   * document order (which is z-order) survives a round-trip.\n   */\n  rawChildren?: Array<{ beforeItem: number; node: import('../xml/tree.js').XmlNode }>;\n  /**\n   * Drawing-rels entries the verbatim nodes above reference (`r:embed` on a\n   * picture inside a group, `r:id` on a shape's hyperlink, …). Carried over\n   * from the source part under their original ids so those references still\n   * resolve after a re-save; the writer allocates its own ids around them.\n   */\n  rawRels?: import('../packaging/relationships.js').Relationships;\n}\n\nexport function makeDrawing(items: DrawingItem[] = []): Drawing {\n  return { items };\n}\n\nexport function makeChartDrawingItem(anchor: DrawingAnchor, chart: ChartReference = {}): DrawingItem {\n  return { anchor, content: { kind: 'chart', chart } };\n}\n\nexport function makePictureDrawingItem(anchor: DrawingAnchor, picture: PictureReference | XlsxImage): DrawingItem {\n  // Distinguish raw image bytes from a full PictureReference by checking the\n  // discriminator: XlsxImage carries `format`, PictureReference doesn't.\n  const ref: PictureReference = 'format' in picture ? { image: picture as XlsxImage } : (picture as PictureReference);\n  return { anchor, content: { kind: 'picture', picture: ref } };\n}\n\n// ---- Worksheet ergonomic helpers ----------------------------------------\n\nimport { loadImage } from './image.js';\nimport { makeOneCellAnchor } from './anchor.js';\nimport type { Worksheet } from '../worksheet/worksheet.js';\n\n/**\n * Drop an image onto a worksheet at a single-cell anchor. Lazy-allocates\n * `ws.drawing` (as `makeDrawing([])`) on first call and appends a picture\n * DrawingItem.\n *\n * `image` accepts either an `XlsxImage` (already loaded via `loadImage`) or raw\n * image bytes — in the bytes case, this helper sniffs the format with\n * `loadImage` itself.\n *\n * `at` is a cell ref like `\"C3\"`. Override `widthPx` / `heightPx` to scale;\n * otherwise the helper uses 96×96 defaults that look fine for typical icons.\n */\nexport const addImageAt = (\n  ws: Worksheet,\n  at: string,\n  image: XlsxImage | Uint8Array,\n  opts: { widthPx?: number; heightPx?: number } = {},\n): DrawingItem => {\n  const xlsxImage: XlsxImage = image instanceof Uint8Array ? loadImage(image) : image;\n  const anchor = makeOneCellAnchor({\n    from: at,\n    widthPx: opts.widthPx ?? 96,\n    heightPx: opts.heightPx ?? 96,\n  });\n  const item = makePictureDrawingItem(anchor, xlsxImage);\n  if (!ws.drawing) ws.drawing = makeDrawing([]);\n  ws.drawing.items.push(item);\n  return item;\n};\n\n/**\n * Anchor a chart to a worksheet at a single-cell ref. Lazy-allocates\n * `ws.drawing`. `chart` is the same `ChartReference` shape `makeChart\n * DrawingItem` accepts (`{ space }` for legacy chart, `{ cxSpace }` for\n * chartex).\n */\nexport const addChartAt = (\n  ws: Worksheet,\n  at: string,\n  chart: ChartReference,\n  opts: { widthPx?: number; heightPx?: number } = {},\n): DrawingItem => {\n  const anchor = makeOneCellAnchor({\n    from: at,\n    widthPx: opts.widthPx ?? 480,\n    heightPx: opts.heightPx ?? 320,\n  });\n  const item = makeChartDrawingItem(anchor, chart);\n  if (!ws.drawing) ws.drawing = makeDrawing([]);\n  ws.drawing.items.push(item);\n  return item;\n};\n\n/**\n * Read-only snapshot of every picture DrawingItem on the sheet. Returns the\n * matching items (each with its anchor + picture reference). Empty array when\n * the sheet has no drawing or only non-picture items.\n */\nexport const listImagesOnSheet = (ws: Worksheet): ReadonlyArray<DrawingItem> => {\n  if (!ws.drawing) return [];\n  return ws.drawing.items.filter((it) => it.content.kind === 'picture');\n};\n\n/**\n * Read-only snapshot of every chart DrawingItem on the sheet. Each item has its\n * anchor + chart reference.\n */\nexport const listChartsOnSheet = (ws: Worksheet): ReadonlyArray<DrawingItem> => {\n  if (!ws.drawing) return [];\n  return ws.drawing.items.filter((it) => it.content.kind === 'chart');\n};\n\n/**\n * Drop every DrawingItem from the worksheet. Returns the count removed. The\n * `ws.drawing` field itself is left in place (empty) so subsequent `addImageAt`\n * / `addChartAt` calls don't have to re-allocate.\n */\nexport const removeAllDrawingItems = (ws: Worksheet): number => {\n  if (!ws.drawing) return 0;\n  const n = ws.drawing.items.length;\n  ws.drawing.items = [];\n  return n;\n};\n\n/**\n * Drop every picture DrawingItem from the worksheet, leaving charts and any\n * other content kinds untouched. Returns the count removed.\n */\nexport const removeAllImages = (ws: Worksheet): number => {\n  if (!ws.drawing) return 0;\n  const before = ws.drawing.items.length;\n  ws.drawing.items = ws.drawing.items.filter((it) => it.content.kind !== 'picture');\n  return before - ws.drawing.items.length;\n};\n\n/**\n * Drop every chart DrawingItem from the worksheet, leaving pictures and any\n * other content kinds untouched. Returns the count removed.\n */\nexport const removeAllCharts = (ws: Worksheet): number => {\n  if (!ws.drawing) return 0;\n  const before = ws.drawing.items.length;\n  ws.drawing.items = ws.drawing.items.filter((it) => it.content.kind !== 'chart');\n  return before - ws.drawing.items.length;\n};\n"],"mappings":"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"}

package/dist/drawing.mjs

@@ -1,4 +1,4 @@
-import { a as makeChartDrawingItem, c as removeAllCharts, f as makeOneCellAnchor, h as loadImage, i as listImagesOnSheet, l as removeAllDrawingItems, n as addImageAt, o as makeDrawing, r as listChartsOnSheet, s as makePictureDrawingItem, t as addChartAt, u as removeAllImages } from "./drawing-BxzLuryn.mjs";
+import { a as makeChartDrawingItem, c as removeAllCharts, f as makeOneCellAnchor, h as loadImage, i as listImagesOnSheet, l as removeAllDrawingItems, n as addImageAt, o as makeDrawing, r as listChartsOnSheet, s as makePictureDrawingItem, t as addChartAt, u as removeAllImages } from "./drawing-ZJ3h4VHD.mjs";
 import { a as makeSchemeColor, i as makeColor, n as VALUED_COLOR_MOD_KINDS, o as makeSrgbColor, r as VALUELESS_COLOR_MOD_KINDS, t as SCHEME_COLOR_NAMES } from "./colors-ovWAwnZI.mjs";
 //#region src/drawing/dml/shape-properties.ts
 const makeShapeProperties = (opts = {}) => ({

package/dist/{inference-BrI9uIY4.mjs → inference-BMvv9cUY.mjs}

@@ -1,3 +1,18 @@
+//#region src/utils/formula-text.ts
+const EQUALS_SIGN_CODE = 61;
+/** True iff `text` is spelled the way a spreadsheet UI shows a formula. */
+function startsWithEquals(text) {
+	return text.charCodeAt(0) === EQUALS_SIGN_CODE;
+}
+/**
+* Drop the leading `=` OOXML formula text must not carry, and the whitespace
+* around it: `' =SUM(A1)'` would otherwise keep the `=` in the stored text.
+*/
+function normalizeFormulaText(text) {
+	const trimmed = text.trim();
+	return startsWithEquals(trimmed) ? trimmed.slice(1).trim() : trimmed;
+}
+//#endregion
 //#region src/utils/inference.ts
 /** Excel error tokens. Anything outside this set is treated as a string. */
 const ERROR_CODES = /* @__PURE__ */ new Set([
@@ -30,13 +45,13 @@ function inferCellType(value) {
 	if (typeof value === "number") return "n";
 	if (value instanceof Date) return "d";
 	if (typeof value === "string") {
-		if (value.length > 0 && value.charCodeAt(0) === 61) return "f";
+		if (startsWithEquals(value)) return "f";
 		if (ERROR_CODES.has(value)) return "e";
 		return "s";
 	}
 	return "n";
 }
 //#endregion
-export { inferCellType as n, ERROR_CODES as t };
+export { startsWithEquals as i, inferCellType as n, normalizeFormulaText as r, ERROR_CODES as t };
 
-//# sourceMappingURL=inference-BrI9uIY4.mjs.map
+//# sourceMappingURL=inference-BMvv9cUY.mjs.map

package/dist/inference-BMvv9cUY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference-BMvv9cUY.mjs","names":[],"sources":["../src/utils/formula-text.ts","../src/utils/inference.ts"],"sourcesContent":["// Formula-text normalisation, shared by every path that carries a formula.\n//\n// A spreadsheet UI shows `=SUM(A1:A3)`, but OOXML stores the text without the\n// leading `=` (ECMA-376 §18.3.1.40) in `<f>`, `<formula1>`, `<cfRule>`'s\n// `<formula>` and `<definedName>` alike, and Excel reports a file that carries\n// one as damaged. The `make*` constructors normalise what a caller hands them,\n// and the serialisers normalise again: the model interfaces are public, so a\n// caller can build one as a literal and reach the writer without passing a\n// constructor.\n\nconst EQUALS_SIGN_CODE = 61;\n\n/** True iff `text` is spelled the way a spreadsheet UI shows a formula. */\nexport function startsWithEquals(text: string): boolean {\n  return text.charCodeAt(0) === EQUALS_SIGN_CODE;\n}\n\n/**\n * Drop the leading `=` OOXML formula text must not carry, and the whitespace\n * around it: `' =SUM(A1)'` would otherwise keep the `=` in the stored text.\n */\nexport function normalizeFormulaText(text: string): string {\n  const trimmed = text.trim();\n  return startsWithEquals(trimmed) ? trimmed.slice(1).trim() : trimmed;\n}\n","// Cell-value type inference. Maps a JS runtime value to the OOXML cell\n// `t` attribute value. Mirrors openpyxl's `Cell._bind_value` /\n// `_TYPES` / error-code path in openpyxl/openpyxl/cell/cell.py.\n\nimport { startsWithEquals } from './formula-text.js';\n\n/**\n * OOXML `t` attribute values. Note that 'inlineStr' is treated\n * separately — the writer chooses between 's' (shared string) and\n * 'inlineStr' based on workbook settings, not the value itself.\n */\nexport type CellDataType = 'n' | 's' | 'b' | 'd' | 'f' | 'e';\n\n/** Excel error tokens. Anything outside this set is treated as a string. */\nexport const ERROR_CODES: ReadonlySet<string> = new Set([\n  '#NULL!',\n  '#DIV/0!',\n  '#VALUE!',\n  '#REF!',\n  '#NAME?',\n  '#NUM!',\n  '#N/A',\n  '#GETTING_DATA',\n]);\n\n/**\n * Infer the cell `t` attribute for a runtime value.\n *\n * - `boolean` → 'b'\n * - `number` → 'n' (incl. integer numerics; date inference is left to\n *   the caller because Excel decides on type via the cell's number\n *   format, not the raw value)\n * - `Date` → 'd'\n * - string starting with `=` → 'f' (formula)\n * - string in {@link ERROR_CODES} → 'e'\n * - any other string → 's'\n * - `null` / `undefined` → 'n' (empty)\n *\n * Throws nothing — returns 'n' as the no-information fallback.\n */\nexport function inferCellType(value: unknown): CellDataType {\n  if (typeof value === 'boolean') return 'b';\n  if (typeof value === 'number') return 'n';\n  if (value instanceof Date) return 'd';\n  if (typeof value === 'string') {\n    if (startsWithEquals(value)) return 'f';\n    if (ERROR_CODES.has(value)) return 'e';\n    return 's';\n  }\n  return 'n';\n}\n"],"mappings":";AAUA,MAAM,mBAAmB;;AAGzB,SAAgB,iBAAiB,MAAuB;CACtD,OAAO,KAAK,WAAW,CAAC,MAAM;AAChC;;;;;AAMA,SAAgB,qBAAqB,MAAsB;CACzD,MAAM,UAAU,KAAK,KAAK;CAC1B,OAAO,iBAAiB,OAAO,IAAI,QAAQ,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;AAC/D;;;;ACVA,MAAa,8BAAmC,IAAI,IAAI;CACtD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;;;;;;;;;;AAiBD,SAAgB,cAAc,OAA8B;CAC1D,IAAI,OAAO,UAAU,WAAW,OAAO;CACvC,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,iBAAiB,MAAM,OAAO;CAClC,IAAI,OAAO,UAAU,UAAU;EAC7B,IAAI,iBAAiB,KAAK,GAAG,OAAO;EACpC,IAAI,YAAY,IAAI,KAAK,GAAG,OAAO;EACnC,OAAO;CACT;CACA,OAAO;AACT"}

package/dist/io/save.d.ts

@@ -1,8 +1,20 @@
 import type { XlsxSink } from '../io/sink.js';
 import { type Workbook } from '../workbook/workbook.js';
+import { type CompressionLevel } from '../zip/writer.js';
 export interface SaveOptions {
-    /** Reserved — passes through to the underlying ZIP writer when implemented. */
-    compressionLevel?: number;
+    /**
+     * Last-modified timestamp for every ZIP entry. Left unset, fflate stamps the
+     * wall clock into each local header and central-directory record, so saving
+     * the same workbook twice produces different bytes. Pin it and the output is
+     * byte-identical for identical input on any machine, which is what
+     * golden-file tests and content-addressed caches need.
+     *
+     * Recorded as the date's UTC wall time, to ZIP's two-second resolution; the
+     * year has to fall in 1980-2099, the range supported by the ZIP backend.
+     */
+    mtime?: Date;
+    /** Deflate level, 0 (no compression) to 9 (smallest). Defaults to fflate's own 6. */
+    compressionLevel?: CompressionLevel;
 }
 /** Convenience: serialise a Workbook to an in-memory `Uint8Array` xlsx.
  *
@@ -11,4 +23,4 @@ export interface SaveOptions {
  */
 export declare function workbookToBytes(wb: Workbook, opts?: SaveOptions): Promise<Uint8Array>;
 /** Save a workbook through the given sink. Returns once `finalize()` resolves. */
-export declare function saveWorkbook(wb: Workbook, sink: XlsxSink, _opts?: SaveOptions): Promise<void>;
+export declare function saveWorkbook(wb: Workbook, sink: XlsxSink, opts?: SaveOptions): Promise<void>;

package/dist/io.mjs

@@ -1,6 +1,6 @@
 import { i as OpenXmlIoError } from "./exceptions-D-CFwxgm.mjs";
-import { t as loadWorkbook } from "./load-Bghb1YHY.mjs";
-import { n as workbookToBytes, t as saveWorkbook } from "./save-Bqcf8w3g.mjs";
+import { t as loadWorkbook } from "./load-CJdGh50R.mjs";
+import { n as workbookToBytes, t as saveWorkbook } from "./save-CjarR7Rp.mjs";
 //#region src/io/browser.ts
 /**
 * Wrap a Blob (or File, since File extends Blob) as an XlsxSource. The

package/dist/{load-Bghb1YHY.mjs → load-CJdGh50R.mjs}

@@ -1,13 +1,13 @@
 import { o as OpenXmlSchemaError } from "./exceptions-D-CFwxgm.mjs";
-import { h as loadImage } from "./drawing-BxzLuryn.mjs";
+import { h as loadImage } from "./drawing-ZJ3h4VHD.mjs";
 import { At as parseQName, a as findChildren, c as ARC_CONTENT_TYPES, f as ARC_ROOT_RELS, ft as SHEET_MAIN_NS, g as ARC_WORKBOOK, h as ARC_THEME, i as findChild, jt as qname, l as ARC_CORE, lt as REL_NS, m as ARC_STYLE, p as ARC_SHARED_STRINGS, q as MARKUP_COMPAT_NS, s as ARC_APP, u as ARC_CUSTOM } from "./tree-BX-sRRVp.mjs";
-import { D as findUserShapesRId, O as parseChartXml, T as parseChartExXml, _ as parseChartsheetXml, a as parseCommentsXml, b as parseWorksheetXml, c as NumberFormatSchema, d as BorderSchema, f as AlignmentSchema, h as parseDrawingXml, l as FontSchema, n as parseTableXml, p as collectRawRelIds, s as ProtectionSchema, u as fillFromTree, w as isChartExBytes, x as parseUserShapesXml } from "./stylesheet-writer-HxaX7bGy.mjs";
+import { D as findUserShapesRId, O as parseChartXml, T as parseChartExXml, _ as parseChartsheetXml, a as parseCommentsXml, b as parseWorksheetXml, c as NumberFormatSchema, d as BorderSchema, f as AlignmentSchema, h as parseDrawingXml, l as FontSchema, n as parseTableXml, p as collectRawRelIds, s as ProtectionSchema, u as fillFromTree, w as isChartExBytes, x as parseUserShapesXml } from "./stylesheet-writer-D7Uug85X.mjs";
 import { n as parseXmlDocument, t as parseXml } from "./parser-By6RWZVW.mjs";
 import { t as fromTree } from "./serialize-BC2Wu3bR.mjs";
 import { B as corePropsFromBytes, Q as findById, _ as customPropsFromBytes, c as extendedPropsFromBytes, et as indexRelsById, nt as relsFromBytes, o as manifestFromBytes, tt as makeRelationships } from "./manifest-pLmx7KYh.mjs";
-import { Zt as stableStringify, ft as makeStylesheet } from "./cell-style-DuvS_Lsg.mjs";
-import { k as parseSharedStringsXml, r as createWorkbook } from "./workbook-BlZVXiyG.mjs";
-import { a as makeDefinedName } from "./defined-names-CviWmtQg.mjs";
+import { en as stableStringify, ht as makeStylesheet } from "./cell-style-BFmJOmcx.mjs";
+import { k as parseSharedStringsXml, r as createWorkbook } from "./workbook-B15-T4cs.mjs";
+import { a as makeDefinedName } from "./defined-names-Ctu3F6ls.mjs";
 import { t as openZip } from "./reader-BNaUTVCy.mjs";
 //#region src/styles/stylesheet-reader.ts
 const STYLESHEET_TAG = qname(SHEET_MAIN_NS, "styleSheet");
@@ -1169,4 +1169,4 @@ function capturePassthrough(archive, manifest, wb, roots, vml) {
 //#endregion
 export { parseStylesheetXml as i, parseDate1904 as n, resolveRelTarget as r, loadWorkbook as t };
 
-//# sourceMappingURL=load-Bghb1YHY.mjs.map
+//# sourceMappingURL=load-CJdGh50R.mjs.map