@odoo/o-spreadsheet 18.0.55 → 18.0.67

package/dist/types/components/top_bar/top_bar.d.ts

@@ -0,0 +1,70 @@
+import { Component } from "@odoo/owl";
+import { Action, ActionSpec } from "../../actions/action";
+import * as ACTION_DATA from "../../actions/data_actions";
+import * as ACTION_EDIT from "../../actions/edit_actions";
+import * as ACTION_FORMAT from "../../actions/format_actions";
+import { Store } from "../../store_engine";
+import { Color, Pixel, SpreadsheetChildEnv } from "../../types/index";
+import { ActionButton } from "../action_button/action_button";
+import { BorderEditorWidget } from "../border_editor/border_editor_widget";
+import { ColorPicker } from "../color_picker/color_picker";
+import { ColorPickerWidget } from "../color_picker/color_picker_widget";
+import { ComposerFocusStore } from "../composer/composer_focus_store";
+import { TopBarComposer } from "../composer/top_bar_composer/top_bar_composer";
+import { FontSizeEditor } from "../font_size_editor/font_size_editor";
+import { Menu, MenuState } from "../menu/menu";
+import { TableDropdownButton } from "../tables/table_dropdown_button/table_dropdown_button";
+import { PaintFormatButton } from "./../paint_format_button/paint_format_button";
+interface State {
+    menuState: MenuState;
+    activeTool: string;
+    fillColor: string;
+    textColor: string;
+}
+interface Props {
+    onClick: () => void;
+    dropdownMaxHeight: Pixel;
+}
+export declare class TopBar extends Component<Props, SpreadsheetChildEnv> {
+    static template: string;
+    static props: {
+        onClick: FunctionConstructor;
+        dropdownMaxHeight: NumberConstructor;
+    };
+    get dropdownStyle(): string;
+    static components: {
+        ColorPickerWidget: typeof ColorPickerWidget;
+        ColorPicker: typeof ColorPicker;
+        Menu: typeof Menu;
+        TopBarComposer: typeof TopBarComposer;
+        FontSizeEditor: typeof FontSizeEditor;
+        ActionButton: typeof ActionButton;
+        PaintFormatButton: typeof PaintFormatButton;
+        BorderEditorWidget: typeof BorderEditorWidget;
+        TableDropdownButton: typeof TableDropdownButton;
+    };
+    state: State;
+    isSelectingMenu: boolean;
+    openedEl: HTMLElement | null;
+    menus: Action[];
+    EDIT: typeof ACTION_EDIT;
+    FORMAT: typeof ACTION_FORMAT;
+    DATA: typeof ACTION_DATA;
+    formatNumberMenuItemSpec: ActionSpec;
+    isntToolbarMenu: boolean;
+    composerFocusStore: Store<ComposerFocusStore>;
+    setup(): void;
+    get topbarComponents(): import("../../registries/topbar_component_registry").TopbarComponent[];
+    onExternalClick(ev: MouseEvent): void;
+    onClick(): void;
+    onMenuMouseOver(menu: Action, ev: MouseEvent): void;
+    toggleDropdownTool(tool: string, ev: MouseEvent): void;
+    toggleContextMenu(menu: Action, ev: MouseEvent): void;
+    toggleToolbarContextMenu(menuSpec: ActionSpec, ev: MouseEvent): void;
+    private openMenu;
+    closeMenus(): void;
+    updateCellState(): void;
+    getMenuName(menu: Action): string;
+    setColor(target: string, color: Color): void;
+}
+export {};

package/dist/types/components/translations_terms.d.ts

