@yasainet/eslint 0.0.59 → 0.0.60

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasainet/eslint",
-  "version": "0.0.59",
+  "version": "0.0.60",
   "description": "ESLint",
   "type": "module",
   "exports": {

package/src/common/local-plugins/index.mjs

@@ -1,6 +1,7 @@
 import { featureNameRule } from "./feature-name.mjs";
 import { formStateNamingRule } from "./form-state-naming.mjs";
 import { importPathStyleRule } from "./import-path-style.mjs";
+import { layoutMainStructuralOnlyRule } from "./layout-main-structural-only.mjs";
 import { namespaceImportNameRule } from "./namespace-import-name.mjs";
 import { noAnyReturnRule } from "./no-any-return.mjs";
 import { queriesExportRule } from "./queries-export.mjs";
@@ -15,6 +16,7 @@ export const localPlugin = {
     "feature-name": featureNameRule,
     "form-state-naming": formStateNamingRule,
     "import-path-style": importPathStyleRule,
+    "layout-main-structural-only": layoutMainStructuralOnlyRule,
     "namespace-import-name": namespaceImportNameRule,
     "no-any-return": noAnyReturnRule,
     "queries-export": queriesExportRule,

package/src/common/local-plugins/layout-main-structural-only.mjs

@@ -0,0 +1,104 @@
+/**
+ * Forbid decoration utility classes on the `<main>` element.
+ *
+ * Design philosophy: `app/**\/layout.tsx` の `<main>` は Header / Footer の
+ * 縦積みを受け持つ構造スロット。装飾（余白・間隔）は page.tsx 側の Container 等が
+ * 持つべき。main に padding / margin / gap を直接当てると、page 全体に暗黙の
+ * オフセットが生まれ、page ごとの調整余地が失われる。
+ *
+ * Disallowed Tailwind token prefixes (case-sensitive):
+ *
+ * - `p`, `m`, `py`, `px`, `pt`, `pb`, `pl`, `pr`, `my`, `mx`, `mt`, `mb`, `ml`, `mr` — padding / margin
+ * - `space-x`, `space-y` — sibling spacing
+ * - `gap` — flex / grid gap
+ *
+ * Allowed: structural utilities (`flex`, `flex-1`, `flex-col`, `min-h-*`,
+ * `block`, `relative`, etc.)
+ *
+ * className value forms supported: string Literal, TemplateLiteral,
+ * `cn(...)` / `clsx(...)` style CallExpression args (string args only).
+ */
+
+const DISALLOWED_TOKEN = /^(?:[pm][xytrbl]?-|space-[xy]-|gap-)/;
+
+function collectStringLiterals(node, out) {
+  if (!node) return;
+  switch (node.type) {
+    case "Literal":
+      if (typeof node.value === "string") out.push(node.value);
+      return;
+    case "TemplateLiteral":
+      for (const q of node.quasis) {
+        if (typeof q.value.cooked === "string") out.push(q.value.cooked);
+      }
+      for (const expr of node.expressions) collectStringLiterals(expr, out);
+      return;
+    case "CallExpression":
+      for (const arg of node.arguments) collectStringLiterals(arg, out);
+      return;
+    case "ConditionalExpression":
+      collectStringLiterals(node.consequent, out);
+      collectStringLiterals(node.alternate, out);
+      return;
+    case "LogicalExpression":
+    case "BinaryExpression":
+      collectStringLiterals(node.left, out);
+      collectStringLiterals(node.right, out);
+      return;
+    case "ArrayExpression":
+      for (const el of node.elements) collectStringLiterals(el, out);
+      return;
+  }
+}
+
+function findInvalidTokens(strings) {
+  const invalid = [];
+  for (const s of strings) {
+    for (const token of s.split(/\s+/)) {
+      if (token && DISALLOWED_TOKEN.test(token)) {
+        invalid.push(token);
+      }
+    }
+  }
+  return invalid;
+}
+
+export const layoutMainStructuralOnlyRule = {
+  meta: {
+    type: "problem",
+    messages: {
+      invalidToken:
+        "<main> in layout.tsx must be structural-only. Move spacing/decoration ({{ tokens }}) to page.tsx (e.g. <Container className=\"py-8\">).",
+    },
+    schema: [],
+  },
+  create(context) {
+    return {
+      JSXOpeningElement(node) {
+        if (node.name?.type !== "JSXIdentifier") return;
+        if (node.name.name !== "main") return;
+
+        for (const attr of node.attributes) {
+          if (attr.type !== "JSXAttribute") continue;
+          if (attr.name?.name !== "className") continue;
+
+          const strings = [];
+          if (attr.value?.type === "Literal") {
+            collectStringLiterals(attr.value, strings);
+          } else if (attr.value?.type === "JSXExpressionContainer") {
+            collectStringLiterals(attr.value.expression, strings);
+          }
+
+          const invalid = findInvalidTokens(strings);
+          if (invalid.length > 0) {
+            context.report({
+              node: attr,
+              messageId: "invalidToken",
+              data: { tokens: invalid.join(", ") },
+            });
+          }
+        }
+      },
+    };
+  },
+};

package/src/next/index.mjs

@@ -10,6 +10,7 @@ import {
 
 import { directivesConfigs } from "./directives.mjs";
 import { importPathStyleConfigs } from "./imports.mjs";
+import { layoutsConfigs } from "./layouts.mjs";
 import { namingConfigs } from "./naming.mjs";
 
 const nextEntryPointConfigs = createEntryPointConfigs(
@@ -33,5 +34,6 @@ export const eslintConfig = [
   ...namingConfigs,
   ...directivesConfigs,
   ...importPathStyleConfigs,
+  ...layoutsConfigs,
   ...nextEntryPointConfigs,
 ];

package/src/next/layouts.mjs

@@ -0,0 +1,18 @@
+import { localPlugin } from "../common/local-plugins/index.mjs";
+
+/**
+ * Enforce design rules on Next.js layout files.
+ *
+ * - `<main>` is a structural slot, not a styling surface. Spacing and
+ *   decoration belong in page.tsx (e.g. `<Container className="py-8">`).
+ */
+export const layoutsConfigs = [
+  {
+    name: "layouts/main-structural-only",
+    files: ["src/app/**/layout.tsx"],
+    plugins: { local: localPlugin },
+    rules: {
+      "local/layout-main-structural-only": "error",
+    },
+  },
+];