web-annotation-renderer 0.5.2 → 0.5.4

package/CHANGELOG.md

@@ -5,6 +5,87 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.3] - 2025-01-20
+
+### Fixed
+
+- Documentation updates to reflect current implementation
+- Removed outdated ink annotation references from README
+- Updated ARCHITECTURE.md to document StrokeRenderer-based architecture
+- Fixed AI_TOOLS_README.md to match actual exported functions
+
+## [0.5.0] - 2025-01-15
+
+### Added
+
+- New annotation types: `underline`, `arrow`, `circle`
+- `underlineToStrokes` converter for underline annotations
+- `arrowToStrokes` converter for arrow annotations with arrowhead
+- `circleToStrokes` converter for circle/ellipse annotations
+
+### Changed
+
+- **BREAKING:** Removed `ink` annotation type
+- Text annotations now use single-stroke font for hand-written style
+- Text animations are now character-by-character instead of word-by-word
+
+### Removed
+
+- `ink` annotation type and related converter
+- `create_ink_annotation` AI tool schema
+
+## [0.4.0] - 2025-01-10
+
+### Added
+
+- `StrokeRenderer` - Unified canvas-based annotation renderer
+- Converter architecture for annotation-to-stroke transformation
+- Support for custom converters via `registerConverter()`
+- Variable-width stroke rendering with pressure simulation
+- High-DPI display support in StrokeRenderer
+
+### Changed
+
+- **BREAKING:** Replaced DOM-based layer rendering with canvas-based StrokeRenderer
+- All annotation types now render through unified stroke pipeline
+- Improved progressive animation with endpoint interpolation
+
+### Removed
+
+- `LayerManager` class (replaced by StrokeRenderer)
+- `HighlightLayer`, `TextLayer`, `DrawingLayer` classes
+- DOM-based annotation rendering
+
+## [0.3.0] - 2025-01-05
+
+### Added
+
+- `textToStrokes` converter using single-stroke font library
+- Single-stroke font JSON data for Latin characters
+- Path subdivision for smoother text animation
+- `uniformScale` support for aspect-ratio preserving text
+
+### Changed
+
+- Text annotations render as strokes instead of DOM elements
+- Improved text animation timing with path-aware duration
+
+## [0.2.0] - 2025-12-20
+
+### Added
+
+- OpenAI function calling schemas for AI-generated annotations
+- `create_highlight_annotation` tool
+- `create_text_annotation` tool
+- `handleToolCall()` and `handleToolCalls()` functions
+- `createHighlight()` and `createText()` creator functions
+- `sentence_ref` field for timing synchronization
+
+### Changed
+
+- AI tools use normalized coordinate format (0-1)
+- Improved validation for annotation parameters
+
 ## [0.1.0] - 2025-10-25
 
 ### Added
@@ -12,11 +93,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Initial release of @ai-annotator/renderer
 - Framework-agnostic core rendering engine
 - PDF rendering with pdf.js integration
-- Timeline synchronization system
+- Timeline synchronization system (TimelineSync)
 - React adapter component (AnnotPdf)
 - Support for highlight annotations with progressive reveal
-- Support for text box annotations with word-by-word reveal
-- Support for ink/drawing annotations with progressive strokes
+- Support for text box annotations
+- Support for ink/drawing annotations (later removed in 0.5.0)
 - Coordinate utilities for normalized positioning
 - Viewport utilities for responsive rendering
 - Type validators for annotation data
@@ -25,10 +106,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Features
 
-- Automatic worker configuration (zero config for consumers)
 - Tree-shakeable exports
 - Source maps for debugging
 - TypeScript-friendly JSDoc annotations
 - Comprehensive error handling
 
+[0.5.3]: https://github.com/jhl72e/pdfAutoAnnotator/compare/v0.5.0...v0.5.3
+[0.5.0]: https://github.com/jhl72e/pdfAutoAnnotator/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/jhl72e/pdfAutoAnnotator/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/jhl72e/pdfAutoAnnotator/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/jhl72e/pdfAutoAnnotator/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/jhl72e/pdfAutoAnnotator/releases/tag/v0.1.0

package/README.md

