@reacteditor/core 0.0.9 → 0.0.10

package/dist/no-external.mjs

@@ -1,4 +1,6 @@
 import {
+  App,
+  AppProvider,
   AutoField,
   Button,
   ComponentList,
@@ -6,6 +8,7 @@ import {
   Editor,
   FieldLabel,
   Render,
+  appConfigContext,
   blocksPlugin,
   createUseEditor,
   fieldsPlugin,
@@ -16,17 +19,14 @@ import {
   registerOverlayPortal,
   renderContext,
   setDeep,
+  useApp,
   useEditor,
   useGetEditor,
-  usePropsContext
-} from "./chunk-DU757QEH.mjs";
-import "./chunk-AJWRDM22.mjs";
-import {
-  migrate,
-  resolveAllData,
-  transformProps
-} from "./chunk-TI3KC54Y.mjs";
-import "./chunk-6QJ2HF4O.mjs";
+  usePropsContext,
+  useRouteParams,
+  useStableValue
+} from "./chunk-3IP22OOD.mjs";
+import "./chunk-BZ4BQZJR.mjs";
 import {
   Action,
   ActionBar,
@@ -35,10 +35,18 @@ import {
   Label,
   RichTextMenu,
   Separator
-} from "./chunk-U7VW3V3W.mjs";
+} from "./chunk-BUR5T7IX.mjs";
+import "./chunk-FT6UFK7G.mjs";
+import {
+  getRouteProps,
+  migrate,
+  resolveAllData,
+  resolveRouteFromString,
+  transformProps
+} from "./chunk-PUDWMFBH.mjs";
+import "./chunk-6QJ2HF4O.mjs";
 import "./chunk-OIFPBVSF.mjs";
 import "./chunk-AD7BMXAA.mjs";
-import "./chunk-FT6UFK7G.mjs";
 import "./chunk-LRFRIIKG.mjs";
 import "./chunk-M4JDRFYB.mjs";
 import "./chunk-IIRJMJFU.mjs";
@@ -55,6 +63,8 @@ init_react_import();
 export {
   Action,
   ActionBar,
+  App,
+  AppProvider,
   AutoField,
   Button,
   ComponentList,
@@ -67,9 +77,11 @@ export {
   Render,
   RichTextMenu,
   Separator,
+  appConfigContext,
   blocksPlugin,
   createUseEditor,
   fieldsPlugin,
+  getRouteProps,
   legacySideBarPlugin,
   migrate,
   outlinePlugin,
@@ -78,10 +90,14 @@ export {
   registerOverlayPortal,
   renderContext,
   resolveAllData,
+  resolveRouteFromString,
   setDeep,
   transformProps,
+  useApp,
   useEditor,
   useGetEditor,
   usePropsContext,
+  useRouteParams,
+  useStableValue,
   walkTree
 };

package/dist/remix.d.mts

@@ -0,0 +1,33 @@
+/**
+ * Remix helpers for `<App>`.
+ *
+ * Pure functions — no `@remix-run/*` imports — namespaced for future
+ * extension.
+ */
+type RemixSplatParams = {
+    /** The splat segment from a `$.tsx` route. */
+    "*"?: string;
+};
+type RemixResolvedRoute = {
+    /** Full path including any editor prefix, e.g. "/editor/products/foo". */
+    route: string;
+    /** True when `route` starts with the editor prefix. */
+    isEditor: boolean;
+    /** Path with the editor prefix stripped — what schemas match against. */
+    matchRoute: string;
+};
+/**
+ * Resolve Remix splat params into a route descriptor for `<App>`.
+ *
+ * Mounted at `app/routes/$.tsx`:
+ *   - `/products/abc` → `{ route: "/products/abc", isEditor: false, matchRoute: "/products/abc" }`
+ *   - `/editor/products/abc` → `{ route: "/editor/products/abc", isEditor: true, matchRoute: "/products/abc" }`
+ *
+ * `editorPath` defaults to "/editor" — same default as `<App>`. Pass `null`
+ * to skip editor-mode classification.
+ */
+declare const remixResolveRoute: (params: RemixSplatParams, options?: {
+    editorPath?: string | null;
+}) => RemixResolvedRoute;
+
+export { type RemixResolvedRoute, type RemixSplatParams, remixResolveRoute };

package/dist/remix.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Remix helpers for `<App>`.
+ *
+ * Pure functions — no `@remix-run/*` imports — namespaced for future
+ * extension.
+ */
+type RemixSplatParams = {
+    /** The splat segment from a `$.tsx` route. */
+    "*"?: string;
+};
+type RemixResolvedRoute = {
+    /** Full path including any editor prefix, e.g. "/editor/products/foo". */
+    route: string;
+    /** True when `route` starts with the editor prefix. */
+    isEditor: boolean;
+    /** Path with the editor prefix stripped — what schemas match against. */
+    matchRoute: string;
+};
+/**
+ * Resolve Remix splat params into a route descriptor for `<App>`.
+ *
+ * Mounted at `app/routes/$.tsx`:
+ *   - `/products/abc` → `{ route: "/products/abc", isEditor: false, matchRoute: "/products/abc" }`
+ *   - `/editor/products/abc` → `{ route: "/editor/products/abc", isEditor: true, matchRoute: "/products/abc" }`
+ *
+ * `editorPath` defaults to "/editor" — same default as `<App>`. Pass `null`
+ * to skip editor-mode classification.
+ */
+declare const remixResolveRoute: (params: RemixSplatParams, options?: {
+    editorPath?: string | null;
+}) => RemixResolvedRoute;
+
+export { type RemixResolvedRoute, type RemixSplatParams, remixResolveRoute };

package/dist/remix.js

@@ -0,0 +1,65 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// bundle/remix.ts
+var remix_exports = {};
+__export(remix_exports, {
+  remixResolveRoute: () => remixResolveRoute
+});
+module.exports = __toCommonJS(remix_exports);
+
+// ../tsup-config/react-import.js
+var import_react = __toESM(require("react"));
+
+// bundle/remix.ts
+var DEFAULT_EDITOR_PATH = "/editor";
+var stripEditorPrefix = (route, editorPath) => {
+  if (!editorPath) return route;
+  if (route === editorPath) return "/";
+  if (!route.startsWith(`${editorPath}/`)) return route;
+  const rest = route.slice(editorPath.length);
+  return rest.startsWith("/") ? rest : `/${rest}`;
+};
+var buildRoute = (params) => {
+  var _a;
+  const splat = (_a = params == null ? void 0 : params["*"]) != null ? _a : "";
+  if (!splat) return "/";
+  return splat.startsWith("/") ? splat : `/${splat}`;
+};
+var remixResolveRoute = (params, options) => {
+  const editorPath = (options == null ? void 0 : options.editorPath) === void 0 ? DEFAULT_EDITOR_PATH : options.editorPath;
+  const route = buildRoute(params);
+  const isEditor = editorPath !== null && (route === editorPath || route.startsWith(`${editorPath}/`));
+  const matchRoute = isEditor ? stripEditorPrefix(route, editorPath) : route;
+  return { route, isEditor, matchRoute };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  remixResolveRoute
+});

package/dist/remix.mjs

@@ -0,0 +1,30 @@
+import {
+  init_react_import
+} from "./chunk-M6W7YEVX.mjs";
+
+// bundle/remix.ts
+init_react_import();
+var DEFAULT_EDITOR_PATH = "/editor";
+var stripEditorPrefix = (route, editorPath) => {
+  if (!editorPath) return route;
+  if (route === editorPath) return "/";
+  if (!route.startsWith(`${editorPath}/`)) return route;
+  const rest = route.slice(editorPath.length);
+  return rest.startsWith("/") ? rest : `/${rest}`;
+};
+var buildRoute = (params) => {
+  var _a;
+  const splat = (_a = params == null ? void 0 : params["*"]) != null ? _a : "";
+  if (!splat) return "/";
+  return splat.startsWith("/") ? splat : `/${splat}`;
+};
+var remixResolveRoute = (params, options) => {
+  const editorPath = (options == null ? void 0 : options.editorPath) === void 0 ? DEFAULT_EDITOR_PATH : options.editorPath;
+  const route = buildRoute(params);
+  const isEditor = editorPath !== null && (route === editorPath || route.startsWith(`${editorPath}/`));
+  const matchRoute = isEditor ? stripEditorPrefix(route, editorPath) : route;
+  return { route, isEditor, matchRoute };
+};
+export {
+  remixResolveRoute
+};

package/dist/rsc.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as Config, U as UserGenerics, M as Metadata } from './actions-2L-1hQ7r.mjs';
-export { m as migrate, r as resolveAllData, t as transformProps, w as walkTree } from './walk-tree-4C3ODO3X.mjs';
+import { C as Config, U as UserGenerics, M as Metadata } from './actions-B8_EA7vy.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-BR2XIZ0W.mjs';
 import 'react';
 import '@tiptap/react';
 import '@tiptap/extension-blockquote';

package/dist/rsc.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as Config, U as UserGenerics, M as Metadata } from './actions-2L-1hQ7r.js';
-export { m as migrate, r as resolveAllData, t as transformProps, w as walkTree } from './walk-tree-C9GrSWsR.js';
+import { C as Config, U as UserGenerics, M as Metadata } from './actions-B8_EA7vy.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-DpUJ9kDx.js';
 import 'react';
 import '@tiptap/react';
 import '@tiptap/extension-blockquote';

