@heycys/gallery 0.1.0 → 0.1.1

package/browser/editor/components/registry.mjs

@@ -23,6 +23,7 @@ import sheets from "./sheets/index.mjs";
 import table from "./table/index.mjs";
 import widget from "./widget/index.mjs";
 import { CATEGORIES, componentOf } from "../../shared/components/index.mjs";
+import { slotAround } from "../../shared/components/installed.mjs";
 import { COLOR_CLASSES } from "./colors.mjs";
 import { MEDIA_HOSTS } from "./media/parts.mjs";
 import { t } from "../../shared/i18n/index.mjs";
@@ -34,14 +35,16 @@ import { t } from "../../shared/i18n/index.mjs";
 // whose category it takes: a basic block, a container, a card or a whole block (CATEGORIES there).
 // Each describes itself:
 //
-//   listed      what 设置 › 组件 calls it (a function, as the server says it in both languages), for a
+//   listed      what 设置 › 组件列表 calls it (a function, as the server says it in both languages), for a
 //               component the reader meets in the "/" menu or as a block of its own; every component
-//               with a type in that menu says it. hideable: false, it stays offered whatever gallery.json
+//               with a type in that menu says it. Its line there shows the icon of its first row in the
+//               "/" menu (basic before advanced, by place), or, for a component with no type there (分区),
+//               its first unit's `icon`; a listed component with neither throws. hideable: false, it stays offered whatever gallery.json
 //               says, its switch there off and locked (文本, 标题, 列表, 分区): what a page cannot do
 //               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?, 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?, 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
@@ -80,25 +83,30 @@ import { t } from "../../shared/i18n/index.mjs";
 //               the page, each with the test of its values. icon: what its handle shows, for a
 //               kind no block type stands for (a type's own icon is its `types` entry's). removedEmpty:
 //               Backspace on the one empty block in it deletes it whole (a code block, a highlight block,
-//               a quote, a disclosure: typing/). turnsEmpty: it holds nothing to carry, so what it is
+//               a callout, a quote, a disclosure: typing/). turnsEmpty: it holds nothing to carry, so what it is
 //               turned into is an empty block of the type, in its place (a divider line: convert.mjs).
+//               leadsChapter: it may stand first in a chapter as the line above its heading, so a
+//               folded heading with only such blocks before it covers the chapter (a divider: fold/rule.mjs).
 //               canHaveChildren: notion-lite's, a block right after it goes under it by Tab, so the
 //               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.
 //   boxes       the box kinds it defines (containers whose children are units): { [kind]: { role,
-//               name?, classes?, find?, owner?, takenBy?, also?, leaveByEnter?, lead?, firstLineActs?, firstBlock?, groups?, holdsOne?, emptyIsNothing?, outer?, selectAll? } }, classes being the kit's classes that make an element one
+//               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
 //               a unit's box of this kind is (a list item's lists, a disclosure's content, a Sheet area's
-//               panels); owner: the element of its unit that takes the box along (a Sheet panel's tab:
+//               panels, an instance's slots by their name: `find(unit, key)`); owner: the element of its unit that takes the box along (a Sheet panel's tab:
 //               boxOwner); takenBy: whether a unit's element is that one, for a box of this key, told from
 //               the element alone, which may be off the page with the box (takesBox);
 //               also: the unit kinds it takes besides what its role takes (a highlight block's icon);
 //               leaveByEnter: Enter on its empty last block moves that block out after it (typing/leave.mjs);
+//               endIsPadding: what is under its last block is its own padding (a highlight block, a
+//               callout, a disclosure's content): a click there makes no block, it is a gap like any other
+//               (geometry.mjs endOf, insert/ clickBlank);
 //               lead: the kind of unit it opens with as its fixed head, which is no block to fall
 //               between (a highlight block's icon: a box selection passes over it, a place before it is
 //               the place after it); firstLineActs: its first block shows the container's handle, not a
