@voithos-labs/aragonite 0.10.3 → 0.10.7

package/dist/editor-actions/plugin/container.d.ts

@@ -1,40 +1,38 @@
 /**
- * The container-authoring seam a plugin block component builds on: the built-in
- * container wiring collapsed into one factory, so a plugin never touches an editor
- * context key. Call synchronously during component init — `getContext` reads the
- * ancestor contexts and `useContainerWindowing` sets its own.
+ * What a plugin's container component builds on: the built-in container wiring in one
+ * factory, so a plugin never touches an editor context key. Call synchronously during
+ * component init: `getContext` reads the ancestor contexts and `useContainerWindowing`
+ * sets its own.
  */
-import type { BlockEditActions, CommitAfterTick, FocusActions } from '../../action-contracts';
+import type { BlockEditActions, FocusActions } from '../../action-contracts';
 import type { NodeView } from '../../core/node-views';
 import type { AmbientPrefix, BlockComponent, ContainerBlockComponent } from '../../block-component';
-import { type KindCommandTarget } from '../../schema/block-commands';
+import type { KindCommandTarget } from '../../schema/block-commands';
 import { type PresentationMode } from '../../presentation-mode';
-import { type PluginEditorLookup } from '../../editor-keys';
+import type { EditorContext } from '../../schema/plugin-install';
 import type { WindowResult } from '../../reactivity/block-window.svelte';
 import type { RefSlots } from '../../reactivity/publish-ref.svelte';
-import { type NestedActionsOverrideFactory } from '../nested/nested-actions';
+import type { NestedActionsOverrideFactory } from '../nested/nested-actions';
 /**
- * The frozen inputs the host component feeds in. A function-valued field is a **live
- * read**, re-evaluated on every use; a plain-valued field is static configuration.
- * `getBoxEl` returns the chrome box whose direct `.block-list` child the windowing
- * lookups walk, so chrome siblings beside the list are fine.
+ * The inputs the host component feeds in. A function-valued field is a live read,
+ * re-evaluated on every use; a plain-valued field is static configuration. `getBoxEl` returns
+ * the block's box, whose direct `.block-list` child windowing reads (other elements may sit
+ * beside it). It must read a `$state` element, or the list's first height guesses, made
+ * before the box exists, are never redone.
  */
 export interface ContainerBlockDeps {
     getNode(): NodeView;
     getIndex(): number;
     getPath(): number[];
     getBoxEl(): HTMLElement | undefined;
-    /**
-     * Opt into whole-block focus for an opaque, childless container: the element that
-     * takes DOM focus. The kind must also declare `blockFocus: 'whole-block'`. Supply
-     * a surface for EVERY steady state — a null degrades to the box with a dev warning.
-     */
+    /** The element that takes DOM focus, opting a childless container into whole-block focus (the
+     *  kind also declares `blockFocus: 'whole-block'`); null falls back to the box, with a dev warning. */
     getFocusEl?: () => HTMLElement | null | undefined;
-    /** Escape hatch only: the clamp derives from a declared `reservedChrome.isCollapsed`. */
+    /** Escape hatch only: the collapsed state comes from a declared `reservedChrome.isCollapsed`. */
     isCollapsed?: () => boolean;
-    /** View-state hooks handed to a minted block command as `ctx.hooks`; typed `unknown`. */
+    /** View-state hooks handed to a block command as `ctx.hooks`; typed `unknown`. */
     commandHooks?: () => unknown;
-    /** Ambient prefix painted before the FIRST child's bytes — the listItem `- ` model. */
+    /** The marker prefix drawn before the first child's bytes, like a list item's `- `. */
     getAmbientPrefix?: () => AmbientPrefix;
 }
 /**
@@ -53,85 +51,66 @@ export interface ContainerBlockListProps {
 }
 export type { ContainerBlockComponent };
 export interface ContainerBlock {
-    /** Spread onto `<BlockList {...blockListProps} />` inside the chrome box. */
+    /** Spread onto `<BlockList {...blockListProps} />` inside the block's box. */
     blockListProps: ContainerBlockListProps;
