@reacteditor/core 0.0.9 → 0.0.11

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-import { D as Data, o as Field, p as FieldProps, C as Config, U as UserGenerics, k as UiState, O as OnAction, f as Permissions, i as Plugin, j as Overrides, m as FieldTransforms, E as EditorAction, V as Viewports, I as IframeConfig, q as InitialHistory, M as Metadata, b as ComponentData, d as DefaultComponentProps, e as DefaultRootFieldProps, h as ResolveDataTrigger, r as ItemSelector, s as PluginInternal } from './actions-2L-1hQ7r.mjs';
-export { t as Adaptor, A as AppState, u as ArrayField, v as ArrayState, w as AsFieldProps, B as BaseData, x as BaseField, y as CacheOpts, z as ColorField, l as ComponentConfig, G as ComponentConfigExtensions, J as ComponentConfigParams, K as ComponentDataMap, L as ComponentDataOptionalId, N as ComponentMetadata, Q as ConfigParams, a as Content, S as CustomField, T as CustomFieldRender, c as DefaultComponents, X as DefaultRootProps, Y as DefaultRootRenderProps, Z as Direction, _ as DragAxis, $ as EditorComponent, a0 as EditorContext, a1 as EditorMetadata, a2 as ExternalField, a3 as ExternalFieldWithAdaptor, a4 as ExtractConfigParams, a5 as ExtractField, a6 as FieldMetadata, a7 as FieldRenderFunctions, a8 as FieldTransformFn, a9 as FieldTransformFnParams, F as Fields, H as History, aa as ItemWithId, ab as MappedItem, ac as NumberField, ad as ObjectField, ae as OverrideKey, af as RadioField, ag as RichText, n as RichtextField, ah as RootConfig, R as RootData, g as RootDataWithProps, ai as RootDataWithoutProps, aj as SelectField, ak as Slot, al as SlotComponent, am as SlotField, an as TextField, ao as TextareaField, ap as Viewport, aq as WithChildren, ar as WithEditorProps, W as WithId, as as WithSlotProps, at as overrideKeys } from './actions-2L-1hQ7r.mjs';
-export { m as migrate, r as resolveAllData, t as transformProps, w as walkTree } from './walk-tree-4C3ODO3X.mjs';
+import { D as Data, o as Field, p as FieldProps, C as Config, U as UserGenerics, O as OnAction, f as UiState, d as Plugin, e as Overrides, h as FieldTransforms, M as Metadata, I as IframeConfig, V as Viewports, a as Permissions, E as EditorAction, q as InitialHistory, b as ComponentData, l as DefaultComponentProps, m as DefaultRootFieldProps, c as ResolveDataTrigger, r as ItemSelector, s as PluginInternal } from './actions-C0LX6bI4.mjs';
+export { t as Adaptor, A as AppState, u as ArrayField, v as ArrayState, w as AsFieldProps, B as BaseData, x as BaseField, y as CacheOpts, z as ColorField, g as ComponentConfig, G as ComponentConfigExtensions, J as ComponentConfigParams, K as ComponentDataMap, L as ComponentDataOptionalId, N as ComponentMetadata, Q as ConfigParams, j as Content, S as CustomField, T as CustomFieldRender, k as DefaultComponents, X as DefaultRootProps, Y as DefaultRootRenderProps, Z as Direction, _ as DragAxis, $ as EditorComponent, a0 as EditorContext, a1 as EditorMetadata, a2 as ExternalField, a3 as ExternalFieldWithAdaptor, a4 as ExtractConfigParams, a5 as ExtractField, a6 as FieldMetadata, a7 as FieldRenderFunctions, a8 as FieldTransformFn, a9 as FieldTransformFnParams, F as Fields, H as History, aa as ItemWithId, ab as MappedItem, ac as NumberField, ad as ObjectField, ae as OverrideKey, af as RadioField, ag as RichText, i as RichtextField, ah as RootConfig, n as RootData, R as RootDataWithProps, ai as RootDataWithoutProps, aj as SelectField, ak as Slot, al as SlotComponent, am as SlotField, an as TextField, ao as TextareaField, ap as Viewport, aq as WithChildren, ar as WithEditorProps, W as WithId, as as WithSlotProps, at as overrideKeys } from './actions-C0LX6bI4.mjs';
+export { G as GetRoutePropsOptions, g as getRouteProps, m as migrate, r as resolveAllData, a as resolveRouteFromString, t as transformProps, w as walkTree } from './walk-tree-5oDs6qOL.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import react__default, { ReactNode, SyntheticEvent, ReactElement, CSSProperties } from 'react';
-import { A as AppStore, G as GetPermissions, R as RefreshPermissions, H as HistorySlice } from './index-BXuSeNez.mjs';
+import { A as AppStore, G as GetPermissions, R as RefreshPermissions, H as HistorySlice } from './index-DMbFEg8G.mjs';
 import '@tiptap/react';
 import '@tiptap/extension-blockquote';
 import '@tiptap/extension-bold';
