@block_factory/lib 0.0.3 → 0.0.5

package/_module/BlockFactory.ts

@@ -0,0 +1,22 @@
+export { _INITIALIZE_BF_FRAMEWORK_ } from "@block_factory/lib/_module/Framework/_INIT";
+
+export { MathUtils } from "./util/Math";
+export { Signal } from "./util/Signal";
+export { Vec2, Vec3 } from "./util/Vector";
+export { RawText } from "./util/RawText";
+export { Command } from "./util/Command";
+export { System } from "./util/System";
+
+export { IForm, IFormValue } from "./util/Forms/Form";
+export { ActionFormCtor, type IButtonOptions, type IActionFormResponse, type IActionFormData } from "./util/Forms/FormAction";
+export { type IModalFormResponse, type ITextFieldOptions, type IDropdownOptions, type ISliderOptions, type IToggleOptions, type IModalFormData } from "./util/Forms/FormModal";
+export { type IMessageFormData, type IMessageFormResponse } from "./util/Forms/FormMessage";
+export { type IFormRegistration, RegisterForm } from "./util/Forms/FormRegistry";
+
+export { Inventory, ContainerWrapper } from "./util/Wrapper/Container";
+export { type IEntity, IEntityWrapper } from "./util/Wrapper/IEntity";
+export { type IPlayer, IPlayerWrapper } from "./util/Wrapper/IPlayer";
+
+export { type Sound, type Animation } from "./Types";
+export { _THREAD_ } from "@block_factory/lib/_module/Framework/Threads";
+export { _EntityHandler_,  type EntityEmissionEvent, onEntityEmission } from "@block_factory/lib/_module/Framework/EntityTasks";

package/_module/Framework/EntityTasks.ts

