@csszyx/compiler 0.8.0 → 0.9.1

package/dist/index.d.cts

@@ -308,6 +308,62 @@ interface TransformSourceCodeOptions {
      * are still safe to transform.
      */
     astBudget?: number;
+    /**
+     * Opt into tiered CSS custom property names for parser paths that support
+     * the CSS variable system. Unsupported parser paths must preserve existing
+     * `--_sz-*` output until they explicitly port this option.
+     *
+     * @default false
+     */
+    mangleVars?: boolean;
+    /**
+     * Maximum cascade depth for component-tier CSS variable hoisting.
+     *
+     * Only used when `mangleVars` is enabled. Defaults to 5 to keep the
+     * invalidation surface bounded.
+     */
+    mangleVarHoistMaxDepth?: number;
+    /**
+     * Explicit app-owned global CSS custom-property aliases. Parser paths that
+     * support Phase H rewrite exact static sz string values from original
+     * token names to aliases, for example `--brand-primary` -> `---gz`.
+     */
+    globalVarAliases?: GlobalVarAliasTableInput;
+}
+/**
+ * Accepted input shapes for global CSS custom-property alias tables.
+ */
+type GlobalVarAliasTableInput = ReadonlyMap<string, string> | ReadonlyArray<readonly [string, string]> | Readonly<Record<string, string>>;
+/**
+ * CSS custom-property mangle metadata. Most originals map to one mangled name,
+ * but the same original can legitimately appear in both scoped and hoisted
+ * tiers in one build, e.g. `--_sz-p` -> `--sz` and `--cz`.
+ */
+type CssVariableMangleValue = string | string[];
+/**
+ * Source transform result shared by the Babel and oxc parser paths.
+ */
+interface SourceTransformResult {
+    /** Rewritten source code. */
+    code: string;
+    /** Whether csszyx changed the source. */
+    transformed: boolean;
+    /** Whether the source needs the _sz runtime helper. */
+    usesRuntime: boolean;
+    /** Whether the source needs the _szMerge runtime helper. */
+    usesMerge: boolean;
+    /** Whether the source needs the color-var runtime helper. */
+    usesColorVar: boolean;
+    /** Classes generated from sz syntax. */
+    classes: Set<string>;
+    /** Raw className/class strings collected for Tailwind discovery only. */
+    rawClassNames: Set<string>;
+    /** Compiler diagnostics to emit in development. */
+    diagnostics: string[];
+    /** Recovery tokens emitted by szRecover attributes. */
+    recoveryTokens: Map<string, TokenData>;
+    /** CSS custom property original-to-mangled names emitted by mangleVars. */
+    cssVariableMap: Map<string, CssVariableMangleValue>;
 }
 /**
  * Transforms all sz props in a source code string into Tailwind classNames.
@@ -321,17 +377,7 @@ interface TransformSourceCodeOptions {
  * @throws {ASTBudgetExceededError} when the file's AST exceeds the
  *   effective budget (`options.astBudget` or {@link AST_BUDGET}).
  */
-declare function transformSourceCode(source: string, filename?: string, options?: TransformSourceCodeOptions): {
-    code: string;
-    transformed: boolean;
-    usesRuntime: boolean;
-    usesMerge: boolean;
-    usesColorVar: boolean;
-    classes: Set<string>;
-    rawClassNames: Set<string>;
-    diagnostics: string[];
-    recoveryTokens: Map<string, TokenData>;
-};
+declare function transformSourceCode(source: string, filename?: string, options?: TransformSourceCodeOptions): SourceTransformResult;
 
 /**
  * Core Compiler class for csszyx.
@@ -393,6 +439,44 @@ declare class CsszyxCompiler {
     }): string;
 }
 
+/** Kind of out-of-band global custom-property usage. */
+type GlobalVarUsageKind = 'style-set-property' | 'style-get-property' | 'style-remove-property' | 'jsx-style-key' | 'class-string-var-reference';
+/** Source location for one out-of-band usage. */
+interface GlobalVarUsageLocation {
+    /** Source file path. */
+    filePath: string;
+    /** 1-based source line. */
+    line: number;
+    /** 1-based source column. */
+    column: number;
+}
+/** One out-of-band global custom-property usage diagnostic. */
+interface GlobalVarUsageDiagnostic {
+    /** Usage kind. */
+    kind: GlobalVarUsageKind;
+    /** Custom-property name including leading `--`. */
+    name: string;
+    /** Source location. */
+    location: GlobalVarUsageLocation;
+    /** Human-readable message. */
+    message: string;
+}
+/** Options for JS/JSX global variable usage scanning. */
+interface ScanGlobalVarUsagesOptions {
+    /** Candidate tokens to report. Undefined reports every concrete token. */
+    tokens?: Iterable<string>;
+}
+/**
+ * Scans JS/TS/JSX/TSX source for global custom-property usages csszyx does not
+ * currently rewrite.
+ *
+ * @param source Source text.
+ * @param filename Source filename.
+ * @param options Scanner options.
+ * @returns Out-of-band usage diagnostics.
+ */
+declare function scanGlobalVarUsages(source: string, filename?: string, options?: ScanGlobalVarUsagesOptions): GlobalVarUsageDiagnostic[];
+
 /**
  * CSS Variable Hoisting — deduplicates identical CSS variables across sibling elements.
  *
@@ -516,31 +600,8 @@ declare function getCSSVariableName(property: string, variantPrefix?: string): s
  * API mapping referenced throughout this file.
  */
 
