@wildwinter/app-shell 0.38.0 → 0.40.0

package/dist/job.css

@@ -6,7 +6,7 @@
   padding: 7px 18px;
   border-bottom: 1px solid var(--line-soft, var(--line));
   background: var(--surface);
-  font-size: 0.8rem;
+  font-size: 13px;
   color: var(--muted);
 }
 .job-strip[hidden] {
@@ -36,11 +36,34 @@
     transition: none;
   }
 }
+.job-strip.indeterminate .job-fill {
+  width: 25%;
+  transition: none;
+  animation: var(--anim-job-band, none);
+}
+@keyframes job-band {
+  from {
+    transform: translateX(-100%);
+  }
+  to {
+    transform: translateX(400%);
+  }
+}
+@media (prefers-reduced-motion: reduce) {
+  .job-strip.indeterminate .job-fill {
+    width: 100%;
+    opacity: 0.35;
+  }
+}
 .job-count,
 .job-time {
   flex: none;
   font-variant-numeric: tabular-nums;
 }
+.job-count[hidden],
+.job-cancel[hidden] {
+  display: none;
+}
 .job-time {
   opacity: 0.8;
 }

package/dist/job.css.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/job.css"],"sourcesContent":["/* The long-job progress strip. Consumes the app's tokens only, so it wears\n   whichever palette the host is in. Quiet: it is a status line, not an alarm. */\n\n.job-strip {\n  display: flex;\n  align-items: center;\n  gap: 12px;\n  padding: 7px 18px;\n  border-bottom: 1px solid var(--line-soft, var(--line));\n  background: var(--surface);\n  font-size: 0.8rem;\n  color: var(--muted);\n}\n.job-strip[hidden] { display: none; }\n\n.job-label { flex: none; }\n\n.job-bar {\n  flex: 1;\n  min-width: 80px;\n  height: 6px;\n  background: var(--line-soft, var(--line));\n  border-radius: var(--radius-pill, 999px);\n  overflow: hidden;\n}\n.job-fill {\n  display: block;\n  height: 100%;\n  width: 0;\n  background: var(--accent);\n  border-radius: var(--radius-pill, 999px);\n  transition: width var(--dur-quick, 120ms) linear;\n}\n@media (prefers-reduced-motion: reduce) {\n  .job-fill { transition: none; }\n}\n\n.job-count,\n.job-time {\n  flex: none;\n  font-variant-numeric: tabular-nums;\n}\n.job-time { opacity: 0.8; }\n\n.job-cancel {\n  flex: none;\n  font: inherit;\n  color: var(--muted);\n  background: none;\n  border: 1px solid var(--line);\n  border-radius: var(--radius-sm, 4px);\n  padding: 3px 10px;\n  cursor: pointer;\n}\n.job-cancel:hover:not(:disabled) { color: var(--danger); border-color: var(--danger); background: none; }\n.job-cancel:focus-visible { outline: 2px solid var(--accent); outline-offset: 1px; }\n.job-cancel:disabled { opacity: 0.6; cursor: default; }\n"],"mappings":";AAGA,CAAC;AACC,WAAS;AACT,eAAa;AACb,OAAK;AACL,WAAS,IAAI;AACb,iBAAe,IAAI,MAAM,IAAI,WAAW,EAAE,IAAI;AAC9C,cAAY,IAAI;AAChB,aAAW;AACX,SAAO,IAAI;AACb;AACA,CAVC,SAUS,CAAC;AAAU,WAAS;AAAM;AAEpC,CAAC;AAAY,QAAM;AAAM;AAEzB,CAAC;AACC,QAAM;AACN,aAAW;AACX,UAAQ;AACR,cAAY,IAAI,WAAW,EAAE,IAAI;AACjC,iBAAe,IAAI,aAAa,EAAE;AAClC,YAAU;AACZ;AACA,CAAC;AACC,WAAS;AACT,UAAQ;AACR,SAAO;AACP,cAAY,IAAI;AAChB,iBAAe,IAAI,aAAa,EAAE;AAClC,cAAY,MAAM,IAAI,WAAW,EAAE,OAAO;AAC5C;AACA,QAAO,wBAAyB;AAC9B,GATD;AASa,gBAAY;AAAM;AAChC;AAEA,CAAC;AACD,CAAC;AACC,QAAM;AACN,wBAAsB;AACxB;AACA,CAJC;AAIW,WAAS;AAAK;AAE1B,CAAC;AACC,QAAM;AACN,QAAM;AACN,SAAO,IAAI;AACX,cAAY;AACZ,UAAQ,IAAI,MAAM,IAAI;AACtB,iBAAe,IAAI,WAAW,EAAE;AAChC,WAAS,IAAI;AACb,UAAQ;AACV;AACA,CAVC,UAUU,MAAM,KAAK;AAAa,SAAO,IAAI;AAAW,gBAAc,IAAI;AAAW,cAAY;AAAM;AACxG,CAXC,UAWU;AAAiB,WAAS,IAAI,MAAM,IAAI;AAAW,kBAAgB;AAAK;AACnF,CAZC,UAYU;AAAY,WAAS;AAAK,UAAQ;AAAS;","names":[]}
+{"version":3,"sources":["../src/job.css"],"sourcesContent":["/* The long-job progress strip. Consumes the app's tokens only, so it wears\n   whichever palette the host is in. Quiet: it is a status line, not an alarm. */\n\n.job-strip {\n  display: flex;\n  align-items: center;\n  gap: 12px;\n  padding: 7px 18px;\n  border-bottom: 1px solid var(--line-soft, var(--line));\n  background: var(--surface);\n  font-size: 13px;\n  color: var(--muted);\n}\n.job-strip[hidden] { display: none; }\n\n.job-label { flex: none; }\n\n.job-bar {\n  flex: 1;\n  min-width: 80px;\n  height: 6px;\n  background: var(--line-soft, var(--line));\n  border-radius: var(--radius-pill, 999px);\n  overflow: hidden;\n}\n.job-fill {\n  display: block;\n  height: 100%;\n  width: 0;\n  background: var(--accent);\n  border-radius: var(--radius-pill, 999px);\n  transition: width var(--dur-quick, 120ms) linear;\n}\n@media (prefers-reduced-motion: reduce) {\n  .job-fill { transition: none; }\n}\n\n/* The indeterminate band: a job that has not said how big it is (total 0, the\n   host's \"no idea yet\") or one that never will (a publish, a pull). A quarter\n   of the bar sweeps left to right on the family's motion token; the count is\n   hidden by the view. Under reduced motion the token is `none`, and the band\n   would otherwise sit still at a quarter and read as stuck, so it becomes a\n   full, translucent bar: \"busy\", said without movement. */\n.job-strip.indeterminate .job-fill {\n  width: 25%;\n  transition: none;\n  animation: var(--anim-job-band, none);\n}\n@keyframes job-band {\n  from { transform: translateX(-100%); }\n  to { transform: translateX(400%); }\n}\n@media (prefers-reduced-motion: reduce) {\n  .job-strip.indeterminate .job-fill { width: 100%; opacity: 0.35; }\n}\n\n.job-count,\n.job-time {\n  flex: none;\n  font-variant-numeric: tabular-nums;\n}\n.job-count[hidden],\n.job-cancel[hidden] { display: none; }\n.job-time { opacity: 0.8; }\n\n.job-cancel {\n  flex: none;\n  font: inherit;\n  color: var(--muted);\n  background: none;\n  border: 1px solid var(--line);\n  border-radius: var(--radius-sm, 4px);\n  padding: 3px 10px;\n  cursor: pointer;\n}\n.job-cancel:hover:not(:disabled) { color: var(--danger); border-color: var(--danger); background: none; }\n.job-cancel:focus-visible { outline: 2px solid var(--accent); outline-offset: 1px; }\n.job-cancel:disabled { opacity: 0.6; cursor: default; }\n"],"mappings":";AAGA,CAAC;AACC,WAAS;AACT,eAAa;AACb,OAAK;AACL,WAAS,IAAI;AACb,iBAAe,IAAI,MAAM,IAAI,WAAW,EAAE,IAAI;AAC9C,cAAY,IAAI;AAChB,aAAW;AACX,SAAO,IAAI;AACb;AACA,CAVC,SAUS,CAAC;AAAU,WAAS;AAAM;AAEpC,CAAC;AAAY,QAAM;AAAM;AAEzB,CAAC;AACC,QAAM;AACN,aAAW;AACX,UAAQ;AACR,cAAY,IAAI,WAAW,EAAE,IAAI;AACjC,iBAAe,IAAI,aAAa,EAAE;AAClC,YAAU;AACZ;AACA,CAAC;AACC,WAAS;AACT,UAAQ;AACR,SAAO;AACP,cAAY,IAAI;AAChB,iBAAe,IAAI,aAAa,EAAE;AAClC,cAAY,MAAM,IAAI,WAAW,EAAE,OAAO;AAC5C;AACA,QAAO,wBAAyB;AAC9B,GATD;AASa,gBAAY;AAAM;AAChC;AAQA,CAxCC,SAwCS,CAAC,cAAc,CAlBxB;AAmBC,SAAO;AACP,cAAY;AACZ,aAAW,IAAI,eAAe,EAAE;AAClC;AACA,WAAW;AACT;AAAO,eAAW,WAAW;AAAQ;AACrC;AAAK,eAAW,WAAW;AAAO;AACpC;AACA,QAAO,wBAAyB;AAC9B,GAlDD,SAkDW,CAVD,cAUgB,CA5B1B;AA4BsC,WAAO;AAAM,aAAS;AAAM;AACnE;AAEA,CAAC;AACD,CAAC;AACC,QAAM;AACN,wBAAsB;AACxB;AACA,CALC,SAKS,CAAC;AACX,CAAC,UAAU,CAAC;AAAU,WAAS;AAAM;AACrC,CANC;AAMW,WAAS;AAAK;AAE1B,CAHC;AAIC,QAAM;AACN,QAAM;AACN,SAAO,IAAI;AACX,cAAY;AACZ,UAAQ,IAAI,MAAM,IAAI;AACtB,iBAAe,IAAI,WAAW,EAAE;AAChC,WAAS,IAAI;AACb,UAAQ;AACV;AACA,CAbC,UAaU,MAAM,KAAK;AAAa,SAAO,IAAI;AAAW,gBAAc,IAAI;AAAW,cAAY;AAAM;AACxG,CAdC,UAcU;AAAiB,WAAS,IAAI,MAAM,IAAI;AAAW,kBAAgB;AAAK;AACnF,CAfC,UAeU;AAAY,WAAS;AAAK,UAAQ;AAAS;","names":[]}