@@ -0,0 +1,203 @@
+import {
+    Entity,
+    system,
+    ScriptEventCommandMessageAfterEvent,
+    ScriptEventCommandMessageAfterEventSignal,
+    world,
+    WorldLoadAfterEventSignal,
+    WorldLoadAfterEvent,
+    EntitySpawnAfterEventSignal,
+    EntityRemoveAfterEventSignal,
+    EntitySpawnAfterEvent,
+    EntityRemoveAfterEvent,
+    EntityRemoveBeforeEvent,
+    EntityRemoveBeforeEventSignal,
+} from "@minecraft/server";
+
+import { Signal } from "../util/Signal";
+import { IEntityWrapper, IEntity } from "../util/Wrapper/IEntity";
+
+/* -------------------------------------------------------------------------- */
+/* Public API                                                                 */
+/* -------------------------------------------------------------------------- */
+
+export type EntityEmissionEvent = {
+    iEntity: IEntity;
+    parms: any;
+};
+
+export const onEntityEmission = new Signal<EntityEmissionEvent>();
+
+/* -------------------------------------------------------------------------- */
+/* Singleton                                                                  */
+/* -------------------------------------------------------------------------- */
+
+
+
+class EntityHandler {
+    private PACK_ID: string | undefined;
+    private GLOBAL_MEMORY_ID = "GLB_MEM.ENTITY";
+
+    private readonly scriptEventSignal: ScriptEventCommandMessageAfterEventSignal = system.afterEvents.scriptEventReceive;
+    private readonly loadEventSignal: WorldLoadAfterEventSignal = world.afterEvents.worldLoad;
+    private readonly spawnEventSignal: EntitySpawnAfterEventSignal = world.afterEvents.entitySpawn;
+    private readonly removeAfterEventSignal: EntityRemoveAfterEventSignal = world.afterEvents.entityRemove;
+    private readonly removeBeforeEventSignal: EntityRemoveBeforeEventSignal = world.beforeEvents.entityRemove;
+
+    private readonly EM_INDEX = new Map<string, Entity>();
+    private readonly EM_KEYS: string[] = [];
+    private readonly SEARCH_TYPES = new Set<string>();
+
+    private _started = false;
+    private _wired = false;
+
+    public configure(): void {
+        if (this._started) throw new Error("BFLIB: EntityHandler already started;");
+    }
+
+    public registerEntity(typeId: string | string[]): void {
+        if (Array.isArray(typeId)) typeId.forEach((t) => this.SEARCH_TYPES.add(t));
+        else this.SEARCH_TYPES.add(typeId);
+    }
+
+    public start(packId: string): void {
+        if (this._started) return;
+        this._started = true;
+        this.PACK_ID = packId;
+
+        this.loadEventSignal.subscribe(this.onWorldLoad);
+    }
+
+    public stop(): void {
+        if (!this._started) return;
+
+        this.loadEventSignal.unsubscribe(this.onWorldLoad);
+        if (this._wired) {
+            this.scriptEventSignal.unsubscribe(this.processScriptEvents);
+            this.spawnEventSignal.unsubscribe(this.onEntitySpawned);
+            this.removeBeforeEventSignal.unsubscribe(this.onEntityRemovedBefore);
+            this.removeAfterEventSignal.unsubscribe(this.onEntityRemovedAfter);
+            this._wired = false;
+        }
+
+        this._started = false;
+    }
+
+    /* ------------------------------------------------------------------------ */
+    /* Event Wiring                                                             */
+    /* ------------------------------------------------------------------------ */
+
+    private onWorldLoad = (_event: WorldLoadAfterEvent): void => {
+
+        this.scriptEventSignal.subscribe(this.processScriptEvents);
+
+        if (this.SEARCH_TYPES.size > 0) {
+            this.spawnEventSignal.subscribe(this.onEntitySpawned);
+            this.removeBeforeEventSignal.subscribe(this.onEntityRemovedBefore);
+            this.removeAfterEventSignal.subscribe(this.onEntityRemovedAfter);
+        }
+
+        this._wired = true;
+        this.reloadEntityMemory();
+        this.loadEventSignal.unsubscribe(this.onWorldLoad);
+    };
+
+    private processScriptEvents = (event: ScriptEventCommandMessageAfterEvent): void => {
+        if (!event.sourceEntity) return;
+        if (event.id !== `${this.PACK_ID}:entity_emitter`) return;
+
+        let parms: any;
+        try {
+            parms = JSON.parse(event.message);
+        } catch (e) {
+            console.error(`BFLIB: entity_emitter JSON parse failed:`, e);
+            return;
+        }
+
+        onEntityEmission.emit({
+            iEntity: IEntityWrapper.wrap(event.sourceEntity),
+            parms,
+        });
+    };
+
+    /* ------------------------------------------------------------------------ */
+    /* Filters                                                                  */
+    /* ------------------------------------------------------------------------ */
+
+    private isValidType(typeId: string): boolean {
+        return this.SEARCH_TYPES.has(typeId);
+    }
+
+    private onEntitySpawned = (event: EntitySpawnAfterEvent): void => {
+        const entity = event.entity;
+        if (!this.isValidType(entity.typeId)) return;
+        this.saveEntityInMemory(entity);
+    };
+
+    private onEntityRemovedBefore = (event: EntityRemoveBeforeEvent): void => {
+        const entity = event.removedEntity;
+        if (!this.isValidType(entity.typeId)) return;
+        this.deleteEntityInMemory(entity);
+    };
+
+    private onEntityRemovedAfter = (_event: EntityRemoveAfterEvent): void => {
+        // 
+    };
+
+    /* ------------------------------------------------------------------------ */
+    /* Persistence                                                              */
+    /* ------------------------------------------------------------------------ */
+
+    private reloadEntityMemory(): void {
+        this.EM_INDEX.clear();
+        this.EM_KEYS.length = 0;
+
+        const raw = world.getDynamicProperty(this.GLOBAL_MEMORY_ID) as string | undefined;
+        if (!raw) return;
+
+        let parsed: string[];
+        try {
+            parsed = JSON.parse(raw) as string[];
+        } catch (e) {
+            console.error(`BFLIB: Failed to parse ${this.GLOBAL_MEMORY_ID}:`, e);
+            return;
+        }
+
+        for (const id of parsed) {
+            this.EM_KEYS.push(id);
+            const entity = world.getEntity(id);
+            if (entity) this.EM_INDEX.set(entity.id, entity);
+        }
+    }
+
+    private persistKeys(): void {
+        world.setDynamicProperty(this.GLOBAL_MEMORY_ID, JSON.stringify(this.EM_KEYS));
+    }
+
+    public saveEntityInMemory(entity: Entity): boolean {
+        if (this.EM_INDEX.has(entity.id)) return false;
+        this.EM_KEYS.push(entity.id);
+        this.EM_INDEX.set(entity.id, entity);
+        this.persistKeys();
+
+        return true;
+    }
+
+    public deleteEntityInMemory(entity: Entity): boolean {
+        const existed = this.EM_INDEX.delete(entity.id);
+        if (!existed) return false;
+
+        const idx = this.EM_KEYS.indexOf(entity.id);
+        if (idx !== -1) this.EM_KEYS.splice(idx, 1);
+
+        this.persistKeys();
+
+        return true;
+    }
+
+    public getEntitiesInMemory(): Entity[] {
+        return Array.from(this.EM_INDEX.values());
+    }
+}
+
+export const _EntityHandler_ = new EntityHandler();

