allyhub 0.7.0 → 0.8.0

package/dist/node_modules/@allyhub/sheet/dist/api/workbook.d.ts

@@ -0,0 +1,362 @@
+import { type SheetNote, type SheetPicture, type SheetPrint, type SheetConditional, type SheetFile, type SheetFilesColumn, type SheetTable, type SheetWorksheet } from "@allyhub/formats";
+import { Comment, HeaderFooter, PageMargins, PageSetup, SheetProtection, type Image } from "./page.js";
+import { Calc } from "../calc/engine.js";
+import { type ParsedCsv } from "../csv.js";
+import type { SheetProblem } from "../file.js";
+import { type GeneratedSheets } from "../generated.js";
+import { type StructureEdit } from "../formula/rewrite.js";
+import { type Scalar } from "../values.js";
+import { type CellLook, type Workbook as Model, type Worksheet as ModelSheet } from "../workbook.js";
+import { type ChartBase } from "./charts.js";
+import { AutoFilter, ConditionalFormattingList, DataValidationList, type DataValidation } from "./rules.js";
+import { Alignment, Border, Font, PatternFill } from "./styles.js";
+export type CellValue = number | string | boolean | Date | null;
+/** A typed cell in rows and columns of at least this many cells goes in a CSV file. */
+export declare const BLOCK_CELLS = 100;
+export declare class Cell {
+    readonly row: number;
+    readonly column: number;
+    _ws: Worksheet;
+    _value: Scalar;
+    _formula: string | undefined;
+    _look: CellLook;
+    _changed: boolean;
+    _styled: boolean;
+    /** It holds nothing in the file yet. */
+    _fresh: boolean;
+    constructor(ws: Worksheet, row: number, column: number);
+    get parent(): Worksheet;
+    get coordinate(): string;
+    get column_letter(): string;
+    get col_idx(): number;
+    /** What it holds: a formula is its text, as openpyxl's; with data_only, what it computes to. */
+    get value(): CellValue;
+    set value(next: CellValue);
+    private _shown;
+    /** What its formula computes to, added to openpyxl's: the workbook as it stands, saved or not. */
+    get computed(): CellValue;
+    get data_type(): string;
+    get is_date(): boolean;
+    /** What it opens: an address on the web, or `#Sheet!A1`. */
+    get hyperlink(): string | undefined;
+    set hyperlink(to: string | undefined);
+    /** Its note: Excel's Note, openpyxl's Comment. */
+    get comment(): Comment | undefined;
+    set comment(note: Comment | undefined);
+    get number_format(): string;
+    set number_format(code: string);
+    private _setLook;
+    get font(): Font;
+    set font(font: Font);
+    get fill(): PatternFill;
+    set fill(fill: PatternFill);
+    get border(): Border;
+    set border(border: Border);
+    get alignment(): Alignment;
+    set alignment(alignment: Alignment);
+    get has_style(): boolean;
+    offset(row?: number, column?: number): Cell;
+}
+export declare class ColumnDimension {
+    readonly index: string;
+    _width: number | undefined;
+    _hidden: boolean | undefined;
+    _files: SheetFilesColumn | undefined;
+    _level: number | undefined;
+    _ws: Worksheet;
+    constructor(ws: Worksheet, letter: string);
+    /** How deep it is grouped, Excel's outline, 1 to 7. */
+    get outlineLevel(): number | undefined;
+    set outlineLevel(level: number | undefined);
+    /** Its cells name files, not an openpyxl field: true, or how they join and how tall a picture is. */
+    get files(): SheetFilesColumn | undefined;
+    set files(files: SheetFilesColumn | undefined);
+    /** In Excel's units, as openpyxl's; the file holds pixels. */
+    get width(): number | undefined;
+    set width(units: number | undefined);
+    get hidden(): boolean;
+    set hidden(hidden: boolean);
+}
+export declare class RowDimension {
+    readonly index: number;
+    _height: number | undefined;
+    _hidden: boolean | undefined;
+    _level: number | undefined;
+    _ws: Worksheet;
+    constructor(ws: Worksheet, row: number);
+    /** How deep it is grouped, Excel's outline, 1 to 7. */
+    get outlineLevel(): number | undefined;
+    set outlineLevel(level: number | undefined);
+    /** In points, as openpyxl's; the file holds pixels. */
+    get height(): number | undefined;
+    set height(points: number | undefined);
+    get hidden(): boolean;
+    set hidden(hidden: boolean);
+}
+export interface TableOptions {
+    displayName: string;
+    ref: string;
+    /** Added to openpyxl's: the column that lines rows up when two hands' changes merge. */
+    key?: string;
+}
+export declare class Table {
+    displayName: string;
+    ref: string;
+    key: string | undefined;
+    /** Its entry in sheet.yaml, once it has one. */
+    _spec: SheetTable | undefined;
+    /** Its filter: its buttons are there unless a script turns them off in the files. */
+    readonly autoFilter: AutoFilter;
+    constructor(o: TableOptions);
+    get name(): string;
+}
+export declare class TableList {
+    _items: Map<string, Table>;
+    constructor();
+    add(table: Table): void;
+    get(name: string): Table | undefined;
+    keys(): string[];
+    values(): Table[];
+    items(): [string, Table][];
+    pop(name: string): Table | undefined;
+}
+export declare class DefinedName {
+    readonly name: string;
+    attr_text: string;
+    constructor(name: string, o: {
+        attr_text: string;
+    });
+    get value(): string;
+    set value(text: string);
+}
+export declare class DefinedNameDict {
+    _items: Map<string, DefinedName>;
+    constructor();
+    add(name: DefinedName): void;
+    get(name: string): DefinedName | undefined;
+    keys(): string[];
+    values(): DefinedName[];
+    items(): [string, DefinedName][];
+    pop(name: string): DefinedName | undefined;
+}
+interface HeldCsv {
+    parsed: ParsedCsv | undefined;
+    rows: string[][];
+}
+export type TableInput = (CellValue | undefined)[] | Record<string, CellValue>;
+export declare class Worksheet {
+    [place: `${string}${number}`]: Cell;
+    _parent: Workbook;
+    _title: string;
+    _was: string | undefined;
+    _model: ModelSheet | undefined;
+    _cells: Map<number, Cell>;
+    _columns: Map<string, ColumnDimension>;
+    _rows: Map<number, RowDimension>;
+    _tables: TableList;
+    _freeze: string | undefined;
+    _merges: string[];
+    _state: "visible" | "hidden";
+    _dimensions: boolean;
+    _lastRow: number;
+    _rules: SheetConditional[];
+    _validations: DataValidation[];
+    _filter: AutoFilter;
+    /** Its charts, openpyxl's private list. */
+    _charts: ChartBase[];
+    _print: SheetPrint;
+    _links: Record<string, string>;
+    _notes: Record<string, SheetNote>;
+    _pictures: SheetPicture[];
+    _protect: boolean;
+    constructor(parent: Workbook, title: string, model?: ModelSheet);
+    _spec(): SheetWorksheet | undefined;
+    /** What sheet.yaml says of its rules and filter. */
+    _heldRules(spec: SheetWorksheet | undefined): void;
+    private _at;
+    private _rowCells;
+    private _area;
+    get parent(): Workbook;
+    get title(): string;
+    set title(name: string);
+    get sheet_state(): "visible" | "hidden";
+    set sheet_state(state: "visible" | "hidden");
+    /** The cell at a row and a column, from 1, as openpyxl counts them. */
+    cell(row: number, column: number, value?: CellValue): Cell;
+    /** A row under the last one written. */
+    append(values: TableInput): void;
+    get max_row(): number;
+    get max_column(): number;
+    readonly min_row = 1;
+    readonly min_column = 1;
+    get dimensions(): string;
+    iter_rows(o?: {
+        min_row?: number;
+        max_row?: number;
+        min_col?: number;
+        max_col?: number;
+        values_only?: boolean;
+    }): (Cell | CellValue)[][];
+    iter_cols(o?: {
+        min_row?: number;
+        max_row?: number;
+        min_col?: number;
+        max_col?: number;
+        values_only?: boolean;
+    }): (Cell | CellValue)[][];
+    get rows(): Cell[][];
+    get columns(): Cell[][];
+    get values(): CellValue[][];
+    /** Rows put in before row `idx`, every formula that names what moved rewritten, as Excel does and openpyxl leaves to you. */
+    insert_rows(idx: number, amount?: number): void;
+    /** Rows taken out from `idx`: a reference to one is #REF!, and a range shrinks. */
+    delete_rows(idx: number, amount?: number): void;
+    /** Columns put in before column `idx`, from 1. */
+    insert_cols(idx: number, amount?: number): void;
+    /** Columns taken out from `idx`, from 1. */
+    delete_cols(idx: number, amount?: number): void;
+    merge_cells(range: string): void;
+    unmerge_cells(range: string): void;
+    /** Each merged range's text; openpyxl's is an object of them. */
+    get merged_cells(): string[];
+    get freeze_panes(): string | undefined;
+    set freeze_panes(place: string | Cell | undefined);
+    get column_dimensions(): Record<string, ColumnDimension>;
+    get row_dimensions(): Record<number, RowDimension>;
+    get tables(): TableList;
+    /** The sheet's conditional formats. */
+    get conditional_formatting(): ConditionalFormattingList;
+    get data_validations(): DataValidationList;
+    add_data_validation(data_validation: DataValidation): void;
+    /** The sheet's AutoFilter: set its ref to have one. A table has its own. */
+    get auto_filter(): AutoFilter;
+    _changed(): void;
+    /** `print`, `links`, `notes`, `pictures` and `protect` as sheet.yaml holds them. */
+    _heldPage(spec: SheetWorksheet | undefined): void;
+    get page_setup(): PageSetup;
+    get page_margins(): PageMargins;
+    get oddHeader(): HeaderFooter;
+    get oddFooter(): HeaderFooter;
+    get protection(): SheetProtection;
+    /** The range that prints. */
+    get print_area(): string | undefined;
+    set print_area(area: string | undefined);
+    /** Rows repeated on every page, as `1:2`. */
+    get print_title_rows(): string | undefined;
+    set print_title_rows(rows: string | undefined);
+    /** Columns repeated on every page, as `A:B`. */
+    get print_title_cols(): string | undefined;
+    set print_title_cols(columns: string | undefined);
+    /** A picture over the cells, at a cell: its anchor unless it says. */
+    add_image(image: Image, anchor?: string): void;
+    /** A chart at a cell: its anchor unless it says. */
+    add_chart(chart: ChartBase, anchor?: string): void;
+    add_table(table: Table): void;
+}
+export interface LoadOptions {
+    /** cell.value reads what a formula computes to, as openpyxl's. */
+    data_only?: boolean;
+}
+export declare class Workbook {
+    worksheets: Worksheet[];
+    readonly defined_names: DefinedNameDict;
+    readonly data_only: boolean;
+    /** The workbook's title, sheet.yaml's. */
+    title: string | undefined;
+    /** Where it was opened or last saved. */
+    path: string | undefined;
+    /** How many typed cells together go in a CSV file of their own. */
+    block_cells: number;
+    _file: SheetFile;
+    _text: string;
+    /** sheet.yaml and the CSV files as they are on disk: what a save compares with. */
+    _disk: {
+        text: string;
+        csv: Map<string, string>;
+    };
+    _csv: Map<string, HeldCsv>;
+    _model: Model | undefined;
+    _names: Map<string, Scalar>;
+    _active: number;
+    /** Something changed since the files were last made. */
+    _pending: boolean;
+    /** It is sheet.ts's: what it makes is never saved. */
+    _making: boolean;
+    private _calc;
+    constructor(o?: LoadOptions);
+    /** A workbook's folder, read. */
+    static open(dir: string, o?: LoadOptions): Workbook;
+    private _read;
+    private _keepCsv;
+    private _load;
+    get active(): Worksheet;
+    set active(ws: Worksheet);
+    get sheetnames(): string[];
+    get_sheet_by_name(name: string): Worksheet | undefined;
+    index(ws: Worksheet): number;
+    create_sheet(title?: string, index?: number): Worksheet;
+    remove(ws: Worksheet): void;
+    move_sheet(ws: Worksheet, offset?: number): void;
+    _tableNamed(name: string): Table | undefined;
+    /** A sheet renamed in every formula that names it. */
+    _renameSheet(ws: Worksheet, from: string, to: string): void;
+    /** Rows or columns put in or taken out, through every file of the workbook. */
+    _restructure(edit: StructureEdit): void;
+    /** Every formula of the files after an edit of the workbook. */
+    private _rewrite;
+    private _rewriteCsv;
+    private _sheetEntry;
+    private _dataPath;
+    /** A table added since the files were read: its cells become its CSV file. */
+    private _writeNewTable;
+    /** What a column's format says needs no entry of its own in `format`. */
+    private _columnsStyled;
+    /** The formula every row of a column has, moved; undefined when they differ. */
+    private _columnFormula;
+    private _columnFormat;
+    private _held;
+    private _setCsvCell;
+    /** The record of a table's row, its file's blank lines not being rows. */
+    private _recordOf;
+    /** Where a changed cell of an existing table goes. */
+    private _writeTableCell;
+    private _movedColumn;
+    /** Writes what changed into the file objects, and reads them again. */
+    _apply(): void;
+    private _applyNames;
+    private _applySheet;
+    private _applyFilter;
+    private _applyTableFilters;
+    private _applyDimensions;
+    private _applyCells;
+    private _styleByFormat;
+    /** The cell's look as far as the file does not give it already. */
+    private _ownLook;
+    private _writeLoose;
+    /** New cells: a run of one formula is one key, many typed cells a CSV file. */
+    private _consolidate;
+    private _build;
+    /** The files as they now stand become what the next change is made over. */
+    private _rebase;
+    /** The workbook as it stands, computed. */
+    _computed(): {
+        calc: Calc;
+        model: Model;
+    };
+    /** What allyhub check would say of it as it stands, added to openpyxl's. */
+    check(): SheetProblem[];
+    /** What sheet.ts made on it: each CSV file named where it stands for no file on disk. */
+    _generated(): GeneratedSheets;
+    /** Writes sheet.yaml and its CSV files: to the folder it came from, or one named. */
+    save(dir?: string): void;
+}
+/** A workbook's folder, read: openpyxl's load_workbook. */
+export declare function load_workbook(dir: string, o?: LoadOptions): Workbook;
+/** openpyxl's helpers for addresses. */
+export declare const get_column_letter: (column: number) => string;
+export declare function column_index_from_string(letters: string): number;
+export declare function coordinate_to_tuple(address: string): [number, number];
+/** (first column, first row, last column, last row), from 1. */
+export declare function range_boundaries(range: string): [number, number, number, number];
+export {};
+//# sourceMappingURL=workbook.d.ts.map

