@heycys/gallery 0.1.2 → 0.2.1

package/browser/editor/page/table/widths.mjs

@@ -11,7 +11,8 @@ import { t } from "../../../shared/i18n/index.mjs";
 
 // A table's column widths (notion-lite's: a 3px strip on each column's right edge; the plan's D4:
 // the kit's own widths until the reader sizes a column). Dragging a strip sizes its column (35px at
-// least, nothing snapped), shown as it goes (Esc puts it back), written when let go as one undo
+// least; the last one's, the table's right edge, snaps where the table is exactly as wide as the
+// text: SNAP), shown as it goes (Esc puts it back), written when let go as one undo
 // step: every column's width on the topmost cell of that column alone (--doc-column-width,
 // index.mjs COLUMN_WIDTH; shared/table-slots.mjs widthHolder: a merged cell holds none), the kit laying the table
 // out at them (tables/layout.js manualLayout); the first
@@ -50,6 +51,8 @@ const STYLE = `
   .ge-trows > b > svg { width: 12px; height: 12px; fill: none; stroke: currentColor; stroke-width: 1.6; stroke-linecap: round; stroke-linejoin: round; transform: rotate(90deg); }
   ${gestureLock("data-ge-tresize", { cursor: "col-resize", select: true })}
 `;
+const SNAP = 6; // px: the last column's edge within this of the width that fills the text lands on it (as the resize tool's: resize/)
+const LIVE = 60000; // ms: the notice saying the table is full stays while the drag lasts (taken off when it ends)
 const DOUBLE = 500; // two presses on a strip within this many ms are a double click (a press on the armed edge after its click too)
 const EDGE = 8; // the edges' strips reach this far past the table (the resize tool's grab)
 const ARROWS = '<svg viewBox="0 0 12 12" aria-hidden="true"><path d="M1.5 6h9M3.5 4 1.5 6l2 2M8.5 4l2 2-2 2"/></svg>';