@@ -30,17 +30,17 @@ import '@tiptap/extension-underline';
 type GlobalsMap = NonNullable<Data["globals"]>;
 
 /**
- * A concrete page destination surfaced in the editor's page switcher.
- * `path` is the stable identifier AND the URL; `title` is the display
- * label. Keep this type light — full page content lives in separate
- * per-page data blobs owned by the consumer. When Editor eventually
- * introduces a richer `Page` type (data + metadata + path + title),
- * `Route` can stay as the summary / reference projection of it.
+ * A route key — the literal string used as a `pages` key in `<App>` and
+ * the picker entry in `<Editor routes>`. The same string flows through:
+ *   - `pages={{ [routeKey]: pageData }}` declares the schema
+ *   - `<Editor routes={[routeKey, ...]}>` powers the page picker
+ *   - `<Editor currentPath={routeKey}>` marks the selected page
+ *   - `onPublish(data, routeKey)` returns it for persistence
+ *
+ * Patterns follow path-to-regexp v8 / Express 5 syntax: "/", "/about",
+ * "/products/:handle", "/docs/*splat".
  */
-type Route = {
-    path: string;
-    title: string;
-};
+type Route = string;
 
 declare const ActionBar: {
     ({ label, children, }: {
@@ -91,6 +91,135 @@ declare function AutoField<ValueType = any, FieldType extends FieldNoLabel<Value
     value: any;
 }): react_jsx_runtime.JSX.Element | null;
 
+/** A route key — the literal pattern used in `pages`. */
+type RouteKey = string;
+type AppMatched<Data = unknown> = {
+    /** The route key string — stable persistence identifier. */
+    route: RouteKey;
+    /** Concrete params extracted from the URL (e.g. { handle: "abc" }). */
+    params: Readonly<Record<string, string | undefined>>;
+    /** The page's data. */
+    data: Data;
+};
+type AppConfigContext<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
+    config: UserConfig;
+    pages: Record<RouteKey, Partial<G["UserData"] | Data>>;
+    /** "/edit" by default; null disables editor mode entirely. */
+    editorPath: string | null;
+};
+declare const appConfigContext: react.Context<AppConfigContext<Config, UserGenerics<Config>> | null>;
+type AppContextValue<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = AppConfigContext<UserConfig, G> & {
+    /** All page route keys, in declaration order. */
+    routes: RouteKey[];
+    /** Resolved current pathname from React Router. */
+    currentPath: string;
+    /** True when currentPath starts with editorPath. */
+    isEditing: boolean;
+    /** The URL relative to editorPath when isEditing — what pages are matched against. */
+    matchRoute: string;
+    /** Result of matching matchRoute against pages. Null = 404. */
+    matched: AppMatched<Partial<G["UserData"] | Data>> | null;
+    /** Navigate to a route key. Wraps with editorPath when editing. */
+    navigate: (route: RouteKey) => void;
+};
+/**
+ * Read the resolved route context. Combines config + pages + editorPath
+ * (from `<AppProvider>`) with the live location/navigation (from React Router).
+ */
+declare const useApp: <UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>() => AppContextValue<UserConfig, G>;
+
+/** Which RR router variant to use on the client. SSR always uses StaticRouter. */
+type AppRouterVariant = "browser" | "hash" | "memory";
+type AppProviderProps<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
+    config: UserConfig;
+    pages: Record<RouteKey, Partial<G["UserData"] | Data>>;
+    /** Defaults to "/editor". Pass null to disable editor mode. */
+    editorPath?: string | null;
+    /** Client-side router variant. Defaults to "browser". */
+    router?: AppRouterVariant;
+    /**
+     * Initial pathname for SSR (StaticRouter) or MemoryRouter.
+     * Required during SSR so the first paint matches the requested URL.
+     * Ignored for BrowserRouter and HashRouter on the client (they read window).
+     */
+    currentPath?: string;
+    children?: ReactNode;
+};
+declare function AppProvider<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>({ config, pages, editorPath, router, currentPath, children, }: AppProviderProps<UserConfig, G>): react_jsx_runtime.JSX.Element;
+
+/** Editor pass-through props shared by <App> (default layout) and <App.Editor>. */
+type EditorPassthroughProps<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
+    /** Called when the editor publishes. `route` is the schema route key. */
+    onPublish?: (data: G["UserData"], route?: string) => void;
+    onChange?: (data: G["UserData"]) => void;
+    onAction?: OnAction<G["UserData"]>;
+    ui?: Partial<UiState>;
+    plugins?: Plugin<UserConfig>[];
+    overrides?: Partial<Overrides<UserConfig>>;
+    fieldTransforms?: FieldTransforms<UserConfig>;
+    metadata?: Metadata;
+    iframe?: IframeConfig;
+    viewports?: Viewports;
+    permissions?: Partial<Permissions>;
+    renderHeader?: (props: {
+        children: ReactNode;
+        dispatch: (action: EditorAction) => void;
+        state: G["UserAppState"];
+    }) => ReactElement;
+    renderHeaderActions?: (props: {
+        state: G["UserAppState"];
+        dispatch: (action: EditorAction) => void;
+    }) => ReactElement;
+    title?: ReactNode;
+    dnd?: {
+        disableAutoScroll?: boolean;
+    };
+    initialHistory?: InitialHistory;
+    height?: CSSProperties["height"];
+    fullScreenCanvas?: boolean;
+    disableZoomControls?: boolean;
+    _experimentalVirtualization?: boolean;
+};
+type AppProps<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = AppProviderProps<UserConfig, G> & EditorPassthroughProps<UserConfig, G> & {
+    /** Optional custom not-found component — falls back to a built-in. */
+    renderNotFound?: () => ReactNode;
+};
+type AppRenderProps = {
+    metadata?: Metadata;
+    renderNotFound?: () => ReactNode;
+};
+/**
+ * Mounts <Render> for the current page when the URL is *not* under editorPath.
+ * Returns null while editing — safe to place anywhere inside <App>.
+ */
+declare function AppRender<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>({ metadata, renderNotFound }: AppRenderProps): react_jsx_runtime.JSX.Element | null;
+type AppEditorProps<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = EditorPassthroughProps<UserConfig, G> & {
+    children?: ReactNode;
+    renderNotFound?: () => ReactNode;
+};
+/**
+ * Mounts <Editor> for the current page when the URL is under editorPath.
+ * Returns null otherwise. Children are forwarded to <Editor> for compositional
+ * UI (e.g. <Editor.Preview />, <Editor.Fields />).
+ */
+declare function AppEditor<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>(props: AppEditorProps<UserConfig, G>): react_jsx_runtime.JSX.Element | null;
+declare function App<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>(props: AppProps<UserConfig, G>): react_jsx_runtime.JSX.Element;
+declare namespace App {
+    var Render: typeof AppRender;
+    var Editor: typeof AppEditor;
+}
+
+/**
+ * Returns the schema-named params extracted from the current route.
+ *
+ * Designed for components rendered *inside* the schema (e.g. a ProductDetails
+ * block inside `pages["/products/:handle"]`) — they need `:handle` resolved
+ * by name. This is a typed re-export of React Router's `useParams()`.
+ *
+ * Returns `{}` when no page matched (404).
+ */
+declare const useRouteParams: <P extends Record<string, string | undefined> = Record<string, string | undefined>>() => Readonly<P>;
+
 declare const Button: ({ children, href, onClick, variant, type, disabled, tabIndex, newTab, fullWidth, icon, size, loading: loadingProp, ...props }: {
     children: ReactNode;
     href?: string;
@@ -161,7 +290,7 @@ type EditorProps<UserConfig extends Config = Config, G extends UserGenerics<User
     data: Partial<G["UserData"] | Data>;
     ui?: Partial<UiState>;
     onChange?: (data: G["UserData"]) => void;
-    onPublish?: (data: G["UserData"]) => void;
+    onPublish?: (data: G["UserData"], route?: string) => void;
     onAction?: OnAction<G["UserData"]>;
     permissions?: Partial<Permissions>;
     plugins?: Plugin<UserConfig>[];
@@ -180,7 +309,7 @@ type EditorProps<UserConfig extends Config = Config, G extends UserGenerics<User
     headerPath?: string;
     title?: ReactNode;
     routes?: Route[];
-    currentPath?: string;
+    currentRoute?: string;
     onRouteChange?: (path: string) => void | Promise<void>;
     viewports?: Viewports;
     iframe?: IframeConfig;
@@ -284,6 +413,15 @@ declare const RichTextMenu: {
     Underline: typeof Underline;
 };
 
+/**
+ * Returns a structurally-stable reference. Updates only when `value` deep-changes,
+ * so referentially-fresh-but-content-equal objects don't re-trigger downstream memos.
+ *
+ * Used inside `<AppProvider>` so that users passing inline `pages={{ ... }}` don't
+ * re-compile the route table on every parent render.
+ */
+declare const useStableValue: <T>(value: T) => T;
+
 /**
  * Framework-agnostic SEO output shape. Mirrors the subset of Next.js's
  * Metadata type that most page builders care about — title, description,
@@ -413,4 +551,4 @@ declare const outlinePlugin: () => Plugin;
 
 declare const legacySideBarPlugin: () => Plugin;
 
-export { Action, ActionBar, AutoField, Button, ComponentData, ComponentList, Config, Data, DefaultComponentProps, DefaultRootFieldProps, Drawer, Editor, EditorAction, type EditorApi, type EditorCommands, Field, FieldLabel, FieldProps, FieldTransforms, type GlobalsMap, Group, IconButton, IframeConfig, InitialHistory, type InsertComponentArgs, Label, Metadata, type MoveDestination, OnAction, Overrides, type PageMetadata, type Parent, Permissions, Plugin, Render, ResolveDataTrigger, RichTextMenu, type Route, Separator, UiState, type UseEditorData, UserGenerics, Viewports, blocksPlugin, createUseEditor, fieldsPlugin, legacySideBarPlugin, outlinePlugin, pageMetadata, registerOverlayPortal, renderContext, setDeep, useEditor, useGetEditor, usePropsContext };
+export { Action, ActionBar, App, type AppContextValue, type AppEditorProps, type AppMatched, type AppProps, AppProvider, type AppProviderProps, type AppRenderProps, type AppRouterVariant, AutoField, Button, ComponentData, ComponentList, Config, Data, DefaultComponentProps, DefaultRootFieldProps, Drawer, Editor, EditorAction, type EditorApi, type EditorCommands, Field, FieldLabel, FieldProps, FieldTransforms, type GlobalsMap, Group, IconButton, IframeConfig, InitialHistory, type InsertComponentArgs, Label, Metadata, type MoveDestination, OnAction, Overrides, type PageMetadata, type Parent, Permissions, Plugin, Render, ResolveDataTrigger, RichTextMenu, type Route, type RouteKey, Separator, UiState, type UseEditorData, UserGenerics, Viewports, appConfigContext, blocksPlugin, createUseEditor, fieldsPlugin, legacySideBarPlugin, outlinePlugin, pageMetadata, registerOverlayPortal, renderContext, setDeep, useApp, useEditor, useGetEditor, usePropsContext, useRouteParams, useStableValue };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { D as Data, o as Field, p as FieldProps, C as Config, U as UserGenerics, k as UiState, O as OnAction, f as Permissions, i as Plugin, j as Overrides, m as FieldTransforms, E as EditorAction, V as Viewports, I as IframeConfig, q as InitialHistory, M as Metadata, b as ComponentData, d as DefaultComponentProps, e as DefaultRootFieldProps, h as ResolveDataTrigger, r as ItemSelector, s as PluginInternal } from './actions-2L-1hQ7r.js';
-export { t as Adaptor, A as AppState, u as ArrayField, v as ArrayState, w as AsFieldProps, B as BaseData, x as BaseField, y as CacheOpts, z as ColorField, l as ComponentConfig, G as ComponentConfigExtensions, J as ComponentConfigParams, K as ComponentDataMap, L as ComponentDataOptionalId, N as ComponentMetadata, Q as ConfigParams, a as Content, S as CustomField, T as CustomFieldRender, c as DefaultComponents, X as DefaultRootProps, Y as DefaultRootRenderProps, Z as Direction, _ as DragAxis, $ as EditorComponent, a0 as EditorContext, a1 as EditorMetadata, a2 as ExternalField, a3 as ExternalFieldWithAdaptor, a4 as ExtractConfigParams, a5 as ExtractField, a6 as FieldMetadata, a7 as FieldRenderFunctions, a8 as FieldTransformFn, a9 as FieldTransformFnParams, F as Fields, H as History, aa as ItemWithId, ab as MappedItem, ac as NumberField, ad as ObjectField, ae as OverrideKey, af as RadioField, ag as RichText, n as RichtextField, ah as RootConfig, R as RootData, g as RootDataWithProps, ai as RootDataWithoutProps, aj as SelectField, ak as Slot, al as SlotComponent, am as SlotField, an as TextField, ao as TextareaField, ap as Viewport, aq as WithChildren, ar as WithEditorProps, W as WithId, as as WithSlotProps, at as overrideKeys } from './actions-2L-1hQ7r.js';
-export { m as migrate, r as resolveAllData, t as transformProps, w as walkTree } from './walk-tree-C9GrSWsR.js';
+import { D as Data, o as Field, p as FieldProps, C as Config, U as UserGenerics, O as OnAction, f as UiState, d as Plugin, e as Overrides, h as FieldTransforms, M as Metadata, I as IframeConfig, V as Viewports, a as Permissions, E as EditorAction, q as InitialHistory, b as ComponentData, l as DefaultComponentProps, m as DefaultRootFieldProps, c as ResolveDataTrigger, r as ItemSelector, s as PluginInternal } from './actions-C0LX6bI4.js';
+export { t as Adaptor, A as AppState, u as ArrayField, v as ArrayState, w as AsFieldProps, B as BaseData, x as BaseField, y as CacheOpts, z as ColorField, g as ComponentConfig, G as ComponentConfigExtensions, J as ComponentConfigParams, K as ComponentDataMap, L as ComponentDataOptionalId, N as ComponentMetadata, Q as ConfigParams, j as Content, S as CustomField, T as CustomFieldRender, k as DefaultComponents, X as DefaultRootProps, Y as DefaultRootRenderProps, Z as Direction, _ as DragAxis, $ as EditorComponent, a0 as EditorContext, a1 as EditorMetadata, a2 as ExternalField, a3 as ExternalFieldWithAdaptor, a4 as ExtractConfigParams, a5 as ExtractField, a6 as FieldMetadata, a7 as FieldRenderFunctions, a8 as FieldTransformFn, a9 as FieldTransformFnParams, F as Fields, H as History, aa as ItemWithId, ab as MappedItem, ac as NumberField, ad as ObjectField, ae as OverrideKey, af as RadioField, ag as RichText, i as RichtextField, ah as RootConfig, n as RootData, R as RootDataWithProps, ai as RootDataWithoutProps, aj as SelectField, ak as Slot, al as SlotComponent, am as SlotField, an as TextField, ao as TextareaField, ap as Viewport, aq as WithChildren, ar as WithEditorProps, W as WithId, as as WithSlotProps, at as overrideKeys } from './actions-C0LX6bI4.js';
+export { G as GetRoutePropsOptions, g as getRouteProps, m as migrate, r as resolveAllData, a as resolveRouteFromString, t as transformProps, w as walkTree } from './walk-tree-B1q6t5Jp.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import react__default, { ReactNode, SyntheticEvent, ReactElement, CSSProperties } from 'react';
-import { A as AppStore, G as GetPermissions, R as RefreshPermissions, H as HistorySlice } from './index-BNsSzMCj.js';
+import { A as AppStore, G as GetPermissions, R as RefreshPermissions, H as HistorySlice } from './index-DmThy7vE.js';
 import '@tiptap/react';
 import '@tiptap/extension-blockquote';
 import '@tiptap/extension-bold';
@@ -30,17 +30,17 @@ import '@tiptap/extension-underline';
 type GlobalsMap = NonNullable<Data["globals"]>;
 
 /**
- * A concrete page destination surfaced in the editor's page switcher.
- * `path` is the stable identifier AND the URL; `title` is the display
- * label. Keep this type light — full page content lives in separate
- * per-page data blobs owned by the consumer. When Editor eventually
- * introduces a richer `Page` type (data + metadata + path + title),
- * `Route` can stay as the summary / reference projection of it.
+ * A route key — the literal string used as a `pages` key in `<App>` and
+ * the picker entry in `<Editor routes>`. The same string flows through:
+ *   - `pages={{ [routeKey]: pageData }}` declares the schema
+ *   - `<Editor routes={[routeKey, ...]}>` powers the page picker
+ *   - `<Editor currentPath={routeKey}>` marks the selected page
+ *   - `onPublish(data, routeKey)` returns it for persistence
+ *
+ * Patterns follow path-to-regexp v8 / Express 5 syntax: "/", "/about",
+ * "/products/:handle", "/docs/*splat".
  */
-type Route = {
-    path: string;
-    title: string;
-};
+type Route = string;
 
 declare const ActionBar: {
     ({ label, children, }: {
@@ -91,6 +91,135 @@ declare function AutoField<ValueType = any, FieldType extends FieldNoLabel<Value
     value: any;
 }): react_jsx_runtime.JSX.Element | null;
 
+/** A route key — the literal pattern used in `pages`. */
+type RouteKey = string;
+type AppMatched<Data = unknown> = {
+    /** The route key string — stable persistence identifier. */
+    route: RouteKey;
+    /** Concrete params extracted from the URL (e.g. { handle: "abc" }). */
+    params: Readonly<Record<string, string | undefined>>;
+    /** The page's data. */
+    data: Data;
+};
+type AppConfigContext<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
+    config: UserConfig;
+    pages: Record<RouteKey, Partial<G["UserData"] | Data>>;
+    /** "/edit" by default; null disables editor mode entirely. */
+    editorPath: string | null;
+};
+declare const appConfigContext: react.Context<AppConfigContext<Config, UserGenerics<Config>> | null>;
+type AppContextValue<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = AppConfigContext<UserConfig, G> & {
+    /** All page route keys, in declaration order. */
+    routes: RouteKey[];
+    /** Resolved current pathname from React Router. */
+    currentPath: string;
+    /** True when currentPath starts with editorPath. */
+    isEditing: boolean;
+    /** The URL relative to editorPath when isEditing — what pages are matched against. */
+    matchRoute: string;
+    /** Result of matching matchRoute against pages. Null = 404. */
+    matched: AppMatched<Partial<G["UserData"] | Data>> | null;
+    /** Navigate to a route key. Wraps with editorPath when editing. */
+    navigate: (route: RouteKey) => void;
+};
+/**
+ * Read the resolved route context. Combines config + pages + editorPath
+ * (from `<AppProvider>`) with the live location/navigation (from React Router).
+ */
+declare const useApp: <UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>() => AppContextValue<UserConfig, G>;
+
+/** Which RR router variant to use on the client. SSR always uses StaticRouter. */
+type AppRouterVariant = "browser" | "hash" | "memory";
+type AppProviderProps<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
+    config: UserConfig;
+    pages: Record<RouteKey, Partial<G["UserData"] | Data>>;
+    /** Defaults to "/editor". Pass null to disable editor mode. */
+    editorPath?: string | null;
+    /** Client-side router variant. Defaults to "browser". */
+    router?: AppRouterVariant;
+    /**
+     * Initial pathname for SSR (StaticRouter) or MemoryRouter.
+     * Required during SSR so the first paint matches the requested URL.
+     * Ignored for BrowserRouter and HashRouter on the client (they read window).
+     */
+    currentPath?: string;
+    children?: ReactNode;
+};
+declare function AppProvider<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>({ config, pages, editorPath, router, currentPath, children, }: AppProviderProps<UserConfig, G>): react_jsx_runtime.JSX.Element;
+
+/** Editor pass-through props shared by <App> (default layout) and <App.Editor>. */
+type EditorPassthroughProps<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
+    /** Called when the editor publishes. `route` is the schema route key. */
+    onPublish?: (data: G["UserData"], route?: string) => void;
+    onChange?: (data: G["UserData"]) => void;
+    onAction?: OnAction<G["UserData"]>;
+    ui?: Partial<UiState>;
+    plugins?: Plugin<UserConfig>[];
+    overrides?: Partial<Overrides<UserConfig>>;
+    fieldTransforms?: FieldTransforms<UserConfig>;
+    metadata?: Metadata;
+    iframe?: IframeConfig;
+    viewports?: Viewports;
+    permissions?: Partial<Permissions>;
+    renderHeader?: (props: {
+        children: ReactNode;
+        dispatch: (action: EditorAction) => void;
+        state: G["UserAppState"];
+    }) => ReactElement;
+    renderHeaderActions?: (props: {
+        state: G["UserAppState"];
+        dispatch: (action: EditorAction) => void;
+    }) => ReactElement;
+    title?: ReactNode;
+    dnd?: {
+        disableAutoScroll?: boolean;
+    };
+    initialHistory?: InitialHistory;
+    height?: CSSProperties["height"];
+    fullScreenCanvas?: boolean;
+    disableZoomControls?: boolean;
+    _experimentalVirtualization?: boolean;
+};
+type AppProps<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = AppProviderProps<UserConfig, G> & EditorPassthroughProps<UserConfig, G> & {
+    /** Optional custom not-found component — falls back to a built-in. */
+    renderNotFound?: () => ReactNode;
+};
+type AppRenderProps = {
+    metadata?: Metadata;
+    renderNotFound?: () => ReactNode;
+};
+/**
+ * Mounts <Render> for the current page when the URL is *not* under editorPath.
+ * Returns null while editing — safe to place anywhere inside <App>.
+ */
+declare function AppRender<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>({ metadata, renderNotFound }: AppRenderProps): react_jsx_runtime.JSX.Element | null;
+type AppEditorProps<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = EditorPassthroughProps<UserConfig, G> & {
+    children?: ReactNode;
+    renderNotFound?: () => ReactNode;
+};
+/**
+ * Mounts <Editor> for the current page when the URL is under editorPath.
+ * Returns null otherwise. Children are forwarded to <Editor> for compositional
+ * UI (e.g. <Editor.Preview />, <Editor.Fields />).
+ */
+declare function AppEditor<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>(props: AppEditorProps<UserConfig, G>): react_jsx_runtime.JSX.Element | null;
+declare function App<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>(props: AppProps<UserConfig, G>): react_jsx_runtime.JSX.Element;
+declare namespace App {
+    var Render: typeof AppRender;
+    var Editor: typeof AppEditor;
+}
+
+/**
+ * Returns the schema-named params extracted from the current route.
+ *
+ * Designed for components rendered *inside* the schema (e.g. a ProductDetails
+ * block inside `pages["/products/:handle"]`) — they need `:handle` resolved
+ * by name. This is a typed re-export of React Router's `useParams()`.
+ *
+ * Returns `{}` when no page matched (404).
+ */
+declare const useRouteParams: <P extends Record<string, string | undefined> = Record<string, string | undefined>>() => Readonly<P>;
+
 declare const Button: ({ children, href, onClick, variant, type, disabled, tabIndex, newTab, fullWidth, icon, size, loading: loadingProp, ...props }: {
     children: ReactNode;
     href?: string;
@@ -161,7 +290,7 @@ type EditorProps<UserConfig extends Config = Config, G extends UserGenerics<User
     data: Partial<G["UserData"] | Data>;
     ui?: Partial<UiState>;
     onChange?: (data: G["UserData"]) => void;
-    onPublish?: (data: G["UserData"]) => void;
+    onPublish?: (data: G["UserData"], route?: string) => void;
     onAction?: OnAction<G["UserData"]>;
     permissions?: Partial<Permissions>;
     plugins?: Plugin<UserConfig>[];
@@ -180,7 +309,7 @@ type EditorProps<UserConfig extends Config = Config, G extends UserGenerics<User
     headerPath?: string;
     title?: ReactNode;
     routes?: Route[];
-    currentPath?: string;
+    currentRoute?: string;
     onRouteChange?: (path: string) => void | Promise<void>;
     viewports?: Viewports;
     iframe?: IframeConfig;
@@ -284,6 +413,15 @@ declare const RichTextMenu: {
     Underline: typeof Underline;
 };
 
+/**
+ * Returns a structurally-stable reference. Updates only when `value` deep-changes,
+ * so referentially-fresh-but-content-equal objects don't re-trigger downstream memos.
+ *
+ * Used inside `<AppProvider>` so that users passing inline `pages={{ ... }}` don't
+ * re-compile the route table on every parent render.
+ */
+declare const useStableValue: <T>(value: T) => T;
+
 /**
  * Framework-agnostic SEO output shape. Mirrors the subset of Next.js's
  * Metadata type that most page builders care about — title, description,
@@ -413,4 +551,4 @@ declare const outlinePlugin: () => Plugin;
 
 declare const legacySideBarPlugin: () => Plugin;
 
-export { Action, ActionBar, AutoField, Button, ComponentData, ComponentList, Config, Data, DefaultComponentProps, DefaultRootFieldProps, Drawer, Editor, EditorAction, type EditorApi, type EditorCommands, Field, FieldLabel, FieldProps, FieldTransforms, type GlobalsMap, Group, IconButton, IframeConfig, InitialHistory, type InsertComponentArgs, Label, Metadata, type MoveDestination, OnAction, Overrides, type PageMetadata, type Parent, Permissions, Plugin, Render, ResolveDataTrigger, RichTextMenu, type Route, Separator, UiState, type UseEditorData, UserGenerics, Viewports, blocksPlugin, createUseEditor, fieldsPlugin, legacySideBarPlugin, outlinePlugin, pageMetadata, registerOverlayPortal, renderContext, setDeep, useEditor, useGetEditor, usePropsContext };
+export { Action, ActionBar, App, type AppContextValue, type AppEditorProps, type AppMatched, type AppProps, AppProvider, type AppProviderProps, type AppRenderProps, type AppRouterVariant, AutoField, Button, ComponentData, ComponentList, Config, Data, DefaultComponentProps, DefaultRootFieldProps, Drawer, Editor, EditorAction, type EditorApi, type EditorCommands, Field, FieldLabel, FieldProps, FieldTransforms, type GlobalsMap, Group, IconButton, IframeConfig, InitialHistory, type InsertComponentArgs, Label, Metadata, type MoveDestination, OnAction, Overrides, type PageMetadata, type Parent, Permissions, Plugin, Render, ResolveDataTrigger, RichTextMenu, type Route, type RouteKey, Separator, UiState, type UseEditorData, UserGenerics, Viewports, appConfigContext, blocksPlugin, createUseEditor, fieldsPlugin, legacySideBarPlugin, outlinePlugin, pageMetadata, registerOverlayPortal, renderContext, setDeep, useApp, useEditor, useGetEditor, usePropsContext, useRouteParams, useStableValue };