web-annotation-renderer 0.3.0 → 0.5.0

package/dist/index18.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index18.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"}
+{"version":3,"file":"index18.cjs","sources":["../src/ai-tools/openai/schemas.js"],"sourcesContent":["/**\n * OpenAI Tool Schemas for PDF Annotation Generation\n *\n * Provides OpenAI-compatible function calling schemas for creating PDF annotations.\n * These schemas define the structure and parameters for AI-generated annotations.\n * Compatible with web-annotation-renderer library format.\n *\n * @module ai-tools/openai/schemas\n */\n\n/**\n * Complete set of annotation tools for OpenAI function calling\n *\n * Export this array to the OpenAI API's `tools` parameter to enable\n * AI-generated annotations.\n *\n * @constant {Array<Object>}\n * @example\n * ```javascript\n * import { annotationTools } from 'web-annotation-renderer/ai-tools';\n *\n * const response = await openai.chat.completions.create({\n *   model: \"gpt-4\",\n *   messages: [...],\n *   tools: annotationTools\n * });\n * ```\n */\nexport const annotationTools = [\n  {\n    type: \"function\",\n    function: {\n      name: \"create_highlight_annotation\",\n      description: \"Create a highlight annotation at specified coordinates on the PDF page. Use this to emphasize important text or regions. Highlights are rectangular regions that can span multiple lines.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          quads: {\n            type: \"array\",\n            description: \"Array of rectangular regions defining the highlight areas. Each quad is an object with normalized coordinates (0-1): {x, y, w, h}. Multiple quads can be used for multi-line highlights.\",\n            items: {\n              type: \"object\",\n              properties: {\n                x: {\n                  type: \"number\",\n                  description: \"Normalized x position (0 = left, 1 = right)\",\n                  minimum: 0,\n                  maximum: 1\n                },\n                y: {\n                  type: \"number\",\n                  description: \"Normalized y position (0 = top, 1 = bottom)\",\n                  minimum: 0,\n                  maximum: 1\n                },\n                w: {\n                  type: \"number\",\n                  description: \"Normalized width (0-1)\",\n                  minimum: 0,\n                  maximum: 1\n                },\n                h: {\n                  type: \"number\",\n                  description: \"Normalized height (0-1)\",\n                  minimum: 0,\n                  maximum: 1\n                }\n              },\n              required: [\"x\", \"y\", \"w\", \"h\"]\n            },\n            minItems: 1\n          },\n          color: {\n            type: \"string\",\n            description: \"Highlight color in rgba format (e.g., 'rgba(255, 255, 0, 0.3)'). Default is semi-transparent yellow. Use rgba for transparency control.\",\n            default: \"rgba(255, 255, 0, 0.3)\"\n          },\n          page: {\n            type: \"integer\",\n            description: \"Page number (1-indexed) where the annotation appears\",\n            minimum: 1\n          },\n          sentence_ref: {\n            type: \"string\",\n            description: \"Reference to sentence marker (e.g., 'S1', 'S2') for timing synchronization\",\n            pattern: \"^S\\\\d+$\"\n          }\n        },\n        required: [\"quads\", \"page\", \"sentence_ref\"]\n      }\n    }\n  },\n  {\n    type: \"function\",\n    function: {\n      name: \"create_text_annotation\",\n      description: \"Create a text box annotation with explanatory content. Use this to add clarifying notes, definitions, or explanations. Text boxes have background and appear as overlays.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          content: {\n            type: \"string\",\n            description: \"The text content of the annotation\",\n            minLength: 1,\n            maxLength: 500\n          },\n          x: {\n            type: \"number\",\n            description: \"Normalized x position (0 = left edge, 1 = right edge)\",\n            minimum: 0,\n            maximum: 1\n          },\n          y: {\n            type: \"number\",\n            description: \"Normalized y position (0 = top edge, 1 = bottom edge)\",\n            minimum: 0,\n            maximum: 1\n          },\n          w: {\n            type: \"number\",\n            description: \"Normalized width (0-1) of the text box\",\n            minimum: 0,\n            maximum: 1\n          },\n          h: {\n            type: \"number\",\n            description: \"Normalized height (0-1) of the text box\",\n            minimum: 0,\n            maximum: 1\n          },\n          page: {\n            type: \"integer\",\n            description: \"Page number (1-indexed) where the annotation appears\",\n            minimum: 1\n          },\n          textColor: {\n            type: \"string\",\n            description: \"Text color in hex format (e.g., '#000000' for black). Default is dark gray.\",\n            default: \"#1f2937\"\n          },\n          bgColor: {\n            type: \"string\",\n            description: \"Background color in rgba format or 'transparent' (e.g., 'rgba(255, 255, 255, 0.9)' or 'transparent'). Default is transparent for better visibility of underlying content. Use rgba format when background is needed.\",\n            default: \"transparent\"\n          },\n          sentence_ref: {\n            type: \"string\",\n            description: \"Reference to sentence marker (e.g., 'S1', 'S2') for timing synchronization\",\n            pattern: \"^S\\\\d+$\"\n          }\n        },\n        required: [\"content\", \"x\", \"y\", \"w\", \"h\", \"page\", \"sentence_ref\"]\n      }\n    }\n  }\n];\n\n/**\n * Get filtered annotation tools based on enabled types\n *\n * @param {Array<string>} enabledTypes - Array of enabled tool types: ['highlight', 'text']\n * @returns {Array<Object>} Filtered annotation tools\n * @example\n * ```javascript\n * // Only enable highlights and text notes\n * const tools = getAnnotationTools(['highlight', 'text']);\n * ```\n */\nexport function getAnnotationTools(enabledTypes = []) {\n  if (!Array.isArray(enabledTypes) || enabledTypes.length === 0) {\n    return [];\n  }\n\n  const typeMap = {\n    'highlight': 'create_highlight_annotation',\n    'text': 'create_text_annotation'\n  };\n\n  const enabledFunctionNames = enabledTypes\n    .map(type => typeMap[type])\n    .filter(Boolean);\n\n  return annotationTools.filter(tool =>\n    enabledFunctionNames.includes(tool.function.name)\n  );\n}\n"],"names":["annotationTools","getAnnotationTools","enabledTypes","typeMap","enabledFunctionNames","type","tool"],"mappings":"gFA4BY,MAACA,EAAkB,CAC7B,CACE,KAAM,WACN,SAAU,CACR,KAAM,8BACN,YAAa,4LACb,WAAY,CACV,KAAM,SACN,WAAY,CACV,MAAO,CACL,KAAM,QACN,YAAa,2LACb,MAAO,CACL,KAAM,SACN,WAAY,CACV,EAAG,CACD,KAAM,SACN,YAAa,8CACb,QAAS,EACT,QAAS,CAC3B,EACgB,EAAG,CACD,KAAM,SACN,YAAa,8CACb,QAAS,EACT,QAAS,CAC3B,EACgB,EAAG,CACD,KAAM,SACN,YAAa,yBACb,QAAS,EACT,QAAS,CAC3B,EACgB,EAAG,CACD,KAAM,SACN,YAAa,0BACb,QAAS,EACT,QAAS,CAC3B,CACA,EACc,SAAU,CAAC,IAAK,IAAK,IAAK,GAAG,CAC3C,EACY,SAAU,CACtB,EACU,MAAO,CACL,KAAM,SACN,YAAa,0IACb,QAAS,wBACrB,EACU,KAAM,CACJ,KAAM,UACN,YAAa,uDACb,QAAS,CACrB,EACU,aAAc,CACZ,KAAM,SACN,YAAa,6EACb,QAAS,SACrB,CACA,EACQ,SAAU,CAAC,QAAS,OAAQ,cAAc,CAClD,CACA,CACA,EACE,CACE,KAAM,WACN,SAAU,CACR,KAAM,yBACN,YAAa,4KACb,WAAY,CACV,KAAM,SACN,WAAY,CACV,QAAS,CACP,KAAM,SACN,YAAa,qCACb,UAAW,EACX,UAAW,GACvB,EACU,EAAG,CACD,KAAM,SACN,YAAa,wDACb,QAAS,EACT,QAAS,CACrB,EACU,EAAG,CACD,KAAM,SACN,YAAa,wDACb,QAAS,EACT,QAAS,CACrB,EACU,EAAG,CACD,KAAM,SACN,YAAa,yCACb,QAAS,EACT,QAAS,CACrB,EACU,EAAG,CACD,KAAM,SACN,YAAa,0CACb,QAAS,EACT,QAAS,CACrB,EACU,KAAM,CACJ,KAAM,UACN,YAAa,uDACb,QAAS,CACrB,EACU,UAAW,CACT,KAAM,SACN,YAAa,8EACb,QAAS,SACrB,EACU,QAAS,CACP,KAAM,SACN,YAAa,uNACb,QAAS,aACrB,EACU,aAAc,CACZ,KAAM,SACN,YAAa,6EACb,QAAS,SACrB,CACA,EACQ,SAAU,CAAC,UAAW,IAAK,IAAK,IAAK,IAAK,OAAQ,cAAc,CACxE,CACA,CACA,CACA,EAaO,SAASC,EAAmBC,EAAe,GAAI,CACpD,GAAI,CAAC,MAAM,QAAQA,CAAY,GAAKA,EAAa,SAAW,EAC1D,MAAO,CAAA,EAGT,MAAMC,EAAU,CACd,UAAa,8BACb,KAAQ,wBACZ,EAEQC,EAAuBF,EAC1B,IAAIG,GAAQF,EAAQE,CAAI,CAAC,EACzB,OAAO,OAAO,EAEjB,OAAOL,EAAgB,OAAOM,GAC5BF,EAAqB,SAASE,EAAK,SAAS,IAAI,CACpD,CACA"}

