akanjs 0.0.1 → 2.0.0-beta.0

package/cli/templates/app/env/env.client.local.ts.template

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

package/cli/templates/app/env/env.client.main.ts.template

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

package/cli/templates/app/env/env.client.testing.ts.template

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

package/cli/templates/app/env/env.client.ts

@@ -0,0 +1,21 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  [key: string]: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict = {}) {
+  return `
+import { env as debug } from "./env.client.debug";
+import { env as develop } from "./env.client.develop";
+import { env as local } from "./env.client.local";
+import { env as main } from "./env.client.main";
+import { env as testing } from "./env.client.testing";
+
+const envConfigs = { debug, testing, develop, main, local };
+const currentEnv = process.env.AKAN_PUBLIC_ENV ?? "local";
+if (!(currentEnv in envConfigs)) throw new Error(\`Unknown environment: \${currentEnv}\`);
+
+export const env = envConfigs[currentEnv as keyof typeof envConfigs];
+
+  `;
+}

package/cli/templates/app/env/env.client.type.ts

@@ -0,0 +1,16 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  [key: string]: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict = {}) {
+  return `
+import type { ClientEnv } from "akanjs/base";
+
+export type AppClientEnv = ClientEnv & {
+  cloudflare?: {
+    siteKey: string;
+  };
+};
+  `;
+}

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

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

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

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

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

@@ -0,0 +1,14 @@
+import { getEnv } from "akanjs/base";
+
+import type { ModulesOptions } from "../lib/option";
+
+export const env: ModulesOptions = {
+  ...getEnv(),
+  hostname: null,
+  redis: {},
+  security: {
+    verifies: [["password", "phone", "naver", "kakao"]],
+    sso: {},
+  },
+  rootAdminInfo: { accountId: "admin@admin.com", password: "admin1234" },
+};

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

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

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

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

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

@@ -0,0 +1,20 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  [key: string]: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict = {}) {
+  return `
+import { env as debug } from "./env.server.debug";
+import { env as develop } from "./env.server.develop";
+import { env as local } from "./env.server.local";
+import { env as main } from "./env.server.main";
+import { env as testing } from "./env.server.testing";
+
+const envConfigs = { debug, testing, develop, main, local };
+const currentEnv = process.env.AKAN_PUBLIC_ENV ?? "local";
+if (!(currentEnv in envConfigs)) throw new Error(\`Unknown environment: \${currentEnv}\`);
+
+export const env = envConfigs[currentEnv as keyof typeof envConfigs];
+  `;
+}

package/cli/templates/app/lib/___appName__/__appName__.dictionary.ts

@@ -0,0 +1,17 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  appName: string;
+  AppName: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
+  return `
+import { serviceDictionary } from "akanjs/dictionary";
+
+import type { ${dict.AppName}Endpoint } from "./${dict.appName}.signal";
+
+export const dictionary = serviceDictionary(["en", "ko"])
+  .endpoint<${dict.AppName}Endpoint>((fn) => ({}))
+  .translate({});
+`;
+}

package/cli/templates/app/lib/___appName__/__appName__.service.ts

@@ -0,0 +1,13 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  appName: string;
+  AppName: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
+  return `
+import { serve } from "akanjs/service";
+
+export class ${dict.AppName}Service extends serve("${dict.appName}" as const, { serverMode: "batch" }, () => ({})) {}
+`;
+}

package/cli/templates/app/lib/___appName__/__appName__.signal.ts

@@ -0,0 +1,17 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  appName: string;
+  AppName: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
+  return `
+import { endpoint, internal } from "akanjs/signal";
+
+import * as srv from "../srv";
+
+export class ${dict.AppName}Internal extends internal(srv.${dict.appName}, () => ({})) {}
+
+export class ${dict.AppName}Endpoint extends endpoint(srv.${dict.appName}, () => ({})) {}
+  `;
+}

package/cli/templates/app/lib/___appName__/__appName__.store.ts

@@ -0,0 +1,15 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  appName: string;
+  AppName: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
+  return `
+import { store } from "akanjs/store";
+
+export class ${dict.AppName}Store extends store("${dict.appName}" as const, () => ({
+})) {
+}
+  `;
+}

package/cli/templates/app/lib/option.ts

@@ -0,0 +1,17 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  [key: string]: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict = {}) {
+  return `
+import { AkanOption } from "akanjs/server";
+
+import type { LibOptions } from "./srv";
+
+export type ModulesOptions = LibOptions & {
+};
+
+export const option = new AkanOption<ModulesOptions>();
+  `;
+}

package/cli/templates/app/main.ts

