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

package/dist/hooks/useUser.d.ts

@@ -0,0 +1,8 @@
+import { type UseQueryResult } from '@tanstack/react-query';
+import type { User } from '../types';
+export type UseUserReturn = UseQueryResult<User | null> & {
+    /** True when an auth token exists (regardless of query state). */
+    isLoggedIn: boolean;
+};
+export declare function useUser(): UseUserReturn;
+//# sourceMappingURL=useUser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUser.d.ts","sourceRoot":"","sources":["../../src/hooks/useUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG;IACxD,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAgB,OAAO,IAAI,aAAa,CAUvC"}

package/dist/hooks/useUser.js

@@ -0,0 +1,9 @@
+export { useUser } from '../chunk-I5Z4NJBB.js';
+import '../chunk-TCSNNCRH.js';
+import '../chunk-2TB2LTL2.js';
+import '../chunk-QYL5OHAV.js';
+import '../chunk-KIPZQN3Y.js';
+import '../chunk-T72DAX7R.js';
+import '../chunk-DGUM43GV.js';
+//# sourceMappingURL=useUser.js.map
+//# sourceMappingURL=useUser.js.map

package/dist/hooks/useUser.js.map

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

package/dist/hooks/useWishlist.d.ts

@@ -0,0 +1,5 @@
+import type { UseToggleWithItems } from './types';
+export type UseWishlistResult = UseToggleWithItems<number>;
+export declare function useWishlist(): UseWishlistResult;
+export declare function resetWishlistStore(): void;
+//# sourceMappingURL=useWishlist.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useWishlist.d.ts","sourceRoot":"","sources":["../../src/hooks/useWishlist.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAiG3D,wBAAgB,WAAW,IAAI,iBAAiB,CA6C/C;AAED,wBAAgB,kBAAkB,SAIjC"}

package/dist/hooks/useWishlist.js

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

package/dist/hooks/useWishlist.js.map

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

package/dist/i18n.d.ts

@@ -0,0 +1 @@
+export * from './providers/i18n';

package/dist/i18n.js

