@office-kit/xlsx 0.11.0 → 0.11.1

package/dist/workbook.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"workbook.mjs","names":[],"sources":["../src/workbook/protection.ts","../src/workbook/views.ts","../src/workbook/calc-properties.ts","../src/workbook/workbook-properties.ts","../src/workbook/file-version.ts","../src/workbook/file-sharing.ts","../src/workbook/file-recovery.ts","../src/workbook/smart-tags.ts","../src/workbook/function-groups.ts"],"sourcesContent":["// Workbook-level <workbookProtection>. Per ECMA-376 §18.2.29 and (workbook\n// side).\n//\n// Two parallel password-hash quadruples cover Excel's \"Protect Workbook\"\n// dialog: one set locks structure / window resize, the other locks the\n// revision-tracking history. The wire-form attrs round-trip verbatim —\n// computing a fresh hash from a plaintext password lives behind a future helper\n// (D-tier in the roadmap).\n//\n// Note: the non-hash `workbookPassword` / `revisionsPassword` attrs are the\n// legacy Excel 97/2000 hex hash form. Modern files use the `*HashValue` +\n// `*SaltValue` + `*SpinCount` + `*AlgorithmName` quad instead.\n\nexport interface WorkbookProtection {\n  /** Legacy 16-bit hex hash of the workbook password (\"CC1A\" etc.). */\n  workbookPassword?: string;\n  workbookPasswordCharacterSet?: string;\n  workbookAlgorithmName?: string;\n  workbookHashValue?: string;\n  workbookSaltValue?: string;\n  workbookSpinCount?: number;\n  /** Legacy 16-bit hex hash of the revisions-tracking password. */\n  revisionsPassword?: string;\n  revisionsPasswordCharacterSet?: string;\n  revisionsAlgorithmName?: string;\n  revisionsHashValue?: string;\n  revisionsSaltValue?: string;\n  revisionsSpinCount?: number;\n  /** Lock add/delete/move/rename/hide of sheets. */\n  lockStructure?: boolean;\n  /** Lock the workbook window size and position. */\n  lockWindows?: boolean;\n  /** Lock revision tracking — enabled with the \"Track Changes\" feature. */\n  lockRevision?: boolean;\n}\n\nexport const makeWorkbookProtection = (opts: WorkbookProtection = {}): WorkbookProtection => {\n  const out: WorkbookProtection = {};\n  for (const k of [\n    'workbookPassword',\n    'workbookPasswordCharacterSet',\n    'workbookAlgorithmName',\n    'workbookHashValue',\n    'workbookSaltValue',\n    'revisionsPassword',\n    'revisionsPasswordCharacterSet',\n    'revisionsAlgorithmName',\n    'revisionsHashValue',\n    'revisionsSaltValue',\n  ] as const) {\n    if (opts[k] !== undefined) out[k] = opts[k];\n  }\n  if (opts.workbookSpinCount !== undefined) out.workbookSpinCount = opts.workbookSpinCount;\n  if (opts.revisionsSpinCount !== undefined) out.revisionsSpinCount = opts.revisionsSpinCount;\n  if (opts.lockStructure !== undefined) out.lockStructure = opts.lockStructure;\n  if (opts.lockWindows !== undefined) out.lockWindows = opts.lockWindows;\n  if (opts.lockRevision !== undefined) out.lockRevision = opts.lockRevision;\n  return out;\n};\n\n// ---- Workbook ergonomic helpers -----------------------------------------\n\nimport type { Workbook } from './workbook';\n\n/**\n * Lock the workbook with Excel's \"Protect Workbook → Structure\" default\n * (lockStructure=true). Pass `overrides` to also lock windows /\n * revision-tracking, or to attach a password-hash quad. Plaintext password\n * support is deferred until the D-tier hashing helper lands.\n */\nexport const protectWorkbook = (\n  wb: Workbook,\n  overrides: Partial<WorkbookProtection> = {},\n): WorkbookProtection => {\n  wb.workbookProtection = { lockStructure: true, ...overrides };\n  return wb.workbookProtection;\n};\n\n/** Drop the workbook-protection record entirely. */\nexport const unprotectWorkbook = (wb: Workbook): void => {\n  delete (wb as { workbookProtection?: WorkbookProtection }).workbookProtection;\n};\n\n/** True iff `lockStructure === true`. */\nexport const isWorkbookProtected = (wb: Workbook): boolean =>\n  wb.workbookProtection?.lockStructure === true;\n","// Workbook-level <bookViews> typed model. Per ECMA-376 §18.2.30 and\n// openpyxl/openpyxl/workbook/views.py.\n//\n// `<bookViews>` carries one or more `<workbookView>` entries. The\n// first entry drives Excel's default tab strip (firstSheet / activeTab)\n// and window position. Most workbooks have exactly one entry.\n\nexport type WorkbookViewVisibility = 'visible' | 'hidden' | 'veryHidden';\n\nexport interface WorkbookView {\n  visibility?: WorkbookViewVisibility;\n  minimized?: boolean;\n  showHorizontalScroll?: boolean;\n  showVerticalScroll?: boolean;\n  showSheetTabs?: boolean;\n  /** Window x position in screen pixels — Excel restores it when re-opening. */\n  xWindow?: number;\n  /** Window y position. */\n  yWindow?: number;\n  windowWidth?: number;\n  windowHeight?: number;\n  /** Width of the sheet tab strip relative to the horizontal scroll bar (0..1000, default 600). */\n  tabRatio?: number;\n  /** Index of the leftmost visible sheet tab (0-based). */\n  firstSheet?: number;\n  /** Index of the currently active sheet tab (0-based). */\n  activeTab?: number;\n  autoFilterDateGrouping?: boolean;\n  /**\n   * Namespaced attributes outside SpreadsheetML, keyed in Clark notation\n   * (`{ns}local`). Excel writes `xr2:uid=\"{…}\"` here to tie the view to its\n   * revision-tracking record; kept verbatim because the model has no slot for\n   * it and dropping it changes what Excel reads back.\n   */\n  extAttrs?: Readonly<Record<string, string>>;\n}\n\nexport const makeWorkbookView = (opts: WorkbookView = {}): WorkbookView => ({ ...opts });\n\nexport type CustomViewShowComments = 'commNone' | 'commIndicator' | 'commIndAndComment';\nexport type CustomViewShowObjects = 'all' | 'placeholders' | 'none';\n\nexport interface CustomWorkbookView {\n  name: string;\n  guid: string;\n  /** Window width in screen pixels — required when the element is present. */\n  windowWidth: number;\n  windowHeight: number;\n  /** Index (0-based) of the sheet active in this saved view. */\n  activeSheetId: number;\n  autoUpdate?: boolean;\n  /** Auto-merge interval in minutes (for shared workbooks). */\n  mergeInterval?: number;\n  changesSavedWin?: boolean;\n  onlySync?: boolean;\n  personalView?: boolean;\n  includePrintSettings?: boolean;\n  includeHiddenRowCol?: boolean;\n  maximized?: boolean;\n  minimized?: boolean;\n  showHorizontalScroll?: boolean;\n  showVerticalScroll?: boolean;\n  showSheetTabs?: boolean;\n  xWindow?: number;\n  yWindow?: number;\n  tabRatio?: number;\n  showFormulaBar?: boolean;\n  showStatusbar?: boolean;\n  showComments?: CustomViewShowComments;\n  showObjects?: CustomViewShowObjects;\n}\n\nexport const makeCustomWorkbookView = (\n  opts: Pick<CustomWorkbookView, 'name' | 'guid' | 'windowWidth' | 'windowHeight' | 'activeSheetId'> &\n    Partial<CustomWorkbookView>,\n): CustomWorkbookView => ({ ...opts });\n\nimport type { Workbook } from './workbook';\n\n/**\n * Get-or-create the primary `<workbookView>` entry. Most workbooks have\n * exactly one `<workbookView>`; this helper is the right place to hang\n * tab-strip / window state edits without forcing the caller to allocate\n * the array themselves.\n */\nconst ensurePrimaryView = (wb: Workbook): WorkbookView => {\n  const existing = wb.bookViews?.[0];\n  if (existing) return existing;\n  const fresh = makeWorkbookView();\n  wb.bookViews = [fresh];\n  return fresh;\n};\n\n/** Get the index of the active sheet tab (0-based) from the primary workbookView, or 0 if unset. */\nexport const getActiveTab = (wb: Workbook): number => wb.bookViews?.[0]?.activeTab ?? 0;\n\n/** Set the active sheet tab (0-based) on the primary workbookView. */\nexport const setActiveTab = (wb: Workbook, index: number): void => {\n  ensurePrimaryView(wb).activeTab = index;\n};\n\n/** Get the index of the leftmost visible sheet tab from the primary workbookView, or 0 if unset. */\nexport const getFirstSheet = (wb: Workbook): number => wb.bookViews?.[0]?.firstSheet ?? 0;\n\n/** Set the leftmost visible sheet tab on the primary workbookView. */\nexport const setFirstSheet = (wb: Workbook, index: number): void => {\n  ensurePrimaryView(wb).firstSheet = index;\n};\n\n/** Set the tab strip width ratio (0..1000, Excel default 600). */\nexport const setTabRatio = (wb: Workbook, ratio: number): void => {\n  ensurePrimaryView(wb).tabRatio = ratio;\n};\n\n/** Toggle the sheet tab strip visibility. */\nexport const setShowSheetTabs = (wb: Workbook, show: boolean): void => {\n  ensurePrimaryView(wb).showSheetTabs = show;\n};\n\n/** Toggle the horizontal scroll bar in Excel's window chrome. */\nexport const setShowHorizontalScroll = (wb: Workbook, show: boolean): void => {\n  ensurePrimaryView(wb).showHorizontalScroll = show;\n};\n\n/** Toggle the vertical scroll bar in Excel's window chrome. */\nexport const setShowVerticalScroll = (wb: Workbook, show: boolean): void => {\n  ensurePrimaryView(wb).showVerticalScroll = show;\n};\n\n/**\n * Toggle the workbook window minimised state. Excel honours this on\n * reopen so the file restores into the minimised state it was saved\n * with.\n */\nexport const setWorkbookMinimized = (wb: Workbook, minimized: boolean): void => {\n  ensurePrimaryView(wb).minimized = minimized;\n};\n\n/** Set the visibility of the workbook window itself ('visible' / 'hidden' / 'veryHidden'). */\nexport const setWorkbookVisibility = (wb: Workbook, visibility: WorkbookViewVisibility): void => {\n  ensurePrimaryView(wb).visibility = visibility;\n};\n\n/**\n * Set window position + size on the primary workbookView in one call.\n * Pass `undefined` for any axis to leave it untouched.\n */\nexport const setWorkbookWindow = (\n  wb: Workbook,\n  opts: { xWindow?: number; yWindow?: number; windowWidth?: number; windowHeight?: number },\n): void => {\n  const v = ensurePrimaryView(wb);\n  if (opts.xWindow !== undefined) v.xWindow = opts.xWindow;\n  if (opts.yWindow !== undefined) v.yWindow = opts.yWindow;\n  if (opts.windowWidth !== undefined) v.windowWidth = opts.windowWidth;\n  if (opts.windowHeight !== undefined) v.windowHeight = opts.windowHeight;\n};\n","// Workbook-level <calcPr>. Per ECMA-376 §18.2.2.\n//\n// `calcId` is a build identifier Excel uses to decide whether to force\n// a recalc when re-opening; modern Excel treats any value as \"use\n// what's there\". The other attrs cover Excel's calculation options\n// (Tools → Options → Formulas).\n\nexport type CalcMode = 'manual' | 'auto' | 'autoNoTable';\nexport type RefMode = 'A1' | 'R1C1';\n\nexport interface CalcProperties {\n  /** Excel build/calc-engine identifier; OpenOffice sets 191621, Excel 2016+ 162913 etc. */\n  calcId?: number;\n  calcMode?: CalcMode;\n  /** Force a full recalc when the workbook is loaded. Excel default `true` for safety. */\n  fullCalcOnLoad?: boolean;\n  refMode?: RefMode;\n  /** Allow circular references via iterative calculation. */\n  iterate?: boolean;\n  iterateCount?: number;\n  iterateDelta?: number;\n  /** Use full 15-digit precision (vs. displayed precision). */\n  fullPrecision?: boolean;\n  calcCompleted?: boolean;\n  /** Run a recalc on save. */\n  calcOnSave?: boolean;\n  /** Use multi-threaded calculation. */\n  concurrentCalc?: boolean;\n  concurrentManualCount?: number;\n  /** Force a full recalc on next interaction. */\n  forceFullCalc?: boolean;\n}\n\nexport const makeCalcProperties = (opts: CalcProperties = {}): CalcProperties => ({ ...opts });\n\n// ---- Workbook ergonomic helpers ----------------------------------------\n\nimport type { Workbook } from './workbook';\n\nconst ensureCalcProperties = (wb: Workbook): CalcProperties => {\n  if (!wb.calcProperties) wb.calcProperties = {};\n  return wb.calcProperties;\n};\n\n/**\n * Set the recalculation mode. `'auto'` is Excel's default;\n * `'manual'` requires F9 to recompute formulas; `'autoNoTable'`\n * recomputes everything except data-table cells.\n */\nexport const setCalcMode = (wb: Workbook, mode: CalcMode): void => {\n  ensureCalcProperties(wb).calcMode = mode;\n};\n\n/**\n * Toggle iterative calculation (Excel's \"Enable iterative calculation\"\n * option). When `enable` is true and `count` / `delta` are provided,\n * they replace the default Excel limits (100 iterations, 0.001 delta).\n */\nexport const setIterativeCalc = (\n  wb: Workbook,\n  enable: boolean,\n  opts: { count?: number; delta?: number } = {},\n): void => {\n  const calc = ensureCalcProperties(wb);\n  calc.iterate = enable;\n  if (opts.count !== undefined) calc.iterateCount = opts.count;\n  if (opts.delta !== undefined) calc.iterateDelta = opts.delta;\n};\n\n/** Toggle \"Recalculate workbook before saving\" (workbook-level). */\nexport const setCalcOnSave = (wb: Workbook, on: boolean): void => {\n  ensureCalcProperties(wb).calcOnSave = on;\n};\n\n/** Toggle \"Recalculate workbook on load\" — forces a full recalc on open. */\nexport const setFullCalcOnLoad = (wb: Workbook, on: boolean): void => {\n  ensureCalcProperties(wb).fullCalcOnLoad = on;\n};\n\n/** Toggle \"Set precision as displayed\" (false = full 15-digit precision). */\nexport const setFullPrecision = (wb: Workbook, on: boolean): void => {\n  ensureCalcProperties(wb).fullPrecision = on;\n};\n","// Workbook-level <workbookPr>. Per ECMA-376 §18.2.28.\n//\n// Mirrors openpyxl/openpyxl/workbook/properties.py WorkbookProperties.\n// `date1904` is already lifted via wb.date1904; everything else lived\n// in workbookXmlExtras passthrough until now. This typed shell promotes\n// all 19 attrs into the modeled workbook so consumers can edit them\n// without rebuilding the XmlNode.\n\nexport type ShowObjectsMode = 'all' | 'placeholders' | 'none';\nexport type UpdateLinksMode = 'userSet' | 'never' | 'always';\n\nexport interface WorkbookProperties {\n  /**\n   * Mac 1904 epoch flag. Mirrored from `Workbook.date1904` — the\n   * canonical source. Setting it here has no effect on the cell-serial\n   * conversion path, which keys off the top-level field.\n   */\n  date1904?: boolean;\n  /** Excel 5/95 ↔ 2007 compatibility hint. */\n  dateCompatibility?: boolean;\n  showObjects?: ShowObjectsMode;\n  showBorderUnselectedTables?: boolean;\n  filterPrivacy?: boolean;\n  promptedSolutions?: boolean;\n  showInkAnnotation?: boolean;\n  backupFile?: boolean;\n  /** Cache external-link values when saving. */\n  saveExternalLinkValues?: boolean;\n  /** \"Update remote links\" prompt mode. */\n  updateLinks?: UpdateLinksMode;\n  /** VBA codeName for the workbook (e.g. \"ThisWorkbook\" / \"ЭтаКнига\"). */\n  codeName?: string;\n  hidePivotFieldList?: boolean;\n  showPivotChartFilter?: boolean;\n  allowRefreshQuery?: boolean;\n  publishItems?: boolean;\n  checkCompatibility?: boolean;\n  autoCompressPictures?: boolean;\n  refreshAllConnections?: boolean;\n  /** Theme schema version (Excel 2007 = 124226, 2013+ = 153222). */\n  defaultThemeVersion?: number;\n}\n\nexport const makeWorkbookProperties = (opts: WorkbookProperties = {}): WorkbookProperties => ({ ...opts });\n\n// ---- Workbook ergonomic helpers ----------------------------------------\n\nimport type { Workbook } from './workbook';\n\nconst ensureWorkbookProperties = (wb: Workbook): WorkbookProperties => {\n  if (!wb.workbookProperties) wb.workbookProperties = {};\n  return wb.workbookProperties;\n};\n\n/**\n * Set the workbook-level VBA codeName (\"ThisWorkbook\" by default in\n * Excel; localised forms like \"ЭтаКнига\" round-trip too). Empty string\n * is allowed — Excel writes it that way for codename-stripped files.\n */\nexport const setWorkbookCodeName = (wb: Workbook, codeName: string): void => {\n  ensureWorkbookProperties(wb).codeName = codeName;\n};\n\n/**\n * Toggle the Mac 1904 epoch. The canonical flag is `wb.date1904`\n * (drives cell-serial conversion); this helper writes both the\n * canonical field and the mirror on `workbookProperties` so a save\n * emits a consistent `<workbookPr date1904=\"…\">` attribute.\n */\nexport const setDate1904 = (wb: Workbook, on: boolean): void => {\n  wb.date1904 = on;\n  ensureWorkbookProperties(wb).date1904 = on;\n};\n\n/**\n * Set the \"Update remote links\" prompt mode. `'userSet'` keeps\n * Excel's per-user preference; `'never'` disables the prompt;\n * `'always'` forces it. Mirrors the Trust Center \"External Content\"\n * dropdown.\n */\nexport const setUpdateLinksMode = (wb: Workbook, mode: UpdateLinksMode): void => {\n  ensureWorkbookProperties(wb).updateLinks = mode;\n};\n\n/** Toggle the \"filterPrivacy\" hint Excel writes to indicate filter contents may be sensitive. */\nexport const setFilterPrivacy = (wb: Workbook, on: boolean): void => {\n  ensureWorkbookProperties(wb).filterPrivacy = on;\n};\n","// Workbook-level <fileVersion>. Per ECMA-376 §18.2.13.\n//\n// Carries Microsoft Office app/version metadata that Excel writes\n// when it saves; round-tripping these values keeps the file looking\n// like Excel's own output to downstream tools that sniff them.\n\nexport interface FileVersion {\n  /** Application that last saved the workbook (\"xl\" for Excel). */\n  appName?: string;\n  /** Build number of the last editor (e.g. \"7.5210\"). */\n  lastEdited?: string;\n  /** Build number of the lowest editor (oldest Excel that touched the file). */\n  lowestEdited?: string;\n  /** Internal \"rolled-up build\" number. */\n  rupBuild?: string;\n  /** GUID identifying the file content (Excel uses it to detect re-saves). */\n  codeName?: string;\n}\n\nexport const makeFileVersion = (opts: FileVersion = {}): FileVersion => ({ ...opts });\n","// Workbook-level <fileSharing>. Per ECMA-376 §18.2.12.\n//\n// Carries the workbook's read-only / write-protection settings (Save\n// As → Tools → General Options → \"Modify password\" / \"Read-only\n// recommended\"). The hash quad mirrors sheetProtection / workbookProtection.\n\nexport interface FileSharing {\n  /** Mark the workbook as \"Read-only recommended\" — Excel pops a dialog on open. */\n  readOnlyRecommended?: boolean;\n  /** Author name attached to the read/write password. */\n  userName?: string;\n  /** Legacy 16-bit hex hash of the reservation password. */\n  reservationPassword?: string;\n  /** Modern hash quad — algorithmName + hashValue + saltValue + spinCount. */\n  algorithmName?: string;\n  hashValue?: string;\n  saltValue?: string;\n  spinCount?: number;\n}\n\nexport const makeFileSharing = (opts: FileSharing = {}): FileSharing => ({ ...opts });\n","// Workbook-level <fileRecoveryPr>. Per ECMA-376 §18.2.11.\n//\n// Excel writes this element after an autorecover sequence to mark the\n// workbook with the recovery state so subsequent opens can prompt the\n// user. Almost always absent in fresh files.\n\nexport interface FileRecoveryProperties {\n  /** True after an autorecover save — Excel uses it to display the recovery banner. */\n  autoRecover?: boolean;\n  /** Persisted crash-recovery flag. */\n  crashSave?: boolean;\n  /** Mark the file as \"data extracted from a damaged workbook\". */\n  dataExtractLoad?: boolean;\n  /** Workbook was repaired during load. */\n  repairLoad?: boolean;\n}\n\nexport const makeFileRecoveryProperties = (\n  opts: FileRecoveryProperties = {},\n): FileRecoveryProperties => ({ ...opts });\n","// Workbook-level <smartTagPr> + <smartTagTypes>. Per ECMA-376 §18.2.26\n// / §18.2.27. Smart tags were Excel 2003's auto-recognized data\n// (stock symbols, dates, names) and are deprecated, but the elements\n// still appear in some legacy workbooks.\n\nexport type SmartTagShowMode = 'all' | 'noIndicator';\n\nexport interface SmartTagProperties {\n  /** Embed smart tags into the workbook on save. */\n  embed?: boolean;\n  show?: SmartTagShowMode;\n}\n\nexport interface SmartTagType {\n  namespaceUri?: string;\n  name?: string;\n  url?: string;\n}\n\nexport const makeSmartTagProperties = (opts: SmartTagProperties = {}): SmartTagProperties => ({ ...opts });\n\nexport const makeSmartTagType = (opts: SmartTagType = {}): SmartTagType => ({ ...opts });\n","// Workbook-level <functionGroups>. Per ECMA-376 §18.2.14.\n//\n// Excel registers built-in function groups (Math/Statistical/Logical/...)\n// implicitly with a `builtInGroupCount` count and supports user-defined\n// XLL function groups appended after that count. Most workbooks don't\n// carry this element at all.\n\nexport interface FunctionGroup {\n  name: string;\n}\n\nexport interface FunctionGroups {\n  /** Number of built-in groups Excel reserves before user entries (default 16). */\n  builtInGroupCount?: number;\n  groups: FunctionGroup[];\n}\n\nexport const makeFunctionGroup = (name: string): FunctionGroup => ({ name });\n\nexport const makeFunctionGroups = (opts: Partial<FunctionGroups> = {}): FunctionGroups => ({\n  groups: opts.groups?.slice() ?? [],\n  ...(opts.builtInGroupCount !== undefined ? { builtInGroupCount: opts.builtInGroupCount } : {}),\n});\n"],"mappings":";;;AAoCA,MAAa,0BAA0B,OAA2B,CAAC,MAA0B;CAC3F,MAAM,MAA0B,CAAC;CACjC,KAAK,MAAM,KAAK;EACd;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,GACE,IAAI,KAAK,OAAO,KAAA,GAAW,IAAI,KAAK,KAAK;CAE3C,IAAI,KAAK,sBAAsB,KAAA,GAAW,IAAI,oBAAoB,KAAK;CACvE,IAAI,KAAK,uBAAuB,KAAA,GAAW,IAAI,qBAAqB,KAAK;CACzE,IAAI,KAAK,kBAAkB,KAAA,GAAW,IAAI,gBAAgB,KAAK;CAC/D,IAAI,KAAK,gBAAgB,KAAA,GAAW,IAAI,cAAc,KAAK;CAC3D,IAAI,KAAK,iBAAiB,KAAA,GAAW,IAAI,eAAe,KAAK;CAC7D,OAAO;AACT;;;ACrBA,MAAa,oBAAoB,OAAqB,CAAC,OAAqB,EAAE,GAAG,KAAK;AAmCtF,MAAa,0BACX,UAEwB,EAAE,GAAG,KAAK;;;AC1CpC,MAAa,sBAAsB,OAAuB,CAAC,OAAuB,EAAE,GAAG,KAAK;;;ACU5F,MAAa,0BAA0B,OAA2B,CAAC,OAA2B,EAAE,GAAG,KAAK;;;ACxBxG,MAAa,mBAAmB,OAAoB,CAAC,OAAoB,EAAE,GAAG,KAAK;;;ACCnF,MAAa,mBAAmB,OAAoB,CAAC,OAAoB,EAAE,GAAG,KAAK;;;ACHnF,MAAa,8BACX,OAA+B,CAAC,OACJ,EAAE,GAAG,KAAK;;;ACAxC,MAAa,0BAA0B,OAA2B,CAAC,OAA2B,EAAE,GAAG,KAAK;AAExG,MAAa,oBAAoB,OAAqB,CAAC,OAAqB,EAAE,GAAG,KAAK;;;ACJtF,MAAa,qBAAqB,UAAiC,EAAE,KAAK;AAE1E,MAAa,sBAAsB,OAAgC,CAAC,OAAuB;CACzF,QAAQ,KAAK,QAAQ,MAAM,KAAK,CAAC;CACjC,GAAI,KAAK,sBAAsB,KAAA,IAAY,EAAE,mBAAmB,KAAK,kBAAkB,IAAI,CAAC;AAC9F"}
+{"version":3,"file":"workbook.mjs","names":[],"sources":["../src/workbook/protection.ts","../src/workbook/views.ts","../src/workbook/calc-properties.ts","../src/workbook/workbook-properties.ts","../src/workbook/file-version.ts","../src/workbook/file-sharing.ts","../src/workbook/file-recovery.ts","../src/workbook/smart-tags.ts","../src/workbook/function-groups.ts"],"sourcesContent":["// Workbook-level <workbookProtection>. Per ECMA-376 §18.2.29 and (workbook\n// side).\n//\n// Two parallel password-hash quadruples cover Excel's \"Protect Workbook\"\n// dialog: one set locks structure / window resize, the other locks the\n// revision-tracking history. The wire-form attrs round-trip verbatim —\n// computing a fresh hash from a plaintext password lives behind a future helper\n// (D-tier in the roadmap).\n//\n// Note: the non-hash `workbookPassword` / `revisionsPassword` attrs are the\n// legacy Excel 97/2000 hex hash form. Modern files use the `*HashValue` +\n// `*SaltValue` + `*SpinCount` + `*AlgorithmName` quad instead.\n\nexport interface WorkbookProtection {\n  /** Legacy 16-bit hex hash of the workbook password (\"CC1A\" etc.). */\n  workbookPassword?: string;\n  workbookPasswordCharacterSet?: string;\n  workbookAlgorithmName?: string;\n  workbookHashValue?: string;\n  workbookSaltValue?: string;\n  workbookSpinCount?: number;\n  /** Legacy 16-bit hex hash of the revisions-tracking password. */\n  revisionsPassword?: string;\n  revisionsPasswordCharacterSet?: string;\n  revisionsAlgorithmName?: string;\n  revisionsHashValue?: string;\n  revisionsSaltValue?: string;\n  revisionsSpinCount?: number;\n  /** Lock add/delete/move/rename/hide of sheets. */\n  lockStructure?: boolean;\n  /** Lock the workbook window size and position. */\n  lockWindows?: boolean;\n  /** Lock revision tracking — enabled with the \"Track Changes\" feature. */\n  lockRevision?: boolean;\n}\n\nexport const makeWorkbookProtection = (opts: WorkbookProtection = {}): WorkbookProtection => {\n  const out: WorkbookProtection = {};\n  for (const k of [\n    'workbookPassword',\n    'workbookPasswordCharacterSet',\n    'workbookAlgorithmName',\n    'workbookHashValue',\n    'workbookSaltValue',\n    'revisionsPassword',\n    'revisionsPasswordCharacterSet',\n    'revisionsAlgorithmName',\n    'revisionsHashValue',\n    'revisionsSaltValue',\n  ] as const) {\n    if (opts[k] !== undefined) out[k] = opts[k];\n  }\n  if (opts.workbookSpinCount !== undefined) out.workbookSpinCount = opts.workbookSpinCount;\n  if (opts.revisionsSpinCount !== undefined) out.revisionsSpinCount = opts.revisionsSpinCount;\n  if (opts.lockStructure !== undefined) out.lockStructure = opts.lockStructure;\n  if (opts.lockWindows !== undefined) out.lockWindows = opts.lockWindows;\n  if (opts.lockRevision !== undefined) out.lockRevision = opts.lockRevision;\n  return out;\n};\n\n// ---- Workbook ergonomic helpers -----------------------------------------\n\nimport type { Workbook } from './workbook.js';\n\n/**\n * Lock the workbook with Excel's \"Protect Workbook → Structure\" default\n * (lockStructure=true). Pass `overrides` to also lock windows /\n * revision-tracking, or to attach a password-hash quad. Plaintext password\n * support is deferred until the D-tier hashing helper lands.\n */\nexport const protectWorkbook = (\n  wb: Workbook,\n  overrides: Partial<WorkbookProtection> = {},\n): WorkbookProtection => {\n  wb.workbookProtection = { lockStructure: true, ...overrides };\n  return wb.workbookProtection;\n};\n\n/** Drop the workbook-protection record entirely. */\nexport const unprotectWorkbook = (wb: Workbook): void => {\n  delete (wb as { workbookProtection?: WorkbookProtection }).workbookProtection;\n};\n\n/** True iff `lockStructure === true`. */\nexport const isWorkbookProtected = (wb: Workbook): boolean =>\n  wb.workbookProtection?.lockStructure === true;\n","// Workbook-level <bookViews> typed model. Per ECMA-376 §18.2.30 and\n// openpyxl/openpyxl/workbook/views.py.\n//\n// `<bookViews>` carries one or more `<workbookView>` entries. The\n// first entry drives Excel's default tab strip (firstSheet / activeTab)\n// and window position. Most workbooks have exactly one entry.\n\nexport type WorkbookViewVisibility = 'visible' | 'hidden' | 'veryHidden';\n\nexport interface WorkbookView {\n  visibility?: WorkbookViewVisibility;\n  minimized?: boolean;\n  showHorizontalScroll?: boolean;\n  showVerticalScroll?: boolean;\n  showSheetTabs?: boolean;\n  /** Window x position in screen pixels — Excel restores it when re-opening. */\n  xWindow?: number;\n  /** Window y position. */\n  yWindow?: number;\n  windowWidth?: number;\n  windowHeight?: number;\n  /** Width of the sheet tab strip relative to the horizontal scroll bar (0..1000, default 600). */\n  tabRatio?: number;\n  /** Index of the leftmost visible sheet tab (0-based). */\n  firstSheet?: number;\n  /** Index of the currently active sheet tab (0-based). */\n  activeTab?: number;\n  autoFilterDateGrouping?: boolean;\n  /**\n   * Namespaced attributes outside SpreadsheetML, keyed in Clark notation\n   * (`{ns}local`). Excel writes `xr2:uid=\"{…}\"` here to tie the view to its\n   * revision-tracking record; kept verbatim because the model has no slot for\n   * it and dropping it changes what Excel reads back.\n   */\n  extAttrs?: Readonly<Record<string, string>>;\n}\n\nexport const makeWorkbookView = (opts: WorkbookView = {}): WorkbookView => ({ ...opts });\n\nexport type CustomViewShowComments = 'commNone' | 'commIndicator' | 'commIndAndComment';\nexport type CustomViewShowObjects = 'all' | 'placeholders' | 'none';\n\nexport interface CustomWorkbookView {\n  name: string;\n  guid: string;\n  /** Window width in screen pixels — required when the element is present. */\n  windowWidth: number;\n  windowHeight: number;\n  /** Index (0-based) of the sheet active in this saved view. */\n  activeSheetId: number;\n  autoUpdate?: boolean;\n  /** Auto-merge interval in minutes (for shared workbooks). */\n  mergeInterval?: number;\n  changesSavedWin?: boolean;\n  onlySync?: boolean;\n  personalView?: boolean;\n  includePrintSettings?: boolean;\n  includeHiddenRowCol?: boolean;\n  maximized?: boolean;\n  minimized?: boolean;\n  showHorizontalScroll?: boolean;\n  showVerticalScroll?: boolean;\n  showSheetTabs?: boolean;\n  xWindow?: number;\n  yWindow?: number;\n  tabRatio?: number;\n  showFormulaBar?: boolean;\n  showStatusbar?: boolean;\n  showComments?: CustomViewShowComments;\n  showObjects?: CustomViewShowObjects;\n}\n\nexport const makeCustomWorkbookView = (\n  opts: Pick<CustomWorkbookView, 'name' | 'guid' | 'windowWidth' | 'windowHeight' | 'activeSheetId'> &\n    Partial<CustomWorkbookView>,\n): CustomWorkbookView => ({ ...opts });\n\nimport type { Workbook } from './workbook.js';\n\n/**\n * Get-or-create the primary `<workbookView>` entry. Most workbooks have\n * exactly one `<workbookView>`; this helper is the right place to hang\n * tab-strip / window state edits without forcing the caller to allocate\n * the array themselves.\n */\nconst ensurePrimaryView = (wb: Workbook): WorkbookView => {\n  const existing = wb.bookViews?.[0];\n  if (existing) return existing;\n  const fresh = makeWorkbookView();\n  wb.bookViews = [fresh];\n  return fresh;\n};\n\n/** Get the index of the active sheet tab (0-based) from the primary workbookView, or 0 if unset. */\nexport const getActiveTab = (wb: Workbook): number => wb.bookViews?.[0]?.activeTab ?? 0;\n\n/** Set the active sheet tab (0-based) on the primary workbookView. */\nexport const setActiveTab = (wb: Workbook, index: number): void => {\n  ensurePrimaryView(wb).activeTab = index;\n};\n\n/** Get the index of the leftmost visible sheet tab from the primary workbookView, or 0 if unset. */\nexport const getFirstSheet = (wb: Workbook): number => wb.bookViews?.[0]?.firstSheet ?? 0;\n\n/** Set the leftmost visible sheet tab on the primary workbookView. */\nexport const setFirstSheet = (wb: Workbook, index: number): void => {\n  ensurePrimaryView(wb).firstSheet = index;\n};\n\n/** Set the tab strip width ratio (0..1000, Excel default 600). */\nexport const setTabRatio = (wb: Workbook, ratio: number): void => {\n  ensurePrimaryView(wb).tabRatio = ratio;\n};\n\n/** Toggle the sheet tab strip visibility. */\nexport const setShowSheetTabs = (wb: Workbook, show: boolean): void => {\n  ensurePrimaryView(wb).showSheetTabs = show;\n};\n\n/** Toggle the horizontal scroll bar in Excel's window chrome. */\nexport const setShowHorizontalScroll = (wb: Workbook, show: boolean): void => {\n  ensurePrimaryView(wb).showHorizontalScroll = show;\n};\n\n/** Toggle the vertical scroll bar in Excel's window chrome. */\nexport const setShowVerticalScroll = (wb: Workbook, show: boolean): void => {\n  ensurePrimaryView(wb).showVerticalScroll = show;\n};\n\n/**\n * Toggle the workbook window minimised state. Excel honours this on\n * reopen so the file restores into the minimised state it was saved\n * with.\n */\nexport const setWorkbookMinimized = (wb: Workbook, minimized: boolean): void => {\n  ensurePrimaryView(wb).minimized = minimized;\n};\n\n/** Set the visibility of the workbook window itself ('visible' / 'hidden' / 'veryHidden'). */\nexport const setWorkbookVisibility = (wb: Workbook, visibility: WorkbookViewVisibility): void => {\n  ensurePrimaryView(wb).visibility = visibility;\n};\n\n/**\n * Set window position + size on the primary workbookView in one call.\n * Pass `undefined` for any axis to leave it untouched.\n */\nexport const setWorkbookWindow = (\n  wb: Workbook,\n  opts: { xWindow?: number; yWindow?: number; windowWidth?: number; windowHeight?: number },\n): void => {\n  const v = ensurePrimaryView(wb);\n  if (opts.xWindow !== undefined) v.xWindow = opts.xWindow;\n  if (opts.yWindow !== undefined) v.yWindow = opts.yWindow;\n  if (opts.windowWidth !== undefined) v.windowWidth = opts.windowWidth;\n  if (opts.windowHeight !== undefined) v.windowHeight = opts.windowHeight;\n};\n","// Workbook-level <calcPr>. Per ECMA-376 §18.2.2.\n//\n// `calcId` is a build identifier Excel uses to decide whether to force\n// a recalc when re-opening; modern Excel treats any value as \"use\n// what's there\". The other attrs cover Excel's calculation options\n// (Tools → Options → Formulas).\n\nexport type CalcMode = 'manual' | 'auto' | 'autoNoTable';\nexport type RefMode = 'A1' | 'R1C1';\n\nexport interface CalcProperties {\n  /** Excel build/calc-engine identifier; OpenOffice sets 191621, Excel 2016+ 162913 etc. */\n  calcId?: number;\n  calcMode?: CalcMode;\n  /** Force a full recalc when the workbook is loaded. Excel default `true` for safety. */\n  fullCalcOnLoad?: boolean;\n  refMode?: RefMode;\n  /** Allow circular references via iterative calculation. */\n  iterate?: boolean;\n  iterateCount?: number;\n  iterateDelta?: number;\n  /** Use full 15-digit precision (vs. displayed precision). */\n  fullPrecision?: boolean;\n  calcCompleted?: boolean;\n  /** Run a recalc on save. */\n  calcOnSave?: boolean;\n  /** Use multi-threaded calculation. */\n  concurrentCalc?: boolean;\n  concurrentManualCount?: number;\n  /** Force a full recalc on next interaction. */\n  forceFullCalc?: boolean;\n}\n\nexport const makeCalcProperties = (opts: CalcProperties = {}): CalcProperties => ({ ...opts });\n\n// ---- Workbook ergonomic helpers ----------------------------------------\n\nimport type { Workbook } from './workbook.js';\n\nconst ensureCalcProperties = (wb: Workbook): CalcProperties => {\n  if (!wb.calcProperties) wb.calcProperties = {};\n  return wb.calcProperties;\n};\n\n/**\n * Set the recalculation mode. `'auto'` is Excel's default;\n * `'manual'` requires F9 to recompute formulas; `'autoNoTable'`\n * recomputes everything except data-table cells.\n */\nexport const setCalcMode = (wb: Workbook, mode: CalcMode): void => {\n  ensureCalcProperties(wb).calcMode = mode;\n};\n\n/**\n * Toggle iterative calculation (Excel's \"Enable iterative calculation\"\n * option). When `enable` is true and `count` / `delta` are provided,\n * they replace the default Excel limits (100 iterations, 0.001 delta).\n */\nexport const setIterativeCalc = (\n  wb: Workbook,\n  enable: boolean,\n  opts: { count?: number; delta?: number } = {},\n): void => {\n  const calc = ensureCalcProperties(wb);\n  calc.iterate = enable;\n  if (opts.count !== undefined) calc.iterateCount = opts.count;\n  if (opts.delta !== undefined) calc.iterateDelta = opts.delta;\n};\n\n/** Toggle \"Recalculate workbook before saving\" (workbook-level). */\nexport const setCalcOnSave = (wb: Workbook, on: boolean): void => {\n  ensureCalcProperties(wb).calcOnSave = on;\n};\n\n/** Toggle \"Recalculate workbook on load\" — forces a full recalc on open. */\nexport const setFullCalcOnLoad = (wb: Workbook, on: boolean): void => {\n  ensureCalcProperties(wb).fullCalcOnLoad = on;\n};\n\n/** Toggle \"Set precision as displayed\" (false = full 15-digit precision). */\nexport const setFullPrecision = (wb: Workbook, on: boolean): void => {\n  ensureCalcProperties(wb).fullPrecision = on;\n};\n","// Workbook-level <workbookPr>. Per ECMA-376 §18.2.28.\n//\n// Mirrors openpyxl/openpyxl/workbook/properties.py WorkbookProperties.\n// `date1904` is already lifted via wb.date1904; everything else lived\n// in workbookXmlExtras passthrough until now. This typed shell promotes\n// all 19 attrs into the modeled workbook so consumers can edit them\n// without rebuilding the XmlNode.\n\nexport type ShowObjectsMode = 'all' | 'placeholders' | 'none';\nexport type UpdateLinksMode = 'userSet' | 'never' | 'always';\n\nexport interface WorkbookProperties {\n  /**\n   * Mac 1904 epoch flag. Mirrored from `Workbook.date1904` — the\n   * canonical source. Setting it here has no effect on the cell-serial\n   * conversion path, which keys off the top-level field.\n   */\n  date1904?: boolean;\n  /** Excel 5/95 ↔ 2007 compatibility hint. */\n  dateCompatibility?: boolean;\n  showObjects?: ShowObjectsMode;\n  showBorderUnselectedTables?: boolean;\n  filterPrivacy?: boolean;\n  promptedSolutions?: boolean;\n  showInkAnnotation?: boolean;\n  backupFile?: boolean;\n  /** Cache external-link values when saving. */\n  saveExternalLinkValues?: boolean;\n  /** \"Update remote links\" prompt mode. */\n  updateLinks?: UpdateLinksMode;\n  /** VBA codeName for the workbook (e.g. \"ThisWorkbook\" / \"ЭтаКнига\"). */\n  codeName?: string;\n  hidePivotFieldList?: boolean;\n  showPivotChartFilter?: boolean;\n  allowRefreshQuery?: boolean;\n  publishItems?: boolean;\n  checkCompatibility?: boolean;\n  autoCompressPictures?: boolean;\n  refreshAllConnections?: boolean;\n  /** Theme schema version (Excel 2007 = 124226, 2013+ = 153222). */\n  defaultThemeVersion?: number;\n}\n\nexport const makeWorkbookProperties = (opts: WorkbookProperties = {}): WorkbookProperties => ({ ...opts });\n\n// ---- Workbook ergonomic helpers ----------------------------------------\n\nimport type { Workbook } from './workbook.js';\n\nconst ensureWorkbookProperties = (wb: Workbook): WorkbookProperties => {\n  if (!wb.workbookProperties) wb.workbookProperties = {};\n  return wb.workbookProperties;\n};\n\n/**\n * Set the workbook-level VBA codeName (\"ThisWorkbook\" by default in\n * Excel; localised forms like \"ЭтаКнига\" round-trip too). Empty string\n * is allowed — Excel writes it that way for codename-stripped files.\n */\nexport const setWorkbookCodeName = (wb: Workbook, codeName: string): void => {\n  ensureWorkbookProperties(wb).codeName = codeName;\n};\n\n/**\n * Toggle the Mac 1904 epoch. The canonical flag is `wb.date1904`\n * (drives cell-serial conversion); this helper writes both the\n * canonical field and the mirror on `workbookProperties` so a save\n * emits a consistent `<workbookPr date1904=\"…\">` attribute.\n */\nexport const setDate1904 = (wb: Workbook, on: boolean): void => {\n  wb.date1904 = on;\n  ensureWorkbookProperties(wb).date1904 = on;\n};\n\n/**\n * Set the \"Update remote links\" prompt mode. `'userSet'` keeps\n * Excel's per-user preference; `'never'` disables the prompt;\n * `'always'` forces it. Mirrors the Trust Center \"External Content\"\n * dropdown.\n */\nexport const setUpdateLinksMode = (wb: Workbook, mode: UpdateLinksMode): void => {\n  ensureWorkbookProperties(wb).updateLinks = mode;\n};\n\n/** Toggle the \"filterPrivacy\" hint Excel writes to indicate filter contents may be sensitive. */\nexport const setFilterPrivacy = (wb: Workbook, on: boolean): void => {\n  ensureWorkbookProperties(wb).filterPrivacy = on;\n};\n","// Workbook-level <fileVersion>. Per ECMA-376 §18.2.13.\n//\n// Carries Microsoft Office app/version metadata that Excel writes\n// when it saves; round-tripping these values keeps the file looking\n// like Excel's own output to downstream tools that sniff them.\n\nexport interface FileVersion {\n  /** Application that last saved the workbook (\"xl\" for Excel). */\n  appName?: string;\n  /** Build number of the last editor (e.g. \"7.5210\"). */\n  lastEdited?: string;\n  /** Build number of the lowest editor (oldest Excel that touched the file). */\n  lowestEdited?: string;\n  /** Internal \"rolled-up build\" number. */\n  rupBuild?: string;\n  /** GUID identifying the file content (Excel uses it to detect re-saves). */\n  codeName?: string;\n}\n\nexport const makeFileVersion = (opts: FileVersion = {}): FileVersion => ({ ...opts });\n","// Workbook-level <fileSharing>. Per ECMA-376 §18.2.12.\n//\n// Carries the workbook's read-only / write-protection settings (Save\n// As → Tools → General Options → \"Modify password\" / \"Read-only\n// recommended\"). The hash quad mirrors sheetProtection / workbookProtection.\n\nexport interface FileSharing {\n  /** Mark the workbook as \"Read-only recommended\" — Excel pops a dialog on open. */\n  readOnlyRecommended?: boolean;\n  /** Author name attached to the read/write password. */\n  userName?: string;\n  /** Legacy 16-bit hex hash of the reservation password. */\n  reservationPassword?: string;\n  /** Modern hash quad — algorithmName + hashValue + saltValue + spinCount. */\n  algorithmName?: string;\n  hashValue?: string;\n  saltValue?: string;\n  spinCount?: number;\n}\n\nexport const makeFileSharing = (opts: FileSharing = {}): FileSharing => ({ ...opts });\n","// Workbook-level <fileRecoveryPr>. Per ECMA-376 §18.2.11.\n//\n// Excel writes this element after an autorecover sequence to mark the\n// workbook with the recovery state so subsequent opens can prompt the\n// user. Almost always absent in fresh files.\n\nexport interface FileRecoveryProperties {\n  /** True after an autorecover save — Excel uses it to display the recovery banner. */\n  autoRecover?: boolean;\n  /** Persisted crash-recovery flag. */\n  crashSave?: boolean;\n  /** Mark the file as \"data extracted from a damaged workbook\". */\n  dataExtractLoad?: boolean;\n  /** Workbook was repaired during load. */\n  repairLoad?: boolean;\n}\n\nexport const makeFileRecoveryProperties = (\n  opts: FileRecoveryProperties = {},\n): FileRecoveryProperties => ({ ...opts });\n","// Workbook-level <smartTagPr> + <smartTagTypes>. Per ECMA-376 §18.2.26\n// / §18.2.27. Smart tags were Excel 2003's auto-recognized data\n// (stock symbols, dates, names) and are deprecated, but the elements\n// still appear in some legacy workbooks.\n\nexport type SmartTagShowMode = 'all' | 'noIndicator';\n\nexport interface SmartTagProperties {\n  /** Embed smart tags into the workbook on save. */\n  embed?: boolean;\n  show?: SmartTagShowMode;\n}\n\nexport interface SmartTagType {\n  namespaceUri?: string;\n  name?: string;\n  url?: string;\n}\n\nexport const makeSmartTagProperties = (opts: SmartTagProperties = {}): SmartTagProperties => ({ ...opts });\n\nexport const makeSmartTagType = (opts: SmartTagType = {}): SmartTagType => ({ ...opts });\n","// Workbook-level <functionGroups>. Per ECMA-376 §18.2.14.\n//\n// Excel registers built-in function groups (Math/Statistical/Logical/...)\n// implicitly with a `builtInGroupCount` count and supports user-defined\n// XLL function groups appended after that count. Most workbooks don't\n// carry this element at all.\n\nexport interface FunctionGroup {\n  name: string;\n}\n\nexport interface FunctionGroups {\n  /** Number of built-in groups Excel reserves before user entries (default 16). */\n  builtInGroupCount?: number;\n  groups: FunctionGroup[];\n}\n\nexport const makeFunctionGroup = (name: string): FunctionGroup => ({ name });\n\nexport const makeFunctionGroups = (opts: Partial<FunctionGroups> = {}): FunctionGroups => ({\n  groups: opts.groups?.slice() ?? [],\n  ...(opts.builtInGroupCount !== undefined ? { builtInGroupCount: opts.builtInGroupCount } : {}),\n});\n"],"mappings":";;;AAoCA,MAAa,0BAA0B,OAA2B,CAAC,MAA0B;CAC3F,MAAM,MAA0B,CAAC;CACjC,KAAK,MAAM,KAAK;EACd;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,GACE,IAAI,KAAK,OAAO,KAAA,GAAW,IAAI,KAAK,KAAK;CAE3C,IAAI,KAAK,sBAAsB,KAAA,GAAW,IAAI,oBAAoB,KAAK;CACvE,IAAI,KAAK,uBAAuB,KAAA,GAAW,IAAI,qBAAqB,KAAK;CACzE,IAAI,KAAK,kBAAkB,KAAA,GAAW,IAAI,gBAAgB,KAAK;CAC/D,IAAI,KAAK,gBAAgB,KAAA,GAAW,IAAI,cAAc,KAAK;CAC3D,IAAI,KAAK,iBAAiB,KAAA,GAAW,IAAI,eAAe,KAAK;CAC7D,OAAO;AACT;;;ACrBA,MAAa,oBAAoB,OAAqB,CAAC,OAAqB,EAAE,GAAG,KAAK;AAmCtF,MAAa,0BACX,UAEwB,EAAE,GAAG,KAAK;;;AC1CpC,MAAa,sBAAsB,OAAuB,CAAC,OAAuB,EAAE,GAAG,KAAK;;;ACU5F,MAAa,0BAA0B,OAA2B,CAAC,OAA2B,EAAE,GAAG,KAAK;;;ACxBxG,MAAa,mBAAmB,OAAoB,CAAC,OAAoB,EAAE,GAAG,KAAK;;;ACCnF,MAAa,mBAAmB,OAAoB,CAAC,OAAoB,EAAE,GAAG,KAAK;;;ACHnF,MAAa,8BACX,OAA+B,CAAC,OACJ,EAAE,GAAG,KAAK;;;ACAxC,MAAa,0BAA0B,OAA2B,CAAC,OAA2B,EAAE,GAAG,KAAK;AAExG,MAAa,oBAAoB,OAAqB,CAAC,OAAqB,EAAE,GAAG,KAAK;;;ACJtF,MAAa,qBAAqB,UAAiC,EAAE,KAAK;AAE1E,MAAa,sBAAsB,OAAgC,CAAC,OAAuB;CACzF,QAAQ,KAAK,QAAQ,MAAM,KAAK,CAAC;CACjC,GAAI,KAAK,sBAAsB,KAAA,IAAY,EAAE,mBAAmB,KAAK,kBAAkB,IAAI,CAAC;AAC9F"}

