@weaverse/next 0.1.0-alpha.1 → 0.1.0-alpha.11

package/dist/{types-DvEeLX6L.d.mts → seo-CgO21rLg.d.mts}

@@ -1,7 +1,42 @@
+import { PageType, InspectorGroup, PageSEOData, SchemaType } from '@weaverse/schema';
 import { WeaverseElement, WeaverseResourcePickerData } from '@weaverse/react';
-import { PageType, SchemaType } from '@weaverse/schema';
 import { ReactNode, ComponentType, ForwardRefExoticComponent } from 'react';
 
+/**
+ * Minimal mutable store for design-mode static text overrides.
+ *
+ * `useSyncExternalStore`-compatible. Passed into {@link TranslationProvider}
+ * (from `./translation-context`) which subscribes internally and layers
+ * overrides on top of `merchantOverrides`/`staticContent`. The Studio bridge
+ * calls `updateOverrides()` via `runtime.internal.translationStore` (also
+ * exposed as the deprecated `runtime.internal.themeTextStore` alias) so live
+ * static-text edits reach the runtime — identical surface to Hydrogen's store,
+ * so Builder's existing static-text RPC works with `@weaverse/next` unchanged.
+ *
+ * Shape: flat `Record<string, string>` — dot-notation keys map to values
+ * (e.g. "cart.title" → "Shopping Cart").
+ */
+declare class TranslationStore {
+    overrides: Record<string, string>;
+    private readonly listeners;
+    setOverrides: (overrides: Record<string, string>) => void;
+    updateOverrides: (newOverrides: Record<string, string>) => void;
+    getSnapshot: () => Record<string, string>;
+    getServerSnapshot: () => Record<string, string>;
+    subscribe: (callback: () => void) => () => void;
+    private readonly emit;
+}
+/**
+ * @deprecated Use {@link TranslationStore} instead. Kept as a backward-compatible
+ * alias and will remain exported for existing integrations.
+ */
+declare const ThemeTextStore: typeof TranslationStore;
+/**
+ * @deprecated Use {@link TranslationStore} instead. Kept as a backward-compatible
+ * alias and will remain exported for existing integrations.
+ */
+type ThemeTextStore = TranslationStore;
+
 interface WeaverseNextRequestInfo {
     i18n?: WeaverseNextI18n;
     pathname: string;
@@ -12,27 +47,101 @@ interface WeaverseNextThemeSettingsStore {
     getServerSnapshot: () => Record<string, unknown>;
     getSnapshot: () => Record<string, unknown>;
     publicEnv?: Record<string, string | undefined>;
-    schema?: unknown;
+    schema?: WeaverseNextThemeSchema;
     settings: Record<string, unknown>;
     subscribe: (listener: () => void) => () => void;
     updateThemeSettings: (next: Record<string, unknown>) => void;
 }
+/**
+ * Page assignment payload returned by `/api/public/project` and preserved on
+ * loader data so the Builder Studio save pipeline receives the same shape it
+ * gets from Hydrogen (`{ projectId, type, locale, handle }`, plus optional
+ * inherited/fallback `meta`). Kept framework-neutral: `type` accepts a known
+ * {@link PageType} or any string, and `meta` preserves inherited/fallback
+ * metadata (unknown fields included) without asserting a strict shape.
+ */
+interface WeaverseNextPageAssignment {
+    handle: string;
+    locale: string;
+    /** Inherited/fallback page metadata; unknown fields preserved as-is. */
+    meta?: {
+        depth?: number;
+        inherited?: boolean;
+        sourceProjectId?: string;
+        [key: string]: unknown;
+    };
+    projectId: string;
+    type: PageType | string;
+}
 interface WeaverseNextRuntimeInternal {
+    /** Active-locale static-text overrides fetched from the API (nested). */
+    merchantOverrides?: Record<string, unknown>;
     navigate?: (to: string, options?: {
         preventScrollReset?: boolean;
     } | Record<string, unknown>) => void;
-    pageAssignment?: unknown;
+    pageAssignment?: WeaverseNextPageAssignment;
     project?: unknown;
     revalidate?: (options?: unknown) => Promise<void> | void;
+    /**
+     * Studio per-item loader revalidation. Builder feature-detects this and
+     * prefers it over the legacy `revalidate()` (`router.refresh()`) flow; it
+     * must reject on failure so Builder can fall back.
+     */
+    revalidateItem?: (draftItem: WeaverseNextComponentData) => Promise<void>;
     themeSettingsStore?: WeaverseNextThemeSettingsStore;
+    /**
+     * @deprecated Use {@link WeaverseNextRuntimeInternal.translationStore}
+     * instead. Same instance, kept so Builder's existing `updateStaticText()`
+     * RPC (which reads `internal.themeTextStore`) works with Next unchanged.
+     */
+    themeTextStore?: TranslationStore;
+    /**
+     * Live design-mode static-text override store. Builder's `updateStaticText()`
+     * RPC mutates it via `updateOverrides()`; the `TranslationProvider` observing
+     * the same instance re-renders `useTranslation()` consumers.
+     */
+    translationStore?: TranslationStore;
 }
 interface WeaverseNextRuntimeConfig {
     client?: WeaverseNextClient;
     data: WeaverseNextLoaderData;
     dataContext?: Record<string, unknown>;
+    /** Active-locale static-text overrides threaded onto `internal`. */
+    merchantOverrides?: Record<string, unknown>;
     navigate?: WeaverseNextRuntimeInternal['navigate'];
     revalidate?: WeaverseNextRuntimeInternal['revalidate'];
     themeSettingsStore?: WeaverseNextThemeSettingsStore;
+    /** Root/route-owned translation store to attach to `internal`. */
+    translationStore?: TranslationStore;
+}
+/** A single translated field for one item. */
+interface WeaverseNextTranslationMapEntry {
+    originalValue: string;
+    translatedValue: string;
+}
+/** Per-item translation fields, keyed by field name. */
+interface WeaverseNextTranslationItemEntry {
+    [key: string]: WeaverseNextTranslationMapEntry;
+}
+/**
+ * Translation map sent from Builder alongside page data in design mode.
+ * Keyed by item ID, each value maps field names to translation entries.
+ */
+interface WeaverseNextTranslationMap {
+    [itemId: string]: WeaverseNextTranslationItemEntry;
+}
+/** A single translation entry for save payloads. */
+interface WeaverseNextTranslationEntry {
+    deleted?: boolean;
+    itemId: string;
+    key: string;
+    originalValue: string;
+    translatedValue: string;
+}
+/** Result of collecting translation changes for the save flow. */
+interface WeaverseNextTranslationChanges {
+    entries: WeaverseNextTranslationEntry[];
+    languageId: string;
 }
 /**
  * Locale/market info passed through to component loaders and the Storefront
@@ -48,6 +157,46 @@ interface WeaverseNextI18n {
     pathPrefix?: string;
     [key: string]: unknown;
 }
+/**
+ * Theme schema shape accepted by the Next adapter. Mirrors Hydrogen's
+ * `HydrogenThemeSchema` but keeps locale data framework-neutral via
+ * {@link WeaverseNextI18n} instead of Shopify Hydrogen's `I18nBase`.
+ */
+interface WeaverseNextThemeSchemaInput {
+    condition?: unknown;
+    defaultValue?: unknown;
+    name?: string;
+    [key: string]: unknown;
+}
+interface WeaverseNextThemeSchemaGroup {
+    group?: string;
+    inputs?: WeaverseNextThemeSchemaInput[];
+    [key: string]: unknown;
+}
+interface WeaverseNextThemeSchema {
+    i18n?: {
+        defaultLocale?: WeaverseNextI18n;
+        shopLocales?: WeaverseNextI18n[];
+        staticContent?: Record<string, unknown>;
+        /** Enable the translation UI in Builder. */
+        translation?: boolean;
+        urlStructure?: 'url-path' | 'subdomain' | 'top-level-domain';
+        [key: string]: unknown;
+    };
+    info?: {
+        author?: string;
+        authorProfilePhoto?: string;
+        documentationUrl?: string;
+        name?: string;
+        supportUrl?: string;
+        version?: string;
+        [key: string]: unknown;
+    };
+    /** @deprecated Use settings instead. */
+    inspector?: (InspectorGroup | WeaverseNextThemeSchemaGroup)[];
+    settings?: (InspectorGroup | WeaverseNextThemeSchemaGroup)[];
+    [key: string]: unknown;
+}
 /**
  * Minimal Storefront client shape required by component loaders. The host app
  * provides this (public or private token mode); Weaverse never owns it.
@@ -104,6 +253,8 @@ interface WeaverseNextPageData {
     items: WeaverseNextComponentData[];
     name?: string;
     rootId?: string;
+    /** Page-level SEO metadata published by Weaverse Builder. */
+    seo?: PageSEOData | null;
     [key: string]: unknown;
 }
 /**
@@ -113,7 +264,7 @@ interface WeaverseNextPageData {
 interface WeaverseNextLoaderData {
     configs?: Record<string, unknown>;
     page: WeaverseNextPageData;
-    pageAssignment?: Record<string, unknown>;
+    pageAssignment?: WeaverseNextPageAssignment;
     project?: Record<string, unknown>;
     [key: string]: unknown;
 }
@@ -160,7 +311,7 @@ interface WeaverseNextClientConfig {
     fetchThemeSettings?: (context?: WeaverseNextRequestContext) => Promise<unknown>;
     projectId: string;
     requestContext?: WeaverseNextRequestContext;
-    themeSchema?: unknown;
+    themeSchema?: WeaverseNextThemeSchema;
     themeSettings?: Record<string, unknown>;
 }
 /**
@@ -181,11 +332,14 @@ interface WeaverseNextClient {
     requestContext?: WeaverseNextRequestContext;
     /** Compatibility alias for `commerce.storefront`. */
     storefront?: WeaverseNextStorefront;
