@pixerate/editor 0.22.0 → 0.23.0

package/dist/spreadsheet/index.d.ts

@@ -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.js';
-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.js';
+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-pePCJLT1.js';
+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-pePCJLT1.js';
 import { I as ImportAdapterRegistry, c as ImportAdapter, h as ImportInput, a as ImportOutcome } from '../registry-GJI4gToU.js';
 
 type FormulaFunctionCategory = 'math' | 'statistical' | 'logical' | 'text' | 'lookup' | 'date' | 'information';
@@ -202,13 +202,22 @@ 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;
 
+/**
+ * The text a cell shows: its error, or its value formatted with the number
+ * format chosen for typed input (`numberFormat`, e.g. `"$"#,##0.00` for
+ * `$1,200.50`, `0%` for `10%`, `m/d/yyyy` for `3/4/2026`). Other numbers use
+ * up to 15 significant digits and booleans show as TRUE/FALSE.
+ */
+declare function formatCellDisplay(cell: Pick<CellData, 'value' | 'error' | 'numberFormat'> | null | undefined): string;
 /**
  * A subset of spreadsheet number format codes, as used by TEXT():
  * - numbers: `0`, `#`, `0.00`, `#,##0`, `#,##0.00`, `0%`, `0.0%`, `0.00E+00`,
@@ -220,6 +229,53 @@ declare function parseCriteria(criterion: unknown): FormulaCriteriaPredicate;
  */
 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;