-/**
- * Result shape returned by both `transformSourceCode` (Babel) and the
- * future `transformOxc`. Kept in lock-step so the parity harness can
- * diff results without conditional logic.
- */
-interface TransformOxcResult {
-    /** Rewritten source — equal to input when `transformed === false`. */
-    code: string;
-    /** True when at least one sz/szRecover/_sz mutation was applied. */
-    transformed: boolean;
-    /** Did the file pull in `_sz` runtime helper? */
-    usesRuntime: boolean;
-    /** Did the file pull in `_szMerge` runtime helper? */
-    usesMerge: boolean;
-    /** Did the file use color-var helpers? */
-    usesColorVar: boolean;
-    /** Class names emitted by the compiler — drives the mangle map. */
-    classes: Set<string>;
-    /** Hand-written `className="..."` strings — TW JIT safelist only. */
-    rawClassNames: Set<string>;
-    /** Dev-mode warnings emitted during transform. */
-    diagnostics: string[];
-    /** Recovery tokens emitted by szRecover attributes. */
-    recoveryTokens: Map<string, TokenData>;
-}
+/** Result shape returned by the oxc parser path. */
+type TransformOxcResult = SourceTransformResult;
 /**
  * Thrown when a caller hits a code path the current slice does not yet
  * implement. The parity harness catches this and reports the fixture
@@ -564,6 +625,62 @@ declare class OxcNotImplementedError extends Error {
  */
 declare function transformOxc(source: string, filename?: string, options?: TransformSourceCodeOptions): TransformOxcResult;
 
