@donotdev/core 0.0.12 → 0.0.14

package/vite/index.d.ts

@@ -759,160 +759,6 @@ declare global {
   }
 }
 
-type $MergeBy<T, K> = Omit<T, keyof K> & K;
-
-type $PreservedValue<Value, Fallback> = [Value] extends [never] ? Fallback : Value;
-
-/**
- * This interface can be augmented by users to add types to `i18next` default TypeOptions.
- *
- * Usage:
- * ```ts
- * // i18next.d.ts
- * import 'i18next';
- * declare module 'i18next' {
- *   interface CustomTypeOptions {
- *     defaultNS: 'custom';
- *     returnNull: false;
- *     returnObjects: false;
- *     nsSeparator: ':';
- *     keySeparator: '.';
- *     compatibilityJSON: 'v4';
- *     allowObjectInHTMLChildren: false;
- *     resources: {
- *       custom: {
- *         foo: 'foo';
- *       };
- *     };
- *   }
- * }
- * ```
- */
-interface CustomTypeOptions {}
-
-type TypeOptions = $MergeBy<
-  {
-    /** @see {InitOptions.returnNull} */
-    returnNull: false;
-
-    /** @see {InitOptions.returnEmptyString} */
-    returnEmptyString: true;
-
-    /** @see {InitOptions.returnObjects} */
-    returnObjects: false;
-
-    /** @see {InitOptions.keySeparator} */
-    keySeparator: '.';
-
-    /** @see {InitOptions.nsSeparator} */
-    nsSeparator: ':';
-
-    /** @see {InitOptions.pluralSeparator} */
-    pluralSeparator: '_';
-
-    /** @see {InitOptions.contextSeparator} */
-    contextSeparator: '_';
-
-    /** @see {InitOptions.defaultNS} */
-    defaultNS: 'translation';
-
-    /** @see {InitOptions.fallbackNS} */
-    fallbackNS: false;
-
-    /** @see {InitOptions.compatibilityJSON} */
-    compatibilityJSON: 'v4';
-
-    /** @see {InitOptions.resources} */
-    resources: object;
-
-    /**
-     * Flag that allows HTML elements to receive objects. This is only useful for React applications
-     * where you pass objects to HTML elements so they can be replaced to their respective interpolation
-     * values (mostly with Trans component)
-     */
-    allowObjectInHTMLChildren: false;
-
-    /**
-     * Flag that enables strict key checking even if a `defaultValue` has been provided.
-     * This ensures all calls of `t` function don't accidentally use implicitly missing keys.
-     */
-    strictKeyChecks: false;
-
-    /**
-     * Prefix for interpolation
-     */
-    interpolationPrefix: '{{';
-
-    /**
-     * Suffix for interpolation
-     */
-    interpolationSuffix: '}}';
-
-    /** @see {InterpolationOptions.unescapePrefix} */
-    unescapePrefix: '-';
-
-    /** @see {InterpolationOptions.unescapeSuffix} */
-    unescapeSuffix: '';
-
-    /**
-     * Use a proxy-based selector to select a translation.
-     *
-     * Enables features like go-to definition, and better DX/faster autocompletion
-     * for TypeScript developers.
-     *
-     * If you're working with an especially large set of translations and aren't
-     * using context, you set `enableSelector` to `"optimize"` and i18next won't do
-     * any type-level processing of your translations at all.
-     *
-     * With `enableSelector` set to `"optimize"`, i18next is capable of supporting
-     * arbitrarily large/deep translation sets without causing any IDE slowdown
-     * whatsoever.
-     *
-     * @default false
-     */
-    enableSelector: false;
-  },
-  CustomTypeOptions
->;
-
-type FlatNamespace = $PreservedValue<keyof TypeOptions['resources'], string>;
-type Namespace<T = FlatNamespace> = T | readonly T[];
-
-interface ReportNamespaces {
-  addUsedNamespaces(namespaces: Namespace): void;
-  getUsedNamespaces(): string[];
-}
-
-declare module 'i18next' {
-  // interface i18n {
-  //   reportNamespaces?: ReportNamespaces;
-  // }
-  interface CustomInstanceExtensions {
-    reportNamespaces?: ReportNamespaces;
-  }
-}
-
-type ObjectOrNever = TypeOptions['allowObjectInHTMLChildren'] extends true
-  ? Record<string, unknown>
-  : never;
-
-type ReactI18NextChildren = React.ReactNode | ObjectOrNever;
-
-declare module 'react' {
-  namespace JSX {
-    interface IntrinsicAttributes {
-      i18nIsDynamicList?: boolean;
-    }
-  }
-
-  interface HTMLAttributes<T> {
-    // This union is inspired by the typings for React.ReactNode. We do this to fix "This JSX tag's 'children' prop
-    // expects a single child of type 'ReactI18NextChildren', but multiple children were provided":
-    // https://github.com/DefinitelyTyped/DefinitelyTyped/blob/5a1e9f91ed0143adede394adb3f540e650455f71/types/react/index.d.ts#L268
-    children?: ReactI18NextChildren | Iterable<ReactI18NextChildren>;
-  }
-}
-
 // packages/core/types/src/layout/layoutTypes.ts
 
 
