@podosoft/podokit 0.1.1 → 0.3.0

package/dist/templates/todo/apps/web/src/lib/components/ui/tooltip/tooltip-content.svelte

@@ -0,0 +1,52 @@
+<script lang="ts">
+	import { Tooltip as TooltipPrimitive } from "bits-ui";
+	import { cn } from "$lib/utils.js";
+	import TooltipPortal from "./tooltip-portal.svelte";
+	import type { ComponentProps } from "svelte";
+	import type { WithoutChildrenOrChild } from "$lib/utils.js";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		sideOffset = 0,
+		side = "top",
+		children,
+		arrowClasses,
+		portalProps,
+		...restProps
+	}: TooltipPrimitive.ContentProps & {
+		arrowClasses?: string;
+		portalProps?: WithoutChildrenOrChild<ComponentProps<typeof TooltipPortal>>;
+	} = $props();
+</script>
+
+<TooltipPortal {...portalProps}>
+	<TooltipPrimitive.Content
+		bind:ref
+		data-slot="tooltip-content"
+		{sideOffset}
+		{side}
+		class={cn(
+			"data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs has-data-[slot=kbd]:pr-1.5 **:data-[slot=kbd]:relative **:data-[slot=kbd]:isolate **:data-[slot=kbd]:z-50 **:data-[slot=kbd]:rounded-sm bg-foreground text-background z-50 w-fit max-w-xs origin-(--bits-tooltip-content-transform-origin)",
+			className
+		)}
+		{...restProps}
+	>
+		{@render children?.()}
+		<TooltipPrimitive.Arrow>
+			{#snippet child({ props })}
+				<div
+					class={cn(
+						"size-2.5 translate-y-[calc(-50%-2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground z-50",
+						"data-[side=top]:translate-x-1/2 data-[side=top]:translate-y-[calc(-50%+2px)]",
+						"data-[side=bottom]:-translate-x-1/2 data-[side=bottom]:-translate-y-[calc(-50%+1px)]",
+						"data-[side=right]:translate-x-[calc(50%+2px)] data-[side=right]:translate-y-1/2",
+						"data-[side=left]:-translate-y-[calc(50%-3px)]",
+						arrowClasses
+					)}
+					{...props}
+				></div>
+			{/snippet}
+		</TooltipPrimitive.Arrow>
+	</TooltipPrimitive.Content>
+</TooltipPortal>

package/dist/templates/todo/apps/web/src/lib/components/ui/tooltip/tooltip-portal.svelte

@@ -0,0 +1,7 @@
+<script lang="ts">
+	import { Tooltip as TooltipPrimitive } from "bits-ui";
+
+	let { ...restProps }: TooltipPrimitive.PortalProps = $props();
+</script>
+
+<TooltipPrimitive.Portal {...restProps} />

package/dist/templates/todo/apps/web/src/lib/components/ui/tooltip/tooltip-provider.svelte

@@ -0,0 +1,7 @@
+<script lang="ts">
+	import { Tooltip as TooltipPrimitive } from "bits-ui";
+
+	let { delayDuration = 0, ...restProps }: TooltipPrimitive.ProviderProps = $props();
+</script>
+
+<TooltipPrimitive.Provider {delayDuration} {...restProps} />

package/dist/templates/todo/apps/web/src/lib/components/ui/tooltip/tooltip-trigger.svelte

@@ -0,0 +1,7 @@
+<script lang="ts" generics="T = never">
+	import { Tooltip as TooltipPrimitive } from "bits-ui";
+
+	let { ref = $bindable(null), ...restProps }: TooltipPrimitive.TriggerProps<T> = $props();
+</script>
+
+<TooltipPrimitive.Trigger bind:ref data-slot="tooltip-trigger" {...restProps} />

package/dist/templates/todo/apps/web/src/lib/components/ui/tooltip/tooltip.svelte

@@ -0,0 +1,7 @@
+<script lang="ts" generics="T = never">
+	import { Tooltip as TooltipPrimitive } from "bits-ui";
+
+	let { open = $bindable(false), ...restProps }: TooltipPrimitive.RootProps<T> = $props();
+</script>
+
+<TooltipPrimitive.Root bind:open {...restProps} />

package/dist/templates/todo/apps/web/src/lib/i18n/README.md

@@ -0,0 +1,7 @@
+# i18n
+
+Locales use [typesafe-i18n](https://github.com/ivanhofer/typesafe-i18n).
+
+- `en.ts` is the base locale; `ko.ts` mirrors its shape.
+- Run `npx typesafe-i18n` to generate the typed runtime and Svelte store,
+  then use `$LL.appTitle()` in components. Add keys to every locale.

package/dist/templates/todo/apps/web/src/lib/i18n/en.ts

@@ -0,0 +1,10 @@
+import type { BaseTranslation } from "typesafe-i18n";
+
+// Base locale. Run `npx typesafe-i18n` to generate the typed runtime,
+// then access strings as `$LL.appTitle()` in components.
+const en = {
+  appTitle: "{{projectName}}",
+  checkHealth: "Check API health",
+} satisfies BaseTranslation;
+
+export default en;

package/dist/templates/todo/apps/web/src/lib/i18n/ko.ts

@@ -0,0 +1,11 @@
+import type { BaseTranslation } from "typesafe-i18n";
+
+// Uses BaseTranslation until you generate typed runtimes with `npx typesafe-i18n`.
+// After generating, switch to `import type { Translation } from "../i18n-types"`
+// so this locale is checked against the base locale's keys.
+const ko = {
+  appTitle: "{{projectName}}",
+  checkHealth: "API 상태 확인",
+} satisfies BaseTranslation;
+
+export default ko;

package/dist/templates/todo/apps/web/src/lib/server/backend-proxy.ts

@@ -0,0 +1,16 @@
+// Server-side proxy boundary. The browser never talks to the API directly:
+// only these allowlisted headers are forwarded to BACKEND_INTERNAL_URL.
+const FORWARDED_HEADERS = ["authorization", "cookie", "content-type"];
+
+export function backendBaseUrl(): string {
+  return process.env.BACKEND_INTERNAL_URL ?? "http://localhost:3000";
+}
+
+export function backendProxyHeaders(request: Request): Headers {
+  const headers = new Headers();
+  for (const name of FORWARDED_HEADERS) {
+    const value = request.headers.get(name);
+    if (value) headers.set(name, value);
+  }
+  return headers;
+}

package/dist/templates/todo/apps/web/src/lib/utils.ts

@@ -0,0 +1,11 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]): string {
+  return twMerge(clsx(inputs));
+}
+
+export type WithoutChild<T> = T extends { child?: unknown } ? Omit<T, "child"> : T;
+export type WithoutChildren<T> = T extends { children?: unknown } ? Omit<T, "children"> : T;
+export type WithoutChildrenOrChild<T> = WithoutChildren<WithoutChild<T>>;
+export type WithElementRef<T, U extends HTMLElement = HTMLElement> = T & { ref?: U | null };