+/**
+ * Source file passed to the Rust native batch transform.
+ */
+interface TransformRustFile {
+    /** Source filename for diagnostics and recovery-token stability. */
+    filename?: string;
+    /** Source module contents. */
+    source: string;
+}
+/**
+ * Thrown when the Rust native transform cannot execute for the current host.
+ *
+ * The class name is kept for compatibility with earlier scaffold-era callers.
+ */
+declare class OxcRustNotImplementedError extends Error {
+    /**
+     * @param detail Native loader or transform failure detail.
+     */
+    constructor(detail: string);
+}
+/**
+ * Transform source through the Rust native engine.
+ *
+ * @param source Source module contents.
+ * @param filename Source filename for diagnostics.
+ * @param options Compiler options.
+ * @returns Transform result.
+ * @throws {OxcRustNotImplementedError} when the native addon is unavailable.
+ */
+declare function transformRust(source: string, filename?: string, options?: TransformSourceCodeOptions): SourceTransformResult;
+/**
+ * Verify that the native Rust transform binding can be loaded.
+ *
+ * This is intentionally separate from `transformRust()` so build integrations
+ * can validate the explicit `rust` parser contract before serving cached
+ * output. If the native addon is missing, `rust` must fail loudly instead of
+ * returning a stale cache entry.
+ *
+ * @throws {OxcRustNotImplementedError} when the native addon is unavailable.
+ */
+declare function ensureRustTransformAvailable(): void;
+/**
+ * Transform a batch of files through the Rust native engine in one napi call.
+ *
+ * This is the compiler-level wrapper around `@csszyx/core/native`'s batch API.
+ * It keeps JS callers on the normal `SourceTransformResult` contract while
+ * preserving the Rust core's FFI amortization for benchmarks and future build
+ * integrations.
+ *
+ * @param files Source files to transform.
+ * @param options Compiler options reserved for future native config plumbing.
+ * @returns One transform result per input file, in input order.
+ * @throws {OxcRustNotImplementedError} when the native addon is unavailable.
+ */
+declare function transformRustBatch(files: readonly TransformRustFile[], options?: TransformSourceCodeOptions): SourceTransformResult[];
+
 interface StandardLonghandProperties<TLength = (string & {}) | 0, TTime = string & {}> {
   /**
    * This feature is not Baseline because it does not work in some of the most widely-used browsers.
@@ -13267,6 +13384,18 @@ interface InteractivityProps {
     select?: 'none' | 'text' | 'all' | 'auto';
     /** @see https://tailwindcss.com/docs/will-change */
     willChange?: 'auto' | 'scroll' | 'contents' | 'transform' | (string & {});
+    /** @see https://tailwindcss.com/docs/scrollbar-width */
+    scrollbar?: 'auto' | 'thin' | 'none';
+    /** @see https://tailwindcss.com/docs/scrollbar-color */
+    scrollbarThumb?: ColorPropValue;
+    /** @see https://tailwindcss.com/docs/scrollbar-color */
+    scrollbarTrack?: ColorPropValue;
+    /** @see https://tailwindcss.com/docs/scrollbar-gutter */
+    scrollbarGutter?: 'auto' | 'stable' | 'both';
+    /** @see https://tailwindcss.com/docs/zoom */
+    zoom?: number | (string & {});
+    /** @see https://tailwindcss.com/docs/tab-size */
+    tabSize?: number | (string & {});
 }
 /**
  *
@@ -13308,6 +13437,12 @@ interface MaskProps {
     maskRepeat?: 'repeat' | 'no-repeat' | 'repeat-x' | 'repeat-y' | 'round' | 'space';
     /** CSS mask-type (shape-rendering) */
     maskShape?: 'alpha' | 'luminance';
+    /** Mask gradient from color stop (v4.1) */
+    maskFrom?: ColorPropValue;
+    /** Mask gradient via color stop (v4.1) */
+    maskVia?: ColorPropValue;
+    /** Mask gradient to color stop (v4.1) */
+    maskTo?: ColorPropValue;
 }
 /**
  * Variant modifiers for pseudo-classes, breakpoints, and states.
@@ -13368,6 +13503,17 @@ interface VariantModifiers {
     motionSafe?: SzPropsBase;
     contrastMore?: SzPropsBase;
     contrastLess?: SzPropsBase;
+    pointerFine?: SzPropsBase;
+    pointerCoarse?: SzPropsBase;
+    pointerNone?: SzPropsBase;
+    anyPointerFine?: SzPropsBase;
+    anyPointerCoarse?: SzPropsBase;
+    anyPointerNone?: SzPropsBase;
+    userValid?: SzPropsBase;
+    userInvalid?: SzPropsBase;
+    detailsContent?: SzPropsBase;
+    invertedColors?: SzPropsBase;
+    noscript?: SzPropsBase;
     print?: SzPropsBase;
     portrait?: SzPropsBase;
     landscape?: SzPropsBase;
@@ -13480,5 +13626,5 @@ declare const DEFAULT_COMPILER_OPTIONS: Required<CompilerOptions>;
  */
 declare function mergeOptions(options?: Partial<CompilerOptions>): Required<CompilerOptions>;
 
