@namiml/web-sdk 3.4.0-dev.202605191927 → 3.4.0-dev.202605241634

package/dist/utils/tts.d.ts

@@ -3,20 +3,25 @@
  *
  * Targets:
  *   - VIZIO  → window.VIZIO.Chromevox.play(text)
- *   - Other CTV (Samsung Tizen, LG webOS, Xbox) + desktop browsers
- *            → window.speechSynthesis.speak(SpeechSynthesisUtterance)
+ *   - Other CTV (Samsung Tizen, LG webOS, Xbox) → window.speechSynthesis
+ *   - Browser (desktop / mobile / tablet) → no SDK-driven TTS; the OS screen
+ *     reader (VoiceOver, TalkBack, NVDA/JAWS, Orca) reads the ARIA path
+ *     directly. Firing `speechSynthesis` here would duplicate the
+ *     announcement and cause overlapping audio.
  *   - Headless / no API available → no-op; callers should also set `aria-label`
  *     on the focused element so the platform screenreader picks it up via the
- *     ARIA path as a last resort.
+ *     ARIA path.
  *
  * Selection precedence on `speak()`:
  *   1. VIZIO Chromevox (when present and enabled by the user).
- *   2. `window.speechSynthesis` (most other modern browsers including the
- *      Chromium-based CTV runtimes).
+ *   2. `window.speechSynthesis` (CTV form factors only — Bowser
+ *      `getPlatform().type === 'tv'`). Browsers rely on the ARIA path.
  *   3. No-op; the caller's ARIA label remains the final fallback.
  *