@@ -1226,6 +1072,59 @@ interface FeaturesConfig {
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
+/**
+ * Query cache configuration
+ *
+ * Configure default TanStack Query cache behavior for your app.
+ * These settings apply to all queries unless overridden per-query.
+ *
+ * **Framework Defaults (Infinite Cache):**
+ * - `staleTime: Infinity` (data never becomes stale)
+ * - `refetchOnWindowFocus: false` (manual refresh only)
+ * - `refetchOnReconnect: false` (manual refresh only)
+ *
+ * This default strategy minimizes API costs and is ideal for:
+ * - Single-admin apps
+ * - Apps with manual refresh buttons
+ * - Cost-optimized scenarios
+ *
+ * @example
+ * ```typescript
+ * // Use framework defaults (infinite cache, no auto-refetch)
+ * // No query config needed - defaults are optimal
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Override to short cache with auto-refetch
+ * query: {
+ *   staleTime: 1000 * 60 * 5,  // 5 minutes
+ *   refetchOnWindowFocus: true,
+ *   refetchOnReconnect: true,
+ * }
+ * ```
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+interface QueryConfig {
+  /** Time until data is considered stale (default: Infinity = never stale) */
+  staleTime?: number;
+  /** Time until inactive data is garbage collected (default: 30 minutes) */
+  gcTime?: number;
+  /** Number of retry attempts for failed queries (default: 1) */
+  retry?: number;
+  /** Whether to refetch when window regains focus (default: false = manual refresh only) */
+  refetchOnWindowFocus?: boolean;
+  /** Whether to refetch on reconnect (default: false = manual refresh only) */
+  refetchOnReconnect?: boolean;
+  /** Mutation retry attempts (default: 1) */
+  mutationRetry?: number;
+  /** Mutation retry delay function (default: exponential backoff) */
+  mutationRetryDelay?: (attemptIndex: number) => number;
+}
+
 interface AppConfig {
   /** App metadata and branding */
   app?: AppMetadata;
@@ -1239,6 +1138,162 @@ interface AppConfig {
   preset?: string;
   /** Feature flags */
   features?: FeaturesConfig;
+  /** Query cache configuration (defaults: 5min staleTime, refetch on focus/reconnect) */
+  query?: QueryConfig;
+}
+
+type $MergeBy<T, K> = Omit<T, keyof K> & K;
+
+type $PreservedValue<Value, Fallback> = [Value] extends [never] ? Fallback : Value;
+
+/**
+ * This interface can be augmented by users to add types to `i18next` default TypeOptions.
+ *
+ * Usage:
+ * ```ts
+ * // i18next.d.ts
+ * import 'i18next';
+ * declare module 'i18next' {
+ *   interface CustomTypeOptions {
+ *     defaultNS: 'custom';
+ *     returnNull: false;
+ *     returnObjects: false;
+ *     nsSeparator: ':';
+ *     keySeparator: '.';
+ *     compatibilityJSON: 'v4';
+ *     allowObjectInHTMLChildren: false;
+ *     resources: {
+ *       custom: {
+ *         foo: 'foo';
+ *       };
+ *     };
+ *   }
+ * }
+ * ```
+ */
+interface CustomTypeOptions {}
+
+type TypeOptions = $MergeBy<
+  {
+    /** @see {InitOptions.returnNull} */
+    returnNull: false;
+
+    /** @see {InitOptions.returnEmptyString} */
+    returnEmptyString: true;
+
+    /** @see {InitOptions.returnObjects} */
+    returnObjects: false;
+
+    /** @see {InitOptions.keySeparator} */
+    keySeparator: '.';
+
+    /** @see {InitOptions.nsSeparator} */
+    nsSeparator: ':';
+
+    /** @see {InitOptions.pluralSeparator} */
+    pluralSeparator: '_';
+
+    /** @see {InitOptions.contextSeparator} */
+    contextSeparator: '_';
+
+    /** @see {InitOptions.defaultNS} */
+    defaultNS: 'translation';
+
+    /** @see {InitOptions.fallbackNS} */
+    fallbackNS: false;
+
+    /** @see {InitOptions.compatibilityJSON} */
+    compatibilityJSON: 'v4';
+
+    /** @see {InitOptions.resources} */
+    resources: object;
+
+    /**
+     * Flag that allows HTML elements to receive objects. This is only useful for React applications
+     * where you pass objects to HTML elements so they can be replaced to their respective interpolation
+     * values (mostly with Trans component)
+     */
+    allowObjectInHTMLChildren: false;
+
+    /**
+     * Flag that enables strict key checking even if a `defaultValue` has been provided.
+     * This ensures all calls of `t` function don't accidentally use implicitly missing keys.
+     */
+    strictKeyChecks: false;
+
+    /**
+     * Prefix for interpolation
+     */
+    interpolationPrefix: '{{';
+
+    /**
+     * Suffix for interpolation
+     */
+    interpolationSuffix: '}}';
+
+    /** @see {InterpolationOptions.unescapePrefix} */
+    unescapePrefix: '-';
+
+    /** @see {InterpolationOptions.unescapeSuffix} */
+    unescapeSuffix: '';
+
+    /**
+     * Use a proxy-based selector to select a translation.
+     *
+     * Enables features like go-to definition, and better DX/faster autocompletion
+     * for TypeScript developers.
+     *
+     * If you're working with an especially large set of translations and aren't
+     * using context, you set `enableSelector` to `"optimize"` and i18next won't do
+     * any type-level processing of your translations at all.
+     *
+     * With `enableSelector` set to `"optimize"`, i18next is capable of supporting
+     * arbitrarily large/deep translation sets without causing any IDE slowdown
+     * whatsoever.
+     *
+     * @default false
+     */
+    enableSelector: false;
+  },
+  CustomTypeOptions
+>;
+
+type FlatNamespace = $PreservedValue<keyof TypeOptions['resources'], string>;
+type Namespace<T = FlatNamespace> = T | readonly T[];
+
+interface ReportNamespaces {
+  addUsedNamespaces(namespaces: Namespace): void;
+  getUsedNamespaces(): string[];
+}
+
+declare module 'i18next' {
+  // interface i18n {
+  //   reportNamespaces?: ReportNamespaces;
+  // }
+  interface CustomInstanceExtensions {
+    reportNamespaces?: ReportNamespaces;
+  }
+}
+
+type ObjectOrNever = TypeOptions['allowObjectInHTMLChildren'] extends true
+  ? Record<string, unknown>
+  : never;
+
+type ReactI18NextChildren = React.ReactNode | ObjectOrNever;
+
+declare module 'react' {
+  namespace JSX {
+    interface IntrinsicAttributes {
+      i18nIsDynamicList?: boolean;
+    }
+  }
+
+  interface HTMLAttributes<T> {
+    // This union is inspired by the typings for React.ReactNode. We do this to fix "This JSX tag's 'children' prop
+    // expects a single child of type 'ReactI18NextChildren', but multiple children were provided":
+    // https://github.com/DefinitelyTyped/DefinitelyTyped/blob/5a1e9f91ed0143adede394adb3f540e650455f71/types/react/index.d.ts#L268
+    children?: ReactI18NextChildren | Iterable<ReactI18NextChildren>;
+  }
 }
 
 // packages/core/config/index.d.ts