@akanjs/cli 0.0.147 → 0.0.149

package/cjs/src/templates/workspaceRoot/.gitignore.template

@@ -0,0 +1,118 @@
+**/dist
+/node_modules
+/.akan
+.vscode/*
+.DS_Store
+Thumbs.db
+*.env
+**/node_modules
+/data
+apps/*/data
+/releases
+apps/*/scripts
+**/.env
+**/env.client.debug.ts
+**/env.client.develop.ts
+**/env.client.main.ts
+**/env.client.testing.ts
+**/env.server.debug.ts
+**/env.server.develop.ts
+**/env.server.main.ts
+**/env.server.testing.ts
+**/*secrets.yaml
+**/kubeconfig.yaml
+**/secrets.*
+**/.idea
+apps/**/src/schema.gql
+.next
+dump
+local
+
+# Xcode
+build/
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+xcuserdata
+*.xccheckout
+*.moved-aside
+DerivedData
+*.hmap
+*.ipa
+*.xcuserstate
+
+# **/android
+build/
+.gradle
+local.properties
+*.iml
+*.hprof
+.cxx/
+*.keystore
+!debug.keystore
+
+**/public/precache.*.*.js
+**/public/sw.js
+**/public/workbox-*.js
+**/public/worker-*.js
+**/public/fallback-*.js
+**/public/precache.*.*.js.map
+**/public/sw.js.map
+**/public/workbox-*.js.map
+**/public/worker-*.js.map
+**/public/fallback-*.js
+**/public/libs
+
+**/vendor/bundle/
+**/ios/App/App/public
+**/ios/App/App/Podfile.lock
+**/ios/App/App.pbxproj
+**/*-secret.yaml
+
+# Akanjs files
+**/akan.app.json
+**/akan.lib.json
+**/akan.pkg.json
+**/next.config.ts
+**/next-env.d.ts
+apps/**/lib/__lib/**
+libs/**/lib/__lib/**
+apps/*/lib/cnst.ts
+apps/*/lib/cnst_.ts
+apps/*/lib/dict.ts
+apps/*/lib/db.ts
+apps/*/lib/fetch.ts
+apps/*/lib/srv.ts
+apps/*/lib/st.ts
+apps/*/lib/sig.ts
+apps/*/lib/store.ts
+apps/*/lib/usePage.ts
+apps/*/lib/__scalar/_server.ts
+apps/*/client.ts
+apps/*/server.ts
+libs/*/lib/cnst.ts
+libs/*/lib/cnst_.ts
+libs/*/lib/dict.ts
+libs/*/lib/db.ts
+libs/*/lib/fetch.ts
+libs/*/lib/srv.ts
+libs/*/lib/st.ts
+libs/*/lib/sig.ts
+libs/*/lib/store.ts
+libs/*/lib/usePage.ts
+libs/*/lib/__scalar/_server.ts
+libs/*/client.ts
+libs/*/server.ts
+libs/*/index.ts
+# **/capacitor.config.ts
+# **/postcss.config.js
+# **/playwright.config.ts
+# **/jest.config.ts
+# **/next-env.d.ts
+# **/tsconfig.json
+# **/tsconfig.spec.json

package/cjs/src/templates/workspaceRoot/.prettierignore.template

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

package/cjs/src/templates/workspaceRoot/.prettierrc.json.template

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

package/cjs/src/templates/workspaceRoot/.swcrc.template

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

package/cjs/src/templates/workspaceRoot/.vscode/settings.json.template

@@ -0,0 +1,13 @@
+{
+  "testing.saveBeforeTest": false,
+  "jest.autoRun": "false",
+  "jestTestExplorer.flattenExplorer": false,
+  "eslint.validate": ["json"],
+  "prettier.configPath": ".prettierrc.json",
+  "tailwindCSS.classAttributes": ["class", "className", ".*Class", ".*ClassName"],
+  "colorize.languages": ["typescript", "javascript", "css", "scss"],
+  "typescript.tsserver.maxTsServerMemory": 16384,
+  "typescript.enablePromptUseWorkspaceTsdk": true,
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "eslint.useFlatConfig": true
+}

package/cjs/src/templates/workspaceRoot/README.md.template

