@tenphi/tasty 0.0.0-snapshot.26b4630 → 0.0.0-snapshot.2705ab9

package/dist/counter-style/index.js

@@ -0,0 +1,51 @@
+//#region src/counter-style/index.ts
+const COUNTER_STYLE_KEY = "@counterStyle";
+/**
+* Check if styles object has local @counterStyle definition.
+*/
+function hasLocalCounterStyle(styles) {
+	return COUNTER_STYLE_KEY in styles;
+}
+/**
+* Extract local @counterStyle from styles object.
+* Returns null if no local counter styles (fast path).
+*/
+function extractLocalCounterStyle(styles) {
+	const counterStyle = styles[COUNTER_STYLE_KEY];
+	if (!counterStyle || typeof counterStyle !== "object") return null;
+	return counterStyle;
+}
+const COUNTER_STYLE_DESCRIPTOR_MAP = {
+	system: "system",
+	symbols: "symbols",
+	additiveSymbols: "additive-symbols",
+	prefix: "prefix",
+	suffix: "suffix",
+	negative: "negative",
+	range: "range",
+	pad: "pad",
+	fallback: "fallback",
+	speakAs: "speak-as"
+};
+/**
+* Format the inner declarations of a @counter-style rule (no wrapper).
+* Used by the injector which needs selector and declarations separately.
+*/
+function formatCounterStyleDeclarations(descriptors) {
+	const parts = [];
+	for (const [key, cssName] of Object.entries(COUNTER_STYLE_DESCRIPTOR_MAP)) {
+		const value = descriptors[key];
+		if (value !== void 0) parts.push(`${cssName}: ${value};`);
+	}
+	return parts.join(" ");
+}
+/**
+* Format a @counter-style rule as CSS.
+*/
+function formatCounterStyleRule(name, descriptors) {
+	return `@counter-style ${name} { ${formatCounterStyleDeclarations(descriptors)} }`;
+}
+
+//#endregion
+export { extractLocalCounterStyle, formatCounterStyleDeclarations, formatCounterStyleRule, hasLocalCounterStyle };
+//# sourceMappingURL=index.js.map

package/dist/counter-style/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/counter-style/index.ts"],"sourcesContent":["/**\n * Counter Style Utilities\n *\n * Utilities for extracting and processing CSS @counter-style definitions in styles.\n * Counter-style rules are permanent once injected and do not need cleanup.\n */\n\nimport type { CounterStyleDescriptors } from '../injector/types';\nimport type { Styles } from '../styles/types';\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst COUNTER_STYLE_KEY = '@counterStyle';\n\n// ============================================================================\n// Extraction Functions\n// ============================================================================\n\n/**\n * Check if styles object has local @counterStyle definition.\n */\nexport function hasLocalCounterStyle(styles: Styles): boolean {\n  return COUNTER_STYLE_KEY in styles;\n}\n\n/**\n * Extract local @counterStyle from styles object.\n * Returns null if no local counter styles (fast path).\n */\nexport function extractLocalCounterStyle(\n  styles: Styles,\n): Record<string, CounterStyleDescriptors> | null {\n  const counterStyle = styles[COUNTER_STYLE_KEY];\n  if (!counterStyle || typeof counterStyle !== 'object') {\n    return null;\n  }\n  return counterStyle as Record<string, CounterStyleDescriptors>;\n}\n\n// ============================================================================\n// CSS Formatting\n// ============================================================================\n\nconst COUNTER_STYLE_DESCRIPTOR_MAP: Record<string, string> = {\n  system: 'system',\n  symbols: 'symbols',\n  additiveSymbols: 'additive-symbols',\n  prefix: 'prefix',\n  suffix: 'suffix',\n  negative: 'negative',\n  range: 'range',\n  pad: 'pad',\n  fallback: 'fallback',\n  speakAs: 'speak-as',\n};\n\n/**\n * Format the inner declarations of a @counter-style rule (no wrapper).\n * Used by the injector which needs selector and declarations separately.\n */\nexport function formatCounterStyleDeclarations(\n  descriptors: CounterStyleDescriptors,\n): string {\n  const parts: string[] = [];\n\n  for (const [key, cssName] of Object.entries(COUNTER_STYLE_DESCRIPTOR_MAP)) {\n    const value = descriptors[key as keyof CounterStyleDescriptors];\n    if (value !== undefined) {\n      parts.push(`${cssName}: ${value};`);\n    }\n  }\n\n  return parts.join(' ');\n}\n\n/**\n * Format a @counter-style rule as CSS.\n */\nexport function formatCounterStyleRule(\n  name: string,\n  descriptors: CounterStyleDescriptors,\n): string {\n  return `@counter-style ${name} { ${formatCounterStyleDeclarations(descriptors)} }`;\n}\n"],"mappings":";AAcA,MAAM,oBAAoB;;;;AAS1B,SAAgB,qBAAqB,QAAyB;AAC5D,QAAO,qBAAqB;;;;;;AAO9B,SAAgB,yBACd,QACgD;CAChD,MAAM,eAAe,OAAO;AAC5B,KAAI,CAAC,gBAAgB,OAAO,iBAAiB,SAC3C,QAAO;AAET,QAAO;;AAOT,MAAM,+BAAuD;CAC3D,QAAQ;CACR,SAAS;CACT,iBAAiB;CACjB,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,OAAO;CACP,KAAK;CACL,UAAU;CACV,SAAS;CACV;;;;;AAMD,SAAgB,+BACd,aACQ;CACR,MAAM,QAAkB,EAAE;AAE1B,MAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,6BAA6B,EAAE;EACzE,MAAM,QAAQ,YAAY;AAC1B,MAAI,UAAU,OACZ,OAAM,KAAK,GAAG,QAAQ,IAAI,MAAM,GAAG;;AAIvC,QAAO,MAAM,KAAK,IAAI;;;;;AAMxB,SAAgB,uBACd,MACA,aACQ;AACR,QAAO,kBAAkB,KAAK,KAAK,+BAA+B,YAAY,CAAC"}

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 };