@@ -11,14 +11,14 @@ This library renders structured annotation data (highlights, text boxes, drawing
 
 - 📄 **PDF Rendering** - Built on pdf.js for reliable PDF display
 - ⏱️ **Timeline Synchronization** - Sync annotations with audio/video playback or manual controls
-- 🎨 **Multiple Annotation Types** - Highlights, text boxes, and ink drawings
+- 🎨 **Multiple Annotation Types** - Highlights, text, underlines, arrows, and circles
 - ⚛️ **Framework Agnostic** - Core engine works with any framework
 - ⚛️ **React Adapter** - Ready-to-use React component included
 - 🎯 **Progressive Animations** - Smooth reveal animations based on timeline
 - 🎬 **Continuous Sync** - Built-in support for real-time audio/video synchronization
 - 📦 **Simple Setup** - One-line worker configuration
 - 🌲 **Tree-shakeable** - Import only what you need
-- ⚡ **Performance Optimized** - Efficient rendering without unnecessary re-draws
+- ⚡ **Performance Optimized** - Efficient canvas-based rendering with StrokeRenderer
 
 ## Installation
 
@@ -530,13 +530,13 @@ All annotations use **normalized coordinates** (0-1 range) for positioning, maki
 
 All annotation types share these base fields:
 
-| Field   | Type   | Required | Description                                          |
-| ------- | ------ | -------- | ---------------------------------------------------- |
-| `id`    | string | ✅ Yes   | Unique identifier for the annotation                 |
-| `type`  | string | ✅ Yes   | Annotation type: `"highlight"`, `"text"`, or `"ink"` |
-| `page`  | number | ✅ Yes   | Page number (1-indexed)                              |
-| `start` | number | ✅ Yes   | Timeline start time in seconds                       |
-| `end`   | number | ✅ Yes   | Timeline end time in seconds                         |
+| Field   | Type   | Required | Description                                                              |
+| ------- | ------ | -------- | ------------------------------------------------------------------------ |
+| `id`    | string | ✅ Yes   | Unique identifier for the annotation                                     |
+| `type`  | string | ✅ Yes   | Annotation type: `"highlight"`, `"text"`, `"underline"`, `"arrow"`, or `"circle"` |
+| `page`  | number | ✅ Yes   | Page number (1-indexed)                                                  |
+| `start` | number | ✅ Yes   | Timeline start time in seconds                                           |
+| `end`   | number | ✅ Yes   | Timeline end time in seconds                                             |
 
 ---
 
@@ -603,7 +603,7 @@ Highlights rectangular regions on the PDF with progressive reveal animation.
 
 ### Text Annotations
 
-Display text boxes with progressive typing animation.
+Display hand-written style text with progressive character-by-character animation using single-stroke fonts.
 
 **Type:** `"text"`
 
@@ -616,31 +616,27 @@ Display text boxes with progressive typing animation.
   page: 1,
   start: 3,
   end: 8,
-  content: "This is the annotation text content",
-  x: 0.5,   // Left position (normalized)
-  y: 0.2,   // Top position (normalized)
-  w: 0.3,   // Width (normalized)
-  h: 0.1,   // Height (normalized)
+  content: "This is the annotation text",
+  x: 0.5,        // Left position (normalized)
+  y: 0.2,        // Top position (normalized)
+  fontSize: 16,  // Font size in pixels
   style: {
-    bg: "rgba(255, 255, 255, 0.95)",    // Background color
-    color: "#1f2937"                     // Text color
+    color: "rgba(220, 20, 60, 1.0)"  // Text color
   }
 }
 ```
 
 **Fields:**
 
-| Field         | Type   | Required | Default                   | Description                     |
-| ------------- | ------ | -------- | ------------------------- | ------------------------------- |
-| `content`     | string | ✅ Yes   | -                         | Text to display                 |
-| `x`           | number | ✅ Yes   | -                         | Left position (0-1, normalized) |
-| `y`           | number | ✅ Yes   | -                         | Top position (0-1, normalized)  |
-| `w`           | number | ✅ Yes   | -                         | Width (0-1, normalized)         |
-| `h`           | number | ✅ Yes   | -                         | Height (0-1, normalized)        |
-| `style.bg`    | string | No       | `"rgba(255,255,255,0.9)"` | Background color                |
-| `style.color` | string | No       | `"#1f2937"`               | Text color                      |
+| Field         | Type   | Required | Default                      | Description                     |
+| ------------- | ------ | -------- | ---------------------------- | ------------------------------- |
+| `content`     | string | ✅ Yes   | -                            | Text to display                 |
+| `x`           | number | ✅ Yes   | -                            | Left position (0-1, normalized) |
+| `y`           | number | ✅ Yes   | -                            | Top position (0-1, normalized)  |
+| `fontSize`    | number | No       | `16`                         | Font size in pixels             |
+| `style.color` | string | No       | `"rgba(220, 20, 60, 1.0)"`   | Text stroke color               |
 
-**Animation:** Text appears word-by-word with a typing effect during the `start` to `end` timeline.
+**Animation:** Text is drawn character-by-character using single-stroke font glyphs, creating a hand-written writing effect.
 
 **Example:**
 
@@ -651,102 +647,127 @@ Display text boxes with progressive typing animation.
   page: 1,
   start: 5.0,
   end: 12.0,
-  content: "Important concept to remember",
+  content: "Important concept",
   x: 0.6,
   y: 0.4,
-  w: 0.25,
-  h: 0.08,
+  fontSize: 18,
   style: {
-    bg: "rgba(255, 255, 200, 0.95)",
-    color: "#0066cc"
+    color: "rgba(0, 100, 200, 1.0)"
   }
 }
 ```
 
 ---
 
