akanjs 2.0.0-rc.0 → 2.0.0-rc.2

package/cli/index.js

@@ -9346,7 +9346,7 @@ import {
   fork,
   spawn
 } from "child_process";
-import { mkdir as mkdir2, stat as stat2 } from "fs/promises";
+import { mkdir as mkdir2, readdir as readDirEntries, stat as stat2 } from "fs/promises";
 import path7 from "path";
 import chalk4 from "chalk";
 
@@ -11074,7 +11074,7 @@ class Executor {
       const fileContent = await this.#applyTemplateFile({ templatePath: prefixTemplatePath, targetPath: path7.join(basePath2, filename), scanInfo, overwrite }, dict, options);
       return fileContent ? [fileContent] : [];
     } else {
-      const subdirs = await this.readdir(templatePath);
+      const subdirs = await readDirEntries(templatePath);
       const fileContents = (await Promise.all(subdirs.map(async (subdir) => {
         const subpath = path7.join(templatePath, subdir);
         if ((await stat2(subpath)).isFile()) {
@@ -11198,6 +11198,9 @@ class WorkspaceExecutor extends Executor {
     if (type === "lib" || type === "pkg")
       rootTsConfig.compilerOptions.paths[`@${name}`] = [`${type}s/${name}/index.ts`];
     rootTsConfig.compilerOptions.paths[`@${name}/*`] = [`${type}s/${name}/*`];
+    rootTsConfig.compilerOptions.paths[`@${type}s/${name}/*`] = [`${type}s/${name}/*`];
+    if (type === "lib" || type === "pkg")
+      rootTsConfig.compilerOptions.paths[`@${type}s/${name}`] = [`${type}s/${name}/index.ts`];
     if (rootTsConfig.references) {
       if (!rootTsConfig.references.some((ref) => ref.path === `./${type}s/${name}/tsconfig.json`))
         rootTsConfig.references.push({ path: `./${type}s/${name}/tsconfig.json` });
@@ -11207,7 +11210,7 @@ class WorkspaceExecutor extends Executor {
   }
   async unsetTsPaths(type, name) {
     const rootTsConfig = await this.readJson("tsconfig.json");
-    const filteredKeys = Object.keys(rootTsConfig.compilerOptions.paths ?? {}).filter((key) => !key.startsWith(`@${name}`));
+    const filteredKeys = Object.keys(rootTsConfig.compilerOptions.paths ?? {}).filter((key) => !key.startsWith(`@${name}`) && !key.startsWith(`@${type}s/${name}`));
     rootTsConfig.compilerOptions.paths = Object.fromEntries(filteredKeys.map((key) => [key, rootTsConfig.compilerOptions.paths?.[key] ?? []]));
     if (rootTsConfig.references) {
       rootTsConfig.references = rootTsConfig.references.filter((ref) => !ref.path.startsWith(`./${type}s/${name}`));
@@ -12737,6 +12740,8 @@ class BarrelAnalyzer {
     const rel = path12.relative(pkg.pkgDir, absFile);
     if (!rel || rel.startsWith("..") || path12.isAbsolute(rel))
       return null;
+    if (pkg.preserveFilePath)
+      return `${pkg.pkgName}/${rel.split(path12.sep).join("/")}`;
     const noExt = stripKnownExt(rel);
     const tail = collapseIndex(noExt);
     if (tail === "")
@@ -12817,7 +12822,7 @@ var collapseIndex = (relPathNoExt) => {
 
 import path13 from "path";
 import ts3 from "typescript";
-var createBarrelImportsPlugin = async (app, { skipPath = (p) => p.includes("node_modules"), pipeAfter } = {}) => {
+var createBarrelImportsPlugin = async (app, { skipPath = defaultSkipPath, pipeAfter } = {}) => {
   const akanConfig2 = await app.getConfig();
   const barrels = [...new Set(akanConfig2.barrelImports)].filter(Boolean);
   const analyzer = new BarrelAnalyzer({
@@ -12826,7 +12831,9 @@ var createBarrelImportsPlugin = async (app, { skipPath = (p) => p.includes("node
   return {
     name: "barrel-imports",
     setup(build) {
-      build.onLoad({ filter: /^(?!.*[\\/]node_modules[\\/]).*\.(tsx|ts|jsx|js)(\?v=\d+)?$/ }, async (args) => {
+      build.onLoad({
+        filter: /^(?:(?!.*[\\/]node_modules[\\/]).*|.*[\\/]node_modules[\\/]akanjs[\\/].*)\.(tsx|ts|jsx|js)(\?v=\d+)?$/
+      }, async (args) => {
         const realPath = args.path.replace(/\?v=\d+$/, "");
         const loader = loaderFor(realPath);
         if (skipPath(realPath)) {
@@ -12936,6 +12943,9 @@ var createTsconfigPackageResolver = async (app) => {
   };
 };
 var CANDIDATE_EXTS2 = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
+var NODE_MODULES_RE = /[\\/]node_modules[\\/]/;
+var AKANJS_NODE_MODULE_RE = /[\\/]node_modules[\\/]akanjs[\\/]/;
+var defaultSkipPath = (absPath) => NODE_MODULES_RE.test(absPath) && !AKANJS_NODE_MODULE_RE.test(absPath);
 var resolveNodePackageExport = async (workspaceRoot, specifier) => {
   const packageName = getPackageName(specifier);
   if (!packageName)
@@ -12947,7 +12957,7 @@ var resolveNodePackageExport = async (workspaceRoot, specifier) => {
     const pkgDir = path13.dirname(pkgJsonPath);
     const pkgJson = JSON.parse(await Bun.file(pkgJsonPath).text());
     const subpath = specifier === packageName ? "." : `.${specifier.slice(packageName.length)}`;
-    const exported = resolveExportValue(pkgJson.exports?.[subpath]);
+    const exported = resolvePackageExport(pkgJson.exports, subpath);
     const rel = exported ?? (subpath === "." ? pkgJson.module ?? pkgJson.main ?? "index.js" : null);
     if (!rel || !rel.startsWith("."))
       return null;
@@ -12955,7 +12965,7 @@ var resolveNodePackageExport = async (workspaceRoot, specifier) => {
     if (!entryFile)
       return null;
     const pkgEntryName = specifier;
-    return { pkgName: pkgEntryName, entryFile, pkgDir: path13.dirname(entryFile) };
+    return { pkgName: pkgEntryName, entryFile, pkgDir: path13.dirname(entryFile), preserveFilePath: true };
   } catch {
     return null;
   }
@@ -12980,6 +12990,27 @@ var resolveExportValue = (value) => {
   }
   return null;
 };
+var resolvePackageExport = (exportsMap, subpath) => {
+  if (!exportsMap)
+    return null;
+  const exact = resolveExportValue(exportsMap[subpath]);
+  if (exact)
+    return exact;
+  for (const [key, value] of Object.entries(exportsMap)) {
+    const starIdx = key.indexOf("*");
+    if (starIdx === -1)
+      continue;
+    const prefix = key.slice(0, starIdx);
+    const suffix = key.slice(starIdx + 1);
+    if (!subpath.startsWith(prefix) || !subpath.endsWith(suffix))
+      continue;
+    const wildcard = subpath.slice(prefix.length, subpath.length - suffix.length);
+    const resolved = resolveExportValue(value);
+    if (resolved)
+      return resolved.replace("*", wildcard);
+  }
+  return null;
+};
 var getPackageName = (specifier) => {
   const parts = specifier.split("/");
   if (!parts[0])
@@ -13173,7 +13204,10 @@ var loaderFor = (absPath) => {
 
 var USE_CLIENT_RE = /^\s*(?:\/\*[\s\S]*?\*\/\s*|\/\/[^\n]*\n\s*)*["']use client["']/;
 var SOURCE_EXTS2 = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
+var NODE_MODULES_RE2 = /[\\/]node_modules[\\/]/;
+var AKANJS_NODE_MODULE_RE2 = /[\\/]node_modules[\\/]akanjs[\\/]/;
 var NON_SOURCE_EXT_RE2 = /\.(css|scss|sass|less|json|svg|png|jpe?g|webp|gif|avif|ico|woff2?|ttf|otf|mp3|mp4|wav)$/i;
+var shouldSkipNodeModule = (absPath) => NODE_MODULES_RE2.test(absPath) && !AKANJS_NODE_MODULE_RE2.test(absPath);
 
 class GraphClientEntryDiscovery {
   #akanConfig;
@@ -13310,7 +13344,7 @@ class GraphClientEntryDiscovery {
     const cached = this.#reachableEntriesCache.get(absPath);
     if (cached)
       return new Set(cached);
-    if (visiting.has(absPath) || absPath.includes("node_modules"))
+    if (visiting.has(absPath) || shouldSkipNodeModule(absPath))
       return new Set;
     visiting.add(absPath);
     const entries = new Set;
@@ -13333,7 +13367,7 @@ class GraphClientEntryDiscovery {
       const resolved = await this.#resolveSpecifier(spec, importerDir);
       if (!resolved)
         continue;
-      if (resolved.includes("node_modules"))
+      if (shouldSkipNodeModule(resolved))
         continue;
       for (const entry of await this.#discoverFromFile(resolved, visiting))
         entries.add(entry);

package/cli/templates/app/env/env.server.debug.ts.template

@@ -1,10 +1,7 @@
-import { getEnv() } from "akanjs/base";
+import { getEnv } from "akanjs/base";
 
 import type { ModulesOptions } from "../lib/option";
 
 export const env: ModulesOptions = {
   ...getEnv(),
-  hostname: null,
-  redis: {},
-  
 };

package/cli/templates/workspaceRoot/.env.template

@@ -1,5 +1,7 @@
 # organization configuration, no need to change
 AKAN_PUBLIC_REPO_NAME=<%= repoName %>
+
+# serve domain, it changes the domain of the server.
 AKAN_PUBLIC_SERVE_DOMAIN="<%= serveDomain %>"
 
 # development branch, debug, develop, main, etc. mainly it changes databases.
@@ -7,14 +9,6 @@ AKAN_PUBLIC_ENV=local
 
 # local, cloud, edge it changes the connection point of the clients.
 AKAN_PUBLIC_OPERATION_MODE=local
-# hybrid app specific config, will be depreciated in the future
-APP_OPERATION_MODE=local
-
-# backend service mode, federation, batch, all
-SERVER_MODE=federation
-
-# analyze the bundle size
-ANALYZE=false
 
 # log level, debug, info, warn, error
 AKAN_PUBLIC_LOG_LEVEL=debug

package/cli/templates/workspaceRoot/biome.json.template

@@ -0,0 +1,175 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": false
+  },
+  "files": {
+    "includes": [
+      "**/*.ts",
+      "**/*.tsx",
+      "**/*.json",
+      "**/*.jsonc",
+      "!**/env.client.local.ts",
+      "!**/env.client.debug.ts",
+      "!**/env.client.develop.ts",
+      "!**/env.client.main.ts",
+      "!**/env.client.testing.ts",
+      "!**/env.server.local.ts",
+      "!**/env.server.develop.ts",
+      "!**/env.server.main.ts",
+      "!**/env.server.testing.ts",
+      "!**/env.server.type.ts",
+      "!apps/*/lib/cnst.ts",
+      "!apps/*/lib/dict.ts",
+      "!apps/*/lib/db.ts",
+      "!apps/*/lib/srv.ts",
+      "!apps/*/lib/st.ts",
+      "!apps/*/lib/sig.ts",
+      "!apps/*/lib/useClient.ts",
+      "!apps/*/lib/useServer.ts",
+      "!apps/*/client.ts",
+      "!apps/*/server.ts",
+      "!apps/*/lib/*/index.tsx",
+      "!libs/*/lib/cnst.ts",
+      "!libs/*/lib/dict.ts",
+      "!libs/*/lib/db.ts",
+      "!libs/*/lib/srv.ts",
+      "!libs/*/lib/st.ts",
+      "!libs/*/lib/sig.ts",
+      "!libs/*/lib/useClient.ts",
+      "!libs/*/lib/useServer.ts",
+      "!libs/*/client.ts",
+      "!libs/*/server.ts",
+      "!libs/*/index.ts",
+      "!libs/*/lib/*/index.tsx",
+      "!infra/master/createRecords.ts",
+      "!pkgs/contract/env.ts",
+      "!!**/node_modules",
+      "!!**/dist",
+      "!!**/.akan",
+      "!!**/dump",
+      "!!**/local"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noConsole": {
+          "level": "error",
+          "options": {
+            "allow": ["assert", "error", "info", "warn"]
+          }
+        },
+        "noArrayIndexKey": "off",
+        "noShadowRestrictedNames": "off"
+      },
+      "correctness": {
+        "noUnusedFunctionParameters": "off",
+        "noUnusedImports": {
+          "level": "error",
+          "fix": "safe"
+        },
+        "useParseIntRadix": "off",
+        "useExhaustiveDependencies": "off"
+      },
+      "nursery": {
+        "useSortedClasses": {
+          "level": "error",
+          "fix": "safe",
+          "options": {
+            "attributes": ["classList"],
+            "functions": ["clsx", "cva"]
+          }
+        }
+      },
+      "a11y": "off",
+      "complexity": {
+        "noStaticOnlyClass": "off"
+      },
+      "style": {
+        "useTemplate": {
+          "level": "warn",
+          "fix": "safe"
+        }
+      }
+    },
+    "domains": {
+      "project": "recommended",
+      "react": "recommended",
+      "test": "recommended",
+      "types": "all"
+    }
+  },
+  "javascript": {
+    "parser": {
+      "unsafeParameterDecoratorsEnabled": true
+    },
+    "formatter": {
+      "quoteStyle": "double"
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["**/page/**/*.ts", "**/page/**/*.tsx", "**/*.Unit.tsx", "**/*.View.tsx"],
+      "plugins": [
+        "./node_modules/akanjs/devkit/lint/no-import-client-functions.grit",
+        "./node_modules/akanjs/devkit/lint/no-use-client-in-server.grit"
+      ]
+    },
+    {
+      "includes": ["**/page/**/*.ts", "**/page/**/*.tsx"],
+      "plugins": ["./node_modules/akanjs/devkit/lint/non-scalar-props-restricted.grit"]
+    },
+    {
+      "includes": ["**/*.constant.ts", "**/*.document.ts", "**/*.service.ts", "**/*.store.ts"],
+      "plugins": ["./node_modules/akanjs/devkit/lint/no-js-private-class-method.grit"]
+    },
+    {
+      "includes": [
+        "**/page/**/*.ts",
+        "**/page/**/*.tsx",
+        "**/index.ts",
+        "**/index.tsx",
+        "**/cnst.ts",
+        "**/db.ts",
+        "**/dict.ts",
+        "**/option.ts",
+        "**/sig.ts",
+        "**/srv.ts",
+        "**/st.ts",
+        "**/*.constant.ts",
+        "**/*.dictionary.ts",
+        "**/*.document.ts",
+        "**/*.service.ts",
+        "**/*.signal.ts",
+        "**/*.signal.test.ts",
+        "**/*.service.test.ts",
+        "**/*.store.ts",
+        "**/*.Template.tsx",
+        "**/*.Unit.tsx",
+        "**/*.Util.tsx",
+        "**/*.View.tsx",
+        "**/*.Zone.tsx"
+      ],
+      "plugins": ["./node_modules/akanjs/devkit/lint/no-import-external-library.grit"]
+    }
+  ]
+}

package/cli/templates/workspaceRoot/bunfig.toml

@@ -0,0 +1,4 @@
+
+[serve.static]
+plugins = ["bun-plugin-tailwind"]
+env = "AKAN_PUBLIC_*"

package/cli/templates/workspaceRoot/package.json.template

@@ -10,6 +10,7 @@
     "daisyui": "^5.5.20"
   },
   "devDependencies": {
+    "@biomejs/biome": "2.4.4",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "crypto-browserify": "^3.12.1",

package/devkit/executors.ts

@@ -7,7 +7,7 @@ import {
   type SpawnOptions,
   spawn,
 } from "node:child_process";
-import { mkdir, stat } from "node:fs/promises";
+import { mkdir, readdir as readDirEntries, stat } from "node:fs/promises";
 import path from "node:path";
 import {
   capitalize,
@@ -455,7 +455,7 @@ export class Executor {
       );
       return fileContent ? [fileContent] : ([] as FileContent[]);
     } else {
-      const subdirs = await this.readdir(templatePath);
+      const subdirs = await readDirEntries(templatePath);
       const fileContents = (
         await Promise.all(
           subdirs.map(async (subdir) => {
@@ -615,6 +615,9 @@ export class WorkspaceExecutor extends Executor {
     if (type === "lib" || type === "pkg")
       rootTsConfig.compilerOptions.paths[`@${name}`] = [`${type}s/${name}/index.ts`];
     rootTsConfig.compilerOptions.paths[`@${name}/*`] = [`${type}s/${name}/*`];
+    rootTsConfig.compilerOptions.paths[`@${type}s/${name}/*`] = [`${type}s/${name}/*`];
+    if (type === "lib" || type === "pkg")
+      rootTsConfig.compilerOptions.paths[`@${type}s/${name}`] = [`${type}s/${name}/index.ts`];
     if (rootTsConfig.references) {
       if (!rootTsConfig.references.some((ref) => ref.path === `./${type}s/${name}/tsconfig.json`))
         rootTsConfig.references.push({ path: `./${type}s/${name}/tsconfig.json` });
@@ -625,7 +628,7 @@ export class WorkspaceExecutor extends Executor {
   async unsetTsPaths(type: "app" | "lib" | "pkg", name: string) {
     const rootTsConfig = (await this.readJson("tsconfig.json")) as TsConfigJson;
     const filteredKeys = Object.keys(rootTsConfig.compilerOptions.paths ?? {}).filter(
-      (key) => !key.startsWith(`@${name}`),
+      (key) => !key.startsWith(`@${name}`) && !key.startsWith(`@${type}s/${name}`),
     );
     rootTsConfig.compilerOptions.paths = Object.fromEntries(
       filteredKeys.map((key) => [key, rootTsConfig.compilerOptions.paths?.[key] ?? []]),

package/devkit/frontendBuild/clientEntryDiscovery.ts

@@ -6,10 +6,14 @@ import type { AkanConfig, ClientEntryDiscovery, ScannedImport } from "./clientBu
 
 const USE_CLIENT_RE = /^\s*(?:\/\*[\s\S]*?\*\/\s*|\/\/[^\n]*\n\s*)*["']use client["']/;
 const SOURCE_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
+const NODE_MODULES_RE = /[\\/]node_modules[\\/]/;
+const AKANJS_NODE_MODULE_RE = /[\\/]node_modules[\\/]akanjs[\\/]/;
 
 const NON_SOURCE_EXT_RE = /\.(css|scss|sass|less|json|svg|png|jpe?g|webp|gif|avif|ico|woff2?|ttf|otf|mp3|mp4|wav)$/i;
 type PackageResolver = Awaited<ReturnType<typeof createTsconfigPackageResolver>>;
 
+const shouldSkipNodeModule = (absPath: string) => NODE_MODULES_RE.test(absPath) && !AKANJS_NODE_MODULE_RE.test(absPath);
+
 /**
  * Graph-based `"use client"` discovery, seeded from an explicit file list.
  *
@@ -156,7 +160,7 @@ export class GraphClientEntryDiscovery implements ClientEntryDiscovery {
     const absPath = path.resolve(file);
     const cached = this.#reachableEntriesCache.get(absPath);
     if (cached) return new Set(cached);
-    if (visiting.has(absPath) || absPath.includes("node_modules")) return new Set();
+    if (visiting.has(absPath) || shouldSkipNodeModule(absPath)) return new Set();
 
     visiting.add(absPath);
     const entries = new Set<string>();
@@ -177,7 +181,7 @@ export class GraphClientEntryDiscovery implements ClientEntryDiscovery {
       if (NON_SOURCE_EXT_RE.test(spec)) continue;
       const resolved = await this.#resolveSpecifier(spec, importerDir);
       if (!resolved) continue;
-      if (resolved.includes("node_modules")) continue;
+      if (shouldSkipNodeModule(resolved)) continue;
       for (const entry of await this.#discoverFromFile(resolved, visiting)) entries.add(entry);
     }
 

package/devkit/transforms/barrelAnalyzer.ts

@@ -17,6 +17,8 @@ export interface PackageEntry {
   entryFile: string;
   /** Absolute directory used as the base for subpath computation. Typically dirname(entryFile). */
   pkgDir: string;
+  /** Preserve concrete file paths for package exports that do not support extensionless deep imports. */
+  preserveFilePath?: boolean;
 }
 
 export interface BarrelAnalyzerOptions {
@@ -162,6 +164,7 @@ export class BarrelAnalyzer {
   #subpathFor(pkg: PackageEntry, absFile: string): string | null {
     const rel = path.relative(pkg.pkgDir, absFile);
     if (!rel || rel.startsWith("..") || path.isAbsolute(rel)) return null;
+    if (pkg.preserveFilePath) return `${pkg.pkgName}/${rel.split(path.sep).join("/")}`;
     const noExt = stripKnownExt(rel);
 
     const tail = collapseIndex(noExt);

package/devkit/transforms/barrelImportsPlugin.ts

@@ -19,7 +19,7 @@ export interface BarrelImportsPluginOptions {
 
 export const createBarrelImportsPlugin = async (
   app: App,
-  { skipPath = (p) => p.includes("node_modules"), pipeAfter }: BarrelImportsPluginOptions = {},
+  { skipPath = defaultSkipPath, pipeAfter }: BarrelImportsPluginOptions = {},
 ): Promise<BunPlugin> => {
   const akanConfig = await app.getConfig();
   const barrels = [...new Set(akanConfig.barrelImports)].filter(Boolean);
@@ -31,40 +31,46 @@ export const createBarrelImportsPlugin = async (
     name: "barrel-imports",
     setup(build) {
 
-      build.onLoad({ filter: /^(?!.*[\\/]node_modules[\\/]).*\.(tsx|ts|jsx|js)(\?v=\d+)?$/ }, async (args) => {
-        const realPath = args.path.replace(/\?v=\d+$/, "");
-        const loader = loaderFor(realPath);
-        if (skipPath(realPath)) {
-          const raw = await Bun.file(realPath).text();
-          return { contents: raw, loader };
-        }
+      build.onLoad(
+        {
+          filter:
+            /^(?:(?!.*[\\/]node_modules[\\/]).*|.*[\\/]node_modules[\\/]akanjs[\\/].*)\.(tsx|ts|jsx|js)(\?v=\d+)?$/,
+        },
+        async (args) => {
+          const realPath = args.path.replace(/\?v=\d+$/, "");
+          const loader = loaderFor(realPath);
+          if (skipPath(realPath)) {
+            const raw = await Bun.file(realPath).text();
+            return { contents: raw, loader };
+          }
 
-        let source = await Bun.file(realPath).text();
+          let source = await Bun.file(realPath).text();
 
-        const hasMacroAttr = MACRO_ATTR_RE.test(source);
+          const hasMacroAttr = MACRO_ATTR_RE.test(source);
 
-        if (!hasMacroAttr && barrels.length > 0) {
-          
-          let maybe = false;
-          for (const b of barrels) {
-            if (source.includes(b)) {
-              maybe = true;
-              break;
+          if (!hasMacroAttr && barrels.length > 0) {
+            
+            let maybe = false;
+            for (const b of barrels) {
+              if (source.includes(b)) {
+                maybe = true;
+                break;
+              }
+            }
+            if (maybe) {
+              const rewritten = await rewriteBarrelImports(source, barrels, analyzer);
+              if (rewritten !== null) source = rewritten;
             }
           }
-          if (maybe) {
-            const rewritten = await rewriteBarrelImports(source, barrels, analyzer);
-            if (rewritten !== null) source = rewritten;
-          }
-        }
 
-        if (pipeAfter) {
-          const piped = await pipeAfter(source, { path: realPath });
-          if (piped !== null) source = piped;
-        }
+          if (pipeAfter) {
+            const piped = await pipeAfter(source, { path: realPath });
+            if (piped !== null) source = piped;
+          }
 
-        return { contents: source, loader };
-      });
+          return { contents: source, loader };
+        },
+      );
     },
   };
 };
@@ -162,6 +168,10 @@ export const createTsconfigPackageResolver = async (
 
 const CANDIDATE_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
 
+const NODE_MODULES_RE = /[\\/]node_modules[\\/]/;
+const AKANJS_NODE_MODULE_RE = /[\\/]node_modules[\\/]akanjs[\\/]/;
+const defaultSkipPath = (absPath: string) => NODE_MODULES_RE.test(absPath) && !AKANJS_NODE_MODULE_RE.test(absPath);
+
 type ExportValue = string | string[] | { [condition: string]: ExportValue | undefined };
 
 const resolveNodePackageExport = async (workspaceRoot: string, specifier: string): Promise<PackageEntry | null> => {
@@ -178,13 +188,13 @@ const resolveNodePackageExport = async (workspaceRoot: string, specifier: string
       main?: string;
     };
     const subpath = specifier === packageName ? "." : `.${specifier.slice(packageName.length)}`;
-    const exported = resolveExportValue(pkgJson.exports?.[subpath]);
+    const exported = resolvePackageExport(pkgJson.exports, subpath);
     const rel = exported ?? (subpath === "." ? (pkgJson.module ?? pkgJson.main ?? "index.js") : null);
     if (!rel || !rel.startsWith(".")) return null;
     const entryFile = await resolveFileCandidate(path.resolve(pkgDir, rel));
     if (!entryFile) return null;
     const pkgEntryName = specifier;
-    return { pkgName: pkgEntryName, entryFile, pkgDir: path.dirname(entryFile) };
+    return { pkgName: pkgEntryName, entryFile, pkgDir: path.dirname(entryFile), preserveFilePath: true };
   } catch {
     return null;
   }
@@ -207,6 +217,25 @@ const resolveExportValue = (value: ExportValue | undefined): string | null => {
   return null;
 };
 
+const resolvePackageExport = (exportsMap: Record<string, ExportValue> | undefined, subpath: string): string | null => {
+  if (!exportsMap) return null;
+  const exact = resolveExportValue(exportsMap[subpath]);
+  if (exact) return exact;
+
+  for (const [key, value] of Object.entries(exportsMap)) {
+    const starIdx = key.indexOf("*");
+    if (starIdx === -1) continue;
+    const prefix = key.slice(0, starIdx);
+    const suffix = key.slice(starIdx + 1);
+    if (!subpath.startsWith(prefix) || !subpath.endsWith(suffix)) continue;
+    const wildcard = subpath.slice(prefix.length, subpath.length - suffix.length);
+    const resolved = resolveExportValue(value);
+    if (resolved) return resolved.replace("*", wildcard);
+  }
+
+  return null;
+};
+
 const getPackageName = (specifier: string): string | null => {
   const parts = specifier.split("/");
   if (!parts[0]) return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "2.0.0-rc.0",
+  "version": "2.0.0-rc.2",
   "sourceType": "module",
   "type": "module",
   "bin": {

package/cli/templates/app/tsconfig.spec.json.template

@@ -1,7 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "types": ["bun-types"]
-  },
-  "include": ["**/*.test.ts"]
-}

package/cli/templates/libRoot/tsconfig.spec.json.template

@@ -1,7 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "types": ["bun-types"]
-  },
-  "include": ["**/*.test.ts"]
-}

package/cli/templates/workspaceRoot/.prettierignore.template

@@ -1,10 +0,0 @@
-# Add files here to ignore them from prettier formatting
-
-/dist
-/coverage
-/node_modules
-/dump
-/data
-/releases
-/tmp
-**/*.yaml

package/cli/templates/workspaceRoot/.prettierrc.json.template

@@ -1,6 +0,0 @@
-{
-  "trailingComma": "es5",
-  "singleQuote": false,
-  "printWidth": 120,
-  "plugins": ["prettier-plugin-tailwindcss"]
-}

package/cli/templates/workspaceRoot/.swcrc.template

@@ -1,9 +0,0 @@
-{
-  "jsc": {
-    "target": "es2016",
-    "parser": {
-      "syntax": "typescript"
-    }
-  },
-  "exclude": [".*\\.spec|test\\.ts$"]
-}

package/cli/templates/workspaceRoot/README.md.template

@@ -1,37 +0,0 @@
-## Get Started
-
-Run the code below.
-
-```
-bun run downloadEnv # Need to register your public key
-
-bun i -g akanjs
-
-bun i
-
-cat <<EOF >> .env
-# organization configuration, no need to change
-AKAN_PUBLIC_REPO_NAME=<%= repoName %>
-AKAN_PUBLIC_SERVE_DOMAIN="<%= serveDomain %>"
-
-# development branch, debug, develop, main, etc. mainly it changes databases.
-AKAN_PUBLIC_ENV=debug
-
-# local, cloud, edge it changes the connection point of the clients.
-AKAN_PUBLIC_OPERATION_MODE=local
-# hybrid app specific config, will be depreciated in the future
-APP_OPERATION_MODE=local
-
-# backend service mode, federation, batch, all
-SERVER_MODE=federation
-
-# analyze the bundle size
-ANALYZE=false
-
-# log level, debug, info, warn, error
-AKAN_PUBLIC_LOG_LEVEL=debug
-EOF
-
-akan serve-backend <%= appName %>
-# or akan serve-frontend <%= appName %>, etc
-```