package/_module/Framework/Threads.ts

@@ -0,0 +1,72 @@
+import { system, TicksPerSecond } from "@minecraft/server";
+import { Signal } from "../util/Signal";
+
+export type ThreadConfig = {
+    mainRate?: number; // interval ticks
+    lateRate?: number; // interval ticks
+};
+
+class Threads {
+    public readonly MAIN = new Signal<number>();
+    public readonly LATE = new Signal<void>();
+
+    private _mainRate = 0;
+    private _lateRate = TicksPerSecond;
+
+    private _MAIN_ID: number | undefined;
+    private _LATE_ID: number | undefined;
+
+    private _delta = this.createDeltaTimer();
+    private _started = false;
+
+    public configure(cfg: ThreadConfig) {
+        if (this._started) throw new Error("BFLIB: _THREAD_ already started; configure before start().");
+        if (cfg.mainRate !== undefined) this._mainRate = cfg.mainRate;
+        if (cfg.lateRate !== undefined) this._lateRate = cfg.lateRate;
+    }
+
+    public start() {
+        if (this._started) return; // idempotent
+        this._started = true;
+
+        this._MAIN_ID = system.runInterval(() => {
+            if (this.MAIN.count <= 0) return;
+            try {
+                const delta = this._delta();
+                this.MAIN.emit(delta);
+            } catch (e) {
+                console.error(`ERROR: _THREAD_.MAIN:${this._MAIN_ID} |`, e);
+            }
+        }, this._mainRate);
+
+        this._LATE_ID = system.runInterval(() => {
+            if (this.LATE.count <= 0) return;
+            try {
+                this.LATE.emit();
+            } catch (e) {
+                console.error(`ERROR: _THREAD_.LATE:${this._LATE_ID} |`, e);
+            }
+        }, this._lateRate);
+    }
+
+    public stop() {
+        if (this._MAIN_ID !== undefined) system.clearRun(this._MAIN_ID);
+        if (this._LATE_ID !== undefined) system.clearRun(this._LATE_ID);
+        this._MAIN_ID = undefined;
+        this._LATE_ID = undefined;
+        this._started = false;
+        this._delta = this.createDeltaTimer(); // reset delta timing
+    }
+
+    private createDeltaTimer() {
+        let last = Date.now();
+        return () => {
+            const now = Date.now();
+            const delta = (now - last) / 1000;
+            last = now;
+            return delta;
+        };
+    }
+}
+
+export const _THREAD_ = new Threads();

package/_module/Framework/_INIT.ts

@@ -0,0 +1,39 @@
+let IS_INITIALIZED: boolean = false
+let PACK_ID: string | undefined = undefined
+
+/* -------------------------------------------------------------------------- */
+/* Public API                                                                 */
+/* -------------------------------------------------------------------------- */
+
+/**
+ * Initializes the Block Factory framework.
+ *
+ * This **must be called exactly once** before using any backend systems
+ * such as threads, entity tasks, or event routing.
+ *
+ * @param packId - Unique identifier for the active pack instance.
+ *
+ * @throws Error if the framework has already been initialized.
+ *
+ * @example
+ * ```ts
+ * _INITIALIZE_BF_FRAMEWORK_("bf:utility_tools");
+ * ```
+ */
+export function _INITIALIZE_BF_FRAMEWORK_(packId: string): void {
+    if (IS_INITIALIZED) throw Error(`CONFLICT WARNING: ${PACK_ID} already initialized.`);
+    PACK_ID = packId; IS_INITIALIZED = true;
+    console.log("Block Factory Framework Loaded");
+}
+
+/* -------------------------------------------------------------------------- */
+/* Internal API                                                               */
+/* -------------------------------------------------------------------------- */
+
+export function getPackId(): string | undefined {
+    return PACK_ID;
+}
+
+export function isInitalized(): boolean {
+    return IS_INITIALIZED;
+}