+
 /**
  * RFC 4180 CSV (and other delimiter-separated values) parsing and
  * serialization.
@@ -288,9 +344,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 +366,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
@@ -427,4 +485,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 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, type ParsedCellInput, 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, formatCellDisplay, formatValueWithCode, getFillDirection, getFormulaArgumentSpecIndex, getFormulaCaretContext, getFormulaFunction, getFormulaHints, getFormulaSignature, getFormulaSignatureParts, getSpreadsheetMenuItems, importFileIntoSpreadsheet, isBlankValue, isSingleCellRange, listFormulaFunctions, matchesFilterRule, normalizeRange, parseCellInput, parseCriteria, parseCsv, parseNumberText, parseTsv, rangeContains, rangeContainsRange, rangesIntersect, registerFormulaFunction, registerSpreadsheetImportAdapters, roundFloat, searchFormulaFunctions, serialFromYmd, serializeCsv, serializeTsv, toNumber, tsvImportAdapter, unregisterFormulaFunction, wildcardToRegExp };

package/dist/spreadsheet/index.js

@@ -52,7 +52,7 @@ import {
   shiftFormulaReferences,
   toNumber,
   tsvImportAdapter
-} from "../chunk-RU52I7QO.js";
+} from "../chunk-K3R5NG2D.js";
 import {
   FORMULA_ERRORS,
   FormulaEvaluator,
@@ -61,7 +61,10 @@ import {
   WHOLE_COLUMN_END_ROW,
   checkFormulaArgumentCount,
   colNameToIndex,
+  compareNumbers,
+  compareValues,
   describeFormulaError,
+  formatCellDisplay,
   formatValueWithCode,
   getFormulaArgumentSpecIndex,
   getFormulaFunction,
@@ -70,16 +73,21 @@ import {
   indexToColName,
   isFormulaError,
   listFormulaFunctions,
+  numberToText,
+  parseCellInput,
   parseCellReference,
   parseCriteria,
   parseFormula,
+  parseNumberText,
   parseRange,
   registerFormulaFunction,
   searchFormulaFunctions,
+  serialFromYmd,
+  sortCompareValues,
   tokenizeFormula,
   unregisterFormulaFunction,
   wildcardToRegExp
-} from "../chunk-DENSCKFC.js";
+} from "../chunk-QBJ22YZR.js";
 export {
   DEFAULT_COLUMN_WIDTH,
   DEFAULT_ROW_HEIGHT,
@@ -103,6 +111,8 @@ export {
   colNameToIndex,
   columnDependencyKey,
   compareCellValues,
+  compareNumbers,
+  compareValues,
   computeFillTarget,
   computeRowGroups,
   createSpreadsheetClipboardData,
@@ -111,6 +121,7 @@ export {
   escapeCsvField,
   extractCellDependencies,
   fillSeries,
+  formatCellDisplay,
   formatValueWithCode,
   getFillDirection,
   getFormulaArgumentSpecIndex,
@@ -131,12 +142,15 @@ export {
   mapFormulaReferences,
   matchesFilterRule,
   normalizeRange,
+  numberToText,
   offsetFormulaReferences,
+  parseCellInput,
   parseCellReference,
   parseCriteria,
   parseCsv,
   parseFormula,
   parseHtmlTable,
+  parseNumberText,
   parseRange,
   parseTsv,
   rangeContains,
@@ -150,10 +164,12 @@ export {
   roundFloat,
   rowPassesFilters,
   searchFormulaFunctions,
+  serialFromYmd,
   serializeCsv,
   serializeHtmlTable,
   serializeTsv,
   shiftFormulaReferences,
+  sortCompareValues,
   toNumber,
   tokenizeFormula,
   tsvImportAdapter,

package/dist/{types-CJ4U-HHI.d.cts → types-DX4Mh4SL.d.cts}

@@ -214,4 +214,4 @@ interface CanvasDockingCallbacks<TNode extends CanvasNode = CanvasNode> {
     onDockDrop?: (dockTarget: TNode, draggedNode: TNode) => void;
 }
 
-export type { CanvasNode as C, DirectionalDisplacementOptions as D, ExplodeNodeOptions as E, FanOutTrajectoryOptions as F, GraphDifferences as G, IncrementalLayoutOptions as I, NodeTransition as N, PlaceBesideOptions as P, Rect as R, Side as S, TrajectoryFunction as T, XYPosition as X, CanvasEdge as a, CanvasLayoutOptions as b, CanvasNodeStyle as c, ReflowDisplacementOptions as d, CanvasClipboardPayload as e, Position as f, Point as g, CanvasDockingCallbacks as h, CollapseNodeOptions as i, DisplacementDirection as j, DockStrategy as k, ExplosionSnapshot as l, TrajectoryPoint as m };
+export type { CanvasNode as C, DirectionalDisplacementOptions as D, ExplodeNodeOptions as E, FanOutTrajectoryOptions as F, GraphDifferences as G, IncrementalLayoutOptions as I, NodeTransition as N, PlaceBesideOptions as P, Rect as R, Side as S, TrajectoryFunction as T, XYPosition as X, CanvasNodeStyle as a, CanvasEdge as b, CanvasLayoutOptions as c, ReflowDisplacementOptions as d, CanvasClipboardPayload as e, Position as f, Point as g, CanvasDockingCallbacks as h, CollapseNodeOptions as i, DisplacementDirection as j, DockStrategy as k, ExplosionSnapshot as l, TrajectoryPoint as m };

package/dist/{types-CJ4U-HHI.d.ts → types-DX4Mh4SL.d.ts}

@@ -214,4 +214,4 @@ interface CanvasDockingCallbacks<TNode extends CanvasNode = CanvasNode> {
     onDockDrop?: (dockTarget: TNode, draggedNode: TNode) => void;
 }
 
-export type { CanvasNode as C, DirectionalDisplacementOptions as D, ExplodeNodeOptions as E, FanOutTrajectoryOptions as F, GraphDifferences as G, IncrementalLayoutOptions as I, NodeTransition as N, PlaceBesideOptions as P, Rect as R, Side as S, TrajectoryFunction as T, XYPosition as X, CanvasEdge as a, CanvasLayoutOptions as b, CanvasNodeStyle as c, ReflowDisplacementOptions as d, CanvasClipboardPayload as e, Position as f, Point as g, CanvasDockingCallbacks as h, CollapseNodeOptions as i, DisplacementDirection as j, DockStrategy as k, ExplosionSnapshot as l, TrajectoryPoint as m };
+export type { CanvasNode as C, DirectionalDisplacementOptions as D, ExplodeNodeOptions as E, FanOutTrajectoryOptions as F, GraphDifferences as G, IncrementalLayoutOptions as I, NodeTransition as N, PlaceBesideOptions as P, Rect as R, Side as S, TrajectoryFunction as T, XYPosition as X, CanvasNodeStyle as a, CanvasEdge as b, CanvasLayoutOptions as c, ReflowDisplacementOptions as d, CanvasClipboardPayload as e, Position as f, Point as g, CanvasDockingCallbacks as h, CollapseNodeOptions as i, DisplacementDirection as j, DockStrategy as k, ExplosionSnapshot as l, TrajectoryPoint as m };

package/dist/types-GT5a5YAX.d.cts

@@ -0,0 +1,86 @@
+interface Command {
+    execute: () => void;
+    undo: () => void;
+    redo?: () => void;
+    name: string;
+    tag?: string;
+    timestamp?: number;
+    /**
+     * Approximate memory held by this command (closures, snapshots), in bytes.
+     * Counted against `HistoryManagerOptions.maxBytes` when no `sizeOf` hook is set.
+     */
+    byteSize?: number;
+}
+interface HistoryState {
+    canUndo: boolean;
+    canRedo: boolean;
+    undoName: string;
+    redoName: string;
+    undoCount: number;
+    redoCount: number;
+}
+interface HistoryManagerOptions {
+    /**
+     * Maximum number of undo states to keep. Defaults to 50.
+     */
+    maxDepth?: number;
+    /**
+     * Approximate memory budget in bytes for the undo and redo stacks
+     * (0 or omitted = unlimited). The oldest undo steps that do not fit are
+     * dropped; the most recent one is always kept so the last step can be undone.
+     */
+    maxBytes?: number;
+    /**
+     * Measures a command for `maxBytes`. Defaults to `command.byteSize ?? 0`.
+     */
+    sizeOf?: (command: Command) => number;
+    /**
+     * Optional callback fired whenever the history state changes.
+     */
+    onStateChange?: (state: HistoryState) => void;
+}
+interface SnapshotCommandOptions<T> {
+    name: string;
+    before: T;
+    after: T;
+    apply: (state: T) => void;
+    tag?: string;
+}
+interface MergedExecutionOptions {
+    /**
+     * Window in milliseconds during which commands with the same tag will be coalesced.
+     * Defaults to 300ms. Ignored when `key` is set or a gesture is held.
+     */
+    windowMs?: number;
+    /**
+     * Gesture key. Consecutive merged executes with the same key fold into one
+     * undo step regardless of timing, until another command is recorded, undo /
+     * redo / `revertTo` / `goTo` runs, or `endGesture()` is called.
+     */
+    key?: string;
+}
+/** One row of a History panel (see `HistoryManager.getEntries`). */
+interface HistoryEntry {
+    /** Stable id of the step (unchanged while a gesture merges into it). */
+    id: number;
+    /** The step's command name. */
+    label: string;
+    /** Position in the timeline: undo steps first (oldest = 0), then redo steps. */
+    index: number;
+    /** True for the step that produced the current state (the top of the undo stack). */
+    current: boolean;
+    /** True for steps on the redo stack (undone, can be redone). */
+    undone: boolean;
+}
+/**
+ * A point in the undo history, from `HistoryManager.mark()`, for `revertTo`.
+ * Treat it as opaque.
+ */
+interface HistoryMark {
+    readonly topId: number | null;
+    readonly nextId: number;
+    readonly epoch: number;
+    readonly dropped: number;
+}
+
+export type { Command as C, HistoryState as H, MergedExecutionOptions as M, SnapshotCommandOptions as S, HistoryEntry as a, HistoryManagerOptions as b, HistoryMark as c };

