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
Editorkernel (7.08 KBgz): PureDocumentmodel, typed event bus, op-basedCommandStackundo/redo with continuous-edit merging, and extensiblePluginAPI. - Web Components & Export:
<marker-area>interactive editor,<marker-view>read-only viewer, andRendererfor 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),MagnifierMarkerzoom 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 KBgz): 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 undoableBlurMarker/PixelateMarkerapplication. - On-Device AI Pro (
reticlejs/ai-pro):SmartSelectPluginclick-to-outline segmentation, WebGPUSam2WebGpuProviderandFlorence2Provideradapters,RasterOcrProvider, air-gappedModelCachewith SHA-256 verification andCache APIpersistence,SmartCleanupclient-side inpainting/text background fill, andgenerateAltText/generateBugReportMarkdownexporters.
Agentic & MCP (reticlejs/agentic)
- Set-of-Mark (SoM) Visual Grounding:
SetOfMarkPluginandgenerateSetOfMark()producing crisp alphanumeric[A1]/[B2]SVG overlays and structured manifests for vision-language models. - MCP JSON-RPC 2.0 Server Adapter:
ReticleMcpServerexposingreticle_get_state,reticle_add_marker,reticle_update_marker,reticle_remove_markers,reticle_redact_region,reticle_undo,reticle_redo, andreticle_export_reporttools pluspingandreticle://state,reticle://report, andreticle://alt-textresources backed directly by undoableEditorcommands. - Describe-to-Annotate NL Planner:
NlPlannerPluginwith pluggable VLM provider support and deterministic offline natural-language parsing into reviewableBatchCommandproposals.
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+AwarenessStorelive presence,CommentsPluginthreaded comments with@mentionsand approval workflows, andComparisonController/diffAnnotationStatesversion diff and Before/After swipe comparison. - Headless Server Rendering: Pure-Node
renderStateToSvgStringandbatchRenderToSvgwithstrictCsp: truemode (zero DOM, zero inlinestyleattributes). - C2PA Provenance & Redaction Audit:
C2paProvenancePluginwith Web Crypto ECDSA (createWebCryptoEcdsaSigner) and HSM proxy signers, JPEG/PNG EXIF/GPS/text metadata stripping (stripImageMetadata), signed manifest verification (verifySignedManifest), and tamper-evident SHA-256RedactionAuditCertificateexport & verification (exportRedactionAudit,verifyRedactionAudit).
Domain Precision (reticlejs/pro, reticlejs/enterprise)
- Calibrated Engineering & Medical Measurements:
CalibratedMeasurementPluginfor reference-line scale calibration (mm,cm,m,in,ft,px), distance, rectangle area, polygon area/perimeter, and 3-point angle measurement. - Smart Snapped Connectors:
SmartConnectorsPluginbinding arrows and curved connectors to marker anchor ports with automatic rerouting on move/resize. - Video Keyframe Tracking & Multi-Page / Deep-Zoom:
VideoFramePlugin,VideoTrackManagerlinear/spline keyframe interpolation, andDocumentCollectionmulti-page + tiled image pyramid helpers.
Headless UI & Mobile Bridge (reticlejs/ui, reticlejs/wrappers/mobile)
- Headless UI Primitives & Design Tokens: Unstyled
createToolbarState,createPropertyInspectorState, andcreateLayersStatecontrollers, CSS custom-property token maps, dark/light/high-contrast themes, andcreateI18nlocalization helpers. - Mobile & Skia Bridge:
reticlejs/wrappers/mobiletranslatingAnnotationStateinto platform-agnostic draw commands and gesture inputs for React Native, Capacitor, and Skia surfaces.
Benchmarks & Packaging
- Deterministic Benchmark Suite (
npm run benchmark): Verified0.70 msmedian 1,000-marker batch add,2.27 msmedian 1,000-marker strict-CSP headless SVG render, and100.00%recall /100.00%precision on the 36-sample on-device PII corpus (seedocs/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.jsonfilesallowlist publishing onlydist/lib,LICENSE,COMMERCIAL-LICENSE.md,README.md, andCHANGELOG.md.