@styleframe/loader 2.4.1 → 3.0.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { Jiti } from 'jiti';
 import { Styleframe } from '@styleframe/core';
 import { TranspileOptions } from '@styleframe/transpiler';
 
@@ -9,13 +10,87 @@ export declare type BuildOptions = {
     transpiler?: TranspileOptions;
 };
 
+/**
+ * Create a jiti instance with standard configuration.
+ *
+ * @param basePath - Directory to resolve imports from
+ * @param alias - Optional alias configuration for virtual modules
+ */
+export declare function createLoader(basePath: string, alias?: Record<string, string>): Jiti;
+
 export declare function directoryExists(path: string): Promise<boolean>;
 
+/**
+ * Export information for a recipe or selector
+ */
+export declare interface ExportInfo {
+    /** Export name (e.g., "buttonRecipe") */
+    name: string;
+    /** Type of export */
+    type: "recipe" | "selector";
+}
+
 export declare function loadConfiguration({ cwd, entry, }?: {
     cwd?: string;
     entry?: string;
 }): Promise<Styleframe>;
 
+/**
+ * Load a module without validating the default export.
+ * Useful for extension files that may not have a default export.
+ *
+ * @param filePath - Absolute path to the module file
+ * @param options - Loading options (without validateInstance)
+ */
+export declare function loadExtensionModule(filePath: string, options?: Omit<LoadModuleOptions, "validateInstance">): Promise<LoadExtensionModuleResult>;
+
+/**
+ * Result of loading an extension module (no instance validation)
+ */
+export declare interface LoadExtensionModuleResult {
+    /** The raw module exports */
+    module: Record<string, unknown>;
+    /** Tracked exports (recipes and selectors with _exportName set) */
+    exports: Map<string, ExportInfo>;
+}
+
+/**
+ * Load a TypeScript/JavaScript module using jiti.
+ * Tracks _exportName on recipes/selectors and validates the default export.
+ *
+ * @param filePath - Absolute path to the module file
+ * @param options - Loading options
+ */
+export declare function loadModule(filePath: string, options?: LoadModuleOptions): Promise<LoadModuleResult>;
+
+/**
+ * Options for loading a module with jiti
+ */
+export declare interface LoadModuleOptions {
+    /** jiti alias configuration (e.g., for virtual modules) */
+    alias?: Record<string, string>;
+    /** Whether to validate that default export is a Styleframe instance (default: true) */
+    validateInstance?: boolean;
+}
+
+/**
+ * Result of loading a module
+ */
+export declare interface LoadModuleResult {
+    /** The raw module exports */
+    module: Record<string, unknown>;
+    /** The default export (Styleframe instance) */
+    instance: Styleframe;
+    /** Tracked exports (recipes and selectors with _exportName set) */
+    exports: Map<string, ExportInfo>;
+}
+
+/**
+ * Track _exportName on recipes and selectors in a module.
+ * Returns a map of export info for recipes and selectors.
+ */
+export declare function trackExports(module: Record<string, unknown>): Map<string, ExportInfo>;
+
 export declare function watchConfiguration({ cwd, entry, onUpdate, onError, }?: {
     cwd?: string;
     entry?: string;