@@ -0,0 +1,191 @@
+export declare const CfTerms: {
+    Errors: {
+        InvalidRange: string;
+        FirstArgMissing: string;
+        SecondArgMissing: string;
+        MinNaN: string;
+        MidNaN: string;
+        MaxNaN: string;
+        ValueUpperInflectionNaN: string;
+        ValueLowerInflectionNaN: string;
+        MinBiggerThanMax: string;
+        MinBiggerThanMid: string;
+        MidBiggerThanMax: string;
+        LowerBiggerThanUpper: string;
+        MinInvalidFormula: string;
+        MaxInvalidFormula: string;
+        MidInvalidFormula: string;
+        ValueUpperInvalidFormula: string;
+        ValueLowerInvalidFormula: string;
+        EmptyRange: string;
+        ValueCellIsInvalidFormula: string;
+        Unexpected: string;
+    };
+    ColorScale: string;
+    IconSet: string;
+    DataBar: string;
+};
+export declare const CellIsOperators: {
+    IsEmpty: string;
+    IsNotEmpty: string;
+    ContainsText: string;
+    NotContains: string;
+    BeginsWith: string;
+    EndsWith: string;
+    Equal: string;
+    NotEqual: string;
+    GreaterThan: string;
+    GreaterThanOrEqual: string;
+    LessThan: string;
+    LessThanOrEqual: string;
+    Between: string;
+    NotBetween: string;
+};
+export declare const ChartTerms: {
+    Series: string;
+    BackgroundColor: string;
+    StackedBarChart: string;
+    StackedLineChart: string;
+    StackedAreaChart: string;
+    StackedColumnChart: string;
+    CumulativeData: string;
+    TreatLabelsAsText: string;
+    AggregatedChart: string;
+    Errors: {
+        Unexpected: string;
+        InvalidDataSet: string;
+        InvalidLabelRange: string;
+        InvalidScorecardKeyValue: string;
+        InvalidScorecardBaseline: string;
+        InvalidGaugeDataRange: string;
+        EmptyGaugeRangeMin: string;
+        GaugeRangeMinNaN: string;
+        EmptyGaugeRangeMax: string;
+        GaugeRangeMaxNaN: string;
+        GaugeRangeMinBiggerThanRangeMax: string;
+        GaugeLowerInflectionPointNaN: string;
+        GaugeUpperInflectionPointNaN: string;
+    };
+};
+export declare const CustomCurrencyTerms: {
+    Custom: string;
+};
+export declare const MergeErrorMessage: string;
+export declare const TableHeaderMoveErrorMessage: string;
+export declare const SplitToColumnsTerms: {
+    Errors: {
+        Unexpected: string;
+        NoSplitSeparatorInSelection: string;
+        MoreThanOneColumnSelected: string;
+        SplitWillOverwriteContent: string;
+    };
+};
+export declare const RemoveDuplicateTerms: {
+    Errors: {
+        Unexpected: string;
+        MoreThanOneRangeSelected: string;
+        EmptyTarget: string;
+        NoColumnsProvided: string;
+        WillRemoveExistingMerge: string;
+    };
+};
+export declare const DVTerms: {
+    DateIs: {
+        today: string;
+        yesterday: string;
+        tomorrow: string;
+        lastWeek: string;
+        lastMonth: string;
+        lastYear: string;
+    };
+    DateIsBefore: {
+        today: string;
+        yesterday: string;
+        tomorrow: string;
+        lastWeek: string;
+        lastMonth: string;
+        lastYear: string;
+    };
+    CriterionError: {
+        notEmptyValue: string;
+        numberValue: string;
+        dateValue: string;
+        validRange: string;
+    };
+};
+export declare const TableTerms: {
+    Errors: {
+        Unexpected: string;
+        TableOverlap: string;
+        NonContinuousTargets: string;
+        InvalidRange: string;
+        TargetOutOfSheet: string;
+    };
+    Checkboxes: {
+        hasFilters: string;
+        headerRow: string;
+        bandedRows: string;
+        firstColumn: string;
+        lastColumn: string;
+        bandedColumns: string;
+        automaticAutofill: string;
+        totalRow: string;
+        isDynamic: string;
+    };
+    Tooltips: {
+        filterWithoutHeader: string;
+        isDynamic: string;
+    };
+};
+export declare const measureDisplayTerms: {
+    labels: {
+        no_calculations: string;
+        "%_of_grand_total": string;
+        "%_of_col_total": string;
+        "%_of_row_total": string;
+        "%_of": string;
+        "%_of_parent_row_total": string;
+        "%_of_parent_col_total": string;
+        "%_of_parent_total": string;
+        difference_from: string;
+        "%_difference_from": string;
+        running_total: string;
+        "%_running_total": string;
+        rank_asc: string;
+        rank_desc: string;
+        index: string;
+    };
+    descriptions: {
+        "%_of_grand_total": () => string;
+        "%_of_col_total": () => string;
+        "%_of_row_total": () => string;
+        "%_of": (field: string) => string;
+        "%_of_parent_row_total": (field: string) => string;
+        "%_of_parent_col_total": () => string;
+        "%_of_parent_total": (field: string) => string;
+        difference_from: (field: string) => string;
+        "%_difference_from": (field: string) => string;
+        running_total: (field: string) => string;
+        "%_running_total": (field: string) => string;
+        rank_asc: (field: string) => string;
+        rank_desc: (field: string) => string;
+        index: () => string;
+    };
+    documentation: {
+        no_calculations: string;
+        "%_of_grand_total": string;
+        "%_of_col_total": string;
+        "%_of_row_total": string;
+        "%_of": string;
+        "%_of_parent_row_total": string;
+        "%_of_parent_col_total": string;
+        "%_of_parent_total": string;
+        difference_from: string;
+        "%_difference_from": string;
+        running_total: string;
+        "%_running_total": string;
+        rank_asc: string;
+        rank_desc: string;
+        index: string;
+    };
+};

