simplified-mojang-jsons 0.0.0-stage → 0.0.2

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HaJuegos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,174 @@
-# Temporary Holding Version
+# 🛠️ Simplified Mojang JSONs
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> [!WARNING]
+> ⚠️ **WORK IN PROGRESS!** ⚠️
+> This repository is constantly evolving and undergoing active updates, so some features or simplified methods may be missing or not yet implemented. Please keep this in mind when using it!
+
+> [!WARNING]
+> 🌐 **COMMENTS IN SPANISH!** 🌐
+> All code comments in this repository are written in **Spanish** and I do not plan to translate them. Identifiers, documentation and public API names are in English.
+
+A lightweight tool to mass-modify and update vanilla JSON files with automated/manual TypeScript export. Say goodbye to tedious bulk updates when vanilla changes break your custom setup—and hello to a cleaner, smarter way to script JSON addons.
+
+## Install:
+
+Just run this in your project root:
+
+```bash
+npm install simplified-mojang-jsons@latest
+```
+
+or via pnpm:
+
+```bash
+pnpm add simplified-mojang-jsons@latest
+```
+
+---
+
+## Build Setup:
+
+To start writing your JSON templates in TypeScript, you need to copy the base generator script into your project.
+
+Add these scripts to your `package.json`:
+
+```json
+"scripts": {
+    "setup:export": "node -e \"const fs = require('fs'); const path = require('path'); const src = require.resolve('simplified-mojang-jsons/exporttojson'); const dest = path.join('scripts', 'generatejsons.ts'); fs.mkdirSync(path.dirname(dest), { recursive: true }); fs.copyFileSync(src, dest); console.log('✅ Export script copied to scripts/generatejsons.ts!');\"",
+    "export:json": "tsx scripts/generatejsons.ts"
+}
+```
+
+Then, run the setup command once in your terminal:
+
+```bash
+npm run setup:export
+```
+
+or via pnpm:
+
+```bash
+pnpm setup:export
+```
+
+This will automatically create a `scripts/generatejsons.ts` file in your project structure.
+
+---
+
+### How to Use
+
+1. Place your TypeScript template files inside your designated **input folder** (by default, the script looks in a `test/` folder or you can adjust it inside your copied `generatejsons.ts`).
+2. Run the export command to compile your TS code and instantly output clean, formatted vanilla JSON files:
+
+```bash
+npm run export:json
+```
+
+or via pnpm:
+
+```bash
+pnpm export:json
+```
+
+---
+
+## Available Modules & Components
+
+The API is split up into several handy modules, components, and pre-made templates to fit whatever your development workflow needs. Here is what's currently available out of the box:
+
+> [!NOTE]
+> **⚠️ Vanilla Templates Notice:** Some pre-made vanilla templates might not be 100% valid or fully functional out of the box in the game due to Minecraft updates or internal structure shifts. Feel free to modify them once they are exported into their final format or tweak them directly in your code!
+
+> [!NOTE]
+> The wrapped modules might not have _every_ single edge case fully mapped out just yet. I'll be adding the rest and keeping things updated to make your dev experience as smooth as possible.
+
+### 1. Custom Builders (`create...`)
+
+Functions designed to programmatically build, structure, and customize your behavior pack JSONs using TypeScript type support and OOP:
+
+```ts
+import {
+    // BP Manifest
+    createBPManifest,
+
+    // BP Stuff's
+    createBPAnimController,
+    createBPBiome,
+    createBPBlock,
+    createBPDialogue,
+    createBPDimension,
+    createBPEntity,
+    createBPFeature,
+    createBPFeatureRule,
+    createBPItemCatalog,
+    createBPItem,
+    createBPLootTable,
+    createBPRecipe,
+    createBPSpawnRule,
+    createBPTrading,
+} from "simplified-mojang-jsons";
+```
+
+### 2. Root Components (`...Components`)
+
+Modular configurations and property wrappers to fine-tune specific behavior features:
+
+- **`BPBiomeComponents`**: Manage biome-specific components like fog, lighting, and sound settings.
+- **`BPBlockComponents`**: Handle block traits, collision boxes, creative categories, and component definitions.
+- **`BPDimensionComponents`**: Configure custom dimension behaviors and environment rules.
+- **`BPEntityComponents`**: Set up entity components such as movement, component groups, and event triggers.
+- **`BPItemComponents`**: Define custom item behaviors, hand actions, and attributes.
+- **`BPSpawnRuleComponents`**: Adjust spawning conditions, mob caps, and herd rules.
+
+```ts
+import {
+    BPBiomeComponents,
+    BPBlockComponents,
+    BPDimensionComponents,
+    BPEntityComponents,
+    BPItemComponents,
+    BPSpawnRuleComponents,
+} from "simplified-mojang-jsons";
+```
+
+### 3. Pre-made Templates (`...Templates`)
+
+Ready-to-use base vanilla templates that you can quickly override, modify, and export:
+
+- **`BPBiomeTemplates`**: Base vanilla biome configurations.
+- **`BPEntityTemplates`**: Base vanilla entity files ready for modification.
+- **`BPFeatureTemplates` & `BPFeatureRuleTemplates`**: World generation and feature rule blueprints.
+- **`BPLootTableTemplates`**: Standard loot tables for blocks, entities, and fishing.
+- **`BPRecipeTemplates`**: Crafting and smelting recipe templates.
+- **`BPSpawnRuleTemplates`**: Default mob spawn rules.
+- **`BPTradingTemplates`**: Villager and wandering trader trade offers.
+
+```ts
+import {
+    BPBiomeTemplates,
+    BPEntityTemplates,
+    BPFeatureTemplates,
+    BPFeatureRuleTemplates,
+    BPLootTableTemplates,
+    BPRecipeTemplates,
+    BPSpawnRuleTemplates,
+    BPTradingTemplates,
+} from "simplified-mojang-jsons";
+```
+
+## Contributing
+
+Got an idea, found a bug, or want to add support for missing vanilla JSON schemas or components? Contributions are more than welcome!
+
+- **Getting Started:** Please check out our [Contributing Guide](.github/CONTRIBUTING.md) before opening a pull request.
+- **Community Guidelines:** Be kind and respectful. See our [Code of Conduct](.github/CODE_OF_CONDUCT.md).
+- **Security:** To report a security vulnerability, please follow the steps in our [Security Policy](.github/SECURITY.md).
+- **Releases:** Check what's new in each update in the [Changelog](.github/CHANGELOG.md).
+
+---
+
+## Author & License
+
+Developed by **[HaJuegos](https://github.com/HaJuegos)**.
+
+This project is licensed under the **[MIT License](LICENSE.md)** — free to use, modify, and distribute in your own Minecraft Bedrock projects.

package/dist/builders/behaviors/ManifestBuilder.d.ts

@@ -0,0 +1,178 @@
+import * as mc from "@minecraft/server";
+import { BPDependenciesParamsTypes, BPMetadataParamsTypes, BPModulesParamsTypes, BPCapabilitiesTypes, BPSubpacksParamsTypes } from "../../types/behaviors/ManifestTemplate";
+/**
+ * Clase principal que define la arquitectura fija de un archivo Manifest de un BehaviorPacks.
+ * @class BehaviorManifest
+ * @author HaJuegos - 60-10-2026
+ * @export
+ */
+export declare class BehaviorManifestBuilder {
+    /**
+     * Version fija del manifest.
+     * @type {number}
+     * @readonly
+     * @private
+     */
+    private readonly manifestVersion;
+    /**
+     * Nombre del add-on. Por defecto esta el texto de abajo.
+     * @type {(string | mc.RawText)}
+     * @private
+     */
+    private namePack;
+    /**
+     * Descripcion del add-on. Por defecto, esta el texto de abajo.
+     * @type {(string | mc.RawText)}
+     * @private
+     */
+    private descPack;
+    /**
+     * Identificador unico del add-on, basado en UUIDv4 de 16 bits. Usa la clase {@link UUIDManager} para asignar un UUID random.
+     * @type {(string | undefined)}
+     * @private
+     */
+    private uuidPack;
+    /**
+     * Version del add-on. Por defecto es [1,0,0]. Tambien se pueden usar etiquetas versionales. Como: "1.0.0-beta".
+     * @type {([number, number, number] | string)}
+     * @private
+     */
+    private versionPack;
+    /**
+     * Version del motor del juego que el add-on va a usar. Por defecto, siempre sera el mas reciente.
+     * @type {([number, number, number] | string)}
+     * @private
+     */
+    private enginePack;
+    /**
+     * Metadatos del add-on. Como derechos de autor o generacion automatica.
+     * @type {(BPMetadataParamsTypes | undefined)}
+     * @private
+     */
+    private metadata;
+    /**
+     * Modulos principales que requiere el add-on para funcionar.
+     * @type {(BPModulesParamsTypes[] | undefined)}
+     * @private
+     */
+    private modules;
+    /**
+     * Capacidades adiccionales que el add-on puede tomar para modificar el juego.
+     * @type {(BPCapabilitiesTypes[] | undefined)}
+     * @private
+     */
+    private capabilities;
+    /**
+     * Dependencias del add-on con otros modulos o add-ons para funcionar.
+     * @type {(BPDependenciesParamsTypes[] | undefined)}
+     * @private
+     */
+    private dependencies;
+    /**
+     * Paquetes adiccionales dentro del add-on activables del mismo.
+     * @type {(BPSubpacksParamsTypes[] | undefined)}
+     * @private
+     */
+    private subpacks;
+    protected constructor();
+    /**
+     * Metodo principal que establece el nombre del add-on. Por defecto hay un texto de ejemplo. Este mismo acepta valores traduccibles por idioma.
+     * @param {string | mc.RawText} name ID o nombre del add-on en concreto.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setNamePack(name: string | mc.RawText): this;
+    /**
+     * Metodo principal que establece la descripcion del add-on. Por defecto, hay un texto de ejemplo. Este mismo acepta valores traduccibles por idioma.
+     * @param {string | mc.RawText} description ID o descripcion del add-on en concreto.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setDescPack(description: string | mc.RawText): this;
+    /**
+     * Metodo auxiliar que establece un UUID v4 de 16 bits random al add-on, si se desea.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setRandomUUIDPack(): this;
+    /**
+     * Metodo principal que establece un UUID v4 de 16 bits fijo para el add-on en concreto. Esto es requerido para que el juego lo reconozca.
+     * @param {string} uuid UUID en concreto a considerar.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setUUIDPack(uuid: string): this;
+    /**
+     * Metodo principal que establece la version del add-on en concreto. Por defecto, siempre sera el valor [1,0,0]. Este mismo tambien admite el formato de versionamiento por tags. Osea "1.0.0-beta".
+     * @param {(string | [number, number, number])} version Versionamiento en concreto del add-on.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setVersionPack(version: string | [number, number, number]): this;
+    /**
+     * Metodo principal que establece la version del motor del juego que el add-on usara. Por defecto siempre usara el mas reciente.
+     * @param {[number, number, number]} version Versionamiento del motor en concreto.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setSpecificMinEngine(version: [number, number, number]): this;
+    /**
+     * Metodo principal que establece metadatos sobre la creacion del add-on, como los autores o creditos.
+     * @param {BPMetadataParamsTypes} params Parametros de los metadatos en concreto.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setMetadata(params: BPMetadataParamsTypes): this;
+    /**
+     * Metodo principal que establece los modulos que usara el add-on en concreto.
+     * @param {BPModulesParamsTypes[]} params Lista de modulos a asignar al add-on.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setModules(params: BPModulesParamsTypes[]): this;
+    /**
+     * Metodo principal que asigna las capacidades adiccionales que tomara el add-on en concreto.
+     * @param {BPCapabilitiesTypes[]} params Lista de capacidades adiccionales a considerar.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setCapabilities(params: BPCapabilitiesTypes[]): this;
+    /**
+     * Metodo principal que establece las dependencias que requiere el add-on en concreto.
+     * @param {BPDependenciesParamsTypes[]} params Lista de dependencias en concreto.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setDependencies(params: BPDependenciesParamsTypes[]): this;
+    /**
+     * Metodo principal que establece los subpacks necesarios del add-on.
+     * @param {BPSubpacksParamsTypes[]} params Lista de subpacks en concreto.
+     * @returns {this} Devuelve la misma clase.
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected setSubpacks(params: BPSubpacksParamsTypes[]): this;
+    /**
+     * Metodo principal que construye la estructura del manifest.json adaptado a la logica requerida para el juego recopilando todos los parametros definidos.
+     * @param {boolean} [stringify] Por defecto esta en false, devolviendo un objecto readonly que no se puede modificar si se llama. Si es true, lo devuelve en formato txt o JSON ya listo para su exportacion.
+     * @returns {string | Record<string, unknown>} Devuelve el manifest listo en sus versiones respectivas.
+     *
+     * @throws {Error} Puede marcar error si, no se establece un UUID fijo o random.
+     *
+     * @author HaJuegos - 06-10-2026
+     * @protected
+     */
+    protected convertToJSON(stringify: true): string;
+    protected convertToJSON(stringify?: false): Record<string, unknown>;
+}
+//# sourceMappingURL=ManifestBuilder.d.ts.map

package/dist/builders/behaviors/ManifestBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestBuilder.d.ts","sourceRoot":"","sources":["../../../src/builders/behaviors/ManifestBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAGxC,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAI5K;;;;;GAKG;AACH,qBAAa,uBAAuB;IAChC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAa;IAE7C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAA4C;IAE5D;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAiD;IAEjE;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAqB;IAErC;;;;OAIG;IACH,OAAO,CAAC,WAAW,CAAgD;IAEnE;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAAkD;IAEpE;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAoC;IAEpD;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAqC;IAEpD;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAoC;IAExD;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAA0C;IAE9D;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAsC;IAEtD,SAAS,eAAmB;IAE5B;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC,OAAO,GAAG,IAAI,CAIrD;IAED;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,EAAE,CAAC,OAAO,GAAG,IAAI,CAI5D;IAED;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI,CAIlC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIxC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAIzE;IAED;;;;;;OAMG;IACH,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAItE;IAED;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAIzD;IAED;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAIzD;IAED;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAI7D;IAED;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,yBAAyB,EAAE,GAAG,IAAI,CAInE;IAED;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAI3D;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACjD,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAoDvE"}

package/dist/builders/behaviors/ManifestTemplateBuilder.d.ts

@@ -0,0 +1,10 @@
+import { BPFinalDefinitionManifest } from "../../types/behaviors/ManifestTemplate";
+/**
+ * Funcion principal de fabrica para la creacion de un Manifest BP vanilla a partir de una definicion fija.
+ * @param {BPFinalDefinitionManifest} def Definicion base de los parametros de la plantilla fija del manifest.
+ * @returns {string} Devuelve la plantilla base ya creada y adaptada para el JSON final.
+ * @author HaJuegos - 06-10-2026
+ * @export
+ */
+export declare function createBPManifest(def: BPFinalDefinitionManifest): string;
+//# sourceMappingURL=ManifestTemplateBuilder.d.ts.map

package/dist/builders/behaviors/ManifestTemplateBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestTemplateBuilder.d.ts","sourceRoot":"","sources":["../../../src/builders/behaviors/ManifestTemplateBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAmEnF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,yBAAyB,GAAG,MAAM,CAEvE"}

package/dist/builders/behaviors/animControllers/AnimControllerBuilder.d.ts

@@ -0,0 +1,71 @@
+import { AnimControllerStatesTypes } from "../../../types/behaviors/animContollers/AnimControllerTemplate";
+/**
+ * Clase principal de base para la creacion de controladores de animaciones para Behaviors Packs.
+ * @class BehaviorAnimControllerBuilder
+ * @author HaJuegos - 07-10-2026
+ * @export
+ */
+export declare class BehaviorAnimControllerBuilder {
+    /**
+     * Version del controlador. Por defecto siempre sera el mas estable o reciente. En este caso "1.10.0"
+     * @type {string}
+     * @private
+     */
+    private animVersion;
+    /**
+     * ID del controlador a crear.
+     * @type {(string | undefined)}
+     * @private
+     */
+    private idAnim;
+    /**
+     * Estado inicial a ejecutar cuando el controlador es inicializado.
+     * @type {(string | undefined)}
+     * @private
+     */
+    private initialState;
+    /**
+     * Todos los estados que contiene el controlador.
+     * @type {Record<string, AnimControllerStatesTypes>}
+     * @private
+     */
+    private states;
+    protected constructor();
+    /**
+     * Metodo principal que establece el ID al controlador a crear.
+     * @param {string} idAnim ID del controlador.
+     * @returns {this} Devuelve el mismo objecto por ser un metodo de propiedades.
+     * @author HaJuegos - 07-10-2026
+     * @protected
+     */
+    protected setIDAnim(idAnim: string): this;
+    /**
+     * Metodo principal que asigna el estado inicial a ejecutar al controlador.
+     * @param {string} stateID ID del estado a asignar.
+     * @returns {this} Devuelve el mismo objecto por ser un metodo de propiedades.
+     * @author HaJuegos - 07-10-2026
+     * @protected
+     */
+    protected setInitialState(stateID: string): this;
+    /**
+     * Metodo principal que asigna la lista de estados a crear en el controlador.
+     * @param {Record<string, AnimControllerStatesTypes>} listStates Lista de estados en concreto.
+     * @returns {this} Devuelve el mismo objecto por ser un metodo de propiedades.
+     * @author HaJuegos - 07-10-2026
+     * @protected
+     */
+    protected setStates(listStates: Record<string, AnimControllerStatesTypes>): this;
+    /**
+     * Metodo principal que convierte toda la plantilla general a una JSON con estructura fija lista para su exportacion.
+     * @param {boolean} stringify Si se establece en true, devuelve el objecto en formato de TXT listo para un JSON.
+     * @returns {string | Record<string, unknown>} Devuelve un string o un objecto readonly dependiendo el argumento asignado.
+     *
+     * @throws {Error} Puede pasar error si, no se establece un ID al controllador de la animacion.
+     *
+     * @author HaJuegos - 07-10-2026
+     * @protected
+     */
+    protected convertToJSON(stringify: true): string;
+    protected convertToJSON(stringify?: false): Record<string, unknown>;
+}
+//# sourceMappingURL=AnimControllerBuilder.d.ts.map

package/dist/builders/behaviors/animControllers/AnimControllerBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimControllerBuilder.d.ts","sourceRoot":"","sources":["../../../../src/builders/behaviors/animControllers/AnimControllerBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gEAAgE,CAAC;AAG3G;;;;;GAKG;AACH,qBAAa,6BAA6B;IACtC;;;;OAIG;IACH,OAAO,CAAC,WAAW,CAAoB;IAEvC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAqB;IAEnC;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAqB;IAEzC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAiD;IAE/D,SAAS,eAAmB;IAE5B;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAIxC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;IAED;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,GAAG,IAAI,CAI/E;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACjD,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CA0BvE"}

package/dist/builders/behaviors/animControllers/AnimControllerTemplateBuilder.d.ts

@@ -0,0 +1,10 @@
+import { BPAnimControllerFinalDefinition } from "../../../types/behaviors/animContollers/AnimControllerTemplate";
+/**
+ * Funcion principal de fabrica para la creacion de un Controlador de Animacion a patir de una definicion fija.
+ * @param {BPAnimControllerFinalDefinition} def Definicion base de los parametros para la plantilla fija.
+ * @returns {string} Devuelve la plantilla base ya creada y adaptada a txt para el JSON final.
+ * @author HaJuegos - 08-10-2026
+ * @export
+ */
+export declare function createBPAnimController<TStates extends string>(def: BPAnimControllerFinalDefinition<TStates>): string;
+//# sourceMappingURL=AnimControllerTemplateBuilder.d.ts.map

package/dist/builders/behaviors/animControllers/AnimControllerTemplateBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimControllerTemplateBuilder.d.ts","sourceRoot":"","sources":["../../../../src/builders/behaviors/animControllers/AnimControllerTemplateBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,gEAAgE,CAAC;AAoCjH;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,SAAS,MAAM,EAAE,GAAG,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAAG,MAAM,CAEpH"}

package/dist/builders/behaviors/biomes/BiomeBuilder.d.ts

@@ -0,0 +1,58 @@
+import { BehaviorBiomeComponentBulder } from "./BiomeCompBuilder";
+/**
+ * Clase principal que define la estructura fija de un archivo Biome de un BP.
+ * @class BehaviorBiomeBuilder
+ * @author HaJuegos - 15-10-2026
+ * @export
+ */
+export declare class BehaviorBiomeBuilder {
+    /**
+     * Version fija del format version del bioma en concreto a crear.
+     * @type {string}
+     * @readonly
+     * @private
+     */
+    private readonly versionBiome;
+    /**
+     * ID del bioma a crear en concreto.
+     * @type {string}
+     * @readonly
+     * @private
+     */
+    private readonly idBiome;
+    /**
+     * (Opcional) Componentes del bioma en concreto a crear.
+     * @type {(BehaviorBiomeComponentBulder<any>[] | undefined)}
+     * @private
+     */
+    private comps;
+    /**
+     * Parametros y eventos iniciales de la clase cuando es llamada o inicializada.
+     * @param {string} idBiome ID del bioma a crear.
+     * @author HaJuegos - 15-10-2026
+     * @constructor
+     * @protected
+     */
+    protected constructor(idBiome: string);
+    /**
+     * Metodo principal auxiliar que asigna los componentes del archivo Biome a crear en concreto.
+     * @param {BehaviorBiomeComponentBulder<any>[]} comps Lista de componentes a asignar en cuestion.
+     * @returns {this} Devuelve la misma clase debido a que es un metodo de propiedades.
+     * @author HaJuegos - 15-10-2026
+     * @protected
+     */
+    protected setComponentsBiome(comps: BehaviorBiomeComponentBulder<any>[]): this;
+    /**
+     * Metodo principal que construye la estructura del biome.json adaptado a la logica requerida para el juego recopilando todos los parametros definidos.
+     * @param {boolean} [stringify] Por defecto esta en false, devolviendo un objecto readonly que no se puede modificar si se llama. Si es true, lo devuelve en formato txt o JSON ya listo para su exportacion.
+     * @returns {string | Record<string, unknown>} Devuelve el biome listo en sus versiones respectivas.
+     *
+     * @throws {Error} Puede marcar error si, no se fijo un ID al biome.
+     *
+     * @author HaJuegos - 15-10-2026
+     * @protected
+     */
+    protected convertToJSON(stringify: true): string;
+    protected convertToJSON(stringify?: false): Record<string, unknown>;
+}
+//# sourceMappingURL=BiomeBuilder.d.ts.map

package/dist/builders/behaviors/biomes/BiomeBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BiomeBuilder.d.ts","sourceRoot":"","sources":["../../../../src/builders/behaviors/biomes/BiomeBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IAEnD;;;;OAIG;IACH,OAAO,CAAC,KAAK,CAAkD;IAE/D;;;;;;OAMG;IACH,SAAS,aAAc,OAAO,EAAE,MAAM,EAErC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,4BAA4B,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAI7E;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACjD,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CA6BvE"}

package/dist/builders/behaviors/biomes/BiomeCompBuilder.d.ts

@@ -0,0 +1,57 @@
+import { BPComponent, BuiltComponent } from "../../../types/behaviors/entities/EntitiesComps";
+/**
+ * Clase principal abstracta que sigue una estrutura fija para la creacion de un componente basado en el archivo de biomes.
+ * @class BehaviorBiomeComponentBulder
+ * @template {BPComponent} Component Datos del componente en concreto a crear.
+ * @template {string} ID ID del componente en concreto a crear.
+ * @author HaJuegos - 15-10-2026
+ * @abstract
+ * @export
+ */
+export declare abstract class BehaviorBiomeComponentBulder<Component extends BPComponent, ID extends string = string> {
+    /**
+     * ID del componente en concreto a crear.
+     * @type {ID}
+     * @protected
+     * @readonly
+     */
+    protected readonly idComponent: ID;
+    /**
+     * Datos del componente en concreto a crear.
+     * @type {?Component}
+     * @protected
+     */
+    protected data?: Component;
+    /**
+     * Parametros iniciales y eventos cuando la clase es llamada o inicializada. Para la creacion de un componente a base de biomes.
+     * @param {ID} idComp ID del componente en cuestion a crear.
+     * @param {?Component} [data] (Opcional) Datos del componente en concreto a crear.
+     * @author HaJuegos - 15-10-2026
+     * @constructor
+     * @public
+     */
+    constructor(idComp: ID, data?: Component);
+    /**
+     * Metodo auxiliar de tipo GET para obtener el ID fijo del componente en concreto a crear.
+     * @type {ID}
+     * @author HaJuegos - 15-10-2026
+     * @readonly
+     * @public
+     */
+    get idComp(): ID;
+    /**
+     * Metodo auxiliar que obtiene los datos definidos del componente en concreto a crear.
+     * @returns {(Component | undefined)} Devuelve los datos del componente en cuestion.
+     * @author HaJuegos - 15-10-2026
+     * @protected
+     */
+    protected getCompData(): Component | undefined;
+    /**
+     * Metodo principal auxiliar que construye el componente final a crear en concreto.
+     * @returns {BuiltComponent} Devuelve el componente preparado y listo con su estructura ya preparada.
+     * @author HaJuegos - 15-10-2026
+     * @public
+     */
+    build(): BuiltComponent;
+}
+//# sourceMappingURL=BiomeCompBuilder.d.ts.map

package/dist/builders/behaviors/biomes/BiomeCompBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BiomeCompBuilder.d.ts","sourceRoot":"","sources":["../../../../src/builders/behaviors/biomes/BiomeCompBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAG9F;;;;;;;;GAQG;AACH,8BAAsB,4BAA4B,CAC9C,SAAS,SAAS,WAAW,EAC7B,EAAE,SAAS,MAAM,GAAG,MAAM;IAE1B;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;IAEnC;;;;OAIG;IACH,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAE3B;;;;;;;OAOG;IACH,YAAoB,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,SAAS,EAG/C;IAED;;;;;;OAMG;IACH,IAAW,MAAM,IAAI,EAAE,CAEtB;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAW,IAAI,SAAS,GAAG,SAAS,CAE7C;IAED;;;;;OAKG;IACI,KAAK,IAAI,cAAc,CAI7B;CACJ"}

package/dist/builders/behaviors/biomes/BiomeTemplateBuilder.d.ts

@@ -0,0 +1,40 @@
+import { BehaviorBiomeBuilder } from "../../../builders/behaviors/biomes/BiomeBuilder";
+import { BPBiomeComponent } from "../../../types/behaviors/biomes/BiomeCompsTemplate";
+import { BPBiomeDefinition, BPBiomeOverride, BPBiomeTemplateInstance } from "../../../types/behaviors/biomes/BiomeTemplate";
+/**
+ * Clase principal que construye el archivo final del biome en su estructura fija con los datos asignados en concreto.
+ * @class FinalBiomeBuilderTemplate
+ * @extends {BehaviorBiomeBuilder}
+ * @author HaJuegos - 15-10-2026
+ * @export
+ */
+export declare class FinalBiomeBuilderTemplate extends BehaviorBiomeBuilder {
+    /**
+     * Parametros principales y eventos para la creacion de un archivo biome con una estructura fija final.
+     * @param {BPBiomeDefinition} def Datos principales para la creacion de una plantilla base.
+     * @param {BPBiomeOverride<any>} over (Opcional) Datos post-edicion para la modificacion de la plantilla base creada.
+     * @author HaJuegos - 15-10-2026
+     * @constructor
+     * @public
+     */
+    constructor(def: BPBiomeDefinition, over: BPBiomeOverride<any>);
+    /**
+     * Metodo final principal que convierte toda la plantilla definitiva en un JSON en texto estructurado.
+     * @returns {string} Devuelve el JSON final en su estructura definitiva.
+     * @author HaJuegos - 30-09-2026
+     * @public
+     */
+    finalBuild(): string;
+}
+/**
+ * Funcion principal de fabrica para exponer la estructura fija final para la creacion de un archivo biome con todas las estructuras necesarias para la creacion base y post-edicion.
+ * @param {(BPBiomeDefinition & { components?: Comps; })} def Definicion base a crear para la plantilla.
+ * @template {readonly BPBiomeComponent[]} Comps Componentes del archivo biomes asignados en concreto.
+ * @returns {BPBiomeTemplateInstance<Comps>} Devuelve una funcion para la post-edicion despues de la creacion de la plantilla base para la libre edicion del mismo.
+ * @author HaJuegos - 15-10-2026
+ * @export
+ */
+export declare function createBPBiome<const Comps extends readonly BPBiomeComponent[] = []>(def: BPBiomeDefinition & {
+    components?: Comps;
+}): BPBiomeTemplateInstance<Comps>;
+//# sourceMappingURL=BiomeTemplateBuilder.d.ts.map

package/dist/builders/behaviors/biomes/BiomeTemplateBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BiomeTemplateBuilder.d.ts","sourceRoot":"","sources":["../../../../src/builders/behaviors/biomes/BiomeTemplateBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAG5H;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,oBAAoB;IAC/D;;;;;;;OAOG;IACH,YAAoB,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC,EAoCrE;IAED;;;;;OAKG;IACI,UAAU,IAAI,MAAM,CAE1B;CACJ;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CACzB,KAAK,CAAC,KAAK,SAAS,SAAS,gBAAgB,EAAE,GAAG,EAAE,EACtD,GAAG,EAAE,iBAAiB,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,CAAC;CAAE,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAIlF"}