@wildwinter/app-shell 0.40.1 → 0.41.0

package/README.md

@@ -144,6 +144,43 @@ needing and never had.
   anywhere: "all is well" was being met with raw green literals that could not
   theme-shift.
 
+## v0.41 (the kit gallery)
+
+The new-thing moment (New Project, New Box, New Scene), drawn once: tiles on
+the left, the chosen kit said in full on the right, one screen, on the dialog
+frame. Shelves say what their button does, so a kit ("Create") and a worked
+example ("Open a Copy") can sit side by side.
+
+```ts
+import { openKitGallery } from "@wildwinter/app-shell";
+import "@wildwinter/app-shell/kit-gallery.css";
+
+openKitGallery({
+  title: "New project",
+  what: "A project is one game's worth of storylets.",
+  namePlaceholder: "The Village",
+  details: vcsFields,                       // the app's own fields, under the name
+  sections: [
+    { caption: "Start from a kit", items: [
+      { id: "starter", name: "Starter project", blurb: "Two cards that already work together.",
+        play: "Press Play: one card opens the next.", lands: ["One box", "Two cards"] },
+    ] },
+    { caption: "Learn from a finished project", action: "Open a Copy", usesDetails: false,
+      items: [{ id: "hamlet", name: "The Hamlet", blurb: "Small.", badge: "Start here" }] },
+  ],
+  onPick: (id, { name }) => { /* the app makes it */ },
+});
+```
+
+- **What a kit is made of stays in the app.** The shell knows names, words and
+  pictures, never boxes or scenes.
+- **Pictures are masks.** `image` is a transparent file whose opaque pixels are
+  the ink, drawn in `--kit-art-ink` on `--kit-art-plate`. A dark theme sets a
+  paper-toned plate and a dark ink rather than inverting, which turns an
+  engraving into a photographic negative.
+- Single click chooses, double-click chooses and goes, Enter in the name field
+  creates; the name is required when asked for.
+
 ## Roadmap
 
 Later slices lift the rest of the common shell from Patterpad (canonical),

package/dist/chunk-BZ3MQDWM.js

