@semiont/react-ui 0.5.3 → 0.5.4

package/dist/lib/annotation-registry.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Centralized annotation type registry
+ *
+ * Single source of truth for W3C annotation motivation metadata including:
+ * - Visual styling (CSS classes)
+ * - Behavior flags (clickable, hover, side panel)
+ * - Type guards (motivation matching)
+ * - Accessibility (screen reader announcements)
+ * - Runtime handlers (click, hover, detect, update, create)
+ *
+ * Per CLAUDE.md: This is the ONLY place to define annotation type metadata.
+ * No aliasing, wrappers, or compatibility layers elsewhere.
+ */
+import type { components } from '@semiont/core';
+import type { Annotation } from '@semiont/core';
+type Motivation = components['schemas']['Motivation'];
+/**
+ * Detection configuration for SSE-based annotation detection
+ */
+export interface DetectionConfig {
+    sseMethod: 'detectReferences' | 'detectHighlights' | 'detectAssessments' | 'detectComments' | 'detectTags';
+    countField: 'foundCount' | 'createdCount' | 'tagsCreated';
+    displayNamePlural: string;
+    displayNameSingular: string;
+    formatRequestParams?: (args: unknown[]) => Array<{
+        label: string;
+        value: string;
+    }>;
+}
+/**
+ * Creation configuration - describes how to create annotations of this type
+ */
+export interface CreateConfig {
+    bodyBuilder: 'empty' | 'text' | 'entityTag' | 'dualTag';
+    refetchAfter: boolean;
+    successMessage?: string;
+}
+/**
+ * Annotator: Encapsulates all motivation-specific behavior
+ * Handles clicks, hovers, detection, and other operations for one annotation type
+ */
+export interface Annotator {
+    motivation: Motivation;
+    internalType: string;
+    displayName: string;
+    description: string;
+    className: string;
+    iconEmoji?: string;
+    isClickable: boolean;
+    hasHoverInteraction: boolean;
+    hasSidePanel: boolean;
+    matchesAnnotation: (annotation: Annotation) => boolean;
+    announceOnCreate: string;
+    detection?: DetectionConfig;
+    create: CreateConfig;
+}
+/**
+ * Static annotator definitions - single source of truth
+ */
+export declare const ANNOTATORS: Record<string, Annotator>;
+export {};
+//# sourceMappingURL=annotation-registry.d.ts.map

package/dist/lib/annotation-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-registry.d.ts","sourceRoot":"","sources":["../../src/lib/annotation-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,KAAK,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAE9B,SAAS,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,YAAY,CAAC;IAG3G,UAAU,EAAE,YAAY,GAAG,cAAc,GAAG,aAAa,CAAC;IAG1D,iBAAiB,EAAE,MAAM,CAAC;IAG1B,mBAAmB,EAAE,MAAM,CAAC;IAI5B,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpF;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAE3B,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAGxD,YAAY,EAAE,OAAO,CAAC;IAGtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IAExB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IAGpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IAGtB,iBAAiB,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC;IAGvD,gBAAgB,EAAE,MAAM,CAAC;IAGzB,SAAS,CAAC,EAAE,eAAe,CAAC;IAG5B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAoKhD,CAAC"}

