@tenphi/tasty 0.0.0-snapshot.27b6708 → 0.0.0-snapshot.28eb83c

package/dist/{index-Cd45t5NM.d.ts → index-BzAC3p06.d.ts}

@@ -153,6 +153,11 @@ interface StyleInjectorConfig {
 /**
  * Per-className usage tracking for GC.
  */
+/**
+ * @deprecated Nothing reads this any more. Collection asks the DOM what is
+ * rendered rather than tracking usage per class, so there is no usage record
+ * to describe. Kept so existing imports keep type-checking.
+ */
 interface StyleUsage {
   lastTouchedAt: number;
 }
@@ -165,19 +170,47 @@ interface StyleUsage {
  */
 interface GCConfig {
   /**
-   * Number of touch events between GC cycles.
+   * How long a class is left alone after collection first notices nothing is
+   * carrying it, in milliseconds (default 10,000).
+   *
+   * Rendering is not commit-aware: a render can resolve a class and commit it a
+   * little later, and in between nothing on the page carries it. Rather than
+   * try to tell that apart from a class that is finished — which cannot be done
+   * from outside React — collection simply does not touch anything that was in
+   * use recently. A render would have to stay pending for the whole window to
+   * lose its rules, and it gets them back on its next render.
+   */
+  grace?: number;
+  /**
+   * Number of touch events between automatic GC cycles.
    * @default 1000
    */
   touchInterval?: number;
   /**
    * Maximum number of unused styles to retain.
    * GC evicts the oldest unused styles when this limit is exceeded.
-   * Actively referenced styles (refCount > 0) and DOM-live styles
+   * Pinned styles and DOM-live styles
    * do not count against this limit.
    * @default 1000
    */
   capacity?: number;
 }
+/**
+ * Per-call options for inject().
+ */
+interface InjectOptions {
+  root?: Document | ShadowRoot;
+  /** Reuse the class already injected for this key instead of writing again. */
+  cacheKey?: string;
+  /**
+   * Pin the injected class (default `true`). A pinned class is never evicted by
+   * `gc()`, and the returned `dispose()` releases the pin. Pass `false` when the
+   * caller keeps no handle and the DOM is the only record that the class is in
+   * use — the render path does this, because a hook-free render has no unmount
+   * signal to dispose on.
+   */
+  pin?: boolean;
+}
 /**
  * Per-call options for gc().
  */
@@ -236,7 +269,8 @@ interface CacheMetrics {
 }
 interface RootRegistry {
   sheets: SheetInfo[];
-  refCounts: Map<string, number>;
+  /** className -> outstanding `inject()` references; 0 means nobody holds a handle */
+  pinCounts: Map<string, number>;
   rules: Map<string, RuleInfo>;
   /** Cache key to className mapping to avoid dual storage of RuleInfo objects */
   cacheKeyToClassName: Map<string, string>;
@@ -270,18 +304,38 @@ interface RootRegistry {
   globalRules: Map<string, RuleInfo>;
   /** Resolver for auto-inferring @property types from declaration values */
   propertyTypeResolver: PropertyTypeResolver;
-  /** Per-className usage tracking for GC */
-  usageMap: Map<string, StyleUsage>;
-  /** Touch counter for scheduling GC (per-root) */
-  touchCount: number;
   /**
-   * Millisecond that `touchedTick` refers to. `touch()` only ever stamps
-   * `lastTouchedAt` with the current millisecond, so a repeat touch of the same
-   * class name inside one millisecond is a no-op worth skipping.
+   * className -> when the class was first noticed to be carrying nothing:
+   * injection, or the first sweep that looked and did not find it on an
+   * element. Cleared the moment a sweep finds it rendered again.
+   *
+   * Deliberately "when it was noticed", not "when it stopped being rendered".
+   * Nothing observes the moment an element leaves, so a class that unmounted
+   * just before a sweep and one that unmounted just after the previous sweep
+   * would otherwise be treated differently — and the first would lose its
+   * grace window entirely. Starting the clock at the sighting gives every
+   * class the same full window, whenever it actually went.
+   *
+   * Written only by the sweep's own DOM scan and at injection, so rendering
+   * never pays for it.
    */
-  touchTick: number;
-  /** Class-name strings already touched during `touchTick`. */
-  touchedTick: Set<string>;
+  unusedSince: Map<string, number>;
+  /**
+   * Local `@keyframes` a class animates, by the name they were authored under.
+   *
+   * One reference is held per distinct set of steps, however many renders ask
+   * for it, and the classes that animate it own that reference between them.
+   * The last of them to be deleted releases it, so keyframes cannot outlive
+   * every rule that referred to them, and repeat renders cannot pile up
+   * references nobody gives back.
+   */
+  localKeyframes: Map<string, {
+    name: string;
+    dispose: () => void;
+    owners: Set<string>;
+  }>;
+  /** Renders since the last scheduled sweep (per-root) */
+  touchCount: number;
   /** How many entries from `window.__TASTY__` have been synced into this registry */
   serverClassSyncIndex: number;
   /** Whether `<style data-tasty-rsc>` tags have been scanned for class names */
@@ -662,7 +716,7 @@ declare function parseStyle(value: StyleValue): ProcessedStyle;
  * Optimized to avoid heavy parseStyle calls for simple color patterns.
  */
 declare function parseColor(val: string, ignoreError?: boolean): ParsedColor;
-declare function filterMods(mods: string[], allowedMods: string[]): string[];
+declare function filterMods(mods: string[], allowedMods: readonly string[]): string[];
 declare function stringifyStyles(styles: unknown): string;
 //#endregion
 //#region src/styles/types.d.ts
@@ -705,7 +759,7 @@ type Digit = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
 type OpaquePercentage = '' | `.${Digit}` | `.${Digit}${Digit}` | '.100';
 type ColorValue = `#${NamedColor}${OpaquePercentage}` | `rgb(${string})` | `hsl(${string})` | `okhsl(${string})` | `oklch(${string})` | (string & {});
 type NoType = false | null | undefined;
-interface StylesInterface extends Omit<CSSProperties, 'color' | 'fill' | 'font' | 'outline' | 'type' | 'gap' | 'padding' | 'margin' | 'width' | 'height' | 'border' | 'transition' | 'placeContent' | 'placeItems' | 'scrollMargin' | 'scrollMarginTop' | 'scrollMarginRight' | 'scrollMarginBottom' | 'scrollMarginLeft' | 'scrollMarginBlock' | 'scrollMarginInline'> {
+interface StylesInterface extends Omit<CSSProperties, 'color' | 'fill' | 'font' | 'outline' | 'type' | 'gap' | 'padding' | 'margin' | 'width' | 'height' | 'blockSize' | 'inlineSize' | 'border' | 'transition' | 'placeContent' | 'placeItems' | 'scrollMargin' | 'scrollMarginTop' | 'scrollMarginRight' | 'scrollMarginBottom' | 'scrollMarginLeft' | 'scrollPadding' | 'scrollPaddingTop' | 'scrollPaddingRight' | 'scrollPaddingBottom' | 'scrollPaddingLeft'> {
   /**
    * @deprecated Use `flow` style instead.
    */
@@ -857,6 +911,10 @@ interface StylesInterface extends Omit<CSSProperties, 'color' | 'fill' | 'font'
    * - `padding={true}` // default padding on all sides
    */
   padding?: CSSProperties['padding'] | string | boolean;
+  /** Logical block-axis padding with `start`/`end` modifiers. */
+  blockPadding?: CSSProperties['paddingBlock'] | string | boolean;
+  /** Logical inline-axis padding with `start`/`end` modifiers. */
+  inlinePadding?: CSSProperties['paddingInline'] | string | boolean;
   /**
    * Shorthand for element margin. Supports custom units, directional modifiers, and design-system-driven defaults.
    *
@@ -871,6 +929,10 @@ interface StylesInterface extends Omit<CSSProperties, 'color' | 'fill' | 'font'
    * - `margin={true}` // default margin on all sides
    */
   margin?: CSSProperties['margin'] | string | boolean;
+  /** Logical block-axis margin with `start`/`end` modifiers. */
+  blockMargin?: CSSProperties['marginBlock'] | string | boolean;
+  /** Logical inline-axis margin with `start`/`end` modifiers. */
+  inlineMargin?: CSSProperties['marginInline'] | string | boolean;
   /**
    * Concise shorthand for setting element width, including min-width and max-width. Supports custom units and advanced sizing keywords.
    *
@@ -902,6 +964,16 @@ interface StylesInterface extends Omit<CSSProperties, 'color' | 'fill' | 'font'
    * - `height={true}` // height: auto
    */
   height?: CSSProperties['height'] | string | boolean;
+  /**
+   * Logical block size with the same enhanced min/max/fixed syntax as `width`.
+   * Emits native `block-size`, `min-block-size`, and `max-block-size` declarations.
+   */
+  blockSize?: CSSProperties['blockSize'] | string | boolean;
+  /**
+   * Logical inline size with the same enhanced min/max/fixed syntax as `width`.
+   * Emits native `inline-size`, `min-inline-size`, and `max-inline-size` declarations.
+   */
+  inlineSize?: CSSProperties['inlineSize'] | string | boolean;
   /**
    * Shorthand for border width, style, and color. Supports directional modifiers and design-system defaults.
    *
@@ -923,6 +995,10 @@ interface StylesInterface extends Omit<CSSProperties, 'color' | 'fill' | 'font'
    * custom property directly, name it `$name-color`.
    */
   border?: CSSProperties['border'] | string | boolean;
+  /** Logical block-axis border with `start`/`end` modifiers. */
+  blockBorder?: CSSProperties['borderBlock'] | string | boolean;
+  /** Logical inline-axis border with `start`/`end` modifiers. */
+  inlineBorder?: CSSProperties['borderInline'] | string | boolean;
   /**
    * Powerful shorthand for CSS transitions using semantic names and design tokens. Supports grouped transitions for common UI effects.
    *
@@ -1128,8 +1204,23 @@ interface StylesInterface extends Omit<CSSProperties, 'color' | 'fill' | 'font'
   scrollMarginRight?: string | number | boolean;
   scrollMarginBottom?: string | number | boolean;
   scrollMarginLeft?: string | number | boolean;
-  scrollMarginBlock?: string | number | boolean;
-  scrollMarginInline?: string | number | boolean;
+  /** Logical block-axis scroll margin with `start`/`end` modifiers. */
+  blockScrollMargin?: CSSProperties['scrollMarginBlock'] | string | boolean;
+  /** Logical inline-axis scroll margin with `start`/`end` modifiers. */
+  inlineScrollMargin?: CSSProperties['scrollMarginInline'] | string | boolean;
+  /**
+   * Shorthand for physical scroll padding. Supports custom units and the same
+   * physical direction modifiers as `padding`.
+   */
+  scrollPadding?: CSSProperties['scrollPadding'] | string | boolean;
+  scrollPaddingTop?: string | number | boolean;
+  scrollPaddingRight?: string | number | boolean;
+  scrollPaddingBottom?: string | number | boolean;
+  scrollPaddingLeft?: string | number | boolean;
+  /** Logical block-axis scroll padding with `start`/`end` modifiers. */
+  blockScrollPadding?: CSSProperties['scrollPaddingBlock'] | string | boolean;
+  /** Logical inline-axis scroll padding with `start`/`end` modifiers. */
+  inlineScrollPadding?: CSSProperties['scrollPaddingInline'] | string | boolean;
   /**
    * Shorthand for `top`, `right`, `bottom`, and `left` offsets. Supports custom units, directional modifiers, and positioning.
    *
@@ -1151,6 +1242,10 @@ interface StylesInterface extends Omit<CSSProperties, 'color' | 'fill' | 'font'
    * insets the sides by `4x`. Without `dock` a second value is ignored.
    */
   inset?: 'top' | 'right' | 'bottom' | 'left' | 'dock' | string | CSSProperties['inset'];
+  /** Logical block-axis inset with `start`/`end` modifiers. */
+  blockInset?: CSSProperties['insetBlock'] | string | boolean;
+  /** Logical inline-axis inset with `start`/`end` modifiers. */
+  inlineInset?: CSSProperties['insetInline'] | string | boolean;
   /**
    * Local keyframes definitions for this component.
    * Keys are animation names, values are keyframes step definitions.
@@ -1281,6 +1376,10 @@ type ConfigTokenValue = string | number | boolean | Record<string, string | numb
  */
 type ConfigTokens = Record<`$${string}` | `#${string}`, ConfigTokenValue>;
 //#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/pipeline/conditions.d.ts
 /**
  * ConditionNode Types and Helpers
@@ -1488,10 +1587,6 @@ interface RenderResult {
   rules: StyleResult[];
   className?: string;
 }
-/**
- * Check if a key is a CSS selector
- */
-declare function isSelector(key: string): boolean;
 /**
  * Options for renderStyles when using direct selector mode.
  */
@@ -1517,5 +1612,5 @@ interface RenderStylesOptions {
 declare function renderStyles(styles?: Styles, classNameOrSelector?: undefined, options?: undefined, pipelineCacheKey?: string): RenderResult;
 declare function renderStyles(styles: Styles | undefined, classNameOrSelector: string, options?: RenderStylesOptions): StyleResult[];
 //#endregion
-export { StyleParser as $, ParsedColor as A, StyleUsage as At, StyleValueStateMap as B, SuffixForSelector as C, PropertyOptions as Ct, CSSMap as D, SheetInfo as Dt, AnyStyleHandler as E, RuleInfo as Et, StyleHandlerProps as F, parseColor as G, getGlobalParser as H, StyleHandlerResult as I, getNamedColorHex as J, parseStyle as K, StyleMap as L, ResolvedStyleValue as M, flushStyles as Mt, StyleHandler as N, hasPendingStyleWrites as Nt, CUSTOM_UNITS as O, StyleInjectorConfig as Ot, StyleHandlerDefinition as P, resetStyleBatch as Pt, strToRgb as Q, StylePropValue as R, StylesWithoutSelectors as S, PropertyDefinition as St, TastyPresetNames as T, RootRegistry as Tt, getGlobalPredefinedTokens as U, filterMods as V, normalizeColorTokenValue as W, hexToRgb as X, getRgbValuesFromRgbaString as Y, hslToRgbValues as Z, NotSelector as _, InjectionMode as _t, ParseStateKeyOptions as a, CSSProperties as at, Styles as b, KeyframesResult as bt, ParsedAdvancedState as c, DisposeFunction as ct, getGlobalPredefinedStates as d, FunctionDefinition as dt, ParserOptions as et, setGlobalPredefinedStates as f, FunctionParameter as ft, NoType as g, InjectResult as gt, ConfigTokens as h, GlobalInjectResult as ht, renderStyles as i, UnitHandler as it, RawStyleHandler as j, QueuedWrite as jt, DIRECTIONS as k, StyleRule as kt, StateParserContext as l, FontFaceDescriptors as lt, ConfigTokenValue as m, GCOptions as mt, StyleResult as n, StyleDetails as nt, parseStateKey as o, CacheMetrics as ot, ConditionNode as p, GCConfig as pt, stringifyStyles as q, isSelector as r, StyleDetailsPart as rt, AtRuleContext as s, CounterStyleDescriptors as st, RenderResult as t, ProcessedStyle as tt, createStateParserContext as u, FontFaceInput as ut, RecipeStyles as v, KeyframesCacheEntry as vt, TastyNamedColors as w, RawCSSResult as wt, StylesInterface as x, KeyframesSteps as xt, Selector as y, KeyframesInfo as yt, StyleValue as z };
-//# sourceMappingURL=index-Cd45t5NM.d.ts.map
+export { StyleParser as $, ParsedColor as A, StyleRule as At, StyleValueStateMap as B, SuffixForSelector as C, PropertyDefinition as Ct, CSSMap as D, RuleInfo as Dt, AnyStyleHandler as E, RootRegistry as Et, StyleHandlerProps as F, resetStyleBatch as Ft, parseColor as G, getGlobalParser as H, StyleHandlerResult as I, getNamedColorHex as J, parseStyle as K, StyleMap as L, ResolvedStyleValue as M, QueuedWrite as Mt, StyleHandler as N, flushStyles as Nt, CUSTOM_UNITS as O, SheetInfo as Ot, StyleHandlerDefinition as P, hasPendingStyleWrites as Pt, strToRgb as Q, StylePropValue as R, StylesWithoutSelectors as S, KeyframesSteps as St, TastyPresetNames as T, RawCSSResult as Tt, getGlobalPredefinedTokens as U, filterMods as V, normalizeColorTokenValue as W, hexToRgb as X, getRgbValuesFromRgbaString as Y, hslToRgbValues as Z, NotSelector as _, InjectResult as _t, parseStateKey as a, CSSProperties as at, Styles as b, KeyframesInfo as bt, StateParserContext as c, DisposeFunction as ct, setGlobalPredefinedStates as d, FunctionDefinition as dt, ParserOptions as et, ConditionNode as f, FunctionParameter as ft, NoType as g, InjectOptions as gt, ConfigTokens as h, GlobalInjectResult as ht, ParseStateKeyOptions as i, UnitHandler as it, RawStyleHandler as j, StyleUsage as jt, DIRECTIONS as k, StyleInjectorConfig as kt, createStateParserContext as l, FontFaceDescriptors as lt, ConfigTokenValue as m, GCOptions as mt, StyleResult as n, StyleDetails as nt, AtRuleContext as o, CacheMetrics as ot, isSelector as p, GCConfig as pt, stringifyStyles as q, renderStyles as r, StyleDetailsPart as rt, ParsedAdvancedState as s, CounterStyleDescriptors as st, RenderResult as t, ProcessedStyle as tt, getGlobalPredefinedStates as u, FontFaceInput as ut, RecipeStyles as v, InjectionMode as vt, TastyNamedColors as w, PropertyOptions as wt, StylesInterface as x, KeyframesResult as xt, Selector as y, KeyframesCacheEntry as yt, StyleValue as z };
+//# sourceMappingURL=index-BzAC3p06.d.ts.map