package/dist/index18.js

@@ -1,40 +1,144 @@
-import { generateId as h } from "./index22.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("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 r = [
+  {
+    type: "function",
+    function: {
+      name: "create_highlight_annotation",
+      description: "Create a highlight annotation at specified coordinates on the PDF page. Use this to emphasize important text or regions. Highlights are rectangular regions that can span multiple lines.",
+      parameters: {
+        type: "object",
+        properties: {
+          quads: {
+            type: "array",
+            description: "Array of rectangular regions defining the highlight areas. Each quad is an object with normalized coordinates (0-1): {x, y, w, h}. Multiple quads can be used for multi-line highlights.",
+            items: {
+              type: "object",
+              properties: {
+                x: {
+                  type: "number",
+                  description: "Normalized x position (0 = left, 1 = right)",
+                  minimum: 0,
+                  maximum: 1
+                },
+                y: {
+                  type: "number",
+                  description: "Normalized y position (0 = top, 1 = bottom)",
+                  minimum: 0,
+                  maximum: 1
+                },
+                w: {
+                  type: "number",
+                  description: "Normalized width (0-1)",
+                  minimum: 0,
+                  maximum: 1
+                },
+                h: {
+                  type: "number",
+                  description: "Normalized height (0-1)",
+                  minimum: 0,
+                  maximum: 1
+                }
+              },
+              required: ["x", "y", "w", "h"]
+            },
+            minItems: 1
+          },
+          color: {
+            type: "string",
+            description: "Highlight color in rgba format (e.g., 'rgba(255, 255, 0, 0.3)'). Default is semi-transparent yellow. Use rgba for transparency control.",
+            default: "rgba(255, 255, 0, 0.3)"
+          },
+          page: {
+            type: "integer",
+            description: "Page number (1-indexed) where the annotation appears",
+            minimum: 1
+          },
+          sentence_ref: {
+            type: "string",
+            description: "Reference to sentence marker (e.g., 'S1', 'S2') for timing synchronization",
+            pattern: "^S\\d+$"
+          }
+        },
+        required: ["quads", "page", "sentence_ref"]
+      }
     }
-  });
-  const n = e.color || "rgba(255, 255, 0, 0.3)";
-  return {
-    id: h("highlight"),
-    type: "highlight",
-    mode: "quads",
-    // Required by HighlightLayer
-    page: e.page,
-    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
-  };
+  },
+  {
+    type: "function",
+    function: {
+      name: "create_text_annotation",
+      description: "Create a text box annotation with explanatory content. Use this to add clarifying notes, definitions, or explanations. Text boxes have background and appear as overlays.",
+      parameters: {
+        type: "object",
+        properties: {
+          content: {
+            type: "string",
+            description: "The text content of the annotation",
+            minLength: 1,
+            maxLength: 500
+          },
+          x: {
+            type: "number",
+            description: "Normalized x position (0 = left edge, 1 = right edge)",
+            minimum: 0,
+            maximum: 1
+          },
+          y: {
+            type: "number",
+            description: "Normalized y position (0 = top edge, 1 = bottom edge)",
+            minimum: 0,
+            maximum: 1
+          },
+          w: {
+            type: "number",
+            description: "Normalized width (0-1) of the text box",
+            minimum: 0,
+            maximum: 1
+          },
+          h: {
+            type: "number",
+            description: "Normalized height (0-1) of the text box",
+            minimum: 0,
+            maximum: 1
+          },
+          page: {
+            type: "integer",
+            description: "Page number (1-indexed) where the annotation appears",
+            minimum: 1
+          },
+          textColor: {
+            type: "string",
+            description: "Text color in hex format (e.g., '#000000' for black). Default is dark gray.",
+            default: "#1f2937"
+          },
+          bgColor: {
+            type: "string",
+            description: "Background color in rgba format or 'transparent' (e.g., 'rgba(255, 255, 255, 0.9)' or 'transparent'). Default is transparent for better visibility of underlying content. Use rgba format when background is needed.",
+            default: "transparent"
+          },
+          sentence_ref: {
+            type: "string",
+            description: "Reference to sentence marker (e.g., 'S1', 'S2') for timing synchronization",
+            pattern: "^S\\d+$"
+          }
+        },
+        required: ["content", "x", "y", "w", "h", "page", "sentence_ref"]
+      }
+    }
+  }
+];
+function o(e = []) {
+  if (!Array.isArray(e) || e.length === 0)
+    return [];
+  const n = {
+    highlight: "create_highlight_annotation",
+    text: "create_text_annotation"
+  }, i = e.map((t) => n[t]).filter(Boolean);
+  return r.filter(
+    (t) => i.includes(t.function.name)
+  );
 }
 export {
-  p as createHighlight
+  r as annotationTools,
+  o as getAnnotationTools
 };
 //# sourceMappingURL=index18.js.map