package/_module/Types.ts

@@ -0,0 +1,10 @@
+export type Sound = {
+    id: string,
+    length: number
+}
+
+export type Animation = {
+    id: string,
+    length: number,
+    loop?: boolean,
+}

package/_module/util/RawText.ts

@@ -0,0 +1,75 @@
+import { RawMessage } from '@minecraft/server';
+
+/**
+ * Utility helpers for building rawtext messages.
+ */
+export class RawText {
+    /**
+     * Creates a simple text component.
+     * @param value - The text value.
+     * @returns Text component object.
+     */
+    public static text(value: string): RawMessage {
+        return { text: value };
+    }
+
+    /**
+     * Creates a translation component with optional 'with' parameters.
+     * @param key - The translation key.
+     * @param params - The optional parameters for translation.
+     * @returns Translation component object.
+     */
+    public static translate(key: string, ...params: string[]): RawMessage {
+        return {
+            translate: key,
+            with: params.length ? params : undefined
+        };
+    }
+
+    /**
+     * Creates a score component.
+     * @param name - The entity's name whose score is being displayed.
+     * @param objective - The name of the score objective.
+     * @returns Score component object.
+     */
+    public static score(name: string, objective: string): RawMessage {
+        return { score: { name, objective } };
+    }
+
+    /**
+     * Wraps various text components into a rawtext structure.
+     * @param rawText - The raw text components.
+     * @returns Raw text object.
+     */
+    public static message(...rawText: RawMessage[]): RawMessage {
+        return { rawtext: rawText };
+    }
+
+    /**
+     * Common formatting and color codes.
+     */
+    public static FORMAT = {
+        DarkRed: "§4",
+        Red: "§c",
+        Gold: "§6",
+        Yellow: "§e",
+        Green: "§2",
+        Lime: "§a",
+        Aqua: "§b",
+        Cyan: "§3",
+        DarkBlue: "§1",
+        Blue: "§9",
+        Magenta: "§d",
+        Purple: "§5",
+        White: "§f",
+        Gray: "§7",
+        DarkGray: "§8",
+        Black: "§0",
+        Obfuscated: "§k",
+        Bold: "§l",
+        StrikeThrough: "§m",
+        Italic: "§o",
+        Reset: "§r",
+        NewLine: "\n"
+    }
+}

package/{util → _module/util}/Signal.ts

@@ -24,8 +24,10 @@ export class Signal<T = void> {
     }
 
     public emit(data: T): void {
-        for (const cb of Array.from(this.listeners)) {
-            cb(data);
+        for (const callback of Array.from(this.listeners)) {
+            try { callback(data) } catch (err) {
+                console.error("BFLIB: Signal listener error:", err);
+            }
         }
     }
 }

package/{util → _module/util}/Wrapper/IEntity.ts

@@ -1,6 +1,7 @@
-import { Entity, EntityInventoryComponent } from "@minecraft/server";
+import { Entity, EntityInventoryComponent, PlayAnimationOptions, system, TicksPerSecond } from "@minecraft/server";
 import { ContainerWrapper, Inventory } from "./Container";
 import { System } from "../System";
+import { Animation } from "../../Types";
 
 export type IEntity = IEntityWrapper & Entity;
 
@@ -17,9 +18,8 @@ export class IEntityWrapper {
     }
 
     //======================== Interal ========================
-    public isAlive: boolean = false;
 