@@ -0,0 +1,5 @@
+export { I18nProvider, useTranslation } from './chunk-VVRYP6IL.js';
+export { FALLBACK_DIR, FALLBACK_LANGUAGE_NAME, FALLBACK_LOCALE, RTL_LOCALES, SUPPORTED_LOCALES, getLanguageInfo, isLocale } from './chunk-T72DAX7R.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=i18n.js.map
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { TwilightProvider, useTwilight, type TwilightProviderProps, } from './providers/TwilightProvider';
+export { SettingsError } from './utils/errors';
+export type { TwilightConfig, TwilightContextValue } from './providers/twilight.types';
+export { RouteId, type RouteIdType } from './router/route-ids';
+export { useRouteId, useIsHome, useIsProduct, useIsCart, useIsCustomer, useIsBlog, useIsBrands, useIsSearch, } from './providers/NavigationProvider';
+export { ComponentRegistry, registry } from './components/ComponentRegistry';
+export { Component, type ComponentProps } from './components/Component';
+export { useComponent, useOriginalComponent } from './components/useComponent';
+export { defineComponent, registerComponents, overrideComponents, } from './components/defineComponent';
+export { HookName, type HookHandler, type HookDefinition, type HookHandlers } from './types/hooks';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,KAAK,qBAAqB,GAC3B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGvF,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,aAAa,EACb,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,83 @@
+import { registry } from './chunk-G7ALL4BC.js';
+export { ComponentRegistry, registry } from './chunk-G7ALL4BC.js';
+export { TwilightProvider } from './chunk-GLM3RPCP.js';
+import './chunk-QTDGM2SO.js';
+import './chunk-5Q6PFLDN.js';
+export { useIsBlog, useIsBrands, useIsCart, useIsCustomer, useIsHome, useIsProduct, useIsSearch, useRouteId } from './chunk-GO34DE35.js';
+import './chunk-VVZNW5CB.js';
+export { HookName } from './chunk-LBUMC5PB.js';
+export { RouteId } from './chunk-MTONGOJD.js';
+import './chunk-2FU6CVSB.js';
+import './chunk-I5Z4NJBB.js';
+import './chunk-TCSNNCRH.js';
+import './chunk-2TB2LTL2.js';
+import './chunk-QYL5OHAV.js';
+export { SettingsError } from './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';
+export { useTwilight } from './chunk-BWFBVXT3.js';
+import './chunk-DGUM43GV.js';
+import { jsx } from 'react/jsx-runtime';
+
+function Component({ name, fallback = null, ...props }) {
+  const ResolvedComponent = registry.resolve(name);
+  if (!ResolvedComponent) {
+    if (process.env.NODE_ENV === "development") {
+      window.salla?.logger?.warn(`Component::"${name}" not found in registry`);
+    }
+    return fallback;
+  }
+  return /* @__PURE__ */ jsx(ResolvedComponent, { ...props });
+}
+
+// src/components/useComponent.ts
+function useComponent(name) {
+  return registry.resolve(name);
+}
+function useOriginalComponent(name) {
+  return registry.getOriginal(name);
+}
+
+// src/components/defineComponent.ts
+function defineComponent(config) {
+  if (config.override) {
+    registry.override(config.name, config.component);
+  } else {
+    registry.register(config.name, config.component);
+  }
+  return config.component;
+}
+function registerComponents(components) {
+  for (const [name, component] of Object.entries(components)) {
+    registry.register(name, component);
+  }
+}
+function overrideComponents(components) {
+  for (const [name, component] of Object.entries(components)) {
+    registry.override(name, component);
+  }
+}
+
+export { Component, defineComponent, overrideComponents, registerComponents, useComponent, useOriginalComponent };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/Component.tsx","../src/components/useComponent.ts","../src/components/defineComponent.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASO,SAAS,UAAU,EAAE,IAAA,EAAM,WAAW,IAAA,EAAM,GAAG,OAAM,EAAoC;AAC9F,EAAA,MAAM,iBAAA,GAAoB,QAAA,CAAS,OAAA,CAAQ,IAAI,CAAA;AAE/C,EAAA,IAAI,CAAC,iBAAA,EAAmB;AACtB,IAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,QAAA,KAAa,aAAA,EAAe;AAC1C,MAAA,MAAA,CAAO,KAAA,EAAO,MAAA,EAAQ,IAAA,CAAK,CAAA,YAAA,EAAe,IAAI,CAAA,uBAAA,CAAyB,CAAA;AAAA,IACzE;AACA,IAAA,OAAO,QAAA;AAAA,EACT;AAEA,EAAA,uBAAO,GAAA,CAAC,iBAAA,EAAA,EAAmB,GAAG,KAAA,EAAO,CAAA;AACvC;;;ACjBO,SAAS,aAA0C,IAAA,EAAuC;AAC/F,EAAA,OAAO,QAAA,CAAS,QAAW,IAAI,CAAA;AACjC;AAEO,SAAS,qBACd,IAAA,EACyB;AACzB,EAAA,OAAO,QAAA,CAAS,YAAe,IAAI,CAAA;AACrC;;;ACFO,SAAS,gBACd,MAAA,EACkB;AAClB,EAAA,IAAI,OAAO,QAAA,EAAU;AACnB,IAAA,QAAA,CAAS,QAAA,CAAS,MAAA,CAAO,IAAA,EAAM,MAAA,CAAO,SAAS,CAAA;AAAA,EACjD,CAAA,MAAO;AACL,IAAA,QAAA,CAAS,QAAA,CAAS,MAAA,CAAO,IAAA,EAAM,MAAA,CAAO,SAAS,CAAA;AAAA,EACjD;AAEA,EAAA,OAAO,MAAA,CAAO,SAAA;AAChB;AAEO,SAAS,mBAAmB,UAAA,EAAiD;AAClF,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,SAAS,KAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,EAAG;AAC1D,IAAA,QAAA,CAAS,QAAA,CAAS,MAAM,SAAS,CAAA;AAAA,EACnC;AACF;AAEO,SAAS,mBAAmB,UAAA,EAAiD;AAClF,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,SAAS,KAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,EAAG;AAC1D,IAAA,QAAA,CAAS,QAAA,CAAS,MAAM,SAAS,CAAA;AAAA,EACnC;AACF","file":"index.js","sourcesContent":["import React from 'react';\nimport { registry } from './ComponentRegistry';\n\nexport interface ComponentProps {\n  name: string;\n  fallback?: React.ReactNode;\n  [key: string]: unknown;\n}\n\nexport function Component({ name, fallback = null, ...props }: ComponentProps): React.ReactNode {\n  const ResolvedComponent = registry.resolve(name);\n\n  if (!ResolvedComponent) {\n    if (process.env.NODE_ENV === 'development') {\n      window.salla?.logger?.warn(`Component::\"${name}\" not found in registry`);\n    }\n    return fallback;\n  }\n\n  return <ResolvedComponent {...props} />;\n}\n","import { registry } from './ComponentRegistry';\nimport type { ComponentType } from '../types';\n\nexport function useComponent<P = Record<string, unknown>>(name: string): ComponentType<P> | null {\n  return registry.resolve<P>(name);\n}\n\nexport function useOriginalComponent<P = Record<string, unknown>>(\n  name: string\n): ComponentType<P> | null {\n  return registry.getOriginal<P>(name);\n}\n","import { registry } from './ComponentRegistry';\nimport type { ComponentType } from '../types';\n\ninterface DefineComponentConfig<P = Record<string, unknown>> {\n  name: string;\n  component: ComponentType<P>;\n  override?: boolean;\n}\n\nexport function defineComponent<P = Record<string, unknown>>(\n  config: DefineComponentConfig<P>\n): ComponentType<P> {\n  if (config.override) {\n    registry.override(config.name, config.component);\n  } else {\n    registry.register(config.name, config.component);\n  }\n\n  return config.component;\n}\n\nexport function registerComponents(components: Record<string, ComponentType>): void {\n  for (const [name, component] of Object.entries(components)) {\n    registry.register(name, component);\n  }\n}\n\nexport function overrideComponents(components: Record<string, ComponentType>): void {\n  for (const [name, component] of Object.entries(components)) {\n    registry.override(name, component);\n  }\n}\n"]}

