@weaverse/hydrogen 6.1.3 → 6.2.0

package/dist/types/next/server/configs.d.ts

@@ -0,0 +1,27 @@
+import type { WeaverseNextBaseConfigs, WeaverseNextRequestContext } from '../types';
+/**
+ * Extract the request search params from the explicit Next request context.
+ * Prefers `searchParams`, falls back to parsing `url`.
+ */
+export declare function getContextSearchParams(context?: WeaverseNextRequestContext): URLSearchParams;
+/** Overrides used while resolving request-scoped Weaverse configuration. */
+export interface ResolveConfigsOptions {
+    /** Environment values; missing keys fall back to `process.env`. */
+    env?: Record<string, string | undefined>;
+    /** Public data API base override. */
+    weaverseApiBase?: string;
+    /** Studio origin override. */
+    weaverseHost?: string;
+    /** Studio asset version override. */
+    weaverseVersion?: string;
+}
+/**
+ * Derive Weaverse configs from the request context and env, close to Hydrogen's
+ * `getWeaverseConfigs`. Resolves the trusted host, public API base, design /
+ * preview / revision flags, and public env — but never resolves the final
+ * `projectId` (that priority chain, which may call an async resolver, lives in
+ * the server client). Query/env projectId candidates are returned for the
+ * client to combine with function/string inputs.
+ */
+export declare function getWeaverseNextConfigs(context?: WeaverseNextRequestContext, options?: ResolveConfigsOptions): WeaverseNextBaseConfigs;
+//# sourceMappingURL=configs.d.ts.map

package/dist/types/next/server/configs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configs.d.ts","sourceRoot":"","sources":["../../../../src/next/server/configs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,UAAU,CAAA;AA6CjB;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,0BAA0B,GACnC,eAAe,CAWjB;AAkCD,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,0BAA0B,EACpC,OAAO,GAAE,qBAA0B,GAClC,uBAAuB,CAuDzB"}

package/dist/types/next/server/normalize-page-url.d.ts

@@ -0,0 +1,19 @@
+import type { WeaverseNextRequestContext } from '../types';
+/**
+ * Normalize the storefront URL sent in the Builder page API request body.
+ *
+ * The Builder reads only the pathname (locale/type/handle fallback) and the
+ * Weaverse/Studio control params from this URL, so keep exactly those and drop
+ * tracking params. Params are sorted for a stable, cache-friendly string.
+ *
+ * Ported from `@weaverse/hydrogen`'s `normalizePageUrl`, but tolerant of a
+ * relative URL (Next route handlers may only know the pathname).
+ */
+export declare function normalizeNextPageUrl(url: string): string;
+/**
+ * Build an absolute-ish request URL string from the explicit request context,
+ * preferring `url`, then `pathname` + `searchParams`. Used as the input to
+ * {@link normalizeNextPageUrl}.
+ */
+export declare function resolveRequestUrl(context?: WeaverseNextRequestContext): string;
+//# sourceMappingURL=normalize-page-url.d.ts.map

package/dist/types/next/server/normalize-page-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-page-url.d.ts","sourceRoot":"","sources":["../../../../src/next/server/normalize-page-url.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAa1D;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqBxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,0BAA0B,GACnC,MAAM,CAkBR"}

package/dist/types/next/server/revalidate-handler.d.ts

