@salla.sa/twilight-theme-engine 1.0.0-beta.4

package/dist/hooks/useCoupon.d.ts

@@ -0,0 +1,66 @@
+/**
+ * useCoupon - Hook for managing coupon functionality in cart
+ *
+ * @example
+ * ```tsx
+ * function CouponInput() {
+ *   const { value, apply, remove, error, loading } = useCoupon();
+ *
+ *   return (
+ *     <div>
+ *       <input placeholder="Enter coupon" />
+ *       <button onClick={() => apply(code)}>Apply</button>
+ *       {error && <span>{error}</span>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+import type { UseApply } from './types';
+/**
+ * UseCouponResult - Return type for useCoupon hook
+ */
+export type UseCouponResult = UseApply<string>;
+/**
+ * useCoupon - Hook for managing cart coupons
+ *
+ * Handles applying and removing coupons from the cart using the
+ * Salla SDK. Returns state for loading, errors, and the current
+ * coupon value.
+ *
+ * @returns Coupon management object with apply and remove functions
+ *
+ * @example
+ * ```tsx
+ * function CouponInput() {
+ *   const { value, apply, remove, error, loading } = useCoupon();
+ *
+ *   const [code, setCode] = useState('');
+ *
+ *   return (
+ *     <div>
+ *       {value ? (
+ *         <>
+ *           <span>Coupon applied: {value}</span>
+ *           <button onClick={remove}>Remove</button>
+ *         </>
+ *       ) : (
+ *         <div>
+ *           <input
+ *             placeholder="Enter coupon code"
+ *             value={code}
+ *             onChange={(e) => setCode(e.target.value)}
+ *           />
+ *           <button onClick={() => apply(code)} disabled={loading}>
+ *             Apply
+ *           </button>
+ *         </div>
+ *       )}
+ *       {error && <span className="error">{error}</span>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useCoupon(): UseCouponResult;
+//# sourceMappingURL=useCoupon.d.ts.map

package/dist/hooks/useCoupon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCoupon.d.ts","sourceRoot":"","sources":["../../src/hooks/useCoupon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAqB3C"}

package/dist/hooks/useCoupon.js

@@ -0,0 +1,5 @@
+export { useCoupon } from '../chunk-BVSJPBJ6.js';
+import '../chunk-6BZ5TKEV.js';
+import '../chunk-DGUM43GV.js';
+//# sourceMappingURL=useCoupon.js.map
+//# sourceMappingURL=useCoupon.js.map

package/dist/hooks/useCoupon.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useCoupon.js"}

package/dist/hooks/useDate.d.ts

@@ -0,0 +1,24 @@
+type DateFormat = 'full' | 'long' | 'medium' | 'short' | 'time';
+export type DateInput = string | number | Date | {
+    date: string;
+    timezone_type: number;
+    timezone: string;
+} | undefined;
+export interface UseDateResult {
+    format: (date: DateInput, formatType?: DateFormat) => string;
+    ago: (date: DateInput) => string;
+    now: Date;
+}
+/**
+ * useDate - Hook for formatting dates
+ *
+ * @example
+ * const { format, ago, now } = useDate();
+ * format('2024-03-15')              // 'March 15, 2024'
+ * format('2024-03-15', 'full')      // 'Friday, March 15, 2024'
+ * ago(Date.now() - 3600000)         // '1 hour ago'
+ * now                               // current Date object
+ */
+export declare function useDate(): UseDateResult;
+export {};
+//# sourceMappingURL=useDate.d.ts.map

package/dist/hooks/useDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDate.d.ts","sourceRoot":"","sources":["../../src/hooks/useDate.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhE,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,IAAI,GACJ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzD,SAAS,CAAC;AAUd,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC;IAC7D,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC;IACjC,GAAG,EAAE,IAAI,CAAC;CACX;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,IAAI,aAAa,CAsDvC"}

package/dist/hooks/useDocumentClass.d.ts

