@block_factory/lib 0.0.3 → 0.0.4

package/_module/BlockFactory.ts

@@ -0,0 +1,18 @@
+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 { _THREAD_ } from "./sys/Threads";

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/_types/_module/BlockFactory.d.ts

@@ -0,0 +1,16 @@
+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 { _THREAD_ } from "./sys/Threads";
+//# 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,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,QAAQ,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"Threads.d.ts","sourceRoot":"","sources":["../../../_module/sys/Threads.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,cAAM,OAAO;WACK,MAAM,IAAI,OAAO;IAC/B,SAAgB,IAAI,iBAAwB;IAC5C,SAAgB,IAAI,eAAgB;IAC7B,kBAAkB,EAAE,MAAM,CAAK;IAC/B,kBAAkB,EAAE,MAAM,CAAkB;IAEnD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA2B;IAEzC,OAAO;IAgBP,OAAO,CAAC,gBAAgB;CAU3B;AAED,eAAO,MAAM,QAAQ,SAAmB,CAAC"}

package/_types/_module/util/Command.d.ts

@@ -0,0 +1,92 @@
+import { CustomCommand, CommandPermissionLevel, CustomCommandParameter, CustomCommandOrigin, CustomCommandResult } from "@minecraft/server";
+/**
+ * Command utilities and base classes for defining and registering
+ * Minecraft Bedrock custom commands.
+ *
+ * Provides:
+ * - `ICustomCommand` base class
+ * - `RegisterCustomCommand` decorator/function
+ * - Internal command registry used during startup
+ */
+export declare namespace Command {
+    /**
+     * Base class for all custom commands.
+     *
+     * @example
+     * ```ts
+     * import { Command } from "@block_factory/lib";
+     * import {
+     *   world,
+     *   system,
+     *   CommandPermissionLevel,
+     *   CustomCommandParameter,
+     *   CustomCommandParamType,
+     *   CustomCommandOrigin,
+     *   CustomCommandResult,
+     *   CustomCommandStatus
+     * } from "@minecraft/server";
+     *
+     * @Command.RegisterCustomCommand
+     * export default class TestCommand extends Command.ICustomCommand {
+     *   public name = "bf_sd:test_cmd";
+     *   public description = "Test command for debugging purposes.";
+     *   public permissionLevel = CommandPermissionLevel.Admin;
+     *
+     *   public optionalParameters: CustomCommandParameter[] = [
+     *     { type: CustomCommandParamType.Integer, name: "size" }
+     *   ];
+     *
+     *   public execute(
+     *     origin: CustomCommandOrigin,
+     *     value: number
+     *   ): CustomCommandResult | undefined {
+     *     const entity = origin.sourceEntity;
+     *     if (!entity)
+     *       return {
+     *         status: CustomCommandStatus.Failure,
+     *         message: "Command fail"
+     *       };
+     *
+     *     system.run(() => {
+     *       world.sendMessage(`Running Test: ${value}`);
+     *     });
+     *
+     *     return {
+     *       status: CustomCommandStatus.Success,
+     *       message: "Completed Test"
+     *     };
+     *   }
+     * }
+     * ```
+     */
+    abstract class ICustomCommand implements CustomCommand {
+        /** Command identifier (e.g. `bf_sd:test_cmd`) */
+        abstract name: string;
+        /** Short description shown in help */
+        abstract description: string;
+        /** Required permission level to execute */
+        abstract permissionLevel: CommandPermissionLevel;
+        /** Whether cheats must be enabled */
+        cheatsRequired?: boolean;
+        /** Required command parameters */
+        mandatoryParameters?: CustomCommandParameter[];
+        /** Optional command parameters */
+        optionalParameters?: CustomCommandParameter[];
+        /**
+         * Executes the command.
+         * @param origin Command execution context
+         * @param args Parsed command arguments
+         */
+        abstract execute(origin: CustomCommandOrigin, ...args: any[]): CustomCommandResult | undefined;
+    }
+    /** Internal list of registered command instances */
+    const customCommands: ICustomCommand[];
+    /**
+     * Registers a command class.
+     * Can be used as a decorator: `@RegisterCustomCommand`.
+     */
+    function RegisterCustomCommand<T extends {
+        new (): ICustomCommand;
+    }>(customCommand: T): void;
+}
+//# sourceMappingURL=Command.d.ts.map

