@slip-stream-kit/eslint-plugin 0.1.2 → 0.1.5

package/dist/index.js

@@ -113,6 +113,52 @@ var getComponentFunction = (node) => {
   }
   return null;
 };
+var unwrapExport = (statement) => {
+  if (statement.type === "ExportNamedDeclaration" || statement.type === "ExportDefaultDeclaration") {
+    return statement.declaration ?? null;
+  }
+  return statement;
+};
+var declaresComponent = (node) => {
+  if (!node) {
+    return false;
+  }
+  if (node.type === "FunctionDeclaration") {
+    return isComponent(node);
+  }
+  if (node.type === "VariableDeclaration") {
+    return node.declarations.some((declaration) => {
+      const fn2 = getComponentFunction(declaration.init);
+      return fn2 ? isComponent(fn2) : false;
+    });
+  }
+  const fn = getComponentFunction(node);
+  return fn ? isComponent(fn) : false;
+};
+var getDeclaredComponentName = (node) => {
+  if (!node) {
+    return null;
+  }
+  if (node.type === "FunctionDeclaration") {
+    return isComponent(node) ? getComponentName(node) : null;
+  }
+  if (node.type === "VariableDeclaration") {
+    for (const declaration of node.declarations) {
+      const fn2 = getComponentFunction(declaration.init);
+      if (fn2 && isComponent(fn2)) {
+        return getComponentName(fn2);
+      }
+    }
+    return null;
+  }
+  const fn = getComponentFunction(node);
+  return fn && isComponent(fn) ? getComponentName(fn) : null;
+};
+var bodyDeclaresComponent = (body) => {
+  return body.some((statement) => {
+    return declaresComponent(unwrapExport(statement));
+  });
+};
 
 // src/utils/path-match.ts
 var REGEX_METACHARS = /* @__PURE__ */ new Set(["\\", "^", "$", ".", "|", "+", "(", ")", "[", "]", "{", "}"]);