@@ -0,0 +1,42 @@
+import { type DocumentElementDescriptor } from '../utils/document-class';
+/**
+ * useDocumentClass - Hook for managing HTML and body element attributes
+ *
+ * Registers attributes for the `<html>` and `<body>` elements that are
+ * automatically applied on mount and cleaned up on unmount. Supports
+ * both SSR (via DocumentClassProvider) and client-side-only environments.
+ *
+ * @param descriptor - Object with html and/or body properties containing
+ *        attribute objects (class names, data attributes, etc.)
+ *
+ * @example Static per-route attrs
+ * ```tsx
+ * function ProductPage() {
+ *   useDocumentClass({
+ *     body: { class: 'page-product', 'data-page': 'product' },
+ *     html: { 'data-layout': 'detail' },
+ *   });
+ *   return <div>...</div>;
+ * }
+ * ```
+ *
+ * @example Dynamic attrs
+ * ```tsx
+ * function Layout({ isRtl }) {
+ *   useDocumentClass({
+ *     html: { dir: isRtl ? 'rtl' : 'ltr', lang: isRtl ? 'ar' : 'en' },
+ *   });
+ *   return <Outlet />;
+ * }
+ * ```
+ *
+ * @example Multiple classes + data attributes
+ * ```tsx
+ * useDocumentClass({
+ *   body: { class: ['page-blog', 'has-sidebar'], 'data-theme': 'light' },
+ *   html: { class: 'blog-layout', lang: 'en' },
+ * });
+ * ```
+ */
+export declare function useDocumentClass(descriptor: DocumentElementDescriptor): void;
+//# sourceMappingURL=useDocumentClass.d.ts.map

package/dist/hooks/useDocumentClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentClass.d.ts","sourceRoot":"","sources":["../../src/hooks/useDocumentClass.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,CAwC5E"}

package/dist/hooks/useDocumentClass.js

@@ -0,0 +1,5 @@
+export { useDocumentClass } from '../chunk-GN34LCTG.js';
+import '../chunk-CW625T2E.js';
+import '../chunk-DGUM43GV.js';
+//# sourceMappingURL=useDocumentClass.js.map
+//# sourceMappingURL=useDocumentClass.js.map

package/dist/hooks/useDocumentClass.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useDocumentClass.js"}

package/dist/hooks/useGtm.d.ts

@@ -0,0 +1,38 @@
+import type { Product, Cart, CartItem } from '../types';
+export interface UseGtmResult {
+    /** Check if GTM is enabled */
+    enabled: boolean;
+    /** Raw push to dataLayer */
+    push: (data: Record<string, unknown>) => void;
+    /** Track page view */
+    viewPage: (pageType: string) => void;
+    /** Track product detail view */
+    detail: (product: Product) => void;
+    /** Track product impressions (listing) */
+    impressions: (products: Product[], list?: string) => void;
+    /** Track product click */
+    click: (product: Product, list?: string, position?: number) => void;
+    /** Track add to cart */
+    add: (product: Product, quantity?: number) => void;
+    /** Track remove from cart */
+    remove: (item: CartItem) => void;
+    /** Track checkout */
+    checkout: (cart: Cart, step?: number) => void;
+    /** Track purchase */
+    purchase: (orderId: string | number, cart: Cart) => void;
+}
+/**
+ * useGtm - Google Tag Manager hook for tracking events
+ *
+ * @example
+ * ```tsx
+ * function ProductPage({ product }) {
+ *   const gtm = useGtm();
+ *
+ *   useEffect(() => { gtm.detail(product); }, [product.id]);
+ *   return <button onClick={() => gtm.add(product)}>Add to Cart</button>;
+ * }
+ * ```
+ */
+export declare function useGtm(): UseGtmResult;
+//# sourceMappingURL=useGtm.d.ts.map

package/dist/hooks/useGtm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGtm.d.ts","sourceRoot":"","sources":["../../src/hooks/useGtm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAQxD,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC9C,sBAAsB;IACtB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,gCAAgC;IAChC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,0CAA0C;IAC1C,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,0BAA0B;IAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,wBAAwB;IACxB,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,6BAA6B;IAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACjC,qBAAqB;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,qBAAqB;IACrB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CAC1D;AAiCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,IAAI,YAAY,CAoJrC"}

package/dist/hooks/useHook.d.ts

