Skip to main content

Changelog

1.2.2 - 25 June 2026​

Changed​

  • TrueScale glasses sizing is now disabled by default. Set trueScaleEnabled: true to enable it.

1.2.1 - 24 June 2026​

Added​

  • trueScaleEnabled parameter for disabling TrueScale glasses sizing in AR.

1.2.0 - 15 May 2026​

Added​

  • zoomIn3D(power) and zoomOut3D(power) methods for programmatic zoom control in 3D.
  • rotateHorizontally3D(degrees) and rotateVertically3D(degrees) methods for programmatic rotation in 3D.
  • Callbacks for detecting zoom and vertical angle limits in 3D.
  • onFirstAREngagement callback fired on first subject detection in AR.
  • onFirst3DEngagement callback fired on first user interaction in 3D.

Fixed​

  • AR prompt image incorrectly exposed to screen readers.
  • Initial animation in 3D not interrupted by panning.
  • Camera jump shortly after interaction when using initialAnimation.

1.1.2 - 30 March 2026​

Added​

  • customArVideo parameter for providing a custom video source in AR instead of the default camera.
  • customTrueScaleFaceWidth parameter for providing a custom face width (in millimeters) for TrueScale glasses AR.

1.1.1 - 24 March 2026​

Added​

  • Bundled default AR prompt image.

Fixed​

  • arPromptEnabled type in SkuData corrected from string to boolean.

Changed​

  • Updated DeepAR to 5.6.22.

1.1.0 - 2 March 2026​

Added​

  • skuData parameter for plugging-in custom data sources.
  • SanitizationError error type for SKU data sanitization failures.
  • 3D and AR close event tracking with duration, engagement duration and trigger type.
  • 3D and AR performance event tracking.

Fixed​

  • SKU data sanitization errors unnecessarily retried.
  • Overreported engagement analytics in glasses VTO.

1.0.2 - 18 February 2026​

Added​

  • 3D and AR launch success event tracking.
  • Duration and stack trace tracking for 3D and AR launch failure events.
  • Duration and cache hit/miss status tracking for API call events.

Fixed​

  • DeepAR disposal logic and error handling during shutdown and initialization.

1.0.1 - 13 February 2026​

Fixed​

  • Error when 3D launch quickly cancelled.

1.0.0 - 9 February 2026​

Added​

  • Customizable and accurate loading bar in 3D.
  • Distinct error types for granulated error handling: ValidationError, ApiError, Launch3DError, LaunchARError, CameraPermissionDeniedError, QRError.
  • More details when reporting API & file download errors.

Fixed​

  • Race condition when accessing <shopar-3d> before CustomElementRegistry definition.
  • Race condition resulting in uninitialized WebGL renderer in 3D.
  • Various memory leaks in 3D and AR.
  • Animation loop running even when 3D closed.
  • Download body read failures not retried.
  • Failed downloads being stored in cache.
  • baseUrl parameter ignored when fetching DRACO decoder in 3D.

Changed​

  • Replaced default.css injection with CSS variables for all UI elements.
  • Disabled in-memory download cache to avoid wasting unused resources.
  • Improved load time in 3D by preloading DRACO decoder.
  • Improved cleanup in 3D.
  • <shopar-3d> now unmounts on plugin close.
  • Loading bar in 3D now accurately shows init progress.
  • Improved cleanup in AR.
  • DeepAR now shuts down on plugin close.
  • Updated DeepAR to 5.6.21.

0.9.4 - 23 December 2025​

Added​

  • AR prompt text override.

0.9.3 - 1 December 2025​

Fixed​

  • Bug preventing different diamond materials from using different ray bounce values.

0.9.2 - 27 October 2025​

Fixed​

  • Bloom artifacts when using transparent background.

0.9.1 - 23 October 2025​

Added​

  • In-memory cache for API responses.

Changed​

  • Improved API error analytics.

0.9.0 - 15 October 2025​

Added​

  • onDebounced3DEngagement callback for tracking user engagement in 3D.
  • debounce3DEngagementMs parameter for configuring 3D engagement debounce duration.
  • onDebouncedAREngagement callback for tracking user engagement in AR.
  • debounceAREngagementMs parameter for configuring AR engagement debounce duration.

0.8.10 - 27 August 2025​

Fixed​

  • Security patches.

0.8.9 - 2 May 2025​

Added​

  • touchAction, minZoom and maxZoom parameters for 3D.

