@fictjs/compiler 0.2.2 → 0.2.3

package/dist/index.d.cts

@@ -7,10 +7,22 @@ interface CompilerWarning {
     line: number;
     column: number;
 }
+type ReactiveExportKind = 'signal' | 'memo' | 'store';
+interface HookReturnInfoSerializable {
+    objectProps?: Record<string, 'signal' | 'memo'>;
+    arrayProps?: Record<string, 'signal' | 'memo'>;
+    directAccessor?: 'signal' | 'memo';
+}
+interface ModuleReactiveMetadata {
+    exports: Record<string, ReactiveExportKind>;
+    hooks?: Record<string, HookReturnInfoSerializable>;
+}
 interface FictCompilerOptions {
     dev?: boolean;
     sourcemap?: boolean;
     onWarn?: (warning: CompilerWarning) => void;
+    /** Internal: filename of the module being compiled. */
+    filename?: string;
     /** Enable lazy evaluation of conditional derived values (Rule J optimization) */
     lazyConditional?: boolean;
     /** Enable getter caching within the same sync block (Rule L optimization) */
@@ -19,8 +31,32 @@ interface FictCompilerOptions {
     fineGrainedDom?: boolean;
     /** Enable HIR optimization passes (DCE/const-fold/CSE) */
     optimize?: boolean;
+    /**
+     * Optimization safety level.
+     * - 'safe': avoid non-constant algebraic rewrites to preserve JS semantics.
+     * - 'full': allow algebraic simplifications beyond constant folding.
+     */
+    optimizeLevel?: 'safe' | 'full';
     /** Allow inlining single-use derived values even when user-named */
     inlineDerivedMemos?: boolean;
+    /**
+     * Treat warnings as errors. Use true for all warnings, or provide a list of codes.
+     */
+    warningsAsErrors?: boolean | string[];
+    /**
+     * Per-warning override. "off" suppresses, "error" throws, "warn" emits.
+     */
+    warningLevels?: Record<string, 'off' | 'warn' | 'error'>;
+    /**
+     * Optional shared module metadata map for cross-module reactive imports.
+     * If omitted, the compiler uses a process-wide cache.
+     */
+    moduleMetadata?: Map<string, ModuleReactiveMetadata>;
+    /**
+     * Optional hook to resolve module metadata for a given import source.
+     * Tooling can override the default resolution strategy.
+     */
+    resolveModuleMetadata?: (source: string, importer?: string) => ModuleReactiveMetadata | null | undefined;
     /**
      * Optional TypeScript integration data provided by tooling (e.g., Vite plugin).
      * The compiler currently ignores this, but it enables future type-aware passes.
@@ -33,6 +69,10 @@ interface FictCompilerOptions {
     };
 }
 
+declare function resolveModuleMetadata(source: string, importer: string | undefined, options?: FictCompilerOptions): ModuleReactiveMetadata | undefined;
+declare function setModuleMetadata(fileName: string | undefined, metadata: ModuleReactiveMetadata, options?: FictCompilerOptions): void;
+declare function clearModuleMetadata(options?: FictCompilerOptions): void;
+
 declare const createFictPlugin: (api: object, options: FictCompilerOptions | null | undefined, dirname: string) => BabelCore.PluginObj<BabelCore.PluginPass>;
 
-export { type CompilerWarning, type FictCompilerOptions, createFictPlugin, createFictPlugin as default };
+export { type CompilerWarning, type FictCompilerOptions, type HookReturnInfoSerializable, type ModuleReactiveMetadata, type ReactiveExportKind, clearModuleMetadata, createFictPlugin, createFictPlugin as default, resolveModuleMetadata, setModuleMetadata };

package/dist/index.d.ts

@@ -7,10 +7,22 @@ interface CompilerWarning {
     line: number;
     column: number;
 }
+type ReactiveExportKind = 'signal' | 'memo' | 'store';
+interface HookReturnInfoSerializable {
+    objectProps?: Record<string, 'signal' | 'memo'>;
+    arrayProps?: Record<string, 'signal' | 'memo'>;
+    directAccessor?: 'signal' | 'memo';
+}
+interface ModuleReactiveMetadata {
+    exports: Record<string, ReactiveExportKind>;
+    hooks?: Record<string, HookReturnInfoSerializable>;
+}
 interface FictCompilerOptions {
     dev?: boolean;
     sourcemap?: boolean;
     onWarn?: (warning: CompilerWarning) => void;
+    /** Internal: filename of the module being compiled. */
+    filename?: string;
     /** Enable lazy evaluation of conditional derived values (Rule J optimization) */
     lazyConditional?: boolean;
     /** Enable getter caching within the same sync block (Rule L optimization) */
@@ -19,8 +31,32 @@ interface FictCompilerOptions {
     fineGrainedDom?: boolean;
     /** Enable HIR optimization passes (DCE/const-fold/CSE) */
     optimize?: boolean;
+    /**
+     * Optimization safety level.
+     * - 'safe': avoid non-constant algebraic rewrites to preserve JS semantics.
+     * - 'full': allow algebraic simplifications beyond constant folding.
+     */
+    optimizeLevel?: 'safe' | 'full';
     /** Allow inlining single-use derived values even when user-named */
     inlineDerivedMemos?: boolean;
+    /**
+     * Treat warnings as errors. Use true for all warnings, or provide a list of codes.
+     */
+    warningsAsErrors?: boolean | string[];
+    /**
+     * Per-warning override. "off" suppresses, "error" throws, "warn" emits.
+     */
+    warningLevels?: Record<string, 'off' | 'warn' | 'error'>;
+    /**
+     * Optional shared module metadata map for cross-module reactive imports.
+     * If omitted, the compiler uses a process-wide cache.
+     */
+    moduleMetadata?: Map<string, ModuleReactiveMetadata>;
+    /**
+     * Optional hook to resolve module metadata for a given import source.
+     * Tooling can override the default resolution strategy.
+     */
+    resolveModuleMetadata?: (source: string, importer?: string) => ModuleReactiveMetadata | null | undefined;
     /**
      * Optional TypeScript integration data provided by tooling (e.g., Vite plugin).
      * The compiler currently ignores this, but it enables future type-aware passes.
@@ -33,6 +69,10 @@ interface FictCompilerOptions {
     };
 }
 
+declare function resolveModuleMetadata(source: string, importer: string | undefined, options?: FictCompilerOptions): ModuleReactiveMetadata | undefined;
+declare function setModuleMetadata(fileName: string | undefined, metadata: ModuleReactiveMetadata, options?: FictCompilerOptions): void;
+declare function clearModuleMetadata(options?: FictCompilerOptions): void;
+
 declare const createFictPlugin: (api: object, options: FictCompilerOptions | null | undefined, dirname: string) => BabelCore.PluginObj<BabelCore.PluginPass>;
 
-export { type CompilerWarning, type FictCompilerOptions, createFictPlugin, createFictPlugin as default };
+export { type CompilerWarning, type FictCompilerOptions, type HookReturnInfoSerializable, type ModuleReactiveMetadata, type ReactiveExportKind, clearModuleMetadata, createFictPlugin, createFictPlugin as default, resolveModuleMetadata, setModuleMetadata };