@@ -62,8 +65,29 @@ export function createColumnWidths(tools) {
   let armed = null; // an edge clicked: { unit, axis: "x" (right) | "y" (bottom), at: when, shown }, the next drag of it the table's size
   let quick = null; // the armed right edge pressed soon after its click: { unit, index, x } (let go there, a double click)
 
-  /** Each column's width as the table shows it now, px. */
-  const shown = (unit) => tools.geometry(unit).columns.map((column) => Math.round((column.right - column.left) * 100) / 100);
+  /**
+   * Each column's width as the table shows it now, px: the width of its cells, not the distance
+   * between their edges. A table scrolled sideways keeps its first column in sight (position: sticky,
+   * tables.css: a header column or .doc-table--sticky-first), so the edges of those cells are not the
+   * columns' and the column under them would read as the part of it in sight: every width then sums
+   * to the frame's, the table seeming full, the columns before the border squeezed when it was pressed.
+   */
+  const shown = (unit) => {
+    const { slots } = tableState(unit);
+    if (!slots) return tools.geometry(unit).columns.map((column) => Math.round((column.right - column.left) * 100) / 100);
+    const cells = [...slots.places].map(([cell, place]) => ({ ...place, width: cell.getBoundingClientRect().width }));
+    const widths = Array(slots.columns).fill(null);
+    for (const { c, cols, width } of cells) if (cols === 1) widths[c] ??= width;
+    // A column no single cell gives a width: what the cells merged over it leave, shared out.
+    for (const { c, cols, width } of cells.filter((cell) => cell.cols > 1).sort((a, b) => a.cols - b.cols)) {
+      const over = Array.from({ length: cols }, (_, i) => c + i);
+      const open = over.filter((i) => widths[i] === null);
+      if (open.length === 0) continue;
+      const left = Math.max(0, width - over.reduce((sum, i) => sum + (widths[i] ?? 0), 0));
+      for (const i of open) widths[i] = left / open.length;
+    }
+    return widths.map((width) => Math.round((width ?? 0) * 100) / 100);
+  };
   /** The cells holding the columns' widths: per column, its topmost cell alone, or null. */
   const holders = (unit) => {
     const { slots } = tableState(unit);
@@ -101,20 +125,56 @@ export function createColumnWidths(tools) {
     return done;
   }
 
-  // Shown as it goes: the holders' widths set straight (taken back before the undo step).
-  function preview(unit, widths) {
+  // Shown as it goes: the holders' widths set straight (taken back before the undo step), the
+  // table's own width (--doc-span) off while it lasts, as the kit would else keep the columns in
+  // proportion to it and the table where it was.
+  function preview(drag, widths) {
+    const { unit } = drag;
+    if (drag.span === undefined) {
+      drag.span = unit.style.getPropertyValue(SPAN);
+      unit.style.removeProperty(SPAN);
+    }
     holders(unit).forEach((cell, c) => cell?.style.setProperty(COLUMN_WIDTH, `${widths[c]}px`));
     relayout(unit);
   }
-  function putBack({ unit, before }) {
+  function putBack({ unit, before, span }) {
     for (const [cell, width] of before) {
       if (width) cell.style.setProperty(COLUMN_WIDTH, width);
       else cell.style.removeProperty(COLUMN_WIDTH);
       if (cell.getAttribute("style") === "") cell.removeAttribute("style");
     }
+    if (span) unit.style.setProperty(SPAN, span);
     relayout(unit);
   }
 
+  // The columns' widths together (px) at which the table is exactly as wide as the text (or the
+  // column it stands in): the room its frame has, as the kit lays a table out at the reader's widths
+  // (tables/layout.js manualLayout: a table of that width or more has the frame at 100%, one less
+  // a frame as wide as it). Null where the frame has none.
+  function fillOf(unit) {
+    const parent = unit.parentElement;
+    if (!parent) return null;
+    const sides = (node) => {
+      const style = getComputedStyle(node);
+      return ["borderLeftWidth", "borderRightWidth", "paddingLeft", "paddingRight"].reduce((sum, name) => sum + (parseFloat(style[name]) || 0), 0);
+    };
+    const room = parent.getBoundingClientRect().width - sides(parent) - sides(unit);
+    return room > 0 ? room : null;
+  }
+
+  // The last column's right edge is the table's: within SNAP of the width that fills the text, the
+  // last column takes what the others leave of it (rounded down: never a hair past the frame).
+  // True when it did. `widths` is changed in place.
+  function snapFull({ last, fill, start, index }, widths) {
+    if (!last || fill === null) return false;
+    const rest = start.reduce((sum, width, c) => (c === index ? sum : sum + width), 0);
+    const wanted = Math.floor((fill - rest) * 100) / 100;
+    if (wanted < MIN_COLUMN_WIDTH || Math.abs(rest + widths[index] - fill) > SNAP) return false;
+    widths[index] = wanted;
+    return true;
+  }
+  const FULL = () => [t("表格"), t("宽度"), t("铺满正文")];
+
   // A column fitted to its widest cell of it alone, unwrapped (+1px): by its words, not the words an
   // Agent took out that the page shows in it (changes/: out of the layout while it is measured).
   function fit(unit, index) {
@@ -221,7 +281,7 @@ export function createColumnWidths(tools) {
             return fit(unit, index);
           }
           const { rows } = tableParts(unit);
-          drag = { unit, index, x: event.clientX, last, fresh: true, start: shown(unit), before: new Map(rows.flatMap((row) => [...row.cells]).map((cell) => [cell, widthOf(cell)])) };
+          drag = { unit, index, x: event.clientX, last, fill: last ? fillOf(unit) : null, told: false, fresh: true, start: shown(unit), before: new Map(rows.flatMap((row) => [...row.cells]).map((cell) => [cell, widthOf(cell)])) };
           document.documentElement.setAttribute("data-ge-tresize", "");
           document.documentElement.setPointerCapture?.(event.pointerId);
         });
@@ -262,8 +322,16 @@ export function createColumnWidths(tools) {
     drag.moved = true;
     const widths = [...drag.start];
     widths[drag.index] = Math.max(MIN_COLUMN_WIDTH, Math.round(drag.start[drag.index] + event.clientX - drag.x));
+    // The last column's edge snaps to the table that fills the text; the bottom notice says so while it holds.
+    const snapped = snapFull(drag, widths);
     drag.widths = widths;
-    preview(drag.unit, widths);
+    drag.snapped = snapped;
+    preview(drag, widths);
+    if (snapped !== drag.told) {
+      drag.told = snapped;
+      if (snapped) tools.say(t("{0}{1}：{2}", ...FULL()), "note", LIVE);
+      else tools.settle();
+    }
     tools.draw();
   }, true);
 
@@ -273,9 +341,13 @@ export function createColumnWidths(tools) {
     document.documentElement.removeAttribute("data-ge-tresize");
     if (!done) return;
     putBack(done);
-    if (!cancel && done.widths) set(done.unit, done.widths);
+    if (done.told) tools.settle(); // the notice of the table filling the text: the result's follows, or nothing
+    // Back at the widths it had, snapped to a table that was full already (or dragged out and back): nothing to write.
+    const unchanged = done.widths?.every((width, c) => Math.abs(width - done.start[c]) < 0.5);
+    if (!cancel && done.widths) {
+      if (!unchanged && set(done.unit, done.widths) && done.snapped) tools.say(t("已调整{0}{1}：{2} · Ctrl+Z 撤销", ...FULL()));
     // The last strip clicked (pressed, not moved): the table's right edge armed.
-    else if (!cancel && done.last) return arm(done.unit, "x");
+    } else if (!cancel && done.last) return arm(done.unit, "x");
     tools.draw();
   }
   document.addEventListener("pointerup", () => end(false), true);

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

@@ -7,6 +7,7 @@ import { joinCode } from "../marks.mjs";
 import { numberWithUnit, sideOf, WORD } from "../../../shared/inline-spacing.mjs";
 import { pageOf, pagesAround } from "../page-objects.mjs";
 import { BLOCK_TYPES, HOSTS, accepts, firstSaysOf, placeholderOf, textFilters, textTypeOf } from "../../components/registry.mjs";
+import { unalign } from "../align.mjs";
 import { t } from "../../../shared/i18n/index.mjs";
 
 // Typing in a block (docs/editor.md, "Browser side"): every key goes first to the component the block
@@ -14,7 +15,7 @@ import { t } from "../../../shared/i18n/index.mjs";
 // `if (!ctx.def.keys?.enter?.(ctx)) splitBlock(...)`, and then to the rules of every block. Enter
 // splits it, Backspace and Delete at its edges merge it with the block before or after, or remove it
 // once empty, the caret going to the neighbouring block. Backspace in a container with nothing
-// written in it (`removedEmpty`) deletes the container. Chinese typed next to a Latin letter or
+// written in it (`removedEmpty`) or in an empty heading turns it into an empty paragraph. Chinese typed next to a Latin letter or
 // digit gets a space between them (autoSpace; not a number and its unit, nor in a block written without), and an empty block under the caret says what it takes
 // (placeholder). Plain typing and input methods stay with the browser; the keys are routed here by
 // editor.mjs.
@@ -53,8 +54,11 @@ function writtenTogether(host, node, start, end) {
  * deleted as the selected ones are (selection/delete.mjs). adding(): the block the "/" menu the
  * handle's "+" opened is open in (slash-menu/), or null. leave: where Enter and Backspace leave a
  * container (leave.mjs). showHidden(node): the folds hiding a block opened (fold/ showAround).
+ * look(element, change): the editor's undoable change of classes (a block's alignment, align.mjs).
+ * afterAbove(host): Backspace at the start of a text block right after a block of no text, the caret
+ * put after that block (after/ back); whether it was.
  */
-export function createTyping({ struct, say, keepText, paragraphBefore, removeBlocks, selectBlock = () => {}, adding = () => null, leave, showHidden = () => {} }) {
+export function createTyping({ struct, say, keepText, paragraphBefore, removeBlocks, selectBlock = () => {}, adding = () => null, leave, showHidden = () => {}, look = () => false, afterAbove = () => false }) {
   // A key, asked of the component of the text block `host` and then of what stands around it, nearest
   // first (docs/editor.md, "The order of keys"): whether it was theirs. `ctx` is notion-lite's, as
   // much of it as a key reads, the block being an element here.
@@ -101,8 +105,8 @@ export function createTyping({ struct, say, keepText, paragraphBefore, removeBlo
   function split(host) {
     if (HOSTS[host.getAttribute("data-ge-kind")]?.opensBody) return enterBody(host);
     // The caret at the very start of a block with text: an empty paragraph goes before the block and
-    // the caret stays (a block that splits does this itself, splitBlock). This comes first: in a code
-    // block too, whose own Enter breaks the line.
+    // the caret stays (a block that splits does this itself, splitBlock). Only hosts that opt in take
+    // this rule; code keeps its own Enter, which breaks the line even at the start.
     const own = HOSTS[host.getAttribute("data-ge-kind")]?.opensBefore; // not a cell, a card's field, the title
     if (own && !can(host, "split") && !isEmpty(host) && atEdge(host, false) && paragraphBefore(host)) return;
     // Its component's Enter (a code block's line, a nested item out a level, a title going into its
@@ -152,10 +156,33 @@ export function createTyping({ struct, say, keepText, paragraphBefore, removeBlo
     return true;
   }
 
-  // An empty container deleted whole (one undo step, which selects it again); the caret at the end of
-  // the block before it, or at the start of the one after it when it was first (a formula block passed
-  // over: textNear).
+  // Whether a block may not go (keepText): the reason said, a note that stays a while.
+  function kept(node) {
+    const reason = keepText(node);
+    if (reason) say(reason, "note", 6000);
+    return Boolean(reason);
+  }
+
+  // An empty container turned into an empty paragraph where it stands, the caret in it (the user's,
+  // 2026-11-09: as an empty heading, an empty item and every other empty block go back to body text,
+  // not away with the caret on the block before); one undo step, which brings the container back.
+  // Where its box takes no paragraph it is deleted whole (one undo step, which selects it again), the
+  // caret at the end of the block before it, or at the start of the one after it when it was first (a
+  // formula block passed over: textNear).
   function removeContainer(container) {
+    const box = container.parentElement;
+    const paragraph = newParagraphHost(document);
+    if (box && accepts(boxKind(box), paragraph.getAttribute("data-ge-type"))) {
+      if (kept(container)) return true;
+      const parts = withLeads(container);
+      struct([box], [], () => {
+        parts[0].before(paragraph);
+        parts.forEach((part) => part.remove());
+        return { touched: [paragraph], focus: paragraph };
+      });
+      caretAt(paragraph, "start");
+      return true;
+    }
     const list = hosts();
     const inside = list.filter((node) => container.contains(node));
     const before = textNear(inside[0], -1, list);
@@ -181,11 +208,7 @@ export function createTyping({ struct, say, keepText, paragraphBefore, removeBlo
       ? (next ? [next, "start"] : [previous, "end"])
       : (previous ? [previous, "end"] : [next, "start"]);
     const node = removalTarget(host);
-    const kept = keepText(node);
-    if (kept) {
-      say(kept, "note", 6000);
-      return true;
-    }
+    if (kept(node)) return true;
     struct([node.parentNode], [host], () => {
       takeOut(node);
       return { touched: [], focus: target };
@@ -203,6 +226,9 @@ export function createTyping({ struct, say, keepText, paragraphBefore, removeBlo
   // Backspace at the start of a block. Returns whether it was handled.
   function backspace(host) {
     opened(previousLine(host));
+    // A paragraph's or a heading's alignment, then its indent a level at a time, goes before anything
+    // else, one undo step each (align.mjs unalign: Feishu's 退对齐 and 反缩进 before a join).
+    if (unalign(host, look)) return true;
     // The block's component (a list item's: a nested item moves out a level, the first or last item of
     // a top-level list leaves it as body text, an emptied item holding lists stays), then what stands
     // around it (the item a block stands under; a node, at the start of its first line, holding
@@ -212,6 +238,12 @@ export function createTyping({ struct, say, keepText, paragraphBefore, removeBlo
     const container = emptyContainer(host);
     if (container) return removeContainer(container);
     if (leave.backspace(host)) return true;
+    // An empty heading (or small text) is an empty paragraph, where it stands (leave.mjs emptied).
+    if (leave.emptied(host)) return true;
+    // Right after a block of no text (a picture, a table, a code block, a callout, a divider, a card…):
+    // the caret after it, at its bottom right (after/), an empty block going (the user's, 2026-11-09:
+    // Backspace there went into the block, or past a picture to the text before it); never a join.
+    if (afterAbove(host)) return true;
     if (isEmpty(host)) return removeHost(host, false);
     if (merge(host)) return true;
     // A block holding blocks that did not join the line above says why, as its component puts it.

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/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];
+}