codexly-ui 0.23.2 → 0.25.0

package/package.json

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

package/types/codexly-ui.d.ts

@@ -3831,6 +3831,10 @@ interface ClxProduct {
     has_discount: boolean;
     discount_percentage?: number;
     tags: string[];
+    /** System tag kinds not shown on this card (ClxTagContext.hiddenSystemTags). */
+    hidden_system_tags?: string[];
+    /** Its own "Últimas unidades" threshold (ClxTagContext.lowStockThreshold). */
+    low_stock_threshold?: number | null;
     main_image?: string;
     in_stock: boolean;
     /** Units left — for the "Últimas unidades" tag (ClxProductTagService). */
@@ -3886,6 +3890,10 @@ interface ClxTagContext {
     showStockCount?: boolean;
     /** Discount percentage, for the DISCOUNT tag (0 / undefined = no discount). */
     discountPercent?: number | null;
+    /** System tag kinds this product/variant doesn't show ('STOCK', 'LOW_STOCK', 'OUT_OF_STOCK', 'DISCOUNT'). */
+    hiddenSystemTags?: readonly string[] | null;
+    /** Its own LOW_STOCK threshold; null / undefined = the tag's global stockThreshold. */
+    lowStockThreshold?: number | null;
 }
 /**
  * The product tags configured by the host app (setTags, e.g. from its backend at startup). Once set,
@@ -4010,11 +4018,19 @@ interface ClxVariation {
     name: string;
     description?: string;
     sale_price?: number;
+    /** This variation's discount when the host resolves it per variation (0 = none); undefined = the
+     *  product's has_discount / discount_percentage. */
+    discount_percentage?: number;
     sort_order: number;
     images: string[];
     in_stock: boolean;
     stock_quantity?: number;
     specs: Record<string, string>;
+    /** This variation's tags, when the host resolves them per variation; undefined = the product's
+     *  (same for the two fields below). */
+    tags?: string[];
+    hidden_system_tags?: string[];
+    low_stock_threshold?: number | null;
 }
 /** st_product_spec_types + st_product_spec_options — fila de ficha técnica */
 interface ClxProductSpec {
@@ -4058,6 +4074,8 @@ interface ClxProductDetailData {
     has_warranty: boolean;
     warranty_period?: number;
     tags: string[];
+    hidden_system_tags?: string[];
+    low_stock_threshold?: number | null;
     currency: string;
     rating: number;
     review_count: number;
@@ -4204,12 +4222,14 @@ declare class ClxProductDetailComponent {
     protected tagLabel(tag: string): string;
     protected tagColor(tag: string): ClxColorInput;
     protected tagVariant(tag: string): codexly_ui.ClxBadgeVariant;
-    /** discount_percentage is the primary source (matches this codebase's actual data model: the
-     *  percentage lives on the product, the price it applies to is sale_price/product_sale_price —
-     *  see listPrice() above). discount_price is only a fallback for a caller whose backend instead
-     *  stores a precomputed higher reference price to derive the percentage from. */
+    /** The selected variation's own discount_percentage when the host sends one, else the product's
+     *  (it applies on top of the list price — see listPrice() above). discount_price is only a fallback
+     *  for a caller whose backend instead stores a precomputed higher reference price to derive the
+     *  percentage from. */
+    private readonly _discountPct;
     readonly discount: _angular_core.Signal<number>;
-    /** The host's configured tags (ClxProductTagService) for the selected variation, over the gallery. */
+    /** The host's configured tags (ClxProductTagService) for the selected variation, over the gallery —
+     *  the variation's own tags and settings when the host sends them, else the product's. */
     protected readonly _badges: _angular_core.Signal<codexly_ui.ClxTagBadge[]>;
     /** 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