@heycys/gallery 0.1.2 → 0.2.0

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

@@ -1,6 +1,9 @@
 import { ARRIVING, ATTRIBUTE, DATA_MOST, DATA_SHOWN, FALLBACK, FIELDS, INSTANCE, NO_TEXT, PACKAGE_MARK, SCHEMA, SLOT, SLOT_PART, componentAt, fitsDataScript, heldBy, instanceMatch, isDataScript, noDataPart, refusedInData, schemaAhead, slotsIn } from "../../../shared/components/installed.mjs";
 import { referencedIds } from "../../../shared/copy-ids.mjs";
+import { jsonIn } from "../../../shared/json-layout.mjs";
+import { CHART_SOURCE, VIEW_FROM } from "../../../shared/table-chart.mjs";
 import { language, t } from "../../../shared/i18n/index.mjs";
+import { searchWords } from "../../../shared/pinyin.mjs";
 import { caretAt, editable } from "../../page/caret.mjs";
 import { htmlToBlocks, parseClipboardHTML } from "../../page/clipboard/import/html.mjs";
 import { toBlocks } from "../../page/clipboard/import/to-blocks.mjs";
@@ -8,8 +11,11 @@ import { build as buildBlock } from "../../page/clipboard/own/blocks.mjs";
 import { copyOf } from "../../page/clipboard/own/describe.mjs";
 import { ownIds } from "../../page/clipboard/own/ids.mjs";
 import { firstHost, newHost, unitElement } from "../../page/core.mjs";
+import { openSettings } from "../../page/board/settings.mjs";
+import { bindAbove, keyOf, tableChoices } from "../../page/table/binding.mjs";
 import { addStyle } from "../../page/ui.mjs";
 import { accepts, capsFor } from "../registry.mjs";
+import { SETTINGS_ICON } from "../icons.mjs";
 import { ICON } from "./index.mjs";
 import { followCatalog, followSettings, isBehind } from "./served.mjs";
 
@@ -301,9 +307,6 @@ function keepSlots(node, from, next) {
   console.error(`[DocKit] ${instance.getAttribute(ATTRIBUTE)}: a slot left its instance: it is put back, its blocks the document's`);
 }
 