-export { COLOR_PROPERTIES, CsszyxCompiler, DEFAULT_COMPILER_OPTIONS, ManifestBuilder, OxcNotImplementedError, PROPERTY_CATEGORY_MAP, PropertyCategory, SzObject, VERSION, buildParentMap, createRecoveryToken, generateRecoveryToken, getCSSVariableName, getPropertyCategory, hoistCSSVariables, injectRecoveryToken, isValidRecoveryMode, mergeOptions, parseManifest, serializeManifest, transformOxc, transformSourceCode, validateManifest, validateSzRecover };
-export type { BackgroundProps, BorderProps, BorderRadiusValue, CSSVarUsage, ColorName, ColorObjectValue, ColorPropValue, ColorShade, ColorValue, CompilerOptions, ContainerSize, CustomTheme, EffectsProps, FilterProps, FlexboxGridProps, FractionValue, InteractivityProps, LayoutProps, NegativeSpacingValue, RecoveryManifest, RecoveryMode, RecoveryToken, ShadowValue, SizingProps, SpacingProps, SpacingScale, SpacingValue, SvgProps, SzPropValue, SzProps, SzPropsBase, TableProps, TokenData, TokenMetadata, TransformOxcResult, TransformProps, TransitionAnimationProps, TypographyProps, VariantModifiers };
+export { COLOR_PROPERTIES, CsszyxCompiler, DEFAULT_COMPILER_OPTIONS, ManifestBuilder, OxcNotImplementedError, OxcRustNotImplementedError, PROPERTY_CATEGORY_MAP, PropertyCategory, SzObject, VERSION, buildParentMap, createRecoveryToken, ensureRustTransformAvailable, generateRecoveryToken, getCSSVariableName, getPropertyCategory, hoistCSSVariables, injectRecoveryToken, isValidRecoveryMode, mergeOptions, parseManifest, scanGlobalVarUsages, serializeManifest, transformOxc, transformRust, transformRustBatch, transformSourceCode, validateManifest, validateSzRecover };
+export type { BackgroundProps, BorderProps, BorderRadiusValue, CSSVarUsage, ColorName, ColorObjectValue, ColorPropValue, ColorShade, ColorValue, CompilerOptions, ContainerSize, CssVariableMangleValue, CustomTheme, EffectsProps, FilterProps, FlexboxGridProps, FractionValue, GlobalVarAliasTableInput, GlobalVarUsageDiagnostic, GlobalVarUsageKind, GlobalVarUsageLocation, InteractivityProps, LayoutProps, NegativeSpacingValue, RecoveryManifest, RecoveryMode, RecoveryToken, ScanGlobalVarUsagesOptions, ShadowValue, SizingProps, SourceTransformResult, SpacingProps, SpacingScale, SpacingValue, SvgProps, SzPropValue, SzProps, SzPropsBase, TableProps, TokenData, TokenMetadata, TransformOxcResult, TransformProps, TransformRustFile, TransformSourceCodeOptions, TransitionAnimationProps, TypographyProps, VariantModifiers };

package/dist/index.d.mts

@@ -308,6 +308,62 @@ interface TransformSourceCodeOptions {
      * are still safe to transform.
      */
     astBudget?: number;
+    /**
+     * Opt into tiered CSS custom property names for parser paths that support
+     * the CSS variable system. Unsupported parser paths must preserve existing
+     * `--_sz-*` output until they explicitly port this option.
+     *
+     * @default false
+     */
+    mangleVars?: boolean;
+    /**
+     * Maximum cascade depth for component-tier CSS variable hoisting.
+     *
+     * Only used when `mangleVars` is enabled. Defaults to 5 to keep the
+     * invalidation surface bounded.
+     */
+    mangleVarHoistMaxDepth?: number;
+    /**
+     * Explicit app-owned global CSS custom-property aliases. Parser paths that
+     * support Phase H rewrite exact static sz string values from original
+     * token names to aliases, for example `--brand-primary` -> `---gz`.
+     */
+    globalVarAliases?: GlobalVarAliasTableInput;
+}
+/**
+ * Accepted input shapes for global CSS custom-property alias tables.
+ */
+type GlobalVarAliasTableInput = ReadonlyMap<string, string> | ReadonlyArray<readonly [string, string]> | Readonly<Record<string, string>>;
+/**
+ * CSS custom-property mangle metadata. Most originals map to one mangled name,
+ * but the same original can legitimately appear in both scoped and hoisted
+ * tiers in one build, e.g. `--_sz-p` -> `--sz` and `--cz`.
+ */
+type CssVariableMangleValue = string | string[];
+/**
+ * Source transform result shared by the Babel and oxc parser paths.
+ */
+interface SourceTransformResult {
+    /** Rewritten source code. */
+    code: string;
+    /** Whether csszyx changed the source. */
+    transformed: boolean;
+    /** Whether the source needs the _sz runtime helper. */
+    usesRuntime: boolean;
+    /** Whether the source needs the _szMerge runtime helper. */
+    usesMerge: boolean;
+    /** Whether the source needs the color-var runtime helper. */
+    usesColorVar: boolean;
+    /** Classes generated from sz syntax. */
+    classes: Set<string>;
+    /** Raw className/class strings collected for Tailwind discovery only. */
+    rawClassNames: Set<string>;
+    /** Compiler diagnostics to emit in development. */
+    diagnostics: string[];
+    /** Recovery tokens emitted by szRecover attributes. */
+    recoveryTokens: Map<string, TokenData>;
+    /** CSS custom property original-to-mangled names emitted by mangleVars. */
+    cssVariableMap: Map<string, CssVariableMangleValue>;
 }
 /**
  * Transforms all sz props in a source code string into Tailwind classNames.
@@ -321,17 +377,7 @@ interface TransformSourceCodeOptions {
  * @throws {ASTBudgetExceededError} when the file's AST exceeds the
  *   effective budget (`options.astBudget` or {@link AST_BUDGET}).
  */