@@ -0,0 +1,55 @@
+import { type WeaverseNextRevalidateRouteContext } from '../revalidate-item';
+import type { WeaverseNextComponentData, WeaverseNextRequestContext, WeaverseNextServerClient } from '../types';
+/** Configuration for the App Router item-revalidation handler. */
+export interface WeaverseNextRevalidateHandlerConfig {
+    /**
+     * Reuse the app's server-client factory so the loader runs with the same
+     * component registry and commerce (storefront) context as page loads.
+     *
+     * The optional second argument is the validated, same-origin route context
+     * reconstructed from the request body. It is `undefined` for legacy bodies
+     * that carry no `routeContext`, so a one-argument `(request) => client`
+     * callback remains valid. Consumers must still source project ID, Studio
+     * host, API bases/keys, and env from server config — never from this
+     * browser-provided context.
+     */
+    getClient: (request: Request, requestContext?: WeaverseNextRequestContext) => Promise<WeaverseNextServerClient> | WeaverseNextServerClient;
+}
+/** POST body accepted by the revalidate route. */
+export interface WeaverseNextRevalidateRequestBody {
+    /** Unsaved Studio item settings to pass to the registered component loader. */
+    draftItem: WeaverseNextComponentData;
+    /** Public route identity used to reconstruct the loader request context. */
+    routeContext?: WeaverseNextRevalidateRouteContext;
+}
+/** App Router handler returned for Studio item revalidation requests. */
+export interface WeaverseNextRevalidateHandler {
+    /** Handle a Studio request to rerun one registered component loader. */
+    POST: (request: Request) => Promise<Response>;
+}
+/**
+ * Create the Studio per-item revalidation route handler.
+ *
+ * Studio design-mode edits to loader-backed inputs (e.g. resource pickers) need
+ * fresh server loader data for a single item. Re-running it through
+ * `router.refresh()` re-applies the whole RSC tree — and the draft-item query
+ * rewrite changes the App Router page segment key, remounting the page and
+ * resetting scroll. This handler runs just the edited component's `loader`
+ * with the unsaved draft settings and returns the payload for an in-place
+ * client update (see the `2026-07-02--next-item-revalidation` spec).
+ *
+ * Security: only registered component types are executable, the handler never
+ * persists anything, and responses are `no-store`. Exposure is equivalent to
+ * the existing `weaverseDraftItem` URL param, which already lets any visitor
+ * run design-mode loaders with arbitrary draft settings.
+ *
+ * @example
+ * ```ts
+ * // app/api/weaverse/revalidate/route.ts
+ * export const { POST } = createWeaverseNextRevalidateHandler({
+ *   getClient: () => getWeaverseServerClient(Promise.resolve({})),
+ * })
+ * ```
+ */
+export declare function createWeaverseNextRevalidateHandler(config: WeaverseNextRevalidateHandlerConfig): WeaverseNextRevalidateHandler;
+//# sourceMappingURL=revalidate-handler.d.ts.map

package/dist/types/next/server/revalidate-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate-handler.d.ts","sourceRoot":"","sources":["../../../../src/next/server/revalidate-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,kCAAkC,EACxC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EACV,yBAAyB,EAEzB,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,UAAU,CAAA;AAsBjB,kEAAkE;AAClE,MAAM,WAAW,mCAAmC;IAClD;;;;;;;;;;OAUG;IACH,SAAS,EAAE,CACT,OAAO,EAAE,OAAO,EAChB,cAAc,CAAC,EAAE,0BAA0B,KACxC,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAA;CAClE;AAED,kDAAkD;AAClD,MAAM,WAAW,iCAAiC;IAChD,+EAA+E;IAC/E,SAAS,EAAE,yBAAyB,CAAA;IACpC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,kCAAkC,CAAA;CAClD;AAoMD,yEAAyE;AACzE,MAAM,WAAW,6BAA6B;IAC5C,wEAAwE;IACxE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,mCAAmC,GAC1C,6BAA6B,CAqE/B"}

package/dist/types/next/server/server-client.d.ts

@@ -0,0 +1,21 @@
+import type { WeaverseNextServerClient, WeaverseNextServerClientConfig } from '../types';
+/**
+ * Create a server-side {@link WeaverseNextServerClient} for Next.js App Router
+ * routes / server components.
+ *
+ * @example
+ * ```ts
+ * let weaverse = createWeaverseNextServerClient({
+ *   projectId: process.env.WEAVERSE_PROJECT_ID,
+ *   components,
+ *   commerce: { storefront },
+ *   requestContext: { url, headers, searchParams, i18n },
+ *   cache: { revalidate: 60, tags: ['weaverse'] },
+ * })
+ * let data = await weaverse.loadPage({ type: 'INDEX' })
+ * let theme = await weaverse.loadThemeSettings()
+ * ```
+ */
+export declare function createWeaverseNextServerClient(config: WeaverseNextServerClientConfig): WeaverseNextServerClient;
+export { getContextSearchParams } from './configs';
+//# sourceMappingURL=server-client.d.ts.map

