flint-compiler 4.0.0

package/README.md

@@ -0,0 +1,54 @@
+# @flint/compiler
+
+> The Flint JSX compiler — transforms JSX with auto-imports and optimizations
+
+## Install
+
+```bash
+npm install @flint/compiler
+```
+
+## Usage
+
+The compiler is typically used via the Vite plugin:
+
+```javascript
+// vite.config.js
+import { defineConfig } from 'vite'
+import flint from '@flint/vite-plugin'
+
+export default defineConfig({
+  plugins: [flint()]
+})
+```
+
+## Features
+
+- **Auto-imports** — no need to import `state`, `computed`, `effect`, `render`
+- **JSX transformation** — converts JSX to efficient DOM operations
+- **Optimizations** — dead code elimination, tree shaking
+- **Source maps** — full source map support for debugging
+- **TypeScript** — full TypeScript support
+
+## Manual Usage
+
+```typescript
+import { parse, transform, compile } from '@flint/compiler'
+
+const ast = parse('<div>Hello</div>')
+const transformed = transform(ast)
+const code = compile(transformed)
+```
+
+## Auto-Imported Symbols
+
+The following symbols are automatically available without importing:
+
+- `state`, `computed`, `effect`, `batch`
+- `render`, `h`, `Show`, `When`, `For`
+- `ref`, `onMount`, `onUpdate`, `onDestroy`
+- And more...
+
+## License
+
+MIT

package/dist/errors/index.d.ts

@@ -0,0 +1,34 @@
+export interface CompilerError {
+    message: string;
+    file?: string;
+    line?: number;
+    column?: number;
+    suggestion?: string;
+    /** The source line(s) of code where the error occurred */
+    sourceLine?: string;
+    /** Likely causes shown as a bullet list */
+    causes?: string[];
+    /** Raw technical detail (shown in verbose/advanced mode) */
+    raw?: string;
+}
+export declare function createCompilerError(message: string, options?: {
+    file?: string;
+    line?: number;
+    column?: number;
+    suggestion?: string;
+    raw?: string;
+}): CompilerError;
+/**
+ * Guess likely causes from a parse/transform error message.
+ * Ordered by commonality in real-world JSX projects.
+ */
+export declare function guessCauses(message: string): string[];
+/**
+ * Build a code frame: the offending source line with a caret at the column.
+ */
+export declare function codeFrame(source: string, line: number, column: number, context?: number): string;
+/**
+ * Format a compiler error for display to humans.
+ */
+export declare function formatCompilerError(error: CompilerError): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GACjG,aAAa,CAKf;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA4BrD;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,SAAI,GACV,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAkChE"}

package/dist/errors/index.js

