@trackunit/eslint-plugin-trackunit 0.6.152 → 0.6.154

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 0.6.154 (2026-09-28)
+
+### 🧱 Updated Dependencies
+
+- Updated css-classname-utils to 0.0.55
+- Updated shared-utils to 1.16.57
+
+## 0.6.153 (2026-09-25)
+
+### 🧱 Updated Dependencies
+
+- Updated css-classname-utils to 0.0.54
+- Updated shared-utils to 1.16.56
+
 ## 0.6.152 (2026-09-25)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -86,9 +86,40 @@ All custom rules are enabled automatically through the presets under the `@track
 
 ### Storybook
 
-| Rule                                                  | Severity | Auto-fix | Description                                                                                                          |
-| ----------------------------------------------------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
-| `@trackunit/require-storybook-folder-landing-page`    | error    | no       | Requires a `*.docs.mdx` landing page (`<Meta title>`) for every ancestor folder implied by a story's title. Enabled for `*.stories.{ts,tsx}` files in the `react` preset. |
+This package owns the `@trackunit/storybook/*` rule implementations and registers the
+`@trackunit/storybook` plugin from the published `react` preset, but the published `react` preset
+does **not enable any rule under that namespace itself**. Inside the `manager` monorepo, a
+separate internal preset (`@trackunit/eslint-plugin-trackunit-internal`'s `storybook` preset,
+consumed via `internalConfigs.storybook`) is what turns these rules on for every story-bearing
+project.
+
+| Rule                                                  | Severity in `manager` | Auto-fix | Enforces                                                                                                          |
+| ----------------------------------------------------- | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
+| `@trackunit/storybook/require-folder-landing-page`    | error                  | no       | Requires a `*.docs.mdx` landing page (`<Meta title="...">`) for every ancestor folder implied by a story's `title` — including titles read from CSF factory `<binding>.meta({...})` calls. Without a landing page, Storybook renders an empty grouping node in the sidebar. |
+| `@trackunit/require-storybook-folder-landing-page`    | not enabled by default | no       | Deprecated alias of `@trackunit/storybook/require-folder-landing-page` — same rule implementation, kept only so configs still referencing the pre-namespace id keep working. Neither the published `react` preset nor the internal `storybook` preset enables it; a consumer must re-enable it explicitly. |
+| `@trackunit/storybook/require-csf-factory`            | warn                   | no       | Detection-only: flags story files in the legacy `export default {...}` shape (`oldFormat`), files mixing that shape with a factory `.meta({...})` call (`mixedFormat`), and files with neither signal (`missingMeta`). Stays silent on files already in the CSF **factory** format (`<binding>.meta({...})` + `<meta>.story({...})`). |
+| `storybook/*` (upstream `eslint-plugin-storybook@^10.3.5` `flat/recommended`) | per-rule (upstream defaults), with `storybook/default-exports` forced `off` | per-rule | Upstream Storybook lint rules, spread only by the internal `storybook` preset — never by the published `react` preset. `storybook/default-exports` is turned back off immediately after the spread because it contradicts the CSF factory format's implicit default export via the `meta` object; `require-csf-factory` above already reports a story file with no meta/default export at all, so no detection guarantee is lost by disabling it. |
+
+**External consumers opt in themselves.** The published `react` preset registers the
+`@trackunit/storybook` plugin (so its rule ids resolve without extra config) but enables zero
+rules under that namespace. If you consume `@trackunit/eslint-plugin-trackunit` outside the
+`manager` monorepo and want this coverage, turn the rules on yourself:
+
+```js
+module.exports = [
+  ...configs.base,
+  ...configs.react,
+  {
+    rules: {
+      "@trackunit/storybook/require-folder-landing-page": "error",
+      "@trackunit/storybook/require-csf-factory": "warn",
+    },
+  },
+];
+```
+
+> **Planned:** A `no-local-meta-component` rule is expected to join the
+> `@trackunit/storybook/*` namespace once it's written; it does not exist yet.
 
 ### Localization
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/eslint-plugin-trackunit",
-  "version": "0.6.152",
+  "version": "0.6.154",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {
@@ -8,7 +8,7 @@
   },
   "dependencies": {
     "@nx/eslint-plugin": "23.1.0",
-    "@trackunit/css-classname-utils": "0.0.53",
+    "@trackunit/css-classname-utils": "0.0.55",
     "@typescript-eslint/eslint-plugin": "8.58.1",
     "@typescript-eslint/utils": "8.58.1",
     "eslint-config-prettier": "^10.1.8",

package/src/index.d.ts

@@ -6,4 +6,5 @@ export { findMonorepoRoot } from "./lib/config/utils";
 export type { MatchCriteria, ProjectMetadata } from "./lib/utils/nx-utils";
 export { strictJsdocRules } from "./lib/config/fragments/jsdoc-rules";
 export { restrictedImportRules } from "./lib/config/fragments/restricted-imports";
-export { globals, jsdoc, localRulesPlugin, nx, reactHooks, tsParser } from "./lib/config/plugins";
+export { storyFileGlobs, storyRelaxations } from "./lib/config/fragments/story-relaxations";
+export { globals, jsdoc, localRulesPlugin, nx, reactHooks, storybookPlugin, tsParser } from "./lib/config/plugins";

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.tsParser = exports.reactHooks = exports.nx = exports.localRulesPlugin = exports.jsdoc = exports.globals = exports.restrictedImportRules = exports.strictJsdocRules = exports.findMonorepoRoot = exports.createSkipWhen = exports.configs = void 0;
+exports.tsParser = exports.storybookPlugin = exports.reactHooks = exports.nx = exports.localRulesPlugin = exports.jsdoc = exports.globals = exports.storyRelaxations = exports.storyFileGlobs = exports.restrictedImportRules = exports.strictJsdocRules = exports.findMonorepoRoot = exports.createSkipWhen = exports.configs = void 0;
 const rules_map_1 = require("./lib/rules-map");
 exports.default = rules_map_1.rulesMap;
 var config_1 = require("./lib/config");
@@ -13,11 +13,15 @@ var jsdoc_rules_1 = require("./lib/config/fragments/jsdoc-rules");
 Object.defineProperty(exports, "strictJsdocRules", { enumerable: true, get: function () { return jsdoc_rules_1.strictJsdocRules; } });
 var restricted_imports_1 = require("./lib/config/fragments/restricted-imports");
 Object.defineProperty(exports, "restrictedImportRules", { enumerable: true, get: function () { return restricted_imports_1.restrictedImportRules; } });
+var story_relaxations_1 = require("./lib/config/fragments/story-relaxations");
+Object.defineProperty(exports, "storyFileGlobs", { enumerable: true, get: function () { return story_relaxations_1.storyFileGlobs; } });
+Object.defineProperty(exports, "storyRelaxations", { enumerable: true, get: function () { return story_relaxations_1.storyRelaxations; } });
 var plugins_1 = require("./lib/config/plugins");
 Object.defineProperty(exports, "globals", { enumerable: true, get: function () { return plugins_1.globals; } });
 Object.defineProperty(exports, "jsdoc", { enumerable: true, get: function () { return plugins_1.jsdoc; } });
 Object.defineProperty(exports, "localRulesPlugin", { enumerable: true, get: function () { return plugins_1.localRulesPlugin; } });
 Object.defineProperty(exports, "nx", { enumerable: true, get: function () { return plugins_1.nx; } });
 Object.defineProperty(exports, "reactHooks", { enumerable: true, get: function () { return plugins_1.reactHooks; } });
+Object.defineProperty(exports, "storybookPlugin", { enumerable: true, get: function () { return plugins_1.storybookPlugin; } });
 Object.defineProperty(exports, "tsParser", { enumerable: true, get: function () { return plugins_1.tsParser; } });
 //# sourceMappingURL=index.js.map

package/src/lib/config/fragments/react-rules.d.ts

@@ -2,4 +2,3 @@ import type { Linter } from "eslint";
 export declare const reactRules: Linter.RulesRecord;
 export declare const reactCustomRules: Linter.RulesRecord;
 export declare const reactTestingLibraryOverrides: Linter.Config;
-export declare const reactStoryOverrides: Linter.Config;

package/src/lib/config/fragments/react-rules.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.reactStoryOverrides = exports.reactTestingLibraryOverrides = exports.reactCustomRules = exports.reactRules = void 0;
+exports.reactTestingLibraryOverrides = exports.reactCustomRules = exports.reactRules = void 0;
 exports.reactRules = {
     "react-hooks/rules-of-hooks": "error",
     "react-hooks/exhaustive-deps": "error",
@@ -141,12 +141,4 @@ exports.reactTestingLibraryOverrides = {
         "jest/expect-expect": "error",
     },
 };
-exports.reactStoryOverrides = {
-    files: ["**/*.stories.ts", "**/*.stories.tsx"],
-    rules: {
-        "jsdoc/require-jsdoc": "off",
-        "no-console": "off",
-        "@typescript-eslint/no-empty-function": "off",
-    },
-};
 //# sourceMappingURL=react-rules.js.map

package/src/lib/config/fragments/story-relaxations.d.ts

@@ -0,0 +1,23 @@
+import type { Linter } from "eslint";
+/**
+ * Story-file glob patterns shared by every preset that needs to scope config to Storybook CSF
+ * files. Kept as its own export (rather than only living inside `storyRelaxations.files`) so
+ * consumers that need the globs for something other than the rule relaxations below (e.g. an
+ * `@nx/dependency-checks` `ignoredFiles` entry) can reuse the same list without re-typing it.
+ */
+export declare const storyFileGlobs: ReadonlyArray<string>;
+/**
+ * The single source of truth for the rule relaxations every story-bearing preset needs. Story
+ * files (CSF `meta`/story objects) legitimately:
+ * - skip JSDoc (`jsdoc/require-jsdoc`) — they're fixtures, not public API surface.
+ * - use `console.*` in play/interaction functions (`no-console`).
+ * - declare empty handlers as story args (`@typescript-eslint/no-empty-function`).
+ * - export multiple story objects per file and name them after the story, not the file
+ *   (`@trackunit/one-component-per-file`, `@trackunit/component-name-matches-filename`).
+ * - render components without satisfying the prop-contract shape the rule expects from real
+ *   components (`@trackunit/require-component-prop-contracts`).
+ *
+ * Intentionally does NOT touch `@trackunit/storybook/*` or `storybook/*` rules — those are
+ * registered and enabled by separate presets, not by this rule-relaxation fragment.
+ */
+export declare const storyRelaxations: Linter.Config;

package/src/lib/config/fragments/story-relaxations.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storyRelaxations = exports.storyFileGlobs = void 0;
+/**
+ * Story-file glob patterns shared by every preset that needs to scope config to Storybook CSF
+ * files. Kept as its own export (rather than only living inside `storyRelaxations.files`) so
+ * consumers that need the globs for something other than the rule relaxations below (e.g. an
+ * `@nx/dependency-checks` `ignoredFiles` entry) can reuse the same list without re-typing it.
+ */
+exports.storyFileGlobs = ["**/*.stories.ts", "**/*.stories.tsx"];
+/**
+ * The single source of truth for the rule relaxations every story-bearing preset needs. Story
+ * files (CSF `meta`/story objects) legitimately:
+ * - skip JSDoc (`jsdoc/require-jsdoc`) — they're fixtures, not public API surface.
+ * - use `console.*` in play/interaction functions (`no-console`).
+ * - declare empty handlers as story args (`@typescript-eslint/no-empty-function`).
+ * - export multiple story objects per file and name them after the story, not the file
+ *   (`@trackunit/one-component-per-file`, `@trackunit/component-name-matches-filename`).
+ * - render components without satisfying the prop-contract shape the rule expects from real
+ *   components (`@trackunit/require-component-prop-contracts`).
+ *
+ * Intentionally does NOT touch `@trackunit/storybook/*` or `storybook/*` rules — those are
+ * registered and enabled by separate presets, not by this rule-relaxation fragment.
+ */
+exports.storyRelaxations = {
+    files: [...exports.storyFileGlobs],
+    rules: {
+        "jsdoc/require-jsdoc": "off",
+        "no-console": "off",
+        "@typescript-eslint/no-empty-function": "off",
+        "@trackunit/one-component-per-file": "off",
+        "@trackunit/component-name-matches-filename": "off",
+        "@trackunit/require-component-prop-contracts": "off",
+    },
+};
+//# sourceMappingURL=story-relaxations.js.map

package/src/lib/config/index.d.ts

@@ -603,6 +603,16 @@ export declare const configs: {
                     };
                 };
             };