-### Ink Annotations
+### Underline Annotations
 
-Draw strokes/paths with progressive reveal animation.
+Draw underlines beneath text regions with progressive reveal animation.
 
-**Type:** `"ink"`
+**Type:** `"underline"`
 
 **Structure:**
 
 ```javascript
 {
-  id: "ink-1",
-  type: "ink",
+  id: "underline-1",
+  type: "underline",
   page: 1,
-  start: 10,
-  end: 15,
-  strokes: [
-    {
-      color: "rgb(255, 0, 0)",
-      size: 3,
-      points: [
-        { t: 0.0, x: 0.2, y: 0.5 },
-        { t: 0.5, x: 0.3, y: 0.45 },
-        { t: 1.0, x: 0.4, y: 0.5 }
-      ]
-    }
-  ]
+  start: 0,
+  end: 2,
+  quads: [
+    { x: 0.1, y: 0.2, w: 0.8, h: 0.05 }
+  ],
+  style: { color: "rgba(0, 0, 255, 0.8)" }
 }
 ```
 
 **Fields:**
 
-| Field              | Type   | Required | Default     | Description                          |
-| ------------------ | ------ | -------- | ----------- | ------------------------------------ |
-| `strokes`          | Array  | ✅ Yes   | -           | Array of stroke objects              |
-| `strokes[].color`  | string | No       | `"#1f2937"` | CSS color for stroke                 |
-| `strokes[].size`   | number | No       | `3`         | Line width in pixels                 |
-| `strokes[].points` | Array  | ✅ Yes   | -           | Array of point objects               |
-| `points[].t`       | number | ✅ Yes   | -           | Time within stroke (0-1, normalized) |
-| `points[].x`       | number | ✅ Yes   | -           | X position (0-1, normalized)         |
-| `points[].y`       | number | ✅ Yes   | -           | Y position (0-1, normalized)         |
+| Field         | Type   | Required | Default                  | Description                     |
+| ------------- | ------ | -------- | ------------------------ | ------------------------------- |
+| `quads`       | Array  | ✅ Yes   | -                        | Array of quad objects           |
+| `quads[].x`   | number | ✅ Yes   | -                        | Left position (0-1, normalized) |
+| `quads[].y`   | number | ✅ Yes   | -                        | Top position (0-1, normalized)  |
+| `quads[].w`   | number | ✅ Yes   | -                        | Width (0-1, normalized)         |
+| `quads[].h`   | number | ✅ Yes   | -                        | Height (0-1, normalized)        |
+| `style.color` | string | No       | `"rgba(0, 0, 255, 0.8)"` | Underline color                 |
 
-**Important:**
+**Animation:** Underlines draw progressively at the bottom edge of each quad from left to right.
 
-- Each point **must have a `t` parameter** representing its position in time within the stroke (0-1 range)
-- The `t` values are used for progressive drawing animation
-- Points should be ordered by increasing `t` values
+---
 
-**Animation:** Strokes are drawn progressively based on the `t` parameter of each point during the `start` to `end` timeline.
+### Arrow Annotations
 
