@runmu.sh/ext-scene 1.0.3

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 1.0.3
+
+- No longer bundled with μClient: `builtin` and `defaultEnabled` are gone from the manifest. Install Scene from Extensions → Discover like any other extension. The panel is unchanged.
+
+## 1.0.2
+
+- Its own repository, [runmu-sh/ext-scene](https://github.com/runmu-sh/ext-scene), made with `npm create @runmu.sh/extension` and built against `@runmu.sh/sdk` from npm. The package is `@runmu.sh/ext-scene`. The panel is unchanged.
+
+## 1.0.1
+
+- The empty state reads NO ROOM YET (was "Awaiting signal…"): an upright, uppercase, tracked faint label, as the 2026-09-29 reference.
+
+## 1.0.0
+
+- The Scene panel as an extension. It was part of the μClient core; it now draws the room through `mu.scene.watch` (SDK 1.4). Nothing changes for players: it is built in, on by default and in the default layout.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 runmu.sh
+
+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 ANY 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

@@ -0,0 +1,58 @@
+# Scene (`@runmu.sh/ext-scene`, id `scene`)
+
+The Scene panel of [μClient](https://runmu.sh) (R-SCENE): the room you are in, its exits and who is there.
+
+First-party, on the [marketplace](https://runmu.sh/marketplace/x/scene). Install it from **☰ → Extensions → Discover**; once installed it is on in every world and takes the Scene slot of the default layout (right top). Turn it off per world in **Extensions → Installed**.
+
+Until 2026-09-29 the panel was part of the client core, and until 1.0.3 it was bundled with the client. The core still tracks the room for every session; this extension only draws it.
+
+## Where the room comes from
+The host keeps one scene per session and fills it from:
+
+| Source | Fields |
+|---|---|
+| GMCP `Room.Info` | `name`, `num`/`id`/`vnum`, `area`/`zone`, `desc`/`description`, `atmosphere`/`weather`, `pose`, `exits` (object, list or string) |
+| GMCP `Room.Players`, `Room.AddPlayer`, `Room.RemovePlayer` | Present (people) |
+| GMCP `Char.Items.List` / `Add` / `Remove` with `location: "room"` | Present (items; `hostile: true` is marked) |
+| MSDP `ROOM_NAME`, `ROOM_VNUM`, `ROOM_EXITS`, `AREA_NAME` (or `ROOM.*`) | Title, exits, area |
+| Another extension: `mu.scene.set({ title, area, desc, atmosphere, pose, exits, present, items })` | Any field |
+
+Package names are case-insensitive. Entering a new room clears Present. The room title is also the session's location (the world switcher shows it).
+
+## What it looks like
+On `--bg-elev`: the title in uppercase `--accent-bright` with a glow and a `--border-bright` rule under it, the area in small faint capitals, the atmosphere in italic `--fg-dim`, the description, and the pose line in italic with a 2px left rule. Then `┤EXITS├` and `┤PRESENT├` section heads (gold, the host's `.sec-head`) over `▸` lists. Each exit is a button: clicking it sends the direction as if typed. A hostile item carries a small `hostile` tag in `--alert`. An empty list says `none`, and before any room arrives the panel says NO ROOM YET (an upright, uppercase, tracked faint label).
+
+The panel is the region `scene`, so **Alt+R** (*Go to scene*) focuses it.
+
+## Behaviour
+- Panel `scene`, singleton, default position right top, Views order 10 (after Terminal, before Channels).
+- The first `Room.*` package of a session adds the panel if it is not open (R-AUTO-PANELS), once per world on this device, so a Scene you closed stays closed.
+- It sends nothing to the game except the exits you click. It adds no `Core.Supports` of its own (the backend's base set already has `Room 1`).
+
+## SDK
+Uses `mu.panels.register` (with `order`, SDK 1.4), `mu.scene.watch` (SDK 1.4), `mu.sessions.send`, `mu.gmcp.on`, `mu.panels.autoAdd` and `mu.ui.style`. It exports no API. `renderScene` and `presentOf` are exported for tests.
+
+## Develop
+Made with `npm create @runmu.sh/extension` ([the quickstart](https://runmu.sh/docs/extensions/quickstart)).
+
+```sh
+npm install
+npm run build        # src/index.ts → dist/index.js, then the manifest check
+npm run typecheck    # against @muclient/sdk (npm:@runmu.sh/sdk)
+npm run dev          # dev server on http://localhost:5199/ with hot reload
+```
+
+In μClient: **☰ → Extensions → Advanced → Developer → load from dev server**.
+
+## Publish
+The repository is linked to the marketplace listing [scene](https://runmu.sh/marketplace/x/scene) (publisher `bitmuse`): every version tag is imported within seconds (webhook), or within 30 minutes (poll).
+
+```sh
+# bump version in package.json and add a CHANGELOG entry, then:
+npm run build && git commit -am "Scene x.y.z" && git tag vx.y.z && git push --follow-tags
+```
+
+`dist/` is committed: the marketplace builds nothing. Versions are immutable.
+
+## License
+MIT.

package/dist/index.js

@@ -0,0 +1,112 @@
+// src/index.ts
+import { defineExtension } from "@muclient/sdk";
+var COPY = {
+  title: "Scene",
+  awaiting: "No room yet",
+  present: "Present",
+  exits: "Exits",
+  none: "none",
+  hostile: "hostile",
+  go: (dir) => `go ${dir}`
+};
+var SCENE_CSS = `
+.mu-scene { height: 100%; overflow-y: auto; background: var(--bg-elev); padding: .7rem .85rem 1rem; font-size: .9rem; color: var(--fg); box-sizing: border-box; }
+.mu-scene:focus { outline: none; }
+.mu-scene .title { margin: 0 0 .5rem; padding-bottom: .4rem; font-weight: 400; font-size: .9rem; letter-spacing: .16em; text-transform: uppercase; color: var(--accent-bright); border-bottom: 1px solid var(--border-bright); }
+.mu-scene .area { font-size: .66rem; letter-spacing: .2em; text-transform: uppercase; color: var(--fg-faint); margin: -.2rem 0 .4rem; }
+.mu-scene .atmo { color: var(--fg-dim); font-style: italic; margin: 0 0 .4rem; }
+.mu-scene .desc { margin: 0 0 .4rem; white-space: pre-wrap; }
+.mu-scene .pose { color: var(--fg-dim); font-style: italic; margin: 0 0 .5rem; padding-left: .5rem; border-left: 2px solid var(--border-bright); }
+.mu-scene .list { list-style: none; margin: 0; padding: 0; }
+.mu-scene .list li { padding: .08rem 0; color: var(--fg); }
+.mu-scene .sigil { color: var(--accent); margin-right: .6ch; }
+.mu-scene .exit { color: inherit; text-align: left; transition: color .12s ease; }
+.mu-scene .exit:hover { color: var(--accent-bright); }
+.mu-scene .exit:focus-visible { outline: 2px solid var(--accent-bright); outline-offset: 1px; }
+.mu-scene .hostile { color: var(--alert); font-size: .72rem; margin-left: 6px; }
+.mu-scene .none { margin: .1rem 0; font-style: normal; }
+.mu-scene .awaiting { margin: 0; color: var(--fg-faint); font-style: normal; font-size: .64rem; letter-spacing: .14em; text-transform: uppercase; }
+`;
+function el(tag, props = {}, ...kids) {
+  const e = document.createElement(tag);
+  for (const [k, v] of Object.entries(props)) {
+    if (v === void 0 || v === false) continue;
+    if (k === "class") e.className = String(v);
+    else e.setAttribute(k, v === true ? "" : String(v));
+  }
+  for (const k of kids) if (k !== null && k !== false) e.append(k);
+  return e;
+}
+function presentOf(s) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const n of s.present) if (!seen.has(n)) {
+    seen.add(n);
+    out.push({ name: n });
+  }
+  for (const it of s.items) if (!seen.has(it.name)) {
+    seen.add(it.name);
+    out.push(it.hostile ? { name: it.name, hostile: true } : { name: it.name });
+  }
+  return out;
+}
+var sectionHead = (label) => el("div", { class: "sec-head", role: "heading", "aria-level": "3" }, label, el("span", { class: "sec-close", "aria-hidden": "true" }));
+var sigil = () => el("span", { class: "sigil", "aria-hidden": "true" }, "\u25B8");
+function renderScene(s, go) {
+  if (!s || !s.known) return [el("p", { class: "empty awaiting", "data-testid": "scene-empty" }, COPY.awaiting)];
+  const out = [el("h3", { class: "title glow-text", role: "heading", "aria-level": "2", "data-testid": "scene-title" }, s.title)];
+  if (s.area) out.push(el("div", { class: "area", "data-testid": "scene-area" }, s.area));
+  if (s.atmosphere) out.push(el("p", { class: "atmo" }, s.atmosphere));
+  if (s.desc) out.push(el("p", { class: "desc" }, s.desc));
+  if (s.pose) out.push(el("p", { class: "pose" }, s.pose));
+  out.push(sectionHead(COPY.exits));
+  if (s.exits.length) {
+    const ul = el("ul", { class: "list", "data-testid": "scene-exits" });
+    for (const dir of s.exits) {
+      const b = el("button", { class: "exit", type: "button", title: COPY.go(dir) }, sigil(), dir);
+      b.addEventListener("click", () => go(dir));
+      ul.append(el("li", {}, b));
+    }
+    out.push(ul);
+  } else out.push(el("p", { class: "empty none" }, COPY.none));
+  out.push(sectionHead(COPY.present));
+  const present = presentOf(s);
+  if (present.length) {
+    const ul = el("ul", { class: "list", "data-testid": "scene-present" });
+    for (const p of present) ul.append(el("li", {}, sigil(), p.name, p.hostile ? el("span", { class: "hostile" }, COPY.hostile) : null));
+    out.push(ul);
+  } else out.push(el("p", { class: "empty none" }, COPY.none));
+  return out;
+}
+var index_default = defineExtension({
+  activate(ctx) {
+    const mu = ctx.mu;
+    mu.ui.style(SCENE_CSS);
+    const mount = (host, pc) => {
+      const root = el("section", { class: "mu-scene", "aria-label": COPY.title, "data-focus-region": "scene", tabindex: "-1", "data-testid": "scene" });
+      host.append(root);
+      const sid = pc.sid;
+      const go = (dir) => {
+        if (sid) void mu.sessions.send(dir, sid);
+      };
+      if (!sid) {
+        root.replaceChildren(...renderScene(null, go));
+        return () => root.remove();
+      }
+      const off = mu.scene.watch((s) => root.replaceChildren(...renderScene(s, go)), sid);
+      return () => {
+        off();
+        root.remove();
+      };
+    };
+    mu.panels.register({ id: "scene", title: COPY.title, singleton: true, defaultPosition: "right-top", order: 10, mount });
+    mu.gmcp.on("Room", (_d, { sid }) => mu.panels.autoAdd("scene", sid));
+  }
+});
+export {
+  COPY,
+  SCENE_CSS,
+  index_default as default,
+  presentOf,
+  renderScene
+};

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@runmu.sh/ext-scene",
+  "version": "1.0.3",
+  "description": "The Scene panel: the room you are in (title, area, atmosphere, description, pose), its exits as buttons and who is present, from GMCP Room.*, Char.Items.*, MSDP or another extension.",
+  "keywords": [
+    "scene",
+    "room",
+    "exits",
+    "gmcp",
+    "msdp",
+    "panel"
+  ],
+  "license": "MIT",
+  "homepage": "https://runmu.sh/marketplace/x/scene",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/runmu-sh/ext-scene.git"
+  },
+  "bugs": {
+    "url": "https://github.com/runmu-sh/ext-scene/issues"
+  },
+  "type": "module",
+  "exports": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "dev": "node scripts/dev.mjs",
+    "typecheck": "tsc --noEmit",
+    "check": "node scripts/build.mjs --check"
+  },
+  "devDependencies": {
+    "@muclient/sdk": "npm:@runmu.sh/sdk@^1.6.0",
+    "@runmu.sh/dev": "^0.1.0",
+    "esbuild": "^0.28.2",
+    "typescript": "^5.9.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "muclient": {
+    "id": "scene",
+    "api": "^1.4",
+    "source": "src/index.ts",
+    "displayName": "Scene",
+    "description": "The Scene panel: the current room, its exits as buttons and who is present, from GMCP Room.*, Char.Items.*, MSDP or another extension.",
+    "categories": [
+      "interface",
+      "mapping"
+    ],
+    "contributes": {
+      "panels": [
+        {
+          "id": "scene",
+          "title": "Scene"
+        }
+      ],
+      "gmcp": [
+        "Room 1"
+      ]
+    },
+    "capabilities": [
+      "read-output",
+      "send-commands"
+    ],
+    "publisher": "bitmuse"
+  }
+}