-    /** The live EFFECTIVE mode, for gating edit affordances. Preferred over the DOM probe. */
+    /** The live effective mode, for disabling edit controls. Preferred over reading the DOM. */
     getPresentationMode(): PresentationMode;
     /**
-     * The live editor theme name (`data-editor-theme`). A body painted by an engine
+     * The live editor theme name (`data-editor-theme`). A body drawn by a rendering library
      * rather than CSS must key its render on this and re-render when it changes.
      */
     getTheme(): string;
-    /**
-     * This editor instance's options for the plugin owning this block's kind — the
-     * `{ plugin, options }` entry's channel, so two editors in one process configure the
-     * same kind differently. `unknown`, like `commandHooks`: the plugin narrows it.
-     */
+    /** This editor's options for the plugin owning this block's kind (its `{ plugin, options }`
+     *  entry), so two editors can configure one kind differently. `unknown`: the plugin narrows it. */
     getOptions(): unknown;
-    /** The `BlockComponent` surface the host re-exports for BlockHost. */
+    /** This editor's context for the plugin that owns this block's kind; undefined in a bare
+     *  harness. Its `computeInlineContent` reads the inline syntax this editor draws. */
+    getEditor(): EditorContext | undefined;
+    /** The `BlockComponent` the host re-exports for BlockHost. */
     containerApi: ContainerBlockComponent;
+    /** Commit a shallow metadata patch as one undo entry, through the kind's `rebuildRaw`; the commit
+     *  puts the caret at `caret`, relative to this container (`[]` is the block), once it renders. */
+    updateOwnMetadata(patch: Record<string, unknown>, options?: {
+        caret?: {
+            path: number[];
+            offset: number;
+        };
+    }): void | Promise<void>;
     /**
-     * Commit a shallow metadata patch on THIS container as one undoable entry, through
-     * the kind's `rebuildRaw`. `afterTick` runs once the commit's DOM has settled.
-     */
-    updateOwnMetadata(patch: Record<string, unknown>, afterTick?: CommitAfterTick): void | Promise<void>;
-    /**
-     * Attach to the chrome box: a chord bubbling from an inner leaf resolves against
-     * this kind's keymap. Kind-only, so a bubbled undo/redo never double-fires.
+     * Attach to the block's box: a chord bubbling from an inner leaf resolves against this
+     * kind's keymap. Kind keymap only, so a bubbled undo or redo never fires twice.
      */
     handleKeydown(e: KeyboardEvent): void;
-    /**
-     * Hand the caret to the neighbour a plain arrow points at — the boundary exit for a
-     * plugin-owned editable whose caret has reached its own edge. Routes through the
-     * editor's focus traversal, so the landing inherits skip-non-focusable, container
-     * entry and windowing reveal. False for a modified or non-arrow key: leave it native.
-     */
+    /** Hand the caret, through the editor's focus traversal, to the neighbour a plain arrow points
+     *  at once a plugin editor's caret reaches its edge. False for a modified or non-arrow key. */
     moveFocusOut(e: KeyboardEvent): boolean;
+    /** Read the scroll position before swapping this block's view for one of another height, and
+     *  await the returned restore after the swap renders. A scroll-into-view in progress wins. */
+    captureScrollPosition(): () => Promise<void>;
 }
-/**
- * Collapse-ness has ONE definition: the descriptor's `reservedChrome.isCollapsed`
- * probe. An explicit dep is dev-cross-checked against it, except in reading mode,
- * which cannot write — a reader's open section is legitimately ahead of the document.
- */
-export declare function composeCollapseProbe(explicit: (() => boolean) | undefined, getNode: () => NodeView, getPresentationMode?: () => PresentationMode): () => boolean;
-/**
- * The expand door a reveal opens before descending into a collapsed body. Commits
- * `reservedChrome.expandPatch` as a real undoable edit, not a view-only divergence
- * from the CST; declines in reading mode, which commits nothing.
- */
+/** Collapsed means the descriptor's `reservedChrome.isCollapsed`; a dev build checks an explicit dep
+ *  against it, except in reading mode, where a section the user opened is ahead of the document. */
+export declare function composeCollapseProbe(explicit: (() => boolean) | undefined, getNode: () => NodeView, getPresentationMode: () => PresentationMode): () => boolean;
+/** Open a collapsed body before a descent goes into it, as an undoable commit of
+ *  `reservedChrome.expandPatch`; declines in reading mode, which commits nothing. */
 export declare function composeExpandDoor(deps: {
     getNode: () => NodeView;
     isCollapsed: () => boolean;
     getPresentationMode: () => PresentationMode;
     commit: (patch: Record<string, unknown>) => void | Promise<void>;
 }): () => Promise<boolean>;
