Changelog

Version: 0.2.4
Date: 2026-05-19
  Bugfixes:
    - Corrected the exported Forgeworks Core remote/library version constant to 0.2.4.
  Documentation:
    - Added a module API index for converted mods.
    - Added a conversion guide for moving project-local helpers into Forgeworks Core.
    - Added a validated consumers note for the current converted mod set.
    - Refreshed usage examples to use the 0.2.x dependency floor.
  Notes:
    - This is a stabilization/documentation release after successful load tests with IPO, Stellar Foundry, Planet Crafter: Nauvis Reborn, Biter Born, and Real Industrial Chemistry.
    - No gameplay content was added.
    - Forgeworks Core remains self-contained with no third-party hard dependencies.

Version: 0.2.3
Date: 2026-05-19
  Features:
    - Added loader helpers for deterministic manifest-based data-stage content loading.
    - Added icon helpers for direct and layered icon assignment contracts.
    - Expanded prototype helpers with item/fluid/recipe/technology existence checks and stack normalization helpers.
    - Expanded recipe, technology, and validation helpers for whole-overhaul data-stage conversion work.
  Notes:
    - Introduced during the Real Industrial Chemistry / Industrial Alchemy conversion.
    - Forgeworks Core remains self-contained with no third-party hard dependencies and still defines no gameplay content.

Version: 0.2.2
Date: 2026-05-19
  Features:
    - Added persistent queue helpers for converted runtime systems.
    - Added a bundled transparent empty sprite for mods that need a dependency-owned blank render shell.
  Internal:
    - Added Biter Born runtime conversion baseline notes.
    - Kept Forgeworks Core self-contained with no third-party hard dependencies.

Version: 0.2.1
Date: 2026-05-19
  Features:
    - Added fluid connection category helpers for safely adding pipe connection categories to single entities, all assembling-machine inputs, or individual fluid boxes.
    - Helpers normalize nil/string/table connection_category fields and deduplicate categories instead of producing duplicate connector entries.
  Notes:
    - Introduced during the Plasma Industries / Plasma Crafter conversion so plasma connector compatibility can live in Core instead of local one-off loops.
    - Forgeworks Core still has no third-party hard dependencies and still defines no gameplay content.

Version: 0.2.0
Date: 2026-05-19
  Features:
    - Added route-graph helpers for native Space Age route chains, pair pruning, keep-lists, route sanitizing, and required-route validation.
    - Added starmap layout helpers for board coordinates, local cluster placement, label orientation, orbit visibility, starmap icon application, and marker creation.
    - Added optional dependency helpers for safe checks/calls without adding third-party hard dependencies.
    - Added prototype cleanup helpers for focused deletion/property/icon cleanup passes.
    - Added space-location and space-connection facade modules for clearer require paths in consuming mods.
  Notes:
    - This is the first 0.2.x baseline informed by the Stellar Foundry and IPO proof conversions.
    - Forgeworks Core still has no third-party hard dependencies and still defines no gameplay content.

Version: 0.1.9
Date: 2026-05-19
  Bugfixes:
    - Space route endpoint normalization now rejects unresolved aliases instead of returning raw candidate text as a prototype endpoint.
    - Prevents consuming mods from creating invalid native space-connection prototypes that point at non-existent marker names.
    - Mirrors newly-created space locations into data.raw for same-stage route builders and validators.
  Notes:
    - Still has no third-party hard dependencies.

Version: 0.1.8
Date: 2026-05-19
  Bugfixes:
    - Ensured native space-connection helpers always provide a required icon/icon_size, including marker routes whose endpoints have no icon fields.
    - Added a base-game fallback icon for dependency bridge/edge routes so repaired route prototypes do not fail Factorio prototype validation.

Version: 0.1.7
Date: 2026-05-19
  Bugfixes:
    - Normalizes native space-connection endpoints before prototype creation so aliases, candidate tables, and copied prototype records cannot leak table values into from/to fields.
    - Invalid existing route endpoints are repaired or discarded instead of being preserved into final prototype validation.
  Notes:
    - Still has no third-party hard dependencies.

Version: 0.1.6
Date: 2026-05-19
  Bugfixes:
    - Hardened space-connection creation so newly repaired routes are mirrored into data.raw immediately for same-stack final validation passes.
    - Keeps native Factorio 2.0 route creation self-contained without third-party library dependencies.

Version: 0.1.5
Date: 2026-05-19
  Features:
    - Added native Factorio 2.0 space-location and space-connection helpers for mods that should not hard-depend on third-party starmap libraries.
    - Added prototype upsert helpers for safe data-stage replacement/extension workflows.
    - Added technology helpers for existence checks, clean prerequisite replacement, and space-location unlock effects.
  Notes:
    - Still has no third-party hard dependencies.

Version: 0.1.4
Date: 2026-05-19
  Features:
    - Added migration version-marker helpers for consuming mods that need explicit, namespaced save markers.
    - Added safe GUI event-element helpers for click/drag handlers.
    - Added runtime event handler count diagnostics for conversion QA.
  Bugfixes:
    - Corrected the exported core version constant to match the packaged release version.
  Notes:
    - This is the first polished Forgeworks Core baseline after the Stellar Foundry 2.2.8 proof conversion.
    - Forgeworks Core still has no third-party hard dependencies.

Version: 0.1.3
Date: 2026-05-19
  Features:
    - Added safe LuaGuiElement inspection helpers for runtime GUI handlers.
    - Added helpers for valid-element checks, safe element names, safe element locations, and safe child lookup.
  Bugfixes:
    - Prevents consuming mods from needing to read LuaGuiElement.name or LuaGuiElement.location before confirming the element is still valid.

Version: 0.1.2
Date: 2026-05-19
  Bugfixes:
    - Fixed runtime-stage detection for Factorio LuaBootstrap userdata.
    - Fixed LuaObject/player validation so runtime objects are accepted as userdata, not only tables.
    - Fixed runtime game/remote object checks used by GUI, surface, and remote helpers.

Version: 0.1.1
Date: 2026-05-19
  Bugfixes:
    - Fixed the packaged recipe and event helper modules so they expose their intended APIs instead of the entity helper body.
  Features:
    - Added a shared runtime event dispatcher that composes multiple handlers for the same Factorio event.
    - Added scheduled tick task helpers compatible with the small subset of flib on-tick-n previously used by Stellar Foundry.
    - Added position helpers for tile conversion, subtraction, addition, lerp, and distance calculations.
  Notes:
    - Still has no third-party hard dependencies.

Version: 0.1.0
Date: 2026-05-19
  Features:
    - Initial Forgeworks Core library release.
    - Added self-contained data-stage helpers for prototypes, recipes, technologies, unlocks, items, fluids, entities, planets, and compatibility checks.
    - Added runtime helpers for event dispatching, GUI element handling, namespaced storage, remote interfaces, and migration guards.
    - Added validation and assertion helpers designed to fail loudly when required prototypes or runtime structures are missing.
    - Added documentation for dependency wiring, require paths, conversion strategy, and library contracts.
  Notes:
    - Forgeworks Core has no third-party hard dependencies.
    - Other libraries may be studied or optionally supported by consuming mods, but they are not required by this library.