Fixed​

  • Missing validation for zoomEnabled and alwaysTransparentBackground parameters.

0.8.8 - 19 March 2025​

Added​

  • Support for import through module loaders (e.g. RequireJS).

Fixed​

  • Rotation bug in TrueScale.

Changed​

  • Updated DeepAR to 5.6.19.

0.8.7 - 13 February 2025​

Fixed​

  • Glasses' arms sometimes not splaying correctly in AR.

Changed​

  • Updated DeepAR to 5.6.16.

0.8.6 - 7 January 2025​

Fixed​

  • Non-existent SKUs counted towards active SKU count.

Changed​

  • Updated DeepAR to 5.6.15.

0.8.5 - 2 December 2024​

Fixed​

  • Runtime error caused by incorrect minification in certain versions of SWC.

Changed​

  • Updated DeepAR to 5.6.12.

0.8.4 - 5 November 2024​

Fixed​

  • Blend mode inconsistencies in 3D.

0.8.3 - 31 October 2024​

Fixed​

  • Improved performance and minimized memory usage in 3D.
  • Minor regressions with poster loading and animation in 3D.

0.8.2 - 16 October 2024​

Added​

  • Diamond & bloom support in AR.

Fixed​

  • Darkened background in 3D on iOS when model uses bloom.
  • AR files downloaded sequentially instead of in parallel.

0.8.1 - 9 October 2024​

Changed​

  • Updated DeepAR to 5.6.11.

0.8.0 - 8 October 2024​

Added​

  • Diamond & bloom support in 3D.

Fixed​

  • Various inconsistencies between dashboard and plugin.

Changed​

  • Updated DeepAR to 5.6.10.

0.7.6 - 28 August 2024​

Changed​

  • Limited DPR scaling in 3D and AR to minimize chances of crashes on iOS.
  • Updated DeepAR to 5.6.9.

0.7.5 - 30 July 2024​

Changed​

  • Updated DeepAR to 5.6.8.

0.7.4 - 26 July 2024​

Changed​

  • Resources loaded more lazily.
  • Updated DeepAR to 5.6.6.

0.7.3 - 9 July 2024​

Added​

  • Watch hand animation from poster image to current time.
  • In-memory cache for downloaded files.

Fixed​

  • Stale render being shown in 3D for a single frame after switching SKU.
  • Race condition during re-initialization.
  • Memory leak in 3D.

Changed​

  • 3D rendering only when in view.
  • Improved resource cleanup on plugin unmount.
  • Ignore close actions for states equal to initialState.
  • Optimised poster image loading.
  • Default UI icons loaded only when default UI is used.

0.7.2 - 1 July 2024​

Added​

  • Watch models show current time in 3D.

0.7.1 - 28 June 2024​

Added​

  • alwaysTransparentBackground parameter.

0.7.0 - 26 June 2024​

Added​

  • zoomEnabled parameter.

Fixed​

  • Initial camera pose not consistent with poster image when using initialAnimation.
  • Missing type exports.

Changed​

  • Vertical touch movement is now interpreted as page scroll.
  • Errors are not thrown anymore when 3D / AR is already launched / closed.
  • Clearer error logging for missing meta viewport tag.

0.6.3 - 20 June 2024​

Changed​

  • Use transparent 3D background for non-transmissive models only.

0.6.1 - 19 June 2024​

Fixed​

  • Touch events not being propagated to sibling nodes.

0.6.0 - 18 June 2024​

Changed​

  • 3D is used as the default view when initialState is set to '3D'.

0.5.3 - 14 June 2024​

Fixed​

  • Incorrect camera angle in poster image when using initialAnimation parameter.

0.5.2 - 12 June 2024​

Changed​

  • Updated DeepAR to 5.6.5.

0.5.1 - 6 June 2024​

Fixed​

  • QR code not shown on touch screen laptops.

0.5.0 - 5 June 2024​

Added​

  • HDR support in AR.

Fixed​

  • Poster images missing default background.

0.4.0 - 29 May 2024​

Added​

  • Poster images for 3D.
  • Support for transparent (custom) background in 3D.

Fixed​

  • Incorrect 3D animation on re-init with different category model.
  • 3D prompt being briefly visible after re-launch.
  • Jump in initial animation in the first few frames.
  • TrueScale initialization error when TrueScale not used at all.

Changed​

  • Improved the cleanup of 3D resources.

