@gaonjs/cli 0.23.0 → 0.25.0

package/dist/templates/project/apps/web/pages/Home/Index.vue.tpl

@@ -2,8 +2,8 @@
 import { computed } from 'vue'
 import { pageProps } from 'gaonjs/vue'
 import { useGaonHealth, type HealthDoctor } from '../../composables/useGaonHealth.js'
-import Card from '../../components/ui/Card.vue'
-import Badge from '../../components/ui/Badge.vue'
+import Card from '@shared/components/ui/Card.vue'
+import Badge from '@shared/components/ui/Badge.vue'
 
 // home#index 의 render props — Serialized<> 로 넘어온다(§6.2).
 // 라우트 키는 .gaon/routes.d.ts 가 유효한 값을 알려준다.
@@ -230,7 +230,7 @@ const routeLines = computed<CodeLine[]>(() => {
 
     <p class="mt-8 text-center text-xs text-muted-foreground">
       <Badge variant="secondary">UI 킷</Badge>
-      이 화면·카드·다음 단계는 gaon g ui-kit 로 심은 컴포넌트로 그렸습니다 — apps/web/components/ui/ 에서 소유·수정하세요.
+      이 화면·카드·다음 단계는 gaon g ui-kit 로 심은 컴포넌트로 그렸습니다 — shared/components/ui/ 에서 소유·수정하세요.
     </p>
   </div>
 </template>

package/dist/templates/project/apps/web/style.css.tpl

@@ -6,53 +6,63 @@
  * :root/.dark 의 CSS 변수 = 디자인 토큰(shadcn 관례). UI 킷 컴포넌트는 이
  * 토큰(bg-primary·text-muted-foreground …)만 참조하므로, 브랜드 색을 바꾸려면
  * 여기 한 곳만 고친다. hsl 채널 값으로 두는 이유는 tailwind.config.ts 가
- * hsl(var(--token)) 로 감싸 투명도 유틸(bg-primary/50)까지 동작하게 하기 위함이다. */
+ * hsl(var(--token)) 로 감싸 투명도 유틸(bg-primary/50)까지 동작하게 하기 위함이다.
+ *
+ * 결정 107: 토큰(:root·.dark)은 @layer base **밖**에 둔다 — @layer 안의 클래스
+ * 선택자 규칙(.dark)은 content 에 'dark' 문자열이 없으면 Tailwind 가 purge 해
+ * 다크 모드가 조용히 안 됐다(:root 등 요소 선택자는 남지만 .dark 는 사라짐).
+ * 토큰은 CSS 변수만 정의하므로 layer 밖이어도 유틸 속성과 충돌하지 않는다. */
 @tailwind base;
 @tailwind components;
 @tailwind utilities;
 
-@layer base {
-  :root {
-    --background: 0 0% 100%;
-    --foreground: 240 10% 3.9%;
-    --card: 0 0% 100%;
-    --card-foreground: 240 10% 3.9%;
-    --primary: 240 5.9% 10%;
-    --primary-foreground: 0 0% 98%;
-    --secondary: 240 4.8% 95.9%;
-    --secondary-foreground: 240 5.9% 10%;
-    --muted: 240 4.8% 95.9%;
-    --muted-foreground: 240 3.8% 46.1%;
-    --accent: 240 4.8% 95.9%;
-    --accent-foreground: 240 5.9% 10%;
-    --destructive: 0 84.2% 60.2%;
-    --destructive-foreground: 0 0% 98%;
-    --border: 240 5.9% 90%;
-    --input: 240 5.9% 90%;
-    --ring: 240 5.9% 10%;
-    --radius: 0.5rem;
-  }
+:root {
+  --background: 0 0% 100%;
+  --foreground: 240 10% 3.9%;
+  --card: 0 0% 100%;
+  --card-foreground: 240 10% 3.9%;
+  --primary: 240 5.9% 10%;
+  --primary-foreground: 0 0% 98%;
+  --secondary: 240 4.8% 95.9%;
+  --secondary-foreground: 240 5.9% 10%;
+  --muted: 240 4.8% 95.9%;
+  --muted-foreground: 240 3.8% 46.1%;
+  --accent: 240 4.8% 95.9%;
+  --accent-foreground: 240 5.9% 10%;
+  --destructive: 0 84.2% 60.2%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 240 5.9% 90%;
+  --input: 240 5.9% 90%;
+  --ring: 240 5.9% 10%;
+  --radius: 0.5rem;
+  /* 모바일·반응형 토큰(결정 107). tap-target-min = 터치 최소 타깃(권장 44px) ·
+     font-size-min = 입력·본문 최소 글꼴(iOS 가 16px 미만 입력에 포커스하면
+     화면을 자동 확대하는 것을 막는 값). 라이트/다크 공통이라 :root 한 곳에 둔다. */
+  --tap-target-min: 44px;
+  --font-size-min: 16px;
+}
 
-  .dark {
-    --background: 240 10% 3.9%;
-    --foreground: 0 0% 98%;
-    --card: 240 10% 3.9%;
-    --card-foreground: 0 0% 98%;
-    --primary: 0 0% 98%;
-    --primary-foreground: 240 5.9% 10%;
-    --secondary: 240 3.7% 15.9%;
-    --secondary-foreground: 0 0% 98%;
-    --muted: 240 3.7% 15.9%;
-    --muted-foreground: 240 5% 64.9%;
-    --accent: 240 3.7% 15.9%;
-    --accent-foreground: 0 0% 98%;
-    --destructive: 0 62.8% 30.6%;
-    --destructive-foreground: 0 0% 98%;
-    --border: 240 3.7% 15.9%;
-    --input: 240 3.7% 15.9%;
-    --ring: 240 4.9% 83.9%;
-  }
+.dark {
+  --background: 240 10% 3.9%;
+  --foreground: 0 0% 98%;
+  --card: 240 10% 3.9%;
+  --card-foreground: 0 0% 98%;
+  --primary: 0 0% 98%;
+  --primary-foreground: 240 5.9% 10%;
+  --secondary: 240 3.7% 15.9%;
+  --secondary-foreground: 0 0% 98%;
+  --muted: 240 3.7% 15.9%;
+  --muted-foreground: 240 5% 64.9%;
+  --accent: 240 3.7% 15.9%;
+  --accent-foreground: 0 0% 98%;
+  --destructive: 0 62.8% 30.6%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 240 3.7% 15.9%;
+  --input: 240 3.7% 15.9%;
+  --ring: 240 4.9% 83.9%;
+}
 
+@layer base {
   * {
     border-color: hsl(var(--border));
   }
@@ -63,4 +73,15 @@
     font-family: system-ui, -apple-system, 'Segoe UI', sans-serif;
     -webkit-font-smoothing: antialiased;
   }
+
+  /* 모바일(≤640px): 입력 글꼴이 16px 미만이면 iOS 가 포커스 시 화면을 확대한다.
+     UI 킷 Input 은 text-sm(14px)이라 좁은 화면에서만 최소 글꼴을 보장한다(결정 107).
+     데스크톱은 원래 text-sm 을 그대로 둔다. */
+  @media (max-width: 640px) {
+    input,
+    textarea,
+    select {
+      font-size: var(--font-size-min);
+    }
+  }
 }

package/dist/templates/project/tsconfig.json.tpl

@@ -11,7 +11,11 @@
     "resolveJsonModule": true,
     "noEmit": true,
     "jsx": "preserve",
-    "types": ["node", "vite/client"]
+    "types": ["node", "vite/client"],
+    "baseUrl": ".",
+    "paths": {
+      "@shared/*": ["./shared/*"]
+    }
   },
   "include": [
     "apps/**/*.ts",

package/dist/templates/project/vite.config.ts.tpl

@@ -7,13 +7,29 @@
 // 앱이 하나 이상이면 각 앱마다 vite.config.ts 를 두는 것이 아니라, 이 루트
 // 파일 하나가 root 를 apps/<앱> 으로 잡고 여러 번 실행된다(gaon dev 가 앱별
 // Vite 서버를 띄운다). 관례가 곧 배치.
+import { fileURLToPath } from 'node:url'
 import { defineConfig } from 'vite'
 import vue from '@vitejs/plugin-vue'
 
+// @shared → 프로젝트 루트의 shared/ (결정 105). UI 킷은 shared/components/ui 에
+// 프로젝트당 한 벌만 있고, 앱 페이지는 @shared 로 참조한다. root 가 apps/web 이라
+// shared 는 root 밖이므로, dev 서버가 읽을 수 있게 fs.allow 에 프로젝트 루트를 넣는다.
+const projectRoot = fileURLToPath(new URL('.', import.meta.url))
+const sharedDir = fileURLToPath(new URL('./shared', import.meta.url))
+
 export default defineConfig({
   // 기본 앱은 apps/web · gaon dev 가 다른 앱에 대해 root 를 재정의한다.
   root: 'apps/web',
   plugins: [vue()],
+  resolve: {
+    // 앱 페이지에서 shared UI 킷을 @shared 로 참조한다(결정 105).
+    // 예) import Button from '@shared/components/ui/Button.vue'
+    alias: { '@shared': sharedDir },
+  },
+  server: {
+    // root(apps/web) 밖의 shared 를 dev 서버가 읽도록 허용한다.
+    fs: { allow: [projectRoot] },
+  },
   build: {
     outDir: '../../dist/web',
     emptyOutDir: true,

package/dist/templates/ui-kit/EmptyState.vue.tpl

@@ -0,0 +1,23 @@
+<script setup lang="ts">
+// UI 킷 블록 · EmptyState (결정 106). 빈 목록·무결과 안내. 아이콘(슬롯)·제목·
+// 설명·액션(슬롯)으로 조합한다. 성격 중립 — 관리자/프론트 구분 없이 전 앱에서 쓴다.
+import { useSlots } from 'vue'
+
+defineProps<{ title?: string; description?: string }>()
+const slots = useSlots()
+</script>
+
+<template>
+  <div
+    class="flex flex-col items-center justify-center gap-3 rounded-lg border border-dashed px-6 py-12 text-center"
+  >
+    <div v-if="slots.icon" class="text-muted-foreground"><slot name="icon" /></div>
+    <div class="space-y-1">
+      <p class="text-sm font-medium"><slot name="title">{{ title }}</slot></p>
+      <p v-if="description || slots.description" class="text-sm text-muted-foreground">
+        <slot name="description">{{ description }}</slot>
+      </p>
+    </div>
+    <div v-if="slots.action" class="mt-1"><slot name="action" /></div>
+  </div>
+</template>

package/dist/templates/ui-kit/PageHeader.vue.tpl

@@ -0,0 +1,25 @@
+<script setup lang="ts">
+// UI 킷 블록 · PageHeader (결정 106). 페이지 상단 — 제목 + 설명 + 액션(슬롯).
+// 모바일에선 액션이 제목 아래로 줄바꿈되고 넓은 화면에선 오른쪽에 붙는다
+// (반응형은 블록 책임 · 결정 107). 액션 슬롯이 없으면 액션 영역은 렌더되지 않는다.
+import { useSlots } from 'vue'
+
+defineProps<{ title?: string; description?: string }>()
+const slots = useSlots()
+</script>
+
+<template>
+  <div class="mb-6 flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
+    <div class="min-w-0 space-y-1">
+      <h1 class="truncate text-2xl font-bold tracking-tight">
+        <slot name="title">{{ title }}</slot>
+      </h1>
+      <p v-if="description || slots.description" class="text-sm text-muted-foreground">
+        <slot name="description">{{ description }}</slot>
+      </p>
+    </div>
+    <div v-if="slots.actions" class="flex shrink-0 flex-wrap items-center gap-2">
+      <slot name="actions" />
+    </div>
+  </div>
+</template>

package/dist/templates/ui-kit/PageShell.vue.tpl

@@ -0,0 +1,27 @@
+<script setup lang="ts">
+// UI 킷 블록 · PageShell (결정 106). 페이지 바깥 골격 — 최대폭·좌우 여백·세로
+// 리듬을 한 곳에서 소유한다. 반응형(폭·여백)은 이 블록이 책임지므로(결정 107)
+// 페이지 코드는 레이아웃 브레이크포인트를 직접 쓰지 않는다. size 로 최대폭을 고른다.
+import { computed } from 'vue'
+import { cn } from '../../lib/utils.js'
+
+type Size = 'default' | 'narrow' | 'wide' | 'full'
+
+const props = withDefaults(defineProps<{ size?: Size }>(), { size: 'default' })
+
+const MAX: Record<Size, string> = {
+  narrow: 'max-w-2xl',
+  default: 'max-w-4xl',
+  wide: 'max-w-6xl',
+  full: 'max-w-none',
+}
+
+// 좌우 여백·세로 리듬을 브레이크포인트로 한 곳에서 정한다 — 페이지는 이 값을 모른다.
+const classes = computed(() =>
+  cn('mx-auto w-full px-4 py-6 sm:px-6 sm:py-8 lg:px-8 lg:py-10', MAX[props.size]),
+)
+</script>
+
+<template>
+  <div :class="classes"><slot /></div>
+</template>

package/dist/templates/ui-kit/Pagination.vue.tpl

@@ -0,0 +1,60 @@
+<script setup lang="ts">
+// UI 킷 블록 · Pagination (결정 106). 페이지 이동 컨트롤. 라우트를 모르는 순수 UI —
+// 현재 페이지를 v-model(update:page)로 올려보내고, 실제 이동(Link·router)은 페이지가
+// 정한다(shared 순수성 · 결정 25). 모바일은 압축형(이전/다음 + "n / m"), sm 이상에선
+// 현재 주변 번호를 함께 보인다(반응형은 블록 책임 · 결정 107). 버튼은 모바일 44px·
+// 데스크톱 40px 로 터치 타깃을 확보한다(결정 107).
+import { computed } from 'vue'
+import { cn } from '../../lib/utils.js'
+
+const props = withDefaults(
+  defineProps<{ page: number; pageCount: number; siblings?: number }>(),
+  { siblings: 1 },
+)
+const emit = defineEmits<{ (e: 'update:page', page: number): void }>()
+
+const total = computed(() => Math.max(1, props.pageCount))
+const clamped = computed(() => Math.min(Math.max(1, props.page), total.value))
+const canPrev = computed(() => clamped.value > 1)
+const canNext = computed(() => clamped.value < total.value)
+
+// 현재 주변 번호 창(sm 이상): [현재-siblings, 현재+siblings]를 1..total 로 자른다.
+const windowPages = computed<number[]>(() => {
+  const from = Math.max(1, clamped.value - props.siblings)
+  const to = Math.min(total.value, clamped.value + props.siblings)
+  const out: number[] = []
+  for (let p = from; p <= to; p++) out.push(p)
+  return out
+})
+
+function go(p: number): void {
+  const next = Math.min(Math.max(1, p), total.value)
+  if (next !== clamped.value) emit('update:page', next)
+}
+
+const BTN =
+  'inline-flex h-11 min-w-11 sm:h-10 sm:min-w-10 items-center justify-center rounded-md border ' +
+  'px-3 text-sm font-medium transition-colors hover:bg-accent hover:text-accent-foreground ' +
+  'disabled:pointer-events-none disabled:opacity-50'
+</script>
+
+<template>
+  <nav class="flex items-center justify-between gap-2 sm:justify-center" aria-label="페이지 이동">
+    <button type="button" :class="BTN" :disabled="!canPrev" @click="go(clamped - 1)">이전</button>
+
+    <span class="text-sm text-muted-foreground sm:hidden">{{ clamped }} / {{ total }}</span>
+
+    <span class="hidden items-center gap-1 sm:inline-flex">
+      <button
+        v-for="p in windowPages"
+        :key="p"
+        type="button"
+        :class="cn(BTN, p === clamped && 'bg-primary text-primary-foreground hover:bg-primary hover:text-primary-foreground')"
+        :aria-current="p === clamped ? 'page' : undefined"
+        @click="go(p)"
+      >{{ p }}</button>
+    </span>
+
+    <button type="button" :class="BTN" :disabled="!canNext" @click="go(clamped + 1)">다음</button>
+  </nav>
+</template>

package/dist/templates/ui-kit/utils.ts.tpl

@@ -1,4 +1,4 @@
-// apps/<app>/lib/utils.ts — UI 킷 공용 헬퍼 (결정 75 · shadcn 참조 · 복사-소유).
+// shared/lib/utils.ts — UI 킷 공용 헬퍼 (결정 75 · 결정 105 · shadcn 참조 · 복사-소유).
 //
 // UI 킷은 외부 런타임 의존 없이 자기완결이다(gaon g ui-kit 로 프로젝트에
 // 복사된 뒤엔 이 파일도 여러분 코드다 — 자유롭게 고친다).

package/dist/uikit.d.ts

@@ -11,10 +11,10 @@ export interface UiKitScaffoldResult {
     readonly created: string[];
     readonly skipped: string[];
 }
-/** UI 킷 전체가 생성하는 파일 목록. */
-export declare function uiKitScaffoldFiles(opts?: UiKitScaffoldOptions): UiKitScaffoldFile[];
-/** `gaon g auth` 가 필요로 하는 UI 킷 최소 세트 파일 목록. */
-export declare function authUiKitFiles(app?: string): UiKitScaffoldFile[];
+/** UI 킷 전체가 생성하는 파일 목록(shared/ · 프로젝트당 한 벌). */
+export declare function uiKitScaffoldFiles(_opts?: UiKitScaffoldOptions): UiKitScaffoldFile[];
+/** `gaon g auth` 가 필요로 하는 UI 킷 최소 세트 파일 목록(shared/). */
+export declare function authUiKitFiles(_app?: string): UiKitScaffoldFile[];
 /** 파일 목록을 디스크에 쓴다. 기존 파일은 덮어쓰지 않고 skip(멱등 · 복사-소유). */
 export declare function writeUiKitFiles(cwd: string, files: readonly UiKitScaffoldFile[]): UiKitScaffoldResult;
 /** `gaon g ui-kit` — UI 킷 전체를 쓴다. */

package/dist/uikit.js

@@ -1,20 +1,25 @@
 /**
- * @gaonjs/cli · `gaon g ui-kit` — shadcn 식 UI 킷 제너레이터 (결정 75)
+ * @gaonjs/cli · `gaon g ui-kit` — shadcn 식 UI 킷 제너레이터 (결정 75 · 결정 105 개정)
  *
  * shadcn 을 참조해 Vue 3 로 새로 쓴 UI 컴포넌트를 프로젝트에 **복사**한다
  * (복사-소유 — 생성된 뒤엔 사용자 코드다). npm 의존이 아니라 파일로 심으므로
  * 자유롭게 고칠 수 있고, 외부 런타임 의존이 전혀 없다(cn 은 자작 · reka-ui·
  * clsx·cva 미도입 · 결정 75). Tailwind(결정 74)를 전제로 한다.
  *
- * 배치:
- *   apps/<app>/lib/utils.ts        — cn() 헬퍼
- *   apps/<app>/components/ui/*.vue  — Button·Input·Card·Form·Dialog … (앱 전용 순수 UI)
+ * 배치(결정 105 — 결정 75 의 "앱마다 복사" 개정):
+ *   shared/lib/utils.ts            — cn() 헬퍼 (프로젝트당 한 벌)
+ *   shared/components/ui/*.vue      — Button·Input·Card·Form·Dialog … (전 앱 공용 순수 UI)
  *
- * 앱 전용에 두는 이유: 컴포넌트에서 lib/utils 로 가는 import 를 얕게 유지해
- * (`../../lib/utils.js`) AI·사람 모두 실수 없이 참조하게 하고, `gaon g auth`
- * 처럼 앱 단위(--app)로 생성한다. 여러 앱이 각자 소유한다(복사-소유 관례).
+ * shared 에 두는 이유(결정 105): UI 킷은 성격 중립 순수 UI 라 앱마다 복제하지
+ * 않고 프로젝트당 한 벌만 둔다 — 앱 컴포넌트는 이 킷을 조합·확장한다. 앱 페이지는
+ * `@shared/components/ui/…` alias 로 참조한다(vite.config.ts·tsconfig.json 에 배선).
+ * 킷 내부 import(cn·하위 컴포넌트)는 상대 경로(`../../lib/utils.js`·`./Label.vue`)라
+ * 위치가 apps/<app> 에서 shared 로 옮겨져도 그대로 유효하다.
+ *
+ * --app 은 이제 킷 위치가 아니라 대상 앱의 Tailwind 배선(style.css·main.ts)을
+ * 멱등 보정하는 데만 쓰인다 — 킷은 앱과 무관하게 shared 로 간다.
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { appWiringFiles, readProjectName } from './scaffold/app-wiring.js';
@@ -39,6 +44,11 @@ const COMPONENTS = [
     'FormMessage',
     'Dialog',
     'Sheet',
+    // 블록(결정 106) — 성격 중립 페이지 조각. 원자를 조합해 페이지 골격을 만든다.
+    'PageShell',
+    'PageHeader',
+    'EmptyState',
+    'Pagination',
 ];
 /** `gaon g auth` 가 스캐폴드하는 로그인·가입·대시보드 페이지가 쓰는 최소 세트.
  *  auth 생성 시 이 컴포넌트가 없으면 페이지가 컴파일되지 않으므로 함께 보장한다. */
@@ -62,26 +72,26 @@ const AUTH_SUBSET = [
 function read(name) {
     return readFileSync(join(TEMPLATE_DIR, name), 'utf8');
 }
-/** 컴포넌트명 목록 → 생성 파일 목록(utils 포함). */
-function filesFor(components, app) {
+/** 컴포넌트명 목록 → 생성 파일 목록(utils 포함). 위치는 shared/ 고정(결정 105). */
+function filesFor(components) {
     const files = [
-        { path: `apps/${app}/lib/utils.ts`, contents: read('utils.ts.tpl') },
+        { path: `shared/lib/utils.ts`, contents: read('utils.ts.tpl') },
     ];
     for (const name of components) {
         files.push({
-            path: `apps/${app}/components/ui/${name}.vue`,
+            path: `shared/components/ui/${name}.vue`,
             contents: read(`${name}.vue.tpl`),
         });
     }
     return files;
 }
-/** UI 킷 전체가 생성하는 파일 목록. */
-export function uiKitScaffoldFiles(opts = {}) {
-    return filesFor(COMPONENTS, opts.app ?? 'web');
+/** UI 킷 전체가 생성하는 파일 목록(shared/ · 프로젝트당 한 벌). */
+export function uiKitScaffoldFiles(_opts = {}) {
+    return filesFor(COMPONENTS);
 }
-/** `gaon g auth` 가 필요로 하는 UI 킷 최소 세트 파일 목록. */
-export function authUiKitFiles(app = 'web') {
-    return filesFor(AUTH_SUBSET, app);
+/** `gaon g auth` 가 필요로 하는 UI 킷 최소 세트 파일 목록(shared/). */
+export function authUiKitFiles(_app = 'web') {
+    return filesFor(AUTH_SUBSET);
 }
 /** 파일 목록을 디스크에 쓴다. 기존 파일은 덮어쓰지 않고 skip(멱등 · 복사-소유). */
 export function writeUiKitFiles(cwd, files) {
@@ -118,11 +128,12 @@ export function runGenerateUiKitCommand(opts = {}) {
         skipped: [...wiring.skipped, ...kit.skipped].sort(),
     };
     if (opts.json) {
-        process.stdout.write(JSON.stringify({ command: 'g ui-kit', app, ...result }, null, 2) + '\n');
+        const legacy = legacyUiKitApps(cwd);
+        process.stdout.write(JSON.stringify({ command: 'g ui-kit', app, ...result, legacyUiKitApps: legacy }, null, 2) + '\n');
         return 0;
     }
     const lines = [''];
-    lines.push(`  gaon g ui-kit — UI 킷 (${app} 앱 · shadcn 참조 · 복사-소유)`);
+    lines.push(`  gaon g ui-kit — UI 킷 (shared/ · shadcn 참조 · 복사-소유)`);
     lines.push('');
     for (const f of result.created)
         lines.push(`   + ${f}`);
@@ -130,9 +141,32 @@ export function runGenerateUiKitCommand(opts = {}) {
         lines.push(`   · ${f} (이미 있음 — 건너뜀)`);
     lines.push('');
     lines.push('  Tailwind 배선(tailwind.config.ts·postcss.config.js·apps/' + app + '/style.css)이 함께 보정됩니다.');
-    lines.push('  컴포넌트는 이제 여러분 코드입니다 — apps/' + app + '/components/ui/ 에서 자유롭게 고치세요.');
-    lines.push('  예) import Button from \'../../components/ui/Button.vue\'');
+    lines.push('  컴포넌트는 이제 여러분 코드입니다 — shared/components/ui/ 에서 자유롭게 고치세요.');
+    lines.push('  예) import Button from \'@shared/components/ui/Button.vue\'');
+    const legacy = legacyUiKitApps(cwd);
+    if (legacy.length > 0) {
+        lines.push('');
+        lines.push('  ⚠ 구버전 UI 킷 사본이 남아 있습니다(결정 105 이전 · 앱별 배치):');
+        for (const app of legacy)
+            lines.push(`     apps/${app}/components/ui/  ·  apps/${app}/lib/utils.ts`);
+        lines.push('  → shared/ 로 옮겼으니 앱 사본을 지우고 import 를 @shared 로 바꾸세요:');
+        lines.push("     import X from '../../components/ui/X.vue'  →  import X from '@shared/components/ui/X.vue'");
+    }
     lines.push('');
     process.stdout.write(lines.join('\n') + '\n');
     return 0;
 }
+/** 결정 105 이전 배치(apps/<app>/components/ui)를 아직 가진 앱 목록 — 마이그레이션 안내용. */
+function legacyUiKitApps(cwd) {
+    const appsDir = join(cwd, 'apps');
+    let apps;
+    try {
+        apps = readdirSync(appsDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+    return apps.filter((app) => existsSync(join(appsDir, app, 'components', 'ui'))).sort();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/cli",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Gaon CLI 구현: 제너레이터·스캐폴딩·로드맵 출력 (M1 스텁)",
   "type": "module",
   "license": "MIT",
@@ -27,12 +27,12 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "typescript": "^5.9.0",
     "vite": "^7.0.0",
-    "@gaonjs/async": "0.6.1",
-    "@gaonjs/data": "0.9.1",
-    "@gaonjs/web": "0.7.1",
+    "@gaonjs/data": "0.10.0",
+    "@gaonjs/config": "0.5.4",
     "@gaonjs/core": "0.2.1",
-    "@gaonjs/config": "0.5.2",
-    "@gaonjs/mail": "0.1.3"
+    "@gaonjs/mail": "0.1.3",
+    "@gaonjs/web": "0.7.2",
+    "@gaonjs/async": "0.6.1"
   },
   "scripts": {
     "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json && node -e \"require('fs').cpSync('src/templates','dist/templates',{recursive:true})\""

package/dist/templates/auth/app.ts.tpl

@@ -1,29 +0,0 @@
-// 웹 앱 팩토리 — gaon g auth 스캐폴드. createWebApp 으로 세션·인증을 배선한다.
-import { createApp, type AppSessionOptions } from 'gaonjs/web'
-import appRoutes from './routes.js'
-import session from './controllers/session.js'
-import registration from './controllers/registration.js'
-import dashboard from './controllers/dashboard.js'
-import { loadUser } from './auth.js'
-
-export interface WebAppDeps {
-  /** 세션 설정 — { redisUrl, secret } (또는 redis 인스턴스). */
-  readonly session: AppSessionOptions
-  /** 서명 쿠키/CSRF 용 비밀. */
-  readonly cookieSecret?: string
-}
-
-export function createWebApp(deps: WebAppDeps) {
-  return createApp({
-    apps: [
-      {
-        name: '{{APP_NAME}}',
-        routes: appRoutes,
-        controllers: { session, registration, dashboard },
-        session: deps.session,
-        auth: { loadUser, loginRedirect: '/session/new' },
-      },
-    ],
-    cookieSecret: deps.cookieSecret,
-  })
-}

package/dist/templates/auth/server.ts.tpl

@@ -1,14 +0,0 @@
-// 서버 진입점 — gaon g auth 스캐폴드. `node dist/server.js` 로 실행.
-import { createWebApp } from './apps/{{APP_NAME}}/app.js'
-
-const app = await createWebApp({
-  session: {
-    redisUrl: process.env.REDIS_URL ?? 'redis://127.0.0.1:6379',
-    secret: process.env.SESSION_SECRET ?? 'change-me-to-a-32+char-random-secret!!',
-  },
-  cookieSecret: process.env.COOKIE_SECRET,
-})
-
-const port = Number(process.env.PORT ?? 3000)
-await app.listen({ port, host: '0.0.0.0' })
-console.log(`web 앱이 http://localhost:${port} 에서 실행 중입니다.`)