package/_types/_module/util/Command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../../_module/util/Command.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EAGtB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;GAQG;AACH,yBAAiB,OAAO,CAAC;IACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiDG;IACH,eAAsB,cAAe,YAAW,aAAa;QAEzD,iDAAiD;QACjD,SAAgB,IAAI,EAAE,MAAM,CAAC;QAE7B,sCAAsC;QACtC,SAAgB,WAAW,EAAE,MAAM,CAAC;QAEpC,2CAA2C;QAC3C,SAAgB,eAAe,EAAE,sBAAsB,CAAC;QAExD,qCAAqC;QAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;QAEhC,kCAAkC;QAC3B,mBAAmB,CAAC,EAAE,sBAAsB,EAAE,CAAC;QAEtD,kCAAkC;QAC3B,kBAAkB,CAAC,EAAE,sBAAsB,EAAE,CAAC;QAErD;;;;WAIG;iBACa,OAAO,CACnB,MAAM,EAAE,mBAAmB,EAC3B,GAAG,IAAI,EAAE,GAAG,EAAE,GACf,mBAAmB,GAAG,SAAS;KACrC;IAED,oDAAoD;IAC7C,MAAM,cAAc,EAAE,cAAc,EAAO,CAAC;IAEnD;;;OAGG;IACH,SAAgB,qBAAqB,CACjC,CAAC,SAAS;QAAE,QAAO,cAAc,CAAA;KAAE,EACrC,aAAa,EAAE,CAAC,GAAG,IAAI,CAGxB;CACJ"}

package/{util → _types/_module/util}/Forms/Form.d.ts

@@ -1,16 +1,12 @@
-import { Player, RawMessage } from "@minecraft/server";
-
-export declare type IFormValue =
-    | string
-    | boolean
-    | number
-    | undefined;
-
-export declare abstract class IForm {
-    static returnText: RawMessage | string;
-    static isOccupied(player: Player): boolean;
-    static closeForms(player: Player): void;
-    static closeOccupiedForms(): void;
-    protected setOccupied(player: Player, occupied: boolean): void;
-    protected abstract build(player: Player): void;
-}
+import { Player, RawMessage } from "@minecraft/server";
+export declare type IFormValue = string | boolean | number | undefined;
+export declare abstract class IForm {
+    private static readonly occupiedPlayers;
+    static returnText: RawMessage | string;
+    static isOccupied(player: Player): boolean;
+    static closeForms(player: Player): void;
+    static closeOccupiedForms(): void;
+    protected setOccupied(player: Player, occupied: boolean): void;
+    protected abstract build(player: Player): void;
+}
+//# sourceMappingURL=Form.d.ts.map

package/_types/_module/util/Forms/Form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.d.ts","sourceRoot":"","sources":["../../../../_module/util/Forms/Form.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAS,MAAM,mBAAmB,CAAC;AAG9D,MAAM,CAAC,OAAO,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvE,8BAAsB,KAAK;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAA0B;IACjE,OAAc,UAAU,EAAE,UAAU,GAAG,MAAM,CAAU;WAEzC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;WAInC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;WAIhC,kBAAkB,IAAI,IAAI;IAOxC,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAK9D,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CACjD"}

package/_types/_module/util/Forms/FormAction.d.ts

