@styleframe/loader 3.0.0 → 3.0.1

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Jiti } from 'jiti';
+import { JitiOptions } from 'jiti';
 import { Styleframe } from '@styleframe/core';
 import { TranspileOptions } from '@styleframe/transpiler';
 
@@ -10,6 +11,21 @@ export declare type BuildOptions = {
     transpiler?: TranspileOptions;
 };
 
+/**
+ * Clears the entire jiti module cache.
+ * Useful for full rebuilds or when dependency graph is unclear.
+ */
+export declare function clearAllJitiCache(jiti: Jiti): void;
+
+/**
+ * Clears specific modules from the jiti cache.
+ * Call this when a file changes to ensure it's reloaded on next import.
+ *
+ * @param jiti - The jiti instance to clear cache from
+ * @param filePaths - Absolute paths of files to invalidate
+ */
+export declare function clearJitiCache(jiti: Jiti, ...filePaths: string[]): void;
+
 /**
  * Create a jiti instance with standard configuration.
  *
@@ -18,6 +34,25 @@ export declare type BuildOptions = {
  */
 export declare function createLoader(basePath: string, alias?: Record<string, string>): Jiti;
 
+/**
+ * Creates a shared jiti instance with module caching enabled.
+ * Use this when loading multiple styleframe config files to avoid
+ * re-compiling shared dependencies.
+ *
+ * @example
+ * ```ts
+ * const jiti = createSharedJiti();
+ *
+ * // Both loads will share cached modules
+ * const config1 = await loadConfigurationFromPath('./button.styleframe.ts', { jiti });
+ * const config2 = await loadConfigurationFromPath('./badge.styleframe.ts', { jiti });
+ *
+ * // Invalidate cache when files change (for HMR)
+ * clearJitiCache(jiti, './theme/useTokens.ts');
+ * ```
+ */
+export declare function createSharedJiti(options?: JitiOptions): Jiti;
+
 export declare function directoryExists(path: string): Promise<boolean>;
 
 /**
@@ -30,6 +65,10 @@ export declare interface ExportInfo {
     type: "recipe" | "selector";
 }
 
+export { Jiti }
+
+export { JitiOptions }
+
 export declare function loadConfiguration({ cwd, entry, }?: {
     cwd?: string;
     entry?: string;
@@ -71,6 +110,8 @@ export declare interface LoadModuleOptions {
     alias?: Record<string, string>;
     /** Whether to validate that default export is a Styleframe instance (default: true) */
     validateInstance?: boolean;
+    /** Optional shared jiti instance to reuse across multiple loads */
+    jiti?: Jiti;
 }
 
 /**