@@ -0,0 +1,37 @@
+## Get Started
+
+Run the code below.
+
+```
+npm run downloadEnv # Need to register your public key
+
+npm i -g akan pnpm
+
+pnpm i
+
+cat <<EOF >> .env
+# organization configuration, no need to change
+NEXT_PUBLIC_REPO_NAME=<%= repoName %>
+NEXT_PUBLIC_SERVE_DOMAIN="<%= serveDomain %>"
+
+# development branch, debug, develop, main, etc. mainly it changes databases.
+NEXT_PUBLIC_ENV=debug
+
+# local, cloud, edge it changes the connection point of the clients.
+NEXT_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
+NEXT_PUBLIC_LOG_LEVEL=debug
+EOF
+
+akan serve-backend <%= appName %>
+# or akan serve-frontend <%= appName %>, etc
+```

package/cjs/src/templates/workspaceRoot/eslint.config.ts.template

@@ -0,0 +1,3 @@
+import { eslintConfig } from "@akanjs/lint";
+
+export default eslintConfig;

package/cjs/src/templates/workspaceRoot/package.json.template

@@ -0,0 +1,43 @@
+{
+  "name": "<%= repoName %>",
+  "description": "<%= repoName %> workspace",
+  "version": "0.0.1",
+  "dependencies": {
+    "next": "15.3.2",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "tailwindcss": "^4.1.7",
+    "daisyui": "^5.0.35"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.1.7",
+    "@types/react": "18.3.1",
+    "@types/react-dom": "18.3.1",
+    "crypto-browserify": "^3.12.1",
+    "eslint": "^9.19.0",
+    "https-browserify": "^1.0.0",
+    "jest": "^29.7.0",
+    "jiti": "^2.4.2",
+    "os-browserify": "^0.3.0",
+    "prettier": "^3.5.3",
+    "prettier-plugin-tailwindcss": "^0.6.11",
+    "process": "^0.11.10",
+    "stream-browserify": "^3.0.0",
+    "stream-http": "^3.2.0",
+    "tailwind-scrollbar": "4.0.2",
+    "tailwindcss-animation-delay": "^2.0.2",
+    "tailwindcss-radix": "^4.0.2",
+    "ts-jest": "^29.3.4",
+    "url-polyfill": "^1.1.13",
+    "vite": "^6.3.5",
+    "vite-plugin-commonjs": "^0.10.4",
+    "vite-plugin-node-polyfills": "^0.23.0",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vm-browserify": "^1.1.2"
+  },
+  "packageManager": "pnpm@10.11.0",
+  "engines": {
+    "node": ">=22",
+    "pnpm": ">=10"
+  }
+}

package/cjs/src/templates/workspaceRoot/tsconfig.json.template

@@ -0,0 +1,29 @@
+{
+  "compileOnSave": false,
+  "compilerOptions": {
+    "rootDir": ".",
+    "sourceMap": true,
+    "declaration": false,
+    "moduleResolution": "node",
+    "emitDecoratorMetadata": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "experimentalDecorators": true,
+    "noPropertyAccessFromIndexSignature": false,
+    "importHelpers": false,
+    "target": "es2022",
+    "module": "esnext",
+    "types": ["node", "webpack-env", "vite/client", "kakao.maps.d.ts", "jest"],
+    "lib": ["es2017", "dom", "webworker"],
+    "skipLibCheck": true,
+    "skipDefaultLibCheck": true,
+    "strictNullChecks": true,
+    "baseUrl": ".",
+    "jsx": "preserve",
+    "resolveJsonModule": true,
+    "paths": {
+      "@/*": ["*"]
+    }
+  },
+  "exclude": ["**/node_modules", "tmp", "**/ios", "**/android"]
+}

package/esm/index.js

@@ -3423,7 +3423,7 @@ var LibraryScript = class {
 };
 
 // pkgs/@akanjs/cli/src/application/application.runner.ts
-import { confirm as confirm2, input as input4 } from "@inquirer/prompts";
+import { confirm as confirm2, input as input4, select as select5 } from "@inquirer/prompts";
 import { StringOutputParser } from "@langchain/core/output_parsers";
 import { PromptTemplate as PromptTemplate2 } from "@langchain/core/prompts";
 import { RunnableSequence as RunnableSequence2 } from "@langchain/core/runnables";
@@ -3468,6 +3468,34 @@ var ApplicationRunner = class {
     await app.syncAssets(scanResult.akanConfig.libs);
     return scanResult;
   }
