@akanjs/cli 2.3.11 → 2.3.12-rc.0

package/incrementalBuilder.proc.js

@@ -721,6 +721,7 @@ var WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"];
 var SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"];
 var NATIVE_RUNTIME_PACKAGES = ["sharp"];
 var DEFAULT_BACKEND_RUNTIME_PACKAGES = ["croner"];
+var MOBILE_RUNTIME_PACKAGES = ["firebase"];
 var DATABASE_MODE_RUNTIME_PACKAGES = {
   single: [],
   multiple: ["@libsql/client", "bullmq", "ioredis", "protobufjs"],
@@ -730,6 +731,7 @@ var AKAN_RUNTIME_PACKAGES = new Set([
   ...SSR_RUNTIME_PACKAGES,
   ...NATIVE_RUNTIME_PACKAGES,
   ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
+  ...MOBILE_RUNTIME_PACKAGES,
   ...Object.values(DATABASE_MODE_RUNTIME_PACKAGES).flat()
 ]);
 var DEFAULT_AKAN_IMAGE_CONFIG = {
@@ -1013,11 +1015,20 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     return [...DATABASE_MODE_RUNTIME_PACKAGES[databaseMode]];
   }
   getMissingDatabaseModeDependencySpecs(databaseMode = this.defaultDatabaseMode) {
+    return this.#getMissingDependencySpecs(this.getDatabaseModeRuntimePackages(databaseMode));
+  }
+  getMobileRuntimePackages() {
+    return [...MOBILE_RUNTIME_PACKAGES];
+  }
+  getMissingMobileDependencySpecs() {
+    return this.#getMissingDependencySpecs(this.getMobileRuntimePackages());
+  }
+  #getMissingDependencySpecs(libs) {
     const rootDependencies = {
       ...this.rootPackageJson.dependencies,
       ...this.rootPackageJson.devDependencies
     };
-    return this.getDatabaseModeRuntimePackages(databaseMode).filter((lib) => !rootDependencies[lib]).map((lib) => {
+    return libs.filter((lib) => !rootDependencies[lib]).map((lib) => {
       const version = this.#resolveProductionDependencyVersion(lib);
       if (!version)
         throw new Error(`Dependency ${lib} not found in package.json`);
@@ -11490,6 +11501,8 @@ import path28 from "path";
 var BARREL_FACETS2 = new Set(["common", "srvkit", "ui", "webkit"]);
 var FACET_SOURCE_FILE_RE = /\.(ts|tsx)$/;
 var FACET_EXCLUDED_FILE_RE = /(^index\.tsx?$|\.d\.ts$|\.(test|spec)\.(ts|tsx)$|\.css$|\.scss$|\.sass$)/;
+var FACET_PASCAL_CASE_RE = /^[A-Z][A-Za-z0-9]*$/;
+var FACET_CAMEL_CASE_RE = /^[a-z][A-Za-z0-9]*$/;
 var MODULE_UI_TYPES = ["Template", "Unit", "Util", "View", "Zone"];
 var SERVICE_UI_TYPES = ["Util", "Zone"];
 var SCALAR_UI_TYPES = ["Template", "Unit"];
@@ -11586,18 +11599,20 @@ class DevGeneratedIndexSync {
     return this.#moduleContent(path28.dirname(indexPath));
   }
   async#facetContent(dir) {
+    const nameCasePattern = path28.basename(dir) === "ui" ? FACET_PASCAL_CASE_RE : FACET_CAMEL_CASE_RE;
     const entries = await readdir2(dir, { withFileTypes: true }).catch(() => []);
     const exportNames = entries.flatMap((entry) => {
       const name = entry.name;
       if (name.startsWith("."))
         return [];
       if (entry.isDirectory())
-        return [name];
+        return nameCasePattern.test(name) ? [name] : [];
       if (!entry.isFile())
         return [];
       if (!FACET_SOURCE_FILE_RE.test(name) || FACET_EXCLUDED_FILE_RE.test(name))
         return [];
-      return [name.replace(FACET_SOURCE_FILE_RE, "")];
+      const exportName = name.replace(FACET_SOURCE_FILE_RE, "");
+      return nameCasePattern.test(exportName) ? [exportName] : [];
     }).sort();
     if (exportNames.length === 0)
       return null;

package/index.js

@@ -719,6 +719,7 @@ var WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"];
 var SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"];
 var NATIVE_RUNTIME_PACKAGES = ["sharp"];
 var DEFAULT_BACKEND_RUNTIME_PACKAGES = ["croner"];
+var MOBILE_RUNTIME_PACKAGES = ["firebase"];
 var DATABASE_MODE_RUNTIME_PACKAGES = {
   single: [],
   multiple: ["@libsql/client", "bullmq", "ioredis", "protobufjs"],
@@ -728,6 +729,7 @@ var AKAN_RUNTIME_PACKAGES = new Set([
   ...SSR_RUNTIME_PACKAGES,
   ...NATIVE_RUNTIME_PACKAGES,
   ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
+  ...MOBILE_RUNTIME_PACKAGES,
   ...Object.values(DATABASE_MODE_RUNTIME_PACKAGES).flat()
 ]);
 var DEFAULT_AKAN_IMAGE_CONFIG = {
@@ -1011,11 +1013,20 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     return [...DATABASE_MODE_RUNTIME_PACKAGES[databaseMode]];
   }
   getMissingDatabaseModeDependencySpecs(databaseMode = this.defaultDatabaseMode) {
+    return this.#getMissingDependencySpecs(this.getDatabaseModeRuntimePackages(databaseMode));
+  }
+  getMobileRuntimePackages() {
+    return [...MOBILE_RUNTIME_PACKAGES];
+  }
+  getMissingMobileDependencySpecs() {
+    return this.#getMissingDependencySpecs(this.getMobileRuntimePackages());
+  }
+  #getMissingDependencySpecs(libs) {
     const rootDependencies = {
       ...this.rootPackageJson.dependencies,
       ...this.rootPackageJson.devDependencies
     };
-    return this.getDatabaseModeRuntimePackages(databaseMode).filter((lib) => !rootDependencies[lib]).map((lib) => {
+    return libs.filter((lib) => !rootDependencies[lib]).map((lib) => {
       const version = this.#resolveProductionDependencyVersion(lib);
       if (!version)
         throw new Error(`Dependency ${lib} not found in package.json`);
@@ -11488,6 +11499,8 @@ import path28 from "path";
 var BARREL_FACETS2 = new Set(["common", "srvkit", "ui", "webkit"]);
 var FACET_SOURCE_FILE_RE = /\.(ts|tsx)$/;
 var FACET_EXCLUDED_FILE_RE = /(^index\.tsx?$|\.d\.ts$|\.(test|spec)\.(ts|tsx)$|\.css$|\.scss$|\.sass$)/;
+var FACET_PASCAL_CASE_RE = /^[A-Z][A-Za-z0-9]*$/;
+var FACET_CAMEL_CASE_RE = /^[a-z][A-Za-z0-9]*$/;
 var MODULE_UI_TYPES = ["Template", "Unit", "Util", "View", "Zone"];
 var SERVICE_UI_TYPES = ["Util", "Zone"];
 var SCALAR_UI_TYPES = ["Template", "Unit"];
@@ -11584,18 +11597,20 @@ class DevGeneratedIndexSync {
     return this.#moduleContent(path28.dirname(indexPath));
   }
   async#facetContent(dir) {
+    const nameCasePattern = path28.basename(dir) === "ui" ? FACET_PASCAL_CASE_RE : FACET_CAMEL_CASE_RE;
     const entries = await readdir2(dir, { withFileTypes: true }).catch(() => []);
     const exportNames = entries.flatMap((entry) => {
       const name = entry.name;
       if (name.startsWith("."))
         return [];
       if (entry.isDirectory())
-        return [name];
+        return nameCasePattern.test(name) ? [name] : [];
       if (!entry.isFile())
         return [];
       if (!FACET_SOURCE_FILE_RE.test(name) || FACET_EXCLUDED_FILE_RE.test(name))
         return [];
-      return [name.replace(FACET_SOURCE_FILE_RE, "")];
+      const exportName = name.replace(FACET_SOURCE_FILE_RE, "");
+      return nameCasePattern.test(exportName) ? [exportName] : [];
     }).sort();
     if (exportNames.length === 0)
       return null;
@@ -17161,6 +17176,31 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
       throw error;
     }
   }
+  async confirmMobileDependencyInstall(installSpecs) {
+    return await confirm3({
+      message: [`Mobile builds require missing dependencies: ${installSpecs.join(", ")}.`, "Install them now?"].join(" "),
+      default: true
+    });
+  }
+  async syncMobileDependencies(app, akanConfig3) {
+    const installSpecs = akanConfig3.getMissingMobileDependencySpecs();
+    if (installSpecs.length === 0)
+      return;
+    const shouldInstall = await this.confirmMobileDependencyInstall(installSpecs);
+    if (!shouldInstall)
+      throw new Error(`Mobile builds require missing dependencies: ${installSpecs.join(", ")}.`);
+    const spinner2 = app.workspace.spinning("Installing mobile dependencies...");
+    try {
+      await app.workspace.spawn("bun", ["add", ...installSpecs], {
+        stdio: "inherit"
+      });
+      await app.workspace.getPackageJson({ refresh: true });
+      spinner2.succeed("Installed mobile dependencies");
+    } catch (error) {
+      spinner2.fail("Failed to install mobile dependencies");
+      throw error;
+    }
+  }
   async createApplication(appName, workspace, { start = false, libs = [] } = {}) {
     const spinner2 = workspace.spinning("Creating application...");
     const app = await this.applicationRunner.createApplication(appName, workspace, libs);
@@ -17282,6 +17322,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     noAllowProvisioningUpdates = false
   } = {}) {
     await app.scanSync({ write });
+    await this.syncMobileDependencies(app, await app.getConfig());
     await this.applicationRunner.startIos(app, {
       open,
       operation,
@@ -17310,6 +17351,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     regenerate = false
   } = {}) {
     await app.scanSync({ write });
+    await this.syncMobileDependencies(app, await app.getConfig());
     await this.applicationRunner.startAndroid(app, {
       open,
       operation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "2.3.11",
+  "version": "2.3.12-rc.0",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -34,7 +34,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.3.11",
+    "akanjs": "2.3.12-rc.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",

package/templates/facetIndex/index.ts

@@ -12,18 +12,24 @@ interface Options {
 
 const sourceFilePattern = /\.(ts|tsx)$/;
 const excludedFilePattern = /(^index\.tsx?$|\.d\.ts$|\.(test|spec)\.(ts|tsx)$|\.css$|\.scss$|\.sass$)/;
+// `ui` exports PascalCase names only; `common`/`srvkit`/`webkit` export camelCase names only. Names with
+// dots, underscores, or hyphens (e.g. `foo.helper`, `Globe_Dynamic`, `kebab-case`) match neither and are skipped.
+const pascalCasePattern = /^[A-Z][A-Za-z0-9]*$/;
+const camelCasePattern = /^[a-z][A-Za-z0-9]*$/;
+const nameCasePatternForFacet = (facet: string) => (facet === "ui" ? pascalCasePattern : camelCasePattern);
 
 export default async function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict = {}, options: Options = {}) {
   const { exec, facet } = options;
   if (!exec || !facet || !(await exec.exists(facet))) return null;
 
+  const nameCasePattern = nameCasePatternForFacet(facet);
   const { files, dirs } = await exec.getFilesAndDirs(facet);
   const exportNames = [
     ...files
       .filter((filename) => sourceFilePattern.test(filename) && !excludedFilePattern.test(filename))
       .map((filename) => filename.replace(sourceFilePattern, "")),
     ...dirs.filter((dirname) => !dirname.startsWith(".")),
-  ].sort();
+  ].filter((name) => nameCasePattern.test(name)).sort();
 
   if (exportNames.length === 0) return null;
   return {

package/templates/workspaceRoot/.cursor/rules/typescript-imports.mdc.template

@@ -9,5 +9,5 @@ alwaysApply: false
 - Use Bun and ESM assumptions from the root `tsconfig.json`.
 - Prefer path aliases over deep relative imports when crossing package boundaries.
 - Use `akanjs/*` for framework facets, `@apps/*` for apps, `@libs/*` for shared libs, and `@contract/*` for contract code.
-- Respect existing client/server entrypoints such as `@libs/shared/client`, `@libs/shared/server`, `@apps/<% appName %>/client`, and `@apps/<% appName %>/server`.
+- Respect existing client/server entrypoints such as `@libs/shared/client`, `@libs/shared/server`, `@apps/myapp/client`, and `@apps/myapp/server`.
 - Let Biome organize imports instead of manually reshuffling unrelated imports.