package/dist/templates/todo/apps/web/src/routes/+layout.svelte

@@ -0,0 +1,9 @@
+<script lang="ts">
+  import "../app.css";
+  import { ModeWatcher } from "mode-watcher";
+
+  let { children } = $props();
+</script>
+
+<ModeWatcher />
+{@render children()}

package/dist/templates/todo/apps/web/src/routes/+page.svelte

@@ -0,0 +1,95 @@
+<script lang="ts">
+  import { Button } from "$lib/components/ui/button";
+  import { Input } from "$lib/components/ui/input";
+  import { Checkbox } from "$lib/components/ui/checkbox";
+  import * as Card from "$lib/components/ui/card";
+
+  type Todo = { id: string; title: string; completed: boolean };
+
+  let todos = $state<Todo[]>([]);
+  let title = $state("");
+  let error = $state<string | null>(null);
+
+  async function load(): Promise<void> {
+    const res = await fetch("/api/todos");
+    if (res.ok) todos = await res.json();
+    else error = `Failed to load (HTTP ${res.status})`;
+  }
+
+  async function add(event: SubmitEvent): Promise<void> {
+    event.preventDefault();
+    const value = title.trim();
+    if (!value) return;
+    const res = await fetch("/api/todos", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ title: value }),
+    });
+    if (res.ok) {
+      title = "";
+      await load();
+    } else {
+      error = `Failed to add (HTTP ${res.status})`;
+    }
+  }
+
+  async function toggle(todo: Todo): Promise<void> {
+    await fetch(`/api/todos/${todo.id}`, {
+      method: "PATCH",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ completed: !todo.completed }),
+    });
+    await load();
+  }
+
+  async function remove(todo: Todo): Promise<void> {
+    await fetch(`/api/todos/${todo.id}`, { method: "DELETE" });
+    await load();
+  }
+
+  $effect(() => {
+    void load();
+  });
+</script>
+
+<main class="mx-auto flex min-h-full max-w-xl flex-col gap-6 p-8">
+  <div>
+    <h1 class="text-3xl font-bold">{{projectName}}</h1>
+    <p class="text-muted-foreground text-sm">Full-stack starter generated with PodoKit.</p>
+  </div>
+
+  <Card.Root>
+    <Card.Header>
+      <Card.Title>Todos</Card.Title>
+      <Card.Description>A NestJS + SvelteKit CRUD example.</Card.Description>
+    </Card.Header>
+    <Card.Content class="flex flex-col gap-4">
+      <form class="flex gap-2" onsubmit={add}>
+        <Input placeholder="Add a todo…" bind:value={title} />
+        <Button type="submit">Add</Button>
+      </form>
+
+      {#if error}
+        <p class="text-destructive text-sm">{error}</p>
+      {/if}
+
+      <ul class="divide-border flex flex-col divide-y">
+        {#each todos as todo (todo.id)}
+          <li class="flex items-center gap-3 py-3">
+            <Checkbox checked={todo.completed} onCheckedChange={() => toggle(todo)} />
+            <span
+              class="flex-1 text-sm"
+              class:line-through={todo.completed}
+              class:text-muted-foreground={todo.completed}
+            >
+              {todo.title}
+            </span>
+            <Button variant="ghost" size="sm" onclick={() => remove(todo)}>Delete</Button>
+          </li>
+        {:else}
+          <li class="text-muted-foreground py-6 text-center text-sm">No todos yet — add one above.</li>
+        {/each}
+      </ul>
+    </Card.Content>
+  </Card.Root>
+</main>

package/dist/templates/todo/apps/web/src/routes/api/health/+server.ts

@@ -0,0 +1,12 @@
+import type { RequestHandler } from "@sveltejs/kit";
+import { backendBaseUrl, backendProxyHeaders } from "$lib/server/backend-proxy";
+
+export const GET: RequestHandler = async ({ request }) => {
+  const upstream = await fetch(`${backendBaseUrl()}/health`, {
+    headers: backendProxyHeaders(request),
+  });
+  return new Response(await upstream.text(), {
+    status: upstream.status,
+    headers: { "content-type": "application/json" },
+  });
+};

package/dist/templates/todo/apps/web/src/routes/api/todos/+server.ts

@@ -0,0 +1,24 @@
+import type { RequestHandler } from "@sveltejs/kit";
+import { backendBaseUrl, backendProxyHeaders } from "$lib/server/backend-proxy";
+
+export const GET: RequestHandler = async ({ request }) => {
+  const upstream = await fetch(`${backendBaseUrl()}/todos`, { headers: backendProxyHeaders(request) });
+  return new Response(await upstream.text(), {
+    status: upstream.status,
+    headers: { "content-type": "application/json" },
+  });
+};
+
+export const POST: RequestHandler = async ({ request }) => {
+  const headers = backendProxyHeaders(request);
+  headers.set("content-type", "application/json");
+  const upstream = await fetch(`${backendBaseUrl()}/todos`, {
+    method: "POST",
+    headers,
+    body: await request.text(),
+  });
+  return new Response(await upstream.text(), {
+    status: upstream.status,
+    headers: { "content-type": "application/json" },
+  });
+};

package/dist/templates/todo/apps/web/src/routes/api/todos/[id]/+server.ts

@@ -0,0 +1,24 @@
+import type { RequestHandler } from "@sveltejs/kit";
+import { backendBaseUrl, backendProxyHeaders } from "$lib/server/backend-proxy";
+
+export const PATCH: RequestHandler = async ({ request, params }) => {
+  const headers = backendProxyHeaders(request);
+  headers.set("content-type", "application/json");
+  const upstream = await fetch(`${backendBaseUrl()}/todos/${params.id}`, {
+    method: "PATCH",
+    headers,
+    body: await request.text(),
+  });
+  return new Response(await upstream.text(), {
+    status: upstream.status,
+    headers: { "content-type": "application/json" },
+  });
+};
+
+export const DELETE: RequestHandler = async ({ request, params }) => {
+  const upstream = await fetch(`${backendBaseUrl()}/todos/${params.id}`, {
+    method: "DELETE",
+    headers: backendProxyHeaders(request),
+  });
+  return new Response(null, { status: upstream.status });
+};

package/dist/templates/todo/apps/web/svelte.config.js

@@ -0,0 +1,15 @@
+import adapter from "@sveltejs/adapter-node";
+import { vitePreprocess } from "@sveltejs/vite-plugin-svelte";
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+  preprocess: vitePreprocess(),
+  kit: {
+    adapter: adapter(),
+    alias: {
+      $i18n: "src/lib/i18n",
+    },
+  },
+};
+
+export default config;

package/dist/templates/todo/apps/web/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./.svelte-kit/tsconfig.json",
+  "compilerOptions": {
+    "strict": true,
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  }
+}