-// A package's picture where a menu shows a mark.
-const pictureOf = ({ preview }) => (preview ? `<img src="${preview}" alt="">` : null);
-
 // A slot the file has empty (an Agent's): what a disclosure's content says (details/page.mjs), a click
 // on it making a paragraph there (insert/ clickBlank).
 const SLOT_EMPTY = `
@@ -312,7 +315,7 @@ const SLOT_EMPTY = `
 `;
 
 /** An instance on the page: what its events are, what Enter does in its words, and what the menus make of its package. */
-export function create({ map, newParagraph, active, sourceStep, struct }) {
+export function create({ map, newParagraph, active, sourceStep, struct, look }) {
   held = map;
   addStyle(SLOT_EMPTY);
   // Whether a key in an instance, on no field of it, is undo or redo: a button or what a component draws
@@ -360,7 +363,73 @@ export function create({ map, newParagraph, active, sourceStep, struct }) {
     sourceStep(changed.map(([part, was]) => [part, was]));
     return true;
   }
+  // ---------- 设置 ----------
+  // An instance's 设置 (the handle's menu; the board's form of a custom page, page/board/settings.mjs, whose
+  // menu cards a choice is made in): the fields its manifest's `settings` lists, kept in its part
+  // `settings` (a script of JSON, what `context.editJSON` writes: one undo step, a change laid out as the
+  // part was), and for a view of a table (needs "tables") which table it reads, kept in its VIEW_FROM and on
+  // the table's frame (binding.mjs), one undo step too. Null where it has none: no field, or no part to keep
+  // them in, and no table to choose; an instance that does not run or that is past its manifest has no form.
+  const TABLE_FIELD = "__table"; // the form's field for the table: no setting of the manifest's
+  const settingsIn = (part) => {
+    try {
+      const value = JSON.parse(part?.textContent?.trim() || "{}");
+      return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+    } catch {
+      return {};
+    }
+  };
+  function formOf(instance) {
+    if (!active() || instance.hasAttribute(FALLBACK) || ahead(instance)) return null;
+    const entry = entryOf(instance.getAttribute(ATTRIBUTE));
+    if (!entry) return null;
+    const part = dataParts(instance).find(([name]) => name === "settings")?.[1] ?? null;
+    const fields = part ? entry.settings ?? [] : [];
+    const reads = entry.needs?.includes("tables") ?? false;
+    return fields.length > 0 || reads ? { entry, part, fields, reads } : null;
+  }
+  // The values of the manifest's fields put in the part, one `source` step, as editJSON writes them.
+  function writeSettings(instance, part, values) {
+    write({
+      parts: [{ name: "settings", part }],
+      run({ settings: draft }) {
+        const text = draft.textContent ?? "";
+        const current = settingsIn(draft);
+        draft.textContent = text.trim() ? jsonIn(text, { ...current, ...values }) : JSON.stringify({ ...current, ...values });
+        return true;
+      },
+    }, instance);
+  }
+  // The table a view reads put on it, as one undo step: its key on both, a new one on a table with none.
+  function readTable(instance, frame) {
+    const key = frame ? keyOf(frame) : null;
+    const keyed = frame && frame.getAttribute(CHART_SOURCE) !== key;
+    look([instance, ...(keyed ? [frame] : [])], [{ attributes: { [VIEW_FROM]: key } }, ...(keyed ? [{ attributes: { [CHART_SOURCE]: key } }] : [])]);
+  }
+  function openFormOf(instance) {
+    const form = formOf(instance);
+    if (!form) return;
+    const choices = form.reads ? tableChoices() : [];
+    const bound = form.reads ? choices.findIndex(({ frame }) => frame.getAttribute(CHART_SOURCE) === instance.getAttribute(VIEW_FROM) && instance.hasAttribute(VIEW_FROM)) : -1;
+    const fields = [
+      ...(form.reads ? [{ key: TABLE_FIELD, label: t("表格"), type: "choice", choices: [["", t("（未选择）")], ...choices.map(({ label }, at) => [String(at), label])] }] : []),
+      ...form.fields,
+    ];
+    const box = instance.getBoundingClientRect();
+    const top = Math.min(Math.max(box.top, 8), innerHeight - 40);
+    openSettings({
+      fields, name: form.entry.name,
+      values: { ...(form.part ? settingsIn(form.part) : {}), ...(form.reads ? { [TABLE_FIELD]: bound >= 0 ? String(bound) : "" } : {}) },
+      anchor: { left: box.left, right: box.right, top, bottom: top + 8, width: box.width, height: 8 },
+      save({ [TABLE_FIELD]: table, ...values }) {
+        if (table !== undefined) readTable(instance, table === "" ? null : choices[Number(table)]?.frame ?? null);
+        if (Object.keys(values).length > 0 && form.part?.isConnected) writeSettings(instance, form.part, values);
+      },
+    });
+  }
   return {
+    /** An instance's own rows in its block menu: 设置…, where it has a form (formOf). */
+    menuItems: (unit) => (formOf(unit) ? [{ label: t("设置…"), icon: SETTINGS_ICON, run: () => openFormOf(unit) }] : []),
     keepsKeys: (node, event) => componentAt(node) && !editable(node) && !pageUndo(node, event),
     undoHere: (node) => componentAt(node) && !editable(node),
     keys: {
@@ -399,8 +468,8 @@ export function create({ map, newParagraph, active, sourceStep, struct }) {
     // for a divider). Its slots are boxes made on the page at once, what the template has in each made
     // blocks of the page's (an empty paragraph where it has none), so that the reader writes in one
     // before the instance is saved, and Enter in a text part goes into the slot after it. One whose needs
-    // hold "tables" is a view a table's 视图 › offers too (`readsTables`: page/table/views.mjs), which
-    // binds the one it makes to the table (VIEW_FROM). Where two offered have one name (the same block
+    // hold "tables" is a view of a table (`readsTables`), which binds itself to the nearest table above it as
+    // it is made (VIEW_FROM: page/table/binding.mjs). Where two offered have one name (the same block
     // of two packs: 我的待办 of Gallery 风格 and of 柔光风格), each row says its pack's name after it in grey
     // (`of`: the menu's ge-pop-of).
     menuVariants: () => {
@@ -410,8 +479,8 @@ export function create({ map, newParagraph, active, sourceStep, struct }) {
       return Object.fromEntries(offered.map((entry) => [entry.id, {
         label: entry.name[language],
         ...(counts.get(entry.name[language]) > 1 ? { of: entry.pack?.name?.[language] ?? entry.id.split("/")[0] } : {}),
-        icon: pictureOf(entry) ?? ICON,
-        words: `${entry.name.zh} ${entry.name.en} ${entry.id} ${entry.words}`.toLowerCase(),
+        icon: ICON,
+        words: searchWords(entry),
         sample: true,
         readsTables: entry.needs?.includes("tables") ?? false,
         preview: { src: entry.preview, says: entry.description[language] },
@@ -421,6 +490,7 @@ export function create({ map, newParagraph, active, sourceStep, struct }) {
           slotsMade(doc, instance, (slot) => blocksOfTemplate(doc, slot));
           ownIds(doc, [instance]);
           place(instance);
+          if (entry.needs?.includes("tables")) bindAbove(instance); // a view reads the nearest table above it; its 设置 changes that
           return editableParts(instance)[0] ?? firstHost(instance) ?? place(paragraph());
         },
       }]));
@@ -458,11 +528,8 @@ export function create({ map, newParagraph, active, sourceStep, struct }) {
       if (next) caretAt(next, "start");
       else if (next === null) selection.removeAllRanges();
     },
-    /** Its package's picture, or the mark of any component. */
-    iconOf: (unit) => {
-      const entry = entryOf(unit.getAttribute(ATTRIBUTE));
-      return (entry && pictureOf(entry)) ?? ICON;
-    },
+    /** The mark of a custom block: the one every custom block has in a menu, its picture shown beside its row instead. */
+    iconOf: () => ICON,
     /**
      * What of an instance its component writes, part by part, as the file is to hold it (null: nothing
      * here does): its parts as the kit's dehydrate leaves them, what it and its component leave on them

package/browser/editor/components/media/icons.mjs

@@ -1,18 +1,23 @@
 import { svg } from "../icons.mjs";
+import { TABLE_ICONS } from "../../page/table/icons.mjs";
 
 // The media blocks' toolbar icons (an image's, an embed's, the block menus' rows): the editor's own line
 // drawings (components/icons.mjs svg) on the same 20 units as the menus' others, the picture in the
 // middle 16 of them. They carry no size or color: the toolbar's buttons and the menus set them.
+// Plain, a few strokes each (the user, 2026-11-09: Notion's looked too close, then the bars against a
+// guide line that took their place too busy): a side is the editor's own 对齐 lines, the ones a text
+// block's and a table's 对齐 › show (table/icons.mjs), so one look says it everywhere; a caption a picture
+// (one hill in it) over a line of words; viewing large one line corner to corner with a head at each end; three dots.
 
 export const TOOL_ICONS = {
-  // The three sides: a picture beside the line it stands against, between a rule above and below.
-  alignLeft: svg('<path d="M4 4.5h12M4 15.5h12"/><rect x="4" y="7.25" width="6.5" height="5.5" rx="1.25"/>'),
-  alignCenter: svg('<path d="M4 4.5h12M4 15.5h12"/><rect x="6.75" y="7.25" width="6.5" height="5.5" rx="1.25"/>'),
-  alignRight: svg('<path d="M4 4.5h12M4 15.5h12"/><rect x="9.5" y="7.25" width="6.5" height="5.5" rx="1.25"/>'),
-  // A picture with two lines of caption under it.
-  caption: svg('<rect x="4.5" y="4" width="11" height="6.5" rx="1.5"/><path d="M4.5 13.25h11M4.5 16h6"/>'),
-  // A magnifier with a plus.
-  expand: svg('<circle cx="9" cy="9" r="5"/><path d="m12.75 12.75 3.5 3.5M7 9h4M9 7v4"/>'),
+  // The three sides: the editor's alignment lines (a text block's 对齐 ›, a table's).
+  alignLeft: TABLE_ICONS["doc-align-left"],
+  alignCenter: TABLE_ICONS["doc-align-center"],
+  alignRight: TABLE_ICONS["doc-align-right"],
+  // A picture (its frame, one hill in it) over a line of words.
+  caption: svg('<rect x="3.75" y="3.25" width="12.5" height="9.5" rx="1.5"/><path d="m4 11.75 4-3.5 4.5 4M3.75 16.25h12.5"/>'),
+  // One line from corner to corner, a head at each end.
+  expand: svg('<path d="M11.5 4.25h4.25V8.5M8.5 15.75H4.25V11.5M15.25 4.75l-10.5 10.5"/>'),
   // An arrow down onto a line.
   download: svg('<path d="M10 4v9M6.5 9.75l3.5 3.5 3.5-3.5M4.5 16h11"/>'),
   more: svg('<circle cx="5" cy="10" r="1.3" fill="currentColor" stroke="none"/><circle cx="10" cy="10" r="1.3" fill="currentColor" stroke="none"/><circle cx="15" cy="10" r="1.3" fill="currentColor" stroke="none"/>'),

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

@@ -175,14 +175,16 @@ export function create({ struct, finishStep, look, say, active, blocks, newParag
       },
       /**
        * `file` pasted: a new block made by `make(doc)`, put in its place by `put` (the paste's, clipboard/:
-       * where a block pasted there goes, one undo step; false when it could not), then `fill(figure, file)`
-       * (its placeholder filled). Returns whether it took the file.
+       * where a block pasted there goes, one undo step; false when it could not), the block selected, then
+       * `fill(figure, file, { pasted: true })` (its placeholder filled, in the same undo step: one Ctrl+Z
+       * takes the paste back to what stood there). Returns whether it took the file.
        */
       paste(put, file, make, fill) {
         if (!file) return false;
         const figure = make(document);
         if (!put(figure)) return false;
-        fill(figure, file);
+        blocks()?.select(figure, { quiet: true });
+        fill(figure, file, { pasted: true });
         return true;
       },
     };

package/browser/editor/components/media/toolbar.mjs

@@ -1,3 +1,4 @@
+import { IN_LAYER } from "../../../shared/layers.mjs";
 import { tooltip } from "../../page/tooltip.mjs";
 import { element } from "../../page/ui.mjs";
 
@@ -7,7 +8,7 @@ import { element } from "../../page/ui.mjs";
 
 /** The toolbar's look, and its buttons' (a popover's too: an image's 对齐 pops three of them). */
 export const TOOLBAR_STYLE = `