-declare function transformSourceCode(source: string, filename?: string, options?: TransformSourceCodeOptions): {
-    code: string;
-    transformed: boolean;
-    usesRuntime: boolean;
-    usesMerge: boolean;
-    usesColorVar: boolean;
-    classes: Set<string>;
-    rawClassNames: Set<string>;
-    diagnostics: string[];
-    recoveryTokens: Map<string, TokenData>;
-};
+declare function transformSourceCode(source: string, filename?: string, options?: TransformSourceCodeOptions): SourceTransformResult;
 
 /**
  * Core Compiler class for csszyx.
@@ -393,6 +439,44 @@ declare class CsszyxCompiler {
     }): string;
 }
 
+/** Kind of out-of-band global custom-property usage. */
+type GlobalVarUsageKind = 'style-set-property' | 'style-get-property' | 'style-remove-property' | 'jsx-style-key' | 'class-string-var-reference';
+/** Source location for one out-of-band usage. */
+interface GlobalVarUsageLocation {
+    /** Source file path. */
+    filePath: string;
+    /** 1-based source line. */
+    line: number;
+    /** 1-based source column. */
+    column: number;
+}
+/** One out-of-band global custom-property usage diagnostic. */
+interface GlobalVarUsageDiagnostic {
+    /** Usage kind. */
+    kind: GlobalVarUsageKind;
+    /** Custom-property name including leading `--`. */
+    name: string;
+    /** Source location. */
+    location: GlobalVarUsageLocation;
+    /** Human-readable message. */
+    message: string;
+}
+/** Options for JS/JSX global variable usage scanning. */
+interface ScanGlobalVarUsagesOptions {
+    /** Candidate tokens to report. Undefined reports every concrete token. */
+    tokens?: Iterable<string>;
+}
+/**
+ * Scans JS/TS/JSX/TSX source for global custom-property usages csszyx does not
+ * currently rewrite.
+ *
+ * @param source Source text.
+ * @param filename Source filename.
+ * @param options Scanner options.
+ * @returns Out-of-band usage diagnostics.
+ */
+declare function scanGlobalVarUsages(source: string, filename?: string, options?: ScanGlobalVarUsagesOptions): GlobalVarUsageDiagnostic[];
+
 /**
  * CSS Variable Hoisting — deduplicates identical CSS variables across sibling elements.
  *
@@ -516,31 +600,8 @@ declare function getCSSVariableName(property: string, variantPrefix?: string): s
  * API mapping referenced throughout this file.
  */
 
-/**
- * Result shape returned by both `transformSourceCode` (Babel) and the
- * future `transformOxc`. Kept in lock-step so the parity harness can
- * diff results without conditional logic.
- */
-interface TransformOxcResult {
-    /** Rewritten source — equal to input when `transformed === false`. */
-    code: string;
-    /** True when at least one sz/szRecover/_sz mutation was applied. */
-    transformed: boolean;
-    /** Did the file pull in `_sz` runtime helper? */
-    usesRuntime: boolean;
-    /** Did the file pull in `_szMerge` runtime helper? */
-    usesMerge: boolean;
-    /** Did the file use color-var helpers? */
-    usesColorVar: boolean;
-    /** Class names emitted by the compiler — drives the mangle map. */
-    classes: Set<string>;
-    /** Hand-written `className="..."` strings — TW JIT safelist only. */
-    rawClassNames: Set<string>;
-    /** Dev-mode warnings emitted during transform. */
-    diagnostics: string[];
-    /** Recovery tokens emitted by szRecover attributes. */
-    recoveryTokens: Map<string, TokenData>;
-}
+/** Result shape returned by the oxc parser path. */
+type TransformOxcResult = SourceTransformResult;
 /**
  * Thrown when a caller hits a code path the current slice does not yet
  * implement. The parity harness catches this and reports the fixture
@@ -564,6 +625,62 @@ declare class OxcNotImplementedError extends Error {
  */
 declare function transformOxc(source: string, filename?: string, options?: TransformSourceCodeOptions): TransformOxcResult;
 
