a-calc 3.0.0-beta.20260130.1 → 3.0.0-beta.20260201.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "a-calc",
-    "version": "3.0.0-beta.20260130.1",
+    "version": "3.0.0-beta.20260201.1",
     "description": "A very powerful and easy-to-use number precision calculation and formatting library.",
     "main": "./cjs/index.js",
     "exports": {
@@ -19,7 +19,8 @@
             "require": "./cjs/index.js",
             "default": "./cjs/index.js"
         },
-        "./mcp-server/src/index.js": "./mcp-server/src/index.js"
+        "./mcp-server/src/index.js": "./mcp-server/src/index.js",
+        "./ts-plugin": "./ts-plugin/dist/index.js"
     },
     "browser": "browser/index.js",
     "module": "es/index.js",
@@ -51,7 +52,8 @@
         "a-calc.versions.js",
         "mcp-server/src",
         "mcp-server/package.json",
-        "mcp-server/README.md"
+        "mcp-server/README.md",
+        "ts-plugin/dist"
     ],
     "repository": {
         "type": "git",
@@ -101,6 +103,7 @@
         "@rollup/plugin-json": "^6.0.1",
         "@rollup/plugin-node-resolve": "^15.2.3",
         "@rollup/plugin-terser": "^0.4.4",
+        "@uiw/codemirror-themes-all": "^4.25.4",
         "@vitest/coverage-v8": "^2.1.9",
         "a-calc": "^2.2.15",
         "benchmark": "^2.1.4",
@@ -122,11 +125,10 @@
         "typescript": "^5.1.6",
         "vitepress": "^1.6.4",
         "vitest": "^2.1.0",
-        "vue": "^3.5.25",
-        "@uiw/codemirror-themes-all": "^4.25.4"
+        "vue": "^3.5.25"
     },
     "dependencies": {
-        "typescript-treasure": "0.0.9",
-        "@modelcontextprotocol/sdk": "^1.0.0"
+        "@modelcontextprotocol/sdk": "^1.0.0",
+        "typescript-treasure": "0.0.9"
     }
 }

package/ts-plugin/dist/config_extractor.d.ts

@@ -0,0 +1,9 @@
+import type * as ts from 'typescript/lib/tsserverlibrary';
+/**
+ * 从项目中提取 set_config 配置的类型信息
+ */
+export declare function extract_config_from_project(ts_module: typeof ts, program: ts.Program, logger: ts.server.Logger): ExtractedConfig;
+export interface ExtractedConfig {
+    units: string[];
+    shortcut_prefix: string;
+}