package/dist/keys.cjs

@@ -0,0 +1,155 @@
+'use strict';
+
+// src/keys.ts
+var override;
+function setKeyPlatform(platform) {
+  override = platform;
+}
+function keyPlatform() {
+  if (override) return override;
+  if (typeof navigator !== "undefined") {
+    const s = `${navigator.platform ?? ""} ${navigator.userAgent ?? ""}`;
+    if (/mac|iphone|ipad/i.test(s)) return "mac";
+    if (/win/i.test(s)) return "win";
+    if (s.trim()) return "linux";
+  }
+  const p = typeof process !== "undefined" ? process.platform : void 0;
+  return p === "darwin" ? "mac" : p === "win32" ? "win" : "linux";
+}
+var MAC_ORDER = ["ctrl", "alt", "shift", "mod"];
+var OTHER_ORDER = ["mod", "ctrl", "alt", "shift"];
+var MAC_MOD = { ctrl: "\u2303", alt: "\u2325", shift: "\u21E7", mod: "\u2318" };
+var OTHER_MOD = { ctrl: "Ctrl", alt: "Alt", shift: "Shift", mod: "Ctrl" };
+var MODIFIER_ALIASES = {
+  mod: "mod",
+  cmd: "mod",
+  command: "mod",
+  meta: "mod",
+  super: "mod",
+  ctrl: "ctrl",
+  control: "ctrl",
+  alt: "alt",
+  option: "alt",
+  opt: "alt",
+  shift: "shift"
+};
+var NAMED = {
+  enter: { mac: "\u21A9", other: "Enter" },
+  return: { mac: "\u21A9", other: "Enter" },
+  esc: { mac: "esc", other: "Esc" },
+  escape: { mac: "esc", other: "Esc" },
+  up: { mac: "\u2191", other: "Up" },
+  down: { mac: "\u2193", other: "Down" },
+  left: { mac: "\u2190", other: "Left" },
+  right: { mac: "\u2192", other: "Right" },
+  backspace: { mac: "\u232B", other: "Backspace" },
+  delete: { mac: "\u2326", other: "Del" },
+  del: { mac: "\u2326", other: "Del" },
+  tab: { mac: "\u21E5", other: "Tab" },
+  space: { mac: "Space", other: "Space" },
+  home: { mac: "\u2196", other: "Home" },
+  end: { mac: "\u2198", other: "End" },
+  pageup: { mac: "\u21DE", other: "PgUp" },
+  pagedown: { mac: "\u21DF", other: "PgDn" }
+};
+var PORTABLE_MODS = /* @__PURE__ */ new Set(["mod", "ctrl", "alt", "shift"]);
+function parse(combo) {
+  const parts = combo.split("+");
+  const mods = [];
+  let key;
+  for (let i = 0; i < parts.length; i++) {
+    const raw = parts[i] ?? "";
+    if (raw === "" && i > 0) {
+      key = "+";
+      continue;
+    }
+    const mod = MODIFIER_ALIASES[raw.toLowerCase()];
+    if (mod) {
+      if (!mods.includes(mod)) mods.push(mod);
+      continue;
+    }
+    key = raw;
+  }
+  return { mods, key };
+}
+function isKeyCombo(value) {
+  const plus = value.length > 2 && value.endsWith("++");
+  const parts = (plus ? value.slice(0, -2) : value).split("+");
+  let keys = plus ? 1 : 0;
+  for (const raw of parts) {
+    if (raw === "") return false;
+    const word = raw.toLowerCase();
+    if (PORTABLE_MODS.has(word)) continue;
+    if (raw.length === 1 || word in NAMED) {
+      keys++;
+      continue;
+    }
+    return false;
+  }
+  return keys === 1;
+}
+function keyLegend(key, mac) {
+  const named = NAMED[key.toLowerCase()];
+  if (named) return mac ? named.mac : named.other;
+  return key.length === 1 ? key.toUpperCase() : key;
+}
+function keyLabel(combo, platform = keyPlatform()) {
+  const mac = platform === "mac";
+  const { mods, key } = parse(combo);
+  const order = mac ? MAC_ORDER : OTHER_ORDER;
+  const words = order.filter((m) => mods.includes(m)).map((m) => (mac ? MAC_MOD : OTHER_MOD)[m]);
+  const seen = /* @__PURE__ */ new Set();
+  const modWords = words.filter((w) => seen.has(w) ? false : (seen.add(w), true));
+  const legend = key === void 0 ? [] : [keyLegend(key, mac)];
+  return mac ? [...modWords, ...legend].join("") : [...modWords, ...legend].join("+");
+}
+function keyLegends(combo, platform = keyPlatform()) {
+  if (platform === "mac") return [keyLabel(combo, platform)];
+  const { mods, key } = parse(combo);
+  const seen = /* @__PURE__ */ new Set();
+  const words = OTHER_ORDER.filter((m) => mods.includes(m)).map((m) => OTHER_MOD[m]).filter((w) => seen.has(w) ? false : (seen.add(w), true));
+  return key === void 0 ? words : [...words, keyLegend(key, false)];
+}
+function chip(legend) {
+  const k = document.createElement("kbd");
+  k.className = "shell-kbd";
+  k.textContent = legend;
+  return k;
+}
+function keyHint(combo, opts = {}) {
+  const platform = opts.platform ?? keyPlatform();
+  const legends = combo.trim().split(/\s+/).flatMap((c) => keyLegends(c, platform));
+  if (legends.length === 1) return chip(legends[0]);
+  const group = document.createElement("span");
+  group.className = "shell-keys";
+  for (const legend of legends) group.append(chip(legend));
+  return group;
+}
+function hintBar(items, opts = {}) {
+  const bar = document.createElement("div");
+  bar.className = "shell-hintbar";
+  for (const item of items) {
+    const hint = document.createElement("span");
+    hint.className = "shell-hint";
+    const label = document.createElement("span");
+    label.className = "shell-hint-label";
+    label.textContent = item.label;
+    hint.append(keyHint(item.keys, opts), label);
+    bar.append(hint);
+  }
+  return bar;
+}
+function tipWithKey(text, combo, platform = keyPlatform()) {
+  return `${text} (${keyLabel(combo, platform)})`;
+}
+
+exports.hintBar = hintBar;
+exports.isKeyCombo = isKeyCombo;
+exports.keyHint = keyHint;
+exports.keyLabel = keyLabel;
+exports.keyLegends = keyLegends;
+exports.keyPlatform = keyPlatform;
+exports.setKeyPlatform = setKeyPlatform;
+exports.tipWithKey = tipWithKey;
+//# sourceMappingURL=keys.cjs.map
+//# sourceMappingURL=keys.cjs.map