+/**
+ * Source file passed to the Rust native batch transform.
+ */
+interface TransformRustFile {
+    /** Source filename for diagnostics and recovery-token stability. */
+    filename?: string;
+    /** Source module contents. */
+    source: string;
+}
+/**
+ * Thrown when the Rust native transform cannot execute for the current host.
+ *
+ * The class name is kept for compatibility with earlier scaffold-era callers.
+ */
+declare class OxcRustNotImplementedError extends Error {
+    /**
+     * @param detail Native loader or transform failure detail.
+     */
+    constructor(detail: string);
+}
+/**
+ * Transform source through the Rust native engine.
+ *
+ * @param source Source module contents.
+ * @param filename Source filename for diagnostics.
+ * @param options Compiler options.
+ * @returns Transform result.
+ * @throws {OxcRustNotImplementedError} when the native addon is unavailable.
+ */
+declare function transformRust(source: string, filename?: string, options?: TransformSourceCodeOptions): SourceTransformResult;
+/**
+ * Verify that the native Rust transform binding can be loaded.
+ *
+ * This is intentionally separate from `transformRust()` so build integrations
+ * can validate the explicit `rust` parser contract before serving cached
+ * output. If the native addon is missing, `rust` must fail loudly instead of
+ * returning a stale cache entry.
+ *
+ * @throws {OxcRustNotImplementedError} when the native addon is unavailable.
+ */
+declare function ensureRustTransformAvailable(): void;
+/**
+ * Transform a batch of files through the Rust native engine in one napi call.
+ *
+ * This is the compiler-level wrapper around `@csszyx/core/native`'s batch API.
+ * It keeps JS callers on the normal `SourceTransformResult` contract while
+ * preserving the Rust core's FFI amortization for benchmarks and future build
+ * integrations.
+ *
+ * @param files Source files to transform.
+ * @param options Compiler options reserved for future native config plumbing.
+ * @returns One transform result per input file, in input order.
+ * @throws {OxcRustNotImplementedError} when the native addon is unavailable.
+ */
+declare function transformRustBatch(files: readonly TransformRustFile[], options?: TransformSourceCodeOptions): SourceTransformResult[];
+
 interface StandardLonghandProperties<TLength = (string & {}) | 0, TTime = string & {}> {
   /**
    * This feature is not Baseline because it does not work in some of the most widely-used browsers.
@@ -13267,6 +13384,18 @@ interface InteractivityProps {
     select?: 'none' | 'text' | 'all' | 'auto';
     /** @see https://tailwindcss.com/docs/will-change */
     willChange?: 'auto' | 'scroll' | 'contents' | 'transform' | (string & {});
+    /** @see https://tailwindcss.com/docs/scrollbar-width */
+    scrollbar?: 'auto' | 'thin' | 'none';
+    /** @see https://tailwindcss.com/docs/scrollbar-color */
+    scrollbarThumb?: ColorPropValue;
+    /** @see https://tailwindcss.com/docs/scrollbar-color */
+    scrollbarTrack?: ColorPropValue;
+    /** @see https://tailwindcss.com/docs/scrollbar-gutter */
+    scrollbarGutter?: 'auto' | 'stable' | 'both';
+    /** @see https://tailwindcss.com/docs/zoom */
+    zoom?: number | (string & {});
+    /** @see https://tailwindcss.com/docs/tab-size */
+    tabSize?: number | (string & {});
 }
 /**
  *
@@ -13308,6 +13437,12 @@ interface MaskProps {
     maskRepeat?: 'repeat' | 'no-repeat' | 'repeat-x' | 'repeat-y' | 'round' | 'space';
     /** CSS mask-type (shape-rendering) */
     maskShape?: 'alpha' | 'luminance';
