@songsid/agend 2.3.2-beta.14 → 2.3.2-beta.16

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

@@ -8,6 +8,9 @@
 // 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
@@ -22,13 +25,14 @@ 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.",
@@ -37,9 +41,9 @@ register("orgl", {
   },
   "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: "有人在這期間修改了辦公室。你的配置已保留：再按一次儲存，會套用到目前的清單。",
@@ -57,7 +61,7 @@ const nightAt = (f) => (f.night.x !== null && f.night.x !== undefined && f.night
 /**
  * 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 waypoints.
+ * 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 = [];
@@ -71,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;
 }
@@ -87,6 +93,7 @@ export function moveHandle(pack, key, x, y) {
   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;
 }
@@ -255,10 +262,11 @@ 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}${h.for ? " reserved" : ""}${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" />`

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

@@ -12,10 +12,14 @@ export interface PackFurniture { id: string; sprite: PackStrip; x: number; y: nu
 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;
@@ -26,6 +30,8 @@ export interface LayoutOverrides {
   /** #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]>;
 }

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

@@ -35,6 +35,10 @@
 //                                                     the org chart's states (fleet-org.js ORG_STATES) → an area; a
 //                                                     state it does not name goes to "default", else the first area
 //     "door": [640, 700],                             optional: where someone new walks in from (default: bottom middle)
+//     "mailDrop": [640, 420],                         optional (#2736): where a letter from another office lands (more
+//                                                     waiting step GAP px right of it, past any seat); default: the
+//                                                     waypoint nearest the middle off every seat (fleet-office-zones.js
+//                                                     dropPoint)
 //     "waypoints": [{ "id": "hall", "x": 640, "y": 600 }, …], "edges": [["hall", "east"], …],
 //                                                     optional: the walkable graph (else people walk straight)
 //     "straight": true,                               optional (#2634): every walk goes across, then up or down — each
@@ -87,6 +91,13 @@
 //                                                     ≤ 40 characters each), in place of the page's own
 //     "room": { "floor": "floor.png", "wall": "wall.png" }, "desk": { "back": …, "front": …, "lit": … }
 //                                                     optional: for the desks layout (a pack without stateZones)
+//     "levels": {                                     optional (#2661): the Office levels' words
+//       "titles": [{ "from": 1, "name": "Intern" }, …],   the title from each level up (≤ 32, `from` 0–100000
+//                                                     rising, a name 1–24 characters), in place of the page's own
+//       "fixed": { "atlas": { "title": "Founder", "hideLevel": true } } }
+//                                                     a title pinned on an instance (or an NPC: a furniture item's
+//                                                     id) whatever its level (≤ 500); hideLevel: its badge is a mark,
+//                                                     its card has no "Lv n" or XP bar
 //   }
 //
 // A STRIP is { "src": "idle.png", "frames": 4, "w": 32, "h": 48, "fps": 4, "ax": 16, "ay": 44 }: `frames` frames of
@@ -120,7 +131,7 @@
 //     "seatFor": { "desks": { "0": { "for": ["atlas"], "lend": false } } },
 //                                                     a seat's reservation by area and slot (#2691), in place of the
 //                                                     pack's own for that seat; "for": [] is none (lends nothing)
-//     "door": [640, 700],
+//     "door": [640, 700], "mailDrop": [640, 420],     (#2736: kept beside the offices on disk, as furnitureNight)
 //     "waypoints": [{ "id": "hall", "x": 640, "y": 600 }, …], "edges": [["hall", "east"], …] }
 //                                                     the walkable graph, replaced whole (edges need waypoints)
 //
@@ -150,7 +161,7 @@ const RESERVED = new Set(["cozy"]);
 const ID = /^[A-Za-z0-9_-]{1,40}$/;
 const SRC = /^[A-Za-z0-9._/-]{1,200}$/;
 const HEX = /^#[0-9a-f]{6}$/i;
-const LIMIT = { areas: 32, seats: 64, furniture: 128, waypoints: 512, edges: 2048, sets: 64, byInstance: 500, lines: 12, line: 40, seatFor: 16 };
+const LIMIT = { areas: 32, seats: 64, furniture: 128, waypoints: 512, edges: 2048, sets: 64, byInstance: 500, lines: 12, line: 40, seatFor: 16, titles: 32, title: 24, fixed: 500 };
 
 class Refused extends Error { constructor(at, why) { super(`${at}: ${why}`); } }
 /** `o[k]` when it is o's own property, else undefined: a name from a pack or a page never reaches Object.prototype. */
@@ -239,6 +250,43 @@ function states(v, at) {
   return Array.isArray(v) ? list(v, 8, at).map((s, i) => one(s, `${at}[${i}]`)) : [one(v, at)];
 }
 
+/** #2661: a title's words — 1–LIMIT.title characters on one line. */
+function titleText(v, at) {
+  if (typeof v !== "string" || !v.trim() || [...v.trim()].length > LIMIT.title || /[\u0000-\u001f\u007f]/.test(v)) throw new Refused(at, `1–${LIMIT.title} characters`);
+  return v.trim();
+}
+/** #2661: a pack's `levels` (titles, fixed), checked; null when it has none. */
+function levelsOf(v) {
+  if (v === undefined) return null;
+  obj(v, "levels");
+  keys(v, ["titles", "fixed"], "levels");
+  const out = {};
+  if (v.titles !== undefined) {
+    let last = -1;
+    out.titles = list(v.titles, LIMIT.titles, "levels.titles").map((t, i) => {
+      const at = `levels.titles[${i}]`;
+      obj(t, at); keys(t, ["from", "name"], at);
+      const from = int(t.from, 0, 100000, `${at}.from`);
+      if (from <= last) throw new Refused(`${at}.from`, "higher than the title before it");
+      last = from;
+      return { from, name: titleText(t.name, `${at}.name`) };
+    });
+  }
+  if (v.fixed !== undefined) {
+    obj(v.fixed, "levels.fixed");
+    if (Object.keys(v.fixed).length > LIMIT.fixed) throw new Refused("levels.fixed", `at most ${LIMIT.fixed}`);
+    out.fixed = {};
+    for (const [k, f] of Object.entries(v.fixed)) {
+      const at = `levels.fixed.${k}`;
+      if (inherited(k)) throw new Refused(at, "an instance's name (not an inherited one)");
+      obj(f, at); keys(f, ["title", "hideLevel"], at);
+      if (f.hideLevel !== undefined && typeof f.hideLevel !== "boolean") throw new Refused(`${at}.hideLevel`, "true or false");
+      out.fixed[k] = { title: titleText(f.title, `${at}.title`), hideLevel: f.hideLevel === true };
+    }
+  }
+  return out;
+}
+
 /**
  * A pack's manifest, strictly: { ok: true, pack } or { ok: false, error: "<where>: <why>" }. `kept`: a pack the host
  * keeps already (read back, not uploaded), which may hold a RESERVED id.
@@ -246,7 +294,7 @@ function states(v, at) {
 export function checkSkinPack(x, { kept = false } = {}) {
   try {
     obj(x, "pack");
-    keys(x, ["format", "id", "scale", "background", "foreground", "matte", "areas", "stateZones", "door", "waypoints", "edges", "straight", "furniture", "characters", "byInstance", "props", "bubbles", "room", "desk"], "pack");
+    keys(x, ["format", "id", "scale", "background", "foreground", "matte", "areas", "stateZones", "door", "mailDrop", "waypoints", "edges", "straight", "furniture", "characters", "byInstance", "props", "bubbles", "room", "desk", "levels"], "pack");
     if (x.format !== 1) throw new Refused("format", "1");
     if (typeof x.id !== "string" || !ID.test(x.id)) throw new Refused("id", "1–40 letters, digits, _ or -");
     if (BUILT_IN.has(x.id) || (!kept && RESERVED.has(x.id))) throw new Refused("id", "a built-in skin's id");
@@ -344,14 +392,17 @@ export function checkSkinPack(x, { kept = false } = {}) {
         });
       }
     }
+    const levels = levelsOf(x.levels);
     const room = x.room === undefined ? {} : obj(x.room, "room"), desk = x.desk === undefined ? {} : obj(x.desk, "desk");
     keys(room, ["floor", "wall"], "room"); keys(desk, ["back", "front", "lit"], "desk");
     const opt = (v, at) => (v === undefined ? undefined : src(v, at));
     return { ok: true, pack: {
       format: 1, id: x.id, scale, background: opt(x.background, "background"), foreground: opt(x.foreground, "foreground"), matte: x.matte === undefined ? undefined : x.matte.toLowerCase(), areas, stateZones,
-      door: x.door === undefined ? { x: LOGICAL.w / 2, y: LOGICAL.h - 10 } : point(x.door, "door"), waypoints, edges, straight: x.straight === true, furniture, characters, byInstance,
+      door: x.door === undefined ? { x: LOGICAL.w / 2, y: LOGICAL.h - 10 } : point(x.door, "door"),
+      mailDrop: x.mailDrop === undefined ? null : point(x.mailDrop, "mailDrop"), waypoints, edges, straight: x.straight === true, furniture, characters, byInstance,
       props: x.props === undefined ? {} : strips(x.props, PROPS, "props", scale), bubbles,
       room: { floor: opt(room.floor, "room.floor"), wall: opt(room.wall, "room.wall") }, desk: { back: opt(desk.back, "desk.back"), front: opt(desk.front, "desk.front"), lit: opt(desk.lit, "desk.lit") },
+      ...(levels ? { levels } : {}),
     } };
   } catch (err) {
     if (err instanceof Refused) return { ok: false, error: err.message };
@@ -392,7 +443,7 @@ const reserve = (s, r) => { const { for: _f, lend: _l, ...p } = s; return r && r
 export function checkLayoutOverrides(x) {
   try {
     obj(x, "overrides");
-    keys(x, ["pack", "seats", "furniture", "furnitureNight", "seatFor", "door", "waypoints", "edges"], "overrides");
+    keys(x, ["pack", "seats", "furniture", "furnitureNight", "seatFor", "door", "mailDrop", "waypoints", "edges"], "overrides");
     if (typeof x.pack !== "string" || !ID.test(x.pack)) throw new Refused("overrides.pack", "1–40 letters, digits, _ or -");
     const out = { pack: x.pack };
     if (x.seats !== undefined) {
@@ -448,6 +499,7 @@ export function checkLayoutOverrides(x) {
       }
     }
     if (x.door !== undefined) { const q = point(x.door, "overrides.door"); out.door = [q.x, q.y]; }
+    if (x.mailDrop !== undefined) { const q = point(x.mailDrop, "overrides.mailDrop"); out.mailDrop = [q.x, q.y]; }
     if (x.edges !== undefined && x.waypoints === undefined) throw new Refused("overrides.edges", "only with waypoints");
     if (x.waypoints !== undefined) {
       const ids = new Set();
@@ -508,8 +560,9 @@ export function applyOverrides(pack, ov) {
       return { ...f, ...(q ? { x: q[0], y: q[1] } : {}), ...(n ? { night: { ...f.night, x: n[0], y: n[1] } } : {}) };
     });
     const door = ov.door ? { x: ov.door[0], y: ov.door[1] } : pack.door;
+    const mailDrop = ov.mailDrop ? { x: ov.mailDrop[0], y: ov.mailDrop[1] } : pack.mailDrop ?? null;
     const graph = ov.waypoints ? { waypoints: ov.waypoints.map((w) => ({ ...w })), edges: (ov.edges || []).map((e) => [e[0], e[1]]) } : { waypoints: pack.waypoints, edges: pack.edges };
-    return { ok: true, pack: { ...pack, areas, furniture, door, ...graph } };
+    return { ok: true, pack: { ...pack, areas, furniture, door, mailDrop, ...graph } };
   } catch (err) {
     if (err instanceof Refused) return { ok: false, error: err.message };
     throw err;
@@ -575,6 +628,9 @@ export function overridesBetween(pack, edited) {
     if (o.night.x !== f.night.x || o.night.y !== f.night.y) (ov.furnitureNight ||= {})[f.id] = [f.night.x, f.night.y];
   }
   if (pack.door.x !== edited.door.x || pack.door.y !== edited.door.y) ov.door = [edited.door.x, edited.door.y];
+  // #2736: a mail drop placed (the pack has none) or moved from the pack's.
+  const md = pack.mailDrop ?? null, ed = edited.mailDrop ?? null;
+  if (ed && (!md || md.x !== ed.x || md.y !== ed.y)) ov.mailDrop = [ed.x, ed.y];
   if (!same(pack.waypoints, edited.waypoints) || !same(pack.edges, edited.edges)) {
     ov.waypoints = edited.waypoints.map((w) => ({ id: w.id, x: w.x, y: w.y }));
     ov.edges = edited.edges.map((e) => [e[0], e[1]]);

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

@@ -13,8 +13,9 @@
 // @typedef {"working"|"idle"|"paused"|"needs"|"walk"} OfficePose   (fleet-office-model.js POSES; "away" draws no one)
 // @typedef {{ pal: OfficePalette, mode: "dark"|"light", labels: { lobby, closed, areas: { [area]: string } } }} OfficeEnv
 // @typedef {{ name: string, label: string, state: string, pose: OfficePose|"away", light: "warn"|"danger"|null,
-//   lamp: boolean, sign: "closed"|null, coat: string, work: number, dim: boolean, match: boolean, free: boolean }} OfficeLook
-//   (one occupant; `free`: standing in a zone, not behind a desk cell)
+//   lamp: boolean, sign: "closed"|null, coat: string, work: number, dim: boolean, match: boolean, free: boolean,
+//   badge?: { text, tier } | { mark: true } }} OfficeLook
+//   (one occupant; `free`: standing in a zone, not behind a desk cell; `badge`: its level on its name tag, #2661)
 // @typedef {object} OfficeSkin
 // @property {string} id
 // @property {object} [pack]        a checked pack (fleet-office-pack.js); with `pack.stateZones` the zones layout is used
@@ -44,15 +45,18 @@
 import { t } from "/assets/app-i18n.js";
 import { frameAt, nameHash } from "./fleet-office-model.js";
 import { CHAR_DEPTH, LOGICAL, checkSkinPack, own, packImages, poseStrip, stripBox, walkStrip } from "./fleet-office-pack.js";
+import { tierColours } from "./fleet-office-levels.js";
 
 export { nameHash };
 
 // ── The palette: the dashboard's tokens, read by the renderer; furniture keeps its own wood and metal ──
 
-/** @typedef {{ bg, surface, surface2, border, text, text2, text3, ok, warn, danger, focus, fx: { task, send, report, broadcast } }} OfficePalette */
+/** @typedef {{ bg, surface, surface2, border, text, text2, text3, ok, warn, danger, focus, accent, accentDim, okBg, warnBg, dangerBg, fx: { task, send, report, broadcast } }} OfficePalette */
 export const DEFAULT_PAL = {
   bg: "#212121", surface: "#2f2f2f", surface2: "#3a3a3a", border: "#3d3d3d", text: "#ececec", text2: "#b4b4b4", text3: "#a3a3a3",
   ok: "#4cc38a", warn: "#e3b341", danger: "#ff8a80", focus: "#7ab7ff", fx: { task: "#b794f6", send: "#2dd4bf", report: "#f472b6", broadcast: "#fb923c" },
+  // #2661: the level badges' tiers (the status tokens and their tints).
+  accent: "#7ab7ff", accentDim: "rgba(122, 183, 255, 0.14)", okBg: "rgba(76, 195, 138, 0.14)", warnBg: "rgba(227, 179, 65, 0.14)", dangerBg: "rgba(255, 138, 128, 0.14)",
 };
 /** Light or dark, from the page's own background token (whatever chose it: the person, the system, a theme). */
 export function modeOf(pal) {
@@ -235,6 +239,7 @@ function drawDeskFront(ctx, d, look, env) {
     ctx.fillText(fitText(ctx, look.label, d.w - 18), d.x + d.w / 2, d.y + 86.5);
   }
   ctx.restore();
+  if (!look.notag && look.badge) drawBadge(ctx, d.x + 6, d.y + 78, look.badge, pal);
   if (look.match) { ctx.save(); ctx.strokeStyle = pal.focus; ctx.lineWidth = 2; ctx.strokeRect(d.x + 2, d.y + 2, d.w - 4, d.h - 6); ctx.restore(); }
 }
 
@@ -296,6 +301,36 @@ export function tagBox(ctx, x, y, label) {
   ctx.restore();
   return { x: Math.round(x - w / 2), y: y + 3, w, h: 14, text: t };
 }
+/**
+ * #2661: a level badge on a name tag's top-left corner (x, y: the tag's corner), overlapping its edge like an app's
+ * badge — it takes none of the tag's width. `badge`: { text, tier } (fleet-office-levels.js badgeOf), or { mark } for a
+ * pinned title that hides the number: a small diamond.
+ */
+export function drawBadge(ctx, x, y, badge, pal) {
+  if (!badge) return;
+  const c = tierColours(badge.tier, pal);
+  ctx.save();
+  ctx.globalAlpha = 1;
+  if (badge.mark) {
+    ctx.translate(x, y); ctx.rotate(Math.PI / 4);
+    ctx.fillStyle = pal.surface; ctx.fillRect(-4, -4, 8, 8);
+    ctx.fillStyle = c.bg; ctx.fillRect(-4, -4, 8, 8);
+    ctx.strokeStyle = c.line; ctx.lineWidth = 1; ctx.strokeRect(-3.5, -3.5, 7, 7);
+    ctx.restore();
+    return;
+  }
+  ctx.font = BADGE_FONT;
+  const w = Math.max(12, Math.ceil((ctx.measureText ? ctx.measureText(badge.text).width : badge.text.length * 5) + 6)), h = 11;
+  const bx = Math.round(x - w / 2 + 3), by = Math.round(y - h / 2 - 1);
+  // An opaque surface first, so a tint reads the same over any picture.
+  ctx.fillStyle = pal.surface; ctx.fillRect(bx, by, w, h);
+  ctx.fillStyle = c.bg; ctx.fillRect(bx, by, w, h);
+  ctx.strokeStyle = c.line; ctx.lineWidth = 1; ctx.strokeRect(bx + 0.5, by + 0.5, w - 1, h - 1);
+  ctx.fillStyle = c.fg; ctx.textAlign = "center"; ctx.textBaseline = "middle"; ctx.fillText(badge.text, bx + w / 2, by + h / 2 + 0.5);
+  ctx.restore();
+}
+const BADGE_FONT = "700 8px system-ui, sans-serif";
+
 /** Zones: a name tag under someone's feet at (x, y). */
 function drawTag(ctx, x, y, look, env) {
   const { pal } = env;
@@ -307,6 +342,7 @@ function drawTag(ctx, x, y, look, env) {
   ctx.strokeStyle = look.match ? pal.focus : pal.border; ctx.lineWidth = look.match ? 2 : 1; ctx.strokeRect(Math.round(x - w / 2) + 0.5, y + 3.5, w - 1, 13);
   ctx.fillStyle = pal.text; ctx.textAlign = "center"; ctx.textBaseline = "middle"; ctx.fillText(t, x, y + 10.5);
   ctx.restore();
+  if (look.badge) drawBadge(ctx, Math.round(x - w / 2), y + 3, look.badge, pal);
 }
 
 /**

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

@@ -1,16 +1,20 @@
 // The Office view's data, behind one small seam (fleet-office.js uses only these calls):
 // - the offices people made: the host's (GET / PUT /ui/offices, src/web-office-store.ts — one list for every viewer);
 //   what comes back is checked again here (fleet-office-model.js officesOk), never trusted;
+// - #2716: the whole-fleet office's style, kept on the host for everyone (GET /ui/offices's autoSkin; PUT
+//   /ui/office-style, an admin's) — this browser's own pick (skin(): an admin's copy of it, anyone else's own choice);
 // - this browser's own choices (localStorage; blocked storage: this page only, as the canvas's Canvas/List): which
-//   office is shown, the auto office's member filter, and its style (skin); #2540: the view (zoom and centre) and the
+//   office is shown, the auto office's member filter; #2540: the view (zoom and centre) and the
 //   fit mode (Fit or Fill) per office; #2554: whether All offices shows the lobby tile.
 // - the skin packs an admin uploaded (#2513: GET /ui/office-skins, POST to upload one, DELETE to remove one;
 //   src/web-office-skins.ts). The office editor and the layout editor call saveOffices() with the whole list and the rev
 //   they read (a change in between answers 409).
+// - #2661: everyone's level (GET /ui/office-levels, src/office-levels.ts; fleet-office-levels.js levelsOk checks it).
 // - #2692: the agents' pack changes (GET / POST /ui/office-pack-changes, an admin's): which agents may change packs, the
 //   fleet's approval mode, the changes waiting for a yes, and the newest log entries.
 import { AUTO_ID, filterOk, officesOk } from "./fleet-office-model.js";
 import { fitModeOk, savedOk } from "./fleet-office-view.js";
+import { levelsOk } from "./fleet-office-levels.js";
 
 const CHOICE_KEY = "agend_org_office", FILTER_KEY = "agend_org_office_filter", SKIN_KEY = "agend_org_office_skin", ASLEEP_KEY = "agend_org_office_hide_asleep", NIGHT_KEY = "agend_org_office_night";
 /** #2554: "0" when All offices leaves the lobby tile out (default: shown). */
@@ -65,15 +69,26 @@ export function createOfficeStore({ fetch: get = globalThis.fetch, storage } = {
   const write = (k, v) => { try { const s = st(); if (s) s.setItem(k, v); } catch { /* this page only */ } };
   const headers = { "Content-Type": "application/json" };
   return {
-    /** { rev, offices } from the host; null when it could not be read (no offices shown but the auto one). */
+    /**
+     * { rev, offices, autoSkin } from the host (#2716 autoSkin: the whole-fleet office's style, or null: none kept); null
+     * when it could not be read (no offices shown but the auto one).
+     */
     async offices() {
       try {
         const r = await get("/ui/offices", { method: "GET", headers });
         if (!r || !r.ok) return null;
         const d = await r.json();
-        return { rev: Number.isSafeInteger(d && d.rev) ? d.rev : 0, offices: officesOk(d && d.offices) };
+        return { rev: Number.isSafeInteger(d && d.rev) ? d.rev : 0, offices: officesOk(d && d.offices), autoSkin: d && typeof d.autoSkin === "string" && PACK_ID.test(d.autoSkin) ? d.autoSkin : null };
       } catch { return null; }
     },
+    /** #2716: the whole-fleet office's style for everyone (an admin session): { ok, autoSkin } or { ok: false, status, error }. */
+    async saveAutoSkin(skin) {
+      try {
+        const r = await get("/ui/office-style", { method: "PUT", headers, body: JSON.stringify({ skin }) });
+        const d = await r.json().catch(() => ({}));
+        return r.ok ? { ok: true, autoSkin: typeof d.autoSkin === "string" ? d.autoSkin : null } : { ok: false, status: r.status, error: d.error || "office_style_failed" };
+      } catch { return { ok: false, status: 0, error: "office_style_failed" }; }
+    },
     /**
      * Replace the host's list (an admin session; `rev`: the one read — required: the host refuses a save without it,
      * so two editors never overwrite each other unseen). { ok, rev, offices } or { ok: false, status, error }.
@@ -95,6 +110,17 @@ export function createOfficeStore({ fetch: get = globalThis.fetch, storage } = {
         return actsOk(d && d.acts, d && d.now);
       } catch { return null; }
     },
+    /**
+     * #2661: everyone's level (GET /ui/office-levels; a share link's own, through its lease), checked (levelsOk); null
+     * when it could not be read (the levels shown stay).
+     */
+    async levels() {
+      try {
+        const r = await get("/ui/office-levels", { method: "GET", headers });
+        if (!r || !r.ok) return null;
+        return levelsOk(await r.json());
+      } catch { return null; }
+    },
     /** The skin packs the host keeps: { rev, packs: [{ id, name, sha }] }; null when they could not be read. */
     async skins() {
       try {
@@ -158,6 +184,8 @@ export function createOfficeStore({ fetch: get = globalThis.fetch, storage } = {
     saveFilter: (f) => write(FILTER_KEY, JSON.stringify(filterOk(f))),
     /** The whole fleet's style here: a skin id ("pixel": desks, "studio" and "cozy": zones); none chosen yet: cozy (#2631); an unknown one is the default where used. */
     skin: () => { const v = read(SKIN_KEY); return typeof v === "string" && /^[A-Za-z0-9_-]{1,40}$/.test(v) ? v : "cozy"; },
+    /** #2716: this browser's own pick of it, or null (none made here). */
+    skinChosen: () => { const v = read(SKIN_KEY); return typeof v === "string" && /^[A-Za-z0-9_-]{1,40}$/.test(v) ? v : null; },
     saveSkin: (id) => write(SKIN_KEY, String(id)),
     /** Whether paused and stopped people are left out of the Office here (default: shown). */
     hideAsleep: () => read(ASLEEP_KEY) === "1",

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

@@ -97,6 +97,14 @@ export function miniFrame(v, size, w, h) {
   const x1 = Math.min(w, (size.w - v.x) / v.k), y1 = Math.min(h, (size.h - v.y) / v.k);
   return { x: x0, y: y0, width: Math.max(0, x1 - x0), height: Math.max(0, y1 - y0) };
 }
+/**
+ * #2737: the whole scene is in view (the overview's frame covers all of it, to half a unit), so the overview would only
+ * repeat the panel — and sit over the one corner of it a person cannot otherwise see.
+ */
+export function wholeInView(v, size, w, h) {
+  const f = miniFrame(v, size, w, h);
+  return f.x <= 0.5 && f.y <= 0.5 && f.x + f.width >= w - 0.5 && f.y + f.height >= h - 0.5;
+}
 
 // ── Kept per device, per office: the zoom and the logical point in the middle (the viewport's size may differ) ──
 

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

@@ -140,7 +140,7 @@ export function zonesLayout(pack, nodes, prev = new Map(), { night = false } = {
     return { key: `zone/${n.name}`, node: n, x: s.x - 24, y: s.y - 52, w: 48, h: 66, seat: { x: s.x, y: s.y }, wp: null, area: s.area, slot: s.slot, night: sleepers.has(n.name) };
   });
   return { mode: "zones", rooms: [{ key: "\u0000zones", name: null, lobby: false, x: 0, y: 0, w: LOGICAL.w, h: LOGICAL.h, desks }], areas: pack.areas,
-    waypoints: pack.waypoints || [], edges: pack.edges || [], straight: pack.straight === true, door: pack.door, width: LOGICAL.w, height: LOGICAL.h, seats, crowd, over };
+    waypoints: pack.waypoints || [], edges: pack.edges || [], straight: pack.straight === true, door: pack.door, mailDrop: pack.mailDrop || null, width: LOGICAL.w, height: LOGICAL.h, seats, crowd, over };
 }
 
 // ── Walking ──
@@ -227,7 +227,9 @@ export function walkTargets(desks, graph, t, wander = true, furniture = [], nigh
  */
 export const MAIL = { MAX_WAIT: 60000, GAP: 16, SEARCH: 320, ASLEEP: new Set(["paused", "stopped"]), MAX: 20 };
 /**
- * Where the `n`th waiting letter lands: `n` GAPs along from the waypoint nearest the room's middle — the nearest whose
+ * Where the `n`th waiting letter lands. #2736: the layout's `mailDrop` when it has one — the `n`th of the slots GAP
+ * apart rightwards from it that no seat is on (never beyond the room's right edge); fewer than that, today's rule. Otherwise `n`
+ * GAPs along from the waypoint nearest the room's middle — the nearest whose
  * spot (offset included) no seat of the office is on, taken or free (someone may sit there any moment; #2561 likewise);
  * with none, the nearest point round the middle (rings GAP·2 apart, inside the room) that no seat is on; with none of
  * those either, null — the letter is not delivered here (never on a seat).
@@ -236,6 +238,12 @@ export function dropPoint(L, n = 0) {
   const mid = { x: L.width / 2, y: L.height * 0.55 }, d = (p, q) => Math.hypot(p.x - q.x, p.y - q.y);
   const seats = [...Object.values(L.areas || {}).flatMap((a) => a.seats || []), ...desksIn(L).map((q) => q.seat)];
   const onSeat = (p) => seats.some((q) => d(p, q) < 4);
+  // #2751 review: the nth off-seat slot (slots GAP apart from the mailDrop), so two letters never share one.
+  const md = L.mailDrop;
+  if (md) for (let i = 0, free = 0; md.x + i * MAIL.GAP <= L.width; i++) {
+    const p = { x: Math.round(md.x + i * MAIL.GAP), y: Math.round(md.y) };
+    if (!onSeat(p) && free++ === n) return p;
+  }
   const spots = (L.waypoints || []).map((w) => ({ x: Math.round(w.x + n * MAIL.GAP), y: Math.round(w.y), from: w }))
     .filter((p) => !onSeat(p.from) && !onSeat(p)).sort((p, q) => d(p.from, mid) - d(q.from, mid));
   if (spots.length) return { x: spots[0].x, y: spots[0].y };