@@ -0,0 +1,24 @@
+import type { HookHandler } from '../types';
+/**
+ * useHook - Registers a hook handler in the hook registry
+ *
+ * A React hook that registers a handler function with the global hook registry.
+ * The handler will be invoked when a corresponding `HookSlot` component is
+ * rendered with the matching hook name. Handlers are automatically cleaned up
+ * when the component unmounts.
+ *
+ * @param name - The hook name to register under
+ * @param handler - The hook handler function that receives context and returns JSX
+ * @param priority - Execution priority (higher runs first). Default: 50
+ *
+ * @example
+ * ```tsx
+ * function Header Logo() {
+ *   useHook('header.before', () => <Logo />);
+ *
+ *   return <header><HookSlot name="header.before" /></header>;
+ * }
+ * ```
+ */
+export declare function useHook<T = Record<string, unknown>>(name: string, handler: HookHandler<T>, priority?: number): void;
+//# sourceMappingURL=useHook.d.ts.map

package/dist/hooks/useHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHook.d.ts","sourceRoot":"","sources":["../../src/hooks/useHook.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,QAAQ,SAAK,GACZ,IAAI,CAYN"}

package/dist/hooks/useHook.js

@@ -0,0 +1,5 @@
+export { useHook } from '../chunk-2FU6CVSB.js';
+import '../chunk-J37AYLWL.js';
+import '../chunk-DGUM43GV.js';
+//# sourceMappingURL=useHook.js.map
+//# sourceMappingURL=useHook.js.map

package/dist/hooks/useHook.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useHook.js"}

package/dist/hooks/useIsClient.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns true only after the component mounts on the client.
+ * Useful for avoiding hydration mismatches with browser-only APIs
+ * or web components that inject DOM content before React hydrates.
+ */
+export declare function useIsClient(): boolean;
+//# sourceMappingURL=useIsClient.d.ts.map

package/dist/hooks/useIsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useIsClient.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAIrC"}

package/dist/hooks/useMoney.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+/**
+ * UseMoneyResult - Return type for useMoney hook
+ */
+export interface UseMoneyResult {
+    /** Format amount with currency */
+    format: (amount: number | string | undefined, options?: {
+        currency?: string;
+        locale?: string;
+        type?: 'product' | 'general';
+    }) => React.ReactNode;
+    /** Parse money string to number */
+    parse: (moneyString: string) => number;
+    /** Check if value is valid monetary amount */
+    isValid: (value: unknown) => boolean;
+}
+/**
+ * useMoney - Hook for formatting monetary values
+ *
+ * @example
+ * const { format, parse, isValid } = useMoney();
+ * // Render price (SAR shows with icon):
+ * <span>{format(100)}</span>  // '100.00' with <i className="sicon-sar" />
+ */
+export declare function useMoney(): UseMoneyResult;
+//# sourceMappingURL=useMoney.d.ts.map

package/dist/hooks/useMoney.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMoney.d.ts","sourceRoot":"","sources":["../../src/hooks/useMoney.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,MAAM,EAAE,CACN,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACnC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;KAAE,KAC3E,KAAK,CAAC,SAAS,CAAC;IACrB,mCAAmC;IACnC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,8CAA8C;IAC9C,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAsFzC"}

package/dist/hooks/useMoney.js

@@ -0,0 +1,39 @@
+export { useMoney } from '../chunk-GLM3RPCP.js';
+import '../chunk-QTDGM2SO.js';
+import '../chunk-5Q6PFLDN.js';
+import '../chunk-GO34DE35.js';
+import '../chunk-VVZNW5CB.js';
+import '../chunk-LBUMC5PB.js';
+import '../chunk-MTONGOJD.js';
+import '../chunk-2FU6CVSB.js';
+import '../chunk-I5Z4NJBB.js';
+import '../chunk-TCSNNCRH.js';
+import '../chunk-2TB2LTL2.js';
+import '../chunk-QYL5OHAV.js';
+import '../chunk-KIPZQN3Y.js';
+import '../chunk-Z653O7MX.js';
+import '../chunk-ZCH7W7DZ.js';
+import '../chunk-SSRNIBVV.js';
+import '../chunk-GN34LCTG.js';
+import '../chunk-CW625T2E.js';
+import '../chunk-BVSJPBJ6.js';
+import '../chunk-GBWCXUPD.js';
+import '../chunk-UIX3W2PN.js';
+import '../chunk-VVRYP6IL.js';
+import '../chunk-T72DAX7R.js';
+import '../chunk-YMVLYYLU.js';
+import '../chunk-RYBA3JDM.js';
+import '../chunk-25SSLQAJ.js';
+import '../chunk-J37AYLWL.js';
+import '../chunk-2KF5JJU6.js';
+import '../chunk-TZ4YD5CU.js';
+import '../chunk-XUI3TRXF.js';
+import '../chunk-6BZ5TKEV.js';
+import '../chunk-UE3BUFZI.js';
+import '../chunk-3DCZJDDK.js';
+import '../chunk-3UHSMGPY.js';
+import '../chunk-MXQCE3KA.js';
+import '../chunk-BWFBVXT3.js';
+import '../chunk-DGUM43GV.js';
+//# sourceMappingURL=useMoney.js.map
+//# sourceMappingURL=useMoney.js.map

