@namiml/web-sdk 3.4.10-dev.202608230430 → 3.4.10-dev.202608232056

package/dist/nami-web.d.ts

@@ -113,11 +113,12 @@ declare class NamiButton extends NamiElement {
      * attached per card by `appendSkuToComponents`) and are ignored, as is every non-television
      * form factor, where tap already drives selection.
      *
-     * Unlike Apple's `setFocusedSku`, this only ever sets a selection, never clears one:
-     * clearing would blank product-scoped content whenever focus moved to the group toggle,
-     * Restore, or a non-product column, and would fight the template's `initialState`
-     * selection. `selectSKU` is idempotent, so repeat focus events on the same card do not
-     * trigger a re-render.
+     * 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.
      */
     private _selectFocusedProductOnTelevision;
     private _handleBlur;