@rebasepro/core 0.0.1-canary.2 → 0.0.1-canary.4d4fb3e

package/dist/hooks/data/useEntityFetch.d.ts

@@ -1,4 +1,5 @@
-import { Entity, EntityCollection, User } from "@rebasepro/types";
+import type { EntityCollection } from "@rebasepro/types";
+import { Entity, User } from "@rebasepro/types";
 /**
  * @group Hooks and utilities
  */
@@ -19,11 +20,11 @@ export interface EntityFetchResult<M extends Record<string, any>> {
 }
 /**
  * This hook is used to fetch an entity.
- * It gives real time updates if the datasource supports it.
+ * It gives real time updates if the driver supports it.
  * @param path
  * @param collection
  * @param entityId
  * @param useCache
  * @group Hooks and utilities
  */
-export declare function useEntityFetch<M extends Record<string, any>, USER extends User>({ path: inputPath, entityId, collection, databaseId, useCache }: EntityFetchProps<M, USER>): EntityFetchResult<M>;
+export declare function useEntityFetch<M extends Record<string, any>, USER extends User = User>({ path, entityId, collection, databaseId, useCache }: EntityFetchProps<M, USER>): EntityFetchResult<M>;

package/dist/hooks/data/useRelationSelector.d.ts

@@ -1,5 +1,12 @@
-import { Entity, EntityCollection, EntityRelation, FilterValues } from "@rebasepro/types";
-import { RelationItem } from "../../components/RelationSelector";
+import type { EntityCollection } from "@rebasepro/types";
+import { Entity, EntityRelation, FilterValues } from "@rebasepro/types";
+export interface RelationItem {
+    id: string | number;
+    label: string;
+    description?: string;
+    data: Entity<any>;
+    relation: EntityRelation;
+}
 export interface UseRelationSelectorProps<M extends Record<string, any> = any> {
     /**
      * Full path where the relation data is located

package/dist/hooks/index.d.ts

@@ -1,27 +1,18 @@
-export * from "./data/useDataSource";
+export * from "./data/useData";
 export * from "./data/useCollectionFetch";
 export * from "./data/useEntityFetch";
 export * from "./data/useRelationSelector";
 export * from "./data/save";
 export * from "./data/delete";
-export * from "./navigation/contexts";
-export * from "./navigation/useBuildCollectionRegistryController";
-export * from "./navigation/useBuildCMSUrlController";
-export * from "./navigation/useBuildNavigationStateController";
-export * from "./navigation/useResolvedCollections";
-export * from "./navigation/useResolvedViews";
-export * from "./navigation/useTopLevelNavigation";
 export * from "./useUnsavedChangesDialog";
-export * from "./useResolvedNavigationFrom";
 export * from "./useStorageSource";
 export * from "./useAuthController";
+export * from "./useAuthSubscription";
 export * from "./useDialogsController";
-export * from "./useSideDialogsController";
 export * from "./useAdminModeController";
 export * from "./useBuildAdminModeController";
 export * from "./useEffectiveRoleController";
 export * from "./useBuildEffectiveRoleController";
-export * from "./useSideEntityController";
 export * from "./useRebaseContext";
 export * from "./useSnackbarController";
 export * from "./useModeController";
@@ -29,13 +20,17 @@ export * from "./useClipboard";
 export * from "./useLargeLayout";
 export * from "./useCollapsedGroups";
 export * from "./useInternalUserManagementController";
-export * from "./useEntitySelectionDialog";
 export * from "./useBrowserTitleAndIcon";
+export * from "./useSlot";
 export * from "./useCustomizationController";
-export * from "./useBuildNavigationController";
 export * from "./useBuildLocalConfigurationPersistence";
 export * from "./useBuildModeController";
 export * from "./useValidateAuthenticator";
+export * from "./useRebaseRegistry";
 export * from "./useBackendStorageSource";
 export * from "./usePermissions";
 export * from "./ApiConfigContext";
+export * from "./useTranslation";
+export * from "./useRebaseClient";
+export * from "./useAnalyticsController";
+export * from "./useUserConfigurationPersistence";

package/dist/hooks/useAuthSubscription.d.ts

@@ -0,0 +1,2 @@
+import { AuthClient, AuthController } from "@rebasepro/types";
+export declare function useAuthSubscription(authClient?: AuthClient): AuthController;

package/dist/hooks/useBridgeRegistration.d.ts

@@ -0,0 +1,18 @@
+import type { StudioBridge } from "./useStudioBridge";
+/**
+ * Registers a value into the self-assembling Studio bridge.
+ *
+ * Each controller (collectionRegistry, sideEntity, url, navigation, breadcrumbs)
+ * calls this hook on mount to inject its real implementation into the bridge.
+ * On unmount the slice is automatically removed, reverting to the noop default.
+ *
+ * Usage:
+ * ```tsx
+ * function SomeProvider({ children }) {
+ *     const controller = useBuildSomeController();
+ *     useBridgeRegistration("sideEntityController", controller);
+ *     return <SomeContext.Provider value={controller}>{children}</SomeContext.Provider>;
+ * }
+ * ```
+ */
+export declare function useBridgeRegistration<K extends keyof StudioBridge>(key: K, value: StudioBridge[K]): void;

package/dist/hooks/useBuildEffectiveRoleController.d.ts

@@ -1,4 +1,4 @@
-import { EffectiveRoleController } from "@rebasepro/types";
+import type { EffectiveRoleController } from "@rebasepro/types";
 /**
  * Use this hook to build an effective role controller that determines
  * what role is simulated in Editor mode when Dev mode is active.

package/dist/hooks/useCustomizationController.d.ts

@@ -1,4 +1,4 @@
-import { CustomizationController } from "@rebasepro/types";
+import type { CustomizationController } from "@rebasepro/types";
 /**
  * Use this hook to retrieve the customization controller.
  * This hook includes all the customization options that can be used

package/dist/hooks/useDialogsController.d.ts

@@ -1,4 +1,4 @@
-import { DialogsController } from "@rebasepro/types";
+import type { DialogsController } from "@rebasepro/types";
 /**
  * Use this hook to open a dialog imperatively.
  * Alternatively, you can use dialogs declaratively using the `Dialog` component.

package/dist/hooks/usePermissions.d.ts

@@ -1,4 +1,5 @@
-import { EntityCollection, Entity } from "@rebasepro/types";
+import type { EntityCollection } from "@rebasepro/types";
+import { Entity } from "@rebasepro/types";
 /**
  * Hook to evaluate roles and permissions for the current user.
  * It abstracts away the need to pass `authController` to permission evaluation functions.

package/dist/hooks/useRebaseClient.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Hook to retrieve the full RebaseClient instance from context.
+ * Returns `undefined` if no client was provided to `<Rebase>`.
+ */
+export declare function useRebaseClient<T = any>(): T | undefined;

package/dist/hooks/useRebaseRegistry.d.ts

@@ -0,0 +1,34 @@
+import React from "react";
+import type { RebaseRegistryController, RebaseCMSConfig, RebaseStudioConfig, RebaseAuthConfig } from "@rebasepro/types";
+/**
+ * Split into two contexts to prevent infinite re-render loops:
+ * - DispatchContext: stable register/unregister functions (never changes identity)
+ * - StateContext: the current config values (changes when modules register)
+ *
+ * Feature components (RebaseAuth, RebaseCMS, RebaseStudio) only consume
+ * the dispatch context, so registering does NOT cause them to re-render.
+ * RebaseShell consumes state context to read the collected configs.
+ */
+interface RegistryDispatch {
+    registerCMS: (config: RebaseCMSConfig) => void;
+    unregisterCMS: () => void;
+    registerStudio: (config: RebaseStudioConfig) => void;
+    unregisterStudio: () => void;
+    registerAuth: (config: RebaseAuthConfig) => void;
+    unregisterAuth: () => void;
+}
+export declare function RebaseRegistryProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the full registry (state + dispatch).
+ * Use this in RebaseShell where you need to read configs.
+ */
+export declare function useRebaseRegistry(): RebaseRegistryController;
+/**
+ * Returns only the stable dispatch functions.
+ * Use this in feature components (RebaseAuth, RebaseCMS, RebaseStudio)
+ * to avoid re-render loops.
+ */
+export declare function useRebaseRegistryDispatch(): RegistryDispatch;
+export {};

package/dist/hooks/useSlot.d.ts

@@ -0,0 +1,18 @@
+import type { SlotName, SlotRegistry } from "@rebasepro/types";
+import React from "react";
+/**
+ * Hook that retrieves and renders all slot contributions for a given slot name.
+ *
+ * @param slot - The slot name to render contributions for.
+ * @param props - Props passed to each slot component.
+ * @returns An array of rendered React nodes, each wrapped in an ErrorBoundary.
+ *
+ * @example
+ * ```tsx
+ * const actions = useSlot("home.actions", { context });
+ * return <div>{actions}</div>;
+ * ```
+ *
+ * @group Hooks
+ */
+export declare function useSlot<K extends SlotName>(slot: K, props: SlotRegistry[K]): React.ReactNode[];

package/dist/hooks/useSnackbarController.d.ts

@@ -1,5 +1,5 @@
+import type { SnackbarMessageType } from "@rebasepro/types";
 import React from "react";
-import { SnackbarMessageType } from "@rebasepro/types";
 /**
  * Hook to retrieve the SnackbarContext.
  *

package/dist/hooks/useStorageSource.d.ts

@@ -1,4 +1,5 @@
-import { EntityCollection, StorageSource } from "@rebasepro/types";
+import type { EntityCollection } from "@rebasepro/types";
+import { StorageSource } from "@rebasepro/types";
 /**
  * Use this hook to get the storage source being used
  * @group Hooks and utilities

package/dist/hooks/useStudioBridge.d.ts

@@ -0,0 +1,91 @@
+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;
+}
+/**
+ * StudioBridge provides optional CMS capabilities to Studio components.
+ * When CMS is present, a bridge provider injects real implementations.
+ * When CMS is absent, noop defaults ensure Studio works standalone.
+ */
+export interface StudioBridge {
+    collectionRegistry: CollectionRegistryController;
+    sideEntityController: SideEntityController;
+    urlController: UrlController;
+    navigationState: NavigationStateController;
+    breadcrumbs: BreadcrumbsController;
+}
+export declare const StudioBridgeContext: React.Context<StudioBridge>;
+/**
+ * Provider that injects CMS capabilities into Studio.
+ * Accepts partial overrides — any field not provided falls back to noop.
+ *
+ * Usage (in app wiring, when CMS is present):
+ * ```tsx
+ * <StudioBridgeProvider value={{
+ *     collectionRegistry: useCollectionRegistryController(),
+ *     sideEntityController: useSideEntityController(),
+ *     urlController: useUrlController(),
+ *     navigationState: useNavigationStateController(),
+ *     breadcrumbs: useBreadcrumbsController(),
+ * }}>
+ *     <RebaseStudio ... />
+ * </StudioBridgeProvider>
+ * ```
+ */
+export declare function StudioBridgeProvider({ value, children, }: {
+    value: Partial<StudioBridge>;
+    children: React.ReactNode;
+}): import("react/jsx-runtime").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. */
+export declare function useStudioSideEntityController(): SideEntityController;
+/** URL controller — returns noop if CMS is not present. */
+export declare function useStudioUrlController(): UrlController;
+/** Navigation state — returns noop if CMS is not present. */
+export declare function useStudioNavigationState(): NavigationStateController;
+/** Breadcrumbs controller — returns noop if CMS is not present. */
+export declare function useStudioBreadcrumbs(): BreadcrumbsController;
+/**
+ * Registry that controllers use to self-register their implementations
+ * into the Studio bridge. Each controller calls `register(key, value)`
+ * on mount and `unregister(key)` on unmount.
+ */
+export interface StudioBridgeRegistry {
+    register: <K extends keyof StudioBridge>(key: K, value: StudioBridge[K]) => void;
+    unregister: (key: keyof StudioBridge) => void;
+}
+export declare const StudioBridgeRegistryContext: React.Context<StudioBridgeRegistry | null>;
+/**
+ * Provider that creates a self-assembling bridge.
+ *
+ * Mount this above the controller providers. Each controller calls
+ * `useBridgeRegistration(key, value)` to inject its implementation.
+ * The bridge context value is automatically kept in sync.
+ *
+ * ```tsx
+ * <StudioBridgeRegistryProvider>
+ *     <CollectionRegistryProvider>   // auto-registers
+ *     <SideEntityProvider>           // auto-registers
+ *     <UrlProvider>                  // auto-registers
+ *         <RebaseStudio />           // consumes bridge
+ *     </UrlProvider>
+ *     </SideEntityProvider>
+ *     </CollectionRegistryProvider>
+ * </StudioBridgeRegistryProvider>
+ * ```
+ */
+export declare function StudioBridgeRegistryProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/hooks/useTranslation.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Internal hook for translating FireCMS UI strings.
+ *
+ * Uses the `rebase_core` i18next namespace that is initialised by
+ * `RebaseI18nProvider`. Do NOT use `react-i18next` directly in internal
+ * components — always go through this hook so the namespace is consistent.
+ *
+ * @example
+ * const { t } = useTranslation();
+ * <Button>{t("save")}</Button>
+ *
+ * @internal
+ */
+export declare function useTranslation(): {
+    t: (key: string, vars?: Record<string, string>) => string;
+    i18n: import("i18next").i18n;
+};

package/dist/hooks/useValidateAuthenticator.d.ts

@@ -1,17 +1,17 @@
-import { AuthController, Authenticator, DataSource, StorageSource, User } from "../index";
+import { AuthController, Authenticator, RebaseData, StorageSource, User } from "@rebasepro/types";
 /**
  * This hook is used internally for validating an authenticator.
  *
  * @param authController
  * @param authentication
  * @param storageSource
- * @param dataSource
+ * @param data
  */
-export declare function useValidateAuthenticator<USER extends User = any>({ disabled, authController, authenticator, storageSource, dataSource }: {
+export declare function useValidateAuthenticator<USER extends User = any>({ disabled, authController, authenticator, storageSource, data }: {
     disabled?: boolean;
     authController: AuthController<USER>;
     authenticator?: boolean | Authenticator<USER>;
-    dataSource: DataSource;
+    data: RebaseData;
     storageSource: StorageSource;
 }): {
     canAccessMainView: boolean;

package/dist/i18n/RebaseI18nProvider.d.ts

@@ -0,0 +1,33 @@
+import { 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 */
+type DeepPartial<T> = T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+export interface RebaseI18nProviderProps {
+    /** BCP-47 locale tag, e.g. "en", "es", "fr". Defaults to "en". */
+    locale?: string;
+    /**
+     * Override or extend any FireCMS UI string, keyed by locale.
+     *
+     * @example
+     * translations={{
+     *   en: { save: "Publish" },
+     *   es: { save: "Publicar", discard: "Descartar" }
+     * }}
+     */
+    translations?: {
+        [locale: string]: DeepPartial<RebaseTranslations>;
+    };
+}
+/**
+ * Initialises a dedicated i18next instance for FireCMS's internal UI strings.
+ *
+ * This instance is isolated from any app-level i18next configuration the
+ * consumer may have. Mount this at the top of the FireCMS component tree.
+ *
+ * @internal
+ */
+export declare function RebaseI18nProvider({ locale, translations, children }: PropsWithChildren<RebaseI18nProviderProps>): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/index.d.ts

@@ -1,15 +1,15 @@
 export * from "./core";
-export * from "./app";
-export * from "@rebasepro/types";
-export * from "@rebasepro/common";
-export * from "./form";
-export * from "./preview";
 export * from "./hooks";
-export * from "./components/admin";
 export * from "./components";
 export * from "./util";
 export * from "./contexts";
-export * from "./routes";
+export * from "./internal/common";
+export * from "./internal/useRestoreScroll";
 export { useUnsavedChangesDialog } from "./hooks/useUnsavedChangesDialog";
 export type { UnsavedChangesDialogProps } from "./components/UnsavedChangesDialog";
 export { UnsavedChangesDialog } from "./components/UnsavedChangesDialog";
+export * from "./i18n/RebaseI18nProvider";
+export * from "./locales/en";
+export * from "./locales/es";
+export * from "./hooks/useStudioBridge";
+export { useBridgeRegistration } from "./hooks/useBridgeRegistration";