@pixerate/editor 0.22.0 → 0.24.0

package/dist/serializers/index.js

@@ -9,7 +9,7 @@ import {
   rtfToPlainText,
   sanitizeImportedHtml,
   serializeRichClipboardPayload
-} from "../chunk-JJDLPEWL.js";
+} from "../chunk-3LV6RRPH.js";
 import {
   MARKDOWN_MENTION_SPLIT_REGEX,
   MENTION_REGEX,
@@ -27,7 +27,8 @@ import {
   preprocessMarkdownMentions,
   sanitizeHtml,
   stripMarkdownCode
-} from "../chunk-MJZBNWG7.js";
+} from "../chunk-PGNZKFQS.js";
+import "../chunk-5S3Z4PPF.js";
 export {
   MARKDOWN_MENTION_SPLIT_REGEX,
   MENTION_REGEX,

package/dist/sourcemap-C8AH3MBQ.d.cts

@@ -0,0 +1,91 @@
+import { P as PromptValues, T as Template, a as PromptDiagnostic } from './tokens-D7yXvUU6.cjs';
+
+interface ResolveTemplatesOptions {
+    bindings?: Record<string, string>;
+    maxDepth?: number;
+    /**
+     * Values for `{variable}` slots and `{?variable}` sections. When omitted,
+     * variables, defaults and section tags are left exactly as written.
+     */
+    values?: PromptValues;
+}
+/**
+ * Recursively resolves template tags `{{template_name}}` in a given text.
+ * A tag that would recurse into itself is replaced with `TEMPLATE_LOOP_ERROR`,
+ * and a tag nested deeper than `maxDepth` with `TEMPLATE_DEPTH_ERROR`; the rest
+ * of the text still resolves normally.
+ *
+ * Pass `options.values` to also fill variables (falling back to their
+ * `{name|default}`) and evaluate `{?name}…{/name}` / `{!name}…{/name}`
+ * sections, including those inside template bodies. See `resolvePrompt` for
+ * the source map and diagnostics.
+ */
+declare function resolveTemplates(text: string, templates?: Template[], options?: ResolveTemplatesOptions): string;
+/**
+ * Replaces `{variableName}` with values from a dictionary, falling back to a
+ * `{variableName|default}` when no value is supplied, and evaluates
+ * `{?name}…{/name}` / `{!name}…{/name}` sections. Variables with neither a
+ * value nor a default are left as written. Templates are not expanded.
+ */
+declare function resolveVariables(text: string, values: PromptValues): string;
+/**
+ * Extracts unique template names referenced in text.
+ */
+declare function extractTemplateNames(text: string): string[];
+/**
+ * Extracts unique variable names referenced in text, including names used by
+ * conditional section tags (`amount` for `{?amount>100}…{/amount}`).
+ * Defaults and descriptions are stripped.
+ */
+declare function extractVariableNames(text: string): string[];
+/**
+ * Extracts unique instruction names referenced in text.
+ */
+declare function extractInstructionNames(text: string): string[];
+
+/**
+ * One contiguous piece of resolved output and the raw range it came from.
+ *
+ * - `raw`: copied verbatim; offsets map character by character.
+ * - `template`: the expansion of a `{{template}}` tag.
+ * - `variable`: a substituted value or `|default` for a `{variable}` tag.
+ * - `conditional`: a section tag, or a whole removed section. These segments
+ *   are empty in the resolved text (`resolvedStart === resolvedEnd`).
+ *
+ * Offsets inside non-raw segments map to the start of their raw range.
+ */
+interface SourceMapSegment {
+    resolvedStart: number;
+    resolvedEnd: number;
+    source: "raw" | "template" | "variable" | "conditional";
+    rawStart: number;
+    rawEnd: number;
+    templateName?: string;
+    /** Variable substituted (`variable`) or tested (`conditional`). */
+    variableName?: string;
+    /** For `variable` segments: whether a supplied value or the default was used. */
+    valueSource?: "value" | "default";
+}
+/**
+ * Resolves templates in text while tracking character offset mapping
+ * between the raw input and the fully resolved output.
+ *
+ * Pass `options.values` to also substitute variables and evaluate conditional
+ * sections (see `resolvePrompt`); without it the output is unchanged from the
+ * template-only behavior.
+ */
+declare function resolveTemplatesWithMapping(text: string, templates?: Template[], templateBindings?: Record<string, string>, options?: Pick<ResolveTemplatesOptions, "maxDepth" | "values">): {
+    text: string;
+    map: SourceMapSegment[];
+    diagnostics: PromptDiagnostic[];
+};
+/**
+ * Maps an offset in resolved text back to the corresponding offset in raw text.
+ */
+declare function mapResolvedOffsetToRaw(resolvedOffset: number, map: SourceMapSegment[]): number;
+/**
+ * Maps an offset in raw text to the corresponding offset in resolved text.
+ */
+declare function mapRawOffsetToResolved(rawOffset: number, map: SourceMapSegment[]): number;
+
+export { type ResolveTemplatesOptions as R, type SourceMapSegment as S, extractTemplateNames as a, extractVariableNames as b, mapResolvedOffsetToRaw as c, resolveTemplatesWithMapping as d, extractInstructionNames as e, resolveVariables as f, mapRawOffsetToResolved as m, resolveTemplates as r };

package/dist/sourcemap-DA1Evhrv.d.ts

@@ -0,0 +1,91 @@
+import { P as PromptValues, T as Template, a as PromptDiagnostic } from './tokens-D7yXvUU6.js';
+
+interface ResolveTemplatesOptions {
+    bindings?: Record<string, string>;
+    maxDepth?: number;
+    /**
+     * Values for `{variable}` slots and `{?variable}` sections. When omitted,
+     * variables, defaults and section tags are left exactly as written.
+     */
+    values?: PromptValues;
+}
+/**
+ * Recursively resolves template tags `{{template_name}}` in a given text.
+ * A tag that would recurse into itself is replaced with `TEMPLATE_LOOP_ERROR`,
+ * and a tag nested deeper than `maxDepth` with `TEMPLATE_DEPTH_ERROR`; the rest
+ * of the text still resolves normally.
+ *
+ * Pass `options.values` to also fill variables (falling back to their
+ * `{name|default}`) and evaluate `{?name}…{/name}` / `{!name}…{/name}`
+ * sections, including those inside template bodies. See `resolvePrompt` for
+ * the source map and diagnostics.
+ */
+declare function resolveTemplates(text: string, templates?: Template[], options?: ResolveTemplatesOptions): string;
+/**
+ * Replaces `{variableName}` with values from a dictionary, falling back to a
+ * `{variableName|default}` when no value is supplied, and evaluates
+ * `{?name}…{/name}` / `{!name}…{/name}` sections. Variables with neither a
+ * value nor a default are left as written. Templates are not expanded.
+ */
+declare function resolveVariables(text: string, values: PromptValues): string;
+/**
+ * Extracts unique template names referenced in text.
+ */
+declare function extractTemplateNames(text: string): string[];
+/**
+ * Extracts unique variable names referenced in text, including names used by
+ * conditional section tags (`amount` for `{?amount>100}…{/amount}`).
+ * Defaults and descriptions are stripped.
+ */
+declare function extractVariableNames(text: string): string[];
+/**
+ * Extracts unique instruction names referenced in text.
+ */
+declare function extractInstructionNames(text: string): string[];
+
+/**
+ * One contiguous piece of resolved output and the raw range it came from.
+ *
+ * - `raw`: copied verbatim; offsets map character by character.
+ * - `template`: the expansion of a `{{template}}` tag.
+ * - `variable`: a substituted value or `|default` for a `{variable}` tag.
+ * - `conditional`: a section tag, or a whole removed section. These segments
+ *   are empty in the resolved text (`resolvedStart === resolvedEnd`).
+ *
+ * Offsets inside non-raw segments map to the start of their raw range.
+ */
+interface SourceMapSegment {
+    resolvedStart: number;
+    resolvedEnd: number;
+    source: "raw" | "template" | "variable" | "conditional";
+    rawStart: number;
+    rawEnd: number;
+    templateName?: string;
+    /** Variable substituted (`variable`) or tested (`conditional`). */
+    variableName?: string;
+    /** For `variable` segments: whether a supplied value or the default was used. */
+    valueSource?: "value" | "default";
+}
+/**
+ * Resolves templates in text while tracking character offset mapping
+ * between the raw input and the fully resolved output.
+ *
+ * Pass `options.values` to also substitute variables and evaluate conditional
+ * sections (see `resolvePrompt`); without it the output is unchanged from the
+ * template-only behavior.
+ */
+declare function resolveTemplatesWithMapping(text: string, templates?: Template[], templateBindings?: Record<string, string>, options?: Pick<ResolveTemplatesOptions, "maxDepth" | "values">): {
+    text: string;
+    map: SourceMapSegment[];
+    diagnostics: PromptDiagnostic[];
+};
+/**
+ * Maps an offset in resolved text back to the corresponding offset in raw text.
+ */
+declare function mapResolvedOffsetToRaw(resolvedOffset: number, map: SourceMapSegment[]): number;
+/**
+ * Maps an offset in raw text to the corresponding offset in resolved text.
+ */
+declare function mapRawOffsetToResolved(rawOffset: number, map: SourceMapSegment[]): number;
+
+export { type ResolveTemplatesOptions as R, type SourceMapSegment as S, extractTemplateNames as a, extractVariableNames as b, mapResolvedOffsetToRaw as c, resolveTemplatesWithMapping as d, extractInstructionNames as e, resolveVariables as f, mapRawOffsetToResolved as m, resolveTemplates as r };

package/dist/spreadsheet/index.cjs

@@ -52,16 +52,17 @@
 
 
 
-var _chunk6M3BCTBDcjs = require('../chunk-6M3BCTBD.cjs');
 
 
 
+var _chunkMA2F5KHFcjs = require('../chunk-MA2F5KHF.cjs');
 
 
 
 
 
 
+var _chunkTNNJXF46cjs = require('../chunk-TNNJXF46.cjs');
 
 
 
@@ -79,7 +80,6 @@ var _chunk6M3BCTBDcjs = require('../chunk-6M3BCTBD.cjs');
 
 
 
-var _chunkSAZRENEZcjs = require('../chunk-SAZRENEZ.cjs');
 
 
 
@@ -105,6 +105,7 @@ var _chunkSAZRENEZcjs = require('../chunk-SAZRENEZ.cjs');
 
 
 
+var _chunkMCSJFWAOcjs = require('../chunk-MCSJFWAO.cjs');
 
 
 
@@ -159,5 +160,54 @@ var _chunkSAZRENEZcjs = require('../chunk-SAZRENEZ.cjs');
 
 
 
-exports.DEFAULT_COLUMN_WIDTH = _chunk6M3BCTBDcjs.DEFAULT_COLUMN_WIDTH; exports.DEFAULT_ROW_HEIGHT = _chunk6M3BCTBDcjs.DEFAULT_ROW_HEIGHT; exports.DataSourceBinder = _chunk6M3BCTBDcjs.DataSourceBinder; exports.DependencyGraph = _chunk6M3BCTBDcjs.DependencyGraph; exports.FORMULA_ERRORS = _chunkSAZRENEZcjs.FORMULA_ERRORS; exports.FormulaEvaluator = _chunkSAZRENEZcjs.FormulaEvaluator; exports.FormulaParser = _chunkSAZRENEZcjs.FormulaParser; exports.MAX_FORMULA_ARRAY_SIZE = _chunkSAZRENEZcjs.MAX_FORMULA_ARRAY_SIZE; exports.SPREADSHEET_CLIPBOARD_MIME = _chunk6M3BCTBDcjs.SPREADSHEET_CLIPBOARD_MIME; exports.SPREADSHEET_IMPORT_ADAPTERS = _chunk6M3BCTBDcjs.SPREADSHEET_IMPORT_ADAPTERS; exports.SPREADSHEET_TABLE_ACTIONS = _chunk6M3BCTBDcjs.SPREADSHEET_TABLE_ACTIONS; exports.SpreadsheetController = _chunk6M3BCTBDcjs.SpreadsheetController; exports.WHOLE_COLUMN_END_ROW = _chunkSAZRENEZcjs.WHOLE_COLUMN_END_ROW; exports.aggregateValues = _chunk6M3BCTBDcjs.aggregateValues; exports.applyFormulaSuggestion = _chunk6M3BCTBDcjs.applyFormulaSuggestion; exports.bindSpreadsheetTableActions = _chunk6M3BCTBDcjs.bindSpreadsheetTableActions; exports.buildSpreadsheetView = _chunk6M3BCTBDcjs.buildSpreadsheetView; exports.checkFormulaArgumentCount = _chunkSAZRENEZcjs.checkFormulaArgumentCount; exports.clampMenuPosition = _chunk6M3BCTBDcjs.clampMenuPosition; exports.colNameToIndex = _chunkSAZRENEZcjs.colNameToIndex; exports.columnDependencyKey = _chunk6M3BCTBDcjs.columnDependencyKey; exports.compareCellValues = _chunk6M3BCTBDcjs.compareCellValues; exports.computeFillTarget = _chunk6M3BCTBDcjs.computeFillTarget; exports.computeRowGroups = _chunk6M3BCTBDcjs.computeRowGroups; exports.createSpreadsheetClipboardData = _chunk6M3BCTBDcjs.createSpreadsheetClipboardData; exports.csvImportAdapter = _chunk6M3BCTBDcjs.csvImportAdapter; exports.describeFormulaError = _chunkSAZRENEZcjs.describeFormulaError; exports.escapeCsvField = _chunk6M3BCTBDcjs.escapeCsvField; exports.extractCellDependencies = _chunk6M3BCTBDcjs.extractCellDependencies; exports.fillSeries = _chunk6M3BCTBDcjs.fillSeries; exports.formatValueWithCode = _chunkSAZRENEZcjs.formatValueWithCode; exports.getFillDirection = _chunk6M3BCTBDcjs.getFillDirection; exports.getFormulaArgumentSpecIndex = _chunkSAZRENEZcjs.getFormulaArgumentSpecIndex; exports.getFormulaCaretContext = _chunk6M3BCTBDcjs.getFormulaCaretContext; exports.getFormulaFunction = _chunkSAZRENEZcjs.getFormulaFunction; exports.getFormulaHints = _chunk6M3BCTBDcjs.getFormulaHints; exports.getFormulaSignature = _chunkSAZRENEZcjs.getFormulaSignature; exports.getFormulaSignatureParts = _chunkSAZRENEZcjs.getFormulaSignatureParts; exports.getRowSection = _chunk6M3BCTBDcjs.getRowSection; exports.getSpreadsheetMenuItems = _chunk6M3BCTBDcjs.getSpreadsheetMenuItems; exports.getTableSections = _chunk6M3BCTBDcjs.getTableSections; exports.importFileIntoSpreadsheet = _chunk6M3BCTBDcjs.importFileIntoSpreadsheet; exports.indexToColName = _chunkSAZRENEZcjs.indexToColName; exports.isBlankValue = _chunk6M3BCTBDcjs.isBlankValue; exports.isFormulaError = _chunkSAZRENEZcjs.isFormulaError; exports.isSingleCellRange = _chunk6M3BCTBDcjs.isSingleCellRange; exports.listFormulaFunctions = _chunkSAZRENEZcjs.listFormulaFunctions; exports.mapFormulaReferences = _chunk6M3BCTBDcjs.mapFormulaReferences; exports.matchesFilterRule = _chunk6M3BCTBDcjs.matchesFilterRule; exports.normalizeRange = _chunk6M3BCTBDcjs.normalizeRange; exports.offsetFormulaReferences = _chunk6M3BCTBDcjs.offsetFormulaReferences; exports.parseCellReference = _chunkSAZRENEZcjs.parseCellReference; exports.parseCriteria = _chunkSAZRENEZcjs.parseCriteria; exports.parseCsv = _chunk6M3BCTBDcjs.parseCsv; exports.parseFormula = _chunkSAZRENEZcjs.parseFormula; exports.parseHtmlTable = _chunk6M3BCTBDcjs.parseHtmlTable; exports.parseRange = _chunkSAZRENEZcjs.parseRange; exports.parseTsv = _chunk6M3BCTBDcjs.parseTsv; exports.rangeContains = _chunk6M3BCTBDcjs.rangeContains; exports.rangeContainsRange = _chunk6M3BCTBDcjs.rangeContainsRange; exports.rangesIntersect = _chunk6M3BCTBDcjs.rangesIntersect; exports.readSpreadsheetClipboard = _chunk6M3BCTBDcjs.readSpreadsheetClipboard; exports.rebaseClipboardRows = _chunk6M3BCTBDcjs.rebaseClipboardRows; exports.registerFormulaFunction = _chunkSAZRENEZcjs.registerFormulaFunction; exports.registerSpreadsheetImportAdapters = _chunk6M3BCTBDcjs.registerSpreadsheetImportAdapters; exports.remapFormulaReferences = _chunk6M3BCTBDcjs.remapFormulaReferences; exports.roundFloat = _chunk6M3BCTBDcjs.roundFloat; exports.rowPassesFilters = _chunk6M3BCTBDcjs.rowPassesFilters; exports.searchFormulaFunctions = _chunkSAZRENEZcjs.searchFormulaFunctions; exports.serializeCsv = _chunk6M3BCTBDcjs.serializeCsv; exports.serializeHtmlTable = _chunk6M3BCTBDcjs.serializeHtmlTable; exports.serializeTsv = _chunk6M3BCTBDcjs.serializeTsv; exports.shiftFormulaReferences = _chunk6M3BCTBDcjs.shiftFormulaReferences; exports.toNumber = _chunk6M3BCTBDcjs.toNumber; exports.tokenizeFormula = _chunkSAZRENEZcjs.tokenizeFormula; exports.tsvImportAdapter = _chunk6M3BCTBDcjs.tsvImportAdapter; exports.unregisterFormulaFunction = _chunkSAZRENEZcjs.unregisterFormulaFunction; exports.wildcardToRegExp = _chunkSAZRENEZcjs.wildcardToRegExp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.DEFAULT_COLUMN_WIDTH = _chunkMA2F5KHFcjs.DEFAULT_COLUMN_WIDTH; exports.DEFAULT_ROW_HEIGHT = _chunkMA2F5KHFcjs.DEFAULT_ROW_HEIGHT; exports.DataSourceBinder = _chunkMA2F5KHFcjs.DataSourceBinder; exports.DependencyGraph = _chunkMA2F5KHFcjs.DependencyGraph; exports.FORMULA_ERRORS = _chunkMCSJFWAOcjs.FORMULA_ERRORS; exports.FormulaEvaluator = _chunkMCSJFWAOcjs.FormulaEvaluator; exports.FormulaParser = _chunkMCSJFWAOcjs.FormulaParser; exports.MAX_FORMULA_ARRAY_SIZE = _chunkMCSJFWAOcjs.MAX_FORMULA_ARRAY_SIZE; exports.MAX_NUMBER_FORMAT_CODE_CHARS = _chunkMCSJFWAOcjs.MAX_NUMBER_FORMAT_CODE_CHARS; exports.NUMBER_FORMAT_PRESETS = _chunkMA2F5KHFcjs.NUMBER_FORMAT_PRESETS; exports.NumberFormat = _chunkMCSJFWAOcjs.NumberFormat; exports.SPREADSHEET_CLIPBOARD_MIME = _chunkMA2F5KHFcjs.SPREADSHEET_CLIPBOARD_MIME; exports.SPREADSHEET_IMPORT_ADAPTERS = _chunkMA2F5KHFcjs.SPREADSHEET_IMPORT_ADAPTERS; exports.SPREADSHEET_TABLE_ACTIONS = _chunkMA2F5KHFcjs.SPREADSHEET_TABLE_ACTIONS; exports.SpreadsheetController = _chunkMA2F5KHFcjs.SpreadsheetController; exports.WHOLE_COLUMN_END_ROW = _chunkMCSJFWAOcjs.WHOLE_COLUMN_END_ROW; exports.aggregateValues = _chunkMA2F5KHFcjs.aggregateValues; exports.applyFormulaSuggestion = _chunkMA2F5KHFcjs.applyFormulaSuggestion; exports.bindSpreadsheetTableActions = _chunkMA2F5KHFcjs.bindSpreadsheetTableActions; exports.buildSpreadsheetView = _chunkMA2F5KHFcjs.buildSpreadsheetView; exports.builtinNumberFormat = _chunkMCSJFWAOcjs.builtinNumberFormat; exports.builtinNumberFormatId = _chunkMCSJFWAOcjs.builtinNumberFormatId; exports.cellFormatForNumberFormat = _chunkMA2F5KHFcjs.cellFormatForNumberFormat; exports.checkFormulaArgumentCount = _chunkMCSJFWAOcjs.checkFormulaArgumentCount; exports.clampMenuPosition = _chunkMA2F5KHFcjs.clampMenuPosition; exports.clearNumberFormatCache = _chunkMCSJFWAOcjs.clearNumberFormatCache; exports.colNameToIndex = _chunkMCSJFWAOcjs.colNameToIndex; exports.columnDependencyKey = _chunkMA2F5KHFcjs.columnDependencyKey; exports.compareCellValues = _chunkMA2F5KHFcjs.compareCellValues; exports.compareNumbers = _chunkMCSJFWAOcjs.compareNumbers; exports.compareValues = _chunkMCSJFWAOcjs.compareValues; exports.computeFillTarget = _chunkMA2F5KHFcjs.computeFillTarget; exports.computeRowGroups = _chunkMA2F5KHFcjs.computeRowGroups; exports.createSpreadsheetClipboardData = _chunkMA2F5KHFcjs.createSpreadsheetClipboardData; exports.csvImportAdapter = _chunkMA2F5KHFcjs.csvImportAdapter; exports.dateValueToSerial = _chunkMCSJFWAOcjs.dateValueToSerial; exports.describeFormulaError = _chunkMCSJFWAOcjs.describeFormulaError; exports.escapeCsvField = _chunkTNNJXF46cjs.escapeCsvField; exports.extractCellDependencies = _chunkMA2F5KHFcjs.extractCellDependencies; exports.fillSeries = _chunkMA2F5KHFcjs.fillSeries; exports.formatCellDisplay = _chunkMA2F5KHFcjs.formatCellDisplay; exports.formatCellForDisplay = _chunkMA2F5KHFcjs.formatCellForDisplay; exports.formatGeneralFit = _chunkMCSJFWAOcjs.formatGeneralFit; exports.formatNumberFormatValue = _chunkMCSJFWAOcjs.formatNumberFormatValue; exports.formatTextFunction = _chunkMCSJFWAOcjs.formatTextFunction; exports.formatValueWithCode = _chunkMA2F5KHFcjs.formatValueWithCode; exports.getFillDirection = _chunkMA2F5KHFcjs.getFillDirection; exports.getFormulaArgumentSpecIndex = _chunkMCSJFWAOcjs.getFormulaArgumentSpecIndex; exports.getFormulaCaretContext = _chunkMA2F5KHFcjs.getFormulaCaretContext; exports.getFormulaFunction = _chunkMCSJFWAOcjs.getFormulaFunction; exports.getFormulaHints = _chunkMA2F5KHFcjs.getFormulaHints; exports.getFormulaSignature = _chunkMCSJFWAOcjs.getFormulaSignature; exports.getFormulaSignatureParts = _chunkMCSJFWAOcjs.getFormulaSignatureParts; exports.getRowSection = _chunkMA2F5KHFcjs.getRowSection; exports.getSpreadsheetMenuItems = _chunkMA2F5KHFcjs.getSpreadsheetMenuItems; exports.getTableSections = _chunkMA2F5KHFcjs.getTableSections; exports.importFileIntoSpreadsheet = _chunkMA2F5KHFcjs.importFileIntoSpreadsheet; exports.indexToColName = _chunkMCSJFWAOcjs.indexToColName; exports.isBlankValue = _chunkMA2F5KHFcjs.isBlankValue; exports.isFormulaError = _chunkMCSJFWAOcjs.isFormulaError; exports.isGeneralNumberFormat = _chunkMA2F5KHFcjs.isGeneralNumberFormat; exports.isSingleCellRange = _chunkMA2F5KHFcjs.isSingleCellRange; exports.listFormulaFunctions = _chunkMCSJFWAOcjs.listFormulaFunctions; exports.mapFormulaReferences = _chunkMA2F5KHFcjs.mapFormulaReferences; exports.matchesFilterRule = _chunkMA2F5KHFcjs.matchesFilterRule; exports.normalizeRange = _chunkMA2F5KHFcjs.normalizeRange; exports.numberFormatColorToCss = _chunkMCSJFWAOcjs.numberFormatColorToCss; exports.numberFormatForCellFormat = _chunkMA2F5KHFcjs.numberFormatForCellFormat; exports.numberToText = _chunkMCSJFWAOcjs.numberToText; exports.offsetFormulaReferences = _chunkMA2F5KHFcjs.offsetFormulaReferences; exports.parseCellInput = _chunkMCSJFWAOcjs.parseCellInput; exports.parseCellReference = _chunkMCSJFWAOcjs.parseCellReference; exports.parseCriteria = _chunkMCSJFWAOcjs.parseCriteria; exports.parseCsv = _chunkTNNJXF46cjs.parseCsv; exports.parseFormula = _chunkMCSJFWAOcjs.parseFormula; exports.parseHtmlTable = _chunkMA2F5KHFcjs.parseHtmlTable; exports.parseNumberText = _chunkMCSJFWAOcjs.parseNumberText; exports.parseRange = _chunkMCSJFWAOcjs.parseRange; exports.parseTsv = _chunkTNNJXF46cjs.parseTsv; exports.rangeContains = _chunkMA2F5KHFcjs.rangeContains; exports.rangeContainsRange = _chunkMA2F5KHFcjs.rangeContainsRange; exports.rangesIntersect = _chunkMA2F5KHFcjs.rangesIntersect; exports.readSpreadsheetClipboard = _chunkMA2F5KHFcjs.readSpreadsheetClipboard; exports.rebaseClipboardRows = _chunkMA2F5KHFcjs.rebaseClipboardRows; exports.registerFormulaFunction = _chunkMCSJFWAOcjs.registerFormulaFunction; exports.registerSpreadsheetImportAdapters = _chunkMA2F5KHFcjs.registerSpreadsheetImportAdapters; exports.remapFormulaReferences = _chunkMA2F5KHFcjs.remapFormulaReferences; exports.roundFloat = _chunkMA2F5KHFcjs.roundFloat; exports.rowPassesFilters = _chunkMA2F5KHFcjs.rowPassesFilters; exports.runSpreadsheetMenuItem = _chunkMA2F5KHFcjs.runSpreadsheetMenuItem; exports.searchFormulaFunctions = _chunkMCSJFWAOcjs.searchFormulaFunctions; exports.serialFromYmd = _chunkMCSJFWAOcjs.serialFromYmd; exports.serializeCsv = _chunkTNNJXF46cjs.serializeCsv; exports.serializeHtmlTable = _chunkMA2F5KHFcjs.serializeHtmlTable; exports.serializeTsv = _chunkTNNJXF46cjs.serializeTsv; exports.shiftFormulaReferences = _chunkMA2F5KHFcjs.shiftFormulaReferences; exports.sortCompareValues = _chunkMCSJFWAOcjs.sortCompareValues; exports.toNumber = _chunkMA2F5KHFcjs.toNumber; exports.tokenizeFormula = _chunkMCSJFWAOcjs.tokenizeFormula; exports.tsvImportAdapter = _chunkMA2F5KHFcjs.tsvImportAdapter; exports.unregisterFormulaFunction = _chunkMCSJFWAOcjs.unregisterFormulaFunction; exports.wildcardToRegExp = _chunkMCSJFWAOcjs.wildcardToRegExp;
 //# sourceMappingURL=index.cjs.map

package/dist/spreadsheet/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/editor/editor/packages/core/dist/spreadsheet/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,2mKAAC","file":"/home/runner/work/editor/editor/packages/core/dist/spreadsheet/index.cjs"}
+{"version":3,"sources":["/home/runner/work/editor/editor/packages/core/dist/spreadsheet/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,itNAAC","file":"/home/runner/work/editor/editor/packages/core/dist/spreadsheet/index.cjs"}

package/dist/spreadsheet/index.d.cts

@@ -1,5 +1,5 @@
-import { A as ASTNode, r as FormulaErrorCode, v as FormulaRange, G as GroupAggregate, O as SortDirection, e as CellRange, d as CellPosition, p as FilterRule, S as SpreadsheetController } from '../controller-B7GIybc4.cjs';
-export { B as BinaryOpNode, C as CellCoordinate, a as CellData, b as CellDep, c as CellFormat, f as CellRefNode, g as CellValueReader, h as ColumnBinding, i as ColumnType, j as CsvExportOptions, k as CsvImportOptions, D as DEFAULT_COLUMN_WIDTH, l as DEFAULT_ROW_HEIGHT, m as DataSourceBinder, n as DependencyGraph, E as EvaluationContext, F as FORMULA_ERRORS, o as FilterOperator, q as FormulaDiagnostic, s as FormulaEvaluationResult, t as FormulaEvaluator, u as FormulaParser, w as FormulaToken, x as FormulaTokenType, y as FunctionCallNode, z as GroupSummary, L as LiteralNode, M as MAX_FORMULA_ARRAY_SIZE, N as NameNode, H as NewFilterRule, P as ParsedSpreadsheetClipboard, I as PropertyRefNode, R as RangeNode, J as RowType, K as SPREADSHEET_CLIPBOARD_MIME, Q as SortKey, T as SpillRefNode, U as SpreadsheetCellSpan, V as SpreadsheetClipboardCell, W as SpreadsheetClipboardData, X as SpreadsheetClipboardPayload, Y as SpreadsheetClipboardSource, Z as SpreadsheetColumn, _ as SpreadsheetControllerOptions, $ as SpreadsheetDataSource, a0 as SpreadsheetDataSourceField, a1 as SpreadsheetDocument, a2 as SpreadsheetFilterState, a3 as SpreadsheetGrouping, a4 as SpreadsheetRow, a5 as SpreadsheetRowGroup, a6 as SpreadsheetRowSection, a7 as SpreadsheetSpill, a8 as SpreadsheetTableSettings, a9 as SpreadsheetViewColumn, aa as SpreadsheetViewModel, ab as SpreadsheetViewRow, ac as StructuralChange, ad as UnaryOpNode, ae as WHOLE_COLUMN_END_ROW, af as buildSpreadsheetView, ag as colNameToIndex, ah as columnDependencyKey, ai as computeRowGroups, aj as createSpreadsheetClipboardData, ak as describeFormulaError, al as extractCellDependencies, am as getRowSection, an as getTableSections, ao as indexToColName, ap as isFormulaError, aq as mapFormulaReferences, ar as offsetFormulaReferences, as as parseCellReference, at as parseFormula, au as parseHtmlTable, av as parseRange, aw as readSpreadsheetClipboard, ax as rebaseClipboardRows, ay as remapFormulaReferences, az as rowPassesFilters, aA as serializeHtmlTable, aB as shiftFormulaReferences, aC as tokenizeFormula } from '../controller-B7GIybc4.cjs';
+import { A as ASTNode, r as FormulaErrorCode, v as FormulaRange, a as CellData, c as CellFormat, G as GroupAggregate, O as SortDirection, e as CellRange, d as CellPosition, p as FilterRule, S as SpreadsheetController } from '../controller-BhLLAoi8.cjs';
+export { B as BinaryOpNode, C as CellCoordinate, b as CellDep, f as CellRefNode, g as CellValueReader, h as ColumnBinding, i as ColumnType, j as CsvExportOptions, k as CsvImportOptions, D as DEFAULT_COLUMN_WIDTH, l as DEFAULT_ROW_HEIGHT, m as DataSourceBinder, n as DependencyGraph, E as EvaluationContext, F as FORMULA_ERRORS, o as FilterOperator, q as FormulaDiagnostic, s as FormulaEvaluationResult, t as FormulaEvaluator, u as FormulaParser, w as FormulaToken, x as FormulaTokenType, y as FunctionCallNode, z as GroupSummary, L as LiteralNode, M as MAX_FORMULA_ARRAY_SIZE, N as NameNode, H as NewFilterRule, P as ParsedSpreadsheetClipboard, I as PropertyRefNode, R as RangeNode, J as RowType, K as SPREADSHEET_CLIPBOARD_MIME, Q as SortKey, T as SpillRefNode, U as SpreadsheetCellSpan, V as SpreadsheetClipboardCell, W as SpreadsheetClipboardData, X as SpreadsheetClipboardPayload, Y as SpreadsheetClipboardSource, Z as SpreadsheetColumn, _ as SpreadsheetControllerOptions, $ as SpreadsheetDataSource, a0 as SpreadsheetDataSourceField, a1 as SpreadsheetDocument, a2 as SpreadsheetFilterState, a3 as SpreadsheetGrouping, a4 as SpreadsheetRow, a5 as SpreadsheetRowGroup, a6 as SpreadsheetRowSection, a7 as SpreadsheetSpill, a8 as SpreadsheetTableSettings, a9 as SpreadsheetViewColumn, aa as SpreadsheetViewModel, ab as SpreadsheetViewRow, ac as StructuralChange, ad as UnaryOpNode, ae as WHOLE_COLUMN_END_ROW, af as buildSpreadsheetView, ag as colNameToIndex, ah as columnDependencyKey, ai as compareNumbers, aj as compareValues, ak as computeRowGroups, al as createSpreadsheetClipboardData, am as describeFormulaError, an as extractCellDependencies, ao as getRowSection, ap as getTableSections, aq as indexToColName, ar as isFormulaError, as as mapFormulaReferences, at as numberToText, au as offsetFormulaReferences, av as parseCellReference, aw as parseFormula, ax as parseHtmlTable, ay as parseRange, az as readSpreadsheetClipboard, aA as rebaseClipboardRows, aB as remapFormulaReferences, aC as rowPassesFilters, aD as serializeHtmlTable, aE as shiftFormulaReferences, aF as sortCompareValues, aG as tokenizeFormula } from '../controller-BhLLAoi8.cjs';
 import { I as ImportAdapterRegistry, c as ImportAdapter, h as ImportInput, a as ImportOutcome } from '../registry-GJI4gToU.cjs';
 
 type FormulaFunctionCategory = 'math' | 'statistical' | 'logical' | 'text' | 'lookup' | 'date' | 'information';
@@ -202,24 +202,234 @@ declare function wildcardToRegExp(pattern: string): RegExp;
  * Parses a criterion as used by SUMIF, COUNTIFS etc.:
  * - a number or boolean matches equal values (`5` matches 5 and the text "5");
  * - text may start with `=`, `<>`, `<`, `<=`, `>` or `>=`. Numeric operands
- *   compare numbers; text operands compare text case-insensitively;
+ *   (typed-input rules: `">1,000"`, `"<50%"`, `">$5"`) compare numbers; date
+ *   operands (`">=3/1/2026"`, `"<2026-03-01"`) compare ISO dates (and serial
+ *   numbers) chronologically; text operands compare text case-insensitively;
  * - `=`/`<>` text operands and plain text support `*` and `?` wildcards;
  * - `""` and `"="` match blank cells, `"<>"` matches non-blank cells.
  * Error values in the data never match.
  */
 declare function parseCriteria(criterion: unknown): FormulaCriteriaPredicate;
 
+/** Number format code parsing: sections, bracket tags and tokens. */
+/** Colour from a `[Red]` or `[ColorN]` section tag (`color1`…`color56` = palette index). */
+type NumberFormatColor = 'black' | 'blue' | 'cyan' | 'green' | 'magenta' | 'red' | 'white' | 'yellow' | `color${number}`;
+
+/**
+ * The General format squeezed into `maxChars` characters, as Excel shows it
+ * in a narrow column: fewer decimals, then scientific notation; `null` when
+ * even that does not fit (the caller paints `####`).
+ */
+declare function formatGeneralFit(n: number, maxChars: number): string | null;
+
+/** Built-in number formats (ECMA-376 §18.8.30, en-US). */
 /**
- * A subset of spreadsheet number format codes, as used by TEXT():
- * - numbers: `0`, `#`, `0.00`, `#,##0`, `#,##0.00`, `0%`, `0.0%`, `0.00E+00`,
- *   literal prefixes/suffixes (`$#,##0.00`, `0.0 "kg"`), and
- *   `positive;negative;zero` sections;
- * - dates and times: `yyyy yy mmmm mmm mm m dddd ddd dd d hh h mm ss AM/PM`
- *   (`m`/`mm` after an hour or before seconds means minutes).
- * Text values are returned unchanged; unsupported codes are best effort.
+ * Built-in format code for an id (0–49, en-US), e.g. 14 → `m/d/yyyy`.
+ * Locale-specific ids (23–36) and unknown ids return undefined.
+ */
+declare function builtinNumberFormat(id: number): string | undefined;
+/** Id of a built-in format code. Matching ignores case and backslash escapes. */
+declare function builtinNumberFormatId(code: string): number | undefined;
+
+/**
+ * Longest number format code, in characters, that is parsed (Excel's own
+ * limit). A longer code displays its value as General and makes `TEXT`
+ * return `#VALUE!`. The cap also bounds work that scales with the code.
+ */
+declare const MAX_NUMBER_FORMAT_CODE_CHARS = 255;
+/** Best guess at the ribbon's number-format category. */
+type NumberFormatKind = 'general' | 'number' | 'currency' | 'accounting' | 'date' | 'time' | 'percentage' | 'fraction' | 'scientific' | 'text'
+/** Zip codes, phone numbers, social security numbers. */
+ | 'special' | 'custom';
+/** A value formatted with a number format, ready to paint. */
+interface FormattedNumberValue {
+    text: string;
+    /** Colour from a `[Red]` / `[ColorN]` tag of the section used. */
+    color?: NumberFormatColor;
+    /**
+     * Repeat-fill character from `*x` and its position (UTF-16 index) in
+     * `text`; a renderer may repeat it to fill the cell width.
+     */
+    fill?: {
+        char: string;
+        index: number;
+    };
+    /** True for numbers (right-aligned by default); text, booleans and errors are false. */
+    numeric: boolean;
+}
+/** A parsed number format code. Parsing never fails: malformed parts become literal text. */
+declare class NumberFormat {
+    readonly code: string;
+    private readonly general;
+    private readonly sections;
+    /** Sections that apply to numbers (a trailing text section is excluded). */
+    private readonly numSections;
+    /** Index of the section that applies to text, if any. */
+    private readonly textSection;
+    private constructor();
+    /**
+     * Parses a format code. Never throws: unknown or malformed parts degrade to
+     * literal text, and a code longer than 255 characters degrades to General.
+     */
+    static parse(code: string): NumberFormat;
+    /** `parse` without the 255-character cap (for tests that reach renderer edge cases). */
+    static parseUncapped(code: string): NumberFormat;
+    /** Like `parse`, but remembers recently parsed codes (bounded), so formatting many values parses a code once. */
+    static parseCached(code: string): NumberFormat;
+    static general(): NumberFormat;
+    isGeneral(): boolean;
+    private numberSections;
+    /** True when the code contains date or time tokens. */
+    isDate(): boolean;
+    isPercent(): boolean;
+    /** True for a pure text format such as `@`. */
+    isText(): boolean;
+    /** Best guess at the format category. */
+    kind(): NumberFormatKind;
+    /**
+     * Picks the number section for `v`, and whether the minus sign is dropped
+     * (a negative section shows the absolute value). Null means General.
+     */
+    private select;
+    /**
+     * Formats a number. `overflow` is true when the value can't be shown (a
+     * date out of range, painted as `########`).
+     */
+    formatNumber(n: number): FormattedNumberValue & {
+        overflow: boolean;
+    };
+    /** Formats text through the text section (`@`), or returns it unchanged. */
+    formatText(text: string): FormattedNumberValue;
+    /**
+     * Formats a cell value: numbers through the number sections, ISO date text
+     * (`2026-03-04`, `2026-03-04 18:00:00`) and `Date`s as serial numbers, other
+     * text through the text section; booleans show TRUE/FALSE and error values
+     * themselves.
+     */
+    format(value: unknown): FormattedNumberValue;
+}
+/** Empties the parse cache used by `NumberFormat.parseCached` (mainly for tests). */
+declare function clearNumberFormatCache(): void;
+/**
+ * 1900-system serial number of a date value: ISO date text (with an optional
+ * time) or a `Date` (its local date and time). Null for anything else.
+ */
+declare function dateValueToSerial(value: unknown): number | null;
+/** Formats a cell value with a format code (see `NumberFormat.format`). */
+declare function formatNumberFormatValue(value: unknown, code: string): FormattedNumberValue;
+/**
+ * The `TEXT()` worksheet function: formats a value with a format code.
+ * Blanks count as 0; numeric and date text (`"5"`, `"3/4/2026"`,
+ * `"2026-03-04"`) is converted to a number first; other text and booleans
+ * (as TRUE/FALSE) go through the text section, or are returned as is.
+ * Errors: the value's own error, `#VALUE!` for a code over 255 characters or
+ * a date out of range, `#NUM!` for a non-finite number.
+ */
+declare function formatTextFunction(value: unknown, code: string): {
+    text: string;
+} | {
+    error: string;
+};
+/** CSS colour for a format colour (`red` → `#FF0000`, `color10` → `#008000`). */
+declare function numberFormatColorToCss(color: NumberFormatColor): string;
+
+type DisplayCell = Pick<CellData, 'value' | 'error' | 'numberFormat' | 'format'>;
+/**
+ * How a cell is shown: its error, or its value formatted with its number
+ * format code (`numberFormat`: set explicitly, inherited from the column, or
+ * chosen for typed input, e.g. `"$"#,##0.00` for `$1,200.50`). Numbers in a
+ * cell with a `currency` / `percentage` / `date` `CellFormat` but no code use
+ * that kind's code. Without a code (General), numbers use up to 15
+ * significant digits and booleans show as TRUE/FALSE.
+ *
+ * `numeric` is true for numbers (and dates shown through a date format):
+ * grids right-align those. `color` comes from a `[Red]` / `[ColorN]` tag.
+ */
+declare function formatCellForDisplay(cell: DisplayCell | null | undefined): FormattedNumberValue;
+/** The text a cell shows (see `formatCellForDisplay`). Used by grids, CSV export and the clipboard. */
+declare function formatCellDisplay(cell: DisplayCell | null | undefined): string;
+/**
+ * Formats a value with a number format code, as `TEXT()` does (see
+ * `formatTextFunction`). Null when the value can't be shown with that code
+ * (a date out of range, a code over 255 characters, an error value).
  */
 declare function formatValueWithCode(value: unknown, format: string): string | null;
 
+/**
+ * Parsing what people type into a cell (and numeric text in formulas).
+ *
+ * Recognises numbers with thousands separators, percentages, currency,
+ * scientific notation, fractions (`1 1/2`), dates (`3/4/2026`, `2026-03-04`,
+ * `4-Mar-2026`, `Mar 4, 2026`), times (`10:30`, `10:30:15 PM`) and
+ * date-times. Locale: en-US (month/day/year).
+ *
+ * Representation: our engine keeps dates as ISO text (`2026-03-04`, or
+ * `2026-03-04 18:00:00` with a time), so a typed date becomes ISO text, not a
+ * serial number. A time typed on its own (`12:00`) has no date to anchor ISO
+ * text to, so it becomes a fraction of a day (0.5), as in Excel.
+ */
+
+/** Kind of automatic number format chosen for typed input. */
+type CellInputFormatKind = 'number' | 'currency' | 'percentage' | 'date' | 'time';
+interface ParsedCellInput {
+    /** The typed value: number, boolean, ISO date text, error code or text. `''` for empty input. */
+    value: string | number | boolean;
+    type: 'empty' | 'text' | 'number' | 'boolean' | 'error' | 'date';
+    /**
+     * Number format code Excel would apply automatically (e.g. `"$"#,##0.00`,
+     * `0%`, `#,##0`, `m/d/yyyy`, `h:mm`), or undefined for General.
+     */
+    numberFormat?: string;
+    /** What kind of format that is, if any. */
+    formatKind?: CellInputFormatKind;
+    /** `formatKind` mapped onto `CellFormat` (times have no `CellFormat` and map to undefined). */
+    cellFormat?: CellFormat;
+}
+/**
+ * Excel 1900-system serial for a date (1 = 1900-01-01, 60 = the fictitious
+ * 1900-02-29). Month and day overflow roll over like `DATE()`; years 0–1899
+ * are added to 1900. Null before the epoch or after 9999-12-31.
+ */
+declare function serialFromYmd(year: number, month: number, day: number): number | null;
+/**
+ * Interprets typed cell input (not formulas). Text that isn't a number,
+ * date, time, boolean or error stays text; a leading apostrophe forces text.
+ */
+declare function parseCellInput(input: string): ParsedCellInput;
+/**
+ * Numeric text as arithmetic coerces it ("1,000", "50%", "$3", "1/2/2020",
+ * "10:00"); dates become 1900-system serial numbers. Null when it isn't numeric.
+ */
+declare function parseNumberText(text: string): number | null;
+
+/**
+ * Common number formats offered by the "Format cells" menu, and the mapping
+ * between format codes and the coarser `CellFormat` kinds.
+ */
+
+interface NumberFormatPreset {
+    id: 'general' | 'number' | 'currency' | 'percent' | 'date' | 'time';
+    label: string;
+    code: string;
+}
+/** Presets of the "Format cells" menu (en-US). */
+declare const NUMBER_FORMAT_PRESETS: readonly NumberFormatPreset[];
+/**
+ * Format code for a `CellFormat` kind, used to display numbers in cells that
+ * have a kind but no format code: `currency` → `"$"#,##0.00`, `percentage` →
+ * `0%`, `date` → `m/d/yyyy`. Other kinds (`number`, `text` — the default of
+ * new columns —, `badge`, `status`, `assignee`) display as General (undefined).
+ */
+declare function numberFormatForCellFormat(format: CellFormat | undefined): string | undefined;
+/**
+ * `CellFormat` kind matching a format code (`"$"#,##0.00` → `currency`,
+ * `0%` → `percentage`, `m/d/yyyy` → `date`, `0.00` → `number`, `@` → `text`);
+ * undefined for General, times and custom codes.
+ */
+declare function cellFormatForNumberFormat(code: string): CellFormat | undefined;
+/** True for an empty or `General` code. */
+declare const isGeneralNumberFormat: (code: string | undefined) => boolean;
+
 /**
  * RFC 4180 CSV (and other delimiter-separated values) parsing and
  * serialization.
@@ -288,9 +498,11 @@ declare function isBlankValue(value: unknown): boolean;
 /** The numeric value of a number or numeric string, or null. */
 declare function toNumber(value: unknown): number | null;
 /**
- * Sort order for cell values: numbers (ascending) before text (natural,
- * case-insensitive). `desc` reverses that order. Blanks always sort last,
- * whatever the direction.
+ * Sort order for cell values, as in Excel: numbers (ascending), then text,
+ * booleans and errors; `desc` reverses that order. Numbers compare at 15
+ * significant digits and ISO dates chronologically. Text uses a natural,
+ * case-insensitive order ("Item 2" before "Item 10"). Blanks always sort
+ * last, whatever the direction.
  */
 declare function compareCellValues(a: unknown, b: unknown, direction?: SortDirection): number;
 /** Whether a cell value passes one filter rule. */
@@ -308,8 +520,8 @@ declare function roundFloat(value: number): number;
  * nearest-first) by `count` values, the way a fill handle does:
  *
  * - numbers: one value repeats; two or more continue their linear trend
- * - ISO dates (`YYYY-MM-DD`): one date counts up by a day; two or more
- *   continue their day or month step
+ * - dates (ISO `YYYY-MM-DD`, or typed like `3/4/2026`): one date counts up
+ *   by a day; two or more continue their day or month step (as ISO dates)
  * - text ending in a number ("Item 1"): the number counts up (or continues
  *   the step of several values with the same prefix/suffix)
  * - anything else (or a mix) repeats the source cyclically
@@ -343,8 +555,25 @@ interface SpreadsheetMenuItem {
     disabled?: boolean;
     /** Draw a divider before this item. */
     separatorBefore?: boolean;
-    run: () => void;
+    /** The item is the current choice of its group (e.g. the cell's number format). */
+    checked?: boolean;
+    /**
+     * Ask for text before running (e.g. a custom number format code): the
+     * editor prompts with `label` and `defaultValue`, then calls `run(text)`;
+     * cancelling skips `run`.
+     */
+    input?: {
+        label: string;
+        defaultValue?: string;
+    };
+    run: (input?: string) => void;
 }
+/**
+ * Runs a menu item the way the editors do: an item with `input` first asks
+ * for text with `ask` (default `window.prompt`) and is skipped when that is
+ * cancelled. Returns whether `run` was called.
+ */
+declare function runSpreadsheetMenuItem(item: SpreadsheetMenuItem, ask?: (label: string, defaultValue: string) => string | null | undefined): boolean;
 /**
  * Where to place a `position: fixed` menu opened at `point` so it stays inside
  * the viewport: it flips to the left of / above the pointer when it would
@@ -379,7 +608,7 @@ declare function getSpreadsheetMenuItems(controller: SpreadsheetController, cell
  * state syncing: the controller reports changes through `onDocumentChange`
  * and `onSelectionChange`.
  */
-declare const SPREADSHEET_TABLE_ACTIONS: readonly ["sortRows", "getFilterState", "setFilterRules", "addFilterRule", "updateFilterRule", "removeFilterRule", "clearFilters", "setFiltersEnabled", "toggleFilters", "setHeaderRowCount", "setFooterRowCount", "setHeaderColumnCount", "setFrozenRowCount", "setFrozenColumnCount", "hideRows", "unhideRows", "hideColumns", "unhideColumns", "unhideAll", "getMerges", "getMergeAt", "mergeCells", "unmergeCells", "autofill", "groupRowsBy", "ungroupRows", "setGroupSummary", "setGroupCollapsed", "toggleGroupCollapsed", "getGroups", "transposeRange", "exportToCsv", "importFromCsv", "copyToClipboardData", "pasteClipboardData"];
+declare const SPREADSHEET_TABLE_ACTIONS: readonly ["sortRows", "getFilterState", "setFilterRules", "addFilterRule", "updateFilterRule", "removeFilterRule", "clearFilters", "setFiltersEnabled", "toggleFilters", "setHeaderRowCount", "setFooterRowCount", "setHeaderColumnCount", "setFrozenRowCount", "setFrozenColumnCount", "hideRows", "unhideRows", "hideColumns", "unhideColumns", "unhideAll", "getMerges", "getMergeAt", "mergeCells", "unmergeCells", "autofill", "groupRowsBy", "ungroupRows", "setGroupSummary", "setGroupCollapsed", "toggleGroupCollapsed", "getGroups", "transposeRange", "setCellNumberFormat", "setColumnNumberFormat", "exportToCsv", "importFromCsv", "copyToClipboardData", "pasteClipboardData"];
 type SpreadsheetTableActionName = (typeof SPREADSHEET_TABLE_ACTIONS)[number];
 type SpreadsheetTableActions = Pick<SpreadsheetController, SpreadsheetTableActionName>;
 /** The table operations of `controller`, bound so they can be passed around. */
@@ -427,4 +656,4 @@ interface ImportFileIntoSpreadsheetOptions {
  */
 declare function importFileIntoSpreadsheet(controller: SpreadsheetController, input: ImportInput, options: ImportFileIntoSpreadsheetOptions): Promise<ImportOutcome<SpreadsheetImport>>;
 
-export { ASTNode, CellPosition, CellRange, type CsvParseOptions, type CsvSerializeOptions, type FillDirection, FilterRule, type FormulaActiveCall, type FormulaArgument, type FormulaArgumentSpec, type FormulaArgumentType, type FormulaCaretContext, type FormulaCriteriaPredicate, FormulaErrorCode, type FormulaFunctionCategory, type FormulaFunctionContext, type FormulaFunctionDefinition, type FormulaFunctionSuggestion, type FormulaHints, FormulaRange, type FormulaSignaturePart, GroupAggregate, type ImportFileIntoSpreadsheetOptions, SPREADSHEET_IMPORT_ADAPTERS, SPREADSHEET_TABLE_ACTIONS, SortDirection, SpreadsheetController, type SpreadsheetImport, type SpreadsheetImportAdapter, type SpreadsheetMenuItem, type SpreadsheetTableActionName, type SpreadsheetTableActions, aggregateValues, applyFormulaSuggestion, bindSpreadsheetTableActions, checkFormulaArgumentCount, clampMenuPosition, compareCellValues, computeFillTarget, csvImportAdapter, escapeCsvField, fillSeries, formatValueWithCode, getFillDirection, getFormulaArgumentSpecIndex, getFormulaCaretContext, getFormulaFunction, getFormulaHints, getFormulaSignature, getFormulaSignatureParts, getSpreadsheetMenuItems, importFileIntoSpreadsheet, isBlankValue, isSingleCellRange, listFormulaFunctions, matchesFilterRule, normalizeRange, parseCriteria, parseCsv, parseTsv, rangeContains, rangeContainsRange, rangesIntersect, registerFormulaFunction, registerSpreadsheetImportAdapters, roundFloat, searchFormulaFunctions, serializeCsv, serializeTsv, toNumber, tsvImportAdapter, unregisterFormulaFunction, wildcardToRegExp };
+export { ASTNode, CellData, CellFormat, type CellInputFormatKind, CellPosition, CellRange, type CsvParseOptions, type CsvSerializeOptions, type FillDirection, FilterRule, type FormattedNumberValue, type FormulaActiveCall, type FormulaArgument, type FormulaArgumentSpec, type FormulaArgumentType, type FormulaCaretContext, type FormulaCriteriaPredicate, FormulaErrorCode, type FormulaFunctionCategory, type FormulaFunctionContext, type FormulaFunctionDefinition, type FormulaFunctionSuggestion, type FormulaHints, FormulaRange, type FormulaSignaturePart, GroupAggregate, type ImportFileIntoSpreadsheetOptions, MAX_NUMBER_FORMAT_CODE_CHARS, NUMBER_FORMAT_PRESETS, NumberFormat, type NumberFormatColor, type NumberFormatKind, type NumberFormatPreset, type ParsedCellInput, SPREADSHEET_IMPORT_ADAPTERS, SPREADSHEET_TABLE_ACTIONS, SortDirection, SpreadsheetController, type SpreadsheetImport, type SpreadsheetImportAdapter, type SpreadsheetMenuItem, type SpreadsheetTableActionName, type SpreadsheetTableActions, aggregateValues, applyFormulaSuggestion, bindSpreadsheetTableActions, builtinNumberFormat, builtinNumberFormatId, cellFormatForNumberFormat, checkFormulaArgumentCount, clampMenuPosition, clearNumberFormatCache, compareCellValues, computeFillTarget, csvImportAdapter, dateValueToSerial, escapeCsvField, fillSeries, formatCellDisplay, formatCellForDisplay, formatGeneralFit, formatNumberFormatValue, formatTextFunction, formatValueWithCode, getFillDirection, getFormulaArgumentSpecIndex, getFormulaCaretContext, getFormulaFunction, getFormulaHints, getFormulaSignature, getFormulaSignatureParts, getSpreadsheetMenuItems, importFileIntoSpreadsheet, isBlankValue, isGeneralNumberFormat, isSingleCellRange, listFormulaFunctions, matchesFilterRule, normalizeRange, numberFormatColorToCss, numberFormatForCellFormat, parseCellInput, parseCriteria, parseCsv, parseNumberText, parseTsv, rangeContains, rangeContainsRange, rangesIntersect, registerFormulaFunction, registerSpreadsheetImportAdapters, roundFloat, runSpreadsheetMenuItem, searchFormulaFunctions, serialFromYmd, serializeCsv, serializeTsv, toNumber, tsvImportAdapter, unregisterFormulaFunction, wildcardToRegExp };