@rpgm-tools/neo-angband-mod-sdk 1.1.1 → 1.1.2

package/README.md

@@ -63,7 +63,7 @@ reads them.
 - [docs/MODS.md](https://github.com/neostryder/neo-angband/blob/master/docs/MODS.md): the full modding guide
 - First-party mods: [qol](https://github.com/neostryder/neo-angband-mod-qol),
   [bug-fixes](https://github.com/neostryder/neo-angband-mod-bug-fixes),
-  [neo-linoleum](https://github.com/neostryder/neo-angband-mod-linoleum),
+  [linoleum](https://github.com/neostryder/neo-angband-mod-linoleum),
   [borg](https://github.com/neostryder/neo-angband-mod-borg)
 
 ## Versioning

package/dist/standards.d.ts

@@ -24,7 +24,7 @@
  *     enforced it, because validateManifest never sees whether plugin.js is there.
  *   - a mod whose payload is committed .zip archives must DECLARE them, or the
  *     installer stores the zips unopened and the mod is present and dead. Found on
- *     neo-linoleum by a live canary, after it had shipped that way.
+ *     Linoleum by a live canary, after it had shipped that way.
  *
  * A rule is either `required` - the mod cannot work, and an install is refused - or
  * `recommended`, which is advice and never blocks anything. Nothing in between: a

package/dist/standards.js

@@ -24,7 +24,7 @@
  *     enforced it, because validateManifest never sees whether plugin.js is there.
  *   - a mod whose payload is committed .zip archives must DECLARE them, or the
  *     installer stores the zips unopened and the mod is present and dead. Found on
- *     neo-linoleum by a live canary, after it had shipped that way.
+ *     Linoleum by a live canary, after it had shipped that way.
  *
  * A rule is either `required` - the mod cannot work, and an install is refused - or
  * `recommended`, which is advice and never blocks anything. Nothing in between: a

package/docs/MOD_SEAMS.md

@@ -109,6 +109,42 @@ reference. The Phase-5 disk fixture then loads two real plugin folders, proves
 only the later one receives that production frame, and keeps an unmodded glyph
 control.
 
+## 0c. `ctx.display` is geometry, not a zoom feature
+
+`ModPluginContext.display` is present after the web shell has a live game
+surface and absent during content composition. It is the narrow access point a
+display-oriented mod needs to change geometry without reaching into private
+module variables:
+
+- `snapshot()` reports the real terminal cell metrics, current play or map
+  viewport, cave-space origin and size, level bounds, layout, and named screen
+  regions.
+- `setGrid()` switches `GlyphTerm`'s existing reflow mode at runtime. The
+  supplied target cell height produces a different addressable grid, and the
+  resulting `WorldFrame.viewport.size` comes from that grid on the next paint.
+  Passing `null` restores the faithful fixed 80x24 term.
+- `setCamera()` reads or replaces the normal play camera origin. A non-null
+  value remains pinned until the mod releases it with `null`; level changes and
+  the game's own center-panel command release it too.
+- `setMapView()` selects an explicit cave-space window while the `M` overview is
+  active. The existing overview producer rebuilds that window for ASCII or
+  graphics and the existing modal repaints it.
+- `setSidebarExtent()` reserves whole terminal columns or rows for a mod-owned
+  sidebar, and `setTileScaling()` selects the existing automatic sampler or
+  crisp nearest-neighbour sampling.
+- `onKey()` subscribes through the one input door at capture priority, before
+  ordinary play and modal owners. It is delivery only; the mod decides which
+  combinations it owns and cancels only those events.
+
+The seam contains no key binding, wheel or gesture handler, zoom ladder,
+camera delta, animation, persistence key, or feature flag. Those are the mod's
+behavior. With no call, every default is unchanged: fixed 80x24, the ordinary
+panel camera, the full-level overview, the classic 13-column or one-row
+sidebar, and automatic high-quality filtering only while a tile is downscaled.
+It is ungated for the same reason `ctx.core` and `ctx.state` are ungated: an
+in-process plugin already runs in the page realm, so a permission check here
+would describe isolation the host does not provide.
+
 ## 1. `GameState.modHooks` - the behaviour seam
 
 The one seam behind both first-party behaviour mods. `GameState.modHooks`

package/docs/PLUGINS.md

@@ -331,7 +331,7 @@ register(host, ctx) {
 - **The game has no opinion about who deserves a tile.** It used to: 0.22.0
   shipped a rule in core that drew a mod-added monster from a race sharing its
   `base`, and 0.23.0 removed it, because Angband 4.2.6 has no concept of a record
-  a mod added and the port adds nothing. That rule now lives in `neo-linoleum`,
+  a mod added and the port adds nothing. That rule now lives in `linoleum`,
   which is the worked example. Note what it does NOT fill: rings, amulets,
   mushrooms and food are drawn by FLAVOUR and their kind slots are blank on
   purpose, and an older pack has no art for content added since it was drawn -

package/docs/README.md

@@ -171,7 +171,7 @@ loaded). Each lives in its own repository and arrives through the mod manager's
 | --- | --- | --- | --- |
 | `qol` | content | [own repo](https://github.com/neostryder/neo-angband-mod-qol) | Genuinely new conveniences, currently just auto-dig on walk. Built-in Angband `=` options are NOT here: they ship in core at their upstream defaults. See `QOL.md`. |
 | `bug-fixes` | content | [own repo](https://github.com/neostryder/neo-angband-mod-bug-fixes) | An unofficial patch set for upstream bugs core deliberately keeps. See `BUG_FIXES.md`. |
-| `neo-linoleum` | tiles | [own repo](https://github.com/neostryder/neo-angband-mod-linoleum) | An ALTERNATIVE tile engine: the Linoleum loose-pack format (individual PNGs addressed by readable target maps, plus variant pools). It does NOT supply the game's graphics - all five upstream tile sets (Original / Adam Bolt / David Gervais / Nomad / Shockbolt Dark and Light) are core content (`grafmode.c` / `lib/tiles/list.txt`) and appear in the Graphics screen with no mod enabled. It ships all six converted to loose packs, so you can compare the two engines on identical art. Declare a pack with `{ "grafID": >=100, "engine": "linoleum", "menuname": "...", "path": "..." }` - note `engine` is the FORMAT name and stays `linoleum`; `neo-linoleum` is the mod. Since its 0.15.0 it also carries the one rule the GAME used to hold: content a mod added, with no tile anywhere, is drawn from its nearest relative with the colour turned - under its own packs only, through `registry:tiles`. See `docs/LINOLEUM.md`. |
+| `linoleum` | tiles | [own repo](https://github.com/neostryder/neo-angband-mod-linoleum) | An ALTERNATIVE tile engine: the Linoleum loose-pack format (individual PNGs addressed by readable target maps, plus variant pools). It does NOT supply the game's graphics - all five upstream tile sets (Original / Adam Bolt / David Gervais / Nomad / Shockbolt Dark and Light) are core content (`grafmode.c` / `lib/tiles/list.txt`) and appear in the Graphics screen with no mod enabled. It ships all six converted to loose packs, so you can compare the two engines on identical art. Declare a pack with `{ "grafID": >=100, "engine": "linoleum", "menuname": "...", "path": "..." }` - `engine` names the FORMAT and the mod that ships the six converted packs shares the same id. Since its 0.15.0 it also carries the one rule the GAME used to hold: content a mod added, with no tile anywhere, is drawn from its nearest relative with the colour turned - under its own packs only, through `registry:tiles`. See `docs/LINOLEUM.md`. |
 | `borg` | plugin | [own repo](https://github.com/neostryder/neo-angband-mod-borg) | An automatic player, driving the game through the same perceive/act API any third-party automation would use. The whole port lives there, with its own release tags and its own suite, including one that drives the BUILT `plugin.js`. Installing and enabling it does not hand it your character; its "Let the Borg play" toggle does. |
 | `feature-restoration` | content + plugin | [own repo](https://github.com/neostryder/neo-angband-mod-feature-restoration) | Beloved Angband features that a later version quietly dropped, brought back one named toggle at a time, every toggle off by default. `Teleport Other` (content: a `fieldPatches` addition to the Priest, Paladin and Ranger's own books, who lost the spell somewhere between an earlier Angband and 4.2.6 while the Mage and the Rogue kept it) and store discounts (plugin: 4.2.6 dropped the discount roll entirely, so this restoration installs a `registry:store` discount-roll handler instead of patching data that no longer exists). |
 | `forge` | plugin | [own repo](https://github.com/neostryder/neo-angband-mod-forge) | An in-game workshop for building other mods without leaving the game: pick an existing record, see its neighbours, change what would have to change, and pack the result up to try in-session, install, or hand off as a file. Early - the workshop's own content is a demonstration fixture until the remaining engine seams land. See `docs/ENGINE_SEAMS.md` in its own repository. |
@@ -180,7 +180,7 @@ loaded). Each lives in its own repository and arrives through the mod manager's
 **First-party is not a shortcut.** All seven take the same route into the game as anybody else's mod, and that is on purpose: bundling the author's own mods would have hidden every defect in the install path behind mods that never used it. The download route, the folder code loader and the plugin ABI all work because nothing is exempt from them. What first-party buys is that these seven are also the reference examples - read them to learn the seams.
 
 Enable one in the in-app mod manager (game menu -> Mods), or with
-`?mods=qol,bug-fixes,neo-linoleum` for a one-off.
+`?mods=qol,bug-fixes,linoleum` for a one-off.
 
 **The mod is the unit you switch; its patches ride with it.** While a mod is
 disabled its patches DO NOT EXIST - its code is never called, no hook is

package/docs/tutorials/02-add-an-item.md

@@ -151,10 +151,10 @@ So if you ship content, ship tiles for it, and if you do not, say so in your mod
 description and point players at a tile mod that fills blanks:
 
 > No tiles of its own: in tile mode the Padded Jerkin draws as a letter. Install
-> [neo-linoleum](https://github.com/neostryder/neo-angband-mod-linoleum) and it is
+> [linoleum](https://github.com/neostryder/neo-angband-mod-linoleum) and it is
 > drawn from another item of its type instead.
 
-neo-linoleum draws an added item from a kind sharing its `tval`, with the colour
+Linoleum draws an added item from a kind sharing its `tval`, with the colour
 turned, under its own tile packs. Under Angband's own tile sheets an added item
 keeps its letter, because those sheets are a fixed grid with no spare cell for a
 variant. **Do not make it a dependency:** your mod is complete in ASCII with no

package/docs/tutorials/03-add-a-monster.md

@@ -132,13 +132,13 @@ thinking your mod is broken and a player knowing what they are looking at:
 or
 
 > No tiles of its own: in tile mode the carpenter ant draws as a letter. Install
-> [neo-linoleum](https://github.com/neostryder/neo-angband-mod-linoleum) and it is
+> [linoleum](https://github.com/neostryder/neo-angband-mod-linoleum) and it is
 > drawn from its family instead.
 
-That second one is a real fallback rather than a shrug. neo-linoleum, the loose-pack
+That second one is a real fallback rather than a shrug. Linoleum, the loose-pack
 tile mod, fills content nothing drew: an added monster is drawn from a relative
 sharing its `base` with the colour turned, so your carpenter ant reads as an ant
-without being pixel-identical to the base game's. It applies to neo-linoleum's own
+without being pixel-identical to the base game's. It applies to Linoleum's own
 packs only - under Angband's own tile sheets there is no spare cell for a variant,
 so a letter is what an added creature gets - and your players turn it on
 themselves. **It is not a dependency:** your mod is complete and correct in ASCII

package/docs/tutorials/README.md

@@ -168,7 +168,7 @@ involved:
 | [feature-restoration](https://github.com/neostryder/neo-angband-mod-feature-restoration) | A small mod that is both data and code, with every feature behind its own switch |
 | [qol](https://github.com/neostryder/neo-angband-mod-qol) | Behaviour hooks in a shipped mod |
 | [bug-fixes](https://github.com/neostryder/neo-angband-mod-bug-fixes) | Many small, independent, individually-switchable changes |
-| [neo-linoleum](https://github.com/neostryder/neo-angband-mod-linoleum) | A whole alternative tile engine, and a mod that ships art |
+| [linoleum](https://github.com/neostryder/neo-angband-mod-linoleum) | A whole alternative tile engine, and a mod that ships art |
 | [borg](https://github.com/neostryder/neo-angband-mod-borg) | A mod that plays the game |
 
 None of them is bundled with the game and none takes a private path in. They

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rpgm-tools/neo-angband-mod-sdk",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Pack schemas, validation, and tooling for Neo Angband mods (content packs, tile packs, scripted plugins)",
   "license": "GPL-2.0-only",
   "author": "neostryder (RPGM Tools)",
@@ -67,7 +67,9 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc"
+    "sync-docs": "node scripts/sync-docs.mjs",
+    "build": "pnpm run sync-docs && tsc",
+    "prepack": "pnpm run sync-docs"
   },
   "devDependencies": {
     "esbuild": "^0.28.1"

package/src/standards.ts

@@ -24,7 +24,7 @@
  *     enforced it, because validateManifest never sees whether plugin.js is there.
  *   - a mod whose payload is committed .zip archives must DECLARE them, or the
  *     installer stores the zips unopened and the mod is present and dead. Found on
- *     neo-linoleum by a live canary, after it had shipped that way.
+ *     Linoleum by a live canary, after it had shipped that way.
  *
  * A rule is either `required` - the mod cannot work, and an install is refused - or
  * `recommended`, which is advice and never blocks anything. Nothing in between: a