@zedtech/zedkit-quality 0.2.0 → 0.3.0

package/README.md

@@ -55,10 +55,13 @@ subagents, commands) see `@zedtech/zedkit-ai` instead.
   jsx-a11y recommended, Tailwind hygiene, tokens-only classes, no `style`
   attributes, no raw `try`/`catch`. `entryPoint` (your Tailwind CSS
   entry) is required: it is the one thing that varies per repo.
-- `defineLayers({ kitPackage, viewDirs, dataDirs, actionPatterns })` —
+- `defineLayers({ kitPackage, viewDirs, dataDirs, actionPatterns, extraPatterns })` —
   `no-restricted-imports` blocks for routes -> views -> data: the UI kit
   is only imported from views, views never import data clients or
-  actions, data files import no UI.
+  actions, data files import no UI. `extraPatterns` (optional,
+  `{ kitScope?, viewData?, dataUi? }`) merges your own bans into each
+  block — use it instead of a second `no-restricted-imports` block,
+  which would replace these per flat-config key semantics.
 - `@zedtech/zedkit-quality/tsconfig` — the strict base (`strict`,
   `exactOptionalPropertyTypes`, `noUncheckedIndexedAccess`,
   `noUnusedLocals`, and more). Extend it, do not copy it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zedtech/zedkit-quality",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"

package/src/eslint.d.mts

@@ -7,6 +7,14 @@ export interface UiPresetOptions {
 
 export function uiPreset(options: UiPresetOptions): Linter.Config[];
 
+/** A `no-restricted-imports` pattern object, passed through untouched. */
+export interface RestrictedImportPattern {
+  readonly group: readonly string[];
+  readonly message: string;
+  readonly importNames?: readonly string[];
+  readonly allowTypeImports?: boolean;
+}
+
 export interface DefineLayersOptions {
   /** UI kit specifier (e.g. `@acme/ui`). */
   readonly kitPackage: string;
@@ -16,6 +24,16 @@ export interface DefineLayersOptions {
   readonly dataDirs: readonly string[];
   /** Import specifiers for data clients and server actions. */
   readonly actionPatterns: readonly string[];
+  /**
+   * Consumer bans merged into each block's own patterns (flat-config
+   * rules replace per key, so a consumer block setting
+   * `no-restricted-imports` would otherwise drop these).
+   */
+  readonly extraPatterns?: {
+    readonly kitScope?: readonly RestrictedImportPattern[];
+    readonly viewData?: readonly RestrictedImportPattern[];
+    readonly dataUi?: readonly RestrictedImportPattern[];
+  };
 }
 
 export function defineLayers(options: DefineLayersOptions): Linter.Config[];

package/src/eslint.mjs

@@ -116,17 +116,31 @@ function asFiles(patterns) {
  * - views receive data as props and never import data clients or actions;
  * - data files import no UI (no React runtime, no UI kit).
  *
- * @param {{ kitPackage: string, viewDirs: string[], dataDirs: string[], actionPatterns: string[] }} options
+ * @param {{ kitPackage: string, viewDirs: string[], dataDirs: string[], actionPatterns: string[], extraPatterns?: { kitScope?: object[], viewData?: object[], dataUi?: object[] } }} options
  * - `kitPackage`: UI kit specifier (e.g. `@acme/ui`).
  * - `viewDirs`: view folders (e.g. `app/ui/**`) or file globs.
  * - `dataDirs`: data-access folders or file globs, same shapes.
  * - `actionPatterns`: import specifiers for data clients and server actions.
+ * - `extraPatterns`: consumer bans merged into each block's own
+ *   patterns (flat-config rules replace per key, so a consumer block
+ *   setting `no-restricted-imports` would otherwise drop these).
+ *   Keys: `kitScope`, `viewData`, `dataUi`; each a list of standard
+ *   `no-restricted-imports` pattern objects, passed through untouched.
  * @returns {import("eslint").Linter.Config[]} Flat config blocks.
  */
-export function defineLayers({ kitPackage, viewDirs, dataDirs, actionPatterns }) {
+export function defineLayers({ kitPackage, viewDirs, dataDirs, actionPatterns, extraPatterns = {} }) {
+  for (const [key, value] of Object.entries(extraPatterns)) {
+    if (key !== "kitScope" && key !== "viewData" && key !== "dataUi") {
+      throw new Error(`defineLayers: unknown extraPatterns key "${key}" (want kitScope, viewData or dataUi)`);
+    }
+    if (!Array.isArray(value)) {
+      throw new Error(`defineLayers: extraPatterns.${key} must be a list of no-restricted-imports pattern objects`);
+    }
+  }
   const kitPatterns = [kitPackage, `${kitPackage}/*`];
   const views = asFiles(viewDirs);
   const data = asFiles(dataDirs);
+  const extras = { kitScope: [], viewData: [], dataUi: [], ...extraPatterns };
   return [
     {
       name: "zedkit/layers-kit-scope",
@@ -141,6 +155,7 @@ export function defineLayers({ kitPackage, viewDirs, dataDirs, actionPatterns })
                 group: kitPatterns,
                 message: "UI kit imports are only allowed from view files. Move this import into a view.",
               },
+              ...extras.kitScope,
             ],
           },
         ],
@@ -158,6 +173,7 @@ export function defineLayers({ kitPackage, viewDirs, dataDirs, actionPatterns })
                 group: [...actionPatterns],
                 message: "Views receive data as props and never import data clients or server actions.",
               },
+              ...extras.viewData,
             ],
           },
         ],
@@ -179,6 +195,7 @@ export function defineLayers({ kitPackage, viewDirs, dataDirs, actionPatterns })
                 group: kitPatterns,
                 message: "Data code is UI-free: no UI kit imports.",
               },
+              ...extras.dataUi,
             ],
           },
         ],