@firecms/core 3.4.0-canary.cb27f16 → 3.4.0-canary.ce97da7

package/src/locales/pl.ts

@@ -65,8 +65,19 @@ export const pl: FireCMSTranslations = {
     select_from: "Wybierz z {{name}}",
     done: "Gotowe",
     log_out: "Wyloguj się",
-    license_needed: "Wymagana licencja",
-    license_description: "Aby korzystać z FireCMS PRO, potrzebujesz ważnej licencji. Skontaktuj się z nami pod adresem {{email}}, aby uzyskać więcej informacji.",
+    license_trial_banner: "Okres próbny FireCMS PRO w produkcji kończy się za {{days}} dni.",
+    license_trial_banner_one: "Okres próbny FireCMS PRO w produkcji kończy się za {{days}} dzień.",
+    license_expired_banner: "Twój okres próbny PRO zakończył się {{date}}. Funkcje PRO, takie jak edytor schematów, import/eksport i historia, są wstrzymane; Twoje dane i kolekcje nadal działają.",
+    license_expired_banner_undated: "Twój okres próbny PRO się zakończył. Funkcje PRO, takie jak edytor schematów, import/eksport i historia, są wstrzymane; Twoje dane i kolekcje nadal działają.",
+    license_invalid_project_banner: "Ten klucz licencyjny nie jest powiązany z projektem {{projectId}}. Do tego czasu funkcje PRO są wstrzymane.",
+    license_invalid_project_banner_unnamed: "Ten klucz licencyjny nie jest powiązany z tym projektem. Do tego czasu funkcje PRO są wstrzymane.",
+    license_over_quota_banner: "Liczba projektów objętych licencją: {{licensed}}, powiązanych z nią: {{actual}}.",
+    license_over_quota_banner_one: "Ta licencja obejmuje {{licensed}} projekt, a powiązanych z nią projektów jest: {{actual}}.",
+    license_get_license: "Kup licencję",
+    license_update_license: "Zaktualizuj licencję",
+    license_add_project_to_license: "Dodaj go do licencji",
+    pro_features_paused: "Funkcje PRO wstrzymane",
+    user_management_paused_description: "Zarządzanie użytkownikami i rolami jest częścią FireCMS PRO. Dotychczasowi użytkownicy i role nadal decydują o tym, kto może się zalogować i co może robić. Edytować je będzie można ponownie, gdy ten projekt otrzyma licencję.",
     column_cannot_be_edited: "Ta kolumna nie może być edytowana bezpośrednio",
     close: "Zamknij",
     unsaved_local_changes: "Niezapisane zmiany lokalne",
@@ -390,6 +401,8 @@ export const pl: FireCMSTranslations = {
     large_number_of_documents: "Ta kolekcja zawiera dużą liczbę dokumentów ({{count}}).",
     include_undefined_values: "Uwzględnij niezdefiniowane wartości",
     export_apply_filter_sort: "Eksportuj tylko wyniki zgodne z aktualnym filtrem/sortowaniem",
+    export_all_entities: "Wszystkie encje",
+    export_selected_entities: "Zaznaczone encje ({{count}})",
     submit: "Wyślij",
 
     no_filterable_properties: "Brak dostępnych właściwości do filtrowania",
@@ -439,6 +452,7 @@ export const pl: FireCMSTranslations = {
     roles_menu: "Role",
     project_settings: "Ustawienia projektu",
     firestore_manager: "Menedżer Firestore",
+    datatalk: "DataTalk",
     manage_your_firestore_data: "Zarządzaj danymi w Firestore",
 
     // ─── FireCMS Cloud Login ──────────────────────────────────────
@@ -455,6 +469,7 @@ export const pl: FireCMSTranslations = {
     not_the_admin_panel: "a nie na panelu administracyjnym.",
     join_our_newsletter: "Dołącz do naszego newslettera. Bez spamu, tylko ważne aktualizacje!",
     by_signing_in_you_agree_to_our: "Logując się, akceptujesz nasz",
+    please_accept_the_terms_to_continue: "Zaakceptuj regulamin, aby kontynuować",
     terms_and_conditions: "Regulamin",
     and_our: "oraz naszą",
     privacy_policy: "Politykę prywatności",
@@ -497,6 +512,7 @@ export const pl: FireCMSTranslations = {
     licensed_projects_lowercase: "licencjonowanych projektów",
     manage: "Zarządzaj",
     update_payment_method: "Zaktualizuj metodę płatności",
+    stripe_portal_error: "Nie udało się otworzyć Stripe: {{message}}",
     your_firecms_cloud_projects: "Twoje projekty FireCMS Cloud",
     status_active: "Aktywna",
     status_trialing: "Okres próbny",

package/src/locales/pt.ts

@@ -70,8 +70,19 @@ export const pt: FireCMSTranslations = {
     select_from: "Selecionar de {{name}}",
     done: "Concluído",
     log_out: "Terminar sessão",
-    license_needed: "Licença necessária",
-    license_description: "Precisa de uma licença válida para usar o FireCMS PRO. Por favor contacte {{email}} para mais informações.",
+    license_trial_banner: "Avaliação do FireCMS PRO: faltam {{days}} dias em produção.",
+    license_trial_banner_one: "Avaliação do FireCMS PRO: falta {{days}} dia em produção.",
+    license_expired_banner: "A sua avaliação PRO terminou a {{date}}. As funcionalidades PRO, como o editor de esquemas, a importação/exportação e o histórico, estão em pausa; os seus dados e coleções continuam a funcionar.",
+    license_expired_banner_undated: "A sua avaliação PRO terminou. As funcionalidades PRO, como o editor de esquemas, a importação/exportação e o histórico, estão em pausa; os seus dados e coleções continuam a funcionar.",
+    license_invalid_project_banner: "Esta chave de licença não está associada ao projeto {{projectId}}. As funcionalidades PRO ficam em pausa até que esteja.",
+    license_invalid_project_banner_unnamed: "Esta chave de licença não está associada a este projeto. As funcionalidades PRO ficam em pausa até que esteja.",
+    license_over_quota_banner: "Esta licença cobre {{licensed}} projetos e tem {{actual}} associados.",
+    license_over_quota_banner_one: "Esta licença cobre {{licensed}} projeto e tem {{actual}} associados.",
+    license_get_license: "Obter uma licença",
+    license_update_license: "Atualizar a sua licença",
+    license_add_project_to_license: "Adicioná-lo à sua licença",
+    pro_features_paused: "Funcionalidades PRO em pausa",
+    user_management_paused_description: "A gestão de utilizadores e funções faz parte do FireCMS PRO. Os seus utilizadores e funções atuais continuam a decidir quem pode iniciar sessão e o que pode fazer, e poderá voltar a editá-los assim que este projeto tiver uma licença.",
     column_cannot_be_edited: "Esta coluna não pode ser editada diretamente",
     close: "Fechar",
     unsaved_local_changes: "Alterações locais não guardadas",
@@ -395,6 +406,8 @@ export const pt: FireCMSTranslations = {
     large_number_of_documents: "Esta coleção tem um grande número de documentos ({{count}}).",
     include_undefined_values: "Incluir valores indefinidos",
     export_apply_filter_sort: "Exportar apenas os resultados que correspondem ao filtro/ordenação atual",
+    export_all_entities: "Todas as entidades",
+    export_selected_entities: "Entidades selecionadas ({{count}})",
     submit: "Submeter",
 
     no_filterable_properties: "Não há propriedades filtráveis disponíveis",
@@ -444,6 +457,7 @@ export const pt: FireCMSTranslations = {
     roles_menu: "Funções",
     project_settings: "Definições do projeto",
     firestore_manager: "Gerenciador do Firestore",
+    datatalk: "DataTalk",
     manage_your_firestore_data: "Gerencie os seus dados do Firestore",
 
     // ─── FireCMS Cloud Login ──────────────────────────────────────
@@ -460,6 +474,7 @@ export const pt: FireCMSTranslations = {
     not_the_admin_panel: "não no painel de administração.",
     join_our_newsletter: "Subscreva a nossa newsletter. Sem spam, apenas atualizações importantes!",
     by_signing_in_you_agree_to_our: "Ao iniciar sessão, concorda com os nossos",
+    please_accept_the_terms_to_continue: "Aceite os termos e condições para continuar",
     terms_and_conditions: "Termos e Condições",
     and_our: "e a nossa",
     privacy_policy: "Política de privacidade",
@@ -502,6 +517,7 @@ export const pt: FireCMSTranslations = {
     licensed_projects_lowercase: "projetos licenciados",
     manage: "Gerir",
     update_payment_method: "Atualizar método de pagamento",
+    stripe_portal_error: "Não foi possível abrir o Stripe: {{message}}",
     your_firecms_cloud_projects: "Os seus projetos FireCMS Cloud",
     status_active: "Ativo",
     status_trialing: "Em avaliação",

package/src/preview/components/DatePreview.tsx

@@ -1,9 +1,8 @@
 import React from "react";
 
 import { format } from "date-fns";
-import * as locales from "date-fns/locale";
 import { useCustomizationController } from "../../hooks";
-import { defaultDateFormat } from "../../util";
+import { defaultDateFormat, useDateFnsLocale } from "../../util";
 
 export interface DatePreviewProps {
     date: Date;
@@ -28,8 +27,7 @@ export function DatePreview({
 }: DatePreviewProps): React.ReactElement {
 
     const customizationController = useCustomizationController();
-    // @ts-ignore
-    const dateUtilsLocale = customizationController?.locale ? locales[customizationController?.locale] : undefined;
+    const dateUtilsLocale = useDateFnsLocale(customizationController?.locale);
 
     if (!date) {
         return <></>;

package/src/types/analytics.ts

@@ -44,5 +44,8 @@ export type CMSAnalyticsEvent =
 
     | "card_view_entity_click"
 
+    | "entity_history_opened"
+    | "entity_history_reverted"
+
     | "unmapped_event"
     ;

package/src/types/firecms.tsx

@@ -70,10 +70,28 @@ export type FireCMSProps<USER extends User> = {
     }) => React.ReactNode;
 
     /**
-     * If you have a custom API key, you can use it here.
+     * Your FireCMS PRO license key. It is checked against
+     * `https://api.firecms.co/access_log` when a user signs in.
      */
     apiKey?: string;
 
+    /**
+     * On sign-in FireCMS sends one request to `https://api.firecms.co/access_log`
+     * with the user's ID token (which carries the Firebase project id, the uid
+     * and the email), the user's email, the datasource key and the keys of the
+     * mounted plugins; the browser adds the page's referrer. It is how the
+     * FireCMS PRO license and trial are checked. No database credentials or
+     * content are sent.
+     *
+     * Set to `false` to skip that request. This only takes effect when the
+     * app has no `apiKey` and mounts no PRO plugin (collection editor, user
+     * management, import/export, entity history, data enhancement, DataTalk):
+     * otherwise the request is the license check and is always sent.
+     *
+     * Defaults to `true`.
+     */
+    telemetry?: boolean;
+
     /**
      * Record of custom form fields to be used in the CMS.
      * You can use the key to reference the custom field in

package/src/types/firecms_context.tsx

@@ -11,6 +11,7 @@ import { DialogsController } from "./dialogs_controller";
 import { CustomizationController } from "./customization_controller";
 import { AnalyticsController } from "./analytics_controller";
 import { InternalUserManagement } from "./internal_user_management";
+import { AccessResponse } from "./license";
 
 /**
  * Context that includes the internal controllers and contexts used by the app.
@@ -97,4 +98,12 @@ export type FireCMSContext<USER extends User = User, AuthControllerType extends
      */
     userManagement: InternalUserManagement<USER>
 
+    /**
+     * FireCMS license status of this project, `null` until the license check
+     * answers or when it is not sent. PRO plugins are paused while `blocked`
+     * is true.
+     * @see useLicenseStatus
+     */
+    licenseStatus?: AccessResponse | null;
+
 };

package/src/types/index.ts

@@ -29,3 +29,4 @@ export * from "./modify_collections";
 export * from "./analytics_controller";
 export * from "./customization_controller";
 export * from "./translations";
+export * from "./license";

package/src/types/license.ts

@@ -0,0 +1,62 @@
+/**
+ * What the FireCMS license check says about this project.
+ *
+ * - `not_required`: no PRO plugin is mounted.
+ * - `whitelisted`: the project is exempt from licensing.
+ * - `licensed`: a license covers this project.
+ * - `trial`: PRO plugins run on the free trial; see `daysLeft` and `trialEndsAt`.
+ * - `expired`: the trial ended without a license. PRO plugins are paused.
+ * - `invalid_project`: a license key was presented, but this project is not
+ *   linked to that license. PRO plugins are paused.
+ * - `over_quota`: the license has more projects linked than it pays for.
+ *   Nothing is paused.
+ *
+ * @group Models
+ */
+export type LicenseState =
+    | "not_required"
+    | "whitelisted"
+    | "licensed"
+    | "trial"
+    | "expired"
+    | "invalid_project"
+    | "over_quota";
+
+/**
+ * Response of the FireCMS license check (`POST https://api.firecms.co/access_log`).
+ *
+ * Servers older than the PRO relaunch send only `blocked` and `message`, so
+ * treat a missing `licenseState` as unknown. `blocked` is honoured either way.
+ *
+ * @group Models
+ */
+export type AccessResponse = {
+    /**
+     * True when the PRO plugins must be paused. The core CMS is never blocked.
+     */
+    blocked?: boolean;
+    licenseState?: LicenseState;
+    /**
+     * Number of projects the license pays for. Present with `licensed` and `over_quota`.
+     */
+    licensedProjects?: number;
+    /**
+     * Number of projects linked to the license.
+     */
+    linkedProjects?: number;
+    projectId?: string;
+    licenseId?: string;
+    /**
+     * ISO date the trial ends or ended. Present with `trial` and `expired`.
+     */
+    trialEndsAt?: string;
+    /**
+     * Whole days left in the trial, present with `trial`.
+     */
+    daysLeft?: number;
+    /**
+     * Where to get or update a license for this project.
+     */
+    subscribeUrl?: string;
+    message?: string;
+};

package/src/types/plugins.tsx

@@ -15,6 +15,9 @@ import { InternalUserManagement } from "./internal_user_management";
  * NOTE: This is a work in progress and the API is not stable yet.
  * @group Core
  */
+/** The strings a plugin contributes for one locale. */
+export type PluginTranslations = Record<string, string>;
+
 export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollection = EntityCollection, COL_ACTIONS_PROPS = any, COL_ACTIONS_START__PROPS = any> = {
 
     /**
@@ -33,8 +36,14 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
      * locales, specific for this plugin.
      * Keys can be existing `FireCMSTranslations` keys, or new keys if using
      * module augmentation.
+     *
+     * A value may be the strings themselves, or a function returning a promise
+     * of them. Use the function form for locales you ship in the plugin bundle:
+     * only the active language is ever read, so importing all of them statically
+     * puts every language into the bundle of every app that mounts the plugin.
+     * Both forms are supported; a plain record keeps working unchanged.
      */
-    i18n?: Record<string, Record<string, string>>;
+    i18n?: Record<string, PluginTranslations | (() => Promise<PluginTranslations>)>;
 
     /**
      * You can use this prop to add higher order components to the CMS.

package/src/types/translations.ts

@@ -66,8 +66,32 @@ export interface FireCMSTranslations {
     select_from: string;
     done: string;
     log_out: string;
-    license_needed: string;
-    license_description: string;
+    /** License banner during the PRO trial. `{{days}}` is the number of days left; plural form. */
+    license_trial_banner: string;
+    /** `license_trial_banner` when one day is left (i18next `_one` plural form). */
+    license_trial_banner_one: string;
+    /** License banner once the trial has ended. `{{date}}` is the day it ended. */
+    license_expired_banner: string;
+    /** `license_expired_banner` when the end date is not known. */
+    license_expired_banner_undated: string;
+    /** License banner when the license key is not linked to this project. `{{projectId}}` is the Firebase project id. */
+    license_invalid_project_banner: string;
+    /** `license_invalid_project_banner` when the project id is not known. */
+    license_invalid_project_banner_unnamed: string;
+    /** License banner when more projects are linked than the license covers. `{{licensed}}` covered, `{{actual}}` linked; plural form. */
+    license_over_quota_banner: string;
+    /** `license_over_quota_banner` when the license covers one project (i18next `_one` plural form). */
+    license_over_quota_banner_one: string;
+    /** Link in the license banner to buy a license. */
+    license_get_license: string;
+    /** Link in the over-quota banner to the license settings. */
+    license_update_license: string;
+    /** Link in the invalid-project banner to link this project to the license. */
+    license_add_project_to_license: string;
+    /** Title of the notice a PRO view shows while PRO features are paused. */
+    pro_features_paused: string;
+    /** Users and Roles views while PRO features are paused. */
+    user_management_paused_description: string;
     column_cannot_be_edited: string;
     close: string;
     unsaved_local_changes: string;
@@ -421,6 +445,10 @@ export interface FireCMSTranslations {
     include_undefined_values: string;
     /** Toggle in the export dialog, only shown when a filter or sort is active */
     export_apply_filter_sort: string;
+    /** Choice in the export dialog, only shown when entities are selected */
+    export_all_entities: string;
+    /** Same choice; `{{count}}` is the number of selected entities */
+    export_selected_entities: string;
     submit: string;
 
     no_filterable_properties: string;
@@ -470,6 +498,8 @@ export interface FireCMSTranslations {
     roles_menu: string;
     project_settings: string;
     firestore_manager: string;
+    /** The DataTalk product name, keyed so a locale can transliterate it. */
+    datatalk: string;
     manage_your_firestore_data: string;
 
     // ─── FireCMS Cloud Login ──────────────────────────────────────
@@ -486,6 +516,7 @@ export interface FireCMSTranslations {
     not_the_admin_panel: string;
     join_our_newsletter: string;
     by_signing_in_you_agree_to_our: string;
+    please_accept_the_terms_to_continue: string;
     terms_and_conditions: string;
     and_our: string;
     privacy_policy: string;
@@ -528,6 +559,8 @@ export interface FireCMSTranslations {
     licensed_projects_lowercase: string;
     manage: string;
     update_payment_method: string;
+    /** Snackbar when a Stripe billing portal link can't be created. `{{message}}` is the reason. */
+    stripe_portal_error: string;
     your_firecms_cloud_projects: string;
     status_active: string;
     status_trialing: string;

package/src/util/date_fns_locales.ts

@@ -0,0 +1,168 @@
+import { useEffect, useReducer } from "react";
+import type { Locale as DateFnsLocale } from "date-fns";
+import { Locale } from "../types";
+
+/**
+ * On-demand loading of date-fns locales.
+ *
+ * `import * as locales from "date-fns/locale"` pulls in every locale date-fns
+ * ships — 625KB of parsed JavaScript, loaded on every single page view, to
+ * support a `locale` setting that is unset for almost every project. Worse, it
+ * sat on the critical path: `@firecms/core` imported it statically, so the
+ * browser could not render anything until it had come down.
+ *
+ * Each locale now has its own dynamic import, so exactly one small chunk is
+ * fetched, and only when a project actually configures a locale. Projects that
+ * do not configure one (the default) pay nothing at all.
+ *
+ * The map is written out rather than built from a template literal because Vite
+ * and webpack both need the specifier to be statically analysable to emit the
+ * chunks.
+ */
+const loaders: Partial<Record<Locale, () => Promise<DateFnsLocale>>> = {
+    af: () => import("date-fns/locale/af").then(m => m.af),
+    ar: () => import("date-fns/locale/ar").then(m => m.ar),
+    arDZ: () => import("date-fns/locale/ar-DZ").then(m => m.arDZ),
+    arMA: () => import("date-fns/locale/ar-MA").then(m => m.arMA),
+    arSA: () => import("date-fns/locale/ar-SA").then(m => m.arSA),
+    az: () => import("date-fns/locale/az").then(m => m.az),
+    be: () => import("date-fns/locale/be").then(m => m.be),
+    bg: () => import("date-fns/locale/bg").then(m => m.bg),
+    bn: () => import("date-fns/locale/bn").then(m => m.bn),
+    ca: () => import("date-fns/locale/ca").then(m => m.ca),
+    cs: () => import("date-fns/locale/cs").then(m => m.cs),
+    cy: () => import("date-fns/locale/cy").then(m => m.cy),
+    da: () => import("date-fns/locale/da").then(m => m.da),
+    de: () => import("date-fns/locale/de").then(m => m.de),
+    el: () => import("date-fns/locale/el").then(m => m.el),
+    enAU: () => import("date-fns/locale/en-AU").then(m => m.enAU),
+    enCA: () => import("date-fns/locale/en-CA").then(m => m.enCA),
+    enGB: () => import("date-fns/locale/en-GB").then(m => m.enGB),
+    enIN: () => import("date-fns/locale/en-IN").then(m => m.enIN),
+    enNZ: () => import("date-fns/locale/en-NZ").then(m => m.enNZ),
+    enUS: () => import("date-fns/locale/en-US").then(m => m.enUS),
+    eo: () => import("date-fns/locale/eo").then(m => m.eo),
+    es: () => import("date-fns/locale/es").then(m => m.es),
+    et: () => import("date-fns/locale/et").then(m => m.et),
+    eu: () => import("date-fns/locale/eu").then(m => m.eu),
+    faIR: () => import("date-fns/locale/fa-IR").then(m => m.faIR),
+    fi: () => import("date-fns/locale/fi").then(m => m.fi),
+    fr: () => import("date-fns/locale/fr").then(m => m.fr),
+    frCA: () => import("date-fns/locale/fr-CA").then(m => m.frCA),
+    frCH: () => import("date-fns/locale/fr-CH").then(m => m.frCH),
+    gd: () => import("date-fns/locale/gd").then(m => m.gd),
+    gl: () => import("date-fns/locale/gl").then(m => m.gl),
+    gu: () => import("date-fns/locale/gu").then(m => m.gu),
+    he: () => import("date-fns/locale/he").then(m => m.he),
+    hi: () => import("date-fns/locale/hi").then(m => m.hi),
+    hr: () => import("date-fns/locale/hr").then(m => m.hr),
+    hu: () => import("date-fns/locale/hu").then(m => m.hu),
+    hy: () => import("date-fns/locale/hy").then(m => m.hy),
+    id: () => import("date-fns/locale/id").then(m => m.id),
+    is: () => import("date-fns/locale/is").then(m => m.is),
+    it: () => import("date-fns/locale/it").then(m => m.it),
+    ja: () => import("date-fns/locale/ja").then(m => m.ja),
+    ka: () => import("date-fns/locale/ka").then(m => m.ka),
+    kk: () => import("date-fns/locale/kk").then(m => m.kk),
+    kn: () => import("date-fns/locale/kn").then(m => m.kn),
+    ko: () => import("date-fns/locale/ko").then(m => m.ko),
+    lb: () => import("date-fns/locale/lb").then(m => m.lb),
+    lt: () => import("date-fns/locale/lt").then(m => m.lt),
+    lv: () => import("date-fns/locale/lv").then(m => m.lv),
+    mk: () => import("date-fns/locale/mk").then(m => m.mk),
+    ms: () => import("date-fns/locale/ms").then(m => m.ms),
+    mt: () => import("date-fns/locale/mt").then(m => m.mt),
+    nb: () => import("date-fns/locale/nb").then(m => m.nb),
+    nl: () => import("date-fns/locale/nl").then(m => m.nl),
+    nlBE: () => import("date-fns/locale/nl-BE").then(m => m.nlBE),
+    nn: () => import("date-fns/locale/nn").then(m => m.nn),
+    pl: () => import("date-fns/locale/pl").then(m => m.pl),
+    pt: () => import("date-fns/locale/pt").then(m => m.pt),
+    ptBR: () => import("date-fns/locale/pt-BR").then(m => m.ptBR),
+    ro: () => import("date-fns/locale/ro").then(m => m.ro),
+    ru: () => import("date-fns/locale/ru").then(m => m.ru),
+    sk: () => import("date-fns/locale/sk").then(m => m.sk),
+    sl: () => import("date-fns/locale/sl").then(m => m.sl),
+    sr: () => import("date-fns/locale/sr").then(m => m.sr),
+    srLatn: () => import("date-fns/locale/sr-Latn").then(m => m.srLatn),
+    sv: () => import("date-fns/locale/sv").then(m => m.sv),
+    ta: () => import("date-fns/locale/ta").then(m => m.ta),
+    te: () => import("date-fns/locale/te").then(m => m.te),
+    th: () => import("date-fns/locale/th").then(m => m.th),
+    tr: () => import("date-fns/locale/tr").then(m => m.tr),
+    ug: () => import("date-fns/locale/ug").then(m => m.ug),
+    uk: () => import("date-fns/locale/uk").then(m => m.uk),
+    uz: () => import("date-fns/locale/uz").then(m => m.uz),
+    vi: () => import("date-fns/locale/vi").then(m => m.vi),
+    zhCN: () => import("date-fns/locale/zh-CN").then(m => m.zhCN),
+    zhTW: () => import("date-fns/locale/zh-TW").then(m => m.zhTW),
+};
+
+const cache = new Map<Locale, DateFnsLocale>();
+const inFlight = new Map<Locale, Promise<DateFnsLocale | undefined>>();
+
+/**
+ * Load a date-fns locale, resolving from cache when it is already in memory.
+ * Concurrent callers for the same locale share one request.
+ */
+export function loadDateFnsLocale(locale: Locale): Promise<DateFnsLocale | undefined> {
+    const cached = cache.get(locale);
+    if (cached) {
+        return Promise.resolve(cached);
+    }
+    const pending = inFlight.get(locale);
+    if (pending) {
+        return pending;
+    }
+    const loader = loaders[locale];
+    if (!loader) {
+        // An unknown key behaves as it did when the whole barrel was imported:
+        // the lookup missed and date-fns fell back to its built-in English.
+        return Promise.resolve(undefined);
+    }
+    const promise = loader()
+        .then((loaded) => {
+            cache.set(locale, loaded);
+            return loaded;
+        })
+        .catch(() => undefined)
+        .finally(() => {
+            inFlight.delete(locale);
+        });
+    inFlight.set(locale, promise);
+    return promise;
+}
+
+/** The locale if it is already loaded, otherwise undefined. Never suspends. */
+export function getLoadedDateFnsLocale(locale?: Locale): DateFnsLocale | undefined {
+    return locale ? cache.get(locale) : undefined;
+}
+
+/**
+ * The date-fns locale for `locale`, loading it in the background on first use.
+ *
+ * Returns undefined until the chunk arrives, which formats the first paint with
+ * date-fns' built-in English and then re-renders. That is a change only for
+ * projects that set a locale, and only for the few hundred milliseconds before
+ * the chunk lands — in exchange for every project no longer waiting on 625KB.
+ */
+export function useDateFnsLocale(locale?: Locale): DateFnsLocale | undefined {
+    const [, forceUpdate] = useReducer((count: number) => count + 1, 0);
+
+    useEffect(() => {
+        if (!locale || cache.has(locale)) {
+            return;
+        }
+        let active = true;
+        loadDateFnsLocale(locale).then((loaded) => {
+            if (active && loaded) {
+                forceUpdate();
+            }
+        });
+        return () => {
+            active = false;
+        };
+    }, [locale]);
+
+    return locale ? cache.get(locale) : undefined;
+}

package/src/util/index.ts

@@ -28,3 +28,4 @@ export * from "./storage";
 export * from "./callbacks";
 export * from "./conditions";
 export * from "./lazy_eager";
+export * from "./date_fns_locales";

package/src/util/lazy_eager.tsx

@@ -1,9 +1,35 @@
 import React from "react";
 
 /**
- * Returns a React.lazy component that is also preloaded immediately using
- * requestIdleCallback or setTimeout.
- * This ensures that chunks are split, but fetched in the background before they are actually needed.
+ * Prefetch after the page has loaded, never during it.
+ *
+ * An idle callback scheduled at module evaluation time fires in the gaps between
+ * the tasks of the initial load — which is exactly when the critical chunks are
+ * still in flight. With a dozen route components each queueing one, the
+ * background prefetch was competing with the render path for connections and
+ * bandwidth. Waiting for the load event costs the prefetch nothing that matters:
+ * it exists to be ready before a navigation, not before first paint.
+ */
+function schedulePrefetch(load: () => void) {
+    const whenIdle = () => {
+        if ("requestIdleCallback" in window) {
+            (window as any).requestIdleCallback(load);
+        } else {
+            setTimeout(load, 500);
+        }
+    };
+
+    if (document.readyState === "complete") {
+        whenIdle();
+    } else {
+        window.addEventListener("load", whenIdle, { once: true });
+    }
+}
+
+/**
+ * Returns a React.lazy component that is also preloaded in the background, once
+ * the page has finished loading.
+ * This ensures that chunks are split, but fetched before they are actually needed.
  */
 export function lazyEager<T extends React.ComponentType<any>>(
     factory: () => Promise<any>,
@@ -22,11 +48,7 @@ export function lazyEager<T extends React.ComponentType<any>>(
     };
 
     if (typeof window !== "undefined") {
-        if ("requestIdleCallback" in window) {
-            (window as any).requestIdleCallback(load);
-        } else {
-            setTimeout(load, 500);
-        }
+        schedulePrefetch(load);
     }
 
     return React.lazy(load);

package/src/util/navigation_utils.ts

@@ -281,7 +281,12 @@ export function resolveCollectionPathIds(path: string, allCollections: EntityCol
                 col,
                 match: col.id
             }])
-            .filter(p => p.match && remainingPath.startsWith(p.match))
+            // A match has to end where a path segment ends. Matching any prefix made
+            // "products-test" resolve to the "products" collection with an entity called
+            // "-test" (FirebaseError: Invalid document reference), and any collection whose
+            // path merely starts with another's — "products_archive", which the collection
+            // editor generates from "Products archive" — resolve to the wrong one.
+            .filter(p => p.match && (remainingPath === p.match || remainingPath.startsWith(p.match + "/")))
             .sort((a, b) => b.match.length - a.match.length);
 
         if (potentialMatches.length > 0) {

package/src/util/useStorageUploadController.tsx

@@ -1,4 +1,4 @@
-import Compressor from "compressorjs";
+import type CompressorType from "compressorjs";
 import equal from "react-fast-compare";
 
 import {
@@ -321,6 +321,11 @@ export async function resizeImage(
         mimeType = `image/${imageResize.format}`;
     }
 
+    // Loaded here rather than imported: compressing an image is something a
+    // small fraction of sessions ever does, and a static import put the library
+    // in `@firecms/core` for everyone.
+    const Compressor: typeof CompressorType = (await import("compressorjs")).default;
+
     return new Promise<File>((resolve, reject) => {
         new Compressor(file, {
             quality,