@mbler/mcx-core 0.0.4-beta → 0.0.5-alpha.r20260410.1

package/README.md

@@ -1,22 +1,5 @@
 # mcx
 
-mcx-core 是 mbler 的 mcx 功能的编译器核心，目前在 alpha 阶段。  
+## This is a DSL for build minecraft bedrock script
 
-本工具基于 typescript 开发，底层模块加载由 rollup 支持由工具 mbler 串起编译流程。  
-## 整体架构
-
-| **npm包名**             | **描述**                       | **完成度(%)** |
-|-----------------------|------------------------------|---------|
-| **@mbler/mcx**        |  为用户提供的typescript类型包         | 0       |
-| **@mbler/mcx-core**   | mcx核心编译器啥的代码                 | 10      |
-| **@mbler/mcx-types**  | 提供类型 | 10 |
-| **@mbler/mcx-compat** | mcx检查器规则，主要适配不一样的minecraft版本 | 0       |
-| **mbler**             | 核心脚手架，把这些东西组装成一个方便使用的cli工具   | 90      |
-
-## 加入开发
-
-前往作者QQ : 3915264929
-
-## 文档（没写完）
-
-**[这里](https://mbler-docs.ruanhor.dpdns.org/guide/mcx)**
+Docs **[see this](https://mbler-docs.ruanhor.dpdns.org/guide/mcx)**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mbler/mcx-core",
-  "version": "0.0.4-beta",
+  "version": "0.0.5-alpha.r20260410.1",
   "description": "a DSL compiler of mcx",
   "main": "dist/index.js",
   "scripts": {

package/dist/index.d.ts

@@ -1,325 +0,0 @@
-import { TransformPluginContext, Plugin } from 'rollup';
-import * as t from '@babel/types';
-import { Expression, CallExpression, SpreadElement, ArgumentPlaceholder, ImportDeclaration, ExportNamedDeclaration, ExportAllDeclaration, ExportDefaultDeclaration } from '@babel/types';
-import { CompileOpt } from '@mbler/mcx-types';
-import { VirtualCode, CodeMapping, LanguagePlugin } from '@volar/language-core';
-import * as ts from 'typescript';
-import { URI } from 'vscode-uri';
-
-interface callList {
-    source: Expression;
-    set: (callEXp: CallExpression) => boolean;
-    arguments: Array<SpreadElement | Expression | ArgumentPlaceholder>;
-    remove: () => void;
-}
-interface ImportListImport {
-    isAll: boolean;
-    import?: string | undefined;
-    as: string;
-}
-interface ImportList {
-    source: string;
-    imported: ImportListImport[];
-    raw?: ImportDeclaration;
-}
-interface BuildCache {
-    call: callList[];
-    import: ImportList[];
-    export: Array<ExportNamedDeclaration | ExportAllDeclaration | ExportDefaultDeclaration>;
-}
-declare const _MCXstructureLocComponentTypes: {
-    readonly items: "item";
-    readonly blocks: "block";
-    readonly entities: "entity";
-};
-type MCXstructureLocComponentType = typeof _MCXstructureLocComponentTypes[keyof typeof _MCXstructureLocComponentTypes];
-interface MCXstructureLoc {
-    script: string;
-    Event: {
-        on: "after" | "before";
-        subscribe: Record<string, string>;
-        loc: {
-            line: number;
-            column: number;
-        };
-        isLoad: boolean;
-    };
-    Component: Record<string, {
-        type: MCXstructureLocComponentType;
-        useExpore: string;
-        loc: {
-            line: number;
-            column: number;
-        };
-    }>;
-    UI: ParsedTagNode | null;
-}
-
-declare class JsCompileData {
-    node: t.Program;
-    BuildCache: BuildCache;
-    File: string;
-    isFile: boolean;
-    constructor(node: t.Program, BuildCache?: BuildCache);
-    setFilePath(dir: string): void;
-}
-declare class MCXCompileData {
-    raw: ParsedTagNode[];
-    JSIR: JsCompileData;
-    strLoc: MCXstructureLoc;
-    File: string;
-    isFile: boolean;
-    constructor(raw: ParsedTagNode[], JSIR: JsCompileData, strLoc: MCXstructureLoc);
-    setFilePath(dir: string): void;
-}
-
-interface BaseToken {
-    data: string;
-    type: TokenType;
-    start: MCXPosition;
-    end: MCXPosition;
-}
-interface TagToken extends BaseToken {
-    type: 'Tag';
-}
-interface TagEndToken extends BaseToken {
-    type: 'TagEnd';
-}
-interface ContentToken extends BaseToken {
-    type: 'Content';
-}
-type Token = TagToken | TagEndToken | ContentToken;
-type AttributeMap = Record<string, string | boolean>;
-/** 统一的位置信息结构 */
-interface MCXPosition {
-    line: number;
-    column: number;
-}
-interface MCXLoc {
-    start: MCXPosition;
-    end: MCXPosition;
-}
-interface ParsedTagNode {
-    start: TagToken;
-    name: string;
-    arr: AttributeMap;
-    content: (ParsedTagContentNode | ParsedTagNode)[];
-    end: TagEndToken | null;
-    loc: MCXLoc;
-    type: "TagNode";
-}
-interface ParsedTagContentNode {
-    data: string;
-    type: 'TagContent';
-}
-type TokenType = 'Tag' | 'TagEnd' | 'Content';
-type PropValue = number | string | object;
-interface PropNode {
-    key: string;
-    value: PropValue;
-    type: "PropChar" | "PropObject";
-}
-type JsType = "boolean" | "number" | "string" | "object" | "function" | "bigint" | "symbol";
-interface TypeVerifyBody {
-    [key: string]: JsType;
-}
-interface ParseReadFileOpt {
-    delay: number;
-    maxRetries: number;
-    want: 'string' | 'object';
-}
-type ReadFileOpt = Partial<ParseReadFileOpt>;
-type mcxType = "component" | "event" | "app" | "ui";
-
-interface transformCtx {
-    rollupContext: TransformPluginContext;
-    compiledCode: MCXCompileData;
-    cache: Map<string, MCXCompileData>;
-    currentId: string;
-    scriptTag: ParsedTagNode;
-    currentAST: t.Program;
-    mainFn: {
-        param: t.FunctionParameter[];
-        body: t.Statement[];
-    };
-    impAST: t.ImportDeclaration[];
-    opt: CompileOpt;
-}
-interface transformParseCtx {
-    prop: t.ObjectProperty[];
-    impBody: t.ImportDeclaration[];
-    mainFn: t.Statement[];
-    ctx: transformCtx;
-    app: ((data: t.ObjectProperty[]) => void) & {
-        prototype: {
-            enable: t.ObjectProperty[] | null;
-        };
-    };
-}
-
-type types_AttributeMap = AttributeMap;
-type types_BaseToken = BaseToken;
-type types_ContentToken = ContentToken;
-type types_JsType = JsType;
-type types_MCXLoc = MCXLoc;
-type types_MCXPosition = MCXPosition;
-type types_ParseReadFileOpt = ParseReadFileOpt;
-type types_ParsedTagContentNode = ParsedTagContentNode;
-type types_ParsedTagNode = ParsedTagNode;
-type types_PropNode = PropNode;
-type types_PropValue = PropValue;
-type types_ReadFileOpt = ReadFileOpt;
-type types_TagEndToken = TagEndToken;
-type types_TagToken = TagToken;
-type types_Token = Token;
-type types_TokenType = TokenType;
-type types_TypeVerifyBody = TypeVerifyBody;
-type types_mcxType = mcxType;
-type types_transformCtx = transformCtx;
-type types_transformParseCtx = transformParseCtx;
-declare namespace types {
-  export type { types_AttributeMap as AttributeMap, types_BaseToken as BaseToken, types_ContentToken as ContentToken, types_JsType as JsType, types_MCXLoc as MCXLoc, types_MCXPosition as MCXPosition, types_ParseReadFileOpt as ParseReadFileOpt, types_ParsedTagContentNode as ParsedTagContentNode, types_ParsedTagNode as ParsedTagNode, types_PropNode as PropNode, types_PropValue as PropValue, types_ReadFileOpt as ReadFileOpt, types_TagEndToken as TagEndToken, types_TagToken as TagToken, types_Token as Token, types_TokenType as TokenType, types_TypeVerifyBody as TypeVerifyBody, types_mcxType as mcxType, types_transformCtx as transformCtx, types_transformParseCtx as transformParseCtx };
-}
-
-declare class McxAst {
-    private text;
-    constructor(text: string);
-    private getAST;
-    get data(): ParsedTagNode[];
-    parseAST(): ParsedTagNode[];
-    /**
-     * 生成代码字符串（递归处理 content 数组）
-     * @param node 要生成代码的AST节点
-     * @returns 生成的代码字符串
-     */
-    static generateCode(node: ParsedTagNode): string;
-}
-
-declare function PropParser(code: string): PropNode[];
-
-declare const _default: {
-    tag: typeof McxAst;
-    prop: typeof PropParser;
-};
-
-declare function mcxPlugn(opt: CompileOpt): Plugin;
-
-declare function CompileMcxDir(BuildOpt: CompileOpt): Promise<void>;
-
-declare class McxUtlis {
-    /**
-     * 检查文件是否存在
-     * @param path 文件路径
-     * @returns 是否存在
-     */
-    static FileExsit(path: string): Promise<boolean>;
-    /**
-     * 读取文件内容，支持返回 string 或 object，带重试机制
-     * @param filePath 文件路径
-     * @param opt 配置选项
-     * @returns 文件内容（string | object），出错时返回 {}
-     */
-    static readFile(filePath: string, opt?: ReadFileOpt): Promise<object | string>;
-    static sleep(time: number): Promise<void>;
-    static TypeVerify(obj: any, types: TypeVerifyBody): boolean;
-    static AbsoluteJoin(baseDir: string, inputPath: string): string;
-}
-
-declare class CompileError extends Error {
-    loc: {
-        line: number;
-        column: number;
-    };
-    constructor(message: string, loc: {
-        line: number;
-        column: number;
-    });
-}
-type Context = Record<string, t.Expression | {
-    status: "wait";
-}>;
-declare class CompileJS {
-    node: t.Program;
-    constructor(node: t.Program);
-    TopContext: Context;
-    private indexTemp;
-    private push;
-    private takeInnerMost;
-    private writeImportKeys;
-    private extractIdentifierNames;
-    private writeBuildCache;
-    private CompileData;
-    getCompileData(): JsCompileData;
-    private conditionalInTempImport;
-    private tre;
-    run(): void;
-}
-declare function compileJSFn(code: string): JsCompileData;
-declare function compileMCXFn(mcxCode: string): MCXCompileData;
-
-type index$2_CompileError = CompileError;
-declare const index$2_CompileError: typeof CompileError;
-type index$2_CompileJS = CompileJS;
-declare const index$2_CompileJS: typeof CompileJS;
-type index$2_Context = Context;
-declare const index$2_compileJSFn: typeof compileJSFn;
-declare const index$2_compileMCXFn: typeof compileMCXFn;
-declare namespace index$2 {
-  export { index$2_CompileError as CompileError, index$2_CompileJS as CompileJS, index$2_compileJSFn as compileJSFn, index$2_compileMCXFn as compileMCXFn };
-  export type { index$2_Context as Context };
-}
-
-declare function compileComponent(compiledCode: MCXCompileData, project: string): Promise<void>;
-
-declare const index$1_compileComponent: typeof compileComponent;
-declare namespace index$1 {
-  export {
-    index$1_compileComponent as compileComponent,
-  };
-}
-
-declare function transform(code: MCXCompileData, cache: Map<string, MCXCompileData>, id: string, context: TransformPluginContext, opt: CompileOpt): Promise<string>;
-
-/**
- * MCX Volar TSC 插件
- * 为 MCX 文件提供 TypeScript 智能感知支持
- */
-declare const mcxVolarTscPlugin: LanguagePlugin<URI>;
-/**
- * MCX 虚拟代码
- * 用于在 Volar 中表示 MCX 文件的内容
- */
-declare class MCXVirtualCode implements VirtualCode {
-    snapshot: ts.IScriptSnapshot;
-    id: string;
-    languageId: string;
-    mappings: CodeMapping[];
-    embeddedCodes: VirtualCode[];
-    constructor(snapshot: ts.IScriptSnapshot, id?: string);
-    /**
-     * 从 MCX 文件中提取 script 标签内容
-     */
-    private extractScriptContent;
-    /**
-     * 计算 script 内容在源文件中的起始偏移量
-     */
-    private calculateScriptOffset;
-}
-/**
- * 创建 MCX 虚拟代码实例
- */
-declare function createMCXVirtualCode(snapshot: ts.IScriptSnapshot, id?: string): VirtualCode;
-
-type index_MCXVirtualCode = MCXVirtualCode;
-declare const index_MCXVirtualCode: typeof MCXVirtualCode;
-declare const index_createMCXVirtualCode: typeof createMCXVirtualCode;
-declare const index_mcxVolarTscPlugin: typeof mcxVolarTscPlugin;
-declare namespace index {
-  export {
-    index_MCXVirtualCode as MCXVirtualCode,
-    index_createMCXVirtualCode as createMCXVirtualCode,
-    index_mcxVolarTscPlugin as mcxVolarTscPlugin,
-  };
-}
-
-export { _default as AST, index$2 as Compiler, types as PUBTYPE, index as TSC, CompileMcxDir as compile, index$1 as compile_component, mcxPlugn as plugin, transform, McxUtlis as utils };