@heycys/gallery 0.1.2 → 0.2.0

package/browser/editor/page/typing/leave.mjs

@@ -14,6 +14,8 @@ import { BLOCK_TYPES, LEAVES_BY_ENTER, accepts } from "../../components/registry
 //     too) moves out after the box, which goes if nothing is left in it (`leaveBox`).
 //   - A block of a type that says `resettable` (a quote's paragraph, a list item) turns into a
 //     paragraph where it stands, its container splitting around it (convert.mjs).
+//   - Backspace in an empty block of a type that says `emptyToText` (a heading, small text) turns it
+//     into an empty paragraph where it stands (`emptied`; the user's, 2026-11-09).
 // Enter in a title that goes into its content (a disclosure, a card, a code block) is another rule
 // (their components').
 
@@ -36,8 +38,10 @@ export function leaveBox(host) {
  * and touchedBy (a structural undo step), convertHost, typeOf and targetsOf (convert.mjs).
  */
 export function createLeaving({ struct, touchedBy, convertHost, typeOf, targetsOf }) {
-  // A block of a type that resets, which can be body text where it stands.
-  const resets = (host) => BLOCK_TYPES[typeOf(host)]?.resettable === true && targetsOf(host).includes("paragraph");
+  // A block of a type that says `field` (resettable, emptyToText), which can be body text where it stands.
+  const says = (host, field) => BLOCK_TYPES[typeOf(host)]?.[field] === true && targetsOf(host).includes("paragraph");
+  const resets = (host) => says(host, "resettable");
+  const toText = (host) => convertHost(host, "paragraph");
 
   // Enter on an empty text block. True when it left its container or became text.
   function enter(host) {
@@ -52,7 +56,7 @@ export function createLeaving({ struct, touchedBy, convertHost, typeOf, targetsO
       return true;
     }
     if (!resets(host)) return false;
-    convertHost(host, "paragraph");
+    toText(host);
     return true;
   }
 
@@ -60,9 +64,19 @@ export function createLeaving({ struct, touchedBy, convertHost, typeOf, targetsO
   // quote's first paragraph), turns into body text before the container. True when it did.
   function backspace(host) {
     if (!resets(host) || host.parentElement?.firstElementChild !== host) return false;
-    convertHost(host, "paragraph");
+    toText(host);
     return true;
   }
 
-  return { enter, backspace };
+  // Backspace in an empty text block of a type that says `emptyToText` (a heading, small text): it turns
+  // into an empty paragraph where it stands, the caret in it, one undo step (the user's, 2026-11-09: as an
+  // emptied item or quote paragraph, and as every container left empty, goes back to body text). True
+  // when it did.
+  function emptied(host) {
+    if (!isEmpty(host) || !says(host, "emptyToText")) return false;
+    toText(host);
+    return true;
+  }
+
+  return { enter, backspace, emptied };
 }

package/browser/shared/block-packs.mjs

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { componentSettings, problemIn, writeComponentSettings } from "./component-catalog.mjs";
 import { refusal, said } from "./i18n/index.mjs";
-import { PACK_FILE, PACK_ID, readPackManifest } from "./pack-manifest.mjs";
+import { DEFAULT_PACK, OWN_SCOPE, PACK_FILE, PACK_ID, readPackManifest } from "./pack-manifest.mjs";
 import { packsDirectory } from "./paths.mjs";
 import { filesIn, fingerprintOf, fingerprintOfFiles, isSystemFile, recordOf, shippedBlocks, shippedPackIds, versionAfter, writeRecord, writingOrder } from "./shipped-blocks.mjs";
 import { DEVICE_NAMES, PACKAGE_MANIFEST, layoutOf, markerOf, packageFolders } from "./workspace.mjs";
@@ -10,8 +10,9 @@ import { DEVICE_NAMES, PACKAGE_MANIFEST, layoutOf, markerOf, packageFolders } fr
 // Block packs (自定义块包: notes/plans/block-packs-plan-2026-11-09.md; docs/render.md "Block packs"). A pack
 // is a scope of the workspace's custom blocks, components/<id>/, with its pack.json (./pack-manifest.mjs)
 // and a folder of each of its blocks, <id>/<name>/, the blocks' ids <id>/<name> as ever, so that nothing
-// written of a block changes; a scope with no pack.json (local/, the Agent's own) is a pack of its own,
-// named by its scope. A pack is shared as its folder, or a zip of it (the folder itself, or what it
+// written of a block changes; a scope with no pack.json is a pack of its own, named by its scope, and
+// local/ (OWN_SCOPE: gallery block new <name>'s, where an Agent's block goes when it names no pack) is the
+// default pack (默认块包, pack-manifest.mjs DEFAULT_PACK), always listed, first. A pack is shared as its folder, or a zip of it (the folder itself, or what it
 // holds, at the zip's top), and installed into a workspace by gallery block pack install (src/cli/component.mjs)
 // or 设置 › 组件列表's 导入 (src/server/component-settings.mjs), which both read it (src/transfer/pack-source.mjs)
 // and hand its files here, checked alike:
@@ -43,6 +44,18 @@ import { DEVICE_NAMES, PACKAGE_MANIFEST, layoutOf, markerOf, packageFolders } fr
 /** Gallery's own packs that a workspace has switched off when they are first installed. */
 export const OFF_AT_FIRST = Object.freeze(["gallery-soft"]);
 
+/**
+ * The ids of Gallery's own packs that are off though gallery.json names no switch for them: one off at first
+ * (OFF_AT_FIRST) that this workspace has not installed yet, which its first install will switch off. A
+ * start that installs none (NO_PACKS, a workspace made by hand) has the library offer Gallery's own blocks
+ * from the package, and a pack that is off when it comes in is not one of them. `switches` is the catalog
+ * settings' `packs` (true on, false off, by id).
+ */
+export function offUntilInstalled(root, switches = {}) {
+  const installed = recordOf(root).packs;
+  return OFF_AT_FIRST.filter((id) => switches?.[id] === undefined && !isTable(installed?.[id]));
+}
+
 /** The environment variable that keeps a start (and gallery init) from installing Gallery's own packs: the tests' workspaces. */
 export const NO_PACKS = "GALLERY_NO_PACKS";
 
@@ -285,14 +298,16 @@ const both = (problem) => ({ zh: problemIn("zh", problem), en: problemIn("en", p
  * switch, gallery.json's components.packs), changed (of what was installed, the blocks changed since, and
  * pack.json where it was), newer (of one of Gallery's own that was changed since, Gallery's version of it
  * when that comes after the one installed, which is not put over it; else null) }]: Gallery's own first,
- * then those installed, then the workspace's own, each by id.
+ * then those installed, then the workspace's own, each by id; and before them all the default pack (local/,
+ * OWN_SCOPE: kind "default", named and described by DEFAULT_PACK, its switch as any pack's), whether or
+ * not it holds a block yet: where an Agent's block goes when it names no pack.
  */
 export function workspacePacks(root, { settings = null, shippedIds = shippedPackIds(), directory = packsDirectory } = {}) {
   const { components } = layoutOf(root);
   const record = recordOf(root);
   const installed = isTable(record.packs) ? record.packs : {};
   const blocks = packageFolders(root);
-  const scopes = new Set(blocks.map(({ id }) => id.split("/")[0]));
+  const scopes = new Set([OWN_SCOPE, ...blocks.map(({ id }) => id.split("/")[0])]);
   try {
     for (const name of fs.readdirSync(components)) if (PACK_ID.test(name) && fs.existsSync(path.join(components, name, PACK_FILE))) scopes.add(name);
   } catch {}
@@ -336,7 +351,7 @@ export function workspacePacks(root, { settings = null, shippedIds = shippedPack
     const ownBlocks = official ? shippedBlocks(directory) : [];
     const behind = official && shipped && changed.some((block) => (block.endsWith(`/${PACK_FILE}`) ? versionAfter(shipped.version, manifest?.version ?? null) : (ownBlocks.some((one) => one.id === block) && versionAfter(ownBlocks.find((one) => one.id === block).version, versionAt(block)))));
     const newer = behind ? shipped.version : null;
-    const told = manifest ?? (problem ? null : shipped);
+    const told = id === OWN_SCOPE ? DEFAULT_PACK : manifest ?? (problem ? null : shipped);
     return {
       id,
       name: told?.name ?? { zh: id, en: id },
@@ -345,7 +360,7 @@ export function workspacePacks(root, { settings = null, shippedIds = shippedPack
       author: told?.author ?? null,
       homepage: told?.homepage ?? null,
       icon: told?.icon ?? null,
-      kind: official ? "official" : was ? "installed" : "own",
+      kind: id === OWN_SCOPE ? "default" : official ? "official" : was ? "installed" : "own",
       problem: problem ? both(problem) : null,
       blocks: ids.length,
       enabled: switches[id] !== false,
@@ -353,7 +368,7 @@ export function workspacePacks(root, { settings = null, shippedIds = shippedPack
       newer,
     };
   });
-  const rank = ({ id, kind }) => (kind === "official" ? shippedIds.indexOf(id) : kind === "installed" ? 1000 : 2000);
+  const rank = ({ id, kind }) => (kind === "default" ? -1 : kind === "official" ? shippedIds.indexOf(id) : kind === "installed" ? 1000 : 2000);
   return listed.sort((a, b) => rank(a) - rank(b) || (a.id < b.id ? -1 : 1));
 }
 

package/browser/shared/component-catalog.mjs

@@ -10,7 +10,7 @@ import { writeAtomic } from "./files.mjs";
 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 { PACK_FILE, PACK_ID, readPackManifest } from "./pack-manifest.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";
 
 // 组件包, custom blocks (自定义块) as the UI and the Agent's documents call them: what the workspace's
@@ -64,7 +64,7 @@ const PLACES = ["document", "page"];
 const DOCUMENT_ONLY = ["document"];
 // What `card` says of a card on a board, in cells of the grid: a row is 12 of them, and a card at most
 // 24 high.
-const CARD_FIELDS = ["sizes", "w", "h", "min", "max", "resize", "fit", "bare"];
+const CARD_FIELDS = ["sizes", "w", "h", "min", "max", "resize", "fit", "bare", "consent"];
 const GRID = { w: 12, h: 24 };
 const FITS = ["fixed", "content"];
 const NO_CARD = { sizes: null, any: false, w: 4, h: null, min: { w: 1, h: 1 }, max: { ...GRID }, resize: false, fit: "fixed", bare: false };
@@ -268,7 +268,9 @@ function placesOf(places) {
 // the fewest whole cells its content takes). With `sizes`, the first is the default, and no w or h is
 // written beside them; a min or a max beside them frees the card (`any`): the sizes are the common ones
 // its 大小 menu lists, any whole size between min and max is its too (resizing by the corner, a place),
-// and each of the sizes stands inside them.
+// and each of the sizes stands inside them. `consent` ({ zh, en }, where it says one) is what the kit's
+// banner on its card says while it waits for the reader to let it online (允许联网之后显示天气), in place of
+// the kit's own line (允许联网之后显示内容).
 function cardOf(card) {
   if (card === undefined) return NO_CARD;
   if (!isTable(card)) fail(said("{0} 要写成一张表", "card"));
@@ -307,12 +309,14 @@ function cardOf(card) {
   }
   for (const flag of ["resize", "bare"]) if (card[flag] !== undefined && typeof card[flag] !== "boolean") fail(said("{0} 要写成 true 或 false", `card.${flag}`));
   if (card.fit !== undefined && !FITS.includes(card.fit)) fail(said("card.fit 只能是 fixed 或 content"));
+  if (card.consent !== undefined) bothLanguages(card.consent, "card.consent");
   return {
     sizes: card.sizes ? card.sizes.map(([width, height]) => [width, height]) : null,
     any, w, h, min, max,
     resize: card.resize ?? false,
     fit: card.fit ?? "fixed",
     bare: card.bare ?? false,
+    ...(card.consent !== undefined ? { consent: { zh: card.consent.zh, en: card.consent.en } } : {}),
   };
 }
 
@@ -635,7 +639,8 @@ export function readCatalog(root = workspaceRoot(), held = NO_SETTINGS, { on = n
 /**
  * What the pack.json of each scope of `scopes` (and of each folder of components/ that holds one) names
  * it: a Map, by scope, of { zh, en }, or null where it has none or one that does not read (a scope of
- * blocks with no pack.json is a pack of its own by its scope's name: ./block-packs.mjs).
+ * blocks with no pack.json is a pack of its own by its scope's name, the default pack, local/, by its own:
+ * ./pack-manifest.mjs DEFAULT_PACK, ./block-packs.mjs).
  */
 export function packNames(root, scopes = []) {
   const { components } = layoutOf(root);
@@ -647,7 +652,7 @@ export function packNames(root, scopes = []) {
   for (const scope of [...new Set([...scopes, ...withFile])].sort()) {
     let name = null;
     try {
-      name = readPackManifest(readFileSync(path.join(components, scope, PACK_FILE), "utf8")).name;
+      name = scope === OWN_SCOPE ? DEFAULT_PACK.name : readPackManifest(readFileSync(path.join(components, scope, PACK_FILE), "utf8")).name;
     } catch {}
     names.set(scope, name);
   }
@@ -687,9 +692,9 @@ const stateOf = (found, settings) => (found.problem ? (found.disabled ? "disable
  * What the kit is told of a package: where its instances are, its parts, what it leaves on a page, how far
  * its content's shape goes, and what it uses (`needs`, where it names any: the kit gives an instance
  * context.workspace for "workspace", context.fetch for a host of the net and context.table() for
- * "tables").
+ * "tables"), and the line its card's consent banner says (`consent`, its card's, where it says one).
  */
-export const descriptionOf = ({ id, match, parts, runtime, schema, needs }) => ({ id, match, parts, ...(runtime ? { runtime } : {}), ...(schema !== undefined ? { schema } : {}), ...(needs?.length ? { needs } : {}) });
+export const descriptionOf = ({ id, match, parts, runtime, schema, needs, card }) => ({ id, match, parts, ...(runtime ? { runtime } : {}), ...(schema !== undefined ? { schema } : {}), ...(needs?.length ? { needs } : {}), ...(card?.consent ? { consent: card.consent } : {}) });
 
 /**
  * What the kit is told of a catalog, each by DocKit.describe, the one way a page learns a package's
@@ -786,7 +791,8 @@ export const templateOf = (found) => readTemplate(found).markup ?? null;
  * no route and no dynamic import. One entry for each package that loads, by id: { id, version, name:
  * { zh, en }, description: { zh, en }, words, definition, stamp, template (the markup "/" puts in: one
  * instance of it, or null), preview (the address of its picture, or null), state ("normal", or "hidden": a menu offers what is "normal" and reads no setting), places (which the page's
- * settingState reads with gallery.json's lists as its event stream says them), needs, markdown, assets (the kit's files it asks for,
+ * settingState reads with gallery.json's lists as its event stream says them), needs, settings (the fields of its 设置 form, a
+ * manifest's `settings`, [] where it has none), markdown, assets (the kit's files it asks for,
  * by id), tags (packageTags: what loads it in a page that was served without it, the line that tells the
  * kit of its parts among them), pack ({ id, name }: the pack it is of, its scope, and what its pack.json names
  * it, null where none does: a menu writes the pack's name after a block's in grey where two packs offer
@@ -806,6 +812,7 @@ export const menuOf = ({ packages, settings = NO_SETTINGS, packs = new Map() })
   state: stateOf(found, settings),
   places: found.places,
   needs: found.needs,
+  settings: found.settings,
   markdown: found.markdown,
   assets: found.assets,
   tags: packageTags(found),

package/browser/shared/component-source.mjs

@@ -16,7 +16,7 @@ export const SOURCE_ATTRIBUTES = ["data-checked", "rowspan", "colspan", "data-so
 
 /**
  * The classes that are a block's or a cell's look, which a reader sets and the file keeps: a text color
- * or a fill (doc-text-<color>, doc-highlight-<color>), a cell's alignments and its bold (table.mjs's
+ * or a fill (doc-text-<color>, doc-highlight-<color>), a text block's alignment and indent (a table's frame's alignment is the same two classes), a cell's alignments and its bold (table.mjs's
  * CELL_ALIGN_CLASSES, CELL_VALIGN_CLASSES, CELL_BOLD_CLASS, the editor's CELL_LOOKS). What the kit and
  * the editor toggle as they lay a page out (a table's number and doc-table--auto, a code block's
  * folds) is none, so that no component hears its own layout as a change of the file, and draws again
@@ -28,6 +28,8 @@ export const LOOK_CLASSES = new Set([
   // file would bring its description, prose and all, into the kit's runtime (tests/unit/installed.mjs
   // holds the two lists together).
   "doc-align-left", "doc-align-center", "doc-align-right", "doc-valign-top", "doc-valign-middle", "doc-valign-bottom", "doc-bold",
+  // A paragraph's or a heading's indent (the editor's components/align.mjs INDENTS; its alignment is a cell's classes above).
+  ...Array.from({ length: 8 }, (_, index) => `doc-indent-${index + 1}`),
 ]);
 
 /** Whether a class attribute's look classes (LOOK_CLASSES) differ from `before` to `after`, either null for none. */

package/browser/shared/components/heading.mjs

@@ -1,4 +1,5 @@
-// A heading, levels 1 to 4 (the fourth body-sized): a basic block.
+// A heading, levels 1 to 4 (the fourth body-sized): a basic block. Aligned and indented as a paragraph
+// is (paragraph.mjs TEXT_ALIGN_CLASSES, described there and by the table).
 export default {
   id: "heading",
   category: "block",

package/browser/shared/components/installed.mjs

@@ -124,7 +124,7 @@ export const PACKAGE_MARK = "data-doc-package";
 export const ARRIVING = "data-ge-arriving";
 
 /**
- * Whether the document's insert entries ("/", 在下方新建, the handle's grid, a table's 视图 ›) offer the
+ * Whether the document's insert entries ("/", 在下方新建, the handle's grid) offer the
  * block `id` whose manifest's `places` are those (left out: ["document"]), by gallery.json's lists
  * (`settings`: hidden, shown, disabled, unlisted, packsOff, each left out for none): one that says it stands in a
  * document is offered unless hidden; one that does not, only where shown; one disabled never, as it does

package/browser/shared/components/page.mjs

@@ -47,6 +47,8 @@ export default {
     // a copy of the view keeps; never written in doc.html.
     state: { html: ["data-doc-theme", ...Object.values(LOOK_ATTRIBUTES)] },
     internal: ["doc-display*", "data-doc-export-copy", "data-theme", "doc-export-id", "doc-reveal", "doc-kit-error", "doc-net-consent*", "data-doc-snapshot",
+      // A consent bar on a card under 240px of content (runtime/net.js), its line over its button.
+      "data-doc-net-narrow",
       // The time an export's snapshot was made (its data-doc-snapshot tag's: render/net-snapshot.mjs), which context.workspace.query answers as `at`.
       "data-at",
       // A custom page's (no document's: src/render/page-html.mjs, the kit's board/): its cards' cells, the Agent's

package/browser/shared/components/paragraph.mjs

@@ -1,9 +1,16 @@
 // A paragraph (文本), or small text (小字, p.doc-note): a basic block. Small text may end in a part at
 // the line's right end (span.doc-tab: the page editor's Tab).
+
+/**
+ * A paragraph's or a heading's alignment and indent (the page editor's 对齐与缩进): centred or at the
+ * right (left is neither), moved in by levels of two body characters (styles/flow.css).
+ */
+export const TEXT_ALIGN_CLASSES = ["doc-align-center", "doc-align-right", ...Array.from({ length: 8 }, (_, index) => `doc-indent-${index + 1}`)];
+
 export default {
   id: "paragraph",
   category: "block",
   match: "p",
   tail: ".doc-tab", // small text's end part, a span at the line's right end
-  classes: ["doc-note", "doc-tab"],
+  classes: ["doc-note", "doc-tab", ...TEXT_ALIGN_CLASSES.filter((name) => name.startsWith("doc-indent-"))], // the alignments are the table's (a cell's), the same classes
 };

package/browser/shared/components/table.mjs

@@ -30,6 +30,7 @@ export default {
     "data-number-columns": "off: no column read as numbers (none centered, none sortable by number), on the table or its frame",
     "data-doc-chart-source": "on its frame: the key a chart drawn from it reads it by (data-doc-chart-data on the chart's host)",
   },
+  // The frame may be placed centred or at the right (doc-align-center, doc-align-right, a text block's: the page editor's 对齐 ›).
   // A cell may also be given a text color or a fill (doc-text-*, doc-highlight-*: text.mjs), an alignment, a vertical one and bold
   // (doc-bold); a header row's cell's look is doc-bold doc-highlight-gray, as the page editor gives it (a header column's th scope="row" none).
   classes: ["doc-table", "doc-table-wrap", "doc-table-meta", "doc-table--sticky-first", ...CELL_ALIGN_CLASSES, ...CELL_VALIGN_CLASSES, CELL_BOLD_CLASS],

package/browser/shared/emoji/line-icons.mjs

@@ -0,0 +1,37 @@
+import { ICON_COLOR_VALUES } from "./icon-value.mjs";
+
+// Gallery's own line icons as a custom page's icon (page.json's `icon`): the look of the workbench's sidebar
+// head, whose 新建 and 搜索 are Lucide's line icons (a 1.75 line in 24 units, workbench/app/components/icons.ts),
+// so that a page Gallery makes stands among them in the same hand (the user's word of 2026-11-09: no filled
+// icon there). A value is `/icons/lucide/<name>.svg`, with no color of its own: the workbench masks it in the
+// color of where it stands (the sidebar's icon gray, as an icon of no icon's color), the browser tab draws it
+// in the tab's gray (as a page with no icon, icon-value.mjs DEFAULT_TAB_ICON). It is none of the three kinds
+// of a document's icon (icon-value.mjs iconKind: no document has one), nor an icon of the 图标 tab: Gallery's
+// default home page's house (src/editor/home-page.mjs HOME_ICON), alone so far. The icon route draws it
+// (src/render/emoji.mjs iconImage).
+
+const LINE_ICONS = {
+  // Lucide's house (1.67.0), the one the sidebar drew for the home page before its page.json said its icon.
+  house: '<path d="M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8"/><path d="M3 10a2 2 0 0 1 .709-1.528l7-5.999a2 2 0 0 1 2.582 0l7 5.999A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/>',
+};
+const LINE = /^\/icons\/lucide\/([a-z0-9-]+)\.svg$/;
+
+/** The value of Gallery's line icon `name` (one LINE_ICONS has). */
+export const lineIconValue = (name) => `/icons/lucide/${name}.svg`;
+
+/** Whether `value` names one of Gallery's line icons. */
+export const isLineIcon = (value) => lineIconSvg(value) !== null;
+
+const [TAB_LIGHT, TAB_DARK] = ICON_COLOR_VALUES.gray;
+
+/**
+ * The SVG of the line icon `value` names, or null (none of them): its lines in `color` (black, the
+ * workbench's mask); with `tab`, a browser tab's, its box cropped to `1 1 22 22` as the tab's icon of a
+ * page with no icon is, in the tab glyphs' gray, light or dark as the system is.
+ */
+export function lineIconSvg(value, { color = "currentColor", tab = false } = {}) {
+  const name = typeof value === "string" ? LINE.exec(value)?.[1] : null;
+  if (!name || !Object.hasOwn(LINE_ICONS, name)) return null;
+  const style = tab ? `<style>svg{color:${TAB_LIGHT}}@media (prefers-color-scheme:dark){svg{color:${TAB_DARK}}}</style>` : "";
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${tab ? "1 1 22 22" : "0 0 24 24"}" fill="none" stroke="${tab ? "currentColor" : color}" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">${style}${LINE_ICONS[name]}</svg>`;
+}

package/browser/shared/http.mjs

@@ -1,6 +1,15 @@
 // The local server's answers: JSON for its endpoints (the editor's saves, the workbench's commands),
 // and files for its routes.
 
+// Who may show a page of Gallery's in a frame (its HTML: the workbench, a document, a custom page): a page of
+// its own origin, and a Gallery server of this computer, http://127.0.0.1 at any port (a workbench showing a
+// draft of another workspace from that workspace's server, docs/workbench.md "Drafts of other workspaces";
+// what such a frame may say and hear is still held to the servers vouched for). Never a site elsewhere, which
+// could lay an editable page under a decoy, the reader's clicks and keys then editing the files (the security
+// review of 0.2.0), nor localhost, which may lead to another program on [::1] (no workbench is shown there:
+// src/server/routes.mjs toLoopback).
+export const FRAMED_BY = { "Content-Security-Policy": "frame-ancestors 'self' http://127.0.0.1:*" };
+
 // A JSON answer.
 export function sendJson(response, status, body) {
   response.statusCode = status;

package/browser/shared/i18n/en.mjs

@@ -383,7 +383,7 @@ export default {
   "不加载它的脚本和样式，已有的块只显示内容": "Its script and style aren't loaded. Existing blocks show only what they hold",
   "文档菜单里出现哪些块，这个工作区加载哪些自定义块。": "Which blocks the document menus offer, and which custom blocks this workspace loads.",
   "文档菜单里出现哪些块，这个工作区加载哪些自定义块": "Which blocks the document menus offer, and which custom blocks this workspace loads",
-  "块包的开关关掉后，它的块都不在 “/”、添加自定义块和表格的「视图」里；已经写在文档和页面里的块照常显示。": "With a pack's switch off, none of its blocks is offered in “/”, Add custom block or a table's Views; those already in documents and pages show as ever.",
+  "块包的开关关掉后，它的块都不在 “/”和添加自定义块里；已经写在文档和页面里的块照常显示。": "With a pack's switch off, none of its blocks is offered in “/” or Add custom block; those already in documents and pages show as ever.",
   "打开块包「{0}」": "Open the pack “{0}”",
   "{0} 个块": "{0} blocks",
   "启用块包": "Pack on",
@@ -391,18 +391,18 @@ export default {
   "Gallery 自带": "Gallery's own",
   "工作区自己写的块": "This workspace's own blocks",
   "pack.json 读不出来：{0}": "pack.json can't be read: {0}",
-  "这个块包关着：它的块都不在 “/”、添加自定义块和表格的「视图」里；已经写在文档和页面里的块照常显示。": "This pack is off: none of its blocks is offered in “/”, Add custom block or a table's Views; those already in documents and pages show as ever.",
+  "这个块包关着：它的块都不在 “/”和添加自定义块里；已经写在文档和页面里的块照常显示。": "This pack is off: none of its blocks is offered in “/” or Add custom block; those already in documents and pages show as ever.",
   "这个块包装上后改过（{0}），Gallery 的新版本 {1} 不会换上改过的部分；没改过的块照常更新。": "This pack was changed after it was installed ({0}): Gallery's new version {1} is not put over what changed; the blocks not changed are updated as ever.",
   "这个块包装上后改过（{0}）：再装一次新版本时，改过的部分保持不变。": "This pack was changed after it was installed ({0}): installing a new version keeps what changed as it is.",
   "这个块包里还没有块。": "This pack has no blocks yet.",
   "已导入块包「{0}」{1}": "Imported the pack “{0}” {1}",
   "块包「{0}」已更新到 {1}": "The pack “{0}” is updated to {1}",
   "块包「{0}」{1} 已经装好了": "The pack “{0}” {1} is installed already",
-  "自定义块按块包放：每个块包右边的开关管它的块在 “/”、添加自定义块和表格的「视图」里提不提供；点一个块包看它的块。": "Custom blocks come in packs: the switch at a pack's right says whether its blocks are offered in “/”, Add custom block and a table's Views; click a pack to see its blocks.",
+  "自定义块按块包放：每个块包右边的开关管它的块在 “/”和添加自定义块里提不提供；点一个块包看它的块。": "Custom blocks come in packs: the switch at a pack's right says whether its blocks are offered in “/” and Add custom block; click a pack to see its blocks.",
   "这个工作区还没有自定义块：让 Agent 做一个，或导入一个块包，它们放在工作区的 components 文件夹里。": "This workspace has no custom blocks yet: ask an Agent to make one, or import a block pack. They live in the workspace's components folder.",
-  "每个块右边的开关管 “/”、添加自定义块和表格的「视图」里提不提供它，默认打开；点一行看它的说明和别的开关。": "The switch right of each block decides whether \"/\", Add custom block and a table's View menu offer it, on by default. Click a row for what it is and its other switches.",
+  "每个块右边的开关管 “/”和添加自定义块里提不提供它，默认打开；点一行看它的说明和别的开关。": "The switch right of each block decides whether \"/\" and Add custom block offer it, on by default. Click a row for what it is and its other switches.",
   "在所有菜单里提供": "Offer in every menu",
-  "总开关关掉后，“/”、添加自定义块和表格的「视图」里都不再提供它；已经写在文档和页面里的块照常显示。": "With the master switch off, it is no longer offered in \"/\", Add custom block or a table's View menu. Blocks already written into documents and pages keep showing.",
+  "总开关关掉后，“/”和添加自定义块里都不再提供它；已经写在文档和页面里的块照常显示。": "With the master switch off, it is no longer offered in \"/\" or Add custom block. Blocks already written into documents and pages keep showing.",
   "每个块右边的开关是「在文档菜单里显示」：关掉的块不再出现在 “/”、在下方新建和手柄的网格里，已有的块照常。": "The switch right of each block is \"Show in document menus\": a block switched off leaves \"/\", Add below and the handle's grid. Existing blocks stay as they are.",
   "这个块总在文档菜单里": "This block is always in the document menus",
   "读不出 component.json": "component.json cannot be read",
@@ -854,7 +854,6 @@ export default {
   "在左侧插入": "Insert left",
   "在右侧插入": "Insert right",
   "均分列宽": "Even column widths",
-  "视图": "View",
   "自动调整列宽": "Auto-fit column widths",
   "列": "Column",
   "行": "Row",
@@ -1026,6 +1025,9 @@ export default {
   "左对齐": "Align left",
   "居中对齐": "Align center",
   "右对齐": "Align right",
+  "对齐与缩进": "Align and indent",
+  "增加缩进": "Indent",
+  "减少缩进": "Outdent",
   "粘贴图片链接…": "Paste an image link…",
   "嵌入图片": "Embed image",
   "适用于网络上的任何图片。": "Works with any image on the web.",
@@ -1048,6 +1050,9 @@ export default {
   "替换图片": "Replace image",
   "恢复原始大小": "Original size",
   "已恢复原始大小 · Ctrl+Z 撤销": "Original size restored · Ctrl+Z to undo",
+  "同步宽度到全局": "Use this width for all images",
+  "页面上的图片已经都是这个宽度。": "The images on this page are all this width already.",
+  "已将 {0} 张图片设为同一宽度 · Ctrl+Z 撤销": "{0} images set to the same width · Ctrl+Z to undo",
   "上一张": "Previous",
   "下一张": "Next",
   "查看图片": "Image viewer",
@@ -1275,6 +1280,7 @@ export default {
   "这份文档的标题和说明读不出来": "This document's title and description could not be read",
   "应用到全部文档": "Apply to all documents",
   "这份文档的字体与布局用到全部文档，新建的文档也一样": "Use this document's font and layout in every document, new ones too",
+  "这份文档的字体与布局用到它所在工作区的全部文档，新建的文档也一样": "Use this document's font and layout in every document of its workspace, new ones too",
   "已应用到全部文档": "Applied to all documents",
   "已应用到全部文档，替换了 {0} 篇的单独设置": "Applied to all documents; own settings replaced in {0}",
   "没有应用到全部文档：{0}": "Not applied to all documents: {0}",
@@ -1282,7 +1288,6 @@ export default {
   "自定义页": "Custom page",
   "更多页面": "More pages",
   "未命名页面": "Untitled page",
-  "首页不能移到回收区": "The home page cannot be moved to the trash",
   "找不到这个页面": "This page was not found",
   "标题不能是空的，也不能超过 200 个字": "A title cannot be empty or longer than 200 characters",
   // 自定义页顶栏右上角的 ···（页的菜单）
@@ -1308,6 +1313,9 @@ export default {
   "这个块不能放在页面上": "This block cannot go on a page",
   "卡片设置": "Card settings",
   "（未选择）": "(none)",
+  // 自定义块的设置：视图读哪一张表格
+  "表格 {0}": "Table {0}",
+  "表格 {0} · {1}": "Table {0} · {1}",
   // 首页：恢复默认卡片（侧栏里首页的菜单）和第一次打开时的说明
   "恢复默认卡片": "Restore default cards",
   "已放回默认卡片：{0}": "Default cards put back: {0}",
@@ -1315,18 +1323,18 @@ export default {
   "没能放回：{0}": "Could not put back: {0}",
   "默认卡片都在，没有要放回的": "All the default cards are there: nothing to put back",
   "没能恢复默认卡片": "The default cards could not be restored",
-  "首页之后又改过，在页面上按 Ctrl+Z 撤销": "The home page changed since: press Ctrl+Z on the page to undo",
+  "这一页之后又改过，在页面上按 Ctrl+Z 撤销": "This page changed since: press Ctrl+Z on the page to undo",
   "放回的卡片之后被改过或拿掉了，没有撤销": "The cards put back were changed or taken out since: nothing undone",
-  "这是你的首页": "This is your home page",
+  "这一页的卡片可以自己摆": "This page's cards are yours to arrange",
   "拖卡片右上角的 {0} 移动它，点一下它打开菜单（大小、设置、删除），点页面右上角的 ··· 里的「添加自定义块」加一张。": "Drag {0} at a card's top right to move it, click it to open the card's menu (Size, Settings, Delete), and use Add custom block in the ··· menu at the top right of the page to add one.",
   "拖卡片右上角的 {0} 移动它，点一下它打开菜单（大小、设置、删除），点页面右上方的「添加自定义块」加一张。": "Drag {0} at a card's top right to move it, click it to open the card's menu (Size, Settings, Delete), and use Add custom block at the top right of the page to add one.",
   "想要新卡片或新页面，跟 Agent 说，比如：": "For a new card or a new page, ask your Agent, for example:",
-  "用 Gallery 在首页加一张卡片，记我每天喝了几杯水。别动我摆好的卡片。": "Use Gallery to add a card to my home page that counts the glasses of water I drink each day. Leave the cards I placed where they are.",
+  "用 Gallery 在「{0}」这一页加一张卡片，记我每天喝了几杯水。别动我摆好的卡片。": "Use Gallery to add a card to my page “{0}” that counts the glasses of water I drink each day. Leave the cards I placed where they are.",
   "复制": "Copy",
   "已复制": "Copied",
   "已复制这句话，发给 Agent 就行": "Copied: send it to your Agent",
   "关闭这条说明": "Close this note",
-  "首页的说明": "About the home page",
+  "这一页的说明": "About this page",
   "没能记下这条说明已关闭": "Could not keep this note closed",
   // 联网：卡片上的「允许访问」和组件列表的「允许联网」打开的同意框（netConsent.ts）
   "这个块现在没有要联网的地方": "This block reaches no website now",
@@ -1337,11 +1345,23 @@ export default {
   "允许联网": "Online",
   "允许它从这些网站取数据：{0}": "Lets it fetch data from these websites: {0}",
   "这个块不联网": "This block reaches no website",
-  "加到首页": "Add to the home page",
-  "首页有了新的卡片": "New cards for your home page",
-  "点「加到首页」放进空位，已有的卡片不动。以后也可以在侧栏里首页的菜单中点「恢复默认卡片」。": "Add to the home page puts them in the empty spots and leaves your cards as they are. Later, Restore default cards in the home page's menu in the sidebar does the same.",
-  "首页的新卡片": "New cards for the home page",
-  "没能把卡片放到首页": "The cards could not be put on the home page",
+  "加到这一页": "Add to this page",
+  "有了新的默认卡片": "New default cards",
+  "点「加到这一页」放进空位，已有的卡片不动。以后也可以在这一页的菜单中点「恢复默认卡片」。": "Add to this page puts them in the empty spots and leaves your cards as they are. Later, Restore default cards in this page's menu does it too.",
+  "新的默认卡片": "New default cards",
+  "没能把卡片放到这一页": "The cards could not be put on this page",
+  // 侧栏头部的拖动、自定义页的 ··· 菜单和新建页面、默认块包（SidebarHead.tsx、reportMenus.tsx、board/hint.mjs、ComponentSettings.tsx）
+  "还没有块。让 Agent 写一个自定义块，没有指定块包时就放在这里。": "No blocks yet. Ask an Agent for a custom block: one it puts in no pack of its own goes here.",
+  "新建页面": "New page",
+  "一个空白页，放在这一页下面，让 Agent 来写": "A blank page under this one, for an Agent to write",
+  "重命名、新建页面等…": "Rename, new page and more…",
+  "页面的操作": "Page actions",
+  "用 Gallery 把「{0}」这个自定义页写出来：放上我这周的待办，和离月底还有几天。": "Use Gallery to write my custom page “{0}”: this week's to-dos, and how many days are left in the month.",
+  "这一页还是空的": "This page is empty",
+  "自定义页由 Agent 来写：可以是一页卡片，也可以是它为你做的任何网页。": "An Agent writes a custom page: a page of cards, or any web page it makes for you.",
+  "跟 Agent 说你想在这里放什么，比如：": "Tell your Agent what you want here, for example:",
+  "空白的自定义页": "A blank custom page",
+  "侧栏头部的顺序不对": "The order of the sidebar's top rows is not valid",
   // 侧栏的栏和网页链接（SidebarTree.tsx、LinkForm.tsx、LinkView.tsx，服务器的 link、link-set）
   "这是 Gallery 自己的地址，请直接链接文档": "This is Gallery's own address: link the document instead",
   "这个网站不允许在别的页面里显示": "This website doesn't let other pages show it",
@@ -1388,7 +1408,10 @@ export default {
   "只改它在这里的显示位置，文件不动": "Changes only where it shows here: no file moves",
   "在文件夹中显示": "Show in folder",
   "在它的工作区里打开": "Open in its workspace",
-  "它自己的工作台：导出、批注、字体与布局在那里": "Its own workbench: export, comments, font and layout are there",
+  "「{0}」已移至它所在工作区的回收区": "“{0}” moved to the trash of its workspace",
+  "副本在它所在的工作区里": "The copy is made in its workspace",
+  "导入的页面在它所在的工作区里": "The imported pages are made in its workspace",
+  "进它所在工作区的回收区": "Goes to the trash of its workspace",
   "从文档树移除": "Remove from the sidebar",
   "只移除这一条，不删除底稿": "Removes this entry only: the draft is not deleted",
   "找不到底稿：本机登记的两个工作区编号相同": "Draft not found: two registered workspaces share one id",

package/browser/shared/outline.mjs

@@ -4,6 +4,7 @@ import path from "node:path";
 import { writeAtomic } from "./files.mjs";
 import { extensionColumnIds } from "./extensions.mjs";
 import { DOCS, entryPattern, extensionGroupId, GROUP_LIMITS, groupOf, isForeign, isTop, newGroupId, topIn, topOf, validGroups } from "./outline-shape.mjs";
+import { storedHead } from "./sidebar-head.mjs";
 import { shownWorkspaces, snapshotOf } from "./workspace-columns.mjs";
 import { layoutOf, listDocumentSlugs, listLinkSlugs, pageSlug } from "./workspace.mjs";
 
@@ -38,6 +39,9 @@ import { layoutOf, listDocumentSlugs, listLinkSlugs, pageSlug } from "./workspac
 // got yet comes last (not written until the outline is), one whose extension is gone drops out, and what an
 // outline says of its entries is passed over (an extension's entries are its own, never the outline's).
 // Their place is what the outline keeps of them.
+// The file also keeps the order of the sidebar's head rows (`head`: 新建, 搜索 and the custom pages,
+// ./sidebar-head.mjs), which only a drag of a head row and a new page write (writeHead), and every write
+// of the tree keeps as it was (writeOutline).
 // Written by the workspace's server (src/workbench/service.mjs: the workbench's moves and columns, a new,
 // copied, restored or imported document, a new link, gallery new --under, gallery move and gallery link
 // add while it runs, in the queue its saves go through), and by a gallery command when no server runs
@@ -137,6 +141,8 @@ const OLD_DOCS_NAMES = ["文档", "Documents"];
  */
 export function storedOf(file) {
   if (!file || typeof file !== "object" || Array.isArray(file)) return null;
+  // A file that holds the head's order alone (writeHead's, before any tree was written) holds no tree.
+  if (!Object.hasOwn(file, "children") && !Object.hasOwn(file, "groups")) return null;
   const groups = [];
   const children = {};
   const take = (id, own) => {
@@ -367,11 +373,33 @@ export function fileOf(value) {
   };
 }
 
-/** Write outline `value` ({ groups?, children }) of workspace `root` (.gallery/ made when there is none yet). */
+/**
+ * Write outline `value` ({ groups?, children }) of workspace `root` (.gallery/ made when there is none yet),
+ * the head's order the file holds kept as it is (writeHead's).
+ */
 export async function writeOutline(root, value) {
   const file = layoutOf(root).outline;
   await fs.mkdir(path.dirname(file), { recursive: true });
-  return writeAtomic(file, `${JSON.stringify(fileOf(value), null, 2)}\n`);
+  const head = storedHead((await readJson(file))?.head);
+  return writeAtomic(file, `${JSON.stringify({ ...fileOf(value), ...(head ? { head } : {}) }, null, 2)}\n`);
+}
+
+/** The head's order as workspace `root`'s outline file keeps it (./sidebar-head.mjs storedHead), or null where it keeps none. */
+export async function readStoredHead(root) {
+  return storedHead((await readJson(layoutOf(root).outline))?.head);
+}
+
+/**
+ * Write the head's order `head` (a stored head: ./sidebar-head.mjs) into workspace `root`'s outline file,
+ * all else it holds as it was (a file there is none of yet holds it alone, which reads as no tree:
+ * storedOf). Run under the outline's lock (withOutlineLock), as every write of the file is.
+ */
+export async function writeHead(root, head) {
+  const file = layoutOf(root).outline;
+  await fs.mkdir(path.dirname(file), { recursive: true });
+  const value = await readJson(file);
+  const kept = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  return writeAtomic(file, `${JSON.stringify({ ...kept, head: storedHead(head) ?? [] }, null, 2)}\n`);
 }
 
 /** The key `slug` sits under in `children` (a column's top key at a top level), or null when the outline holds it not. */

package/browser/shared/pack-manifest.mjs

@@ -23,9 +23,20 @@ export const PACK_FILE = "pack.json";
 /** What a pack's id, a scope, may be: as a block id's scope (shared/components/installed.mjs PACKAGE_ID). */
 export const PACK_ID = /^[a-z0-9][a-z0-9-]*$/;
 
-/** The scope a block of the workspace's own is in (gallery block new local/<name>, or a <name> alone), which no pack takes. */
+/**
+ * The scope a block of the workspace's own is in (gallery block new local/<name>, or a <name> alone), which
+ * no pack installed takes: the default pack (默认块包, DEFAULT_PACK), where an Agent's block goes when it
+ * names no pack, so that a single block needs no pack of its own. It has no pack.json (none may name it):
+ * its name and words are these, and 设置 › 组件列表 lists it first, its blocks or none (shared/block-packs.mjs).
+ */
 export const OWN_SCOPE = "local";
 
+/** What the default pack (OWN_SCOPE's) is called and says of itself, in both languages. */
+export const DEFAULT_PACK = Object.freeze({
+  name: Object.freeze({ zh: "默认块包", en: "Default pack" }),
+  description: Object.freeze({ zh: "Agent 写自定义块时没有指定块包，块就放在这里。只写一个块，不用另建块包。", en: "Where an Agent's custom block goes when it names no pack: a single block needs no pack of its own." }),
+});
+
 const FIELDS = ["id", "name", "description", "version", "author", "homepage", "icon"];
 const VERSION = /^\d+\.\d+\.\d+$/;
 const isTable = (value) => typeof value === "object" && value !== null && !Array.isArray(value);