eslint-plugin-kerfjs 5.0.0-beta.88 → 5.0.0-beta.89

package/docs/rules/ui-wiring.md

@@ -8,7 +8,15 @@ Declare application entry modules in the application UI profile to check root wi
 { "schemaVersion": 1, "scope": "workspace", "wiring": { "entries": ["src/main.tsx"] } }
 ```
 
-Entry paths are relative to the workspace root. The rule follows relative imports, re-exports, and literal dynamic imports from each entry. An application-scoped obligation is checked at the entry if any reachable module renders its component; a recognized helper call in any reachable module satisfies it. Reachable leaf modules need no duplicate wiring. A module outside every declared entry keeps the per-file check. A composition entry can set `wiring.scope` to `"module"` for a helper that must be installed beside its rendering code; omitted scope means `"application"`. Computed import paths and unresolved modules stay outside the static graph, so put them in a declared entry or check them separately. `KUI-L402` still checks the helper's call site.
+Entry paths are relative to the workspace root. The rule follows relative imports, re-exports, and literal dynamic imports from each entry. An application-scoped obligation is checked at the entry if any reachable module renders its component; a recognized helper call or required registration import in any reachable module satisfies it. Reachable leaf modules need no duplicate wiring. A module outside every declared entry keeps the per-file check. A composition entry can set `wiring.scope` to `"module"` for wiring that must be installed beside its rendering code; omitted scope means `"application"`. Computed import paths and unresolved modules stay outside the static graph, so put them in a declared entry or check them separately. `KUI-L402` still checks the helper's call site.
+
+For a page-lifetime root helper, declare the actual app entry in the workspace `.kerf-ui-profile.json`. For example, if `src/client/app.tsx` imports `init.ts`, `init.ts` calls `wireShellSearch(root)`, and that imported helper calls `wireTokenSearchFields(root)`, use:
+
+```json
+{ "schemaVersion": 1, "scope": "workspace", "wiring": { "entries": ["src/client/app.tsx"] } }
+```
+
+The entry graph then covers a `TokenSearchField` in an imported view without duplicate wiring in that view. Include every independently mounted application entry. The path must resolve through relative imports from each entry to both the view and the helper; merely naming the helper in the profile does not count as invoking it.
 
 Consumer composition catalogs can name an application helper's defining file in `wiring.sources`:
 

package/index.js

@@ -14,7 +14,7 @@ import uiPublicBoundaries from './lib/rules/ui-public-boundaries.js';
 import uiWiring from './lib/rules/ui-wiring.js';
 
 const plugin = {
-  meta: { name: 'eslint-plugin-kerfjs', version: '5.0.0-beta.88' },
+  meta: { name: 'eslint-plugin-kerfjs', version: '5.0.0-beta.89' },
   rules: {
     'no-inline-jsx-event-handlers': noInlineJsxEventHandlers,
     'no-raw-with-dynamic-arg': noRawWithDynamicArg,

package/lib/rules/ui-wiring.js

@@ -21,6 +21,16 @@ const script = /\.(?:[cm]?[jt]sx?)$/;
 const imports =
   /(?:^|[;\n])\s*(?:import|export)\s+(?:[^;'"`]*?\s+from\s*)?['"]([^'"]+)['"]/g;
 const dynamicImports = /\bimport\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+const staticImports =
+  /(?:^|[;\n])\s*import\s+(?:[^;'"`]*?\s+from\s*)?['"]([^'"]+)['"]/g;
+
+function moduleImportSources(source) {
+  const withoutComments = source.replace(
+    /\/\*[\s\S]*?\*\/|\/\/[^\n]*/g,
+    (comment) => comment.replace(/[^\n]/g, ' '),
+  );
+  return [...withoutComments.matchAll(staticImports)].map((match) => match[1]);
+}
 
 function entryModules(entryFile, currentFile, currentText) {
   const modules = new Map();
@@ -223,11 +233,15 @@ export default {
         );
         const ownEntry = entries.find(({ file }) => file === filename);
         const reachableCalls = new Set(calls.keys());
+        const reachableImports = new Set(registry.sources);
         if (ownEntry)
           for (const [file, source] of ownEntry.modules)
-            if (file !== filename)
+            if (file !== filename) {
+              for (const imported of moduleImportSources(source))
+                reachableImports.add(imported);
               for (const helper of moduleCalls(source, file, contract))
                 reachableCalls.add(helper);
+            }
         const required = new Map(used);
         if (ownEntry)
           for (const [file, source] of ownEntry.modules)
@@ -242,7 +256,11 @@ export default {
           for (const helper of entry.wiring.helpers) {
             if (helper.startsWith('@')) {
               if (
-                !registry.sources.has(helper) &&
+                !(
+                  entry.wiring.scope === 'module'
+                    ? registry.sources
+                    : reachableImports
+                ).has(helper) &&
                 !isExcepted(contract, MISSING_CODE, filename)
               )
                 context.report({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-kerfjs",
-  "version": "5.0.0-beta.88",
+  "version": "5.0.0-beta.89",
   "description": "ESLint rules that enforce kerf's hard rules — catches AI-shaped bugs at edit time.",
   "type": "module",
   "license": "MIT",