@xlcalc/vue 0.0.0-stage → 0.21.2

package/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+## 0.21.2 (2026-10-20)
+
+The first public release. Earlier versions were internal builds and were not published to npm; their changes are folded into this entry, and the README and `docs/` describe the package as it is now. The internal builds were named `xlcalc-sheet`: a host built on them imports `@xlcalc/vue`, `@xlcalc/vue/local` and `@xlcalc/vue/style.css` instead (breaking for that host).
+
+Contents:
+
+- `SheetView`: a virtualized grid over a `SheetSource`, with the workbook's styles, number formats, conditional formats, merged ranges, tables, hyperlinks and notes. It has:
+  - editing with Excel's keys;
+  - the formula bar as in Excel: always an input (a click places the caret at the click, a drag selects; on read-only sheets the text can be copied), a single line expanded by its arrow or Ctrl+Shift+U, references colored like their range borders on the grid, and Ctrl+click (Cmd+click) on a reference going to its range (with the key held, the reference under the pointer is underlined and the pointer becomes a hand; on a touch screen a long press on it goes to it), with Excel's Cancel and Enter buttons next to it and Insert Function (fx: search, Excel's categories, the ten most recently used, each function's syntax and description);
+  - Point mode with the mouse and the keys as measured in Excel (xlcalc's `refAt`: an arrow inserts a reference, enters the formula or does nothing; Cmd+arrow or Ctrl+arrow, Home and Page Down move the reference as on the sheet);
+  - Formula AutoComplete and Excel's argument tooltip (the current argument in bold, from the source's `functionSignature`, for the call found by xlcalc's `callAt`);
+  - fill and paste, Ctrl+Enter, undo and redo, and Excel's "We found a typo in your formula" dialog offering the source's correction of an unclosed formula;
+  - selection, Ctrl+arrow as Excel's Range.End, frozen panes, the fill handle continuing series as Excel's AutoFill does (`fillRange`: 1, 2 → 3, 4, dates, Item1 → Item2; Ctrl or Option held on release for a series from a single number), and cut, copy and paste with Excel's clipboard text;
+  - Find and Replace, data validation with Excel's dropdown, input message and alerts, the outline, the display filter and sort, the Trace Precedents panel, and context menus for cells, rows, columns and sheet tabs;
+  - column widths and row heights by mouse (cells whose display changes with a new width are redrawn from `layout`'s changes), with AutoFit on a double click.
+- List mode: the host's list on the sheet, with column titles the host sorts by (`sort`), drill-down cells (`cellDrill`), rows opened from the first column (`openRows`, `rowOpen`) and a totals row pinned to the bottom.
+- `SheetToolbar` and `FormatDialog`: Excel's formatting toolbar, with Merge & Center and its dropdown (Merge Across, Merge Cells, Unmerge Cells) and Excel's warning before values are lost, and Excel's Format Cells dialog.
+- `SheetView`'s `hostLinks` and `SheetToolbar`'s `hostDialog`: a host whose listener the component cannot see, such as a custom element's, still opens links (`openLink`) and its own Format Cells dialog (`formatCells`).
+- The dialogs share one modal container: Esc and a click outside close Format Cells, Insert Function and the context menu's dialogs, and Tab stays inside every dialog. The primary buttons (Apply, OK) use the accent color and darken on hover. Inputs on touch screens have 16 px text, so iOS does not zoom into them.
+- CSS variables `--xs-on-accent`, `--xs-shadow-pop`, `--xs-shadow-menu`, `--xs-shadow-modal`, `--xs-backdrop`, `--xs-z-menu`, `--xs-z-modal` and `--xs-z-alert`; `--xs-outline-bg` and `--xs-outline-button-bg` default to `--xs-bar-bg` and `--xs-bg`, and `--xs-font-size` applies to the formula bar, the menus and the filter funnel's list. Breaking for a host built on the internal builds: `SheetMessages.validationRetry` is removed (the alert's Retry uses `retry`), `--xs-fl-on-fg` is removed (use `--xs-on-accent`), and the classes `.xs-fmt-main`, `.xs-va-main`, `.xs-tb-swatch`, `.xs-fmt-swatch`, `.xs-dialog-back`, `.xs-ifn-back` and `.xs-va-back` are replaced by `.xs-button-main`, `.xs-swatch` and `.xs-modal-back`.
+- The `SheetSource` contract (`src/contract/source.ts`): every feature beyond reading sheets and windows is an optional method, so a server-side source and an in-page source each provide what they support. An `invalid` outcome may carry `correction`, the formula Excel suggests for a typo. `functionSignature(name)` returns a function's arguments for Excel's argument tooltip while a formula is typed, and its description for Insert Function (`SheetFunctionSignature`). Fields the sheet never read were removed before the release (breaking for a host built on the internal builds): `visibleRows` returns `{ rows }`, a rejection carries no `cells` and no `busy` reason, Find's hits are `{ row, col }`, and `SheetWindow.bars` and `MemoryCell.bar` are replaced by `appearance`.
+- `memorySource`: a source over an in-memory workbook, for examples and tests. Its display filter follows `./local`'s rules, its Find and Replace match as xlcalc's do (`findMatcher`, `findReplacer`), its outline groups come from xlcalc's `outlineGroups` and its outline commands from xlcalc's `outlineEdit`, with the same commands and rejections as `./local`, and its widths, heights and outline levels also accept an entire column or row as `C:C` or `5:5`.
+- `@xlcalc/vue/local`: `localSource`, a source over an xlcalc workbook calculated in a Web Worker or on the page's main thread, which performs the grid's operations as Excel does, plus `openXlsx` and `saveXlsx`. The display filter, its sort and the filter funnel read only the columns they need from the session, once; selection totals come from the session's `summarizeRanges` without transferring the cells, and under a display filter cover only its rows; a request's signal stops the session's reads; the sort and the funnel order mixed values as Excel's SORT does, with text in the workbook's locale (xlcalc's `valueComparator`; the ru-RU order is the en-US one, as Excel for Windows sorts); a style set by `format` repaints its ranges instead of reloading the sheet. It requires `xlcalc` 0.46.0 or later, an optional peer dependency.
+- The public types in `src/contract/` by area (`source`, `view`, `memory`, `messages`), behind `src/contract.ts`; `MemoryOutline`, the type of `MemorySheet.outline`, is exported.
+- `docs/`: a quick start with the common uses, each a component that works as written (`docs/quick-start.md`), the API reference (`docs/api.md`) and a page for each feature.
+- Interface texts in English by default and in Russian (`ruMessages`). The English texts use Excel's command names (Font Color, All Borders, Wrap Text) and the term workbook. Breaking for a host built on the internal builds that overrides them: the `SheetMessages` keys `fontColour`, `fillColour`, `pickColour`, `colourAuto`, `fmtColour`, `fmtColourCode` and `fmtColourBad` are renamed to `fontColor`, `fillColor`, `pickColor`, `colorAuto`, `fmtColor`, `fmtColorCode` and `fmtColorBad`.
+- `example/spa.html`: an Excel-like app over `./local` that runs entirely in the browser, without a server.
+- Without the window's `editText`, a cell opens for editing with xlcalc's `entryText` (`xlcalc/entry`) in the workbook's locale according to its code in `numberFormats`, as Excel's formula bar displays it; the module is a separate chunk, loaded when the first cell needs it, and until then the editor opens with the displayed text. `MemoryCell.numberFormat` sets the format codes of `memorySource`'s cells. Breaking for a host without `editText`: a number opens as General without `numberFormats`, and the apostrophe depends only on the workbook's locale.
+- The Column Width box counts characters as Excel for Mac's does (`columnWidthToChars`, `columnWidthFromChars` of `xlcalc/text`): the default column is 8, and entering 8 restores it. A row height goes up to 409.5 points, both by dragging the row's edge and in the Row Height box.
+- Formula AutoComplete finds the typed name with `nameAt` of `xlcalc/text`, after the workbook's list separator only (`,` in en-US, `;` in ru-RU).
+- The grid renders by rows: a typed character, a move of the active cell or of the selection, a scroll and a cell change redraw only the rows they affect (5 to 9 ms in Chromium on a desktop, down from 15 to 25); repaints from one task go to the source as a single request, and a burst of source events requests the active cell's validation once.
+- Ctrl+A, Ctrl+F and Ctrl+H work by the key's position on any keyboard layout, as the other shortcuts do; AltGr (Ctrl+Alt) types its character instead, so Ctrl+Alt+A no longer selects all.
+- A horizontal scroll creates and patches only the columns it brings into view, and a cell is clipped once, at its content box: scrolling by two columns takes 17 ms in Chromium (down from 22), by four rows 8 ms (down from 11), and a typed character 4.8 ms (down from 5.5).
+- A format change that the source repaints is not read a second time; after a structure change, the requested sheet is found by name case-insensitively, as Excel compares sheet names; a double click on the fill handle stops when another sheet is displayed instead of filling it.
+- Built against xlcalc 0.54.2, whose English messages are rewritten in plain English (xlcalc 0.53.0). The outline commands of `memorySource` reject with the new texts, since the main entry point bundles `xlcalc/a1`: an Ungroup of rows in no group says `the rows 3:6 are not in a group`, a group's button says `the detail of row 8 is already shown`. `@xlcalc/vue/local` returns the texts of the `xlcalc` the host installs, the new ones from 0.53.0. A host that matches these texts rather than their meaning needs the new ones.
+- The context menu's dialogs are labeled by their titles for screen readers. Nothing of a sheet outlives it: a search waiting for its pause, the filter's row list, an explain response, a long press, and the reads of the fill handle and the merge warning stop when the sheet is unmounted.
+- The type declarations name each imported file with `.js` and import no stylesheet, so both entry points' types resolve with `moduleResolution` `bundler`, `node16` and `nodenext`, with `skipLibCheck` off.
+- A new `source`, or the sheet's unmount, ends the previous workbook: its sheets, edit outcomes, corrections and rejections answered later are ignored, its alert closes, and its pending cells are no longer marked, so nothing of it is written or displayed in the new workbook. Of two reloads of one workbook answered in reverse order, the newer list of sheets stays.
+- A refusal may carry `code`, the source's code for its reason: `memorySource` and `./local` give xlcalc's codes of the outline commands (`outline_deep`, `not_grouped`, `detail`), and `./local` those of the structure operations, so a host can react to a refusal without matching its text.
+- At runtime the main entry point depends only on `vue` and does not include the engine. Its test keeps it under 400,000 characters (389,000 now); the engine would add hundreds of thousands.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mikhail Kostryukov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,76 @@
-# Temporary Holding Version
+# @xlcalc/vue
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A Vue 3 spreadsheet component for [xlcalc](https://github.com/drakosha/xlcalc) workbooks: Excel in the browser, with the workbook's styles, formulas, editing, context menus, Find and Replace, data validation and outline. Wherever the component could behave differently from Excel, it follows Excel's behavior as measured by xlcalc.
+
+The component accesses its data only through a `SheetSource`. Two sources are included: `memorySource`, an in-memory workbook for examples and tests, and `localSource` from `@xlcalc/vue/local`, which calculates an xlcalc workbook in a Web Worker and reads and writes xlsx files. A server-side source implements the same interface. MIT license.
+
+## Install
+
+```sh
+npm install @xlcalc/vue vue
+npm install xlcalc        # for @xlcalc/vue/local, 0.46.0 or later
+```
+
+At runtime the main entry point depends only on `vue` and does not include the calculation engine. Its types use `xlcalc/contract`, so a TypeScript project that uses only the main entry point installs `xlcalc` as a dev dependency: `npm install -D xlcalc`.
+
+## Quick start
+
+```vue
+<script setup lang="ts">
+import { SheetView, memorySource } from '@xlcalc/vue'
+import '@xlcalc/vue/style.css'
+
+const source = memorySource({ sheets: [{ name: 'Sheet1', cells: { A1: 'Hello', B1: 42 } }] })
+</script>
+
+<template>
+  <SheetView :source="source" style="height: 480px" />
+</template>
+```
+
+A workbook from an xlsx file, calculated in the browser:
+
+```ts
+import { localSource, openXlsx, saveXlsx } from '@xlcalc/vue/local'
+
+const { book, cached } = await openXlsx(file, { locale: 'ru-RU' }) // a File from a file input or a drop
+const source = localSource(book, { session: { cached } })           // <SheetView :source="source" :locale="source.locale" />
+const { data } = await saveXlsx(source)                             // the xlsx bytes: formulas along with their values
+```
+
+Excel's formatting toolbar (`SheetToolbar`) and Format Cells dialog (`FormatDialog`) work with the same source; see [toolbar.md](docs/toolbar.md).
+
+Apart from the two required methods that read sheets and cells, every feature is an optional method of the source: without `edit` the sheet is read-only, without `find` there is no search, and so on. The interface is in English by default and in Russian with `ruMessages`. Colors and sizes are set by `--xs-*` CSS variables.
+
+More of these, from a table the page already has to a workbook on your server, are in the [quick start](docs/quick-start.md).
+
+## Documentation
+
+- [Quick start](docs/quick-start.md): common uses, each with a component that works as written.
+- [API reference](docs/api.md): components, the sheet's methods, the `SheetSource` contract, `memorySource`, `@xlcalc/vue/local`, CSS variables.
+- [Cell editing and keyboard shortcuts](docs/editing.md): Excel's keyboard shortcuts, Point mode, and the features each optional source method enables.
+- [Rows, columns and sheets](docs/sheets.md): row, column and sheet tab context menus, sizes, outline.
+- [Clipboard and fill handle](docs/clipboard.md)
+- [Freeze Panes, Reapply and Trace Precedents](docs/view.md)
+- [Find and Replace](docs/find-replace.md)
+- [Data validation](docs/validation.md)
+- [Formula AutoComplete](docs/autocomplete.md)
+- [The formatting toolbar and Format Cells](docs/toolbar.md)
+- [In-browser calculation](docs/local.md): how `@xlcalc/vue/local` works, xlsx files.
+- [List mode](docs/list-mode.md): the host's list (a view or a report) displayed on the sheet, sorted by the host, with drill-down and a totals row.
+- [Example app](docs/example-app.md) and [browser tests](docs/checks.md)
+
+## Development
+
+```sh
+npm install
+npm test               # unit tests
+npm run typecheck
+npm run build          # dist/
+npm run check:package  # publint and attw over the packed package
+npm run dev:example    # the example app at http://localhost:5181/spa.html
+```
+
+## License
+
+MIT

package/dist/abort.d.ts

@@ -0,0 +1,6 @@
+/** The error of a request stopped by its signal: a DOMException named AbortError. */
+export declare const abortError: () => DOMException;
+/** Whether an error is that of a stopped request, which the sheet discards without a message. */
+export declare const isAbort: (e: unknown) => boolean;
+/** Throws the abort error once the signal is aborted. */
+export declare function throwIfAborted(signal?: AbortSignal): void;

package/dist/components/CellDraft.vue.d.ts

@@ -0,0 +1,7 @@
+/** `fill`: the cell's width when its alignment repeats the text across it (Excel's Fill). */
+type __VLS_Props = {
+    fill?: number;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/CellEditor.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/ColourSwatches.vue.d.ts

@@ -0,0 +1,13 @@
+type __VLS_Props = {
+    /** The color shown pressed, `#RRGGBB`; null for none. */
+    modelValue: string | null;
+    /** A label for the group; none where the surrounding menu labels it. */
+    label?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (colour: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((colour: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/DialogShell.vue.d.ts

@@ -0,0 +1,37 @@
+type __VLS_Props = {
+    /** The box's element: a form where Enter submits. */
+    as?: 'div' | 'form';
+    role?: 'dialog' | 'alertdialog';
+    /** A click on the backdrop closes the box; Excel's alerts stay open. */
+    outside?: boolean;
+    /** Full screen on a phone (the sheet's .xs-narrow), as Excel's larger dialogs are. */
+    full?: boolean;
+    /** An extra class for the backdrop: the Format Cells dialog's carries the sheet's variables outside a sheet. */
+    backClass?: string;
+    /** Where focus goes on opening: a selector inside the box (an input gets its text selected); the box itself without one. */
+    focus?: string;
+};
+declare var __VLS_9: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_9) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+}>, {
+    outside: boolean;
+    focus: string;
+    role: "dialog" | "alertdialog";
+    as: "div" | "form";
+    full: boolean;
+    backClass: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/ExplainPanel.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FilterPopover.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FindBar.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FormatBorders.vue.d.ts

@@ -0,0 +1,14 @@
+import { type FormatDraft, type FormatStart } from '../format-cells.js';
+import type { SheetMessages } from '../contract/messages.js';
+type __VLS_Props = {
+    start: FormatStart;
+    draft: FormatDraft;
+    messages: SheetMessages;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    invalid: (bad: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onInvalid?: ((bad: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FormatColour.vue.d.ts

@@ -0,0 +1,19 @@
+import type { SheetMessages } from '../contract/messages.js';
+type __VLS_Props = {
+    /** `#RRGGBB`, or null for the no-color choice. */
+    modelValue: string | null;
+    /** The no-color choice: Automatic for text and lines, No Color for a fill. */
+    noneLabel: string;
+    messages: SheetMessages;
+    /** Names the picker's buttons for tests and checks (`data-fmt-colour-of`). */
+    name: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    invalid: (bad: boolean) => any;
+    "update:modelValue": (colour: string | null) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onInvalid?: ((bad: boolean) => any) | undefined;
+    "onUpdate:modelValue"?: ((colour: string | null) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FormatDialog.vue.d.ts

@@ -0,0 +1,24 @@
+import type { SheetFormatPatch, SheetViewState } from '../contract/view.js';
+import type { SheetMessages } from '../contract/messages.js';
+type __VLS_Props = {
+    /** Shown while true; each time it opens, it starts from the active cell's formatting. */
+    open: boolean;
+    /** The payload of the sheet's `state` event: the selection and the active cell's formatting; with null nothing is shown. */
+    state: SheetViewState | null;
+    /** Interface texts; a partial set overrides the English defaults. */
+    messages?: Partial<SheetMessages>;
+    /** The workbook's locale (as for `SheetView`), in which the Number tab names its categories and items; en-US without one. */
+    locale?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+    apply: (patches: SheetFormatPatch[]) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onApply?: ((patches: SheetFormatPatch[]) => any) | undefined;
+}>, {
+    locale: string;
+    messages: Partial<SheetMessages>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FormulaBar.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FunctionList.vue.d.ts

@@ -0,0 +1,28 @@
+import type { SheetMessages } from '../contract/messages.js';
+import { type PopupRect } from './popup.js';
+type __VLS_Props = {
+    /** The editor, in the coordinates of the element the list is placed in. */
+    rect: PopupRect;
+    items: readonly string[];
+    /** The highlighted item. */
+    active?: number;
+    /** The part in view, in the same coordinates: the list goes above the editor where it has no room below and stays inside horizontally. */
+    view?: PopupRect;
+    /** Touch input: 44 px items, and a tap inserts one. */
+    touch?: boolean;
+    messages?: Partial<SheetMessages>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    pick: (index: number) => any;
+    highlight: (index: number) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onPick?: ((index: number) => any) | undefined;
+    onHighlight?: ((index: number) => any) | undefined;
+}>, {
+    view: PopupRect;
+    touch: boolean;
+    messages: Partial<SheetMessages>;
+    active: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FunctionTip.vue.d.ts

@@ -0,0 +1,14 @@
+import type { TipPart } from '../core/function-tip.js';
+import { type PopupRect } from './popup.js';
+type __VLS_Props = {
+    /** The editor, in the coordinates of the element the tooltip is placed in. */
+    rect: PopupRect;
+    parts: readonly TipPart[];
+    /** The part in view, in the same coordinates: the tooltip stays inside it. */
+    view?: PopupRect;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    view: PopupRect;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/InsertFunction.vue.d.ts

@@ -0,0 +1,9 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+    pick: (name: string) => any;
+}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onPick?: ((name: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/OutlineCell.vue.d.ts

@@ -0,0 +1,8 @@
+import type { OutlineAxis } from '../core/outline.js';
+type __VLS_Props = {
+    axis: OutlineAxis;
+    line: number;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/OutlineLevels.vue.d.ts

@@ -0,0 +1,7 @@
+import type { OutlineAxis } from '../core/outline.js';
+type __VLS_Props = {
+    axis: OutlineAxis;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/SheetGrid.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/SheetMarks.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/SheetMenu.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/SheetRow.vue.d.ts

@@ -0,0 +1,18 @@
+type __VLS_Props = {
+    /** The display row and the sheet row. */
+    d: number;
+    r: number;
+    frozen: boolean;
+    /** Drawn columns, a spacer's with c = 0. */
+    cols: readonly {
+        key: string;
+        c: number;
+    }[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    pick: (row: number, extend: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onPick?: ((row: number, extend: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/SheetTabs.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/SheetToolbar.vue.d.ts

@@ -0,0 +1,43 @@
+import type { SheetViewApi, SheetViewState, ToolbarSource } from '../contract/view.js';
+import type { SheetMessages } from '../contract/messages.js';
+type __VLS_Props = {
+    source: ToolbarSource;
+    /** The payload of the sheet's `state` event: the selection and the active cell's formatting; with null the buttons are disabled. */
+    state: SheetViewState | null;
+    /** Interface texts; a partial set overrides the English defaults. */
+    messages?: Partial<SheetMessages>;
+    /** The workbook's locale (as for `SheetView`), in which the Number Format box names its categories and items; en-US without one. */
+    locale?: string;
+    /**
+     * The sheet (a `SheetView`'s template ref) to format, undo and redo through, as its keyboard commands do: it applies the
+     * outcome, sets the selection and displays a rejection itself. Without it the toolbar calls the source and emits `select`
+     * and `error`.
+     */
+    sheet?: SheetViewApi | null;
+    /** The host opens its own dialog on `formatCells`: for a host whose listener the toolbar cannot see, such as a custom element's. */
+    hostDialog?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (place: {
+        sheet: string;
+        range: string;
+    }) => any;
+    formatCells: () => any;
+    error: (message: string) => any;
+    done: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((place: {
+        sheet: string;
+        range: string;
+    }) => any) | undefined;
+    onFormatCells?: (() => any) | undefined;
+    onError?: ((message: string) => any) | undefined;
+    onDone?: (() => any) | undefined;
+}>, {
+    sheet: SheetViewApi | null;
+    locale: string;
+    messages: Partial<SheetMessages>;
+    hostDialog: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/SheetView.vue.d.ts

@@ -0,0 +1,56 @@
+import type { ListSort, SheetFailure, SheetLinkEvent, SheetViewApi, SheetViewProps, SheetViewState } from '../contract/view.js';
+type __VLS_Slots = {
+    /** The workbook cannot be displayed: the source's error and a retry function. */
+    fallback?: (scope: {
+        failure: SheetFailure;
+        retry: () => void;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<SheetViewProps, SheetViewApi, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    sort: (sort: ListSort) => any;
+    state: (state: SheetViewState | null) => any;
+    openLink: (link: SheetLinkEvent) => any;
+    cellDrill: (cell: {
+        sheet: string;
+        cell: string;
+    }) => any;
+    rowOpen: (row: {
+        sheet: string;
+        row: number;
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<SheetViewProps> & Readonly<{
+    onSort?: ((sort: ListSort) => any) | undefined;
+    onState?: ((state: SheetViewState | null) => any) | undefined;
+    onOpenLink?: ((link: SheetLinkEvent) => any) | undefined;
+    onCellDrill?: ((cell: {
+        sheet: string;
+        cell: string;
+    }) => any) | undefined;
+    onRowOpen?: ((row: {
+        sheet: string;
+        row: number;
+    }) => any) | undefined;
+}>, {
+    sort: ListSort | null;
+    readOnly: boolean;
+    locale: string;
+    focus: {
+        ref: string;
+    } | null;
+    messages: Partial<import("../contract.js").SheetMessages>;
+    storageKey: string;
+    cellUrl: (ref: string) => string;
+    formulaBar: boolean;
+    hideLoneTab: boolean;
+    edgeRestoresWidth: boolean;
+    openRows: boolean;
+    hostLinks: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/ValidationAlert.vue.d.ts

@@ -0,0 +1,16 @@
+import { type AlertAnswer, type SheetAlert } from '../core/validation.js';
+import type { SheetMessages } from '../contract/messages.js';
+type __VLS_Props = {
+    /** The alert to show; null shows nothing. */
+    alert: SheetAlert | null;
+    messages?: Partial<SheetMessages>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    answer: (answer: AlertAnswer) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onAnswer?: ((answer: AlertAnswer) => any) | undefined;
+}>, {
+    messages: Partial<SheetMessages>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/ValidationDropdown.vue.d.ts

@@ -0,0 +1,33 @@
+import type { SheetMessages } from '../contract/messages.js';
+import { type PopupRect } from './popup.js';
+type __VLS_Props = {
+    /** The active cell (an entire merged range). */
+    rect: PopupRect;
+    items: string[];
+    open: boolean;
+    /** The highlighted item; -1 for none. */
+    active?: number;
+    /** The part of the grid in view, in the same coordinates: the list goes above the cell where it has no room below. */
+    view?: PopupRect;
+    /** Touch input: the arrow and the items are 44 px. */
+    touch?: boolean;
+    messages?: Partial<SheetMessages>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+    pick: (index: number) => any;
+    toggle: () => any;
+    hover: (index: number) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onPick?: ((index: number) => any) | undefined;
+    onToggle?: (() => any) | undefined;
+    onHover?: ((index: number) => any) | undefined;
+}>, {
+    view: PopupRect;
+    touch: boolean;
+    messages: Partial<SheetMessages>;
+    active: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/ValidationPrompt.vue.d.ts

@@ -0,0 +1,16 @@
+import { type PopupRect } from './popup.js';
+type __VLS_Props = {
+    /** The active cell (an entire merged range), in the coordinates of the element the component is placed in. */
+    rect: PopupRect;
+    prompt: {
+        title?: string;
+        text: string;
+    };
+    /** The part of the grid in view, in the same coordinates. */
+    view?: PopupRect;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    view: PopupRect;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/cf-icons.d.ts

@@ -0,0 +1,6 @@
+import { type FunctionalComponent } from 'vue';
+import type { Icon } from 'xlcalc/contract';
+/** A conditional format's icon; nothing for a number the set does not have. */
+export declare const CfIcon: FunctionalComponent<{
+    icon: Icon;
+}>;

package/dist/components/context.d.ts

@@ -0,0 +1,4 @@
+import { type InjectionKey } from 'vue';
+import type { SheetContext } from '../core/sheet.js';
+export declare const sheetContextKey: InjectionKey<SheetContext>;
+export declare function useSheetContext(): SheetContext;

package/dist/components/dom.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentInternalInstance, Ref } from 'vue';
+/** A function ref that keeps the element in `target`, null once it is removed. */
+export declare const refInto: <T extends Element>(target: Ref<T | null>) => (el: unknown) => void;
+/** The value of the input or list an `input` or `change` event came from. */
+export declare const fieldValue: (e: Event) => string;
+/** Whether the host currently listens to an event of the component (`handler` as on its vnode: `onOpenLink`). */
+export declare function hasListener(instance: ComponentInternalInstance | null, handler: string): boolean;