@@ -0,0 +1,153 @@
+import { dialogFrame } from './chunk-YRFJLJUH.js';
+import { el } from './chunk-UG2P777F.js';
+
+// src/kit-gallery.ts
+function openKitGallery(opts) {
+  const frame = dialogFrame({ title: opts.title, ...opts.what !== void 0 ? { sub: opts.what } : {}, className: "kit-gallery", ...opts.onClose ? { onClose: opts.onClose } : {} });
+  const { dialog } = frame;
+  const entries = opts.sections.flatMap((section, s) => section.items.map((item) => ({ item, section, s })));
+  if (entries.length === 0) throw new Error("openKitGallery: no items to choose from");
+  let chosen = entries.find((e) => e.item.id === opts.initial) ?? entries[0];
+  const nameInput = opts.namePlaceholder === void 0 ? void 0 : el("input", { className: "field kit-gallery-name" });
+  if (nameInput) {
+    nameInput.placeholder = opts.namePlaceholder;
+    nameInput.setAttribute("aria-label", opts.nameLabel ?? "Name");
+  }
+  const fields = el(
+    "div",
+    "kit-gallery-fields",
+    ...nameInput ? [el("label", "kit-gallery-label", opts.nameLabel ?? "Name"), nameInput] : [],
+    ...opts.details ? [opts.details] : []
+  );
+  const panelArt = el("div", "kit-gallery-art kit-gallery-panel-art");
+  const panelName = el("h3", "kit-gallery-panel-name");
+  const panelBlurb = el("p", "kit-gallery-panel-blurb");
+  const panelDetail = el("p", "kit-gallery-panel-detail");
+  const panelPlay = el("p", "kit-gallery-play");
+  const panelShows = el("p", "kit-gallery-shows");
+  const panelLands = el("ul", "kit-gallery-lands");
+  const panelLandsCaption = el("p", "kit-gallery-lands-caption", "What you get");
+  const panelNote = el("p", "kit-gallery-note");
+  const panel = el(
+    "div",
+    "kit-gallery-panel",
+    panelArt,
+    panelName,
+    panelBlurb,
+    panelDetail,
+    panelPlay,
+    panelShows,
+    panelLandsCaption,
+    panelLands,
+    panelNote,
+    fields
+  );
+  const primary = el("button", { className: "btn primary", onClick: () => commit() });
+  primary.type = "button";
+  const cancel = el("button", { className: "btn", text: "Cancel", onClick: () => frame.close() });
+  cancel.type = "button";
+  const setArt = (host, image) => {
+    host.replaceChildren();
+    host.hidden = image === void 0;
+    if (image === void 0) return;
+    const ink = el("span", "kit-gallery-ink");
+    ink.style.setProperty("--kit-art", `url("${image.replace(/"/g, "%22")}")`);
+    host.append(ink);
+  };
+  const setText = (node, text) => {
+    node.textContent = text ?? "";
+    node.hidden = text === void 0 || text === "";
+  };
+  const tiles = /* @__PURE__ */ new Map();
+  const shelves = opts.sections.map((section) => {
+    const grid = el("div", "kit-gallery-grid", ...section.items.map((item) => {
+      const art = el("div", "kit-gallery-art");
+      setArt(art, item.image);
+      const tile = el(
+        "button",
+        { className: "kit-gallery-tile", onClick: () => choose(item.id) },
+        art,
+        el(
+          "span",
+          "kit-gallery-tile-head",
+          el("span", "kit-gallery-tile-name", item.name),
+          item.badge !== void 0 ? el("span", "kit-gallery-badge", item.badge) : null
+        ),
+        el("span", "kit-gallery-tile-blurb", item.blurb)
+      );
+      tile.type = "button";
+      tile.dataset.kit = item.id;
+      tile.addEventListener("dblclick", () => {
+        choose(item.id);
+        commit();
+      });
+      tiles.set(item.id, tile);
+      return tile;
+    }));
+    return el(
+      "section",
+      "kit-gallery-shelf",
+      section.caption !== void 0 ? el("h3", "kit-gallery-caption", section.caption) : null,
+      section.note !== void 0 ? el("p", "kit-gallery-shelf-note", section.note) : null,
+      grid
+    );
+  });
+  const choose = (id) => {
+    const next = entries.find((e) => e.item.id === id);
+    if (!next) return;
+    chosen = next;
+    for (const [tid, tile] of tiles) tile.setAttribute("aria-pressed", String(tid === id));
+    const { item, section } = chosen;
+    setArt(panelArt, item.image);
+    panelName.textContent = item.name;
+    setText(panelBlurb, item.blurb);
+    setText(panelDetail, item.detail);
+    setText(panelPlay, item.play);
+    setText(panelShows, item.shows !== void 0 ? `Shows: ${item.shows}` : void 0);
+    panelLands.replaceChildren(...(item.lands ?? []).map((l) => el("li", void 0, l)));
+    panelLands.hidden = (item.lands ?? []).length === 0;
+    panelLandsCaption.hidden = panelLands.hidden;
+    const details = section.usesDetails !== false;
+    fields.hidden = !details || nameInput === void 0 && opts.details === void 0;
+    setText(panelNote, details ? void 0 : section.note);
+    primary.textContent = section.action ?? "Create";
+  };
+  const commit = () => {
+    const { item, section } = chosen;
+    const details = section.usesDetails !== false;
+    let name;
+    if (details && nameInput) {
+      name = nameInput.value.trim();
+      if (name === "") {
+        nameInput.focus();
+        nameInput.classList.add("kit-gallery-missing");
+        return;
+      }
+    }
+    frame.close();
+    opts.onPick(item.id, name !== void 0 ? { name } : {});
+  };
+  if (nameInput) {
+    nameInput.addEventListener("input", () => nameInput.classList.remove("kit-gallery-missing"));
+    nameInput.addEventListener("keydown", (e) => {
+      e.stopPropagation();
+      if (e.key !== "Enter") return;
+      e.preventDefault();
+      commit();
+    });
+  }
+  frame.body.append(el("div", "kit-gallery-layout", el("div", "kit-gallery-shelves", ...shelves), panel));
+  frame.actions.append(cancel, primary);
+  dialog.addEventListener("click", (e) => {
+    if (e.target === dialog) frame.close();
+  });
+  choose(chosen.item.id);
+  frame.open();
+  if (nameInput && chosen.section.usesDetails !== false) nameInput.focus();
+  else tiles.get(chosen.item.id)?.focus();
+  return { dialog, close: () => frame.close() };
+}
+
+export { openKitGallery };
+//# sourceMappingURL=chunk-BZ3MQDWM.js.map
+//# sourceMappingURL=chunk-BZ3MQDWM.js.map

