@owomark/core 0.1.2 → 0.1.3

package/README.md

@@ -2,7 +2,7 @@
 
 Framework-agnostic Markdown editor engine. Provides document model, incremental rendering, input handling, commands, and selection management for a single-layer `contenteditable` editing experience.
 
-Official package: `@owomark/core`. The flat name `owomark-core` is reserved only as a compatibility redirect and should not be used for new installs.
+Install the official package: `@owomark/core`.
 
 ## Install
 
@@ -48,7 +48,7 @@ view.destroy();
 core.destroy();
 ```
 
-For backward compatibility, a legacy standalone editor API is also available:
+The standalone DOM editor API is also available through `@owomark/view`:
 
 ```ts
 import { createOwoMarkVanillaEditor } from '@owomark/view';
@@ -193,7 +193,7 @@ const dirtyRange = computePreviewDirtyRange(previousBlocks, blocks);
 ```
 
 - Adjacent same-type container blocks (lists, blockquotes) are grouped into a single `PreviewBlock`
-- Each block has a stable `blockId` (`L{startLine}-{endLine}`) for DOM reconciliation
+- Each block has a content-based `blockId` (`{renderKey}#{occurrenceIndex}`) for stable DOM reconciliation
 - `renderKey` (djb2 hash of `kind:theme:raw`) drives cache invalidation
 
 ### Preview Types

package/dist/{chunk-RINTEGPG.js → chunk-TRLKIMRD.js}

