@tenphi/tasty 0.0.0-snapshot.1d29633 → 0.0.0-snapshot.1f1c00a

package/dist/{index-D1nMkpUe.d.ts → index-G9JuwM9p.d.ts}

@@ -1,8 +1,64 @@
-import { _ as TastyPluginFactory, w as StyleInjector } from "./config-DmFxnBxg.js";
-import { B as StyleValueStateMap, Ct as PropertyOptions, D as CSSMap, I as StyleHandlerResult, M as ResolvedStyleValue, Ot as StyleInjectorConfig, R as StylePropValue, at as CSSProperties$1, b as Styles, bt as KeyframesResult, dt as FunctionDefinition, gt as InjectResult, ht as GlobalInjectResult, j as RawStyleHandler, lt as FontFaceDescriptors, mt as GCOptions, n as StyleResult, nt as StyleDetails, ot as CacheMetrics, st as CounterStyleDescriptors, ut as FontFaceInput, x as StylesInterface, xt as KeyframesSteps, z as StyleValue } from "./index-LC3O3Jj4.js";
-import { t as ServerStyleCollector } from "./collector-BFuqdF2F.js";
+import { Et as StyleDetails, G as NoType, M as StyleResult, X as StylesInterface, Y as Styles, _ as KeyframesSteps, a as FontFaceInput, ct as StyleHandler, d as InjectOptions, dt as StyleHandlerResult, f as InjectResult, g as KeyframesResult, ht as StyleValueStateMap, i as FontFaceDescriptors, kt as CSSProperties$1, l as GCOptions, mt as StyleValue, n as CounterStyleDescriptors, nt as CSSMap, o as FunctionDefinition, ot as RawStyleHandler, pt as StylePropValue, st as ResolvedStyleValue, t as CacheMetrics, u as GlobalInjectResult, w as StyleInjectorConfig, y as PropertyOptions } from "./types-JEY8PVYP.js";
+import { b as StyleInjector, p as TastyPluginFactory } from "./config-CZWCzBr6.js";
+import { t as ServerStyleCollector } from "./collector-w4mBj5gd.js";
+import "./merge-styles-VXwJ0Frr.js";
 import { AllHTMLAttributes, CSSProperties, ComponentType, ElementType, ForwardRefExoticComponent, JSX, PropsWithoutRef, ReactNode, RefAttributes } from "react";
-
+//#region src/utils/color-math.d.ts
+/**
+ * Consolidated color conversion math.
+ *
+ * Single source of truth for all color space conversions used across the
+ * library: sRGB gamma, HSL, OKLab, OKLCH, OKHSL, hex parsing, named
+ * colors, and CSS string converters.
+ *
+ * This module has zero internal imports — it is a leaf dependency.
+ *
+ * Reference: https://bottosson.github.io/posts/oklab/
+ */
+type Vec3 = [number, number, number];
+/**
+ * HSL to RGB.
+ * Algorithm from CSS Color 4 spec.
+ *
+ * @param h - Hue in degrees (0-360)
+ * @param s - Saturation (0-1)
+ * @param l - Lightness (0-1)
+ * @returns RGB values in 0-255 range (may have fractional values)
+ */
+declare function hslToRgbValues(h: number, s: number, l: number): Vec3;
+declare function getNamedColorHex(): Map<string, string>;
+/**
+ * Convert hex color string to `rgb()` CSS string.
+ * Supports 3, 4, 6, and 8 character hex values (with or without `#`).
+ */
+declare function hexToRgb(hex: string): string | null;
+/**
+ * Extract RGB values from an `rgb()`/`rgba()` string.
+ * Supports comma-separated, space-separated, fractional, percentage,
+ * and slash alpha notation.
+ *
+ * @returns Array of RGB values (0-255 range), converting percentages as needed.
+ */
+declare function getRgbValuesFromRgbaString(str: string): number[];
+/**
+ * Convert any recognized color string to an `rgb()` CSS string.
+ * Handles hex, `okhsl()`, `okhst()`, `hsl()`/`hsla()`, named CSS colors,
+ * and `rgb()`/`rgba()` pass-through.
+ */
+declare function strToRgb(color: string, _ignoreAlpha?: boolean): string | null | undefined;
+//#endregion
+//#region src/utils/is-selector.d.ts
+/** Check whether a style-object key identifies a nested CSS selector. */
+declare function isSelector(key: string): boolean;
+//#endregion
+//#region src/config-state.d.ts
+/**
+ * Minimal configuration state shared by the style engine, zero-runtime
+ * extractor, and runtime configuration module. Keeping it independent
+ * prevents pure rendering code from importing the full injector graph.
+ */
+declare function hasStylesGenerated(): boolean;
+//#endregion
 //#region src/utils/name-prefix.d.ts
 /**
  * Name prefix utilities for generated identifiers.
@@ -31,17 +87,17 @@ declare const DEFAULT_ZERO_NAME_PREFIX = "ts";
 //#endregion
 //#region src/styles/list.d.ts
 declare const BASE_STYLES: readonly ["display", "font", "preset", "hide", "whiteSpace", "opacity", "transition"];
-declare const POSITION_STYLES: readonly ["gridArea", "order", "gridColumn", "gridRow", "placeSelf", "alignSelf", "justifySelf", "zIndex", "margin", "inset", "position", "scrollMargin"];
-declare const BLOCK_INNER_STYLES: readonly ["padding", "paddingInline", "paddingBlock", "overflow", "scrollbar", "textAlign"];
-declare const BLOCK_OUTER_STYLES: readonly ["border", "radius", "shadow", "outline"];
-declare const BLOCK_STYLES: readonly ["padding", "paddingInline", "paddingBlock", "overflow", "scrollbar", "textAlign", "border", "radius", "shadow", "outline"];
+declare const POSITION_STYLES: readonly ["gridArea", "order", "gridColumn", "gridRow", "placeSelf", "alignSelf", "justifySelf", "zIndex", "margin", "blockMargin", "inlineMargin", "inset", "blockInset", "inlineInset", "position", "scrollMargin", "blockScrollMargin", "inlineScrollMargin", "scrollPadding", "blockScrollPadding", "inlineScrollPadding"];
+declare const BLOCK_INNER_STYLES: readonly ["padding", "blockPadding", "inlinePadding", "overflow", "scrollbar", "textAlign"];
+declare const BLOCK_OUTER_STYLES: readonly ["border", "blockBorder", "inlineBorder", "radius", "shadow", "outline"];
+declare const BLOCK_STYLES: readonly ["padding", "blockPadding", "inlinePadding", "overflow", "scrollbar", "textAlign", "border", "blockBorder", "inlineBorder", "radius", "shadow", "outline"];
 declare const COLOR_STYLES: readonly ["color", "fill", "fade", "image"];
 declare const TEXT_STYLES: readonly ["textTransform", "fontWeight", "fontStyle"];
-declare const DIMENSION_STYLES: readonly ["width", "height", "flexBasis", "flexGrow", "flexShrink", "flex"];
+declare const DIMENSION_STYLES: readonly ["width", "height", "blockSize", "inlineSize", "flexBasis", "flexGrow", "flexShrink", "flex"];
 declare const FLOW_STYLES: readonly ["flow", "place", "placeItems", "placeContent", "alignItems", "alignContent", "justifyItems", "justifyContent", "align", "justify", "gap", "columnGap", "rowGap", "gridColumns", "gridRows", "gridTemplate", "gridAreas"];
-declare const CONTAINER_STYLES: readonly ["display", "font", "preset", "hide", "whiteSpace", "opacity", "transition", "color", "fill", "fade", "image", "width", "height", "flexBasis", "flexGrow", "flexShrink", "flex", "gridArea", "order", "gridColumn", "gridRow", "placeSelf", "alignSelf", "justifySelf", "zIndex", "margin", "inset", "position", "scrollMargin", "padding", "paddingInline", "paddingBlock", "overflow", "scrollbar", "textAlign", "border", "radius", "shadow", "outline", "flow", "place", "placeItems", "placeContent", "alignItems", "alignContent", "justifyItems", "justifyContent", "align", "justify", "gap", "columnGap", "rowGap", "gridColumns", "gridRows", "gridTemplate", "gridAreas"];
-declare const OUTER_STYLES: readonly ["gridArea", "order", "gridColumn", "gridRow", "placeSelf", "alignSelf", "justifySelf", "zIndex", "margin", "inset", "position", "scrollMargin", "width", "height", "flexBasis", "flexGrow", "flexShrink", "flex", "border", "radius", "shadow", "outline"];
-declare const INNER_STYLES: readonly ["display", "font", "preset", "hide", "whiteSpace", "opacity", "transition", "color", "fill", "fade", "image", "padding", "paddingInline", "paddingBlock", "overflow", "scrollbar", "textAlign", "flow", "place", "placeItems", "placeContent", "alignItems", "alignContent", "justifyItems", "justifyContent", "align", "justify", "gap", "columnGap", "rowGap", "gridColumns", "gridRows", "gridTemplate", "gridAreas"];
+declare const CONTAINER_STYLES: readonly ["display", "font", "preset", "hide", "whiteSpace", "opacity", "transition", "color", "fill", "fade", "image", "width", "height", "blockSize", "inlineSize", "flexBasis", "flexGrow", "flexShrink", "flex", "gridArea", "order", "gridColumn", "gridRow", "placeSelf", "alignSelf", "justifySelf", "zIndex", "margin", "blockMargin", "inlineMargin", "inset", "blockInset", "inlineInset", "position", "scrollMargin", "blockScrollMargin", "inlineScrollMargin", "scrollPadding", "blockScrollPadding", "inlineScrollPadding", "padding", "blockPadding", "inlinePadding", "overflow", "scrollbar", "textAlign", "border", "blockBorder", "inlineBorder", "radius", "shadow", "outline", "flow", "place", "placeItems", "placeContent", "alignItems", "alignContent", "justifyItems", "justifyContent", "align", "justify", "gap", "columnGap", "rowGap", "gridColumns", "gridRows", "gridTemplate", "gridAreas"];
+declare const OUTER_STYLES: readonly ["gridArea", "order", "gridColumn", "gridRow", "placeSelf", "alignSelf", "justifySelf", "zIndex", "margin", "blockMargin", "inlineMargin", "inset", "blockInset", "inlineInset", "position", "scrollMargin", "blockScrollMargin", "inlineScrollMargin", "scrollPadding", "blockScrollPadding", "inlineScrollPadding", "width", "height", "blockSize", "inlineSize", "flexBasis", "flexGrow", "flexShrink", "flex", "border", "blockBorder", "inlineBorder", "radius", "shadow", "outline"];
+declare const INNER_STYLES: readonly ["display", "font", "preset", "hide", "whiteSpace", "opacity", "transition", "color", "fill", "fade", "image", "padding", "blockPadding", "inlinePadding", "overflow", "scrollbar", "textAlign", "flow", "place", "placeItems", "placeContent", "alignItems", "alignContent", "justifyItems", "justifyContent", "align", "justify", "gap", "columnGap", "rowGap", "gridColumns", "gridRows", "gridTemplate", "gridAreas"];
 //#endregion
 //#region src/types.d.ts
 /**
@@ -96,7 +152,7 @@ interface TastyBaseStylePropNames {}
  * it names. Intersecting with `keyof StylesInterface` makes a name that isn't a
  * real style inert rather than `never`-typed.
  */
