@lark.js/mvc 0.0.9 → 0.0.11

package/dist/rspack.d.cts

@@ -0,0 +1,122 @@
+import { RspackPluginInstance, Compiler } from '@rspack/core';
+
+/**
+ * @lark.js/mvc Rspack Integration for Template Compilation
+ *
+ * Provides two integration modes:
+ *
+ * 1. **Loader** (larkMvcLoader) — Direct file transformation
+ *    - Transforms .html files into JS function modules
+ *    - Requires manual rspack.config.ts setup
+ *
+ * 2. **Plugin** (LarkMvcPlugin) — Auto-registers the loader
+ *    - Automatically configures the loader rule for .html files
+ *    - Zero-config: just add the plugin to your rspack config
+ *    - Recommended approach for most use cases
+ *
+ * Features:
+ * - All template operators: = (escape), ! (raw), @ (ref lookup), : (binding)
+ * - @event attribute processing with $g prefix
+ * - $encUri (URI encoding), $encQuote (quote encoding), $refFn (reference lookup)
+ * - Debug mode with line tracking
+ * - View ID injection
+ * - Auto variable extraction via AST analysis (Babel or SWC)
+ * - Virtual DOM support (optional)
+ *
+ * Usage with Plugin (recommended):
+ * ```js
+ * import { LarkMvcPlugin } from '@lark.js/mvc/rspack';
+ *
+ * export default {
+ *   plugins: [
+ *     new LarkMvcPlugin({
+ *       debug: process.env.NODE_ENV !== 'production',
+ *       virtualDom: false,
+ *       useSwc: false,
+ *     }),
+ *   ],
+ * };
+ * ```
+ *
+ * Usage with Loader (manual):
+ * ```js
+ * export default {
+ *   module: {
+ *     rules: [{
+ *       test: /\.html$/,
+ *       loader: '@lark.js/mvc/rspack',
+ *       options: { debug: false, virtualDom: false, useSwc: false },
+ *     }],
+ *   },
+ * };
+ * ```
+ */
+
+/** Rspack loader context */
+interface LoaderContext {
+    /** 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;
+}
+/**
+ * Rspack loader entry point.
+ * Compiles .html template files into JS function modules.
+ *
+ * Unlike the webpack version, rspack async loaders must return the result
+ * directly rather than calling `this.callback()`. Calling callback() inside
+ * an async function causes "callback already called" errors because the
+ * resolved promise also signals completion.
+ */
+declare function larkMvcLoader(this: LoaderContext, source: string): Promise<string>;
+/**
+ * Rspack 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/rspack';
+ *
+ * export default {
+ *   plugins: [
+ *     new LarkMvcPlugin({
+ *       debug: true,
+ *       virtualDom: false,
+ *       useSwc: false,
+ *     }),
+ *   ],
+ * };
+ * ```
+ */
+declare class LarkMvcPlugin implements RspackPluginInstance {
+    private options;
+    constructor(options?: LarkMvcPluginOptions);
+    /**
+     * Rspack plugin entry point.
+     * Called by rspack when the plugin is applied.
+     */
+    apply(compiler: Compiler): void;
+}
+
+export { LarkMvcPlugin, larkMvcLoader as default, larkMvcLoader };

package/dist/rspack.d.ts

@@ -0,0 +1,122 @@
+import { RspackPluginInstance, Compiler } from '@rspack/core';
+
+/**
+ * @lark.js/mvc Rspack Integration for Template Compilation
+ *
+ * Provides two integration modes:
+ *
+ * 1. **Loader** (larkMvcLoader) — Direct file transformation
+ *    - Transforms .html files into JS function modules
+ *    - Requires manual rspack.config.ts setup
+ *
+ * 2. **Plugin** (LarkMvcPlugin) — Auto-registers the loader
+ *    - Automatically configures the loader rule for .html files
+ *    - Zero-config: just add the plugin to your rspack config
+ *    - Recommended approach for most use cases
+ *
+ * Features:
+ * - All template operators: = (escape), ! (raw), @ (ref lookup), : (binding)
+ * - @event attribute processing with $g prefix
+ * - $encUri (URI encoding), $encQuote (quote encoding), $refFn (reference lookup)
+ * - Debug mode with line tracking
+ * - View ID injection
+ * - Auto variable extraction via AST analysis (Babel or SWC)
+ * - Virtual DOM support (optional)
+ *
+ * Usage with Plugin (recommended):
+ * ```js
+ * import { LarkMvcPlugin } from '@lark.js/mvc/rspack';
+ *
+ * export default {
+ *   plugins: [
+ *     new LarkMvcPlugin({
+ *       debug: process.env.NODE_ENV !== 'production',
+ *       virtualDom: false,
+ *       useSwc: false,
+ *     }),
+ *   ],
+ * };
+ * ```
+ *
+ * Usage with Loader (manual):
+ * ```js
+ * export default {
+ *   module: {
+ *     rules: [{
+ *       test: /\.html$/,
+ *       loader: '@lark.js/mvc/rspack',
+ *       options: { debug: false, virtualDom: false, useSwc: false },
+ *     }],
+ *   },
+ * };
+ * ```
+ */
+
+/** Rspack loader context */
+interface LoaderContext {
+    /** 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;
+}
+/**
+ * Rspack loader entry point.
+ * Compiles .html template files into JS function modules.
+ *
+ * Unlike the webpack version, rspack async loaders must return the result
+ * directly rather than calling `this.callback()`. Calling callback() inside
+ * an async function causes "callback already called" errors because the
+ * resolved promise also signals completion.
+ */
+declare function larkMvcLoader(this: LoaderContext, source: string): Promise<string>;
+/**
+ * Rspack 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/rspack';
+ *
+ * export default {
+ *   plugins: [
+ *     new LarkMvcPlugin({
+ *       debug: true,
+ *       virtualDom: false,
+ *       useSwc: false,
+ *     }),
+ *   ],
+ * };
+ * ```
+ */
+declare class LarkMvcPlugin implements RspackPluginInstance {
+    private options;
+    constructor(options?: LarkMvcPluginOptions);
+    /**
+     * Rspack plugin entry point.
+     * Called by rspack when the plugin is applied.
+     */
+    apply(compiler: Compiler): void;
+}
+
+export { LarkMvcPlugin, larkMvcLoader as default, larkMvcLoader };