@csszyx/types 0.7.0 → 0.8.0

package/dist/config.d.mts

@@ -0,0 +1,261 @@
+/**
+ * Configuration types for csszyx.
+ *
+ * This module defines all configuration interfaces and types used
+ * throughout the csszyx framework.
+ */
+/**
+ * Development mode configuration options.
+ */
+interface DevelopmentConfig {
+    /**
+     * 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;
+}
+/**
+ * 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;
+    /**
+     * 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
+     * for custom design tokens, enabling IntelliSense for user-defined colors, spacings, etc.
+     *
+     * Accepts a single glob/path or an array of globs/paths.
+     *
+     * @example ['src/styles/theme.css', 'src/styles/tokens.css']
+     */
+    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.
+ */
+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 = {
+    /**
+     * 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>;
+    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 { 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 };

package/dist/{chunk-IFAXISDF.js → config.mjs}

@@ -1,32 +1,32 @@
-// src/config.ts
-var DEFAULT_DEVELOPMENT_CONFIG = {
+const DEFAULT_DEVELOPMENT_CONFIG = {
   strictMode: false,
   debug: false
 };
-var DEFAULT_PRODUCTION_CONFIG = {
+const DEFAULT_PRODUCTION_CONFIG = {
   mangle: true,
   contentHashing: true,
   injectChecksum: true,
   incrementalBuild: true,
   minify: true
 };
-var DEFAULT_BUILD_CONFIG = {
+const DEFAULT_BUILD_CONFIG = {
   tailwindConfig: "tailwind.config.js",
   outputDir: ".csszyx",
   cacheDir: ".csszyx/cache",
-  astBudgetLimit: 5e4
+  astBudgetLimit: 5e4,
+  parser: "oxc"
 };
-var DEFAULT_HYDRATION_CONFIG = {
+const DEFAULT_HYDRATION_CONFIG = {
   strict: true,
   defaultRecoveryMode: null,
   auditLog: true
 };
-var DEFAULT_PERFORMANCE_CONFIG = {
+const DEFAULT_PERFORMANCE_CONFIG = {
   parallel: true,
   optimizeVariables: true,
   zeroRuntime: true
 };
-var DEFAULT_CSSZYX_CONFIG = {
+const DEFAULT_CSSZYX_CONFIG = {
   development: DEFAULT_DEVELOPMENT_CONFIG,
   production: DEFAULT_PRODUCTION_CONFIG,
   build: DEFAULT_BUILD_CONFIG,
@@ -44,12 +44,4 @@ function getCurrentEnvironment() {
   return "development";
 }
 
-export {
-  DEFAULT_DEVELOPMENT_CONFIG,
-  DEFAULT_PRODUCTION_CONFIG,
-  DEFAULT_BUILD_CONFIG,
-  DEFAULT_HYDRATION_CONFIG,
-  DEFAULT_PERFORMANCE_CONFIG,
-  DEFAULT_CSSZYX_CONFIG,
-  getCurrentEnvironment
-};
+export { DEFAULT_BUILD_CONFIG, DEFAULT_CSSZYX_CONFIG, DEFAULT_DEVELOPMENT_CONFIG, DEFAULT_HYDRATION_CONFIG, DEFAULT_PERFORMANCE_CONFIG, DEFAULT_PRODUCTION_CONFIG, getCurrentEnvironment };

package/dist/index.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+const config = require('./config.cjs');
+const runtime = require('./runtime.cjs');
+
+const VERSION = "0.0.0";
+
+exports.DEFAULT_BUILD_CONFIG = config.DEFAULT_BUILD_CONFIG;
+exports.DEFAULT_CSSZYX_CONFIG = config.DEFAULT_CSSZYX_CONFIG;
+exports.DEFAULT_DEVELOPMENT_CONFIG = config.DEFAULT_DEVELOPMENT_CONFIG;
+exports.DEFAULT_HYDRATION_CONFIG = config.DEFAULT_HYDRATION_CONFIG;
+exports.DEFAULT_PERFORMANCE_CONFIG = config.DEFAULT_PERFORMANCE_CONFIG;
+exports.DEFAULT_PRODUCTION_CONFIG = config.DEFAULT_PRODUCTION_CONFIG;
+exports.getCurrentEnvironment = config.getCurrentEnvironment;
+exports.isCsszyxWindow = runtime.isCsszyxWindow;
+exports.VERSION = VERSION;

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

@@ -1,8 +1,8 @@
-export { BuildConfig, CsszyxConfig, DEFAULT_BUILD_CONFIG, DEFAULT_CSSZYX_CONFIG, DEFAULT_DEVELOPMENT_CONFIG, DEFAULT_HYDRATION_CONFIG, DEFAULT_PERFORMANCE_CONFIG, DEFAULT_PRODUCTION_CONFIG, DevelopmentConfig, Environment, HydrationConfig, PartialCsszyxConfig, PerformanceConfig, ProductionConfig, getCurrentEnvironment } from './config.js';
-export { AuditLogEntry, ComponentPropsWithSz, CsszyxWindow, HydrationError, HydrationErrorType, MangleMap, MangleMapMetadata, PerformanceMetrics, RecoveryManifest, RecoveryMode, RuntimeState, SzProp, TokenData, VerificationResult, isCsszyxWindow } from './runtime.js';
-export { BuildPhase, BuildPhaseResult, BuildPhaseStatus, BuildResult, BuildStatistics, CacheEntry, CacheManager, CollisionResult, CompilerContext, CompilerOptions, CompilerPlugin, FileCompilationResult, GeneratedToken, MangleMapEntry, NodeLocation, TokenMetadata, TransformOptions, ValidationError, ValidationResult } from './compiler.js';
+export { BuildPhase, BuildPhaseResult, BuildPhaseStatus, BuildResult, BuildStatistics, CacheEntry, CacheManager, CollisionResult, CompilerContext, CompilerOptions, CompilerPlugin, FileCompilationResult, GeneratedToken, MangleMapEntry, NodeLocation, TokenMetadata, TransformOptions, ValidationError, ValidationResult } from './compiler.cjs';
+export { BuildConfig, CsszyxConfig, DEFAULT_BUILD_CONFIG, DEFAULT_CSSZYX_CONFIG, DEFAULT_DEVELOPMENT_CONFIG, DEFAULT_HYDRATION_CONFIG, DEFAULT_PERFORMANCE_CONFIG, DEFAULT_PRODUCTION_CONFIG, DevelopmentConfig, Environment, HydrationConfig, PartialCsszyxConfig, PerformanceConfig, ProductionConfig, getCurrentEnvironment } from './config.cjs';
 import { SzPropValue, RecoveryMode } from '@csszyx/compiler';
 export { SzPropValue, SzProps } from '@csszyx/compiler';
+export { AuditLogEntry, ComponentPropsWithSz, CsszyxWindow, HydrationError, HydrationErrorType, MangleMap, MangleMapMetadata, PerformanceMetrics, RecoveryManifest, RecoveryMode, RuntimeState, SzProp, TokenData, VerificationResult, isCsszyxWindow } from './runtime.cjs';
 
 /**
  * @csszyx/types - Core WASM Contract
@@ -60,60 +60,60 @@ interface CsszyxCorePkg {
 
 
 declare module 'react' {
-  /**
-   *
-   */
-
-  /**
-   *
-   */
-  interface HTMLAttributes<T> {
     /**
-     * csszyx styling prop — Tailwind CSS via object syntax or class string.
      *
-     * @example
-     * ```tsx
-     * <div sz={{ p: 4, bg: 'blue-500', hover: { bg: 'blue-700' } }} />
-     * <div sz="p-4 bg-blue-500 hover:bg-blue-700" />
-     * ```
      */
-    sz?: SzPropValue;
+
     /**
-     * Hydration recovery mode for the element. The csszyx unplugin
-     * compiles this attribute into a `data-sz-recovery-token` and
-     * registers the element in the SSR recovery manifest read by
-     * `@csszyx/runtime/verify` at hydration time.
-     *
-     * - `'csr'` — recovery permitted in both dev and production
-     * - `'dev-only'` — recovery permitted in development only;
-     *   stripped from the production manifest at build time.
      *
-     * @example
-     * ```tsx
-     * <section szRecover="csr">…</section>
-     * ```
      */
-    szRecover?: RecoveryMode;
-  }
+    interface HTMLAttributes<T> {
+        /**
+         * csszyx styling prop — Tailwind CSS via object syntax or class string.
+         *
+         * @example
+         * ```tsx
+         * <div sz={{ p: 4, bg: 'blue-500', hover: { bg: 'blue-700' } }} />
+         * <div sz="p-4 bg-blue-500 hover:bg-blue-700" />
+         * ```
+         */
+        sz?: SzPropValue;
+        /**
+         * Hydration recovery mode for the element. The csszyx unplugin
+         * compiles this attribute into a `data-sz-recovery-token` and
+         * registers the element in the SSR recovery manifest read by
+         * `@csszyx/runtime/verify` at hydration time.
+         *
+         * - `'csr'` — recovery permitted in both dev and production
+         * - `'dev-only'` — recovery permitted in development only;
+         *   stripped from the production manifest at build time.
+         *
+         * @example
+         * ```tsx
+         * <section szRecover="csr">…</section>
+         * ```
+         */
+        szRecover?: RecoveryMode;
+    }
 
-  /**
-   *
-   */
+    /**
+     *
+     */
 
-  /**
-   *
-   */
-  interface SVGAttributes<T> {
     /**
-     * csszyx styling prop — Tailwind CSS via object syntax or class string.
      *
-     * @example
-     * ```tsx
-     * <svg sz={{ fill: 'red-500', stroke: 'current' }} />
-     * ```
      */
-    sz?: SzPropValue;
-  }
+    interface SVGAttributes<T> {
+        /**
+         * csszyx styling prop — Tailwind CSS via object syntax or class string.
+         *
+         * @example
+         * ```tsx
+         * <svg sz={{ fill: 'red-500', stroke: 'current' }} />
+         * ```
+         */
+        sz?: SzPropValue;
+    }
 }
 
 /**
@@ -129,4 +129,5 @@ declare module 'react' {
  */
 declare const VERSION = "0.0.0";
 
-export { type CsszyxCorePkg, type CsszyxCoreWasm, VERSION };
+export { VERSION };
+export type { CsszyxCorePkg, CsszyxCoreWasm };

package/dist/index.d.mts

@@ -0,0 +1,133 @@
+export { BuildPhase, BuildPhaseResult, BuildPhaseStatus, BuildResult, BuildStatistics, CacheEntry, CacheManager, CollisionResult, CompilerContext, CompilerOptions, CompilerPlugin, FileCompilationResult, GeneratedToken, MangleMapEntry, NodeLocation, TokenMetadata, TransformOptions, ValidationError, ValidationResult } from './compiler.mjs';
+export { BuildConfig, CsszyxConfig, DEFAULT_BUILD_CONFIG, DEFAULT_CSSZYX_CONFIG, DEFAULT_DEVELOPMENT_CONFIG, DEFAULT_HYDRATION_CONFIG, DEFAULT_PERFORMANCE_CONFIG, DEFAULT_PRODUCTION_CONFIG, DevelopmentConfig, Environment, HydrationConfig, PartialCsszyxConfig, PerformanceConfig, ProductionConfig, getCurrentEnvironment } from './config.mjs';
+import { SzPropValue, RecoveryMode } from '@csszyx/compiler';
+export { SzPropValue, SzProps } from '@csszyx/compiler';
+export { AuditLogEntry, ComponentPropsWithSz, CsszyxWindow, HydrationError, HydrationErrorType, MangleMap, MangleMapMetadata, PerformanceMetrics, RecoveryManifest, RecoveryMode, RuntimeState, SzProp, TokenData, VerificationResult, isCsszyxWindow } from './runtime.mjs';
+
+/**
+ * @csszyx/types - Core WASM Contract
+ *
+ * This file defines the strict interface between the Rust/WASM core
+ * and the TypeScript world. This is the source of truth for "The Forge" workstream.
+ */
+/**
+ *
+ */
+interface CsszyxCoreWasm {
+    /**
+     * Encodes a numeric index into a compact tier-based class name (z, y, x...).
+     */
+    encode(index: number): string;
+    /**
+     * Generates a unique cryptographic recovery token for SSR hydration safety.
+     */
+    generate_token(componentName: string, filePath: string, line: number, column: number, recoveryMode: 'csr' | 'dev-only', buildId: string): string;
+    /**
+     * Verifies if a recovery token is valid for the given context.
+     */
+    verify_token(token: string, componentName: string, filePath: string, line: number, column: number, recoveryMode: 'csr' | 'dev-only', buildId: string): boolean;
+    /**
+     * Computes a dual-hash for a CSS class name to prevent collisions.
+     */
+    compute_dual_hash(className: string): string;
+    /**
+     * Returns the current version of the core engine.
+     */
+    version(): string;
+}
+/**
+ * The expected structure of the WASM initialization output.
+ */
+interface CsszyxCorePkg {
+    default: () => Promise<void>;
+    encode: (index: number) => string;
+    generate_token: (componentName: string, filePath: string, line: number, column: number, recoveryMode: string, buildId: string) => string;
+    verify_token: (token: string, componentName: string, filePath: string, line: number, column: number, recoveryMode: string, buildId: string) => boolean;
+    compute_dual_hash: (className: string) => string;
+    version: () => string;
+}
+
+/**
+ * JSX type augmentation for csszyx sz prop.
+ *
+ * This module extends React's JSX namespace to add the `sz` prop
+ * to all HTML elements. Types are re-exported from @csszyx/compiler
+ * for IntelliSense and autocompletion.
+ *
+ * @module @csszyx/types/jsx
+ */
+
+
+
+declare module 'react' {
+    /**
+     *
+     */
+
+    /**
+     *
+     */
+    interface HTMLAttributes<T> {
+        /**
+         * csszyx styling prop — Tailwind CSS via object syntax or class string.
+         *
+         * @example
+         * ```tsx
+         * <div sz={{ p: 4, bg: 'blue-500', hover: { bg: 'blue-700' } }} />
+         * <div sz="p-4 bg-blue-500 hover:bg-blue-700" />
+         * ```
+         */
+        sz?: SzPropValue;
+        /**
+         * Hydration recovery mode for the element. The csszyx unplugin
+         * compiles this attribute into a `data-sz-recovery-token` and
+         * registers the element in the SSR recovery manifest read by
+         * `@csszyx/runtime/verify` at hydration time.
+         *
+         * - `'csr'` — recovery permitted in both dev and production
+         * - `'dev-only'` — recovery permitted in development only;
+         *   stripped from the production manifest at build time.
+         *
+         * @example
+         * ```tsx
+         * <section szRecover="csr">…</section>
+         * ```
+         */
+        szRecover?: RecoveryMode;
+    }
+
+    /**
+     *
+     */
+
+    /**
+     *
+     */
+    interface SVGAttributes<T> {
+        /**
+         * csszyx styling prop — Tailwind CSS via object syntax or class string.
+         *
+         * @example
+         * ```tsx
+         * <svg sz={{ fill: 'red-500', stroke: 'current' }} />
+         * ```
+         */
+        sz?: SzPropValue;
+    }
+}
+
+/**
+ * @csszyx/types - Shared TypeScript types for csszyx.
+ *
+ * This package provides comprehensive type definitions used across
+ * the csszyx framework, including configuration, runtime, and compiler types.
+ *
+ * @module @csszyx/types
+ */
+/**
+ * Package version.
+ */
+declare const VERSION = "0.0.0";
+
+export { VERSION };
+export type { CsszyxCorePkg, CsszyxCoreWasm };

package/dist/index.mjs

@@ -0,0 +1,6 @@
+export { DEFAULT_BUILD_CONFIG, DEFAULT_CSSZYX_CONFIG, DEFAULT_DEVELOPMENT_CONFIG, DEFAULT_HYDRATION_CONFIG, DEFAULT_PERFORMANCE_CONFIG, DEFAULT_PRODUCTION_CONFIG, getCurrentEnvironment } from './config.mjs';
+export { isCsszyxWindow } from './runtime.mjs';
+
+const VERSION = "0.0.0";
+
+export { VERSION };

package/dist/jsx.d.ts

@@ -15,58 +15,58 @@ import type { RecoveryMode, SzProps, SzPropValue } from '@csszyx/compiler';
 export type { RecoveryMode, SzProps, SzPropValue };
 
 declare module 'react' {
-  /**
-   *
-   */
-
-  /**
-   *
-   */
-  interface HTMLAttributes<T> {
     /**
-     * csszyx styling prop — Tailwind CSS via object syntax or class string.
      *
-     * @example
-     * ```tsx
-     * <div sz={{ p: 4, bg: 'blue-500', hover: { bg: 'blue-700' } }} />
-     * <div sz="p-4 bg-blue-500 hover:bg-blue-700" />
-     * ```
      */
-    sz?: SzPropValue;
+
     /**
-     * Hydration recovery mode for the element. The csszyx unplugin
-     * compiles this attribute into a `data-sz-recovery-token` and
-     * registers the element in the SSR recovery manifest read by
-     * `@csszyx/runtime/verify` at hydration time.
-     *
-     * - `'csr'` — recovery permitted in both dev and production
-     * - `'dev-only'` — recovery permitted in development only;
-     *   stripped from the production manifest at build time.
      *
-     * @example
-     * ```tsx
-     * <section szRecover="csr">…</section>
-     * ```
      */
-    szRecover?: RecoveryMode;
-  }
+    interface HTMLAttributes<T> {
+        /**
+         * csszyx styling prop — Tailwind CSS via object syntax or class string.
+         *
+         * @example
+         * ```tsx
+         * <div sz={{ p: 4, bg: 'blue-500', hover: { bg: 'blue-700' } }} />
+         * <div sz="p-4 bg-blue-500 hover:bg-blue-700" />
+         * ```
+         */
+        sz?: SzPropValue;
+        /**
+         * Hydration recovery mode for the element. The csszyx unplugin
+         * compiles this attribute into a `data-sz-recovery-token` and
+         * registers the element in the SSR recovery manifest read by
+         * `@csszyx/runtime/verify` at hydration time.
+         *
+         * - `'csr'` — recovery permitted in both dev and production
+         * - `'dev-only'` — recovery permitted in development only;
+         *   stripped from the production manifest at build time.
+         *
+         * @example
+         * ```tsx
+         * <section szRecover="csr">…</section>
+         * ```
+         */
+        szRecover?: RecoveryMode;
+    }
 
-  /**
-   *
-   */
+    /**
+     *
+     */
 
-  /**
-   *
-   */
-  interface SVGAttributes<T> {
     /**
-     * csszyx styling prop — Tailwind CSS via object syntax or class string.
      *
-     * @example
-     * ```tsx
-     * <svg sz={{ fill: 'red-500', stroke: 'current' }} />
-     * ```
      */
-    sz?: SzPropValue;
-  }
+    interface SVGAttributes<T> {
+        /**
+         * csszyx styling prop — Tailwind CSS via object syntax or class string.
+         *
+         * @example
+         * ```tsx
+         * <svg sz={{ fill: 'red-500', stroke: 'current' }} />
+         * ```
+         */
+        sz?: SzPropValue;
+    }
 }