-type ExtraBaseStyleProps = { [key in keyof TastyBaseStylePropNames & keyof StylesInterface]?: StylePropValue<StylesInterface[key]> };
+type ExtraBaseStyleProps = { [key in keyof TastyBaseStylePropNames & keyof StylesInterface]?: StylePropValue<StylesInterface[key]>; };
 /** Allowed mod value types */
 type ModValue = boolean | string | number | undefined | null;
 /**
@@ -119,7 +175,7 @@ type TokenValue = string | number | boolean | undefined | null;
 /**
  * Tokens definition for inline CSS custom properties.
  * - `$name` keys become `--name` CSS properties
- * - `#name` keys become `--name-color` and `--name-color-{colorSpace}` CSS properties
+ * - `#name` keys become `--name-color` CSS properties
  */
 type Tokens = Record<`$${string}` | `#${string}`, TokenValue>;
 type Caps = 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z';
@@ -247,7 +303,7 @@ interface TastyExtensionConfig {
 }
 //#endregion
 //#region src/tasty.d.ts
-type StyleList = readonly (keyof { [key in keyof StylesInterface]: StylesInterface[key] })[];
+type StyleList = readonly (keyof { [key in keyof StylesInterface]: StylesInterface[key]; })[];
 /** Type descriptor for a single mod prop: a JS constructor or an enum array. */
 type ModPropDef = BooleanConstructor | StringConstructor | NumberConstructor | readonly string[];
 /** Array form: list of mod key names (types default to ModValue). */
@@ -259,7 +315,7 @@ type ModPropsInput = ModPropsList | ModPropsMap;
 /** Resolve a single ModPropDef to its TypeScript type. */
 type ResolveModPropDef<T> = T extends BooleanConstructor ? boolean : T extends StringConstructor ? string : T extends NumberConstructor ? number : T extends readonly (infer U)[] ? U : ModValue;
 /** Resolve an entire `modProps` definition to the component prop types it adds. */
-type ResolveModProps<M extends ModPropsInput> = M extends readonly (infer K)[] ? Partial<Record<K & string, ModValue>> : M extends Record<string, ModPropDef> ? { [key in keyof M & string]?: ResolveModPropDef<M[key]> } : {};
+type ResolveModProps<M extends ModPropsInput> = M extends readonly (infer K)[] ? Partial<Record<K & string, ModValue>> : M extends Record<string, ModPropDef> ? { [key in keyof M & string]?: ResolveModPropDef<M[key]>; } : {};
 /** A token key with `$` or `#` prefix. */
 type TokenPropKey = `$${string}` | `#${string}`;
 /** Array form: list of prop names. Names ending in `Color` map to `#` color tokens. */
@@ -315,23 +371,30 @@ type SubElementProps<Tag extends keyof JSX.IntrinsicElements = 'div'> = Omit<JSX
 /**
  * Generates the sub-element component types from an ElementsDefinition
  */
