@abraca/convert 2.3.0

package/src/index.ts

@@ -0,0 +1,103 @@
+// @abraca/convert — Bullet-proof Markdown ↔ Yjs/TipTap round-trip.
+//
+// One canonical source for converting between Markdown text (with MDC
+// extensions covering every TipTap node/mark) and Yjs XmlFragments that
+// match the cou-sh / abracadabra-nuxt / @abraca/mcp prose schema.
+//
+// Consumers (cou-sh, abracadabra-nuxt, @abraca/mcp) import these
+// functions instead of maintaining their own copies. The full wire
+// spec is in SPEC.md.
+
+export {
+  filenameToLabel,
+  parseFrontmatter,
+  populateYDocFromMarkdown,
+  type FrontmatterResult,
+} from './markdown-to-yjs.ts'
+
+export { yjsToMarkdown, yjsToHtml, yjsToPlainText } from './yjs-to-markdown.ts'
+
+export {
+  populateYDocFromHtml,
+  appendHtmlToFragment,
+} from './html-to-yjs.ts'
+
+export type { DocPageMeta } from './types.ts'
+
+// Structural Y.XmlFragment ↔ JSON converter + diff. Used by the
+// integration test suite and available to consumers who want to
+// author golden fixtures or do their own assertions.
+export {
+  yfragmentToJson,
+  jsonToYFragment,
+  diffYjs,
+  diffJson,
+  stringifyJsonNode,
+  type YjsJsonNode,
+  type YjsJsonElement,
+  type YjsJsonText,
+  type YjsTextRun,
+  type YjsDiff,
+  type JsonAttr,
+} from './diff.ts'
+
+// Wire-format spec registries — see SPEC.md for the human-readable
+// version. The registries are the executable source of truth.
+export {
+  NODE_SPECS,
+  NODE_SPEC_BY_NAME,
+  mdcTagOf,
+  type NodeSpec,
+  type NodeAttrSpec,
+  type NodeWireKind,
+  MARK_SPECS,
+  MARK_SPEC_BY_NAME,
+  MARK_SPEC_BY_DELIM,
+  type MarkSpec,
+  type MarkAttrSpec,
+  type MarkWireKind,
+  UNIVERSAL_META_KEYS,
+  UNIVERSAL_META_KEY_NAMES,
+  buildAliasMap,
+  type UniversalMetaKey,
+  type MetaValueType,
+} from './spec/index.ts'
+
+// File-block sidecar utilities (FS-sync). These have a soft runtime
+// dependency on `@tauri-apps/plugin-fs` (loaded via dynamic import).
+// Consumers that don't ship Tauri can use the pure helpers (path
+// resolution, manifest mutation) without the FS-bound load/save.
+export {
+  manifestDir,
+  trashDir,
+  orphansDir,
+  conflictsDir,
+  createEmptyManifest,
+  loadManifest,
+  saveManifest,
+  lookupByDocId,
+  lookupByPath,
+  lookupByHash,
+  setEntry,
+  removeEntry,
+  buildReverseLookup,
+  setFsAdapter,
+  getFsAdapter,
+  type FsAdapter,
+  type UploadManifestEntry,
+  type ManifestEntry,
+  type FsSyncManifest,
+} from './file-blocks/manifest.ts'
+
+export {
+  labelToFilename,
+  fsFilenameToLabel,
+  hasChildren,
+  buildRelativePath,
+  getDocDir,
+  resolveParentFromPath,
+  simpleHash,
+  getTreeData,
+  nextOrder,
+  type FsTreeEntry,
+} from './file-blocks/paths.ts'