@owomark/core 0.1.5 → 0.1.7

package/dist/chunk-OOH46GIF.js

@@ -0,0 +1,95 @@
+// src/semantic/shared/registry.ts
+function deepFreezeValue(value) {
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      deepFreezeValue(item);
+    }
+    return Object.freeze(value);
+  }
+  if (value && typeof value === "object") {
+    for (const nestedValue of Object.values(value)) {
+      deepFreezeValue(nestedValue);
+    }
+    return Object.freeze(value);
+  }
+  return value;
+}
+function freezeDescriptor(descriptor) {
+  return deepFreezeValue(descriptor);
+}
+function createDescriptorRegistry(descriptors, familyName) {
+  const frozen = descriptors.map((descriptor) => freezeDescriptor({ ...descriptor }));
+  const index = /* @__PURE__ */ new Map();
+  for (const descriptor of frozen) {
+    if (index.has(descriptor.key)) {
+      throw new Error(`[owomark/semantic] duplicate ${familyName} descriptor key "${descriptor.key}"`);
+    }
+    index.set(descriptor.key, descriptor);
+  }
+  return {
+    list() {
+      return frozen;
+    },
+    get(key) {
+      return index.get(key);
+    }
+  };
+}
+function requireDescriptor(registry, key, familyName) {
+  const descriptor = registry.get(key);
+  if (!descriptor) {
+    throw new Error(`[owomark/semantic] unknown ${familyName} descriptor "${key}"`);
+  }
+  return descriptor;
+}
+
+// src/semantic/shared/validation.ts
+function assertSpecIds(specIds, family, key) {
+  if (specIds.length === 0) {
+    throw new Error(`[owomark/semantic] ${family} descriptor "${key}" must declare at least one specId`);
+  }
+}
+function validateSyntaxDescriptors(descriptors) {
+  for (const descriptor of descriptors) {
+    assertSpecIds(descriptor.specIds, "syntax", descriptor.key);
+  }
+}
+function validateComponentDescriptors(descriptors) {
+  const directiveNames = /* @__PURE__ */ new Set();
+  for (const descriptor of descriptors) {
+    assertSpecIds(descriptor.specIds, "component", descriptor.key);
+    if (directiveNames.has(descriptor.directiveName)) {
+      throw new Error(`[owomark/semantic] duplicate component directive "${descriptor.directiveName}"`);
+    }
+    directiveNames.add(descriptor.directiveName);
+  }
+}
+function validateRuntimeDescriptors(descriptors) {
+  const blockTypes = /* @__PURE__ */ new Set();
+  for (const descriptor of descriptors) {
+    assertSpecIds(descriptor.specIds, "runtime", descriptor.key);
+    if (blockTypes.has(descriptor.blockType)) {
+      throw new Error(`[owomark/semantic] duplicate runtime block type "${descriptor.blockType}"`);
+    }
+    blockTypes.add(descriptor.blockType);
+  }
+}
+function validateEditorEntryDescriptors(descriptors) {
+  const commandIds = /* @__PURE__ */ new Set();
+  for (const descriptor of descriptors) {
+    assertSpecIds(descriptor.specIds, "editor", descriptor.key);
+    if (commandIds.has(descriptor.commandId)) {
+      throw new Error(`[owomark/semantic] duplicate editor command id "${descriptor.commandId}"`);
+    }
+    commandIds.add(descriptor.commandId);
+  }
+}
+
+export {
+  createDescriptorRegistry,
+  requireDescriptor,
+  validateSyntaxDescriptors,
+  validateComponentDescriptors,
+  validateRuntimeDescriptors,
+  validateEditorEntryDescriptors
+};

package/dist/chunk-ROJILHRQ.js