package/dist/rsc.js

@@ -356,8 +356,10 @@ var init_Render = __esm({
 var rsc_exports = {};
 __export(rsc_exports, {
   Render: () => Render,
+  getRouteProps: () => getRouteProps,
   migrate: () => migrate,
   resolveAllData: () => resolveAllData,
+  resolveRouteFromString: () => resolveRouteFromString,
   transformProps: () => transformProps,
   walkTree: () => walkTree
 });
@@ -1474,11 +1476,57 @@ function migrate(data, config, migrationOptions) {
     data
   );
 }
+
+// lib/get-route-props.ts
+init_react_import();
+var import_react_router = require("react-router");
+var DEFAULT_EDITOR_PATH = "/editor";
+var stripEditorPrefix = (currentRoute, editorPath) => {
+  if (!editorPath) return currentRoute;
+  if (currentRoute === editorPath) return "/";
+  if (!currentRoute.startsWith(`${editorPath}/`)) return currentRoute;
+  const rest = currentRoute.slice(editorPath.length);
+  return rest.startsWith("/") ? rest : `/${rest}`;
+};
+var findMatch = (pages, pathname) => {
+  const keys = Object.keys(pages);
+  if (keys.length === 0) return null;
+  const matches = (0, import_react_router.matchRoutes)(
+    keys.map((path) => ({ path })),
+    pathname
+  );
+  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: pages[key] };
+};
+var getRouteProps = (pages, currentRoute, options = {}) => {
+  var _a, _b;
+  const editorPath = options.editorPath === void 0 ? DEFAULT_EDITOR_PATH : options.editorPath;
+  const matchRoute = stripEditorPrefix(currentRoute || "/", editorPath);
+  const match = findMatch(pages, matchRoute);
+  if (!match) return null;
+  const props = (_b = (_a = match.data) == null ? void 0 : _a.root) == null ? void 0 : _b.props;
+  return props != null ? props : null;
+};
+var resolveRouteFromString = (pages, currentRoute, options = {}) => {
+  const editorPath = options.editorPath === void 0 ? DEFAULT_EDITOR_PATH : options.editorPath;
+  const matchRoute = stripEditorPrefix(currentRoute || "/", editorPath);
+  const match = findMatch(pages, matchRoute);
+  if (!match) return null;
+  return {
+    route: match.route,
+    data: match.data,
+    params: match.params
+  };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Render,
+  getRouteProps,
   migrate,
   resolveAllData,
+  resolveRouteFromString,
   transformProps,
   walkTree
 });