-**Example:**
+Draw arrows pointing from source to target with progressive reveal animation.
+
+**Type:** `"arrow"`
+
+**Structure:**
 
 ```javascript
 {
-  id: "ink-1",
-  type: "ink",
+  id: "arrow-1",
+  type: "arrow",
   page: 1,
-  start: 8.0,
-  end: 13.0,
-  strokes: [
-    {
-      color: "rgb(255, 0, 0)",
-      size: 2,
-      points: [
-        { t: 0.0, x: 0.2, y: 0.4 },
-        { t: 0.25, x: 0.25, y: 0.38 },
-        { t: 0.5, x: 0.3, y: 0.4 },
-        { t: 0.75, x: 0.35, y: 0.42 },
-        { t: 1.0, x: 0.4, y: 0.4 }
-      ]
-    },
-    {
-      color: "rgb(255, 0, 0)",
-      size: 2,
-      points: [
-        { t: 0.0, x: 0.22, y: 0.45 },
-        { t: 1.0, x: 0.38, y: 0.45 }
-      ]
-    }
-  ]
+  start: 0,
+  end: 2,
+  from_x: 0.2,
+  from_y: 0.3,
+  to_x: 0.8,
+  to_y: 0.7,
+  style: { color: "rgba(255, 0, 0, 0.8)" }
+}
+```
+
+**Fields:**
+
+| Field         | Type   | Required | Default                  | Description                       |
+| ------------- | ------ | -------- | ------------------------ | --------------------------------- |
+| `from_x`      | number | ✅ Yes   | -                        | Source x position (0-1)           |
+| `from_y`      | number | ✅ Yes   | -                        | Source y position (0-1)           |
+| `to_x`        | number | ✅ Yes   | -                        | Target x position (0-1)           |
+| `to_y`        | number | ✅ Yes   | -                        | Target y position (0-1)           |
+| `style.color` | string | No       | `"rgba(255, 0, 0, 0.8)"` | Arrow color                       |
+
+**Animation:** Line draws first (70% of duration), then arrowhead wings draw (30% of duration).
+
+---
+
+### Circle Annotations
+
+Draw circles/ellipses with progressive reveal animation around the perimeter.
+
+**Type:** `"circle"`
+
+**Structure:**
+
+```javascript
+{
+  id: "circle-1",
+  type: "circle",
+  page: 1,
+  start: 0,
+  end: 2,
+  cx: 0.5,
+  cy: 0.5,
+  rx: 0.1,
+  ry: 0.1,
+  style: { color: "rgba(255, 165, 0, 0.8)" }
 }
 ```
 
+**Fields:**
+
+| Field         | Type   | Required | Default                    | Description                   |
+| ------------- | ------ | -------- | -------------------------- | ----------------------------- |
+| `cx`          | number | ✅ Yes   | -                          | Center x position (0-1)       |
+| `cy`          | number | ✅ Yes   | -                          | Center y position (0-1)       |
+| `rx`          | number | ✅ Yes   | -                          | Horizontal radius (0-1)       |
+| `ry`          | number | ✅ Yes   | -                          | Vertical radius (0-1)         |
+| `style.color` | string | No       | `"rgba(255, 165, 0, 0.8)"` | Circle color                  |
+
+**Animation:** Circle draws progressively around the perimeter from 0° to 360°.
+
 ---
 
 ### Coordinate System
@@ -783,7 +804,7 @@ const annotations = [
     style: { color: "rgba(255, 255, 0, 0.4)" },
   },
 
