@tenphi/tasty 0.1.0

package/dist/states/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/states/index.ts"],"sourcesContent":["/**\n * Advanced State Mapping - Predefined States Management\n *\n * This module handles global and local predefined states for the Tasty styling system.\n * See ADVANCED_STATE_MAPPING.md for full specification.\n */\n\nimport { hasStylesGenerated } from '../config';\nimport type { Styles } from '../styles/types';\nimport { isDevEnv } from '../utils/is-dev-env';\n\n/**\n * Parsed advanced state information\n */\nexport interface ParsedAdvancedState {\n  type:\n    | 'media'\n    | 'container'\n    | 'root'\n    | 'own'\n    | 'starting'\n    | 'predefined'\n    | 'modifier';\n  condition: string; // e.g., 'width <= 920px' or 'hovered'\n  containerName?: string; // for container queries\n  raw: string; // original state key\n  mediaType?: string; // for @media:screen, @media:print, etc.\n}\n\n/**\n * Context for state parsing operations\n */\nexport interface StateParserContext {\n  localPredefinedStates: Record<string, string>;\n  globalPredefinedStates: Record<string, string>;\n  isSubElement?: boolean; // true when processing sub-element styles (for @own() validation)\n}\n\n/**\n * At-rule context for CSS generation\n */\nexport interface AtRuleContext {\n  media?: string[]; // @media conditions to wrap rule in (merged with 'and')\n  container?: { name?: string; condition: string }[]; // @container conditions (nested)\n  startingStyle?: boolean;\n  rootStates?: string[]; // :root state selectors (e.g., '[data-theme=\"dark\"]')\n  negatedRootStates?: string[]; // Negated :root state selectors for non-overlapping rules (e.g., ':not([data-theme=\"dark\"])')\n}\n\n// Built-in state names that cannot be overridden\nconst BUILTIN_STATES = new Set([\n  '@starting',\n  '@keyframes',\n  '@properties',\n  '@supports',\n  // @inherit is a value (not a key), but reserved here to prevent\n  // users from accidentally defining a state named '@inherit'.\n  '@inherit',\n]);\n\n// Reserved prefixes that are built-in\nconst RESERVED_PREFIXES = [\n  '@media',\n  '@root',\n  '@own',\n  '@(',\n  '@starting',\n  '@keyframes',\n  '@properties',\n  '@supports',\n  '@inherit',\n];\n\n// Global predefined states storage\nlet globalPredefinedStates: Record<string, string> = {};\n\n// Warnings tracking to avoid duplicates\nconst emittedWarnings = new Set<string>();\n\nconst devMode = isDevEnv();\n\n/**\n * Emit a warning only once\n */\nfunction warnOnce(key: string, message: string): void {\n  if (devMode && !emittedWarnings.has(key)) {\n    emittedWarnings.add(key);\n    console.warn(message);\n  }\n}\n\n/**\n * Configure global predefined states\n */\nexport function setGlobalPredefinedStates(\n  states: Record<string, string>,\n): void {\n  if (hasStylesGenerated()) {\n    const newStateNames = Object.keys(states).join(', ');\n    warnOnce(\n      `dynamic-states:${newStateNames}`,\n      `[Tasty] Cannot update predefined states after styles have been generated.\\n` +\n        `The new definition(s) for ${newStateNames} will be ignored.`,\n    );\n    return;\n  }\n\n  // Validate state names\n  for (const [name, value] of Object.entries(states)) {\n    // Check for valid name format\n    if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(name)) {\n      warnOnce(\n        `invalid-state-name:${name}`,\n        `[Tasty] Invalid predefined state name '${name}'. Must start with '@' followed by a letter.`,\n      );\n      continue;\n    }\n\n    // Check for reserved names\n    if (BUILTIN_STATES.has(name)) {\n      warnOnce(\n        `reserved-state:${name}`,\n        `[Tasty] Cannot define predefined state '${name}'. This name is reserved for built-in functionality.`,\n      );\n      continue;\n    }\n\n    // Check for reserved prefixes (but only exact matches, not user-defined states like @mobile)\n    // Reserved prefixes are: @media, @root, @own, @(\n    // A user state like @mobile should NOT be blocked\n    const isReservedPrefix =\n      name === '@media' ||\n      name === '@root' ||\n      name === '@own' ||\n      name.startsWith('@(');\n\n    if (isReservedPrefix) {\n      warnOnce(\n        `reserved-prefix:${name}`,\n        `[Tasty] Cannot define predefined state '${name}'. This prefix is reserved for built-in functionality.`,\n      );\n      continue;\n    }\n\n    // Check for cross-references\n    const crossRefs = extractPredefinedStateRefs(value);\n    if (crossRefs.length > 0) {\n      warnOnce(\n        `cross-ref:${name}`,\n        `[Tasty] Predefined state '${name}' references another predefined state '${crossRefs[0]}'.\\n` +\n          `Predefined states cannot reference each other. Use the full definition instead.`,\n      );\n      continue;\n    }\n\n    // Check for duplicates\n    if (\n      globalPredefinedStates[name] &&\n      globalPredefinedStates[name] !== value\n    ) {\n      warnOnce(\n        `duplicate-state:${name}`,\n        `[Tasty] Duplicate predefined state '${name}' in configure(). The last definition will be used.`,\n      );\n    }\n\n    globalPredefinedStates[name] = value;\n  }\n}\n\n/**\n * Get global predefined states\n */\nexport function getGlobalPredefinedStates(): Record<string, string> {\n  return globalPredefinedStates;\n}\n\n/**\n * Clear global predefined states (for testing only)\n */\nexport function clearGlobalPredefinedStates(): void {\n  globalPredefinedStates = {};\n  emittedWarnings.clear();\n}\n\n/**\n * Regex to match predefined state references in a string\n * Matches @name that is NOT followed by ( or : and is a complete word\n * Uses word boundary and negative lookahead\n */\nconst PREDEFINED_STATE_PATTERN = /@([A-Za-z][A-Za-z0-9-]*)(?![A-Za-z0-9-:(])/g;\n\n/**\n * Extract predefined state references from a string\n */\nexport function extractPredefinedStateRefs(value: string): string[] {\n  const matches = value.matchAll(PREDEFINED_STATE_PATTERN);\n  const refs: string[] = [];\n\n  for (const match of matches) {\n    const stateName = '@' + match[1];\n    // Skip built-in states (@starting) and duplicates\n    // Note: @media, @root, @own are always followed by '(' so the regex\n    // negative lookahead (?![A-Za-z0-9-:(]) already excludes them\n    if (!BUILTIN_STATES.has(stateName) && !refs.includes(stateName)) {\n      refs.push(stateName);\n    }\n  }\n\n  return refs;\n}\n\n/**\n * Check if a state key is a predefined state reference\n */\nexport function isPredefinedStateRef(stateKey: string): boolean {\n  if (!stateKey.startsWith('@')) return false;\n  if (BUILTIN_STATES.has(stateKey)) return false;\n\n  // Check if it's NOT a built-in prefix\n  for (const prefix of RESERVED_PREFIXES) {\n    if (stateKey === prefix || stateKey.startsWith(prefix)) {\n      // Check if it's exactly @media, @root, @own, or starts with @( or @media(\n      if (\n        stateKey === '@media' ||\n        stateKey.startsWith('@media(') ||\n        stateKey.startsWith('@media:')\n      ) {\n        return false;\n      }\n      if (stateKey === '@root' || stateKey.startsWith('@root(')) return false;\n      if (stateKey === '@own' || stateKey.startsWith('@own(')) return false;\n      if (stateKey.startsWith('@(')) return false;\n    }\n  }\n\n  // Must match the predefined state pattern\n  return /^@[A-Za-z][A-Za-z0-9-]*$/.test(stateKey);\n}\n\n/**\n * Extract local predefined states from a styles object\n * Local predefined states are top-level keys starting with @ that have string values\n * and are valid predefined state names (not built-in like @media, @root, etc.)\n */\nexport function extractLocalPredefinedStates(\n  styles: Styles,\n): Record<string, string> {\n  const localStates: Record<string, string> = {};\n\n  if (!styles || typeof styles !== 'object') {\n    return localStates;\n  }\n\n  for (const [key, value] of Object.entries(styles)) {\n    // Check if it's a predefined state definition (starts with @, has string value)\n    if (key.startsWith('@') && typeof value === 'string') {\n      // Validate name format - must be @[letter][letters/numbers/dashes]*\n      if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(key)) {\n        continue; // Skip invalid names silently (might be something else)\n      }\n\n      // Skip built-in states\n      if (BUILTIN_STATES.has(key)) {\n        continue;\n      }\n\n      // Skip reserved prefixes\n      if (\n        key === '@media' ||\n        key === '@root' ||\n        key === '@own' ||\n        key.startsWith('@(')\n      ) {\n        continue;\n      }\n\n      // Check for cross-references (predefined states cannot reference each other)\n      const crossRefs = extractPredefinedStateRefs(value);\n      if (crossRefs.length > 0) {\n        warnOnce(\n          `local-cross-ref:${key}`,\n          `[Tasty] Predefined state '${key}' references another predefined state '${crossRefs[0]}'.\\n` +\n            `Predefined states cannot reference each other. Use the full definition instead.`,\n        );\n        continue;\n      }\n\n      localStates[key] = value;\n    }\n  }\n\n  return localStates;\n}\n\n/**\n * Create a state parser context from styles\n */\nexport function createStateParserContext(\n  styles?: Styles,\n  isSubElement?: boolean,\n): StateParserContext {\n  const localStates = styles ? extractLocalPredefinedStates(styles) : {};\n\n  return {\n    localPredefinedStates: localStates,\n    globalPredefinedStates: getGlobalPredefinedStates(),\n    isSubElement,\n  };\n}\n\n/**\n * Resolve a predefined state reference to its value\n * Returns the resolved value or null if not found\n */\nexport function resolvePredefinedState(\n  stateKey: string,\n  ctx: StateParserContext,\n): string | null {\n  // Check local first (higher priority)\n  if (ctx.localPredefinedStates[stateKey]) {\n    return ctx.localPredefinedStates[stateKey];\n  }\n\n  // Then check global\n  if (ctx.globalPredefinedStates[stateKey]) {\n    return ctx.globalPredefinedStates[stateKey];\n  }\n\n  // Not found - emit warning\n  warnOnce(\n    `undefined-state:${stateKey}`,\n    `[Tasty] Undefined predefined state '${stateKey}'.\\n` +\n      `Define it in configure({ states: { '${stateKey}': '...' } }) or in the component's styles.`,\n  );\n\n  return null;\n}\n\n/**\n * Normalize state key by trimming whitespace and removing trailing/leading operators\n */\nexport function normalizeStateKey(stateKey: string): {\n  key: string;\n  warnings: string[];\n} {\n  const warnings: string[] = [];\n  let key = stateKey;\n\n  // Check for whitespace-only\n  if (key.trim() === '') {\n    if (key !== '') {\n      warnings.push(\n        `[Tasty] Whitespace-only state key normalized to default state ''.`,\n      );\n    }\n    return { key: '', warnings };\n  }\n\n  // Trim whitespace\n  key = key.trim();\n\n  // Remove trailing operators\n  const trailingOpMatch = key.match(/\\s*[&|^]\\s*$/);\n  if (trailingOpMatch) {\n    const originalKey = key;\n    key = key.slice(0, -trailingOpMatch[0].length).trim();\n    warnings.push(\n      `[Tasty] State key '${originalKey}' has trailing operator. Normalized to '${key}'.`,\n    );\n  }\n\n  // Remove leading operators (except !)\n  const leadingOpMatch = key.match(/^\\s*[&|^]\\s*/);\n  if (leadingOpMatch) {\n    const originalKey = key;\n    key = key.slice(leadingOpMatch[0].length).trim();\n    warnings.push(\n      `[Tasty] State key '${originalKey}' has leading operator. Normalized to '${key}'.`,\n    );\n  }\n\n  return { key, warnings };\n}\n\n/**\n * Expand dimension shorthands in a condition string\n * w -> width, h -> height, is -> inline-size, bs -> block-size\n */\nexport function expandDimensionShorthands(condition: string): string {\n  // Replace dimension shorthands (only when they appear as standalone words)\n  let result = condition;\n\n  // w -> width (but not part of other words)\n  result = result.replace(/\\bw\\b/g, 'width');\n\n  // h -> height\n  result = result.replace(/\\bh\\b/g, 'height');\n\n  // is -> inline-size\n  result = result.replace(/\\bis\\b/g, 'inline-size');\n\n  // bs -> block-size\n  result = result.replace(/\\bbs\\b/g, 'block-size');\n\n  return result;\n}\n\n/**\n * Convert tasty units in a string (e.g., 40x -> calc(var(--gap) * 40))\n */\nexport function expandTastyUnits(value: string): string {\n  // Match number followed by 'x' unit (tasty gap unit)\n  return value.replace(/(\\d+(?:\\.\\d+)?)\\s*x\\b/g, (_, num) => {\n    return `calc(var(--gap) * ${num})`;\n  });\n}\n\n/**\n * Parse an advanced state key and return its type and components\n */\nexport function parseAdvancedState(\n  stateKey: string,\n  ctx: StateParserContext,\n): ParsedAdvancedState {\n  const raw = stateKey;\n\n  // Check for @starting (exact match)\n  if (stateKey === '@starting') {\n    return {\n      type: 'starting',\n      condition: '',\n      raw,\n    };\n  }\n\n  // Check for @media:type (e.g., @media:print)\n  if (stateKey.startsWith('@media:')) {\n    const mediaType = stateKey.slice(7); // Remove '@media:'\n    if (!['all', 'screen', 'print', 'speech'].includes(mediaType)) {\n      warnOnce(\n        `unknown-media-type:${mediaType}`,\n        `[Tasty] Unknown media type '${mediaType}'. Valid types: all, screen, print, speech.`,\n      );\n    }\n    return {\n      type: 'media',\n      condition: '',\n      mediaType,\n      raw,\n    };\n  }\n\n  // Check for @media(...) - media query with condition\n  if (stateKey.startsWith('@media(')) {\n    const endParen = findMatchingParen(stateKey, 6);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-media:${stateKey}`,\n        `[Tasty] Unclosed media query '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    let condition = stateKey.slice(7, endParen);\n\n    // Check for empty condition\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-media:${stateKey}`,\n        `[Tasty] Empty media query condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Expand shorthands and units\n    condition = expandDimensionShorthands(condition);\n    condition = expandTastyUnits(condition);\n\n    return {\n      type: 'media',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @root(...) - root state\n  if (stateKey.startsWith('@root(')) {\n    const endParen = findMatchingParen(stateKey, 5);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-root:${stateKey}`,\n        `[Tasty] Unclosed root state '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const condition = stateKey.slice(6, endParen);\n\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-root:${stateKey}`,\n        `[Tasty] Empty root state condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    return {\n      type: 'root',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @own(...) - sub-element own state\n  if (stateKey.startsWith('@own(')) {\n    const endParen = findMatchingParen(stateKey, 4);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-own:${stateKey}`,\n        `[Tasty] Unclosed own state '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const condition = stateKey.slice(5, endParen);\n\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-own:${stateKey}`,\n        `[Tasty] Empty own state condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Check if used outside sub-element context\n    if (!ctx.isSubElement) {\n      warnOnce(\n        `own-outside-subelement:${stateKey}`,\n        `[Tasty] @own(${condition}) used outside sub-element context.\\n` +\n          `@own() is equivalent to '${condition}' at the root level. ` +\n          `Did you mean to use it inside a sub-element?`,\n      );\n      // Treat as regular modifier\n      return {\n        type: 'modifier',\n        condition,\n        raw,\n      };\n    }\n\n    return {\n      type: 'own',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @(...) - container query (unnamed or named)\n  if (stateKey.startsWith('@(')) {\n    const endParen = findMatchingParen(stateKey, 1);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-container:${stateKey}`,\n        `[Tasty] Unclosed container query '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const content = stateKey.slice(2, endParen);\n\n    if (!content.trim()) {\n      warnOnce(\n        `empty-container:${stateKey}`,\n        `[Tasty] Empty container query '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Check if named container (first token is name, followed by comma)\n    // Use parentheses-aware comma search so inner commas (e.g., scroll-state(a, b)) are skipped\n    const commaIndex = findTopLevelComma(content);\n    let containerName: string | undefined;\n    let condition: string;\n\n    if (commaIndex !== -1) {\n      // Named container: @(layout, w < 600px)\n      containerName = content.slice(0, commaIndex).trim();\n      condition = content.slice(commaIndex + 1).trim();\n    } else {\n      // Unnamed container: @(w < 600px)\n      condition = content.trim();\n    }\n\n    // Check for style query shorthand (starts with $)\n    if (condition.startsWith('$')) {\n      // Style query: @(layout, $compact) or @(layout, $variant=compact)\n      const styleCondition = parseStyleQuery(condition);\n      if (!styleCondition) {\n        warnOnce(\n          `invalid-style-query:${stateKey}`,\n          `[Tasty] Invalid style query '${condition}' in container query.`,\n        );\n        return { type: 'modifier', condition: stateKey, raw };\n      }\n      condition = styleCondition;\n    } else if (/^[a-zA-Z][\\w-]*\\s*\\(/.test(condition)) {\n      // Function-like syntax: scroll-state(...), style(...), etc.\n      // Pass through verbatim — no dimension expansion needed\n    } else {\n      // Dimension query - expand shorthands and units\n      condition = expandDimensionShorthands(condition);\n      condition = expandTastyUnits(condition);\n    }\n\n    return {\n      type: 'container',\n      condition,\n      containerName,\n      raw,\n    };\n  }\n\n  // Check for predefined state reference\n  if (isPredefinedStateRef(stateKey)) {\n    const resolved = resolvePredefinedState(stateKey, ctx);\n    if (resolved) {\n      // Recursively parse the resolved value to extract the actual state type\n      // (e.g., @mobile -> @media(w < 768px) should become a media state)\n      const parsedResolved = parseAdvancedState(resolved, ctx);\n      return {\n        ...parsedResolved,\n        raw, // Keep original raw for traceability\n      };\n    }\n    // If not resolved, treat as modifier (will likely produce invalid CSS)\n    return {\n      type: 'modifier',\n      condition: stateKey,\n      raw,\n    };\n  }\n\n  // Regular modifier (boolean mod, pseudo-class, class, attribute)\n  return {\n    type: 'modifier',\n    condition: stateKey,\n    raw,\n  };\n}\n\n/**\n * Parse a style query condition (e.g., $compact, $variant=compact, $variant=\"very compact\")\n */\nfunction parseStyleQuery(condition: string): string | null {\n  // Remove $ prefix\n  const query = condition.slice(1);\n\n  // Check for comparison operators (not supported)\n  if (/[<>]/.test(query)) {\n    warnOnce(\n      `style-query-comparison:${condition}`,\n      `[Tasty] Style queries only support equality. '${condition}' is invalid. Use '${condition.split(/[<>]/)[0]}=...' instead.`,\n    );\n    return null;\n  }\n\n  // Check for equality\n  const eqIndex = query.indexOf('=');\n  if (eqIndex === -1) {\n    // Just existence check: style(--compact)\n    return `style(--${query})`;\n  }\n\n  const propName = query.slice(0, eqIndex).trim();\n  let value = query.slice(eqIndex + 1).trim();\n\n  // Handle quoted values\n  if (\n    (value.startsWith('\"') && value.endsWith('\"')) ||\n    (value.startsWith(\"'\") && value.endsWith(\"'\"))\n  ) {\n    // Keep quotes for CSS\n  } else {\n    // Add quotes if needed\n    value = `\"${value}\"`;\n  }\n\n  // Expand tasty units in value\n  value = expandTastyUnits(value);\n\n  return `style(--${propName}: ${value})`;\n}\n\n/**\n * Find the index of the first comma at parentheses depth 0.\n * Returns -1 if no top-level comma is found.\n * This prevents splitting on commas inside function calls like scroll-state(a, b).\n */\nexport function findTopLevelComma(s: string): number {\n  let depth = 0;\n\n  for (let i = 0; i < s.length; i++) {\n    if (s[i] === '(') depth++;\n    else if (s[i] === ')') depth--;\n    else if (s[i] === ',' && depth === 0) return i;\n  }\n\n  return -1;\n}\n\nfunction findMatchingParen(str: string, startIndex: number): number {\n  let depth = 1;\n  let i = startIndex + 1;\n\n  while (i < str.length && depth > 0) {\n    if (str[i] === '(') depth++;\n    else if (str[i] === ')') depth--;\n    i++;\n  }\n\n  return depth === 0 ? i - 1 : -1;\n}\n\n/**\n * Check if a state key is an advanced state (starts with @)\n */\nexport function isAdvancedState(stateKey: string): boolean {\n  return stateKey.startsWith('@') || stateKey.startsWith('!@');\n}\n\n/**\n * Detect the type of advanced state from a raw state key\n */\nexport function detectAdvancedStateType(\n  stateKey: string,\n): ParsedAdvancedState['type'] {\n  // Handle negation prefix\n  const key = stateKey.startsWith('!') ? stateKey.slice(1) : stateKey;\n\n  if (key === '@starting') return 'starting';\n  if (key.startsWith('@media')) return 'media';\n  if (key.startsWith('@root(')) return 'root';\n  if (key.startsWith('@own(')) return 'own';\n  if (key.startsWith('@(')) return 'container';\n  if (isPredefinedStateRef(key)) return 'predefined';\n  return 'modifier';\n}\n"],"mappings":"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"}

package/dist/states/index.mjs

@@ -0,0 +1,161 @@
+import { isDevEnv } from "../utils/is-dev-env.mjs";
+import { hasStylesGenerated } from "../config.mjs";
+
+//#region src/states/index.ts
+/**
+* Advanced State Mapping - Predefined States Management
+*
+* This module handles global and local predefined states for the Tasty styling system.
+* See ADVANCED_STATE_MAPPING.md for full specification.
+*/
+const BUILTIN_STATES = new Set([
+	"@starting",
+	"@keyframes",
+	"@properties",
+	"@supports",
+	"@inherit"
+]);
+let globalPredefinedStates = {};
+const emittedWarnings = /* @__PURE__ */ new Set();
+const devMode = isDevEnv();
+/**
+* Emit a warning only once
+*/
+function warnOnce(key, message) {
+	if (devMode && !emittedWarnings.has(key)) {
+		emittedWarnings.add(key);
+		console.warn(message);
+	}
+}
+/**
+* Configure global predefined states
+*/
+function setGlobalPredefinedStates(states) {
+	if (hasStylesGenerated()) {
+		const newStateNames = Object.keys(states).join(", ");
+		warnOnce(`dynamic-states:${newStateNames}`, `[Tasty] Cannot update predefined states after styles have been generated.\nThe new definition(s) for ${newStateNames} will be ignored.`);
+		return;
+	}
+	for (const [name, value] of Object.entries(states)) {
+		if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(name)) {
+			warnOnce(`invalid-state-name:${name}`, `[Tasty] Invalid predefined state name '${name}'. Must start with '@' followed by a letter.`);
+			continue;
+		}
+		if (BUILTIN_STATES.has(name)) {
+			warnOnce(`reserved-state:${name}`, `[Tasty] Cannot define predefined state '${name}'. This name is reserved for built-in functionality.`);
+			continue;
+		}
+		if (name === "@media" || name === "@root" || name === "@own" || name.startsWith("@(")) {
+			warnOnce(`reserved-prefix:${name}`, `[Tasty] Cannot define predefined state '${name}'. This prefix is reserved for built-in functionality.`);
+			continue;
+		}
+		const crossRefs = extractPredefinedStateRefs(value);
+		if (crossRefs.length > 0) {
+			warnOnce(`cross-ref:${name}`, `[Tasty] Predefined state '${name}' references another predefined state '${crossRefs[0]}'.\nPredefined states cannot reference each other. Use the full definition instead.`);
+			continue;
+		}
+		if (globalPredefinedStates[name] && globalPredefinedStates[name] !== value) warnOnce(`duplicate-state:${name}`, `[Tasty] Duplicate predefined state '${name}' in configure(). The last definition will be used.`);
+		globalPredefinedStates[name] = value;
+	}
+}
+/**
+* Get global predefined states
+*/
+function getGlobalPredefinedStates() {
+	return globalPredefinedStates;
+}
+/**
+* Regex to match predefined state references in a string
+* Matches @name that is NOT followed by ( or : and is a complete word
+* Uses word boundary and negative lookahead
+*/
+const PREDEFINED_STATE_PATTERN = /@([A-Za-z][A-Za-z0-9-]*)(?![A-Za-z0-9-:(])/g;
+/**
+* Extract predefined state references from a string
+*/
+function extractPredefinedStateRefs(value) {
+	const matches = value.matchAll(PREDEFINED_STATE_PATTERN);
+	const refs = [];
+	for (const match of matches) {
+		const stateName = "@" + match[1];
+		if (!BUILTIN_STATES.has(stateName) && !refs.includes(stateName)) refs.push(stateName);
+	}
+	return refs;
+}
+/**
+* Extract local predefined states from a styles object
+* Local predefined states are top-level keys starting with @ that have string values
+* and are valid predefined state names (not built-in like @media, @root, etc.)
+*/
+function extractLocalPredefinedStates(styles) {
+	const localStates = {};
+	if (!styles || typeof styles !== "object") return localStates;
+	for (const [key, value] of Object.entries(styles)) if (key.startsWith("@") && typeof value === "string") {
+		if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(key)) continue;
+		if (BUILTIN_STATES.has(key)) continue;
+		if (key === "@media" || key === "@root" || key === "@own" || key.startsWith("@(")) continue;
+		const crossRefs = extractPredefinedStateRefs(value);
+		if (crossRefs.length > 0) {
+			warnOnce(`local-cross-ref:${key}`, `[Tasty] Predefined state '${key}' references another predefined state '${crossRefs[0]}'.\nPredefined states cannot reference each other. Use the full definition instead.`);
+			continue;
+		}
+		localStates[key] = value;
+	}
+	return localStates;
+}
+/**
+* Create a state parser context from styles
+*/
+function createStateParserContext(styles, isSubElement) {
+	return {
+		localPredefinedStates: styles ? extractLocalPredefinedStates(styles) : {},
+		globalPredefinedStates: getGlobalPredefinedStates(),
+		isSubElement
+	};
+}
+/**
+* Resolve a predefined state reference to its value
+* Returns the resolved value or null if not found
+*/
+function resolvePredefinedState(stateKey, ctx) {
+	if (ctx.localPredefinedStates[stateKey]) return ctx.localPredefinedStates[stateKey];
+	if (ctx.globalPredefinedStates[stateKey]) return ctx.globalPredefinedStates[stateKey];
+	warnOnce(`undefined-state:${stateKey}`, `[Tasty] Undefined predefined state '${stateKey}'.\nDefine it in configure({ states: { '${stateKey}': '...' } }) or in the component's styles.`);
+	return null;
+}
+/**
+* Expand dimension shorthands in a condition string
+* w -> width, h -> height, is -> inline-size, bs -> block-size
+*/
+function expandDimensionShorthands(condition) {
+	let result = condition;
+	result = result.replace(/\bw\b/g, "width");
+	result = result.replace(/\bh\b/g, "height");
+	result = result.replace(/\bis\b/g, "inline-size");
+	result = result.replace(/\bbs\b/g, "block-size");
+	return result;
+}
+/**
+* Convert tasty units in a string (e.g., 40x -> calc(var(--gap) * 40))
+*/
+function expandTastyUnits(value) {
+	return value.replace(/(\d+(?:\.\d+)?)\s*x\b/g, (_, num) => {
+		return `calc(var(--gap) * ${num})`;
+	});
+}
+/**
+* Find the index of the first comma at parentheses depth 0.
+* Returns -1 if no top-level comma is found.
+* This prevents splitting on commas inside function calls like scroll-state(a, b).
+*/
+function findTopLevelComma(s) {
+	let depth = 0;
+	for (let i = 0; i < s.length; i++) if (s[i] === "(") depth++;
+	else if (s[i] === ")") depth--;
+	else if (s[i] === "," && depth === 0) return i;
+	return -1;
+}
+
+//#endregion
+export { createStateParserContext, expandDimensionShorthands, expandTastyUnits, extractLocalPredefinedStates, extractPredefinedStateRefs, findTopLevelComma, resolvePredefinedState, setGlobalPredefinedStates };
+//# sourceMappingURL=index.mjs.map