package/dist/rsc.mjs

@@ -1,11 +1,13 @@
 import {
   SlotRenderPure,
+  getRouteProps,
   migrate,
   resolveAllData,
+  resolveRouteFromString,
   transformProps,
   useRichtextProps,
   useSlots
-} from "./chunk-TI3KC54Y.mjs";
+} from "./chunk-PUDWMFBH.mjs";
 import "./chunk-6QJ2HF4O.mjs";
 import "./chunk-IIRJMJFU.mjs";
 import "./chunk-Y2EFNT5P.mjs";
@@ -141,8 +143,10 @@ function Render({
 }
 export {
   Render,
+  getRouteProps,
   migrate,
   resolveAllData,
+  resolveRouteFromString,
   transformProps,
   walkTree
 };

package/dist/{walk-tree-4C3ODO3X.d.mts → walk-tree-BR2XIZ0W.d.mts}

@@ -1,4 +1,35 @@
-import { C as Config, D as Data, W as WithId, U as UserGenerics, a as Content, b as ComponentData, c as DefaultComponents, d as DefaultComponentProps, e as DefaultRootFieldProps, M as Metadata, R as RootData } from './actions-2L-1hQ7r.mjs';
+import { C as Config, D as Data, W as WithId, U as UserGenerics, j as Content, b as ComponentData, k as DefaultComponents, l as DefaultComponentProps, m as DefaultRootFieldProps, M as Metadata, n as RootData } from './actions-B8_EA7vy.mjs';
+
+type GetRoutePropsOptions = {
+    /** Defaults to "/editor". Pass null to skip editor-prefix handling. */
+    editorPath?: string | null;
+};
+type AnyPages = Record<string, {
+    root?: {
+        props?: unknown;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}>;
+/**
+ * Resolve the matched page for `currentRoute` against `pages` and return its
+ * `root.props`. Editor prefix is stripped first so `/edit/about` returns the
+ * same root props as `/about`.
+ *
+ * Server-safe — uses `matchRoutes` from `react-router` which is a pure
+ * non-React utility. Useful in Next's `generateMetadata` and similar hooks.
+ */
+declare const getRouteProps: <P = Record<string, unknown>>(pages: AnyPages, currentRoute: string, options?: GetRoutePropsOptions) => P | null;
+/**
+ * Lower-level variant that returns the matched route key alongside the data,
+ * for callers that need to know which entry resolved (canonical URLs,
+ * persistence keys, etc.) server-side.
+ */
+declare const resolveRouteFromString: <Data = unknown>(pages: Record<string, Data>, currentRoute: string, options?: GetRoutePropsOptions) => {
+    route: string;
+    data: Data;
+    params: Readonly<Record<string, string | undefined>>;
+} | null;
 
 type MigrationOptions<UserConfig extends Config> = {
     migrateDynamicZonesForComponent?: {
@@ -26,4 +57,4 @@ type WalkTreeOptions = {
 };
 declare function walkTree<T extends ComponentData | RootData | G["UserData"], UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>(data: T, config: UserConfig, callbackFn: (data: Content, options: WalkTreeOptions) => Content | null | void): T;
 
-export { migrate as m, resolveAllData as r, transformProps as t, walkTree as w };
+export { type GetRoutePropsOptions as G, resolveRouteFromString as a, getRouteProps as g, migrate as m, resolveAllData as r, transformProps as t, walkTree as w };

package/dist/{walk-tree-C9GrSWsR.d.ts → walk-tree-DpUJ9kDx.d.ts}

@@ -1,4 +1,35 @@
-import { C as Config, D as Data, W as WithId, U as UserGenerics, a as Content, b as ComponentData, c as DefaultComponents, d as DefaultComponentProps, e as DefaultRootFieldProps, M as Metadata, R as RootData } from './actions-2L-1hQ7r.js';
+import { C as Config, D as Data, W as WithId, U as UserGenerics, j as Content, b as ComponentData, k as DefaultComponents, l as DefaultComponentProps, m as DefaultRootFieldProps, M as Metadata, n as RootData } from './actions-B8_EA7vy.js';
+
+type GetRoutePropsOptions = {
+    /** Defaults to "/editor". Pass null to skip editor-prefix handling. */
+    editorPath?: string | null;
+};
+type AnyPages = Record<string, {
+    root?: {
+        props?: unknown;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}>;
+/**
+ * Resolve the matched page for `currentRoute` against `pages` and return its
+ * `root.props`. Editor prefix is stripped first so `/edit/about` returns the
+ * same root props as `/about`.
+ *
+ * Server-safe — uses `matchRoutes` from `react-router` which is a pure
+ * non-React utility. Useful in Next's `generateMetadata` and similar hooks.
+ */
+declare const getRouteProps: <P = Record<string, unknown>>(pages: AnyPages, currentRoute: string, options?: GetRoutePropsOptions) => P | null;
+/**
+ * Lower-level variant that returns the matched route key alongside the data,
+ * for callers that need to know which entry resolved (canonical URLs,
+ * persistence keys, etc.) server-side.
+ */
+declare const resolveRouteFromString: <Data = unknown>(pages: Record<string, Data>, currentRoute: string, options?: GetRoutePropsOptions) => {
+    route: string;
+    data: Data;
+    params: Readonly<Record<string, string | undefined>>;
+} | null;
 
 type MigrationOptions<UserConfig extends Config> = {
     migrateDynamicZonesForComponent?: {
@@ -26,4 +57,4 @@ type WalkTreeOptions = {
 };
 declare function walkTree<T extends ComponentData | RootData | G["UserData"], UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>(data: T, config: UserConfig, callbackFn: (data: Content, options: WalkTreeOptions) => Content | null | void): T;
 
-export { migrate as m, resolveAllData as r, transformProps as t, walkTree as w };
+export { type GetRoutePropsOptions as G, resolveRouteFromString as a, getRouteProps as g, migrate as m, resolveAllData as r, transformProps as t, walkTree as w };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reacteditor/core",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "The open-source visual editor for React",
   "author": "Rami Bitar <rami@frontend.co>",
   "repository": "frontend-inc/react-editor",
@@ -50,6 +50,16 @@
       "import": "./dist/internal.mjs",
       "require": "./dist/internal.js"
     },
+    "./nextjs": {
+      "types": "./dist/nextjs.d.ts",
+      "import": "./dist/nextjs.mjs",
+      "require": "./dist/nextjs.js"
+    },
+    "./remix": {
+      "types": "./dist/remix.d.ts",
+      "import": "./dist/remix.mjs",
+      "require": "./dist/remix.js"
+    },
     "./react-editor.css": "./dist/index.css",
     "./no-external.css": "./dist/no-external.css",
     "./dist/index.css": "./dist/index.css",
@@ -65,7 +75,7 @@
   "license": "MIT",
   "scripts": {
     "lint": "eslint \"**/*.ts*\"",
-    "build": "rm -rf dist && tsup bundle/index.ts bundle/rsc.tsx bundle/no-external.ts bundle/internal.ts",
+    "build": "rm -rf dist && tsup bundle/index.ts bundle/rsc.tsx bundle/no-external.ts bundle/internal.ts bundle/nextjs.ts bundle/remix.ts",
     "test": "jest",
     "prepare": "cp ../../README.md . && yarn build",
     "postpublish": "rm README.md"
@@ -140,6 +150,7 @@
     "zustand": "^5.0.3"
   },
   "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0"
+    "react": "^18.0.0 || ^19.0.0",
+    "react-router": "^7.0.0"
   }
 }

package/dist/{chunk-U7VW3V3W.mjs → chunk-BUR5T7IX.mjs}

@@ -1,12 +1,12 @@
+import {
+  useListOptions
+} from "./chunk-FT6UFK7G.mjs";
 import {
   useAlignOptions
 } from "./chunk-OIFPBVSF.mjs";
 import {
   useHeadingOptions
 } from "./chunk-AD7BMXAA.mjs";
-import {
-  useListOptions
-} from "./chunk-FT6UFK7G.mjs";
 import {
   AlignCenter,
   AlignJustify,