@input/pen-core 0.1.7 → 0.1.9

package/dist/index.cjs

@@ -134,6 +134,7 @@ __export(index_exports, {
   historyUndo: () => historyUndo,
   hookPriorityToPrecedence: () => hookPriorityToPrecedence,
   indent: () => indent,
+  inlineLogicalText: () => inlineLogicalText,
   inputRulesEngineFacet: () => inputRulesEngineFacet,
   inputRulesFacet: () => inputRulesFacet,
   insertLineBreak: () => insertLineBreak,
@@ -189,6 +190,7 @@ __export(index_exports, {
   resolveSchema: () => resolveSchema,
   resolveSchemaA11y: () => resolveSchemaA11y,
   resolveSelectionTargetBlockIds: () => resolveSelectionTargetBlockIds,
+  resolveSuggestionMenuTarget: () => resolveSuggestionMenuTarget,
   runMigrations: () => runMigrations,
   searchControllerFacet: () => searchControllerFacet,
   selectAdjacentInlineAtom: () => selectAdjacentInlineAtom,
@@ -206,6 +208,7 @@ __export(index_exports, {
   shouldShowBlockInDefaultMenus: () => shouldShowBlockInDefaultMenus,
   singleController: () => singleController,
   slashMenuGroupOf: () => slashMenuGroupOf,
+  smoothStreamControllerFacet: () => smoothStreamControllerFacet,
   snapToNormalPosition: () => snapToNormalPosition,
   snapshotsControllerFacet: () => snapshotsControllerFacet,
   sortDeltaAttributes: () => sortDeltaAttributes,
@@ -589,6 +592,47 @@ function filterOpsForDocumentProfile(ops, documentProfile, registry) {
   };
 }
 
+// src/schema/generateValidator.ts
+function generateValidator(propSchemas) {
+  return (raw) => {
+    const result = {};
+    for (const [key, schema] of Object.entries(propSchemas)) {
+      let value = raw[key];
+      if (value === void 0 || value === null) {
+        result[key] = schema.default;
+        continue;
+      }
+      const schemaType = Array.isArray(schema.type) ? schema.type[0] : schema.type;
+      if (schemaType === "number" && typeof value === "string") {
+        const parsed = Number(value);
+        if (!Number.isNaN(parsed)) value = parsed;
+      }
+      if (schemaType === "boolean" && typeof value === "string") {
+        value = value === "true";
+      }
+      const matchesSchemaType = schemaType === "array" ? Array.isArray(value) : typeof value === schemaType;
+      if (schema.type && schemaType !== void 0 && !matchesSchemaType) {
+        result[key] = schema.default;
+        continue;
+      }
+      if (typeof value === "number") {
+        if (schema.minimum !== void 0 && value < schema.minimum) {
+          value = schema.minimum;
+        }
+        if (typeof value === "number" && schema.maximum !== void 0 && value > schema.maximum) {
+          value = schema.maximum;
+        }
+      }
+      if (schema.enum && !schema.enum.includes(value)) {
+        result[key] = schema.default;
+        continue;
+      }
+      result[key] = value;
+    }
+    return result;
+  };
+}
+
 // src/schema/prop.ts
 var PropChainImpl = class {
   _schema;
@@ -895,6 +939,10 @@ var SchemaRegistryImpl = class _SchemaRegistryImpl {
     if (patch.serialize) {
       merged.serialize = { ...existing.serialize, ...patch.serialize };
     }
+    if ("propSchema" in patch && !("validateProps" in patch)) {
+      const propSchema = merged.propSchema ?? {};
+      merged.validateProps = Object.keys(propSchema).length > 0 ? generateValidator(propSchema) : void 0;
+    }
     const blocks = new Map(this._blocks);
     blocks.set(type, merged);
     return new _SchemaRegistryImpl({
@@ -989,45 +1037,6 @@ function generateAIDescription(type, props) {
   }).join(", ");
   return `${type}: ${propDescriptions}`;
 }
-function generateValidator(propSchemas) {
-  return (raw) => {
-    const result = {};
-    for (const [key, schema] of Object.entries(propSchemas)) {
-      let value = raw[key];
-      if (value === void 0 || value === null) {
-        result[key] = schema.default;
-        continue;
-      }
-      const schemaType = Array.isArray(schema.type) ? schema.type[0] : schema.type;
-      if (schemaType === "number" && typeof value === "string") {
-        const parsed = Number(value);
-        if (!Number.isNaN(parsed)) value = parsed;
-      }
-      if (schemaType === "boolean" && typeof value === "string") {
-        value = value === "true";
-      }
-      const matchesSchemaType = schemaType === "array" ? Array.isArray(value) : typeof value === schemaType;
-      if (schema.type && schemaType !== void 0 && !matchesSchemaType) {
-        result[key] = schema.default;
-        continue;
-      }
-      if (typeof value === "number") {
-        if (schema.minimum !== void 0 && value < schema.minimum) {
-          value = schema.minimum;
-        }
-        if (typeof value === "number" && schema.maximum !== void 0 && value > schema.maximum) {
-          value = schema.maximum;
-        }
-      }
-      if (schema.enum && !schema.enum.includes(value)) {
-        result[key] = schema.default;
-        continue;
-      }
-      result[key] = value;
-    }
-    return result;
-  };
-}
 function defineBlock(typeOrConfig, maybeConfig) {
   const type = typeof typeOrConfig === "string" ? typeOrConfig : typeOrConfig.type;
   const config = typeof typeOrConfig === "string" ? maybeConfig : typeOrConfig;
@@ -3654,6 +3663,18 @@ function snapshotPlain(value) {
       writable: true
     });
   }
+  for (const key of Object.getOwnPropertySymbols(value)) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    if (!descriptor?.enumerable) {
+      continue;
+    }
+    Object.defineProperty(next, key, {
+      value: snapshotPlain(descriptor.value),
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  }
   return next;
 }
 function snapshotOps(ops) {
@@ -5087,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)) {
@@ -5126,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);
@@ -5168,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);
   }
 };
 
@@ -5235,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) {
@@ -5262,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) {
@@ -7957,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) {
@@ -7971,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);
@@ -7992,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);
@@ -8289,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) {
@@ -8328,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(
@@ -8390,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) {
@@ -9280,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");
@@ -10065,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) {
@@ -11076,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) {
@@ -14475,6 +14516,77 @@ function emitMissingBlock(editor, blockId) {
   emit("diagnostic", event);
 }
 
+// src/suggestion/resolveSuggestionMenuTarget.ts
+var DEFAULT_LOOKBEHIND = 80;
+function inlineLogicalText(block) {
+  return logicalInline(block).text;
+}
+function resolveSuggestionMenuTarget(editor, trigger) {
+  if (trigger.char.length === 0) {
+    return null;
+  }
+  const selection = editor.selection;
+  if (selection?.type !== "text" || !isCollapsed(selection)) {
+    return null;
+  }
+  if (selection.anchor.blockId !== selection.focus.blockId) {
+    return null;
+  }
+  const block = editor.getBlock(selection.focus.blockId);
+  if (!block) {
+    return null;
+  }
+  const offset = selection.focus.offset;
+  const lookbehind = trigger.lookbehind ?? DEFAULT_LOOKBEHIND;
+  const prefixStartOffset = Math.max(0, offset - lookbehind);
+  const { text, atoms } = logicalInline(block);
+  const textBefore = text.slice(prefixStartOffset, offset);
+  const triggerIndex = textBefore.lastIndexOf(trigger.char);
+  if (triggerIndex < 0) {
+    return null;
+  }
+  if (trigger.boundary === "whitespace") {
+    const previousChar = textBefore[triggerIndex - 1];
+    if (previousChar && !/\s/.test(previousChar)) {
+      return null;
+    }
+  }
+  const query = textBefore.slice(triggerIndex + trigger.char.length);
+  const startOffset = prefixStartOffset + triggerIndex;
+  const queryStartOffset = startOffset + trigger.char.length;
+  if (queryRangeContainsAtom(atoms, queryStartOffset, offset)) {
+    return null;
+  }
+  if (!trigger.allowSpaces && /\s/.test(query)) {
+    return null;
+  }
+  if (trigger.closingChar && query.includes(trigger.closingChar)) {
+    return null;
+  }
+  if (query.length < (trigger.minQueryLength ?? 0)) {
+    return null;
+  }
+  if (trigger.maxQueryLength !== void 0 && query.length > trigger.maxQueryLength) {
+    return null;
+  }
+  if (trigger.queryPattern) {
+    trigger.queryPattern.lastIndex = 0;
+    if (!trigger.queryPattern.test(query)) {
+      return null;
+    }
+  }
+  return {
+    blockId: selection.focus.blockId,
+    startOffset,
+    endOffset: offset,
+    query,
+    trigger: trigger.char
+  };
+}
+function queryRangeContainsAtom(atoms, queryStart, queryEnd) {
+  return atoms.some((atom) => atom.start < queryEnd && atom.end > queryStart);
+}
+
 // src/commands/resolveDirectedBinding.ts
 function resolveDirectedBinding(editor, binding) {
   const direction = resolveFocusBlockDirection(editor);
@@ -15091,6 +15203,7 @@ function mapOffsetThroughSplices(splices, offset, assoc) {
   historyUndo,
   hookPriorityToPrecedence,
   indent,
+  inlineLogicalText,
   inputRulesEngineFacet,
   inputRulesFacet,
   insertLineBreak,
@@ -15146,6 +15259,7 @@ function mapOffsetThroughSplices(splices, offset, assoc) {
   resolveSchema,
   resolveSchemaA11y,
   resolveSelectionTargetBlockIds,
+  resolveSuggestionMenuTarget,
   runMigrations,
   searchControllerFacet,
   selectAdjacentInlineAtom,
@@ -15163,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;
@@ -722,6 +723,71 @@ declare function resolveBlockDirection(editor: Editor, block: BlockHandle): Bloc
  */
 declare function blockLogicalText(editor: Editor, blockId: string): string;
 
+/** Whether a trigger may sit after a non-whitespace character. */
+type SuggestionMenuBoundary = "any" | "whitespace";
+/**
+ * Match constraints for {@link resolveSuggestionMenuTarget}.
+ *
+ * Offsets are logical (N6): each inline atom is one unit.
+ */
+interface SuggestionMenuTrigger {
+    /** Trigger string to find; empty `char` never matches. */
+    char: string;
+    /** Minimum query length after the trigger. @default 0 */
+    minQueryLength?: number;
+    /** Maximum query length after the trigger. @default unlimited */
+    maxQueryLength?: number;
+    /** How many logical offsets before the caret to search. @default 80 */
+    lookbehind?: number;
+    /** When false, a query containing whitespace is refused. @default false */
+    allowSpaces?: boolean;
+    /**
+     * `"whitespace"` requires start-of-prefix or a whitespace character before
+     * the trigger (an atom is not whitespace). `"any"` does not.
+     * @default "any"
+     */
+    boundary?: SuggestionMenuBoundary;
+    /** When set, a query containing this character is refused. @default none */
+    closingChar?: string;
+    /** When set, the query must match; `lastIndex` is reset first. @default none */
+    queryPattern?: RegExp;
+}
+/** Resolved trigger range in the logical offset domain (N6). */
+interface SuggestionMenuTarget {
+    blockId: string;
+    startOffset: number;
+    endOffset: number;
+    query: string;
+    trigger: string;
+}
+/**
+ * Logical inline text of a block: stored string text plus one U+FFFC per
+ * inline atom, in the same offset domain as caret offsets and
+ * `block.length()` (N6).
+ *
+ * @param block - Live block handle to read.
+ * @returns The logical string. Empty blocks return `""`.
+ * @throws Never.
+ */
+declare function inlineLogicalText(block: BlockHandle): string;
+/**
+ * Resolves a collapsed caret to a suggestion-menu trigger range.
+ *
+ * Matching uses the logical offset domain (N6), not `block.textContent()`.
+ * Each inline atom occupies one offset (U+FFFC in {@link inlineLogicalText}).
+ * A query range that contains an atom is refused. A trigger immediately after
+ * an atom starts at the offset after that atom; `boundary: "whitespace"` still
+ * rejects when the preceding unit is the atom.
+ *
+ * @param editor - Editor whose collapsed text caret is read.
+ * @param trigger - Trigger character and match constraints. See
+ *   {@link SuggestionMenuTrigger} for field defaults.
+ * @returns The trigger range in logical offsets, or `null` when the caret is
+ *   not a collapsed in-block text selection or the prefix does not match.
+ * @throws Never. Non-matches return `null`.
+ */
+declare function resolveSuggestionMenuTarget(editor: Editor, trigger: SuggestionMenuTrigger): SuggestionMenuTarget | null;
+
 type DefaultKeymapContext = "text" | "cell" | "block" | "any";
 type KeymapPlatform = "macos" | "windows" | "linux";
 interface DefaultKeymapBinding {
@@ -1036,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[];
 
@@ -1048,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 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 };
+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;
@@ -722,6 +723,71 @@ declare function resolveBlockDirection(editor: Editor, block: BlockHandle): Bloc
  */
 declare function blockLogicalText(editor: Editor, blockId: string): string;
 
+/** Whether a trigger may sit after a non-whitespace character. */
+type SuggestionMenuBoundary = "any" | "whitespace";
+/**
+ * Match constraints for {@link resolveSuggestionMenuTarget}.
+ *
+ * Offsets are logical (N6): each inline atom is one unit.
+ */
+interface SuggestionMenuTrigger {
+    /** Trigger string to find; empty `char` never matches. */
+    char: string;
+    /** Minimum query length after the trigger. @default 0 */
+    minQueryLength?: number;
+    /** Maximum query length after the trigger. @default unlimited */
+    maxQueryLength?: number;
+    /** How many logical offsets before the caret to search. @default 80 */
+    lookbehind?: number;
+    /** When false, a query containing whitespace is refused. @default false */
+    allowSpaces?: boolean;
+    /**
+     * `"whitespace"` requires start-of-prefix or a whitespace character before
+     * the trigger (an atom is not whitespace). `"any"` does not.
+     * @default "any"
+     */
+    boundary?: SuggestionMenuBoundary;
+    /** When set, a query containing this character is refused. @default none */
+    closingChar?: string;
+    /** When set, the query must match; `lastIndex` is reset first. @default none */
+    queryPattern?: RegExp;
+}
+/** Resolved trigger range in the logical offset domain (N6). */
+interface SuggestionMenuTarget {
+    blockId: string;
+    startOffset: number;
+    endOffset: number;
+    query: string;
+    trigger: string;
+}
+/**
+ * Logical inline text of a block: stored string text plus one U+FFFC per
+ * inline atom, in the same offset domain as caret offsets and
+ * `block.length()` (N6).
+ *
+ * @param block - Live block handle to read.
+ * @returns The logical string. Empty blocks return `""`.
+ * @throws Never.
+ */
+declare function inlineLogicalText(block: BlockHandle): string;
+/**
+ * Resolves a collapsed caret to a suggestion-menu trigger range.
+ *
+ * Matching uses the logical offset domain (N6), not `block.textContent()`.
+ * Each inline atom occupies one offset (U+FFFC in {@link inlineLogicalText}).
+ * A query range that contains an atom is refused. A trigger immediately after
+ * an atom starts at the offset after that atom; `boundary: "whitespace"` still
+ * rejects when the preceding unit is the atom.
+ *
+ * @param editor - Editor whose collapsed text caret is read.
+ * @param trigger - Trigger character and match constraints. See
+ *   {@link SuggestionMenuTrigger} for field defaults.
+ * @returns The trigger range in logical offsets, or `null` when the caret is
+ *   not a collapsed in-block text selection or the prefix does not match.
+ * @throws Never. Non-matches return `null`.
+ */
+declare function resolveSuggestionMenuTarget(editor: Editor, trigger: SuggestionMenuTrigger): SuggestionMenuTarget | null;
+
 type DefaultKeymapContext = "text" | "cell" | "block" | "any";
 type KeymapPlatform = "macos" | "windows" | "linux";
 interface DefaultKeymapBinding {
@@ -1036,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[];
 
@@ -1048,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 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 };
+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

@@ -353,6 +353,47 @@ function filterOpsForDocumentProfile(ops, documentProfile, registry) {
   };
 }
 
+// src/schema/generateValidator.ts
+function generateValidator(propSchemas) {
+  return (raw) => {
+    const result = {};
+    for (const [key, schema] of Object.entries(propSchemas)) {
+      let value = raw[key];
+      if (value === void 0 || value === null) {
+        result[key] = schema.default;
+        continue;
+      }
+      const schemaType = Array.isArray(schema.type) ? schema.type[0] : schema.type;
+      if (schemaType === "number" && typeof value === "string") {
+        const parsed = Number(value);
+        if (!Number.isNaN(parsed)) value = parsed;
+      }
+      if (schemaType === "boolean" && typeof value === "string") {
+        value = value === "true";
+      }
+      const matchesSchemaType = schemaType === "array" ? Array.isArray(value) : typeof value === schemaType;
+      if (schema.type && schemaType !== void 0 && !matchesSchemaType) {
+        result[key] = schema.default;
+        continue;
+      }
+      if (typeof value === "number") {
+        if (schema.minimum !== void 0 && value < schema.minimum) {
+          value = schema.minimum;
+        }
+        if (typeof value === "number" && schema.maximum !== void 0 && value > schema.maximum) {
+          value = schema.maximum;
+        }
+      }
+      if (schema.enum && !schema.enum.includes(value)) {
+        result[key] = schema.default;
+        continue;
+      }
+      result[key] = value;
+    }
+    return result;
+  };
+}
+
 // src/schema/prop.ts
 var PropChainImpl = class {
   _schema;
@@ -659,6 +700,10 @@ var SchemaRegistryImpl = class _SchemaRegistryImpl {
     if (patch.serialize) {
       merged.serialize = { ...existing.serialize, ...patch.serialize };
     }
+    if ("propSchema" in patch && !("validateProps" in patch)) {
+      const propSchema = merged.propSchema ?? {};
+      merged.validateProps = Object.keys(propSchema).length > 0 ? generateValidator(propSchema) : void 0;
+    }
     const blocks = new Map(this._blocks);
     blocks.set(type, merged);
     return new _SchemaRegistryImpl({
@@ -753,45 +798,6 @@ function generateAIDescription(type, props) {
   }).join(", ");
   return `${type}: ${propDescriptions}`;
 }
-function generateValidator(propSchemas) {
-  return (raw) => {
-    const result = {};
-    for (const [key, schema] of Object.entries(propSchemas)) {
-      let value = raw[key];
-      if (value === void 0 || value === null) {
-        result[key] = schema.default;
-        continue;
-      }
-      const schemaType = Array.isArray(schema.type) ? schema.type[0] : schema.type;
-      if (schemaType === "number" && typeof value === "string") {
-        const parsed = Number(value);
-        if (!Number.isNaN(parsed)) value = parsed;
-      }
-      if (schemaType === "boolean" && typeof value === "string") {
-        value = value === "true";
-      }
-      const matchesSchemaType = schemaType === "array" ? Array.isArray(value) : typeof value === schemaType;
-      if (schema.type && schemaType !== void 0 && !matchesSchemaType) {
-        result[key] = schema.default;
-        continue;
-      }
-      if (typeof value === "number") {
-        if (schema.minimum !== void 0 && value < schema.minimum) {
-          value = schema.minimum;
-        }
-        if (typeof value === "number" && schema.maximum !== void 0 && value > schema.maximum) {
-          value = schema.maximum;
-        }
-      }
-      if (schema.enum && !schema.enum.includes(value)) {
-        result[key] = schema.default;
-        continue;
-      }
-      result[key] = value;
-    }
-    return result;
-  };
-}
 function defineBlock(typeOrConfig, maybeConfig) {
   const type = typeof typeOrConfig === "string" ? typeOrConfig : typeOrConfig.type;
   const config = typeof typeOrConfig === "string" ? maybeConfig : typeOrConfig;
@@ -3422,6 +3428,18 @@ function snapshotPlain(value) {
       writable: true
     });
   }
+  for (const key of Object.getOwnPropertySymbols(value)) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    if (!descriptor?.enumerable) {
+      continue;
+    }
+    Object.defineProperty(next, key, {
+      value: snapshotPlain(descriptor.value),
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  }
   return next;
 }
 function snapshotOps(ops) {
@@ -4855,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)) {
@@ -4894,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);
@@ -4936,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);
   }
 };
 
@@ -5003,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) {
@@ -5030,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) {
@@ -7738,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) {
@@ -7752,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);
@@ -7773,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);
@@ -8070,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) {
@@ -8109,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(
@@ -8171,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) {
@@ -9061,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");
@@ -9846,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) {
@@ -10873,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) {
@@ -14288,6 +14326,77 @@ function emitMissingBlock(editor, blockId) {
   emit("diagnostic", event);
 }
 
+// src/suggestion/resolveSuggestionMenuTarget.ts
+var DEFAULT_LOOKBEHIND = 80;
+function inlineLogicalText(block) {
+  return logicalInline(block).text;
+}
+function resolveSuggestionMenuTarget(editor, trigger) {
+  if (trigger.char.length === 0) {
+    return null;
+  }
+  const selection = editor.selection;
+  if (selection?.type !== "text" || !isCollapsed(selection)) {
+    return null;
+  }
+  if (selection.anchor.blockId !== selection.focus.blockId) {
+    return null;
+  }
+  const block = editor.getBlock(selection.focus.blockId);
+  if (!block) {
+    return null;
+  }
+  const offset = selection.focus.offset;
+  const lookbehind = trigger.lookbehind ?? DEFAULT_LOOKBEHIND;
+  const prefixStartOffset = Math.max(0, offset - lookbehind);
+  const { text, atoms } = logicalInline(block);
+  const textBefore = text.slice(prefixStartOffset, offset);
+  const triggerIndex = textBefore.lastIndexOf(trigger.char);
+  if (triggerIndex < 0) {
+    return null;
+  }
+  if (trigger.boundary === "whitespace") {
+    const previousChar = textBefore[triggerIndex - 1];
+    if (previousChar && !/\s/.test(previousChar)) {
+      return null;
+    }
+  }
+  const query = textBefore.slice(triggerIndex + trigger.char.length);
+  const startOffset = prefixStartOffset + triggerIndex;
+  const queryStartOffset = startOffset + trigger.char.length;
+  if (queryRangeContainsAtom(atoms, queryStartOffset, offset)) {
+    return null;
+  }
+  if (!trigger.allowSpaces && /\s/.test(query)) {
+    return null;
+  }
+  if (trigger.closingChar && query.includes(trigger.closingChar)) {
+    return null;
+  }
+  if (query.length < (trigger.minQueryLength ?? 0)) {
+    return null;
+  }
+  if (trigger.maxQueryLength !== void 0 && query.length > trigger.maxQueryLength) {
+    return null;
+  }
+  if (trigger.queryPattern) {
+    trigger.queryPattern.lastIndex = 0;
+    if (!trigger.queryPattern.test(query)) {
+      return null;
+    }
+  }
+  return {
+    blockId: selection.focus.blockId,
+    startOffset,
+    endOffset: offset,
+    query,
+    trigger: trigger.char
+  };
+}
+function queryRangeContainsAtom(atoms, queryStart, queryEnd) {
+  return atoms.some((atom) => atom.start < queryEnd && atom.end > queryStart);
+}
+
 // src/commands/resolveDirectedBinding.ts
 function resolveDirectedBinding(editor, binding) {
   const direction = resolveFocusBlockDirection(editor);
@@ -14913,6 +15022,7 @@ export {
   historyUndo,
   hookPriorityToPrecedence,
   indent,
+  inlineLogicalText,
   inputRulesEngineFacet,
   inputRulesFacet,
   insertLineBreak,
@@ -14968,6 +15078,7 @@ export {
   resolveSchema,
   resolveSchemaA11y,
   resolveSelectionTargetBlockIds,
+  resolveSuggestionMenuTarget,
   runMigrations,
   searchControllerFacet,
   selectAdjacentInlineAtom,
@@ -14985,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.7",
+  "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.7",
-    "@input/pen-types": "^0.1.7"
+    "@input/pen-yjs": "^0.1.9",
+    "@input/pen-types": "^0.1.9"
   },
   "devDependencies": {
     "tsup": "^8.4.0",