package/dist/lib/analytics/gtm.d.ts

@@ -0,0 +1,38 @@
+import type { Cart, CartItem } from '../../types';
+export interface GtmCheckoutProduct {
+    id: number;
+    name: string;
+    price: number;
+    quantity: number;
+}
+export interface GtmCheckoutEvent {
+    event: 'checkout';
+    ecommerce: {
+        checkout: {
+            actionField: {
+                step: 1 | 2 | 3;
+            };
+            products: GtmCheckoutProduct[];
+            cart_total: number;
+            currency: string;
+        };
+    };
+}
+/**
+ * Maps `Cart.items` to the GTM product array format.
+ *
+ * Only available items are included — mirrors PHP `$cartService->getAvailableItems()`.
+ */
+export declare function mapCartItemsToProducts(items: CartItem[]): GtmCheckoutProduct[];
+/**
+ * Pushes a GTM `checkout` event to `window.dataLayer`.
+ *
+ * Safe to call in SSR environments — guards against `typeof window`.
+ * Initialises `window.dataLayer` if GTM hasn't done so yet.
+ *
+ * @param step        Checkout funnel step (1 = cart, 2 = shipping, 3 = payment)
+ * @param cart        Current cart data from the Twilight loader
+ * @param currencyCode ISO 4217 currency code, e.g. "SAR"
+ */
+export declare function pushCheckoutEvent(step: 1 | 2 | 3, cart: Cart, currencyCode: string): void;
+//# sourceMappingURL=gtm.d.ts.map

package/dist/lib/analytics/gtm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gtm.d.ts","sourceRoot":"","sources":["../../../src/lib/analytics/gtm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE;QACT,QAAQ,EAAE;YACR,WAAW,EAAE;gBAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;aAAE,CAAC;YACjC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;YAC/B,UAAU,EAAE,MAAM,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;CACH;AAcD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAS9E;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAkBzF"}

package/dist/lib/services/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/services/index.ts"],"names":[],"mappings":""}

package/dist/navigation-N4H65RUN.js

@@ -0,0 +1,17 @@
+import { NextJsLinkAdapter } from './chunk-SVZOWI7E.js';
+import { NavigationProvider, defaultNavigate } from './chunk-GO34DE35.js';
+import './chunk-MTONGOJD.js';
+import './chunk-KIPZQN3Y.js';
+import './chunk-T72DAX7R.js';
+import { LinkProvider } from './chunk-XUI3TRXF.js';
+import './chunk-BWFBVXT3.js';
+import './chunk-DGUM43GV.js';
+import { jsx } from 'react/jsx-runtime';
+
+function NavigationSetup({ children }) {
+  return /* @__PURE__ */ jsx(NavigationProvider, { navigate: defaultNavigate, children: /* @__PURE__ */ jsx(LinkProvider, { adapter: NextJsLinkAdapter, children }) });
+}
+
+export { NavigationSetup };
+//# sourceMappingURL=navigation-N4H65RUN.js.map
+//# sourceMappingURL=navigation-N4H65RUN.js.map

