@trackunit/eslint-plugin-trackunit 0.6.165 → 0.6.167

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 0.6.167 (2026-10-07)
+
+### 🧱 Updated Dependencies
+
+- Updated css-classname-utils to 0.0.68
+- Updated shared-utils to 1.19.2
+
+## 0.6.166 (2026-10-07)
+
+### 🧱 Updated Dependencies
+
+- Updated css-classname-utils to 0.0.67
+- Updated shared-utils to 1.19.1
+
 ## 0.6.165 (2026-10-06)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -97,7 +97,7 @@ project.
 | ----------------------------------------------------- | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
 | `@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({...})`). |
+| `@trackunit/storybook/require-csf-factory`            | error                  | 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({...})`). |
 | `@trackunit/storybook/no-local-meta-component`        | error                  | no       | Detection-only: flags a meta `component` (in `export default {...}`, `const meta = {...}; export default meta`, or any `<binding>.meta({...})`) that resolves to a function/class declared in the story file, an inline component, a wrapper call around a local (`memo(Local)`), or an import from another `*.stories` module. Docgen skips `*.stories.*`, so Controls loses JSDoc prop descriptions and "Show code" names a story-only identifier. Fix by pointing at the real component (`component: MultiSelectField<Option>` for generics) or moving the demo into a sibling `*.demo.tsx`. |
 | `storybook/*` (upstream `eslint-plugin-storybook@^10.6.0` `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. |
 
@@ -113,7 +113,7 @@ module.exports = [
   {
     rules: {
       "@trackunit/storybook/require-folder-landing-page": "error",
-      "@trackunit/storybook/require-csf-factory": "warn",
+      "@trackunit/storybook/require-csf-factory": "error",
       "@trackunit/storybook/no-local-meta-component": "error",
     },
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/eslint-plugin-trackunit",
-  "version": "0.6.165",
+  "version": "0.6.167",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {
@@ -8,9 +8,9 @@
   },
   "dependencies": {
     "@nx/eslint-plugin": "23.1.0",
-    "@trackunit/css-classname-utils": "0.0.66",
-    "@typescript-eslint/eslint-plugin": "8.58.1",
-    "@typescript-eslint/utils": "8.58.1",
+    "@trackunit/css-classname-utils": "0.0.68",
+    "@typescript-eslint/eslint-plugin": "8.70.1",
+    "@typescript-eslint/utils": "8.70.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "2.32.0",
     "eslint-plugin-jest": "^29.15.2",

package/src/lib/config/fragments/module-boundaries.js

@@ -5,7 +5,8 @@ exports.moduleBoundaryRules = {
     "@nx/enforce-module-boundaries": [
         "error",
         {
-            allow: [],
+            // Ambient alias for the loading Storybook's preview (`typings/storybook-preview.d.ts`), not a project.
+            allow: ["@trackunit/storybook/preview"],
             depConstraints: [
                 {
                     sourceTag: "type:app",

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

@@ -1,5 +1,5 @@
 /**
- * Warn when a `*.stories.*` file is written in the legacy CSF (Component Story Format)
+ * Report a `*.stories.*` file 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
@@ -11,7 +11,8 @@
  *   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
+ *   `const meta = preview.meta({ component, title });`) or
+ *   `<importedBinding>.type<{ args }>().meta({...})`, 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

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

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Warn when a `*.stories.*` file is written in the legacy CSF (Component Story Format)
+ * Report a `*.stories.*` file 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
@@ -12,7 +12,8 @@
  *   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
+ *   `const meta = preview.meta({ component, title });`) or
+ *   `<importedBinding>.type<{ args }>().meta({...})`, 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
@@ -75,28 +76,48 @@ const isAnalyzableStoryFile = (filename) => {
     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.
+ * The `<identifier>` a `.meta(...)` call is made on: `preview` in `preview.meta(...)` and in the
+ * typed escape hatch `preview.type<{ args }>().meta(...)`. Null for any other receiver.
+ */
+const getMetaReceiver = (receiver) => {
+    if (receiver.type === utils_1.AST_NODE_TYPES.Identifier) {
+        return receiver;
+    }
+    if (receiver.type === utils_1.AST_NODE_TYPES.CallExpression &&
+        receiver.arguments.length === 0 &&
+        receiver.callee.type === utils_1.AST_NODE_TYPES.MemberExpression &&
+        !receiver.callee.computed &&
+        receiver.callee.object.type === utils_1.AST_NODE_TYPES.Identifier &&
+        receiver.callee.property.type === utils_1.AST_NODE_TYPES.Identifier &&
+        receiver.callee.property.name === "type") {
+        return receiver.callee.object;
+    }
+    return null;
+};
+/**
+ * True for a call `<identifier>.meta({...})` or `<identifier>.type<…>().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") {
+    if (callee.computed || 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) {
+    const receiver = getMetaReceiver(callee.object);
+    if (receiver === null) {
         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;
+    const scope = context.sourceCode.getScope(receiver);
+    const variable = scope.references.find(ref => ref.identifier === receiver)?.resolved;
     if (!variable) {
         return false;
     }
@@ -170,7 +191,7 @@ exports.requireCsfFactory = createRule({
     meta: {
         type: "problem",
         docs: {
-            description: "Warn on Storybook story files that are not written in CSF factory format",
+            description: "Report Storybook story files that are not written in CSF factory format",
         },
         schema: [],
         messages: {