package/dist/index18.js.map

@@ -1 +1 @@
-{"version":3,"file":"index18.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;"}
+{"version":3,"file":"index18.js","sources":["../src/ai-tools/openai/schemas.js"],"sourcesContent":["/**\n * OpenAI Tool Schemas for PDF Annotation Generation\n *\n * Provides OpenAI-compatible function calling schemas for creating PDF annotations.\n * These schemas define the structure and parameters for AI-generated annotations.\n * Compatible with web-annotation-renderer library format.\n *\n * @module ai-tools/openai/schemas\n */\n\n/**\n * Complete set of annotation tools for OpenAI function calling\n *\n * Export this array to the OpenAI API's `tools` parameter to enable\n * AI-generated annotations.\n *\n * @constant {Array<Object>}\n * @example\n * ```javascript\n * import { annotationTools } from 'web-annotation-renderer/ai-tools';\n *\n * const response = await openai.chat.completions.create({\n *   model: \"gpt-4\",\n *   messages: [...],\n *   tools: annotationTools\n * });\n * ```\n */\nexport const annotationTools = [\n  {\n    type: \"function\",\n    function: {\n      name: \"create_highlight_annotation\",\n      description: \"Create a highlight annotation at specified coordinates on the PDF page. Use this to emphasize important text or regions. Highlights are rectangular regions that can span multiple lines.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          quads: {\n            type: \"array\",\n            description: \"Array of rectangular regions defining the highlight areas. Each quad is an object with normalized coordinates (0-1): {x, y, w, h}. Multiple quads can be used for multi-line highlights.\",\n            items: {\n              type: \"object\",\n              properties: {\n                x: {\n                  type: \"number\",\n                  description: \"Normalized x position (0 = left, 1 = right)\",\n                  minimum: 0,\n                  maximum: 1\n                },\n                y: {\n                  type: \"number\",\n                  description: \"Normalized y position (0 = top, 1 = bottom)\",\n                  minimum: 0,\n                  maximum: 1\n                },\n                w: {\n                  type: \"number\",\n                  description: \"Normalized width (0-1)\",\n                  minimum: 0,\n                  maximum: 1\n                },\n                h: {\n                  type: \"number\",\n                  description: \"Normalized height (0-1)\",\n                  minimum: 0,\n                  maximum: 1\n                }\n              },\n              required: [\"x\", \"y\", \"w\", \"h\"]\n            },\n            minItems: 1\n          },\n          color: {\n            type: \"string\",\n            description: \"Highlight color in rgba format (e.g., 'rgba(255, 255, 0, 0.3)'). Default is semi-transparent yellow. Use rgba for transparency control.\",\n            default: \"rgba(255, 255, 0, 0.3)\"\n          },\n          page: {\n            type: \"integer\",\n            description: \"Page number (1-indexed) where the annotation appears\",\n            minimum: 1\n          },\n          sentence_ref: {\n            type: \"string\",\n            description: \"Reference to sentence marker (e.g., 'S1', 'S2') for timing synchronization\",\n            pattern: \"^S\\\\d+$\"\n          }\n        },\n        required: [\"quads\", \"page\", \"sentence_ref\"]\n      }\n    }\n  },\n  {\n    type: \"function\",\n    function: {\n      name: \"create_text_annotation\",\n      description: \"Create a text box annotation with explanatory content. Use this to add clarifying notes, definitions, or explanations. Text boxes have background and appear as overlays.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          content: {\n            type: \"string\",\n            description: \"The text content of the annotation\",\n            minLength: 1,\n            maxLength: 500\n          },\n          x: {\n            type: \"number\",\n            description: \"Normalized x position (0 = left edge, 1 = right edge)\",\n            minimum: 0,\n            maximum: 1\n          },\n          y: {\n            type: \"number\",\n            description: \"Normalized y position (0 = top edge, 1 = bottom edge)\",\n            minimum: 0,\n            maximum: 1\n          },\n          w: {\n            type: \"number\",\n            description: \"Normalized width (0-1) of the text box\",\n            minimum: 0,\n            maximum: 1\n          },\n          h: {\n            type: \"number\",\n            description: \"Normalized height (0-1) of the text box\",\n            minimum: 0,\n            maximum: 1\n          },\n          page: {\n            type: \"integer\",\n            description: \"Page number (1-indexed) where the annotation appears\",\n            minimum: 1\n          },\n          textColor: {\n            type: \"string\",\n            description: \"Text color in hex format (e.g., '#000000' for black). Default is dark gray.\",\n            default: \"#1f2937\"\n          },\n          bgColor: {\n            type: \"string\",\n            description: \"Background color in rgba format or 'transparent' (e.g., 'rgba(255, 255, 255, 0.9)' or 'transparent'). Default is transparent for better visibility of underlying content. Use rgba format when background is needed.\",\n            default: \"transparent\"\n          },\n          sentence_ref: {\n            type: \"string\",\n            description: \"Reference to sentence marker (e.g., 'S1', 'S2') for timing synchronization\",\n            pattern: \"^S\\\\d+$\"\n          }\n        },\n        required: [\"content\", \"x\", \"y\", \"w\", \"h\", \"page\", \"sentence_ref\"]\n      }\n    }\n  }\n];\n\n/**\n * Get filtered annotation tools based on enabled types\n *\n * @param {Array<string>} enabledTypes - Array of enabled tool types: ['highlight', 'text']\n * @returns {Array<Object>} Filtered annotation tools\n * @example\n * ```javascript\n * // Only enable highlights and text notes\n * const tools = getAnnotationTools(['highlight', 'text']);\n * ```\n */\nexport function getAnnotationTools(enabledTypes = []) {\n  if (!Array.isArray(enabledTypes) || enabledTypes.length === 0) {\n    return [];\n  }\n\n  const typeMap = {\n    'highlight': 'create_highlight_annotation',\n    'text': 'create_text_annotation'\n  };\n\n  const enabledFunctionNames = enabledTypes\n    .map(type => typeMap[type])\n    .filter(Boolean);\n\n  return annotationTools.filter(tool =>\n    enabledFunctionNames.includes(tool.function.name)\n  );\n}\n"],"names":["annotationTools","getAnnotationTools","enabledTypes","typeMap","enabledFunctionNames","type","tool"],"mappings":"AA4BY,MAACA,IAAkB;AAAA,EAC7B;AAAA,IACE,MAAM;AAAA,IACN,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,YAAY;AAAA,QACV,MAAM;AAAA,QACN,YAAY;AAAA,UACV,OAAO;AAAA,YACL,MAAM;AAAA,YACN,aAAa;AAAA,YACb,OAAO;AAAA,cACL,MAAM;AAAA,cACN,YAAY;AAAA,gBACV,GAAG;AAAA,kBACD,MAAM;AAAA,kBACN,aAAa;AAAA,kBACb,SAAS;AAAA,kBACT,SAAS;AAAA,gBAC3B;AAAA,gBACgB,GAAG;AAAA,kBACD,MAAM;AAAA,kBACN,aAAa;AAAA,kBACb,SAAS;AAAA,kBACT,SAAS;AAAA,gBAC3B;AAAA,gBACgB,GAAG;AAAA,kBACD,MAAM;AAAA,kBACN,aAAa;AAAA,kBACb,SAAS;AAAA,kBACT,SAAS;AAAA,gBAC3B;AAAA,gBACgB,GAAG;AAAA,kBACD,MAAM;AAAA,kBACN,aAAa;AAAA,kBACb,SAAS;AAAA,kBACT,SAAS;AAAA,gBAC3B;AAAA,cACA;AAAA,cACc,UAAU,CAAC,KAAK,KAAK,KAAK,GAAG;AAAA,YAC3C;AAAA,YACY,UAAU;AAAA,UACtB;AAAA,UACU,OAAO;AAAA,YACL,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,UACrB;AAAA,UACU,MAAM;AAAA,YACJ,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,UACrB;AAAA,UACU,cAAc;AAAA,YACZ,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,UACrB;AAAA,QACA;AAAA,QACQ,UAAU,CAAC,SAAS,QAAQ,cAAc;AAAA,MAClD;AAAA,IACA;AAAA,EACA;AAAA,EACE;AAAA,IACE,MAAM;AAAA,IACN,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,YAAY;AAAA,QACV,MAAM;AAAA,QACN,YAAY;AAAA,UACV,SAAS;AAAA,YACP,MAAM;AAAA,YACN,aAAa;AAAA,YACb,WAAW;AAAA,YACX,WAAW;AAAA,UACvB;AAAA,UACU,GAAG;AAAA,YACD,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,YACT,SAAS;AAAA,UACrB;AAAA,UACU,GAAG;AAAA,YACD,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,YACT,SAAS;AAAA,UACrB;AAAA,UACU,GAAG;AAAA,YACD,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,YACT,SAAS;AAAA,UACrB;AAAA,UACU,GAAG;AAAA,YACD,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,YACT,SAAS;AAAA,UACrB;AAAA,UACU,MAAM;AAAA,YACJ,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,UACrB;AAAA,UACU,WAAW;AAAA,YACT,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,UACrB;AAAA,UACU,SAAS;AAAA,YACP,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,UACrB;AAAA,UACU,cAAc;AAAA,YACZ,MAAM;AAAA,YACN,aAAa;AAAA,YACb,SAAS;AAAA,UACrB;AAAA,QACA;AAAA,QACQ,UAAU,CAAC,WAAW,KAAK,KAAK,KAAK,KAAK,QAAQ,cAAc;AAAA,MACxE;AAAA,IACA;AAAA,EACA;AACA;AAaO,SAASC,EAAmBC,IAAe,IAAI;AACpD,MAAI,CAAC,MAAM,QAAQA,CAAY,KAAKA,EAAa,WAAW;AAC1D,WAAO,CAAA;AAGT,QAAMC,IAAU;AAAA,IACd,WAAa;AAAA,IACb,MAAQ;AAAA,EACZ,GAEQC,IAAuBF,EAC1B,IAAI,CAAAG,MAAQF,EAAQE,CAAI,CAAC,EACzB,OAAO,OAAO;AAEjB,SAAOL,EAAgB;AAAA,IAAO,CAAAM,MAC5BF,EAAqB,SAASE,EAAK,SAAS,IAAI;AAAA,EACpD;AACA;"}