- * Replaces the original `vizio-tts.ts` which only covered VIZIO and silently
- * dropped speech requests on every other platform.
+ * The CTV gate exists because no Web API reports OS-level screen-reader
+ * state. On a CTV runtime (typically no integrated screen reader) we are
+ * the AT path; on a browser, the OS AT already reads ARIA and our extra
+ * utterance would duplicate it. See NAM-1102 for the full rationale.
  */
 /**
  * Attach platform-specific TTS event listeners. Idempotent. Currently only

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@namiml/web-sdk",
   "type": "module",
-  "version": "3.4.0-dev.202605191927",
+  "version": "3.4.0-dev.202605241634",
   "source": "src/nami-web.ts",
   "description": "Subscription monetization infrastructure — drop-in SDK with no-code paywalls, onboarding flows, A/B testing for web",
   "scripts": {
@@ -38,8 +38,7 @@
   },
   "files": [
     "dist",
-    "!dist/**/*.map",
-    "CHANGELOG.md"
+    "!dist/**/*.map"
   ],
   "keywords": [
     "in-app-purchase",
@@ -101,7 +100,7 @@
   "dependencies": {
     "@lit-labs/ssr-dom-shim": "^1.2.1",
     "@lit/context": "^1.1.3",
-    "@namiml/sdk-core": "3.4.0-dev.202605191927",
+    "@namiml/sdk-core": "3.4.0-dev.202605241634",
     "bowser": "^2.11.0",
     "hls.js": "^1.5.18",
     "lit": "^3.3.1",

package/CHANGELOG.md

@@ -1,400 +0,0 @@
-# Changelog - Web SDK
-
-## Unreleased
-
-### Bug Fixes
-- Recognize Xbox controller B button (`BrowserBack`, `XF86Back`, keyCode 166) as the paywall Back key, so onboarding flows no longer reload the host SPA on Xbox UWP / Edge WebView. Back is still routed through the campaign's `__remoteback__` action — if no action is configured on the current flow step, the event is swallowed (no-op) the same as before, just without the browser falling through to `history.back`. (NAM-79)
-
-### New Features
-- Support `modal` page presentation style: centered overlay with dim backdrop, internal scrolling capped at 85vh, 90vw on phone and 50vw on tablet/desktop/TV. Backdrop click and Escape dismiss the modal. (NAM-62)
-
-## 1.7.8
-**Release Date:** February 17, 2026
-
-### Bug Fixes
-- Fix rendering of components with 0 height or width
-- Fix CTV button focus display
-- Clear uninterpolated Smart Text variables
-- Make sure background image is fullscreen when scrolling
-
-### New Features
-- Support Segment Picker form component
-- Support Countdown Timer component
-- Support Progress Bar component
-- Support new flow function setTags
-- Support listening for user tag updates in Flow
-
-### Enhancements
-- Allow branching in flows based on set/notSet operators
-- Support TTS on Vizio devices
-- Support active and inactive drop shadow styling on segment picker
-- Support paywall conditions based on product subscription duration
-
-## 1.7.7
-**Release Date:** December 17, 2025
-
-### Bug Fixes
-- Ensure page-changed event escapes shadow DOM when CustomEvent polyfill is present
-
-## 1.7.6
-
-**Release Date:** December 16, 2025
-
-### Bug Fixes
-- Fix padding issues in toggle and list components
-- Fix gradient background issue
-
-### New Features
-- Add radio and standard toggle button components
-
-### Enhancements
-- Support disabled button properties
-
-## 1.7.5
-**Release Date:** November 19, 2025
-
-### Enhancements
-- Support using launch context custom attributes in flow analytics
-- Initial support for a progress indicator component
-
-### Bug Fixes
-- Resolve an issue where a user's signed in state wasn't reflected on the paywall properly
-- Resolve an issue with content padding on certain components
-- Resolve an ssue where CMS settings for video player audio playback was not honored
-
-## 1.7.4
-**Release Date:** October 30, 2025
-
-### Bug Fixes
-- Fix an issue where if device registration failed, user was stuck in anonymous mode
-
-### Enhancements
-- Support for legacy browsers
-
-## 1.7.3
-**Release Date:** October 13, 2025
-
-### Bug Fixes
-- Fix issue with hidden components not being hidden
-- Fix issue with deeplink handler
-- Fix issue preventing black bar and double scrolling in certain situations
-
-### Enhancements
-- Swipe and animation improements
-- Support for custom carousel indicators
-- Add support for launch id to group flow transitions
-- Add support for disabled field on toggle switch
-- Add `NamiCampaignManager.isFlow` for checking if a placement is a flow or not
-
-## 1.7.2
-**Release Date:** September 17, 2025
-
-### Enhancements
-- Improve handling of device creation failures and latency
-- Add `disableCampaignUpdates` namiCommand
-- Add forced A/B testing via `splitPosition` namiCommand
-- Standardize `NamiPaywallManager.emitter`
-- Support smart variables derived from URL query parameters and related analytics
-
-### Bug Fixes
-- Fix CTV scaling and spacing issues
-- Styling improvements
-
-## 1.7.1
-**Release Date:** September 3, 2025
-
-### Enhancements
-- Add `NamiFlowManager.pause` method
-- Add component animations (pulse/wave)
-
-### Bug Fixes
-- Completed Flows will no longer call registered paywall close handlers
-
-## 1.7.0
-**Release Date:** August 27, 2025
-
-### Enhancements
-- Add new components (Form container, Toggle switch, Radio button)
-- Support Flow Smart Text Variables
-- Support Flow animations / transitions
-- Smart TV Back button support
-- Support for buy / select sku Flow handoffs
-
-### Bug Fixes
-- QR Code component (scaling and non-hex colors)
-
-## 1.6.4  
-**Release Date:** August 6, 2025
-
-### Enhancements
-- Improved directional navigation support for TV and custom Nami components
-- Pass launch context in flows for better paywall context handling
-
-### Bug Fixes
-- Prevent scrolling on TV form factor (Content and Background containers)
-- Fix for handling unexpected SKU smart text variables
-
-## 1.6.3  
-**Release Date:** July 29, 2025
-
-### Enhancements
-- Improved television layout scaling for various viewport sizes
-
-## 1.6.2  
-**Release Date:** July 28, 2025
-
-### New Features
-- `Nami.sdkVersion` method to get the internal SDK version
-- Support for QR Code components
-- On Device Segment Selection for A/B testing
-- Support Base64, Gzipped Initial Configurations
-- Support Fully Uppercase Text Components
-
-### Enhancements
-- Paywall actions will now trigger if no flow action for a button is defined
-
-### Bug Fixes
-- Dynamic widths on Responsive Grid components
-
-## 1.6.1  
-**Release Date:** July 13, 2025
-
-### Improvements
-- Fix type exports in declaration files
-
-## 1.6.0  
-**Release Date:** July 10, 2025
-
-### New Features
-- Introduced `NamiFlowManager` for orchestrating multi-page flows
-  - `NamiFlowManager.registerStepHandoff`: callback when a flow is handed off
-  - `NamiFlowManager.registerEventHandler`: callback for flow analytics
-  - `NamiFlowManager.resume`: resume a handed-off flow
-
-### UI Enhancements
-- Default Focused Buttons
-- Blur Properties
-
-### Accessibility
-- Screenreader support for videos
-- Screenreader hints added
-
-### Performance
-- Better support handling multiple `Nami.configure` calls
-- General stability fixes
-
-## 1.5.12  
-**Release Date:** July 30, 2025
-
-### Bug Fixes
-- Fix race condition when local storage fails
-
-## 1.5.11  
-**Release Date:** June 18, 2025
-
-### Enhancements
-- Performance improvements for form factor lookups
-
-### Bug Fixes
-- Fix uninterpolated smart text
-- Fix fallback to in-memory storage on localStorage write failures
-
-## 1.5.10  
-**Release Date:** May 22, 2025
-
-### Enhancements
-- Support focused styling on buttons and toggle
-- Support tab key focus for collapsible component
-- Support alt tags on images
-
-### Bug Fixes
-- Fix toggle switch not preserving state on re-render
-- Fix additional spacing in text list items
-- Fix issue with screenreader and collapsed content
-
-## 1.5.9  
-**Release Date:** April 2, 2025
-
-### Bug Fixes
-- Resolve incorrect downscaling on 720p TV devices
-
-## 1.5.8  
-**Release Date:** April 1, 2025
-
-### Bug Fixes
-- Resolve issue where toggle component event was firing twice
-- Fix toggle switch state re-rendering due to parent page
-- Remove additional unintended spacing
-
-## 1.5.7  
-**Release Date:** February 20, 2025
-
-### Bug Fixes
-- Resolve additional type issue encountered with certain initial config files
-
-## 1.5.6  
-**Release Date:** February 19, 2025
-
-### Bug Fixes
-- Resolve type issue encountered with certain initial config files
-
-## 1.5.5  
-**Release Date:** January 16, 2025
-
-### Enhancements
-- Add optional `purchaseChannel` to `NamiConfiguration` to pass through to `NamiPaywallEvent` analytics
-
-## 1.5.4  
-**Release Date:** November 29, 2024
-
-### Bug Fixes
-- Resolve issue with TV focus on containers and product buttons on first load
-
-## 1.5.3  
-**Release Date:** November 21, 2024
-
-### Bug Fixes
-- Fix collapse component caret icon not updating when expanded
-
-### Enhancements
-- Support scaling on TV devices (720p, 1080p, 4K, and 8K)
-
-## 1.5.2  
-**Release Date:** October 24, 2024
-
-### Bug Fixes
-- Fix wrong campaign rule used for placement labels
-- Fix initial config campaign rule mapping
-- Fix background video fullscreen on mobile
-- Fix focus events on connected TV
-- Fix login/logout state handling
-- Fix display of free trials and promotional offers
-- Fix multiple UI issues in carousel and stack components
-
-## 1.5.1  
-**Release Date:** October 2, 2024
-
-### Enhancements
-- Add `TOGGLE_CHANGE` and `PAGE_CHANGE` paywall events
-
-### Bug Fixes
-- Fix carousel component swiper
-- Fix flex alignment issues
-- Fix Safari rendering for hero video
-
-## 1.5.0  
-**Release Date:** September 26, 2024
-
-### New Features
-- Advanced video feature support
-- Carousel component support
-
-### Enhancements
-- Improve fallback data handling
-- Support repeatable lists inside collapse components
-- Support vertical alignment in product container
-- Align `removeAllListeners` behavior with RN SDK
-
-### Bug Fixes
-- Fix segment picker cursor behavior
-- Fix hidden component visibility
-- Fix responsive grid spacing and scrolling
-- Fix background video gradient and position
-
-## 1.4.0  
-**Release Date:** September 5, 2024
-
-### New Features
-- HLS support in Video component
-- Responsive Grid component support
-- `NamiCustomerManager.deviceId` added
-- `NamiCustomerManager.registerJourneyStateHandler` and `journeyState` (subscription management)
-- `NamiEntitlementManager.clearProvisionalEntitlementGrants` (subscription management)
-
-### Enhancements
-- Pass product groups to paywall via campaign launch
-
-### Bug Fixes
-- Find product by ID instead of name
-- Fix spacing in text component
-
-### Improvements
-- Update type definitions across paywall manager and customer manager APIs
-
-## 1.3.2  
-**Release Date:** August 14, 2024
-
-### Bug Fixes
-- Conditional component rendering based on product entitlement and product groups
-
-## 1.3.1  
-**Release Date:** August 12, 2024
-
-### Bug Fixes
-- Fix `SHOW_PAYWALL` event being triggered as `UNKNOWN`
-
-## 1.3.0  
-**Release Date:** August 12, 2024
-
-### New Features
-- `NamiEntitlementManager` to manage entitlements
-  - `active`, `isEntitlementActive`, `refresh`, `registerActiveEntitlementsHandler`
-- `NamiEntitlement` object model
-- Hidden component support
-- New components: Video and collapsible
-- Timeout and error handling improvements
-
-### Bug Fixes
-- Typing improvements across SDKs
-- ECMAScript 2021 support
-
-### Breaking Changes
-- `appPlatformId` renamed to `appPlatformID` in `NamiConfiguration`
-- `NamiPaywallManager.buySkuComplete` interface simplified
-
-## 1.2.0  
-**Release Date:** July 26, 2024
-
-### New Features
-- `NamiCampaignManager.launch`: supports `paywallLaunchContext`
-- `NamiPaywallManager.buySKUCancel` and `buySKUComplete`
-- Paywall impression and conversion reporting
-- Faster paywall render time
-
-### Bug Fixes
-- Consistent typing and API alignment across SDKs
-
-## 1.1.0  
-**Release Date:** June 24, 2024
-
-### New Features
-- `NamiCustomerManager.setAnonymousMode`
-- `NamiCampaignManager.launch` with `paywallActionHandler`
-- `NamiPaywallManager.registerBuySkuHandler`
-
-### Bug Fixes
-- Lit component compatibility and SSR fixes
-- Subscription pricing rendering fixes
-- Custom API host connectivity fixes
-- Icon display improvements
-
-### Known Issues
-- `buySkuComplete`, `buySkuCancel` not fully implemented
-- Impression/conversion reporting and launch context not implemented
-
-## 1.0.0  
-**Release Date:** June 13, 2024
-
-### New Features
-- Core SDK: `Nami`, `Nami.configure`, `NamiConfiguration`, `NamiLanguageCodes`
-- `NamiCampaignManager` for campaign management
-- `NamiCustomerManager` for customer state and attributes
-- `NamiPaywallManager` for paywall and event handler management
-
-### Known Issues
-- Paywall event callbacks not firing
-- `buySkuComplete`, `buySkuCancel`, and `setAnonymousMode` partially implemented
-- Impression/conversion reporting and launch context not yet available
-
-### Additional Notes
-Refer to the documentation for detailed usage instructions and integration examples.