@trebco/treb 36.1.4 → 37.0.1

package/build/treb-grid/src/types/grid_command.js

@@ -0,0 +1,75 @@
+/*
+ * This file is part of TREB.
+ *
+ * TREB is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any
+ * later version.
+ *
+ * TREB is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with TREB. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * Copyright 2022-2026 trebco, llc.
+ * info@treb.app
+ *
+ */
+/**
+ * switching to an exec-command based model, so we can serialize
+ * data, layout and style changes; the intent is to support recording,
+ * replaying, and transmitting modifications.
+ *
+ * NOTE regarding commands: let's make them as explicit as possible
+ * (meaning fewer optional parameters). force callers to populate fields.
+ *
+ */
+/**
+ * commands are symbolic for (hopefully) faster switching. we use a
+ * discriminated union for build-time parameter checks. see individual
+ * command interfaces for comments.
+ */
+export var CommandKey;
+(function (CommandKey) {
+    /** use an empty value so all commands are non-zero */
+    CommandKey[CommandKey["Null"] = 0] = "Null";
+    CommandKey[CommandKey["InsertRows"] = 1] = "InsertRows";
+    CommandKey[CommandKey["InsertColumns"] = 2] = "InsertColumns";
+    CommandKey[CommandKey["ResizeRows"] = 3] = "ResizeRows";
+    CommandKey[CommandKey["ResizeColumns"] = 4] = "ResizeColumns";
+    CommandKey[CommandKey["Select"] = 5] = "Select";
+    CommandKey[CommandKey["SetRange"] = 6] = "SetRange";
+    CommandKey[CommandKey["UpdateStyle"] = 7] = "UpdateStyle";
+    CommandKey[CommandKey["UpdateBorders"] = 8] = "UpdateBorders";
+    CommandKey[CommandKey["Indent"] = 9] = "Indent";
+    CommandKey[CommandKey["MergeCells"] = 10] = "MergeCells";
+    CommandKey[CommandKey["UnmergeCells"] = 11] = "UnmergeCells";
+    CommandKey[CommandKey["Clear"] = 12] = "Clear";
+    CommandKey[CommandKey["UpdateTheme"] = 13] = "UpdateTheme";
+    CommandKey[CommandKey["SetNote"] = 14] = "SetNote";
+    CommandKey[CommandKey["SetLink"] = 15] = "SetLink";
+    CommandKey[CommandKey["Freeze"] = 16] = "Freeze";
+    CommandKey[CommandKey["SetName"] = 17] = "SetName";
+    CommandKey[CommandKey["ShowHeaders"] = 18] = "ShowHeaders";
+    CommandKey[CommandKey["AddSheet"] = 19] = "AddSheet";
+    CommandKey[CommandKey["DuplicateSheet"] = 20] = "DuplicateSheet";
+    CommandKey[CommandKey["DeleteSheet"] = 21] = "DeleteSheet";
+    CommandKey[CommandKey["ActivateSheet"] = 22] = "ActivateSheet";
+    CommandKey[CommandKey["RenameSheet"] = 23] = "RenameSheet";
+    CommandKey[CommandKey["ReorderSheet"] = 24] = "ReorderSheet";
+    CommandKey[CommandKey["ShowSheet"] = 25] = "ShowSheet";
+    CommandKey[CommandKey["DataValidation"] = 26] = "DataValidation";
+    CommandKey[CommandKey["Reset"] = 27] = "Reset";
+    CommandKey[CommandKey["SortTable"] = 28] = "SortTable";
+    CommandKey[CommandKey["InsertTable"] = 29] = "InsertTable";
+    CommandKey[CommandKey["RemoveTable"] = 30] = "RemoveTable";
+    CommandKey[CommandKey["AddConditionalFormat"] = 31] = "AddConditionalFormat";
+    CommandKey[CommandKey["RemoveConditionalFormat"] = 32] = "RemoveConditionalFormat";
+    CommandKey[CommandKey["TabColor"] = 33] = "TabColor";
+    CommandKey[CommandKey["CreateAnnotation"] = 34] = "CreateAnnotation";
+    CommandKey[CommandKey["RemoveAnnotation"] = 35] = "RemoveAnnotation";
+})(CommandKey || (CommandKey = {}));
+//# sourceMappingURL=grid_command.js.map