package/dist/types-GT5a5YAX.d.ts

@@ -0,0 +1,86 @@
+interface Command {
+    execute: () => void;
+    undo: () => void;
+    redo?: () => void;
+    name: string;
+    tag?: string;
+    timestamp?: number;
+    /**
+     * Approximate memory held by this command (closures, snapshots), in bytes.
+     * Counted against `HistoryManagerOptions.maxBytes` when no `sizeOf` hook is set.
+     */
+    byteSize?: number;
+}
+interface HistoryState {
+    canUndo: boolean;
+    canRedo: boolean;
+    undoName: string;
+    redoName: string;
+    undoCount: number;
+    redoCount: number;
+}
+interface HistoryManagerOptions {
+    /**
+     * Maximum number of undo states to keep. Defaults to 50.
+     */
+    maxDepth?: number;
+    /**
+     * Approximate memory budget in bytes for the undo and redo stacks
+     * (0 or omitted = unlimited). The oldest undo steps that do not fit are
+     * dropped; the most recent one is always kept so the last step can be undone.
+     */
+    maxBytes?: number;
+    /**
+     * Measures a command for `maxBytes`. Defaults to `command.byteSize ?? 0`.
+     */
+    sizeOf?: (command: Command) => number;
+    /**
+     * Optional callback fired whenever the history state changes.
+     */
+    onStateChange?: (state: HistoryState) => void;
+}
+interface SnapshotCommandOptions<T> {
+    name: string;
+    before: T;
+    after: T;
+    apply: (state: T) => void;
+    tag?: string;
+}
+interface MergedExecutionOptions {
+    /**
+     * Window in milliseconds during which commands with the same tag will be coalesced.
+     * Defaults to 300ms. Ignored when `key` is set or a gesture is held.
+     */
+    windowMs?: number;
+    /**
+     * Gesture key. Consecutive merged executes with the same key fold into one
+     * undo step regardless of timing, until another command is recorded, undo /
+     * redo / `revertTo` / `goTo` runs, or `endGesture()` is called.
+     */
+    key?: string;
+}
+/** One row of a History panel (see `HistoryManager.getEntries`). */
+interface HistoryEntry {
+    /** Stable id of the step (unchanged while a gesture merges into it). */
+    id: number;
+    /** The step's command name. */
+    label: string;
+    /** Position in the timeline: undo steps first (oldest = 0), then redo steps. */
+    index: number;
+    /** True for the step that produced the current state (the top of the undo stack). */
+    current: boolean;
+    /** True for steps on the redo stack (undone, can be redone). */
+    undone: boolean;
+}
+/**
+ * A point in the undo history, from `HistoryManager.mark()`, for `revertTo`.
+ * Treat it as opaque.
+ */
+interface HistoryMark {
+    readonly topId: number | null;
+    readonly nextId: number;
+    readonly epoch: number;
+    readonly dropped: number;
+}
+
+export type { Command as C, HistoryState as H, MergedExecutionOptions as M, SnapshotCommandOptions as S, HistoryEntry as a, HistoryManagerOptions as b, HistoryMark as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",
@@ -58,10 +58,16 @@
       "types": "./dist/image-editor/index.d.ts",
       "import": "./dist/image-editor/index.js",
       "require": "./dist/image-editor/index.cjs"
+    },
+    "./commands": {
+      "types": "./dist/commands/index.d.ts",
+      "import": "./dist/commands/index.js",
+      "require": "./dist/commands/index.cjs"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "sideEffects": false,
   "dependencies": {