@tenphi/eslint-plugin-tasty 0.6.4 → 0.7.0

package/README.md

@@ -79,7 +79,7 @@ export default {
 | `tasty/valid-color-token` | error | Invalid color token syntax or unknown tokens |
 | `tasty/valid-custom-unit` | error | Unknown custom units |
 | `tasty/valid-boolean-property` | error | `true` on properties that don't support it |
-| `tasty/valid-state-key` | error | Invalid state key syntax in style mappings |
+| `tasty/valid-state-key` | error | Invalid state key syntax in style mappings (including misuse of the `_` fallback floor) |
 | `tasty/valid-styles-structure` | error | Invalid styles object structure |
 | `tasty/no-nested-state-map` | error | Nested state maps (not supported) |
 | `tasty/no-important` | error | `!important` usage (breaks tasty specificity) |
@@ -92,7 +92,7 @@ export default {
 | `tasty/no-nested-selector` | warn | `&`-prefixed nested selectors (use sub-elements) |
 | `tasty/static-no-dynamic-values` | error | Dynamic values in `tastyStatic()` |
 | `tasty/static-valid-selector` | error | Invalid selector in `tastyStatic(selector, ...)` |
-| `tasty/require-default-state` | error | Missing default (`''`) key in state mappings (skipped for extending calls) |
+| `tasty/require-default-state` | error | Missing default (`''`) or fallback floor (`_`) key in state mappings (skipped for extending calls) |
 
 ### Strict (includes all recommended rules)
 

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../src/context.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport type { RuleContext } from '@typescript-eslint/utils/ts-eslint';\nimport type { ResolvedConfig } from './types.js';\nimport { loadConfig } from './config.js';\nimport { DEFAULT_IMPORT_SOURCES } from './constants.js';\nimport { getKeyName } from './utils.js';\n\n/**\n * AST selectors that match ObjectExpressions in all known tasty style contexts:\n * call sites, variable declarations, satisfies/as expressions.\n */\nexport const STYLE_OBJECT_SELECTORS = [\n  'CallExpression ObjectExpression',\n  'VariableDeclarator > ObjectExpression',\n  'VariableDeclarator > TSSatisfiesExpression > ObjectExpression',\n  'VariableDeclarator > TSAsExpression > ObjectExpression',\n] as const;\n\n/**\n * Creates a record of ESLint listeners that all point to the same handler,\n * one entry per style-object AST selector.\n */\nexport function styleObjectListeners(\n  handler: (node: TSESTree.ObjectExpression) => void,\n): Record<string, (node: TSESTree.ObjectExpression) => void> {\n  const listeners: Record<string, (node: TSESTree.ObjectExpression) => void> =\n    {};\n  for (const selector of STYLE_OBJECT_SELECTORS) {\n    listeners[selector] = handler;\n  }\n  return listeners;\n}\n\nexport interface TastyImport {\n  localName: string;\n  importedName: string;\n  source: string;\n}\n\nconst TASTY_FUNCTION_NAMES = new Set([\n  'tasty',\n  'tastyStatic',\n  'useStyles',\n  'useGlobalStyles',\n  'configure',\n]);\n\n/**\n * Context tracker for a single file's lint pass.\n * Tracks which imports come from tasty and provides\n * helpers to determine if a node is in a tasty style context.\n */\nexport class TastyContext {\n  readonly config: ResolvedConfig;\n  private imports = new Map<string, TastyImport>();\n  private importSources: Set<string>;\n\n  constructor(\n    private context: RuleContext<string, unknown[]>,\n    config?: ResolvedConfig,\n  ) {\n    this.config = config ?? loadConfig(context.filename);\n    this.importSources = new Set([\n      ...DEFAULT_IMPORT_SOURCES,\n      ...this.config.importSources,\n    ]);\n  }\n\n  trackImport(node: TSESTree.ImportDeclaration): void {\n    const source = node.source.value;\n    if (!this.importSources.has(source)) return;\n\n    for (const specifier of node.specifiers) {\n      if (specifier.type === 'ImportSpecifier') {\n        const importedName =\n          specifier.imported.type === 'Identifier'\n            ? specifier.imported.name\n            : specifier.imported.value;\n        if (TASTY_FUNCTION_NAMES.has(importedName)) {\n          this.imports.set(specifier.local.name, {\n            localName: specifier.local.name,\n            importedName,\n            source,\n          });\n        }\n      }\n    }\n  }\n\n  getImport(localName: string): TastyImport | undefined {\n    return this.imports.get(localName);\n  }\n\n  isTastyCall(node: TSESTree.CallExpression): TastyImport | undefined {\n    if (node.callee.type !== 'Identifier') return undefined;\n    return this.imports.get(node.callee.name);\n  }\n\n  /**\n   * Determines whether an object expression is a tasty style object\n   * by walking up the AST to find a recognized call expression.\n   */\n  isStyleObject(node: TSESTree.ObjectExpression): boolean {\n    return this.getStyleContext(node) !== null;\n  }\n\n  getStyleContext(node: TSESTree.Node): {\n    type: 'tasty' | 'tastyStatic' | 'useStyles' | 'useGlobalStyles';\n    isStaticCall: boolean;\n    isSelectorMode: boolean;\n    isExtending: boolean;\n  } | null {\n    // Sub-element objects inherit their parent style object's context\n    if (node.type === 'ObjectExpression') {\n      const parent = node.parent;\n      if (parent?.type === 'Property' && !parent.computed) {\n        const key = getKeyName(parent.key);\n        if (key && /^[A-Z]/.test(key)) {\n          const grandparent = parent.parent;\n          if (grandparent?.type === 'ObjectExpression') {\n            return this.getStyleContext(grandparent);\n          }\n        }\n      }\n    }\n\n    let current: TSESTree.Node | undefined = node;\n\n    while (current) {\n      if (current.type === 'CallExpression') {\n        const imp = this.isTastyCall(current);\n        if (!imp) return null;\n\n        const name = imp.importedName;\n        const isStaticCall = name === 'tastyStatic';\n\n        if (name === 'tasty') {\n          return this.getTastyCallContext(current, node);\n        }\n\n        if (name === 'tastyStatic') {\n          return this.getTastyStaticCallContext(current, node);\n        }\n\n        if (name === 'useStyles') {\n          if (current.arguments[0] === node) {\n            return {\n              type: 'useStyles',\n              isStaticCall: false,\n              isSelectorMode: false,\n              isExtending: false,\n            };\n          }\n        }\n\n        if (name === 'useGlobalStyles') {\n          if (current.arguments[1] === node) {\n            return {\n              type: 'useGlobalStyles',\n              isStaticCall,\n              isSelectorMode: true,\n              isExtending: false,\n            };\n          }\n        }\n\n        return null;\n      }\n\n      if (this.isStyleVariableDeclaration(current, node)) {\n        return {\n          type: 'tasty',\n          isStaticCall: false,\n          isSelectorMode: false,\n          isExtending: false,\n        };\n      }\n\n      current = current.parent;\n    }\n\n    return null;\n  }\n\n  private isStyleVariableDeclaration(\n    current: TSESTree.Node,\n    targetNode: TSESTree.Node,\n  ): boolean {\n    if (\n      current.type !== 'VariableDeclarator' ||\n      current.id.type !== 'Identifier'\n    ) {\n      return false;\n    }\n\n    let init: TSESTree.Node | null | undefined = current.init;\n    while (\n      init?.type === 'TSAsExpression' ||\n      init?.type === 'TSSatisfiesExpression' ||\n      init?.type === 'TSTypeAssertion' ||\n      init?.type === 'TSNonNullExpression'\n    ) {\n      init = (init as TSESTree.TSAsExpression).expression;\n    }\n\n    if (init !== targetNode) return false;\n\n    const name = current.id.name;\n\n    if (/^[A-Z][A-Z0-9_]*$/.test(name)) return false;\n\n    if (/styles?$/i.test(name)) return true;\n\n    if (this.hasStylesTypeAnnotation(current)) return true;\n\n    return false;\n  }\n\n  private hasStylesTypeAnnotation(node: TSESTree.VariableDeclarator): boolean {\n    const annotation = node.id.typeAnnotation?.typeAnnotation;\n    if (!annotation) return false;\n\n    if (\n      annotation.type === 'TSTypeReference' &&\n      annotation.typeName.type === 'Identifier'\n    ) {\n      return /^Styles$/i.test(annotation.typeName.name);\n    }\n\n    return false;\n  }\n\n  private getTastyCallContext(\n    call: TSESTree.CallExpression,\n    targetNode: TSESTree.Node,\n  ) {\n    const args = call.arguments;\n\n    // tasty({ styles: { ... } }) or tasty(Component, { styles: { ... } })\n    const optionsArg =\n      args.length >= 2 && args[0].type !== 'ObjectExpression'\n        ? args[1]\n        : args[0];\n\n    if (\n      optionsArg?.type === 'ObjectExpression' &&\n      this.isInsideStylesProperty(optionsArg, targetNode)\n    ) {\n      return {\n        type: 'tasty' as const,\n        isStaticCall: false,\n        isSelectorMode: false,\n        isExtending: args.length >= 2 && args[0].type !== 'ObjectExpression',\n      };\n    }\n\n    // Check if inside variants\n    if (\n      optionsArg?.type === 'ObjectExpression' &&\n      this.isInsideVariantsProperty(optionsArg, targetNode)\n    ) {\n      return {\n        type: 'tasty' as const,\n        isStaticCall: false,\n        isSelectorMode: false,\n        isExtending: false,\n      };\n    }\n\n    return null;\n  }\n\n  private getTastyStaticCallContext(\n    call: TSESTree.CallExpression,\n    targetNode: TSESTree.Node,\n  ) {\n    const args = call.arguments;\n\n    // tastyStatic({ ... })\n    if (args.length === 1 && args[0] === targetNode) {\n      return {\n        type: 'tastyStatic' as const,\n        isStaticCall: true,\n        isSelectorMode: false,\n        isExtending: false,\n      };\n    }\n\n    // tastyStatic(base, { ... }) or tastyStatic('selector', { ... })\n    if (args.length === 2 && args[1] === targetNode) {\n      const isSelectorMode = args[0].type === 'Literal';\n      return {\n        type: 'tastyStatic' as const,\n        isStaticCall: true,\n        isSelectorMode,\n        isExtending: !isSelectorMode,\n      };\n    }\n\n    return null;\n  }\n\n  private isInsideStylesProperty(\n    optionsObj: TSESTree.ObjectExpression,\n    targetNode: TSESTree.Node,\n  ): boolean {\n    for (const prop of optionsObj.properties) {\n      if (\n        prop.type === 'Property' &&\n        prop.key.type === 'Identifier' &&\n        prop.key.name === 'styles' &&\n        prop.value === targetNode\n      ) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  private isInsideVariantsProperty(\n    optionsObj: TSESTree.ObjectExpression,\n    targetNode: TSESTree.Node,\n  ): boolean {\n    for (const prop of optionsObj.properties) {\n      if (\n        prop.type === 'Property' &&\n        prop.key.type === 'Identifier' &&\n        prop.key.name === 'variants' &&\n        prop.value.type === 'ObjectExpression'\n      ) {\n        for (const variantProp of prop.value.properties) {\n          if (\n            variantProp.type === 'Property' &&\n            variantProp.value === targetNode\n          ) {\n            return true;\n          }\n        }\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Checks if a property value node is a state mapping object\n   * (i.e., an object where keys are state expressions and values are style values).\n   */\n  isStateMap(\n    node: TSESTree.ObjectExpression,\n    parentProperty: TSESTree.Property,\n  ): boolean {\n    const keyName = getKeyName(parentProperty.key);\n    if (keyName === null) return false;\n\n    // If the key starts with uppercase, it's a sub-element, not a state map\n    if (/^[A-Z]/.test(keyName)) return false;\n\n    // Special keys are not state maps\n    if (keyName === '@keyframes' || keyName === '@properties') return false;\n\n    // If the object has keys that look like state expressions, it's a state map\n    return node.properties.some((prop) => {\n      if (prop.type !== 'Property') return false;\n      if (prop.key.type === 'Literal' && prop.key.value === '') return true;\n      if (prop.key.type === 'Identifier') return true;\n      if (prop.key.type === 'Literal' && typeof prop.key.value === 'string') {\n        return true;\n      }\n      return false;\n    });\n  }\n\n  /**\n   * Checks if a key represents a sub-element (starts with uppercase).\n   */\n  isSubElementKey(key: string): boolean {\n    return /^[A-Z]/.test(key);\n  }\n\n  /**\n   * Checks if a key represents a nested selector (starts with &).\n   */\n  isNestedSelectorKey(key: string): boolean {\n    return key.startsWith('&');\n  }\n\n  /**\n   * Checks if a key is a custom CSS property definition ($name or $$name).\n   */\n  isCustomPropertyKey(key: string): boolean {\n    return key.startsWith('$');\n  }\n\n  /**\n   * Checks if a key is a color token definition (#name or ##name).\n   */\n  isColorTokenKey(key: string): boolean {\n    return key.startsWith('#');\n  }\n\n  /**\n   * Checks if a key is a special @ property (@keyframes, @properties).\n   */\n  isSpecialKey(key: string): boolean {\n    return key.startsWith('@');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"context.js","names":[],"sources":["../src/context.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport type { RuleContext } from '@typescript-eslint/utils/ts-eslint';\nimport type { ResolvedConfig } from './types.js';\nimport { loadConfig } from './config.js';\nimport { DEFAULT_IMPORT_SOURCES } from './constants.js';\nimport { getKeyName } from './utils.js';\n\n/**\n * AST selectors that match ObjectExpressions in all known tasty style contexts:\n * call sites, variable declarations, satisfies/as expressions.\n */\nexport const STYLE_OBJECT_SELECTORS = [\n  'CallExpression ObjectExpression',\n  'VariableDeclarator > ObjectExpression',\n  'VariableDeclarator > TSSatisfiesExpression > ObjectExpression',\n  'VariableDeclarator > TSAsExpression > ObjectExpression',\n] as const;\n\n/**\n * Creates a record of ESLint listeners that all point to the same handler,\n * one entry per style-object AST selector.\n */\nexport function styleObjectListeners(\n  handler: (node: TSESTree.ObjectExpression) => void,\n): Record<string, (node: TSESTree.ObjectExpression) => void> {\n  const listeners: Record<string, (node: TSESTree.ObjectExpression) => void> =\n    {};\n  for (const selector of STYLE_OBJECT_SELECTORS) {\n    listeners[selector] = handler;\n  }\n  return listeners;\n}\n\nexport interface TastyImport {\n  localName: string;\n  importedName: string;\n  source: string;\n}\n\nconst TASTY_FUNCTION_NAMES = new Set([\n  'tasty',\n  'tastyStatic',\n  'useStyles',\n  'useGlobalStyles',\n  'configure',\n]);\n\n/**\n * Context tracker for a single file's lint pass.\n * Tracks which imports come from tasty and provides\n * helpers to determine if a node is in a tasty style context.\n */\nexport class TastyContext {\n  readonly config: ResolvedConfig;\n  private imports = new Map<string, TastyImport>();\n  private importSources: Set<string>;\n\n  constructor(\n    private context: RuleContext<string, unknown[]>,\n    config?: ResolvedConfig,\n  ) {\n    this.config = config ?? loadConfig(context.filename);\n    this.importSources = new Set([\n      ...DEFAULT_IMPORT_SOURCES,\n      ...this.config.importSources,\n    ]);\n  }\n\n  trackImport(node: TSESTree.ImportDeclaration): void {\n    const source = node.source.value;\n    if (!this.importSources.has(source)) return;\n\n    for (const specifier of node.specifiers) {\n      if (specifier.type === 'ImportSpecifier') {\n        const importedName =\n          specifier.imported.type === 'Identifier'\n            ? specifier.imported.name\n            : specifier.imported.value;\n        if (TASTY_FUNCTION_NAMES.has(importedName)) {\n          this.imports.set(specifier.local.name, {\n            localName: specifier.local.name,\n            importedName,\n            source,\n          });\n        }\n      }\n    }\n  }\n\n  getImport(localName: string): TastyImport | undefined {\n    return this.imports.get(localName);\n  }\n\n  isTastyCall(node: TSESTree.CallExpression): TastyImport | undefined {\n    if (node.callee.type !== 'Identifier') return undefined;\n    return this.imports.get(node.callee.name);\n  }\n\n  /**\n   * Determines whether an object expression is a tasty style object\n   * by walking up the AST to find a recognized call expression.\n   */\n  isStyleObject(node: TSESTree.ObjectExpression): boolean {\n    return this.getStyleContext(node) !== null;\n  }\n\n  getStyleContext(node: TSESTree.Node): {\n    type: 'tasty' | 'tastyStatic' | 'useStyles' | 'useGlobalStyles';\n    isStaticCall: boolean;\n    isSelectorMode: boolean;\n    isExtending: boolean;\n  } | null {\n    // Sub-element objects inherit their parent style object's context\n    if (node.type === 'ObjectExpression') {\n      const parent = node.parent;\n      if (parent?.type === 'Property' && !parent.computed) {\n        const key = getKeyName(parent.key);\n        if (key && /^[A-Z]/.test(key)) {\n          const grandparent = parent.parent;\n          if (grandparent?.type === 'ObjectExpression') {\n            return this.getStyleContext(grandparent);\n          }\n        }\n      }\n    }\n\n    let current: TSESTree.Node | undefined = node;\n\n    while (current) {\n      if (current.type === 'CallExpression') {\n        const imp = this.isTastyCall(current);\n        if (!imp) return null;\n\n        const name = imp.importedName;\n        const isStaticCall = name === 'tastyStatic';\n\n        if (name === 'tasty') {\n          return this.getTastyCallContext(current, node);\n        }\n\n        if (name === 'tastyStatic') {\n          return this.getTastyStaticCallContext(current, node);\n        }\n\n        if (name === 'useStyles') {\n          if (current.arguments[0] === node) {\n            return {\n              type: 'useStyles',\n              isStaticCall: false,\n              isSelectorMode: false,\n              isExtending: false,\n            };\n          }\n        }\n\n        if (name === 'useGlobalStyles') {\n          if (current.arguments[1] === node) {\n            return {\n              type: 'useGlobalStyles',\n              isStaticCall,\n              isSelectorMode: true,\n              isExtending: false,\n            };\n          }\n        }\n\n        return null;\n      }\n\n      if (this.isStyleVariableDeclaration(current, node)) {\n        return {\n          type: 'tasty',\n          isStaticCall: false,\n          isSelectorMode: false,\n          isExtending: false,\n        };\n      }\n\n      current = current.parent;\n    }\n\n    return null;\n  }\n\n  private isStyleVariableDeclaration(\n    current: TSESTree.Node,\n    targetNode: TSESTree.Node,\n  ): boolean {\n    if (\n      current.type !== 'VariableDeclarator' ||\n      current.id.type !== 'Identifier'\n    ) {\n      return false;\n    }\n\n    let init: TSESTree.Node | null | undefined = current.init;\n    while (\n      init?.type === 'TSAsExpression' ||\n      init?.type === 'TSSatisfiesExpression' ||\n      init?.type === 'TSTypeAssertion' ||\n      init?.type === 'TSNonNullExpression'\n    ) {\n      init = (init as TSESTree.TSAsExpression).expression;\n    }\n\n    if (init !== targetNode) return false;\n\n    const name = current.id.name;\n\n    if (/^[A-Z][A-Z0-9_]*$/.test(name)) return false;\n\n    if (/styles?$/i.test(name)) return true;\n\n    if (this.hasStylesTypeAnnotation(current)) return true;\n\n    return false;\n  }\n\n  private hasStylesTypeAnnotation(node: TSESTree.VariableDeclarator): boolean {\n    const annotation = node.id.typeAnnotation?.typeAnnotation;\n    if (!annotation) return false;\n\n    if (\n      annotation.type === 'TSTypeReference' &&\n      annotation.typeName.type === 'Identifier'\n    ) {\n      return /^Styles$/i.test(annotation.typeName.name);\n    }\n\n    return false;\n  }\n\n  private getTastyCallContext(\n    call: TSESTree.CallExpression,\n    targetNode: TSESTree.Node,\n  ) {\n    const args = call.arguments;\n\n    // tasty({ styles: { ... } }) or tasty(Component, { styles: { ... } })\n    const optionsArg =\n      args.length >= 2 && args[0].type !== 'ObjectExpression'\n        ? args[1]\n        : args[0];\n\n    if (\n      optionsArg?.type === 'ObjectExpression' &&\n      this.isInsideStylesProperty(optionsArg, targetNode)\n    ) {\n      return {\n        type: 'tasty' as const,\n        isStaticCall: false,\n        isSelectorMode: false,\n        isExtending: args.length >= 2 && args[0].type !== 'ObjectExpression',\n      };\n    }\n\n    // Check if inside variants\n    if (\n      optionsArg?.type === 'ObjectExpression' &&\n      this.isInsideVariantsProperty(optionsArg, targetNode)\n    ) {\n      return {\n        type: 'tasty' as const,\n        isStaticCall: false,\n        isSelectorMode: false,\n        isExtending: false,\n      };\n    }\n\n    return null;\n  }\n\n  private getTastyStaticCallContext(\n    call: TSESTree.CallExpression,\n    targetNode: TSESTree.Node,\n  ) {\n    const args = call.arguments;\n\n    // tastyStatic({ ... })\n    if (args.length === 1 && args[0] === targetNode) {\n      return {\n        type: 'tastyStatic' as const,\n        isStaticCall: true,\n        isSelectorMode: false,\n        isExtending: false,\n      };\n    }\n\n    // tastyStatic(base, { ... }) or tastyStatic('selector', { ... })\n    if (args.length === 2 && args[1] === targetNode) {\n      const isSelectorMode = args[0].type === 'Literal';\n      return {\n        type: 'tastyStatic' as const,\n        isStaticCall: true,\n        isSelectorMode,\n        isExtending: !isSelectorMode,\n      };\n    }\n\n    return null;\n  }\n\n  private isInsideStylesProperty(\n    optionsObj: TSESTree.ObjectExpression,\n    targetNode: TSESTree.Node,\n  ): boolean {\n    for (const prop of optionsObj.properties) {\n      if (\n        prop.type === 'Property' &&\n        prop.key.type === 'Identifier' &&\n        prop.key.name === 'styles' &&\n        prop.value === targetNode\n      ) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  private isInsideVariantsProperty(\n    optionsObj: TSESTree.ObjectExpression,\n    targetNode: TSESTree.Node,\n  ): boolean {\n    for (const prop of optionsObj.properties) {\n      if (\n        prop.type === 'Property' &&\n        prop.key.type === 'Identifier' &&\n        prop.key.name === 'variants' &&\n        prop.value.type === 'ObjectExpression'\n      ) {\n        for (const variantProp of prop.value.properties) {\n          if (\n            variantProp.type === 'Property' &&\n            variantProp.value === targetNode\n          ) {\n            return true;\n          }\n        }\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Checks if a property value node is a state mapping object\n   * (i.e., an object where keys are state expressions and values are style values).\n   */\n  isStateMap(\n    node: TSESTree.ObjectExpression,\n    parentProperty: TSESTree.Property,\n  ): boolean {\n    const keyName = getKeyName(parentProperty.key);\n    if (keyName === null) return false;\n\n    // If the key starts with uppercase, it's a sub-element, not a state map\n    if (/^[A-Z]/.test(keyName)) return false;\n\n    // Special keys are not state maps\n    if (keyName === '@keyframes' || keyName === '@properties') return false;\n\n    // If the object has keys that look like state expressions, it's a state map.\n    // A lone `_` (the fallback floor) or `''` (the default) is enough — both are\n    // already covered by the string-literal / identifier branches below.\n    return node.properties.some((prop) => {\n      if (prop.type !== 'Property') return false;\n      if (prop.key.type === 'Literal' && prop.key.value === '') return true;\n      if (prop.key.type === 'Identifier') return true;\n      if (prop.key.type === 'Literal' && typeof prop.key.value === 'string') {\n        return true;\n      }\n      return false;\n    });\n  }\n\n  /**\n   * Checks if a key represents a sub-element (starts with uppercase).\n   */\n  isSubElementKey(key: string): boolean {\n    return /^[A-Z]/.test(key);\n  }\n\n  /**\n   * Checks if a key represents a nested selector (starts with &).\n   */\n  isNestedSelectorKey(key: string): boolean {\n    return key.startsWith('&');\n  }\n\n  /**\n   * Checks if a key is a custom CSS property definition ($name or $$name).\n   */\n  isCustomPropertyKey(key: string): boolean {\n    return key.startsWith('$');\n  }\n\n  /**\n   * Checks if a key is a color token definition (#name or ##name).\n   */\n  isColorTokenKey(key: string): boolean {\n    return key.startsWith('#');\n  }\n\n  /**\n   * Checks if a key is a special @ property (@keyframes, @properties).\n   */\n  isSpecialKey(key: string): boolean {\n    return key.startsWith('@');\n  }\n}\n"],"mappings":";;;;;;;;;AAWA,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACD;;;;;AAMD,SAAgB,qBACd,SAC2D;CAC3D,MAAM,YACJ,EAAE;AACJ,MAAK,MAAM,YAAY,uBACrB,WAAU,YAAY;AAExB,QAAO;;AAST,MAAM,uBAAuB,IAAI,IAAI;CACnC;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;AAOF,IAAa,eAAb,MAA0B;CACxB,AAAS;CACT,AAAQ,0BAAU,IAAI,KAA0B;CAChD,AAAQ;CAER,YACE,AAAQ,SACR,QACA;EAFQ;AAGR,OAAK,SAAS,UAAU,WAAW,QAAQ,SAAS;AACpD,OAAK,gBAAgB,IAAI,IAAI,CAC3B,GAAG,wBACH,GAAG,KAAK,OAAO,cAChB,CAAC;;CAGJ,YAAY,MAAwC;EAClD,MAAM,SAAS,KAAK,OAAO;AAC3B,MAAI,CAAC,KAAK,cAAc,IAAI,OAAO,CAAE;AAErC,OAAK,MAAM,aAAa,KAAK,WAC3B,KAAI,UAAU,SAAS,mBAAmB;GACxC,MAAM,eACJ,UAAU,SAAS,SAAS,eACxB,UAAU,SAAS,OACnB,UAAU,SAAS;AACzB,OAAI,qBAAqB,IAAI,aAAa,CACxC,MAAK,QAAQ,IAAI,UAAU,MAAM,MAAM;IACrC,WAAW,UAAU,MAAM;IAC3B;IACA;IACD,CAAC;;;CAMV,UAAU,WAA4C;AACpD,SAAO,KAAK,QAAQ,IAAI,UAAU;;CAGpC,YAAY,MAAwD;AAClE,MAAI,KAAK,OAAO,SAAS,aAAc,QAAO;AAC9C,SAAO,KAAK,QAAQ,IAAI,KAAK,OAAO,KAAK;;;;;;CAO3C,cAAc,MAA0C;AACtD,SAAO,KAAK,gBAAgB,KAAK,KAAK;;CAGxC,gBAAgB,MAKP;AAEP,MAAI,KAAK,SAAS,oBAAoB;GACpC,MAAM,SAAS,KAAK;AACpB,OAAI,QAAQ,SAAS,cAAc,CAAC,OAAO,UAAU;IACnD,MAAM,MAAM,WAAW,OAAO,IAAI;AAClC,QAAI,OAAO,SAAS,KAAK,IAAI,EAAE;KAC7B,MAAM,cAAc,OAAO;AAC3B,SAAI,aAAa,SAAS,mBACxB,QAAO,KAAK,gBAAgB,YAAY;;;;EAMhD,IAAI,UAAqC;AAEzC,SAAO,SAAS;AACd,OAAI,QAAQ,SAAS,kBAAkB;IACrC,MAAM,MAAM,KAAK,YAAY,QAAQ;AACrC,QAAI,CAAC,IAAK,QAAO;IAEjB,MAAM,OAAO,IAAI;IACjB,MAAM,eAAe,SAAS;AAE9B,QAAI,SAAS,QACX,QAAO,KAAK,oBAAoB,SAAS,KAAK;AAGhD,QAAI,SAAS,cACX,QAAO,KAAK,0BAA0B,SAAS,KAAK;AAGtD,QAAI,SAAS,aACX;SAAI,QAAQ,UAAU,OAAO,KAC3B,QAAO;MACL,MAAM;MACN,cAAc;MACd,gBAAgB;MAChB,aAAa;MACd;;AAIL,QAAI,SAAS,mBACX;SAAI,QAAQ,UAAU,OAAO,KAC3B,QAAO;MACL,MAAM;MACN;MACA,gBAAgB;MAChB,aAAa;MACd;;AAIL,WAAO;;AAGT,OAAI,KAAK,2BAA2B,SAAS,KAAK,CAChD,QAAO;IACL,MAAM;IACN,cAAc;IACd,gBAAgB;IAChB,aAAa;IACd;AAGH,aAAU,QAAQ;;AAGpB,SAAO;;CAGT,AAAQ,2BACN,SACA,YACS;AACT,MACE,QAAQ,SAAS,wBACjB,QAAQ,GAAG,SAAS,aAEpB,QAAO;EAGT,IAAI,OAAyC,QAAQ;AACrD,SACE,MAAM,SAAS,oBACf,MAAM,SAAS,2BACf,MAAM,SAAS,qBACf,MAAM,SAAS,sBAEf,QAAQ,KAAiC;AAG3C,MAAI,SAAS,WAAY,QAAO;EAEhC,MAAM,OAAO,QAAQ,GAAG;AAExB,MAAI,oBAAoB,KAAK,KAAK,CAAE,QAAO;AAE3C,MAAI,YAAY,KAAK,KAAK,CAAE,QAAO;AAEnC,MAAI,KAAK,wBAAwB,QAAQ,CAAE,QAAO;AAElD,SAAO;;CAGT,AAAQ,wBAAwB,MAA4C;EAC1E,MAAM,aAAa,KAAK,GAAG,gBAAgB;AAC3C,MAAI,CAAC,WAAY,QAAO;AAExB,MACE,WAAW,SAAS,qBACpB,WAAW,SAAS,SAAS,aAE7B,QAAO,YAAY,KAAK,WAAW,SAAS,KAAK;AAGnD,SAAO;;CAGT,AAAQ,oBACN,MACA,YACA;EACA,MAAM,OAAO,KAAK;EAGlB,MAAM,aACJ,KAAK,UAAU,KAAK,KAAK,GAAG,SAAS,qBACjC,KAAK,KACL,KAAK;AAEX,MACE,YAAY,SAAS,sBACrB,KAAK,uBAAuB,YAAY,WAAW,CAEnD,QAAO;GACL,MAAM;GACN,cAAc;GACd,gBAAgB;GAChB,aAAa,KAAK,UAAU,KAAK,KAAK,GAAG,SAAS;GACnD;AAIH,MACE,YAAY,SAAS,sBACrB,KAAK,yBAAyB,YAAY,WAAW,CAErD,QAAO;GACL,MAAM;GACN,cAAc;GACd,gBAAgB;GAChB,aAAa;GACd;AAGH,SAAO;;CAGT,AAAQ,0BACN,MACA,YACA;EACA,MAAM,OAAO,KAAK;AAGlB,MAAI,KAAK,WAAW,KAAK,KAAK,OAAO,WACnC,QAAO;GACL,MAAM;GACN,cAAc;GACd,gBAAgB;GAChB,aAAa;GACd;AAIH,MAAI,KAAK,WAAW,KAAK,KAAK,OAAO,YAAY;GAC/C,MAAM,iBAAiB,KAAK,GAAG,SAAS;AACxC,UAAO;IACL,MAAM;IACN,cAAc;IACd;IACA,aAAa,CAAC;IACf;;AAGH,SAAO;;CAGT,AAAQ,uBACN,YACA,YACS;AACT,OAAK,MAAM,QAAQ,WAAW,WAC5B,KACE,KAAK,SAAS,cACd,KAAK,IAAI,SAAS,gBAClB,KAAK,IAAI,SAAS,YAClB,KAAK,UAAU,WAEf,QAAO;AAGX,SAAO;;CAGT,AAAQ,yBACN,YACA,YACS;AACT,OAAK,MAAM,QAAQ,WAAW,WAC5B,KACE,KAAK,SAAS,cACd,KAAK,IAAI,SAAS,gBAClB,KAAK,IAAI,SAAS,cAClB,KAAK,MAAM,SAAS,oBAEpB;QAAK,MAAM,eAAe,KAAK,MAAM,WACnC,KACE,YAAY,SAAS,cACrB,YAAY,UAAU,WAEtB,QAAO;;AAKf,SAAO;;;;;;CAOT,WACE,MACA,gBACS;EACT,MAAM,UAAU,WAAW,eAAe,IAAI;AAC9C,MAAI,YAAY,KAAM,QAAO;AAG7B,MAAI,SAAS,KAAK,QAAQ,CAAE,QAAO;AAGnC,MAAI,YAAY,gBAAgB,YAAY,cAAe,QAAO;AAKlE,SAAO,KAAK,WAAW,MAAM,SAAS;AACpC,OAAI,KAAK,SAAS,WAAY,QAAO;AACrC,OAAI,KAAK,IAAI,SAAS,aAAa,KAAK,IAAI,UAAU,GAAI,QAAO;AACjE,OAAI,KAAK,IAAI,SAAS,aAAc,QAAO;AAC3C,OAAI,KAAK,IAAI,SAAS,aAAa,OAAO,KAAK,IAAI,UAAU,SAC3D,QAAO;AAET,UAAO;IACP;;;;;CAMJ,gBAAgB,KAAsB;AACpC,SAAO,SAAS,KAAK,IAAI;;;;;CAM3B,oBAAoB,KAAsB;AACxC,SAAO,IAAI,WAAW,IAAI;;;;;CAM5B,oBAAoB,KAAsB;AACxC,SAAO,IAAI,WAAW,IAAI;;;;;CAM5B,gBAAgB,KAAsB;AACpC,SAAO,IAAI,WAAW,IAAI;;;;;CAM5B,aAAa,KAAsB;AACjC,SAAO,IAAI,WAAW,IAAI"}

package/dist/parsers/state-key-parser.js

@@ -469,10 +469,35 @@ function parseStateKey(stateKey, opts = {}) {
 		hasOwn: false,
 		referencedAliases: []
 	};
-	const { tokens, errors: tokenErrors } = tokenize(stateKey.trim());
+	const trimmed = stateKey.trim();
+	if (trimmed === "_") return {
+		errors: [],
+		hasOwn: false,
+		referencedAliases: []
+	};
+	if (isMisusedFallbackKey(trimmed)) return {
+		errors: [{
+			message: "The fallback floor \"_\" cannot be combined with other state logic. Use \"_\" on its own as a map-wide fallback floor.",
+			offset: 0,
+			length: stateKey.length
+		}],
+		hasOwn: false,
+		referencedAliases: []
+	};
+	const { tokens, errors: tokenErrors } = tokenize(trimmed);
 	return new StateKeyValidator(tokens, tokenErrors, opts).validate();
 }
 /**
+* Detect a misused standalone `_` fallback key: a key that is not exactly
+* `_` but contains `_` as a standalone atom among state-logic operators
+* (`&`, `|`, `^`, `,`) or grouping parens. A `_` embedded in a longer token
+* (e.g. a modifier named `_private`) is not a misuse.
+*/
+function isMisusedFallbackKey(stateKey) {
+	if (stateKey === "_" || !stateKey.includes("_")) return false;
+	return /(?:^|[\s&|^,(])_(?:[\s&|^,)]|$)/.test(stateKey);
+}
+/**
 * Validate a state definition value (the RHS of a state alias).
 * State definitions should be valid state expressions like
 * '@media(w < 768px)', '@root(theme=dark)', etc.

package/dist/parsers/state-key-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-key-parser.js","names":[],"sources":["../../src/parsers/state-key-parser.ts"],"sourcesContent":["import { KNOWN_PSEUDO_CLASSES } from '../constants.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface StateKeyError {\n  message: string;\n  offset: number;\n  length: number;\n}\n\nexport interface StateKeyResult {\n  errors: StateKeyError[];\n  hasOwn: boolean;\n  referencedAliases: string[];\n}\n\nexport interface StateKeyParserOptions {\n  knownAliases?: string[];\n}\n\n// ============================================================================\n// Tokenizer\n// ============================================================================\n\ntype TokenType = 'AND' | 'OR' | 'NOT' | 'XOR' | 'LPAREN' | 'RPAREN' | 'STATE';\n\ninterface Token {\n  type: TokenType;\n  value: string;\n  offset: number;\n  length: number;\n}\n\n/**\n * Pattern for tokenizing state notation.\n * Matches operators, parentheses, @-prefixed states, value mods, boolean mods,\n * pseudo-classes with functions (including :is/:has/:not/:where with nesting),\n * class selectors, and attribute selectors.\n */\nconst STATE_TOKEN_PATTERN =\n  /([&|!^])|([()])|(@media:[a-z]+)|(@media\\([^)]*\\))|(@supports\\([^()]*(?:\\([^)]*\\))?[^)]*\\))|(@root\\([^()]*(?:\\([^()]*(?:\\([^)]*\\))?[^)]*\\))*[^)]*\\))|(@parent\\([^()]*(?:\\([^()]*(?:\\([^)]*\\))?[^)]*\\))*[^)]*\\))|(@own\\([^()]*(?:\\([^()]*(?:\\([^)]*\\))?[^)]*\\))*[^)]*\\))|(@\\([^()]*(?:\\([^)]*\\))?[^)]*\\))|(@starting)|(@[A-Za-z][A-Za-z0-9-]*)|([a-z][a-z0-9-]*(?:\\^=|\\$=|\\*=|=)(?:\"[^\"]*\"|'[^']*'|[^\\s&|!^()]+))|([a-z][a-z0-9-]+)|(:(?:is|has|not|where)\\([^()]*(?:\\([^()]*(?:\\([^)]*\\))?[^)]*\\))*[^)]*\\))|(:[-a-z][a-z0-9-]*(?:\\([^)]+\\))?)|(\\.[a-z][a-z0-9-]+)|(\\[[^\\]]+\\])/gi;\n\nfunction tokenize(stateKey: string): {\n  tokens: Token[];\n  errors: StateKeyError[];\n} {\n  const tokens: Token[] = [];\n  const errors: StateKeyError[] = [];\n\n  // Replace commas with | outside of parentheses\n  const normalized = replaceCommasOutsideParens(stateKey);\n\n  const covered = new Set<number>();\n\n  STATE_TOKEN_PATTERN.lastIndex = 0;\n  let match: RegExpExecArray | null;\n  while ((match = STATE_TOKEN_PATTERN.exec(normalized)) !== null) {\n    const fullMatch = match[0];\n    const offset = match.index;\n\n    for (let i = offset; i < offset + fullMatch.length; i++) {\n      covered.add(i);\n    }\n\n    if (match[1]) {\n      switch (fullMatch) {\n        case '&':\n          tokens.push({ type: 'AND', value: '&', offset, length: 1 });\n          break;\n        case '|':\n          tokens.push({ type: 'OR', value: '|', offset, length: 1 });\n          break;\n        case '!':\n          tokens.push({ type: 'NOT', value: '!', offset, length: 1 });\n          break;\n        case '^':\n          tokens.push({ type: 'XOR', value: '^', offset, length: 1 });\n          break;\n      }\n    } else if (match[2]) {\n      if (fullMatch === '(') {\n        tokens.push({ type: 'LPAREN', value: '(', offset, length: 1 });\n      } else {\n        tokens.push({ type: 'RPAREN', value: ')', offset, length: 1 });\n      }\n    } else {\n      tokens.push({\n        type: 'STATE',\n        value: fullMatch,\n        offset,\n        length: fullMatch.length,\n      });\n    }\n  }\n\n  // Check for uncovered characters (unrecognized tokens)\n  const uncovered: { ch: string; pos: number }[] = [];\n  for (let i = 0; i < stateKey.length; i++) {\n    const ch = stateKey[i];\n    if (ch === ' ' || ch === '\\t' || ch === ',') continue;\n    if (!covered.has(i)) {\n      uncovered.push({ ch, pos: i });\n    }\n  }\n\n  if (uncovered.length > 0) {\n    const chars = [...new Set(uncovered.map((u) => u.ch))].join('');\n    errors.push({\n      message: `Unrecognized characters '${chars}' in state key '${stateKey}'.`,\n      offset: uncovered[0].pos,\n      length: 1,\n    });\n  }\n\n  return { tokens, errors };\n}\n\nfunction replaceCommasOutsideParens(str: string): string {\n  let result = '';\n  let depth = 0;\n\n  for (const char of str) {\n    if (char === '(') {\n      depth++;\n      result += char;\n    } else if (char === ')') {\n      depth--;\n      result += char;\n    } else if (char === ',' && depth === 0) {\n      result += '|';\n    } else {\n      result += char;\n    }\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Validator\n// ============================================================================\n\nconst MAX_XOR_CHAIN_LENGTH = 4;\n\nconst DIMENSION_SHORTHANDS = new Set(['w', 'h', 'is', 'bs']);\nconst DIMENSION_FULL = new Set([\n  'width',\n  'height',\n  'inline-size',\n  'block-size',\n]);\n\nclass StateKeyValidator {\n  private errors: StateKeyError[] = [];\n  private hasOwn = false;\n  private referencedAliases: string[] = [];\n  private tokens: Token[];\n  private pos = 0;\n  private opts: StateKeyParserOptions;\n  private insideOwn = false;\n\n  constructor(\n    tokens: Token[],\n    tokenErrors: StateKeyError[],\n    opts: StateKeyParserOptions,\n  ) {\n    this.tokens = tokens;\n    this.errors = [...tokenErrors];\n    this.opts = opts;\n  }\n\n  validate(): StateKeyResult {\n    if (this.tokens.length > 0) {\n      this.parseExpression();\n    }\n\n    return {\n      errors: this.errors,\n      hasOwn: this.hasOwn,\n      referencedAliases: this.referencedAliases,\n    };\n  }\n\n  private current(): Token | undefined {\n    return this.tokens[this.pos];\n  }\n\n  private advance(): Token | undefined {\n    return this.tokens[this.pos++];\n  }\n\n  private match(type: TokenType): boolean {\n    if (this.current()?.type === type) {\n      this.advance();\n      return true;\n    }\n    return false;\n  }\n\n  private parseExpression(): void {\n    this.parseAnd();\n  }\n\n  private parseAnd(): void {\n    this.parseOr();\n    while (this.current()?.type === 'AND') {\n      this.advance();\n      if (!this.current() || this.current()?.type === 'AND') {\n        const prev = this.tokens[this.pos - 1];\n        this.errors.push({\n          message: \"Expected expression after '&' operator.\",\n          offset: prev.offset,\n          length: prev.length,\n        });\n        return;\n      }\n      this.parseOr();\n    }\n  }\n\n  private parseOr(): void {\n    this.parseXor();\n    while (this.current()?.type === 'OR') {\n      this.advance();\n      if (!this.current() || this.current()?.type === 'OR') {\n        const prev = this.tokens[this.pos - 1];\n        this.errors.push({\n          message: \"Expected expression after '|' operator.\",\n          offset: prev.offset,\n          length: prev.length,\n        });\n        return;\n      }\n      this.parseXor();\n    }\n  }\n\n  private parseXor(): void {\n    this.parseUnary();\n    let operandCount = 1;\n\n    while (this.current()?.type === 'XOR') {\n      this.advance();\n      operandCount++;\n      if (operandCount > MAX_XOR_CHAIN_LENGTH) {\n        const prev = this.tokens[this.pos - 1];\n        this.errors.push({\n          message: `XOR chain with ${operandCount} operands produces ${Math.pow(2, operandCount - 1)} OR branches. Consider breaking into smaller expressions.`,\n          offset: prev.offset,\n          length: prev.length,\n        });\n      }\n      this.parseUnary();\n    }\n  }\n\n  private parseUnary(): void {\n    if (this.match('NOT')) {\n      if (\n        !this.current() ||\n        this.current()?.type === 'AND' ||\n        this.current()?.type === 'OR' ||\n        this.current()?.type === 'XOR'\n      ) {\n        const prev = this.tokens[this.pos - 1];\n        this.errors.push({\n          message: \"Expected expression after '!' operator.\",\n          offset: prev.offset,\n          length: prev.length,\n        });\n        return;\n      }\n      this.parseUnary();\n      return;\n    }\n    this.parsePrimary();\n  }\n\n  private parsePrimary(): void {\n    if (this.match('LPAREN')) {\n      this.parseExpression();\n      if (!this.match('RPAREN')) {\n        this.errors.push({\n          message: \"Missing closing ')' in state expression.\",\n          offset: this.tokens[this.pos - 1]?.offset ?? 0,\n          length: 1,\n        });\n      }\n      return;\n    }\n\n    const token = this.current();\n    if (token?.type === 'STATE') {\n      this.advance();\n      this.validateStateToken(token);\n      return;\n    }\n\n    // Unexpected token or end\n    if (token) {\n      this.errors.push({\n        message: `Unexpected token '${token.value}'.`,\n        offset: token.offset,\n        length: token.length,\n      });\n      this.advance();\n    }\n  }\n\n  private validateStateToken(token: Token): void {\n    const value = token.value;\n\n    // @starting\n    if (value === '@starting') return;\n\n    // @media:type\n    if (value.startsWith('@media:')) {\n      const mediaType = value.slice(7);\n      const validTypes = new Set(['print', 'screen', 'all', 'speech']);\n      if (!validTypes.has(mediaType)) {\n        this.errors.push({\n          message: `Unknown media type '${mediaType}'. Valid: print, screen, all, speech.`,\n          offset: token.offset,\n          length: token.length,\n        });\n      }\n      return;\n    }\n\n    // @media(...)\n    if (value.startsWith('@media(')) {\n      this.validateMediaQuery(value, token);\n      return;\n    }\n\n    // @supports(...)\n    if (value.startsWith('@supports(')) {\n      this.validateSupportsQuery(value, token);\n      return;\n    }\n\n    // @root(...)\n    if (value.startsWith('@root(')) {\n      this.validateInnerStateExpression(value, 6, token);\n      return;\n    }\n\n    // @parent(...)\n    if (value.startsWith('@parent(')) {\n      this.validateParentState(value, token);\n      return;\n    }\n\n    // @own(...)\n    if (value.startsWith('@own(')) {\n      this.hasOwn = true;\n      if (this.insideOwn) {\n        this.errors.push({\n          message: 'Nested @own() is not allowed.',\n          offset: token.offset,\n          length: token.length,\n        });\n        return;\n      }\n      const prevInsideOwn = this.insideOwn;\n      this.insideOwn = true;\n      this.validateInnerStateExpression(value, 5, token);\n      this.insideOwn = prevInsideOwn;\n      return;\n    }\n\n    // @(...) container query\n    if (value.startsWith('@(')) {\n      this.validateContainerQuery(value, token);\n      return;\n    }\n\n    // @alias predefined state\n    if (value.startsWith('@') && /^@[A-Za-z][A-Za-z0-9-]*$/.test(value)) {\n      this.referencedAliases.push(value);\n      return;\n    }\n\n    // Pseudo-class/pseudo-element\n    if (value.startsWith(':')) {\n      this.validatePseudoClass(value, token);\n      return;\n    }\n\n    // Class selector\n    if (value.startsWith('.')) return;\n\n    // Attribute selector\n    if (value.startsWith('[')) {\n      this.validateAttributeSelector(value, token);\n      return;\n    }\n\n    // Value modifier (e.g., theme=danger)\n    if (value.includes('=')) {\n      this.validateValueModifier(value, token);\n      return;\n    }\n\n    // Boolean modifier (e.g., hovered, disabled)\n    if (/^[a-z][a-z0-9-]+$/i.test(value)) return;\n\n    this.errors.push({\n      message: `Unrecognized state token '${value}'.`,\n      offset: token.offset,\n      length: token.length,\n    });\n  }\n\n  private validateMediaQuery(raw: string, token: Token): void {\n    const content = raw.slice(7, -1);\n    if (!content.trim()) {\n      this.errors.push({\n        message: 'Empty @media() query.',\n        offset: token.offset,\n        length: token.length,\n      });\n      return;\n    }\n\n    // Expand dimension shorthands for validation\n    const expanded = expandDimensionShorthands(content.trim());\n\n    // Feature query (contains ':' but no comparison operators)\n    if (\n      expanded.includes(':') &&\n      !expanded.includes('<') &&\n      !expanded.includes('>') &&\n      !expanded.includes('=')\n    ) {\n      return;\n    }\n\n    // Boolean feature query (no comparison operators)\n    if (\n      !expanded.includes('<') &&\n      !expanded.includes('>') &&\n      !expanded.includes('=')\n    ) {\n      return;\n    }\n\n    // Dimension query — validate dimension names\n    this.validateDimensionCondition(expanded, token);\n  }\n\n  private validateDimensionCondition(condition: string, token: Token): void {\n    // Range syntax: 600px <= width < 1200px\n    const rangeMatch = condition.match(\n      /^(.+?)\\s*(<=|<)\\s*(\\S+)\\s*(<=|<)\\s*(.+)$/,\n    );\n    if (rangeMatch) {\n      const dim = rangeMatch[3];\n      if (!DIMENSION_FULL.has(dim) && !DIMENSION_SHORTHANDS.has(dim)) {\n        this.errors.push({\n          message: `Unknown dimension '${dim}' in media/container query. Valid: width, height, inline-size, block-size (or w, h, is, bs).`,\n          offset: token.offset,\n          length: token.length,\n        });\n      }\n      return;\n    }\n\n    // Simple comparison: width < 768px\n    const simpleMatch = condition.match(/^(\\S+)\\s*(<=|>=|<|>|=)\\s*(.+)$/);\n    if (simpleMatch) {\n      const dim = simpleMatch[1];\n      if (DIMENSION_FULL.has(dim) || DIMENSION_SHORTHANDS.has(dim)) {\n        return;\n      }\n    }\n\n    // Reversed: 768px > width\n    const reversedMatch = condition.match(/^(.+?)\\s*(<=|>=|<|>|=)\\s*(\\S+)$/);\n    if (reversedMatch) {\n      const dim = reversedMatch[3];\n      if (DIMENSION_FULL.has(dim) || DIMENSION_SHORTHANDS.has(dim)) {\n        return;\n      }\n    }\n  }\n\n  private validateSupportsQuery(raw: string, token: Token): void {\n    const content = raw.slice(10, -1);\n    if (!content.trim()) {\n      this.errors.push({\n        message: 'Empty @supports() query.',\n        offset: token.offset,\n        length: token.length,\n      });\n    }\n  }\n\n  private validateInnerStateExpression(\n    raw: string,\n    prefixLen: number,\n    _token: Token,\n  ): void {\n    const content = raw.slice(prefixLen, -1);\n    if (!content.trim()) return;\n\n    const innerResult = parseStateKey(content, this.opts);\n    this.errors.push(...innerResult.errors);\n    if (innerResult.hasOwn) this.hasOwn = true;\n    this.referencedAliases.push(...innerResult.referencedAliases);\n  }\n\n  private validateParentState(raw: string, token: Token): void {\n    const content = raw.slice(8, -1);\n    if (!content.trim()) {\n      this.errors.push({\n        message: 'Empty @parent() state.',\n        offset: token.offset,\n        length: token.length,\n      });\n      return;\n    }\n\n    let condition = content.trim();\n\n    // Check for direct parent combinator: @parent(hovered, >)\n    const lastCommaIdx = condition.lastIndexOf(',');\n    if (lastCommaIdx !== -1) {\n      const afterComma = condition.slice(lastCommaIdx + 1).trim();\n      if (afterComma === '>') {\n        condition = condition.slice(0, lastCommaIdx).trim();\n      }\n    }\n\n    const innerResult = parseStateKey(condition, this.opts);\n    this.errors.push(...innerResult.errors);\n    this.referencedAliases.push(...innerResult.referencedAliases);\n  }\n\n  private validateContainerQuery(raw: string, token: Token): void {\n    const content = raw.slice(2, -1);\n    if (!content.trim()) {\n      this.errors.push({\n        message: 'Empty container query.',\n        offset: token.offset,\n        length: token.length,\n      });\n      return;\n    }\n\n    // Named container: @(layout, w < 600px)\n    const commaIdx = findTopLevelComma(content);\n    let condition: string;\n\n    if (commaIdx !== -1) {\n      condition = content.slice(commaIdx + 1).trim();\n    } else {\n      condition = content.trim();\n    }\n\n    // Style query: @($variant=primary) — skip\n    if (condition.startsWith('$')) return;\n\n    // Function-like: scroll-state(...) — skip\n    if (/^[a-zA-Z][\\w-]*\\s*\\(/.test(condition)) return;\n\n    // Dimension query\n    const expanded = expandDimensionShorthands(condition);\n    if (\n      expanded.includes('<') ||\n      expanded.includes('>') ||\n      expanded.includes('=')\n    ) {\n      this.validateDimensionCondition(expanded, token);\n    }\n  }\n\n  private validatePseudoClass(value: string, token: Token): void {\n    // :is(), :has(), :not(), :where() — structural pseudo-classes\n    const enhancedMatch = /^:(is|has|not|where)\\(/.exec(value);\n    if (enhancedMatch) return;\n\n    // Functional pseudo-classes like :nth-child(2n+1)\n    const funcMatch = /^(:[a-z-]+)\\(/.exec(value);\n    if (funcMatch) {\n      const baseName = funcMatch[1];\n      if (!KNOWN_PSEUDO_CLASSES.has(baseName)) {\n        this.errors.push({\n          message: `Unknown pseudo-class '${baseName}'.`,\n          offset: token.offset,\n          length: token.length,\n        });\n      }\n      return;\n    }\n\n    // Simple pseudo-class: :hover, :focus, etc.\n    if (!KNOWN_PSEUDO_CLASSES.has(value)) {\n      this.errors.push({\n        message: `Unknown pseudo-class '${value}'.`,\n        offset: token.offset,\n        length: token.length,\n      });\n    }\n  }\n\n  private validateAttributeSelector(value: string, token: Token): void {\n    if (!value.startsWith('[') || !value.endsWith(']')) {\n      this.errors.push({\n        message: `Malformed attribute selector '${value}'.`,\n        offset: token.offset,\n        length: token.length,\n      });\n    }\n  }\n\n  private validateValueModifier(value: string, token: Token): void {\n    const opMatch = value.match(/^([a-z][a-z0-9-]*)(\\^=|\\$=|\\*=|=)(.+)$/i);\n    if (!opMatch) {\n      this.errors.push({\n        message: `Invalid value modifier syntax '${value}'.`,\n        offset: token.offset,\n        length: token.length,\n      });\n    }\n  }\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction expandDimensionShorthands(condition: string): string {\n  return condition\n    .replace(/\\bw\\b/g, 'width')\n    .replace(/\\bh\\b/g, 'height')\n    .replace(/\\bis\\b/g, 'inline-size')\n    .replace(/\\bbs\\b/g, 'block-size');\n}\n\nfunction findTopLevelComma(str: string): number {\n  let depth = 0;\n  for (let i = 0; i < str.length; i++) {\n    const ch = str[i];\n    if (ch === '(') depth++;\n    else if (ch === ')') depth = Math.max(0, depth - 1);\n    else if (ch === ',' && depth === 0) return i;\n  }\n  return -1;\n}\n\n// ============================================================================\n// Public API\n// ============================================================================\n\n/**\n * Validate a state key string and return detailed errors.\n */\nexport function parseStateKey(\n  stateKey: string,\n  opts: StateKeyParserOptions = {},\n): StateKeyResult {\n  if (!stateKey || !stateKey.trim()) {\n    return { errors: [], hasOwn: false, referencedAliases: [] };\n  }\n\n  const { tokens, errors: tokenErrors } = tokenize(stateKey.trim());\n  const validator = new StateKeyValidator(tokens, tokenErrors, opts);\n  return validator.validate();\n}\n\n/**\n * Validate a state definition value (the RHS of a state alias).\n * State definitions should be valid state expressions like\n * '@media(w < 768px)', '@root(theme=dark)', etc.\n */\nexport function validateStateDefinition(\n  value: string,\n  opts: StateKeyParserOptions = {},\n): StateKeyResult {\n  return parseStateKey(value, opts);\n}\n"],"mappings":"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"}
+{"version":3,"file":"state-key-parser.js","names":[],"sources":["../../src/parsers/state-key-parser.ts"],"sourcesContent":["import { KNOWN_PSEUDO_CLASSES } from '../constants.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface StateKeyError {\n  message: string;\n  offset: number;\n  length: number;\n}\n\nexport interface StateKeyResult {\n  errors: StateKeyError[];\n  hasOwn: boolean;\n  referencedAliases: string[];\n}\n\nexport interface StateKeyParserOptions {\n  knownAliases?: string[];\n}\n\n// ============================================================================\n// Tokenizer\n// ============================================================================\n\ntype TokenType = 'AND' | 'OR' | 'NOT' | 'XOR' | 'LPAREN' | 'RPAREN' | 'STATE';\n\ninterface Token {\n  type: TokenType;\n  value: string;\n  offset: number;\n  length: number;\n}\n\n/**\n * Pattern for tokenizing state notation.\n * Matches operators, parentheses, @-prefixed states, value mods, boolean mods,\n * pseudo-classes with functions (including :is/:has/:not/:where with nesting),\n * class selectors, and attribute selectors.\n */\nconst STATE_TOKEN_PATTERN =\n  /([&|!^])|([()])|(@media:[a-z]+)|(@media\\([^)]*\\))|(@supports\\([^()]*(?:\\([^)]*\\))?[^)]*\\))|(@root\\([^()]*(?:\\([^()]*(?:\\([^)]*\\))?[^)]*\\))*[^)]*\\))|(@parent\\([^()]*(?:\\([^()]*(?:\\([^)]*\\))?[^)]*\\))*[^)]*\\))|(@own\\([^()]*(?:\\([^()]*(?:\\([^)]*\\))?[^)]*\\))*[^)]*\\))|(@\\([^()]*(?:\\([^)]*\\))?[^)]*\\))|(@starting)|(@[A-Za-z][A-Za-z0-9-]*)|([a-z][a-z0-9-]*(?:\\^=|\\$=|\\*=|=)(?:\"[^\"]*\"|'[^']*'|[^\\s&|!^()]+))|([a-z][a-z0-9-]+)|(:(?:is|has|not|where)\\([^()]*(?:\\([^()]*(?:\\([^)]*\\))?[^)]*\\))*[^)]*\\))|(:[-a-z][a-z0-9-]*(?:\\([^)]+\\))?)|(\\.[a-z][a-z0-9-]+)|(\\[[^\\]]+\\])/gi;\n\nfunction tokenize(stateKey: string): {\n  tokens: Token[];\n  errors: StateKeyError[];\n} {\n  const tokens: Token[] = [];\n  const errors: StateKeyError[] = [];\n\n  // Replace commas with | outside of parentheses\n  const normalized = replaceCommasOutsideParens(stateKey);\n\n  const covered = new Set<number>();\n\n  STATE_TOKEN_PATTERN.lastIndex = 0;\n  let match: RegExpExecArray | null;\n  while ((match = STATE_TOKEN_PATTERN.exec(normalized)) !== null) {\n    const fullMatch = match[0];\n    const offset = match.index;\n\n    for (let i = offset; i < offset + fullMatch.length; i++) {\n      covered.add(i);\n    }\n\n    if (match[1]) {\n      switch (fullMatch) {\n        case '&':\n          tokens.push({ type: 'AND', value: '&', offset, length: 1 });\n          break;\n        case '|':\n          tokens.push({ type: 'OR', value: '|', offset, length: 1 });\n          break;\n        case '!':\n          tokens.push({ type: 'NOT', value: '!', offset, length: 1 });\n          break;\n        case '^':\n          tokens.push({ type: 'XOR', value: '^', offset, length: 1 });\n          break;\n      }\n    } else if (match[2]) {\n      if (fullMatch === '(') {\n        tokens.push({ type: 'LPAREN', value: '(', offset, length: 1 });\n      } else {\n        tokens.push({ type: 'RPAREN', value: ')', offset, length: 1 });\n      }\n    } else {\n      tokens.push({\n        type: 'STATE',\n        value: fullMatch,\n        offset,\n        length: fullMatch.length,\n      });\n    }\n  }\n\n  // Check for uncovered characters (unrecognized tokens)\n  const uncovered: { ch: string; pos: number }[] = [];\n  for (let i = 0; i < stateKey.length; i++) {\n    const ch = stateKey[i];\n    if (ch === ' ' || ch === '\\t' || ch === ',') continue;\n    if (!covered.has(i)) {\n      uncovered.push({ ch, pos: i });\n    }\n  }\n\n  if (uncovered.length > 0) {\n    const chars = [...new Set(uncovered.map((u) => u.ch))].join('');\n    errors.push({\n      message: `Unrecognized characters '${chars}' in state key '${stateKey}'.`,\n      offset: uncovered[0].pos,\n      length: 1,\n    });\n  }\n\n  return { tokens, errors };\n}\n\nfunction replaceCommasOutsideParens(str: string): string {\n  let result = '';\n  let depth = 0;\n\n  for (const char of str) {\n    if (char === '(') {\n      depth++;\n      result += char;\n    } else if (char === ')') {\n      depth--;\n      result += char;\n    } else if (char === ',' && depth === 0) {\n      result += '|';\n    } else {\n      result += char;\n    }\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Validator\n// ============================================================================\n\nconst MAX_XOR_CHAIN_LENGTH = 4;\n\nconst DIMENSION_SHORTHANDS = new Set(['w', 'h', 'is', 'bs']);\nconst DIMENSION_FULL = new Set([\n  'width',\n  'height',\n  'inline-size',\n  'block-size',\n]);\n\nclass StateKeyValidator {\n  private errors: StateKeyError[] = [];\n  private hasOwn = false;\n  private referencedAliases: string[] = [];\n  private tokens: Token[];\n  private pos = 0;\n  private opts: StateKeyParserOptions;\n  private insideOwn = false;\n\n  constructor(\n    tokens: Token[],\n    tokenErrors: StateKeyError[],\n    opts: StateKeyParserOptions,\n  ) {\n    this.tokens = tokens;\n    this.errors = [...tokenErrors];\n    this.opts = opts;\n  }\n\n  validate(): StateKeyResult {\n    if (this.tokens.length > 0) {\n      this.parseExpression();\n    }\n\n    return {\n      errors: this.errors,\n      hasOwn: this.hasOwn,\n      referencedAliases: this.referencedAliases,\n    };\n  }\n\n  private current(): Token | undefined {\n    return this.tokens[this.pos];\n  }\n\n  private advance(): Token | undefined {\n    return this.tokens[this.pos++];\n  }\n\n  private match(type: TokenType): boolean {\n    if (this.current()?.type === type) {\n      this.advance();\n      return true;\n    }\n    return false;\n  }\n\n  private parseExpression(): void {\n    this.parseAnd();\n  }\n\n  private parseAnd(): void {\n    this.parseOr();\n    while (this.current()?.type === 'AND') {\n      this.advance();\n      if (!this.current() || this.current()?.type === 'AND') {\n        const prev = this.tokens[this.pos - 1];\n        this.errors.push({\n          message: \"Expected expression after '&' operator.\",\n          offset: prev.offset,\n          length: prev.length,\n        });\n        return;\n      }\n      this.parseOr();\n    }\n  }\n\n  private parseOr(): void {\n    this.parseXor();\n    while (this.current()?.type === 'OR') {\n      this.advance();\n      if (!this.current() || this.current()?.type === 'OR') {\n        const prev = this.tokens[this.pos - 1];\n        this.errors.push({\n          message: \"Expected expression after '|' operator.\",\n          offset: prev.offset,\n          length: prev.length,\n        });\n        return;\n      }\n      this.parseXor();\n    }\n  }\n\n  private parseXor(): void {\n    this.parseUnary();\n    let operandCount = 1;\n\n    while (this.current()?.type === 'XOR') {\n      this.advance();\n      operandCount++;\n      if (operandCount > MAX_XOR_CHAIN_LENGTH) {\n        const prev = this.tokens[this.pos - 1];\n        this.errors.push({\n          message: `XOR chain with ${operandCount} operands produces ${Math.pow(2, operandCount - 1)} OR branches. Consider breaking into smaller expressions.`,\n          offset: prev.offset,\n          length: prev.length,\n        });\n      }\n      this.parseUnary();\n    }\n  }\n\n  private parseUnary(): void {\n    if (this.match('NOT')) {\n      if (\n        !this.current() ||\n        this.current()?.type === 'AND' ||\n        this.current()?.type === 'OR' ||\n        this.current()?.type === 'XOR'\n      ) {\n        const prev = this.tokens[this.pos - 1];\n        this.errors.push({\n          message: \"Expected expression after '!' operator.\",\n          offset: prev.offset,\n          length: prev.length,\n        });\n        return;\n      }\n      this.parseUnary();\n      return;\n    }\n    this.parsePrimary();\n  }\n\n  private parsePrimary(): void {\n    if (this.match('LPAREN')) {\n      this.parseExpression();\n      if (!this.match('RPAREN')) {\n        this.errors.push({\n          message: \"Missing closing ')' in state expression.\",\n          offset: this.tokens[this.pos - 1]?.offset ?? 0,\n          length: 1,\n        });\n      }\n      return;\n    }\n\n    const token = this.current();\n    if (token?.type === 'STATE') {\n      this.advance();\n      this.validateStateToken(token);\n      return;\n    }\n\n    // Unexpected token or end\n    if (token) {\n      this.errors.push({\n        message: `Unexpected token '${token.value}'.`,\n        offset: token.offset,\n        length: token.length,\n      });\n      this.advance();\n    }\n  }\n\n  private validateStateToken(token: Token): void {\n    const value = token.value;\n\n    // @starting\n    if (value === '@starting') return;\n\n    // @media:type\n    if (value.startsWith('@media:')) {\n      const mediaType = value.slice(7);\n      const validTypes = new Set(['print', 'screen', 'all', 'speech']);\n      if (!validTypes.has(mediaType)) {\n        this.errors.push({\n          message: `Unknown media type '${mediaType}'. Valid: print, screen, all, speech.`,\n          offset: token.offset,\n          length: token.length,\n        });\n      }\n      return;\n    }\n\n    // @media(...)\n    if (value.startsWith('@media(')) {\n      this.validateMediaQuery(value, token);\n      return;\n    }\n\n    // @supports(...)\n    if (value.startsWith('@supports(')) {\n      this.validateSupportsQuery(value, token);\n      return;\n    }\n\n    // @root(...)\n    if (value.startsWith('@root(')) {\n      this.validateInnerStateExpression(value, 6, token);\n      return;\n    }\n\n    // @parent(...)\n    if (value.startsWith('@parent(')) {\n      this.validateParentState(value, token);\n      return;\n    }\n\n    // @own(...)\n    if (value.startsWith('@own(')) {\n      this.hasOwn = true;\n      if (this.insideOwn) {\n        this.errors.push({\n          message: 'Nested @own() is not allowed.',\n          offset: token.offset,\n          length: token.length,\n        });\n        return;\n      }\n      const prevInsideOwn = this.insideOwn;\n      this.insideOwn = true;\n      this.validateInnerStateExpression(value, 5, token);\n      this.insideOwn = prevInsideOwn;\n      return;\n    }\n\n    // @(...) container query\n    if (value.startsWith('@(')) {\n      this.validateContainerQuery(value, token);\n      return;\n    }\n\n    // @alias predefined state\n    if (value.startsWith('@') && /^@[A-Za-z][A-Za-z0-9-]*$/.test(value)) {\n      this.referencedAliases.push(value);\n      return;\n    }\n\n    // Pseudo-class/pseudo-element\n    if (value.startsWith(':')) {\n      this.validatePseudoClass(value, token);\n      return;\n    }\n\n    // Class selector\n    if (value.startsWith('.')) return;\n\n    // Attribute selector\n    if (value.startsWith('[')) {\n      this.validateAttributeSelector(value, token);\n      return;\n    }\n\n    // Value modifier (e.g., theme=danger)\n    if (value.includes('=')) {\n      this.validateValueModifier(value, token);\n      return;\n    }\n\n    // Boolean modifier (e.g., hovered, disabled)\n    if (/^[a-z][a-z0-9-]+$/i.test(value)) return;\n\n    this.errors.push({\n      message: `Unrecognized state token '${value}'.`,\n      offset: token.offset,\n      length: token.length,\n    });\n  }\n\n  private validateMediaQuery(raw: string, token: Token): void {\n    const content = raw.slice(7, -1);\n    if (!content.trim()) {\n      this.errors.push({\n        message: 'Empty @media() query.',\n        offset: token.offset,\n        length: token.length,\n      });\n      return;\n    }\n\n    // Expand dimension shorthands for validation\n    const expanded = expandDimensionShorthands(content.trim());\n\n    // Feature query (contains ':' but no comparison operators)\n    if (\n      expanded.includes(':') &&\n      !expanded.includes('<') &&\n      !expanded.includes('>') &&\n      !expanded.includes('=')\n    ) {\n      return;\n    }\n\n    // Boolean feature query (no comparison operators)\n    if (\n      !expanded.includes('<') &&\n      !expanded.includes('>') &&\n      !expanded.includes('=')\n    ) {\n      return;\n    }\n\n    // Dimension query — validate dimension names\n    this.validateDimensionCondition(expanded, token);\n  }\n\n  private validateDimensionCondition(condition: string, token: Token): void {\n    // Range syntax: 600px <= width < 1200px\n    const rangeMatch = condition.match(\n      /^(.+?)\\s*(<=|<)\\s*(\\S+)\\s*(<=|<)\\s*(.+)$/,\n    );\n    if (rangeMatch) {\n      const dim = rangeMatch[3];\n      if (!DIMENSION_FULL.has(dim) && !DIMENSION_SHORTHANDS.has(dim)) {\n        this.errors.push({\n          message: `Unknown dimension '${dim}' in media/container query. Valid: width, height, inline-size, block-size (or w, h, is, bs).`,\n          offset: token.offset,\n          length: token.length,\n        });\n      }\n      return;\n    }\n\n    // Simple comparison: width < 768px\n    const simpleMatch = condition.match(/^(\\S+)\\s*(<=|>=|<|>|=)\\s*(.+)$/);\n    if (simpleMatch) {\n      const dim = simpleMatch[1];\n      if (DIMENSION_FULL.has(dim) || DIMENSION_SHORTHANDS.has(dim)) {\n        return;\n      }\n    }\n\n    // Reversed: 768px > width\n    const reversedMatch = condition.match(/^(.+?)\\s*(<=|>=|<|>|=)\\s*(\\S+)$/);\n    if (reversedMatch) {\n      const dim = reversedMatch[3];\n      if (DIMENSION_FULL.has(dim) || DIMENSION_SHORTHANDS.has(dim)) {\n        return;\n      }\n    }\n  }\n\n  private validateSupportsQuery(raw: string, token: Token): void {\n    const content = raw.slice(10, -1);\n    if (!content.trim()) {\n      this.errors.push({\n        message: 'Empty @supports() query.',\n        offset: token.offset,\n        length: token.length,\n      });\n    }\n  }\n\n  private validateInnerStateExpression(\n    raw: string,\n    prefixLen: number,\n    _token: Token,\n  ): void {\n    const content = raw.slice(prefixLen, -1);\n    if (!content.trim()) return;\n\n    const innerResult = parseStateKey(content, this.opts);\n    this.errors.push(...innerResult.errors);\n    if (innerResult.hasOwn) this.hasOwn = true;\n    this.referencedAliases.push(...innerResult.referencedAliases);\n  }\n\n  private validateParentState(raw: string, token: Token): void {\n    const content = raw.slice(8, -1);\n    if (!content.trim()) {\n      this.errors.push({\n        message: 'Empty @parent() state.',\n        offset: token.offset,\n        length: token.length,\n      });\n      return;\n    }\n\n    let condition = content.trim();\n\n    // Check for direct parent combinator: @parent(hovered, >)\n    const lastCommaIdx = condition.lastIndexOf(',');\n    if (lastCommaIdx !== -1) {\n      const afterComma = condition.slice(lastCommaIdx + 1).trim();\n      if (afterComma === '>') {\n        condition = condition.slice(0, lastCommaIdx).trim();\n      }\n    }\n\n    const innerResult = parseStateKey(condition, this.opts);\n    this.errors.push(...innerResult.errors);\n    this.referencedAliases.push(...innerResult.referencedAliases);\n  }\n\n  private validateContainerQuery(raw: string, token: Token): void {\n    const content = raw.slice(2, -1);\n    if (!content.trim()) {\n      this.errors.push({\n        message: 'Empty container query.',\n        offset: token.offset,\n        length: token.length,\n      });\n      return;\n    }\n\n    // Named container: @(layout, w < 600px)\n    const commaIdx = findTopLevelComma(content);\n    let condition: string;\n\n    if (commaIdx !== -1) {\n      condition = content.slice(commaIdx + 1).trim();\n    } else {\n      condition = content.trim();\n    }\n\n    // Style query: @($variant=primary) — skip\n    if (condition.startsWith('$')) return;\n\n    // Function-like: scroll-state(...) — skip\n    if (/^[a-zA-Z][\\w-]*\\s*\\(/.test(condition)) return;\n\n    // Dimension query\n    const expanded = expandDimensionShorthands(condition);\n    if (\n      expanded.includes('<') ||\n      expanded.includes('>') ||\n      expanded.includes('=')\n    ) {\n      this.validateDimensionCondition(expanded, token);\n    }\n  }\n\n  private validatePseudoClass(value: string, token: Token): void {\n    // :is(), :has(), :not(), :where() — structural pseudo-classes\n    const enhancedMatch = /^:(is|has|not|where)\\(/.exec(value);\n    if (enhancedMatch) return;\n\n    // Functional pseudo-classes like :nth-child(2n+1)\n    const funcMatch = /^(:[a-z-]+)\\(/.exec(value);\n    if (funcMatch) {\n      const baseName = funcMatch[1];\n      if (!KNOWN_PSEUDO_CLASSES.has(baseName)) {\n        this.errors.push({\n          message: `Unknown pseudo-class '${baseName}'.`,\n          offset: token.offset,\n          length: token.length,\n        });\n      }\n      return;\n    }\n\n    // Simple pseudo-class: :hover, :focus, etc.\n    if (!KNOWN_PSEUDO_CLASSES.has(value)) {\n      this.errors.push({\n        message: `Unknown pseudo-class '${value}'.`,\n        offset: token.offset,\n        length: token.length,\n      });\n    }\n  }\n\n  private validateAttributeSelector(value: string, token: Token): void {\n    if (!value.startsWith('[') || !value.endsWith(']')) {\n      this.errors.push({\n        message: `Malformed attribute selector '${value}'.`,\n        offset: token.offset,\n        length: token.length,\n      });\n    }\n  }\n\n  private validateValueModifier(value: string, token: Token): void {\n    const opMatch = value.match(/^([a-z][a-z0-9-]*)(\\^=|\\$=|\\*=|=)(.+)$/i);\n    if (!opMatch) {\n      this.errors.push({\n        message: `Invalid value modifier syntax '${value}'.`,\n        offset: token.offset,\n        length: token.length,\n      });\n    }\n  }\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction expandDimensionShorthands(condition: string): string {\n  return condition\n    .replace(/\\bw\\b/g, 'width')\n    .replace(/\\bh\\b/g, 'height')\n    .replace(/\\bis\\b/g, 'inline-size')\n    .replace(/\\bbs\\b/g, 'block-size');\n}\n\nfunction findTopLevelComma(str: string): number {\n  let depth = 0;\n  for (let i = 0; i < str.length; i++) {\n    const ch = str[i];\n    if (ch === '(') depth++;\n    else if (ch === ')') depth = Math.max(0, depth - 1);\n    else if (ch === ',' && depth === 0) return i;\n  }\n  return -1;\n}\n\n// ============================================================================\n// Public API\n// ============================================================================\n\n/**\n * Validate a state key string and return detailed errors.\n */\nexport function parseStateKey(\n  stateKey: string,\n  opts: StateKeyParserOptions = {},\n): StateKeyResult {\n  if (!stateKey || !stateKey.trim()) {\n    return { errors: [], hasOwn: false, referencedAliases: [] };\n  }\n\n  const trimmed = stateKey.trim();\n\n  // The standalone `_` key is the map-wide fallback floor. It always applies\n  // and must be used on its own — it carries no state logic to validate.\n  if (trimmed === '_') {\n    return { errors: [], hasOwn: false, referencedAliases: [] };\n  }\n\n  // A `_` combined with state logic (`_ & hovered`, `_ | x`) is a misuse: the\n  // fallback floor can only be used on its own. Tasty ignores such keys at\n  // runtime and warns; flag them here so the mistake surfaces in the editor.\n  if (isMisusedFallbackKey(trimmed)) {\n    return {\n      errors: [\n        {\n          message:\n            'The fallback floor \"_\" cannot be combined with other state ' +\n            'logic. Use \"_\" on its own as a map-wide fallback floor.',\n          offset: 0,\n          length: stateKey.length,\n        },\n      ],\n      hasOwn: false,\n      referencedAliases: [],\n    };\n  }\n\n  const { tokens, errors: tokenErrors } = tokenize(trimmed);\n  const validator = new StateKeyValidator(tokens, tokenErrors, opts);\n  return validator.validate();\n}\n\n/**\n * Detect a misused standalone `_` fallback key: a key that is not exactly\n * `_` but contains `_` as a standalone atom among state-logic operators\n * (`&`, `|`, `^`, `,`) or grouping parens. A `_` embedded in a longer token\n * (e.g. a modifier named `_private`) is not a misuse.\n */\nfunction isMisusedFallbackKey(stateKey: string): boolean {\n  if (stateKey === '_' || !stateKey.includes('_')) return false;\n  return /(?:^|[\\s&|^,(])_(?:[\\s&|^,)]|$)/.test(stateKey);\n}\n\n/**\n * Validate a state definition value (the RHS of a state alias).\n * State definitions should be valid state expressions like\n * '@media(w < 768px)', '@root(theme=dark)', etc.\n */\nexport function validateStateDefinition(\n  value: string,\n  opts: StateKeyParserOptions = {},\n): StateKeyResult {\n  return parseStateKey(value, opts);\n}\n"],"mappings":"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"}