package/build/treb-grid/src/types/grid_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid_command.js","sourceRoot":"","sources":["../../../../treb-grid/src/types/grid_command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,CAAN,IAAY,UA2CX;AA3CD,WAAY,UAAU;IAEpB,sDAAsD;IACtD,2CAAQ,CAAA;IAER,uDAAU,CAAA;IACV,6DAAa,CAAA;IACb,uDAAU,CAAA;IACV,6DAAa,CAAA;IACb,+CAAM,CAAA;IACN,mDAAQ,CAAA;IACR,yDAAW,CAAA;IACX,6DAAa,CAAA;IACb,+CAAM,CAAA;IACN,wDAAU,CAAA;IACV,4DAAY,CAAA;IACZ,8CAAK,CAAA;IACL,0DAAW,CAAA;IACX,kDAAO,CAAA;IACP,kDAAO,CAAA;IACP,gDAAM,CAAA;IACN,kDAAO,CAAA;IACP,0DAAW,CAAA;IACX,oDAAQ,CAAA;IACR,gEAAc,CAAA;IACd,0DAAW,CAAA;IACX,8DAAa,CAAA;IACb,0DAAW,CAAA;IACX,4DAAY,CAAA;IACZ,sDAAS,CAAA;IACT,gEAAc,CAAA;IACd,8CAAK,CAAA;IACL,sDAAS,CAAA;IACT,0DAAW,CAAA;IACX,0DAAW,CAAA;IAEX,4EAAoB,CAAA;IACpB,kFAAuB,CAAA;IAEvB,oDAAQ,CAAA;IACR,oEAAgB,CAAA;IAChB,oEAAgB,CAAA;AAElB,CAAC,EA3CW,UAAU,KAAV,UAAU,QA2CrB"}

package/build/treb-grid/src/types/grid_events.d.ts

@@ -0,0 +1,93 @@
+import type { Annotation, GridSelection, Sheet } from 'treb-data-model';
+import type { Area } from 'treb-base-types';
+export declare enum ErrorCode {
+    /** no error: zero so it's falsy */
+    none = 0,
+    /** placeholder for new errors */
+    unknown = 1,
+    /** you can't change part of an array */
+    array = 2,
+    /** invalid value (data validation) */
+    data_validation = 3,
+    /** invalid area for insert table: there's a merge, array or existing table within the range */
+    invalid_area_for_table = 4,
+    /** invalid area for paste, same as invalid area for table */
+    invalid_area_for_paste = 5
+}
+export interface SheetChangeEvent {
+    type: 'sheet-change';
+    activate: Sheet;
+    deactivate: Sheet;
+}
+export interface GridSelectionEvent {
+    type: 'selection';
+    selection: GridSelection;
+    reason?: 'sheet-change';
+}
+export interface GridAlternateSelectionEvent {
+    type: 'alternate-selection';
+    selection: GridSelection;
+}
+/**
+ * we used to return strings here, changed to error codes for l10n
+ */
+export interface GridErrorEvent {
+    type: 'error';
+    code: ErrorCode;
+}
+export interface StructureEvent {
+    type: 'structure';
+    /**
+     * this flag should be set if the structure change changes references,
+     * insert or delete events. resize events don't need to set it.
+     *
+     * FIXME: merge/unmerge? (...) I think yes
+     */
+    rebuild_required?: boolean;
+    /**
+     * we can use this when conditional formats are modified/added/removed
+     */
+    conditional_format?: boolean;
+    /**
+     * this flag should be set if annotations have been added or removed,
+     * so parent/child views can update as necessary
+     */
+    update_annotations?: boolean;
+}
+export interface AnnotationEvent {
+    type: 'annotation';
+    annotation?: Annotation;
+    event?: 'move' | 'resize' | 'create' | 'delete' | 'update' | 'select';
+}
+export interface HyperlinkCellEventData {
+    type: 'hyperlink';
+    reference: string;
+}
+export interface CellEvent {
+    type: 'cell-event';
+    data?: HyperlinkCellEventData;
+}
+/**
+ * data + style. temporary while I figure out a better solution.
+ */
+export interface CompositeEvent {
+    type: 'composite';
+    data_area?: Area;
+    style_area?: Area;
+}
+export interface DataEvent {
+    type: 'data';
+    area?: Area;
+}
+export interface FlushEvent {
+    type: 'flush';
+}
+export interface StyleEvent {
+    type: 'style';
+    area?: Area;
+}
+export interface ScaleEvent {
+    type: 'scale';
+    scale: number;
+}
+export type GridEvent = DataEvent | CellEvent | StyleEvent | FlushEvent | ScaleEvent | CompositeEvent | GridErrorEvent | StructureEvent | AnnotationEvent | SheetChangeEvent | GridSelectionEvent | GridAlternateSelectionEvent;