package/dist/worksheet/auto-filter.d.ts

@@ -20,7 +20,7 @@ export declare function makeFilterColumn(opts: {
     values: ReadonlyArray<string>;
     blank?: boolean;
 }): FilterColumn;
-import type { Worksheet } from './worksheet';
+import type { Worksheet } from './worksheet.js';
 /** Add an AutoFilter dropdown header strip to the given range. */
 export declare const addAutoFilter: (ws: Worksheet, ref: string) => AutoFilter;
 /**

package/dist/worksheet/cell-range.d.ts

@@ -1,5 +1,5 @@
-import type { Cell } from '../cell/cell';
-import { type CellRangeBoundaries } from '../utils/coordinate';
+import type { Cell } from '../cell/cell.js';
+import { type CellRangeBoundaries } from '../utils/coordinate.js';
 /** Re-export under the plan's canonical name. */
 export type CellRange = CellRangeBoundaries;
 /** Build a CellRange from explicit 1-based bounds. */

package/dist/worksheet/comments-xml.d.ts

@@ -1,4 +1,4 @@
-import type { LegacyComment } from './comments';
+import type { LegacyComment } from './comments.js';
 /** Parse a `xl/commentsN.xml` payload into a flat LegacyComment list. */
 export declare function parseCommentsXml(bytes: Uint8Array | string): LegacyComment[];
 /**

package/dist/worksheet/conditional-formatting.d.ts

@@ -1,4 +1,4 @@
-import { type MultiCellRange } from './cell-range';
+import { type MultiCellRange } from './cell-range.js';
 export type ConditionalFormattingRuleType = 'expression' | 'cellIs' | 'colorScale' | 'dataBar' | 'iconSet' | 'top10' | 'aboveAverage' | 'uniqueValues' | 'duplicateValues' | 'containsText' | 'notContainsText' | 'beginsWith' | 'endsWith' | 'containsBlanks' | 'notContainsBlanks' | 'containsErrors' | 'notContainsErrors' | 'timePeriod';
 export type CellIsOperator = 'lessThan' | 'lessThanOrEqual' | 'equal' | 'notEqual' | 'greaterThanOrEqual' | 'greaterThan' | 'between' | 'notBetween';
 export type TextOperator = 'containsText' | 'notContains' | 'beginsWith' | 'endsWith';
@@ -53,7 +53,7 @@ export declare function makeCfRule(opts: Partial<ConditionalFormattingRule> & {
     type: ConditionalFormattingRuleType;
     priority: number;
 }): ConditionalFormattingRule;
-import type { Worksheet } from './worksheet';
+import type { Worksheet } from './worksheet.js';
 /**
  * "If cell value [op] formula → apply dxf". Mirrors Excel's "Highlight Cell
  * Rules → ..." UI.

package/dist/worksheet/custom-sheet-views.d.ts

@@ -1,5 +1,5 @@
-import type { HeaderFooter, PageBreak, PageMargins, PageSetup, PrintOptions } from './page-setup';
-import type { Pane, Selection, SheetViewMode } from './views';
+import type { HeaderFooter, PageBreak, PageMargins, PageSetup, PrintOptions } from './page-setup.js';
+import type { Pane, Selection, SheetViewMode } from './views.js';
 export type CustomSheetViewState = 'visible' | 'hidden' | 'veryHidden';
 export interface CustomSheetView {
     guid: string;

package/dist/worksheet/data-validations.d.ts

@@ -1,4 +1,4 @@
-import { type MultiCellRange } from './cell-range';
+import { type MultiCellRange } from './cell-range.js';
 export type DataValidationType = 'whole' | 'decimal' | 'list' | 'date' | 'time' | 'textLength' | 'custom';
 export type DataValidationOperator = 'between' | 'notBetween' | 'equal' | 'notEqual' | 'greaterThan' | 'greaterThanOrEqual' | 'lessThan' | 'lessThanOrEqual';
 export type DataValidationErrorStyle = 'stop' | 'warning' | 'information';
@@ -31,7 +31,7 @@ export declare function makeDataValidation(opts: Omit<Partial<DataValidation>, '
     type: DataValidationType;
     sqref: MultiCellRange | string;
 }): DataValidation;
-import type { Worksheet } from './worksheet';
+import type { Worksheet } from './worksheet.js';
 export interface ValidationCommon {
     /** Show the dropdown / input prompt when the cell is selected. */
     prompt?: string;