package/dist/navigation-N4H65RUN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nextjs/navigation.tsx"],"names":[],"mappings":";;;;;;;;;;AASO,SAAS,eAAA,CAAgB,EAAE,QAAA,EAAS,EAA4B;AACrE,EAAA,uBACE,GAAA,CAAC,sBAAmB,QAAA,EAAU,eAAA,EAC5B,8BAAC,YAAA,EAAA,EAAa,OAAA,EAAS,iBAAA,EAAoB,QAAA,EAAS,CAAA,EACtD,CAAA;AAEJ","file":"navigation-N4H65RUN.js","sourcesContent":["import { NavigationProvider, defaultNavigate } from '../providers/NavigationProvider';\nimport { LinkProvider } from '../providers/LinkProvider';\nimport { NextJsLinkAdapter } from './link';\nimport type { ReactNode } from 'react';\n\n/**\n * Next.js navigation setup - wraps children with NavigationProvider and LinkProvider.\n * Called by TwilightProvider when client.framework === 'nextjs'.\n */\nexport function NavigationSetup({ children }: { children: ReactNode }) {\n  return (\n    <NavigationProvider navigate={defaultNavigate}>\n      <LinkProvider adapter={NextJsLinkAdapter}>{children}</LinkProvider>\n    </NavigationProvider>\n  );\n}\n"]}

package/dist/navigation-YCYHW4MK.js

@@ -0,0 +1,10 @@
+export { NavigationSetup, TanStackNavigationProvider } from './chunk-EQ5ZGAVR.js';
+import './chunk-GO34DE35.js';
+import './chunk-MTONGOJD.js';
+import './chunk-KIPZQN3Y.js';
+import './chunk-T72DAX7R.js';
+import './chunk-XUI3TRXF.js';
+import './chunk-BWFBVXT3.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=navigation-YCYHW4MK.js.map
+//# sourceMappingURL=navigation-YCYHW4MK.js.map

package/dist/navigation-YCYHW4MK.js.map

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

package/dist/nextjs/document-class.d.ts

@@ -0,0 +1,92 @@
+import { type DocumentElementDescriptor } from '../utils/document-class';
+/**
+ * Next.js App Router document element adapter.
+ *
+ * ## Usage in `layout.tsx`
+ *
+ * Next.js App Router renders `<html>` and `<body>` in the root layout as a
+ * **Server Component** — hooks are not available at that level.
+ * Compute the descriptor server-side (from route params, cookies, etc.) and
+ * pass it to this adapter.
+ *
+ * ```tsx
+ * // app/layout.tsx
+ * import { attrs } from '@salla.sa/twilight-theme-engine/nextjs';
+ *
+ * export default async function RootLayout({ params, children }) {
+ *   const { lang } = await params;
+ *   const isRtl = lang === 'ar';
+ *
+ *   const { bodyAttrs, htmlAttrs } = attrs({
+ *     html: { lang, dir: isRtl ? 'rtl' : 'ltr', class: 'antialiased' },
+ *     body: { class: 'font-sans', 'data-theme': 'default' },
+ *   });
+ *
+ *   return (
+ *     <html {...htmlAttrs}>
+ *       <body {...bodyAttrs}>{children}</body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ *
+ * ## Per-page dynamic attrs (Client Components)
+ *
+ * For page-specific attributes that depend on loader data or state, use
+ * `DocumentClassProvider` + `useDocumentClass` in Client Components:
+ *
+ * ```tsx
+ * // app/layout.tsx
+ * import { DocumentClassProvider } from '@salla.sa/twilight-theme-engine';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <DocumentClassProvider>{children}</DocumentClassProvider>
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ *
+ * ```tsx
+ * // app/product/[slug]/page.tsx
+ * 'use client';
+ * import { useDocumentClass } from '@salla.sa/twilight-theme-engine';
+ *
+ * export default function ProductPage() {
+ *   useDocumentClass({ body: { class: 'page-product', 'data-page': 'product' } });
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export declare function nextjsDocumentAdapter(descriptor: DocumentElementDescriptor): {
+    /** React props for the `<body>` element (`class` → `className`). */
+    bodyAttrs: Record<string, string>;
+    /** React props for the `<html>` element (`class` → `className`). */
+    htmlAttrs: Record<string, string>;
+};
+/**
+ * Merge multiple `DocumentElementDescriptor`s into a single Next.js-ready output.
+ *
+ * Merge rules:
+ * - `class` → union across all descriptors (deduplicated)
+ * - all other attrs → last descriptor wins
+ *
+ * @example
+ * ```tsx
+ * import { mergeAttrs } from '@salla.sa/twilight-theme-engine/nextjs';
+ *
+ * const { bodyAttrs, htmlAttrs } = mergeAttrs(
+ *   { html: { class: 'antialiased' } },
+ *   { html: { dir: isRtl ? 'rtl' : 'ltr', lang }, body: { class: 'font-sans' } },
+ *   routeDescriptor,
+ * );
+ * ```
+ */
+export declare function mergeNextjsDocumentAttrs(...descriptors: DocumentElementDescriptor[]): {
+    bodyAttrs: Record<string, string>;
+    htmlAttrs: Record<string, string>;
+};
+//# sourceMappingURL=document-class.d.ts.map

