vlite3 1.4.2 → 1.4.4

package/components/Cart/types.d.ts

@@ -0,0 +1,391 @@
+export type CartVariant = 'Variant1' | 'Variant2' | 'Variant3' | 'Variant4';
+/** How the cart should be sized within its parent */
+export type CartSize = 'sm' | 'md' | 'lg';
+/**
+ * Tax configuration. The cart applies this automatically when `data.totals`
+ * is not provided. Supports the most common real-world scenarios:
+ *
+ * - **`rate`**     — percent-based tax on the post-discount subtotal
+ *                    (e.g. 8.75% US sales tax, 19% German VAT)
+ * - **`flat`**     — fixed tax amount (e.g. "$5 service fee")
+ * - **`exempt`**   — no tax at all (digital goods, B2B resale, etc.)
+ * - **`inclusive`**— tax already baked into the displayed price (EU VAT)
+ */
+export interface CartTaxConfig {
+    mode: 'rate' | 'flat' | 'exempt' | 'inclusive';
+    /** Percent rate when `mode === 'rate' | 'inclusive'` (e.g. 8.75) */
+    rate?: number;
+    /** Fixed amount when `mode === 'flat'` */
+    amount?: number;
+    /** Override the default label (e.g. "GST" instead of "Tax (10%)") */
+    label?: string;
+    /** Currency this tax applies to (defaults to the cart currency) */
+    currency?: string;
+    /**
+     * What base to apply tax on. Default: 'afterDiscount' (most common).
+     * - `subtotal`        — full subtotal before any coupon
+     * - `afterDiscount`   — subtotal minus coupon discount
+     * - `original`        — alias for `subtotal`
+     */
+    applyTo?: 'subtotal' | 'afterDiscount' | 'original';
+}
+/**
+ * Shipping configuration. Plug-and-play with the most common e-commerce /
+ * POS patterns. Use `mode: 'function'` for fully custom logic.
+ */
+export interface CartShippingConfig {
+    mode: 'flat' | 'free' | 'freeOver' | 'tiered' | 'function' | 'pickup';
+    /** Default shipping cost (for `flat` / `freeOver`) */
+    cost?: number;
+    /** Free-shipping threshold (for `freeOver`) */
+    freeOver?: number;
+    /** Tiered shipping table (for `tiered`) */
+    tiers?: Array<{
+        /** Min subtotal for this tier to apply */
+        minSubtotal: number;
+        /** Shipping cost for this tier (0 = free) */
+        cost: number;
+        /** Optional label override for this tier */
+        label?: string;
+    }>;
+    /** Custom calculation (for `function`) */
+    calculate?: (subtotal: number, items: CartItem[]) => {
+        cost: number;
+        isFree?: boolean;
+        label?: string;
+    };
+    /** Default label for the shipping line */
+    label?: string;
+    /** Currency this shipping cost is in */
+    currency?: string;
+}
+/**
+ * A coupon's business rules. Pass an array of these as `data.coupons` and
+ * the cart will validate user-typed codes against this list internally —
+ * you don't need any custom code in your component to handle fixed/percent
+ * discounts, min-spend, expiry, or max-cap.
+ *
+ * If you need server-side validation (rate-limited, single-use, fraud),
+ * use `validateCoupon` on `CartProps` instead — the cart will await it
+ * and drive the `applying` / `applied` / `invalid` UX for you.
+ */
+export interface CartCouponDefinition {
+    /** Coupon code (case-insensitive match by default) */
+    code: string;
+    /** 'percentage' (% off subtotal) or 'fixed' (flat amount off) */
+    type: 'percentage' | 'fixed';
+    /** Discount value — percent (0-100) for 'percentage', currency for 'fixed' */
+    value: number;
+    /** Human-readable description, e.g. "10% off your first order" */
+    description?: string;
+    /** Min cart subtotal required to apply */
+    minSubtotal?: number;
+    /** Cap on the discount amount (mostly for `type: 'percentage'`) */
+    maxDiscount?: number;
+    /** ISO 8601 / Date — coupon expiry */
+    expiresAt?: string | Date;
+    /** ISO 4217 currency code (coupon only applies to matching currency) */
+    currency?: string;
+    /**
+     * For stacking: how many times this coupon can be applied (1 by default).
+     * Single-use coupons set this to 1.
+     */
+    usageLimit?: number;
+    /** Optional minimum item count required */
+    minItems?: number;
+}
+/**
+ * Drives the coupon input's visual state and helper message.
+ *
+ * - `idle`     → empty input, no validation feedback
+ * - `applying` → request in flight (shows spinner, disables input)
+ * - `applied`  → success state (green check, shows "Remove" action)
+ * - `invalid`  → code does not exist (red border + helper text)
+ * - `expired`  → coupon no longer valid (amber border + helper text)
+ * - `error`    → generic error (e.g. min spend not met) — message from API
+ */
+export type CartCouponState = 'idle' | 'applying' | 'applied' | 'invalid' | 'expired' | 'error';
+export interface CartTrustSignal {
+    /** Iconify name, e.g. "lucide:truck" */
+    icon: string;
+    /** Text to display */
+    text: string;
+}
+export interface CartItem {
+    /** Unique identifier for the line item */
+    id: string | number;
+    /** Product / service name (required) */
+    name: string;
+    /** Optional secondary description */
+    description?: string;
+    /** URL to the product thumbnail */
+    thumbnail?: string;
+    /** SKU / barcode string */
+    sku?: string;
+    /** Variant label (size, color, etc.) */
+    variant?: string;
+    /** Unit price */
+    price: number;
+    /** Quantity in cart */
+    quantity: number;
+    /** Optional strike-through original price (for sale items) */
+    originalPrice?: number;
+    /** Hard cap on the qty stepper (e.g. stock) */
+    maxQuantity?: number;
+    /** Mark out-of-stock items (renders disabled state) */
+    inStock?: boolean;
+    /** Whether this line should be taxed */
+    taxable?: boolean;
+    /** Free-form metadata — passed through to custom renderers via slots */
+    metadata?: Record<string, any>;
+}
+export interface CartCoupon {
+    /** The coupon code as typed by the user */
+    code: string;
+    /** Human-readable description, e.g. "10% off your order" */
+    description?: string;
+    /** Current state of the coupon in the UX (see CartCouponState) */
+    state?: CartCouponState;
+    /** Discount amount (positive number) applied to the cart */
+    discountAmount?: number;
+    /**
+     * Free-form message from the validation API.
+     * Shown in the helper-text area when state is 'invalid' | 'expired' | 'error'.
+     */
+    message?: string;
+    /** ISO 8601 / Date — used to render the "Expires in 2d" pill */
+    expiresAt?: string | Date;
+    /**
+     * The full coupon definition. When provided, the cart will recompute
+     * `discountAmount` automatically as items change. Without it, the
+     * cart trusts whatever `discountAmount` you pass in.
+     */
+    definition?: CartCouponDefinition;
+}
+export interface CartTotals {
+    /** Sum of all line items before any discount/tax/shipping */
+    subtotal: number;
+    /** Total discount applied to the order (positive number) */
+    discount?: number;
+    /** Estimated tax — labelled exactly as the user asked: "Estimated Tax" */
+    estimatedTax?: number;
+    /** Tax rate in percent (e.g. 8.625) — used to render "Tax (8.625%)" */
+    taxRate?: number;
+    /** Shipping cost */
+    shipping?: number;
+    /** Final amount to charge (after discount + tax + shipping) */
+    grandTotal: number;
+    /** Number of items — used to render the "Items (4)" line in the summary */
+    itemCount?: number;
+    /** Total saved vs. original prices — rendered as a savings pill */
+    totalSavings?: number;
+    /** ISO 4217 currency code (defaults to the global Price config) */
+    currency?: string;
+    /** Subtotal of taxable items only (used internally; safe to ignore) */
+    taxableSubtotal?: number;
+    /**
+     * Free-shipping progress hint. When the user is below the free-shipping
+     * threshold, the cart renders "Add $X more for free shipping".
+     */
+    freeShippingProgress?: {
+        /** Amount left to spend to unlock free shipping */
+        remaining: number;
+        /** The free-shipping threshold itself */
+        threshold: number;
+    } | null;
+    /** Per-line tax breakdown — drives the summary if you want multi-rate tax */
+    taxBreakdown?: Array<{
+        label: string;
+        amount: number;
+        rate?: number;
+    }>;
+}
+export interface CartActions {
+    /** Label for the primary action, e.g. "Continue to Checkout" */
+    continueLabel?: string;
+    /** Label for the secondary action, e.g. "Continue Shopping" */
+    continueShoppingLabel?: string;
+    /** Show / hide the primary action button */
+    showContinue?: boolean;
+    /** Show / hide the secondary action button */
+    showContinueShopping?: boolean;
+    /** Disable the primary action (e.g. when cart is empty) */
+    continueDisabled?: boolean;
+    /** Disable the secondary action */
+    continueShoppingDisabled?: boolean;
+    /** Optional icon for the primary action (Iconify name) */
+    continueIcon?: string;
+    /** Optional icon for the secondary action (Iconify name) */
+    continueShoppingIcon?: string;
+}
+/**
+ * Every optional block of the cart can be turned on or off independently.
+ * This is what makes the same component usable across e-commerce and POS.
+ *
+ * Defaults are documented per field — they are designed to satisfy the
+ * "out-of-the-box e-commerce cart" use case. POS scenarios explicitly
+ * disable thumbnails and description.
+ */
+export interface CartFeatures {
+    /** Allow +/- quantity stepper (disabled in readonly) */
+    editableQuantity?: boolean;
+    /** Allow removing individual items */
+    removable?: boolean;
+    /** Show the "Clear cart" action */
+    clearable?: boolean;
+    /** Show the coupon input */
+    coupon?: boolean;
+    /** Show the Subtotal row */
+    subtotal?: boolean;
+    /** Show the Discount row */
+    discount?: boolean;
+    /** Show the Estimated Tax row */
+    estimatedTax?: boolean;
+    /** Show the Shipping row */
+    shipping?: boolean;
+    /** Show the Total Savings row */
+    totalSavings?: boolean;
+    /** Show the primary "Continue" action */
+    continue?: boolean;
+    /** Show the secondary "Continue shopping" action */
+    continueShopping?: boolean;
+    /** Show item thumbnails (false in POS compact) */
+    thumbnails?: boolean;
+    /** Show the secondary description line under the name */
+    description?: boolean;
+    /** Show the SKU line under the name */
+    sku?: boolean;
+    /** Show the variant label (size, color) */
+    itemVariant?: boolean;
+    /** Render an Empty state when there are no items */
+    emptyState?: boolean;
+    /** Show trust signals (if provided in data) */
+    trustSignals?: boolean;
+}
+export interface CartData {
+    /** Cart title (e.g. "Your Cart", "Order #1287", "Basket") */
+    title?: string;
+    /** Optional subtitle / context line */
+    subtitle?: string;
+    /** Brand / store name */
+    brandName?: string;
+    /** Brand / store logo URL */
+    brandLogo?: string;
+    /** Line items in the cart */
+    items: CartItem[];
+    /**
+     * Totals breakdown. OPTIONAL — if you don't pass it, the cart computes
+     * it automatically from `items + tax + shipping + coupon`. If you do
+     * pass it (e.g. server-computed or pre-aggregated), the cart uses it
+     * verbatim and skips its own math.
+     */
+    totals?: CartTotals;
+    /** Currently applied coupon, if any */
+    coupon?: CartCoupon;
+    /**
+     * Tax configuration. Used by the built-in calculator when `totals`
+     * is not provided. Ignored when `totals` is provided.
+     */
+    tax?: CartTaxConfig;
+    /**
+     * Shipping configuration. Used by the built-in calculator when `totals`
+     * is not provided. Ignored when `totals` is provided.
+     */
+    shipping?: CartShippingConfig;
+    /**
+     * Catalog of valid coupons. When provided, the cart will validate
+     * user-typed codes against this list internally — no `apply-coupon`
+     * event handler needed. Use this for static coupon lists; for
+     * server-validated coupons, use the `validateCoupon` prop instead.
+     */
+    coupons?: CartCouponDefinition[];
+    /**
+     * Default currency for the cart. Used by the calculation engine when
+     * `totals` is not provided. Falls back to the global Price config.
+     */
+    currency?: string;
+    /** Mark the entire cart read-only (no qty edits, no remove, no coupon change) */
+    readonly?: boolean;
+    /** Reduce padding/typography (mirrors Invoice `compact` flag) */
+    compact?: boolean;
+    /** Manually toggle the empty state (overrides `items.length === 0`) */
+    empty?: boolean;
+    /** Optional trust signals (e.g. "Free shipping over $50", "30-day returns"). */
+    trustSignals?: CartTrustSignal[];
+    /** Custom CSS class for the root container */
+    containerClass?: string | any[] | Record<string, boolean>;
+}
+export interface CartLabels {
+    /** Replaces the default "Cart" / "Your Cart" heading */
+    cart?: string;
+    /** Replaces the default "Your cart is empty" heading in the empty state */
+    emptyTitle?: string;
+    /** Replaces the default empty-state description */
+    emptyDescription?: string;
+    /** Replaces the default "Start shopping" CTA in the empty state */
+    emptyAction?: string;
+    /** Replaces the default "Subtotal" label */
+    subtotal?: string;
+    /** Replaces the default "Discount" label */
+    discount?: string;
+    /** Replaces the default "Estimated Tax" label */
+    estimatedTax?: string;
+    /** Replaces the default "Shipping" label */
+    shipping?: string;
+    /** Replaces the default "Grand Total" label */
+    grandTotal?: string;
+    /** Replaces the default "Total Savings" label */
+    totalSavings?: string;
+    /** Replaces the default "Coupon" input label */
+    coupon?: string;
+    /** Replaces the default coupon input placeholder */
+    couponPlaceholder?: string;
+    /** Replaces the default "Apply" button text */
+    applyCoupon?: string;
+    /** Replaces the default "Remove coupon" aria-label on the applied-coupon × button */
+    removeCoupon?: string;
+    /** Replaces the default "Quantity" label */
+    quantity?: string;
+    /** Replaces the default "Remove" item button */
+    remove?: string;
+    /** Replaces the default "Continue to checkout" button */
+    continue?: string;
+    /** Replaces the default "Continue shopping" button */
+    continueShopping?: string;
+    /** Replaces the default "Clear cart" action */
+    clearCart?: string;
+    /** Replaces the default "Items" prefix in summary (e.g. "Items (3)") */
+    itemCount?: string;
+}
+export interface CartProps {
+    /** The complete cart data object (required) */
+    data: CartData;
+    /** Visual layout variant */
+    variant?: CartVariant;
+    /** Action button configuration */
+    actions?: CartActions;
+    /** Per-feature on/off toggles */
+    features?: CartFeatures;
+    /** Custom text label overrides */
+    labels?: CartLabels;
+    /** Custom CSS class for the root container */
+    containerClass?: string | any[] | Record<string, boolean>;
+    /**
+     * Async server-side coupon validator. Receives the code the user typed
+     * and the current subtotal; resolves with a `CartCouponDefinition`
+     * (or null to reject). When provided, this takes precedence over
+     * `data.coupons` for the apply flow.
+     *
+     * The cart automatically drives the `applying` / `applied` / `invalid`
+     * / `expired` / `error` UX around this call.
+     */
+    validateCoupon?: (code: string, context: {
+        subtotal: number;
+        currency?: string;
+        items: CartItem[];
+    }) => Promise<CartCouponDefinition | {
+        code: string;
+        message: string;
+        state?: 'invalid' | 'expired' | 'error';
+    } | null>;
+}