package/dist/states/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/states/index.ts"],"sourcesContent":["/**\n * Advanced State Mapping - Predefined States Management\n *\n * This module handles global and local predefined states for the Tasty styling system.\n * See ADVANCED_STATE_MAPPING.md for full specification.\n */\n\nimport { hasStylesGenerated } from '../config';\nimport type { Styles } from '../styles/types';\nimport { isDevEnv } from '../utils/is-dev-env';\n\n/**\n * Parsed advanced state information\n */\nexport interface ParsedAdvancedState {\n  type:\n    | 'media'\n    | 'container'\n    | 'root'\n    | 'own'\n    | 'starting'\n    | 'predefined'\n    | 'modifier';\n  condition: string; // e.g., 'width <= 920px' or 'hovered'\n  containerName?: string; // for container queries\n  raw: string; // original state key\n  mediaType?: string; // for @media:screen, @media:print, etc.\n}\n\n/**\n * Context for state parsing operations\n */\nexport interface StateParserContext {\n  localPredefinedStates: Record<string, string>;\n  globalPredefinedStates: Record<string, string>;\n  isSubElement?: boolean; // true when processing sub-element styles (for @own() validation)\n}\n\n/**\n * At-rule context for CSS generation\n */\nexport interface AtRuleContext {\n  media?: string[]; // @media conditions to wrap rule in (merged with 'and')\n  container?: { name?: string; condition: string }[]; // @container conditions (nested)\n  startingStyle?: boolean;\n  rootStates?: string[]; // :root state selectors (e.g., '[data-theme=\"dark\"]')\n  negatedRootStates?: string[]; // Negated :root state selectors for non-overlapping rules (e.g., ':not([data-theme=\"dark\"])')\n}\n\n// Built-in state names that cannot be overridden\nconst BUILTIN_STATES = new Set([\n  '@starting',\n  '@keyframes',\n  '@properties',\n  '@supports',\n  // @inherit is a value (not a key), but reserved here to prevent\n  // users from accidentally defining a state named '@inherit'.\n  '@inherit',\n]);\n\n// Reserved prefixes that are built-in\nconst RESERVED_PREFIXES = [\n  '@media',\n  '@root',\n  '@own',\n  '@(',\n  '@starting',\n  '@keyframes',\n  '@properties',\n  '@supports',\n  '@inherit',\n];\n\n// Global predefined states storage\nlet globalPredefinedStates: Record<string, string> = {};\n\n// Warnings tracking to avoid duplicates\nconst emittedWarnings = new Set<string>();\n\nconst devMode = isDevEnv();\n\n/**\n * Emit a warning only once\n */\nfunction warnOnce(key: string, message: string): void {\n  if (devMode && !emittedWarnings.has(key)) {\n    emittedWarnings.add(key);\n    console.warn(message);\n  }\n}\n\n/**\n * Configure global predefined states\n */\nexport function setGlobalPredefinedStates(\n  states: Record<string, string>,\n): void {\n  if (hasStylesGenerated()) {\n    const newStateNames = Object.keys(states).join(', ');\n    warnOnce(\n      `dynamic-states:${newStateNames}`,\n      `[Tasty] Cannot update predefined states after styles have been generated.\\n` +\n        `The new definition(s) for ${newStateNames} will be ignored.`,\n    );\n    return;\n  }\n\n  // Validate state names\n  for (const [name, value] of Object.entries(states)) {\n    // Check for valid name format\n    if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(name)) {\n      warnOnce(\n        `invalid-state-name:${name}`,\n        `[Tasty] Invalid predefined state name '${name}'. Must start with '@' followed by a letter.`,\n      );\n      continue;\n    }\n\n    // Check for reserved names\n    if (BUILTIN_STATES.has(name)) {\n      warnOnce(\n        `reserved-state:${name}`,\n        `[Tasty] Cannot define predefined state '${name}'. This name is reserved for built-in functionality.`,\n      );\n      continue;\n    }\n\n    // Check for reserved prefixes (but only exact matches, not user-defined states like @mobile)\n    // Reserved prefixes are: @media, @root, @own, @(\n    // A user state like @mobile should NOT be blocked\n    const isReservedPrefix =\n      name === '@media' ||\n      name === '@root' ||\n      name === '@own' ||\n      name.startsWith('@(');\n\n    if (isReservedPrefix) {\n      warnOnce(\n        `reserved-prefix:${name}`,\n        `[Tasty] Cannot define predefined state '${name}'. This prefix is reserved for built-in functionality.`,\n      );\n      continue;\n    }\n\n    // Check for cross-references\n    const crossRefs = extractPredefinedStateRefs(value);\n    if (crossRefs.length > 0) {\n      warnOnce(\n        `cross-ref:${name}`,\n        `[Tasty] Predefined state '${name}' references another predefined state '${crossRefs[0]}'.\\n` +\n          `Predefined states cannot reference each other. Use the full definition instead.`,\n      );\n      continue;\n    }\n\n    // Check for duplicates\n    if (\n      globalPredefinedStates[name] &&\n      globalPredefinedStates[name] !== value\n    ) {\n      warnOnce(\n        `duplicate-state:${name}`,\n        `[Tasty] Duplicate predefined state '${name}' in configure(). The last definition will be used.`,\n      );\n    }\n\n    globalPredefinedStates[name] = value;\n  }\n}\n\n/**\n * Get global predefined states\n */\nexport function getGlobalPredefinedStates(): Record<string, string> {\n  return globalPredefinedStates;\n}\n\n/**\n * Clear global predefined states (for testing only)\n */\nexport function clearGlobalPredefinedStates(): void {\n  globalPredefinedStates = {};\n  emittedWarnings.clear();\n}\n\n/**\n * Regex to match predefined state references in a string\n * Matches @name that is NOT followed by ( or : and is a complete word\n * Uses word boundary and negative lookahead\n */\nconst PREDEFINED_STATE_PATTERN = /@([A-Za-z][A-Za-z0-9-]*)(?![A-Za-z0-9-:(])/g;\n\n/**\n * Extract predefined state references from a string\n */\nexport function extractPredefinedStateRefs(value: string): string[] {\n  const matches = value.matchAll(PREDEFINED_STATE_PATTERN);\n  const refs: string[] = [];\n\n  for (const match of matches) {\n    const stateName = '@' + match[1];\n    // Skip built-in states (@starting) and duplicates\n    // Note: @media, @root, @own are always followed by '(' so the regex\n    // negative lookahead (?![A-Za-z0-9-:(]) already excludes them\n    if (!BUILTIN_STATES.has(stateName) && !refs.includes(stateName)) {\n      refs.push(stateName);\n    }\n  }\n\n  return refs;\n}\n\n/**\n * Check if a state key is a predefined state reference\n */\nexport function isPredefinedStateRef(stateKey: string): boolean {\n  if (!stateKey.startsWith('@')) return false;\n  if (BUILTIN_STATES.has(stateKey)) return false;\n\n  // Check if it's NOT a built-in prefix\n  for (const prefix of RESERVED_PREFIXES) {\n    if (stateKey === prefix || stateKey.startsWith(prefix)) {\n      // Check if it's exactly @media, @root, @own, or starts with @( or @media(\n      if (\n        stateKey === '@media' ||\n        stateKey.startsWith('@media(') ||\n        stateKey.startsWith('@media:')\n      ) {\n        return false;\n      }\n      if (stateKey === '@root' || stateKey.startsWith('@root(')) return false;\n      if (stateKey === '@own' || stateKey.startsWith('@own(')) return false;\n      if (stateKey.startsWith('@(')) return false;\n    }\n  }\n\n  // Must match the predefined state pattern\n  return /^@[A-Za-z][A-Za-z0-9-]*$/.test(stateKey);\n}\n\n/**\n * Extract local predefined states from a styles object\n * Local predefined states are top-level keys starting with @ that have string values\n * and are valid predefined state names (not built-in like @media, @root, etc.)\n */\nexport function extractLocalPredefinedStates(\n  styles: Styles,\n): Record<string, string> {\n  const localStates: Record<string, string> = {};\n\n  if (!styles || typeof styles !== 'object') {\n    return localStates;\n  }\n\n  for (const [key, value] of Object.entries(styles)) {\n    // Check if it's a predefined state definition (starts with @, has string value)\n    if (key.startsWith('@') && typeof value === 'string') {\n      // Validate name format - must be @[letter][letters/numbers/dashes]*\n      if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(key)) {\n        continue; // Skip invalid names silently (might be something else)\n      }\n\n      // Skip built-in states\n      if (BUILTIN_STATES.has(key)) {\n        continue;\n      }\n\n      // Skip reserved prefixes\n      if (\n        key === '@media' ||\n        key === '@root' ||\n        key === '@own' ||\n        key.startsWith('@(')\n      ) {\n        continue;\n      }\n\n      // Check for cross-references (predefined states cannot reference each other)\n      const crossRefs = extractPredefinedStateRefs(value);\n      if (crossRefs.length > 0) {\n        warnOnce(\n          `local-cross-ref:${key}`,\n          `[Tasty] Predefined state '${key}' references another predefined state '${crossRefs[0]}'.\\n` +\n            `Predefined states cannot reference each other. Use the full definition instead.`,\n        );\n        continue;\n      }\n\n      localStates[key] = value;\n    }\n  }\n\n  return localStates;\n}\n\n/**\n * Create a state parser context from styles\n */\nexport function createStateParserContext(\n  styles?: Styles,\n  isSubElement?: boolean,\n): StateParserContext {\n  const localStates = styles ? extractLocalPredefinedStates(styles) : {};\n\n  return {\n    localPredefinedStates: localStates,\n    globalPredefinedStates: getGlobalPredefinedStates(),\n    isSubElement,\n  };\n}\n\n/**\n * Resolve a predefined state reference to its value\n * Returns the resolved value or null if not found\n */\nexport function resolvePredefinedState(\n  stateKey: string,\n  ctx: StateParserContext,\n): string | null {\n  // Check local first (higher priority)\n  if (ctx.localPredefinedStates[stateKey]) {\n    return ctx.localPredefinedStates[stateKey];\n  }\n\n  // Then check global\n  if (ctx.globalPredefinedStates[stateKey]) {\n    return ctx.globalPredefinedStates[stateKey];\n  }\n\n  // Not found - emit warning\n  warnOnce(\n    `undefined-state:${stateKey}`,\n    `[Tasty] Undefined predefined state '${stateKey}'.\\n` +\n      `Define it in configure({ states: { '${stateKey}': '...' } }) or in the component's styles.`,\n  );\n\n  return null;\n}\n\n/**\n * Normalize state key by trimming whitespace and removing trailing/leading operators\n */\nexport function normalizeStateKey(stateKey: string): {\n  key: string;\n  warnings: string[];\n} {\n  const warnings: string[] = [];\n  let key = stateKey;\n\n  // Check for whitespace-only\n  if (key.trim() === '') {\n    if (key !== '') {\n      warnings.push(\n        `[Tasty] Whitespace-only state key normalized to default state ''.`,\n      );\n    }\n    return { key: '', warnings };\n  }\n\n  // Trim whitespace\n  key = key.trim();\n\n  // Remove trailing operators\n  const trailingOpMatch = key.match(/\\s*[&|^]\\s*$/);\n  if (trailingOpMatch) {\n    const originalKey = key;\n    key = key.slice(0, -trailingOpMatch[0].length).trim();\n    warnings.push(\n      `[Tasty] State key '${originalKey}' has trailing operator. Normalized to '${key}'.`,\n    );\n  }\n\n  // Remove leading operators (except !)\n  const leadingOpMatch = key.match(/^\\s*[&|^]\\s*/);\n  if (leadingOpMatch) {\n    const originalKey = key;\n    key = key.slice(leadingOpMatch[0].length).trim();\n    warnings.push(\n      `[Tasty] State key '${originalKey}' has leading operator. Normalized to '${key}'.`,\n    );\n  }\n\n  return { key, warnings };\n}\n\n/**\n * Expand dimension shorthands in a condition string\n * w -> width, h -> height, is -> inline-size, bs -> block-size\n */\nexport function expandDimensionShorthands(condition: string): string {\n  // Replace dimension shorthands (only when they appear as standalone words)\n  let result = condition;\n\n  // w -> width (but not part of other words)\n  result = result.replace(/\\bw\\b/g, 'width');\n\n  // h -> height\n  result = result.replace(/\\bh\\b/g, 'height');\n\n  // is -> inline-size\n  result = result.replace(/\\bis\\b/g, 'inline-size');\n\n  // bs -> block-size\n  result = result.replace(/\\bbs\\b/g, 'block-size');\n\n  return result;\n}\n\n/**\n * Convert tasty units in a string (e.g., 40x -> calc(var(--gap) * 40))\n */\nexport function expandTastyUnits(value: string): string {\n  // Match number followed by 'x' unit (tasty gap unit)\n  return value.replace(/(\\d+(?:\\.\\d+)?)\\s*x\\b/g, (_, num) => {\n    return `calc(var(--gap) * ${num})`;\n  });\n}\n\n/**\n * Parse an advanced state key and return its type and components\n */\nexport function parseAdvancedState(\n  stateKey: string,\n  ctx: StateParserContext,\n): ParsedAdvancedState {\n  const raw = stateKey;\n\n  // Check for @starting (exact match)\n  if (stateKey === '@starting') {\n    return {\n      type: 'starting',\n      condition: '',\n      raw,\n    };\n  }\n\n  // Check for @media:type (e.g., @media:print)\n  if (stateKey.startsWith('@media:')) {\n    const mediaType = stateKey.slice(7); // Remove '@media:'\n    if (!['all', 'screen', 'print', 'speech'].includes(mediaType)) {\n      warnOnce(\n        `unknown-media-type:${mediaType}`,\n        `[Tasty] Unknown media type '${mediaType}'. Valid types: all, screen, print, speech.`,\n      );\n    }\n    return {\n      type: 'media',\n      condition: '',\n      mediaType,\n      raw,\n    };\n  }\n\n  // Check for @media(...) - media query with condition\n  if (stateKey.startsWith('@media(')) {\n    const endParen = findMatchingParen(stateKey, 6);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-media:${stateKey}`,\n        `[Tasty] Unclosed media query '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    let condition = stateKey.slice(7, endParen);\n\n    // Check for empty condition\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-media:${stateKey}`,\n        `[Tasty] Empty media query condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Expand shorthands and units\n    condition = expandDimensionShorthands(condition);\n    condition = expandTastyUnits(condition);\n\n    return {\n      type: 'media',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @root(...) - root state\n  if (stateKey.startsWith('@root(')) {\n    const endParen = findMatchingParen(stateKey, 5);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-root:${stateKey}`,\n        `[Tasty] Unclosed root state '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const condition = stateKey.slice(6, endParen);\n\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-root:${stateKey}`,\n        `[Tasty] Empty root state condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    return {\n      type: 'root',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @own(...) - sub-element own state\n  if (stateKey.startsWith('@own(')) {\n    const endParen = findMatchingParen(stateKey, 4);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-own:${stateKey}`,\n        `[Tasty] Unclosed own state '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const condition = stateKey.slice(5, endParen);\n\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-own:${stateKey}`,\n        `[Tasty] Empty own state condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Check if used outside sub-element context\n    if (!ctx.isSubElement) {\n      warnOnce(\n        `own-outside-subelement:${stateKey}`,\n        `[Tasty] @own(${condition}) used outside sub-element context.\\n` +\n          `@own() is equivalent to '${condition}' at the root level. ` +\n          `Did you mean to use it inside a sub-element?`,\n      );\n      // Treat as regular modifier\n      return {\n        type: 'modifier',\n        condition,\n        raw,\n      };\n    }\n\n    return {\n      type: 'own',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @(...) - container query (unnamed or named)\n  if (stateKey.startsWith('@(')) {\n    const endParen = findMatchingParen(stateKey, 1);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-container:${stateKey}`,\n        `[Tasty] Unclosed container query '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const content = stateKey.slice(2, endParen);\n\n    if (!content.trim()) {\n      warnOnce(\n        `empty-container:${stateKey}`,\n        `[Tasty] Empty container query '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Check if named container (first token is name, followed by comma)\n    // Use parentheses-aware comma search so inner commas (e.g., scroll-state(a, b)) are skipped\n    const commaIndex = findTopLevelComma(content);\n    let containerName: string | undefined;\n    let condition: string;\n\n    if (commaIndex !== -1) {\n      // Named container: @(layout, w < 600px)\n      containerName = content.slice(0, commaIndex).trim();\n      condition = content.slice(commaIndex + 1).trim();\n    } else {\n      // Unnamed container: @(w < 600px)\n      condition = content.trim();\n    }\n\n    // Check for style query shorthand (starts with $)\n    if (condition.startsWith('$')) {\n      // Style query: @(layout, $compact) or @(layout, $variant=compact)\n      const styleCondition = parseStyleQuery(condition);\n      if (!styleCondition) {\n        warnOnce(\n          `invalid-style-query:${stateKey}`,\n          `[Tasty] Invalid style query '${condition}' in container query.`,\n        );\n        return { type: 'modifier', condition: stateKey, raw };\n      }\n      condition = styleCondition;\n    } else if (/^[a-zA-Z][\\w-]*\\s*\\(/.test(condition)) {\n      // Function-like syntax: scroll-state(...), style(...), etc.\n      // Pass through verbatim — no dimension expansion needed\n    } else {\n      // Dimension query - expand shorthands and units\n      condition = expandDimensionShorthands(condition);\n      condition = expandTastyUnits(condition);\n    }\n\n    return {\n      type: 'container',\n      condition,\n      containerName,\n      raw,\n    };\n  }\n\n  // Check for predefined state reference\n  if (isPredefinedStateRef(stateKey)) {\n    const resolved = resolvePredefinedState(stateKey, ctx);\n    if (resolved) {\n      // Recursively parse the resolved value to extract the actual state type\n      // (e.g., @mobile -> @media(w < 768px) should become a media state)\n      const parsedResolved = parseAdvancedState(resolved, ctx);\n      return {\n        ...parsedResolved,\n        raw, // Keep original raw for traceability\n      };\n    }\n    // If not resolved, treat as modifier (will likely produce invalid CSS)\n    return {\n      type: 'modifier',\n      condition: stateKey,\n      raw,\n    };\n  }\n\n  // Regular modifier (boolean mod, pseudo-class, class, attribute)\n  return {\n    type: 'modifier',\n    condition: stateKey,\n    raw,\n  };\n}\n\n/**\n * Parse a style query condition (e.g., $compact, $variant=compact, $variant=\"very compact\")\n */\nfunction parseStyleQuery(condition: string): string | null {\n  // Remove $ prefix\n  const query = condition.slice(1);\n\n  // Check for comparison operators (not supported)\n  if (/[<>]/.test(query)) {\n    warnOnce(\n      `style-query-comparison:${condition}`,\n      `[Tasty] Style queries only support equality. '${condition}' is invalid. Use '${condition.split(/[<>]/)[0]}=...' instead.`,\n    );\n    return null;\n  }\n\n  // Check for equality\n  const eqIndex = query.indexOf('=');\n  if (eqIndex === -1) {\n    // Just existence check: style(--compact)\n    return `style(--${query})`;\n  }\n\n  const propName = query.slice(0, eqIndex).trim();\n  let value = query.slice(eqIndex + 1).trim();\n\n  // Handle quoted values\n  if (\n    (value.startsWith('\"') && value.endsWith('\"')) ||\n    (value.startsWith(\"'\") && value.endsWith(\"'\"))\n  ) {\n    // Keep quotes for CSS\n  } else {\n    // Add quotes if needed\n    value = `\"${value}\"`;\n  }\n\n  // Expand tasty units in value\n  value = expandTastyUnits(value);\n\n  return `style(--${propName}: ${value})`;\n}\n\n/**\n * Find the index of the first comma at parentheses depth 0.\n * Returns -1 if no top-level comma is found.\n * This prevents splitting on commas inside function calls like scroll-state(a, b).\n */\nexport function findTopLevelComma(s: string): number {\n  let depth = 0;\n\n  for (let i = 0; i < s.length; i++) {\n    if (s[i] === '(') depth++;\n    else if (s[i] === ')') depth--;\n    else if (s[i] === ',' && depth === 0) return i;\n  }\n\n  return -1;\n}\n\nfunction findMatchingParen(str: string, startIndex: number): number {\n  let depth = 1;\n  let i = startIndex + 1;\n\n  while (i < str.length && depth > 0) {\n    if (str[i] === '(') depth++;\n    else if (str[i] === ')') depth--;\n    i++;\n  }\n\n  return depth === 0 ? i - 1 : -1;\n}\n\n/**\n * Check if a state key is an advanced state (starts with @)\n */\nexport function isAdvancedState(stateKey: string): boolean {\n  return stateKey.startsWith('@') || stateKey.startsWith('!@');\n}\n\n/**\n * Detect the type of advanced state from a raw state key\n */\nexport function detectAdvancedStateType(\n  stateKey: string,\n): ParsedAdvancedState['type'] {\n  // Handle negation prefix\n  const key = stateKey.startsWith('!') ? stateKey.slice(1) : stateKey;\n\n  if (key === '@starting') return 'starting';\n  if (key.startsWith('@media')) return 'media';\n  if (key.startsWith('@root(')) return 'root';\n  if (key.startsWith('@own(')) return 'own';\n  if (key.startsWith('@(')) return 'container';\n  if (isPredefinedStateRef(key)) return 'predefined';\n  return 'modifier';\n}\n"],"mappings":"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"}

package/dist/static/index.d.ts

@@ -0,0 +1,5 @@
+import { Styles } from "../styles/types.js";
+import { mergeStyles } from "../utils/merge-styles.js";
+import { StaticStyle, createStaticStyle, isStaticStyle } from "./types.js";
+import { tastyStatic } from "./tastyStatic.js";
+export { type StaticStyle, type Styles, createStaticStyle, isStaticStyle, mergeStyles, tastyStatic };

package/dist/static/index.js

@@ -0,0 +1,5 @@
+import { mergeStyles } from "../utils/merge-styles.js";
+import { createStaticStyle, isStaticStyle } from "./types.js";
+import { tastyStatic } from "./tastyStatic.js";
+
+export { createStaticStyle, isStaticStyle, mergeStyles, tastyStatic };

package/dist/static/tastyStatic.d.ts

@@ -0,0 +1,46 @@
+import { Styles } from "../styles/types.js";
+import { StaticStyle } from "./types.js";
+
+//#region src/static/tastyStatic.d.ts
+/**
+ * Generate styles and return a StaticStyle object.
+ * The object has `className`, `styles`, and `toString()`.
+ *
+ * @example
+ * ```typescript
+ * const button = tastyStatic({
+ *   fill: '#blue',
+ *   padding: '2x',
+ * });
+ * // After build: { className: 'ts3f2a1b', styles: {...}, toString() }
+ *
+ * <div className={button} />  // Works via toString()
+ * ```
+ */
+declare function tastyStatic(styles: Styles): StaticStyle;
+/**
+ * Extend an existing StaticStyle with additional styles.
+ * Uses mergeStyles() internally for proper nested selector handling.
+ *
+ * @example
+ * ```typescript
+ * const button = tastyStatic({ fill: '#blue' });
+ * const primary = tastyStatic(button, { fill: '#purple' });
+ * // After build: { className: 'ts8c4d2e', styles: {...merged...}, toString() }
+ * ```
+ */
+declare function tastyStatic(base: StaticStyle, styles: Styles): StaticStyle;
+/**
+ * Generate styles for a specific CSS selector.
+ * The call is completely removed after build transformation.
+ *
+ * @example
+ * ```typescript
+ * tastyStatic('.heading', { preset: 'h1', color: '#primary' });
+ * // After build: (removed)
+ * ```
+ */
+declare function tastyStatic(selector: string, styles: Styles): void;
+//#endregion
+export { tastyStatic };
+//# sourceMappingURL=tastyStatic.d.ts.map

package/dist/static/tastyStatic.js

@@ -0,0 +1,31 @@
+import { mergeStyles } from "../utils/merge-styles.js";
+import { createStaticStyle, isStaticStyle } from "./types.js";
+
+//#region src/static/tastyStatic.ts
+/**
+* Build-time only function for zero-runtime static site generation.
+*
+* This function is transformed by the Babel plugin:
+* - `tastyStatic(styles)` → StaticStyle object with className
+* - `tastyStatic(base, styles)` → StaticStyle object with merged styles
+* - `tastyStatic(selector, styles)` → removed entirely
+*
+* At runtime (during development/build), this function returns a placeholder.
+* In production, all calls are replaced/removed by the build plugin.
+*/
+function tastyStatic(stylesOrBaseOrSelector, styles) {
+	if (typeof stylesOrBaseOrSelector === "string") {
+		console.warn(`[tasty] tastyStatic('${stylesOrBaseOrSelector}', styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.`);
+		return;
+	}
+	if (isStaticStyle(stylesOrBaseOrSelector)) {
+		console.warn("[tasty] tastyStatic(base, styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.");
+		return createStaticStyle("__TASTY_STATIC_NOT_TRANSFORMED__", mergeStyles(stylesOrBaseOrSelector.styles, styles || {}));
+	}
+	console.warn("[tasty] tastyStatic(styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.");
+	return createStaticStyle("__TASTY_STATIC_NOT_TRANSFORMED__", stylesOrBaseOrSelector);
+}
+
+//#endregion
+export { tastyStatic };
+//# sourceMappingURL=tastyStatic.js.map

package/dist/static/tastyStatic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tastyStatic.js","names":[],"sources":["../../src/static/tastyStatic.ts"],"sourcesContent":["import type { Styles } from '../styles/types';\nimport { mergeStyles } from '../utils/merge-styles';\n\nimport type { StaticStyle } from './types';\nimport { createStaticStyle, isStaticStyle } from './types';\n\n/**\n * Generate styles and return a StaticStyle object.\n * The object has `className`, `styles`, and `toString()`.\n *\n * @example\n * ```typescript\n * const button = tastyStatic({\n *   fill: '#blue',\n *   padding: '2x',\n * });\n * // After build: { className: 'ts3f2a1b', styles: {...}, toString() }\n *\n * <div className={button} />  // Works via toString()\n * ```\n */\nexport function tastyStatic(styles: Styles): StaticStyle;\n\n/**\n * Extend an existing StaticStyle with additional styles.\n * Uses mergeStyles() internally for proper nested selector handling.\n *\n * @example\n * ```typescript\n * const button = tastyStatic({ fill: '#blue' });\n * const primary = tastyStatic(button, { fill: '#purple' });\n * // After build: { className: 'ts8c4d2e', styles: {...merged...}, toString() }\n * ```\n */\nexport function tastyStatic(base: StaticStyle, styles: Styles): StaticStyle;\n\n/**\n * Generate styles for a specific CSS selector.\n * The call is completely removed after build transformation.\n *\n * @example\n * ```typescript\n * tastyStatic('.heading', { preset: 'h1', color: '#primary' });\n * // After build: (removed)\n * ```\n */\nexport function tastyStatic(selector: string, styles: Styles): void;\n\n/**\n * Build-time only function for zero-runtime static site generation.\n *\n * This function is transformed by the Babel plugin:\n * - `tastyStatic(styles)` → StaticStyle object with className\n * - `tastyStatic(base, styles)` → StaticStyle object with merged styles\n * - `tastyStatic(selector, styles)` → removed entirely\n *\n * At runtime (during development/build), this function returns a placeholder.\n * In production, all calls are replaced/removed by the build plugin.\n */\nexport function tastyStatic(\n  stylesOrBaseOrSelector: Styles | StaticStyle | string,\n  styles?: Styles,\n): StaticStyle | void {\n  // This code only executes if the Babel plugin hasn't processed the file yet.\n  // In a properly configured build, this function is never called at runtime.\n\n  if (typeof stylesOrBaseOrSelector === 'string') {\n    // Selector mode: tastyStatic(selector, styles)\n    // The plugin will remove this call entirely\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        `[tasty] tastyStatic('${stylesOrBaseOrSelector}', styles) was called at runtime. ` +\n          'This indicates the Babel plugin is not configured. ' +\n          'Add @tenphi/tasty/babel-plugin to your Babel config.',\n      );\n    }\n    return; // void\n  }\n\n  if (isStaticStyle(stylesOrBaseOrSelector)) {\n    // Extension mode: tastyStatic(base, styles)\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        '[tasty] tastyStatic(base, styles) was called at runtime. ' +\n          'This indicates the Babel plugin is not configured. ' +\n          'Add @tenphi/tasty/babel-plugin to your Babel config.',\n      );\n    }\n    // Merge styles for dev mode preview (won't have real classNames)\n    const mergedStyles = mergeStyles(\n      stylesOrBaseOrSelector.styles,\n      styles || {},\n    );\n    return createStaticStyle('__TASTY_STATIC_NOT_TRANSFORMED__', mergedStyles);\n  }\n\n  // Styles mode: tastyStatic(styles)\n  if (process.env.NODE_ENV !== 'production') {\n    console.warn(\n      '[tasty] tastyStatic(styles) was called at runtime. ' +\n        'This indicates the Babel plugin is not configured. ' +\n        'Add @tenphi/tasty/babel-plugin to your Babel config.',\n    );\n  }\n\n  // Return placeholder - styles won't be applied without the plugin\n  return createStaticStyle(\n    '__TASTY_STATIC_NOT_TRANSFORMED__',\n    stylesOrBaseOrSelector,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;AA2DA,SAAgB,YACd,wBACA,QACoB;AAIpB,KAAI,OAAO,2BAA2B,UAAU;AAI5C,UAAQ,KACN,wBAAwB,uBAAuB,2IAGhD;AAEH;;AAGF,KAAI,cAAc,uBAAuB,EAAE;AAGvC,UAAQ,KACN,mKAGD;AAOH,SAAO,kBAAkB,oCAJJ,YACnB,uBAAuB,QACvB,UAAU,EAAE,CACb,CACyE;;AAK1E,SAAQ,KACN,6JAGD;AAIH,QAAO,kBACL,oCACA,uBACD"}

package/dist/static/types.d.ts

@@ -0,0 +1,49 @@
+import { Styles } from "../styles/types.js";
+
+//#region src/static/types.d.ts
+/**
+ * Static style definition returned by tastyStatic().
+ *
+ * Supports both explicit className access and implicit string coercion via toString().
+ *
+ * @example
+ * ```typescript
+ * const button = tastyStatic({ fill: '#blue' });
+ *
+ * // Both work in JSX:
+ * <div className={button} />           // Uses toString()
+ * <div className={button.className} /> // Explicit
+ *
+ * // Extension:
+ * const primary = tastyStatic(button, { fill: '#purple' });
+ * ```
+ */
+interface StaticStyle {
+  /**
+   * Generated className(s) for use in JSX.
+   * May contain multiple space-separated class names due to chunking.
+   */
+  className: string;
+  /**
+   * The original (or merged) styles object.
+   * Available for extension via tastyStatic(base, overrides).
+   */
+  styles: Styles;
+  /**
+   * Returns className for implicit string coercion.
+   * Enables `<div className={button} />` syntax.
+   */
+  toString(): string;
+}
+/**
+ * Create a StaticStyle object.
+ * Used internally by the Babel plugin to generate output.
+ */
+declare function createStaticStyle(className: string, styles: Styles): StaticStyle;
+/**
+ * Type guard to check if a value is a StaticStyle object.
+ */
+declare function isStaticStyle(value: unknown): value is StaticStyle;
+//#endregion
+export { StaticStyle, createStaticStyle, isStaticStyle };
+//# sourceMappingURL=types.d.ts.map

package/dist/static/types.js

@@ -0,0 +1,24 @@
+//#region src/static/types.ts
+/**
+* Create a StaticStyle object.
+* Used internally by the Babel plugin to generate output.
+*/
+function createStaticStyle(className, styles) {
+	return {
+		className,
+		styles,
+		toString() {
+			return this.className;
+		}
+	};
+}
+/**
+* Type guard to check if a value is a StaticStyle object.
+*/
+function isStaticStyle(value) {
+	return typeof value === "object" && value !== null && "className" in value && "styles" in value && "toString" in value && typeof value.className === "string" && typeof value.styles === "object";
+}
+
+//#endregion
+export { createStaticStyle, isStaticStyle };
+//# sourceMappingURL=types.js.map

package/dist/static/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/static/types.ts"],"sourcesContent":["import type { Styles } from '../styles/types';\n\n/**\n * Static style definition returned by tastyStatic().\n *\n * Supports both explicit className access and implicit string coercion via toString().\n *\n * @example\n * ```typescript\n * const button = tastyStatic({ fill: '#blue' });\n *\n * // Both work in JSX:\n * <div className={button} />           // Uses toString()\n * <div className={button.className} /> // Explicit\n *\n * // Extension:\n * const primary = tastyStatic(button, { fill: '#purple' });\n * ```\n */\nexport interface StaticStyle {\n  /**\n   * Generated className(s) for use in JSX.\n   * May contain multiple space-separated class names due to chunking.\n   */\n  className: string;\n\n  /**\n   * The original (or merged) styles object.\n   * Available for extension via tastyStatic(base, overrides).\n   */\n  styles: Styles;\n\n  /**\n   * Returns className for implicit string coercion.\n   * Enables `<div className={button} />` syntax.\n   */\n  toString(): string;\n}\n\n/**\n * Create a StaticStyle object.\n * Used internally by the Babel plugin to generate output.\n */\nexport function createStaticStyle(\n  className: string,\n  styles: Styles,\n): StaticStyle {\n  return {\n    className,\n    styles,\n    toString() {\n      return this.className;\n    },\n  };\n}\n\n/**\n * Type guard to check if a value is a StaticStyle object.\n */\nexport function isStaticStyle(value: unknown): value is StaticStyle {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'className' in value &&\n    'styles' in value &&\n    'toString' in value &&\n    typeof (value as StaticStyle).className === 'string' &&\n    typeof (value as StaticStyle).styles === 'object'\n  );\n}\n"],"mappings":";;;;;AA2CA,SAAgB,kBACd,WACA,QACa;AACb,QAAO;EACL;EACA;EACA,WAAW;AACT,UAAO,KAAK;;EAEf;;;;;AAMH,SAAgB,cAAc,OAAsC;AAClE,QACE,OAAO,UAAU,YACjB,UAAU,QACV,eAAe,SACf,YAAY,SACZ,cAAc,SACd,OAAQ,MAAsB,cAAc,YAC5C,OAAQ,MAAsB,WAAW"}

package/dist/styles/align.d.ts

@@ -0,0 +1,15 @@
+//#region src/styles/align.d.ts
+declare function alignStyle({
+  align
+}: {
+  align: any;
+}): {
+  'align-items': string;
+  'align-content': string;
+} | undefined;
+declare namespace alignStyle {
+  var __lookupStyles: string[];
+}
+//#endregion
+export { alignStyle };
+//# sourceMappingURL=align.d.ts.map

package/dist/styles/align.js

@@ -0,0 +1,14 @@
+//#region src/styles/align.ts
+function alignStyle({ align }) {
+	if (typeof align !== "string") return;
+	if (!align) return;
+	return {
+		"align-items": align,
+		"align-content": align
+	};
+}
+alignStyle.__lookupStyles = ["align"];
+
+//#endregion
+export { alignStyle };
+//# sourceMappingURL=align.js.map

package/dist/styles/align.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"align.js","names":[],"sources":["../../src/styles/align.ts"],"sourcesContent":["export function alignStyle({ align }) {\n  if (typeof align !== 'string') return;\n\n  if (!align) return;\n\n  return {\n    'align-items': align,\n    'align-content': align,\n  };\n}\n\nalignStyle.__lookupStyles = ['align'];\n"],"mappings":";AAAA,SAAgB,WAAW,EAAE,SAAS;AACpC,KAAI,OAAO,UAAU,SAAU;AAE/B,KAAI,CAAC,MAAO;AAEZ,QAAO;EACL,eAAe;EACf,iBAAiB;EAClB;;AAGH,WAAW,iBAAiB,CAAC,QAAQ"}