-/**
- * The `updateOwnMetadata` gate: reading mode writes no bytes (plugin-contract.md), so the
- * commit declines as a no-op and DEV names the kind that knocked.
- */
-export declare function composeMetadataDoor(deps: {
-    getNode: () => NodeView;
-    getPresentationMode: () => PresentationMode;
-    commit: (patch: Record<string, unknown>, afterTick?: CommitAfterTick) => void | Promise<void>;
-}): ContainerBlock['updateOwnMetadata'];
-/** While collapsed the body is unmounted, so `descendToBody` would mint an invisible one. */
-export declare function gateDescendOnCollapse(isCollapsed: (() => boolean) | undefined, descend: (innerIndex: number) => void | Promise<void>): (innerIndex: number) => Promise<void>;
-/**
- * While collapsed only the chrome row is mounted, so an interior `moveFocus`
- * targeting a body index dead-ends on the unmounted ref. Route body targets past the
- * container instead — the same exit an open container's past-end move takes.
- */
+/** While collapsed the body is unmounted, so `descendToBody` would create an invisible one. */
+export declare function gateDescendOnCollapse(isCollapsed: (() => boolean) | undefined, descend: (innerIndex: number) => Promise<boolean>): (innerIndex: number) => Promise<boolean>;
+/** While collapsed only the title row is mounted, so a `moveFocus` at a body index goes past the
+ *  container instead, as an open container's past-the-end move does. */
 export declare function gateMoveFocusOnCollapse(isCollapsed: (() => boolean) | undefined, moveWithin: FocusActions['moveFocus'], parentFocus: FocusActions, getIndex: () => number): FocusActions['moveFocus'];
 export type NestedActionsOverrides = ReturnType<NestedActionsOverrideFactory>;
-/** Each surface spreads its base first: a gate ADDS a member, never replaces one. */
+/** Each group spreads its base first: a check adds a member, never replaces one. */
 export declare function composeCollapseGates(base: NestedActionsOverrides, gates: {
     descendToBody: NonNullable<BlockEditActions['descendToBody']>;
     moveFocus: FocusActions['moveFocus'];
 }): NestedActionsOverrides;
-/**
- * The kind-command target a plugin container bubbles into `dispatchKindCommand`.
- * `runCommand` is inert — a plugin container owns no built-in kind commands, so a
- * chord resolves only through a registered one.
- */
-export declare function buildContainerKindTarget(deps: Pick<ContainerBlockDeps, 'getNode' | 'commandHooks'>, updateOwnMetadata: ContainerBlock['updateOwnMetadata'], pluginEditor?: PluginEditorLookup): KindCommandTarget;
+/** The kind-command target a plugin container hands to `dispatchKindCommand`. It has no
+ *  `runCommand`, since a plugin container owns no built-in kind commands. */
+export declare function buildContainerKindTarget(deps: Pick<ContainerBlockDeps, 'getNode' | 'commandHooks'>, updateOwnMetadata: ContainerBlock['updateOwnMetadata']): KindCommandTarget;
 export declare function createContainerBlock(deps: ContainerBlockDeps): ContainerBlock;

package/dist/editor-actions/plugin/container.js

@@ -1,49 +1,44 @@
 /**
- * The container-authoring seam a plugin block component builds on: the built-in
- * container wiring collapsed into one factory, so a plugin never touches an editor
- * context key. Call synchronously during component init — `getContext` reads the
- * ancestor contexts and `useContainerWindowing` sets its own.
+ * What a plugin's container component builds on: the built-in container wiring in one
+ * factory, so a plugin never touches an editor context key. Call synchronously during
+ * component init: `getContext` reads the ancestor contexts and `useContainerWindowing`
+ * sets its own.
  */
-import { DEV } from 'esm-env';
+import { isDevChecks } from '../../env';
 import { getContext } from 'svelte';
 import { getBlockKindDescriptor } from '../../schema/block-kind-descriptor';
 import { expandContainerPatch, isCollapsedContainer } from '../../schema/reserved-chrome';
