@datamoc/mw_games 0.33.0 → 0.35.0

package/CHANGELOG.md

@@ -7,6 +7,39 @@ the public API may still change between minor versions.
 
 ## [Unreleased]
 
+## [0.35.0] - 2026-10-11
+
+A Lua integration host for games that need synchronous API results and resumable dialogue, an offline Lua to JavaScript translator, and the Lua dependency moves to `@datamoc/fengari` 0.5.2.
+
+### Added
+
+- `createFengariRuntime` on the optional `mwl/fengari` subpath: synchronous host functions with results, live indexed table bindings, owned Lua callback/table references, embedded `require`/`dofile`, and host-driven coroutines with request values and scene answers. `luaToJs` translates Lua source to readable JavaScript offline (fengari 0.5.0's `lua2js`), flagging untranslatable constructs, for a game leaving Lua scripting. The existing JSON-only `ScriptHost` stays unchanged. Calls, module compilation and coroutine resumes share bounded execution, with a fresh budget for each top-level operation.
+
+### Changed
+
+- The optional Lua dependency moves to `@datamoc/fengari` `^0.5.2`, whose shipped TypeScript declarations replace the old `@ts-expect-error` import and the hand-written `luaToJs` types, and whose `vm.protect` and `vm.throwLuaError` replace the host-side protected-call code. The host reuses `FengariVm`'s execution guard while retaining text-only compilation, JSON-shaped tables and seeded randomness.
+
+### Fixed
+
+- Lua instruction limits now interrupt native table moves and string searches, and cannot be swallowed by `pcall`, `xpcall` message handlers or coroutine resumes. Parsing and execution still share the per-call string/buffer allocation budget. The `ScriptHost` sandbox also drops `string.dump` and fengari's internal `__random`, which scripts could still reach.
+
+## [0.34.0] - 2026-10-10
+
+Hex grids for the cave, dungeon and overworld generators, and the Lua host moves to the `@datamoc/fengari` 0.3.0 fork (`<const>`, `<close>`, `coroutine.close`).
+
+### Added
+
+- `shape: 'hex'` on `generateDungeon`/`generateDungeonGraph`, `generateCave` and `generateOverworld`: the generators lay their output out on a hex grid (odd-q offsets, as `Level` does) instead of squares. The dungeon and cave `Level` carry the hex shape; a dungeon corridor leg runs as a hex line and `furthestRoom` counts hex steps on a hex level; a cave grows chambers by hex distance and walks passages by true on-screen distance, so a chamber is round rather than a skewed diamond; the overworld samples its value noise where each hex is drawn and steps rivers and roads across the six edges, with settlement spacing and the near-water test in hex steps. Square output is unchanged byte for byte.
+- `generateCave` accepts `random`, a `RandomSource`, in place of `seed`: the cave draws from that stream and advances it, and the ambient `Random` stack is left alone. Passing neither is refused by name.
+
+### Changed
+
+- `@datamoc/fengari` moves to `^0.3.0`. Lua scripts in `mwl/fengari` and `ai/lua` now accept `<const>` and `<close>` variables and `coroutine.close`; a limit error (instructions or memory) unwinds through pending `__close` handlers, and a handler cannot buy extra instructions after the limit fired.
+
+### Fixed
+
+- `mwg_emit(name, payload)` called from inside a coroutine read its payload from the main thread's stack, so it returned garbage or failed; it now reads from the calling coroutine.
+
 ## [0.33.0] - 2026-10-10
 
 Seven roadmap items in one release: the Wesnoth port's proposal file is now fully answered

package/api-surface.json

@@ -8963,18 +8963,78 @@
 		"subpath": "./mwl",
 		"declaringModule": "mwl/schema.d.ts"
 	},
+	{
+		"name": "createFengariRuntime",
+		"kind": "function",
+		"subpath": "./mwl/fengari",
+		"declaringModule": "mwl/fengari-runtime.d.ts"
+	},
 	{
 		"name": "createFengariScriptHost",
 		"kind": "function",
 		"subpath": "./mwl/fengari",
 		"declaringModule": "mwl/fengari.d.ts"
 	},
+	{
+		"name": "FengariCoroutine",
+		"kind": "interface",
+		"subpath": "./mwl/fengari",
+		"declaringModule": "mwl/fengari-runtime.d.ts"
+	},
+	{
+		"name": "FengariReference",
+		"kind": "interface",
+		"subpath": "./mwl/fengari",
+		"declaringModule": "mwl/fengari-runtime.d.ts"
+	},
+	{
+		"name": "FengariRuntime",
+		"kind": "interface",
+		"subpath": "./mwl/fengari",
+		"declaringModule": "mwl/fengari-runtime.d.ts"
+	},
+	{
+		"name": "FengariRuntimeOptions",
+		"kind": "interface",
+		"subpath": "./mwl/fengari",
+		"declaringModule": "mwl/fengari-runtime.d.ts"
+	},
 	{
 		"name": "FengariScriptHostOptions",
 		"kind": "interface",
 		"subpath": "./mwl/fengari",
 		"declaringModule": "mwl/fengari.d.ts"
 	},
+	{
+		"name": "FengariTableBinding",
+		"kind": "interface",
+		"subpath": "./mwl/fengari",
+		"declaringModule": "mwl/fengari-runtime.d.ts"
+	},
+	{
+		"name": "FengariValue",
+		"kind": "type",
+		"subpath": "./mwl/fengari",
+		"declaringModule": "mwl/fengari-runtime.d.ts"
+	},
+	{
+		"name": "luaToJs",
+		"kind": "function",
+		"subpath": "./mwl/fengari",
+		"declaringModule": "mwl/fengari.d.ts"
+	},
+	{
+		"name": "LuaToJsOptions",
+		"kind": "type",
+		"subpath": "./mwl/fengari",
+		"declaringModule": "mwl/fengari.d.ts"
+	},
+	{
+		"name": "LuaToJsResult",
+		"kind": "type",
+		"subpath": "./mwl/fengari",
+		"declaringModule": "mwl/fengari.d.ts"
+	},
 	{
 		"name": "AbilityCycle",
 		"kind": "class",