@rebasepro/core 0.5.0 → 0.6.0

package/dist/components/AIIcon.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 export interface AIIconProps {
     size?: "smallest" | "small" | "medium" | "large";
     className?: string;
@@ -6,11 +7,11 @@ export interface AIIconProps {
  * AI-styled AutoAwesome icon with gradient coloring.
  * Used consistently across AI features for visual identification.
  */
-export declare function AIIcon({ size, className }: AIIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function AIIcon({ size, className }: AIIconProps): React.JSX.Element;
 /**
  * Small animated dot indicator for AI-modified elements.
  * Shows a pulsing gradient dot.
  */
 export declare function AIModifiedIndicator({ className }: {
     className?: string;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/components/ConfirmationDialog.d.ts

@@ -6,4 +6,4 @@ export declare function ConfirmationDialog({ open, onAccept, onCancel, title, lo
     loading?: boolean;
     title: React.ReactNode;
     body?: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/components/Debug/UIReferenceView.d.ts

@@ -1 +1,13 @@
-export declare function UIReferenceView(): import("react/jsx-runtime").JSX.Element;
+/**
+ * UIReferenceView — hidden debug route at /debug/ui
+ *
+ * This file is a STATIC reference of the real UI patterns used across the app.
+ * All markup / styles are copied verbatim from source files.
+ * DO NOT add invented styles. Only copy from actual source files.
+ *
+ * Sources:
+ *   DefaultDrawer.tsx, DefaultAppBar.tsx, DrawerNavigationItem.tsx,
+ *   DrawerNavigationGroup.tsx, UsersView.tsx, RolesView.tsx
+ */
+import React from "react";
+export declare function UIReferenceView(): React.JSX.Element;

package/dist/components/Debug/UIStyleGuide.d.ts

@@ -1 +1,2 @@
-export declare const UIStyleGuide: () => import("react/jsx-runtime").JSX.Element;
+import React from "react";
+export declare const UIStyleGuide: () => React.JSX.Element;

package/dist/components/ErrorTooltip.d.ts

@@ -1,2 +1,3 @@
+import React from "react";
 import { TooltipProps } from "@rebasepro/ui";
-export declare function ErrorTooltip(props: TooltipProps): import("react/jsx-runtime").JSX.Element;
+export declare function ErrorTooltip(props: TooltipProps): React.JSX.Element;

package/dist/components/LanguageToggle.d.ts

@@ -1 +1,2 @@
-export declare function LanguageToggle(): import("react/jsx-runtime").JSX.Element;
+import React from "react";
+export declare function LanguageToggle(): React.JSX.Element;

package/dist/components/LoginView/LoginView.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from "react";
+import React, { ReactNode } from "react";
 /** Google Identity Services SDK — injected by the GIS <script> tag. */
 declare global {
     interface Window {
@@ -106,4 +106,4 @@ export interface LoginViewProps {
  * Feature-detects capabilities to show/hide login methods.
  * @group Core
  */
-export declare function LoginView({ logo, authController, noUserComponent, disableSignupScreen, disabled, notAllowedError, googleClientId, githubClientId, linkedinClientId, title, subtitle, needsSetup, registrationEnabled, additionalComponent, defaultEmail, defaultPassword }: LoginViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function LoginView({ logo, authController, noUserComponent, disableSignupScreen, disabled, notAllowedError, googleClientId, githubClientId, linkedinClientId, title, subtitle, needsSetup, registrationEnabled, additionalComponent, defaultEmail, defaultPassword }: LoginViewProps): React.JSX.Element;

package/dist/components/NotFoundPage.d.ts

@@ -1 +1,2 @@
-export declare function NotFoundPage(): import("react/jsx-runtime").JSX.Element;
+import React from "react";
+export declare function NotFoundPage(): React.JSX.Element;

package/dist/components/RebaseLogo.d.ts

@@ -4,4 +4,4 @@ export declare function RebaseLogo({ width, height, className, style }: {
     height?: string;
     className?: string;
     style?: React.CSSProperties;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/components/SchemaDriftBanner.d.ts

@@ -0,0 +1,27 @@
+import React from "react";
+interface SchemaDriftContextValue {
+    /** Report a schema drift error (call from any data-loading hook). */
+    reportSchemaDrift: (message: string) => void;
+    /** The most recent schema drift message, or null. */
+    schemaDriftMessage: string | null;
+    /** Dismiss the banner for this session. */
+    dismiss: () => void;
+}
+export declare function useSchemaDriftContext(): SchemaDriftContextValue;
+/**
+ * Detects schema drift from an error object.
+ * Checks both the error code (from `RebaseApiError`) and the message
+ * for schema drift indicators.
+ */
+export declare function isSchemaDriftError(error: unknown): boolean;
+export declare function SchemaDriftProvider({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+export interface SchemaDriftBannerProps {
+    className?: string;
+}
+/**
+ * Persistent banner shown when a schema drift error is detected.
+ */
+export declare function SchemaDriftBanner({ className }: SchemaDriftBannerProps): React.JSX.Element | null;
+export {};

package/dist/components/UnsavedChangesDialog.d.ts

@@ -6,4 +6,4 @@ export interface UnsavedChangesDialogProps {
     handleOk: () => void;
     handleCancel: () => void;
 }
-export declare function UnsavedChangesDialog({ open, handleOk, handleCancel, body, title }: UnsavedChangesDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function UnsavedChangesDialog({ open, handleOk, handleCancel, body, title }: UnsavedChangesDialogProps): React.JSX.Element;

package/dist/components/UserDisplay.d.ts

@@ -4,4 +4,4 @@ import { User } from "@rebasepro/types";
  */
 export declare function UserDisplay({ user }: {
     user: User | null;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;

package/dist/components/UserSelectPopover.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 /**
  * Represents a selectable user item with optional role information.
  */
@@ -59,4 +60,4 @@ export interface UserSelectPopoverProps {
  *
  * @group Components
  */
-export declare function UserSelectPopover({ selectedUser, onUserSelected, users, loading, currentUser, defaultLabel, renderLimit, className, size }: UserSelectPopoverProps): import("react/jsx-runtime").JSX.Element;
+export declare function UserSelectPopover({ selectedUser, onUserSelected, users, loading, currentUser, defaultLabel, renderLimit, className, size }: UserSelectPopoverProps): React.JSX.Element;

package/dist/components/UserSettingsView.d.ts

@@ -1 +1,2 @@
-export declare function UserSettingsView(): import("react/jsx-runtime").JSX.Element | null;
+import React from "react";
+export declare function UserSettingsView(): React.JSX.Element | null;

package/dist/components/index.d.ts

@@ -14,4 +14,4 @@ export * from "./UserSelectPopover";
 export * from "./UserDisplay";
 export * from "./LoginView";
 export * from "./RebaseAuth";
-export * from "./BootstrapAdminBanner";
+export * from "./SchemaDriftBanner";

package/dist/contexts/ComponentOverrideContext.d.ts

@@ -0,0 +1,42 @@
+import React from "react";
+import type { ComponentOverrideMap } from "@rebasepro/types";
+/**
+ * Internal state for the component override resolution chain.
+ * Holds both global overrides (set on `<Rebase>`) and collection-scoped
+ * overrides (set on individual collections).
+ *
+ * Resolution priority: collection > global > default.
+ *
+ * @internal
+ */
+interface ComponentOverrideState {
+    globalOverrides: ComponentOverrideMap;
+    collectionOverrides: ComponentOverrideMap;
+}
+export declare const ComponentOverrideContext: React.Context<ComponentOverrideState>;
+/**
+ * Provider set at the `<Rebase>` root level to supply global component overrides.
+ *
+ * @internal — Used by the Rebase component. End users set overrides via
+ * the `components` prop on `<Rebase>`.
+ */
+export declare function GlobalComponentOverrideProvider({ overrides, children }: {
+    overrides?: ComponentOverrideMap;
+    children: React.ReactNode;
+}): React.JSX.Element;
+/**
+ * Provider set at the collection level to layer collection-scoped overrides
+ * on top of global overrides.
+ *
+ * When a collection defines `components`, this provider is mounted
+ * around the collection's view subtree. Components within the subtree
+ * will resolve overrides in order: collection → global → default.
+ *
+ * @internal — Used by EntityCollectionView when a collection has
+ * `components` defined.
+ */
+export declare function CollectionComponentOverrideProvider({ overrides, children }: {
+    overrides?: ComponentOverrideMap;
+    children: React.ReactNode;
+}): React.JSX.Element;
+export {};

package/dist/contexts/RebaseClientInstanceContext.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 /**
- * Context that exposes the full RebaseClient instance (from `@rebasepro/client`).
+ * Context that exposes the full RebaseClient instance.
  * Used by the JS Editor to give developer scripts access to `client.data`, `client.auth`, etc.
  */
 export declare const RebaseClientInstanceContext: React.Context<any>;

package/dist/contexts/index.d.ts

@@ -8,6 +8,6 @@ export * from "./AnalyticsContext";
 export * from "./StorageSourceContext";
 export * from "./UserConfigurationPersistenceContext";
 export * from "./DialogsProvider";
-export * from "./InternalUserManagementContext";
 export * from "./RebaseClientInstanceContext";
 export * from "./CustomizationControllerContext";
+export * from "./ComponentOverrideContext";

package/dist/core/Rebase.d.ts

@@ -1,4 +1,5 @@
 import type { RebaseProps } from "./RebaseProps";
+import React from "react";
 import { User } from "@rebasepro/types";
 /**
  * If you are using independent components of the CMS
@@ -11,4 +12,4 @@ import { User } from "@rebasepro/types";
  *
  * @group Core
  */
-export declare function Rebase<USER extends User>(props: RebaseProps<USER>): import("react/jsx-runtime").JSX.Element;
+export declare function Rebase<USER extends User>(props: RebaseProps<USER>): React.JSX.Element;

package/dist/core/RebaseProps.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { Locale, User, AuthController, AnalyticsEvent, DataDriver, StorageSource, UserConfigurationPersistence, DatabaseAdmin, RebaseData, RebaseClient, RebaseContext, UserManagementDelegate, EntityLinkBuilder, RebasePlugin, SlotContribution, PropertyConfig, EntityCustomView, EntityAction, RebaseTranslations } from "@rebasepro/types";
+import { Locale, User, AuthController, AnalyticsEvent, DataDriver, StorageSource, UserConfigurationPersistence, DatabaseAdmin, RebaseData, RebaseClient, RebaseContext, EntityLinkBuilder, RebasePlugin, SlotContribution, PropertyConfig, EntityCustomView, EntityAction, RebaseTranslations, ComponentOverrideMap } from "@rebasepro/types";
 /** DeepPartial helper — allows partial overrides at any nesting level */
 type DeepPartial<T> = T extends object ? {
     [K in keyof T]?: DeepPartial<T[K]>;
@@ -92,19 +92,6 @@ export type RebaseProps<USER extends User> = {
      * The function must return a URL that gets opened when the button is clicked
      */
     entityLinkBuilder?: EntityLinkBuilder;
-    /**
-     * You can use this props to provide your own user management implementation.
-     * Note that this will not affect the UI, but it will be used to show user information
-     * in various places of the CMS, for example, to show who created or modified an entity,
-     * or to assign ownership of an entity.
-     *
-     * You can also use this data to be retrieved in your custom properties,
-     * for example, to show a list of users in a dropdown.
-     *
-     * If you are using the Rebase user management plugin, this
-     * prop will be implemented automatically.
-     */
-    userManagement?: UserManagementDelegate<USER>;
     /**
      * Plugins loaded in the CMS
      */
@@ -125,14 +112,6 @@ export type RebaseProps<USER extends User> = {
      * Entity Actions
      */
     entityActions?: EntityAction[];
-    components?: {
-        /**
-         * Component to render when a reference is missing
-         */
-        missingReference?: React.ComponentType<{
-            path: string;
-        }>;
-    };
     /**
      * Controller to simulate different roles when dev mode is active.
      */
@@ -143,5 +122,27 @@ export type RebaseProps<USER extends User> = {
     translations?: {
         [locale: string]: DeepPartial<RebaseTranslations>;
     };
+    /**
+     * Override built-in UI components with custom implementations.
+     *
+     * Keys are component names from {@link OverridableComponentName}.
+     * Values specify the replacement component and an optional `wrap`
+     * flag for the wrapping pattern.
+     *
+     * @example
+     * ```tsx
+     * <Rebase
+     *     client={client}
+     *     components={{
+     *         "Shell.AppBar": { Component: MyCustomAppBar },
+     *         "Entity.FormActions": {
+     *             Component: MyFormActions,
+     *             wrap: true
+     *         }
+     *     }}
+     * >
+     * ```
+     */
+    components?: ComponentOverrideMap;
 };
 export {};

package/dist/core/RebaseRouter.d.ts

@@ -1,4 +1,4 @@
 export declare function RebaseRouter({ children, basePath }: {
     children: React.ReactNode;
     basePath?: string;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;

package/dist/core/RebaseRoutes.d.ts

@@ -14,4 +14,4 @@ import React from "react";
  */
 export declare function RebaseRoutes({ children }: {
     children?: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/hooks/ApiConfigContext.d.ts

@@ -21,4 +21,4 @@ export declare function useApiConfig(): ApiConfig | undefined;
  */
 export declare function ApiConfigProvider({ apiUrl, getAuthToken, children }: ApiConfig & {
     children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/hooks/index.d.ts

@@ -2,7 +2,6 @@ export * from "./data/useData";
 export * from "./data/useCollectionFetch";
 export * from "./data/useEntityFetch";
 export * from "./data/useRelationSelector";
-export * from "./data/useUserSelector";
 export * from "./data/save";
 export * from "./data/delete";
 export * from "./useUnsavedChangesDialog";
@@ -20,7 +19,6 @@ export * from "./useModeController";
 export * from "./useClipboard";
 export * from "./useLargeLayout";
 export * from "./useCollapsedGroups";
-export * from "./useInternalUserManagementController";
 export * from "./useBrowserTitleAndIcon";
 export * from "./useSlot";
 export * from "./useCustomizationController";
@@ -35,3 +33,4 @@ export * from "./useRebaseClient";
 export * from "./useAnalyticsController";
 export * from "./useUserConfigurationPersistence";
 export * from "./useResolvedComponent";
+export * from "./useComponentOverride";

package/dist/hooks/useComponentOverride.d.ts

@@ -0,0 +1,32 @@
+import React from "react";
+import type { OverridableComponentName } from "@rebasepro/types";
+/**
+ * Resolves a potentially overridden component.
+ *
+ * Resolution order:
+ * 1. Collection-scoped override (highest priority)
+ * 2. Global override
+ * 3. Default component (fallback)
+ *
+ * Supports two override modes:
+ * - **Eject** (default): The override component fully replaces the default.
+ * - **Wrap** (`wrap: true`): The override component wraps the default.
+ *   The default is passed as `OriginalComponent` in props.
+ *
+ * @param name - The overridable component name (e.g. `"Entity.Form"`)
+ * @param DefaultComponent - The built-in default component
+ * @returns The resolved component — either the default, a full replacement, or a wrapper
+ *
+ * @example
+ * ```tsx
+ * import { useComponentOverride } from "@rebasepro/core";
+ *
+ * function EntityFormWrapper(props: EntityFormProps) {
+ *     const ResolvedForm = useComponentOverride("Entity.Form", DefaultEntityForm);
+ *     return <ResolvedForm {...props} />;
+ * }
+ * ```
+ *
+ * @group Hooks
+ */
+export declare function useComponentOverride<P>(name: OverridableComponentName, DefaultComponent: React.ComponentType<P>): React.ComponentType<P>;

package/dist/hooks/useRebaseRegistry.d.ts

@@ -19,7 +19,7 @@ interface RegistryDispatch {
 }
 export declare function RebaseRegistryProvider({ children }: {
     children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;
 /**
  * Returns the full registry (state + dispatch).
  * Use this in RebaseShell where you need to read configs.

package/dist/hooks/useStudioBridge.d.ts

@@ -1,18 +1,6 @@
 import React from "react";
-import type { CollectionRegistryController, SideEntityController, UrlController, NavigationStateController } from "@rebasepro/types";
-export interface BreadcrumbEntry {
-    title: string;
-    url: string;
-    count?: number | null;
-    id?: string;
-}
-export interface BreadcrumbsController {
-    breadcrumbs: BreadcrumbEntry[];
-    set: (props: {
-        breadcrumbs: BreadcrumbEntry[];
-    }) => void;
-    updateCount: (id: string, count: number | null | undefined) => void;
-}
+import type { CollectionRegistryController, SideEntityController, UrlController, NavigationStateController, BreadcrumbEntry, BreadcrumbsController } from "@rebasepro/types";
+export type { BreadcrumbEntry, BreadcrumbsController };
 /**
  * StudioBridge provides optional CMS capabilities to Studio components.
  * When CMS is present, a bridge provider injects real implementations.
@@ -46,7 +34,7 @@ export declare const StudioBridgeContext: React.Context<StudioBridge>;
 export declare function StudioBridgeProvider({ value, children }: {
     value: Partial<StudioBridge>;
     children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;
 /** Collection registry — returns noop if CMS is not present. */
 export declare function useStudioCollectionRegistry(): CollectionRegistryController;
 /** Side entity controller — returns noop if CMS is not present. */
@@ -88,4 +76,4 @@ export declare const StudioBridgeRegistryContext: React.Context<StudioBridgeRegi
  */
 export declare function StudioBridgeRegistryProvider({ children }: {
     children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/i18n/RebaseI18nProvider.d.ts

@@ -1,4 +1,4 @@
-import { PropsWithChildren } from "react";
+import React, { PropsWithChildren } from "react";
 import { RebaseTranslations } from "@rebasepro/types";
 export declare const REBASE_LOCALE_STORAGE_KEY = "rebase_locale";
 /** DeepPartial helper — allows partial overrides at any nesting level */
@@ -29,5 +29,5 @@ export interface RebaseI18nProviderProps {
  *
  * @internal
  */
-export declare function RebaseI18nProvider({ locale, translations, children }: PropsWithChildren<RebaseI18nProviderProps>): import("react/jsx-runtime").JSX.Element | null;
+export declare function RebaseI18nProvider({ locale, translations, children }: PropsWithChildren<RebaseI18nProviderProps>): React.JSX.Element | null;
 export {};