@questpie/admin 1.1.0 → 2.0.0

package/dist/client/runtime/content-locales-provider.mjs

@@ -0,0 +1,85 @@
+import { selectClient, useAdminStore } from "./provider.mjs";
+import { DEFAULT_LOCALE } from "questpie/shared";
+import { useQuery } from "@tanstack/react-query";
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/client/runtime/content-locales-provider.tsx
+/**
+* Content Locales Provider
+*
+* Fetches and provides content locales from the backend CMS configuration.
+* Content locales are different from UI locales - they define which languages
+* are available for content translation.
+*/
+const ContentLocalesContext = createContext(null);
+const DEFAULT_LOCALES = {
+	locales: [{
+		code: DEFAULT_LOCALE,
+		label: "English",
+		fallback: true
+	}],
+	defaultLocale: DEFAULT_LOCALE
+};
+/**
+* Content Locales Provider
+*
+* Fetches content locales from the backend and provides them to the UI.
+* Must be used inside AdminProvider to access the client.
+*
+* @example
+* ```tsx
+* <AdminProvider admin={admin} client={client}>
+*   <ContentLocalesProvider>
+*     <App />
+*   </ContentLocalesProvider>
+* </AdminProvider>
+* ```
+*/
+function ContentLocalesProvider({ children }) {
+	const client = useAdminStore(selectClient);
+	const { data, isLoading, error } = useQuery({
+		queryKey: ["cms", "contentLocales"],
+		queryFn: async () => {
+			try {
+				return await client.rpc.getContentLocales({});
+			} catch {
+				return DEFAULT_LOCALES;
+			}
+		},
+		staleTime: 300 * 1e3,
+		gcTime: 600 * 1e3
+	});
+	const localesData = data ?? DEFAULT_LOCALES;
+	const value = {
+		...localesData,
+		isLocalized: localesData.locales.length > 1,
+		isLoading,
+		error,
+		getLocaleLabel: (code) => {
+			return localesData.locales.find((l) => l.code === code)?.label ?? code.toUpperCase();
+		},
+		isValidLocale: (code) => {
+			return localesData.locales.some((l) => l.code === code);
+		},
+		getFallbackLocale: (code) => {
+			if (localesData.fallbacks?.[code]) return localesData.fallbacks[code];
+			return localesData.defaultLocale;
+		}
+	};
+	return /* @__PURE__ */ jsx(ContentLocalesContext.Provider, {
+		value,
+		children
+	});
+}
+/**
+* Safely get content locales from context.
+* Returns null if not inside provider (useful for optional features).
+*/
+function useSafeContentLocales() {
+	return useContext(ContentLocalesContext);
+}
+
+//#endregion
+export { ContentLocalesProvider, useSafeContentLocales };
+//# sourceMappingURL=content-locales-provider.mjs.map