@@ -0,0 +1,110 @@
+// Flint Compiler — Error Messages
+// Actionable, human-readable error messages with code frames
+//
+// Raw parser errors like "Unexpected token (12:4)" are useless to beginners.
+// Flint renders the offending line with a caret, the file, and likely causes
+// plus a fix — while keeping the raw detail available for advanced users.
+const ANSI = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    bold: '\x1b[1m',
+};
+function supportsColor() {
+    return (typeof process !== 'undefined' &&
+        process.stdout?.isTTY === true &&
+        process.env?.NO_COLOR === undefined);
+}
+function colorize(text, ...codes) {
+    if (!supportsColor())
+        return text;
+    return codes.join('') + text + ANSI.reset;
+}
+export function createCompilerError(message, options = {}) {
+    return {
+        message,
+        ...options,
+    };
+}
+/**
+ * Guess likely causes from a parse/transform error message.
+ * Ordered by commonality in real-world JSX projects.
+ */
+export function guessCauses(message) {
+    const causes = [];
+    const msg = message.toLowerCase();
+    if (msg.includes('unexpected token') || msg.includes('unexpected character')) {
+        causes.push('A tag, brace, or parenthesis is missing or mismatched', 'JSX is used inside a .js file that the tooling does not treat as JSX', 'An unclosed string or template literal earlier in the file');
+    }
+    else if (msg.includes('unexpected end') || msg.includes('unterminated')) {
+        causes.push('A tag, brace, or parenthesis opened earlier was never closed', 'A string or template literal is missing its closing quote/backtick');
+    }
+    else if (msg.includes('jsx')) {
+        causes.push('The file contains JSX but may not be recognized as a JSX file', 'Self-closing tags must be written as <Tag />, and every tag must be closed');
+    }
+    else if (msg.includes('reserved') || msg.includes('keyword')) {
+        causes.push('A reserved JavaScript keyword is used as a variable or prop name');
+    }
+    if (causes.length === 0) {
+        causes.push('The syntax near this position is not valid JavaScript/JSX');
+    }
+    return causes;
+}
+/**
+ * Build a code frame: the offending source line with a caret at the column.
+ */
+export function codeFrame(source, line, column, context = 1) {
+    const lines = source.split('\n');
+    const start = Math.max(0, line - 1 - context);
+    const end = Math.min(lines.length, line + context);
+    const gutterWidth = String(end).length;
+    const frames = [];
+    for (let i = start; i < end; i++) {
+        const num = i + 1;
+        const text = lines[i] ?? '';
+        const isCaret = num === line;
+        const gutter = String(num).padStart(gutterWidth, ' ');
+        const prefix = isCaret ? colorize('>', ANSI.red, ANSI.bold) : ' ';
+        frames.push(`${prefix} ${colorize(gutter + ' │', ANSI.gray)} ${text}`);
+        if (isCaret && column >= 0) {
+            const caretPad = ' '.repeat(Math.min(column, text.length));
+            frames.push(`  ${colorize(gutter + ' │', ANSI.gray)} ${colorize(caretPad + '^', ANSI.red, ANSI.bold)}`);
+        }
+    }
+    return frames.join('\n');
+}
+/**
+ * Format a compiler error for display to humans.
+ */
+export function formatCompilerError(error) {
+    let output = `\n${colorize('❌ ' + error.message, ANSI.red, ANSI.bold)}`;
+    if (error.file || error.line !== undefined) {
+        const where = [
+            error.file,
+            error.line !== undefined ? `${error.line}${error.column !== undefined ? ':' + error.column : ''}` : undefined,
+        ]
+            .filter(Boolean)
+            .join(', ');
+        output += `\n\n${colorize('📄 ' + where, ANSI.cyan)}`;
+    }
+    if (error.sourceLine && error.line !== undefined) {
+        output += `\n\n${codeFrame(error.sourceLine, error.line, error.column ?? 0)}`;
+    }
+    if (error.causes && error.causes.length > 0) {
+        output += `\n\n${colorize('Kemungkinan penyebab / Likely causes:', ANSI.bold)}`;
+        for (const cause of error.causes) {
+            output += `\n  • ${cause}`;
+        }
+    }
+    if (error.suggestion) {
+        output += `\n\n${colorize('💡 ' + error.suggestion, ANSI.yellow)}`;
+    }
+    if (error.raw) {
+        output += `\n\n${colorize('── technical detail ' + '─'.repeat(40), ANSI.gray)}\n${colorize(error.raw, ANSI.gray)}`;
+    }
+    output += '\n';
+    return output;
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+export { parse } from './parser/index.js';
+export { transform } from './transformer/index.js';
+export { createCompilerError, formatCompilerError, guessCauses, codeFrame, } from './errors/index.js';
+export type { CompilerError } from './errors/index.js';
+export type { ParseOptions, ParseResult } from './parser/index.js';
+export type { TransformOptions, TransformResult } from './transformer/index.js';
+/** Shape of the failure object returned by compile() on error. */
+export interface CompileFailure {
+    code: string;
+    error: Error;
+    /** Formatted, human-friendly report ready to print (code frame + causes) */
+    formatted?: string;
+    line?: number;
+    column?: number;
+}
+/**
+ * Compile JSX/JavaScript source code into Flint runtime calls.
+ *
+ * On failure, returns the original code plus a richly formatted error:
+ * file, line:column, a caret code frame, likely causes, and a suggestion —
+ * while the raw error stays available for tooling.
+ */
+export declare function compile(code: string, options?: {
+    filename?: string;
+    dev?: boolean;
+    sourceType?: 'module' | 'script';
+}): {
+    code: string;
+    error?: Error;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,SAAS,GACV,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAClE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE/E,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,KAAK,CAAA;IACZ,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAkBD;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAC5B,GACL;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAsCjC"}

package/dist/index.js

@@ -0,0 +1,61 @@
+// Flint Compiler — Main Entry Point
+import { parse as doParse } from './parser/index.js';
+import { transform as doTransform } from './transformer/index.js';
+import { createCompilerError, formatCompilerError, guessCauses, } from './errors/index.js';
+export { parse } from './parser/index.js';
+export { transform } from './transformer/index.js';
+export { createCompilerError, formatCompilerError, guessCauses, codeFrame, } from './errors/index.js';
+/**
+ * Extract line/column from an acorn-style error message ("(12:4)") and
+ * grab the offending source line for the code frame.
+ */
+function locateError(err, code) {
+    const message = err instanceof Error ? err.message : String(err);
+    const match = /\((\d+):(\d+)\)\s*$/.exec(message.trim());
+    if (!match)
+        return {};
+    const line = parseInt(match[1], 10);
+    const column = parseInt(match[2], 10);
+    const lines = code.split('\n');
+    const sourceLine = line >= 1 && line <= lines.length ? lines[line - 1] : undefined;
+    return { line, column, sourceLine };
+}
+/**
+ * Compile JSX/JavaScript source code into Flint runtime calls.
+ *
+ * On failure, returns the original code plus a richly formatted error:
+ * file, line:column, a caret code frame, likely causes, and a suggestion —
+ * while the raw error stays available for tooling.
+ */
+export function compile(code, options = {}) {
+    try {
+        const { ast } = doParse(code, {
+            sourceType: options.sourceType,
+            filename: options.filename,
+        });
+        const result = doTransform(ast, code, {
+            filename: options.filename,
+            dev: options.dev,
+        });
+        return { code: result.code };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        const { line, column, sourceLine } = locateError(error, code);
+        const compilerError = createCompilerError('Could not compile this file', {
+            file: options.filename,
+            line,
+            column,
+            suggestion: 'Fix the syntax at the marked position, then save the file again.',
+            raw: `${error.name}: ${error.message}`,
+        });
+        compilerError.causes = guessCauses(error.message);
+        compilerError.sourceLine = sourceLine;
+        return {
+            code,
+            error,
+            formatted: formatCompilerError(compilerError),
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/optimizer/index.d.ts

@@ -0,0 +1,178 @@
+type ASTNode = any;
+export interface OptimizationOptions {
+    /** Enable dead code elimination */
+    deadCodeElimination: boolean;
+    /** Enable constant folding */
+    constantFolding: boolean;
+    /** Enable dead store elimination */
+    deadStoreElimination: boolean;
+    /** Enable function inlining */
+    functionInlining: boolean;
+    /** Enable JSX optimization */
+    jsxOptimization: boolean;
+    /** Enable tree-shaking hints */
+    treeShaking: boolean;
+    /** Enable static subtree hoisting (React.memo-like) */
+    staticHoisting: boolean;
+    /** Enable compile-time CSS scoping */
+    cssScoping: boolean;
+    /** Enable auto-memoization (React Compiler-like) */
+    autoMemoization: boolean;
+    /** Minification level (0-3) */
+    minificationLevel: 0 | 1 | 2 | 3;
+}
+export interface OptimizationResult {
+    code: string;
+    ast: ASTNode;
+    warnings: OptimizationWarning[];
+    stats: OptimizationStats;
+    /** CSS scopes extracted during optimization */
+    cssScopes?: CSSScope[];
+}
+export interface OptimizationWarning {
+    type: 'dead_code' | 'unused_variable' | 'side_effect' | 'performance' | 'static_hoist';
+    message: string;
+    line?: number;
+    column?: number;
+}
+export interface OptimizationStats {
+    originalSize: number;
+    optimizedSize: number;
+    reduction: number;
+    eliminatedNodes: number;
+    inlinedFunctions: number;
+    constantFolds: number;
+    staticHoisted: number;
+    autoMemoized: number;
+}
+export interface CSSScope {
+    id: string;
+    selector: string;
+    css: string;
+    hash: string;
+}
+export declare class Optimizer {
+    private options;
+    private warnings;
+    private stats;
+    constructor(options?: Partial<OptimizationOptions>);
+    /**
+     * Optimize AST
+     */
+    optimize(ast: ASTNode): OptimizationResult;
+    private cloneAST;
+    private eliminateDeadCode;
+    private foldConstants;
+    private eliminateDeadStores;
+    private inlineFunctions;
+    private optimizeJSX;
+    private evaluateConstant;
+    private evaluateBinary;
+    private evaluateUnary;
+    private evaluateLogical;
+    private createLiteral;
+    private isSmallExpression;
+    private substituteParams;
+    private hasSideEffects;
+    private generateCode;
+    /**
+     * Convert AST node to JavaScript code string
+     */
+    private astToCode;
+    /**
+     * Automatically memoize expensive computations.
+     * Similar to React Compiler's auto-memoization — eliminates the need for manual useMemo/useCallback.
+     */
+    private autoMemoize;
+}
+export interface TreeShakeOptions {
+    /** Entry points */
+    entryPoints: string[];
+    /** Mark functions as side-effect free */
+    sideEffectFree: Set<string>;
+    /** Export analysis */
+    analyzeExports: boolean;
+}
+export interface TreeShakeResult {
+    kept: string[];
+    eliminated: string[];
+    warnings: string[];
+}
+/**
+ * Analyze and tree-shake unused exports
+ */
+export declare function treeShake(code: string, options: TreeShakeOptions): TreeShakeResult;
+export interface BundleAnalysis {
+    size: number;
+    gzipSize: number;
+    modules: ModuleInfo[];
+    dependencies: string[];
+    peerDependencies: string[];
+}
+export interface ModuleInfo {
+    name: string;
+    size: number;
+    exports: string[];
+    sideEffects: boolean;
+}
+/**
+ * Analyze bundle for optimization opportunities
+ */
+export declare function analyzeBundle(code: string, moduleName: string): BundleAnalysis;
+export declare const DEAD_CODE_PATTERNS: RegExp[];
+export declare const SIDE_EFFECT_FREE_FUNCTIONS: Set<string>;
+/**
+ * Identify and hoist static JSX subtrees.
+ * Static elements (no dynamic expressions) can be created once and reused.
+ *
+ * @example
+ * // Before hoisting
+ * function App() {
+ *   return <div><Header /><StaticContent /><Footer /></div>
+ * }
+ *
+ * // After hoisting — StaticContent is hoisted outside the function
+ * const _hoisted_0 = <StaticContent />
+ * function App() {
+ *   return <div><Header />{_hoisted_0}<Footer /></div>
+ * }
+ */
+export declare function hoistStaticSubtrees(ast: ASTNode, code: string): {
+    ast: ASTNode;
+    code: string;
+    hoisted: number;
+};
+export declare function autoMemoize(ast: ASTNode): {
+    ast: ASTNode;
+    memoized: number;
+};
+/**
+ * Scope CSS to components at compile time.
+ * Generates unique class names and injects scoped styles.
+ *
+ * @example
+ * // Input
+ * <style>
+ *   .container { padding: 16px; }
+ *   .title { font-size: 24px; }
+ * </style>
+ * <div class="container">
+ *   <h1 class="title">Hello</h1>
+ * </div>
+ *
+ * // Output (with scope hash "abc123")
+ * <style>
+ *   .container[data-scoped-abc123] { padding: 16px; }
+ *   .title[data-scoped-abc123] { font-size: 24px; }
+ * </style>
+ * <div class="container" data-scoped-abc123>
+ *   <h1 class="title" data-scoped-abc123>Hello</h1>
+ * </div>
+ */
+export declare function scopeCSS(ast: ASTNode, code: string, componentName?: string): {
+    ast: ASTNode;
+    code: string;
+    scopes: CSSScope[];
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/optimizer/index.d.ts.map

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