@reacteditor/core 0.0.16 → 0.0.18

package/dist/{chunk-3NSI5XES.mjs → chunk-WUEYD7ZN.mjs}

@@ -1,13 +1,13 @@
 import {
   EditorInner,
   LoadedRichTextMenu
-} from "./chunk-5QKQ3LQJ.mjs";
+} from "./chunk-NABX5FH7.mjs";
 import {
   ActionBar,
   IconButton,
   LoadedRichTextMenuInner,
   Loader
-} from "./chunk-Q667J2EG.mjs";
+} from "./chunk-UQHR5LFK.mjs";
 import {
   RichTextRenderFallback,
   SlotRender,
@@ -16,7 +16,7 @@ import {
   getSlotTransform,
   useRichtextProps,
   useSlots
-} from "./chunk-4L7H4JV4.mjs";
+} from "./chunk-AD67LVXW.mjs";
 import {
   Check,
   ChevronDown,
@@ -60,7 +60,7 @@ import {
   useRegisterFieldsSlice,
   useRegisterHistorySlice,
   useRegisterPermissionsSlice
-} from "./chunk-JHURG5NN.mjs";
+} from "./chunk-LFJGTSUB.mjs";
 import {
   getItem,
   insert,
@@ -74,7 +74,7 @@ import {
 } from "./chunk-FTVOCMGV.mjs";
 import {
   get_class_name_factory_default
-} from "./chunk-Y2EFNT5P.mjs";
+} from "./chunk-DQU3HIP4.mjs";
 import {
   defaultSlots,
   expandNode,
@@ -226,9 +226,8 @@ var Button = (_a) => {
       href
     }, dataAttrs), {
       children: [
-        icon && /* @__PURE__ */ jsx("div", { className: getClassName("icon"), children: icon }),
-        children,
-        loading && /* @__PURE__ */ jsx("div", { className: getClassName("spinner"), children: /* @__PURE__ */ jsx(Loader, { size: 14 }) })
+        loading ? /* @__PURE__ */ jsx("div", { className: getClassName("spinner"), children: /* @__PURE__ */ jsx(Loader, { size: 14 }) }) : icon && /* @__PURE__ */ jsx("div", { className: getClassName("icon"), children: icon }),
+        children
       ]
     })
   );