package/build/treb-grid/src/types/grid_events.js

@@ -0,0 +1,36 @@
+/*
+ * This file is part of TREB.
+ *
+ * TREB is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any
+ * later version.
+ *
+ * TREB is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with TREB. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * Copyright 2022-2026 trebco, llc.
+ * info@treb.app
+ *
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    /** no error: zero so it's falsy */
+    ErrorCode[ErrorCode["none"] = 0] = "none";
+    /** placeholder for new errors */
+    ErrorCode[ErrorCode["unknown"] = 1] = "unknown";
+    /** you can't change part of an array */
+    ErrorCode[ErrorCode["array"] = 2] = "array";
+    /** invalid value (data validation) */
+    ErrorCode[ErrorCode["data_validation"] = 3] = "data_validation";
+    /** invalid area for insert table: there's a merge, array or existing table within the range */
+    ErrorCode[ErrorCode["invalid_area_for_table"] = 4] = "invalid_area_for_table";
+    /** invalid area for paste, same as invalid area for table */
+    ErrorCode[ErrorCode["invalid_area_for_paste"] = 5] = "invalid_area_for_paste";
+})(ErrorCode || (ErrorCode = {}));
+//# sourceMappingURL=grid_events.js.map

package/build/treb-grid/src/types/grid_events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid_events.js","sourceRoot":"","sources":["../../../../treb-grid/src/types/grid_events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,MAAM,CAAN,IAAY,SAoBX;AApBD,WAAY,SAAS;IAEnB,mCAAmC;IACnC,yCAAQ,CAAA;IAER,iCAAiC;IACjC,+CAAO,CAAA;IAEP,wCAAwC;IACxC,2CAAK,CAAA;IAEL,sCAAsC;IACtC,+DAAe,CAAA;IAEf,+FAA+F;IAC/F,6EAAsB,CAAA;IAEtB,6DAA6D;IAC7D,6EAAsB,CAAA;AAExB,CAAC,EApBW,SAAS,KAAT,SAAS,QAoBpB"}

package/build/treb-grid/src/types/grid_options.d.ts

@@ -0,0 +1,50 @@
+import type { CellValue } from 'treb-base-types';
+import type { StatsEntry } from './tab_bar';
+export type StatsFunction = (data: CellValue | CellValue[][] | undefined) => StatsEntry[];
+/**
+ * @internalRemarks
+ *
+ * why are there two levels of options? can we consolidate this with
+ * the embedded spreadsheet options? they are never (AFAICT) used
+ * independently. maybe that's recent.
+ */
+export type GridOptions = {
+    /** can expand rows/columns */
+    expand?: boolean;
+    /**
+     * if you are running a calculator, you might not want the grid
+     * to repaint any time there's a data change (which is the default
+     * behavior).
+     */
+    repaint_on_cell_change?: boolean;
+    /** support in-cell editing */
+    in_cell_editor?: boolean;
+    /** show the formula bar (and allow editing; TODO: read-only option) */
+    formula_bar?: boolean;
+    /** show the tab bar */
+    tab_bar?: boolean | 'auto';
+    /** scale controls. implies tab bar */
+    scale_control?: boolean;
+    /** stats panel. implies tab bar */
+    stats?: boolean | StatsFunction;
+    /** save/load scale to storage, with the given key */
+    persist_scale_key?: string;
+    /** allow add tab */
+    add_tab?: boolean;
+    /** button to increase/reduce size of formula editor */
+    expand_formula_button?: boolean;
+    /** scale (wip) */
+    /** enable scrolling (default true) */
+    scrollbars?: boolean;
+    /** always show grid, even if there is background color */
+    grid_over_background?: boolean;
+    /** initial scale for layout */
+    initial_scale?: number;
+    /** support MD formatting in text */
+    markdown?: boolean;
+    /** support MD formatting in comments */
+    comment_markdown?: boolean;
+    /** support font stacks */
+    support_font_stacks?: boolean;
+};
+export declare const DefaultGridOptions: GridOptions;