package/dist/hooks/useMoney.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useMoney.js"}

package/dist/hooks/useNumber.d.ts

@@ -0,0 +1,24 @@
+/**
+ * UseNumberResult - Return type for useNumber hook
+ */
+export interface UseNumberResult {
+    /** Format number with store settings */
+    format: (number: number | string) => string;
+    /** Convert to Arabic numerals */
+    toArabic: (input: number | string) => string;
+    /** Whether Arabic numerals are enabled */
+    useArabicNumerals: boolean;
+}
+/**
+ * useNumber - Hook for number formatting
+ *
+ * @returns Object with number formatting utilities
+ *
+ * @example
+ * const { format, toArabic, useArabicNumerals } = useNumber();
+ * format(1234)              // '١٢٣٤' if arabic numbers enabled, else '1234'
+ * toArabic(1234)            // '١٢٣٤'
+ * useArabicNumerals         // boolean from store settings
+ */
+export declare function useNumber(): UseNumberResult;
+//# sourceMappingURL=useNumber.d.ts.map

package/dist/hooks/useNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNumber.d.ts","sourceRoot":"","sources":["../../src/hooks/useNumber.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAC5C,iCAAiC;IACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAC7C,0CAA0C;IAC1C,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAqB3C"}

package/dist/hooks/useOpeningHours.d.ts

@@ -0,0 +1,28 @@
+import type { OpeningHoursSettings } from '../types';
+export interface UseOpeningHoursResult {
+    /** Whether the store is currently open */
+    isOpen: boolean;
+    /** Whether opening hours feature is enabled and configured */
+    isEnabled: boolean;
+    /** Next opening time as Date object, null if currently open or not configured */
+    nextOpen: Date | null;
+    /** Formatted next opening time string, empty if currently open or not configured */
+    nextOpenFormatted: string;
+}
+/**
+ * useOpeningHours - Hook for checking store opening status and next open time.
+ *
+ * @param settings - Opening hours settings from the store
+ * @returns Opening status information
+ *
+ * @example
+ * ```tsx
+ * const { isOpen, nextOpenFormatted } = useOpeningHours(store.settings.opening_hours);
+ *
+ * if (!isOpen) {
+ *   return <div>Store closed. Opens at {nextOpenFormatted}</div>;
+ * }
+ * ```
+ */
+export declare function useOpeningHours(settings?: OpeningHoursSettings): UseOpeningHoursResult;
+//# sourceMappingURL=useOpeningHours.d.ts.map

package/dist/hooks/useOpeningHours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOpeningHours.d.ts","sourceRoot":"","sources":["../../src/hooks/useOpeningHours.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAsCrD,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,oFAAoF;IACpF,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAiFD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,qBAAqB,CAoFtF"}