package/dist/worksheet/errors.d.ts

@@ -1,4 +1,4 @@
-import type { MultiCellRange } from './cell-range';
+import type { MultiCellRange } from './cell-range.js';
 /**
  * One Cell-Watch entry. The Watch Window in Excel (Formulas → Watch Window)
  * shows live values for the cells listed here.

package/dist/worksheet/hyperlinks.d.ts

@@ -20,7 +20,7 @@ export interface Hyperlink {
 export declare function makeHyperlink(opts: Partial<Hyperlink> & {
     ref: string;
 }): Hyperlink;
-import type { Worksheet } from './worksheet';
+import type { Worksheet } from './worksheet.js';
 /**
  * Add an external URL hyperlink to a cell or range. The URL goes into the
  * worksheet rels as a hyperlink relationship; the writer generates an rId on

package/dist/worksheet/index.d.ts

@@ -1,46 +1,46 @@
-export type { CellsByKindCounts, IterRowsOptions, Worksheet, } from './worksheet';
-export { addCellWatch, addConditionalFormatting, addDataValidation, addIgnoredError, addTable, appendRow, appendRows, applyToRange, autofitColumns, clearAllCells, clearRange, collapseColumnGroup, collapseRowGroup, copyRange, countCells, countCellsByKind, deleteCell, expandColumnGroup, expandRowGroup, findCells, freezePanes, getAutoFilter, getCell, getCellByCoord, getCellsInColumn, getCellsInRange, getCellsInRow, getColumnDimension, getDataExtent, getFreezePanes, getMaxCol, getMaxRow, getMergedCells, getMergedRangeAt, getNonEmptyCellCount, getPopulatedColumnIndices, getPopulatedRowIndices, getRangeValues, getRowDimension, getTable, groupColumns, groupRows, hideColumn, hideColumns, hideRow, hideRows, isMergedCell, isWorksheetEmpty, iterCells, iterRows, iterValues, listComments, listDataValidations, listHyperlinks, listTables, makeWorksheet, mergeCells, moveRange, removeAllComments, removeAllConditionalFormatting, removeAllDataValidations, removeAllHyperlinks, removeAllMergedRanges, removeAllTables, removeCellWatches, removeDataValidations, removeHyperlink, removeIgnoredErrors, removeTable, setAutoFilter, setCell, setCellByCoord, setColumnDimension, setColumnWidth, setColumnWidths, setComment, setDefaultColumnWidth, setDefaultRowHeight, setFreezePanes, setHyperlink, setRangeValues, setRowDimension, setRowHeight, setRowHeights, setSheetTabColor, setSheetViewMode, setSheetZoom, ungroupColumns, ungroupRows, unhideColumn, unhideColumns, unhideRow, unhideRows, unmergeCells, unmergeCellsAt, writeRange, } from './worksheet';
-export type { MultiCellRange } from './cell-range';
-export { expandRangeStr, intersectionRange, isCellInRange, isRangeInRange, rangeArea, rangeContainsCell, rangeContainsRange, rangesOverlap, shiftRange, unionRange, } from './cell-range';
-export type { ColumnDimension, RowDimension } from './dimensions';
-export { makeColumnDimension, makeRowDimension } from './dimensions';
-export type { Pane, PaneState, PaneType, Selection, SheetView, SheetViewMode, } from './views';
-export { freezePaneRef, makeFreezePane, makeSheetView } from './views';
-export type { LegacyComment } from './comments';
-export { makeLegacyComment } from './comments';
-export type { DataValidation, DataValidationErrorStyle, DataValidationOperator, DataValidationType, ValidationCommon, } from './data-validations';
-export { makeDataValidation } from './data-validations';
-export type { CellIsOperator, Cfvo, CfvoType, ConditionalFormatting, ConditionalFormattingRule, ConditionalFormattingRuleType, IconSetStyle, TextOperator, TimePeriod, } from './conditional-formatting';
-export { makeCfRule, makeConditionalFormatting } from './conditional-formatting';
-export type { Hyperlink } from './hyperlinks';
-export { makeHyperlink } from './hyperlinks';
-export type { AutoFilter, FilterColumn } from './auto-filter';
-export { makeAutoFilter, makeFilterColumn } from './auto-filter';
-export type { TableColumn, TableDefinition, TableStyleInfo } from './table';
-export { addExcelTable, makeTableColumn, makeTableDefinition } from './table';
-export type { CellWatch, IgnoredError } from './errors';
-export { makeCellWatch, makeIgnoredError } from './errors';
-export type { OutlineProperties, PageSetupProperties, SheetProperties } from './properties';
-export { makeSheetProperties } from './properties';
-export type { SheetProtection } from './protection';
-export { makeSheetProtection } from './protection';
-export type { ProtectedRange } from './protected-ranges';
-export { makeProtectedRange } from './protected-ranges';
-export type { SortBy, SortCondition, SortIconSet, SortMethod, SortState, } from './sort-state';
-export { makeSortCondition, makeSortState } from './sort-state';
-export type { CellSmartTag, CellSmartTagProperty, CellSmartTags, } from './smart-tags';
-export { makeCellSmartTag, makeCellSmartTagProperty, makeCellSmartTags, } from './smart-tags';
-export type { FormControl, OleDvAspect, OleObject, OleUpdateMode, } from './ole-objects';
-export { makeFormControl, makeOleObject } from './ole-objects';
-export type { CustomSheetView, CustomSheetViewState } from './custom-sheet-views';
-export { makeCustomSheetView } from './custom-sheet-views';
-export type { CellCommentMode, HeaderFooter, HeaderFooterSection, PageBreak, PageMargins, PageOrder, PageOrientation, PageSetup, PrintErrorMode, PrintOptions, } from './page-setup';
-export { buildHeaderFooterText, HEADER_FOOTER_CODES, makeHeaderFooter, makePageBreak, makePageMargins, makePageSetup, makePrintOptions, } from './page-setup';
-export type { WebPublishItem, WorksheetCustomProperty } from './web-publish';
-export { makeWebPublishItem, makeWorksheetCustomProperty } from './web-publish';
-export type { PhoneticAlignment, PhoneticType, WorksheetPhoneticProperties, } from './phonetic';
-export { makeWorksheetPhoneticProperties } from './phonetic';
-export type { DataConsolidate, DataConsolidateFunction, DataReference, } from './data-consolidate';
-export { makeDataConsolidate } from './data-consolidate';
-export type { Scenario, ScenarioInputCell, ScenarioList } from './scenarios';
-export { makeScenario, makeScenarioInputCell, makeScenarioList } from './scenarios';
+export type { CellsByKindCounts, IterRowsOptions, Worksheet, } from './worksheet.js';
+export { addCellWatch, addConditionalFormatting, addDataValidation, addIgnoredError, addTable, appendRow, appendRows, applyToRange, autofitColumns, clearAllCells, clearRange, collapseColumnGroup, collapseRowGroup, copyRange, countCells, countCellsByKind, deleteCell, expandColumnGroup, expandRowGroup, findCells, freezePanes, getAutoFilter, getCell, getCellByCoord, getCellsInColumn, getCellsInRange, getCellsInRow, getColumnDimension, getDataExtent, getFreezePanes, getMaxCol, getMaxRow, getMergedCells, getMergedRangeAt, getNonEmptyCellCount, getPopulatedColumnIndices, getPopulatedRowIndices, getRangeValues, getRowDimension, getTable, groupColumns, groupRows, hideColumn, hideColumns, hideRow, hideRows, isMergedCell, isWorksheetEmpty, iterCells, iterRows, iterValues, listComments, listDataValidations, listHyperlinks, listTables, makeWorksheet, mergeCells, moveRange, removeAllComments, removeAllConditionalFormatting, removeAllDataValidations, removeAllHyperlinks, removeAllMergedRanges, removeAllTables, removeCellWatches, removeDataValidations, removeHyperlink, removeIgnoredErrors, removeTable, setAutoFilter, setCell, setCellByCoord, setColumnDimension, setColumnWidth, setColumnWidths, setComment, setDefaultColumnWidth, setDefaultRowHeight, setFreezePanes, setHyperlink, setRangeValues, setRowDimension, setRowHeight, setRowHeights, setSheetTabColor, setSheetViewMode, setSheetZoom, ungroupColumns, ungroupRows, unhideColumn, unhideColumns, unhideRow, unhideRows, unmergeCells, unmergeCellsAt, writeRange, } from './worksheet.js';
+export type { MultiCellRange } from './cell-range.js';
+export { expandRangeStr, intersectionRange, isCellInRange, isRangeInRange, rangeArea, rangeContainsCell, rangeContainsRange, rangesOverlap, shiftRange, unionRange, } from './cell-range.js';
+export type { ColumnDimension, RowDimension } from './dimensions.js';
+export { makeColumnDimension, makeRowDimension } from './dimensions.js';
+export type { Pane, PaneState, PaneType, Selection, SheetView, SheetViewMode, } from './views.js';
+export { freezePaneRef, makeFreezePane, makeSheetView } from './views.js';
+export type { LegacyComment } from './comments.js';
+export { makeLegacyComment } from './comments.js';
+export type { DataValidation, DataValidationErrorStyle, DataValidationOperator, DataValidationType, ValidationCommon, } from './data-validations.js';
+export { makeDataValidation } from './data-validations.js';
+export type { CellIsOperator, Cfvo, CfvoType, ConditionalFormatting, ConditionalFormattingRule, ConditionalFormattingRuleType, IconSetStyle, TextOperator, TimePeriod, } from './conditional-formatting.js';
+export { makeCfRule, makeConditionalFormatting } from './conditional-formatting.js';
+export type { Hyperlink } from './hyperlinks.js';
+export { makeHyperlink } from './hyperlinks.js';
+export type { AutoFilter, FilterColumn } from './auto-filter.js';
+export { makeAutoFilter, makeFilterColumn } from './auto-filter.js';
+export type { TableColumn, TableDefinition, TableStyleInfo } from './table.js';
+export { addExcelTable, makeTableColumn, makeTableDefinition } from './table.js';
+export type { CellWatch, IgnoredError } from './errors.js';
+export { makeCellWatch, makeIgnoredError } from './errors.js';
+export type { OutlineProperties, PageSetupProperties, SheetProperties } from './properties.js';
+export { makeSheetProperties } from './properties.js';
+export type { SheetProtection } from './protection.js';
+export { makeSheetProtection } from './protection.js';
+export type { ProtectedRange } from './protected-ranges.js';
+export { makeProtectedRange } from './protected-ranges.js';
+export type { SortBy, SortCondition, SortIconSet, SortMethod, SortState, } from './sort-state.js';
+export { makeSortCondition, makeSortState } from './sort-state.js';
+export type { CellSmartTag, CellSmartTagProperty, CellSmartTags, } from './smart-tags.js';
+export { makeCellSmartTag, makeCellSmartTagProperty, makeCellSmartTags, } from './smart-tags.js';
+export type { FormControl, OleDvAspect, OleObject, OleUpdateMode, } from './ole-objects.js';
+export { makeFormControl, makeOleObject } from './ole-objects.js';
+export type { CustomSheetView, CustomSheetViewState } from './custom-sheet-views.js';
+export { makeCustomSheetView } from './custom-sheet-views.js';
+export type { CellCommentMode, HeaderFooter, HeaderFooterSection, PageBreak, PageMargins, PageOrder, PageOrientation, PageSetup, PrintErrorMode, PrintOptions, } from './page-setup.js';
+export { buildHeaderFooterText, HEADER_FOOTER_CODES, makeHeaderFooter, makePageBreak, makePageMargins, makePageSetup, makePrintOptions, } from './page-setup.js';
+export type { WebPublishItem, WorksheetCustomProperty } from './web-publish.js';
+export { makeWebPublishItem, makeWorksheetCustomProperty } from './web-publish.js';
+export type { PhoneticAlignment, PhoneticType, WorksheetPhoneticProperties, } from './phonetic.js';
+export { makeWorksheetPhoneticProperties } from './phonetic.js';
+export type { DataConsolidate, DataConsolidateFunction, DataReference, } from './data-consolidate.js';
+export { makeDataConsolidate } from './data-consolidate.js';
+export type { Scenario, ScenarioInputCell, ScenarioList } from './scenarios.js';
+export { makeScenario, makeScenarioInputCell, makeScenarioList } from './scenarios.js';

package/dist/worksheet/ole-objects.d.ts

@@ -1,4 +1,4 @@
-import type { XmlNode } from '../xml/tree';
+import type { XmlNode } from '../xml/tree.js';
 export type OleDvAspect = 'DVASPECT_CONTENT' | 'DVASPECT_ICON';
 export type OleUpdateMode = 'OLEUPDATE_ALWAYS' | 'OLEUPDATE_ONCALL';
 export interface OleObject {

package/dist/worksheet/page-setup.d.ts

@@ -85,7 +85,7 @@ export interface PageBreak {
     pt?: boolean;
 }
 export declare const makePageBreak: (opts?: PageBreak) => PageBreak;
-import type { Worksheet } from './worksheet';
+import type { Worksheet } from './worksheet.js';
 /** Set page orientation on `ws.pageSetup` (allocates if missing). */
 export declare const setPageOrientation: (ws: Worksheet, orientation: PageOrientation) => void;
 /** Set paper size code (Excel uses ECMA-376 §3.3 paper-size enums; 1=Letter, 9=A4 etc.). */

