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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-executable-stories-jest",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "type": "module",
   "description": "ESLint rules for executable-stories-jest: step context, doc.story in test/it",
   "main": "./dist/index.cjs",
@@ -16,7 +16,9 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "skills",
+    "README.md",
+    "bin"
   ],
   "repository": {
     "type": "git",
@@ -43,11 +45,15 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18",
-    "eslint-config-executable-stories": "0.2.0"
+    "eslint-config-executable-stories": "0.2.0",
+    "executable-stories-vitest": "7.0.2"
   },
   "engines": {
     "node": ">=22"
   },
+  "bin": {
+    "intent": "./bin/intent.js"
+  },
   "scripts": {
     "build": "tsup",
     "type-check": "node -e \"const fs=require('fs');const {execSync}=require('child_process');const p=require('path').resolve(process.cwd(),'../executable-stories-jest/package.json');if(!fs.existsSync(p)){console.log('Skipping type-check: executable-stories-jest not in workspace');process.exit(0);}execSync('pnpm --filter executable-stories-jest run build && tsc --noEmit',{stdio:'inherit'});\"",

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

@@ -0,0 +1,111 @@
+---
+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),
+  require-test-context-for-doc-story (doc.story must be inside test/it).
+  Recommended config enables both at error level.
+type: core
+library: eslint-plugin-executable-stories-jest
+library_version: "0.1.0"
+sources:
+  - "jagreehal/executable-stories:packages/eslint-plugin-executable-stories-jest/src/index.ts"
+---
+
+# ESLint Plugin: executable-stories-jest
+
+## Setup
+
+```typescript
+// eslint.config.mjs
+import jestStories from "eslint-plugin-executable-stories-jest";
+
+export default [
+  // Option A: Use recommended config
+  ...jestStories.configs.recommended,
+
+  // Option B: Manual configuration
+  {
+    plugins: {
+      "executable-stories-jest": jestStories,
+    },
+    rules: {
+      "executable-stories-jest/require-story-context-for-steps": "error",
+      "executable-stories-jest/require-test-context-for-doc-story": "error",
+    },
+  },
+];
+```
+
+## Core Patterns
+
+### Rule: require-story-context-for-steps
+
+Ensures step functions (`given`, `when`, `then`, `and`, `but` and aliases) are called inside a `story()` or `doc.story(..., callback)`.
+
+```typescript
+// Fails lint
+it("my test", () => {
+  given("something"); // Error: must be inside story() or doc.story()
+});
+
+// Passes lint
+it("my test", () => {
+  story.init();
+  story.given("something");
+});
+```
+
+### Rule: require-test-context-for-doc-story
+
+Ensures `doc.story(title)` is called inside a `test()` or `it()` callback.
+
+```typescript
+// Fails lint
+function setup() {
+  doc.story("My story"); // Error: must be inside test/it callback
+}
+
+// Fails lint
+it("my test", () => {
+  doc.story(); // Error: requires a title argument
+});
+
+// Passes lint
+it("my test", () => {
+  doc.story("My story");
+});
+
+// Also detects modifiers: it.only, it.skip, it.todo, it.concurrent, it.failing
+it.only("focused test", () => {
+  doc.story("My story"); // Passes lint
+});
+```
+
+## Common Mistakes
+
+### HIGH Using legacy .eslintrc instead of flat config
+
+Wrong:
+
+```json
+{
+  "plugins": ["executable-stories-jest"],
+  "rules": {
+    "executable-stories-jest/require-story-context-for-steps": "error"
+  }
+}
+```
+
+Correct:
+
+```typescript
+// eslint.config.mjs (flat config)
+import jestStories from "eslint-plugin-executable-stories-jest";
+
+export default [...jestStories.configs.recommended];
+```
+
+This plugin only supports ESLint 9 flat config.
+
+Source: packages/eslint-plugin-executable-stories-jest/src/index.ts