+    /** Mask gradient from color stop (v4.1) */
+    maskFrom?: ColorPropValue;
+    /** Mask gradient via color stop (v4.1) */
+    maskVia?: ColorPropValue;
+    /** Mask gradient to color stop (v4.1) */
+    maskTo?: ColorPropValue;
 }
 /**
  * Variant modifiers for pseudo-classes, breakpoints, and states.
@@ -13368,6 +13503,17 @@ interface VariantModifiers {
     motionSafe?: SzPropsBase;
     contrastMore?: SzPropsBase;
     contrastLess?: SzPropsBase;
+    pointerFine?: SzPropsBase;
+    pointerCoarse?: SzPropsBase;
+    pointerNone?: SzPropsBase;
+    anyPointerFine?: SzPropsBase;
+    anyPointerCoarse?: SzPropsBase;
+    anyPointerNone?: SzPropsBase;
+    userValid?: SzPropsBase;
+    userInvalid?: SzPropsBase;
+    detailsContent?: SzPropsBase;
+    invertedColors?: SzPropsBase;
+    noscript?: SzPropsBase;
     print?: SzPropsBase;
     portrait?: SzPropsBase;
     landscape?: SzPropsBase;
@@ -13480,5 +13626,5 @@ declare const DEFAULT_COMPILER_OPTIONS: Required<CompilerOptions>;
  */
 declare function mergeOptions(options?: Partial<CompilerOptions>): Required<CompilerOptions>;
 
-export { COLOR_PROPERTIES, CsszyxCompiler, DEFAULT_COMPILER_OPTIONS, ManifestBuilder, OxcNotImplementedError, PROPERTY_CATEGORY_MAP, PropertyCategory, SzObject, VERSION, buildParentMap, createRecoveryToken, generateRecoveryToken, getCSSVariableName, getPropertyCategory, hoistCSSVariables, injectRecoveryToken, isValidRecoveryMode, mergeOptions, parseManifest, serializeManifest, transformOxc, transformSourceCode, validateManifest, validateSzRecover };
-export type { BackgroundProps, BorderProps, BorderRadiusValue, CSSVarUsage, ColorName, ColorObjectValue, ColorPropValue, ColorShade, ColorValue, CompilerOptions, ContainerSize, CustomTheme, EffectsProps, FilterProps, FlexboxGridProps, FractionValue, InteractivityProps, LayoutProps, NegativeSpacingValue, RecoveryManifest, RecoveryMode, RecoveryToken, ShadowValue, SizingProps, SpacingProps, SpacingScale, SpacingValue, SvgProps, SzPropValue, SzProps, SzPropsBase, TableProps, TokenData, TokenMetadata, TransformOxcResult, TransformProps, TransitionAnimationProps, TypographyProps, VariantModifiers };
+export { COLOR_PROPERTIES, CsszyxCompiler, DEFAULT_COMPILER_OPTIONS, ManifestBuilder, OxcNotImplementedError, OxcRustNotImplementedError, PROPERTY_CATEGORY_MAP, PropertyCategory, SzObject, VERSION, buildParentMap, createRecoveryToken, ensureRustTransformAvailable, generateRecoveryToken, getCSSVariableName, getPropertyCategory, hoistCSSVariables, injectRecoveryToken, isValidRecoveryMode, mergeOptions, parseManifest, scanGlobalVarUsages, serializeManifest, transformOxc, transformRust, transformRustBatch, transformSourceCode, validateManifest, validateSzRecover };
+export type { BackgroundProps, BorderProps, BorderRadiusValue, CSSVarUsage, ColorName, ColorObjectValue, ColorPropValue, ColorShade, ColorValue, CompilerOptions, ContainerSize, CssVariableMangleValue, CustomTheme, EffectsProps, FilterProps, FlexboxGridProps, FractionValue, GlobalVarAliasTableInput, GlobalVarUsageDiagnostic, GlobalVarUsageKind, GlobalVarUsageLocation, InteractivityProps, LayoutProps, NegativeSpacingValue, RecoveryManifest, RecoveryMode, RecoveryToken, ScanGlobalVarUsagesOptions, ShadowValue, SizingProps, SourceTransformResult, SpacingProps, SpacingScale, SpacingValue, SvgProps, SzPropValue, SzProps, SzPropsBase, TableProps, TokenData, TokenMetadata, TransformOxcResult, TransformProps, TransformRustFile, TransformSourceCodeOptions, TransitionAnimationProps, TypographyProps, VariantModifiers };