@eightyfourthousand/lib-editing 2026.4.0 → 2026.4.1

package/src/lib/exporters/glossary-instance.spec.ts

@@ -1,85 +0,0 @@
-import type { Node, Mark } from '@tiptap/pm/model';
-import { glossaryInstance } from './glossary-instance';
-
-describe('glossaryInstance exporter', () => {
-  it('should export glossaryInstance annotation correctly', () => {
-    const node = {
-      textContent: 'Buddha',
-    } as unknown as Node;
-
-    const mark = {
-      attrs: {
-        uuid: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
-        authority: 'f1e2d3c4-5678-90ab-cdef-fedcba098766',
-        glossary: 'f1e2d3c4-5678-90ab-cdef-fedcba098765',
-      },
-    } as unknown as Mark;
-
-    const result = glossaryInstance({
-      node,
-      mark,
-      parent: node,
-      root: node,
-      start: 5,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toEqual({
-      uuid: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
-      authority: 'f1e2d3c4-5678-90ab-cdef-fedcba098766',
-      passageUuid: 'passage-uuid-1234',
-      type: 'glossaryInstance',
-      start: 5,
-      end: 11,
-      glossary: 'f1e2d3c4-5678-90ab-cdef-fedcba098765',
-    });
-  });
-
-  it('should return undefined when textContent is missing', () => {
-    const node = {
-      textContent: '',
-    } as unknown as Node;
-
-    const mark = {
-      attrs: {
-        uuid: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
-        glossary: 'f1e2d3c4-5678-90ab-cdef-fedcba098765',
-        authority: 'f1e2d3c4-5678-90ab-cdef-fedcba098766',
-      },
-    } as unknown as Mark;
-
-    const result = glossaryInstance({
-      node,
-      mark,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toBeUndefined();
-  });
-
-  it('should return undefined when glossary is missing', () => {
-    const node = {
-      textContent: 'Buddha',
-    } as unknown as Node;
-
-    const mark = {
-      attrs: {
-        uuid: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
-      },
-    } as unknown as Mark;
-
-    const result = glossaryInstance({
-      node,
-      mark,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toBeUndefined();
-  });
-});

package/src/lib/exporters/glossary-instance.ts

@@ -1,31 +0,0 @@
-import { GlossaryInstanceAnnotation } from '@eightyfourthousand/data-access';
-import { Exporter } from './export';
-
-export const glossaryInstance: Exporter<GlossaryInstanceAnnotation> = ({
-  mark,
-  node,
-  start,
-  passageUuid,
-}): GlossaryInstanceAnnotation | undefined => {
-  const textContent = node.textContent;
-  const authority = mark?.attrs.authority;
-  const glossary = mark?.attrs.glossary;
-  const uuid = mark?.attrs.uuid;
-
-  if (!textContent || !glossary || !authority || !uuid) {
-    console.warn(
-      `Glossary instance ${uuid} on pasage ${passageUuid} is incomplete`,
-    );
-    return undefined;
-  }
-
-  return {
-    uuid,
-    type: 'glossaryInstance',
-    passageUuid,
-    start,
-    end: start + textContent.length,
-    authority,
-    glossary,
-  };
-};

package/src/lib/exporters/has-abbreviation.spec.ts

@@ -1,31 +0,0 @@
-import type { Node } from '@tiptap/pm/model';
-import { hasAbbreviation } from './has-abbreviation';
-
-describe('hasAbbreviation exporter', () => {
-  it('should export hasAbbreviation annotation correctly', () => {
-    const node = {
-      attrs: {
-        uuid: 'has-abbr-uuid-1234',
-        abbreviation: 'abbr-ref-uuid-5678',
-      },
-      textContent: 'Toh',
-    } as unknown as Node;
-
-    const result = hasAbbreviation({
-      node,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toEqual({
-      uuid: 'has-abbr-uuid-1234',
-      passageUuid: 'passage-uuid-1234',
-      type: 'hasAbbreviation',
-      start: 0,
-      end: 3,
-      abbreviation: 'abbr-ref-uuid-5678',
-    });
-  });
-});

package/src/lib/exporters/has-abbreviation.ts

@@ -1,21 +0,0 @@
-import { HasAbbreviationAnnotation } from '@eightyfourthousand/data-access';
-import { Exporter } from './export';
-
-export const hasAbbreviation: Exporter<HasAbbreviationAnnotation> = ({
-  node,
-  start,
-  passageUuid,
-}): HasAbbreviationAnnotation => {
-  const textContent = node.textContent;
-  const abbreviation = node.attrs.abbreviation;
-  const uuid = node.attrs.uuid;
-
-  return {
-    uuid,
-    type: 'hasAbbreviation',
-    passageUuid,
-    start,
-    end: start + textContent.length,
-    abbreviation,
-  };
-};

package/src/lib/exporters/heading.spec.ts

@@ -1,80 +0,0 @@
-import type { Node } from '@tiptap/pm/model';
-import { heading } from './heading';
-
-describe('heading exporter', () => {
-  it('should export heading annotation correctly', () => {
-    const node = {
-      attrs: {
-        uuid: 'heading-uuid-1234',
-        level: 2,
-        class: 'chapter-title',
-      },
-      textContent: 'Chapter Title',
-    } as unknown as Node;
-
-    const result = heading({
-      node,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toEqual({
-      uuid: 'heading-uuid-1234',
-      passageUuid: 'passage-uuid-1234',
-      type: 'heading',
-      start: 0,
-      end: 13,
-      level: 2,
-      class: 'chapter-title',
-    });
-  });
-
-  it('should default to level 1 when level is missing', () => {
-    const node = {
-      attrs: {
-        uuid: 'heading-uuid-5678',
-      },
-      textContent: 'Default Heading',
-    } as unknown as Node;
-
-    const result = heading({
-      node,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toEqual({
-      uuid: 'heading-uuid-5678',
-      passageUuid: 'passage-uuid-1234',
-      type: 'heading',
-      start: 0,
-      end: 15,
-      level: 1,
-      class: undefined,
-    });
-  });
-
-  it('should return undefined when textContent is missing', () => {
-    const node = {
-      attrs: {
-        uuid: 'heading-uuid-empty',
-        level: 1,
-      },
-      textContent: '',
-    } as unknown as Node;
-
-    const result = heading({
-      node,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toBeUndefined();
-  });
-});

package/src/lib/exporters/heading.ts

@@ -1,28 +0,0 @@
-import { HeadingAnnotation } from '@eightyfourthousand/data-access';
-import { Exporter } from './export';
-
-export const heading: Exporter<HeadingAnnotation> = ({
-  node,
-  start,
-  passageUuid,
-}): HeadingAnnotation | undefined => {
-  const textContent = node.textContent;
-  const uuid = node.attrs.uuid;
-  const level = (node.attrs.level as number) || 1;
-  const cls = node.attrs.class;
-
-  if (!textContent) {
-    console.warn(`Heading node ${uuid} is incomplete`);
-    return undefined;
-  }
-
-  return {
-    uuid,
-    type: 'heading',
-    passageUuid,
-    start,
-    end: start + textContent.length,
-    level,
-    class: cls,
-  };
-};

package/src/lib/exporters/image.spec.ts

@@ -1,48 +0,0 @@
-import type { Node } from '@tiptap/pm/model';
-import { image } from './image';
-
-describe('image exporter', () => {
-  it('should export image annotation correctly', () => {
-    const node = {
-      attrs: {
-        uuid: 'image-uuid-1234',
-        src: '/images/thangka.jpg',
-      },
-    } as unknown as Node;
-
-    const result = image({
-      node,
-      parent: node,
-      root: node,
-      start: 100,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toEqual({
-      uuid: 'image-uuid-1234',
-      passageUuid: 'passage-uuid-1234',
-      type: 'image',
-      start: 100,
-      end: 100,
-      src: '/images/thangka.jpg',
-    });
-  });
-
-  it('should return undefined when src is missing', () => {
-    const node = {
-      attrs: {
-        uuid: 'image-uuid-nosrc',
-      },
-    } as unknown as Node;
-
-    const result = image({
-      node,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toBeUndefined();
-  });
-});

package/src/lib/exporters/image.ts

@@ -1,25 +0,0 @@
-import { ImageAnnotation } from '@eightyfourthousand/data-access';
-import { Exporter } from './export';
-
-export const image: Exporter<ImageAnnotation> = ({
-  node,
-  start,
-  passageUuid,
-}): ImageAnnotation | undefined => {
-  const src = node.attrs.src;
-  const uuid = node.attrs.uuid;
-
-  if (!src) {
-    console.warn(`Image node ${uuid} is missing src attribute`);
-    return undefined;
-  }
-
-  return {
-    uuid,
-    type: 'image',
-    passageUuid,
-    start,
-    end: start,
-    src,
-  };
-};

package/src/lib/exporters/indent.spec.ts

@@ -1,58 +0,0 @@
-import type { Node } from '@tiptap/pm/model';
-import { indent } from './indent';
-
-describe('indent exporter', () => {
-  it('should export indent annotation correctly', () => {
-    const node = {
-      attrs: {
-        indentUuid: 'indent-uuid-1234',
-      },
-      textContent: 'Indented text',
-    } as unknown as Node;
-
-    const result = indent({
-      node,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toEqual({
-      uuid: 'indent-uuid-1234',
-      passageUuid: 'passage-uuid-1234',
-      type: 'indent',
-      start: 0,
-      end: 13,
-    });
-  });
-
-  it('should use parent textContent when node textContent is missing', () => {
-    const parent = {
-      textContent: 'Parent text',
-    } as unknown as Node;
-
-    const node = {
-      attrs: {
-        indentUuid: 'indent-uuid-5678',
-      },
-      textContent: '',
-    } as unknown as Node;
-
-    const result = indent({
-      node,
-      parent,
-      root: parent,
-      start: 5,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toEqual({
-      uuid: 'indent-uuid-5678',
-      passageUuid: 'passage-uuid-1234',
-      type: 'indent',
-      start: 5,
-      end: 16,
-    });
-  });
-});

package/src/lib/exporters/indent.ts

@@ -1,18 +0,0 @@
-import { IndentAnnotation } from '@eightyfourthousand/data-access';
-import { Exporter } from './export';
-
-export const indent: Exporter<IndentAnnotation> = ({
-  node,
-  parent,
-  start,
-  passageUuid,
-}): IndentAnnotation => {
-  const textContent = node.textContent || parent.textContent || '';
-  return {
-    uuid: node.attrs.indentUuid,
-    type: 'indent',
-    passageUuid,
-    start,
-    end: start + textContent.length,
-  };
-};

package/src/lib/exporters/internal-link.spec.ts

@@ -1,90 +0,0 @@
-import type { Node, Mark } from '@tiptap/pm/model';
-import { internalLink } from './internal-link';
-
-describe('internalLink exporter', () => {
-  it('should export internalLink annotation correctly', () => {
-    const node = {
-      textContent: 'internal link',
-    } as unknown as Node;
-
-    const mark = {
-      attrs: {
-        uuid: 'internal-link-uuid-1234',
-        type: 'passage',
-        entity: 'entity-uuid-5678',
-        href: '/passage/entity-uuid-5678',
-        isPending: false,
-      },
-    } as unknown as Mark;
-
-    const result = internalLink({
-      node,
-      mark,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toEqual({
-      uuid: 'internal-link-uuid-1234',
-      passageUuid: 'passage-uuid-1234',
-      type: 'internalLink',
-      linkType: 'passage',
-      entity: 'entity-uuid-5678',
-      href: '/passage/entity-uuid-5678',
-      isPending: false,
-      start: 0,
-      end: 13,
-    });
-  });
-
-  it('should return undefined when textContent is missing', () => {
-    const node = {
-      textContent: '',
-    } as unknown as Node;
-
-    const mark = {
-      attrs: {
-        uuid: 'internal-link-uuid-empty',
-        type: 'passage',
-        entity: 'entity-uuid-5678',
-      },
-    } as unknown as Mark;
-
-    const result = internalLink({
-      node,
-      mark,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toBeUndefined();
-  });
-
-  it('should return undefined when entity is missing', () => {
-    const node = {
-      textContent: 'internal link',
-    } as unknown as Node;
-
-    const mark = {
-      attrs: {
-        uuid: 'internal-link-uuid-noentity',
-        type: 'passage',
-      },
-    } as unknown as Mark;
-
-    const result = internalLink({
-      node,
-      mark,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toBeUndefined();
-  });
-});

package/src/lib/exporters/internal-link.ts

@@ -1,35 +0,0 @@
-import { InternalLinkAnnotation } from '@eightyfourthousand/data-access';
-import { Exporter } from './export';
-
-export const internalLink: Exporter<InternalLinkAnnotation> = ({
-  mark,
-  node,
-  start,
-  passageUuid,
-}): InternalLinkAnnotation | undefined => {
-  const textContent = node.textContent;
-  const linkType = mark?.attrs.type;
-  const entity = mark?.attrs.entity;
-  const uuid = mark?.attrs.uuid;
-  const href = mark?.attrs.href;
-  const isPending = mark?.attrs.isPending;
-
-  if (!textContent || !entity || !linkType || !uuid) {
-    console.warn(
-      `Internal link ${uuid} on pasage ${passageUuid} is incomplete`,
-    );
-    return undefined;
-  }
-
-  return {
-    uuid,
-    type: 'internalLink',
-    passageUuid,
-    linkType,
-    entity,
-    href,
-    isPending,
-    start,
-    end: start + textContent.length,
-  };
-};

package/src/lib/exporters/italic.spec.ts

@@ -1,84 +0,0 @@
-import type { Node, Mark } from '@tiptap/pm/model';
-import { italic } from './italic';
-
-describe('italic exporter', () => {
-  it('should export inlineTitle annotation correctly', () => {
-    const node = {
-      textContent: 'Inline Title',
-    } as unknown as Node;
-
-    const mark = {
-      attrs: {
-        uuid: 'italic-uuid-1234',
-        type: 'inlineTitle',
-        lang: 'en',
-      },
-    } as unknown as Mark;
-
-    const result = italic({
-      node,
-      mark,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toEqual({
-      uuid: 'italic-uuid-1234',
-      passageUuid: 'passage-uuid-1234',
-      type: 'inlineTitle',
-      start: 0,
-      end: 12,
-      lang: 'en',
-    });
-  });
-
-  it('should export span annotation with emphasis by default', () => {
-    const node = {
-      textContent: 'emphasized text',
-    } as unknown as Node;
-
-    const mark = {
-      attrs: {
-        uuid: 'italic-uuid-5678',
-        type: 'span',
-      },
-    } as unknown as Mark;
-
-    const result = italic({
-      node,
-      mark,
-      parent: node,
-      root: node,
-      start: 5,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toEqual({
-      uuid: 'italic-uuid-5678',
-      passageUuid: 'passage-uuid-1234',
-      type: 'span',
-      start: 5,
-      end: 20,
-      textStyle: 'emphasis',
-    });
-  });
-
-  it('should return undefined when mark is missing', () => {
-    const node = {
-      textContent: 'text',
-    } as unknown as Node;
-
-    const result = italic({
-      node,
-      mark: undefined,
-      parent: node,
-      root: node,
-      start: 0,
-      passageUuid: 'passage-uuid-1234',
-    });
-
-    expect(result).toBeUndefined();
-  });
-});

package/src/lib/exporters/italic.ts

@@ -1,55 +0,0 @@
-import { Exporter, ExporterContext } from './export';
-import {
-  AnnotationType,
-  ExtendedTranslationLanguage,
-  InlineTitleAnnotation,
-  MantraAnnotation,
-  SpanAnnotation,
-} from '@eightyfourthousand/data-access';
-
-export const italic: Exporter<
-  InlineTitleAnnotation | MantraAnnotation | SpanAnnotation
-> = ({
-  mark,
-  node,
-  parent,
-  start,
-  passageUuid,
-}: ExporterContext):
-  | InlineTitleAnnotation
-  | MantraAnnotation
-  | SpanAnnotation
-  | undefined => {
-  if (!mark) {
-    console.warn('Italic exporter called without mark');
-    return undefined;
-  }
-
-  const uuid = mark?.attrs.uuid;
-  const type = mark?.attrs.type as AnnotationType;
-  const textContent = node.textContent || parent.textContent || '';
-  const textStyle = (mark?.attrs.textStyle as string) || 'emphasis';
-  const lang = mark?.attrs.lang as ExtendedTranslationLanguage;
-  const end = start + textContent.length;
-
-  switch (type) {
-    case 'inlineTitle':
-      return {
-        uuid,
-        type: 'inlineTitle',
-        passageUuid,
-        start,
-        end,
-        lang,
-      } as InlineTitleAnnotation;
-    default:
-      return {
-        uuid,
-        type: 'span',
-        passageUuid,
-        start,
-        end,
-        textStyle,
-      } as SpanAnnotation;
-  }
-};