@csszyx/types 0.7.0 → 0.8.0

package/dist/compiler.cjs

@@ -0,0 +1,2 @@
+'use strict';
+

package/dist/{compiler.d.ts → compiler.d.cts}

@@ -1,4 +1,4 @@
-import { RecoveryMode } from './runtime.js';
+import { RecoveryMode } from './runtime.cjs';
 
 /**
  * Compiler types for csszyx.

package/dist/compiler.d.mts

@@ -0,0 +1,431 @@
+import { RecoveryMode } from './runtime.mjs';
+
+/**
+ * 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;
+    /**
+     * 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/compiler.mjs

@@ -0,0 +1 @@
+

package/dist/config.cjs

@@ -0,0 +1,55 @@
+'use strict';
+
+const DEFAULT_DEVELOPMENT_CONFIG = {
+  strictMode: false,
+  debug: false
+};
+const DEFAULT_PRODUCTION_CONFIG = {
+  mangle: true,
+  contentHashing: true,
+  injectChecksum: true,
+  incrementalBuild: true,
+  minify: true
+};
+const DEFAULT_BUILD_CONFIG = {
+  tailwindConfig: "tailwind.config.js",
+  outputDir: ".csszyx",
+  cacheDir: ".csszyx/cache",
+  astBudgetLimit: 5e4,
+  parser: "oxc"
+};
+const DEFAULT_HYDRATION_CONFIG = {
+  strict: true,
+  defaultRecoveryMode: null,
+  auditLog: true
+};
+const DEFAULT_PERFORMANCE_CONFIG = {
+  parallel: true,
+  optimizeVariables: true,
+  zeroRuntime: true
+};
+const DEFAULT_CSSZYX_CONFIG = {
+  development: DEFAULT_DEVELOPMENT_CONFIG,
+  production: DEFAULT_PRODUCTION_CONFIG,
+  build: DEFAULT_BUILD_CONFIG,
+  hydration: DEFAULT_HYDRATION_CONFIG,
+  performance: DEFAULT_PERFORMANCE_CONFIG
+};
+function getCurrentEnvironment() {
+  const env = process.env.NODE_ENV;
+  if (env === "production") {
+    return "production";
+  }
+  if (env === "test") {
+    return "test";
+  }
+  return "development";
+}
+
+exports.DEFAULT_BUILD_CONFIG = DEFAULT_BUILD_CONFIG;
+exports.DEFAULT_CSSZYX_CONFIG = DEFAULT_CSSZYX_CONFIG;
+exports.DEFAULT_DEVELOPMENT_CONFIG = DEFAULT_DEVELOPMENT_CONFIG;
+exports.DEFAULT_HYDRATION_CONFIG = DEFAULT_HYDRATION_CONFIG;
+exports.DEFAULT_PERFORMANCE_CONFIG = DEFAULT_PERFORMANCE_CONFIG;
+exports.DEFAULT_PRODUCTION_CONFIG = DEFAULT_PRODUCTION_CONFIG;
+exports.getCurrentEnvironment = getCurrentEnvironment;

package/dist/{config.d.ts → config.d.cts}

@@ -91,6 +91,15 @@ interface BuildConfig {
      * @default 50000
      */
     astBudgetLimit?: number;
+    /**
+     * Source parser used for JSX/TSX sz transforms.
+     *
+     * `oxc` is the default parser. `babel` remains available as a compatibility
+     * fallback while the migration keeps Babel dependencies installed.
+     *
+     * @default "oxc"
+     */
+    parser?: 'babel' | 'oxc';
     /**
      * CSS file(s) to scan for Tailwind v4 @theme blocks.
      * When set, the plugin generates .csszyx/theme.d.ts with TypeScript augmentation
@@ -102,6 +111,14 @@ interface BuildConfig {
      */
     scanCss?: string | string[];
 }
+/**
+ * File patterns accepted by csszyx plugin filters.
+ *
+ * String patterns may be literal paths (`src/generated/icon-dump.tsx`) or
+ * simple globs such as `src/generated/**` or any TSX file. RegExp patterns are matched
+ * against both absolute paths and paths relative to the project root.
+ */
+type FilePattern = string | RegExp;
 /**
  * Hydration safety configuration.
  */
@@ -184,6 +201,21 @@ interface CsszyxConfig {
  * All fields are optional and will be merged with defaults.
  */
 type PartialCsszyxConfig = {
+    /**
+     * Restrict source files that csszyx transforms.
+     *
+     * CSS files used for Tailwind class discovery are still processed unless
+     * excluded explicitly, so narrow source includes do not accidentally disable
+     * CSS safelist injection.
+     */
+    include?: FilePattern | FilePattern[];
+    /**
+     * Exclude files from csszyx processing before parsing.
+     *
+     * Use this for large generated source files that happen to contain an `sz`
+     * marker and would otherwise hit the AST budget guard.
+     */
+    exclude?: FilePattern | FilePattern[];
     development?: Partial<DevelopmentConfig>;
     production?: Partial<ProductionConfig>;
     build?: Partial<BuildConfig>;
@@ -225,4 +257,5 @@ type Environment = 'development' | 'production' | 'test';
  */
 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 };
+export { DEFAULT_BUILD_CONFIG, DEFAULT_CSSZYX_CONFIG, DEFAULT_DEVELOPMENT_CONFIG, DEFAULT_HYDRATION_CONFIG, DEFAULT_PERFORMANCE_CONFIG, DEFAULT_PRODUCTION_CONFIG, getCurrentEnvironment };
+export type { BuildConfig, CsszyxConfig, DevelopmentConfig, Environment, FilePattern, HydrationConfig, PartialCsszyxConfig, PerformanceConfig, ProductionConfig };