@@ -194,6 +194,7 @@ function tokenizeInline(raw, baseOffset = 0) {
 
 // src/parser/blocks.ts
 var MATH_FENCE_RE = /^\$\$\s*$/;
+var SINGLE_LINE_MATH_BLOCK_RE = /^ {0,3}\$\$(?!\s*$)([^\n]*?)(?<!\\)\$\$\s*$/;
 function tokenizeBlock(raw, blockType, baseOffset = 0) {
   if (blockType === "code-fence") {
     return tokenizeCodeFence(raw, baseOffset);
@@ -207,6 +208,18 @@ function tokenizeBlock(raw, blockType, baseOffset = 0) {
     });
   }
   if (blockType === "math-block") {
+    const singleLineMatch = raw.match(SINGLE_LINE_MATH_BLOCK_RE);
+    if (singleLineMatch) {
+      const leadingWhitespace = raw.match(/^ {0,3}/)?.[0] ?? "";
+      const trimmed = raw.slice(leadingWhitespace.length).replace(/\s+$/, "");
+      const inner = trimmed.slice(2, -2);
+      const start = baseOffset + leadingWhitespace.length;
+      return [
+        { type: "fence-marker", text: "$$", start, end: start + 2 },
+        { type: "math-text", text: inner, start: start + 2, end: start + 2 + inner.length },
+        { type: "fence-marker", text: "$$", start: start + 2 + inner.length, end: start + 4 + inner.length }
+      ];
+    }
     return tokenizeMultiLineBlock(raw, baseOffset, (line, _i, isFirst, isLast) => {
       if ((isFirst || isLast) && MATH_FENCE_RE.test(line)) {
         return [{ type: "fence-marker", text: line, start: -1, end: -1 }];
@@ -409,6 +422,19 @@ function parseMarkdownToDocument(markdown, genId) {
         continue;
       }
     }
+    if (SINGLE_LINE_MATH_BLOCK_RE.test(line)) {
+      const tokens2 = tokenizeBlock(line, "math-block", offset);
+      blocks.push({
+        type: "math-block",
+        raw: line,
+        id: genBlockId(),
+        depth: 0,
+        decorators: tokensToDecorators(tokens2, line, offset)
+      });
+      offset += line.length + 1;
+      i++;
+      continue;
+    }
     if (MATH_FENCE_RE.test(line)) {
       let closeIndex = -1;
       for (let j = i + 1; j < lines.length; j++) {

package/dist/{dom-adapter-BwEilZtY.d.ts → dom-adapter-CTSJe5Uo.d.ts}

@@ -130,6 +130,12 @@ type JsonValue = JsonPrimitive | JsonValue[] | {
     [key: string]: JsonValue;
 };
 type PreviewBlock = {
+    /**
+     * Content-based identity: `{renderKey}#{occurrenceIndex}`.
+     * Stable across blank line edits — only changes when block content changes.
+     * Used as the DOM wrapper lifecycle key by the virtual preview engine.
+     * For line-range positional mapping (scroll sync), use startLine/endLine.
+     */
     blockId: string;
     kind: PreviewBlockKind;
     raw: string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { B as BlockNode, a as BlockContextType, O as OwoMarkSelection, C as CoreStateSnapshot, S as SlashState, b as CommandRegistry, c as OwoMarkDocument, D as DirtyRange, P as PreviewBlockKind, d as PreviewBlock, e as BlockTransform, f as OwoMarkSharedStateController, I as InlineToken, g as InlineTokenType } from './dom-adapter-BwEilZtY.js';
-export { h as BeforeInputIntent, i as BlockContext, j as BlockContextListener, k as BlockInsertType, l as BlockType, m as CommandContext, n as CommandDefinition, o as CompositionState, p as CoreApplyAction, q as CoreApplyResult, r as CoreSelectionSnapshot, s as CreateOwoMarkCoreOptions, t as Decorator, u as DecoratorType, v as DocumentChangeCallback, w as DomAdapterInstance, H as HeadingLevel, x as HistoryEntry, y as IndentMode, z as IndentResult, J as JsonPrimitive, A as JsonValue, K as KeyDownIntent, L as Leaf, E as OwoMarkCommands, F as OwoMarkCore, G as OwoMarkEditorInstance, M as OwoMarkEditorLike, N as OwoMarkSharedState, Q as OwoMarkSharedStateStore, R as PasteIntent, T as PreviewDirtyReason, U as SlashStateListener, V as SlashTriggerInfo, W as VirtualPosition, X as VirtualSelection, Y as applyMarkdownIndent, Z as createOwoMarkCore, _ as getBlockIndexForPosition, $ as isVirtualSelectionCollapsed, a0 as linearToVirtual, a1 as linearToVirtualPosition, a2 as resolveIndentSize, a3 as virtualPositionToLinear, a4 as virtualPositionsEqual, a5 as virtualToLinear } from './dom-adapter-BwEilZtY.js';
+import { B as BlockNode, a as BlockContextType, O as OwoMarkSelection, C as CoreStateSnapshot, S as SlashState, b as CommandRegistry, c as OwoMarkDocument, D as DirtyRange, P as PreviewBlockKind, d as PreviewBlock, e as BlockTransform, f as OwoMarkSharedStateController, I as InlineToken, g as InlineTokenType } from './dom-adapter-CTSJe5Uo.js';
+export { h as BeforeInputIntent, i as BlockContext, j as BlockContextListener, k as BlockInsertType, l as BlockType, m as CommandContext, n as CommandDefinition, o as CompositionState, p as CoreApplyAction, q as CoreApplyResult, r as CoreSelectionSnapshot, s as CreateOwoMarkCoreOptions, t as Decorator, u as DecoratorType, v as DocumentChangeCallback, w as DomAdapterInstance, H as HeadingLevel, x as HistoryEntry, y as IndentMode, z as IndentResult, J as JsonPrimitive, A as JsonValue, K as KeyDownIntent, L as Leaf, E as OwoMarkCommands, F as OwoMarkCore, G as OwoMarkEditorInstance, M as OwoMarkEditorLike, N as OwoMarkSharedState, Q as OwoMarkSharedStateStore, R as PasteIntent, T as PreviewDirtyReason, U as SlashStateListener, V as SlashTriggerInfo, W as VirtualPosition, X as VirtualSelection, Y as applyMarkdownIndent, Z as createOwoMarkCore, _ as getBlockIndexForPosition, $ as isVirtualSelectionCollapsed, a0 as linearToVirtual, a1 as linearToVirtualPosition, a2 as resolveIndentSize, a3 as virtualPositionToLinear, a4 as virtualPositionsEqual, a5 as virtualToLinear } from './dom-adapter-CTSJe5Uo.js';
 export { WordBoundaryResult, deleteToLineEnd, deleteToLineStart, deleteWordBackward, deleteWordForward } from './internal/commands/word-boundary.js';
 export { normalizeMarkdownPaste } from './internal/clipboard/paste.js';
 export { enableMapSet, produce } from 'immer';
@@ -95,12 +95,22 @@ declare function expandDirtyRange(current: DirtyRange | null, blockIndex: number
 declare function expandWithContext(range: DirtyRange, totalBlocks: number, context?: number): DirtyRange | null;
 
 /**
- * Stable block identity derivation.
+ * Block identity derivation.
  *
- * Both editor and preview sides derive blockId from the same source line
- * range, ensuring they share a common identity without runtime DOM coupling.
+ * blockId is a content-based identity: stable across blank line edits.
+ * sourceKey is a line-range positional tag: used by scroll sync for
+ * editor↔preview coordinate mapping.
  */
-declare function deriveBlockId(startLine: number, endLine: number): string;
+/**
+ * Derive a content-based block identity from its render key and
+ * occurrence index. Two blocks with identical content but different
+ * positions get different blockIds via their occurrence index.
+ */
+declare function deriveBlockId(renderKey: string, occurrenceIndex: number): string;
+/**
+ * Derive a line-range positional key for scroll sync mapping.
+ */
+declare function deriveSourceKey(startLine: number, endLine: number): string;
 
 /**
  * Derive a stable render key for a preview block.
@@ -352,4 +362,4 @@ declare function buildVirtualRows(blocks: readonly BlockNode[], heightCache: Map
 /** Compute the visible range given scroll state. */
 declare function computeVisibleRange(rows: VirtualRow[], scrollTop: number, viewportHeight: number, overscan?: number): VisibleRange;
 
-export { BLOCK_TYPE_TO_CLASS, BQ_STEP, BlockContextType, type BlockIdGenerator, BlockNode, BlockTransform, CommandRegistry, type CommandResult, type CoreEventHub, type CoreSlashStateListener, CoreStateSnapshot, type CreateSharedStateOptions, DirtyRange, type ImageSizeSyntax, InlineToken, InlineTokenType, NOT_HANDLED, OwoMarkDocument, OwoMarkSelection, OwoMarkSharedStateController, PreviewBlock, PreviewBlockKind, SlashState, TOKEN_TO_CLASS, type VirtualRow, type VisibleRange, buildBlockquoteBarsBoxShadow, buildVirtualRows, computePreviewDirtyRange, computeVisibleRange, createBlockElement, createBlockIdGenerator, createCommandRegistry, createImageSizeTransform, createSharedStateStore, deriveBlockId, deriveRenderKey, detectAndRenderDirty, domRangeToOffset, estimateEditorBlockHeight, expandDirtyRange, expandWithContext, fullRender, getBlockAtOffset, getBlockById, getBlockIndexById, getBlockStartOffset, handleCharInput, handleMarkdownEnter, handleSmartBackspace, handleSmartDelete, insertCodeFence, insertImage, insertLink, insertMathBlock, insertSideAnnotation, insertTable, invalidateBlockCache, offsetToDomRange, parseMarkdownToDocument, patchDirtyBlocks, projectToPreviewBlocks, readSelection, reconcileBlocks, resetBlockIdCounter, resolveBlockContextType, restoreSelection, serializeDocument, toggleBold, toggleItalic, tokenizeBlock, tokenizeInline, updateBlockElement };
+export { BLOCK_TYPE_TO_CLASS, BQ_STEP, BlockContextType, type BlockIdGenerator, BlockNode, BlockTransform, CommandRegistry, type CommandResult, type CoreEventHub, type CoreSlashStateListener, CoreStateSnapshot, type CreateSharedStateOptions, DirtyRange, type ImageSizeSyntax, InlineToken, InlineTokenType, NOT_HANDLED, OwoMarkDocument, OwoMarkSelection, OwoMarkSharedStateController, PreviewBlock, PreviewBlockKind, SlashState, TOKEN_TO_CLASS, type VirtualRow, type VisibleRange, buildBlockquoteBarsBoxShadow, buildVirtualRows, computePreviewDirtyRange, computeVisibleRange, createBlockElement, createBlockIdGenerator, createCommandRegistry, createImageSizeTransform, createSharedStateStore, deriveBlockId, deriveRenderKey, deriveSourceKey, detectAndRenderDirty, domRangeToOffset, estimateEditorBlockHeight, expandDirtyRange, expandWithContext, fullRender, getBlockAtOffset, getBlockById, getBlockIndexById, getBlockStartOffset, handleCharInput, handleMarkdownEnter, handleSmartBackspace, handleSmartDelete, insertCodeFence, insertImage, insertLink, insertMathBlock, insertSideAnnotation, insertTable, invalidateBlockCache, offsetToDomRange, parseMarkdownToDocument, patchDirtyBlocks, projectToPreviewBlocks, readSelection, reconcileBlocks, resetBlockIdCounter, resolveBlockContextType, restoreSelection, serializeDocument, toggleBold, toggleItalic, tokenizeBlock, tokenizeInline, updateBlockElement };

package/dist/index.js

@@ -53,7 +53,7 @@ import {
   virtualPositionToLinear,
   virtualPositionsEqual,
   virtualToLinear
-} from "./chunk-RINTEGPG.js";
+} from "./chunk-TRLKIMRD.js";
 import {
   normalizeMarkdownPaste
 } from "./chunk-BGXCXQZP.js";
@@ -65,7 +65,10 @@ import {
 } from "./chunk-MPIWZLI3.js";
 
 // src/preview/block-id.ts
-function deriveBlockId(startLine, endLine) {
+function deriveBlockId(renderKey, occurrenceIndex) {
+  return `${renderKey}#${occurrenceIndex}`;
+}
+function deriveSourceKey(startLine, endLine) {
   return `L${startLine}-${endLine}`;
 }
 
@@ -159,6 +162,7 @@ function collectSideAnnotationChain(blocks, startIndex) {
 function projectToPreviewBlocks(doc, themeKey, transforms) {
   const result = [];
   const blocks = doc.blocks;
+  const occurrenceCounter = /* @__PURE__ */ new Map();
   let currentLine = 1;
   let i = 0;
   while (i < blocks.length) {
@@ -168,14 +172,16 @@ function projectToPreviewBlocks(doc, themeKey, transforms) {
     const sideChain = collectSideAnnotationChain(blocks, i);
     if (sideChain) {
       const endLine2 = startLine + sideChain.endLine;
-      const blockId2 = deriveBlockId(startLine, endLine2);
+      const renderKey2 = deriveRenderKey(sideChain.raw, "paragraph", themeKey);
+      const occurrence2 = occurrenceCounter.get(renderKey2) ?? 0;
+      occurrenceCounter.set(renderKey2, occurrence2 + 1);
       result.push({
-        blockId: blockId2,
+        blockId: deriveBlockId(renderKey2, occurrence2),
         kind: "paragraph",
         raw: sideChain.raw,
         startLine,
         endLine: endLine2,
-        renderKey: deriveRenderKey(sideChain.raw, "paragraph", themeKey)
+        renderKey: renderKey2
       });
       currentLine = endLine2 + 1;
       i = sideChain.endIndex + 1;
@@ -199,14 +205,16 @@ function projectToPreviewBlocks(doc, themeKey, transforms) {
       }
       const raw = groupRawParts.join("\n");
       const kind2 = blockTypeToPreviewKind(block);
-      const blockId2 = deriveBlockId(startLine, endLine2);
+      const renderKey2 = deriveRenderKey(raw, kind2, themeKey);
+      const occurrence2 = occurrenceCounter.get(renderKey2) ?? 0;
+      occurrenceCounter.set(renderKey2, occurrence2 + 1);
       result.push({
-        blockId: blockId2,
+        blockId: deriveBlockId(renderKey2, occurrence2),
         kind: kind2,
         raw,
         startLine,
         endLine: endLine2,
-        renderKey: deriveRenderKey(raw, kind2, themeKey)
+        renderKey: renderKey2
       });
       currentLine = endLine2 + 1;
       i = j;
@@ -214,14 +222,16 @@ function projectToPreviewBlocks(doc, themeKey, transforms) {
     }
     const endLine = startLine + blockLines - 1;
     const kind = blockTypeToPreviewKind(block);
-    const blockId = deriveBlockId(startLine, endLine);
+    const renderKey = deriveRenderKey(block.raw, kind, themeKey);
+    const occurrence = occurrenceCounter.get(renderKey) ?? 0;
+    occurrenceCounter.set(renderKey, occurrence + 1);
     const previewBlock = {
-      blockId,
+      blockId: deriveBlockId(renderKey, occurrence),
       kind,
       raw: block.raw,
       startLine,
       endLine,
-      renderKey: deriveRenderKey(block.raw, kind, themeKey)
+      renderKey
     };
     if (block.type === "code-fence") {
       previewBlock.language = block.language || null;
@@ -243,7 +253,7 @@ function projectToPreviewBlocks(doc, themeKey, transforms) {
   });
 }
 function blocksMatch(a, b) {
-  return a.renderKey === b.renderKey && a.blockId === b.blockId;
+  return a.blockId === b.blockId;
 }
 function computePreviewDirtyRange(oldBlocks, newBlocks) {
   const oldLen = oldBlocks.length;
@@ -599,6 +609,7 @@ export {
   deleteWordForward,
   deriveBlockId,
   deriveRenderKey,
+  deriveSourceKey,
   detectAndRenderDirty,
   domRangeToOffset,
   enableMapSet,

package/dist/internal/dom-adapter.d.ts

@@ -1 +1 @@
-export { v as DocumentChangeCallback, w as DomAdapterInstance, a6 as createDomAdapter } from '../dom-adapter-BwEilZtY.js';
+export { v as DocumentChangeCallback, w as DomAdapterInstance, a6 as createDomAdapter } from '../dom-adapter-CTSJe5Uo.js';

package/dist/internal/dom-adapter.js

@@ -4,7 +4,7 @@ import {
   fullRender,
   readSelection,
   restoreSelection
-} from "../chunk-RINTEGPG.js";
+} from "../chunk-TRLKIMRD.js";
 import "../chunk-BGXCXQZP.js";
 import "../chunk-MPIWZLI3.js";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owomark/core",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Framework-agnostic core engine for the OwoMark editor.",
   "type": "module",
   "main": "./dist/index.js",