@firecms/core 3.0.0-alpha.8 → 3.0.0-alpha.80

package/dist/hooks/useClipboard.d.ts

@@ -0,0 +1,57 @@
+import { MutableRefObject } from "react";
+export interface UseClipboardProps {
+    /**
+     * It's callback function that is called after the `copy` command
+     * is executed.
+     *
+     * @param text: The selected clipboard text.
+     */
+    onSuccess?: (text: string) => void;
+    /**
+     * Triggers when the hook encounters an error.
+     * If passed hook won't throw an error.
+     *
+     * @param error: cause of the error
+     */
+    onError?: (error: string) => void;
+    /**
+     * Disables the new clipboard API `navigator.clipboard` even if
+     * it is supported.
+     */
+    disableClipboardAPI?: boolean;
+    /**
+     * revert back the isCopied flag to false again if a value is set.
+     */
+    copiedDuration?: number;
+}
+export interface useClipboardReturnType {
+    /**
+     * Use ref to pull the text content from.
+     */
+    ref: MutableRefObject<any>;
+    /**
+     * Use it to perform the copy operation
+     */
+    copy: (text?: string) => void;
+    /**
+     * Use it to perform the cut operation
+     */
+    cut: () => void;
+    /**
+     * Indicates wheater the content was successfully copied or not.
+     */
+    isCoppied: boolean;
+    /**
+     * Current selected clipboard content.
+     */
+    clipboard: string;
+    /**
+     * Clears the user clipboard.
+     */
+    clearClipboard: () => void;
+    /**
+     * Check to see if the browser supports the new `navigator.clipboard` API.
+     */
+    isSupported: () => boolean;
+}
+export declare const useClipboard: (options?: UseClipboardProps) => useClipboardReturnType;

package/dist/hooks/useDialogsController.d.ts

@@ -0,0 +1,11 @@
+import { DialogsController } from "../types/dialogs_controller";
+/**
+ * Use this hook to open a dialog imperatively.
+ * Alternatively, you can use dialogs declaratively using the `Dialog` component.
+ *
+ * Consider that in order to use this hook you need to have a parent
+ * `FireCMS`
+ *
+ * @group Hooks and utilities
+ */
+export declare const useDialogsController: () => DialogsController;

package/dist/hooks/useFireCMSContext.d.ts

@@ -0,0 +1,12 @@
+import { AuthController, FireCMSContext, User } from "../types";
+export declare const FireCMSContextInstance: import("react").Context<Partial<FireCMSContext>>;
+/**
+ * Hook to retrieve the {@link FireCMSContext}.
+ *
+ * Consider that in order to use this hook you need to have a parent
+ * `FireCMS` component.
+ *
+ * @see FireCMSContext
+ * @group Hooks and utilities
+ */
+export declare const useFireCMSContext: <UserType extends User = User, AuthControllerType extends AuthController<UserType> = AuthController<UserType>>() => FireCMSContext<UserType, AuthControllerType>;

package/dist/hooks/useLargeLayout.d.ts

@@ -0,0 +1 @@
+export declare const useLargeLayout: () => boolean;

package/dist/hooks/useModeController.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Use this controller to change color mode
+ * @group Hooks and utilities
+ */
+export interface ModeController {
+    mode: "light" | "dark";
+    setMode: (mode: "light" | "dark") => void;
+    toggleMode: () => void;
+}
+/**
+ * Hook to retrieve the current mode ("light" | "dark"), and `setMode`
+ * or `toggle` functions to change it.
+ *
+ * Consider that in order to use this hook you need to have a parent
+ * `FireCMS`
+ *
+ * @see ModeController
+ * @group Hooks and utilities
+ */
+export declare const useModeController: () => ModeController;

package/dist/hooks/useNavigationController.d.ts

@@ -0,0 +1,9 @@
+import { NavigationController } from "../types";
+/**
+ * Use this hook to get the navigation of the app.
+ * This controller provides the resolved collections for the CMS as well
+ * as utility methods.
+ *
+ * @group Hooks and utilities
+ */
+export declare const useNavigationController: () => NavigationController;

package/dist/hooks/useReferenceDialog.d.ts

@@ -0,0 +1,18 @@
+import { ReferenceSelectionInnerProps } from "../components";
+/**
+ * This hook is used to open a side dialog that allows the selection
+ * of entities under a given path.
+ * You can use it in custom views for selecting entities.
+ * You need to specify the path of the target collection at least.
+ * If your collection is not defined in your  top collection configuration
+ * (in your `FireCMS` component), you need to specify explicitly.
+ * This is the same hook used internally when a reference property is defined.
+ * @group Hooks and utilities
+ */
+export declare function useReferenceDialog<M extends Record<string, any>>(referenceDialogProps: Omit<ReferenceSelectionInnerProps<M>, "path"> & {
+    path?: string | false;
+    onClose?: () => void;
+}): {
+    open: () => void;
+    close: () => void;
+};

package/dist/hooks/useResolvedNavigationFrom.d.ts