@@ -0,0 +1,73 @@
+import { IForm } from "./Form";
+import { Player, RawMessage } from "@minecraft/server";
+import { ActionFormData, FormCancelationReason } from "@minecraft/server-ui";
+/**
+ * Constructor type for ActionForm classes.
+ * Used for sub-form navigation and chaining.
+ */
+export type ActionFormCtor<T extends IActionFormData = IActionFormData> = new () => T;
+/**
+ * Options used when adding a button to an ActionForm.
+ */
+export interface IButtonOptions {
+    /**
+     * Logical identifier returned in the form response.
+     * If omitted, the numeric button index is used.
+     */
+    id?: string | number;
+    /**
+     * Optional icon path from a resource pack.
+     */
+    iconPath?: string;
+    /**
+     * Form class to open when this button is selected.
+     */
+    subForm?: ActionFormCtor;
+    /**
+     * Whether the sub-form is allowed to return to this form.
+     * Defaults to true.
+     */
+    allowReturn?: boolean;
+}
+/**
+ * Normalized response object returned by IActionFormData.
+ */
+export interface IActionFormResponse {
+    /**Reason the form was canceled, if applicable.*/
+    readonly cancelationReason?: FormCancelationReason;
+    /** Whether the form was canceled by the player.*/
+    readonly canceled: boolean;
+    /**Raw button index selected by the player.*/
+    readonly selection?: number;
+    /**Logical button id associated with the selection.*/
+    readonly id?: string | number;
+}
+/**
+ * Abstract base class for ActionForm-based menus.
+ *
+ * Provides:
+ * - Button id mapping
+ * - Occupied player handling
+ * - Sub-form chaining with automatic Back navigation
+ * - Normalized response objects
+ */
+export declare abstract class IActionFormData extends IForm {
+    protected form: ActionFormData;
+    private _buttons;
+    private _nextButtonIndex;
+    private _id;
+    protected abstract build(player: Player): void;
+    protected abstract onSubmit(player: Player, response: IActionFormResponse): void;
+    protected onCancel?(player: Player, response: IActionFormResponse): void;
+    title(titleText: RawMessage | string): this;
+    body(bodyText: RawMessage | string): this;
+    divider(): this;
+    header(text: RawMessage | string): this;
+    label(text: RawMessage | string): this;
+    button(text: RawMessage | string, options?: IButtonOptions): this;
+    show(player: Player): Promise<IActionFormResponse>;
+    protected _showChained(player: Player, returnStack: ActionFormCtor[]): Promise<IActionFormResponse>;
+    private _wrapResponse;
+    private _showInternal;
+}
+//# sourceMappingURL=FormAction.d.ts.map

package/_types/_module/util/Forms/FormAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormAction.d.ts","sourceRoot":"","sources":["../../../../_module/util/Forms/FormAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAsB,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAIjG;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,UAAU,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAQD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,iDAAiD;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IACnD,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,8BAAsB,eAAgB,SAAQ,KAAK;IAC/C,SAAS,CAAC,IAAI,EAAE,cAAc,CAAwB;IAEtD,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,GAAG,CAAsB;IAEjC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAE9C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAEhF,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAEjE,KAAK,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAM3C,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAEzC,OAAO,IAAI,IAAI;IAEf,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAEvC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAEtC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI;IAiB/D,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;cAc/C,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIzG,OAAO,CAAC,aAAa;YASP,aAAa;CAwD9B"}

package/{util → _types/_module/util}/Forms/FormMessage.d.ts

@@ -1,30 +1,24 @@
-import { IForm } from "./Form";
-import { Player, RawMessage } from "@minecraft/server";
-import { MessageFormData, MessageFormResponse } from "@minecraft/server-ui";
-
-export declare abstract class IMessageFormData extends IForm {
-    protected form: MessageFormData;
-
-    private _id: string;
-
-    protected abstract build(player: Player): void;
-
-    protected abstract onSubmit(
-        player: Player,
-        response: MessageFormResponse
-    ): void;
-
-    protected onCancel?(player: Player, response: MessageFormResponse): void;
-
-    title(titleText: RawMessage | string): this;
-
-    body(bodyText: RawMessage | string): this;
-
-    button0(text: RawMessage | string, id?: string | number): this;
-
-    button1(text: RawMessage | string, id?: string | number): this;
-
-    show(player: Player): Promise<MessageFormResponse>;
-
-    private _showInternal(player: Player): Promise<MessageFormResponse>;
-}
+import { IForm } from "./Form";
+import { Player, RawMessage } from "@minecraft/server";
+import { MessageFormData, MessageFormResponse } from "@minecraft/server-ui";
+/**
+ * Abstract base class for MessageFormData.
+ *
+ * Provides:
+ * - occupied player handling
+ */
+export type IMessageFormResponse = MessageFormResponse;
+export declare abstract class IMessageFormData extends IForm {
+    protected form: MessageFormData;
+    private _id;
+    protected abstract build(player: Player): void;
+    protected abstract onSubmit(player: Player, response: IMessageFormResponse): void;
+    protected onCancel?(player: Player, response: IMessageFormResponse): void;
+    title(titleText: RawMessage | string): this;
+    body(bodyText: RawMessage | string): this;
+    button0(text: RawMessage | string, id?: string | number): this;
+    button1(text: RawMessage | string, id?: string | number): this;
+    show(player: Player): Promise<IMessageFormResponse>;
+    private _showInternal;
+}
+//# sourceMappingURL=FormMessage.d.ts.map