package/dist/types/next/server/server-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-client.d.ts","sourceRoot":"","sources":["../../../../src/next/server/server-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAgBV,wBAAwB,EACxB,8BAA8B,EAM/B,MAAM,UAAU,CAAA;AAsqBjB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,8BAA8B,GACrC,wBAAwB,CAE1B;AAED,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA"}

package/dist/types/next/server.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Server-only Weaverse APIs for Next.js App Router server components and route
+ * handlers.
+ *
+ * When migrating from Hydrogen's `context.weaverse`, create a request-scoped
+ * client with {@link createWeaverseNextServerClient}, then call `loadPage()` or
+ * `loadThemeSettings()`. Keep rendering providers and components imported from
+ * the root `@weaverse/hydrogen/next` entrypoint.
+ *
+ * @packageDocumentation
+ */
+export type { WeaverseNextRevalidateRouteContext } from './revalidate-item';
+export { formatWeaverseNextSeoMetadata, getWeaverseNextSeoMetadata, type NextOpenGraph, type NextTwitter, type WeaverseNextSeoInput, type WeaverseNextSeoMetadata, type WeaverseNextSeoPageContainer, } from './seo';
+export { getWeaverseNextConfigs, type ResolveConfigsOptions, } from './server/configs';
+export { normalizeNextPageUrl, resolveRequestUrl, } from './server/normalize-page-url';
+export { createWeaverseNextRevalidateHandler, type WeaverseNextRevalidateHandler, type WeaverseNextRevalidateHandlerConfig, type WeaverseNextRevalidateRequestBody, } from './server/revalidate-handler';
+export { createWeaverseNextServerClient } from './server/server-client';
+export type { WeaverseNextBaseConfigs, WeaverseNextCacheConfig, WeaverseNextClient, WeaverseNextCommerceContext, WeaverseNextComponent, WeaverseNextComponentData, WeaverseNextComponentLoaderArgs, WeaverseNextComponentProps, WeaverseNextConfigs, WeaverseNextCustomPageEntry, WeaverseNextFetchCustomPagesOptions, WeaverseNextFetchOptions, WeaverseNextI18n, WeaverseNextLoaderData, WeaverseNextLoadPageInput, WeaverseNextPageAssignment, WeaverseNextPageData, WeaverseNextProjectId, WeaverseNextRequestContext, WeaverseNextServerClient, WeaverseNextServerClientConfig, WeaverseNextServerLoadPageInput, WeaverseNextStorefront, WeaverseNextThemeSchema, WeaverseNextThemeSchemaGroup, WeaverseNextThemeSchemaInput, WeaverseNextThemeSettingsOptions, WeaverseNextThemeSettingsResponse, } from './types';
+//# sourceMappingURL=server.d.ts.map

package/dist/types/next/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/next/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAAE,kCAAkC,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,GAClC,MAAM,OAAO,CAAA;AACd,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,mCAAmC,EACnC,KAAK,6BAA6B,EAClC,KAAK,mCAAmC,EACxC,KAAK,iCAAiC,GACvC,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAA;AACvE,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,yBAAyB,EACzB,+BAA+B,EAC/B,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,mCAAmC,EACnC,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,4BAA4B,EAC5B,gCAAgC,EAChC,iCAAiC,GAClC,MAAM,SAAS,CAAA"}

package/dist/types/next/studio-bridge.d.ts

