@sciexpr/parser 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,158 @@
+import { ExpressionRoot } from '@sciexpr/core';
+
+/** 解析器接口 */
+interface IParser {
+    /** 解析器唯一标识 */
+    readonly id: string;
+    /** 支持的语言/格式 */
+    readonly formats: string[];
+    /** 解析输入为 AST */
+    parse(input: string, options?: ParseOptions): ExpressionRoot;
+    /** 检测是否能解析该输入 */
+    canParse(input: string): boolean;
+}
+/** 解析选项 */
+interface ParseOptions {
+    /** 输入格式提示 */
+    hint?: 'latex' | 'chemical' | 'unicode' | 'auto';
+    /** 是否为 display 模式 */
+    displayMode?: boolean;
+    /** 自定义宏 */
+    macros?: Record<string, string>;
+    /** 严格模式（遇到未知命令是否报错） */
+    strict?: boolean;
+}
+/** Token 类型 */
+declare enum TokenType {
+    Command = "command",// \alpha, \frac, etc.
+    OpenBrace = "openBrace",// {
+    CloseBrace = "closeBrace",// }
+    OpenBracket = "openBracket",// [
+    CloseBracket = "closeBracket",
+    OpenParen = "openParen",// (
+    CloseParen = "closeParen",
+    Superscript = "superscript",// ^
+    Subscript = "subscript",// _
+    Whitespace = "whitespace",
+    Text = "text",// regular text
+    Number = "number",
+    Ampersand = "ampersand",// & (for matrices)
+    Newline = "newline",// \\
+    Dollar = "dollar",// $ (inline math delimiter)
+    DoubleDollar = "doubleDollar",// $$ (display math delimiter)
+    EOF = "eof"
+}
+/** Token 定义 */
+interface Token {
+    type: TokenType;
+    value: string;
+    position: number;
+    length: number;
+}
+
+/**
+ * LaTeX 词法分析器
+ * 将 LaTeX 源码分解为 token 流
+ */
+declare class LatexTokenizer {
+    private input;
+    private pos;
+    constructor(input: string);
+    /** 获取所有 token */
+    tokenize(): Token[];
+    /** 获取下一个 token */
+    private nextToken;
+}
+
+/**
+ * LaTeX 表达式解析器
+ *
+ * 支持的命令：
+ * - \frac{num}{den} — 分数
+ * - \sqrt[index]{radicand} — 根式
+ * - ^{sup} — 上标
+ * - _{sub} — 下标
+ * - \alpha, \beta, ... — 希腊字母
+ * - 括号匹配 ...
+ */
+declare class LatexParser implements IParser {
+    readonly id = "latex";
+    readonly formats: string[];
+    private tokens;
+    private pos;
+    private displayMode;
+    canParse(input: string): boolean;
+    parse(input: string, options?: ParseOptions): ExpressionRoot;
+    private parseExpressions;
+    private parseExpression;
+    /** 处理上/下标：检查 ^ 和 _ 后附加到 base 节点 */
+    private handleScripts;
+    private parseCommand;
+    /** 解析 {} 包裹的分组 */
+    private parseBraceGroup;
+    /** 解析 { expressions } 分组 */
+    private parseGroup;
+    /** 解析单个表达式（用于上/下标参数） */
+    private parseSingleExpression;
+    /** 解析上/下标内容 */
+    private parseScriptContent;
+    private peek;
+    private advance;
+    private skipType;
+    private isEOF;
+    /** 根据文本内容判断符号类型 */
+    private classifySymbol;
+}
+
+/**
+ * 化学式解析器
+ *
+ * 解析化学分子式和反应方程式。
+ * 支持格式：
+ * - H2O → 水
+ * - H2SO4 → 硫酸
+ * - NaCl → 食盐
+ * - Fe2O3 → 氧化铁
+ */
+declare class ChemicalParser implements IParser {
+    readonly id = "chemical";
+    readonly formats: string[];
+    canParse(input: string): boolean;
+    parse(input: string, _options?: ParseOptions): ExpressionRoot;
+    /**
+     * 解析化学式，如 "H2SO4" → [H, 2, S, O, 4]
+     */
+    private parseFormula;
+}
+
+/**
+ * Parser 注册表
+ *
+ * 管理所有解析器，支持自动检测和手动选择
+ */
+declare class ParserRegistry {
+    private parsers;
+    private defaultParsers;
+    constructor();
+    /** 注册自定义解析器 */
+    register(parser: IParser): void;
+    /** 移除解析器 */
+    unregister(id: string): boolean;
+    /** 根据 ID 获取解析器 */
+    get(id: string): IParser | undefined;
+    /**
+     * 自动检测并选择合适的解析器
+     */
+    find(input: string): IParser | null;
+    /**
+     * 解析输入
+     * @param input 输入文本
+     * @param options 解析选项
+     * @returns 解析后的 AST
+     */
+    parse(input: string, options?: ParseOptions): ExpressionRoot;
+    /** 列出所有已注册的解析器 ID */
+    list(): string[];
+}
+
+export { ChemicalParser, type IParser, LatexParser, LatexTokenizer, type ParseOptions, ParserRegistry, type Token, TokenType };

