@sciexpr/core 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -67,6 +67,7 @@ var ExpressionKind = /* @__PURE__ */ ((ExpressionKind2) => {
   ExpressionKind2["Matrix"] = "matrix";
   ExpressionKind2["Text"] = "text";
   ExpressionKind2["Mixed"] = "mixed";
+  ExpressionKind2["Physics"] = "physics";
   return ExpressionKind2;
 })(ExpressionKind || {});
 var SymbolType = /* @__PURE__ */ ((SymbolType2) => {
@@ -528,7 +529,7 @@ var ExpressionClassifier = class {
   hasMathNodes(root) {
     return collectNodes(
       root,
-      (n) => ["frac", "script", "radical", "delimiter", "matrix", "accent", "largeop"].includes(n.kind)
+      (n) => ["frac", "script", "radical", "delimiter", "matrix", "accent", "largeop", "symbol", "group"].includes(n.kind)
     ).length > 0;
   }
   /**

package/dist/index.d.cts

@@ -11,7 +11,9 @@ declare enum ExpressionKind {
     /** 纯文本 */
     Text = "text",
     /** 混合表达式（含多种类型片段） */
-    Mixed = "mixed"
+    Mixed = "mixed",
+    /** 物理表达式（公式/方程式/矢量表示） */
+    Physics = "physics"
 }
 /** 源码位置（用于错误提示和高亮） */
 interface SourceLocation {
@@ -26,10 +28,12 @@ interface SourceLocation {
         offset: number;
     };
 }
+/** 所有 AST 节点 kind 的字面量联合 */
+type ExpressionNodeKind = 'root' | 'symbol' | 'frac' | 'script' | 'radical' | 'delimiter' | 'matrix' | 'text' | 'space' | 'accent' | 'largeop' | 'color' | 'group' | 'chem-element' | 'chem-bond' | 'chem-reaction' | 'chem-group';
 /** 所有 AST 节点的基类 */
 interface ExpressionNode {
     /** 节点类型标识（discriminant） */
-    kind: string;
+    kind: ExpressionNodeKind;
     /** 可选的唯一标识 */
     id?: string;
     /** 源码位置 */
@@ -282,17 +286,47 @@ interface PipelineOptions {
     params?: Record<string, unknown>;
 }
 
-/** 生成唯一节点 ID */
+/**
+ * 生成唯一节点 ID
+ * @returns 格式为 `n{序号}` 的唯一标识字符串
+ */
 declare function generateNodeId(): string;
 /** 重置节点 ID 计数器（主要用于测试） */
 declare function resetNodeIdCounter(): void;
+/**
+ * 创建表达式根节点
+ * @param type - 表达式分类 (math/molecule/chemical-equation/matrix/text/mixed)
+ * @param children - 子节点列表
+ * @param metadata - 可选的元数据 (displayMode/label/style/originalSource)
+ */
 declare function createRoot(type: ExpressionKind, children: ExpressionNode[], metadata?: ExpressionMetadata): ExpressionRoot;
+/**
+ * 创建符号节点
+ * @param value - 符号文本 (LaTeX 命令或 Unicode 字符)
+ * @param symbolType - 符号分类 (greek/operator/relation/arrow/variable/number 等)
+ */
 declare function createSymbol(value: string, symbolType: SymbolType): SymbolNode;
+/**
+ * 创建分数节点
+ * @param numerator - 分子
+ * @param denominator - 分母
+ */
 declare function createFraction(numerator: ExpressionNode, denominator: ExpressionNode): FractionNode;
+/**
+ * 创建上下标节点
+ * @param base - 基础表达式
+ * @param options.sub - 下标表达式
+ * @param options.super - 上标表达式
+ */
 declare function createScript(base: ExpressionNode, options?: {
     sub?: ExpressionNode;
     super?: ExpressionNode;
 }): ScriptNode;
+/**
+ * 创建根式节点
+ * @param radicand - 被开方数
+ * @param index - 可选的根指数 (省略则为平方根)
+ */
 declare function createRadical(radicand: ExpressionNode, index?: ExpressionNode): RadicalNode;
 declare function createDelimiter(left: string, right: string, body: ExpressionNode): DelimiterNode;
 declare function createMatrix(rows: ExpressionNode[][], options?: {
@@ -417,4 +451,4 @@ declare class ExpressionClassifier {
     isDisplayMode(root: ExpressionRoot): boolean;
 }
 
-export { type ASTNode, type ASTVisitor, type AccentNode, type ChemArrowType, type ChemBondNode, type ChemElementNode, type ChemGroupNode, type ChemReactionNode, type ColorNode, type DelimiterNode, ExpressionClassifier, ExpressionKind, type ExpressionMetadata, type ExpressionNode, type ExpressionRoot, type FractionNode, type GroupNode, type IValidator, type LargeOpNode, type MatrixNode, type NodeByKind, type PipelineContext, type PipelineError, type PipelineOptions, type PipelineStage, type RadicalNode, type ScriptNode, type SourceLocation, type SpaceNode, type SymbolNode, SymbolType, type TextNode, type TraverseOptions, type ValidationError, ValidationErrorCode, type ValidationResult, type ValidationWarning, cloneNode, collectNodes, countNodes, createAccent, createChemBond, createChemElement, createChemGroup, createChemReaction, createColor, createDelimiter, createFraction, createGroup, createLargeOp, createMatrix, createRadical, createRoot, createScript, createSpace, createSymbol, createText, deserializeAST, findNode, flattenNode, generateNodeId, getNodeChildren, isNodeType, resetNodeIdCounter, safeDeserializeAST, serializeAST, serializeASTCompact, serializeASTPretty, traverseAST };
+export { type ASTNode, type ASTVisitor, type AccentNode, type ChemArrowType, type ChemBondNode, type ChemElementNode, type ChemGroupNode, type ChemReactionNode, type ColorNode, type DelimiterNode, ExpressionClassifier, ExpressionKind, type ExpressionMetadata, type ExpressionNode, type ExpressionNodeKind, type ExpressionRoot, type FractionNode, type GroupNode, type IValidator, type LargeOpNode, type MatrixNode, type NodeByKind, type PipelineContext, type PipelineError, type PipelineOptions, type PipelineStage, type RadicalNode, type ScriptNode, type SourceLocation, type SpaceNode, type SymbolNode, SymbolType, type TextNode, type TraverseOptions, type ValidationError, ValidationErrorCode, type ValidationResult, type ValidationWarning, cloneNode, collectNodes, countNodes, createAccent, createChemBond, createChemElement, createChemGroup, createChemReaction, createColor, createDelimiter, createFraction, createGroup, createLargeOp, createMatrix, createRadical, createRoot, createScript, createSpace, createSymbol, createText, deserializeAST, findNode, flattenNode, generateNodeId, getNodeChildren, isNodeType, resetNodeIdCounter, safeDeserializeAST, serializeAST, serializeASTCompact, serializeASTPretty, traverseAST };

package/dist/index.d.ts

@@ -11,7 +11,9 @@ declare enum ExpressionKind {
     /** 纯文本 */
     Text = "text",
     /** 混合表达式（含多种类型片段） */
-    Mixed = "mixed"
+    Mixed = "mixed",
+    /** 物理表达式（公式/方程式/矢量表示） */
+    Physics = "physics"
 }
 /** 源码位置（用于错误提示和高亮） */
 interface SourceLocation {
@@ -26,10 +28,12 @@ interface SourceLocation {
         offset: number;
     };
 }
+/** 所有 AST 节点 kind 的字面量联合 */
+type ExpressionNodeKind = 'root' | 'symbol' | 'frac' | 'script' | 'radical' | 'delimiter' | 'matrix' | 'text' | 'space' | 'accent' | 'largeop' | 'color' | 'group' | 'chem-element' | 'chem-bond' | 'chem-reaction' | 'chem-group';
 /** 所有 AST 节点的基类 */
 interface ExpressionNode {
     /** 节点类型标识（discriminant） */
-    kind: string;
+    kind: ExpressionNodeKind;
     /** 可选的唯一标识 */
     id?: string;
     /** 源码位置 */
@@ -282,17 +286,47 @@ interface PipelineOptions {
     params?: Record<string, unknown>;
 }
 
-/** 生成唯一节点 ID */
+/**
+ * 生成唯一节点 ID
+ * @returns 格式为 `n{序号}` 的唯一标识字符串
+ */
 declare function generateNodeId(): string;
 /** 重置节点 ID 计数器（主要用于测试） */
 declare function resetNodeIdCounter(): void;
+/**
+ * 创建表达式根节点
+ * @param type - 表达式分类 (math/molecule/chemical-equation/matrix/text/mixed)
+ * @param children - 子节点列表
+ * @param metadata - 可选的元数据 (displayMode/label/style/originalSource)
+ */
 declare function createRoot(type: ExpressionKind, children: ExpressionNode[], metadata?: ExpressionMetadata): ExpressionRoot;
+/**
+ * 创建符号节点
+ * @param value - 符号文本 (LaTeX 命令或 Unicode 字符)
+ * @param symbolType - 符号分类 (greek/operator/relation/arrow/variable/number 等)
+ */
 declare function createSymbol(value: string, symbolType: SymbolType): SymbolNode;
+/**
+ * 创建分数节点
+ * @param numerator - 分子
+ * @param denominator - 分母
+ */
 declare function createFraction(numerator: ExpressionNode, denominator: ExpressionNode): FractionNode;
+/**
+ * 创建上下标节点
+ * @param base - 基础表达式
+ * @param options.sub - 下标表达式
+ * @param options.super - 上标表达式
+ */
 declare function createScript(base: ExpressionNode, options?: {
     sub?: ExpressionNode;
     super?: ExpressionNode;
 }): ScriptNode;
+/**
+ * 创建根式节点
+ * @param radicand - 被开方数
+ * @param index - 可选的根指数 (省略则为平方根)
+ */
 declare function createRadical(radicand: ExpressionNode, index?: ExpressionNode): RadicalNode;
 declare function createDelimiter(left: string, right: string, body: ExpressionNode): DelimiterNode;
 declare function createMatrix(rows: ExpressionNode[][], options?: {
@@ -417,4 +451,4 @@ declare class ExpressionClassifier {
     isDisplayMode(root: ExpressionRoot): boolean;
 }
 
-export { type ASTNode, type ASTVisitor, type AccentNode, type ChemArrowType, type ChemBondNode, type ChemElementNode, type ChemGroupNode, type ChemReactionNode, type ColorNode, type DelimiterNode, ExpressionClassifier, ExpressionKind, type ExpressionMetadata, type ExpressionNode, type ExpressionRoot, type FractionNode, type GroupNode, type IValidator, type LargeOpNode, type MatrixNode, type NodeByKind, type PipelineContext, type PipelineError, type PipelineOptions, type PipelineStage, type RadicalNode, type ScriptNode, type SourceLocation, type SpaceNode, type SymbolNode, SymbolType, type TextNode, type TraverseOptions, type ValidationError, ValidationErrorCode, type ValidationResult, type ValidationWarning, cloneNode, collectNodes, countNodes, createAccent, createChemBond, createChemElement, createChemGroup, createChemReaction, createColor, createDelimiter, createFraction, createGroup, createLargeOp, createMatrix, createRadical, createRoot, createScript, createSpace, createSymbol, createText, deserializeAST, findNode, flattenNode, generateNodeId, getNodeChildren, isNodeType, resetNodeIdCounter, safeDeserializeAST, serializeAST, serializeASTCompact, serializeASTPretty, traverseAST };
+export { type ASTNode, type ASTVisitor, type AccentNode, type ChemArrowType, type ChemBondNode, type ChemElementNode, type ChemGroupNode, type ChemReactionNode, type ColorNode, type DelimiterNode, ExpressionClassifier, ExpressionKind, type ExpressionMetadata, type ExpressionNode, type ExpressionNodeKind, type ExpressionRoot, type FractionNode, type GroupNode, type IValidator, type LargeOpNode, type MatrixNode, type NodeByKind, type PipelineContext, type PipelineError, type PipelineOptions, type PipelineStage, type RadicalNode, type ScriptNode, type SourceLocation, type SpaceNode, type SymbolNode, SymbolType, type TextNode, type TraverseOptions, type ValidationError, ValidationErrorCode, type ValidationResult, type ValidationWarning, cloneNode, collectNodes, countNodes, createAccent, createChemBond, createChemElement, createChemGroup, createChemReaction, createColor, createDelimiter, createFraction, createGroup, createLargeOp, createMatrix, createRadical, createRoot, createScript, createSpace, createSymbol, createText, deserializeAST, findNode, flattenNode, generateNodeId, getNodeChildren, isNodeType, resetNodeIdCounter, safeDeserializeAST, serializeAST, serializeASTCompact, serializeASTPretty, traverseAST };

package/dist/index.js

@@ -6,6 +6,7 @@ var ExpressionKind = /* @__PURE__ */ ((ExpressionKind2) => {
   ExpressionKind2["Matrix"] = "matrix";
   ExpressionKind2["Text"] = "text";
   ExpressionKind2["Mixed"] = "mixed";
+  ExpressionKind2["Physics"] = "physics";
   return ExpressionKind2;
 })(ExpressionKind || {});
 var SymbolType = /* @__PURE__ */ ((SymbolType2) => {
@@ -467,7 +468,7 @@ var ExpressionClassifier = class {
   hasMathNodes(root) {
     return collectNodes(
       root,
-      (n) => ["frac", "script", "radical", "delimiter", "matrix", "accent", "largeop"].includes(n.kind)
+      (n) => ["frac", "script", "radical", "delimiter", "matrix", "accent", "largeop", "symbol", "group"].includes(n.kind)
     ).length > 0;
   }
   /**

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@sciexpr/core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Scientific Expression Engine - Core types, AST, schema and validators",
   "type": "module",
   "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
+      "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     }
   },