@fluixi/compiler 1.0.0-alpha.83 → 1.0.0-alpha.84

package/dist/frontend/babel/plugin.d.cts

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview Babel front-end for the Fluixi compiler.
+ * @module @fluixi/babel-plugin-jsx
+ *
+ * This is a host adapter, not the compiler. It parses with babel and, for each
+ * JSX element/fragment and each `` html`...` `` template, hands the node to the
+ * shared pipeline — build IR, run the imperative backend — then splices the
+ * emitted code back into the program. Everything that decides *what* the output
+ * means (directives, control flow, component resolution, load strategies,
+ * reactivity, templates) lives in ../../{ir,resolve,optimize,codegen}, which
+ * import no babel at all.
+ *
+ * What stays here is genuinely host work: dispatching the visitors, collecting
+ * the runtime symbols the backend reported so the imports can be injected, and
+ * hoisting static templates to module scope.
+ */
+import { type ComponentResolverRule } from '../../resolve/component-resolver.cjs';
+import { type PluginObj } from '@babel/core';
+export interface PluginOptions {
+    /**
+     * Import source for the JSX types and for whatever JSX this plugin does not
+     * consume — esbuild's automatic runtime and TypeScript's `jsxImportSource`
+     * both point at it. The compiler itself never emits `jsx()` calls.
+     * @default '@fluixi/jsx'
+     */
+    importSource?: string;
+    /**
+     * Enable development mode with additional checks
+     * @default false
+     */
+    development?: boolean;
+    /**
+     * Enable event delegation
+     * @default true
+     */
+    delegateEvents?: boolean;
+    /**
+     * Generate source maps
+     * @default true
+     */
+    sourceMaps?: boolean;
+    /**
+     * Module name for signal directive
+     * @default '@fluixi/dom'
+     */
+    signalModule?: string;
+    /**
+     * Module name for control flow
+     * @default '@fluixi/dom'
+     */
+    controlFlowModule?: string;
+    /**
+     * Module the router components (Router/Outlet/…) are auto-imported from.
+     * @default '@fluixi/core/router'
+     */
+    routerModule?: string;
+    /** Clone static subtrees from a template. Client-only — see CompilerOptions. */
+    templateClone?: boolean;
+    /** Also clone structure-static subtrees with holes. See CompilerOptions. */
+    partialTemplates?: boolean;
+    /**
+     * Rules that resolve an unbound capitalised tag to a module, so a component can be
+     * used without an import — the configurable form of the built-in
+     * Suspense/Portal/Router auto-import.
+     *
+     * A lexical binding always wins, so an explicit import or a local variable is never
+     * overridden. With no rules, behaviour is exactly as before.
+     */
+    resolve?: readonly ComponentResolverRule[];
+    /**
+     * Where reactive primitives (createMemo) are imported from — the signal core,
+     * not the dom runtime.
+     * @default '@fluixi/reactive/signal'
+     */
+    reactiveModule?: string;
+    /**
+     * Which authoring syntaxes to compile:
+     * - 'jsx': only JSX elements/fragments.
+     * - 'lit': only `` html`...` `` / `` svg`...` `` tagged templates.
+     * - 'both' (default): JSX and `html``` templates in the same file.
+     *
+     * Both syntaxes lower to the same IR and the same imperative backend, so the
+     * choice is about which source forms the plugin touches, not about output.
+     * @default 'both'
+     */
+    format?: 'jsx' | 'lit' | 'both';
+    /**
+     * Tag name that marks a lit template for compilation (when `format` includes
+     * lit). Other tagged templates are left untouched.
+     * @default 'html'
+     */
+    litTag?: string;
+}
+declare const _default: (api: object, options: PluginOptions | null | undefined, dirname: string) => PluginObj<import("@babel/core").PluginPass>;
+export default _default;