codexly-ui 0.23.1 → 0.24.0

package/package.json

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

package/types/codexly-ui.d.ts

@@ -141,9 +141,9 @@ declare class ClxSocialIconComponent {
     readonly platform: _angular_core.InputSignal<ClxSocialPlatform>;
     readonly variant: _angular_core.InputSignal<ClxButtonVariant>;
     readonly color: _angular_core.InputSignal<ClxColorInput | undefined>;
-    readonly size: _angular_core.InputSignal<"sm" | "md" | "lg" | "xxs" | "xs" | undefined>;
+    readonly size: _angular_core.InputSignal<"sm" | "md" | "xxs" | "xs" | "lg" | undefined>;
     protected readonly _color: _angular_core.Signal<ClxColorInput>;
-    protected readonly _size: _angular_core.Signal<"sm" | "md" | "lg" | "xxs" | "xs">;
+    protected readonly _size: _angular_core.Signal<"sm" | "md" | "xxs" | "xs" | "lg">;
     protected readonly _markup: _angular_core.Signal<SafeHtml>;
     protected readonly _hostClass: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClxSocialIconComponent, never>;
@@ -166,17 +166,17 @@ declare class ClxButtonComponent {
      *  unusual background shade (bright yellow) where the variant's own resolved text color (white)
      *  reads poorly and a themed text tone is needed instead. */
     readonly textColor: _angular_core.InputSignal<ClxColorInput | undefined>;
-    readonly size: _angular_core.InputSignal<"sm" | "md" | "lg" | "xxs" | "xs" | undefined>;
+    readonly size: _angular_core.InputSignal<"sm" | "md" | "xxs" | "xs" | "lg" | undefined>;
     readonly shape: _angular_core.InputSignal<ClxShape | undefined>;
     private readonly _tableActionsColor;
     protected readonly _color: _angular_core.Signal<ClxColorInput>;
-    protected readonly _size: _angular_core.Signal<"sm" | "md" | "lg" | "xxs" | "xs">;
+    protected readonly _size: _angular_core.Signal<"sm" | "md" | "xxs" | "xs" | "lg">;
     protected readonly _shape: _angular_core.Signal<ClxShape>;
     readonly loading: _angular_core.InputSignal<boolean>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly block: _angular_core.InputSignal<boolean>;
     readonly icon: _angular_core.InputSignal<string | undefined>;
-    readonly iconPosition: _angular_core.InputSignal<"right" | "left">;
+    readonly iconPosition: _angular_core.InputSignal<"left" | "right">;
     readonly iconOnly: _angular_core.InputSignal<boolean>;
     readonly badge: _angular_core.InputSignal<string | number | undefined>;
     readonly badgeColor: _angular_core.InputSignal<ClxColorInput>;
@@ -214,7 +214,7 @@ declare class ClxButtonGroupComponent {
     readonly label: _angular_core.InputSignal<string>;
     readonly shape: _angular_core.InputSignal<ClxButtonGroupShape>;
     readonly attached: _angular_core.InputSignal<boolean>;
-    readonly orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
+    readonly orientation: _angular_core.InputSignal<"vertical" | "horizontal">;
     protected readonly _groupClass: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClxButtonGroupComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClxButtonGroupComponent, "clx-button-group", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "attached": { "alias": "attached"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -314,7 +314,7 @@ declare class ClxCardComponent {
      *  product-cart-style layout) regardless of variant/color. */
     readonly border: _angular_core.InputSignal<boolean>;
     /** Per-instance border-radius override — falls back to the theme's global borderRadius when unset. */
-    readonly radius: _angular_core.InputSignal<"none" | "sm" | "md" | "lg" | "xl" | "full" | undefined>;
+    readonly radius: _angular_core.InputSignal<"sm" | "md" | "lg" | "xl" | "none" | "full" | undefined>;
     /** Auto-generated header icon (Material Symbols name) — shown in a rounded primary-subtle
      *  square next to headerTitle. Ignored when a manual [clxCardHeader] block is projected. */
     readonly icon: _angular_core.InputSignal<string | undefined>;
@@ -1367,7 +1367,7 @@ declare class ClxRadioGroupComponent implements ControlValueAccessor {
     readonly resolvedColor: _angular_core.Signal<ClxColorInput>;
     readonly variant: _angular_core.InputSignal<ClxRadioVariant>;
     readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
-    readonly direction: _angular_core.InputSignal<"horizontal" | "vertical">;
+    readonly direction: _angular_core.InputSignal<"vertical" | "horizontal">;
     readonly disabled: _angular_core.InputSignal<boolean>;
     /** Current selected value — readable by child clx-radio via injection */
     readonly _value: _angular_core.WritableSignal<unknown>;
@@ -2848,7 +2848,7 @@ declare class ClxNotificationComponent {
     } | undefined>;
     readonly buttonColor: _angular_core.InputSignal<ClxColorInput | undefined>;
     readonly buttonVariant: _angular_core.InputSignal<ClxButtonVariant>;
-    readonly buttonSize: _angular_core.InputSignal<"sm" | "md" | "lg" | "xxs" | "xs">;
+    readonly buttonSize: _angular_core.InputSignal<"sm" | "md" | "xxs" | "xs" | "lg">;
     readonly buttonIcon: _angular_core.InputSignal<string>;
     /** Unread-count badge color — falls back to the theme's notification.unreadColor (then
      *  primaryColor) when unset. */
@@ -3146,7 +3146,7 @@ declare class ClxTreeComponent {
         icon: "xs" | "sm" | "md";
         indent: string;
     }>;
-    protected readonly _indentPx: _angular_core.Signal<20 | 16 | 24>;
+    protected readonly _indentPx: _angular_core.Signal<16 | 20 | 24>;
     protected readonly _rootClass: _angular_core.Signal<string>;
     protected _isExpanded(id: string | number): boolean;
     protected _isSelected(id: string | number): boolean;
@@ -3656,7 +3656,7 @@ declare class ClxStatCardComponent {
     readonly metric: _angular_core.InputSignal<ClxStatMetric>;
     readonly chartData: _angular_core.InputSignal<number[]>;
     readonly color: _angular_core.InputSignal<ClxColorInput>;
-    readonly layout: _angular_core.InputSignal<"horizontal" | "vertical" | "bar" | "banner" | "corner">;
+    readonly layout: _angular_core.InputSignal<"vertical" | "horizontal" | "bar" | "banner" | "corner">;
     protected readonly _hostClass: _angular_core.Signal<string>;
     protected readonly _barHeights: _angular_core.Signal<number[]>;
     protected readonly _iconBg: _angular_core.Signal<string>;
@@ -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,
@@ -3920,7 +3928,7 @@ declare class ClxProductComponent {
      *  itself always reads cardBorderColor() regardless of variant — only whether it's shown at
      *  all, and whether a shadow accompanies it, changes. */
     readonly variant: _angular_core.InputSignal<ClxCardVariant>;
-    readonly imageFit: _angular_core.InputSignal<"contain" | "cover">;
+    readonly imageFit: _angular_core.InputSignal<"cover" | "contain">;
     readonly addToCart: _angular_core.OutputEmitterRef<ClxProduct>;
     readonly addToWishlist: _angular_core.OutputEmitterRef<ClxProduct>;
     readonly viewOptions: _angular_core.OutputEmitterRef<ClxProduct>;
@@ -4015,6 +4023,11 @@ interface ClxVariation {
     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 +4071,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;
@@ -4209,7 +4224,8 @@ declare class ClxProductDetailComponent {
      *  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. */
     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
@@ -4448,6 +4464,10 @@ declare class ClxCartComponent {
     protected readonly _savingsAmount: _angular_core.Signal<number>;
     protected readonly _couponDiscount: _angular_core.Signal<number>;
     protected readonly _total: _angular_core.Signal<number>;
+    protected _exceedsStock(item: ClxCartItem): boolean;
+    /** Lines that can't be bought as they are — out of stock, or more units than are left. While any
+     *  exists the checkout button stays disabled. */
+    protected readonly _blockedItems: _angular_core.Signal<ClxCartItem[]>;
     protected readonly _totalUnits: _angular_core.Signal<number>;
     applyCoupon(): void;
     removeCoupon(): void;
@@ -4578,7 +4598,7 @@ declare class ClxSearchComponent implements ControlValueAccessor {
         padDefaultL: string;
         padDefaultR: string;
     }>;
-    protected readonly _buttonSize: _angular_core.Signal<"sm" | "md" | "lg" | "xs">;
+    protected readonly _buttonSize: _angular_core.Signal<"sm" | "md" | "xs" | "lg">;
     protected readonly _accentText: _angular_core.Signal<string>;
     protected readonly _wrapperClass: _angular_core.Signal<string>;
     protected readonly _inputClass: _angular_core.Signal<string>;