@csszyx/types 0.1.0

package/dist/compiler.d.ts

@@ -0,0 +1,435 @@
+import { RecoveryMode } from './runtime.js';
+
+/**
+ * Compiler types for csszyx.
+ *
+ * This module defines types used during compilation and build phases.
+ */
+
+/**
+ * Build phase identifiers.
+ */
+type BuildPhase = 'type_generation' | 'jsx_transform' | 'tailwind_jit' | 'global_mangling' | 'output_emit';
+/**
+ * Build phase status.
+ */
+type BuildPhaseStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+/**
+ * Build phase result.
+ */
+interface BuildPhaseResult {
+    /**
+     * Phase identifier
+     */
+    phase: BuildPhase;
+    /**
+     * Phase status
+     */
+    status: BuildPhaseStatus;
+    /**
+     * Time taken in milliseconds
+     */
+    duration?: number;
+    /**
+     * Error if phase failed
+     */
+    error?: Error;
+    /**
+     * Output artifacts from this phase
+     */
+    artifacts?: string[];
+}
+/**
+ * Compiler options.
+ */
+interface CompilerOptions {
+    /**
+     * Build ID (git hash or timestamp)
+     */
+    buildId?: string;
+    /**
+     * Enable development mode features
+     */
+    development?: boolean;
+    /**
+     * Auto-inject recovery tokens
+     */
+    autoInjectRecovery?: boolean;
+    /**
+     * Strict mode - fail build on warnings
+     */
+    strictMode?: boolean;
+    /**
+     * Enable debug output
+     */
+    debug?: boolean;
+    /**
+     * Source root directory
+     */
+    sourceRoot?: string;
+    /**
+     * Output directory
+     */
+    outDir?: string;
+}
+/**
+ * Transform options for JSX transformation.
+ */
+interface TransformOptions {
+    /**
+     * File path being transformed
+     */
+    filePath: string;
+    /**
+     * Build ID
+     */
+    buildId: string;
+    /**
+     * Whether to inject recovery tokens
+     */
+    injectRecovery: boolean;
+    /**
+     * Development mode
+     */
+    development: boolean;
+}
+/**
+ * Token metadata for compiler.
+ */
+interface TokenMetadata {
+    /**
+     * Recovery mode
+     */
+    mode: RecoveryMode;
+    /**
+     * Component name
+     */
+    component: string;
+    /**
+     * Absolute file path
+     */
+    filePath: string;
+    /**
+     * Line number in source
+     */
+    line: number;
+    /**
+     * Column number in source
+     */
+    column: number;
+    /**
+     * Build ID
+     */
+    buildId: string;
+}
+/**
+ * Generated recovery token with metadata.
+ */
+interface GeneratedToken {
+    /**
+     * The token string
+     */
+    token: string;
+    /**
+     * Token metadata
+     */
+    metadata: TokenMetadata;
+}
+/**
+ * Compilation result for a single file.
+ */
+interface FileCompilationResult {
+    /**
+     * File path
+     */
+    filePath: string;
+    /**
+     * Transformed code
+     */
+    code: string;
+    /**
+     * Source map (optional)
+     */
+    map?: string;
+    /**
+     * Generated tokens
+     */
+    tokens: GeneratedToken[];
+    /**
+     * Extracted class names
+     */
+    classNames: string[];
+    /**
+     * Whether file was cached
+     */
+    cached: boolean;
+}
+/**
+ * Build statistics.
+ */
+interface BuildStatistics {
+    /**
+     * Total files processed
+     */
+    filesProcessed: number;
+    /**
+     * Files from cache
+     */
+    filesCached: number;
+    /**
+     * Total class names found
+     */
+    totalClasses: number;
+    /**
+     * Unique class names
+     */
+    uniqueClasses: number;
+    /**
+     * Recovery tokens generated
+     */
+    tokensGenerated: number;
+    /**
+     * Total build time (ms)
+     */
+    totalTime: number;
+    /**
+     * Phase durations
+     */
+    phaseTimes: Partial<Record<BuildPhase, number>>;
+    /**
+     * Memory usage (bytes)
+     */
+    memoryUsage?: number;
+}
+/**
+ * Build result.
+ */
+interface BuildResult {
+    /**
+     * Success flag
+     */
+    success: boolean;
+    /**
+     * Build statistics
+     */
+    stats: BuildStatistics;
+    /**
+     * Phase results
+     */
+    phases: BuildPhaseResult[];
+    /**
+     * Errors encountered
+     */
+    errors: Error[];
+    /**
+     * Warnings generated
+     */
+    warnings: string[];
+    /**
+     * Output artifacts
+     */
+    artifacts: Record<string, string>;
+}
+/**
+ * Mangle map entry.
+ */
+interface MangleMapEntry {
+    /**
+     * Original class name
+     */
+    original: string;
+    /**
+     * Mangled class name
+     */
+    mangled: string;
+    /**
+     * Usage count
+     */
+    usageCount: number;
+    /**
+     * First seen at file
+     */
+    firstSeenIn?: string;
+}
+/**
+ * Collision detection result.
+ */
+interface CollisionResult {
+    /**
+     * Whether a collision was detected
+     */
+    hasCollision: boolean;
+    /**
+     * Colliding class names
+     */
+    collisions?: Array<{
+        className: string;
+        hash: string;
+        conflictsWith: string;
+    }>;
+}
+/**
+ * AST node location.
+ */
+interface NodeLocation {
+    /**
+     * Line number
+     */
+    line: number;
+    /**
+     * Column number
+     */
+    column: number;
+    /**
+     * File path
+     */
+    filePath: string;
+}
+/**
+ * Validation error.
+ */
+interface ValidationError {
+    /**
+     * Error type
+     */
+    type: 'syntax' | 'semantic' | 'type' | 'warning';
+    /**
+     * Error message
+     */
+    message: string;
+    /**
+     * Location where error occurred
+     */
+    location?: NodeLocation;
+    /**
+     * Suggestions for fixing
+     */
+    suggestions?: string[];
+}
+/**
+ * Validation result.
+ */
+interface ValidationResult {
+    /**
+     * Whether validation passed
+     */
+    valid: boolean;
+    /**
+     * Validation errors
+     */
+    errors: ValidationError[];
+    /**
+     * Warnings
+     */
+    warnings: ValidationError[];
+}
+/**
+ * Plugin interface for extending compiler.
+ */
+interface CompilerPlugin {
+    /**
+     * Plugin name
+     */
+    name: string;
+    /**
+     * Plugin version
+     */
+    version?: string;
+    /**
+     * Setup hook - called once at initialization
+     */
+    setup?: (compiler: CompilerContext) => void | Promise<void>;
+    /**
+     * Transform hook - called for each file
+     */
+    transform?: (code: string, filePath: string, options: TransformOptions) => string | Promise<string>;
+    /**
+     * Post-process hook - called after all transformations
+     */
+    postProcess?: (result: BuildResult) => BuildResult | Promise<BuildResult>;
+}
+/**
+ * Compiler context passed to plugins.
+ */
+interface CompilerContext {
+    /**
+     * Compiler options
+     */
+    options: CompilerOptions;
+    /**
+     * Build statistics (read-only)
+     */
+    readonly stats: BuildStatistics;
+    /**
+     * Register a new file for processing
+     */
+    addFile: (filePath: string) => void;
+    /**
+     * Get compilation result for a file
+     */
+    getFileResult: (filePath: string) => FileCompilationResult | undefined;
+    /**
+     * Emit a warning
+     */
+    warn: (message: string, location?: NodeLocation) => void;
+    /**
+     * Emit an error
+     */
+    error: (message: string, location?: NodeLocation) => void;
+}
+/**
+ * Cache entry for incremental builds.
+ */
+interface CacheEntry {
+    /**
+     * File path
+     */
+    filePath: string;
+    /**
+     * Content hash
+     */
+    contentHash: string;
+    /**
+     * Compilation result
+     */
+    result: FileCompilationResult;
+    /**
+     * Timestamp when cached
+     */
+    timestamp: number;
+    /**
+     * Build ID when cached
+     */
+    buildId: string;
+}
+/**
+ * Cache manager interface.
+ */
+interface CacheManager {
+    /**
+     * Get cached result for a file
+     */
+    get: (filePath: string, contentHash: string) => CacheEntry | undefined;
+    /**
+     * Set cache entry for a file
+     */
+    set: (filePath: string, contentHash: string, result: FileCompilationResult) => void;
+    /**
+     * Clear cache for a file
+     */
+    clear: (filePath: string) => void;
+    /**
+     * Clear all cache entries
+     */
+    clearAll: () => void;
+    /**
+     * Get cache statistics
+     */
+    getStats: () => {
+        entries: number;
+        totalSize: number;
+        hitRate: number;
+    };
+}
+
+export type { BuildPhase, BuildPhaseResult, BuildPhaseStatus, BuildResult, BuildStatistics, CacheEntry, CacheManager, CollisionResult, CompilerContext, CompilerOptions, CompilerPlugin, FileCompilationResult, GeneratedToken, MangleMapEntry, NodeLocation, TokenMetadata, TransformOptions, ValidationError, ValidationResult };