package/_types/_module/util/Forms/FormMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormMessage.d.ts","sourceRoot":"","sources":["../../../../_module/util/Forms/FormMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACH,eAAe,EACf,mBAAmB,EACtB,MAAM,sBAAsB,CAAC;AAE9B;;;;;GAKG;AAEH,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAEvD,8BAAsB,gBAAiB,SAAQ,KAAK;IAChD,SAAS,CAAC,IAAI,EAAE,eAAe,CAAyB;IAExD,OAAO,CAAC,GAAG,CAAsB;IAEjC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAE9C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,oBAAoB,GAC/B,IAAI;IAEP,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAElE,KAAK,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAS3C,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAIzC,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAC,EAAE,GAAE,MAAM,GAAG,MAAU,GAAG,IAAI;IAKhE,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAC,EAAE,GAAE,MAAM,GAAG,MAAU,GAAG,IAAI;IAK1D,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAgBlD,aAAa;CAiB9B"}

package/{util → _types/_module/util}/Forms/FormModal.d.ts

@@ -1,57 +1,66 @@
-import { IForm, IFormValue } from "./Form";
-import { Player, RawMessage } from "@minecraft/server";
-import { ModalFormData, FormCancelationReason } from "@minecraft/server-ui";
-
-export declare interface IModalFormResponse {
-    readonly cancelationReason?: FormCancelationReason;
-    readonly canceled: boolean;
-    readonly formValues?: IFormValue[];
-    readonly widget?: Map<string, IFormValue>;
-}
-
-export declare interface ITextFieldOptions {
-    id: string;
-    placeholder: string | RawMessage;
-    defaultValue?: string;
-}
-
-export declare interface IDropdownOptions {
-    id: string;
-    choices: string[];
-    defaultValueIndex?: number;
-}
-
-export declare interface ISliderOptions {
-    id: string;
-    min: number;
-    max: number;
-    step: number;
-    defaultValue?: number;
-}
-
-export declare interface IToggleOptions {
-    id: string;
-    defaultValue?: boolean;
-}
-
-export declare abstract class IModalFormData extends IForm {
-    protected form: ModalFormData;
-
-    protected abstract build(player: Player): void;
-
-    protected abstract onSubmit(player: Player, response: IModalFormResponse): void;
-
-    protected onCancel?(player: Player, response: IModalFormResponse): void;
-
-    title(titleText: RawMessage | string): this;
-    divider(): this;
-    header(text: RawMessage | string): this;
-    label(text: RawMessage | string): this;
-
-    textField(label: string | RawMessage, options: ITextFieldOptions): this;
-    dropdown(label: string | RawMessage, options: IDropdownOptions): this;
-    slider(label: string | RawMessage, options: ISliderOptions): this;
-    toggle(label: string | RawMessage, options: IToggleOptions): this;
-
-    show(player: Player): Promise<IModalFormResponse>;
-}
+import { IForm } from "./Form";
+import { Player, RawMessage } from "@minecraft/server";
+import { ModalFormData, FormCancelationReason } from "@minecraft/server-ui";
+export type FormValue = string | boolean | number | undefined;
+/** Normalized response for Modal forms */
+export interface IModalFormResponse {
+    /**Reason the form was canceled, if applicable.*/
+    readonly cancelationReason?: FormCancelationReason;
+    /** Whether the form was canceled by the player.*/
+    readonly canceled: boolean;
+    /** Raw values array from the form */
+    readonly formValues?: FormValue[];
+    /** Mapped values by widget id */
+    readonly widget?: Map<string, FormValue>;
+}
+/** Options for each widget type */
+export interface ITextFieldOptions {
+    id: string;
+    placeholder: string | RawMessage;
+    defaultValue?: string;
+}
+export interface IDropdownOptions {
+    id: string;
+    choices: string[];
+    defaultValueIndex?: number;
+}
+export interface ISliderOptions {
+    id: string;
+    min: number;
+    max: number;
+    step: number;
+    defaultValue?: number;
+}
+export interface IToggleOptions {
+    id: string;
+    defaultValue?: boolean;
+}
+/**
+ * Abstract base class for ModalFormData-based menus.
+ *
+ * Provides:
+ * - Occupied player handling
+ * - Widget id mapping into a Map<string, FormValue>
+ * - Normalized response object
+ */
+export declare abstract class IModalFormData extends IForm {
+    protected form: ModalFormData;
+    private _id;
+    private _widgetMeta;
+    protected abstract build(player: Player): void;
+    protected abstract onSubmit(player: Player, response: IModalFormResponse): void;
+    protected onCancel?(player: Player, response: IModalFormResponse): void;
+    title(titleText: RawMessage | string): this;
+    divider(): this;
+    header(text: RawMessage | string): this;
+    label(text: RawMessage | string): this;
+    textField(label: string | RawMessage, options: ITextFieldOptions): this;
+    dropdown(label: string | RawMessage, options: IDropdownOptions): this;
+    slider(label: string | RawMessage, options: ISliderOptions): this;
+    toggle(label: string | RawMessage, options: IToggleOptions): this;
+    show(player: Player): Promise<IModalFormResponse>;
+    private _wrapResponse;
+    private _mapValues;
+    private _showInternal;
+}
+//# sourceMappingURL=FormModal.d.ts.map

