eslint-plugin-executable-stories-jest 2.1.2 → 2.1.3

package/dist/index.cjs

@@ -26,9 +26,101 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/rules/require-init-before-steps.ts
+var STEP_NAMES = /* @__PURE__ */ new Set([
+  "given",
+  "when",
+  "then",
+  "and",
+  "but",
+  "arrange",
+  "act",
+  "assert",
+  "setup",
+  "context",
+  "execute",
+  "action",
+  "verify",
+  "fn",
+  "expect"
+]);
+function isFunction(node) {
+  return node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression" || node.type === "FunctionDeclaration";
+}
+function isStoryInitCall(node) {
+  const { callee } = node;
+  if (callee.type !== "MemberExpression") return false;
+  const member = callee;
+  const { object, property } = member;
+  return object.type === "Identifier" && object.name === "story" && property.type === "Identifier" && property.name === "init";
+}
+function isStoryStepCall(node) {
+  const { callee } = node;
+  if (callee.type !== "MemberExpression") return false;
+  const member = callee;
+  const { object, property } = member;
+  return object.type === "Identifier" && object.name === "story" && property.type === "Identifier" && STEP_NAMES.has(property.name);
+}
+function getContainingFunction(node, context) {
+  const ancestors = context.sourceCode.getAncestors(node);
+  for (let i = ancestors.length - 1; i >= 0; i--) {
+    if (isFunction(ancestors[i])) {
+      return ancestors[i];
+    }
+  }
+  return null;
+}
+var rule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require story.init() to be called before any step markers (story.given/when/then/etc) in Jest.",
+      recommended: true
+    },
+    schema: [],
+    messages: {
+      requireInit: "story.init() must be called before using step markers like story.given(), story.when(), story.then()."
+    }
+  },
+  create(context) {
+    let hasRelevantImport = false;
+    const functionsWithInit = /* @__PURE__ */ new WeakSet();
+    const pendingStepCalls = [];
+    return {
+      ImportDeclaration(node) {
+        if (node.source.value === "executable-stories-jest") {
+          hasRelevantImport = true;
+        }
+      },
+      CallExpression(node) {
+        if (!hasRelevantImport) return;
+        if (isStoryInitCall(node)) {
+          const containingFunction = getContainingFunction(node, context);
+          if (containingFunction) {
+            functionsWithInit.add(containingFunction);
+          }
+          return;
+        }
+        if (isStoryStepCall(node)) {
+          const containingFunction = getContainingFunction(node, context);
+          pendingStepCalls.push({ node, containingFunction });
+        }
+      },
+      "Program:exit"() {
+        for (const { node, containingFunction } of pendingStepCalls) {
+          if (!containingFunction || !functionsWithInit.has(containingFunction)) {
+            context.report({ node, messageId: "requireInit" });
+          }
+        }
+      }
+    };
+  }
+};
+var require_init_before_steps_default = rule;
+
 // src/rules/require-story-context-for-steps.ts
 var V1_PACKAGE = "executable-stories-jest";