package/dist/types/components/validation_messages/validation_messages.d.ts

@@ -0,0 +1,21 @@
+import { Component } from "@odoo/owl";
+import { SpreadsheetChildEnv } from "../../types/index";
+interface Props {
+    messages: string[];
+    msgType: "warning" | "error" | "info";
+    singleBox?: boolean;
+}
+export declare class ValidationMessages extends Component<Props, SpreadsheetChildEnv> {
+    static template: string;
+    static props: {
+        messages: ArrayConstructor;
+        msgType: StringConstructor;
+        singleBox: {
+            type: BooleanConstructor;
+            optional: boolean;
+        };
+    };
+    get divClasses(): "o-validation-warning" | "o-validation-info" | "o-validation-error";
+    get alertBoxes(): string[][];
+}
+export {};

package/dist/types/constants.d.ts

@@ -0,0 +1,179 @@
+import { BorderDescr, Color, Currency } from "./types";
+export declare const CANVAS_SHIFT = 0.5;
+export declare const HIGHLIGHT_COLOR = "#37A850";
+export declare const BACKGROUND_GRAY_COLOR = "#f5f5f5";
+export declare const BACKGROUND_HEADER_COLOR = "#F8F9FA";
+export declare const BACKGROUND_HEADER_SELECTED_COLOR = "#E8EAED";
+export declare const BACKGROUND_HEADER_ACTIVE_COLOR = "#595959";
+export declare const TEXT_HEADER_COLOR = "#666666";
+export declare const FIGURE_BORDER_COLOR = "#c9ccd2";
+export declare const SELECTION_BORDER_COLOR = "#3266ca";
+export declare const HEADER_BORDER_COLOR = "#C0C0C0";
+export declare const CELL_BORDER_COLOR = "#E2E3E3";
+export declare const BACKGROUND_CHART_COLOR = "#FFFFFF";
+export declare const DISABLED_TEXT_COLOR = "#CACACA";
+export declare const DEFAULT_COLOR_SCALE_MIDPOINT_COLOR = 11982760;
+export declare const LINK_COLOR = "#017E84";
+export declare const FILTERS_COLOR = "#188038";
+export declare const BACKGROUND_HEADER_FILTER_COLOR = "#E6F4EA";
+export declare const SEPARATOR_COLOR = "#E0E2E4";
+export declare const ICONS_COLOR = "#4A4F59";
+export declare const HEADER_GROUPING_BACKGROUND_COLOR = "#F5F5F5";
+export declare const HEADER_GROUPING_BORDER_COLOR = "#999";
+export declare const GRID_BORDER_COLOR = "#E2E3E3";
+export declare const FROZEN_PANE_HEADER_BORDER_COLOR = "#BCBCBC";
+export declare const FROZEN_PANE_BORDER_COLOR = "#DADFE8";
+export declare const COMPOSER_ASSISTANT_COLOR = "#9B359B";
+export declare const CHART_WATERFALL_POSITIVE_COLOR = "#4EA7F2";
+export declare const CHART_WATERFALL_NEGATIVE_COLOR = "#EA6175";
+export declare const CHART_WATERFALL_SUBTOTAL_COLOR = "#AAAAAA";
+export declare const GRAY_900 = "#111827";
+export declare const GRAY_300 = "#D8DADD";
+export declare const GRAY_200 = "#E7E9ED";
+export declare const GRAY_100 = "#F9FAFB";
+export declare const TEXT_BODY = "#374151";
+export declare const TEXT_BODY_MUTED: string;
+export declare const TEXT_HEADING = "#111827";
+export declare const PRIMARY_BUTTON_BG = "#714B67";
+export declare const PRIMARY_BUTTON_HOVER_BG = "#624159";
+export declare const PRIMARY_BUTTON_ACTIVE_BG = "#f1edf0";
+export declare const BUTTON_BG = "#E7E9ED";
+export declare const BUTTON_HOVER_BG = "#D8DADD";
+export declare const BUTTON_HOVER_TEXT_COLOR = "#111827";
+export declare const BUTTON_ACTIVE_BG = "#e6f2f3";
+export declare const BUTTON_ACTIVE_TEXT_COLOR = "#111827";
+export declare const ACTION_COLOR = "#017E84";
+export declare const ACTION_COLOR_HOVER = "#01585c";
+export declare const ALERT_WARNING_BG = "#FBEBCC";
+export declare const ALERT_WARNING_BORDER = "#F8E2B3";
+export declare const ALERT_WARNING_TEXT_COLOR = "#946D23";
+export declare const ALERT_DANGER_BG = "#D44C591A";
+export declare const ALERT_DANGER_BORDER = "#C34A41";
+export declare const ALERT_DANGER_TEXT_COLOR = "#C34A41";
+export declare const ALERT_INFO_BG = "#CDEDF1";
+export declare const ALERT_INFO_BORDER = "#98DBE2";
+export declare const ALERT_INFO_TEXT_COLOR = "#09414A";
+export declare const BADGE_SELECTED_COLOR = "#E6F2F3";
+export declare const DEFAULT_CHART_PADDING = 20;
+export declare const DEFAULT_CHART_FONT_SIZE = 22;
+export declare const SCORECARD_GAUGE_CHART_PADDING = 10;
+export declare const SCORECARD_GAUGE_CHART_FONT_SIZE = 14;
+export declare const COLOR_PICKER_DEFAULTS: Color[];
+export declare const MIN_ROW_HEIGHT = 10;
+export declare const MIN_COL_WIDTH = 5;
+export declare const HEADER_HEIGHT = 26;
+export declare const HEADER_WIDTH = 48;
+export declare const TOPBAR_HEIGHT = 63;
+export declare const TOPBAR_TOOLBAR_HEIGHT = 34;
+export declare const BOTTOMBAR_HEIGHT = 36;
+export declare const DEFAULT_CELL_WIDTH = 96;
+export declare const DEFAULT_CELL_HEIGHT = 23;
+export declare const SCROLLBAR_WIDTH = 15;
+export declare const AUTOFILL_EDGE_LENGTH = 8;
+export declare const ICON_EDGE_LENGTH = 18;
+export declare const UNHIDE_ICON_EDGE_LENGTH = 14;
+export declare const MIN_CF_ICON_MARGIN = 4;
+export declare const MIN_CELL_TEXT_MARGIN = 4;
+export declare const CF_ICON_EDGE_LENGTH = 15;
+export declare const PADDING_AUTORESIZE_VERTICAL = 3;
+export declare const PADDING_AUTORESIZE_HORIZONTAL = 4;
+export declare const GROUP_LAYER_WIDTH = 21;
+export declare const GRID_ICON_MARGIN = 2;
+export declare const GRID_ICON_EDGE_LENGTH = 17;
+export declare const FILTER_ICON_MARGIN = 2;
+export declare const FILTER_ICON_EDGE_LENGTH = 17;
+export declare const FOOTER_HEIGHT: number;
+export declare const MENU_WIDTH = 250;
+export declare const MENU_VERTICAL_PADDING = 6;
+export declare const MENU_ITEM_HEIGHT = 26;
+export declare const MENU_ITEM_PADDING_HORIZONTAL = 11;
+export declare const MENU_ITEM_PADDING_VERTICAL = 4;
+export declare const MENU_SEPARATOR_BORDER_WIDTH = 1;
+export declare const MENU_SEPARATOR_PADDING = 5;
+export declare const MENU_SEPARATOR_HEIGHT: number;
+export declare const DEFAULT_STYLE: {
+    align: "left";
+    verticalAlign: "bottom";
+    wrapping: "overflow";
+    bold: false;
+    italic: false;
+    strikethrough: false;
+    underline: false;
+    fontSize: number;
+    fillColor: string;
+    textColor: string;
+};
+export declare const DEFAULT_NUMBER_STYLE: {
+    align: "right";
+    verticalAlign: "bottom";
+    wrapping: "overflow";
+    bold: false;
+    italic: false;
+    strikethrough: false;
+    underline: false;
+    fontSize: number;
+    fillColor: string;
+    textColor: string;
+};
+export declare const DEFAULT_VERTICAL_ALIGN: "bottom";
+export declare const DEFAULT_WRAPPING_MODE: "overflow";
+export declare const DEFAULT_FONT_WEIGHT = "400";
+export declare const DEFAULT_FONT_SIZE: number;
+export declare const HEADER_FONT_SIZE = 11;
+export declare const DEFAULT_FONT = "'Roboto', arial";
+export declare const DEFAULT_BORDER_DESC: BorderDescr;
+export declare const DEFAULT_FILTER_BORDER_DESC: BorderDescr;
+export declare const MAX_HISTORY_STEPS = 99;
+export declare const DEFAULT_REVISION_ID = "START_REVISION";
+export declare const DEFAULT_FIGURE_HEIGHT = 335;
+export declare const DEFAULT_FIGURE_WIDTH = 536;
+export declare const FIGURE_BORDER_WIDTH = 1;
+export declare const ACTIVE_BORDER_WIDTH = 2;
+export declare const MIN_FIG_SIZE = 80;
+export declare const MAX_CHAR_LABEL = 20;
+export declare const FIGURE_ID_SPLITTER = "??";
+export declare const DEFAULT_GAUGE_LOWER_COLOR = "#EA6175";
+export declare const DEFAULT_GAUGE_MIDDLE_COLOR = "#FFD86D";
+export declare const DEFAULT_GAUGE_UPPER_COLOR = "#43C5B1";
+export declare const DEFAULT_SCORECARD_BASELINE_MODE = "difference";
+export declare const DEFAULT_SCORECARD_BASELINE_COLOR_UP = "#43C5B1";
+export declare const DEFAULT_SCORECARD_BASELINE_COLOR_DOWN = "#EA6175";
+export declare const LINE_FILL_TRANSPARENCY = 0.4;
+export declare const DEBOUNCE_TIME = 200;
+export declare const MESSAGE_VERSION = 1;
+export declare const FORBIDDEN_SHEETNAME_CHARS: readonly ["'", "*", "?", "/", "\\", "[", "]"];
+export declare const FORBIDDEN_SHEETNAME_CHARS_IN_EXCEL_REGEX: RegExp;
+export declare const FORMULA_REF_IDENTIFIER = "|";
+export declare const LOADING = "Loading...";
+export declare enum ComponentsImportance {
+    Grid = 0,
+    Highlight = 5,
+    HeaderGroupingButton = 6,
+    Figure = 10,
+    ScrollBar = 15,
+    GridPopover = 19,
+    GridComposer = 20,
+    Dropdown = 21,
+    IconPicker = 25,
+    TopBarComposer = 30,
+    Popover = 35,
+    FigureAnchor = 1000,
+    FigureSnapLine = 1001
+}
+export declare function getDefaultSheetViewSize(): number;
+export declare function setDefaultSheetViewSize(size: number): void;
+export declare const MAXIMAL_FREEZABLE_RATIO = 0.85;
+export declare const NEWLINE = "\n";
+export declare const FONT_SIZES: number[];
+export declare const PIVOT_TABLE_CONFIG: {
+    hasFilters: boolean;
+    totalRow: boolean;
+    firstColumn: boolean;
+    lastColumn: boolean;
+    numberOfHeaders: number;
+    bandedRows: boolean;
+    bandedColumns: boolean;
+    styleId: string;
+    automaticAutofill: boolean;
+};
+export declare const DEFAULT_CURRENCY: Currency;