package/dist/index.d.ts

@@ -0,0 +1,158 @@
+import { ExpressionRoot } from '@sciexpr/core';
+
+/** 解析器接口 */
+interface IParser {
+    /** 解析器唯一标识 */
+    readonly id: string;
+    /** 支持的语言/格式 */
+    readonly formats: string[];
+    /** 解析输入为 AST */
+    parse(input: string, options?: ParseOptions): ExpressionRoot;
+    /** 检测是否能解析该输入 */
+    canParse(input: string): boolean;
+}
+/** 解析选项 */
+interface ParseOptions {
+    /** 输入格式提示 */
+    hint?: 'latex' | 'chemical' | 'unicode' | 'auto';
+    /** 是否为 display 模式 */
+    displayMode?: boolean;
+    /** 自定义宏 */
+    macros?: Record<string, string>;
+    /** 严格模式（遇到未知命令是否报错） */
+    strict?: boolean;
+}
+/** Token 类型 */
+declare enum TokenType {
+    Command = "command",// \alpha, \frac, etc.
+    OpenBrace = "openBrace",// {
+    CloseBrace = "closeBrace",// }
+    OpenBracket = "openBracket",// [
+    CloseBracket = "closeBracket",
+    OpenParen = "openParen",// (
+    CloseParen = "closeParen",
+    Superscript = "superscript",// ^
+    Subscript = "subscript",// _
+    Whitespace = "whitespace",
+    Text = "text",// regular text
+    Number = "number",
+    Ampersand = "ampersand",// & (for matrices)
+    Newline = "newline",// \\
+    Dollar = "dollar",// $ (inline math delimiter)
+    DoubleDollar = "doubleDollar",// $$ (display math delimiter)
+    EOF = "eof"
+}
+/** Token 定义 */
+interface Token {
+    type: TokenType;
+    value: string;
+    position: number;
+    length: number;
+}
+
+/**
+ * LaTeX 词法分析器
+ * 将 LaTeX 源码分解为 token 流
+ */
+declare class LatexTokenizer {
+    private input;
+    private pos;
+    constructor(input: string);
+    /** 获取所有 token */
+    tokenize(): Token[];
+    /** 获取下一个 token */
+    private nextToken;
+}
+
+/**
+ * LaTeX 表达式解析器
+ *
+ * 支持的命令：
+ * - \frac{num}{den} — 分数
+ * - \sqrt[index]{radicand} — 根式
+ * - ^{sup} — 上标
+ * - _{sub} — 下标
+ * - \alpha, \beta, ... — 希腊字母
+ * - 括号匹配 ...
+ */
+declare class LatexParser implements IParser {
+    readonly id = "latex";
+    readonly formats: string[];
+    private tokens;
+    private pos;
+    private displayMode;
+    canParse(input: string): boolean;
+    parse(input: string, options?: ParseOptions): ExpressionRoot;
+    private parseExpressions;
+    private parseExpression;
+    /** 处理上/下标：检查 ^ 和 _ 后附加到 base 节点 */
+    private handleScripts;
+    private parseCommand;
+    /** 解析 {} 包裹的分组 */
+    private parseBraceGroup;
+    /** 解析 { expressions } 分组 */
+    private parseGroup;
+    /** 解析单个表达式（用于上/下标参数） */
+    private parseSingleExpression;
+    /** 解析上/下标内容 */
+    private parseScriptContent;
+    private peek;
+    private advance;
+    private skipType;
+    private isEOF;
+    /** 根据文本内容判断符号类型 */
+    private classifySymbol;
+}
+
+/**
+ * 化学式解析器
+ *
+ * 解析化学分子式和反应方程式。
+ * 支持格式：
+ * - H2O → 水
+ * - H2SO4 → 硫酸
+ * - NaCl → 食盐
+ * - Fe2O3 → 氧化铁
+ */
+declare class ChemicalParser implements IParser {
+    readonly id = "chemical";
+    readonly formats: string[];
+    canParse(input: string): boolean;
+    parse(input: string, _options?: ParseOptions): ExpressionRoot;
+    /**
+     * 解析化学式，如 "H2SO4" → [H, 2, S, O, 4]
+     */
+    private parseFormula;
+}
+
+/**
+ * Parser 注册表
+ *
+ * 管理所有解析器，支持自动检测和手动选择
+ */
+declare class ParserRegistry {
+    private parsers;
+    private defaultParsers;
+    constructor();
+    /** 注册自定义解析器 */
+    register(parser: IParser): void;
+    /** 移除解析器 */
+    unregister(id: string): boolean;
+    /** 根据 ID 获取解析器 */
+    get(id: string): IParser | undefined;
+    /**
+     * 自动检测并选择合适的解析器
+     */
+    find(input: string): IParser | null;
+    /**
+     * 解析输入
+     * @param input 输入文本
+     * @param options 解析选项
+     * @returns 解析后的 AST
+     */
+    parse(input: string, options?: ParseOptions): ExpressionRoot;
+    /** 列出所有已注册的解析器 ID */
+    list(): string[];
+}
+
+export { ChemicalParser, type IParser, LatexParser, LatexTokenizer, type ParseOptions, ParserRegistry, type Token, TokenType };