@@ -0,0 +1,16 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  appName: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
+  return `
+import { AkanApp } from "akanjs/server";
+
+const run = async () => {
+  await new AkanApp().start();
+};
+void run();
+
+  `;
+}

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

@@ -0,0 +1,5 @@
+{
+  "type": "module",
+  "name": "@<%= appName %>",
+  "version": "0.0.1"
+}

package/cli/templates/app/page/_index.tsx

@@ -0,0 +1,172 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  appName: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
+  return {
+    filename: "_index.tsx",
+    content: `
+import { Link } from "akanjs/ui";
+import {
+  FaBookOpen,
+  FaBoxOpen,
+  FaCheckCircle,
+  FaCodeBranch,
+  FaExternalLinkAlt,
+  FaLayerGroup,
+  FaRocket,
+  FaShieldAlt,
+  FaTerminal,
+} from "react-icons/fa";
+
+export default function Page() {
+  const appName = ${JSON.stringify(dict.appName)};
+
+  const highlights = [
+    {
+      icon: <FaLayerGroup />,
+      title: "One Codebase",
+      description: "Design pages, services, server contracts, and deployment surfaces in one Akan workspace.",
+    },
+    {
+      icon: <FaShieldAlt />,
+      title: "Type-Safe Flow",
+      description: "Keep application contracts close to the business logic they protect.",
+    },
+    {
+      icon: <FaRocket />,
+      title: "Ready To Ship",
+      description: "Start locally, build production artifacts, and grow without changing the app shape.",
+    },
+  ];
+
+  return (
+    <main className="relative min-h-screen overflow-hidden bg-base-100 text-base-content">
+      <div className="absolute -left-48 -top-48 h-96 w-96 rounded-full bg-primary/25 blur-3xl" />
+      <div className="absolute -bottom-56 -right-40 h-112 w-md rounded-full bg-accent/20 blur-3xl" />
+      <div className="absolute inset-x-0 top-0 h-px bg-linear-to-r from-transparent via-primary/60 to-transparent" />
+
+      <section className="relative mx-auto flex min-h-screen w-full max-w-7xl flex-col px-6 py-8 lg:px-8">
+        <nav className="flex items-center justify-between">
+          <div className="flex items-center gap-3">
+            <div className="flex h-11 w-11 items-center justify-center overflow-hidden rounded-2xl bg-black shadow-lg shadow-primary/20">
+              <img src="/logo.png" alt="Akan.js logo" className="h-full w-full object-cover" />
+            </div>
+            <div>
+              <p className="text-sm font-semibold uppercase tracking-[0.3em] text-primary">Akan.js</p>
+              <p className="text-xs text-base-content/60">Full-stack TypeScript framework</p>
+            </div>
+          </div>
+          <Link href="https://akanjs.com" target="_blank">
+            <button className="btn btn-sm border-base-content/10 bg-base-content/10 text-base-content hover:border-primary hover:bg-primary hover:text-base-100">
+              Official Site
+              <FaExternalLinkAlt />
+            </button>
+          </Link>
+        </nav>
+
+        <div className="grid flex-1 items-center gap-10 py-16 lg:grid-cols-[1.04fr_0.96fr] lg:py-10">
+          <div>
+            <div className="badge mb-6 border-primary/20 bg-primary/10 px-4 py-3 text-primary">
+              <FaCheckCircle />
+              Your app is running
+            </div>
+            <h1 className="max-w-4xl text-5xl font-black tracking-tight text-base-content sm:text-6xl lg:text-7xl">
+              Build your business app as one connected system.
+            </h1>
+            <p className="mt-6 max-w-2xl text-lg leading-8 text-base-content/70">
+              Akan.js helps solo developers and small teams create web, server, database, and deployment-ready
+              surfaces from a single TypeScript workspace.
+            </p>
+
+            <div className="mt-8 flex flex-wrap gap-3">
+              <span className="badge badge-lg border-base-content/10 bg-base-content/10 text-base-content">All-in-one</span>
+              <span className="badge badge-lg border-base-content/10 bg-base-content/10 text-base-content">Type-safe</span>
+              <span className="badge badge-lg border-base-content/10 bg-base-content/10 text-base-content">Minimal code</span>
+              <span className="badge badge-lg border-base-content/10 bg-base-content/10 text-base-content">Bun-first</span>
+            </div>
+
+            <div className="mt-10 flex flex-col gap-3 sm:flex-row">
+              <Link href="https://akanjs.com/docs/intro/quickstart" target="_blank">
+                <button className="btn border-none bg-primary text-base-100 hover:bg-primary/80">
+                  Read Quick Start
+                  <FaBookOpen />
+                </button>
+              </Link>
+              <Link href="https://akanjs.com/docs/intro/practice" target="_blank">
+                <button className="btn border-base-content/10 bg-base-content/10 text-base-content hover:border-base-content/20 hover:bg-base-content/15">
+                  Learn By Building
+                  <FaCodeBranch />
+                </button>
+              </Link>
+            </div>
+          </div>
+
+          <div className="relative">
+            <div className="absolute inset-0 rotate-3 rounded-4xl bg-primary/20 blur-2xl" />
+            <div className="relative overflow-hidden rounded-4xl border border-base-content/10 bg-base-content/6 p-5 shadow-2xl backdrop-blur">
+              <div className="mb-5 flex items-center justify-between rounded-2xl border border-base-content/10 bg-base-100/70 px-4 py-3">
+                <div>
+                  <p className="text-xs uppercase tracking-[0.24em] text-base-content/40">Current App</p>
+                  <p className="text-lg font-semibold text-base-content">{appName}</p>
+                </div>
+                <div className="rounded-xl bg-primary/10 px-3 py-2 text-sm font-medium text-primary">Live</div>
+              </div>
+
+              <div className="mockup-code border border-base-content/10 bg-base-100 text-sm shadow-none">
+                <pre data-prefix="$">
+                  <code className="text-primary">bun run akan start {appName}</code>
+                </pre>
+                <pre data-prefix="✓">
+                  <code className="text-accent">server, web, and app surfaces ready</code>
+                </pre>
+                <pre data-prefix="→">
+                  <code className="text-base-content/70">edit page/_index.tsx to begin</code>
+                </pre>
+              </div>
+
+              <div className="mt-5 grid gap-3 sm:grid-cols-3">
+                {[
+                  ["Pages", "UI routes"],
+                  ["Services", "Typed APIs"],
+                  ["Deploy", "Artifacts"],
+                ].map(([title, description]) => (
+                  <div key={title} className="rounded-2xl border border-base-content/10 bg-base-content/4 p-4">
+                    <p className="text-sm font-semibold text-base-content">{title}</p>
+                    <p className="mt-1 text-xs text-base-content/60">{description}</p>
+                  </div>
+                ))}
+              </div>
+            </div>
+          </div>
+        </div>
+
+        <div className="grid gap-4 pb-8 md:grid-cols-3">
+          {highlights.map((item) => (
+            <div key={item.title} className="rounded-3xl border border-base-content/10 bg-base-content/4 p-6 backdrop-blur">
+              <div className="mb-5 flex h-12 w-12 items-center justify-center rounded-2xl bg-primary/10 text-xl text-primary">
+                {item.icon}
+              </div>
+              <h2 className="text-lg font-bold text-base-content">{item.title}</h2>
+              <p className="mt-2 text-sm leading-6 text-base-content/60">{item.description}</p>
+            </div>
+          ))}
+        </div>
+
+        <div className="flex flex-col items-start justify-between gap-4 rounded-3xl border border-base-content/10 bg-base-content/4 p-5 text-sm text-base-content/70 md:flex-row md:items-center">
+          <div className="flex items-center gap-3">
+            <FaTerminal className="text-primary" />
+            <span>Next: open your workspace and start shaping the product around your business model.</span>
+          </div>
+          <div className="flex items-center gap-2 text-base-content/40">
+            <FaBoxOpen />
+            <span>Akan.js template</span>
+          </div>
+        </div>
+      </section>
+    </main>
+  );
+}`,
+  };
+}