-type SubElementComponents<E extends ElementsDefinition> = { [K in keyof E]: ForwardRefExoticComponent<PropsWithoutRef<SubElementProps<ResolveElementTag<E[K]>>> & RefAttributes<ResolveElementTag<E[K]> extends keyof HTMLElementTagNameMap ? HTMLElementTagNameMap[ResolveElementTag<E[K]>] : Element$1>> };
+type SubElementComponents<E extends ElementsDefinition> = { [K in keyof E]: ForwardRefExoticComponent<PropsWithoutRef<SubElementProps<ResolveElementTag<E[K]>>> & RefAttributes<ResolveElementTag<E[K]> extends keyof HTMLElementTagNameMap ? HTMLElementTagNameMap[ResolveElementTag<E[K]>] : Element$1>>; };
 /**
  * Base type containing common properties shared between TastyProps and TastyElementOptions.
  * Separated to avoid code duplication while allowing different type constraints.
  */
 type TastyBaseProps<K extends StyleList, V extends VariantMap, E extends ElementsDefinition = Record<string, never>, M extends ModPropsInput = readonly never[], TP extends TokenPropsInput = readonly never[]> = {
-  /** Default styles of the element. */styles?: Styles; /** The list of styles that can be provided by props */
-  styleProps?: K; /** Modifier keys exposed as top-level component props (array or typed object form). */
-  modProps?: M; /** Token keys exposed as top-level component props (array or typed object form). */
+  /** Default styles of the element. */
+  styles?: Styles;
+  /** The list of styles that can be provided by props */
+  styleProps?: K;
+  /** Modifier keys exposed as top-level component props (array or typed object form). */
+  modProps?: M;
+  /** Token keys exposed as top-level component props (array or typed object form). */
   tokenProps?: TP;
   element?: BaseProps['element'];
-  variants?: V; /** Default tokens for inline CSS custom properties */
-  tokens?: Tokens; /** Sub-element definitions for compound components */
+  variants?: V;
+  /** Default tokens for inline CSS custom properties */
+  tokens?: Tokens;
+  /** Sub-element definitions for compound components */
   elements?: E;
 } & Pick<BaseProps, 'qa' | 'qaVal'> & WithVariant<V>;
 type TastyProps<K extends StyleList, V extends VariantMap, E extends ElementsDefinition = Record<string, never>, DefaultProps = AnyProps, M extends ModPropsInput = readonly never[], TP extends TokenPropsInput = readonly never[]> = TastyBaseProps<K, V, E, M, TP> & {
-  /** The tag name of the element or a React component. */as?: string | ComponentType<any>;
+  /** The tag name of the element or a React component. */
+  as?: string | ComponentType<any>;
 } & Partial<Omit<DefaultProps, 'as' | 'styles' | 'styleProps' | 'modProps' | 'tokenProps' | 'tokens'>>;
 /**
  * Resolves the props of a polymorphic `as` value (intrinsic tag or component).
@@ -350,14 +413,15 @@ type ResolveAsProps<AsType extends ElementType> = AsType extends keyof JSX.Intri
  * record to ensure strict type checking for styles.
  */
 type TastyElementOptions<K extends StyleList, V extends VariantMap, E extends ElementsDefinition = Record<string, never>, AsType extends ElementType = 'div', M extends ModPropsInput = readonly never[], TP extends TokenPropsInput = readonly never[]> = TastyBaseProps<K, V, E, M, TP> & {
-  /** The tag name of the element or a React component. */as?: AsType;
+  /** The tag name of the element or a React component. */
+  as?: AsType;
 } & Record<string, unknown>;
-type AllBasePropsWithMods<K extends StyleList, M extends ModPropsInput = readonly never[], TP extends TokenPropsInput = readonly never[]> = AllBaseProps & { [key in K[number]]?: StyleValue<StylesInterface[key]> | StyleValueStateMap<StylesInterface[key]> } & BaseStyleProps & ExtraBaseStyleProps & Partial<TastyCustomProps> & ResolveModProps<M> & ResolveTokenProps<TP>;
+type AllBasePropsWithMods<K extends StyleList, M extends ModPropsInput = readonly never[], TP extends TokenPropsInput = readonly never[]> = AllBaseProps & { [key in K[number]]?: StyleValue<StylesInterface[key]> | StyleValueStateMap<StylesInterface[key]>; } & BaseStyleProps & ExtraBaseStyleProps & Partial<TastyCustomProps> & ResolveModProps<M> & ResolveTokenProps<TP>;
 /**
- * Keys from BasePropsWithoutChildren that should be omitted from HTML attributes.
- * This excludes event handlers so they can be properly typed from JSX.IntrinsicElements.
+ * Props consumed by Tasty rather than forwarded to the `as` component.
+ * Event handlers are resolved from JSX.IntrinsicElements or the component's own props.
  */
-type TastySpecificKeys = 'as' | 'qa' | 'qaVal' | 'element' | 'styles' | 'mods' | 'isHidden' | 'isDisabled' | 'isChecked' | 'style' | 'theme' | 'tokens' | 'ref' | 'color';
+type TastySpecificKeys = keyof BaseStyleProps | 'as' | 'qa' | 'qaVal' | 'element' | 'styles' | 'mods' | 'isHidden' | 'isDisabled' | 'isChecked' | 'style' | 'theme' | 'tokens' | 'ref';
 /** Extract prop key names from a ModPropsInput (array elements or object keys). */
 type ModPropsKeys<M extends ModPropsInput> = M extends readonly (infer K)[] ? K & string : keyof M & string;
 /** Extract prop key names from a TokenPropsInput (array elements or object keys). */
