@tenphi/eslint-plugin-tasty 1.0.1 → 1.0.3

package/dist/context.js

@@ -1,4 +1,4 @@
-import { DEFAULT_IMPORT_SOURCES, SPECIAL_STYLE_KEYS } from "./constants.js";
+import { DEFAULT_IMPORT_SOURCES, KNOWN_CSS_PROPERTIES, KNOWN_TASTY_PROPERTIES, SPECIAL_STYLE_KEYS } from "./constants.js";
 import { loadConfig } from "./config.js";
 import { getKeyName } from "./utils.js";
 
@@ -30,6 +30,66 @@ function styleObjectListeners(handler) {
 	for (const selector of STYLE_OBJECT_SELECTORS) listeners[selector] = once;
 	return listeners;
 }
+/**
+* Whether a type annotation names tasty's `Styles` anywhere inside it.
+*
+* Walks the annotation rather than matching only the outermost reference, so a
+* wrapped tasty type (`Styles | undefined`, `Record<string, Styles>`,
+* `{ root: Styles }`) is recognised while `CSSProperties` in the same positions is
+* not. Deliberately name-based: the plugin has no type checker, and requiring one
+* would make every rule type-aware.
+*/
+function referencesStylesType(node) {
+	const stack = [node];
+	while (stack.length) {
+		const current = stack.pop();
+		if (current.type === "TSTypeReference" && current.typeName.type === "Identifier" && /^Styles$/i.test(current.typeName.name)) return true;
+		for (const value of Object.values(current)) if (Array.isArray(value)) {
+			for (const item of value) if (item && typeof item === "object" && "type" in item) stack.push(item);
+		} else if (value && typeof value === "object" && "type" in value) {
+			if (value !== current.parent) stack.push(value);
+		}
+	}
+	return false;
+}
+/**
+* Whether a key could plausibly be a tasty style key.
+*
+* Covers every top-level shape tasty accepts: a style property, a sub-element
+* (capitalised), an at-rule or state/custom-property/colour key (`@`, `&`, `$`,
+* `#`), and the default-state key.
+*/
+function isPlausibleStyleKey(key) {
+	if (key === "" || key === "_") return true;
+	if (/^[A-Z]/.test(key)) return true;
+	if (/^[@&$#]/.test(key)) return true;
+	if (SPECIAL_STYLE_KEYS.has(key)) return true;
+	return KNOWN_TASTY_PROPERTIES.has(key) || KNOWN_CSS_PROPERTIES.has(key);
+}
+/**
+* Whether an object is a map of named CSS blocks rather than a tasty styles object.
+*
+* The shape is unmistakable — `{ table: {…}, th: {…}, td: {…} }`, `{ root: {…},
+* toolbar: {…} }` — and it is what a React inline-style map looks like when it
+* carries no type annotation to opt it out. Every key is a block name that is not a
+* style key, and every value is an object.
+*
+* Requiring *every* value to be an object literal is what keeps this from swallowing
+* the case it would hurt most: `const styles = { colour: 'red' }` has a string value,
+* so it is not treated as a block map and `known-property` still reports the typo.
+* Otherwise the rule that catches a misspelled property would be silenced by the
+* misspelling.
+*/
+function isNamedCssBlockMap(node) {
+	if (node.properties.length === 0) return false;
+	for (const prop of node.properties) {
+		if (prop.type !== "Property" || prop.computed) return false;
+		const key = getKeyName(prop.key);
+		if (key === null || isPlausibleStyleKey(key)) return false;
+		if (prop.value.type !== "ObjectExpression") return false;
+	}
+	return true;
+}
 const TASTY_FUNCTION_NAMES = new Set([
 	"tasty",
 	"tastyStatic",
@@ -138,15 +198,25 @@ var TastyContext = class {
 		if (init !== targetNode) return false;
 		const name = current.id.name;
 		if (/^[A-Z][A-Z0-9_]*$/.test(name)) return false;
-		if (name === "styles" || name.endsWith("Styles")) return true;
-		if (this.hasStylesTypeAnnotation(current)) return true;
+		const annotated = this.stylesTypeAnnotation(current);
+		if (annotated !== null) return annotated;
+		if (name === "styles" || name.endsWith("Styles")) return !(targetNode.type === "ObjectExpression" && isNamedCssBlockMap(targetNode));
 		return false;
 	}
-	hasStylesTypeAnnotation(node) {
+	/**
+	* Verdict from the declared type: `true` tasty, `false` explicitly not, `null`
+	* when there is no annotation to go on and the caller should fall back to the
+	* name.
+	*
+	* A `Styles` reference anywhere in the annotation counts, so wrappers like
+	* `Styles | undefined` and `Record<string, Styles>` opt in — while
+	* `CSSProperties`, `Record<string, CSSProperties>` and an inline literal of
+	* them opt out.
+	*/
+	stylesTypeAnnotation(node) {
 		const annotation = node.id.typeAnnotation?.typeAnnotation;
-		if (!annotation) return false;
-		if (annotation.type === "TSTypeReference" && annotation.typeName.type === "Identifier") return /^Styles$/i.test(annotation.typeName.name);
-		return false;
+		if (!annotation) return null;
+		return referencesStylesType(annotation);
 	}
 	getTastyCallContext(call, targetNode) {
 		const args = call.arguments;

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, SPECIAL_STYLE_KEYS } 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  // `<Block styles={{…}} />`. Safe to match on the prop name alone: React's own\n  // prop is `style`, singular, so a plural `styles` JSX prop is a Tasty\n  // convention.\n  \"JSXAttribute[name.name='styles'] > JSXExpressionContainer > ObjectExpression\",\n  // A Storybook story's `args.styles`. Deliberately this specific rather than\n  // matching any `styles` key: plenty of unrelated libraries take a `styles`\n  // option object, and a bare key carries no evidence it is Tasty's. Story files\n  // are where a lot of style code is authored and neither the call-site nor the\n  // variable-name heuristic reaches them — the enclosing variable is named after\n  // the story, and there is no Tasty call.\n  // Superset of the `args.styles` shape; `isStylesPropertyValue` is the real\n  // gate, so both `styles` and `'styles'` key forms are covered.\n  'Property > ObjectExpression > Property > 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\n  // Selectors overlap — `tasty({ styles: {…} })` matches both\n  // `CallExpression ObjectExpression` and the `styles` key selector — so the\n  // handler must run at most once per object, or every rule double-reports.\n  const visited = new WeakSet<TSESTree.ObjectExpression>();\n  const once = (node: TSESTree.ObjectExpression) => {\n    if (visited.has(node)) return;\n    visited.add(node);\n    handler(node);\n  };\n\n  for (const selector of STYLE_OBJECT_SELECTORS) {\n    listeners[selector] = once;\n  }\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    // An object assigned to a `styles` key (or a `styles` JSX prop) is a style\n    // object on its own terms — no enclosing tasty call or `styles`-ish variable\n    // name required. Checked before the walk, which would otherwise climb past it\n    // to an unrelated call or declaration and reject the whole thing.\n    if (node.type === 'ObjectExpression' && this.isStylesPropertyValue(node)) {\n      return {\n        type: 'tasty',\n        isStaticCall: false,\n        isSelectorMode: false,\n        isExtending: false,\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    // Only `styles` and `*Styles` count. The singular `style` is conventionally\n    // a DOM inline-style object (`el.style`, `CSSProperties`, `setStyle(el, …)`)\n    // holding raw CSS longhands, not tasty syntax — matching it reported those\n    // longhands as tasty violations. A `Styles` type annotation still opts a\n    // differently-named variable in, below.\n    if (name === 'styles' || name.endsWith('Styles')) 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   * Whether this object is a `styles` JSX prop value or a Storybook `args.styles`.\n   *\n   * Both are unambiguous enough to stand on their own without an import-tracked\n   * call or a `styles`-ish variable name. A bare `styles` key elsewhere is not —\n   * see the selector list for why.\n   */\n  isStylesPropertyValue(node: TSESTree.ObjectExpression): boolean {\n    const parent = node.parent;\n\n    if (parent?.type === 'Property' && !parent.computed) {\n      if (getKeyName(parent.key) !== 'styles') return false;\n\n      // Only inside `args: { … }`.\n      const argsObject = parent.parent;\n      const argsProperty =\n        argsObject?.type === 'ObjectExpression' ? argsObject.parent : undefined;\n\n      return (\n        argsProperty?.type === 'Property' &&\n        !argsProperty.computed &&\n        getKeyName(argsProperty.key) === 'args'\n      );\n    }\n\n    if (parent?.type === 'JSXExpressionContainer') {\n      const attribute = parent.parent;\n\n      return (\n        attribute?.type === 'JSXAttribute' &&\n        attribute.name.type === 'JSXIdentifier' &&\n        attribute.name.name === 'styles'\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    // At-rule blocks are not state maps — their object values are descriptor maps.\n    if (SPECIAL_STYLE_KEYS.has(keyName)) 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, @property, ...).\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 {\n  DEFAULT_IMPORT_SOURCES,\n  KNOWN_CSS_PROPERTIES,\n  KNOWN_TASTY_PROPERTIES,\n  SPECIAL_STYLE_KEYS,\n} 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  // `<Block styles={{…}} />`. Safe to match on the prop name alone: React's own\n  // prop is `style`, singular, so a plural `styles` JSX prop is a Tasty\n  // convention.\n  \"JSXAttribute[name.name='styles'] > JSXExpressionContainer > ObjectExpression\",\n  // A Storybook story's `args.styles`. Deliberately this specific rather than\n  // matching any `styles` key: plenty of unrelated libraries take a `styles`\n  // option object, and a bare key carries no evidence it is Tasty's. Story files\n  // are where a lot of style code is authored and neither the call-site nor the\n  // variable-name heuristic reaches them — the enclosing variable is named after\n  // the story, and there is no Tasty call.\n  // Superset of the `args.styles` shape; `isStylesPropertyValue` is the real\n  // gate, so both `styles` and `'styles'` key forms are covered.\n  'Property > ObjectExpression > Property > 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\n  // Selectors overlap — `tasty({ styles: {…} })` matches both\n  // `CallExpression ObjectExpression` and the `styles` key selector — so the\n  // handler must run at most once per object, or every rule double-reports.\n  const visited = new WeakSet<TSESTree.ObjectExpression>();\n  const once = (node: TSESTree.ObjectExpression) => {\n    if (visited.has(node)) return;\n    visited.add(node);\n    handler(node);\n  };\n\n  for (const selector of STYLE_OBJECT_SELECTORS) {\n    listeners[selector] = once;\n  }\n\n  return listeners;\n}\n\nexport interface TastyImport {\n  localName: string;\n  importedName: string;\n  source: string;\n}\n\n/**\n * Whether a type annotation names tasty's `Styles` anywhere inside it.\n *\n * Walks the annotation rather than matching only the outermost reference, so a\n * wrapped tasty type (`Styles | undefined`, `Record<string, Styles>`,\n * `{ root: Styles }`) is recognised while `CSSProperties` in the same positions is\n * not. Deliberately name-based: the plugin has no type checker, and requiring one\n * would make every rule type-aware.\n */\nfunction referencesStylesType(node: TSESTree.TypeNode): boolean {\n  const stack: TSESTree.Node[] = [node];\n\n  while (stack.length) {\n    const current = stack.pop()!;\n\n    if (\n      current.type === 'TSTypeReference' &&\n      current.typeName.type === 'Identifier' &&\n      /^Styles$/i.test(current.typeName.name)\n    ) {\n      return true;\n    }\n\n    for (const value of Object.values(\n      current as unknown as Record<string, unknown>,\n    )) {\n      if (Array.isArray(value)) {\n        for (const item of value) {\n          if (item && typeof item === 'object' && 'type' in item) {\n            stack.push(item as TSESTree.Node);\n          }\n        }\n      } else if (value && typeof value === 'object' && 'type' in value) {\n        // Skip `parent` — it points back up the tree and would loop forever.\n        if (value !== (current as TSESTree.Node).parent) {\n          stack.push(value as TSESTree.Node);\n        }\n      }\n    }\n  }\n\n  return false;\n}\n\n/**\n * Whether a key could plausibly be a tasty style key.\n *\n * Covers every top-level shape tasty accepts: a style property, a sub-element\n * (capitalised), an at-rule or state/custom-property/colour key (`@`, `&`, `$`,\n * `#`), and the default-state key.\n */\nfunction isPlausibleStyleKey(key: string): boolean {\n  if (key === '' || key === '_') return true;\n  if (/^[A-Z]/.test(key)) return true;\n  if (/^[@&$#]/.test(key)) return true;\n  if (SPECIAL_STYLE_KEYS.has(key)) return true;\n\n  return KNOWN_TASTY_PROPERTIES.has(key) || KNOWN_CSS_PROPERTIES.has(key);\n}\n\n/**\n * Whether an object is a map of named CSS blocks rather than a tasty styles object.\n *\n * The shape is unmistakable — `{ table: {…}, th: {…}, td: {…} }`, `{ root: {…},\n * toolbar: {…} }` — and it is what a React inline-style map looks like when it\n * carries no type annotation to opt it out. Every key is a block name that is not a\n * style key, and every value is an object.\n *\n * Requiring *every* value to be an object literal is what keeps this from swallowing\n * the case it would hurt most: `const styles = { colour: 'red' }` has a string value,\n * so it is not treated as a block map and `known-property` still reports the typo.\n * Otherwise the rule that catches a misspelled property would be silenced by the\n * misspelling.\n */\nfunction isNamedCssBlockMap(node: TSESTree.ObjectExpression): boolean {\n  if (node.properties.length === 0) return false;\n\n  for (const prop of node.properties) {\n    if (prop.type !== 'Property' || prop.computed) return false;\n\n    const key = getKeyName(prop.key);\n\n    if (key === null || isPlausibleStyleKey(key)) return false;\n    if (prop.value.type !== 'ObjectExpression') return false;\n  }\n\n  return true;\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    // An object assigned to a `styles` key (or a `styles` JSX prop) is a style\n    // object on its own terms — no enclosing tasty call or `styles`-ish variable\n    // name required. Checked before the walk, which would otherwise climb past it\n    // to an unrelated call or declaration and reject the whole thing.\n    if (node.type === 'ObjectExpression' && this.isStylesPropertyValue(node)) {\n      return {\n        type: 'tasty',\n        isStaticCall: false,\n        isSelectorMode: false,\n        isExtending: false,\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    // An explicit type annotation is authoritative, in both directions. The name\n    // heuristic below is a guess; a declared type is the author stating what the\n    // object is, so it wins.\n    //\n    // This matters because the rewrites these rules offer are only valid *inside*\n    // tasty: `#purple.05` and `$font-sans` are correct tasty declarations and\n    // meaningless as raw CSS. A `const styles: Record<string, CSSProperties>`\n    // handed to React's `style={…}` was matched on name alone, so its plain CSS\n    // longhands were reported as tasty violations — and `--fix` rewrote real\n    // `var(--shadow-sm-color)` to `#shadow-sm`, which nothing resolves there, so\n    // the browser dropped the declaration.\n    const annotated = this.stylesTypeAnnotation(current);\n\n    if (annotated !== null) return annotated;\n\n    // Only `styles` and `*Styles` count. The singular `style` is conventionally\n    // a DOM inline-style object (`el.style`, `CSSProperties`, `setStyle(el, …)`)\n    // holding raw CSS longhands, not tasty syntax — matching it reported those\n    // longhands as tasty violations.\n    if (name === 'styles' || name.endsWith('Styles')) {\n      // The name is the weakest evidence there is, so let an unmistakable shape\n      // overrule it. Without an annotation to go on, a map of named CSS blocks was\n      // reported as tasty — `known-property` on every HTML tag name, each block read\n      // as a state map — and `--fix` offered rewrites that are only valid inside\n      // tasty.\n      return !(\n        targetNode.type === 'ObjectExpression' && isNamedCssBlockMap(targetNode)\n      );\n    }\n\n    return false;\n  }\n\n  /**\n   * Verdict from the declared type: `true` tasty, `false` explicitly not, `null`\n   * when there is no annotation to go on and the caller should fall back to the\n   * name.\n   *\n   * A `Styles` reference anywhere in the annotation counts, so wrappers like\n   * `Styles | undefined` and `Record<string, Styles>` opt in — while\n   * `CSSProperties`, `Record<string, CSSProperties>` and an inline literal of\n   * them opt out.\n   */\n  private stylesTypeAnnotation(\n    node: TSESTree.VariableDeclarator,\n  ): boolean | null {\n    const annotation = node.id.typeAnnotation?.typeAnnotation;\n\n    if (!annotation) return null;\n\n    return referencesStylesType(annotation);\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   * Whether this object is a `styles` JSX prop value or a Storybook `args.styles`.\n   *\n   * Both are unambiguous enough to stand on their own without an import-tracked\n   * call or a `styles`-ish variable name. A bare `styles` key elsewhere is not —\n   * see the selector list for why.\n   */\n  isStylesPropertyValue(node: TSESTree.ObjectExpression): boolean {\n    const parent = node.parent;\n\n    if (parent?.type === 'Property' && !parent.computed) {\n      if (getKeyName(parent.key) !== 'styles') return false;\n\n      // Only inside `args: { … }`.\n      const argsObject = parent.parent;\n      const argsProperty =\n        argsObject?.type === 'ObjectExpression' ? argsObject.parent : undefined;\n\n      return (\n        argsProperty?.type === 'Property' &&\n        !argsProperty.computed &&\n        getKeyName(argsProperty.key) === 'args'\n      );\n    }\n\n    if (parent?.type === 'JSXExpressionContainer') {\n      const attribute = parent.parent;\n\n      return (\n        attribute?.type === 'JSXAttribute' &&\n        attribute.name.type === 'JSXIdentifier' &&\n        attribute.name.name === 'styles'\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    // At-rule blocks are not state maps — their object values are descriptor maps.\n    if (SPECIAL_STYLE_KEYS.has(keyName)) 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, @property, ...).\n   */\n  isSpecialKey(key: string): boolean {\n    return key.startsWith('@');\n  }\n}\n"],"mappings":"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"}

package/package.json

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