package/dist/nextjs/document-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-class.d.ts","sourceRoot":"","sources":["../../src/nextjs/document-class.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,yBAAyB,GAAG;IAC5E,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAKA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,WAAW,EAAE,yBAAyB,EAAE,GAAG;IACrF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAKA"}

package/dist/nextjs/head.d.ts

@@ -0,0 +1,36 @@
+import type { HeadDescriptor } from '../utils/head';
+export declare function nextjsHeadAdapter(descriptor: HeadDescriptor): {
+    alternates: {
+        canonical: string | undefined;
+        languages: Record<string, string> | undefined;
+    };
+    twitter?: {
+        card: any;
+        title: string | undefined;
+        description: string | undefined;
+        images: string[] | undefined;
+        site: string | undefined;
+        creator: string | undefined;
+    } | undefined;
+    openGraph?: {
+        siteName: string | undefined;
+        type: any;
+        title: string | undefined;
+        description: string | undefined;
+        url: string | undefined;
+        locale: string | undefined;
+        images: {
+            url: string;
+            width?: number;
+            height?: number;
+            alt?: string;
+        }[] | undefined;
+        publishedTime: string | undefined;
+        modifiedTime: string | undefined;
+    } | undefined;
+    title: string | undefined;
+    description: string | undefined;
+    keywords: string | string[] | undefined;
+    robots: string | undefined;
+};
+//# sourceMappingURL=head.d.ts.map

package/dist/nextjs/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../src/nextjs/head.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,eAAe,CAAC;AAapE,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,cAAc;;;;;;cAwBR,GAAG;;;;;;;;;cAZ9B,GAAG;;;;;;iBArBZ,MAAM;oBAAU,MAAM;qBAAW,MAAM;kBAAQ,MAAM;;;;;;;;;EAmDpE"}

package/dist/nextjs/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Next.js adapter utilities.
+ *
+ * @example
+ * ```typescript
+ * import { head, attrs, mergeAttrs, createRouter } from '@salla.sa/twilight-theme-engine/nextjs';
+ *
+ * // In page.tsx - generate metadata
+ * export async function generateMetadata({ params }) {
+ *   const data = await Product.loader({ params: { id: params.id } });
+ *   return head(Product.head(data));
+ * }
+ *
+ * // In layout.tsx - body/html attributes
+ * const { bodyAttrs, htmlAttrs } = attrs({
+ *   html: { lang, dir: isRtl ? 'rtl' : 'ltr' },
+ *   body: { class: 'theme-my-store' },
+ * });
+ *
+ * // Merge multiple descriptors (e.g., layout + page)
+ * const merged = mergeAttrs(baseAttrs, pageAttrs);
+ * ```
+ */
+export { nextjsHeadAdapter as head } from './head';
+export { nextjsDocumentAdapter as attrs } from './document-class';
+export { mergeDocumentDescriptors as mergeAttrs } from '../utils/document-class';
+export { createRouter } from './router';
+export { NextJsLinkAdapter, createNextJsLinkAdapter } from './link';
+//# sourceMappingURL=index.d.ts.map

package/dist/nextjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nextjs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,iBAAiB,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AAGnD,OAAO,EAAE,qBAAqB,IAAI,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,EAAE,wBAAwB,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGjF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/nextjs/link.d.ts

@@ -0,0 +1,14 @@
+import type { BaseLinkProps } from '../components/common/Link.types';
+/**
+ * Next.js Link adapter.
+ * Translates framework-agnostic props to Next.js Link props.
+ *
+ * Note: This adapter expects Next.js Link to be available via dynamic import
+ * or provided by the consuming app.
+ */
+export declare const NextJsLinkAdapter: import("react").ForwardRefExoticComponent<Omit<BaseLinkProps, "ref"> & import("react").RefAttributes<HTMLAnchorElement>>;
+/**
+ * Create a Next.js Link adapter component.
+ */
+export declare function createNextJsLinkAdapter(): import("react").ForwardRefExoticComponent<Omit<BaseLinkProps, "ref"> & import("react").RefAttributes<HTMLAnchorElement>>;
+//# sourceMappingURL=link.d.ts.map