package/dist/types/formulas/code_builder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Block of code that produces a value.
+ */
+export interface FunctionCode {
+    readonly returnExpression: string;
+    /**
+     * Return the same function code but with the return expression assigned to a variable.
+     */
+    assignResultToVariable(): FunctionCode;
+}
+export declare class FunctionCodeBuilder {
+    private scope;
+    private code;
+    constructor(scope?: Scope);
+    append(...lines: (string | FunctionCode)[]): void;
+    return(expression: string): FunctionCode;
+    toString(): string;
+}
+export declare class Scope {
+    private nextId;
+    private declaredVariables;
+    nextVariableName(): string;
+    isAlreadyDeclared(name: string): boolean;
+}

package/dist/types/formulas/compiler.d.ts

@@ -0,0 +1,26 @@
+import { Token } from ".";
+import { CompiledFormula, FormulaToExecute } from "../types";
+export declare const OPERATOR_MAP: {
+    "=": string;
+    "+": string;
+    "-": string;
+    "*": string;
+    "/": string;
+    ">=": string;
+    "<>": string;
+    ">": string;
+    "<=": string;
+    "<": string;
+    "^": string;
+    "&": string;
+};
+export declare const UNARY_OPERATOR_MAP: {
+    "-": string;
+    "+": string;
+    "%": string;
+};
+export declare const functionCache: {
+    [key: string]: FormulaToExecute;
+};
+export declare function compile(formula: string): CompiledFormula;
+export declare function compileTokens(tokens: Token[]): CompiledFormula;