package/dist/keys.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/keys.ts"],"names":[],"mappings":"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","file":"keys.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// Keyboard hints, platform-true, from ONE helper.\n//\n// \"One casing rule, and platform-true key hints\" (design-language.md section\n// 4, 2026-09-16): a hint writes \"⌘\" on macOS and \"Ctrl\" elsewhere, and \"⌘\"\n// never appears in a hard-coded string. Before this module the family had four\n// notations for one idea (ui-review-2026-09, finding 26): a <kbd> here, \"(⌘1)\"\n// in a tooltip there, a platform fork in one label, and \"↑↓ move · ↵ jump ·\n// esc to close\" typed into a hint bar, which on Windows showed a Mac glyph.\n//\n// The input is the portable spelling every caller already knows from the menu\n// spine: \"Mod+1\", \"Mod+Shift+M\", \"Enter\", \"Esc\", \"Up\". The output is what the\n// platform writes: \"⌘1\" / \"⇧⌘M\" / \"↩\" / \"esc\" on a Mac, in Apple's modifier\n// order and with no joiner; \"Ctrl+1\" / \"Ctrl+Shift+M\" / \"Enter\" / \"Esc\"\n// everywhere else. A hint is DOM (`keyHint`, `hintBar`): a keycap element,\n// never a glyph string, and a tooltip gets its bracketed key from\n// `tipWithKey` so it is right on both platforms.\n// ---------------------------------------------------------------------------\n\nexport type KeyPlatform = \"mac\" | \"win\" | \"linux\";\n\nlet override: KeyPlatform | undefined;\n\n/** Pin the platform every helper here renders for (undefined = detect again).\n *  A seam for the tests and for a preview harness; an app leaves it unset. */\nexport function setKeyPlatform(platform?: KeyPlatform): void { override = platform; }\n\n/** The platform the hints render for: the override, else the browser's, else\n *  the process's, else \"linux\" (which draws the same as \"win\"). */\nexport function keyPlatform(): KeyPlatform {\n  if (override) return override;\n  if (typeof navigator !== \"undefined\") {\n    const s = `${navigator.platform ?? \"\"} ${navigator.userAgent ?? \"\"}`;\n    if (/mac|iphone|ipad/i.test(s)) return \"mac\";\n    if (/win/i.test(s)) return \"win\";\n    if (s.trim()) return \"linux\";\n  }\n  const p = typeof process !== \"undefined\" ? process.platform : undefined;\n  return p === \"darwin\" ? \"mac\" : p === \"win32\" ? \"win\" : \"linux\";\n}\n\n/** Canonical modifier words, in the order each platform writes them. Apple\n *  puts them ⌃ ⌥ ⇧ ⌘ before the key; Windows and Linux write Ctrl+Alt+Shift. */\ntype Modifier = \"ctrl\" | \"alt\" | \"shift\" | \"mod\";\nconst MAC_ORDER: Modifier[] = [\"ctrl\", \"alt\", \"shift\", \"mod\"];\nconst OTHER_ORDER: Modifier[] = [\"mod\", \"ctrl\", \"alt\", \"shift\"];\nconst MAC_MOD: Record<Modifier, string> = { ctrl: \"⌃\", alt: \"⌥\", shift: \"⇧\", mod: \"⌘\" };\nconst OTHER_MOD: Record<Modifier, string> = { ctrl: \"Ctrl\", alt: \"Alt\", shift: \"Shift\", mod: \"Ctrl\" };\n\nconst MODIFIER_ALIASES: Record<string, Modifier> = {\n  mod: \"mod\", cmd: \"mod\", command: \"mod\", meta: \"mod\", super: \"mod\",\n  ctrl: \"ctrl\", control: \"ctrl\",\n  alt: \"alt\", option: \"alt\", opt: \"alt\",\n  shift: \"shift\",\n};\n\n/** Named keys: the Mac legend and the spelled-out word the others use. */\nconst NAMED: Record<string, { mac: string; other: string }> = {\n  enter: { mac: \"↩\", other: \"Enter\" }, return: { mac: \"↩\", other: \"Enter\" },\n  esc: { mac: \"esc\", other: \"Esc\" }, escape: { mac: \"esc\", other: \"Esc\" },\n  up: { mac: \"↑\", other: \"Up\" }, down: { mac: \"↓\", other: \"Down\" },\n  left: { mac: \"←\", other: \"Left\" }, right: { mac: \"→\", other: \"Right\" },\n  backspace: { mac: \"⌫\", other: \"Backspace\" }, delete: { mac: \"⌦\", other: \"Del\" }, del: { mac: \"⌦\", other: \"Del\" },\n  tab: { mac: \"⇥\", other: \"Tab\" }, space: { mac: \"Space\", other: \"Space\" },\n  home: { mac: \"↖\", other: \"Home\" }, end: { mac: \"↘\", other: \"End\" },\n  pageup: { mac: \"⇞\", other: \"PgUp\" }, pagedown: { mac: \"⇟\", other: \"PgDn\" },\n};\n\ninterface Parsed { mods: Modifier[]; key: string | undefined }\n\n/** The portable modifier words, exactly: the spelling the menu spine uses. The\n *  aliases above (\"Cmd\", \"Option\") are tolerated by `parse` but they are not\n *  portable, which is what `isKeyCombo` keys on. */\nconst PORTABLE_MODS = new Set<string>([\"mod\", \"ctrl\", \"alt\", \"shift\"]);\n\n/** Split \"Mod+Shift+M\" into its modifiers and its key. A literal \"+\" key is\n *  written \"Mod++\" (the last empty part). Case is ignored on the words. */\nfunction parse(combo: string): Parsed {\n  const parts = combo.split(\"+\");\n  const mods: Modifier[] = [];\n  let key: string | undefined;\n  for (let i = 0; i < parts.length; i++) {\n    const raw = parts[i] ?? \"\";\n    if (raw === \"\" && i > 0) { key = \"+\"; continue; }\n    const mod = MODIFIER_ALIASES[raw.toLowerCase()];\n    if (mod) { if (!mods.includes(mod)) mods.push(mod); continue; }\n    key = raw;\n  }\n  return { mods, key };\n}\n\n/**\n * Whether `value` is a combo in the portable spelling (\"Mod+1\", \"Ctrl+Shift+M\",\n * \"Enter\", \"Mod++\") rather than a literal hint someone already wrote out\n * (\"Cmd+1\", \"⌘1\", \"F1 twice\"). The test is strict on purpose: only the words\n * `Mod`, `Ctrl`, `Alt` and `Shift` (any case) count as modifiers, and the one\n * key must be a single character or a named key. A place that took a literal\n * string before (the pane shell's `shortcutHint`) can then take a combo as\n * well without changing what any existing literal draws.\n */\nexport function isKeyCombo(value: string): boolean {\n  // \"Mod++\" is the plus key, as `parse` reads it: count it, then read the rest.\n  const plus = value.length > 2 && value.endsWith(\"++\");\n  const parts = (plus ? value.slice(0, -2) : value).split(\"+\");\n  let keys = plus ? 1 : 0;\n  for (const raw of parts) {\n    if (raw === \"\") return false;\n    const word = raw.toLowerCase();\n    if (PORTABLE_MODS.has(word)) continue;\n    if (raw.length === 1 || word in NAMED) { keys++; continue; }\n    return false;\n  }\n  return keys === 1;\n}\n\nfunction keyLegend(key: string, mac: boolean): string {\n  const named = NAMED[key.toLowerCase()];\n  if (named) return mac ? named.mac : named.other;\n  return key.length === 1 ? key.toUpperCase() : key;\n}\n\n/** The platform's spelling of a combo as one string: \"⇧⌘M\" on a Mac,\n *  \"Ctrl+Shift+M\" elsewhere. For a tooltip or a menu label; a visible hint in\n *  a window is `keyHint` (a keycap), not this. */\nexport function keyLabel(combo: string, platform: KeyPlatform = keyPlatform()): string {\n  const mac = platform === \"mac\";\n  const { mods, key } = parse(combo);\n  const order = mac ? MAC_ORDER : OTHER_ORDER;\n  const words = order.filter((m) => mods.includes(m)).map((m) => (mac ? MAC_MOD : OTHER_MOD)[m]);\n  // On Windows \"Mod\" and \"Ctrl\" are both Ctrl; say it once.\n  const seen = new Set<string>();\n  const modWords = words.filter((w) => (seen.has(w) ? false : (seen.add(w), true)));\n  const legend = key === undefined ? [] : [keyLegend(key, mac)];\n  return mac ? [...modWords, ...legend].join(\"\") : [...modWords, ...legend].join(\"+\");\n}\n\n/** The legends of a combo as the platform would draw them on keycaps: one\n *  entry on a Mac (Apple's glyph string is one legend), one per key elsewhere. */\nexport function keyLegends(combo: string, platform: KeyPlatform = keyPlatform()): string[] {\n  if (platform === \"mac\") return [keyLabel(combo, platform)];\n  const { mods, key } = parse(combo);\n  const seen = new Set<string>();\n  const words = OTHER_ORDER.filter((m) => mods.includes(m)).map((m) => OTHER_MOD[m])\n    .filter((w) => (seen.has(w) ? false : (seen.add(w), true)));\n  return key === undefined ? words : [...words, keyLegend(key, false)];\n}\n\nexport interface KeyHintOptions {\n  /** Render for this platform rather than the detected one. */\n  platform?: KeyPlatform;\n}\n\nfunction chip(legend: string): HTMLElement {\n  const k = document.createElement(\"kbd\");\n  k.className = \"shell-kbd\";\n  k.textContent = legend;\n  return k;\n}\n\n/**\n * A keycap for `combo`: `<kbd class=\"shell-kbd\">` (keys.css). On a Mac one\n * chip carrying the glyph string (\"⇧⌘M\"); elsewhere one chip per key\n * (\"Ctrl\" \"Shift\" \"M\") side by side in a `<span class=\"shell-keys\">`, with no\n * typed joiner: keycaps beside each other read as \"together\". `combo` may\n * also list ALTERNATIVES separated by spaces (\"Up Down\" for a move hint),\n * each drawn as its own keycap.\n */\nexport function keyHint(combo: string, opts: KeyHintOptions = {}): HTMLElement {\n  const platform = opts.platform ?? keyPlatform();\n  const legends = combo.trim().split(/\\s+/).flatMap((c) => keyLegends(c, platform));\n  if (legends.length === 1) return chip(legends[0]!);\n  const group = document.createElement(\"span\");\n  group.className = \"shell-keys\";\n  for (const legend of legends) group.append(chip(legend));\n  return group;\n}\n\nexport interface HintBarItem {\n  /** A combo, or space-separated alternatives (\"Up Down\"). */\n  keys: string;\n  /** What the key does, as a sentence-case fragment (\"Move\", \"Jump\"). */\n  label: string;\n}\n\n/**\n * The hint bar under a picker or a tool window (\"↑↓ move · ↵ jump · esc\n * close\" as it used to be typed): one `<div class=\"shell-hintbar\">` of\n * `<span class=\"shell-hint\">` items, each a keycap (`keyHint`) and a label,\n * spaced by CSS and separated by nothing typed at all.\n */\nexport function hintBar(items: HintBarItem[], opts: KeyHintOptions = {}): HTMLElement {\n  const bar = document.createElement(\"div\");\n  bar.className = \"shell-hintbar\";\n  for (const item of items) {\n    const hint = document.createElement(\"span\");\n    hint.className = \"shell-hint\";\n    const label = document.createElement(\"span\");\n    label.className = \"shell-hint-label\";\n    label.textContent = item.label;\n    hint.append(keyHint(item.keys, opts), label);\n    bar.append(hint);\n  }\n  return bar;\n}\n\n/** Tooltip text with its key in brackets, platform-true: `tipWithKey(\"Show\n *  scenes\", \"Mod+1\")` is \"Show scenes (⌘1)\" on a Mac and \"Show scenes\n *  (Ctrl+1)\" elsewhere. For `data-tip`; the pane shell calls it itself when\n *  `PaneSideConfig.shortcutHint` is a combo. */\nexport function tipWithKey(text: string, combo: string, platform: KeyPlatform = keyPlatform()): string {\n  return `${text} (${keyLabel(combo, platform)})`;\n}\n"]}

