@tenphi/tasty 0.0.0-snapshot.056b911

package/dist/utils/resolve-recipes.js

@@ -0,0 +1,146 @@
+import { isDevEnv } from "./is-dev-env.js";
+import { isSelector } from "../pipeline/index.js";
+import { getGlobalRecipes } from "../config.js";
+import { mergeStyles } from "./merge-styles.js";
+//#region src/utils/resolve-recipes.ts
+/**
+* Recipe resolution utility.
+*
+* Resolves `recipe` style properties by looking up predefined recipe styles
+* from global configuration and merging them with the component's own styles.
+*
+* Resolution order per level (top-level and each sub-element independently):
+* base_recipe_1 base_recipe_2 → component styles → post_recipe_1 post_recipe_2
+*
+* The `/` separator splits base recipes (before component styles)
+* from post recipes (after component styles). All merges use mergeStyles
+* semantics: primitives and state maps with '' key fully replace;
+* state maps without '' key extend the existing value.
+*
+* Returns the same object reference if no recipes are present (zero overhead).
+*/
+const devMode = isDevEnv();
+/**
+* Parse a recipe string into base and post recipe name groups.
+*
+* Syntax: `'base1 base2 / post1 post2'`
+* - Names are space-separated within each group
+* - `/` separates base (before component) from post (after component) groups
+* - `/` is optional; if absent, all names are base
+* - `none` as the sole base value means "no base recipes"
+*
+* Returns `{ base: null, post: null }` if the string is empty or invalid.
+*/
+function parseRecipeNames(value) {
+	const empty = {
+		base: null,
+		post: null
+	};
+	if (typeof value !== "string") return empty;
+	const trimmed = value.trim();
+	if (trimmed === "") return empty;
+	const slashIndex = trimmed.indexOf("/");
+	if (slashIndex === -1) {
+		if (trimmed === "none") return empty;
+		return {
+			base: splitNames(trimmed),
+			post: null
+		};
+	}
+	const basePart = trimmed.slice(0, slashIndex);
+	const postPart = trimmed.slice(slashIndex + 1);
+	return {
+		base: basePart.trim() === "none" ? null : splitNames(basePart),
+		post: splitNames(postPart)
+	};
+}
+function splitNames(s) {
+	const names = s.split(/\s+/).filter(Boolean);
+	return names.length > 0 ? names : null;
+}
+/**
+* Collect merged styles for a list of recipe names.
+* Each recipe is flat-spread on top of the previous.
+*/
+function collectRecipeStyles(names, recipes) {
+	let merged = {};
+	for (const name of names) {
+		const recipeStyles = recipes[name];
+		if (!recipeStyles) {
+			if (devMode) console.warn(`[Tasty] Recipe "${name}" not found. Make sure it is defined in configure({ recipes: { ... } }).`);
+			continue;
+		}
+		merged = {
+			...merged,
+			...recipeStyles
+		};
+	}
+	return merged;
+}
+/**
+* Resolve recipe references in a flat styles object (no sub-elements).
+* Returns null if no `recipe` key is present.
+*
+* Resolution: base recipes → component styles → post recipes (all via mergeStyles)
+*/
+function resolveRecipesForLevel(styles, recipes) {
+	if (!("recipe" in styles)) return null;
+	const { base, post } = parseRecipeNames(styles.recipe);
+	const { recipe: _recipe, ...allRest } = styles;
+	const flatStyles = {};
+	const selectorStyles = {};
+	for (const key of Object.keys(allRest)) if (isSelector(key)) selectorStyles[key] = allRest[key];
+	else flatStyles[key] = allRest[key];
+	if (!base && !post) return allRest;
+	let result;
+	if (base) result = mergeStyles(collectRecipeStyles(base, recipes), flatStyles);
+	else result = { ...flatStyles };
+	if (post) {
+		const postStyles = collectRecipeStyles(post, recipes);
+		result = mergeStyles(result, postStyles);
+	}
+	for (const key of Object.keys(selectorStyles)) result[key] = selectorStyles[key];
+	return result;
+}
+/**
+* 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
+*/
+function resolveRecipes(styles) {
+	const recipes = getGlobalRecipes();
+	if (!recipes) return styles;
+	let changed = false;
+	const topResolved = resolveRecipesForLevel(styles, recipes);
+	let result;
+	if (topResolved) {
+		changed = true;
+		result = topResolved;
+	} else result = styles;
+	const keys = Object.keys(result);
+	for (const key of keys) {
+		if (!isSelector(key)) continue;
+		const subStyles = result[key];
+		if (!subStyles || typeof subStyles !== "object" || Array.isArray(subStyles)) continue;
+		const subRecord = subStyles;
+		if (!("recipe" in subRecord)) continue;
+		const subResolved = resolveRecipesForLevel(subRecord, recipes);
+		if (subResolved) {
+			if (!changed) {
+				changed = true;
+				result = { ...styles };
+			}
+			result[key] = subResolved;
+		}
+	}
+	return changed ? result : styles;
+}
+//#endregion
+export { resolveRecipes };
+
+//# sourceMappingURL=resolve-recipes.js.map