+            "@trackunit/storybook": {
+                rules: {
+                    "require-folder-landing-page": import("@typescript-eslint/utils/ts-eslint").RuleModule<"missingLandingPage", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
+                    "require-csf-factory": import("@typescript-eslint/utils/ts-eslint").RuleModule<"oldFormat" | "mixedFormat" | "missingMeta", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
+                };
+            };
             "@typescript-eslint": {
                 configs: Record<string, import("@typescript-eslint/utils/ts-eslint").ClassicConfig.Config>;
                 meta: import("typescript-eslint").FlatConfig.PluginMeta;
@@ -1038,26 +1048,8 @@ export declare const configs: {
             })[];
             "no-unreachable": string;
             "prefer-spread": string;
-            "jsdoc/require-jsdoc"?: undefined;
-            "no-console"?: undefined;
-            "@typescript-eslint/no-empty-function"?: undefined;
             "@trackunit/one-component-per-file"?: undefined;
             "@trackunit/component-name-matches-filename"?: undefined;
-            "@trackunit/require-storybook-folder-landing-page"?: undefined;
-        };
-        plugins?: undefined;
-        settings?: undefined;
-        languageOptions?: undefined;
-    } | {
-        files: string[];
-        rules: {
-            "jsdoc/require-jsdoc": string;
-            "no-console": string;
-            "@typescript-eslint/no-empty-function": string;
-            "@trackunit/one-component-per-file": string;
-            "@trackunit/component-name-matches-filename": string;
-            "@trackunit/require-storybook-folder-landing-page": string;
-            "no-restricted-properties"?: undefined;
         };
         plugins?: undefined;
         settings?: undefined;
@@ -1068,10 +1060,6 @@ export declare const configs: {
             "@trackunit/one-component-per-file": string;
             "@trackunit/component-name-matches-filename": string;
             "no-restricted-properties": string;
-            "jsdoc/require-jsdoc"?: undefined;
-            "no-console"?: undefined;
-            "@typescript-eslint/no-empty-function"?: undefined;
-            "@trackunit/require-storybook-folder-landing-page"?: undefined;
         };
         plugins?: undefined;
         settings?: undefined;
@@ -1125,6 +1113,7 @@ export declare const configs: {
                 };
             };
             "@trackunit"?: undefined;