package/dist/lib/browser-pdfjs.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Browser PDF.js utilities
+ *
+ * Uses native browser PDF.js when available, falls back to CDN.
+ * Zero npm dependencies - no webpack bundling issues.
+ */
+export interface PDFDocumentProxy {
+    numPages: number;
+    getPage(pageNumber: number): Promise<PDFPageProxy>;
+}
+export interface PDFPageProxy {
+    getViewport(params: {
+        scale: number;
+        rotation?: number;
+    }): PDFViewport;
+    render(params: PDFRenderParams): PDFRenderTask;
+    getTextContent(): Promise<TextContent>;
+}
+export interface PDFViewport {
+    width: number;
+    height: number;
+    scale: number;
+    rotation: number;
+}
+export interface PDFRenderParams {
+    canvasContext: CanvasRenderingContext2D;
+    viewport: PDFViewport;
+}
+export interface PDFRenderTask {
+    promise: Promise<void>;
+    cancel(): void;
+}
+export interface PDFLib {
+    getDocument(params: {
+        url: string;
+    }): PDFLoadingTask;
+    GlobalWorkerOptions: {
+        workerSrc: string;
+    };
+    version: string;
+}
+export interface PDFLoadingTask {
+    promise: Promise<PDFDocumentProxy>;
+    destroy(): void;
+}
+/**
+ * Text content types (for Phase 2)
+ */
+export interface TextItem {
+    str: string;
+    dir: string;
+    transform: number[];
+    width: number;
+    height: number;
+    fontName: string;
+    hasEOL: boolean;
+}
+export interface TextContent {
+    items: TextItem[];
+    styles: Record<string, any>;
+}
+/**
+ * Ensure PDF.js is available, loading from local public folder if needed
+ */
+export declare function ensurePdfJs(): Promise<PDFLib>;
+/**
+ * Load PDF document from a URL.
+ *
+ * The URL must include authentication (e.g. ?token=<media-token>).
+ * PDF.js streams the document directly — no ArrayBuffer buffering in JS.
+ */
+export declare function loadPdfDocument(url: string): Promise<PDFDocumentProxy>;
+/**
+ * Render PDF page to canvas and return as data URL
+ */
+export declare function renderPdfPageToDataUrl(page: PDFPageProxy, scale?: number): Promise<{
+    dataUrl: string;
+    width: number;
+    height: number;
+}>;
+/**
+ * Render PDF page with text content extraction (Phase 2)
+ *
+ * This function extracts text in parallel with rendering for future
+ * text layer support. Currently the text content is available but not used.
+ */
+export declare function renderPdfPageWithText(page: PDFPageProxy, scale?: number): Promise<{
+    dataUrl: string;
+    width: number;
+    height: number;
+    textContent: TextContent;
+}>;
+//# sourceMappingURL=browser-pdfjs.d.ts.map

package/dist/lib/browser-pdfjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-pdfjs.d.ts","sourceRoot":"","sources":["../../src/lib/browser-pdfjs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW,CAAC;IACvE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAAC;IAC/C,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,wBAAwB,CAAC;IACxC,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC;IACrD,mBAAmB,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAgCnD;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAI5E;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,YAAY,EAClB,KAAK,SAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA2B7D;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,YAAY,EAClB,KAAK,SAAM,GACV,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC,CAgCD"}

package/dist/lib/button-styles.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Centralized button styles matching Figma design
+ * Two primary styles from authenticated home page:
+ * 1. Primary (cyan/blue gradient) - for main CTAs
+ * 2. Secondary (gray with black outline) - for secondary actions
+ */
+export declare const buttonStyles: {
+    readonly primary: {
+        readonly base: "semiont-button semiont-button--primary";
+        readonly large: "semiont-button semiont-button--primary semiont-button--large";
+    };
+    readonly secondary: {
+        readonly base: "semiont-button semiont-button--secondary";
+        readonly withScale: "semiont-button semiont-button--secondary semiont-button--scale";
+    };
+    readonly tertiary: {
+        readonly base: "semiont-button semiont-button--tertiary";
+    };
+    readonly danger: {
+        readonly base: "semiont-button semiont-button--danger";
+    };
+    readonly warning: {
+        readonly base: "semiont-button semiont-button--warning";
+    };
+    readonly combine: (...classes: string[]) => string;
+};
+//# sourceMappingURL=button-styles.d.ts.map

package/dist/lib/button-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-styles.d.ts","sourceRoot":"","sources":["../../src/lib/button-styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;mCA6BD,MAAM,EAAE;CACtB,CAAC"}

package/dist/lib/codemirror-handlers.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Event handler logic extracted from CodeMirrorRenderer
+ *
+ * These functions handle click and hover interactions on annotations
+ * and widgets within the CodeMirror editor. They operate on plain DOM
+ * elements and a SemiontSession — no CodeMirror API dependency.
+ */
+import type { Motivation } from '@semiont/core';
+import type { SemiontSession } from '@semiont/sdk';
+import type { TextSegment } from './codemirror-logic';
+/**
+ * Handle click on an annotation element.
+ * Looks up the segment by annotation ID, then emits browse:click.
+ *
+ * @returns true if the click was handled (an annotation was clicked), false otherwise
+ */
+export declare function handleAnnotationClick(target: HTMLElement, segmentsById: Map<string, TextSegment>, session: SemiontSession): boolean;
+/**
+ * Result of processing a widget click
+ */
+export interface WidgetClickResult {
+    handled: boolean;
+    action?: 'navigate' | 'browse-click';
+    resourceId?: string;
+    annotationId?: string;
+    motivation?: Motivation;
+}
+/**
+ * Handle click on a reference preview widget.
+ * Determines whether to navigate (resolved) or browse-click (unresolved).
+ */
+export declare function handleWidgetClick(target: HTMLElement): WidgetClickResult;
+/**
+ * Dispatch a widget click result to the session bus
+ */
+export declare function dispatchWidgetClick(result: WidgetClickResult, session: SemiontSession): void;
+/**
+ * Handle mouseenter on a widget — show preview tooltip for resolved references
+ */
+export declare function handleWidgetMouseEnter(target: HTMLElement): {
+    showPreview: boolean;
+    targetName?: string;
+    widget: HTMLElement | null;
+};
+/**
+ * Handle mouseleave on a widget — hide preview tooltip
+ */
+export declare function handleWidgetMouseLeave(target: HTMLElement): {
+    hidePreview: boolean;
+    widget: HTMLElement | null;
+};
+//# sourceMappingURL=codemirror-handlers.d.ts.map

