@mbler/mcx-core 0.1.2-rc.1 → 0.1.2-rc.11

package/README.md

@@ -1,5 +1,40 @@
-# mcx
-
-## This is a DSL for build minecraft bedrock script
-
-Docs **[see this](https://mbler-docs.ruanhor.dpdns.org/guide/mcx)**
+# @mbler/mcx-core
+
+The MCX DSL compiler — the core of the MCX ecosystem. Compiles `.mcx` source files into MCBE-compatible JSON components, UI forms, and event systems.
+
+## Pipeline
+
+`.mcx` file → **parser** → AST → **transform** (Babel) → compiled JS → MCBE JSON
+
+## Features
+
+- **MCX Parser** — Parses `.mcx` source into a tokenized AST (`tag`, `prop`)
+- **Transform Pipeline** — Detects file type (`event`, `ui`, `component`, `app`) and generates compiled Babel AST
+- **Component Compilation** — Runs component scripts in a sandboxed VM, generates MCBE JSON, executes file edit operations
+- **CJS Transform** — Rewrites ESM imports to CommonJS `require()` for VM execution
+- **Image Assets** — Compiles PNG, JPG, SVG, GIF image references into MCBE texture assets
+- **Rollup/Rolldown Plugin** — Seamless `.mcx` file resolution and transformation in your build pipeline
+
+## Installation
+
+```bash
+pnpm add -D @mbler/mcx-core
+```
+
+## Usage
+
+Add the plugin to your Rollup or Rolldown config:
+
+```ts
+import { rollupPlugin } from '@mbler/mcx-core'
+
+export default {
+  plugins: [rollupPlugin({ moduleDir: './modules', tsconfigPath: './tsconfig.json' })],
+}
+```
+
+For full documentation, visit the **[Docs](https://mbler-docs.ruanhor.dpdns.org/guide/mcx)**.
+
+## License
+
+MIT

package/dist/chunk-6Ep1yQYe.js

@@ -0,0 +1,16 @@
+import { createRequire } from "node:module";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+//#endregion
+export { __exportAll as n, __require as r, __commonJSMin as t };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
+import * as Parser from "@babel/parser";
 import * as t from "@babel/types";
 import { ArgumentPlaceholder, CallExpression, ExportAllDeclaration, ExportDefaultDeclaration, ExportNamedDeclaration, Expression, ImportDeclaration, SpreadElement } from "@babel/types";
-import * as Parser from "@babel/parser";
-import { BlockComponent, BlockComponent as BlockComponent$1, EnchantableSlot, EntityComponent, EntityComponent as EntityComponent$1, EntityComponentOptions, EntityJson, FoodEffect, GIFImageComponent, GIFImageComponent as GIFImageComponent$1, ItemComponent, ItemComponent as ItemComponent$1, ItemComponentOptions, ItemJson, JPGImageComponent, JPGImageComponent as JPGImageComponent$1, PNGImageComponent, PNGImageComponent as PNGImageComponent$1, ParticleType, Rarity, SVGImageComponent, SVGImageComponent as SVGImageComponent$1, SoundEvent } from "@mbler/mcx-component";
+import { BlockComponent, BlockComponent as BlockComponent$1, EnchantableSlot, EntityComponent, EntityComponent as EntityComponent$1, EntityComponentOptions, FoodEffect, GIFImageComponent, GIFImageComponent as GIFImageComponent$1, ItemComponent, ItemComponent as ItemComponent$1, ItemComponentOptions, JPGImageComponent, JPGImageComponent as JPGImageComponent$1, PNGImageComponent, PNGImageComponent as PNGImageComponent$1, ParticleType, Rarity, SVGImageComponent, SVGImageComponent as SVGImageComponent$1, SoundEvent } from "@mbler/mcx-component";
 import { Plugin, TransformPluginContext } from "rollup";
 import { CompileOpt, CompileOpt as CompileOpt$1 } from "@mbler/mcx-types";
 import { Plugin as Plugin$1 } from "rolldown";
@@ -178,14 +178,10 @@ declare class McxAst {
   private text;
   private includeComments;
   constructor(text: string, includeComments?: boolean);
-  private getAST;
-  get data(): ParsedTagNode[];
   parseAST(): ParsedTagNode[];
-  /**
-   * 生成代码字符串
-   * @param node 代码的AST节点
-   * @returns 代码字符串
-   */
+  private convertTemplateChild;
+  private convertVueElement;
+  private convertVueChildren;
   static generateCode(node: ParsedTagNode): string;
 }
 //#endregion
@@ -207,7 +203,7 @@ declare class Utils {
   static FileExist(path: string): Promise<boolean>;
   static readFile(filePath: string, opt?: ReadFileOpt): Promise<object | string>;
   static sleep(time: number): Promise<void>;
-  static TypeVerify<T extends Record<string, any>, U extends TypeVerifyBody>(obj: T, types: U): obj is T & { [P in keyof U]: {
+  static TypeVerify<T extends Record<string, unknown>, U extends TypeVerifyBody>(obj: T, types: U): obj is T & { [P in keyof U]: {
     boolean: boolean;
     number: number;
     string: string;
@@ -263,7 +259,7 @@ declare const compileMCXFn: ((mcxCode: string) => MCXCompileData) & {
   cache: Record<string, MCXCompileData>;
 };
 declare namespace types_d_exports {
-  export { BaseJson, DefineEntry, EnchantableSlot, EntityComponentOptions, EntityJson, FileBindSource, FileEditExpression, FileEditOption, FilePoint, FoodEffect, ItemComponentOptions, ItemJson, ParticleType, Rarity, SoundEvent, createFileEdit };
+  export { BaseJson, DefineEntry, EnchantableSlot, EntityComponentOptions, FileBindSource, FileEditExpression, FileEditOption, FilePoint, FoodEffect, ItemComponentOptions, ParticleType, Rarity, SoundEvent, createFileEdit };
 }
 interface FilePoint {
   base: 'behavior' | 'resources' | 'root';
@@ -293,7 +289,7 @@ type FileEditOption = {
   type: 'edit';
   id?: string;
   source: FilePoint | FileBindSource;
-  expression: FileEditExpression<any>;
+  expression: FileEditExpression<Record<string, DefineEntry>>;
 } | {
   type: 'copy_assets';
   id?: string;
@@ -353,7 +349,7 @@ declare function clearCachedOptions(): void;
  * Resolve a FilePoint to an absolute path on disk.
  *
  * - `base: 'root'` is only allowed when the calling component originates from
- *   @mbler/mcx-core (the `sourceIsMcxCore` flag). This prevents third-party
+ *   @mbler/mcx-component (the `sourceIsMcxCore` flag). This prevents third-party
  *   components from reading arbitrary filesystem locations.
  * - For `behavior` / `resources`, the file is resolved relative to the
  *   corresponding output directory. A path-traversal check ensures the resolved
@@ -365,7 +361,7 @@ declare function resolveFilePoint(point: FilePoint, ctx: transformCtx, sourceIsM
  * Delegates to execEditInternal with a fresh limits counter.
  *
  * @param isMcxCoreSource - when true, the component originates from
- *   @mbler/mcx-core and is exempt from file I/O limits and root base
+ *   @mbler/mcx-component and is exempt from file I/O limits and root base
  *   restrictions.
  */
 declare function execEdit(option: BaseJson['_meta']['file_edit'], ctx: transformCtx, isMcxCoreSource?: boolean): Promise<void>;
@@ -388,7 +384,7 @@ declare function generateItemTextureJson(output: {
  *
  * Per-component restrictions (checked after VM execution):
  * - path traversal guard on the output file point
- * - root base: only allowed if the export came from @mbler/mcx-core
+ * - root base: only allowed if the export came from @mbler/mcx-component
  * - file write limit (≤5) and read limit (≤1): only enforced for
  *   non-mcx-core components
  */