allyhub 0.7.0 → 0.8.0

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

@@ -1,362 +0,0 @@
-import { type SheetNote, type SheetPicture, type SheetPrint, type SheetConditional, type SheetFile, type SheetFilesColumn, type SheetTable, type SheetWorksheet } from "@allyhub-next/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-next/sheet/dist/api/workbook.js

@@ -1,2 +0,0 @@
-/*! 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-next/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('content/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-next/sheet/dist/arrange.d.ts

@@ -1,68 +0,0 @@
-import type { SheetChart, SheetConditional, SheetFilterColumn, SheetSide, SheetValidation } from "@allyhub-next/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-next/sheet/dist/calc/server.d.ts

@@ -1,82 +0,0 @@
-import type { SheetFile } from "@allyhub-next/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-next/sheet/dist/chart.d.ts

@@ -1,58 +0,0 @@
-import { type ChartDef } from "@allyhub-next/chart";
-import type { SheetChart, SheetChartType } from "@allyhub-next/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 interface ChartSvgOptions {
-    /** The chart's ground. */
-    paper?: string;
-    /** Its edge; none for no edge. */
-    edge?: string;
-    font?: string;
-}
-/** A chart as an SVG of `width` × `height` pixels: the one drawing the grid, a PDF and a picture show. */
-export declare function 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