web-annotation-renderer 0.3.0 → 0.5.0

package/dist/index2.js

@@ -1,17 +1,19 @@
-import { PDFRenderer as r } from "./index3.js";
-import { LayerManager as n } from "./index4.js";
-import { TimelineSync as s } from "./index5.js";
-class c {
+import { PDFRenderer as n } from "./index3.js";
+import { TimelineSync as s } from "./index4.js";
+import { StrokeRenderer as i } from "./index5.js";
+import { deepMerge as o } from "./index6.js";
+class d {
   /**
    * Create AnnotationRenderer instance
    *
    * @param {Object} config - Configuration object
-   * @param {HTMLElement} config.container - DOM element for layer rendering
+   * @param {HTMLElement} config.container - DOM element for annotation canvas
    * @param {HTMLCanvasElement} config.canvasElement - Canvas element for PDF rendering
    * @param {string} [config.pdfUrl] - PDF URL to load immediately
    * @param {number} [config.initialPage=1] - Initial page number
    * @param {number} [config.initialScale=1.0] - Initial scale factor
    * @param {Array} [config.annotations=[]] - Initial annotation data
+   * @param {Object} [config.strokeConfig] - StrokeRenderer configuration
    * @throws {Error} If config is invalid or required elements are missing
    */
   constructor(e) {
@@ -21,42 +23,36 @@ class c {
       throw new Error("AnnotationRenderer: config.container must be a valid DOM element");
     if (!e.canvasElement || !(e.canvasElement instanceof HTMLCanvasElement))
       throw new Error("AnnotationRenderer: config.canvasElement must be a valid canvas element");
-    this.config = e, this.canvasElement = e.canvasElement, this.container = e.container, this.pdfRenderer = new r(), this.layerManager = new n(e.container, {
-      width: 1,
-      height: 1,
-      scale: 1
-    }), this.timelineSync = new s(), this.currentPage = e.initialPage || 1, this.currentScale = e.initialScale || 1, this.annotations = e.annotations || [], this.pageCount = 0, this.currentViewport = null, this.pdfUrl = null, this.timelineSync.subscribe((t) => {
-      this.layerManager.updateTimeline(t);
+    this.config = e, this.canvasElement = e.canvasElement, this.container = e.container, this.pdfRenderer = new n(), this.strokeCanvas = this._createStrokeCanvas(), this.strokeRenderer = new i(this.strokeCanvas, e.strokeConfig || {}), this.timelineSync = new s(), this.currentPage = e.initialPage || 1, this.currentScale = e.initialScale || 1, this.annotations = e.annotations || [], this.pageCount = 0, this.currentViewport = null, this.pdfUrl = null, this.timelineSync.subscribe((t) => {
+      this.strokeRenderer.render(t);
     }), e.pdfUrl && this.loadPDF(e.pdfUrl).catch((t) => {
       console.error("AnnotationRenderer: Failed to auto-load PDF:", t);
     });
   }
+  /**
+   * Create stroke canvas overlay
+   *
+   * @private
+   * @returns {HTMLCanvasElement} Stroke canvas element
+   */
+  _createStrokeCanvas() {
+    const e = document.createElement("canvas");
+    return e.className = "stroke-canvas", e.style.position = "absolute", e.style.top = "0", e.style.left = "0", e.style.pointerEvents = "none", e.style.zIndex = "10", this.container.appendChild(e), e;
+  }
   /**
    * Load PDF document from URL
    *
    * @param {string} url - URL or path to PDF file
    * @returns {Promise<Object>} Load result with success status and page count
-   * @returns {boolean} return.success - Whether loading succeeded
-   * @returns {number} [return.pageCount] - Number of pages if successful
-   * @returns {string} [return.error] - Error message if failed
    */
   async loadPDF(e) {
     try {
       if (!e || typeof e != "string")
-        return {
-          success: !1,
-          error: "Invalid PDF URL provided"
-        };
+        return { success: !1, error: "Invalid PDF URL provided" };
       const t = await this.pdfRenderer.loadDocument(e);
-      return t.success ? (this.pdfUrl = e, this.pageCount = t.pageCount, {
-        success: !0,
-        pageCount: t.pageCount
-      }) : t;
+      return t.success ? (this.pdfUrl = e, this.pageCount = t.pageCount, { success: !0, pageCount: t.pageCount }) : t;
     } catch (t) {
-      return console.error("AnnotationRenderer.loadPDF: Error loading PDF:", t), {
-        success: !1,
-        error: `Failed to load PDF: ${t.message}`
-      };
+      return console.error("AnnotationRenderer.loadPDF: Error loading PDF:", t), { success: !1, error: `Failed to load PDF: ${t.message}` };
     }
   }
   /**
@@ -64,37 +60,27 @@ class c {
    *
    * @param {number} pageNum - Page number (1-indexed)
    * @returns {Promise<Object>} Render result with viewport information
-   * @returns {boolean} return.success - Whether rendering succeeded
-   * @returns {Object} [return.viewport] - Viewport dimensions if successful
-   * @returns {string} [return.error] - Error message if failed
    */
   async setPage(e) {
     try {
       if (typeof e != "number" || e < 1)
-        return {
-          success: !1,
-          error: "Invalid page number"
-        };
+        return { success: !1, error: "Invalid page number" };
       if (this.pageCount > 0 && e > this.pageCount)
-        return {
-          success: !1,
-          error: `Page ${e} exceeds document page count (${this.pageCount})`
-        };
+        return { success: !1, error: `Page ${e} exceeds document page count (${this.pageCount})` };
       this.pdfRenderer.cancelRender();
       const t = await this.pdfRenderer.renderPage(
         e,
         this.canvasElement,
         this.currentScale
       );
-      return t.success ? (this.currentPage = e, this.currentViewport = t.viewport, this.layerManager.setAnnotations(this.annotations, e), this.layerManager.setViewport(t.viewport), {
-        success: !0,
-        viewport: t.viewport
-      }) : t;
+      if (t.success) {
+        this.currentPage = e, this.currentViewport = t.viewport, this.strokeRenderer.setViewport(t.viewport.width, t.viewport.height), this.strokeRenderer.setAnnotations(this.annotations, e);
+        const r = this.timelineSync.getCurrentTime();
+        return this.strokeRenderer.render(r), { success: !0, viewport: t.viewport };
+      }
+      return t;
     } catch (t) {
-      return console.error("AnnotationRenderer.setPage: Error rendering page:", t), {
-        success: !1,
-        error: `Failed to render page: ${t.message}`
-      };
+      return console.error("AnnotationRenderer.setPage: Error rendering page:", t), { success: !1, error: `Failed to render page: ${t.message}` };
     }
   }
   /**
@@ -102,37 +88,40 @@ class c {
    *
    * @param {number} scale - Scale factor (e.g., 1.0, 1.5, 2.0)
    * @returns {Promise<Object>} Render result with viewport information
-   * @returns {boolean} return.success - Whether rendering succeeded
-   * @returns {Object} [return.viewport] - Viewport dimensions if successful
-   * @returns {string} [return.error] - Error message if failed
    */
   async setScale(e) {
     try {
-      return typeof e != "number" || e <= 0 ? {
-        success: !1,
-        error: "Invalid scale value (must be positive number)"
-      } : (this.currentScale = e, await this.setPage(this.currentPage));
+      return typeof e != "number" || e <= 0 ? { success: !1, error: "Invalid scale value (must be positive number)" } : (this.currentScale = e, await this.setPage(this.currentPage));
     } catch (t) {
-      return console.error("AnnotationRenderer.setScale: Error changing scale:", t), {
-        success: !1,
-        error: `Failed to change scale: ${t.message}`
-      };
+      return console.error("AnnotationRenderer.setScale: Error changing scale:", t), { success: !1, error: `Failed to change scale: ${t.message}` };
     }
   }
   /**
    * Update annotation data for rendering
    *
    * @param {Array} annotations - Complete annotation array (all pages, all types)
-   * @returns {void}
    */
   setAnnotations(e) {
-    Array.isArray(e) || (console.warn("AnnotationRenderer.setAnnotations: annotations must be an array"), e = []), this.annotations = e, this.layerManager.setAnnotations(e, this.currentPage);
+    Array.isArray(e) || (console.warn("AnnotationRenderer.setAnnotations: annotations must be an array"), e = []), this.annotations = e, this.strokeRenderer.setAnnotations(e, this.currentPage);
+    const t = this.timelineSync.getCurrentTime();
+    this.strokeRenderer.render(t);
+  }
+  /**
+   * Set pre-converted strokes directly
+   *
+   * Bypasses annotation conversion, useful for stroke commands from backend.
+   *
+   * @param {Array} strokes - Array of stroke command objects
+   */
+  setStrokes(e) {
+    this.strokeRenderer.setStrokes(e);
+    const t = this.timelineSync.getCurrentTime();
+    this.strokeRenderer.render(t);
   }
   /**
    * Update timeline position for animation
    *
    * @param {number} timestamp - Current timeline position in seconds
-   * @returns {void}
    */
   setTime(e) {
     if (typeof e != "number") {
@@ -141,17 +130,55 @@ class c {
     }
     this.timelineSync.setTime(e);
   }
+  /**
+   * Start continuous timeline synchronization using requestAnimationFrame
+   *
+   * Polls the provided function at ~60fps for smooth animation.
+   * Use this for audio/video synchronization instead of setTime().
+   *
+   * @param {Function} getTimeFunction - Function that returns current time in seconds
+   * @example
+   * const audio = document.getElementById('audio');
+   * renderer.startContinuousSync(() => audio.currentTime);
+   */
+  startContinuousSync(e) {
+    this.timelineSync.startContinuousSync(e);
+  }
+  /**
+   * Stop continuous timeline synchronization
+   *
+   * Call this when audio/video stops or component unmounts.
+   */
+  stopContinuousSync() {
+    this.timelineSync.stopContinuousSync();
+  }
+  /**
+   * Check if continuous sync is currently active
+   *
+   * @returns {boolean} True if continuous sync is running
+   */
+  isContinuousSyncActive() {
+    return this.timelineSync.isRunning;
+  }
+  /**
+   * Update stroke rendering configuration at runtime
+   *
+   * Merges new config with existing and re-renders annotations.
+   * Used for live preview of pen style changes.
+   *
+   * @param {Object} newConfig - New stroke configuration to merge
+   */
+  updateStrokeConfig(e) {
+    if (!e || typeof e != "object")
+      return;
+    this.strokeRenderer.config = o(this.strokeRenderer.config, e), this.strokeRenderer.setAnnotations(this.annotations, this.currentPage);
+    const t = this.timelineSync.getCurrentTime();
+    this.strokeRenderer.render(t);
+  }
   /**
    * Get current engine state snapshot
    *
    * @returns {Object} Current state
-   * @returns {number} return.page - Current page number
-   * @returns {number} return.scale - Current scale factor
-   * @returns {Array} return.annotations - Current annotation array
-   * @returns {number} return.pageCount - Total page count
-   * @returns {number} return.time - Current timeline position
-   * @returns {Object|null} return.viewport - Current viewport dimensions
-   * @returns {string|null} return.pdfUrl - Current PDF URL
    */
   getState() {
     return {
@@ -166,17 +193,12 @@ class c {
   }
   /**
    * Clean up all resources and subsystems
-   *
-   * Call before removing AnnotationRenderer instance.
-   * Destroys all subsystems and releases references.
-   *
-   * @returns {void}
    */
   destroy() {
-    this.pdfRenderer && this.pdfRenderer.destroy(), this.layerManager && this.layerManager.destroy(), this.timelineSync && this.timelineSync.destroy(), this.pdfRenderer = null, this.layerManager = null, this.timelineSync = null, this.config = null, this.canvasElement = null, this.container = null, this.annotations = [], this.currentPage = 0, this.currentScale = 1, this.pageCount = 0, this.currentViewport = null, this.pdfUrl = null;
+    this.pdfRenderer && this.pdfRenderer.destroy(), this.strokeRenderer && this.strokeRenderer.destroy(), this.timelineSync && this.timelineSync.destroy(), this.strokeCanvas && this.strokeCanvas.parentNode && this.strokeCanvas.parentNode.removeChild(this.strokeCanvas), this.pdfRenderer = null, this.strokeRenderer = null, this.timelineSync = null, this.strokeCanvas = null, this.config = null, this.canvasElement = null, this.container = null, this.annotations = [], this.currentPage = 0, this.currentScale = 1, this.pageCount = 0, this.currentViewport = null, this.pdfUrl = null;
   }
 }
 export {
-  c as AnnotationRenderer
+  d as AnnotationRenderer
 };
 //# sourceMappingURL=index2.js.map

package/dist/index2.js.map

@@ -1 +1 @@
-{"version":3,"file":"index2.js","sources":["../src/core/AnnotationRenderer.js"],"sourcesContent":["/**\n * AnnotationRenderer - Main facade for PDF annotation rendering engine\n *\n * This module orchestrates all subsystems (PDFRenderer, LayerManager, TimelineSync)\n * and provides the primary public API for rendering PDFs with timeline-synchronized\n * annotations. Framework-agnostic core that can be wrapped by React/Vue adapters.\n *\n * @module core/AnnotationRenderer\n */\n\nimport { PDFRenderer } from './PDFRenderer.js';\nimport { LayerManager } from './LayerManager.js';\nimport { TimelineSync } from './TimelineSync.js';\n\n/**\n * AnnotationRenderer class\n *\n * Main engine that coordinates PDF rendering, annotation layers, and timeline\n * synchronization. Provides simple imperative API for consumers.\n *\n * @class\n * @example\n * const renderer = new AnnotationRenderer({\n *   container: document.getElementById('layer-container'),\n *   canvasElement: document.getElementById('pdf-canvas')\n * });\n *\n * await renderer.loadPDF('/path/to/doc.pdf');\n * await renderer.setPage(1);\n * renderer.setAnnotations(annotationData);\n * renderer.setScale(1.5);\n * renderer.setTime(3.5);\n */\nexport class AnnotationRenderer {\n  /**\n   * Create AnnotationRenderer instance\n   *\n   * @param {Object} config - Configuration object\n   * @param {HTMLElement} config.container - DOM element for layer rendering\n   * @param {HTMLCanvasElement} config.canvasElement - Canvas element for PDF rendering\n   * @param {string} [config.pdfUrl] - PDF URL to load immediately\n   * @param {number} [config.initialPage=1] - Initial page number\n   * @param {number} [config.initialScale=1.0] - Initial scale factor\n   * @param {Array} [config.annotations=[]] - Initial annotation data\n   * @throws {Error} If config is invalid or required elements are missing\n   */\n  constructor(config) {\n    // Validate config\n    if (!config || typeof config !== 'object') {\n      throw new Error('AnnotationRenderer: config object is required');\n    }\n\n    if (!config.container || !(config.container instanceof HTMLElement)) {\n      throw new Error('AnnotationRenderer: config.container must be a valid DOM element');\n    }\n\n    if (!config.canvasElement || !(config.canvasElement instanceof HTMLCanvasElement)) {\n      throw new Error('AnnotationRenderer: config.canvasElement must be a valid canvas element');\n    }\n\n    /**\n     * @private\n     * @type {Object}\n     */\n    this.config = config;\n\n    /**\n     * @private\n     * @type {HTMLCanvasElement}\n     */\n    this.canvasElement = config.canvasElement;\n\n    /**\n     * @private\n     * @type {HTMLElement}\n     */\n    this.container = config.container;\n\n    /**\n     * @private\n     * @type {PDFRenderer}\n     */\n    this.pdfRenderer = new PDFRenderer();\n\n    /**\n     * @private\n     * @type {LayerManager}\n     */\n    // Initialize LayerManager with a minimal default viewport that will be updated when PDF loads\n    // BaseLayer requires positive width/height, so use 1x1 as placeholder\n    this.layerManager = new LayerManager(config.container, {\n      width: 1,\n      height: 1,\n      scale: 1.0\n    });\n\n    /**\n     * @private\n     * @type {TimelineSync}\n     */\n    this.timelineSync = new TimelineSync();\n\n    /**\n     * @private\n     * @type {number}\n     */\n    this.currentPage = config.initialPage || 1;\n\n    /**\n     * @private\n     * @type {number}\n     */\n    this.currentScale = config.initialScale || 1.0;\n\n    /**\n     * @private\n     * @type {Array}\n     */\n    this.annotations = config.annotations || [];\n\n    /**\n     * @private\n     * @type {number}\n     */\n    this.pageCount = 0;\n\n    /**\n     * @private\n     * @type {Object|null}\n     */\n    this.currentViewport = null;\n\n    /**\n     * @private\n     * @type {string|null}\n     */\n    this.pdfUrl = null;\n\n    // Wire up subsystem communication\n    // Timeline updates automatically propagate to LayerManager\n    this.timelineSync.subscribe((time) => {\n      this.layerManager.updateTimeline(time);\n    });\n\n    // Auto-load PDF if provided\n    if (config.pdfUrl) {\n      this.loadPDF(config.pdfUrl).catch(err => {\n        console.error('AnnotationRenderer: Failed to auto-load PDF:', err);\n      });\n    }\n  }\n\n  /**\n   * Load PDF document from URL\n   *\n   * @param {string} url - URL or path to PDF file\n   * @returns {Promise<Object>} Load result with success status and page count\n   * @returns {boolean} return.success - Whether loading succeeded\n   * @returns {number} [return.pageCount] - Number of pages if successful\n   * @returns {string} [return.error] - Error message if failed\n   */\n  async loadPDF(url) {\n    try {\n      // Validate URL\n      if (!url || typeof url !== 'string') {\n        return {\n          success: false,\n          error: 'Invalid PDF URL provided'\n        };\n      }\n\n      // Load via PDFRenderer\n      const result = await this.pdfRenderer.loadDocument(url);\n\n      if (result.success) {\n        // Store PDF metadata\n        this.pdfUrl = url;\n        this.pageCount = result.pageCount;\n\n        return {\n          success: true,\n          pageCount: result.pageCount\n        };\n      } else {\n        return result;\n      }\n    } catch (err) {\n      console.error('AnnotationRenderer.loadPDF: Error loading PDF:', err);\n      return {\n        success: false,\n        error: `Failed to load PDF: ${err.message}`\n      };\n    }\n  }\n\n  /**\n   * Navigate to specific page and render it\n   *\n   * @param {number} pageNum - Page number (1-indexed)\n   * @returns {Promise<Object>} Render result with viewport information\n   * @returns {boolean} return.success - Whether rendering succeeded\n   * @returns {Object} [return.viewport] - Viewport dimensions if successful\n   * @returns {string} [return.error] - Error message if failed\n   */\n  async setPage(pageNum) {\n    try {\n      // Validate page number\n      if (typeof pageNum !== 'number' || pageNum < 1) {\n        return {\n          success: false,\n          error: 'Invalid page number'\n        };\n      }\n\n      if (this.pageCount > 0 && pageNum > this.pageCount) {\n        return {\n          success: false,\n          error: `Page ${pageNum} exceeds document page count (${this.pageCount})`\n        };\n      }\n\n      // Cancel any in-progress rendering\n      this.pdfRenderer.cancelRender();\n\n      // Render page via PDFRenderer\n      const result = await this.pdfRenderer.renderPage(\n        pageNum,\n        this.canvasElement,\n        this.currentScale\n      );\n\n      if (result.success) {\n        // Store current state\n        this.currentPage = pageNum;\n        this.currentViewport = result.viewport;\n\n        // Update LayerManager with new page and viewport\n        this.layerManager.setAnnotations(this.annotations, pageNum);\n        this.layerManager.setViewport(result.viewport);\n\n        return {\n          success: true,\n          viewport: result.viewport\n        };\n      } else {\n        return result;\n      }\n    } catch (err) {\n      console.error('AnnotationRenderer.setPage: Error rendering page:', err);\n      return {\n        success: false,\n        error: `Failed to render page: ${err.message}`\n      };\n    }\n  }\n\n  /**\n   * Change zoom scale and re-render current page\n   *\n   * @param {number} scale - Scale factor (e.g., 1.0, 1.5, 2.0)\n   * @returns {Promise<Object>} Render result with viewport information\n   * @returns {boolean} return.success - Whether rendering succeeded\n   * @returns {Object} [return.viewport] - Viewport dimensions if successful\n   * @returns {string} [return.error] - Error message if failed\n   */\n  async setScale(scale) {\n    try {\n      // Validate scale\n      if (typeof scale !== 'number' || scale <= 0) {\n        return {\n          success: false,\n          error: 'Invalid scale value (must be positive number)'\n        };\n      }\n\n      // Store new scale\n      this.currentScale = scale;\n\n      // Re-render current page at new scale\n      const result = await this.setPage(this.currentPage);\n\n      return result;\n    } catch (err) {\n      console.error('AnnotationRenderer.setScale: Error changing scale:', err);\n      return {\n        success: false,\n        error: `Failed to change scale: ${err.message}`\n      };\n    }\n  }\n\n  /**\n   * Update annotation data for rendering\n   *\n   * @param {Array} annotations - Complete annotation array (all pages, all types)\n   * @returns {void}\n   */\n  setAnnotations(annotations) {\n    // Validate annotations\n    if (!Array.isArray(annotations)) {\n      console.warn('AnnotationRenderer.setAnnotations: annotations must be an array');\n      annotations = [];\n    }\n\n    // Store annotations\n    this.annotations = annotations;\n\n    // Route to LayerManager for current page\n    this.layerManager.setAnnotations(annotations, this.currentPage);\n  }\n\n  /**\n   * Update timeline position for animation\n   *\n   * @param {number} timestamp - Current timeline position in seconds\n   * @returns {void}\n   */\n  setTime(timestamp) {\n    // Validate timestamp\n    if (typeof timestamp !== 'number') {\n      console.warn('AnnotationRenderer.setTime: timestamp must be a number');\n      return;\n    }\n\n    // Forward to TimelineSync\n    // TimelineSync will notify LayerManager automatically via subscription\n    this.timelineSync.setTime(timestamp);\n  }\n\n  /**\n   * Get current engine state snapshot\n   *\n   * @returns {Object} Current state\n   * @returns {number} return.page - Current page number\n   * @returns {number} return.scale - Current scale factor\n   * @returns {Array} return.annotations - Current annotation array\n   * @returns {number} return.pageCount - Total page count\n   * @returns {number} return.time - Current timeline position\n   * @returns {Object|null} return.viewport - Current viewport dimensions\n   * @returns {string|null} return.pdfUrl - Current PDF URL\n   */\n  getState() {\n    return {\n      page: this.currentPage,\n      scale: this.currentScale,\n      annotations: this.annotations,\n      pageCount: this.pageCount,\n      time: this.timelineSync.getCurrentTime(),\n      viewport: this.currentViewport,\n      pdfUrl: this.pdfUrl\n    };\n  }\n\n  /**\n   * Clean up all resources and subsystems\n   *\n   * Call before removing AnnotationRenderer instance.\n   * Destroys all subsystems and releases references.\n   *\n   * @returns {void}\n   */\n  destroy() {\n    // Destroy all subsystems\n    if (this.pdfRenderer) {\n      this.pdfRenderer.destroy();\n    }\n\n    if (this.layerManager) {\n      this.layerManager.destroy();\n    }\n\n    if (this.timelineSync) {\n      this.timelineSync.destroy();\n    }\n\n    // Clear all references\n    this.pdfRenderer = null;\n    this.layerManager = null;\n    this.timelineSync = null;\n    this.config = null;\n    this.canvasElement = null;\n    this.container = null;\n    this.annotations = [];\n    this.currentPage = 0;\n    this.currentScale = 1.0;\n    this.pageCount = 0;\n    this.currentViewport = null;\n    this.pdfUrl = null;\n  }\n}\n"],"names":["AnnotationRenderer","config","PDFRenderer","LayerManager","TimelineSync","time","err","url","result","pageNum","scale","annotations","timestamp"],"mappings":"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"}
+{"version":3,"file":"index2.js","sources":["../src/core/AnnotationRenderer.js"],"sourcesContent":["/**\n * AnnotationRenderer - Main facade for PDF annotation rendering engine\n *\n * Orchestrates PDFRenderer, StrokeRenderer, and TimelineSync subsystems.\n * Provides the primary public API for rendering PDFs with timeline-synchronized\n * annotations. Framework-agnostic core that can be wrapped by React/Vue adapters.\n *\n * @module core/AnnotationRenderer\n */\n\nimport { PDFRenderer } from './PDFRenderer.js';\nimport { TimelineSync } from './TimelineSync.js';\nimport { StrokeRenderer } from '../renderer/StrokeRenderer.js';\nimport { deepMerge } from '../pen/effects.js';\n\n/**\n * AnnotationRenderer class\n *\n * Main engine that coordinates PDF rendering, stroke-based annotation rendering,\n * and timeline synchronization. Provides simple imperative API for consumers.\n *\n * @class\n * @example\n * const renderer = new AnnotationRenderer({\n *   container: document.getElementById('container'),\n *   canvasElement: document.getElementById('pdf-canvas')\n * });\n *\n * await renderer.loadPDF('/path/to/doc.pdf');\n * await renderer.setPage(1);\n * renderer.setAnnotations(annotationData);\n * renderer.setTime(3.5);\n */\nexport class AnnotationRenderer {\n  /**\n   * Create AnnotationRenderer instance\n   *\n   * @param {Object} config - Configuration object\n   * @param {HTMLElement} config.container - DOM element for annotation canvas\n   * @param {HTMLCanvasElement} config.canvasElement - Canvas element for PDF rendering\n   * @param {string} [config.pdfUrl] - PDF URL to load immediately\n   * @param {number} [config.initialPage=1] - Initial page number\n   * @param {number} [config.initialScale=1.0] - Initial scale factor\n   * @param {Array} [config.annotations=[]] - Initial annotation data\n   * @param {Object} [config.strokeConfig] - StrokeRenderer configuration\n   * @throws {Error} If config is invalid or required elements are missing\n   */\n  constructor(config) {\n    if (!config || typeof config !== 'object') {\n      throw new Error('AnnotationRenderer: config object is required');\n    }\n\n    if (!config.container || !(config.container instanceof HTMLElement)) {\n      throw new Error('AnnotationRenderer: config.container must be a valid DOM element');\n    }\n\n    if (!config.canvasElement || !(config.canvasElement instanceof HTMLCanvasElement)) {\n      throw new Error('AnnotationRenderer: config.canvasElement must be a valid canvas element');\n    }\n\n    this.config = config;\n    this.canvasElement = config.canvasElement;\n    this.container = config.container;\n\n    // Initialize PDFRenderer\n    this.pdfRenderer = new PDFRenderer();\n\n    // Create stroke canvas and StrokeRenderer\n    this.strokeCanvas = this._createStrokeCanvas();\n    this.strokeRenderer = new StrokeRenderer(this.strokeCanvas, config.strokeConfig || {});\n\n    // Initialize TimelineSync\n    this.timelineSync = new TimelineSync();\n\n    // State\n    this.currentPage = config.initialPage || 1;\n    this.currentScale = config.initialScale || 1.0;\n    this.annotations = config.annotations || [];\n    this.pageCount = 0;\n    this.currentViewport = null;\n    this.pdfUrl = null;\n\n    // Wire up timeline to render\n    this.timelineSync.subscribe((time) => {\n      this.strokeRenderer.render(time);\n    });\n\n    // Auto-load PDF if provided\n    if (config.pdfUrl) {\n      this.loadPDF(config.pdfUrl).catch(err => {\n        console.error('AnnotationRenderer: Failed to auto-load PDF:', err);\n      });\n    }\n  }\n\n  /**\n   * Create stroke canvas overlay\n   *\n   * @private\n   * @returns {HTMLCanvasElement} Stroke canvas element\n   */\n  _createStrokeCanvas() {\n    const canvas = document.createElement('canvas');\n    canvas.className = 'stroke-canvas';\n    canvas.style.position = 'absolute';\n    canvas.style.top = '0';\n    canvas.style.left = '0';\n    canvas.style.pointerEvents = 'none';\n    canvas.style.zIndex = '10';\n    this.container.appendChild(canvas);\n    return canvas;\n  }\n\n  /**\n   * Load PDF document from URL\n   *\n   * @param {string} url - URL or path to PDF file\n   * @returns {Promise<Object>} Load result with success status and page count\n   */\n  async loadPDF(url) {\n    try {\n      if (!url || typeof url !== 'string') {\n        return { success: false, error: 'Invalid PDF URL provided' };\n      }\n\n      const result = await this.pdfRenderer.loadDocument(url);\n\n      if (result.success) {\n        this.pdfUrl = url;\n        this.pageCount = result.pageCount;\n        return { success: true, pageCount: result.pageCount };\n      }\n\n      return result;\n    } catch (err) {\n      console.error('AnnotationRenderer.loadPDF: Error loading PDF:', err);\n      return { success: false, error: `Failed to load PDF: ${err.message}` };\n    }\n  }\n\n  /**\n   * Navigate to specific page and render it\n   *\n   * @param {number} pageNum - Page number (1-indexed)\n   * @returns {Promise<Object>} Render result with viewport information\n   */\n  async setPage(pageNum) {\n    try {\n      if (typeof pageNum !== 'number' || pageNum < 1) {\n        return { success: false, error: 'Invalid page number' };\n      }\n\n      if (this.pageCount > 0 && pageNum > this.pageCount) {\n        return { success: false, error: `Page ${pageNum} exceeds document page count (${this.pageCount})` };\n      }\n\n      this.pdfRenderer.cancelRender();\n\n      const result = await this.pdfRenderer.renderPage(\n        pageNum,\n        this.canvasElement,\n        this.currentScale\n      );\n\n      if (result.success) {\n        this.currentPage = pageNum;\n        this.currentViewport = result.viewport;\n\n        // Update StrokeRenderer viewport\n        this.strokeRenderer.setViewport(result.viewport.width, result.viewport.height);\n\n        // Re-set annotations for new page\n        this.strokeRenderer.setAnnotations(this.annotations, pageNum);\n\n        // Render at current time\n        const currentTime = this.timelineSync.getCurrentTime();\n        this.strokeRenderer.render(currentTime);\n\n        return { success: true, viewport: result.viewport };\n      }\n\n      return result;\n    } catch (err) {\n      console.error('AnnotationRenderer.setPage: Error rendering page:', err);\n      return { success: false, error: `Failed to render page: ${err.message}` };\n    }\n  }\n\n  /**\n   * Change zoom scale and re-render current page\n   *\n   * @param {number} scale - Scale factor (e.g., 1.0, 1.5, 2.0)\n   * @returns {Promise<Object>} Render result with viewport information\n   */\n  async setScale(scale) {\n    try {\n      if (typeof scale !== 'number' || scale <= 0) {\n        return { success: false, error: 'Invalid scale value (must be positive number)' };\n      }\n\n      this.currentScale = scale;\n      return await this.setPage(this.currentPage);\n    } catch (err) {\n      console.error('AnnotationRenderer.setScale: Error changing scale:', err);\n      return { success: false, error: `Failed to change scale: ${err.message}` };\n    }\n  }\n\n  /**\n   * Update annotation data for rendering\n   *\n   * @param {Array} annotations - Complete annotation array (all pages, all types)\n   */\n  setAnnotations(annotations) {\n    if (!Array.isArray(annotations)) {\n      console.warn('AnnotationRenderer.setAnnotations: annotations must be an array');\n      annotations = [];\n    }\n\n    this.annotations = annotations;\n    this.strokeRenderer.setAnnotations(annotations, this.currentPage);\n\n    // Render at current time\n    const currentTime = this.timelineSync.getCurrentTime();\n    this.strokeRenderer.render(currentTime);\n  }\n\n  /**\n   * Set pre-converted strokes directly\n   *\n   * Bypasses annotation conversion, useful for stroke commands from backend.\n   *\n   * @param {Array} strokes - Array of stroke command objects\n   */\n  setStrokes(strokes) {\n    this.strokeRenderer.setStrokes(strokes);\n\n    const currentTime = this.timelineSync.getCurrentTime();\n    this.strokeRenderer.render(currentTime);\n  }\n\n  /**\n   * Update timeline position for animation\n   *\n   * @param {number} timestamp - Current timeline position in seconds\n   */\n  setTime(timestamp) {\n    if (typeof timestamp !== 'number') {\n      console.warn('AnnotationRenderer.setTime: timestamp must be a number');\n      return;\n    }\n\n    this.timelineSync.setTime(timestamp);\n  }\n\n  /**\n   * Start continuous timeline synchronization using requestAnimationFrame\n   *\n   * Polls the provided function at ~60fps for smooth animation.\n   * Use this for audio/video synchronization instead of setTime().\n   *\n   * @param {Function} getTimeFunction - Function that returns current time in seconds\n   * @example\n   * const audio = document.getElementById('audio');\n   * renderer.startContinuousSync(() => audio.currentTime);\n   */\n  startContinuousSync(getTimeFunction) {\n    this.timelineSync.startContinuousSync(getTimeFunction);\n  }\n\n  /**\n   * Stop continuous timeline synchronization\n   *\n   * Call this when audio/video stops or component unmounts.\n   */\n  stopContinuousSync() {\n    this.timelineSync.stopContinuousSync();\n  }\n\n  /**\n   * Check if continuous sync is currently active\n   *\n   * @returns {boolean} True if continuous sync is running\n   */\n  isContinuousSyncActive() {\n    return this.timelineSync.isRunning;\n  }\n\n  /**\n   * Update stroke rendering configuration at runtime\n   *\n   * Merges new config with existing and re-renders annotations.\n   * Used for live preview of pen style changes.\n   *\n   * @param {Object} newConfig - New stroke configuration to merge\n   */\n  updateStrokeConfig(newConfig) {\n    if (!newConfig || typeof newConfig !== 'object') {\n      return;\n    }\n\n    // Merge new config into existing\n    this.strokeRenderer.config = deepMerge(this.strokeRenderer.config, newConfig);\n\n    // Re-convert annotations with new style and render\n    this.strokeRenderer.setAnnotations(this.annotations, this.currentPage);\n    const currentTime = this.timelineSync.getCurrentTime();\n    this.strokeRenderer.render(currentTime);\n  }\n\n  /**\n   * Get current engine state snapshot\n   *\n   * @returns {Object} Current state\n   */\n  getState() {\n    return {\n      page: this.currentPage,\n      scale: this.currentScale,\n      annotations: this.annotations,\n      pageCount: this.pageCount,\n      time: this.timelineSync.getCurrentTime(),\n      viewport: this.currentViewport,\n      pdfUrl: this.pdfUrl\n    };\n  }\n\n  /**\n   * Clean up all resources and subsystems\n   */\n  destroy() {\n    if (this.pdfRenderer) {\n      this.pdfRenderer.destroy();\n    }\n\n    if (this.strokeRenderer) {\n      this.strokeRenderer.destroy();\n    }\n\n    if (this.timelineSync) {\n      this.timelineSync.destroy();\n    }\n\n    if (this.strokeCanvas && this.strokeCanvas.parentNode) {\n      this.strokeCanvas.parentNode.removeChild(this.strokeCanvas);\n    }\n\n    this.pdfRenderer = null;\n    this.strokeRenderer = null;\n    this.timelineSync = null;\n    this.strokeCanvas = null;\n    this.config = null;\n    this.canvasElement = null;\n    this.container = null;\n    this.annotations = [];\n    this.currentPage = 0;\n    this.currentScale = 1.0;\n    this.pageCount = 0;\n    this.currentViewport = null;\n    this.pdfUrl = null;\n  }\n}\n"],"names":["AnnotationRenderer","config","PDFRenderer","StrokeRenderer","TimelineSync","time","err","canvas","url","result","pageNum","currentTime","scale","annotations","strokes","timestamp","getTimeFunction","newConfig","deepMerge"],"mappings":"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"}

package/dist/index20.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("./index22.cjs");function w(e){if(!e.strokes||!Array.isArray(e.strokes)||e.strokes.length===0)throw new Error("Ink annotation requires at least one stroke");if(!e.page||typeof e.page!="number"||e.page<1)throw new Error("Ink annotation requires a valid page number (>= 1)");if(!e.sentence_ref||typeof e.sentence_ref!="string")throw new Error("Ink annotation requires a sentence_ref for timing");return e.strokes.forEach((r,o)=>{if(typeof r!="object"||r===null||Array.isArray(r))throw new Error(`Stroke at index ${o} must be an object with {color, size, points} properties`);if(!r.points||!Array.isArray(r.points)||r.points.length<2)throw new Error(`Stroke at index ${o} must have at least 2 points`);r.points.forEach((t,n)=>{if(typeof t!="object"||t===null)throw new Error(`Point at stroke[${o}][${n}] must be an object with {t, x, y} properties`);const a=["t","x","y"];for(const s of a)if(typeof t[s]!="number")throw new Error(`Point at stroke[${o}][${n}] is missing required property '${s}' or it's not a number`);if(t.t<0)throw new Error(`Point time offset (t) at stroke[${o}][${n}] must be >= 0 (got ${t.t})`);if(t.x<0||t.x>1)throw new Error(`Point x coordinate at stroke[${o}][${n}] must be between 0 and 1 (got ${t.x})`);if(t.y<0||t.y>1)throw new Error(`Point y coordinate at stroke[${o}][${n}] must be between 0 and 1 (got ${t.y})`)});const i=r.size||3;if(i<1||i>10)throw new Error(`Stroke size at index ${o} must be between 1 and 10 pixels (got ${i})`)}),{id:f.generateId("ink"),type:"ink",page:e.page,strokes:e.strokes.map(r=>({color:r.color||"#1f2937",size:r.size||3,points:r.points})),sentence_ref:e.sentence_ref}}exports.createInk=w;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./index24.cjs");function h(e){if(!e.quads||!Array.isArray(e.quads)||e.quads.length===0)throw new Error("Highlight annotation requires at least one quad");if(!e.page||typeof e.page!="number"||e.page<1)throw new Error("Highlight annotation requires a valid page number (>= 1)");if(!e.sentence_ref||typeof e.sentence_ref!="string")throw new Error("Highlight annotation requires a sentence_ref for timing");e.quads.forEach((r,o)=>{if(typeof r!="object"||r===null||Array.isArray(r))throw new Error(`Quad at index ${o} must be an object with {x, y, w, h} properties`);const i=["x","y","w","h"];for(const t of i){if(typeof r[t]!="number")throw new Error(`Quad at index ${o} is missing required property '${t}' or it's not a number`);if(r[t]<0||r[t]>1)throw new Error(`Quad property '${t}' at index ${o} must be between 0 and 1 (got ${r[t]})`)}});const n=e.color||"rgba(255, 255, 0, 0.3)";return{id:a.generateId("highlight"),type:"highlight",mode:"quads",page:e.page,quads:e.quads,style:{color:n},sentence_ref:e.sentence_ref}}exports.createHighlight=h;
 //# sourceMappingURL=index20.cjs.map

package/dist/index20.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index20.cjs","sources":["../src/ai-tools/creators/createInk.js"],"sourcesContent":["/**\n * Ink Annotation Creator\n *\n * Converts AI-generated tool call arguments into valid ink/drawing annotation objects\n * compatible with web-annotation-renderer library format.\n *\n * @module ai-tools/creators/createInk\n */\n\nimport { generateId } from '../../utils/idGenerator.js';\n\n/**\n * Create an ink (drawing) annotation from tool call arguments\n *\n * @param {Object} args - Tool call arguments from AI\n * @param {Array<Object>} args.strokes - Array of stroke objects with color, size, and points\n * @param {number} args.page - Page number (1-indexed)\n * @param {string} args.sentence_ref - Sentence reference for timing (e.g., 'S1')\n * @returns {Object} Valid ink annotation object\n * @example\n * ```javascript\n * const drawing = createInk({\n *   strokes: [\n *     {\n *       color: '#FF0000',\n *       size: 2,\n *       points: [\n *         {t: 0, x: 0.1, y: 0.1},\n *         {t: 0.5, x: 0.2, y: 0.2}\n *       ]\n *     }\n *   ],\n *   page: 1,\n *   sentence_ref: 'S4'\n * });\n * ```\n */\nexport function createInk(args) {\n  // Validate required fields\n  if (!args.strokes || !Array.isArray(args.strokes) || args.strokes.length === 0) {\n    throw new Error('Ink annotation requires at least one stroke');\n  }\n\n  if (!args.page || typeof args.page !== 'number' || args.page < 1) {\n    throw new Error('Ink annotation requires a valid page number (>= 1)');\n  }\n\n  if (!args.sentence_ref || typeof args.sentence_ref !== 'string') {\n    throw new Error('Ink annotation requires a sentence_ref for timing');\n  }\n\n  // Validate stroke format - each stroke must be an object\n  args.strokes.forEach((stroke, index) => {\n    if (typeof stroke !== 'object' || stroke === null || Array.isArray(stroke)) {\n      throw new Error(`Stroke at index ${index} must be an object with {color, size, points} properties`);\n    }\n\n    // Validate points array\n    if (!stroke.points || !Array.isArray(stroke.points) || stroke.points.length < 2) {\n      throw new Error(`Stroke at index ${index} must have at least 2 points`);\n    }\n\n    // Validate each point\n    stroke.points.forEach((point, pointIndex) => {\n      if (typeof point !== 'object' || point === null) {\n        throw new Error(`Point at stroke[${index}][${pointIndex}] must be an object with {t, x, y} properties`);\n      }\n\n      const requiredProps = ['t', 'x', 'y'];\n      for (const prop of requiredProps) {\n        if (typeof point[prop] !== 'number') {\n          throw new Error(`Point at stroke[${index}][${pointIndex}] is missing required property '${prop}' or it's not a number`);\n        }\n      }\n\n      // Validate time offset (t >= 0)\n      if (point.t < 0) {\n        throw new Error(`Point time offset (t) at stroke[${index}][${pointIndex}] must be >= 0 (got ${point.t})`);\n      }\n\n      // Validate x and y coordinates (0-1)\n      if (point.x < 0 || point.x > 1) {\n        throw new Error(`Point x coordinate at stroke[${index}][${pointIndex}] must be between 0 and 1 (got ${point.x})`);\n      }\n      if (point.y < 0 || point.y > 1) {\n        throw new Error(`Point y coordinate at stroke[${index}][${pointIndex}] must be between 0 and 1 (got ${point.y})`);\n      }\n    });\n\n    // Validate size\n    const size = stroke.size || 3;\n    if (size < 1 || size > 10) {\n      throw new Error(`Stroke size at index ${index} must be between 1 and 10 pixels (got ${size})`);\n    }\n  });\n\n  // Create annotation object matching library format\n  return {\n    id: generateId('ink'),\n    type: 'ink',\n    page: args.page,\n    strokes: args.strokes.map(stroke => ({\n      color: stroke.color || '#1f2937',    // Default dark gray\n      size: stroke.size || 3,               // Default 3px\n      points: stroke.points                 // Array of {t, x, y} objects\n    })),\n    sentence_ref: args.sentence_ref,\n    // Note: start/end will be added during timing sync phase\n  };\n}\n"],"names":["createInk","args","stroke","index","point","pointIndex","requiredProps","prop","size","generateId"],"mappings":"iHAqCO,SAASA,EAAUC,EAAM,CAE9B,GAAI,CAACA,EAAK,SAAW,CAAC,MAAM,QAAQA,EAAK,OAAO,GAAKA,EAAK,QAAQ,SAAW,EAC3E,MAAM,IAAI,MAAM,6CAA6C,EAG/D,GAAI,CAACA,EAAK,MAAQ,OAAOA,EAAK,MAAS,UAAYA,EAAK,KAAO,EAC7D,MAAM,IAAI,MAAM,oDAAoD,EAGtE,GAAI,CAACA,EAAK,cAAgB,OAAOA,EAAK,cAAiB,SACrD,MAAM,IAAI,MAAM,mDAAmD,EAIrE,OAAAA,EAAK,QAAQ,QAAQ,CAACC,EAAQC,IAAU,CACtC,GAAI,OAAOD,GAAW,UAAYA,IAAW,MAAQ,MAAM,QAAQA,CAAM,EACvE,MAAM,IAAI,MAAM,mBAAmBC,CAAK,0DAA0D,EAIpG,GAAI,CAACD,EAAO,QAAU,CAAC,MAAM,QAAQA,EAAO,MAAM,GAAKA,EAAO,OAAO,OAAS,EAC5E,MAAM,IAAI,MAAM,mBAAmBC,CAAK,8BAA8B,EAIxED,EAAO,OAAO,QAAQ,CAACE,EAAOC,IAAe,CAC3C,GAAI,OAAOD,GAAU,UAAYA,IAAU,KACzC,MAAM,IAAI,MAAM,mBAAmBD,CAAK,KAAKE,CAAU,+CAA+C,EAGxG,MAAMC,EAAgB,CAAC,IAAK,IAAK,GAAG,EACpC,UAAWC,KAAQD,EACjB,GAAI,OAAOF,EAAMG,CAAI,GAAM,SACzB,MAAM,IAAI,MAAM,mBAAmBJ,CAAK,KAAKE,CAAU,mCAAmCE,CAAI,wBAAwB,EAK1H,GAAIH,EAAM,EAAI,EACZ,MAAM,IAAI,MAAM,mCAAmCD,CAAK,KAAKE,CAAU,uBAAuBD,EAAM,CAAC,GAAG,EAI1G,GAAIA,EAAM,EAAI,GAAKA,EAAM,EAAI,EAC3B,MAAM,IAAI,MAAM,gCAAgCD,CAAK,KAAKE,CAAU,kCAAkCD,EAAM,CAAC,GAAG,EAElH,GAAIA,EAAM,EAAI,GAAKA,EAAM,EAAI,EAC3B,MAAM,IAAI,MAAM,gCAAgCD,CAAK,KAAKE,CAAU,kCAAkCD,EAAM,CAAC,GAAG,CAEpH,CAAC,EAGD,MAAMI,EAAON,EAAO,MAAQ,EAC5B,GAAIM,EAAO,GAAKA,EAAO,GACrB,MAAM,IAAI,MAAM,wBAAwBL,CAAK,yCAAyCK,CAAI,GAAG,CAEjG,CAAC,EAGM,CACL,GAAIC,EAAAA,WAAW,KAAK,EACpB,KAAM,MACN,KAAMR,EAAK,KACX,QAASA,EAAK,QAAQ,IAAIC,IAAW,CACnC,MAAOA,EAAO,OAAS,UACvB,KAAMA,EAAO,MAAQ,EACrB,OAAQA,EAAO,MACrB,EAAM,EACF,aAAcD,EAAK,YAEvB,CACA"}
+{"version":3,"file":"index20.cjs","sources":["../src/ai-tools/creators/createHighlight.js"],"sourcesContent":["/**\n * Highlight Annotation Creator\n *\n * Converts AI-generated tool call arguments into valid highlight annotation objects\n * compatible with web-annotation-renderer library format.\n *\n * @module ai-tools/creators/createHighlight\n */\n\nimport { generateId } from '../../utils/idGenerator.js';\n\n/**\n * Create a highlight annotation from tool call arguments\n *\n * @param {Object} args - Tool call arguments from AI\n * @param {Array<Object>} args.quads - Rectangle objects with {x, y, w, h} (normalized 0-1)\n * @param {string} [args.color='rgba(255, 255, 0, 0.3)'] - Highlight color in rgba format\n * @param {number} args.page - Page number (1-indexed)\n * @param {string} args.sentence_ref - Sentence reference for timing (e.g., 'S1')\n * @returns {Object} Valid highlight annotation object\n * @example\n * ```javascript\n * const highlight = createHighlight({\n *   quads: [{x: 0.1, y: 0.2, w: 0.8, h: 0.05}],\n *   color: 'rgba(255, 255, 0, 0.3)',\n *   page: 1,\n *   sentence_ref: 'S2'\n * });\n * ```\n */\nexport function createHighlight(args) {\n  // Validate required fields\n  if (!args.quads || !Array.isArray(args.quads) || args.quads.length === 0) {\n    throw new Error('Highlight annotation requires at least one quad');\n  }\n\n  if (!args.page || typeof args.page !== 'number' || args.page < 1) {\n    throw new Error('Highlight annotation requires a valid page number (>= 1)');\n  }\n\n  if (!args.sentence_ref || typeof args.sentence_ref !== 'string') {\n    throw new Error('Highlight annotation requires a sentence_ref for timing');\n  }\n\n  // Validate quad format - each quad must be an object with {x, y, w, h}\n  args.quads.forEach((quad, index) => {\n    if (typeof quad !== 'object' || quad === null || Array.isArray(quad)) {\n      throw new Error(`Quad at index ${index} must be an object with {x, y, w, h} properties`);\n    }\n\n    const requiredProps = ['x', 'y', 'w', 'h'];\n    for (const prop of requiredProps) {\n      if (typeof quad[prop] !== 'number') {\n        throw new Error(`Quad at index ${index} is missing required property '${prop}' or it's not a number`);\n      }\n      if (quad[prop] < 0 || quad[prop] > 1) {\n        throw new Error(`Quad property '${prop}' at index ${index} must be between 0 and 1 (got ${quad[prop]})`);\n      }\n    }\n  });\n\n  // Validate color format (should be rgba)\n  const color = args.color || 'rgba(255, 255, 0, 0.3)';\n\n  // Create annotation object matching library format\n  return {\n    id: generateId('highlight'),\n    type: 'highlight',\n    mode: 'quads',           // Required by HighlightLayer\n    page: args.page,\n    quads: args.quads,       // Array of {x, y, w, h} objects\n    style: {\n      color: color           // Color wrapped in style object\n    },\n    sentence_ref: args.sentence_ref,\n    // Note: start/end will be added during timing sync phase\n  };\n}\n"],"names":["createHighlight","args","quad","index","requiredProps","prop","color","generateId"],"mappings":"iHA8BO,SAASA,EAAgBC,EAAM,CAEpC,GAAI,CAACA,EAAK,OAAS,CAAC,MAAM,QAAQA,EAAK,KAAK,GAAKA,EAAK,MAAM,SAAW,EACrE,MAAM,IAAI,MAAM,iDAAiD,EAGnE,GAAI,CAACA,EAAK,MAAQ,OAAOA,EAAK,MAAS,UAAYA,EAAK,KAAO,EAC7D,MAAM,IAAI,MAAM,0DAA0D,EAG5E,GAAI,CAACA,EAAK,cAAgB,OAAOA,EAAK,cAAiB,SACrD,MAAM,IAAI,MAAM,yDAAyD,EAI3EA,EAAK,MAAM,QAAQ,CAACC,EAAMC,IAAU,CAClC,GAAI,OAAOD,GAAS,UAAYA,IAAS,MAAQ,MAAM,QAAQA,CAAI,EACjE,MAAM,IAAI,MAAM,iBAAiBC,CAAK,iDAAiD,EAGzF,MAAMC,EAAgB,CAAC,IAAK,IAAK,IAAK,GAAG,EACzC,UAAWC,KAAQD,EAAe,CAChC,GAAI,OAAOF,EAAKG,CAAI,GAAM,SACxB,MAAM,IAAI,MAAM,iBAAiBF,CAAK,kCAAkCE,CAAI,wBAAwB,EAEtG,GAAIH,EAAKG,CAAI,EAAI,GAAKH,EAAKG,CAAI,EAAI,EACjC,MAAM,IAAI,MAAM,kBAAkBA,CAAI,cAAcF,CAAK,iCAAiCD,EAAKG,CAAI,CAAC,GAAG,CAE3G,CACF,CAAC,EAGD,MAAMC,EAAQL,EAAK,OAAS,yBAG5B,MAAO,CACL,GAAIM,EAAAA,WAAW,WAAW,EAC1B,KAAM,YACN,KAAM,QACN,KAAMN,EAAK,KACX,MAAOA,EAAK,MACZ,MAAO,CACL,MAAOK,CACb,EACI,aAAcL,EAAK,YAEvB,CACA"}

package/dist/index20.js

@@ -1,50 +1,40 @@
-import { generateId as f } from "./index22.js";
-function c(e) {
-  if (!e.strokes || !Array.isArray(e.strokes) || e.strokes.length === 0)
-    throw new Error("Ink annotation requires at least one stroke");
+import { generateId as h } from "./index24.js";
+function p(e) {
+  if (!e.quads || !Array.isArray(e.quads) || e.quads.length === 0)
+    throw new Error("Highlight annotation requires at least one quad");
   if (!e.page || typeof e.page != "number" || e.page < 1)
-    throw new Error("Ink annotation requires a valid page number (>= 1)");
+    throw new Error("Highlight annotation requires a valid page number (>= 1)");
   if (!e.sentence_ref || typeof e.sentence_ref != "string")
-    throw new Error("Ink annotation requires a sentence_ref for timing");
-  return e.strokes.forEach((r, o) => {
+    throw new Error("Highlight annotation requires a sentence_ref for timing");
+  e.quads.forEach((r, o) => {
     if (typeof r != "object" || r === null || Array.isArray(r))
-      throw new Error(`Stroke at index ${o} must be an object with {color, size, points} properties`);
-    if (!r.points || !Array.isArray(r.points) || r.points.length < 2)
-      throw new Error(`Stroke at index ${o} must have at least 2 points`);
-    r.points.forEach((t, n) => {
-      if (typeof t != "object" || t === null)
-        throw new Error(`Point at stroke[${o}][${n}] must be an object with {t, x, y} properties`);
-      const a = ["t", "x", "y"];
-      for (const i of a)
-        if (typeof t[i] != "number")
-          throw new Error(`Point at stroke[${o}][${n}] is missing required property '${i}' or it's not a number`);
-      if (t.t < 0)
-        throw new Error(`Point time offset (t) at stroke[${o}][${n}] must be >= 0 (got ${t.t})`);
-      if (t.x < 0 || t.x > 1)
-        throw new Error(`Point x coordinate at stroke[${o}][${n}] must be between 0 and 1 (got ${t.x})`);
-      if (t.y < 0 || t.y > 1)
-        throw new Error(`Point y coordinate at stroke[${o}][${n}] must be between 0 and 1 (got ${t.y})`);
-    });
-    const s = r.size || 3;
-    if (s < 1 || s > 10)
-      throw new Error(`Stroke size at index ${o} must be between 1 and 10 pixels (got ${s})`);
-  }), {
-    id: f("ink"),
-    type: "ink",
+      throw new Error(`Quad at index ${o} must be an object with {x, y, w, h} properties`);
+    const i = ["x", "y", "w", "h"];
+    for (const t of i) {
+      if (typeof r[t] != "number")
+        throw new Error(`Quad at index ${o} is missing required property '${t}' or it's not a number`);
+      if (r[t] < 0 || r[t] > 1)
+        throw new Error(`Quad property '${t}' at index ${o} must be between 0 and 1 (got ${r[t]})`);
+    }
+  });
+  const n = e.color || "rgba(255, 255, 0, 0.3)";
+  return {
+    id: h("highlight"),
+    type: "highlight",
+    mode: "quads",
+    // Required by HighlightLayer
     page: e.page,
-    strokes: e.strokes.map((r) => ({
-      color: r.color || "#1f2937",
-      // Default dark gray
-      size: r.size || 3,
-      // Default 3px
-      points: r.points
-      // Array of {t, x, y} objects
-    })),
+    quads: e.quads,
+    // Array of {x, y, w, h} objects
+    style: {
+      color: n
+      // Color wrapped in style object
+    },
     sentence_ref: e.sentence_ref
     // Note: start/end will be added during timing sync phase
   };
 }
 export {
-  c as createInk
+  p as createHighlight
 };
 //# sourceMappingURL=index20.js.map

package/dist/index20.js.map

@@ -1 +1 @@
-{"version":3,"file":"index20.js","sources":["../src/ai-tools/creators/createInk.js"],"sourcesContent":["/**\n * Ink Annotation Creator\n *\n * Converts AI-generated tool call arguments into valid ink/drawing annotation objects\n * compatible with web-annotation-renderer library format.\n *\n * @module ai-tools/creators/createInk\n */\n\nimport { generateId } from '../../utils/idGenerator.js';\n\n/**\n * Create an ink (drawing) annotation from tool call arguments\n *\n * @param {Object} args - Tool call arguments from AI\n * @param {Array<Object>} args.strokes - Array of stroke objects with color, size, and points\n * @param {number} args.page - Page number (1-indexed)\n * @param {string} args.sentence_ref - Sentence reference for timing (e.g., 'S1')\n * @returns {Object} Valid ink annotation object\n * @example\n * ```javascript\n * const drawing = createInk({\n *   strokes: [\n *     {\n *       color: '#FF0000',\n *       size: 2,\n *       points: [\n *         {t: 0, x: 0.1, y: 0.1},\n *         {t: 0.5, x: 0.2, y: 0.2}\n *       ]\n *     }\n *   ],\n *   page: 1,\n *   sentence_ref: 'S4'\n * });\n * ```\n */\nexport function createInk(args) {\n  // Validate required fields\n  if (!args.strokes || !Array.isArray(args.strokes) || args.strokes.length === 0) {\n    throw new Error('Ink annotation requires at least one stroke');\n  }\n\n  if (!args.page || typeof args.page !== 'number' || args.page < 1) {\n    throw new Error('Ink annotation requires a valid page number (>= 1)');\n  }\n\n  if (!args.sentence_ref || typeof args.sentence_ref !== 'string') {\n    throw new Error('Ink annotation requires a sentence_ref for timing');\n  }\n\n  // Validate stroke format - each stroke must be an object\n  args.strokes.forEach((stroke, index) => {\n    if (typeof stroke !== 'object' || stroke === null || Array.isArray(stroke)) {\n      throw new Error(`Stroke at index ${index} must be an object with {color, size, points} properties`);\n    }\n\n    // Validate points array\n    if (!stroke.points || !Array.isArray(stroke.points) || stroke.points.length < 2) {\n      throw new Error(`Stroke at index ${index} must have at least 2 points`);\n    }\n\n    // Validate each point\n    stroke.points.forEach((point, pointIndex) => {\n      if (typeof point !== 'object' || point === null) {\n        throw new Error(`Point at stroke[${index}][${pointIndex}] must be an object with {t, x, y} properties`);\n      }\n\n      const requiredProps = ['t', 'x', 'y'];\n      for (const prop of requiredProps) {\n        if (typeof point[prop] !== 'number') {\n          throw new Error(`Point at stroke[${index}][${pointIndex}] is missing required property '${prop}' or it's not a number`);\n        }\n      }\n\n      // Validate time offset (t >= 0)\n      if (point.t < 0) {\n        throw new Error(`Point time offset (t) at stroke[${index}][${pointIndex}] must be >= 0 (got ${point.t})`);\n      }\n\n      // Validate x and y coordinates (0-1)\n      if (point.x < 0 || point.x > 1) {\n        throw new Error(`Point x coordinate at stroke[${index}][${pointIndex}] must be between 0 and 1 (got ${point.x})`);\n      }\n      if (point.y < 0 || point.y > 1) {\n        throw new Error(`Point y coordinate at stroke[${index}][${pointIndex}] must be between 0 and 1 (got ${point.y})`);\n      }\n    });\n\n    // Validate size\n    const size = stroke.size || 3;\n    if (size < 1 || size > 10) {\n      throw new Error(`Stroke size at index ${index} must be between 1 and 10 pixels (got ${size})`);\n    }\n  });\n\n  // Create annotation object matching library format\n  return {\n    id: generateId('ink'),\n    type: 'ink',\n    page: args.page,\n    strokes: args.strokes.map(stroke => ({\n      color: stroke.color || '#1f2937',    // Default dark gray\n      size: stroke.size || 3,               // Default 3px\n      points: stroke.points                 // Array of {t, x, y} objects\n    })),\n    sentence_ref: args.sentence_ref,\n    // Note: start/end will be added during timing sync phase\n  };\n}\n"],"names":["createInk","args","stroke","index","point","pointIndex","requiredProps","prop","size","generateId"],"mappings":";AAqCO,SAASA,EAAUC,GAAM;AAE9B,MAAI,CAACA,EAAK,WAAW,CAAC,MAAM,QAAQA,EAAK,OAAO,KAAKA,EAAK,QAAQ,WAAW;AAC3E,UAAM,IAAI,MAAM,6CAA6C;AAG/D,MAAI,CAACA,EAAK,QAAQ,OAAOA,EAAK,QAAS,YAAYA,EAAK,OAAO;AAC7D,UAAM,IAAI,MAAM,oDAAoD;AAGtE,MAAI,CAACA,EAAK,gBAAgB,OAAOA,EAAK,gBAAiB;AACrD,UAAM,IAAI,MAAM,mDAAmD;AAIrE,SAAAA,EAAK,QAAQ,QAAQ,CAACC,GAAQC,MAAU;AACtC,QAAI,OAAOD,KAAW,YAAYA,MAAW,QAAQ,MAAM,QAAQA,CAAM;AACvE,YAAM,IAAI,MAAM,mBAAmBC,CAAK,0DAA0D;AAIpG,QAAI,CAACD,EAAO,UAAU,CAAC,MAAM,QAAQA,EAAO,MAAM,KAAKA,EAAO,OAAO,SAAS;AAC5E,YAAM,IAAI,MAAM,mBAAmBC,CAAK,8BAA8B;AAIxE,IAAAD,EAAO,OAAO,QAAQ,CAACE,GAAOC,MAAe;AAC3C,UAAI,OAAOD,KAAU,YAAYA,MAAU;AACzC,cAAM,IAAI,MAAM,mBAAmBD,CAAK,KAAKE,CAAU,+CAA+C;AAGxG,YAAMC,IAAgB,CAAC,KAAK,KAAK,GAAG;AACpC,iBAAWC,KAAQD;AACjB,YAAI,OAAOF,EAAMG,CAAI,KAAM;AACzB,gBAAM,IAAI,MAAM,mBAAmBJ,CAAK,KAAKE,CAAU,mCAAmCE,CAAI,wBAAwB;AAK1H,UAAIH,EAAM,IAAI;AACZ,cAAM,IAAI,MAAM,mCAAmCD,CAAK,KAAKE,CAAU,uBAAuBD,EAAM,CAAC,GAAG;AAI1G,UAAIA,EAAM,IAAI,KAAKA,EAAM,IAAI;AAC3B,cAAM,IAAI,MAAM,gCAAgCD,CAAK,KAAKE,CAAU,kCAAkCD,EAAM,CAAC,GAAG;AAElH,UAAIA,EAAM,IAAI,KAAKA,EAAM,IAAI;AAC3B,cAAM,IAAI,MAAM,gCAAgCD,CAAK,KAAKE,CAAU,kCAAkCD,EAAM,CAAC,GAAG;AAAA,IAEpH,CAAC;AAGD,UAAMI,IAAON,EAAO,QAAQ;AAC5B,QAAIM,IAAO,KAAKA,IAAO;AACrB,YAAM,IAAI,MAAM,wBAAwBL,CAAK,yCAAyCK,CAAI,GAAG;AAAA,EAEjG,CAAC,GAGM;AAAA,IACL,IAAIC,EAAW,KAAK;AAAA,IACpB,MAAM;AAAA,IACN,MAAMR,EAAK;AAAA,IACX,SAASA,EAAK,QAAQ,IAAI,CAAAC,OAAW;AAAA,MACnC,OAAOA,EAAO,SAAS;AAAA;AAAA,MACvB,MAAMA,EAAO,QAAQ;AAAA;AAAA,MACrB,QAAQA,EAAO;AAAA;AAAA,IACrB,EAAM;AAAA,IACF,cAAcD,EAAK;AAAA;AAAA,EAEvB;AACA;"}
+{"version":3,"file":"index20.js","sources":["../src/ai-tools/creators/createHighlight.js"],"sourcesContent":["/**\n * Highlight Annotation Creator\n *\n * Converts AI-generated tool call arguments into valid highlight annotation objects\n * compatible with web-annotation-renderer library format.\n *\n * @module ai-tools/creators/createHighlight\n */\n\nimport { generateId } from '../../utils/idGenerator.js';\n\n/**\n * Create a highlight annotation from tool call arguments\n *\n * @param {Object} args - Tool call arguments from AI\n * @param {Array<Object>} args.quads - Rectangle objects with {x, y, w, h} (normalized 0-1)\n * @param {string} [args.color='rgba(255, 255, 0, 0.3)'] - Highlight color in rgba format\n * @param {number} args.page - Page number (1-indexed)\n * @param {string} args.sentence_ref - Sentence reference for timing (e.g., 'S1')\n * @returns {Object} Valid highlight annotation object\n * @example\n * ```javascript\n * const highlight = createHighlight({\n *   quads: [{x: 0.1, y: 0.2, w: 0.8, h: 0.05}],\n *   color: 'rgba(255, 255, 0, 0.3)',\n *   page: 1,\n *   sentence_ref: 'S2'\n * });\n * ```\n */\nexport function createHighlight(args) {\n  // Validate required fields\n  if (!args.quads || !Array.isArray(args.quads) || args.quads.length === 0) {\n    throw new Error('Highlight annotation requires at least one quad');\n  }\n\n  if (!args.page || typeof args.page !== 'number' || args.page < 1) {\n    throw new Error('Highlight annotation requires a valid page number (>= 1)');\n  }\n\n  if (!args.sentence_ref || typeof args.sentence_ref !== 'string') {\n    throw new Error('Highlight annotation requires a sentence_ref for timing');\n  }\n\n  // Validate quad format - each quad must be an object with {x, y, w, h}\n  args.quads.forEach((quad, index) => {\n    if (typeof quad !== 'object' || quad === null || Array.isArray(quad)) {\n      throw new Error(`Quad at index ${index} must be an object with {x, y, w, h} properties`);\n    }\n\n    const requiredProps = ['x', 'y', 'w', 'h'];\n    for (const prop of requiredProps) {\n      if (typeof quad[prop] !== 'number') {\n        throw new Error(`Quad at index ${index} is missing required property '${prop}' or it's not a number`);\n      }\n      if (quad[prop] < 0 || quad[prop] > 1) {\n        throw new Error(`Quad property '${prop}' at index ${index} must be between 0 and 1 (got ${quad[prop]})`);\n      }\n    }\n  });\n\n  // Validate color format (should be rgba)\n  const color = args.color || 'rgba(255, 255, 0, 0.3)';\n\n  // Create annotation object matching library format\n  return {\n    id: generateId('highlight'),\n    type: 'highlight',\n    mode: 'quads',           // Required by HighlightLayer\n    page: args.page,\n    quads: args.quads,       // Array of {x, y, w, h} objects\n    style: {\n      color: color           // Color wrapped in style object\n    },\n    sentence_ref: args.sentence_ref,\n    // Note: start/end will be added during timing sync phase\n  };\n}\n"],"names":["createHighlight","args","quad","index","requiredProps","prop","color","generateId"],"mappings":";AA8BO,SAASA,EAAgBC,GAAM;AAEpC,MAAI,CAACA,EAAK,SAAS,CAAC,MAAM,QAAQA,EAAK,KAAK,KAAKA,EAAK,MAAM,WAAW;AACrE,UAAM,IAAI,MAAM,iDAAiD;AAGnE,MAAI,CAACA,EAAK,QAAQ,OAAOA,EAAK,QAAS,YAAYA,EAAK,OAAO;AAC7D,UAAM,IAAI,MAAM,0DAA0D;AAG5E,MAAI,CAACA,EAAK,gBAAgB,OAAOA,EAAK,gBAAiB;AACrD,UAAM,IAAI,MAAM,yDAAyD;AAI3E,EAAAA,EAAK,MAAM,QAAQ,CAACC,GAAMC,MAAU;AAClC,QAAI,OAAOD,KAAS,YAAYA,MAAS,QAAQ,MAAM,QAAQA,CAAI;AACjE,YAAM,IAAI,MAAM,iBAAiBC,CAAK,iDAAiD;AAGzF,UAAMC,IAAgB,CAAC,KAAK,KAAK,KAAK,GAAG;AACzC,eAAWC,KAAQD,GAAe;AAChC,UAAI,OAAOF,EAAKG,CAAI,KAAM;AACxB,cAAM,IAAI,MAAM,iBAAiBF,CAAK,kCAAkCE,CAAI,wBAAwB;AAEtG,UAAIH,EAAKG,CAAI,IAAI,KAAKH,EAAKG,CAAI,IAAI;AACjC,cAAM,IAAI,MAAM,kBAAkBA,CAAI,cAAcF,CAAK,iCAAiCD,EAAKG,CAAI,CAAC,GAAG;AAAA,IAE3G;AAAA,EACF,CAAC;AAGD,QAAMC,IAAQL,EAAK,SAAS;AAG5B,SAAO;AAAA,IACL,IAAIM,EAAW,WAAW;AAAA,IAC1B,MAAM;AAAA,IACN,MAAM;AAAA;AAAA,IACN,MAAMN,EAAK;AAAA,IACX,OAAOA,EAAK;AAAA;AAAA,IACZ,OAAO;AAAA,MACL,OAAOK;AAAA;AAAA,IACb;AAAA,IACI,cAAcL,EAAK;AAAA;AAAA,EAEvB;AACA;"}

package/dist/index21.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t={page:1,start:0,end:0},o={mode:"quads",quads:[{x:.1,y:.1,w:.8,h:.05}],style:{color:"rgba(255, 255, 0, 0.3)"}},e={content:"[No content]",x:.1,y:.1,w:.3,h:.1,style:{bg:"rgba(255, 255, 255, 0.9)",color:"#000000"}},s={strokes:[{color:"#1f2937",size:3,points:[{t:0,x:.1,y:.1},{t:1,x:.2,y:.2}]}]};exports.BASE_DEFAULTS=t;exports.HIGHLIGHT_DEFAULTS=o;exports.INK_DEFAULTS=s;exports.TEXT_DEFAULTS=e;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./index24.cjs");function r(e){if(!e.content||typeof e.content!="string"||e.content.trim().length===0)throw new Error("Text annotation requires non-empty content");if(typeof e.x!="number"||e.x<0||e.x>1)throw new Error("Text annotation x position must be between 0 and 1");if(typeof e.y!="number"||e.y<0||e.y>1)throw new Error("Text annotation y position must be between 0 and 1");if(typeof e.w!="number"||e.w<0||e.w>1)throw new Error("Text annotation width (w) must be between 0 and 1");if(typeof e.h!="number"||e.h<0||e.h>1)throw new Error("Text annotation height (h) must be between 0 and 1");if(!e.page||typeof e.page!="number"||e.page<1)throw new Error("Text annotation requires a valid page number (>= 1)");if(!e.sentence_ref||typeof e.sentence_ref!="string")throw new Error("Text annotation requires a sentence_ref for timing");const t=e.textColor||"#1f2937",n=e.bgColor||"transparent";return{id:o.generateId("text"),type:"text",page:e.page,content:e.content.trim(),x:e.x,y:e.y,w:e.w,h:e.h,style:{bg:n,color:t},sentence_ref:e.sentence_ref}}exports.createText=r;
 //# sourceMappingURL=index21.cjs.map

package/dist/index21.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index21.cjs","sources":["../src/types/defaults.js"],"sourcesContent":["/**\n * Default Values for Annotation Normalization\n *\n * This module defines default values used when annotation fields are missing\n * or invalid. These defaults ensure annotations render visibly and safely.\n *\n * @module types/defaults\n */\n\n/**\n * Default values for base annotation fields (common to all types)\n *\n * @constant {Object}\n * @property {number} page - Default page number (first page)\n * @property {number} start - Default start time (display immediately)\n * @property {number} end - Default end time (static display, no animation)\n */\nexport const BASE_DEFAULTS = {\n  page: 1,\n  start: 0,\n  end: 0\n};\n\n/**\n * Default values for highlight annotations\n *\n * Creates a visible yellow highlight near the top of the page.\n *\n * @constant {Object}\n * @property {string} mode - Highlight mode (only 'quads' supported)\n * @property {Array<Object>} quads - Default rectangular regions\n * @property {Object} style - Default styling\n */\nexport const HIGHLIGHT_DEFAULTS = {\n  mode: 'quads',\n  quads: [{ x: 0.1, y: 0.1, w: 0.8, h: 0.05 }],\n  style: { color: 'rgba(255, 255, 0, 0.3)' }\n};\n\n/**\n * Default values for text annotations\n *\n * Creates a visible text box in the top-left with placeholder content.\n *\n * @constant {Object}\n * @property {string} content - Placeholder text\n * @property {number} x - Normalized x position (10% from left)\n * @property {number} y - Normalized y position (10% from top)\n * @property {number} w - Normalized width (30% of page width)\n * @property {number} h - Normalized height (10% of page height)\n * @property {Object} style - Default styling with white background and black text\n */\nexport const TEXT_DEFAULTS = {\n  content: '[No content]',\n  x: 0.1,\n  y: 0.1,\n  w: 0.3,\n  h: 0.1,\n  style: {\n    bg: 'rgba(255, 255, 255, 0.9)',\n    color: '#000000'\n  }\n};\n\n/**\n * Default values for ink annotations\n *\n * Creates a visible diagonal line in dark gray.\n *\n * @constant {Object}\n * @property {Array<Object>} strokes - Default stroke with two points\n */\nexport const INK_DEFAULTS = {\n  strokes: [{\n    color: '#1f2937',\n    size: 3,\n    points: [\n      { t: 0, x: 0.1, y: 0.1 },\n      { t: 1, x: 0.2, y: 0.2 }\n    ]\n  }]\n};\n"],"names":["BASE_DEFAULTS","HIGHLIGHT_DEFAULTS","TEXT_DEFAULTS","INK_DEFAULTS"],"mappings":"gFAiBY,MAACA,EAAgB,CAC3B,KAAM,EACN,MAAO,EACP,IAAK,CACP,EAYaC,EAAqB,CAChC,KAAM,QACN,MAAO,CAAC,CAAE,EAAG,GAAK,EAAG,GAAK,EAAG,GAAK,EAAG,IAAM,EAC3C,MAAO,CAAE,MAAO,wBAAwB,CAC1C,EAeaC,EAAgB,CAC3B,QAAS,eACT,EAAG,GACH,EAAG,GACH,EAAG,GACH,EAAG,GACH,MAAO,CACL,GAAI,2BACJ,MAAO,SACX,CACA,EAUaC,EAAe,CAC1B,QAAS,CAAC,CACR,MAAO,UACP,KAAM,EACN,OAAQ,CACN,CAAE,EAAG,EAAG,EAAG,GAAK,EAAG,EAAG,EACtB,CAAE,EAAG,EAAG,EAAG,GAAK,EAAG,EAAG,CAC5B,CACA,CAAG,CACH"}
+{"version":3,"file":"index21.cjs","sources":["../src/ai-tools/creators/createText.js"],"sourcesContent":["/**\n * Text Annotation Creator\n *\n * Converts AI-generated tool call arguments into valid text annotation objects\n * compatible with web-annotation-renderer library format.\n *\n * @module ai-tools/creators/createText\n */\n\nimport { generateId } from '../../utils/idGenerator.js';\n\n/**\n * Create a text annotation from tool call arguments\n *\n * @param {Object} args - Tool call arguments from AI\n * @param {string} args.content - Text content\n * @param {number} args.x - Horizontal position (0-1)\n * @param {number} args.y - Vertical position (0-1)\n * @param {number} args.w - Width (0-1)\n * @param {number} args.h - Height (0-1)\n * @param {number} args.page - Page number (1-indexed)\n * @param {string} [args.textColor='#1f2937'] - Text color in hex format\n * @param {string} [args.bgColor='transparent'] - Background color (transparent by default, or rgba format)\n * @param {string} args.sentence_ref - Sentence reference for timing (e.g., 'S1')\n * @returns {Object} Valid text annotation object\n * @example\n * ```javascript\n * const textNote = createText({\n *   content: 'This is important',\n *   x: 0.1,\n *   y: 0.5,\n *   w: 0.3,\n *   h: 0.1,\n *   page: 1,\n *   textColor: '#000000',\n *   bgColor: 'transparent',  // or use rgba format like 'rgba(255, 255, 255, 0.9)'\n *   sentence_ref: 'S3'\n * });\n * ```\n */\nexport function createText(args) {\n  // Validate required fields\n  if (!args.content || typeof args.content !== 'string' || args.content.trim().length === 0) {\n    throw new Error('Text annotation requires non-empty content');\n  }\n\n  if (typeof args.x !== 'number' || args.x < 0 || args.x > 1) {\n    throw new Error('Text annotation x position must be between 0 and 1');\n  }\n\n  if (typeof args.y !== 'number' || args.y < 0 || args.y > 1) {\n    throw new Error('Text annotation y position must be between 0 and 1');\n  }\n\n  if (typeof args.w !== 'number' || args.w < 0 || args.w > 1) {\n    throw new Error('Text annotation width (w) must be between 0 and 1');\n  }\n\n  if (typeof args.h !== 'number' || args.h < 0 || args.h > 1) {\n    throw new Error('Text annotation height (h) must be between 0 and 1');\n  }\n\n  if (!args.page || typeof args.page !== 'number' || args.page < 1) {\n    throw new Error('Text annotation requires a valid page number (>= 1)');\n  }\n\n  if (!args.sentence_ref || typeof args.sentence_ref !== 'string') {\n    throw new Error('Text annotation requires a sentence_ref for timing');\n  }\n\n  // Get colors with defaults (transparent background for better visibility)\n  const textColor = args.textColor || '#1f2937';\n  const bgColor = args.bgColor || 'transparent';\n\n  // Create annotation object matching library format\n  return {\n    id: generateId('text'),\n    type: 'text',              // Type name is 'text', not 'text_annotation'\n    page: args.page,\n    content: args.content.trim(),\n    x: args.x,                 // Direct properties, not in position object\n    y: args.y,\n    w: args.w,\n    h: args.h,\n    style: {                   // Colors wrapped in style object\n      bg: bgColor,\n      color: textColor\n    },\n    sentence_ref: args.sentence_ref,\n    // Note: start/end will be added during timing sync phase\n  };\n}\n"],"names":["createText","args","textColor","bgColor","generateId"],"mappings":"iHAwCO,SAASA,EAAWC,EAAM,CAE/B,GAAI,CAACA,EAAK,SAAW,OAAOA,EAAK,SAAY,UAAYA,EAAK,QAAQ,OAAO,SAAW,EACtF,MAAM,IAAI,MAAM,4CAA4C,EAG9D,GAAI,OAAOA,EAAK,GAAM,UAAYA,EAAK,EAAI,GAAKA,EAAK,EAAI,EACvD,MAAM,IAAI,MAAM,oDAAoD,EAGtE,GAAI,OAAOA,EAAK,GAAM,UAAYA,EAAK,EAAI,GAAKA,EAAK,EAAI,EACvD,MAAM,IAAI,MAAM,oDAAoD,EAGtE,GAAI,OAAOA,EAAK,GAAM,UAAYA,EAAK,EAAI,GAAKA,EAAK,EAAI,EACvD,MAAM,IAAI,MAAM,mDAAmD,EAGrE,GAAI,OAAOA,EAAK,GAAM,UAAYA,EAAK,EAAI,GAAKA,EAAK,EAAI,EACvD,MAAM,IAAI,MAAM,oDAAoD,EAGtE,GAAI,CAACA,EAAK,MAAQ,OAAOA,EAAK,MAAS,UAAYA,EAAK,KAAO,EAC7D,MAAM,IAAI,MAAM,qDAAqD,EAGvE,GAAI,CAACA,EAAK,cAAgB,OAAOA,EAAK,cAAiB,SACrD,MAAM,IAAI,MAAM,oDAAoD,EAItE,MAAMC,EAAYD,EAAK,WAAa,UAC9BE,EAAUF,EAAK,SAAW,cAGhC,MAAO,CACL,GAAIG,EAAAA,WAAW,MAAM,EACrB,KAAM,OACN,KAAMH,EAAK,KACX,QAASA,EAAK,QAAQ,KAAI,EAC1B,EAAGA,EAAK,EACR,EAAGA,EAAK,EACR,EAAGA,EAAK,EACR,EAAGA,EAAK,EACR,MAAO,CACL,GAAIE,EACJ,MAAOD,CACb,EACI,aAAcD,EAAK,YAEvB,CACA"}