@rebasepro/app 0.17.3-canary.gdd23447 → 0.18.0

package/README.md

@@ -8,6 +8,10 @@ Framework-agnostic runtime for data-driven admin panels — React hooks, provide
 pnpm add @rebasepro/app
 ```
 
+ESM-only: `"type": "module"` with no CommonJS build, so it is loaded with
+`import`. `require()` of it resolves only on Node 22.12+, which supports
+`require(esm)`.
+
 **Peer dependencies:** `react >= 19.2.7`, `react-dom >= 19.2.7`, `react-router ^8`
 
 ## What This Package Does
@@ -97,7 +101,6 @@ This package is **framework-agnostic** in the sense that it doesn't depend on an
 | `LanguageToggle` | i18n language switcher |
 | `BootstrapAdminBanner` | First-user setup banner |
 | `RebaseLogo` | Rebase branding logo |
-| `UIStyleGuide` / `UIReferenceView` | Debug/reference components |
 
 ### Contexts
 

package/dist/components/index.d.ts

@@ -6,9 +6,6 @@ export * from "./ConfirmationDialog.js";
 export * from "./ErrorTooltip.js";
 export * from "./RebaseLogo.js";
 export * from "./AIIcon.js";
-export * from "./Debug/UIStyleGuide.js";
-export * from "./Debug/UIReferenceView.js";
-export { CrmDashboardDemo } from "./Debug/crm-dashboard/CrmDashboardDemo.js";
 export * from "./UserSettingsView.js";
 export * from "./LanguageToggle.js";
 export * from "./UserSelectPopover.js";

package/dist/contexts/AuthControllerContext.d.ts

@@ -1,3 +1,4 @@
 import React from "react";
 import { AuthController } from "@rebasepro/cms-types";
-export declare const AuthControllerContext: React.Context<AuthController<any, any>>;
+/** `null` outside `<Rebase>` — see {@link RebaseDataContext}. */
+export declare const AuthControllerContext: React.Context<AuthController<any, any> | null>;

package/dist/contexts/CustomizationControllerContext.d.ts

@@ -1,3 +1,4 @@
 import type { CustomizationController } from "@rebasepro/cms-types";
 import React from "react";
-export declare const CustomizationControllerContext: React.Context<CustomizationController>;
+/** `null` outside `<Rebase>` — see {@link RebaseDataContext}. */
+export declare const CustomizationControllerContext: React.Context<CustomizationController | null>;

package/dist/contexts/DialogsProvider.d.ts

@@ -1,4 +1,5 @@
 import type { DialogsController } from "@rebasepro/cms-types";
 import React, { PropsWithChildren } from "react";
-export declare const DialogsControllerContext: React.Context<DialogsController>;
+/** `null` outside `<Rebase>` — see `RebaseDataContext`. */
+export declare const DialogsControllerContext: React.Context<DialogsController | null>;
 export declare const DialogsProvider: React.FC<PropsWithChildren>;

package/dist/contexts/RebaseDataContext.d.ts

@@ -1,3 +1,12 @@
 import React from "react";
 import { RebaseData } from "@rebasepro/types";
-export declare const RebaseDataContext: React.Context<RebaseData>;
+/**
+ * `null` outside `<Rebase>`, so {@link useData} can say so.
+ *
+ * The default used to be `{} as RebaseData` — a lie the type system agreed
+ * with. A hook called outside the tree handed back an empty object, and the
+ * first thing anyone does with it is `data.collection("posts")`, which fails as
+ * "data.collection is not a function" somewhere in a component's render. That
+ * names neither the hook nor the missing provider.
+ */
+export declare const RebaseDataContext: React.Context<RebaseData | null>;

package/dist/contexts/StorageSourceContext.d.ts

@@ -1,3 +1,13 @@
 import React from "react";
 import { StorageSource } from "@rebasepro/types";
-export declare const StorageSourceContext: React.Context<StorageSource>;
+/**
+ * Three states, and they mean different things:
+ *
+ * - `null` — outside `<Rebase>`.
+ * - `undefined` — inside it, but the project configured no storage. `<Rebase>`
+ *   already warns about this on the console.
+ * - a source — the resolved default storage.
+ *
+ * See {@link RebaseDataContext} for why the default is not `{}`.
+ */
+export declare const StorageSourceContext: React.Context<StorageSource | null | undefined>;

package/dist/core/RebaseProps.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import { User, DataDriver, DataSourceDefinition, StorageSource, StorageSourceDefinition, DatabaseAdmin, RebaseClient } from "@rebasepro/types";
-import { Locale, AuthController, AnalyticsEvent, UserConfigurationPersistence, RebaseContext, EntityLinkBuilder, RebasePlugin, SlotContribution, PropertyConfig, EntityCustomView, CollectionCustomView, EntityAction, RebaseTranslations, ComponentOverrideMap } from "@rebasepro/cms-types";
+import { Locale, AuthController, AnalyticsEvent, UserConfigurationPersistence, RebaseContext, EntityLinkBuilder, RebasePlugin, AnySlotContribution, PropertyConfig, EntityCustomView, CollectionCustomView, EntityAction, RebaseTranslations, ComponentOverrideMap } from "@rebasepro/cms-types";
 /**
  * A data source registered on `<Rebase>`. Extends the shared
  * {@link DataSourceDefinition} with the frontend {@link DataDriver} used for
@@ -108,16 +108,6 @@ export type RebaseProps<USER extends User, DB = unknown> = {
         context: RebaseContext;
         loading: boolean;
     }) => React.ReactNode);
-    /**
-     * Optional base path for the entire Rebase app.
-     * Defaults to "/"
-     */
-    basePath?: string;
-    /**
-     * Optional base path for the admin collections.
-     * Defaults to "/c"
-     */
-    baseCollectionPath?: string;
     /**
      * Base URL for the backend API (e.g. "http://localhost:3001").
      * When provided, this is available via `useApiConfig()` to any hook
@@ -249,7 +239,7 @@ export type RebaseProps<USER extends User, DB = unknown> = {
     /**
      * Extra slots for the admin
      */
-    slots?: SlotContribution[];
+    slots?: AnySlotContribution[];
     /**
      * Property configs (widgets)
      */

package/dist/debug/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@rebasepro/app/debug` — the design reference and the demo dashboard.
+ *
+ * These three used to be on the package's main barrel, which meant every
+ * consumer shipped them: `UIReferenceView` is a single file that renders every
+ * component in the kit, `CrmDashboardDemo` is a fake CRM with sample data, and
+ * `UIStyleGuide` is a token sheet. Nobody building an admin panel imports any
+ * of them, and nothing in the framework does either — the `/debug/ui` route
+ * that rendered `UIReferenceView` was hardcoded into `RebaseRouteDefs`, so the
+ * whole reference was a static dependency of the admin's route table.
+ *
+ * They are not dead, though: `/debug/ui` in the dogfood app is where the design
+ * language is read from, and the marketing site renders both on public pages.
+ * A subpath is what that shape wants — reachable by name, paid for only by
+ * whoever asks.
+ */
+export * from "./UIStyleGuide.js";
+export * from "./UIReferenceView.js";
+export { CrmDashboardDemo } from "./crm-dashboard/CrmDashboardDemo.js";