package/dist/keys.css

@@ -0,0 +1,41 @@
+/* src/keys.css */
+.shell-kbd {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 18px;
+  padding: 0 5px;
+  font: 500 11px/1.5 var(--font-ui);
+  letter-spacing: 0.01em;
+  color: var(--muted);
+  background: var(--surface);
+  border: 1px solid var(--line);
+  border-bottom-width: 2px;
+  border-radius: var(--radius-sm);
+  white-space: nowrap;
+  vertical-align: middle;
+}
+.shell-keys {
+  display: inline-flex;
+  align-items: center;
+  gap: 3px;
+  vertical-align: middle;
+}
+.shell-hintbar {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 4px 14px;
+  font: 11.5px/1.4 var(--font-ui);
+  color: var(--muted);
+}
+.shell-hint {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  white-space: nowrap;
+}
+.shell-hint-label {
+  color: var(--muted);
+}
+/*# sourceMappingURL=keys.css.map */

package/dist/keys.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/keys.css"],"sourcesContent":["/* ============================================================================\n   Keycaps and hint bars (keys.ts): `keyHint`, `hintBar`. On the chrome scale\n   (px off the 14px base, tokens.css). Reads the palette (--surface, --line,\n   --muted, --ink, --font-ui). The element `kbd` rule in controls.css is the\n   floor for a hand-written keycap; these are the shell's own.\n   ============================================================================ */\n\n/* One keycap. The UI face, not mono: Apple's modifier glyphs sit on the text\n   baseline in the UI face and float in most monos. A 2px bottom edge is the\n   whole of the \"key\" drawing; nothing else lifts or shades. */\n.shell-kbd {\n  display: inline-flex; align-items: center; justify-content: center;\n  min-width: 18px; padding: 0 5px;\n  font: 500 11px/1.5 var(--font-ui); letter-spacing: 0.01em;\n  color: var(--muted); background: var(--surface);\n  border: 1px solid var(--line); border-bottom-width: 2px; border-radius: var(--radius-sm);\n  white-space: nowrap; vertical-align: middle;\n}\n\n/* Several keycaps that mean \"together\" (Windows and Linux spell a chord as\n   one cap per key) or \"either\" (a move hint's up and down): side by side,\n   with a gap and no typed joiner. */\n.shell-keys { display: inline-flex; align-items: center; gap: 3px; vertical-align: middle; }\n\n/* The hint bar: items spaced by the row's gap, each a keycap then its label. */\n.shell-hintbar {\n  display: flex; flex-wrap: wrap; align-items: center; gap: 4px 14px;\n  font: 11.5px/1.4 var(--font-ui); color: var(--muted);\n}\n.shell-hint { display: inline-flex; align-items: center; gap: 5px; white-space: nowrap; }\n.shell-hint-label { color: var(--muted); }\n"],"mappings":";AAUA,CAAC;AACC,WAAS;AAAa,eAAa;AAAQ,mBAAiB;AAC5D,aAAW;AAAM,WAAS,EAAE;AAC5B,QAAM,IAAI,IAAI,CAAC,IAAI,IAAI;AAAY,kBAAgB;AACnD,SAAO,IAAI;AAAU,cAAY,IAAI;AACrC,UAAQ,IAAI,MAAM,IAAI;AAAS,uBAAqB;AAAK,iBAAe,IAAI;AAC5E,eAAa;AAAQ,kBAAgB;AACvC;AAKA,CAAC;AAAa,WAAS;AAAa,eAAa;AAAQ,OAAK;AAAK,kBAAgB;AAAQ;AAG3F,CAAC;AACC,WAAS;AAAM,aAAW;AAAM,eAAa;AAAQ,OAAK,IAAI;AAC9D,QAAM,MAAM,CAAC,IAAI,IAAI;AAAY,SAAO,IAAI;AAC9C;AACA,CAAC;AAAa,WAAS;AAAa,eAAa;AAAQ,OAAK;AAAK,eAAa;AAAQ;AACxF,CAAC;AAAmB,SAAO,IAAI;AAAU;","names":[]}