-  .ge-layer > .ge-media-bar { pointer-events: auto; }
+  .ge-layer > .ge-media-bar { pointer-events: auto; z-index: ${IN_LAYER.button}; } /* over its block's fill while the block is selected */
   .ge-media-bar { display: flex; padding: 2px; border-radius: 6px; background: var(--ge-bg);
     box-shadow: 0 0 0 1px var(--ge-outline), 0 4px 12px -2px light-dark(rgb(25 25 25 / 8%), rgb(0 0 0 / 30%)); }
   .ge-media-tool { display: flex; align-items: center; justify-content: center; width: 24px; height: 24px; border-radius: 4px; color: var(--ge-ico2); cursor: pointer; user-select: none; transition: background 20ms ease-in; }
@@ -21,11 +22,19 @@ export const mediaBar = (label) => element("div", { class: "ge-media-bar", role:
 /**
  * A toolbar button: `label` (what it is), `tip` (the tooltip), `icon` (an svg, or a function giving
  * it, drawn by draw() each time the bar is shown), `run(button)` on a click while `alive()` (the block it stands for is
- * still on the page).
+ * still on the page). draw() puts a new icon in only when it changed: a bar placed every frame (an
+ * image's, while it is selected) that put its icons in anew each time took the svg a press landed on
+ * out of the page before the button was let go, and the browser then fired no click (2026-11-09).
  */
 export function toolButton({ label, tip, icon, run, alive }) {
   const button = element("div", { class: "ge-media-tool", role: "button", "aria-label": label });
-  button.draw = () => { button.innerHTML = typeof icon === "function" ? icon() : icon; };
+  let drawn = null;
+  button.draw = () => {
+    const markup = typeof icon === "function" ? icon() : icon;
+    if (markup === drawn) return;
+    drawn = markup;
+    button.innerHTML = markup;
+  };
   if (typeof icon !== "function") button.draw(); // a function icon depends on the block: drawn when the bar is shown
   tooltip(button, tip);
   button.addEventListener("pointerdown", (event) => event.preventDefault());

package/browser/editor/components/paragraph/index.mjs

@@ -1,5 +1,6 @@
 import { svg } from "../icons.mjs";
 import { PARAGRAPH, classOf } from "../kit.mjs";
+import { ALIGN_TOGGLES } from "../align.mjs";
 import { t } from "../../../shared/i18n/index.mjs";
 
 // 文本 and 小字: the plain text blocks. A paragraph is the editor's default block: Enter makes one,
@@ -8,7 +9,7 @@ import { t } from "../../../shared/i18n/index.mjs";
 // default, a paragraph is the engines' own: core.mjs (newHost, splitBlock), insert/
 // (paragraphBefore, newParagraph, clickBlank), convert.mjs (typeOf tells 小字 from text), clipboard/own/
 // (a text block's description is the engine's own, and a block that says no kind is written as a paragraph).
-// Its color (颜色 in the block menu): class switches, colors.mjs.
+// Its color (颜色 in the block menu): class switches, colors.mjs; its alignment and indent (对齐与缩进), align.mjs.
 // Its look: the kit's styles/flow.css (src/render/kit/).
 /** The class of small text's end part (the page editor's Tab), a span at the line's right end (the kit's styles/flow.css). */
 export const TAB = classOf(PARAGRAPH.tail);
@@ -23,7 +24,7 @@ export default {
   name: "paragraph",
   listed: () => t("文本"), hideable: false,
   units: {
-    paragraph: { name: t("文本"), match: [{ rank: 180, tag: "p" }], colors: ["text", "background"], emptyIsNothing: true, fromWords: true },
+    paragraph: { name: t("文本"), match: [{ rank: 180, tag: "p" }], colors: ["text", "background"], toggles: ALIGN_TOGGLES, emptyIsNothing: true, fromWords: true, replacedByFile: true },
   },
   types: {
     paragraph: {
@@ -34,7 +35,7 @@ export default {
     },
     note: { // 小字: a brief label, unit or scope note
       turn: 2, menu: ["basic", 2],
-      tag: "p", className: "doc-note", kind: "paragraph", leaf: "note", text: true, empty: true,
+      tag: "p", className: "doc-note", kind: "paragraph", leaf: "note", text: true, empty: true, emptyToText: true,
       corner: "paragraph", // seldom picked: the gray corner of 文本's cell (type-grid.mjs), so 文本 and the headings fill one line
       label: t("小字"), icon: svg('<path d="M6.25 8.5v-.9h7.5v.9M10 7.6v8.15M8.75 15.75h2.5"/>'), words: "小字 注释 说明 备注 标注 xiaozi zhushi shuoming beizhu xz zs sm note small caption",
       glance: { row: 11, name: "小字", write: "`<p class=\"doc-note\">`, `span.doc-tab` at its right", rule: "Kit blocks" },

package/browser/editor/components/registry.mjs

@@ -44,7 +44,7 @@ import { t } from "../../shared/i18n/index.mjs";
 //               without. What is hidden goes from "/", 在下方新建 and the handle's grid and nothing else
 //               (page/offered.mjs); its blocks, its Markdown shortcut and "Blocks at a glance" stay.
 //   units       the unit kinds it defines (blocks the reader selects, moves and deletes):
-//               { [kind]: { name, icon?, match, chapter?, fixed?, block?, handle?, below?, boxed?, beside?, inRow?, sharesHeight?, entersAfter?, resizable?, copy?, clipboard?, sizes?, toggles?, colors?, colorDefaults?, removedEmpty?, turnsEmpty?, leadsChapter?, canHaveChildren?, emptyIsNothing?, fromWords?, attributes? } }
+//               { [kind]: { name, icon?, match, chapter?, fixed?, block?, handle?, below?, boxed?, beside?, inRow?, sharesHeight?, entersAfter?, resizable?, copy?, clipboard?, sizes?, toggles?, colors?, colorDefaults?, removedEmpty?, turnsEmpty?, leadsChapter?, canHaveChildren?, emptyIsNothing?, fromWords?, replacedByFile?, attributes? } }
 //               match: rules an element matches by its tag (one of `tag`), its class and its
 //               attribute, and by the element it stands in (`parent`: { tag?, class? }, a flowchart's
 //               step being an li whose parent is an ol.doc-flow), whichever are given; every
@@ -58,7 +58,7 @@ import { t } from "../../shared/i18n/index.mjs";
 //               (its container's: a tab's, the Sheet area's, on the tab row); below: false, its menu
 //               offers no new block below it (a tab, a Sheet area); boxed: a block with a frame of its
 //               own, no text flowing beside it: a double click between two of them makes a paragraph,
-//               a click to its right selects it, Enter on it selected puts a paragraph after it unless
+//               a click to its right puts the caret after it (page/after/), Enter on it selected puts a paragraph after it unless
 //               it is a text block (beside.mjs), and it is a block of its own to Ctrl+A; beside: the
 //               same click and Enter without being boxed (a row of columns); inRow(element): whether
 //               this one stands beside another now, as a row of columns always does and a flowchart's
@@ -91,6 +91,8 @@ import { t } from "../../shared/i18n/index.mjs";
 //               keys of a block stand after it as they stand in what it is in (a list: under its last item).
 //               emptyIsNothing: a block of it left empty counts as nothing written, in a container
 //               that says `removedEmpty`. fromWords: a block of it can be made again from its words alone.
+//               replacedByFile: a file pasted at the caret in an empty block of it takes the block's place (notion-lite's
+//               pasteFiles: an empty text block goes), else it goes after the block (page/clipboard/).
 //   boxes       the box kinds it defines (containers whose children are units): { [kind]: { role,
 //               name?, classes?, find?, owner?, takenBy?, also?, leaveByEnter?, endIsPadding?, lead?, firstLineActs?, firstBlock?, groups?, holdsOne?, emptyIsNothing?, outer?, selectAll? } }, classes being the kit's classes that make an element one
 //               (rank order, as above); the others the server knows by their tag (findUnits). find: where
@@ -165,7 +167,7 @@ import { t } from "../../shared/i18n/index.mjs";
 //   types       the blocks the reader can make on the page or turn a block into (the "/" menu,
 //               Markdown shortcuts, the block menu), written by the server in the kit's plain markup:
 //               { [type]: { tag, className?, kind, box?, leaf?, wraps?, container?, part?, text?, inside?, tex?,
-//               empty?, resettable?, bare?, placeholder?, bar?, label?, icon?, hint?, markdown?, words?, turn?, menu?, fresh?,
+//               empty?, resettable?, emptyToText?, bare?, placeholder?, bar?, label?, icon?, hint?, markdown?, words?, turn?, menu?, fresh?,
 //               corner?, preload?, onSplit?, create?, takesAsIs?, holder?, nests?, joins?, leadIcon?, fromSelection?, clipboard?, glance? } } and, for the blocks the page
 //               and the server write apart from text, title?, content?, keyed?, written?,
 //               extras?, textHost?, blanks?, blankSays? (what each says is at its component). Leaves hold
@@ -174,7 +176,8 @@ import { t } from "../../shared/i18n/index.mjs";
 //               giving its markup, its words in the language t() says them in: components/placeholder.mjs
 //               mediaBar); resettable: an empty block of the type
 //               turns into body text on Enter, and the first of its container on Backspace at its start (a
-//               quote's paragraph, a list item: notion-lite's `resettable`, typing/leave.mjs). leaf: the text block a block turned
+//               quote's paragraph, a list item: notion-lite's `resettable`, typing/leave.mjs); emptyToText: Backspace in an
+//               empty block of the type turns it into an empty paragraph where it stands (a heading, small text: typing/leave.mjs). leaf: the text block a block turned
 //               into the type becomes; wraps: such a text block sits in a container of the type, found
 //               by `container` (a selector); text: a plain text leaf; empty: a leaf written with no
 //               text too (a paragraph, a heading, a list item, a code block: an empty
@@ -436,6 +439,12 @@ export const CATEGORY_NAMES = Object.fromEntries(Object.entries(CATEGORIES).map(
  */
 export const COPIED_AS_ITSELF = new Set(Object.entries(UNITS).filter(([kind, unit]) => UNIT_CATEGORY[kind] === "card" || unit.copy === "itself").map(([kind]) => kind));
 
+/**
+ * The unit kinds drawn with no selection fill while selected alone (their own tools show it), each with
+ * the selector its element must hold for that (an image with its picture: a placeholder is filled).
+ */
+export const UNFILLED_ALONE = Object.fromEntries(Object.entries(UNITS).filter(([, unit]) => unit.unfilled).map(([kind, unit]) => [kind, unit.unfilled]));
+
 /** What the reader calls each kind of unit (block labels while dragging, the block menu). */
 export const KIND_NAMES = Object.fromEntries(Object.entries(UNITS).filter(([, unit]) => unit.name).map(([kind, unit]) => [kind, unit.name]));
 
@@ -744,6 +753,9 @@ export const removedFromAnywhere = (kind) => UNITS[kind]?.removedEmpty === "anyw
 const NOTHING_EMPTY = flagged("emptyIsNothing");
 export const TEXT_BLOCKS = [...new Set(Object.values(BLOCK_TYPES).filter((spec) => NOTHING_EMPTY.has(spec.kind)).map((spec) => spec.tag)), ...Object.values(BOXES).filter((box) => box.emptyIsNothing).flatMap((box) => box.classes.map((rule) => `.${rule.class}`))].join(", ");
 
+/** Whether an empty unit of this kind gives its place to a file pasted at its caret (`replacedByFile`). */
+export const replacedByFile = (kind) => Boolean(UNITS[kind]?.replacedByFile);
+
 /** Whether what a unit of this kind is turned into is an empty block in its place (`turnsEmpty`). */
 export const turnsEmpty = (kind) => Boolean(UNITS[kind]?.turnsEmpty);
 
@@ -777,7 +789,7 @@ export const hasOuter = (boxKind) => BOXES[boxKind]?.outer !== false;
 /** The unit kinds with a frame of their own (`boxed`): a double click between two makes a paragraph (insert/). */
 export const BOXED = flagged("boxed");
 
-/** The unit kinds a click to the right of one, past the text area it stands in, selects: the boxed ones and those that say `beside` (beside.mjs). */
+/** The unit kinds a click to the right of one puts the caret after (page/after/): the boxed ones and those that say `beside` (beside.mjs). */
 export const BESIDE = new Set([...BOXED, ...flagged("beside")]);
 
 /** Whether a unit of this kind stands beside another now, `element` being that unit (`beside`, `inRow`). */

package/browser/editor/components/table/index.mjs

@@ -1,3 +1,4 @@
+import { ALIGN_PLACES } from "../align.mjs";
 import { BLOCK_COLORS } from "../colors.mjs";
 import { svg } from "../icons.mjs";
 import { SPAN } from "../../../shared/media.mjs";
@@ -53,10 +54,11 @@ export default {
         { rank: 90, class: "doc-table-wrap" },
       ],
       boxed: true,
+      toggles: ALIGN_PLACES, // the table placed on the page, at the left (the kit's own), centred or at the right: 对齐 ›, a text block's classes (align.mjs)
       resizable: ".doc-table-wrap[data-ge-unit]", // its right and bottom edges, once it is in the file
       copy: "itself", // within the report a copy keeps all of its markup (its scope line, its frame's size); another report's gets the table's data (tableData) made anew
-      // 识别数字列 off, and the key a chart or a view reads it by (src/shared/table-chart.mjs), which 视图 ›
-      // of its menu puts on a table that has none (page/table/views.mjs) in the step that puts the view in.
+      // 识别数字列 off, and the key a chart or a view reads it by (src/shared/table-chart.mjs), which a view
+      // made from a menu puts on a table that has none (page/table/binding.mjs) in the step that makes the view.
       attributes: { [NUMBERS]: (value) => value === "off", [CHART_SOURCE]: (value) => CHART_KEY.test(value) },
       sizes: {
         [SPAN]: { min: 0.15, max: 3 }, // past 1 the table is wider than the text and scrolls in its frame