@input/pen-core 0.1.1 → 0.1.2

package/dist/index.cjs

@@ -141,6 +141,8 @@ __export(index_exports, {
   interpolateMessage: () => interpolateMessage,
   isBlockSelected: () => isBlockSelected,
   isCollapsed: () => isCollapsed,
+  isContainerBlock: () => isContainerBlock,
+  isContainerBlockType: () => isContainerBlockType,
   isContinuousTextFlowCapability: () => isContinuousTextFlowCapability,
   isMultiBlock: () => isMultiBlock,
   isPseudoLocaleText: () => isPseudoLocaleText,
@@ -200,6 +202,7 @@ __export(index_exports, {
   shouldAllowFlowInsertionInSlashMenu: () => shouldAllowFlowInsertionInSlashMenu,
   shouldExposeBlockInTooling: () => shouldExposeBlockInTooling,
   shouldForceBlockScopedSelectAll: () => shouldForceBlockScopedSelectAll,
+  shouldRenderContainerChildren: () => shouldRenderContainerChildren,
   shouldShowBlockInDefaultMenus: () => shouldShowBlockInDefaultMenus,
   singleController: () => singleController,
   slashMenuGroupOf: () => slashMenuGroupOf,
@@ -2185,7 +2188,7 @@ function schemaDeclaresBlockCapability(schema, capability) {
 }
 
 // src/editor/editor.ts
-var import_pen_types10 = require("@input/pen-types");
+var import_pen_types11 = require("@input/pen-types");
 var import_pen_yjs8 = require("@input/pen-yjs");
 
 // src/editor/events.ts
@@ -2930,6 +2933,7 @@ function opBlockId(_pipeline, op) {
 var import_pen_yjs = require("@input/pen-yjs");
 
 // src/schema/contentType.ts
+var import_pen_types2 = require("@input/pen-types");
 function resolveRuntimeContentType(schema) {
   if (!schema) {
     return "none";
@@ -2939,6 +2943,10 @@ function resolveRuntimeContentType(schema) {
   }
   return schema.content;
 }
+function isContainerBlock(schema) {
+  if (!schema) return false;
+  return (0, import_pen_types2.isNestedContent)(schema.content) || schema.isContainer === true;
+}
 
 // src/editor/rejectedOwnKeys.ts
 var REJECTED_OWN_PROP_KEYS = /* @__PURE__ */ new Set([
@@ -3813,6 +3821,15 @@ function executeOps(pipeline, ops, origin, structural) {
     const blockId = opBlockId(pipeline, op);
     if (!validateOp(pipeline, op)) continue;
     if (op.type === "insert-block") {
+      if (blockExists(pipeline, op.blockId) || pendingBlockIds.has(op.blockId)) {
+        emitPipelineDiagnostic(pipeline, {
+          code: "PEN_APPLY_010",
+          level: "warn",
+          source: "apply",
+          message: `apply: skipping insert-block for already-present block "${op.blockId}"`
+        });
+        continue;
+      }
       pendingBlockIds.add(op.blockId);
       pendingBlockTypes.set(op.blockId, op.blockType);
     }
@@ -6278,9 +6295,11 @@ var SelectionAuthorityImpl = class {
 };
 
 // src/editor/documentState.ts
+var EMPTY_CHILD_IDS = Object.freeze([]);
 var DocumentStateImpl = class {
   _positionIndex;
   _parentIndex;
+  _childIndex;
   _blockOrder;
   _generation = 0;
   _documentProfile;
@@ -6294,6 +6313,7 @@ var DocumentStateImpl = class {
     this._documentProfile = documentProfile;
     this._positionIndex = /* @__PURE__ */ new Map();
     this._parentIndex = /* @__PURE__ */ new Map();
+    this._childIndex = /* @__PURE__ */ new Map();
     this._blockOrder = [];
     this.rebuild();
   }
@@ -6332,6 +6352,9 @@ var DocumentStateImpl = class {
   parentOf(blockId) {
     return this._parentIndex.get(blockId) ?? null;
   }
+  childrenOf(blockId) {
+    return this._childIndex.get(blockId) ?? EMPTY_CHILD_IDS;
+  }
   *allBlocks() {
     const seen = /* @__PURE__ */ new Set();
     for (const id of this._blockOrder) {
@@ -6351,21 +6374,44 @@ var DocumentStateImpl = class {
     this._blockOrder = [];
     this._positionIndex = /* @__PURE__ */ new Map();
     this._parentIndex = /* @__PURE__ */ new Map();
+    this._childIndex = /* @__PURE__ */ new Map();
     for (let i = 0; i < order.length; i++) {
       const id = order.get(i);
       this._blockOrder.push(id);
       this._positionIndex.set(id, i);
     }
+    const nestedChildIds = /* @__PURE__ */ new Set();
+    const parentIdChildIds = [];
     for (const [blockId, blockMap] of this._doc.blocks.entries()) {
       const props = blockMap.get("props");
       if (props?.get?.("parentId")) {
         this._parentIndex.set(blockId, props.get("parentId"));
+        parentIdChildIds.push(blockId);
       }
       const children = blockMap.get("children");
-      if (children) {
+      if (children && children.length > 0) {
+        const childIds = [];
         for (let i = 0; i < children.length; i++) {
-          this._parentIndex.set(children.get(i), blockId);
+          const childId = children.get(i);
+          this._parentIndex.set(childId, blockId);
+          nestedChildIds.add(childId);
+          childIds.push(childId);
         }
+        this._childIndex.set(blockId, childIds);
+      }
+    }
+    parentIdChildIds.sort(
+      (a, b) => (this._positionIndex.get(a) ?? -1) - (this._positionIndex.get(b) ?? -1)
+    );
+    for (const childId of parentIdChildIds) {
+      if (nestedChildIds.has(childId)) continue;
+      const parentId = this._parentIndex.get(childId);
+      if (parentId === void 0) continue;
+      const siblings = this._childIndex.get(parentId);
+      if (siblings === void 0) {
+        this._childIndex.set(parentId, [childId]);
+      } else {
+        siblings.push(childId);
       }
     }
     this._generation++;
@@ -6373,6 +6419,7 @@ var DocumentStateImpl = class {
   clear() {
     this._positionIndex.clear();
     this._parentIndex.clear();
+    this._childIndex.clear();
     this._blockOrder = [];
     this._generation++;
   }
@@ -7596,7 +7643,7 @@ function sameIdList(left, right) {
 }
 
 // src/facets/i18nFacets.ts
-var import_pen_types2 = require("@input/pen-types");
+var import_pen_types3 = require("@input/pen-types");
 function resolveEnvironmentLocale() {
   if (typeof navigator === "object" && navigator !== null) {
     const language = navigator.language;
@@ -7614,7 +7661,7 @@ var messagesFacet = defineFacet({
   name: "pen.messages",
   combine: (inputs) => {
     const catalog = {
-      ...import_pen_types2.DEFAULT_MESSAGE_CATALOG
+      ...import_pen_types3.DEFAULT_MESSAGE_CATALOG
     };
     for (let index = inputs.length - 1; index >= 0; index -= 1) {
       Object.assign(catalog, inputs[index]);
@@ -7636,11 +7683,18 @@ var BACKSPACE_EXIT_TYPES = /* @__PURE__ */ new Set([
   ...CONTAINER_EXIT_TYPES,
   ...HEADING_TYPES
 ]);
-var PARENT_ID_CONTAINER_TYPES = /* @__PURE__ */ new Set([
-  "toggle",
-  "callout",
-  "blockquote"
-]);
+function isContainerBlockType(editor, blockType) {
+  if (!blockType) {
+    return false;
+  }
+  return isContainerBlock(editor.schema.resolve(blockType));
+}
+function shouldRenderContainerChildren(editor, block) {
+  if (!block || !isContainerBlockType(editor, block.type)) {
+    return false;
+  }
+  return block.props?.open !== false;
+}
 function emitCommandDiagnostic(editor, event) {
   editor.internals?.emit("diagnostic", event);
 }
@@ -7692,18 +7746,13 @@ function isInsideParentIdContainer(editor, blockId) {
     return false;
   }
   const parent = editor.getBlock(parentId);
-  return !!parent && PARENT_ID_CONTAINER_TYPES.has(parent.type);
+  return !!parent && isContainerBlockType(editor, parent.type);
 }
 function getRootBlockIds(editor) {
   return editor.documentState.blockOrder.filter(
     (blockId) => editor.documentState.parentOf(blockId) == null
   );
 }
-function getParentIdChildBlockIds(editor, parentBlockId) {
-  return editor.documentState.blockOrder.filter(
-    (blockId) => editor.documentState.parentOf(blockId) === parentBlockId
-  );
-}
 function getVisibleBlockIds(editor) {
   const visibleBlockIds = [];
   for (const rootBlockId of getRootBlockIds(editor)) {
@@ -7825,23 +7874,13 @@ function convertBlockOps(editor, options) {
 }
 function collectVisibleBlockIds(editor, blockId, visibleBlockIds) {
   visibleBlockIds.push(blockId);
-  if (!shouldShowParentIdChildren(editor, blockId)) {
+  if (!shouldRenderContainerChildren(editor, editor.getBlock(blockId))) {
     return;
   }
-  for (const childBlockId of getParentIdChildBlockIds(editor, blockId)) {
+  for (const childBlockId of editor.documentState.childrenOf(blockId)) {
     collectVisibleBlockIds(editor, childBlockId, visibleBlockIds);
   }
 }
-function shouldShowParentIdChildren(editor, blockId) {
-  const block = editor.getBlock(blockId);
-  if (!block || !PARENT_ID_CONTAINER_TYPES.has(block.type)) {
-    return false;
-  }
-  if (block.type !== "toggle") {
-    return true;
-  }
-  return Boolean(block.props?.open);
-}
 
 // src/commands/commandSelection.ts
 function textSelectionResult(anchor, focus = anchor, extras) {
@@ -8017,12 +8056,12 @@ function parentContainerKind(editor, parentId) {
   if (!parent) {
     return null;
   }
-  if (PARENT_ID_CONTAINER_TYPES.has(parent.type)) {
-    return "layout-cell";
-  }
   if (parent.type === "table") {
     return "table";
   }
+  if (isContainerBlockType(editor, parent.type)) {
+    return "layout-cell";
+  }
   return null;
 }
 
@@ -9235,7 +9274,7 @@ function isUndoManager(value) {
 }
 
 // src/commands/structure.ts
-var import_pen_types3 = require("@input/pen-types");
+var import_pen_types4 = require("@input/pen-types");
 var moveBlockUp = defineCommand("pen.moveBlockUp");
 var moveBlockDown = defineCommand("pen.moveBlockDown");
 var duplicateBlock = defineCommand("pen.duplicateBlock");
@@ -9286,7 +9325,7 @@ function handleDuplicateBlock(editor, param) {
   if (!block) {
     return false;
   }
-  const newBlockId = (0, import_pen_types3.generateId)();
+  const newBlockId = (0, import_pen_types4.generateId)();
   const ops = [
     {
       type: "insert-block",
@@ -9319,7 +9358,7 @@ function handleDeleteBlock(editor, param) {
     (blockId) => !blockIds.includes(blockId)
   );
   if (remaining.length === 0) {
-    const replacementId = (0, import_pen_types3.generateId)();
+    const replacementId = (0, import_pen_types4.generateId)();
     editor.apply(
       [
         {
@@ -9893,7 +9932,7 @@ function deleteSelectedBlocks(editor, blockIds) {
 }
 
 // src/commands/textEnter.ts
-var import_pen_types4 = require("@input/pen-types");
+var import_pen_types5 = require("@input/pen-types");
 
 // src/commands/textInsert.ts
 function handleInsertText(editor, param) {
@@ -10080,7 +10119,7 @@ function handleSplitBlock(editor) {
       if (!block) {
         return false;
       }
-      const newBlockId = (0, import_pen_types4.generateId)();
+      const newBlockId = (0, import_pen_types5.generateId)();
       const recipe = buildSplitBlockRecipe({
         block,
         offset: focus.offset,
@@ -10511,12 +10550,12 @@ function getCommandRegistry(editor) {
 }
 
 // src/facets/a11yFacets.ts
-var import_pen_types5 = require("@input/pen-types");
+var import_pen_types6 = require("@input/pen-types");
 function isUsableA11yLabel(value) {
   if (typeof value === "string") {
     return value.trim().length > 0;
   }
-  if (value == null || !(0, import_pen_types5.isA11yLabelledBy)(value)) {
+  if (value == null || !(0, import_pen_types6.isA11yLabelledBy)(value)) {
     return false;
   }
   return value.labelledBy.trim().length > 0;
@@ -10854,7 +10893,7 @@ function sortExtensions(extensions) {
 }
 
 // src/editor/editorApiHelpers.ts
-var import_pen_types6 = require("@input/pen-types");
+var import_pen_types7 = require("@input/pen-types");
 var import_pen_yjs4 = require("@input/pen-yjs");
 
 // src/changes/blockIndex.ts
@@ -10964,19 +11003,19 @@ function toStringMap(value) {
 
 // src/editor/editorApiHelpers.ts
 var FACET_BY_SLOT_KEY = {
-  [import_pen_types6.FIELD_EDITOR_SLOT_KEY]: fieldEditorHostFacet,
-  [import_pen_types6.INPUT_RULES_ENGINE_SLOT_KEY]: inputRulesEngineFacet,
-  [import_pen_types6.UNDO_HISTORY_RESTORE_SLOT_KEY]: undoRestoreControllerFacet,
-  [import_pen_types6.UNDO_HISTORY_METADATA_CONTROLLER_SLOT_KEY]: undoMetadataControllerFacet,
-  [import_pen_types6.INLINE_COMPLETION_SLOT]: aiInlineCompletionFacet,
-  [import_pen_types6.AI_CONTROLLER_SLOT]: aiControllerFacet,
-  [import_pen_types6.AI_INLINE_HISTORY_SLOT]: aiInlineHistoryFacet,
-  [import_pen_types6.AI_REVIEW_CONTROLLER_SLOT]: aiReviewControllerFacet,
-  [import_pen_types6.AI_AUTOCOMPLETE_CONTROLLER_SLOT]: aiAutocompleteControllerFacet,
-  [import_pen_types6.AI_SUGGESTIONS_CONTROLLER_SLOT]: aiSuggestionsControllerFacet,
-  [import_pen_types6.SEARCH_CONTROLLER_SLOT]: searchControllerFacet,
-  [import_pen_types6.MULTIPLAYER_CONTROLLER_SLOT]: multiplayerControllerFacet,
-  [import_pen_types6.SNAPSHOTS_CONTROLLER_SLOT]: snapshotsControllerFacet,
+  [import_pen_types7.FIELD_EDITOR_SLOT_KEY]: fieldEditorHostFacet,
+  [import_pen_types7.INPUT_RULES_ENGINE_SLOT_KEY]: inputRulesEngineFacet,
+  [import_pen_types7.UNDO_HISTORY_RESTORE_SLOT_KEY]: undoRestoreControllerFacet,
+  [import_pen_types7.UNDO_HISTORY_METADATA_CONTROLLER_SLOT_KEY]: undoMetadataControllerFacet,
+  [import_pen_types7.INLINE_COMPLETION_SLOT]: aiInlineCompletionFacet,
+  [import_pen_types7.AI_CONTROLLER_SLOT]: aiControllerFacet,
+  [import_pen_types7.AI_INLINE_HISTORY_SLOT]: aiInlineHistoryFacet,
+  [import_pen_types7.AI_REVIEW_CONTROLLER_SLOT]: aiReviewControllerFacet,
+  [import_pen_types7.AI_AUTOCOMPLETE_CONTROLLER_SLOT]: aiAutocompleteControllerFacet,
+  [import_pen_types7.AI_SUGGESTIONS_CONTROLLER_SLOT]: aiSuggestionsControllerFacet,
+  [import_pen_types7.SEARCH_CONTROLLER_SLOT]: searchControllerFacet,
+  [import_pen_types7.MULTIPLAYER_CONTROLLER_SLOT]: multiplayerControllerFacet,
+  [import_pen_types7.SNAPSHOTS_CONTROLLER_SLOT]: snapshotsControllerFacet,
   "paste:importers": clipboardFacet,
   "paste:assetProvider": assetProviderFacet,
   "undo:manager": undoManagerFacet,
@@ -10985,7 +11024,7 @@ var FACET_BY_SLOT_KEY = {
   "pen.messages": messagesFacet,
   "pen.a11yLabel": a11yLabelFacet,
   "delta-stream:target": streamingTargetFacet,
-  [import_pen_types6.ANNOUNCER_SLOT_KEY]: announcerFacet
+  [import_pen_types7.ANNOUNCER_SLOT_KEY]: announcerFacet
 };
 function writeAssignedSlot(self, key, value) {
   self._slots.set(key, value);
@@ -11057,10 +11096,10 @@ function recordMutationGroupMetadata(editor, origin, groupId) {
     return;
   }
   const controller = self._slots.get(
-    import_pen_types6.UNDO_HISTORY_METADATA_CONTROLLER_SLOT_KEY
+    import_pen_types7.UNDO_HISTORY_METADATA_CONTROLLER_SLOT_KEY
   );
   controller?.setCurrentEntryMetadata(
-    import_pen_types6.MUTATION_GROUP_METADATA_KEY,
+    import_pen_types7.MUTATION_GROUP_METADATA_KEY,
     {
       before: null,
       after: createMutationGroupMetadata(origin, groupId)
@@ -11505,7 +11544,7 @@ function openEditorTextStream(editor, target, options, host) {
 }
 
 // src/editor/editorLifecycle.ts
-var import_pen_types8 = require("@input/pen-types");
+var import_pen_types9 = require("@input/pen-types");
 
 // src/changes/install.ts
 var import_pen_yjs5 = require("@input/pen-yjs");
@@ -11982,11 +12021,11 @@ function flushDeferredCRDTEvent(host) {
 var import_pen_yjs7 = require("@input/pen-yjs");
 
 // src/migrations/runMigrations.ts
-var import_pen_types7 = require("@input/pen-types");
+var import_pen_types8 = require("@input/pen-types");
 var MIGRATION_ORIGIN = "migration";
 function readLedger(editor) {
   const value = editor.internals.doc.metadata.get(
-    import_pen_types7.MIGRATION_LEDGER_METADATA_KEY
+    import_pen_types8.MIGRATION_LEDGER_METADATA_KEY
   );
   if (!Array.isArray(value)) {
     return [];
@@ -11995,7 +12034,7 @@ function readLedger(editor) {
 }
 function writeLedger(editor, ids) {
   const metadata = editor.internals.doc.metadata;
-  metadata.set(import_pen_types7.MIGRATION_LEDGER_METADATA_KEY, [...ids]);
+  metadata.set(import_pen_types8.MIGRATION_LEDGER_METADATA_KEY, [...ids]);
 }
 function bindMigrationApply(editor) {
   const previousApply = editor.apply.bind(editor);
@@ -12356,7 +12395,7 @@ function ensureInitialParagraph(editor) {
     [
       {
         type: "insert-block",
-        blockId: (0, import_pen_types8.generateId)(),
+        blockId: (0, import_pen_types9.generateId)(),
         blockType: "paragraph",
         props: {},
         position: "last"
@@ -12484,7 +12523,7 @@ function stampSummaryCommitId(summary, commitId) {
 }
 
 // src/editor/editorSelectionMutations.ts
-var import_pen_types9 = require("@input/pen-types");
+var import_pen_types10 = require("@input/pen-types");
 function replaceEditorSelection(editor, content) {
   const self = editor;
   const sel = self._selection.getSelection();
@@ -12543,7 +12582,7 @@ function replaceEditorSelection(editor, content) {
       )
     };
     if (typeof content === "string") {
-      const newId = (0, import_pen_types9.generateId)();
+      const newId = (0, import_pen_types10.generateId)();
       ops.push({
         type: "insert-block",
         blockId: newId,
@@ -12563,7 +12602,7 @@ function replaceEditorSelection(editor, content) {
     } else if (Array.isArray(content)) {
       let prevPosition = insertPosition;
       for (const block of content) {
-        const newId = (0, import_pen_types9.generateId)();
+        const newId = (0, import_pen_types10.generateId)();
         ops.push({
           type: "insert-block",
           blockId: newId,
@@ -12919,7 +12958,7 @@ var EditorImpl = class {
   _unsubSummary = null;
   _blockRevisions = /* @__PURE__ */ new Map();
   _decorations;
-  _viewId = (0, import_pen_types10.generateId)();
+  _viewId = (0, import_pen_types11.generateId)();
   _extensionLifecycle = Promise.resolve();
   _facetRegistry;
   _slotDeprecationWarned = /* @__PURE__ */ new Set();
@@ -13390,7 +13429,7 @@ function createHeadlessEditor(options = {}) {
 }
 
 // src/editor/inlineCompletion.ts
-var import_pen_types11 = require("@input/pen-types");
+var import_pen_types12 = require("@input/pen-types");
 var inlineCompletionLeases = /* @__PURE__ */ new WeakMap();
 var InlineCompletionControllerImpl = class {
   constructor(_editor) {
@@ -13455,7 +13494,7 @@ var InlineCompletionControllerImpl = class {
       this._emit();
       return true;
     }
-    const blockId = (0, import_pen_types11.generateId)();
+    const blockId = (0, import_pen_types12.generateId)();
     this._editor.apply(
       [
         {
@@ -13495,7 +13534,7 @@ var InlineCompletionControllerImpl = class {
       type: "block",
       blockId: suggestion2.blockId,
       attributes: {
-        [import_pen_types11.INLINE_COMPLETION_VISIBLE_BLOCK_ATTRIBUTE]: true
+        [import_pen_types12.INLINE_COMPLETION_VISIBLE_BLOCK_ATTRIBUTE]: true
       }
     };
     if (suggestion2.type !== "inline") {
@@ -13566,7 +13605,7 @@ function ensureInlineCompletionController(editor) {
     };
   }
   const controller = new InlineCompletionControllerImpl(editor);
-  editor.internals.assignSlot(import_pen_types11.INLINE_COMPLETION_SLOT, controller);
+  editor.internals.assignSlot(import_pen_types12.INLINE_COMPLETION_SLOT, controller);
   inlineCompletionLeases.set(editor, {
     controller,
     refCount: 1
@@ -13594,7 +13633,7 @@ function createInlineCompletionRelease(editor, controller) {
     }
     inlineCompletionLeases.delete(editor);
     if (getInlineCompletionController(editor) === controller) {
-      editor.internals.assignSlot(import_pen_types11.INLINE_COMPLETION_SLOT, null);
+      editor.internals.assignSlot(import_pen_types12.INLINE_COMPLETION_SLOT, null);
     }
     controller.destroy();
   };
@@ -13727,13 +13766,13 @@ function renderSelectionTargetBlockText(editor, target, options) {
 }
 
 // src/importerUtils.ts
-var import_pen_types12 = require("@input/pen-types");
+var import_pen_types13 = require("@input/pen-types");
 function blocksToOps(blocks, options) {
   const ops = [];
   let position = options?.position ?? "last";
   for (const block of blocks) {
     if (block.type.startsWith("__table")) continue;
-    const blockId = (0, import_pen_types12.generateId)();
+    const blockId = (0, import_pen_types13.generateId)();
     ops.push({
       type: "insert-block",
       blockId,
@@ -13973,7 +14012,7 @@ var urlPolicyFacet = defineFacet({
 });
 
 // src/facets/aiEgressFacet.ts
-var import_pen_types13 = require("@input/pen-types");
+var import_pen_types14 = require("@input/pen-types");
 var aiEgressFacet = defineFacet({
   name: "pen.aiEgress",
   combine: (inputs) => {
@@ -14032,7 +14071,7 @@ function emitInventory(editor, context) {
     return;
   }
   editor.internals.emit("diagnostic", {
-    code: import_pen_types13.AI_EGRESS_INVENTORY_CODE,
+    code: import_pen_types14.AI_EGRESS_INVENTORY_CODE,
     level: "info",
     source: "ai",
     message: "AI request excerpt inventory",
@@ -14045,7 +14084,7 @@ function emitInventory(editor, context) {
 }
 function emitRefused(editor, context) {
   editor.internals.emit("diagnostic", {
-    code: import_pen_types13.AI_REQUEST_REFUSED_CODE,
+    code: import_pen_types14.AI_REQUEST_REFUSED_CODE,
     level: "info",
     source: "ai",
     message: "AI request refused by pen.aiEgress",
@@ -14566,7 +14605,7 @@ var defaultKeymapBindings = {
 };
 
 // src/i18n/messages.ts
-var import_pen_types14 = require("@input/pen-types");
+var import_pen_types15 = require("@input/pen-types");
 function interpolateMessage(template, params) {
   if (!params) {
     return template;
@@ -14583,21 +14622,21 @@ function interpolateMessage(template, params) {
   );
 }
 function resolveMessage(catalog, key, ...args) {
-  const raw = catalog[key] ?? import_pen_types14.DEFAULT_MESSAGE_CATALOG[key];
+  const raw = catalog[key] ?? import_pen_types15.DEFAULT_MESSAGE_CATALOG[key];
   if (raw == null) {
     return "";
   }
-  if ((0, import_pen_types14.isPluralMessage)(raw)) {
+  if ((0, import_pen_types15.isPluralMessage)(raw)) {
     return interpolateMessage(raw.other, args[0]);
   }
   return interpolateMessage(raw, args[0]);
 }
 
 // src/editor/toolExecution.ts
-var import_pen_types15 = require("@input/pen-types");
+var import_pen_types16 = require("@input/pen-types");
 async function collectToolExecutionOutput(result, onPart) {
   const resolved = await result;
-  if (!(0, import_pen_types15.isAsyncIterable)(resolved)) {
+  if (!(0, import_pen_types16.isAsyncIterable)(resolved)) {
     return resolved;
   }
   const parts = [];
@@ -14609,7 +14648,7 @@ async function collectToolExecutionOutput(result, onPart) {
 }
 
 // src/i18n/resolveEditorMessage.ts
-var import_pen_types16 = require("@input/pen-types");
+var import_pen_types17 = require("@input/pen-types");
 
 // src/i18n/formatters.ts
 function formatterKey(locale, options) {
@@ -14668,7 +14707,7 @@ function resolveEditorMessage(editor, key, ...args) {
   return interpolateMessage(selectTemplate(value, locale, params), params);
 }
 function selectTemplate(value, locale, params) {
-  if (!(0, import_pen_types16.isPluralMessage)(value)) {
+  if (!(0, import_pen_types17.isPluralMessage)(value)) {
     return value;
   }
   const count = params?.count;
@@ -14696,7 +14735,7 @@ function emitMissingOnce(editor, key) {
 }
 
 // src/a11y/resolveEditorA11yLabel.ts
-var import_pen_types17 = require("@input/pen-types");
+var import_pen_types18 = require("@input/pen-types");
 var A11Y_MISSING_LABEL_CODE = "a11y-missing-label";
 var missingLabelWarned = /* @__PURE__ */ new WeakSet();
 function resolveEditorA11yLabel(editor) {
@@ -14704,7 +14743,7 @@ function resolveEditorA11yLabel(editor) {
   if (typeof value === "string") {
     return { "aria-label": value };
   }
-  if (value != null && (0, import_pen_types17.isA11yLabelledBy)(value)) {
+  if (value != null && (0, import_pen_types18.isA11yLabelledBy)(value)) {
     return { "aria-labelledby": value.labelledBy };
   }
   warnMissingA11yLabel(editor);
@@ -14730,7 +14769,7 @@ function warnMissingA11yLabel(editor) {
 }
 
 // src/a11y/announceEditorA11y.ts
-var import_pen_types18 = require("@input/pen-types");
+var import_pen_types19 = require("@input/pen-types");
 function announceEditorA11y(editor, key, ...args) {
   const announcer = editor.facet(announcerFacet) ?? null;
   if (!announcer) {
@@ -14749,7 +14788,7 @@ function announceEditorA11y(editor, key, ...args) {
 }
 function resolveA11yBlockTypeLabel(editor, type) {
   const key = `pen.schema.${type}.title`;
-  if ((0, import_pen_types18.isMessageKey)(key)) {
+  if ((0, import_pen_types19.isMessageKey)(key)) {
     const label = resolveEditorMessage(editor, key);
     if (label.length > 0) {
       return label;
@@ -14802,7 +14841,7 @@ function warnMissingSchemaA11y(editor, type) {
 }
 
 // src/i18n/pseudoLocale.ts
-var import_pen_types19 = require("@input/pen-types");
+var import_pen_types20 = require("@input/pen-types");
 var PSEUDO_LOCALE_OPEN = "[[";
 var PSEUDO_LOCALE_CLOSE = " \xB7\xB7\xB7]]";
 function toPseudoLocaleText(text) {
@@ -14812,7 +14851,7 @@ function toPseudoLocaleText(text) {
   return `${PSEUDO_LOCALE_OPEN}${text}${PSEUDO_LOCALE_CLOSE}`;
 }
 function toPseudoLocaleValue(value) {
-  if (!(0, import_pen_types19.isPluralMessage)(value)) {
+  if (!(0, import_pen_types20.isPluralMessage)(value)) {
     return toPseudoLocaleText(value);
   }
   const next = {
@@ -14825,7 +14864,7 @@ function toPseudoLocaleValue(value) {
   }
   return next;
 }
-function createPseudoLocaleCatalog(catalog = import_pen_types19.DEFAULT_MESSAGE_CATALOG) {
+function createPseudoLocaleCatalog(catalog = import_pen_types20.DEFAULT_MESSAGE_CATALOG) {
   const next = {};
   for (const key of Object.keys(catalog)) {
     next[key] = toPseudoLocaleValue(catalog[key]);
@@ -15007,6 +15046,8 @@ function mapOffsetThroughSplices(splices, offset, assoc) {
   interpolateMessage,
   isBlockSelected,
   isCollapsed,
+  isContainerBlock,
+  isContainerBlockType,
   isContinuousTextFlowCapability,
   isMultiBlock,
   isPseudoLocaleText,
@@ -15066,6 +15107,7 @@ function mapOffsetThroughSplices(splices, offset, assoc) {
   shouldAllowFlowInsertionInSlashMenu,
   shouldExposeBlockInTooling,
   shouldForceBlockScopedSelectAll,
+  shouldRenderContainerChildren,
   shouldShowBlockInDefaultMenus,
   singleController,
   slashMenuGroupOf,

package/dist/index.d.cts

@@ -504,6 +504,19 @@ interface NormalPositionSnapshot {
  */
 declare function snapToNormalPosition(doc: NormalPositionSnapshot, point: Point, direction: NormalPositionDirection): NextNormalPositionResult;
 
+/**
+ * Whether a block type holds child blocks, resolved from its schema rather than
+ * from a hardcoded type list — host-defined containers count too.
+ */
+declare function isContainerBlockType(editor: Editor, blockType: string | null | undefined): boolean;
+/**
+ * Whether a container's children participate in rendering and navigation.
+ *
+ * Collapsing is expressed by the block's own `open` prop, so any container that
+ * declares one is collapsible. `toggle` defaults `open` to `false` and so stays
+ * collapsed until opened; containers without the prop always show children.
+ */
+declare function shouldRenderContainerChildren(editor: Editor, block: BlockHandle | null | undefined): boolean;
 /**
  * Ops that change one block's type in place, keeping its id and its text.
  *
@@ -910,6 +923,15 @@ declare const outdent: _input_pen_types.Command<void>;
 declare const toggleMark: _input_pen_types.Command<ToggleMarkParam>;
 declare const convertBlock: _input_pen_types.Command<ConvertBlockParam>;
 
+/**
+ * Whether a block type holds child blocks, by either route: a nested-content
+ * schema, or the `parentId` convention that `isContainer` marks.
+ *
+ * This is the single authority for the question. Callers must not test block
+ * type names — a hardcoded set silently excludes every host-defined container.
+ */
+declare function isContainerBlock(schema: BlockSchema | null | undefined): boolean;
+
 interface StructureBlockParam {
     readonly blockId?: string;
 }
@@ -1021,4 +1043,4 @@ declare function affectedBlockIdsFromSummary(summary: Pick<ChangeSummary, "block
  */
 declare function mapOffsetThroughSplices(splices: readonly TextSplice[], offset: number, assoc: Assoc): number;
 
-export { A11Y_MISSING_LABEL_CODE, APPLY_STORM_CODE, APPLY_STORM_QUEUE_LIMIT, type BeforeApplyHook, type BlockDirection, type BlockDirectionResolver, type BlockDirectionSetting, type CaretMotionParam, type CellCaretFocus, type CellCaretWrite, type ClipboardHandler, type CommandDispatchContext, type CommandHandlerTable, type CommandRegistry, type ContentMove, type ConvertBlockParam, type CreateCommandRegistryOptions, type CreateFacetRegistryOptions, type CreateHeadlessEditorOptions, type DecorationSource, type DefaultKeymapBinding, type DefaultKeymapContext, type DefinedBlockSchema, type DeleteGranularity, type DeleteParam, type DocumentMigration, DocumentRangeImpl, type EditorA11yLabelAttrs, EventEmitter, ExtensionManagerImpl, type FacetRegistry, type FacetSettleInput, HOOK_PRIORITIES, type InsertTextParam, type Keymap, type KeymapPlatform, type MigrationReport, type NormalPositionSnapshot, PIPELINE_PHASES, PSEUDO_LOCALE_CLOSE, PSEUDO_LOCALE_OPEN, type PendingBlock, type PendingBlockImportPolicyViolation, type PendingBlockProfilePolicyViolation, type ProfilePolicyViolation, type SchemaA11yAttrs, type SchemaA11yKind, SchemaEngineImpl, type SchemaRegistryConfig, SchemaRegistryImpl, type SelectBlockParam, SelectionAuthorityImpl as SelectionAuthority, type StructureBlockParam, type ToggleMarkParam, type UrlContext, type UrlPolicy, type VerticalCaretDirection, type VerticalCaretMeasure, type VerticalCaretMeasureResult, type VerticalCaretPoint, type WordRange, a11yLabelFacet, affectedBlockIdsFromSummary, aiAutocompleteControllerFacet, aiControllerFacet, aiEgressExtension, aiEgressFacet, aiInlineCompletionFacet, aiInlineHistoryFacet, aiReviewControllerFacet, aiSuggestionsControllerFacet, announceEditorA11y, announcerFacet, applyDirectedBinding, applyMergeBlocks, applySplitBlock, ariaReadOnlyFacet, assetProviderFacet, beforeApplyFacet, blockDirectionFacet, blockLogicalText, blocksToOps, buildMergeBlocksRecipe, buildNormalPositionSnapshot, buildSplitBlockRecipe, buildTableChildren, builtinCommandHandlers, caretBlockEnd, caretBlockStart, caretDocEnd, caretDocStart, caretDown, caretLeft, caretLineEnd, caretLineStart, caretRight, caretUp, caretWordLeft, caretWordRight, clipboardFacet, collectEditorKeyBindings, collectToolExecutionOutput, commandHandler, commandsFacet, convertBlock, convertBlockOps, createAppHandle, createBlockHandle, createCommandRegistry, createDecorationSet, createDocumentSession, createEditor, createEmptySchema, createFacetRegistry, createHeadlessEditor, createImportResult, createMutationGroupMetadata, createPseudoLocaleCatalog, createTextSelection, decorationsFacet, deepEqual, defaultDirectionFacet, defaultKeymapBindings, defineBlock, defineCommand, defineExtension, defineFacet, delegatesToGridEditing, deleteAdjacentInlineAtom, deleteBackward, deleteBlock, deleteForward, deriveContentMoves, duplicateBlock, emptyDecorationSet, ensureInlineCompletionController, fieldEditorHostFacet, filterAIRequest, filterOpsForDocumentProfile, filterPendingBlocksForDocumentProfile, foldAndNormalize, getApplyOptionsGroupId, getBlockSelectionRoleFromSchema, getBlockSelectionRoleFromType, getCellCaretFocus, getCommandRegistry, getEditorSelectionRecord, getFlowCapabilityFromSchema, getFlowCapabilityFromType, getInlineCompletionController, getNumberedListItemValue, getOpOriginGroupId, getOpOriginType, getSelectionBlockRange, getVerticalCaretGoalX, getVerticalCaretMeasure, hasFieldEditorSurface, hasIndexedCellSelectionMetadata, historyRedo, historyUndo, hookPriorityToPrecedence, indent, inputRulesEngineFacet, inputRulesFacet, insertLineBreak, insertText, interpolateMessage, isBlockSelected, isCollapsed, isContinuousTextFlowCapability, isMultiBlock, isPseudoLocaleText, keyBindingPriorityToPrecedence, keymapFacet, localeFacet, mapOffsetThroughSplices, mergeDecorationSets, mergeSchemas, messagesFacet, moveBlockDown, moveBlockUp, multiplayerControllerFacet, nextGraphemeBoundary, nextWordBoundary, normalizePendingBlocksForImport, orderSlashMenuItemsByGroup, outdent, previousGraphemeBoundary, previousWordBoundary, priorityToPrecedence, prop, renderSelectionTargetBlockText, renderSelectionTargetText, repairAnchor, reportPendingBlockImportViolations, reportPendingBlockProfileViolations, resolveA11yBlockTypeLabel, resolveA11ySpec, resolveBlockDirection, resolveBlockFlowCapability, resolveCellSelectionCoord, resolveCellSelectionMatrix, resolveDefaultKeymap, resolveDirectedBinding, resolveDirectedCommand, resolveEditorA11yLabel, resolveEditorMessage, resolveEditorSchema, resolveFieldEditorBehavior, resolveFieldEditorInputMode, resolveFocusBlockDirection, resolveMessage, resolveSchema, resolveSchemaA11y, resolveSelectionTargetBlockIds, runMigrations, searchControllerFacet, selectAdjacentInlineAtom, selectAll, selectBlock, selectionToRange, setCellCaretFocus, setVerticalCaretGoalX, setVerticalCaretMeasure, shouldAllowDirectBlockPaste, shouldAllowFlowInsertionInSlashMenu, shouldExposeBlockInTooling, shouldForceBlockScopedSelectAll, shouldShowBlockInDefaultMenus, singleController, slashMenuGroupOf, snapToNormalPosition, snapshotsControllerFacet, sortDeltaAttributes, spliceDeleteOp, spliceInsertOp, splitBlock, streamThroughEgress, streamingTargetFacet, suggestion, supportsInlineInputRules, supportsInlineMarks, tableCellDown, tableCellNext, tableCellPrev, tableEscapeGrid, toPseudoLocaleText, toggleMark, toolRuntimeFacet, undoManagerFacet, undoMetadataControllerFacet, undoRestoreControllerFacet, urlPolicy, urlPolicyFacet, usesInlineTextSelection, wordRangeAt };
+export { A11Y_MISSING_LABEL_CODE, APPLY_STORM_CODE, APPLY_STORM_QUEUE_LIMIT, type BeforeApplyHook, type BlockDirection, type BlockDirectionResolver, type BlockDirectionSetting, type CaretMotionParam, type CellCaretFocus, type CellCaretWrite, type ClipboardHandler, type CommandDispatchContext, type CommandHandlerTable, type CommandRegistry, type ContentMove, type ConvertBlockParam, type CreateCommandRegistryOptions, type CreateFacetRegistryOptions, type CreateHeadlessEditorOptions, type DecorationSource, type DefaultKeymapBinding, type DefaultKeymapContext, type DefinedBlockSchema, type DeleteGranularity, type DeleteParam, type DocumentMigration, DocumentRangeImpl, type EditorA11yLabelAttrs, EventEmitter, ExtensionManagerImpl, type FacetRegistry, type FacetSettleInput, HOOK_PRIORITIES, type InsertTextParam, type Keymap, type KeymapPlatform, type MigrationReport, type NormalPositionSnapshot, PIPELINE_PHASES, PSEUDO_LOCALE_CLOSE, PSEUDO_LOCALE_OPEN, type PendingBlock, type PendingBlockImportPolicyViolation, type PendingBlockProfilePolicyViolation, type ProfilePolicyViolation, type SchemaA11yAttrs, type SchemaA11yKind, SchemaEngineImpl, type SchemaRegistryConfig, SchemaRegistryImpl, type SelectBlockParam, SelectionAuthorityImpl as SelectionAuthority, type StructureBlockParam, type ToggleMarkParam, type UrlContext, type UrlPolicy, type VerticalCaretDirection, type VerticalCaretMeasure, type VerticalCaretMeasureResult, type VerticalCaretPoint, type WordRange, a11yLabelFacet, affectedBlockIdsFromSummary, aiAutocompleteControllerFacet, aiControllerFacet, aiEgressExtension, aiEgressFacet, aiInlineCompletionFacet, aiInlineHistoryFacet, aiReviewControllerFacet, aiSuggestionsControllerFacet, announceEditorA11y, announcerFacet, applyDirectedBinding, applyMergeBlocks, applySplitBlock, ariaReadOnlyFacet, assetProviderFacet, beforeApplyFacet, blockDirectionFacet, blockLogicalText, blocksToOps, buildMergeBlocksRecipe, buildNormalPositionSnapshot, buildSplitBlockRecipe, buildTableChildren, builtinCommandHandlers, caretBlockEnd, caretBlockStart, caretDocEnd, caretDocStart, caretDown, caretLeft, caretLineEnd, caretLineStart, caretRight, caretUp, caretWordLeft, caretWordRight, clipboardFacet, collectEditorKeyBindings, collectToolExecutionOutput, commandHandler, commandsFacet, convertBlock, convertBlockOps, createAppHandle, createBlockHandle, createCommandRegistry, createDecorationSet, createDocumentSession, createEditor, createEmptySchema, createFacetRegistry, createHeadlessEditor, createImportResult, createMutationGroupMetadata, createPseudoLocaleCatalog, createTextSelection, decorationsFacet, deepEqual, defaultDirectionFacet, defaultKeymapBindings, defineBlock, defineCommand, defineExtension, defineFacet, delegatesToGridEditing, deleteAdjacentInlineAtom, deleteBackward, deleteBlock, deleteForward, deriveContentMoves, duplicateBlock, emptyDecorationSet, ensureInlineCompletionController, fieldEditorHostFacet, filterAIRequest, filterOpsForDocumentProfile, filterPendingBlocksForDocumentProfile, foldAndNormalize, getApplyOptionsGroupId, getBlockSelectionRoleFromSchema, getBlockSelectionRoleFromType, getCellCaretFocus, getCommandRegistry, getEditorSelectionRecord, getFlowCapabilityFromSchema, getFlowCapabilityFromType, getInlineCompletionController, getNumberedListItemValue, getOpOriginGroupId, getOpOriginType, getSelectionBlockRange, getVerticalCaretGoalX, getVerticalCaretMeasure, hasFieldEditorSurface, hasIndexedCellSelectionMetadata, historyRedo, historyUndo, hookPriorityToPrecedence, indent, inputRulesEngineFacet, inputRulesFacet, insertLineBreak, insertText, interpolateMessage, isBlockSelected, isCollapsed, isContainerBlock, isContainerBlockType, isContinuousTextFlowCapability, isMultiBlock, isPseudoLocaleText, keyBindingPriorityToPrecedence, keymapFacet, localeFacet, mapOffsetThroughSplices, mergeDecorationSets, mergeSchemas, messagesFacet, moveBlockDown, moveBlockUp, multiplayerControllerFacet, nextGraphemeBoundary, nextWordBoundary, normalizePendingBlocksForImport, orderSlashMenuItemsByGroup, outdent, previousGraphemeBoundary, previousWordBoundary, priorityToPrecedence, prop, renderSelectionTargetBlockText, renderSelectionTargetText, repairAnchor, reportPendingBlockImportViolations, reportPendingBlockProfileViolations, resolveA11yBlockTypeLabel, resolveA11ySpec, resolveBlockDirection, resolveBlockFlowCapability, resolveCellSelectionCoord, resolveCellSelectionMatrix, resolveDefaultKeymap, resolveDirectedBinding, resolveDirectedCommand, resolveEditorA11yLabel, resolveEditorMessage, resolveEditorSchema, resolveFieldEditorBehavior, resolveFieldEditorInputMode, resolveFocusBlockDirection, resolveMessage, resolveSchema, resolveSchemaA11y, resolveSelectionTargetBlockIds, runMigrations, searchControllerFacet, selectAdjacentInlineAtom, selectAll, selectBlock, selectionToRange, setCellCaretFocus, setVerticalCaretGoalX, setVerticalCaretMeasure, shouldAllowDirectBlockPaste, shouldAllowFlowInsertionInSlashMenu, shouldExposeBlockInTooling, shouldForceBlockScopedSelectAll, shouldRenderContainerChildren, shouldShowBlockInDefaultMenus, singleController, slashMenuGroupOf, snapToNormalPosition, snapshotsControllerFacet, sortDeltaAttributes, spliceDeleteOp, spliceInsertOp, splitBlock, streamThroughEgress, streamingTargetFacet, suggestion, supportsInlineInputRules, supportsInlineMarks, tableCellDown, tableCellNext, tableCellPrev, tableEscapeGrid, toPseudoLocaleText, toggleMark, toolRuntimeFacet, undoManagerFacet, undoMetadataControllerFacet, undoRestoreControllerFacet, urlPolicy, urlPolicyFacet, usesInlineTextSelection, wordRangeAt };

package/dist/index.d.ts

@@ -504,6 +504,19 @@ interface NormalPositionSnapshot {
  */
 declare function snapToNormalPosition(doc: NormalPositionSnapshot, point: Point, direction: NormalPositionDirection): NextNormalPositionResult;
 
+/**
+ * Whether a block type holds child blocks, resolved from its schema rather than
+ * from a hardcoded type list — host-defined containers count too.
+ */
+declare function isContainerBlockType(editor: Editor, blockType: string | null | undefined): boolean;
+/**
+ * Whether a container's children participate in rendering and navigation.
+ *
+ * Collapsing is expressed by the block's own `open` prop, so any container that
+ * declares one is collapsible. `toggle` defaults `open` to `false` and so stays
+ * collapsed until opened; containers without the prop always show children.
+ */
+declare function shouldRenderContainerChildren(editor: Editor, block: BlockHandle | null | undefined): boolean;
 /**
  * Ops that change one block's type in place, keeping its id and its text.
  *
@@ -910,6 +923,15 @@ declare const outdent: _input_pen_types.Command<void>;
 declare const toggleMark: _input_pen_types.Command<ToggleMarkParam>;
 declare const convertBlock: _input_pen_types.Command<ConvertBlockParam>;
 
+/**
+ * Whether a block type holds child blocks, by either route: a nested-content
+ * schema, or the `parentId` convention that `isContainer` marks.
+ *
+ * This is the single authority for the question. Callers must not test block
+ * type names — a hardcoded set silently excludes every host-defined container.
+ */
+declare function isContainerBlock(schema: BlockSchema | null | undefined): boolean;
+
 interface StructureBlockParam {
     readonly blockId?: string;
 }
@@ -1021,4 +1043,4 @@ declare function affectedBlockIdsFromSummary(summary: Pick<ChangeSummary, "block
  */
 declare function mapOffsetThroughSplices(splices: readonly TextSplice[], offset: number, assoc: Assoc): number;
 
-export { A11Y_MISSING_LABEL_CODE, APPLY_STORM_CODE, APPLY_STORM_QUEUE_LIMIT, type BeforeApplyHook, type BlockDirection, type BlockDirectionResolver, type BlockDirectionSetting, type CaretMotionParam, type CellCaretFocus, type CellCaretWrite, type ClipboardHandler, type CommandDispatchContext, type CommandHandlerTable, type CommandRegistry, type ContentMove, type ConvertBlockParam, type CreateCommandRegistryOptions, type CreateFacetRegistryOptions, type CreateHeadlessEditorOptions, type DecorationSource, type DefaultKeymapBinding, type DefaultKeymapContext, type DefinedBlockSchema, type DeleteGranularity, type DeleteParam, type DocumentMigration, DocumentRangeImpl, type EditorA11yLabelAttrs, EventEmitter, ExtensionManagerImpl, type FacetRegistry, type FacetSettleInput, HOOK_PRIORITIES, type InsertTextParam, type Keymap, type KeymapPlatform, type MigrationReport, type NormalPositionSnapshot, PIPELINE_PHASES, PSEUDO_LOCALE_CLOSE, PSEUDO_LOCALE_OPEN, type PendingBlock, type PendingBlockImportPolicyViolation, type PendingBlockProfilePolicyViolation, type ProfilePolicyViolation, type SchemaA11yAttrs, type SchemaA11yKind, SchemaEngineImpl, type SchemaRegistryConfig, SchemaRegistryImpl, type SelectBlockParam, SelectionAuthorityImpl as SelectionAuthority, type StructureBlockParam, type ToggleMarkParam, type UrlContext, type UrlPolicy, type VerticalCaretDirection, type VerticalCaretMeasure, type VerticalCaretMeasureResult, type VerticalCaretPoint, type WordRange, a11yLabelFacet, affectedBlockIdsFromSummary, aiAutocompleteControllerFacet, aiControllerFacet, aiEgressExtension, aiEgressFacet, aiInlineCompletionFacet, aiInlineHistoryFacet, aiReviewControllerFacet, aiSuggestionsControllerFacet, announceEditorA11y, announcerFacet, applyDirectedBinding, applyMergeBlocks, applySplitBlock, ariaReadOnlyFacet, assetProviderFacet, beforeApplyFacet, blockDirectionFacet, blockLogicalText, blocksToOps, buildMergeBlocksRecipe, buildNormalPositionSnapshot, buildSplitBlockRecipe, buildTableChildren, builtinCommandHandlers, caretBlockEnd, caretBlockStart, caretDocEnd, caretDocStart, caretDown, caretLeft, caretLineEnd, caretLineStart, caretRight, caretUp, caretWordLeft, caretWordRight, clipboardFacet, collectEditorKeyBindings, collectToolExecutionOutput, commandHandler, commandsFacet, convertBlock, convertBlockOps, createAppHandle, createBlockHandle, createCommandRegistry, createDecorationSet, createDocumentSession, createEditor, createEmptySchema, createFacetRegistry, createHeadlessEditor, createImportResult, createMutationGroupMetadata, createPseudoLocaleCatalog, createTextSelection, decorationsFacet, deepEqual, defaultDirectionFacet, defaultKeymapBindings, defineBlock, defineCommand, defineExtension, defineFacet, delegatesToGridEditing, deleteAdjacentInlineAtom, deleteBackward, deleteBlock, deleteForward, deriveContentMoves, duplicateBlock, emptyDecorationSet, ensureInlineCompletionController, fieldEditorHostFacet, filterAIRequest, filterOpsForDocumentProfile, filterPendingBlocksForDocumentProfile, foldAndNormalize, getApplyOptionsGroupId, getBlockSelectionRoleFromSchema, getBlockSelectionRoleFromType, getCellCaretFocus, getCommandRegistry, getEditorSelectionRecord, getFlowCapabilityFromSchema, getFlowCapabilityFromType, getInlineCompletionController, getNumberedListItemValue, getOpOriginGroupId, getOpOriginType, getSelectionBlockRange, getVerticalCaretGoalX, getVerticalCaretMeasure, hasFieldEditorSurface, hasIndexedCellSelectionMetadata, historyRedo, historyUndo, hookPriorityToPrecedence, indent, inputRulesEngineFacet, inputRulesFacet, insertLineBreak, insertText, interpolateMessage, isBlockSelected, isCollapsed, isContinuousTextFlowCapability, isMultiBlock, isPseudoLocaleText, keyBindingPriorityToPrecedence, keymapFacet, localeFacet, mapOffsetThroughSplices, mergeDecorationSets, mergeSchemas, messagesFacet, moveBlockDown, moveBlockUp, multiplayerControllerFacet, nextGraphemeBoundary, nextWordBoundary, normalizePendingBlocksForImport, orderSlashMenuItemsByGroup, outdent, previousGraphemeBoundary, previousWordBoundary, priorityToPrecedence, prop, renderSelectionTargetBlockText, renderSelectionTargetText, repairAnchor, reportPendingBlockImportViolations, reportPendingBlockProfileViolations, resolveA11yBlockTypeLabel, resolveA11ySpec, resolveBlockDirection, resolveBlockFlowCapability, resolveCellSelectionCoord, resolveCellSelectionMatrix, resolveDefaultKeymap, resolveDirectedBinding, resolveDirectedCommand, resolveEditorA11yLabel, resolveEditorMessage, resolveEditorSchema, resolveFieldEditorBehavior, resolveFieldEditorInputMode, resolveFocusBlockDirection, resolveMessage, resolveSchema, resolveSchemaA11y, resolveSelectionTargetBlockIds, runMigrations, searchControllerFacet, selectAdjacentInlineAtom, selectAll, selectBlock, selectionToRange, setCellCaretFocus, setVerticalCaretGoalX, setVerticalCaretMeasure, shouldAllowDirectBlockPaste, shouldAllowFlowInsertionInSlashMenu, shouldExposeBlockInTooling, shouldForceBlockScopedSelectAll, shouldShowBlockInDefaultMenus, singleController, slashMenuGroupOf, snapToNormalPosition, snapshotsControllerFacet, sortDeltaAttributes, spliceDeleteOp, spliceInsertOp, splitBlock, streamThroughEgress, streamingTargetFacet, suggestion, supportsInlineInputRules, supportsInlineMarks, tableCellDown, tableCellNext, tableCellPrev, tableEscapeGrid, toPseudoLocaleText, toggleMark, toolRuntimeFacet, undoManagerFacet, undoMetadataControllerFacet, undoRestoreControllerFacet, urlPolicy, urlPolicyFacet, usesInlineTextSelection, wordRangeAt };
+export { A11Y_MISSING_LABEL_CODE, APPLY_STORM_CODE, APPLY_STORM_QUEUE_LIMIT, type BeforeApplyHook, type BlockDirection, type BlockDirectionResolver, type BlockDirectionSetting, type CaretMotionParam, type CellCaretFocus, type CellCaretWrite, type ClipboardHandler, type CommandDispatchContext, type CommandHandlerTable, type CommandRegistry, type ContentMove, type ConvertBlockParam, type CreateCommandRegistryOptions, type CreateFacetRegistryOptions, type CreateHeadlessEditorOptions, type DecorationSource, type DefaultKeymapBinding, type DefaultKeymapContext, type DefinedBlockSchema, type DeleteGranularity, type DeleteParam, type DocumentMigration, DocumentRangeImpl, type EditorA11yLabelAttrs, EventEmitter, ExtensionManagerImpl, type FacetRegistry, type FacetSettleInput, HOOK_PRIORITIES, type InsertTextParam, type Keymap, type KeymapPlatform, type MigrationReport, type NormalPositionSnapshot, PIPELINE_PHASES, PSEUDO_LOCALE_CLOSE, PSEUDO_LOCALE_OPEN, type PendingBlock, type PendingBlockImportPolicyViolation, type PendingBlockProfilePolicyViolation, type ProfilePolicyViolation, type SchemaA11yAttrs, type SchemaA11yKind, SchemaEngineImpl, type SchemaRegistryConfig, SchemaRegistryImpl, type SelectBlockParam, SelectionAuthorityImpl as SelectionAuthority, type StructureBlockParam, type ToggleMarkParam, type UrlContext, type UrlPolicy, type VerticalCaretDirection, type VerticalCaretMeasure, type VerticalCaretMeasureResult, type VerticalCaretPoint, type WordRange, a11yLabelFacet, affectedBlockIdsFromSummary, aiAutocompleteControllerFacet, aiControllerFacet, aiEgressExtension, aiEgressFacet, aiInlineCompletionFacet, aiInlineHistoryFacet, aiReviewControllerFacet, aiSuggestionsControllerFacet, announceEditorA11y, announcerFacet, applyDirectedBinding, applyMergeBlocks, applySplitBlock, ariaReadOnlyFacet, assetProviderFacet, beforeApplyFacet, blockDirectionFacet, blockLogicalText, blocksToOps, buildMergeBlocksRecipe, buildNormalPositionSnapshot, buildSplitBlockRecipe, buildTableChildren, builtinCommandHandlers, caretBlockEnd, caretBlockStart, caretDocEnd, caretDocStart, caretDown, caretLeft, caretLineEnd, caretLineStart, caretRight, caretUp, caretWordLeft, caretWordRight, clipboardFacet, collectEditorKeyBindings, collectToolExecutionOutput, commandHandler, commandsFacet, convertBlock, convertBlockOps, createAppHandle, createBlockHandle, createCommandRegistry, createDecorationSet, createDocumentSession, createEditor, createEmptySchema, createFacetRegistry, createHeadlessEditor, createImportResult, createMutationGroupMetadata, createPseudoLocaleCatalog, createTextSelection, decorationsFacet, deepEqual, defaultDirectionFacet, defaultKeymapBindings, defineBlock, defineCommand, defineExtension, defineFacet, delegatesToGridEditing, deleteAdjacentInlineAtom, deleteBackward, deleteBlock, deleteForward, deriveContentMoves, duplicateBlock, emptyDecorationSet, ensureInlineCompletionController, fieldEditorHostFacet, filterAIRequest, filterOpsForDocumentProfile, filterPendingBlocksForDocumentProfile, foldAndNormalize, getApplyOptionsGroupId, getBlockSelectionRoleFromSchema, getBlockSelectionRoleFromType, getCellCaretFocus, getCommandRegistry, getEditorSelectionRecord, getFlowCapabilityFromSchema, getFlowCapabilityFromType, getInlineCompletionController, getNumberedListItemValue, getOpOriginGroupId, getOpOriginType, getSelectionBlockRange, getVerticalCaretGoalX, getVerticalCaretMeasure, hasFieldEditorSurface, hasIndexedCellSelectionMetadata, historyRedo, historyUndo, hookPriorityToPrecedence, indent, inputRulesEngineFacet, inputRulesFacet, insertLineBreak, insertText, interpolateMessage, isBlockSelected, isCollapsed, isContainerBlock, isContainerBlockType, isContinuousTextFlowCapability, isMultiBlock, isPseudoLocaleText, keyBindingPriorityToPrecedence, keymapFacet, localeFacet, mapOffsetThroughSplices, mergeDecorationSets, mergeSchemas, messagesFacet, moveBlockDown, moveBlockUp, multiplayerControllerFacet, nextGraphemeBoundary, nextWordBoundary, normalizePendingBlocksForImport, orderSlashMenuItemsByGroup, outdent, previousGraphemeBoundary, previousWordBoundary, priorityToPrecedence, prop, renderSelectionTargetBlockText, renderSelectionTargetText, repairAnchor, reportPendingBlockImportViolations, reportPendingBlockProfileViolations, resolveA11yBlockTypeLabel, resolveA11ySpec, resolveBlockDirection, resolveBlockFlowCapability, resolveCellSelectionCoord, resolveCellSelectionMatrix, resolveDefaultKeymap, resolveDirectedBinding, resolveDirectedCommand, resolveEditorA11yLabel, resolveEditorMessage, resolveEditorSchema, resolveFieldEditorBehavior, resolveFieldEditorInputMode, resolveFocusBlockDirection, resolveMessage, resolveSchema, resolveSchemaA11y, resolveSelectionTargetBlockIds, runMigrations, searchControllerFacet, selectAdjacentInlineAtom, selectAll, selectBlock, selectionToRange, setCellCaretFocus, setVerticalCaretGoalX, setVerticalCaretMeasure, shouldAllowDirectBlockPaste, shouldAllowFlowInsertionInSlashMenu, shouldExposeBlockInTooling, shouldForceBlockScopedSelectAll, shouldRenderContainerChildren, shouldShowBlockInDefaultMenus, singleController, slashMenuGroupOf, snapToNormalPosition, snapshotsControllerFacet, sortDeltaAttributes, spliceDeleteOp, spliceInsertOp, splitBlock, streamThroughEgress, streamingTargetFacet, suggestion, supportsInlineInputRules, supportsInlineMarks, tableCellDown, tableCellNext, tableCellPrev, tableEscapeGrid, toPseudoLocaleText, toggleMark, toolRuntimeFacet, undoManagerFacet, undoMetadataControllerFacet, undoRestoreControllerFacet, urlPolicy, urlPolicyFacet, usesInlineTextSelection, wordRangeAt };

package/dist/index.mjs

@@ -2699,6 +2699,9 @@ function opBlockId(_pipeline, op) {
 import { STRUCTURAL_ORIGIN_META_KEY } from "@input/pen-yjs";
 
 // src/schema/contentType.ts
+import {
+  isNestedContent
+} from "@input/pen-types";
 function resolveRuntimeContentType(schema) {
   if (!schema) {
     return "none";
@@ -2708,6 +2711,10 @@ function resolveRuntimeContentType(schema) {
   }
   return schema.content;
 }
+function isContainerBlock(schema) {
+  if (!schema) return false;
+  return isNestedContent(schema.content) || schema.isContainer === true;
+}
 
 // src/editor/rejectedOwnKeys.ts
 var REJECTED_OWN_PROP_KEYS = /* @__PURE__ */ new Set([
@@ -3582,6 +3589,15 @@ function executeOps(pipeline, ops, origin, structural) {
     const blockId = opBlockId(pipeline, op);
     if (!validateOp(pipeline, op)) continue;
     if (op.type === "insert-block") {
+      if (blockExists(pipeline, op.blockId) || pendingBlockIds.has(op.blockId)) {
+        emitPipelineDiagnostic(pipeline, {
+          code: "PEN_APPLY_010",
+          level: "warn",
+          source: "apply",
+          message: `apply: skipping insert-block for already-present block "${op.blockId}"`
+        });
+        continue;
+      }
       pendingBlockIds.add(op.blockId);
       pendingBlockTypes.set(op.blockId, op.blockType);
     }
@@ -6047,9 +6063,11 @@ var SelectionAuthorityImpl = class {
 };
 
 // src/editor/documentState.ts
+var EMPTY_CHILD_IDS = Object.freeze([]);
 var DocumentStateImpl = class {
   _positionIndex;
   _parentIndex;
+  _childIndex;
   _blockOrder;
   _generation = 0;
   _documentProfile;
@@ -6063,6 +6081,7 @@ var DocumentStateImpl = class {
     this._documentProfile = documentProfile;
     this._positionIndex = /* @__PURE__ */ new Map();
     this._parentIndex = /* @__PURE__ */ new Map();
+    this._childIndex = /* @__PURE__ */ new Map();
     this._blockOrder = [];
     this.rebuild();
   }
@@ -6101,6 +6120,9 @@ var DocumentStateImpl = class {
   parentOf(blockId) {
     return this._parentIndex.get(blockId) ?? null;
   }
+  childrenOf(blockId) {
+    return this._childIndex.get(blockId) ?? EMPTY_CHILD_IDS;
+  }
   *allBlocks() {
     const seen = /* @__PURE__ */ new Set();
     for (const id of this._blockOrder) {
@@ -6120,21 +6142,44 @@ var DocumentStateImpl = class {
     this._blockOrder = [];
     this._positionIndex = /* @__PURE__ */ new Map();
     this._parentIndex = /* @__PURE__ */ new Map();
+    this._childIndex = /* @__PURE__ */ new Map();
     for (let i = 0; i < order.length; i++) {
       const id = order.get(i);
       this._blockOrder.push(id);
       this._positionIndex.set(id, i);
     }
+    const nestedChildIds = /* @__PURE__ */ new Set();
+    const parentIdChildIds = [];
     for (const [blockId, blockMap] of this._doc.blocks.entries()) {
       const props = blockMap.get("props");
       if (props?.get?.("parentId")) {
         this._parentIndex.set(blockId, props.get("parentId"));
+        parentIdChildIds.push(blockId);
       }
       const children = blockMap.get("children");
-      if (children) {
+      if (children && children.length > 0) {
+        const childIds = [];
         for (let i = 0; i < children.length; i++) {
-          this._parentIndex.set(children.get(i), blockId);
+          const childId = children.get(i);
+          this._parentIndex.set(childId, blockId);
+          nestedChildIds.add(childId);
+          childIds.push(childId);
         }
+        this._childIndex.set(blockId, childIds);
+      }
+    }
+    parentIdChildIds.sort(
+      (a, b) => (this._positionIndex.get(a) ?? -1) - (this._positionIndex.get(b) ?? -1)
+    );
+    for (const childId of parentIdChildIds) {
+      if (nestedChildIds.has(childId)) continue;
+      const parentId = this._parentIndex.get(childId);
+      if (parentId === void 0) continue;
+      const siblings = this._childIndex.get(parentId);
+      if (siblings === void 0) {
+        this._childIndex.set(parentId, [childId]);
+      } else {
+        siblings.push(childId);
       }
     }
     this._generation++;
@@ -6142,6 +6187,7 @@ var DocumentStateImpl = class {
   clear() {
     this._positionIndex.clear();
     this._parentIndex.clear();
+    this._childIndex.clear();
     this._blockOrder = [];
     this._generation++;
   }
@@ -7418,11 +7464,18 @@ var BACKSPACE_EXIT_TYPES = /* @__PURE__ */ new Set([
   ...CONTAINER_EXIT_TYPES,
   ...HEADING_TYPES
 ]);
-var PARENT_ID_CONTAINER_TYPES = /* @__PURE__ */ new Set([
-  "toggle",
-  "callout",
-  "blockquote"
-]);
+function isContainerBlockType(editor, blockType) {
+  if (!blockType) {
+    return false;
+  }
+  return isContainerBlock(editor.schema.resolve(blockType));
+}
+function shouldRenderContainerChildren(editor, block) {
+  if (!block || !isContainerBlockType(editor, block.type)) {
+    return false;
+  }
+  return block.props?.open !== false;
+}
 function emitCommandDiagnostic(editor, event) {
   editor.internals?.emit("diagnostic", event);
 }
@@ -7474,18 +7527,13 @@ function isInsideParentIdContainer(editor, blockId) {
     return false;
   }
   const parent = editor.getBlock(parentId);
-  return !!parent && PARENT_ID_CONTAINER_TYPES.has(parent.type);
+  return !!parent && isContainerBlockType(editor, parent.type);
 }
 function getRootBlockIds(editor) {
   return editor.documentState.blockOrder.filter(
     (blockId) => editor.documentState.parentOf(blockId) == null
   );
 }
-function getParentIdChildBlockIds(editor, parentBlockId) {
-  return editor.documentState.blockOrder.filter(
-    (blockId) => editor.documentState.parentOf(blockId) === parentBlockId
-  );
-}
 function getVisibleBlockIds(editor) {
   const visibleBlockIds = [];
   for (const rootBlockId of getRootBlockIds(editor)) {
@@ -7607,23 +7655,13 @@ function convertBlockOps(editor, options) {
 }
 function collectVisibleBlockIds(editor, blockId, visibleBlockIds) {
   visibleBlockIds.push(blockId);
-  if (!shouldShowParentIdChildren(editor, blockId)) {
+  if (!shouldRenderContainerChildren(editor, editor.getBlock(blockId))) {
     return;
   }
-  for (const childBlockId of getParentIdChildBlockIds(editor, blockId)) {
+  for (const childBlockId of editor.documentState.childrenOf(blockId)) {
     collectVisibleBlockIds(editor, childBlockId, visibleBlockIds);
   }
 }
-function shouldShowParentIdChildren(editor, blockId) {
-  const block = editor.getBlock(blockId);
-  if (!block || !PARENT_ID_CONTAINER_TYPES.has(block.type)) {
-    return false;
-  }
-  if (block.type !== "toggle") {
-    return true;
-  }
-  return Boolean(block.props?.open);
-}
 
 // src/commands/commandSelection.ts
 function textSelectionResult(anchor, focus = anchor, extras) {
@@ -7799,12 +7837,12 @@ function parentContainerKind(editor, parentId) {
   if (!parent) {
     return null;
   }
-  if (PARENT_ID_CONTAINER_TYPES.has(parent.type)) {
-    return "layout-cell";
-  }
   if (parent.type === "table") {
     return "table";
   }
+  if (isContainerBlockType(editor, parent.type)) {
+    return "layout-cell";
+  }
   return null;
 }
 
@@ -14830,6 +14868,8 @@ export {
   interpolateMessage,
   isBlockSelected,
   isCollapsed,
+  isContainerBlock,
+  isContainerBlockType,
   isContinuousTextFlowCapability,
   isMultiBlock,
   isPseudoLocaleText,
@@ -14889,6 +14929,7 @@ export {
   shouldAllowFlowInsertionInSlashMenu,
   shouldExposeBlockInTooling,
   shouldForceBlockScopedSelectAll,
+  shouldRenderContainerChildren,
   shouldShowBlockInDefaultMenus,
   singleController,
   slashMenuGroupOf,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@input/pen-core",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Headless, extension-first editor engine for human-AI co-authoring",
   "license": "MIT",
   "homepage": "https://github.com/input-systems/pen#readme",
@@ -43,8 +43,8 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@input/pen-yjs": "^0.1.1",
-    "@input/pen-types": "^0.1.1"
+    "@input/pen-yjs": "^0.1.2",
+    "@input/pen-types": "^0.1.2"
   },
   "devDependencies": {
     "tsup": "^8.4.0",