-import { dispatchKindCommand } from '../../schema/block-commands';
-import { eventToChord } from '../../schema/keybindings';
+import { commandForKey } from '../../schema/commands';
 import { isReadingMode } from '../../presentation-mode';
 import { devWarn } from '../../dev-warn';
-import { BLOCK_EDIT_KEY, CONTAINER_EDIT_KEY, EDITOR_DOC_KEY, EDITOR_POLICIES_KEY, EDITOR_SERVICES_KEY, FOCUS_KEY, HISTORY_KEY } from '../../editor-keys';
-import { emitCommandError } from '../../editor-events';
-import { owningPluginEditor } from '../../schema/plugin-install';
-import { createBlockListState } from '../../reactivity/block-list-state.svelte';
+import { blockAccessibleName } from '../../a11y-strings';
+import { EDITOR_DOC_KEY, EDITOR_POLICIES_KEY, EDITOR_SERVICES_KEY } from '../../editor-keys';
+import { componentPluginEditor } from '../../schema/block-component-registry';
 import { useContainerWindowing } from '../../reactivity/use-container-windowing.svelte';
 import { createContainerExitOverrides } from '../container-exit-overrides';
-import { createContainerBlockComponent, focusAcrossBlockEdge, handleEditorGlobalChord, handleWholeBlockKeys } from '../container-block-component';
+import { delegateMoveFocus } from '../focus/focus-dispatch';
+import { createContainerBlockComponent, dispatchContainerChord, dispatchWholeBlockGlobalChord, focusAcrossBlockEdge, handleWholeBlockKeys } from '../container-block-component';
 import { composeWholeBlockFocusSurface, createWholeBlockInputProxy, holdsWholeBlockFocus, isEditableEventTarget } from '../whole-block-focus-surface';
-import { createStandardNestedActions, setNestedActionsContexts } from '../nested/nested-actions';
+import { createContainerActions } from '../nested/container-actions';
 const _conforms = [true, true];
