@input/pen-core 0.1.8 → 0.1.9

package/dist/index.cjs

@@ -208,6 +208,7 @@ __export(index_exports, {
   shouldShowBlockInDefaultMenus: () => shouldShowBlockInDefaultMenus,
   singleController: () => singleController,
   slashMenuGroupOf: () => slashMenuGroupOf,
+  smoothStreamControllerFacet: () => smoothStreamControllerFacet,
   snapToNormalPosition: () => snapToNormalPosition,
   snapshotsControllerFacet: () => snapshotsControllerFacet,
   sortDeltaAttributes: () => sortDeltaAttributes,
@@ -5107,17 +5108,54 @@ function normalizeFieldEditorType(schema) {
   return "none";
 }
 
+// src/editor/documentPreorder.ts
+function documentPreorderBlockIds(editor) {
+  return documentPreorderBlockIdsFromState(editor.documentState);
+}
+function documentPreorderBlockIdsFromState(state) {
+  const ids = [];
+  for (const block of state.blocks) {
+    ids.push(block.id);
+  }
+  return ids;
+}
+function documentPreorderBlockIdsFromDoc(doc) {
+  const ids = [];
+  const seen = /* @__PURE__ */ new Set();
+  const blocks = doc.blocks;
+  const order = doc.blockOrder;
+  const walk = (id) => {
+    if (seen.has(id)) {
+      return;
+    }
+    seen.add(id);
+    ids.push(id);
+    const blockMap = blocks.get(id);
+    const children = blockMap?.get("children");
+    if (!children) {
+      return;
+    }
+    for (let i = 0; i < children.length; i++) {
+      walk(children.get(i));
+    }
+  };
+  for (let i = 0; i < order.length; i++) {
+    walk(order.get(i));
+  }
+  return ids;
+}
+
 // src/editor/range.ts
 var DocumentRangeImpl = class {
   start;
   end;
   _anchor;
   _focus;
-  _doc;
+  _order;
   constructor(anchor, focus, doc) {
     this._anchor = anchor;
     this._focus = focus;
-    this._doc = doc;
+    this._order = documentPreorderBlockIdsFromDoc(doc);
     const anchorIdx = this._indexOfBlock(anchor.blockId);
     const focusIdx = this._indexOfBlock(focus.blockId);
     if (anchorIdx < focusIdx || anchorIdx === focusIdx && (anchor.offset ?? 0) <= (focus.offset ?? 0)) {
@@ -5146,13 +5184,10 @@ var DocumentRangeImpl = class {
   get blockRange() {
     const startIdx = this._indexOfBlock(this.start.blockId);
     const endIdx = this._indexOfBlock(this.end.blockId);
-    const result = [];
-    for (let i = startIdx; i <= endIdx; i++) {
-      result.push(
-        this._doc.blockOrder.get(i)
-      );
+    if (startIdx < 0 || endIdx < 0) {
+      return [];
     }
-    return result;
+    return this._order.slice(startIdx, endIdx + 1);
   }
   contains(point) {
     const idx = this._indexOfBlock(point.blockId);
@@ -5188,10 +5223,7 @@ var DocumentRangeImpl = class {
     };
   }
   _indexOfBlock(blockId) {
-    for (let i = 0; i < this._doc.blockOrder.length; i++) {
-      if (this._doc.blockOrder.get(i) === blockId) return i;
-    }
-    return -1;
+    return this._order.indexOf(blockId);
   }
 };
 
@@ -5255,13 +5287,10 @@ function blockIdsFromOrder(order, anchorId, focusId) {
   );
 }
 function blockIdsBetween(doc, anchorId, focusId) {
-  const order = doc.blockOrder;
-  return sliceBlockIds(
-    indexOfBlock(order, anchorId),
-    indexOfBlock(order, focusId),
+  return blockIdsFromOrder(
+    documentPreorderBlockIdsFromDoc(doc),
     anchorId,
-    focusId,
-    (index) => order.get(index)
+    focusId
   );
 }
 function sliceBlockIds(anchorIndex, focusIndex, anchorId, focusId, idAt) {
@@ -5282,14 +5311,6 @@ function sliceBlockIds(anchorIndex, focusIndex, anchorId, focusId, idAt) {
   }
   return ids;
 }
-function indexOfBlock(order, blockId) {
-  for (let i = 0; i < order.length; i++) {
-    if (order.get(i) === blockId) {
-      return i;
-    }
-  }
-  return -1;
-}
 
 // src/editor/anchorRepair.ts
 function sitsInMovedRange(offset, assoc, range) {
@@ -7977,7 +7998,7 @@ function readTextAnchor(editor) {
   return selection.anchor;
 }
 function documentOrderedTextPoints(editor, selection) {
-  const order = editor.documentState.blockOrder;
+  const order = documentPreorderBlockIds(editor);
   const anchorIndex = order.indexOf(selection.anchor.blockId);
   const focusIndex = order.indexOf(selection.focus.blockId);
   if (anchorIndex < 0 || focusIndex < 0) {
@@ -7991,7 +8012,7 @@ function documentOrderedTextPoints(editor, selection) {
 
 // src/commands/commandSnapshots.ts
 function buildNormalPositionSnapshot(editor) {
-  const blockOrder = [...editor.documentState.blockOrder];
+  const blockOrder = [...getVisibleBlockIds(editor)];
   const blocks = {};
   for (const blockId of blockOrder) {
     const block = editor.getBlock(blockId);
@@ -8012,7 +8033,7 @@ function buildNormalPositionSnapshot(editor) {
   return { blockOrder, blocks };
 }
 function buildTransitionSnapshot(editor) {
-  const blockOrder = [...editor.documentState.blockOrder];
+  const blockOrder = [...getVisibleBlockIds(editor)];
   const blocks = {};
   for (const blockId of blockOrder) {
     const block = editor.getBlock(blockId);
@@ -8309,7 +8330,7 @@ function replaceSingleBlockRange(blockId, start, end, text, marks) {
   };
 }
 function replaceMultiBlockRange(editor, start, end, text, marks) {
-  const order = editor.documentState.blockOrder;
+  const order = documentPreorderBlockIds(editor);
   const startIndex = order.indexOf(start.blockId);
   const endIndex = order.indexOf(end.blockId);
   if (startIndex < 0 || endIndex < 0 || startIndex >= endIndex) {
@@ -8348,7 +8369,7 @@ function replaceMultiBlockRange(editor, start, end, text, marks) {
   );
 }
 function replaceTextToTextRange(editor, start, end, text, marks, startIndex, endIndex, startLength) {
-  const order = editor.documentState.blockOrder;
+  const order = documentPreorderBlockIds(editor);
   const ops = [];
   if (start.offset < startLength) {
     ops.push(
@@ -8410,7 +8431,7 @@ function replaceTextToTextRange(editor, start, end, text, marks, startIndex, end
   };
 }
 function replaceMixedBoundaryRange(editor, start, end, text, marks, startIndex, endIndex, startEditable, endEditable, startLength) {
-  const order = editor.documentState.blockOrder;
+  const order = documentPreorderBlockIds(editor);
   const ops = [];
   if (startEditable) {
     if (start.offset < startLength) {
@@ -9300,11 +9321,10 @@ var multiplayerControllerFacet = singleController(
 );
 var snapshotsControllerFacet = singleController("history.controller");
 var assetProviderFacet = singleController("pen.assetProvider");
-var toolRuntimeFacet = singleController(
-  "tools.toolRuntime"
-);
+var toolRuntimeFacet = singleController("tools.toolRuntime");
 var announcerFacet = singleController("pen.announcer");
 var streamingTargetFacet = singleController("deltaStream.target");
+var smoothStreamControllerFacet = singleController("ai.smoothStream");
 
 // src/commands/history.ts
 var historyUndo = defineCommand("history.undo");
@@ -10085,7 +10105,7 @@ function toggleMarkAcrossBlocks(editor, selection, param) {
   if (!range) {
     return false;
   }
-  const order = editor.documentState.blockOrder;
+  const order = documentPreorderBlockIds(editor);
   const startIndex = order.indexOf(range.start.blockId);
   const endIndex = order.indexOf(range.end.blockId);
   if (startIndex < 0 || endIndex < 0) {
@@ -11096,6 +11116,7 @@ var FACET_BY_SLOT_KEY = {
   "pen.messages": messagesFacet,
   "pen.a11yLabel": a11yLabelFacet,
   "delta-stream:target": streamingTargetFacet,
+  "smooth-stream:controller": smoothStreamControllerFacet,
   [import_pen_types7.ANNOUNCER_SLOT_KEY]: announcerFacet
 };
 function writeAssignedSlot(self, key, value) {
@@ -15256,6 +15277,7 @@ function mapOffsetThroughSplices(splices, offset, assoc) {
   shouldShowBlockInDefaultMenus,
   singleController,
   slashMenuGroupOf,
+  smoothStreamControllerFacet,
   snapToNormalPosition,
   snapshotsControllerFacet,
   sortDeltaAttributes,

package/dist/index.d.cts

@@ -304,7 +304,7 @@ declare class DocumentRangeImpl implements DocumentRange {
     };
     private readonly _anchor;
     private readonly _focus;
-    private readonly _doc;
+    private readonly _order;
     constructor(anchor: {
         blockId: string;
         offset?: number;
@@ -456,9 +456,10 @@ declare function createTextSelection(input: {
 declare function isCollapsed(sel: ReadonlySelectionState): boolean;
 declare function isMultiBlock(sel: ReadonlySelectionState): boolean;
 /**
- * Document-order block ids covered by `sel`. Pass a plain `blockOrder`
- * snapshot (`editor.documentState.blockOrder`) from a renderer effect —
- * walking a live `Y.Array` through a deep-proxied document writes back.
+ * Document-order block ids covered by `sel`. A live `PenDocument` walks
+ * nested `children` as well as top-level `blockOrder`. Pass a plain id
+ * snapshot from a renderer effect — walking a live `Y.Array` through a
+ * deep-proxied document writes back.
  */
 declare function getSelectionBlockRange(doc: PenDocument | readonly string[], sel: ReadonlySelectionState): string[];
 declare function isBlockSelected(blockOrder: readonly string[], sel: ReadonlySelectionState, blockId: string): boolean;
@@ -1101,6 +1102,7 @@ declare const assetProviderFacet: _input_pen_types.Facet<unknown, unknown>;
 declare const toolRuntimeFacet: _input_pen_types.Facet<unknown, unknown>;
 declare const announcerFacet: _input_pen_types.Facet<unknown, unknown>;
 declare const streamingTargetFacet: _input_pen_types.Facet<unknown, unknown>;
+declare const smoothStreamControllerFacet: _input_pen_types.Facet<unknown, unknown>;
 
 declare function affectedBlockIdsFromSummary(summary: Pick<ChangeSummary, "blockText" | "structural">, documentOrder?: readonly string[]): string[];
 
@@ -1113,4 +1115,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 SuggestionMenuBoundary, type SuggestionMenuTarget, type SuggestionMenuTrigger, 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, inlineLogicalText, 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, resolveSuggestionMenuTarget, 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 };
+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 SuggestionMenuBoundary, type SuggestionMenuTarget, type SuggestionMenuTrigger, 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, inlineLogicalText, 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, resolveSuggestionMenuTarget, runMigrations, searchControllerFacet, selectAdjacentInlineAtom, selectAll, selectBlock, selectionToRange, setCellCaretFocus, setVerticalCaretGoalX, setVerticalCaretMeasure, shouldAllowDirectBlockPaste, shouldAllowFlowInsertionInSlashMenu, shouldExposeBlockInTooling, shouldForceBlockScopedSelectAll, shouldRenderContainerChildren, shouldShowBlockInDefaultMenus, singleController, slashMenuGroupOf, smoothStreamControllerFacet, 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

@@ -304,7 +304,7 @@ declare class DocumentRangeImpl implements DocumentRange {
     };
     private readonly _anchor;
     private readonly _focus;
-    private readonly _doc;
+    private readonly _order;
     constructor(anchor: {
         blockId: string;
         offset?: number;
@@ -456,9 +456,10 @@ declare function createTextSelection(input: {
 declare function isCollapsed(sel: ReadonlySelectionState): boolean;
 declare function isMultiBlock(sel: ReadonlySelectionState): boolean;
 /**
- * Document-order block ids covered by `sel`. Pass a plain `blockOrder`
- * snapshot (`editor.documentState.blockOrder`) from a renderer effect —
- * walking a live `Y.Array` through a deep-proxied document writes back.
+ * Document-order block ids covered by `sel`. A live `PenDocument` walks
+ * nested `children` as well as top-level `blockOrder`. Pass a plain id
+ * snapshot from a renderer effect — walking a live `Y.Array` through a
+ * deep-proxied document writes back.
  */
 declare function getSelectionBlockRange(doc: PenDocument | readonly string[], sel: ReadonlySelectionState): string[];
 declare function isBlockSelected(blockOrder: readonly string[], sel: ReadonlySelectionState, blockId: string): boolean;
@@ -1101,6 +1102,7 @@ declare const assetProviderFacet: _input_pen_types.Facet<unknown, unknown>;
 declare const toolRuntimeFacet: _input_pen_types.Facet<unknown, unknown>;
 declare const announcerFacet: _input_pen_types.Facet<unknown, unknown>;
 declare const streamingTargetFacet: _input_pen_types.Facet<unknown, unknown>;
+declare const smoothStreamControllerFacet: _input_pen_types.Facet<unknown, unknown>;
 
 declare function affectedBlockIdsFromSummary(summary: Pick<ChangeSummary, "blockText" | "structural">, documentOrder?: readonly string[]): string[];
 
@@ -1113,4 +1115,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 SuggestionMenuBoundary, type SuggestionMenuTarget, type SuggestionMenuTrigger, 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, inlineLogicalText, 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, resolveSuggestionMenuTarget, 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 };
+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 SuggestionMenuBoundary, type SuggestionMenuTarget, type SuggestionMenuTrigger, 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, inlineLogicalText, 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, resolveSuggestionMenuTarget, runMigrations, searchControllerFacet, selectAdjacentInlineAtom, selectAll, selectBlock, selectionToRange, setCellCaretFocus, setVerticalCaretGoalX, setVerticalCaretMeasure, shouldAllowDirectBlockPaste, shouldAllowFlowInsertionInSlashMenu, shouldExposeBlockInTooling, shouldForceBlockScopedSelectAll, shouldRenderContainerChildren, shouldShowBlockInDefaultMenus, singleController, slashMenuGroupOf, smoothStreamControllerFacet, 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

@@ -4873,17 +4873,54 @@ function normalizeFieldEditorType(schema) {
   return "none";
 }
 
+// src/editor/documentPreorder.ts
+function documentPreorderBlockIds(editor) {
+  return documentPreorderBlockIdsFromState(editor.documentState);
+}
+function documentPreorderBlockIdsFromState(state) {
+  const ids = [];
+  for (const block of state.blocks) {
+    ids.push(block.id);
+  }
+  return ids;
+}
+function documentPreorderBlockIdsFromDoc(doc) {
+  const ids = [];
+  const seen = /* @__PURE__ */ new Set();
+  const blocks = doc.blocks;
+  const order = doc.blockOrder;
+  const walk = (id) => {
+    if (seen.has(id)) {
+      return;
+    }
+    seen.add(id);
+    ids.push(id);
+    const blockMap = blocks.get(id);
+    const children = blockMap?.get("children");
+    if (!children) {
+      return;
+    }
+    for (let i = 0; i < children.length; i++) {
+      walk(children.get(i));
+    }
+  };
+  for (let i = 0; i < order.length; i++) {
+    walk(order.get(i));
+  }
+  return ids;
+}
+
 // src/editor/range.ts
 var DocumentRangeImpl = class {
   start;
   end;
   _anchor;
   _focus;
-  _doc;
+  _order;
   constructor(anchor, focus, doc) {
     this._anchor = anchor;
     this._focus = focus;
-    this._doc = doc;
+    this._order = documentPreorderBlockIdsFromDoc(doc);
     const anchorIdx = this._indexOfBlock(anchor.blockId);
     const focusIdx = this._indexOfBlock(focus.blockId);
     if (anchorIdx < focusIdx || anchorIdx === focusIdx && (anchor.offset ?? 0) <= (focus.offset ?? 0)) {
@@ -4912,13 +4949,10 @@ var DocumentRangeImpl = class {
   get blockRange() {
     const startIdx = this._indexOfBlock(this.start.blockId);
     const endIdx = this._indexOfBlock(this.end.blockId);
-    const result = [];
-    for (let i = startIdx; i <= endIdx; i++) {
-      result.push(
-        this._doc.blockOrder.get(i)
-      );
+    if (startIdx < 0 || endIdx < 0) {
+      return [];
     }
-    return result;
+    return this._order.slice(startIdx, endIdx + 1);
   }
   contains(point) {
     const idx = this._indexOfBlock(point.blockId);
@@ -4954,10 +4988,7 @@ var DocumentRangeImpl = class {
     };
   }
   _indexOfBlock(blockId) {
-    for (let i = 0; i < this._doc.blockOrder.length; i++) {
-      if (this._doc.blockOrder.get(i) === blockId) return i;
-    }
-    return -1;
+    return this._order.indexOf(blockId);
   }
 };
 
@@ -5021,13 +5052,10 @@ function blockIdsFromOrder(order, anchorId, focusId) {
   );
 }
 function blockIdsBetween(doc, anchorId, focusId) {
-  const order = doc.blockOrder;
-  return sliceBlockIds(
-    indexOfBlock(order, anchorId),
-    indexOfBlock(order, focusId),
+  return blockIdsFromOrder(
+    documentPreorderBlockIdsFromDoc(doc),
     anchorId,
-    focusId,
-    (index) => order.get(index)
+    focusId
   );
 }
 function sliceBlockIds(anchorIndex, focusIndex, anchorId, focusId, idAt) {
@@ -5048,14 +5076,6 @@ function sliceBlockIds(anchorIndex, focusIndex, anchorId, focusId, idAt) {
   }
   return ids;
 }
-function indexOfBlock(order, blockId) {
-  for (let i = 0; i < order.length; i++) {
-    if (order.get(i) === blockId) {
-      return i;
-    }
-  }
-  return -1;
-}
 
 // src/editor/anchorRepair.ts
 function sitsInMovedRange(offset, assoc, range) {
@@ -7756,7 +7776,7 @@ function readTextAnchor(editor) {
   return selection.anchor;
 }
 function documentOrderedTextPoints(editor, selection) {
-  const order = editor.documentState.blockOrder;
+  const order = documentPreorderBlockIds(editor);
   const anchorIndex = order.indexOf(selection.anchor.blockId);
   const focusIndex = order.indexOf(selection.focus.blockId);
   if (anchorIndex < 0 || focusIndex < 0) {
@@ -7770,7 +7790,7 @@ function documentOrderedTextPoints(editor, selection) {
 
 // src/commands/commandSnapshots.ts
 function buildNormalPositionSnapshot(editor) {
-  const blockOrder = [...editor.documentState.blockOrder];
+  const blockOrder = [...getVisibleBlockIds(editor)];
   const blocks = {};
   for (const blockId of blockOrder) {
     const block = editor.getBlock(blockId);
@@ -7791,7 +7811,7 @@ function buildNormalPositionSnapshot(editor) {
   return { blockOrder, blocks };
 }
 function buildTransitionSnapshot(editor) {
-  const blockOrder = [...editor.documentState.blockOrder];
+  const blockOrder = [...getVisibleBlockIds(editor)];
   const blocks = {};
   for (const blockId of blockOrder) {
     const block = editor.getBlock(blockId);
@@ -8088,7 +8108,7 @@ function replaceSingleBlockRange(blockId, start, end, text, marks) {
   };
 }
 function replaceMultiBlockRange(editor, start, end, text, marks) {
-  const order = editor.documentState.blockOrder;
+  const order = documentPreorderBlockIds(editor);
   const startIndex = order.indexOf(start.blockId);
   const endIndex = order.indexOf(end.blockId);
   if (startIndex < 0 || endIndex < 0 || startIndex >= endIndex) {
@@ -8127,7 +8147,7 @@ function replaceMultiBlockRange(editor, start, end, text, marks) {
   );
 }
 function replaceTextToTextRange(editor, start, end, text, marks, startIndex, endIndex, startLength) {
-  const order = editor.documentState.blockOrder;
+  const order = documentPreorderBlockIds(editor);
   const ops = [];
   if (start.offset < startLength) {
     ops.push(
@@ -8189,7 +8209,7 @@ function replaceTextToTextRange(editor, start, end, text, marks, startIndex, end
   };
 }
 function replaceMixedBoundaryRange(editor, start, end, text, marks, startIndex, endIndex, startEditable, endEditable, startLength) {
-  const order = editor.documentState.blockOrder;
+  const order = documentPreorderBlockIds(editor);
   const ops = [];
   if (startEditable) {
     if (start.offset < startLength) {
@@ -9079,11 +9099,10 @@ var multiplayerControllerFacet = singleController(
 );
 var snapshotsControllerFacet = singleController("history.controller");
 var assetProviderFacet = singleController("pen.assetProvider");
-var toolRuntimeFacet = singleController(
-  "tools.toolRuntime"
-);
+var toolRuntimeFacet = singleController("tools.toolRuntime");
 var announcerFacet = singleController("pen.announcer");
 var streamingTargetFacet = singleController("deltaStream.target");
+var smoothStreamControllerFacet = singleController("ai.smoothStream");
 
 // src/commands/history.ts
 var historyUndo = defineCommand("history.undo");
@@ -9864,7 +9883,7 @@ function toggleMarkAcrossBlocks(editor, selection, param) {
   if (!range) {
     return false;
   }
-  const order = editor.documentState.blockOrder;
+  const order = documentPreorderBlockIds(editor);
   const startIndex = order.indexOf(range.start.blockId);
   const endIndex = order.indexOf(range.end.blockId);
   if (startIndex < 0 || endIndex < 0) {
@@ -10891,6 +10910,7 @@ var FACET_BY_SLOT_KEY = {
   "pen.messages": messagesFacet,
   "pen.a11yLabel": a11yLabelFacet,
   "delta-stream:target": streamingTargetFacet,
+  "smooth-stream:controller": smoothStreamControllerFacet,
   [ANNOUNCER_SLOT_KEY]: announcerFacet
 };
 function writeAssignedSlot(self, key, value) {
@@ -15076,6 +15096,7 @@ export {
   shouldShowBlockInDefaultMenus,
   singleController,
   slashMenuGroupOf,
+  smoothStreamControllerFacet,
   snapToNormalPosition,
   snapshotsControllerFacet,
   sortDeltaAttributes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@input/pen-core",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "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.8",
-    "@input/pen-types": "^0.1.8"
+    "@input/pen-yjs": "^0.1.9",
+    "@input/pen-types": "^0.1.9"
   },
   "devDependencies": {
     "tsup": "^8.4.0",