package/dist/types/formulas/composer_tokenizer.d.ts

@@ -0,0 +1,48 @@
+import { Locale } from "../types";
+import { Token } from "./index";
+import { AST } from "./parser";
+interface FunctionContext {
+    /**
+     * The parent function name of the token.
+     */
+    parent: string;
+    /**
+     * The position of the token within the argument list of its parent function.
+     */
+    argPosition: number;
+    /**
+     * An array of parsed arguments, possibly containing undefined values if the argument
+     * is empty or is an invalid expression.
+     */
+    args: (AST | undefined)[];
+    /**
+     * Array of token arrays representing the tokens for each argument.
+     * Needed as an intermediate step to parse the arguments AST (see `args` property).
+     */
+    argsTokens?: Token[][];
+}
+/**
+ * Enriched Token is used by the composer to add information on the tokens that
+ * are only needed during the edition of a formula.
+ *
+ * The information added are:
+ * - start, end and length of each token
+ * - range detection (replaces the tokens that composes the range with 1 token)
+ * - parenthesis matching (only for parenthesis tokens)
+ * - parent function (only for tokens surrounded by a function)
+ * - arg position (only for tokens surrounded by a function)
+ */
+export interface EnrichedToken extends Token {
+    start: number;
+    end: number;
+    length: number;
+    parenIndex?: number;
+    functionContext?: FunctionContext;
+}
+/**
+ * Take the result of the tokenizer and transform it to be usable in the composer.
+ *
+ * @param formula
+ */
+export declare function composerTokenize(formula: string, locale: Locale): EnrichedToken[];
+export {};