package/_types/_module/util/Forms/FormModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormModal.d.ts","sourceRoot":"","sources":["../../../../_module/util/Forms/FormModal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACH,aAAa,EAEb,qBAAqB,EAKxB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE9D,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IACnD,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IAClC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAC5C;AAED,mCAAmC;AACnC,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AACD,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAQD;;;;;;;GAOG;AACH,8BAAsB,cAAe,SAAQ,KAAK;IAC9C,SAAS,CAAC,IAAI,EAAE,aAAa,CAAuB;IAEpD,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,WAAW,CAAoB;IAEvC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAE9C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAE/E,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAEhE,KAAK,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAM3C,OAAO,IAAI,IAAI;IAKf,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAKvC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAKtC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAOvE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAOrE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAUjE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAO3D,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAc9D,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,UAAU;YAYJ,aAAa;CAoB9B"}

package/_types/_module/util/Forms/FormRegistry.d.ts

@@ -0,0 +1,12 @@
+import { IActionFormData } from "./FormAction";
+import { IModalFormData } from "./FormModal";
+import { IMessageFormData } from "./FormMessage";
+type AnyShowableForm = IActionFormData | IModalFormData | IMessageFormData;
+type AnyShowableCtor = new () => AnyShowableForm;
+export interface IFormRegistration {
+    itemId: string;
+    formCtor: AnyShowableCtor;
+}
+export declare function RegisterForm(itemId: string): <T extends AnyShowableCtor>(formCtor: T) => void;
+export {};
+//# sourceMappingURL=FormRegistry.d.ts.map

package/_types/_module/util/Forms/FormRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormRegistry.d.ts","sourceRoot":"","sources":["../../../../_module/util/Forms/FormRegistry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,KAAK,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAC3E,KAAK,eAAe,GAAG,UAAU,eAAe,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,CAAC;CAC7B;AAID,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,IACtB,CAAC,SAAS,eAAe,EAAE,UAAU,CAAC,KAAG,IAAI,CAKjE"}