package/dist/worksheet/properties.d.ts

@@ -1,4 +1,4 @@
-import type { Color } from '../styles/colors';
+import type { Color } from '../styles/colors.js';
 export interface OutlineProperties {
     applyStyles?: boolean;
     /** "Summary rows below detail" — Excel default true. */

package/dist/worksheet/protected-ranges.d.ts

@@ -1,4 +1,4 @@
-import type { MultiCellRange } from './cell-range';
+import type { MultiCellRange } from './cell-range.js';
 export interface ProtectedRange {
     /** Range to expose for editing while the sheet is protected. */
     sqref: MultiCellRange;

package/dist/worksheet/protection.d.ts

@@ -28,7 +28,7 @@ export interface SheetProtection {
     hashValue?: string;
 }
 export declare const makeSheetProtection: (opts?: SheetProtection) => SheetProtection;
-import type { Worksheet } from './worksheet';
+import type { Worksheet } from './worksheet.js';
 /**
  * Lock a worksheet with Excel's "Protect Sheet" defaults. Pass `overrides` to
  * allow specific actions while otherwise locked (e.g. `{ sort: true,

package/dist/worksheet/reader.d.ts

@@ -1,12 +1,12 @@
-import type { Drawing } from '../drawing/drawing';
-import type { Relationships } from '../packaging/relationships';
-import { type XmlNode } from '../xml/tree';
-import { type SharedStringEntry } from '../workbook/shared-strings';
-import type { LegacyComment } from './comments';
-import type { HeaderFooter, PageMargins, PageSetup } from './page-setup';
-import type { WebPublishItem } from './web-publish';
-import type { TableDefinition } from './table';
-import { type Worksheet } from './worksheet';
+import type { Drawing } from '../drawing/drawing.js';
+import type { Relationships } from '../packaging/relationships.js';
+import { type XmlNode } from '../xml/tree.js';
+import { type SharedStringEntry } from '../workbook/shared-strings.js';
+import type { LegacyComment } from './comments.js';
+import type { HeaderFooter, PageMargins, PageSetup } from './page-setup.js';
+import type { WebPublishItem } from './web-publish.js';
+import type { TableDefinition } from './table.js';
+import { type Worksheet } from './worksheet.js';
 /** Inputs the worksheet reader needs from the surrounding workbook context. */
 export interface WorksheetReadContext {
     /**

package/dist/worksheet/scenarios.d.ts

@@ -1,4 +1,4 @@
-import type { MultiCellRange } from './cell-range';
+import type { MultiCellRange } from './cell-range.js';
 /** One <inputCells> entry — a single (cell, override-value) pair. */
 export interface ScenarioInputCell {
     /** Single-cell ref, e.g. "B5". */

package/dist/worksheet/table-xml.d.ts

@@ -1,4 +1,4 @@
-import type { TableDefinition } from './table';
+import type { TableDefinition } from './table.js';
 /** Parse a `xl/tables/tableN.xml` payload. */
 export declare function parseTableXml(bytes: Uint8Array | string): TableDefinition;
 /** Serialise a TableDefinition to its `xl/tables/tableN.xml` bytes. */

package/dist/worksheet/table.d.ts

@@ -1,6 +1,6 @@
-import type { Workbook } from '../workbook/workbook';
-import type { AutoFilter } from './auto-filter';
-import type { Worksheet } from './worksheet';
+import type { Workbook } from '../workbook/workbook.js';
+import type { AutoFilter } from './auto-filter.js';
+import type { Worksheet } from './worksheet.js';
 export interface TableColumn {
     /** 1-based column id (per-table). */
     id: number;

package/dist/worksheet/worksheet.d.ts

@@ -1,27 +1,27 @@
-import type { CellValue } from '../cell/cell';
-import { type Cell } from '../cell/cell';
-import { type InlineFont, type TextRun } from '../cell/rich-text';
-import type { Drawing } from '../drawing/drawing';
-import { type Color } from '../styles/colors';
-import type { AutoFilter } from './auto-filter';
-import { type CellRange } from './cell-range';
-import type { LegacyComment } from './comments';
-import type { ConditionalFormatting } from './conditional-formatting';
-import type { DataValidation } from './data-validations';
-import { type ColumnDimension, type RowDimension } from './dimensions';
-import type { DataConsolidate } from './data-consolidate';
-import type { ScenarioList } from './scenarios';
-import type { CellWatch, IgnoredError } from './errors';
-import type { HeaderFooter, PageBreak, PageMargins, PageSetup, PrintOptions } from './page-setup';
-import type { WorksheetPhoneticProperties } from './phonetic';
-import { type SheetProperties } from './properties';
-import type { SheetProtection } from './protection';
-import type { ProtectedRange } from './protected-ranges';
-import type { SortState } from './sort-state';
-import type { WebPublishItem, WorksheetCustomProperty } from './web-publish';
-import { type Hyperlink } from './hyperlinks';
-import type { TableDefinition } from './table';
-import { type SheetView } from './views';
+import type { CellValue } from '../cell/cell.js';
+import { type Cell } from '../cell/cell.js';
+import { type InlineFont, type TextRun } from '../cell/rich-text.js';
+import type { Drawing } from '../drawing/drawing.js';
+import { type Color } from '../styles/colors.js';
+import type { AutoFilter } from './auto-filter.js';
+import { type CellRange } from './cell-range.js';
+import type { LegacyComment } from './comments.js';
+import type { ConditionalFormatting } from './conditional-formatting.js';
+import type { DataValidation } from './data-validations.js';
+import { type ColumnDimension, type RowDimension } from './dimensions.js';
+import type { DataConsolidate } from './data-consolidate.js';
+import type { ScenarioList } from './scenarios.js';
+import type { CellWatch, IgnoredError } from './errors.js';
+import type { HeaderFooter, PageBreak, PageMargins, PageSetup, PrintOptions } from './page-setup.js';
+import type { WorksheetPhoneticProperties } from './phonetic.js';
+import { type SheetProperties } from './properties.js';
+import type { SheetProtection } from './protection.js';
+import type { ProtectedRange } from './protected-ranges.js';
+import type { SortState } from './sort-state.js';
+import type { WebPublishItem, WorksheetCustomProperty } from './web-publish.js';
+import { type Hyperlink } from './hyperlinks.js';
+import type { TableDefinition } from './table.js';
+import { type SheetView } from './views.js';
 export interface Worksheet {
     title: string;
     /** Sparse store: row index → (col index → Cell). */
@@ -134,24 +134,24 @@ export interface Worksheet {
      * `<smartTags>` — per-cell smart-tag annotations (Excel 2003 era). Pairs with
      * the workbook-level smartTagTypes registry.
      */
-    smartTags: import('./smart-tags').CellSmartTags[];
+    smartTags: import('./smart-tags.js').CellSmartTags[];
     /**
      * `<customSheetViews>` — saved per-user view presets for this worksheet
      * (Excel's "Custom Views" feature). Each entry snapshots zoom / gridline /
      * formula / heading toggles plus its own page-setup block and break list.
      */
-    customSheetViews: import('./custom-sheet-views').CustomSheetView[];
+    customSheetViews: import('./custom-sheet-views.js').CustomSheetView[];
     /**
      * `<oleObjects>` — embedded OLE objects (linked Word documents, Equation
      * editor formulas, etc.). The objectPr child is round-tripped verbatim as an
      * XmlNode.
      */
-    oleObjects: import('./ole-objects').OleObject[];
+    oleObjects: import('./ole-objects.js').OleObject[];
     /**
      * `<controls>` — form controls (checkboxes / list boxes / spin buttons placed
      * via the Developer tab). The controlPr child is round-tripped verbatim.
      */
-    controls: import('./ole-objects').FormControl[];
+    controls: import('./ole-objects.js').FormControl[];
     /** `<printOptions>` — gridlines, headings, horizontal/vertical centering on the printed page. */
     printOptions?: PrintOptions;
     /** `<pageMargins>` — six required margins in inches. */
@@ -223,8 +223,8 @@ export interface Worksheet {
      * openpyxl-emitted files round-trip cleanly.
      */
     bodyExtras?: {
-        beforeSheetData: import('../xml/tree').XmlNode[];
-        afterSheetData: import('../xml/tree').XmlNode[];
+        beforeSheetData: import('../xml/tree.js').XmlNode[];
+        afterSheetData: import('../xml/tree.js').XmlNode[];
     };
 }
 /** Build a Worksheet shell. */
@@ -371,7 +371,7 @@ export interface CellsByKindCounts {
  * Shared between {@link countCellsByKind} and the workbook-wide overview so
  * the two never drift in how they classify (e.g. `Date` vs `duration`).
  */
-export declare function classifyCellValue(v: import('../cell/cell').CellValue): keyof CellsByKindCounts;
+export declare function classifyCellValue(v: import('../cell/cell.js').CellValue): keyof CellsByKindCounts;
 export declare function countCellsByKind(ws: Worksheet): CellsByKindCounts;
 /**
  * Sheet-qualified A1 address for a cell — `'Sheet1!A1'` for plain titles,

package/dist/worksheet/writer.d.ts

@@ -1,9 +1,9 @@
-import { type Cell } from '../cell/cell';
-import type { Relationships } from '../packaging/relationships';
-import type { SharedStringsTable } from '../workbook/shared-strings';
-import type { HeaderFooter, PageMargins, PageSetup } from './page-setup';
-import type { WebPublishItem } from './web-publish';
-import type { Worksheet } from './worksheet';
+import { type Cell } from '../cell/cell.js';
+import type { Relationships } from '../packaging/relationships.js';
+import type { SharedStringsTable } from '../workbook/shared-strings.js';
+import type { HeaderFooter, PageMargins, PageSetup } from './page-setup.js';
+import type { WebPublishItem } from './web-publish.js';
+import type { Worksheet } from './worksheet.js';
 export interface WorksheetWriteContext {
     /** Accumulator the writer mutates as it emits string cells. */
     sharedStrings: SharedStringsTable;
@@ -26,7 +26,7 @@ export interface WorksheetWriteContext {
      * ("../tables/tableN.xml") + the worksheet-rels rId. Called once per
      * `ws.tables` entry while serialising.
      */
-    registerTable?: (table: import('./table').TableDefinition) => {
+    registerTable?: (table: import('./table.js').TableDefinition) => {
         rId: string;
     };
     /**
@@ -36,7 +36,7 @@ export interface WorksheetWriteContext {
      * `<legacyDrawing r:id>`. Called once per worksheet that carries any
      * comments.
      */
-    registerComments?: (comments: ReadonlyArray<import('./comments').LegacyComment>) => {
+    registerComments?: (comments: ReadonlyArray<import('./comments.js').LegacyComment>) => {
         vmlRelId: string;
     };
     /**
@@ -45,7 +45,7 @@ export interface WorksheetWriteContext {
      * worksheet rels, and returns the worksheet-rels rId — splatted into
      * `<drawing r:id>` by the writer. Called once when ws.drawing is set.
      */
-    registerDrawing?: (drawing: import('../drawing/drawing').Drawing) => {
+    registerDrawing?: (drawing: import('../drawing/drawing.js').Drawing) => {
         rId: string;
     };
 }