package/dist/hooks/usePageConfig.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Page config data structure for salla.config.set('page', ...)
+ */
+export interface PageConfigData {
+    slug: string;
+    id?: string | number;
+    title: string;
+    /** Optional - defaults to current location pathname + search */
+    url?: string;
+    parent?: {
+        id: string | number;
+        name: string;
+        url: string;
+    } | null;
+}
+/**
+ * usePageConfig - Centralized hook for setting salla.config.page
+ *
+ * Replaces scattered salla?.config?.set('page', ...) calls across multiple pages.
+ * Handles optional salla object safely.
+ * Automatically uses current URL from router context if url not provided.
+ *
+ * @param pageData - Page configuration data to set
+ *
+ * @example
+ * ```tsx
+ * // URL is auto-detected from router context
+ * usePageConfig({
+ *   slug: 'product.index',
+ *   id: categoryId,
+ *   title: category.name,
+ * });
+ *
+ * // With explicit URL override
+ * usePageConfig({
+ *   slug: 'product.index',
+ *   id: categoryId,
+ *   title: category.name,
+ *   url: '/custom-url',
+ * });
+ * ```
+ */
+export declare function usePageConfig(pageData: PageConfigData): void;
+//# sourceMappingURL=usePageConfig.d.ts.map

package/dist/hooks/usePageConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageConfig.d.ts","sourceRoot":"","sources":["../../src/hooks/usePageConfig.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAqB5D"}

package/dist/hooks/useProduct.d.ts

