fastapi-rtk 2.1.5 → 2.2.1

package/dist/core/esm/Wrappers/ApiProvider/hooks/useProvideApi.mjs

@@ -4,7 +4,7 @@ import { useDidUpdate } from "@mantine/hooks";
 import { keepPreviousData } from "../../../../../.external/esm/@tanstack_query-core@5.90.20/@tanstack/query-core/build/modern/utils.mjs";
 import { useQuery } from "../../../../../.external/esm/@tanstack_react-query@5.90.20_react@19.2.3/@tanstack/react-query/build/modern/useQuery.mjs";
 import { useInfiniteQuery } from "../../../../../.external/esm/@tanstack_react-query@5.90.20_react@19.2.3/@tanstack/react-query/build/modern/useInfiniteQuery.mjs";
-import { useLang } from "../../../hooks/lang/useLang.mjs";
+import { useLang } from "fastapi-rtk/contexts";
 import { createItem } from "../utils/api/createItem.mjs";
 import { deleteItem } from "../utils/api/deleteItem.mjs";
 import { downloadItems } from "../utils/api/downloadItems.mjs";
@@ -41,22 +41,22 @@ const getStreamingQuerySignature = (params) => {
   delete rest.streaming;
   return JSON.stringify(rest);
 };
-function useProvideApi({
-  path,
-  initialQueryParams,
-  relation,
-  fetchInfo = true,
-  clearInfoOnRefetch = false,
-  clearDataOnRefetch = false,
-  refetchInfoBasedOnLang = true,
-  refetchDataBasedOnLang = true,
-  resetQueryParamsOnPathChange = true,
-  infoQueryProps,
-  dataQueryProps,
-  streamingQueryProps,
-  streaming: streamingMode = false
-}, api = defaultApi) {
-  var _a;
+function useProvideApi(params, api = defaultApi) {
+  const {
+    path,
+    initialQueryParams,
+    relation,
+    fetchInfo = true,
+    clearInfoOnRefetch = false,
+    clearDataOnRefetch = false,
+    refetchInfoBasedOnLang = true,
+    refetchDataBasedOnLang = true,
+    resetQueryParamsOnPathChange = true,
+    infoQueryProps,
+    dataQueryProps,
+    streamingQueryProps,
+    streaming: streamingMode = false
+  } = params;
   const [queryParams, setQueryParams] = useState(
     initialQueryParams ? createQueryParams(null, initialQueryParams) : null
   );
@@ -70,7 +70,11 @@ function useProvideApi({
         ...relation ? {
           filters: [
             ...queryParams.filters || [],
-            { col: relation.foreign_key, opr: relation.type, value: convertId(getItemId(relation)) }
+            {
+              col: relation.foreign_key ?? "",
+              opr: relation.type ?? "",
+              value: convertId(getItemId(relation))
+            }
           ]
         } : {}
       } : null;
@@ -81,22 +85,20 @@ function useProvideApi({
   const queryParamsRef = useLatest(memoizedQueryParams);
   const setQueryParamsCallback = useCallback(
     (partialQueryParams) => setQueryParams((prev) => {
-      if (typeof partialQueryParams === "function") {
-        partialQueryParams = partialQueryParams(prev);
-      }
+      const partial = typeof partialQueryParams === "function" ? partialQueryParams(prev) : partialQueryParams;
       if (!prev) {
-        return createQueryParams(null, partialQueryParams);
+        return createQueryParams(null, partial ?? void 0);
       }
-      const newQueryParams = createQueryParams({ ...prev }, partialQueryParams);
-      if (partialQueryParams) {
-        if ((partialQueryParams.filters || partialQueryParams.order_column || partialQueryParams.order_direction) && !partialQueryParams.page) {
+      const newQueryParams = createQueryParams({ ...prev }, partial ?? void 0);
+      if (partial) {
+        if ((partial.filters || partial.order_column || partial.order_direction) && !partial.page) {
           newQueryParams.page = 0;
         }
         if (streamingMode) {
-          if (partialQueryParams.page && partialQueryParams.page !== prev.page && !partialQueryParams.streaming) {
+          if (partial.page && partial.page !== prev.page && !partial.streaming) {
             throw new Error("You cannot change page in streaming mode, use streaming.fetch() instead");
           }
-          if (partialQueryParams.page_size && partialQueryParams.page_size !== prev.page_size) {
+          if (partial.page_size && partial.page_size !== prev.page_size) {
             throw new Error("You cannot change page size in streaming mode, use streaming.fetch() instead");
           }
         }
@@ -110,7 +112,14 @@ function useProvideApi({
   const { currentLanguage } = useLang();
   const infoQuery = useQuery({
     queryKey: [`info`, path, refetchInfoBasedOnLang ? currentLanguage : ""],
-    queryFn: ({ signal }) => api.getInfo(urlJoin(path, "_info"), { signal, headers: { "Accept-Language": currentLanguage } }).then((data) => ({ ...convertInfo(data), path })),
+    queryFn: ({ signal }) => api.getInfo(urlJoin(path, "_info"), { signal, headers: { "Accept-Language": currentLanguage } }).then((data) => {
+      const converted = convertInfo(data);
+      if (!converted) {
+        throw new Error("Empty /_info response");
+      }
+      return { ...converted, path };
+    }),
+    // #MUSTASSERT #MUSTANY null clears the placeholder at runtime; react-query's placeholderData type does not include null
     placeholderData: clearInfoOnRefetch ? null : keepPreviousData,
     enabled: fetchInfo,
     retry: false,
@@ -130,12 +139,19 @@ function useProvideApi({
     queryFn: ({ signal }) => memoizedQueryParams ? api.getItems(urlJoin(memoizedQueryParamsPathRef.current, "/"), memoizedQueryParams, {
       signal,
       headers: { "Accept-Language": currentLanguage }
-    }).then((data) => ({
-      ...data,
-      result: data.result.map((item, index) => ({ ...item, id: data.ids[index] })),
-      path: memoizedQueryParamsPathRef.current,
-      queryParams: memoizedQueryParams
-    })) : null,
+    }).then(
+      // #MUSTANY getItems resolves to a dynamic list response; the page shape is model-driven at runtime
+      (data) => ({
+        ...data,
+        result: data.result.map((item, index) => ({
+          ...item,
+          id: data.ids[index]
+        })),
+        path: memoizedQueryParamsPathRef.current,
+        queryParams: memoizedQueryParams
+      })
+    ) : null,
+    // #MUSTASSERT #MUSTANY null clears the placeholder at runtime; react-query's placeholderData type does not include null
     placeholderData: clearDataOnRefetch ? null : keepPreviousData,
     retry: false,
     enabled: !streamingMode,
@@ -158,30 +174,37 @@ function useProvideApi({
         return null;
       }
       const page = pageParam ?? memoizedQueryParams.page ?? 0;
-      const params = { ...memoizedQueryParams, page };
-      return api.getItems(urlJoin(memoizedQueryParamsPathRef.current, "/"), params, {
+      const params2 = { ...memoizedQueryParams, page };
+      return api.getItems(urlJoin(memoizedQueryParamsPathRef.current, "/"), params2, {
         signal,
         headers: { "Accept-Language": currentLanguage }
-      }).then((data) => ({
-        ...data,
-        result: data.result.map((item, index) => ({ ...item, id: data.ids[index] })),
-        path: memoizedQueryParamsPathRef.current,
-        queryParams: params
-      }));
+      }).then(
+        // #MUSTANY getItems resolves to a dynamic list response; the page shape is model-driven at runtime
+        (data) => ({
+          ...data,
+          result: data.result.map((item, index) => ({
+            ...item,
+            id: data.ids[index]
+          })),
+          path: memoizedQueryParamsPathRef.current,
+          queryParams: params2
+        })
+      );
     },
     initialPageParam: (memoizedQueryParams == null ? void 0 : memoizedQueryParams.page) ?? 0,
     getNextPageParam: (lastPage) => {
-      var _a2, _b;
+      var _a, _b;
       if (!lastPage) {
         return void 0;
       }
-      const currentPage = ((_a2 = lastPage.queryParams) == null ? void 0 : _a2.page) ?? 0;
+      const currentPage = ((_a = lastPage.queryParams) == null ? void 0 : _a.page) ?? 0;
       const pageSize = (_b = lastPage.queryParams) == null ? void 0 : _b.page_size;
       if (!pageSize || lastPage.result.length < pageSize) {
         return void 0;
       }
       return currentPage + 1;
     },
+    // #MUSTASSERT #MUSTANY null clears the placeholder at runtime; react-query's placeholderData type does not include null
     placeholderData: clearDataOnRefetch ? null : keepPreviousData,
     retry: false,
     enabled: streamingMode && !!memoizedQueryParams,
@@ -223,23 +246,27 @@ function useProvideApi({
     currentLanguage
   });
   const specialKey = useMemo(() => {
-    var _a2, _b;
-    const specialKey2 = {
-      all: "all",
-      actions: "actions"
+    const activeData = activeDataQuery.data;
+    const listColumns = activeData && "list_columns" in activeData ? activeData.list_columns : void 0;
+    return {
+      all: (listColumns == null ? void 0 : listColumns.includes("all")) ? "_all" : "all",
+      actions: (listColumns == null ? void 0 : listColumns.includes("actions")) ? "_actions" : "actions"
     };
-    (_b = (_a2 = activeDataQuery.data) == null ? void 0 : _a2.list_columns) == null ? void 0 : _b.forEach((key) => {
-      if (specialKey2[key]) {
-        specialKey2[key] = `_${key}`;
-      }
-    });
-    return specialKey2;
-  }, [(_a = activeDataQuery.data) == null ? void 0 : _a.list_columns]);
+  }, [activeDataQuery.data]);
   const refetch = useCallback(
-    () => queryParamsRef.current ? activeDataQuery.refetch() : setQueryParamsCallback(),
+    async () => {
+      if (queryParamsRef.current) {
+        await activeDataQuery.refetch();
+        return;
+      }
+      setQueryParamsCallback();
+    },
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [activeDataQuery.refetch, queryParamsRef, setQueryParamsCallback]
   );
+  const refetchInfo = useCallback(async () => {
+    await infoQuery.refetch();
+  }, [infoQuery.refetch]);
   return {
     path,
     data: activeDataQuery.data,
@@ -258,7 +285,7 @@ function useProvideApi({
     specialKey,
     setQueryParams: setQueryParamsCallback,
     refetch,
-    refetchInfo: infoQuery.refetch,
+    refetchInfo,
     getEntry,
     addEntry,
     updateEntry,
@@ -269,6 +296,7 @@ function useProvideApi({
     getImageURL: (item) => getItemURL("image", item),
     setError,
     resetError
+    // #MUSTASSERT useProvideApi holds raw react-query state (DataPage/StreamingPage data, raw QueryParams, null errors); this is the resolved ApiContextValue surface consumers read, normalized at runtime
   };
 }
 export {

package/dist/core/esm/Wrappers/ApiProvider/hooks/useProvideBulk.mjs

@@ -1,7 +1,8 @@
 import { useState, useCallback, useMemo } from "react";
 import { postBulk } from "../utils/bulkActions/postBulkAction.mjs";
 const defaultBulk = { postBulk };
-const useProvideBulk = ({ path }, bulk = defaultBulk) => {
+const useProvideBulk = (params, bulk = defaultBulk) => {
+  const { path } = params;
   const [selectedIds, setSelectedIds] = useState([]);
   const [error, setError] = useState();
   const resetError = useCallback(() => setError(void 0), []);

package/dist/core/esm/Wrappers/ApiProvider/hooks/utils/useApiActions.mjs

@@ -1,10 +1,14 @@
 import { convertId, urlJoin } from "fastapi-rtk/utils";
 import { useCallback } from "react";
-const useApiActions = ({ api, path, pathRef, infoRef, queryParamsRef, currentLanguage }) => {
+const useApiActions = (params) => {
+  const { api, path, pathRef, infoRef, queryParamsRef, currentLanguage } = params;
   const getEntry = useCallback(
-    async (id) => api.getItem(pathRef.current, convertId(id), {
-      headers: { "Accept-Language": currentLanguage }
-    }),
+    async (id) => (
+      // #MUSTASSERT convertId returns a broad union; ids resolve to a string/number at runtime
+      api.getItem(pathRef.current, convertId(id), {
+        headers: { "Accept-Language": currentLanguage }
+      })
+    ),
     [api, currentLanguage, pathRef]
   );
   const addEntry = useCallback(
@@ -28,13 +32,21 @@ const useApiActions = ({ api, path, pathRef, infoRef, queryParamsRef, currentLan
     [api.formUpdateItem, api.updateItem, currentLanguage, infoRef, pathRef]
   );
   const deleteEntry = useCallback(
-    async (id) => api.deleteItem(pathRef.current, convertId(id), {
-      headers: { "Accept-Language": currentLanguage }
-    }),
+    async (id) => (
+      // #MUSTASSERT convertId returns a broad union; ids resolve to a string/number at runtime
+      api.deleteItem(pathRef.current, convertId(id), {
+        headers: { "Accept-Language": currentLanguage }
+      })
+    ),
     [api, currentLanguage, pathRef]
   );
   const download = useCallback(
-    async (label, { export_mode, delimiter, quotechar } = {}) => api.downloadItems(pathRef.current, queryParamsRef.current, { label, export_mode, delimiter, quotechar }),
+    async (label, { export_mode, delimiter, quotechar } = {}) => api.downloadItems(pathRef.current, queryParamsRef.current ?? void 0, {
+      label,
+      export_mode,
+      delimiter,
+      quotechar
+    }),
     [api, pathRef, queryParamsRef]
   );
   const upload = useCallback(

package/dist/core/esm/Wrappers/ApiProvider/hooks/utils/useStreamingData.mjs

@@ -1,7 +1,8 @@
 import { useQueryClient } from "../../../../../../.external/esm/@tanstack_react-query@5.90.20_react@19.2.3/@tanstack/react-query/build/modern/QueryClientProvider.mjs";
 import { useMemo, useCallback } from "react";
-const useStreamingData = ({ streamingMode, dataQuery, streamingQuery, streamingQueryKey }) => {
+const useStreamingData = (params) => {
   var _a;
+  const { streamingMode, dataQuery, streamingQuery, streamingQueryKey } = params;
   const queryClient = useQueryClient();
   const streamingPages = useMemo(() => {
     var _a2;

package/dist/core/esm/Wrappers/ApiProvider/utils/getValidationSchema.mjs

@@ -2,7 +2,8 @@ import * as index_esm from "../../../../../.external/esm/yup@1.7.1/yup/index.esm
 import { object as create$3 } from "../../../../../.external/esm/yup@1.7.1/yup/index.esm.mjs";
 const getValidationSchema = (columns) => {
   const schema = columns.reduce((schema2, column) => {
-    let { name, required, type } = column;
+    const { name, required } = column;
+    let type = column.type;
     switch (type) {
       case "RelatedList":
         type = "array";
@@ -21,15 +22,18 @@ const getValidationSchema = (columns) => {
     }
     let validator;
     try {
+      const factory = index_esm[type];
       if (required) {
-        validator = index_esm[type]().typeError(`Field must be of type ${type}`).required("Field is required");
+        validator = factory().typeError(`Field must be of type ${type}`).required("Field is required");
       } else {
-        validator = index_esm[type]().typeError(`Field must be of type ${type}`).nullable(true);
+        validator = factory().typeError(`Field must be of type ${type}`).nullable(true);
       }
     } catch (error) {
       console.log(error);
     }
-    schema2[name] = validator;
+    if (validator) {
+      schema2[name] = validator;
+    }
     return schema2;
   }, {});
   return create$3().shape(schema);

package/dist/core/esm/Wrappers/InfiniteScroll/InfiniteScroll.mjs

@@ -1,19 +1,21 @@
-import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 import { parseFromValuesOrFunc } from "fastapi-rtk/utils";
 import { Center, Loader } from "@mantine/core";
 import { useInViewport } from "@mantine/hooks";
 import { useMemo, useEffect } from "react";
-import { useApi } from "../../hooks/api/useApi.mjs";
-const InfiniteScroll = ({
-  children,
-  fetch = true,
-  components: {
-    Loading = /* @__PURE__ */ jsx(Center, { children: /* @__PURE__ */ jsx(Loader, {}) }),
-    End = /* @__PURE__ */ jsx(Center, { children: "End of data" }),
-    FetchWrapper = Center
-  } = {},
-  fetchWrapperProps
-}) => {
+import { useTranslation, useApi } from "fastapi-rtk/contexts";
+const InfiniteScroll = (props) => {
+  const { t } = useTranslation();
+  const {
+    children,
+    fetch = true,
+    components: {
+      Loading = /* @__PURE__ */ jsx(Center, { children: /* @__PURE__ */ jsx(Loader, {}) }),
+      End = /* @__PURE__ */ jsx(Center, { children: t("End of data") }),
+      FetchWrapper = Center
+    } = {},
+    fetchWrapperProps
+  } = props;
   const { streaming, loading } = useApi();
   const { ref, inViewport } = useInViewport();
   const items = useMemo(() => Object.values(streaming.data).flat(), [streaming.data]);

package/dist/core/esm/Wrappers/LazyLoadWrapper/LazyLoadWrapper.mjs

@@ -1,5 +1,6 @@
 import { useTrueOnce } from "fastapi-rtk/hooks";
-function LazyLoadWrapper({ children, cond }) {
+function LazyLoadWrapper(props) {
+  const { children, cond } = props;
   const show = useTrueOnce(cond);
   return show ? children : null;
 }

package/dist/core/esm/Wrappers/Provider/Contexts/AuthContext.mjs

@@ -1,5 +1,7 @@
 import { createSafeContext } from "fastapi-rtk/utils";
-const [AuthContextProvider, useAuthProvider] = createSafeContext("useAuth must be used within a Provider");
+const [AuthContextProvider, useAuthProvider] = createSafeContext(
+  "useAuth must be used within a Provider"
+);
 export {
   AuthContextProvider,
   useAuthProvider

package/dist/core/esm/Wrappers/Provider/Contexts/InfoContext.mjs

@@ -1,5 +1,7 @@
 import { createSafeContext } from "fastapi-rtk/utils";
-const [InfoContextProvider, useInfoProvider] = createSafeContext("useInfo must be used within a Provider");
+const [InfoContextProvider, useInfoProvider] = createSafeContext(
+  "useInfo must be used within a Provider"
+);
 export {
   InfoContextProvider,
   useInfoProvider

package/dist/core/esm/Wrappers/Provider/Contexts/LangContext.mjs

@@ -1,6 +1,8 @@
 import { jsx } from "react/jsx-runtime";
 import { LANG_LOCAL_STORAGE_PROPS } from "fastapi-rtk/constants";
-import { createSafeContext, parseFromValuesOrFunc } from "fastapi-rtk/utils";
+import { InnerInnerLangContextProvider } from "fastapi-rtk/contexts";
+import { InnerInnerLangContextProvider as InnerInnerLangContextProvider2 } from "fastapi-rtk/contexts";
+import { parseFromValuesOrFunc } from "fastapi-rtk/utils";
 import { useProxy } from "fastapi-rtk/zustand";
 import { useLocalStorage } from "@mantine/hooks";
 import { createInstance } from "../../../../../.external/esm/i18next@25.8.0_typescript@5.9.3/i18next/dist/esm/i18next.mjs";
@@ -9,13 +11,15 @@ import de from "../../../translations/de.mjs";
 import { useProvideLang } from "../hooks/useProvideLang.mjs";
 import { I18nextProvider } from "../../../../../.external/esm/react-i18next@15.7.4_i18next@25.8.0_typescript@5.9.3__react-dom@19.2.3_react@19.2.3__react@19.2.3_typescript@5.9.3/react-i18next/dist/es/I18nextProvider.mjs";
 import { initReactI18next } from "../../../../../.external/esm/react-i18next@15.7.4_i18next@25.8.0_typescript@5.9.3__react-dom@19.2.3_react@19.2.3__react@19.2.3_typescript@5.9.3/react-i18next/dist/es/initReactI18next.mjs";
-const getI18n = ({ initProps, callback, translations } = {}) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
+const getI18n = (props = {}) => {
+  var _a, _b, _c, _d;
+  const { initProps, callback, translations } = props;
   const i18n = createInstance();
   const parsedTranslations = Object.entries(translations ?? {}).reduce((acc, [key, value]) => {
     acc[key] = { translation: value };
     return acc;
   }, {});
+  const initResources = (initProps == null ? void 0 : initProps.resources) ?? {};
   i18n.use(initReactI18next).init({
     ...initProps,
     // the translations
@@ -23,20 +27,20 @@ const getI18n = ({ initProps, callback, translations } = {}) => {
     // or even better, manage them via a UI: https://react.i18next.com/guides/multiple-translation-files#manage-your-translations-with-a-management-gui)
     resources: {
       ...parsedTranslations,
-      ...initProps == null ? void 0 : initProps.resources,
+      ...initResources,
       en: {
-        ...(_a = initProps == null ? void 0 : initProps.resources) == null ? void 0 : _a.en,
+        ...initResources.en,
         translation: {
-          ...(_b = parsedTranslations == null ? void 0 : parsedTranslations.en) == null ? void 0 : _b.translation,
-          ...(_d = (_c = initProps == null ? void 0 : initProps.resources) == null ? void 0 : _c.en) == null ? void 0 : _d.translation
+          ...(_a = parsedTranslations == null ? void 0 : parsedTranslations.en) == null ? void 0 : _a.translation,
+          ...(_b = initResources.en) == null ? void 0 : _b.translation
         }
       },
       de: {
-        ...(_e = initProps == null ? void 0 : initProps.resources) == null ? void 0 : _e.de,
+        ...initResources.de,
         translation: {
           ...de,
-          ...(_f = parsedTranslations == null ? void 0 : parsedTranslations.de) == null ? void 0 : _f.translation,
-          ...(_h = (_g = initProps == null ? void 0 : initProps.resources) == null ? void 0 : _g.de) == null ? void 0 : _h.translation
+          ...(_c = parsedTranslations == null ? void 0 : parsedTranslations.de) == null ? void 0 : _c.translation,
+          ...(_d = initResources.de) == null ? void 0 : _d.translation
         }
       }
     },
@@ -48,15 +52,14 @@ const getI18n = ({ initProps, callback, translations } = {}) => {
   });
   return parseFromValuesOrFunc(callback ?? i18n, i18n);
 };
-const [InnerInnerLangContextProvider, useLangProvider] = createSafeContext(
-  "useLang must be used within a Provider"
-);
-const InnerLangContextProvider = ({ children, MRTLocalization, ...props }) => {
+const InnerLangContextProvider = (props) => {
+  const { children, MRTLocalization, ...rest } = props;
   const lang = useProvideLang(MRTLocalization);
   const langProxy = useProxy(lang);
-  return /* @__PURE__ */ jsx(InnerInnerLangContextProvider, { value: langProxy, ...props, children });
+  return /* @__PURE__ */ jsx(InnerInnerLangContextProvider, { value: langProxy, ...rest, children });
 };
-const LangContextProvider = ({ children, langProps, props }) => {
+const LangContextProvider = (props) => {
+  const { children, langProps, props: contextProps } = props;
   const i18nRef = useRef((langProps == null ? void 0 : langProps.i18n) ?? getI18n(langProps == null ? void 0 : langProps.getI18nProps));
   const [localStorageLanguage] = useLocalStorage(LANG_LOCAL_STORAGE_PROPS);
   const language = useMemo(
@@ -66,11 +69,10 @@ const LangContextProvider = ({ children, langProps, props }) => {
   useEffect(() => {
     i18nRef.current.changeLanguage(language);
   }, [language]);
-  return /* @__PURE__ */ jsx(I18nextProvider, { i18n: i18nRef.current, children: /* @__PURE__ */ jsx(InnerLangContextProvider, { MRTLocalization: langProps == null ? void 0 : langProps.MRTLocalization, ...props, children }) });
+  return /* @__PURE__ */ jsx(I18nextProvider, { i18n: i18nRef.current, children: /* @__PURE__ */ jsx(InnerLangContextProvider, { MRTLocalization: langProps == null ? void 0 : langProps.MRTLocalization, ...contextProps, children }) });
 };
 export {
-  InnerInnerLangContextProvider,
+  InnerInnerLangContextProvider2 as InnerInnerLangContextProvider,
   InnerLangContextProvider,
-  LangContextProvider,
-  useLangProvider
+  LangContextProvider
 };

package/dist/core/esm/Wrappers/Provider/Provider.mjs

@@ -25,9 +25,12 @@ function InnerProvider(props) {
   const info = useProvideInfo(baseUrl, auth, infoParams);
   const infoProxy = useProxy(info);
   useEffect(() => {
-    setDebugMode(props.debug);
+    setDebugMode(props.debug ?? false);
   }, []);
-  return /* @__PURE__ */ jsx(AuthContextProvider, { value: authProxy, children: /* @__PURE__ */ jsx(InfoContextProvider, { value: infoProxy, children: /* @__PURE__ */ jsx(LangContextProvider, { langProps: props.langProps, children }) }) });
+  return (
+    // #MUSTASSERT #MUSTUNKNOWN useProvideAuth exposes error as a string and a deprecated oauth_signin alias, diverging from the AuthContextValue shape consumed downstream
+    /* @__PURE__ */ jsx(AuthContextProvider, { value: authProxy, children: /* @__PURE__ */ jsx(InfoContextProvider, { value: infoProxy, children: /* @__PURE__ */ jsx(LangContextProvider, { langProps: props.langProps, children }) }) })
+  );
 }
 const Provider = (props) => {
   const [queryClient] = useState(() => new QueryClient(props.queryClientProps));
@@ -39,7 +42,10 @@ const withProvider = (providerProps, Component, options = {}) => {
     const resolvedProps = parseFromValuesOrFunc(providerProps, props);
     return /* @__PURE__ */ jsx(Provider, { ...resolvedProps, children: /* @__PURE__ */ jsx(Component, { ...props, ref }) });
   };
-  const WrappedComponent = shouldForwardRef ? forwardRef(renderComponent) : (props) => renderComponent(props, void 0);
+  const WrappedComponent = shouldForwardRef ? (
+    // #MUSTANY ComponentProps<typeof Component> does not line up with forwardRef's PropsWithoutRef inference; the runtime render fn is correct
+    forwardRef(renderComponent)
+  ) : (props) => renderComponent(props, null);
   WrappedComponent.displayName = displayName || `withProvider(${Component.displayName || Component.name || "Component"})`;
   return WrappedComponent;
 };

package/dist/core/esm/Wrappers/Provider/hooks/useProvideLang.mjs

@@ -17,14 +17,15 @@ const useProvideLang = (baseMRTLocalization = {}) => {
     if (!translation.i18n.language) {
       return;
     }
-    if (!(MRTLocalization == null ? void 0 : MRTLocalization[translation.i18n.language])) {
-      if (!MRT_LOCALIZATION_IMPORT_MAP[translation.i18n.language]) {
+    const language = translation.i18n.language;
+    if (!(MRTLocalization == null ? void 0 : MRTLocalization[language])) {
+      if (!MRT_LOCALIZATION_IMPORT_MAP[language]) {
         FastAPIRTKLogger.error(
-          `No localization found for '${translation.i18n.language}', consider adding it yourself using 'MRTLocalization' prop within the 'langProps' in 'Provider' component. See here for the keys: https://github.com/KevinVandy/mantine-react-table/blob/v2/packages/mantine-react-table/src/locales/en.ts`
+          `No localization found for '${language}', consider adding it yourself using 'MRTLocalization' prop within the 'langProps' in 'Provider' component. See here for the keys: https://github.com/KevinVandy/mantine-react-table/blob/v2/packages/mantine-react-table/src/locales/en.ts`
         );
         return;
       }
-      MRT_LOCALIZATION_IMPORT_MAP[translation.i18n.language]().then((languagePack) => setMRTLocalization({ [translation.i18n.language]: languagePack })).catch(() => FastAPIRTKLogger.error(`Failed to load localization for ${translation.i18n.language}`));
+      MRT_LOCALIZATION_IMPORT_MAP[language]().then((languagePack) => setMRTLocalization({ [language]: languagePack })).catch(() => FastAPIRTKLogger.error(`Failed to load localization for ${language}`));
     }
   }, [translation.i18n.language]);
   return {

package/dist/core/esm/Wrappers/Provider/utils/authFetch.mjs

@@ -12,6 +12,7 @@ async function authSignin(baseUrl, { username, password }) {
     headers: {
       "Content-Type": "application/x-www-form-urlencoded"
     },
+    // #MUSTASSERT #MUSTANY URLSearchParams accepts FormData at runtime, but the DOM lib types omit that constructor overload
     body: new URLSearchParams(formData)
   });
   if (!res.ok) {

package/dist/core/esm/fab-react-toolkit-patch/api/hooks/useProvideApi.mjs

@@ -7,6 +7,7 @@ import { uploadItems } from "../../../Wrappers/ApiProvider/utils/api/uploadItems
 import { downloadItems } from "../utils/api/downloadItems.mjs";
 import { getItems } from "../utils/api/getItems.mjs";
 const defaultApi = {
+  // #MUSTANNOTATE interface annotation required so inline function params inside the literal inherit their types
   getItem,
   getItems,
   createItem,
@@ -15,12 +16,10 @@ const defaultApi = {
   downloadItems,
   uploadItems,
   getInfo,
-  // eslint-disable-next-line no-unused-vars
-  formCreateItem: async (path, item) => {
+  formCreateItem: async (_path, _item) => {
     throw new Error("formCreateItem is not implemented in fab");
   },
-  // eslint-disable-next-line no-unused-vars
-  formUpdateItem: async (path, id, item) => {
+  formUpdateItem: async (_path, _id, _item) => {
     throw new Error("formUpdateItem is not implemented in fab");
   }
 };

package/dist/core/esm/fab-react-toolkit-patch/api/utils/api/getItems.mjs

@@ -3,7 +3,7 @@ const getItems = async (path, queryParams, options) => {
   const { fetchPath, options: fetchOptions } = createFetchParams({
     path,
     method: "GET",
-    queryParams: { q: queryParams },
+    queryParams: { q: JSON.stringify(queryParams ?? {}) },
     options
   });
   const response = await fetch(fetchPath, fetchOptions);

package/dist/core/esm/fab-react-toolkit-patch/utils/convertToFormInputs.mjs

@@ -3,15 +3,15 @@ function convertToFormInputs(item, columns) {
   const result = {};
   columns.forEach((column) => {
     var _a;
-    const { type, values } = column;
+    const values = "values" in column ? column.values : void 0;
     if (!values) {
       result[column.name] = (getItemId(item[column.name]) || item[column.name]) ?? void 0;
       return;
     }
-    if (type === "Related") {
+    if (column.type === "Related") {
       result[column.name] = values.find((val) => getItemId(val) === getItemId(item[column.name])) || item[column.name];
     } else {
-      const existingValues = ((_a = item[column.name]) == null ? void 0 : _a.map((item2) => getItemId(item2) || item2)) || [];
+      const existingValues = ((_a = item[column.name]) == null ? void 0 : _a.map((entry) => getItemId(entry) || entry)) || [];
       result[column.name] = values.filter((val) => existingValues.includes(getItemId(val))).map(getItemId);
     }
   });

package/dist/core/esm/hooks/api/useBulkActions.mjs

@@ -1,5 +1,8 @@
 import { useBulkActionsProvider } from "../../Wrappers/ApiProvider/Contexts/BulkActionsContext.mjs";
-const useBulkActions = (options) => useBulkActionsProvider(options);
+const useBulkActions = (options) => (
+  // #MUSTASSERT the BulkActionsContext is created from an untyped createSafeContext, so the provider hook returns unknown
+  useBulkActionsProvider(options)
+);
 export {
   useBulkActions
 };

package/dist/core/esm/hooks/api/useForms.mjs

@@ -1,5 +1,5 @@
 import { useFormDeleteProvider, useFormEditProvider, useFormAddProvider, useFormViewProvider } from "../../Wrappers/ApiProvider/Contexts/FormContext.mjs";
-const useForms = (type, options) => {
+function useForms(type, options) {
   switch (type) {
     case "view":
       return useFormViewProvider(options);
@@ -12,7 +12,7 @@ const useForms = (type, options) => {
     default:
       throw new Error(`useForms: Unknown form type '${type}'. Expected 'view', 'add', 'edit', or 'delete'.`);
   }
-};
+}
 export {
   useForms
 };

package/dist/core/esm/hooks/auth/useAuth.mjs

@@ -1,5 +1,8 @@
 import { useAuthProvider } from "../../Wrappers/Provider/Contexts/AuthContext.mjs";
-const useAuth = (options) => useAuthProvider(options);
+const useAuth = (options) => (
+  // #MUSTASSERT the AuthContext is created from an untyped createSafeContext, so the provider hook returns unknown
+  useAuthProvider(options)
+);
 export {
   useAuth
 };