@@ -0,0 +1,72 @@
+import { Entity, EntityCollection, EntityCustomView, FireCMSContext, User } from "../types";
+/**
+ * @see resolveNavigationFrom
+ * @group Hooks and utilities
+ */
+export type ResolvedNavigationEntry<M extends Record<string, any>> = ResolvedNavigationEntity<M> | ResolvedNavigationCollection<M> | ResolvedNavigationEntityCustom<M>;
+/**
+ * @see resolveNavigationFrom
+ * @group Hooks and utilities
+ */
+export interface ResolvedNavigationEntity<M extends Record<string, any>> {
+    type: "entity";
+    entity: Entity<M>;
+    entityId: string;
+    path: string;
+    parentCollection: EntityCollection<M>;
+}
+/**
+ * @see resolveNavigationFrom
+ * @group Hooks and utilities
+ */
+export interface ResolvedNavigationCollection<M extends Record<string, any>> {
+    type: "collection";
+    path: string;
+    collection: EntityCollection<M>;
+}
+/**
+ * @see resolveNavigationFrom
+ * @group Hooks and utilities
+ */
+interface ResolvedNavigationEntityCustom<M extends Record<string, any>> {
+    type: "custom_view";
+    path: string;
+    view: EntityCustomView<M>;
+}
+/**
+ * Use this function to retrieve an array of navigation entries (resolved
+ * collection, entity or entity custom_view) for the given path. You need to pass the app context
+ * that you receive in different callbacks, such as the save hooks.
+ *
+ * It will take into account the `navigation` provided at the `FireCMS` level.
+ *
+ * @param path
+ * @param context
+ * @group Hooks and utilities
+ */
+export declare function resolveNavigationFrom<M extends Record<string, any>, UserType extends User>({ path, context }: {
+    path: string;
+    context: FireCMSContext<UserType>;
+}): Promise<ResolvedNavigationEntry<M>[]>;
+/**
+ * @group Hooks and utilities
+ */
+export interface NavigationFromProps {
+    path: string;
+}
+/**
+ * @group Hooks and utilities
+ */
+export interface NavigationFrom<M extends Record<string, any>> {
+    data?: ResolvedNavigationEntry<M>[];
+    dataLoading: boolean;
+    dataLoadingError?: Error;
+}
+/**
+ * Use this hook to retrieve an array of navigation entries (resolved
+ * collection or entity) for the given path. You can use this hook
+ * in any React component that lives under `FireCMS`
+ * @group Hooks and utilities
+ */
+export declare function useResolvedNavigationFrom<M extends Record<string, any>, UserType extends User>({ path }: NavigationFromProps): NavigationFrom<M>;
+export {};

package/dist/hooks/useSideDialogsController.d.ts

@@ -0,0 +1,18 @@
+import { SideDialogsController } from "../types";
+/**
+ * Hook to retrieve the side dialogs' controller.
+ *
+ * This hook allows you to open and close side dialogs. This is the mechanism
+ * used when open a side entity dialog, or when selecting a reference.
+ *
+ * If you want to open a side entity dialog, you can use the {@link useSideEntityController}
+ * hook.
+ *
+ * If you want to select a reference, you can use the {@link useReferenceDialog}
+ *
+ * Consider that in order to use this hook you need to have a parent
+ * `FireCMS`
+ *
+ * @group Hooks and utilities
+ */
+export declare const useSideDialogsController: () => SideDialogsController;

package/dist/hooks/useSideEntityController.d.ts

@@ -0,0 +1,12 @@
+import { SideEntityController } from "../types";
+/**
+ * Use this hook to retrieve an entity controller that allows you to open
+ * a side dialog to edit an entity.
+ *
+ * Consider that in order to use this hook you need to have a parent
+ * `FireCMS`
+ *
+ * @see SideEntityController
+ * @group Hooks and utilities
+ */
+export declare const useSideEntityController: () => SideEntityController;

package/dist/hooks/useSnackbarController.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Possible snackbar types
+ * @group Hooks and utilities
+ */
+export type SnackbarMessageType = "success" | "info" | "warning" | "error";
+/**
+ * Controller to display snackbars
+ * @group Hooks and utilities
+ */
+export interface SnackbarController {
+    /**
+     * Close the currently open snackbar
+     */
+    close: () => void;
+    /**
+     * Display a new snackbar. You need to specify the type and message.
+     * You can optionally specify a title
+     */
+    open: (props: {
+        type: SnackbarMessageType;
+        message: React.ReactNode;
+        autoHideDuration?: number;
+    }) => void;
+}
+/**
+ * Hook to retrieve the SnackbarContext.
+ *
+ * Consider that in order to use this hook you need to have a parent
+ * `FireCMS`
+ *
+ * @see SnackbarController
+ * @group Hooks and utilities
+ */
+export declare const useSnackbarController: () => {
+    open: (props: {
+        type: SnackbarMessageType;
+        message: React.ReactNode;
+        autoHideDuration?: number;
+    }) => void;
+    close: () => void;
+};

package/dist/hooks/useStorageSource.d.ts

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

package/dist/hooks/useUserConfigurationPersistence.d.ts

@@ -0,0 +1,8 @@
+import { UserConfigurationPersistence } from "../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/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./core";
+export * from "./types";
+export * from "./form";
+export * from "./preview";
+export * from "./hooks";
+export * from "./components";
+export * from "./util";
+export * from "./contexts";