package/dist/lib/codemirror-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemirror-handlers.d.ts","sourceRoot":"","sources":["../../src/lib/codemirror-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACtC,OAAO,EAAE,cAAc,GACtB,OAAO,CAWT;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CA2BxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAQ5F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG;IAC3D,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAC5B,CAmBA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG;IAC3D,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAC5B,CAcA"}

package/dist/lib/codemirror-json-theme.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared CodeMirror JSON theme for light mode
+ * Used by both JsonLdView (popups) and JsonLdPanel (sidebar)
+ */
+import { HighlightStyle } from '@codemirror/language';
+export declare const jsonLightTheme: import("@codemirror/state").Extension;
+export declare const jsonLightHighlightStyle: HighlightStyle;
+//# sourceMappingURL=codemirror-json-theme.d.ts.map

package/dist/lib/codemirror-json-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemirror-json-theme.d.ts","sourceRoot":"","sources":["../../src/lib/codemirror-json-theme.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,eAAO,MAAM,cAAc,uCAmBR,CAAC;AAEpB,eAAO,MAAM,uBAAuB,gBASlC,CAAC"}

package/dist/lib/codemirror-logic.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Pure logic extracted from CodeMirrorRenderer
+ *
+ * These functions have zero dependency on CodeMirror's DOM or React.
+ * They handle position conversion, tooltip generation, and decoration metadata.
+ */
+import type { Annotation } from '@semiont/core';
+export interface TextSegment {
+    exact: string;
+    annotation?: Annotation;
+    start: number;
+    end: number;
+}
+/**
+ * Convert positions from CRLF character space to LF character space.
+ * CodeMirror normalizes all line endings to LF internally, but annotation positions
+ * are calculated in the original content's character space (which may have CRLF).
+ *
+ * @param segments - Segments with positions in CRLF space
+ * @param content - Original content (may have CRLF line endings)
+ * @returns Segments with positions adjusted for LF space
+ */
+export declare function convertSegmentPositions(segments: TextSegment[], content: string): TextSegment[];
+/**
+ * Get tooltip text for annotation based on type/motivation
+ */
+export declare function getAnnotationTooltip(annotation: Annotation): string;
+/**
+ * Metadata for a single annotation decoration (class name, data attributes, tooltip)
+ */
+export interface AnnotationDecorationMeta {
+    className: string;
+    annotationType: string;
+    annotationId: string;
+    tooltip: string;
+}
+/**
+ * Compute decoration metadata for a single annotated segment.
+ * Pure function — no CodeMirror dependency.
+ */
+export declare function getAnnotationDecorationMeta(annotation: Annotation, isNew: boolean): AnnotationDecorationMeta;
+/**
+ * Compute all annotation decoration metadata from segments.
+ * Returns sorted, filtered entries ready for CodeMirror's RangeSetBuilder.
+ */
+export declare function computeAnnotationDecorations(segments: TextSegment[], newAnnotationIds?: Set<string>): Array<{
+    start: number;
+    end: number;
+    meta: AnnotationDecorationMeta;
+}>;
+/**
+ * Widget metadata for a reference annotation
+ */
+export interface ReferenceWidgetMeta {
+    annotationId: string;
+    position: number;
+    targetName: string | undefined;
+    isGenerating: boolean;
+    bodySource: string | undefined;
+}
+/**
+ * Compute widget metadata for reference annotations.
+ * Pure function — no CodeMirror dependency.
+ */
+export declare function computeWidgetDecorations(segments: TextSegment[], generatingReferenceId: string | null | undefined, getTargetResourceName?: (resourceId: string) => string | undefined): ReferenceWidgetMeta[];
+//# sourceMappingURL=codemirror-logic.d.ts.map

