@csszyx/compiler 0.10.8 → 0.10.10

package/dist/index.d.cts

@@ -581,6 +581,28 @@ declare const COLOR_PROPERTIES: Set<string>;
  */
 declare function getCSSVariableName(property: string, variantPrefix?: string): string;
 
+/**
+ * Deterministic, locale-independent ascending sort for string collections.
+ *
+ * A bare `Array.prototype.sort()` coerces elements to strings, so it silently
+ * mis-orders numbers (`[10, 9]` → `[10, 9]`). Every ordered collection in this
+ * codebase is a set of identifiers — class names, mangle tokens, filenames,
+ * variant names, CSS-variable references — so the correct sort is lexicographic
+ * AND locale-independent (a locale-aware `localeCompare` would make build output
+ * order depend on the runner's locale and break reproducibility).
+ *
+ * This helper encodes exactly that, and its `T extends string` bound makes the
+ * intent compiler-checked: passing a `number[]` (or a `(string | number)[]`) is a
+ * type error, so a future numeric sort cannot slip through as a bare `.sort()`.
+ * The `no-restricted-syntax` lint rule forbids bare `.sort()` to route every sort
+ * through here or an explicit comparator.
+ *
+ * @template T - the (string) element type.
+ * @param values - the strings to sort (any iterable; not mutated).
+ * @returns a new array sorted ascending by UTF-16 code unit.
+ */
+declare function sortStrings<T extends string>(values: Iterable<T>): T[];
+
 /**
  * Phase D production transform — `transformOxc()` is the oxc-parser +
  * magic-string replacement for `transformSourceCode()` (Babel). The
@@ -13590,6 +13612,24 @@ type SzArrayElement = SzProps | false | null | undefined;
  * ```
  */
 type SzPropValue = string | SzProps | SzArrayElement[];
+/**
+ * Value of the `szs` prop — a map of a component's slot names to sz values, so a
+ * consumer styles the parts a compound component renders internally. The build
+ * transform compiles each slot VALUE to its Tailwind class string (keeping the
+ * key), safelists and mangles the classes exactly like `sz`, and the component
+ * forwards `props.szs?.<slot>` into the matching child's `className`.
+ *
+ * Component authors declare their slot set so consumers get autocompletion and
+ * typo checking:
+ *
+ * @example
+ * ```tsx
+ * type CardProps = { szs?: Szs<'header' | 'icon'> };
+ * // consumer:
+ * <Card szs={{ header: { bg: 'gray-100' }, icon: { color: 'red-500' } }} />
+ * ```
+ */
+type Szs<Slots extends string = string> = Partial<Record<Slots, SzPropValue>>;
 
 /**
  * @csszyx/compiler - TypeScript compiler package for csszyx.
@@ -13639,5 +13679,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, isRustTransformAvailable, 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 };
+export { COLOR_PROPERTIES, CsszyxCompiler, DEFAULT_COMPILER_OPTIONS, ManifestBuilder, OxcNotImplementedError, OxcRustNotImplementedError, PROPERTY_CATEGORY_MAP, PropertyCategory, SzObject, VERSION, buildParentMap, createRecoveryToken, ensureRustTransformAvailable, generateRecoveryToken, getCSSVariableName, getPropertyCategory, hoistCSSVariables, injectRecoveryToken, isRustTransformAvailable, isValidRecoveryMode, mergeOptions, parseManifest, scanGlobalVarUsages, serializeManifest, sortStrings, 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, Szs, TableProps, TokenData, TokenMetadata, TransformOxcResult, TransformProps, TransformRustFile, TransformSourceCodeOptions, TransitionAnimationProps, TypographyProps, VariantModifiers };

package/dist/index.d.mts

@@ -581,6 +581,28 @@ declare const COLOR_PROPERTIES: Set<string>;
  */
 declare function getCSSVariableName(property: string, variantPrefix?: string): string;
 
+/**
+ * Deterministic, locale-independent ascending sort for string collections.
+ *
+ * A bare `Array.prototype.sort()` coerces elements to strings, so it silently
+ * mis-orders numbers (`[10, 9]` → `[10, 9]`). Every ordered collection in this
+ * codebase is a set of identifiers — class names, mangle tokens, filenames,
+ * variant names, CSS-variable references — so the correct sort is lexicographic
+ * AND locale-independent (a locale-aware `localeCompare` would make build output
+ * order depend on the runner's locale and break reproducibility).
+ *
+ * This helper encodes exactly that, and its `T extends string` bound makes the
+ * intent compiler-checked: passing a `number[]` (or a `(string | number)[]`) is a
+ * type error, so a future numeric sort cannot slip through as a bare `.sort()`.
+ * The `no-restricted-syntax` lint rule forbids bare `.sort()` to route every sort
+ * through here or an explicit comparator.
+ *
+ * @template T - the (string) element type.
+ * @param values - the strings to sort (any iterable; not mutated).
+ * @returns a new array sorted ascending by UTF-16 code unit.
+ */
+declare function sortStrings<T extends string>(values: Iterable<T>): T[];
+
 /**
  * Phase D production transform — `transformOxc()` is the oxc-parser +
  * magic-string replacement for `transformSourceCode()` (Babel). The
@@ -13590,6 +13612,24 @@ type SzArrayElement = SzProps | false | null | undefined;
  * ```
  */
 type SzPropValue = string | SzProps | SzArrayElement[];
+/**
+ * Value of the `szs` prop — a map of a component's slot names to sz values, so a
+ * consumer styles the parts a compound component renders internally. The build
+ * transform compiles each slot VALUE to its Tailwind class string (keeping the
+ * key), safelists and mangles the classes exactly like `sz`, and the component
+ * forwards `props.szs?.<slot>` into the matching child's `className`.
+ *
+ * Component authors declare their slot set so consumers get autocompletion and
+ * typo checking:
+ *
+ * @example
+ * ```tsx
+ * type CardProps = { szs?: Szs<'header' | 'icon'> };
+ * // consumer:
+ * <Card szs={{ header: { bg: 'gray-100' }, icon: { color: 'red-500' } }} />
+ * ```
+ */
+type Szs<Slots extends string = string> = Partial<Record<Slots, SzPropValue>>;
 
 /**
  * @csszyx/compiler - TypeScript compiler package for csszyx.
@@ -13639,5 +13679,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, isRustTransformAvailable, 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 };
+export { COLOR_PROPERTIES, CsszyxCompiler, DEFAULT_COMPILER_OPTIONS, ManifestBuilder, OxcNotImplementedError, OxcRustNotImplementedError, PROPERTY_CATEGORY_MAP, PropertyCategory, SzObject, VERSION, buildParentMap, createRecoveryToken, ensureRustTransformAvailable, generateRecoveryToken, getCSSVariableName, getPropertyCategory, hoistCSSVariables, injectRecoveryToken, isRustTransformAvailable, isValidRecoveryMode, mergeOptions, parseManifest, scanGlobalVarUsages, serializeManifest, sortStrings, 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, Szs, TableProps, TokenData, TokenMetadata, TransformOxcResult, TransformProps, TransformRustFile, TransformSourceCodeOptions, TransitionAnimationProps, TypographyProps, VariantModifiers };