@tenphi/tasty 2.0.3 → 2.1.0

package/dist/injector/injector.d.ts

@@ -1,198 +0,0 @@
-import { CacheMetrics, CounterStyleDescriptors, FontFaceDescriptors, GCOptions, GlobalInjectResult, InjectResult, KeyframesResult, KeyframesSteps, PropertyDefinition, RawCSSResult, StyleInjectorConfig } from "./types.js";
-import { StyleResult } from "../pipeline/index.js";
-import { SheetManager } from "./sheet-manager.js";
-
-//#region src/injector/injector.d.ts
-declare class StyleInjector {
-  private sheetManager;
-  private config;
-  private globalRuleCounter;
-  private pendingGCHandle;
-  /** @internal — exposed for debug utilities only */
-  get _sheetManager(): SheetManager;
-  constructor(config?: StyleInjectorConfig);
-  /**
-   * Check if `className` was hydrated from server-rendered styles and,
-   * if so, wire the cacheKey mapping. Returns true on hit.
-   */
-  private tryHydratedHit;
-  /**
-   * Allocate a className for a cacheKey without injecting styles yet.
-   * This allows separating className allocation (render phase) from style injection (insertion phase).
-   */
-  allocateClassName(cacheKey: string, options?: {
-    root?: Document | ShadowRoot;
-  }): {
-    className: string;
-    isNewAllocation: boolean;
-  };
-  /**
-   * Inject styles from StyleResult objects
-   */
-  inject(rules: StyleResult[], options?: {
-    root?: Document | ShadowRoot;
-    cacheKey?: string;
-  }): InjectResult;
-  /**
-   * Inject global styles (rules without a generated tasty class selector)
-   * This ensures we don't reserve a tasty class name (t{number}) for global rules,
-   * which could otherwise collide with element-level styles and break lookups.
-   */
-  injectGlobal(rules: StyleResult[], options?: {
-    root?: Document | ShadowRoot;
-  }): GlobalInjectResult;
-  /**
-   * Inject raw CSS text directly without parsing
-   * This is a low-overhead alternative to createGlobalStyle for raw CSS
-   * The CSS is inserted into a separate style element to avoid conflicts with tasty's chunking
-   */
-  injectRawCSS(css: string, options?: {
-    root?: Document | ShadowRoot;
-  }): RawCSSResult;
-  /**
-   * Get raw CSS text for SSR
-   */
-  getRawCSSText(options?: {
-    root?: Document | ShadowRoot;
-  }): string;
-  /**
-   * Increment refCount for an already-injected cacheKey and return a dispose.
-   * Used by useStyles on cache hits (hydration or runtime reuse) where
-   * the pipeline was skipped but refCount tracking is still needed.
-   * Returns null if the cacheKey is not found.
-   */
-  trackRef(cacheKey: string, options?: {
-    root?: Document | ShadowRoot;
-  }): InjectResult | null;
-  /**
-   * Dispose of a className (decrements refCount only).
-   */
-  private dispose;
-  /**
-   * Force bulk cleanup of unused styles
-   */
-  cleanup(root?: Document | ShadowRoot): void;
-  /**
-   * Get CSS text from all sheets (for SSR)
-   */
-  getCssText(options?: {
-    root?: Document | ShadowRoot;
-  }): string;
-  /**
-   * Get CSS only for the provided tasty classNames (e.g., ["t0","t3"])
-   */
-  getCssTextForClasses(classNames: Iterable<string>, options?: {
-    root?: Document | ShadowRoot;
-  }): string;
-  /**
-   * Get cache performance metrics
-   */
-  getMetrics(options?: {
-    root?: Document | ShadowRoot;
-  }): CacheMetrics | null;
-  /**
-   * Reset cache performance metrics
-   */
-  resetMetrics(options?: {
-    root?: Document | ShadowRoot;
-  }): void;
-  /**
-   * Define a CSS @property custom property.
-   *
-   * Accepts tasty token syntax for the property name:
-   * - `$name` → defines `--name`
-   * - `#name` → defines `--name-color` (auto-sets syntax: '<color>', defaults initialValue: 'transparent')
-   * - `--name` → defines `--name` (legacy format)
-   *
-   * Example:
-   * @property --rotation { syntax: "<angle>"; inherits: false; initial-value: 45deg; }
-   *
-   * Note: No caching or dispose — this defines a global property.
-   *
-   * If the same property is registered with different options, a warning is emitted
-   * but the original definition is preserved (CSS @property cannot be redefined).
-   */
-  property(name: string, options?: PropertyDefinition & {
-    root?: Document | ShadowRoot;
-  }): void;
-  /**
-   * Check whether a given @property name was already injected by this injector.
-   *
-   * Accepts tasty token syntax:
-   * - `$name` → checks `--name`
-   * - `#name` → checks `--name-color`
-   * - `--name` → checks `--name` (legacy format)
-   */
-  isPropertyDefined(name: string, options?: {
-    root?: Document | ShadowRoot;
-  }): boolean;
-  /**
-   * Inject a CSS @font-face rule.
-   *
-   * Permanent and global — no dispose or ref-counting.
-   * Deduplicates by content hash (family + descriptors).
-   */
-  fontFace(family: string, descriptors: FontFaceDescriptors, options?: {
-    root?: Document | ShadowRoot;
-  }): void;
-  /**
-   * Inject a CSS @counter-style rule.
-   *
-   * Permanent and global — no dispose or ref-counting.
-   * Deduplicates by name (first definition wins).
-   */
-  counterStyle(name: string, descriptors: CounterStyleDescriptors, options?: {
-    root?: Document | ShadowRoot;
-  }): void;
-  /**
-   * Inject keyframes and return object with toString() and dispose()
-   *
-   * Keyframes are cached by content (steps). If the same content is injected
-   * multiple times with different provided names, the first injected name is reused.
-   *
-   * If the same name is provided with different content (collision), a unique
-   * name is generated to avoid overwriting the existing keyframes.
-   */
-  keyframes(steps: KeyframesSteps, nameOrOptions?: string | {
-    root?: Document | ShadowRoot;
-    name?: string;
-  }): KeyframesResult;
-  /**
-   * Dispose keyframes
-   */
-  private disposeKeyframes;
-  private static readonly TASTY_CLASS_RE;
-  /**
-   * Record a render-time usage hit for one or more classNames.
-   * Handles space-separated multi-chunk classNames.
-   * When the global touch counter reaches `touchInterval`, schedules a GC
-   * via `requestIdleCallback`.
-   * No-op on the server.
-   */
-  touch(className: string, options?: {
-    root?: Document | ShadowRoot;
-  }): void;
-  /**
-   * Schedule a GC via `requestIdleCallback` (or synchronously as fallback).
-   * Runs GC on all active roots. Avoids double-scheduling via `pendingGCHandle`.
-   */
-  private scheduleGC;
-  /**
-   * Synchronous garbage collection.
-   *
-   * 1. Quick upper-bound check: skip if unused count can't exceed capacity.
-   * 2. Scans the DOM for live tasty classNames (safety guard).
-   * 3. With `force: true`: deletes all unused entries inline.
-   *    Without `force`: collects unused, sorts oldest-first, evicts over capacity.
-   *
-   * @returns Number of styles evicted.
-   */
-  gc(options?: GCOptions): number;
-  /**
-   * Destroy all resources for a root
-   */
-  destroy(root?: Document | ShadowRoot): void;
-}
-//#endregion
-export { StyleInjector };
-//# sourceMappingURL=injector.d.ts.map