@namiml/web-sdk 3.4.11-dev.202609040555 → 3.4.11-dev.202609092330

package/dist/components/elements/Button.d.ts

@@ -16,19 +16,22 @@ export declare class NamiButton extends NamiElement {
     protected updated(changedProperties: PropertyValueMap<this>): void;
     private _handleFocus;
     /**
-     * NAM-3607: on CTV, focus is the selection signal — there is no tap to select a product.
-     * Bridge a focused product button into `state.selectedProducts` so conditions and smart
-     * text authored against `${state.selectedProducts.${state.currentGroupId}}` resolve
-     * against the *focused* product. Buttons outside a product card carry no `sku` (it is
-     * attached per card by `appendSkuToComponents`) and are ignored, as is every non-television
-     * form factor, where tap already drives selection.
+     * On CTV, focus is the selection signal — there is no tap to select a product (NAM-3607).
      *
-     * This button path only ever sets a selection, never clears one: a blur/non-product
-     * clear here would fight the template's `initialState` selection on incidental focus
-     * churn. The clear lives on the positive signal instead — focusing the group toggle
-     * clears the current group's selection (`NamiSegmentPicker._handleFocusIn` →
-     * `clearSelectedProduct`, NAM-3606), matching Apple's `setFocusedSku(nil)`. `selectSKU`
-     * is idempotent, so repeat focus events on the same card do not trigger a re-render.
+     * - A focused PRODUCT button (one carrying a `sku`, attached per card by `appendSkuToComponents`)
+     *   is bridged into `state.selectedProducts`, so conditions and smart text authored against
+     *   `${state.selectedProducts.${state.currentGroupId}}` resolve against the *focused* product.
+     *   `selectSKU` is idempotent, so repeat focus events on the same card do not re-render.
+     * - A focused NON-product button (login / restore / TV-provider — no `sku`) CLEARS the current
+     *   group's selection (NAM-4270, decision 3 on NAM-4265), the same positive signal the group
+     *   toggle already uses (`NamiSegmentPicker._handleFocusIn` → `clearSelectedProduct`, NAM-3606).
+     *   Every `${sku.*}`-conditioned tile then takes its non-premium branch, matching Apple's
+     *   `setFocusedSku(nil)` and Roku. This supersedes the earlier set-only rule from NAM-3607.
+     *
+     * Only focus-IN clears; `_handleBlur` never touches the selection, so focus merely leaving a
+     * card does nothing, and on web focus moves only under user input (TVJS), never as a side
+     * effect of a re-render — the Compose recomposition-loop hazard behind Android's settle guard
+     * does not apply here. Every non-television form factor is ignored: tap drives selection there.
      */
     private _selectFocusedProductOnTelevision;
     private _handleBlur;