package/dist/utils/resolve-recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-recipes.js","names":[],"sources":["../../src/utils/resolve-recipes.ts"],"sourcesContent":["/**\n * Recipe resolution utility.\n *\n * Resolves `recipe` style properties by looking up predefined recipe styles\n * from global configuration and merging them with the component's own styles.\n *\n * Resolution order per level (top-level and each sub-element independently):\n * base_recipe_1 base_recipe_2 → component styles → post_recipe_1 post_recipe_2\n *\n * The `/` separator splits base recipes (before component styles)\n * from post recipes (after component styles). All merges use mergeStyles\n * semantics: primitives and state maps with '' key fully replace;\n * state maps without '' key extend the existing value.\n *\n * Returns the same object reference if no recipes are present (zero overhead).\n */\n\nimport { getGlobalRecipes } from '../config';\nimport { isSelector } from '../pipeline';\nimport type { RecipeStyles, Styles } from '../styles/types';\n\nimport { isDevEnv } from './is-dev-env';\nimport { mergeStyles } from './merge-styles';\n\nconst devMode = isDevEnv();\n\ninterface ParsedRecipeGroups {\n  base: string[] | null;\n  post: string[] | null;\n}\n\n/**\n * Parse a recipe string into base and post recipe name groups.\n *\n * Syntax: `'base1 base2 / post1 post2'`\n * - Names are space-separated within each group\n * - `/` separates base (before component) from post (after component) groups\n * - `/` is optional; if absent, all names are base\n * - `none` as the sole base value means \"no base recipes\"\n *\n * Returns `{ base: null, post: null }` if the string is empty or invalid.\n */\nfunction parseRecipeNames(value: unknown): ParsedRecipeGroups {\n  const empty: ParsedRecipeGroups = { base: null, post: null };\n\n  if (typeof value !== 'string') return empty;\n  const trimmed = value.trim();\n  if (trimmed === '') return empty;\n\n  const slashIndex = trimmed.indexOf('/');\n\n  if (slashIndex === -1) {\n    if (trimmed === 'none') return empty;\n    const names = splitNames(trimmed);\n    return { base: names, post: null };\n  }\n\n  const basePart = trimmed.slice(0, slashIndex);\n  const postPart = trimmed.slice(slashIndex + 1);\n\n  return {\n    base: basePart.trim() === 'none' ? null : splitNames(basePart),\n    post: splitNames(postPart),\n  };\n}\n\nfunction splitNames(s: string): string[] | null {\n  const names = s.split(/\\s+/).filter(Boolean);\n  return names.length > 0 ? names : null;\n}\n\n/**\n * Collect merged styles for a list of recipe names.\n * Each recipe is flat-spread on top of the previous.\n */\nfunction collectRecipeStyles(\n  names: string[],\n  recipes: Record<string, RecipeStyles>,\n): Record<string, unknown> {\n  let merged: Record<string, unknown> = {};\n\n  for (const name of names) {\n    const recipeStyles = recipes[name];\n\n    if (!recipeStyles) {\n      if (devMode) {\n        console.warn(\n          `[Tasty] Recipe \"${name}\" not found. ` +\n            `Make sure it is defined in configure({ recipes: { ... } }).`,\n        );\n      }\n      continue;\n    }\n\n    merged = { ...merged, ...(recipeStyles as Record<string, unknown>) };\n  }\n\n  return merged;\n}\n\n/**\n * Resolve recipe references in a flat styles object (no sub-elements).\n * Returns null if no `recipe` key is present.\n *\n * Resolution: base recipes → component styles → post recipes (all via mergeStyles)\n */\nfunction resolveRecipesForLevel(\n  styles: Record<string, unknown>,\n  recipes: Record<string, RecipeStyles>,\n): Record<string, unknown> | null {\n  if (!('recipe' in styles)) return null;\n\n  const { base, post } = parseRecipeNames(styles.recipe);\n\n  // Separate selector keys (sub-elements) from flat style properties.\n  // mergeStyles handles selectors with its own semantics (e.g. false = delete),\n  // but at this level we only want recipe merging on flat properties.\n\n  const { recipe: _recipe, ...allRest } = styles;\n  const flatStyles: Record<string, unknown> = {};\n  const selectorStyles: Record<string, unknown> = {};\n\n  for (const key of Object.keys(allRest)) {\n    if (isSelector(key)) {\n      selectorStyles[key] = allRest[key];\n    } else {\n      flatStyles[key] = allRest[key];\n    }\n  }\n\n  if (!base && !post) {\n    return allRest;\n  }\n\n  // 1. Merge base recipes, then component styles on top (via mergeStyles)\n  let result: Record<string, unknown>;\n\n  if (base) {\n    const baseStyles = collectRecipeStyles(base, recipes);\n    result = mergeStyles(baseStyles as Styles, flatStyles as Styles) as Record<\n      string,\n      unknown\n    >;\n  } else {\n    result = { ...flatStyles };\n  }\n\n  // 2. Apply post recipes via mergeStyles (state map extend semantics)\n  if (post) {\n    const postStyles = collectRecipeStyles(post, recipes);\n    result = mergeStyles(result as Styles, postStyles as Styles) as Record<\n      string,\n      unknown\n    >;\n  }\n\n  // Re-attach selector keys unchanged\n  for (const key of Object.keys(selectorStyles)) {\n    result[key] = selectorStyles[key];\n  }\n\n  return result;\n}\n\n/**\n * Resolve all `recipe` style properties in a styles object.\n *\n * Handles both top-level and sub-element recipe references.\n * Returns the same object reference if no recipes are present anywhere\n * (zero overhead for the common case).\n *\n * @param styles - The styles object potentially containing `recipe` keys\n * @returns Resolved styles with recipe values merged in, or the original object if unchanged\n */\nexport function resolveRecipes(styles: Styles): Styles {\n  const recipes = getGlobalRecipes();\n\n  // Fast path: no recipes configured globally\n  if (!recipes) return styles;\n\n  let changed = false;\n\n  // Resolve top-level recipe\n  const topResolved = resolveRecipesForLevel(\n    styles as Record<string, unknown>,\n    recipes,\n  );\n\n  let result: Record<string, unknown>;\n\n  if (topResolved) {\n    changed = true;\n    result = topResolved;\n  } else {\n    // Keep reference; a shallow copy is deferred until a sub-element actually changes\n    result = styles as Record<string, unknown>;\n  }\n\n  // Resolve sub-element recipes\n  const keys = Object.keys(result);\n\n  for (const key of keys) {\n    if (!isSelector(key)) continue;\n\n    const subStyles = result[key];\n\n    if (\n      !subStyles ||\n      typeof subStyles !== 'object' ||\n      Array.isArray(subStyles)\n    ) {\n      continue;\n    }\n\n    const subRecord = subStyles as Record<string, unknown>;\n\n    if (!('recipe' in subRecord)) continue;\n\n    const subResolved = resolveRecipesForLevel(subRecord, recipes);\n\n    if (subResolved) {\n      if (!changed) {\n        // First change in sub-elements -- need to shallow-copy the top level\n        changed = true;\n        result = { ...(styles as Record<string, unknown>) };\n      }\n      result[key] = subResolved;\n    }\n  }\n\n  return changed ? (result as Styles) : styles;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAwBA,MAAM,UAAU,UAAU;;;;;;;;;;;;AAkB1B,SAAS,iBAAiB,OAAoC;CAC5D,MAAM,QAA4B;EAAE,MAAM;EAAM,MAAM;EAAM;AAE5D,KAAI,OAAO,UAAU,SAAU,QAAO;CACtC,MAAM,UAAU,MAAM,MAAM;AAC5B,KAAI,YAAY,GAAI,QAAO;CAE3B,MAAM,aAAa,QAAQ,QAAQ,IAAI;AAEvC,KAAI,eAAe,IAAI;AACrB,MAAI,YAAY,OAAQ,QAAO;AAE/B,SAAO;GAAE,MADK,WAAW,QAAQ;GACX,MAAM;GAAM;;CAGpC,MAAM,WAAW,QAAQ,MAAM,GAAG,WAAW;CAC7C,MAAM,WAAW,QAAQ,MAAM,aAAa,EAAE;AAE9C,QAAO;EACL,MAAM,SAAS,MAAM,KAAK,SAAS,OAAO,WAAW,SAAS;EAC9D,MAAM,WAAW,SAAS;EAC3B;;AAGH,SAAS,WAAW,GAA4B;CAC9C,MAAM,QAAQ,EAAE,MAAM,MAAM,CAAC,OAAO,QAAQ;AAC5C,QAAO,MAAM,SAAS,IAAI,QAAQ;;;;;;AAOpC,SAAS,oBACP,OACA,SACyB;CACzB,IAAI,SAAkC,EAAE;AAExC,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,eAAe,QAAQ;AAE7B,MAAI,CAAC,cAAc;AACjB,OAAI,QACF,SAAQ,KACN,mBAAmB,KAAK,0EAEzB;AAEH;;AAGF,WAAS;GAAE,GAAG;GAAQ,GAAI;GAA0C;;AAGtE,QAAO;;;;;;;;AAST,SAAS,uBACP,QACA,SACgC;AAChC,KAAI,EAAE,YAAY,QAAS,QAAO;CAElC,MAAM,EAAE,MAAM,SAAS,iBAAiB,OAAO,OAAO;CAMtD,MAAM,EAAE,QAAQ,SAAS,GAAG,YAAY;CACxC,MAAM,aAAsC,EAAE;CAC9C,MAAM,iBAA0C,EAAE;AAElD,MAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CACpC,KAAI,WAAW,IAAI,CACjB,gBAAe,OAAO,QAAQ;KAE9B,YAAW,OAAO,QAAQ;AAI9B,KAAI,CAAC,QAAQ,CAAC,KACZ,QAAO;CAIT,IAAI;AAEJ,KAAI,KAEF,UAAS,YADU,oBAAoB,MAAM,QAAQ,EACV,WAAqB;KAKhE,UAAS,EAAE,GAAG,YAAY;AAI5B,KAAI,MAAM;EACR,MAAM,aAAa,oBAAoB,MAAM,QAAQ;AACrD,WAAS,YAAY,QAAkB,WAAqB;;AAO9D,MAAK,MAAM,OAAO,OAAO,KAAK,eAAe,CAC3C,QAAO,OAAO,eAAe;AAG/B,QAAO;;;;;;;;;;;;AAaT,SAAgB,eAAe,QAAwB;CACrD,MAAM,UAAU,kBAAkB;AAGlC,KAAI,CAAC,QAAS,QAAO;CAErB,IAAI,UAAU;CAGd,MAAM,cAAc,uBAClB,QACA,QACD;CAED,IAAI;AAEJ,KAAI,aAAa;AACf,YAAU;AACV,WAAS;OAGT,UAAS;CAIX,MAAM,OAAO,OAAO,KAAK,OAAO;AAEhC,MAAK,MAAM,OAAO,MAAM;AACtB,MAAI,CAAC,WAAW,IAAI,CAAE;EAEtB,MAAM,YAAY,OAAO;AAEzB,MACE,CAAC,aACD,OAAO,cAAc,YACrB,MAAM,QAAQ,UAAU,CAExB;EAGF,MAAM,YAAY;AAElB,MAAI,EAAE,YAAY,WAAY;EAE9B,MAAM,cAAc,uBAAuB,WAAW,QAAQ;AAE9D,MAAI,aAAa;AACf,OAAI,CAAC,SAAS;AAEZ,cAAU;AACV,aAAS,EAAE,GAAI,QAAoC;;AAErD,UAAO,OAAO;;;AAIlB,QAAO,UAAW,SAAoB"}

package/dist/utils/selector-transform.js

@@ -0,0 +1,32 @@
+//#region src/utils/selector-transform.ts
+/**
+* Shared utility for transforming capitalized PascalCase element names
+* in CSS selector content to `[data-element="..."]` attribute selectors.
+*
+* Lowercase words are treated as HTML tags and left unchanged.
+*/
+/**
+* Matches a capitalized PascalCase word at the start of the string
+* or after a CSS combinator/separator character.
+*/
+const ELEMENT_NAME_RE = /(^|[\s>+~,(])([A-Z][a-zA-Z0-9]*)/g;
+/**
+* Replace capitalized PascalCase words with `[data-element="Name"]` selectors.
+*
+* @example
+* transformSelectorContent('> Field + input:checked')
+* // → '> [data-element="Field"] + input:checked'
+*
+* transformSelectorContent('Body > Row')
+* // → '[data-element="Body"] > [data-element="Row"]'
+*
+* transformSelectorContent('button')
+* // → 'button'  (lowercase = HTML tag, unchanged)
+*/
+function transformSelectorContent(content) {
+	return content.replace(ELEMENT_NAME_RE, (_, prefix, name) => `${prefix}[data-element="${name}"]`);
+}
+//#endregion
+export { transformSelectorContent };
+
+//# sourceMappingURL=selector-transform.js.map

package/dist/utils/selector-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-transform.js","names":[],"sources":["../../src/utils/selector-transform.ts"],"sourcesContent":["/**\n * Shared utility for transforming capitalized PascalCase element names\n * in CSS selector content to `[data-element=\"...\"]` attribute selectors.\n *\n * Lowercase words are treated as HTML tags and left unchanged.\n */\n\n/**\n * Matches a capitalized PascalCase word at the start of the string\n * or after a CSS combinator/separator character.\n */\nconst ELEMENT_NAME_RE = /(^|[\\s>+~,(])([A-Z][a-zA-Z0-9]*)/g;\n\n/**\n * Replace capitalized PascalCase words with `[data-element=\"Name\"]` selectors.\n *\n * @example\n * transformSelectorContent('> Field + input:checked')\n * // → '> [data-element=\"Field\"] + input:checked'\n *\n * transformSelectorContent('Body > Row')\n * // → '[data-element=\"Body\"] > [data-element=\"Row\"]'\n *\n * transformSelectorContent('button')\n * // → 'button'  (lowercase = HTML tag, unchanged)\n */\nexport function transformSelectorContent(content: string): string {\n  return content.replace(\n    ELEMENT_NAME_RE,\n    (_, prefix, name) => `${prefix}[data-element=\"${name}\"]`,\n  );\n}\n"],"mappings":";;;;;;;;;;;AAWA,MAAM,kBAAkB;;;;;;;;;;;;;;AAexB,SAAgB,yBAAyB,SAAyB;AAChE,QAAO,QAAQ,QACb,kBACC,GAAG,QAAQ,SAAS,GAAG,OAAO,iBAAiB,KAAK,IACtD"}

package/dist/utils/string.js

@@ -0,0 +1,8 @@
+//#region src/utils/string.ts
+function toSnakeCase(str) {
+	return str.replace(/[A-Z]/g, (s) => `-${s.toLowerCase()}`);
+}
+//#endregion
+export { toSnakeCase };
+
+//# sourceMappingURL=string.js.map

package/dist/utils/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","names":[],"sources":["../../src/utils/string.ts"],"sourcesContent":["export function toSnakeCase(str: string): string {\n  return str.replace(/[A-Z]/g, (s) => `-${s.toLowerCase()}`);\n}\n"],"mappings":";AAAA,SAAgB,YAAY,KAAqB;AAC/C,QAAO,IAAI,QAAQ,WAAW,MAAM,IAAI,EAAE,aAAa,GAAG"}

package/dist/utils/styles.d.ts

@@ -0,0 +1,99 @@
+import { ProcessedStyle, StyleDetails } from "../parser/types.js";
+import { StyleParser } from "../parser/parser.js";
+import { getNamedColorHex, getRgbValuesFromRgbaString, hexToRgb, strToRgb } from "./color-math.js";
+
+//#region src/utils/styles.d.ts
+type StyleValue<T = string> = T | boolean | number | null | undefined;
+/**
+ * Normalize a color token value.
+ * - Boolean `true` is converted to `'transparent'`
+ * - Boolean `false` returns `null` (signals the token should be skipped)
+ * - Other values are returned as-is
+ *
+ * @param value - The raw token value
+ * @returns Normalized value or null if the token should be skipped
+ */
+declare function normalizeColorTokenValue<T>(value: T | boolean): T | 'transparent' | null;
+type StyleValueStateMap<T = string> = Record<string, StyleValue<T> | '@inherit'>;
+/**
+ * Combined type for style values that can be either a direct value or a state map.
+ * Use this for component props that accept style values.
+ */
+type StylePropValue<T = string> = StyleValue<T> | StyleValueStateMap<T>;
+type CSSMap = {
+  $?: string | string[];
+} & Record<string, string | string[]>;
+type StyleHandlerResult = CSSMap | CSSMap[] | null | void;
+type RawStyleHandler = (value: StyleValueStateMap) => StyleHandlerResult;
+type StyleHandler = RawStyleHandler & {
+  __lookupStyles: string[];
+};
+/**
+ * Handler definition forms for configure() and plugins.
+ * - Function only: lookup styles inferred from key name
+ * - Single property tuple: ['styleName', handler]
+ * - Multi-property tuple: [['style1', 'style2'], handler]
+ */
+type StyleHandlerDefinition = RawStyleHandler | [string, RawStyleHandler] | [string[], RawStyleHandler];
+interface ParsedColor {
+  color?: string;
+  name?: string;
+  opacity?: number;
+}
+type StyleMap = Record<string, StyleValue | StyleValueStateMap>;
+declare const CUSTOM_UNITS: {
+  r: string;
+  cr: string;
+  bw: string;
+  ow: string;
+  x: string;
+  sf: (num: number) => string;
+};
+declare const DIRECTIONS: string[];
+declare function customFunc(name: string, fn: (groups: StyleDetails[]) => string): void;
+/**
+ * Get the global StyleParser instance.
+ * Used by configure() to apply parser configuration.
+ */
+declare function getGlobalParser(): StyleParser;
+/**
+ * Get the current custom functions registry.
+ * Used by configure() to merge with new functions.
+ */
+declare function getGlobalFuncs(): Record<string, (groups: StyleDetails[]) => string>;
+/**
+ * Set global predefined tokens.
+ * Called from configure() after processing token values.
+ * Merges with existing tokens (new tokens override existing ones with same key).
+ * Keys are normalized to lowercase (parser lowercases input before classification).
+ * @internal
+ */
+declare function setGlobalPredefinedTokens(tokens: Record<string, string>): void;
+/**
+ * Get the current global predefined tokens.
+ * Returns null if no tokens are configured.
+ */
+declare function getGlobalPredefinedTokens(): Record<string, string> | null;
+/**
+ * Reset global predefined tokens.
+ * Used for testing.
+ * @internal
+ */
+declare function resetGlobalPredefinedTokens(): void;
+/**
+ *
+ * @param {String} value
+ * @param {Number} mode
+ * @returns {Object<String,String|Array>}
+ */
+declare function parseStyle(value: StyleValue): ProcessedStyle;
+/**
+ * Parse color. Find it value, name and opacity.
+ * 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 stringifyStyles(styles: unknown): string;
+//#endregion
+export { CSSMap, CUSTOM_UNITS, DIRECTIONS, ParsedColor, RawStyleHandler, StyleHandler, StyleHandlerDefinition, StyleHandlerResult, StyleMap, StylePropValue, StyleValue, StyleValueStateMap, customFunc, filterMods, getGlobalFuncs, getGlobalParser, getGlobalPredefinedTokens, normalizeColorTokenValue, parseColor, parseStyle, resetGlobalPredefinedTokens, setGlobalPredefinedTokens, stringifyStyles };
+//# sourceMappingURL=styles.d.ts.map

package/dist/utils/styles.js

@@ -0,0 +1,220 @@
+import { getNamedColorHex } from "./color-math.js";
+import { StyleParser } from "../parser/parser.js";
+import { okhslFunc } from "../plugins/okhsl-plugin.js";
+//#region src/utils/styles.ts
+/**
+* Normalize a color token value.
+* - Boolean `true` is converted to `'transparent'`
+* - Boolean `false` returns `null` (signals the token should be skipped)
+* - Other values are returned as-is
+*
+* @param value - The raw token value
+* @returns Normalized value or null if the token should be skipped
+*/
+function normalizeColorTokenValue(value) {
+	if (value === true) return "transparent";
+	if (value === false) return null;
+	return value;
+}
+const COLOR_VAR_PATTERN = /var\(--([a-z0-9-]+)-color/;
+const COLOR_VAR_COMPONENTS_PATTERN = /var\(--([a-z0-9-]+)-color-(?:rgb|hsl|oklch)/;
+const RGB_ALPHA_PATTERN = /\/\s*([0-9.]+)\)/;
+const RE_HEX_COLOR = /^#[0-9a-fA-F]{3,8}$/;
+const RE_VAR_COLOR = /^var\(--[a-z0-9-]+-color/;
+function isSimpleColorFast(val) {
+	switch (val.charCodeAt(0)) {
+		case 35: return RE_HEX_COLOR.test(val);
+		case 114: return val.charCodeAt(1) === 103 && val.charCodeAt(2) === 98;
+		case 104: return val.charCodeAt(1) === 115 && val.charCodeAt(2) === 108;
+		case 108: return val.charCodeAt(1) === 99 && val.charCodeAt(2) === 104;
+		case 111: return val.startsWith("oklch(") || val.startsWith("okhsl(");
+		case 118: return RE_VAR_COLOR.test(val);
+		case 99: return val === "currentColor" || val === "currentcolor";
+		case 116: return val === "transparent";
+		default: return getNamedColorHex().has(val.toLowerCase());
+	}
+}
+let colorWarningCount = 0;
+const MAX_COLOR_WARNINGS = 10;
+const CUSTOM_UNITS = {
+	r: "6px",
+	cr: "10px",
+	bw: "1px",
+	ow: "3px",
+	x: "8px",
+	sf: function sf(num) {
+		return `minmax(0, ${num}fr)`;
+	}
+};
+const DIRECTIONS = [
+	"top",
+	"right",
+	"bottom",
+	"left"
+];
+let __tastyParser = null;
+function getOrCreateParser() {
+	if (!__tastyParser) {
+		__tastyParser = new StyleParser({ units: CUSTOM_UNITS });
+		__tastyParser.setFuncs(__tastyFuncs);
+	}
+	return __tastyParser;
+}
+const __tastyFuncs = { okhsl: okhslFunc };
+function customFunc(name, fn) {
+	__tastyFuncs[name] = fn;
+	getOrCreateParser().setFuncs(__tastyFuncs);
+}
+/**
+* Get the global StyleParser instance.
+* Used by configure() to apply parser configuration.
+*/
+function getGlobalParser() {
+	return getOrCreateParser();
+}
+/**
+* Get the current custom functions registry.
+* Used by configure() to merge with new functions.
+*/
+function getGlobalFuncs() {
+	return __tastyFuncs;
+}
+/**
+* Storage for predefined tokens that are replaced during style parsing.
+* Keys are token names (with $ or # prefix), values are pre-processed CSS values.
+*/
+let __globalPredefinedTokens = null;
+/**
+* Set global predefined tokens.
+* Called from configure() after processing token values.
+* Merges with existing tokens (new tokens override existing ones with same key).
+* Keys are normalized to lowercase (parser lowercases input before classification).
+* @internal
+*/
+function setGlobalPredefinedTokens(tokens) {
+	const normalizedTokens = {};
+	for (const [key, value] of Object.entries(tokens)) {
+		const lowerKey = key.toLowerCase();
+		const lowerValue = value.toLowerCase();
+		if (lowerKey.startsWith("#") && lowerValue === "#current") {
+			console.warn(`Tasty: Using #current to define color token "${key}" is not supported. The #current token represents currentcolor which cannot be used as a base for other tokens.`);
+			continue;
+		}
+		normalizedTokens[lowerKey] = value;
+	}
+	__globalPredefinedTokens = __globalPredefinedTokens ? {
+		...__globalPredefinedTokens,
+		...normalizedTokens
+	} : normalizedTokens;
+	getOrCreateParser().clearCache();
+}
+/**
+* Get the current global predefined tokens.
+* Returns null if no tokens are configured.
+*/
+function getGlobalPredefinedTokens() {
+	return __globalPredefinedTokens;
+}
+/**
+* Reset global predefined tokens.
+* Used for testing.
+* @internal
+*/
+function resetGlobalPredefinedTokens() {
+	__globalPredefinedTokens = null;
+	getOrCreateParser().clearCache();
+}
+/**
+*
+* @param {String} value
+* @param {Number} mode
+* @returns {Object<String,String|Array>}
+*/
+function parseStyle(value) {
+	let str;
+	if (typeof value === "string") str = value;
+	else if (typeof value === "number") str = String(value);
+	else str = "";
+	return getOrCreateParser().process(str);
+}
+/**
+* Parse color. Find it value, name and opacity.
+* Optimized to avoid heavy parseStyle calls for simple color patterns.
+*/
+function parseColor(val, ignoreError = false) {
+	if (typeof val !== "string") val = String(val ?? "");
+	val = val.trim();
+	if (!val) return {};
+	const isSimpleColor = isSimpleColorFast(val);
+	let firstColor;
+	if (isSimpleColor) firstColor = val;
+	else {
+		const extractedColor = parseStyle(val).groups.find((g) => g.colors.length)?.colors[0];
+		if (!extractedColor) {
+			if (!ignoreError && colorWarningCount < MAX_COLOR_WARNINGS) {
+				console.warn("Tasty: unable to parse color:", val);
+				colorWarningCount++;
+				if (colorWarningCount === MAX_COLOR_WARNINGS) console.warn("Tasty: color parsing warnings will be suppressed from now on");
+			}
+			return {};
+		}
+		firstColor = extractedColor;
+	}
+	let nameMatch = firstColor.match(COLOR_VAR_PATTERN);
+	if (!nameMatch) nameMatch = firstColor.match(COLOR_VAR_COMPONENTS_PATTERN);
+	let opacity;
+	if (firstColor.startsWith("rgb") || firstColor.startsWith("hsl") || firstColor.startsWith("lch") || firstColor.startsWith("oklch") || firstColor.startsWith("okhsl")) {
+		const alphaMatch = firstColor.match(RGB_ALPHA_PATTERN);
+		if (alphaMatch) {
+			const v = parseFloat(alphaMatch[1]);
+			if (!isNaN(v)) opacity = v * 100;
+		}
+	}
+	return {
+		color: firstColor,
+		name: nameMatch ? nameMatch[1] : void 0,
+		opacity
+	};
+}
+function filterMods(mods, allowedMods) {
+	return mods.filter((mod) => allowedMods.includes(mod));
+}
+const _innerCache = /* @__PURE__ */ new WeakMap();
+const _topLevelCache = /* @__PURE__ */ new WeakMap();
+function stringifyStyles(styles) {
+	if (styles == null || typeof styles !== "object") return "";
+	const cached = _topLevelCache.get(styles);
+	if (cached !== void 0) return cached;
+	const obj = styles;
+	const keys = Object.keys(obj).sort();
+	const parts = [];
+	for (const k of keys) {
+		const v = obj[k];
+		if (v === void 0 || typeof v === "function" || typeof v === "symbol") continue;
+		const c0 = k.charCodeAt(0);
+		const needsInnerSort = (c0 >= 65 && c0 <= 90 || c0 === 38) && v && typeof v === "object" && !Array.isArray(v);
+		let sv;
+		if (needsInnerSort) {
+			sv = _innerCache.get(v);
+			if (sv === void 0) {
+				const innerObj = v;
+				const innerKeys = Object.keys(innerObj).sort();
+				const innerParts = [];
+				for (const ik of innerKeys) {
+					const ivs = JSON.stringify(innerObj[ik]);
+					if (ivs !== void 0) innerParts.push(JSON.stringify(ik) + ":" + ivs);
+				}
+				sv = "{" + innerParts.join(",") + "}";
+				_innerCache.set(v, sv);
+			}
+		} else sv = JSON.stringify(v);
+		parts.push(JSON.stringify(k) + ":" + sv);
+	}
+	const result = "{" + parts.join(",") + "}";
+	_topLevelCache.set(styles, result);
+	return result;
+}
+//#endregion
+export { CUSTOM_UNITS, DIRECTIONS, customFunc, filterMods, getGlobalFuncs, getGlobalParser, getGlobalPredefinedTokens, normalizeColorTokenValue, parseColor, parseStyle, resetGlobalPredefinedTokens, setGlobalPredefinedTokens, stringifyStyles };
+
+//# sourceMappingURL=styles.js.map

package/dist/utils/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","names":[],"sources":["../../src/utils/styles.ts"],"sourcesContent":["import { StyleParser } from '../parser/parser';\nimport { okhslFunc } from '../plugins/okhsl-plugin';\n\nimport type { ProcessedStyle, StyleDetails } from '../parser/types';\n\nimport { getNamedColorHex } from './color-math';\n\nexport {\n  getNamedColorHex,\n  getRgbValuesFromRgbaString,\n  hexToRgb,\n  strToRgb,\n} from './color-math';\n\nexport type StyleValue<T = string> = T | boolean | number | null | undefined;\n\n/**\n * Normalize a color token value.\n * - Boolean `true` is converted to `'transparent'`\n * - Boolean `false` returns `null` (signals the token should be skipped)\n * - Other values are returned as-is\n *\n * @param value - The raw token value\n * @returns Normalized value or null if the token should be skipped\n */\nexport function normalizeColorTokenValue<T>(\n  value: T | boolean,\n): T | 'transparent' | null {\n  if (value === true) {\n    return 'transparent';\n  }\n  if (value === false) {\n    return null;\n  }\n  return value as T;\n}\n\nexport type StyleValueStateMap<T = string> = Record<\n  string,\n  StyleValue<T> | '@inherit'\n>;\n\n/**\n * Combined type for style values that can be either a direct value or a state map.\n * Use this for component props that accept style values.\n */\nexport type StylePropValue<T = string> = StyleValue<T> | StyleValueStateMap<T>;\n\nexport type CSSMap = { $?: string | string[] } & Record<\n  string,\n  string | string[]\n>;\n\nexport type StyleHandlerResult = CSSMap | CSSMap[] | null | void;\n\nexport type RawStyleHandler = (value: StyleValueStateMap) => StyleHandlerResult;\n\nexport type StyleHandler = RawStyleHandler & {\n  __lookupStyles: string[];\n};\n\n/**\n * Handler definition forms for configure() and plugins.\n * - Function only: lookup styles inferred from key name\n * - Single property tuple: ['styleName', handler]\n * - Multi-property tuple: [['style1', 'style2'], handler]\n */\nexport type StyleHandlerDefinition =\n  | RawStyleHandler\n  | [string, RawStyleHandler]\n  | [string[], RawStyleHandler];\n\nexport interface ParsedColor {\n  color?: string;\n  name?: string;\n  opacity?: number;\n}\n\nexport type StyleMap = Record<string, StyleValue | StyleValueStateMap>;\n\nconst devMode = process.env.NODE_ENV !== 'production';\n\n// Precompiled regex patterns for parseColor optimization\n// Match var(--name-color...) and extract the name, regardless of fallbacks\nconst COLOR_VAR_PATTERN = /var\\(--([a-z0-9-]+)-color/;\nconst COLOR_VAR_COMPONENTS_PATTERN =\n  /var\\(--([a-z0-9-]+)-color-(?:rgb|hsl|oklch)/;\nconst RGB_ALPHA_PATTERN = /\\/\\s*([0-9.]+)\\)/;\nconst RE_HEX_COLOR = /^#[0-9a-fA-F]{3,8}$/;\nconst RE_VAR_COLOR = /^var\\(--[a-z0-9-]+-color/;\n\nfunction isSimpleColorFast(val: string): boolean {\n  const c0 = val.charCodeAt(0);\n\n  switch (c0) {\n    case 35: // '#'\n      return RE_HEX_COLOR.test(val);\n    case 114: // 'r'\n      return val.charCodeAt(1) === 103 && val.charCodeAt(2) === 98; // 'rgb'\n    case 104: // 'h'\n      return val.charCodeAt(1) === 115 && val.charCodeAt(2) === 108; // 'hsl'\n    case 108: // 'l'\n      return val.charCodeAt(1) === 99 && val.charCodeAt(2) === 104; // 'lch'\n    case 111: // 'o'\n      return val.startsWith('oklch(') || val.startsWith('okhsl(');\n    case 118: // 'v'\n      return RE_VAR_COLOR.test(val);\n    case 99: // 'c'\n      return val === 'currentColor' || val === 'currentcolor';\n    case 116: // 't'\n      return val === 'transparent';\n    default:\n      return getNamedColorHex().has(val.toLowerCase());\n  }\n}\n\n// Rate limiting for dev warnings to avoid spam\nlet colorWarningCount = 0;\nconst MAX_COLOR_WARNINGS = 10;\n\nexport const CUSTOM_UNITS = {\n  r: '6px',\n  cr: '10px',\n  bw: '1px',\n  ow: '3px',\n  x: '8px',\n  sf: function sf(num: number) {\n    return `minmax(0, ${num}fr)`;\n  },\n};\n\nexport const DIRECTIONS = ['top', 'right', 'bottom', 'left'];\n\n// Lazy-initialized to break the circular dependency:\n// parser.ts → classify.ts → utils/styles.ts → parser.ts\nlet __tastyParser: StyleParser | null = null;\n\nfunction getOrCreateParser(): StyleParser {\n  if (!__tastyParser) {\n    __tastyParser = new StyleParser({ units: CUSTOM_UNITS });\n    __tastyParser.setFuncs(__tastyFuncs);\n  }\n  return __tastyParser;\n}\n\n// Registry for user-provided custom functions that the parser can call.\n// It is updated through the `customFunc` helper exported below.\n// okhsl is registered as a built-in function so it works regardless of\n// tree-shaking or module initialization order.\nconst __tastyFuncs: Record<string, (groups: StyleDetails[]) => string> = {\n  okhsl: okhslFunc,\n};\n\nexport function customFunc(\n  name: string,\n  fn: (groups: StyleDetails[]) => string,\n) {\n  __tastyFuncs[name] = fn;\n  getOrCreateParser().setFuncs(__tastyFuncs);\n}\n\n/**\n * Get the global StyleParser instance.\n * Used by configure() to apply parser configuration.\n */\nexport function getGlobalParser(): StyleParser {\n  return getOrCreateParser();\n}\n\n/**\n * Get the current custom functions registry.\n * Used by configure() to merge with new functions.\n */\nexport function getGlobalFuncs(): Record<\n  string,\n  (groups: StyleDetails[]) => string\n> {\n  return __tastyFuncs;\n}\n\n// ============================================================================\n// Global Predefined Tokens\n// ============================================================================\n\n/**\n * Storage for predefined tokens that are replaced during style parsing.\n * Keys are token names (with $ or # prefix), values are pre-processed CSS values.\n */\nlet __globalPredefinedTokens: Record<string, string> | null = null;\n\n/**\n * Set global predefined tokens.\n * Called from configure() after processing token values.\n * Merges with existing tokens (new tokens override existing ones with same key).\n * Keys are normalized to lowercase (parser lowercases input before classification).\n * @internal\n */\nexport function setGlobalPredefinedTokens(\n  tokens: Record<string, string>,\n): void {\n  // Normalize keys to lowercase for case-insensitive matching\n  const normalizedTokens: Record<string, string> = {};\n  for (const [key, value] of Object.entries(tokens)) {\n    const lowerKey = key.toLowerCase();\n    const lowerValue = value.toLowerCase();\n\n    // Warn if trying to use bare #current to define other color tokens\n    // #current represents currentcolor which cannot be used as a base for recursive token resolution\n    // Note: #current.5 (with opacity) is allowed since it resolves to a concrete color-mix value\n    if (lowerKey.startsWith('#') && lowerValue === '#current') {\n      console.warn(\n        `Tasty: Using #current to define color token \"${key}\" is not supported. ` +\n          `The #current token represents currentcolor which cannot be used as a base for other tokens.`,\n      );\n      continue; // Skip this token\n    }\n\n    normalizedTokens[lowerKey] = value;\n  }\n  // Merge with existing tokens (consistent with how states, units, funcs are handled)\n  __globalPredefinedTokens = __globalPredefinedTokens\n    ? { ...__globalPredefinedTokens, ...normalizedTokens }\n    : normalizedTokens;\n  // Clear parser cache since token values affect parsing\n  getOrCreateParser().clearCache();\n}\n\n/**\n * Get the current global predefined tokens.\n * Returns null if no tokens are configured.\n */\nexport function getGlobalPredefinedTokens(): Record<string, string> | null {\n  return __globalPredefinedTokens;\n}\n\n/**\n * Reset global predefined tokens.\n * Used for testing.\n * @internal\n */\nexport function resetGlobalPredefinedTokens(): void {\n  __globalPredefinedTokens = null;\n  // Clear parser cache since token availability affects parsing\n  getOrCreateParser().clearCache();\n}\n\n/**\n *\n * @param {String} value\n * @param {Number} mode\n * @returns {Object<String,String|Array>}\n */\nexport function parseStyle(value: StyleValue): ProcessedStyle {\n  let str: string;\n\n  if (typeof value === 'string') {\n    str = value;\n  } else if (typeof value === 'number') {\n    str = String(value);\n  } else {\n    // boolean, null, undefined, objects etc. → empty string\n    str = '';\n  }\n\n  return getOrCreateParser().process(str);\n}\n\n/**\n * Parse color. Find it value, name and opacity.\n * Optimized to avoid heavy parseStyle calls for simple color patterns.\n */\nexport function parseColor(val: string, ignoreError = false): ParsedColor {\n  // Early return for non-strings or empty values\n  if (typeof val !== 'string') {\n    val = String(val ?? '');\n  }\n\n  val = val.trim();\n  if (!val) return {};\n\n  // Fast path: Check if it's a simple color pattern that doesn't need full parsing\n  const isSimpleColor = isSimpleColorFast(val);\n\n  let firstColor: string;\n  if (isSimpleColor) {\n    // For simple colors, use the value directly without parsing\n    firstColor = val;\n  } else {\n    const processed = parseStyle(val);\n    const extractedColor = processed.groups.find((g) => g.colors.length)\n      ?.colors[0];\n\n    if (!extractedColor) {\n      // Rate-limited warning to avoid spam\n      if (!ignoreError && devMode && colorWarningCount < MAX_COLOR_WARNINGS) {\n        console.warn('Tasty: unable to parse color:', val);\n        colorWarningCount++;\n        if (colorWarningCount === MAX_COLOR_WARNINGS) {\n          console.warn(\n            'Tasty: color parsing warnings will be suppressed from now on',\n          );\n        }\n      }\n      return {};\n    }\n\n    firstColor = extractedColor;\n  }\n\n  // Extract color name (if present) from variable pattern using precompiled regex\n  let nameMatch = firstColor.match(COLOR_VAR_PATTERN);\n  if (!nameMatch) {\n    nameMatch = firstColor.match(COLOR_VAR_COMPONENTS_PATTERN);\n  }\n\n  let opacity: number | undefined;\n  if (\n    firstColor.startsWith('rgb') ||\n    firstColor.startsWith('hsl') ||\n    firstColor.startsWith('lch') ||\n    firstColor.startsWith('oklch') ||\n    firstColor.startsWith('okhsl')\n  ) {\n    const alphaMatch = firstColor.match(RGB_ALPHA_PATTERN);\n    if (alphaMatch) {\n      const v = parseFloat(alphaMatch[1]);\n      if (!isNaN(v)) opacity = v * 100;\n    }\n  }\n\n  return {\n    color: firstColor,\n    name: nameMatch ? nameMatch[1] : undefined,\n    opacity,\n  };\n}\n\nexport function filterMods(mods: string[], allowedMods: string[]): string[] {\n  return mods.filter((mod) => allowedMods.includes(mod));\n}\n\n// ============================================================================\n// Style Stringification\n// ============================================================================\n\nconst _innerCache = new WeakMap();\nconst _topLevelCache = new WeakMap<object, string>();\n\nexport function stringifyStyles(styles: unknown): string {\n  if (styles == null || typeof styles !== 'object') return '';\n\n  const cached = _topLevelCache.get(styles as object);\n  if (cached !== undefined) return cached;\n\n  const obj = styles as Record<string, unknown>;\n  const keys = Object.keys(obj).sort();\n  const parts: string[] = [];\n  for (const k of keys) {\n    const v = obj[k];\n    if (v === undefined || typeof v === 'function' || typeof v === 'symbol')\n      continue;\n\n    const c0 = k.charCodeAt(0);\n    const needsInnerSort =\n      ((c0 >= 65 && c0 <= 90) || c0 === 38) &&\n      v &&\n      typeof v === 'object' &&\n      !Array.isArray(v);\n\n    let sv: string;\n    if (needsInnerSort) {\n      sv = _innerCache.get(v);\n      if (sv === undefined) {\n        const innerObj = v as Record<string, unknown>;\n        const innerKeys = Object.keys(innerObj).sort();\n        const innerParts: string[] = [];\n        for (const ik of innerKeys) {\n          const ivs = JSON.stringify(innerObj[ik]);\n          if (ivs !== undefined)\n            innerParts.push(JSON.stringify(ik) + ':' + ivs);\n        }\n        sv = '{' + innerParts.join(',') + '}';\n        _innerCache.set(v, sv);\n      }\n    } else {\n      sv = JSON.stringify(v);\n    }\n    parts.push(JSON.stringify(k) + ':' + sv);\n  }\n  const result = '{' + parts.join(',') + '}';\n  _topLevelCache.set(styles as object, result);\n  return result;\n}\n"],"mappings":"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"}

package/dist/utils/typography.d.ts

@@ -0,0 +1,58 @@
+import { ConfigTokens } from "../styles/types.js";
+
+//#region src/utils/typography.d.ts
+/**
+ * A typography token value: plain value or a state map for responsive/theme-aware presets.
+ *
+ * @example
+ * // Plain value
+ * fontWeight: '400'
+ * // State map
+ * fontWeight: { '': '400', '@dark': '300' }
+ */
+type TypographyTokenValue = string | number | Record<string, string | number | undefined | null | '@inherit'>;
+/**
+ * Typography preset configuration.
+ * Each preset defines font properties that get expanded into CSS custom properties.
+ * All fields accept plain values or state maps for responsive/theme-aware tokens.
+ *
+ * Use with `generateTypographyTokens()` to create typography tokens for your design system.
+ */
+interface TypographyPreset {
+  fontSize: TypographyTokenValue;
+  lineHeight: TypographyTokenValue;
+  letterSpacing?: TypographyTokenValue;
+  fontWeight: TypographyTokenValue;
+  boldFontWeight?: TypographyTokenValue;
+  iconSize?: TypographyTokenValue;
+  textTransform?: TypographyTokenValue;
+  fontFamily?: TypographyTokenValue;
+  fontStyle?: TypographyTokenValue;
+}
+/**
+ * Generate typography tokens with $ prefix for CSS custom properties.
+ *
+ * Each preset generates the following CSS custom properties:
+ * - `${name}-font-size`
+ * - `${name}-line-height`
+ * - `${name}-letter-spacing`
+ * - `${name}-font-weight`
+ * - `${name}-bold-font-weight` (if defined)
+ * - `${name}-icon-size` (if defined)
+ * - `${name}-text-transform` (if defined)
+ * - `${name}-font-family` (if defined)
+ * - `${name}-font-style` (if defined)
+ *
+ * @param presets - Typography presets object
+ * @returns ConfigTokens object with $ prefixed keys
+ *
+ * @example
+ * const customTokens = generateTypographyTokens({
+ *   myHeading: { fontSize: '24px', lineHeight: '32px', fontWeight: '700' },
+ *   body: { fontSize: '16px', lineHeight: '24px', fontWeight: '400' },
+ * });
+ */
+declare function generateTypographyTokens(presets: Record<string, TypographyPreset>): ConfigTokens;
+//#endregion
+export { TypographyPreset, TypographyTokenValue, generateTypographyTokens };
+//# sourceMappingURL=typography.d.ts.map