web-annotation-renderer 0.5.1 → 0.5.3

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./index2.cjs"),i=require("./index3.cjs"),l=require("./index4.cjs"),s=require("./index5.cjs"),e=require("./index6.cjs"),c=require("./index7.cjs"),d=require("./index8.cjs"),t=require("./index9.cjs"),u=require("./index10.cjs"),g=require("./index11.cjs"),p=require("./index12.cjs"),h=require("./index13.cjs"),q=require("./index14.cjs"),T=require("./index15.cjs"),P=require("./index16.cjs"),r=require("./index17.cjs"),o=require("./index18.cjs"),n=require("./index19.cjs"),A=require("./index20.cjs"),S=require("./index21.cjs"),R="1.0.0",x="web-annotation-renderer";exports.AnnotationRenderer=a.AnnotationRenderer;exports.PDFRenderer=i.PDFRenderer;exports.TimelineSync=l.TimelineSync;exports.StrokeRenderer=s.StrokeRenderer;exports.applyJitter=e.applyJitter;exports.applyPressure=e.applyPressure;exports.applyWobble=e.applyWobble;exports.deepMerge=e.deepMerge;exports.seededRandom=e.seededRandom;exports.coordinateUtils=c;exports.viewportUtils=d;exports.extractAllBlocks=t.extractAllBlocks;exports.extractMultiplePages=t.extractMultiplePages;exports.extractPDFBlocks=t.extractAllBlocks;exports.normalizeAnnotationArray=u.normalizeAnnotationArray;exports.TypeValidators=g;exports.AnnotPdf=p.default;exports.highlightToStrokes=h.highlightToStrokes;exports.textToStrokes=q.textToStrokes;exports.GradualRenderer=T.default;exports.StrokeDrawer=P.default;exports.getPenPreset=r.getPreset;exports.getPenPresetNames=r.getPresetNames;exports.annotationTools=o.annotationTools;exports.getAnnotationTools=o.getAnnotationTools;exports.handleToolCall=n.handleToolCall;exports.handleToolCalls=n.handleToolCalls;exports.createHighlight=A.createHighlight;exports.createText=S.createText;exports.LIB_NAME=x;exports.VERSION=R;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./index2.cjs"),l=require("./index3.cjs"),a=require("./index4.cjs"),s=require("./index5.cjs"),e=require("./index6.cjs"),c=require("./index7.cjs"),d=require("./index8.cjs"),r=require("./index9.cjs"),u=require("./index10.cjs"),T=require("./index11.cjs"),g=require("./index12.cjs"),q=require("./index13.cjs"),p=require("./index14.cjs"),S=require("./index15.cjs"),h=require("./index16.cjs"),k=require("./index17.cjs"),P=require("./index18.cjs"),A=require("./index19.cjs"),t=require("./index20.cjs"),o=require("./index21.cjs"),n=require("./index22.cjs"),R=require("./index23.cjs"),x=require("./index24.cjs"),y="1.0.0",m="web-annotation-renderer";exports.AnnotationRenderer=i.AnnotationRenderer;exports.PDFRenderer=l.PDFRenderer;exports.TimelineSync=a.TimelineSync;exports.StrokeRenderer=s.StrokeRenderer;exports.applyJitter=e.applyJitter;exports.applyPressure=e.applyPressure;exports.applyWobble=e.applyWobble;exports.deepMerge=e.deepMerge;exports.seededRandom=e.seededRandom;exports.coordinateUtils=c;exports.viewportUtils=d;exports.extractAllBlocks=r.extractAllBlocks;exports.extractMultiplePages=r.extractMultiplePages;exports.extractPDFBlocks=r.extractAllBlocks;exports.normalizeAnnotationArray=u.normalizeAnnotationArray;exports.TypeValidators=T;exports.AnnotPdf=g.default;exports.highlightToStrokes=q.highlightToStrokes;exports.textToStrokes=p.textToStrokes;exports.underlineToStrokes=S.underlineToStrokes;exports.arrowToStrokes=h.arrowToStrokes;exports.circleToStrokes=k.circleToStrokes;exports.GradualRenderer=P.default;exports.StrokeDrawer=A.default;exports.getPenPreset=t.getPreset;exports.getPenPresetNames=t.getPresetNames;exports.annotationTools=o.annotationTools;exports.getAnnotationTools=o.getAnnotationTools;exports.handleToolCall=n.handleToolCall;exports.handleToolCalls=n.handleToolCalls;exports.createHighlight=R.createHighlight;exports.createText=x.createText;exports.LIB_NAME=m;exports.VERSION=y;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/index.js"],"sourcesContent":["/**\n * @ai-annotator/renderer - Public API\n *\n * Single entry point for the Dynamic PDF Annotation Renderer library.\n * Exports all core subsystems, utilities, and types.\n *\n * @module @ai-annotator/renderer\n */\n\n// ============================================================================\n// Core Rendering Engine\n// ============================================================================\n\nimport { AnnotationRenderer } from './core/AnnotationRenderer.js';\nimport { PDFRenderer } from './core/PDFRenderer.js';\nimport { TimelineSync } from './core/TimelineSync.js';\n\nexport { AnnotationRenderer };\nexport { PDFRenderer };\nexport { TimelineSync };\n\n// ============================================================================\n// Stroke Renderer - Unified Canvas-Based Annotation Rendering\n// ============================================================================\n\nimport { StrokeRenderer } from './renderer/StrokeRenderer.js';\n\nexport { StrokeRenderer };\n\n// ============================================================================\n// Converters - Annotation to Stroke Conversion\n// ============================================================================\n\nimport { highlightToStrokes, textToStrokes } from './converters/index.js';\n\nexport { highlightToStrokes };\nexport { textToStrokes };\n\n// ============================================================================\n// Pen Effects - Hand-Drawn Feel Utilities\n// ============================================================================\n\nimport {\n  applyJitter,\n  applyPressure,\n  applyWobble,\n  deepMerge,\n  seededRandom\n} from './pen/effects.js';\n\nexport { applyJitter };\nexport { applyPressure };\nexport { applyWobble };\nexport { deepMerge };\nexport { seededRandom };\n\n// ============================================================================\n// Pen Module - Legacy Stroke Rendering (Retained for Compatibility)\n// ============================================================================\n\nimport { GradualRenderer, StrokeDrawer, getPreset, getPresetNames } from './pen/index.js';\n\nexport { GradualRenderer };\nexport { StrokeDrawer };\nexport { getPreset as getPenPreset };\nexport { getPresetNames as getPenPresetNames };\n\n// ============================================================================\n// Utilities\n// ============================================================================\n\nimport * as coordinateUtils from './utils/coordinateUtils.js';\nimport * as viewportUtils from './utils/viewportUtils.js';\n\nexport { coordinateUtils };\nexport { viewportUtils };\n\n// ============================================================================\n// PDF Extraction Utilities\n// ============================================================================\n\nimport { extractAllBlocks, extractMultiplePages } from './utils/pdfExtractor.js';\n\nexport { extractAllBlocks };\nexport { extractMultiplePages };\nexport { extractAllBlocks as extractPDFBlocks };\n\n// ============================================================================\n// Type Definitions & Validators\n// ============================================================================\n\nexport { normalizeAnnotationArray } from './types/validators.js';\nexport * as TypeValidators from './types/index.js';\n\n// ============================================================================\n// Framework Adapters\n// ============================================================================\n\nexport { AnnotPdf } from './adapters/index.js';\n\n// ============================================================================\n// AI Tools for Annotation Generation\n// ============================================================================\n\nexport {\n  annotationTools,\n  getAnnotationTools,\n  handleToolCall,\n  handleToolCalls,\n  createHighlight,\n  createText\n} from './ai-tools/index.js';\n\n// ============================================================================\n// Package Metadata\n// ============================================================================\n\nexport const VERSION = '1.0.0';\nexport const LIB_NAME = 'web-annotation-renderer';\n"],"names":["VERSION","LIB_NAME"],"mappings":"0mBAqHaA,EAAU,QACVC,EAAW"}
+{"version":3,"file":"index.cjs","sources":["../src/index.js"],"sourcesContent":["/**\n * @ai-annotator/renderer - Public API\n *\n * Single entry point for the Dynamic PDF Annotation Renderer library.\n * Exports all core subsystems, utilities, and types.\n *\n * @module @ai-annotator/renderer\n */\n\n// ============================================================================\n// Core Rendering Engine\n// ============================================================================\n\nimport { AnnotationRenderer } from './core/AnnotationRenderer.js';\nimport { PDFRenderer } from './core/PDFRenderer.js';\nimport { TimelineSync } from './core/TimelineSync.js';\n\nexport { AnnotationRenderer };\nexport { PDFRenderer };\nexport { TimelineSync };\n\n// ============================================================================\n// Stroke Renderer - Unified Canvas-Based Annotation Rendering\n// ============================================================================\n\nimport { StrokeRenderer } from './renderer/StrokeRenderer.js';\n\nexport { StrokeRenderer };\n\n// ============================================================================\n// Converters - Annotation to Stroke Conversion\n// ============================================================================\n\nimport {\n  highlightToStrokes,\n  textToStrokes,\n  underlineToStrokes,\n  arrowToStrokes,\n  circleToStrokes\n} from './converters/index.js';\n\nexport { highlightToStrokes };\nexport { textToStrokes };\nexport { underlineToStrokes };\nexport { arrowToStrokes };\nexport { circleToStrokes };\n\n// ============================================================================\n// Pen Effects - Hand-Drawn Feel Utilities\n// ============================================================================\n\nimport {\n  applyJitter,\n  applyPressure,\n  applyWobble,\n  deepMerge,\n  seededRandom\n} from './pen/effects.js';\n\nexport { applyJitter };\nexport { applyPressure };\nexport { applyWobble };\nexport { deepMerge };\nexport { seededRandom };\n\n// ============================================================================\n// Pen Module - Legacy Stroke Rendering (Retained for Compatibility)\n// ============================================================================\n\nimport { GradualRenderer, StrokeDrawer, getPreset, getPresetNames } from './pen/index.js';\n\nexport { GradualRenderer };\nexport { StrokeDrawer };\nexport { getPreset as getPenPreset };\nexport { getPresetNames as getPenPresetNames };\n\n// ============================================================================\n// Utilities\n// ============================================================================\n\nimport * as coordinateUtils from './utils/coordinateUtils.js';\nimport * as viewportUtils from './utils/viewportUtils.js';\n\nexport { coordinateUtils };\nexport { viewportUtils };\n\n// ============================================================================\n// PDF Extraction Utilities\n// ============================================================================\n\nimport { extractAllBlocks, extractMultiplePages } from './utils/pdfExtractor.js';\n\nexport { extractAllBlocks };\nexport { extractMultiplePages };\nexport { extractAllBlocks as extractPDFBlocks };\n\n// ============================================================================\n// Type Definitions & Validators\n// ============================================================================\n\nexport { normalizeAnnotationArray } from './types/validators.js';\nexport * as TypeValidators from './types/index.js';\n\n// ============================================================================\n// Framework Adapters\n// ============================================================================\n\nexport { AnnotPdf } from './adapters/index.js';\n\n// ============================================================================\n// AI Tools for Annotation Generation\n// ============================================================================\n\nexport {\n  annotationTools,\n  getAnnotationTools,\n  handleToolCall,\n  handleToolCalls,\n  createHighlight,\n  createText\n} from './ai-tools/index.js';\n\n// ============================================================================\n// Package Metadata\n// ============================================================================\n\nexport const VERSION = '1.0.0';\nexport const LIB_NAME = 'web-annotation-renderer';\n"],"names":["VERSION","LIB_NAME"],"mappings":"2rBA8HaA,EAAU,QACVC,EAAW"}

