akanjs 2.0.0-rc.1 → 2.0.0-rc.2

package/cli/index.js

@@ -12957,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;
@@ -12990,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])
@@ -13183,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;
@@ -13320,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;
@@ -13343,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/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/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/barrelImportsPlugin.ts

@@ -188,7 +188,7 @@ 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));
@@ -217,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.1",
+  "version": "2.0.0-rc.2",
   "sourceType": "module",
   "type": "module",
   "bin": {

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
-```