+  async getScriptFilename(app) {
+    if (!app.exists("scripts")) {
+      app.mkdir("scripts");
+      throw new Error(`No script files found. make a script file in apps/${app.name}/scripts folder`);
+    }
+    const scriptFiles = (await app.readdir("scripts")).filter((file) => file.endsWith(".ts"));
+    const scriptFile = await select5({
+      message: "Select script to run",
+      choices: scriptFiles.map((file) => ({ name: file, value: file.replace(".ts", "") }))
+    });
+    return scriptFile;
+  }
+  async runScript(app, filename) {
+    const buildResult = await esbuild2.build({
+      write: true,
+      entryPoints: [`${app.cwdPath}/scripts/${filename}.ts`],
+      bundle: true,
+      format: "cjs",
+      packages: "external",
+      platform: "node",
+      outdir: `${app.cwdPath}/scripts`,
+      logLevel: "warning"
+    });
+    await app.spawn("node", [`scripts/${filename}.js`], {
+      stdio: "inherit",
+      env: this.#getEnv(app)
+    });
+  }
   #getEnv(app, env = {}) {
     const rootEnv = dotenv3.parse(app.workspace.readFile(".env"));
     return {
@@ -3535,10 +3563,10 @@ var ApplicationRunner = class {
       setTimeout(() => openBrowser("http://localhost:8080/backend/graphql"), 3e3);
     await app.dist.spawn("node", ["--watch", "backend/main.js"], { env, stdio: "inherit" });
   }
-  async buildFrontend(app) {
+  async buildFrontend(app, { spawnOptions } = {}) {
     const { env } = await this.#prepareCommand(app, "build", "frontend");
     const akanConfig = await app.getConfig("build");
-    await app.spawn("npx", ["next", "build", "--no-lint"], { env });
+    await app.spawn("npx", ["next", "build", "--no-lint"], { env, ...spawnOptions });
     const buildResult = await esbuild2.build({
       entryPoints: [`${app.cwdPath}/next.config.ts`],
       outdir: `${app.dist.cwdPath}/frontend`,
@@ -3943,6 +3971,11 @@ var ApplicationScript = class {
     spinner.succeed("Application scanned");
     return scanResult;
   }
+  async script(app, filename) {
+    const scriptFilename = filename ?? await this.#runner.getScriptFilename(app);
+    await this.syncApplication(app);
+    await this.#runner.runScript(app, scriptFilename);
+  }
   async build(app) {
     await this.syncApplication(app);
     await Promise.all([this.buildBackend(app, { sync: false }), this.buildFrontend(app, { sync: false })]);
@@ -3973,12 +4006,16 @@ var ApplicationScript = class {
       }
     });
   }
-  async buildFrontend(app, { sync = true } = {}) {
+  async buildFrontend(app, { sync = true, standalone = false } = {}) {
     if (sync)
       await this.syncApplication(app);
-    const spinner = app.spinning("Building frontend...");
-    await this.#runner.buildFrontend(app);
-    spinner.succeed(`Frontend built in dist/apps/${app.name}/frontend`);
+    if (standalone)
+      await this.#runner.buildFrontend(app, { spawnOptions: { stdio: "inherit" } });
+    else {
+      const spinner = app.spinning("Building frontend...");
+      await this.#runner.buildFrontend(app);
+      spinner.succeed(`Frontend built in dist/apps/${app.name}/frontend`);
+    }
   }
   async startFrontend(app, { open: open2 = false, turbo = false, sync = true } = {}) {
     if (sync)
@@ -4105,6 +4142,9 @@ var ApplicationCommand = class {
   async syncApplication(app) {
     await this.applicationScript.syncApplication(app);
   }
+  async script(app, filename) {
+    await this.applicationScript.script(app, filename);
+  }
   async build(app) {
     await this.applicationScript.build(app);
   }
@@ -4112,7 +4152,7 @@ var ApplicationCommand = class {
     await this.applicationScript.buildBackend(app);
   }
   async buildFrontend(app) {
-    await this.applicationScript.buildFrontend(app);
+    await this.applicationScript.buildFrontend(app, { standalone: true });
   }
   async buildCsr(app) {
     await this.applicationScript.buildCsr(app);
@@ -4186,6 +4226,11 @@ __decorateClass([
   Target.Public(),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "syncApplication", 1);
+__decorateClass([
+  Target.Public(),
+  __decorateParam(0, App()),
+  __decorateParam(1, Argument("filename", { desc: "name of script", nullable: true }))
+], ApplicationCommand.prototype, "script", 1);
 __decorateClass([
   Target.Public({ short: true }),
   __decorateParam(0, App())
@@ -4336,7 +4381,11 @@ var PackageRunner = class {
     if (pkg.name === "@akanjs/cli")
       await builder.build({
         bundle: true,
-        additionalEntryPoints: [`${pkg.cwdPath}/src/templates/**/*.ts`, `${pkg.cwdPath}/src/guidelines/**/*.md`]
+        additionalEntryPoints: [
+          `${pkg.cwdPath}/src/templates/**/*.ts`,
+          `${pkg.cwdPath}/src/templates/**/*.template`,
+          `${pkg.cwdPath}/src/guidelines/**/*.md`
+        ]
       });
     else
       await builder.build();

package/esm/src/guidelines/___library/sharedUiStructureDescription.en.md

@@ -559,24 +559,6 @@ Key features:
 - Simultaneous Korean/English address provision
 - Modal address search
 
-### 26. Field.KoreanCityDistrict
-
-\`\`\`typescript
-interface KoreanCityDistrictProps {
-city: string | null;
-onChangeCity: (city: string | null) => void;
-district: string | null;
-onChangeDistrict: (district: string | null) => void;
-disabled?: boolean;
-}
-\`\`\`
-Key features:
-
-- Hardcoded Korean region data
-- Two-level selection (city/province → district/county)
-- Includes detailed regions: 25 districts in Seoul, 16 in Busan, etc.
-- Linked selection (district activates after city selection)
-
 ## Common Patterns and Features
 
 ### 1. Caching System

package/esm/src/templates/app/app/[lang]/(__appName__)/styles.css.template

@@ -0,0 +1,19 @@
+@import "tailwindcss";
+@import "@akanjs/config/styles.css";
+
+@plugin "daisyui" {
+  logs: false;
+}
+
+@plugin "daisyui/theme" {
+  name: "light";
+}
+
+@plugin "daisyui/theme" {
+  name: "dark";
+}
+
+@theme {
+  --font-lemonmilk: var(--font-lemonmilk);
+  --font-pretendard: var(--font-pretendard);
+}

package/esm/src/templates/app/app/index.html.template

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title><%= appName %></title>
+    <base href="/" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/csr.tsx"></script>
+  </body>
+</html>

package/esm/src/templates/app/capacitor.config.ts.template

@@ -0,0 +1,8 @@
+//! will be replaced with akan.config.ts
+import { withBase } from "@akanjs/config/capacitor.base.config";
+
+export default withBase((config) => {
+  return {
+    ...config,
+  };
+});

package/esm/src/templates/app/env/env.client.debug.ts.template

@@ -0,0 +1,7 @@
+import { baseClientEnv } from "@akanjs/base";
+
+import { AppClientEnv } from "./env.client.type";
+
+export const env: AppClientEnv = {
+  ...baseClientEnv,
+} as const;

package/esm/src/templates/app/env/env.client.develop.ts.template

@@ -0,0 +1,7 @@
+import { baseClientEnv } from "@akanjs/base";
+
+import { AppClientEnv } from "./env.client.type";
+
+export const env: AppClientEnv = {
+  ...baseClientEnv,
+} as const;

package/esm/src/templates/app/env/env.client.local.ts.template

@@ -0,0 +1,7 @@
+import { baseClientEnv } from "@akanjs/base";
+
+import { AppClientEnv } from "./env.client.type";
+
+export const env: AppClientEnv = {
+  ...baseClientEnv,
+} as const;

package/esm/src/templates/app/env/env.client.main.ts.template

@@ -0,0 +1,7 @@
+import { baseClientEnv } from "@akanjs/base";
+
+import { AppClientEnv } from "./env.client.type";
+
+export const env: AppClientEnv = {
+  ...baseClientEnv,
+} as const;

package/esm/src/templates/app/env/env.client.testing.ts.template

@@ -0,0 +1,7 @@
+import { baseClientEnv } from "@akanjs/base";
+
+import { AppClientEnv } from "./env.client.type";
+
+export const env: AppClientEnv = {
+  ...baseClientEnv,
+} as const;

package/esm/src/templates/app/env/env.server.debug.ts.template

@@ -0,0 +1,15 @@
+import { baseEnv } from "@akanjs/base";
+
+import type { ModulesOptions } from "../lib/option";
+
+export const env: ModulesOptions = {
+  ...baseEnv,
+  hostname: null,
+  redis: {},
+  mongo: { password: "S20n-D2bUg" },
+  security: {
+    verifies: [["password", "phone", "naver", "kakao"]],
+    sso: {},
+  },
+  rootAdminInfo: { accountId: "akamirofficial@gmail.com", password: "akamir190319" },
+};

package/esm/src/templates/app/env/env.server.develop.ts.template

@@ -0,0 +1,15 @@
+import { baseEnv } from "@akanjs/base";
+
+import type { ModulesOptions } from "../lib/option";
+
+export const env: ModulesOptions = {
+  ...baseEnv,
+  hostname: null,
+  redis: {},
+  mongo: { password: "S20n-D2VeL0p-0905*" },
+  security: {
+    verifies: [["password", "phone", "naver", "kakao"]],
+    sso: {},
+  },
+  rootAdminInfo: { accountId: "akamirofficial@gmail.com", password: "akamir190319" },
+};

package/esm/src/templates/app/env/env.server.local.ts.template

@@ -0,0 +1,15 @@
+import { baseEnv } from "@akanjs/base";
+
+import type { ModulesOptions } from "../lib/option";
+
+export const env: ModulesOptions = {
+  ...baseEnv,
+  hostname: null,
+  redis: {},
+  mongo: {},
+  security: {
+    verifies: [["password", "phone", "naver", "kakao"]],
+    sso: {},
+  },
+  rootAdminInfo: { accountId: "akamirofficial@gmail.com", password: "akamir190319" },
+};

package/esm/src/templates/app/env/env.server.main.ts.template

@@ -0,0 +1,15 @@
+import { baseEnv } from "@akanjs/base";
+
+import type { ModulesOptions } from "../lib/option";
+
+export const env: ModulesOptions = {
+  ...baseEnv,
+  hostname: null,
+  redis: {},
+  mongo: { password: "S20n-m@In-0905*-SEON" },
+  security: {
+    verifies: [["password", "phone", "naver", "kakao"]],
+    sso: {},
+  },
+  rootAdminInfo: { accountId: "akamirofficial@gmail.com", password: "akamir190319" },
+};

package/esm/src/templates/app/env/env.server.testing.ts.template

@@ -0,0 +1,7 @@
+import { env as shared } from "@shared/server";
+
+import type { ModulesOptions } from "../lib/option";
+
+export const env: ModulesOptions = {
+  ...shared,
+};

package/esm/src/templates/app/main.js

@@ -9,7 +9,8 @@ import { registerModules } from "./server";
 const bootstrap = async () => {
   const serverMode = process.env.SERVER_MODE as "federation" | "batch" | "all" | null;
   if (!serverMode) throw new Error("SERVER_MODE environment variable is not defined");
-  await createNestApp({ registerModules, serverMode, env });
+  const app = await createNestApp({ registerModules, serverMode, env });
+  return () => app.close();
 };
 void bootstrap();
   `;

package/esm/src/templates/app/page.test.ts.template

@@ -0,0 +1,10 @@
+// import { PageAgent } from "@akanjs/next";
+// import { expect, test } from "@playwright/test";
+
+// test.describe("index page", () => {
+//   test("has title", async ({ page }) => {
+//     const agent = new PageAgent(page);
+//     await agent.goto("/");
+//     expect(agent.page).toBeTruthy();
+//   });
+// });

package/esm/src/templates/app/playwright.config.ts.template

@@ -0,0 +1,6 @@
+//! will be replaced with akan.config.ts
+import { withBase } from "@akanjs/test/playwright.config.base";
+
+const config = withBase(__filename);
+
+export default config;

package/esm/src/templates/app/postcss.config.js.template

@@ -0,0 +1,10 @@
+//! will be replaced with akan.config.ts
+const akanjsPrefix = process.env.USE_AKANJS_PKGS === "true" ? "../../pkgs/" : "";
+const { withBase } = require(`${akanjsPrefix}@akanjs/config/postcss.config.base`);
+
+/**
+ * @type {import('postcss-load-config').Config}
+ */
+const config = {};
+
+module.exports = withBase(config);