@songsid/agend 2.3.2-beta.9 → 2.3.3-beta.1

package/dist/ui/fleet-office-layout.js

@@ -8,6 +8,14 @@
 // seats' figures, #2558), a moon, and a thin line to its day place. One that sleeps in place shows it on its day place
 // (and it follows the item); dragged away, the item has its own night place; its Reset puts back the pack's.
 //
+// #2736: the mail drop — where letters from other offices land — is a handle too (an envelope). On a pack without
+// one it stands, dashed, where letters land today (fleet-office-zones.js dropPoint); dragged, the office has its own.
+//
+// #2691: a selected seat lists the office's members under "Reserved for" (several may be picked) and "Lend when
+// away": whoever it is for takes it first, and nobody else does unless it is lent while they are all elsewhere
+// (fleet-office-zones.js assignSeats). Saved as the overrides' `seatFor` by area and slot; a reserved seat's handle
+// is ringed.
+//
 // Every handle is a button for the keyboard too: Tab to it, the arrow keys move it (Shift: by 10), Delete removes a
 // waypoint; the selected waypoint's corridors are listed with a way to join or unjoin each. Never offered to a guest,
 // the public link or a read-only session (the host refuses their saves too).
@@ -17,24 +25,27 @@ import { html, useEffect, useLayoutEffect, useMemo, useRef, useState } from "/as
 import { t, register } from "/assets/app-i18n.js";
 import { SidePanel } from "/assets/side-panel.js";
 import { LOGICAL, overridesBetween, own } from "./fleet-office-pack.js";