package/dist/lib/codemirror-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemirror-logic.d.ts","sourceRoot":"","sources":["../../src/lib/codemirror-logic.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CA+B/F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAsBnE;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,OAAO,GACb,wBAAwB,CAuB1B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,WAAW,EAAE,EACvB,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,wBAAwB,CAAA;CAAE,CAAC,CAavE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,WAAW,EAAE,EACvB,qBAAqB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChD,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GACjE,mBAAmB,EAAE,CAkBvB"}

package/dist/lib/codemirror-widgets.d.ts

@@ -0,0 +1,39 @@
+/**
+ * CodeMirror Inline Widgets
+ *
+ * Custom widgets for enhancing the document editing experience:
+ * - Reference resolution indicators (resolved 🔗, generating ✨, stub ❓)
+ *
+ * Event handling uses delegation — no per-widget listeners.
+ * Data attributes on the container enable CodeMirrorRenderer to handle
+ * clicks and hovers via a single set of delegated handlers.
+ */
+import { WidgetType } from '@codemirror/view';
+import type { Annotation } from '@semiont/core';
+/**
+ * Reference Resolution Widget
+ * Shows a small indicator next to references with hover preview.
+ *
+ * All event handling is delegated — the widget sets data attributes
+ * and CodeMirrorRenderer handles events via container-level listeners.
+ */
+export declare class ReferenceResolutionWidget extends WidgetType {
+    readonly annotation: Annotation;
+    readonly targetDocumentName?: string | undefined;
+    readonly isGenerating?: boolean | undefined;
+    constructor(annotation: Annotation, targetDocumentName?: string | undefined, isGenerating?: boolean | undefined);
+    eq(other: ReferenceResolutionWidget): boolean;
+    toDOM(): HTMLSpanElement;
+    ignoreEvent(event: Event): boolean;
+}
+/**
+ * Show a tooltip preview on a widget container.
+ * Called from delegated mouseenter handler in CodeMirrorRenderer.
+ */
+export declare function showWidgetPreview(container: HTMLElement, documentName: string): void;
+/**
+ * Hide the tooltip preview from a widget container.
+ * Called from delegated mouseleave handler in CodeMirrorRenderer.
+ */
+export declare function hideWidgetPreview(container: HTMLElement): void;
+//# sourceMappingURL=codemirror-widgets.d.ts.map

package/dist/lib/codemirror-widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemirror-widgets.d.ts","sourceRoot":"","sources":["../../src/lib/codemirror-widgets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,UAAU;IAErD,QAAQ,CAAC,UAAU,EAAE,UAAU;IAC/B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO;gBAFtB,UAAU,EAAE,UAAU,EACtB,kBAAkB,CAAC,EAAE,MAAM,YAAA,EAC3B,YAAY,CAAC,EAAE,OAAO,YAAA;IAKxB,EAAE,CAAC,KAAK,EAAE,yBAAyB;IASnC,KAAK;IAqGL,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;CAG5C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAwBpF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAG9D"}

package/dist/lib/formatTime.d.ts

@@ -0,0 +1,2 @@
+export declare function formatTime(milliseconds: number | null): string | null;
+//# sourceMappingURL=formatTime.d.ts.map

package/dist/lib/formatTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatTime.d.ts","sourceRoot":"","sources":["../../src/lib/formatTime.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAiBrE"}

package/dist/lib/media-shapes.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Media Type Shape Support
+ *
+ * Defines which annotation shapes are supported for each media type.
+ * Shapes are tracked per selector type (FragmentSelector, SvgSelector).
+ */
+import type { ShapeType } from '../components/annotation/AnnotateToolbar';
+/**
+ * Selector types that support shape selection
+ */
+export type SelectorType = 'fragment' | 'svg' | 'text';
+/**
+ * Get supported annotation shapes for a given media type
+ *
+ * PDF: Only rectangles (FragmentSelector with RFC 3778 viewrect)
+ * Images: All shapes (SvgSelector supports rect, circle, polygon)
+ *
+ * @param mediaType - MIME type of the resource (e.g., 'application/pdf', 'image/png')
+ * @returns Array of supported shape types for annotation
+ */
+export declare function getSupportedShapes(mediaType: string | undefined | null): ShapeType[];
+/**
+ * Check if a shape type is supported for a given media type
+ *
+ * @param mediaType - MIME type of the resource
+ * @param shape - Shape type to check
+ * @returns true if the shape is supported for this media type
+ */
+export declare function isShapeSupported(mediaType: string | undefined | null, shape: ShapeType): boolean;
+/**
+ * Get the selector type used for a given media type
+ *
+ * @param mediaType - MIME type of the resource
+ * @returns Selector type (fragment, svg, or text)
+ */
+export declare function getSelectorType(mediaType: string | undefined | null): SelectorType;
+/**
+ * Get the selected shape for a given selector type from localStorage
+ *
+ * @param selectorType - The selector type
+ * @returns The selected shape, or default for that selector type
+ */
+export declare function getSelectedShapeForSelectorType(selectorType: SelectorType): ShapeType;
+/**
+ * Save the selected shape for a given selector type to localStorage
+ *
+ * @param selectorType - The selector type
+ * @param shape - The shape to save
+ */
+export declare function saveSelectedShapeForSelectorType(selectorType: SelectorType, shape: ShapeType): void;
+//# sourceMappingURL=media-shapes.d.ts.map