@@ -0,0 +1,47 @@
+import type { Product } from '../types';
+/**
+ * UseProductResult - Return type for useProduct hook
+ */
+export interface UseProductResult {
+    /** Current product state (updates on option changes) */
+    product: Product;
+    /** Reload product data from API */
+    reload: () => Promise<void>;
+}
+/**
+ * useProduct - Hook for managing product state with live updates
+ *
+ * Provides reactive product data with automatic updates for price, stock,
+ * and variant changes. Handles manual reloads (e.g., after add-to-cart)
+ * and subscribes to Salla SDK events for real-time price updates.
+ *
+ * Stock status is reflected in `product.is_out_of_stock` which updates
+ * when price calculations succeed or fail (e.g., unavailable option combinations).
+ *
+ * @param initialProduct - The initial product object (typically from loader/SSR)
+ *
+ * @returns Object with product and reload function
+ *
+ * @example
+ * ```tsx
+ * function ProductDetails({ product }) {
+ *   const { product: updatedProduct, reload } = useProduct(product);
+ *
+ *   const handleAddToCart = async () => {
+ *     await addToCart(updatedProduct.id);
+ *     await reload(); // Refresh product state after cart update
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <h1>{updatedProduct.name}</h1>
+ *       <p>Price: {formatMoney(updatedProduct.price)}</p>
+ *       {updatedProduct.is_out_of_stock && <p>Currently out of stock</p>}
+ *       <button onClick={handleAddToCart}>Add to Cart</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useProduct(initialProduct: Product): UseProductResult;
+//# sourceMappingURL=useProduct.d.ts.map

package/dist/hooks/useProduct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProduct.d.ts","sourceRoot":"","sources":["../../src/hooks/useProduct.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,UAAU,CAAC,cAAc,EAAE,OAAO,GAAG,gBAAgB,CAyFpE"}

package/dist/hooks/useProduct.js

@@ -0,0 +1,4 @@
+export { useProduct } from '../chunk-SSRNIBVV.js';
+import '../chunk-DGUM43GV.js';
+//# sourceMappingURL=useProduct.js.map
+//# sourceMappingURL=useProduct.js.map

package/dist/hooks/useProduct.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useProduct.js"}

package/dist/hooks/useStore.d.ts

@@ -0,0 +1,36 @@
+import type { Store } from '../types';
+/**
+ * UseStoreResult - Return type for useStore hook
+ *
+ * Extends the Store interface with a refresh method to re-fetch
+ * the latest store configuration from the Salla SDK.
+ */
+export interface UseStoreResult extends Store {
+    refresh: () => Promise<void>;
+}
+/**
+ * useStore - Hook for accessing and managing store state
+ *
+ * Provides access to the store configuration and metadata from the
+ * Twilight provider. Includes a refresh method to update the store
+ * state with the latest data from the Salla SDK.
+ *
+ * @returns Store object with refresh() method to reload store data
+ *
+ * @example
+ * ```tsx
+ * function StoreInfo() {
+ *   const { name, currency, refresh } = useStore();
+ *
+ *   return (
+ *     <div>
+ *       <h1>{name}</h1>
+ *       <button onClick={refresh}>Refresh store data</button>
+ *       <p>Current currency: {currency}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useStore(): UseStoreResult;
+//# sourceMappingURL=useStore.d.ts.map

package/dist/hooks/useStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStore.d.ts","sourceRoot":"","sources":["../../src/hooks/useStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK;IAC3C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAgBzC"}

package/dist/hooks/useStore.js

@@ -0,0 +1,39 @@
+export { useStore } from '../chunk-GLM3RPCP.js';
+import '../chunk-QTDGM2SO.js';
+import '../chunk-5Q6PFLDN.js';
+import '../chunk-GO34DE35.js';
+import '../chunk-VVZNW5CB.js';
+import '../chunk-LBUMC5PB.js';
+import '../chunk-MTONGOJD.js';
+import '../chunk-2FU6CVSB.js';
+import '../chunk-I5Z4NJBB.js';
+import '../chunk-TCSNNCRH.js';
+import '../chunk-2TB2LTL2.js';
+import '../chunk-QYL5OHAV.js';
+import '../chunk-KIPZQN3Y.js';
+import '../chunk-Z653O7MX.js';
+import '../chunk-ZCH7W7DZ.js';
+import '../chunk-SSRNIBVV.js';
+import '../chunk-GN34LCTG.js';
+import '../chunk-CW625T2E.js';
+import '../chunk-BVSJPBJ6.js';
+import '../chunk-GBWCXUPD.js';
+import '../chunk-UIX3W2PN.js';
+import '../chunk-VVRYP6IL.js';
+import '../chunk-T72DAX7R.js';
+import '../chunk-YMVLYYLU.js';
+import '../chunk-RYBA3JDM.js';
+import '../chunk-25SSLQAJ.js';
+import '../chunk-J37AYLWL.js';
+import '../chunk-2KF5JJU6.js';
+import '../chunk-TZ4YD5CU.js';
+import '../chunk-XUI3TRXF.js';
+import '../chunk-6BZ5TKEV.js';
+import '../chunk-UE3BUFZI.js';
+import '../chunk-3DCZJDDK.js';
+import '../chunk-3UHSMGPY.js';
+import '../chunk-MXQCE3KA.js';
+import '../chunk-BWFBVXT3.js';
+import '../chunk-DGUM43GV.js';
+//# sourceMappingURL=useStore.js.map
+//# sourceMappingURL=useStore.js.map

package/dist/hooks/useStore.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useStore.js"}

package/dist/hooks/useTheme.d.ts

@@ -0,0 +1,41 @@
+import type { ThemeColor, ThemeFont, ThemeSettings } from '../types';
+/**
+ * UseThemeResult - Return type for useTheme hook
+ *
+ * @property color - Theme color configuration (primary, reverse_text, etc.)
+ * @property font - Theme font configuration (family and weights)
+ * @property settings - Theme settings (checkout options, RTL, etc.)
+ * @property isRTL - Boolean indicating if the current theme uses RTL layout
+ */
+export interface UseThemeResult {
+    color: ThemeColor;
+    font: ThemeFont | undefined;
+    settings: ThemeSettings;
+    isRTL: boolean;
+}
+/**
+ * useTheme - Hook for accessing theme configuration
+ *
+ * Provides access to the current theme's colors, fonts, settings,
+ * and RTL direction. This hook is SSR-safe and works with the
+ * TwilightProvider to deliver theme data to components.
+ *
+ * @returns Theme configuration object
+ *
+ * @example
+ * ```tsx
+ * function ThemedButton() {
+ *   const { color, isRTL } = useTheme();
+ *
+ *   const styles = {
+ *     backgroundColor: color.primary,
+ *     color: color.reverse_text || '#fff',
+ *     direction: isRTL ? 'rtl' : 'ltr',
+ *   };
+ *
+ *   return <button style={styles}>Click me</button>;
+ * }
+ * ```
+ */
+export declare function useTheme(): UseThemeResult;
+//# sourceMappingURL=useTheme.d.ts.map

package/dist/hooks/useTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useTheme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CASzC"}

package/dist/hooks/useTheme.js

@@ -0,0 +1,5 @@
+export { useTheme } from '../chunk-UE3BUFZI.js';
+import '../chunk-BWFBVXT3.js';
+import '../chunk-DGUM43GV.js';
+//# sourceMappingURL=useTheme.js.map
+//# sourceMappingURL=useTheme.js.map

package/dist/hooks/useTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useTheme.js"}