+import { dropPoint } from "./fleet-office-zones.js";
 
 register("orgl", {
   en: {
     edit: "Edit layout", title: "Edit layout", coords: "Show coordinates", addWaypoint: "Add waypoint", removeWaypoint: "Remove waypoint",
-    joinTo: "Join to", join: "Join", unjoin: "Unjoin {0}", corridors: "Corridors", none: "Nothing selected: pick a seat, an item, the door or a waypoint.",
+    joinTo: "Join to", join: "Join", unjoin: "Unjoin {0}", corridors: "Corridors", none: "Nothing selected: pick a seat, an item, the door, the mail drop or a waypoint.",
     reset: "Reset to the pack's layout", save: "Save layout", cancel: "Cancel", saved: "Layout saved.", hint: "Drag, or use the arrow keys (Shift: by 10).",
-    seat: "Seat {0} in {1}", furniture: "Item {0}", night: "Item {0} (night)", door: "Door", waypoint: "Waypoint {0}", at: "{0} at {1}, {2}",
+    seat: "Seat {0} in {1}", furniture: "Item {0}", night: "Item {0} (night)", door: "Door", mail: "Mail drop", mailAuto: "Mail drop (where letters land now; drag to place it)", waypoint: "Waypoint {0}", at: "{0} at {1}, {2}",
     nightReset: "Back to the pack's night place",
+    seatFor: "Seat {0} in {1}, reserved for {2}", reservedFor: "Reserved for", lend: "Lend when away", nobody: "No members to pick.",
     changed: "Someone changed the offices meanwhile. Your layout is kept: Save again puts it on the current list.",
     failed: "The layout was not saved ({0}).", rateLimited: "Too many saves. Try again in a minute.",
     stale: "This office was removed or its style changed meanwhile: this layout can no longer be saved. Cancel closes it.",
   },
   "zh-TW": {
     edit: "編輯配置", title: "編輯配置", coords: "顯示座標", addWaypoint: "新增路徑點", removeWaypoint: "移除路徑點",
-    joinTo: "連到", join: "連接", unjoin: "取消連接 {0}", corridors: "走道", none: "尚未選取：請選座位、家具、門或路徑點。",
+    joinTo: "連到", join: "連接", unjoin: "取消連接 {0}", corridors: "走道", none: "尚未選取：請選座位、家具、門、信件落點或路徑點。",
     reset: "還原成 pack 的配置", save: "儲存配置", cancel: "取消", saved: "配置已儲存。", hint: "拖曳，或用方向鍵移動（Shift：一次 10）。",
-    seat: "{1} 的座位 {0}", furniture: "家具 {0}", night: "家具 {0}（夜間）", door: "門", waypoint: "路徑點 {0}", at: "{0}，位置 {1}, {2}",
+    seat: "{1} 的座位 {0}", furniture: "家具 {0}", night: "家具 {0}（夜間）", door: "門", mail: "信件落點", mailAuto: "信件落點（目前信件落下的位置；拖曳即可指定）", waypoint: "路徑點 {0}", at: "{0}，位置 {1}, {2}",
     nightReset: "回到 pack 的夜間位置",
+    seatFor: "{1} 的座位 {0}，保留給 {2}", reservedFor: "保留給", lend: "不在時借給別人", nobody: "沒有可選的成員。",
     changed: "有人在這期間修改了辦公室。你的配置已保留：再按一次儲存，會套用到目前的清單。",
     failed: "配置沒有儲存（{0}）。", rateLimited: "儲存太頻繁，請一分鐘後再試。",
     stale: "這個辦公室在這期間被移除，或它的風格已改變：這份配置無法再儲存。按取消關閉。",
@@ -48,12 +59,15 @@ const clamp = (v, lo, hi) => Math.max(lo, Math.min(hi, Math.round(v)));
 /** An item's night place (#2665): its own, or (in place) its day place; `own` whether it has one. */
 const nightAt = (f) => (f.night.x !== null && f.night.x !== undefined && f.night.y !== null && f.night.y !== undefined ? { x: f.night.x, y: f.night.y, own: true } : { x: f.x, y: f.y, own: false });
 /**
- * Every handle on a pack: { key, kind, label, x, y } — seats by area, furniture, each item's night place (#2665: an
- * item with a `night`; `day` its day place, `inPlace` while it sleeps there), the door, the waypoints.
+ * Every handle on a pack: { key, kind, label, x, y } — seats by area (#2691: `for` and `lend` when reserved),
+ * furniture, each item's night place (#2665: an item with a `night`; `day` its day place, `inPlace` while it sleeps
+ * there), the door, the mail drop (#2736: `auto` where the pack has none — where letters land now), the waypoints.
  */
 export function handlesOf(pack) {
   const out = [];
-  for (const [name, a] of Object.entries(pack.areas)) a.seats.forEach((s, i) => out.push({ key: `seat:${name}:${i}`, kind: "seat", label: tl("seat", i + 1, name), x: s.x, y: s.y }));
+  for (const [name, a] of Object.entries(pack.areas)) a.seats.forEach((s, i) => out.push({ key: `seat:${name}:${i}`, kind: "seat",
+    label: s.for && s.for.length ? tl("seatFor", i + 1, name, s.for.join(", ")) : tl("seat", i + 1, name), x: s.x, y: s.y,
+    ...(s.for && s.for.length ? { for: [...s.for], lend: s.lend === true } : {}) }));
   for (const f of pack.furniture) out.push({ key: `furn:${f.id}`, kind: "furniture", label: tl("furniture", f.id), x: f.x, y: f.y });
   for (const f of pack.furniture) {
     if (!f.night) continue;
@@ -61,6 +75,8 @@ export function handlesOf(pack) {
     out.push({ key: `night:${f.id}`, kind: "night", label: tl("night", f.id), x: n.x, y: n.y, day: { x: f.x, y: f.y }, inPlace: !n.own });
   }
   out.push({ key: "door", kind: "door", label: tl("door"), x: pack.door.x, y: pack.door.y });
+  const md = pack.mailDrop || dropPoint({ areas: pack.areas, waypoints: pack.waypoints, width: LOGICAL.w, height: LOGICAL.h });
+  if (md) out.push({ key: "mail", kind: "mail", label: tl(pack.mailDrop ? "mail" : "mailAuto"), x: md.x, y: md.y, ...(pack.mailDrop ? {} : { auto: true }) });
   for (const w of pack.waypoints) out.push({ key: `wp:${w.id}`, kind: "waypoint", label: tl("waypoint", w.id), x: w.x, y: w.y });
   return out;
 }
@@ -72,11 +88,12 @@ export function moveHandle(pack, key, x, y) {
     const area = own(pack.areas, a), i = Number(b);
     if (!area || !area.seats[i]) return pack;
     const r = area.rect, p = { x: clamp(x, Math.ceil(r.x), Math.floor(r.x + r.w)), y: clamp(y, Math.ceil(r.y), Math.floor(r.y + r.h)) };
-    return { ...pack, areas: { ...pack.areas, [a]: { ...area, seats: area.seats.map((s, j) => (j === i ? p : s)) } } };
+    return { ...pack, areas: { ...pack.areas, [a]: { ...area, seats: area.seats.map((s, j) => (j === i ? { ...s, ...p } : s)) } } };
   }
   if (kind === "furn") return { ...pack, furniture: pack.furniture.map((f) => (f.id === a ? { ...f, ...inCanvas() } : f)) };
   if (kind === "night") return { ...pack, furniture: pack.furniture.map((f) => (f.id === a && f.night ? { ...f, night: { ...f.night, ...inCanvas() } } : f)) };
   if (kind === "door") return { ...pack, door: inCanvas() };
+  if (kind === "mail") return { ...pack, mailDrop: inCanvas() };
   if (kind === "wp") return { ...pack, waypoints: pack.waypoints.map((w) => (w.id === a ? { ...w, ...inCanvas() } : w)) };
   return pack;
 }
@@ -104,6 +121,18 @@ export function resetNight(pack, base, id) {
   if (!o || !o.night) return pack;
   return { ...pack, furniture: pack.furniture.map((f) => (f.id === id && f.night ? { ...f, night: { ...f.night, x: o.night.x, y: o.night.y } } : f)) };
 }
+/**
+ * #2691: seat `key` ("seat:<area>:<i>") reserved for `names` (in that order, none twice), lent while they are all
+ * elsewhere when `lend`; no names: a plain seat again.
+ */
+export function reserveSeat(pack, key, names, lend = false) {
+  const [kind, a, b] = key.split(":");
+  const area = kind === "seat" ? own(pack.areas, a) : null, i = Number(b);
+  if (!area || !area.seats[i]) return pack;
+  const list = [...new Set(names)];
+  const seat = (s) => { const { for: _f, lend: _l, ...p } = s; return list.length ? { ...p, for: list, lend: lend === true } : p; };
+  return { ...pack, areas: { ...pack.areas, [a]: { ...area, seats: area.seats.map((s, j) => (j === i ? seat(s) : s)) } } };
+}
 /** What Save keeps: the overrides between the pack and the edited layout (null: the pack's own). */
 export const layoutOverrides = (base, edited) => overridesBetween(base, edited);
 
@@ -123,9 +152,10 @@ const KEY_STEP = { ArrowLeft: [-1, 0], ArrowRight: [1, 0], ArrowUp: [0, -1], Arr
  * zoomed; the page sets its box through the CSSOM, never a style attribute: #1300) — a pointer is read back through
  * the overlay's own box, so a drag lands on the logical point under it at any zoom; `onChange(edited)` as anything
  * moves (the canvas redraws it); `onSave(overrides | null)` → { ok } or { ok: false, message }; `onClose()`. `stale` (a message): the
- * office or its style changed underneath the session — no handles, nothing to save, only Cancel.
+ * office or its style changed underneath the session — no handles, nothing to save, only Cancel. `members` (#2691):
+ * the office's instances' names, offered under a selected seat's "Reserved for".
  */
-export function LayoutEditor({ base, start, place = null, stale = "", dock = true, onChange, onSave, onClose }) {
+export function LayoutEditor({ base, start, place = null, stale = "", dock = true, members = [], onChange, onSave, onClose }) {
   const [edited, setEdited] = useState(start);
   const [sel, setSel] = useState(null);
   const [coords, setCoords] = useState(true);
@@ -160,6 +190,13 @@ export function LayoutEditor({ base, start, place = null, stale = "", dock = tru
   const add = () => { const at = selected ? { x: selected.x + 40, y: selected.y } : { x: LOGICAL.w / 2, y: LOGICAL.h / 2 }; const r = addWaypoint(edited, at.x, at.y); change(r.pack); setSel(`wp:${r.id}`); };
   const wpSel = selected && selected.kind === "waypoint" ? selected.key.slice(3) : null;
   const nightSel = selected && selected.kind === "night" ? selected.key.slice(6) : null;
+  const seatSel = selected && selected.kind === "seat" ? selected : null;
+  // #2691: the members to pick from, and anyone the seat is already for who is not one now (so they can be unpicked).
+  const pickable = seatSel ? [...new Set([...members, ...(seatSel.for || [])])] : [];
+  const pickFor = (name) => {
+    const now = seatSel.for || [], next = now.includes(name) ? now.filter((n) => n !== name) : [...now, name];
+    change(reserveSeat(edited, seatSel.key, next, next.length ? seatSel.lend === true : false));
+  };
   const save = async () => {
     if (busy) return;
     setBusy(true); setMsg("");
@@ -196,6 +233,12 @@ export function LayoutEditor({ base, start, place = null, stale = "", dock = tru
   const controls = html`<label class="check"><input type="checkbox" class="ol-coords" checked=${coords} onChange=${() => setCoords((v) => !v)} /><span>${tl("coords")}</span></label>
       <button type="button" class="btn btn-sm ol-add" onClick=${add} disabled=${busy}>${tl("addWaypoint")}</button>
       <span class="muted ol-sel" aria-live="polite">${selected ? tl("at", selected.label, selected.x, selected.y) : tl("none")}</span>
+      ${seatSel ? html`<fieldset class="ol-for"><legend class="oo-pick-label">${tl("reservedFor")}</legend>
+          ${pickable.length ? pickable.map((n) => html`<label key=${n} class="check"><input type="checkbox" class="ol-for-pick" value=${n} checked=${(seatSel.for || []).includes(n)}
+            disabled=${busy} onChange=${() => pickFor(n)} /><span>${n}</span></label>`) : html`<span class="muted">${tl("nobody")}</span>`}
+        </fieldset>
+        <label class="check"><input type="checkbox" class="ol-lend" checked=${seatSel.lend === true} disabled=${busy || !(seatSel.for || []).length}
+          onChange=${() => change(reserveSeat(edited, seatSel.key, seatSel.for || [], !(seatSel.lend === true)))} /><span>${tl("lend")}</span></label>` : null}
       ${nightSel ? html`<button type="button" class="btn btn-sm ol-night-reset" onClick=${() => change(resetNight(edited, base, nightSel))} disabled=${busy}>${tl("nightReset")}</button>` : null}
       ${wpSel ? html`<button type="button" class="btn btn-sm btn-danger ol-remove" onClick=${() => { change(removeWaypoint(edited, wpSel)); setSel(null); }} disabled=${busy}>${tl("removeWaypoint")}</button>
         <label class="oo-pick"><span class="oo-pick-label">${tl("joinTo")}</span>
@@ -219,12 +262,14 @@ export function LayoutEditor({ base, start, place = null, stale = "", dock = tru
         ${Object.values(edited.areas).map((a) => html`<rect key=${`a:${a.name}`} class="ol-area" x=${a.rect.x} y=${a.rect.y} width=${a.rect.w} height=${a.rect.h} />`)}
         ${edited.edges.map((e) => { const p = at.get(e[0]), q = at.get(e[1]); return p && q ? html`<line key=${`e:${edgeKey(e)}`} class="ol-edge" x1=${p.x} y1=${p.y} x2=${q.x} y2=${q.y} />` : null; })}
         ${handles.filter((h) => h.kind === "night" && !h.inPlace).map((h) => html`<line key=${`nl:${h.key}`} class="ol-night-line" x1=${h.day.x} y1=${h.day.y} x2=${h.x} y2=${h.y} />`)}
-        ${[...handles.filter((h) => h.kind === "night"), ...handles.filter((h) => h.kind !== "night")].map((h) => html`<g key=${h.key} class=${`ol-handle ol-${h.kind}${sel === h.key ? " on" : ""}`} data-handle=${h.key} tabindex="0" role="button"
+        ${[...handles.filter((h) => h.kind === "night"), ...handles.filter((h) => h.kind !== "night")].map((h) => html`<g key=${h.key} class=${`ol-handle ol-${h.kind}${h.for ? " reserved" : ""}${h.auto ? " auto" : ""}${sel === h.key ? " on" : ""}`} data-handle=${h.key} tabindex="0" role="button"
             aria-label=${tl("at", h.label, h.x, h.y)} aria-pressed=${sel === h.key ? "true" : "false"}
             onPointerDown=${down(h.key)} onKeyDown=${keyOn(h)} onFocus=${() => setSel(h.key)}>
           ${h.kind === "door" ? html`<rect x=${h.x - 9} y=${h.y - 9} width="18" height="18" transform=${`rotate(45 ${h.x} ${h.y})`} />`
+            : h.kind === "mail" ? html`<rect x=${h.x - 10} y=${h.y - 7} width="20" height="14" /><path class="ol-flap" d=${`M${h.x - 10} ${h.y - 7}L${h.x} ${h.y + 1}L${h.x + 10} ${h.y - 7}`} />`
             : h.kind === "furniture" ? html`<rect x=${h.x - 8} y=${h.y - 8} width="16" height="16" />`
             : h.kind === "night" ? html`<circle cx=${h.x} cy=${h.y} r=${h.inPlace ? 15 : 8} /><path class="ol-moon" d=${h.inPlace ? moonPath(h.x + 10, h.y - 10) : moonPath(h.x, h.y)} />`
+            : h.kind === "seat" && h.for ? html`<circle class="ol-for-ring" cx=${h.x} cy=${h.y} r="13" /><circle cx=${h.x} cy=${h.y} r="9" />`
             : html`<circle cx=${h.x} cy=${h.y} r=${h.kind === "seat" ? 9 : 7} />`}
           ${coords && sel === h.key ? html`<text class="ol-coord" x=${h.x + 12} y=${h.y - 10}>${h.x}, ${h.y}</text>` : null}
         </g>`)}

package/dist/ui/fleet-office-levels.js

@@ -0,0 +1,105 @@
+// #2661: the Office levels on the page — what the host serves (GET /ui/office-levels, src/office-levels.ts: the level from
+// each instance's lifetime work, and where the viewer may see them, the numbers behind it) put into words and colours:
+// the tier a level is in, its title (the page's generic ones, or a skin pack's `levels.titles`), a title a pack pins on
+// someone (`levels.fixed`, which may hide the number), the badge's text and the XP bar. Pure: no DOM, no fetch.
+import { t, register } from "/assets/app-i18n.js";
+
+register("olv", {
+  en: { t0: "Novice", t1: "Apprentice", t2: "Adept", t3: "Expert", t4: "Master", t5: "Legend" },
+  "zh-TW": { t0: "新手", t1: "學徒", t2: "熟手", t3: "專家", t4: "大師", t5: "傳奇" },
+});
+
+/** The tiers by the level each starts at: grey, green, blue, the filled blue, gold, red (#2661). */
+export const TIER_FROM = [0, 10, 20, 35, 50, 100];
+/** The tier (0–5) a level is in. */
+export const tierOf = (level) => { let i = 0; while (i + 1 < TIER_FROM.length && level >= TIER_FROM[i + 1]) i++; return i; };
+
+/**
+ * A tier's badge colours from the dashboard's tokens (no palette of its own: the status tokens and their tints, as the
+ * renderer reads them, readPal). { bg, fg, line }.
+ */
+export function tierColours(tier, pal) {
+  switch (tier) {
+    case 1: return { bg: pal.okBg, fg: pal.ok, line: pal.ok };
+    case 2: return { bg: pal.accentDim, fg: pal.accent, line: pal.accent };
+    case 3: return { bg: pal.accent, fg: pal.surface, line: pal.accent };
+    case 4: return { bg: pal.warnBg, fg: pal.warn, line: pal.warn };
+    case 5: return { bg: pal.dangerBg, fg: pal.danger, line: pal.danger };
+    default: return { bg: pal.surface2, fg: pal.text2, line: pal.border };
+  }
+}
+
+/** A level as the badge writes it: up to 999 whole, then 1.1k, 12k (never wider than four characters). */
+export function badgeText(level) {
+  if (level < 1000) return String(level);
+  const k = level / 1000;
+  return k < 10 ? `${Math.floor(k * 10) / 10}k` : `${Math.floor(k)}k`;
+}
+
+/** The title for a level: the pack's table (the last entry it has reached), else the page's tier name. */
+export function titleOf(level, titles) {
+  if (Array.isArray(titles) && titles.length) {
+    let name = null;
+    for (const e of titles) if (level >= e.from) name = e.name;
+    if (name) return name;
+  }
+  return t(`olv.t${tierOf(level)}`);
+}
+
+/** What a pack pins on `name` (an instance or an NPC's id): { title, hideLevel } or null. */
+export function fixedOf(name, levels) {
+  const f = levels && levels.fixed;
+  return f && Object.prototype.hasOwnProperty.call(f, name) ? f[name] : null;
+}
+
+/** Work tokens to reach a level (the host's curve: level = floor(√(work ÷ unit))). */
+export const workFor = (level, unit) => level * level * unit;
+
+/** The XP bar: { next, toNext, pct (0–1) } — the next level, the work it still needs, how far along this level is. */
+export function xpOf(level, work, unit) {
+  const from = workFor(level, unit), to = workFor(level + 1, unit);
+  return { next: level + 1, toNext: Math.max(0, to - work), pct: to > from ? Math.min(1, Math.max(0, (work - from) / (to - from))) : 0 };
+}
+
+/** Tokens in short words: 950, 12.3K, 260M, 1.2B. */
+export function tokens(n) {
+  const v = Math.max(0, n);
+  if (v < 1000) return String(Math.round(v));
+  const [d, s] = v >= 1e9 ? [1e9, "B"] : v >= 1e6 ? [1e6, "M"] : [1e3, "K"];
+  const x = v / d;
+  return `${x < 100 ? Math.floor(x * 10) / 10 : Math.floor(x)}${s}`;
+}
+
+/**
+ * What the host answered (GET /ui/office-levels), checked: { enabled, unit, detail, levels: name → entry } with every
+ * entry's numbers sane (anything odd: no levels at all).
+ */
+export function levelsOk(v) {
+  const none = { enabled: false, unit: 100000, detail: false, levels: new Map() };
+  if (!v || typeof v !== "object" || v.enabled !== true || typeof v.levels !== "object" || !v.levels) return none;
+  const unit = Number.isFinite(v.unit) && v.unit > 0 ? v.unit : 100000;
+  const n = (x) => Number.isFinite(x) && x >= 0;
+  const out = new Map();
+  for (const [name, e] of Object.entries(v.levels)) {
+    if (!e || !Number.isInteger(e.level) || e.level < 0) continue;
+    const detail = v.detail === true && n(e.workTokens) && e.today && n(e.today.workTokens) && n(e.today.requests);
+    out.set(name, detail
+      ? { level: e.level, workTokens: e.workTokens, estimated: e.estimated === true, today: { workTokens: e.today.workTokens, requests: e.today.requests },
+        firstSeen: typeof e.firstSeen === "string" && /^\d{4}-\d{2}-\d{2}$/.test(e.firstSeen) ? e.firstSeen : null }
+      : { level: e.level });
+  }
+  return { enabled: true, unit, detail: v.detail === true, levels: out };
+}
+
+/**
+ * The badge a person's name tag carries: { text, tier } — or { mark: true } for a pinned title that hides the level —
+ * or null (levels off, or none for them).
+ */
+export function badgeOf(name, lv, levels) {
+  if (!lv || !lv.enabled) return null;
+  const fx = fixedOf(name, levels);
+  if (fx && fx.hideLevel) return { mark: true, tier: 0 };
+  const e = lv && lv.levels.get(name);
+  if (!e) return null;
+  return { text: badgeText(e.level), tier: tierOf(e.level) };
+}

package/dist/ui/fleet-office-model.js

@@ -74,13 +74,21 @@ export function officeRooms(view, filter) {
   return picked.map((r) => ({ ...r, nodes: r.nodes.filter((n) => pinned.has(n.name)) })).filter((r) => r.nodes.length);
 }
 
-/** A stored office's members: instance names, or `team:<name>` for a team's; none means everyone. */
+/**
+ * #2752: an office kept for nobody (its style's NPCs only) stores this one member: a team with no name, which no team
+ * has, so a version before it finds nobody too. `[]` still means everyone.
+ */
+export const NOBODY = "team:";
+/** Who an office's members pick: "everyone" ([]), "nobody" (only NOBODY), or "picked". */
+export const membersMode = (members) => (!members.length ? "everyone" : members.every((m) => m === NOBODY) ? "nobody" : "picked");
+/** A stored office's members: instance names, or `team:<name>` for a team's; none means everyone, NOBODY nobody. */
 export function membersOf(office, view) {
   const every = [...view.top, ...view.teams.flatMap((tm) => tm.nodes), ...view.rest.nodes];
   const byName = new Map(every.map((n) => [n.name, n]));
   if (!office.members.length) return [...byName.values()];
   const out = new Map();
   for (const m of office.members) {
+    if (m === NOBODY) continue;
     const team = m.startsWith("team:") ? view.teams.find((tm) => tm.name === m.slice(5)) : null;
     for (const n of team ? team.nodes : byName.has(m) ? [byName.get(m)] : []) if (!out.has(n.name)) out.set(n.name, n);
   }

package/dist/ui/fleet-office-pack.d.ts

@@ -3,16 +3,23 @@
 /** `dw` × `dh`: its displayed size in logical units (w·scale × h·scale unless the manifest says otherwise). */
 export interface PackStrip { src: string; frames: number; w: number; h: number; fps: number; ax: number; ay: number; dw: number; dh: number }
 export interface PackPoint { x: number; y: number }
-export interface PackArea { name: string; rect: { x: number; y: number; w: number; h: number }; seats: PackPoint[] }
-/** `label` (#2574): its name tag, or null. */
-export interface PackFurniture { id: string; sprite: PackStrip; x: number; y: number; depth: number | "y"; activeWhen: string[] | null; activeSprite: PackStrip | null; label: string | null }
+/** #2691: a seat reserved for `for` (lent while they are all elsewhere when `lend`); a plain seat has neither. */
+export interface PackSeat extends PackPoint { for?: string[]; lend?: boolean }
+export interface PackArea { name: string; rect: { x: number; y: number; w: number; h: number }; seats: PackSeat[] }
+/** `label` (#2574): its name tag, or null. `activeOn`/`hides` (#2698): when it turns active, and whether it hides its people then. */
+export interface PackFurniture { id: string; sprite: PackStrip; x: number; y: number; depth: number | "y"; activeWhen: string[] | null; activeSprite: PackStrip | null;
+  activeFor?: string[] | null; loop?: boolean; activeOn?: "state" | "seated"; hides?: boolean; label: string | null }
 export interface CheckedPack {
   format: 1; id: string; scale: number; background?: string; foreground?: string; matte?: string;
   areas: Record<string, PackArea>; stateZones: Record<string, string> | null; door: PackPoint;
+  /** #2736: where a letter from another office lands, or null (the waypoint nearest the middle). */
+  mailDrop: PackPoint | null;
   waypoints: Array<{ id: string; x: number; y: number }>; edges: Array<[string, string]>;
   furniture: PackFurniture[]; characters: Record<string, Record<string, PackStrip>>; byInstance: Record<string, string>;
   props: Record<string, PackStrip>; bubbles: Record<string, Record<string, string[]>>;
   room: { floor?: string; wall?: string }; desk: { back?: string; front?: string; lit?: string };
+  /** #2661: the Office levels' words — titles from each level up, and titles pinned on instances or NPCs. */
+  levels?: { titles?: Array<{ from: number; name: string }>; fixed?: Record<string, { title: string; hideLevel: boolean }> };
 }
 export interface LayoutOverrides {
   pack: string;
@@ -20,7 +27,11 @@ export interface LayoutOverrides {
   furniture?: Record<string, [number, number]>;
   /** #2665: an item's night place (an item with a `night` only). */
   furnitureNight?: Record<string, [number, number]>;
+  /** #2691: a seat's reservation by area and slot ("0", "1", …), in place of the pack's; `for: []` is none. */
+  seatFor?: Record<string, Record<string, { for: string[]; lend: boolean }>>;
   door?: [number, number];
+  /** #2736: where a letter from another office lands. */
+  mailDrop?: [number, number];
   waypoints?: Array<{ id: string; x: number; y: number }>;
   edges?: Array<[string, string]>;
 }
@@ -38,6 +49,7 @@ export function packStrips(pack: CheckedPack): Array<{ at: string; strip: PackSt
 export function checkLayoutOverrides(x: unknown): { ok: true; overrides: LayoutOverrides } | { ok: false; error: string };
 export function applyOverrides(pack: CheckedPack, ov: LayoutOverrides | null | undefined): { ok: true; pack: CheckedPack } | { ok: false; error: string };
 export function fitNight<T extends LayoutOverrides | null | undefined>(pack: CheckedPack, ov: T): T;
+export function fitSeatFor<T extends LayoutOverrides | null | undefined>(pack: CheckedPack, ov: T): T;
 export function overridesBetween(pack: CheckedPack, edited: CheckedPack): LayoutOverrides | null;
 export function poseStrip(set: Record<string, PackStrip> | null | undefined, pose: string, heading?: { dx: number; dy: number } | null): { strip: PackStrip; mirror: boolean } | null;
 export function walkStrip(f: { walk?: Record<string, PackStrip> | null; walking?: boolean; heading?: { dx: number; dy: number } | null } | null | undefined): { strip: PackStrip; mirror: boolean } | null;