package/dist/lib/media-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-shapes.d.ts","sourceRoot":"","sources":["../../src/lib/media-shapes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,EAAE,CAmBpF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACpC,KAAK,EAAE,SAAS,GACf,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,YAAY,CAiBlF;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,CAqBrF;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAKnG"}

package/dist/lib/pdf-coordinates.d.ts

@@ -0,0 +1,69 @@
+/**
+ * PDF Coordinate Utilities
+ *
+ * Handles coordinate transformations between:
+ * - Canvas space (pixels, top-left origin, Y increases downward)
+ * - PDF space (points, bottom-left origin, Y increases upward)
+ *
+ * Based on RFC 3778 PDF Fragment Identifiers:
+ * https://tools.ietf.org/html/rfc3778
+ */
+export interface Rectangle {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface PdfCoordinate {
+    page: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface CanvasRectangle {
+    startX: number;
+    startY: number;
+    endX: number;
+    endY: number;
+}
+/**
+ * Convert canvas coordinates to PDF coordinates
+ *
+ * Canvas: Origin at top-left, Y increases downward
+ * PDF: Origin at bottom-left, Y increases upward
+ *
+ * @param canvasRect - Rectangle in canvas pixel coordinates
+ * @param page - PDF page number (1-indexed)
+ * @param pageWidth - PDF page width in points
+ * @param pageHeight - PDF page height in points
+ * @param scale - Current canvas scale factor
+ */
+export declare function canvasToPdfCoordinates(canvasRect: CanvasRectangle, page: number, _pageWidth: number, pageHeight: number, scale?: number): PdfCoordinate;
+/**
+ * Convert PDF coordinates to canvas coordinates
+ *
+ * @param pdfCoord - Coordinates in PDF space
+ * @param pageHeight - PDF page height in points
+ * @param scale - Current canvas scale factor
+ */
+export declare function pdfToCanvasCoordinates(pdfCoord: PdfCoordinate, pageHeight: number, scale?: number): Rectangle;
+/**
+ * Generate RFC 3778 FragmentSelector value
+ *
+ * Format: page=N&viewrect=left,top,width,height
+ * All coordinates in PDF points
+ */
+export declare function createFragmentSelector(coord: PdfCoordinate): string;
+/**
+ * Parse RFC 3778 FragmentSelector value
+ *
+ * @param fragment - Fragment string like "page=5&viewrect=100,200,300,400"
+ * @returns Parsed PDF coordinates or null if invalid
+ */
+export declare function parseFragmentSelector(fragment: string): PdfCoordinate | null;
+/**
+ * Extract page number from FragmentSelector
+ */
+export declare function getPageFromFragment(fragment: string): number | null;
+//# sourceMappingURL=pdf-coordinates.d.ts.map

package/dist/lib/pdf-coordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-coordinates.d.ts","sourceRoot":"","sources":["../../src/lib/pdf-coordinates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,eAAe,EAC3B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAU,GAChB,aAAa,CAsBf;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAU,GAChB,SAAS,CAeX;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAqB5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnE"}

package/dist/lib/resource-utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Resource utilities
+ * Shared helper functions for resource display and metadata
+ */
+/**
+ * Get icon emoji based on media type
+ */
+export declare function getResourceIcon(mediaType: string | undefined): string;
+/**
+ * Check if a resource supports text-based AI detection features
+ *
+ * Currently returns true for any text/* media type.
+ * Future enhancements may include:
+ * - Checking resource language/locale compatibility
+ * - Validating content size limits
+ * - Checking for specific text format requirements
+ *
+ * @param mediaType - The media type string (e.g., 'text/plain', 'text/markdown')
+ * @returns true if the resource supports AI detection features
+ */
+export declare function supportsDetection(mediaType: string | undefined): boolean;
+//# sourceMappingURL=resource-utils.d.ts.map

package/dist/lib/resource-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-utils.d.ts","sourceRoot":"","sources":["../../src/lib/resource-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAmBrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIxE"}

package/dist/lib/scroll-utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Scroll utilities for annotation navigation
+ */
+export interface ScrollToAnnotationOptions {
+    /** Add pulse animation that auto-removes after 2 seconds */
+    pulse?: boolean;
+    /** Scroll behavior */
+    behavior?: ScrollBehavior;
+}
+/**
+ * Scrolls an annotation into view within its scroll container.
+ * Centers the annotation vertically within the container.
+ *
+ * @param annotationId - ID of the annotation to scroll to
+ * @param rootElement - Root element containing the annotation (will search within this)
+ * @param options - Scroll options
+ * @returns true if annotation was found and scrolled, false otherwise
+ */
+export declare function scrollAnnotationIntoView(annotationId: string | null, rootElement: HTMLElement, options?: ScrollToAnnotationOptions): boolean;
+//# sourceMappingURL=scroll-utils.d.ts.map

package/dist/lib/scroll-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-utils.d.ts","sourceRoot":"","sources":["../../src/lib/scroll-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAgDT"}

package/dist/lib/text-segmentation.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Text segmentation for annotation rendering
+ *
+ * Splits document text into segments, matching each annotation to its
+ * position using fuzzy anchoring (TextQuoteSelector) with fallback to
+ * exact positions (TextPositionSelector).
+ *
+ * No React dependencies — safe to use in any JavaScript environment.
+ */
+import type { TextSegment } from './codemirror-logic';
+import type { Annotation } from '@semiont/core';
+export type { TextSegment };
+/**
+ * Segment text with annotations — uses fuzzy anchoring when available.
+ *
+ * For each annotation, tries TextQuoteSelector (fuzzy) first, then falls
+ * back to TextPositionSelector (exact). Handles overlapping annotations
+ * by skipping later ones that overlap earlier ones.
+ *
+ * @param content - Full document text
+ * @param annotations - Array of W3C annotations with target selectors
+ * @returns Array of TextSegments covering the full content
+ */
+export declare function segmentTextWithAnnotations(content: string, annotations: Annotation[]): TextSegment[];
+//# sourceMappingURL=text-segmentation.d.ts.map

package/dist/lib/text-segmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-segmentation.d.ts","sourceRoot":"","sources":["../../src/lib/text-segmentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,CAiFpG"}

package/dist/lib/text-selection-handler.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Text selection handler logic extracted from AnnotateView
+ *
+ * Builds W3C annotation selectors (TextPositionSelector + TextQuoteSelector)
+ * from a text selection. No DOM, React, or CodeMirror dependencies.
+ */
+/**
+ * A pair of selectors for a text annotation:
+ * TextPositionSelector (exact position) + TextQuoteSelector (fuzzy anchoring)
+ */
+export type SelectorPair = [
+    {
+        type: 'TextPositionSelector';
+        start: number;
+        end: number;
+    },
+    {
+        type: 'TextQuoteSelector';
+        exact: string;
+        prefix?: string;
+        suffix?: string;
+    }
+];
+/**
+ * Build a TextPositionSelector + TextQuoteSelector pair for a text selection.
+ *
+ * @param content - Full document text
+ * @param selectedText - The selected text
+ * @param start - Start position in the document
+ * @param end - End position in the document
+ * @returns Selector pair ready for mark:requested event, or null if invalid
+ */
+export declare function buildTextSelectors(content: string, selectedText: string, start: number, end: number): SelectorPair | null;
+/**
+ * Determine the start position of selected text using a fallback strategy.
+ * Tries indexOf when CodeMirror's posAtDOM is unavailable.
+ *
+ * @param content - Full document text
+ * @param selectedText - The selected text
+ * @returns Position or null if not found
+ */
+export declare function fallbackTextPosition(content: string, selectedText: string): {
+    start: number;
+    end: number;
+} | null;
+//# sourceMappingURL=text-selection-handler.d.ts.map

package/dist/lib/text-selection-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-selection-handler.d.ts","sourceRoot":"","sources":["../../src/lib/text-selection-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;QAAE,IAAI,EAAE,sBAAsB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAC5D;QAAE,IAAI,EAAE,mBAAmB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAC/E,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,YAAY,GAAG,IAAI,CAoBrB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIvC"}