package/dist/styles/align.mjs

@@ -0,0 +1,14 @@
+//#region src/styles/align.ts
+function alignStyle({ align }) {
+	if (typeof align !== "string") return;
+	if (!align) return;
+	return {
+		"align-items": align,
+		"align-content": align
+	};
+}
+alignStyle.__lookupStyles = ["align"];
+
+//#endregion
+export { alignStyle };
+//# sourceMappingURL=align.mjs.map

package/dist/styles/align.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"align.mjs","names":[],"sources":["../../src/styles/align.ts"],"sourcesContent":["export function alignStyle({ align }) {\n  if (typeof align !== 'string') return;\n\n  if (!align) return;\n\n  return {\n    'align-items': align,\n    'align-content': align,\n  };\n}\n\nalignStyle.__lookupStyles = ['align'];\n"],"mappings":";AAAA,SAAgB,WAAW,EAAE,SAAS;AACpC,KAAI,OAAO,UAAU,SAAU;AAE/B,KAAI,CAAC,MAAO;AAEZ,QAAO;EACL,eAAe;EACf,iBAAiB;EAClB;;AAGH,WAAW,iBAAiB,CAAC,QAAQ"}

package/dist/styles/border.d.ts

@@ -0,0 +1,25 @@
+//#region src/styles/border.d.ts
+/**
+ * Border style handler with multi-group support.
+ *
+ * Single group (backward compatible):
+ * - `border="1bw solid #red"` - all sides
+ * - `border="1bw solid #red top left"` - only top and left
+ *
+ * Multi-group (new):
+ * - `border="1bw #red, 2bw #blue top"` - all sides red 1bw, then top overridden to blue 2bw
+ * - `border="1bw, dashed top bottom, #purple left right"` - base 1bw, dashed on top/bottom, purple on left/right
+ *
+ * Later groups override earlier groups for conflicting directions.
+ */
+declare function borderStyle({
+  border
+}: {
+  border: any;
+}): Record<string, string> | undefined;
+declare namespace borderStyle {
+  var __lookupStyles: string[];
+}
+//#endregion
+export { borderStyle };
+//# sourceMappingURL=border.d.ts.map