@mbler/mcx-core 0.1.0 → 0.1.1-beta.r1

package/dist/types/ast/index.d.ts

@@ -1,5 +1,5 @@
-import AST_tag from "./tag.js";
-import AST_prop from "./prop.js";
+import AST_tag from './tag.js';
+import AST_prop from './prop.js';
 declare const _default: {
     tag: typeof AST_tag;
     prop: typeof AST_prop;

package/dist/types/ast/prop.d.ts

@@ -1,4 +1,4 @@
-import type { PropNode, PropValue } from "../types.js";
+import type { PropNode, PropValue } from '../types.js';
 export declare class Lexer {
     private code;
     constructor(code: string);

package/dist/types/ast/tag.d.ts

@@ -1,4 +1,4 @@
-import type { BaseToken, TagToken, TagEndToken, ContentToken, CommentToken, Token, ParsedTagNode, AttributeMap, ParsedTagContentNode, ParsedCommentNode, TokenType } from "./../types.js";
+import type { BaseToken, TagToken, TagEndToken, ContentToken, CommentToken, Token, ParsedTagNode, AttributeMap, ParsedTagContentNode, ParsedCommentNode, TokenType } from './../types.js';
 declare class Tokenizer {
     private text;
     constructor(text: string);

package/dist/types/compile-mcx/compiler/compileData.d.ts

@@ -1,6 +1,6 @@
-import * as t from "@babel/types";
-import { BuildCache, MCXstructureLoc } from "../types";
-import { ParsedTagNode } from "../../types";
+import * as t from '@babel/types';
+import { BuildCache, MCXstructureLoc } from '../types';
+import { ParsedTagNode } from '../../types';
 export declare class JsCompileData {
     node: t.Program;
     BuildCache: BuildCache;

package/dist/types/compile-mcx/compiler/index.d.ts

@@ -1,6 +1,6 @@
-import * as t from "@babel/types";
-import * as CompileData from "./compileData";
-import Utils from "./utils";
+import * as t from '@babel/types';
+import * as CompileData from './compileData';
+import Utils from './utils';
 export declare class CompileError extends Error {
     loc: {
         line: number;
@@ -12,7 +12,7 @@ export declare class CompileError extends Error {
     });
 }
 export type Context = Record<string, t.Expression | {
-    status: "wait";
+    status: 'wait';
 }>;
 export declare class CompileJS {
     node: t.Program;
@@ -20,17 +20,17 @@ export declare class CompileJS {
     TopContext: Context;
     private indexTemp;
     private push;
-    private takeInnerMost;
-    private writeImportKeys;
-    private extractIdentifierNames;
     private writeBuildCache;
     private CompileData;
     getCompileData(): CompileData.JsCompileData;
-    private conditionalInTempImport;
     private tre;
     run(): void;
 }
-export declare function compileJSFn(code: string): CompileData.JsCompileData;
-export declare function compileMCXFn(mcxCode: string): CompileData.MCXCompileData;
-export * from "./compileData";
+export declare const compileJSFn: ((code: string) => CompileData.JsCompileData) & {
+    cache: Record<string, CompileData.JsCompileData>;
+};
+export declare const compileMCXFn: ((mcxCode: string) => CompileData.MCXCompileData) & {
+    cache: Record<string, CompileData.MCXCompileData>;
+};
+export * from './compileData';
 export { Utils as MCXNodeUtils };

package/dist/types/compile-mcx/compiler/utils.d.ts

@@ -1,6 +1,6 @@
-import * as Parser from "@babel/parser";
-import { ImportList } from "../types";
-import * as t from "@babel/types";
+import * as Parser from '@babel/parser';
+import { ImportList } from '../types';
+import * as t from '@babel/types';
 export default class Utils {
     static FileAST(fileDir: string, parserOpt: Parser.ParserOptions): Promise<t.Program>;
     static FileContent(fileDir: string): Promise<string>;

package/dist/types/compile-mcx/index.d.ts

@@ -1 +1 @@
-export { rollupPlugin, rolldownPlugin } from "./compiler/main";
+export { rollupPlugin, rolldownPlugin } from './compiler/main';

package/dist/types/compile-mcx/types.d.ts

@@ -1,6 +1,6 @@
-import type { ImportDeclaration, ExportAllDeclaration, ExportDefaultDeclaration, ExportNamedDeclaration, Expression, SpreadElement, ArgumentPlaceholder, CallExpression } from "@babel/types";
-import { CompileOpt } from "@mbler/mcx-types";
-import { ParsedTagNode } from "../types";
+import type { ImportDeclaration, ExportAllDeclaration, ExportDefaultDeclaration, ExportNamedDeclaration, Expression, SpreadElement, ArgumentPlaceholder, CallExpression } from '@babel/types';
+import { CompileOpt } from '@mbler/mcx-types';
+import { ParsedTagNode } from '../types';
 interface callList {
     source: Expression;
     set: (callEXp: CallExpression) => boolean;
@@ -27,11 +27,11 @@ export declare const _MCXstructureLocComponentTypes: {
     readonly blocks: "block";
     readonly entities: "entity";
 };
-type MCXstructureLocComponentType = typeof _MCXstructureLocComponentTypes[keyof typeof _MCXstructureLocComponentTypes];
+type MCXstructureLocComponentType = (typeof _MCXstructureLocComponentTypes)[keyof typeof _MCXstructureLocComponentTypes];
 interface MCXstructureLoc {
     script: string;
     Event: {
-        on: "after" | "before";
+        on: 'after' | 'before';
         subscribe: Record<string, string>;
         loc: {
             line: number;
@@ -49,4 +49,4 @@ interface MCXstructureLoc {
     }>;
     UI: ParsedTagNode | null;
 }
-export type { BuildCache, ImportList, ImportListImport, callList, CompileOpt, MCXstructureLoc, MCXstructureLocComponentType };
+export type { BuildCache, ImportList, ImportListImport, callList, CompileOpt, MCXstructureLoc, MCXstructureLocComponentType, };

package/dist/types/compile-mcx/utils.node.d.ts

@@ -4,11 +4,11 @@ export default class NodeUtils {
     static stringArrayToMemberExpression(stringArray: string[]): MemberExpression;
     static memberExpressionToStringArray(memberExpression: MemberExpression, maxLength: number): string[];
     /**
-     * 计算表达式的值
-     * @param expression Babel AST 表达式节点
-     * @param currentContext 当前上下文变量
-     * @param topContext 顶层上下文变量
-     * @returns 计算结果 (string | number | symbol | object)
+     * Calc babel expression value
+     * @param expression Babel AST node
+     * @param currentContext current context
+     * @param topContext top context
+     * @returns {string | number | symbol | object}
      */
-    static evaluateExpression(expression: Expression, currentContext?: Context, topContext?: Context): string | number | symbol | object;
+    static evaluateExpression(expression: Expression, currentContext?: Context, topContext?: Context): unknown;
 }

package/dist/types/index.d.ts

@@ -1,10 +1,10 @@
-import AST from "./ast/index.js";
-import { rollupPlugin, rolldownPlugin } from "./compile-mcx/index.js";
-import utils from "./utils.js";
-import * as Compiler from "./compile-mcx/compiler";
-import * as PUBTYPE from "./types.js";
-import * as compile_component from "./mcx-component/index.js";
-import { transform } from "./transforms";
+import AST from './ast/index.js';
+import { rollupPlugin, rolldownPlugin } from './compile-mcx/index.js';
+import utils from './utils.js';
+import * as Compiler from './compile-mcx/compiler';
+import * as PUBTYPE from './types.js';
+import * as compile_component from './mcx-component/index.js';
+import { transform } from './transforms';
 export { PUBTYPE, AST, Compiler as compiler, utils, transform, compile_component, rollupPlugin, rolldownPlugin, };
-export { ItemComponent, BlockComponent, EntityComponent, PNGImageComponent, JPGImageComponent, SVGImageComponent, GIFImageComponent } from "./mcx-component/lib";
-export * as ComponentType from "./mcx-component/types";
+export { ItemComponent, BlockComponent, EntityComponent, PNGImageComponent, JPGImageComponent, SVGImageComponent, GIFImageComponent, } from './mcx-component/lib';
+export * as ComponentType from './mcx-component/types';

package/dist/types/mcx-component/components/entity.d.ts

@@ -1,8 +1,8 @@
-import * as t from "./../types";
+import * as t from './../types';
 declare class EntityComponent {
     #private;
-    constructor(opt: t.EntityComponentOpt);
-    toJSON(): t.EntityJSON;
+    constructor(opt: t.EntityComponentOptions);
+    toJSON(): t.EntityJson;
     setId(newValue: string): void;
     setFormat(newValue: string): void;
     setIsSpawnable(value: boolean): void;
@@ -237,10 +237,10 @@ declare class EntityComponent {
         can_auto_step_from_liquid?: boolean;
         drag_down_on_buoyancy_removed?: number;
         liquid_blocks?: string[];
-        movement_type?: "waves" | "bobbing" | "none";
+        movement_type?: 'waves' | 'bobbing' | 'none';
     }): void;
     setBurnsInDaylight(config?: {
-        protection_slot?: "slot.armor.body" | "slot.armor.chest" | "slot.armor.feet" | "slot.armor.head" | "slot.armor.legs" | "slot.weapon.mainhand" | "slot.weapon.offhand";
+        protection_slot?: 'slot.armor.body' | 'slot.armor.chest' | 'slot.armor.feet' | 'slot.armor.head' | 'slot.armor.legs' | 'slot.weapon.mainhand' | 'slot.weapon.offhand';
     }): void;
     setCannotBeAttacked(): void;
     setCanClimb(): void;
@@ -271,7 +271,7 @@ declare class EntityComponent {
     setCombatRegeneration(config?: {
         apply_to_family?: boolean;
         apply_to_self?: boolean;
-        regeneration_duration?: number | "infinite";
+        regeneration_duration?: number | 'infinite';
     }): void;
     setConditionalBandwidthOptimization(config?: {
         conditional_values?: Array<{
@@ -298,7 +298,7 @@ declare class EntityComponent {
         time_between_hurt?: number;
     }): void;
     setDamageSensor(config?: {
-        deals_damage?: boolean | "yes" | "no" | "no_but_side_effects_apply";
+        deals_damage?: boolean | 'yes' | 'no' | 'no_but_side_effects_apply';
         triggers?: Array<{
             cause?: string;
             damage_modifier?: number;
@@ -331,7 +331,7 @@ declare class EntityComponent {
     setDashAction(config?: {
         can_dash_underwater?: boolean;
         cooldown_time?: number;
-        direction?: "entity" | "passenger";
+        direction?: 'entity' | 'passenger';
         horizontal_momentum?: number;
         vertical_momentum?: number;
     }): void;
@@ -855,7 +855,7 @@ declare class EntityComponent {
                 operator?: string;
                 [key: string]: any;
             };
-            spring_type?: "bouncy" | "dampened" | "quad_dampened";
+            spring_type?: 'bouncy' | 'dampened' | 'quad_dampened';
         }>;
     }): void;
     /**
@@ -877,7 +877,7 @@ declare class EntityComponent {
             [key: string]: any;
         };
         find_players_only?: boolean;
-        line_of_sight_obstruction_type?: "outline" | "collision" | "collision_for_camera";
+        line_of_sight_obstruction_type?: 'outline' | 'collision' | 'collision_for_camera';
         look_at_locations?: string[];
         looked_at_cooldown?: {
             min: number;
@@ -894,7 +894,7 @@ declare class EntityComponent {
         };
         scale_fov_by_distance?: boolean;
         search_radius?: number;
-        set_target?: boolean | "never" | "once_and_stop_scanning" | "once_and_keep_scanning";
+        set_target?: boolean | 'never' | 'once_and_stop_scanning' | 'once_and_keep_scanning';
     }): void;
     /**
      * Sets the loot table for the entity
@@ -917,7 +917,7 @@ declare class EntityComponent {
         ambient?: boolean;
         cooldown_time?: number;
         effect_range?: number;
-        effect_time?: number | "infinite";
+        effect_time?: number | 'infinite';
         entity_filter?: {
             subject?: string;
             test?: string;

package/dist/types/mcx-component/components/item.d.ts

@@ -1,8 +1,9 @@
-import * as t from "./../types";
+import { PNGImageComponent } from '../lib';
+import * as t from './../types';
 declare class ItemComponent {
     #private;
-    constructor(opt: t.ItemComponentOpt);
-    toJSON(): t.ItemJSON;
+    constructor(opt: t.ItemComponentOptions);
+    toJSON(): t.ItemJson;
     /**
      * set name
      * @throws {Error}&
@@ -11,6 +12,7 @@ declare class ItemComponent {
      */
     setName(newValue: string): void;
     setIcon(newValue: string): void;
+    setIcon(newValue: PNGImageComponent): void;
     /**
      * get name
      * @returns {string} name
@@ -51,7 +53,7 @@ declare class ItemComponent {
     setCooldown(config: {
         category: string;
         duration: number;
-        type?: "use" | "attack";
+        type?: 'use' | 'attack';
     }): void;
     /**
      * setCompostable
@@ -429,5 +431,90 @@ declare class ItemComponent {
         emit_vibrations?: boolean;
         start_sound?: string;
     }): void;
+    getIcon(): string | PNGImageComponent | undefined;
+    getAllowOffHand(): boolean | undefined;
+    getTags(): {
+        tags?: string[];
+    } | undefined;
+    getDamageAbsorption(): {
+        absorbable_causes: string[];
+    } | undefined;
+    getDurability(): {
+        max_durability: number;
+        damage_chance?: {
+            min: number;
+            max: number;
+        };
+    } | undefined;
+    getMaxStackSize(): number | {
+        value?: number;
+    } | undefined;
+    getShouldDespawn(): any;
+    getHandEquipped(): boolean | undefined;
+    getRepairable(): any;
+    getFuel(): {
+        duration: number;
+    } | undefined;
+    getStorageWeightModifier(): {
+        weight_in_storage_item: number;
+    } | undefined;
+    getStorageWeightLimit(): {
+        max_weight_limit: number;
+    } | undefined;
+    getStorageItem(): {
+        allow_nested_storage_items?: boolean;
+        allowed_items?: string[];
+        banned_items?: string[];
+        max_slots?: number;
+        max_weight_limit?: number;
+        weight_in_storage_item?: number;
+    } | undefined;
+    getBundleInteraction(): {
+        num_viewable_slots?: number;
+    } | undefined;
+    getCooldown(): {
+        category: string;
+        duration: number;
+        type?: "use" | "attack";
+    } | undefined;
+    getCompostable(): {
+        composting_chance: number;
+    } | undefined;
+    getBlockPlacer(): {
+        aligned_placement?: boolean;
+        block: string;
+        replace_block_item?: boolean;
+        use_on?: Array<string | {
+            name: string;
+            states?: Record<string, number | string | boolean>;
+            tags?: string;
+        }>;
+    } | undefined;
+    getThrowable(): {
+        do_swing_animation?: boolean;
+        launch_power_scale?: number;
+        max_draw_duration?: number;
+        max_launch_power?: number;
+        min_draw_duration?: number;
+        scale_power_by_draw_duration?: boolean;
+    } | undefined;
+    getProjectile(): any;
+    getRecord(): any;
+    getGlint(): any;
+    getUseAnimation(): string | {
+        value?: string;
+    } | undefined;
+    getWearable(): {
+        slot: "slot.armor.head" | "slot.armor.chest" | "slot.armor.legs" | "slot.armor.feet" | "slot.armor.body" | "slot.weapon.mainhand" | "slot.weapon.offhand" | "slot.hotbar" | "slot.inventory" | "slot.enderchest" | "slot.saddle" | "slot.armor" | "slot.chest";
+        protection?: number;
+        hides_player_location?: boolean;
+        dispensable?: boolean;
+    } | undefined;
+    getUseModifiers(): {
+        use_duration: number;
+        movement_modifier?: number;
+        emit_vibrations?: boolean;
+        start_sound?: string;
+    } | undefined;
 }
 export { ItemComponent };

package/dist/types/mcx-component/index.d.ts

@@ -1,5 +1,17 @@
-import { MCXCompileData } from "../compile-mcx/compiler/compileData";
-import { transformCtx } from "../types";
+import { MCXCompileData } from '../compile-mcx/compiler/compileData';
+import { transformCtx } from '../types';
+import type { BaseJson, FilePoint } from './types';
+/** Clear all cached bind options (called between builds) */
+export declare function clearCachedOptions(): void;
+export declare function resolveFilePoint(point: FilePoint, ctx: transformCtx): string;
+export declare function execEdit(option: BaseJson['_meta']['file_edit'], ctx: transformCtx): Promise<void>;
+/**
+ * Generate the final textures/item_texture.json from accumulated bind data.
+ * Call this in the plugin's buildEnd / onEnd hook.
+ */
+export declare function generateItemTextureJson(output: {
+    resources: string;
+}): Promise<void>;
 export declare function compileComponent(compiledCode: MCXCompileData, ctx: transformCtx): Promise<void>;
-export * from "./vm";
-export { ItemComponent, EntityComponent, BlockComponent, PNGImageComponent, SVGImageComponent, GIFImageComponent, JPGImageComponent } from "./lib";
+export * from './vm';
+export { ItemComponent, EntityComponent, BlockComponent, PNGImageComponent, SVGImageComponent, GIFImageComponent, JPGImageComponent, } from './lib';

package/dist/types/mcx-component/lib.d.ts

@@ -1,6 +1,6 @@
-import { BlockComponent } from "./components/block";
-import { EntityComponent } from "./components/entity";
-import { ItemComponent } from "./components/item";
+import { BlockComponent } from './components/block';
+import { EntityComponent } from './components/entity';
+import { ItemComponent } from './components/item';
 declare const _default: {
     item: typeof ItemComponent;
     entity: typeof EntityComponent;
@@ -29,4 +29,4 @@ declare class GIFImageComponent extends ImageComponent {
     classId: "mcx_git_019723";
     constructor(filePath: string);
 }
-export { ItemComponent, BlockComponent, EntityComponent, PNGImageComponent, JPGImageComponent, SVGImageComponent, GIFImageComponent };
+export { ItemComponent, BlockComponent, EntityComponent, PNGImageComponent, JPGImageComponent, SVGImageComponent, GIFImageComponent, };

package/dist/types/mcx-component/types/EnchantableSlot.d.ts

@@ -4,6 +4,6 @@
  * @description Update time UTC 2026/4/8
  */
 export declare const EnchantableSlotArray: readonly ["none", "all", "g_armor", "armor_head", "armor_torso", "armor_feet", "armor_legs", "sword", "bow", "spear", "crossbow", "melee_spear", "g_tool", "hoe", "shears", "flintsteel", "shield", "g_digging", "axe", "pickaxe", "shovel", "fishing_rod", "carrot_stick", "elytra", "cosmetic_head"];
-export type EnchantableSlot = typeof EnchantableSlotArray[number];
+export type EnchantableSlot = (typeof EnchantableSlotArray)[number];
 export declare const EnchantableSlotEnum: readonly ["none", "all", "g_armor", "armor_head", "armor_torso", "armor_feet", "armor_legs", "sword", "bow", "spear", "crossbow", "melee_spear", "g_tool", "hoe", "shears", "flintsteel", "shield", "g_digging", "axe", "pickaxe", "shovel", "fishing_rod", "carrot_stick", "elytra", "cosmetic_head"];
 export default EnchantableSlot;

package/dist/types/mcx-component/types/ParticleType.d.ts

@@ -3,6 +3,6 @@
  * @description Update time UTC 2026/4/8
  */
 declare const ParticleTypeEnum: readonly ["balloongas", "bleach", "blockforcefield", "blueflame", "breezewindexplosion", "bubble", "bubblecolumndown", "bubblecolumnup", "bubblemanual", "campfiresmoke", "campfiresmoketall", "candleflame", "carrotboost", "coloredflame", "conduit", "creakingcrumble", "crit", "dragonbreath", "dragonbreathfire", "dragonbreathtrail", "dragondestroyblock", "driphoney", "driplava", "dripwater", "dustplume", "electricspark", "enchantingtable", "endrod", "evaporation", "explode", "eyeblossomclose", "eyeblossomopen", "fallingborderdust", "fallingdust", "fireworks", "fireworksoverlay", "fireworksstarter", "flame", "food", "greenflame", "heart", "hugeexplosion", "iconcrack", "ink", "largeexplode", "largesmoke", "lava", "mobappearance", "mobflame", "mobspell", "mobspellambient", "mobspellinstantaneous", "myceliumdust", "none", "note", "obsidiantear", "paleoakleaves", "pausemobgrowth", "portal", "portalreverse", "rainsplash", "reddust", "resetmobgrowth", "risingborderdust", "sculksoul", "shriek", "shulkerbullet", "slime", "smoke", "sneeze", "snowballpoof", "snowflake", "sonicexplosion", "soul", "sparkler", "spit", "stalactitedriplava", "stalactitedripwater", "terrain", "totem", "townaura", "trackingemitter", "vaultconnection", "villagerangry", "villagerhappy", "watersplash", "watersplashmanual", "waterwake", "wax", "whitesmoke", "windexplosion", "witchspell", "wolfarmorcrack"];
-type ParticleType = typeof ParticleTypeEnum[number];
+type ParticleType = (typeof ParticleTypeEnum)[number];
 export default ParticleType;
 export { ParticleTypeEnum };

package/dist/types/mcx-component/types/SoundEvent.d.ts

@@ -3,6 +3,6 @@
  * @description Update time UTC 2026/4/8
  */
 declare const SoundEventEnum: string[];
-type SoundEvent = typeof SoundEventEnum[number];
+type SoundEvent = (typeof SoundEventEnum)[number];
 export default SoundEvent;
 export { SoundEventEnum };