@rebasepro/app 0.0.1-canary.4829d6e

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

@@ -0,0 +1,20 @@
+import type { SnackbarMessageType } from "@rebasepro/types";
+import React from "react";
+/**
+ * Hook to retrieve the SnackbarContext.
+ *
+ * Consider that in order to use this hook you need to have a parent
+ * `Rebase`
+ *
+ * @see SnackbarController
+ * @group Hooks and utilities
+ */
+export declare const useSnackbarController: () => {
+    open: (props: {
+        type: SnackbarMessageType;
+        title?: string;
+        message: React.ReactNode;
+        autoHideDuration?: number;
+    }) => void;
+    close: () => void;
+};

package/dist/hooks/useStorageSource.d.ts

@@ -0,0 +1,6 @@
+import { StorageSource } from "@rebasepro/types";
+/**
+ * Use this hook to get the storage source being used
+ * @group Hooks and utilities
+ */
+export declare const useStorageSource: () => StorageSource;

package/dist/hooks/useStudioBridge.d.ts

@@ -0,0 +1,79 @@
+import React from "react";
+import type { CollectionRegistryController, SidePanelController, 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.
+ * When CMS is absent, noop defaults ensure Studio works standalone.
+ */
+export interface StudioBridge {
+    collectionRegistry: CollectionRegistryController;
+    sidePanelController: SidePanelController;
+    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(),
+ *     sidePanelController: useSidePanel(),
+ *     urlController: useUrlController(),
+ *     navigationState: useNavigationStateController(),
+ *     breadcrumbs: useBreadcrumbsController(),
+ * }}>
+ *     <RebaseStudio ... />
+ * </StudioBridgeProvider>
+ * ```
+ */
+export declare function StudioBridgeProvider({ value, children }: {
+    value: Partial<StudioBridge>;
+    children: React.ReactNode;
+}): React.JSX.Element;
+/** Collection registry — returns noop if CMS is not present. */
+export declare function useStudioCollectionRegistry(): CollectionRegistryController;
+/** Side panel controller — returns noop if CMS is not present. */
+export declare function useStudioSidePanelController(): SidePanelController;
+/** 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
+ *     <SidePanelProvider>           // auto-registers
+ *     <UrlProvider>                  // auto-registers
+ *         <RebaseStudio />           // consumes bridge
+ *     </UrlProvider>
+ *     </SidePanelProvider>
+ *     </CollectionRegistryProvider>
+ * </StudioBridgeRegistryProvider>
+ * ```
+ */
+export declare function StudioBridgeRegistryProvider({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;

package/dist/hooks/useTranslation.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Internal hook for translating Rebase 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/useUnsavedChangesDialog.d.ts

@@ -0,0 +1,12 @@
+import { UnsavedChangesDialogProps } from "../components/UnsavedChangesDialog";
+/**
+ * A single, unified hook to prevent navigation when there are unsaved changes.
+ *
+ * It automatically handles:
+ * 1. Internal React Router navigation using `useBlocker`.
+ * 2. External browser navigation (page refresh, tab close) using `beforeunload`.
+ */
+export declare function useUnsavedChangesDialog(when: boolean, onOk: () => void): {
+    dialogProps: UnsavedChangesDialogProps;
+    triggerDialog: () => void;
+};

package/dist/hooks/useUserConfigurationPersistence.d.ts

@@ -0,0 +1,8 @@
+import { UserConfigurationPersistence } from "@rebasepro/types";
+/**
+ * Use this controller to access the configuration that is stored externally,
+ * and not defined in code
+ *
+ * @group Hooks and utilities
+ */
+export declare const useUserConfigurationPersistence: () => UserConfigurationPersistence | undefined;

package/dist/i18n/RebaseI18nProvider.d.ts

@@ -0,0 +1,33 @@
+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 */
+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 Rebase 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 Rebase'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 Rebase component tree.
+ *
+ * @internal
+ */
+export declare function RebaseI18nProvider({ locale, translations, children }: PropsWithChildren<RebaseI18nProviderProps>): React.JSX.Element | null;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./core";
+export * from "./hooks";
+export * from "./auth";
+export * from "./components";
+export * from "./util";
+export * from "./contexts";
+export { CONTAINER_FULL_WIDTH, ADDITIONAL_TAB_WIDTH, FORM_CONTAINER_WIDTH } from "./internal/common";
+export { useRestoreScroll } 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";