@salla.sa/twilight-components 2.14.596 → 2.14.598

package/dist/types/components.d.ts

@@ -173,15 +173,15 @@ export namespace Components {
     }
     interface SallaAlert {
         /**
-          * Icon type (defaults to variant)
+          * The icon type to display. Defaults to the variant type. Set to 'none' to hide the icon.
          */
         "icon"?: 'info' | 'success' | 'warning' | 'error' | 'none';
         /**
-          * Message text
+          * The alert message text to display.
          */
         "message": string;
         /**
-          * Variant theme
+          * The visual style/theme of the alert. Can be 'info', 'success', 'warning', or 'error'. Default is 'info'.
           * @default 'info'
          */
         "variant": 'info' | 'success' | 'warning' | 'error';
@@ -380,7 +380,7 @@ export namespace Components {
     }
     interface SallaButton {
         /**
-          * Button Color
+          * The color theme of the button. Available options: 'primary', 'success', 'warning', 'danger', 'light', 'gray', 'dark'. Default is 'primary'.
           * @default 'primary'
          */
         "color": 'primary' | 'success' | 'warning' | 'danger' | 'light' | 'gray' | 'dark';
@@ -389,7 +389,7 @@ export namespace Components {
          */
         "disable": () => Promise<HTMLElement>;
         /**
-          * Is the button currently disabled
+          * Disables the button, preventing user interaction. Default is false.
           * @default false
          */
         "disabled": boolean;
@@ -403,12 +403,12 @@ export namespace Components {
          */
         "enableLoader": boolean;
         /**
-          * Button Fill
+          * The fill style of the button. 'solid' (filled background), 'outline' (bordered, transparent background), or 'none'. Default is 'solid'.
           * @default 'solid'
          */
         "fill": 'solid' | 'outline' | 'none';
         /**
-          * Button with href as normal link
+          * When provided, renders the button as an anchor (`<a>`) element with this URL.
          */
         "href": string;
         /**
@@ -416,12 +416,12 @@ export namespace Components {
          */
         "load": () => Promise<HTMLElement>;
         /**
-          * If there is need to change loader position, pass the position
+          * Position of the loading spinner. Can be 'start', 'end', 'center', or 'after' (after the button text). Default is 'after'.
           * @default 'after'
          */
         "loaderPosition": 'start' | 'end' | 'center' | 'after';
         /**
-          * Is the button currently loading
+          * Shows a loading spinner on the button. Default is false.
           * @default false
          */
         "loading": boolean;
@@ -431,12 +431,12 @@ export namespace Components {
          */
         "setText": (html: string) => Promise<HTMLElement>;
         /**
-          * Button Type
+          * The shape/variant of the button. Can be 'link' (text-only style), 'icon' (circular icon button), or 'btn' (standard button). Default is 'btn'.
           * @default 'btn'
          */
         "shape": 'link' | 'icon' | 'btn';
         /**
-          * Button Size
+          * The size of the button. Can be 'small', 'medium', or 'large'. Default is 'medium'.
           * @default 'medium'
          */
         "size": 'small' | 'large' | 'medium';
@@ -445,12 +445,12 @@ export namespace Components {
          */
         "stop": () => Promise<HTMLElement>;
         /**
-          * Determines the type of the rendered button. By default, the type is set to "button," making it a general-purpose button. Setting `type` to "submit" makes the button behave as a submit button within a form, triggering form submission. Possible values for `type` include "button," "submit," "reset," and "menu.".  Possible values and their usage are as follows: "button" (default, used for general button functionality),  "reset" (resets form fields to their default values), and  "menu" (represents a button that, when activated, displays a context menu).
+          * The HTML type attribute for the button. 'button' (default, general-purpose), 'submit' (submits forms), or 'reset' (resets form fields).
           * @default "button"
          */
         "type": string;
         /**
-          * Button Width
+          * The width of the button. 'wide' makes the button full-width, 'normal' uses auto width. Default is 'normal'.
           * @default 'normal'
          */
         "width": 'wide' | 'normal';
@@ -486,7 +486,7 @@ export namespace Components {
          */
         "animateToCart": (image: any) => Promise<void>;
         /**
-          * Show cart label
+          * Whether to show the cart label text alongside the cart icon. Default is false (icon only).
          */
         "showCartLabel": boolean;
     }
@@ -706,7 +706,7 @@ export namespace Components {
          */
         "boxTheme": string;
         /**
-          * If true, the count down numbers will be appear in a boxes
+          * Whether to display countdown numbers in boxed containers. Default is false.
          */
         "boxed": boolean;
         /**
@@ -722,7 +722,7 @@ export namespace Components {
          */
         "buttonText"?: string;
         /**
-          * The color of the count down
+          * The color theme of the countdown. Can be 'primary', 'light', or 'dark'. Default is 'dark'.
           * @default 'dark'
          */
         "color": 'primary' | 'light' | 'dark';
@@ -731,7 +731,7 @@ export namespace Components {
          */
         "date": string;
         /**
-          * The digits lang to show in the count down
+          * The language/format for displaying digits. 'en' for English numerals, 'auto' for localized numerals. Default is 'auto'.
           * @default 'auto'
          */
         "digits": 'en' | 'auto';
@@ -740,11 +740,11 @@ export namespace Components {
          */
         "endCountDown": () => Promise<void>;
         /**
-          * If true, the count down will end at the end of the day
+          * Whether to set the countdown end time to the end of the specified day (23:59:59). Default is false.
          */
         "endOfDay": boolean;
         /**
-          * The text to show when the count down ends
+          * Custom text to display when the countdown ends. If not provided, uses the default localized message.
          */
         "endText": string;
         /**
@@ -752,7 +752,7 @@ export namespace Components {
          */
         "horizontal"?: boolean;
         /**
-          * Show labels for each count down number
+          * Whether to show labels (day, hour, minute, second) below each countdown number. Default is false.
          */
         "labeled": boolean;
         /**
@@ -768,7 +768,7 @@ export namespace Components {
          */
         "prefixText"?: string;
         /**
-          * The size of the count down
+          * The size of the countdown display. Can be 'sm', 'md', or 'lg'. Default is 'md'.
           * @default 'md'
          */
         "size": 'sm' | 'md' | 'lg';
@@ -777,6 +777,10 @@ export namespace Components {
          */
         "withButton"?: boolean;
     }
+    /**
+     * The `salla-custom-fields` component renders custom form fields with validation support.
+     * Supports text and file upload fields with real-time validation.
+     */
     interface SallaCustomFields {
         /**
           * The list of custom fields to render. Can be a JSON string or an array of objects.
@@ -1407,7 +1411,7 @@ export namespace Components {
          */
         "applyFilters": () => Promise<void>;
         /**
-          * Array of filter options
+          * Array of filter options to display. Each filter contains key, label, type, and values for filtering products.
          */
         "filters"?: Filter[];
         /**
@@ -1524,6 +1528,10 @@ export namespace Components {
          */
         "widgetTitle": string;
     }
+    /**
+     * The `salla-hook` component serves as a placeholder for dynamic content injection.
+     * Used by the Salla hooks system to mount elements at specific locations.
+     */
     interface SallaHook {
         /**
           * Mounts a given HTML element into the hook position.
@@ -2349,7 +2357,7 @@ export namespace Components {
     }
     interface SallaProductCard {
         /**
-          * Compact list layout for drawers and lists.
+          * Whether to use a compact card layout suitable for drawers and lists. Default is false.
          */
         "compact": boolean;
         /**
@@ -2363,31 +2371,31 @@ export namespace Components {
          */
         "forceShowWishlistButton": boolean;
         /**
-          * Full image card.
+          * Whether to use a full-image card style where the image covers the entire card. Default is false.
          */
         "fullImage": boolean;
         /**
-          * Hide add to cart button.
+          * Whether to hide the "Add to Cart" button. Default is false (button is shown).
          */
         "hideAddBtn": boolean;
         /**
-          * Horizontal card.
+          * Whether to display the card in horizontal (landscape) layout. Default is false (vertical layout).
          */
         "horizontal": boolean;
         /**
-          * Special card.
+          * Whether this is a special/featured product card with additional styling (like quantity pie chart). Default is false.
          */
         "isSpecial": boolean;
         /**
-          * Minimal card.
+          * Whether to use a minimal card style with reduced information. Default is false.
          */
         "minimal": boolean;
         /**
-          * Product information.
+          * The product data to display. Can be a JSON string or a product object containing id, name, image, price, etc.
          */
         "product": string | object;
         /**
-          * Support shadow on hover.
+          * Whether to add a shadow effect on hover. Default is false.
          */
         "shadowOnHover": boolean;
         /**
@@ -2396,7 +2404,7 @@ export namespace Components {
          */
         "showOutOfStockBesidePrice": boolean;
         /**
-          * Show quantity.
+          * Whether to show the product quantity in a badge. Default is false.
          */
         "showQuantity": boolean;
     }
@@ -2894,7 +2902,7 @@ export namespace Components {
     }
     interface SallaRatingStars {
         /**
-          * Allows the rating to be editable.
+          * Whether the rating is interactive/editable by the user. Default is false (display-only).
           * @default false
          */
         "editable": boolean;
@@ -2904,17 +2912,17 @@ export namespace Components {
          */
         "labelBeforeStars": boolean;
         /**
-          * Sets input name.
+          * The name attribute for the rating input (used in forms). Default is 'rating'.
           * @default 'rating'
          */
         "name": string;
         /**
-          * Number of reviews to display.
+          * The number of reviews to display next to the stars. Default is 0 (hidden).
           * @default 0
          */
         "reviews": number;
         /**
-          * Sets the height and width of the component. Defaults to medium.
+          * The size of the star icons. Can be 'large', 'medium', 'small', or 'mini'. Default is 'medium'.
           * @default 'medium'
          */
         "size": "large" | "medium" | "small" | "mini";
@@ -2923,14 +2931,18 @@ export namespace Components {
          */
         "tag": boolean;
         /**
-          * The rating value.
+          * The current rating value (0-5). Used to display filled stars.
          */
         "value": number;
         /**
-          * Show the description label.
+          * Whether to show a descriptive label (e.g., "Excellent", "Good") next to the rating. Default is false.
          */
         "withLabel": boolean;
     }
+    /**
+     * The `salla-review-card` component displays a product review with images, ratings, and product info.
+     * Supports image carousel with swipe gestures.
+     */
     interface SallaReviewCard {
         /**
           * The review object to render, containing review text, stars, product info, and images.
@@ -3176,17 +3188,17 @@ export namespace Components {
     }
     interface SallaSkeleton {
         /**
-          * Set the skeleton height
+          * The height of the skeleton. Can be any CSS height value (e.g., '100%', '50px', '2rem'). Default is '100%'.
           * @default '100%'
          */
         "height": string;
         /**
-          * Set the shape type of the skeleton is it circle or normal
+          * The shape type of the skeleton. 'circle' for circular skeletons (e.g., avatars), 'normal' for rectangular shapes. Default is 'normal'.
           * @default 'normal'
          */
         "type": 'circle' | 'normal';
         /**
-          * Set the skeleton width
+          * The width of the skeleton. Can be any CSS width value (e.g., '100%', '50px', '2rem'). Default is '100%'.
           * @default '100%'
          */
         "width": string;
@@ -4203,6 +4215,10 @@ declare global {
     isValid: boolean;
   };
     }
+    /**
+     * The `salla-custom-fields` component renders custom form fields with validation support.
+     * Supports text and file upload fields with real-time validation.
+     */
     interface HTMLSallaCustomFieldsElement extends Components.SallaCustomFields, HTMLStencilElement {
         addEventListener<K extends keyof HTMLSallaCustomFieldsElementEventMap>(type: K, listener: (this: HTMLSallaCustomFieldsElement, ev: SallaCustomFieldsCustomEvent<HTMLSallaCustomFieldsElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
         addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
@@ -4379,6 +4395,10 @@ declare global {
         prototype: HTMLSallaGiftingElement;
         new (): HTMLSallaGiftingElement;
     };
+    /**
+     * The `salla-hook` component serves as a placeholder for dynamic content injection.
+     * Used by the Salla hooks system to mount elements at specific locations.
+     */
     interface HTMLSallaHookElement extends Components.SallaHook, HTMLStencilElement {
     }
     var HTMLSallaHookElement: {
@@ -5033,6 +5053,10 @@ declare global {
         prototype: HTMLSallaRatingStarsElement;
         new (): HTMLSallaRatingStarsElement;
     };
+    /**
+     * The `salla-review-card` component displays a product review with images, ratings, and product info.
+     * Supports image carousel with swipe gestures.
+     */
     interface HTMLSallaReviewCardElement extends Components.SallaReviewCard, HTMLStencilElement {
     }
     var HTMLSallaReviewCardElement: {
@@ -5651,15 +5675,15 @@ declare namespace LocalJSX {
     }
     interface SallaAlert {
         /**
-          * Icon type (defaults to variant)
+          * The icon type to display. Defaults to the variant type. Set to 'none' to hide the icon.
          */
         "icon"?: 'info' | 'success' | 'warning' | 'error' | 'none';
         /**
-          * Message text
+          * The alert message text to display.
          */
         "message"?: string;
         /**
-          * Variant theme
+          * The visual style/theme of the alert. Can be 'info', 'success', 'warning', or 'error'. Default is 'info'.
           * @default 'info'
          */
         "variant"?: 'info' | 'success' | 'warning' | 'error';
@@ -5861,12 +5885,12 @@ declare namespace LocalJSX {
     }
     interface SallaButton {
         /**
-          * Button Color
+          * The color theme of the button. Available options: 'primary', 'success', 'warning', 'danger', 'light', 'gray', 'dark'. Default is 'primary'.
           * @default 'primary'
          */
         "color"?: 'primary' | 'success' | 'warning' | 'danger' | 'light' | 'gray' | 'dark';
         /**
-          * Is the button currently disabled
+          * Disables the button, preventing user interaction. Default is false.
           * @default false
          */
         "disabled"?: boolean;
@@ -5876,41 +5900,41 @@ declare namespace LocalJSX {
          */
         "enableLoader"?: boolean;
         /**
-          * Button Fill
+          * The fill style of the button. 'solid' (filled background), 'outline' (bordered, transparent background), or 'none'. Default is 'solid'.
           * @default 'solid'
          */
         "fill"?: 'solid' | 'outline' | 'none';
         /**
-          * Button with href as normal link
+          * When provided, renders the button as an anchor (`<a>`) element with this URL.
          */
         "href"?: string;
         /**
-          * If there is need to change loader position, pass the position
+          * Position of the loading spinner. Can be 'start', 'end', 'center', or 'after' (after the button text). Default is 'after'.
           * @default 'after'
          */
         "loaderPosition"?: 'start' | 'end' | 'center' | 'after';
         /**
-          * Is the button currently loading
+          * Shows a loading spinner on the button. Default is false.
           * @default false
          */
         "loading"?: boolean;
         /**
-          * Button Type
+          * The shape/variant of the button. Can be 'link' (text-only style), 'icon' (circular icon button), or 'btn' (standard button). Default is 'btn'.
           * @default 'btn'
          */
         "shape"?: 'link' | 'icon' | 'btn';
         /**
-          * Button Size
+          * The size of the button. Can be 'small', 'medium', or 'large'. Default is 'medium'.
           * @default 'medium'
          */
         "size"?: 'small' | 'large' | 'medium';
         /**
-          * Determines the type of the rendered button. By default, the type is set to "button," making it a general-purpose button. Setting `type` to "submit" makes the button behave as a submit button within a form, triggering form submission. Possible values for `type` include "button," "submit," "reset," and "menu.".  Possible values and their usage are as follows: "button" (default, used for general button functionality),  "reset" (resets form fields to their default values), and  "menu" (represents a button that, when activated, displays a context menu).
+          * The HTML type attribute for the button. 'button' (default, general-purpose), 'submit' (submits forms), or 'reset' (resets form fields).
           * @default "button"
          */
         "type"?: string;
         /**
-          * Button Width
+          * The width of the button. 'wide' makes the button full-width, 'normal' uses auto width. Default is 'normal'.
           * @default 'normal'
          */
         "width"?: 'wide' | 'normal';
@@ -5937,7 +5961,7 @@ declare namespace LocalJSX {
     }
     interface SallaCartSummary {
         /**
-          * Show cart label
+          * Whether to show the cart label text alongside the cart icon. Default is false (icon only).
          */
         "showCartLabel"?: boolean;
     }
@@ -6144,7 +6168,7 @@ declare namespace LocalJSX {
          */
         "boxTheme"?: string;
         /**
-          * If true, the count down numbers will be appear in a boxes
+          * Whether to display countdown numbers in boxed containers. Default is false.
          */
         "boxed"?: boolean;
         /**
@@ -6160,7 +6184,7 @@ declare namespace LocalJSX {
          */
         "buttonText"?: string;
         /**
-          * The color of the count down
+          * The color theme of the countdown. Can be 'primary', 'light', or 'dark'. Default is 'dark'.
           * @default 'dark'
          */
         "color"?: 'primary' | 'light' | 'dark';
@@ -6169,16 +6193,16 @@ declare namespace LocalJSX {
          */
         "date"?: string;
         /**
-          * The digits lang to show in the count down
+          * The language/format for displaying digits. 'en' for English numerals, 'auto' for localized numerals. Default is 'auto'.
           * @default 'auto'
          */
         "digits"?: 'en' | 'auto';
         /**
-          * If true, the count down will end at the end of the day
+          * Whether to set the countdown end time to the end of the specified day (23:59:59). Default is false.
          */
         "endOfDay"?: boolean;
         /**
-          * The text to show when the count down ends
+          * Custom text to display when the countdown ends. If not provided, uses the default localized message.
          */
         "endText"?: string;
         /**
@@ -6186,7 +6210,7 @@ declare namespace LocalJSX {
          */
         "horizontal"?: boolean;
         /**
-          * Show labels for each count down number
+          * Whether to show labels (day, hour, minute, second) below each countdown number. Default is false.
          */
         "labeled"?: boolean;
         /**
@@ -6202,7 +6226,7 @@ declare namespace LocalJSX {
          */
         "prefixText"?: string;
         /**
-          * The size of the count down
+          * The size of the countdown display. Can be 'sm', 'md', or 'lg'. Default is 'md'.
           * @default 'md'
          */
         "size"?: 'sm' | 'md' | 'lg';
@@ -6211,6 +6235,10 @@ declare namespace LocalJSX {
          */
         "withButton"?: boolean;
     }
+    /**
+     * The `salla-custom-fields` component renders custom form fields with validation support.
+     * Supports text and file upload fields with real-time validation.
+     */
     interface SallaCustomFields {
         /**
           * The list of custom fields to render. Can be a JSON string or an array of objects.
@@ -6853,7 +6881,7 @@ declare namespace LocalJSX {
     }
     interface SallaFilters {
         /**
-          * Array of filter options
+          * Array of filter options to display. Each filter contains key, label, type, and values for filtering products.
          */
         "filters"?: Filter[];
         /**
@@ -6939,6 +6967,10 @@ declare namespace LocalJSX {
          */
         "widgetTitle"?: string;
     }
+    /**
+     * The `salla-hook` component serves as a placeholder for dynamic content injection.
+     * Used by the Salla hooks system to mount elements at specific locations.
+     */
     interface SallaHook {
         /**
           * The unique name to identify the hook position.
@@ -7750,7 +7782,7 @@ declare namespace LocalJSX {
     }
     interface SallaProductCard {
         /**
-          * Compact list layout for drawers and lists.
+          * Whether to use a compact card layout suitable for drawers and lists. Default is false.
          */
         "compact"?: boolean;
         /**
@@ -7764,31 +7796,31 @@ declare namespace LocalJSX {
          */
         "forceShowWishlistButton"?: boolean;
         /**
-          * Full image card.
+          * Whether to use a full-image card style where the image covers the entire card. Default is false.
          */
         "fullImage"?: boolean;
         /**
-          * Hide add to cart button.
+          * Whether to hide the "Add to Cart" button. Default is false (button is shown).
          */
         "hideAddBtn"?: boolean;
         /**
-          * Horizontal card.
+          * Whether to display the card in horizontal (landscape) layout. Default is false (vertical layout).
          */
         "horizontal"?: boolean;
         /**
-          * Special card.
+          * Whether this is a special/featured product card with additional styling (like quantity pie chart). Default is false.
          */
         "isSpecial"?: boolean;
         /**
-          * Minimal card.
+          * Whether to use a minimal card style with reduced information. Default is false.
          */
         "minimal"?: boolean;
         /**
-          * Product information.
+          * The product data to display. Can be a JSON string or a product object containing id, name, image, price, etc.
          */
         "product"?: string | object;
         /**
-          * Support shadow on hover.
+          * Whether to add a shadow effect on hover. Default is false.
          */
         "shadowOnHover"?: boolean;
         /**
@@ -7797,7 +7829,7 @@ declare namespace LocalJSX {
          */
         "showOutOfStockBesidePrice"?: boolean;
         /**
-          * Show quantity.
+          * Whether to show the product quantity in a badge. Default is false.
          */
         "showQuantity"?: boolean;
     }
@@ -8199,7 +8231,7 @@ declare namespace LocalJSX {
     }
     interface SallaRatingStars {
         /**
-          * Allows the rating to be editable.
+          * Whether the rating is interactive/editable by the user. Default is false (display-only).
           * @default false
          */
         "editable"?: boolean;
@@ -8209,17 +8241,17 @@ declare namespace LocalJSX {
          */
         "labelBeforeStars"?: boolean;
         /**
-          * Sets input name.
+          * The name attribute for the rating input (used in forms). Default is 'rating'.
           * @default 'rating'
          */
         "name"?: string;
         /**
-          * Number of reviews to display.
+          * The number of reviews to display next to the stars. Default is 0 (hidden).
           * @default 0
          */
         "reviews"?: number;
         /**
-          * Sets the height and width of the component. Defaults to medium.
+          * The size of the star icons. Can be 'large', 'medium', 'small', or 'mini'. Default is 'medium'.
           * @default 'medium'
          */
         "size"?: "large" | "medium" | "small" | "mini";
@@ -8228,14 +8260,18 @@ declare namespace LocalJSX {
          */
         "tag"?: boolean;
         /**
-          * The rating value.
+          * The current rating value (0-5). Used to display filled stars.
          */
         "value"?: number;
         /**
-          * Show the description label.
+          * Whether to show a descriptive label (e.g., "Excellent", "Good") next to the rating. Default is false.
          */
         "withLabel"?: boolean;
     }
+    /**
+     * The `salla-review-card` component displays a product review with images, ratings, and product info.
+     * Supports image carousel with swipe gestures.
+     */
     interface SallaReviewCard {
         /**
           * The review object to render, containing review text, stars, product info, and images.
@@ -8484,17 +8520,17 @@ declare namespace LocalJSX {
     }
     interface SallaSkeleton {
         /**
-          * Set the skeleton height
+          * The height of the skeleton. Can be any CSS height value (e.g., '100%', '50px', '2rem'). Default is '100%'.
           * @default '100%'
          */
         "height"?: string;
         /**
-          * Set the shape type of the skeleton is it circle or normal
+          * The shape type of the skeleton. 'circle' for circular skeletons (e.g., avatars), 'normal' for rectangular shapes. Default is 'normal'.
           * @default 'normal'
          */
         "type"?: 'circle' | 'normal';
         /**
-          * Set the skeleton width
+          * The width of the skeleton. Can be any CSS width value (e.g., '100%', '50px', '2rem'). Default is '100%'.
           * @default '100%'
          */
         "width"?: string;
@@ -9155,6 +9191,10 @@ declare module "@stencil/core" {
             "salla-contacts": LocalJSX.SallaContacts & JSXBase.HTMLAttributes<HTMLSallaContactsElement>;
             "salla-cookies-bar": LocalJSX.SallaCookiesBar & JSXBase.HTMLAttributes<HTMLSallaCookiesBarElement>;
             "salla-count-down": LocalJSX.SallaCountDown & JSXBase.HTMLAttributes<HTMLSallaCountDownElement>;
+            /**
+             * The `salla-custom-fields` component renders custom form fields with validation support.
+             * Supports text and file upload fields with real-time validation.
+             */
             "salla-custom-fields": LocalJSX.SallaCustomFields & JSXBase.HTMLAttributes<HTMLSallaCustomFieldsElement>;
             "salla-datetime-picker": LocalJSX.SallaDatetimePicker & JSXBase.HTMLAttributes<HTMLSallaDatetimePickerElement>;
             /**
@@ -9192,6 +9232,10 @@ declare module "@stencil/core" {
              */
             "salla-gift-card-redeem": LocalJSX.SallaGiftCardRedeem & JSXBase.HTMLAttributes<HTMLSallaGiftCardRedeemElement>;
             "salla-gifting": LocalJSX.SallaGifting & JSXBase.HTMLAttributes<HTMLSallaGiftingElement>;
+            /**
+             * The `salla-hook` component serves as a placeholder for dynamic content injection.
+             * Used by the Salla hooks system to mount elements at specific locations.
+             */
             "salla-hook": LocalJSX.SallaHook & JSXBase.HTMLAttributes<HTMLSallaHookElement>;
             "salla-infinite-scroll": LocalJSX.SallaInfiniteScroll & JSXBase.HTMLAttributes<HTMLSallaInfiniteScrollElement>;
             "salla-installment": LocalJSX.SallaInstallment & JSXBase.HTMLAttributes<HTMLSallaInstallmentElement>;
@@ -9345,6 +9389,10 @@ declare module "@stencil/core" {
             "salla-rating-modal": LocalJSX.SallaRatingModal & JSXBase.HTMLAttributes<HTMLSallaRatingModalElement>;
             "salla-rating-modal-v2": LocalJSX.SallaRatingModalV2 & JSXBase.HTMLAttributes<HTMLSallaRatingModalV2Element>;
             "salla-rating-stars": LocalJSX.SallaRatingStars & JSXBase.HTMLAttributes<HTMLSallaRatingStarsElement>;
+            /**
+             * The `salla-review-card` component displays a product review with images, ratings, and product info.
+             * Supports image carousel with swipe gestures.
+             */
             "salla-review-card": LocalJSX.SallaReviewCard & JSXBase.HTMLAttributes<HTMLSallaReviewCardElement>;
             "salla-review-factors-tags": LocalJSX.SallaReviewFactorsTags & JSXBase.HTMLAttributes<HTMLSallaReviewFactorsTagsElement>;
             "salla-review-order-item": LocalJSX.SallaReviewOrderItem & JSXBase.HTMLAttributes<HTMLSallaReviewOrderItemElement>;