@cj-tech-master/excelts 9.2.1 → 9.3.0

package/dist/types/modules/formula/syntax/token-types.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Token Types for Formula Tokenizer
+ *
+ * Defines a proper discriminated union of all token types.
+ * Each token variant carries only the data relevant to its type.
+ */
+export declare const enum TokenType {
+    Number = 1,
+    String = 2,
+    Boolean = 3,
+    Error = 4,
+    CellRef = 5,
+    Range = 6,// e.g. A1:B10
+    SheetRef = 7,// sheet prefix, e.g. Sheet1! or 'Sheet Name'!
+    Function = 8,// function name (followed by '(')
+    Operator = 9,// + - * / ^ & = < > <> <= >=
+    OpenParen = 10,
+    CloseParen = 11,
+    Comma = 12,
+    Colon = 13,// standalone : (for building ranges)
+    Percent = 14,
+    OpenBrace = 15,// { for array constants
+    CloseBrace = 16,// } for array constants
+    Semicolon = 17,// ; for array row separators
+    UnaryPrefix = 18,// unary + or -
+    Name = 19,// named range / defined name
+    ColRange = 20,// whole-column range e.g. A:B, $C:$D
+    RowRange = 21,// whole-row range e.g. 1:5, $3:$7
+    StructuredRef = 22,// structured reference e.g. Table1[Column], [@Column]
+    AtSign = 23,// @ implicit intersection prefix (Excel 365)
+    Intersect = 24
+}
+export interface NumberToken {
+    type: TokenType.Number;
+    value: string;
+}
+export interface StringToken {
+    type: TokenType.String;
+    value: string;
+}
+export interface BooleanToken {
+    type: TokenType.Boolean;
+    value: "TRUE" | "FALSE";
+}
+export interface ErrorToken {
+    type: TokenType.Error;
+    value: string;
+}
+export interface CellRefToken {
+    type: TokenType.CellRef;
+    /** Uppercase column letters (e.g. "A") */
+    col: string;
+    /** Row number as string (e.g. "1") */
+    row: string;
+    /** Whether column is absolute ($A) */
+    colAbsolute: boolean;
+    /** Whether row is absolute ($1) */
+    rowAbsolute: boolean;
+}
+export interface RangeToken {
+    type: TokenType.Range;
+    /** Raw range string, e.g. "A1:B2" or "$A$1:$B$2" */
+    value: string;
+}
+export interface SheetRefToken {
+    type: TokenType.SheetRef;
+    /** The sheet name (unquoted) */
+    sheetName: string;
+    /** The end sheet name for 3D references (e.g. Sheet1:Sheet3!) */
+    endSheetName?: string;
+}
+export interface FunctionToken {
+    type: TokenType.Function;
+    /** Uppercase function name */
+    name: string;
+}
+export interface OperatorToken {
+    type: TokenType.Operator;
+    value: string;
+}
+export interface OpenParenToken {
+    type: TokenType.OpenParen;
+}
+export interface CloseParenToken {
+    type: TokenType.CloseParen;
+}
+export interface CommaToken {
+    type: TokenType.Comma;
+}
+export interface ColonToken {
+    type: TokenType.Colon;
+}
+export interface PercentToken {
+    type: TokenType.Percent;
+}
+export interface OpenBraceToken {
+    type: TokenType.OpenBrace;
+}
+export interface CloseBraceToken {
+    type: TokenType.CloseBrace;
+}
+export interface SemicolonToken {
+    type: TokenType.Semicolon;
+}
+export interface UnaryPrefixToken {
+    type: TokenType.UnaryPrefix;
+    value: "+" | "-";
+}
+export interface NameToken {
+    type: TokenType.Name;
+    value: string;
+}
+export interface ColRangeToken {
+    type: TokenType.ColRange;
+    value: string;
+}
+export interface RowRangeToken {
+    type: TokenType.RowRange;
+    value: string;
+}
+export interface StructuredRefToken {
+    type: TokenType.StructuredRef;
+    /** Table name (empty string for implicit [@Col] syntax) */
+    tableName: string;
+    /** Column references (e.g. ["Column1", "Column2"]) */
+    columns: string[];
+    /** Special items (e.g. ["#Headers", "#Data"]) */
+    specials: string[];
+}
+export interface AtSignToken {
+    type: TokenType.AtSign;
+}
+/**
+ * Intersection operator — emitted by the tokenizer when a whitespace
+ * character separates two reference-producing tokens (ranges or refs).
+ * In Excel, `A1:A10 B1:B10` intersects the two areas.
+ */
+export interface IntersectToken {
+    type: TokenType.Intersect;
+}
+/**
+ * Strip Excel's `_XLFN.` / `_XLFN._XLWS.` function-name prefixes.
+ *
+ * Excel emits these prefixes for functions introduced after the original
+ * XLSX schema was frozen (e.g. `_XLFN.FILTER`, `_XLFN._XLWS.SORT`). The
+ * canonical function name is recovered by stripping the prefix.
+ *
+ * The input may or may not already be uppercased — this helper does not
+ * alter case; callers that compare against an uppercase table should
+ * uppercase first (or compare case-insensitively).
+ */
+export declare function stripFunctionPrefix(name: string): string;
+export type Token = NumberToken | StringToken | BooleanToken | ErrorToken | CellRefToken | RangeToken | SheetRefToken | FunctionToken | OperatorToken | OpenParenToken | CloseParenToken | CommaToken | ColonToken | PercentToken | OpenBraceToken | CloseBraceToken | SemicolonToken | UnaryPrefixToken | NameToken | ColRangeToken | RowRangeToken | StructuredRefToken | AtSignToken | IntersectToken;