@@ -149,43 +195,22 @@ var matchesAnyGlob = (filename, patterns) => {
 
 // src/rules/component-file-order.ts
 var PROPS_SUFFIX = "Props";
-var unwrapExport = (statement) => {
-  if (statement.type === "ExportNamedDeclaration" || statement.type === "ExportDefaultDeclaration") {
-    return statement.declaration ?? null;
-  }
-  return statement;
-};
-var isPropsTypeDeclaration = (node) => {
+var getPropsTypeName = (node) => {
   if (!node) {
-    return false;
+    return null;
   }
   const named = node;
   if (named.type !== "TSInterfaceDeclaration" && named.type !== "TSTypeAliasDeclaration") {
-    return false;
-  }
-  return named.id?.name?.endsWith(PROPS_SUFFIX) ?? false;
-};
-var declaresComponent = (node) => {
-  if (!node) {
-    return false;
-  }
-  if (node.type === "FunctionDeclaration") {
-    return isComponent(node);
-  }
-  if (node.type === "VariableDeclaration") {
-    return node.declarations.some((declaration) => {
-      const fn2 = getComponentFunction(declaration.init);
-      return fn2 ? isComponent(fn2) : false;
-    });
+    return null;
   }
-  const fn = getComponentFunction(node);
-  return fn ? isComponent(fn) : false;
+  const name = named.id?.name;
+  return name?.endsWith(PROPS_SUFFIX) ? name : null;
 };
 var componentFileOrder = {
   meta: {
     type: "suggestion",
     docs: {
-      description: "Enforce a strict top-level order in React component files: imports first, then the component props interface/type, then the component declaration.",
+      description: "Enforce a strict top-level order in React component files: imports first, then \u2014 for each component \u2014 its props interface/type declared immediately before the component.",
       recommended: true,
       url: "https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin"
     },
@@ -209,7 +234,7 @@ var componentFileOrder = {
     ],
     messages: {
       importsFirst: "Imports must come before the component interface and declaration.",
-      interfaceBeforeComponent: "The component props interface must be declared before the component."
+      interfaceImmediatelyBeforeComponent: "The component props interface must be declared immediately before the component."
     }
   },
   create(context) {
@@ -226,33 +251,40 @@ var componentFileOrder = {
       Program(program) {
         const body = program.body;
         const importIndices = [];
-        const propsIndices = [];
-        let componentIndex = -1;
+        const components = [];
+        const propsIndexByName = /* @__PURE__ */ new Map();
         body.forEach((statement, index) => {
           if (statement.type === "ImportDeclaration") {
             importIndices.push(index);
             return;
           }
           const declaration = unwrapExport(statement);
-          if (isPropsTypeDeclaration(declaration)) {
-            propsIndices.push(index);
+          const propsName = getPropsTypeName(declaration);
+          if (propsName !== null && !propsIndexByName.has(propsName)) {
+            propsIndexByName.set(propsName, index);
           }
-          if (componentIndex === -1 && declaresComponent(declaration)) {
-            componentIndex = index;
+          if (declaresComponent(declaration)) {
+            components.push({ index, name: getDeclaredComponentName(declaration) });
           }
         });
-        if (componentIndex === -1) {
+        if (components.length === 0) {
           return;
         }
-        const importBoundary = Math.min(componentIndex, ...propsIndices);
+        const first = components[0];
+        const firstPropsIndex = first.name === null ? void 0 : propsIndexByName.get(`${first.name}${PROPS_SUFFIX}`);
+        const importBoundary = Math.min(first.index, firstPropsIndex ?? first.index);
         for (const importIndex of importIndices) {
           if (importIndex > importBoundary) {
             context.report({ node: body[importIndex], messageId: "importsFirst" });
           }
         }
-        for (const propsIndex of propsIndices) {
-          if (propsIndex > componentIndex) {
-            context.report({ node: body[propsIndex], messageId: "interfaceBeforeComponent" });
+        for (const component of components) {
+          if (component.name === null) {
+            continue;
+          }
+          const propsIndex = propsIndexByName.get(`${component.name}${PROPS_SUFFIX}`);
+          if (propsIndex !== void 0 && propsIndex !== component.index - 1) {
+            context.report({ node: body[propsIndex], messageId: "interfaceImmediatelyBeforeComponent" });
           }
         }
       }
@@ -436,11 +468,213 @@ ${baseIndent}}`
   }
 };
 
+// src/rules/require-component-stories.ts
+import { existsSync } from "node:fs";
+import path2 from "node:path";
+
+// src/utils/story-path.ts
+import path from "node:path";
+var DEFAULT_STORY_PATH_OPTIONS = {
+  storiesDir: "__stories__",
+  storySuffix: ".stories",
+  storyExtensions: [".tsx", ".jsx", ".ts", ".js"],
+  componentExtensions: [".tsx", ".jsx"],
+  componentSuffix: "-component",
+  extraTargets: []
+};
+var resolveOptions = (opts) => {
+  return { ...DEFAULT_STORY_PATH_OPTIONS, ...opts };
+};
+var toPosix = (filePath) => {
+  return filePath.split("\\").join("/");
+};
+var parse = (filePath) => {
+  const normalized = toPosix(filePath);
+  const segments = normalized.split("/");
+  const basename = segments[segments.length - 1] ?? "";
+  const ext = path.posix.extname(basename);
+  const base = ext ? basename.slice(0, -ext.length) : basename;
+  return {
+    dir: path.posix.dirname(normalized),
+    base,
+    ext,
+    parent: segments[segments.length - 2] ?? "",
+    grandparent: segments[segments.length - 3] ?? "",
+    greatGrandparent: segments[segments.length - 4] ?? ""
+  };
+};
+var passesComponentPreconditions = (parsed, options) => {
+  if (!options.componentExtensions.includes(parsed.ext)) {
+    return false;
+  }
+  return options.componentSuffix === "" || parsed.base.endsWith(options.componentSuffix);
+};
+var classifyComponent = (filePath, opts) => {
+  const options = resolveOptions(opts);
+  const parsed = parse(filePath);
+  if (!passesComponentPreconditions(parsed, options)) {
+    return null;
+  }
+  if (parsed.parent === "components" && parsed.greatGrandparent === "features") {
+    return { mode: "feature-root" };
+  }
+  if (parsed.parent === "default" && parsed.grandparent === "components") {
+    return { mode: "sibling" };
+  }
+  for (const target of options.extraTargets) {
+    const parentMatches = parsed.parent === target.componentsDir;
+    const anchorMatches = target.anchorParentDir == null || parsed.grandparent === target.anchorParentDir;
+    if (parentMatches && anchorMatches) {
+      return { mode: target.storyMode };
+    }
+  }
+  return null;
+};
+var deriveExpectedStoryPaths = (filePath, opts) => {
+  const options = resolveOptions(opts);
+  const classification = classifyComponent(filePath, options);
+  if (!classification) {
+    return [];
+  }
+  const parsed = parse(filePath);
+  const storyBaseDir = classification.mode === "feature-root" ? path.posix.dirname(parsed.dir) : parsed.dir;
+  const storyDir = path.posix.join(storyBaseDir, options.storiesDir);
+  return options.storyExtensions.map((extension) => {
+    return path.posix.join(storyDir, `${parsed.base}${options.storySuffix}${extension}`);
+  });
+};
+
+// src/rules/require-component-stories.ts
+var toStoryPathOptions = (options) => {
+  const picked = {};
+  if (options.storiesDir !== void 0) {
+    picked.storiesDir = options.storiesDir;
+  }
+  if (options.storySuffix !== void 0) {
+    picked.storySuffix = options.storySuffix;
+  }
+  if (options.storyExtensions !== void 0) {
+    picked.storyExtensions = options.storyExtensions;
+  }
+  if (options.componentSuffix !== void 0) {
+    picked.componentSuffix = options.componentSuffix;
+  }
+  if (options.extraTargets !== void 0) {
+    picked.extraTargets = options.extraTargets;
+  }
+  return picked;
+};
+var requireComponentStories = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require a co-located Storybook story for every dumb component.",
+      recommended: true,
+      url: "https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin"
+    },
+    schema: [
+      {
+        type: "object",
+        properties: {
+          paths: {
+            type: "array",
+            items: { type: "string" },
+            description: "Optional globs; when provided the rule only runs for files whose path matches one."
+          },
+          ignore: {
+            type: "array",
+            items: { type: "string" },
+            description: "Optional globs; the rule is skipped for matching files, even if they also match `paths`."
+          },
+          storiesDir: {
+            type: "string",
+            description: `Story directory name (default '${DEFAULT_STORY_PATH_OPTIONS.storiesDir}').`
+          },
+          storySuffix: {
+            type: "string",
+            description: `Suffix inserted before the extension (default '${DEFAULT_STORY_PATH_OPTIONS.storySuffix}').`
+          },
+          storyExtensions: {
+            type: "array",
+            items: { type: "string" },
+            description: "Extensions a satisfying story file may have, in priority order."
+          },
+          componentSuffix: {
+            type: "string",
+            description: `Basename suffix a component file must end with (default '${DEFAULT_STORY_PATH_OPTIONS.componentSuffix}'; '' disables).`
+          },
+          requireComponentAst: {
+            type: "boolean",
+            description: "When true (default), only require a story for files that actually declare a component."
+          },
+          extraTargets: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                componentsDir: { type: "string" },
+                anchorParentDir: { type: "string" },
+                storyMode: { enum: ["feature-root", "sibling"] }
+              },
+              required: ["componentsDir", "storyMode"],
+              additionalProperties: false
+            },
+            description: "Extra structured component layouts (componentsDir + optional anchorParentDir + storyMode)."
+          }
+        },
+        additionalProperties: false
+      }
+    ],
+    messages: {
+      missingStory: "Dumb component '{{component}}' is missing a Storybook story (expected at '{{expected}}')."
+    }
+  },
+  create(context) {
+    const options = context.options[0] ?? {};
+    const paths = options.paths ?? [];
+    const ignore = options.ignore ?? [];
+    const requireComponentAst = options.requireComponentAst ?? true;
+    const storyPathOptions = toStoryPathOptions(options);
+    if (ignore.length > 0 && matchesAnyGlob(context.filename, ignore)) {
+      return {};
+    }
+    if (paths.length > 0 && !matchesAnyGlob(context.filename, paths)) {
+      return {};
+    }
+    return {
+      Program(program) {
+        if (!classifyComponent(context.filename, storyPathOptions)) {
+          return;
+        }
+        if (requireComponentAst && !bodyDeclaresComponent(program.body)) {
+          return;
+        }
+        const candidates = deriveExpectedStoryPaths(context.filename, storyPathOptions);
+        const hasStory = candidates.some((candidate) => {
+          return existsSync(candidate);
+        });
+        if (hasStory) {
+          return;
+        }
+        context.report({
+          node: program,
+          messageId: "missingStory",
+          data: {
+            component: path2.posix.basename(context.filename.split("\\").join("/")),
+            expected: candidates[0] ?? ""
+          }
+        });
+      }
+    };
+  }
+};
+
 // src/rules/index.ts
 var rules = {
   "props-destructuring-newline": propsDestructuringNewline,
   "props-destructuring-blank-line": propsDestructuringBlankLine,
-  "component-file-order": componentFileOrder
+  "component-file-order": componentFileOrder,
+  "require-component-stories": requireComponentStories
 };
 
 // src/index.ts
@@ -448,7 +682,7 @@ var PLUGIN_NAME = "@wl";
 var plugin = {
   meta: {
     name: "@wl/eslint-plugin",
-    version: "0.1.1"
+    version: "0.1.3"
   },
   rules,
   configs: {}
@@ -460,7 +694,8 @@ plugin.configs.recommended = {
   rules: {
     [`${PLUGIN_NAME}/props-destructuring-newline`]: "error",
     [`${PLUGIN_NAME}/props-destructuring-blank-line`]: "error",
-    [`${PLUGIN_NAME}/component-file-order`]: "error"
+    [`${PLUGIN_NAME}/component-file-order`]: "error",
+    [`${PLUGIN_NAME}/require-component-stories`]: "error"
   }
 };
 var meta = plugin.meta;

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/utils/component.ts", "../src/utils/path-match.ts", "../src/rules/component-file-order.ts", "../src/rules/props-destructuring-blank-line.ts", "../src/rules/props-destructuring-newline.ts", "../src/rules/index.ts", "../src/index.ts"],
-  "sourcesContent": ["import type * as ESTree from 'estree'\n\nexport type ComponentFunction = ESTree.ArrowFunctionExpression | ESTree.FunctionDeclaration | ESTree.FunctionExpression\n\n// Minimal structural view over the `parent` back-reference ESLint adds to every node.\ninterface WithParent {\n  parent?: ESTree.Node\n}\n\n// Calls that wrap a component while preserving its identity (memo, forwardRef, observer, ...).\nconst COMPONENT_WRAPPER_CALLEES = new Set(['memo', 'forwardRef', 'observer', 'React.memo', 'React.forwardRef'])\n\n// Node types that introduce a new function scope \u2014 their returns are not the outer component's.\nconst NESTED_SCOPES = new Set(['FunctionDeclaration', 'FunctionExpression', 'ArrowFunctionExpression'])\n\nconst isPascalCase = (name: string): boolean => {\n  return /^[A-Z]/.test(name)\n}\n\nconst isJsxNode = (node: ESTree.Node | null | undefined): boolean => {\n  if (!node) {\n    return false\n  }\n\n  const type = node.type as string\n\n  return type === 'JSXElement' || type === 'JSXFragment'\n}\n\nconst getParent = (node: ESTree.Node | undefined): ESTree.Node | undefined => {\n  return (node as (WithParent & ESTree.Node) | undefined)?.parent\n}\n\n/** Best-effort name of a call's callee: `memo` for `memo(...)`, `React.memo` for `React.memo(...)`. */\nconst getCalleeName = (callee: ESTree.CallExpression['callee']): string | null => {\n  if (callee.type === 'Identifier') {\n    return callee.name\n  }\n\n  if (\n    callee.type === 'MemberExpression' &&\n    callee.object.type === 'Identifier' &&\n    callee.property.type === 'Identifier'\n  ) {\n    return `${callee.object.name}.${callee.property.name}`\n  }\n\n  return null\n}\n\n/**\n * Resolve the declared name of a function, looking through component wrappers\n * such as `memo`/`forwardRef` so that `const Comp = memo(({ a }) => ...)` is\n * still recognised by its PascalCase variable name.\n */\nconst getComponentName = (node: ComponentFunction): string | null => {\n  if (node.type === 'FunctionDeclaration') {\n    return node.id?.name ?? null\n  }\n\n  let current = getParent(node)\n\n  // Walk through wrapping call expressions (memo, forwardRef, React.memo, ...).\n  while (current?.type === 'CallExpression') {\n    const calleeName = getCalleeName(current.callee)\n\n    if (!calleeName || !COMPONENT_WRAPPER_CALLEES.has(calleeName)) {\n      break\n    }\n\n    current = getParent(current)\n  }\n\n  if (current?.type === 'VariableDeclarator' && current.id.type === 'Identifier') {\n    return current.id.name\n  }\n\n  return null\n}\n\n/** Whether a function returns JSX, scanning its own body without descending into nested functions. */\nconst returnsJsx = (node: ComponentFunction): boolean => {\n  if (node.body.type !== 'BlockStatement') {\n    return isJsxNode(node.body)\n  }\n\n  let found = false\n\n  const visit = (current: ESTree.Node | null | undefined): void => {\n    if (found || !current || NESTED_SCOPES.has(current.type)) {\n      return\n    }\n\n    if (current.type === 'ReturnStatement') {\n      if (isJsxNode(current.argument)) {\n        found = true\n      }\n\n      return\n    }\n\n    if (current.type === 'IfStatement') {\n      visit(current.consequent)\n      visit(current.alternate)\n\n      return\n    }\n\n    if (current.type === 'BlockStatement') {\n      current.body.forEach(visit)\n\n      return\n    }\n\n    if (current.type === 'SwitchStatement') {\n      for (const switchCase of current.cases) {\n        switchCase.consequent.forEach(visit)\n      }\n\n      return\n    }\n\n    if (current.type === 'TryStatement') {\n      visit(current.block)\n      visit(current.handler?.body)\n      visit(current.finalizer)\n\n      return\n    }\n\n    if (\n      current.type === 'ForStatement' ||\n      current.type === 'ForInStatement' ||\n      current.type === 'ForOfStatement' ||\n      current.type === 'WhileStatement' ||\n      current.type === 'DoWhileStatement'\n    ) {\n      visit(current.body)\n    }\n  }\n\n  node.body.body.forEach(visit)\n\n  return found\n}\n\n/** A function is treated as a React component when it is PascalCase-named or returns JSX. */\nexport const isComponent = (node: ComponentFunction): boolean => {\n  const name = getComponentName(node)\n\n  if (name && isPascalCase(name)) {\n    return true\n  }\n\n  return returnsJsx(node)\n}\n\nconst isComponentFunctionNode = (node: ESTree.Node): node is ComponentFunction => {\n  return (\n    node.type === 'ArrowFunctionExpression' || node.type === 'FunctionExpression' || node.type === 'FunctionDeclaration'\n  )\n}\n\n/**\n * Extract the component function from an expression, unwrapping a single layer of\n * component wrappers (`memo(fn)`, `forwardRef(fn)`, `React.memo(fn)`, ...). Returns\n * null when no function is found.\n */\nexport const getComponentFunction = (node: ESTree.Node | null | undefined): ComponentFunction | null => {\n  if (!node) {\n    return null\n  }\n\n  if (isComponentFunctionNode(node)) {\n    return node\n  }\n\n  if (node.type === 'CallExpression') {\n    for (const argument of node.arguments) {\n      if (argument.type === 'SpreadElement') {\n        continue\n      }\n\n      const found = getComponentFunction(argument)\n\n      if (found) {\n        return found\n      }\n    }\n  }\n\n  return null\n}\n", "// Characters that must be escaped when embedded literally into a RegExp source.\nconst REGEX_METACHARS = new Set(['\\\\', '^', '$', '.', '|', '+', '(', ')', '[', ']', '{', '}'])\n\n/**\n * Convert a glob pattern to an (unanchored) RegExp.\n *\n * - `**` matches any characters, including path separators.\n * - `*` matches any characters except a path separator.\n * - `?` matches a single non-separator character.\n *\n * The result is intentionally unanchored so a pattern matches anywhere in the\n * path (e.g. `features/**` matches `/repo/src/features/x/comp.tsx`).\n */\nconst globToRegExp = (glob: string): RegExp => {\n  let source = ''\n\n  for (let index = 0; index < glob.length; index++) {\n    const char = glob[index]!\n\n    if (char === '*') {\n      if (glob[index + 1] === '*') {\n        source += '.*'\n        index++\n\n        // Consume a trailing slash so `**/foo` also matches a bare `foo`.\n        if (glob[index + 1] === '/') {\n          index++\n        }\n      } else {\n        source += '[^/]*'\n      }\n    } else if (char === '?') {\n      source += '[^/]'\n    } else if (REGEX_METACHARS.has(char)) {\n      source += `\\\\${char}`\n    } else {\n      source += char\n    }\n  }\n\n  return new RegExp(source)\n}\n\n/** Whether `filename` matches at least one of the provided glob `patterns`. */\nexport const matchesAnyGlob = (filename: string, patterns: readonly string[]): boolean => {\n  const normalized = filename.split('\\\\').join('/')\n\n  return patterns.some((pattern) => {\n    return globToRegExp(pattern).test(normalized)\n  })\n}\n", "import type { Rule } from 'eslint'\nimport type * as ESTree from 'estree'\n\nimport { getComponentFunction, isComponent } from '../utils/component'\nimport { matchesAnyGlob } from '../utils/path-match'\n\ninterface Options {\n  paths?: string[]\n  ignore?: string[]\n}\n\n// TS-only nodes are not modelled by estree; access their identifier structurally.\ninterface NamedDeclaration {\n  type: string\n  id?: { name?: string } | null\n}\n\nconst PROPS_SUFFIX = 'Props'\n\n/** Unwrap an `export ...` statement to the declaration it wraps (or the statement itself). */\nconst unwrapExport = (statement: ESTree.Statement | ESTree.ModuleDeclaration): ESTree.Node | null => {\n  if (statement.type === 'ExportNamedDeclaration' || statement.type === 'ExportDefaultDeclaration') {\n    return (statement.declaration as ESTree.Node | null) ?? null\n  }\n\n  return statement\n}\n\n/** Whether a declaration is a props interface/type alias (`SomethingProps`). */\nconst isPropsTypeDeclaration = (node: ESTree.Node | null): boolean => {\n  if (!node) {\n    return false\n  }\n\n  const named = node as NamedDeclaration\n\n  if (named.type !== 'TSInterfaceDeclaration' && named.type !== 'TSTypeAliasDeclaration') {\n    return false\n  }\n\n  return named.id?.name?.endsWith(PROPS_SUFFIX) ?? false\n}\n\n/** Whether a top-level declaration declares a React component. */\nconst declaresComponent = (node: ESTree.Node | null): boolean => {\n  if (!node) {\n    return false\n  }\n\n  if (node.type === 'FunctionDeclaration') {\n    return isComponent(node)\n  }\n\n  if (node.type === 'VariableDeclaration') {\n    return node.declarations.some((declaration) => {\n      const fn = getComponentFunction(declaration.init)\n\n      return fn ? isComponent(fn) : false\n    })\n  }\n\n  const fn = getComponentFunction(node)\n\n  return fn ? isComponent(fn) : false\n}\n\nexport const componentFileOrder: Rule.RuleModule = {\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'Enforce a strict top-level order in React component files: imports first, then the component props interface/type, then the component declaration.',\n      recommended: true,\n      url: 'https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: {\n          paths: {\n            type: 'array',\n            items: { type: 'string' },\n            description:\n              'Optional glob patterns. When provided, the rule only runs for files whose path matches one of them.',\n          },\n          ignore: {\n            type: 'array',\n            items: { type: 'string' },\n            description:\n              'Optional glob patterns. The rule is skipped for files whose path matches one of them, even if it also matches `paths`.',\n          },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      importsFirst: 'Imports must come before the component interface and declaration.',\n      interfaceBeforeComponent: 'The component props interface must be declared before the component.',\n    },\n  },\n\n  create(context) {\n    const options = (context.options[0] ?? {}) as Options\n    const paths = options.paths ?? []\n    const ignore = options.ignore ?? []\n\n    // `ignore` takes precedence: skip excluded files even when they also match `paths`.\n    if (ignore.length > 0 && matchesAnyGlob(context.filename, ignore)) {\n      return {}\n    }\n\n    if (paths.length > 0 && !matchesAnyGlob(context.filename, paths)) {\n      return {}\n    }\n\n    return {\n      Program(program) {\n        const body = program.body\n\n        const importIndices: number[] = []\n        const propsIndices: number[] = []\n        let componentIndex = -1\n\n        body.forEach((statement, index) => {\n          if (statement.type === 'ImportDeclaration') {\n            importIndices.push(index)\n\n            return\n          }\n\n          const declaration = unwrapExport(statement)\n\n          if (isPropsTypeDeclaration(declaration)) {\n            propsIndices.push(index)\n          }\n\n          if (componentIndex === -1 && declaresComponent(declaration)) {\n            componentIndex = index\n          }\n        })\n\n        // The rule only governs files that actually contain a component.\n        if (componentIndex === -1) {\n          return\n        }\n\n        // Imports must precede the first props interface and the component.\n        const importBoundary = Math.min(componentIndex, ...propsIndices)\n\n        for (const importIndex of importIndices) {\n          if (importIndex > importBoundary) {\n            context.report({ node: body[importIndex]!, messageId: 'importsFirst' })\n          }\n        }\n\n        // The props interface/type must precede the component declaration.\n        for (const propsIndex of propsIndices) {\n          if (propsIndex > componentIndex) {\n            context.report({ node: body[propsIndex]!, messageId: 'interfaceBeforeComponent' })\n          }\n        }\n      },\n    }\n  },\n}\n\nexport default componentFileOrder\n", "import type { Rule } from 'eslint'\nimport type * as ESTree from 'estree'\n\nimport type { ComponentFunction } from '../utils/component'\nimport { isComponent } from '../utils/component'\n\n/** Whether a statement is `const { ... } = props` (destructuring the `props` identifier). */\nconst isPropsDestructuring = (statement: ESTree.Statement): boolean => {\n  if (statement.type !== 'VariableDeclaration') {\n    return false\n  }\n\n  return statement.declarations.some((declaration) => {\n    return (\n      declaration.id.type === 'ObjectPattern' &&\n      declaration.init?.type === 'Identifier' &&\n      declaration.init.name === 'props'\n    )\n  })\n}\n\nexport const propsDestructuringBlankLine: Rule.RuleModule = {\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'Require a blank line after the `const { ... } = props` destructuring statement at the top of a React component body.',\n      recommended: true,\n      url: 'https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin',\n    },\n    fixable: 'whitespace',\n    schema: [],\n    messages: {\n      blankLineAfterProps: 'Add a blank line after destructuring props.',\n    },\n  },\n\n  create(context) {\n    const sourceCode = context.sourceCode\n\n    const check = (node: ComponentFunction): void => {\n      if (node.body.type !== 'BlockStatement') {\n        return\n      }\n\n      if (!isComponent(node)) {\n        return\n      }\n\n      const statements = node.body.body\n      const index = statements.findIndex(isPropsDestructuring)\n\n      if (index === -1) {\n        return\n      }\n\n      const propsStatement = statements[index]\n      const nextStatement = statements[index + 1]\n\n      // `propsStatement` is defined because `index !== -1`; the guard also narrows the type.\n      // Nothing follows the destructuring \u2014 no separation needed.\n      if (!propsStatement || !nextStatement) {\n        return\n      }\n\n      // The token/comment that follows the destructuring statement; a comment on the\n      // next line still counts as \"no blank line\" until it is pushed down.\n      const tokenAfter = sourceCode.getTokenAfter(propsStatement, { includeComments: true })\n      const referenceLine = (tokenAfter ?? nextStatement).loc!.start.line\n\n      if (referenceLine - propsStatement.loc!.end.line >= 2) {\n        return\n      }\n\n      context.report({\n        node: propsStatement,\n        messageId: 'blankLineAfterProps',\n        fix(fixer) {\n          return fixer.insertTextAfter(propsStatement, '\\n')\n        },\n      })\n    }\n\n    return {\n      ArrowFunctionExpression: check,\n      FunctionDeclaration: check,\n      FunctionExpression: check,\n    }\n  },\n}\n\nexport default propsDestructuringBlankLine\n", "import type { Rule } from 'eslint'\nimport type * as ESTree from 'estree'\n\nimport type { ComponentFunction } from '../utils/component'\nimport { isComponent } from '../utils/component'\n\n// Minimal structural views over nodes that estree's types do not fully model:\n// the optional TS type annotation and `range` that the parser attaches to params.\ninterface WithRange {\n  range?: [number, number]\n}\ntype AnnotatedPattern = ESTree.ObjectPattern & { typeAnnotation?: ESTree.Node & WithRange } & WithRange\n\n// Recursively collect every identifier a destructuring pattern binds, so we can detect\n// whether it already introduces a `props` binding (e.g. a `...props` rest).\nconst collectBoundNames = (node: ESTree.Node | null, names: Set<string>): void => {\n  if (!node) {\n    return\n  }\n\n  switch (node.type) {\n    case 'Identifier':\n      names.add(node.name)\n      break\n    case 'ObjectPattern':\n      for (const property of node.properties) collectBoundNames(property, names)\n      break\n    case 'ArrayPattern':\n      for (const element of node.elements) collectBoundNames(element, names)\n      break\n    case 'Property':\n      collectBoundNames(node.value, names)\n      break\n    case 'RestElement':\n      collectBoundNames(node.argument, names)\n      break\n    case 'AssignmentPattern':\n      collectBoundNames(node.left, names)\n      break\n    default:\n      break\n  }\n}\n\nexport const propsDestructuringNewline: Rule.RuleModule = {\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'Require React components to accept a single props parameter and destructure it on its own line in the body, rather than destructuring inline in the parameter list.',\n      recommended: true,\n      url: 'https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin',\n    },\n    fixable: 'code',\n    schema: [],\n    messages: {\n      destructureOnNewLine:\n        'Accept a single `props` parameter and destructure it on its own line in the component body instead of destructuring in the parameter list.',\n    },\n  },\n\n  create(context) {\n    const sourceCode = context.sourceCode\n\n    const check = (node: ComponentFunction): void => {\n      const firstParam = node.params[0]\n\n      if (!firstParam || firstParam.type !== 'ObjectPattern') {\n        return\n      }\n\n      if (!isComponent(node)) {\n        return\n      }\n\n      // The fix renames the parameter to `props` and re-destructures it in the body\n      // (`const <pattern> = props`). If the pattern already binds `props` (e.g. a\n      // `...props` rest), that body binding collides with the new parameter and yields\n      // an invalid \"Duplicate declaration props\". There is no safe rename that keeps the\n      // `props` name the rule mandates, so skip these patterns entirely.\n      const boundNames = new Set<string>()\n\n      collectBoundNames(firstParam, boundNames)\n\n      if (boundNames.has('props')) {\n        return\n      }\n\n      const objectPattern = firstParam as AnnotatedPattern\n\n      context.report({\n        node: firstParam,\n        messageId: 'destructureOnNewLine',\n        fix(fixer) {\n          const text = sourceCode.getText()\n          const annotation = objectPattern.typeAnnotation\n\n          const patternStart = objectPattern.range![0]\n          const patternEnd = annotation ? annotation.range![0] : objectPattern.range![1]\n          const fullEnd = annotation ? annotation.range![1] : objectPattern.range![1]\n\n          const patternText = text.slice(patternStart, patternEnd).trim()\n          const annotationText = annotation ? sourceCode.getText(annotation) : ''\n\n          const fixes = [fixer.replaceTextRange([patternStart, fullEnd], `props${annotationText}`)]\n\n          const destructureStatement = `const ${patternText} = props`\n\n          // Indentation of the line the component is declared on, used as the base for inserted code.\n          const lines = sourceCode.getLines()\n          const declarationLine = lines[node.loc!.start.line - 1] ?? ''\n          const baseIndent = declarationLine.slice(0, declarationLine.length - declarationLine.trimStart().length)\n          const innerIndent = `${baseIndent}  `\n\n          if (node.body.type === 'BlockStatement') {\n            const [firstStatement] = node.body.body\n\n            if (firstStatement) {\n              const indent = ' '.repeat(firstStatement.loc!.start.column)\n\n              fixes.push(fixer.insertTextBefore(firstStatement, `${destructureStatement}\\n\\n${indent}`))\n            } else {\n              const openBrace = sourceCode.getFirstToken(node.body)!\n\n              fixes.push(fixer.insertTextAfter(openBrace, `\\n${innerIndent}${destructureStatement}\\n${baseIndent}`))\n            }\n\n            return fixes\n          }\n\n          // Expression-bodied arrow (implicit return) \u2014 wrap it in a block.\n          const bodyText = sourceCode.getText(node.body)\n\n          fixes.push(\n            fixer.replaceText(\n              node.body,\n              `{\\n${innerIndent}${destructureStatement}\\n\\n${innerIndent}return ${bodyText}\\n${baseIndent}}`,\n            ),\n          )\n\n          return fixes\n        },\n      })\n    }\n\n    return {\n      ArrowFunctionExpression: check,\n      FunctionDeclaration: check,\n      FunctionExpression: check,\n    }\n  },\n}\n\nexport default propsDestructuringNewline\n", "import type { Rule } from 'eslint'\n\nimport { componentFileOrder } from './component-file-order'\nimport { propsDestructuringBlankLine } from './props-destructuring-blank-line'\nimport { propsDestructuringNewline } from './props-destructuring-newline'\n\nexport const rules: Record<string, Rule.RuleModule> = {\n  'props-destructuring-newline': propsDestructuringNewline,\n  'props-destructuring-blank-line': propsDestructuringBlankLine,\n  'component-file-order': componentFileOrder,\n}\n", "import type { ESLint, Linter } from 'eslint'\n\nimport { rules } from './rules'\n\nconst PLUGIN_NAME = '@wl'\n\nconst plugin: ESLint.Plugin & { configs: Record<string, Linter.Config> } = {\n  meta: {\n    name: '@wl/eslint-plugin',\n    version: '0.1.1',\n  },\n  rules,\n  configs: {},\n}\n\n/**\n * Flat-config preset that registers the plugin and turns every rule on.\n *\n * @example\n * import wl from '@wl/eslint-plugin'\n *\n * export default [wl.configs.recommended]\n */\nplugin.configs.recommended = {\n  plugins: {\n    [PLUGIN_NAME]: plugin,\n  },\n  rules: {\n    [`${PLUGIN_NAME}/props-destructuring-newline`]: 'error',\n    [`${PLUGIN_NAME}/props-destructuring-blank-line`]: 'error',\n    [`${PLUGIN_NAME}/component-file-order`]: 'error',\n  },\n}\n\nexport const meta: ESLint.Plugin['meta'] = plugin.meta\nexport const configs: Record<string, Linter.Config> = plugin.configs\nexport { rules }\n\nexport default plugin\n"],
-  "mappings": "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",
-  "names": ["fn"]
+  "sources": ["../src/utils/component.ts", "../src/utils/path-match.ts", "../src/rules/component-file-order.ts", "../src/rules/props-destructuring-blank-line.ts", "../src/rules/props-destructuring-newline.ts", "../src/rules/require-component-stories.ts", "../src/utils/story-path.ts", "../src/rules/index.ts", "../src/index.ts"],
+  "sourcesContent": ["import type * as ESTree from 'estree'\n\nexport type ComponentFunction = ESTree.ArrowFunctionExpression | ESTree.FunctionDeclaration | ESTree.FunctionExpression\n\n// Minimal structural view over the `parent` back-reference ESLint adds to every node.\ninterface WithParent {\n  parent?: ESTree.Node\n}\n\n// Calls that wrap a component while preserving its identity (memo, forwardRef, observer, ...).\nconst COMPONENT_WRAPPER_CALLEES = new Set(['memo', 'forwardRef', 'observer', 'React.memo', 'React.forwardRef'])\n\n// Node types that introduce a new function scope \u2014 their returns are not the outer component's.\nconst NESTED_SCOPES = new Set(['FunctionDeclaration', 'FunctionExpression', 'ArrowFunctionExpression'])\n\nconst isPascalCase = (name: string): boolean => {\n  return /^[A-Z]/.test(name)\n}\n\nconst isJsxNode = (node: ESTree.Node | null | undefined): boolean => {\n  if (!node) {\n    return false\n  }\n\n  const type = node.type as string\n\n  return type === 'JSXElement' || type === 'JSXFragment'\n}\n\nconst getParent = (node: ESTree.Node | undefined): ESTree.Node | undefined => {\n  return (node as (WithParent & ESTree.Node) | undefined)?.parent\n}\n\n/** Best-effort name of a call's callee: `memo` for `memo(...)`, `React.memo` for `React.memo(...)`. */\nconst getCalleeName = (callee: ESTree.CallExpression['callee']): string | null => {\n  if (callee.type === 'Identifier') {\n    return callee.name\n  }\n\n  if (\n    callee.type === 'MemberExpression' &&\n    callee.object.type === 'Identifier' &&\n    callee.property.type === 'Identifier'\n  ) {\n    return `${callee.object.name}.${callee.property.name}`\n  }\n\n  return null\n}\n\n/**\n * Resolve the declared name of a function, looking through component wrappers\n * such as `memo`/`forwardRef` so that `const Comp = memo(({ a }) => ...)` is\n * still recognised by its PascalCase variable name.\n */\nconst getComponentName = (node: ComponentFunction): string | null => {\n  if (node.type === 'FunctionDeclaration') {\n    return node.id?.name ?? null\n  }\n\n  let current = getParent(node)\n\n  // Walk through wrapping call expressions (memo, forwardRef, React.memo, ...).\n  while (current?.type === 'CallExpression') {\n    const calleeName = getCalleeName(current.callee)\n\n    if (!calleeName || !COMPONENT_WRAPPER_CALLEES.has(calleeName)) {\n      break\n    }\n\n    current = getParent(current)\n  }\n\n  if (current?.type === 'VariableDeclarator' && current.id.type === 'Identifier') {\n    return current.id.name\n  }\n\n  return null\n}\n\n/** Whether a function returns JSX, scanning its own body without descending into nested functions. */\nconst returnsJsx = (node: ComponentFunction): boolean => {\n  if (node.body.type !== 'BlockStatement') {\n    return isJsxNode(node.body)\n  }\n\n  let found = false\n\n  const visit = (current: ESTree.Node | null | undefined): void => {\n    if (found || !current || NESTED_SCOPES.has(current.type)) {\n      return\n    }\n\n    if (current.type === 'ReturnStatement') {\n      if (isJsxNode(current.argument)) {\n        found = true\n      }\n\n      return\n    }\n\n    if (current.type === 'IfStatement') {\n      visit(current.consequent)\n      visit(current.alternate)\n\n      return\n    }\n\n    if (current.type === 'BlockStatement') {\n      current.body.forEach(visit)\n\n      return\n    }\n\n    if (current.type === 'SwitchStatement') {\n      for (const switchCase of current.cases) {\n        switchCase.consequent.forEach(visit)\n      }\n\n      return\n    }\n\n    if (current.type === 'TryStatement') {\n      visit(current.block)\n      visit(current.handler?.body)\n      visit(current.finalizer)\n\n      return\n    }\n\n    if (\n      current.type === 'ForStatement' ||\n      current.type === 'ForInStatement' ||\n      current.type === 'ForOfStatement' ||\n      current.type === 'WhileStatement' ||\n      current.type === 'DoWhileStatement'\n    ) {\n      visit(current.body)\n    }\n  }\n\n  node.body.body.forEach(visit)\n\n  return found\n}\n\n/** A function is treated as a React component when it is PascalCase-named or returns JSX. */\nexport const isComponent = (node: ComponentFunction): boolean => {\n  const name = getComponentName(node)\n\n  if (name && isPascalCase(name)) {\n    return true\n  }\n\n  return returnsJsx(node)\n}\n\nconst isComponentFunctionNode = (node: ESTree.Node): node is ComponentFunction => {\n  return (\n    node.type === 'ArrowFunctionExpression' || node.type === 'FunctionExpression' || node.type === 'FunctionDeclaration'\n  )\n}\n\n/**\n * Extract the component function from an expression, unwrapping a single layer of\n * component wrappers (`memo(fn)`, `forwardRef(fn)`, `React.memo(fn)`, ...). Returns\n * null when no function is found.\n */\nexport const getComponentFunction = (node: ESTree.Node | null | undefined): ComponentFunction | null => {\n  if (!node) {\n    return null\n  }\n\n  if (isComponentFunctionNode(node)) {\n    return node\n  }\n\n  if (node.type === 'CallExpression') {\n    for (const argument of node.arguments) {\n      if (argument.type === 'SpreadElement') {\n        continue\n      }\n\n      const found = getComponentFunction(argument)\n\n      if (found) {\n        return found\n      }\n    }\n  }\n\n  return null\n}\n\n/** Unwrap an `export ...` statement to the declaration it wraps (or the statement itself). */\nexport const unwrapExport = (statement: ESTree.Statement | ESTree.ModuleDeclaration): ESTree.Node | null => {\n  if (statement.type === 'ExportNamedDeclaration' || statement.type === 'ExportDefaultDeclaration') {\n    return (statement.declaration as ESTree.Node | null) ?? null\n  }\n\n  return statement\n}\n\n/** Whether a single top-level declaration declares a React component. */\nexport const declaresComponent = (node: ESTree.Node | null): boolean => {\n  if (!node) {\n    return false\n  }\n\n  if (node.type === 'FunctionDeclaration') {\n    return isComponent(node)\n  }\n\n  if (node.type === 'VariableDeclaration') {\n    return node.declarations.some((declaration) => {\n      const fn = getComponentFunction(declaration.init)\n\n      return fn ? isComponent(fn) : false\n    })\n  }\n\n  const fn = getComponentFunction(node)\n\n  return fn ? isComponent(fn) : false\n}\n\n/**\n * Resolve the name of the React component declared by a single top-level declaration,\n * or null when the declaration is not a component or the component is anonymous\n * (e.g. `export default () => <div />`). Mirrors `declaresComponent`'s node dispatch and\n * resolves the name through component wrappers (`memo`/`forwardRef`).\n */\nexport const getDeclaredComponentName = (node: ESTree.Node | null): string | null => {\n  if (!node) {\n    return null\n  }\n\n  if (node.type === 'FunctionDeclaration') {\n    return isComponent(node) ? getComponentName(node) : null\n  }\n\n  if (node.type === 'VariableDeclaration') {\n    for (const declaration of node.declarations) {\n      const fn = getComponentFunction(declaration.init)\n\n      if (fn && isComponent(fn)) {\n        return getComponentName(fn)\n      }\n    }\n\n    return null\n  }\n\n  const fn = getComponentFunction(node)\n\n  return fn && isComponent(fn) ? getComponentName(fn) : null\n}\n\n/** Whether any top-level statement in a program body declares a React component. */\nexport const bodyDeclaresComponent = (body: Array<ESTree.Statement | ESTree.ModuleDeclaration>): boolean => {\n  return body.some((statement) => {\n    return declaresComponent(unwrapExport(statement))\n  })\n}\n", "// Characters that must be escaped when embedded literally into a RegExp source.\nconst REGEX_METACHARS = new Set(['\\\\', '^', '$', '.', '|', '+', '(', ')', '[', ']', '{', '}'])\n\n/**\n * Convert a glob pattern to an (unanchored) RegExp.\n *\n * - `**` matches any characters, including path separators.\n * - `*` matches any characters except a path separator.\n * - `?` matches a single non-separator character.\n *\n * The result is intentionally unanchored so a pattern matches anywhere in the\n * path (e.g. `features/**` matches `/repo/src/features/x/comp.tsx`).\n */\nconst globToRegExp = (glob: string): RegExp => {\n  let source = ''\n\n  for (let index = 0; index < glob.length; index++) {\n    const char = glob[index]!\n\n    if (char === '*') {\n      if (glob[index + 1] === '*') {\n        source += '.*'\n        index++\n\n        // Consume a trailing slash so `**/foo` also matches a bare `foo`.\n        if (glob[index + 1] === '/') {\n          index++\n        }\n      } else {\n        source += '[^/]*'\n      }\n    } else if (char === '?') {\n      source += '[^/]'\n    } else if (REGEX_METACHARS.has(char)) {\n      source += `\\\\${char}`\n    } else {\n      source += char\n    }\n  }\n\n  return new RegExp(source)\n}\n\n/** Whether `filename` matches at least one of the provided glob `patterns`. */\nexport const matchesAnyGlob = (filename: string, patterns: readonly string[]): boolean => {\n  const normalized = filename.split('\\\\').join('/')\n\n  return patterns.some((pattern) => {\n    return globToRegExp(pattern).test(normalized)\n  })\n}\n", "import type { Rule } from 'eslint'\nimport type * as ESTree from 'estree'\n\nimport { declaresComponent, getDeclaredComponentName, unwrapExport } from '../utils/component'\nimport { matchesAnyGlob } from '../utils/path-match'\n\ninterface Options {\n  paths?: string[]\n  ignore?: string[]\n}\n\n// TS-only nodes are not modelled by estree; access their identifier structurally.\ninterface NamedDeclaration {\n  type: string\n  id?: { name?: string } | null\n}\n\nconst PROPS_SUFFIX = 'Props'\n\n/** The name of a props interface/type alias (`SomethingProps`), or null when it is neither. */\nconst getPropsTypeName = (node: ESTree.Node | null): string | null => {\n  if (!node) {\n    return null\n  }\n\n  const named = node as NamedDeclaration\n\n  if (named.type !== 'TSInterfaceDeclaration' && named.type !== 'TSTypeAliasDeclaration') {\n    return null\n  }\n\n  const name = named.id?.name\n\n  return name?.endsWith(PROPS_SUFFIX) ? name : null\n}\n\nexport const componentFileOrder: Rule.RuleModule = {\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'Enforce a strict top-level order in React component files: imports first, then \u2014 for each component \u2014 its props interface/type declared immediately before the component.',\n      recommended: true,\n      url: 'https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: {\n          paths: {\n            type: 'array',\n            items: { type: 'string' },\n            description:\n              'Optional glob patterns. When provided, the rule only runs for files whose path matches one of them.',\n          },\n          ignore: {\n            type: 'array',\n            items: { type: 'string' },\n            description:\n              'Optional glob patterns. The rule is skipped for files whose path matches one of them, even if it also matches `paths`.',\n          },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      importsFirst: 'Imports must come before the component interface and declaration.',\n      interfaceImmediatelyBeforeComponent:\n        'The component props interface must be declared immediately before the component.',\n    },\n  },\n\n  create(context) {\n    const options = (context.options[0] ?? {}) as Options\n    const paths = options.paths ?? []\n    const ignore = options.ignore ?? []\n\n    // `ignore` takes precedence: skip excluded files even when they also match `paths`.\n    if (ignore.length > 0 && matchesAnyGlob(context.filename, ignore)) {\n      return {}\n    }\n\n    if (paths.length > 0 && !matchesAnyGlob(context.filename, paths)) {\n      return {}\n    }\n\n    return {\n      Program(program) {\n        const body = program.body\n\n        const importIndices: number[] = []\n        const components: { index: number; name: string | null }[] = []\n        // First index of each `*Props` declaration, keyed by its name.\n        const propsIndexByName = new Map<string, number>()\n\n        body.forEach((statement, index) => {\n          if (statement.type === 'ImportDeclaration') {\n            importIndices.push(index)\n\n            return\n          }\n\n          const declaration = unwrapExport(statement)\n\n          const propsName = getPropsTypeName(declaration)\n\n          if (propsName !== null && !propsIndexByName.has(propsName)) {\n            propsIndexByName.set(propsName, index)\n          }\n\n          if (declaresComponent(declaration)) {\n            components.push({ index, name: getDeclaredComponentName(declaration) })\n          }\n        })\n\n        // The rule only governs files that actually contain a component.\n        if (components.length === 0) {\n          return\n        }\n\n        // Imports must precede the first component and its matching props interface.\n        const first = components[0]!\n        const firstPropsIndex = first.name === null ? undefined : propsIndexByName.get(`${first.name}${PROPS_SUFFIX}`)\n        const importBoundary = Math.min(first.index, firstPropsIndex ?? first.index)\n\n        for (const importIndex of importIndices) {\n          if (importIndex > importBoundary) {\n            context.report({ node: body[importIndex]!, messageId: 'importsFirst' })\n          }\n        }\n\n        // Each component's own `<Name>Props` interface, when present, must sit immediately\n        // before the component. Matching by name keeps a sibling component's props from\n        // being judged against this component.\n        for (const component of components) {\n          if (component.name === null) {\n            continue\n          }\n\n          const propsIndex = propsIndexByName.get(`${component.name}${PROPS_SUFFIX}`)\n\n          if (propsIndex !== undefined && propsIndex !== component.index - 1) {\n            context.report({ node: body[propsIndex]!, messageId: 'interfaceImmediatelyBeforeComponent' })\n          }\n        }\n      },\n    }\n  },\n}\n\nexport default componentFileOrder\n", "import type { Rule } from 'eslint'\nimport type * as ESTree from 'estree'\n\nimport type { ComponentFunction } from '../utils/component'\nimport { isComponent } from '../utils/component'\n\n/** Whether a statement is `const { ... } = props` (destructuring the `props` identifier). */\nconst isPropsDestructuring = (statement: ESTree.Statement): boolean => {\n  if (statement.type !== 'VariableDeclaration') {\n    return false\n  }\n\n  return statement.declarations.some((declaration) => {\n    return (\n      declaration.id.type === 'ObjectPattern' &&\n      declaration.init?.type === 'Identifier' &&\n      declaration.init.name === 'props'\n    )\n  })\n}\n\nexport const propsDestructuringBlankLine: Rule.RuleModule = {\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'Require a blank line after the `const { ... } = props` destructuring statement at the top of a React component body.',\n      recommended: true,\n      url: 'https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin',\n    },\n    fixable: 'whitespace',\n    schema: [],\n    messages: {\n      blankLineAfterProps: 'Add a blank line after destructuring props.',\n    },\n  },\n\n  create(context) {\n    const sourceCode = context.sourceCode\n\n    const check = (node: ComponentFunction): void => {\n      if (node.body.type !== 'BlockStatement') {\n        return\n      }\n\n      if (!isComponent(node)) {\n        return\n      }\n\n      const statements = node.body.body\n      const index = statements.findIndex(isPropsDestructuring)\n\n      if (index === -1) {\n        return\n      }\n\n      const propsStatement = statements[index]\n      const nextStatement = statements[index + 1]\n\n      // `propsStatement` is defined because `index !== -1`; the guard also narrows the type.\n      // Nothing follows the destructuring \u2014 no separation needed.\n      if (!propsStatement || !nextStatement) {\n        return\n      }\n\n      // The token/comment that follows the destructuring statement; a comment on the\n      // next line still counts as \"no blank line\" until it is pushed down.\n      const tokenAfter = sourceCode.getTokenAfter(propsStatement, { includeComments: true })\n      const referenceLine = (tokenAfter ?? nextStatement).loc!.start.line\n\n      if (referenceLine - propsStatement.loc!.end.line >= 2) {\n        return\n      }\n\n      context.report({\n        node: propsStatement,\n        messageId: 'blankLineAfterProps',\n        fix(fixer) {\n          return fixer.insertTextAfter(propsStatement, '\\n')\n        },\n      })\n    }\n\n    return {\n      ArrowFunctionExpression: check,\n      FunctionDeclaration: check,\n      FunctionExpression: check,\n    }\n  },\n}\n\nexport default propsDestructuringBlankLine\n", "import type { Rule } from 'eslint'\nimport type * as ESTree from 'estree'\n\nimport type { ComponentFunction } from '../utils/component'\nimport { isComponent } from '../utils/component'\n\n// Minimal structural views over nodes that estree's types do not fully model:\n// the optional TS type annotation and `range` that the parser attaches to params.\ninterface WithRange {\n  range?: [number, number]\n}\ntype AnnotatedPattern = ESTree.ObjectPattern & { typeAnnotation?: ESTree.Node & WithRange } & WithRange\n\n// Recursively collect every identifier a destructuring pattern binds, so we can detect\n// whether it already introduces a `props` binding (e.g. a `...props` rest).\nconst collectBoundNames = (node: ESTree.Node | null, names: Set<string>): void => {\n  if (!node) {\n    return\n  }\n\n  switch (node.type) {\n    case 'Identifier':\n      names.add(node.name)\n      break\n    case 'ObjectPattern':\n      for (const property of node.properties) collectBoundNames(property, names)\n      break\n    case 'ArrayPattern':\n      for (const element of node.elements) collectBoundNames(element, names)\n      break\n    case 'Property':\n      collectBoundNames(node.value, names)\n      break\n    case 'RestElement':\n      collectBoundNames(node.argument, names)\n      break\n    case 'AssignmentPattern':\n      collectBoundNames(node.left, names)\n      break\n    default:\n      break\n  }\n}\n\nexport const propsDestructuringNewline: Rule.RuleModule = {\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'Require React components to accept a single props parameter and destructure it on its own line in the body, rather than destructuring inline in the parameter list.',\n      recommended: true,\n      url: 'https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin',\n    },\n    fixable: 'code',\n    schema: [],\n    messages: {\n      destructureOnNewLine:\n        'Accept a single `props` parameter and destructure it on its own line in the component body instead of destructuring in the parameter list.',\n    },\n  },\n\n  create(context) {\n    const sourceCode = context.sourceCode\n\n    const check = (node: ComponentFunction): void => {\n      const firstParam = node.params[0]\n\n      if (!firstParam || firstParam.type !== 'ObjectPattern') {\n        return\n      }\n\n      if (!isComponent(node)) {\n        return\n      }\n\n      // The fix renames the parameter to `props` and re-destructures it in the body\n      // (`const <pattern> = props`). If the pattern already binds `props` (e.g. a\n      // `...props` rest), that body binding collides with the new parameter and yields\n      // an invalid \"Duplicate declaration props\". There is no safe rename that keeps the\n      // `props` name the rule mandates, so skip these patterns entirely.\n      const boundNames = new Set<string>()\n\n      collectBoundNames(firstParam, boundNames)\n\n      if (boundNames.has('props')) {\n        return\n      }\n\n      const objectPattern = firstParam as AnnotatedPattern\n\n      context.report({\n        node: firstParam,\n        messageId: 'destructureOnNewLine',\n        fix(fixer) {\n          const text = sourceCode.getText()\n          const annotation = objectPattern.typeAnnotation\n\n          const patternStart = objectPattern.range![0]\n          const patternEnd = annotation ? annotation.range![0] : objectPattern.range![1]\n          const fullEnd = annotation ? annotation.range![1] : objectPattern.range![1]\n\n          const patternText = text.slice(patternStart, patternEnd).trim()\n          const annotationText = annotation ? sourceCode.getText(annotation) : ''\n\n          const fixes = [fixer.replaceTextRange([patternStart, fullEnd], `props${annotationText}`)]\n\n          const destructureStatement = `const ${patternText} = props`\n\n          // Indentation of the line the component is declared on, used as the base for inserted code.\n          const lines = sourceCode.getLines()\n          const declarationLine = lines[node.loc!.start.line - 1] ?? ''\n          const baseIndent = declarationLine.slice(0, declarationLine.length - declarationLine.trimStart().length)\n          const innerIndent = `${baseIndent}  `\n\n          if (node.body.type === 'BlockStatement') {\n            const [firstStatement] = node.body.body\n\n            if (firstStatement) {\n              const indent = ' '.repeat(firstStatement.loc!.start.column)\n\n              fixes.push(fixer.insertTextBefore(firstStatement, `${destructureStatement}\\n\\n${indent}`))\n            } else {\n              const openBrace = sourceCode.getFirstToken(node.body)!\n\n              fixes.push(fixer.insertTextAfter(openBrace, `\\n${innerIndent}${destructureStatement}\\n${baseIndent}`))\n            }\n\n            return fixes\n          }\n\n          // Expression-bodied arrow (implicit return) \u2014 wrap it in a block.\n          const bodyText = sourceCode.getText(node.body)\n\n          fixes.push(\n            fixer.replaceText(\n              node.body,\n              `{\\n${innerIndent}${destructureStatement}\\n\\n${innerIndent}return ${bodyText}\\n${baseIndent}}`,\n            ),\n          )\n\n          return fixes\n        },\n      })\n    }\n\n    return {\n      ArrowFunctionExpression: check,\n      FunctionDeclaration: check,\n      FunctionExpression: check,\n    }\n  },\n}\n\nexport default propsDestructuringNewline\n", "import type { Rule } from 'eslint'\nimport { existsSync } from 'node:fs'\nimport path from 'node:path'\n\nimport { bodyDeclaresComponent } from '../utils/component'\nimport { matchesAnyGlob } from '../utils/path-match'\nimport type { ExtraTarget, StoryPathOptions } from '../utils/story-path'\nimport { DEFAULT_STORY_PATH_OPTIONS, classifyComponent, deriveExpectedStoryPaths } from '../utils/story-path'\n\ninterface Options {\n  paths?: string[]\n  ignore?: string[]\n  storiesDir?: string\n  storySuffix?: string\n  storyExtensions?: string[]\n  componentSuffix?: string\n  requireComponentAst?: boolean\n  extraTargets?: ExtraTarget[]\n}\n\n/** Pick the story-path knobs out of the rule options, leaving defaults to the helper. */\nconst toStoryPathOptions = (options: Options): Partial<StoryPathOptions> => {\n  const picked: Partial<StoryPathOptions> = {}\n\n  if (options.storiesDir !== undefined) {\n    picked.storiesDir = options.storiesDir\n  }\n\n  if (options.storySuffix !== undefined) {\n    picked.storySuffix = options.storySuffix\n  }\n\n  if (options.storyExtensions !== undefined) {\n    picked.storyExtensions = options.storyExtensions\n  }\n\n  if (options.componentSuffix !== undefined) {\n    picked.componentSuffix = options.componentSuffix\n  }\n\n  if (options.extraTargets !== undefined) {\n    picked.extraTargets = options.extraTargets\n  }\n\n  return picked\n}\n\nexport const requireComponentStories: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Require a co-located Storybook story for every dumb component.',\n      recommended: true,\n      url: 'https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: {\n          paths: {\n            type: 'array',\n            items: { type: 'string' },\n            description: 'Optional globs; when provided the rule only runs for files whose path matches one.',\n          },\n          ignore: {\n            type: 'array',\n            items: { type: 'string' },\n            description: 'Optional globs; the rule is skipped for matching files, even if they also match `paths`.',\n          },\n          storiesDir: {\n            type: 'string',\n            description: `Story directory name (default '${DEFAULT_STORY_PATH_OPTIONS.storiesDir}').`,\n          },\n          storySuffix: {\n            type: 'string',\n            description: `Suffix inserted before the extension (default '${DEFAULT_STORY_PATH_OPTIONS.storySuffix}').`,\n          },\n          storyExtensions: {\n            type: 'array',\n            items: { type: 'string' },\n            description: 'Extensions a satisfying story file may have, in priority order.',\n          },\n          componentSuffix: {\n            type: 'string',\n            description: `Basename suffix a component file must end with (default '${DEFAULT_STORY_PATH_OPTIONS.componentSuffix}'; '' disables).`,\n          },\n          requireComponentAst: {\n            type: 'boolean',\n            description: 'When true (default), only require a story for files that actually declare a component.',\n          },\n          extraTargets: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                componentsDir: { type: 'string' },\n                anchorParentDir: { type: 'string' },\n                storyMode: { enum: ['feature-root', 'sibling'] },\n              },\n              required: ['componentsDir', 'storyMode'],\n              additionalProperties: false,\n            },\n            description: 'Extra structured component layouts (componentsDir + optional anchorParentDir + storyMode).',\n          },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      missingStory: \"Dumb component '{{component}}' is missing a Storybook story (expected at '{{expected}}').\",\n    },\n  },\n\n  create(context) {\n    const options = (context.options[0] ?? {}) as Options\n    const paths = options.paths ?? []\n    const ignore = options.ignore ?? []\n    const requireComponentAst = options.requireComponentAst ?? true\n    const storyPathOptions = toStoryPathOptions(options)\n\n    // `ignore` takes precedence: skip excluded files even when they also match `paths`.\n    if (ignore.length > 0 && matchesAnyGlob(context.filename, ignore)) {\n      return {}\n    }\n\n    if (paths.length > 0 && !matchesAnyGlob(context.filename, paths)) {\n      return {}\n    }\n\n    return {\n      Program(program) {\n        // Is this file a dumb component that requires a story, and where would the story live?\n        if (!classifyComponent(context.filename, storyPathOptions)) {\n          return\n        }\n\n        // Only enforce on files that actually declare a component (avoids flagging stray\n        // non-component files placed under a components/ directory).\n        if (requireComponentAst && !bodyDeclaresComponent(program.body)) {\n          return\n        }\n\n        const candidates = deriveExpectedStoryPaths(context.filename, storyPathOptions)\n\n        // The story is satisfied if ANY candidate (by extension) exists on disk.\n        const hasStory = candidates.some((candidate) => {\n          return existsSync(candidate)\n        })\n\n        if (hasStory) {\n          return\n        }\n\n        context.report({\n          node: program,\n          messageId: 'missingStory',\n          data: {\n            component: path.posix.basename(context.filename.split('\\\\').join('/')),\n            expected: candidates[0] ?? '',\n          },\n        })\n      },\n    }\n  },\n}\n\nexport default requireComponentStories\n", "import path from 'node:path'\n\n/** Where a story file lives relative to its component. */\nexport type StoryMode = 'feature-root' | 'sibling'\n\n/** A consumer-defined extra component layout (structured \u2014 never a glob). */\nexport interface ExtraTarget {\n  /** Immediate parent directory name a component file must sit directly inside. */\n  componentsDir: string\n  /** Optional grandparent directory name gate (e.g. `features`). */\n  anchorParentDir?: string\n  /** Where the story is expected for files matched by this target. */\n  storyMode: StoryMode\n}\n\nexport interface StoryPathOptions {\n  /** Story directory name (default `__stories__`). */\n  storiesDir: string\n  /** Suffix inserted before the extension (default `.stories`). */\n  storySuffix: string\n  /** Extensions a satisfying story file may have, in priority order. */\n  storyExtensions: string[]\n  /** Extensions a file must have to be considered a component. */\n  componentExtensions: string[]\n  /** Basename suffix a component file must end with (default `-component`; `''` disables). */\n  componentSuffix: string\n  /** Additional structured component layouts beyond the two built-ins. */\n  extraTargets: ExtraTarget[]\n}\n\nexport const DEFAULT_STORY_PATH_OPTIONS: StoryPathOptions = {\n  storiesDir: '__stories__',\n  storySuffix: '.stories',\n  storyExtensions: ['.tsx', '.jsx', '.ts', '.js'],\n  componentExtensions: ['.tsx', '.jsx'],\n  componentSuffix: '-component',\n  extraTargets: [],\n}\n\nconst resolveOptions = (opts?: Partial<StoryPathOptions>): StoryPathOptions => {\n  return { ...DEFAULT_STORY_PATH_OPTIONS, ...opts }\n}\n\n/** Normalize OS-native separators to posix so all downstream path logic is deterministic. */\nconst toPosix = (filePath: string): string => {\n  return filePath.split('\\\\').join('/')\n}\n\ninterface ParsedComponent {\n  /** Posix directory of the file. */\n  dir: string\n  /** Basename without its extension. */\n  base: string\n  /** Original extension (e.g. `.tsx`). */\n  ext: string\n  /** Immediate parent directory name. */\n  parent: string\n  /** Grandparent directory name. */\n  grandparent: string\n  /** Great-grandparent directory name. */\n  greatGrandparent: string\n}\n\n/** Parse a file path into the segment view the gate and derivation both need. */\nconst parse = (filePath: string): ParsedComponent => {\n  const normalized = toPosix(filePath)\n  const segments = normalized.split('/')\n  const basename = segments[segments.length - 1] ?? ''\n  const ext = path.posix.extname(basename)\n  const base = ext ? basename.slice(0, -ext.length) : basename\n\n  return {\n    dir: path.posix.dirname(normalized),\n    base,\n    ext,\n    parent: segments[segments.length - 2] ?? '',\n    grandparent: segments[segments.length - 3] ?? '',\n    greatGrandparent: segments[segments.length - 4] ?? '',\n  }\n}\n\n/** Whether the file passes the component preconditions (extension + name suffix). */\nconst passesComponentPreconditions = (parsed: ParsedComponent, options: StoryPathOptions): boolean => {\n  if (!options.componentExtensions.includes(parsed.ext)) {\n    return false\n  }\n\n  return options.componentSuffix === '' || parsed.base.endsWith(options.componentSuffix)\n}\n\n/**\n * Classify a file as a dumb component requiring a story, resolving WHERE its story should live.\n * Returns null when the file is not a component-requiring-a-story under any branch.\n *\n * Exactly one admit-condition may hold:\n *  - feature-root: direct child of `components/` whose chain is `features/<f>/components`.\n *  - sibling: a `components/default/<name>-component` file (parent `default`, grandparent `components`).\n *  - extraTargets: a structured consumer-defined layout.\n */\nexport const classifyComponent = (filePath: string, opts?: Partial<StoryPathOptions>): { mode: StoryMode } | null => {\n  const options = resolveOptions(opts)\n  const parsed = parse(filePath)\n\n  if (!passesComponentPreconditions(parsed, options)) {\n    return null\n  }\n\n  // (a) feature-root \u2014 immediate parent is `components` AND the chain is `features/<feature>/components`.\n  if (parsed.parent === 'components' && parsed.greatGrandparent === 'features') {\n    return { mode: 'feature-root' }\n  }\n\n  // (b) sibling \u2014 `components/default/<name>-component.*` (NOT a direct child of `components/`).\n  if (parsed.parent === 'default' && parsed.grandparent === 'components') {\n    return { mode: 'sibling' }\n  }\n\n  // (c) extraTargets \u2014 structured layouts (componentsDir + optional anchorParentDir).\n  for (const target of options.extraTargets) {\n    const parentMatches = parsed.parent === target.componentsDir\n    const anchorMatches = target.anchorParentDir == null || parsed.grandparent === target.anchorParentDir\n\n    if (parentMatches && anchorMatches) {\n      return { mode: target.storyMode }\n    }\n  }\n\n  return null\n}\n\n/**\n * Ordered candidate story paths for a component file. Empty when the file is not a\n * component-requiring-a-story (see {@link classifyComponent}). The story is considered present\n * when ANY candidate exists on disk.\n */\nexport const deriveExpectedStoryPaths = (filePath: string, opts?: Partial<StoryPathOptions>): string[] => {\n  const options = resolveOptions(opts)\n  const classification = classifyComponent(filePath, options)\n\n  if (!classification) {\n    return []\n  }\n\n  const parsed = parse(filePath)\n\n  // feature-root: dirname(file) is `.../components`, so its parent is the feature root.\n  // sibling: the story dir sits next to the component file itself.\n  const storyBaseDir = classification.mode === 'feature-root' ? path.posix.dirname(parsed.dir) : parsed.dir\n  const storyDir = path.posix.join(storyBaseDir, options.storiesDir)\n\n  return options.storyExtensions.map((extension) => {\n    return path.posix.join(storyDir, `${parsed.base}${options.storySuffix}${extension}`)\n  })\n}\n", "import type { Rule } from 'eslint'\n\nimport { componentFileOrder } from './component-file-order'\nimport { propsDestructuringBlankLine } from './props-destructuring-blank-line'\nimport { propsDestructuringNewline } from './props-destructuring-newline'\nimport { requireComponentStories } from './require-component-stories'\n\nexport const rules: Record<string, Rule.RuleModule> = {\n  'props-destructuring-newline': propsDestructuringNewline,\n  'props-destructuring-blank-line': propsDestructuringBlankLine,\n  'component-file-order': componentFileOrder,\n  'require-component-stories': requireComponentStories,\n}\n", "import type { ESLint, Linter } from 'eslint'\n\nimport { rules } from './rules'\n\nconst PLUGIN_NAME = '@wl'\n\nconst plugin: ESLint.Plugin & { configs: Record<string, Linter.Config> } = {\n  meta: {\n    name: '@wl/eslint-plugin',\n    version: '0.1.3',\n  },\n  rules,\n  configs: {},\n}\n\n/**\n * Flat-config preset that registers the plugin and turns every rule on.\n *\n * @example\n * import wl from '@wl/eslint-plugin'\n *\n * export default [wl.configs.recommended]\n */\nplugin.configs.recommended = {\n  plugins: {\n    [PLUGIN_NAME]: plugin,\n  },\n  rules: {\n    [`${PLUGIN_NAME}/props-destructuring-newline`]: 'error',\n    [`${PLUGIN_NAME}/props-destructuring-blank-line`]: 'error',\n    [`${PLUGIN_NAME}/component-file-order`]: 'error',\n    [`${PLUGIN_NAME}/require-component-stories`]: 'error',\n  },\n}\n\nexport const meta: ESLint.Plugin['meta'] = plugin.meta\nexport const configs: Record<string, Linter.Config> = plugin.configs\nexport { rules }\n\nexport default plugin\n"],
+  "mappings": "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",
+  "names": ["fn", "path", "path"]
 }

package/dist/rules/require-component-stories.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from 'eslint';
+export declare const requireComponentStories: Rule.RuleModule;
+export default requireComponentStories;

package/dist/utils/component.d.ts

@@ -8,3 +8,16 @@ export declare const isComponent: (node: ComponentFunction) => boolean;
  * null when no function is found.
  */
 export declare const getComponentFunction: (node: ESTree.Node | null | undefined) => ComponentFunction | null;
+/** Unwrap an `export ...` statement to the declaration it wraps (or the statement itself). */
+export declare const unwrapExport: (statement: ESTree.Statement | ESTree.ModuleDeclaration) => ESTree.Node | null;
+/** Whether a single top-level declaration declares a React component. */
+export declare const declaresComponent: (node: ESTree.Node | null) => boolean;
+/**
+ * Resolve the name of the React component declared by a single top-level declaration,
+ * or null when the declaration is not a component or the component is anonymous
+ * (e.g. `export default () => <div />`). Mirrors `declaresComponent`'s node dispatch and
+ * resolves the name through component wrappers (`memo`/`forwardRef`).
+ */
+export declare const getDeclaredComponentName: (node: ESTree.Node | null) => string | null;
+/** Whether any top-level statement in a program body declares a React component. */
+export declare const bodyDeclaresComponent: (body: Array<ESTree.Statement | ESTree.ModuleDeclaration>) => boolean;

package/dist/utils/story-path.d.ts

@@ -0,0 +1,44 @@
+/** Where a story file lives relative to its component. */
+export type StoryMode = 'feature-root' | 'sibling';
+/** A consumer-defined extra component layout (structured — never a glob). */
+export interface ExtraTarget {
+    /** Immediate parent directory name a component file must sit directly inside. */
+    componentsDir: string;
+    /** Optional grandparent directory name gate (e.g. `features`). */
+    anchorParentDir?: string;
+    /** Where the story is expected for files matched by this target. */
+    storyMode: StoryMode;
+}
+export interface StoryPathOptions {
+    /** Story directory name (default `__stories__`). */
+    storiesDir: string;
+    /** Suffix inserted before the extension (default `.stories`). */
+    storySuffix: string;
+    /** Extensions a satisfying story file may have, in priority order. */
+    storyExtensions: string[];
+    /** Extensions a file must have to be considered a component. */
+    componentExtensions: string[];
+    /** Basename suffix a component file must end with (default `-component`; `''` disables). */
+    componentSuffix: string;
+    /** Additional structured component layouts beyond the two built-ins. */
+    extraTargets: ExtraTarget[];
+}
+export declare const DEFAULT_STORY_PATH_OPTIONS: StoryPathOptions;
+/**
+ * Classify a file as a dumb component requiring a story, resolving WHERE its story should live.
+ * Returns null when the file is not a component-requiring-a-story under any branch.
+ *
+ * Exactly one admit-condition may hold:
+ *  - feature-root: direct child of `components/` whose chain is `features/<f>/components`.
+ *  - sibling: a `components/default/<name>-component` file (parent `default`, grandparent `components`).
+ *  - extraTargets: a structured consumer-defined layout.
+ */
+export declare const classifyComponent: (filePath: string, opts?: Partial<StoryPathOptions>) => {
+    mode: StoryMode;
+} | null;
+/**
+ * Ordered candidate story paths for a component file. Empty when the file is not a
+ * component-requiring-a-story (see {@link classifyComponent}). The story is considered present
+ * when ANY candidate exists on disk.
+ */
+export declare const deriveExpectedStoryPaths: (filePath: string, opts?: Partial<StoryPathOptions>) => string[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@slip-stream-kit/eslint-plugin",
   "type": "module",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Custom ESLint rules enforcing the white-label frontend architecture conventions",
   "author": "Arthur Saenko <arthur.saenz7@gmail.com> (https://github.com/ArthurSaenz)",
   "license": "MIT",
@@ -52,11 +52,11 @@
   },
   "devDependencies": {
     "@types/node": "catalog:",
-    "@typescript-eslint/parser": "^8.60.1",
+    "@typescript-eslint/parser": "^8.61.1",
     "@wl/eslint-config": "workspace:*",
     "esbuild": "^0.28.0",
-    "eslint": "^10.4.1",
+    "eslint": "^10.5.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.9"
   }
 }

package/readme.md

@@ -133,3 +133,62 @@ every file (you can also scope it the usual way with flat-config `files`).
 
 Glob support: `*` matches within a path segment, `**` matches across segments,
 `?` matches a single character. A file matches if any pattern matches its path.
+
+### `require-component-stories`
+
+Require a co-located Storybook story for every dumb component. By default it enforces two layouts,
+mirroring the white-label `fe-architect` convention:
+
+| Layout | Component file | Required story |
+| --- | --- | --- |
+| Feature component | `features/<feature>/components/<name>-component.tsx` | `features/<feature>/__stories__/<name>-component.stories.tsx` (feature root) |
+| Shared default component | `components/default/<name>-component.tsx` | `components/default/__stories__/<name>-component.stories.tsx` (sibling) |
+
+A file is treated as a dumb component when it ends with the `-component` suffix, has a `.tsx`/`.jsx`
+extension, sits directly inside a `components/` directory (feature layout) or `components/default/`
+(shared layout), and — by default — actually declares a React component. Containers, nested
+`components/sub/*` files, barrels (`index.*`), and type files are never required to have stories. The
+story is satisfied when any candidate (`.tsx`, `.jsx`, `.ts`, `.js`) exists on disk.
+
+```js
+{
+  rules: {
+    '@wl/require-component-stories': 'error',
+  },
+}
+```
+
+#### Options (all optional)
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `paths` | `[]` | Restrict the rule to files matching these globs. |
+| `ignore` | `[]` | Skip files matching these globs (takes precedence over `paths`). |
+| `storiesDir` | `'__stories__'` | Directory name a story must live in. |
+| `storySuffix` | `'.stories'` | Suffix inserted before the extension. |
+| `storyExtensions` | `['.tsx', '.jsx', '.ts', '.js']` | Accepted story extensions, in priority order. |
+| `componentSuffix` | `'-component'` | Basename suffix a component must end with (`''` disables the check). |
+| `requireComponentAst` | `true` | When true, only require a story for files that actually declare a component. |
+| `extraTargets` | `[]` | Extra structured layouts: `{ componentsDir, anchorParentDir?, storyMode: 'feature-root' \| 'sibling' }`. |
+
+```js
+{
+  rules: {
+    '@wl/require-component-stories': ['error', {
+      extraTargets: [{ componentsDir: 'widgets', anchorParentDir: 'ui', storyMode: 'sibling' }],
+    }],
+  },
+}
+```
+
+#### Caveats
+
+- **Filesystem-coupled.** Unlike pure AST rules, this one checks the disk for a sibling story file,
+  so results depend on the working-tree state.
+- **`--cache`.** Adding or removing a story file does not change the component file, so a cached
+  ESLint result can go stale. Run without `--cache` in CI (or invalidate the cache) if you rely on
+  this rule as a gate.
+- **Case sensitivity.** The existence check is exact-case; a casing mismatch may pass on a
+  case-insensitive filesystem (macOS) and fail on a case-sensitive one (Linux CI).
+- **Unanchored globs.** `paths`/`ignore` patterns match anywhere in the path, so anchor them
+  (e.g. start with `**/`) when you need precision.