ReticleJS

Changelog

All notable changes to ReticleJS will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.0] - 2026-11-20

Initial v1.0.0 public release of ReticleJS, a zero-runtime-dependency TypeScript image annotation SDK with 15 tree-shakeable subpath exports.

Core (reticlejs, reticlejs/core)

  • Headless Editor kernel (7.08 KB gz): Pure Document model, typed event bus, op-based CommandStack undo/redo with continuous-edit merging, and extensible Plugin API.
  • Web Components & Export: <marker-area> interactive editor, <marker-view> read-only viewer, and Renderer for flattened PNG / JPEG / WebP rasterization and SVG export without canvas tainting.
  • 20 Standard Markers: Frame, caption frame, ellipse frame, ellipse, highlight, cover/redact, destructive blur, destructive pixelate, arrow, line, curved arrow, measurement, freehand, highlighter, polygon, text, callout, check/cross stamps, and custom image stamps.
  • Editing Ergonomics: Multi-select, rotation-aware handles and cursors, smart edge/center snapping with guides, keyboard shortcuts, clipboard copy/cut/paste (including system image paste), inline text editing, zoom-at-cursor, and pan.

Pro Editing (reticlejs/pro)

  • Pro Editing Pack: Auto-renumbering StepMarker (numbered callout steps), MagnifierMarker zoom loupe, align & distribute operations, marker grouping/ungrouping, layer visibility/lock/rename, and non-destructive/destructive canvas crop & 90°/180°/270° rotation.

On-Device AI (reticlejs/ai-redact, reticlejs/ai-pro)

  • On-Device PII & Face Redaction (reticlejs/ai-redact, 1.56 KB gz): Zero-egress local detection for emails, phone numbers, Luhn-validated credit cards, SSNs, API keys/secrets, IPv4 addresses, and faces with human-in-the-loop accept/reject proposals and atomic undoable BlurMarker/PixelateMarker application.
  • On-Device AI Pro (reticlejs/ai-pro): SmartSelectPlugin click-to-outline segmentation, WebGPU Sam2WebGpuProvider and Florence2Provider adapters, RasterOcrProvider, air-gapped ModelCache with SHA-256 verification and Cache API persistence, SmartCleanup client-side inpainting/text background fill, and generateAltText / generateBugReportMarkdown exporters.

Agentic & MCP (reticlejs/agentic)

  • Set-of-Mark (SoM) Visual Grounding: SetOfMarkPlugin and generateSetOfMark() producing crisp alphanumeric [A1]/[B2] SVG overlays and structured manifests for vision-language models.
  • MCP JSON-RPC 2.0 Server Adapter: ReticleMcpServer exposing reticle_get_state, reticle_add_marker, reticle_update_marker, reticle_remove_markers, reticle_redact_region, reticle_undo, reticle_redo, and reticle_export_report tools plus ping and reticle://state, reticle://report, and reticle://alt-text resources backed directly by undoable Editor commands.
  • Describe-to-Annotate NL Planner: NlPlannerPlugin with pluggable VLM provider support and deterministic offline natural-language parsing into reviewable BatchCommand proposals.

Frameworks & Formats (reticlejs/wrappers/*, reticlejs/formats)

  • Zero-Dependency Framework Wrappers: Official subpath wrappers for React (reticlejs/wrappers/react), Vue 3 (reticlejs/wrappers/vue), Svelte (reticlejs/wrappers/svelte), and Angular (reticlejs/wrappers/angular).
  • Standard Interop & ML Formats: Pure-TypeScript PDF-1.4 export (exportToPdfBytes, createPdfBlob), W3C Web Annotation Data Model, COCO JSON, and Pascal VOC XML round-trip import/export.

Enterprise & C2PA (reticlejs/enterprise)

  • Collaboration & Review: Yjs-compatible CrdtSyncPlugin + AwarenessStore live presence, CommentsPlugin threaded comments with @mentions and approval workflows, and ComparisonController / diffAnnotationStates version diff and Before/After swipe comparison.
  • Headless Server Rendering: Pure-Node renderStateToSvgString and batchRenderToSvg with strictCsp: true mode (zero DOM, zero inline style attributes).
  • C2PA Provenance & Redaction Audit: C2paProvenancePlugin with Web Crypto ECDSA (createWebCryptoEcdsaSigner) and HSM proxy signers, JPEG/PNG EXIF/GPS/text metadata stripping (stripImageMetadata), signed manifest verification (verifySignedManifest), and tamper-evident SHA-256 RedactionAuditCertificate export & verification (exportRedactionAudit, verifyRedactionAudit).

Domain Precision (reticlejs/pro, reticlejs/enterprise)

  • Calibrated Engineering & Medical Measurements: CalibratedMeasurementPlugin for reference-line scale calibration (mm, cm, m, in, ft, px), distance, rectangle area, polygon area/perimeter, and 3-point angle measurement.
  • Smart Snapped Connectors: SmartConnectorsPlugin binding arrows and curved connectors to marker anchor ports with automatic rerouting on move/resize.
  • Video Keyframe Tracking & Multi-Page / Deep-Zoom: VideoFramePlugin, VideoTrackManager linear/spline keyframe interpolation, and DocumentCollection multi-page + tiled image pyramid helpers.

Headless UI & Mobile Bridge (reticlejs/ui, reticlejs/wrappers/mobile)

  • Headless UI Primitives & Design Tokens: Unstyled createToolbarState, createPropertyInspectorState, and createLayersState controllers, CSS custom-property token maps, dark/light/high-contrast themes, and createI18n localization helpers.
  • Mobile & Skia Bridge: reticlejs/wrappers/mobile translating AnnotationState into platform-agnostic draw commands and gesture inputs for React Native, Capacitor, and Skia surfaces.

Benchmarks & Packaging

  • Deterministic Benchmark Suite (npm run benchmark): Verified 0.70 ms median 1,000-marker batch add, 2.27 ms median 1,000-marker strict-CSP headless SVG render, and 100.00% recall / 100.00% precision on the 36-sample on-device PII corpus (see docs/BENCHMARKS.md).
  • Bundle Budget Enforcement (npm run check:budget): Automated verification of all 15 subpath exports (ESM, CJS, .d.ts) and gzipped size budgets.
  • Hardened npm Package: Strict package.json files allowlist publishing only dist/lib, LICENSE, COMMERCIAL-LICENSE.md, README.md, and CHANGELOG.md.