package/dist/templates/todo/apps/web/vite.config.ts

@@ -0,0 +1,7 @@
+import { sveltekit } from "@sveltejs/kit/vite";
+import tailwindcss from "@tailwindcss/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [tailwindcss(), sveltekit()],
+});

package/dist/templates/todo/dot-env.example

@@ -0,0 +1,16 @@
+# Copy to .env and adjust. Never commit real secrets.
+NODE_ENV=development
+PORT=3000
+
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+POSTGRES_USER=podokit
+POSTGRES_PASSWORD=podokit
+POSTGRES_DB=podokit
+
+REDIS_HOST=localhost
+REDIS_PORT=6379
+
+# Web -> API boundary (server-side only; not exposed to the browser)
+BACKEND_INTERNAL_URL=http://localhost:3000
+CORS_ORIGIN=http://localhost:5173

package/dist/templates/todo/dot-gitignore

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+build/
+.svelte-kit/
+.env
+.env.*
+!.env.example
+.DS_Store
+*.log

package/dist/templates/todo/infra/docker/docker-compose.yml

@@ -0,0 +1,29 @@
+services:
+  postgres:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-podokit}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-podokit}
+      POSTGRES_DB: ${POSTGRES_DB:-podokit}
+    ports:
+      - "${POSTGRES_PORT:-5432}:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-podokit}"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  redis:
+    image: redis:7-alpine
+    ports:
+      - "${REDIS_PORT:-6379}:6379"
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  pgdata:

