@owomark/core 0.1.5 → 0.1.7

package/dist/chunk-3KTK7CSS.js

@@ -0,0 +1,82 @@
+import {
+  createDescriptorRegistry,
+  requireDescriptor,
+  validateEditorEntryDescriptors
+} from "./chunk-OOH46GIF.js";
+
+// src/semantic/editor/index.ts
+var BUILTIN_EDITOR_I18N = {
+  "command.bold.label": "Bold",
+  "command.italic.label": "Italic",
+  "command.link.label": "Link",
+  "command.codeFence.label": "Code Block",
+  "command.math.label": "Math Block",
+  "command.sideAnnotation.label": "Side Annotation",
+  "command.heading1.label": "Heading 1",
+  "command.heading2.label": "Heading 2",
+  "command.heading3.label": "Heading 3",
+  "command.blockquote.label": "Blockquote",
+  "command.unorderedList.label": "Bullet List",
+  "command.orderedList.label": "Numbered List",
+  "command.thematicBreak.label": "Divider",
+  "command.table.label": "Table",
+  "command.image.label": "Image",
+  "command.component.note.label": "Note",
+  "command.component.callout.label": "Callout",
+  "command.component.codeDemo.label": "Code Demo",
+  "command.component.details.label": "Details",
+  "command.component.steps.label": "Steps",
+  "command.component.tabs.label": "Tabs",
+  "command.component.linkCard.label": "Link Card",
+  "command.component.fileTree.label": "File Tree",
+  "command.category.basic": "basic",
+  "command.category.insert": "insert",
+  "command.category.format": "format",
+  "command.category.components": "components"
+};
+var builtinEditorEntryDescriptors = [
+  { key: "builtin.editor.bold", family: "editor", commandId: "bold", entryKind: "format", labelKey: "command.bold.label", categoryKey: "command.category.format", keywords: ["bold"], slashMenu: false, toolbarEligible: false, shortcut: "Ctrl+B", specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.italic", family: "editor", commandId: "italic", entryKind: "format", labelKey: "command.italic.label", categoryKey: "command.category.format", keywords: ["italic"], slashMenu: false, toolbarEligible: false, shortcut: "Ctrl+I", specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.link", family: "editor", commandId: "link", entryKind: "insert", labelKey: "command.link.label", categoryKey: "command.category.insert", keywords: ["link"], slashMenu: true, toolbarEligible: false, priority: 50, shortcut: "Ctrl+K", specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.code-fence", family: "editor", commandId: "code-fence", entryKind: "insert", labelKey: "command.codeFence.label", categoryKey: "command.category.insert", keywords: ["code", "fence", "block"], slashMenu: true, toolbarEligible: false, priority: 60, specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.math", family: "editor", commandId: "math", entryKind: "insert", labelKey: "command.math.label", categoryKey: "command.category.insert", keywords: ["math", "equation", "formula", "latex", "katex"], slashMenu: true, toolbarEligible: false, priority: 65, specIds: ["docs/specs/editor.md"], featureFlag: "enableMath" },
+  { key: "builtin.editor.side-annotation", family: "editor", commandId: "side-annotation", entryKind: "insert", labelKey: "command.sideAnnotation.label", categoryKey: "command.category.insert", keywords: ["side", "annotation", "brace", "margin", "note"], slashMenu: true, toolbarEligible: false, priority: 70, shortcut: "Ctrl+Shift+]", specIds: ["docs/specs/editor.md"], featureFlag: "enableSideAnnotation" },
+  { key: "builtin.editor.heading-1", family: "editor", commandId: "heading-1", entryKind: "block", labelKey: "command.heading1.label", categoryKey: "command.category.basic", keywords: ["h1", "title"], slashMenu: true, toolbarEligible: false, priority: 10, specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.heading-2", family: "editor", commandId: "heading-2", entryKind: "block", labelKey: "command.heading2.label", categoryKey: "command.category.basic", keywords: ["h2"], slashMenu: true, toolbarEligible: false, priority: 11, specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.heading-3", family: "editor", commandId: "heading-3", entryKind: "block", labelKey: "command.heading3.label", categoryKey: "command.category.basic", keywords: ["h3"], slashMenu: true, toolbarEligible: false, priority: 12, specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.blockquote", family: "editor", commandId: "blockquote", entryKind: "block", labelKey: "command.blockquote.label", categoryKey: "command.category.basic", keywords: ["quote"], slashMenu: true, toolbarEligible: false, priority: 20, specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.unordered-list", family: "editor", commandId: "unordered-list", entryKind: "block", labelKey: "command.unorderedList.label", categoryKey: "command.category.basic", keywords: ["bullet", "list", "ul"], slashMenu: true, toolbarEligible: false, priority: 30, specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.ordered-list", family: "editor", commandId: "ordered-list", entryKind: "block", labelKey: "command.orderedList.label", categoryKey: "command.category.basic", keywords: ["number", "list", "ol"], slashMenu: true, toolbarEligible: false, priority: 31, specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.thematic-break", family: "editor", commandId: "thematic-break", entryKind: "block", labelKey: "command.thematicBreak.label", categoryKey: "command.category.basic", keywords: ["divider", "hr", "line", "separator"], slashMenu: true, toolbarEligible: false, priority: 40, specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.insert-table", family: "editor", commandId: "insert-table", entryKind: "insert", labelKey: "command.table.label", categoryKey: "command.category.insert", keywords: ["table", "grid"], slashMenu: true, toolbarEligible: false, priority: 75, specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.insert-image", family: "editor", commandId: "insert-image", entryKind: "insert", labelKey: "command.image.label", categoryKey: "command.category.insert", keywords: ["image", "picture", "photo", "img"], slashMenu: true, toolbarEligible: false, priority: 80, specIds: ["docs/specs/editor.md"] },
+  { key: "builtin.editor.component-note", family: "editor", commandId: "component-note", entryKind: "component", labelKey: "command.component.note.label", categoryKey: "command.category.components", keywords: ["note", "tip", "info", "\u8BF4\u660E"], slashMenu: true, toolbarEligible: true, templateKey: "component-note", specIds: ["docs/specs/editor.md", "docs/specs/owomark-components-extension.md"], featureFlag: "enableComponents" },
+  { key: "builtin.editor.component-callout", family: "editor", commandId: "component-callout", entryKind: "component", labelKey: "command.component.callout.label", categoryKey: "command.category.components", keywords: ["callout", "warning", "warn", "info"], slashMenu: true, toolbarEligible: true, templateKey: "component-callout", specIds: ["docs/specs/editor.md", "docs/specs/owomark-components-extension.md"], featureFlag: "enableComponents" },
+  { key: "builtin.editor.component-code-demo", family: "editor", commandId: "component-code-demo", entryKind: "component", labelKey: "command.component.codeDemo.label", categoryKey: "command.category.components", keywords: ["code", "demo", "example", "snippet"], slashMenu: true, toolbarEligible: true, templateKey: "component-code-demo", specIds: ["docs/specs/editor.md", "docs/specs/owomark-components-extension.md"], featureFlag: "enableComponents" },
+  { key: "builtin.editor.component-details", family: "editor", commandId: "component-details", entryKind: "component", labelKey: "command.component.details.label", categoryKey: "command.category.components", keywords: ["details", "accordion", "collapse"], slashMenu: true, toolbarEligible: true, templateKey: "component-details", specIds: ["docs/specs/editor.md", "docs/specs/owomark-components-extension.md"], featureFlag: "enableComponents" },
+  { key: "builtin.editor.component-steps", family: "editor", commandId: "component-steps", entryKind: "component", labelKey: "command.component.steps.label", categoryKey: "command.category.components", keywords: ["steps", "process", "guide"], slashMenu: true, toolbarEligible: true, templateKey: "component-steps", specIds: ["docs/specs/editor.md", "docs/specs/owomark-components-extension.md"], featureFlag: "enableComponents" },
+  { key: "builtin.editor.component-tabs", family: "editor", commandId: "component-tabs", entryKind: "component", labelKey: "command.component.tabs.label", categoryKey: "command.category.components", keywords: ["tabs", "tab", "switch"], slashMenu: true, toolbarEligible: true, templateKey: "component-tabs", specIds: ["docs/specs/editor.md", "docs/specs/owomark-components-extension.md"], featureFlag: "enableComponents" },
+  { key: "builtin.editor.component-link-card", family: "editor", commandId: "component-link-card", entryKind: "component", labelKey: "command.component.linkCard.label", categoryKey: "command.category.components", keywords: ["link", "card", "reference"], slashMenu: true, toolbarEligible: true, templateKey: "component-link-card", specIds: ["docs/specs/editor.md", "docs/specs/owomark-components-extension.md"], featureFlag: "enableComponents" },
+  { key: "builtin.editor.component-file-tree", family: "editor", commandId: "component-file-tree", entryKind: "component", labelKey: "command.component.fileTree.label", categoryKey: "command.category.components", keywords: ["file", "tree", "directory"], slashMenu: true, toolbarEligible: true, templateKey: "component-file-tree", specIds: ["docs/specs/editor.md", "docs/specs/owomark-components-extension.md"], featureFlag: "enableComponents" }
+];
+validateEditorEntryDescriptors(builtinEditorEntryDescriptors);
+var editorEntryRegistry = createDescriptorRegistry(builtinEditorEntryDescriptors, "editor");
+function getEditorEntryDescriptor(key) {
+  return requireDescriptor(editorEntryRegistry, key, "editor");
+}
+function getEditorEntryDescriptorByCommandId(commandId) {
+  return editorEntryRegistry.list().find((descriptor) => descriptor.commandId === commandId);
+}
+function resolveEditorEntryPresentation(descriptor) {
+  return {
+    label: BUILTIN_EDITOR_I18N[descriptor.labelKey] ?? descriptor.labelKey,
+    category: BUILTIN_EDITOR_I18N[descriptor.categoryKey] ?? descriptor.categoryKey
+  };
+}
+
+export {
+  editorEntryRegistry,
+  getEditorEntryDescriptor,
+  getEditorEntryDescriptorByCommandId,
+  resolveEditorEntryPresentation
+};