package/dist/config.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Configuration types for csszyx.
+ *
+ * This module defines all configuration interfaces and types used
+ * throughout the csszyx framework.
+ */
+/**
+ * Development mode configuration options.
+ */
+interface DevelopmentConfig {
+    /**
+     * Automatically inject recovery tokens for all components.
+     * When enabled, all components get szRecover="dev-only" by default.
+     *
+     * @default false
+     */
+    autoInjectRecovery: boolean;
+    /**
+     * Enable strict mode - fail build on warnings.
+     * When enabled, warnings are treated as errors.
+     *
+     * @default false
+     */
+    strictMode: boolean;
+    /**
+     * Enable debug logging during build.
+     *
+     * @default false
+     */
+    debug: boolean;
+    /**
+     * Allow client-side recovery on hydration mismatch.
+     * Only works in development mode.
+     *
+     * @default true
+     */
+    allowCSRRecovery: boolean;
+}
+/**
+ * Production mode configuration options.
+ */
+interface ProductionConfig {
+    /**
+     * Enable global class name mangling.
+     * Minifies class names to single characters (a, b, c, etc.).
+     *
+     * @default true
+     */
+    mangle: boolean;
+    /**
+     * Enable content hashing for immutable caching.
+     *
+     * @default true
+     */
+    contentHashing: boolean;
+    /**
+     * Inject checksum for SSR hydration validation.
+     *
+     * @default true
+     */
+    injectChecksum: boolean;
+    /**
+     * Enable incremental build caching.
+     *
+     * @default true
+     */
+    incrementalBuild: boolean;
+    /**
+     * Minify output (class names and attributes).
+     *
+     * @default true in production
+     */
+    minify: boolean;
+}
+/**
+ * Build pipeline configuration.
+ */
+interface BuildConfig {
+    /**
+     * Build ID (git hash or timestamp).
+     * Auto-generated if not provided.
+     */
+    buildId?: string;
+    /**
+     * Path to Tailwind config file.
+     *
+     * @default "tailwind.config.js"
+     */
+    tailwindConfig?: string;
+    /**
+     * Output directory for generated files.
+     *
+     * @default ".csszyx"
+     */
+    outputDir?: string;
+    /**
+     * Cache directory for incremental builds.
+     *
+     * @default ".csszyx/cache"
+     */
+    cacheDir?: string;
+    /**
+     * Maximum AST nodes per file before warning.
+     *
+     * @default 50000
+     */
+    astBudgetLimit?: number;
+}
+/**
+ * Hydration safety configuration.
+ */
+interface HydrationConfig {
+    /**
+     * Enable strict hydration checks.
+     * When enabled, hydration mismatches trigger abort protocol.
+     *
+     * @default true
+     */
+    strict: boolean;
+    /**
+     * Default recovery mode for components without explicit szRecover.
+     *
+     * @default null (no recovery)
+     */
+    defaultRecoveryMode?: 'csr' | 'dev-only' | null;
+    /**
+     * Enable hydration audit logging.
+     *
+     * @default true
+     */
+    auditLog: boolean;
+}
+/**
+ * Performance optimization configuration.
+ */
+interface PerformanceConfig {
+    /**
+     * Enable parallel processing during build.
+     *
+     * @default true
+     */
+    parallel: boolean;
+    /**
+     * Number of worker threads for parallel processing.
+     * Auto-detected if not provided.
+     */
+    workers?: number;
+    /**
+     * Enable CSS variable optimization.
+     *
+     * @default true
+     */
+    optimizeVariables: boolean;
+    /**
+     * Enable zero-runtime optimization for static cases.
+     *
+     * @default true
+     */
+    zeroRuntime: boolean;
+}
+/**
+ * Main csszyx configuration.
+ */
+interface CsszyxConfig {
+    /**
+     * Development mode configuration.
+     */
+    development: DevelopmentConfig;
+    /**
+     * Production mode configuration.
+     */
+    production: ProductionConfig;
+    /**
+     * Build pipeline configuration.
+     */
+    build: BuildConfig;
+    /**
+     * Hydration safety configuration.
+     */
+    hydration: HydrationConfig;
+    /**
+     * Performance optimization configuration.
+     */
+    performance: PerformanceConfig;
+}
+/**
+ * Partial configuration for user-provided config.
+ * All fields are optional and will be merged with defaults.
+ */
+type PartialCsszyxConfig = {
+    development?: Partial<DevelopmentConfig>;
+    production?: Partial<ProductionConfig>;
+    build?: Partial<BuildConfig>;
+    hydration?: Partial<HydrationConfig>;
+    performance?: Partial<PerformanceConfig>;
+};
+/**
+ * Default development configuration.
+ */
+declare const DEFAULT_DEVELOPMENT_CONFIG: DevelopmentConfig;
+/**
+ * Default production configuration.
+ */
+declare const DEFAULT_PRODUCTION_CONFIG: ProductionConfig;
+/**
+ * Default build configuration.
+ */
+declare const DEFAULT_BUILD_CONFIG: BuildConfig;
+/**
+ * Default hydration configuration.
+ */
+declare const DEFAULT_HYDRATION_CONFIG: HydrationConfig;
+/**
+ * Default performance configuration.
+ */
+declare const DEFAULT_PERFORMANCE_CONFIG: PerformanceConfig;
+/**
+ * Default csszyx configuration.
+ */
+declare const DEFAULT_CSSZYX_CONFIG: CsszyxConfig;
+/**
+ * Environment type.
+ */
+type Environment = 'development' | 'production' | 'test';
+/**
+ * Gets the current environment.
+ *
+ * @returns {Environment} Current environment
+ */
+declare function getCurrentEnvironment(): Environment;
+
+export { type BuildConfig, type CsszyxConfig, DEFAULT_BUILD_CONFIG, DEFAULT_CSSZYX_CONFIG, DEFAULT_DEVELOPMENT_CONFIG, DEFAULT_HYDRATION_CONFIG, DEFAULT_PERFORMANCE_CONFIG, DEFAULT_PRODUCTION_CONFIG, type DevelopmentConfig, type Environment, type HydrationConfig, type PartialCsszyxConfig, type PerformanceConfig, type ProductionConfig, getCurrentEnvironment };

package/dist/config.js

@@ -0,0 +1,18 @@
+import {
+  DEFAULT_BUILD_CONFIG,
+  DEFAULT_CSSZYX_CONFIG,
+  DEFAULT_DEVELOPMENT_CONFIG,
+  DEFAULT_HYDRATION_CONFIG,
+  DEFAULT_PERFORMANCE_CONFIG,
+  DEFAULT_PRODUCTION_CONFIG,
+  getCurrentEnvironment
+} from "./chunk-2KLMBDLU.js";
+export {
+  DEFAULT_BUILD_CONFIG,
+  DEFAULT_CSSZYX_CONFIG,
+  DEFAULT_DEVELOPMENT_CONFIG,
+  DEFAULT_HYDRATION_CONFIG,
+  DEFAULT_PERFORMANCE_CONFIG,
+  DEFAULT_PRODUCTION_CONFIG,
+  getCurrentEnvironment
+};