package/dist/templates/todo/infra/k3s/api-deployment.yaml

@@ -0,0 +1,24 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: api
+  namespace: podokit
+spec:
+  replicas: 1
+  selector:
+    matchLabels: { app: api }
+  template:
+    metadata:
+      labels: { app: api }
+    spec:
+      containers:
+        - name: api
+          image: ghcr.io/example/podokit-api:latest
+          ports:
+            - containerPort: 3000
+          envFrom:
+            - configMapRef: { name: app-config }
+            - secretRef: { name: app-secrets }
+          readinessProbe:
+            httpGet: { path: /health, port: 3000 }
+            initialDelaySeconds: 5

package/dist/templates/todo/infra/k3s/configmap.yaml

@@ -0,0 +1,10 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: app-config
+  namespace: podokit
+data:
+  NODE_ENV: "production"
+  PORT: "3000"
+  CORS_ORIGIN: "https://example.com"
+  BACKEND_INTERNAL_URL: "http://api:3000"

package/dist/templates/todo/infra/k3s/ingress.yaml

@@ -0,0 +1,18 @@
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: app
+  namespace: podokit
+spec:
+  rules:
+    - host: example.com
+      http:
+        paths:
+          - path: /api
+            pathType: Prefix
+            backend:
+              service: { name: api, port: { number: 3000 } }
+          - path: /
+            pathType: Prefix
+            backend:
+              service: { name: web, port: { number: 3000 } }

package/dist/templates/todo/infra/k3s/namespace.yaml