@@ -379,7 +443,7 @@ type TokenPropsKeys<TP extends TokenPropsInput> = TP extends readonly (infer K)[
  * is a component type with a narrower prop API.
  */
 type TastyElementProps<K extends StyleList, V extends VariantMap, AsType extends ElementType = 'div', M extends ModPropsInput = readonly never[], TP extends TokenPropsInput = readonly never[]> = Omit<AllBasePropsWithMods<K, M, TP>, Exclude<keyof ResolveAsProps<AsType>, TastySpecificKeys | keyof TastyCustomProps | keyof ExtraBaseStyleProps | K[number] | ModPropsKeys<M> | TokenPropsKeys<TP>>> & WithVariant<V> & Omit<Omit<AllHTMLAttributes<HTMLElement>, keyof ResolveAsProps<AsType>> & ResolveAsProps<AsType>, TastySpecificKeys | keyof TastyCustomProps | keyof ExtraBaseStyleProps | K[number] | ModPropsKeys<M> | TokenPropsKeys<TP>>;
-type TastyComponentPropsWithDefaults<Props extends PropsWithStyles, DefaultProps extends Partial<Props>> = keyof DefaultProps extends never ? Props : { [key in Extract<keyof Props, keyof DefaultProps>]?: Props[key] } & { [key in keyof Omit<Props, keyof DefaultProps>]: Props[key] };
+type TastyComponentPropsWithDefaults<Props extends PropsWithStyles, DefaultProps extends Partial<Props>> = keyof DefaultProps extends never ? Props : { [key in Extract<keyof Props, keyof DefaultProps>]?: Props[key]; } & { [key in keyof Omit<Props, keyof DefaultProps>]: Props[key]; };
 /**
  * The component type returned by the `tasty(options)` element-factory overload.
  *
@@ -394,9 +458,9 @@ type TastyComponentPropsWithDefaults<Props extends PropsWithStyles, DefaultProps
  * `SomeComponent`; create another `tasty({ as: SomeComponent })` for that.
  */
 type TastyPolymorphicComponent<DefaultAs extends ElementType, K extends StyleList, V extends VariantMap, M extends ModPropsInput, TP extends TokenPropsInput> = ForwardRefExoticComponent<PropsWithoutRef<TastyElementProps<K, V, DefaultAs, M, TP>> & RefAttributes<unknown>>;
-declare function tasty<K extends StyleList, V extends VariantMap, E extends ElementsDefinition = Record<string, never>, AsType extends ElementType = 'div', M extends ModPropsInput = readonly never[], TP extends TokenPropsInput = readonly never[]>(options: TastyElementOptions<K, V, E, AsType, M, TP>, secondArg?: never): TastyPolymorphicComponent<AsType, K, V, M, TP> & SubElementComponents<E>;
+declare function tasty<K extends StyleList = readonly never[], V extends VariantMap = VariantMap, E extends ElementsDefinition = Record<string, never>, AsType extends ElementType = 'div', M extends ModPropsInput = readonly never[], TP extends TokenPropsInput = readonly never[]>(options: TastyElementOptions<K, V, E, AsType, M, TP>, secondArg?: never): TastyPolymorphicComponent<AsType, K, V, M, TP> & SubElementComponents<E>;
 declare function tasty<Props extends PropsWithStyles, DefaultProps extends Partial<Props> = Partial<Props>, K extends StyleList = readonly never[], V extends VariantMap = VariantMap, E extends ElementsDefinition = Record<string, never>, M extends ModPropsInput = readonly never[], TP extends TokenPropsInput = readonly never[]>(Component: ComponentType<Props>, options?: TastyProps<K, V, E, Props, M, TP>): ComponentType<TastyComponentPropsWithDefaults<Props, DefaultProps>>;
-declare const Element$1: TastyPolymorphicComponent<"div", StyleList, VariantMap, readonly never[], readonly never[]> & SubElementComponents<Record<string, never>>;
+declare const Element$1: TastyPolymorphicComponent<"div", readonly never[], VariantMap, readonly never[], readonly never[]> & SubElementComponents<Record<string, never>>;
 //#endregion
 //#region src/hooks/useStyles.d.ts
 interface UseStylesResult {
@@ -777,9 +841,7 @@ interface TastyBatchProviderProps {
  * );
  * ```
  */
-declare function TastyBatchProvider({
-  children
-}: TastyBatchProviderProps): ReactNode;
+declare function TastyBatchProvider({ children }: TastyBatchProviderProps): ReactNode;
 //#endregion
 //#region src/utils/get-display-name.d.ts
 declare function getDisplayName<T>(Component: ElementType<T>, fallbackName?: string): string;
@@ -887,8 +949,8 @@ declare function resolveFunctionColor(str: string): string | null;
 /**
  * Chunk names, the built-in chunk style lists, and the style→chunk lookup.
  *
- * This is a **leaf module with no imports**. It exists separately from
- * `definitions.ts` for two reasons:
+ * This module only imports data-only style-name lists. It exists separately
+ * from `definitions.ts` for two reasons:
  *
  * 1. The style handler registry (`styles/predefined.ts`) needs to assign chunk
  *    membership for custom handlers. Reaching for `definitions.ts` would create an
@@ -901,7 +963,8 @@ declare function resolveFunctionColor(str: string): string | null;
  * public API surface are unchanged.
  */
 declare const CHUNK_NAMES: {
-  /** Special chunk for styles that cannot be split */readonly COMBINED: "combined";
+  /** Special chunk for styles that cannot be split */
+  readonly COMBINED: "combined";
   readonly SUBCOMPONENTS: "subcomponents";
   readonly APPEARANCE: "appearance";
   readonly FONT: "font";
@@ -917,7 +980,7 @@ type ChunkName = (typeof CHUNK_NAMES)[keyof typeof CHUNK_NAMES];
  *
  * @public
  */
-declare const APPEARANCE_CHUNK_STYLES: readonly ["fill", "color", "opacity", "border", "radius", "outline", "outlineOffset", "shadow", "fade"];
+declare const APPEARANCE_CHUNK_STYLES: readonly ["fill", "color", "opacity", "border", "blockBorder", "inlineBorder", "radius", "outline", "outlineOffset", "shadow", "fade"];
 /**
  * Font chunk - typography styles
  *
@@ -931,13 +994,15 @@ declare const FONT_CHUNK_STYLES: readonly ["preset", "font", "fontWeight", "font
  * Dimension chunk - sizing and spacing
  *
  * Handler dependencies (all styles in each handler MUST stay in this chunk):
- * ⚠️ paddingStyle: padding, paddingTop/Right/Bottom/Left, paddingBlock/Inline
- * ⚠️ marginStyle: margin, marginTop/Right/Bottom/Left, marginBlock/Inline
+ * ⚠️ paddingStyle: padding, paddingTop/Right/Bottom/Left
+ * ⚠️ marginStyle: margin, marginTop/Right/Bottom/Left
  * ⚠️ widthStyle: width, minWidth, maxWidth
  * ⚠️ heightStyle: height, minHeight, maxHeight
+ * ⚠️ blockSizeStyle: blockSize, minBlockSize, maxBlockSize
+ * ⚠️ inlineSizeStyle: inlineSize, minInlineSize, maxInlineSize
  */
 /** @public */
-declare const DIMENSION_CHUNK_STYLES: readonly ["padding", "paddingTop", "paddingRight", "paddingBottom", "paddingLeft", "paddingBlock", "paddingInline", "margin", "marginTop", "marginRight", "marginBottom", "marginLeft", "marginBlock", "marginInline", "width", "minWidth", "maxWidth", "height", "minHeight", "maxHeight", "flexBasis", "flexGrow", "flexShrink", "flex"];
+declare const DIMENSION_CHUNK_STYLES: readonly ["padding", "paddingTop", "paddingRight", "paddingBottom", "paddingLeft", "blockPadding", "inlinePadding", "margin", "marginTop", "marginRight", "marginBottom", "marginLeft", "blockMargin", "inlineMargin", "width", "minWidth", "maxWidth", "height", "minHeight", "maxHeight", "blockSize", "minBlockSize", "maxBlockSize", "inlineSize", "minInlineSize", "maxInlineSize", "flexBasis", "flexGrow", "flexShrink", "flex"];
 /**
  * Display chunk - display mode, layout flow, text overflow, and scrollbar
  *
@@ -961,10 +1026,10 @@ declare const LAYOUT_CHUNK_STYLES: readonly ["placeItems", "placeContent", "alig
  * Position chunk - element positioning
  *
  * Handler dependencies (all styles in each handler MUST stay in this chunk):
- * ⚠️ insetStyle: inset, insetBlock, insetInline, top, right, bottom, left
+ * ⚠️ insetStyle: inset, top, right, bottom, left
  */
 /** @public */
-declare const POSITION_CHUNK_STYLES: readonly ["position", "inset", "insetBlock", "insetInline", "top", "right", "bottom", "left", "zIndex", "gridArea", "gridColumn", "gridRow", "order", "placeSelf", "alignSelf", "justifySelf", "transform", "transition", "animation"];
+declare const POSITION_CHUNK_STYLES: readonly ["position", "inset", "blockInset", "inlineInset", "top", "right", "bottom", "left", "blockScrollMargin", "inlineScrollMargin", "blockScrollPadding", "inlineScrollPadding", "zIndex", "gridArea", "gridColumn", "gridRow", "order", "placeSelf", "alignSelf", "justifySelf", "transform", "transition", "animation"];
 /**
  * Map for O(1) style-to-chunk lookup. Seeded with the built-in lists above and
  * extended by {@link assignStyleChunk} when a custom handler declares style names
@@ -1004,19 +1069,25 @@ declare function categorizeStyleKeys(styles: Record<string, unknown>): Map<strin
  *
  * Later groups override earlier groups for conflicting directions.
  */
-declare function borderStyle({
-  border
-}: {
+declare function borderStyle({ border }: {
   border?: string | number | boolean;
 }): Record<string, string> | null;
 declare namespace borderStyle {
   var __lookupStyles: string[];
 }
 //#endregion
+//#region src/styles/blockSize.d.ts
+declare function blockSizeStyle({ blockSize, minBlockSize, maxBlockSize }: {
+  blockSize?: string | number | boolean;
+  minBlockSize?: string | number | boolean;
+  maxBlockSize?: string | number | boolean;
+}): Record<string, string | string[]> | null;
+declare namespace blockSizeStyle {
+  var __lookupStyles: ("blockSize" | "maxBlockSize" | "minBlockSize")[];
+}
+//#endregion
 //#region src/styles/color.d.ts
-declare function colorStyle({
-  color
-}: {
+declare function colorStyle({ color }: {
   color?: string | boolean;
 }): Record<string, string> | null;
 declare namespace colorStyle {
@@ -1040,21 +1111,13 @@ interface DisplayStyleProps {
  * 3. Single-line `textOverflow` defaults white-space to nowrap
  * 4. Explicit `whiteSpace` overrides the default from `textOverflow`
  */
-declare function displayStyle({
-  display,
-  hide,
-  textOverflow,
-  overflow,
-  whiteSpace
-}: DisplayStyleProps): Record<string, string | number> | null;
+declare function displayStyle({ display, hide, textOverflow, overflow, whiteSpace }: DisplayStyleProps): Record<string, string | number> | null;
 declare namespace displayStyle {
   var __lookupStyles: string[];
 }
 //#endregion
 //#region src/styles/fade.d.ts
-declare function fadeStyle({
-  fade
-}: {
+declare function fadeStyle({ fade }: {
   fade?: string;
 }): {
   mask: string;
@@ -1065,19 +1128,7 @@ declare namespace fadeStyle {
 }
 //#endregion
 //#region src/styles/fill.d.ts
-declare function fillStyle({
-  fill,
-  backgroundColor,
-  image,
-  backgroundImage,
-  backgroundPosition,
-  backgroundSize,
-  backgroundRepeat,
-  backgroundAttachment,
-  backgroundOrigin,
-  backgroundClip,
-  background
-}: {
+declare function fillStyle({ fill, backgroundColor, image, backgroundImage, backgroundPosition, backgroundSize, backgroundRepeat, backgroundAttachment, backgroundOrigin, backgroundClip, background }: {
   fill?: string;
   backgroundColor?: string;
   image?: string;
@@ -1093,9 +1144,7 @@ declare function fillStyle({
 declare namespace fillStyle {
   var __lookupStyles: string[];
 }
-declare function svgFillStyle({
-  svgFill
-}: {
+declare function svgFillStyle({ svgFill }: {
   svgFill?: string;
 }): {
   fill: string;
@@ -1105,12 +1154,9 @@ declare namespace svgFillStyle {
 }
 //#endregion
 //#region src/styles/flow.d.ts
-declare function flowStyle({
-  display,
-  flow
-}: {
-  display?: string;
-  flow?: string;
+declare function flowStyle({ display, flow }: {
+  display?: string | NoType;
+  flow?: string | NoType;
 }): {
   [x: string]: string;
 } | null;
@@ -1119,14 +1165,10 @@ declare namespace flowStyle {
 }
 //#endregion
 //#region src/styles/gap.d.ts
-declare function gapStyle({
-  display,
-  flow,
-  gap
-}: {
-  display?: string;
-  flow?: string;
-  gap?: string | number | boolean;
+declare function gapStyle({ display, flow, gap }: {
+  display?: string | NoType;
+  flow?: string | NoType;
+  gap?: string | number | boolean | NoType;
 }): {
   gap: string;
   $?: undefined;
@@ -1153,28 +1195,14 @@ interface HeightStyleProps {
   minHeight?: string | number | boolean;
   maxHeight?: string | number | boolean;
 }
-declare function heightStyle({
-  height,
-  minHeight,
-  maxHeight
-}: HeightStyleProps): Record<string, string | string[]> | null;
+declare function heightStyle({ height, minHeight, maxHeight }: HeightStyleProps): Record<string, string | string[]> | null;
 declare namespace heightStyle {
   var __lookupStyles: string[];
 }
 //#endregion
 //#region src/styles/inset.d.ts
-declare function insetStyle({
-  inset,
-  insetBlock,
-  insetInline,
-  top,
-  right,
-  bottom,
-  left
-}: {
+declare function insetStyle({ inset, top, right, bottom, left }: {
   inset?: string | number | boolean;
-  insetBlock?: string | number | boolean;
-  insetInline?: string | number | boolean;
   top?: string | number | boolean;
   right?: string | number | boolean;
   bottom?: string | number | boolean;
@@ -1184,19 +1212,19 @@ declare namespace insetStyle {
   var __lookupStyles: string[];
 }
 //#endregion
+//#region src/styles/inlineSize.d.ts
+declare function inlineSizeStyle({ inlineSize, minInlineSize, maxInlineSize }: {
+  inlineSize?: string | number | boolean;
+  minInlineSize?: string | number | boolean;
+  maxInlineSize?: string | number | boolean;
+}): Record<string, string | string[]> | null;
+declare namespace inlineSizeStyle {
+  var __lookupStyles: ("inlineSize" | "maxInlineSize" | "minInlineSize")[];
+}
+//#endregion
 //#region src/styles/margin.d.ts
-declare function marginStyle({
-  margin,
-  marginBlock,
-  marginInline,
-  marginTop,
-  marginRight,
-  marginBottom,
-  marginLeft
-}: {
+declare function marginStyle({ margin, marginTop, marginRight, marginBottom, marginLeft }: {
   margin?: string | number | boolean;
-  marginBlock?: string | number | boolean;
-  marginInline?: string | number | boolean;
   marginTop?: string | number | boolean;
   marginRight?: string | number | boolean;
   marginBottom?: string | number | boolean;
@@ -1225,27 +1253,14 @@ interface OutlineStyleProps {
  *
  * @return CSS properties for outline and optionally outline-offset
  */
-declare function outlineStyle({
-  outline,
-  outlineOffset
-}: OutlineStyleProps): Record<string, string> | null;
+declare function outlineStyle({ outline, outlineOffset }: OutlineStyleProps): Record<string, string> | null;
 declare namespace outlineStyle {
   var __lookupStyles: string[];
 }
 //#endregion
 //#region src/styles/padding.d.ts
-declare function paddingStyle({
-  padding,
-  paddingBlock,
-  paddingInline,
-  paddingTop,
-  paddingRight,
-  paddingBottom,
-  paddingLeft
-}: {
+declare function paddingStyle({ padding, paddingTop, paddingRight, paddingBottom, paddingLeft }: {
   padding?: string | number | boolean;
-  paddingBlock?: string | number | boolean;
-  paddingInline?: string | number | boolean;
   paddingTop?: string | number | boolean;
   paddingRight?: string | number | boolean;
   paddingBottom?: string | number | boolean;
@@ -1275,17 +1290,7 @@ interface PlacementStyleProps {
  * 2. placeItems, placeContent, align, justify (medium) — each sets 2 longhands
  * 3. alignItems, alignContent, justifyItems, justifyContent (highest) — each sets 1 longhand
  */
-declare function placementStyle({
-  place,
-  placeItems,
-  placeContent,
-  align,
-  justify,
-  alignItems,
-  alignContent,
-  justifyItems,
-  justifyContent
-}: PlacementStyleProps): Record<string, string> | null;
+declare function placementStyle({ place, placeItems, placeContent, align, justify, alignItems, alignContent, justifyItems, justifyContent }: PlacementStyleProps): Record<string, string> | null;
 declare namespace placementStyle {
   var __lookupStyles: string[];
 }
@@ -1326,25 +1331,13 @@ interface PresetStyleProps {
  * - `font` is the recommended prop with special handling (monospace, boolean, fallback)
  * - `fontFamily` is a direct value without special handling
  */
-declare function presetStyle({
-  preset,
-  fontSize,
-  lineHeight,
-  textTransform,
-  letterSpacing,
-  fontWeight,
-  fontStyle,
-  fontFamily,
-  font
-}: PresetStyleProps): CSSMap | null;
+declare function presetStyle({ preset, fontSize, lineHeight, textTransform, letterSpacing, fontWeight, fontStyle, fontFamily, font }: PresetStyleProps): CSSMap | null;
 declare namespace presetStyle {
   var __lookupStyles: string[];
 }
 //#endregion
 //#region src/styles/radius.d.ts
-declare function radiusStyle({
-  radius
-}: {
+declare function radiusStyle({ radius }: {
   radius?: string | number | boolean;
 }): Record<string, string> | null;
 declare namespace radiusStyle {
@@ -1352,18 +1345,8 @@ declare namespace radiusStyle {
 }
 //#endregion
 //#region src/styles/scrollMargin.d.ts
-declare function scrollMarginStyle({
-  scrollMargin,
-  scrollMarginBlock,
-  scrollMarginInline,
-  scrollMarginTop,
-  scrollMarginRight,
-  scrollMarginBottom,
-  scrollMarginLeft
-}: {
+declare function scrollMarginStyle({ scrollMargin, scrollMarginTop, scrollMarginRight, scrollMarginBottom, scrollMarginLeft }: {
   scrollMargin?: string | number | boolean;
-  scrollMarginBlock?: string | number | boolean;
-  scrollMarginInline?: string | number | boolean;
   scrollMarginTop?: string | number | boolean;
   scrollMarginRight?: string | number | boolean;
   scrollMarginBottom?: string | number | boolean;
@@ -1373,6 +1356,18 @@ declare namespace scrollMarginStyle {
   var __lookupStyles: string[];
 }
 //#endregion
+//#region src/styles/scrollPadding.d.ts
+declare function scrollPaddingStyle({ scrollPadding, scrollPaddingTop, scrollPaddingRight, scrollPaddingBottom, scrollPaddingLeft }: {
+  scrollPadding?: string | number | boolean;
+  scrollPaddingTop?: string | number | boolean;
+  scrollPaddingRight?: string | number | boolean;
+  scrollPaddingBottom?: string | number | boolean;
+  scrollPaddingLeft?: string | number | boolean;
+}): Record<string, string> | null;
+declare namespace scrollPaddingStyle {
+  var __lookupStyles: string[];
+}
+//#endregion
 //#region src/styles/scrollbar.d.ts
 interface ScrollbarStyleProps {
   scrollbar?: string | boolean;
@@ -1388,18 +1383,13 @@ interface ScrollbarStyleProps {
  * Note: `auto` is classified as a VALUE_KEYWORD by the parser, so it lands
  * in `values` rather than `mods`. Both locations are checked for robustness.
  */
-declare function scrollbarStyle({
-  scrollbar,
-  overflow
-}: ScrollbarStyleProps): Record<string, string> | null;
+declare function scrollbarStyle({ scrollbar, overflow }: ScrollbarStyleProps): Record<string, string> | null;
 declare namespace scrollbarStyle {
   var __lookupStyles: string[];
 }
 //#endregion
 //#region src/styles/shadow.d.ts
-declare function shadowStyle({
-  shadow
-}: {
+declare function shadowStyle({ shadow }: {
   shadow?: string | boolean;
 }): {
   'box-shadow': string;
@@ -1409,9 +1399,7 @@ declare namespace shadowStyle {
 }
 //#endregion
 //#region src/styles/transition.d.ts
-declare function transitionStyle({
-  transition
-}: {
+declare function transitionStyle({ transition }: {
   transition?: string;
 }): {
   transition: string;
@@ -1426,11 +1414,7 @@ interface WidthStyleProps {
   minWidth?: string | number | boolean;
   maxWidth?: string | number | boolean;
 }
-declare function widthStyle({
-  width,
-  minWidth,
-  maxWidth
-}: WidthStyleProps): Record<string, string | string[]> | null;
+declare function widthStyle({ width, minWidth, maxWidth }: WidthStyleProps): Record<string, string | string[]> | null;
 declare namespace widthStyle {
   var __lookupStyles: string[];
 }
@@ -1460,16 +1444,6 @@ declare namespace widthStyle {
  * ```
  */
 declare const styleHandlers: {
-  readonly border: typeof borderStyle;
-  readonly color: typeof colorStyle;
-  readonly display: typeof displayStyle;
-  readonly fade: typeof fadeStyle;
-  readonly fill: typeof fillStyle;
-  readonly svgFill: typeof svgFillStyle;
-  readonly flow: typeof flowStyle;
-  readonly gap: typeof gapStyle;
-  readonly height: typeof heightStyle;
-  readonly inset: typeof insetStyle;
   readonly margin: typeof marginStyle;
   readonly outline: typeof outlineStyle;
   readonly padding: typeof paddingStyle;
@@ -1477,10 +1451,35 @@ declare const styleHandlers: {
   readonly preset: typeof presetStyle;
   readonly radius: typeof radiusStyle;
   readonly scrollMargin: typeof scrollMarginStyle;
+  readonly scrollPadding: typeof scrollPaddingStyle;
   readonly scrollbar: typeof scrollbarStyle;
   readonly shadow: typeof shadowStyle;
   readonly transition: typeof transitionStyle;
   readonly width: typeof widthStyle;
+  readonly blockBorder: StyleHandler<Partial<Record<"blockBorder", string | number | boolean | undefined>>>;
+  readonly inlineBorder: StyleHandler<Partial<Record<"inlineBorder", string | number | boolean | undefined>>>;
+  readonly blockScrollPadding: StyleHandler<Partial<Record<"blockScrollPadding", string | number | boolean | undefined>>>;
+  readonly inlineScrollPadding: StyleHandler<Partial<Record<"inlineScrollPadding", string | number | boolean | undefined>>>;
+  readonly blockScrollMargin: StyleHandler<Partial<Record<"blockScrollMargin", string | number | boolean | undefined>>>;
+  readonly inlineScrollMargin: StyleHandler<Partial<Record<"inlineScrollMargin", string | number | boolean | undefined>>>;
+  readonly blockInset: StyleHandler<Partial<Record<"blockInset", string | number | boolean | undefined>>>;
+  readonly inlineInset: StyleHandler<Partial<Record<"inlineInset", string | number | boolean | undefined>>>;
+  readonly blockMargin: StyleHandler<Partial<Record<"blockMargin", string | number | boolean | undefined>>>;
+  readonly inlineMargin: StyleHandler<Partial<Record<"inlineMargin", string | number | boolean | undefined>>>;
+  readonly blockPadding: StyleHandler<Partial<Record<"blockPadding", string | number | boolean | undefined>>>;
+  readonly inlinePadding: StyleHandler<Partial<Record<"inlinePadding", string | number | boolean | undefined>>>;
+  readonly blockSize: typeof blockSizeStyle;
+  readonly border: typeof borderStyle;
+  readonly color: typeof colorStyle;
+  readonly display: typeof displayStyle;
+  readonly fade: typeof fadeStyle;
+  readonly fill: typeof fillStyle;
+  readonly svgFill: typeof svgFillStyle;
+  readonly flow: typeof flowStyle;
+  readonly gap: typeof gapStyle;
+  readonly height: typeof heightStyle;
+  readonly inset: typeof insetStyle;
+  readonly inlineSize: typeof inlineSizeStyle;
 };
 //#endregion
 //#region src/styles/define-handler.d.ts
@@ -1523,6 +1522,13 @@ interface ComputeStylesOptions {
   ssrCollector?: ServerStyleCollector | null;
   /** Target root for style injection (client only). Defaults to `document`. */
   root?: Document | ShadowRoot;
+  /**
+   * Set when `styles` outlives this call and will be passed in again — a
+   * `tasty()` factory's own styles object rather than a per-render merge.
+   * It lets chunk cache keys be memoized on the object, which is worth the
+   * bookkeeping only when there is a next render to spend it on.
+   */
+  stableStyles?: boolean;
 }
 /**
  * Synchronous, hook-free style computation.
@@ -1580,10 +1586,7 @@ declare const chunkSheetRegistry: ChunkSheetRegistry;
 /**
  * Inject styles and return className with dispose function
  */
-declare function inject(rules: StyleResult[], options?: {
-  root?: Document | ShadowRoot;
-  cacheKey?: string;
-}): InjectResult;
+declare function inject(rules: StyleResult[], options?: InjectOptions): InjectResult;
 /**
  * Inject global rules that should not reserve tasty class names
  */
@@ -1714,21 +1717,40 @@ declare function getCSSTextForNode(node: ParentNode | Element | DocumentFragment
   root?: Document | ShadowRoot;
 }): string;
 /**
- * Force cleanup of unused rules
+ * Take a reference on local `@keyframes` under the deterministic names the
+ * caller resolved, and report which entry holds each. Pair with
+ * `ownKeyframes()` once the rules exist to inspect.
+ */
+declare function holdKeyframes(steps: Record<string, KeyframesSteps>, names: Map<string, string>, options?: {
+  root?: Document | ShadowRoot;
+}): Map<string, string>;
+/**
+ * Record that a class animates these keyframes, so the reference is released
+ * when the last such class is collected.
+ */
+declare function ownKeyframes(key: string, className: string, options?: {
+  root?: Document | ShadowRoot;
+}): void;
+/**
+ * Remove every injected rule that is neither in the DOM nor held by an
+ * outstanding `inject()` handle. Equivalent to `gc({ force: true })`.
  */
 declare function cleanup(root?: Document | ShadowRoot): void;
 /**
- * Record a render-time usage hit for one or more classNames.
- * Used internally by computeStyles and tasty() to track usage for GC.
- * When the global touch counter reaches `touchInterval`, schedules GC.
+ * Count a render, so that a collection pass is scheduled every
+ * `gc.touchInterval` of them. Used internally by computeStyles and tasty().
+ *
+ * @deprecated The class name is ignored — collection asks the DOM what is
+ * rendered rather than recording usage per class. The argument is kept so
+ * existing calls still compile.
  */
 declare function touch(className: string, options?: {
   root?: Document | ShadowRoot;
 }): void;
 /**
- * Synchronous garbage collection of unused styles.
- * Evicts the oldest unused styles when usageMap exceeds capacity.
- * With `{ force: true }`, removes ALL unused styles regardless of capacity.
+ * Synchronous garbage collection of unused styles — those no element carries
+ * and no `inject()` handle references. Evicts the oldest ones once they exceed
+ * capacity. With `{ force: true }`, removes all of them regardless of capacity.
  *
  * @returns Number of styles evicted.
  */
@@ -1749,66 +1771,54 @@ declare function destroy(root?: Document | ShadowRoot): void;
 declare function createInjector(config?: Partial<StyleInjectorConfig>): StyleInjector;
 //#endregion
 //#region src/utils/filter-base-props.d.ts
+declare const basePropNames: readonly ["role", "title", "inert", "as", "element", "css", "qa", "mods", "qaVal", "hidden", "isHidden", "disabled", "isDisabled", "children", "style", "className", "href", "target", "tabIndex"];
+declare const ignoredEventPropNames: readonly ["onPress", "onHoverStart", "onHoverEnd", "onPressStart", "onPressEnd"];
 interface PropsFilterOptions {
   labelable?: boolean;
-  propNames?: Set<string>;
+  propNames?: ReadonlySet<string>;
   eventProps?: boolean;
 }
-/**
- * Filters out all props that aren't valid DOM props or defined via override prop obj.
+type ExplicitPropName<O> = O extends {
+  propNames?: ReadonlySet<infer P>;
+} ? Extract<P, string> : never;
+type EventPropsEnabled<O> = O extends {
+  eventProps?: infer E;
+} ? Extract<E, boolean> : never;
+type Characters<S extends string> = S extends `${infer First}${infer Rest}` ? First | Characters<Rest> : never;
+/** Models DOM-style event keys and the runtime's ignored event names. */
+type EventPropName<K extends string> = string extends K ? `on${Characters<'ABCDEFGHIJKLMNOPQRSTUVWXYZ'>}${string}` : K extends `on${infer Initial}${infer Rest}` ? 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' extends `${string}${Initial}${string}` ? Rest extends '' ? never : Exclude<K, (typeof ignoredEventPropNames)[number]> : never : never;
+type ExplicitNumericPropName<K, O> = K extends number ? `${K}` extends ExplicitPropName<O> ? K : never : never;
+type RetainedPropName<T, O> = 'id' | (typeof basePropNames)[number] | `aria-${string}` | `data-${string}` | ExplicitPropName<O> | (true extends EventPropsEnabled<O> ? EventPropName<Extract<keyof T, string>> : never);
+type FilteredProps<T extends object, O> = T extends unknown ? Partial<Pick<T, Extract<keyof T, RetainedPropName<T, O>> | Extract<RetainedPropName<T, O>, keyof T> | ExplicitNumericPropName<keyof T, O>>> : never;
+/**
+ * Keeps the built-in base props, ARIA/data attributes, and explicitly allowed props.
+ * DOM-style event names are kept only with `eventProps: true`, except the ignored
+ * interaction events (which can still be allowed explicitly via `propNames`).
+ * The return type preserves the input value types only for potentially retained
+ * keys. Props remain optional because only own enumerable string keys are copied.
+ * Use a literal union (e.g. `new Set(['name', 'type'] as const)`) for `propNames`
+ * to keep precise types; a `Set<string>` can potentially retain any string key.
  * @param props - The component props to be filtered.
- * @param opts - Props to override.
+ * @param opts - Additional prop names and event forwarding options.
  */
-declare function filterBaseProps<T extends object>(props: T, opts?: PropsFilterOptions): Partial<T>;
+declare function filterBaseProps<T extends object>(props: T, opts?: undefined): FilteredProps<T, undefined>;
+declare function filterBaseProps<T extends object, O extends PropsFilterOptions | undefined = PropsFilterOptions>(props: T, opts: O): FilteredProps<T, O>;
 //#endregion
 //#region src/utils/colors.d.ts
 declare function color$1(name: string, opacity?: number): string;
 //#endregion
 //#region src/utils/mod-attrs.d.ts
-declare const _modAttrs: (firstArg: Record<string, ModValue> | undefined, secondArg?: unknown) => Record<string, string> | null;
-//#endregion
-//#region src/utils/dotize.d.ts
-declare const dotize: {
-  valTypes: {
-    none: string;
-    primitive: string;
-    object: string;
-    array: string;
-  };
-  getValType: (val: any) => string | undefined;
-  getPathType: (arrPath: any) => string[];
-  isUndefined: (obj: any) => obj is undefined;
-  isNumber: (f: any) => boolean;
-  isEmptyObj: (obj: any) => boolean;
-  isPlainObject: (obj: any) => boolean;
-  isNotObject: (obj: any) => boolean;
-  isEmptyArray: (arr: any) => boolean;
-  isNotArray: (arr: any) => boolean;
-  removeEmptyArrayItem: (arr: any) => any;
-  getFieldName: (field: any, prefix: any, isRoot: any, isArrayItem: any, isArray: any) => string;
-  startsWith: (val: any, valToSearch: any) => boolean;
-  convert: (obj: any, prefix?: string) => any;
-  backward: (obj: any, prefix: any) => any;
-};
+declare function modAttrs(map: AllBaseProps['mods']): Record<string, string> | null;
 //#endregion
 //#region src/utils/resolve-recipes.d.ts
-/**
- * Resolve all `recipe` style properties in a styles object.
- *
- * Handles both top-level and sub-element recipe references.
- * Returns the same object reference if no recipes are present anywhere
- * (zero overhead for the common case).
- *
- * @param styles - The styles object potentially containing `recipe` keys
- * @returns Resolved styles with recipe values merged in, or the original object if unchanged
- */
+/** Resolve recipe references against the globally configured recipe map. */
 declare function resolveRecipes(styles: Styles): Styles;
 //#endregion
 //#region src/utils/process-tokens.d.ts
 /**
  * Process tokens object into inline style properties.
- * - $name -> --name with parsed value
- * - #name -> --name-color with parsed value
+ * - `$name` -> `--name` with the parsed value
+ * - `#name` -> `--name-color` with the parsed value
  *
  * @param tokens - The tokens object to process
  * @returns CSSProperties object or undefined if no tokens to process
@@ -1863,7 +1873,13 @@ interface ChunkBreakdown {
 }
 interface Summary {
   activeClasses: string[];
+  /** Classes `gc({ force: true })` would delete right now. */
   unusedClasses: string[];
+  /**
+   * Held but in neither list: nothing renders them, yet collection will not
+   * take them — inside the grace window, or pinned by an `inject()` handle.
+   */
+  hotClasses: string[];
   totalStyledClasses: string[];
   activeCSSSize: number;
   unusedCSSSize: number;
@@ -1900,5 +1916,5 @@ declare const tastyDebug: {
   install(): void;
 };
 //#endregion
-export { okhstFunction as $, PositionStyleProps as $t, keyframes as A, TastyElementProps as At, ChunkInfo as B, BaseStyleProps as Bt, getCSSTextForNode as C, ResolveModPropDef as Ct, injectRawCSS as D, SubElementProps as Dt, injectGlobal as E, SubElementDefinition as Et, ComputeStylesOptions as F, WithVariant as Ft, DIMENSION_CHUNK_STYLES as G, ContainerStyleProps as Gt, APPEARANCE_CHUNK_STYLES as H, BlockOuterStyleProps as Ht, ComputeStylesResult as I, tasty as It, LAYOUT_CHUNK_STYLES as J, FlowStyleProps as Jt, DISPLAY_CHUNK_STYLES as K, DimensionStyleProps as Kt, computeStyles as L, AllBaseProps as Lt, touch as M, TastyProps as Mt, ChunkSheetRegistry as N, TokenPropsInput as Nt, injector as O, TastyComponentPropsWithDefaults as Ot, chunkSheetRegistry as P, VariantMap as Pt, createColorFunc as Q, OuterStyleProps as Qt, defineHandler as R, BaseProps as Rt, getCSSText as S, DEFAULT_ZERO_NAME_PREFIX as Sn, ResolveAsProps as St, inject as T, ResolveTokenProps as Tt, CHUNK_NAMES as U, BlockStyleProps as Ut, categorizeStyleKeys as V, BlockInnerStyleProps as Vt, ChunkName as W, ColorStyleProps as Wt, STYLE_TO_CHUNK as X, ModValue as Xt, POSITION_CHUNK_STYLES as Y, InnerStyleProps as Yt, resolveFunctionColor as Z, Mods as Zt, createInjector as _, INNER_STYLES as _n, AllBasePropsWithMods as _t, DebugOptions as a, TastyThemeNames as an, TastyBatchProviderProps as at, func as b, TEXT_STYLES as bn, ModPropDef as bt, tastyDebug as c, Tokens as cn, useCounterStyle as ct, dotize as d, BLOCK_OUTER_STYLES as dn, useProperty as dt, ShortGridStyles as en, okhstPlugin as et, _modAttrs as f, BLOCK_STYLES as fn, useKeyframes as ft, counterStyle as g, FLOW_STYLES as gn, useStyles as gt, cleanup as h, DIMENSION_STYLES as hn, UseStylesResult as ht, DebugChunkInfo as i, TastyExtensionConfig as in, TastyBatchProvider as it, property as j, TastyPolymorphicComponent as jt, isPropertyDefined as k, TastyElementOptions as kt, processTokens as l, BASE_STYLES as ln, useFontFace as lt, filterBaseProps as m, CONTAINER_STYLES as mn, useGlobalStyles as mt, CacheStatus as n, TastyBaseStylePropNames as nn, okhslPlugin as nt, InspectResult as o, TextStyleProps as on, UseFunctionOptions as ot, color$1 as p, COLOR_STYLES as pn, useRawCSS as pt, FONT_CHUNK_STYLES as q, ExtraBaseStyleProps as qt, ChunkBreakdown as r, TastyCustomProps as rn, getDisplayName as rt, Summary as s, TokenValue as sn, useFunction as st, CSSOptions as t, TagName as tn, okhslFunction as tt, resolveRecipes as u, BLOCK_INNER_STYLES as un, UsePropertyOptions as ut, destroy as v, OUTER_STYLES as vn, Element$1 as vt, getRawCSSText as w, ResolveModProps as wt, gc as x, DEFAULT_NAME_PREFIX as xn, ModPropsInput as xt, fontFace as y, POSITION_STYLES as yn, ElementsDefinition as yt, styleHandlers as z, BasePropsWithoutChildren as zt };
-//# sourceMappingURL=index-D1nMkpUe.d.ts.map
+export { createColorFunc as $, OuterStyleProps as $t, keyframes as A, strToRgb as An, TastyElementOptions as At, styleHandlers as B, BasePropsWithoutChildren as Bt, getRawCSSText as C, DEFAULT_ZERO_NAME_PREFIX as Cn, ResolveAsProps as Ct, injectRawCSS as D, getRgbValuesFromRgbaString as Dn, SubElementDefinition as Dt, injectGlobal as E, getNamedColorHex as En, ResolveTokenProps as Et, chunkSheetRegistry as F, VariantMap as Ft, ChunkName as G, ColorStyleProps as Gt, categorizeStyleKeys as H, BlockInnerStyleProps as Ht, ComputeStylesOptions as I, WithVariant as It, FONT_CHUNK_STYLES as J, ExtraBaseStyleProps as Jt, DIMENSION_CHUNK_STYLES as K, ContainerStyleProps as Kt, ComputeStylesResult as L, tasty as Lt, property as M, TastyPolymorphicComponent as Mt, touch as N, TastyProps as Nt, injector as O, hexToRgb as On, SubElementProps as Ot, ChunkSheetRegistry as P, TokenPropsInput as Pt, resolveFunctionColor as Q, Mods as Qt, computeStyles as R, AllBaseProps as Rt, getCSSTextForNode as S, DEFAULT_NAME_PREFIX as Sn, ModPropsInput as St, inject as T, isSelector as Tn, ResolveModProps as Tt, APPEARANCE_CHUNK_STYLES as U, BlockOuterStyleProps as Ut, ChunkInfo as V, BaseStyleProps as Vt, CHUNK_NAMES as W, BlockStyleProps as Wt, POSITION_CHUNK_STYLES as X, InnerStyleProps as Xt, LAYOUT_CHUNK_STYLES as Y, FlowStyleProps as Yt, STYLE_TO_CHUNK as Z, ModValue as Zt, destroy as _, FLOW_STYLES as _n, useStyles as _t, DebugOptions as a, TastyExtensionConfig as an, TastyBatchProvider as at, gc as b, POSITION_STYLES as bn, ElementsDefinition as bt, tastyDebug as c, TokenValue as cn, useFunction as ct, modAttrs as d, BLOCK_INNER_STYLES as dn, UsePropertyOptions as dt, PositionStyleProps as en, okhstFunction as et, color$1 as f, BLOCK_OUTER_STYLES as fn, useProperty as ft, createInjector as g, DIMENSION_STYLES as gn, UseStylesResult as gt, counterStyle as h, CONTAINER_STYLES as hn, useGlobalStyles as ht, DebugChunkInfo as i, TastyCustomProps as in, getDisplayName as it, ownKeyframes as j, TastyElementProps as jt, isPropertyDefined as k, hslToRgbValues as kn, TastyComponentPropsWithDefaults as kt, processTokens as l, Tokens as ln, useCounterStyle as lt, cleanup as m, COLOR_STYLES as mn, useRawCSS as mt, CacheStatus as n, TagName as nn, okhslFunction as nt, InspectResult as o, TastyThemeNames as on, TastyBatchProviderProps as ot, filterBaseProps as p, BLOCK_STYLES as pn, useKeyframes as pt, DISPLAY_CHUNK_STYLES as q, DimensionStyleProps as qt, ChunkBreakdown as r, TastyBaseStylePropNames as rn, okhslPlugin as rt, Summary as s, TextStyleProps as sn, UseFunctionOptions as st, CSSOptions as t, ShortGridStyles as tn, okhstPlugin as tt, resolveRecipes as u, BASE_STYLES as un, useFontFace as ut, fontFace as v, INNER_STYLES as vn, AllBasePropsWithMods as vt, holdKeyframes as w, hasStylesGenerated as wn, ResolveModPropDef as wt, getCSSText as x, TEXT_STYLES as xn, ModPropDef as xt, func as y, OUTER_STYLES as yn, Element$1 as yt, defineHandler as z, BaseProps as zt };
+//# sourceMappingURL=index-G9JuwM9p.d.ts.map