package/dist/rules/no-own-at-root.js

@@ -35,7 +35,7 @@ var no_own_at_root_default = createRule({
 				for (const stateProp of prop.value.properties) {
 					if (stateProp.type !== "Property") continue;
 					const stateKey = !stateProp.computed ? getKeyName(stateProp.key) : getStringValue(stateProp.key);
-					if (stateKey === null || stateKey === "") continue;
+					if (stateKey === null || stateKey === "" || stateKey === "_") continue;
 					if (parseStateKey(stateKey).hasOwn) context.report({
 						node: stateProp.key,
 						messageId: "ownAtRoot"

package/dist/rules/no-own-at-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"no-own-at-root.js","names":[],"sources":["../../src/rules/no-own-at-root.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport { getKeyName, getStringValue } from '../utils.js';\nimport { parseStateKey } from '../parsers/state-key-parser.js';\n\ntype MessageIds = 'ownAtRoot';\n\nexport default createRule<[], MessageIds>({\n  name: 'no-own-at-root',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'Warn when @own() is used outside sub-element styles where it is redundant',\n    },\n    messages: {\n      ownAtRoot:\n        '@own() is redundant outside sub-element styles. Use the inner selector directly instead (e.g. :hover instead of @own(:hover)).',\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    function isInsideSubElement(node: TSESTree.Node): boolean {\n      let current: TSESTree.Node | undefined = node.parent;\n      while (current) {\n        if (\n          current.type === 'Property' &&\n          !current.computed &&\n          current.key.type === 'Identifier' &&\n          /^[A-Z]/.test(current.key.name)\n        ) {\n          return true;\n        }\n        current = current.parent;\n      }\n      return false;\n    }\n\n    function handleStyleObject(node: TSESTree.ObjectExpression) {\n      if (!ctx.isStyleObject(node)) return;\n\n      const insideSubElement = isInsideSubElement(node);\n\n      if (insideSubElement) return;\n\n      for (const prop of node.properties) {\n        if (prop.type !== 'Property' || prop.computed) continue;\n\n        const key = getKeyName(prop.key);\n        if (key === null) continue;\n\n        if (/^[A-Z]/.test(key) || key.startsWith('@') || key.startsWith('&'))\n          continue;\n\n        if (prop.value.type !== 'ObjectExpression') continue;\n\n        for (const stateProp of prop.value.properties) {\n          if (stateProp.type !== 'Property') continue;\n\n          const stateKey = !stateProp.computed\n            ? getKeyName(stateProp.key)\n            : getStringValue(stateProp.key);\n          if (stateKey === null || stateKey === '') continue;\n\n          const result = parseStateKey(stateKey);\n\n          if (result.hasOwn) {\n            context.report({\n              node: stateProp.key,\n              messageId: 'ownAtRoot',\n            });\n          }\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;;AAQA,6BAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,6EACH;EACD,UAAU,EACR,WACE,kIACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,SAAS,mBAAmB,MAA8B;GACxD,IAAI,UAAqC,KAAK;AAC9C,UAAO,SAAS;AACd,QACE,QAAQ,SAAS,cACjB,CAAC,QAAQ,YACT,QAAQ,IAAI,SAAS,gBACrB,SAAS,KAAK,QAAQ,IAAI,KAAK,CAE/B,QAAO;AAET,cAAU,QAAQ;;AAEpB,UAAO;;EAGT,SAAS,kBAAkB,MAAiC;AAC1D,OAAI,CAAC,IAAI,cAAc,KAAK,CAAE;AAI9B,OAFyB,mBAAmB,KAAK,CAE3B;AAEtB,QAAK,MAAM,QAAQ,KAAK,YAAY;AAClC,QAAI,KAAK,SAAS,cAAc,KAAK,SAAU;IAE/C,MAAM,MAAM,WAAW,KAAK,IAAI;AAChC,QAAI,QAAQ,KAAM;AAElB,QAAI,SAAS,KAAK,IAAI,IAAI,IAAI,WAAW,IAAI,IAAI,IAAI,WAAW,IAAI,CAClE;AAEF,QAAI,KAAK,MAAM,SAAS,mBAAoB;AAE5C,SAAK,MAAM,aAAa,KAAK,MAAM,YAAY;AAC7C,SAAI,UAAU,SAAS,WAAY;KAEnC,MAAM,WAAW,CAAC,UAAU,WACxB,WAAW,UAAU,IAAI,GACzB,eAAe,UAAU,IAAI;AACjC,SAAI,aAAa,QAAQ,aAAa,GAAI;AAI1C,SAFe,cAAc,SAAS,CAE3B,OACT,SAAQ,OAAO;MACb,MAAM,UAAU;MAChB,WAAW;MACZ,CAAC;;;;AAMV,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAGvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}
+{"version":3,"file":"no-own-at-root.js","names":[],"sources":["../../src/rules/no-own-at-root.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport { getKeyName, getStringValue } from '../utils.js';\nimport { parseStateKey } from '../parsers/state-key-parser.js';\n\ntype MessageIds = 'ownAtRoot';\n\nexport default createRule<[], MessageIds>({\n  name: 'no-own-at-root',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'Warn when @own() is used outside sub-element styles where it is redundant',\n    },\n    messages: {\n      ownAtRoot:\n        '@own() is redundant outside sub-element styles. Use the inner selector directly instead (e.g. :hover instead of @own(:hover)).',\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    function isInsideSubElement(node: TSESTree.Node): boolean {\n      let current: TSESTree.Node | undefined = node.parent;\n      while (current) {\n        if (\n          current.type === 'Property' &&\n          !current.computed &&\n          current.key.type === 'Identifier' &&\n          /^[A-Z]/.test(current.key.name)\n        ) {\n          return true;\n        }\n        current = current.parent;\n      }\n      return false;\n    }\n\n    function handleStyleObject(node: TSESTree.ObjectExpression) {\n      if (!ctx.isStyleObject(node)) return;\n\n      const insideSubElement = isInsideSubElement(node);\n\n      if (insideSubElement) return;\n\n      for (const prop of node.properties) {\n        if (prop.type !== 'Property' || prop.computed) continue;\n\n        const key = getKeyName(prop.key);\n        if (key === null) continue;\n\n        if (/^[A-Z]/.test(key) || key.startsWith('@') || key.startsWith('&'))\n          continue;\n\n        if (prop.value.type !== 'ObjectExpression') continue;\n\n        for (const stateProp of prop.value.properties) {\n          if (stateProp.type !== 'Property') continue;\n\n          const stateKey = !stateProp.computed\n            ? getKeyName(stateProp.key)\n            : getStringValue(stateProp.key);\n          if (stateKey === null || stateKey === '' || stateKey === '_')\n            continue;\n\n          const result = parseStateKey(stateKey);\n\n          if (result.hasOwn) {\n            context.report({\n              node: stateProp.key,\n              messageId: 'ownAtRoot',\n            });\n          }\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;;AAQA,6BAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,6EACH;EACD,UAAU,EACR,WACE,kIACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,SAAS,mBAAmB,MAA8B;GACxD,IAAI,UAAqC,KAAK;AAC9C,UAAO,SAAS;AACd,QACE,QAAQ,SAAS,cACjB,CAAC,QAAQ,YACT,QAAQ,IAAI,SAAS,gBACrB,SAAS,KAAK,QAAQ,IAAI,KAAK,CAE/B,QAAO;AAET,cAAU,QAAQ;;AAEpB,UAAO;;EAGT,SAAS,kBAAkB,MAAiC;AAC1D,OAAI,CAAC,IAAI,cAAc,KAAK,CAAE;AAI9B,OAFyB,mBAAmB,KAAK,CAE3B;AAEtB,QAAK,MAAM,QAAQ,KAAK,YAAY;AAClC,QAAI,KAAK,SAAS,cAAc,KAAK,SAAU;IAE/C,MAAM,MAAM,WAAW,KAAK,IAAI;AAChC,QAAI,QAAQ,KAAM;AAElB,QAAI,SAAS,KAAK,IAAI,IAAI,IAAI,WAAW,IAAI,IAAI,IAAI,WAAW,IAAI,CAClE;AAEF,QAAI,KAAK,MAAM,SAAS,mBAAoB;AAE5C,SAAK,MAAM,aAAa,KAAK,MAAM,YAAY;AAC7C,SAAI,UAAU,SAAS,WAAY;KAEnC,MAAM,WAAW,CAAC,UAAU,WACxB,WAAW,UAAU,IAAI,GACzB,eAAe,UAAU,IAAI;AACjC,SAAI,aAAa,QAAQ,aAAa,MAAM,aAAa,IACvD;AAIF,SAFe,cAAc,SAAS,CAE3B,OACT,SAAQ,OAAO;MACb,MAAM,UAAU;MAChB,WAAW;MACZ,CAAC;;;;AAMV,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAGvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}

package/dist/rules/require-default-state.js

@@ -8,7 +8,7 @@ var require_default_state_default = createRule({
 	meta: {
 		type: "suggestion",
 		docs: { description: "Warn when a state mapping object doesn't have a default ('') key" },
-		messages: { missingDefaultState: "State mapping for '{{property}}' has no default ('') value." },
+		messages: { missingDefaultState: "State mapping for '{{property}}' has no default ('') or fallback floor ('_') value." },
 		schema: []
 	},
 	defaultOptions: [],
@@ -25,8 +25,9 @@ var require_default_state_default = createRule({
 				if (/^[A-Z@&$#]/.test(key)) continue;
 				if (prop.value.type !== "ObjectExpression") continue;
 				if (!prop.value.properties.some((p) => {
-					if (p.type !== "Property") return false;
-					return (p.key.type === "Literal" ? p.key.value : null) === "";
+					if (p.type !== "Property" || p.computed) return false;
+					const stateKey = getKeyName(p.key);
+					return stateKey === "" || stateKey === "_";
 				})) context.report({
 					node: prop.value,
 					messageId: "missingDefaultState",

package/dist/rules/require-default-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"require-default-state.js","names":[],"sources":["../../src/rules/require-default-state.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport { getKeyName } from '../utils.js';\n\ntype MessageIds = 'missingDefaultState';\n\nexport default createRule<[], MessageIds>({\n  name: 'require-default-state',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        \"Warn when a state mapping object doesn't have a default ('') key\",\n    },\n    messages: {\n      missingDefaultState:\n        \"State mapping for '{{property}}' has no default ('') value.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    function handleStyleObject(node: TSESTree.ObjectExpression) {\n      const styleCtx = ctx.getStyleContext(node);\n      if (!styleCtx) return;\n\n      // Skip if extending (omitting '' is intentional)\n      if (styleCtx.isExtending) return;\n\n      for (const prop of node.properties) {\n        if (prop.type !== 'Property' || prop.computed) continue;\n\n        const key = getKeyName(prop.key);\n        if (key === null) continue;\n\n        // Skip sub-elements and special keys\n        if (/^[A-Z@&$#]/.test(key)) continue;\n\n        if (prop.value.type !== 'ObjectExpression') continue;\n\n        // Check if this object has a '' key\n        const hasDefault = prop.value.properties.some((p) => {\n          if (p.type !== 'Property') return false;\n          const stateKey = p.key.type === 'Literal' ? p.key.value : null;\n          return stateKey === '';\n        });\n\n        if (!hasDefault) {\n          context.report({\n            node: prop.value,\n            messageId: 'missingDefaultState',\n            data: { property: key },\n          });\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;AAOA,oCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,oEACH;EACD,UAAU,EACR,qBACE,+DACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,SAAS,kBAAkB,MAAiC;GAC1D,MAAM,WAAW,IAAI,gBAAgB,KAAK;AAC1C,OAAI,CAAC,SAAU;AAGf,OAAI,SAAS,YAAa;AAE1B,QAAK,MAAM,QAAQ,KAAK,YAAY;AAClC,QAAI,KAAK,SAAS,cAAc,KAAK,SAAU;IAE/C,MAAM,MAAM,WAAW,KAAK,IAAI;AAChC,QAAI,QAAQ,KAAM;AAGlB,QAAI,aAAa,KAAK,IAAI,CAAE;AAE5B,QAAI,KAAK,MAAM,SAAS,mBAAoB;AAS5C,QAAI,CANe,KAAK,MAAM,WAAW,MAAM,MAAM;AACnD,SAAI,EAAE,SAAS,WAAY,QAAO;AAElC,aADiB,EAAE,IAAI,SAAS,YAAY,EAAE,IAAI,QAAQ,UACtC;MACpB,CAGA,SAAQ,OAAO;KACb,MAAM,KAAK;KACX,WAAW;KACX,MAAM,EAAE,UAAU,KAAK;KACxB,CAAC;;;AAKR,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAEvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}
+{"version":3,"file":"require-default-state.js","names":[],"sources":["../../src/rules/require-default-state.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport { getKeyName } from '../utils.js';\n\ntype MessageIds = 'missingDefaultState';\n\nexport default createRule<[], MessageIds>({\n  name: 'require-default-state',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        \"Warn when a state mapping object doesn't have a default ('') key\",\n    },\n    messages: {\n      missingDefaultState:\n        \"State mapping for '{{property}}' has no default ('') or fallback floor ('_') value.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    function handleStyleObject(node: TSESTree.ObjectExpression) {\n      const styleCtx = ctx.getStyleContext(node);\n      if (!styleCtx) return;\n\n      // Skip if extending (omitting '' is intentional)\n      if (styleCtx.isExtending) return;\n\n      for (const prop of node.properties) {\n        if (prop.type !== 'Property' || prop.computed) continue;\n\n        const key = getKeyName(prop.key);\n        if (key === null) continue;\n\n        // Skip sub-elements and special keys\n        if (/^[A-Z@&$#]/.test(key)) continue;\n\n        if (prop.value.type !== 'ObjectExpression') continue;\n\n        // A '' default or a '_' fallback floor both provide a value in the\n        // normal state, so either one satisfies the requirement.\n        const hasDefault = prop.value.properties.some((p) => {\n          if (p.type !== 'Property' || p.computed) return false;\n          const stateKey = getKeyName(p.key);\n          return stateKey === '' || stateKey === '_';\n        });\n\n        if (!hasDefault) {\n          context.report({\n            node: prop.value,\n            messageId: 'missingDefaultState',\n            data: { property: key },\n          });\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;AAOA,oCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,oEACH;EACD,UAAU,EACR,qBACE,uFACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,SAAS,kBAAkB,MAAiC;GAC1D,MAAM,WAAW,IAAI,gBAAgB,KAAK;AAC1C,OAAI,CAAC,SAAU;AAGf,OAAI,SAAS,YAAa;AAE1B,QAAK,MAAM,QAAQ,KAAK,YAAY;AAClC,QAAI,KAAK,SAAS,cAAc,KAAK,SAAU;IAE/C,MAAM,MAAM,WAAW,KAAK,IAAI;AAChC,QAAI,QAAQ,KAAM;AAGlB,QAAI,aAAa,KAAK,IAAI,CAAE;AAE5B,QAAI,KAAK,MAAM,SAAS,mBAAoB;AAU5C,QAAI,CANe,KAAK,MAAM,WAAW,MAAM,MAAM;AACnD,SAAI,EAAE,SAAS,cAAc,EAAE,SAAU,QAAO;KAChD,MAAM,WAAW,WAAW,EAAE,IAAI;AAClC,YAAO,aAAa,MAAM,aAAa;MACvC,CAGA,SAAQ,OAAO;KACb,MAAM,KAAK;KACX,WAAW;KACX,MAAM,EAAE,UAAU,KAAK;KACxB,CAAC;;;AAKR,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAEvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}

package/dist/rules/valid-styles-structure.js

@@ -27,7 +27,7 @@ var valid_styles_structure_default = createRule({
 			/^\[/
 		];
 		function looksLikeStateKey(key) {
-			if (key === "") return true;
+			if (key === "" || key === "_") return true;
 			return STATE_KEY_PATTERNS.some((p) => p.test(key));
 		}
 		function handleStyleObject(node) {

package/dist/rules/valid-styles-structure.js.map

@@ -1 +1 @@
-{"version":3,"file":"valid-styles-structure.js","names":[],"sources":["../../src/rules/valid-styles-structure.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport { getKeyName, getStringValue } from '../utils.js';\n\ntype MessageIds =\n  | 'stateKeyAtTopLevel'\n  | 'invalidKeyframesStructure'\n  | 'invalidPropertiesStructure'\n  | 'invalidFontFaceStructure'\n  | 'invalidCounterStyleStructure'\n  | 'recipeNotString';\n\nexport default createRule<[], MessageIds>({\n  name: 'valid-styles-structure',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Validate overall structure of styles object passed to tasty APIs',\n    },\n    messages: {\n      stateKeyAtTopLevel:\n        \"State key '{{key}}' at top level is not valid. State maps belong inside property values, not at the root of the styles object.\",\n      invalidKeyframesStructure:\n        '@keyframes value must be an object of { name: { step: styles } }.',\n      invalidPropertiesStructure:\n        '@properties value must be an object of { name: { syntax, inherits, initialValue } }.',\n      invalidFontFaceStructure:\n        '@fontFace value must be an object of { familyName: descriptors | descriptors[] }.',\n      invalidCounterStyleStructure:\n        '@counterStyle value must be an object of { name: descriptors }.',\n      recipeNotString: \"'recipe' value must be a string.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    const STATE_KEY_PATTERNS = [\n      /^:/, // pseudo-class\n      /^\\./, // class selector\n      /^\\[/, // attribute selector\n    ];\n\n    function looksLikeStateKey(key: string): boolean {\n      if (key === '') return true;\n      return STATE_KEY_PATTERNS.some((p) => p.test(key));\n    }\n\n    function handleStyleObject(node: TSESTree.ObjectExpression) {\n      if (!ctx.isStyleObject(node)) return;\n\n      for (const prop of node.properties) {\n        if (prop.type !== 'Property' || prop.computed) continue;\n\n        const key = getKeyName(prop.key);\n        if (key === null) continue;\n\n        // Check for state keys at top level (common mistake)\n        if (looksLikeStateKey(key)) {\n          context.report({\n            node: prop.key,\n            messageId: 'stateKeyAtTopLevel',\n            data: { key },\n          });\n          continue;\n        }\n\n        // Validate @keyframes structure\n        if (key === '@keyframes') {\n          if (prop.value.type !== 'ObjectExpression') {\n            context.report({\n              node: prop.value,\n              messageId: 'invalidKeyframesStructure',\n            });\n          }\n          continue;\n        }\n\n        // Validate @properties structure\n        if (key === '@properties') {\n          if (prop.value.type !== 'ObjectExpression') {\n            context.report({\n              node: prop.value,\n              messageId: 'invalidPropertiesStructure',\n            });\n          }\n          continue;\n        }\n\n        // Validate @fontFace structure\n        if (key === '@fontFace') {\n          if (prop.value.type !== 'ObjectExpression') {\n            context.report({\n              node: prop.value,\n              messageId: 'invalidFontFaceStructure',\n            });\n          }\n          continue;\n        }\n\n        // Validate @counterStyle structure\n        if (key === '@counterStyle') {\n          if (prop.value.type !== 'ObjectExpression') {\n            context.report({\n              node: prop.value,\n              messageId: 'invalidCounterStyleStructure',\n            });\n          }\n          continue;\n        }\n\n        // Validate recipe is a string\n        if (key === 'recipe') {\n          const str = getStringValue(prop.value);\n          if (str === null && prop.value.type !== 'Literal') {\n            // Allow string literals, template literals without expressions\n            if (\n              prop.value.type !== 'TemplateLiteral' ||\n              prop.value.expressions.length > 0\n            ) {\n              context.report({\n                node: prop.value,\n                messageId: 'recipeNotString',\n              });\n            }\n          }\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;AAaA,qCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,oEACH;EACD,UAAU;GACR,oBACE;GACF,2BACE;GACF,4BACE;GACF,0BACE;GACF,8BACE;GACF,iBAAiB;GAClB;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,MAAM,qBAAqB;GACzB;GACA;GACA;GACD;EAED,SAAS,kBAAkB,KAAsB;AAC/C,OAAI,QAAQ,GAAI,QAAO;AACvB,UAAO,mBAAmB,MAAM,MAAM,EAAE,KAAK,IAAI,CAAC;;EAGpD,SAAS,kBAAkB,MAAiC;AAC1D,OAAI,CAAC,IAAI,cAAc,KAAK,CAAE;AAE9B,QAAK,MAAM,QAAQ,KAAK,YAAY;AAClC,QAAI,KAAK,SAAS,cAAc,KAAK,SAAU;IAE/C,MAAM,MAAM,WAAW,KAAK,IAAI;AAChC,QAAI,QAAQ,KAAM;AAGlB,QAAI,kBAAkB,IAAI,EAAE;AAC1B,aAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACX,MAAM,EAAE,KAAK;MACd,CAAC;AACF;;AAIF,QAAI,QAAQ,cAAc;AACxB,SAAI,KAAK,MAAM,SAAS,mBACtB,SAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACZ,CAAC;AAEJ;;AAIF,QAAI,QAAQ,eAAe;AACzB,SAAI,KAAK,MAAM,SAAS,mBACtB,SAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACZ,CAAC;AAEJ;;AAIF,QAAI,QAAQ,aAAa;AACvB,SAAI,KAAK,MAAM,SAAS,mBACtB,SAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACZ,CAAC;AAEJ;;AAIF,QAAI,QAAQ,iBAAiB;AAC3B,SAAI,KAAK,MAAM,SAAS,mBACtB,SAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACZ,CAAC;AAEJ;;AAIF,QAAI,QAAQ,UAEV;SADY,eAAe,KAAK,MAAM,KAC1B,QAAQ,KAAK,MAAM,SAAS,WAEtC;UACE,KAAK,MAAM,SAAS,qBACpB,KAAK,MAAM,YAAY,SAAS,EAEhC,SAAQ,OAAO;OACb,MAAM,KAAK;OACX,WAAW;OACZ,CAAC;;;;;AAOZ,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAGvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}
+{"version":3,"file":"valid-styles-structure.js","names":[],"sources":["../../src/rules/valid-styles-structure.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport { getKeyName, getStringValue } from '../utils.js';\n\ntype MessageIds =\n  | 'stateKeyAtTopLevel'\n  | 'invalidKeyframesStructure'\n  | 'invalidPropertiesStructure'\n  | 'invalidFontFaceStructure'\n  | 'invalidCounterStyleStructure'\n  | 'recipeNotString';\n\nexport default createRule<[], MessageIds>({\n  name: 'valid-styles-structure',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Validate overall structure of styles object passed to tasty APIs',\n    },\n    messages: {\n      stateKeyAtTopLevel:\n        \"State key '{{key}}' at top level is not valid. State maps belong inside property values, not at the root of the styles object.\",\n      invalidKeyframesStructure:\n        '@keyframes value must be an object of { name: { step: styles } }.',\n      invalidPropertiesStructure:\n        '@properties value must be an object of { name: { syntax, inherits, initialValue } }.',\n      invalidFontFaceStructure:\n        '@fontFace value must be an object of { familyName: descriptors | descriptors[] }.',\n      invalidCounterStyleStructure:\n        '@counterStyle value must be an object of { name: descriptors }.',\n      recipeNotString: \"'recipe' value must be a string.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    const STATE_KEY_PATTERNS = [\n      /^:/, // pseudo-class\n      /^\\./, // class selector\n      /^\\[/, // attribute selector\n    ];\n\n    function looksLikeStateKey(key: string): boolean {\n      // '' default and '_' fallback floor are state-map keys, never top-level.\n      if (key === '' || key === '_') return true;\n      return STATE_KEY_PATTERNS.some((p) => p.test(key));\n    }\n\n    function handleStyleObject(node: TSESTree.ObjectExpression) {\n      if (!ctx.isStyleObject(node)) return;\n\n      for (const prop of node.properties) {\n        if (prop.type !== 'Property' || prop.computed) continue;\n\n        const key = getKeyName(prop.key);\n        if (key === null) continue;\n\n        // Check for state keys at top level (common mistake)\n        if (looksLikeStateKey(key)) {\n          context.report({\n            node: prop.key,\n            messageId: 'stateKeyAtTopLevel',\n            data: { key },\n          });\n          continue;\n        }\n\n        // Validate @keyframes structure\n        if (key === '@keyframes') {\n          if (prop.value.type !== 'ObjectExpression') {\n            context.report({\n              node: prop.value,\n              messageId: 'invalidKeyframesStructure',\n            });\n          }\n          continue;\n        }\n\n        // Validate @properties structure\n        if (key === '@properties') {\n          if (prop.value.type !== 'ObjectExpression') {\n            context.report({\n              node: prop.value,\n              messageId: 'invalidPropertiesStructure',\n            });\n          }\n          continue;\n        }\n\n        // Validate @fontFace structure\n        if (key === '@fontFace') {\n          if (prop.value.type !== 'ObjectExpression') {\n            context.report({\n              node: prop.value,\n              messageId: 'invalidFontFaceStructure',\n            });\n          }\n          continue;\n        }\n\n        // Validate @counterStyle structure\n        if (key === '@counterStyle') {\n          if (prop.value.type !== 'ObjectExpression') {\n            context.report({\n              node: prop.value,\n              messageId: 'invalidCounterStyleStructure',\n            });\n          }\n          continue;\n        }\n\n        // Validate recipe is a string\n        if (key === 'recipe') {\n          const str = getStringValue(prop.value);\n          if (str === null && prop.value.type !== 'Literal') {\n            // Allow string literals, template literals without expressions\n            if (\n              prop.value.type !== 'TemplateLiteral' ||\n              prop.value.expressions.length > 0\n            ) {\n              context.report({\n                node: prop.value,\n                messageId: 'recipeNotString',\n              });\n            }\n          }\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;AAaA,qCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,oEACH;EACD,UAAU;GACR,oBACE;GACF,2BACE;GACF,4BACE;GACF,0BACE;GACF,8BACE;GACF,iBAAiB;GAClB;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,MAAM,qBAAqB;GACzB;GACA;GACA;GACD;EAED,SAAS,kBAAkB,KAAsB;AAE/C,OAAI,QAAQ,MAAM,QAAQ,IAAK,QAAO;AACtC,UAAO,mBAAmB,MAAM,MAAM,EAAE,KAAK,IAAI,CAAC;;EAGpD,SAAS,kBAAkB,MAAiC;AAC1D,OAAI,CAAC,IAAI,cAAc,KAAK,CAAE;AAE9B,QAAK,MAAM,QAAQ,KAAK,YAAY;AAClC,QAAI,KAAK,SAAS,cAAc,KAAK,SAAU;IAE/C,MAAM,MAAM,WAAW,KAAK,IAAI;AAChC,QAAI,QAAQ,KAAM;AAGlB,QAAI,kBAAkB,IAAI,EAAE;AAC1B,aAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACX,MAAM,EAAE,KAAK;MACd,CAAC;AACF;;AAIF,QAAI,QAAQ,cAAc;AACxB,SAAI,KAAK,MAAM,SAAS,mBACtB,SAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACZ,CAAC;AAEJ;;AAIF,QAAI,QAAQ,eAAe;AACzB,SAAI,KAAK,MAAM,SAAS,mBACtB,SAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACZ,CAAC;AAEJ;;AAIF,QAAI,QAAQ,aAAa;AACvB,SAAI,KAAK,MAAM,SAAS,mBACtB,SAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACZ,CAAC;AAEJ;;AAIF,QAAI,QAAQ,iBAAiB;AAC3B,SAAI,KAAK,MAAM,SAAS,mBACtB,SAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACZ,CAAC;AAEJ;;AAIF,QAAI,QAAQ,UAEV;SADY,eAAe,KAAK,MAAM,KAC1B,QAAQ,KAAK,MAAM,SAAS,WAEtC;UACE,KAAK,MAAM,SAAS,qBACpB,KAAK,MAAM,YAAY,SAAS,EAEhC,SAAQ,OAAO;OACb,MAAM,KAAK;OACX,WAAW;OACZ,CAAC;;;;;AAOZ,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAGvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenphi/eslint-plugin-tasty",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "description": "ESLint plugin for validating tasty() and tastyStatic() style objects",
   "type": "module",
   "exports": {