package/dist/nextjs/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/nextjs/link.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,0HA+C7B,CAAC;AAIF;;GAEG;AACH,wBAAgB,uBAAuB,6HAEtC"}

package/dist/nextjs/navigation.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from 'react';
+/**
+ * Next.js navigation setup - wraps children with NavigationProvider and LinkProvider.
+ * Called by TwilightProvider when client.framework === 'nextjs'.
+ */
+export declare function NavigationSetup({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/nextjs/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/nextjs/navigation.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAMpE"}

package/dist/nextjs/router.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Next.js Router setup for Twilight Theme
+ *
+ * This module will contain Next.js-specific router configuration
+ * when Next.js support is added to the Twilight theme engine.
+ *
+ * @todo Implement Next.js router setup
+ */
+/**
+ * Resolves a Next.js route ID to a semantic RouteId constant.
+ * Falls back to the original ID if no mapping exists.
+ */
+export declare function resolveNextjsRouteId(nextjsId: string): string;
+export declare function createRouter(): void;
+//# sourceMappingURL=router.d.ts.map

package/dist/nextjs/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/nextjs/router.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0BH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,YAAY,SAE3B"}

package/dist/nextjs.d.ts

@@ -0,0 +1 @@
+export * from './nextjs/index';

package/dist/nextjs.js

@@ -0,0 +1,22 @@
+export { NextJsLinkAdapter, createNextJsLinkAdapter } from './chunk-SVZOWI7E.js';
+export { nextjsHeadAdapter as head } from './chunk-HOSHJBPS.js';
+import { toReactProps, mergeElementAttrs } from './chunk-CW625T2E.js';
+export { mergeDocumentDescriptors as mergeAttrs } from './chunk-CW625T2E.js';
+import './chunk-DGUM43GV.js';
+
+// src/nextjs/document-class.ts
+function nextjsDocumentAdapter(descriptor) {
+  return {
+    bodyAttrs: toReactProps(mergeElementAttrs([descriptor.body ?? {}])),
+    htmlAttrs: toReactProps(mergeElementAttrs([descriptor.html ?? {}]))
+  };
+}
+
+// src/nextjs/router.tsx
+function createRouter() {
+  throw new Error("Next.js router is not yet implemented. Use TanStack Router for now.");
+}
+
+export { nextjsDocumentAdapter as attrs, createRouter };
+//# sourceMappingURL=nextjs.js.map
+//# sourceMappingURL=nextjs.js.map

package/dist/nextjs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nextjs/document-class.ts","../src/nextjs/router.tsx"],"names":[],"mappings":";;;;;;;AAoEO,SAAS,sBAAsB,UAAA,EAKpC;AACA,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,aAAa,iBAAA,CAAkB,CAAC,WAAW,IAAA,IAAQ,EAAE,CAAC,CAAC,CAAA;AAAA,IAClE,SAAA,EAAW,aAAa,iBAAA,CAAkB,CAAC,WAAW,IAAA,IAAQ,EAAE,CAAC,CAAC;AAAA,GACpE;AACF;;;ACrCO,SAAS,YAAA,GAAe;AAC7B,EAAA,MAAM,IAAI,MAAM,qEAAqE,CAAA;AACvF","file":"nextjs.js","sourcesContent":["import {\n  mergeElementAttrs,\n  toReactProps,\n  type DocumentElementDescriptor,\n} from '../utils/document-class';\n\n/**\n * Next.js App Router document element adapter.\n *\n * ## Usage in `layout.tsx`\n *\n * Next.js App Router renders `<html>` and `<body>` in the root layout as a\n * **Server Component** — hooks are not available at that level.\n * Compute the descriptor server-side (from route params, cookies, etc.) and\n * pass it to this adapter.\n *\n * ```tsx\n * // app/layout.tsx\n * import { attrs } from '@salla.sa/twilight-theme-engine/nextjs';\n *\n * export default async function RootLayout({ params, children }) {\n *   const { lang } = await params;\n *   const isRtl = lang === 'ar';\n *\n *   const { bodyAttrs, htmlAttrs } = attrs({\n *     html: { lang, dir: isRtl ? 'rtl' : 'ltr', class: 'antialiased' },\n *     body: { class: 'font-sans', 'data-theme': 'default' },\n *   });\n *\n *   return (\n *     <html {...htmlAttrs}>\n *       <body {...bodyAttrs}>{children}</body>\n *     </html>\n *   );\n * }\n * ```\n *\n * ## Per-page dynamic attrs (Client Components)\n *\n * For page-specific attributes that depend on loader data or state, use\n * `DocumentClassProvider` + `useDocumentClass` in Client Components:\n *\n * ```tsx\n * // app/layout.tsx\n * import { DocumentClassProvider } from '@salla.sa/twilight-theme-engine';\n *\n * export default function RootLayout({ children }) {\n *   return (\n *     <html>\n *       <body>\n *         <DocumentClassProvider>{children}</DocumentClassProvider>\n *       </body>\n *     </html>\n *   );\n * }\n * ```\n *\n * ```tsx\n * // app/product/[slug]/page.tsx\n * 'use client';\n * import { useDocumentClass } from '@salla.sa/twilight-theme-engine';\n *\n * export default function ProductPage() {\n *   useDocumentClass({ body: { class: 'page-product', 'data-page': 'product' } });\n *   return <div>...</div>;\n * }\n * ```\n */\nexport function nextjsDocumentAdapter(descriptor: DocumentElementDescriptor): {\n  /** React props for the `<body>` element (`class` → `className`). */\n  bodyAttrs: Record<string, string>;\n  /** React props for the `<html>` element (`class` → `className`). */\n  htmlAttrs: Record<string, string>;\n} {\n  return {\n    bodyAttrs: toReactProps(mergeElementAttrs([descriptor.body ?? {}])),\n    htmlAttrs: toReactProps(mergeElementAttrs([descriptor.html ?? {}])),\n  };\n}\n\n/**\n * Merge multiple `DocumentElementDescriptor`s into a single Next.js-ready output.\n *\n * Merge rules:\n * - `class` → union across all descriptors (deduplicated)\n * - all other attrs → last descriptor wins\n *\n * @example\n * ```tsx\n * import { mergeAttrs } from '@salla.sa/twilight-theme-engine/nextjs';\n *\n * const { bodyAttrs, htmlAttrs } = mergeAttrs(\n *   { html: { class: 'antialiased' } },\n *   { html: { dir: isRtl ? 'rtl' : 'ltr', lang }, body: { class: 'font-sans' } },\n *   routeDescriptor,\n * );\n * ```\n */\nexport function mergeNextjsDocumentAttrs(...descriptors: DocumentElementDescriptor[]): {\n  bodyAttrs: Record<string, string>;\n  htmlAttrs: Record<string, string>;\n} {\n  return {\n    bodyAttrs: toReactProps(mergeElementAttrs(descriptors.map((d) => d.body ?? {}))),\n    htmlAttrs: toReactProps(mergeElementAttrs(descriptors.map((d) => d.html ?? {}))),\n  };\n}\n","/**\n * Next.js Router setup for Twilight Theme\n *\n * This module will contain Next.js-specific router configuration\n * when Next.js support is added to the Twilight theme engine.\n *\n * @todo Implement Next.js router setup\n */\n\nimport type { RouteIdType } from '../router/route-ids';\n\n/**\n * Next.js Route ID Mapping (Placeholder)\n *\n * Maps Next.js route IDs to semantic RouteId constants.\n * This will be populated when Next.js support is implemented.\n *\n * Next.js uses file-based routing where IDs are typically the route path\n * without the locale prefix (e.g., '/cart', '/products/[id]').\n *\n * Example mapping:\n * {\n *   '/': RouteId.INDEX,\n *   '/cart': RouteId.CART,\n *   '/products/[id]': RouteId.PRODUCT_SINGLE,\n *   '/blog': RouteId.BLOG_INDEX,\n *   // etc.\n * }\n */\nconst NEXTJS_ROUTE_ID_MAP: Record<string, RouteIdType> = {\n  // TODO: Add Next.js route ID mappings when Next.js adapter is implemented\n};\n\n/**\n * Resolves a Next.js route ID to a semantic RouteId constant.\n * Falls back to the original ID if no mapping exists.\n */\nexport function resolveNextjsRouteId(nextjsId: string): string {\n  return NEXTJS_ROUTE_ID_MAP[nextjsId] ?? nextjsId;\n}\n\nexport function createRouter() {\n  throw new Error('Next.js router is not yet implemented. Use TanStack Router for now.');\n}\n"]}

package/dist/not-found-BJ3VK5VJ.js

@@ -0,0 +1,69 @@
+import './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 { useTranslation } from './chunk-VVRYP6IL.js';
+import './chunk-T72DAX7R.js';
+import './chunk-YMVLYYLU.js';
+import './chunk-RYBA3JDM.js';
+import { HookSlot } from './chunk-25SSLQAJ.js';
+import './chunk-J37AYLWL.js';
+import { LazyErrorPage } from './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';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+function NotFoundPage(props = {}) {
+  const { t } = useTranslation();
+  const {
+    title = t("common.errors.404") || "Page Not Found",
+    message = t("common.errors.error_occurred") || "The page you are looking for does not exist or has been moved.",
+    showHomeLink = true,
+    homeLinkText = t("common.elements.back_home") || "Back to Home",
+    LinkComponent
+  } = props;
+  return /* @__PURE__ */ jsxs(
+    LazyErrorPage,
+    {
+      code: 404,
+      title,
+      message,
+      showAction: showHomeLink,
+      actionText: homeLinkText,
+      LinkComponent,
+      children: [
+        /* @__PURE__ */ jsx(HookSlot, { name: "notfound:start" }),
+        /* @__PURE__ */ jsx(HookSlot, { name: "notfound:content" }),
+        /* @__PURE__ */ jsx(HookSlot, { name: "notfound:end" })
+      ]
+    }
+  );
+}
+
+export { NotFoundPage };
+//# sourceMappingURL=not-found-BJ3VK5VJ.js.map
+//# sourceMappingURL=not-found-BJ3VK5VJ.js.map

package/dist/not-found-BJ3VK5VJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/routes/not-found.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBO,SAAS,YAAA,CAAa,KAAA,GAA2B,EAAC,EAAG;AAC1D,EAAA,MAAM,EAAE,CAAA,EAAE,GAAI,cAAA,EAAe;AAE7B,EAAA,MAAM;AAAA,IACJ,KAAA,GAAQ,CAAA,CAAE,mBAAmB,CAAA,IAAK,gBAAA;AAAA,IAClC,OAAA,GAAU,CAAA,CAAE,8BAA8B,CAAA,IACxC,gEAAA;AAAA,IACF,YAAA,GAAe,IAAA;AAAA,IACf,YAAA,GAAe,CAAA,CAAE,2BAA2B,CAAA,IAAK,cAAA;AAAA,IACjD;AAAA,GACF,GAAI,KAAA;AAEJ,EAAA,uBACE,IAAA;AAAA,IAAC,aAAA;AAAA,IAAA;AAAA,MACC,IAAA,EAAM,GAAA;AAAA,MACN,KAAA;AAAA,MACA,OAAA;AAAA,MACA,UAAA,EAAY,YAAA;AAAA,MACZ,UAAA,EAAY,YAAA;AAAA,MACZ,aAAA;AAAA,MAEA,QAAA,EAAA;AAAA,wBAAA,GAAA,CAAC,QAAA,EAAA,EAAS,MAAK,gBAAA,EAAiB,CAAA;AAAA,wBAChC,GAAA,CAAC,QAAA,EAAA,EAAS,IAAA,EAAK,kBAAA,EAAmB,CAAA;AAAA,wBAClC,GAAA,CAAC,QAAA,EAAA,EAAS,IAAA,EAAK,cAAA,EAAe;AAAA;AAAA;AAAA,GAChC;AAEJ","file":"not-found-BJ3VK5VJ.js","sourcesContent":["import type { ComponentType, ReactNode } from 'react';\nimport { HookSlot } from '../hooks';\nimport { useTranslation } from '../providers/i18n';\nimport { ErrorPage } from '../components/common';\n\nexport interface NotFoundPageProps {\n  title?: string;\n  message?: string;\n  showHomeLink?: boolean;\n  homeLinkText?: string;\n  LinkComponent?: ComponentType<{\n    to: string;\n    className?: string;\n    style?: React.CSSProperties;\n    children: ReactNode;\n  }>;\n}\n\nexport function NotFoundPage(props: NotFoundPageProps = {}) {\n  const { t } = useTranslation();\n\n  const {\n    title = t('common.errors.404') || 'Page Not Found',\n    message = t('common.errors.error_occurred') ||\n      'The page you are looking for does not exist or has been moved.',\n    showHomeLink = true,\n    homeLinkText = t('common.elements.back_home') || 'Back to Home',\n    LinkComponent,\n  } = props;\n\n  return (\n    <ErrorPage\n      code={404}\n      title={title}\n      message={message}\n      showAction={showHomeLink}\n      actionText={homeLinkText}\n      LinkComponent={LinkComponent}\n    >\n      <HookSlot name=\"notfound:start\" />\n      <HookSlot name=\"notfound:content\" />\n      <HookSlot name=\"notfound:end\" />\n    </ErrorPage>\n  );\n}\n"]}