-var STEP_NAMES = /* @__PURE__ */ new Set([
+var STEP_NAMES2 = /* @__PURE__ */ new Set([
   "given",
   "when",
   "then",
@@ -44,7 +136,7 @@ var STEP_NAMES = /* @__PURE__ */ new Set([
   "verify"
 ]);
 var STORY_MODIFIERS = /* @__PURE__ */ new Set(["skip", "only"]);
-function isFunction(node) {
+function isFunction2(node) {
   return node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
 }
 function isFunctionNode(node) {
@@ -58,6 +150,11 @@ function isStoryCall(node) {
     return false;
   return callee.property.type === "Identifier" && STORY_MODIFIERS.has(callee.property.name);
 }
+function isStoryInitCall2(node) {
+  const { callee } = node;
+  if (callee.type !== "MemberExpression") return false;
+  return callee.object.type === "Identifier" && callee.object.name === "story" && callee.property.type === "Identifier" && callee.property.name === "init";
+}
 function isDocStoryCall(node) {
   const { callee } = node;
   if (callee.type !== "MemberExpression") return false;
@@ -65,16 +162,16 @@ function isDocStoryCall(node) {
 }
 function isStepCall(node) {
   const { callee } = node;
-  if (callee.type === "Identifier") return STEP_NAMES.has(callee.name);
+  if (callee.type === "Identifier") return STEP_NAMES2.has(callee.name);
   if (callee.type !== "MemberExpression") return false;
   if (callee.object.type !== "Identifier") return false;
   if (callee.object.name !== "steps" && callee.object.name !== "step")
     return false;
-  return callee.property.type === "Identifier" && STEP_NAMES.has(callee.property.name);
+  return callee.property.type === "Identifier" && STEP_NAMES2.has(callee.property.name);
 }
 function insideStoryCallback(node, context) {
   const ancestors = context.sourceCode.getAncestors(node);
-  const functionAncestors = new Set(ancestors.filter(isFunction));
+  const functionAncestors = new Set(ancestors.filter(isFunction2));
   for (const ancestor of ancestors) {
     if (ancestor.type !== "CallExpression") continue;
     if (!isStoryCall(ancestor) && !isDocStoryCall(ancestor)) continue;
@@ -86,7 +183,7 @@ function insideStoryCallback(node, context) {
   }
   return false;
 }
-var rule = {
+var rule2 = {
   meta: {
     type: "problem",
     docs: {
@@ -102,7 +199,17 @@ var rule = {
     let hasV1Import = false;
     const namedFunctions = /* @__PURE__ */ new Map();
     const storyCallbackNames = /* @__PURE__ */ new Set();
+    const functionsWithInit = /* @__PURE__ */ new WeakSet();
     const pendingStepCalls = [];
+    function getContainingFunction2(node) {
+      const ancestors = context.sourceCode.getAncestors(node);
+      for (let i = ancestors.length - 1; i >= 0; i--) {
+        if (isFunctionNode(ancestors[i]) || isFunction2(ancestors[i])) {
+          return ancestors[i];
+        }
+      }
+      return null;
+    }
     function getContainingFunctionName(node) {
       const ancestors = context.sourceCode.getAncestors(node);
       for (let i = ancestors.length - 1; i >= 0; i--) {
@@ -147,6 +254,13 @@ var rule = {
       },
       CallExpression(node) {
         if (!hasV1Import) return;
+        if (isStoryInitCall2(node)) {
+          const containingFunction2 = getContainingFunction2(node);
+          if (containingFunction2) {
+            functionsWithInit.add(containingFunction2);
+          }
+          return;
+        }
         if (isStoryCall(node) || isDocStoryCall(node)) {
           for (const arg of node.arguments) {
             if (arg.type === "Identifier") {
@@ -160,21 +274,25 @@ var rule = {
         }
         if (!isStepCall(node)) return;
         if (insideStoryCallback(node, context)) return;
+        const containingFunction = getContainingFunction2(node);
         const containingFunctionName = getContainingFunctionName(node);
-        pendingStepCalls.push({ node, containingFunctionName });
+        pendingStepCalls.push({ node, containingFunction, containingFunctionName });
       },
       "Program:exit"() {
-        for (const { node, containingFunctionName } of pendingStepCalls) {
+        for (const { node, containingFunction, containingFunctionName } of pendingStepCalls) {
           if (containingFunctionName && storyCallbackNames.has(containingFunctionName)) {
             continue;
           }
+          if (containingFunction && functionsWithInit.has(containingFunction)) {
+            continue;
+          }
           context.report({ node, messageId: "requireStory" });
         }
       }
     };
   }
 };
-var require_story_context_for_steps_default = rule;
+var require_story_context_for_steps_default = rule2;
 
 // src/rules/require-test-context-for-doc-story.ts
 var TEST_MODIFIERS = /* @__PURE__ */ new Set([
@@ -184,7 +302,7 @@ var TEST_MODIFIERS = /* @__PURE__ */ new Set([
   "concurrent",
   "failing"
 ]);
-function isFunction2(node) {
+function isFunction3(node) {
   return node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
 }
 function isFunctionNode2(node) {
@@ -220,7 +338,7 @@ function isTestCallExpression(node) {
 }
 function insideTestCallback(node, context) {
   const ancestors = context.sourceCode.getAncestors(node);
-  const functionAncestors = new Set(ancestors.filter(isFunction2));
+  const functionAncestors = new Set(ancestors.filter(isFunction3));
   for (const ancestor of ancestors) {
     if (ancestor.type !== "CallExpression") continue;
     if (!isTestCallExpression(ancestor)) continue;
@@ -232,7 +350,7 @@ function insideTestCallback(node, context) {
   }
   return false;
 }
-var rule2 = {
+var rule3 = {
   meta: {
     type: "problem",
     docs: {
@@ -325,10 +443,11 @@ var rule2 = {
     };
   }
 };
-var require_test_context_for_doc_story_default = rule2;
+var require_test_context_for_doc_story_default = rule3;
 
 // src/index.ts
 var rules = {
+  "require-init-before-steps": require_init_before_steps_default,
   "require-story-context-for-steps": require_story_context_for_steps_default,
   "require-test-context-for-doc-story": require_test_context_for_doc_story_default
 };
@@ -339,6 +458,7 @@ var configs = {
         "executable-stories-jest": { rules }
       },
       rules: {
+        "executable-stories-jest/require-init-before-steps": "error",
         "executable-stories-jest/require-story-context-for-steps": "error",
         "executable-stories-jest/require-test-context-for-doc-story": "error"
       }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/rules/require-story-context-for-steps.ts","../src/rules/require-test-context-for-doc-story.ts"],"sourcesContent":["import type { ESLint, Linter } from 'eslint';\nimport requireStoryContextForSteps from './rules/require-story-context-for-steps.js';\nimport requireTestContextForDocStory from './rules/require-test-context-for-doc-story.js';\n\nconst rules = {\n  'require-story-context-for-steps': requireStoryContextForSteps,\n  'require-test-context-for-doc-story': requireTestContextForDocStory,\n};\n\nconst configs: Record<string, Linter.Config[]> = {\n  recommended: [\n    {\n      plugins: {\n        'executable-stories-jest': { rules },\n      },\n      rules: {\n        'executable-stories-jest/require-story-context-for-steps': 'error',\n        'executable-stories-jest/require-test-context-for-doc-story': 'error',\n      },\n    },\n  ],\n};\n\nconst plugin: ESLint.Plugin = {\n  meta: {\n    name: 'eslint-plugin-executable-stories-jest',\n    version: '0.1.0',\n  },\n  rules,\n  configs,\n};\n\nexport default plugin;\nexport { rules, configs };\n","import type { Rule } from 'eslint';\nimport type {\n  ArrowFunctionExpression,\n  CallExpression,\n  FunctionDeclaration,\n  FunctionExpression,\n  Node,\n  Property,\n  VariableDeclarator,\n} from 'estree';\n\n/** Current API uses story.given() etc. inside test(); no top-level given/when/then. */\nconst V1_PACKAGE = 'executable-stories-jest';\n\nconst STEP_NAMES = new Set([\n  'given',\n  'when',\n  'then',\n  'and',\n  'but',\n  'arrange',\n  'act',\n  'assert',\n  'setup',\n  'context',\n  'execute',\n  'action',\n  'verify',\n]);\n\nconst STORY_MODIFIERS = new Set(['skip', 'only']);\n\nfunction isFunction(node: Node): boolean {\n  return (\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isFunctionNode(\n  node: Node,\n): node is FunctionDeclaration | ArrowFunctionExpression | FunctionExpression {\n  return (\n    node.type === 'FunctionDeclaration' ||\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') return callee.name === 'story';\n  if (callee.type !== 'MemberExpression') return false;\n  if (callee.object.type !== 'Identifier' || callee.object.name !== 'story')\n    return false;\n  return (\n    callee.property.type === 'Identifier' &&\n    STORY_MODIFIERS.has(callee.property.name)\n  );\n}\n\nfunction isDocStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  return (\n    callee.object.type === 'Identifier' &&\n    callee.object.name === 'doc' &&\n    callee.property.type === 'Identifier' &&\n    callee.property.name === 'story'\n  );\n}\n\nfunction isStepCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') return STEP_NAMES.has(callee.name);\n  if (callee.type !== 'MemberExpression') return false;\n  if (callee.object.type !== 'Identifier') return false;\n  if (callee.object.name !== 'steps' && callee.object.name !== 'step')\n    return false;\n  return (\n    callee.property.type === 'Identifier' &&\n    STEP_NAMES.has(callee.property.name)\n  );\n}\n\nfunction insideStoryCallback(\n  node: CallExpression,\n  context: Rule.RuleContext,\n): boolean {\n  const ancestors = context.sourceCode.getAncestors(node);\n  const functionAncestors = new Set(ancestors.filter(isFunction));\n\n  for (const ancestor of ancestors) {\n    if (ancestor.type !== 'CallExpression') continue;\n    if (!isStoryCall(ancestor) && !isDocStoryCall(ancestor)) continue;\n    for (const arg of ancestor.arguments) {\n      if (arg && typeof arg === 'object' && functionAncestors.has(arg)) {\n        return true;\n      }\n    }\n  }\n\n  return false;\n}\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require step functions (given/when/then/and/but and aliases) to be called inside story() or doc.story(..., callback).',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireStory:\n        'Step functions must be called inside story(...) (or doc.story(..., callback)).',\n    },\n  },\n  create(context) {\n    let hasV1Import = false;\n    const namedFunctions = new Map<string, Node>();\n    const storyCallbackNames = new Set<string>();\n    const pendingStepCalls: Array<{\n      node: CallExpression;\n      containingFunctionName: string | null;\n    }> = [];\n\n    function getContainingFunctionName(node: CallExpression): string | null {\n      const ancestors = context.sourceCode.getAncestors(node);\n      for (let i = ancestors.length - 1; i >= 0; i--) {\n        const ancestor = ancestors[i];\n        if (ancestor.type === 'FunctionDeclaration' && ancestor.id) {\n          return ancestor.id.name;\n        }\n        if (ancestor.type === 'VariableDeclarator') {\n          const declarator = ancestor as VariableDeclarator;\n          if (\n            declarator.id.type === 'Identifier' &&\n            declarator.init &&\n            isFunctionNode(declarator.init)\n          ) {\n            return declarator.id.name;\n          }\n        }\n        // Check for object method definitions\n        if (ancestor.type === 'Property') {\n          const prop = ancestor as Property;\n          if (\n            prop.key.type === 'Identifier' &&\n            prop.value &&\n            isFunctionNode(prop.value)\n          ) {\n            return prop.key.name;\n          }\n          // Shorthand method syntax: { define() {} }\n          if (prop.key.type === 'Identifier' && prop.method) {\n            return prop.key.name;\n          }\n        }\n      }\n      return null;\n    }\n\n    return {\n      ImportDeclaration(node) {\n        const pkg = node.source.value;\n        if (typeof pkg === 'string' && pkg === V1_PACKAGE) {\n          hasV1Import = true;\n        }\n      },\n      FunctionDeclaration(node: FunctionDeclaration) {\n        if (node.id) {\n          namedFunctions.set(node.id.name, node);\n        }\n      },\n      VariableDeclarator(node: VariableDeclarator) {\n        if (\n          node.id.type === 'Identifier' &&\n          node.init &&\n          isFunctionNode(node.init)\n        ) {\n          namedFunctions.set(node.id.name, node.init);\n        }\n      },\n      CallExpression(node: CallExpression) {\n        if (!hasV1Import) return;\n\n        if (isStoryCall(node) || isDocStoryCall(node)) {\n          for (const arg of node.arguments) {\n            if (arg.type === 'Identifier') {\n              storyCallbackNames.add(arg.name);\n            }\n            // Handle member expression callbacks like handlers.define\n            if (\n              arg.type === 'MemberExpression' &&\n              arg.property.type === 'Identifier'\n            ) {\n              storyCallbackNames.add(arg.property.name);\n            }\n          }\n          return;\n        }\n\n        if (!isStepCall(node)) return;\n        if (insideStoryCallback(node, context)) return;\n\n        const containingFunctionName = getContainingFunctionName(node);\n        pendingStepCalls.push({ node, containingFunctionName });\n      },\n      'Program:exit'() {\n        for (const { node, containingFunctionName } of pendingStepCalls) {\n          if (\n            containingFunctionName &&\n            storyCallbackNames.has(containingFunctionName)\n          ) {\n            continue;\n          }\n          context.report({ node, messageId: 'requireStory' });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\nimport type {\n  ArrowFunctionExpression,\n  CallExpression,\n  FunctionDeclaration,\n  FunctionExpression,\n  Node,\n  Property,\n  VariableDeclarator,\n} from 'estree';\n\nconst TEST_MODIFIERS = new Set([\n  'only',\n  'skip',\n  'todo',\n  'concurrent',\n  'failing',\n]);\n\nfunction isFunction(node: Node): boolean {\n  return (\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isFunctionNode(\n  node: Node,\n): node is FunctionDeclaration | ArrowFunctionExpression | FunctionExpression {\n  return (\n    node.type === 'FunctionDeclaration' ||\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\n/** Legacy doc.story() is not used; current API uses story.init() inside it/test. */\nconst V1_PACKAGE = 'executable-stories-jest';\n\nfunction isDocStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  return (\n    callee.object.type === 'Identifier' &&\n    callee.object.name === 'doc' &&\n    callee.property.type === 'Identifier' &&\n    callee.property.name === 'story'\n  );\n}\n\nfunction isTestCallExpression(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') {\n    return callee.name === 'test' || callee.name === 'it';\n  }\n  if (callee.type === 'MemberExpression') {\n    if (callee.object.type !== 'Identifier') return false;\n    if (callee.object.name !== 'test' && callee.object.name !== 'it')\n      return false;\n    if (callee.property.type !== 'Identifier') return false;\n    return TEST_MODIFIERS.has(callee.property.name);\n  }\n  if (callee.type === 'CallExpression') {\n    const inner = callee.callee;\n    if (inner.type !== 'MemberExpression') return false;\n    if (inner.object.type !== 'Identifier') return false;\n    if (inner.object.name !== 'test' && inner.object.name !== 'it')\n      return false;\n    return (\n      inner.property.type === 'Identifier' && inner.property.name === 'each'\n    );\n  }\n  return false;\n}\n\nfunction insideTestCallback(\n  node: CallExpression,\n  context: Rule.RuleContext,\n): boolean {\n  const ancestors = context.sourceCode.getAncestors(node);\n  const functionAncestors = new Set(ancestors.filter(isFunction));\n\n  for (const ancestor of ancestors) {\n    if (ancestor.type !== 'CallExpression') continue;\n    if (!isTestCallExpression(ancestor)) continue;\n    for (const arg of ancestor.arguments) {\n      if (arg && typeof arg === 'object' && functionAncestors.has(arg)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require doc.story(title) to be called inside a test/it callback in Jest.',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireTest:\n        \"doc.story(title) must be called inside a test/it callback (e.g. it('...', () => { doc.story('Title'); ... })).\",\n      requireTitle: 'doc.story(title) requires a title argument.',\n    },\n  },\n  create(context) {\n    let hasV1Import = false;\n    const namedFunctions = new Map<string, Node>();\n    const testCallbackNames = new Set<string>();\n    const pendingDocStoryCalls: Array<{\n      node: CallExpression;\n      containingFunctionName: string | null;\n    }> = [];\n\n    function getContainingFunctionName(node: CallExpression): string | null {\n      const ancestors = context.sourceCode.getAncestors(node);\n      for (let i = ancestors.length - 1; i >= 0; i--) {\n        const ancestor = ancestors[i];\n        if (ancestor.type === 'FunctionDeclaration' && ancestor.id) {\n          return ancestor.id.name;\n        }\n        if (ancestor.type === 'VariableDeclarator') {\n          const declarator = ancestor as VariableDeclarator;\n          if (\n            declarator.id.type === 'Identifier' &&\n            declarator.init &&\n            isFunctionNode(declarator.init)\n          ) {\n            return declarator.id.name;\n          }\n        }\n        // Check for object method definitions\n        if (ancestor.type === 'Property') {\n          const prop = ancestor as Property;\n          if (\n            prop.key.type === 'Identifier' &&\n            prop.value &&\n            isFunctionNode(prop.value)\n          ) {\n            return prop.key.name;\n          }\n          // Shorthand method syntax: { run() {} }\n          if (prop.key.type === 'Identifier' && prop.method) {\n            return prop.key.name;\n          }\n        }\n      }\n      return null;\n    }\n\n    return {\n      ImportDeclaration(node) {\n        if (node.source.value === V1_PACKAGE) {\n          hasV1Import = true;\n        }\n      },\n      FunctionDeclaration(node: FunctionDeclaration) {\n        if (node.id) {\n          namedFunctions.set(node.id.name, node);\n        }\n      },\n      VariableDeclarator(node: VariableDeclarator) {\n        if (\n          node.id.type === 'Identifier' &&\n          node.init &&\n          isFunctionNode(node.init)\n        ) {\n          namedFunctions.set(node.id.name, node.init);\n        }\n      },\n      CallExpression(node: CallExpression) {\n        if (!hasV1Import) return;\n\n        if (isTestCallExpression(node)) {\n          for (const arg of node.arguments) {\n            if (arg.type === 'Identifier') {\n              testCallbackNames.add(arg.name);\n            }\n            // Handle member expression callbacks like handlers.run\n            if (\n              arg.type === 'MemberExpression' &&\n              arg.property.type === 'Identifier'\n            ) {\n              testCallbackNames.add(arg.property.name);\n            }\n          }\n          return;\n        }\n\n        if (!isDocStoryCall(node)) return;\n\n        if (node.arguments.length === 0) {\n          context.report({ node, messageId: 'requireTitle' });\n          return;\n        }\n        if (node.arguments.length >= 2) return;\n\n        if (insideTestCallback(node, context)) return;\n\n        const containingFunctionName = getContainingFunctionName(node);\n        pendingDocStoryCalls.push({ node, containingFunctionName });\n      },\n      'Program:exit'() {\n        for (const { node, containingFunctionName } of pendingDocStoryCalls) {\n          if (\n            containingFunctionName &&\n            testCallbackNames.has(containingFunctionName)\n          ) {\n            continue;\n          }\n          context.report({ node, messageId: 'requireTest' });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n"],"mappings":"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","names":["isFunction","isFunctionNode","V1_PACKAGE","isDocStoryCall","rule"]}
+{"version":3,"sources":["../src/index.ts","../src/rules/require-init-before-steps.ts","../src/rules/require-story-context-for-steps.ts","../src/rules/require-test-context-for-doc-story.ts"],"sourcesContent":["import type { ESLint, Linter } from 'eslint';\nimport requireInitBeforeSteps from './rules/require-init-before-steps.js';\nimport requireStoryContextForSteps from './rules/require-story-context-for-steps.js';\nimport requireTestContextForDocStory from './rules/require-test-context-for-doc-story.js';\n\nconst rules = {\n  'require-init-before-steps': requireInitBeforeSteps,\n  'require-story-context-for-steps': requireStoryContextForSteps,\n  'require-test-context-for-doc-story': requireTestContextForDocStory,\n};\n\nconst configs: Record<string, Linter.Config[]> = {\n  recommended: [\n    {\n      plugins: {\n        'executable-stories-jest': { rules },\n      },\n      rules: {\n        'executable-stories-jest/require-init-before-steps': 'error',\n        'executable-stories-jest/require-story-context-for-steps': 'error',\n        'executable-stories-jest/require-test-context-for-doc-story': 'error',\n      },\n    },\n  ],\n};\n\nconst plugin: ESLint.Plugin = {\n  meta: {\n    name: 'eslint-plugin-executable-stories-jest',\n    version: '0.1.0',\n  },\n  rules,\n  configs,\n};\n\nexport default plugin;\nexport { rules, configs };\n","import type { Rule } from 'eslint';\nimport type { CallExpression, MemberExpression, Node } from 'estree';\n\n/**\n * Rule: require-init-before-steps\n *\n * Ensures story.init() is called before any step markers (story.given/when/then/etc).\n * This is a best-effort static check - it flags step markers that appear before any story.init()\n * call in the same function scope.\n *\n * BAD:\n *   story.given('something'); // No story.init() before this\n *\n * GOOD:\n *   story.init();\n *   story.given('something');\n */\n\nconst STEP_NAMES = new Set([\n  'given',\n  'when',\n  'then',\n  'and',\n  'but',\n  'arrange',\n  'act',\n  'assert',\n  'setup',\n  'context',\n  'execute',\n  'action',\n  'verify',\n  'fn',\n  'expect',\n]);\n\nfunction isFunction(node: Node): boolean {\n  return (\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression' ||\n    node.type === 'FunctionDeclaration'\n  );\n}\n\nfunction isStoryInitCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  const member = callee as MemberExpression;\n  const { object, property } = member;\n  return (\n    object.type === 'Identifier' &&\n    object.name === 'story' &&\n    property.type === 'Identifier' &&\n    property.name === 'init'\n  );\n}\n\nfunction isStoryStepCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  const member = callee as MemberExpression;\n  const { object, property } = member;\n  return (\n    object.type === 'Identifier' &&\n    object.name === 'story' &&\n    property.type === 'Identifier' &&\n    STEP_NAMES.has(property.name)\n  );\n}\n\nfunction getContainingFunction(\n  node: Node,\n  context: Rule.RuleContext,\n): Node | null {\n  const ancestors = context.sourceCode.getAncestors(node);\n  for (let i = ancestors.length - 1; i >= 0; i--) {\n    if (isFunction(ancestors[i])) {\n      return ancestors[i];\n    }\n  }\n  return null;\n}\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require story.init() to be called before any step markers (story.given/when/then/etc) in Jest.',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireInit:\n        'story.init() must be called before using step markers like story.given(), story.when(), story.then().',\n    },\n  },\n  create(context) {\n    let hasRelevantImport = false;\n    // Track functions that have story.init() calls\n    const functionsWithInit = new WeakSet<Node>();\n    // Track step calls and their containing functions for later verification\n    const pendingStepCalls: Array<{\n      node: CallExpression;\n      containingFunction: Node | null;\n    }> = [];\n\n    return {\n      ImportDeclaration(node) {\n        if (node.source.value === 'executable-stories-jest') {\n          hasRelevantImport = true;\n        }\n      },\n      CallExpression(node: CallExpression) {\n        if (!hasRelevantImport) return;\n\n        if (isStoryInitCall(node)) {\n          const containingFunction = getContainingFunction(node, context);\n          if (containingFunction) {\n            functionsWithInit.add(containingFunction);\n          }\n          return;\n        }\n\n        if (isStoryStepCall(node)) {\n          const containingFunction = getContainingFunction(node, context);\n          pendingStepCalls.push({ node, containingFunction });\n        }\n      },\n      'Program:exit'() {\n        for (const { node, containingFunction } of pendingStepCalls) {\n          // If no containing function, or the function doesn't have story.init(), report\n          if (\n            !containingFunction ||\n            !functionsWithInit.has(containingFunction)\n          ) {\n            context.report({ node, messageId: 'requireInit' });\n          }\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\nimport type {\n  ArrowFunctionExpression,\n  CallExpression,\n  FunctionDeclaration,\n  FunctionExpression,\n  Node,\n  Property,\n  VariableDeclarator,\n} from 'estree';\n\n/** Current API uses story.given() etc. inside test(); no top-level given/when/then. */\nconst V1_PACKAGE = 'executable-stories-jest';\n\nconst STEP_NAMES = new Set([\n  'given',\n  'when',\n  'then',\n  'and',\n  'but',\n  'arrange',\n  'act',\n  'assert',\n  'setup',\n  'context',\n  'execute',\n  'action',\n  'verify',\n]);\n\nconst STORY_MODIFIERS = new Set(['skip', 'only']);\n\nfunction isFunction(node: Node): boolean {\n  return (\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isFunctionNode(\n  node: Node,\n): node is FunctionDeclaration | ArrowFunctionExpression | FunctionExpression {\n  return (\n    node.type === 'FunctionDeclaration' ||\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') return callee.name === 'story';\n  if (callee.type !== 'MemberExpression') return false;\n  if (callee.object.type !== 'Identifier' || callee.object.name !== 'story')\n    return false;\n  return (\n    callee.property.type === 'Identifier' &&\n    STORY_MODIFIERS.has(callee.property.name)\n  );\n}\n\nfunction isStoryInitCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  return (\n    callee.object.type === 'Identifier' &&\n    callee.object.name === 'story' &&\n    callee.property.type === 'Identifier' &&\n    callee.property.name === 'init'\n  );\n}\n\nfunction isDocStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  return (\n    callee.object.type === 'Identifier' &&\n    callee.object.name === 'doc' &&\n    callee.property.type === 'Identifier' &&\n    callee.property.name === 'story'\n  );\n}\n\nfunction isStepCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') return STEP_NAMES.has(callee.name);\n  if (callee.type !== 'MemberExpression') return false;\n  if (callee.object.type !== 'Identifier') return false;\n  if (callee.object.name !== 'steps' && callee.object.name !== 'step')\n    return false;\n  return (\n    callee.property.type === 'Identifier' &&\n    STEP_NAMES.has(callee.property.name)\n  );\n}\n\nfunction insideStoryCallback(\n  node: CallExpression,\n  context: Rule.RuleContext,\n): boolean {\n  const ancestors = context.sourceCode.getAncestors(node);\n  const functionAncestors = new Set(ancestors.filter(isFunction));\n\n  for (const ancestor of ancestors) {\n    if (ancestor.type !== 'CallExpression') continue;\n    if (!isStoryCall(ancestor) && !isDocStoryCall(ancestor)) continue;\n    for (const arg of ancestor.arguments) {\n      if (arg && typeof arg === 'object' && functionAncestors.has(arg)) {\n        return true;\n      }\n    }\n  }\n\n  return false;\n}\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require step functions (given/when/then/and/but and aliases) to be called inside story() or doc.story(..., callback).',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireStory:\n        'Step functions must be called inside story(...) (or doc.story(..., callback)).',\n    },\n  },\n  create(context) {\n    let hasV1Import = false;\n    const namedFunctions = new Map<string, Node>();\n    const storyCallbackNames = new Set<string>();\n    // Track functions that contain story.init() calls\n    const functionsWithInit = new WeakSet<Node>();\n    const pendingStepCalls: Array<{\n      node: CallExpression;\n      containingFunction: Node | null;\n      containingFunctionName: string | null;\n    }> = [];\n\n    function getContainingFunction(node: CallExpression): Node | null {\n      const ancestors = context.sourceCode.getAncestors(node);\n      for (let i = ancestors.length - 1; i >= 0; i--) {\n        if (isFunctionNode(ancestors[i]) || isFunction(ancestors[i])) {\n          return ancestors[i];\n        }\n      }\n      return null;\n    }\n\n    function getContainingFunctionName(node: CallExpression): string | null {\n      const ancestors = context.sourceCode.getAncestors(node);\n      for (let i = ancestors.length - 1; i >= 0; i--) {\n        const ancestor = ancestors[i];\n        if (ancestor.type === 'FunctionDeclaration' && ancestor.id) {\n          return ancestor.id.name;\n        }\n        if (ancestor.type === 'VariableDeclarator') {\n          const declarator = ancestor as VariableDeclarator;\n          if (\n            declarator.id.type === 'Identifier' &&\n            declarator.init &&\n            isFunctionNode(declarator.init)\n          ) {\n            return declarator.id.name;\n          }\n        }\n        // Check for object method definitions\n        if (ancestor.type === 'Property') {\n          const prop = ancestor as Property;\n          if (\n            prop.key.type === 'Identifier' &&\n            prop.value &&\n            isFunctionNode(prop.value)\n          ) {\n            return prop.key.name;\n          }\n          // Shorthand method syntax: { define() {} }\n          if (prop.key.type === 'Identifier' && prop.method) {\n            return prop.key.name;\n          }\n        }\n      }\n      return null;\n    }\n\n    return {\n      ImportDeclaration(node) {\n        const pkg = node.source.value;\n        if (typeof pkg === 'string' && pkg === V1_PACKAGE) {\n          hasV1Import = true;\n        }\n      },\n      FunctionDeclaration(node: FunctionDeclaration) {\n        if (node.id) {\n          namedFunctions.set(node.id.name, node);\n        }\n      },\n      VariableDeclarator(node: VariableDeclarator) {\n        if (\n          node.id.type === 'Identifier' &&\n          node.init &&\n          isFunctionNode(node.init)\n        ) {\n          namedFunctions.set(node.id.name, node.init);\n        }\n      },\n      CallExpression(node: CallExpression) {\n        if (!hasV1Import) return;\n\n        // Track story.init() calls and their containing functions\n        if (isStoryInitCall(node)) {\n          const containingFunction = getContainingFunction(node);\n          if (containingFunction) {\n            functionsWithInit.add(containingFunction);\n          }\n          return;\n        }\n\n        if (isStoryCall(node) || isDocStoryCall(node)) {\n          for (const arg of node.arguments) {\n            if (arg.type === 'Identifier') {\n              storyCallbackNames.add(arg.name);\n            }\n            // Handle member expression callbacks like handlers.define\n            if (\n              arg.type === 'MemberExpression' &&\n              arg.property.type === 'Identifier'\n            ) {\n              storyCallbackNames.add(arg.property.name);\n            }\n          }\n          return;\n        }\n\n        if (!isStepCall(node)) return;\n        if (insideStoryCallback(node, context)) return;\n\n        const containingFunction = getContainingFunction(node);\n        const containingFunctionName = getContainingFunctionName(node);\n        pendingStepCalls.push({ node, containingFunction, containingFunctionName });\n      },\n      'Program:exit'() {\n        for (const { node, containingFunction, containingFunctionName } of pendingStepCalls) {\n          // Allow if inside a named function passed to story()/doc.story()\n          if (\n            containingFunctionName &&\n            storyCallbackNames.has(containingFunctionName)\n          ) {\n            continue;\n          }\n          // Allow if inside a function that has story.init()\n          if (containingFunction && functionsWithInit.has(containingFunction)) {\n            continue;\n          }\n          context.report({ node, messageId: 'requireStory' });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\nimport type {\n  ArrowFunctionExpression,\n  CallExpression,\n  FunctionDeclaration,\n  FunctionExpression,\n  Node,\n  Property,\n  VariableDeclarator,\n} from 'estree';\n\nconst TEST_MODIFIERS = new Set([\n  'only',\n  'skip',\n  'todo',\n  'concurrent',\n  'failing',\n]);\n\nfunction isFunction(node: Node): boolean {\n  return (\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isFunctionNode(\n  node: Node,\n): node is FunctionDeclaration | ArrowFunctionExpression | FunctionExpression {\n  return (\n    node.type === 'FunctionDeclaration' ||\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\n/** Legacy doc.story() is not used; current API uses story.init() inside it/test. */\nconst V1_PACKAGE = 'executable-stories-jest';\n\nfunction isDocStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  return (\n    callee.object.type === 'Identifier' &&\n    callee.object.name === 'doc' &&\n    callee.property.type === 'Identifier' &&\n    callee.property.name === 'story'\n  );\n}\n\nfunction isTestCallExpression(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') {\n    return callee.name === 'test' || callee.name === 'it';\n  }\n  if (callee.type === 'MemberExpression') {\n    if (callee.object.type !== 'Identifier') return false;\n    if (callee.object.name !== 'test' && callee.object.name !== 'it')\n      return false;\n    if (callee.property.type !== 'Identifier') return false;\n    return TEST_MODIFIERS.has(callee.property.name);\n  }\n  if (callee.type === 'CallExpression') {\n    const inner = callee.callee;\n    if (inner.type !== 'MemberExpression') return false;\n    if (inner.object.type !== 'Identifier') return false;\n    if (inner.object.name !== 'test' && inner.object.name !== 'it')\n      return false;\n    return (\n      inner.property.type === 'Identifier' && inner.property.name === 'each'\n    );\n  }\n  return false;\n}\n\nfunction insideTestCallback(\n  node: CallExpression,\n  context: Rule.RuleContext,\n): boolean {\n  const ancestors = context.sourceCode.getAncestors(node);\n  const functionAncestors = new Set(ancestors.filter(isFunction));\n\n  for (const ancestor of ancestors) {\n    if (ancestor.type !== 'CallExpression') continue;\n    if (!isTestCallExpression(ancestor)) continue;\n    for (const arg of ancestor.arguments) {\n      if (arg && typeof arg === 'object' && functionAncestors.has(arg)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require doc.story(title) to be called inside a test/it callback in Jest.',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireTest:\n        \"doc.story(title) must be called inside a test/it callback (e.g. it('...', () => { doc.story('Title'); ... })).\",\n      requireTitle: 'doc.story(title) requires a title argument.',\n    },\n  },\n  create(context) {\n    let hasV1Import = false;\n    const namedFunctions = new Map<string, Node>();\n    const testCallbackNames = new Set<string>();\n    const pendingDocStoryCalls: Array<{\n      node: CallExpression;\n      containingFunctionName: string | null;\n    }> = [];\n\n    function getContainingFunctionName(node: CallExpression): string | null {\n      const ancestors = context.sourceCode.getAncestors(node);\n      for (let i = ancestors.length - 1; i >= 0; i--) {\n        const ancestor = ancestors[i];\n        if (ancestor.type === 'FunctionDeclaration' && ancestor.id) {\n          return ancestor.id.name;\n        }\n        if (ancestor.type === 'VariableDeclarator') {\n          const declarator = ancestor as VariableDeclarator;\n          if (\n            declarator.id.type === 'Identifier' &&\n            declarator.init &&\n            isFunctionNode(declarator.init)\n          ) {\n            return declarator.id.name;\n          }\n        }\n        // Check for object method definitions\n        if (ancestor.type === 'Property') {\n          const prop = ancestor as Property;\n          if (\n            prop.key.type === 'Identifier' &&\n            prop.value &&\n            isFunctionNode(prop.value)\n          ) {\n            return prop.key.name;\n          }\n          // Shorthand method syntax: { run() {} }\n          if (prop.key.type === 'Identifier' && prop.method) {\n            return prop.key.name;\n          }\n        }\n      }\n      return null;\n    }\n\n    return {\n      ImportDeclaration(node) {\n        if (node.source.value === V1_PACKAGE) {\n          hasV1Import = true;\n        }\n      },\n      FunctionDeclaration(node: FunctionDeclaration) {\n        if (node.id) {\n          namedFunctions.set(node.id.name, node);\n        }\n      },\n      VariableDeclarator(node: VariableDeclarator) {\n        if (\n          node.id.type === 'Identifier' &&\n          node.init &&\n          isFunctionNode(node.init)\n        ) {\n          namedFunctions.set(node.id.name, node.init);\n        }\n      },\n      CallExpression(node: CallExpression) {\n        if (!hasV1Import) return;\n\n        if (isTestCallExpression(node)) {\n          for (const arg of node.arguments) {\n            if (arg.type === 'Identifier') {\n              testCallbackNames.add(arg.name);\n            }\n            // Handle member expression callbacks like handlers.run\n            if (\n              arg.type === 'MemberExpression' &&\n              arg.property.type === 'Identifier'\n            ) {\n              testCallbackNames.add(arg.property.name);\n            }\n          }\n          return;\n        }\n\n        if (!isDocStoryCall(node)) return;\n\n        if (node.arguments.length === 0) {\n          context.report({ node, messageId: 'requireTitle' });\n          return;\n        }\n        if (node.arguments.length >= 2) return;\n\n        if (insideTestCallback(node, context)) return;\n\n        const containingFunctionName = getContainingFunctionName(node);\n        pendingDocStoryCalls.push({ node, containingFunctionName });\n      },\n      'Program:exit'() {\n        for (const { node, containingFunctionName } of pendingDocStoryCalls) {\n          if (\n            containingFunctionName &&\n            testCallbackNames.has(containingFunctionName)\n          ) {\n            continue;\n          }\n          context.report({ node, messageId: 'requireTest' });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n"],"mappings":"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","names":["STEP_NAMES","isFunction","isStoryInitCall","rule","getContainingFunction","containingFunction","isFunction","isFunctionNode","V1_PACKAGE","isDocStoryCall","rule"]}

package/dist/index.d.cts

@@ -2,6 +2,7 @@ import * as eslint from 'eslint';
 import { Linter, ESLint } from 'eslint';
 
 declare const rules: {
+    'require-init-before-steps': eslint.Rule.RuleModule;
     'require-story-context-for-steps': eslint.Rule.RuleModule;
     'require-test-context-for-doc-story': eslint.Rule.RuleModule;
 };

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import * as eslint from 'eslint';
 import { Linter, ESLint } from 'eslint';
 
 declare const rules: {
+    'require-init-before-steps': eslint.Rule.RuleModule;
     'require-story-context-for-steps': eslint.Rule.RuleModule;
     'require-test-context-for-doc-story': eslint.Rule.RuleModule;
 };

package/dist/index.js

@@ -1,6 +1,98 @@
+// src/rules/require-init-before-steps.ts
+var STEP_NAMES = /* @__PURE__ */ new Set([
+  "given",
+  "when",
+  "then",
+  "and",
+  "but",
+  "arrange",
+  "act",
+  "assert",
+  "setup",
+  "context",
+  "execute",
+  "action",
+  "verify",
+  "fn",
+  "expect"
+]);
+function isFunction(node) {
+  return node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression" || node.type === "FunctionDeclaration";
+}
+function isStoryInitCall(node) {
+  const { callee } = node;
+  if (callee.type !== "MemberExpression") return false;
+  const member = callee;
+  const { object, property } = member;
+  return object.type === "Identifier" && object.name === "story" && property.type === "Identifier" && property.name === "init";
+}
+function isStoryStepCall(node) {
+  const { callee } = node;
+  if (callee.type !== "MemberExpression") return false;
+  const member = callee;
+  const { object, property } = member;
+  return object.type === "Identifier" && object.name === "story" && property.type === "Identifier" && STEP_NAMES.has(property.name);
+}
+function getContainingFunction(node, context) {
+  const ancestors = context.sourceCode.getAncestors(node);
+  for (let i = ancestors.length - 1; i >= 0; i--) {
+    if (isFunction(ancestors[i])) {
+      return ancestors[i];
+    }
+  }
+  return null;
+}
+var rule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require story.init() to be called before any step markers (story.given/when/then/etc) in Jest.",
+      recommended: true
+    },
+    schema: [],
+    messages: {
+      requireInit: "story.init() must be called before using step markers like story.given(), story.when(), story.then()."
+    }
+  },
+  create(context) {
+    let hasRelevantImport = false;
+    const functionsWithInit = /* @__PURE__ */ new WeakSet();
+    const pendingStepCalls = [];
+    return {
+      ImportDeclaration(node) {
+        if (node.source.value === "executable-stories-jest") {
+          hasRelevantImport = true;
+        }
+      },
+      CallExpression(node) {
+        if (!hasRelevantImport) return;
+        if (isStoryInitCall(node)) {
+          const containingFunction = getContainingFunction(node, context);
+          if (containingFunction) {
+            functionsWithInit.add(containingFunction);
+          }
+          return;
+        }
+        if (isStoryStepCall(node)) {
+          const containingFunction = getContainingFunction(node, context);
+          pendingStepCalls.push({ node, containingFunction });
+        }
+      },
+      "Program:exit"() {
+        for (const { node, containingFunction } of pendingStepCalls) {
+          if (!containingFunction || !functionsWithInit.has(containingFunction)) {
+            context.report({ node, messageId: "requireInit" });
+          }
+        }
+      }
+    };
+  }
+};
+var require_init_before_steps_default = rule;
+
 // src/rules/require-story-context-for-steps.ts
 var V1_PACKAGE = "executable-stories-jest";
-var STEP_NAMES = /* @__PURE__ */ new Set([
+var STEP_NAMES2 = /* @__PURE__ */ new Set([
   "given",
   "when",
   "then",
@@ -16,7 +108,7 @@ var STEP_NAMES = /* @__PURE__ */ new Set([
   "verify"
 ]);
 var STORY_MODIFIERS = /* @__PURE__ */ new Set(["skip", "only"]);
-function isFunction(node) {
+function isFunction2(node) {
   return node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
 }
 function isFunctionNode(node) {
@@ -30,6 +122,11 @@ function isStoryCall(node) {
     return false;
   return callee.property.type === "Identifier" && STORY_MODIFIERS.has(callee.property.name);
 }
+function isStoryInitCall2(node) {
+  const { callee } = node;
+  if (callee.type !== "MemberExpression") return false;
+  return callee.object.type === "Identifier" && callee.object.name === "story" && callee.property.type === "Identifier" && callee.property.name === "init";
+}
 function isDocStoryCall(node) {
   const { callee } = node;
   if (callee.type !== "MemberExpression") return false;
@@ -37,16 +134,16 @@ function isDocStoryCall(node) {
 }
 function isStepCall(node) {
   const { callee } = node;
-  if (callee.type === "Identifier") return STEP_NAMES.has(callee.name);
+  if (callee.type === "Identifier") return STEP_NAMES2.has(callee.name);
   if (callee.type !== "MemberExpression") return false;
   if (callee.object.type !== "Identifier") return false;
   if (callee.object.name !== "steps" && callee.object.name !== "step")
     return false;
-  return callee.property.type === "Identifier" && STEP_NAMES.has(callee.property.name);
+  return callee.property.type === "Identifier" && STEP_NAMES2.has(callee.property.name);
 }
 function insideStoryCallback(node, context) {
   const ancestors = context.sourceCode.getAncestors(node);
-  const functionAncestors = new Set(ancestors.filter(isFunction));
+  const functionAncestors = new Set(ancestors.filter(isFunction2));
   for (const ancestor of ancestors) {
     if (ancestor.type !== "CallExpression") continue;
     if (!isStoryCall(ancestor) && !isDocStoryCall(ancestor)) continue;
@@ -58,7 +155,7 @@ function insideStoryCallback(node, context) {
   }
   return false;
 }
-var rule = {
+var rule2 = {
   meta: {
     type: "problem",
     docs: {
@@ -74,7 +171,17 @@ var rule = {
     let hasV1Import = false;
     const namedFunctions = /* @__PURE__ */ new Map();
     const storyCallbackNames = /* @__PURE__ */ new Set();
+    const functionsWithInit = /* @__PURE__ */ new WeakSet();
     const pendingStepCalls = [];
+    function getContainingFunction2(node) {
+      const ancestors = context.sourceCode.getAncestors(node);
+      for (let i = ancestors.length - 1; i >= 0; i--) {
+        if (isFunctionNode(ancestors[i]) || isFunction2(ancestors[i])) {
+          return ancestors[i];
+        }
+      }
+      return null;
+    }
     function getContainingFunctionName(node) {
       const ancestors = context.sourceCode.getAncestors(node);
       for (let i = ancestors.length - 1; i >= 0; i--) {
@@ -119,6 +226,13 @@ var rule = {
       },
       CallExpression(node) {
         if (!hasV1Import) return;
+        if (isStoryInitCall2(node)) {
+          const containingFunction2 = getContainingFunction2(node);
+          if (containingFunction2) {
+            functionsWithInit.add(containingFunction2);
+          }
+          return;
+        }
         if (isStoryCall(node) || isDocStoryCall(node)) {
           for (const arg of node.arguments) {
             if (arg.type === "Identifier") {
@@ -132,21 +246,25 @@ var rule = {
         }
         if (!isStepCall(node)) return;
         if (insideStoryCallback(node, context)) return;
+        const containingFunction = getContainingFunction2(node);
         const containingFunctionName = getContainingFunctionName(node);
-        pendingStepCalls.push({ node, containingFunctionName });
+        pendingStepCalls.push({ node, containingFunction, containingFunctionName });
       },
       "Program:exit"() {
-        for (const { node, containingFunctionName } of pendingStepCalls) {
+        for (const { node, containingFunction, containingFunctionName } of pendingStepCalls) {
           if (containingFunctionName && storyCallbackNames.has(containingFunctionName)) {
             continue;
           }
+          if (containingFunction && functionsWithInit.has(containingFunction)) {
+            continue;
+          }
           context.report({ node, messageId: "requireStory" });
         }
       }
     };
   }
 };
-var require_story_context_for_steps_default = rule;
+var require_story_context_for_steps_default = rule2;
 
 // src/rules/require-test-context-for-doc-story.ts
 var TEST_MODIFIERS = /* @__PURE__ */ new Set([
@@ -156,7 +274,7 @@ var TEST_MODIFIERS = /* @__PURE__ */ new Set([
   "concurrent",
   "failing"
 ]);
-function isFunction2(node) {
+function isFunction3(node) {
   return node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
 }
 function isFunctionNode2(node) {
@@ -192,7 +310,7 @@ function isTestCallExpression(node) {
 }
 function insideTestCallback(node, context) {
   const ancestors = context.sourceCode.getAncestors(node);
-  const functionAncestors = new Set(ancestors.filter(isFunction2));
+  const functionAncestors = new Set(ancestors.filter(isFunction3));
   for (const ancestor of ancestors) {
     if (ancestor.type !== "CallExpression") continue;
     if (!isTestCallExpression(ancestor)) continue;
@@ -204,7 +322,7 @@ function insideTestCallback(node, context) {
   }
   return false;
 }
-var rule2 = {
+var rule3 = {
   meta: {
     type: "problem",
     docs: {
@@ -297,10 +415,11 @@ var rule2 = {
     };
   }
 };
-var require_test_context_for_doc_story_default = rule2;
+var require_test_context_for_doc_story_default = rule3;
 
 // src/index.ts
 var rules = {
+  "require-init-before-steps": require_init_before_steps_default,
   "require-story-context-for-steps": require_story_context_for_steps_default,
   "require-test-context-for-doc-story": require_test_context_for_doc_story_default
 };
@@ -311,6 +430,7 @@ var configs = {
         "executable-stories-jest": { rules }
       },
       rules: {
+        "executable-stories-jest/require-init-before-steps": "error",
         "executable-stories-jest/require-story-context-for-steps": "error",
         "executable-stories-jest/require-test-context-for-doc-story": "error"
       }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/rules/require-story-context-for-steps.ts","../src/rules/require-test-context-for-doc-story.ts","../src/index.ts"],"sourcesContent":["import type { Rule } from 'eslint';\nimport type {\n  ArrowFunctionExpression,\n  CallExpression,\n  FunctionDeclaration,\n  FunctionExpression,\n  Node,\n  Property,\n  VariableDeclarator,\n} from 'estree';\n\n/** Current API uses story.given() etc. inside test(); no top-level given/when/then. */\nconst V1_PACKAGE = 'executable-stories-jest';\n\nconst STEP_NAMES = new Set([\n  'given',\n  'when',\n  'then',\n  'and',\n  'but',\n  'arrange',\n  'act',\n  'assert',\n  'setup',\n  'context',\n  'execute',\n  'action',\n  'verify',\n]);\n\nconst STORY_MODIFIERS = new Set(['skip', 'only']);\n\nfunction isFunction(node: Node): boolean {\n  return (\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isFunctionNode(\n  node: Node,\n): node is FunctionDeclaration | ArrowFunctionExpression | FunctionExpression {\n  return (\n    node.type === 'FunctionDeclaration' ||\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') return callee.name === 'story';\n  if (callee.type !== 'MemberExpression') return false;\n  if (callee.object.type !== 'Identifier' || callee.object.name !== 'story')\n    return false;\n  return (\n    callee.property.type === 'Identifier' &&\n    STORY_MODIFIERS.has(callee.property.name)\n  );\n}\n\nfunction isDocStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  return (\n    callee.object.type === 'Identifier' &&\n    callee.object.name === 'doc' &&\n    callee.property.type === 'Identifier' &&\n    callee.property.name === 'story'\n  );\n}\n\nfunction isStepCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') return STEP_NAMES.has(callee.name);\n  if (callee.type !== 'MemberExpression') return false;\n  if (callee.object.type !== 'Identifier') return false;\n  if (callee.object.name !== 'steps' && callee.object.name !== 'step')\n    return false;\n  return (\n    callee.property.type === 'Identifier' &&\n    STEP_NAMES.has(callee.property.name)\n  );\n}\n\nfunction insideStoryCallback(\n  node: CallExpression,\n  context: Rule.RuleContext,\n): boolean {\n  const ancestors = context.sourceCode.getAncestors(node);\n  const functionAncestors = new Set(ancestors.filter(isFunction));\n\n  for (const ancestor of ancestors) {\n    if (ancestor.type !== 'CallExpression') continue;\n    if (!isStoryCall(ancestor) && !isDocStoryCall(ancestor)) continue;\n    for (const arg of ancestor.arguments) {\n      if (arg && typeof arg === 'object' && functionAncestors.has(arg)) {\n        return true;\n      }\n    }\n  }\n\n  return false;\n}\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require step functions (given/when/then/and/but and aliases) to be called inside story() or doc.story(..., callback).',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireStory:\n        'Step functions must be called inside story(...) (or doc.story(..., callback)).',\n    },\n  },\n  create(context) {\n    let hasV1Import = false;\n    const namedFunctions = new Map<string, Node>();\n    const storyCallbackNames = new Set<string>();\n    const pendingStepCalls: Array<{\n      node: CallExpression;\n      containingFunctionName: string | null;\n    }> = [];\n\n    function getContainingFunctionName(node: CallExpression): string | null {\n      const ancestors = context.sourceCode.getAncestors(node);\n      for (let i = ancestors.length - 1; i >= 0; i--) {\n        const ancestor = ancestors[i];\n        if (ancestor.type === 'FunctionDeclaration' && ancestor.id) {\n          return ancestor.id.name;\n        }\n        if (ancestor.type === 'VariableDeclarator') {\n          const declarator = ancestor as VariableDeclarator;\n          if (\n            declarator.id.type === 'Identifier' &&\n            declarator.init &&\n            isFunctionNode(declarator.init)\n          ) {\n            return declarator.id.name;\n          }\n        }\n        // Check for object method definitions\n        if (ancestor.type === 'Property') {\n          const prop = ancestor as Property;\n          if (\n            prop.key.type === 'Identifier' &&\n            prop.value &&\n            isFunctionNode(prop.value)\n          ) {\n            return prop.key.name;\n          }\n          // Shorthand method syntax: { define() {} }\n          if (prop.key.type === 'Identifier' && prop.method) {\n            return prop.key.name;\n          }\n        }\n      }\n      return null;\n    }\n\n    return {\n      ImportDeclaration(node) {\n        const pkg = node.source.value;\n        if (typeof pkg === 'string' && pkg === V1_PACKAGE) {\n          hasV1Import = true;\n        }\n      },\n      FunctionDeclaration(node: FunctionDeclaration) {\n        if (node.id) {\n          namedFunctions.set(node.id.name, node);\n        }\n      },\n      VariableDeclarator(node: VariableDeclarator) {\n        if (\n          node.id.type === 'Identifier' &&\n          node.init &&\n          isFunctionNode(node.init)\n        ) {\n          namedFunctions.set(node.id.name, node.init);\n        }\n      },\n      CallExpression(node: CallExpression) {\n        if (!hasV1Import) return;\n\n        if (isStoryCall(node) || isDocStoryCall(node)) {\n          for (const arg of node.arguments) {\n            if (arg.type === 'Identifier') {\n              storyCallbackNames.add(arg.name);\n            }\n            // Handle member expression callbacks like handlers.define\n            if (\n              arg.type === 'MemberExpression' &&\n              arg.property.type === 'Identifier'\n            ) {\n              storyCallbackNames.add(arg.property.name);\n            }\n          }\n          return;\n        }\n\n        if (!isStepCall(node)) return;\n        if (insideStoryCallback(node, context)) return;\n\n        const containingFunctionName = getContainingFunctionName(node);\n        pendingStepCalls.push({ node, containingFunctionName });\n      },\n      'Program:exit'() {\n        for (const { node, containingFunctionName } of pendingStepCalls) {\n          if (\n            containingFunctionName &&\n            storyCallbackNames.has(containingFunctionName)\n          ) {\n            continue;\n          }\n          context.report({ node, messageId: 'requireStory' });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\nimport type {\n  ArrowFunctionExpression,\n  CallExpression,\n  FunctionDeclaration,\n  FunctionExpression,\n  Node,\n  Property,\n  VariableDeclarator,\n} from 'estree';\n\nconst TEST_MODIFIERS = new Set([\n  'only',\n  'skip',\n  'todo',\n  'concurrent',\n  'failing',\n]);\n\nfunction isFunction(node: Node): boolean {\n  return (\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isFunctionNode(\n  node: Node,\n): node is FunctionDeclaration | ArrowFunctionExpression | FunctionExpression {\n  return (\n    node.type === 'FunctionDeclaration' ||\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\n/** Legacy doc.story() is not used; current API uses story.init() inside it/test. */\nconst V1_PACKAGE = 'executable-stories-jest';\n\nfunction isDocStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  return (\n    callee.object.type === 'Identifier' &&\n    callee.object.name === 'doc' &&\n    callee.property.type === 'Identifier' &&\n    callee.property.name === 'story'\n  );\n}\n\nfunction isTestCallExpression(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') {\n    return callee.name === 'test' || callee.name === 'it';\n  }\n  if (callee.type === 'MemberExpression') {\n    if (callee.object.type !== 'Identifier') return false;\n    if (callee.object.name !== 'test' && callee.object.name !== 'it')\n      return false;\n    if (callee.property.type !== 'Identifier') return false;\n    return TEST_MODIFIERS.has(callee.property.name);\n  }\n  if (callee.type === 'CallExpression') {\n    const inner = callee.callee;\n    if (inner.type !== 'MemberExpression') return false;\n    if (inner.object.type !== 'Identifier') return false;\n    if (inner.object.name !== 'test' && inner.object.name !== 'it')\n      return false;\n    return (\n      inner.property.type === 'Identifier' && inner.property.name === 'each'\n    );\n  }\n  return false;\n}\n\nfunction insideTestCallback(\n  node: CallExpression,\n  context: Rule.RuleContext,\n): boolean {\n  const ancestors = context.sourceCode.getAncestors(node);\n  const functionAncestors = new Set(ancestors.filter(isFunction));\n\n  for (const ancestor of ancestors) {\n    if (ancestor.type !== 'CallExpression') continue;\n    if (!isTestCallExpression(ancestor)) continue;\n    for (const arg of ancestor.arguments) {\n      if (arg && typeof arg === 'object' && functionAncestors.has(arg)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require doc.story(title) to be called inside a test/it callback in Jest.',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireTest:\n        \"doc.story(title) must be called inside a test/it callback (e.g. it('...', () => { doc.story('Title'); ... })).\",\n      requireTitle: 'doc.story(title) requires a title argument.',\n    },\n  },\n  create(context) {\n    let hasV1Import = false;\n    const namedFunctions = new Map<string, Node>();\n    const testCallbackNames = new Set<string>();\n    const pendingDocStoryCalls: Array<{\n      node: CallExpression;\n      containingFunctionName: string | null;\n    }> = [];\n\n    function getContainingFunctionName(node: CallExpression): string | null {\n      const ancestors = context.sourceCode.getAncestors(node);\n      for (let i = ancestors.length - 1; i >= 0; i--) {\n        const ancestor = ancestors[i];\n        if (ancestor.type === 'FunctionDeclaration' && ancestor.id) {\n          return ancestor.id.name;\n        }\n        if (ancestor.type === 'VariableDeclarator') {\n          const declarator = ancestor as VariableDeclarator;\n          if (\n            declarator.id.type === 'Identifier' &&\n            declarator.init &&\n            isFunctionNode(declarator.init)\n          ) {\n            return declarator.id.name;\n          }\n        }\n        // Check for object method definitions\n        if (ancestor.type === 'Property') {\n          const prop = ancestor as Property;\n          if (\n            prop.key.type === 'Identifier' &&\n            prop.value &&\n            isFunctionNode(prop.value)\n          ) {\n            return prop.key.name;\n          }\n          // Shorthand method syntax: { run() {} }\n          if (prop.key.type === 'Identifier' && prop.method) {\n            return prop.key.name;\n          }\n        }\n      }\n      return null;\n    }\n\n    return {\n      ImportDeclaration(node) {\n        if (node.source.value === V1_PACKAGE) {\n          hasV1Import = true;\n        }\n      },\n      FunctionDeclaration(node: FunctionDeclaration) {\n        if (node.id) {\n          namedFunctions.set(node.id.name, node);\n        }\n      },\n      VariableDeclarator(node: VariableDeclarator) {\n        if (\n          node.id.type === 'Identifier' &&\n          node.init &&\n          isFunctionNode(node.init)\n        ) {\n          namedFunctions.set(node.id.name, node.init);\n        }\n      },\n      CallExpression(node: CallExpression) {\n        if (!hasV1Import) return;\n\n        if (isTestCallExpression(node)) {\n          for (const arg of node.arguments) {\n            if (arg.type === 'Identifier') {\n              testCallbackNames.add(arg.name);\n            }\n            // Handle member expression callbacks like handlers.run\n            if (\n              arg.type === 'MemberExpression' &&\n              arg.property.type === 'Identifier'\n            ) {\n              testCallbackNames.add(arg.property.name);\n            }\n          }\n          return;\n        }\n\n        if (!isDocStoryCall(node)) return;\n\n        if (node.arguments.length === 0) {\n          context.report({ node, messageId: 'requireTitle' });\n          return;\n        }\n        if (node.arguments.length >= 2) return;\n\n        if (insideTestCallback(node, context)) return;\n\n        const containingFunctionName = getContainingFunctionName(node);\n        pendingDocStoryCalls.push({ node, containingFunctionName });\n      },\n      'Program:exit'() {\n        for (const { node, containingFunctionName } of pendingDocStoryCalls) {\n          if (\n            containingFunctionName &&\n            testCallbackNames.has(containingFunctionName)\n          ) {\n            continue;\n          }\n          context.report({ node, messageId: 'requireTest' });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { ESLint, Linter } from 'eslint';\nimport requireStoryContextForSteps from './rules/require-story-context-for-steps.js';\nimport requireTestContextForDocStory from './rules/require-test-context-for-doc-story.js';\n\nconst rules = {\n  'require-story-context-for-steps': requireStoryContextForSteps,\n  'require-test-context-for-doc-story': requireTestContextForDocStory,\n};\n\nconst configs: Record<string, Linter.Config[]> = {\n  recommended: [\n    {\n      plugins: {\n        'executable-stories-jest': { rules },\n      },\n      rules: {\n        'executable-stories-jest/require-story-context-for-steps': 'error',\n        'executable-stories-jest/require-test-context-for-doc-story': 'error',\n      },\n    },\n  ],\n};\n\nconst plugin: ESLint.Plugin = {\n  meta: {\n    name: 'eslint-plugin-executable-stories-jest',\n    version: '0.1.0',\n  },\n  rules,\n  configs,\n};\n\nexport default plugin;\nexport { rules, configs };\n"],"mappings":"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","names":["isFunction","isFunctionNode","V1_PACKAGE","isDocStoryCall","rule"]}
+{"version":3,"sources":["../src/rules/require-init-before-steps.ts","../src/rules/require-story-context-for-steps.ts","../src/rules/require-test-context-for-doc-story.ts","../src/index.ts"],"sourcesContent":["import type { Rule } from 'eslint';\nimport type { CallExpression, MemberExpression, Node } from 'estree';\n\n/**\n * Rule: require-init-before-steps\n *\n * Ensures story.init() is called before any step markers (story.given/when/then/etc).\n * This is a best-effort static check - it flags step markers that appear before any story.init()\n * call in the same function scope.\n *\n * BAD:\n *   story.given('something'); // No story.init() before this\n *\n * GOOD:\n *   story.init();\n *   story.given('something');\n */\n\nconst STEP_NAMES = new Set([\n  'given',\n  'when',\n  'then',\n  'and',\n  'but',\n  'arrange',\n  'act',\n  'assert',\n  'setup',\n  'context',\n  'execute',\n  'action',\n  'verify',\n  'fn',\n  'expect',\n]);\n\nfunction isFunction(node: Node): boolean {\n  return (\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression' ||\n    node.type === 'FunctionDeclaration'\n  );\n}\n\nfunction isStoryInitCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  const member = callee as MemberExpression;\n  const { object, property } = member;\n  return (\n    object.type === 'Identifier' &&\n    object.name === 'story' &&\n    property.type === 'Identifier' &&\n    property.name === 'init'\n  );\n}\n\nfunction isStoryStepCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  const member = callee as MemberExpression;\n  const { object, property } = member;\n  return (\n    object.type === 'Identifier' &&\n    object.name === 'story' &&\n    property.type === 'Identifier' &&\n    STEP_NAMES.has(property.name)\n  );\n}\n\nfunction getContainingFunction(\n  node: Node,\n  context: Rule.RuleContext,\n): Node | null {\n  const ancestors = context.sourceCode.getAncestors(node);\n  for (let i = ancestors.length - 1; i >= 0; i--) {\n    if (isFunction(ancestors[i])) {\n      return ancestors[i];\n    }\n  }\n  return null;\n}\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require story.init() to be called before any step markers (story.given/when/then/etc) in Jest.',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireInit:\n        'story.init() must be called before using step markers like story.given(), story.when(), story.then().',\n    },\n  },\n  create(context) {\n    let hasRelevantImport = false;\n    // Track functions that have story.init() calls\n    const functionsWithInit = new WeakSet<Node>();\n    // Track step calls and their containing functions for later verification\n    const pendingStepCalls: Array<{\n      node: CallExpression;\n      containingFunction: Node | null;\n    }> = [];\n\n    return {\n      ImportDeclaration(node) {\n        if (node.source.value === 'executable-stories-jest') {\n          hasRelevantImport = true;\n        }\n      },\n      CallExpression(node: CallExpression) {\n        if (!hasRelevantImport) return;\n\n        if (isStoryInitCall(node)) {\n          const containingFunction = getContainingFunction(node, context);\n          if (containingFunction) {\n            functionsWithInit.add(containingFunction);\n          }\n          return;\n        }\n\n        if (isStoryStepCall(node)) {\n          const containingFunction = getContainingFunction(node, context);\n          pendingStepCalls.push({ node, containingFunction });\n        }\n      },\n      'Program:exit'() {\n        for (const { node, containingFunction } of pendingStepCalls) {\n          // If no containing function, or the function doesn't have story.init(), report\n          if (\n            !containingFunction ||\n            !functionsWithInit.has(containingFunction)\n          ) {\n            context.report({ node, messageId: 'requireInit' });\n          }\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\nimport type {\n  ArrowFunctionExpression,\n  CallExpression,\n  FunctionDeclaration,\n  FunctionExpression,\n  Node,\n  Property,\n  VariableDeclarator,\n} from 'estree';\n\n/** Current API uses story.given() etc. inside test(); no top-level given/when/then. */\nconst V1_PACKAGE = 'executable-stories-jest';\n\nconst STEP_NAMES = new Set([\n  'given',\n  'when',\n  'then',\n  'and',\n  'but',\n  'arrange',\n  'act',\n  'assert',\n  'setup',\n  'context',\n  'execute',\n  'action',\n  'verify',\n]);\n\nconst STORY_MODIFIERS = new Set(['skip', 'only']);\n\nfunction isFunction(node: Node): boolean {\n  return (\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isFunctionNode(\n  node: Node,\n): node is FunctionDeclaration | ArrowFunctionExpression | FunctionExpression {\n  return (\n    node.type === 'FunctionDeclaration' ||\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') return callee.name === 'story';\n  if (callee.type !== 'MemberExpression') return false;\n  if (callee.object.type !== 'Identifier' || callee.object.name !== 'story')\n    return false;\n  return (\n    callee.property.type === 'Identifier' &&\n    STORY_MODIFIERS.has(callee.property.name)\n  );\n}\n\nfunction isStoryInitCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  return (\n    callee.object.type === 'Identifier' &&\n    callee.object.name === 'story' &&\n    callee.property.type === 'Identifier' &&\n    callee.property.name === 'init'\n  );\n}\n\nfunction isDocStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  return (\n    callee.object.type === 'Identifier' &&\n    callee.object.name === 'doc' &&\n    callee.property.type === 'Identifier' &&\n    callee.property.name === 'story'\n  );\n}\n\nfunction isStepCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') return STEP_NAMES.has(callee.name);\n  if (callee.type !== 'MemberExpression') return false;\n  if (callee.object.type !== 'Identifier') return false;\n  if (callee.object.name !== 'steps' && callee.object.name !== 'step')\n    return false;\n  return (\n    callee.property.type === 'Identifier' &&\n    STEP_NAMES.has(callee.property.name)\n  );\n}\n\nfunction insideStoryCallback(\n  node: CallExpression,\n  context: Rule.RuleContext,\n): boolean {\n  const ancestors = context.sourceCode.getAncestors(node);\n  const functionAncestors = new Set(ancestors.filter(isFunction));\n\n  for (const ancestor of ancestors) {\n    if (ancestor.type !== 'CallExpression') continue;\n    if (!isStoryCall(ancestor) && !isDocStoryCall(ancestor)) continue;\n    for (const arg of ancestor.arguments) {\n      if (arg && typeof arg === 'object' && functionAncestors.has(arg)) {\n        return true;\n      }\n    }\n  }\n\n  return false;\n}\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require step functions (given/when/then/and/but and aliases) to be called inside story() or doc.story(..., callback).',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireStory:\n        'Step functions must be called inside story(...) (or doc.story(..., callback)).',\n    },\n  },\n  create(context) {\n    let hasV1Import = false;\n    const namedFunctions = new Map<string, Node>();\n    const storyCallbackNames = new Set<string>();\n    // Track functions that contain story.init() calls\n    const functionsWithInit = new WeakSet<Node>();\n    const pendingStepCalls: Array<{\n      node: CallExpression;\n      containingFunction: Node | null;\n      containingFunctionName: string | null;\n    }> = [];\n\n    function getContainingFunction(node: CallExpression): Node | null {\n      const ancestors = context.sourceCode.getAncestors(node);\n      for (let i = ancestors.length - 1; i >= 0; i--) {\n        if (isFunctionNode(ancestors[i]) || isFunction(ancestors[i])) {\n          return ancestors[i];\n        }\n      }\n      return null;\n    }\n\n    function getContainingFunctionName(node: CallExpression): string | null {\n      const ancestors = context.sourceCode.getAncestors(node);\n      for (let i = ancestors.length - 1; i >= 0; i--) {\n        const ancestor = ancestors[i];\n        if (ancestor.type === 'FunctionDeclaration' && ancestor.id) {\n          return ancestor.id.name;\n        }\n        if (ancestor.type === 'VariableDeclarator') {\n          const declarator = ancestor as VariableDeclarator;\n          if (\n            declarator.id.type === 'Identifier' &&\n            declarator.init &&\n            isFunctionNode(declarator.init)\n          ) {\n            return declarator.id.name;\n          }\n        }\n        // Check for object method definitions\n        if (ancestor.type === 'Property') {\n          const prop = ancestor as Property;\n          if (\n            prop.key.type === 'Identifier' &&\n            prop.value &&\n            isFunctionNode(prop.value)\n          ) {\n            return prop.key.name;\n          }\n          // Shorthand method syntax: { define() {} }\n          if (prop.key.type === 'Identifier' && prop.method) {\n            return prop.key.name;\n          }\n        }\n      }\n      return null;\n    }\n\n    return {\n      ImportDeclaration(node) {\n        const pkg = node.source.value;\n        if (typeof pkg === 'string' && pkg === V1_PACKAGE) {\n          hasV1Import = true;\n        }\n      },\n      FunctionDeclaration(node: FunctionDeclaration) {\n        if (node.id) {\n          namedFunctions.set(node.id.name, node);\n        }\n      },\n      VariableDeclarator(node: VariableDeclarator) {\n        if (\n          node.id.type === 'Identifier' &&\n          node.init &&\n          isFunctionNode(node.init)\n        ) {\n          namedFunctions.set(node.id.name, node.init);\n        }\n      },\n      CallExpression(node: CallExpression) {\n        if (!hasV1Import) return;\n\n        // Track story.init() calls and their containing functions\n        if (isStoryInitCall(node)) {\n          const containingFunction = getContainingFunction(node);\n          if (containingFunction) {\n            functionsWithInit.add(containingFunction);\n          }\n          return;\n        }\n\n        if (isStoryCall(node) || isDocStoryCall(node)) {\n          for (const arg of node.arguments) {\n            if (arg.type === 'Identifier') {\n              storyCallbackNames.add(arg.name);\n            }\n            // Handle member expression callbacks like handlers.define\n            if (\n              arg.type === 'MemberExpression' &&\n              arg.property.type === 'Identifier'\n            ) {\n              storyCallbackNames.add(arg.property.name);\n            }\n          }\n          return;\n        }\n\n        if (!isStepCall(node)) return;\n        if (insideStoryCallback(node, context)) return;\n\n        const containingFunction = getContainingFunction(node);\n        const containingFunctionName = getContainingFunctionName(node);\n        pendingStepCalls.push({ node, containingFunction, containingFunctionName });\n      },\n      'Program:exit'() {\n        for (const { node, containingFunction, containingFunctionName } of pendingStepCalls) {\n          // Allow if inside a named function passed to story()/doc.story()\n          if (\n            containingFunctionName &&\n            storyCallbackNames.has(containingFunctionName)\n          ) {\n            continue;\n          }\n          // Allow if inside a function that has story.init()\n          if (containingFunction && functionsWithInit.has(containingFunction)) {\n            continue;\n          }\n          context.report({ node, messageId: 'requireStory' });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\nimport type {\n  ArrowFunctionExpression,\n  CallExpression,\n  FunctionDeclaration,\n  FunctionExpression,\n  Node,\n  Property,\n  VariableDeclarator,\n} from 'estree';\n\nconst TEST_MODIFIERS = new Set([\n  'only',\n  'skip',\n  'todo',\n  'concurrent',\n  'failing',\n]);\n\nfunction isFunction(node: Node): boolean {\n  return (\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\nfunction isFunctionNode(\n  node: Node,\n): node is FunctionDeclaration | ArrowFunctionExpression | FunctionExpression {\n  return (\n    node.type === 'FunctionDeclaration' ||\n    node.type === 'FunctionExpression' ||\n    node.type === 'ArrowFunctionExpression'\n  );\n}\n\n/** Legacy doc.story() is not used; current API uses story.init() inside it/test. */\nconst V1_PACKAGE = 'executable-stories-jest';\n\nfunction isDocStoryCall(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type !== 'MemberExpression') return false;\n  return (\n    callee.object.type === 'Identifier' &&\n    callee.object.name === 'doc' &&\n    callee.property.type === 'Identifier' &&\n    callee.property.name === 'story'\n  );\n}\n\nfunction isTestCallExpression(node: CallExpression): boolean {\n  const { callee } = node;\n  if (callee.type === 'Identifier') {\n    return callee.name === 'test' || callee.name === 'it';\n  }\n  if (callee.type === 'MemberExpression') {\n    if (callee.object.type !== 'Identifier') return false;\n    if (callee.object.name !== 'test' && callee.object.name !== 'it')\n      return false;\n    if (callee.property.type !== 'Identifier') return false;\n    return TEST_MODIFIERS.has(callee.property.name);\n  }\n  if (callee.type === 'CallExpression') {\n    const inner = callee.callee;\n    if (inner.type !== 'MemberExpression') return false;\n    if (inner.object.type !== 'Identifier') return false;\n    if (inner.object.name !== 'test' && inner.object.name !== 'it')\n      return false;\n    return (\n      inner.property.type === 'Identifier' && inner.property.name === 'each'\n    );\n  }\n  return false;\n}\n\nfunction insideTestCallback(\n  node: CallExpression,\n  context: Rule.RuleContext,\n): boolean {\n  const ancestors = context.sourceCode.getAncestors(node);\n  const functionAncestors = new Set(ancestors.filter(isFunction));\n\n  for (const ancestor of ancestors) {\n    if (ancestor.type !== 'CallExpression') continue;\n    if (!isTestCallExpression(ancestor)) continue;\n    for (const arg of ancestor.arguments) {\n      if (arg && typeof arg === 'object' && functionAncestors.has(arg)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require doc.story(title) to be called inside a test/it callback in Jest.',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireTest:\n        \"doc.story(title) must be called inside a test/it callback (e.g. it('...', () => { doc.story('Title'); ... })).\",\n      requireTitle: 'doc.story(title) requires a title argument.',\n    },\n  },\n  create(context) {\n    let hasV1Import = false;\n    const namedFunctions = new Map<string, Node>();\n    const testCallbackNames = new Set<string>();\n    const pendingDocStoryCalls: Array<{\n      node: CallExpression;\n      containingFunctionName: string | null;\n    }> = [];\n\n    function getContainingFunctionName(node: CallExpression): string | null {\n      const ancestors = context.sourceCode.getAncestors(node);\n      for (let i = ancestors.length - 1; i >= 0; i--) {\n        const ancestor = ancestors[i];\n        if (ancestor.type === 'FunctionDeclaration' && ancestor.id) {\n          return ancestor.id.name;\n        }\n        if (ancestor.type === 'VariableDeclarator') {\n          const declarator = ancestor as VariableDeclarator;\n          if (\n            declarator.id.type === 'Identifier' &&\n            declarator.init &&\n            isFunctionNode(declarator.init)\n          ) {\n            return declarator.id.name;\n          }\n        }\n        // Check for object method definitions\n        if (ancestor.type === 'Property') {\n          const prop = ancestor as Property;\n          if (\n            prop.key.type === 'Identifier' &&\n            prop.value &&\n            isFunctionNode(prop.value)\n          ) {\n            return prop.key.name;\n          }\n          // Shorthand method syntax: { run() {} }\n          if (prop.key.type === 'Identifier' && prop.method) {\n            return prop.key.name;\n          }\n        }\n      }\n      return null;\n    }\n\n    return {\n      ImportDeclaration(node) {\n        if (node.source.value === V1_PACKAGE) {\n          hasV1Import = true;\n        }\n      },\n      FunctionDeclaration(node: FunctionDeclaration) {\n        if (node.id) {\n          namedFunctions.set(node.id.name, node);\n        }\n      },\n      VariableDeclarator(node: VariableDeclarator) {\n        if (\n          node.id.type === 'Identifier' &&\n          node.init &&\n          isFunctionNode(node.init)\n        ) {\n          namedFunctions.set(node.id.name, node.init);\n        }\n      },\n      CallExpression(node: CallExpression) {\n        if (!hasV1Import) return;\n\n        if (isTestCallExpression(node)) {\n          for (const arg of node.arguments) {\n            if (arg.type === 'Identifier') {\n              testCallbackNames.add(arg.name);\n            }\n            // Handle member expression callbacks like handlers.run\n            if (\n              arg.type === 'MemberExpression' &&\n              arg.property.type === 'Identifier'\n            ) {\n              testCallbackNames.add(arg.property.name);\n            }\n          }\n          return;\n        }\n\n        if (!isDocStoryCall(node)) return;\n\n        if (node.arguments.length === 0) {\n          context.report({ node, messageId: 'requireTitle' });\n          return;\n        }\n        if (node.arguments.length >= 2) return;\n\n        if (insideTestCallback(node, context)) return;\n\n        const containingFunctionName = getContainingFunctionName(node);\n        pendingDocStoryCalls.push({ node, containingFunctionName });\n      },\n      'Program:exit'() {\n        for (const { node, containingFunctionName } of pendingDocStoryCalls) {\n          if (\n            containingFunctionName &&\n            testCallbackNames.has(containingFunctionName)\n          ) {\n            continue;\n          }\n          context.report({ node, messageId: 'requireTest' });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { ESLint, Linter } from 'eslint';\nimport requireInitBeforeSteps from './rules/require-init-before-steps.js';\nimport requireStoryContextForSteps from './rules/require-story-context-for-steps.js';\nimport requireTestContextForDocStory from './rules/require-test-context-for-doc-story.js';\n\nconst rules = {\n  'require-init-before-steps': requireInitBeforeSteps,\n  'require-story-context-for-steps': requireStoryContextForSteps,\n  'require-test-context-for-doc-story': requireTestContextForDocStory,\n};\n\nconst configs: Record<string, Linter.Config[]> = {\n  recommended: [\n    {\n      plugins: {\n        'executable-stories-jest': { rules },\n      },\n      rules: {\n        'executable-stories-jest/require-init-before-steps': 'error',\n        'executable-stories-jest/require-story-context-for-steps': 'error',\n        'executable-stories-jest/require-test-context-for-doc-story': 'error',\n      },\n    },\n  ],\n};\n\nconst plugin: ESLint.Plugin = {\n  meta: {\n    name: 'eslint-plugin-executable-stories-jest',\n    version: '0.1.0',\n  },\n  rules,\n  configs,\n};\n\nexport default plugin;\nexport { rules, configs };\n"],"mappings":"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","names":["STEP_NAMES","isFunction","isStoryInitCall","rule","getContainingFunction","containingFunction","isFunction","isFunctionNode","V1_PACKAGE","isDocStoryCall","rule"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-executable-stories-jest",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "type": "module",
   "description": "ESLint rules for executable-stories-jest: step context, doc.story in test/it",
   "main": "./dist/index.cjs",
@@ -40,13 +40,13 @@
   "devDependencies": {
     "@types/eslint": "^9.6.1",
     "@types/estree": "^1.0.8",
-    "@types/node": "^25.3.2",
+    "@types/node": "^25.5.0",
     "eslint": "^10.0.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
+    "vitest": "^4.1.0",
     "eslint-config-executable-stories": "0.2.0",
-    "executable-stories-vitest": "7.0.2"
+    "executable-stories-vitest": "8.1.3"
   },
   "engines": {
     "node": ">=22"

package/skills/eslint-jest-rules/SKILL.md

@@ -1,10 +1,11 @@
 ---
 name: eslint-jest-rules
 description: >
-  ESLint flat config plugin for executable-stories-jest. Two rules:
-  require-story-context-for-steps (steps must be inside story callback),
+  ESLint flat config plugin for executable-stories-jest. Three rules:
+  require-init-before-steps (init before given/when/then),
+  require-story-context-for-steps (steps must be inside story callback or story.init scope),
   require-test-context-for-doc-story (doc.story must be inside test/it).
-  Recommended config enables both at error level.
+  Recommended config enables all at error level.
 type: core
 library: eslint-plugin-executable-stories-jest
 library_version: "0.1.0"
@@ -21,7 +22,7 @@ sources:
 import jestStories from "eslint-plugin-executable-stories-jest";
 
 export default [
-  // Option A: Use recommended config
+  // Option A: Use recommended config (enables all rules at error)
   ...jestStories.configs.recommended,
 
   // Option B: Manual configuration
@@ -30,6 +31,7 @@ export default [
       "executable-stories-jest": jestStories,
     },
     rules: {
+      "executable-stories-jest/require-init-before-steps": "error",
       "executable-stories-jest/require-story-context-for-steps": "error",
       "executable-stories-jest/require-test-context-for-doc-story": "error",
     },
@@ -39,20 +41,47 @@ export default [
 
 ## Core Patterns
 
-### Rule: require-story-context-for-steps
+### Rule: require-init-before-steps
 
-Ensures step functions (`given`, `when`, `then`, `and`, `but` and aliases) are called inside a `story()` or `doc.story(..., callback)`.
+Ensures `story.init()` is called before any step markers.
 
 ```typescript
 // Fails lint
 it("my test", () => {
-  given("something"); // Error: must be inside story() or doc.story()
+  story.given("something", () => {}); // Error: story.init() must be called first
+  story.init();
 });
 
 // Passes lint
 it("my test", () => {
   story.init();
-  story.given("something");
+  story.given("something", () => {});
+});
+```
+
+Detects all step methods: `given`, `when`, `then`, `and`, `but`, `arrange`, `act`, `assert`, `setup`, `context`, `execute`, `action`, `verify`, `fn`, `expect`.
+
+### Rule: require-story-context-for-steps
+
+Ensures bare step functions (`given`, `when`, `then`, `and`, `but` and aliases) are called inside a `story()` callback, `doc.story(..., callback)`, or a function that has `story.init()`.
+
+```typescript
+// Fails lint
+it("my test", () => {
+  given("something", () => {}); // Error: must be inside story() or story.init() scope
+});
+
+// Passes lint — inside story() callback
+story("Login", () => {
+  given("a user", () => {});
+  when("they sign in", () => {});
+  then("they see the dashboard", () => {});
+});
+
+// Passes lint — story.init() in same scope
+it("my test", () => {
+  story.init();
+  given("a user", () => {});
 });
 ```
 
@@ -109,3 +138,29 @@ export default [...jestStories.configs.recommended];
 This plugin only supports ESLint 9 flat config.
 
 Source: packages/eslint-plugin-executable-stories-jest/src/index.ts
+
+### MEDIUM Not scoping rules to story test files
+
+```typescript
+// eslint.config.mjs
+import jestStories from "eslint-plugin-executable-stories-jest";
+
+export default [
+  {
+    // Scope to story test files only
+    files: ["**/*.story.test.ts", "**/*.story.spec.ts"],
+    plugins: {
+      "executable-stories-jest": jestStories,
+    },
+    rules: {
+      "executable-stories-jest/require-init-before-steps": "error",
+      "executable-stories-jest/require-story-context-for-steps": "error",
+      "executable-stories-jest/require-test-context-for-doc-story": "error",
+    },
+  },
+];
+```
+
+Scoping avoids false positives on non-story test files that don't use the story API.
+
+Source: packages/eslint-plugin-executable-stories-jest/src/index.ts