@mog-sdk/node 0.1.11 → 0.1.13

package/dist/index.d.cts

@@ -16,13 +16,13 @@ export type IKernelContext = any;
 export type IEventBus = any;
 
 
-import { Workbook, WorkbookInternal, Worksheet } from '@mog/spreadsheet-contracts/api';
-export { Workbook, Worksheet } from '@mog/spreadsheet-contracts/api';
+import { Workbook, WorkbookInternal, Worksheet } from '@mog-sdk/spreadsheet-contracts/api';
+export { Workbook, Worksheet } from '@mog-sdk/spreadsheet-contracts/api';
 import * as _mog_kernel_bridges from '@mog/kernel/bridges';
 
 
 
-import { CodeExecutionOptions, CodeExecutionResult } from '@mog/spreadsheet-contracts/core';
+import { CodeExecutionOptions, CodeExecutionResult } from '@mog-sdk/spreadsheet-contracts/core';
 
 /**
  * Save a workbook to a file path. Node.js only.
@@ -113,6 +113,7 @@ var subApis = {
 		viewport: "WorkbookViewport"
 	},
 	ws: {
+		whatIf: "WorksheetWhatIf",
 		smartArt: "WorksheetSmartArt",
 		changes: "WorksheetChanges",
 		formats: "WorksheetFormats",
@@ -219,10 +220,12 @@ var interfaces = {
 				]
 			},
 			calculate: {
-				signature: "calculate(calculationType?: CalculationType): Promise<void>;",
-				docstring: "Trigger recalculation of formulas.\n@param calculationType - Type of recalculation (default: 'full')\n  - 'recalculate' — recalculate dirty cells only\n  - 'full' — recalculate all cells\n  - 'fullRebuild' — rebuild dependency graph and recalculate all",
+				signature: "calculate(options?: CalculateOptions | CalculationType): Promise<CalculateResult>;",
+				docstring: "Trigger recalculation of formulas.\n@param options - Calculation options, or a CalculationType string for backward compatibility",
 				usedTypes: [
-					"CalculationType"
+					"CalculateOptions",
+					"CalculationType",
+					"CalculateResult"
 				]
 			},
 			getCalculationMode: {
@@ -245,19 +248,19 @@ var interfaces = {
 			},
 			setIterativeCalculation: {
 				signature: "setIterativeCalculation(enabled: boolean): Promise<void>;",
-				docstring: "Set whether iterative calculation is enabled for circular references.\nConvenience mutator — patches `calculationSettings.enableIterativeCalculation`.",
+				docstring: "Set whether iterative calculation is enabled for circular references.\nConvenience mutator — patches `calculationSettings.enableIterativeCalculation`.\n@deprecated Use calculate({ iterative: ... }) instead.",
 				usedTypes: [
 				]
 			},
 			setMaxIterations: {
 				signature: "setMaxIterations(n: number): Promise<void>;",
-				docstring: "Set the maximum number of iterations for iterative calculation.\nConvenience mutator — patches `calculationSettings.maxIterations`.",
+				docstring: "Set the maximum number of iterations for iterative calculation.\nConvenience mutator — patches `calculationSettings.maxIterations`.\n@deprecated Use calculate({ iterative: { maxIterations: n } }) instead.",
 				usedTypes: [
 				]
 			},
 			setConvergenceThreshold: {
 				signature: "setConvergenceThreshold(threshold: number): Promise<void>;",
-				docstring: "Set the convergence threshold (maximum change) for iterative calculation.\nConvenience mutator — patches `calculationSettings.maxChange`.",
+				docstring: "Set the convergence threshold (maximum change) for iterative calculation.\nConvenience mutator — patches `calculationSettings.maxChange`.\n@deprecated Use calculate({ iterative: { maxChange: threshold } }) instead.",
 				usedTypes: [
 				]
 			},
@@ -739,13 +742,6 @@ var interfaces = {
 					"FormatEntry"
 				]
 			},
-			goalSeek: {
-				signature: "goalSeek(targetCell: string, targetValue: number, changingCell: string): Promise<GoalSeekResult>;",
-				docstring: "Run a goal seek to find the input value that produces a target result.",
-				usedTypes: [
-					"GoalSeekResult"
-				]
-			},
 			isVisible: {
 				signature: "isVisible(): boolean;",
 				docstring: "Check if the sheet is visible (sync -- local metadata).",
@@ -1299,6 +1295,25 @@ var interfaces = {
 			}
 		}
 	},
+	WorksheetWhatIf: {
+		docstring: "Sub-API for What-If analysis operations.",
+		functions: {
+			goalSeek: {
+				signature: "goalSeek(targetCell: string, targetValue: number, changingCell: string): Promise<GoalSeekResult>;",
+				docstring: "Run a goal seek to find the input value that produces a target result.",
+				usedTypes: [
+					"GoalSeekResult"
+				]
+			},
+			dataTable: {
+				signature: "dataTable(\n    formulaCell: string,\n    options: {\n      rowInputCell?: string | null;\n      colInputCell?: string | null;\n      rowValues: (string | number | boolean | null)[];\n      colValues: (string | number | boolean | null)[];\n    },\n  ): Promise<DataTableResult>;",
+				docstring: "Evaluate a formula with different input values (What-If Data Table).\n\nOne-variable table: provide either `rowInputCell` or `colInputCell` (not both).\nTwo-variable table: provide both `rowInputCell` and `colInputCell`.\n\nFor one-variable tables, pass an empty array for the unused dimension's values.\n\nInput cells must already contain a value before calling this method.\n\n@param formulaCell - A1 address of the cell containing the formula to evaluate\n@param options - Input cells and substitution values\n@returns 2D grid of computed results",
+				usedTypes: [
+					"DataTableResult"
+				]
+			}
+		}
+	},
 	WorksheetSmartArt: {
 		docstring: "",
 		functions: {
@@ -1445,7 +1460,7 @@ var interfaces = {
 		functions: {
 			set: {
 				signature: "set(address: string, format: CellFormat): Promise<FormatChangeResult>;",
-				docstring: "Set format for a single cell.\n\n@param address - A1-style cell address (e.g. \"A1\", \"B3\")\n@param format - Format properties to apply",
+				docstring: "Set format for a single cell.\n\n@param address - A1-style cell address (e.g. \"A1\", \"B3\")\n@param format - Format properties to apply\n\n@example\n// Bold red currency\nawait ws.formats.set('A1', { bold: true, fontColor: '#ff0000', numberFormat: '$#,##0.00' });\n// Date format\nawait ws.formats.set('B1', { numberFormat: 'YYYY-MM-DD' });\n// Header style\nawait ws.formats.set('A1', { bold: true, fontSize: 14, backgroundColor: '#4472c4', fontColor: '#ffffff' });",
 				usedTypes: [
 					"CellFormat",
 					"FormatChangeResult"
@@ -1453,7 +1468,7 @@ var interfaces = {
 			},
 			setRange: {
 				signature: "setRange(range: string, format: CellFormat): Promise<FormatChangeResult>;",
-				docstring: "Set format for a contiguous range.\n\n@param range - A1-style range string (e.g. \"A1:B2\")\n@param format - Format properties to apply",
+				docstring: "Set format for a contiguous range.\n\n@param range - A1-style range string (e.g. \"A1:B2\")\n@param format - Format properties to apply\n\n@example\n// Currency column\nawait ws.formats.setRange('B2:B100', { numberFormat: '$#,##0.00' });\n// Header row with borders\nawait ws.formats.setRange('A1:F1', {\n  bold: true,\n  backgroundColor: '#4472c4',\n  fontColor: '#ffffff',\n  borders: { bottom: { style: 'medium', color: '#2f5496' } }\n});",
 				usedTypes: [
 					"CellFormat",
 					"FormatChangeResult"
@@ -2361,7 +2376,7 @@ var interfaces = {
 				]
 			},
 			setCriteria: {
-				signature: "setCriteria(\n    filterId: string,\n    col: number,\n    criteria: ColumnFilterCriteria,\n  ): Promise<void>;",
+				signature: "setCriteria(filterId: string, col: number, criteria: ColumnFilterCriteria): Promise<void>;",
 				docstring: "Set filter criteria for a column using filter ID.\n\n@param filterId - Filter ID\n@param col - Column index (0-based)\n@param criteria - Filter criteria to apply",
 				usedTypes: [
 					"ColumnFilterCriteria"
@@ -3816,8 +3831,8 @@ var types = {
 	},
 	AxisConfig: {
 		name: "AxisConfig",
-		definition: "{\n  xAxis?: {\n    type: AxisType;\n    title?: string;\n    min?: number;\n    max?: number;\n    gridLines?: boolean;\n    /** Show minor gridlines between major gridlines */\n    minorGridLines?: boolean;\n    majorUnit?: number;\n    minorUnit?: number;\n    tickMarks?: 'inside' | 'outside' | 'cross' | 'none';\n    /** Minor tick mark style (separate from major tickMarks) */\n    minorTickMarks?: 'inside' | 'outside' | 'cross' | 'none';\n    numberFormat?: string;\n    reverse?: boolean;\n    visible?: boolean;\n    position?: 'bottom' | 'top' | 'left' | 'right';\n    logBase?: number;\n    displayUnit?: string;\n  };\n  yAxis?: {\n    type: AxisType;\n    title?: string;\n    min?: number;\n    max?: number;\n    gridLines?: boolean;\n    /** Show minor gridlines between major gridlines */\n    minorGridLines?: boolean;\n    majorUnit?: number;\n    minorUnit?: number;\n    tickMarks?: 'inside' | 'outside' | 'cross' | 'none';\n    /** Minor tick mark style (separate from major tickMarks) */\n    minorTickMarks?: 'inside' | 'outside' | 'cross' | 'none';\n    numberFormat?: string;\n    reverse?: boolean;\n    visible?: boolean;\n    position?: 'bottom' | 'top' | 'left' | 'right';\n    logBase?: number;\n    displayUnit?: string;\n  };\n  secondaryYAxis?: {\n    type: AxisType;\n    title?: string;\n    min?: number;\n    max?: number;\n    show: boolean;\n    majorUnit?: number;\n    minorUnit?: number;\n    tickMarks?: 'inside' | 'outside' | 'cross' | 'none';\n    /** Minor tick mark style (separate from major tickMarks) */\n    minorTickMarks?: 'inside' | 'outside' | 'cross' | 'none';\n    numberFormat?: string;\n    reverse?: boolean;\n    visible?: boolean;\n    position?: 'bottom' | 'top' | 'left' | 'right';\n    logBase?: number;\n    displayUnit?: string;\n  };\n}",
-		docstring: "Axis configuration"
+		definition: "{\n  categoryAxis?: SingleAxisConfig;\n  valueAxis?: SingleAxisConfig;\n  secondaryCategoryAxis?: SingleAxisConfig;\n  secondaryValueAxis?: SingleAxisConfig;\n  /** @deprecated Use categoryAxis instead */\n  xAxis?: SingleAxisConfig;\n  /** @deprecated Use valueAxis instead */\n  yAxis?: SingleAxisConfig;\n  /** @deprecated Use secondaryValueAxis instead */\n  secondaryYAxis?: SingleAxisConfig;\n}",
+		docstring: "Axis configuration (matches AxisData wire type).\n\nWire field names: categoryAxis, valueAxis, secondaryCategoryAxis, secondaryValueAxis.\nLegacy aliases: xAxis, yAxis, secondaryYAxis (mapped in chart-bridge)."
 	},
 	AxisType: {
 		name: "AxisType",
@@ -3971,7 +3986,7 @@ var types = {
 	},
 	CellFormat: {
 		name: "CellFormat",
-		definition: "{\n  numberFormat?: string;\n  numberFormatType?: NumberFormatType;\n  fontFamily?: string;\n  fontSize?: number;\n  /** Theme font reference for Excel-compatible \"+Headings\" / \"+Body\" fonts.\n\nWhen set, the cell uses the theme's majorFont (headings) or minorFont (body)\ninstead of fontFamily. Theme fonts are resolved at render time, allowing cells\nto automatically update when the workbook theme changes.\n\nBehavior:\n- 'major': Uses theme.fonts.majorFont (e.g., 'Calibri Light' in Office theme)\n- 'minor': Uses theme.fonts.minorFont (e.g., 'Calibri' in Office theme)\n- undefined: Uses fontFamily property (or default font if not set)\n\nWhen fontTheme is set, fontFamily is ignored for rendering but may still be\nstored for fallback purposes. This matches Excel's behavior where \"+Headings\"\ncells can have a fontFamily that's used when the theme is unavailable.\n\n@see resolveThemeFonts in theme.ts for resolution\n@see ThemeFonts for theme font pair definition */\n  fontTheme?: 'major' | 'minor';\n  /** Font color. Can be:\n- Absolute hex: '#4472c4' or '#ff0000'\n- Theme reference: 'theme:accent1' (uses current theme's accent1 color)\n- Theme with tint: 'theme:accent1:0.4' (40% lighter) or 'theme:accent1:-0.25' (25% darker)\n\nTheme references are resolved at render time via resolveThemeColors().\nThis enables cells to automatically update when the workbook theme changes.\n\n@see resolveThemeColors in theme.ts for resolution\n@see ThemeColorSlot for valid slot names (dark1, light1, accent1-6, etc.) */\n  fontColor?: string;\n  bold?: boolean;\n  italic?: boolean;\n  /** Underline type. Excel supports 4 underline styles:\n- 'none': No underline (default)\n- 'single': Standard underline under all characters\n- 'double': Two parallel lines under all characters\n- 'singleAccounting': Underline under text only (not spaces), for column alignment\n- 'doubleAccounting': Double underline under text only (not spaces), for column alignment */\n  underlineType?: 'none' | 'single' | 'double' | 'singleAccounting' | 'doubleAccounting';\n  strikethrough?: boolean;\n  /** Superscript text (vertAlign = 'superscript' in Excel).\nText is rendered smaller and raised above the baseline. */\n  superscript?: boolean;\n  /** Subscript text (vertAlign = 'subscript' in Excel).\nText is rendered smaller and lowered below the baseline. */\n  subscript?: boolean;\n  /** Font outline effect.\nDraws only the outline of each character (hollow text).\nRare in modern spreadsheets but supported by Excel. */\n  fontOutline?: boolean;\n  /** Font shadow effect.\nAdds a shadow behind the text.\nRare in modern spreadsheets but supported by Excel. */\n  fontShadow?: boolean;\n  /** Horizontal text alignment.\n- 'general': Context-based (left for text, right for numbers) - Excel default\n- 'left': Left-align text\n- 'center': Center text\n- 'right': Right-align text\n- 'fill': Repeat content to fill cell width\n- 'justify': Justify text (distribute evenly)\n- 'centerContinuous': Center across selection without merging\n- 'distributed': Distribute text evenly with indent support */\n  horizontalAlign?: | 'general'\n    | 'left'\n    | 'center'\n    | 'right'\n    | 'fill'\n    | 'justify'\n    | 'centerContinuous'\n    | 'distributed';\n  /** Vertical text alignment.\n- 'top': Align to top of cell\n- 'middle': Center vertically (also known as 'center')\n- 'bottom': Align to bottom of cell - Excel default\n- 'justify': Justify vertically (distribute lines evenly)\n- 'distributed': Distribute text evenly with vertical spacing */\n  verticalAlign?: 'top' | 'middle' | 'bottom' | 'justify' | 'distributed';\n  wrapText?: boolean;\n  /** Text rotation angle in degrees.\n- 0-90: Counter-clockwise rotation\n- 91-180: Clockwise rotation (180 - value)\n- 255: Vertical text (stacked characters, read top-to-bottom) */\n  textRotation?: number;\n  /** Indent level (0-15).\nEach level adds approximately 8 pixels of indent from the cell edge.\nWorks with left and right horizontal alignment. */\n  indent?: number;\n  /** Shrink text to fit cell width.\nReduces font size to fit all text within the cell width.\nMutually exclusive with wrapText in Excel behavior. */\n  shrinkToFit?: boolean;\n  /** Text reading order for bidirectional text support.\n- 'context': Determined by first character with strong directionality\n- 'ltr': Left-to-right (forced)\n- 'rtl': Right-to-left (forced) */\n  readingOrder?: 'context' | 'ltr' | 'rtl';\n  /** Background color. Can be:\n- Absolute hex: '#ffffff' or '#c6efce'\n- Theme reference: 'theme:accent1' (uses current theme's accent1 color)\n- Theme with tint: 'theme:accent1:0.4' (40% lighter) or 'theme:accent1:-0.25' (25% darker)\n\nTheme references are resolved at render time via resolveThemeColors().\nThis enables cells to automatically update when the workbook theme changes.\n\nFor solid fills, this is the only color needed.\nFor pattern fills, this is the background color behind the pattern.\n\n@see resolveThemeColors in theme.ts for resolution\n@see ThemeColorSlot for valid slot names (dark1, light1, accent1-6, etc.) */\n  backgroundColor?: string;\n  /** Pattern fill type.\nExcel supports 18 pattern types for cell backgrounds.\nWhen set (and not 'none' or 'solid'), the cell uses a pattern fill. */\n  patternType?: PatternType;\n  /** Pattern foreground color.\nThe color of the pattern itself (dots, lines, etc.).\nOnly used when patternType is set to a non-solid pattern. */\n  patternForegroundColor?: string;\n  /** Gradient fill configuration.\nWhen set, overrides backgroundColor and pattern fill.\nExcel supports linear and path (radial) gradients. */\n  gradientFill?: GradientFill;\n  /** Cell borders (top, right, bottom, left, diagonal) */\n  borders?: CellBorders;\n  /** Cell is locked when sheet protection is enabled.\nDefault is true in Excel (all cells locked by default).\nOnly effective when the sheet's isProtected flag is true. */\n  locked?: boolean;\n  /** Formula is hidden when sheet protection is enabled.\nWhen true, the cell's formula is not shown in the formula bar.\nThe computed value is still displayed in the cell.\nOnly effective when the sheet's isProtected flag is true. */\n  hidden?: boolean;\n  /** Cell value is forced to text mode (apostrophe prefix).\nWhen true:\n- Raw value includes the leading apostrophe\n- Display value strips the apostrophe\n- Formula bar shows the apostrophe\n- Value is NOT coerced to date/number/etc.\n\nSet when user types ' as first character.\nFollows cell on sort/move (keyed by CellId, Cell Identity Model).\n\n@see plans/active/excel-parity/08-EDITING.md - Item 8.1 */\n  forcedTextMode?: boolean;\n  /** Arbitrary extension data for future features.\nUse namespaced keys: \"myfeature.mykey\"\nExample: { ignoreError: true } to suppress error indicators. */\n  extensions?: Record<string, unknown>;\n}",
+		definition: "{\n  /** Excel-compatible number format code string.\n\nCommon format codes:\n- Currency:    '$#,##0.00'\n- Accounting:  '_($* #,##0.00_);_($* (#,##0.00);_($* \"-\"??_);_(@_)'\n- Percentage:  '0.00%'\n- Date:        'M/D/YYYY', 'YYYY-MM-DD', 'MMM D, YYYY'\n- Time:        'h:mm AM/PM', 'HH:mm:ss'\n- Number:      '#,##0.00', '0.00'\n- Scientific:  '0.00E+00'\n- Text:        '@'\n- Fraction:    '# ?/?'\n\nSee the `formatPresets` section in api-spec.json for the full catalog\nof 85+ pre-defined format codes with examples.\n\n@example\n// Currency\n{ numberFormat: '$#,##0.00' }\n// Percentage with 1 decimal\n{ numberFormat: '0.0%' }\n// ISO date\n{ numberFormat: 'YYYY-MM-DD' } */\n  numberFormat?: string;\n  /** Number format category hint. Auto-detected from numberFormat when not set.\nValid values: 'general' | 'number' | 'currency' | 'accounting' | 'date' |\n             'time' | 'percentage' | 'fraction' | 'scientific' | 'text' |\n             'special' | 'custom' */\n  numberFormatType?: NumberFormatType;\n  fontFamily?: string;\n  fontSize?: number;\n  /** Theme font reference for Excel-compatible \"+Headings\" / \"+Body\" fonts.\n\nWhen set, the cell uses the theme's majorFont (headings) or minorFont (body)\ninstead of fontFamily. Theme fonts are resolved at render time, allowing cells\nto automatically update when the workbook theme changes.\n\nBehavior:\n- 'major': Uses theme.fonts.majorFont (e.g., 'Calibri Light' in Office theme)\n- 'minor': Uses theme.fonts.minorFont (e.g., 'Calibri' in Office theme)\n- undefined: Uses fontFamily property (or default font if not set)\n\nWhen fontTheme is set, fontFamily is ignored for rendering but may still be\nstored for fallback purposes. This matches Excel's behavior where \"+Headings\"\ncells can have a fontFamily that's used when the theme is unavailable.\n\n@see resolveThemeFonts in theme.ts for resolution\n@see ThemeFonts for theme font pair definition */\n  fontTheme?: 'major' | 'minor';\n  /** Font color. Can be:\n- Absolute hex: '#4472c4' or '#ff0000'\n- Theme reference: 'theme:accent1' (uses current theme's accent1 color)\n- Theme with tint: 'theme:accent1:0.4' (40% lighter) or 'theme:accent1:-0.25' (25% darker)\n\nTheme references are resolved at render time via resolveThemeColors().\nThis enables cells to automatically update when the workbook theme changes.\n\n@see resolveThemeColors in theme.ts for resolution\n@see ThemeColorSlot for valid slot names (dark1, light1, accent1-6, etc.) */\n  fontColor?: string;\n  bold?: boolean;\n  italic?: boolean;\n  /** Underline type. Excel supports 4 underline styles:\n- 'none': No underline (default)\n- 'single': Standard underline under all characters\n- 'double': Two parallel lines under all characters\n- 'singleAccounting': Underline under text only (not spaces), for column alignment\n- 'doubleAccounting': Double underline under text only (not spaces), for column alignment */\n  underlineType?: 'none' | 'single' | 'double' | 'singleAccounting' | 'doubleAccounting';\n  strikethrough?: boolean;\n  /** Superscript text (vertAlign = 'superscript' in Excel).\nText is rendered smaller and raised above the baseline. */\n  superscript?: boolean;\n  /** Subscript text (vertAlign = 'subscript' in Excel).\nText is rendered smaller and lowered below the baseline. */\n  subscript?: boolean;\n  /** Font outline effect.\nDraws only the outline of each character (hollow text).\nRare in modern spreadsheets but supported by Excel. */\n  fontOutline?: boolean;\n  /** Font shadow effect.\nAdds a shadow behind the text.\nRare in modern spreadsheets but supported by Excel. */\n  fontShadow?: boolean;\n  /** Horizontal text alignment.\n- 'general': Context-based (left for text, right for numbers) - Excel default\n- 'left': Left-align text\n- 'center': Center text\n- 'right': Right-align text\n- 'fill': Repeat content to fill cell width\n- 'justify': Justify text (distribute evenly)\n- 'centerContinuous': Center across selection without merging\n- 'distributed': Distribute text evenly with indent support */\n  horizontalAlign?: | 'general'\n    | 'left'\n    | 'center'\n    | 'right'\n    | 'fill'\n    | 'justify'\n    | 'centerContinuous'\n    | 'distributed';\n  /** Vertical text alignment.\n- 'top': Align to top of cell\n- 'middle': Center vertically (also known as 'center')\n- 'bottom': Align to bottom of cell - Excel default\n- 'justify': Justify vertically (distribute lines evenly)\n- 'distributed': Distribute text evenly with vertical spacing */\n  verticalAlign?: 'top' | 'middle' | 'bottom' | 'justify' | 'distributed';\n  wrapText?: boolean;\n  /** Text rotation angle in degrees.\n- 0-90: Counter-clockwise rotation\n- 91-180: Clockwise rotation (180 - value)\n- 255: Vertical text (stacked characters, read top-to-bottom) */\n  textRotation?: number;\n  /** Indent level (0-15).\nEach level adds approximately 8 pixels of indent from the cell edge.\nWorks with left and right horizontal alignment. */\n  indent?: number;\n  /** Shrink text to fit cell width.\nReduces font size to fit all text within the cell width.\nMutually exclusive with wrapText in Excel behavior. */\n  shrinkToFit?: boolean;\n  /** Text reading order for bidirectional text support.\n- 'context': Determined by first character with strong directionality\n- 'ltr': Left-to-right (forced)\n- 'rtl': Right-to-left (forced) */\n  readingOrder?: 'context' | 'ltr' | 'rtl';\n  /** Background color. Can be:\n- Absolute hex: '#ffffff' or '#c6efce'\n- Theme reference: 'theme:accent1' (uses current theme's accent1 color)\n- Theme with tint: 'theme:accent1:0.4' (40% lighter) or 'theme:accent1:-0.25' (25% darker)\n\nTheme references are resolved at render time via resolveThemeColors().\nThis enables cells to automatically update when the workbook theme changes.\n\nFor solid fills, this is the only color needed.\nFor pattern fills, this is the background color behind the pattern.\n\n@see resolveThemeColors in theme.ts for resolution\n@see ThemeColorSlot for valid slot names (dark1, light1, accent1-6, etc.) */\n  backgroundColor?: string;\n  /** Pattern fill type.\nExcel supports 18 pattern types for cell backgrounds.\nWhen set (and not 'none' or 'solid'), the cell uses a pattern fill. */\n  patternType?: PatternType;\n  /** Pattern foreground color.\nThe color of the pattern itself (dots, lines, etc.).\nOnly used when patternType is set to a non-solid pattern. */\n  patternForegroundColor?: string;\n  /** Gradient fill configuration.\nWhen set, overrides backgroundColor and pattern fill.\nExcel supports linear and path (radial) gradients. */\n  gradientFill?: GradientFill;\n  /** Cell borders (top, right, bottom, left, diagonal) */\n  borders?: CellBorders;\n  /** Cell is locked when sheet protection is enabled.\nDefault is true in Excel (all cells locked by default).\nOnly effective when the sheet's isProtected flag is true. */\n  locked?: boolean;\n  /** Formula is hidden when sheet protection is enabled.\nWhen true, the cell's formula is not shown in the formula bar.\nThe computed value is still displayed in the cell.\nOnly effective when the sheet's isProtected flag is true. */\n  hidden?: boolean;\n  /** Cell value is forced to text mode (apostrophe prefix).\nWhen true:\n- Raw value includes the leading apostrophe\n- Display value strips the apostrophe\n- Formula bar shows the apostrophe\n- Value is NOT coerced to date/number/etc.\n\nSet when user types ' as first character.\nFollows cell on sort/move (keyed by CellId, Cell Identity Model).\n\n@see plans/active/excel-parity/08-EDITING.md - Item 8.1 */\n  forcedTextMode?: boolean;\n  /** Arbitrary extension data for future features.\nUse namespaced keys: \"myfeature.mykey\"\nExample: { ignoreError: true } to suppress error indicators. */\n  extensions?: Record<string, unknown>;\n}",
 		docstring: "Cell formatting options\n\nThis interface defines ALL Excel format properties that can be applied to cells.\nThe implementation status of each property is tracked in format-registry.ts.\n\n@see FORMAT_PROPERTY_REGISTRY in format-registry.ts for implementation status"
 	},
 	CellRange: {
@@ -4026,12 +4041,12 @@ var types = {
 	},
 	ChartBorder: {
 		name: "ChartBorder",
-		definition: "{\n  color?: string;\n  width?: number;\n  style?: 'solid' | 'dashed' | 'dotted' | 'none';\n}",
-		docstring: "Shared chart border configuration"
+		definition: "{\n  color?: string;\n  width?: number;\n  style?: string;\n}",
+		docstring: "Shared chart border configuration (matches ChartBorderData wire type)"
 	},
 	ChartConfig: {
 		name: "ChartConfig",
-		definition: "{\n  type: ChartType;\n  /** Chart sub-type. For type-safe usage, prefer TypedChartConfig<T> which constrains subType to match type. */\n  subType?: BarSubType | LineSubType | AreaSubType | StockSubType | RadarSubType;\n  /** Anchor row (0-based) */\n  anchorRow: number;\n  /** Anchor column (0-based) */\n  anchorCol: number;\n  /** Chart width in cells */\n  width: number;\n  /** Chart height in cells */\n  height: number;\n  /** Data range in A1 notation (e.g., \"A1:D10\"). Optional when series[].values are provided. */\n  dataRange?: string;\n  /** Series labels range in A1 notation */\n  seriesRange?: string;\n  /** Category labels range in A1 notation */\n  categoryRange?: string;\n  seriesOrientation?: SeriesOrientation;\n  title?: string;\n  subtitle?: string;\n  legend?: LegendConfig;\n  axis?: AxisConfig;\n  colors?: string[];\n  series?: SeriesConfig[];\n  dataLabels?: DataLabelConfig;\n  pieSlice?: PieSliceConfig;\n  trendline?: TrendlineConfig;\n  /** Connect scatter points with lines (scatter-lines variant) */\n  showLines?: boolean;\n  /** Use smooth curves for scatter lines (scatter-smooth-lines variant) */\n  smoothLines?: boolean;\n  /** Fill area under radar lines */\n  radarFilled?: boolean;\n  /** Show markers on radar vertices */\n  radarMarkers?: boolean;\n  /** How blank cells are plotted: 'gap' (leave gap), 'zero' (treat as zero), 'span' (interpolate) */\n  displayBlanksAs?: 'gap' | 'zero' | 'span';\n  /** Whether to plot only visible cells (respecting row/column hiding) */\n  plotVisibleOnly?: boolean;\n  /** Gap width between bars/columns as percentage (0-500). Applied to bar/column chart types. */\n  gapWidth?: number;\n  /** Overlap between bars/columns (-100 to 100). Applied to clustered bar/column types. */\n  overlap?: number;\n  /** Hole size for doughnut charts as percentage (10-90) */\n  doughnutHoleSize?: number;\n  /** First slice angle for pie/doughnut charts in degrees (0-360) */\n  firstSliceAngle?: number;\n  /** Bubble scale for bubble charts as percentage (0-300) */\n  bubbleScale?: number;\n  /** Split type for of-pie charts (pie-of-pie, bar-of-pie) */\n  splitType?: 'auto' | 'value' | 'percent' | 'position' | 'custom';\n  /** Split value threshold for of-pie charts */\n  splitValue?: number;\n  waterfall?: WaterfallConfig;\n  histogram?: HistogramConfig;\n  boxplot?: BoxplotConfig;\n  heatmap?: HeatmapConfig;\n  violin?: ViolinConfig;\n  name?: string;\n  chartTitle?: TitleConfig;\n  chartArea?: ChartAreaConfig;\n  plotArea?: PlotAreaConfig;\n  /** Z-order command for layering charts.\nAccepted as a convenience field by ws.charts.update() to adjust z-index:\n- 'front': bring to top of stack\n- 'back': send to bottom of stack\n- 'forward': move one layer up\n- 'backward': move one layer down */\n  zOrder?: 'front' | 'back' | 'forward' | 'backward';\n  /** Extensible extra data for enriched chart configurations.\nContains additional chart-specific settings (e.g., chartTitle font, chartArea fill)\nthat are stored on the chart but not part of the core config schema. */\n  extra?: unknown;\n}",
+		definition: "{\n  type: ChartType;\n  /** Chart sub-type. For type-safe usage, prefer TypedChartConfig<T> which constrains subType to match type. */\n  subType?: BarSubType | LineSubType | AreaSubType | StockSubType | RadarSubType;\n  /** Anchor row (0-based) */\n  anchorRow: number;\n  /** Anchor column (0-based) */\n  anchorCol: number;\n  /** Chart width in cells */\n  width: number;\n  /** Chart height in cells */\n  height: number;\n  /** Data range in A1 notation (e.g., \"A1:D10\"). Optional when series[].values are provided. */\n  dataRange?: string;\n  /** Series labels range in A1 notation */\n  seriesRange?: string;\n  /** Category labels range in A1 notation */\n  categoryRange?: string;\n  seriesOrientation?: SeriesOrientation;\n  title?: string;\n  subtitle?: string;\n  legend?: LegendConfig;\n  axis?: AxisConfig;\n  colors?: string[];\n  series?: SeriesConfig[];\n  dataLabels?: DataLabelConfig;\n  pieSlice?: PieSliceConfig;\n  /** @deprecated Use trendlines[] instead — kept for backward compat */\n  trendline?: TrendlineConfig;\n  /** Wire-compatible trendline array */\n  trendlines?: TrendlineConfig[];\n  /** Connect scatter points with lines (scatter-lines variant) */\n  showLines?: boolean;\n  /** Use smooth curves for scatter lines (scatter-smooth-lines variant) */\n  smoothLines?: boolean;\n  /** Fill area under radar lines */\n  radarFilled?: boolean;\n  /** Show markers on radar vertices */\n  radarMarkers?: boolean;\n  /** How blank cells are plotted: 'gap' (leave gap), 'zero' (treat as zero), 'span' (interpolate) */\n  displayBlanksAs?: 'gap' | 'zero' | 'span';\n  /** Whether to plot only visible cells (respecting row/column hiding) */\n  plotVisibleOnly?: boolean;\n  /** Gap width between bars/columns as percentage (0-500). Applied to bar/column chart types. */\n  gapWidth?: number;\n  /** Overlap between bars/columns (-100 to 100). Applied to clustered bar/column types. */\n  overlap?: number;\n  /** Hole size for doughnut charts as percentage (10-90) */\n  doughnutHoleSize?: number;\n  /** First slice angle for pie/doughnut charts in degrees (0-360) */\n  firstSliceAngle?: number;\n  /** Bubble scale for bubble charts as percentage (0-300) */\n  bubbleScale?: number;\n  /** Split type for of-pie charts (pie-of-pie, bar-of-pie) */\n  splitType?: 'auto' | 'value' | 'percent' | 'position' | 'custom';\n  /** Split value threshold for of-pie charts */\n  splitValue?: number;\n  waterfall?: WaterfallConfig;\n  histogram?: HistogramConfig;\n  boxplot?: BoxplotConfig;\n  heatmap?: HeatmapConfig;\n  violin?: ViolinConfig;\n  name?: string;\n  chartTitle?: TitleConfig;\n  chartArea?: ChartAreaConfig;\n  plotArea?: PlotAreaConfig;\n  /** Z-order command for layering charts.\nAccepted as a convenience field by ws.charts.update() to adjust z-index:\n- 'front': bring to top of stack\n- 'back': send to bottom of stack\n- 'forward': move one layer up\n- 'backward': move one layer down */\n  zOrder?: 'front' | 'back' | 'forward' | 'backward';\n  /** Extensible extra data for enriched chart configurations.\nContains additional chart-specific settings (e.g., chartTitle font, chartArea fill)\nthat are stored on the chart but not part of the core config schema. */\n  extra?: unknown;\n}",
 		docstring: "Public chart configuration -- the shape used by the unified API surface.\n\nThis contains all user-facing fields for creating/updating charts.\nInternal-only fields (CellId anchors, zIndex, table linking cache)\nare defined in StoredChartConfig in the charts package."
 	},
 	ChartFill: {
@@ -4094,11 +4109,6 @@ var types = {
 		definition: "{\n  /** Column index to write to (0-indexed) */\n  columnIndex: number;\n  /** JSONPath or field name to extract from data */\n  dataPath: string;\n  /** Optional transform formula (receives value as input) */\n  transform?: string;\n  /** Header text (if headerRow >= 0) */\n  headerText?: string;\n}",
 		docstring: "Column mapping for a sheet data binding."
 	},
-	Comment: {
-		name: "Comment",
-		definition: "{\n  id: string;\n  cellId: string;\n  cellAddress: string;\n  text: string;\n  author: string;\n  threadId?: string;\n  resolved?: boolean;\n  createdAt?: number;\n  parentId?: string;\n  authorId?: string;\n  modifiedAt?: number;\n  content?: RichTextSegment[];\n}",
-		docstring: "A cell comment (thread-aware)."
-	},
 	ConditionalFormat: {
 		name: "ConditionalFormat",
 		definition: "{\n  /** Unique format identifier. */\n  id: string;\n  /** Cell ranges this format applies to. */\n  ranges: CellRange[];\n  /** Rules to evaluate (sorted by priority). */\n  rules: CFRule[];\n}",
@@ -4156,8 +4166,8 @@ var types = {
 	},
 	DataLabelConfig: {
 		name: "DataLabelConfig",
-		definition: "{\n  show: boolean;\n  position?: 'inside' | 'outside' | 'top' | 'bottom' | 'left' | 'right';\n  format?: string;\n  showCategoryName?: boolean;\n  showSeriesName?: boolean;\n  showPercentage?: boolean;\n  showBubbleSize?: boolean;\n  showLegendKey?: boolean;\n  separator?: string;\n  /** Show leader lines connecting data labels to their data points (pie/doughnut charts) */\n  showLeaderLines?: boolean;\n}",
-		docstring: "Data label configuration"
+		definition: "{\n  show: boolean;\n  position?: string;\n  format?: string;\n  showValue?: boolean;\n  showCategoryName?: boolean;\n  showSeriesName?: boolean;\n  showPercentage?: boolean;\n  showBubbleSize?: boolean;\n  showLegendKey?: boolean;\n  separator?: string;\n  showLeaderLines?: boolean;\n  text?: string;\n}",
+		docstring: "Data label configuration (matches DataLabelData wire type)"
 	},
 	DatePeriod: {
 		name: "DatePeriod",
@@ -4211,8 +4221,8 @@ var types = {
 	},
 	ErrorBarConfig: {
 		name: "ErrorBarConfig",
-		definition: "{\n  visible?: boolean;\n  type?: 'fixedValue' | 'percentage' | 'standardDeviation' | 'standardError' | 'custom';\n  include?: 'both' | 'plus' | 'minus';\n  value?: number;\n}",
-		docstring: "Error bar configuration for series"
+		definition: "{\n  visible?: boolean;\n  direction?: string;\n  barType?: string;\n  valueType?: string;\n  value?: number;\n  noEndCap?: boolean;\n}",
+		docstring: "Error bar configuration for series (matches ErrorBarData wire type)"
 	},
 	ErrorVariant: {
 		name: "ErrorVariant",
@@ -4251,7 +4261,7 @@ var types = {
 	},
 	FilterDetailInfo: {
 		name: "FilterDetailInfo",
-		definition: "{\n  /** Filter ID */\n  id: string;\n  /** Resolved numeric range of the filter */\n  range: { startRow: number; startCol: number; endRow: number; endCol: number };\n  /** Per-column filter criteria, keyed by header cell ID */\n  columnFilters: Record<string, ColumnFilterCriteria>;\n}",
+		definition: "{\n  /** Filter ID */\n  id: string;\n  /** Resolved numeric range of the filter */\n  range: { startRow: number; startCol: number; endRow: number; endCol: number };\n  /** Per-column filter criteria, keyed by header cell ID */\n  columnFilters: Record<string, ColumnFilter>;\n}",
 		docstring: "Detailed filter information including resolved numeric range and column filters."
 	},
 	FilterInfo: {
@@ -4266,8 +4276,8 @@ var types = {
 	},
 	FilterState: {
 		name: "FilterState",
-		definition: "{\n  /** The range the auto-filter is applied to (A1 notation) */\n  range: string;\n  /** Per-column filter criteria, keyed by column index */\n  columns: Map<number, ColumnFilterCriteria>;\n}",
-		docstring: "Current auto-filter state for a sheet."
+		definition: "{\n  /** The range the auto-filter is applied to (A1 notation) */\n  range: string;\n  /** Per-column filter criteria, keyed by column identifier (string) */\n  columnFilters: Record<string, ColumnFilter>;\n}",
+		docstring: "API filter state — derived from Rust FilterState with A1-notation range."
 	},
 	FloatingObject: {
 		name: "FloatingObject",
@@ -4356,13 +4366,8 @@ var types = {
 	},
 	LegendConfig: {
 		name: "LegendConfig",
-		definition: "{\n  show: boolean;\n  position: LegendPosition;\n  visible?: boolean;\n  overlay?: boolean;\n  font?: ChartFont;\n}",
-		docstring: "Legend configuration"
-	},
-	LegendPosition: {
-		name: "LegendPosition",
-		definition: "'top' | 'bottom' | 'left' | 'right' | 'none'",
-		docstring: "Legend position options"
+		definition: "{\n  show: boolean;\n  position: string;\n  visible: boolean;\n  overlay?: boolean;\n  font?: ChartFont;\n}",
+		docstring: "Legend configuration (matches LegendData wire type)"
 	},
 	LineDash: {
 		name: "LineDash",
@@ -4427,7 +4432,7 @@ var types = {
 	Note: {
 		name: "Note",
 		definition: "{\n  content: string;\n  author: string;\n  cellAddress: string;\n}",
-		docstring: "A cell note (simple, single string per cell)."
+		docstring: "A cell note (simple, single string per cell). API-only type (no Rust equivalent)."
 	},
 	NumberFormatCategory: {
 		name: "NumberFormatCategory",
@@ -4448,11 +4453,6 @@ var types = {
 		},
 		docstring: "Number format category classification.\nMatches the FormatType enum from Rust compute-formats."
 	},
-	NumberFormatType: {
-		name: "NumberFormatType",
-		definition: "| 'general'\n  | 'number'\n  | 'currency'\n  | 'accounting'\n  | 'date'\n  | 'time'\n  | 'percentage'\n  | 'fraction'\n  | 'scientific'\n  | 'text'\n  | 'special'\n  | 'custom'",
-		docstring: "Number format types"
-	},
 	ObjectAnchorType: {
 		name: "ObjectAnchorType",
 		definition: "| 'twoCell' // Anchored to two cells (moves and resizes with cells)\n  | 'oneCell' // Anchored to one cell (moves but doesn't resize)\n  | 'absolute'",
@@ -4550,8 +4550,8 @@ var types = {
 	},
 	PieSliceConfig: {
 		name: "PieSliceConfig",
-		definition: "{\n  /** Index of slice to explode (pull out from center) */\n  explodedIndex?: number;\n  /** Array of indices to explode */\n  explodedIndices?: number[];\n  /** Distance to explode (0-1, default 0.1) */\n  explodeOffset?: number;\n  /** Allow clicking to select/explode slices */\n  selectable?: boolean;\n}",
-		docstring: "Pie/doughnut slice configuration for exploded slices"
+		definition: "{\n  explosion?: number;\n  explodedIndices?: number[];\n  explodeOffset?: number;\n}",
+		docstring: "Pie/doughnut slice configuration (matches PieSliceData wire type)"
 	},
 	PivotQueryRecord: {
 		name: "PivotQueryRecord",
@@ -4590,8 +4590,8 @@ var types = {
 	},
 	PointFormat: {
 		name: "PointFormat",
-		definition: "{\n  fill?: string;\n  border?: ChartBorder;\n  dataLabel?: DataLabelConfig;\n}",
-		docstring: "Per-point formatting for individual data points in a series"
+		definition: "{\n  idx: number;\n  fill?: string;\n  border?: ChartBorder;\n  dataLabel?: DataLabelConfig;\n}",
+		docstring: "Per-point formatting for individual data points (matches PointFormatData wire type)"
 	},
 	PrintSettings: {
 		name: "PrintSettings",
@@ -4640,11 +4640,6 @@ var types = {
 		definition: "{\n  [K in keyof CellFormat]-?: CellFormat[K] | null;\n}",
 		docstring: "Dense cell format where every property is explicitly present (null when unset). Returned by formats.get()."
 	},
-	RichTextSegment: {
-		name: "RichTextSegment",
-		definition: "{\n  text: string;\n  bold?: boolean;\n  italic?: boolean;\n  underline?: boolean;\n  strikethrough?: boolean;\n  color?: string;\n  fontName?: string;\n  fontSize?: number;\n}",
-		docstring: "A single segment of rich text content."
-	},
 	Scenario: {
 		name: "Scenario",
 		definition: "{\n  /** Unique scenario ID */\n  id: string;\n  /** Creation timestamp (Unix ms) */\n  createdAt: number;\n}",
@@ -4672,8 +4667,8 @@ var types = {
 	},
 	SeriesConfig: {
 		name: "SeriesConfig",
-		definition: "{\n  name?: string;\n  type?: ChartType;\n  color?: string;\n  yAxisIndex?: 0 | 1;\n  showMarkers?: boolean;\n  markerSize?: number;\n  markerStyle?: | 'circle'\n    | 'dash'\n    | 'diamond'\n    | 'dot'\n    | 'picture'\n    | 'plus'\n    | 'square'\n    | 'star'\n    | 'triangle'\n    | 'x'\n    | 'auto'\n    | 'none';\n  lineWidth?: number;\n  smooth?: boolean;\n  dataLabels?: DataLabelConfig;\n  trendline?: TrendlineConfig;\n  errorBars?: ErrorBarConfig;\n  /** Separate X-axis error bars (for scatter/bubble charts) */\n  xErrorBars?: ErrorBarConfig;\n  /** Separate Y-axis error bars (for scatter/bubble charts) */\n  yErrorBars?: ErrorBarConfig;\n  /** Whether to invert the fill color for negative values */\n  invertIfNegative?: boolean;\n  /** Explosion distance for pie/doughnut per-series (0-400%) */\n  explosion?: number;\n  /** Data values range in A1 notation (e.g., \"B2:B10\") */\n  values?: string;\n  /** Category labels range in A1 notation (e.g., \"A2:A10\") */\n  categories?: string;\n  /** Per-point formatting overrides */\n  points?: PointFormat[];\n}",
-		docstring: "Individual series configuration"
+		definition: "{\n  name?: string;\n  type?: string;\n  color?: string;\n  values?: string;\n  categories?: string;\n  bubbleSize?: string;\n  smooth?: boolean;\n  explosion?: number;\n  invertIfNegative?: boolean;\n  yAxisIndex?: number;\n  showMarkers?: boolean;\n  markerSize?: number;\n  markerStyle?: string;\n  lineWidth?: number;\n  points?: PointFormat[];\n  dataLabels?: DataLabelConfig;\n  trendlines?: TrendlineConfig[];\n  errorBars?: ErrorBarConfig;\n  xErrorBars?: ErrorBarConfig;\n  yErrorBars?: ErrorBarConfig;\n  idx?: number;\n  order?: number;\n  /** @deprecated Use trendlines[] instead */\n  trendline?: TrendlineConfig;\n}",
+		docstring: "Individual series configuration (matches ChartSeriesData wire type)"
 	},
 	SeriesOrientation: {
 		name: "SeriesOrientation",
@@ -4750,6 +4745,11 @@ var types = {
 		definition: "{\n  /** Sheet ID */\n  id: string;\n  /** Sheet name */\n  name: string;\n  /** Sheet index (0-based) */\n  index: number;\n  /** Range containing all non-empty cells (A1 notation), or null if empty */\n  usedRange: string | null;\n  /** Number of cells with data */\n  cellCount: number;\n  /** Number of cells with formulas */\n  formulaCount: number;\n  /** Number of charts in this sheet */\n  chartCount: number;\n  /** Sheet dimensions */\n  dimensions: { rows: number; cols: number };\n}",
 		docstring: "A summary snapshot of a single sheet."
 	},
+	SingleAxisConfig: {
+		name: "SingleAxisConfig",
+		definition: "{\n  title?: string;\n  visible: boolean;\n  min?: number;\n  max?: number;\n  axisType?: string;\n  gridLines?: boolean;\n  minorGridLines?: boolean;\n  majorUnit?: number;\n  minorUnit?: number;\n  tickMarks?: string;\n  minorTickMarks?: string;\n  numberFormat?: string;\n  reverse?: boolean;\n  position?: string;\n  logBase?: number;\n  displayUnit?: string;\n  /** @deprecated Alias for axisType — kept for backward compat with charts package */\n  type?: AxisType;\n  /** @deprecated Alias for visible — kept for backward compat with charts package */\n  show?: boolean;\n}",
+		docstring: "Single axis configuration (matches SingleAxisData wire type)."
+	},
 	Slicer: {
 		name: "Slicer",
 		definition: "{\n  /** Currently selected filter items */\n  selectedItems: CellValue[];\n  /** Position and dimensions in pixels */\n  position: { x: number; y: number; width: number; height: number };\n}",
@@ -4757,7 +4757,7 @@ var types = {
 	},
 	SlicerConfig: {
 		name: "SlicerConfig",
-		definition: "{\n  /** Name of the table to connect the slicer to */\n  tableName?: string;\n  /** Column name within the table to filter on */\n  columnName?: string;\n  /** Display name for the slicer (auto-generated if omitted) */\n  name?: string;\n  /** Position and dimensions in pixels */\n  position?: { x: number; y: number; width: number; height: number };\n  /** Data source connection (rich alternative to tableName/columnName) */\n  source?: SlicerSource;\n  /** Slicer caption (header text) */\n  caption?: string;\n  /** Style configuration (partial for incremental updates) */\n  style?: Partial<SlicerStyle>;\n  /** Show slicer header */\n  showHeader?: boolean;\n  /** Currently selected date range start (timeline slicers) */\n  selectedStartDate?: number;\n  /** Currently selected date range end (timeline slicers) */\n  selectedEndDate?: number;\n  /** Current aggregation level (timeline slicers) */\n  timelineLevel?: TimelineLevel;\n}",
+		definition: "{\n  /** Slicer ID (generated if omitted) */\n  id?: string;\n  /** Sheet ID the slicer belongs to */\n  sheetId?: string;\n  /** Name of the table to connect the slicer to */\n  tableName?: string;\n  /** Column name within the table to filter on */\n  columnName?: string;\n  /** Display name for the slicer (auto-generated if omitted) */\n  name?: string;\n  /** Position and dimensions in pixels */\n  position?: { x: number; y: number; width: number; height: number };\n  /** Data source connection (rich alternative to tableName/columnName) */\n  source?: SlicerSource;\n  /** Slicer caption (header text) */\n  caption?: string;\n  /** Style configuration */\n  style?: SlicerStyle;\n  /** Show slicer header */\n  showHeader?: boolean;\n  /** Z-order within the sheet */\n  zIndex?: number;\n  /** Whether slicer position is locked */\n  locked?: boolean;\n  /** Whether multi-select is enabled */\n  multiSelect?: boolean;\n  /** Initial selected values */\n  selectedValues?: CellValue[];\n  /** Currently selected date range start (timeline slicers) */\n  selectedStartDate?: number;\n  /** Currently selected date range end (timeline slicers) */\n  selectedEndDate?: number;\n  /** Current aggregation level (timeline slicers) */\n  timelineLevel?: TimelineLevel;\n}",
 		docstring: "Configuration for creating a new slicer."
 	},
 	SlicerCustomStyle: {
@@ -4867,13 +4867,13 @@ var types = {
 	},
 	TableColumn: {
 		name: "TableColumn",
-		definition: "{\n  /** Column header name */\n  name: string;\n  /** Column index within the table (0-based) */\n  index: number;\n  /** Total row function type */\n  totalFunction?: TotalFunction;\n  /** Calculated column formula */\n  calculatedFormula?: string;\n}",
-		docstring: "A single column in a table."
+		definition: "{\n  /** Unique column ID */\n  id: string;\n  /** Column header name */\n  name: string;\n  /** Column index within the table (0-based) */\n  index: number;\n  /** Total row function type */\n  totalsFunction: TotalsFunction | null;\n  /** Total row label */\n  totalsLabel: string | null;\n  /** Calculated column formula */\n  calculatedFormula?: string;\n}",
+		docstring: "A single column in a table.\n\nField names match the Rust-generated `TableColumn` type (compute-types.gen.ts)."
 	},
 	TableInfo: {
 		name: "TableInfo",
-		definition: "{\n  /** Internal table identifier (opaque string) */\n  id?: string;\n  /** Table name */\n  name: string;\n  /** Table range in A1 notation */\n  range: string;\n  /** Whether the table has a header row */\n  hasHeaders: boolean;\n  /** Table style preset name */\n  style?: TableStylePreset;\n  /** Column definitions */\n  columns: TableColumn[];\n  /** Whether the total row is visible */\n  showTotals?: boolean;\n  /** Whether first column is highlighted */\n  highlightFirstColumn?: boolean;\n  /** Whether last column is highlighted */\n  highlightLastColumn?: boolean;\n  /** Whether banded columns are shown */\n  showBandedColumns?: boolean;\n  /** Whether banded rows are shown */\n  showBandedRows?: boolean;\n  /** Whether filter buttons are shown */\n  showFilterButton?: boolean;\n  /** Whether the header row is shown (mirrors hasHeaders) */\n  showHeaders?: boolean;\n}",
-		docstring: "Information about an existing table."
+		definition: "{\n  /** Internal table identifier */\n  id: string;\n  /** Table name */\n  name: string;\n  /** Display name */\n  displayName: string;\n  /** Sheet the table belongs to */\n  sheetId: string;\n  /** Table range in A1 notation (converted from Rust SheetRange) */\n  range: string;\n  /** Column definitions */\n  columns: TableColumn[];\n  /** Whether the table has a header row */\n  hasHeaderRow: boolean;\n  /** Whether the totals row is visible */\n  hasTotalsRow: boolean;\n  /** Table style name */\n  style: string;\n  /** Whether banded rows are shown */\n  bandedRows: boolean;\n  /** Whether banded columns are shown */\n  bandedColumns: boolean;\n  /** Whether first column is emphasized */\n  emphasizeFirstColumn: boolean;\n  /** Whether last column is emphasized */\n  emphasizeLastColumn: boolean;\n  /** Whether filter buttons are shown */\n  showFilterButtons: boolean;\n}",
+		docstring: "Information about an existing table.\n\nField names match the Rust-generated `Table` type (compute-types.gen.ts)\nexcept `range` which is converted from `SheetRange` to A1 notation string."
 	},
 	TableOptions: {
 		name: "TableOptions",
@@ -4885,16 +4885,6 @@ var types = {
 		definition: "{\n  /** Style name */\n  name: string;\n}",
 		docstring: "Configuration for creating/updating a custom table style."
 	},
-	TableStyleInfo: {
-		name: "TableStyleInfo",
-		definition: "{\n  /** Style name/ID */\n  name: string;\n  /** Display name */\n  displayName?: string;\n  /** Whether this is a built-in style */\n  isBuiltIn?: boolean;\n}",
-		docstring: "Information about a custom table style."
-	},
-	TableStylePreset: {
-		name: "TableStylePreset",
-		definition: "| 'none'\n  // Light styles\n  | 'light1'\n  | 'light2'\n  | 'light3'\n  | 'light4'\n  | 'light5'\n  | 'light6'\n  | 'light7'\n  | 'light8'\n  | 'light9'\n  | 'light10'\n  | 'light11'\n  | 'light12'\n  | 'light13'\n  | 'light14'\n  | 'light15'\n  | 'light16'\n  | 'light17'\n  | 'light18'\n  | 'light19'\n  | 'light20'\n  | 'light21'\n  // Medium styles\n  | 'medium1'\n  | 'medium2'\n  | 'medium3'\n  | 'medium4'\n  | 'medium5'\n  | 'medium6'\n  | 'medium7'\n  | 'medium8'\n  | 'medium9'\n  | 'medium10'\n  | 'medium11'\n  | 'medium12'\n  | 'medium13'\n  | 'medium14'\n  | 'medium15'\n  | 'medium16'\n  | 'medium17'\n  | 'medium18'\n  | 'medium19'\n  | 'medium20'\n  | 'medium21'\n  | 'medium22'\n  | 'medium23'\n  | 'medium24'\n  | 'medium25'\n  | 'medium26'\n  | 'medium27'\n  | 'medium28'\n  // Dark styles\n  | 'dark1'\n  | 'dark2'\n  | 'dark3'\n  | 'dark4'\n  | 'dark5'\n  | 'dark6'\n  | 'dark7'\n  | 'dark8'\n  | 'dark9'\n  | 'dark10'\n  | 'dark11'",
-		docstring: "Table style presets matching Excel's table style gallery.\nLight styles (1-21), Medium styles (1-28), Dark styles (1-11)."
-	},
 	TextBoxBorder: {
 		name: "TextBoxBorder",
 		definition: "{\n  /** Corner radius in pixels (for rounded corners) */\n  radius?: number;\n}",
@@ -4945,20 +4935,15 @@ var types = {
 		definition: "{\n  text?: string;\n  visible?: boolean;\n  position?: 'top' | 'bottom' | 'left' | 'right' | 'overlay';\n  font?: ChartFont;\n}",
 		docstring: "Rich title configuration"
 	},
-	TotalFunction: {
-		name: "TotalFunction",
-		definition: "| 'none'\n  | 'sum'\n  | 'count'\n  | 'average'\n  | 'min'\n  | 'max'\n  | 'stdDev'\n  | 'var'\n  | 'countNums'\n  | 'custom'",
-		docstring: "Total row function types.\nMaps to Excel's total row dropdown options."
+	TotalsFunction: {
+		name: "TotalsFunction",
+		definition: "| 'average'\n  | 'count'\n  | 'countNums'\n  | 'max'\n  | 'min'\n  | 'stdDev'\n  | 'sum'\n  | 'var'\n  | 'custom'\n  | 'none'",
+		docstring: "Totals function type (matches Rust TotalsFunction)."
 	},
 	TrendlineConfig: {
 		name: "TrendlineConfig",
-		definition: "{\n  show: boolean;\n  type: TrendlineType;\n  color?: string;\n  lineWidth?: number;\n  showEquation?: boolean;\n  showR2?: boolean;\n  order?: number;\n  period?: number;\n  intercept?: number;\n  forwardPeriod?: number;\n  backwardPeriod?: number;\n  name?: string;\n}",
-		docstring: "Trendline configuration"
-	},
-	TrendlineType: {
-		name: "TrendlineType",
-		definition: "| 'linear'\n  | 'exponential'\n  | 'logarithmic'\n  | 'polynomial'\n  | 'power'\n  | 'moving-average'",
-		docstring: "Trendline types for scatter charts"
+		definition: "{\n  show?: boolean;\n  type?: string;\n  color?: string;\n  lineWidth?: number;\n  order?: number;\n  period?: number;\n  forward?: number;\n  backward?: number;\n  intercept?: number;\n  displayEquation?: boolean;\n  displayRSquared?: boolean;\n  name?: string;\n  /** @deprecated Use displayEquation instead */\n  showEquation?: boolean;\n  /** @deprecated Use displayRSquared instead */\n  showR2?: boolean;\n  /** @deprecated Use forward instead */\n  forwardPeriod?: number;\n  /** @deprecated Use backward instead */\n  backwardPeriod?: number;\n}",
+		docstring: "Trendline configuration (matches TrendlineData wire type)"
 	},
 	UndoHistoryEntry: {
 		name: "UndoHistoryEntry",
@@ -5036,10 +5021,422 @@ var types = {
 		docstring: "A summary snapshot of the entire workbook state."
 	}
 };
+var formatPresets = {
+	general: {
+		"default": {
+			code: "General",
+			description: "",
+			example: "1234.5"
+		}
+	},
+	number: {
+		integer: {
+			code: "0",
+			description: "No decimal places",
+			example: "1235"
+		},
+		decimal1: {
+			code: "0.0",
+			description: "1 decimal place",
+			example: "1234.5"
+		},
+		decimal2: {
+			code: "0.00",
+			description: "2 decimal places",
+			example: "1234.50"
+		},
+		decimal3: {
+			code: "0.000",
+			description: "3 decimal places",
+			example: "1234.500"
+		},
+		thousands: {
+			code: "#,##0",
+			description: "Thousands separator, no decimals",
+			example: "1,235"
+		},
+		thousandsDecimal1: {
+			code: "#,##0.0",
+			description: "Thousands separator, 1 decimal",
+			example: "1,234.5"
+		},
+		thousandsDecimal2: {
+			code: "#,##0.00",
+			description: "Thousands separator, 2 decimals",
+			example: "1,234.50"
+		},
+		negativeRed: {
+			code: "#,##0.00;[Red]-#,##0.00",
+			description: "Red negative numbers",
+			example: "-1,234.50"
+		},
+		negativeParens: {
+			code: "#,##0.00;(#,##0.00)",
+			description: "Parentheses for negatives",
+			example: "(1,234.50)"
+		},
+		negativeParensRed: {
+			code: "#,##0.00;[Red](#,##0.00)",
+			description: "Red parentheses for negatives",
+			example: "(1,234.50)"
+		}
+	},
+	currency: {
+		usd: {
+			code: "$#,##0.00",
+			description: "US Dollar",
+			example: "$1,234.50"
+		},
+		usdNegMinus: {
+			code: "$#,##0.00;-$#,##0.00",
+			description: "USD minus",
+			example: "-$1,234.50"
+		},
+		usdNegParens: {
+			code: "$#,##0.00;($#,##0.00)",
+			description: "USD parentheses",
+			example: "($1,234.50)"
+		},
+		usdNegRed: {
+			code: "$#,##0.00;[Red]-$#,##0.00",
+			description: "USD red minus",
+			example: "-$1,234.50"
+		},
+		usdNegParensRed: {
+			code: "$#,##0.00;[Red]($#,##0.00)",
+			description: "USD red parentheses",
+			example: "($1,234.50)"
+		},
+		eur: {
+			code: "€#,##0.00",
+			description: "Euro",
+			example: "€1,234.50"
+		},
+		gbp: {
+			code: "£#,##0.00",
+			description: "British Pound",
+			example: "£1,234.50"
+		},
+		jpy: {
+			code: "¥#,##0",
+			description: "Japanese Yen (no decimals)",
+			example: "¥1,235"
+		},
+		cny: {
+			code: "¥#,##0.00",
+			description: "Chinese Yuan",
+			example: "¥1,234.50"
+		},
+		inr: {
+			code: "₹#,##0.00",
+			description: "Indian Rupee",
+			example: "₹1,234.50"
+		},
+		krw: {
+			code: "₩#,##0",
+			description: "Korean Won (no decimals)",
+			example: "₩1,235"
+		},
+		chf: {
+			code: "CHF #,##0.00",
+			description: "Swiss Franc",
+			example: "CHF 1,234.50"
+		},
+		cad: {
+			code: "CA$#,##0.00",
+			description: "Canadian Dollar",
+			example: "CA$1,234.50"
+		},
+		aud: {
+			code: "A$#,##0.00",
+			description: "Australian Dollar",
+			example: "A$1,234.50"
+		}
+	},
+	accounting: {
+		usd: {
+			code: "_($* #,##0.00_);_($* (#,##0.00);_($* \"-\"??_);_(@_)",
+			description: "USD Accounting",
+			example: "$ 1,234.50"
+		},
+		eur: {
+			code: "_(€* #,##0.00_);_(€* (#,##0.00);_(€* \"-\"??_);_(@_)",
+			description: "EUR Accounting",
+			example: "€ 1,234.50"
+		},
+		gbp: {
+			code: "_(£* #,##0.00_);_(£* (#,##0.00);_(£* \"-\"??_);_(@_)",
+			description: "GBP Accounting",
+			example: "£ 1,234.50"
+		}
+	},
+	date: {
+		shortUS: {
+			code: "m/d/yyyy",
+			description: "Short date (US)",
+			example: "12/13/2025"
+		},
+		mediumUS: {
+			code: "mmm d, yyyy",
+			description: "Medium date (US)",
+			example: "Dec 13, 2025"
+		},
+		longUS: {
+			code: "mmmm d, yyyy",
+			description: "Long date (US)",
+			example: "December 13, 2025"
+		},
+		fullUS: {
+			code: "dddd, mmmm d, yyyy",
+			description: "Full date (US)",
+			example: "Saturday, December 13, 2025"
+		},
+		iso: {
+			code: "yyyy-mm-dd",
+			description: "ISO 8601",
+			example: "2025-12-13"
+		},
+		shortEU: {
+			code: "d/m/yyyy",
+			description: "Short date (EU)",
+			example: "13/12/2025"
+		},
+		mediumEU: {
+			code: "d mmm yyyy",
+			description: "Medium date (EU)",
+			example: "13 Dec 2025"
+		},
+		longEU: {
+			code: "d mmmm yyyy",
+			description: "Long date (EU)",
+			example: "13 December 2025"
+		},
+		monthYear: {
+			code: "mmmm yyyy",
+			description: "Month and year",
+			example: "December 2025"
+		},
+		monthYearShort: {
+			code: "mmm yyyy",
+			description: "Short month and year",
+			example: "Dec 2025"
+		},
+		dayMonth: {
+			code: "d mmmm",
+			description: "Day and month",
+			example: "13 December"
+		},
+		dayMonthShort: {
+			code: "d mmm",
+			description: "Short day and month",
+			example: "13 Dec"
+		},
+		excelShort: {
+			code: "m/d/yy",
+			description: "Excel short date",
+			example: "12/13/25"
+		},
+		excelMedium: {
+			code: "d-mmm-yy",
+			description: "Excel medium date",
+			example: "13-Dec-25"
+		},
+		excelLong: {
+			code: "d-mmm-yyyy",
+			description: "Excel long date",
+			example: "13-Dec-2025"
+		}
+	},
+	time: {
+		short12: {
+			code: "h:mm AM/PM",
+			description: "12-hour short",
+			example: "3:45 PM"
+		},
+		long12: {
+			code: "h:mm:ss AM/PM",
+			description: "12-hour with seconds",
+			example: "3:45:30 PM"
+		},
+		short24: {
+			code: "HH:mm",
+			description: "24-hour short",
+			example: "15:45"
+		},
+		long24: {
+			code: "HH:mm:ss",
+			description: "24-hour with seconds",
+			example: "15:45:30"
+		},
+		dateTime12: {
+			code: "m/d/yyyy h:mm AM/PM",
+			description: "Date and 12-hour time",
+			example: "12/13/2025 3:45 PM"
+		},
+		dateTime24: {
+			code: "yyyy-mm-dd HH:mm",
+			description: "ISO date and 24-hour time",
+			example: "2025-12-13 15:45"
+		},
+		durationHM: {
+			code: "[h]:mm",
+			description: "Hours and minutes (elapsed)",
+			example: "25:30"
+		},
+		durationHMS: {
+			code: "[h]:mm:ss",
+			description: "Hours, minutes, seconds (elapsed)",
+			example: "25:30:45"
+		},
+		durationMS: {
+			code: "[mm]:ss",
+			description: "Minutes and seconds (elapsed)",
+			example: "1530:45"
+		}
+	},
+	percentage: {
+		integer: {
+			code: "0%",
+			description: "No decimal places",
+			example: "50%"
+		},
+		decimal1: {
+			code: "0.0%",
+			description: "1 decimal place",
+			example: "50.0%"
+		},
+		decimal2: {
+			code: "0.00%",
+			description: "2 decimal places",
+			example: "50.00%"
+		},
+		decimal3: {
+			code: "0.000%",
+			description: "3 decimal places",
+			example: "50.000%"
+		}
+	},
+	fraction: {
+		halves: {
+			code: "# ?/2",
+			description: "Halves (1/2)",
+			example: "1 1/2"
+		},
+		quarters: {
+			code: "# ?/4",
+			description: "Quarters (1/4)",
+			example: "1 1/4"
+		},
+		eighths: {
+			code: "# ?/8",
+			description: "Eighths (1/8)",
+			example: "1 3/8"
+		},
+		sixteenths: {
+			code: "# ??/16",
+			description: "Sixteenths (1/16)",
+			example: "1 5/16"
+		},
+		tenths: {
+			code: "# ?/10",
+			description: "Tenths (1/10)",
+			example: "1 3/10"
+		},
+		hundredths: {
+			code: "# ??/100",
+			description: "Hundredths (1/100)",
+			example: "1 25/100"
+		},
+		upToOneDigit: {
+			code: "# ?/?",
+			description: "Up to one digit (1/4)",
+			example: "1 2/3"
+		},
+		upToTwoDigits: {
+			code: "# ??/??",
+			description: "Up to two digits (21/25)",
+			example: "1 25/67"
+		},
+		upToThreeDigits: {
+			code: "# ???/???",
+			description: "Up to three digits (312/943)",
+			example: "1 312/943"
+		}
+	},
+	scientific: {
+		"default": {
+			code: "0.00E+00",
+			description: "2 decimal places",
+			example: "1.23E+03"
+		},
+		decimal1: {
+			code: "0.0E+00",
+			description: "1 decimal place",
+			example: "1.2E+03"
+		},
+		decimal3: {
+			code: "0.000E+00",
+			description: "3 decimal places",
+			example: "1.235E+03"
+		},
+		noDecimals: {
+			code: "0E+00",
+			description: "No decimal places",
+			example: "1E+03"
+		}
+	},
+	text: {
+		"default": {
+			code: "@",
+			description: "Display as entered",
+			example: "1234"
+		}
+	},
+	special: {
+		zipCode: {
+			code: "00000",
+			description: "ZIP Code (5-digit)",
+			example: "01234"
+		},
+		zipPlus4: {
+			code: "00000-0000",
+			description: "ZIP+4 Code",
+			example: "01234-5678"
+		},
+		phone: {
+			code: "(###) ###-####",
+			description: "Phone Number",
+			example: "(555) 123-4567"
+		},
+		ssn: {
+			code: "000-00-0000",
+			description: "Social Security Number",
+			example: "123-45-6789"
+		}
+	},
+	custom: {
+	}
+};
+var defaultFormats = {
+	accounting: "_($* #,##0.00_);_($* (#,##0.00);_($* \"-\"??_);_(@_)",
+	currency: "$#,##0.00",
+	custom: "General",
+	date: "m/d/yyyy",
+	fraction: "# ?/?",
+	general: "General",
+	number: "#,##0.00",
+	percentage: "0.00%",
+	scientific: "0.00E+00",
+	special: "00000",
+	text: "@",
+	time: "h:mm AM/PM"
+};
 var apiSpec = {
 	subApis: subApis,
 	interfaces: interfaces,
-	types: types
+	types: types,
+	formatPresets: formatPresets,
+	defaultFormats: defaultFormats
 };
 
 /**