@weaverse/next 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/index.d.ts

@@ -1,250 +0,0 @@
-import { Weaverse } from '@weaverse/react';
-export { isBrowser, isIframe, useChildInstances, useItemInstance, useParentInstance, useWeaverse } from '@weaverse/react';
-export { InspectorGroup, PageType, SchemaType, createSchema } from '@weaverse/schema';
-import { d as WeaverseNextClientConfig, c as WeaverseNextClient, e as WeaverseNextCommerceContext, q as WeaverseNextRequestContext, n as WeaverseNextLoaderData, r as WeaverseNextRequestInfo, t as WeaverseNextRuntimeInternal, s as WeaverseNextRuntimeConfig, A as WeaverseNextThemeSettingsStore } from './types-DvEeLX6L.js';
-export { W as WeaverseCollection, f as WeaverseNextComponent, g as WeaverseNextComponentData, h as WeaverseNextComponentLoaderArgs, i as WeaverseNextComponentProps, l as WeaverseNextI18n, m as WeaverseNextLoadPageInput, o as WeaverseNextPageData, x as WeaverseNextStorefront, B as WeaverseProduct } from './types-DvEeLX6L.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as react from 'react';
-import { ReactNode } from 'react';
-
-/**
- * Create a {@link WeaverseNextClient} from explicit config.
- *
- * @example
- * ```ts
- * let client = createWeaverseNextClient({
- *   projectId: process.env.WEAVERSE_PROJECT_ID!,
- *   components,
- *   commerce: { storefront },
- *   fetchPage: async ({ type, handle }) => fetchWeaversePage({ type, handle }),
- * })
- * ```
- */
-declare function createWeaverseNextClient(config: WeaverseNextClientConfig): WeaverseNextClient;
-
-/**
- * Read explicit root/global data passed to the provider. Next-native
- * replacement for `useRouteLoaderData('root')`.
- */
-declare function useWeaverseRootData<T = unknown>(): T;
-/**
- * Read explicit page/route commerce data passed to the provider. Next-native
- * replacement for section-level `useLoaderData()`.
- */
-declare function useWeaversePageData<T = unknown>(): T;
-/** Read the app-provided commerce context (storefront/cart/customer). */
-declare function useWeaverseCommerce<T = WeaverseNextCommerceContext>(): T;
-/**
- * Read live Weaverse theme settings. The Studio bridge updates the provider's
- * external store via `updateThemeSettings`, so components re-render during live
- * design-mode edits.
- */
-declare function useThemeSettings<T = Record<string, unknown>>(): T;
-
-interface RunComponentLoadersArgs {
-    client: WeaverseNextClient;
-    commerce?: WeaverseNextCommerceContext;
-    context?: WeaverseNextRequestContext;
-    /** Page payload to walk; defaults to `client.data`. */
-    data?: WeaverseNextLoaderData | null;
-}
-/**
- * Walk a serialized page tree and run each registered component's `loader`,
- * attaching the result to the item as `loaderData`.
- *
- * Loaders receive explicit `commerce.storefront` (and `weaverse.storefront` as
- * a compatibility alias via the client). Children are walked recursively when
- * they are inline item objects; flat `items` arrays are covered by the
- * top-level walk.
- *
- * @returns a cloned `data` object with `loaderData` attached to cloned items.
- */
-declare function runWeaverseComponentLoaders(args: RunComponentLoadersArgs): Promise<WeaverseNextLoaderData | null>;
-
-interface WeaverseNextProviderProps {
-    children: ReactNode;
-    client?: WeaverseNextClient;
-    /** App-provided commerce context (storefront/cart/customer). */
-    commerce?: WeaverseNextCommerceContext;
-    /** Explicit page/route commerce data (replaces section-level `useLoaderData`). */
-    pageData?: unknown;
-    /** Explicit root/global data (replaces `useRouteLoaderData('root')`). */
-    rootData?: unknown;
-    /** Theme settings override; falls back to `client.themeSettings`. */
-    themeSettings?: Record<string, unknown>;
-}
-/**
- * Client boundary that supplies explicit root/page/commerce data to Weaverse
- * sections. Next-native replacement for `withWeaverse` + route loader data —
- * no React Router route matches are emulated.
- *
- * In App Router, create/pass `client` only from a client component wrapper. A
- * `WeaverseNextClient` contains functions and component references, so it is
- * not serializable across a Server Component → Client Component boundary.
- *
- * @example
- * ```tsx
- * 'use client'
- *
- * <WeaverseNextProvider client={client} rootData={rootData} pageData={pageData} commerce={commerce}>
- *   <WeaverseNextRenderer />
- * </WeaverseNextProvider>
- * ```
- */
-declare function WeaverseNextProvider(props: WeaverseNextProviderProps): react_jsx_runtime.JSX.Element;
-
-interface WeaverseNextRendererProps {
-    /** Client to render from. Defaults to the provider's client. */
-    client?: WeaverseNextClient;
-    /** Page payload to render. Defaults to `client.data`. */
-    data?: WeaverseNextLoaderData | null;
-    /** Data-connector context for `{{...}}` template replacement. */
-    dataContext?: Record<string, unknown>;
-}
-/**
- * Render a serialized Weaverse page tree through `@weaverse/react` primitives.
- *
- * Reads the client/page data from {@link WeaverseNextContext} when no props are
- * passed, or accepts an explicit `client` + `data` for standalone use. Builds a
- * framework-neutral `Weaverse` core instance (no React Router hooks) and hands
- * it to the shared `WeaverseRoot`.
- */
-declare const WeaverseNextRenderer: react.MemoExoticComponent<(props: WeaverseNextRendererProps) => react_jsx_runtime.JSX.Element | null>;
-
-/**
- * Build the Hydrogen-like request info shape consumed by the Studio bridge.
- * Duplicate query keys keep the last value, matching `URLSearchParams` iteration
- * assignment and Hydrogen's practical query-object behavior.
- */
-declare function buildWeaverseNextRequestInfo(context?: WeaverseNextRequestContext): WeaverseNextRequestInfo;
-
-declare global {
-    interface Window {
-        __weaverse?: WeaverseNextRuntime;
-        __weaverses?: Record<string, WeaverseNextRuntime>;
-    }
-}
-declare class WeaverseNextRuntime extends Weaverse {
-    pageId: string;
-    internal: WeaverseNextRuntimeInternal;
-    requestInfo: WeaverseNextRequestInfo;
-    isPreviewMode: boolean;
-    isRevisionPreview: boolean;
-    sectionType?: string;
-    translationMap: Record<string, unknown>;
-    translationLocale: string;
-    translationLanguageId: string;
-    constructor(config: WeaverseNextRuntimeConfig);
-    extractTranslationSidecar: () => undefined;
-    setTranslationSidecar: (map?: Record<string, unknown>, locale?: string, languageId?: string) => void;
-    updateTranslation: () => undefined;
-    getTranslationChanges: () => undefined;
-}
-declare function createWeaverseNextRuntime(config: WeaverseNextRuntimeConfig): WeaverseNextRuntime;
-declare function bindWeaverseNextStudioRuntime(runtime: WeaverseNextRuntime): boolean;
-
-interface WeaverseNextStudioBridgeProps {
-    navigate?: WeaverseNextRuntimeInternal['navigate'];
-    revalidate?: WeaverseNextRuntimeInternal['revalidate'];
-    runtime: WeaverseNextRuntime;
-}
-/** Page-level Studio runtime binder. */
-declare function WeaverseNextStudioBridge(props: WeaverseNextStudioBridgeProps): null;
-
-interface WeaverseNextStudioConnectProps {
-    context?: WeaverseNextRequestContext;
-    storefrontHostname?: string;
-}
-/** Root-level Studio script connector for Next client boundaries. */
-declare function WeaverseNextStudioConnect(props: WeaverseNextStudioConnectProps): null;
-
-/**
- * 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.
- */
-interface WeaverseNextRouterLike {
-    push: (href: string, options?: {
-        scroll?: boolean;
-    }) => void;
-    refresh: () => void;
-    replace: (href: string, options?: {
-        scroll?: boolean;
-    }) => void;
-}
-/** Resolved Studio navigation/revalidation callbacks for a Next runtime. */
-interface WeaverseNextStudioInternals {
-    navigate: NonNullable<WeaverseNextRuntimeInternal['navigate']>;
-    revalidate: NonNullable<WeaverseNextRuntimeInternal['revalidate']>;
-}
-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.
- */
-declare function createWeaverseNextStudioInternals(router: WeaverseNextRouterLike, options?: CreateWeaverseNextStudioInternalsOptions): WeaverseNextStudioInternals;
-
-interface ResolveWeaverseNextStudioScriptSrcOptions {
-    framework?: 'hydrogen' | 'next';
-    storefrontHostname?: string;
-}
-/**
- * Resolve the Studio script URL from request/search context. v0 intentionally
- * reuses the existing structural Hydrogen bridge script until a concrete Builder
- * incompatibility requires a dedicated Next bundle.
- */
-declare function resolveWeaverseNextStudioScriptSrc(context?: WeaverseNextRequestContext, options?: ResolveWeaverseNextStudioScriptSrcOptions): string | null;
-
-interface CreateWeaverseNextThemeSettingsStoreOptions {
-    publicEnv?: Record<string, string | undefined>;
-    schema?: unknown;
-    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.
- */
-declare function createWeaverseNextThemeSettingsStore(options?: CreateWeaverseNextThemeSettingsStoreOptions): WeaverseNextThemeSettingsStore;
-
-/**
- * Resolve stable Studio `navigate` / `revalidate` callbacks from the Next App
- * Router. `useRouter()` is stable across renders, but the derived callbacks are
- * cached in a ref keyed on the router instance so the bridge's bind effect
- * (which depends on `navigate` / `revalidate` identity) doesn't re-run — and
- * re-`refreshStudio` — on every render.
- */
-declare function useWeaverseNextStudioInternals(options?: CreateWeaverseNextStudioInternalsOptions): WeaverseNextStudioInternals;
-interface WeaverseNextStudioProps extends CreateWeaverseNextStudioInternalsOptions {
-    runtime: WeaverseNextRuntime;
-}
-/**
- * Page-level Studio binder wired to the Next App Router. Mirrors Hydrogen's
- * `useStudio` (which binds the runtime and feeds it React Router's `navigate` /
- * `revalidate`): it resolves the App Router callbacks via
- * {@link useWeaverseNextStudioInternals} and hands them to
- * {@link WeaverseNextStudioBridge}, so consuming apps get Studio navigation and
- * revalidation without manually wiring `next/navigation`.
- *
- * Client-only — it is the single place `@weaverse/next` touches
- * `next/navigation`, keeping the runtime/renderer and `@weaverse/next/server`
- * free of router imports.
- */
-declare function WeaverseNextStudio(props: WeaverseNextStudioProps): react_jsx_runtime.JSX.Element;
-
-export { type CreateWeaverseNextStudioInternalsOptions, type CreateWeaverseNextThemeSettingsStoreOptions, type ResolveWeaverseNextStudioScriptSrcOptions, type RunComponentLoadersArgs, WeaverseNextClient, WeaverseNextClientConfig, WeaverseNextCommerceContext, WeaverseNextLoaderData, WeaverseNextProvider, type WeaverseNextProviderProps, WeaverseNextRenderer, type WeaverseNextRendererProps, WeaverseNextRequestContext, WeaverseNextRequestInfo, type WeaverseNextRouterLike, WeaverseNextRuntime, WeaverseNextRuntimeConfig, WeaverseNextRuntimeInternal, WeaverseNextStudio, WeaverseNextStudioBridge, type WeaverseNextStudioBridgeProps, WeaverseNextStudioConnect, type WeaverseNextStudioConnectProps, type WeaverseNextStudioInternals, type WeaverseNextStudioProps, WeaverseNextThemeSettingsStore, bindWeaverseNextStudioRuntime, buildWeaverseNextRequestInfo, createWeaverseNextClient, createWeaverseNextRuntime, createWeaverseNextStudioInternals, createWeaverseNextThemeSettingsStore, resolveWeaverseNextStudioScriptSrc, runWeaverseComponentLoaders, useThemeSettings, useWeaverseCommerce, useWeaverseNextStudioInternals, useWeaversePageData, useWeaverseRootData };

package/dist/server.d.mts

@@ -1,60 +0,0 @@
-import { q as WeaverseNextRequestContext, a as WeaverseNextBaseConfigs, v as WeaverseNextServerClientConfig, u as WeaverseNextServerClient } from './types-DvEeLX6L.mjs';
-export { b as WeaverseNextCacheConfig, j as WeaverseNextConfigs, k as WeaverseNextFetchOptions, p as WeaverseNextProjectId, w as WeaverseNextServerLoadPageInput, y as WeaverseNextThemeSettingsOptions, z as WeaverseNextThemeSettingsResponse } from './types-DvEeLX6L.mjs';
-import '@weaverse/react';
-import '@weaverse/schema';
-import 'react';
-
-interface ResolveConfigsOptions {
-    env?: Record<string, string | undefined>;
-    weaverseApiBase?: string;
-    weaverseHost?: string;
-    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.
- */
-declare function getWeaverseNextConfigs(context?: WeaverseNextRequestContext, options?: ResolveConfigsOptions): WeaverseNextBaseConfigs;
-
-/**
- * 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).
- */
-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}.
- */
-declare function resolveRequestUrl(context?: WeaverseNextRequestContext): string;
-
-/**
- * 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()
- * ```
- */
-declare function createWeaverseNextServerClient(config: WeaverseNextServerClientConfig): WeaverseNextServerClient;
-
-export { WeaverseNextBaseConfigs, WeaverseNextServerClient, WeaverseNextServerClientConfig, createWeaverseNextServerClient, getWeaverseNextConfigs, normalizeNextPageUrl, resolveRequestUrl };

package/dist/server.d.ts

@@ -1,60 +0,0 @@
-import { q as WeaverseNextRequestContext, a as WeaverseNextBaseConfigs, v as WeaverseNextServerClientConfig, u as WeaverseNextServerClient } from './types-DvEeLX6L.js';
-export { b as WeaverseNextCacheConfig, j as WeaverseNextConfigs, k as WeaverseNextFetchOptions, p as WeaverseNextProjectId, w as WeaverseNextServerLoadPageInput, y as WeaverseNextThemeSettingsOptions, z as WeaverseNextThemeSettingsResponse } from './types-DvEeLX6L.js';
-import '@weaverse/react';
-import '@weaverse/schema';
-import 'react';
-
-interface ResolveConfigsOptions {
-    env?: Record<string, string | undefined>;
-    weaverseApiBase?: string;
-    weaverseHost?: string;
-    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.
- */
-declare function getWeaverseNextConfigs(context?: WeaverseNextRequestContext, options?: ResolveConfigsOptions): WeaverseNextBaseConfigs;
-
-/**
- * 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).
- */
-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}.
- */
-declare function resolveRequestUrl(context?: WeaverseNextRequestContext): string;
-
-/**
- * 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()
- * ```
- */
-declare function createWeaverseNextServerClient(config: WeaverseNextServerClientConfig): WeaverseNextServerClient;
-
-export { WeaverseNextBaseConfigs, WeaverseNextServerClient, WeaverseNextServerClientConfig, createWeaverseNextServerClient, getWeaverseNextConfigs, normalizeNextPageUrl, resolveRequestUrl };