@@ -2146,7 +2145,7 @@ EditorFallback.displayName = "EditorFallback";
 // components/AutoField/fields/RichtextField/index.tsx
 import { Fragment as Fragment3, jsx as jsx20 } from "react/jsx-runtime";
 var Editor = lazy(
-  () => import("./Editor-J7XDD77B.mjs").then((m) => ({
+  () => import("./Editor-ULH2S4LO.mjs").then((m) => ({
     default: m.Editor
   }))
 );
@@ -4698,12 +4697,12 @@ import {
 } from "react";
 import { jsx as jsx30 } from "react/jsx-runtime";
 var Editor2 = lazy2(
-  () => import("./Editor-J7XDD77B.mjs").then((m) => ({
+  () => import("./Editor-ULH2S4LO.mjs").then((m) => ({
     default: m.Editor
   }))
 );
 var RichTextRender = lazy2(
-  () => import("./Render-STFB5CNO.mjs").then((m) => ({
+  () => import("./Render-IDDFFANP.mjs").then((m) => ({
     default: m.RichTextRender
   }))
 );
@@ -5896,6 +5895,9 @@ var createEditorCommands = (appStore) => {
       ui: { itemSelector: { index: sel.index, zone: sel.zone } }
     });
   };
+  const publish = () => {
+    void getState().publish();
+  };
   return {
     insertComponent: insertComponent2,
     removeComponent,
@@ -5905,7 +5907,8 @@ var createEditorCommands = (appStore) => {
     updateProps,
     updateRoot,
     selectComponent,
-    scrollToComponent
+    scrollToComponent,
+    publish
   };
 };
 
@@ -5924,6 +5927,8 @@ var generateUseEditor = (store, getState, commands) => {
   const storeData = __spreadProps(__spreadValues({}, commands), {
     appState: makeStatePublic(store.state),
     config: store.config,
+    route: store.route,
+    isPublishing: store.isPublishing,
     dispatch: store.dispatch,
     getPermissions: store.permissions.getPermissions,
     refreshPermissions: store.permissions.refreshPermissions,
@@ -5958,7 +5963,9 @@ var convertToPickedStore = (store) => {
     dispatch: store.dispatch,
     permissions: store.permissions,
     history: store.history,
-    selectedItem: store.selectedItem
+    selectedItem: store.selectedItem,
+    route: store.route,
+    isPublishing: store.isPublishing
   };
 };
 var useRegisterUseEditorStore = (appStore) => {
@@ -7634,18 +7641,19 @@ var DEVICE_VIEWPORTS = {
   mobile: { width: 360, height: "auto", icon: "Smartphone", label: "Mobile" }
 };
 var UrlBar = () => {
-  const { routes, currentRoute, onRouteChange } = usePropsContext();
+  const { routes, route, onRouteChange } = usePropsContext();
   const chrome = useChromeConfig();
-  const showRoutePicker = !!routes && currentRoute !== void 0 && !!onRouteChange;
-  const [inputValue, setInputValue] = useState20(currentRoute != null ? currentRoute : "");
-  const lastSyncedPath = useRef13(currentRoute);
-  if (lastSyncedPath.current !== currentRoute) {
-    lastSyncedPath.current = currentRoute;
-    setInputValue(currentRoute != null ? currentRoute : "");
+  const currentKey = route == null ? void 0 : route.key;
+  const showRoutePicker = !!routes && currentKey !== void 0 && !!onRouteChange;
+  const [inputValue, setInputValue] = useState20(currentKey != null ? currentKey : "");
+  const lastSyncedPath = useRef13(currentKey);
+  if (lastSyncedPath.current !== currentKey) {
+    lastSyncedPath.current = currentKey;
+    setInputValue(currentKey != null ? currentKey : "");
   }
   const submit = (raw) => {
     const next = normalizeRoute(raw);
-    if (!next || next === currentRoute) return;
+    if (!next || next === currentKey) return;
     void (onRouteChange == null ? void 0 : onRouteChange(next));
   };
   if (!chrome.showUrlBar) return null;
@@ -7654,7 +7662,7 @@ var UrlBar = () => {
       Combobox,
       {
         items: routes,
-        value: currentRoute,
+        value: currentKey,
         onValueChange: (next) => {
           if (typeof next === "string") submit(next);
         },
@@ -8425,12 +8433,12 @@ var TopHeader = ({
   pluginItems
 }) => {
   const appStore = useAppStoreApi();
-  const { onPublish, currentRoute } = usePropsContext();
   const chrome = useChromeConfig();
   const back = useAppStore((s) => s.history.back);
   const forward = useAppStore((s) => s.history.forward);
   const hasFuture = useAppStore((s) => s.history.hasFuture());
   const hasPast = useAppStore((s) => s.history.hasPast());
+  const isPublishing = useAppStore((s) => s.isPublishing);
   const CustomHeaderActions = useAppStore(
     (s) => s.overrides.headerActions || DefaultOverride
   );
@@ -8482,11 +8490,8 @@ var TopHeader = ({
       /* @__PURE__ */ jsx53(CustomHeaderActions, { children: /* @__PURE__ */ jsx53(
         Button,
         {
-          onClick: () => {
-            const data = appStore.getState().state.data;
-            onPublish && onPublish(data, currentRoute);
-          },
-          children: "Publish"
+          onClick: () => appStore.getState().publish(),
+          children: isPublishing ? "Publishing\u2026" : "Publish"
         }
       ) })
     ] })
@@ -8908,6 +8913,7 @@ function EditorProvider({ children }) {
     data: initialData,
     ui: initialUi,
     onChange,
+    onPublish,
     permissions = {},
     plugins,
     overrides,
@@ -8918,7 +8924,8 @@ function EditorProvider({ children }) {
     onAction,
     fieldTransforms,
     fullScreenCanvas,
-    _experimentalVirtualization
+    _experimentalVirtualization,
+    route
   } = usePropsContext();
   const iframe = useMemo24(
     () => __spreadValues({
@@ -9028,7 +9035,9 @@ function EditorProvider({ children }) {
         _experimentalVirtualization: !!_experimentalVirtualization,
         onAction,
         metadata,
-        fieldTransforms: loadedFieldTransforms
+        fieldTransforms: loadedFieldTransforms,
+        route: route != null ? route : null,
+        onPublish
       };
     },
     [
@@ -9043,7 +9052,9 @@ function EditorProvider({ children }) {
       _experimentalVirtualization,
       onAction,
       metadata,
-      loadedFieldTransforms
+      loadedFieldTransforms,
+      route,
+      onPublish
     ]
   );
   const [appStore] = useState24(
@@ -9131,34 +9142,31 @@ var useApp = () => {
   const rrNavigate = useNavigate();
   const currentPath = location.pathname || "/";
   const isEditing = cfg.editorPath !== null && (currentPath === cfg.editorPath || currentPath.startsWith(`${cfg.editorPath}/`));
-  const matchRoute = isEditing ? stripPrefix(currentPath, cfg.editorPath) : currentPath;
-  const matched = useMemo25(() => {
+  const pagePath = isEditing ? stripPrefix(currentPath, cfg.editorPath) : currentPath;
+  const route = useMemo25(() => {
     const routeKeys = Object.keys(cfg.pages);
     if (routeKeys.length === 0) return null;
     const matches = matchRoutes(
       routeKeys.map((path) => ({ path })),
-      matchRoute
+      pagePath
     );
     if (!matches || matches.length === 0) return null;
     const last = matches[matches.length - 1];
-    const key = last.route.path;
     return {
-      route: key,
-      params: last.params,
-      data: cfg.pages[key]
+      key: last.route.path,
+      path: pagePath,
+      params: last.params
     };
-  }, [cfg.pages, matchRoute]);
+  }, [cfg.pages, pagePath]);
   const routes = useMemo25(() => Object.keys(cfg.pages), [cfg.pages]);
-  const navigate = (route) => {
-    const target = isEditing && cfg.editorPath ? `${cfg.editorPath}${route === "/" ? "" : route}` || "/" : route;
-    rrNavigate(target || "/");
+  const navigate = (target) => {
+    const next = isEditing && cfg.editorPath ? `${cfg.editorPath}${target === "/" ? "" : target}` || "/" : target;
+    rrNavigate(next || "/");
   };
   return __spreadProps(__spreadValues({}, cfg), {
     routes,
-    currentPath,
     isEditing,
-    matchRoute,
-    matched,
+    route,
     navigate
   });
 };
@@ -9252,9 +9260,14 @@ function EditorForKey({
   editorProps,
   children
 }) {
-  const { config, pages, routes, navigate } = useApp();
+  const { config, pages, routes, navigate, route } = useApp();
   const data = pages[routeKey];
   if (!data) return null;
+  const editorRoute = {
+    key: routeKey,
+    path: (route == null ? void 0 : route.key) === routeKey ? route.path : routeKey,
+    params: (route == null ? void 0 : route.key) === routeKey ? route.params : {}
+  };
   return /* @__PURE__ */ jsx56(
     Editor3,
     {
@@ -9281,7 +9294,7 @@ function EditorForKey({
       disableZoomControls: editorProps.disableZoomControls,
       _experimentalVirtualization: editorProps._experimentalVirtualization,
       routes,
-      currentRoute: routeKey,
+      route: editorRoute,
       onRouteChange: (next) => navigate(next),
       children
     },

package/dist/{full-7ABPY2WA.css → full-B5V3G4IY.css}

@@ -88,25 +88,19 @@
 }
 
 /* css-module:/Users/rami/Documents/apps/react-editor/packages/core/components/Loader/styles.module.css/#css-module-data */
-@keyframes _loader-animation_nacdm_1 {
-  0% {
-    transform: rotate(0deg) scale(1);
+@keyframes _loader-spin_6933g_1 {
+  from {
+    transform: rotate(0deg);
   }
-  50% {
-    transform: rotate(180deg) scale(0.8);
-  }
-  100% {
-    transform: rotate(360deg) scale(1);
+  to {
+    transform: rotate(360deg);
   }
 }
-._Loader_nacdm_13 {
-  background: transparent;
-  border-radius: 100%;
-  border: 2px solid currentColor;
-  border-bottom-color: transparent;
-  display: inline-block;
-  animation: _loader-animation_nacdm_1 1s 0s infinite linear;
-  animation-fill-mode: both;
+._Loader_6933g_10 {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  animation: _loader-spin_6933g_1 1s linear infinite;
 }
 
 /* css-module:/Users/rami/Documents/apps/react-editor/packages/core/components/ActionBar/styles.module.css/#css-module-data */

package/dist/{full-T5SGODJ2.mjs → full-LIVYWOAF.mjs}

@@ -1,13 +1,13 @@
 import {
   LoadedRichTextMenuInner
-} from "./chunk-Q667J2EG.mjs";
-import "./chunk-RQZQMS6E.mjs";
-import "./chunk-RGC274VM.mjs";
-import "./chunk-TG2KTWSB.mjs";
-import "./chunk-JHURG5NN.mjs";
+} from "./chunk-UQHR5LFK.mjs";
+import "./chunk-HR67L662.mjs";
+import "./chunk-DGIVBKSJ.mjs";
+import "./chunk-IOAYKTDH.mjs";
+import "./chunk-LFJGTSUB.mjs";
 import "./chunk-M4JDRFYB.mjs";
 import "./chunk-FTVOCMGV.mjs";
-import "./chunk-Y2EFNT5P.mjs";
+import "./chunk-DQU3HIP4.mjs";
 import "./chunk-JIXMPJZA.mjs";
 import {
   __spreadValues,

package/dist/{index-BZRpxcwy.d.mts → index-CUe2XTb6.d.mts}

@@ -69,6 +69,23 @@ type ZoomConfig = {
 type ComponentState = Record<string, {
     loadingCount: number;
 }>;
+/**
+ * Routing descriptor for the page currently loaded in the editor. Mirrored
+ * from `useApp().route` by `<App>` and exposed via `useEditor((s) => s.route)`.
+ */
+type EditorRoute = {
+    /** Route key/pattern, e.g. "/posts/:handle". */
+    key: string;
+    /** Canonical page URL (editorPath stripped), e.g. "/posts/abc". */
+    path: string;
+    /** Concrete URL params extracted from the URL. */
+    params: Record<string, string | undefined>;
+};
+/** Publish callback signature — receives current data + route descriptor. */
+type OnPublish<UserData = unknown> = (payload: {
+    data: UserData;
+    route: EditorRoute | null;
+}) => void | Promise<void>;
 type AppStore<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
     instanceId: string;
     state: G["UserAppState"];
@@ -113,6 +130,16 @@ type AppStore<UserConfig extends Config = Config, G extends UserGenerics<UserCon
         id: string;
     } | null;
     scrollToComponent: (id: string) => void;
+    route: EditorRoute | null;
+    onPublish?: OnPublish<G["UserData"]>;
+    /** True while a `publish()` call is in flight. */
+    isPublishing: boolean;
+    /**
+     * Invoke the user's `onPublish` with the current data + route, awaiting
+     * the result. `isPublishing` flips true for the duration. No-op when
+     * `onPublish` isn't set.
+     */
+    publish: () => Promise<void>;
 };
 
-export type { AppStore as A, GetPermissions as G, HistorySlice as H, RefreshPermissions as R };
+export type { AppStore as A, EditorRoute as E, GetPermissions as G, HistorySlice as H, OnPublish as O, RefreshPermissions as R };

package/dist/{index-B_21fGrq.d.ts → index-CYzc1n29.d.ts}

@@ -69,6 +69,23 @@ type ZoomConfig = {
 type ComponentState = Record<string, {
     loadingCount: number;
 }>;
+/**
+ * Routing descriptor for the page currently loaded in the editor. Mirrored
+ * from `useApp().route` by `<App>` and exposed via `useEditor((s) => s.route)`.
+ */
+type EditorRoute = {
+    /** Route key/pattern, e.g. "/posts/:handle". */
+    key: string;
+    /** Canonical page URL (editorPath stripped), e.g. "/posts/abc". */
+    path: string;
+    /** Concrete URL params extracted from the URL. */
+    params: Record<string, string | undefined>;
+};
+/** Publish callback signature — receives current data + route descriptor. */
+type OnPublish<UserData = unknown> = (payload: {
+    data: UserData;
+    route: EditorRoute | null;
+}) => void | Promise<void>;
 type AppStore<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
     instanceId: string;
     state: G["UserAppState"];
@@ -113,6 +130,16 @@ type AppStore<UserConfig extends Config = Config, G extends UserGenerics<UserCon
         id: string;
     } | null;
     scrollToComponent: (id: string) => void;
+    route: EditorRoute | null;
+    onPublish?: OnPublish<G["UserData"]>;
+    /** True while a `publish()` call is in flight. */
+    isPublishing: boolean;
+    /**
+     * Invoke the user's `onPublish` with the current data + route, awaiting
+     * the result. `isPublishing` flips true for the duration. No-op when
+     * `onPublish` isn't set.
+     */
+    publish: () => Promise<void>;
 };
 
-export type { AppStore as A, GetPermissions as G, HistorySlice as H, RefreshPermissions as R };
+export type { AppStore as A, EditorRoute as E, GetPermissions as G, HistorySlice as H, OnPublish as O, RefreshPermissions as R };

package/dist/index.css

@@ -706,25 +706,19 @@ textarea._Input-input_zwh6e_27 {
 }
 
 /* css-module:/Users/rami/Documents/apps/react-editor/packages/core/components/Loader/styles.module.css/#css-module-data */
-@keyframes _loader-animation_nacdm_1 {
-  0% {
-    transform: rotate(0deg) scale(1);
+@keyframes _loader-spin_6933g_1 {
+  from {
+    transform: rotate(0deg);
   }
-  50% {
-    transform: rotate(180deg) scale(0.8);
-  }
-  100% {
-    transform: rotate(360deg) scale(1);
+  to {
+    transform: rotate(360deg);
   }
 }
-._Loader_nacdm_13 {
-  background: transparent;
-  border-radius: 100%;
-  border: 2px solid currentColor;
-  border-bottom-color: transparent;
-  display: inline-block;
-  animation: _loader-animation_nacdm_1 1s 0s infinite linear;
-  animation-fill-mode: both;
+._Loader_6933g_10 {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  animation: _loader-spin_6933g_1 1s linear infinite;
 }
 
 /* css-module:/Users/rami/Documents/apps/react-editor/packages/core/components/DragIcon/styles.module.css/#css-module-data */

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, O as OnAction, f as UiState, q as EditorChromeConfig, d as Plugin, e as Overrides, h as FieldTransforms, M as Metadata, I as IframeConfig, V as Viewports, a as Permissions, E as EditorAction, r as InitialHistory, b as ComponentData, l as DefaultComponentProps, m as DefaultRootFieldProps, c as ResolveDataTrigger, s as ItemSelector, t as PluginInternal } from './actions-BxLinRKD.mjs';
 export { u as Adaptor, A as AppState, v as ArrayField, w as ArrayState, x as AsFieldProps, B as BaseData, y as BaseField, z as CacheOpts, G as ColorField, g as ComponentConfig, J as ComponentConfigExtensions, K as ComponentConfigParams, L as ComponentDataMap, N as ComponentDataOptionalId, Q as ComponentMetadata, S as ConfigParams, j as Content, T as CustomField, X as CustomFieldRender, k as DefaultComponents, Y as DefaultRootProps, Z as DefaultRootRenderProps, _ as Direction, $ as DragAxis, a0 as EditorComponent, a1 as EditorContext, a2 as EditorMetadata, a3 as ExternalField, a4 as ExternalFieldWithAdaptor, a5 as ExtractConfigParams, a6 as ExtractField, a7 as FieldMetadata, a8 as FieldRenderFunctions, a9 as FieldTransformFn, aa as FieldTransformFnParams, F as Fields, H as History, ab as ItemWithId, ac as MappedItem, ad as NumberField, ae as ObjectField, af as OverrideKey, ag as RadioField, ah as RichText, i as RichtextField, ai as RootConfig, n as RootData, R as RootDataWithProps, aj as RootDataWithoutProps, ak as SelectField, al as Slot, am as SlotComponent, an as SlotField, ao as TextField, ap as TextareaField, aq as Viewport, ar as WithChildren, as as WithEditorProps, W as WithId, at as WithSlotProps, au as overrideKeys } from './actions-BxLinRKD.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-BvYigWFL.mjs';
+import { O as OnPublish, E as EditorRoute, A as AppStore, G as GetPermissions, R as RefreshPermissions, H as HistorySlice } from './index-CUe2XTb6.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-BZRpxcwy.mjs';
 import '@tiptap/react';
 import '@tiptap/extension-blockquote';
 import '@tiptap/extension-bold';
@@ -34,8 +34,8 @@ type GlobalsMap = NonNullable<Data["globals"]>;
  * 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
+ *   - `<Editor route={{ key: routeKey, path, params }}>` marks the selected page
+ *   - `onPublish({ data, route })` returns the descriptor for persistence
  *
  * Patterns follow path-to-regexp v8 / Express 5 syntax: "/", "/about",
  * "/products/:handle", "/docs/*splat".
@@ -93,13 +93,18 @@ declare function AutoField<ValueType = any, FieldType extends FieldNoLabel<Value
 
 /** 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;
+/**
+ * Routing descriptor for the current page. Pure routing info — no page data
+ * (use `pages[route.key]` for the static initial, or `useEditor((s) => s.appState.data)`
+ * for the live editor data).
+ */
+type AppRoute = {
+    /** Route key/pattern, e.g. "/posts/:handle". */
+    key: RouteKey;
+    /** Canonical page URL with `editorPath` stripped, e.g. "/posts/abc". */
+    path: string;
     /** 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;
@@ -111,14 +116,10 @@ declare const appConfigContext: react.Context<AppConfigContext<Config, UserGener
 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. */
+    /** True when the live URL is under `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;
+    /** Resolved routing descriptor for the current page. Null = 404. */
+    route: AppRoute | null;
     /** Navigate to a route key. Wraps with editorPath when editing. */
     navigate: (route: RouteKey) => void;
 };
@@ -149,8 +150,8 @@ declare function AppProvider<UserConfig extends Config = Config, G extends UserG
 
 /** 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;
+    /** Called when the editor publishes — receives `{ data, route }`. */
+    onPublish?: OnPublish<G["UserData"]>;
     onChange?: (data: G["UserData"]) => void;
     onAction?: OnAction<G["UserData"]>;
     ui?: Partial<UiState> & Partial<EditorChromeConfig>;
@@ -296,7 +297,7 @@ type EditorProps<UserConfig extends Config = Config, G extends UserGenerics<User
      */
     ui?: Partial<UiState> & Partial<EditorChromeConfig>;
     onChange?: (data: G["UserData"]) => void;
-    onPublish?: (data: G["UserData"], route?: string) => void;
+    onPublish?: OnPublish<G["UserData"]>;
     onAction?: OnAction<G["UserData"]>;
     permissions?: Partial<Permissions>;
     plugins?: Plugin<UserConfig>[];
@@ -315,7 +316,12 @@ type EditorProps<UserConfig extends Config = Config, G extends UserGenerics<User
     headerPath?: string;
     title?: ReactNode;
     routes?: Route[];
-    currentRoute?: string;
+    /**
+     * Routing descriptor for the page being edited. Mirrored into the editor
+     * store and exposed via `useEditor((s) => s.route)`. Set by `<App>` from
+     * `useApp().route`; usually omitted when mounting `<Editor>` standalone.
+     */
+    route?: EditorRoute;
     onRouteChange?: (path: string) => void | Promise<void>;
     viewports?: Viewports;
     iframe?: IframeConfig;
@@ -501,11 +507,20 @@ type EditorCommands = {
     updateRoot: (updater: Partial<DefaultRootFieldProps> | ((prev: DefaultRootFieldProps) => Partial<DefaultRootFieldProps>)) => void;
     selectComponent: (id: string | null) => void;
     scrollToComponent: (id: string) => void;
+    /**
+     * Invoke the user's `onPublish` callback with the current editor data and
+     * route descriptor. No-op when `onPublish` isn't set on the Editor.
+     */
+    publish: () => void;
 };
 
 type UseEditorData<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = EditorCommands & {
     appState: G["UserPublicAppState"];
     config: UserConfig;
+    /** Routing descriptor for the page being edited. Null when standalone or 404. */
+    route: EditorRoute | null;
+    /** True while a `publish()` call is in flight. */
+    isPublishing: boolean;
     dispatch: AppStore["dispatch"];
     getPermissions: GetPermissions<UserConfig>;
     refreshPermissions: RefreshPermissions<UserConfig>;
@@ -557,4 +572,4 @@ declare const outlinePlugin: () => Plugin;
 
 declare const legacySideBarPlugin: () => Plugin;
 
-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, EditorChromeConfig, 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 };
+export { Action, ActionBar, App, type AppContextValue, type AppEditorProps, type AppProps, AppProvider, type AppProviderProps, type AppRenderProps, type AppRoute, type AppRouterVariant, AutoField, Button, ComponentData, ComponentList, Config, Data, DefaultComponentProps, DefaultRootFieldProps, Drawer, Editor, EditorAction, type EditorApi, EditorChromeConfig, type EditorCommands, EditorRoute, Field, FieldLabel, FieldProps, FieldTransforms, type GlobalsMap, Group, IconButton, IframeConfig, InitialHistory, type InsertComponentArgs, Label, Metadata, type MoveDestination, OnAction, OnPublish, 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 };