-//               handle of its own (Notion's disableFirstItemHoverMenu: a highlight block's, a quote's);
+//               handle of its own (Notion's disableFirstItemHoverMenu: a highlight block's, a callout's, a quote's);
 //               firstBlock: the type its first block (after its lead) always is, its first line (a
 //               flowchart's node: "paragraph", its title), which is turned into no other type (no
 //               转换为, no Markdown shortcut there) and has nothing made, dropped or pasted before it;
@@ -107,7 +115,7 @@ import { t } from "../../shared/i18n/index.mjs";
 //               groups: a plain <div> with no class in it is a group of blocks, not a block of its own (the
 //               same boxes as the shared descriptions' GROUPING_FLOWS: tests/unit/components.mjs);
 //               holdsOne: a change that leaves it empty puts an empty paragraph in it, so there is always a
-//               block to write in (a disclosure's content, a highlight block: core.mjs tidyEmptied);
+//               block to write in (a disclosure's content, a highlight block, a callout: core.mjs tidyEmptied);
 //               emptyIsNothing: as on a unit, of a box that is an element of its own, by its `classes`;
 //               outer: false, a block straight in it has no block around it for the reader, whatever
 //               stands around its element: no 选中外层 (a detail card's content: block-info.mjs outerOf);
@@ -121,16 +129,17 @@ import { t } from "../../shared/i18n/index.mjs";
 //   sealed      a selector: what stands in such an element is no text of a text block around it, as
 //               a list item holding it (caret.mjs editable): its own text blocks are the only hosts in it
 //   readOnly    why an element of it stays read-only, on hover and on a click (hints/): rules
-//               { rank, at, says }, at a selector found from the element (closest), says the reason
+//               { rank, at, says }, at a selector found from the element (closest), or a function
+//               of the element saying whether the rule is its (an instance's own region, heldBy, which
+//               no selector tells from its slots), says the reason
 //               in the reader's words, or null for an element that needs none, having a tool of its
 //               own. Every component's rules are tried in `rank` order, with the page's (PAGE below),
 //               and the first match wins: a rule ranked below the page's 80 goes before any control's,
 //               and is the one that can claim a button as its own.
-//   hosts       the kinds of text block it defines (data-ge-kind): { [kind]: { name, caps, tex?, wrapped?, parts?, whole?, takes?, opensBefore?, opensAfter?, textFilters?, formula?, closed?, inner?, blankSays?, placeholder? } }, caps
+//   hosts       the kinds of text block it defines (data-ge-kind): { [kind]: { name, caps, tex?, wrapped?, parts?, opensBefore?, textFilters?, formula?, closed?, inner?, blankSays?, placeholder? } }, caps
 //               ({ bound, blockLevel }) giving what such a text block can do (source/); opensBefore:
 //               Enter at its very start, with words in it, puts an empty paragraph before its block
-//               where it does not split, as one that splits does (typing/); opensAfter: Enter at its
-//               very end, a paragraph after its block, where it does not split; textFilters: false, what
+//               where it does not split, as one that splits does (typing/); textFilters: false, what
 //               is typed in it is taken as it is, no inline code, no space set by itself (notion-lite's);
 //               formula: false, no inline formula is offered in it or pasted as one, the kit drawing
 //               none there (takesFormula);
@@ -139,9 +148,7 @@ import { t } from "../../shared/i18n/index.mjs";
 //               nodes say (a code block's code);
 //               parts: the parts of components ([component id, part name]: a part of its shared
 //               description edited as text, src/shared/components/) whose elements are text blocks
-//               of this kind, found so by the server's scan; whole: the element (a selector) that is one
-//               text block of this kind, by the scan too, while it holds inline text alone (a callout); takes: the tag of a
-//               block that, standing alone in `whole` with nothing of its own, natural HTML makes its words; tex: its text is a formula's TeX alone; wrapped: the page makes the text block a
+//               of this kind, found so by the server's scan; tex: its text is a formula's TeX alone; wrapped: the page makes the text block a
 //               span inside the element, which keeps its own behaviour (a Sheet tab's button);
 //               blankSays: what the status line says of one left blank that must hold words, as a
 //               type's says of a block of it (blankSaysOf); placeholder: what one says while it