-    public get inventory(): Inventory {
+    public get inventory(): Inventory | undefined {
         const i = this.source.getComponent(
             EntityInventoryComponent.componentId
         ) as EntityInventoryComponent;
@@ -27,8 +27,9 @@ export class IEntityWrapper {
         return ContainerWrapper.wrap(i.container);
     }
 
-    public test(): void {
-        //this.source.sendMessage(`${this.source.name} was tested`);
+    public async playAnimationAsync(animation: Animation, options: PlayAnimationOptions): Promise<void> {
+        this.source.playAnimation(animation.id, options);
+        await system.waitTicks(animation.length * TicksPerSecond);
     }
 
 }

package/{util → _module/util}/Wrapper/IPlayer.ts

@@ -1,6 +1,7 @@
-import { EntityInventoryComponent, Player } from "@minecraft/server";
+import { EntityInventoryComponent, PlayAnimationOptions, Player, PlayerSoundOptions, system, TicksPerSecond } from "@minecraft/server";
 import { ContainerWrapper, Inventory } from "./Container";
 import { System } from "../System";
+import { Animation, Sound } from "../../Types";
 
 export type IPlayer = IPlayerWrapper & Player;
 
@@ -17,7 +18,6 @@ export class IPlayerWrapper {
     }
 
     //======================== Interal ========================
-    public isAlive: boolean = false;
 
     public get inventory(): Inventory {
         const i = this.source.getComponent(
@@ -27,8 +27,14 @@ export class IPlayerWrapper {
         return ContainerWrapper.wrap(i.container);
     }
 
-    public test(): void {
-        this.source.sendMessage(`${this.source.name} was tested`);
+    public async playSoundAsync(sound:Sound, options: PlayerSoundOptions): Promise<void>{
+        this.source.playSound(sound.id, options);
+        await system.waitTicks(sound.length * TicksPerSecond);
+    }
+
+    public async playAnimationAsync(animation: Animation, options: PlayAnimationOptions): Promise<void> {
+        this.source.playAnimation(animation.id, options);
+        await system.waitTicks(animation.length * TicksPerSecond);
     }
 
 }

package/_types/_module/BlockFactory.d.ts

@@ -0,0 +1,19 @@
+export { _INITIALIZE_BF_FRAMEWORK_ } from "@block_factory/lib/_module/Framework/_INIT";
+export { MathUtils } from "./util/Math";
+export { Signal } from "./util/Signal";
+export { Vec2, Vec3 } from "./util/Vector";
+export { RawText } from "./util/RawText";
+export { Command } from "./util/Command";
+export { System } from "./util/System";
+export { IForm, IFormValue } from "./util/Forms/Form";
+export { ActionFormCtor, type IButtonOptions, type IActionFormResponse, type IActionFormData } from "./util/Forms/FormAction";
+export { type IModalFormResponse, type ITextFieldOptions, type IDropdownOptions, type ISliderOptions, type IToggleOptions, type IModalFormData } from "./util/Forms/FormModal";
+export { type IMessageFormData, type IMessageFormResponse } from "./util/Forms/FormMessage";
+export { type IFormRegistration, RegisterForm } from "./util/Forms/FormRegistry";
+export { Inventory, ContainerWrapper } from "./util/Wrapper/Container";
+export { type IEntity, IEntityWrapper } from "./util/Wrapper/IEntity";
+export { type IPlayer, IPlayerWrapper } from "./util/Wrapper/IPlayer";
+export { type Sound, type Animation } from "./Types";
+export { _THREAD_ } from "@block_factory/lib/_module/Framework/Threads";
+export { _EntityHandler_, type EntityEmissionEvent, onEntityEmission } from "@block_factory/lib/_module/Framework/EntityTasks";
+//# sourceMappingURL=BlockFactory.d.ts.map

package/_types/_module/BlockFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockFactory.d.ts","sourceRoot":"","sources":["../../_module/BlockFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAEvF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC9H,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC/K,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,KAAK,iBAAiB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEjF,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,KAAK,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,KAAK,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,8CAA8C,CAAC;AACxE,OAAO,EAAE,eAAe,EAAG,KAAK,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC"}

package/_types/_module/Framework/EntityTasks.d.ts

@@ -0,0 +1,40 @@
+import { Entity } from "@minecraft/server";
+import { Signal } from "../util/Signal";
+import { IEntity } from "../util/Wrapper/IEntity";
+export type EntityEmissionEvent = {
+    iEntity: IEntity;
+    parms: any;
+};
+export declare const onEntityEmission: Signal<EntityEmissionEvent>;
+declare class EntityHandler {
+    private PACK_ID;
+    private GLOBAL_MEMORY_ID;
+    private readonly scriptEventSignal;
+    private readonly loadEventSignal;
+    private readonly spawnEventSignal;
+    private readonly removeAfterEventSignal;
+    private readonly removeBeforeEventSignal;
+    private readonly EM_INDEX;
+    private readonly EM_KEYS;
+    private readonly SEARCH_TYPES;
+    private _started;
+    private _wired;
+    configure(): void;
+    registerEntity(typeId: string | string[]): void;
+    start(): void;
+    stop(): void;
+    private onWorldLoad;
+    private processScriptEvents;
+    private isValidType;
+    private onEntitySpawned;
+    private onEntityRemovedBefore;
+    private onEntityRemovedAfter;
+    private reloadEntityMemory;
+    private persistKeys;
+    saveEntityInMemory(entity: Entity): boolean;
+    deleteEntityInMemory(entity: Entity): boolean;
+    getEntitiesInMemory(): Entity[];
+}
+export declare const _EntityHandler_: EntityHandler;
+export {};
+//# sourceMappingURL=EntityTasks.d.ts.map

package/_types/_module/Framework/EntityTasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityTasks.d.ts","sourceRoot":"","sources":["../../../_module/Framework/EntityTasks.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,MAAM,EAaT,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAkB,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAOlE,MAAM,MAAM,mBAAmB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,gBAAgB,6BAAoC,CAAC;AAQlE,cAAM,aAAa;IACf,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,gBAAgB,CAAoB;IAE5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoF;IACtH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0D;IAC1F,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8D;IAC/F,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAgE;IACvG,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAkE;IAE1G,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IAEhB,SAAS,IAAI,IAAI;IAIjB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAK/C,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;IAmBnB,OAAO,CAAC,WAAW,CAcjB;IAEF,OAAO,CAAC,mBAAmB,CAgBzB;IAMF,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe,CAIrB;IAEF,OAAO,CAAC,qBAAqB,CAI3B;IAEF,OAAO,CAAC,oBAAoB,CAE1B;IAMF,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,WAAW;IAIZ,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAU3C,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAY7C,mBAAmB,IAAI,MAAM,EAAE;CAGzC;AAED,eAAO,MAAM,eAAe,eAAsB,CAAC"}

package/{sys → _types/_module/Framework}/Threads.d.ts

@@ -1,14 +1,20 @@
 import { Signal } from "../util/Signal";
+export type ThreadConfig = {
+    mainRate?: number;
+    lateRate?: number;
+};
 declare class Threads {
-    static create(): Threads;
     readonly MAIN: Signal<number>;
     readonly LATE: Signal<void>;
-    MAIN_INTERVAL_RATE: number;
-    LATE_INTERVAL_RATE: number;
+    private _mainRate;
+    private _lateRate;
     private _MAIN_ID;
     private _LATE_ID;
     private _delta;
-    private constructor();
+    private _started;
+    configure(cfg: ThreadConfig): void;
+    start(): void;
+    stop(): void;
     private createDeltaTimer;
 }
 export declare const _THREAD_: Threads;

package/_types/_module/Framework/Threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Threads.d.ts","sourceRoot":"","sources":["../../../_module/Framework/Threads.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,cAAM,OAAO;IACT,SAAgB,IAAI,iBAAwB;IAC5C,SAAgB,IAAI,eAAsB;IAE1C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAAqB;IAErC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAS;IAElB,SAAS,CAAC,GAAG,EAAE,YAAY;IAM3B,KAAK;IAwBL,IAAI;IASX,OAAO,CAAC,gBAAgB;CAS3B;AAED,eAAO,MAAM,QAAQ,SAAgB,CAAC"}

package/_types/_module/Framework/_INIT.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Initializes the Block Factory framework.
+ *
+ * This **must be called exactly once** before using any backend systems
+ * such as threads, entity tasks, or event routing.
+ *
+ * @param packId - Unique identifier for the active pack instance.
+ *
+ * @throws Error if the framework has already been initialized.
+ *
+ * @example
+ * ```ts
+ * _INITIALIZE_BF_FRAMEWORK_("bf:utility_tools");
+ * ```
+ */
+export declare function _INITIALIZE_BF_FRAMEWORK_(packId: string): void;
+export declare function getPackId(): string | undefined;
+export declare function isInitalized(): boolean;
+//# sourceMappingURL=_INIT.d.ts.map

package/_types/_module/Framework/_INIT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_INIT.d.ts","sourceRoot":"","sources":["../../../_module/Framework/_INIT.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAI9D;AAMD,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/_types/_module/Types.d.ts

@@ -0,0 +1,10 @@
+export type Sound = {
+    id: string;
+    length: number;
+};
+export type Animation = {
+    id: string;
+    length: number;
+    loop?: boolean;
+};
+//# sourceMappingURL=Types.d.ts.map

package/_types/_module/Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../_module/Types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB,CAAA"}