@@ -0,0 +1,16 @@
+import { type WeaverseNextRuntime } from './runtime';
+import type { WeaverseNextRuntimeInternal } from './types';
+/** Runtime and host callbacks attached to the Builder Studio bridge. */
+export interface WeaverseNextStudioBridgeProps {
+    /** Preview navigation callback. */
+    navigate?: WeaverseNextRuntimeInternal['navigate'];
+    /** Whole-route refresh callback used as a legacy fallback. */
+    revalidate?: WeaverseNextRuntimeInternal['revalidate'];
+    /** Preferred per-item loader revalidation callback. */
+    revalidateItem?: WeaverseNextRuntimeInternal['revalidateItem'];
+    /** Browser runtime to initialize or refresh in Studio. */
+    runtime: WeaverseNextRuntime;
+}
+/** Page-level Studio runtime binder. */
+export declare function WeaverseNextStudioBridge(props: WeaverseNextStudioBridgeProps): null;
+//# sourceMappingURL=studio-bridge.d.ts.map

package/dist/types/next/studio-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-bridge.d.ts","sourceRoot":"","sources":["../../../src/next/studio-bridge.tsx"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAA;AAK1D,wEAAwE;AACxE,MAAM,WAAW,6BAA6B;IAC5C,mCAAmC;IACnC,QAAQ,CAAC,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAA;IAClD,8DAA8D;IAC9D,UAAU,CAAC,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAA;IACtD,uDAAuD;IACvD,cAAc,CAAC,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,CAAA;IAC9D,0DAA0D;IAC1D,OAAO,EAAE,mBAAmB,CAAA;CAC7B;AAED,wCAAwC;AACxC,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,QAwD5E"}

package/dist/types/next/studio-connect.d.ts

@@ -0,0 +1,27 @@
+import type { WeaverseNextRequestContext } from './types';
+/** Trust context used while loading the Studio bridge script. */
+export interface LoadWeaverseNextStudioScriptOptions {
+    /** Storefront hostname; required to permit loopback Studio origins. */
+    storefrontHostname?: string;
+}
+/**
+ * Resolve and append the Next Studio bridge script for the given request
+ * context, deduping by src. SSR-safe (no-op without `document`) so it can run
+ * unconditionally from a root layout/error boundary before any page tree or
+ * runtime exists — e.g. App Router `not-found.tsx` / `error.tsx` routes.
+ */
+export declare function loadWeaverseNextStudioScript(context?: WeaverseNextRequestContext, options?: LoadWeaverseNextStudioScriptOptions): void;
+/** Props for the root-level Studio script connector. */
+export interface WeaverseNextStudioConnectProps {
+    /** Explicit request context used to resolve Studio mode and host. */
+    context?: WeaverseNextRequestContext;
+    /** Storefront hostname; required to permit loopback Studio origins. */
+    storefrontHostname?: string;
+}
+/**
+ * Root-level Studio script connector for Next client boundaries. Mount once
+ * near the app root (e.g. root layout) so it also covers routes that never
+ * render `WeaverseNextRenderer`, such as `not-found.tsx` / `error.tsx`.
+ */
+export declare function WeaverseNextStudioConnect(props: WeaverseNextStudioConnectProps): null;
+//# sourceMappingURL=studio-connect.d.ts.map

package/dist/types/next/studio-connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-connect.d.ts","sourceRoot":"","sources":["../../../src/next/studio-connect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AA0BzD,iEAAiE;AACjE,MAAM,WAAW,mCAAmC;IAClD,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,CAAC,EAAE,0BAA0B,EACpC,OAAO,GAAE,mCAAwC,QAkBlD;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,qEAAqE;IACrE,OAAO,CAAC,EAAE,0BAA0B,CAAA;IACpC,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,QAStC"}

package/dist/types/next/studio-router.d.ts

