@csszyx/compiler 0.9.0 → 0.9.1

package/dist/index.d.cts

@@ -308,7 +308,38 @@ 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.
  */
@@ -331,6 +362,8 @@ interface SourceTransformResult {
     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.
@@ -406,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.
  *
@@ -13313,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 & {});
 }
 /**
  *
@@ -13354,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.
@@ -13414,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;
@@ -13526,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, OxcRustNotImplementedError, PROPERTY_CATEGORY_MAP, PropertyCategory, SzObject, VERSION, buildParentMap, createRecoveryToken, ensureRustTransformAvailable, generateRecoveryToken, getCSSVariableName, getPropertyCategory, hoistCSSVariables, injectRecoveryToken, isValidRecoveryMode, mergeOptions, parseManifest, serializeManifest, transformOxc, transformRust, transformRustBatch, 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, SourceTransformResult, SpacingProps, SpacingScale, SpacingValue, SvgProps, SzPropValue, SzProps, SzPropsBase, TableProps, TokenData, TokenMetadata, TransformOxcResult, TransformProps, TransformRustFile, 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,7 +308,38 @@ 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.
  */
@@ -331,6 +362,8 @@ interface SourceTransformResult {
     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.
@@ -406,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.
  *
@@ -13313,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 & {});
 }
 /**
  *
@@ -13354,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.
@@ -13414,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;
@@ -13526,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, OxcRustNotImplementedError, PROPERTY_CATEGORY_MAP, PropertyCategory, SzObject, VERSION, buildParentMap, createRecoveryToken, ensureRustTransformAvailable, generateRecoveryToken, getCSSVariableName, getPropertyCategory, hoistCSSVariables, injectRecoveryToken, isValidRecoveryMode, mergeOptions, parseManifest, serializeManifest, transformOxc, transformRust, transformRustBatch, 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, SourceTransformResult, SpacingProps, SpacingScale, SpacingValue, SvgProps, SzPropValue, SzProps, SzPropsBase, TableProps, TokenData, TokenMetadata, TransformOxcResult, TransformProps, TransformRustFile, 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 };