package/build/treb-grid/src/types/grid_options.js

@@ -0,0 +1,34 @@
+/*
+ * This file is part of TREB.
+ *
+ * TREB is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any
+ * later version.
+ *
+ * TREB is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with TREB. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * Copyright 2022-2026 trebco, llc.
+ * info@treb.app
+ *
+ */
+export const DefaultGridOptions = {
+    scrollbars: true,
+    in_cell_editor: true,
+    formula_bar: true,
+    add_tab: false,
+    tab_bar: 'auto',
+    // insert_function_button: false,
+    expand_formula_button: false,
+    expand: true,
+    comment_markdown: true,
+    repaint_on_cell_change: true,
+    grid_over_background: false, // true,
+};
+//# sourceMappingURL=grid_options.js.map

package/build/treb-grid/src/types/grid_options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid_options.js","sourceRoot":"","sources":["../../../../treb-grid/src/types/grid_options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAiFH,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,MAAM;IACf,iCAAiC;IACjC,qBAAqB,EAAE,KAAK;IAC5B,MAAM,EAAE,IAAI;IACZ,gBAAgB,EAAE,IAAI;IACtB,sBAAsB,EAAE,IAAI;IAC5B,oBAAoB,EAAE,KAAK,EAAE,QAAQ;CACtC,CAAC"}

package/build/treb-grid/src/types/scale-control.d.ts

@@ -0,0 +1,21 @@
+import { EventSource } from 'treb-utils';
+export interface ScaleEvent {
+    type: 'scale';
+    value: number;
+    keep_focus?: boolean;
+}
+/**
+ * updated scale control, broken out. this is based on what we did for
+ * project planning, which worked out rather nicely.
+ */
+export declare class ScaleControl extends EventSource<ScaleEvent> {
+    container: HTMLElement;
+    private input;
+    private slider;
+    private scale;
+    private format;
+    private timeout;
+    constructor(container: HTMLElement);
+    Tick(value: number): void;
+    UpdateScale(scale: number, notify?: boolean, keep_focus?: boolean): void;
+}

package/build/treb-grid/src/types/scale-control.js