@@ -0,0 +1,192 @@
+import {
+  createDescriptorRegistry,
+  requireDescriptor,
+  validateRuntimeDescriptors
+} from "./chunk-OOH46GIF.js";
+
+// src/semantic/runtime/index.ts
+var builtinRuntimeBlockDescriptors = [
+  {
+    key: "builtin.runtime.paragraph",
+    family: "runtime",
+    blockType: "paragraph",
+    previewKind: "paragraph",
+    projectionStrategy: "plain",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  },
+  {
+    key: "builtin.runtime.heading",
+    family: "runtime",
+    blockType: "heading",
+    previewKind: "heading",
+    projectionStrategy: "plain",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  },
+  {
+    key: "builtin.runtime.unordered-list",
+    family: "runtime",
+    blockType: "unordered-list",
+    previewKind: "unordered-list",
+    projectionStrategy: "group-adjacent",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  },
+  {
+    key: "builtin.runtime.ordered-list",
+    family: "runtime",
+    blockType: "ordered-list",
+    previewKind: "ordered-list",
+    projectionStrategy: "group-adjacent",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  },
+  {
+    key: "builtin.runtime.blockquote",
+    family: "runtime",
+    blockType: "blockquote",
+    previewKind: "blockquote",
+    projectionStrategy: "group-adjacent",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  },
+  {
+    key: "builtin.runtime.code-fence",
+    family: "runtime",
+    blockType: "code-fence",
+    previewKind: "code-fence",
+    projectionStrategy: "plain",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  },
+  {
+    key: "builtin.runtime.thematic-break",
+    family: "runtime",
+    blockType: "thematic-break",
+    previewKind: "thematic-break",
+    projectionStrategy: "plain",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  },
+  {
+    key: "builtin.runtime.table",
+    family: "runtime",
+    blockType: "table",
+    previewKind: "table",
+    projectionStrategy: "plain",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  },
+  {
+    key: "builtin.runtime.math-block",
+    family: "runtime",
+    blockType: "math-block",
+    previewKind: "math-block",
+    projectionStrategy: "plain",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "deferred",
+    heavy: true,
+    specIds: ["docs/specs/owomark-preview.md", "docs/specs/owomark-math.md"],
+    featureFlag: "enableMath"
+  },
+  {
+    key: "builtin.runtime.html-block",
+    family: "runtime",
+    blockType: "html-block",
+    previewKind: "html-block",
+    projectionStrategy: "plain",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  },
+  {
+    key: "builtin.runtime.side-annotation",
+    family: "runtime",
+    blockType: "side-annotation",
+    previewKind: "custom",
+    customBlockKey: "side-annotation",
+    projectionStrategy: "custom-grouped",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    workerRendererId: "builtin:side-annotation",
+    sharedStateDirtyReason: "custom-block-change",
+    specIds: ["docs/specs/owomark-preview.md", "docs/specs/owomark-side-annotation.md"],
+    featureFlag: "enableSideAnnotation"
+  },
+  {
+    key: "builtin.runtime.side-note-definition",
+    family: "runtime",
+    blockType: "side-note-definition",
+    previewKind: "custom",
+    customBlockKey: "side-annotation",
+    projectionStrategy: "custom-single",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    workerRendererId: "builtin:side-annotation",
+    sharedStateDirtyReason: "custom-block-change",
+    specIds: ["docs/specs/owomark-preview.md", "docs/specs/owomark-side-annotation.md"],
+    featureFlag: "enableSideAnnotation"
+  },
+  {
+    key: "builtin.runtime.directive-container",
+    family: "runtime",
+    blockType: "directive-container",
+    previewKind: "custom",
+    customBlockKey: "directive-container",
+    projectionStrategy: "custom-single",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  },
+  {
+    key: "builtin.runtime.custom-block",
+    family: "runtime",
+    blockType: "custom-block",
+    previewKind: "custom",
+    customBlockKey: "custom-block",
+    projectionStrategy: "custom-single",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    processorFallback: "render-raw",
+    sharedStateDirtyReason: "custom-block-change",
+    specIds: ["docs/specs/owomark-preview-api.md"]
+  },
+  {
+    key: "builtin.runtime.reference-definition",
+    family: "runtime",
+    blockType: "reference-definition",
+    previewKind: "custom",
+    customBlockKey: "reference-definition",
+    projectionStrategy: "custom-single",
+    rendererMode: "html-worker-safe",
+    rendererPriority: "realtime",
+    specIds: ["docs/specs/owomark-preview.md"]
+  }
+];
+validateRuntimeDescriptors(builtinRuntimeBlockDescriptors);
+var runtimeBlockRegistry = createDescriptorRegistry(builtinRuntimeBlockDescriptors, "runtime");
+function getRuntimeBlockDescriptor(key) {
+  return requireDescriptor(runtimeBlockRegistry, key, "runtime");
+}
+function getRuntimeBlockDescriptorByBlockType(blockType) {
+  return runtimeBlockRegistry.list().find((descriptor) => descriptor.blockType === blockType);
+}
+function getRuntimeBlockDescriptorByPreviewKind(previewKind) {
+  return runtimeBlockRegistry.list().find((descriptor) => descriptor.previewKind === previewKind);
+}
+
+export {
+  runtimeBlockRegistry,
+  getRuntimeBlockDescriptor,
+  getRuntimeBlockDescriptorByBlockType,
+  getRuntimeBlockDescriptorByPreviewKind
+};

package/dist/chunk-WFPUIPWU.js

@@ -0,0 +1,34 @@
+// src/model/dirty-range.ts
+function expandDirtyRange(current, blockIndex, totalBlocks) {
+  if (totalBlocks <= 0) return current;
+  const clamped = Math.max(0, Math.min(blockIndex, totalBlocks - 1));
+  if (!current) {
+    return { startBlock: clamped, endBlock: clamped };
+  }
+  return {
+    startBlock: Math.min(current.startBlock, clamped),
+    endBlock: Math.max(current.endBlock, clamped)
+  };
+}
+function expandWithContext(range, totalBlocks, context = 1) {
+  if (totalBlocks <= 0) return null;
+  return {
+    startBlock: Math.max(0, range.startBlock - context),
+    endBlock: Math.min(totalBlocks - 1, range.endBlock + context)
+  };
+}
+
+// src/preview/block-id.ts
+function deriveBlockId(renderKey, occurrenceIndex) {
+  return `${renderKey}#${occurrenceIndex}`;
+}
+function deriveSourceKey(startLine, endLine) {
+  return `L${startLine}-${endLine}`;
+}
+
+export {
+  expandDirtyRange,
+  expandWithContext,
+  deriveBlockId,
+  deriveSourceKey
+};