package/dist/chunk-BZ3MQDWM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/kit-gallery.ts"],"names":[],"mappings":"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","file":"chunk-BZ3MQDWM.js","sourcesContent":["// ---------------------------------------------------------------------------\n// The kit gallery: pick a starting point by what you want to make.\n//\n// The new-thing moment for the family (New Project, New Box, New Scene), drawn\n// once. Adobe's New Document is the shape: tiles on the left, a details panel\n// on the right, one screen. Not a wizard: a wizard asks for settings before\n// anything has been chosen, and the choice is the part that teaches.\n//\n// Storyletter grew this as `kit-picker.ts` (one component at two scales on\n// <dialog>, \"a shell candidate, held back until it had been used in earnest\")\n// and the kit gallery brief moved it here, 2026-09-27\n// (storylet-studio/design/kit-gallery.md). What a kit IS made of stays in\n// each app: this file knows names, words and pictures, never boxes or scenes.\n//\n// Sections are shelves (\"Start from a kit\", \"Learn from a finished project\"),\n// and each says what its button does, because opening a copy of an example\n// and creating from a kit are different acts behind the same kind of tile.\n// The app's own fields (a project name, version control, a build path) sit in\n// the details panel, shown only for the sections that use them.\n// ---------------------------------------------------------------------------\n\nimport { el } from \"./dom.js\";\nimport { dialogFrame } from \"./dialog.js\";\n\nexport interface KitGalleryItem<T extends string> {\n  id: T;\n  /** What you are making, in the author's terms, not the model's. */\n  name: string;\n  /** What it is FOR: one line on the tile, and the panel's first line. */\n  blurb: string;\n  /** More, for the panel only. */\n  detail?: string;\n  /** What pressing Play (or Run) shows, said as a promise. */\n  play?: string;\n  /** The model's parts it puts to work, second and quieter (\"Shows: ...\"). */\n  shows?: string;\n  /** What lands, in the concrete, as a short list in the panel. */\n  lands?: string[];\n  /** A word or two on the tile (\"Start here\"). */\n  badge?: string;\n  /** An illustration: a transparent image whose opaque pixels are the ink.\n   *  Drawn as a mask in `--kit-art-ink` on `--kit-art-plate`, so one file\n   *  serves both themes and the app chooses the colours. */\n  image?: string;\n}\n\nexport interface KitGallerySection<T extends string> {\n  /** Sentence-case label text (\"Start from a kit\"). Absent: no caption. */\n  caption?: string;\n  /** The consequence of a click, said before the click. */\n  note?: string;\n  items: KitGalleryItem<T>[];\n  /** The primary button's label while an item here is chosen. Default \"Create\". */\n  action?: string;\n  /** Show the app's detail fields (and ask for the name) for this section.\n   *  Default true. An example is opened, not named, so its shelf says false. */\n  usesDetails?: boolean;\n}\n\nexport interface KitGalleryChoice {\n  /** Present when a name was asked for and the chosen section uses details. */\n  name?: string;\n}\n\nexport interface KitGalleryOptions<T extends string> {\n  /** The dialog's heading: \"New project\", \"New box\", \"New scene\". */\n  title: string;\n  /** What the thing being made IS, in concrete terms. */\n  what?: string;\n  sections: KitGallerySection<T>[];\n  /** Ask for a name in the details panel, with this placeholder. Required\n   *  when asked: making a thing without one would have to invent a folder. */\n  namePlaceholder?: string;\n  /** The name field's label. Default \"Name\". */\n  nameLabel?: string;\n  /** The app's own fields, below the name (version control, a build path). */\n  details?: HTMLElement;\n  /** The item chosen when the gallery opens. Default: the first. */\n  initial?: T;\n  onPick: (id: T, choice: KitGalleryChoice) => void;\n  /** Runs once the gallery has closed, whichever way. */\n  onClose?: () => void;\n}\n\nexport interface KitGallery {\n  readonly dialog: HTMLDialogElement;\n  close(): void;\n}\n\n/** Open the gallery as a modal dialog on the family's frame. */\nexport function openKitGallery<T extends string>(opts: KitGalleryOptions<T>): KitGallery {\n  const frame = dialogFrame({ title: opts.title, ...(opts.what !== undefined ? { sub: opts.what } : {}), className: \"kit-gallery\", ...(opts.onClose ? { onClose: opts.onClose } : {}) });\n  const { dialog } = frame;\n\n  const entries = opts.sections.flatMap((section, s) => section.items.map((item) => ({ item, section, s })));\n  if (entries.length === 0) throw new Error(\"openKitGallery: no items to choose from\");\n  let chosen = entries.find((e) => e.item.id === opts.initial) ?? entries[0]!;\n\n  // --- the details panel ----------------------------------------------------\n  const nameInput = opts.namePlaceholder === undefined ? undefined : el(\"input\", { className: \"field kit-gallery-name\" }) as HTMLInputElement;\n  if (nameInput) {\n    nameInput.placeholder = opts.namePlaceholder!;\n    nameInput.setAttribute(\"aria-label\", opts.nameLabel ?? \"Name\");\n  }\n  const fields = el(\"div\", \"kit-gallery-fields\",\n    ...(nameInput ? [el(\"label\", \"kit-gallery-label\", opts.nameLabel ?? \"Name\"), nameInput] : []),\n    ...(opts.details ? [opts.details] : []));\n\n  const panelArt = el(\"div\", \"kit-gallery-art kit-gallery-panel-art\");\n  const panelName = el(\"h3\", \"kit-gallery-panel-name\");\n  const panelBlurb = el(\"p\", \"kit-gallery-panel-blurb\");\n  const panelDetail = el(\"p\", \"kit-gallery-panel-detail\");\n  const panelPlay = el(\"p\", \"kit-gallery-play\");\n  const panelShows = el(\"p\", \"kit-gallery-shows\");\n  const panelLands = el(\"ul\", \"kit-gallery-lands\");\n  const panelLandsCaption = el(\"p\", \"kit-gallery-lands-caption\", \"What you get\");\n  const panelNote = el(\"p\", \"kit-gallery-note\");\n  const panel = el(\"div\", \"kit-gallery-panel\",\n    panelArt, panelName, panelBlurb, panelDetail, panelPlay, panelShows, panelLandsCaption, panelLands, panelNote, fields);\n\n  const primary = el(\"button\", { className: \"btn primary\", onClick: () => commit() }) as HTMLButtonElement;\n  primary.type = \"button\";\n  const cancel = el(\"button\", { className: \"btn\", text: \"Cancel\", onClick: () => frame.close() }) as HTMLButtonElement;\n  cancel.type = \"button\";\n\n  const setArt = (host: HTMLElement, image: string | undefined): void => {\n    host.replaceChildren();\n    host.hidden = image === undefined;\n    if (image === undefined) return;\n    const ink = el(\"span\", \"kit-gallery-ink\");\n    ink.style.setProperty(\"--kit-art\", `url(\"${image.replace(/\"/g, \"%22\")}\")`);\n    host.append(ink);\n  };\n  const setText = (node: HTMLElement, text: string | undefined): void => {\n    node.textContent = text ?? \"\";\n    node.hidden = text === undefined || text === \"\";\n  };\n\n  // --- the tiles --------------------------------------------------------------\n  const tiles = new Map<T, HTMLButtonElement>();\n  const shelves = opts.sections.map((section) => {\n    const grid = el(\"div\", \"kit-gallery-grid\", ...section.items.map((item) => {\n      const art = el(\"div\", \"kit-gallery-art\");\n      setArt(art, item.image);\n      const tile = el(\"button\", { className: \"kit-gallery-tile\", onClick: () => choose(item.id) },\n        art,\n        el(\"span\", \"kit-gallery-tile-head\",\n          el(\"span\", \"kit-gallery-tile-name\", item.name),\n          item.badge !== undefined ? el(\"span\", \"kit-gallery-badge\", item.badge) : null),\n        el(\"span\", \"kit-gallery-tile-blurb\", item.blurb)) as HTMLButtonElement;\n      tile.type = \"button\";\n      tile.dataset.kit = item.id;\n      // Double-click is the desktop's \"choose and go\"; a single click only chooses,\n      // so a tile can be read in the panel before anything is made.\n      tile.addEventListener(\"dblclick\", () => { choose(item.id); commit(); });\n      tiles.set(item.id, tile);\n      return tile;\n    }));\n    return el(\"section\", \"kit-gallery-shelf\",\n      section.caption !== undefined ? el(\"h3\", \"kit-gallery-caption\", section.caption) : null,\n      section.note !== undefined ? el(\"p\", \"kit-gallery-shelf-note\", section.note) : null,\n      grid);\n  });\n\n  const choose = (id: T): void => {\n    const next = entries.find((e) => e.item.id === id);\n    if (!next) return;\n    chosen = next;\n    for (const [tid, tile] of tiles) tile.setAttribute(\"aria-pressed\", String(tid === id));\n    const { item, section } = chosen;\n    setArt(panelArt, item.image);\n    panelName.textContent = item.name;\n    setText(panelBlurb, item.blurb);\n    setText(panelDetail, item.detail);\n    setText(panelPlay, item.play);\n    setText(panelShows, item.shows !== undefined ? `Shows: ${item.shows}` : undefined);\n    panelLands.replaceChildren(...(item.lands ?? []).map((l) => el(\"li\", undefined, l)));\n    panelLands.hidden = (item.lands ?? []).length === 0;\n    panelLandsCaption.hidden = panelLands.hidden;\n    const details = section.usesDetails !== false;\n    fields.hidden = !details || (nameInput === undefined && opts.details === undefined);\n    // Without the fields, the shelf's note is what the click will do next\n    // (\"a folder you choose\"), so the panel repeats it beside the button.\n    setText(panelNote, details ? undefined : section.note);\n    primary.textContent = section.action ?? \"Create\";\n  };\n\n  const commit = (): void => {\n    const { item, section } = chosen;\n    const details = section.usesDetails !== false;\n    let name: string | undefined;\n    if (details && nameInput) {\n      name = nameInput.value.trim();\n      if (name === \"\") { nameInput.focus(); nameInput.classList.add(\"kit-gallery-missing\"); return; }\n    }\n    frame.close();\n    opts.onPick(item.id, name !== undefined ? { name } : {});\n  };\n\n  if (nameInput) {\n    nameInput.addEventListener(\"input\", () => nameInput.classList.remove(\"kit-gallery-missing\"));\n    // Enter creates with what is chosen: the author has said what it should be\n    // called, and the tile they are looking at is the one they meant.\n    nameInput.addEventListener(\"keydown\", (e) => {\n      e.stopPropagation();\n      if (e.key !== \"Enter\") return;\n      e.preventDefault();\n      commit();\n    });\n  }\n\n  frame.body.append(el(\"div\", \"kit-gallery-layout\", el(\"div\", \"kit-gallery-shelves\", ...shelves), panel));\n  frame.actions.append(cancel, primary);\n  dialog.addEventListener(\"click\", (e) => { if (e.target === dialog) frame.close(); });\n\n  choose(chosen.item.id);\n  frame.open();\n  // Focus where the next keystroke is wanted: the name when one is asked for\n  // and the opening shelf uses it, otherwise the chosen tile.\n  if (nameInput && chosen.section.usesDetails !== false) nameInput.focus();\n  else tiles.get(chosen.item.id)?.focus();\n\n  return { dialog, close: () => frame.close() };\n}\n"]}