@@ -152,7 +159,7 @@ import { t } from "../../shared/i18n/index.mjs";
 //               false` says nothing where a block of it would (a list item)
 //   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, host?, box?, leaf?, wraps?, container?, part?, text?, inside?, tex?,
+//               { [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?,
 //               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?,
@@ -165,7 +172,7 @@ import { t } from "../../shared/i18n/index.mjs";
 //               quote's paragraph, a list item: notion-lite's `resettable`, 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, a callout: an empty
+//               text too (a paragraph, a heading, a list item, a code block: an empty
 //               one stays, as Notion's; the page's core.mjs and the server's source/checks.mjs read
 //               this and nothing else); inside: the element its text is written in, as plain text
 //               (a code block's code element); tex: its text is a formula's TeX alone (a display
@@ -180,8 +187,7 @@ import { t } from "../../shared/i18n/index.mjs";
 //               over (page/markdown/rules.mjs); turn: its place among
 //               the types a text block is turned into; fresh: its place among the types made as an
 //               empty block that stands for an empty one; menu: [group, place], its place in the "/"
-//               menu (group "basic" or "advanced"), which the block menu's 在下方新建 shows too; host: the
-//               kind of text block a new one is (`hosts`; "flow" without: core.mjs newHost); corner: the
+//               menu (group "basic" or "advanced"), which the block menu's 在下方新建 shows too; corner: the
 //               type in whose cell of a type grid it sits, as a gray corner, when the grid has both
 //               (type-grid.mjs); preload: true, it needs something on the page as soon as a type grid
 //               offers it, and before a block with text is turned into it, which its page object's
@@ -197,7 +203,7 @@ import { t } from "../../shared/i18n/index.mjs";
 //               paragraph. It returns the node the caret or the choice goes to (null: none); a type
 //               without is a text block, made by convert.mjs standIn.
 //               takesAsIs: a block turned into it goes into it as it is, each keeping its type (a
-//               highlight block, a disclosure); holder: its place among the containers that turn into
+//               highlight block, a callout, a disclosure); holder: its place among the containers that turn into
 //               one another, what they hold carried along; nests: false, none inside another of its
 //               kind; joins: false, a block turned into it never joins the one beside it; leadIcon: the
 //               icon a new one opens with; fromSelection: { label, icon }, its row of the format bar's
@@ -295,8 +301,10 @@ import { t } from "../../shared/i18n/index.mjs";
 // label, width }, or null; reason: why the block may not go, remove(): delete it); rowBeside(target),
 // a row for a block of another component, beside its color, every page object being asked and each
 // testing the block itself; acceptsFile(file), whether a file pasted makes a block of it, and
-// fromFiles(host, files), that block made below the block of `host` (notion-lite's, which gives the
-// data of a new block; the first page object that takes a file in their order); fromLink(figure,
+// fromFiles(put, files), that block made and handed to `put(block)`, the paste's, which puts it where a
+// block pasted at the caret goes (one undo step) and says whether it could (notion-lite's
+// createFromFiles(files, width, place), whose fromFiles gives the data of a new block and whose place
+// the paste gives; the first page object that takes a file in their order); fromLink(figure,
 // url, options), a block of the component filled from an address (notion-lite's, here the figure
 // is there first: one pasted with its address, `{ pasted: true }`, a bookmark in an embed's place).
 // What the rest of the editor asks of a component that does something of its own where every block
@@ -336,8 +344,17 @@ import { t } from "../../shared/i18n/index.mjs";
 // A new kit component gets a folder of its own and a line below.
 export const COMPONENTS = [paragraph, heading, list, flowchart, quote, callout, highlight, details, code, divider, section, sheets, table, figure, image, file, bookmark, embed, columns, math, dialog, widget, icon, installed];
 
