@gallerist/plugin-shortcuts 0.0.0-stage → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shafayet Ahmmed
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,124 @@
-# Temporary Holding Version
+# @gallerist/plugin-shortcuts
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Gallerist plugin — the viewer's **keyboard shortcuts** in a modal dialog, on **`?`**. It lists the
+keys that work in the viewer as it is laid out right now, and on a touch screen the gestures instead.
+
+Part of [Gallerist](https://github.com/shafayet9780/gallerist#readme) — a headless, framework-agnostic media viewer for grouped / nested galleries with image-space overlays and virtualized rendering.
+
+## Install
+
+```bash
+npm i @gallerist/plugin-shortcuts
+```
+
+## Usage
+
+```ts
+import { createViewer } from '@gallerist/core'
+import { shortcuts } from '@gallerist/plugin-shortcuts'
+import { thumbnails } from '@gallerist/plugin-thumbnails'
+import { view } from '@gallerist/plugin-view'
+import { mount } from '@gallerist/renderer-dom'
+import '@gallerist/theme-default/gallerist.css'
+
+const viewer = createViewer({
+  groups,
+  plugins: [
+    thumbnails(),
+    view(), // its popover gets a last row, "Keyboard shortcuts ?"
+    shortcuts({ shortcuts: [{ keys: ['N'], label: 'Add a note', gesture: 'Long press' }] }),
+  ],
+})
+mount(viewer, { preset: 'reviewer' })
+```
+
+Nothing joins the toolbar (it is crowded enough). The list opens:
+
+- on **`?`** while the viewer has focus (not while typing in a field in it, not with Ctrl, ⌘ or Alt);
+- from the [View menu](../plugin-view/README.md)'s last row, when both plugins are registered;
+- from the host: `shortcuts()` returns the plugin with `open(keys?)` and `close()`, for a help button
+  of your own (`open()` returns `false` when no viewer it is registered on is open). The instance
+  (named `shortcuts`, `ShortcutsInstance`) has the same `open()` / `close()`, `isOpen`, and `label`.
+
+`open()` with no argument shows the gestures on a coarse pointer (a phone, a tablet) and the keys
+otherwise; `open(true)` the keys, `open(false)` the gestures. `?` always shows the keys (a keyboard
+pressed it).
+
+## What it lists
+
+The list is built each time it opens, from what the viewer does then, so it never lists a key that
+does nothing:
+
+- **Move.** With items grouped (a stacked or index rail, or none): ←/→ move between groups, ↑/↓
+  within one, Home/End to the first / last group, 1–9 to an item in the group. A row rail
+  (`groupDisplay: 'flat'`, or `linear`) walks every item in order: ←/→ and Home/End only. So does a
+  collection where every group holds one item. A side rail (`groupAxis: 'vertical'`) turns the axes
+  (↑/↓ between groups). Right to left, ← moves forward, and the list shows → ← for previous / next.
+- **Zoom.** `+`, `−`, `0`: the renderer's keys, or [plugin-zoom](../plugin-zoom/README.md)'s stops
+  when it is registered. Only while the collection has an item that can zoom: an image, or with
+  plugin-zoom what its `zoomable` option accepts; the gestures leave out pinch and drag the same
+  way.
+- **Viewer.** F for fullscreen ([plugin-fullscreen](../plugin-fullscreen/README.md), where the
+  browser can fullscreen an element), T to show or hide the thumbnails (with a rail), E for the
+  group's items (a stacked rail), G for the grid, P and C for pins (C with `onPlace`), D (or its
+  `key`) to download, `?` for this list, Esc to close (an overlay viewer). A plugin's key shows only
+  while that plugin holds it: a later plugin that took the key hides it. The renderer reads its own
+  keys first (the arrows, Home/End, `+` `=` `-` `0`, `t`, and 1–9 while items are grouped), so a
+  plugin given one of them (`grid({ key: 't' })`) never gets it and shouldn't be: the list would
+  show it. `?` typed with AltGr (Ctrl + Alt on Windows) counts as `?`.
+- **Your own**, from `shortcuts`: `{ label, keys?, gesture?, section? }`. `keys` are drawn as key
+  caps; `section` names a built-in section (its title: `strings.move`, `zoom`, `viewer`) or a new one
+  after them; without it the entry joins Viewer. An entry with a `gesture` is listed with the
+  gestures; one without `keys` only there.
+
+**Gestures** (one list): swipe left or right for previous / next; swipe up for the next item in a
+group (grouped items only); pinch or double-tap to zoom; drag to move while zoomed; swipe down to
+close (an overlay viewer); then yours. A note under them says `?` lists the keys with a keyboard.
+
+## Options
+
+| Option | Default | |
+|---|---|---|
+| `shortcuts` | — | your own entries, as above |
+| `strings` | English | every label, for translation; defaults in `DEFAULT_SHORTCUTS_STRINGS`, key names (`home`, `end`, `esc`) included. `toClose` is the close button's text, with `{key}` where the Esc key cap goes (`'{key} to close'`; `'Fermer avec {key}'`) |
+
+## Keyboard, pointer and screen readers
+
+The dialog is `role="dialog"` with `aria-modal="true"`, named by its title ("Keyboard shortcuts", or
+"Gestures"). It sits in the viewer's root over a scrim that covers the viewer, and the rest of the
+viewer is `inert` while it shows (what was inert already stays so). Focus moves to the dialog, so a
+screen reader reads it, and **Tab** stays inside it: its close button, then the list, which takes
+focus so the arrow keys, Page Up/Down and Home/End scroll it when the viewer is too short to show it
+whole (it has no role or name of its own: the dialog's title is announced once) (the dialog keeps inside the viewer, an inline one included).
+Each section is a heading
+over a description list: what it does, then its keys.
+
+- **Escape** closes the list, and only the list: the viewer stays open. **`?`** closes it too.
+- The close button ("Esc to close"; an × named "Close" with the gestures), or a click or tap on the
+  scrim, closes it. Focus goes back where it was before it opened (the View tool, when opened from
+  its row). A press on the page outside the viewer closes it and leaves focus there.
+- No other key acts while it is open: a `window` listener in the capture phase takes every key
+  pressed in the viewer first, so the viewer doesn't move, zoom or close under it, and plugin-zoom's
+  keys don't reach the image.
+- It closes when the viewer closes, and when the plugin is disposed; if the renderer goes away with
+  it open, its listeners go at the next key or press.
+
+## Look
+
+A panel in `--gallerist-popover-bg` with a hairline border and `--gallerist-popover-shadow`, centred
+over the viewer on `--gallerist-scrim`, up to 720px wide: a header (keyboard glyph, title, Esc to
+close), then the sections side by side, Move widest, wrapping when there are more. Keys are key caps
+in the skin's surface and monospace face. At 600px wide or less it is a sheet from the bottom edge,
+one column. It fades in over `--gallerist-dur-exit`, and not at all under reduced motion; right to
+left it mirrors. Every skin and scheme gets the styles (`@gallerist/theme-default`, `base.css`).
+
+## Not in the CDN bundle
+
+`@gallerist/cdn` (the one-`<script>` build) doesn't include this plugin: it would take that bundle
+past its size budget. Install it from npm alongside the packages above.
+
+Full docs: the [monorepo README](https://github.com/shafayet9780/gallerist#readme) and [`docs/`](https://github.com/shafayet9780/gallerist/tree/main/docs).
+
+## License
+
+MIT © Shafayet Ahmmed

package/dist/index.cjs

@@ -0,0 +1,288 @@
+'use strict';
+
+var internal = require('@gallerist/core/internal');
+
+// src/index.ts
+var DEFAULT_SHORTCUTS_STRINGS = {
+  title: "Keyboard shortcuts",
+  gestures: "Gestures",
+  toClose: "{key} to close",
+  close: "Close",
+  move: "Move",
+  zoom: "Zoom",
+  viewer: "Viewer",
+  prevNext: "Previous / next",
+  prevNextGroup: "Previous / next group",
+  prevNextItem: "Previous / next in the group",
+  nextItem: "Next in the group",
+  firstLast: "First / last",
+  firstLastGroup: "First / last group",
+  jump: "Item in the group",
+  zoomIn: "Zoom in",
+  zoomOut: "Zoom out",
+  fit: "Fit to screen",
+  pan: "Move while zoomed",
+  fullscreen: "Fullscreen",
+  rail: "Thumbnails",
+  items: "Item list",
+  grid: "Grid",
+  pins: "Pins",
+  addPin: "Add a comment",
+  download: "Download",
+  help: "This list",
+  exit: "Close",
+  swipe: "Swipe left or right",
+  swipeUp: "Swipe up",
+  swipeDown: "Swipe down",
+  pinch: "Pinch, or double-tap",
+  drag: "Drag",
+  keysNote: "With a keyboard, ? lists its shortcuts.",
+  home: "Home",
+  end: "End",
+  esc: "Esc"
+};
+var KEYBOARD = '<svg class="gallerist-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><rect x="2" y="4" width="20" height="16" rx="2"/><path d="M6 8h.01M10 8h.01M14 8h.01M18 8h.01M8 12h.01M12 12h.01M16 12h.01M7 16h10"/></svg>';
+var X = '<svg class="gallerist-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M18 6 6 18M6 6l12 12"/></svg>';
+var TABBABLE = 'button:not([disabled]), [href], [tabindex]:not([tabindex="-1"])';
+var lists = 0;
+var el = (tag, className = "", text = "") => {
+  const node = document.createElement(tag);
+  if (className) node.className = className;
+  if (text) node.textContent = text;
+  return node;
+};
+var cap = (k) => k.length === 1 ? k.toUpperCase() : k;
+var chord = (e) => (e.ctrlKey || e.metaKey || e.altKey) && !e.getModifierState?.("AltGraph");
+function shortcuts(opts = {}) {
+  const t = { ...DEFAULT_SHORTCUTS_STRINGS, ...opts.strings };
+  const live = [];
+  const plugin = (viewer) => {
+    let anchor = null;
+    let scrim = null;
+    let back = null;
+    let inerted = [];
+    let unsub = null;
+    const id = `gallerist-shortcuts-${++lists}`;
+    const root = () => anchor?.closest(".gallerist") ?? null;
+    const coarse = () => !!window.matchMedia?.("(pointer: coarse)").matches;
+    const rows = (keys) => {
+      const r = root();
+      const plugins = internal.getInternals(viewer).getPlugins();
+      const map = {};
+      for (const p of plugins) Object.assign(map, p.keymap);
+      const named = (name) => plugins.find((p) => p.name === name);
+      const held = (name, k) => {
+        const own = named(name)?.keymap ?? {};
+        const key = k ?? Object.keys(own)[0];
+        return key && own[key] && map[key] === own[key] ? key : void 0;
+      };
+      const linear = r.hasAttribute("data-gallerist-linear");
+      const vertical = r.getAttribute("data-gallerist-axis") === "vertical";
+      const across = r.getAttribute("data-gallerist-dir") === "rtl" ? ["\u2192", "\u2190"] : ["\u2190", "\u2192"];
+      const along = ["\u2191", "\u2193"];
+      const grouped = !linear && viewer.getCollection().groups.some((g) => g.items.length > 1);
+      const overlay = r.getAttribute("data-gallerist-mode") === "overlay";
+      const rail = named("thumbnails")?.display;
+      const can = named("zoom")?.zoomable ?? ((i) => i.type === "image");
+      const zoom = viewer.getCollection().groups.some((g) => g.items.some((i) => can(i)));
+      let sections;
+      if (keys) {
+        const move = grouped ? [
+          [t.prevNextGroup, vertical ? along : across],
+          [t.prevNextItem, vertical ? across : along],
+          [t.firstLastGroup, [t.home, t.end]],
+          [t.jump, ["1\u20139"]]
+        ] : [
+          [t.prevNext, vertical ? along : across],
+          [t.firstLast, [t.home, t.end]]
+        ];
+        const fs = document.webkitFullscreenEnabled;
+        const tools = [
+          [t.fullscreen, document.fullscreenEnabled ?? fs ? held("fullscreen", "f") : void 0],
+          [t.rail, rail ? "t" : void 0],
+          [t.items, held("thumbnails", "e")],
+          [t.grid, held("grid")],
+          [t.pins, held("pins", "p")],
+          [t.addPin, held("pins", "c")],
+          [t.download, held("download")],
+          [t.help, "?"],
+          [t.exit, overlay ? t.esc : void 0]
+        ];
+        sections = [
+          [t.move, move],
+          [
+            t.zoom,
+            zoom ? [
+              [t.zoomIn, ["+"]],
+              [t.zoomOut, ["\u2212"]],
+              [t.fit, ["0"]]
+            ] : []
+          ],
+          [t.viewer, tools.flatMap(([label, k]) => k ? [[label, [cap(k)]]] : [])]
+        ];
+      } else {
+        sections = [
+          [
+            "",
+            [
+              [grouped ? t.prevNextGroup : t.prevNext, t.swipe],
+              ...grouped ? [[t.nextItem, t.swipeUp]] : [],
+              ...zoom ? [[t.zoom, t.pinch], [t.pan, t.drag]] : [],
+              ...overlay ? [[t.exit, t.swipeDown]] : []
+            ]
+          ]
+        ];
+      }
+      for (const x of opts.shortcuts ?? []) {
+        const what = keys ? x.keys : x.gesture;
+        if (!what?.length) continue;
+        const title = keys ? x.section ?? t.viewer : "";
+        let section = sections.find(([s]) => s === title);
+        if (!section) {
+          section = [title, []];
+          sections.push(section);
+        }
+        section[1].push([x.label, what]);
+      }
+      return sections.filter(([, list]) => list.length);
+    };
+    const close = (refocus = false) => {
+      if (!scrim) return;
+      scrim.remove();
+      scrim = null;
+      for (const node of inerted) node.removeAttribute("inert");
+      inerted = [];
+      window.removeEventListener("keydown", onKey, true);
+      document.removeEventListener("pointerdown", onPress, true);
+      if (refocus) (back?.isConnected ? back : root())?.focus({ preventScroll: true });
+      back = null;
+    };
+    const onKey = (e) => {
+      const r = root();
+      if (!scrim?.isConnected) return close();
+      if (!r || !e.composedPath().includes(r)) return;
+      e.stopPropagation();
+      if (e.key === "Escape" || e.key === "?" && !chord(e)) {
+        e.preventDefault();
+        close(true);
+      } else if (e.key === "Tab") {
+        const box = scrim.firstElementChild;
+        const list = [...box.querySelectorAll(TABBABLE)];
+        const active = r.getRootNode().activeElement;
+        const first = list[0];
+        const last = list[list.length - 1];
+        const to = e.shiftKey ? active === first || active === box ? last : null : active === last ? first : null;
+        if (!first || to) {
+          e.preventDefault();
+          to?.focus();
+        }
+      }
+    };
+    const onPress = (e) => {
+      if (!e.composedPath().includes(root())) close();
+    };
+    const open = (keys = !coarse()) => {
+      const r = root();
+      if (!r || !anchor?.isConnected || viewer.getState().phase !== "open") return false;
+      close();
+      back = r.getRootNode().activeElement;
+      const s = el("div", "gallerist-shortcuts-scrim");
+      const box = el("div", "gallerist-shortcuts");
+      box.setAttribute("role", "dialog");
+      box.setAttribute("aria-modal", "true");
+      box.setAttribute("aria-labelledby", id);
+      box.tabIndex = -1;
+      box.setAttribute("data-gallerist-list", keys ? "keys" : "gestures");
+      const head = el("div", "gallerist-shortcuts-head");
+      if (keys) head.innerHTML = KEYBOARD;
+      const title = head.appendChild(el("h2", "", keys ? t.title : t.gestures));
+      title.id = id;
+      const x = head.appendChild(el("button", "gallerist-shortcuts-close"));
+      x.type = "button";
+      if (keys) {
+        const [before, after] = t.toClose.split("{key}");
+        x.append(before, el("kbd", "", t.esc), after ?? "");
+      } else {
+        x.innerHTML = X;
+        x.setAttribute("aria-label", t.close);
+      }
+      x.addEventListener("click", () => close(true));
+      const body = el("div", "gallerist-shortcuts-body");
+      body.tabIndex = 0;
+      for (const [name, list] of rows(keys)) {
+        const section = body.appendChild(el("section"));
+        if (name) section.appendChild(el("h3", "", name));
+        const dl = section.appendChild(el("dl"));
+        for (const [label, what] of list) {
+          const row = dl.appendChild(el("div", "gallerist-shortcuts-row"));
+          row.appendChild(el("dt", "", label));
+          const dd = row.appendChild(el("dd"));
+          if (typeof what === "string") dd.textContent = what;
+          else for (const k of what) dd.appendChild(el("kbd", "", k));
+        }
+      }
+      box.append(head, body);
+      if (!keys) box.appendChild(el("p", "gallerist-shortcuts-note", t.keysNote));
+      s.appendChild(box);
+      s.addEventListener("mousedown", (e) => e.target === s && e.preventDefault());
+      s.addEventListener("click", (e) => e.target === s && close(true));
+      for (const node of r.children)
+        if (!node.hasAttribute("inert")) {
+          node.setAttribute("inert", "");
+          inerted.push(node);
+        }
+      r.appendChild(s);
+      scrim = s;
+      window.addEventListener("keydown", onKey, true);
+      document.addEventListener("pointerdown", onPress, true);
+      box.focus({ preventScroll: true });
+      return true;
+    };
+    const instance = {
+      name: "shortcuts",
+      get label() {
+        return coarse() ? t.gestures : t.title;
+      },
+      get isOpen() {
+        return !!scrim;
+      },
+      open,
+      close: () => close(true),
+      init() {
+        live.push(instance);
+        unsub = viewer.subscribe((st) => {
+          if (st.phase === "closing" || st.phase === "closed") close();
+        });
+      },
+      destroy() {
+        close();
+        unsub?.();
+        unsub = anchor = null;
+        const at = live.indexOf(instance);
+        if (at >= 0) live.splice(at, 1);
+      },
+      keymap: { "?": () => open(true) },
+      // a hidden node, to find the viewer's root by (marked off: a bar shows not for it)
+      regions: {
+        toolbar: () => {
+          anchor = el("span");
+          anchor.hidden = true;
+          anchor.setAttribute("data-gallerist-off", "");
+          return anchor;
+        }
+      }
+    };
+    return instance;
+  };
+  return Object.assign(plugin, {
+    open: (keys) => live.reduceRight((done, i) => done || i.open(keys), false),
+    close: () => {
+      for (const i of live) i.close();
+    }
+  });
+}
+
+exports.DEFAULT_SHORTCUTS_STRINGS = DEFAULT_SHORTCUTS_STRINGS;
+exports.shortcuts = shortcuts;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["getInternals"],"mappings":"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","file":"index.cjs","sourcesContent":["// @gallerist/plugin-shortcuts — the viewer's keyboard shortcuts in a modal dialog, on `?`.\n//\n// The list is built each time it opens, from what the viewer does then: the renderer's own keys as\n// the layout has them (a row rail walks every item with ←/→ and has no ↑/↓; a side rail turns the\n// axes; right to left mirrors ←/→), the official plugins' keys while they are registered and hold\n// them (the aggregated keymap, so a key another plugin took isn't listed), and the host's entries.\n// Opened by a touch (the View menu's row, `open()`, on a coarse pointer) it lists the renderer's\n// gestures instead. `?` (with the viewer focused, not in a text field) opens the keys.\n//\n// The dialog sits in the viewer's root over a scrim that covers the viewer: `aria-modal`, the rest\n// of the root inert while it shows, Tab kept inside, focus back where it was on close. Keys pressed\n// in it never reach the viewer (a window listener in the capture phase takes them first): Escape and\n// `?` close it, and nothing else acts. The root is found from a hidden node in the toolbar region.\n\nimport type { Item, Plugin, PluginInstance, ViewerApi } from '@gallerist/core'\nimport { getInternals } from '@gallerist/core/internal'\n\n/** A host's own shortcut, listed with the built-in ones. */\nexport interface ShortcutEntry {\n  /** what it does */\n  label: string\n  /** the keys, each drawn as a key cap (`['N']`, `['Shift', 'N']`); without them it's listed only\n   *  with the gestures */\n  keys?: readonly string[]\n  /** the gesture that does it on a touch screen (`'Long press'`); without one it's listed only with\n   *  the keys */\n  gesture?: string\n  /** the section it joins: a built-in one by its title (`strings.move`, `zoom`, `viewer`) or a new\n   *  one after them. Default: the Viewer section. */\n  section?: string\n}\n\nexport interface ShortcutsStrings {\n  /** the dialog's title with the keys, and the View menu's row */\n  title: string\n  /** the dialog's title with the gestures (and the View menu's row on a touch screen) */\n  gestures: string\n  /** the close button's text, `{key}` where the Esc key cap goes (\"{key} to close\") */\n  toClose: string\n  close: string\n  /** section titles */\n  move: string\n  zoom: string\n  viewer: string\n  /** moving */\n  prevNext: string\n  prevNextGroup: string\n  prevNextItem: string\n  nextItem: string\n  firstLast: string\n  firstLastGroup: string\n  jump: string\n  /** zooming */\n  zoomIn: string\n  zoomOut: string\n  fit: string\n  pan: string\n  /** the viewer, and the plugins' keys */\n  fullscreen: string\n  rail: string\n  items: string\n  grid: string\n  pins: string\n  addPin: string\n  download: string\n  help: string\n  exit: string\n  /** gestures */\n  swipe: string\n  swipeUp: string\n  swipeDown: string\n  pinch: string\n  drag: string\n  /** under the gestures */\n  keysNote: string\n  /** key names on their caps */\n  home: string\n  end: string\n  esc: string\n}\n\nexport const DEFAULT_SHORTCUTS_STRINGS: ShortcutsStrings = {\n  title: 'Keyboard shortcuts',\n  gestures: 'Gestures',\n  toClose: '{key} to close',\n  close: 'Close',\n  move: 'Move',\n  zoom: 'Zoom',\n  viewer: 'Viewer',\n  prevNext: 'Previous / next',\n  prevNextGroup: 'Previous / next group',\n  prevNextItem: 'Previous / next in the group',\n  nextItem: 'Next in the group',\n  firstLast: 'First / last',\n  firstLastGroup: 'First / last group',\n  jump: 'Item in the group',\n  zoomIn: 'Zoom in',\n  zoomOut: 'Zoom out',\n  fit: 'Fit to screen',\n  pan: 'Move while zoomed',\n  fullscreen: 'Fullscreen',\n  rail: 'Thumbnails',\n  items: 'Item list',\n  grid: 'Grid',\n  pins: 'Pins',\n  addPin: 'Add a comment',\n  download: 'Download',\n  help: 'This list',\n  exit: 'Close',\n  swipe: 'Swipe left or right',\n  swipeUp: 'Swipe up',\n  swipeDown: 'Swipe down',\n  pinch: 'Pinch, or double-tap',\n  drag: 'Drag',\n  keysNote: 'With a keyboard, ? lists its shortcuts.',\n  home: 'Home',\n  end: 'End',\n  esc: 'Esc',\n}\n\nexport interface ShortcutsOptions {\n  /** the host's own shortcuts, listed after the built-in ones */\n  shortcuts?: readonly ShortcutEntry[]\n  /** UI text overrides, for translation; merged over English. */\n  strings?: Partial<ShortcutsStrings>\n}\n\n/** The plugin's instance on a viewer (named `shortcuts`); the View menu finds it by that name. */\nexport interface ShortcutsInstance extends PluginInstance {\n  /** what `open()` shows now: the title of the keys, or of the gestures on a coarse pointer */\n  readonly label: string\n  readonly isOpen: boolean\n  /** Opens the list on the open viewer: the keys (`true`), the gestures (`false`), or by the\n   *  pointer (default). False when there is no open viewer to show it in. */\n  open(keys?: boolean): boolean\n  close(): void\n}\n\n/** `shortcuts()`: a plugin, with `open()` / `close()` for the host (a help button of its own). */\nexport interface ShortcutsPlugin extends Plugin {\n  /** Opens the list on the viewer this plugin was last registered on that is open. */\n  open(keys?: boolean): boolean\n  close(): void\n}\n\ntype Row = [label: string, keys: readonly string[] | string]\n\nconst KEYBOARD =\n  '<svg class=\"gallerist-icon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.75\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\" focusable=\"false\"><rect x=\"2\" y=\"4\" width=\"20\" height=\"16\" rx=\"2\"/><path d=\"M6 8h.01M10 8h.01M14 8h.01M18 8h.01M8 12h.01M12 12h.01M16 12h.01M7 16h10\"/></svg>'\nconst X =\n  '<svg class=\"gallerist-icon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\" focusable=\"false\"><path d=\"M18 6 6 18M6 6l12 12\"/></svg>'\nconst TABBABLE = 'button:not([disabled]), [href], [tabindex]:not([tabindex=\"-1\"])'\n\nlet lists = 0 // ids, for aria-labelledby\n\nconst el = <K extends keyof HTMLElementTagNameMap>(\n  tag: K,\n  className = '',\n  text = '',\n): HTMLElementTagNameMap[K] => {\n  const node = document.createElement(tag)\n  if (className) node.className = className\n  if (text) node.textContent = text\n  return node\n}\nconst cap = (k: string) => (k.length === 1 ? k.toUpperCase() : k)\n// `?` typed with AltGr (Ctrl + Alt on Windows) is still `?`; another chord is the browser's\nconst chord = (e: KeyboardEvent) =>\n  (e.ctrlKey || e.metaKey || e.altKey) && !e.getModifierState?.('AltGraph')\n\nexport function shortcuts(opts: ShortcutsOptions = {}): ShortcutsPlugin {\n  const t: ShortcutsStrings = { ...DEFAULT_SHORTCUTS_STRINGS, ...opts.strings }\n  const live: ShortcutsInstance[] = [] // registered instances, the latest last\n\n  const plugin = (viewer: ViewerApi): ShortcutsInstance => {\n    let anchor: HTMLElement | null = null\n    let scrim: HTMLElement | null = null\n    let back: HTMLElement | null = null // focus before it opened\n    let inerted: Element[] = []\n    let unsub: (() => void) | null = null\n    const id = `gallerist-shortcuts-${++lists}`\n    const root = () => anchor?.closest<HTMLElement>('.gallerist') ?? null\n    const coarse = () => !!window.matchMedia?.('(pointer: coarse)').matches\n\n    // What the viewer does now, read from its root and its plugins.\n    const rows = (keys: boolean): Array<[string, Row[]]> => {\n      const r = root() as HTMLElement\n      const plugins = getInternals(viewer).getPlugins()\n      const map: Record<string, unknown> = {}\n      for (const p of plugins) Object.assign(map, p.keymap)\n      const named = (name: string) => plugins.find((p) => p.name === name)\n      // the key `k` of the plugin `name`, while it holds it (none: its first key)\n      const held = (name: string, k?: string) => {\n        const own = named(name)?.keymap ?? {}\n        const key = k ?? Object.keys(own)[0]\n        return key && own[key] && map[key] === own[key] ? key : undefined\n      }\n      const linear = r.hasAttribute('data-gallerist-linear')\n      const vertical = r.getAttribute('data-gallerist-axis') === 'vertical'\n      const across = r.getAttribute('data-gallerist-dir') === 'rtl' ? ['→', '←'] : ['←', '→']\n      const along = ['↑', '↓']\n      const grouped = !linear && viewer.getCollection().groups.some((g) => g.items.length > 1)\n      const overlay = r.getAttribute('data-gallerist-mode') === 'overlay'\n      const rail = (named('thumbnails') as { display?: string } | undefined)?.display\n\n      // zooming, while an item can zoom: plugin-zoom's `zoomable`, else an image\n      const can =\n        (named('zoom') as { zoomable?: (item: Item) => boolean } | undefined)?.zoomable ??\n        ((i: Item) => i.type === 'image')\n      const zoom = viewer.getCollection().groups.some((g) => g.items.some((i) => can(i)))\n      let sections: Array<[string, Row[]]>\n      if (keys) {\n        const move: Row[] = grouped\n          ? [\n              [t.prevNextGroup, vertical ? along : across],\n              [t.prevNextItem, vertical ? across : along],\n              [t.firstLastGroup, [t.home, t.end]],\n              [t.jump, ['1–9']],\n            ]\n          : [\n              [t.prevNext, vertical ? along : across],\n              [t.firstLast, [t.home, t.end]],\n            ]\n        const fs = (document as { webkitFullscreenEnabled?: boolean }).webkitFullscreenEnabled\n        const tools: Array<[string, string | undefined]> = [\n          [t.fullscreen, (document.fullscreenEnabled ?? fs) ? held('fullscreen', 'f') : undefined],\n          [t.rail, rail ? 't' : undefined],\n          [t.items, held('thumbnails', 'e')],\n          [t.grid, held('grid')],\n          [t.pins, held('pins', 'p')],\n          [t.addPin, held('pins', 'c')],\n          [t.download, held('download')],\n          [t.help, '?'],\n          [t.exit, overlay ? t.esc : undefined],\n        ]\n        sections = [\n          [t.move, move],\n          [\n            t.zoom,\n            zoom\n              ? [\n                  [t.zoomIn, ['+']],\n                  [t.zoomOut, ['−']],\n                  [t.fit, ['0']],\n                ]\n              : [],\n          ],\n          [t.viewer, tools.flatMap(([label, k]) => (k ? [[label, [cap(k)]] as Row] : []))],\n        ]\n      } else {\n        sections = [\n          [\n            '',\n            [\n              [grouped ? t.prevNextGroup : t.prevNext, t.swipe],\n              ...(grouped ? [[t.nextItem, t.swipeUp] as Row] : []),\n              ...(zoom ? [[t.zoom, t.pinch] as Row, [t.pan, t.drag] as Row] : []),\n              ...(overlay ? [[t.exit, t.swipeDown] as Row] : []),\n            ],\n          ],\n        ]\n      }\n      for (const x of opts.shortcuts ?? []) {\n        const what = keys ? x.keys : x.gesture\n        if (!what?.length) continue\n        const title = keys ? (x.section ?? t.viewer) : ''\n        let section = sections.find(([s]) => s === title)\n        if (!section) {\n          section = [title, []]\n          sections.push(section)\n        }\n        section[1].push([x.label, what])\n      }\n      return sections.filter(([, list]) => list.length)\n    }\n\n    const close = (refocus = false) => {\n      if (!scrim) return\n      scrim.remove()\n      scrim = null\n      for (const node of inerted) node.removeAttribute('inert')\n      inerted = []\n      window.removeEventListener('keydown', onKey, true)\n      document.removeEventListener('pointerdown', onPress, true)\n      if (refocus) (back?.isConnected ? back : root())?.focus({ preventScroll: true })\n      back = null\n    }\n\n    // Every key pressed in the viewer while the list shows stops here: the viewer's keys, the zoom\n    // tool's and the page's never see it. Escape and ? close; Tab stays in the dialog.\n    const onKey = (e: KeyboardEvent) => {\n      const r = root()\n      if (!scrim?.isConnected) return close() // the viewer went away with it open\n      if (!r || !e.composedPath().includes(r)) return\n      e.stopPropagation()\n      if (e.key === 'Escape' || (e.key === '?' && !chord(e))) {\n        e.preventDefault()\n        close(true)\n      } else if (e.key === 'Tab') {\n        const box = scrim.firstElementChild as HTMLElement\n        const list = [...box.querySelectorAll<HTMLElement>(TABBABLE)]\n        const active = (r.getRootNode() as Document | ShadowRoot).activeElement\n        const first = list[0]\n        const last = list[list.length - 1]\n        const to = e.shiftKey\n          ? active === first || active === box\n            ? last\n            : null\n          : active === last\n            ? first\n            : null\n        if (!first || to) {\n          e.preventDefault()\n          to?.focus()\n        }\n      }\n    }\n    // A press on the page outside the viewer closes it, leaving focus where the press puts it (a\n    // press on the scrim closes it too, with focus back where it was: see open()).\n    // (A viewer gone with it open is outside too: its listeners go with the next press or key.)\n    const onPress = (e: Event) => {\n      if (!e.composedPath().includes(root() as EventTarget)) close()\n    }\n\n    const open = (keys = !coarse()): boolean => {\n      const r = root()\n      if (!r || !anchor?.isConnected || viewer.getState().phase !== 'open') return false\n      close()\n      back = (r.getRootNode() as Document | ShadowRoot).activeElement as HTMLElement | null\n      const s = el('div', 'gallerist-shortcuts-scrim')\n      const box = el('div', 'gallerist-shortcuts')\n      box.setAttribute('role', 'dialog')\n      box.setAttribute('aria-modal', 'true')\n      box.setAttribute('aria-labelledby', id)\n      box.tabIndex = -1\n      box.setAttribute('data-gallerist-list', keys ? 'keys' : 'gestures')\n      const head = el('div', 'gallerist-shortcuts-head')\n      if (keys) head.innerHTML = KEYBOARD\n      const title = head.appendChild(el('h2', '', keys ? t.title : t.gestures))\n      title.id = id\n      const x = head.appendChild(el('button', 'gallerist-shortcuts-close'))\n      x.type = 'button'\n      if (keys) {\n        const [before, after] = t.toClose.split('{key}')\n        x.append(before as string, el('kbd', '', t.esc), after ?? '')\n      } else {\n        x.innerHTML = X\n        x.setAttribute('aria-label', t.close)\n      }\n      x.addEventListener('click', () => close(true))\n      // the list scrolls when the viewer is short: a stop for the keys, so they can scroll it (no\n      // role or name of its own: the dialog's title names it already, once)\n      const body = el('div', 'gallerist-shortcuts-body')\n      body.tabIndex = 0\n      for (const [name, list] of rows(keys)) {\n        const section = body.appendChild(el('section'))\n        if (name) section.appendChild(el('h3', '', name))\n        const dl = section.appendChild(el('dl'))\n        for (const [label, what] of list) {\n          const row = dl.appendChild(el('div', 'gallerist-shortcuts-row'))\n          row.appendChild(el('dt', '', label))\n          const dd = row.appendChild(el('dd'))\n          if (typeof what === 'string') dd.textContent = what\n          else for (const k of what) dd.appendChild(el('kbd', '', k))\n        }\n      }\n      box.append(head, body)\n      if (!keys) box.appendChild(el('p', 'gallerist-shortcuts-note', t.keysNote))\n      s.appendChild(box)\n      // the scrim takes no focus (the viewer's root would, under a press), and a click on it closes\n      s.addEventListener('mousedown', (e) => e.target === s && e.preventDefault())\n      s.addEventListener('click', (e) => e.target === s && close(true))\n      // the rest of the viewer is inert while the dialog shows (what was inert already stays so)\n      for (const node of r.children)\n        if (!node.hasAttribute('inert')) {\n          node.setAttribute('inert', '')\n          inerted.push(node)\n        }\n      r.appendChild(s)\n      scrim = s\n      window.addEventListener('keydown', onKey, true)\n      document.addEventListener('pointerdown', onPress, true)\n      box.focus({ preventScroll: true })\n      return true\n    }\n\n    const instance: ShortcutsInstance = {\n      name: 'shortcuts',\n      get label() {\n        return coarse() ? t.gestures : t.title\n      },\n      get isOpen() {\n        return !!scrim\n      },\n      open,\n      close: () => close(true),\n      init() {\n        live.push(instance)\n        unsub = viewer.subscribe((st) => {\n          if (st.phase === 'closing' || st.phase === 'closed') close()\n        })\n      },\n      destroy() {\n        close()\n        unsub?.()\n        unsub = anchor = null\n        const at = live.indexOf(instance)\n        if (at >= 0) live.splice(at, 1)\n      },\n      keymap: { '?': () => open(true) },\n      // a hidden node, to find the viewer's root by (marked off: a bar shows not for it)\n      regions: {\n        toolbar: () => {\n          anchor = el('span')\n          anchor.hidden = true\n          anchor.setAttribute('data-gallerist-off', '')\n          return anchor\n        },\n      },\n    }\n    return instance\n  }\n  return Object.assign(plugin, {\n    open: (keys?: boolean) => live.reduceRight((done, i) => done || i.open(keys), false),\n    close: () => {\n      for (const i of live) i.close()\n    },\n  })\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,90 @@
+import { PluginInstance, Plugin } from '@gallerist/core';
+
+/** A host's own shortcut, listed with the built-in ones. */
+interface ShortcutEntry {
+    /** what it does */
+    label: string;
+    /** the keys, each drawn as a key cap (`['N']`, `['Shift', 'N']`); without them it's listed only
+     *  with the gestures */
+    keys?: readonly string[];
+    /** the gesture that does it on a touch screen (`'Long press'`); without one it's listed only with
+     *  the keys */
+    gesture?: string;
+    /** the section it joins: a built-in one by its title (`strings.move`, `zoom`, `viewer`) or a new
+     *  one after them. Default: the Viewer section. */
+    section?: string;
+}
+interface ShortcutsStrings {
+    /** the dialog's title with the keys, and the View menu's row */
+    title: string;
+    /** the dialog's title with the gestures (and the View menu's row on a touch screen) */
+    gestures: string;
+    /** the close button's text, `{key}` where the Esc key cap goes ("{key} to close") */
+    toClose: string;
+    close: string;
+    /** section titles */
+    move: string;
+    zoom: string;
+    viewer: string;
+    /** moving */
+    prevNext: string;
+    prevNextGroup: string;
+    prevNextItem: string;
+    nextItem: string;
+    firstLast: string;
+    firstLastGroup: string;
+    jump: string;
+    /** zooming */
+    zoomIn: string;
+    zoomOut: string;
+    fit: string;
+    pan: string;
+    /** the viewer, and the plugins' keys */
+    fullscreen: string;
+    rail: string;
+    items: string;
+    grid: string;
+    pins: string;
+    addPin: string;
+    download: string;
+    help: string;
+    exit: string;
+    /** gestures */
+    swipe: string;
+    swipeUp: string;
+    swipeDown: string;
+    pinch: string;
+    drag: string;
+    /** under the gestures */
+    keysNote: string;
+    /** key names on their caps */
+    home: string;
+    end: string;
+    esc: string;
+}
+declare const DEFAULT_SHORTCUTS_STRINGS: ShortcutsStrings;
+interface ShortcutsOptions {
+    /** the host's own shortcuts, listed after the built-in ones */
+    shortcuts?: readonly ShortcutEntry[];
+    /** UI text overrides, for translation; merged over English. */
+    strings?: Partial<ShortcutsStrings>;
+}
+/** The plugin's instance on a viewer (named `shortcuts`); the View menu finds it by that name. */
+interface ShortcutsInstance extends PluginInstance {
+    /** what `open()` shows now: the title of the keys, or of the gestures on a coarse pointer */
+    readonly label: string;
+    readonly isOpen: boolean;
+    /** Opens the list on the open viewer: the keys (`true`), the gestures (`false`), or by the
+     *  pointer (default). False when there is no open viewer to show it in. */
+    open(keys?: boolean): boolean;
+    close(): void;
+}
+/** `shortcuts()`: a plugin, with `open()` / `close()` for the host (a help button of its own). */
+interface ShortcutsPlugin extends Plugin {
+    /** Opens the list on the viewer this plugin was last registered on that is open. */
+    open(keys?: boolean): boolean;
+    close(): void;
+}
+declare function shortcuts(opts?: ShortcutsOptions): ShortcutsPlugin;
+
+export { DEFAULT_SHORTCUTS_STRINGS, type ShortcutEntry, type ShortcutsInstance, type ShortcutsOptions, type ShortcutsPlugin, type ShortcutsStrings, shortcuts };

package/dist/index.d.ts

@@ -0,0 +1,90 @@
+import { PluginInstance, Plugin } from '@gallerist/core';
+
+/** A host's own shortcut, listed with the built-in ones. */
+interface ShortcutEntry {
+    /** what it does */
+    label: string;
+    /** the keys, each drawn as a key cap (`['N']`, `['Shift', 'N']`); without them it's listed only
+     *  with the gestures */
+    keys?: readonly string[];
+    /** the gesture that does it on a touch screen (`'Long press'`); without one it's listed only with
+     *  the keys */
+    gesture?: string;
+    /** the section it joins: a built-in one by its title (`strings.move`, `zoom`, `viewer`) or a new
+     *  one after them. Default: the Viewer section. */
+    section?: string;
+}
+interface ShortcutsStrings {
+    /** the dialog's title with the keys, and the View menu's row */
+    title: string;
+    /** the dialog's title with the gestures (and the View menu's row on a touch screen) */
+    gestures: string;
+    /** the close button's text, `{key}` where the Esc key cap goes ("{key} to close") */
+    toClose: string;
+    close: string;
+    /** section titles */
+    move: string;
+    zoom: string;
+    viewer: string;
+    /** moving */
+    prevNext: string;
+    prevNextGroup: string;
+    prevNextItem: string;
+    nextItem: string;
+    firstLast: string;
+    firstLastGroup: string;
+    jump: string;
+    /** zooming */
+    zoomIn: string;
+    zoomOut: string;
+    fit: string;
+    pan: string;
+    /** the viewer, and the plugins' keys */
+    fullscreen: string;
+    rail: string;
+    items: string;
+    grid: string;
+    pins: string;
+    addPin: string;
+    download: string;
+    help: string;
+    exit: string;
+    /** gestures */
+    swipe: string;
+    swipeUp: string;
+    swipeDown: string;
+    pinch: string;
+    drag: string;
+    /** under the gestures */
+    keysNote: string;
+    /** key names on their caps */
+    home: string;
+    end: string;
+    esc: string;
+}
+declare const DEFAULT_SHORTCUTS_STRINGS: ShortcutsStrings;
+interface ShortcutsOptions {
+    /** the host's own shortcuts, listed after the built-in ones */
+    shortcuts?: readonly ShortcutEntry[];
+    /** UI text overrides, for translation; merged over English. */
+    strings?: Partial<ShortcutsStrings>;
+}
+/** The plugin's instance on a viewer (named `shortcuts`); the View menu finds it by that name. */
+interface ShortcutsInstance extends PluginInstance {
+    /** what `open()` shows now: the title of the keys, or of the gestures on a coarse pointer */
+    readonly label: string;
+    readonly isOpen: boolean;
+    /** Opens the list on the open viewer: the keys (`true`), the gestures (`false`), or by the
+     *  pointer (default). False when there is no open viewer to show it in. */
+    open(keys?: boolean): boolean;
+    close(): void;
+}
+/** `shortcuts()`: a plugin, with `open()` / `close()` for the host (a help button of its own). */
+interface ShortcutsPlugin extends Plugin {
+    /** Opens the list on the viewer this plugin was last registered on that is open. */
+    open(keys?: boolean): boolean;
+    close(): void;
+}
+declare function shortcuts(opts?: ShortcutsOptions): ShortcutsPlugin;
+
+export { DEFAULT_SHORTCUTS_STRINGS, type ShortcutEntry, type ShortcutsInstance, type ShortcutsOptions, type ShortcutsPlugin, type ShortcutsStrings, shortcuts };

package/dist/index.js

@@ -0,0 +1,285 @@
+import { getInternals } from '@gallerist/core/internal';
+
+// src/index.ts
+var DEFAULT_SHORTCUTS_STRINGS = {
+  title: "Keyboard shortcuts",
+  gestures: "Gestures",
+  toClose: "{key} to close",
+  close: "Close",
+  move: "Move",
+  zoom: "Zoom",
+  viewer: "Viewer",
+  prevNext: "Previous / next",
+  prevNextGroup: "Previous / next group",
+  prevNextItem: "Previous / next in the group",
+  nextItem: "Next in the group",
+  firstLast: "First / last",
+  firstLastGroup: "First / last group",
+  jump: "Item in the group",
+  zoomIn: "Zoom in",
+  zoomOut: "Zoom out",
+  fit: "Fit to screen",
+  pan: "Move while zoomed",
+  fullscreen: "Fullscreen",
+  rail: "Thumbnails",
+  items: "Item list",
+  grid: "Grid",
+  pins: "Pins",
+  addPin: "Add a comment",
+  download: "Download",
+  help: "This list",
+  exit: "Close",
+  swipe: "Swipe left or right",
+  swipeUp: "Swipe up",
+  swipeDown: "Swipe down",
+  pinch: "Pinch, or double-tap",
+  drag: "Drag",
+  keysNote: "With a keyboard, ? lists its shortcuts.",
+  home: "Home",
+  end: "End",
+  esc: "Esc"
+};
+var KEYBOARD = '<svg class="gallerist-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><rect x="2" y="4" width="20" height="16" rx="2"/><path d="M6 8h.01M10 8h.01M14 8h.01M18 8h.01M8 12h.01M12 12h.01M16 12h.01M7 16h10"/></svg>';
+var X = '<svg class="gallerist-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M18 6 6 18M6 6l12 12"/></svg>';
+var TABBABLE = 'button:not([disabled]), [href], [tabindex]:not([tabindex="-1"])';
+var lists = 0;
+var el = (tag, className = "", text = "") => {
+  const node = document.createElement(tag);
+  if (className) node.className = className;
+  if (text) node.textContent = text;
+  return node;
+};
+var cap = (k) => k.length === 1 ? k.toUpperCase() : k;
+var chord = (e) => (e.ctrlKey || e.metaKey || e.altKey) && !e.getModifierState?.("AltGraph");
+function shortcuts(opts = {}) {
+  const t = { ...DEFAULT_SHORTCUTS_STRINGS, ...opts.strings };
+  const live = [];
+  const plugin = (viewer) => {
+    let anchor = null;
+    let scrim = null;
+    let back = null;
+    let inerted = [];
+    let unsub = null;
+    const id = `gallerist-shortcuts-${++lists}`;
+    const root = () => anchor?.closest(".gallerist") ?? null;
+    const coarse = () => !!window.matchMedia?.("(pointer: coarse)").matches;
+    const rows = (keys) => {
+      const r = root();
+      const plugins = getInternals(viewer).getPlugins();
+      const map = {};
+      for (const p of plugins) Object.assign(map, p.keymap);
+      const named = (name) => plugins.find((p) => p.name === name);
+      const held = (name, k) => {
+        const own = named(name)?.keymap ?? {};
+        const key = k ?? Object.keys(own)[0];
+        return key && own[key] && map[key] === own[key] ? key : void 0;
+      };
+      const linear = r.hasAttribute("data-gallerist-linear");
+      const vertical = r.getAttribute("data-gallerist-axis") === "vertical";
+      const across = r.getAttribute("data-gallerist-dir") === "rtl" ? ["\u2192", "\u2190"] : ["\u2190", "\u2192"];
+      const along = ["\u2191", "\u2193"];
+      const grouped = !linear && viewer.getCollection().groups.some((g) => g.items.length > 1);
+      const overlay = r.getAttribute("data-gallerist-mode") === "overlay";
+      const rail = named("thumbnails")?.display;
+      const can = named("zoom")?.zoomable ?? ((i) => i.type === "image");
+      const zoom = viewer.getCollection().groups.some((g) => g.items.some((i) => can(i)));
+      let sections;
+      if (keys) {
+        const move = grouped ? [
+          [t.prevNextGroup, vertical ? along : across],
+          [t.prevNextItem, vertical ? across : along],
+          [t.firstLastGroup, [t.home, t.end]],
+          [t.jump, ["1\u20139"]]
+        ] : [
+          [t.prevNext, vertical ? along : across],
+          [t.firstLast, [t.home, t.end]]
+        ];
+        const fs = document.webkitFullscreenEnabled;
+        const tools = [
+          [t.fullscreen, document.fullscreenEnabled ?? fs ? held("fullscreen", "f") : void 0],
+          [t.rail, rail ? "t" : void 0],
+          [t.items, held("thumbnails", "e")],
+          [t.grid, held("grid")],
+          [t.pins, held("pins", "p")],
+          [t.addPin, held("pins", "c")],
+          [t.download, held("download")],
+          [t.help, "?"],
+          [t.exit, overlay ? t.esc : void 0]
+        ];
+        sections = [
+          [t.move, move],
+          [
+            t.zoom,
+            zoom ? [
+              [t.zoomIn, ["+"]],
+              [t.zoomOut, ["\u2212"]],
+              [t.fit, ["0"]]
+            ] : []
+          ],
+          [t.viewer, tools.flatMap(([label, k]) => k ? [[label, [cap(k)]]] : [])]
+        ];
+      } else {
+        sections = [
+          [
+            "",
+            [
+              [grouped ? t.prevNextGroup : t.prevNext, t.swipe],
+              ...grouped ? [[t.nextItem, t.swipeUp]] : [],
+              ...zoom ? [[t.zoom, t.pinch], [t.pan, t.drag]] : [],
+              ...overlay ? [[t.exit, t.swipeDown]] : []
+            ]
+          ]
+        ];
+      }
+      for (const x of opts.shortcuts ?? []) {
+        const what = keys ? x.keys : x.gesture;
+        if (!what?.length) continue;
+        const title = keys ? x.section ?? t.viewer : "";
+        let section = sections.find(([s]) => s === title);
+        if (!section) {
+          section = [title, []];
+          sections.push(section);
+        }
+        section[1].push([x.label, what]);
+      }
+      return sections.filter(([, list]) => list.length);
+    };
+    const close = (refocus = false) => {
+      if (!scrim) return;
+      scrim.remove();
+      scrim = null;
+      for (const node of inerted) node.removeAttribute("inert");
+      inerted = [];
+      window.removeEventListener("keydown", onKey, true);
+      document.removeEventListener("pointerdown", onPress, true);
+      if (refocus) (back?.isConnected ? back : root())?.focus({ preventScroll: true });
+      back = null;
+    };
+    const onKey = (e) => {
+      const r = root();
+      if (!scrim?.isConnected) return close();
+      if (!r || !e.composedPath().includes(r)) return;
+      e.stopPropagation();
+      if (e.key === "Escape" || e.key === "?" && !chord(e)) {
+        e.preventDefault();
+        close(true);
+      } else if (e.key === "Tab") {
+        const box = scrim.firstElementChild;
+        const list = [...box.querySelectorAll(TABBABLE)];
+        const active = r.getRootNode().activeElement;
+        const first = list[0];
+        const last = list[list.length - 1];
+        const to = e.shiftKey ? active === first || active === box ? last : null : active === last ? first : null;
+        if (!first || to) {
+          e.preventDefault();
+          to?.focus();
+        }
+      }
+    };
+    const onPress = (e) => {
+      if (!e.composedPath().includes(root())) close();
+    };
+    const open = (keys = !coarse()) => {
+      const r = root();
+      if (!r || !anchor?.isConnected || viewer.getState().phase !== "open") return false;
+      close();
+      back = r.getRootNode().activeElement;
+      const s = el("div", "gallerist-shortcuts-scrim");
+      const box = el("div", "gallerist-shortcuts");
+      box.setAttribute("role", "dialog");
+      box.setAttribute("aria-modal", "true");
+      box.setAttribute("aria-labelledby", id);
+      box.tabIndex = -1;
+      box.setAttribute("data-gallerist-list", keys ? "keys" : "gestures");
+      const head = el("div", "gallerist-shortcuts-head");
+      if (keys) head.innerHTML = KEYBOARD;
+      const title = head.appendChild(el("h2", "", keys ? t.title : t.gestures));
+      title.id = id;
+      const x = head.appendChild(el("button", "gallerist-shortcuts-close"));
+      x.type = "button";
+      if (keys) {
+        const [before, after] = t.toClose.split("{key}");
+        x.append(before, el("kbd", "", t.esc), after ?? "");
+      } else {
+        x.innerHTML = X;
+        x.setAttribute("aria-label", t.close);
+      }
+      x.addEventListener("click", () => close(true));
+      const body = el("div", "gallerist-shortcuts-body");
+      body.tabIndex = 0;
+      for (const [name, list] of rows(keys)) {
+        const section = body.appendChild(el("section"));
+        if (name) section.appendChild(el("h3", "", name));
+        const dl = section.appendChild(el("dl"));
+        for (const [label, what] of list) {
+          const row = dl.appendChild(el("div", "gallerist-shortcuts-row"));
+          row.appendChild(el("dt", "", label));
+          const dd = row.appendChild(el("dd"));
+          if (typeof what === "string") dd.textContent = what;
+          else for (const k of what) dd.appendChild(el("kbd", "", k));
+        }
+      }
+      box.append(head, body);
+      if (!keys) box.appendChild(el("p", "gallerist-shortcuts-note", t.keysNote));
+      s.appendChild(box);
+      s.addEventListener("mousedown", (e) => e.target === s && e.preventDefault());
+      s.addEventListener("click", (e) => e.target === s && close(true));
+      for (const node of r.children)
+        if (!node.hasAttribute("inert")) {
+          node.setAttribute("inert", "");
+          inerted.push(node);
+        }
+      r.appendChild(s);
+      scrim = s;
+      window.addEventListener("keydown", onKey, true);
+      document.addEventListener("pointerdown", onPress, true);
+      box.focus({ preventScroll: true });
+      return true;
+    };
+    const instance = {
+      name: "shortcuts",
+      get label() {
+        return coarse() ? t.gestures : t.title;
+      },
+      get isOpen() {
+        return !!scrim;
+      },
+      open,
+      close: () => close(true),
+      init() {
+        live.push(instance);
+        unsub = viewer.subscribe((st) => {
+          if (st.phase === "closing" || st.phase === "closed") close();
+        });
+      },
+      destroy() {
+        close();
+        unsub?.();
+        unsub = anchor = null;
+        const at = live.indexOf(instance);
+        if (at >= 0) live.splice(at, 1);
+      },
+      keymap: { "?": () => open(true) },
+      // a hidden node, to find the viewer's root by (marked off: a bar shows not for it)
+      regions: {
+        toolbar: () => {
+          anchor = el("span");
+          anchor.hidden = true;
+          anchor.setAttribute("data-gallerist-off", "");
+          return anchor;
+        }
+      }
+    };
+    return instance;
+  };
+  return Object.assign(plugin, {
+    open: (keys) => live.reduceRight((done, i) => done || i.open(keys), false),
+    close: () => {
+      for (const i of live) i.close();
+    }
+  });
+}
+
+export { DEFAULT_SHORTCUTS_STRINGS, shortcuts };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// @gallerist/plugin-shortcuts — the viewer's keyboard shortcuts in a modal dialog, on `?`.\n//\n// The list is built each time it opens, from what the viewer does then: the renderer's own keys as\n// the layout has them (a row rail walks every item with ←/→ and has no ↑/↓; a side rail turns the\n// axes; right to left mirrors ←/→), the official plugins' keys while they are registered and hold\n// them (the aggregated keymap, so a key another plugin took isn't listed), and the host's entries.\n// Opened by a touch (the View menu's row, `open()`, on a coarse pointer) it lists the renderer's\n// gestures instead. `?` (with the viewer focused, not in a text field) opens the keys.\n//\n// The dialog sits in the viewer's root over a scrim that covers the viewer: `aria-modal`, the rest\n// of the root inert while it shows, Tab kept inside, focus back where it was on close. Keys pressed\n// in it never reach the viewer (a window listener in the capture phase takes them first): Escape and\n// `?` close it, and nothing else acts. The root is found from a hidden node in the toolbar region.\n\nimport type { Item, Plugin, PluginInstance, ViewerApi } from '@gallerist/core'\nimport { getInternals } from '@gallerist/core/internal'\n\n/** A host's own shortcut, listed with the built-in ones. */\nexport interface ShortcutEntry {\n  /** what it does */\n  label: string\n  /** the keys, each drawn as a key cap (`['N']`, `['Shift', 'N']`); without them it's listed only\n   *  with the gestures */\n  keys?: readonly string[]\n  /** the gesture that does it on a touch screen (`'Long press'`); without one it's listed only with\n   *  the keys */\n  gesture?: string\n  /** the section it joins: a built-in one by its title (`strings.move`, `zoom`, `viewer`) or a new\n   *  one after them. Default: the Viewer section. */\n  section?: string\n}\n\nexport interface ShortcutsStrings {\n  /** the dialog's title with the keys, and the View menu's row */\n  title: string\n  /** the dialog's title with the gestures (and the View menu's row on a touch screen) */\n  gestures: string\n  /** the close button's text, `{key}` where the Esc key cap goes (\"{key} to close\") */\n  toClose: string\n  close: string\n  /** section titles */\n  move: string\n  zoom: string\n  viewer: string\n  /** moving */\n  prevNext: string\n  prevNextGroup: string\n  prevNextItem: string\n  nextItem: string\n  firstLast: string\n  firstLastGroup: string\n  jump: string\n  /** zooming */\n  zoomIn: string\n  zoomOut: string\n  fit: string\n  pan: string\n  /** the viewer, and the plugins' keys */\n  fullscreen: string\n  rail: string\n  items: string\n  grid: string\n  pins: string\n  addPin: string\n  download: string\n  help: string\n  exit: string\n  /** gestures */\n  swipe: string\n  swipeUp: string\n  swipeDown: string\n  pinch: string\n  drag: string\n  /** under the gestures */\n  keysNote: string\n  /** key names on their caps */\n  home: string\n  end: string\n  esc: string\n}\n\nexport const DEFAULT_SHORTCUTS_STRINGS: ShortcutsStrings = {\n  title: 'Keyboard shortcuts',\n  gestures: 'Gestures',\n  toClose: '{key} to close',\n  close: 'Close',\n  move: 'Move',\n  zoom: 'Zoom',\n  viewer: 'Viewer',\n  prevNext: 'Previous / next',\n  prevNextGroup: 'Previous / next group',\n  prevNextItem: 'Previous / next in the group',\n  nextItem: 'Next in the group',\n  firstLast: 'First / last',\n  firstLastGroup: 'First / last group',\n  jump: 'Item in the group',\n  zoomIn: 'Zoom in',\n  zoomOut: 'Zoom out',\n  fit: 'Fit to screen',\n  pan: 'Move while zoomed',\n  fullscreen: 'Fullscreen',\n  rail: 'Thumbnails',\n  items: 'Item list',\n  grid: 'Grid',\n  pins: 'Pins',\n  addPin: 'Add a comment',\n  download: 'Download',\n  help: 'This list',\n  exit: 'Close',\n  swipe: 'Swipe left or right',\n  swipeUp: 'Swipe up',\n  swipeDown: 'Swipe down',\n  pinch: 'Pinch, or double-tap',\n  drag: 'Drag',\n  keysNote: 'With a keyboard, ? lists its shortcuts.',\n  home: 'Home',\n  end: 'End',\n  esc: 'Esc',\n}\n\nexport interface ShortcutsOptions {\n  /** the host's own shortcuts, listed after the built-in ones */\n  shortcuts?: readonly ShortcutEntry[]\n  /** UI text overrides, for translation; merged over English. */\n  strings?: Partial<ShortcutsStrings>\n}\n\n/** The plugin's instance on a viewer (named `shortcuts`); the View menu finds it by that name. */\nexport interface ShortcutsInstance extends PluginInstance {\n  /** what `open()` shows now: the title of the keys, or of the gestures on a coarse pointer */\n  readonly label: string\n  readonly isOpen: boolean\n  /** Opens the list on the open viewer: the keys (`true`), the gestures (`false`), or by the\n   *  pointer (default). False when there is no open viewer to show it in. */\n  open(keys?: boolean): boolean\n  close(): void\n}\n\n/** `shortcuts()`: a plugin, with `open()` / `close()` for the host (a help button of its own). */\nexport interface ShortcutsPlugin extends Plugin {\n  /** Opens the list on the viewer this plugin was last registered on that is open. */\n  open(keys?: boolean): boolean\n  close(): void\n}\n\ntype Row = [label: string, keys: readonly string[] | string]\n\nconst KEYBOARD =\n  '<svg class=\"gallerist-icon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.75\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\" focusable=\"false\"><rect x=\"2\" y=\"4\" width=\"20\" height=\"16\" rx=\"2\"/><path d=\"M6 8h.01M10 8h.01M14 8h.01M18 8h.01M8 12h.01M12 12h.01M16 12h.01M7 16h10\"/></svg>'\nconst X =\n  '<svg class=\"gallerist-icon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\" focusable=\"false\"><path d=\"M18 6 6 18M6 6l12 12\"/></svg>'\nconst TABBABLE = 'button:not([disabled]), [href], [tabindex]:not([tabindex=\"-1\"])'\n\nlet lists = 0 // ids, for aria-labelledby\n\nconst el = <K extends keyof HTMLElementTagNameMap>(\n  tag: K,\n  className = '',\n  text = '',\n): HTMLElementTagNameMap[K] => {\n  const node = document.createElement(tag)\n  if (className) node.className = className\n  if (text) node.textContent = text\n  return node\n}\nconst cap = (k: string) => (k.length === 1 ? k.toUpperCase() : k)\n// `?` typed with AltGr (Ctrl + Alt on Windows) is still `?`; another chord is the browser's\nconst chord = (e: KeyboardEvent) =>\n  (e.ctrlKey || e.metaKey || e.altKey) && !e.getModifierState?.('AltGraph')\n\nexport function shortcuts(opts: ShortcutsOptions = {}): ShortcutsPlugin {\n  const t: ShortcutsStrings = { ...DEFAULT_SHORTCUTS_STRINGS, ...opts.strings }\n  const live: ShortcutsInstance[] = [] // registered instances, the latest last\n\n  const plugin = (viewer: ViewerApi): ShortcutsInstance => {\n    let anchor: HTMLElement | null = null\n    let scrim: HTMLElement | null = null\n    let back: HTMLElement | null = null // focus before it opened\n    let inerted: Element[] = []\n    let unsub: (() => void) | null = null\n    const id = `gallerist-shortcuts-${++lists}`\n    const root = () => anchor?.closest<HTMLElement>('.gallerist') ?? null\n    const coarse = () => !!window.matchMedia?.('(pointer: coarse)').matches\n\n    // What the viewer does now, read from its root and its plugins.\n    const rows = (keys: boolean): Array<[string, Row[]]> => {\n      const r = root() as HTMLElement\n      const plugins = getInternals(viewer).getPlugins()\n      const map: Record<string, unknown> = {}\n      for (const p of plugins) Object.assign(map, p.keymap)\n      const named = (name: string) => plugins.find((p) => p.name === name)\n      // the key `k` of the plugin `name`, while it holds it (none: its first key)\n      const held = (name: string, k?: string) => {\n        const own = named(name)?.keymap ?? {}\n        const key = k ?? Object.keys(own)[0]\n        return key && own[key] && map[key] === own[key] ? key : undefined\n      }\n      const linear = r.hasAttribute('data-gallerist-linear')\n      const vertical = r.getAttribute('data-gallerist-axis') === 'vertical'\n      const across = r.getAttribute('data-gallerist-dir') === 'rtl' ? ['→', '←'] : ['←', '→']\n      const along = ['↑', '↓']\n      const grouped = !linear && viewer.getCollection().groups.some((g) => g.items.length > 1)\n      const overlay = r.getAttribute('data-gallerist-mode') === 'overlay'\n      const rail = (named('thumbnails') as { display?: string } | undefined)?.display\n\n      // zooming, while an item can zoom: plugin-zoom's `zoomable`, else an image\n      const can =\n        (named('zoom') as { zoomable?: (item: Item) => boolean } | undefined)?.zoomable ??\n        ((i: Item) => i.type === 'image')\n      const zoom = viewer.getCollection().groups.some((g) => g.items.some((i) => can(i)))\n      let sections: Array<[string, Row[]]>\n      if (keys) {\n        const move: Row[] = grouped\n          ? [\n              [t.prevNextGroup, vertical ? along : across],\n              [t.prevNextItem, vertical ? across : along],\n              [t.firstLastGroup, [t.home, t.end]],\n              [t.jump, ['1–9']],\n            ]\n          : [\n              [t.prevNext, vertical ? along : across],\n              [t.firstLast, [t.home, t.end]],\n            ]\n        const fs = (document as { webkitFullscreenEnabled?: boolean }).webkitFullscreenEnabled\n        const tools: Array<[string, string | undefined]> = [\n          [t.fullscreen, (document.fullscreenEnabled ?? fs) ? held('fullscreen', 'f') : undefined],\n          [t.rail, rail ? 't' : undefined],\n          [t.items, held('thumbnails', 'e')],\n          [t.grid, held('grid')],\n          [t.pins, held('pins', 'p')],\n          [t.addPin, held('pins', 'c')],\n          [t.download, held('download')],\n          [t.help, '?'],\n          [t.exit, overlay ? t.esc : undefined],\n        ]\n        sections = [\n          [t.move, move],\n          [\n            t.zoom,\n            zoom\n              ? [\n                  [t.zoomIn, ['+']],\n                  [t.zoomOut, ['−']],\n                  [t.fit, ['0']],\n                ]\n              : [],\n          ],\n          [t.viewer, tools.flatMap(([label, k]) => (k ? [[label, [cap(k)]] as Row] : []))],\n        ]\n      } else {\n        sections = [\n          [\n            '',\n            [\n              [grouped ? t.prevNextGroup : t.prevNext, t.swipe],\n              ...(grouped ? [[t.nextItem, t.swipeUp] as Row] : []),\n              ...(zoom ? [[t.zoom, t.pinch] as Row, [t.pan, t.drag] as Row] : []),\n              ...(overlay ? [[t.exit, t.swipeDown] as Row] : []),\n            ],\n          ],\n        ]\n      }\n      for (const x of opts.shortcuts ?? []) {\n        const what = keys ? x.keys : x.gesture\n        if (!what?.length) continue\n        const title = keys ? (x.section ?? t.viewer) : ''\n        let section = sections.find(([s]) => s === title)\n        if (!section) {\n          section = [title, []]\n          sections.push(section)\n        }\n        section[1].push([x.label, what])\n      }\n      return sections.filter(([, list]) => list.length)\n    }\n\n    const close = (refocus = false) => {\n      if (!scrim) return\n      scrim.remove()\n      scrim = null\n      for (const node of inerted) node.removeAttribute('inert')\n      inerted = []\n      window.removeEventListener('keydown', onKey, true)\n      document.removeEventListener('pointerdown', onPress, true)\n      if (refocus) (back?.isConnected ? back : root())?.focus({ preventScroll: true })\n      back = null\n    }\n\n    // Every key pressed in the viewer while the list shows stops here: the viewer's keys, the zoom\n    // tool's and the page's never see it. Escape and ? close; Tab stays in the dialog.\n    const onKey = (e: KeyboardEvent) => {\n      const r = root()\n      if (!scrim?.isConnected) return close() // the viewer went away with it open\n      if (!r || !e.composedPath().includes(r)) return\n      e.stopPropagation()\n      if (e.key === 'Escape' || (e.key === '?' && !chord(e))) {\n        e.preventDefault()\n        close(true)\n      } else if (e.key === 'Tab') {\n        const box = scrim.firstElementChild as HTMLElement\n        const list = [...box.querySelectorAll<HTMLElement>(TABBABLE)]\n        const active = (r.getRootNode() as Document | ShadowRoot).activeElement\n        const first = list[0]\n        const last = list[list.length - 1]\n        const to = e.shiftKey\n          ? active === first || active === box\n            ? last\n            : null\n          : active === last\n            ? first\n            : null\n        if (!first || to) {\n          e.preventDefault()\n          to?.focus()\n        }\n      }\n    }\n    // A press on the page outside the viewer closes it, leaving focus where the press puts it (a\n    // press on the scrim closes it too, with focus back where it was: see open()).\n    // (A viewer gone with it open is outside too: its listeners go with the next press or key.)\n    const onPress = (e: Event) => {\n      if (!e.composedPath().includes(root() as EventTarget)) close()\n    }\n\n    const open = (keys = !coarse()): boolean => {\n      const r = root()\n      if (!r || !anchor?.isConnected || viewer.getState().phase !== 'open') return false\n      close()\n      back = (r.getRootNode() as Document | ShadowRoot).activeElement as HTMLElement | null\n      const s = el('div', 'gallerist-shortcuts-scrim')\n      const box = el('div', 'gallerist-shortcuts')\n      box.setAttribute('role', 'dialog')\n      box.setAttribute('aria-modal', 'true')\n      box.setAttribute('aria-labelledby', id)\n      box.tabIndex = -1\n      box.setAttribute('data-gallerist-list', keys ? 'keys' : 'gestures')\n      const head = el('div', 'gallerist-shortcuts-head')\n      if (keys) head.innerHTML = KEYBOARD\n      const title = head.appendChild(el('h2', '', keys ? t.title : t.gestures))\n      title.id = id\n      const x = head.appendChild(el('button', 'gallerist-shortcuts-close'))\n      x.type = 'button'\n      if (keys) {\n        const [before, after] = t.toClose.split('{key}')\n        x.append(before as string, el('kbd', '', t.esc), after ?? '')\n      } else {\n        x.innerHTML = X\n        x.setAttribute('aria-label', t.close)\n      }\n      x.addEventListener('click', () => close(true))\n      // the list scrolls when the viewer is short: a stop for the keys, so they can scroll it (no\n      // role or name of its own: the dialog's title names it already, once)\n      const body = el('div', 'gallerist-shortcuts-body')\n      body.tabIndex = 0\n      for (const [name, list] of rows(keys)) {\n        const section = body.appendChild(el('section'))\n        if (name) section.appendChild(el('h3', '', name))\n        const dl = section.appendChild(el('dl'))\n        for (const [label, what] of list) {\n          const row = dl.appendChild(el('div', 'gallerist-shortcuts-row'))\n          row.appendChild(el('dt', '', label))\n          const dd = row.appendChild(el('dd'))\n          if (typeof what === 'string') dd.textContent = what\n          else for (const k of what) dd.appendChild(el('kbd', '', k))\n        }\n      }\n      box.append(head, body)\n      if (!keys) box.appendChild(el('p', 'gallerist-shortcuts-note', t.keysNote))\n      s.appendChild(box)\n      // the scrim takes no focus (the viewer's root would, under a press), and a click on it closes\n      s.addEventListener('mousedown', (e) => e.target === s && e.preventDefault())\n      s.addEventListener('click', (e) => e.target === s && close(true))\n      // the rest of the viewer is inert while the dialog shows (what was inert already stays so)\n      for (const node of r.children)\n        if (!node.hasAttribute('inert')) {\n          node.setAttribute('inert', '')\n          inerted.push(node)\n        }\n      r.appendChild(s)\n      scrim = s\n      window.addEventListener('keydown', onKey, true)\n      document.addEventListener('pointerdown', onPress, true)\n      box.focus({ preventScroll: true })\n      return true\n    }\n\n    const instance: ShortcutsInstance = {\n      name: 'shortcuts',\n      get label() {\n        return coarse() ? t.gestures : t.title\n      },\n      get isOpen() {\n        return !!scrim\n      },\n      open,\n      close: () => close(true),\n      init() {\n        live.push(instance)\n        unsub = viewer.subscribe((st) => {\n          if (st.phase === 'closing' || st.phase === 'closed') close()\n        })\n      },\n      destroy() {\n        close()\n        unsub?.()\n        unsub = anchor = null\n        const at = live.indexOf(instance)\n        if (at >= 0) live.splice(at, 1)\n      },\n      keymap: { '?': () => open(true) },\n      // a hidden node, to find the viewer's root by (marked off: a bar shows not for it)\n      regions: {\n        toolbar: () => {\n          anchor = el('span')\n          anchor.hidden = true\n          anchor.setAttribute('data-gallerist-off', '')\n          return anchor\n        },\n      },\n    }\n    return instance\n  }\n  return Object.assign(plugin, {\n    open: (keys?: boolean) => live.reduceRight((done, i) => done || i.open(keys), false),\n    close: () => {\n      for (const i of live) i.close()\n    },\n  })\n}\n"]}

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@gallerist/plugin-shortcuts",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.0",
+  "description": "Gallerist plugin — a keyboard shortcut list on ?: the keys that work in the viewer as it is laid out (and the gestures on a touch screen), with the host's own, in a modal dialog.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "peerDependencies": {
+    "@gallerist/core": ">=0.3.0 <1"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@gallerist/core": "0.4.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shafayet9780/gallerist.git",
+    "directory": "packages/plugin-shortcuts"
+  },
+  "homepage": "https://github.com/shafayet9780/gallerist#readme",
+  "bugs": {
+    "url": "https://github.com/shafayet9780/gallerist/issues"
+  },
+  "author": "Shafayet Ahmmed",
+  "keywords": [
+    "lightbox",
+    "gallery",
+    "image-viewer",
+    "media-viewer",
+    "photo-gallery",
+    "carousel",
+    "keyboard-shortcuts",
+    "accessibility",
+    "overlays",
+    "headless",
+    "framework-agnostic",
+    "virtualized",
+    "nested-gallery"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
 }