package/dist/types/modules/formula/syntax/tokenizer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Formula Tokenizer
+ *
+ * Converts an Excel formula string into a stream of tokens.
+ * Supports cell references (A1, $A$1), ranges (A1:B10),
+ * cross-sheet references (Sheet1!A1), operators, function calls,
+ * numbers, strings, booleans, and error literals.
+ */
+import { type Token } from "./token-types.js";
+export declare function tokenize(formula: string): Token[];

package/package.json

@@ -1,43 +1,26 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "9.2.1",
+  "version": "9.3.0",
   "description": "Zero-dependency TypeScript toolkit — Excel (XLSX), PDF, CSV, Markdown, XML, ZIP/TAR, and streaming.",
   "keywords": [
     "archive",
-    "compression",
-    "cross-platform",
+    "browser",
+    "bun",
     "csv",
-    "csv-parser",
-    "csv-writer",
-    "deflate",
-    "dom",
     "excel",
-    "excel-to-pdf",
-    "gfm",
-    "gzip",
+    "formula",
     "markdown",
-    "markdown-table",
-    "openxml",
     "pdf",
-    "pdf-generation",
-    "rfc4180",
-    "sax",
     "spreadsheet",
     "stream",
-    "streaming",
     "tar",
+    "toolkit",
     "typescript",
     "workbook",
     "xlsx",
-    "xlsx-reader",
-    "xlsx-writer",
     "xml",
-    "xml-parser",
-    "xml-writer",
     "zero-dependency",
-    "zip",
-    "zip64",
-    "zlib"
+    "zip"
   ],
   "homepage": "https://github.com/cjnoname/excelts#readme",
   "bugs": {
@@ -81,6 +64,9 @@
       "pdf": [
         "dist/types/modules/pdf/index.d.ts"
       ],
+      "formula": [
+        "dist/types/modules/formula/index.d.ts"
+      ],
       "xml": [
         "dist/types/modules/xml/index.d.ts"
       ],
@@ -178,6 +164,20 @@
         "default": "./dist/cjs/modules/pdf/index.js"
       }
     },
+    "./formula": {
+      "browser": {
+        "types": "./dist/browser/modules/formula/index.d.ts",
+        "default": "./dist/browser/modules/formula/index.js"
+      },
+      "import": {
+        "types": "./dist/types/modules/formula/index.d.ts",
+        "default": "./dist/esm/modules/formula/index.js"
+      },
+      "require": {
+        "types": "./dist/types/modules/formula/index.d.ts",
+        "default": "./dist/cjs/modules/formula/index.js"
+      }
+    },
     "./xml": {
       "browser": {
         "types": "./dist/browser/modules/xml/index.d.ts",
@@ -200,23 +200,23 @@
   "devDependencies": {
     "@rspack/core": "^1.7.11",
     "@types/node": "^25.6.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260413.1",
+    "@typescript/native-preview": "^7.0.0-dev.20260418.1",
     "@vitest/browser": "^4.1.4",
     "@vitest/browser-playwright": "^4.1.4",
     "@vitest/ui": "^4.1.4",
     "concurrently": "^9.2.1",
     "cross-env": "^10.1.0",
     "esbuild": "^0.28.0",
-    "fast-xml-parser": "^5.5.12",
+    "fast-xml-parser": "^5.7.1",
     "husky": "^9.1.7",
     "oxfmt": "^0.45.0",
     "oxlint": "^1.60.0",
     "oxlint-tsgolint": "latest",
     "playwright": "^1.59.1",
     "rimraf": "^6.1.3",
-    "rolldown": "^1.0.0-rc.15",
+    "rolldown": "^1.0.0-rc.16",
     "rollup-plugin-visualizer": "^7.0.1",
-    "typescript": "^6.0.2",
+    "typescript": "^6.0.3",
     "vitest": "^4.1.4"
   },
   "browserslist": [
@@ -237,7 +237,7 @@
     "test:browser": "pnpm run generate:csv-worker && rimraf dist && pnpm run build:browser:bundle && vitest run --config vitest.browser.config.ts",
     "test:watch": "vitest",
     "build": "pnpm run generate:csv-worker && rimraf dist && concurrently \"pnpm run build:esm\" \"pnpm run build:cjs\" \"pnpm run build:browser\" \"pnpm run build:browser:bundle\" && pnpm run build:verify",
-    "build:verify": "tsc --noEmit --ignoreConfig --module NodeNext --moduleResolution NodeNext --lib ESNext,DOM --types node dist/types/index.d.ts dist/types/modules/archive/index.d.ts dist/types/modules/csv/index.d.ts dist/types/modules/markdown/index.d.ts dist/types/modules/pdf/index.d.ts dist/types/modules/stream/index.d.ts dist/types/modules/xml/index.d.ts",
+    "build:verify": "tsc --noEmit --ignoreConfig --module NodeNext --moduleResolution NodeNext --lib ESNext,DOM --types node dist/types/index.d.ts dist/types/modules/archive/index.d.ts dist/types/modules/csv/index.d.ts dist/types/modules/formula/index.d.ts dist/types/modules/markdown/index.d.ts dist/types/modules/pdf/index.d.ts dist/types/modules/stream/index.d.ts dist/types/modules/xml/index.d.ts",
     "verify:treeshake": "node scripts/treeshake-verify.ts",
     "analyze:browser": "rimraf dist && node --input-type=module -e \"import { execSync } from 'node:child_process'; process.env.ANALYZE='true'; execSync('rolldown -c rolldown.config.ts', { stdio: 'inherit' });\"",
     "clean": "pnpm dlx --reporter=silent rimraf \"**/node_modules\" pnpm-lock.yaml \"**/dist\" -g && pnpm i",