package/components/CategoryManager/CategoryManager.vue.d.ts

@@ -37,11 +37,11 @@ declare const __VLS_component: import('vue').DefineComponent<CategoryManagerProp
 }>, {
     size: "sm" | "md" | "lg";
     loading: boolean;
+    emptyTitle: string;
+    emptyDescription: string;
     readonly: boolean;
     modelValue: CategoryItem[];
     rawData: RawCategoryItem[];
-    emptyTitle: string;
-    emptyDescription: string;
     defaultExpanded: (string | number)[];
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

package/components/CategoryManager/CategoryManager.vue2.js

@@ -17,7 +17,7 @@ import "v-datepicker-lite";
 import "v-datepicker-lite/style.css";
 import "@jaames/iro";
 import "@vueuse/core";
-/* empty css                           */
+/* empty css                          */
 import Ue from "../IconPicker.vue.js";
 /* empty css                        */
 /* empty css                                         */

package/components/CategoryMenu/CategoryMenuVariant1.vue.js

@@ -33,7 +33,7 @@ const T = {
       f("select", { id: "all", title: o.allItemLabel });
     }, u = (n, c = []) => O(o.routePrefix, n, c), x = (n) => n ? "router-link" : "button", g = (n) => n ? { to: n } : { type: "button" }, y = (n) => o.activeId ? n.id === o.activeId || (n.children || []).some((c) => y(c)) : !1;
     return (n, c) => (t(), s("nav", {
-      class: P(["relative w-full bg-card", o.class]),
+      class: P(["relative w-full", o.class]),
       role: "navigation",
       "aria-label": "Categories"
     }, [

package/components/Clipboard.vue.d.ts

@@ -27,11 +27,11 @@ declare function __VLS_template(): {
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<ClipboardProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    copy: (text: string) => any;
     error: (err: Error) => any;
+    copy: (text: string) => any;
 }, string, import('vue').PublicProps, Readonly<ClipboardProps> & Readonly<{
-    onCopy?: (text: string) => any;
     onError?: (err: Error) => any;
+    onCopy?: (text: string) => any;
 }>, {
     variant: ButtonVariant;
     size: ButtonSize;

package/components/ColorPicker/ColorIro.vue3.js

@@ -1,5 +1,5 @@
-import o from "./ColorIro.vue.js";
-/* empty css              */
+import o from "./ColorIro.vue2.js";
+/* empty css             */
 export {
   o as default
 };

package/components/ColorPicker/ColorPicker.vue.js

@@ -7,8 +7,8 @@ import "../../core/config.js";
 /* empty css                                    */
 /* empty css                            */
 import E from "../Button.vue.js";
-import _ from "./ColorIro.vue.js";
-/* empty css              */
+import _ from "./ColorIro.vue2.js";
+/* empty css             */
 import { useEyeDropper as I } from "@vueuse/core";
 const N = { class: "absolute left-2.5 top-1/2 -translate-y-1/2 flex items-center justify-center z-20 pointer-events-none" }, j = {
   key: 0,

package/components/Dropdown/Dropdown.vue.js

@@ -254,6 +254,7 @@ const He = /* @__PURE__ */ ae({
             searchable: t.searchable,
             remote: t.remote,
             debounceTime: t.debounceTime,
+            trigger: t.trigger,
             onSelect: le,
             onClose: w,
             onLoadMore: o[0] || (o[0] = (n) => e.$emit("load-more")),
@@ -288,7 +289,7 @@ const He = /* @__PURE__ */ ae({
               ]),
               key: "3"
             } : void 0
-          ]), 1032, ["options", "cachedOptions", "class", "emptyMessage", "searchEmptyMessage", "selected", "selectedIndex", "maxHeight", "nestedPosition", "nestedOffset", "selectable", "direction", "isCustomSlotMenu", "layout", "columns", "loading", "hasMore", "searchable", "remote", "debounceTime"])) : ye("", !0)
+          ]), 1032, ["options", "cachedOptions", "class", "emptyMessage", "searchEmptyMessage", "selected", "selectedIndex", "maxHeight", "nestedPosition", "nestedOffset", "selectable", "direction", "isCustomSlotMenu", "layout", "columns", "loading", "hasMore", "searchable", "remote", "debounceTime", "trigger"])) : ye("", !0)
         ]),
         _: 3
       }, 8, ["trigger", "disabled", "teleport", "offset", "placement", "isOpen", "keepAlive", "menuId", "ignoreClickOutside", "className", "styles"]),

package/components/Dropdown/DropdownMenu.vue.d.ts

@@ -20,6 +20,7 @@ interface Props {
     direction?: 'ltr' | 'rtl';
     emptyMessage?: string;
     searchEmptyMessage?: string;
+    trigger?: import('v-tooltip-lite/types').TooltTipTrigger;
 }
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -54,6 +55,7 @@ declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {},
     columns: number | string;
     loading: boolean;
     layout: "default" | "grouped";
+    trigger: import('v-tooltip-lite/types').TooltTipTrigger;
     direction: "ltr" | "rtl";
     selectable: boolean;
     options: (IDropdownOption | string | number)[];

package/components/Dropdown/DropdownMenu.vue.js

@@ -1,7 +1,7 @@
-import o from "./DropdownMenu.vue3.js";
+import o from "./DropdownMenu.vue2.js";
 /* empty css                  */
 import r from "../../_virtual/_plugin-vue_export-helper.js";
-const m = /* @__PURE__ */ r(o, [["__scopeId", "data-v-0df8084f"]]);
+const m = /* @__PURE__ */ r(o, [["__scopeId", "data-v-754d002e"]]);
 export {
   m as default
 };