vlite3 1.4.2 → 1.4.4

package/components/AvatarUploader/AvatarUploader.vue.d.ts

@@ -13,12 +13,12 @@ export interface Props {
     className?: string;
 }
 declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    change: (value: FilePickerValue) => any;
     error: (error: string) => any;
+    change: (value: FilePickerValue) => any;
     "update:modelValue": (value: any) => any;
 }, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
-    onChange?: (value: FilePickerValue) => any;
     onError?: (error: string) => any;
+    onChange?: (value: FilePickerValue) => any;
     "onUpdate:modelValue"?: (value: any) => any;
 }>, {
     alt: string;

package/components/Cart/Cart.vue.d.ts

@@ -0,0 +1,27 @@
+import { CartProps, CartCoupon, CartTotals } from './types';
+declare const _default: import('vue').DefineComponent<CartProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    clear: () => any;
+    remove: (itemId: string | number) => any;
+    continue: () => any;
+    "update:quantity": (itemId: string | number, quantity: number) => any;
+    "continue-shopping": () => any;
+    "apply-coupon": (code: string) => any;
+    "remove-coupon": () => any;
+    "coupon-change": (code: string) => any;
+    "update:coupon": (coupon: CartCoupon) => any;
+    "update:totals": (totals: CartTotals) => any;
+}, string, import('vue').PublicProps, Readonly<CartProps> & Readonly<{
+    onClear?: () => any;
+    onRemove?: (itemId: string | number) => any;
+    onContinue?: () => any;
+    "onUpdate:quantity"?: (itemId: string | number, quantity: number) => any;
+    "onContinue-shopping"?: () => any;
+    "onApply-coupon"?: (code: string) => any;
+    "onRemove-coupon"?: () => any;
+    "onCoupon-change"?: (code: string) => any;
+    "onUpdate:coupon"?: (coupon: CartCoupon) => any;
+    "onUpdate:totals"?: (totals: CartTotals) => any;
+}>, {
+    variant: import('./types').CartVariant;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/components/Cart/CartCouponInput.vue.d.ts

@@ -0,0 +1,32 @@
+import { CartCoupon, CartLabels } from './types';
+/**
+ * Coupon field with all UX states modelled as a discriminated union.
+ *
+ * - idle     → empty input, no validation feedback
+ * - applying → request in flight (spinner, input + button disabled)
+ * - applied  → success state, shows remove action and discount summary
+ * - invalid  → code not recognised (red border + helper text)
+ * - expired  → coupon no longer valid (amber border + helper text)
+ * - error    → generic API error, uses `coupon.message` for helper text
+ *
+ * The parent owns validation logic; the component only renders.
+ */
+type __VLS_Props = {
+    coupon?: CartCoupon;
+    labels: CartLabels;
+    compact?: boolean;
+    readonly?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    remove: () => any;
+    apply: (code: string) => any;
+    change: (code: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onRemove?: () => any;
+    onApply?: (code: string) => any;
+    onChange?: (code: string) => any;
+}>, {
+    compact: boolean;
+    readonly: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/components/Cart/CartEmptyState.vue.d.ts

@@ -0,0 +1,17 @@
+import { CartLabels } from './types';
+/**
+ * Empty-cart state, rendered when items.length === 0 (and features.emptyState).
+ * Same look across all variants; the parent controls size via `compact`.
+ */
+type __VLS_Props = {
+    labels: CartLabels;
+    compact?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "continue-shopping": () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onContinue-shopping"?: () => any;
+}>, {
+    compact: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/components/Cart/CartLineItem.vue.d.ts

@@ -0,0 +1,29 @@
+import { CartItem, CartFeatures, CartLabels } from './types';
+/**
+ * Internal layout hints — passed by the variant parent to switch presentation.
+ * - 'drawer' : full image, name, sku, variant, qty stepper, price, remove
+ * - 'compact': no image, dense single-line per item (POS / register)
+ * - 'card'   : image + name + variant stacked, controls in a row below
+ * - 'mini'   : single line, name, qty, price; minimal controls
+ */
+type Layout = 'drawer' | 'compact' | 'card' | 'mini';
+type __VLS_Props = {
+    item: CartItem;
+    features: CartFeatures;
+    labels: CartLabels;
+    compact?: boolean;
+    readonly?: boolean;
+    layout?: Layout;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    remove: (itemId: string | number) => any;
+    "update:quantity": (itemId: string | number, quantity: number) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onRemove?: (itemId: string | number) => any;
+    "onUpdate:quantity"?: (itemId: string | number, quantity: number) => any;
+}>, {
+    compact: boolean;
+    readonly: boolean;
+    layout: Layout;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/components/Cart/CartSummary.vue.d.ts

@@ -0,0 +1,29 @@
+import { CartTotals, CartFeatures, CartLabels, CartVariant, CartCoupon } from './types';
+/**
+ * Subtotal / Discount / Estimated Tax / Shipping / Grand Total renderer.
+ * Used by Variant1, Variant2, Variant3. Variant4 inlines its own summary
+ * to preserve the mini-cart look.
+ *
+ * Driven entirely by `features` — every row is conditionally rendered, so
+ * the same component can produce a single-line POS total or a full
+ * e-commerce summary without branching at the call site.
+ *
+ * Accepts the applied `coupon` (optional) so it can render the discount
+ * row as "Discount · WELCOME10" + "−$25.00" / "−10%". Also renders the
+ * free-shipping progress hint ("Add $X more for free shipping") when the
+ * totals carry a `freeShippingProgress` payload.
+ */
+type __VLS_Props = {
+    totals: CartTotals;
+    features: CartFeatures;
+    labels: CartLabels;
+    compact?: boolean;
+    variant?: CartVariant;
+    /** Currently applied coupon (for the discount-row caption + pill) */
+    coupon?: CartCoupon;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    variant: CartVariant;
+    compact: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/components/Cart/CartVariant1.vue.d.ts

@@ -0,0 +1,42 @@
+import { CartData, CartActions, CartFeatures, CartLabels, CartVariant } from './types';
+/**
+ * Variant 1 — E-commerce Drawer / Slide-over Cart
+ *
+ * - Full-width drawer / panel layout
+ * - Header: title + item count + close
+ * - Scrollable line-items list
+ * - Sticky footer: coupon + summary + actions
+ * - Best for: site.com slide-over cart, mobile / tablet cart drawer
+ */
+type __VLS_Props = {
+    data: CartData;
+    actions: CartActions;
+    features: CartFeatures;
+    labels: CartLabels;
+    compact?: boolean;
+    variant?: CartVariant;
+    containerClass?: string | any[] | Record<string, boolean>;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    clear: () => any;
+    remove: (itemId: string | number) => any;
+    continue: () => any;
+    "update:quantity": (itemId: string | number, quantity: number) => any;
+    "continue-shopping": () => any;
+    "apply-coupon": (code: string) => any;
+    "remove-coupon": () => any;
+    "coupon-change": (code: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClear?: () => any;
+    onRemove?: (itemId: string | number) => any;
+    onContinue?: () => any;
+    "onUpdate:quantity"?: (itemId: string | number, quantity: number) => any;
+    "onContinue-shopping"?: () => any;
+    "onApply-coupon"?: (code: string) => any;
+    "onRemove-coupon"?: () => any;
+    "onCoupon-change"?: (code: string) => any;
+}>, {
+    variant: CartVariant;
+    compact: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/components/Cart/CartVariant2.vue.d.ts

@@ -0,0 +1,42 @@
+import { CartData, CartActions, CartFeatures, CartLabels, CartVariant } from './types';
+/**
+ * Variant 2 — POS / Register Cart
+ *
+ *   - Dense, register-friendly layout
+ *   - No thumbnails (faster scanning at the till)
+ *   - Receipt-style dashed dividers
+ *   - Inline coupon + summary, two compact side-by-side actions
+ *   - Best for: in-store POS, kitchen tickets, fast-checkout flows
+ */
+type __VLS_Props = {
+    data: CartData;
+    actions: CartActions;
+    features: CartFeatures;
+    labels: CartLabels;
+    compact?: boolean;
+    variant?: CartVariant;
+    containerClass?: string | any[] | Record<string, boolean>;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    clear: () => any;
+    remove: (itemId: string | number) => any;
+    continue: () => any;
+    "update:quantity": (itemId: string | number, quantity: number) => any;
+    "continue-shopping": () => any;
+    "apply-coupon": (code: string) => any;
+    "remove-coupon": () => any;
+    "coupon-change": (code: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClear?: () => any;
+    onRemove?: (itemId: string | number) => any;
+    onContinue?: () => any;
+    "onUpdate:quantity"?: (itemId: string | number, quantity: number) => any;
+    "onContinue-shopping"?: () => any;
+    "onApply-coupon"?: (code: string) => any;
+    "onRemove-coupon"?: () => any;
+    "onCoupon-change"?: (code: string) => any;
+}>, {
+    variant: CartVariant;
+    compact: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/components/Cart/CartVariant3.vue.d.ts

@@ -0,0 +1,41 @@
+import { CartData, CartActions, CartFeatures, CartLabels, CartVariant } from './types';
+/**
+ * Variant 3 — Full Page Cart
+ *
+ * - Header (title + item count + clear)
+ * - Two-column body on lg+: items list (left) + sticky summary card (right)
+ * - Stacks on mobile
+ * - Best for: /cart route, e-commerce site, mobile-first responsive checkout
+ */
+type __VLS_Props = {
+    data: CartData;
+    actions: CartActions;
+    features: CartFeatures;
+    labels: CartLabels;
+    compact?: boolean;
+    variant?: CartVariant;
+    containerClass?: string | any[] | Record<string, boolean>;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    clear: () => any;
+    remove: (itemId: string | number) => any;
+    continue: () => any;
+    "update:quantity": (itemId: string | number, quantity: number) => any;
+    "continue-shopping": () => any;
+    "apply-coupon": (code: string) => any;
+    "remove-coupon": () => any;
+    "coupon-change": (code: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClear?: () => any;
+    onRemove?: (itemId: string | number) => any;
+    onContinue?: () => any;
+    "onUpdate:quantity"?: (itemId: string | number, quantity: number) => any;
+    "onContinue-shopping"?: () => any;
+    "onApply-coupon"?: (code: string) => any;
+    "onRemove-coupon"?: () => any;
+    "onCoupon-change"?: (code: string) => any;
+}>, {
+    variant: CartVariant;
+    compact: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/components/Cart/CartVariant4.vue.d.ts

@@ -0,0 +1,41 @@
+import { CartData, CartActions, CartFeatures, CartLabels, CartVariant } from './types';
+/**
+ * Variant 4 — Mini Cart / Summary
+ *
+ *   - Compact, single-column "summary-first" layout
+ *   - Tiny line items (no images, no qty stepper — name + qty + price)
+ *   - Inline summary, single primary CTA
+ *   - Best for: navbar dropdown, header mini-cart, side panel pre-checkout
+ */
+type __VLS_Props = {
+    data: CartData;
+    actions: CartActions;
+    features: CartFeatures;
+    labels: CartLabels;
+    compact?: boolean;
+    variant?: CartVariant;
+    containerClass?: string | any[] | Record<string, boolean>;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    clear: () => any;
+    remove: (itemId: string | number) => any;
+    continue: () => any;
+    "update:quantity": (itemId: string | number, quantity: number) => any;
+    "continue-shopping": () => any;
+    "apply-coupon": (code: string) => any;
+    "remove-coupon": () => any;
+    "coupon-change": (code: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClear?: () => any;
+    onRemove?: (itemId: string | number) => any;
+    onContinue?: () => any;
+    "onUpdate:quantity"?: (itemId: string | number, quantity: number) => any;
+    "onContinue-shopping"?: () => any;
+    "onApply-coupon"?: (code: string) => any;
+    "onRemove-coupon"?: () => any;
+    "onCoupon-change"?: (code: string) => any;
+}>, {
+    variant: CartVariant;
+    compact: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/components/Cart/composables/useCartCalculation.d.ts

@@ -0,0 +1,91 @@
+import { CartItem, CartTotals, CartTaxConfig, CartShippingConfig, CartCoupon } from '../types';
+/** Sum of (price × quantity) for items that are taxable (or all, if item.taxable is undefined). */
+export declare function sumLineTotals(items: CartItem[], onlyTaxable?: boolean): number;
+/** Sum of (originalPrice × quantity) − (price × quantity) across all items. */
+export declare function sumSavings(items: CartItem[]): number;
+export declare function sumItemCount(items: CartItem[]): number;
+/**
+ * Compute the discount amount a coupon would apply to a given subtotal.
+ * Returns 0 if the coupon doesn't qualify (expired / min-spend not met / etc).
+ */
+export declare function computeCouponDiscount(coupon: CartCoupon | null | undefined, subtotal: number, currency?: string): number;
+export interface TaxBreakdownLine {
+    /** Human label, e.g. "Sales Tax" or "VAT (20%)" */
+    label: string;
+    /** Computed tax amount */
+    amount: number;
+    /** Rate used (in percent), when applicable */
+    rate?: number;
+}
+export interface TaxResult {
+    /** Total tax across all breakdown lines */
+    total: number;
+    /** Per-line breakdown (single line for `rate`/`flat`, no lines for `exempt`) */
+    breakdown: TaxBreakdownLine[];
+}
+/**
+ * Compute tax on a given taxable subtotal using a `CartTaxConfig`.
+ * - `mode: 'rate'`     → percent-based tax (e.g. 8.75% sales tax)
+ * - `mode: 'flat'`     → fixed tax amount regardless of cart value
+ * - `mode: 'exempt'`   → no tax
+ * - `mode: 'inclusive'`→ tax is already inside the price (display only)
+ */
+export declare function computeTax(taxableSubtotal: number, tax: CartTaxConfig | undefined, roundToCents?: number): TaxResult;
+export interface ShippingResult {
+    /** Final shipping cost the customer pays */
+    cost: number;
+    /** True when the cost is 0 because the user crossed a free-shipping threshold */
+    isFree: boolean;
+    /** Human-readable reason, e.g. "Free over $50" or "Standard" */
+    label: string;
+    /** For UI: "Add $X more for free shipping" — null when already free / no rule */
+    freeShippingProgress: {
+        /** Amount left to spend to unlock free shipping (0 when already unlocked) */
+        remaining: number;
+        /** The threshold itself */
+        threshold: number;
+    } | null;
+}
+/**
+ * Compute shipping cost using a `CartShippingConfig`.
+ * - `mode: 'flat'`          → fixed cost
+ * - `mode: 'free'`          → always free
+ * - `mode: 'freeOver'`      → free when subtotal ≥ cost-free threshold
+ * - `mode: 'tiered'`        → lookup table; first row whose `minSubtotal ≤ subtotal` wins
+ * - `mode: 'function'`      → caller-provided (subtotal, items) => cost
+ * - `mode: 'pickup'`        → no shipping (in-store pickup)
+ */
+export declare function computeShipping(subtotal: number, shipping: CartShippingConfig | undefined, items: CartItem[]): ShippingResult;
+export interface CalculateInput {
+    items: CartItem[];
+    tax?: CartTaxConfig;
+    shipping?: CartShippingConfig;
+    /** The applied coupon (with optional `definition` for internal math) */
+    coupon?: CartCoupon | null;
+    /** Override rounding precision (default 2) */
+    roundToCents?: number;
+    /** Currency code — propagated to the result */
+    currency?: string;
+}
+export interface CalculateOutput {
+    /** The full `CartTotals` object the cart renders */
+    totals: CartTotals;
+    /** Per-line tax breakdown (empty array for `exempt` / no tax) */
+    taxBreakdown: TaxBreakdownLine[];
+    /** Free-shipping progress hint for the UI ("Add $X more…") */
+    freeShippingProgress: ShippingResult['freeShippingProgress'];
+}
+/**
+ * The single entry point used by the Cart. Pure: same input → same output.
+ *
+ *   items = [{ price: 100, quantity: 2 }, { price: 50, quantity: 1, taxable: false }]
+ *   tax = { mode: 'rate', rate: 8.75 }
+ *   shipping = { mode: 'freeOver', cost: 9.99, freeOver: 50 }
+ *   coupon = { code: 'WELCOME10', state: 'applied', definition: { type: 'percentage', value: 10, minSubtotal: 100 } }
+ *
+ *   → { subtotal: 250, discount: 25, taxableSubtotal: 200, estimatedTax: 17.50,
+ *        shipping: 0, grandTotal: 242.50, itemCount: 3, ... }
+ */
+export declare function calculateCartTotals(input: CalculateInput): CalculateOutput;
+/** Convenience helper for the most common case: just items + configs. */
+export declare function useCartCalculation(input: () => CalculateInput): CalculateOutput;

package/components/Cart/index.d.ts

@@ -0,0 +1,7 @@
+export { default as Cart } from './Cart.vue';
+export { default as CartLineItem } from './CartLineItem.vue';
+export { default as CartSummary } from './CartSummary.vue';
+export { default as CartCouponInput } from './CartCouponInput.vue';
+export { default as CartEmptyState } from './CartEmptyState.vue';
+export * from './composables/useCartCalculation';
+export * from './types';