@lark.js/mvc 0.0.9 → 0.0.11

package/dist/webpack.d.cts

@@ -1,18 +1,74 @@
 /** Webpack loader context */
 interface LoaderContext {
-    /** Callback to return the result */
-    callback: (error: Error | null, result?: string) => void;
     /** Whether in development mode */
     dev?: boolean;
     /** Loader options */
     getOptions: () => {
         debug?: boolean;
+        virtualDom?: boolean;
+        useSwc?: boolean;
     };
 }
+/** Plugin options */
+interface LarkMvcPluginOptions {
+    /** Enable debug mode with line tracking (default: false) */
+    debug?: boolean;
+    /** Enable virtual DOM output (default: false) */
+    virtualDom?: boolean;
+    /** Use SWC instead of Babel for AST analysis (default: false) */
+    useSwc?: boolean;
+    /** File extension to match (default: /\.html$/) */
+    test?: RegExp;
+    /** Exclude pattern (default: /node_modules/) */
+    exclude?: RegExp;
+}
 /**
  * Webpack loader entry point.
  * Compiles .html template files into JS function modules.
+ *
+ * Uses this.callback() for async result delivery — this is the standard
+ * webpack pattern for async loaders. Unlike rspack, webpack 5 does not
+ * reliably support returning a Promise from the loader function; the
+ * callback approach works across all webpack 5.x versions.
+ */
+declare function larkMvcLoader(this: LoaderContext, source: string): Promise<string>;
+/**
+ * Webpack plugin that auto-registers the lark-mvc loader.
+ *
+ * This is the recommended integration approach. The plugin:
+ * 1. Automatically adds a loader rule for .html files
+ * 2. Passes through all configuration options
+ * 3. Handles edge cases (e.g., excluding node_modules)
+ *
+ * Usage:
+ * ```js
+ * import { LarkMvcPlugin } from '@lark.js/mvc/webpack';
+ *
+ * export default {
+ *   plugins: [
+ *     new LarkMvcPlugin({
+ *       debug: true,
+ *       virtualDom: false,
+ *       useSwc: false,
+ *     }),
+ *   ],
+ * };
+ * ```
  */
-declare function larkMvcLoader(this: LoaderContext, source: string): void;
+declare class LarkMvcPlugin {
+    private options;
+    constructor(options?: LarkMvcPluginOptions);
+    /**
+     * Webpack plugin entry point.
+     * Called by webpack when the plugin is applied.
+     */
+    apply(compiler: {
+        options: {
+            module: {
+                rules: unknown[];
+            };
+        };
+    }): void;
+}
 
-export { larkMvcLoader as default, larkMvcLoader };
+export { LarkMvcPlugin, larkMvcLoader as default, larkMvcLoader };

package/dist/webpack.d.ts

@@ -1,18 +1,74 @@
 /** Webpack loader context */
 interface LoaderContext {
-    /** Callback to return the result */
-    callback: (error: Error | null, result?: string) => void;
     /** Whether in development mode */
     dev?: boolean;
     /** Loader options */
     getOptions: () => {
         debug?: boolean;
+        virtualDom?: boolean;
+        useSwc?: boolean;
     };
 }
+/** Plugin options */
+interface LarkMvcPluginOptions {
+    /** Enable debug mode with line tracking (default: false) */
+    debug?: boolean;
+    /** Enable virtual DOM output (default: false) */
+    virtualDom?: boolean;
+    /** Use SWC instead of Babel for AST analysis (default: false) */
+    useSwc?: boolean;
+    /** File extension to match (default: /\.html$/) */
+    test?: RegExp;
+    /** Exclude pattern (default: /node_modules/) */
+    exclude?: RegExp;
+}
 /**
  * Webpack loader entry point.
  * Compiles .html template files into JS function modules.
+ *
+ * Uses this.callback() for async result delivery — this is the standard
+ * webpack pattern for async loaders. Unlike rspack, webpack 5 does not
+ * reliably support returning a Promise from the loader function; the
+ * callback approach works across all webpack 5.x versions.
+ */
+declare function larkMvcLoader(this: LoaderContext, source: string): Promise<string>;
+/**
+ * Webpack plugin that auto-registers the lark-mvc loader.
+ *
+ * This is the recommended integration approach. The plugin:
+ * 1. Automatically adds a loader rule for .html files
+ * 2. Passes through all configuration options
+ * 3. Handles edge cases (e.g., excluding node_modules)
+ *
+ * Usage:
+ * ```js
+ * import { LarkMvcPlugin } from '@lark.js/mvc/webpack';
+ *
+ * export default {
+ *   plugins: [
+ *     new LarkMvcPlugin({
+ *       debug: true,
+ *       virtualDom: false,
+ *       useSwc: false,
+ *     }),
+ *   ],
+ * };
+ * ```
  */
-declare function larkMvcLoader(this: LoaderContext, source: string): void;
+declare class LarkMvcPlugin {
+    private options;
+    constructor(options?: LarkMvcPluginOptions);
+    /**
+     * Webpack plugin entry point.
+     * Called by webpack when the plugin is applied.
+     */
+    apply(compiler: {
+        options: {
+            module: {
+                rules: unknown[];
+            };
+        };
+    }): void;
+}
 
-export { larkMvcLoader as default, larkMvcLoader };
+export { LarkMvcPlugin, larkMvcLoader as default, larkMvcLoader };