package/dist/index.cjs

@@ -2763,6 +2763,153 @@ function mountWelcome(host, opts) {
   return { el: root, setRecents: drawRecents, setError };
 }
 
+// src/kit-gallery.ts
+function openKitGallery(opts) {
+  const frame = dialogFrame({ title: opts.title, ...opts.what !== void 0 ? { sub: opts.what } : {}, className: "kit-gallery", ...opts.onClose ? { onClose: opts.onClose } : {} });
+  const { dialog } = frame;
+  const entries = opts.sections.flatMap((section, s) => section.items.map((item) => ({ item, section, s })));
+  if (entries.length === 0) throw new Error("openKitGallery: no items to choose from");
+  let chosen = entries.find((e) => e.item.id === opts.initial) ?? entries[0];
+  const nameInput = opts.namePlaceholder === void 0 ? void 0 : el("input", { className: "field kit-gallery-name" });
+  if (nameInput) {
+    nameInput.placeholder = opts.namePlaceholder;
+    nameInput.setAttribute("aria-label", opts.nameLabel ?? "Name");
+  }
+  const fields = el(
+    "div",
+    "kit-gallery-fields",
+    ...nameInput ? [el("label", "kit-gallery-label", opts.nameLabel ?? "Name"), nameInput] : [],
+    ...opts.details ? [opts.details] : []
+  );
+  const panelArt = el("div", "kit-gallery-art kit-gallery-panel-art");
+  const panelName = el("h3", "kit-gallery-panel-name");
+  const panelBlurb = el("p", "kit-gallery-panel-blurb");
+  const panelDetail = el("p", "kit-gallery-panel-detail");
+  const panelPlay = el("p", "kit-gallery-play");
+  const panelShows = el("p", "kit-gallery-shows");
+  const panelLands = el("ul", "kit-gallery-lands");
+  const panelLandsCaption = el("p", "kit-gallery-lands-caption", "What you get");
+  const panelNote = el("p", "kit-gallery-note");
+  const panel = el(
+    "div",
+    "kit-gallery-panel",
+    panelArt,
+    panelName,
+    panelBlurb,
+    panelDetail,
+    panelPlay,
+    panelShows,
+    panelLandsCaption,
+    panelLands,
+    panelNote,
+    fields
+  );
+  const primary = el("button", { className: "btn primary", onClick: () => commit() });
+  primary.type = "button";
+  const cancel = el("button", { className: "btn", text: "Cancel", onClick: () => frame.close() });
+  cancel.type = "button";
+  const setArt = (host, image) => {
+    host.replaceChildren();
+    host.hidden = image === void 0;
+    if (image === void 0) return;
+    const ink = el("span", "kit-gallery-ink");
+    ink.style.setProperty("--kit-art", `url("${image.replace(/"/g, "%22")}")`);
+    host.append(ink);
+  };
+  const setText = (node2, text) => {
+    node2.textContent = text ?? "";
+    node2.hidden = text === void 0 || text === "";
+  };
+  const tiles = /* @__PURE__ */ new Map();
+  const shelves = opts.sections.map((section) => {
+    const grid = el("div", "kit-gallery-grid", ...section.items.map((item) => {
+      const art = el("div", "kit-gallery-art");
+      setArt(art, item.image);
+      const tile = el(
+        "button",
+        { className: "kit-gallery-tile", onClick: () => choose(item.id) },
+        art,
+        el(
+          "span",
+          "kit-gallery-tile-head",
+          el("span", "kit-gallery-tile-name", item.name),
+          item.badge !== void 0 ? el("span", "kit-gallery-badge", item.badge) : null
+        ),
+        el("span", "kit-gallery-tile-blurb", item.blurb)
+      );
+      tile.type = "button";
+      tile.dataset.kit = item.id;
+      tile.addEventListener("dblclick", () => {
+        choose(item.id);
+        commit();
+      });
+      tiles.set(item.id, tile);
+      return tile;
+    }));
+    return el(
+      "section",
+      "kit-gallery-shelf",
+      section.caption !== void 0 ? el("h3", "kit-gallery-caption", section.caption) : null,
+      section.note !== void 0 ? el("p", "kit-gallery-shelf-note", section.note) : null,
+      grid
+    );
+  });
+  const choose = (id) => {
+    const next = entries.find((e) => e.item.id === id);
+    if (!next) return;
+    chosen = next;
+    for (const [tid, tile] of tiles) tile.setAttribute("aria-pressed", String(tid === id));
+    const { item, section } = chosen;
+    setArt(panelArt, item.image);
+    panelName.textContent = item.name;
+    setText(panelBlurb, item.blurb);
+    setText(panelDetail, item.detail);
+    setText(panelPlay, item.play);
+    setText(panelShows, item.shows !== void 0 ? `Shows: ${item.shows}` : void 0);
+    panelLands.replaceChildren(...(item.lands ?? []).map((l) => el("li", void 0, l)));
+    panelLands.hidden = (item.lands ?? []).length === 0;
+    panelLandsCaption.hidden = panelLands.hidden;
+    const details = section.usesDetails !== false;
+    fields.hidden = !details || nameInput === void 0 && opts.details === void 0;
+    setText(panelNote, details ? void 0 : section.note);
+    primary.textContent = section.action ?? "Create";
+  };
+  const commit = () => {
+    const { item, section } = chosen;
+    const details = section.usesDetails !== false;
+    let name;
+    if (details && nameInput) {
+      name = nameInput.value.trim();
+      if (name === "") {
+        nameInput.focus();
+        nameInput.classList.add("kit-gallery-missing");
+        return;
+      }
+    }
+    frame.close();
+    opts.onPick(item.id, name !== void 0 ? { name } : {});
+  };
+  if (nameInput) {
+    nameInput.addEventListener("input", () => nameInput.classList.remove("kit-gallery-missing"));
+    nameInput.addEventListener("keydown", (e) => {
+      e.stopPropagation();
+      if (e.key !== "Enter") return;
+      e.preventDefault();
+      commit();
+    });
+  }
+  frame.body.append(el("div", "kit-gallery-layout", el("div", "kit-gallery-shelves", ...shelves), panel));
+  frame.actions.append(cancel, primary);
+  dialog.addEventListener("click", (e) => {
+    if (e.target === dialog) frame.close();
+  });
+  choose(chosen.item.id);
+  frame.open();
+  if (nameInput && chosen.section.usesDetails !== false) nameInput.focus();
+  else tiles.get(chosen.item.id)?.focus();
+  return { dialog, close: () => frame.close() };
+}
+
 // src/link-status.ts
 function linkStatusClass(s) {
   if (s.state === "off" || s.state === "error") return "off";
@@ -3161,6 +3308,7 @@ exports.openAnchoredPanel = openAnchoredPanel;
 exports.openComments = openComments;
 exports.openContextMenu = openContextMenu;
 exports.openGameIdEditor = openGameIdEditor;
+exports.openKitGallery = openKitGallery;
 exports.openNotesEditor = openNotesEditor;
 exports.openPopover = openPopover;
 exports.paintVcBadges = paintVcBadges;