@vertz/ui-compiler 0.2.3 → 1.0.0

package/README.md

@@ -1,19 +1,3 @@
 # @vertz/ui-compiler
 
-> **Internal package** — You don't use this directly. It powers the reactive compiler behind `@vertz/ui`.
-
-The UI compiler transforms `@vertz/ui` components at build time — converting `let` declarations into signals, wrapping derived `const` values in `computed()`, inserting `.value` accessors, and generating getter-based props for cross-component reactivity.
-
-## Who uses this
-
-- **`@vertz/ui-server`** — The Bun plugin loads this compiler to transform `.tsx` files during development and SSR.
-- **Framework contributors** — If you're working on the compiler itself, see the source in `src/` for architecture details.
-
-## Related Packages
-
-- [`@vertz/ui`](../ui) — The UI framework this compiler targets
-- [`@vertz/ui-server`](../ui-server) — Dev server and SSR runtime that invokes the compiler
-
-## License
-
-MIT
+> ⚠️ **Internal package** — This package is an implementation detail of the Vertz framework. It is published for use by other `@vertz/*` packages. No API stability is guaranteed between versions.

package/dist/index.d.ts

@@ -1,11 +1,4 @@
 import { SourceFile } from "ts-morph";
-/** Options for the compile() function. */
-interface CompileOptions {
-	/** Filename for source map generation. Defaults to 'input.tsx'. */
-	filename?: string;
-	/** Compilation target. 'dom' uses @vertz/ui/internals, 'tui' uses @vertz/tui/internals. */
-	target?: "dom" | "tui";
-}
 /** Severity of a compiler diagnostic. */
 type DiagnosticSeverity = "error" | "warning" | "info";
 /** A diagnostic message emitted during compilation. */
