codexly-ui 0.10.67 → 0.10.69

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexly-ui",
-  "version": "0.10.67",
+  "version": "0.10.69",
   "description": "Standalone, signal-based Angular UI component library for Codexly, styled with Tailwind CSS.",
   "keywords": [
     "angular",

package/types/codexly-ui.d.ts

@@ -2997,12 +2997,28 @@ declare class ClxProductDetailComponent {
     readonly _carousel: _angular_core.Signal<ClxCarouselComponent | undefined>;
     readonly quantity: _angular_core.WritableSignal<number>;
     readonly activeTab: _angular_core.WritableSignal<string>;
+    /** Only holds specs the visitor has explicitly clicked — starts empty, not pre-filled with the
+     *  initial variation's specs, so a spec option can be toggled off (click again to deselect)
+     *  without fighting a "fully selected" starting state that never lets go of its last value. */
     readonly selectedSpecs: _angular_core.WritableSignal<Record<string, string>>;
+    private readonly _initialVariation;
     /** Same card treatment as clx-product (bg-clx-surface + shadow-sm) — keeps the gallery/info
      *  panels visually consistent with the rest of the e-commerce card set. */
     protected readonly _panelClass = "bg-clx-surface rounded-2xl shadow-sm p-4";
     readonly tabItems: ClxTabItem[];
+    /** Tracks which product the spec selection was initialized for — the init effect below must run
+     *  once per actual product change, not every time initialVariationId() changes. A host app that
+     *  syncs its own ?variant= URL param from the (variationChange) output (see codexly-store's
+     *  product-detail page) feeds that id back into this same input; without this guard, every spec
+     *  click would round-trip through the host and re-trigger initialization, silently overwriting
+     *  the visitor's in-progress selection with the just-resolved variation's full spec set. */
+    private _initializedForProductId;
     constructor();
+    /** With no specs selected (fresh load, or every spec toggled back off) this is the variation
+     *  the visitor originally landed on. Otherwise, resolves the variation matching every currently
+     *  selected spec — with a partial selection (some spec types still untouched), any variation
+     *  whose specs are a superset of the selection counts as a match, since the visitor hasn't
+     *  narrowed those other spec types down to one value yet. */
     readonly activeVariation: _angular_core.Signal<ClxVariation | null>;
     readonly finalPrice: _angular_core.Signal<number>;
     readonly discount: _angular_core.Signal<number>;
@@ -3017,6 +3033,11 @@ declare class ClxProductDetailComponent {
      *  hide each other's only selected value and the whole panel would render empty, even though
      *  other in-stock combinations (Azul L, Gris M, …) exist. */
     isOptionAvailable(specTypeId: string, specOptionId: string): boolean;
+    /** Clicking an already-selected option deselects it (toggle) instead of being a no-op — the only
+     *  way to escape a narrowed-down selection and see all options again, per the "hide unavailable
+     *  options" design: there's no separate disabled state to click through, so toggling off is the
+     *  sole path back. Once every spec is toggled off, activeVariation() falls back to the variation
+     *  the visitor originally landed on (see _initialVariation). */
     selectSpec(specTypeId: string, specOptionId: string): void;
     isSpecSelected(specTypeId: string, specOptionId: string): boolean;
     selectedOptionLabel(specType: ClxSpecType): string;