-/** The built-in components 设置 › 组件 lists: { id, name() (in the language t() says it in), hideable }, by the order above. */
-export const LISTED_BLOCKS = COMPONENTS.filter((component) => component.listed).map(({ name, listed, hideable = true }) => ({ id: name, name: listed, hideable }));
+// The "/" menu's groups, in order (MENU_GROUPS below says the same).
+const MENU_GROUP_ORDER = ["basic", "advanced"];
+const menuRank = ({ menu }) => MENU_GROUP_ORDER.indexOf(menu[0]) * 1000 + menu[1];
+// The mark of a component's line in 设置 › 组件列表: the icon of its first row in the "/" menu, the
+// same drawing; one with no type there (分区) shows its first unit's (`icon`, a kind no type stands for).
+const listedIcon = ({ types = {}, units = {} }) => Object.values(types).filter((spec) => spec.menu && spec.icon).sort((a, b) => menuRank(a) - menuRank(b))[0]?.icon
+  ?? Object.values(units).find((unit) => unit.icon)?.icon ?? null;
+
+/** The built-in components 设置 › 组件列表 lists: { id, name() (in the language t() says it in), icon (svg markup), hideable }, by the order above. */
+export const LISTED_BLOCKS = COMPONENTS.filter((component) => component.listed).map((component) => ({ id: component.name, name: component.listed, icon: listedIcon(component), hideable: component.hideable ?? true }));
+for (const { id, icon } of LISTED_BLOCKS) if (!icon) throw new Error(`component ${id} has a line in the settings (listed), so it needs an icon: a type in the "/" menu, or a unit's icon`);
 
 /** The names of those the reader may hide. */
 export const HIDEABLE = new Set(LISTED_BLOCKS.filter(({ hideable }) => hideable).map(({ id }) => id));
@@ -487,7 +504,7 @@ export const FRESH = inOrder((spec) => spec.fresh);
 export const HOLDERS = inOrder((spec) => spec.holder);
 
 /** The "/" menu's groups of block types, in order: { basic, advanced } (the menu says their names). */
-export const MENU_GROUPS = Object.fromEntries(["basic", "advanced"].map((group) => [group, inOrder((spec) => (spec.menu?.[0] === group ? spec.menu[1] : undefined))]));
+export const MENU_GROUPS = Object.fromEntries(MENU_GROUP_ORDER.map((group) => [group, inOrder((spec) => (spec.menu?.[0] === group ? spec.menu[1] : undefined))]));
 
 /** The types a block is made of from selected text, each with its row of the format bar's 更多 (`fromSelection`). */
 export const FROM_SELECTION = Object.entries(BLOCK_TYPES).filter(([, spec]) => spec.fromSelection).map(([type, spec]) => ({ type, ...spec.fromSelection }));
@@ -538,9 +555,12 @@ const ONE_BLOCK_AT = ONE_BLOCK.map(({ at }) => at).join(", ");
 /** What no text block around it reaches into (`sealed`), a selector, "" where no component says. */
 export const SEALED = COMPONENTS.map((component) => component.sealed).filter(Boolean).join(", ");
 
+// What is one block is found inside the slot whose inside is the document's region an element stands
+// in, where it does (an instance's slot holds blocks of their own: installed.mjs slotAround).
 const oneBlockOf = (element) => {
-  let whole = element.closest(ONE_BLOCK_AT);
-  for (let around = whole; around; around = around.parentElement?.closest(ONE_BLOCK_AT)) whole = around;
+  const region = slotAround(element);
+  let whole = null;
+  for (let around = element.closest(ONE_BLOCK_AT); around && (!region || region.contains(around)); around = around.parentElement?.closest(ONE_BLOCK_AT)) whole = around;
   return whole && ONE_BLOCK.find(({ at }) => whole.matches(at)).name;
 };
 
