sinwan-compiler 0.0.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohammed Ben Cheikh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# sinwan-compiler
+
+Shared compiler core for the SinwanJS framework. Provides the JSX transform, the project-wide reactive-prop analyzer, and the dev/HMR cache used by both the Bun and Vite plugins.
+
+## Documentation
+
+See the [`docs/`](docs/) folder:
+
+- [Overview](docs/README.md)
+- [Analyzer](docs/analyzer.md)
+- [Transform](docs/transform.md)
+- [CLI](docs/cli.md)
+- [Plugins](docs/plugins.md)
+- [API reference](docs/api.md)
+- [Architecture](docs/architecture.md)
+
+## Quick start
+
+```bash
+bunx sinwan-compiler analyze ./src ./.sinwan/reactive-props.json
+```
+
+## Installation
+
+```bash
+bun add -d sinwan-compiler
+```

package/dist/analyze.d.ts

@@ -0,0 +1,103 @@
+/**
+ * SinwanJS Compiler — Project-wide reactive prop analyzer.
+ *
+ * Scans a project for JSX/TSX files, builds a global component call graph,
+ * and computes which exported component props are actually reactive across
+ * modules. The result is written to a JSON metadata file consumed by the
+ * per-file transform.
+ */
+import * as t from "@babel/types";
+import { type ReactiveScope, type CallSite } from "./reactive-wrap";
+export type ImportInfo = {
+    source: string;
+    importedName: string;
+};
+export type ImportedCallSite = {
+    caller: t.Function;
+    source: string;
+    name: string;
+    props: {
+        name: string;
+        value: t.Expression;
+    }[];
+    /** Spread expressions forwarded to the child. */
+    spreads: t.Expression[];
+};
+export type ModuleAnalysis = {
+    filePath: string;
+    imports: Map<string, ImportInfo>;
+    exports: Map<string, t.Function>;
+    defaultExport: t.Function | null;
+    componentFunctions: Set<t.Function>;
+    localScopes: Map<t.Function, ReactiveScope>;
+    localCallGraph: Map<t.Function, CallSite[]>;
+    importedCallSites: ImportedCallSite[];
+};
+export type ProjectAnalysis = {
+    modules: Map<string, ModuleAnalysis>;
+    reactiveProps: Map<string, Map<string, Set<string>>>;
+};
+export type WorkspacesConfig = string | string[] | {
+    file?: string;
+    include?: string[];
+};
+export type AnalyzeOptions = {
+    /** Project root directory to scan. */
+    root: string;
+    /** Output file path for the metadata JSON. */
+    outFile: string;
+    /** File extensions to scan. */
+    extensions?: string[];
+    /** Custom import resolver: returns absolute file path or null. */
+    resolve?: (source: string, fromFile: string) => string | null;
+    /** Path to tsconfig.json used to resolve path aliases. */
+    tsConfigPath?: string;
+    /** Path to bunfig.toml used to resolve Bun aliases. */
+    bunfigPath?: string;
+    /** Workspace package discovery: path to a workspace file, list of package paths/globs, or both. */
+    workspaces?: WorkspacesConfig;
+};
+export declare function analyzeModule(code: string, filePath: string): ModuleAnalysis;
+export declare function loadWorkspacePackages(workspaces: WorkspacesConfig, root: string): string[];
+export declare function analyzeProject(options: {
+    root: string;
+    extensions?: string[];
+    resolve?: (source: string, fromFile: string) => string | null;
+    files?: Record<string, string>;
+    tsConfigPath?: string;
+    bunfigPath?: string;
+    workspaces?: WorkspacesConfig;
+}): ProjectAnalysis;
+export declare class AnalyzerCache {
+    root: string;
+    extensions: string[];
+    tsConfigPath?: string;
+    bunfigPath?: string;
+    workspaces?: WorkspacesConfig;
+    cachePath?: string;
+    resolve: (source: string, fromFile: string) => string | null;
+    modules: Map<string, ModuleAnalysis>;
+    reactiveProps: Map<string, Map<string, Set<string>>>;
+    private importers;
+    constructor(options: {
+        root: string;
+        extensions?: string[];
+        tsConfigPath?: string;
+        bunfigPath?: string;
+        workspaces?: WorkspacesConfig;
+        resolve?: (source: string, fromFile: string) => string | null;
+        cachePath?: string;
+    });
+    update(filePath: string, code: string): void;
+    remove(filePath: string): void;
+    save(): void;
+    private restore;
+    private addImporters;
+    private removeImporters;
+    private ensureAnalyzed;
+    private collectAffected;
+    private recomputeFor;
+    private recompute;
+}
+export declare function analyze(options: AnalyzeOptions): void;
+export declare function loadMetadata(filePath: string): Map<string, Map<string, Set<string>>>;