@tenphi/tasty 0.13.1 → 0.14.0

package/dist/debug.d.ts

@@ -1,17 +1,21 @@
+import { CacheMetrics } from "./injector/types.js";
+
 //#region src/debug.d.ts
-/**
- * Debug utilities for inspecting tasty-generated CSS at runtime
- */
 declare global {
   interface Window {
     tastyDebug?: typeof tastyDebug;
   }
 }
 type CSSTarget = 'all' | 'global' | 'active' | 'unused' | 'page' | string | string[] | Element;
-interface CssOptions {
+interface DebugOptions {
   root?: Document | ShadowRoot;
+  /** Suppress console logging and return data only (default: false) */
+  raw?: boolean;
+}
+interface CssOptions extends DebugOptions {
   prettify?: boolean;
-  log?: boolean;
+  /** Read from stored source CSS (dev-mode only) instead of live CSSOM */
+  source?: boolean;
 }
 interface ChunkInfo {
   className: string;
@@ -25,22 +29,6 @@ interface InspectResult {
   size: number;
   rules: number;
 }
-interface CacheMetrics {
-  hits: number;
-  misses: number;
-  bulkCleanups: number;
-  totalInsertions: number;
-  totalUnused: number;
-  stylesCleanedUp: number;
-  cleanupHistory: {
-    timestamp: number;
-    classesDeleted: number;
-    cssSize: number;
-    rulesDeleted: number;
-  }[];
-  startTime: number;
-  unusedHits?: number;
-}
 interface CacheStatus {
   classes: {
     active: string[];
@@ -49,17 +37,14 @@ interface CacheStatus {
   };
   metrics: CacheMetrics | null;
 }
-interface Definitions {
-  properties: string[];
-  keyframes: {
-    name: string;
-    refCount: number;
-  }[];
-}
-interface SummaryOptions {
-  root?: Document | ShadowRoot;
-  log?: boolean;
-  includePageCSS?: false | true | 'all';
+interface ChunkBreakdown {
+  byChunk: Record<string, {
+    classes: string[];
+    cssSize: number;
+    ruleCount: number;
+  }>;
+  totalChunkTypes: number;
+  totalClasses: number;
 }
 interface Summary {
   activeClasses: string[];
@@ -72,132 +57,32 @@ interface Summary {
   keyframesCSSSize: number;
   propertyCSSSize: number;
   totalCSSSize: number;
-  activeCSS: string;
-  unusedCSS: string;
-  globalCSS: string;
-  rawCSS: string;
-  keyframesCSS: string;
-  propertyCSS: string;
-  allCSS: string;
+  activeRuleCount: number;
+  unusedRuleCount: number;
   globalRuleCount: number;
   rawRuleCount: number;
   keyframesRuleCount: number;
   propertyRuleCount: number;
-  page?: {
-    css?: string;
-    cssSize: number;
-    ruleCount: number;
-    stylesheetCount: number;
-    skippedStylesheets: number;
-  };
+  totalRuleCount: number;
   metrics: CacheMetrics | null;
   definedProperties: string[];
   definedKeyframes: {
     name: string;
     refCount: number;
   }[];
-  propertyCount: number;
-  keyframeCount: number;
-  cleanupSummary: {
-    enabled: boolean;
-    totalCleanups: number;
-    totalClassesDeleted: number;
-    totalCssDeleted: number;
-    totalRulesDeleted: number;
-    averageClassesPerCleanup: number;
-    averageCssPerCleanup: number;
-    averageRulesPerCleanup: number;
-    lastCleanup?: {
-      timestamp: number;
-      date: string;
-      classesDeleted: number;
-      cssSize: number;
-      rulesDeleted: number;
-    };
-  };
-  chunkBreakdown: {
-    byChunk: Record<string, {
-      classes: string[];
-      cssSize: number;
-      ruleCount: number;
-    }>;
-    totalChunkTypes: number;
-  };
+  chunkBreakdown: ChunkBreakdown;
 }
-/**
- * Concise tastyDebug API for inspecting styles at runtime
- */
 declare const tastyDebug: {
   css(target: CSSTarget, opts?: CssOptions): string;
-  inspect(target: string | Element, opts?: {
-    root?: Document | ShadowRoot;
-  }): InspectResult;
-  cache(opts?: {
-    root?: Document | ShadowRoot;
-    includeHistory?: boolean;
-  }): CacheStatus;
+  inspect(target: string | Element, opts?: DebugOptions): InspectResult;
+  summary(opts?: DebugOptions): Summary;
+  chunks(opts?: DebugOptions): ChunkBreakdown;
+  cache(opts?: DebugOptions): CacheStatus;
   cleanup(opts?: {
     root?: Document | ShadowRoot;
   }): void;
-  metrics(opts?: {
-    root?: Document | ShadowRoot;
-  }): CacheMetrics | null;
-  resetMetrics(opts?: {
-    root?: Document | ShadowRoot;
-  }): void;
-  /**
-   * Get breakdown of styles by chunk type.
-   *
-   * With style chunking enabled, styles are split into logical chunks
-   * (appearance, font, dimension, container, etc.) for better caching
-   * and CSS reuse.
-   *
-   * @param opts - Options including root document/shadow root
-   * @returns Breakdown by chunk type with class counts and CSS sizes
-   */
-  chunks(opts?: {
-    root?: Document | ShadowRoot;
-    log?: boolean;
-  }): {
-    byChunk: Record<string, {
-      classes: string[];
-      cssSize: number;
-      ruleCount: number;
-    }>;
-    totalChunkTypes: number;
-    totalClasses: number;
-  };
-  getGlobalTypeCSS(type: "global" | "raw" | "keyframes" | "property", opts?: {
-    root?: Document | ShadowRoot;
-  }): {
-    css: string;
-    ruleCount: number;
-    size: number;
-  };
-  defs(opts?: {
-    root?: Document | ShadowRoot;
-  }): Definitions;
-  summary(opts?: SummaryOptions): Summary;
-  pageCSS(opts?: {
-    root?: Document | ShadowRoot;
-    prettify?: boolean;
-    log?: boolean;
-    includeCrossOrigin?: boolean;
-  }): string;
-  pageStats(opts?: {
-    root?: Document | ShadowRoot;
-    includeCrossOrigin?: boolean;
-  }): {
-    cssSize: number;
-    ruleCount: number;
-    stylesheetCount: number;
-    skippedStylesheets: number;
-  };
-  install(): void;
-  log(target: CSSTarget, opts?: CssOptions & {
-    title?: string;
-  }): void;
   help(): void;
+  install(): void;
 };
 //#endregion
 export { tastyDebug };