@heycys/gallery 0.2.0 → 0.2.2

package/THIRD-PARTY-NOTICES.md

@@ -1,6 +1,6 @@
 # Third-party notices
 
-@heycys/gallery 0.2.0 carries the following code and data of others, bundled into dist/ and web/, built into kit/, or as files in vendor/ and browser/.
+@heycys/gallery 0.2.2 carries the following code and data of others, bundled into dist/ and web/, built into kit/, or as files in vendor/ and browser/.
 
 ## @asamuzakjp/css-color 5.1.11
 

package/browser/editor/components/icon/page.mjs

@@ -43,9 +43,9 @@ const STYLE = `
   [data-ge-editing] main ${STEP}[data-ge-number-hover]:not(:has(> .${ICON}))::before { box-shadow: inset 0 0 0 20px light-dark(rgb(55 53 47 / 8%), rgb(255 255 255 / 8%)); }
   .ge-add-icon { position: fixed; left: 0; top: 0; z-index: ${Z.affordance}; display: flex; align-items: center; gap: 6px; height: 28px; padding: 0 8px; border-radius: 6px;
     color: var(--ge-tx3); font: 14px/1 ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif;
-    white-space: nowrap; cursor: pointer; user-select: none; opacity: 0; transition: opacity .1s ease-in, background .1s ease-in; }
+    white-space: nowrap; cursor: pointer; user-select: none; opacity: 0; visibility: hidden; pointer-events: none; transition: opacity .1s ease-in, background .1s ease-in; }
   .ge-add-icon svg { display: block; flex: none; width: 14px; height: 14px; fill: none; stroke: currentColor; stroke-width: 1.6; stroke-linecap: round; stroke-linejoin: round; }
-  .ge-add-icon[data-shown] { opacity: 1; }
+  .ge-add-icon[data-shown] { opacity: 1; visibility: visible; pointer-events: auto; }
   .ge-add-icon:hover { background: light-dark(rgb(55 53 47 / 6%), rgb(255 255 255 / 6%)); }
 `;
 