package/dist/chunk-5JNL3LHV.js

@@ -0,0 +1,215 @@
+import {
+  deriveSourceKey
+} from "./chunk-WFPUIPWU.js";
+
+// src/scroll/projection.ts
+var projectionRevisionCounter = 0;
+function projectToScrollSegments(previewBlocks) {
+  const segments = [];
+  for (const block of previewBlocks) {
+    const sourceKey = deriveSourceKey(block.startLine, block.endLine);
+    segments.push({
+      contentId: block.blockId,
+      sourceKey,
+      startLine: block.startLine,
+      endLine: block.endLine,
+      kind: block.kind
+    });
+  }
+  return segments;
+}
+function buildScrollProjectionSnapshot(previewBlocks, documentRevision) {
+  projectionRevisionCounter += 1;
+  return {
+    documentRevision,
+    projectionRevision: projectionRevisionCounter,
+    segments: projectToScrollSegments(previewBlocks)
+  };
+}
+
+// src/scroll/progress-engine.ts
+var DEFAULT_VIEWPORT_ANCHOR_RATIO = 0.35;
+var EPSILON = 1e-9;
+var BOTTOM_SNAP_THRESHOLD_PX = 1;
+function buildProgressSegments(projection, geometry) {
+  if (projection.segments.length === 0) return [];
+  const geoIndex = /* @__PURE__ */ new Map();
+  for (const g of geometry.segments) {
+    geoIndex.set(g.sourceKey, g);
+  }
+  let totalWeight = 0;
+  const weights = [];
+  for (const seg of projection.segments) {
+    const w = Math.max(1, seg.endLine - seg.startLine + 1);
+    weights.push(w);
+    totalWeight += w;
+  }
+  const result = [];
+  let cum = 0;
+  for (let i = 0; i < projection.segments.length; i++) {
+    const seg = projection.segments[i];
+    const span = weights[i] / totalWeight;
+    const geo = geoIndex.get(seg.sourceKey);
+    const measured = geo?.measured ?? false;
+    result.push({
+      sourceKey: seg.sourceKey,
+      startLine: seg.startLine,
+      endLine: seg.endLine,
+      progressStart: cum,
+      progressEnd: cum + span,
+      top: geo?.top ?? 0,
+      bottom: geo?.bottom ?? 0,
+      height: geo?.height ?? 0,
+      measured
+    });
+    cum += span;
+  }
+  return result;
+}
+function resolveScrollPosition(projection, geometry, viewport, viewportAnchorRatio = DEFAULT_VIEWPORT_ANCHOR_RATIO) {
+  const segments = buildProgressSegments(projection, geometry);
+  if (segments.length === 0) return null;
+  const maxScroll = viewport.scrollHeight - viewport.clientHeight;
+  if (maxScroll <= 0) return null;
+  if (viewport.scrollTop <= 0) {
+    return {
+      documentRevision: projection.documentRevision,
+      projectionRevision: projection.projectionRevision,
+      sourceKey: segments[0].sourceKey,
+      blockProgress: 0
+    };
+  }
+  if (viewport.scrollTop >= maxScroll - BOTTOM_SNAP_THRESHOLD_PX) {
+    const last = segments[segments.length - 1];
+    return {
+      documentRevision: projection.documentRevision,
+      projectionRevision: projection.projectionRevision,
+      sourceKey: last.sourceKey,
+      blockProgress: 1
+    };
+  }
+  const anchorY = viewport.scrollTop + viewport.clientHeight * viewportAnchorRatio;
+  const live = segments.filter((s) => s.measured);
+  if (live.length === 0) return null;
+  for (const seg of live) {
+    if (anchorY >= seg.top && anchorY < seg.bottom) {
+      const local = seg.height > 0 ? clamp01((anchorY - seg.top) / seg.height) : 0;
+      const globalProgress2 = seg.progressStart + local * (seg.progressEnd - seg.progressStart);
+      return positionFromProgress(projection, segments, globalProgress2);
+    }
+  }
+  let before = null;
+  let after = null;
+  for (const seg of live) {
+    if (seg.bottom <= anchorY) before = seg;
+    else if (seg.top > anchorY && !after) {
+      after = seg;
+      break;
+    }
+  }
+  let globalProgress;
+  if (!before && !after) return null;
+  if (!before) {
+    globalProgress = after.top <= 0 ? after.progressStart : clamp01(anchorY / after.top) * after.progressStart;
+  } else if (!after) {
+    const remaining = viewport.scrollHeight - before.bottom;
+    const frac = remaining <= 0 ? 1 : clamp01((anchorY - before.bottom) / remaining);
+    globalProgress = before.progressEnd + frac * (1 - before.progressEnd);
+  } else {
+    const pixelGap = after.top - before.bottom;
+    const frac = pixelGap <= 0 ? 0 : clamp01((anchorY - before.bottom) / pixelGap);
+    globalProgress = before.progressEnd + frac * (after.progressStart - before.progressEnd);
+  }
+  return positionFromProgress(projection, segments, globalProgress);
+}
+function positionFromProgress(projection, segments, globalProgress) {
+  const p = clamp01(globalProgress);
+  for (const seg of segments) {
+    if (p >= seg.progressStart - EPSILON && p <= seg.progressEnd + EPSILON) {
+      const span2 = seg.progressEnd - seg.progressStart;
+      const blockProgress2 = span2 > EPSILON ? clamp01((p - seg.progressStart) / span2) : 0;
+      return {
+        documentRevision: projection.documentRevision,
+        projectionRevision: projection.projectionRevision,
+        sourceKey: seg.sourceKey,
+        blockProgress: blockProgress2
+      };
+    }
+  }
+  let closest = segments[0];
+  let minDist = Infinity;
+  for (const seg of segments) {
+    const mid = (seg.progressStart + seg.progressEnd) / 2;
+    const dist = Math.abs(p - mid);
+    if (dist < minDist) {
+      minDist = dist;
+      closest = seg;
+    }
+  }
+  const span = closest.progressEnd - closest.progressStart;
+  const blockProgress = span > EPSILON ? clamp01((p - closest.progressStart) / span) : 0;
+  return {
+    documentRevision: projection.documentRevision,
+    projectionRevision: projection.projectionRevision,
+    sourceKey: closest.sourceKey,
+    blockProgress
+  };
+}
+function resolveScrollTopFromPosition(position, projection, geometry, viewportHeight, scrollHeight, viewportAnchorRatio = DEFAULT_VIEWPORT_ANCHOR_RATIO) {
+  const maxScroll = scrollHeight - viewportHeight;
+  if (maxScroll <= 0) return null;
+  const segments = buildProgressSegments(projection, geometry);
+  if (segments.length === 0) return null;
+  const targetSeg = segments.find((s) => s.sourceKey === position.sourceKey);
+  if (!targetSeg) return null;
+  const globalProgress = targetSeg.progressStart + clamp01(position.blockProgress) * (targetSeg.progressEnd - targetSeg.progressStart);
+  const p = clamp01(globalProgress);
+  if (p <= 0) return 0;
+  if (p >= 1 - EPSILON) return maxScroll;
+  const live = segments.filter((s) => s.measured);
+  if (live.length === 0) return null;
+  for (const seg of live) {
+    if (p >= seg.progressStart - EPSILON && p <= seg.progressEnd + EPSILON) {
+      const segSpan = seg.progressEnd - seg.progressStart;
+      const local = segSpan > EPSILON ? clamp01((p - seg.progressStart) / segSpan) : 0;
+      const targetY = seg.top + local * seg.height;
+      return clampRange(targetY - viewportHeight * viewportAnchorRatio, 0, maxScroll);
+    }
+  }
+  let before = null;
+  let after = null;
+  for (const seg of live) {
+    if (seg.progressEnd <= p + EPSILON) before = seg;
+    else if (!after) after = seg;
+  }
+  if (before && after) {
+    const progressGap = after.progressStart - before.progressEnd;
+    const frac = progressGap > EPSILON ? clamp01((p - before.progressEnd) / progressGap) : 0;
+    const targetY = before.bottom + frac * (after.top - before.bottom);
+    return clampRange(targetY - viewportHeight * viewportAnchorRatio, 0, maxScroll);
+  }
+  if (before) {
+    return clampRange(before.bottom - viewportHeight * viewportAnchorRatio, 0, maxScroll);
+  }
+  if (after) {
+    const frac = after.progressStart > EPSILON ? clamp01(p / after.progressStart) : 0;
+    const targetY = frac * after.top;
+    return clampRange(targetY - viewportHeight * viewportAnchorRatio, 0, maxScroll);
+  }
+  return null;
+}
+function clamp01(v) {
+  return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+function clampRange(v, min, max) {
+  return v < min ? min : v > max ? max : v;
+}
+
+export {
+  projectToScrollSegments,
+  buildScrollProjectionSnapshot,
+  DEFAULT_VIEWPORT_ANCHOR_RATIO,
+  buildProgressSegments,
+  resolveScrollPosition,
+  resolveScrollTopFromPosition
+};