eslint-plugin-executable-stories-playwright 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+# eslint-plugin-executable-stories-playwright
+
+ESLint rules for [executable-stories-playwright](https://github.com/jagreehal/executable-stories). Use with Playwright to catch common mistakes when writing story tests.
+
+## Install
+
+```bash
+pnpm add -D eslint-plugin-executable-stories-playwright
+```
+
+Requires ESLint 9+ (flat config).
+
+## Usage (flat config)
+
+```js
+import playwrightExecutableStories from 'eslint-plugin-executable-stories-playwright';
+
+export default [
+  {
+    plugins: {
+      'executable-stories-playwright': playwrightExecutableStories,
+    },
+    rules: {
+      ...playwrightExecutableStories.configs.recommended[0].rules,
+    },
+  },
+];
+```
+
+Or spread the recommended config:
+
+```js
+import playwrightExecutableStories from 'eslint-plugin-executable-stories-playwright';
+
+export default [...playwrightExecutableStories.configs.recommended];
+```
+
+## Rules
+
+| Rule                                 | Description                                                                                                 | Config      |
+| ------------------------------------ | ----------------------------------------------------------------------------------------------------------- | ----------- |
+| `require-story-context-for-steps`    | Ensure `given/when/then/and/but` (and aliases) are called inside `story(...)` or `doc.story(..., callback)` | recommended |
+| `require-test-context-for-doc-story` | Ensure `doc.story(title)` is called inside a `test()` or `it()` callback (framework-native tests)           | recommended |
+
+These rules apply only when the file uses legacy patterns (e.g. top-level steps or `doc.story()`). If you use test() + `story.init(testInfo)` + `story.given`/`story.when`/`story.then`, the rules do not run; the current API has no top-level steps and no `doc.story()`, so no changes are required.
+
+## Configs
+
+| Config        | Description             |
+| ------------- | ----------------------- |
+| `recommended` | Enables the rules above |
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,345 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  configs: () => configs,
+  default: () => src_default,
+  rules: () => rules
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/rules/require-story-context-for-steps.ts
+var V1_PACKAGE = "executable-stories-playwright";
+var STEP_NAMES = /* @__PURE__ */ new Set([
+  "given",
+  "when",
+  "then",
+  "and",
+  "but",
+  "arrange",
+  "act",
+  "assert",
+  "setup",
+  "context",
+  "execute",
+  "action",
+  "verify"
+]);
+var STORY_MODIFIERS = /* @__PURE__ */ new Set(["skip", "only"]);
+function isFunction(node) {
+  return node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
+}
+function isFunctionNode(node) {
+  return node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
+}
+function isStoryCall(node) {
+  const { callee } = node;
+  if (callee.type === "Identifier") return callee.name === "story";
+  if (callee.type !== "MemberExpression") return false;
+  if (callee.object.type !== "Identifier" || callee.object.name !== "story")
+    return false;
+  return callee.property.type === "Identifier" && STORY_MODIFIERS.has(callee.property.name);
+}
+function isDocStoryCall(node) {
+  const { callee } = node;
+  if (callee.type !== "MemberExpression") return false;
+  return callee.object.type === "Identifier" && callee.object.name === "doc" && callee.property.type === "Identifier" && callee.property.name === "story";
+}
+function isStepCall(node) {
+  const { callee } = node;
+  if (callee.type === "Identifier") return STEP_NAMES.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);
+}
+function insideStoryCallback(node, context) {
+  const ancestors = context.getSourceCode().getAncestors(node);
+  const functionAncestors = new Set(ancestors.filter(isFunction));
+  for (const ancestor of ancestors) {
+    if (ancestor.type !== "CallExpression") continue;
+    if (!isStoryCall(ancestor) && !isDocStoryCall(ancestor)) continue;
+    for (const arg of ancestor.arguments) {
+      if (arg && typeof arg === "object" && functionAncestors.has(arg)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+var rule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require step functions (given/when/then/and/but and aliases) to be called inside story() or doc.story(..., callback).",
+      recommended: true
+    },
+    schema: [],
+    messages: {
+      requireStory: "Step functions must be called inside story(...) (or doc.story(..., callback))."
+    }
+  },
+  create(context) {
+    let hasV1Import = false;
+    const namedFunctions = /* @__PURE__ */ new Map();
+    const storyCallbackNames = /* @__PURE__ */ new Set();
+    const pendingStepCalls = [];
+    function getContainingFunctionName(node) {
+      const ancestors = context.getSourceCode().getAncestors(node);
+      for (let i = ancestors.length - 1; i >= 0; i--) {
+        const ancestor = ancestors[i];
+        if (ancestor.type === "FunctionDeclaration" && ancestor.id) {
+          return ancestor.id.name;
+        }
+        if (ancestor.type === "VariableDeclarator") {
+          const declarator = ancestor;
+          if (declarator.id.type === "Identifier" && declarator.init && isFunctionNode(declarator.init)) {
+            return declarator.id.name;
+          }
+        }
+        if (ancestor.type === "Property") {
+          const prop = ancestor;
+          if (prop.key.type === "Identifier" && prop.value && isFunctionNode(prop.value)) {
+            return prop.key.name;
+          }
+          if (prop.key.type === "Identifier" && prop.method) {
+            return prop.key.name;
+          }
+        }
+      }
+      return null;
+    }
+    return {
+      ImportDeclaration(node) {
+        if (node.source.value === V1_PACKAGE) {
+          hasV1Import = true;
+        }
+      },
+      FunctionDeclaration(node) {
+        if (node.id) {
+          namedFunctions.set(node.id.name, node);
+        }
+      },
+      VariableDeclarator(node) {
+        if (node.id.type === "Identifier" && node.init && isFunctionNode(node.init)) {
+          namedFunctions.set(node.id.name, node.init);
+        }
+      },
+      CallExpression(node) {
+        if (!hasV1Import) return;
+        if (isStoryCall(node) || isDocStoryCall(node)) {
+          for (const arg of node.arguments) {
+            if (arg.type === "Identifier") {
+              storyCallbackNames.add(arg.name);
+            }
+            if (arg.type === "MemberExpression" && arg.property.type === "Identifier") {
+              storyCallbackNames.add(arg.property.name);
+            }
+          }
+          return;
+        }
+        if (!isStepCall(node)) return;
+        if (insideStoryCallback(node, context)) return;
+        const containingFunctionName = getContainingFunctionName(node);
+        pendingStepCalls.push({ node, containingFunctionName });
+      },
+      "Program:exit"() {
+        for (const { node, containingFunctionName } of pendingStepCalls) {
+          if (containingFunctionName && storyCallbackNames.has(containingFunctionName)) {
+            continue;
+          }
+          context.report({ node, messageId: "requireStory" });
+        }
+      }
+    };
+  }
+};
+var require_story_context_for_steps_default = rule;
+
+// src/rules/require-test-context-for-doc-story.ts
+var V1_PACKAGE2 = "executable-stories-playwright";
+var TEST_MODIFIERS = /* @__PURE__ */ new Set(["only", "skip", "fixme", "fail", "slow"]);
+function isFunction2(node) {
+  return node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
+}
+function isFunctionNode2(node) {
+  return node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
+}
+function isDocStoryCall2(node) {
+  const { callee } = node;
+  if (callee.type !== "MemberExpression") return false;
+  return callee.object.type === "Identifier" && callee.object.name === "doc" && callee.property.type === "Identifier" && callee.property.name === "story";
+}
+function isTestCallExpression(node) {
+  const { callee } = node;
+  if (callee.type === "Identifier") {
+    return callee.name === "test" || callee.name === "it";
+  }
+  if (callee.type !== "MemberExpression") return false;
+  if (callee.object.type !== "Identifier") return false;
+  if (callee.object.name !== "test" && callee.object.name !== "it")
+    return false;
+  if (callee.property.type !== "Identifier") return false;
+  return TEST_MODIFIERS.has(callee.property.name);
+}
+function insideTestCallback(node, context) {
+  const ancestors = context.getSourceCode().getAncestors(node);
+  const functionAncestors = new Set(ancestors.filter(isFunction2));
+  for (const ancestor of ancestors) {
+    if (ancestor.type !== "CallExpression") continue;
+    if (!isTestCallExpression(ancestor)) continue;
+    for (const arg of ancestor.arguments) {
+      if (arg && typeof arg === "object" && functionAncestors.has(arg)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+var rule2 = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require doc.story(title) to be called inside a test() or it() callback (framework-native pattern).",
+      recommended: true
+    },
+    schema: [],
+    messages: {
+      requireTest: "doc.story(title) must be called inside a test() callback (e.g. test('...', () => { doc.story('Title'); ... })).",
+      requireTitle: "doc.story(title) requires a title argument."
+    }
+  },
+  create(context) {
+    let hasV1Import = false;
+    const namedFunctions = /* @__PURE__ */ new Map();
+    const testCallbackNames = /* @__PURE__ */ new Set();
+    const pendingDocStoryCalls = [];
+    function getContainingFunctionName(node) {
+      const ancestors = context.getSourceCode().getAncestors(node);
+      for (let i = ancestors.length - 1; i >= 0; i--) {
+        const ancestor = ancestors[i];
+        if (ancestor.type === "FunctionDeclaration" && ancestor.id) {
+          return ancestor.id.name;
+        }
+        if (ancestor.type === "VariableDeclarator") {
+          const declarator = ancestor;
+          if (declarator.id.type === "Identifier" && declarator.init && isFunctionNode2(declarator.init)) {
+            return declarator.id.name;
+          }
+        }
+        if (ancestor.type === "Property") {
+          const prop = ancestor;
+          if (prop.key.type === "Identifier" && prop.value && isFunctionNode2(prop.value)) {
+            return prop.key.name;
+          }
+          if (prop.key.type === "Identifier" && prop.method) {
+            return prop.key.name;
+          }
+        }
+      }
+      return null;
+    }
+    return {
+      ImportDeclaration(node) {
+        if (node.source.value === V1_PACKAGE2) {
+          hasV1Import = true;
+        }
+      },
+      FunctionDeclaration(node) {
+        if (node.id) {
+          namedFunctions.set(node.id.name, node);
+        }
+      },
+      VariableDeclarator(node) {
+        if (node.id.type === "Identifier" && node.init && isFunctionNode2(node.init)) {
+          namedFunctions.set(node.id.name, node.init);
+        }
+      },
+      CallExpression(node) {
+        if (!hasV1Import) return;
+        if (isTestCallExpression(node)) {
+          for (const arg of node.arguments) {
+            if (arg.type === "Identifier") {
+              testCallbackNames.add(arg.name);
+            }
+            if (arg.type === "MemberExpression" && arg.property.type === "Identifier") {
+              testCallbackNames.add(arg.property.name);
+            }
+          }
+          return;
+        }
+        if (!isDocStoryCall2(node)) return;
+        if (node.arguments.length === 0) {
+          context.report({ node, messageId: "requireTitle" });
+          return;
+        }
+        if (node.arguments.length >= 2) return;
+        if (insideTestCallback(node, context)) return;
+        const containingFunctionName = getContainingFunctionName(node);
+        pendingDocStoryCalls.push({ node, containingFunctionName });
+      },
+      "Program:exit"() {
+        for (const { node, containingFunctionName } of pendingDocStoryCalls) {
+          if (containingFunctionName && testCallbackNames.has(containingFunctionName)) {
+            continue;
+          }
+          context.report({ node, messageId: "requireTest" });
+        }
+      }
+    };
+  }
+};
+var require_test_context_for_doc_story_default = rule2;
+
+// src/index.ts
+var rules = {
+  "require-story-context-for-steps": require_story_context_for_steps_default,
+  "require-test-context-for-doc-story": require_test_context_for_doc_story_default
+};
+var configs = {
+  recommended: [
+    {
+      plugins: {
+        "executable-stories-playwright": { rules }
+      },
+      rules: {
+        "executable-stories-playwright/require-story-context-for-steps": "error",
+        "executable-stories-playwright/require-test-context-for-doc-story": "error"
+      }
+    }
+  ]
+};
+var plugin = {
+  meta: {
+    name: "eslint-plugin-executable-stories-playwright",
+    version: "0.1.0"
+  },
+  rules,
+  configs
+};
+var src_default = plugin;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  configs,
+  rules
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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-playwright': { rules },\n      },\n      rules: {\n        'executable-stories-playwright/require-story-context-for-steps':\n          'error',\n        'executable-stories-playwright/require-test-context-for-doc-story':\n          'error',\n      },\n    },\n  ],\n};\n\nconst plugin: ESLint.Plugin = {\n  meta: {\n    name: 'eslint-plugin-executable-stories-playwright',\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-playwright';\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.getSourceCode().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.getSourceCode().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        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 (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\n/** Legacy doc.story() is not used; current API uses story.init(testInfo) inside test(). */\nconst V1_PACKAGE = 'executable-stories-playwright';\n\nconst TEST_MODIFIERS = new Set(['only', 'skip', 'fixme', 'fail', 'slow']);\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 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') return false;\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\nfunction insideTestCallback(\n  node: CallExpression,\n  context: Rule.RuleContext,\n): boolean {\n  const ancestors = context.getSourceCode().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() or it() callback (framework-native pattern).',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireTest:\n        \"doc.story(title) must be called inside a test() callback (e.g. test('...', () => { 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.getSourceCode().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":["V1_PACKAGE","isFunction","isFunctionNode","isDocStoryCall","rule"]}

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+import * as eslint from 'eslint';
+import { Linter, ESLint } from 'eslint';
+
+declare const rules: {
+    'require-story-context-for-steps': eslint.Rule.RuleModule;
+    'require-test-context-for-doc-story': eslint.Rule.RuleModule;
+};
+declare const configs: Record<string, Linter.Config[]>;
+declare const plugin: ESLint.Plugin;
+
+export { configs, plugin as default, rules };

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import * as eslint from 'eslint';
+import { Linter, ESLint } from 'eslint';
+
+declare const rules: {
+    'require-story-context-for-steps': eslint.Rule.RuleModule;
+    'require-test-context-for-doc-story': eslint.Rule.RuleModule;
+};
+declare const configs: Record<string, Linter.Config[]>;
+declare const plugin: ESLint.Plugin;
+
+export { configs, plugin as default, rules };

package/dist/index.js

@@ -0,0 +1,317 @@
+// src/rules/require-story-context-for-steps.ts
+var V1_PACKAGE = "executable-stories-playwright";
+var STEP_NAMES = /* @__PURE__ */ new Set([
+  "given",
+  "when",
+  "then",
+  "and",
+  "but",
+  "arrange",
+  "act",
+  "assert",
+  "setup",
+  "context",
+  "execute",
+  "action",
+  "verify"
+]);
+var STORY_MODIFIERS = /* @__PURE__ */ new Set(["skip", "only"]);
+function isFunction(node) {
+  return node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
+}
+function isFunctionNode(node) {
+  return node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
+}
+function isStoryCall(node) {
+  const { callee } = node;
+  if (callee.type === "Identifier") return callee.name === "story";
+  if (callee.type !== "MemberExpression") return false;
+  if (callee.object.type !== "Identifier" || callee.object.name !== "story")
+    return false;
+  return callee.property.type === "Identifier" && STORY_MODIFIERS.has(callee.property.name);
+}
+function isDocStoryCall(node) {
+  const { callee } = node;
+  if (callee.type !== "MemberExpression") return false;
+  return callee.object.type === "Identifier" && callee.object.name === "doc" && callee.property.type === "Identifier" && callee.property.name === "story";
+}
+function isStepCall(node) {
+  const { callee } = node;
+  if (callee.type === "Identifier") return STEP_NAMES.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);
+}
+function insideStoryCallback(node, context) {
+  const ancestors = context.getSourceCode().getAncestors(node);
+  const functionAncestors = new Set(ancestors.filter(isFunction));
+  for (const ancestor of ancestors) {
+    if (ancestor.type !== "CallExpression") continue;
+    if (!isStoryCall(ancestor) && !isDocStoryCall(ancestor)) continue;
+    for (const arg of ancestor.arguments) {
+      if (arg && typeof arg === "object" && functionAncestors.has(arg)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+var rule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require step functions (given/when/then/and/but and aliases) to be called inside story() or doc.story(..., callback).",
+      recommended: true
+    },
+    schema: [],
+    messages: {
+      requireStory: "Step functions must be called inside story(...) (or doc.story(..., callback))."
+    }
+  },
+  create(context) {
+    let hasV1Import = false;
+    const namedFunctions = /* @__PURE__ */ new Map();
+    const storyCallbackNames = /* @__PURE__ */ new Set();
+    const pendingStepCalls = [];
+    function getContainingFunctionName(node) {
+      const ancestors = context.getSourceCode().getAncestors(node);
+      for (let i = ancestors.length - 1; i >= 0; i--) {
+        const ancestor = ancestors[i];
+        if (ancestor.type === "FunctionDeclaration" && ancestor.id) {
+          return ancestor.id.name;
+        }
+        if (ancestor.type === "VariableDeclarator") {
+          const declarator = ancestor;
+          if (declarator.id.type === "Identifier" && declarator.init && isFunctionNode(declarator.init)) {
+            return declarator.id.name;
+          }
+        }
+        if (ancestor.type === "Property") {
+          const prop = ancestor;
+          if (prop.key.type === "Identifier" && prop.value && isFunctionNode(prop.value)) {
+            return prop.key.name;
+          }
+          if (prop.key.type === "Identifier" && prop.method) {
+            return prop.key.name;
+          }
+        }
+      }
+      return null;
+    }
+    return {
+      ImportDeclaration(node) {
+        if (node.source.value === V1_PACKAGE) {
+          hasV1Import = true;
+        }
+      },
+      FunctionDeclaration(node) {
+        if (node.id) {
+          namedFunctions.set(node.id.name, node);
+        }
+      },
+      VariableDeclarator(node) {
+        if (node.id.type === "Identifier" && node.init && isFunctionNode(node.init)) {
+          namedFunctions.set(node.id.name, node.init);
+        }
+      },
+      CallExpression(node) {
+        if (!hasV1Import) return;
+        if (isStoryCall(node) || isDocStoryCall(node)) {
+          for (const arg of node.arguments) {
+            if (arg.type === "Identifier") {
+              storyCallbackNames.add(arg.name);
+            }
+            if (arg.type === "MemberExpression" && arg.property.type === "Identifier") {
+              storyCallbackNames.add(arg.property.name);
+            }
+          }
+          return;
+        }
+        if (!isStepCall(node)) return;
+        if (insideStoryCallback(node, context)) return;
+        const containingFunctionName = getContainingFunctionName(node);
+        pendingStepCalls.push({ node, containingFunctionName });
+      },
+      "Program:exit"() {
+        for (const { node, containingFunctionName } of pendingStepCalls) {
+          if (containingFunctionName && storyCallbackNames.has(containingFunctionName)) {
+            continue;
+          }
+          context.report({ node, messageId: "requireStory" });
+        }
+      }
+    };
+  }
+};
+var require_story_context_for_steps_default = rule;
+
+// src/rules/require-test-context-for-doc-story.ts
+var V1_PACKAGE2 = "executable-stories-playwright";
+var TEST_MODIFIERS = /* @__PURE__ */ new Set(["only", "skip", "fixme", "fail", "slow"]);
+function isFunction2(node) {
+  return node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
+}
+function isFunctionNode2(node) {
+  return node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
+}
+function isDocStoryCall2(node) {
+  const { callee } = node;
+  if (callee.type !== "MemberExpression") return false;
+  return callee.object.type === "Identifier" && callee.object.name === "doc" && callee.property.type === "Identifier" && callee.property.name === "story";
+}
+function isTestCallExpression(node) {
+  const { callee } = node;
+  if (callee.type === "Identifier") {
+    return callee.name === "test" || callee.name === "it";
+  }
+  if (callee.type !== "MemberExpression") return false;
+  if (callee.object.type !== "Identifier") return false;
+  if (callee.object.name !== "test" && callee.object.name !== "it")
+    return false;
+  if (callee.property.type !== "Identifier") return false;
+  return TEST_MODIFIERS.has(callee.property.name);
+}
+function insideTestCallback(node, context) {
+  const ancestors = context.getSourceCode().getAncestors(node);
+  const functionAncestors = new Set(ancestors.filter(isFunction2));
+  for (const ancestor of ancestors) {
+    if (ancestor.type !== "CallExpression") continue;
+    if (!isTestCallExpression(ancestor)) continue;
+    for (const arg of ancestor.arguments) {
+      if (arg && typeof arg === "object" && functionAncestors.has(arg)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+var rule2 = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require doc.story(title) to be called inside a test() or it() callback (framework-native pattern).",
+      recommended: true
+    },
+    schema: [],
+    messages: {
+      requireTest: "doc.story(title) must be called inside a test() callback (e.g. test('...', () => { doc.story('Title'); ... })).",
+      requireTitle: "doc.story(title) requires a title argument."
+    }
+  },
+  create(context) {
+    let hasV1Import = false;
+    const namedFunctions = /* @__PURE__ */ new Map();
+    const testCallbackNames = /* @__PURE__ */ new Set();
+    const pendingDocStoryCalls = [];
+    function getContainingFunctionName(node) {
+      const ancestors = context.getSourceCode().getAncestors(node);
+      for (let i = ancestors.length - 1; i >= 0; i--) {
+        const ancestor = ancestors[i];
+        if (ancestor.type === "FunctionDeclaration" && ancestor.id) {
+          return ancestor.id.name;
+        }
+        if (ancestor.type === "VariableDeclarator") {
+          const declarator = ancestor;
+          if (declarator.id.type === "Identifier" && declarator.init && isFunctionNode2(declarator.init)) {
+            return declarator.id.name;
+          }
+        }
+        if (ancestor.type === "Property") {
+          const prop = ancestor;
+          if (prop.key.type === "Identifier" && prop.value && isFunctionNode2(prop.value)) {
+            return prop.key.name;
+          }
+          if (prop.key.type === "Identifier" && prop.method) {
+            return prop.key.name;
+          }
+        }
+      }
+      return null;
+    }
+    return {
+      ImportDeclaration(node) {
+        if (node.source.value === V1_PACKAGE2) {
+          hasV1Import = true;
+        }
+      },
+      FunctionDeclaration(node) {
+        if (node.id) {
+          namedFunctions.set(node.id.name, node);
+        }
+      },
+      VariableDeclarator(node) {
+        if (node.id.type === "Identifier" && node.init && isFunctionNode2(node.init)) {
+          namedFunctions.set(node.id.name, node.init);
+        }
+      },
+      CallExpression(node) {
+        if (!hasV1Import) return;
+        if (isTestCallExpression(node)) {
+          for (const arg of node.arguments) {
+            if (arg.type === "Identifier") {
+              testCallbackNames.add(arg.name);
+            }
+            if (arg.type === "MemberExpression" && arg.property.type === "Identifier") {
+              testCallbackNames.add(arg.property.name);
+            }
+          }
+          return;
+        }
+        if (!isDocStoryCall2(node)) return;
+        if (node.arguments.length === 0) {
+          context.report({ node, messageId: "requireTitle" });
+          return;
+        }
+        if (node.arguments.length >= 2) return;
+        if (insideTestCallback(node, context)) return;
+        const containingFunctionName = getContainingFunctionName(node);
+        pendingDocStoryCalls.push({ node, containingFunctionName });
+      },
+      "Program:exit"() {
+        for (const { node, containingFunctionName } of pendingDocStoryCalls) {
+          if (containingFunctionName && testCallbackNames.has(containingFunctionName)) {
+            continue;
+          }
+          context.report({ node, messageId: "requireTest" });
+        }
+      }
+    };
+  }
+};
+var require_test_context_for_doc_story_default = rule2;
+
+// src/index.ts
+var rules = {
+  "require-story-context-for-steps": require_story_context_for_steps_default,
+  "require-test-context-for-doc-story": require_test_context_for_doc_story_default
+};
+var configs = {
+  recommended: [
+    {
+      plugins: {
+        "executable-stories-playwright": { rules }
+      },
+      rules: {
+        "executable-stories-playwright/require-story-context-for-steps": "error",
+        "executable-stories-playwright/require-test-context-for-doc-story": "error"
+      }
+    }
+  ]
+};
+var plugin = {
+  meta: {
+    name: "eslint-plugin-executable-stories-playwright",
+    version: "0.1.0"
+  },
+  rules,
+  configs
+};
+var src_default = plugin;
+export {
+  configs,
+  src_default as default,
+  rules
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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-playwright';\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.getSourceCode().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.getSourceCode().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        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 (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\n/** Legacy doc.story() is not used; current API uses story.init(testInfo) inside test(). */\nconst V1_PACKAGE = 'executable-stories-playwright';\n\nconst TEST_MODIFIERS = new Set(['only', 'skip', 'fixme', 'fail', 'slow']);\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 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') return false;\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\nfunction insideTestCallback(\n  node: CallExpression,\n  context: Rule.RuleContext,\n): boolean {\n  const ancestors = context.getSourceCode().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() or it() callback (framework-native pattern).',\n      recommended: true,\n    },\n    schema: [],\n    messages: {\n      requireTest:\n        \"doc.story(title) must be called inside a test() callback (e.g. test('...', () => { 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.getSourceCode().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-playwright': { rules },\n      },\n      rules: {\n        'executable-stories-playwright/require-story-context-for-steps':\n          'error',\n        'executable-stories-playwright/require-test-context-for-doc-story':\n          'error',\n      },\n    },\n  ],\n};\n\nconst plugin: ESLint.Plugin = {\n  meta: {\n    name: 'eslint-plugin-executable-stories-playwright',\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":["V1_PACKAGE","isFunction","isFunctionNode","isDocStoryCall","rule"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "eslint-plugin-executable-stories-playwright",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "ESLint rules for executable-stories-playwright: step context, doc.story in test/it",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "lint": "eslint .",
+    "clean": "rm -rf dist",
+    "quality": "pnpm type-check && pnpm test && pnpm lint"
+  },
+  "keywords": [
+    "eslint",
+    "eslint-plugin",
+    "playwright",
+    "executable-stories",
+    "bdd"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "eslint": ">=9"
+  },
+  "devDependencies": {
+    "@types/eslint": "^9.6.1",
+    "@types/estree": "^1.0.8",
+    "@types/node": "^25.2.1",
+    "eslint": "^9.39.2",
+    "eslint-config-executable-stories": "workspace:*",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}