@@ -0,0 +1,50 @@
+import type { WeaverseNextRuntimeInternal } from './types';
+/**
+ * Minimal structural shape of the Next App Router returned by `useRouter()`
+ * (`next/navigation`) that the Studio bridge needs. Declared locally — rather
+ * than importing `AppRouterInstance` from `next` — so the adapter stays a pure
+ * function that unit tests can drive with a plain mock and never pulls
+ * `next/navigation` into the test graph.
+ */
+export interface WeaverseNextRouterLike {
+    /** Add a route to browser history. */
+    push: (href: string, options?: {
+        /** Whether to scroll to the top after navigation. */
+        scroll?: boolean;
+    }) => void;
+    /** Refresh the current App Router route and server data. */
+    refresh: () => void;
+    /** Replace the current browser-history entry. */
+    replace: (href: string, options?: {
+        /** Whether to scroll to the top after navigation. */
+        scroll?: boolean;
+    }) => void;
+}
+/** Resolved Studio navigation/revalidation callbacks for a Next runtime. */
+export interface WeaverseNextStudioInternals {
+    /** Navigate Studio's preview with React Router-compatible options. */
+    navigate: NonNullable<WeaverseNextRuntimeInternal['navigate']>;
+    /** Refresh the current App Router route. */
+    revalidate: NonNullable<WeaverseNextRuntimeInternal['revalidate']>;
+}
+/** Controls how Studio navigation maps to the Next App Router. */
+export interface CreateWeaverseNextStudioInternalsOptions {
+    /** Use `router.replace` instead of `router.push` for navigation. */
+    replace?: boolean;
+}
+/**
+ * Build Studio `navigate` / `revalidate` callbacks from a Next App Router.
+ *
+ * Maps Hydrogen's React Router semantics onto Next App Router:
+ * - `navigate(to, { preventScrollReset })` → `router.push(to, { scroll })`,
+ *   where `scroll` is the inverse of `preventScrollReset`. Studio passes
+ *   `preventScrollReset` for in-place edits so the preview viewport is kept,
+ *   matching React Router's `navigate({ preventScrollReset })`.
+ * - `revalidate()` → `router.refresh()`, the App Router's loader-backed refresh
+ *   and the closest equivalent to React Router's `useRevalidator`.
+ *
+ * Pure (no React, no `next/navigation`) so it is unit-testable with a mock
+ * router; the {@link WeaverseNextRouterLike} contract is the only coupling.
+ */
+export declare function createWeaverseNextStudioInternals(router: WeaverseNextRouterLike, options?: CreateWeaverseNextStudioInternalsOptions): WeaverseNextStudioInternals;
+//# sourceMappingURL=studio-router.d.ts.map

package/dist/types/next/studio-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-router.d.ts","sourceRoot":"","sources":["../../../src/next/studio-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,IAAI,EAAE,CACJ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,qDAAqD;QACrD,MAAM,CAAC,EAAE,OAAO,CAAA;KACjB,KACE,IAAI,CAAA;IACT,4DAA4D;IAC5D,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,iDAAiD;IACjD,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,qDAAqD;QACrD,MAAM,CAAC,EAAE,OAAO,CAAA;KACjB,KACE,IAAI,CAAA;CACV;AAED,4EAA4E;AAC5E,MAAM,WAAW,2BAA2B;IAC1C,sEAAsE;IACtE,QAAQ,EAAE,WAAW,CAAC,2BAA2B,CAAC,UAAU,CAAC,CAAC,CAAA;IAC9D,4CAA4C;IAC5C,UAAU,EAAE,WAAW,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC,CAAA;CACnE;AAED,kEAAkE;AAClE,MAAM,WAAW,wCAAwC;IACvD,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAWD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,wCAA6C,GACrD,2BAA2B,CAc7B"}

package/dist/types/next/studio-script-src.d.ts

@@ -0,0 +1,12 @@
+import type { WeaverseNextRequestContext } from './types';
+/** Trust context used when resolving a Studio bridge script URL. */
+export interface ResolveWeaverseNextStudioScriptSrcOptions {
+    /** Storefront hostname; required to permit loopback Studio origins. */
+    storefrontHostname?: string;
+}
+/**
+ * Resolve the Studio script URL from request/search context. `@weaverse/hydrogen/next`
+ * uses the dedicated Next bridge path served by Builder.
+ */
+export declare function resolveWeaverseNextStudioScriptSrc(context?: WeaverseNextRequestContext, options?: ResolveWeaverseNextStudioScriptSrcOptions): string | null;
+//# sourceMappingURL=studio-script-src.d.ts.map

