@sidebase/base-config 0.3.3 → 0.3.4

package/README.md

@@ -176,7 +176,7 @@ TypeScript config file) in your devDependencies; `sync` adds both.
 | `trpcGuard` | `false` | Ban `publicProcedure` in `server/trpc/routers/**` |
 | `prismaImportGuard` | `false` | Ban `~~/prisma/` client imports outside server code |
 | `typeDefStyle` | `"interface"` | Prefer `interface` or `type` |
-| `autoImportPaths` | `["utils/", "composables/", "~~/shared/types/"]` | Paths Nuxt auto-imports, so direct imports are banned |
+| `autoImportPaths` | `["utils/", "composables/", "~~/shared/types/"]` | Paths Nuxt auto-imports, so direct imports are banned in app code. The defaults cover `app/utils`, `shared/utils`, `app/composables` and `shared/types` under every Nuxt alias. Files in the root (or `layers/*`) `server/` and `shared/` dirs and relative imports are never matched |
 | `autoImportTypeOnly` | `[]` | Of those, paths where `import type` stays allowed |
 | `ignoresTypeAware` | config files | Files excluded from type-aware linting |
 | `testFilePattern` | `*.test`, `*.spec`, `*.stories` | Files where the `process.env` and auto-import bans are off |

package/dist/eslint/index.d.mts