-    themeSchema?: unknown;
+    themeSchema?: WeaverseNextThemeSchema;
     themeSettings: Record<string, unknown>;
 }
 type WeaverseProduct = WeaverseResourcePickerData;
 type WeaverseCollection = WeaverseResourcePickerData;
+type WeaverseBlog = WeaverseResourcePickerData;
+type WeaverseArticle = WeaverseResourcePickerData;
+type WeaverseMetaObject = WeaverseResourcePickerData;
 /**
  * Project identifier accepted by {@link WeaverseNextServerClientConfig}. Either
  * a static string or a (possibly async) resolver that reads the request
@@ -249,7 +403,7 @@ interface WeaverseNextThemeSettingsResponse {
     _loadFailed?: boolean;
     merchantOverrides?: Record<string, unknown>;
     publicEnv?: Record<string, string | undefined>;
-    schema?: unknown;
+    schema?: WeaverseNextThemeSchema;
     staticContent?: Record<string, unknown>;
     theme?: Record<string, unknown>;
     [key: string]: unknown;
@@ -261,6 +415,18 @@ interface WeaverseNextThemeSettingsResponse {
  */
 interface WeaverseNextThemeSettingsOptions extends WeaverseNextCacheConfig {
 }
+interface WeaverseNextCustomPageEntry {
+    changeFrequency?: 'daily' | 'weekly' | 'monthly';
+    handle: string;
+    lastModified: string;
+    locale: string | null;
+    path: string;
+    priority?: number;
+}
+interface WeaverseNextFetchCustomPagesOptions extends WeaverseNextCacheConfig {
+    limit?: number;
+    locale?: string;
+}
 /**
  * Config for {@link createWeaverseNextServerClient}. Unlike
  * {@link WeaverseNextClientConfig} (which delegates network I/O to injected
@@ -279,7 +445,7 @@ interface WeaverseNextServerClientConfig {
     fetchTimeoutMs?: number;
     projectId?: WeaverseNextProjectId;
     requestContext?: WeaverseNextRequestContext;
-    themeSchema?: unknown;
+    themeSchema?: WeaverseNextThemeSchema;
     themeSettings?: Record<string, unknown>;
     /** Optional override for the resolved Weaverse public API base. */
     weaverseApiBase?: string;