package/dist/types/next/studio-script-src.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-script-src.d.ts","sourceRoot":"","sources":["../../../src/next/studio-script-src.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAmFzD,oEAAoE;AACpE,MAAM,WAAW,yCAAyC;IACxD,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,CAAC,EAAE,0BAA0B,EACpC,OAAO,GAAE,yCAA8C,GACtD,MAAM,GAAG,IAAI,CA+Bf"}

package/dist/types/next/theme-settings-store.d.ts

@@ -0,0 +1,18 @@
+import type { SchemaType } from '@weaverse/schema';
+import type { WeaverseNextThemeSchema, WeaverseNextThemeSettingsStore } from './types';
+/** Initial values for a root-scoped theme-settings store. */
+export interface CreateWeaverseNextThemeSettingsStoreOptions {
+    /** Public environment values exposed alongside the store. */
+    publicEnv?: Record<string, string | undefined>;
+    /** Theme schema associated with the settings. */
+    schema?: SchemaType | WeaverseNextThemeSchema;
+    /** Initial setting values. */
+    settings?: Record<string, unknown>;
+}
+/**
+ * Small external store shape compatible with the Studio bridge and React's
+ * `useSyncExternalStore` contract. The bridge calls `updateThemeSettings` during
+ * live theme edits, so keep that method name stable.
+ */
+export declare function createWeaverseNextThemeSettingsStore(options?: CreateWeaverseNextThemeSettingsStoreOptions): WeaverseNextThemeSettingsStore;
+//# sourceMappingURL=theme-settings-store.d.ts.map

package/dist/types/next/theme-settings-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-settings-store.d.ts","sourceRoot":"","sources":["../../../src/next/theme-settings-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EACV,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,SAAS,CAAA;AAEhB,6DAA6D;AAC7D,MAAM,WAAW,2CAA2C;IAC1D,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IAC9C,iDAAiD;IACjD,MAAM,CAAC,EAAE,UAAU,GAAG,uBAAuB,CAAA;IAC7C,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,GAAE,2CAAgD,GACxD,8BAA8B,CAuBhC"}

package/dist/types/next/translation-context.d.ts