package/cli/templates/app/page/_layout.tsx

@@ -0,0 +1,32 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  appName: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict, options: { libs: string[] }) {
+  const isUsingShared = options.libs.includes("shared");
+  return {
+    filename: "_layout.tsx",
+    content: `
+import "./styles.css";
+import type { LayoutProps } from "akanjs/client";
+import { fetch } from "@${dict.appName}/client";
+${isUsingShared ? "import { Auth } from '@shared/ui';" : ""}
+
+export const head = (
+  <>
+    <title>${dict.appName}</title>
+    <link rel="icon" href="/favicon.ico" />
+  </>
+);
+
+export default function Layout({ children }: LayoutProps) {
+  return (
+    <>
+      {children}${isUsingShared ? "\n      <Auth.User />\n      <Auth.Admin />" : ""}
+    </>
+  );
+}
+  `,
+  };
+}

package/cli/templates/app/page/styles.css.template

@@ -0,0 +1,53 @@
+@import "tailwindcss";
+@import "akanjs/ui/styles.css";
+
+@plugin "daisyui" {
+  logs: false;
+  exclude: properties;
+}
+
+@plugin "daisyui/theme" {
+  name: "light";
+  --color-primary: #c33c32;
+  --color-secondary: #2b2e33;
+  --color-accent: #e67e22;
+  --color-accent-content: #ffffff;
+  --color-base-content: #2c3e50;
+  --color-base-100: #fafafa;
+  --color-base-200: #f5f5f5;
+  --color-info: #f1fdff;
+  --color-info-content: #2c3e50;
+  --color-neutral: #292c32;
+  --color-neutral-content: #fafafa;
+  --color-success: #2ecc71;
+  --color-success-content: #fafafa;
+  --color-warning: #f39c12;
+  --color-warning-content: #fafafa;
+  --color-error: #e74c3c;
+  --color-error-content: #fafafa;
+  --color-open: #27ae60;
+  --color-open-content: #fafafa;
+}
+
+@plugin "daisyui/theme" {
+  name: "dark";
+  default: true;
+  --color-primary: #ff493b;
+  --color-secondary: #2b2e33;
+  --color-accent: #d1a23b;
+  --color-accent-content: #ffffff;
+  --color-base-content: #ffffff;
+  --color-base-100: #1a1a1a;
+  --color-base-200: #2a2a2a;
+  --color-info: #173b78;
+  --color-info-content: #ffffff;
+  --color-neutral: #3ed13b;
+  --color-neutral-content: #ffffff;
+  --color-success: #255fc3;
+  --color-success-content: #ffffff;
+  --color-warning: #ffcc00;
+  --color-warning-content: #ffffff;
+  --color-error: #f02020;
+  --color-error-content: #ffffff;
+  --color-open: #10fc00;
+}