@@ -0,0 +1,148 @@
+/*
+ * This file is part of TREB.
+ *
+ * TREB is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any
+ * later version.
+ *
+ * TREB is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with TREB. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * Copyright 2022-2026 trebco, llc.
+ * info@treb.app
+ *
+ */
+import { DOMContext } from 'treb-base-types';
+import { NumberFormat, NumberFormatCache, ValueParser } from 'treb-format';
+import { ValueType } from 'treb-base-types';
+import { EventSource } from 'treb-utils';
+/**
+ * updated scale control, broken out. this is based on what we did for
+ * project planning, which worked out rather nicely.
+ */
+export class ScaleControl extends EventSource {
+    container;
+    input;
+    slider;
+    scale = 0;
+    format;
+    timeout = 0;
+    constructor(container) {
+        super();
+        this.container = container;
+        this.format = NumberFormatCache.Get('0.0');
+        const DOM = DOMContext.GetInstance(container.ownerDocument);
+        this.input = DOM.Create('input', 'treb-scale-input', container, {
+            events: {
+                // is this for some x-browser issue? or did we just not 
+                // know which event to use and this is old junk?
+                keypress: (event) => {
+                    switch (event.key) {
+                        case 'ArrowUp':
+                        case 'ArrowDown':
+                            event.stopPropagation();
+                            event.preventDefault();
+                            console.info('mark?');
+                            break;
+                    }
+                },
+                keydown: (event) => {
+                    switch (event.key) {
+                        case 'Enter':
+                            this.input.blur();
+                            break;
+                        case 'ArrowUp':
+                            this.Tick(-1);
+                            break;
+                        case 'ArrowDown':
+                            this.Tick(1);
+                            break;
+                        case 'Escape':
+                            this.input.value = this.format.Format(this.scale) + '%';
+                            this.input.blur();
+                            break;
+                        default:
+                            return;
+                    }
+                    event.stopPropagation();
+                    event.preventDefault();
+                },
+                // select text on click
+                focusin: () => this.input.select(),
+                change: () => {
+                    // what we're doing here is a little unusual. we always treat
+                    // the value as a percent, even if there's no percent sign.
+                    // for that to work, if there is a percent sign, we need to remove
+                    // it before we continue. then try to parse as a number.
+                    let text = this.input.value;
+                    text = text.replace(/%/g, '');
+                    const value = ValueParser.TryParse(text);
+                    if (value.type === ValueType.number) {
+                        this.UpdateScale(Number(value.value), true);
+                    }
+                    else {
+                        this.input.value = this.format.Format(this.scale) + '%';
+                    }
+                },
+            }
+        });
+        const popup = DOM.Div('treb-slider-container', container);
+        this.slider = DOM.Create('input', undefined, popup, {
+            attrs: {
+                type: 'range',
+                min: '50',
+                max: '200',
+                value: '100',
+                step: '2.5',
+            },
+            events: {
+                input: () => this.UpdateScale(Number(this.slider.value), true),
+            }
+        });
+        // we're overriding scroll behavior here, but it's a tiny panel.
+        // if we explicitly mark passive:false we can avoid the console
+        // warning (I think)
+        container.addEventListener('wheel', (event) => {
+            event.stopPropagation();
+            event.preventDefault();
+            this.Tick(event.deltaY);
+        }, { passive: false });
+    }
+    Tick(value) {
+        // normalize
+        const scale = Math.round(this.scale / 2.5) * 2.5;
+        if (value > 0) {
+            this.UpdateScale(scale - 2.5, true, true);
+        }
+        else if (value < 0) {
+            this.UpdateScale(scale + 2.5, true, true);
+        }
+    }
+    UpdateScale(scale, notify = false, keep_focus = false) {
+        scale = Math.max(50, Math.min(200, scale));
+        if (scale !== this.scale) {
+            this.scale = scale;
+            this.input.value = this.format.Format(scale) + '%';
+            this.slider.value = scale.toFixed(1);
+            if (notify) {
+                if (!this.timeout) {
+                    this.timeout = requestAnimationFrame(() => {
+                        this.timeout = 0;
+                        this.Publish({
+                            type: 'scale',
+                            value: this.scale / 100,
+                            keep_focus,
+                        });
+                    });
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=scale-control.js.map

package/build/treb-grid/src/types/scale-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale-control.js","sourceRoot":"","sources":["../../../../treb-grid/src/types/scale-control.ts"],"names":[],"mappings":"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"}

package/build/treb-grid/src/types/set_range_options.d.ts

@@ -0,0 +1,24 @@
+/**
+ * options for the SetRange method
+ */
+export interface SetRangeOptions {
+    /** transpose rectangular array before inserting */
+    transpose?: boolean;
+    /** recycle values (R-style) */
+    recycle?: boolean;
+    /** apply as an array (as if you pressed ctrl+shift+enter) */
+    array?: boolean;
+    /** spill over */
+    spill?: boolean;
+    /**
+     * argument separator to use when parsing the input formula. set this
+     * option to call SetRange with a consistent argument separator,
+     * independent of current locale.
+     */
+    argument_separator?: ',' | ';';
+    /**
+     * allow R1C1-style references; these can be either absolute
+     * addresses (e.g. R2C4) or relative to the cell (e.g. R[-3]C[0]).
+     */
+    r1c1?: boolean;
+}

package/build/treb-grid/src/types/set_range_options.js

@@ -0,0 +1,22 @@
+/*
+ * This file is part of TREB.
+ *
+ * TREB is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any
+ * later version.
+ *
+ * TREB is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with TREB. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * Copyright 2022-2026 trebco, llc.
+ * info@treb.app
+ *
+ */
+export {};
+//# sourceMappingURL=set_range_options.js.map

package/build/treb-grid/src/types/set_range_options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set_range_options.js","sourceRoot":"","sources":["../../../../treb-grid/src/types/set_range_options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/build/treb-grid/src/types/tab_bar.d.ts

@@ -0,0 +1,84 @@
+import type { DataModel, ViewModel, Sheet } from 'treb-data-model';
+import { EventSource } from 'treb-utils';
+import type { BaseLayout } from '../layout/base_layout';
+import type { GridOptions } from './grid_options';
+import { type ScaleEvent } from './scale-control';
+import { type Theme } from 'treb-base-types';
+export interface ActivateSheetEvent {
+    type: 'activate-sheet';
+    sheet: Sheet;
+}
+export interface RenameSheetEvent {
+    type: 'rename-sheet';
+    sheet: Sheet;
+    name: string;
+}
+export interface ReorderSheetEvent {
+    type: 'reorder-sheet';
+    index: number;
+    move_before: number;
+}
+export interface AddSheetEvent {
+    type: 'add-sheet';
+}
+export interface DeleteSheetEvent {
+    type: 'delete-sheet';
+}
+export interface CancelEvent {
+    type: 'cancel';
+}
+export type TabEvent = CancelEvent | ScaleEvent | AddSheetEvent | RenameSheetEvent | DeleteSheetEvent | ReorderSheetEvent | ActivateSheetEvent;
+export interface StatsEntry {
+    label: string;
+    value: string;
+}
+/**
+ * tabs for multiple sheets. at the bottom, atm (FIXME: options?)
+ *
+ * rename tabs (sheets) by double-clicking. this triggers a global
+ * rename over all cells and annotations.
+ *
+ * reorder tabs by dragging. reorders the array, but order is not
+ * material to any other module, so it's basically just housekeeping.
+ *
+ * add a new tab with a special (+) tab (last).
+ *
+ * FIXME: delete tabs... add an (x) to each tab? don't really want to
+ * do that. right-click is out. ??? [A: toolbar menu]
+ *
+ */
+export declare class TabBar extends EventSource<TabEvent> {
+    private layout;
+    private model;
+    private view;
+    private options;
+    private theme;
+    private tab_container?;
+    private scale_control?;
+    private stats_panel?;
+    private dragging;
+    private double_click_data;
+    private tab_color_cache;
+    private _visible;
+    get visible(): boolean;
+    set stats_data(value: StatsEntry[]);
+    private container;
+    private DOM;
+    constructor(layout: BaseLayout, model: DataModel, view: ViewModel, options: GridOptions, theme: Theme, view_node: HTMLElement);
+    IsDoubleClick(index: number, timeout?: number): boolean;
+    Hide(): void;
+    Show(show?: boolean): void;
+    SetActive(tab: HTMLElement, active: boolean, user?: boolean): void;
+    /** change scale if we have a scale label */
+    UpdateScale(scale: number): void;
+    DoubleClickTab(event: MouseEvent, tab: HTMLElement, sheet: Sheet): void;
+    MouseDownTab(event: MouseEvent, tab: HTMLElement, sheet: Sheet, index: number, tabs: HTMLElement[]): void;
+    UpdateTheme(): void;
+    /**
+     * update tabs from model.
+     *
+     * @param user - this is a user action, so use smooth scrolling
+     * when activating the tab. otherwise it's automatic so jump.
+     */
+    Update(user?: boolean): void;
+}