package/dist/index.js

@@ -1,55 +1,61 @@
-import { AnnotationRenderer as p } from "./index2.js";
+import { AnnotationRenderer as n } from "./index2.js";
 import { PDFRenderer as m } from "./index3.js";
 import { TimelineSync as f } from "./index4.js";
 import { StrokeRenderer as d } from "./index5.js";
-import { applyJitter as g, applyPressure as P, applyWobble as T, deepMerge as A, seededRandom as h } from "./index6.js";
+import { applyJitter as T, applyPressure as g, applyWobble as P, deepMerge as k, seededRandom as S } from "./index6.js";
 import * as e from "./index7.js";
 import * as r from "./index8.js";
-import { extractAllBlocks as u, extractMultiplePages as y, extractAllBlocks as R } from "./index9.js";
-import { normalizeAnnotationArray as B } from "./index10.js";
+import { extractAllBlocks as h, extractMultiplePages as u, extractAllBlocks as y } from "./index9.js";
+import { normalizeAnnotationArray as w } from "./index10.js";
 import * as o from "./index11.js";
-import { default as b } from "./index12.js";
+import { default as N } from "./index12.js";
 import { highlightToStrokes as D } from "./index13.js";
 import { textToStrokes as C } from "./index14.js";
-import { default as F } from "./index15.js";
-import { default as U } from "./index16.js";
-import { getPreset as v, getPresetNames as z } from "./index17.js";
-import { annotationTools as H, getAnnotationTools as J } from "./index18.js";
-import { handleToolCall as O, handleToolCalls as W } from "./index19.js";
-import { createHighlight as j } from "./index20.js";
-import { createText as K } from "./index21.js";
+import { underlineToStrokes as F } from "./index15.js";
+import { arrowToStrokes as U } from "./index16.js";
+import { circleToStrokes as v } from "./index17.js";
+import { default as G } from "./index18.js";
+import { default as J } from "./index19.js";
+import { getPreset as O, getPresetNames as W } from "./index20.js";
+import { annotationTools as j, getAnnotationTools as q } from "./index21.js";
+import { handleToolCall as Q, handleToolCalls as X } from "./index22.js";
+import { createHighlight as Z } from "./index23.js";
+import { createText as ee } from "./index24.js";
 const t = "1.0.0", a = "web-annotation-renderer";
 export {
-  b as AnnotPdf,
-  p as AnnotationRenderer,
-  F as GradualRenderer,
+  N as AnnotPdf,
+  n as AnnotationRenderer,
+  G as GradualRenderer,
   a as LIB_NAME,
   m as PDFRenderer,
-  U as StrokeDrawer,
+  J as StrokeDrawer,
   d as StrokeRenderer,
   f as TimelineSync,
   o as TypeValidators,
   t as VERSION,
-  H as annotationTools,
-  g as applyJitter,
-  P as applyPressure,
-  T as applyWobble,
+  j as annotationTools,
+  T as applyJitter,
+  g as applyPressure,
+  P as applyWobble,
+  U as arrowToStrokes,
+  v as circleToStrokes,
   e as coordinateUtils,
-  j as createHighlight,
-  K as createText,
-  A as deepMerge,
-  u as extractAllBlocks,
-  y as extractMultiplePages,
-  R as extractPDFBlocks,
-  J as getAnnotationTools,
-  v as getPenPreset,
-  z as getPenPresetNames,
-  O as handleToolCall,
-  W as handleToolCalls,
+  Z as createHighlight,
+  ee as createText,
+  k as deepMerge,
+  h as extractAllBlocks,
+  u as extractMultiplePages,
+  y as extractPDFBlocks,
+  q as getAnnotationTools,
+  O as getPenPreset,
+  W as getPenPresetNames,
+  Q as handleToolCall,
+  X as handleToolCalls,
   D as highlightToStrokes,
-  B as normalizeAnnotationArray,
-  h as seededRandom,
+  w as normalizeAnnotationArray,
+  S as seededRandom,
   C as textToStrokes,
+  F as underlineToStrokes,
   r as viewportUtils
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.js"],"sourcesContent":["/**\n * @ai-annotator/renderer - Public API\n *\n * Single entry point for the Dynamic PDF Annotation Renderer library.\n * Exports all core subsystems, utilities, and types.\n *\n * @module @ai-annotator/renderer\n */\n\n// ============================================================================\n// Core Rendering Engine\n// ============================================================================\n\nimport { AnnotationRenderer } from './core/AnnotationRenderer.js';\nimport { PDFRenderer } from './core/PDFRenderer.js';\nimport { TimelineSync } from './core/TimelineSync.js';\n\nexport { AnnotationRenderer };\nexport { PDFRenderer };\nexport { TimelineSync };\n\n// ============================================================================\n// Stroke Renderer - Unified Canvas-Based Annotation Rendering\n// ============================================================================\n\nimport { StrokeRenderer } from './renderer/StrokeRenderer.js';\n\nexport { StrokeRenderer };\n\n// ============================================================================\n// Converters - Annotation to Stroke Conversion\n// ============================================================================\n\nimport { highlightToStrokes, textToStrokes } from './converters/index.js';\n\nexport { highlightToStrokes };\nexport { textToStrokes };\n\n// ============================================================================\n// Pen Effects - Hand-Drawn Feel Utilities\n// ============================================================================\n\nimport {\n  applyJitter,\n  applyPressure,\n  applyWobble,\n  deepMerge,\n  seededRandom\n} from './pen/effects.js';\n\nexport { applyJitter };\nexport { applyPressure };\nexport { applyWobble };\nexport { deepMerge };\nexport { seededRandom };\n\n// ============================================================================\n// Pen Module - Legacy Stroke Rendering (Retained for Compatibility)\n// ============================================================================\n\nimport { GradualRenderer, StrokeDrawer, getPreset, getPresetNames } from './pen/index.js';\n\nexport { GradualRenderer };\nexport { StrokeDrawer };\nexport { getPreset as getPenPreset };\nexport { getPresetNames as getPenPresetNames };\n\n// ============================================================================\n// Utilities\n// ============================================================================\n\nimport * as coordinateUtils from './utils/coordinateUtils.js';\nimport * as viewportUtils from './utils/viewportUtils.js';\n\nexport { coordinateUtils };\nexport { viewportUtils };\n\n// ============================================================================\n// PDF Extraction Utilities\n// ============================================================================\n\nimport { extractAllBlocks, extractMultiplePages } from './utils/pdfExtractor.js';\n\nexport { extractAllBlocks };\nexport { extractMultiplePages };\nexport { extractAllBlocks as extractPDFBlocks };\n\n// ============================================================================\n// Type Definitions & Validators\n// ============================================================================\n\nexport { normalizeAnnotationArray } from './types/validators.js';\nexport * as TypeValidators from './types/index.js';\n\n// ============================================================================\n// Framework Adapters\n// ============================================================================\n\nexport { AnnotPdf } from './adapters/index.js';\n\n// ============================================================================\n// AI Tools for Annotation Generation\n// ============================================================================\n\nexport {\n  annotationTools,\n  getAnnotationTools,\n  handleToolCall,\n  handleToolCalls,\n  createHighlight,\n  createText\n} from './ai-tools/index.js';\n\n// ============================================================================\n// Package Metadata\n// ============================================================================\n\nexport const VERSION = '1.0.0';\nexport const LIB_NAME = 'web-annotation-renderer';\n"],"names":["VERSION","LIB_NAME"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqHY,MAACA,IAAU,SACVC,IAAW;"}
+{"version":3,"file":"index.js","sources":["../src/index.js"],"sourcesContent":["/**\n * @ai-annotator/renderer - Public API\n *\n * Single entry point for the Dynamic PDF Annotation Renderer library.\n * Exports all core subsystems, utilities, and types.\n *\n * @module @ai-annotator/renderer\n */\n\n// ============================================================================\n// Core Rendering Engine\n// ============================================================================\n\nimport { AnnotationRenderer } from './core/AnnotationRenderer.js';\nimport { PDFRenderer } from './core/PDFRenderer.js';\nimport { TimelineSync } from './core/TimelineSync.js';\n\nexport { AnnotationRenderer };\nexport { PDFRenderer };\nexport { TimelineSync };\n\n// ============================================================================\n// Stroke Renderer - Unified Canvas-Based Annotation Rendering\n// ============================================================================\n\nimport { StrokeRenderer } from './renderer/StrokeRenderer.js';\n\nexport { StrokeRenderer };\n\n// ============================================================================\n// Converters - Annotation to Stroke Conversion\n// ============================================================================\n\nimport {\n  highlightToStrokes,\n  textToStrokes,\n  underlineToStrokes,\n  arrowToStrokes,\n  circleToStrokes\n} from './converters/index.js';\n\nexport { highlightToStrokes };\nexport { textToStrokes };\nexport { underlineToStrokes };\nexport { arrowToStrokes };\nexport { circleToStrokes };\n\n// ============================================================================\n// Pen Effects - Hand-Drawn Feel Utilities\n// ============================================================================\n\nimport {\n  applyJitter,\n  applyPressure,\n  applyWobble,\n  deepMerge,\n  seededRandom\n} from './pen/effects.js';\n\nexport { applyJitter };\nexport { applyPressure };\nexport { applyWobble };\nexport { deepMerge };\nexport { seededRandom };\n\n// ============================================================================\n// Pen Module - Legacy Stroke Rendering (Retained for Compatibility)\n// ============================================================================\n\nimport { GradualRenderer, StrokeDrawer, getPreset, getPresetNames } from './pen/index.js';\n\nexport { GradualRenderer };\nexport { StrokeDrawer };\nexport { getPreset as getPenPreset };\nexport { getPresetNames as getPenPresetNames };\n\n// ============================================================================\n// Utilities\n// ============================================================================\n\nimport * as coordinateUtils from './utils/coordinateUtils.js';\nimport * as viewportUtils from './utils/viewportUtils.js';\n\nexport { coordinateUtils };\nexport { viewportUtils };\n\n// ============================================================================\n// PDF Extraction Utilities\n// ============================================================================\n\nimport { extractAllBlocks, extractMultiplePages } from './utils/pdfExtractor.js';\n\nexport { extractAllBlocks };\nexport { extractMultiplePages };\nexport { extractAllBlocks as extractPDFBlocks };\n\n// ============================================================================\n// Type Definitions & Validators\n// ============================================================================\n\nexport { normalizeAnnotationArray } from './types/validators.js';\nexport * as TypeValidators from './types/index.js';\n\n// ============================================================================\n// Framework Adapters\n// ============================================================================\n\nexport { AnnotPdf } from './adapters/index.js';\n\n// ============================================================================\n// AI Tools for Annotation Generation\n// ============================================================================\n\nexport {\n  annotationTools,\n  getAnnotationTools,\n  handleToolCall,\n  handleToolCalls,\n  createHighlight,\n  createText\n} from './ai-tools/index.js';\n\n// ============================================================================\n// Package Metadata\n// ============================================================================\n\nexport const VERSION = '1.0.0';\nexport const LIB_NAME = 'web-annotation-renderer';\n"],"names":["VERSION","LIB_NAME"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8HY,MAACA,IAAU,SACVC,IAAW;"}

package/dist/index10.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./index22.cjs");function d(n,e,i,l,t){let o=n;return typeof n=="string"&&(o=parseFloat(n)),typeof o!="number"||isNaN(o)?(t.push(`[${i}]: Field "${l}" invalid value "${n}", using default ${e}`),e):o<0?(t.push(`[${i}]: Field "${l}" value ${o} below range [0,1], clamping to 0`),0):o>1?(t.push(`[${i}]: Field "${l}" value ${o} exceeds range [0,1], clamping to 1`),1):o}function u(n,e,i,l){if(typeof n!="string"||n.trim().length===0)return l.push(`[${i}]: Invalid color format "${n}", using default ${e}`),e;const t=n.trim(),o=/^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/,r=/^rgba?\(\s*\d+\s*,\s*\d+\s*,\s*\d+\s*(,\s*[\d.]+\s*)?\)$/,a=["red","blue","green","yellow","black","white","gray","grey","orange","purple","pink","brown","transparent"],m=o.test(t),y=r.test(t),h=a.includes(t.toLowerCase());return m||y||h?t:(l.push(`[${i}]: Invalid color format "${n}", using default ${e}`),e)}function $(n,e,i,l,t){let o=n;return typeof n=="string"&&(o=parseFloat(n)),typeof o!="number"||isNaN(o)||o<=0?(t.push(`[${i}]: Field "${l}" invalid value "${n}", using default ${e}`),e):o}function f(n,e,i){const l={};if(typeof n.id!="string"||n.id.trim().length===0){const t=Date.now(),o=Math.random().toString(36).substr(2,9);l.id=`anno-${t}-${o}`,i.push(`[${l.id}]: Auto-generated ID (original was missing or invalid)`)}else l.id=n.id.trim();return l.type=n.type,typeof n.page!="number"||n.page<1?(e.push(`[${l.id}]: Field "page" invalid value "${n.page}", using default ${s.BASE_DEFAULTS.page}`),l.page=s.BASE_DEFAULTS.page):l.page=Math.floor(n.page),typeof n.start!="number"||n.start<0?(e.push(`[${l.id}]: Field "start" invalid value "${n.start}", using default ${s.BASE_DEFAULTS.start}`),l.start=s.BASE_DEFAULTS.start):l.start=n.start,typeof n.end!="number"||n.end<0?(e.push(`[${l.id}]: Field "end" invalid value "${n.end}", using start value ${l.start}`),l.end=l.start):n.end<l.start?(e.push(`[${l.id}]: Field "end" (${n.end}) less than start (${l.start}), clamping to start`),l.end=l.start):l.end=n.end,l}function A(n,e,i){return!n||typeof n!="object"?(i.push(`[${e}]: Invalid quad object, using default`),{x:.1,y:.1,w:.8,h:.05}):{x:d(n.x,.1,e,"quad.x",i),y:d(n.y,.1,e,"quad.y",i),w:d(n.w,.8,e,"quad.w",i),h:d(n.h,.05,e,"quad.h",i)}}function c(n,e,i,l){const t={...n};e.mode!=="quads"?(i.push(`[${n.id}]: Field "mode" invalid value "${e.mode}", using default "${s.HIGHLIGHT_DEFAULTS.mode}"`),t.mode=s.HIGHLIGHT_DEFAULTS.mode):t.mode=e.mode,!Array.isArray(e.quads)||e.quads.length===0?(i.push(`[${n.id}]: Field "quads" missing or empty, using default`),t.quads=s.HIGHLIGHT_DEFAULTS.quads):t.quads=e.quads.map((r,a)=>A(r,n.id,i));const o=s.HIGHLIGHT_DEFAULTS.style.color;return!e.style||typeof e.style!="object"?(i.push(`[${n.id}]: Field "style" missing or invalid, using default`),t.style={color:o}):t.style={color:u(e.style.color,o,n.id,i)},t}function p(n,e,i,l){const t={...n};typeof e.content!="string"||e.content.trim().length===0?(i.push(`[${n.id}]: Field "content" missing or empty, using default "${s.TEXT_DEFAULTS.content}"`),t.content=s.TEXT_DEFAULTS.content):t.content=e.content,t.x=d(e.x,s.TEXT_DEFAULTS.x,n.id,"x",i),t.y=d(e.y,s.TEXT_DEFAULTS.y,n.id,"y",i),t.w=d(e.w,s.TEXT_DEFAULTS.w,n.id,"w",i),t.h=d(e.h,s.TEXT_DEFAULTS.h,n.id,"h",i);const o=s.TEXT_DEFAULTS.style.bg,r=s.TEXT_DEFAULTS.style.color;return!e.style||typeof e.style!="object"?(i.push(`[${n.id}]: Field "style" missing or invalid, using defaults`),t.style={bg:o,color:r}):t.style={bg:u(e.style.bg,o,n.id,i),color:u(e.style.color,r,n.id,i)},t}function g(n,e){const i=[],l=[];if(!n||typeof n!="object")return{annotation:null,warnings:[],info:[],critical:`Annotation at index ${e}: Not a valid object`};if(typeof n.type!="string"||n.type.trim().length===0)return{annotation:null,warnings:[],info:[],critical:`Annotation at index ${e}: Missing or invalid type field`};const t=n.type.trim(),o=f(n,i,l);let r;if(t==="highlight")r=c(o,n,i);else if(t==="text")r=p(o,n,i);else return{annotation:null,warnings:[],info:[],critical:`Annotation at index ${e}: Unsupported type "${t}"`};return{annotation:r,warnings:i,info:l,critical:null}}function T(n,e={}){e.skipInvalid;const i=e.warnInConsole!==!1,l=e.onWarning||null,t={normalized:[],warnings:[],info:[],skipped:[]};if(!Array.isArray(n)){const o="normalizeAnnotationArray: Input is not an array, returning empty result";return t.warnings.push(o),i&&console.warn(`[Annotation Normalizer] ${o}`),t}return n.forEach((o,r)=>{if(o==null){t.skipped.push({index:r,annotation:o,reason:"Annotation is null or undefined"});return}const a=g(o,r);if(a.critical){t.skipped.push({index:r,annotation:o,reason:a.critical}),i&&console.error(`[Annotation Normalizer] ${a.critical}`);return}t.normalized.push(a.annotation),t.warnings.push(...a.warnings),t.info.push(...a.info)}),i&&(t.warnings.length>0||t.info.length>0||t.skipped.length>0)&&(console.group("[Annotation Normalizer] Validation Summary"),t.normalized.length>0&&console.info(`✓ Normalized ${t.normalized.length} annotation(s)`),t.skipped.length>0&&(console.error(`✗ Skipped ${t.skipped.length} annotation(s)`),t.skipped.forEach(o=>{console.error(`  Index ${o.index}: ${o.reason}`)})),t.warnings.length>0&&(console.warn(`⚠ ${t.warnings.length} warning(s):`),t.warnings.forEach(o=>console.warn(`  ${o}`))),t.info.length>0&&(console.info(`ℹ ${t.info.length} info message(s):`),t.info.forEach(o=>console.info(`  ${o}`))),console.groupEnd()),l&&typeof l=="function"&&l(t),t}exports.normalizeAnnotation=g;exports.normalizeAnnotationArray=T;exports.normalizeBaseFields=f;exports.normalizeColor=u;exports.normalizeCoordinate=d;exports.normalizeHighlight=c;exports.normalizePositiveNumber=$;exports.normalizeText=p;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./index25.cjs");function d(t,n,e,l,o){let i=t;return typeof t=="string"&&(i=parseFloat(t)),typeof i!="number"||isNaN(i)?(o.push(`[${e}]: Field "${l}" invalid value "${t}", using default ${n}`),n):i<0?(o.push(`[${e}]: Field "${l}" value ${i} below range [0,1], clamping to 0`),0):i>1?(o.push(`[${e}]: Field "${l}" value ${i} exceeds range [0,1], clamping to 1`),1):i}function c(t,n,e,l){if(typeof t!="string"||t.trim().length===0)return l.push(`[${e}]: Invalid color format "${t}", using default ${n}`),n;const o=t.trim(),i=/^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/,r=/^rgba?\(\s*\d+\s*,\s*\d+\s*,\s*\d+\s*(,\s*[\d.]+\s*)?\)$/,u=["red","blue","green","yellow","black","white","gray","grey","orange","purple","pink","brown","transparent"],$=i.test(o),E=r.test(o),T=u.includes(o.toLowerCase());return $||E||T?o:(l.push(`[${e}]: Invalid color format "${t}", using default ${n}`),n)}function F(t,n,e,l,o){let i=t;return typeof t=="string"&&(i=parseFloat(t)),typeof i!="number"||isNaN(i)||i<=0?(o.push(`[${e}]: Field "${l}" invalid value "${t}", using default ${n}`),n):i}function f(t,n,e){const l={};if(typeof t.id!="string"||t.id.trim().length===0){const o=Date.now(),i=Math.random().toString(36).substr(2,9);l.id=`anno-${o}-${i}`,e.push(`[${l.id}]: Auto-generated ID (original was missing or invalid)`)}else l.id=t.id.trim();return l.type=t.type,typeof t.page!="number"||t.page<1?(n.push(`[${l.id}]: Field "page" invalid value "${t.page}", using default ${s.BASE_DEFAULTS.page}`),l.page=s.BASE_DEFAULTS.page):l.page=Math.floor(t.page),typeof t.start!="number"||t.start<0?(n.push(`[${l.id}]: Field "start" invalid value "${t.start}", using default ${s.BASE_DEFAULTS.start}`),l.start=s.BASE_DEFAULTS.start):l.start=t.start,typeof t.end!="number"||t.end<0?(n.push(`[${l.id}]: Field "end" invalid value "${t.end}", using start value ${l.start}`),l.end=l.start):t.end<l.start?(n.push(`[${l.id}]: Field "end" (${t.end}) less than start (${l.start}), clamping to start`),l.end=l.start):l.end=t.end,l}function a(t,n,e){return!t||typeof t!="object"?(e.push(`[${n}]: Invalid quad object, using default`),{x:.1,y:.1,w:.8,h:.05}):{x:d(t.x,.1,n,"quad.x",e),y:d(t.y,.1,n,"quad.y",e),w:d(t.w,.8,n,"quad.w",e),h:d(t.h,.05,n,"quad.h",e)}}function y(t,n,e,l){const o={...t};n.mode!=="quads"?(e.push(`[${t.id}]: Field "mode" invalid value "${n.mode}", using default "${s.HIGHLIGHT_DEFAULTS.mode}"`),o.mode=s.HIGHLIGHT_DEFAULTS.mode):o.mode=n.mode,!Array.isArray(n.quads)||n.quads.length===0?(e.push(`[${t.id}]: Field "quads" missing or empty, using default`),o.quads=s.HIGHLIGHT_DEFAULTS.quads):o.quads=n.quads.map((r,u)=>a(r,t.id,e));const i=s.HIGHLIGHT_DEFAULTS.style.color;return!n.style||typeof n.style!="object"?(e.push(`[${t.id}]: Field "style" missing or invalid, using default`),o.style={color:i}):o.style={color:c(n.style.color,i,t.id,e)},o}function p(t,n,e,l){const o={...t};typeof n.content!="string"||n.content.trim().length===0?(e.push(`[${t.id}]: Field "content" missing or empty, using default "${s.TEXT_DEFAULTS.content}"`),o.content=s.TEXT_DEFAULTS.content):o.content=n.content,o.x=d(n.x,s.TEXT_DEFAULTS.x,t.id,"x",e),o.y=d(n.y,s.TEXT_DEFAULTS.y,t.id,"y",e),o.w=d(n.w,s.TEXT_DEFAULTS.w,t.id,"w",e),o.h=d(n.h,s.TEXT_DEFAULTS.h,t.id,"h",e);const i=s.TEXT_DEFAULTS.style.bg,r=s.TEXT_DEFAULTS.style.color;return!n.style||typeof n.style!="object"?(e.push(`[${t.id}]: Field "style" missing or invalid, using defaults`),o.style={bg:i,color:r}):o.style={bg:c(n.style.bg,i,t.id,e),color:c(n.style.color,r,t.id,e)},o}function m(t,n,e,l){const o={...t};!Array.isArray(n.quads)||n.quads.length===0?(e.push(`[${t.id}]: Field "quads" missing or empty, using default`),o.quads=s.UNDERLINE_DEFAULTS.quads):o.quads=n.quads.map(r=>a(r,t.id,e));const i=s.UNDERLINE_DEFAULTS.style.color;return!n.style||typeof n.style!="object"?o.style={color:i}:o.style={color:c(n.style.color,i,t.id,e)},o}function g(t,n,e,l){const o={...t};o.from_x=d(n.from_x,s.ARROW_DEFAULTS.from_x,t.id,"from_x",e),o.from_y=d(n.from_y,s.ARROW_DEFAULTS.from_y,t.id,"from_y",e),o.to_x=d(n.to_x,s.ARROW_DEFAULTS.to_x,t.id,"to_x",e),o.to_y=d(n.to_y,s.ARROW_DEFAULTS.to_y,t.id,"to_y",e);const i=s.ARROW_DEFAULTS.style.color;return!n.style||typeof n.style!="object"?o.style={color:i}:o.style={color:c(n.style.color,i,t.id,e)},o}function h(t,n,e,l){const o={...t};o.cx=d(n.cx,s.CIRCLE_DEFAULTS.cx,t.id,"cx",e),o.cy=d(n.cy,s.CIRCLE_DEFAULTS.cy,t.id,"cy",e),o.rx=d(n.rx,s.CIRCLE_DEFAULTS.rx,t.id,"rx",e),o.ry=d(n.ry,s.CIRCLE_DEFAULTS.ry,t.id,"ry",e);const i=s.CIRCLE_DEFAULTS.style.color;return!n.style||typeof n.style!="object"?o.style={color:i}:o.style={color:c(n.style.color,i,t.id,e)},o}function A(t,n){const e=[],l=[];if(!t||typeof t!="object")return{annotation:null,warnings:[],info:[],critical:`Annotation at index ${n}: Not a valid object`};if(typeof t.type!="string"||t.type.trim().length===0)return{annotation:null,warnings:[],info:[],critical:`Annotation at index ${n}: Missing or invalid type field`};const o=t.type.trim(),i=f(t,e,l);let r;if(o==="highlight")r=y(i,t,e);else if(o==="text")r=p(i,t,e);else if(o==="underline")r=m(i,t,e);else if(o==="arrow")r=g(i,t,e);else if(o==="circle")r=h(i,t,e);else return{annotation:null,warnings:[],info:[],critical:`Annotation at index ${n}: Unsupported type "${o}"`};return{annotation:r,warnings:e,info:l,critical:null}}function _(t,n={}){n.skipInvalid;const e=n.warnInConsole!==!1,l=n.onWarning||null,o={normalized:[],warnings:[],info:[],skipped:[]};if(!Array.isArray(t)){const i="normalizeAnnotationArray: Input is not an array, returning empty result";return o.warnings.push(i),e&&console.warn(`[Annotation Normalizer] ${i}`),o}return t.forEach((i,r)=>{if(i==null){o.skipped.push({index:r,annotation:i,reason:"Annotation is null or undefined"});return}const u=A(i,r);if(u.critical){o.skipped.push({index:r,annotation:i,reason:u.critical}),e&&console.error(`[Annotation Normalizer] ${u.critical}`);return}o.normalized.push(u.annotation),o.warnings.push(...u.warnings),o.info.push(...u.info)}),e&&(o.warnings.length>0||o.info.length>0||o.skipped.length>0)&&(console.group("[Annotation Normalizer] Validation Summary"),o.normalized.length>0&&console.info(`✓ Normalized ${o.normalized.length} annotation(s)`),o.skipped.length>0&&(console.error(`✗ Skipped ${o.skipped.length} annotation(s)`),o.skipped.forEach(i=>{console.error(`  Index ${i.index}: ${i.reason}`)})),o.warnings.length>0&&(console.warn(`⚠ ${o.warnings.length} warning(s):`),o.warnings.forEach(i=>console.warn(`  ${i}`))),o.info.length>0&&(console.info(`ℹ ${o.info.length} info message(s):`),o.info.forEach(i=>console.info(`  ${i}`))),console.groupEnd()),l&&typeof l=="function"&&l(o),o}exports.normalizeAnnotation=A;exports.normalizeAnnotationArray=_;exports.normalizeArrow=g;exports.normalizeBaseFields=f;exports.normalizeCircle=h;exports.normalizeColor=c;exports.normalizeCoordinate=d;exports.normalizeHighlight=y;exports.normalizePositiveNumber=F;exports.normalizeText=p;exports.normalizeUnderline=m;
 //# sourceMappingURL=index10.cjs.map

package/dist/index10.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index10.cjs","sources":["../src/types/validators.js"],"sourcesContent":["/**\n * Annotation Data Normalization Utilities\n *\n * This module provides defensive normalization functions that validate and fix\n * annotation data. Invalid values are replaced with safe defaults and warnings\n * are collected for user feedback.\n *\n * @module types/validators\n */\n\nimport {\n  BASE_DEFAULTS,\n  HIGHLIGHT_DEFAULTS,\n  TEXT_DEFAULTS\n} from './defaults.js';\n\n// ============================================================================\n// FIELD-LEVEL NORMALIZERS\n// ============================================================================\n\n/**\n * Normalize coordinate value to 0-1 range\n *\n * Validates that a value is a number in the 0-1 range. Out-of-range values\n * are clamped. Invalid values use the provided default.\n *\n * @param {*} value - Value to normalize\n * @param {number} defaultValue - Fallback value if invalid\n * @param {string} id - Annotation ID for warning messages\n * @param {string} fieldName - Field name for warning messages\n * @param {Array<string>} warnings - Array to collect warning messages\n * @returns {number} Normalized coordinate value in range [0, 1]\n *\n * @example\n * normalizeCoordinate(0.5, 0.1, 'txt-1', 'x', warnings)  // Returns: 0.5\n * normalizeCoordinate(5, 0.1, 'txt-1', 'x', warnings)    // Returns: 1, adds warning\n * normalizeCoordinate('abc', 0.1, 'txt-1', 'x', warnings) // Returns: 0.1, adds warning\n */\nexport function normalizeCoordinate(value, defaultValue, id, fieldName, warnings) {\n  // Type coercion: parse string to number if needed\n  let numValue = value;\n  if (typeof value === 'string') {\n    numValue = parseFloat(value);\n    if (!isNaN(numValue) && numValue === value) {\n      // Successfully parsed - no warning needed\n    }\n  }\n\n  // Validate is valid number\n  if (typeof numValue !== 'number' || isNaN(numValue)) {\n    warnings.push(\n      `[${id}]: Field \"${fieldName}\" invalid value \"${value}\", using default ${defaultValue}`\n    );\n    return defaultValue;\n  }\n\n  // Range check: clamp to [0, 1]\n  if (numValue < 0) {\n    warnings.push(\n      `[${id}]: Field \"${fieldName}\" value ${numValue} below range [0,1], clamping to 0`\n    );\n    return 0;\n  }\n\n  if (numValue > 1) {\n    warnings.push(\n      `[${id}]: Field \"${fieldName}\" value ${numValue} exceeds range [0,1], clamping to 1`\n    );\n    return 1;\n  }\n\n  // Valid value\n  return numValue;\n}\n\n/**\n * Normalize color string\n *\n * Validates that a value is a valid color string. Supports hex, rgb/rgba,\n * and named colors. Invalid colors use the provided default.\n *\n * @param {*} value - Color value to normalize\n * @param {string} defaultValue - Fallback color if invalid\n * @param {string} id - Annotation ID for warning messages\n * @param {Array<string>} warnings - Array to collect warning messages\n * @returns {string} Valid color string\n *\n * @example\n * normalizeColor('#fff', '#000', 'txt-1', warnings)           // Returns: '#fff'\n * normalizeColor('rgba(255,0,0,0.5)', '#000', 'txt-1', warnings) // Returns: 'rgba(255,0,0,0.5)'\n * normalizeColor('notacolor', '#000', 'txt-1', warnings)      // Returns: '#000', adds warning\n */\nexport function normalizeColor(value, defaultValue, id, warnings) {\n  // Type check: must be non-empty string\n  if (typeof value !== 'string' || value.trim().length === 0) {\n    warnings.push(\n      `[${id}]: Invalid color format \"${value}\", using default ${defaultValue}`\n    );\n    return defaultValue;\n  }\n\n  const trimmed = value.trim();\n\n  // Regex patterns for color validation (cached at module level)\n  const hexPattern = /^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/;\n  const rgbPattern = /^rgba?\\(\\s*\\d+\\s*,\\s*\\d+\\s*,\\s*\\d+\\s*(,\\s*[\\d.]+\\s*)?\\)$/;\n\n  // Named colors (basic set)\n  const namedColors = [\n    'red', 'blue', 'green', 'yellow', 'black', 'white', 'gray',\n    'grey', 'orange', 'purple', 'pink', 'brown', 'transparent'\n  ];\n\n  // Validate format\n  const isHex = hexPattern.test(trimmed);\n  const isRgb = rgbPattern.test(trimmed);\n  const isNamed = namedColors.includes(trimmed.toLowerCase());\n\n  if (isHex || isRgb || isNamed) {\n    return trimmed;\n  }\n\n  // Invalid format\n  warnings.push(\n    `[${id}]: Invalid color format \"${value}\", using default ${defaultValue}`\n  );\n  return defaultValue;\n}\n\n/**\n * Normalize positive number\n *\n * Validates that a value is a positive number. Invalid values use the\n * provided default.\n *\n * @param {*} value - Value to normalize\n * @param {number} defaultValue - Fallback value if invalid\n * @param {string} id - Annotation ID for warning messages\n * @param {string} fieldName - Field name for warning messages\n * @param {Array<string>} warnings - Array to collect warning messages\n * @returns {number} Positive number\n *\n * @example\n * normalizePositiveNumber(5, 3, 'ink-1', 'size', warnings)      // Returns: 5\n * normalizePositiveNumber(-1, 3, 'ink-1', 'size', warnings)     // Returns: 3, adds warning\n * normalizePositiveNumber('abc', 3, 'ink-1', 'size', warnings)  // Returns: 3, adds warning\n */\nexport function normalizePositiveNumber(value, defaultValue, id, fieldName, warnings) {\n  // Type coercion: parse string to number if needed\n  let numValue = value;\n  if (typeof value === 'string') {\n    numValue = parseFloat(value);\n  }\n\n  // Validate is valid number and positive\n  if (typeof numValue !== 'number' || isNaN(numValue) || numValue <= 0) {\n    warnings.push(\n      `[${id}]: Field \"${fieldName}\" invalid value \"${value}\", using default ${defaultValue}`\n    );\n    return defaultValue;\n  }\n\n  return numValue;\n}\n\n// ============================================================================\n// BASE FIELDS NORMALIZER\n// ============================================================================\n\n/**\n * Normalize common base annotation fields\n *\n * Validates and normalizes fields common to all annotation types: id, type,\n * page, start, and end. Auto-generates ID if missing. Applies safe defaults\n * for invalid values.\n *\n * @param {Object} raw - Raw annotation object\n * @param {Array<string>} warnings - Array to collect warning messages\n * @param {Array<string>} info - Array to collect info messages\n * @returns {Object} Object with normalized base fields\n *\n * @example\n * normalizeBaseFields({ type: 'text', page: 2 }, warnings, info)\n * // Returns: { id: 'anno-1234...', type: 'text', page: 2, start: 0, end: 0 }\n */\nexport function normalizeBaseFields(raw, warnings, info) {\n  const base = {};\n\n  // ===== ID Field =====\n  // Check: non-empty string\n  // Invalid: auto-generate unique ID\n  if (typeof raw.id !== 'string' || raw.id.trim().length === 0) {\n    const timestamp = Date.now();\n    const random = Math.random().toString(36).substr(2, 9);\n    base.id = `anno-${timestamp}-${random}`;\n    info.push(`[${base.id}]: Auto-generated ID (original was missing or invalid)`);\n  } else {\n    base.id = raw.id.trim();\n  }\n\n  // ===== Type Field =====\n  // Pass through as-is (validated in parent function)\n  base.type = raw.type;\n\n  // ===== Page Field =====\n  // Check: positive integer\n  // Invalid: default to 1\n  if (typeof raw.page !== 'number' || raw.page < 1) {\n    warnings.push(\n      `[${base.id}]: Field \"page\" invalid value \"${raw.page}\", using default ${BASE_DEFAULTS.page}`\n    );\n    base.page = BASE_DEFAULTS.page;\n  } else {\n    // Floor to ensure integer\n    base.page = Math.floor(raw.page);\n  }\n\n  // ===== Start Field =====\n  // Check: non-negative number\n  // Invalid: default to 0\n  if (typeof raw.start !== 'number' || raw.start < 0) {\n    warnings.push(\n      `[${base.id}]: Field \"start\" invalid value \"${raw.start}\", using default ${BASE_DEFAULTS.start}`\n    );\n    base.start = BASE_DEFAULTS.start;\n  } else {\n    base.start = raw.start;\n  }\n\n  // ===== End Field =====\n  // Check: non-negative number >= start\n  // Invalid: clamp to start value\n  if (typeof raw.end !== 'number' || raw.end < 0) {\n    warnings.push(\n      `[${base.id}]: Field \"end\" invalid value \"${raw.end}\", using start value ${base.start}`\n    );\n    base.end = base.start;\n  } else if (raw.end < base.start) {\n    warnings.push(\n      `[${base.id}]: Field \"end\" (${raw.end}) less than start (${base.start}), clamping to start`\n    );\n    base.end = base.start;\n  } else {\n    base.end = raw.end;\n  }\n\n  return base;\n}\n\n// ============================================================================\n// TYPE-SPECIFIC NORMALIZERS\n// ============================================================================\n\n/**\n * Normalize a single quad (rectangular region)\n *\n * @private\n * @param {Object} quad - Quad object with x, y, w, h\n * @param {string} id - Annotation ID\n * @param {Array<string>} warnings - Warnings array\n * @returns {Object} Normalized quad\n */\nfunction normalizeQuad(quad, id, warnings) {\n  if (!quad || typeof quad !== 'object') {\n    warnings.push(`[${id}]: Invalid quad object, using default`);\n    return { x: 0.1, y: 0.1, w: 0.8, h: 0.05 };\n  }\n\n  return {\n    x: normalizeCoordinate(quad.x, 0.1, id, 'quad.x', warnings),\n    y: normalizeCoordinate(quad.y, 0.1, id, 'quad.y', warnings),\n    w: normalizeCoordinate(quad.w, 0.8, id, 'quad.w', warnings),\n    h: normalizeCoordinate(quad.h, 0.05, id, 'quad.h', warnings)\n  };\n}\n\n/**\n * Normalize highlight annotation\n *\n * Validates and normalizes highlight-specific fields: mode, quads array,\n * and style.color. Applies defaults for invalid fields.\n *\n * @param {Object} base - Object with normalized base fields\n * @param {Object} raw - Raw annotation object\n * @param {Array<string>} warnings - Warnings array\n * @param {Array<string>} info - Info array\n * @returns {Object} Fully normalized highlight annotation\n *\n * @example\n * normalizeHighlight(base, raw, warnings, info)\n * // Returns: { ...base, mode: 'quads', quads: [...], style: {...} }\n */\nexport function normalizeHighlight(base, raw, warnings, info) {\n  const annotation = { ...base };\n\n  // ===== Mode Field =====\n  // Check: value equals \"quads\"\n  // Invalid: default to \"quads\"\n  if (raw.mode !== 'quads') {\n    warnings.push(\n      `[${base.id}]: Field \"mode\" invalid value \"${raw.mode}\", using default \"${HIGHLIGHT_DEFAULTS.mode}\"`\n    );\n    annotation.mode = HIGHLIGHT_DEFAULTS.mode;\n  } else {\n    annotation.mode = raw.mode;\n  }\n\n  // ===== Quads Array =====\n  // Check: non-empty array\n  // Invalid: use default quads\n  if (!Array.isArray(raw.quads) || raw.quads.length === 0) {\n    warnings.push(\n      `[${base.id}]: Field \"quads\" missing or empty, using default`\n    );\n    annotation.quads = HIGHLIGHT_DEFAULTS.quads;\n  } else {\n    // Normalize each quad\n    annotation.quads = raw.quads.map((quad, idx) => normalizeQuad(quad, base.id, warnings));\n  }\n\n  // ===== Style Object =====\n  // Check: object with color property\n  const defaultColor = HIGHLIGHT_DEFAULTS.style.color;\n  if (!raw.style || typeof raw.style !== 'object') {\n    warnings.push(\n      `[${base.id}]: Field \"style\" missing or invalid, using default`\n    );\n    annotation.style = { color: defaultColor };\n  } else {\n    annotation.style = {\n      color: normalizeColor(raw.style.color, defaultColor, base.id, warnings)\n    };\n  }\n\n  return annotation;\n}\n\n/**\n * Normalize text annotation\n *\n * Validates and normalizes text-specific fields: content, position (x, y),\n * dimensions (w, h), and style (bg, color). Applies defaults for invalid fields.\n *\n * @param {Object} base - Object with normalized base fields\n * @param {Object} raw - Raw annotation object\n * @param {Array<string>} warnings - Warnings array\n * @param {Array<string>} info - Info array\n * @returns {Object} Fully normalized text annotation\n *\n * @example\n * normalizeText(base, raw, warnings, info)\n * // Returns: { ...base, content: '...', x: 0.1, y: 0.1, w: 0.3, h: 0.1, style: {...} }\n */\nexport function normalizeText(base, raw, warnings, info) {\n  const annotation = { ...base };\n\n  // ===== Content Field =====\n  // Check: non-empty string\n  // Invalid: default to placeholder\n  if (typeof raw.content !== 'string' || raw.content.trim().length === 0) {\n    warnings.push(\n      `[${base.id}]: Field \"content\" missing or empty, using default \"${TEXT_DEFAULTS.content}\"`\n    );\n    annotation.content = TEXT_DEFAULTS.content;\n  } else {\n    annotation.content = raw.content;\n  }\n\n  // ===== Position Fields (x, y) =====\n  annotation.x = normalizeCoordinate(raw.x, TEXT_DEFAULTS.x, base.id, 'x', warnings);\n  annotation.y = normalizeCoordinate(raw.y, TEXT_DEFAULTS.y, base.id, 'y', warnings);\n\n  // ===== Dimension Fields (w, h) =====\n  annotation.w = normalizeCoordinate(raw.w, TEXT_DEFAULTS.w, base.id, 'w', warnings);\n  annotation.h = normalizeCoordinate(raw.h, TEXT_DEFAULTS.h, base.id, 'h', warnings);\n\n  // ===== Style Object =====\n  const defaultBg = TEXT_DEFAULTS.style.bg;\n  const defaultColor = TEXT_DEFAULTS.style.color;\n\n  if (!raw.style || typeof raw.style !== 'object') {\n    warnings.push(\n      `[${base.id}]: Field \"style\" missing or invalid, using defaults`\n    );\n    annotation.style = {\n      bg: defaultBg,\n      color: defaultColor\n    };\n  } else {\n    annotation.style = {\n      bg: normalizeColor(raw.style.bg, defaultBg, base.id, warnings),\n      color: normalizeColor(raw.style.color, defaultColor, base.id, warnings)\n    };\n  }\n\n  return annotation;\n}\n\n// ============================================================================\n// ORCHESTRATION - SINGLE ANNOTATION & ARRAY\n// ============================================================================\n\n/**\n * Normalize a single annotation\n *\n * Routes annotation to appropriate type-specific normalizer based on type field.\n * Handles critical validation errors (missing/invalid type).\n *\n * @param {Object} raw - Raw annotation object\n * @param {number} index - Position in original array (for error context)\n * @returns {Object} Result object with annotation, warnings, info, and critical error\n * @returns {Object|null} return.annotation - Normalized annotation or null if critical error\n * @returns {Array<string>} return.warnings - Warning messages\n * @returns {Array<string>} return.info - Info messages\n * @returns {string|null} return.critical - Critical error message or null\n *\n * @example\n * normalizeAnnotation({ type: 'text', content: 'Hello' }, 0)\n * // Returns: { annotation: {...}, warnings: [], info: [], critical: null }\n */\nexport function normalizeAnnotation(raw, index) {\n  const warnings = [];\n  const info = [];\n\n  // Validate input is object\n  if (!raw || typeof raw !== 'object') {\n    return {\n      annotation: null,\n      warnings: [],\n      info: [],\n      critical: `Annotation at index ${index}: Not a valid object`\n    };\n  }\n\n  // Check type field (critical - cannot route without type)\n  if (typeof raw.type !== 'string' || raw.type.trim().length === 0) {\n    return {\n      annotation: null,\n      warnings: [],\n      info: [],\n      critical: `Annotation at index ${index}: Missing or invalid type field`\n    };\n  }\n\n  const type = raw.type.trim();\n\n  // Normalize base fields first\n  const base = normalizeBaseFields(raw, warnings, info);\n\n  // Route to type-specific normalizer\n  let annotation;\n\n  if (type === 'highlight') {\n    annotation = normalizeHighlight(base, raw, warnings, info);\n  } else if (type === 'text') {\n    annotation = normalizeText(base, raw, warnings, info);\n  } else {\n    return {\n      annotation: null,\n      warnings: [],\n      info: [],\n      critical: `Annotation at index ${index}: Unsupported type \"${type}\"`\n    };\n  }\n\n  return {\n    annotation,\n    warnings,\n    info,\n    critical: null\n  };\n}\n\n/**\n * Normalize array of annotations\n *\n * MAIN ENTRY POINT for annotation normalization. Processes each annotation,\n * collects warnings, and returns normalized data ready for rendering.\n *\n * @param {Array} rawAnnotations - Array of raw annotation objects\n * @param {Object} [options] - Configuration options\n * @param {boolean} [options.skipInvalid=true] - Skip critically invalid annotations\n * @param {boolean} [options.warnInConsole=true] - Log warnings to console\n * @param {Function} [options.onWarning] - Custom warning callback\n * @returns {Object} ValidationResult with normalized annotations and messages\n * @returns {Array} return.normalized - Successfully normalized annotations\n * @returns {Array<string>} return.warnings - Warning messages\n * @returns {Array<string>} return.info - Informational messages\n * @returns {Array<Object>} return.skipped - Skipped annotations with reasons\n *\n * @example\n * const result = normalizeAnnotationArray(rawAnnotations, {\n *   skipInvalid: true,\n *   warnInConsole: true\n * });\n *\n * renderer.setAnnotations(result.normalized);\n */\nexport function normalizeAnnotationArray(rawAnnotations, options = {}) {\n  // Default options\n  const skipInvalid = options.skipInvalid !== false;  // Default: true\n  const warnInConsole = options.warnInConsole !== false;  // Default: true\n  const onWarning = options.onWarning || null;\n\n  // Initialize result structure\n  const result = {\n    normalized: [],\n    warnings: [],\n    info: [],\n    skipped: []\n  };\n\n  // Validate input is array\n  if (!Array.isArray(rawAnnotations)) {\n    const warning = 'normalizeAnnotationArray: Input is not an array, returning empty result';\n    result.warnings.push(warning);\n\n    if (warnInConsole) {\n      console.warn(`[Annotation Normalizer] ${warning}`);\n    }\n\n    return result;\n  }\n\n  // Process each annotation\n  rawAnnotations.forEach((raw, index) => {\n    // Skip null/undefined\n    if (raw == null) {\n      result.skipped.push({\n        index,\n        annotation: raw,\n        reason: 'Annotation is null or undefined'\n      });\n      return;\n    }\n\n    // Normalize annotation\n    const normalized = normalizeAnnotation(raw, index);\n\n    // Check for critical error\n    if (normalized.critical) {\n      result.skipped.push({\n        index,\n        annotation: raw,\n        reason: normalized.critical\n      });\n\n      if (warnInConsole) {\n        console.error(`[Annotation Normalizer] ${normalized.critical}`);\n      }\n\n      return;\n    }\n\n    // Add to normalized array\n    result.normalized.push(normalized.annotation);\n\n    // Collect warnings and info\n    result.warnings.push(...normalized.warnings);\n    result.info.push(...normalized.info);\n  });\n\n  // Console output\n  if (warnInConsole) {\n    if (result.warnings.length > 0 || result.info.length > 0 || result.skipped.length > 0) {\n      console.group('[Annotation Normalizer] Validation Summary');\n\n      if (result.normalized.length > 0) {\n        console.info(`✓ Normalized ${result.normalized.length} annotation(s)`);\n      }\n\n      if (result.skipped.length > 0) {\n        console.error(`✗ Skipped ${result.skipped.length} annotation(s)`);\n        result.skipped.forEach(s => {\n          console.error(`  Index ${s.index}: ${s.reason}`);\n        });\n      }\n\n      if (result.warnings.length > 0) {\n        console.warn(`⚠ ${result.warnings.length} warning(s):`);\n        result.warnings.forEach(w => console.warn(`  ${w}`));\n      }\n\n      if (result.info.length > 0) {\n        console.info(`ℹ ${result.info.length} info message(s):`);\n        result.info.forEach(i => console.info(`  ${i}`));\n      }\n\n      console.groupEnd();\n    }\n  }\n\n  // Call custom warning handler\n  if (onWarning && typeof onWarning === 'function') {\n    onWarning(result);\n  }\n\n  return result;\n}\n"],"names":["normalizeCoordinate","value","defaultValue","id","fieldName","warnings","numValue","normalizeColor","trimmed","hexPattern","rgbPattern","namedColors","isHex","isRgb","isNamed","normalizePositiveNumber","normalizeBaseFields","raw","info","base","timestamp","random","BASE_DEFAULTS","normalizeQuad","quad","normalizeHighlight","annotation","HIGHLIGHT_DEFAULTS","idx","defaultColor","normalizeText","TEXT_DEFAULTS","defaultBg","normalizeAnnotation","index","type","normalizeAnnotationArray","rawAnnotations","options","warnInConsole","onWarning","result","warning","normalized","s","w","i"],"mappings":"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"}
+{"version":3,"file":"index10.cjs","sources":["../src/types/validators.js"],"sourcesContent":["/**\n * Annotation Data Normalization Utilities\n *\n * This module provides defensive normalization functions that validate and fix\n * annotation data. Invalid values are replaced with safe defaults and warnings\n * are collected for user feedback.\n *\n * @module types/validators\n */\n\nimport {\n  BASE_DEFAULTS,\n  HIGHLIGHT_DEFAULTS,\n  TEXT_DEFAULTS,\n  UNDERLINE_DEFAULTS,\n  ARROW_DEFAULTS,\n  CIRCLE_DEFAULTS\n} from './defaults.js';\n\n// ============================================================================\n// FIELD-LEVEL NORMALIZERS\n// ============================================================================\n\n/**\n * Normalize coordinate value to 0-1 range\n *\n * Validates that a value is a number in the 0-1 range. Out-of-range values\n * are clamped. Invalid values use the provided default.\n *\n * @param {*} value - Value to normalize\n * @param {number} defaultValue - Fallback value if invalid\n * @param {string} id - Annotation ID for warning messages\n * @param {string} fieldName - Field name for warning messages\n * @param {Array<string>} warnings - Array to collect warning messages\n * @returns {number} Normalized coordinate value in range [0, 1]\n *\n * @example\n * normalizeCoordinate(0.5, 0.1, 'txt-1', 'x', warnings)  // Returns: 0.5\n * normalizeCoordinate(5, 0.1, 'txt-1', 'x', warnings)    // Returns: 1, adds warning\n * normalizeCoordinate('abc', 0.1, 'txt-1', 'x', warnings) // Returns: 0.1, adds warning\n */\nexport function normalizeCoordinate(value, defaultValue, id, fieldName, warnings) {\n  // Type coercion: parse string to number if needed\n  let numValue = value;\n  if (typeof value === 'string') {\n    numValue = parseFloat(value);\n    if (!isNaN(numValue) && numValue === value) {\n      // Successfully parsed - no warning needed\n    }\n  }\n\n  // Validate is valid number\n  if (typeof numValue !== 'number' || isNaN(numValue)) {\n    warnings.push(\n      `[${id}]: Field \"${fieldName}\" invalid value \"${value}\", using default ${defaultValue}`\n    );\n    return defaultValue;\n  }\n\n  // Range check: clamp to [0, 1]\n  if (numValue < 0) {\n    warnings.push(\n      `[${id}]: Field \"${fieldName}\" value ${numValue} below range [0,1], clamping to 0`\n    );\n    return 0;\n  }\n\n  if (numValue > 1) {\n    warnings.push(\n      `[${id}]: Field \"${fieldName}\" value ${numValue} exceeds range [0,1], clamping to 1`\n    );\n    return 1;\n  }\n\n  // Valid value\n  return numValue;\n}\n\n/**\n * Normalize color string\n *\n * Validates that a value is a valid color string. Supports hex, rgb/rgba,\n * and named colors. Invalid colors use the provided default.\n *\n * @param {*} value - Color value to normalize\n * @param {string} defaultValue - Fallback color if invalid\n * @param {string} id - Annotation ID for warning messages\n * @param {Array<string>} warnings - Array to collect warning messages\n * @returns {string} Valid color string\n *\n * @example\n * normalizeColor('#fff', '#000', 'txt-1', warnings)           // Returns: '#fff'\n * normalizeColor('rgba(255,0,0,0.5)', '#000', 'txt-1', warnings) // Returns: 'rgba(255,0,0,0.5)'\n * normalizeColor('notacolor', '#000', 'txt-1', warnings)      // Returns: '#000', adds warning\n */\nexport function normalizeColor(value, defaultValue, id, warnings) {\n  // Type check: must be non-empty string\n  if (typeof value !== 'string' || value.trim().length === 0) {\n    warnings.push(\n      `[${id}]: Invalid color format \"${value}\", using default ${defaultValue}`\n    );\n    return defaultValue;\n  }\n\n  const trimmed = value.trim();\n\n  // Regex patterns for color validation (cached at module level)\n  const hexPattern = /^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/;\n  const rgbPattern = /^rgba?\\(\\s*\\d+\\s*,\\s*\\d+\\s*,\\s*\\d+\\s*(,\\s*[\\d.]+\\s*)?\\)$/;\n\n  // Named colors (basic set)\n  const namedColors = [\n    'red', 'blue', 'green', 'yellow', 'black', 'white', 'gray',\n    'grey', 'orange', 'purple', 'pink', 'brown', 'transparent'\n  ];\n\n  // Validate format\n  const isHex = hexPattern.test(trimmed);\n  const isRgb = rgbPattern.test(trimmed);\n  const isNamed = namedColors.includes(trimmed.toLowerCase());\n\n  if (isHex || isRgb || isNamed) {\n    return trimmed;\n  }\n\n  // Invalid format\n  warnings.push(\n    `[${id}]: Invalid color format \"${value}\", using default ${defaultValue}`\n  );\n  return defaultValue;\n}\n\n/**\n * Normalize positive number\n *\n * Validates that a value is a positive number. Invalid values use the\n * provided default.\n *\n * @param {*} value - Value to normalize\n * @param {number} defaultValue - Fallback value if invalid\n * @param {string} id - Annotation ID for warning messages\n * @param {string} fieldName - Field name for warning messages\n * @param {Array<string>} warnings - Array to collect warning messages\n * @returns {number} Positive number\n *\n * @example\n * normalizePositiveNumber(5, 3, 'ink-1', 'size', warnings)      // Returns: 5\n * normalizePositiveNumber(-1, 3, 'ink-1', 'size', warnings)     // Returns: 3, adds warning\n * normalizePositiveNumber('abc', 3, 'ink-1', 'size', warnings)  // Returns: 3, adds warning\n */\nexport function normalizePositiveNumber(value, defaultValue, id, fieldName, warnings) {\n  // Type coercion: parse string to number if needed\n  let numValue = value;\n  if (typeof value === 'string') {\n    numValue = parseFloat(value);\n  }\n\n  // Validate is valid number and positive\n  if (typeof numValue !== 'number' || isNaN(numValue) || numValue <= 0) {\n    warnings.push(\n      `[${id}]: Field \"${fieldName}\" invalid value \"${value}\", using default ${defaultValue}`\n    );\n    return defaultValue;\n  }\n\n  return numValue;\n}\n\n// ============================================================================\n// BASE FIELDS NORMALIZER\n// ============================================================================\n\n/**\n * Normalize common base annotation fields\n *\n * Validates and normalizes fields common to all annotation types: id, type,\n * page, start, and end. Auto-generates ID if missing. Applies safe defaults\n * for invalid values.\n *\n * @param {Object} raw - Raw annotation object\n * @param {Array<string>} warnings - Array to collect warning messages\n * @param {Array<string>} info - Array to collect info messages\n * @returns {Object} Object with normalized base fields\n *\n * @example\n * normalizeBaseFields({ type: 'text', page: 2 }, warnings, info)\n * // Returns: { id: 'anno-1234...', type: 'text', page: 2, start: 0, end: 0 }\n */\nexport function normalizeBaseFields(raw, warnings, info) {\n  const base = {};\n\n  // ===== ID Field =====\n  // Check: non-empty string\n  // Invalid: auto-generate unique ID\n  if (typeof raw.id !== 'string' || raw.id.trim().length === 0) {\n    const timestamp = Date.now();\n    const random = Math.random().toString(36).substr(2, 9);\n    base.id = `anno-${timestamp}-${random}`;\n    info.push(`[${base.id}]: Auto-generated ID (original was missing or invalid)`);\n  } else {\n    base.id = raw.id.trim();\n  }\n\n  // ===== Type Field =====\n  // Pass through as-is (validated in parent function)\n  base.type = raw.type;\n\n  // ===== Page Field =====\n  // Check: positive integer\n  // Invalid: default to 1\n  if (typeof raw.page !== 'number' || raw.page < 1) {\n    warnings.push(\n      `[${base.id}]: Field \"page\" invalid value \"${raw.page}\", using default ${BASE_DEFAULTS.page}`\n    );\n    base.page = BASE_DEFAULTS.page;\n  } else {\n    // Floor to ensure integer\n    base.page = Math.floor(raw.page);\n  }\n\n  // ===== Start Field =====\n  // Check: non-negative number\n  // Invalid: default to 0\n  if (typeof raw.start !== 'number' || raw.start < 0) {\n    warnings.push(\n      `[${base.id}]: Field \"start\" invalid value \"${raw.start}\", using default ${BASE_DEFAULTS.start}`\n    );\n    base.start = BASE_DEFAULTS.start;\n  } else {\n    base.start = raw.start;\n  }\n\n  // ===== End Field =====\n  // Check: non-negative number >= start\n  // Invalid: clamp to start value\n  if (typeof raw.end !== 'number' || raw.end < 0) {\n    warnings.push(\n      `[${base.id}]: Field \"end\" invalid value \"${raw.end}\", using start value ${base.start}`\n    );\n    base.end = base.start;\n  } else if (raw.end < base.start) {\n    warnings.push(\n      `[${base.id}]: Field \"end\" (${raw.end}) less than start (${base.start}), clamping to start`\n    );\n    base.end = base.start;\n  } else {\n    base.end = raw.end;\n  }\n\n  return base;\n}\n\n// ============================================================================\n// TYPE-SPECIFIC NORMALIZERS\n// ============================================================================\n\n/**\n * Normalize a single quad (rectangular region)\n *\n * @private\n * @param {Object} quad - Quad object with x, y, w, h\n * @param {string} id - Annotation ID\n * @param {Array<string>} warnings - Warnings array\n * @returns {Object} Normalized quad\n */\nfunction normalizeQuad(quad, id, warnings) {\n  if (!quad || typeof quad !== 'object') {\n    warnings.push(`[${id}]: Invalid quad object, using default`);\n    return { x: 0.1, y: 0.1, w: 0.8, h: 0.05 };\n  }\n\n  return {\n    x: normalizeCoordinate(quad.x, 0.1, id, 'quad.x', warnings),\n    y: normalizeCoordinate(quad.y, 0.1, id, 'quad.y', warnings),\n    w: normalizeCoordinate(quad.w, 0.8, id, 'quad.w', warnings),\n    h: normalizeCoordinate(quad.h, 0.05, id, 'quad.h', warnings)\n  };\n}\n\n/**\n * Normalize highlight annotation\n *\n * Validates and normalizes highlight-specific fields: mode, quads array,\n * and style.color. Applies defaults for invalid fields.\n *\n * @param {Object} base - Object with normalized base fields\n * @param {Object} raw - Raw annotation object\n * @param {Array<string>} warnings - Warnings array\n * @param {Array<string>} info - Info array\n * @returns {Object} Fully normalized highlight annotation\n *\n * @example\n * normalizeHighlight(base, raw, warnings, info)\n * // Returns: { ...base, mode: 'quads', quads: [...], style: {...} }\n */\nexport function normalizeHighlight(base, raw, warnings, info) {\n  const annotation = { ...base };\n\n  // ===== Mode Field =====\n  // Check: value equals \"quads\"\n  // Invalid: default to \"quads\"\n  if (raw.mode !== 'quads') {\n    warnings.push(\n      `[${base.id}]: Field \"mode\" invalid value \"${raw.mode}\", using default \"${HIGHLIGHT_DEFAULTS.mode}\"`\n    );\n    annotation.mode = HIGHLIGHT_DEFAULTS.mode;\n  } else {\n    annotation.mode = raw.mode;\n  }\n\n  // ===== Quads Array =====\n  // Check: non-empty array\n  // Invalid: use default quads\n  if (!Array.isArray(raw.quads) || raw.quads.length === 0) {\n    warnings.push(\n      `[${base.id}]: Field \"quads\" missing or empty, using default`\n    );\n    annotation.quads = HIGHLIGHT_DEFAULTS.quads;\n  } else {\n    // Normalize each quad\n    annotation.quads = raw.quads.map((quad, idx) => normalizeQuad(quad, base.id, warnings));\n  }\n\n  // ===== Style Object =====\n  // Check: object with color property\n  const defaultColor = HIGHLIGHT_DEFAULTS.style.color;\n  if (!raw.style || typeof raw.style !== 'object') {\n    warnings.push(\n      `[${base.id}]: Field \"style\" missing or invalid, using default`\n    );\n    annotation.style = { color: defaultColor };\n  } else {\n    annotation.style = {\n      color: normalizeColor(raw.style.color, defaultColor, base.id, warnings)\n    };\n  }\n\n  return annotation;\n}\n\n/**\n * Normalize text annotation\n *\n * Validates and normalizes text-specific fields: content, position (x, y),\n * dimensions (w, h), and style (bg, color). Applies defaults for invalid fields.\n *\n * @param {Object} base - Object with normalized base fields\n * @param {Object} raw - Raw annotation object\n * @param {Array<string>} warnings - Warnings array\n * @param {Array<string>} info - Info array\n * @returns {Object} Fully normalized text annotation\n *\n * @example\n * normalizeText(base, raw, warnings, info)\n * // Returns: { ...base, content: '...', x: 0.1, y: 0.1, w: 0.3, h: 0.1, style: {...} }\n */\nexport function normalizeText(base, raw, warnings, info) {\n  const annotation = { ...base };\n\n  // ===== Content Field =====\n  // Check: non-empty string\n  // Invalid: default to placeholder\n  if (typeof raw.content !== 'string' || raw.content.trim().length === 0) {\n    warnings.push(\n      `[${base.id}]: Field \"content\" missing or empty, using default \"${TEXT_DEFAULTS.content}\"`\n    );\n    annotation.content = TEXT_DEFAULTS.content;\n  } else {\n    annotation.content = raw.content;\n  }\n\n  // ===== Position Fields (x, y) =====\n  annotation.x = normalizeCoordinate(raw.x, TEXT_DEFAULTS.x, base.id, 'x', warnings);\n  annotation.y = normalizeCoordinate(raw.y, TEXT_DEFAULTS.y, base.id, 'y', warnings);\n\n  // ===== Dimension Fields (w, h) =====\n  annotation.w = normalizeCoordinate(raw.w, TEXT_DEFAULTS.w, base.id, 'w', warnings);\n  annotation.h = normalizeCoordinate(raw.h, TEXT_DEFAULTS.h, base.id, 'h', warnings);\n\n  // ===== Style Object =====\n  const defaultBg = TEXT_DEFAULTS.style.bg;\n  const defaultColor = TEXT_DEFAULTS.style.color;\n\n  if (!raw.style || typeof raw.style !== 'object') {\n    warnings.push(\n      `[${base.id}]: Field \"style\" missing or invalid, using defaults`\n    );\n    annotation.style = {\n      bg: defaultBg,\n      color: defaultColor\n    };\n  } else {\n    annotation.style = {\n      bg: normalizeColor(raw.style.bg, defaultBg, base.id, warnings),\n      color: normalizeColor(raw.style.color, defaultColor, base.id, warnings)\n    };\n  }\n\n  return annotation;\n}\n\n/**\n * Normalize underline annotation\n *\n * Validates and normalizes underline-specific fields: quads array and style.color.\n * Uses same quad structure as highlight for consistency.\n *\n * @param {Object} base - Object with normalized base fields\n * @param {Object} raw - Raw annotation object\n * @param {Array<string>} warnings - Warnings array\n * @param {Array<string>} info - Info array\n * @returns {Object} Fully normalized underline annotation\n */\nexport function normalizeUnderline(base, raw, warnings, info) {\n  const annotation = { ...base };\n\n  // ===== Quads Array =====\n  if (!Array.isArray(raw.quads) || raw.quads.length === 0) {\n    warnings.push(\n      `[${base.id}]: Field \"quads\" missing or empty, using default`\n    );\n    annotation.quads = UNDERLINE_DEFAULTS.quads;\n  } else {\n    annotation.quads = raw.quads.map((quad) => normalizeQuad(quad, base.id, warnings));\n  }\n\n  // ===== Style Object =====\n  const defaultColor = UNDERLINE_DEFAULTS.style.color;\n  if (!raw.style || typeof raw.style !== 'object') {\n    annotation.style = { color: defaultColor };\n  } else {\n    annotation.style = {\n      color: normalizeColor(raw.style.color, defaultColor, base.id, warnings)\n    };\n  }\n\n  return annotation;\n}\n\n/**\n * Normalize arrow annotation\n *\n * Validates and normalizes arrow-specific fields: from_x, from_y, to_x, to_y,\n * and style.color.\n *\n * @param {Object} base - Object with normalized base fields\n * @param {Object} raw - Raw annotation object\n * @param {Array<string>} warnings - Warnings array\n * @param {Array<string>} info - Info array\n * @returns {Object} Fully normalized arrow annotation\n */\nexport function normalizeArrow(base, raw, warnings, info) {\n  const annotation = { ...base };\n\n  // ===== Coordinate Fields =====\n  annotation.from_x = normalizeCoordinate(raw.from_x, ARROW_DEFAULTS.from_x, base.id, 'from_x', warnings);\n  annotation.from_y = normalizeCoordinate(raw.from_y, ARROW_DEFAULTS.from_y, base.id, 'from_y', warnings);\n  annotation.to_x = normalizeCoordinate(raw.to_x, ARROW_DEFAULTS.to_x, base.id, 'to_x', warnings);\n  annotation.to_y = normalizeCoordinate(raw.to_y, ARROW_DEFAULTS.to_y, base.id, 'to_y', warnings);\n\n  // ===== Style Object =====\n  const defaultColor = ARROW_DEFAULTS.style.color;\n  if (!raw.style || typeof raw.style !== 'object') {\n    annotation.style = { color: defaultColor };\n  } else {\n    annotation.style = {\n      color: normalizeColor(raw.style.color, defaultColor, base.id, warnings)\n    };\n  }\n\n  return annotation;\n}\n\n/**\n * Normalize circle annotation\n *\n * Validates and normalizes circle-specific fields: cx, cy, rx, ry,\n * and style.color.\n *\n * @param {Object} base - Object with normalized base fields\n * @param {Object} raw - Raw annotation object\n * @param {Array<string>} warnings - Warnings array\n * @param {Array<string>} info - Info array\n * @returns {Object} Fully normalized circle annotation\n */\nexport function normalizeCircle(base, raw, warnings, info) {\n  const annotation = { ...base };\n\n  // ===== Center and Radii Fields =====\n  annotation.cx = normalizeCoordinate(raw.cx, CIRCLE_DEFAULTS.cx, base.id, 'cx', warnings);\n  annotation.cy = normalizeCoordinate(raw.cy, CIRCLE_DEFAULTS.cy, base.id, 'cy', warnings);\n  annotation.rx = normalizeCoordinate(raw.rx, CIRCLE_DEFAULTS.rx, base.id, 'rx', warnings);\n  annotation.ry = normalizeCoordinate(raw.ry, CIRCLE_DEFAULTS.ry, base.id, 'ry', warnings);\n\n  // ===== Style Object =====\n  const defaultColor = CIRCLE_DEFAULTS.style.color;\n  if (!raw.style || typeof raw.style !== 'object') {\n    annotation.style = { color: defaultColor };\n  } else {\n    annotation.style = {\n      color: normalizeColor(raw.style.color, defaultColor, base.id, warnings)\n    };\n  }\n\n  return annotation;\n}\n\n// ============================================================================\n// ORCHESTRATION - SINGLE ANNOTATION & ARRAY\n// ============================================================================\n\n/**\n * Normalize a single annotation\n *\n * Routes annotation to appropriate type-specific normalizer based on type field.\n * Handles critical validation errors (missing/invalid type).\n *\n * @param {Object} raw - Raw annotation object\n * @param {number} index - Position in original array (for error context)\n * @returns {Object} Result object with annotation, warnings, info, and critical error\n * @returns {Object|null} return.annotation - Normalized annotation or null if critical error\n * @returns {Array<string>} return.warnings - Warning messages\n * @returns {Array<string>} return.info - Info messages\n * @returns {string|null} return.critical - Critical error message or null\n *\n * @example\n * normalizeAnnotation({ type: 'text', content: 'Hello' }, 0)\n * // Returns: { annotation: {...}, warnings: [], info: [], critical: null }\n */\nexport function normalizeAnnotation(raw, index) {\n  const warnings = [];\n  const info = [];\n\n  // Validate input is object\n  if (!raw || typeof raw !== 'object') {\n    return {\n      annotation: null,\n      warnings: [],\n      info: [],\n      critical: `Annotation at index ${index}: Not a valid object`\n    };\n  }\n\n  // Check type field (critical - cannot route without type)\n  if (typeof raw.type !== 'string' || raw.type.trim().length === 0) {\n    return {\n      annotation: null,\n      warnings: [],\n      info: [],\n      critical: `Annotation at index ${index}: Missing or invalid type field`\n    };\n  }\n\n  const type = raw.type.trim();\n\n  // Normalize base fields first\n  const base = normalizeBaseFields(raw, warnings, info);\n\n  // Route to type-specific normalizer\n  let annotation;\n\n  if (type === 'highlight') {\n    annotation = normalizeHighlight(base, raw, warnings, info);\n  } else if (type === 'text') {\n    annotation = normalizeText(base, raw, warnings, info);\n  } else if (type === 'underline') {\n    annotation = normalizeUnderline(base, raw, warnings, info);\n  } else if (type === 'arrow') {\n    annotation = normalizeArrow(base, raw, warnings, info);\n  } else if (type === 'circle') {\n    annotation = normalizeCircle(base, raw, warnings, info);\n  } else {\n    return {\n      annotation: null,\n      warnings: [],\n      info: [],\n      critical: `Annotation at index ${index}: Unsupported type \"${type}\"`\n    };\n  }\n\n  return {\n    annotation,\n    warnings,\n    info,\n    critical: null\n  };\n}\n\n/**\n * Normalize array of annotations\n *\n * MAIN ENTRY POINT for annotation normalization. Processes each annotation,\n * collects warnings, and returns normalized data ready for rendering.\n *\n * @param {Array} rawAnnotations - Array of raw annotation objects\n * @param {Object} [options] - Configuration options\n * @param {boolean} [options.skipInvalid=true] - Skip critically invalid annotations\n * @param {boolean} [options.warnInConsole=true] - Log warnings to console\n * @param {Function} [options.onWarning] - Custom warning callback\n * @returns {Object} ValidationResult with normalized annotations and messages\n * @returns {Array} return.normalized - Successfully normalized annotations\n * @returns {Array<string>} return.warnings - Warning messages\n * @returns {Array<string>} return.info - Informational messages\n * @returns {Array<Object>} return.skipped - Skipped annotations with reasons\n *\n * @example\n * const result = normalizeAnnotationArray(rawAnnotations, {\n *   skipInvalid: true,\n *   warnInConsole: true\n * });\n *\n * renderer.setAnnotations(result.normalized);\n */\nexport function normalizeAnnotationArray(rawAnnotations, options = {}) {\n  // Default options\n  const skipInvalid = options.skipInvalid !== false;  // Default: true\n  const warnInConsole = options.warnInConsole !== false;  // Default: true\n  const onWarning = options.onWarning || null;\n\n  // Initialize result structure\n  const result = {\n    normalized: [],\n    warnings: [],\n    info: [],\n    skipped: []\n  };\n\n  // Validate input is array\n  if (!Array.isArray(rawAnnotations)) {\n    const warning = 'normalizeAnnotationArray: Input is not an array, returning empty result';\n    result.warnings.push(warning);\n\n    if (warnInConsole) {\n      console.warn(`[Annotation Normalizer] ${warning}`);\n    }\n\n    return result;\n  }\n\n  // Process each annotation\n  rawAnnotations.forEach((raw, index) => {\n    // Skip null/undefined\n    if (raw == null) {\n      result.skipped.push({\n        index,\n        annotation: raw,\n        reason: 'Annotation is null or undefined'\n      });\n      return;\n    }\n\n    // Normalize annotation\n    const normalized = normalizeAnnotation(raw, index);\n\n    // Check for critical error\n    if (normalized.critical) {\n      result.skipped.push({\n        index,\n        annotation: raw,\n        reason: normalized.critical\n      });\n\n      if (warnInConsole) {\n        console.error(`[Annotation Normalizer] ${normalized.critical}`);\n      }\n\n      return;\n    }\n\n    // Add to normalized array\n    result.normalized.push(normalized.annotation);\n\n    // Collect warnings and info\n    result.warnings.push(...normalized.warnings);\n    result.info.push(...normalized.info);\n  });\n\n  // Console output\n  if (warnInConsole) {\n    if (result.warnings.length > 0 || result.info.length > 0 || result.skipped.length > 0) {\n      console.group('[Annotation Normalizer] Validation Summary');\n\n      if (result.normalized.length > 0) {\n        console.info(`✓ Normalized ${result.normalized.length} annotation(s)`);\n      }\n\n      if (result.skipped.length > 0) {\n        console.error(`✗ Skipped ${result.skipped.length} annotation(s)`);\n        result.skipped.forEach(s => {\n          console.error(`  Index ${s.index}: ${s.reason}`);\n        });\n      }\n\n      if (result.warnings.length > 0) {\n        console.warn(`⚠ ${result.warnings.length} warning(s):`);\n        result.warnings.forEach(w => console.warn(`  ${w}`));\n      }\n\n      if (result.info.length > 0) {\n        console.info(`ℹ ${result.info.length} info message(s):`);\n        result.info.forEach(i => console.info(`  ${i}`));\n      }\n\n      console.groupEnd();\n    }\n  }\n\n  // Call custom warning handler\n  if (onWarning && typeof onWarning === 'function') {\n    onWarning(result);\n  }\n\n  return result;\n}\n"],"names":["normalizeCoordinate","value","defaultValue","id","fieldName","warnings","numValue","normalizeColor","trimmed","hexPattern","rgbPattern","namedColors","isHex","isRgb","isNamed","normalizePositiveNumber","normalizeBaseFields","raw","info","base","timestamp","random","BASE_DEFAULTS","normalizeQuad","quad","normalizeHighlight","annotation","HIGHLIGHT_DEFAULTS","idx","defaultColor","normalizeText","TEXT_DEFAULTS","defaultBg","normalizeUnderline","UNDERLINE_DEFAULTS","normalizeArrow","ARROW_DEFAULTS","normalizeCircle","CIRCLE_DEFAULTS","normalizeAnnotation","index","type","normalizeAnnotationArray","rawAnnotations","options","warnInConsole","onWarning","result","warning","normalized","s","w"],"mappings":"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"}