+            "@trackunit/storybook"?: undefined;
             "@typescript-eslint"?: undefined;
             jsdoc?: undefined;
             react?: undefined;
@@ -1144,12 +1133,8 @@ export declare const configs: {
         rules: {
             "jest/no-commented-out-tests": string;
             "jest/expect-expect": string;
-            "jsdoc/require-jsdoc"?: undefined;
-            "no-console"?: undefined;
-            "@typescript-eslint/no-empty-function"?: undefined;
             "@trackunit/one-component-per-file"?: undefined;
             "@trackunit/component-name-matches-filename"?: undefined;
-            "@trackunit/require-storybook-folder-landing-page"?: undefined;
             "no-restricted-properties"?: undefined;
         };
         settings?: undefined;

package/src/lib/config/plugins.d.ts

@@ -121,4 +121,23 @@ export declare const localRulesPlugin: {
         };
     };
 };
+/**
+ * Shared plugin object for the `@trackunit/storybook` namespace. Rule code stays in this
+ * package; this object is what presets (and external consumers who opt in directly) register
+ * under the `@trackunit/storybook` plugin key so ESLint resolves e.g.
+ * `@trackunit/storybook/require-folder-landing-page` to plugin `@trackunit/storybook` + rule
+ * `require-folder-landing-page`. Must stay a single object reference — flat config compares
+ * plugin references by identity — so import this export everywhere the namespace is registered,
+ * never construct a new `{ rules: {...} }` object elsewhere.
+ */
+export declare const storybookPlugin: {
+    rules: {
+        "require-folder-landing-page": import("@typescript-eslint/utils/ts-eslint").RuleModule<"missingLandingPage", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+            name: string;
+        };
+        "require-csf-factory": import("@typescript-eslint/utils/ts-eslint").RuleModule<"oldFormat" | "mixedFormat" | "missingMeta", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+            name: string;
+        };
+    };
+};
 export { eslintConfigPrettier, globals, importPlugin, jest, jsdoc, jsoncParser, noNull, nx, react, reactHooks, testingLibrary, tsParser, typescriptEslint, };

package/src/lib/config/plugins.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.typescriptEslint = exports.tsParser = exports.testingLibrary = exports.reactHooks = exports.react = exports.nx = exports.noNull = exports.jsoncParser = exports.jsdoc = exports.jest = exports.importPlugin = exports.globals = exports.eslintConfigPrettier = exports.localRulesPlugin = void 0;
+exports.typescriptEslint = exports.tsParser = exports.testingLibrary = exports.reactHooks = exports.react = exports.nx = exports.noNull = exports.jsoncParser = exports.jsdoc = exports.jest = exports.importPlugin = exports.globals = exports.eslintConfigPrettier = exports.storybookPlugin = exports.localRulesPlugin = void 0;
 const tslib_1 = require("tslib");
 /**
  * Shared plugin instances for ESLint flat config.
@@ -37,6 +37,23 @@ const globals = tslib_1.__importStar(require("globals"));
 exports.globals = globals;
 const jsoncParser = tslib_1.__importStar(require("jsonc-eslint-parser"));
 exports.jsoncParser = jsoncParser;
+const require_csf_factory_1 = require("../rules/require-csf-factory/require-csf-factory");
+const require_storybook_folder_landing_page_1 = require("../rules/require-storybook-folder-landing-page/require-storybook-folder-landing-page");
 const rules_map_1 = require("../rules-map");
 exports.localRulesPlugin = { rules: rules_map_1.rulesMap };
+/**
+ * Shared plugin object for the `@trackunit/storybook` namespace. Rule code stays in this
+ * package; this object is what presets (and external consumers who opt in directly) register
+ * under the `@trackunit/storybook` plugin key so ESLint resolves e.g.
+ * `@trackunit/storybook/require-folder-landing-page` to plugin `@trackunit/storybook` + rule
+ * `require-folder-landing-page`. Must stay a single object reference — flat config compares
+ * plugin references by identity — so import this export everywhere the namespace is registered,
+ * never construct a new `{ rules: {...} }` object elsewhere.
+ */
+exports.storybookPlugin = {
+    rules: {
+        "require-folder-landing-page": require_storybook_folder_landing_page_1.requireFolderLandingPage,
+        "require-csf-factory": require_csf_factory_1.requireCsfFactory,
+    },
+};
 //# sourceMappingURL=plugins.js.map

package/src/lib/config/presets/base.js

@@ -9,6 +9,7 @@ const jsdoc_rules_1 = require("../fragments/jsdoc-rules");
 const module_boundaries_1 = require("../fragments/module-boundaries");
 const no_direct_storage_access_1 = require("../fragments/no-direct-storage-access");
 const restricted_imports_1 = require("../fragments/restricted-imports");
+const story_relaxations_1 = require("../fragments/story-relaxations");
 const typescript_rules_1 = require("../fragments/typescript-rules");
 const plugins_1 = require("../plugins");
 const utils_1 = require("../utils");
@@ -187,6 +188,9 @@ exports.base = [
         },
     },
     plugins_1.eslintConfigPrettier,