package/dist/node_modules/@allyhub/sheet/dist/api/workbook.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{SHEET_DATA as G,SHEET_FILE as P,strict as g}from"@allyhub/formats";import{Comment as z,HeaderFooter as A,PageMargins as V,PageSetup as Y,SheetProtection as q}from"./page.js";import{columnIndex as E,columnLetter as L,cellName as C,contains as N,rangeName as x,readAddress as y,readArea as k}from"../address.js";import{Calc as Q}from"../calc/engine.js";import{checkWorkbook as X}from"../check.js";import{readCsv as Z,writeCsv as ee}from"../csv.js";import{GENERATED as te}from"../generated.js";import{moveFormula as se,relativeKey as ne}from"../formula/move.js";import{parseFormula as F}from"../formula/parse.js";import{printFormula as B}from"../formula/print.js";import{rewriteFormula as oe}from"../formula/rewrite.js";import{isDateCode as S}from"../format.js";import{patchCsv as re}from"../patch.js";import{CellError as W,dateOfSerial as ie,isoOfSerial as le,readTyped as M,serialOfDate as ae,writeTyped as he}from"../values.js";import{FormulaCell as fe,readWorkbook as I,validName as H}from"../workbook.js";import{restructure as _e,tableShape as ce}from"../structure.js";import{patchYaml as ue}from"../write.js";import{anchorOf as de,chartOfSpec as me}from"./charts.js";import{HINT as w}from"./hint.js";import{rectangles as T}from"./rectangles.js";import{AutoFilter as K,ConditionalFormattingList as pe,DataValidationList as we,validationOf as ge,validationSpec as ke}from"./rules.js";import{alignmentLook as ye,alignmentOf as be,borderLook as ve,borderOf as xe,fillLook as Ee,fillOf as Se,fontLook as $e,fontOf as Ce}from"./styles.js";const J=()=>process.getBuiltinModule("node:fs"),$=(...l)=>process.getBuiltinModule("node:path").join(...l);export const BLOCK_CELLS=100;const Te=l=>Math.round(l*7+5),Oe=l=>(l-5)/7,Le=l=>l*4/3,Ne=l=>l*3/4;function Fe(l,e){const t={},s=l,n=e;for(const o of new Set([...Object.keys(s),...Object.keys(n)])){const r=n[o];JSON.stringify(r??!1)!==JSON.stringify(s[o]??!1)&&(t[o]=r??!1)}return t}const m=l=>Object.keys(l).length===0,b=(l,e)=>{if(!Number.isInteger(l)||l<1)throw new RangeError(`A ${e} is a whole number from 1: ${String(l)}.`);return l},j=(l,e)=>Object.fromEntries(Object.entries(l).filter(([t])=>t!==e));export class Cell{row;column;_ws;_value;_formula=void 0;_look;_changed=!1;_styled=!1;_fresh=!1;constructor(e,t,s){this._ws=e,this.row=t,this.column=s;const n=t-1,o=s-1,r=e._model?.at(n,o);return this._value=null,r instanceof fe?this._formula=r.text:r!==void 0&&(this._value=r),this._look=e._model?.lookAt(n,o)??{},this._fresh=r===void 0,g(this,"Cell",w)}get parent(){return this._ws}get coordinate(){return C({row:this.row-1,col:this.column-1})}get column_letter(){return L(this.column-1)}get col_idx(){return this.column}get value(){return this._ws.parent.data_only?this.computed:this._formula!==void 0?this._formula:this._shown(this._value)}set value(e){if(e===void 0)throw new TypeError(`${this.coordinate}: a value is not undefined.`);if(this._formula=void 0,this._changed=!0,this._ws.parent._pending=!0,e instanceof Date){if(Number.isNaN(e.getTime()))throw new TypeError(`${this.coordinate}: the date is not valid.`);this._value=ae(e),S(this._look.format)||(this._look={...this._look,format:Number.isInteger(this._value)?"yyyy-mm-dd":"yyyy-mm-dd hh:mm"});return}if(typeof e=="string"&&e.length>1&&e.startsWith("=")){this._formula=e,this._value=null;return}this._value=e}_shown(e){return typeof e=="number"&&S(this._look.format)?ie(e)??e:e instanceof W?e.code:e}get computed(){const{calc:e,model:t}=this._ws.parent._computed(),s=t.sheet(this._ws.title);return s?this._shown(e.value(s,this.row-1,this.column-1)):null}get data_type(){if(this._formula!==void 0)return"f";const e=this._value;return e===null?"n":typeof e=="number"?S(this._look.format)?"d":"n":typeof e=="boolean"?"b":e instanceof W?"e":"s"}get is_date(){return this.data_type==="d"}get hyperlink(){return this._ws._links[this.coordinate]}set hyperlink(e){e===void 0?Reflect.deleteProperty(this._ws._links,this.coordinate):this._ws._links[this.coordinate]=e,this._ws._changed()}get comment(){const e=this._ws._notes[this.coordinate];if(e!==void 0)return typeof e=="string"?new z(e):new z(e.text,e.author)}set comment(e){e===void 0?Reflect.deleteProperty(this._ws._notes,this.coordinate):this._ws._notes[this.coordinate]=e._file(),this._ws._changed()}get number_format(){return this._look.format??"General"}set number_format(e){this._setLook({format:e})}_setLook(e){this._look={...this._look,...e},this._styled=!0,this._ws.parent._pending=!0}get font(){return Ce(this._look)}set font(e){this._setLook($e(e))}get fill(){return Se(this._look)}set fill(e){this._setLook(Ee(e))}get border(){return xe(this._look)}set border(e){this._setLook(ve(e))}get alignment(){return be(this._look)}set alignment(e){this._setLook(ye(e))}get has_style(){return!m(this._look)}offset(e=0,t=0){return this._ws.cell(this.row+e,this.column+t)}}export class ColumnDimension{index;_width;_hidden;_files;_level;_ws;constructor(e,t){this._ws=e,this.index=t;const s=e._spec()?.columns?.[t];return this._level=s?.level,this._width=s?.width,this._hidden=s?.hidden,this._files=s?.files,g(this,"ColumnDimension",w)}get outlineLevel(){return this._level}set outlineLevel(e){this._level=e,this._ws._dimensions=!0}get files(){return this._files}set files(e){this._files=e,this._ws._dimensions=!0}get width(){return this._width===void 0?void 0:Oe(this._width)}set width(e){this._width=e===void 0?void 0:Te(e),this._ws._dimensions=!0}get hidden(){return this._hidden??!1}set hidden(e){this._hidden=e,this._ws._dimensions=!0}}export class RowDimension{index;_height;_hidden;_level;_ws;constructor(e,t){this._ws=e,this.index=t;const s=e._spec()?.rows?.[String(t)];return this._level=s?.level,this._height=s?.height,this._hidden=s?.hidden,g(this,"RowDimension",w)}get outlineLevel(){return this._level}set outlineLevel(e){this._level=e,this._ws._dimensions=!0}get height(){return this._height===void 0?void 0:Ne(this._height)}set height(e){this._height=e===void 0?void 0:Le(e),this._ws._dimensions=!0}get hidden(){return this._hidden??!1}set hidden(e){this._hidden=e,this._ws._dimensions=!0}}export class Table{displayName;ref;key;_spec;autoFilter;constructor(e){for(const t of Object.keys(e))if(!["displayName","ref","key"].includes(t))throw new TypeError(`Table takes displayName, ref and key; it has no ${t}. ${w}`);if(!H(e.displayName))throw new TypeError(`${e.displayName} cannot be a table's name.`);if(!k(e.ref))throw new TypeError(`${e.ref} is not a range.`);return this.displayName=e.displayName,this.ref=e.ref,this.key=e.key,this.autoFilter=new K(e.ref,()=>{}),g(this,"Table",w)}get name(){return this.displayName}}export class TableList{_items=new Map;constructor(){return g(this,"TableList",w,{key:e=>this._items.get(e)})}add(e){this._items.set(e.name,e)}get(e){return this._items.get(e)}keys(){return[...this._items.keys()]}values(){return[...this._items.values()]}items(){return[...this._items.entries()]}pop(e){const t=this._items.get(e);return this._items.delete(e),t}}export class DefinedName{name;attr_text;constructor(e,t){if(!H(e))throw new TypeError(`${e} cannot be a name.`);return this.name=e,this.attr_text=t.attr_text.replace(/^=/u,""),g(this,"DefinedName",w)}get value(){return this.attr_text}set value(e){this.attr_text=e.replace(/^=/u,"")}}export class DefinedNameDict{_items=new Map;constructor(){return g(this,"DefinedNameDict",w,{key:e=>this._items.get(e),setKey:(e,t)=>t instanceof DefinedName?(this._items.set(e,t),!0):!1})}add(e){this._items.set(e.name,e)}get(e){return this._items.get(e)}keys(){return[...this._items.keys()]}values(){return[...this._items.values()]}items(){return[...this._items.entries()]}pop(e){const t=this._items.get(e);return this._items.delete(e),t}}const v=l=>{if(l._formula!==void 0)return l._formula;const e=l._value;return typeof e=="number"&&S(l._look.format)?le(e):he(e)};function U(l){if(l._formula!==void 0)return l._formula;const e=l._value;return e===null?null:typeof e=="number"&&!S(l._look.format)||typeof e=="boolean"?e:v(l)}const Me=l=>l.toLowerCase().replace(/[^\p{L}\p{N}]+/gu,"-").replace(/^-+|-+$/gu,"")||"rows";export class Worksheet{_parent;_title;_was;_model;_cells=new Map;_columns=new Map;_rows=new Map;_tables=new TableList;_freeze;_merges=[];_state="visible";_dimensions=!1;_lastRow=0;_rules=[];_validations=[];_filter;_charts=[];_print={};_links={};_notes={};_pictures=[];_protect=!1;constructor(e,t,s){if(this._parent=e,this._title=t,this._filter=new K(void 0,()=>{this._parent._pending=!0}),s){this._model=s,this._was=t,this._freeze=s.spec.freeze,this._heldPage(s.spec),this._merges=[...s.spec.merges??[]],this._state=s.spec.hidden===!0?"hidden":"visible",this._lastRow=(s.used?.bottom??-1)+1,this._heldRules(s.spec);for(const n of s.tables){const o=new Table({displayName:n.name,ref:x(n.area),...n.spec.key===void 0?{}:{key:n.spec.key}});o._spec=n.spec;const{filter:r}=n.spec;if(r)for(const[a,f]of Object.entries(r.columns)){const c=n.column(a);c&&o.autoFilter._columns.set(c.index,f)}this._tables.add(o)}}return g(this,"Worksheet",w,{index:n=>this._rowCells(n),key:n=>this._at(n),setKey:(n,o)=>{const r=y(n);return r?(this.cell(r.row+1,r.col+1).value=o,!0):!1}})}_spec(){return this._parent._file.sheets.find(e=>e.name===(this._was??this._title))}_heldRules(e){this._rules=[...e?.conditional??[]],this._validations=(e?.validations??[]).map(ge),this._charts=(e?.charts??[]).map(me),this._filter.ref=e?.filter?.range,this._filter._columns.clear();const t=e?.filter?k(e.filter.range):void 0;for(const[s,n]of Object.entries(e?.filter?.columns??{})){const o=E(s);t&&o!==void 0&&this._filter._columns.set(o-t.left,n)}}_at(e){const t=y(e);if(t)return this.cell(t.row+1,t.col+1);const s=k(e);if(s)return this._area(s);const n=E(e);if(n!==void 0){const o=[];for(let r=1;r<=this.max_row;r++)o.push(this.cell(r,n+1));return o}}_rowCells(e){const t=[];for(let s=1;s<=this.max_column;s++)t.push(this.cell(e,s));return t}_area(e){const t=[];for(let s=e.top;s<=e.bottom;s++){const n=[];for(let o=e.left;o<=e.right;o++)n.push(this.cell(s+1,o+1));t.push(n)}return t}get parent(){return this._parent}get title(){return this._title}set title(e){const t=this._title;e!==t&&this._parent._renameSheet(this,t,e)}get sheet_state(){return this._state}set sheet_state(e){this._state=e}cell(e,t,s){if(e<1||t<1)throw new RangeError(`Row and column values must be at least 1: ${String(e)}, ${String(t)}.`);const n=(e-1)*16384+t-1;let o=this._cells.get(n);return o||(o=new Cell(this,e,t),this._cells.set(n,o)),s!==void 0&&(o.value=s),e>this._lastRow&&(this._lastRow=e),o}append(e){const t=this._lastRow+1,s=(n,o)=>{o!=null&&this.cell(t,n,o)};if(Array.isArray(e))e.forEach((n,o)=>{s(o+1,n)});else for(const[n,o]of Object.entries(e)){const r=/^\d+$/u.test(n)?Number(n)-1:E(n);if(r===void 0)throw new TypeError(`${n} is not a column.`);s(r+1,o)}this._lastRow=t}get max_row(){return Math.max(1,this._lastRow)}get max_column(){let e=this._model?.columnsUsed??0;for(const t of this._cells.values())(t._value!==null||t._formula!==void 0)&&t.column>e&&(e=t.column);return Math.max(1,e)}min_row=1;min_column=1;get dimensions(){return x({top:0,left:0,bottom:this.max_row-1,right:this.max_column-1})}iter_rows(e={}){const t=this._area({top:(e.min_row??1)-1,left:(e.min_col??1)-1,bottom:(e.max_row??this.max_row)-1,right:(e.max_col??this.max_column)-1});return e.values_only===!0?t.map(s=>s.map(n=>n.value)):t}iter_cols(e={}){const t=this.iter_rows(e);return(t[0]??[]).map((n,o)=>t.map(r=>r[o]))}get rows(){return this.iter_rows()}get columns(){return this.iter_cols()}get values(){return this.iter_rows({values_only:!0})}insert_rows(e,t=1){this._parent._restructure({op:"insert-rows",sheet:this._title,at:b(e,"row")-1,count:b(t,"amount")})}delete_rows(e,t=1){this._parent._restructure({op:"delete-rows",sheet:this._title,at:b(e,"row")-1,count:b(t,"amount")})}insert_cols(e,t=1){this._parent._restructure({op:"insert-columns",sheet:this._title,at:b(e,"column")-1,count:b(t,"amount")})}delete_cols(e,t=1){this._parent._restructure({op:"delete-columns",sheet:this._title,at:b(e,"column")-1,count:b(t,"amount")})}merge_cells(e){if(!k(e))throw new TypeError(`${e} is not a range.`);this._merges.includes(e)||this._merges.push(e),this._parent._pending=!0}unmerge_cells(e){this._merges=this._merges.filter(t=>t!==e),this._parent._pending=!0}get merged_cells(){return[...this._merges]}get freeze_panes(){return this._freeze}set freeze_panes(e){const t=e instanceof Cell?e.coordinate:e;if(t!==void 0&&!y(t))throw new TypeError(`${t} is not a cell.`);this._freeze=t,this._parent._pending=!0}get column_dimensions(){return new Proxy({},{get:(e,t)=>{if(typeof t!="string")return;const s=t.toUpperCase();if(E(s)===void 0)throw new TypeError(`${t} is not a column.`);let n=this._columns.get(s);return n||(n=new ColumnDimension(this,s),this._columns.set(s,n)),n}})}get row_dimensions(){return new Proxy({},{get:(e,t)=>{if(typeof t!="string"||!/^[1-9]\d*$/u.test(t))throw new TypeError(`${String(t)} is not a row.`);const s=Number(t);let n=this._rows.get(s);return n||(n=new RowDimension(this,s),this._rows.set(s,n)),n}})}get tables(){return this._tables}get conditional_formatting(){return new pe(this._rules,()=>{this._parent._pending=!0})}get data_validations(){return new we(this._validations,()=>{this._parent._pending=!0})}add_data_validation(e){this._validations.push(e),this._parent._pending=!0}get auto_filter(){return this._filter}_changed(){this._parent._pending=!0}_heldPage(e){this._print=structuredClone(e?.print??{}),this._links={...e?.links},this._notes={...e?.notes},this._pictures=[...e?.pictures??[]],this._protect=e?.protect===!0}get page_setup(){return new Y(this)}get page_margins(){return new V(this)}get oddHeader(){return new A(this,"header")}get oddFooter(){return new A(this,"footer")}get protection(){return new q(()=>this._protect,e=>{this._protect=e,this._changed()})}get print_area(){return this._print.area}set print_area(e){if(e===void 0)delete this._print.area;else if(k(e))this._print.area=e;else throw new TypeError(`${e} is not a range.`);this._changed()}get print_title_rows(){return this._print.title_rows}set print_title_rows(e){e===void 0?delete this._print.title_rows:this._print.title_rows=e,this._changed()}get print_title_cols(){return this._print.title_cols}set print_title_cols(e){e===void 0?delete this._print.title_cols:this._print.title_cols=e,this._changed()}add_image(e,t){const s=t??e.anchor??"A1";if(!y(s))throw new TypeError(`${s} is not a cell.`);this._pictures.push({file:e.path,at:s,...e.width===void 0?{}:{width:e.width},...e.height===void 0?{}:{height:e.height}}),this._changed()}add_chart(e,t){e.anchor=de(t)??e.anchor,this._charts.push(e),this._parent._pending=!0}add_table(e){if(this._parent._tableNamed(e.name))throw new Error(`There is already a table named ${e.name}.`);this._tables.add(e),this._parent._pending=!0}}export class Workbook{worksheets=[];defined_names=new DefinedNameDict;data_only;title;path;block_cells=BLOCK_CELLS;_file={sheets:[]};_text="";_disk={text:"",csv:new Map};_csv=new Map;_model;_names=new Map;_active=0;_pending=!1;_making=!1;_calc=void 0;constructor(e={}){this.data_only=e.data_only??!1;const t=g(this,"Workbook",w,{key:s=>this.worksheets.find(n=>n.title===s),index:s=>this.worksheets[s]});return t.worksheets=[new Worksheet(t,"Sheet")],t}static open(e,t={}){const s=new Workbook(t);return s.path=e,s._read(e),s}_read(e){const{readFileSync:t}=J(),s=t($(e,P),"utf8"),n=new Map,o=r=>{try{const a=t($(e,r),"utf8");return n.set(r,a),a}catch{return}};this._load(s,o);for(const[r,a]of n)this._keepCsv(r,a);this._disk={text:s,csv:n}}_keepCsv(e,t){const s=Z(t);this._csv.set(e,{parsed:s,rows:s.records.map(n=>n.end===n.start?[]:[...n.fields])})}_load(e,t){const{workbook:s,problems:n}=I({text:e,read:t});if(!s)throw new Error(`sheet.yaml cannot be opened: ${n.map(o=>o.message).join("; ")}`);this._text=e,this._file=structuredClone(s.file),this._model=s,this.title=s.title,this.worksheets=s.sheets.map(o=>new Worksheet(this,o.name,o));for(const o of s.names.values()){if(o.source.path?.[0]!=="names")continue;const r=o.formula?o.formula.text:o.value??null;this._names.set(o.name,r),this.defined_names.add(new DefinedName(o.name,{attr_text:String(r)}))}}get active(){const e=this.worksheets[this._active]??this.worksheets[0];if(!e)throw new Error("The workbook has no sheets.");return e}set active(e){this._active=this.worksheets.indexOf(e)}get sheetnames(){return this.worksheets.map(e=>e.title)}get_sheet_by_name(e){return this.worksheets.find(t=>t.title===e)}index(e){return this.worksheets.indexOf(e)}create_sheet(e,t){let s=e??"Sheet";for(let o=1;this.worksheets.some(r=>r.title===s);o++)s=`${e??"Sheet"}${String(o)}`;const n=new Worksheet(this,s);return this.worksheets.splice(t??this.worksheets.length,0,n),this._pending=!0,n}remove(e){this.worksheets=this.worksheets.filter(t=>t!==e),this._pending=!0}move_sheet(e,t=0){const s=this.worksheets.indexOf(e);this.worksheets.splice(s,1),this.worksheets.splice(s+t,0,e),this._pending=!0}_tableNamed(e){for(const t of this.worksheets){const s=t._tables.get(e);if(s)return s}}_renameSheet(e,t,s){if(this.worksheets.some(o=>o!==e&&o.title===s))throw new Error(`There is already a sheet named ${s}.`);this._apply(),this._rewrite({op:"rename-sheet",from:t,to:s}),e._title=s,e._was=s;const n=this._file.sheets.find(o=>o.name===t);n&&(n.name=s),this._apply()}_restructure(e){this._apply();const t=_e({file:this._file,rows:new Map([...this._csv].map(([n,o])=>[n,o.rows]))},e);if(t.refused!==void 0)throw new Error(t.refused==="table-header"?"A table's header row is not deleted: delete the table's rows, or all of it.":"That sheet is not there.");this._file=t.file;for(const[n,o]of t.rows){const r=this._csv.get(n);r&&(r.rows=o.map(a=>[...a]))}for(const n of this.worksheets){const o=this._file.sheets.find(r=>r.name===n._title);n._cells.clear(),n._columns.clear(),n._rows.clear(),n._merges=[...o?.merges??[]],n._freeze=o?.freeze,n._heldPage(o),n._heldRules(o)}const s=this._build();this._rebase(s.text,s.files);for(const n of this.worksheets){const o=this._model?.sheet(n._title);if(o){n._lastRow=(o.used?.bottom??-1)+1;for(const r of o.tables){const a=n._tables.get(r.name);a&&(a.ref=x(r.area))}}}}_rewrite(e){const t=(n,o)=>{const r=F(n);if(!r.ok)return n;const a=oe(r.node,e,o);return a===r.node?n:B(a)},{_file:s}=this;if(s.names){for(const[n,o]of Object.entries(s.names))if(typeof o=="string"&&o.startsWith("=")){const r=t(o,s.sheets[0]?.name??"");s.names[n]=r,this._names.set(n,r);const a=this.defined_names.get(n);a&&(a.attr_text=r.slice(1))}}for(const n of s.checks??[])n.formula=t(n.formula,s.sheets[0]?.name??"");for(const n of s.sheets){for(const[o,r]of Object.entries(n.cells??{}))typeof r=="string"&&r.startsWith("=")?n.cells[o]=t(r,n.name):r!==null&&typeof r=="object"&&r.formula!==void 0&&(r.formula=t(r.formula,n.name));for(const o of n.tables??[]){for(const r of Object.values(o.columns??{}))r.formula!==void 0&&(r.formula=t(r.formula,n.name));this._rewriteCsv(o.rows,n.name,t)}for(const o of n.blocks??[])this._rewriteCsv(o.rows,n.name,t)}}_rewriteCsv(e,t,s){const n=this._csv.get(e);n&&(n.rows=n.rows.map(o=>o.map(r=>M(r).formula!==void 0?s(r,t):r)))}_sheetEntry(e){const t=e._was??e._title;let s=this._file.sheets.find(n=>n.name===t);return s||(s={name:e._title},this._file.sheets.push(s)),s.name=e._title,s}_dataPath(e){const t=`${G}/${Me(e)}`;let s=`${t}.csv`;const n=o=>this._csv.has(o)||this._file.sheets.some(r=>r.tables?.some(a=>a.rows===o)??r.blocks?.some(a=>a.rows===o));for(let o=2;n(s);o++)s=`${t}-${String(o)}.csv`;return s}_writeNewTable(e,t,s){const n=k(s.ref);if(!n)throw new Error(`${s.ref} is not a range.`);const o=[];for(let i=n.left;i<=n.right;i++){const h=e.cell(n.top+1,i+1).value;if(h===null||h==="")throw new Error(`Table ${s.name}'s header has no name at ${C({row:n.top,col:i})}.`);o.push(String(h))}const r={},a=[];o.forEach((i,h)=>{const _=n.left+h,d=this._columnFormula(e,n,_);d===void 0?a.push(h):r[i]={formula:d};const p=this._columnFormat(e,n,_);p!==void 0&&(r[i]={...r[i],format:p})}),this._columnsStyled(e,n);const f=[a.map(i=>o[i]??"")];for(let i=n.top+1;i<=n.bottom;i++)f.push(a.map(h=>v(e.cell(i+1,n.left+h+1))));t.cells&&(t.cells=Object.fromEntries(Object.entries(t.cells).filter(([i])=>{const h=y(i);return!h||!N(n,h.row,h.col)})));const c=this._dataPath(s.name);this._csv.set(c,{parsed:void 0,rows:f});const u={name:s.name,at:C({row:n.top,col:n.left}),rows:c,...s.key===void 0?{}:{key:s.key},...m(r)?{}:{columns:r}};(t.tables??=[]).push(u),s._spec=u}_columnsStyled(e,t){for(let s=t.left;s<=t.right;s++)for(let n=t.top+1;n<=t.bottom;n++){const o=e.cell(n+1,s+1),{format:r,...a}=this._ownLook(o);r!==void 0&&m(a)&&(o._styled=!1)}}_columnFormula(e,t,s){if(t.bottom<=t.top)return;const n=e.cell(t.top+2,s+1),o=R(n);if(o!==void 0){for(let r=t.top+2;r<=t.bottom;r++)if(R(e.cell(r+1,s+1))!==o)return;return n._formula}}_columnFormat(e,t,s){if(t.bottom<=t.top)return;const n=r=>this._ownLook(e.cell(r+1,s+1)).format,o=n(t.top+1);for(let r=t.top+2;r<=t.bottom;r++)if(n(r)!==o)return;return o}_held(e){const t=this._csv.get(e);if(!t)throw new Error(`${e} was not read.`);return t}_setCsvCell(e,t,s,n){const{rows:o}=this._held(e);for(;o.length<=t;)o.push([]);const r=o[t];if(r){for(;r.length<=s;)r.push("");r[s]=n}}_recordOf(e,t){let s=0;for(let n=0;n<t;){if(s+=1,s>=e.length)return s+t-n-1;e[s]?.length!==0&&(n+=1)}return s}_writeTableCell(e,t,s){const n=this._held(e.rows),o=n.rows[0]??[],r=s.column-1-t.left,a=this._recordOf(n.rows,s.row-1-t.top),f=Object.keys(e.columns??{}).filter(_=>!o.some(d=>d.trim().toLowerCase()===_.toLowerCase())),u=[...o.map(_=>_.trim()),...f][r];if(u===void 0)return;if(a===0){r<o.length&&(o[r]=v(s));return}const i=e.columns?.[u]?.formula;if(i!==void 0){const _=this._movedColumn(i,t,s);if(s._formula===_){const d=o.findIndex(p=>p.trim()===u);d>=0&&this._setCsvCell(e.rows,a,d,"");return}}let h=o.findIndex(_=>_.trim()===u);h<0&&(h=o.length,this._setCsvCell(e.rows,0,h,u)),this._setCsvCell(e.rows,a,h,v(s))}_movedColumn(e,t,s){const n=F(e);if(!n.ok)return e;const o=s.row-1-(t.top+1);return o===0?e:B(se(n.node,o,0))}_apply(){this.title===void 0?delete this._file.title:this._file.title=this.title;const e=new Set(this.worksheets.map(s=>s._was??s._title));this._file.sheets=this._file.sheets.filter(s=>e.has(s.name));for(const s of this.worksheets)this._applySheet(s);this._file.sheets=this.worksheets.map(s=>this._sheetEntry(s)),this._applyNames();const t=this._build();this._rebase(t.text,t.files)}_applyNames(){const e={};for(const t of this.defined_names.values()){const s=M(t.attr_text),n=this._names.get(t.name);e[t.name]=n!==void 0&&String(n).replace(/^=/u,"")===t.attr_text?n:typeof s.value=="number"||typeof s.value=="boolean"?s.value:/^"[^"]*"$/u.test(t.attr_text)?t.attr_text.slice(1,-1):`=${t.attr_text}`}m(e)?delete this._file.names:this._file.names=e}_applySheet(e){const t=this._sheetEntry(e);e._freeze===void 0?delete t.freeze:t.freeze=e._freeze,m(e._print)?delete t.print:t.print=e._print,m(e._links)?delete t.links:t.links=e._links,m(e._notes)?delete t.notes:t.notes=e._notes,e._pictures.length===0?delete t.pictures:t.pictures=e._pictures,e._protect?t.protect=!0:delete t.protect,e._merges.length===0?delete t.merges:t.merges=[...e._merges],e._state==="hidden"?t.hidden=!0:delete t.hidden,e._rules.length===0?delete t.conditional:t.conditional=[...e._rules],e._validations.length===0?delete t.validations:t.validations=e._validations.map(ke),e._charts.length===0?delete t.charts:t.charts=e._charts.map(n=>n._spec(e._title)),this._applyFilter(e,t);const s=new Set(t.tables?.map(n=>n.name.toLowerCase()));for(const n of e._tables.values())s.has(n.name.toLowerCase())||this._writeNewTable(e,t,n);this._applyTableFilters(e,t),this._applyCells(e,t),this._applyDimensions(e,t),t.cells&&m(t.cells)&&delete t.cells,t.columns&&m(t.columns)&&delete t.columns,t.rows&&m(t.rows)&&delete t.rows,t.format?.length===0&&delete t.format,t.tables?.length===0&&delete t.tables,t.blocks?.length===0&&delete t.blocks}_applyFilter(e,t){const{ref:s,_columns:n}=e._filter;if(s===void 0){delete t.filter;return}const o=k(s);if(!o)throw new TypeError(`${s} is not a range.`);const r={};for(const[a,f]of n)r[L(o.left+a)]=f;t.filter={range:s,...m(r)?{}:{columns:r}}}_applyTableFilters(e,t){for(const s of t.tables??[]){const n=e._tables.get(s.name);if(!n||n.autoFilter._columns.size===0)continue;const o=this._csv.get(s.rows)?.rows??[],r=ce(s,o)?.names??[],a={};for(const[f,c]of n.autoFilter._columns){const u=r[f];if(u===void 0)throw new RangeError(`Table ${s.name} has no column at ${String(f)}.`);a[u]=c}s.filter={columns:a}}}_applyDimensions(e,t){if(e._dimensions){for(const[s,n]of e._columns){const o={...t.columns?.[s]};n._width===void 0?delete o.width:o.width=n._width,n._hidden===void 0?delete o.hidden:o.hidden=n._hidden,n._files===void 0?delete o.files:o.files=n._files,n._level===void 0?delete o.level:o.level=n._level;const r=j(t.columns??{},s);t.columns=m(o)?r:{...r,[s]:o}}for(const[s,n]of e._rows){const o={...t.rows?.[String(s)]};n._height===void 0?delete o.height:o.height=n._height,n._hidden===void 0?delete o.hidden:o.hidden=n._hidden,n._level===void 0?delete o.level:o.level=n._level;const r=j(t.rows??{},String(s));t.rows=m(o)?r:{...r,[String(s)]:o}}e._dimensions=!1}}_applyCells(e,t){const s=(t.tables??[]).flatMap(r=>{const a=y(r.at),f=e._tables.get(r.name),c=f?k(f.ref):void 0;return a&&c?[{entry:r,area:c}]:[]}),n=(t.blocks??[]).flatMap(r=>{const a=e._model?.blocks.find(f=>f.file===r.rows);return a?[{entry:r,area:a.area}]:[]}),o=[];for(const r of e._cells.values()){if(!r._changed&&!r._styled)continue;const a=r.row-1,f=r.column-1,c=s.find(i=>N(i.area,a,f)),u=n.find(i=>N(i.area,a,f));c?(r._changed&&this._writeTableCell(c.entry,c.area,r),r._styled&&this._styleByFormat(t,r)):u?(r._changed&&this._setCsvCell(u.entry.rows,a-u.area.top,f-u.area.left,v(r)),r._styled&&this._styleByFormat(t,r)):r._fresh&&!e._model?.keys.has(a*16384+f)?o.push(r):this._writeLoose(e,t,r),r._changed=!1,r._styled=!1}this._consolidate(e,t,o),je(t)}_styleByFormat(e,t){(e.format??=[]).push({range:t.coordinate,...this._ownLook(t)})}_ownLook(e){const t=e._ws._model?.lookAt(e.row-1,e.column-1)??{},s=Fe(t,e._look);return s.format!==void 0&&e._formula===void 0&&M(v(e)).format===s.format&&delete s.format,s}_writeLoose(e,t,s){const n=s.coordinate,o=t.cells??={},r=U(s),a=this._ownLook(s),f=o[n],u={...f!==null&&typeof f=="object"?Object.fromEntries(Object.entries(f).filter(([_])=>_!=="value"&&_!=="formula"&&_!=="name")):{},...a},i=f!==null&&typeof f=="object"&&f.name!==void 0?{name:f.name}:{},h=e._model?.at(s.row-1,s.column-1)!==void 0;if(r===null&&m(u)&&!h){t.cells=j(o,n);return}o[n]=m(u)&&m(i)?r:{...typeof r=="string"&&r.startsWith("=")?{formula:r}:r===null?{}:{value:r},...i,...u}}_consolidate(e,t,s){const n=s.filter(i=>i._value!==null||i._formula!==void 0),o=new Map;for(const i of s){const h=this._ownLook(i);if(m(h))continue;const _=JSON.stringify(h),d=o.get(_);d?d.push(i):o.set(_,[i])}const r=new Map(n.map(i=>[`${String(i.row)}:${String(i.column)}`,i])),a=i=>r.get(`${String(i.row+1)}:${String(i.col+1)}`)??e.cell(i.row+1,i.col+1),f=new Map,c=[];for(const i of n){const h={row:i.row-1,col:i.column-1},_=i._formula===void 0?void 0:R(i);if(_===void 0){c.push(h);continue}const d=f.get(_);d?d.push(h):f.set(_,[h])}const u=t.cells??={};for(const i of f.values())for(const h of T(i))u[x(h)]=a({row:h.top,col:h.left})._formula??null;for(const i of T(c))if((i.bottom-i.top+1)*(i.right-i.left+1)>=this.block_cells){const _=[];for(let p=i.top;p<=i.bottom;p++){const D=[];for(let O=i.left;O<=i.right;O++)D.push(v(a({row:p,col:O})));_.push(D)}const d=this._dataPath(e._title);this._csv.set(d,{parsed:void 0,rows:_}),(t.blocks??=[]).push({at:C({row:i.top,col:i.left}),rows:d})}else for(let _=i.top;_<=i.bottom;_++)for(let d=i.left;d<=i.right;d++){const p=a({row:_,col:d});u[p.coordinate]=U(p)}for(const i of o.values()){const[h]=i;if(!h)continue;const _=this._ownLook(h),d=i.map(p=>({row:p.row-1,col:p.column-1}));for(const p of T(d))(t.format??=[]).push({range:x(p),..._})}}_build(){const e=new Map;for(const[t,s]of this._csv)e.set(t,s.parsed?re(s.parsed,s.rows):ee(s.rows));return{text:ue(this._text,this._file),files:e}}_rebase(e,t){const{workbook:s,problems:n}=I({text:e,read:o=>t.get(o)});if(!s)throw new Error(`The workbook is not one: ${n.map(o=>o.message).join("; ")}`);this._text=e,this._file=structuredClone(s.file),this._model=s;for(const[o,r]of t)this._keepCsv(o,r);this._calc=void 0,this._pending=!1;for(const o of this.worksheets){o._was=o._title;const r=s.sheet(o._title);r&&(o._model=r);for(const a of o._cells.values())a._fresh=r?.at(a.row-1,a.column-1)===void 0}this._names=new Map;for(const o of s.names.values())o.source.path?.[0]==="names"&&this._names.set(o.name,o.formula?o.formula.text:o.value??null)}_computed(){const e=[...this.defined_names.values()];if((this._pending||e.length!==this._names.size||e.some(t=>String(this._names.get(t.name)).replace(/^=/u,"")!==t.attr_text))&&this._apply(),!this._calc){const t=this._model;if(!t)throw new Error("The workbook has no sheets.");this._calc={calc:new Q(t).calculate(),model:t}}return this._calc}check(){this._apply();const{text:e,files:t}=this._build();return X({text:e,read:s=>t.get(s)}).problems}_generated(){if(this.worksheets.length===0)return this._applyNames(),{sheets:[],csv:{},...this._file.names?{names:this._file.names}:{}};this._apply();const e=structuredClone(this._file.sheets),t=n=>`${te}${n}`;for(const n of e){for(const o of n.tables??[])o.rows=t(o.rows);for(const o of n.blocks??[])o.rows=t(o.rows)}const s={};for(const[n,o]of this._build().files)s[t(n)]=o;return{sheets:e,csv:s,...this._file.names?{names:this._file.names}:{}}}save(e){if(this._making)throw new Error("sheet.ts makes sheets and saves nothing: what it adds to wb is what it makes.");const t=e??this.path;if(t===void 0)throw new TypeError("A new workbook is saved to a folder: wb.save('finance/budget').");if(this.worksheets.length===0)throw new Error("A workbook has at least one sheet.");const{text:s,csv:n}=this._disk;this._apply();const o=new Set(this._file.sheets.flatMap(i=>[...(i.tables??[]).map(h=>h.rows),...(i.blocks??[]).map(h=>h.rows)])),r=[...this._csv.keys()].filter(i=>!o.has(i));for(const i of r)this._csv.delete(i);const{mkdirSync:a,rmSync:f,writeFileSync:c}=J(),u=process.getBuiltinModule("node:path");a(t,{recursive:!0}),(this._text!==s||e!==void 0)&&c($(t,P),this._text);for(const[i,h]of this._csv){const _=h.parsed?.source??"";if(e===void 0&&n.get(i)===_)continue;const d=$(t,i);a(u.dirname(d),{recursive:!0}),c(d,_)}if(e===void 0||t===this.path)for(const i of r)f($(t,i),{force:!0});this._disk={text:this._text,csv:new Map([...this._csv].map(([i,h])=>[i,h.parsed?.source??""]))},this.path=t}}function R(l){if(l._formula===void 0)return;const e=F(l._formula);if(e.ok)return ne(e.node,l.row-1,l.column-1)}function je(l){const e=l.format;if(!e||e.length<2)return;const t=[],s=new Map;for(const n of e){const{range:o,...r}=n,a=y(o);if(!a){t.push(n);continue}const f=JSON.stringify(r),c=s.get(f);c?c.places.push(a):s.set(f,{look:r,places:[a]})}for(const{look:n,places:o}of s.values())for(const r of T(o))t.push({range:x(r),...n});l.format=t}export function load_workbook(l,e={}){return Workbook.open(l,e)}export const get_column_letter=l=>L(l-1);export function column_index_from_string(l){const e=E(l);if(e===void 0)throw new TypeError(`${l} is not a column.`);return e+1}export function coordinate_to_tuple(l){const e=y(l);if(!e)throw new TypeError(`${l} is not a cell.`);return[e.row+1,e.col+1]}export function range_boundaries(l){const e=k(l);if(!e)throw new TypeError(`${l} is not a range.`);return[e.left+1,e.top+1,e.right+1,e.bottom+1]}

package/dist/node_modules/@allyhub/sheet/dist/arrange.d.ts

@@ -0,0 +1,68 @@
+import type { SheetChart, SheetConditional, SheetFilterColumn, SheetSide, SheetValidation } from "@allyhub/formats";
+import { type Area, type Place } from "./address.js";
+import { Draft, type BookEdit, type EditBook } from "./edit.js";
+import type { CellLook, Filter, Worksheet } from "./workbook.js";
+/** Excel's Borders list. */
+export declare const BORDER_PRESETS: readonly ["bottom", "top", "left", "right", "none", "all", "outside", "thickOutside", "bottomDouble", "thickBottom", "topBottom", "topThickBottom", "topDoubleBottom"];
+export type BorderPreset = (typeof BORDER_PRESETS)[number];
+type Sides = NonNullable<CellLook["border"]>;
+/** Sides drawn on an area, in `format`: later entries win side by side. */
+export declare function drawSides(d: Draft, sheet: Worksheet, area: Area, sides: Sides): void;
+/** A preset of Excel's Borders list on an area. */
+export declare function setBorders(book: EditBook, sheetName: string, area: Area, preset: BorderPreset, o?: {
+    style?: SheetSide["style"];
+    color?: string;
+}): BookEdit;
+/** What Format Cells' Border tab says of each side of a selection, and between its cells. */
+export declare function setBorderSides(book: EditBook, sheetName: string, area: Area, sides: {
+    top?: SheetSide | null;
+    bottom?: SheetSide | null;
+    left?: SheetSide | null;
+    right?: SheetSide | null;
+    /** Between its rows. */
+    horizontal?: SheetSide | null;
+    /** Between its columns. */
+    vertical?: SheetSide | null;
+}): BookEdit;
+export type MergeHow = "center" | "across" | "cells";
+/** Whether merging would take a value away: cells other than the first of each merge hold something. */
+export declare function mergeLoses(sheet: Worksheet, area: Area, how: MergeHow): boolean;
+/**
+ * Cells merged as Excel's Merge & Center, Merge Across and Merge Cells: the
+ * first value stays, in the first cell, and the others go. Tables hold no merges.
+ */
+export declare function mergeCells(book: EditBook, sheetName: string, area: Area, how: MergeHow): BookEdit;
+/** Every merge that touches an area taken out. */
+export declare function unmergeCells(book: EditBook, sheetName: string, area: Area): BookEdit;
+/** The panes frozen above and left of a cell; nothing unfreezes them. */
+export declare function setFreeze(book: EditBook, sheetName: string, at: Place | undefined): BookEdit;
+/** Rows or columns hidden, or shown again. */
+export declare function setHidden(book: EditBook, sheetName: string, what: "rows" | "columns", from: number, to: number, hidden: boolean): BookEdit;
+/** A sheet hidden or shown; at least one stays. */
+export declare function setSheetHidden(book: EditBook, sheetName: string, hidden: boolean): BookEdit;
+/** A sheet's tab given a colour, or none. */
+export declare function setTabColor(book: EditBook, sheetName: string, color: string | undefined): BookEdit;
+/** Cmd+Shift+L: a filter on the selection's region, or off. A table's buttons go and come. */
+export declare function toggleFilter(book: EditBook, sheetName: string, area: Area): BookEdit;
+/** What one column of a filter keeps; nothing clears it. */
+export declare function setFilterColumn(book: EditBook, sheetName: string, filter: Filter, col: number, keep: SheetFilterColumn | undefined): BookEdit;
+/** Every filter of a sheet shows all its rows again. */
+export declare function clearFilters(book: EditBook, sheetName: string): BookEdit;
+/** A rule added, first of all, as Excel puts a new one. */
+export declare function addConditional(book: EditBook, sheetName: string, rule: SheetConditional): BookEdit;
+/** Conditional formats cleared from an area, or from all the sheet. */
+export declare function clearConditional(book: EditBook, sheetName: string, area: Area | undefined): BookEdit;
+/** The data validation of an area: what was there goes, and `rule` holds. */
+export declare function setValidation(book: EditBook, sheetName: string, area: Area, rule: Omit<SheetValidation, "range"> | undefined): BookEdit;
+/** A sheet's whole grid, for what covers all of it. */
+export declare const WHOLE_SHEET: Area;
+/** A chart put on a sheet. */
+export declare function addChart(book: EditBook, sheetName: string, chart: SheetChart): BookEdit;
+/** A chart changed: what `patch` says, an undefined field taken away. */
+export declare function setChart(book: EditBook, sheetName: string, index: number, patch: {
+    [K in keyof SheetChart]?: SheetChart[K] | undefined;
+}): BookEdit;
+/** A chart taken off its sheet. */
+export declare function removeChart(book: EditBook, sheetName: string, index: number): BookEdit;
+export {};
+//# sourceMappingURL=arrange.d.ts.map

package/dist/node_modules/@allyhub/sheet/dist/calc/server.d.ts

@@ -0,0 +1,82 @@
+import type { SheetFile } from "@allyhub/formats";
+import type { BookEdit } from "../edit.js";
+import type { GeneratedSheets } from "../generated.js";
+import { type CsvRows, type Workbook } from "../workbook.js";
+import { Calc } from "./engine.js";
+import type { Computed } from "./remote.js";
+/** A changed cell as plain data, which crosses postMessage. */
+export interface CellEdit {
+    /** The sheet's place in the workbook. */
+    sheet: number;
+    row: number;
+    col: number;
+    /** What it now holds, as typed; absent: empty. */
+    input?: string;
+    /** A table's calculated column whose formula it holds again. */
+    column?: {
+        table: string;
+        name: string;
+    };
+    /** sheet.yaml's key for it now; null: it has none. */
+    key?: string | null;
+    /** The CSV record of a table's row, now. */
+    record?: {
+        table: string;
+        index: number;
+        fields: string[];
+    };
+}
+/** An edit's changed cells, as plain data. */
+export declare function cellEditsOf(edit: BookEdit): CellEdit[];
+/**
+ * Changed cells put in a model and computed, or, for a replica, put in to
+ * wait for what a calculation elsewhere computes: sheet.yaml's keys, a
+ * table's records, the format a value typed implies, and the cell itself.
+ */
+export declare function applyCellEdits(wb: Workbook, calc: Calc, cells: readonly CellEdit[], file?: SheetFile): void;
+/** What a workbook is opened from. */
+export interface Opening {
+    file: SheetFile;
+    rows: readonly (readonly [string, CsvRows])[];
+    /** What RAND is seeded with. */
+    seed: string;
+    generated?: GeneratedSheets;
+    /** The scenario on show. */
+    scenario?: string;
+}
+/** A model made from what its files say, computing or a replica. */
+export declare function openWorkbook(o: Opening, mode?: {
+    report?: boolean;
+    replica?: boolean;
+}): {
+    workbook: Workbook;
+    calc: Calc;
+};
+/**
+ * What a calculation elsewhere is told. Each opening starts a generation;
+ * what is said of an earlier one is left unanswered, and its answers are
+ * dropped by the page.
+ */
+export type CalcRequest = ({
+    kind: "open";
+    generation: number;
+} & Opening) | {
+    kind: "cells";
+    generation: number;
+    cells: CellEdit[];
+    file?: SheetFile;
+} | {
+    kind: "recalculate";
+    generation: number;
+};
+export interface CalcReply {
+    generation: number;
+    computed: Computed;
+}
+/** The calculation a worker runs: a request in, what it computed out. */
+export declare class CalcServer {
+    private model;
+    private generation;
+    handle(r: CalcRequest): CalcReply | undefined;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/node_modules/@allyhub/sheet/dist/chart.d.ts

@@ -0,0 +1,52 @@
+import { type ChartDef, type ChartSvgOptions } from "@allyhub/chart";
+import type { SheetChart, SheetChartType } from "@allyhub/formats";
+import { type Area } from "./address.js";
+import type { Calc } from "./calc/engine.js";
+import type { Chart, Worksheet } from "./workbook.js";
+/** What a chart is unless it says otherwise: Excel's new chart. */
+export declare const SHEET_CHART_DEFAULTS: {
+    /** Pixels. */
+    readonly width: 480;
+    readonly height: 288;
+    /** Points. */
+    readonly size: 9;
+    readonly titleSize: 14;
+    readonly ink: "#595959";
+    /** Pixels to the point, at 96 to the inch. */
+    readonly pixelsToPoints: 0.75;
+};
+/** A chart as it is drawn now: what its cells compute, from the sheet it is on. */
+export declare function chartDef(calc: Calc, sheet: Worksheet, chart: Chart): ChartDef;
+/** A chart's size on the sheet, pixels. */
+export declare const chartSize: (spec: SheetChart) => {
+    width: number;
+    height: number;
+};
+export type { ChartSvgOptions };
+/** A chart as an SVG of `width` × `height` pixels: the one drawing the grid, a PDF and a picture show. */
+export declare const chartSvg: (def: ChartDef, width: number, height: number, o?: ChartSvgOptions) => string;
+/** Every reference a chart holds through a change. */
+export declare function chartAfter(chart: SheetChart, again: (text: string) => string): SheetChart;
+export type NewChart = Pick<SheetChart, "type" | "categories" | "series" | "legend" | "title">;
+/**
+ * What a chart of a range reads, as Excel's Insert Chart lays a selection
+ * out: a first row of text names the series, a first column of text or dates
+ * is the categories, and with more columns than rows each row is a series. A
+ * scatter's first column is its places across.
+ */
+export declare function chartOfRange(calc: Calc, sheet: Worksheet, from: Worksheet, area: Area, type: SheetChartType): NewChart | undefined;
+/** The range a chart reads as one (Select Data's), when its pieces make one. */
+export declare function chartDataRange(calc: Calc, sheet: Worksheet, chart: Chart): string | undefined;
+/** A range typed in Select Data: its sheet and area. */
+export declare function readDataRange(calc: Calc, sheet: Worksheet, text: string): {
+    sheet: Worksheet;
+    area: Area;
+} | undefined;
+/** Where a chart's top left is, in pixels from the sheet's, given each row's and column's start. */
+export declare function chartPlace(spec: SheetChart, rowTop: (row: number) => number, columnLeft: (col: number) => number): {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=chart.d.ts.map

package/dist/node_modules/@allyhub/sheet/dist/chart.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{chartSvg as E,isRound as M,isScatter as C}from"@allyhub/chart";import{cellName as L,columnLetter as F,contains as H,rangeName as P,readAddress as U,readArea as I}from"./address.js";import{Reference as N,Union as V}from"./calc/types.js";import{shownValue as W}from"./format.js";import{sheetPrefix as k}from"./formula/print.js";import{CellError as q,Matrix as T}from"./values.js";export const SHEET_CHART_DEFAULTS={width:480,height:288,size:9,titleSize:14,ink:"#595959",pixelsToPoints:.75};function z(e,n,o){const{node:t}=o;if(!t)return[];const i=e.eval(t,{sheet:n,row:0,col:0,dr:0,dc:0}),f=l=>{const a=l.sheet,b=e.filtered(a),m=[],h=Math.min(l.bottom,a.lastRow),p=Math.min(l.right,a.columnsUsed-1);for(let u=l.top;u<=h;u++)if(!(b.has(u)||a.spec.rows?.[String(u+1)]?.hidden===!0))for(let d=l.left;d<=p;d++)a.spec.columns?.[F(d)]?.hidden!==!0&&m.push({value:e.value(a,u,d),sheet:a,row:u,col:d});return m};if(i instanceof N)return f(i);if(i instanceof V)return i.parts.flatMap(f);if(i instanceof T)return i.data.map(l=>({value:l}));const r=e.flat(i);return r instanceof T?r.data.map(l=>({value:l})):[{value:r}]}const O=e=>{if(e.value===null)return"";const n=e.sheet&&e.row!==void 0&&e.col!==void 0?e.sheet.lookAt(e.row,e.col).format:void 0;return W(e.value,n)};function j(e){return typeof e=="number"?Number.isFinite(e)?e:null:e===null||e instanceof q?null:typeof e=="boolean"&&e?1:0}const D=e=>e&&{...e.min===void 0?{}:{minimum_scale:e.min},...e.max===void 0?{}:{maximum_scale:e.max},...e.major===void 0?{}:{major_unit:e.major},...e.gridlines===void 0?{}:{has_major_gridlines:e.gridlines},...e.visible===void 0?{}:{visible:e.visible},...e.format===void 0?{}:{number_format:e.format},...e.reverse===void 0?{}:{reverse_order:e.reverse},...e.title===void 0||e.title===""?{}:{title:e.title}},R=e=>e===void 0?void 0:{rgb:e};function B(e){if(e===void 0||e===!1)return;if(e===!0)return{show_value:!0};const n=typeof e.color=="string"?R(e.color):void 0;return{...e.value===void 0?{}:{show_value:e.value},...e.percentage===void 0?{}:{show_percentage:e.percentage},...e.category===void 0?{}:{show_category_name:e.category},...e.series===void 0?{}:{show_series_name:e.series},...e.format===void 0?{}:{number_format:e.format},...e.position===void 0?{}:{position:e.position},...e.size===void 0?{}:{size:e.size},...n?{color:n}:{}}}const G=e=>{const n=e.find(o=>o.sheet);return n?.sheet&&n.row!==void 0&&n.col!==void 0?n.sheet.lookAt(n.row,n.col).format:void 0};export function chartDef(e,n,o){const{spec:t}=o,i=C(t.type),f=o.categories?z(e,n,o.categories):void 0,r=o.series.map((d,g)=>{const c=t.series[g],w=z(e,n,d.values),x=d.name?z(e,n,d.name)[0]:void 0,A=d.x?z(e,n,d.x):i?f:void 0,v=c.format??G(w),y=R(c.color);return{name:(x?O(x):c.name)??`Series${String(g+1)}`,values:w.map(s=>j(s.value)),...A?{x:A.map(s=>j(s.value))}:{},...v===void 0?{}:{number_format:v},...y?{color:y}:{},...c.smooth===void 0?{}:{smooth:c.smooth},...c.line_width===void 0?{}:{line_width:c.line_width},...c.marker_size===void 0?{}:{marker_size:c.marker_size}}}),l=Math.max(0,...r.map(d=>d.values.length)),a=f?f.map(O):Array.from({length:l},(d,g)=>String(g+1)),b=o.title?z(e,n,o.title)[0]:void 0,m=b?O(b):t.title,h=B(t.labels),p=D(t.value_axis),u=D(t.category_axis);return{type:t.type,categories:a,series:r,...m===void 0||m===""?{}:{title:m},...t.legend===void 0?{}:{legend:t.legend},...h?{labels:h}:{},...t.gap_width===void 0?{}:{gap_width:t.gap_width},...t.overlap===void 0?{}:{overlap:t.overlap},...t.vary_by_categories===void 0?{}:{vary_by_categories:t.vary_by_categories},...t.hole_size===void 0?{}:{hole_size:t.hole_size},...p?{value_axis:p}:{},...u?{category_axis:u}:{},font_size:t.size??SHEET_CHART_DEFAULTS.size,title_size:t.title_size??SHEET_CHART_DEFAULTS.titleSize,font_color:R(t.color)??{rgb:SHEET_CHART_DEFAULTS.ink}}}export const chartSize=e=>({width:e.width??SHEET_CHART_DEFAULTS.width,height:e.height??SHEET_CHART_DEFAULTS.height}),chartSvg=(e,n,o,t={})=>E(e,n,o,{pointsPerPixel:SHEET_CHART_DEFAULTS.pixelsToPoints,...t});export function chartAfter(e,n){const o=i=>i?.startsWith("=")===!0?n(i):i,t=o(e.title);return{...e,...t===void 0?{}:{title:t},...e.categories===void 0?{}:{categories:n(e.categories)},series:e.series.map(i=>{const f=o(i.name);return{...i,values:n(i.values),...i.x===void 0?{}:{x:n(i.x)},...f===void 0?{}:{name:f}}})}}function J(e,n,o,t){if(t){const i=t.data;if(o.top===i.top&&o.bottom===i.bottom&&o.left===o.right){const f=t.columns[o.left-t.at.col];if(f)return`${t.name}[${f.name}]`}}return`${n===e?"":k(n.name)}${P(o)}`}const K=(e,n,o,t)=>typeof e.value(n,o,t)=="number",Q=(e,n,o,t)=>{const i=e.value(n,o,t);if(typeof i=="string")return!0;const f=n.lookAt(o,t).format;return typeof i=="number"&&f!==void 0&&/[ymd]/iu.test(f)};export function chartOfRange(e,n,o,t,i){const f=t.bottom-t.top+1,r=t.right-t.left+1,l=n.tables.find(s=>H(s.area,t.top,t.left)),a=s=>J(o,n,s,l),b=C(i),m=f>1&&Array.from({length:r},(s,_)=>t.left+_).some(s=>!K(e,n,t.top,s)),h=r>1&&(b||Array.from({length:f-(m?1:0)},(s,_)=>_).every(s=>Q(e,n,t.top+(m?1:0)+s,t.left)||e.value(n,t.top+(m?1:0)+s,t.left)===null)),p=t.top+(m?1:0),u=t.left+(h?1:0);if(p>t.bottom||u>t.right)return;const d=!b&&!M(i)&&t.right-u>t.bottom-p,g=[],c=(s,_)=>e.value(n,s,_)===null?void 0:`=${n===o?"":k(n.name)}${L({row:s,col:_})}`,w=d?{first:p,last:t.bottom}:{first:u,last:t.right};for(let s=w.first;s<=w.last;s++){const _=d?{top:s,left:u,bottom:s,right:t.right}:{top:p,left:s,bottom:t.bottom,right:s},$=d?h?c(s,t.left):void 0:m?c(t.top,s):void 0;g.push({values:a(_),...$===void 0?{}:{name:$}})}const x=d?m?{top:t.top,left:u,bottom:t.top,right:t.right}:void 0:h?{top:p,left:t.left,bottom:t.bottom,right:t.left}:void 0,A=g.length>1&&!M(i),v=M(i)?g.slice(0,1):g,y=v.length===1?v[0]?.name:void 0;return{type:i,...x?{categories:a(x)}:{},series:v,...A||M(i)?{legend:"bottom"}:{},...y===void 0?{}:{title:y}}}function S(e,n,o){if(!o?.node)return;const t=e.eval(o.node,{sheet:n,row:0,col:0,dr:0,dc:0});return t instanceof N?{sheet:t.sheet,area:{top:t.top,left:t.left,bottom:Math.min(t.bottom,Math.max(t.top,t.sheet.lastRow)),right:t.right}}:void 0}export function chartDataRange(e,n,o){const t=[S(e,n,o.categories),...o.series.flatMap(r=>[S(e,n,r.values),S(e,n,r.name),S(e,n,r.x)])].filter(r=>r!==void 0),i=t[0];if(!i||t.some(r=>r.sheet!==i.sheet))return;const f={top:Math.min(...t.map(r=>r.area.top)),left:Math.min(...t.map(r=>r.area.left)),bottom:Math.max(...t.map(r=>r.area.bottom)),right:Math.max(...t.map(r=>r.area.right))};return`${i.sheet===n?"":k(i.sheet.name)}${P(f)}`}export function readDataRange(e,n,o){const t=o.lastIndexOf("!"),i=t<0?void 0:o.slice(0,t).replace(/^'|'$/gu,""),f=i===void 0?n:e.wb.sheet(i.replaceAll("''","'")),r=I(o.slice(t+1).replaceAll("$",""));return f&&r?{sheet:f,area:r}:void 0}export function chartPlace(e,n,o){const t=U(e.at)??{row:0,col:0};return{left:o(t.col)+(e.x??0),top:n(t.row)+(e.y??0),...chartSize(e)}}