package/dist/chunk-WXVKSKP3.js

@@ -0,0 +1,191 @@
+import {
+  createDescriptorRegistry,
+  requireDescriptor,
+  validateComponentDescriptors
+} from "./chunk-OOH46GIF.js";
+
+// src/semantic/components/index.ts
+var builtinComponentDescriptors = [
+  {
+    key: "builtin.component.note",
+    family: "component",
+    directiveName: "note",
+    componentName: "Note",
+    componentKind: "block-container",
+    allowedAttrs: ["title"],
+    requiredAttrs: [],
+    requiredParent: null,
+    allowedChildDirectives: [],
+    payloadStrategy: "none",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.callout",
+    family: "component",
+    directiveName: "callout",
+    componentName: "Callout",
+    componentKind: "block-container",
+    allowedAttrs: ["type"],
+    requiredAttrs: [],
+    requiredParent: null,
+    allowedChildDirectives: [],
+    payloadStrategy: "none",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.code-demo",
+    family: "component",
+    directiveName: "code-demo",
+    componentName: "CodeDemo",
+    componentKind: "block-container",
+    allowedAttrs: ["title", "language"],
+    requiredAttrs: [],
+    requiredParent: null,
+    allowedChildDirectives: ["code-tab"],
+    payloadStrategy: "code-tabs",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.code-tab",
+    family: "component",
+    directiveName: "code-tab",
+    componentName: "CodeTab",
+    componentKind: "block-child",
+    allowedAttrs: ["label", "language"],
+    requiredAttrs: ["label"],
+    requiredParent: "code-demo",
+    allowedChildDirectives: [],
+    payloadStrategy: "single-code-block",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.details",
+    family: "component",
+    directiveName: "details",
+    componentName: "Details",
+    componentKind: "block-container",
+    allowedAttrs: ["summary", "open"],
+    requiredAttrs: ["summary"],
+    requiredParent: null,
+    allowedChildDirectives: [],
+    payloadStrategy: "none",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.link-card",
+    family: "component",
+    directiveName: "link-card",
+    componentName: "LinkCard",
+    componentKind: "block-container",
+    allowedAttrs: ["href", "title", "description", "domain"],
+    requiredAttrs: ["href", "title"],
+    requiredParent: null,
+    allowedChildDirectives: [],
+    payloadStrategy: "optional-summary",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.steps",
+    family: "component",
+    directiveName: "steps",
+    componentName: "Steps",
+    componentKind: "block-parent",
+    allowedAttrs: [],
+    requiredAttrs: [],
+    requiredParent: null,
+    allowedChildDirectives: ["step"],
+    payloadStrategy: "none",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.step",
+    family: "component",
+    directiveName: "step",
+    componentName: "Step",
+    componentKind: "block-child",
+    allowedAttrs: ["title"],
+    requiredAttrs: [],
+    requiredParent: "steps",
+    allowedChildDirectives: [],
+    payloadStrategy: "none",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.tabs",
+    family: "component",
+    directiveName: "tabs",
+    componentName: "Tabs",
+    componentKind: "block-parent",
+    allowedAttrs: [],
+    requiredAttrs: [],
+    requiredParent: null,
+    allowedChildDirectives: ["tab"],
+    payloadStrategy: "none",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.tab",
+    family: "component",
+    directiveName: "tab",
+    componentName: "Tab",
+    componentKind: "block-child",
+    allowedAttrs: ["label"],
+    requiredAttrs: [],
+    requiredParent: "tabs",
+    allowedChildDirectives: [],
+    payloadStrategy: "none",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.file-tree",
+    family: "component",
+    directiveName: "file-tree",
+    componentName: "FileTree",
+    componentKind: "block-container",
+    allowedAttrs: [],
+    requiredAttrs: [],
+    requiredParent: null,
+    allowedChildDirectives: [],
+    payloadStrategy: "single-code-block",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  },
+  {
+    key: "builtin.component.kbd",
+    family: "component",
+    directiveName: "kbd",
+    componentName: "Kbd",
+    componentKind: "inline-text",
+    allowedAttrs: [],
+    requiredAttrs: [],
+    requiredParent: null,
+    allowedChildDirectives: [],
+    payloadStrategy: "inline-text",
+    specIds: ["docs/specs/owomark-components-extension.md"],
+    featureFlag: "enableComponents"
+  }
+];
+validateComponentDescriptors(builtinComponentDescriptors);
+var componentRegistry = createDescriptorRegistry(builtinComponentDescriptors, "component");
+function getComponentDescriptor(key) {
+  return requireDescriptor(componentRegistry, key, "component");
+}
+function getComponentDescriptorByDirective(directiveName) {
+  return componentRegistry.list().find((descriptor) => descriptor.directiveName === directiveName);
+}
+
+export {
+  componentRegistry,
+  getComponentDescriptor,
+  getComponentDescriptorByDirective
+};