package/{util → _types/_module/util}/Math.d.ts

@@ -1,14 +1,20 @@
-import type { Vector2, Vector3 } from "@minecraft/server";
-
+import { Vector2, Vector3 } from "@minecraft/server";
 export declare namespace MathUtils {
+    /** Clamps a number between a minimum and maximum value */
     function clamp(value: number, min: number, max: number): number;
+    /** Linearly interpolates between two values based on a given factor (0 to 1) */
     function lerp(start: number, end: number, factor: number): number;
+    /** Converts degrees to radians */
     function toRadians(degrees: number): number;
+    /** Converts radians to degrees */
     function toDegrees(radians: number): number;
     function fromRotation(rotation: Vector2): Vector3;
     function rotateOffset(offset: Vector3, yawDegrees: number): Vector3;
+    /** Calculates the distance between two points in 3D space */
     function distance3D(pointA: Vector3, pointB: Vector3): number;
+    /** Generates a random integer between min and max (inclusive) */
     function randomInt(min: number, max: number): number;
+    /** Generates a random float between min and max */
     function randomFloat(min: number, max: number): number;
 }
 //# sourceMappingURL=Math.d.ts.map

package/_types/_module/util/Math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Math.d.ts","sourceRoot":"","sources":["../../../_module/util/Math.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAErD,yBAAiB,SAAS,CAAC;IACxB,0DAA0D;IACzD,SAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;IAED,gFAAgF;IAChF,SAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;IAED,kCAAkC;IAClC,SAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;IAED,kCAAkC;IAClC,SAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;IAED,SAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAcvD;IAED,SAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CASzE;IAED,6DAA6D;IAC7D,SAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAKnE;IAED,iEAAiE;IACjE,SAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;IAED,mDAAmD;IACnD,SAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;CACJ"}

package/_types/_module/util/RawText.d.ts

@@ -0,0 +1,60 @@
+import { RawMessage } from '@minecraft/server';
+/**
+ * Utility helpers for building rawtext messages.
+ */
+export declare class RawText {
+    /**
+     * Creates a simple text component.
+     * @param value - The text value.
+     * @returns Text component object.
+     */
+    static text(value: string): RawMessage;
+    /**
+     * Creates a translation component with optional 'with' parameters.
+     * @param key - The translation key.
+     * @param params - The optional parameters for translation.
+     * @returns Translation component object.
+     */
+    static translate(key: string, ...params: string[]): RawMessage;
+    /**
+     * 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.
+     */
+    static score(name: string, objective: string): RawMessage;
+    /**
+     * Wraps various text components into a rawtext structure.
+     * @param rawText - The raw text components.
+     * @returns Raw text object.
+     */
+    static message(...rawText: RawMessage[]): RawMessage;
+    /**
+     * Common formatting and color codes.
+     */
+    static FORMAT: {
+        DarkRed: string;
+        Red: string;
+        Gold: string;
+        Yellow: string;
+        Green: string;
+        Lime: string;
+        Aqua: string;
+        Cyan: string;
+        DarkBlue: string;
+        Blue: string;
+        Magenta: string;
+        Purple: string;
+        White: string;
+        Gray: string;
+        DarkGray: string;
+        Black: string;
+        Obfuscated: string;
+        Bold: string;
+        StrikeThrough: string;
+        Italic: string;
+        Reset: string;
+        NewLine: string;
+    };
+}
+//# sourceMappingURL=RawText.d.ts.map

package/_types/_module/util/RawText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RawText.d.ts","sourceRoot":"","sources":["../../../_module/util/RawText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;GAEG;AACH,qBAAa,OAAO;IAChB;;;;OAIG;WACW,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAI7C;;;;;OAKG;WACW,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU;IAOrE;;;;;OAKG;WACW,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU;IAIhE;;;;OAIG;WACW,OAAO,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU;IAI3D;;OAEG;IACH,OAAc,MAAM;;;;;;;;;;;;;;;;;;;;;;;MAuBnB;CACJ"}