package/dist/keys.d.cts

@@ -0,0 +1,57 @@
+type KeyPlatform = "mac" | "win" | "linux";
+/** Pin the platform every helper here renders for (undefined = detect again).
+ *  A seam for the tests and for a preview harness; an app leaves it unset. */
+declare function setKeyPlatform(platform?: KeyPlatform): void;
+/** The platform the hints render for: the override, else the browser's, else
+ *  the process's, else "linux" (which draws the same as "win"). */
+declare function keyPlatform(): KeyPlatform;
+/**
+ * Whether `value` is a combo in the portable spelling ("Mod+1", "Ctrl+Shift+M",
+ * "Enter", "Mod++") rather than a literal hint someone already wrote out
+ * ("Cmd+1", "⌘1", "F1 twice"). The test is strict on purpose: only the words
+ * `Mod`, `Ctrl`, `Alt` and `Shift` (any case) count as modifiers, and the one
+ * key must be a single character or a named key. A place that took a literal
+ * string before (the pane shell's `shortcutHint`) can then take a combo as
+ * well without changing what any existing literal draws.
+ */
+declare function isKeyCombo(value: string): boolean;
+/** The platform's spelling of a combo as one string: "⇧⌘M" on a Mac,
+ *  "Ctrl+Shift+M" elsewhere. For a tooltip or a menu label; a visible hint in
+ *  a window is `keyHint` (a keycap), not this. */
+declare function keyLabel(combo: string, platform?: KeyPlatform): string;
+/** The legends of a combo as the platform would draw them on keycaps: one
+ *  entry on a Mac (Apple's glyph string is one legend), one per key elsewhere. */
+declare function keyLegends(combo: string, platform?: KeyPlatform): string[];
+interface KeyHintOptions {
+    /** Render for this platform rather than the detected one. */
+    platform?: KeyPlatform;
+}
+/**
+ * A keycap for `combo`: `<kbd class="shell-kbd">` (keys.css). On a Mac one
+ * chip carrying the glyph string ("⇧⌘M"); elsewhere one chip per key
+ * ("Ctrl" "Shift" "M") side by side in a `<span class="shell-keys">`, with no
+ * typed joiner: keycaps beside each other read as "together". `combo` may
+ * also list ALTERNATIVES separated by spaces ("Up Down" for a move hint),
+ * each drawn as its own keycap.
+ */
+declare function keyHint(combo: string, opts?: KeyHintOptions): HTMLElement;
+interface HintBarItem {
+    /** A combo, or space-separated alternatives ("Up Down"). */
+    keys: string;
+    /** What the key does, as a sentence-case fragment ("Move", "Jump"). */
+    label: string;
+}
+/**
+ * The hint bar under a picker or a tool window ("↑↓ move · ↵ jump · esc
+ * close" as it used to be typed): one `<div class="shell-hintbar">` of
+ * `<span class="shell-hint">` items, each a keycap (`keyHint`) and a label,
+ * spaced by CSS and separated by nothing typed at all.
+ */
+declare function hintBar(items: HintBarItem[], opts?: KeyHintOptions): HTMLElement;
+/** Tooltip text with its key in brackets, platform-true: `tipWithKey("Show
+ *  scenes", "Mod+1")` is "Show scenes (⌘1)" on a Mac and "Show scenes
+ *  (Ctrl+1)" elsewhere. For `data-tip`; the pane shell calls it itself when
+ *  `PaneSideConfig.shortcutHint` is a combo. */
+declare function tipWithKey(text: string, combo: string, platform?: KeyPlatform): string;
+
+export { type HintBarItem, type KeyHintOptions, type KeyPlatform, hintBar, isKeyCombo, keyHint, keyLabel, keyLegends, keyPlatform, setKeyPlatform, tipWithKey };