package/ts-plugin/dist/config_extractor.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extract_config_from_project = void 0;
+/**
+ * 从项目中提取 set_config 配置的类型信息
+ */
+function extract_config_from_project(ts_module, program, logger) {
+    const result = {
+        units: [],
+        shortcut_prefix: '!u',
+    };
+    const type_checker = program.getTypeChecker();
+    for (const source_file of program.getSourceFiles()) {
+        // 跳过 node_modules
+        if (source_file.fileName.includes('node_modules'))
+            continue;
+        visit_node(ts_module, source_file, type_checker, result, logger);
+    }
+    return result;
+}
+exports.extract_config_from_project = extract_config_from_project;
+function visit_node(ts_module, node, type_checker, result, logger) {
+    // 查找 set_config 调用
+    if (ts_module.isCallExpression(node)) {
+        const func_name = get_call_name(ts_module, node);
+        if (func_name === 'set_config' && node.arguments.length > 0) {
+            const arg = node.arguments[0];
+            extract_from_config_arg(ts_module, arg, type_checker, result, logger);
+        }
+    }
+    ts_module.forEachChild(node, child => {
+        visit_node(ts_module, child, type_checker, result, logger);
+    });
+}
+function get_call_name(ts_module, node) {
+    if (ts_module.isIdentifier(node.expression)) {
+        return node.expression.text;
+    }
+    return undefined;
+}
+function extract_from_config_arg(ts_module, arg, type_checker, result, logger) {
+    const type = type_checker.getTypeAtLocation(arg);
+    const properties = type.getProperties();
+    for (const prop of properties) {
+        const prop_name = prop.getName();
+        if (prop_name === '_unit_convert_out') {
+            extract_units_from_convert_out(ts_module, prop, type_checker, result, logger);
+        }
+        else if (prop_name === '_unit_convert_in') {
+            extract_units_from_convert_in(ts_module, prop, type_checker, result, logger);
+        }
+        else if (prop_name === '_shortcut_prefix') {
+            extract_shortcut_prefix(ts_module, prop, type_checker, result, logger);
+        }
+    }
+}
+function extract_units_from_convert_out(ts_module, prop, type_checker, result, logger) {
+    const prop_type = type_checker.getTypeOfSymbolAtLocation(prop, prop.valueDeclaration);
+    // 获取 _unit_convert_out 对象的所有 key
+    const unit_props = prop_type.getProperties();
+    for (const unit_prop of unit_props) {
+        const unit_name = unit_prop.getName();
+        if (!result.units.includes(unit_name)) {
+            result.units.push(unit_name);
+        }
+    }
+    logger.info(`a-calc-ts-plugin: extracted units from _unit_convert_out = ${result.units.join(', ')}`);
+}
+function extract_units_from_convert_in(ts_module, prop, type_checker, result, logger) {
+    const prop_type = type_checker.getTypeOfSymbolAtLocation(prop, prop.valueDeclaration);
+    // _unit_convert_in 结构: { 输入单位: { 输出单位: 转换规则 } }
+    // 需要提取输出单位（内层的 key）
+    const input_unit_props = prop_type.getProperties();
+    for (const input_prop of input_unit_props) {
+        const input_type = type_checker.getTypeOfSymbolAtLocation(input_prop, input_prop.valueDeclaration);
+        // 获取内层的输出单位
+        const output_props = input_type.getProperties();
+        for (const output_prop of output_props) {
+            const unit_name = output_prop.getName();
+            if (!result.units.includes(unit_name)) {
+                result.units.push(unit_name);
+            }
+        }
+    }
+    logger.info(`a-calc-ts-plugin: extracted units from _unit_convert_in = ${result.units.join(', ')}`);
+}
+function extract_shortcut_prefix(ts_module, prop, type_checker, result, logger) {
+    const prop_type = type_checker.getTypeOfSymbolAtLocation(prop, prop.valueDeclaration);
+    // 尝试获取字符串字面量类型的值
+    if (prop_type.isStringLiteral()) {
+        result.shortcut_prefix = prop_type.value;
+        logger.info(`a-calc-ts-plugin: shortcut_prefix (literal) = ${result.shortcut_prefix}`);
+        return;
+    }
+    // 尝试从声明中直接获取值
+    const decl = prop.valueDeclaration;
+    if (decl && ts_module.isPropertyAssignment(decl)) {
+        const init = decl.initializer;
+        if (ts_module.isStringLiteral(init)) {
+            result.shortcut_prefix = init.text;
+            logger.info(`a-calc-ts-plugin: shortcut_prefix (init) = ${result.shortcut_prefix}`);
+        }
+    }
+}

package/ts-plugin/dist/constants.d.ts

@@ -0,0 +1,34 @@
+/**
+ * a-calc ! 系统预设
+ */
+export declare const ACALC_PRESETS: {
+    name: string;
+    description: string;
+    has_value: boolean;
+    value_required: boolean;
+    example: string;
+}[];
+/**
+ * 千分位预设值
+ */
+export declare const THOUSANDS_PRESETS: {
+    name: string;
+    description: string;
+}[];
+/**
+ * 紧凑格式预设值
+ */
+export declare const COMPACT_PRESETS: {
+    name: string;
+    description: string;
+}[];
+/**
+ * 格式化语法列表（用于 | 后的补全）
+ * insert_text: 实际插入的文本（不含占位符）
+ */
+export declare const FORMAT_SYNTAX: {
+    name: string;
+    insert_text: string;
+    description: string;
+    example: string;
+}[];