@@ -12,7 +12,12 @@ interface CreateSidebaseEslintOptions {
     prismaImportGuard?: boolean;
     /** `ts/consistent-type-definitions`. Default `"interface"`. */
     typeDefStyle?: "interface" | "type";
-    /** Paths banned from direct import (Nuxt auto-import). Default `["utils/", "composables/", "~~/shared/types/"]`. */
+    /**
+     * Paths banned from direct import (Nuxt auto-import). Default `["utils/", "composables/", "~~/shared/types/"]`.
+     * The defaults expand to the Nuxt 4 app-side dirs (`app/` and `shared/` utils) under every
+     * default alias. Paths starting with `~`, `@`, `#`, `/`, `./` or `../` are used as-is.
+     * Not applied to files in the root (or `layers/*`) `server/` and `shared/` dirs.
+     */
     autoImportPaths?: string[];
     /**
      * Subset of {@link autoImportPaths} where `import type { ... }` is still allowed

package/dist/eslint/index.d.ts

@@ -12,7 +12,12 @@ interface CreateSidebaseEslintOptions {
     prismaImportGuard?: boolean;
     /** `ts/consistent-type-definitions`. Default `"interface"`. */
     typeDefStyle?: "interface" | "type";
-    /** Paths banned from direct import (Nuxt auto-import). Default `["utils/", "composables/", "~~/shared/types/"]`. */
+    /**
+     * Paths banned from direct import (Nuxt auto-import). Default `["utils/", "composables/", "~~/shared/types/"]`.
+     * The defaults expand to the Nuxt 4 app-side dirs (`app/` and `shared/` utils) under every
+     * default alias. Paths starting with `~`, `@`, `#`, `/`, `./` or `../` are used as-is.
+     * Not applied to files in the root (or `layers/*`) `server/` and `shared/` dirs.
+     */
     autoImportPaths?: string[];
     /**
      * Subset of {@link autoImportPaths} where `import type { ... }` is still allowed

package/dist/eslint/index.mjs

@@ -35,6 +35,8 @@ const TRPC_ROUTERS_GLOB = "**/server/trpc/routers/**/*.{ts,js}";
 const ZOD_DEPRECATED_METHODS = ["extend", "merge", "passthrough"];
 const APP_FILES = ["**/*.{ts,vue}"];
 const APP_IGNORES = ["**/*.d.ts"];
+const SHARED_FILES = ["shared/**/*.{ts,vue}", "layers/*/shared/**/*.{ts,vue}"];
+const SERVER_FILES = ["server/**/*.{ts,vue}", "layers/*/server/**/*.{ts,vue}"];
 const PROCESS_ENV_PROPERTY = {
   object: "process",
   property: "env",
@@ -71,12 +73,26 @@ function zodImportStyleBans(options) {
     { selector: `ExportNamedDeclaration[source.value=${ZOD_SOURCE}][exportKind!='type'] ExportSpecifier[local.name='z'][exportKind!='type']`, message: ZOD_IMPORT_STYLE_MESSAGE }
   ];
 }
+const NUXT_AUTO_IMPORT_GLOBS = /* @__PURE__ */ new Map([
+  ["utils", [
+    "~/utils/**",
+    "@/utils/**",
+    "~~/app/utils/**",
+    "@@/app/utils/**",
+    "~~/shared/utils/**",
+    "@@/shared/utils/**",
+    "#shared/utils/**"
+  ]],
+  ["composables", ["~/composables/**", "@/composables/**", "~~/app/composables/**", "@@/app/composables/**"]],
+  ["~~/shared/types", ["~~/shared/types/**", "@@/shared/types/**", "#shared/types/**"]]
+]);
+function escapeGlob(glob) {
+  return glob.replace(/^#/, "\\#");
+}
 function anchoredGlobs(rawPath) {
   const path = rawPath.replace(/\/+$/, "");
-  if (/^(?:[~@#/]|\.{1,2}\/)/.test(path)) {
-    return [`${path}/**`];
-  }
-  return [`~/${path}/**`, `~~/${path}/**`, `@/${path}/**`];
+  const [first, ...rest] = NUXT_AUTO_IMPORT_GLOBS.get(path) ?? (/^(?:[~@#/]|\.{1,2}\/)/.test(path) ? [`${path}/**`] : [`~/${path}/**`, `~~/${path}/**`, `@/${path}/**`]);
+  return [escapeGlob(first), ...rest.map(escapeGlob)];
 }
 function importRestrictions(options) {
   const paths = [
@@ -150,18 +166,27 @@ function buildEslintLayers(options) {
     }
   });
   const { paths, patterns } = importRestrictions(options);
-  const appRules = {
-    "no-restricted-properties": ["error", PROCESS_ENV_PROPERTY]
-  };
-  if (paths.length > 0 || patterns.length > 0) {
-    appRules["ts/no-restricted-imports"] = ["error", { paths, patterns }];
+  const prismaPatterns = options.prismaImportGuard ? [{
+    group: ["~~/prisma/*", "~~/prisma/**"],
+    message: "Do not import the Prisma client on the app side. Use a server-only module."
+  }] : [];
+  const scopes = [
+    ["sidebase/restricted-app", APP_FILES, [...patterns, ...prismaPatterns]],
+    ["sidebase/restricted-shared", SHARED_FILES, prismaPatterns],
+    // Server code legitimately imports the Prisma client.
+    ["sidebase/restricted-server", SERVER_FILES, []]
+  ];
+  for (const [name, files, scopePatterns] of scopes) {
+    configs.push({
+      name,
+      files,
+      ignores: APP_IGNORES,
+      rules: {
+        "no-restricted-properties": ["error", PROCESS_ENV_PROPERTY],
+        "ts/no-restricted-imports": ["error", scopePatterns.length > 0 ? { paths, patterns: scopePatterns } : { paths }]
+      }
+    });
   }
-  configs.push({
-    name: "sidebase/restricted-app",
-    files: APP_FILES,
-    ignores: APP_IGNORES,
-    rules: appRules
-  });
   const zodSyntax = [...zodImportStyleBans(options), ...zodMethodBans(options)];
   if (zodSyntax.length > 0) {
     configs.push({
@@ -180,18 +205,6 @@ function buildEslintLayers(options) {
       rules: { "no-restricted-syntax": ["error", ...zodSyntax, PUBLIC_PROCEDURE_SELECTOR] }
     });
   }
-  if (options.prismaImportGuard) {
-    const prismaPattern = {
-      group: ["~~/prisma/*", "~~/prisma/**"],
-      message: "Do not import the Prisma client on the app side. Use a server-only module."
-    };
-    configs.push({
-      name: "sidebase/prisma-import-guard",
-      files: APP_FILES,
-      ignores: [...APP_IGNORES, "**/server/**"],
-      rules: { "ts/no-restricted-imports": ["error", { paths, patterns: [...patterns, prismaPattern] }] }
-    });
-  }
   if (options.testFilePattern.length > 0) {
     configs.push({
       name: "sidebase/test-overrides",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sidebase/base-config",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Shared @sidebase base configuration for Nuxt repos: ESLint / Prisma / tsconfig factories on npm, plus the streamctl file-sync preset payload",
   "keywords": [
     "sidebase",