package/dist/types/formulas/helpers.d.ts

@@ -0,0 +1,7 @@
+import { AST } from "./parser";
+import { Token } from "./tokenizer";
+export declare function isExportableToExcel(tokens: Token[]): boolean;
+export declare function getFunctionsFromTokens(tokens: Token[], functionNames: string[]): {
+    functionName: string;
+    args: AST[];
+}[];

package/dist/types/formulas/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The formulas module provides all functionality related to manipulating
+ * formulas:
+ *
+ * - tokenization (transforming a string into a list of tokens)
+ * - parsing (same, but into an AST (Abstract Syntax Tree))
+ * - compiler (getting an executable function representing a formula)
+ */
+export { compile } from "./compiler";
+export * from "./helpers";
+export { parse } from "./parser";
+export { rangeTokenize } from "./range_tokenizer";
+export { tokenize } from "./tokenizer";
+export type { Token } from "./tokenizer";

package/dist/types/formulas/parser.d.ts

@@ -0,0 +1,76 @@
+import { Token } from "./tokenizer";
+interface ASTBase {
+    debug?: boolean;
+}
+interface ASTNumber extends ASTBase {
+    type: "NUMBER";
+    value: number;
+}
+interface ASTReference extends ASTBase {
+    type: "REFERENCE";
+    value: string;
+}
+export interface ASTString extends ASTBase {
+    type: "STRING";
+    value: string;
+}
+interface ASTBoolean extends ASTBase {
+    type: "BOOLEAN";
+    value: boolean;
+}
+interface ASTUnaryOperation extends ASTBase {
+    type: "UNARY_OPERATION";
+    value: any;
+    operand: AST;
+    postfix?: boolean;
+}
+interface ASTOperation extends ASTBase {
+    type: "BIN_OPERATION";
+    value: any;
+    left: AST;
+    right: AST;
+}
+export interface ASTFuncall extends ASTBase {
+    type: "FUNCALL";
+    value: string;
+    args: AST[];
+}
+export interface ASTSymbol extends ASTBase {
+    type: "SYMBOL";
+    value: string;
+}
+interface ASTEmpty extends ASTBase {
+    type: "EMPTY";
+    value: "";
+}
+export type AST = ASTOperation | ASTUnaryOperation | ASTFuncall | ASTSymbol | ASTNumber | ASTBoolean | ASTString | ASTReference | ASTEmpty;
+/**
+ * Parse an expression (as a string) into an AST.
+ */
+export declare function parse(str: string): AST;
+export declare function parseTokens(tokens: Token[]): AST;
+/**
+ * Allows to visit all nodes of an AST and apply a mapping function
+ * to nodes of a specific type.
+ * Useful if you want to convert some part of a formula.
+ *
+ * @example
+ * convertAstNodes(ast, "FUNCALL", convertFormulaToExcel)
+ *
+ * function convertFormulaToExcel(ast: ASTFuncall) {
+ *   // ...
+ *   return modifiedAst
+ * }
+ */
+export declare function convertAstNodes<T extends AST["type"]>(ast: AST, type: T, fn: (ast: Extract<AST, {
+    type: T;
+}>) => AST): AST;
+export declare function iterateAstNodes(ast: AST): AST[];
+export declare function mapAst<T extends AST["type"]>(ast: AST, fn: (ast: Extract<AST, {
+    type: T;
+}>) => AST): AST;
+/**
+ * Converts an ast formula to the corresponding string
+ */
+export declare function astToFormula(ast: AST): string;
+export {};

package/dist/types/formulas/range_tokenizer.d.ts

@@ -0,0 +1,8 @@
+import { Token } from "./tokenizer";
+/**
+ * Take the result of the tokenizer and transform it to be usable in the
+ * manipulations of range
+ *
+ * @param formula
+ */
+export declare function rangeTokenize(formula: string, locale?: import("..").Locale): Token[];