meaoiu 0.1.0

package/dist/core/preprocessor.js

@@ -0,0 +1,187 @@
+// src/core/preprocessor.ts
+const fullWidthMap = {
+    // 数字
+    '０': '0',
+    '１': '1',
+    '２': '2',
+    '３': '3',
+    '４': '4',
+    '５': '5',
+    '６': '6',
+    '７': '7',
+    '８': '8',
+    '９': '9',
+    // 大写字母
+    Ａ: 'A',
+    Ｂ: 'B',
+    Ｃ: 'C',
+    Ｄ: 'D',
+    Ｅ: 'E',
+    Ｆ: 'F',
+    Ｇ: 'G',
+    Ｈ: 'H',
+    Ｉ: 'I',
+    Ｊ: 'J',
+    Ｋ: 'K',
+    Ｌ: 'L',
+    Ｍ: 'M',
+    Ｎ: 'N',
+    Ｏ: 'O',
+    Ｐ: 'P',
+    Ｑ: 'Q',
+    Ｒ: 'R',
+    Ｓ: 'S',
+    Ｔ: 'T',
+    Ｕ: 'U',
+    Ｖ: 'V',
+    Ｗ: 'W',
+    Ｘ: 'X',
+    Ｙ: 'Y',
+    Ｚ: 'Z',
+    // 小写字母
+    ａ: 'a',
+    ｂ: 'b',
+    ｃ: 'c',
+    ｄ: 'd',
+    ｅ: 'e',
+    ｆ: 'f',
+    ｇ: 'g',
+    ｈ: 'h',
+    ｉ: 'i',
+    ｊ: 'j',
+    ｋ: 'k',
+    ｌ: 'l',
+    ｍ: 'm',
+    ｎ: 'n',
+    ｏ: 'o',
+    ｐ: 'p',
+    ｑ: 'q',
+    ｒ: 'r',
+    ｓ: 's',
+    ｔ: 't',
+    ｕ: 'u',
+    ｖ: 'v',
+    ｗ: 'w',
+    ｘ: 'x',
+    ｙ: 'y',
+    ｚ: 'z',
+    // 标点符号
+    '！': '!',
+    '＂': '"',
+    '＃': '#',
+    '＄': '$',
+    '％': '%',
+    '＆': '&',
+    '＇': "'",
+    '（': '(',
+    '）': ')',
+    '＊': '*',
+    '＋': '+',
+    '，': ',',
+    '－': '-',
+    '．': '.',
+    '／': '/',
+    '：': ':',
+    '；': ';',
+    '＜': '<',
+    '＝': '=',
+    '＞': '>',
+    '？': '?',
+    '＠': '@',
+    '［': '[',
+    '＼': '\\',
+    '］': ']',
+    '＾': '^',
+    '＿': '_',
+    '｀': '`',
+    '｛': '{',
+    '｜': '|',
+    '｝': '}',
+    '～': '~',
+    '　': ' ',
+    // 常见中文排版符号
+    '【': '[',
+    '】': ']',
+    '「': "'",
+    '」': "'",
+    '『': '"',
+    '』': '"',
+    '《': '<',
+    '》': '>',
+    '〈': '<',
+    '〉': '>',
+    '。': '.',
+    '、': ',',
+    '‘': "'",
+    '’': "'",
+    '“': '"',
+    '”': '"',
+};
+export function preprocess(sourceCode) {
+    let result = '';
+    let state = 0 /* State.DEFAULT */;
+    let commentNesting = 0;
+    for (let i = 0; i < sourceCode.length; i++) {
+        const char = sourceCode[i];
+        const convertedChar = fullWidthMap[char] ?? char;
+        switch (state) {
+            case 0 /* State.DEFAULT */: {
+                // 根据转换后的字符来判断状态切换
+                if (convertedChar === "'") {
+                    state = 1 /* State.IN_SINGLE_QUOTE */;
+                }
+                else if (convertedChar === '"') {
+                    state = 2 /* State.IN_DOUBLE_QUOTE */;
+                }
+                else if (convertedChar === '(') {
+                    state = 3 /* State.IN_COMMENT */;
+                    commentNesting = 1;
+                }
+                // 在 DEFAULT 状态下，总是添加转换后的字符
+                result += convertedChar;
+                break;
+            }
+            case 1 /* State.IN_SINGLE_QUOTE */: {
+                if (convertedChar === "'") {
+                    state = 0 /* State.DEFAULT */;
+                    result += convertedChar; // 统一输出半宽
+                }
+                else {
+                    result += char; // 内部字符原样输出
+                }
+                break;
+            }
+            case 2 /* State.IN_DOUBLE_QUOTE */: {
+                if (convertedChar === '"') {
+                    state = 0 /* State.DEFAULT */;
+                    result += convertedChar; // 统一输出半宽
+                }
+                else {
+                    result += char; // 内部字符原样输出
+                }
+                break;
+            }
+            case 3 /* State.IN_COMMENT */: {
+                if (convertedChar === '(') {
+                    commentNesting++;
+                }
+                else if (convertedChar === ')') {
+                    commentNesting--;
+                }
+                if (commentNesting === 0) {
+                    state = 0 /* State.DEFAULT */;
+                    result += convertedChar; // 统一输出半宽
+                }
+                else {
+                    result += char; // 内部字符原样输出
+                }
+                break;
+            }
+            default:
+                const _s = state;
+                console.error('只是告诉你发生了奇怪的事情:', _s);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=preprocessor.js.map

package/dist/core/preprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocessor.js","sourceRoot":"","sources":["../../src/core/preprocessor.ts"],"names":[],"mappings":"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"}

package/dist/core/run/environment.d.ts

@@ -0,0 +1,43 @@
+import type * as AST from '../ast.js';
+import { type MeaoiuValue } from '../typedef.js';
+import { type Evaluated, type ReferenceLink } from './value.js';
+export declare const autoKey: (index: number) => string;
+export declare class Environment {
+    readonly id: number;
+    private readonly parent;
+    private readonly variables;
+    private readonly functions;
+    readonly orderedVariableNames: string[];
+    constructor(parent?: Environment);
+    static markReferenceMoved(ref: ReferenceLink): void;
+    static resolveValue(value: Evaluated): MeaoiuValue;
+    hasVariable(name: string): boolean;
+    /**
+     * 声明新变量（不包含赋值）。
+     */
+    declare(name: string): ReferenceLink;
+    /**
+     * 为已存在的变量赋值。
+     */
+    assign(name: string, value: Evaluated, operator: AST.AssignmentOperator): ReferenceLink;
+    lookup(name: string, originalName?: string, checkMoved?: boolean): ReferenceLink;
+    private findVariableScope;
+    declareFunction(name: string, func: AST.FunctionDeclaration): void;
+    findFunction(name: string): AST.FunctionDeclaration | undefined;
+    declareReference(name: string, targetScope: Environment, targetName: string): void;
+    createShallowCopy(): Environment;
+    /**
+     * 创建一个「合并视图」。
+     * 将创建一个新纸箱，该纸箱按顺序包含来自 A (this) 和 B (other) 的所有引用。
+     * 自动生成的键（}?{）会被重命名以保证顺序。
+     * 用户定义的键如果冲突，A 优先。
+     */
+    createMergedView(other: Environment): Environment;
+    /**
+     * 检查当前环境是否严格位于 ancestor 的「内部」。
+     */
+    isInsideOf(ancestor: Environment | undefined): boolean;
+    toString(): string;
+    get length(): number;
+}
+//# sourceMappingURL=environment.d.ts.map

package/dist/core/run/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/core/run/environment.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,GAAG,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAGN,KAAK,SAAS,EACd,KAAK,aAAa,EAGlB,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,WAAiB,CAAC;AAIvD,qBAAa,WAAW;IACvB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAC7E,SAAgB,oBAAoB,EAAE,MAAM,EAAE,CAAM;gBAExC,MAAM,CAAC,EAAE,WAAW;WAMlB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;WAI5C,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW;IAMlD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAQ3C;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,kBAAkB,GAAG,aAAa;IAwCvF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,GAAE,MAAa,EAAmB,UAAU,UAAO,GAAG,aAAa;IA4B3G,OAAO,CAAC,iBAAiB;IAIlB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,mBAAmB,GAAG,IAAI;IAIlE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,mBAAmB,GAAG,SAAS;IAI/D,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IASlF,iBAAiB,IAAI,WAAW;IASvC;;;;;OAKG;IACI,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW;IAsCxD;;OAEG;IACI,UAAU,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO;IAQtD,QAAQ,IAAI,MAAM;IAMzB,IAAW,MAAM,IAAI,MAAM,CAE1B;CACD"}

package/dist/core/run/environment.js

@@ -0,0 +1,192 @@
+// src/core/run/environment.ts
+import logger from '../run/logger.js';
+import { typeNames } from '../typedef.js';
+import { isReferenceLink, isSignal, } from './value.js';
+// 防碰撞自动变量名
+export const autoKey = (index) => `}${index}{`; // 使用不合语法的反花括号
+const isAutoKey = (key) => key[0] === '}' && key[key.length - 1] === '{';
+let envCounter = 0;
+export class Environment {
+    id;
+    parent;
+    variables = new Map();
+    functions = new Map();
+    orderedVariableNames = [];
+    constructor(parent) {
+        this.parent = parent;
+        this.id = envCounter++;
+        logger.debug(`[ENV] 新建环境 #${this.id} (上级: ${this.parent?.id ?? '无'})`);
+    }
+    static markReferenceMoved(ref) {
+        ref.scope.variables.get(ref.name).moved = true;
+    }
+    static resolveValue(value) {
+        if (isSignal(value))
+            throw new Error(`不能在这里发送神秘信号喵！`);
+        while (isReferenceLink(value))
+            value = value.scope.variables.get(value.name).value;
+        return value;
+    }
+    hasVariable(name) {
+        return this.variables.has(name);
+    }
+    /**
+     * 声明新变量（不包含赋值）。
+     */
+    declare(name) {
+        if (this.variables.has(name))
+            throw new Error(`变量「${name}」已经被“蹭”过一次了喵！`);
+        logger.debug(`[ENV #${this.id}] 声明: 变量「${name}」`);
+        this.variables.set(name, { value: null, moved: false });
+        this.orderedVariableNames.push(name);
+        return this.lookup(name);
+    }
+    /**
+     * 为已存在的变量赋值。
+     */
+    assign(name, value, operator) {
+        // 查找并追踪目标的最终存放位置
+        const initialTargetScope = this.findVariableScope(name);
+        if (!initialTargetScope)
+            throw new Error(`还不认识「${name}」喵！要先“蹭”一下喵！`);
+        let finalTargetScope = initialTargetScope;
+        let finalTargetName = name;
+        // 顺着引用链一直往下找，找到真正的「碗」
+        for (let targetVar; (targetVar = finalTargetScope.variables.get(finalTargetName)) && isReferenceLink(targetVar.value); { scope: finalTargetScope, name: finalTargetName } = targetVar.value)
+            ;
+        // 在最终位置赋值
+        let finalValue;
+        if (operator === 0 /* AssignmentOperator.REFERENCE */) {
+            finalValue =
+                isReferenceLink(value) &&
+                    (finalTargetScope !== value.scope || finalTargetName !== value.name) /* 防御循环引用 */
+                    ? value
+                    : Environment.resolveValue(value);
+        }
+        else {
+            finalValue = Environment.resolveValue(value);
+            if (operator === 2 /* AssignmentOperator.MOVE */) {
+                if (isReferenceLink(value))
+                    Environment.markReferenceMoved(value); // 引用被移动，标记为「已移动」
+            }
+            else if (operator === 1 /* AssignmentOperator.COPY */ && finalValue instanceof Environment) {
+                finalValue = finalValue.createShallowCopy(); // 复制一个纸箱，实际上是创建一个「视图」
+            }
+        }
+        finalTargetScope.variables.set(finalTargetName, { value: finalValue, moved: false });
+        logger.debug(`[ENV #${this.id}] 赋值: 环境 #${finalTargetScope.id} 中的「${finalTargetName}」被赋予 (方式: ${operator}) 值:`, finalValue);
+        return finalTargetScope.lookup(finalTargetName);
+    }
+    lookup(name, originalName = name /* 未定源时为第一环查询 */, checkMoved = true) {
+        // 查找符号
+        const scope = this.findVariableScope(name);
+        if (!scope) {
+            const errorMessage = this.findFunction(name)
+                ? `是不是想把${typeNames[4 /* MeaoiuType.FUNCTION */]}「${name}」当成玩具喵？`
+                : `没找到叫做「${name}」的玩具，是不是被你藏起来了喵？`;
+            throw new Error(`咦？${errorMessage}`);
+        }
+        const { value, moved } = scope.variables.get(name);
+        // 检查「已移动」状态
+        if (moved && checkMoved) {
+            const errorMessage = isAutoKey(originalName)
+                ? `纸箱里的「${this.orderedVariableNames.indexOf(originalName) + 1}」号玩具不见了，一定是被谁拿走了喵！`
+                : originalName === name
+                    ? `藏在「${originalName}」里的东西被拿走了，现在是只空碗喵！`
+                    : `碰不到「${originalName}」，因为它的本体「${name}」被拿走了喵！`; // 起终点不一致，报告起终点
+            throw new Error(`喵呜！${errorMessage}`);
+        }
+        logger.debug(`[ENV #${this.id}] 查找: 在环境 #${scope.id} 中找到「${name}」`);
+        // 递归查找（继续传递 originalName）
+        if (isReferenceLink(value))
+            return value.scope.lookup(value.name, originalName, checkMoved);
+        return { isReference: true, scope, name };
+    }
+    findVariableScope(name) {
+        return this.variables.has(name) ? this : this.parent?.findVariableScope(name);
+    }
+    declareFunction(name, func) {
+        this.functions.set(name, func);
+    }
+    findFunction(name) {
+        return this.functions.get(name) ?? this.parent?.findFunction(name);
+    }
+    declareReference(name, targetScope, targetName) {
+        if (this.variables.has(name))
+            throw new Error(`已经“蹭”过一次「${name}」了喵！`);
+        this.variables.set(name, {
+            value: { isReference: true, scope: targetScope, name: targetName },
+            moved: false,
+        });
+        this.orderedVariableNames.push(name); // 确保引用也被添加到有序列表中
+    }
+    createShallowCopy() {
+        const newEnv = new Environment(this.parent);
+        for (const varName of this.orderedVariableNames) {
+            const originalVarRef = this.lookup(varName, undefined, false);
+            newEnv.declareReference(varName, originalVarRef.scope, originalVarRef.name);
+        }
+        return newEnv;
+    }
+    /**
+     * 创建一个「合并视图」。
+     * 将创建一个新纸箱，该纸箱按顺序包含来自 A (this) 和 B (other) 的所有引用。
+     * 自动生成的键（}?{）会被重命名以保证顺序。
+     * 用户定义的键如果冲突，A 优先。
+     */
+    createMergedView(other) {
+        const newEnv = new Environment(this.parent);
+        const addedKeys = new Set();
+        let autoIndexCounter = 0; // 为新视图创建全新的自动索引
+        // 1. 添加来自 A (this) 的所有引用
+        for (const varName of this.orderedVariableNames) {
+            const originalVarRef = this.lookup(varName, undefined, false);
+            if (isAutoKey(varName)) {
+                // 重命名自动键
+                const newAutoKey = autoKey(autoIndexCounter++);
+                newEnv.declareReference(newAutoKey, originalVarRef.scope, originalVarRef.name);
+            }
+            else {
+                // 添加用户定义的键
+                newEnv.declareReference(varName, originalVarRef.scope, originalVarRef.name);
+                addedKeys.add(varName);
+            }
+        }
+        // 2. 添加来自 B (other) 的引用
+        for (const varName of other.orderedVariableNames) {
+            const originalVarRef = other.lookup(varName, undefined, false);
+            if (isAutoKey(varName)) {
+                // 总是添加并重命名自动键
+                const newAutoKey = autoKey(autoIndexCounter++);
+                newEnv.declareReference(newAutoKey, originalVarRef.scope, originalVarRef.name);
+            }
+            else if (!addedKeys.has(varName)) {
+                // 用户定义的键，检查冲突
+                newEnv.declareReference(varName, originalVarRef.scope, originalVarRef.name);
+                addedKeys.add(varName);
+            }
+        }
+        return newEnv;
+    }
+    /**
+     * 检查当前环境是否严格位于 ancestor 的「内部」。
+     */
+    isInsideOf(ancestor) {
+        if (!ancestor)
+            return false;
+        for (let current = this; current; current = current.parent) {
+            if (current === ancestor)
+                return true;
+        }
+        return false;
+    }
+    toString() {
+        return `[= ${this.orderedVariableNames
+            .map((name, index) => (isAutoKey(name) ? `(${index + 1})` : `{${name}}`))
+            .join(', ')} =]`;
+    }
+    get length() {
+        return this.orderedVariableNames.length;
+    }
+}
+//# sourceMappingURL=environment.js.map

package/dist/core/run/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/core/run/environment.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAI9B,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAc,SAAS,EAAoB,MAAM,eAAe,CAAC;AACxE,OAAO,EACN,eAAe,EACf,QAAQ,GAKR,MAAM,YAAY,CAAC;AAEpB,WAAW;AACX,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,cAAc;AACtE,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;AAEjF,IAAI,UAAU,GAAG,CAAC,CAAC;AACnB,MAAM,OAAO,WAAW;IACP,EAAE,CAAS;IACV,MAAM,CAA0B;IAChC,SAAS,GAA6B,IAAI,GAAG,EAAE,CAAC;IAChD,SAAS,GAAyC,IAAI,GAAG,EAAE,CAAC;IAC7D,oBAAoB,GAAa,EAAE,CAAC;IAEpD,YAAY,MAAoB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,EAAE,SAAS,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;IACxE,CAAC;IAEM,MAAM,CAAC,kBAAkB,CAAC,GAAkB;QAClD,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,KAAK,GAAG,IAAI,CAAC;IACjD,CAAC;IAEM,MAAM,CAAC,YAAY,CAAC,KAAgB;QAC1C,IAAI,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACtD,OAAO,eAAe,CAAC,KAAK,CAAC;YAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,KAAK,CAAC;QACpF,OAAO,KAAK,CAAC;IACd,CAAC;IAEM,WAAW,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,IAAY;QAC1B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC;QACzE,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,YAAY,IAAI,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,IAAY,EAAE,KAAgB,EAAE,QAAgC;QAC7E,iBAAiB;QACjB,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,kBAAkB;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,cAAc,CAAC,CAAC;QAErE,IAAI,gBAAgB,GAAG,kBAAkB,CAAC;QAC1C,IAAI,eAAe,GAAG,IAAI,CAAC;QAE3B,sBAAsB;QACtB,KACC,IAAI,SAAkC,EACtC,CAAC,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,EACjG,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC,KAAK;YACpE,CAAC;QAEF,UAAU;QACV,IAAI,UAAyB,CAAC;QAC9B,IAAI,QAAQ,yCAAiC,EAAE,CAAC;YAC/C,UAAU;gBACT,eAAe,CAAC,KAAK,CAAC;oBACtB,CAAC,gBAAgB,KAAK,KAAK,CAAC,KAAK,IAAI,eAAe,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,YAAY;oBAChF,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACP,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC7C,IAAI,QAAQ,oCAA4B,EAAE,CAAC;gBAC1C,IAAI,eAAe,CAAC,KAAK,CAAC;oBAAE,WAAW,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB;YACrF,CAAC;iBAAM,IAAI,QAAQ,oCAA4B,IAAI,UAAU,YAAY,WAAW,EAAE,CAAC;gBACtF,UAAU,GAAG,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC,sBAAsB;YACpE,CAAC;QACF,CAAC;QACD,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,KAAK,CACX,SAAS,IAAI,CAAC,EAAE,aAAa,gBAAgB,CAAC,EAAE,OAAO,eAAe,aAAa,QAAQ,MAAM,EACjG,UAAU,CACV,CAAC;QAEF,OAAO,gBAAgB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACjD,CAAC;IAEM,MAAM,CAAC,IAAY,EAAE,eAAuB,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,IAAI;QAC1F,OAAO;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;gBAC3C,CAAC,CAAC,QAAQ,SAAS,6BAAqB,IAAI,IAAI,SAAS;gBACzD,CAAC,CAAC,SAAS,IAAI,kBAAkB,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QAEpD,YAAY;QACZ,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;YACzB,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC;gBAC3C,CAAC,CAAC,QAAQ,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,oBAAoB;gBACjF,CAAC,CAAC,YAAY,KAAK,IAAI;oBACtB,CAAC,CAAC,MAAM,YAAY,oBAAoB;oBACxC,CAAC,CAAC,OAAO,YAAY,YAAY,IAAI,SAAS,CAAC,CAAC,eAAe;YACjE,MAAM,IAAI,KAAK,CAAC,MAAM,YAAY,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,cAAc,KAAK,CAAC,EAAE,QAAQ,IAAI,GAAG,CAAC,CAAC;QAEpE,0BAA0B;QAC1B,IAAI,eAAe,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;QAE5F,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IAEO,iBAAiB,CAAC,IAAY;QACrC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC/E,CAAC;IAEM,eAAe,CAAC,IAAY,EAAE,IAA6B;QACjE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAEM,YAAY,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAEM,gBAAgB,CAAC,IAAY,EAAE,WAAwB,EAAE,UAAkB;QACjF,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,MAAM,CAAC,CAAC;QACtE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE;YACxB,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE;YAClE,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB;IACxD,CAAC;IAEM,iBAAiB;QACvB,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACjD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAC9D,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACI,gBAAgB,CAAC,KAAkB;QACzC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,IAAI,gBAAgB,GAAG,CAAC,CAAC,CAAC,gBAAgB;QAE1C,yBAAyB;QACzB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACjD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAE9D,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,SAAS;gBACT,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBAC/C,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;YAChF,CAAC;iBAAM,CAAC;gBACP,WAAW;gBACX,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;gBAC5E,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;QACF,CAAC;QAED,wBAAwB;QACxB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;YAClD,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAE/D,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,cAAc;gBACd,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBAC/C,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;YAChF,CAAC;iBAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpC,cAAc;gBACd,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;gBAC5E,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;QACF,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,QAAiC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,KAAK,IAAI,OAAO,GAA4B,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACrF,IAAI,OAAO,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;QACvC,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAEM,QAAQ;QACd,OAAO,MAAM,IAAI,CAAC,oBAAoB;aACpC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;aACxE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,IAAW,MAAM;QAChB,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC;IACzC,CAAC;CACD"}

package/dist/core/run/interpreter.d.ts

@@ -0,0 +1,13 @@
+import type * as AST from '../ast.js';
+import { type MeaoiuBuiltIns } from '../builtIns.js';
+import { Environment } from './environment.js';
+import { type Evaluated } from './value.js';
+type BoundaryEnv = Partial<Record<(AST.ReturnStatement | AST.AmbushStatement)['kind'], Environment>>;
+declare const enum NewEnvMode {
+    NORMAL = 0,
+    FUNC = 1,
+    LOOP = 2
+}
+export declare function evaluate(node: AST.Node, env: Environment, builtIns: MeaoiuBuiltIns, boundaryEnv: BoundaryEnv, newEnvMode?: NewEnvMode): Promise<Evaluated>;
+export {};
+//# sourceMappingURL=interpreter.d.ts.map

package/dist/core/run/interpreter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpreter.d.ts","sourceRoot":"","sources":["../../../src/core/run/interpreter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,GAAG,MAAM,WAAW,CAAC;AAEtC,OAAO,EAA8C,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAWjG,OAAO,EAAW,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAIN,KAAK,SAAS,EAMd,MAAM,YAAY,CAAC;AAEpB,KAAK,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;AACrG,mBAAW,UAAU;IACpB,MAAM,IAAA;IACN,IAAI,IAAA;IACJ,IAAI,IAAA;CACJ;AAmBD,wBAAsB,QAAQ,CAC7B,IAAI,EAAE,GAAG,CAAC,IAAI,EACd,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,UAA8B,GACxC,OAAO,CAAC,SAAS,CAAC,CAwXpB"}