codexly-ui 0.10.66 → 0.10.68

package/package.json

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

package/types/codexly-ui.d.ts

@@ -2997,20 +2997,40 @@ 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[];
     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>;
-    /** An option is available only if some variation matching it (combined with the rest of the
-     *  current selection) both exists AND has stock — a sold-out combination is treated the same
-     *  as a non-existent one and hidden, per the same "hide, don't disable" rule already applied to
-     *  invalid combinations, so the visitor never sees a spec they can't actually buy. */
+    /** An option is available if some in-stock variation matches it together with the rest of the
+     *  current selection — a sold-out combination is hidden, same "hide, don't disable" rule already
+     *  applied to invalid combinations, so the visitor never sees a spec they can't actually buy.
+     *
+     *  Falls back to ignoring the cross-selection filter (any in-stock variation with this option,
+     *  regardless of other selected specs) when the strict cross-filter would hide every option of
+     *  this spec type — that happens when the *currently selected* combination itself has no stock
+     *  (e.g. landed on Negro+XL, which is sold out): without the fallback, Color and Talla would
+     *  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;