-// ── Collapse gates ───────────────────────────────────────────────────────────
-/**
- * Collapse-ness has ONE definition: the descriptor's `reservedChrome.isCollapsed`
- * probe. An explicit dep is dev-cross-checked against it, except in reading mode,
- * which cannot write — a reader's open section is legitimately ahead of the document.
- */
+// ── Collapsed-container checks ───────────────────────────────────────────────
+/** Collapsed means the descriptor's `reservedChrome.isCollapsed`; a dev build checks an explicit dep
+ *  against it, except in reading mode, where a section the user opened is ahead of the document. */
 export function composeCollapseProbe(explicit, getNode, getPresentationMode) {
     if (!explicit)
         return () => isCollapsedContainer(getNode());
     return () => {
         const value = explicit();
-        if (DEV && value !== isCollapsedContainer(getNode()) && !isReadingMode(getPresentationMode)) {
+        if (isDevChecks() &&
+            value !== isCollapsedContainer(getNode()) &&
+            !isReadingMode(getPresentationMode)) {
             devWarn('plugin-container', `isCollapsed dep disagrees with the declared reservedChrome.isCollapsed probe for kind "${getNode().kind}"`);
         }
         return value;
     };
 }
-/**
- * The expand door a reveal opens before descending into a collapsed body. Commits
- * `reservedChrome.expandPatch` as a real undoable edit, not a view-only divergence
- * from the CST; declines in reading mode, which commits nothing.
- */
+/** Open a collapsed body before a descent goes into it, as an undoable commit of
+ *  `reservedChrome.expandPatch`; declines in reading mode, which commits nothing. */
 export function composeExpandDoor(deps) {
     return async () => {
         if (!deps.isCollapsed() || isReadingMode(deps.getPresentationMode))
@@ -55,46 +50,26 @@ export function composeExpandDoor(deps) {
         return true;
     };
 }
-/**
- * The `updateOwnMetadata` gate: reading mode writes no bytes (plugin-contract.md), so the
- * commit declines as a no-op and DEV names the kind that knocked.
- */
-export function composeMetadataDoor(deps) {
-    return (patch, afterTick) => {
-        if (isReadingMode(deps.getPresentationMode)) {
-            devWarn('plugin-container', `updateOwnMetadata declined: reading mode writes no bytes (kind "${deps.getNode().kind}")`);
-            return;
-        }
-        return deps.commit(patch, afterTick);
-    };
-}
-/** While collapsed the body is unmounted, so `descendToBody` would mint an invisible one. */
+/** While collapsed the body is unmounted, so `descendToBody` would create an invisible one. */
 export function gateDescendOnCollapse(isCollapsed, descend) {
     return async (innerIndex) => {
         if (isCollapsed?.())
-            return;
-        await descend(innerIndex);
+            return false;
+        return descend(innerIndex);
     };
 }
-/**
- * While collapsed only the chrome row is mounted, so an interior `moveFocus`
- * targeting a body index dead-ends on the unmounted ref. Route body targets past the
- * container instead — the same exit an open container's past-end move takes.
- */
+/** While collapsed only the title row is mounted, so a `moveFocus` at a body index goes past the
+ *  container instead, as an open container's past-the-end move does. */
 export function gateMoveFocusOnCollapse(isCollapsed, moveWithin, parentFocus, getIndex) {
     return async (innerIndex, position, options) => {
         if (innerIndex >= 1 && isCollapsed?.()) {
-            // Omit the options arg when unset, mirroring dispatchMoveFocus's own delegation.
-            if (options)
-                await parentFocus.moveFocus(getIndex() + 1, position, options);
-            else
-                await parentFocus.moveFocus(getIndex() + 1, position);
+            await delegateMoveFocus(parentFocus, getIndex() + 1, position, options);
             return;
         }
         await moveWithin(innerIndex, position, options);
     };
 }
-/** Each surface spreads its base first: a gate ADDS a member, never replaces one. */
+/** Each group spreads its base first: a check adds a member, never replaces one. */
 export function composeCollapseGates(base, gates) {
     return {
         ...base,
@@ -103,128 +78,93 @@ export function composeCollapseGates(base, gates) {
     };
 }
 // ── Kind-command target ──────────────────────────────────────────────────────
-/**
- * The kind-command target a plugin container bubbles into `dispatchKindCommand`.
- * `runCommand` is inert — a plugin container owns no built-in kind commands, so a
- * chord resolves only through a registered one.
- */
-export function buildContainerKindTarget(deps, updateOwnMetadata, pluginEditor) {
+/** The kind-command target a plugin container hands to `dispatchKindCommand`. It has no
+ *  `runCommand`, since a plugin container owns no built-in kind commands. */
+export function buildContainerKindTarget(deps, updateOwnMetadata) {
     return {
         get kind() {
             return deps.getNode().kind;
         },
-        runCommand: () => false,
         getCommandContext: () => ({
             node: deps.getNode(),
             updateMetadata: (patch) => {
                 void updateOwnMetadata(patch);
             },
-            hooks: deps.commandHooks?.(),
-            editor: owningPluginEditor(pluginEditor, deps.getNode().kind)
+            hooks: deps.commandHooks?.()
         })
     };
 }
 // ── Factory ──────────────────────────────────────────────────────────────────
 export function createContainerBlock(deps) {
-    const parentBlockEdit = getContext(BLOCK_EDIT_KEY);
-    const parentFocus = getContext(FOCUS_KEY);
-    const parentContainerEdit = getContext(CONTAINER_EDIT_KEY);
-    const history = getContext(HISTORY_KEY);
-    const { stickyColumn, edgeAffinity, selection, reorder, events: editorEvents, registryView, activePlugins } = getContext(EDITOR_SERVICES_KEY);
-    const { keybindingOverrides, presentationMode: getPresentationMode, theme: getTheme } = getContext(EDITOR_POLICIES_KEY);
-    const editorDoc = getContext(EDITOR_DOC_KEY);
-    const pluginEditor = editorDoc?.pluginEditor;
-    const linkRef = editorDoc?.linkRef;
-    // Resolved by the kind's recorded owner, like the kind-command context's `editor`.
-    const getOptions = () => owningPluginEditor(pluginEditor, deps.getNode().kind)?.options;
-    const listState = createBlockListState(deps.getNode);
-    // One live scope over the frozen thunks, shared by every factory this seam wires.
-    // Passed by reference, never spread — spreading would snapshot the getters.
-    const scope = {
-        get index() {
-            return deps.getIndex();
-        },
-        get node() {
-            return deps.getNode();
-        },
-        get path() {
-            return deps.getPath();
-        }
-    };
+    const { caretMemory, selection, scrollOwner, commands } = getContext(EDITOR_SERVICES_KEY);
+    const { theme: getTheme } = getContext(EDITOR_POLICIES_KEY);
+    const { pluginEditor, reading } = getContext(EDITOR_DOC_KEY);
+    const getPresentationMode = reading.mode;
+    const getEditor = () => componentPluginEditor(pluginEditor, deps.getNode().kind);
+    const getOptions = () => getEditor()?.options;
     const collapsed = composeCollapseProbe(deps.isCollapsed, deps.getNode, getPresentationMode);
-    const containerExitOverrides = createContainerExitOverrides({ scope, parentBlockEdit });
-    // All three override the same `defaults`, so they coexist; for a non-collapsing
-    // container the gates are inert.
-    const overrideFactory = (defaults) => composeCollapseGates(containerExitOverrides(defaults), {
-        descendToBody: gateDescendOnCollapse(collapsed, defaults.blockEdit.descendToBody),
-        moveFocus: gateMoveFocusOnCollapse(collapsed, defaults.focus.moveFocus, parentFocus, deps.getIndex)
+    const { state: listState, parent: { blockEdit: parentBlockEdit, focus: parentFocus } } = createContainerActions({
+        getNode: deps.getNode,
+        getIndex: deps.getIndex,
+        getPath: deps.getPath,
+        childList: () => childList,
+        // The exit rules and the collapse gates override the same defaults, so they coexist; for a
+        // container that cannot collapse the gates are inert.
+        overrides: ({ scope, parent, reading }) => (defaults) => composeCollapseGates(createContainerExitOverrides({ scope, parentBlockEdit: parent.blockEdit, reading })(defaults), {
+            descendToBody: gateDescendOnCollapse(collapsed, defaults.blockEdit.descendToBody),
+            moveFocus: gateMoveFocusOnCollapse(collapsed, defaults.focus.moveFocus, parent.focus, deps.getIndex)
+        })
     });
-    const bundle = createStandardNestedActions(listState, {
-        scope,
-        stickyColumn,
-        grammar: registryView.grammar,
-        getPresentationMode,
-        linkRef,
-        parent: {
-            blockEdit: parentBlockEdit,
-            focus: parentFocus,
-            containerEdit: parentContainerEdit
-        }
-    }, overrideFactory);
-    setNestedActionsContexts(bundle);
     const windowing = useContainerWindowing({
-        getIndex: deps.getIndex,
         getParentPath: deps.getPath,
         getChildren: () => deps.getNode().children ?? [],
         getChildIds: () => listState.innerBlockIds,
         getListEl: () => deps.getBoxEl()?.querySelector(':scope > .block-list') ?? null,
-        getOwnEl: () => deps.getBoxEl()?.closest('.block-host') ?? null,
-        provideLeafChannel: true,
         isCollapsed: collapsed
     });
-    // One composed surface feeds the shim AND the keydown gate, so a fallback-focused
-    // box passes the same containment check the affordances use.
+    // One composed focus element feeds the component and the keydown check, so a box focused
+    // by the fallback passes the same containment check the key handling uses.
     const wholeBlockSurface = deps.getFocusEl
         ? composeWholeBlockFocusSurface(deps.getFocusEl, () => deps.getBoxEl(), () => deps.getNode().kind)
         : undefined;
     // The editing host AltGr and IME input arrive through: keydown alone drops both, and a
-    // whole-block kind has no editable surface of its own to catch them.
+    // whole-block kind has no editable element of its own to catch them.
     const inputProxy = wholeBlockSurface
         ? createWholeBlockInputProxy({
             getBoxEl: () => deps.getBoxEl(),
             getFocusEl: wholeBlockSurface,
             isReading: () => isReadingMode(getPresentationMode),
+            getLabel: () => blockAccessibleName(deps.getNode()),
             mint: (text) => void parentBlockEdit.insertParagraph(deps.getIndex() + 1, text)
         })
         : undefined;
-    // Through a closure, not the `updateOwnMetadata` value: that const is declared
-    // below, and is only ever read at reveal time.
-    const expandCollapsed = composeExpandDoor({
-        getNode: deps.getNode,
+    const childList = {
+        count: () => deps.getNode().children?.length ?? 0,
+        refs: listState.refSlots,
+        windowing,
         isCollapsed: collapsed,
-        getPresentationMode,
-        commit: (patch) => updateOwnMetadata(patch)
-    });
+        // Through a closure, not the `updateOwnMetadata` value: that const is declared below.
+        openCollapsed: composeExpandDoor({
+            getNode: deps.getNode,
+            isCollapsed: collapsed,
+            getPresentationMode,
+            commit: (patch) => updateOwnMetadata(patch)
+        })
+    };
     const containerApi = createContainerBlockComponent({
-        // The kind's descriptor is the declaration; the mounted surface only reports it.
+        // The kind's descriptor is the declaration; the mounted component only reports it.
         get editable() {
             return getBlockKindDescriptor(deps.getNode().kind).editable;
         },
         selection,
+        reading,
         get innerBlockRefs() {
             return listState.innerBlockRefs;
         },
-        refSlots: listState.refSlots,
-        get nodeChildrenLength() {
-            return deps.getNode().children?.length ?? 0;
-        },
+        childList,
         get node() {
             return deps.getNode();
         },
-        revealChild: windowing.revealChild,
-        isInWindow: windowing.isInWindow,
-        isCollapsed: collapsed,
-        expandCollapsed,
         getFocusEl: wholeBlockSurface,
         getBoxEl: () => deps.getBoxEl(),
         inputProxy
@@ -243,63 +183,52 @@ export function createContainerBlock(deps) {
         get window() {
             return windowing.window;
         },
-        // Opaque containers are a reorder boundary, so a handle on a chrome or body row
-        // would be dead; the container itself reorders through its parent's BlockList.
-        reorderable: false,
+        // The same declaration the keyboard's reorder reads, so a drag moves what Alt+Arrow moves.
+        get reorderable() {
+            return getBlockKindDescriptor(deps.getNode().kind).reorderChildren !== undefined;
+        },
         get ambientPrefixForFirst() {
             return deps.getAmbientPrefix?.() ?? '';
         }
     };
-    const updateOwnMetadata = composeMetadataDoor({
-        getNode: deps.getNode,
-        getPresentationMode,
-        commit: (patch, afterTick) => parentBlockEdit.updateBlockMetadata(deps.getIndex(), patch, { afterTick })
-    });
-    const kindTarget = buildContainerKindTarget(deps, updateOwnMetadata, pluginEditor);
-    const globalChordDeps = {
-        getKind: () => deps.getNode().kind,
-        history,
-        pluginEditor,
-        onCommandError: (report) => emitCommandError(editorEvents, report),
-        getKeybindingOverrides: keybindingOverrides,
-        isReading: () => isReadingMode(getPresentationMode),
-        activation: activePlugins
+    // Reading mode declines at the commit, which names the write in a dev build.
+    const updateOwnMetadata = async (patch, options) => {
+        await parentBlockEdit.updateBlockMetadata(deps.getIndex(), patch, options);
+    };
+    const kindTarget = buildContainerKindTarget(deps, updateOwnMetadata);
+    // Focused as a whole, the block is the one a reorder chord moves; a key bubbling from an
+    // inner leaf was that leaf's to move.
+    const wholeBlockTarget = {
+        get kind() {
+            return kindTarget.kind;
+        },
+        getCommandContext: kindTarget.getCommandContext,
+        getPath: deps.getPath
     };
+    const commandOf = (e) => commandForKey(e, deps.getNode().kind, commands);
     const handleKeydown = (e) => {
         if (e.defaultPrevented)
             return;
-        const chord = eventToChord(e);
-        // Own-surface only: a chord bubbling from an inner leaf already met the global tier
-        // there, and re-firing it here would double-fire.
-        if (chord && ownsWholeBlockFocus(e) && handleEditorGlobalChord(chord, globalChordDeps)) {
-            e.preventDefault();
+        const ownsFocus = ownsWholeBlockFocus(e);
+        // Only when this block itself holds focus: a chord bubbling from an inner leaf already
+        // met the global chords there, and running it here would fire it twice.
+        if (ownsFocus && dispatchWholeBlockGlobalChord(e, deps.getNode().kind, commands))
             return;
-        }
-        if (chord &&
-            dispatchKindCommand(chord, kindTarget, 
-            // A container bubble carries no range command: the leaf below it owns the format ids.
-            {
-                getPresentationMode,
-                isCrossBlockRange: () => selection.isCrossBlock,
-                crossBlockCommands: undefined
-            }, keybindingOverrides(), (report) => emitCommandError(editorEvents, report))) {
-            e.preventDefault();
+        if (dispatchContainerChord(e, ownsFocus ? wholeBlockTarget : kindTarget, commands))
             return;
-        }
-        handleWholeBlockKeydown(e);
+        if (ownsFocus)
+            handleWholeBlockKeydown(e);
     };
     const moveFocusOut = (e) => {
         if (e.shiftKey || e.altKey || e.ctrlKey || e.metaKey)
             return false;
-        // Classified through the doors before the move (G2.10 / G4.31). A plugin editable
-        // exposes no caret X to measure, so a vertical exit carries the column it arrived
-        // with, exactly as a whole-block pass-through does.
-        stickyColumn.noteKey(e);
-        edgeAffinity.note(e);
+        // A plugin editor exposes no caret x to measure, so a vertical exit keeps the column it
+        // arrived with, exactly as a whole-block pass-through does.
+        caretMemory.noteKey(e, commandOf(e));
         return focusAcrossBlockEdge(e.key, { getIndex: deps.getIndex, focus: parentFocus });
     };
-    // The three gates keep a focused sibling (a toolbar button would double-fire its click
-    // and an Enter split) and a plugin's own editable surface untouched.
+    // The three checks keep a focused sibling (a toolbar button would fire its click and an
+    // Enter split) and a plugin's own editor untouched.
     function ownsWholeBlockFocus(e) {
         if (!wholeBlockSurface)
             return false;
@@ -313,29 +242,17 @@ export function createContainerBlock(deps) {
             return false;
         return !isEditableEventTarget(e.target);
     }
-    // The whole-block-focus affordances, dispatched from the wrapper's bubble phase.
+    // The whole-block key handling, dispatched from the wrapper's bubble phase. A whole-block
+    // element is focusable by tabindex regardless of contenteditable, so it runs in reading mode.
     function handleWholeBlockKeydown(e) {
-        if (!ownsWholeBlockFocus(e))
-            return;
-        // A whole-block surface is tabindex-focusable independent of contenteditable,
-        // so this path is live in reading mode: arrows stay, edits gate.
-        const reading = isReadingMode(getPresentationMode);
-        // Alt-arrow reorder is inline because `runCommand` is inert here, so unlike
-        // ThematicBreak it cannot come from dispatchKindCommand.
-        if (e.altKey && (e.key === 'ArrowUp' || e.key === 'ArrowDown')) {
-            e.preventDefault();
-            if (!reading)
-                void reorder.nudgeReorderUnit(deps.getPath(), e.key === 'ArrowUp' ? -1 : 1);
-            return;
-        }
         handleWholeBlockKeys(e, {
             getIndex: deps.getIndex,
             getRaw: () => deps.getNode().raw,
             blockEdit: parentBlockEdit,
             focus: parentFocus,
-            isReading: () => reading,
-            stickyColumn,
-            edgeAffinity
+            isReading: () => isReadingMode(getPresentationMode),
+            caretMemory,
+            commandOf
         });
     }
     return {
@@ -344,8 +261,10 @@ export function createContainerBlock(deps) {
         updateOwnMetadata,
         handleKeydown,
         moveFocusOut,
+        captureScrollPosition: scrollOwner.keep,
         getPresentationMode,
         getTheme,
-        getOptions
+        getOptions,
+        getEditor
     };
 }

package/dist/editor-actions/plugin/directive-container.d.ts

@@ -1,8 +1,8 @@
 /**
- * `rebuildRaw` factory for a directive-backed container whose reserved child 0 is an
- * editable title emitted into the opener line. Owns the title's return to the opener
- * info, the `children[1:]` body, and the authored `lineEnding` a hand-written copy
- * drops. The no-title sibling is `core/directive`'s `rebuildDirectiveContainerRaw`.
+ * `rebuildRaw` for a directive container whose reserved child 0 is an editable title
+ * written into the opener line. Puts the title back into the opener, serializes
+ * `children[1:]` as the body, and keeps the authored line ending a hand-written copy
+ * would drop. The no-title version is `core/directive`'s `rebuildDirectiveContainerRaw`.
  */
 import { type CstNode } from '../../core/nodes';
 export declare function createDirectiveRebuild<M extends {