package/dist/client/runtime/content-locales-provider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-locales-provider.mjs","names":["DEFAULT_LOCALES: ContentLocalesData","value: ContentLocalesContextValue"],"sources":["../../../src/client/runtime/content-locales-provider.tsx"],"sourcesContent":["/**\n * Content Locales Provider\n *\n * Fetches and provides content locales from the backend CMS configuration.\n * Content locales are different from UI locales - they define which languages\n * are available for content translation.\n */\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport { DEFAULT_LOCALE } from \"questpie/shared\";\nimport {\n  createContext,\n  type ReactElement,\n  type ReactNode,\n  useContext,\n} from \"react\";\nimport { selectClient, useAdminStore } from \"./provider\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface ContentLocale {\n  /** Locale code (e.g. \"en\", \"sk\", \"en-US\") */\n  code: string;\n  /** Human-readable label (e.g. \"English\", \"Slovenčina\") */\n  label?: string;\n  /** Is this the fallback locale? */\n  fallback?: boolean;\n  /** Custom country code for flag display (e.g. \"us\" for \"en\") */\n  flagCountryCode?: string;\n}\n\nexport interface ContentLocalesData {\n  /** Available content locales */\n  locales: ContentLocale[];\n  /** Default locale code */\n  defaultLocale: string;\n  /** Fallback locale mappings (e.g. { \"en-GB\": \"en\" }) */\n  fallbacks?: Record<string, string>;\n}\n\nexport interface ContentLocalesContextValue extends ContentLocalesData {\n  /** Check if localization is enabled (more than one locale) */\n  isLocalized: boolean;\n  /** Get the human-readable label for a locale code */\n  getLocaleLabel: (code: string) => string;\n  /** Check if a locale code is valid */\n  isValidLocale: (code: string) => boolean;\n  /** Get fallback locale for a given locale */\n  getFallbackLocale: (code: string) => string;\n  /** Loading state */\n  isLoading: boolean;\n  /** Error state */\n  error: Error | null;\n}\n\n// ============================================================================\n// Context\n// ============================================================================\n\nconst ContentLocalesContext = createContext<ContentLocalesContextValue | null>(\n  null,\n);\n\n// ============================================================================\n// Default Values\n// ============================================================================\n\nconst DEFAULT_LOCALES: ContentLocalesData = {\n  locales: [{ code: DEFAULT_LOCALE, label: \"English\", fallback: true }],\n  defaultLocale: DEFAULT_LOCALE,\n};\n\n// ============================================================================\n// Provider Component\n// ============================================================================\n\nexport interface ContentLocalesProviderProps {\n  children: ReactNode;\n}\n\n/**\n * Content Locales Provider\n *\n * Fetches content locales from the backend and provides them to the UI.\n * Must be used inside AdminProvider to access the client.\n *\n * @example\n * ```tsx\n * <AdminProvider admin={admin} client={client}>\n *   <ContentLocalesProvider>\n *     <App />\n *   </ContentLocalesProvider>\n * </AdminProvider>\n * ```\n */\nexport function ContentLocalesProvider({\n  children,\n}: ContentLocalesProviderProps): ReactElement {\n  const client = useAdminStore(selectClient);\n\n  const { data, isLoading, error } = useQuery({\n    queryKey: [\"cms\", \"contentLocales\"],\n    queryFn: async () => {\n      try {\n        // Use type assertion since the client type may not include getContentLocales\n        // depending on which modules are used\n        const result = await (client as any).rpc.getContentLocales({});\n        return result as ContentLocalesData;\n      } catch {\n        // If the function doesn't exist, return default locales\n        return DEFAULT_LOCALES;\n      }\n    },\n    staleTime: 5 * 60 * 1000, // Cache for 5 minutes\n    gcTime: 10 * 60 * 1000, // Keep in cache for 10 minutes\n  });\n\n  const localesData = data ?? DEFAULT_LOCALES;\n\n  const value: ContentLocalesContextValue = {\n    ...localesData,\n    isLocalized: localesData.locales.length > 1,\n    isLoading,\n    error: error as Error | null,\n\n    getLocaleLabel: (code: string): string => {\n      const locale = localesData.locales.find((l) => l.code === code);\n      return locale?.label ?? code.toUpperCase();\n    },\n\n    isValidLocale: (code: string): boolean => {\n      return localesData.locales.some((l) => l.code === code);\n    },\n\n    getFallbackLocale: (code: string): string => {\n      // Check explicit fallbacks first\n      if (localesData.fallbacks?.[code]) {\n        return localesData.fallbacks[code];\n      }\n      // Return default locale\n      return localesData.defaultLocale;\n    },\n  };\n\n  return (\n    <ContentLocalesContext.Provider value={value}>\n      {children}\n    </ContentLocalesContext.Provider>\n  );\n}\n\n// ============================================================================\n// Hooks\n// ============================================================================\n\n/**\n * Get content locales from context.\n *\n * Must be used inside ContentLocalesProvider.\n * Returns locale data, helper functions, and loading state.\n *\n * @example\n * ```tsx\n * function LocaleSwitcher() {\n *   const {\n *     locales,\n *     defaultLocale,\n *     isLocalized,\n *     getLocaleLabel,\n *   } = useContentLocales();\n *\n *   if (!isLocalized) return null;\n *\n *   return (\n *     <select>\n *       {locales.map(l => (\n *         <option key={l.code} value={l.code}>\n *           {getLocaleLabel(l.code)}\n *         </option>\n *       ))}\n *     </select>\n *   );\n * }\n * ```\n */\nexport function useContentLocales(): ContentLocalesContextValue {\n  const context = useContext(ContentLocalesContext);\n  if (!context) {\n    throw new Error(\n      \"useContentLocales must be used within ContentLocalesProvider. \" +\n        \"Wrap your app with <ContentLocalesProvider> inside <AdminProvider>.\",\n    );\n  }\n  return context;\n}\n\n/**\n * Safely get content locales from context.\n * Returns null if not inside provider (useful for optional features).\n */\nexport function useSafeContentLocales(): ContentLocalesContextValue | null {\n  return useContext(ContentLocalesContext);\n}\n"],"mappings":";;;;;;;;;;;;;;AA6DA,MAAM,wBAAwB,cAC5B,KACD;AAMD,MAAMA,kBAAsC;CAC1C,SAAS,CAAC;EAAE,MAAM;EAAgB,OAAO;EAAW,UAAU;EAAM,CAAC;CACrE,eAAe;CAChB;;;;;;;;;;;;;;;;AAyBD,SAAgB,uBAAuB,EACrC,YAC4C;CAC5C,MAAM,SAAS,cAAc,aAAa;CAE1C,MAAM,EAAE,MAAM,WAAW,UAAU,SAAS;EAC1C,UAAU,CAAC,OAAO,iBAAiB;EACnC,SAAS,YAAY;AACnB,OAAI;AAIF,WADe,MAAO,OAAe,IAAI,kBAAkB,EAAE,CAAC;WAExD;AAEN,WAAO;;;EAGX,WAAW,MAAS;EACpB,QAAQ,MAAU;EACnB,CAAC;CAEF,MAAM,cAAc,QAAQ;CAE5B,MAAMC,QAAoC;EACxC,GAAG;EACH,aAAa,YAAY,QAAQ,SAAS;EAC1C;EACO;EAEP,iBAAiB,SAAyB;AAExC,UADe,YAAY,QAAQ,MAAM,MAAM,EAAE,SAAS,KAAK,EAChD,SAAS,KAAK,aAAa;;EAG5C,gBAAgB,SAA0B;AACxC,UAAO,YAAY,QAAQ,MAAM,MAAM,EAAE,SAAS,KAAK;;EAGzD,oBAAoB,SAAyB;AAE3C,OAAI,YAAY,YAAY,MAC1B,QAAO,YAAY,UAAU;AAG/B,UAAO,YAAY;;EAEtB;AAED,QACE,oBAAC,sBAAsB;EAAgB;EACpC;GAC8B;;;;;;AAqDrC,SAAgB,wBAA2D;AACzE,QAAO,WAAW,sBAAsB"}

