@gaonjs/cli 0.24.0 → 0.26.0

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.24.0",
+  "version": "0.26.0",
   "description": "Gaon CLI 구현: 제너레이터·스캐폴딩·로드맵 출력 (M1 스텁)",
   "type": "module",
   "license": "MIT",
@@ -28,11 +28,11 @@
     "typescript": "^5.9.0",
     "vite": "^7.0.0",
     "@gaonjs/async": "0.6.1",
-    "@gaonjs/web": "0.7.2",
-    "@gaonjs/config": "0.5.3",
+    "@gaonjs/config": "0.6.0",
     "@gaonjs/core": "0.2.1",
-    "@gaonjs/mail": "0.1.3",
-    "@gaonjs/data": "0.9.2"
+    "@gaonjs/web": "0.8.0",
+    "@gaonjs/data": "0.11.0",
+    "@gaonjs/mail": "0.1.3"
   },
   "scripts": {
     "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json && node -e \"require('fs').cpSync('src/templates','dist/templates',{recursive:true})\""