@csszyx/types 0.6.2 → 0.8.0

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

@@ -39,6 +39,10 @@ interface RecoveryManifest {
      * SHA-256 checksum of the tokens object for integrity verification
      */
     checksum: string;
+    /**
+     * SHA-256 checksum of the mangle map emitted in the HTML checksum attribute
+     */
+    mangleChecksum: string;
     /**
      * Map of recovery token → token data
      */
@@ -254,4 +258,5 @@ interface CsszyxWindow extends Window {
  */
 declare function isCsszyxWindow(win: Window): win is CsszyxWindow;
 
-export { type AuditLogEntry, type ComponentPropsWithSz, type CsszyxWindow, type HydrationError, type HydrationErrorType, type MangleMap, type MangleMapMetadata, type PerformanceMetrics, type RecoveryManifest, type RecoveryMode, type RuntimeState, type SzProp, type TokenData, type VerificationResult, isCsszyxWindow };
+export { isCsszyxWindow };
+export type { AuditLogEntry, ComponentPropsWithSz, CsszyxWindow, HydrationError, HydrationErrorType, MangleMap, MangleMapMetadata, PerformanceMetrics, RecoveryManifest, RecoveryMode, RuntimeState, SzProp, TokenData, VerificationResult };

package/dist/runtime.d.mts

@@ -0,0 +1,262 @@
+/**
+ * Runtime types for csszyx.
+ *
+ * This module defines types used at runtime for hydration guards,
+ * recovery tokens, and mangle maps.
+ */
+/**
+ * Recovery mode types.
+ */
+type RecoveryMode = 'csr' | 'dev-only';
+/**
+ * Token data stored in the recovery manifest.
+ */
+interface TokenData {
+    /**
+     * Recovery mode ('csr' or 'dev-only')
+     */
+    mode: RecoveryMode;
+    /**
+     * Component name where the token was generated
+     */
+    component: string;
+    /**
+     * File path relative to project root
+     */
+    path: string;
+}
+/**
+ * Recovery manifest structure.
+ *
+ * Embedded in build output as JSON in a script tag with id "__SZ_RECOVERY_MANIFEST__".
+ */
+interface RecoveryManifest {
+    /**
+     * Build ID (git hash or timestamp)
+     */
+    buildId: string;
+    /**
+     * SHA-256 checksum of the tokens object for integrity verification
+     */
+    checksum: string;
+    /**
+     * SHA-256 checksum of the mangle map emitted in the HTML checksum attribute
+     */
+    mangleChecksum: string;
+    /**
+     * Map of recovery token → token data
+     */
+    tokens: Record<string, TokenData>;
+}
+/**
+ * Mangle map structure.
+ *
+ * Maps original Tailwind class names to their minified equivalents.
+ * Embedded in build output as JSON in a script tag with id "__SZ_MANGLE_MAP__".
+ */
+interface MangleMap {
+    /**
+     * Map of original class name → mangled class name
+     */
+    [originalClass: string]: string;
+}
+/**
+ * Mangle map metadata.
+ */
+interface MangleMapMetadata {
+    /**
+     * Build ID
+     */
+    buildId: string;
+    /**
+     * Total number of classes in the map
+     */
+    classCount: number;
+    /**
+     * SHA-256 checksum of the map for validation
+     */
+    checksum: string;
+    /**
+     * Timestamp when the map was generated
+     */
+    timestamp: number;
+}
+/**
+ * Hydration error types.
+ */
+type HydrationErrorType = 'checksum_mismatch' | 'map_missing' | 'invalid_token' | 'abort_failed';
+/**
+ * Hydration error details.
+ */
+interface HydrationError {
+    /**
+     * Error type
+     */
+    type: HydrationErrorType;
+    /**
+     * Error message
+     */
+    message: string;
+    /**
+     * Element where the error occurred (optional)
+     */
+    element?: HTMLElement;
+    /**
+     * Timestamp when error occurred
+     */
+    timestamp: number;
+    /**
+     * Stack trace (optional)
+     */
+    stack?: string;
+}
+/**
+ * Token verification result.
+ */
+interface VerificationResult {
+    /**
+     * Whether the token is valid
+     */
+    valid: boolean;
+    /**
+     * Token data if valid
+     */
+    tokenData?: TokenData;
+    /**
+     * Error message if invalid
+     */
+    error?: string;
+}
+/**
+ * Runtime state interface.
+ */
+interface RuntimeState {
+    /**
+     * Whether the runtime has been initialized
+     */
+    initialized: boolean;
+    /**
+     * Current environment
+     */
+    environment: 'development' | 'production' | 'test';
+    /**
+     * Whether CSR recovery is allowed
+     */
+    csrRecoveryAllowed: boolean;
+    /**
+     * Loaded recovery manifest
+     */
+    manifest?: RecoveryManifest;
+    /**
+     * Loaded mangle map
+     */
+    mangleMap?: MangleMap;
+    /**
+     * Recorded hydration errors
+     */
+    errors: HydrationError[];
+    /**
+     * Count of aborted subtrees
+     */
+    abortedCount: number;
+}
+/**
+ * JSX sz prop object type.
+ */
+interface SzProp {
+    [key: string]: string | number | boolean | SzProp;
+}
+/**
+ * Component props with sz attribute.
+ */
+interface ComponentPropsWithSz {
+    /**
+     * csszyx object syntax for Tailwind classes
+     */
+    sz?: SzProp | string;
+    /**
+     * Recovery mode (optional)
+     */
+    szRecover?: RecoveryMode;
+    /**
+     * Standard className prop (merged with sz)
+     */
+    className?: string;
+}
+/**
+ * Audit log entry.
+ */
+interface AuditLogEntry {
+    /**
+     * Log level
+     */
+    level: 'info' | 'warn' | 'error';
+    /**
+     * Log message
+     */
+    message: string;
+    /**
+     * Timestamp
+     */
+    timestamp: number;
+    /**
+     * Additional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Performance metrics.
+ */
+interface PerformanceMetrics {
+    /**
+     * Time taken for hydration guard (ms)
+     */
+    hydrationGuardTime?: number;
+    /**
+     * Time taken for token verification (ms)
+     */
+    tokenVerificationTime?: number;
+    /**
+     * Total number of tokens verified
+     */
+    tokensVerified?: number;
+    /**
+     * Number of hydration errors
+     */
+    hydrationErrors?: number;
+    /**
+     * Memory usage (bytes)
+     */
+    memoryUsage?: number;
+}
+/**
+ * Global window interface extensions for csszyx.
+ */
+interface CsszyxWindow extends Window {
+    /**
+     * Allow CSR recovery flag (development only)
+     */
+    __SZ_ALLOW_CSR_RECOVERY__?: boolean;
+    /**
+     * Runtime state
+     */
+    __SZ_RUNTIME_STATE__?: RuntimeState;
+    /**
+     * Performance metrics
+     */
+    __SZ_METRICS__?: PerformanceMetrics;
+    /**
+     * Debug mode flag
+     */
+    __SZ_DEBUG__?: boolean;
+}
+/**
+ * Type guard to check if window has csszyx extensions.
+ *
+ * @param {Window} win - Window object to check
+ * @returns {win is CsszyxWindow} True if window has csszyx extensions
+ */
+declare function isCsszyxWindow(win: Window): win is CsszyxWindow;
+
+export { isCsszyxWindow };
+export type { AuditLogEntry, ComponentPropsWithSz, CsszyxWindow, HydrationError, HydrationErrorType, MangleMap, MangleMapMetadata, PerformanceMetrics, RecoveryManifest, RecoveryMode, RuntimeState, SzProp, TokenData, VerificationResult };

package/dist/{chunk-QAJB64L5.js → runtime.mjs}

@@ -1,8 +1,5 @@
-// src/runtime.ts
 function isCsszyxWindow(win) {
   return "__SZ_RUNTIME_STATE__" in win || "__SZ_ALLOW_CSR_RECOVERY__" in win;
 }
 
-export {
-  isCsszyxWindow
-};
+export { isCsszyxWindow };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csszyx/types",
-  "version": "0.6.2",
+  "version": "0.8.0",
   "description": "TypeScript definitions for csszyx",
   "keywords": [
     "csszyx",
@@ -19,25 +19,25 @@
     "url": "https://github.com/nguyennhutien/csszyx/issues"
   },
   "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
     },
     "./config": {
-      "types": "./dist/config.d.ts",
-      "import": "./dist/config.js"
+      "types": "./dist/config.d.mts",
+      "import": "./dist/config.mjs"
     },
     "./runtime": {
-      "types": "./dist/runtime.d.ts",
-      "import": "./dist/runtime.js"
+      "types": "./dist/runtime.d.mts",
+      "import": "./dist/runtime.mjs"
     },
     "./compiler": {
-      "types": "./dist/compiler.d.ts",
-      "import": "./dist/compiler.js"
+      "types": "./dist/compiler.d.mts",
+      "import": "./dist/compiler.mjs"
     },
     "./jsx": {
       "types": "./dist/jsx.d.ts"
@@ -48,13 +48,17 @@
   ],
   "devDependencies": {
     "@types/node": "^20.11.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.3",
-    "@csszyx/compiler": "0.6.2"
+    "typescript": "^6.0.3",
+    "unbuild": "^3.6.1",
+    "@csszyx/compiler": "0.8.0"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.12.0"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/config.ts src/runtime.ts src/compiler.ts --format esm --dts && cp src/jsx.d.ts dist/jsx.d.ts",
-    "dev": "tsup src/index.ts src/config.ts src/runtime.ts src/compiler.ts --format esm --dts --watch",
+    "build": "unbuild",
+    "dev": "unbuild --stub",
     "type-check": "tsc --noEmit"
   }
 }

package/dist/config.js

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

package/dist/index.js

@@ -1,26 +0,0 @@
-import {
-  DEFAULT_BUILD_CONFIG,
-  DEFAULT_CSSZYX_CONFIG,
-  DEFAULT_DEVELOPMENT_CONFIG,
-  DEFAULT_HYDRATION_CONFIG,
-  DEFAULT_PERFORMANCE_CONFIG,
-  DEFAULT_PRODUCTION_CONFIG,
-  getCurrentEnvironment
-} from "./chunk-IFAXISDF.js";
-import {
-  isCsszyxWindow
-} from "./chunk-QAJB64L5.js";
-
-// src/index.ts
-var VERSION = "0.0.0";
-export {
-  DEFAULT_BUILD_CONFIG,
-  DEFAULT_CSSZYX_CONFIG,
-  DEFAULT_DEVELOPMENT_CONFIG,
-  DEFAULT_HYDRATION_CONFIG,
-  DEFAULT_PERFORMANCE_CONFIG,
-  DEFAULT_PRODUCTION_CONFIG,
-  VERSION,
-  getCurrentEnvironment,
-  isCsszyxWindow
-};

package/dist/runtime.js

@@ -1,6 +0,0 @@
-import {
-  isCsszyxWindow
-} from "./chunk-QAJB64L5.js";
-export {
-  isCsszyxWindow
-};