@@ -187,21 +187,23 @@ export function create({ struct, say, isEditing, openMediaPicker, assetUrl, impo
   const add = element("div", { class: "ge-add-icon", role: "button", tabindex: "0", html: t("{0}添加图标", FACE_ICON) });
   add.addEventListener("mousedown", (event) => event.preventDefault());
   add.addEventListener("click", async () => {
+    if (!shown || !isEditing() || iconOf()) return;
     await loadEmojiData();
+    if (!shown || !isEditing() || iconOf()) return;
     setIcon(randomEmoji(), t("已添加页面图标"));
   });
   let shown = false;
   function showAdd() {
     const title = titleOf();
     const header = title?.parentElement;
-    if (!title || !header) return hideAdd();
+    if (!isEditing() || !title || !header || iconOf()) return hideAdd();
     if (!add.isConnected) mount(add);
     const first = header.firstElementChild.getBoundingClientRect();
     const range = document.createRange();
     range.selectNodeContents(title);
     const text = range.getClientRects()[0] ?? title.getBoundingClientRect();
     add.style.transform = `translate(${Math.round(text.left - 8)}px, ${Math.round(first.top - 28 - 6)}px)`;
-    if (!shown) requestAnimationFrame(() => add.setAttribute("data-shown", ""));
+    if (!shown) requestAnimationFrame(() => { if (shown) add.setAttribute("data-shown", ""); });
     shown = true;
   }
   function hideAdd() {

package/browser/editor/components/icons.mjs

@@ -18,8 +18,8 @@ const LEVELS = {
 export const FORMULA_ICON = svg('<path d="M1.6 11.6 5.5 16.25 9.5 3.75h8.75"/><path d="m10.6 7.9 6.6 8.35M17.2 7.9l-6.6 8.35"/>');
 
 /** A link (two rings of a chain): the "/" menu's 链接, 链接视图, an empty link's chip, one drawing. */
-/** A page (as the workbench's tree draws one with no icon: Lucide's file-text, FinHarness's 文档, here in 20 units): the "/" menu's 页面, a page block left empty, a page with no icon in a search's rows. */
-export const PAGE_ICON = svg('<path d="M5 18.33a1.67 1.67 0 0 1-1.67-1.66V3.33a1.67 1.67 0 0 1 1.67-1.66h6.67a2 2 0 0 1 1.42.58l2.99 2.99a2 2 0 0 1 .59 1.43v10a1.67 1.67 0 0 1-1.67 1.66z"/><path d="M11.67 1.67v4.16c0 .46.37.84.83.84h4.17"/><path d="M8.33 7.5H6.67M13.33 10.83H6.67M13.33 14.17H6.67"/>');
+/** A page (the workbench's plain Lucide file outline, here in 20 units): the "/" menu's 页面, a page block left empty, a page with no icon in a search's rows. */
+export const PAGE_ICON = svg('<path d="M5 18.33a1.67 1.67 0 0 1-1.67-1.66V3.33a1.67 1.67 0 0 1 1.67-1.66h6.67a2 2 0 0 1 1.42.58l2.99 2.99a2 2 0 0 1 .59 1.43v10a1.67 1.67 0 0 1-1.67 1.66z"/><path d="M11.67 1.67v4.16c0 .46.37.84.83.84h4.17"/>');
 
 /** A section (分区): blocks gathered between brackets, the block menu's 组成新分区 and the section's line in 设置 › 组件列表. */
 export const SECTION_ICON = svg('<path d="M6 3.75h-.75a2 2 0 0 0-2 2v8.5a2 2 0 0 0 2 2H6M14 3.75h.75a2 2 0 0 1 2 2v8.5a2 2 0 0 1-2 2H14"/><path d="M7.25 7.75h5.5M7.25 12.25h5.5"/>');

package/browser/editor/page/annotate/index.mjs

@@ -1,3 +1,4 @@
+import { documentKey, workspaceAddress } from "../../../shared/workspace-address.mjs";
 import { CARD, RAIL, cardTops, markerLeft, markerTop, newAnnotationId, sameWords, squash, stackItems, tidy } from "../../../shared/annotations.mjs";
 import { t } from "../../../shared/i18n/index.mjs";
 import { SHARES_HEIGHT, standsAsPicture } from "../../components/registry.mjs";
@@ -106,7 +107,7 @@ const NOTICE_ROOM = 70;
 const IN_ROW = [...SHARES_HEIGHT].map((kind) => `[data-ge-unit-kind="${kind}"] > *`).join();
 
 export function createAnnotate({ slug, token, isEditing, picked, unpick = () => {}, wholePage = () => [], crossTexts, idFor, changed = () => {}, removed = () => {}, say }) {
-  const stashKey = `gallery-edit:${slug}:notes`; // what could not be saved (offline), sent by the next page that reads them
+  const stashKey = `gallery-edit:${documentKey(slug)}:notes`; // what could not be saved (offline), sent by the next page that reads them
   let reading = null; // the first read from the server, under way or done (taken back when it failed)
   let counted = false; // that read is in and what it brought found: the page can say how many it has
   let items = new Map(); // id -> { id, created, updated, text, anchor } in page order, as the server last said, with the page's own changes
@@ -189,7 +190,7 @@ export function createAnnotate({ slug, token, isEditing, picked, unpick = () =>
     chain = run.catch(() => {});
     return run;
   };
-  const fetchAll = () => fetch(`${ROUTE}?slug=${encodeURIComponent(slug)}`, { headers: { "X-Gallery-Token": token }, cache: "no-store" })
+  const fetchAll = () => fetch(workspaceAddress(`${ROUTE}?slug=${encodeURIComponent(slug)}`), { headers: { "X-Gallery-Token": token }, cache: "no-store" })
     .then((response) => response.json()).catch(() => ({ ok: false, reason: "offline" }));
   const wire = (item) => ({ id: item.id, created: item.created, updated: item.updated, text: item.text, anchor: item.anchor });
 

package/browser/editor/page/board/index.mjs

@@ -1,3 +1,4 @@
+import { workspaceAddress } from "../../../shared/workspace-address.mjs";
 import { GAP, GRID, cellAt, fitHeight, gridFor, moved, pushDown, sizeFor, spanOf } from "../../../shared/board-places.mjs";
 import { cellsOf } from "../../../shared/card-size.mjs";
 import { language, t } from "../../../shared/i18n/index.mjs";
@@ -793,7 +794,7 @@ export function startBoard({ map, reload, hosted = false }) {
     menu.close();
     let listed = [];
     try {
-      listed = (await (await fetch(`/__gallery/pages/${slug}/library?language=${language}`)).json()).blocks ?? [];
+      listed = (await (await fetch(workspaceAddress(`/__gallery/pages/${slug}/library?language=${language}`))).json()).blocks ?? [];
     } catch {
       say(t("连不上本地服务"), "error");
       return false;

package/browser/editor/page/board/settings.mjs

@@ -1,3 +1,4 @@
+import { workspaceAddress } from "../../../shared/workspace-address.mjs";
 import { Z } from "../../../shared/layers.mjs";
 import { language, t } from "../../../shared/i18n/index.mjs";
 import { createMenu } from "../menu.mjs";
@@ -59,7 +60,7 @@ export const formOpen = () => shown !== null;
 /** The workspace's documents, by title: [{ slug, title }] (none where the outline cannot be read). */
 async function documents() {
   try {
-    const answer = await (await fetch("/__gallery/workspace/outline")).json();
+    const answer = await (await fetch(workspaceAddress("/__gallery/workspace/outline"))).json();
     return Object.values(answer.reports ?? {}).filter((report) => !report.instructions && report.kind !== "link").map(({ slug, title }) => ({ slug, title: title || slug }))
       .sort((a, b) => a.title.localeCompare(b.title, "zh-CN"));
   } catch {

package/browser/editor/page/clipboard/import/read.mjs

@@ -14,7 +14,8 @@ import { addressOf } from "../../links/address.mjs";
 //     formatting" (html.mjs containsRichFormatting; WordPress's always): spans, divs and paragraphs
 //     alone paste as their text.
 //   - Office's HTML (its namespaces) that looks like Word's goes through the Word filter (office.mjs).
-//   - A whole $$ formula $$ → a formula block; several lines from VS Code → code in its language.
+//   - A whole $$ formula $$ → a formula block; IDE Markdown → document blocks, other IDE code →
+//     code in its language. An unspecified IDE language can be Markdown by its parsed structure.
 //   - HTML: several lines of text, or a table → blocks (html.mjs htmlToBlocks); else one rich text.
 //   - No HTML: several lines → Markdown (markdown.mjs); one line → inline Markdown (bold, links,
 //     addresses, formulas) when it has any, else plain text. A whole line that is a display formula
@@ -89,6 +90,20 @@ function sameAddress(one, other) {
   }
 }
 
+// VS Code and Cursor copy syntax-colored HTML beside the source text, even for Markdown. Use
+// the same Markdown reader as an ordinary text paste, not the colored HTML. A Markdown language
+// hint is enough; for an unspecified language, require some structure or inline formatting the
+// reader actually recognizes. Unrecognized lines remain text; the whole selection need not be
+// valid Markdown. A declared programming language wins over lookalike comments and operators.
+function editorMarkdown({ text, language }) {
+  if (language !== "Markdown" && language !== "Plain Text") return null;
+  const specs = fromMarkdown(text);
+  if (language === "Markdown") return specs;
+  const marked = (blocks) => blocks.some((block) => block.type !== "text"
+    || block.title.some((piece) => piece[1]?.length) || marked(block.children));
+  return !addressOf(text) && marked(specs) ? specs : null;
+}
+
 /**
  * Another program's content as { kind: "blocks", specs } | { kind: "rich", title } | { kind: "plain",
  * text } (notion-lite readClipboard, after the editor's own formats).
@@ -98,11 +113,14 @@ export function readExternal(data, options = {}) {
   const yuque = readYuque(data, options);
   if (yuque) return yuque;
   const external = externalContent(data, options);
-  const { text, html } = external;
+  const { text } = external;
   const convert = { colors: external.colors };
   const equation = EQUATION.exec(text)?.[1];
   if (equation?.trim()) return { kind: "blocks", specs: [{ type: "equation", title: [[equation]], props: {}, children: [] }] };
+  const markdown = editorMarkdown(external);
+  if (markdown?.length && (multiline(text) || markdown.some((block) => block.type !== "text"))) return { kind: "blocks", specs: markdown };
   if (multiline(text) && external.language) return { kind: "blocks", specs: [{ type: "code", title: [[text]], props: { language: external.language }, children: [] }] };
+  const html = markdown ? "" : external.html;
   if (html) {
     if (multiline(text) || external.isTable) {
       const specs = mathifySpecs(htmlToBlocks(parseClipboardHTML(html, options), convert));

package/browser/editor/page/core.mjs

@@ -1,3 +1,4 @@
+import { localPath } from "../../shared/workspace-address.mjs";
 import { escapeAttribute, escapeText, escapeTyped, unescapeText } from "../../shared/escape.mjs";
 import { formatRange, isInkClass, isUnderlineClass, markValue } from "./marks.mjs";
 import { ZWSP, inlineItems, spaceAround } from "../../shared/inline-spacing.mjs";
@@ -294,13 +295,13 @@ export function newMention(doc, { href, title, icon = null, drawn = null }, asse
 export function mentionOf(chip) {
   const img = chip.querySelector(`img.${MENTION_ICON}`);
   const src = img?.getAttribute("data-ge-src") ?? img?.getAttribute("src") ?? "";
-  const served = /^\/__gallery\/edit\/asset\/([^/]+)\/(assets\/[^/?#]+)$/.exec(src);
+  const served = /^\/__gallery\/edit\/asset\/([^/]+)\/(assets\/[^/?#]+)$/.exec(localPath(src));
   return {
     href: chip.getAttribute("href") ?? "",
     title: chip.textContent.replace(/\s+/g, " ").trim(),
     icon: served ? served[2] : /^assets\/[^/]+$/.test(src) ? src : null,
     slug: served ? decodeURIComponent(served[1]) : null,
-    drawn: src.startsWith("/__gallery/edit/icon?") ? src : null,
+    drawn: localPath(src).startsWith("/__gallery/edit/icon?") ? src : null,
   };
 }
 

package/browser/editor/page/custom-page.mjs

@@ -1,3 +1,4 @@
+import { localPath } from "../../shared/workspace-address.mjs";
 import { startBoard } from "./board/index.mjs";
 import { relayTo } from "./notices.mjs";
 import { connectWorkbench } from "./session.mjs";
@@ -21,7 +22,7 @@ import { connectWorkbench } from "./session.mjs";
 // document or another page, or a block's context.workspace.open: doc-open-request) and key. Opened on its own (not in a frame of the workbench), it has no
 // session: its board edits all the same, and the live script reloads it.
 
-const slug = decodeURIComponent(location.pathname.split("/")[2] ?? "");
+const slug = decodeURIComponent(localPath(location.pathname).split("/")[2] ?? "");
 const IDLE = { editing: false, pending: false, saving: false, offline: false, conflicts: 0, unfit: 0, changed: false };
 // Nothing stands over a custom page as a modal.
 const NO_MODALS = { open: () => [], listen() {}, closeTop: () => false };
@@ -94,8 +95,8 @@ if (session) {
       window.open(url.href, "_blank", "noopener");
       return;
     }
-    const custom = /^\/pages\/([a-z0-9-]+)\/?$/.exec(url.pathname)?.[1];
-    const page = /^\/generated\/([a-z0-9-]+)\.html$/.exec(url.pathname)?.[1] ?? /^\/([a-z0-9-]+)\/(?:doc|report)\.html$/.exec(url.pathname)?.[1];
+    const custom = /^\/pages\/([a-z0-9-]+)\/?$/.exec(localPath(url.pathname))?.[1];
+    const page = /^\/generated\/([a-z0-9-]+)\.html$/.exec(localPath(url.pathname))?.[1] ?? /^\/([a-z0-9-]+)\/(?:doc|report)\.html$/.exec(localPath(url.pathname))?.[1];
     if (custom) {
       event.preventDefault();
       session.open({ hash: `@${custom}` });

package/browser/editor/page/editor.mjs

@@ -1,3 +1,5 @@
+import { documentKey, workspaceStoragePrefix } from "../../shared/workspace-address.mjs";
+import { workspaceAddress } from "../../shared/workspace-address.mjs";
 // First: what the browser keeps under the names before 2026-10-28 carried to the new ones (the
 // editor's gallery-edit:… keys, src/shared/renamed-storage.mjs), before any module below reads them.
 import "../../shared/renamed-storage.mjs";
@@ -61,7 +63,7 @@ import { decoded, fullAddress, isFileLink } from "../../shared/page-address.mjs"
 import { goBackTo, placeIn, unmoved } from "../../shared/reading-place.mjs";
 import { heldList, holdPages } from "./links/pages.mjs";
 import { hideBlocks } from "./offered.mjs";
-import { local, storageOf } from "./storage.mjs";
+import { storageOf } from "./storage.mjs";
 import { createTodoWrites } from "./todo-writes.mjs";
 import { language, t } from "../../shared/i18n/index.mjs";
 
@@ -131,7 +133,9 @@ let conflicts = null; // what the file refused, for the reader to decide (confli
 let unsaveable = { blank: 0, unplaced: 0 }; // blocks the page cannot save as they are
 let notice = null; // { text, time }: what a commit just said, to say again if the page reloads by itself
 
-const session = storageOf(() => sessionStorage);
+const storageScope = { prefix: workspaceStoragePrefix() };
+const local = storageOf(() => localStorage, storageScope);
+const session = storageOf(() => sessionStorage, storageScope);
 
 // This tab, kept over reloads (sessionStorage). Each tab keeps what waits to be saved (the crash
 // buffer, autosave.mjs) under its own id, so two tabs of a report never overwrite each other's; the
@@ -140,7 +144,7 @@ const session = storageOf(() => sessionStorage);
 const newTab = () => Math.random().toString(36).slice(2, 10);
 let TAB = session.get(keys.tab) ?? newTab();
 session.set(keys.tab, TAB);
-const channel = (() => { try { return new BroadcastChannel(`gallery-edit:${MAP.slug}`); } catch { return null; } })();
+const channel = (() => { try { return new BroadcastChannel(`gallery-edit:${documentKey(MAP.slug)}`); } catch { return null; } })();
 channel?.addEventListener("message", (event) => {
   if (event.data?.type === "who") channel.postMessage({ type: "here", tab: TAB });
 });
@@ -1411,7 +1415,7 @@ async function goTo({ slug = null, block = null, hash = null }, href) {
     if (block) jumpTo(block);
   } else if (SOLO) window.open(href, "_blank", "noopener");
   else if (window.parent !== window) workbench?.open(hash === null ? { target: slug, block } : { hash });
-  else if (hash === null || (await leadsToPage(hash))) COMMANDS["prepare-close"]().then(() => location.assign(hash === null ? `/generated/${slug}.html${block ? `#${encodeURIComponent(block)}` : ""}` : href));
+  else if (hash === null || (await leadsToPage(hash))) COMMANDS["prepare-close"]().then(() => location.assign(hash === null ? workspaceAddress( `/generated/${slug}.html${block ? `#${encodeURIComponent(block)}` : ""}` ) : href));
 }
 
 function connectParts() {
@@ -1500,7 +1504,7 @@ function connect() {
     event.preventDefault();
     if (page) {
       if (window.parent !== window && !SOLO) workbench?.open({ hash: `@${page}` });
-      else COMMANDS["prepare-close"]().then(() => location.assign(`/pages/${page}`));
+      else COMMANDS["prepare-close"]().then(() => location.assign(workspaceAddress(`/pages/${page}`)));
     } else goTo({ slug, block }, `/generated/${slug}.html${block ? `#${encodeURIComponent(block)}` : ""}`);
   });
   relayTo(workbench ? workbench.notice : null, workbench ? workbench.noticeRoom : null); // the workbench shows the page's notices, above the page's bottom panels

package/browser/editor/page/emoji-picker/support.mjs

@@ -1,3 +1,4 @@
+import { workspaceAddress } from "../../../shared/workspace-address.mjs";
 import { Z } from "../../../shared/layers.mjs";
 import { escapeMarkup } from "../../../shared/escape.mjs";
 import { icon } from "./icons.mjs";
@@ -198,7 +199,7 @@ export function connectPicker({ slug, token, notify }) {
   server = { slug, token };
   say = notify;
   setEmojiLibraryStorage({
-    loadEmojiLibrary: () => fetch(`/__gallery/edit/emoji-library`).then((response) => response.json()).then((answer) => answer.list ?? []).catch(() => []),
-    addEmoji: async ({ name, url }) => (await post("emoji-library", { name, url })).entry,
+    loadEmojiLibrary: () => fetch(workspaceAddress(`/__gallery/edit/emoji-library`)).then((response) => response.json()).then((answer) => (answer.list ?? []).map(entry => ({ ...entry, url: workspaceAddress(entry.url) }))).catch(() => []),
+    addEmoji: async ({ name, url }) => { const entry = (await post("emoji-library", { name, url })).entry; return { ...entry, url: workspaceAddress(entry.url) }; },
   });
 }

package/browser/editor/page/links/index.mjs

@@ -752,17 +752,6 @@ function opens(event) {
 // workspace's page of one folder name, opened as any web address. A tab
 // of its own opens with the click, the list read after, for only what the click itself opens does the
 // browser leave behind the page.
-async function followElsewhere(address, tab) {
-  const opened = tab ? window.open("", "_blank") : null;
-  const list = await readPages(use.own());
-  const page = list && placeIn(list, address);
-  const here = page && fullAddress(location.origin, page, list.links);
-  if (opened) {
-    opened.opener = null;
-    opened.location.replace(here ?? address);
-  } else if (page) use.go(page, here);
-  else openTab(address);
-}
 
 // Go where `href`, a link of this page that is no anchor, leads, read as its file reads it, so that
 // doc.html beside it is this document: a document's address there, with `tab` in a tab of its own, a
@@ -771,7 +760,7 @@ async function followElsewhere(address, tab) {
 function follow(href, tab) {
   const address = fromFile(href, use.slug, location.origin);
   if (!address) return;
-  if (elsewhere(address, location.origin)) return void followElsewhere(address, tab);
+  if (elsewhere(address, location.origin)) return void openTab(address);
   const place = placeOf(address);
   const file = referencedFile(href);
   if (place && !tab) use.go(place, address);

package/browser/editor/page/links/pages.mjs

@@ -1,3 +1,4 @@
+import { workspaceAddress } from "../../../shared/workspace-address.mjs";
 import { iconUrl } from "../../../shared/emoji/icon-value.mjs";
 import { escapeAttribute } from "../../../shared/escape.mjs";
 import { addressOn, decoded, hashAddress } from "../../../shared/page-address.mjs";
@@ -41,7 +42,7 @@ let shown = () => null; // this page, as readPages takes it
  * null when the list cannot be read (`webs`: the links of the sidebar's web links, which are no pages). `own`: this page, { slug, title } as it shows it.
  */
 export async function readPages(own = null) {
-  const listed = await fetch(OUTLINE).then((answer) => answer.json()).catch(() => null);
+  const listed = await fetch(workspaceAddress(OUTLINE)).then((answer) => answer.json()).catch(() => null);
   if (!listed?.reports) return null;
   const titleOf = (slug) => (slug === own?.slug && own.title ? own.title : listed.reports[slug]?.title);
   const pages = [];
@@ -80,7 +81,7 @@ export function heldList() {
 
 /** Whether document `slug` is in the workspace's trash (not when the trash cannot be read). */
 export async function trashed(slug) {
-  const listed = await fetch(TRASH).then((answer) => answer.json()).catch(() => null);
+  const listed = await fetch(workspaceAddress(TRASH)).then((answer) => answer.json()).catch(() => null);
   return inTrash(listed?.entries ?? [], slug);
 }
 

package/browser/editor/page/outline/folds.mjs

@@ -3,6 +3,7 @@
 // heading's block id, a tab's area and tab), the reports folded last kept and the oldest let go. The
 // headings folded on the page (fold/) are kept the same way under a key of their own (`key`).
 
+import { documentKey } from "../../../shared/workspace-address.mjs";
 import { KEYS } from "../../../shared/renamed-storage.mjs";
 
 export const FOLDS_KEY = KEYS.outlineFolds;
@@ -18,6 +19,7 @@ function read(storage, key) {
 
 /** The keys folded in report `slug` (`storage`: { get, set }, page/storage.mjs), kept under `key`. */
 export function foldsOf(storage, slug, key = FOLDS_KEY) {
+  slug = documentKey(slug);
   const keys = read(storage, key).folds[slug];
   return new Set(Array.isArray(keys) ? keys.filter((key) => typeof key === "string") : []);
 }
@@ -27,6 +29,7 @@ export function foldsOf(storage, slug, key = FOLDS_KEY) {
  * folded last; none folded forgets the report. At most KEEP reports, the oldest going first.
  */
 export function keepFolds(storage, slug, folded, present = null, key = FOLDS_KEY) {
+  slug = documentKey(slug);
   const value = read(storage, key);
   const keys = [...folded].filter((each) => !present || present.has(each));
   delete value.folds[slug]; // put back last: the report folded last

package/browser/editor/page/post.mjs

@@ -1,3 +1,4 @@
+import { workspaceAddress } from "../../shared/workspace-address.mjs";
 import { t, told } from "../../shared/i18n/index.mjs";
 // The page's one way to talk to the preview server: a POST of JSON with the report's token
 // (postJson: the request, a network error rejecting as fetch does; postAnswer: its answer read, a
@@ -5,7 +6,7 @@ import { t, told } from "../../shared/i18n/index.mjs";
 // says (failure) and how an upload carries a file (blobBase64).
 
 /** POST `body` as JSON to `route` with `token` (the map's); resolves with the Response. */
-export const postJson = (route, token, body, { keepalive = false } = {}) => fetch(route, {
+export const postJson = (route, token, body, { keepalive = false } = {}) => fetch(workspaceAddress(route), {
   method: "POST",
   headers: { "Content-Type": "application/json", "X-Gallery-Token": token },
   body: JSON.stringify(body),

package/browser/editor/page/present-links.mjs

@@ -1,8 +1,9 @@
+import { workspaceAddress } from "../../shared/workspace-address.mjs";
 import { t } from "../../shared/i18n/index.mjs";
 import { addressOn, elsewhere, fromFile, isPageAddress, mayBePage, pageAddress, workbenchHash } from "../../shared/page-address.mjs";
 import { inTrash, linkedPages, pageLinks } from "../../shared/page-links.mjs";
 import { entryOfKey } from "../../shared/extension-sidebar.mjs";
-import { SHELL, tell } from "./present-shell.mjs";
+import { tell } from "./present-shell.mjs";
 
 // The links of a page shown in 演示视图 (?present: src/server/routes.mjs), which has no editor and whose
 // frame the presentation holds (src/workbench/app/features/present/). A link to a document or a block
@@ -21,11 +22,11 @@ import { SHELL, tell } from "./present-shell.mjs";
 
 const own = pageAddress(location.href)?.slug ?? null;
 const openTab = (address) => window.open(address, "_blank", "noopener");
-const read = (route) => fetch(`/__gallery/workspace/${route}`).then((answer) => answer.json()).catch(() => null);
+const read = (route) => fetch(workspaceAddress(`/__gallery/workspace/${route}`)).then((answer) => answer.json()).catch(() => null);
 
 function go({ slug, block }) {
   const fragment = block ? `#${encodeURIComponent(block)}` : "";
-  if (slug !== own) location.assign(`/generated/${slug}.html?present${SHELL ? `&shell=${encodeURIComponent(SHELL)}` : ""}${fragment}`); // a draft's presentation keeps the workbench around it (present-shell.mjs)
+  if (slug !== own) location.assign(workspaceAddress(`/generated/${slug}.html?present${fragment}`)); // a draft's presentation keeps the workbench around it (present-shell.mjs)
   else if (block) dispatchEvent(new CustomEvent("doc-jump-request", { detail: { hash: fragment } })); // the kit's jump, a step of the history as a link #<block id> is
 }
 

package/browser/editor/page/present-shell.mjs

@@ -1,63 +1,8 @@
 import { pageAddress } from "../../shared/page-address.mjs";
-import { KEEPS_KEYS, stepSection } from "../../shared/present-step.mjs";
-import { PROTOCOL, PROTOCOLS, VERSION } from "../../shared/session.mjs";
+import { PROTOCOL, VERSION } from "../../shared/session.mjs";
 
-// What a page shown in 演示视图 (?present: src/server/routes.mjs, no editor) says to the presentation around it and
-// hears from it. The presentation of a document of this workspace is a frame of the same origin, which it reaches into (its
-// scroll, its keys, its theme); that of a draft of another workspace (docs/workbench.md "Drafts of other workspaces") is a frame
-// of that workspace's server, named by the page's address (?shell=<the workbench's origin>) as the editor's page names it
-// (session.mjs): this page then asks its own server whether that is a Gallery server of this computer (GET
-// /__gallery/workspace/shell) and talks to it alone once it is, holding what it says until then; one that is not hears nothing.
-// It tells where the page is scrolled (`present-view`: { x, y }, with `ready` once the page can be spoken to) and the keys pressed
-// in it that are the presentation's (`present-key`: { key, ctrlKey, metaKey, altKey, kept (a control holds the key), prevented }),
-// and does what it is asked: `theme` (the workbench's, light or dark), `go-section` (上一节 / 下一节) and `scroll` ({ left, top }: the wheel). Every message is the session
-// protocol's envelope (src/shared/session.mjs).
-
-/** The origin of a workbench of another origin showing this page (?shell=<origin>), or null: this one's. */
-export const SHELL = (() => {
-  const named = new URLSearchParams(location.search).get("shell");
-  return named && named !== location.origin ? named : null;
-})();
-
-const vouched = (origin) => fetch(`/__gallery/workspace/shell?origin=${encodeURIComponent(origin)}`, { cache: "no-store" })
-  .then((answer) => answer.json()).then((answer) => answer?.shell === true, () => false);
-
-let parentOrigin = SHELL ? null : location.origin;
-let held = SHELL ? [] : null;
-
-/** Tell the presentation around the page (`window.parent`) something; held until its origin is vouched for, dropped when it is not. */
+// Presentations and their documents share one origin; links may notify their parent.
 export function tell(type, fields = {}) {
   if (window.parent === window) return;
-  if (held) return void held.push([type, fields]);
-  if (!parentOrigin) return;
-  window.parent.postMessage({ protocol: PROTOCOL, v: VERSION, type, slug: pageAddress(location.href)?.slug ?? "", ...fields }, parentOrigin);
-}
-
-function bridge() {
-  let frame = 0;
-  const view = (ready = false) => tell("present-view", { x: scrollX, y: scrollY, ...(ready ? { ready: true } : {}) });
-  addEventListener("scroll", () => { frame ||= requestAnimationFrame(() => { frame = 0; view(); }); }, { passive: true });
-  addEventListener("keydown", (event) => {
-    if (event.isComposing) return;
-    tell("present-key", { key: event.key, ctrlKey: event.ctrlKey, metaKey: event.metaKey, altKey: event.altKey, kept: Boolean(event.target?.closest?.(KEEPS_KEYS)), prevented: event.defaultPrevented });
-  });
-  addEventListener("message", (event) => {
-    const message = event.data;
-    if (event.source !== window.parent || event.origin !== parentOrigin || !PROTOCOLS.includes(message?.protocol) || message.v !== VERSION || message.type !== "command") return;
-    if (message.name === "theme") dispatchEvent(new CustomEvent("doc-theme-request", { detail: { theme: message.theme === "dark" ? "dark" : "light" } })); // the kit's ui.js
-    else if (message.name === "go-section") stepSection(window, message.direction > 0 ? 1 : -1);
-    else if (message.name === "scroll") scrollBy({ left: Number(message.left) || 0, top: Number(message.top) || 0 }); // the wheel over the presentation's ink
-  });
-  view(true);
-}
-
-if (SHELL && window.parent !== window) {
-  vouched(SHELL).then((ok) => {
-    const waiting = held;
-    held = null;
-    if (!ok) return;
-    parentOrigin = SHELL;
-    for (const [type, fields] of waiting) tell(type, fields);
-    bridge();
-  });
+  window.parent.postMessage({ protocol: PROTOCOL, v: VERSION, type, slug: pageAddress(location.href)?.slug ?? "", ...fields }, location.origin);
 }

package/browser/editor/page/session.mjs

@@ -5,15 +5,7 @@ import { lookOf, lookOfElement } from "../../shared/document-look.mjs";
 // tells the workbench its state, never the report's content. Nothing happens when the page is not
 // embedded. The protocol is src/shared/session.mjs; how a workbench uses it, docs/workbench.md.
 //
-// A workbench of another workspace shows a draft of this one from its own origin (docs/workbench.md
-// "Drafts of other workspaces"), naming that origin in the frame's address (?shell=<origin>): the page
-// then asks its own server whether that is a Gallery server of this computer (GET
-// /__gallery/workspace/shell: on the registry, running, its token and process as it announces them),
-// and talks to it alone once it is, holding what it says until then; one that is not hears nothing and
-// is heard by nothing, so that no other page of this computer drives a document by framing it. Going,
-// such a page says `bye` (the workbench of another origin cannot see it go).
-//
-// A message counts only from the parent window, of this origin (or the shell's, vouched for) and protocol. A command names the
+// A message counts only from the parent window, of this exact origin and protocol. A command names the
 // report it is meant for: one for another report (the iframe went to another page meanwhile) is
 // refused. Every command gets exactly one reply, once it is done. Besides the editor's commands the
 // session itself answers five: `theme` (show the report light or dark, or as the reader chose, without
@@ -27,16 +19,6 @@ import { lookOf, lookOfElement } from "../../shared/document-look.mjs";
 
 /** A page opened in a frame on its own (?solo), not as the workbench's report: no session, its own notices. */
 export const SOLO = new URLSearchParams(location.search).has("solo");
-/** The origin of a workbench of another workspace showing this page (?shell=<origin>), or null: this one's. */
-const SHELL = (() => {
-  const named = new URLSearchParams(location.search).get("shell");
-  return named && named !== location.origin ? named : null;
-})();
-
-// Whether this page's server vouches for the workbench at `origin` (GET /__gallery/workspace/shell).
-const vouched = (origin) => fetch(`/__gallery/workspace/shell?origin=${encodeURIComponent(origin)}`, { cache: "no-store" })
-  .then((answer) => answer.json()).then((answer) => answer?.shell === true, () => false);
-
 /**
  * slug: the report's; snapshot(): { title, state } (state: STATE_FLAGS of src/shared/session.mjs);
  * commands: name -> async (message) => result ({ ok, … }); modals: what stands open over the page
@@ -56,27 +38,11 @@ const vouched = (origin) => fetch(`/__gallery/workspace/shell?origin=${encodeURI
 export function connectWorkbench({ slug, snapshot, commands, modals }) {
   if (window.parent === window || SOLO) return null;
   centreCards(modals);
-  // The workbench's origin: this one's, or the shell's once this page's server vouched for it (null till
-  // then: what the page says is held, and is dropped when it does not).
-  let parentOrigin = SHELL ? null : location.origin;
-  let held = SHELL ? [] : null;
-  if (SHELL) {
-    vouched(SHELL).then((ok) => {
-      const waiting = held;
-      held = null;
-      if (!ok) return;
-      parentOrigin = SHELL;
-      for (const [type, fields, protocols] of waiting) send(type, fields, protocols);
-      // A workbench of another origin sees no pagehide of this page: it is told.
-      addEventListener("pagehide", () => send("bye", {}), { once: true });
-    });
-  }
+  const parentOrigin = location.origin;
   // The id the workbench speaks (src/shared/session.mjs, OLD_PROTOCOL): null until its first command,
   // and meanwhile every message goes under both, so that a workbench of either version hears it.
   let spoken = null;
   const send = (type, fields, protocols = spoken ? [spoken] : [PROTOCOL, OLD_PROTOCOL]) => {
-    if (held) return void held.push([type, fields, protocols]);
-    if (!parentOrigin) return;
     for (const protocol of protocols) window.parent.postMessage({ protocol, v: VERSION, type, slug, ...fields }, parentOrigin);
   };
   let last = null;
@@ -141,7 +107,7 @@ export function connectWorkbench({ slug, snapshot, commands, modals }) {
 
   addEventListener("message", async (event) => {
     const message = event.data;
-    if (event.source !== window.parent || !parentOrigin || event.origin !== parentOrigin) return;
+    if (event.source !== window.parent || event.origin !== parentOrigin) return;
     if (!PROTOCOLS.includes(message?.protocol) || message.v !== VERSION || message.type !== "command") return;
     spoken = message.protocol;
     const run = Object.hasOwn(all, message.name) ? all[message.name] : null;

package/browser/editor/page/storage.mjs

@@ -4,11 +4,11 @@
 // and the page works without (a list used lately is then kept for the page's life only).
 
 /** A storage area (`area()`: localStorage or sessionStorage) whose calls never throw. */
-export const storageOf = (area) => ({
-  get(key) { try { return area().getItem(key); } catch { return null; } },
-  set(key, value) { try { area().setItem(key, value); return true; } catch { return false; } },
-  remove(key) { try { area().removeItem(key); } catch {} },
-  keys() { try { return Object.keys(area()); } catch { return []; } },
+export const storageOf = (area, { prefix = "" } = {}) => ({
+  get(key) { try { return area().getItem(prefix + key); } catch { return null; } },
+  set(key, value) { try { area().setItem(prefix + key, value); return true; } catch { return false; } },
+  remove(key) { try { area().removeItem(prefix + key); } catch {} },
+  keys() { try { return Object.keys(area()).filter(key => key.startsWith(prefix)).map(key => key.slice(prefix.length)); } catch { return []; } },
 });
 
 /** localStorage, safe. */

package/browser/shared/component-catalog.mjs

@@ -11,7 +11,7 @@ import { attr, walk } from "./html-tree.mjs";
 import { HOST, NET, netHostsOf } from "./net-policy.mjs";
 import { inLanguage, refusal, said, saying, told } from "./i18n/index.mjs";
 import { DEFAULT_PACK, OWN_SCOPE, PACK_FILE, PACK_ID, readPackManifest } from "./pack-manifest.mjs";
-import { DEVICE_NAMES, PACKAGE_MANIFEST, WORKSPACE_MARK, findWorkspace, layoutOf, markerOf, packageFolders } from "./workspace.mjs";
+import { DEVICE_NAMES, PACKAGE_MANIFEST, WORKSPACE_MARK, defaultWorkspace, layoutOf, markerOf, packageFolders } from "./workspace.mjs";
 
 // 组件包, custom blocks (自定义块) as the UI and the Agent's documents call them: what the workspace's
 // component packages say of themselves to Gallery, read from
@@ -466,7 +466,7 @@ function readPackage(id, folder) {
   }
 }
 
-const workspaceRoot = () => findWorkspace().root;
+const workspaceRoot = () => defaultWorkspace();
 
 // A file edited by hand holds what it holds: of its lists, what can be an id is read, once each, and
 // the rest is passed over, one that names nothing there doing nothing. An id may be of a package that

package/browser/shared/document-copy.mjs

@@ -0,0 +1,43 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { parse } from "parse5";
+import { attr, walk } from "./html-tree.mjs";
+import { escapeAttribute } from "./escape.mjs";
+import { newNames } from "./new-names.mjs";
+import { COMPONENTS_FOLDER, DOCUMENT_FOLDERS, SHARED_FOLDERS, documentFiles, packageFolders, readLink } from "./workspace.mjs";
+
+/** Files belonging to a document, excluding packages/pages sharing a legacy reserved folder. */
+export async function documentNames(root, slug) {
+  const entries = await fs.readdir(path.join(root, slug), { withFileTypes: true });
+  if (!SHARED_FOLDERS.includes(slug)) return entries.map(({ name }) => name);
+  const scopes = slug === COMPONENTS_FOLDER ? new Set(packageFolders(root).map(({ id }) => id.split("/")[0])) : new Set();
+  return entries.filter(entry => entry.isFile() || (DOCUMENT_FOLDERS.includes(entry.name) && !scopes.has(entry.name))).map(({ name }) => name);
+}
+
+/** Same copy primitive for duplicate and cross-workspace copy: local assets and metadata stay intact. */
+export async function copyEntryFiles(root, slug, destination, copy, { names = new Map() } = {}) {
+  const source = path.join(root, slug);
+  const document = await fs.access(documentFiles(source).html).then(() => true, () => false);
+  const link = document ? null : await readLink(source);
+  const own = new Set(["", ...(await documentNames(root, slug))]);
+  await fs.cp(source, destination, { recursive: true, errorOnExist: true, force: false, filter: from => own.has(path.relative(source, from).split(path.sep)[0]) });
+  if (link) return [];
+  const file = documentFiles(destination).html;
+  const html = await fs.readFile(file, "utf8");
+  const text = newNames(html);
+  const edits = new Map(), packages = new Set();
+  walk(parse(text.replace(/^\uFEFF/, " "), { sourceCodeLocationInfo: true }), node => {
+    const component = attr(node, "data-doc-component");
+    if (component) packages.add(component);
+    for (const { name, value } of node.attrs ?? []) {
+      const at = node.sourceCodeLocation?.attrs?.[name];
+      if (!at) continue;
+      const relative = /^(\.\.\/)([a-z0-9]+(?:-[a-z0-9]+)*)(\/.*)$/.exec(value);
+      const next = name === "data-doc-id" && value === slug ? copy : ["href", "src", "poster"].includes(name) && relative && names.has(relative[2]) ? `../${names.get(relative[2])}${relative[3]}` : value;
+      if (next !== value) edits.set(at.startOffset, { to: at.endOffset, text: `${name}="${escapeAttribute(next)}"` });
+    }
+  });
+  const next = [...edits].sort(([a], [b]) => b - a).reduce((text, [from, edit]) => text.slice(0, from) + edit.text + text.slice(edit.to), text);
+  await fs.writeFile(file, next);
+  return [...packages];
+}