@tenphi/eslint-plugin-tasty 1.10.0 → 1.12.0

package/dist/protected-components.js

@@ -0,0 +1,188 @@
+import { DIMENSION_STYLES, POSITION_STYLES } from "./constants.js";
+import { unwrapExpression, wildcardPattern } from "./utils.js";
+import { resolveModuleExportOrigin, withMembers } from "./module-components.js";
+
+//#region src/protected-components.ts
+function namePattern(pattern) {
+	return {
+		regex: wildcardPattern(pattern),
+		member: pattern.includes(".")
+	};
+}
+const STYLE_PROP_GROUPS = new Map([["position", POSITION_STYLES], ["dimension", DIMENSION_STYLES]]);
+const entriesByConfig = /* @__PURE__ */ new WeakMap();
+function readEntries(config) {
+	let entries = entriesByConfig.get(config);
+	if (entries) return entries;
+	const list = config.protectedComponents ?? [];
+	if (!Array.isArray(list)) throw new Error("tasty: protectedComponents must be an array.");
+	entries = list.map((item, index) => {
+		const at = `tasty: protectedComponents[${index}]`;
+		if (!item || typeof item !== "object" || typeof item.source !== "string") throw new Error(`${at} must be an object with a string 'source'.`);
+		const entry = item;
+		const strings = (key) => {
+			const value = entry[key];
+			if (value === void 0) return key === "include" ? ["*"] : [];
+			if (!Array.isArray(value) || value.some((name) => typeof name !== "string")) throw new Error(`${at}.${key} must be an array of strings.`);
+			return value;
+		};
+		return {
+			source: wildcardPattern(entry.source),
+			include: strings("include").map(namePattern),
+			exclude: strings("exclude").map(namePattern),
+			allowedStyleProps: new Set(strings("allowedStyleProps").flatMap((name) => STYLE_PROP_GROUPS.get(name) ?? [name]))
+		};
+	});
+	entriesByConfig.set(config, entries);
+	return entries;
+}
+function importedName(specifier) {
+	return specifier.imported.type === "Identifier" ? specifier.imported.name : specifier.imported.value;
+}
+/**
+* Resolves JSX tags and `tasty()` bases to the `protectedComponents` entry they
+* name, by the name their source exports them under plus any members read off
+* it (`Button.Group`). Aliases, namespace members (`UI.Button`), `const`
+* aliases, `tasty()` wrappers and relative re-exports are followed; relative
+* modules need the `typescript` package, as for other cross-file recognition.
+*/
+var ProtectedComponents = class {
+	entries;
+	bindings = /* @__PURE__ */ new WeakMap();
+	modules = /* @__PURE__ */ new Map();
+	constructor(context, ctx) {
+		this.context = context;
+		this.ctx = ctx;
+		this.entries = readEntries(ctx.config);
+	}
+	get enabled() {
+		return this.entries.length > 0;
+	}
+	/** `tasty(Base, ...)`: a Tasty wrapper of an existing component. */
+	isWrapperCall(node) {
+		const base = node.arguments[0];
+		return this.ctx.isTastyCall(node)?.importedName === "tasty" && base !== void 0 && base.type !== "SpreadElement" && unwrapExpression(base).type !== "ObjectExpression";
+	}
+	/** The protected component a JSX tag name refers to. */
+	resolveTag(name) {
+		if (name.type === "JSXIdentifier" && !/^[A-Z]/.test(name.name)) return null;
+		let root = name;
+		const members = [];
+		while (root.type === "JSXMemberExpression") {
+			members.unshift(root.property.name);
+			root = root.object;
+		}
+		if (root.type !== "JSXIdentifier") return null;
+		return this.match(this.resolveBinding(root, root.name, members, /* @__PURE__ */ new Set()));
+	}
+	/** The protected component an expression, such as a `tasty()` base, refers to. */
+	resolveExpression(node) {
+		return this.match(this.origin(node, [], /* @__PURE__ */ new Set()));
+	}
+	/**
+	* The most specific name decides: an entry that names a member path
+	* (`Button.Group`, `Button.*`) in `include` or `exclude` wins over one that
+	* matches only the export, so a sub-component that is a separate component
+	* can follow its own entry. Longer paths are tried first.
+	*/
+	match(origin) {
+		if (!origin) return null;
+		const entries = this.entries.filter((entry) => entry.source.test(origin.source));
+		const protect = (name, entry) => ({
+			name,
+			source: origin.source,
+			wrapped: origin.wrapped,
+			allowedStyleProps: entry.allowedStyleProps
+		});
+		const parts = [origin.name, ...origin.members];
+		for (let length = parts.length; length > 1; length--) {
+			const path = parts.slice(0, length).join(".");
+			const names = (patterns) => patterns.some((pattern) => pattern.member && pattern.regex.test(path));
+			for (const entry of entries) {
+				if (names(entry.exclude)) return null;
+				if (names(entry.include)) return protect(path, entry);
+			}
+		}
+		const matches = (patterns) => patterns.some((pattern) => !pattern.member && pattern.regex.test(origin.name));
+		const entry = entries.find((candidate) => matches(candidate.include) && !matches(candidate.exclude));
+		return entry ? protect(origin.name, entry) : null;
+	}
+	origin(node, members, visited) {
+		const value = unwrapExpression(node);
+		if (value.type === "Identifier") return this.resolveBinding(value, value.name, members, visited);
+		if (value.type === "MemberExpression") {
+			let root = value;
+			const path = [...members];
+			while (root.type === "MemberExpression") {
+				if (root.computed || root.property.type !== "Identifier") return null;
+				path.unshift(root.property.name);
+				root = unwrapExpression(root.object);
+			}
+			return root.type === "Identifier" ? this.resolveBinding(root, root.name, path, visited) : null;
+		}
+		if (members.length === 0 && value.type === "CallExpression" && this.isWrapperCall(value)) {
+			const origin = this.origin(value.arguments[0], [], visited);
+			return origin && {
+				...origin,
+				wrapped: true
+			};
+		}
+		return null;
+	}
+	/** `members` are the properties read off the binding, as in `UI.Button.Group`. */
+	resolveBinding(reference, localName, members, visited) {
+		let scope = this.context.sourceCode.getScope(reference);
+		while (scope && !scope.set.has(localName)) scope = scope.upper;
+		const variable = scope?.set.get(localName);
+		if (!variable || variable.defs.length !== 1) return null;
+		let cache = this.bindings.get(variable);
+		if (!cache) {
+			cache = /* @__PURE__ */ new Map();
+			this.bindings.set(variable, cache);
+		}
+		const key = members.join(".");
+		if (cache.has(key)) return cache.get(key);
+		const result = this.resolveDefinition(variable.defs[0], members, visited);
+		cache.set(key, result);
+		return result;
+	}
+	resolveDefinition(def, members, visited) {
+		if (def.type === "ImportBinding") {
+			if (def.parent.type !== "ImportDeclaration" || def.parent.importKind === "type") return null;
+			const specifier = def.node;
+			let name;
+			let rest = members;
+			if (specifier.type === "ImportNamespaceSpecifier") [name, ...rest] = members;
+			else if (specifier.type === "ImportDefaultSpecifier") name = "default";
+			else if (specifier.type === "ImportSpecifier") {
+				if (specifier.importKind === "type") return null;
+				name = importedName(specifier);
+			}
+			if (name === void 0) return null;
+			const source = def.parent.source.value;
+			if (!source.startsWith(".")) return {
+				source,
+				name,
+				members: rest,
+				wrapped: false
+			};
+			return withMembers(this.moduleOrigin(source, name), rest);
+		}
+		if (def.type !== "Variable" || def.parent.kind !== "const" || def.node.id.type !== "Identifier" || !def.node.init || visited.has(def.node)) return null;
+		visited.add(def.node);
+		return this.origin(def.node.init, members, visited);
+	}
+	moduleOrigin(source, exportName) {
+		const key = `${source}\0${exportName}`;
+		if (!this.modules.has(key)) this.modules.set(key, resolveModuleExportOrigin(this.context.filename, source, exportName, {
+			importSources: this.ctx.trackedSources,
+			isComponentFactory: (name) => name === "tasty",
+			isOriginSource: (candidate) => this.entries.some((entry) => entry.source.test(candidate))
+		}));
+		return this.modules.get(key);
+	}
+};
+
+//#endregion
+export { ProtectedComponents };
+//# sourceMappingURL=protected-components.js.map