package/dist/index19.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./index22.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||"rgba(255, 255, 255, 0.9)";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;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./index20.cjs"),c=require("./index21.cjs");function o(r){if(!r||typeof r!="object")throw new Error("Invalid tool call: must be an object");if(!r.function||typeof r.function!="object")throw new Error("Invalid tool call: missing function property");const{name:t,arguments:e}=r.function;if(!t||typeof t!="string")throw new Error("Invalid tool call: missing or invalid function name");let n;try{n=typeof e=="string"?JSON.parse(e):e}catch(a){throw new Error(`Failed to parse tool call arguments: ${a.message}`)}switch(t){case"create_highlight_annotation":return i.createHighlight(n);case"create_text_annotation":return c.createText(n);default:throw new Error(`Unknown tool: ${t}. Supported tools: create_highlight_annotation, create_text_annotation`)}}function l(r){if(!Array.isArray(r))throw new Error("Tool calls must be an array");return r.map((t,e)=>{try{return o(t)}catch(n){throw new Error(`Error processing tool call at index ${e}: ${n.message}`)}})}exports.handleToolCall=o;exports.handleToolCalls=l;
 //# sourceMappingURL=index19.cjs.map

package/dist/index19.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index19.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='rgba(255, 255, 255, 0.9)'] - Background color in 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: '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\n  const textColor = args.textColor || '#1f2937';\n  const bgColor = args.bgColor || 'rgba(255, 255, 255, 0.9)';\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,2BAGhC,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"}
+{"version":3,"file":"index19.cjs","sources":["../src/ai-tools/openai/handler.js"],"sourcesContent":["/**\n * OpenAI Tool Call Handler\n *\n * Processes OpenAI function calling responses and converts them into\n * valid annotation objects.\n *\n * @module ai-tools/openai/handler\n */\n\nimport { createHighlight } from '../creators/createHighlight.js';\nimport { createText } from '../creators/createText.js';\n\n/**\n * Handle an OpenAI tool call and convert it to a valid annotation\n *\n * @param {Object} toolCall - Tool call object from OpenAI API response\n * @param {Object} toolCall.function - Function call details\n * @param {string} toolCall.function.name - Function name\n * @param {string} toolCall.function.arguments - JSON string of arguments\n * @returns {Object} Valid annotation object\n * @throws {Error} If tool call is invalid or unsupported\n * @example\n * ```javascript\n * import { handleToolCall } from 'web-annotation-renderer/ai-tools';\n *\n * const response = await openai.chat.completions.create({\n *   model: \"gpt-4\",\n *   messages: [...],\n *   tools: annotationTools\n * });\n *\n * const annotations = [];\n * if (response.choices[0].message.tool_calls) {\n *   for (const toolCall of response.choices[0].message.tool_calls) {\n *     const annotation = handleToolCall(toolCall);\n *     annotations.push(annotation);\n *   }\n * }\n * ```\n */\nexport function handleToolCall(toolCall) {\n  // Validate tool call structure\n  if (!toolCall || typeof toolCall !== 'object') {\n    throw new Error('Invalid tool call: must be an object');\n  }\n\n  if (!toolCall.function || typeof toolCall.function !== 'object') {\n    throw new Error('Invalid tool call: missing function property');\n  }\n\n  const { name, arguments: argsString } = toolCall.function;\n\n  if (!name || typeof name !== 'string') {\n    throw new Error('Invalid tool call: missing or invalid function name');\n  }\n\n  // Parse arguments\n  let args;\n  try {\n    args = typeof argsString === 'string' ? JSON.parse(argsString) : argsString;\n  } catch (error) {\n    throw new Error(`Failed to parse tool call arguments: ${error.message}`);\n  }\n\n  // Route to appropriate creator function\n  switch (name) {\n    case 'create_highlight_annotation':\n      return createHighlight(args);\n\n    case 'create_text_annotation':\n      return createText(args);\n\n    default:\n      throw new Error(`Unknown tool: ${name}. Supported tools: create_highlight_annotation, create_text_annotation`);\n  }\n}\n\n/**\n * Process multiple tool calls from an OpenAI response\n *\n * @param {Array<Object>} toolCalls - Array of tool call objects from OpenAI\n * @returns {Array<Object>} Array of valid annotation objects\n * @example\n * ```javascript\n * const annotations = handleToolCalls(response.choices[0].message.tool_calls);\n * ```\n */\nexport function handleToolCalls(toolCalls) {\n  if (!Array.isArray(toolCalls)) {\n    throw new Error('Tool calls must be an array');\n  }\n\n  return toolCalls.map((toolCall, index) => {\n    try {\n      return handleToolCall(toolCall);\n    } catch (error) {\n      throw new Error(`Error processing tool call at index ${index}: ${error.message}`);\n    }\n  });\n}\n"],"names":["handleToolCall","toolCall","name","argsString","args","error","createHighlight","createText","handleToolCalls","toolCalls","index"],"mappings":"4IAwCO,SAASA,EAAeC,EAAU,CAEvC,GAAI,CAACA,GAAY,OAAOA,GAAa,SACnC,MAAM,IAAI,MAAM,sCAAsC,EAGxD,GAAI,CAACA,EAAS,UAAY,OAAOA,EAAS,UAAa,SACrD,MAAM,IAAI,MAAM,8CAA8C,EAGhE,KAAM,CAAE,KAAAC,EAAM,UAAWC,CAAU,EAAKF,EAAS,SAEjD,GAAI,CAACC,GAAQ,OAAOA,GAAS,SAC3B,MAAM,IAAI,MAAM,qDAAqD,EAIvE,IAAIE,EACJ,GAAI,CACFA,EAAO,OAAOD,GAAe,SAAW,KAAK,MAAMA,CAAU,EAAIA,CACnE,OAASE,EAAO,CACd,MAAM,IAAI,MAAM,wCAAwCA,EAAM,OAAO,EAAE,CACzE,CAGA,OAAQH,EAAI,CACV,IAAK,8BACH,OAAOI,EAAAA,gBAAgBF,CAAI,EAE7B,IAAK,yBACH,OAAOG,EAAAA,WAAWH,CAAI,EAExB,QACE,MAAM,IAAI,MAAM,iBAAiBF,CAAI,wEAAwE,CACnH,CACA,CAYO,SAASM,EAAgBC,EAAW,CACzC,GAAI,CAAC,MAAM,QAAQA,CAAS,EAC1B,MAAM,IAAI,MAAM,6BAA6B,EAG/C,OAAOA,EAAU,IAAI,CAACR,EAAUS,IAAU,CACxC,GAAI,CACF,OAAOV,EAAeC,CAAQ,CAChC,OAASI,EAAO,CACd,MAAM,IAAI,MAAM,uCAAuCK,CAAK,KAAKL,EAAM,OAAO,EAAE,CAClF,CACF,CAAC,CACH"}

