@firecms/core 3.0.0 → 3.1.0-canary.02232f4

package/dist/form/validation.d.ts

@@ -1,8 +1,9 @@
 import { CMSType, ResolvedArrayProperty, ResolvedMapProperty, ResolvedProperties, ResolvedProperty } from "../types";
+import * as yup from "yup";
 import { AnySchema, ObjectSchema } from "yup";
 declare module "yup" {
-    interface ArraySchema<T> {
-        uniqueInArray(mapper: (a: T) => T, message: string): ArraySchema<T>;
+    interface ArraySchema<TIn extends any[] | null | undefined, TContext, TDefault = undefined, TFlags extends yup.Flags = ""> {
+        uniqueInArray(mapper: (a: any) => any, message: string): ArraySchema<TIn, TContext, TDefault, TFlags>;
     }
 }
 export type CustomFieldValidator = (props: {

package/dist/hooks/index.d.ts

@@ -24,3 +24,4 @@ export * from "./useBuildNavigationController";
 export * from "./useBuildLocalConfigurationPersistence";
 export * from "./useBuildModeController";
 export * from "./useValidateAuthenticator";
+export * from "./useTranslation";

package/dist/hooks/useBreadcrumbsController.d.ts

@@ -6,6 +6,10 @@ export interface BreadcrumbsController {
     set: (props: {
         breadcrumbs: BreadcrumbEntry[];
     }) => void;
+    /**
+     * Update the count for a specific breadcrumb by ID.
+     */
+    updateCount: (id: string, count: number | null | undefined) => void;
 }
 /**
  * @group Hooks and utilities
@@ -13,6 +17,18 @@ export interface BreadcrumbsController {
 export interface BreadcrumbEntry {
     title: string;
     url: string;
+    /**
+     * Optional entity count for collection breadcrumbs.
+     * - undefined: not applicable (e.g., entity breadcrumb, custom view)
+     * - null: loading
+     * - number: loaded count
+     */
+    count?: number | null;
+    /**
+     * Unique identifier for this breadcrumb (e.g., collection path).
+     * Used to update count without replacing entire breadcrumb array.
+     */
+    id?: string;
 }
 /**
  * Hook to retrieve the BreadcrumbsController.

package/dist/hooks/useBuildNavigationController.d.ts

@@ -1,5 +1,4 @@
 import { AuthController, CMSView, CMSViewsBuilder, DataSourceDelegate, EntityCollection, EntityCollectionsBuilder, FireCMSPlugin, NavigationController, NavigationGroupMapping, PermissionsBuilder, User, UserConfigurationPersistence } from "../types";
-export declare const NAVIGATION_DEFAULT_GROUP_NAME = "Views";
 export declare const NAVIGATION_ADMIN_GROUP_NAME = "Admin";
 export type BuildNavigationContextProps<EC extends EntityCollection, USER extends User> = {
     /**

package/dist/hooks/useCollapsedGroups.d.ts

@@ -2,8 +2,11 @@
  * Custom hook for managing collapsed/expanded state of navigation groups
  * with localStorage persistence. Automatically cleans up stale group entries
  * when groups are removed from the navigation.
+ *
+ * @param groupNames - Array of group names to track
+ * @param namespace - Namespace for localStorage key (e.g., "home", "drawer") to allow independent state
  */
-export declare function useCollapsedGroups(groupNames: string[]): {
-    isGroupCollapsed: (name: string) => boolean;
-    toggleGroupCollapsed: (name: string) => void;
+export declare function useCollapsedGroups(groupNames: (string | null)[], namespace?: string): {
+    isGroupCollapsed: (name?: string | null) => boolean;
+    toggleGroupCollapsed: (name?: string | null) => void;
 };

package/dist/hooks/useTranslation.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Internal hook for translating FireCMS UI strings.
+ *
+ * Uses the `firecms_core` i18next namespace that is initialised by
+ * `FireCMSi18nProvider`. 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/i18n/FireCMSi18nProvider.d.ts

@@ -0,0 +1,33 @@
+import { PropsWithChildren } from "react";
+import { FireCMSTranslations } from "../types/translations";
+export declare const FIRECMS_LOCALE_STORAGE_KEY = "firecms_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 FireCMSi18nProviderProps {
+    /** 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<FireCMSTranslations>;
+    };
+}
+/**
+ * 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 FireCMSi18nProvider({ locale, translations, children }: PropsWithChildren<FireCMSi18nProviderProps>): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/index.d.ts

@@ -7,3 +7,8 @@ export * from "./hooks";
 export * from "./components";
 export * from "./util";
 export * from "./contexts";
+export * from "./i18n/FireCMSi18nProvider";
+export * from "./locales/en";
+export * from "./locales/es";
+export * from "./editor";
+export * from "./util/objects";