@@ -0,0 +1,109 @@
+import { type ReactNode } from 'react';
+import { type TranslateFunction } from '../utils/translate';
+import type { TranslationStore } from '../utils/translation-store';
+/** Translation function and live override stores exposed by `useTranslation`. */
+export interface TranslationValue {
+    /** Active-locale translated keys loaded from the storefront API. */
+    merchantOverrides: Record<string, unknown> | null;
+    /**
+     * Translate a key with optional variable interpolation.
+     *
+     * Priority chain (highest wins):
+     * 1. External `t`        (passed into `WeaverseNextRootProvider` / `TranslationProvider`)
+     * 2. Design overrides   (live Builder edits from `TranslationStore`)
+     * 3. `merchantOverrides` (DB/API overrides for the current locale)
+     * 4. `staticContent`     (theme default JSON)
+     * 5. The key itself      (fallback)
+     *
+     * @example
+     * t('cart.title')                           // => "Cart"
+     * t('badge.sale', { percentage: 15 })       // => "-15% Off"
+     */
+    t: TranslateFunction;
+    /**
+     * Legacy name for the live design-mode translation store.
+     *
+     * @deprecated Migrate to {@link TranslationValue.translationStore}. This
+     * alias points at the same store instance.
+     */
+    themeTextStore: TranslationStore | null;
+    /** Exposed so the runtime/Studio bridge can attach it to `internal`. */
+    translationStore: TranslationStore | null;
+}
+/** Sources and content rendered by {@link TranslationProvider}. */
+export interface TranslationProviderProps {
+    /** React subtree that can call `useTranslation`. */
+    children: ReactNode;
+    /** Active-locale static-text overrides loaded from Weaverse. */
+    merchantOverrides?: Record<string, unknown>;
+    /** Default-locale static content from the theme schema. */
+    staticContent: Record<string, unknown>;
+    /**
+     * Optional external translation function.
+     * When provided it becomes the **highest-priority** source:
+     * if it returns a non-empty string that differs from the raw key,
+     * that value is used; otherwise the internal resolution chain continues.
+     */
+    t?: TranslateFunction;
+    /**
+     * Legacy prop name for the live translation store.
+     *
+     * @deprecated Migrate to {@link TranslationProviderProps.translationStore}.
+     * Still accepted for backward compatibility; ignored when `translationStore`
+     * is also provided.
+     */
+    themeTextStore?: TranslationStore | null;
+    /** Optional store for live design-mode text overrides from the builder. */
+    translationStore?: TranslationStore | null;
+}
+/**
+ * Provider that wraps the app to expose the `t()` function.
+ *
+ * - `staticContent`      – the theme's default locale JSON (from themeSchema.i18n)
+ * - `merchantOverrides`  – locale-specific overrides fetched from the API
+ * - `translationStore`   – optional store for live design-mode text overrides
+ *   (the deprecated `themeTextStore` prop is accepted as a fallback)
+ */
+export declare function TranslationProvider({ staticContent, merchantOverrides, t: externalT, translationStore, themeTextStore, children, }: TranslationProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the translation `t()` function.
+ *
+ * Must be used inside a component wrapped by `WeaverseNextRootProvider` or
+ * `TranslationProvider`.
+ *
+ * @example
+ * ```tsx
+ * function CartTitle() {
+ *   let { t } = useTranslation()
+ *   return <h2>{t('cart.title')}</h2>
+ * }
+ * ```
+ */
+export declare function useTranslation(): TranslationValue;
+/**
+ * Legacy name for {@link TranslationProvider}.
+ *
+ * @deprecated Replace `ThemeTextProvider` with {@link TranslationProvider};
+ * the props and runtime behavior are unchanged.
+ */
+export declare const ThemeTextProvider: typeof TranslationProvider;
+/**
+ * Legacy name for {@link useTranslation}.
+ *
+ * @deprecated Replace `useThemeText` with {@link useTranslation}; the return
+ * value is unchanged.
+ */
+export declare const useThemeText: typeof useTranslation;
+/**
+ * Legacy name for {@link TranslationValue}.
+ *
+ * @deprecated Import {@link TranslationValue} instead.
+ */
+export type ThemeTextValue = TranslationValue;
+/**
+ * Legacy name for {@link TranslationProviderProps}.
+ *
+ * @deprecated Import {@link TranslationProviderProps} instead.
+ */
+export type ThemeTextProviderProps = TranslationProviderProps;
+//# sourceMappingURL=translation-context.d.ts.map

package/dist/types/next/translation-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-context.d.ts","sourceRoot":"","sources":["../../../src/next/translation-context.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAA;AAC1E,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAMlE,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACjD;;;;;;;;;;;;;OAaG;IACH,CAAC,EAAE,iBAAiB,CAAA;IACpB;;;;;OAKG;IACH,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACvC,wEAAwE;IACxE,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAC1C;AAKD,mEAAmE;AACnE,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,QAAQ,EAAE,SAAS,CAAA;IACnB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3C,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC;;;;;OAKG;IACH,CAAC,CAAC,EAAE,iBAAiB,CAAA;IACrB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACxC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAC3C;AAUD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,aAAa,EACb,iBAAiB,EACjB,CAAC,EAAE,SAAS,EACZ,gBAAgB,EAChB,cAAc,EACd,QAAQ,GACT,EAAE,wBAAwB,2CAgC1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,CAQjD;AAMD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,4BAAsB,CAAA;AACpD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,uBAAiB,CAAA;AAC1C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAA;AAC7C;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,wBAAwB,CAAA"}