package/dist/index19.js

@@ -1,41 +1,41 @@
-import { generateId as o } from "./index22.js";
-function i(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 || "rgba(255, 255, 255, 0.9)";
-  return {
-    id: o("text"),
-    type: "text",
-    // Type name is 'text', not 'text_annotation'
-    page: e.page,
-    content: e.content.trim(),
-    x: e.x,
-    // Direct properties, not in position object
-    y: e.y,
-    w: e.w,
-    h: e.h,
-    style: {
-      // Colors wrapped in style object
-      bg: n,
-      color: t
-    },
-    sentence_ref: e.sentence_ref
-    // Note: start/end will be added during timing sync phase
-  };
+import { createHighlight as a } from "./index20.js";
+import { createText as i } from "./index21.js";
+function c(r) {
+  if (!r || typeof r != "object")
+    throw new Error("Invalid tool call: must be an object");
+  if (!r.function || typeof r.function != "object")
+    throw new Error("Invalid tool call: missing function property");
+  const { name: t, arguments: o } = r.function;
+  if (!t || typeof t != "string")
+    throw new Error("Invalid tool call: missing or invalid function name");
+  let n;
+  try {
+    n = typeof o == "string" ? JSON.parse(o) : o;
+  } catch (e) {
+    throw new Error(`Failed to parse tool call arguments: ${e.message}`);
+  }
+  switch (t) {
+    case "create_highlight_annotation":
+      return a(n);
+    case "create_text_annotation":
+      return i(n);
+    default:
+      throw new Error(`Unknown tool: ${t}. Supported tools: create_highlight_annotation, create_text_annotation`);
+  }
+}
+function h(r) {
+  if (!Array.isArray(r))
+    throw new Error("Tool calls must be an array");
+  return r.map((t, o) => {
+    try {
+      return c(t);
+    } catch (n) {
+      throw new Error(`Error processing tool call at index ${o}: ${n.message}`);
+    }
+  });
 }
 export {
-  i as createText
+  c as handleToolCall,
+  h as handleToolCalls
 };
 //# sourceMappingURL=index19.js.map

package/dist/index19.js.map

@@ -1 +1 @@
-{"version":3,"file":"index19.js","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='rgba(255, 255, 255, 0.9)'] - Background color in 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: '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\n  const textColor = args.textColor || '#1f2937';\n  const bgColor = args.bgColor || 'rgba(255, 255, 255, 0.9)';\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":";AAwCO,SAASA,EAAWC,GAAM;AAE/B,MAAI,CAACA,EAAK,WAAW,OAAOA,EAAK,WAAY,YAAYA,EAAK,QAAQ,OAAO,WAAW;AACtF,UAAM,IAAI,MAAM,4CAA4C;AAG9D,MAAI,OAAOA,EAAK,KAAM,YAAYA,EAAK,IAAI,KAAKA,EAAK,IAAI;AACvD,UAAM,IAAI,MAAM,oDAAoD;AAGtE,MAAI,OAAOA,EAAK,KAAM,YAAYA,EAAK,IAAI,KAAKA,EAAK,IAAI;AACvD,UAAM,IAAI,MAAM,oDAAoD;AAGtE,MAAI,OAAOA,EAAK,KAAM,YAAYA,EAAK,IAAI,KAAKA,EAAK,IAAI;AACvD,UAAM,IAAI,MAAM,mDAAmD;AAGrE,MAAI,OAAOA,EAAK,KAAM,YAAYA,EAAK,IAAI,KAAKA,EAAK,IAAI;AACvD,UAAM,IAAI,MAAM,oDAAoD;AAGtE,MAAI,CAACA,EAAK,QAAQ,OAAOA,EAAK,QAAS,YAAYA,EAAK,OAAO;AAC7D,UAAM,IAAI,MAAM,qDAAqD;AAGvE,MAAI,CAACA,EAAK,gBAAgB,OAAOA,EAAK,gBAAiB;AACrD,UAAM,IAAI,MAAM,oDAAoD;AAItE,QAAMC,IAAYD,EAAK,aAAa,WAC9BE,IAAUF,EAAK,WAAW;AAGhC,SAAO;AAAA,IACL,IAAIG,EAAW,MAAM;AAAA,IACrB,MAAM;AAAA;AAAA,IACN,MAAMH,EAAK;AAAA,IACX,SAASA,EAAK,QAAQ,KAAI;AAAA,IAC1B,GAAGA,EAAK;AAAA;AAAA,IACR,GAAGA,EAAK;AAAA,IACR,GAAGA,EAAK;AAAA,IACR,GAAGA,EAAK;AAAA,IACR,OAAO;AAAA;AAAA,MACL,IAAIE;AAAA,MACJ,OAAOD;AAAA,IACb;AAAA,IACI,cAAcD,EAAK;AAAA;AAAA,EAEvB;AACA;"}
+{"version":3,"file":"index19.js","sources":["../src/ai-tools/openai/handler.js"],"sourcesContent":["/**\n * OpenAI Tool Call Handler\n *\n * Processes OpenAI function calling responses and converts them into\n * valid annotation objects.\n *\n * @module ai-tools/openai/handler\n */\n\nimport { createHighlight } from '../creators/createHighlight.js';\nimport { createText } from '../creators/createText.js';\n\n/**\n * Handle an OpenAI tool call and convert it to a valid annotation\n *\n * @param {Object} toolCall - Tool call object from OpenAI API response\n * @param {Object} toolCall.function - Function call details\n * @param {string} toolCall.function.name - Function name\n * @param {string} toolCall.function.arguments - JSON string of arguments\n * @returns {Object} Valid annotation object\n * @throws {Error} If tool call is invalid or unsupported\n * @example\n * ```javascript\n * import { handleToolCall } from 'web-annotation-renderer/ai-tools';\n *\n * const response = await openai.chat.completions.create({\n *   model: \"gpt-4\",\n *   messages: [...],\n *   tools: annotationTools\n * });\n *\n * const annotations = [];\n * if (response.choices[0].message.tool_calls) {\n *   for (const toolCall of response.choices[0].message.tool_calls) {\n *     const annotation = handleToolCall(toolCall);\n *     annotations.push(annotation);\n *   }\n * }\n * ```\n */\nexport function handleToolCall(toolCall) {\n  // Validate tool call structure\n  if (!toolCall || typeof toolCall !== 'object') {\n    throw new Error('Invalid tool call: must be an object');\n  }\n\n  if (!toolCall.function || typeof toolCall.function !== 'object') {\n    throw new Error('Invalid tool call: missing function property');\n  }\n\n  const { name, arguments: argsString } = toolCall.function;\n\n  if (!name || typeof name !== 'string') {\n    throw new Error('Invalid tool call: missing or invalid function name');\n  }\n\n  // Parse arguments\n  let args;\n  try {\n    args = typeof argsString === 'string' ? JSON.parse(argsString) : argsString;\n  } catch (error) {\n    throw new Error(`Failed to parse tool call arguments: ${error.message}`);\n  }\n\n  // Route to appropriate creator function\n  switch (name) {\n    case 'create_highlight_annotation':\n      return createHighlight(args);\n\n    case 'create_text_annotation':\n      return createText(args);\n\n    default:\n      throw new Error(`Unknown tool: ${name}. Supported tools: create_highlight_annotation, create_text_annotation`);\n  }\n}\n\n/**\n * Process multiple tool calls from an OpenAI response\n *\n * @param {Array<Object>} toolCalls - Array of tool call objects from OpenAI\n * @returns {Array<Object>} Array of valid annotation objects\n * @example\n * ```javascript\n * const annotations = handleToolCalls(response.choices[0].message.tool_calls);\n * ```\n */\nexport function handleToolCalls(toolCalls) {\n  if (!Array.isArray(toolCalls)) {\n    throw new Error('Tool calls must be an array');\n  }\n\n  return toolCalls.map((toolCall, index) => {\n    try {\n      return handleToolCall(toolCall);\n    } catch (error) {\n      throw new Error(`Error processing tool call at index ${index}: ${error.message}`);\n    }\n  });\n}\n"],"names":["handleToolCall","toolCall","name","argsString","args","error","createHighlight","createText","handleToolCalls","toolCalls","index"],"mappings":";;AAwCO,SAASA,EAAeC,GAAU;AAEvC,MAAI,CAACA,KAAY,OAAOA,KAAa;AACnC,UAAM,IAAI,MAAM,sCAAsC;AAGxD,MAAI,CAACA,EAAS,YAAY,OAAOA,EAAS,YAAa;AACrD,UAAM,IAAI,MAAM,8CAA8C;AAGhE,QAAM,EAAE,MAAAC,GAAM,WAAWC,EAAU,IAAKF,EAAS;AAEjD,MAAI,CAACC,KAAQ,OAAOA,KAAS;AAC3B,UAAM,IAAI,MAAM,qDAAqD;AAIvE,MAAIE;AACJ,MAAI;AACF,IAAAA,IAAO,OAAOD,KAAe,WAAW,KAAK,MAAMA,CAAU,IAAIA;AAAA,EACnE,SAASE,GAAO;AACd,UAAM,IAAI,MAAM,wCAAwCA,EAAM,OAAO,EAAE;AAAA,EACzE;AAGA,UAAQH,GAAI;AAAA,IACV,KAAK;AACH,aAAOI,EAAgBF,CAAI;AAAA,IAE7B,KAAK;AACH,aAAOG,EAAWH,CAAI;AAAA,IAExB;AACE,YAAM,IAAI,MAAM,iBAAiBF,CAAI,wEAAwE;AAAA,EACnH;AACA;AAYO,SAASM,EAAgBC,GAAW;AACzC,MAAI,CAAC,MAAM,QAAQA,CAAS;AAC1B,UAAM,IAAI,MAAM,6BAA6B;AAG/C,SAAOA,EAAU,IAAI,CAACR,GAAUS,MAAU;AACxC,QAAI;AACF,aAAOV,EAAeC,CAAQ;AAAA,IAChC,SAASI,GAAO;AACd,YAAM,IAAI,MAAM,uCAAuCK,CAAK,KAAKL,EAAM,OAAO,EAAE;AAAA,IAClF;AAAA,EACF,CAAC;AACH;"}

package/dist/index2.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./index3.cjs"),n=require("./index4.cjs"),s=require("./index5.cjs");class a{constructor(e){if(!e||typeof e!="object")throw new Error("AnnotationRenderer: config object is required");if(!e.container||!(e.container instanceof HTMLElement))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.PDFRenderer,this.layerManager=new n.LayerManager(e.container,{width:1,height:1,scale:1}),this.timelineSync=new s.TimelineSync,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)}),e.pdfUrl&&this.loadPDF(e.pdfUrl).catch(t=>{console.error("AnnotationRenderer: Failed to auto-load PDF:",t)})}async loadPDF(e){try{if(!e||typeof e!="string")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}catch(t){return console.error("AnnotationRenderer.loadPDF: Error loading PDF:",t),{success:!1,error:`Failed to load PDF: ${t.message}`}}}async setPage(e){try{if(typeof e!="number"||e<1)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})`};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}catch(t){return console.error("AnnotationRenderer.setPage: Error rendering page:",t),{success:!1,error:`Failed to render page: ${t.message}`}}}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))}catch(t){return console.error("AnnotationRenderer.setScale: Error changing scale:",t),{success:!1,error:`Failed to change scale: ${t.message}`}}}setAnnotations(e){Array.isArray(e)||(console.warn("AnnotationRenderer.setAnnotations: annotations must be an array"),e=[]),this.annotations=e,this.layerManager.setAnnotations(e,this.currentPage)}setTime(e){if(typeof e!="number"){console.warn("AnnotationRenderer.setTime: timestamp must be a number");return}this.timelineSync.setTime(e)}getState(){return{page:this.currentPage,scale:this.currentScale,annotations:this.annotations,pageCount:this.pageCount,time:this.timelineSync.getCurrentTime(),viewport:this.currentViewport,pdfUrl:this.pdfUrl}}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}}exports.AnnotationRenderer=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./index3.cjs"),s=require("./index4.cjs"),i=require("./index5.cjs"),o=require("./index6.cjs");class a{constructor(e){if(!e||typeof e!="object")throw new Error("AnnotationRenderer: config object is required");if(!e.container||!(e.container instanceof HTMLElement))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 n.PDFRenderer,this.strokeCanvas=this._createStrokeCanvas(),this.strokeRenderer=new i.StrokeRenderer(this.strokeCanvas,e.strokeConfig||{}),this.timelineSync=new s.TimelineSync,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)})}_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}async loadPDF(e){try{if(!e||typeof e!="string")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}catch(t){return console.error("AnnotationRenderer.loadPDF: Error loading PDF:",t),{success:!1,error:`Failed to load PDF: ${t.message}`}}}async setPage(e){try{if(typeof e!="number"||e<1)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})`};this.pdfRenderer.cancelRender();const t=await this.pdfRenderer.renderPage(e,this.canvasElement,this.currentScale);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}`}}}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))}catch(t){return console.error("AnnotationRenderer.setScale: Error changing scale:",t),{success:!1,error:`Failed to change scale: ${t.message}`}}}setAnnotations(e){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)}setStrokes(e){this.strokeRenderer.setStrokes(e);const t=this.timelineSync.getCurrentTime();this.strokeRenderer.render(t)}setTime(e){if(typeof e!="number"){console.warn("AnnotationRenderer.setTime: timestamp must be a number");return}this.timelineSync.setTime(e)}startContinuousSync(e){this.timelineSync.startContinuousSync(e)}stopContinuousSync(){this.timelineSync.stopContinuousSync()}isContinuousSyncActive(){return this.timelineSync.isRunning}updateStrokeConfig(e){if(!e||typeof e!="object")return;this.strokeRenderer.config=o.deepMerge(this.strokeRenderer.config,e),this.strokeRenderer.setAnnotations(this.annotations,this.currentPage);const t=this.timelineSync.getCurrentTime();this.strokeRenderer.render(t)}getState(){return{page:this.currentPage,scale:this.currentScale,annotations:this.annotations,pageCount:this.pageCount,time:this.timelineSync.getCurrentTime(),viewport:this.currentViewport,pdfUrl:this.pdfUrl}}destroy(){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}}exports.AnnotationRenderer=a;
 //# sourceMappingURL=index2.cjs.map