+    // Shared with the `react` preset and the internal `publicApi` preset. Consumers that only
+    // spread `base` (without `react`) still get the six rule relaxations for story files.
+    story_relaxations_1.storyRelaxations,
     {
         files: ["**/*.stories.{ts,tsx,js,jsx}", "**/*.demo.{ts,tsx,js,jsx}"],
         rules: {

package/src/lib/config/presets/react.d.ts

@@ -102,6 +102,16 @@ export declare const reactPreset: (import("eslint").Linter.Config<import("eslint
                 };
             };
         };
+        "@trackunit/storybook": {
+            rules: {
+                "require-folder-landing-page": import("@typescript-eslint/utils/ts-eslint").RuleModule<"missingLandingPage", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
+                "require-csf-factory": import("@typescript-eslint/utils/ts-eslint").RuleModule<"oldFormat" | "mixedFormat" | "missingMeta", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
+            };
+        };
         "@typescript-eslint": {
             configs: Record<string, import("@typescript-eslint/utils/ts-eslint").ClassicConfig.Config>;
             meta: import("typescript-eslint").FlatConfig.PluginMeta;
@@ -537,26 +547,8 @@ export declare const reactPreset: (import("eslint").Linter.Config<import("eslint
         })[];
         "no-unreachable": string;
         "prefer-spread": string;
-        "jsdoc/require-jsdoc"?: undefined;
-        "no-console"?: undefined;
-        "@typescript-eslint/no-empty-function"?: undefined;
         "@trackunit/one-component-per-file"?: undefined;
         "@trackunit/component-name-matches-filename"?: undefined;
-        "@trackunit/require-storybook-folder-landing-page"?: undefined;
-    };
-    plugins?: undefined;
-    settings?: undefined;
-    languageOptions?: undefined;
-} | {
-    files: string[];
-    rules: {
-        "jsdoc/require-jsdoc": string;
-        "no-console": string;
-        "@typescript-eslint/no-empty-function": string;
-        "@trackunit/one-component-per-file": string;
-        "@trackunit/component-name-matches-filename": string;
-        "@trackunit/require-storybook-folder-landing-page": string;
-        "no-restricted-properties"?: undefined;
     };
     plugins?: undefined;
     settings?: undefined;
@@ -567,10 +559,6 @@ export declare const reactPreset: (import("eslint").Linter.Config<import("eslint
         "@trackunit/one-component-per-file": string;
         "@trackunit/component-name-matches-filename": string;
         "no-restricted-properties": string;
-        "jsdoc/require-jsdoc"?: undefined;
-        "no-console"?: undefined;
-        "@typescript-eslint/no-empty-function"?: undefined;
-        "@trackunit/require-storybook-folder-landing-page"?: undefined;
     };
     plugins?: undefined;
     settings?: undefined;
@@ -624,6 +612,7 @@ export declare const reactPreset: (import("eslint").Linter.Config<import("eslint
             };
         };
         "@trackunit"?: undefined;
+        "@trackunit/storybook"?: undefined;
         "@typescript-eslint"?: undefined;
         jsdoc?: undefined;
         react?: undefined;
@@ -643,12 +632,8 @@ export declare const reactPreset: (import("eslint").Linter.Config<import("eslint
     rules: {
         "jest/no-commented-out-tests": string;
         "jest/expect-expect": string;
-        "jsdoc/require-jsdoc"?: undefined;
-        "no-console"?: undefined;
-        "@typescript-eslint/no-empty-function"?: undefined;
         "@trackunit/one-component-per-file"?: undefined;
         "@trackunit/component-name-matches-filename"?: undefined;
-        "@trackunit/require-storybook-folder-landing-page"?: undefined;
         "no-restricted-properties"?: undefined;
     };
     settings?: undefined;

package/src/lib/config/presets/react.js

@@ -3,12 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.reactPreset = void 0;
 const no_direct_storage_access_1 = require("../fragments/no-direct-storage-access");
 const react_rules_1 = require("../fragments/react-rules");
+const story_relaxations_1 = require("../fragments/story-relaxations");
 const testing_library_1 = require("../fragments/testing-library");
 const plugins_1 = require("../plugins");
 exports.reactPreset = [
     {
         plugins: {
             "@trackunit": plugins_1.localRulesPlugin,
+            // Registers the `@trackunit/storybook` namespace so opt-in consumers can reference
+            // `@trackunit/storybook/require-folder-landing-page` without extra config. This preset
+            // intentionally does not enable any rule under that key itself.
+            "@trackunit/storybook": plugins_1.storybookPlugin,
             "@typescript-eslint": plugins_1.typescriptEslint,
             jsdoc: plugins_1.jsdoc,
             react: plugins_1.react,
@@ -63,19 +68,12 @@ exports.reactPreset = [
         },
     },
     no_direct_storage_access_1.noDirectStoragePropertyExceptionOverrides,
-    {
-        files: ["**/*.stories.ts", "**/*.stories.tsx"],
-        rules: {
-            "jsdoc/require-jsdoc": "off",
-            "no-console": "off",
-            "@typescript-eslint/no-empty-function": "off",
-            "@trackunit/one-component-per-file": "off",
-            "@trackunit/component-name-matches-filename": "off",
-            // Every Storybook folder implied by a story title must have a landing page
-            // (*.docs.mdx with a matching <Meta title>). See docs/STORYBOOK-LANDING-PAGES.md.
-            "@trackunit/require-storybook-folder-landing-page": "error",
-        },
-    },
+    // The published preset registers `@trackunit/storybook` (above) for opt-in use but does NOT
+    // enable `@trackunit/storybook/require-folder-landing-page` (nor its deprecated
+    // `@trackunit/require-storybook-folder-landing-page` alias) here. External consumers who want
+    // the landing-page check opt in explicitly. The rule relaxations below are unrelated to that
+    // namespace and shared with `base` and the internal `publicApi` preset.
+    story_relaxations_1.storyRelaxations,
     {
         files: ["**/*.spec.ts", "**/*.spec.tsx", "**/*.test.ts", "**/*.test.tsx"],
         rules: {

package/src/lib/rules/require-csf-factory/require-csf-factory.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Warn when a `*.stories.*` file is written in the legacy CSF (Component Story Format)
+ * default-export shape instead of Storybook's CSF **factory** format.
+ *
+ * Architecture: per-story-file rule, syntax-only (no TypeScript type information — see
+ * `isFactoryMetaCall`'s doc comment for why type-checking `component:` is unnecessary).
+ *
+ * Recognized shapes, per file:
+ * - **Old format** — any `export default ...` in the file (the legacy `export default { title,
+ *   component, ... }` meta object, whether inline or via a `const meta = {...}; export default
+ *   meta;` variable), and no factory `.meta({...})` call anywhere in the file. Reported with
+ *   `oldFormat`, pointing at the `export default` node.
+ * - **Factory format** (silent) — a call `<importedBinding>.meta({...})` (e.g.
+ *   `const meta = preview.meta({ component, title });`), where `<importedBinding>` resolves to
+ *   an imported identifier, and NEITHER an `export default` NOR an old-style named
+ *   object-literal story export (`export const Foo = { args: {...} };`, including a `satisfies` or
+ *   `as` wrapper around that object) is present. Individual
+ *   stories are expected to be exported as `<meta>.story({...})`, but this rule does not require
+ *   at least one such export to exist — it only needs the absence of old-format signals.
+ *   A `component:` property that is a generic/instantiation expression (e.g.
+ *   `MultiSelectField<Option>`) still matches this shape: the rule only inspects the *call*
+ *   shape, never the properties inside the `.meta({...})` object, so it never needs to
+ *   type-check `component`.
+ * - **Mixed format** — a factory `.meta({...})` call together with an
+ *   `export default` OR an old-style object-literal named story export. Reported with
+ *   `mixedFormat`, pointing at the `.meta({...})` call.
+ * - **Missing meta** — neither an `export default` nor a factory
+ *   `.meta({...})` call anywhere in the file. Reported with `missingMeta`, pointing at the
+ *   file's `Program` node (there is no more specific node to point at — the file declares no
+ *   meta object at all).
+ *
+ * Never visits `.storybook/` config files, `*.demo.*` files, or `*.mdx` files, even if their
+ * name would otherwise match the story-file pattern.
+ *
+ * This is a **detection-only** rule: no autofix (`meta.fixable` unset) and no suggestions
+ * (`meta.hasSuggestions` unset) — migrating a story file to the factory format requires
+ * rewriting the whole file's shape (imports, meta declaration, every story export), which is far
+ * beyond what a syntax-preserving ESLint fixer can safely produce. Storybook ships an official
+ * codemod for this (`npx storybook@latest automigrate csf-factories`) — see
+ * `REQUIRE_CSF_FACTORY_DOCS_URL`.
+ *
+ * See README.md for incorrect/correct examples.
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+type MessageIds = "oldFormat" | "mixedFormat" | "missingMeta";
+/**
+ * Canonical permalink to the how-to-migrate doc. Single source of truth, embedded in every
+ * message so developers tripping the rule get a direct link. Mirrors the
+ * `STORYBOOK_LANDING_PAGE_DOCS_URL` idiom in `../require-storybook-folder-landing-page/require-storybook-folder-landing-page.ts`.
+ */
+export declare const REQUIRE_CSF_FACTORY_DOCS_URL = "https://github.com/Trackunit/manager/blob/master/docs/STORYBOOK-CSF-FACTORY.md";
+export declare const requireCsfFactory: ESLintUtils.RuleModule<MessageIds, [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export {};

package/src/lib/rules/require-csf-factory/require-csf-factory.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * Warn when a `*.stories.*` file is written in the legacy CSF (Component Story Format)
+ * default-export shape instead of Storybook's CSF **factory** format.
+ *
+ * Architecture: per-story-file rule, syntax-only (no TypeScript type information — see
+ * `isFactoryMetaCall`'s doc comment for why type-checking `component:` is unnecessary).
+ *
+ * Recognized shapes, per file:
+ * - **Old format** — any `export default ...` in the file (the legacy `export default { title,
+ *   component, ... }` meta object, whether inline or via a `const meta = {...}; export default
+ *   meta;` variable), and no factory `.meta({...})` call anywhere in the file. Reported with
+ *   `oldFormat`, pointing at the `export default` node.
+ * - **Factory format** (silent) — a call `<importedBinding>.meta({...})` (e.g.
+ *   `const meta = preview.meta({ component, title });`), where `<importedBinding>` resolves to
+ *   an imported identifier, and NEITHER an `export default` NOR an old-style named
+ *   object-literal story export (`export const Foo = { args: {...} };`, including a `satisfies` or
+ *   `as` wrapper around that object) is present. Individual
+ *   stories are expected to be exported as `<meta>.story({...})`, but this rule does not require
+ *   at least one such export to exist — it only needs the absence of old-format signals.
+ *   A `component:` property that is a generic/instantiation expression (e.g.
+ *   `MultiSelectField<Option>`) still matches this shape: the rule only inspects the *call*
+ *   shape, never the properties inside the `.meta({...})` object, so it never needs to
+ *   type-check `component`.
+ * - **Mixed format** — a factory `.meta({...})` call together with an
+ *   `export default` OR an old-style object-literal named story export. Reported with
+ *   `mixedFormat`, pointing at the `.meta({...})` call.
+ * - **Missing meta** — neither an `export default` nor a factory
+ *   `.meta({...})` call anywhere in the file. Reported with `missingMeta`, pointing at the
+ *   file's `Program` node (there is no more specific node to point at — the file declares no
+ *   meta object at all).
+ *
+ * Never visits `.storybook/` config files, `*.demo.*` files, or `*.mdx` files, even if their
+ * name would otherwise match the story-file pattern.
+ *
+ * This is a **detection-only** rule: no autofix (`meta.fixable` unset) and no suggestions
+ * (`meta.hasSuggestions` unset) — migrating a story file to the factory format requires
+ * rewriting the whole file's shape (imports, meta declaration, every story export), which is far
+ * beyond what a syntax-preserving ESLint fixer can safely produce. Storybook ships an official
+ * codemod for this (`npx storybook@latest automigrate csf-factories`) — see
+ * `REQUIRE_CSF_FACTORY_DOCS_URL`.
+ *
+ * See README.md for incorrect/correct examples.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireCsfFactory = exports.REQUIRE_CSF_FACTORY_DOCS_URL = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const createRule = utils_1.ESLintUtils.RuleCreator(name => `https://github.com/trackunit/manager/blob/master/libs/eslint/plugin-trackunit/src/lib/rules/${name}/${name}.ts`);
+/**
+ * Canonical permalink to the how-to-migrate doc. Single source of truth, embedded in every
+ * message so developers tripping the rule get a direct link. Mirrors the
+ * `STORYBOOK_LANDING_PAGE_DOCS_URL` idiom in `../require-storybook-folder-landing-page/require-storybook-folder-landing-page.ts`.
+ */
+exports.REQUIRE_CSF_FACTORY_DOCS_URL = "https://github.com/Trackunit/manager/blob/master/docs/STORYBOOK-CSF-FACTORY.md";
+// Only analyze story files — mirrors `STORY_FILE_REGEX` in the landing-page rule.
+const STORY_FILE_REGEX = /\.stories\.(js|jsx|ts|tsx)$/;
+// Excluded even when the name would otherwise match a story file.
+const STORYBOOK_CONFIG_DIR_REGEX = /(^|\/)\.storybook\//;
+// Not anchored to the end: a real demo file is named `Foo.demo.tsx` (never also `.stories.`,
+// so it's already excluded by `STORY_FILE_REGEX` below), but this stays non-anchored so it also
+// excludes a hypothetical combined name like `Foo.demo.stories.tsx` rather than relying on that
+// combination never existing.
+const DEMO_FILE_REGEX = /\.demo\./;
+const MDX_REGEX = /\.mdx$/;
+const isAnalyzableStoryFile = (filename) => {
+    if (MDX_REGEX.test(filename)) {
+        return false;
+    }
+    if (STORYBOOK_CONFIG_DIR_REGEX.test(filename)) {
+        return false;
+    }
+    if (DEMO_FILE_REGEX.test(filename)) {
+        return false;
+    }
+    return STORY_FILE_REGEX.test(filename);
+};
+/**
+ * True for a call `<identifier>.meta({...})` where `<identifier>` resolves to an imported
+ * binding. Only the call *shape* is inspected — the object argument's properties (e.g. a
+ * generic/instantiation `component:` value) are never type-checked or destructured, so this
+ * rule stays syntax-only.
+ */
+const isFactoryMetaCall = (node, context) => {
+    const { callee } = node;
+    if (callee.type !== utils_1.AST_NODE_TYPES.MemberExpression) {
+        return false;
+    }
+    if (callee.property.type !== utils_1.AST_NODE_TYPES.Identifier || callee.property.name !== "meta") {
+        return false;
+    }
+    if (callee.object.type !== utils_1.AST_NODE_TYPES.Identifier) {
+        return false;
+    }
+    const [firstArgument] = node.arguments;
+    if (firstArgument === undefined || firstArgument.type !== utils_1.AST_NODE_TYPES.ObjectExpression) {
+        return false;
+    }
+    const scope = context.sourceCode.getScope(callee.object);
+    const variable = scope.references.find(ref => ref.identifier === callee.object)?.resolved;
+    if (!variable) {
+        return false;
+    }
+    return variable.defs.some(def => def.type === "ImportBinding");
+};
+/** Unwrap `satisfies` / `as` wrappers, same as the landing-page rule's `unwrapExpression`. */
+const unwrapExpression = (node) => {
+    let current = node;
+    while (current.type === utils_1.AST_NODE_TYPES.TSSatisfiesExpression || current.type === utils_1.AST_NODE_TYPES.TSAsExpression) {
+        current = current.expression;
+    }
+    return current;
+};
+/**
+ * An old-style named story export: `export const Foo = { ... };` (object literal, not a call).
+ * `satisfies` and `as` wrappers still count (`export const Legacy = { args: {} } satisfies StoryObj`),
+ * matching how current stories write `export const Default: Story = { ... }` with a bare object.
+ */
+const isObjectLiteralStoryExport = (node) => {
+    const { declaration } = node;
+    if (declaration === null || declaration.type !== utils_1.AST_NODE_TYPES.VariableDeclaration) {
+        return false;
+    }
+    return declaration.declarations.some(declarator => {
+        if (declarator.init === null) {
+            return false;
+        }
+        return unwrapExpression(declarator.init).type === utils_1.AST_NODE_TYPES.ObjectExpression;
+    });
+};
+const create = context => {
+    if (!isAnalyzableStoryFile(context.filename)) {
+        return {};
+    }
+    let defaultExportNode = null;
+    let metaCallNode = null;
+    let hasObjectLiteralStoryExport = false;
+    return {
+        ExportDefaultDeclaration(node) {
+            defaultExportNode = node;
+        },
+        ExportNamedDeclaration(node) {
+            if (isObjectLiteralStoryExport(node)) {
+                hasObjectLiteralStoryExport = true;
+            }
+        },
+        CallExpression(node) {
+            if (metaCallNode === null && isFactoryMetaCall(node, context)) {
+                metaCallNode = node;
+            }
+        },
+        "Program:exit"(node) {
+            const hasDefaultExport = defaultExportNode !== null;
+            if (!hasDefaultExport && metaCallNode === null) {
+                context.report({ node, messageId: "missingMeta" });
+                return;
+            }
+            if (metaCallNode !== null && (hasDefaultExport || hasObjectLiteralStoryExport)) {
+                context.report({ node: metaCallNode, messageId: "mixedFormat" });
+                return;
+            }
+            if (defaultExportNode !== null) {
+                context.report({ node: defaultExportNode, messageId: "oldFormat" });
+            }
+            // Otherwise: factory format (a `.meta({...})` call with no old-format signals) — silent.
+        },
+    };
+};
+exports.requireCsfFactory = createRule({
+    name: "require-csf-factory",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Warn on Storybook story files that are not written in CSF factory format",
+        },
+        schema: [],
+        messages: {
+            oldFormat: `[require-csf-factory] This story file uses the legacy \`export default { ... }\` CSF format instead of Storybook's CSF factory format (\`preview.meta({...})\` + \`meta.story({...})\`). See ${exports.REQUIRE_CSF_FACTORY_DOCS_URL} for how to migrate.`,
+            mixedFormat: `[require-csf-factory] This story file mixes a factory \`.meta({...})\` call with legacy \`export default\`/object-literal story exports. Migrate the whole file to the CSF factory format. See ${exports.REQUIRE_CSF_FACTORY_DOCS_URL} for how to migrate.`,
+            missingMeta: `[require-csf-factory] This story file declares no meta object (neither \`export default\` nor a factory \`.meta({...})\` call). See ${exports.REQUIRE_CSF_FACTORY_DOCS_URL} for how to migrate.`,
+        },
+    },
+    defaultOptions: [],
+    create,
+});
+//# sourceMappingURL=require-csf-factory.js.map

package/src/lib/rules/require-storybook-folder-landing-page/require-storybook-folder-landing-page.d.ts

@@ -3,10 +3,13 @@
  * FOLDER implied by a story's title.
  *
  * Architecture: per-story-file rule. Each `*.stories.@(js|jsx|ts|tsx)` file declares a Storybook
- * `title` (e.g. "Hooks/react-core-hooks/useDebounce"). The folders implied by that title are the
- * accumulated path prefixes EXCLUDING the story leaf (here: "Hooks" and "Hooks/react-core-hooks").
- * Every such folder must have a landing page: a `*.docs.mdx` somewhere in the workspace whose
- * `<Meta title="FOLDER" />` EXACTLY equals the folder path, with non-empty body and no TODO marker.
+ * `title` (e.g. "Hooks/react-core-hooks/useDebounce"), read from either the legacy default-export
+ * meta object (`export default { title, ... }`, including via an intermediate variable) or a
+ * Storybook CSF factory `.meta({...})` call (`const meta = preview.meta({ title, ... });`).
+ * The folders implied by that title are the accumulated path prefixes
+ * EXCLUDING the story leaf (here: "Hooks" and "Hooks/react-core-hooks"). Every such folder must
+ * have a landing page: a `*.docs.mdx` somewhere in the workspace whose `<Meta title="FOLDER" />`
+ * EXACTLY equals the folder path, with non-empty body and no TODO marker.
  *
  * The rule is REPORT-ONLY: it does not scaffold files. Creating a separate `*.docs.mdx` cannot be
  * expressed as a pure ESLint fix, and ESLint evaluates fix/suggestion callbacks on every lint pass
@@ -18,6 +21,13 @@
 import { ESLintUtils } from "@typescript-eslint/utils";
 /** Canonical TODO marker. A landing page still containing this marker does NOT satisfy the rule. */
 export declare const STORYBOOK_LANDING_PAGE_TODO_MARKER = "{/* TODO: storybook-folder-landing-page */}";
+/**
+ * The namespaced rule id (plugin `@trackunit/storybook`, rule `require-folder-landing-page`).
+ * Registered as the `require-folder-landing-page` entry of the shared `storybookPlugin` object
+ * (see `../../config/plugins.ts`). This is the id the deprecated alias below points at via
+ * `meta.deprecated.replacedBy`.
+ */
+export declare const STORYBOOK_NAMESPACED_RULE_ID = "@trackunit/storybook/require-folder-landing-page";
 /**
  * Canonical permalink to the how-to-author doc. Single source of truth, embedded in the rule's
  * error message so developers tripping the rule get a direct link. The `master` permalink stays
@@ -26,6 +36,20 @@ export declare const STORYBOOK_LANDING_PAGE_TODO_MARKER = "{/* TODO: storybook-f
 export declare const STORYBOOK_LANDING_PAGE_DOCS_URL = "https://github.com/Trackunit/manager/blob/master/docs/STORYBOOK-LANDING-PAGES.md";
 /** Clear the module-level scan cache (primarily for tests). */
 export declare const clearLandingPageCache: () => void;
+/**
+ * The namespaced rule: `@trackunit/storybook/require-folder-landing-page` (registered under that
+ * key in the shared `storybookPlugin` object exported from `../../config/plugins.ts`). This is
+ * the current, non-deprecated rule id.
+ */
+export declare const requireFolderLandingPage: ESLintUtils.RuleModule<"missingLandingPage", [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+/**
+ * Deprecated alias of {@link requireFolderLandingPage}, kept registered under the original
+ * `require-storybook-folder-landing-page` key in `rulesMap` (id `@trackunit/require-storybook-folder-landing-page`)
+ * so existing configs keep working. Delegates to the identical `create` implementation — only the
+ * `meta` differs (marks itself deprecated and points at the namespaced replacement).
+ */
 export declare const requireStorybookFolderLandingPage: ESLintUtils.RuleModule<"missingLandingPage", [], unknown, ESLintUtils.RuleListener> & {
     name: string;
 };

package/src/lib/rules/require-storybook-folder-landing-page/require-storybook-folder-landing-page.js

@@ -4,10 +4,13 @@
  * FOLDER implied by a story's title.
  *
  * Architecture: per-story-file rule. Each `*.stories.@(js|jsx|ts|tsx)` file declares a Storybook
- * `title` (e.g. "Hooks/react-core-hooks/useDebounce"). The folders implied by that title are the
- * accumulated path prefixes EXCLUDING the story leaf (here: "Hooks" and "Hooks/react-core-hooks").
- * Every such folder must have a landing page: a `*.docs.mdx` somewhere in the workspace whose
- * `<Meta title="FOLDER" />` EXACTLY equals the folder path, with non-empty body and no TODO marker.
+ * `title` (e.g. "Hooks/react-core-hooks/useDebounce"), read from either the legacy default-export
+ * meta object (`export default { title, ... }`, including via an intermediate variable) or a
+ * Storybook CSF factory `.meta({...})` call (`const meta = preview.meta({ title, ... });`).
+ * The folders implied by that title are the accumulated path prefixes
+ * EXCLUDING the story leaf (here: "Hooks" and "Hooks/react-core-hooks"). Every such folder must
+ * have a landing page: a `*.docs.mdx` somewhere in the workspace whose `<Meta title="FOLDER" />`
+ * EXACTLY equals the folder path, with non-empty body and no TODO marker.
  *
  * The rule is REPORT-ONLY: it does not scaffold files. Creating a separate `*.docs.mdx` cannot be
  * expressed as a pure ESLint fix, and ESLint evaluates fix/suggestion callbacks on every lint pass
@@ -17,7 +20,7 @@
  * See README.md for incorrect/correct examples.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.requireStorybookFolderLandingPage = exports.clearLandingPageCache = exports.STORYBOOK_LANDING_PAGE_DOCS_URL = exports.STORYBOOK_LANDING_PAGE_TODO_MARKER = void 0;
+exports.requireStorybookFolderLandingPage = exports.requireFolderLandingPage = exports.clearLandingPageCache = exports.STORYBOOK_LANDING_PAGE_DOCS_URL = exports.STORYBOOK_NAMESPACED_RULE_ID = exports.STORYBOOK_LANDING_PAGE_TODO_MARKER = void 0;
 const tslib_1 = require("tslib");
 const utils_1 = require("@typescript-eslint/utils");
 const crypto = tslib_1.__importStar(require("crypto"));
@@ -27,6 +30,13 @@ const file_utils_1 = require("../../utils/file-utils");
 const createRule = utils_1.ESLintUtils.RuleCreator(name => `https://github.com/trackunit/manager/blob/master/libs/eslint/plugin-trackunit/src/lib/rules/${name}/${name}.ts`);
 /** Canonical TODO marker. A landing page still containing this marker does NOT satisfy the rule. */
 exports.STORYBOOK_LANDING_PAGE_TODO_MARKER = "{/* TODO: storybook-folder-landing-page */}";
+/**
+ * The namespaced rule id (plugin `@trackunit/storybook`, rule `require-folder-landing-page`).
+ * Registered as the `require-folder-landing-page` entry of the shared `storybookPlugin` object
+ * (see `../../config/plugins.ts`). This is the id the deprecated alias below points at via
+ * `meta.deprecated.replacedBy`.
+ */
+exports.STORYBOOK_NAMESPACED_RULE_ID = "@trackunit/storybook/require-folder-landing-page";
 /**
  * Canonical permalink to the how-to-author doc. Single source of truth, embedded in the rule's
  * error message so developers tripping the rule get a direct link. The `master` permalink stays
@@ -157,82 +167,136 @@ const getTitleFromObject = (object) => {
     }
     return null;
 };
-exports.requireStorybookFolderLandingPage = createRule({
-    name: "require-storybook-folder-landing-page",
-    meta: {
-        type: "problem",
-        docs: {
-            description: "Require a Storybook landing page (*.docs.mdx) for every ancestor folder implied by a story's title",
-        },
-        schema: [],
-        messages: {
-            // URL embedded from the single-source-of-truth const (see STORYBOOK_LANDING_PAGE_DOCS_URL).
-            missingLandingPage: `[require-storybook-folder-landing-page] Missing Storybook landing page for folder "{{folder}}". The <Meta title> must equal "{{folder}}" exactly (no extra leaf). Add a *.docs.mdx with <Meta title="{{folder}}" /> and real content. See ${exports.STORYBOOK_LANDING_PAGE_DOCS_URL} for how to author one.`,
-        },
-    },
-    defaultOptions: [],
-    create(context) {
-        const currentFile = context.filename;
-        // Only analyze story files (never .docs.* or .mdx).
-        if (!STORY_FILE_REGEX.test(currentFile)) {
-            return {};
+/**
+ * The rule's `create` implementation, shared by every rule object below (the namespaced rule and
+ * the deprecated alias). Extracted to a standalone function so both `createRule(...)` calls
+ * delegate to the identical implementation instead of duplicating the detection/reporting logic.
+ */
+const create = context => {
+    const currentFile = context.filename;
+    // Only analyze story files (never .docs.* or .mdx).
+    if (!STORY_FILE_REGEX.test(currentFile)) {
+        return {};
+    }
+    const nxJsonPath = (0, file_utils_1.findNearestFile)(currentFile, "nx.json");
+    if (nxJsonPath === null) {
+        return {};
+    }
+    const workspaceRoot = path.dirname(nxJsonPath);
+    const reportForObject = (titleNode, reportNode) => {
+        const title = titleNode.value;
+        if (typeof title !== "string") {
+            return;
         }
-        const nxJsonPath = (0, file_utils_1.findNearestFile)(currentFile, "nx.json");
-        if (nxJsonPath === null) {
-            return {};
+        const folders = deriveFolders(title);
+        if (folders.length === 0) {
+            return;
         }
-        const workspaceRoot = path.dirname(nxJsonPath);
-        const reportForObject = (titleNode, reportNode) => {
-            const title = titleNode.value;
-            if (typeof title !== "string") {
-                return;
-            }
-            const folders = deriveFolders(title);
-            if (folders.length === 0) {
-                return;
+        const landingPages = getLandingPages(workspaceRoot);
+        for (const folder of folders) {
+            const entry = landingPages.get(folder);
+            if (isSatisfied(entry)) {
+                continue;
             }
-            const landingPages = getLandingPages(workspaceRoot);
-            for (const folder of folders) {
-                const entry = landingPages.get(folder);
-                if (isSatisfied(entry)) {
-                    continue;
+            context.report({
+                node: reportNode,
+                messageId: "missingLandingPage",
+                data: { folder },
+            });
+        }
+    };
+    return {
+        ExportDefaultDeclaration(node) {
+            const declaration = node.declaration;
+            // Shape 1: export default { title: "..." }
+            if (declaration.type === utils_1.AST_NODE_TYPES.ObjectExpression) {
+                const titleNode = getTitleFromObject(declaration);
+                if (titleNode) {
+                    reportForObject(titleNode, node);
                 }
-                context.report({
-                    node: reportNode,
-                    messageId: "missingLandingPage",
-                    data: { folder },
-                });
+                return;
             }
-        };
-        return {
-            ExportDefaultDeclaration(node) {
-                const declaration = node.declaration;
-                // Shape 1: export default { title: "..." }
-                if (declaration.type === utils_1.AST_NODE_TYPES.ObjectExpression) {
-                    const titleNode = getTitleFromObject(declaration);
-                    if (titleNode) {
-                        reportForObject(titleNode, node);
-                    }
-                    return;
-                }
-                // Shape 2: const meta = { title: "..." } satisfies Meta; export default meta;
-                if (declaration.type === utils_1.AST_NODE_TYPES.Identifier) {
-                    const variable = context.sourceCode
-                        .getScope(node)
-                        .references.find(ref => ref.identifier === declaration)?.resolved;
-                    const definition = variable?.defs[0];
-                    if (definition && definition.node.type === utils_1.AST_NODE_TYPES.VariableDeclarator && definition.node.init) {
-                        const initializer = unwrapExpression(definition.node.init);
-                        if (initializer.type === utils_1.AST_NODE_TYPES.ObjectExpression) {
-                            const titleNode = getTitleFromObject(initializer);
-                            if (titleNode) {
-                                reportForObject(titleNode, node);
-                            }
+            // Shape 2: const meta = { title: "..." } satisfies Meta; export default meta;
+            if (declaration.type === utils_1.AST_NODE_TYPES.Identifier) {
+                const variable = context.sourceCode
+                    .getScope(node)
+                    .references.find(ref => ref.identifier === declaration)?.resolved;
+                const definition = variable?.defs[0];
+                if (definition && definition.node.type === utils_1.AST_NODE_TYPES.VariableDeclarator && definition.node.init) {
+                    const initializer = unwrapExpression(definition.node.init);
+                    if (initializer.type === utils_1.AST_NODE_TYPES.ObjectExpression) {
+                        const titleNode = getTitleFromObject(initializer);
+                        if (titleNode) {
+                            reportForObject(titleNode, node);
                         }
                     }
                 }
-            },
-        };
+            }
+        },
+        // Shape 3 (CSF factory format): `<binding>.meta({ title: "..." })`, e.g.
+        // `const meta = preview.meta({ title: "Foo/Widget", component: Widget });`. Only the call
+        // shape is checked (a `.meta(...)` member call with an object-literal first argument) — this
+        // is purely additive: it does not change how the default-export shapes above are detected.
+        CallExpression(node) {
+            const { callee } = node;
+            if (callee.type !== utils_1.AST_NODE_TYPES.MemberExpression) {
+                return;
+            }
+            if (callee.property.type !== utils_1.AST_NODE_TYPES.Identifier || callee.property.name !== "meta") {
+                return;
+            }
+            const [firstArgument] = node.arguments;
+            if (firstArgument === undefined || firstArgument.type !== utils_1.AST_NODE_TYPES.ObjectExpression) {
+                return;
+            }
+            const titleNode = getTitleFromObject(firstArgument);
+            if (titleNode) {
+                reportForObject(titleNode, node);
+            }
+        },
+    };
+};
+/**
+ * Builds a fresh `meta` object for a landing-page rule object. Called once per rule object (never
+ * shared by reference) so the namespaced rule and the deprecated alias can carry different
+ * `deprecated` values without one mutating the other.
+ */
+const buildMeta = (deprecated) => ({
+    type: "problem",
+    docs: {
+        description: "Require a Storybook landing page (*.docs.mdx) for every ancestor folder implied by a story's title",
+    },
+    schema: [],
+    messages: {
+        // URL embedded from the single-source-of-truth const (see STORYBOOK_LANDING_PAGE_DOCS_URL).
+        missingLandingPage: `[require-storybook-folder-landing-page] Missing Storybook landing page for folder "{{folder}}". The <Meta title> must equal "{{folder}}" exactly (no extra leaf). Add a *.docs.mdx with <Meta title="{{folder}}" /> and real content. See ${exports.STORYBOOK_LANDING_PAGE_DOCS_URL} for how to author one.`,
     },
+    ...(deprecated === undefined ? {} : { deprecated }),
+});
+/**
+ * The namespaced rule: `@trackunit/storybook/require-folder-landing-page` (registered under that
+ * key in the shared `storybookPlugin` object exported from `../../config/plugins.ts`). This is
+ * the current, non-deprecated rule id.
+ */
+exports.requireFolderLandingPage = createRule({
+    name: "require-storybook-folder-landing-page",
+    meta: buildMeta(),
+    defaultOptions: [],
+    create,
+});
+/**
+ * Deprecated alias of {@link requireFolderLandingPage}, kept registered under the original
+ * `require-storybook-folder-landing-page` key in `rulesMap` (id `@trackunit/require-storybook-folder-landing-page`)
+ * so existing configs keep working. Delegates to the identical `create` implementation — only the
+ * `meta` differs (marks itself deprecated and points at the namespaced replacement).
+ */
+exports.requireStorybookFolderLandingPage = createRule({
+    name: "require-storybook-folder-landing-page",
+    meta: buildMeta({
+        message: `Use \`${exports.STORYBOOK_NAMESPACED_RULE_ID}\` instead.`,
+        replacedBy: [{ rule: { name: exports.STORYBOOK_NAMESPACED_RULE_ID } }],
+    }),
+    defaultOptions: [],
+    create,
 });
 //# sourceMappingURL=require-storybook-folder-landing-page.js.map