@fluixi/compiler 1.0.0-alpha.53

package/dist/integrations.d.ts

@@ -0,0 +1,251 @@
+/**
+ * @fileoverview Bundler integrations for the Fluixi compiler.
+ * @module @fluixi/compiler/integrations
+ *
+ * Build-tool adapters (vite/webpack/rollup/esbuild) plus the prop/template
+ * analysis helpers that drive them. These wrap the babel front-end so a single
+ * package owns all compile-time code. @fluixi/core re-exports
+ * createVitePlugin from here.
+ *
+ * Helpers:
+ * - Detecting reactive expressions
+ * - Wrapping signals for optimal updates
+ * - Template optimization
+ * - Static vs dynamic prop detection
+ */
+export interface CompilerOptions {
+    /**
+     * Whether to use lit-html templates when possible
+     * @default true
+     */
+    useLitHTML?: boolean;
+    /**
+     * Whether to generate source maps
+     * @default false
+     */
+    sourceMaps?: boolean;
+    /**
+     * Whether to enable aggressive optimizations
+     * @default true
+     */
+    optimize?: boolean;
+    /**
+     * Whether to delegate events
+     * @default true
+     */
+    delegateEvents?: boolean;
+    /**
+     * Events to delegate (if delegateEvents is true)
+     * @default ['click', 'input', 'change', 'submit']
+     */
+    delegatedEvents?: string[];
+    /**
+     * Whether to generate dev-mode code with additional checks
+     * @default false
+     */
+    development?: boolean;
+    /**
+     * Custom pragma for JSX
+     * @default 'jsx'
+     */
+    pragma?: string;
+    /**
+     * Custom pragma fragment
+     * @default 'Fragment'
+     */
+    pragmaFrag?: string;
+    /**
+     * Module to import JSX runtime from
+     * @default '@fluixi/jsx'
+     */
+    importSource?: string;
+    /**
+     * Code-generation backend.
+     * - 'imperative': compile straight into @fluixi/dom runtime calls (default).
+     * - 'jsx': emit the automatic runtime jsx()/jsxs().
+     * @default 'imperative'
+     */
+    backend?: 'jsx' | 'imperative';
+    /**
+     * Imperative codegen path: 'inline' (plugin builds calls directly) or 'ir'
+     * (shared build-IR + backend emit() pipeline). Same output.
+     * @default 'inline'
+     */
+    codegen?: 'inline' | 'ir';
+    /**
+     * Module emitted runtime symbols are imported from in 'imperative' mode.
+     * @default '@fluixi/dom'
+     */
+    signalModule?: string;
+    /**
+     * Module control-flow components are imported from in 'imperative' mode.
+     * @default '@fluixi/dom'
+     */
+    controlFlowModule?: string;
+    /**
+     * Where reactive primitives (createMemo) are imported from in 'imperative' mode.
+     * @default '@fluixi/reactive/signal'
+     */
+    reactiveModule?: string;
+}
+export interface TransformResult {
+    code: string;
+    map?: any;
+    metadata?: TransformMetadata;
+}
+export interface TransformMetadata {
+    hasSignals: boolean;
+    hasStores: boolean;
+    hasLitHTML: boolean;
+    staticProps: Set<string>;
+    dynamicProps: Set<string>;
+    components: Set<string>;
+}
+export interface PropAnalysis {
+    name: string;
+    isStatic: boolean;
+    isReactive: boolean;
+    isEvent: boolean;
+    isRef: boolean;
+    isSpread: boolean;
+}
+/**
+ * Analyze a prop to determine if it's static or dynamic
+ */
+export declare function analyzeProp(name: string, value: any): PropAnalysis;
+/**
+ * Analyze all props on an element
+ */
+export declare function analyzeProps(props: Record<string, any>): Map<string, PropAnalysis>;
+/**
+ * Check if JSX should be compiled to lit-html template
+ */
+export declare function shouldUseLitTemplate(tag: string, props: Record<string, any>, children: any[]): boolean;
+/**
+ * Check if a value is a lit-html template
+ */
+export declare function isLitTemplate(value: any): boolean;
+/**
+ * Generate code for creating an element
+ */
+export declare function generateCreateElement(tag: string, props: Record<string, any>, children: any[], options?: CompilerOptions): string;
+/**
+ * Generate code for props object
+ */
+export declare function generatePropsCode(props: Record<string, any>, options?: CompilerOptions): string;
+/**
+ * Generate code for children
+ */
+export declare function generateChildrenCode(children: any[]): string;
+/**
+ * Generate lit-html template code
+ */
+export declare function generateLitHTMLTemplate(tag: string, props: Record<string, any>, children: any[], isSVG?: boolean): string;
+/**
+ * Optimize static content
+ */
+export declare function optimizeStatic(code: string): string;
+/**
+ * Optimize prop spreads
+ */
+export declare function optimizeSpreads(code: string): string;
+/**
+ * Hoist static elements
+ */
+export declare function hoistStatic(code: string): string;
+/**
+ * Generate event delegation setup
+ */
+export declare function generateEventDelegation(events: string[], options?: CompilerOptions): string;
+/**
+ * Transform JSX code with optimizations
+ */
+export declare function transform(code: string, options?: CompilerOptions): TransformResult;
+/**
+ * Helper for creating a Babel plugin
+ */
+export declare function createBabelPlugin(options?: CompilerOptions): Promise<{
+    name: string;
+    plugin: ((api: object, options: import("./frontend/babel/plugin.js").PluginOptions | null | undefined, dirname: string) => import("@babel/core").PluginObj<import("@babel/core").PluginPass>) | null;
+    getOptions(): {
+        reactiveModule?: string | undefined;
+        controlFlowModule?: string | undefined;
+        signalModule?: string | undefined;
+        codegen?: "inline" | "ir" | undefined;
+        runtime: string;
+        importSource: string;
+        pragma: string;
+        pragmaFrag: string;
+        development: boolean;
+        detectReactivity: boolean;
+        useLitHTML: boolean;
+        hoistStatics: boolean;
+        delegateEvents: boolean;
+        delegatedEvents: string[];
+        optimizeControlFlow: boolean;
+        sourceMaps: boolean;
+        backend: "imperative" | "jsx";
+    };
+}>;
+/**
+ * Helper for creating a TypeScript transformer
+ */
+export declare function createTypeScriptTransformer(options?: CompilerOptions): (context: any) => (sourceFile: any) => any;
+/**
+ * Create a Vite plugin for JSX transformation
+ */
+export declare function createVitePlugin<T>(options?: CompilerOptions): T;
+/**
+ * Create a Webpack loader for JSX transformation
+ */
+export declare function createWebpackLoader(options?: CompilerOptions): (this: any, source: string) => Promise<void>;
+/**
+ * Create a Rollup plugin for JSX transformation
+ */
+export declare function createRollupPlugin(options?: CompilerOptions): {
+    name: string;
+    transform(code: string, id: string): Promise<{
+        code: any;
+        map: any;
+    } | null>;
+};
+/**
+ * Create an ESBuild plugin for JSX transformation
+ */
+export declare function createESBuildPlugin(options?: CompilerOptions): {
+    name: string;
+    setup(build: any): void;
+};
+export { transformServerFunctions } from './frontend/babel/server-functions.js';
+/**
+ * Vite plugin for `"use server"`: applies the transform (client→RPC stub, server→register
+ * the body), and provides `virtual:fluixi-server-fns` — side-effect imports of every
+ * module that defines a server function. The server entry imports it so ALL server
+ * functions register at startup (including those in lazy routes, which would otherwise
+ * register only when their chunk loads → an RPC registry miss). The client never imports
+ * it. `enforce:'pre'` so it runs on the raw source before other transforms.
+ */
+export declare function serverFunctionsVitePlugin<T = any>(): T;
+declare const _default: {
+    analyzeProp: typeof analyzeProp;
+    analyzeProps: typeof analyzeProps;
+    shouldUseLitTemplate: typeof shouldUseLitTemplate;
+    isLitTemplate: typeof isLitTemplate;
+    generateCreateElement: typeof generateCreateElement;
+    generatePropsCode: typeof generatePropsCode;
+    generateChildrenCode: typeof generateChildrenCode;
+    generateLitHTMLTemplate: typeof generateLitHTMLTemplate;
+    optimizeStatic: typeof optimizeStatic;
+    optimizeSpreads: typeof optimizeSpreads;
+    hoistStatic: typeof hoistStatic;
+    generateEventDelegation: typeof generateEventDelegation;
+    transform: typeof transform;
+    createBabelPlugin: typeof createBabelPlugin;
+    createTypeScriptTransformer: typeof createTypeScriptTransformer;
+    createVitePlugin: typeof createVitePlugin;
+    createWebpackLoader: typeof createWebpackLoader;
+    createRollupPlugin: typeof createRollupPlugin;
+    createESBuildPlugin: typeof createESBuildPlugin;
+};
+export default _default;
+//# sourceMappingURL=integrations.d.ts.map

package/dist/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../src/integrations.ts"],"names":[],"mappings":"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"}