-  // Text
+  // Text (hand-written style)
   {
     id: "t1",
     type: "text",
@@ -793,32 +814,47 @@ const annotations = [
     content: "Key concept here",
     x: 0.6,
     y: 0.2,
-    w: 0.25,
-    h: 0.08,
-    style: {
-      bg: "rgba(255, 255, 255, 0.95)",
-      color: "#0066cc",
-    },
+    fontSize: 16,
+    style: { color: "rgba(220, 20, 60, 1.0)" },
   },
 
-  // Ink
+  // Underline
   {
-    id: "i1",
-    type: "ink",
+    id: "u1",
+    type: "underline",
     page: 1,
-    start: 6,
+    start: 5,
+    end: 7,
+    quads: [{ x: 0.1, y: 0.3, w: 0.4, h: 0.03 }],
+    style: { color: "rgba(0, 0, 255, 0.8)" },
+  },
+
+  // Arrow
+  {
+    id: "a1",
+    type: "arrow",
+    page: 1,
+    start: 7,
     end: 10,
-    strokes: [
-      {
-        color: "rgb(255, 0, 0)",
-        size: 3,
-        points: [
-          { t: 0.0, x: 0.2, y: 0.5 },
-          { t: 0.5, x: 0.3, y: 0.45 },
-          { t: 1.0, x: 0.4, y: 0.5 },
-        ],
-      },
-    ],
+    from_x: 0.2,
+    from_y: 0.5,
+    to_x: 0.6,
+    to_y: 0.6,
+    style: { color: "rgba(255, 0, 0, 0.8)" },
+  },
+
+  // Circle
+  {
+    id: "c1",
+    type: "circle",
+    page: 1,
+    start: 10,
+    end: 13,
+    cx: 0.75,
+    cy: 0.4,
+    rx: 0.08,
+    ry: 0.06,
+    style: { color: "rgba(255, 165, 0, 0.8)" },
   },
 ];
 ```
@@ -846,10 +882,10 @@ Requires:
 **Solutions:**
 
 1. Check that highlight annotations include `mode: "quads"` field
-2. Verify text annotations use `type: "text"` (not `"textBox"`)
-3. Ensure ink annotation points have `t` parameter
-4. Check browser console for validation warnings
-5. Verify timeline position is within annotation `start`/`end` range
+2. Verify annotation `type` is one of: `"highlight"`, `"text"`, `"underline"`, `"arrow"`, `"circle"`
+3. Check browser console for validation warnings (unknown type warnings)
+4. Verify timeline position is within annotation `start`/`end` range
+5. Ensure coordinates are normalized (0-1 range)
 
 ### Worker errors
 
@@ -893,8 +929,9 @@ If you're upgrading from documentation examples that used the old format:
 1. **Package name:** `@ai-annotator/renderer` → `web-annotation-renderer`
 2. **Method name:** `renderer.updateTimeline()` → `renderer.setTime()`
 3. **Highlight annotations:** Must include `mode: "quads"` field
-4. **Text annotations:** Use `type: "text"` (not `"textBox"`), `content` (not `text`), flat coordinates, and `style.bg`/`style.color`
-5. **Ink annotations:** Use `strokes` (not `paths`), `size` (not `width`), and points must have `t` parameter
+4. **Text annotations:** Now render as hand-written style using single-stroke font; use `fontSize` instead of `w`/`h`
+5. **Ink annotations:** Removed in v0.5.0; use `arrow`, `underline`, or `circle` instead
+6. **New annotation types:** `underline`, `arrow`, `circle` added in v0.5.0
 
 ### Quick Migration
 
@@ -926,8 +963,8 @@ Both examples include:
 - PDF loading and rendering
 - Page navigation and zoom controls
 - Timeline slider with annotation synchronization
-- All three annotation types (highlight, text, ink)
-- Optimized rendering for smooth, flicker-free updates
+- All five annotation types (highlight, text, underline, arrow, circle)
+- Optimized canvas-based rendering for smooth, flicker-free updates
 
 **Use Cases:**
 - **Manual timeline control** (sliders, buttons): Use `setTime()` for discrete updates

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"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;
+"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="0.5.3",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 {\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"}
+{"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 = '0.5.3';\nexport const LIB_NAME = 'web-annotation-renderer';\n"],"names":["VERSION","LIB_NAME"],"mappings":"2rBA8HaA,EAAU,QACVC,EAAW"}

package/dist/index.js

@@ -21,7 +21,7 @@ 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";
+const t = "0.5.3", a = "web-annotation-renderer";
 export {
   N as AnnotPdf,
   n as AnnotationRenderer,

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 {\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;"}
+{"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 = '0.5.3';\nexport const LIB_NAME = 'web-annotation-renderer';\n"],"names":["VERSION","LIB_NAME"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8HY,MAACA,IAAU,SACVC,IAAW;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web-annotation-renderer",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "type": "module",
   "description": "Framework-agnostic PDF annotation renderer with timeline synchronization for educational content and interactive documents",
   "keywords": [