@@ -60,14 +53,6 @@ interface VariableInfo {
 	* the Set on deserialization.
 	*/
 	signalProperties?: Set<string>;
-	/** Plain (non-signal) properties on this variable. */
-	plainProperties?: Set<string>;
-	/** Per-field signal properties (e.g., form().title.error). */
-	fieldSignalProperties?: Set<string>;
-	/** Synthetic variable name this binding was destructured from (e.g., `__query_0`). */
-	destructuredFrom?: string;
-	/** Whether this variable is a reactive source (e.g., useContext result). */
-	isReactiveSource?: boolean;
 }
 /** Information about a detected component function. */
 interface ComponentInfo {
@@ -151,16 +136,13 @@ declare class CSSAnalyzer {
 	private classifyArgument;
 	/** Check if a nested object (for complex selectors) is fully static. */
 	private isStaticNestedObject;
-	/** Check if a node is a static raw declaration: { property: '...', value: '...' } */
-	private isStaticRawDeclaration;
 	/** Extract block names from a static css() argument. */
 	private extractBlockNames;
 }
 import { SourceFile as SourceFile3 } from "ts-morph";
 /**
 * Map each JSX expression/attribute to its dependencies.
-* Classify as reactive or static based on whether any dependency is a signal,
-* computed, or a signal API property access (e.g., query().data, form().submitting).
+* Classify as reactive or static based on whether any dependency is a signal or computed.
 */
 declare class JsxAnalyzer {
 	analyze(sourceFile: SourceFile3, component: ComponentInfo, variables: VariableInfo[]): JsxExpressionInfo[];
@@ -195,7 +177,7 @@ declare class ReactivityAnalyzer {
 * 8. JSX transform (includes prop transform) →
 * 9. Diagnostics → 10. Add imports → 11. Return { code, map, diagnostics }
 */
-declare function compile(source: string, optionsOrFilename?: CompileOptions | string): CompileOutput;
+declare function compile(source: string, filename?: string): CompileOutput;
 /** Result of extracting CSS from a source file. */
 interface CSSExtractionResult {
 	/** The extracted CSS rules as a string. */
@@ -343,45 +325,17 @@ import { SourceFile as SourceFile8 } from "ts-morph";
 declare class PropsDestructuringDiagnostics {
 	analyze(sourceFile: SourceFile8, components: ComponentInfo[]): CompilerDiagnostic[];
 }
-import { SourceFile as SourceFile9 } from "ts-morph";
-/**
-* Detect browser-only API usage at component top level that would crash during SSR.
-*
-* Flags globals like `localStorage`, `navigator`, observer constructors, and
-* browser-only `document` properties when used outside of callbacks (arrow
-* functions, function expressions). Usage inside `onMount()`, event handlers,
-* or any nested function is safe and not flagged.
-*/
-declare class SSRSafetyDiagnostics {
-	analyze(sourceFile: SourceFile9, component: ComponentInfo): CompilerDiagnostic[];
-}
-import { BunPlugin } from "bun";
-/** Options for the Vertz library compilation plugin. */
-interface VertzLibraryPluginOptions {
-	/** File filter regex. Defaults to /\.tsx$/. */
-	filter?: RegExp;
-	/** Compilation target. Defaults to 'dom'. */
-	target?: "dom" | "tui";
-}
-/**
-* Creates a Bun plugin for compiling Vertz library packages.
-*
-* Runs hydration transform + compile on .tsx files during bunup build.
-* CSS extraction is intentionally skipped — CSS hashing is path-dependent
-* and must be done by the consuming app's build pipeline.
-*/
-declare function createVertzLibraryPlugin(options?: VertzLibraryPluginOptions): BunPlugin;
 import MagicString from "magic-string";
-import { SourceFile as SourceFile10 } from "ts-morph";
+import { SourceFile as SourceFile9 } from "ts-morph";
 /**
 * Transform `const x = expr` → `const x = computed(() => expr)` when classified as computed.
 * Also handles destructuring: `const { a, b } = expr` → individual computed declarations.
 */
 declare class ComputedTransformer {
-	transform(source: MagicString, sourceFile: SourceFile10, component: ComponentInfo, variables: VariableInfo[]): void;
+	transform(source: MagicString, sourceFile: SourceFile9, component: ComponentInfo, variables: VariableInfo[]): void;
 }
 import MagicString2 from "magic-string";
-import { SourceFile as SourceFile11 } from "ts-morph";
+import { SourceFile as SourceFile10 } from "ts-morph";
 /** Result of CSS transformation. */
 interface CSSTransformResult {
 	/** Extracted CSS rules. */
@@ -393,14 +347,14 @@ interface CSSTransformResult {
 * Transform static css() calls in the source.
 */
 declare class CSSTransformer {
-	transform(s: MagicString2, sourceFile: SourceFile11, cssCalls: CSSCallInfo[], filePath: string): CSSTransformResult;
+	transform(s: MagicString2, sourceFile: SourceFile10, cssCalls: CSSCallInfo[], filePath: string): CSSTransformResult;
 	/** Process a static css() call to extract CSS and generate class names. */
 	private processStaticCall;
 	/** Build the replacement JS expression: { card: '_a1b2c3d4', title: '_e5f6g7h8' } */
 	private buildReplacement;
 }
 import MagicString3 from "magic-string";
-import { SourceFile as SourceFile12 } from "ts-morph";
+import { SourceFile as SourceFile11 } from "ts-morph";
 /**
 * Marks interactive components with `data-v-id` hydration markers.
 *
@@ -412,7 +366,7 @@ import { SourceFile as SourceFile12 } from "ts-morph";
 * with `data-v-id="ComponentName"`.
 */
 declare class HydrationTransformer {
-	transform(s: MagicString3, sourceFile: SourceFile12): void;
+	transform(s: MagicString3, sourceFile: SourceFile11): void;
 	/**
 	* Determine whether a component is interactive by checking for `let`
 	* declarations in the component body.
@@ -427,7 +381,7 @@ declare class HydrationTransformer {
 	private _injectAttribute;
 }
 import MagicString4 from "magic-string";
-import { SourceFile as SourceFile13 } from "ts-morph";
+import { SourceFile as SourceFile12 } from "ts-morph";
 /**
 * Transform JSX into DOM helper calls.
 * Reactive expressions are wrapped in functions, static expressions are passed directly.
@@ -436,7 +390,7 @@ import { SourceFile as SourceFile13 } from "ts-morph";
 * so that it picks up .value transforms from the signal/computed transformers.
 */
 declare class JsxTransformer {
-	transform(source: MagicString4, sourceFile: SourceFile13, component: ComponentInfo, variables: VariableInfo[], jsxExpressions: JsxExpressionInfo[]): void;
+	transform(source: MagicString4, sourceFile: SourceFile12, component: ComponentInfo, variables: VariableInfo[], jsxExpressions: JsxExpressionInfo[]): void;
 	/**
 	* Walk the full function body and transform every top-level JSX node.
 	* "Top-level" means JSX that isn't nested inside other JSX (children are
@@ -465,7 +419,7 @@ declare class MutationTransformer {
 	private _transformObjectAssign;
 }
 import MagicString6 from "magic-string";
-import { Node, SourceFile as SourceFile14 } from "ts-morph";
+import { Node, SourceFile as SourceFile13 } from "ts-morph";
 /**
 * Transform component props: reactive → getter, static → plain value.
 *
@@ -474,12 +428,12 @@ import { Node, SourceFile as SourceFile14 } from "ts-morph";
 * cases where prop transformation is needed independently.
 */
 declare class PropTransformer {
-	transform(_source: MagicString6, _sourceFile: SourceFile14, _component: ComponentInfo, _variables: VariableInfo[], _jsxExpressions: JsxExpressionInfo[]): void;
+	transform(_source: MagicString6, _sourceFile: SourceFile13, _component: ComponentInfo, _variables: VariableInfo[], _jsxExpressions: JsxExpressionInfo[]): void;
 	/** Build a props object string for a component call. */
 	buildPropsObject(attrs: Node[], jsxMap: Map<number, JsxExpressionInfo>): string;
 }
 import MagicString7 from "magic-string";
-import { SourceFile as SourceFile15 } from "ts-morph";
+import { SourceFile as SourceFile14 } from "ts-morph";
 /**
 * Transform `let x = val` → `const x = signal(val)` and all reads/writes
 * for variables classified as signals.
@@ -488,7 +442,7 @@ import { SourceFile as SourceFile15 } from "ts-morph";
 * expressions are handled by the MutationTransformer instead.
 */
 declare class SignalTransformer {
-	transform(source: MagicString7, sourceFile: SourceFile15, component: ComponentInfo, variables: VariableInfo[], mutationRanges?: Array<{
+	transform(source: MagicString7, sourceFile: SourceFile14, component: ComponentInfo, variables: VariableInfo[], mutationRanges?: Array<{
 		start: number;
 		end: number;
 	}>): void;
@@ -561,4 +515,49 @@ interface ThemeTypeInput {
 * @returns TypeScript source string with exported ThemeTokens type.
 */
 declare function generateThemeTypes(input: ThemeTypeInput): string;
-export { generateThemeTypes, generateCSSProperties, createVertzLibraryPlugin, compile, VertzLibraryPluginOptions, VariableInfo, ThemeTypeInput, SignalTransformer, SSRSafetyDiagnostics, RouteCSSManifest, ReactivityKind, ReactivityAnalyzer, PropsDestructuringDiagnostics, PropTransformer, MutationTransformer, MutationKind, MutationInfo, MutationDiagnostics, MutationAnalyzer, JsxTransformer, JsxExpressionInfo, JsxAnalyzer, HydrationTransformer, DiagnosticSeverity, DeadCSSEliminator, ComputedTransformer, ComponentInfo, ComponentAnalyzer, CompilerDiagnostic, CompileOutput, CompileOptions, CSSTransformer, CSSTransformResult, CSSPropertiesInput, CSSHMRUpdateResult, CSSHMRHandler, CSSExtractor, CSSExtractionResult, CSSDiagnostics, CSSCodeSplitter, CSSCallKind, CSSCallInfo, CSSAnalyzer };
+import { Plugin } from "vite";
+/** SSR configuration options. */
+interface SSROptions {
+	/**
+	* Path to the root component. Auto-detected from index.html if omitted.
+	* @default auto-detect from <script type="module" src="..."> in index.html
+	*/
+	entry?: string;
+	/**
+	* Streaming SSR vs buffered.
+	* @default 'buffered'
+	*/
+	mode?: "buffered" | "streaming";
+	/**
+	* Port override for the dev server (uses Vite's default if unset).
+	*/
+	port?: number;
+}
+/** Options for the Vertz Vite plugin. */
+interface VertzPluginOptions {
+	/** Glob patterns for component files. Defaults to tsx and jsx. */
+	include?: string[];
+	/** Glob patterns to exclude. */
+	exclude?: string[];
+	/** Enable CSS extraction in production. Defaults to true. */
+	cssExtraction?: boolean;
+	/** Route-to-file mapping for CSS code splitting (production only). */
+	routeMap?: Map<string, string[]>;
+	/**
+	* Enable SSR in development mode.
+	* When true, `vite dev` serves SSR'd HTML automatically.
+	* When an object, provides SSR configuration options.
+	*/
+	ssr?: boolean | SSROptions;
+}
+/**
+* Vite plugin that transforms tsx/jsx files using the vertz/ui compiler.
+*
+* Chains all compiler passes: reactive transforms, component transforms,
+* hydration markers, and CSS extraction. In dev mode, provides HMR for
+* both component code and CSS changes. In production, extracts CSS to
+* virtual modules and performs dead CSS elimination and route-level
+* code splitting.
+*/
+declare function vertzPlugin(options?: VertzPluginOptions): Plugin;
+export { generateThemeTypes, generateCSSProperties, vertzPlugin as default, compile, VertzPluginOptions, VariableInfo, ThemeTypeInput, SignalTransformer, RouteCSSManifest, ReactivityKind, ReactivityAnalyzer, PropsDestructuringDiagnostics, PropTransformer, MutationTransformer, MutationKind, MutationInfo, MutationDiagnostics, MutationAnalyzer, JsxTransformer, JsxExpressionInfo, JsxAnalyzer, HydrationTransformer, DiagnosticSeverity, DeadCSSEliminator, ComputedTransformer, ComponentInfo, ComponentAnalyzer, CompilerDiagnostic, CompileOutput, CSSTransformer, CSSTransformResult, CSSPropertiesInput, CSSHMRUpdateResult, CSSHMRHandler, CSSExtractor, CSSExtractionResult, CSSDiagnostics, CSSCodeSplitter, CSSCallKind, CSSCallInfo, CSSAnalyzer };