ooxml-core 1.2.0 → 1.2.1

package/dist/xlsx/formula/shift-graph.d.ts

@@ -0,0 +1,42 @@
+import { type CellRange } from '../address.js';
+import type { FormulaAst } from './ast.js';
+import type { Area } from './values.js';
+/** A structural edit on one sheet: `count` rows or columns inserted (positive) or deleted at `at`. */
+export interface GraphShift {
+    axis: 'row' | 'col';
+    at: number;
+    count: number;
+}
+/** What a formula's syntax says about how a structural edit can change its value. */
+export interface AstTraits {
+    /**
+     * Reads areas the formula text does not spell out (defined names, tables, 3D references):
+     * their precedents are worked out again when an edit reaches them.
+     */
+    complex: boolean;
+    /** Calls a name (a LAMBDA) whose cells the graph does not know: recalculated on every edit. */
+    opaque: boolean;
+    /** Returns a position (ROW, COLUMN), so moving the formula or its precedents changes it. */
+    positional: boolean;
+    /** Returns text about references or sheets (FORMULATEXT, CELL, SHEET). */
+    descriptive: boolean;
+    /** Sheet names its prefixes mention, lower case. */
+    sheets: ReadonlySet<string>;
+}
+/** The traits of a parsed formula (cached per syntax tree). */
+export declare function astTraits(ast: FormulaAst): AstTraits;
+/** How an interval moves: by `delta`, or `undefined` when its cells change (cut, widened, gone). */
+export declare function intervalDelta(a: number, b: number, shift: GraphShift): number | undefined;
+/** How an area moves when `shift` applies to `sheet` (areas on other sheets stay). */
+export declare function areaDelta(area: Area, sheet: number, shift: GraphShift): number | undefined;
+/** A copy of a range moved `delta` along the axis. */
+export declare function movedRange(range: CellRange, axis: GraphShift['axis'], delta: number): CellRange;
+/** Whether any of the areas reaches the moved part of the sheet (at or past the edit). */
+export declare function reachesEdit(areas: readonly Area[], sheet: number, shift: GraphShift): boolean;
+/**
+ * Whether implicit intersection with an area can pick a different cell: the area spans several
+ * positions along the axis, moves differently from the formula, and the formula's position
+ * (`pos` before, `pos + nodeDelta` after) falls inside it before or after.
+ */
+export declare function intersectionMoves(area: Area, delta: number, pos: number, nodeDelta: number, axis: GraphShift['axis']): boolean;
+//# sourceMappingURL=shift-graph.d.ts.map

package/dist/xlsx/formula/shift-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shift-graph.d.ts","sourceRoot":"","sources":["../../../xlsx/formula/shift-graph.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAErC,sGAAsG;AACtG,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACd;AAED,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACzB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,+FAA+F;IAC/F,MAAM,EAAE,OAAO,CAAC;IAChB,4FAA4F;IAC5F,UAAU,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5B;AAMD,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,CA+CpD;AAED,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAWzF;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAM1F;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAW/F;AAED,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAM7F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GACtB,OAAO,CAOT"}

package/dist/xlsx/formula/transform.d.ts

@@ -1,29 +1,8 @@
 import { type CellRange } from '../address.js';
-import { type RefSpec, type SheetPrefix } from './ast.js';
-import { type Token } from './tokenizer.js';
-export interface ShiftSpec {
-    /** Sheet whose rows or columns are inserted or deleted. */
-    sheet: string;
-    axis: 'row' | 'col';
-    /** Zero-based first row or column affected. */
-    at: number;
-    /** Positive to insert, negative to delete. */
-    count: number;
-}
-export declare function safeTokens(formula: string): Token[] | undefined;
-/** Formats a reference spec (without sheet prefix). */
-export declare function formatRefSpec(spec: RefSpec): string;
+export { formatRefSpec, prefixText, safeTokens } from './ref-text.js';
+export { renameSheetInFormula, type ShiftSpec, shiftFormula } from './shift-formula.js';
 /** Moves relative references by (dRow, dCol), as copying or filling a formula does. Off-grid parts become #REF!. */
 export declare function translateFormula(formula: string, dRow: number, dCol: number): string;
-/**
- * Adjusts references for inserted (`count` > 0) or deleted (`count` < 0) rows or columns on
- * `spec.sheet`. References into deleted cells become `#REF!`.
- */
-export declare function shiftFormula(formula: string, formulaSheet: string, spec: ShiftSpec): string;
-/** The text of a sheet prefix (`Sheet1!`, `'My Sheet'!`), quoted when needed. */
-export declare function prefixText(prefix: SheetPrefix): string;
-/** Rewrites sheet prefixes naming `oldName` (case-insensitive) to `newName`, quoting as needed. */
-export declare function renameSheetInFormula(formula: string, oldName: string, newName: string): string;
 /** The ranges a formula references directly (for coloured reference highlighting). */
 export declare function referencedRanges(formula: string, formulaSheet: string): {
     sheet: string;

package/dist/xlsx/formula/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../xlsx/formula/transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAiD,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAgC,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AACrF,OAAO,EAAc,KAAK,KAAK,EAAY,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,SAAS;IACzB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,SAAS,CAO/D;AAQD,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAInD;AAeD,oHAAoH;AACpH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBpF;AA6ED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAiC3F;AAaD,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAMtD;AAED,mGAAmG;AACnG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkB9F;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,EAAE,CAgBvC;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC7B,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,EAAE,CAqBrF"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../xlsx/formula/transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAoC,MAAM,YAAY,CAAC;AAK9E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,KAAK,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAErF,oHAAoH;AACpH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBpF;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,EAAE,CAgBvC;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC7B,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,EAAE,CAqBrF"}