package/dist/index2.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index2.cjs","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.cjs","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":"8LAiCO,MAAMA,CAAmB,CAc9B,YAAYC,EAAQ,CAClB,GAAI,CAACA,GAAU,OAAOA,GAAW,SAC/B,MAAM,IAAI,MAAM,+CAA+C,EAGjE,GAAI,CAACA,EAAO,WAAa,EAAEA,EAAO,qBAAqB,aACrD,MAAM,IAAI,MAAM,kEAAkE,EAGpF,GAAI,CAACA,EAAO,eAAiB,EAAEA,EAAO,yBAAyB,mBAC7D,MAAM,IAAI,MAAM,yEAAyE,EAG3F,KAAK,OAASA,EACd,KAAK,cAAgBA,EAAO,cAC5B,KAAK,UAAYA,EAAO,UAGxB,KAAK,YAAc,IAAIC,cAGvB,KAAK,aAAe,KAAK,oBAAmB,EAC5C,KAAK,eAAiB,IAAIC,iBAAe,KAAK,aAAcF,EAAO,cAAgB,EAAE,EAGrF,KAAK,aAAe,IAAIG,eAGxB,KAAK,YAAcH,EAAO,aAAe,EACzC,KAAK,aAAeA,EAAO,cAAgB,EAC3C,KAAK,YAAcA,EAAO,aAAe,CAAA,EACzC,KAAK,UAAY,EACjB,KAAK,gBAAkB,KACvB,KAAK,OAAS,KAGd,KAAK,aAAa,UAAWI,GAAS,CACpC,KAAK,eAAe,OAAOA,CAAI,CACjC,CAAC,EAGGJ,EAAO,QACT,KAAK,QAAQA,EAAO,MAAM,EAAE,MAAMK,GAAO,CACvC,QAAQ,MAAM,+CAAgDA,CAAG,CACnE,CAAC,CAEL,CAQA,qBAAsB,CACpB,MAAMC,EAAS,SAAS,cAAc,QAAQ,EAC9C,OAAAA,EAAO,UAAY,gBACnBA,EAAO,MAAM,SAAW,WACxBA,EAAO,MAAM,IAAM,IACnBA,EAAO,MAAM,KAAO,IACpBA,EAAO,MAAM,cAAgB,OAC7BA,EAAO,MAAM,OAAS,KACtB,KAAK,UAAU,YAAYA,CAAM,EAC1BA,CACT,CAQA,MAAM,QAAQC,EAAK,CACjB,GAAI,CACF,GAAI,CAACA,GAAO,OAAOA,GAAQ,SACzB,MAAO,CAAE,QAAS,GAAO,MAAO,0BAA0B,EAG5D,MAAMC,EAAS,MAAM,KAAK,YAAY,aAAaD,CAAG,EAEtD,OAAIC,EAAO,SACT,KAAK,OAASD,EACd,KAAK,UAAYC,EAAO,UACjB,CAAE,QAAS,GAAM,UAAWA,EAAO,SAAS,GAG9CA,CACT,OAASH,EAAK,CACZ,eAAQ,MAAM,iDAAkDA,CAAG,EAC5D,CAAE,QAAS,GAAO,MAAO,uBAAuBA,EAAI,OAAO,EAAE,CACtE,CACF,CAQA,MAAM,QAAQI,EAAS,CACrB,GAAI,CACF,GAAI,OAAOA,GAAY,UAAYA,EAAU,EAC3C,MAAO,CAAE,QAAS,GAAO,MAAO,qBAAqB,EAGvD,GAAI,KAAK,UAAY,GAAKA,EAAU,KAAK,UACvC,MAAO,CAAE,QAAS,GAAO,MAAO,QAAQA,CAAO,iCAAiC,KAAK,SAAS,GAAG,EAGnG,KAAK,YAAY,aAAY,EAE7B,MAAMD,EAAS,MAAM,KAAK,YAAY,WACpCC,EACA,KAAK,cACL,KAAK,YACb,EAEM,GAAID,EAAO,QAAS,CAClB,KAAK,YAAcC,EACnB,KAAK,gBAAkBD,EAAO,SAG9B,KAAK,eAAe,YAAYA,EAAO,SAAS,MAAOA,EAAO,SAAS,MAAM,EAG7E,KAAK,eAAe,eAAe,KAAK,YAAaC,CAAO,EAG5D,MAAMC,EAAc,KAAK,aAAa,eAAc,EACpD,YAAK,eAAe,OAAOA,CAAW,EAE/B,CAAE,QAAS,GAAM,SAAUF,EAAO,QAAQ,CACnD,CAEA,OAAOA,CACT,OAASH,EAAK,CACZ,eAAQ,MAAM,oDAAqDA,CAAG,EAC/D,CAAE,QAAS,GAAO,MAAO,0BAA0BA,EAAI,OAAO,EAAE,CACzE,CACF,CAQA,MAAM,SAASM,EAAO,CACpB,GAAI,CACF,OAAI,OAAOA,GAAU,UAAYA,GAAS,EACjC,CAAE,QAAS,GAAO,MAAO,+CAA+C,GAGjF,KAAK,aAAeA,EACb,MAAM,KAAK,QAAQ,KAAK,WAAW,EAC5C,OAASN,EAAK,CACZ,eAAQ,MAAM,qDAAsDA,CAAG,EAChE,CAAE,QAAS,GAAO,MAAO,2BAA2BA,EAAI,OAAO,EAAE,CAC1E,CACF,CAOA,eAAeO,EAAa,CACrB,MAAM,QAAQA,CAAW,IAC5B,QAAQ,KAAK,iEAAiE,EAC9EA,EAAc,CAAA,GAGhB,KAAK,YAAcA,EACnB,KAAK,eAAe,eAAeA,EAAa,KAAK,WAAW,EAGhE,MAAMF,EAAc,KAAK,aAAa,eAAc,EACpD,KAAK,eAAe,OAAOA,CAAW,CACxC,CASA,WAAWG,EAAS,CAClB,KAAK,eAAe,WAAWA,CAAO,EAEtC,MAAMH,EAAc,KAAK,aAAa,eAAc,EACpD,KAAK,eAAe,OAAOA,CAAW,CACxC,CAOA,QAAQI,EAAW,CACjB,GAAI,OAAOA,GAAc,SAAU,CACjC,QAAQ,KAAK,wDAAwD,EACrE,MACF,CAEA,KAAK,aAAa,QAAQA,CAAS,CACrC,CAaA,oBAAoBC,EAAiB,CACnC,KAAK,aAAa,oBAAoBA,CAAe,CACvD,CAOA,oBAAqB,CACnB,KAAK,aAAa,mBAAkB,CACtC,CAOA,wBAAyB,CACvB,OAAO,KAAK,aAAa,SAC3B,CAUA,mBAAmBC,EAAW,CAC5B,GAAI,CAACA,GAAa,OAAOA,GAAc,SACrC,OAIF,KAAK,eAAe,OAASC,EAAAA,UAAU,KAAK,eAAe,OAAQD,CAAS,EAG5E,KAAK,eAAe,eAAe,KAAK,YAAa,KAAK,WAAW,EACrE,MAAMN,EAAc,KAAK,aAAa,eAAc,EACpD,KAAK,eAAe,OAAOA,CAAW,CACxC,CAOA,UAAW,CACT,MAAO,CACL,KAAM,KAAK,YACX,MAAO,KAAK,aACZ,YAAa,KAAK,YAClB,UAAW,KAAK,UAChB,KAAM,KAAK,aAAa,eAAc,EACtC,SAAU,KAAK,gBACf,OAAQ,KAAK,MACnB,CACE,CAKA,SAAU,CACJ,KAAK,aACP,KAAK,YAAY,QAAO,EAGtB,KAAK,gBACP,KAAK,eAAe,QAAO,EAGzB,KAAK,cACP,KAAK,aAAa,QAAO,EAGvB,KAAK,cAAgB,KAAK,aAAa,YACzC,KAAK,aAAa,WAAW,YAAY,KAAK,YAAY,EAG5D,KAAK,YAAc,KACnB,KAAK,eAAiB,KACtB,KAAK,aAAe,KACpB,KAAK,aAAe,KACpB,KAAK,OAAS,KACd,KAAK,cAAgB,KACrB,KAAK,UAAY,KACjB,KAAK,YAAc,CAAA,EACnB,KAAK,YAAc,EACnB,KAAK,aAAe,EACpB,KAAK,UAAY,EACjB,KAAK,gBAAkB,KACvB,KAAK,OAAS,IAChB,CACF"}