@ecomiq/storefront 0.1.0 → 0.1.1

package/README.md

@@ -1,8 +1,8 @@
 # @ecomiq/storefront
 
-SDK oficial para construir tiendas online con **Next.js** y **React** sobre la plataforma Ecomiq.
+SDK **headless** para construir tu propia tienda con **Next.js** y **React** sobre Ecomiq.
 
-Incluye componentes de catálogo, carrito, checkout, cuenta de cliente, CMS, temas y un proxy listo para conectar tu app con la API de tienda.
+Incluye capa de **datos y API**: tipos, schemas Zod, cliente BFF (`/api/store`), hooks y utilidades server. **No** incluye UI precargada (checkout, CMS renderer, temas, `ShellRouter`, etc.): diseñas e implementas la interfaz en tu proyecto.
 
 ## Requisitos
 
@@ -19,8 +19,6 @@ npm install @ecomiq/storefront
 pnpm add @ecomiq/storefront
 ```
 
-En `next.config.js` (o `.mjs`), transpila el SDK:
-
 ```js
 /** @type {import('next').NextConfig} */
 const nextConfig = {
@@ -30,20 +28,18 @@ const nextConfig = {
 export default nextConfig;
 ```
 
-## Inicio rápido
-
-### 1. Estilos
+## Arquitectura
 
-En `app/globals.css`:
-
-```css
-@import "tailwindcss";
-@import "@ecomiq/storefront/nextjs/css";
+```
+Navegador → /api/store/* (proxy en tu Next.js) → API Ecomiq
+              ↑ X-Store-Id (cookie / header tras getPublicStore)
 ```
 
-### 2. Proxy de la API de tienda
+El SDK **no** llama al upstream desde el browser; todas las peticiones van al proxy que tú montas con `toNextJsStoreApiHandler`.
 
-Crea la ruta que reenvía las peticiones al backend de Ecomiq:
+## Inicio rápido
+
+### 1. Proxy BFF
 
 ```ts
 // app/api/store/[...path]/route.ts
@@ -54,124 +50,136 @@ export const { GET, POST, PUT, PATCH, DELETE } = toNextJsStoreApiHandler({
 });
 ```
 
-### 3. Layout y provider
+### 2. Resolver la tienda (server)
 
 ```tsx
-// app/(shop)/layout.tsx
-import { EcomiqProvider, getPublicStore, ThemeComponentLoader } from "@ecomiq/storefront/nextjs";
-
-export default async function ShopLayout({ children }: { children: React.ReactNode }) {
-  const { data } = await getPublicStore();
-
+// app/layout.tsx (Server Component)
+import { getPublicStore, EcomiqProvider } from "@ecomiq/storefront/nextjs";
+import { authClient } from "./auth-client";
+
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  const { data: store, error } = await getPublicStore();
+  if (error) {
+    // tu página de error / tienda no encontrada
+  }
   return (
-    <EcomiqProvider store={data} authClient={yourAuthClient}>
-      <ThemeComponentLoader themeName="default" componentName="header" props={{ /* logo, etc. */ }} />
+    <EcomiqProvider store={store} authClient={authClient}>
       {children}
-      <ThemeComponentLoader themeName="default" componentName="footer" props={{ /* … */ }} />
     </EcomiqProvider>
   );
 }
 ```
 
-### 4. Rutas de la tienda
+`EcomiqProvider` es un Client Component: puedes importarlo desde un layout servidor como en el ejemplo. Hidrata la tienda (`useStore`, `setClientStoreId`), React Query y la sesión (`authClient` de Better Auth).
 
-Usa el enrutador incluido para catálogo, producto, carrito, checkout y cuenta:
+### 3. Catálogo con hooks
 
 ```tsx
-// app/(shop)/[[...route]]/page.tsx
-import {
-  ShellRouter,
-  generateMetadata as generateStoreMetadata,
-} from "@ecomiq/storefront/nextjs";
-
-export default function StorePage(props: {
-  params: Promise<{ route?: string[] }>;
-  searchParams: Record<string, string | string[] | undefined>;
-}) {
-  return <ShellRouter {...props} getServerSession={yourGetSession} />;
-}
+"use client";
+
+import { useStoreProducts } from "@ecomiq/storefront/nextjs";
+
+export function ProductList() {
+  const { useStorefrontProductsList } = useStoreProducts();
+  const { data, isLoading } = useStorefrontProductsList({ page: 1, pageSize: 24 });
 
-export function generateMetadata(props: { params: Promise<{ route?: string[] }> }) {
-  return generateStoreMetadata({ params: props.params });
+  if (isLoading) return <p>Cargando…</p>;
+  return (
+    <ul>
+      {data?.products.map((p) => (
+        <li key={p.id}>{p.name}</li>
+      ))}
+    </ul>
+  );
 }
 ```
 
-Con esto tienes una tienda funcional: home, listados, ficha de producto, carrito, checkout y área de cliente.
-
-## Puntos de entrada
+### 4. Datos en Server Components
 
-Elige el subpath según lo que necesites en tu proyecto:
+```tsx
+import { getStorefrontProducts } from "@ecomiq/storefront/nextjs";
 
-| Import | Cuándo usarlo |
-|--------|----------------|
-| `@ecomiq/storefront/nextjs` | App Next.js completa: layout, router, provider, páginas exportables, temas |
-| `@ecomiq/storefront/nextjs/api` | Solo el handler del proxy `/api/store/*` |
-| `@ecomiq/storefront/nextjs/css` | Estilos base del shell |
-| `@ecomiq/storefront/react` | Componentes, hooks, tipos y utilidades para UI personalizada |
-| `@ecomiq/storefront/client` | Llamadas a la API de tienda (catálogo, carrito, pedidos, cliente) sin componentes |
-| `@ecomiq/storefront/core` | Tipos y schemas Zod (módulos sin React) |
+export default async function CatalogPage() {
+  const { products } = await getStorefrontProducts({ page: 1, pageSize: 24 });
+  return <YourGrid products={products} />;
+}
+```
 
-En la mayoría de storefronts nuevos basta con **`/nextjs`** para el armazón y **`/react`** cuando añadas pantallas o bloques propios.
+### 5. Estilos (opcional)
 
-## Variables de entorno
+```css
+@import "tailwindcss";
+@import "@ecomiq/storefront/nextjs/css";
+```
 
-| Variable | Descripción |
-|----------|-------------|
-| `STOREFRONT_API_URL` | URL base de la API de tienda Ecomiq (usada en el proxy) |
+El CSS publicado es **mínimo**. Tu design system y componentes viven en la app.
 
-Configura también en tu app el identificador de tienda y auth según tu despliegue (subdominio, `X-Store-Id`, Better Auth, etc.).
+## Puntos de entrada (npm)
 
-## Personalización
+| Import | Uso |
+|--------|-----|
+| `@ecomiq/storefront/core` | Tipos, Zod, utilidades, servicios axios legacy |
+| `@ecomiq/storefront/react` | `EcomiqProvider`, hooks, stores, auth OAuth, `findStorefrontCmsPageBySlug`, selector de variantes |
+| `@ecomiq/storefront/nextjs` | `getPublicStore`, `EcomiqProvider`, cliente BFF, hooks `useStore*` |
+| `@ecomiq/storefront/nextjs/api` | Handler del proxy `/api/store/*` |
+| `@ecomiq/storefront/nextjs/css` | Tailwind base opcional |
+| `@ecomiq/storefront/nextjs/postcss` | PostCSS de referencia |
 
-### Temas
+No hay subpath `./client` en npm: las funciones del cliente BFF se importan desde **`/nextjs`**.
 
-Los bloques visuales (header, footer, tarjeta de producto, etc.) se cargan por nombre de tema:
+## Auth (Better Auth)
 
-```tsx
-import { ThemeComponentLoader } from "@ecomiq/storefront/nextjs";
+Plugins para OAuth password grant de Ecomiq:
 
-<ThemeComponentLoader
-  themeName="default"
-  componentName="productCard"
-  props={{ product }}
-/>
+```ts
+import {
+  ecomiqOAuthPassword,
+  ecomiqOAuthPasswordClient,
+} from "@ecomiq/storefront/react";
 ```
 
-Puedes registrar un tema propio y referenciarlo con `themeName`.
+## Variables de entorno
 
-### UI y datos en componentes propios
+| Variable | Descripción |
+|----------|-------------|
+| `STOREFRONT_API_URL` | URL base de la API de tienda (proxy) |
+| `PUBLIC_STORE_SETTINGS_SOURCE` | `api` (default) o `kv` (OpenNext / Cloudflare) |
 
-```tsx
-import { useProducts, ProductsSection, type StorefrontProduct } from "@ecomiq/storefront/react";
-```
+Tras `getPublicStore`, el SDK fija `X-Store-Id` en el servidor para las llamadas al proxy.
 
-```ts
-import { setClientStoreId, getStorefrontProducts } from "@ecomiq/storefront/client";
+## Qué no viene en el paquete npm
 
-setClientStoreId("tu-store-id");
-const page = await getStorefrontProducts({ page: 1, pageSize: 24 });
-```
+Pensado para que **tú** construyas la UI:
+
+- `ShellRouter`, páginas exportadas
+- Checkout, carrito drawer, cuenta, formularios precargados
+- `CmsSectionsRenderer`, `DefaultCmsSectionsRenderer`, `SafeThemeInjector`
+- `ThemeComponentLoader` y temas `default` / `ana` / `sony`
+- Dependencia de `@ecomiq/ui`
+
+Esa capa completa existe en el **monorepo Ecomiq** (`workspace:*` sobre `src/`), no en el tarball npm.
 
-### Páginas preconstruidas
+## Desarrollo en el monorepo Ecomiq
 
-Importa páginas listas desde `@ecomiq/storefront/nextjs/export-pages/*` si prefieres componer rutas manualmente en lugar de `ShellRouter`.
+Si trabajas dentro del repo `ecomiq`, el paquete se consume por fuente con exports amplios (`./react/components/*`, `./nextjs/export-pages/*`, etc.) y UI con `@ecomiq/ui`.
 
-## Ejemplo de dependencias
+Para empaquetar o publicar en npm: ver [PUBLISHING.md](./PUBLISHING.md).
+
+## Dependencias recomendadas en tu app
 
 ```json
 {
   "dependencies": {
     "@ecomiq/storefront": "^0.1.0",
+    "@tanstack/react-query": "^5.66.0",
+    "better-auth": "^1.6.0",
     "next": "^15.3.0",
     "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "tailwindcss": "^4.0.0"
+    "react-dom": "^19.0.0"
   }
 }
 ```
 
 ## Soporte
 
-Documentación de la plataforma y credenciales de API: [ecomiq.pe](https://ecomiq.pe) (o el portal que use tu organización).
-
-Para incidencias del SDK, abre un issue en el repositorio del paquete o contacta al equipo Ecomiq.
+Documentación y credenciales: [ecomiq.pe](https://ecomiq.pe) (o el portal de tu organización).

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-import { P as ProductsFilters, g as ProductsResponse, e as Product, d as StorefrontProductsParamsInput, h as StorefrontProductsResponse, b as StorefrontProductDetail, c as StorefrontCollection, o as StorefrontCollectionDetail, S as StorefrontSettings } from './store-CYBCpY6v.js';
-export { t as ProductSchema, f as ProductVariant, u as ProductVariantSchema, w as ProductsFiltersSchema, v as ProductsResponseSchema, m as StorefrontBundleItem, C as StorefrontBundleItemSchema, I as StorefrontCheckoutSettingsSchema, r as StorefrontCmsPage, q as StorefrontCmsSettings, F as StorefrontCollectionDetailSchema, D as StorefrontCollectionSchema, n as StorefrontCollectionsResponse, E as StorefrontCollectionsResponseSchema, l as StorefrontPriceTier, B as StorefrontPriceTierSchema, a as StorefrontProduct, A as StorefrontProductDetailSchema, k as StorefrontProductImage, x as StorefrontProductSchema, z as StorefrontProductsParamsSchema, y as StorefrontProductsResponseSchema, s as StorefrontSettingsLegacyFlat, J as StorefrontSettingsLegacyFlatSchema, G as StorefrontSettingsSchema, p as StorefrontStore, H as StorefrontStoreSchema, i as StorefrontVariant, j as StorefrontVariantOption, N as normalizeStorefrontSettingsPayload, L as storefrontFaviconUrl, M as storefrontOgImageUrl, K as storefrontStoreRecord } from './store-CYBCpY6v.js';
+import { P as ProductsFilters, d as ProductsResponse, b as Product, a as StorefrontProductsParamsInput, f as StorefrontProductsResponse, g as StorefrontProductDetail, m as StorefrontCollection, o as StorefrontCollectionDetail, S as StorefrontSettings } from './store-to_vuWRF.js';
+export { t as ProductSchema, c as ProductVariant, u as ProductVariantSchema, w as ProductsFiltersSchema, v as ProductsResponseSchema, l as StorefrontBundleItem, C as StorefrontBundleItemSchema, I as StorefrontCheckoutSettingsSchema, r as StorefrontCmsPage, q as StorefrontCmsSettings, F as StorefrontCollectionDetailSchema, D as StorefrontCollectionSchema, n as StorefrontCollectionsResponse, E as StorefrontCollectionsResponseSchema, k as StorefrontPriceTier, B as StorefrontPriceTierSchema, e as StorefrontProduct, A as StorefrontProductDetailSchema, j as StorefrontProductImage, x as StorefrontProductSchema, z as StorefrontProductsParamsSchema, y as StorefrontProductsResponseSchema, s as StorefrontSettingsLegacyFlat, J as StorefrontSettingsLegacyFlatSchema, G as StorefrontSettingsSchema, p as StorefrontStore, H as StorefrontStoreSchema, h as StorefrontVariant, i as StorefrontVariantOption, N as normalizeStorefrontSettingsPayload, L as storefrontFaviconUrl, M as storefrontOgImageUrl, K as storefrontStoreRecord } from './store-to_vuWRF.js';
 import { z } from 'zod';
 import { AxiosRequestConfig } from 'axios';
 
@@ -3191,15 +3191,6 @@ declare class ApiClient {
 }
 declare const apiClient: ApiClient;
 
-interface ThemeComponentsMap {
-    header: React.ComponentType<any>;
-    footer: React.ComponentType<any>;
-    buttonCart: React.ComponentType<any>;
-    productCard: React.ComponentType<any>;
-}
-type ThemeComponentName = keyof ThemeComponentsMap;
-type ThemeName = 'ana' | 'sony' | 'default';
-
 interface ThemeColors {
     primary: string;
     secondary: string;
@@ -3397,4 +3388,4 @@ type CustomerProfile = {
     dateOfBirth: string | null;
 };
 
-export { type CartAddressesRequest, CartAddressesRequestSchema, type CartBuyerRequest, CartBuyerRequestSchema, type CartCheckoutPayment, type CartCheckoutPaymentAction, CartCheckoutPaymentActionSchema, CartCheckoutPaymentSchema, type CartCheckoutReadResponse, CartCheckoutReadResponseSchema, type CartCheckoutRequest, CartCheckoutRequestSchema, type CartCheckoutResponse, CartCheckoutResponseSchema, type CartCouponRequest, CartCouponRequestSchema, type CartCreateRequest, CartCreateRequestSchema, type CartItemModifierRequest, CartItemModifierRequestSchema, type CartItemRequest, CartItemRequestSchema, type CartPaymentMethod, CartPaymentMethodSchema, type CartPaymentMethodsResponse, CartPaymentMethodsResponseSchema, type CartPaymentReceiptResponse, CartPaymentReceiptResponseSchema, type CartResponse, CartResponseBundleItemSchema, CartResponseItemSchema, CartResponseSchema, type CartShippingMethodPutRequest, CartShippingMethodPutRequestSchema, type CustomerAddressUpsertInput, type CustomerOrderDetail, type CustomerOrderLineItem, type CustomerOrderListItem, type CustomerOrderShippingAddress, type CustomerProfile, type CustomerProfilePatch, type CustomerSavedAddress, type GeoItem, Product, ProductsFilters, ProductsResponse, STOREFRONT_API_PATH_PREFIX, STOREFRONT_ECOMIQ_OAUTH_COOKIE_NAME, STOREFRONT_ECOMIQ_OAUTH_COOKIE_PATH, type ShippingOptionGroup, ShippingOptionGroupSchema, type ShippingOptionsResponse, ShippingOptionsResponseSchema, type ShippingRate, ShippingRateSchema, type StoreTheme, StorefrontCollection, StorefrontCollectionDetail, type StorefrontPageBlock, type StorefrontPageDetail, StorefrontPageDetailSchema, type StorefrontPageListItem, StorefrontPageListItemSchema, type StorefrontPageSection, StorefrontProductDetail, StorefrontProductsParamsInput, StorefrontProductsResponse, StorefrontSettings, type ThemeComponentName, type ThemeComponentsMap, type ThemeName, apiClient, cartService, collectionService, countryCurrency, customerOrderStatusTone, fetchStorefrontGeoDistricts, fetchStorefrontGeoProvinces, formatCurrency, formatCustomerOrderStatus, formatOrderDate, formatOrderDateTime, loadStorefrontGeoDepartments, pageService, productService, resolveIneiCodesFromLabels, storeService, toGeoItems };
+export { type CartAddressesRequest, CartAddressesRequestSchema, type CartBuyerRequest, CartBuyerRequestSchema, type CartCheckoutPayment, type CartCheckoutPaymentAction, CartCheckoutPaymentActionSchema, CartCheckoutPaymentSchema, type CartCheckoutReadResponse, CartCheckoutReadResponseSchema, type CartCheckoutRequest, CartCheckoutRequestSchema, type CartCheckoutResponse, CartCheckoutResponseSchema, type CartCouponRequest, CartCouponRequestSchema, type CartCreateRequest, CartCreateRequestSchema, type CartItemModifierRequest, CartItemModifierRequestSchema, type CartItemRequest, CartItemRequestSchema, type CartPaymentMethod, CartPaymentMethodSchema, type CartPaymentMethodsResponse, CartPaymentMethodsResponseSchema, type CartPaymentReceiptResponse, CartPaymentReceiptResponseSchema, type CartResponse, CartResponseBundleItemSchema, CartResponseItemSchema, CartResponseSchema, type CartShippingMethodPutRequest, CartShippingMethodPutRequestSchema, type CustomerAddressUpsertInput, type CustomerOrderDetail, type CustomerOrderLineItem, type CustomerOrderListItem, type CustomerOrderShippingAddress, type CustomerProfile, type CustomerProfilePatch, type CustomerSavedAddress, type GeoItem, Product, ProductsFilters, ProductsResponse, STOREFRONT_API_PATH_PREFIX, STOREFRONT_ECOMIQ_OAUTH_COOKIE_NAME, STOREFRONT_ECOMIQ_OAUTH_COOKIE_PATH, type ShippingOptionGroup, ShippingOptionGroupSchema, type ShippingOptionsResponse, ShippingOptionsResponseSchema, type ShippingRate, ShippingRateSchema, type StoreTheme, StorefrontCollection, StorefrontCollectionDetail, type StorefrontPageBlock, type StorefrontPageDetail, StorefrontPageDetailSchema, type StorefrontPageListItem, StorefrontPageListItemSchema, type StorefrontPageSection, StorefrontProductDetail, StorefrontProductsParamsInput, StorefrontProductsResponse, StorefrontSettings, apiClient, cartService, collectionService, countryCurrency, customerOrderStatusTone, fetchStorefrontGeoDistricts, fetchStorefrontGeoProvinces, formatCurrency, formatCustomerOrderStatus, formatOrderDate, formatOrderDateTime, loadStorefrontGeoDepartments, pageService, productService, resolveIneiCodesFromLabels, storeService, toGeoItems };

package/dist/find-storefront-cms-page-c8CktSz7.d.ts

@@ -0,0 +1,164 @@
+import * as zustand from 'zustand';
+import { S as StorefrontSettings } from './store-to_vuWRF.js';
+import * as React$1 from 'react';
+import React__default from 'react';
+import * as better_auth_react from 'better-auth/react';
+import { createAuthClient } from 'better-auth/react';
+import * as better_auth from 'better-auth';
+import { StorefrontProductDetail, StorefrontVariant, StorefrontSettings as StorefrontSettings$1, StorefrontPageDetail } from '@ecomiq/storefront/react';
+
+/** Instancia de `createAuthClient` (better-auth/react) con los plugins de la app. */
+type StorefrontAuthClientInstance = ReturnType<typeof createAuthClient>;
+declare function StorefrontAuthProvider({ authClient, children, }: {
+    authClient: StorefrontAuthClientInstance;
+    children: React__default.ReactNode;
+}): React__default.JSX.Element;
+declare function useStorefrontAuthClient(): StorefrontAuthClientInstance;
+type StorefrontSessionUser = {
+    id: string;
+    email: string;
+    firstName: string;
+    lastName: string;
+    name?: string;
+    phone?: string;
+};
+/** Caducidad alineada con OAuth/`expires_in` (skew en ms). El bearer ya no viene en JSON de sesión. */
+declare function storefrontSessionEndsSoon(expiresAt: Date | undefined, skewMs?: number): boolean;
+/** @deprecated Usar `storefrontSessionEndsSoon` */
+declare const storefrontAccessTokenNeedsRefresh: typeof storefrontSessionEndsSoon;
+/**
+ * Sesión Better Auth + usuario mapeado para UI (headers, drawer).
+ */
+declare function useStorefrontSession(): {
+    session: {
+        data: {
+            user: better_auth.StripEmptyObjects<{
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined;
+            }>;
+            session: better_auth.StripEmptyObjects<{
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                userId: string;
+                expiresAt: Date;
+                token: string;
+                ipAddress?: string | null | undefined;
+                userAgent?: string | null | undefined;
+            }>;
+        } | null;
+        isPending: boolean;
+        isRefetching: boolean;
+        error: better_auth_react.BetterFetchError | null;
+        refetch: (queryParams?: {
+            query?: better_auth.SessionQueryParams;
+        } | undefined) => Promise<void>;
+    };
+    user: StorefrontSessionUser | null;
+    sessionExpiresAt: Date | undefined;
+    isAuthenticated: boolean;
+    isPending: boolean;
+    error: better_auth_react.BetterFetchError | null;
+    refetch: (queryParams?: {
+        query?: better_auth.SessionQueryParams;
+    } | undefined) => Promise<void>;
+    signOut: () => Promise<{
+        data: {
+            success: boolean;
+        };
+        error: null;
+    } | {
+        data: null;
+        error: {
+            code?: string | undefined | undefined;
+            message?: string | undefined | undefined;
+            status: number;
+            statusText: string;
+        };
+    }>;
+};
+
+type Drawers = {
+    cart: boolean;
+    search: boolean;
+    menu: boolean;
+    filter: boolean;
+    [key: string]: boolean;
+};
+type Modals = {
+    login: boolean;
+    signup: boolean;
+    [key: string]: boolean;
+};
+type StoreState = {
+    data: StorefrontSettings | null;
+    drawers: Drawers;
+    modals: Modals;
+    openDrawer: (drawer: keyof Drawers) => void;
+    closeDrawer: (drawer: keyof Drawers) => void;
+    toggleDrawer: (drawer: keyof Drawers) => void;
+    closeAllDrawers: () => void;
+    openModal: (modal: keyof Modals) => void;
+    closeModal: (modal: keyof Modals) => void;
+    toggleModal: (modal: keyof Modals) => void;
+    closeAllModals: () => void;
+};
+declare const useStore: zustand.UseBoundStore<zustand.StoreApi<StoreState>>;
+
+type EcomiqProviderProps = {
+    store: StorefrontSettings | null;
+    authClient: StorefrontAuthClientInstance;
+    children: React__default.ReactNode;
+    /**
+     * Modales de login/registro y toasts del shell Ecomiq (requiere `@ecomiq/ui` en el monorepo).
+     * En npm / tiendas custom deja `false` y monta tu propia UI.
+     */
+    withShellUi?: boolean;
+};
+declare function EcomiqProvider({ store, authClient, children, withShellUi, }: EcomiqProviderProps): React__default.JSX.Element;
+
+/** Option group derived from variants (e.g. Color: [Black, White], Size: [6x8, 8x11]) */
+type OptionGroup = {
+    key: string;
+    name: string;
+    values: string[];
+};
+/** Selected options per group (e.g. { Color: "Black", Size: "8 x 11 inch" }) */
+type SelectedOptions = Record<string, string>;
+type ProductVariantSelectorRenderProps = {
+    product: StorefrontProductDetail;
+    selectedVariant: StorefrontVariant | null;
+    displayPrice: number;
+    compareAtPrice: number | null | undefined;
+    isAvailable: boolean;
+    selectedOptions: SelectedOptions;
+};
+
+type ProductVariantSelectorProps = {
+    product: StorefrontProductDetail;
+    currency?: string;
+    features?: string[];
+    onVariantChange?: (variant: StorefrontVariant | null, price: number) => void;
+    children?: (props: {
+        product: StorefrontProductDetail;
+        selectedVariant: StorefrontVariant | null;
+        displayPrice: number;
+        compareAtPrice: number | null | undefined;
+        isAvailable: boolean;
+        selectedOptions: SelectedOptions;
+    }) => React.ReactNode;
+};
+declare function ProductVariantSelector({ product, currency, features, onVariantChange, children, }: ProductVariantSelectorProps): React$1.JSX.Element;
+
+/**
+ * Busca una página CMS en `settings.cms.pages` (payload de `getPublicStore` / settings)
+ * y la valida como `StorefrontPageDetail` para `DynamicPage`.
+ */
+declare function findStorefrontCmsPageBySlug(settings: StorefrontSettings$1 | null | undefined, slug: string): StorefrontPageDetail | null;
+
+export { EcomiqProvider as E, type OptionGroup as O, ProductVariantSelector as P, StorefrontAuthProvider as S, storefrontSessionEndsSoon as a, useStorefrontSession as b, type StorefrontAuthClientInstance as c, type StorefrontSessionUser as d, type EcomiqProviderProps as e, findStorefrontCmsPageBySlug as f, useStore as g, type ProductVariantSelectorProps as h, type SelectedOptions as i, type ProductVariantSelectorRenderProps as j, storefrontAccessTokenNeedsRefresh as s, useStorefrontAuthClient as u };

package/dist/nextjs/globals.css

@@ -1,11 +1,10 @@
 /**
- * Estilos base del SDK para consumidores npm (sin @ecomiq/ui).
- * La app debe aportar su propio sistema de diseño / primitivos UI.
+ * Estilos mínimos para consumidores npm.
+ * La app define su propio design system y componentes.
  */
 @import "tailwindcss";
 
-@source "../react/";
-@source "../react/components/cms-sections-renderer.tsx";
+@source "../react/shell/components/product-variant-selector/";
 
 @layer base {
   * {