@@ -0,0 +1,4 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: podokit

package/dist/templates/todo/infra/k3s/secret.example.yaml

@@ -0,0 +1,10 @@
+# Example only. Never commit real secrets. Create the real Secret out-of-band:
+#   kubectl -n podokit create secret generic app-secrets --from-literal=POSTGRES_PASSWORD=...
+apiVersion: v1
+kind: Secret
+metadata:
+  name: app-secrets
+  namespace: podokit
+type: Opaque
+stringData:
+  POSTGRES_PASSWORD: "change-me"

package/dist/templates/todo/infra/k3s/services.yaml

@@ -0,0 +1,21 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: api
+  namespace: podokit
+spec:
+  selector: { app: api }
+  ports:
+    - port: 3000
+      targetPort: 3000
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: web
+  namespace: podokit
+spec:
+  selector: { app: web }
+  ports:
+    - port: 3000
+      targetPort: 3000

package/dist/templates/todo/infra/k3s/web-deployment.yaml

@@ -0,0 +1,20 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: web
+  namespace: podokit
+spec:
+  replicas: 1
+  selector:
+    matchLabels: { app: web }
+  template:
+    metadata:
+      labels: { app: web }
+    spec:
+      containers:
+        - name: web
+          image: ghcr.io/example/podokit-web:latest
+          ports:
+            - containerPort: 3000
+          envFrom:
+            - configMapRef: { name: app-config }

package/dist/templates/todo/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.0.0",
+  "private": true,
+  "engines": { "node": ">=20" },
+  "workspaces": ["apps/*"],
+  "scripts": {
+    "dev": "npm run dev --workspaces --if-present",
+    "build": "npm run build --workspaces --if-present",
+    "lint": "npm run lint --workspaces --if-present",
+    "test": "npm run test --workspaces --if-present"
+  }
+}

package/dist/templates.d.ts

@@ -0,0 +1,10 @@
+export interface TemplateInfo {
+    name: string;
+    description: string;
+}
+export declare const TEMPLATES: TemplateInfo[];
+export declare const DEFAULT_TEMPLATE: string;
+export declare const TEMPLATE_NAMES: string[];
+export declare function isKnownTemplate(name: string): boolean;
+/** Human-readable list of templates with descriptions, for prompts and help. */
+export declare function templateListText(): string;

package/dist/templates.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEMPLATE_NAMES = exports.DEFAULT_TEMPLATE = exports.TEMPLATES = void 0;
+exports.isKnownTemplate = isKnownTemplate;
+exports.templateListText = templateListText;
+// Order matters: the first entry is the default and prompts list them in order.
+exports.TEMPLATES = [
+    {
+        name: "fullstack-nest-svelte",
+        description: "NestJS + SvelteKit starter — TypeORM wired, Swagger, no domain code (clean)",
+    },
+    {
+        name: "todo",
+        description: "Fullstack starter plus a Todo CRUD example (DB entity, migration, UI)",
+    },
+    {
+        name: "base",
+        description: "Minimal npm workspace to build up from scratch",
+    },
+];
+exports.DEFAULT_TEMPLATE = exports.TEMPLATES[0].name;
+exports.TEMPLATE_NAMES = exports.TEMPLATES.map((t) => t.name);
+function isKnownTemplate(name) {
+    return exports.TEMPLATE_NAMES.includes(name);
+}
+/** Human-readable list of templates with descriptions, for prompts and help. */
+function templateListText() {
+    const width = Math.max(...exports.TEMPLATES.map((t) => t.name.length));
+    return exports.TEMPLATES.map((t) => {
+        const suffix = t.name === exports.DEFAULT_TEMPLATE ? " (default)" : "";
+        return `  ${t.name.padEnd(width)}  ${t.description}${suffix}`;
+    }).join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@podosoft/podokit",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "An opinionated but extensible starter toolkit and CLI for full-stack TypeScript apps with NestJS, SvelteKit, TailwindCSS, shadcn-svelte, Docker, and k3s.",
   "license": "Apache-2.0",
   "repository": {
@@ -36,6 +36,6 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@podosoft/podokit-template-engine": "^0.1.0"
+    "@podosoft/podokit-template-engine": "^0.3.0"
   }
 }