package/ts-plugin/dist/constants.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORMAT_SYNTAX = exports.COMPACT_PRESETS = exports.THOUSANDS_PRESETS = exports.ACALC_PRESETS = void 0;
+/**
+ * a-calc ! 系统预设
+ */
+exports.ACALC_PRESETS = [
+    {
+        name: 't',
+        description: '千分位预设',
+        has_value: true,
+        value_required: false,
+        example: '!t 或 !t:indian'
+    },
+    {
+        name: 'c',
+        description: '紧凑格式',
+        has_value: true,
+        value_required: false,
+        example: '!c 或 !c:cn'
+    },
+    {
+        name: 'i',
+        description: '整数补零',
+        has_value: true,
+        value_required: true,
+        example: '!i:3'
+    },
+    {
+        name: 'g',
+        description: '格式化分组',
+        has_value: true,
+        value_required: true,
+        example: '!g:money'
+    },
+    {
+        name: 'u',
+        description: '单位（默认位置）',
+        has_value: true,
+        value_required: true,
+        example: '!u:元'
+    },
+    {
+        name: 'ua',
+        description: '单位在数字后',
+        has_value: true,
+        value_required: true,
+        example: '!ua:元'
+    },
+    {
+        name: 'ub',
+        description: '单位在数字前',
+        has_value: true,
+        value_required: true,
+        example: '!ub:$'
+    },
+    {
+        name: 'um',
+        description: '单位在符号后',
+        has_value: true,
+        value_required: true,
+        example: '!um:元'
+    },
+    {
+        name: 'uh',
+        description: '转换但隐藏单位',
+        has_value: true,
+        value_required: false,
+        example: '!uh 或 !uh:元'
+    },
+];
+/**
+ * 千分位预设值
+ */
+exports.THOUSANDS_PRESETS = [
+    { name: 'en', description: '英文/国际 (1,234,567)' },
+    { name: 'eu', description: '欧洲 (1.234.567)' },
+    { name: 'swiss', description: "瑞士 (1'234'567)" },
+    { name: 'space', description: '空格分隔 (1 234 567)' },
+    { name: 'fr', description: '法国 (1 234 567,89)' },
+    { name: 'indian', description: '印度 (12,34,567)' },
+    { name: 'wan', description: '万进制 (1234,5678)' },
+];
+/**
+ * 紧凑格式预设值
+ */
+exports.COMPACT_PRESETS = [
+    { name: 'en', description: '英文 (K/M/B/T)' },
+    { name: 'cn', description: '中文千进制 (千/百万/十亿)' },
+    { name: 'wan', description: '万进制 (万/亿)' },
+    { name: 'storage', description: '存储单位 (KB/MB/GB)' },
+    { name: 'indian', description: '印度 (K/L/Cr)' },
+];
+/**
+ * 格式化语法列表（用于 | 后的补全）
+ * insert_text: 实际插入的文本（不含占位符）
+ */
+exports.FORMAT_SYNTAX = [
+    // 小数位控制
+    {
+        name: '=N',
+        insert_text: '=',
+        description: '精确 N 位小数',
+        example: '=2 → 1.50',
+    },
+    {
+        name: '<=N',
+        insert_text: '<=',
+        description: '最多 N 位小数（不补零）',
+        example: '<=2 → 1.5',
+    },
+    {
+        name: '>=N',
+        insert_text: '>=',
+        description: '最少 N 位小数（补零）',
+        example: '>=3 → 1.500',
+    },
+    {
+        name: '>=N<=M',
+        insert_text: '>=',
+        description: '小数位数范围',
+        example: '>=2<=4 → 1.5 ~ 1.5000',
+    },
+    // 舍入规则
+    {
+        name: '~5',
+        insert_text: '~5',
+        description: '四舍五入',
+        example: '~5=2: 1.125 → 1.13',
+    },
+    {
+        name: '~6',
+        insert_text: '~6',
+        description: '银行家舍入（四舍六入五取偶）',
+        example: '~6=2: 1.125 → 1.12',
+    },
+    {
+        name: '~+',
+        insert_text: '~+',
+        description: '进位（向上取整）',
+        example: '~+=2: 1.121 → 1.13',
+    },
+    {
+        name: '~-',
+        insert_text: '~-',
+        description: '截断（向下取整，默认）',
+        example: '~-=2: 1.129 → 1.12',
+    },
+    // 千分位
+    {
+        name: ',',
+        insert_text: ',',
+        description: '千分位分隔',
+        example: '1234567 → 1,234,567',
+    },
+    {
+        name: '!t',
+        insert_text: '!t',
+        description: '千分位（默认预设）',
+        example: '1234567 → 1,234,567',
+    },
+    {
+        name: '!t:preset',
+        insert_text: '!t:',
+        description: '千分位预设',
+        example: '!t:indian → 12,34,567',
+    },
+    // 紧凑格式
+    {
+        name: '!c',
+        insert_text: '!c',
+        description: '紧凑格式（默认 K/M/B/T）',
+        example: '1500 → 1.5K',
+    },
+    {
+        name: '!c:preset',
+        insert_text: '!c:',
+        description: '紧凑格式预设',
+        example: '!c:wan → 1万',
+    },
+    // 百分比
+    {
+        name: '%',
+        insert_text: '%',
+        description: '百分比格式',
+        example: '0.1234 → 12.34%',
+    },
+    // 正负号
+    {
+        name: '+',
+        insert_text: '+',
+        description: '显示正号',
+        example: '100 → +100',
+    },
+    // 整数补零
+    {
+        name: '!i:N',
+        insert_text: '!i:',
+        description: '整数部分补零到 N 位',
+        example: '!i:3: 5 → 005',
+    },
+    // 科学计数法
+    {
+        name: '!e',
+        insert_text: '!e',
+        description: '科学计数法',
+        example: '123456789 → 1.23e+8',
+    },
+    // 分数
+    {
+        name: '/',
+        insert_text: '/',
+        description: '分数形式',
+        example: '0.5 → 1/2',
+    },
+    // 返回类型
+    {
+        name: '!n',
+        insert_text: '!n',
+        description: '返回数字类型',
+        example: '"3" → 3 (number)',
+    },
+    {
+        name: '!s',
+        insert_text: '!s',
+        description: '返回字符串类型（默认）',
+        example: '3 → "3" (string)',
+    },
+    // 单位
+    {
+        name: '!u:unit',
+        insert_text: '!u:',
+        description: '单位（默认位置）',
+        example: '!u:元 → 100元',
+    },
+    {
+        name: '!ua:unit',
+        insert_text: '!ua:',
+        description: '单位在数字后',
+        example: '!ua:$ → 100$',
+    },
+    {
+        name: '!ub:unit',
+        insert_text: '!ub:',
+        description: '单位在数字前',
+        example: '!ub:$ → $100',
+    },
+    {
+        name: '!um:unit',
+        insert_text: '!um:',
+        description: '单位在符号后',
+        example: '!um:$ → +$100',
+    },
+    {
+        name: '!uh:unit',
+        insert_text: '!uh:',
+        description: '转换但隐藏单位',
+        example: '!uh:元 → 100',
+    },
+    // 范围限制
+    {
+        name: '[min,max]',
+        insert_text: '[',
+        description: '范围限制',
+        example: '[0,100]: 150 → 100',
+    },
+    // 格式化分组
+    {
+        name: '!g:name',
+        insert_text: '!g:',
+        description: '格式化分组',
+        example: '!g:money → 预设格式',
+    },
+];

package/ts-plugin/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type * as ts from 'typescript/lib/tsserverlibrary';
+declare function init(modules: {
+    typescript: typeof ts;
+}): {
+    create: (info: ts.server.PluginCreateInfo) => ts.LanguageService;
+};
+export = init;