pasika 0.10.110 → 0.10.112

package/dist/eslint/pasika/index.js

@@ -10375,24 +10375,170 @@ function applyOperationCount(utility) {
   }
   return count;
 }
+function themeCandidate(name, utilityText) {
+  const match = /^@utility\s+[\w-]+\s*\{\s*@apply\s+\[(?<property>font-size|letter-spacing):(?<value>[^\]\r\n;{}]+)\];?\s*\}$/u.exec(
+    utilityText.trim()
+  );
+  if (!match) return void 0;
+  const property = match.groups?.property;
+  const value = match.groups?.value?.trim();
+  if (!property || !value) return void 0;
+  const prefix = property === "font-size" ? "text-" : "tracking-";
+  if (!name.startsWith(prefix) || name.length === prefix.length) return void 0;
+  const length = /^-?(?:\d+(?:\.\d+)?|\.\d+)(?:px|rem|em|%)$/u.test(value);
+  const variable = /^var\(--[a-z][a-z0-9-]*\)$/u.test(value);
+  if (!length && !variable) return void 0;
+  if (property === "font-size" && value.startsWith("-")) return void 0;
+  return { token: `--${name}`, property, value };
+}
+var builtInTextSizes = /* @__PURE__ */ new Set([
+  "xs",
+  "sm",
+  "base",
+  "lg",
+  "xl",
+  "2xl",
+  "3xl",
+  "4xl",
+  "5xl",
+  "6xl",
+  "7xl",
+  "8xl",
+  "9xl"
+]);
+var builtInTracking = /* @__PURE__ */ new Set(["tighter", "tight", "normal", "wide", "wider", "widest"]);
+function lengthIdentity(value) {
+  const match = /^(?<number>-?(?:\d+(?:\.\d*)?|\.\d+))(?<unit>px|rem|em|%)$/u.exec(value);
+  const number = match?.groups?.number;
+  const unit = match?.groups?.unit;
+  if (!number || !unit) return void 0;
+  return `${String(Number(number))}${unit}`;
+}
+function declarationValue(text) {
+  const match = /^--[\w-]+\s*:\s*(?<value>[^;{}]+);?$/u.exec(text.trim());
+  return match?.groups?.value?.trim();
+}
+function canonicalToken(name) {
+  if (name.startsWith("--text-")) return builtInTextSizes.has(name.slice("--text-".length));
+  if (name.startsWith("--tracking-")) return builtInTracking.has(name.slice("--tracking-".length));
+  return false;
+}
+function isTypographySize(name) {
+  return /^--text-(?!.*--)(?:[a-z0-9]+-)*[a-z0-9]+$/u.test(name);
+}
 var utilityMappingRule = {
   meta: {
-    schema: [],
+    schema: [
+      {
+        type: "object",
+        properties: { preferThemeTokens: { type: "boolean" } },
+        additionalProperties: false
+      }
+    ],
     type: "problem",
     docs: {
-      description: "Require custom utilities to map exactly one Tailwind styling operation."
+      description: "Require one styling operation per custom utility; optionally suggest theme-generated utilities."
     }
   },
   create(context) {
+    const option = context.options[0];
+    const preferThemeTokens = typeof option === "object" && option !== null && "preferThemeTokens" in option && option.preferThemeTokens === true;
     return {
       "StyleSheet:exit"(node) {
-        for (const utility of atrulesNamed(node, "utility")) {
+        const utilities = atrulesNamed(node, "utility");
+        const themeTokens = /* @__PURE__ */ new Set();
+        const nameCounts = /* @__PURE__ */ new Map();
+        if (preferThemeTokens) {
+          let identity2 = function(value) {
+            const variable = /^var\((?<name>--[a-z][a-z0-9-]*)\)$/u.exec(value);
+            if (!variable) return lengthIdentity(value);
+            const name = variable.groups?.name;
+            if (!name || overriddenVariables.has(name)) return void 0;
+            const definitions = rootValues.get(name);
+            const definition = definitions?.length === 1 ? definitions[0] : void 0;
+            return definition ? lengthIdentity(definition) : void 0;
+          };
+          var identity = identity2;
+          for (const theme of atrulesNamed(node, "theme")) {
+            for (const child of blockChildren2(theme)) {
+              if (child.type === "Declaration") themeTokens.add(child.property);
+            }
+          }
+          for (const utility of utilities) {
+            const name = preludeIdentifiers(utility)[0] ?? "";
+            nameCounts.set(name, (nameCounts.get(name) ?? 0) + 1);
+          }
+          const themeDefinitions = /* @__PURE__ */ new Map();
+          for (const theme of atrulesNamed(node, "theme")) {
+            for (const child of blockChildren2(theme)) {
+              if (child.type !== "Declaration") continue;
+              const value = declarationValue(context.sourceCode.getText(child));
+              if (!value) continue;
+              const definitions = themeDefinitions.get(child.property) ?? [];
+              definitions.push({ node: child, value });
+              themeDefinitions.set(child.property, definitions);
+            }
+          }
+          const rootValues = /* @__PURE__ */ new Map();
+          const overriddenVariables = /* @__PURE__ */ new Set();
+          for (const cssRule of rules(node)) {
+            if (!("prelude" in cssRule) || !cssRule.prelude) continue;
+            const isRoot = context.sourceCode.getText(cssRule.prelude).trim() === ":root";
+            for (const child of blockChildren2(cssRule)) {
+              if (child.type !== "Declaration" || !child.property.startsWith("--")) continue;
+              if (!isRoot) {
+                overriddenVariables.add(child.property);
+                continue;
+              }
+              const value = declarationValue(context.sourceCode.getText(child));
+              if (!value) continue;
+              const definitions = rootValues.get(child.property) ?? [];
+              definitions.push(value);
+              rootValues.set(child.property, definitions);
+            }
+          }
+          for (const [name, definitions] of themeDefinitions) {
+            const definition = definitions.length === 1 ? definitions[0] : void 0;
+            if (!definition || canonicalToken(name)) continue;
+            if (!isTypographySize(name) && !name.startsWith("--tracking-")) continue;
+            if (name.includes("--", 2)) continue;
+            const value = identity2(definition.value);
+            if (!value) continue;
+            const prefix = name.startsWith("--text-") ? "--text-" : "--tracking-";
+            for (const [other, otherDefinitions] of themeDefinitions) {
+              const otherDefinition = otherDefinitions.length === 1 ? otherDefinitions[0] : void 0;
+              if (!canonicalToken(other) || !other.startsWith(prefix) || !otherDefinition) continue;
+              if (identity2(otherDefinition.value) !== value) continue;
+              if (prefix === "--text-" && ["--line-height", "--letter-spacing", "--font-weight"].some(
+                (suffix) => themeDefinitions.has(`${name}${suffix}`) || themeDefinitions.has(`${other}${suffix}`)
+              )) {
+                continue;
+              }
+              context.report({
+                node: definition.node,
+                message: `Theme token "${name}" duplicates the configured built-in "${other}" (${value}); reuse the "${other.slice(2)}" utility instead of defining an equivalent theme token.`
+              });
+              break;
+            }
+          }
+        }
+        for (const utility of utilities) {
           const name = preludeIdentifiers(utility)[0] ?? "unknown";
           const operationCount = applyOperationCount(utility);
-          if (operationCount === 1) continue;
+          if (operationCount !== 1) {
+            context.report({
+              node: utility,
+              message: `Custom utility "${name}" maps ${String(operationCount)} Tailwind operations; custom utilities must map exactly one operation. Reusable presentation belongs in a component.`
+            });
+            continue;
+          }
+          if (!preferThemeTokens || nameCounts.get(name) !== 1) continue;
+          const candidate = themeCandidate(name, context.sourceCode.getText(utility));
+          if (!candidate || themeTokens.has(candidate.token)) continue;
+          if (candidate.property === "font-size" && themeTokens.has(`--color-${name.slice(5)}`)) continue;
           context.report({
             node: utility,
-            message: `Custom utility "${name}" maps ${String(operationCount)} Tailwind operations; custom utilities must map exactly one operation. Reusable presentation belongs in a component.`
+            message: `Custom utility "${name}" only maps ${candidate.property} (${candidate.value}); prefer @theme inline token "${candidate.token}" backed by a :root variable. Preserve the class name and compare compiled CSS before removing the utility.`
           });
         }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.10.110",
+  "version": "0.10.112",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",