package/dist/keys.d.ts

@@ -0,0 +1,57 @@
+type KeyPlatform = "mac" | "win" | "linux";
+/** Pin the platform every helper here renders for (undefined = detect again).
+ *  A seam for the tests and for a preview harness; an app leaves it unset. */
+declare function setKeyPlatform(platform?: KeyPlatform): void;
+/** The platform the hints render for: the override, else the browser's, else
+ *  the process's, else "linux" (which draws the same as "win"). */
+declare function keyPlatform(): KeyPlatform;
+/**
+ * Whether `value` is a combo in the portable spelling ("Mod+1", "Ctrl+Shift+M",
+ * "Enter", "Mod++") rather than a literal hint someone already wrote out
+ * ("Cmd+1", "⌘1", "F1 twice"). The test is strict on purpose: only the words
+ * `Mod`, `Ctrl`, `Alt` and `Shift` (any case) count as modifiers, and the one
+ * key must be a single character or a named key. A place that took a literal
+ * string before (the pane shell's `shortcutHint`) can then take a combo as
+ * well without changing what any existing literal draws.
+ */
+declare function isKeyCombo(value: string): boolean;
+/** The platform's spelling of a combo as one string: "⇧⌘M" on a Mac,
+ *  "Ctrl+Shift+M" elsewhere. For a tooltip or a menu label; a visible hint in
+ *  a window is `keyHint` (a keycap), not this. */
+declare function keyLabel(combo: string, platform?: KeyPlatform): string;
+/** The legends of a combo as the platform would draw them on keycaps: one
+ *  entry on a Mac (Apple's glyph string is one legend), one per key elsewhere. */
+declare function keyLegends(combo: string, platform?: KeyPlatform): string[];
+interface KeyHintOptions {
+    /** Render for this platform rather than the detected one. */
+    platform?: KeyPlatform;
+}
+/**
+ * A keycap for `combo`: `<kbd class="shell-kbd">` (keys.css). On a Mac one
+ * chip carrying the glyph string ("⇧⌘M"); elsewhere one chip per key
+ * ("Ctrl" "Shift" "M") side by side in a `<span class="shell-keys">`, with no
+ * typed joiner: keycaps beside each other read as "together". `combo` may
+ * also list ALTERNATIVES separated by spaces ("Up Down" for a move hint),
+ * each drawn as its own keycap.
+ */
+declare function keyHint(combo: string, opts?: KeyHintOptions): HTMLElement;
+interface HintBarItem {
+    /** A combo, or space-separated alternatives ("Up Down"). */
+    keys: string;
+    /** What the key does, as a sentence-case fragment ("Move", "Jump"). */
+    label: string;
+}
+/**
+ * The hint bar under a picker or a tool window ("↑↓ move · ↵ jump · esc
+ * close" as it used to be typed): one `<div class="shell-hintbar">` of
+ * `<span class="shell-hint">` items, each a keycap (`keyHint`) and a label,
+ * spaced by CSS and separated by nothing typed at all.
+ */
+declare function hintBar(items: HintBarItem[], opts?: KeyHintOptions): HTMLElement;
+/** Tooltip text with its key in brackets, platform-true: `tipWithKey("Show
+ *  scenes", "Mod+1")` is "Show scenes (⌘1)" on a Mac and "Show scenes
+ *  (Ctrl+1)" elsewhere. For `data-tip`; the pane shell calls it itself when
+ *  `PaneSideConfig.shortcutHint` is a combo. */
+declare function tipWithKey(text: string, combo: string, platform?: KeyPlatform): string;
+
+export { type HintBarItem, type KeyHintOptions, type KeyPlatform, hintBar, isKeyCombo, keyHint, keyLabel, keyLegends, keyPlatform, setKeyPlatform, tipWithKey };

package/dist/keys.js

@@ -0,0 +1,3 @@
+export { hintBar, isKeyCombo, keyHint, keyLabel, keyLegends, keyPlatform, setKeyPlatform, tipWithKey } from './chunk-YWMSQFXX.js';
+//# sourceMappingURL=keys.js.map
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"keys.js"}