@@ -554,7 +574,8 @@ const textPartOf = (element) => TEXT_PARTS.find(({ match, at }) => [...(element.
 
 /**
  * The component an element is of, by name, or null. Nothing inside an element that is one block is
- * anyone else's, whatever its tag or class (a cell's list, a Sheet's tab). Else that of its kind of text
+ * anyone else's, whatever its tag or class (a cell's list, a Sheet's tab), but what an instance's slot
+ * holds, the document's blocks, each its own. Else that of its kind of text
  * block, where a component defines the kind (a cell, a tab's name), that of the text part of a
  * component it is, that of the unit it is (a flowchart's node, though an li) and last that of its type
  * (a list's item made on the page). What stands in a container is its own component's, not the
@@ -598,7 +619,7 @@ export const takesBox = (element, { kind, key }) => Boolean(element && BOXES[kin
 const FROM_WORDS = flagged("fromWords");
 export const PLAIN_TEXT = new Set(Object.keys(BLOCK_TYPES).filter((type) => FROM_WORDS.has(BLOCK_TYPES[type].kind)));
 
-/** Plain text leaves (paragraphs, small text, headings, callouts). */
+/** Plain text leaves (paragraphs, small text, headings). */
 export const TEXT_TYPES = new Set(Object.keys(BLOCK_TYPES).filter((type) => BLOCK_TYPES[type].text));
 
 /** The heading type of each heading tag (H1 -> heading1). */
@@ -682,6 +703,8 @@ const ROLES = Object.fromEntries(Object.entries(BOXES).map(([kind, box]) => [kin
 /** What a chapter is: the page and Sheet panels hold these besides body text. */
 export const CHAPTER = flagged("chapter");
 const FIXED = flagged("fixed"); // never inside a flow
+/** What may stand first in a chapter as the line above its heading (`leadsChapter`: a divider, fold/). */
+export const LEADS_CHAPTER = flagged("leadsChapter");
 
 /** The kinds of box a plain <div> without a class is a group of blocks in (`groups`; source/units.mjs boxKind). */
 export const GROUPING = new Set(Object.keys(BOXES).filter((kind) => BOXES[kind].groups));
@@ -695,6 +718,9 @@ export const HOLDS_ONE = new Set(Object.keys(BOXES).filter((kind) => BOXES[kind]
 /** The box kinds whose empty last block Enter moves out after the box (`leaveByEnter`). */
 export const LEAVES_BY_ENTER = new Set(Object.keys(BOXES).filter((kind) => BOXES[kind].leaveByEnter));
 
+/** Whether what is under the last block of a box of this kind is its own padding (`endIsPadding`): a click there makes no block (geometry.mjs endOf). */
+export const endIsPadding = (boxKind) => Boolean(BOXES[boxKind]?.endIsPadding);
+
 /** The unit kinds Backspace deletes whole once nothing is written in them (`removedEmpty`). */
 export const REMOVED_EMPTY = Object.keys(UNITS).filter((kind) => UNITS[kind].removedEmpty);
 
@@ -742,7 +768,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 selects: the boxed ones and those that say `beside` (beside.mjs). */
+/** 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). */
 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/section/index.mjs

@@ -1,3 +1,4 @@
+import { SECTION_ICON } from "../icons.mjs";
 import { HIGHLIGHT } from "../kit.mjs";
 import { t } from "../../../shared/i18n/index.mjs";
 // 分区: section.doc-section, a container of ordinary blocks (its title is whatever heading it
@@ -18,7 +19,7 @@ export default {
   name: "section",
   listed: () => t("分区"), hideable: false,
   units: {
-    section: { name: t("分区"), match: [{ rank: 40, tag: "section" }], chapter: true, fixed: true, handle: "bar" },
+    section: { name: t("分区"), icon: SECTION_ICON, match: [{ rank: 40, tag: "section" }], chapter: true, fixed: true, handle: "bar" },
   },
   boxes: {
     section: { role: "flow", name: t("分区"), groups: true },

package/browser/editor/components/set-apart.mjs

@@ -0,0 +1,24 @@
+import { escapeText } from "../../shared/escape.mjs";
+
+/**
+ * How a box of blocks set apart (a highlight block, a callout: `match` its elements) is copied, one
+ * rule for both, their clipboard's hooks (registry.mjs `clipboard`) for the block of `type`: its
+ * blocks; one with words straight in it (an Agent's, a callout written the old way), a paragraph of
+ * what it says. A list with its class is a list, and a text block of a type of its own that type.
+ */
+export const setApart = (type, match) => ({
+  describe(node, { isHost, holding, colorOf, copiedType, serializeInner, plain }) {
+    if (!node.matches(match) || node.matches("ul, ol") || (isHost(node) && copiedType(node))) return undefined;
+    const straight = [...node.childNodes].some((child) => child.nodeType === 3 && child.data.trim());
+    const words = isHost(node) ? serializeInner(node) : straight ? escapeText(plain(node)) : null;
+    const blocks = words === null ? holding(node) : [{ type: "paragraph", html: words }];
+    const color = colorOf(node);
+    return blocks ? { type, blocks, ...(color ? { color } : {}) } : null;
+  },
+  endsIn(unit, { blocksIn, boxesOf, colorOf }) {
+    if (!unit.matches(match)) return undefined;
+    const color = colorOf(unit);
+    return [{ type, blocks: blocksIn(boxesOf(unit)), ...(color ? { color } : {}) }];
+  },
+  check: (block, { container }) => container(block),
+});

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

@@ -115,9 +115,11 @@ export const CELL_BOLD = CELL_BOLD_CLASS;
 export const CELL_LOOKS = [...BLOCK_COLORS, ...CELL_ALIGNS.map(([name]) => name), ...CELL_VALIGNS.map(([name]) => name), CELL_BOLD];
 
 /**
- * The look a cell takes when it becomes a header cell (a th: the header row's or column's toggle, a
- * row or column moved there, a cell made there: page.mjs) and loses when it stops being one: bold,
- * and the gray fill unless it has a color of its own. Nothing else of the kit's sets a header apart.
+ * The look a cell takes when it becomes a header row's cell (a th that is no row's header: 标题行's
+ * toggle, a row moved there, a cell made there: page.mjs) and loses when it stops being one: bold,
+ * and the gray fill unless it has a color of its own. A header column's cell (th scope="row") has
+ * none: 标题列 only makes the first column stay when the frame scrolls sideways (the user's,
+ * 2026-11-06). Nothing else of the kit's sets a header apart.
  */
 export const HEADER_LOOK = [CELL_BOLD, "doc-highlight-gray"];
 

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

@@ -35,7 +35,7 @@ export function sharedWidths(wrap, count, share = 1) {
  * `numbers` is false (识别数字列: index.mjs NUMBERS). `looks`, `widths` and `spans` as tableData
  * describes them: each cell's look classes, each column's width, each cell's [rowspan, colspan]
  * (a cell merged makes a row hold fewer cells); where `looks` is given the cells have just those,
- * where not a header cell takes the header's look. `chart`: the key a chart drawn from it reads it
+ * where not a header row's cell takes the header's look (a header column's none). `chart`: the key a chart drawn from it reads it
  * by (its frame's data-doc-chart-source), when it has one.
  */
 export function newTable(doc, { rows, header = false, column = false, numbers = true, looks, widths, spans, chart }) {
@@ -55,7 +55,7 @@ export function newTable(doc, { rows, header = false, column = false, numbers =
       const first = at[r][index] === 0;
       const cell = newCell(doc, head || (column && first) ? "th" : "td", !head && column && first ? "row" : null);
       if (looks) cell.classList.add(...(looks[r][index] ?? "").split(" ").filter(Boolean));
-      else if (cell.localName === "th") headerLook(cell, true);
+      else if (head) headerLook(cell, true);
       const [down, across] = spans?.[r]?.[index] ?? [1, 1];
       setSpan(cell, down, across);
       if (Array.isArray(html)) cell.append(...html);
@@ -139,7 +139,7 @@ export function build({ doc, block, inline }) {
 /**
  * A table standing for an empty block (its type's `create`): three columns, a header row and two rows
  * (the plan's D6), the caret in its first cell (notion-lite's). It is two fifths as wide as the text
- * it stands in, its columns equal and fixed (typing does not move them); 一键调整列宽 is the reader's
+ * it stands in, its columns equal and fixed (typing does not move them); 自动调整列宽 is the reader's
  * to choose (a pasted table has the kit's widths). Its numeric columns are not read (识别数字列 off):
  * typing numbers does not center or sort them.
  */
@@ -164,8 +164,8 @@ export function create({ tables }) {
 
 /**
  * A new cell: a text block made on the page (td, or th with its scope). A header cell made in a
- * header row or column takes the look of the header cell beside it (`model`: lookLike), one of a
- * new table the header's (newTable).
+ * header row takes the look of the header cell beside it (`model`: lookLike), one of a new table
+ * the header's (newTable); a header column's cell is made plain.
  */
 export function newCell(doc, tag = "td", scope = null, model = null) {
   const cell = doc.createElement(tag);
@@ -175,9 +175,15 @@ export function newCell(doc, tag = "td", scope = null, model = null) {
   return cell;
 }
 
-// A cell that becomes a header cell takes the header's look (index.mjs HEADER_LOOK: bold, and the
-// gray fill unless it has a color of its own); one that stops being one loses it. These are looks
-// as any other: the reader may change them.
+// Whether a cell of `tag` and `scope` wears the header row's look (index.mjs HEADER_LOOK): a th that is
+// no row's header. A header column's th (scope="row") has no look of its own: 标题列 only makes the
+// column stay at the left when the frame scrolls sideways (the user's, 2026-11-06).
+const wearsHeaderLook = (tag, scope) => tag === "th" && (scope ?? "").trim().toLowerCase() !== "row";
+
+// A cell that becomes a header row's cell (wearsHeaderLook) takes the header's look (index.mjs
+// HEADER_LOOK: bold, and the gray fill unless it has a color of its own); one that stops being one
+// loses it; a header column's cell has none (标题列 only sticks). These are looks as any other: the
+// reader may change them.
 function headerLook(cell, on) {
   const [bold, fill] = HEADER_LOOK;
   if (!on) return cell.classList.remove(bold, fill);
@@ -185,7 +191,7 @@ function headerLook(cell, on) {
   if (!BLOCK_COLORS.some((name) => cell.classList.contains(name))) cell.classList.add(fill);
 }
 
-// A header cell made beside another of its header row or column: its color and bold as that one's
+// A header cell made beside another of its header row: its color and bold as that one's
 // (a header the reader made plain, or the Agent wrote plain, stays so).
 function lookLike(cell, model) {
   const [bold] = HEADER_LOOK;
@@ -253,10 +259,10 @@ export function columnRange(unit, from, to = from) {
 }
 
 // The cell a new row has in column `c`: as the row it is made beside has it there (a header
-// column's th), never a header row's th.
+// column's th, plain), never a header row's th.
 const cellLike = (doc, slots, r, c) => {
   const model = r === null ? null : slots.matrix[r]?.[c];
-  return model?.localName === "th" && model.getAttribute("scope") === "row" && c === 0 ? newCell(doc, "th", "row", model) : newCell(doc);
+  return model?.localName === "th" && model.getAttribute("scope") === "row" && c === 0 ? newCell(doc, "th", "row") : newCell(doc);
 };
 
 /** A new row at `at` (0 … rows): in the tbody (in the thead only between its rows). Returns it. */
@@ -304,7 +310,7 @@ export function insertColumn(unit, at) {
     const head = row.parentElement.localName === "thead";
     const first = slots.matrix[r][0];
     const beside = slots.matrix[r][Math.max(0, at - 1)];
-    const cell = head ? newCell(doc, "th", null, beside) : at === 0 && headerColumn ? newCell(doc, "th", "row", first) : newCell(doc);
+    const cell = head ? newCell(doc, "th", null, beside) : at === 0 && headerColumn ? newCell(doc, "th", "row") : newCell(doc);
     row.insertBefore(cell, cellFrom(slots, row, at));
     made.push(cell);
     // A header column stays the first: the cell that was first is a plain one now.
@@ -464,7 +470,7 @@ export function labelColumn(unit) {
 
 /**
  * 一键优化 (the table's block menu; a table pasted from elsewhere comes in so): the kit's column
- * widths (一键调整列宽: many columns scroll sideways in the frame), a header row, the first column a
+ * widths (自动调整列宽: many columns scroll sideways in the frame), a header row, the first column a
  * header column when its words are the rows' names, its numeric columns read (识别数字列: centered,
  * sorted by their header), and a frame shown whole (显示全部行) that is taller than the kit's scroll
  * height scrolling again (one that scrolls already stays as it is). Inside one undo step (the
@@ -491,7 +497,7 @@ export function optimizeTable(unit) {
   return changed;
 }
 
-/** The header column on (each body row's cell in the first column th scope="row") or off (td). */
+/** The header column on (each body row's cell in the first column th scope="row") or off (td); its cells' looks untouched either way (the header column only sticks). */
 export function setHeaderColumn(unit, on) {
   const { rows, body, headerColumn, slots } = tableState(unit);
   if (on === headerColumn) return false;
@@ -596,7 +602,7 @@ export function splitCell(unit, cell) {
       const before = cellFrom(slots, rows[r], place.c + place.cols);
       for (let c = place.c; c < place.c + place.cols; c++) {
         if (r === place.r && c === place.c) continue;
-        const piece = rowHeader ? (c === 0 ? newCell(doc, "th", "row", cell) : newCell(doc)) : newCell(doc, cell.localName, null, cell);
+        const piece = rowHeader ? (c === 0 ? newCell(doc, "th", "row") : newCell(doc)) : newCell(doc, cell.localName, null, cell);
         rows[r].insertBefore(piece, before);
         made.push(piece);
       }
@@ -647,11 +653,16 @@ function keepWidths(unit, mutate) {
 /**
  * A cell as a td or th (`scope`: a th's, null for none): a new element of that tag in its place,
  * taking its attributes, a copy of its content (the old cell keeps its own, for undo to put back)
- * and its identity (it stays the same cell to the commits); the header's look taken or lost with it.
+ * and its identity (it stays the same cell to the commits); the header row's look taken or lost when
+ * the cell comes into or leaves the kind that wears it (wearsHeaderLook): a header column's th wears
+ * none, and a cell switched between td and it keeps its looks. A th only given another scope stays
+ * itself unless its look changes (a new element then too, so undo puts its classes back).
  */
 export function retagCell(cell, tag, scope = null) {
   if (!cell) return cell;
-  if (cell.localName === tag) {
+  const look = wearsHeaderLook(tag, tag === "th" ? scope : null);
+  const changes = wearsHeaderLook(cell.localName, cell.getAttribute("scope")) !== look;
+  if (cell.localName === tag && !changes) {
     if (tag === "th" && scope) cell.setAttribute("scope", scope);
     else cell.removeAttribute("scope");
     return cell;
@@ -659,7 +670,7 @@ export function retagCell(cell, tag, scope = null) {
   const next = cell.ownerDocument.createElement(tag);
   for (const { name, value } of [...cell.attributes]) if (name !== "scope") next.setAttribute(name, value);
   if (tag === "th" && scope) next.setAttribute("scope", scope);
-  headerLook(next, tag === "th");
+  if (changes) headerLook(next, look);
   next.append(...[...cell.childNodes].map((node) => node.cloneNode(true)));
   cell.replaceWith(next);
   return next;

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

@@ -26,9 +26,10 @@ const unitOf = (node) => {
 /**
  * The text of `elements` (in page order) as the server reads a block, a line between them: { text,
  * at }, `at[i]` where character `i` comes from ({ node, offset } in a text node, { element } for a
- * formula's TeX, null for a line's end).
+ * formula's TeX, null for a line's end). `skip(child)`: an element of theirs read past (a list item's
+ * blocks, when its own words alone are read: changes/).
  */
-export function readText(elements) {
+export function readText(elements, { skip = null } = {}) {
   let text = "";
   const at = [];
   const put = (char, place) => { text += char; at.push(place); };
@@ -59,7 +60,7 @@ export function readText(elements) {
         space({ element: child });
         continue;
       }
-      if (child.matches(SKIP)) continue;
+      if (child.matches(SKIP) || skip?.(child)) continue;
       const words = isMention(child) ? sourceWords(child) : null;
       if (words !== null) {
         for (const char of words) (/\s/.test(char) ? space : (place) => put(char, place))({ element: child });