@datamoc/mw_games 0.31.0 → 0.33.0

package/CHANGELOG.md

@@ -7,6 +7,73 @@ the public API may still change between minor versions.
 
 ## [Unreleased]
 
+## [0.33.0] - 2026-10-10
+
+Seven roadmap items in one release: the Wesnoth port's proposal file is now fully answered
+(405 shipped with 0.32.0, 406/407/409 this release, 408's first half, 401 parked with the
+port), alongside the skeletal puppet pair (399/400), SVG as inbound data (398), the overworld
+generator (410), and the Lua host riding the fork's new allocation hook.
+
+### Added
+
+- `skeleton`, a new renderer-free root module (roadmap 399): a bone tree where a pose is one
+  rotation per bone, keyframed clips (plain JSON, interpolation, looping, playback rate,
+  crossfade), and additive layers mixing by priority that displace only the bones they name.
+  `two-d/render` gains the drawing half (400): `SkeletalSprite` binds parts to bones by
+  name, and `ArticulatedChain`/`ChainRig` draw a follower-rule spine with per-segment
+  rotation limits.
+- `roguelike.generateCave` (407): chambers grown as blobs (`jagged`), winding passages
+  (`windiness`, `width`, `chance`), starts with cleared rings, village density, and a forced
+  join so a cave is always connected. `roguelike.generateOverworld` (410): seeded elevation
+  and moisture fields classify seven terrains behind a `seaLevel` knob, rivers run downhill
+  to the sea and drown lakes at ridges, settlements place themselves by suitability and join
+  into a road tree that prefers flat ground (water a ford, not a wall), points of interest
+  carry `leadsTo`, and every cell carries a coarse region id.
+- `assets` SVG inbound rules (398): `sanitizeSvg` refuses what it cannot prove inert by name,
+  `svgScaleVariants` rasterizes one source per named scale, `splitSvgGroups` loads one part
+  per top-level `<g>` group.
+- `testing` gains `createSceneControls` (408's first half): named steps a game opts into,
+  driven by name, refused by name when unknown - the seam a headless driver calls a game's
+  private scene flow through.
+
+### Changed
+
+- `mwl/fengari` now requires `@datamoc/fengari@^0.2.0` and enforces `memoryLimit` through the
+  fork's per-state allocation hook (`lua_setallocf`) instead of swapping the global
+  `Uint8Array` constructor mid-call: no global mutation (and so no reentrancy hazard between
+  hosts on one page), parsing is inside the budget, host callbacks allocate freely, and a
+  refused allocation surfaces to scripts as Lua's standard `not enough memory` while the
+  host still rejects the call.
+- MWL `test=` expressions can call `have_unit`/`have_location` and registered predicate hooks
+  directly (406), `[while]` traces `while_limit` when its cap is reached with the condition
+  still true (`on_limit=error` makes it a hard failure), and `[condition]` accepts free
+  predicate attributes.
+
+## [0.32.0] - 2026-10-10
+
+The optional Lua host hardens around what the `@datamoc/fengari` fork offers, and the
+phantom-leader bug the Wesnoth port's scenarios exposed is fixed.
+
+### Changed
+
+- `mwl/fengari` moves to the `@datamoc/fengari` fork (Lua 5.4) and opens only the
+  sandbox-safe Lua standard libraries (base, coroutine, math, string, table, utf8) through
+  the fork's `luaL_openselectedlibs`: `io`, `os`, `debug` and `package` with its `require`
+  are never constructed - identically in Node and the browser - instead of being opened and
+  then nil'd. Chunks now compile in text mode, so a binary `\x1bLua` dump is rejected instead
+  of reaching the bytecode undumper.
+- Roadmap item 390 (the tourney chess engine) is closed by accepting its recorded split:
+  4-piece tablebases stay a `tools/build-tablebases.mjs` run away rather than shipping tens
+  of megabytes per ending; the compiled 3-piece tables stay under `data/tablebases`.
+
+### Fixed
+
+- `MwlRuntime` no longer spawns a phantom leader when a `[side]`'s `leader=` names an
+  already-declared unit: the named unit is the leader, a known unit type still spawns one
+  leader per free start cell with its real stats, and a value that is neither is refused by
+  name instead of creating a 1-hp, 0-move ghost (roadmap 405, which broke about ten of the
+  Wesnoth port's scenarios with "unknown unit type").
+
 ## [0.31.0] - 2026-10-09
 
 Two pixel-dungeon proposals: P43, `SpriteMotion` (squash, hop, bob, wobble, spin, shear and flip over `Tweener`, reduced-motion aware), and P42, camera snapping in whole device pixels, which closes the thin tile seams at a fractional `devicePixelRatio`.

package/api-surface.json

@@ -131,6 +131,12 @@
 		"subpath": ".",
 		"declaringModule": "two-d/render/ImageModifiers.d.ts"
 	},
+	{
+		"name": "ArticulatedChain",
+		"kind": "class",
+		"subpath": ".",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
 	{
 		"name": "assertAutotileLayout",
 		"kind": "function",
@@ -383,6 +389,18 @@
 		"subpath": ".",
 		"declaringModule": "core/Grid.d.ts"
 	},
+	{
+		"name": "ChainOptions",
+		"kind": "interface",
+		"subpath": ".",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
+	{
+		"name": "ChainRig",
+		"kind": "class",
+		"subpath": ".",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
 	{
 		"name": "channelScaleMatrix",
 		"kind": "function",
@@ -2645,6 +2663,18 @@
 		"subpath": ".",
 		"declaringModule": "core/Sanitize.d.ts"
 	},
+	{
+		"name": "SkeletalSprite",
+		"kind": "class",
+		"subpath": ".",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
+	{
+		"name": "Skeleton",
+		"kind": "namespace",
+		"subpath": ".",
+		"declaringModule": "index.d.ts"
+	},
 	{
 		"name": "Skin",
 		"kind": "interface",
@@ -4733,6 +4763,18 @@
 		"subpath": "./assets",
 		"declaringModule": "assets/paths.d.ts"
 	},
+	{
+		"name": "sanitizeSvg",
+		"kind": "function",
+		"subpath": "./assets",
+		"declaringModule": "assets/svg.d.ts"
+	},
+	{
+		"name": "ScaleVariant",
+		"kind": "interface",
+		"subpath": "./assets",
+		"declaringModule": "assets/svg.d.ts"
+	},
 	{
 		"name": "setAssetMap",
 		"kind": "function",
@@ -4745,6 +4787,30 @@
 		"subpath": "./assets",
 		"declaringModule": "assets/paths.d.ts"
 	},
+	{
+		"name": "splitSvgGroups",
+		"kind": "function",
+		"subpath": "./assets",
+		"declaringModule": "assets/svg.d.ts"
+	},
+	{
+		"name": "svgDataUri",
+		"kind": "function",
+		"subpath": "./assets",
+		"declaringModule": "assets/svg.d.ts"
+	},
+	{
+		"name": "svgScaleVariants",
+		"kind": "function",
+		"subpath": "./assets",
+		"declaringModule": "assets/svg.d.ts"
+	},
+	{
+		"name": "SvgVariant",
+		"kind": "interface",
+		"subpath": "./assets",
+		"declaringModule": "assets/svg.d.ts"
+	},
 	{
 		"name": "texture",
 		"kind": "function",
@@ -9011,6 +9077,36 @@
 		"subpath": "./roguelike",
 		"declaringModule": "roguelike/Targeting.d.ts"
 	},
+	{
+		"name": "CaveChamber",
+		"kind": "interface",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Cave.d.ts"
+	},
+	{
+		"name": "CaveOptions",
+		"kind": "interface",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Cave.d.ts"
+	},
+	{
+		"name": "CavePassage",
+		"kind": "interface",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Cave.d.ts"
+	},
+	{
+		"name": "CaveResult",
+		"kind": "interface",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Cave.d.ts"
+	},
+	{
+		"name": "CaveStart",
+		"kind": "interface",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Cave.d.ts"
+	},
 	{
 		"name": "CellFeatureDef",
 		"kind": "interface",
@@ -9197,6 +9293,12 @@
 		"subpath": "./roguelike",
 		"declaringModule": "roguelike/generate.d.ts"
 	},
+	{
+		"name": "generateCave",
+		"kind": "function",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Cave.d.ts"
+	},
 	{
 		"name": "generateDungeon",
 		"kind": "function",
@@ -9209,6 +9311,12 @@
 		"subpath": "./roguelike",
 		"declaringModule": "roguelike/generate.d.ts"
 	},
+	{
+		"name": "generateOverworld",
+		"kind": "function",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Overworld.d.ts"
+	},
 	{
 		"name": "hallBuilder",
 		"kind": "const",
@@ -9287,6 +9395,36 @@
 		"subpath": "./roguelike",
 		"declaringModule": "roguelike/Level.d.ts"
 	},
+	{
+		"name": "OverworldInterest",
+		"kind": "interface",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Overworld.d.ts"
+	},
+	{
+		"name": "OverworldOptions",
+		"kind": "interface",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Overworld.d.ts"
+	},
+	{
+		"name": "OverworldResult",
+		"kind": "interface",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Overworld.d.ts"
+	},
+	{
+		"name": "OverworldSettlement",
+		"kind": "interface",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Overworld.d.ts"
+	},
+	{
+		"name": "OverworldTerrain",
+		"kind": "type",
+		"subpath": "./roguelike",
+		"declaringModule": "roguelike/Overworld.d.ts"
+	},
 	{
 		"name": "Pathfinder",
 		"kind": "class",
@@ -10151,6 +10289,120 @@
 		"subpath": "./simulation",
 		"declaringModule": "simulation/Runtime.d.ts"
 	},
+	{
+		"name": "advance",
+		"kind": "function",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "advancePlayback",
+		"kind": "function",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "Bone",
+		"kind": "interface",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "boneOrder",
+		"kind": "function",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "BoneTransform",
+		"kind": "interface",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "Clip",
+		"kind": "interface",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "create",
+		"kind": "function",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "createMixer",
+		"kind": "function",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "crossfadeTo",
+		"kind": "function",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "Keyframe",
+		"kind": "interface",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "Layer",
+		"kind": "interface",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "Mixer",
+		"kind": "interface",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "mixPoses",
+		"kind": "function",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "Playback",
+		"kind": "interface",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "Pose",
+		"kind": "type",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "resolve",
+		"kind": "function",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "samplePose",
+		"kind": "function",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "SkeletonBones",
+		"kind": "interface",
+		"subpath": "./skeleton",
+		"declaringModule": "skeleton/index.d.ts"
+	},
+	{
+		"name": "createSceneControls",
+		"kind": "function",
+		"subpath": "./testing",
+		"declaringModule": "testing/SceneControls.d.ts"
+	},
 	{
 		"name": "fakeAudio",
 		"kind": "function",
@@ -10199,6 +10451,18 @@
 		"subpath": "./testing",
 		"declaringModule": "testing/index.d.ts"
 	},
+	{
+		"name": "SceneControls",
+		"kind": "interface",
+		"subpath": "./testing",
+		"declaringModule": "testing/SceneControls.d.ts"
+	},
+	{
+		"name": "SceneStep",
+		"kind": "type",
+		"subpath": "./testing",
+		"declaringModule": "testing/SceneControls.d.ts"
+	},
 	{
 		"name": "spawn",
 		"kind": "function",
@@ -10445,6 +10709,12 @@
 		"subpath": "./two-d",
 		"declaringModule": "two-d/render/ImageModifiers.d.ts"
 	},
+	{
+		"name": "ArticulatedChain",
+		"kind": "class",
+		"subpath": "./two-d",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
 	{
 		"name": "assertAutotileLayout",
 		"kind": "function",
@@ -10625,6 +10895,18 @@
 		"subpath": "./two-d",
 		"declaringModule": "two-d/render/Camera.d.ts"
 	},
+	{
+		"name": "ChainOptions",
+		"kind": "interface",
+		"subpath": "./two-d",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
+	{
+		"name": "ChainRig",
+		"kind": "class",
+		"subpath": "./two-d",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
 	{
 		"name": "channelScaleMatrix",
 		"kind": "function",
@@ -12029,6 +12311,12 @@
 		"subpath": "./two-d",
 		"declaringModule": "two-d/stage/DialogueStage.d.ts"
 	},
+	{
+		"name": "SkeletalSprite",
+		"kind": "class",
+		"subpath": "./two-d",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
 	{
 		"name": "Skin",
 		"kind": "interface",
@@ -12791,6 +13079,12 @@
 		"subpath": "./two-d/render",
 		"declaringModule": "two-d/render/ImageModifiers.d.ts"
 	},
+	{
+		"name": "ArticulatedChain",
+		"kind": "class",
+		"subpath": "./two-d/render",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
 	{
 		"name": "assertAutotileLayout",
 		"kind": "function",
@@ -12911,6 +13205,18 @@
 		"subpath": "./two-d/render",
 		"declaringModule": "two-d/render/Camera.d.ts"
 	},
+	{
+		"name": "ChainOptions",
+		"kind": "interface",
+		"subpath": "./two-d/render",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
+	{
+		"name": "ChainRig",
+		"kind": "class",
+		"subpath": "./two-d/render",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
 	{
 		"name": "channelScaleMatrix",
 		"kind": "function",
@@ -13601,6 +13907,12 @@
 		"subpath": "./two-d/render",
 		"declaringModule": "two-d/render/Shape2D.d.ts"
 	},
+	{
+		"name": "SkeletalSprite",
+		"kind": "class",
+		"subpath": "./two-d/render",
+		"declaringModule": "two-d/render/SkeletalSprite.d.ts"
+	},
 	{
 		"name": "snapZoom",
 		"kind": "function",

package/dist/assets/index.d.ts

@@ -15,6 +15,8 @@ export type { AssetProgress } from './paths.ts';
 export { load, texture, get, isLoaded, release } from './loader.ts';
 export type { LoadAssetsOptions } from './loader.ts';
 export { loadBinary, getBinary, isBinaryLoaded, releaseBinary } from './binary.ts';
+export { sanitizeSvg, svgScaleVariants, svgDataUri, splitSvgGroups } from './svg.ts';
+export type { ScaleVariant, SvgVariant } from './svg.ts';
 export type { LoadBinaryOptions } from './binary.ts';
 export { AssetStream } from './Streaming.ts';
 export type { AssetBundle, AssetStreamOptions } from './Streaming.ts';

package/dist/assets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACrF,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/assets/index.js

@@ -13,6 +13,7 @@
 export { setBase, setAssetMap, isCompiled, paths, has, resolve } from './paths.js';
 export { load, texture, get, isLoaded, release } from './loader.js';
 export { loadBinary, getBinary, isBinaryLoaded, releaseBinary } from './binary.js';
+export { sanitizeSvg, svgScaleVariants, svgDataUri, splitSvgGroups } from './svg.js';
 export { AssetStream } from './Streaming.js';
 export { fetchWithByteProgress } from './ByteProgress.js';
 //# sourceMappingURL=index.js.map

package/dist/assets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGnF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGnF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGnF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAIrF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/assets/svg.d.ts

@@ -0,0 +1,87 @@
+/**
+ * SVG as inbound data (roadmap 398): sanitization, named scale variants, and group-split
+ * parts.
+ *
+ * An SVG is inbound data that can carry active content - `<script>`, event-handler
+ * attributes, `foreignObject` - the same way a save slot or a replay file is inbound data.
+ * `sanitizeSvg` refuses what it cannot prove inert, by name, conservatively: anything the
+ * scan does not recognize as inert is an error, never a silent pass, and the posture is the
+ * same one the saves and replay rules carry rather than a trust in the `file://` CSP to make
+ * the question moot.
+ *
+ * `svgScaleVariants` rasterizes one source once per named scale (1x, 2x, 3x), so a game
+ * picks the variant by device the way it picks an asset path, instead of every call site
+ * re-deciding a resolution multiplier. `splitSvgGroups` loads an SVG authored with named
+ * `<g>` groups as one standalone SVG per group - the natural authoring form for a skeletal
+ * puppet: one drawing, one source of truth, split at load.
+ *
+ * All three are string processing with no renderer: they run headless, and the compiled
+ * `data:` URI form is what they consume and produce.
+ *
+ * @example
+ * ```ts
+ * import { sanitizeSvg, splitSvgGroups } from '@datamoc/mw_games/assets';
+ *
+ * const puppet = '<svg><g id=\"arm\"><rect/></g></svg>';
+ * const parts = splitSvgGroups(sanitizeSvg(puppet));
+ * console.log(Object.keys(parts)); // ['arm']
+ * ```
+ */
+/**
+ * Refuse an SVG that is not proven inert, by name. The scan is deliberately conservative:
+ * it names what it refuses, and anything it cannot read as inert is an error rather than a
+ * silent pass. The source is returned unchanged once proven inert - sanitization here is a
+ * gate, not a rewrite; what a game authors is what a game gets.
+ */
+export declare function sanitizeSvg(source: string): string;
+export interface ScaleVariant {
+    /** the name a game picks the variant by, the way it picks an asset path */
+    name: string;
+    /** the rasterization resolution multiple, so a device picks its sharpness at load */
+    resolution: number;
+}
+export interface SvgVariant {
+    name: string;
+    /** a `data:image/svg\+xml` URI ready for the asset loader */
+    src: string;
+    /** the loader's own resolution hint, carried from the named scale */
+    resolution: number;
+}
+/**
+ * The `data:image/svg+xml` form of a source, ready for the loader.
+ *
+ * @example
+ * ```ts
+ * import { svgDataUri } from '@datamoc/mw_games/assets';
+ *
+ * console.log(svgDataUri('<svg/>').startsWith('data:image/svg+xml,')); // true
+ * ```
+ */
+export declare function svgDataUri(source: string): string;
+/**
+ * One source, one variant per named scale. Each variant is the same proven-inert source at
+ * its own resolution multiple, so the loader rasterizes each scale once and a game asks for
+ * the variant by name instead of re-deciding a multiplier at every call site.
+ */
+/**
+ * One source, one variant per named scale.
+ *
+ * @example
+ * ```ts
+ * import { svgScaleVariants } from '@datamoc/mw_games/assets';
+ *
+ * const [sharp] = svgScaleVariants('<svg/>', [{ name: '3x', resolution: 3 }]);
+ * console.log(sharp.resolution); // 3
+ * ```
+ */
+export declare function svgScaleVariants(source: string, scales: readonly ScaleVariant[]): SvgVariant[];
+/**
+ * An SVG authored with named `<g id="...">` groups loads as one standalone SVG per group -
+ * the natural authoring form for a skeletal puppet: one drawing, one source of truth for
+ * palette and style, split at load. Each part keeps the original `<svg>` root attributes
+ * (viewBox included) and carries exactly one group's children.
+ *
+ * Refused by name: an empty id, a duplicate id, and any group the scan cannot balance.
+ */
+export declare function splitSvgGroups(source: string): Record<string, string>;
+//# sourceMappingURL=svg.d.ts.map

package/dist/assets/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/assets/svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAcH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,MAAM,WAAW,YAAY;IAC5B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,UAAU,EAAE,CAa9F;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2CrE"}