package/cli/templates/app/srvkit/backendLogic.ts

@@ -0,0 +1,12 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  appName: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
+  return `
+
+export const someBackendLogic = () => {
+};
+  `;
+}

package/cli/templates/app/srvkit/index.ts

@@ -0,0 +1,10 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  [key: string]: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict = {}) {
+  return `
+export * from "./backendLogic";
+  `;
+}

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

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

package/cli/templates/app/ui/UiComponent.ts

@@ -0,0 +1,16 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  appName: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
+  return {
+    filename: "UiComponent.tsx",
+    content: `
+
+export const UiComponent = () => {
+  return <div>UiComponent</div>;
+};
+  `,
+  };
+}

package/cli/templates/app/ui/index.ts

@@ -0,0 +1,10 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  [key: string]: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict = {}) {
+  return `
+export { UiComponent } from "./UiComponent";
+`;
+}

package/cli/templates/app/webkit/frontendLogic.ts

@@ -0,0 +1,12 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  appName: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
+  return `
+
+export const someFrontendLogic = () => {
+};
+  `;
+}

package/cli/templates/app/webkit/index.ts

@@ -0,0 +1,10 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+interface Dict {
+  [key: string]: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict = {}) {
+  return `
+export * from "./frontendLogic";
+  `;
+}

package/cli/templates/client.ts

@@ -0,0 +1,46 @@
+import type { AppInfo, LibInfo } from "akanjs/devkit";
+
+const capitalize = (str: string) => str.charAt(0).toUpperCase() + str.slice(1);
+
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { [key: string]: string } = {}) {
+  if (!scanInfo) return null;
+  const databaseModules = [...scanInfo.database.entries()]
+    .filter(
+      ([_, fileTypes]) =>
+        fileTypes.has("template") ||
+        fileTypes.has("unit") ||
+        fileTypes.has("util") ||
+        fileTypes.has("view") ||
+        fileTypes.has("zone"),
+    )
+    .map(([key]) => key);
+  const scalarModules = [...scanInfo.scalar.entries()]
+    .filter(
+      ([_, fileTypes]) =>
+        fileTypes.has("template") ||
+        fileTypes.has("unit") ||
+        fileTypes.has("util") ||
+        fileTypes.has("view") ||
+        fileTypes.has("zone"),
+    )
+    .map(([key]) => key);
+  const serviceModules = [...scanInfo.service.entries()]
+    .filter(
+      ([_, fileTypes]) =>
+        fileTypes.has("template") ||
+        fileTypes.has("unit") ||
+        fileTypes.has("util") ||
+        fileTypes.has("view") ||
+        fileTypes.has("zone"),
+    )
+    .map(([key]) => key);
+  return `
+export * as cnst from "./lib/cnst";
+export { msg, Err, usePage, fetch, sig } from "./lib/useClient";
+export { st, RootStore } from "./lib/st";
+export * as store from "./lib/st";
+${scalarModules.map((module) => `export { ${capitalize(module)} } from "./lib/__scalar/${module}";`).join("\n")}
+${serviceModules.map((module) => `export { ${capitalize(module)} } from "./lib/_${module}";`).join("\n")}
+${databaseModules.map((module) => `export { ${capitalize(module)} } from "./lib/${module}";`).join("\n")}
+`;
+}