@tenphi/eslint-plugin-tasty 1.0.5 → 1.1.0

package/dist/rules/no-raw-transition-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-raw-transition-duration.js","names":[],"sources":["../../src/rules/no-raw-transition-duration.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 { replaceInStringValue } from '../fix-utils.js';\n\ntype MessageIds =\n  | 'rawTransitionDuration'\n  | 'useDurationToken'\n  | 'useDefaultDuration';\n\n/**\n * A CSS time literal: `0.2s`, `200ms`, `.15s`, `0`.\n *\n * A bare `0` counts because it is a duration in the timing slot — and the one\n * spelling of \"no transition\" a design system would rather express as a state\n * than as a hardcoded zero.\n *\n * Deliberately narrow. `$fast-transition`, `var(--transition)`, `(0.2s * 2)`\n * and `calc(…)` all reach the same slot and none is a raw literal: the first\n * two are already tokens, and the arithmetic forms are somebody deriving a\n * duration from one, which is not what this rule is about. A unitless non-zero\n * (`fill 200`) is invalid CSS rather than a hardcoded token, so it is left to\n * `valid-value`.\n */\nconst TIME_LITERAL = /^(?:\\d*\\.?\\d+m?s|0)$/i;\n\n/**\n * A plausible transition name: a semantic name, a CSS property, or a `$$name` /\n * `##name` / `--name` custom-property reference.\n *\n * This is the guard that makes the naive comma split safe. A value can carry a\n * multi-argument easing — `transition: 'fill cubic-bezier(0.4, 0, 0.2, 1) 1s'`\n * — whose commas are not group separators, so the last \"group\" comes out as\n * `1) 1s`. Requiring the name slot to look like a name drops that fragment\n * instead of reporting a duration for a property called `1)`.\n */\nconst TRANSITION_NAME = /^(?:\\$\\$|##|--)?[a-zA-Z][\\w-]*$/;\n\n/**\n * Config `tokens` entries that name a duration.\n *\n * Tasty resolves an omitted duration to `var(--<name>-transition,\n * var(--transition))`, so `-transition` is the naming convention the runtime\n * itself imposes; `duration` is the other spelling design systems reach for.\n */\nconst DURATION_TOKEN = /(?:^\\$transition$|-transition$|duration)/i;\n\n/** The default timing tasty substitutes for a group whose duration is omitted. */\nfunction defaultTimingHint(name: string): string {\n  // A custom-property reference names no semantic group, so there is no\n  // per-name timing token to point at — only the global one.\n  if (!/^[a-zA-Z][\\w-]*$/.test(name)) return '$transition';\n\n  return `$${name}-transition (falling back to $transition)`;\n}\n\nexport default createRule<[], MessageIds>({\n  name: 'no-raw-transition-duration',\n  meta: {\n    type: 'suggestion',\n    hasSuggestions: true,\n    docs: {\n      description:\n        \"Suggest a duration token, or tasty's default timing, instead of a hardcoded transition duration\",\n    },\n    messages: {\n      rawTransitionDuration:\n        \"Transition duration '{{duration}}' is hardcoded. Use a duration token{{available}}, or omit it to inherit {{fallback}}.\",\n      useDurationToken: \"Replace '{{duration}}' with '{{token}}'\",\n      useDefaultDuration:\n        \"Remove '{{duration}}' to inherit the default transition timing\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    /** `$`-prefixed config tokens whose name reads as a duration. */\n    const durationTokens = Array.isArray(ctx.config.tokens)\n      ? ctx.config.tokens.filter(\n          (token) => token.startsWith('$') && DURATION_TOKEN.test(token),\n        )\n      : [];\n\n    function checkTransitionValue(value: string, node: TSESTree.Node): void {\n      let offset = 0;\n\n      for (const group of value.split(',')) {\n        const tokens = group.trim().split(/\\s+/).filter(Boolean);\n        const [name, timing] = tokens;\n\n        // Only the second token is inspected, which is exactly the slot tasty\n        // reads as the duration. A later time value is a *delay*\n        // (`fill ease-in 0.1s`), and the advice here would not hold for one:\n        // omitting a delay means \"no delay\", a real rendering change, whereas\n        // omitting a duration falls back to the design system's own timing.\n        if (\n          !name ||\n          !timing ||\n          !TRANSITION_NAME.test(name) ||\n          !TIME_LITERAL.test(timing)\n        ) {\n          offset += group.length + 1;\n          continue;\n        }\n\n        // Search from the end of the name so a duration that repeats the name's\n        // own text cannot match the wrong occurrence.\n        const nameEnd = group.indexOf(name) + name.length;\n        const startInGroup = group.indexOf(timing, nameEnd);\n        if (startInGroup === -1) {\n          offset += group.length + 1;\n          continue;\n        }\n\n        const start = offset + startInGroup;\n        const end = start + timing.length;\n        // Removal swallows the separating whitespace too, so dropping the\n        // duration does not leave `fill  ease-in` behind.\n        const removeStart = offset + nameEnd;\n\n        context.report({\n          node,\n          messageId: 'rawTransitionDuration',\n          data: {\n            duration: timing,\n            available: durationTokens.length\n              ? ` (${durationTokens.join(', ')})`\n              : '',\n            fallback: defaultTimingHint(name),\n          },\n          suggest: [\n            // Config tokens first: naming the project's own duration is better\n            // advice than deleting the author's intent, when one exists.\n            ...durationTokens.map((token) => ({\n              messageId: 'useDurationToken' as const,\n              data: { duration: timing, token },\n              fix: (fixer: Parameters<typeof replaceInStringValue>[0]) =>\n                replaceInStringValue(\n                  fixer,\n                  node,\n                  [{ start, end, replacement: token }],\n                  context.sourceCode,\n                ),\n            })),\n            {\n              messageId: 'useDefaultDuration' as const,\n              data: { duration: timing },\n              fix: (fixer: Parameters<typeof replaceInStringValue>[0]) =>\n                replaceInStringValue(\n                  fixer,\n                  node,\n                  [{ start: removeStart, end, replacement: '' }],\n                  context.sourceCode,\n                ),\n            },\n          ],\n        });\n\n        offset += group.length + 1;\n      }\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 !== 'transition') continue;\n\n        const str = getStringValue(prop.value);\n        if (str) {\n          checkTransitionValue(str, prop.value);\n          continue;\n        }\n\n        if (prop.value.type === 'ObjectExpression') {\n          for (const stateProp of prop.value.properties) {\n            if (stateProp.type !== 'Property') continue;\n            const stateStr = getStringValue(stateProp.value);\n            if (stateStr) {\n              checkTransitionValue(stateStr, stateProp.value);\n            }\n          }\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAyBA,MAAM,eAAe;;;;;;;;;;;AAYrB,MAAM,kBAAkB;;;;;;;;AASxB,MAAM,iBAAiB;;AAGvB,SAAS,kBAAkB,MAAsB;AAG/C,KAAI,CAAC,mBAAmB,KAAK,KAAK,CAAE,QAAO;AAE3C,QAAO,IAAI,KAAK;;AAGlB,yCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,gBAAgB;EAChB,MAAM,EACJ,aACE,mGACH;EACD,UAAU;GACR,uBACE;GACF,kBAAkB;GAClB,oBACE;GACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;;EAGrC,MAAM,iBAAiB,MAAM,QAAQ,IAAI,OAAO,OAAO,GACnD,IAAI,OAAO,OAAO,QACf,UAAU,MAAM,WAAW,IAAI,IAAI,eAAe,KAAK,MAAM,CAC/D,GACD,EAAE;EAEN,SAAS,qBAAqB,OAAe,MAA2B;GACtE,IAAI,SAAS;AAEb,QAAK,MAAM,SAAS,MAAM,MAAM,IAAI,EAAE;IAEpC,MAAM,CAAC,MAAM,UADE,MAAM,MAAM,CAAC,MAAM,MAAM,CAAC,OAAO,QAAQ;AAQxD,QACE,CAAC,QACD,CAAC,UACD,CAAC,gBAAgB,KAAK,KAAK,IAC3B,CAAC,aAAa,KAAK,OAAO,EAC1B;AACA,eAAU,MAAM,SAAS;AACzB;;IAKF,MAAM,UAAU,MAAM,QAAQ,KAAK,GAAG,KAAK;IAC3C,MAAM,eAAe,MAAM,QAAQ,QAAQ,QAAQ;AACnD,QAAI,iBAAiB,IAAI;AACvB,eAAU,MAAM,SAAS;AACzB;;IAGF,MAAM,QAAQ,SAAS;IACvB,MAAM,MAAM,QAAQ,OAAO;IAG3B,MAAM,cAAc,SAAS;AAE7B,YAAQ,OAAO;KACb;KACA,WAAW;KACX,MAAM;MACJ,UAAU;MACV,WAAW,eAAe,SACtB,KAAK,eAAe,KAAK,KAAK,CAAC,KAC/B;MACJ,UAAU,kBAAkB,KAAK;MAClC;KACD,SAAS,CAGP,GAAG,eAAe,KAAK,WAAW;MAChC,WAAW;MACX,MAAM;OAAE,UAAU;OAAQ;OAAO;MACjC,MAAM,UACJ,qBACE,OACA,MACA,CAAC;OAAE;OAAO;OAAK,aAAa;OAAO,CAAC,EACpC,QAAQ,WACT;MACJ,EAAE,EACH;MACE,WAAW;MACX,MAAM,EAAE,UAAU,QAAQ;MAC1B,MAAM,UACJ,qBACE,OACA,MACA,CAAC;OAAE,OAAO;OAAa;OAAK,aAAa;OAAI,CAAC,EAC9C,QAAQ,WACT;MACJ,CACF;KACF,CAAC;AAEF,cAAU,MAAM,SAAS;;;EAI7B,SAAS,kBAAkB,MAAiC;AAC1D,OAAI,CAAC,IAAI,cAAc,KAAK,CAAE;AAE9B,QAAK,MAAM,QAAQ,KAAK,YAAY;AAClC,QAAI,KAAK,SAAS,cAAc,KAAK,SAAU;AAG/C,QADY,WAAW,KAAK,IAAI,KACpB,aAAc;IAE1B,MAAM,MAAM,eAAe,KAAK,MAAM;AACtC,QAAI,KAAK;AACP,0BAAqB,KAAK,KAAK,MAAM;AACrC;;AAGF,QAAI,KAAK,MAAM,SAAS,mBACtB,MAAK,MAAM,aAAa,KAAK,MAAM,YAAY;AAC7C,SAAI,UAAU,SAAS,WAAY;KACnC,MAAM,WAAW,eAAe,UAAU,MAAM;AAChD,SAAI,SACF,sBAAqB,UAAU,UAAU,MAAM;;;;AAOzD,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAEvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}

package/dist/rules/no-unknown-state-alias.js

@@ -1,5 +1,5 @@
 import { createRule } from "../create-rule.js";
-import { collectLocalStateAliases, findRootStyleObject, getKeyName, getStringValue, isKnownStateAlias } from "../utils.js";
+import { collectLocalStateAliases, getKeyName, getStringValue, isKnownStateAlias } from "../utils.js";
 import { TastyContext, styleObjectListeners } from "../context.js";
 
 //#region src/rules/no-unknown-state-alias.ts
@@ -28,7 +28,7 @@ var no_unknown_state_alias_default = createRule({
 		}
 		function handleStyleObject(node) {
 			if (!ctx.isStyleObject(node)) return;
-			const localAliases = collectLocalStateAliases(findRootStyleObject(node));
+			const localAliases = collectLocalStateAliases(ctx.getRootStyleObject(node));
 			if (ctx.config.states.length === 0 && localAliases.length === 0) return;
 			for (const prop of node.properties) {
 				if (prop.type !== "Property" || prop.computed) continue;

package/dist/rules/no-unknown-state-alias.js.map

@@ -1 +1 @@
-{"version":3,"file":"no-unknown-state-alias.js","names":[],"sources":["../../src/rules/no-unknown-state-alias.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport {\n  getKeyName,\n  getStringValue,\n  isKnownStateAlias,\n  collectLocalStateAliases,\n  findRootStyleObject,\n} from '../utils.js';\n\ntype MessageIds = 'unknownAlias';\n\nexport default createRule<[], MessageIds>({\n  name: 'no-unknown-state-alias',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        \"Warn when a @name state alias is used that isn't in the config\",\n    },\n    messages: {\n      unknownAlias:\n        \"Unknown state alias '{{alias}}'. Add it to 'states' in your tasty config, or define it locally as a '@name' key.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    function checkStateKeys(\n      obj: TSESTree.ObjectExpression,\n      localAliases: string[],\n    ): void {\n      for (const prop of obj.properties) {\n        if (prop.type !== 'Property') continue;\n\n        const key = !prop.computed\n          ? getKeyName(prop.key)\n          : getStringValue(prop.key);\n        if (key === null || !key.startsWith('@')) continue;\n\n        if (\n          !isKnownStateAlias(key, ctx.config) &&\n          !localAliases.includes(key)\n        ) {\n          context.report({\n            node: prop.key,\n            messageId: 'unknownAlias',\n            data: { alias: key },\n          });\n        }\n      }\n    }\n\n    function handleStyleObject(node: TSESTree.ObjectExpression) {\n      if (!ctx.isStyleObject(node)) return;\n\n      const rootObj = findRootStyleObject(node);\n      const localAliases = collectLocalStateAliases(rootObj);\n\n      // Skip if no states configured and no local aliases\n      if (ctx.config.states.length === 0 && localAliases.length === 0) return;\n\n      for (const prop of node.properties) {\n        if (prop.type !== 'Property' || prop.computed) continue;\n\n        // Skip sub-elements and special keys\n        const key = getKeyName(prop.key);\n        if (key === null || /^[A-Z@&]/.test(key)) continue;\n\n        // Check state map objects for unknown aliases\n        if (prop.value.type === 'ObjectExpression') {\n          checkStateKeys(prop.value, localAliases);\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;AAaA,qCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,kEACH;EACD,UAAU,EACR,cACE,oHACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,SAAS,eACP,KACA,cACM;AACN,QAAK,MAAM,QAAQ,IAAI,YAAY;AACjC,QAAI,KAAK,SAAS,WAAY;IAE9B,MAAM,MAAM,CAAC,KAAK,WACd,WAAW,KAAK,IAAI,GACpB,eAAe,KAAK,IAAI;AAC5B,QAAI,QAAQ,QAAQ,CAAC,IAAI,WAAW,IAAI,CAAE;AAE1C,QACE,CAAC,kBAAkB,KAAK,IAAI,OAAO,IACnC,CAAC,aAAa,SAAS,IAAI,CAE3B,SAAQ,OAAO;KACb,MAAM,KAAK;KACX,WAAW;KACX,MAAM,EAAE,OAAO,KAAK;KACrB,CAAC;;;EAKR,SAAS,kBAAkB,MAAiC;AAC1D,OAAI,CAAC,IAAI,cAAc,KAAK,CAAE;GAG9B,MAAM,eAAe,yBADL,oBAAoB,KAAK,CACa;AAGtD,OAAI,IAAI,OAAO,OAAO,WAAW,KAAK,aAAa,WAAW,EAAG;AAEjE,QAAK,MAAM,QAAQ,KAAK,YAAY;AAClC,QAAI,KAAK,SAAS,cAAc,KAAK,SAAU;IAG/C,MAAM,MAAM,WAAW,KAAK,IAAI;AAChC,QAAI,QAAQ,QAAQ,WAAW,KAAK,IAAI,CAAE;AAG1C,QAAI,KAAK,MAAM,SAAS,mBACtB,gBAAe,KAAK,OAAO,aAAa;;;AAK9C,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAEvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}
+{"version":3,"file":"no-unknown-state-alias.js","names":[],"sources":["../../src/rules/no-unknown-state-alias.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport {\n  getKeyName,\n  getStringValue,\n  isKnownStateAlias,\n  collectLocalStateAliases,\n} from '../utils.js';\n\ntype MessageIds = 'unknownAlias';\n\nexport default createRule<[], MessageIds>({\n  name: 'no-unknown-state-alias',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        \"Warn when a @name state alias is used that isn't in the config\",\n    },\n    messages: {\n      unknownAlias:\n        \"Unknown state alias '{{alias}}'. Add it to 'states' in your tasty config, or define it locally as a '@name' key.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    function checkStateKeys(\n      obj: TSESTree.ObjectExpression,\n      localAliases: string[],\n    ): void {\n      for (const prop of obj.properties) {\n        if (prop.type !== 'Property') continue;\n\n        const key = !prop.computed\n          ? getKeyName(prop.key)\n          : getStringValue(prop.key);\n        if (key === null || !key.startsWith('@')) continue;\n\n        if (\n          !isKnownStateAlias(key, ctx.config) &&\n          !localAliases.includes(key)\n        ) {\n          context.report({\n            node: prop.key,\n            messageId: 'unknownAlias',\n            data: { alias: key },\n          });\n        }\n      }\n    }\n\n    function handleStyleObject(node: TSESTree.ObjectExpression) {\n      if (!ctx.isStyleObject(node)) return;\n\n      const rootObj = ctx.getRootStyleObject(node);\n      const localAliases = collectLocalStateAliases(rootObj);\n\n      // Skip if no states configured and no local aliases\n      if (ctx.config.states.length === 0 && localAliases.length === 0) return;\n\n      for (const prop of node.properties) {\n        if (prop.type !== 'Property' || prop.computed) continue;\n\n        // Skip sub-elements and special keys\n        const key = getKeyName(prop.key);\n        if (key === null || /^[A-Z@&]/.test(key)) continue;\n\n        // Check state map objects for unknown aliases\n        if (prop.value.type === 'ObjectExpression') {\n          checkStateKeys(prop.value, localAliases);\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;AAYA,qCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,kEACH;EACD,UAAU,EACR,cACE,oHACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,SAAS,eACP,KACA,cACM;AACN,QAAK,MAAM,QAAQ,IAAI,YAAY;AACjC,QAAI,KAAK,SAAS,WAAY;IAE9B,MAAM,MAAM,CAAC,KAAK,WACd,WAAW,KAAK,IAAI,GACpB,eAAe,KAAK,IAAI;AAC5B,QAAI,QAAQ,QAAQ,CAAC,IAAI,WAAW,IAAI,CAAE;AAE1C,QACE,CAAC,kBAAkB,KAAK,IAAI,OAAO,IACnC,CAAC,aAAa,SAAS,IAAI,CAE3B,SAAQ,OAAO;KACb,MAAM,KAAK;KACX,WAAW;KACX,MAAM,EAAE,OAAO,KAAK;KACrB,CAAC;;;EAKR,SAAS,kBAAkB,MAAiC;AAC1D,OAAI,CAAC,IAAI,cAAc,KAAK,CAAE;GAG9B,MAAM,eAAe,yBADL,IAAI,mBAAmB,KAAK,CACU;AAGtD,OAAI,IAAI,OAAO,OAAO,WAAW,KAAK,aAAa,WAAW,EAAG;AAEjE,QAAK,MAAM,QAAQ,KAAK,YAAY;AAClC,QAAI,KAAK,SAAS,cAAc,KAAK,SAAU;IAG/C,MAAM,MAAM,WAAW,KAAK,IAAI;AAChC,QAAI,QAAQ,QAAQ,WAAW,KAAK,IAAI,CAAE;AAG1C,QAAI,KAAK,MAAM,SAAS,mBACtB,gBAAe,KAAK,OAAO,aAAa;;;AAK9C,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAEvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}

package/dist/rules/valid-boolean-property.js

@@ -15,6 +15,16 @@ var valid_boolean_property_default = createRule({
 	defaultOptions: [],
 	create(context) {
 		const ctx = new TastyContext(context);
+		function report(name, node) {
+			context.report({
+				node,
+				messageId: "invalidBooleanTrue",
+				data: {
+					name,
+					allowed: [...BOOLEAN_TRUE_PROPERTIES].join(", ")
+				}
+			});
+		}
 		function handleStyleObject(node) {
 			if (!ctx.isStyleObject(node)) return;
 			for (const prop of node.properties) {
@@ -22,14 +32,15 @@ var valid_boolean_property_default = createRule({
 				const key = getKeyName(prop.key);
 				if (key === null) continue;
 				if (/^[A-Z@&$#]/.test(key)) continue;
-				if (prop.value.type === "Literal" && prop.value.value === true && !BOOLEAN_TRUE_PROPERTIES.has(key)) context.report({
-					node: prop.value,
-					messageId: "invalidBooleanTrue",
-					data: {
-						name: key,
-						allowed: [...BOOLEAN_TRUE_PROPERTIES].join(", ")
-					}
-				});
+				if (BOOLEAN_TRUE_PROPERTIES.has(key)) continue;
+				if (prop.value.type === "Literal" && prop.value.value === true) {
+					report(key, prop.value);
+					continue;
+				}
+				if (prop.value.type === "ObjectExpression" && ctx.isStateMap(prop.value, prop)) for (const stateProp of prop.value.properties) {
+					if (stateProp.type !== "Property") continue;
+					if (stateProp.value.type === "Literal" && stateProp.value.value === true) report(key, stateProp.value);
+				}
 			}
 		}
 		return {

package/dist/rules/valid-boolean-property.js.map

@@ -1 +1 @@
-{"version":3,"file":"valid-boolean-property.js","names":[],"sources":["../../src/rules/valid-boolean-property.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';\nimport { BOOLEAN_TRUE_PROPERTIES } from '../constants.js';\n\ntype MessageIds = 'invalidBooleanTrue';\n\nexport default createRule<[], MessageIds>({\n  name: 'valid-boolean-property',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Validate that true/false values are only used on properties that support them',\n    },\n    messages: {\n      invalidBooleanTrue:\n        \"Property '{{name}}' does not accept boolean true. Only these properties support it: {{allowed}}.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\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        // Skip sub-elements and special keys\n        if (/^[A-Z@&$#]/.test(key)) continue;\n\n        // Check for true literal — false is always valid (tombstone)\n        if (\n          prop.value.type === 'Literal' &&\n          prop.value.value === true &&\n          !BOOLEAN_TRUE_PROPERTIES.has(key)\n        ) {\n          context.report({\n            node: prop.value,\n            messageId: 'invalidBooleanTrue',\n            data: {\n              name: key,\n              allowed: [...BOOLEAN_TRUE_PROPERTIES].join(', '),\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,qCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,iFACH;EACD,UAAU,EACR,oBACE,oGACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,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,aAAa,KAAK,IAAI,CAAE;AAG5B,QACE,KAAK,MAAM,SAAS,aACpB,KAAK,MAAM,UAAU,QACrB,CAAC,wBAAwB,IAAI,IAAI,CAEjC,SAAQ,OAAO;KACb,MAAM,KAAK;KACX,WAAW;KACX,MAAM;MACJ,MAAM;MACN,SAAS,CAAC,GAAG,wBAAwB,CAAC,KAAK,KAAK;MACjD;KACF,CAAC;;;AAKR,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAGvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}
+{"version":3,"file":"valid-boolean-property.js","names":[],"sources":["../../src/rules/valid-boolean-property.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';\nimport { BOOLEAN_TRUE_PROPERTIES } from '../constants.js';\n\ntype MessageIds = 'invalidBooleanTrue';\n\nexport default createRule<[], MessageIds>({\n  name: 'valid-boolean-property',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Validate that true/false values are only used on properties that support them',\n    },\n    messages: {\n      invalidBooleanTrue:\n        \"Property '{{name}}' does not accept boolean true. Only these properties support it: {{allowed}}.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    function report(name: string, node: TSESTree.Node): void {\n      context.report({\n        node,\n        messageId: 'invalidBooleanTrue',\n        data: { name, allowed: [...BOOLEAN_TRUE_PROPERTIES].join(', ') },\n      });\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        // Skip sub-elements and special keys\n        if (/^[A-Z@&$#]/.test(key)) continue;\n\n        if (BOOLEAN_TRUE_PROPERTIES.has(key)) continue;\n\n        // Check for true literal — false is always valid (tombstone)\n        if (prop.value.type === 'Literal' && prop.value.value === true) {\n          report(key, prop.value);\n          continue;\n        }\n\n        // A state map holds values for the same property, so `true` is exactly\n        // as unsupported in one as it is written directly — and rather more\n        // likely, since a per-state default (`fill: { '': '#clear', hovered:\n        // true }`) is the shape that reads as if it should work.\n        //\n        // Only genuine state maps: a sub-element object is a style object in its\n        // own right and is visited by the listener, so descending into one here\n        // would attribute its keys to the outer property.\n        if (\n          prop.value.type === 'ObjectExpression' &&\n          ctx.isStateMap(prop.value, prop)\n        ) {\n          for (const stateProp of prop.value.properties) {\n            if (stateProp.type !== 'Property') continue;\n            if (\n              stateProp.value.type === 'Literal' &&\n              stateProp.value.value === true\n            ) {\n              report(key, stateProp.value);\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,qCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,iFACH;EACD,UAAU,EACR,oBACE,oGACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,SAAS,OAAO,MAAc,MAA2B;AACvD,WAAQ,OAAO;IACb;IACA,WAAW;IACX,MAAM;KAAE;KAAM,SAAS,CAAC,GAAG,wBAAwB,CAAC,KAAK,KAAK;KAAE;IACjE,CAAC;;EAGJ,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,aAAa,KAAK,IAAI,CAAE;AAE5B,QAAI,wBAAwB,IAAI,IAAI,CAAE;AAGtC,QAAI,KAAK,MAAM,SAAS,aAAa,KAAK,MAAM,UAAU,MAAM;AAC9D,YAAO,KAAK,KAAK,MAAM;AACvB;;AAWF,QACE,KAAK,MAAM,SAAS,sBACpB,IAAI,WAAW,KAAK,OAAO,KAAK,CAEhC,MAAK,MAAM,aAAa,KAAK,MAAM,YAAY;AAC7C,SAAI,UAAU,SAAS,WAAY;AACnC,SACE,UAAU,MAAM,SAAS,aACzB,UAAU,MAAM,UAAU,KAE1B,QAAO,KAAK,UAAU,MAAM;;;;AAOtC,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAGvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}

package/dist/rules/valid-directional-modifier.js

@@ -5,6 +5,19 @@ import { TastyContext, styleObjectListeners } from "../context.js";
 import { parseValue } from "../parsers/value-parser.js";
 
 //#region src/rules/valid-directional-modifier.ts
+/**
+* Every direction word the rule recognises, across physical and logical
+* vocabularies. A word here is read as a *modifier*; whether it is accepted is
+* then decided per property by `DIRECTIONAL_MODIFIERS`.
+*
+* `start` and `end` are ordinary CSS *values* for a long tail of properties
+* (`textAlign: 'start'`, `justifyContent: 'end'`), which is exactly what the
+* `DIRECTIONAL_MODIFIERS` gate in `checkValue` exists to keep out: only the
+* properties with a directional vocabulary are ever inspected. Inside that set
+* no property takes `start`/`end` as a value, so reading them as modifiers is
+* safe — and it is what turns `padding: '1x start'` (a physical property given
+* a logical edge, which the handler drops) into a report.
+*/
 const ALL_DIRECTIONS = new Set([
 	"top",
 	"right",
@@ -13,7 +26,9 @@ const ALL_DIRECTIONS = new Set([
 	"top-left",
 	"top-right",
 	"bottom-left",
-	"bottom-right"
+	"bottom-right",
+	"start",
+	"end"
 ]);
 /**
 * Token types that count as a *value* rather than a modifier.

package/dist/rules/valid-directional-modifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"valid-directional-modifier.js","names":[],"sources":["../../src/rules/valid-directional-modifier.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 {\n  DIRECTIONAL_MODIFIERS,\n  DOCK_PROPERTIES,\n  SINGLE_VALUE_DIRECTIONAL_PROPERTIES,\n} from '../constants.js';\nimport { parseValue } from '../parsers/index.js';\nimport type { ValueToken } from '../parsers/index.js';\n\ntype MessageIds = 'invalidDirectionalModifier' | 'tooManyValues';\n\nconst ALL_DIRECTIONS = new Set([\n  'top',\n  'right',\n  'bottom',\n  'left',\n  'top-left',\n  'top-right',\n  'bottom-left',\n  'bottom-right',\n]);\n\n/**\n * Token types that count as a *value* rather than a modifier.\n *\n * Deliberately excludes `keyword`: direction words, `solid`, `inherit` and every\n * other bare word classify as keywords, and a CSS-wide keyword alongside a\n * direction (`padding: 'inherit top'`) is legal while carrying no value of its own.\n *\n * Also excludes colors: a `fade` group carries a width plus up to two mask\n * colors, so colors must not count toward the one-value limit.\n */\nconst VALUE_TOKEN_TYPES = new Set<ValueToken['type']>([\n  'custom-unit',\n  'css-unit',\n  'number',\n  'custom-prop',\n  'custom-prop-ref',\n  'css-function',\n  'tasty-function',\n  'group-expr',\n]);\n\n/** The source text of a token. `keyword` tokens carry `value` rather than `raw`. */\nfunction tokenText(token: ValueToken): string {\n  if ('raw' in token && typeof token.raw === 'string') return token.raw;\n  if (token.type === 'keyword') return token.value;\n\n  return '';\n}\n\nexport default createRule<[], MessageIds>({\n  name: 'valid-directional-modifier',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Validate directional modifiers: only on properties that support them, and one value per group',\n    },\n    messages: {\n      invalidDirectionalModifier:\n        \"Modifier '{{modifier}}' is not valid for '{{property}}'. Accepted: {{accepted}}.\",\n      tooManyValues:\n        'A group that names directions takes {{limit}}, but \\'{{group}}\\' has {{count}}. Values and modifiers are parsed into separate buckets, so their order is not recoverable — use comma-separated groups for per-side values, e.g. \"2x top, 4x right\".',\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    function checkValue(\n      property: string,\n      value: string,\n      node: TSESTree.Node,\n    ): void {\n      const allowedMods = DIRECTIONAL_MODIFIERS[property];\n      // Only properties with a directional vocabulary are checked.\n      //\n      // This gate looks like it makes the \"wrong property\" case unreachable, and\n      // it does — but removing it is not the fix. Direction words are ordinary CSS\n      // *values* for a long tail of properties: `verticalAlign: 'bottom'`,\n      // `textAlign: 'left'`, `transformOrigin: 'top center'`,\n      // `backgroundPosition`, `objectPosition`, `float`, `clear`,\n      // `scrollSnapAlign`, and `transition` (whose value names properties, which\n      // can themselves be `left`/`top`). Checking every property reported all of\n      // those as errors across a real design system. Catching `fill: '#purple\n      // top'` is not worth an allowlist of every property that takes a\n      // positional keyword.\n      if (!allowedMods) return;\n\n      // `parseValue` splits on commas (groups) and spaced slashes (parts), which\n      // is what makes a per-group arity check possible at all.\n      const { groups } = parseValue(value, {\n        skipUnitValidation: true,\n        skipFuncValidation: true,\n      });\n\n      for (const group of groups) {\n        const tokens = group.parts.flatMap((part) => part.tokens);\n        const directions: string[] = [];\n        let valueCount = 0;\n        let hasSpanModifier = false;\n\n        for (const token of tokens) {\n          if (VALUE_TOKEN_TYPES.has(token.type)) {\n            valueCount++;\n            continue;\n          }\n\n          const word = tokenText(token);\n\n          if (ALL_DIRECTIONS.has(word)) {\n            directions.push(word);\n          } else if (word === 'dock' && DOCK_PROPERTIES.has(property)) {\n            hasSpanModifier = true;\n          }\n        }\n\n        if (directions.length === 0) continue;\n\n        let reportedUnknown = false;\n        for (const direction of directions) {\n          if (!allowedMods.has(direction)) {\n            context.report({\n              node,\n              messageId: 'invalidDirectionalModifier',\n              data: {\n                property,\n                modifier: direction,\n                accepted: [...allowedMods].join(', '),\n              },\n            });\n            reportedUnknown = true;\n          }\n        }\n\n        // Don't pile an arity complaint on top of an already-invalid modifier.\n        if (reportedUnknown) continue;\n\n        if (!SINGLE_VALUE_DIRECTIONAL_PROPERTIES.has(property)) continue;\n\n        // Values and modifiers are bucketed separately by the parser, so the\n        // pairing a reader infers from source order does not survive parsing: a\n        // group naming directions carries one value, applied to every direction it\n        // names. `dock` is the exception — its second value insets the sides the\n        // dock spans.\n        const limit = hasSpanModifier ? 2 : 1;\n\n        if (valueCount > limit) {\n          context.report({\n            node,\n            messageId: 'tooManyValues',\n            data: {\n              group: tokens.map(tokenText).filter(Boolean).join(' '),\n              count: `${valueCount}`,\n              limit: hasSpanModifier ? 'at most two values' : 'a single value',\n            },\n          });\n        }\n      }\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        // Sub-elements, at-rules, token declarations, nested selectors, and the\n        // `$` affix (which holds a selector, not a value) are not style values.\n        if (\n          key === '$' ||\n          key.startsWith('@') ||\n          key.startsWith('$') ||\n          key.startsWith('#') ||\n          key.startsWith('&') ||\n          /^[A-Z]/.test(key)\n        ) {\n          continue;\n        }\n\n        // Direct value\n        const str = getStringValue(prop.value);\n        if (str) {\n          checkValue(key, str, prop.value);\n          continue;\n        }\n\n        // State map\n        if (\n          prop.value.type === 'ObjectExpression' &&\n          ctx.isStateMap(prop.value, prop)\n        ) {\n          for (const stateProp of prop.value.properties) {\n            if (stateProp.type !== 'Property') continue;\n            const stateStr = getStringValue(stateProp.value);\n            if (stateStr) {\n              checkValue(key, stateStr, stateProp.value);\n            }\n          }\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"valid-directional-modifier.js","names":[],"sources":["../../src/rules/valid-directional-modifier.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 {\n  DIRECTIONAL_MODIFIERS,\n  DOCK_PROPERTIES,\n  SINGLE_VALUE_DIRECTIONAL_PROPERTIES,\n} from '../constants.js';\nimport { parseValue } from '../parsers/index.js';\nimport type { ValueToken } from '../parsers/index.js';\n\ntype MessageIds = 'invalidDirectionalModifier' | 'tooManyValues';\n\n/**\n * Every direction word the rule recognises, across physical and logical\n * vocabularies. A word here is read as a *modifier*; whether it is accepted is\n * then decided per property by `DIRECTIONAL_MODIFIERS`.\n *\n * `start` and `end` are ordinary CSS *values* for a long tail of properties\n * (`textAlign: 'start'`, `justifyContent: 'end'`), which is exactly what the\n * `DIRECTIONAL_MODIFIERS` gate in `checkValue` exists to keep out: only the\n * properties with a directional vocabulary are ever inspected. Inside that set\n * no property takes `start`/`end` as a value, so reading them as modifiers is\n * safe — and it is what turns `padding: '1x start'` (a physical property given\n * a logical edge, which the handler drops) into a report.\n */\nconst ALL_DIRECTIONS = new Set([\n  'top',\n  'right',\n  'bottom',\n  'left',\n  'top-left',\n  'top-right',\n  'bottom-left',\n  'bottom-right',\n  'start',\n  'end',\n]);\n\n/**\n * Token types that count as a *value* rather than a modifier.\n *\n * Deliberately excludes `keyword`: direction words, `solid`, `inherit` and every\n * other bare word classify as keywords, and a CSS-wide keyword alongside a\n * direction (`padding: 'inherit top'`) is legal while carrying no value of its own.\n *\n * Also excludes colors: a `fade` group carries a width plus up to two mask\n * colors, so colors must not count toward the one-value limit.\n */\nconst VALUE_TOKEN_TYPES = new Set<ValueToken['type']>([\n  'custom-unit',\n  'css-unit',\n  'number',\n  'custom-prop',\n  'custom-prop-ref',\n  'css-function',\n  'tasty-function',\n  'group-expr',\n]);\n\n/** The source text of a token. `keyword` tokens carry `value` rather than `raw`. */\nfunction tokenText(token: ValueToken): string {\n  if ('raw' in token && typeof token.raw === 'string') return token.raw;\n  if (token.type === 'keyword') return token.value;\n\n  return '';\n}\n\nexport default createRule<[], MessageIds>({\n  name: 'valid-directional-modifier',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Validate directional modifiers: only on properties that support them, and one value per group',\n    },\n    messages: {\n      invalidDirectionalModifier:\n        \"Modifier '{{modifier}}' is not valid for '{{property}}'. Accepted: {{accepted}}.\",\n      tooManyValues:\n        'A group that names directions takes {{limit}}, but \\'{{group}}\\' has {{count}}. Values and modifiers are parsed into separate buckets, so their order is not recoverable — use comma-separated groups for per-side values, e.g. \"2x top, 4x right\".',\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    function checkValue(\n      property: string,\n      value: string,\n      node: TSESTree.Node,\n    ): void {\n      const allowedMods = DIRECTIONAL_MODIFIERS[property];\n      // Only properties with a directional vocabulary are checked.\n      //\n      // This gate looks like it makes the \"wrong property\" case unreachable, and\n      // it does — but removing it is not the fix. Direction words are ordinary CSS\n      // *values* for a long tail of properties: `verticalAlign: 'bottom'`,\n      // `textAlign: 'left'`, `transformOrigin: 'top center'`,\n      // `backgroundPosition`, `objectPosition`, `float`, `clear`,\n      // `scrollSnapAlign`, and `transition` (whose value names properties, which\n      // can themselves be `left`/`top`). Checking every property reported all of\n      // those as errors across a real design system. Catching `fill: '#purple\n      // top'` is not worth an allowlist of every property that takes a\n      // positional keyword.\n      if (!allowedMods) return;\n\n      // `parseValue` splits on commas (groups) and spaced slashes (parts), which\n      // is what makes a per-group arity check possible at all.\n      const { groups } = parseValue(value, {\n        skipUnitValidation: true,\n        skipFuncValidation: true,\n      });\n\n      for (const group of groups) {\n        const tokens = group.parts.flatMap((part) => part.tokens);\n        const directions: string[] = [];\n        let valueCount = 0;\n        let hasSpanModifier = false;\n\n        for (const token of tokens) {\n          if (VALUE_TOKEN_TYPES.has(token.type)) {\n            valueCount++;\n            continue;\n          }\n\n          const word = tokenText(token);\n\n          if (ALL_DIRECTIONS.has(word)) {\n            directions.push(word);\n          } else if (word === 'dock' && DOCK_PROPERTIES.has(property)) {\n            hasSpanModifier = true;\n          }\n        }\n\n        if (directions.length === 0) continue;\n\n        let reportedUnknown = false;\n        for (const direction of directions) {\n          if (!allowedMods.has(direction)) {\n            context.report({\n              node,\n              messageId: 'invalidDirectionalModifier',\n              data: {\n                property,\n                modifier: direction,\n                accepted: [...allowedMods].join(', '),\n              },\n            });\n            reportedUnknown = true;\n          }\n        }\n\n        // Don't pile an arity complaint on top of an already-invalid modifier.\n        if (reportedUnknown) continue;\n\n        if (!SINGLE_VALUE_DIRECTIONAL_PROPERTIES.has(property)) continue;\n\n        // Values and modifiers are bucketed separately by the parser, so the\n        // pairing a reader infers from source order does not survive parsing: a\n        // group naming directions carries one value, applied to every direction it\n        // names. `dock` is the exception — its second value insets the sides the\n        // dock spans.\n        const limit = hasSpanModifier ? 2 : 1;\n\n        if (valueCount > limit) {\n          context.report({\n            node,\n            messageId: 'tooManyValues',\n            data: {\n              group: tokens.map(tokenText).filter(Boolean).join(' '),\n              count: `${valueCount}`,\n              limit: hasSpanModifier ? 'at most two values' : 'a single value',\n            },\n          });\n        }\n      }\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        // Sub-elements, at-rules, token declarations, nested selectors, and the\n        // `$` affix (which holds a selector, not a value) are not style values.\n        if (\n          key === '$' ||\n          key.startsWith('@') ||\n          key.startsWith('$') ||\n          key.startsWith('#') ||\n          key.startsWith('&') ||\n          /^[A-Z]/.test(key)\n        ) {\n          continue;\n        }\n\n        // Direct value\n        const str = getStringValue(prop.value);\n        if (str) {\n          checkValue(key, str, prop.value);\n          continue;\n        }\n\n        // State map\n        if (\n          prop.value.type === 'ObjectExpression' &&\n          ctx.isStateMap(prop.value, prop)\n        ) {\n          for (const stateProp of prop.value.properties) {\n            if (stateProp.type !== 'Property') continue;\n            const stateStr = getStringValue(stateProp.value);\n            if (stateStr) {\n              checkValue(key, stateStr, stateProp.value);\n            }\n          }\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":"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"}

package/dist/rules/valid-state-key.js

@@ -1,5 +1,5 @@
 import { createRule } from "../create-rule.js";
-import { collectLocalStateAliases, findRootStyleObject, getKeyName, getStringValue } from "../utils.js";
+import { collectLocalStateAliases, getKeyName, getStringValue } from "../utils.js";
 import { TastyContext, styleObjectListeners } from "../context.js";
 import { parseStateKey } from "../parsers/state-key-parser.js";
 
@@ -19,15 +19,7 @@ var valid_state_key_default = createRule({
 	create(context) {
 		const ctx = new TastyContext(context);
 		const parserOpts = { knownAliases: ctx.config.states };
-		function isInsideSubElement(node) {
-			let current = node.parent;
-			while (current) {
-				if (current.type === "Property" && !current.computed && current.key.type === "Identifier" && /^[A-Z]/.test(current.key.name)) return true;
-				current = current.parent;
-			}
-			return false;
-		}
-		function checkStateKey(key, keyNode, insideSubElement, localAliases) {
+		function checkStateKey(key, keyNode, localAliases) {
 			if (key === "") return;
 			const result = parseStateKey(key, parserOpts);
 			for (const error of result.errors) context.report({
@@ -49,8 +41,7 @@ var valid_state_key_default = createRule({
 		}
 		function handleStyleObject(node) {
 			if (!ctx.isStyleObject(node)) return;
-			const insideSubElement = isInsideSubElement(node);
-			const localAliases = collectLocalStateAliases(findRootStyleObject(node));
+			const localAliases = collectLocalStateAliases(ctx.getRootStyleObject(node));
 			for (const prop of node.properties) {
 				if (prop.type !== "Property" || prop.computed) continue;
 				const key = getKeyName(prop.key);
@@ -61,7 +52,7 @@ var valid_state_key_default = createRule({
 					if (stateProp.type !== "Property") continue;
 					const stateKey = !stateProp.computed ? getKeyName(stateProp.key) : getStringValue(stateProp.key);
 					if (stateKey === null) continue;
-					checkStateKey(stateKey, stateProp.key, insideSubElement, localAliases);
+					checkStateKey(stateKey, stateProp.key, localAliases);
 				}
 			}
 		}

package/dist/rules/valid-state-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"valid-state-key.js","names":[],"sources":["../../src/rules/valid-state-key.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport {\n  getKeyName,\n  getStringValue,\n  collectLocalStateAliases,\n  findRootStyleObject,\n} from '../utils.js';\nimport { parseStateKey } from '../parsers/state-key-parser.js';\nimport type { StateKeyParserOptions } from '../parsers/state-key-parser.js';\n\ntype MessageIds = 'invalidStateKey' | 'unknownAlias';\n\nexport default createRule<[], MessageIds>({\n  name: 'valid-state-key',\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Validate state key syntax in style mapping objects',\n    },\n    messages: {\n      invalidStateKey: '{{reason}}',\n      unknownAlias:\n        \"Unknown state alias '{{alias}}'. Configured aliases: {{known}}.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    const parserOpts: StateKeyParserOptions = {\n      knownAliases: ctx.config.states,\n    };\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 checkStateKey(\n      key: string,\n      keyNode: TSESTree.Node,\n      insideSubElement: boolean,\n      localAliases: string[],\n    ): void {\n      if (key === '') return;\n\n      const result = parseStateKey(key, parserOpts);\n\n      // Report all parse/validation errors\n      for (const error of result.errors) {\n        context.report({\n          node: keyNode,\n          messageId: 'invalidStateKey',\n          data: { reason: error.message },\n        });\n      }\n\n      // Check aliases against config and local definitions\n      const allKnown = [...ctx.config.states, ...localAliases];\n      if (allKnown.length > 0) {\n        for (const alias of result.referencedAliases) {\n          if (!allKnown.includes(alias)) {\n            context.report({\n              node: keyNode,\n              messageId: 'unknownAlias',\n              data: {\n                alias,\n                known: allKnown.join(', '),\n              },\n            });\n          }\n        }\n      }\n    }\n\n    function handleStyleObject(node: TSESTree.ObjectExpression) {\n      if (!ctx.isStyleObject(node)) return;\n\n      const insideSubElement = isInsideSubElement(node);\n      const rootObj = findRootStyleObject(node);\n      const localAliases = collectLocalStateAliases(rootObj);\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) continue;\n\n          checkStateKey(\n            stateKey,\n            stateProp.key,\n            insideSubElement,\n            localAliases,\n          );\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;;AAcA,8BAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aAAa,sDACd;EACD,UAAU;GACR,iBAAiB;GACjB,cACE;GACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,MAAM,aAAoC,EACxC,cAAc,IAAI,OAAO,QAC1B;EAED,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,cACP,KACA,SACA,kBACA,cACM;AACN,OAAI,QAAQ,GAAI;GAEhB,MAAM,SAAS,cAAc,KAAK,WAAW;AAG7C,QAAK,MAAM,SAAS,OAAO,OACzB,SAAQ,OAAO;IACb,MAAM;IACN,WAAW;IACX,MAAM,EAAE,QAAQ,MAAM,SAAS;IAChC,CAAC;GAIJ,MAAM,WAAW,CAAC,GAAG,IAAI,OAAO,QAAQ,GAAG,aAAa;AACxD,OAAI,SAAS,SAAS,GACpB;SAAK,MAAM,SAAS,OAAO,kBACzB,KAAI,CAAC,SAAS,SAAS,MAAM,CAC3B,SAAQ,OAAO;KACb,MAAM;KACN,WAAW;KACX,MAAM;MACJ;MACA,OAAO,SAAS,KAAK,KAAK;MAC3B;KACF,CAAC;;;EAMV,SAAS,kBAAkB,MAAiC;AAC1D,OAAI,CAAC,IAAI,cAAc,KAAK,CAAE;GAE9B,MAAM,mBAAmB,mBAAmB,KAAK;GAEjD,MAAM,eAAe,yBADL,oBAAoB,KAAK,CACa;AAEtD,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,KAAM;AAEvB,mBACE,UACA,UAAU,KACV,kBACA,aACD;;;;AAKP,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAGvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}
+{"version":3,"file":"valid-state-key.js","names":[],"sources":["../../src/rules/valid-state-key.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport {\n  getKeyName,\n  getStringValue,\n  collectLocalStateAliases,\n} from '../utils.js';\nimport { parseStateKey } from '../parsers/state-key-parser.js';\nimport type { StateKeyParserOptions } from '../parsers/state-key-parser.js';\n\ntype MessageIds = 'invalidStateKey' | 'unknownAlias';\n\nexport default createRule<[], MessageIds>({\n  name: 'valid-state-key',\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Validate state key syntax in style mapping objects',\n    },\n    messages: {\n      invalidStateKey: '{{reason}}',\n      unknownAlias:\n        \"Unknown state alias '{{alias}}'. Configured aliases: {{known}}.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n\n    const parserOpts: StateKeyParserOptions = {\n      knownAliases: ctx.config.states,\n    };\n\n    function checkStateKey(\n      key: string,\n      keyNode: TSESTree.Node,\n      localAliases: string[],\n    ): void {\n      if (key === '') return;\n\n      const result = parseStateKey(key, parserOpts);\n\n      // Report all parse/validation errors\n      for (const error of result.errors) {\n        context.report({\n          node: keyNode,\n          messageId: 'invalidStateKey',\n          data: { reason: error.message },\n        });\n      }\n\n      // Check aliases against config and local definitions\n      const allKnown = [...ctx.config.states, ...localAliases];\n      if (allKnown.length > 0) {\n        for (const alias of result.referencedAliases) {\n          if (!allKnown.includes(alias)) {\n            context.report({\n              node: keyNode,\n              messageId: 'unknownAlias',\n              data: {\n                alias,\n                known: allKnown.join(', '),\n              },\n            });\n          }\n        }\n      }\n    }\n\n    function handleStyleObject(node: TSESTree.ObjectExpression) {\n      if (!ctx.isStyleObject(node)) return;\n\n      const rootObj = ctx.getRootStyleObject(node);\n      const localAliases = collectLocalStateAliases(rootObj);\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) continue;\n\n          checkStateKey(stateKey, stateProp.key, localAliases);\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;;AAaA,8BAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aAAa,sDACd;EACD,UAAU;GACR,iBAAiB;GACjB,cACE;GACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,MAAM,aAAoC,EACxC,cAAc,IAAI,OAAO,QAC1B;EAED,SAAS,cACP,KACA,SACA,cACM;AACN,OAAI,QAAQ,GAAI;GAEhB,MAAM,SAAS,cAAc,KAAK,WAAW;AAG7C,QAAK,MAAM,SAAS,OAAO,OACzB,SAAQ,OAAO;IACb,MAAM;IACN,WAAW;IACX,MAAM,EAAE,QAAQ,MAAM,SAAS;IAChC,CAAC;GAIJ,MAAM,WAAW,CAAC,GAAG,IAAI,OAAO,QAAQ,GAAG,aAAa;AACxD,OAAI,SAAS,SAAS,GACpB;SAAK,MAAM,SAAS,OAAO,kBACzB,KAAI,CAAC,SAAS,SAAS,MAAM,CAC3B,SAAQ,OAAO;KACb,MAAM;KACN,WAAW;KACX,MAAM;MACJ;MACA,OAAO,SAAS,KAAK,KAAK;MAC3B;KACF,CAAC;;;EAMV,SAAS,kBAAkB,MAAiC;AAC1D,OAAI,CAAC,IAAI,cAAc,KAAK,CAAE;GAG9B,MAAM,eAAe,yBADL,IAAI,mBAAmB,KAAK,CACU;AAEtD,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,KAAM;AAEvB,mBAAc,UAAU,UAAU,KAAK,aAAa;;;;AAK1D,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAGvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}

package/dist/rules/valid-sub-element.js

@@ -1,5 +1,5 @@
 import { createRule } from "../create-rule.js";
-import { getKeyName } from "../utils.js";
+import { getKeyName, unwrapExpression } from "../utils.js";
 import { TastyContext, styleObjectListeners } from "../context.js";
 
 //#region src/rules/valid-sub-element.ts
@@ -20,9 +20,10 @@ var valid_sub_element_default = createRule({
 				if (prop.type !== "Property" || prop.computed) continue;
 				const key = getKeyName(prop.key);
 				if (key === null || !/^[A-Z]/.test(key)) continue;
-				if (prop.value.type !== "ObjectExpression") {
-					if (prop.value.type === "Literal" && prop.value.value === false) continue;
-					const valueType = prop.value.type === "Literal" ? typeof prop.value.value : prop.value.type;
+				const value = unwrapExpression(prop.value);
+				if (value.type !== "ObjectExpression") {
+					if (value.type === "Literal" && value.value === false) continue;
+					const valueType = value.type === "Literal" ? typeof value.value : value.type;
 					context.report({
 						node: prop.value,
 						messageId: "subElementNotObject",

package/dist/rules/valid-sub-element.js.map

@@ -1 +1 @@
-{"version":3,"file":"valid-sub-element.js","names":[],"sources":["../../src/rules/valid-sub-element.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 = 'subElementNotObject';\n\nexport default createRule<[], MessageIds>({\n  name: 'valid-sub-element',\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Validate sub-element key format in style objects',\n    },\n    messages: {\n      subElementNotObject:\n        \"Sub-element '{{name}}' value must be a style object, not a {{type}}.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\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 || !/^[A-Z]/.test(key)) continue;\n\n        if (prop.value.type !== 'ObjectExpression') {\n          if (prop.value.type === 'Literal' && prop.value.value === false) {\n            continue;\n          }\n\n          const valueType =\n            prop.value.type === 'Literal'\n              ? typeof prop.value.value\n              : prop.value.type;\n\n          context.report({\n            node: prop.value,\n            messageId: 'subElementNotObject',\n            data: { name: key, type: valueType },\n          });\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;AAOA,gCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aAAa,oDACd;EACD,UAAU,EACR,qBACE,wEACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,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,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAE;AAEzC,QAAI,KAAK,MAAM,SAAS,oBAAoB;AAC1C,SAAI,KAAK,MAAM,SAAS,aAAa,KAAK,MAAM,UAAU,MACxD;KAGF,MAAM,YACJ,KAAK,MAAM,SAAS,YAChB,OAAO,KAAK,MAAM,QAClB,KAAK,MAAM;AAEjB,aAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACX,MAAM;OAAE,MAAM;OAAK,MAAM;OAAW;MACrC,CAAC;;;;AAKR,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAEvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}
+{"version":3,"file":"valid-sub-element.js","names":[],"sources":["../../src/rules/valid-sub-element.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext, styleObjectListeners } from '../context.js';\nimport { getKeyName, unwrapExpression } from '../utils.js';\n\ntype MessageIds = 'subElementNotObject';\n\nexport default createRule<[], MessageIds>({\n  name: 'valid-sub-element',\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Validate sub-element key format in style objects',\n    },\n    messages: {\n      subElementNotObject:\n        \"Sub-element '{{name}}' value must be a style object, not a {{type}}.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\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 || !/^[A-Z]/.test(key)) continue;\n\n        const value = unwrapExpression(prop.value);\n        if (value.type !== 'ObjectExpression') {\n          if (value.type === 'Literal' && value.value === false) {\n            continue;\n          }\n\n          const valueType =\n            value.type === 'Literal' ? typeof value.value : value.type;\n\n          context.report({\n            node: prop.value,\n            messageId: 'subElementNotObject',\n            data: { name: key, type: valueType },\n          });\n        }\n      }\n    }\n\n    return {\n      ImportDeclaration(node) {\n        ctx.trackImport(node);\n      },\n      ...styleObjectListeners(handleStyleObject),\n    };\n  },\n});\n"],"mappings":";;;;;AAOA,gCAAe,WAA2B;CACxC,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aAAa,oDACd;EACD,UAAU,EACR,qBACE,wEACH;EACD,QAAQ,EAAE;EACX;CACD,gBAAgB,EAAE;CAClB,OAAO,SAAS;EACd,MAAM,MAAM,IAAI,aAAa,QAAQ;EAErC,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,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAE;IAEzC,MAAM,QAAQ,iBAAiB,KAAK,MAAM;AAC1C,QAAI,MAAM,SAAS,oBAAoB;AACrC,SAAI,MAAM,SAAS,aAAa,MAAM,UAAU,MAC9C;KAGF,MAAM,YACJ,MAAM,SAAS,YAAY,OAAO,MAAM,QAAQ,MAAM;AAExD,aAAQ,OAAO;MACb,MAAM,KAAK;MACX,WAAW;MACX,MAAM;OAAE,MAAM;OAAK,MAAM;OAAW;MACrC,CAAC;;;;AAKR,SAAO;GACL,kBAAkB,MAAM;AACtB,QAAI,YAAY,KAAK;;GAEvB,GAAG,qBAAqB,kBAAkB;GAC3C;;CAEJ,CAAC"}

package/dist/types.d.ts

@@ -1,4 +1,13 @@
 //#region src/types.d.ts
+/** A named import whose arguments contain Tasty styles. */
+interface StyleFunctionConfig {
+  /** Zero-based argument index, or every argument for a variadic style helper. */
+  argument: number | 'all';
+  /** A style object, or Tasty options containing `styles` and `variants`. */
+  kind: 'styles' | 'options';
+  /** Treat styles as a partial override of existing styles. Defaults to false. */
+  partial?: boolean;
+}
 interface TastyValidationConfig {
   extends?: string;
   tokens?: false | string[];
@@ -17,6 +26,8 @@ interface TastyValidationConfig {
   recipes?: string[];
   styles?: string[];
   importSources?: string[];
+  /** Custom calls, keyed by exported name, from tracked `importSources`. */
+  styleFunctions?: Record<string, StyleFunctionConfig>;
   /**
    * Import sources whose components this project can edit — a design system
    * published from the same monorepo, for instance. Rules that would send the
@@ -46,7 +57,9 @@ interface ResolvedConfig {
    * missing value as the empty list. See `types.compat.ts` for the guard.
    */
   ownedSources?: string[];
+  /** Optional for compatibility with existing consumer-built configs. */
+  styleFunctions?: Record<string, StyleFunctionConfig>;
 }
 //#endregion
-export { ResolvedConfig, TastyValidationConfig };
+export { ResolvedConfig, StyleFunctionConfig, TastyValidationConfig };
 //# sourceMappingURL=types.d.ts.map

package/dist/utils.js

@@ -1,6 +1,12 @@
 import { BUILT_IN_STATE_PREFIXES, BUILT_IN_UNITS, CSS_UNITS } from "./constants.js";
 
 //#region src/utils.ts
+/** Strip TypeScript wrappers that do not change an expression's runtime value. */
+function unwrapExpression(node) {
+	let current = node;
+	while (current.type === "TSAsExpression" || current.type === "TSSatisfiesExpression" || current.type === "TSNonNullExpression" || current.type === "TSTypeAssertion" || current.type === "TSInstantiationExpression") current = current.expression;
+	return current;
+}
 /**
 * Gets the string value of a property key node.
 */
@@ -22,6 +28,7 @@ function getStringValue(node) {
 * Checks if a value node is a static literal.
 */
 function isStaticValue(node) {
+	node = unwrapExpression(node);
 	if (node.type === "Literal") return true;
 	if (node.type === "UnaryExpression" && node.operator === "-" && node.argument.type === "Literal") return true;
 	if (node.type === "TemplateLiteral" && node.expressions.length === 0) return true;
@@ -126,27 +133,7 @@ function collectLocalStateAliases(node) {
 	}
 	return aliases;
 }
-/**
-* Walks up the AST through sub-element properties (capitalized keys) to find
-* the outermost styles ObjectExpression. Local states are always defined at
-* the root level, so sub-elements inherit them.
-*/
-function findRootStyleObject(node) {
-	let current = node;
-	while (current.parent) {
-		const parent = current.parent;
-		if (parent.type === "Property" && !parent.computed) {
-			const key = getKeyName(parent.key);
-			if (key && /^[A-Z]/.test(key) && parent.parent?.type === "ObjectExpression") {
-				current = parent.parent;
-				continue;
-			}
-		}
-		break;
-	}
-	return current;
-}
 
 //#endregion
-export { collectLocalStateAliases, extractCustomUnit, findRootStyleObject, getKeyName, getStringValue, isKnownStateAlias, isRawHexColor, isStaticValue, isValidSelector, isValidUnit, validateColorTokenSyntax };
+export { collectLocalStateAliases, extractCustomUnit, getKeyName, getStringValue, isKnownStateAlias, isRawHexColor, isStaticValue, isValidSelector, isValidUnit, unwrapExpression, validateColorTokenSyntax };
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../src/utils.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport {\n  BUILT_IN_UNITS,\n  CSS_UNITS,\n  BUILT_IN_STATE_PREFIXES,\n} from './constants.js';\nimport type { ResolvedConfig } from './types.js';\n\n/**\n * Gets the string value of a property key node.\n */\nexport function getKeyName(key: TSESTree.Node): string | null {\n  if (key.type === 'Identifier') return key.name;\n  if (key.type === 'Literal' && typeof key.value === 'string') return key.value;\n  if (key.type === 'Literal' && typeof key.value === 'number')\n    return String(key.value);\n  return null;\n}\n\n/**\n * Gets the string value of a node if it is a string literal.\n */\nexport function getStringValue(node: TSESTree.Node): string | null {\n  if (node.type === 'Literal' && typeof node.value === 'string') {\n    return node.value;\n  }\n  if (node.type === 'TemplateLiteral' && node.expressions.length === 0) {\n    return node.quasis[0].value.cooked ?? null;\n  }\n  return null;\n}\n\n/**\n * Checks if a value node is a static literal.\n */\nexport function isStaticValue(node: TSESTree.Node): boolean {\n  if (node.type === 'Literal') return true;\n  if (\n    node.type === 'UnaryExpression' &&\n    node.operator === '-' &&\n    node.argument.type === 'Literal'\n  ) {\n    return true;\n  }\n  if (node.type === 'TemplateLiteral' && node.expressions.length === 0) {\n    return true;\n  }\n  if (node.type === 'ArrayExpression') {\n    return node.elements.every((el) => el !== null && isStaticValue(el));\n  }\n  if (node.type === 'ObjectExpression') {\n    return node.properties.every(\n      (prop) =>\n        prop.type === 'Property' && !prop.computed && isStaticValue(prop.value),\n    );\n  }\n  return false;\n}\n\n/**\n * Validates color token syntax.\n * Returns null if valid, or an error message if invalid.\n */\nexport function validateColorTokenSyntax(token: string): string | null {\n  // Strip leading # or ##\n  let name = token;\n  if (name.startsWith('##')) {\n    name = name.slice(2);\n  } else if (name.startsWith('#')) {\n    name = name.slice(1);\n  } else {\n    return 'Color token must start with #';\n  }\n\n  if (name.length === 0) return 'Empty color token name';\n\n  // Check for opacity suffix\n  const dotIndex = name.indexOf('.');\n  if (dotIndex !== -1) {\n    const tokenName = name.slice(0, dotIndex);\n    const opacitySuffix = name.slice(dotIndex + 1);\n\n    if (tokenName.length === 0) return 'Empty color token name before opacity';\n\n    if (opacitySuffix.startsWith('$')) {\n      // Dynamic opacity from CSS custom property — always valid\n      return null;\n    }\n\n    if (opacitySuffix.length === 0) return 'Trailing dot with no opacity value';\n\n    const opacity = Number(opacitySuffix);\n    if (isNaN(opacity)) return `Invalid opacity value '${opacitySuffix}'`;\n    if (opacity < 0) return 'Opacity cannot be negative';\n    if (opacity > 100) return `Opacity '${opacitySuffix}' exceeds 100`;\n  }\n\n  return null;\n}\n\n/**\n * Checks if a string looks like a raw hex color (not a token).\n * Hex colors: #fff, #ffff, #ffffff, #ffffffff (3, 4, 6, or 8 hex chars).\n */\nexport function isRawHexColor(value: string): boolean {\n  if (!value.startsWith('#')) return false;\n  const hex = value.slice(1).split('.')[0];\n  if (![3, 4, 6, 8].includes(hex.length)) return false;\n  return /^[0-9a-fA-F]+$/.test(hex);\n}\n\n/**\n * Extracts custom unit from a value token like \"2x\", \"1.5r\", \"3cols\".\n * Returns the unit name, or null if not a custom-unit value.\n */\nexport function extractCustomUnit(token: string): string | null {\n  const match = token.match(/^-?[\\d.]+([a-zA-Z]+)$/);\n  if (!match) return null;\n  return match[1];\n}\n\n/**\n * Checks if a unit is valid (built-in, CSS, or in config).\n */\nexport function isValidUnit(unit: string, config: ResolvedConfig): boolean {\n  if (config.units === false) return true;\n  if (BUILT_IN_UNITS.has(unit)) return true;\n  if (CSS_UNITS.has(unit)) return true;\n  if (Array.isArray(config.units) && config.units.includes(unit)) return true;\n  return false;\n}\n\n/**\n * Checks if a state alias key (starting with @) is known.\n */\nexport function isKnownStateAlias(\n  key: string,\n  config: ResolvedConfig,\n): boolean {\n  // Built-in prefixes\n  for (const prefix of BUILT_IN_STATE_PREFIXES) {\n    if (key === prefix || key.startsWith(prefix + '(')) return true;\n  }\n  // Container query shorthand\n  if (key.startsWith('@(')) return true;\n  // Config aliases\n  return config.states.includes(key);\n}\n\n/**\n * Checks if a CSS selector string is basically valid.\n */\nexport function isValidSelector(selector: string): string | null {\n  if (selector.length === 0) return 'Selector cannot be empty';\n\n  // Check balanced brackets\n  let depth = 0;\n  for (const char of selector) {\n    if (char === '(' || char === '[') depth++;\n    if (char === ')' || char === ']') depth--;\n    if (depth < 0) return 'Unbalanced brackets in selector';\n  }\n  if (depth !== 0) return 'Unbalanced brackets in selector';\n\n  return null;\n}\n\n/**\n * Finds a property by key name in an object expression.\n */\nexport function findProperty(\n  obj: TSESTree.ObjectExpression,\n  name: string,\n): TSESTree.Property | undefined {\n  for (const prop of obj.properties) {\n    if (prop.type === 'Property' && !prop.computed) {\n      const keyName = getKeyName(prop.key);\n      if (keyName === name) return prop;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Collects local predefined state alias names from a styles ObjectExpression.\n * Local states are top-level `@name` keys with string literal values,\n * mirroring the runtime's `extractLocalPredefinedStates()`.\n */\nexport function collectLocalStateAliases(\n  node: TSESTree.ObjectExpression,\n): string[] {\n  const aliases: string[] = [];\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    if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(key)) continue;\n\n    // Skip built-in prefixes — they are not local state definitions\n    if (BUILT_IN_STATE_PREFIXES.has(key)) continue;\n\n    // Must have a string value to be a state definition\n    if (getStringValue(prop.value) !== null) {\n      aliases.push(key);\n    }\n  }\n\n  return aliases;\n}\n\n/**\n * Walks up the AST through sub-element properties (capitalized keys) to find\n * the outermost styles ObjectExpression. Local states are always defined at\n * the root level, so sub-elements inherit them.\n */\nexport function findRootStyleObject(\n  node: TSESTree.ObjectExpression,\n): TSESTree.ObjectExpression {\n  let current: TSESTree.ObjectExpression = node;\n\n  while (current.parent) {\n    const parent = current.parent;\n\n    if (parent.type === 'Property' && !parent.computed) {\n      const key = getKeyName(parent.key);\n\n      if (\n        key &&\n        /^[A-Z]/.test(key) &&\n        parent.parent?.type === 'ObjectExpression'\n      ) {\n        current = parent.parent;\n        continue;\n      }\n    }\n\n    break;\n  }\n\n  return current;\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.js","names":[],"sources":["../src/utils.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport {\n  BUILT_IN_UNITS,\n  CSS_UNITS,\n  BUILT_IN_STATE_PREFIXES,\n} from './constants.js';\nimport type { ResolvedConfig } from './types.js';\n\n/** Strip TypeScript wrappers that do not change an expression's runtime value. */\nexport function unwrapExpression(node: TSESTree.Node): TSESTree.Node {\n  let current = node;\n\n  while (\n    current.type === 'TSAsExpression' ||\n    current.type === 'TSSatisfiesExpression' ||\n    current.type === 'TSNonNullExpression' ||\n    current.type === 'TSTypeAssertion' ||\n    current.type === 'TSInstantiationExpression'\n  ) {\n    current = current.expression;\n  }\n\n  return current;\n}\n\n/**\n * Gets the string value of a property key node.\n */\nexport function getKeyName(key: TSESTree.Node): string | null {\n  if (key.type === 'Identifier') return key.name;\n  if (key.type === 'Literal' && typeof key.value === 'string') return key.value;\n  if (key.type === 'Literal' && typeof key.value === 'number')\n    return String(key.value);\n  return null;\n}\n\n/**\n * Gets the string value of a node if it is a string literal.\n */\nexport function getStringValue(node: TSESTree.Node): string | null {\n  if (node.type === 'Literal' && typeof node.value === 'string') {\n    return node.value;\n  }\n  if (node.type === 'TemplateLiteral' && node.expressions.length === 0) {\n    return node.quasis[0].value.cooked ?? null;\n  }\n  return null;\n}\n\n/**\n * Checks if a value node is a static literal.\n */\nexport function isStaticValue(node: TSESTree.Node): boolean {\n  node = unwrapExpression(node);\n  if (node.type === 'Literal') return true;\n  if (\n    node.type === 'UnaryExpression' &&\n    node.operator === '-' &&\n    node.argument.type === 'Literal'\n  ) {\n    return true;\n  }\n  if (node.type === 'TemplateLiteral' && node.expressions.length === 0) {\n    return true;\n  }\n  if (node.type === 'ArrayExpression') {\n    return node.elements.every((el) => el !== null && isStaticValue(el));\n  }\n  if (node.type === 'ObjectExpression') {\n    return node.properties.every(\n      (prop) =>\n        prop.type === 'Property' && !prop.computed && isStaticValue(prop.value),\n    );\n  }\n  return false;\n}\n\n/**\n * Validates color token syntax.\n * Returns null if valid, or an error message if invalid.\n */\nexport function validateColorTokenSyntax(token: string): string | null {\n  // Strip leading # or ##\n  let name = token;\n  if (name.startsWith('##')) {\n    name = name.slice(2);\n  } else if (name.startsWith('#')) {\n    name = name.slice(1);\n  } else {\n    return 'Color token must start with #';\n  }\n\n  if (name.length === 0) return 'Empty color token name';\n\n  // Check for opacity suffix\n  const dotIndex = name.indexOf('.');\n  if (dotIndex !== -1) {\n    const tokenName = name.slice(0, dotIndex);\n    const opacitySuffix = name.slice(dotIndex + 1);\n\n    if (tokenName.length === 0) return 'Empty color token name before opacity';\n\n    if (opacitySuffix.startsWith('$')) {\n      // Dynamic opacity from CSS custom property — always valid\n      return null;\n    }\n\n    if (opacitySuffix.length === 0) return 'Trailing dot with no opacity value';\n\n    const opacity = Number(opacitySuffix);\n    if (isNaN(opacity)) return `Invalid opacity value '${opacitySuffix}'`;\n    if (opacity < 0) return 'Opacity cannot be negative';\n    if (opacity > 100) return `Opacity '${opacitySuffix}' exceeds 100`;\n  }\n\n  return null;\n}\n\n/**\n * Checks if a string looks like a raw hex color (not a token).\n * Hex colors: #fff, #ffff, #ffffff, #ffffffff (3, 4, 6, or 8 hex chars).\n */\nexport function isRawHexColor(value: string): boolean {\n  if (!value.startsWith('#')) return false;\n  const hex = value.slice(1).split('.')[0];\n  if (![3, 4, 6, 8].includes(hex.length)) return false;\n  return /^[0-9a-fA-F]+$/.test(hex);\n}\n\n/**\n * Extracts custom unit from a value token like \"2x\", \"1.5r\", \"3cols\".\n * Returns the unit name, or null if not a custom-unit value.\n */\nexport function extractCustomUnit(token: string): string | null {\n  const match = token.match(/^-?[\\d.]+([a-zA-Z]+)$/);\n  if (!match) return null;\n  return match[1];\n}\n\n/**\n * Checks if a unit is valid (built-in, CSS, or in config).\n */\nexport function isValidUnit(unit: string, config: ResolvedConfig): boolean {\n  if (config.units === false) return true;\n  if (BUILT_IN_UNITS.has(unit)) return true;\n  if (CSS_UNITS.has(unit)) return true;\n  if (Array.isArray(config.units) && config.units.includes(unit)) return true;\n  return false;\n}\n\n/**\n * Checks if a state alias key (starting with @) is known.\n */\nexport function isKnownStateAlias(\n  key: string,\n  config: ResolvedConfig,\n): boolean {\n  // Built-in prefixes\n  for (const prefix of BUILT_IN_STATE_PREFIXES) {\n    if (key === prefix || key.startsWith(prefix + '(')) return true;\n  }\n  // Container query shorthand\n  if (key.startsWith('@(')) return true;\n  // Config aliases\n  return config.states.includes(key);\n}\n\n/**\n * Checks if a CSS selector string is basically valid.\n */\nexport function isValidSelector(selector: string): string | null {\n  if (selector.length === 0) return 'Selector cannot be empty';\n\n  // Check balanced brackets\n  let depth = 0;\n  for (const char of selector) {\n    if (char === '(' || char === '[') depth++;\n    if (char === ')' || char === ']') depth--;\n    if (depth < 0) return 'Unbalanced brackets in selector';\n  }\n  if (depth !== 0) return 'Unbalanced brackets in selector';\n\n  return null;\n}\n\n/**\n * Finds a property by key name in an object expression.\n */\nexport function findProperty(\n  obj: TSESTree.ObjectExpression,\n  name: string,\n): TSESTree.Property | undefined {\n  for (const prop of obj.properties) {\n    if (prop.type === 'Property' && !prop.computed) {\n      const keyName = getKeyName(prop.key);\n      if (keyName === name) return prop;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Collects local predefined state alias names from a styles ObjectExpression.\n * Local states are top-level `@name` keys with string literal values,\n * mirroring the runtime's `extractLocalPredefinedStates()`.\n */\nexport function collectLocalStateAliases(\n  node: TSESTree.ObjectExpression,\n): string[] {\n  const aliases: string[] = [];\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    if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(key)) continue;\n\n    // Skip built-in prefixes — they are not local state definitions\n    if (BUILT_IN_STATE_PREFIXES.has(key)) continue;\n\n    // Must have a string value to be a state definition\n    if (getStringValue(prop.value) !== null) {\n      aliases.push(key);\n    }\n  }\n\n  return aliases;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenphi/eslint-plugin-tasty",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "ESLint plugin for validating tasty() and tastyStatic() style objects",
   "type": "module",
   "exports": {
@@ -39,7 +39,7 @@
   },
   "homepage": "https://github.com/tenphi/eslint-plugin-tasty#readme",
   "peerDependencies": {
-    "@tenphi/tasty": ">=3",
+    "@tenphi/tasty": ">=3.8.0",
     "eslint": ">=8.0.0"
   },
   "dependencies": {
@@ -50,13 +50,14 @@
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.29.8",
     "@eslint/js": "^10.0.1",
-    "@tenphi/tasty": "^3.0.1",
+    "@tenphi/tasty": "^3.8.0",
     "@types/node": "^22.0.0",
     "@typescript-eslint/parser": "^8.56.1",
     "@typescript-eslint/rule-tester": "^8.56.1",
     "eslint": "^10.0.0",
     "eslint-config-prettier": "^10.1.8",
     "known-css-properties": "^0.37.0",
+    "oxlint": "1.83.0",
     "prettier": "^3.8.1",
     "react": "^19.2.8",
     "tsdown": "^0.20.3",
@@ -72,6 +73,7 @@
   "scripts": {
     "build": "tsdown",
     "test": "vitest run",
+    "test:linters": "node test/linter-integration.mjs",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",