0.3.0 - 16 May 2024​

Added​

  • Platform tracking.

Fixed​

  • Small error with camera distance calculation in 3D.
  • QR code shown on iPad.

Changed​

  • Updated DeepAR to 5.6.3.
  • Updated the QR app domain.

0.2.1 - 13 May 2024​

Added​

  • Support for custom tone mapping exposure in 3D.

Fixed​

  • Bug where tone mapping in 3D was always set to ACES.

Changed​

  • Removed transmissive material overrides in 3D.

0.2.0 - 9 May 2024​

Added​

  • User interactivity control in 3D preview.
  • Animation control for 3D preview.

Fixed​

  • TrueScale crash on iOS caused by invalid video source.
  • Occasional angle drift in 3D interaction prompt.

0.1.2 - 23 April 2024​

Added​

  • Vision plugin for lower level control over AR and TrueScale.
  • Support for custom QR code text.
  • Support for custom camera error text.

Fixed​

  • Occasional error logged after closing 3D preview.

Changed​

  • Removed spammy TrueScale logs.

0.1.1 - 26 March 2024​

Added​

  • Support for arms splaying in TrueScale for glasses.
  • Support for neutral tone mapping in 3D.

Fixed​

  • Improved AR init performance.

Changed​

  • Updated DeepAR to 5.6.0.
  • Updated three.js to 0.162.0.

0.1.0 - 11 March 2024​

Added​

  • Support for custom AR prompts.
  • Support for custom tone mapping in 3D.

Fixed​

  • Rare issue where AR would not start up after re-init.

0.0.9 - 6 March 2024​

Added​

  • Interaction prompt for 3D preview.

0.0.8 - 29 February 2024​

Added​

  • Support for multiple simultaneous plugin targets.

Fixed​

  • Optimised shadow rendering in 3D.
  • Rare issue with 3D camera being controlled while mouse moved instead of dragged.

Changed​

  • Updated DeepAR to 5.6.0-pbr-alpha-123.
  • Breaking change:
    • setup() now returns undefined for unavailable preview actions.
  • Automatic cleanup on target removal from DOM.

0.0.7 - 23 February 2024​

Added​

  • strings parameter.

Fixed​

  • Restrict panning in 3D preview to prevent camera going inside model.

Changed​

  • Updated DeepAR to 5.6.0-pbr-alpha-120.
  • Nicer contact shadows in 3D preview.
  • Better default camera distance in 3D preview.
  • Better rotation center point in 3D preview.
  • Replaced distance-based with FOV-based zoom control in 3D preview.

0.0.6 - 25 January 2024​

Added​

  • Contact shadows in 3D preview.
  • QR code support on desktop for shoe AR.

Fixed​

  • Removed all usages of z-index.
  • Close if re-init SKU doesn't allow the running preview.
  • Edge case where camera wouldn't shut down after AR launch error.
  • Edge case where close button wouldn't work after 3D launch error.

Changed​

  • Updated DeepAR to 5.5.2.
  • 3D camera resets between launches.
  • Default CSS loaded by default.
  • Nicer loading screens.
  • Improved analytics.

0.0.5 - 8 January 2024​

Added​

  • Support for re-initialization with different SKUs and target elements.
  • Support for dashboard-defined environment maps in 3D preview.
  • Exposed the close() action.

Fixed​

  • Camera in use between AR launches.
  • Wrong pixel ratio in 3D preview.
  • Typo in launch3D error message.

Changed​

  • Updated DeepAR to 5.5.1.
  • Improved accuracy of TrueScale for glasses.
  • Updated the default environment map and removed scene lights in 3D preview.

0.0.4 - 17 November 2023​

Added​

  • TrueScale for glasses.
  • initialState parameter.
  • defaultUI parameter.

Fixed​

  • Re-initialization duplicate bug.

Changed​

  • Updated 3D preview settings.
  • Default camera in 3D preview dependent on item category.

0.0.3 - 23 October 2023​

Added​

  • Support for non-free DeepAR licenses.
  • Analytics support.
  • Default styling.

Changed​

  • Prettier UI.
  • Close button instead of toggles.
  • Loading spinner instead of placeholder text.

0.0.2 - 11 September 2023​

Fixed​

  • Default value for baseUrl.

0.0.1 - 8 September 2023​

Added​

  • ShopAR.plugin.setup method.
  • Release on NPM.