@@ -297,6 +463,7 @@ interface WeaverseNextServerClientConfig {
 interface WeaverseNextServerClient extends WeaverseNextClient {
     /** Public, client-safe resolved configs (no server secrets). */
     configs: WeaverseNextConfigs;
+    fetchCustomPages: (options?: WeaverseNextFetchCustomPagesOptions) => Promise<WeaverseNextCustomPageEntry[]>;
     fetchWithCache: <T = unknown>(url: string, options?: WeaverseNextFetchOptions) => Promise<T>;
     loadPage: (input?: WeaverseNextLoadPageInput) => Promise<WeaverseNextLoaderData | null>;
     /**
@@ -318,4 +485,33 @@ interface WeaverseNextServerLoadPageInput extends WeaverseNextLoadPageInput {
     projectId?: string;
 }
 
-export type { WeaverseNextThemeSettingsStore as A, WeaverseProduct as B, WeaverseCollection as W, WeaverseNextBaseConfigs as a, WeaverseNextCacheConfig as b, WeaverseNextClient as c, WeaverseNextClientConfig as d, WeaverseNextCommerceContext as e, WeaverseNextComponent as f, WeaverseNextComponentData as g, WeaverseNextComponentLoaderArgs as h, WeaverseNextComponentProps as i, WeaverseNextConfigs as j, WeaverseNextFetchOptions as k, WeaverseNextI18n as l, WeaverseNextLoadPageInput as m, WeaverseNextLoaderData as n, WeaverseNextPageData as o, WeaverseNextProjectId as p, WeaverseNextRequestContext as q, WeaverseNextRequestInfo as r, WeaverseNextRuntimeConfig as s, WeaverseNextRuntimeInternal as t, WeaverseNextServerClient as u, WeaverseNextServerClientConfig as v, WeaverseNextServerLoadPageInput as w, WeaverseNextStorefront as x, WeaverseNextThemeSettingsOptions as y, WeaverseNextThemeSettingsResponse as z };
+interface WeaverseNextSeoMetadata {
+    alternates?: {
+        canonical?: string;
+    };
+    description?: string;
+    keywords?: string;
+    openGraph?: {
+        description?: string;
+        images?: string[];
+        title?: string;
+        type?: string;
+    };
+    robots: {
+        follow: boolean;
+        index: boolean;
+    };
+    title?: string;
+    twitter?: {
+        card?: string;
+        description?: string;
+        images?: string[];
+        title?: string;
+    };
+}
+declare function formatWeaverseNextSeoMetadata(seo: PageSEOData | null | undefined): WeaverseNextSeoMetadata;
+declare function getWeaverseNextSeoMetadata(data: WeaverseNextLoaderData | WeaverseNextPageData | {
+    page?: WeaverseNextPageData | null;
+} | null | undefined): WeaverseNextSeoMetadata;
+
+export { type WeaverseNextRuntimeInternal as A, type WeaverseNextSeoMetadata as B, type WeaverseNextServerClient as C, type WeaverseNextServerClientConfig as D, type WeaverseNextServerLoadPageInput as E, type WeaverseNextStorefront as F, type WeaverseNextThemeSchema as G, type WeaverseNextThemeSettingsOptions as H, type WeaverseNextThemeSettingsResponse as I, type WeaverseNextThemeSettingsStore as J, type WeaverseNextTranslationChanges as K, type WeaverseNextTranslationEntry as L, type WeaverseNextTranslationItemEntry as M, type WeaverseNextTranslationMap as N, type WeaverseNextTranslationMapEntry as O, type WeaverseProduct as P, formatWeaverseNextSeoMetadata as Q, getWeaverseNextSeoMetadata as R, ThemeTextStore as T, type WeaverseArticle as W, TranslationStore as a, type WeaverseBlog as b, type WeaverseCollection as c, type WeaverseMetaObject as d, type WeaverseNextBaseConfigs as e, type WeaverseNextCacheConfig as f, type WeaverseNextClient as g, type WeaverseNextClientConfig as h, type WeaverseNextCommerceContext as i, type WeaverseNextComponent as j, type WeaverseNextComponentData as k, type WeaverseNextComponentLoaderArgs as l, type WeaverseNextComponentProps as m, type WeaverseNextConfigs as n, type WeaverseNextCustomPageEntry as o, type WeaverseNextFetchCustomPagesOptions as p, type WeaverseNextFetchOptions as q, type WeaverseNextI18n as r, type WeaverseNextLoadPageInput as s, type WeaverseNextLoaderData as t, type WeaverseNextPageAssignment as u, type WeaverseNextPageData as v, type WeaverseNextProjectId as w, type WeaverseNextRequestContext as x, type WeaverseNextRequestInfo as y, type WeaverseNextRuntimeConfig as z };

package/dist/{types-DvEeLX6L.d.ts → seo-CgO21rLg.d.ts}

@@ -1,7 +1,42 @@
+import { PageType, InspectorGroup, PageSEOData, SchemaType } from '@weaverse/schema';
 import { WeaverseElement, WeaverseResourcePickerData } from '@weaverse/react';
-import { PageType, SchemaType } from '@weaverse/schema';
 import { ReactNode, ComponentType, ForwardRefExoticComponent } from 'react';
 
+/**
+ * Minimal mutable store for design-mode static text overrides.
+ *
+ * `useSyncExternalStore`-compatible. Passed into {@link TranslationProvider}
+ * (from `./translation-context`) which subscribes internally and layers
+ * overrides on top of `merchantOverrides`/`staticContent`. The Studio bridge
+ * calls `updateOverrides()` via `runtime.internal.translationStore` (also
+ * exposed as the deprecated `runtime.internal.themeTextStore` alias) so live
+ * static-text edits reach the runtime — identical surface to Hydrogen's store,
+ * so Builder's existing static-text RPC works with `@weaverse/next` unchanged.
+ *
+ * Shape: flat `Record<string, string>` — dot-notation keys map to values
+ * (e.g. "cart.title" → "Shopping Cart").
+ */
+declare class TranslationStore {
+    overrides: Record<string, string>;
+    private readonly listeners;
+    setOverrides: (overrides: Record<string, string>) => void;
+    updateOverrides: (newOverrides: Record<string, string>) => void;
+    getSnapshot: () => Record<string, string>;
+    getServerSnapshot: () => Record<string, string>;
+    subscribe: (callback: () => void) => () => void;
+    private readonly emit;
+}
+/**
+ * @deprecated Use {@link TranslationStore} instead. Kept as a backward-compatible
+ * alias and will remain exported for existing integrations.
+ */
+declare const ThemeTextStore: typeof TranslationStore;
+/**
+ * @deprecated Use {@link TranslationStore} instead. Kept as a backward-compatible
+ * alias and will remain exported for existing integrations.
+ */
+type ThemeTextStore = TranslationStore;
+
 interface WeaverseNextRequestInfo {
     i18n?: WeaverseNextI18n;
     pathname: string;
@@ -12,27 +47,101 @@ interface WeaverseNextThemeSettingsStore {
     getServerSnapshot: () => Record<string, unknown>;
     getSnapshot: () => Record<string, unknown>;
     publicEnv?: Record<string, string | undefined>;
-    schema?: unknown;
+    schema?: WeaverseNextThemeSchema;
     settings: Record<string, unknown>;
     subscribe: (listener: () => void) => () => void;
     updateThemeSettings: (next: Record<string, unknown>) => void;
 }
+/**
+ * Page assignment payload returned by `/api/public/project` and preserved on
+ * loader data so the Builder Studio save pipeline receives the same shape it
+ * gets from Hydrogen (`{ projectId, type, locale, handle }`, plus optional
+ * inherited/fallback `meta`). Kept framework-neutral: `type` accepts a known
+ * {@link PageType} or any string, and `meta` preserves inherited/fallback
+ * metadata (unknown fields included) without asserting a strict shape.
+ */
+interface WeaverseNextPageAssignment {
+    handle: string;
+    locale: string;
+    /** Inherited/fallback page metadata; unknown fields preserved as-is. */
+    meta?: {
+        depth?: number;
+        inherited?: boolean;
+        sourceProjectId?: string;
+        [key: string]: unknown;
+    };
+    projectId: string;
+    type: PageType | string;
+}
 interface WeaverseNextRuntimeInternal {
+    /** Active-locale static-text overrides fetched from the API (nested). */
+    merchantOverrides?: Record<string, unknown>;
     navigate?: (to: string, options?: {
         preventScrollReset?: boolean;
     } | Record<string, unknown>) => void;
-    pageAssignment?: unknown;
+    pageAssignment?: WeaverseNextPageAssignment;
     project?: unknown;
     revalidate?: (options?: unknown) => Promise<void> | void;
+    /**
+     * Studio per-item loader revalidation. Builder feature-detects this and
+     * prefers it over the legacy `revalidate()` (`router.refresh()`) flow; it
+     * must reject on failure so Builder can fall back.
+     */
+    revalidateItem?: (draftItem: WeaverseNextComponentData) => Promise<void>;
     themeSettingsStore?: WeaverseNextThemeSettingsStore;
+    /**
+     * @deprecated Use {@link WeaverseNextRuntimeInternal.translationStore}
+     * instead. Same instance, kept so Builder's existing `updateStaticText()`
+     * RPC (which reads `internal.themeTextStore`) works with Next unchanged.
+     */
+    themeTextStore?: TranslationStore;
+    /**
+     * Live design-mode static-text override store. Builder's `updateStaticText()`
+     * RPC mutates it via `updateOverrides()`; the `TranslationProvider` observing
+     * the same instance re-renders `useTranslation()` consumers.
+     */
+    translationStore?: TranslationStore;
 }
 interface WeaverseNextRuntimeConfig {
     client?: WeaverseNextClient;
     data: WeaverseNextLoaderData;
     dataContext?: Record<string, unknown>;
+    /** Active-locale static-text overrides threaded onto `internal`. */
+    merchantOverrides?: Record<string, unknown>;
     navigate?: WeaverseNextRuntimeInternal['navigate'];
     revalidate?: WeaverseNextRuntimeInternal['revalidate'];
     themeSettingsStore?: WeaverseNextThemeSettingsStore;
+    /** Root/route-owned translation store to attach to `internal`. */
+    translationStore?: TranslationStore;
+}
+/** A single translated field for one item. */
+interface WeaverseNextTranslationMapEntry {
+    originalValue: string;
+    translatedValue: string;
+}
+/** Per-item translation fields, keyed by field name. */
+interface WeaverseNextTranslationItemEntry {
+    [key: string]: WeaverseNextTranslationMapEntry;
+}
+/**
+ * Translation map sent from Builder alongside page data in design mode.
+ * Keyed by item ID, each value maps field names to translation entries.
+ */
+interface WeaverseNextTranslationMap {
+    [itemId: string]: WeaverseNextTranslationItemEntry;
+}
+/** A single translation entry for save payloads. */
+interface WeaverseNextTranslationEntry {
+    deleted?: boolean;
+    itemId: string;
+    key: string;
+    originalValue: string;
+    translatedValue: string;
+}
+/** Result of collecting translation changes for the save flow. */
+interface WeaverseNextTranslationChanges {
+    entries: WeaverseNextTranslationEntry[];
+    languageId: string;
 }
 /**
  * Locale/market info passed through to component loaders and the Storefront
@@ -48,6 +157,46 @@ interface WeaverseNextI18n {
     pathPrefix?: string;
     [key: string]: unknown;
 }
+/**
+ * Theme schema shape accepted by the Next adapter. Mirrors Hydrogen's
+ * `HydrogenThemeSchema` but keeps locale data framework-neutral via
+ * {@link WeaverseNextI18n} instead of Shopify Hydrogen's `I18nBase`.
+ */
+interface WeaverseNextThemeSchemaInput {
+    condition?: unknown;
+    defaultValue?: unknown;
+    name?: string;
+    [key: string]: unknown;
+}
+interface WeaverseNextThemeSchemaGroup {
+    group?: string;
+    inputs?: WeaverseNextThemeSchemaInput[];
+    [key: string]: unknown;
+}
+interface WeaverseNextThemeSchema {
+    i18n?: {
+        defaultLocale?: WeaverseNextI18n;
+        shopLocales?: WeaverseNextI18n[];
+        staticContent?: Record<string, unknown>;
+        /** Enable the translation UI in Builder. */
+        translation?: boolean;
+        urlStructure?: 'url-path' | 'subdomain' | 'top-level-domain';
+        [key: string]: unknown;
+    };
+    info?: {
+        author?: string;
+        authorProfilePhoto?: string;
+        documentationUrl?: string;
+        name?: string;
+        supportUrl?: string;
+        version?: string;
+        [key: string]: unknown;
+    };
+    /** @deprecated Use settings instead. */
+    inspector?: (InspectorGroup | WeaverseNextThemeSchemaGroup)[];
+    settings?: (InspectorGroup | WeaverseNextThemeSchemaGroup)[];
+    [key: string]: unknown;
+}
 /**
  * Minimal Storefront client shape required by component loaders. The host app
  * provides this (public or private token mode); Weaverse never owns it.
@@ -104,6 +253,8 @@ interface WeaverseNextPageData {
     items: WeaverseNextComponentData[];
     name?: string;
     rootId?: string;
+    /** Page-level SEO metadata published by Weaverse Builder. */
+    seo?: PageSEOData | null;
     [key: string]: unknown;
 }
 /**
@@ -113,7 +264,7 @@ interface WeaverseNextPageData {
 interface WeaverseNextLoaderData {
     configs?: Record<string, unknown>;
     page: WeaverseNextPageData;
-    pageAssignment?: Record<string, unknown>;
+    pageAssignment?: WeaverseNextPageAssignment;
     project?: Record<string, unknown>;
     [key: string]: unknown;
 }
@@ -160,7 +311,7 @@ interface WeaverseNextClientConfig {
     fetchThemeSettings?: (context?: WeaverseNextRequestContext) => Promise<unknown>;
     projectId: string;
     requestContext?: WeaverseNextRequestContext;
-    themeSchema?: unknown;
+    themeSchema?: WeaverseNextThemeSchema;
     themeSettings?: Record<string, unknown>;
 }
 /**
@@ -181,11 +332,14 @@ interface WeaverseNextClient {
     requestContext?: WeaverseNextRequestContext;
     /** Compatibility alias for `commerce.storefront`. */
     storefront?: WeaverseNextStorefront;
-    themeSchema?: unknown;
+    themeSchema?: WeaverseNextThemeSchema;
     themeSettings: Record<string, unknown>;
 }
 type WeaverseProduct = WeaverseResourcePickerData;
 type WeaverseCollection = WeaverseResourcePickerData;
+type WeaverseBlog = WeaverseResourcePickerData;
+type WeaverseArticle = WeaverseResourcePickerData;
+type WeaverseMetaObject = WeaverseResourcePickerData;
 /**
  * Project identifier accepted by {@link WeaverseNextServerClientConfig}. Either
  * a static string or a (possibly async) resolver that reads the request
@@ -249,7 +403,7 @@ interface WeaverseNextThemeSettingsResponse {
     _loadFailed?: boolean;
     merchantOverrides?: Record<string, unknown>;
     publicEnv?: Record<string, string | undefined>;
-    schema?: unknown;
+    schema?: WeaverseNextThemeSchema;
     staticContent?: Record<string, unknown>;
     theme?: Record<string, unknown>;
     [key: string]: unknown;
@@ -261,6 +415,18 @@ interface WeaverseNextThemeSettingsResponse {
  */
 interface WeaverseNextThemeSettingsOptions extends WeaverseNextCacheConfig {
 }
+interface WeaverseNextCustomPageEntry {
+    changeFrequency?: 'daily' | 'weekly' | 'monthly';
+    handle: string;
+    lastModified: string;
+    locale: string | null;
+    path: string;
+    priority?: number;
+}
+interface WeaverseNextFetchCustomPagesOptions extends WeaverseNextCacheConfig {
+    limit?: number;
+    locale?: string;
+}
 /**
  * Config for {@link createWeaverseNextServerClient}. Unlike
  * {@link WeaverseNextClientConfig} (which delegates network I/O to injected
@@ -279,7 +445,7 @@ interface WeaverseNextServerClientConfig {
     fetchTimeoutMs?: number;
     projectId?: WeaverseNextProjectId;
     requestContext?: WeaverseNextRequestContext;
-    themeSchema?: unknown;
+    themeSchema?: WeaverseNextThemeSchema;
     themeSettings?: Record<string, unknown>;
     /** Optional override for the resolved Weaverse public API base. */
     weaverseApiBase?: string;
@@ -297,6 +463,7 @@ interface WeaverseNextServerClientConfig {
 interface WeaverseNextServerClient extends WeaverseNextClient {
     /** Public, client-safe resolved configs (no server secrets). */
     configs: WeaverseNextConfigs;
+    fetchCustomPages: (options?: WeaverseNextFetchCustomPagesOptions) => Promise<WeaverseNextCustomPageEntry[]>;
     fetchWithCache: <T = unknown>(url: string, options?: WeaverseNextFetchOptions) => Promise<T>;
     loadPage: (input?: WeaverseNextLoadPageInput) => Promise<WeaverseNextLoaderData | null>;
     /**
@@ -318,4 +485,33 @@ interface WeaverseNextServerLoadPageInput extends WeaverseNextLoadPageInput {
     projectId?: string;
 }
 
-export type { WeaverseNextThemeSettingsStore as A, WeaverseProduct as B, WeaverseCollection as W, WeaverseNextBaseConfigs as a, WeaverseNextCacheConfig as b, WeaverseNextClient as c, WeaverseNextClientConfig as d, WeaverseNextCommerceContext as e, WeaverseNextComponent as f, WeaverseNextComponentData as g, WeaverseNextComponentLoaderArgs as h, WeaverseNextComponentProps as i, WeaverseNextConfigs as j, WeaverseNextFetchOptions as k, WeaverseNextI18n as l, WeaverseNextLoadPageInput as m, WeaverseNextLoaderData as n, WeaverseNextPageData as o, WeaverseNextProjectId as p, WeaverseNextRequestContext as q, WeaverseNextRequestInfo as r, WeaverseNextRuntimeConfig as s, WeaverseNextRuntimeInternal as t, WeaverseNextServerClient as u, WeaverseNextServerClientConfig as v, WeaverseNextServerLoadPageInput as w, WeaverseNextStorefront as x, WeaverseNextThemeSettingsOptions as y, WeaverseNextThemeSettingsResponse as z };
+interface WeaverseNextSeoMetadata {
+    alternates?: {
+        canonical?: string;
+    };
+    description?: string;
+    keywords?: string;
+    openGraph?: {
+        description?: string;
+        images?: string[];
+        title?: string;
+        type?: string;
+    };
+    robots: {
+        follow: boolean;
+        index: boolean;
+    };
+    title?: string;
+    twitter?: {
+        card?: string;
+        description?: string;
+        images?: string[];
+        title?: string;
+    };
+}
+declare function formatWeaverseNextSeoMetadata(seo: PageSEOData | null | undefined): WeaverseNextSeoMetadata;
+declare function getWeaverseNextSeoMetadata(data: WeaverseNextLoaderData | WeaverseNextPageData | {
+    page?: WeaverseNextPageData | null;
+} | null | undefined): WeaverseNextSeoMetadata;
+
+export { type WeaverseNextRuntimeInternal as A, type WeaverseNextSeoMetadata as B, type WeaverseNextServerClient as C, type WeaverseNextServerClientConfig as D, type WeaverseNextServerLoadPageInput as E, type WeaverseNextStorefront as F, type WeaverseNextThemeSchema as G, type WeaverseNextThemeSettingsOptions as H, type WeaverseNextThemeSettingsResponse as I, type WeaverseNextThemeSettingsStore as J, type WeaverseNextTranslationChanges as K, type WeaverseNextTranslationEntry as L, type WeaverseNextTranslationItemEntry as M, type WeaverseNextTranslationMap as N, type WeaverseNextTranslationMapEntry as O, type WeaverseProduct as P, formatWeaverseNextSeoMetadata as Q, getWeaverseNextSeoMetadata as R, ThemeTextStore as T, type WeaverseArticle as W, TranslationStore as a, type WeaverseBlog as b, type WeaverseCollection as c, type WeaverseMetaObject as d, type WeaverseNextBaseConfigs as e, type WeaverseNextCacheConfig as f, type WeaverseNextClient as g, type WeaverseNextClientConfig as h, type WeaverseNextCommerceContext as i, type WeaverseNextComponent as j, type WeaverseNextComponentData as k, type WeaverseNextComponentLoaderArgs as l, type WeaverseNextComponentProps as m, type WeaverseNextConfigs as n, type WeaverseNextCustomPageEntry as o, type WeaverseNextFetchCustomPagesOptions as p, type WeaverseNextFetchOptions as q, type WeaverseNextI18n as r, type WeaverseNextLoadPageInput as s, type WeaverseNextLoaderData as t, type WeaverseNextPageAssignment as u, type WeaverseNextPageData as v, type WeaverseNextProjectId as w, type WeaverseNextRequestContext as x, type WeaverseNextRequestInfo as y, type WeaverseNextRuntimeConfig as z };