@akanjs/cli 0.0.147 → 0.0.149

package/esm/src/templates/app/public/manifest.json.template

@@ -0,0 +1,67 @@
+{
+  "name": "<%= AppName %>",
+  "short_name": "<%= AppName %>",
+  "orientation": "portrait",
+  "theme_color": "#1976d2",
+  "background_color": "#fafafa",
+  "display": "standalone",
+  "scope": "/",
+  "description": "<%= appName %>",
+  "start_url": "/",
+  "icons": [
+    {
+      "src": "icons/icon-72x72.png",
+      "sizes": "72x72",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "icons/icon-96x96.png",
+      "sizes": "96x96",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "icons/icon-128x128.png",
+      "sizes": "128x128",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "icons/icon-144x144.png",
+      "sizes": "144x144",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "icons/icon-152x152.png",
+      "sizes": "152x152",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "icons/icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "icons/icon-256x256.png",
+      "sizes": "256x256",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "icons/icon-384x384.png",
+      "sizes": "384x384",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "icons/icon-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any"
+    }
+  ]
+}

package/esm/src/templates/app/tsconfig.json.template

@@ -0,0 +1,22 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "allowJs": true,
+    "strict": false,
+    "noEmit": true,
+    "incremental": true,
+    "resolveJsonModule": true,
+    "jsx": "preserve",
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": ["./**/*.ts", "./**/*.tsx", ".next/types/**/*.ts"],
+  "references": [
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/esm/src/templates/app/tsconfig.spec.json.template

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

package/esm/src/templates/libRoot/.gitignore.template

@@ -0,0 +1,15 @@
+**/script.ts
+**/script*.ts
+**/.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*
+
+# System Files
+.DS_Store
+Thumbs.db

package/esm/src/templates/libRoot/env/env.server.example.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/libRoot/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/libRoot/package.json.template

@@ -0,0 +1,4 @@
+{
+  "name": "@<%= libName %>",
+  "version": "0.0.1"
+}

package/esm/src/templates/libRoot/tsconfig.json.template

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "jsx": "preserve",
+    "declaration": true,
+    "declarationDir": "dist"
+  },
+  "references": [
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/esm/src/templates/libRoot/tsconfig.spec.json.template

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

package/esm/src/templates/localDev/docker-compose.yaml.template

@@ -0,0 +1,36 @@
+version: "3.8"
+networks:
+  <%= repoName %>-network:
+    driver: bridge
+services:
+  redis:
+    container_name: redis
+    image: redis
+    restart: unless-stopped
+    ports:
+      - 6379:6379
+    networks:
+      - <%= repoName %>-network
+  mongo:
+    image: mongo
+    container_name: mongo
+    restart: unless-stopped
+    ports:
+      - 27017:27017
+    volumes:
+      - ./mongo/local/data:/data/db
+    command: mongod --dbpath /data/db
+    networks:
+      - <%= repoName %>-network
+  meili:
+    image: getmeili/meilisearch:latest
+    container_name: meili
+    restart: unless-stopped
+    ports:
+      - "7700:7700"
+    environment:
+      - MEILI_ENV=development
+      - MEILI_MASTER_KEY=masterKey
+      - MEILI_NO_ANALYTICS=true
+    networks:
+      - <%= repoName %>-network

package/esm/src/templates/pkgRoot/tsconfig.json.template

@@ -0,0 +1,15 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "jsx": "preserve",
+    "declaration": true,
+    "declarationDir": "dist"
+  },
+  "files": [],
+  "include": ["**/*.ts", "**/*.tsx"],
+  "references": [
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/esm/src/templates/workspaceRoot/.env.template

@@ -0,0 +1,20 @@
+# 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=local
+
+# 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

package/esm/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/esm/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/esm/src/templates/workspaceRoot/.prettierrc.json.template

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

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

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

package/esm/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/esm/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/esm/src/templates/workspaceRoot/eslint.config.ts.template

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

package/esm/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/esm/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/package.json

@@ -1,7 +1,7 @@
 {
   "sourceType": "module",
   "name": "@akanjs/cli",
-  "version": "0.0.147",
+  "version": "0.0.149",
   "bin": {
     "akan": "cjs/index.js"
   },

package/src/application/application.command.d.ts

@@ -5,6 +5,7 @@ export declare class ApplicationCommand {
     createApplication(appName: string, start: boolean, workspace: Workspace): Promise<void>;
     removeApplication(app: App): Promise<void>;
     syncApplication(app: App): Promise<void>;
+    script(app: App, filename: string | null): Promise<void>;
     build(app: App): Promise<void>;
     buildBackend(app: App): Promise<void>;
     buildFrontend(app: App): Promise<void>;

package/src/application/application.runner.d.ts

@@ -1,5 +1,6 @@
 import { type AppConfigResult } from "@akanjs/config";
 import { App, AppExecutor, type Workspace } from "@akanjs/devkit";
+import type { SpawnOptions } from "child_process";
 export interface ReleaseSourceOptions {
     rebuild?: boolean;
     buildNum?: number;
@@ -12,12 +13,16 @@ export declare class ApplicationRunner {
     removeApplication(app: App): Promise<void>;
     getConfig(app: App): Promise<AppConfigResult>;
     scanSync(app: App, akanConfig: AppConfigResult): Promise<import("@akanjs/config").AppScanResult | import("@akanjs/config").LibScanResult>;
+    getScriptFilename(app: App): Promise<string>;
+    runScript(app: App, filename: string): Promise<void>;
     buildBackend(app: App): Promise<void>;
     startBackend(app: App, { open, onStart }?: {
         open?: boolean;
         onStart?: () => void;
     }): Promise<void>;
-    buildFrontend(app: App): Promise<void>;
+    buildFrontend(app: App, { spawnOptions }?: {
+        spawnOptions?: SpawnOptions;
+    }): Promise<void>;
     startFrontend(app: App, { open, turbo, onStart }?: {
         open?: boolean;
         turbo?: boolean;

package/src/application/application.script.d.ts

@@ -9,6 +9,7 @@ export declare class ApplicationScript {
     }): Promise<void>;
     removeApplication(app: App): Promise<void>;
     syncApplication(app: App): Promise<import("@akanjs/config").AppScanResult | import("@akanjs/config").LibScanResult>;
+    script(app: App, filename: string | null): Promise<void>;
     build(app: App): Promise<void>;
     start(app: App, { open }?: {
         open?: boolean;
@@ -21,8 +22,9 @@ export declare class ApplicationScript {
         dbup?: boolean;
         sync?: boolean;
     }): Promise<void>;
-    buildFrontend(app: App, { sync }?: {
+    buildFrontend(app: App, { sync, standalone }?: {
         sync?: boolean;
+        standalone?: boolean;
     }): Promise<void>;
     startFrontend(app: App, { open, turbo, sync }?: {
         open?: boolean;

package/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