package/dist/client/runtime/index.d.mts

@@ -0,0 +1,7 @@
+import { NavigationGroup, NavigationItem } from "./routes.mjs";
+import { AdminProvider, AdminProviderProps, AdminState, AdminStore, selectAdmin, selectBasePath, selectClient, selectNavigate, useAdminStore } from "./provider.mjs";
+import "./content-locales-provider.mjs";
+import "./locale-scope.mjs";
+import "./translations-provider.mjs";
+import { useShallow } from "zustand/shallow";
+export { useShallow };

package/dist/client/runtime/index.mjs

@@ -0,0 +1,8 @@
+import { buildNavigation, buildRoutes } from "./routes.mjs";
+import { TranslationsProvider, getAdminLocalesQueryOptions, getAdminTranslationsQueryOptions, getUiLocaleFromCookie, setUiLocaleCookie } from "./translations-provider.mjs";
+import { AdminProvider, selectAdmin, selectAuthClient, selectBasePath, selectBrandName, selectClient, selectContentLocale, selectNavigate, selectRealtime, selectSetContentLocale, useAdminStore } from "./provider.mjs";
+import { ContentLocalesProvider, useSafeContentLocales } from "./content-locales-provider.mjs";
+import { LocaleScopeProvider, useScopedLocale } from "./locale-scope.mjs";
+import { useShallow } from "zustand/shallow";
+
+export { useShallow };

package/dist/client/runtime/locale-scope.d.mts

@@ -0,0 +1,2 @@
+import "react";
+import "react/jsx-runtime";

package/dist/{runtime-6VZM878K.mjs → client/runtime/locale-scope.mjs}

@@ -1,7 +1,6 @@
-import { c as selectContentLocale, d as selectSetContentLocale, f as useAdminStore } from "./content-locales-provider-BXvuIgfg.mjs";
+import { selectContentLocale, selectSetContentLocale, useAdminStore } from "./provider.mjs";
 import * as React$1 from "react";
 import { jsx } from "react/jsx-runtime";