package/dist/protected-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protected-components.js","names":[],"sources":["../src/protected-components.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport type { RuleContext, Scope } from '@typescript-eslint/utils/ts-eslint';\nimport type { TastyContext } from './context.js';\nimport type { ResolvedConfig } from './types.js';\nimport { DIMENSION_STYLES, POSITION_STYLES } from './constants.js';\nimport {\n  type ModuleExportOrigin,\n  resolveModuleExportOrigin,\n  withMembers,\n} from './module-components.js';\nimport { unwrapExpression, wildcardPattern } from './utils.js';\n\n/** A component resolved to a `protectedComponents` entry. */\nexport interface ProtectedComponent {\n  /**\n   * The name it is protected under: the export name (`Button` for `<UI.Button>`,\n   * an alias or `<Button.Split>`), or the member path an entry names, such as\n   * `Button.Group`.\n   */\n  name: string;\n  source: string;\n  /** Whether a `tasty()` wrapper sits between the reference and the export. */\n  wrapped: boolean;\n  allowedStyleProps: ReadonlySet<string>;\n}\n\ninterface Pattern {\n  regex: RegExp;\n  /** Names a member path, such as `Button.Group` or `Button.*`. */\n  member: boolean;\n}\n\ninterface Entry {\n  source: RegExp;\n  include: Pattern[];\n  exclude: Pattern[];\n  allowedStyleProps: ReadonlySet<string>;\n}\n\nfunction namePattern(pattern: string): Pattern {\n  return { regex: wildcardPattern(pattern), member: pattern.includes('.') };\n}\n\nconst STYLE_PROP_GROUPS = new Map<string, readonly string[]>([\n  ['position', POSITION_STYLES],\n  ['dimension', DIMENSION_STYLES],\n]);\n\nconst entriesByConfig = new WeakMap<ResolvedConfig, Entry[]>();\n\nfunction readEntries(config: ResolvedConfig): Entry[] {\n  let entries = entriesByConfig.get(config);\n  if (entries) return entries;\n\n  const list: unknown = config.protectedComponents ?? [];\n  if (!Array.isArray(list)) {\n    throw new Error('tasty: protectedComponents must be an array.');\n  }\n  entries = list.map((item: unknown, index): Entry => {\n    const at = `tasty: protectedComponents[${index}]`;\n    if (\n      !item ||\n      typeof item !== 'object' ||\n      typeof (item as { source?: unknown }).source !== 'string'\n    ) {\n      throw new Error(`${at} must be an object with a string 'source'.`);\n    }\n    const entry = item as Record<string, unknown>;\n    const strings = (key: string): string[] => {\n      const value = entry[key];\n      if (value === undefined) return key === 'include' ? ['*'] : [];\n      if (\n        !Array.isArray(value) ||\n        value.some((name) => typeof name !== 'string')\n      ) {\n        throw new Error(`${at}.${key} must be an array of strings.`);\n      }\n      return value as string[];\n    };\n    return {\n      source: wildcardPattern(entry.source as string),\n      include: strings('include').map(namePattern),\n      exclude: strings('exclude').map(namePattern),\n      allowedStyleProps: new Set(\n        strings('allowedStyleProps').flatMap(\n          (name) => STYLE_PROP_GROUPS.get(name) ?? [name],\n        ),\n      ),\n    };\n  });\n  entriesByConfig.set(config, entries);\n  return entries;\n}\n\nfunction importedName(specifier: TSESTree.ImportSpecifier): string {\n  return specifier.imported.type === 'Identifier'\n    ? specifier.imported.name\n    : specifier.imported.value;\n}\n\n/**\n * Resolves JSX tags and `tasty()` bases to the `protectedComponents` entry they\n * name, by the name their source exports them under plus any members read off\n * it (`Button.Group`). Aliases, namespace members (`UI.Button`), `const`\n * aliases, `tasty()` wrappers and relative re-exports are followed; relative\n * modules need the `typescript` package, as for other cross-file recognition.\n */\nexport class ProtectedComponents {\n  private entries: Entry[];\n  private bindings = new WeakMap<\n    Scope.Variable,\n    Map<string, ModuleExportOrigin | null>\n  >();\n  private modules = new Map<string, ModuleExportOrigin | null>();\n\n  constructor(\n    private context: RuleContext<string, unknown[]>,\n    private ctx: TastyContext,\n  ) {\n    this.entries = readEntries(ctx.config);\n  }\n\n  get enabled(): boolean {\n    return this.entries.length > 0;\n  }\n\n  /** `tasty(Base, ...)`: a Tasty wrapper of an existing component. */\n  isWrapperCall(node: TSESTree.CallExpression): boolean {\n    const base = node.arguments[0];\n    return (\n      this.ctx.isTastyCall(node)?.importedName === 'tasty' &&\n      base !== undefined &&\n      base.type !== 'SpreadElement' &&\n      unwrapExpression(base).type !== 'ObjectExpression'\n    );\n  }\n\n  /** The protected component a JSX tag name refers to. */\n  resolveTag(name: TSESTree.JSXTagNameExpression): ProtectedComponent | null {\n    // `<button>` is a native element whatever a `button` binding holds.\n    if (name.type === 'JSXIdentifier' && !/^[A-Z]/.test(name.name)) return null;\n    let root = name;\n    const members: string[] = [];\n    while (root.type === 'JSXMemberExpression') {\n      members.unshift(root.property.name);\n      root = root.object;\n    }\n    if (root.type !== 'JSXIdentifier') return null;\n    return this.match(this.resolveBinding(root, root.name, members, new Set()));\n  }\n\n  /** The protected component an expression, such as a `tasty()` base, refers to. */\n  resolveExpression(node: TSESTree.Node): ProtectedComponent | null {\n    return this.match(this.origin(node, [], new Set()));\n  }\n\n  /**\n   * The most specific name decides: an entry that names a member path\n   * (`Button.Group`, `Button.*`) in `include` or `exclude` wins over one that\n   * matches only the export, so a sub-component that is a separate component\n   * can follow its own entry. Longer paths are tried first.\n   */\n  private match(origin: ModuleExportOrigin | null): ProtectedComponent | null {\n    if (!origin) return null;\n    const entries = this.entries.filter((entry) =>\n      entry.source.test(origin.source),\n    );\n    const protect = (name: string, entry: Entry): ProtectedComponent => ({\n      name,\n      source: origin.source,\n      wrapped: origin.wrapped,\n      allowedStyleProps: entry.allowedStyleProps,\n    });\n\n    const parts = [origin.name, ...origin.members];\n    for (let length = parts.length; length > 1; length--) {\n      const path = parts.slice(0, length).join('.');\n      const names = (patterns: Pattern[]) =>\n        patterns.some((pattern) => pattern.member && pattern.regex.test(path));\n      for (const entry of entries) {\n        if (names(entry.exclude)) return null;\n        if (names(entry.include)) return protect(path, entry);\n      }\n    }\n\n    const matches = (patterns: Pattern[]) =>\n      patterns.some(\n        (pattern) => !pattern.member && pattern.regex.test(origin.name),\n      );\n    const entry = entries.find(\n      (candidate) => matches(candidate.include) && !matches(candidate.exclude),\n    );\n    return entry ? protect(origin.name, entry) : null;\n  }\n\n  private origin(\n    node: TSESTree.Node,\n    members: string[],\n    visited: Set<TSESTree.Node>,\n  ): ModuleExportOrigin | null {\n    const value = unwrapExpression(node);\n    if (value.type === 'Identifier') {\n      return this.resolveBinding(value, value.name, members, visited);\n    }\n    if (value.type === 'MemberExpression') {\n      let root: TSESTree.Node = value;\n      const path = [...members];\n      while (root.type === 'MemberExpression') {\n        if (root.computed || root.property.type !== 'Identifier') return null;\n        path.unshift(root.property.name);\n        root = unwrapExpression(root.object);\n      }\n      return root.type === 'Identifier'\n        ? this.resolveBinding(root, root.name, path, visited)\n        : null;\n    }\n    if (\n      members.length === 0 &&\n      value.type === 'CallExpression' &&\n      this.isWrapperCall(value)\n    ) {\n      const origin = this.origin(value.arguments[0], [], visited);\n      return origin && { ...origin, wrapped: true };\n    }\n    return null;\n  }\n\n  /** `members` are the properties read off the binding, as in `UI.Button.Group`. */\n  private resolveBinding(\n    reference: TSESTree.Node,\n    localName: string,\n    members: string[],\n    visited: Set<TSESTree.Node>,\n  ): ModuleExportOrigin | null {\n    let scope: Scope.Scope | null = this.context.sourceCode.getScope(reference);\n    while (scope && !scope.set.has(localName)) scope = scope.upper;\n    const variable = scope?.set.get(localName);\n    if (!variable || variable.defs.length !== 1) return null;\n\n    let cache = this.bindings.get(variable);\n    if (!cache) {\n      cache = new Map();\n      this.bindings.set(variable, cache);\n    }\n    const key = members.join('.');\n    if (cache.has(key)) return cache.get(key)!;\n\n    const result = this.resolveDefinition(variable.defs[0], members, visited);\n    cache.set(key, result);\n    return result;\n  }\n\n  private resolveDefinition(\n    def: Scope.Definition,\n    members: string[],\n    visited: Set<TSESTree.Node>,\n  ): ModuleExportOrigin | null {\n    if (def.type === 'ImportBinding') {\n      if (\n        def.parent.type !== 'ImportDeclaration' ||\n        def.parent.importKind === 'type'\n      ) {\n        return null;\n      }\n      const specifier = def.node;\n      let name: string | undefined;\n      let rest = members;\n      if (specifier.type === 'ImportNamespaceSpecifier') {\n        [name, ...rest] = members;\n      } else if (specifier.type === 'ImportDefaultSpecifier') name = 'default';\n      else if (specifier.type === 'ImportSpecifier') {\n        if (specifier.importKind === 'type') return null;\n        name = importedName(specifier);\n      }\n      if (name === undefined) return null;\n\n      const source = def.parent.source.value;\n      if (!source.startsWith('.')) {\n        return { source, name, members: rest, wrapped: false };\n      }\n      return withMembers(this.moduleOrigin(source, name), rest);\n    }\n\n    if (\n      def.type !== 'Variable' ||\n      def.parent.kind !== 'const' ||\n      def.node.id.type !== 'Identifier' ||\n      !def.node.init ||\n      visited.has(def.node)\n    ) {\n      return null;\n    }\n    visited.add(def.node);\n    return this.origin(def.node.init, members, visited);\n  }\n\n  private moduleOrigin(\n    source: string,\n    exportName: string,\n  ): ModuleExportOrigin | null {\n    const key = `${source}\\0${exportName}`;\n    if (!this.modules.has(key)) {\n      this.modules.set(\n        key,\n        resolveModuleExportOrigin(this.context.filename, source, exportName, {\n          importSources: this.ctx.trackedSources,\n          isComponentFactory: (name) => name === 'tasty',\n          isOriginSource: (candidate) =>\n            this.entries.some((entry) => entry.source.test(candidate)),\n        }),\n      );\n    }\n    return this.modules.get(key)!;\n  }\n}\n"],"mappings":"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"}

package/dist/rules/no-protected-restyle.js

@@ -0,0 +1,120 @@
+import { createRule } from "../create-rule.js";
+import { KNOWN_TASTY_PROPERTIES } from "../constants.js";
+import { getKeyName, unwrapExpression } from "../utils.js";
+import { TastyContext } from "../context.js";
+import { jsxElementPropListeners } from "./tasty-component-props.js";
+import { ProtectedComponents } from "../protected-components.js";
+
+//#region src/rules/no-protected-restyle.ts
+/** `tasty(Base, options)` keys that configure the wrapper instead of setting a default prop. */
+const WRAPPER_OPTIONS = new Set([
+	"as",
+	"element",
+	"elements",
+	"mods",
+	"modProps",
+	"qa",
+	"qaVal",
+	"styleProps",
+	"tokenProps",
+	"tokens",
+	"variant"
+]);
+/** `inputStyles`, `triggerStyles`, ...: styles for one of the component's inner elements. */
+function isInnerStylesProp(name) {
+	return /^[a-z][A-Za-z0-9]*Styles$/.test(name);
+}
+/** A value that cannot be a style value: a callback or an element. */
+function isNeverStyleValue(node) {
+	const value = unwrapExpression(node);
+	return value.type === "ArrowFunctionExpression" || value.type === "FunctionExpression" || value.type === "JSXElement" || value.type === "JSXFragment";
+}
+var no_protected_restyle_default = createRule({
+	name: "no-protected-restyle",
+	meta: {
+		type: "suggestion",
+		docs: { description: "Warn when a design system's protected components are restyled instead of customized through their props" },
+		messages: {
+			restyleProp: "'{{prop}}' restyles {{component}}, a protected {{source}} component. Customize it through its own props, 'tokens' or 'mods'. If this override is intended, explicitly disable tasty/no-protected-restyle for this usage with an ESLint comment and a reason.",
+			restyleWrapper: "This tasty() wrapper restyles {{component}}, a protected {{source}} component, through '{{prop}}'. Set its own props, 'tokens' or 'mods' instead. If this override is intended, explicitly disable tasty/no-protected-restyle for this usage with an ESLint comment and a reason."
+		},
+		schema: []
+	},
+	defaultOptions: [],
+	create(context) {
+		const ctx = new TastyContext(context);
+		const components = new ProtectedComponents(context, ctx);
+		if (!components.enabled) return {};
+		const styleProps = new Set([...KNOWN_TASTY_PROPERTIES, ...ctx.config.styles]);
+		/** Root `styles` that only places or sizes the component, through allowed keys. */
+		function placesOnly(value, target) {
+			const object = value && unwrapExpression(value);
+			return object?.type === "ObjectExpression" && object.properties.every((prop) => {
+				if (prop.type !== "Property" || prop.computed) return false;
+				const key = getKeyName(prop.key);
+				return key !== null && target.allowedStyleProps.has(key);
+			});
+		}
+		function restyles(name, value, target, attribute) {
+			if (name === "styles") return !placesOnly(value, target);
+			if (isInnerStylesProp(name)) return true;
+			if (!styleProps.has(name) || target.allowedStyleProps.has(name)) return false;
+			if (value && isNeverStyleValue(value)) return false;
+			return !(attribute && ctx.isComponentJSXProp(attribute));
+		}
+		function report(node, messageId, prop, target) {
+			context.report({
+				node,
+				messageId,
+				data: {
+					prop,
+					component: target.reference === target.name ? `'${target.name}'` : `'${target.reference}' (based on '${target.name}')`,
+					source: `'${target.source}'`
+				}
+			});
+		}
+		function checkWrapperOptions(options, target) {
+			for (const prop of options.properties) {
+				if (prop.type === "SpreadElement") {
+					const spread = unwrapExpression(prop.argument);
+					if (spread.type === "ObjectExpression") checkWrapperOptions(spread, target);
+					continue;
+				}
+				const key = prop.computed ? unwrapExpression(prop.key) : prop.key;
+				if (prop.computed && key.type !== "Literal") continue;
+				const name = getKeyName(key);
+				if (name === null || WRAPPER_OPTIONS.has(name)) continue;
+				if (name === "variants" || restyles(name, prop.value, target)) report(prop, "restyleWrapper", name, target);
+			}
+		}
+		return {
+			...jsxElementPropListeners(ctx, (node) => {
+				const target = components.resolveTag(node.name);
+				return target && {
+					...target,
+					reference: context.sourceCode.getText(node.name)
+				};
+			}, (name, node, target) => {
+				if (restyles(name, node.type === "Property" ? node.value : node.value?.type === "JSXExpressionContainer" ? node.value.expression : node.value, target, node.type === "JSXAttribute" ? node : void 0)) report(node, "restyleProp", name, target);
+			}),
+			"Program:exit"() {
+				ctx.finishJSXAnalysis();
+			},
+			CallExpression(node) {
+				const [base, options] = node.arguments;
+				if (!options || !components.isWrapperCall(node)) return;
+				const component = components.resolveExpression(base);
+				const object = unwrapExpression(options);
+				if (!component || object.type !== "ObjectExpression") return;
+				checkWrapperOptions(object, {
+					...component,
+					reference: context.sourceCode.getText(unwrapExpression(base))
+				});
+			}
+		};
+	}
+});
+
+//#endregion
+export { no_protected_restyle_default as default };
+//# sourceMappingURL=no-protected-restyle.js.map

package/dist/rules/no-protected-restyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-protected-restyle.js","names":[],"sources":["../../src/rules/no-protected-restyle.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport { createRule } from '../create-rule.js';\nimport { TastyContext } from '../context.js';\nimport { KNOWN_TASTY_PROPERTIES } from '../constants.js';\nimport {\n  type ProtectedComponent,\n  ProtectedComponents,\n} from '../protected-components.js';\nimport { getKeyName, unwrapExpression } from '../utils.js';\nimport { jsxElementPropListeners } from './tasty-component-props.js';\n\ntype MessageIds = 'restyleProp' | 'restyleWrapper';\n\n/** `tasty(Base, options)` keys that configure the wrapper instead of setting a default prop. */\nconst WRAPPER_OPTIONS = new Set([\n  'as',\n  'element',\n  'elements',\n  'mods',\n  'modProps',\n  'qa',\n  'qaVal',\n  'styleProps',\n  'tokenProps',\n  'tokens',\n  'variant',\n]);\n\ninterface Target extends ProtectedComponent {\n  /** The tag or base as written: `UI.Button`, `CopyButton`. */\n  reference: string;\n}\n\n/** `inputStyles`, `triggerStyles`, ...: styles for one of the component's inner elements. */\nfunction isInnerStylesProp(name: string): boolean {\n  return /^[a-z][A-Za-z0-9]*Styles$/.test(name);\n}\n\n/** A value that cannot be a style value: a callback or an element. */\nfunction isNeverStyleValue(node: TSESTree.Node): boolean {\n  const value = unwrapExpression(node);\n  return (\n    value.type === 'ArrowFunctionExpression' ||\n    value.type === 'FunctionExpression' ||\n    value.type === 'JSXElement' ||\n    value.type === 'JSXFragment'\n  );\n}\n\nexport default createRule<[], MessageIds>({\n  name: 'no-protected-restyle',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        \"Warn when a design system's protected components are restyled instead of customized through their props\",\n    },\n    messages: {\n      restyleProp:\n        \"'{{prop}}' restyles {{component}}, a protected {{source}} component. Customize it through its own props, 'tokens' or 'mods'. If this override is intended, explicitly disable tasty/no-protected-restyle for this usage with an ESLint comment and a reason.\",\n      restyleWrapper:\n        \"This tasty() wrapper restyles {{component}}, a protected {{source}} component, through '{{prop}}'. Set its own props, 'tokens' or 'mods' instead. If this override is intended, explicitly disable tasty/no-protected-restyle for this usage with an ESLint comment and a reason.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const ctx = new TastyContext(context);\n    const components = new ProtectedComponents(context, ctx);\n    if (!components.enabled) return {};\n\n    const styleProps = new Set([\n      ...KNOWN_TASTY_PROPERTIES,\n      ...ctx.config.styles,\n    ]);\n\n    /** Root `styles` that only places or sizes the component, through allowed keys. */\n    function placesOnly(value: TSESTree.Node | null, target: Target): boolean {\n      const object = value && unwrapExpression(value);\n      return (\n        object?.type === 'ObjectExpression' &&\n        object.properties.every((prop) => {\n          if (prop.type !== 'Property' || prop.computed) return false;\n          const key = getKeyName(prop.key);\n          return key !== null && target.allowedStyleProps.has(key);\n        })\n      );\n    }\n\n    function restyles(\n      name: string,\n      value: TSESTree.Node | null,\n      target: Target,\n      attribute?: TSESTree.JSXAttribute,\n    ): boolean {\n      if (name === 'styles') return !placesOnly(value, target);\n      if (isInnerStylesProp(name)) return true;\n      if (!styleProps.has(name) || target.allowedStyleProps.has(name)) {\n        return false;\n      }\n      if (value && isNeverStyleValue(value)) return false;\n      // With typeAwareJSX, a prop the component declares itself is not a style prop.\n      return !(attribute && ctx.isComponentJSXProp(attribute));\n    }\n\n    function report(\n      node: TSESTree.Node,\n      messageId: MessageIds,\n      prop: string,\n      target: Target,\n    ): void {\n      context.report({\n        node,\n        messageId,\n        data: {\n          prop,\n          component:\n            target.reference === target.name\n              ? `'${target.name}'`\n              : `'${target.reference}' (based on '${target.name}')`,\n          source: `'${target.source}'`,\n        },\n      });\n    }\n\n    function checkWrapperOptions(\n      options: TSESTree.ObjectExpression,\n      target: Target,\n    ): void {\n      for (const prop of options.properties) {\n        if (prop.type === 'SpreadElement') {\n          const spread = unwrapExpression(prop.argument);\n          if (spread.type === 'ObjectExpression') {\n            checkWrapperOptions(spread, target);\n          }\n          continue;\n        }\n        const key = prop.computed ? unwrapExpression(prop.key) : prop.key;\n        if (prop.computed && key.type !== 'Literal') continue;\n        const name = getKeyName(key);\n        if (name === null || WRAPPER_OPTIONS.has(name)) continue;\n        if (name === 'variants' || restyles(name, prop.value, target)) {\n          report(prop, 'restyleWrapper', name, target);\n        }\n      }\n    }\n\n    const jsx = jsxElementPropListeners(\n      ctx,\n      (node): Target | null => {\n        const target = components.resolveTag(node.name);\n        return (\n          target && {\n            ...target,\n            reference: context.sourceCode.getText(node.name),\n          }\n        );\n      },\n      (name, node, target) => {\n        const value =\n          node.type === 'Property'\n            ? node.value\n            : node.value?.type === 'JSXExpressionContainer'\n              ? node.value.expression\n              : node.value;\n        const attribute = node.type === 'JSXAttribute' ? node : undefined;\n        if (restyles(name, value, target, attribute)) {\n          report(node, 'restyleProp', name, target);\n        }\n      },\n    );\n\n    return {\n      ...jsx,\n      'Program:exit'() {\n        ctx.finishJSXAnalysis();\n      },\n      CallExpression(node) {\n        const [base, options] = node.arguments;\n        if (!options || !components.isWrapperCall(node)) return;\n        const component = components.resolveExpression(base);\n        const object = unwrapExpression(options);\n        if (!component || object.type !== 'ObjectExpression') return;\n        checkWrapperOptions(object, {\n          ...component,\n          reference: context.sourceCode.getText(unwrapExpression(base)),\n        });\n      },\n    };\n  },\n});\n"],"mappings":"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"}

package/dist/rules/tasty-component-props.js

@@ -2,39 +2,47 @@ import { getKeyName, unwrapExpression } from "../utils.js";
 
 //#region src/rules/tasty-component-props.ts
 /**
-* Inspect explicit props and inline object spreads on every JSX element without
-* evaluating spread bindings. `kinds` limits which elements are classified and
-* checked, so a Tasty-only rule never runs component recognition elsewhere.
+* Inspect explicit props and inline object spreads on JSX elements without
+* evaluating spread bindings. `classify` picks the elements to check and what
+* the check is told about each; `null` skips the element.
 */
-function jsxPropListeners(ctx, kinds, check) {
-	function visitSpread(node, kind) {
+function jsxElementPropListeners(ctx, classify, check) {
+	function visitSpread(node, target) {
 		node = unwrapExpression(node);
 		if (node.type !== "ObjectExpression") return;
-		for (const prop of node.properties) if (prop.type === "SpreadElement") visitSpread(prop.argument, kind);
+		for (const prop of node.properties) if (prop.type === "SpreadElement") visitSpread(prop.argument, target);
 		else {
 			const name = prop.computed ? getKeyName(unwrapExpression(prop.key)) : getKeyName(prop.key);
-			if (name !== null && (!prop.computed || unwrapExpression(prop.key).type === "Literal")) check(name, prop, kind);
+			if (name !== null && (!prop.computed || unwrapExpression(prop.key).type === "Literal")) check(name, prop, target);
 		}
 	}
-	function classify(node) {
-		let name = node.name;
-		while (name.type === "JSXMemberExpression") name = name.object;
-		if (name.type !== "JSXIdentifier" || node.name.type === "JSXIdentifier" && !/^[A-Z]/.test(name.name)) return kinds.has("element") ? "element" : null;
-		if (kinds.has("tasty") && ctx.isTastyJSXComponent(node, name.name)) return "tasty";
-		return kinds.has("component") ? "component" : null;
-	}
 	return {
 		ImportDeclaration(node) {
 			ctx.trackImport(node);
 		},
 		JSXOpeningElement(node) {
-			const kind = classify(node);
-			if (!kind) return;
-			for (const attribute of node.attributes) if (attribute.type === "JSXSpreadAttribute") visitSpread(attribute.argument, kind);
-			else if (attribute.name.type === "JSXIdentifier") check(attribute.name.name, attribute, kind);
+			const target = classify(node);
+			if (target === null) return;
+			for (const attribute of node.attributes) if (attribute.type === "JSXSpreadAttribute") visitSpread(attribute.argument, target);
+			else if (attribute.name.type === "JSXIdentifier") check(attribute.name.name, attribute, target);
 		}
 	};
 }
+/**
+* Inspect explicit props and inline object spreads on every JSX element without
+* evaluating spread bindings. `kinds` limits which elements are classified and
+* checked, so a Tasty-only rule never runs component recognition elsewhere.
+*/
+function jsxPropListeners(ctx, kinds, check) {
+	function classify(node) {
+		let name = node.name;
+		while (name.type === "JSXMemberExpression") name = name.object;
+		if (name.type !== "JSXIdentifier" || node.name.type === "JSXIdentifier" && !/^[A-Z]/.test(name.name)) return kinds.has("element") ? "element" : null;
+		if (kinds.has("tasty") && ctx.isTastyJSXComponent(node, name.name)) return "tasty";
+		return kinds.has("component") ? "component" : null;
+	}
+	return jsxElementPropListeners(ctx, classify, check);
+}
 const TASTY_ONLY = new Set(["tasty"]);
 /** Inspect explicit props and inline object spreads on recognized Tasty components. */
 function tastyComponentPropListeners(ctx, check) {
@@ -42,5 +50,5 @@ function tastyComponentPropListeners(ctx, check) {
 }
 
 //#endregion
-export { jsxPropListeners, tastyComponentPropListeners };
+export { jsxElementPropListeners, jsxPropListeners, tastyComponentPropListeners };
 //# sourceMappingURL=tasty-component-props.js.map

package/dist/rules/tasty-component-props.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasty-component-props.js","names":[],"sources":["../../src/rules/tasty-component-props.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport type { TastyContext } from '../context.js';\nimport { getKeyName, unwrapExpression } from '../utils.js';\n\n/**\n * What a JSX element is, for prop rules: a recognized Tasty component, any\n * other component (capitalized or member tag), or a native element.\n */\nexport type JSXElementKind = 'tasty' | 'component' | 'element';\n\n/**\n * Inspect explicit props and inline object spreads on every JSX element without\n * evaluating spread bindings. `kinds` limits which elements are classified and\n * checked, so a Tasty-only rule never runs component recognition elsewhere.\n */\nexport function jsxPropListeners(\n  ctx: TastyContext,\n  kinds: ReadonlySet<JSXElementKind>,\n  check: (name: string, node: TSESTree.Node, kind: JSXElementKind) => void,\n) {\n  function visitSpread(node: TSESTree.Node, kind: JSXElementKind): void {\n    node = unwrapExpression(node);\n    if (node.type !== 'ObjectExpression') return;\n    for (const prop of node.properties) {\n      if (prop.type === 'SpreadElement') {\n        visitSpread(prop.argument, kind);\n      } else {\n        const name = prop.computed\n          ? getKeyName(unwrapExpression(prop.key))\n          : getKeyName(prop.key);\n        // A computed identifier is dynamic; a computed string literal is visible.\n        if (\n          name !== null &&\n          (!prop.computed || unwrapExpression(prop.key).type === 'Literal')\n        ) {\n          check(name, prop, kind);\n        }\n      }\n    }\n  }\n\n  function classify(node: TSESTree.JSXOpeningElement): JSXElementKind | null {\n    let name = node.name;\n    while (name.type === 'JSXMemberExpression') name = name.object;\n    // `<svg:rect>` and lowercase tags are native; `<motion.div>` is a component.\n    if (\n      name.type !== 'JSXIdentifier' ||\n      (node.name.type === 'JSXIdentifier' && !/^[A-Z]/.test(name.name))\n    ) {\n      return kinds.has('element') ? 'element' : null;\n    }\n    if (kinds.has('tasty') && ctx.isTastyJSXComponent(node, name.name))\n      return 'tasty';\n    return kinds.has('component') ? 'component' : null;\n  }\n\n  return {\n    ImportDeclaration(node: TSESTree.ImportDeclaration) {\n      ctx.trackImport(node);\n    },\n    JSXOpeningElement(node: TSESTree.JSXOpeningElement) {\n      const kind = classify(node);\n      if (!kind) return;\n      for (const attribute of node.attributes) {\n        if (attribute.type === 'JSXSpreadAttribute')\n          visitSpread(attribute.argument, kind);\n        else if (attribute.name.type === 'JSXIdentifier')\n          check(attribute.name.name, attribute, kind);\n      }\n    },\n  };\n}\n\nconst TASTY_ONLY = new Set<JSXElementKind>(['tasty']);\n\n/** Inspect explicit props and inline object spreads on recognized Tasty components. */\nexport function tastyComponentPropListeners(\n  ctx: TastyContext,\n  check: (name: string, node: TSESTree.Node) => void,\n) {\n  return jsxPropListeners(ctx, TASTY_ONLY, (name, node) => check(name, node));\n}\n"],"mappings":";;;;;;;;AAeA,SAAgB,iBACd,KACA,OACA,OACA;CACA,SAAS,YAAY,MAAqB,MAA4B;AACpE,SAAO,iBAAiB,KAAK;AAC7B,MAAI,KAAK,SAAS,mBAAoB;AACtC,OAAK,MAAM,QAAQ,KAAK,WACtB,KAAI,KAAK,SAAS,gBAChB,aAAY,KAAK,UAAU,KAAK;OAC3B;GACL,MAAM,OAAO,KAAK,WACd,WAAW,iBAAiB,KAAK,IAAI,CAAC,GACtC,WAAW,KAAK,IAAI;AAExB,OACE,SAAS,SACR,CAAC,KAAK,YAAY,iBAAiB,KAAK,IAAI,CAAC,SAAS,WAEvD,OAAM,MAAM,MAAM,KAAK;;;CAM/B,SAAS,SAAS,MAAyD;EACzE,IAAI,OAAO,KAAK;AAChB,SAAO,KAAK,SAAS,sBAAuB,QAAO,KAAK;AAExD,MACE,KAAK,SAAS,mBACb,KAAK,KAAK,SAAS,mBAAmB,CAAC,SAAS,KAAK,KAAK,KAAK,CAEhE,QAAO,MAAM,IAAI,UAAU,GAAG,YAAY;AAE5C,MAAI,MAAM,IAAI,QAAQ,IAAI,IAAI,oBAAoB,MAAM,KAAK,KAAK,CAChE,QAAO;AACT,SAAO,MAAM,IAAI,YAAY,GAAG,cAAc;;AAGhD,QAAO;EACL,kBAAkB,MAAkC;AAClD,OAAI,YAAY,KAAK;;EAEvB,kBAAkB,MAAkC;GAClD,MAAM,OAAO,SAAS,KAAK;AAC3B,OAAI,CAAC,KAAM;AACX,QAAK,MAAM,aAAa,KAAK,WAC3B,KAAI,UAAU,SAAS,qBACrB,aAAY,UAAU,UAAU,KAAK;YAC9B,UAAU,KAAK,SAAS,gBAC/B,OAAM,UAAU,KAAK,MAAM,WAAW,KAAK;;EAGlD;;AAGH,MAAM,aAAa,IAAI,IAAoB,CAAC,QAAQ,CAAC;;AAGrD,SAAgB,4BACd,KACA,OACA;AACA,QAAO,iBAAiB,KAAK,aAAa,MAAM,SAAS,MAAM,MAAM,KAAK,CAAC"}
+{"version":3,"file":"tasty-component-props.js","names":[],"sources":["../../src/rules/tasty-component-props.ts"],"sourcesContent":["import type { TSESTree } from '@typescript-eslint/utils';\nimport type { TastyContext } from '../context.js';\nimport { getKeyName, unwrapExpression } from '../utils.js';\n\n/**\n * What a JSX element is, for prop rules: a recognized Tasty component, any\n * other component (capitalized or member tag), or a native element.\n */\nexport type JSXElementKind = 'tasty' | 'component' | 'element';\n\n/** An explicit JSX attribute, or a key of an inline object spread. */\nexport type JSXPropNode = TSESTree.JSXAttribute | TSESTree.Property;\n\n/**\n * Inspect explicit props and inline object spreads on JSX elements without\n * evaluating spread bindings. `classify` picks the elements to check and what\n * the check is told about each; `null` skips the element.\n */\nexport function jsxElementPropListeners<T>(\n  ctx: TastyContext,\n  classify: (node: TSESTree.JSXOpeningElement) => T | null,\n  check: (name: string, node: JSXPropNode, target: T) => void,\n) {\n  function visitSpread(node: TSESTree.Node, target: T): void {\n    node = unwrapExpression(node);\n    if (node.type !== 'ObjectExpression') return;\n    for (const prop of node.properties) {\n      if (prop.type === 'SpreadElement') {\n        visitSpread(prop.argument, target);\n      } else {\n        const name = prop.computed\n          ? getKeyName(unwrapExpression(prop.key))\n          : getKeyName(prop.key);\n        // A computed identifier is dynamic; a computed string literal is visible.\n        if (\n          name !== null &&\n          (!prop.computed || unwrapExpression(prop.key).type === 'Literal')\n        ) {\n          check(name, prop, target);\n        }\n      }\n    }\n  }\n\n  return {\n    ImportDeclaration(node: TSESTree.ImportDeclaration) {\n      ctx.trackImport(node);\n    },\n    JSXOpeningElement(node: TSESTree.JSXOpeningElement) {\n      const target = classify(node);\n      if (target === null) return;\n      for (const attribute of node.attributes) {\n        if (attribute.type === 'JSXSpreadAttribute')\n          visitSpread(attribute.argument, target);\n        else if (attribute.name.type === 'JSXIdentifier')\n          check(attribute.name.name, attribute, target);\n      }\n    },\n  };\n}\n\n/**\n * Inspect explicit props and inline object spreads on every JSX element without\n * evaluating spread bindings. `kinds` limits which elements are classified and\n * checked, so a Tasty-only rule never runs component recognition elsewhere.\n */\nexport function jsxPropListeners(\n  ctx: TastyContext,\n  kinds: ReadonlySet<JSXElementKind>,\n  check: (name: string, node: JSXPropNode, kind: JSXElementKind) => void,\n) {\n  function classify(node: TSESTree.JSXOpeningElement): JSXElementKind | null {\n    let name = node.name;\n    while (name.type === 'JSXMemberExpression') name = name.object;\n    // `<svg:rect>` and lowercase tags are native; `<motion.div>` is a component.\n    if (\n      name.type !== 'JSXIdentifier' ||\n      (node.name.type === 'JSXIdentifier' && !/^[A-Z]/.test(name.name))\n    ) {\n      return kinds.has('element') ? 'element' : null;\n    }\n    if (kinds.has('tasty') && ctx.isTastyJSXComponent(node, name.name))\n      return 'tasty';\n    return kinds.has('component') ? 'component' : null;\n  }\n\n  return jsxElementPropListeners(ctx, classify, check);\n}\n\nconst TASTY_ONLY = new Set<JSXElementKind>(['tasty']);\n\n/** Inspect explicit props and inline object spreads on recognized Tasty components. */\nexport function tastyComponentPropListeners(\n  ctx: TastyContext,\n  check: (name: string, node: JSXPropNode) => void,\n) {\n  return jsxPropListeners(ctx, TASTY_ONLY, (name, node) => check(name, node));\n}\n"],"mappings":";;;;;;;;AAkBA,SAAgB,wBACd,KACA,UACA,OACA;CACA,SAAS,YAAY,MAAqB,QAAiB;AACzD,SAAO,iBAAiB,KAAK;AAC7B,MAAI,KAAK,SAAS,mBAAoB;AACtC,OAAK,MAAM,QAAQ,KAAK,WACtB,KAAI,KAAK,SAAS,gBAChB,aAAY,KAAK,UAAU,OAAO;OAC7B;GACL,MAAM,OAAO,KAAK,WACd,WAAW,iBAAiB,KAAK,IAAI,CAAC,GACtC,WAAW,KAAK,IAAI;AAExB,OACE,SAAS,SACR,CAAC,KAAK,YAAY,iBAAiB,KAAK,IAAI,CAAC,SAAS,WAEvD,OAAM,MAAM,MAAM,OAAO;;;AAMjC,QAAO;EACL,kBAAkB,MAAkC;AAClD,OAAI,YAAY,KAAK;;EAEvB,kBAAkB,MAAkC;GAClD,MAAM,SAAS,SAAS,KAAK;AAC7B,OAAI,WAAW,KAAM;AACrB,QAAK,MAAM,aAAa,KAAK,WAC3B,KAAI,UAAU,SAAS,qBACrB,aAAY,UAAU,UAAU,OAAO;YAChC,UAAU,KAAK,SAAS,gBAC/B,OAAM,UAAU,KAAK,MAAM,WAAW,OAAO;;EAGpD;;;;;;;AAQH,SAAgB,iBACd,KACA,OACA,OACA;CACA,SAAS,SAAS,MAAyD;EACzE,IAAI,OAAO,KAAK;AAChB,SAAO,KAAK,SAAS,sBAAuB,QAAO,KAAK;AAExD,MACE,KAAK,SAAS,mBACb,KAAK,KAAK,SAAS,mBAAmB,CAAC,SAAS,KAAK,KAAK,KAAK,CAEhE,QAAO,MAAM,IAAI,UAAU,GAAG,YAAY;AAE5C,MAAI,MAAM,IAAI,QAAQ,IAAI,IAAI,oBAAoB,MAAM,KAAK,KAAK,CAChE,QAAO;AACT,SAAO,MAAM,IAAI,YAAY,GAAG,cAAc;;AAGhD,QAAO,wBAAwB,KAAK,UAAU,MAAM;;AAGtD,MAAM,aAAa,IAAI,IAAoB,CAAC,QAAQ,CAAC;;AAGrD,SAAgB,4BACd,KACA,OACA;AACA,QAAO,iBAAiB,KAAK,aAAa,MAAM,SAAS,MAAM,MAAM,KAAK,CAAC"}

package/dist/types.d.ts

@@ -8,6 +8,28 @@ interface StyleFunctionConfig {
   /** Treat styles as a partial override of existing styles. Defaults to false. */
   partial?: boolean;
 }
+/** Design-system components whose look is a contract, for `no-protected-restyle`. */
+interface ProtectedComponentConfig {
+  /** Package the components are imported from. `*` matches any run of characters. */
+  source: string;
+  /**
+   * Exported names to protect, `*` matching any run of characters. Defaults to
+   * every export. A name with a dot is a member path, such as `Button.Split` or
+   * `Menu.*`, and wins over an entry that matches only the export.
+   */
+  include?: string[];
+  /**
+   * Exported names or member paths to leave out, such as layout and typography
+   * primitives, or a separate component attached as `Button.Group`.
+   */
+  exclude?: string[];
+  /**
+   * Style props that place or size the root and stay allowed: `'position'` and
+   * `'dimension'` stand for Tasty's `POSITION_STYLES` and `DIMENSION_STYLES`,
+   * anything else is a property name.
+   */
+  allowedStyleProps?: string[];
+}
 interface TastyValidationConfig {
   extends?: string;
   tokens?: false | string[];
@@ -39,6 +61,11 @@ interface TastyValidationConfig {
    * of characters, so `@my-org/*` covers every package under the scope.
    */
   ownedSources?: string[];
+  /**
+   * Components a consumer should customize through their props rather than
+   * restyle. Entries from an extended config come first; `false` drops them.
+   */
+  protectedComponents?: false | ProtectedComponentConfig[];
 }
 interface ResolvedConfig {
   tokens: false | string[];
@@ -59,7 +86,9 @@ interface ResolvedConfig {
   ownedSources?: string[];
   /** Optional for compatibility with existing consumer-built configs. */
   styleFunctions?: Record<string, StyleFunctionConfig>;
+  /** Optional for compatibility with existing consumer-built configs. */
+  protectedComponents?: ProtectedComponentConfig[];
 }
 //#endregion
-export { ResolvedConfig, StyleFunctionConfig, TastyValidationConfig };
+export { ProtectedComponentConfig, ResolvedConfig, StyleFunctionConfig, TastyValidationConfig };
 //# sourceMappingURL=types.d.ts.map

package/dist/utils.js

@@ -7,6 +7,11 @@ function unwrapExpression(node) {
 	while (current.type === "TSAsExpression" || current.type === "TSSatisfiesExpression" || current.type === "TSNonNullExpression" || current.type === "TSTypeAssertion" || current.type === "TSInstantiationExpression") current = current.expression;
 	return current;
 }
+/** A whole-string pattern in which `*` matches any run of characters. */
+function wildcardPattern(pattern) {
+	const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	return new RegExp(`^${escaped.replace(/\\\*/g, ".*")}$`);
+}
 /**
 * Gets the string value of a property key node.
 */
@@ -123,5 +128,5 @@ function collectLocalStateAliases(node) {
 }
 
 //#endregion
-export { collectLocalStateAliases, getKeyName, getStringValue, isKnownStateAlias, isRawHexColor, isStaticValue, isValidSelector, isValidUnit, unwrapExpression, validateColorTokenSyntax };
+export { collectLocalStateAliases, getKeyName, getStringValue, isKnownStateAlias, isRawHexColor, isStaticValue, isValidSelector, isValidUnit, unwrapExpression, validateColorTokenSyntax, wildcardPattern };
 //# 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/** 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    // Tasty reads the digits as a decimal fraction (`.5` and `.50` are 50%,\n    // `.150` is 15%), so any digit string is in range.\n    if (!/^\\d+$/.test(opacitySuffix)) {\n      return /^-\\d+$/.test(opacitySuffix)\n        ? 'Opacity cannot be negative'\n        : `Invalid opacity value '${opacitySuffix}'`;\n    }\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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"}
+{"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/** A whole-string pattern in which `*` matches any run of characters. */\nexport function wildcardPattern(pattern: string): RegExp {\n  const escaped = pattern.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n  return new RegExp(`^${escaped.replace(/\\\\\\*/g, '.*')}$`);\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    // Tasty reads the digits as a decimal fraction (`.5` and `.50` are 50%,\n    // `.150` is 15%), so any digit string is in range.\n    if (!/^\\d+$/.test(opacitySuffix)) {\n      return /^-\\d+$/.test(opacitySuffix)\n        ? 'Opacity cannot be negative'\n        : `Invalid opacity value '${opacitySuffix}'`;\n    }\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.10.0",
+  "version": "1.12.0",
   "description": "ESLint plugin for validating tasty() and tastyStatic() style objects",
   "type": "module",
   "exports": {