-import { useShallow } from "zustand/shallow";
 
 //#region src/client/runtime/locale-scope.tsx
 /**
@@ -65,5 +64,5 @@ function useScopedLocale() {
 }
 
 //#endregion
-export { LocaleScopeProvider as n, useScopedLocale as r, useShallow as t };
-//# sourceMappingURL=runtime-6VZM878K.mjs.map
+export { LocaleScopeProvider, useScopedLocale };
+//# sourceMappingURL=locale-scope.mjs.map

package/dist/client/runtime/locale-scope.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-scope.mjs","names":["React"],"sources":["../../../src/client/runtime/locale-scope.tsx"],"sourcesContent":["/**\n * LocaleScope Context\n *\n * Provides scoped locale state for nested forms (e.g., ResourceSheet).\n * When a component is wrapped in LocaleScopeProvider, locale changes\n * affect only that scope, not the global content locale.\n *\n * @example\n * ```tsx\n * // In ResourceSheet - creates isolated locale scope\n * <LocaleScopeProvider>\n *   <FormView ... />\n * </LocaleScopeProvider>\n *\n * // In FieldWrapper - uses scoped locale if available\n * const { locale, setLocale } = useScopedLocale();\n * ```\n */\n\nimport * as React from \"react\";\nimport {\n  selectContentLocale,\n  selectSetContentLocale,\n  useAdminStore,\n} from \"./index\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\ninterface LocaleScopeContextValue {\n  /** Current locale in this scope */\n  locale: string;\n  /** Set locale for this scope only */\n  setLocale: (locale: string) => void;\n  /** Whether we're in a scoped context (nested form) */\n  isScoped: boolean;\n}\n\n// ============================================================================\n// Context\n// ============================================================================\n\nconst LocaleScopeContext = React.createContext<LocaleScopeContextValue | null>(\n  null,\n);\n\n// ============================================================================\n// Provider\n// ============================================================================\n\ninterface LocaleScopeProviderProps {\n  children: React.ReactNode;\n  /** Initial locale (defaults to current global content locale) */\n  initialLocale?: string;\n}\n\n/**\n * Provides an isolated locale scope for nested forms.\n * Locale changes inside this provider don't affect the global state.\n */\nexport function LocaleScopeProvider({\n  children,\n  initialLocale,\n}: LocaleScopeProviderProps) {\n  const globalLocale = useAdminStore(selectContentLocale);\n  const [scopedLocale, setScopedLocale] = React.useState(\n    initialLocale ?? globalLocale,\n  );\n\n  // Sync with global locale on mount or when global changes (only if not yet modified)\n  const hasModifiedRef = React.useRef(false);\n  React.useEffect(() => {\n    if (!hasModifiedRef.current) {\n      setScopedLocale(globalLocale);\n    }\n  }, [globalLocale]);\n\n  const setLocale = React.useCallback((locale: string) => {\n    hasModifiedRef.current = true;\n    setScopedLocale(locale);\n  }, []);\n\n  const value = React.useMemo<LocaleScopeContextValue>(\n    () => ({\n      locale: scopedLocale,\n      setLocale,\n      isScoped: true,\n    }),\n    [scopedLocale, setLocale],\n  );\n\n  return (\n    <LocaleScopeContext.Provider value={value}>\n      {children}\n    </LocaleScopeContext.Provider>\n  );\n}\n\n// ============================================================================\n// Hooks\n// ============================================================================\n\n/**\n * Returns scoped locale if in a LocaleScopeProvider, otherwise global locale.\n * Use this in components that need locale-aware behavior (FieldWrapper, FormView).\n */\nexport function useScopedLocale(): LocaleScopeContextValue {\n  const scopedContext = React.useContext(LocaleScopeContext);\n  const globalLocale = useAdminStore(selectContentLocale);\n  const globalSetLocale = useAdminStore(selectSetContentLocale);\n\n  // If we're in a scoped context, use that\n  if (scopedContext) {\n    return scopedContext;\n  }\n\n  // Otherwise, use global locale\n  return {\n    locale: globalLocale,\n    setLocale: globalSetLocale,\n    isScoped: false,\n  };\n}\n\n/**\n * Returns true if we're currently in a scoped locale context (nested form).\n */\nexport function useIsLocaleScopeActive(): boolean {\n  const scopedContext = React.useContext(LocaleScopeContext);\n  return scopedContext !== null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAM,qBAAqBA,QAAM,cAC/B,KACD;;;;;AAgBD,SAAgB,oBAAoB,EAClC,UACA,iBAC2B;CAC3B,MAAM,eAAe,cAAc,oBAAoB;CACvD,MAAM,CAAC,cAAc,mBAAmBA,QAAM,SAC5C,iBAAiB,aAClB;CAGD,MAAM,iBAAiBA,QAAM,OAAO,MAAM;AAC1C,SAAM,gBAAgB;AACpB,MAAI,CAAC,eAAe,QAClB,iBAAgB,aAAa;IAE9B,CAAC,aAAa,CAAC;CAElB,MAAM,YAAYA,QAAM,aAAa,WAAmB;AACtD,iBAAe,UAAU;AACzB,kBAAgB,OAAO;IACtB,EAAE,CAAC;CAEN,MAAM,QAAQA,QAAM,eACX;EACL,QAAQ;EACR;EACA,UAAU;EACX,GACD,CAAC,cAAc,UAAU,CAC1B;AAED,QACE,oBAAC,mBAAmB;EAAgB;EACjC;GAC2B;;;;;;AAYlC,SAAgB,kBAA2C;CACzD,MAAM,gBAAgBA,QAAM,WAAW,mBAAmB;CAC1D,MAAM,eAAe,cAAc,oBAAoB;CACvD,MAAM,kBAAkB,cAAc,uBAAuB;AAG7D,KAAI,cACF,QAAO;AAIT,QAAO;EACL,QAAQ;EACR,WAAW;EACX,UAAU;EACX"}