sh-ui-cli 0.98.0 → 0.109.1

package/data/registry/react/tokens-used.json

@@ -1,6 +1,6 @@
 {
   "$description": "컴포넌트별 토큰 의존성 (var(--*) 추출). build-registry-tokens.mjs 가 자동 생성.",
-  "$generated": "2026-05-13T03:22:30.348Z",
+  "$generated": "2026-05-21T07:02:56.611Z",
   "components": {
     "button": {
       "plain": [
@@ -1977,6 +1977,91 @@
       "css-modules": [],
       "vanilla-extract": []
     },
+    "scroll-area": {
+      "plain": [
+        "--border-strong",
+        "--border-width-strong",
+        "--foreground-muted",
+        "--ring"
+      ],
+      "tailwind": [
+        "--border-width-strong"
+      ],
+      "css-modules": [
+        "--border-strong",
+        "--border-width-strong",
+        "--foreground-muted",
+        "--ring"
+      ],
+      "vanilla-extract": []
+    },
+    "sheet": {
+      "plain": [
+        "--background",
+        "--background-subtle",
+        "--border",
+        "--border-width-strong",
+        "--control-sm",
+        "--duration-fast",
+        "--duration-slow",
+        "--foreground",
+        "--foreground-muted",
+        "--radius",
+        "--ring",
+        "--shadow-xl",
+        "--space-1",
+        "--space-2",
+        "--space-3",
+        "--space-4",
+        "--space-6",
+        "--text-lg",
+        "--text-sm",
+        "--weight-semibold",
+        "--z-modal",
+        "--z-overlay"
+      ],
+      "tailwind": [
+        "--border-width-strong",
+        "--control-sm",
+        "--duration-fast",
+        "--duration-slow",
+        "--radius",
+        "--shadow-xl",
+        "--space-1",
+        "--space-2",
+        "--space-4",
+        "--space-6",
+        "--text-lg",
+        "--text-sm",
+        "--z-modal",
+        "--z-overlay"
+      ],
+      "css-modules": [
+        "--background",
+        "--background-subtle",
+        "--border",
+        "--border-width-strong",
+        "--control-sm",
+        "--duration-fast",
+        "--duration-slow",
+        "--foreground",
+        "--foreground-muted",
+        "--radius",
+        "--ring",
+        "--shadow-xl",
+        "--space-1",
+        "--space-2",
+        "--space-3",
+        "--space-4",
+        "--space-6",
+        "--text-lg",
+        "--text-sm",
+        "--weight-semibold",
+        "--z-modal",
+        "--z-overlay"
+      ],
+      "vanilla-extract": []
+    },
     "utils": {
       "plain": [],
       "tailwind": [],

package/data/summaries/react.json

@@ -55,6 +55,8 @@
     "form-yup": "yup 스키마 → sh-ui Form 의 Standard Schema 어댑터. `yupSchema(yupObject)` 로 감싸 Form 의 `validation` prop 에 전달. yup 자체는 peerDependency.",
     "form-rhf": "React Hook Form 인스턴스 → sh-ui FormStore 어댑터. `adaptReactHookForm(rhfInstance, config)` — RHF 가 state owner, sh-ui 가 메타(steps/sections) 관리. react-hook-form 은 peerDependency.",
     "form-tanstack": "TanStack Form 인스턴스 → sh-ui FormStore 어댑터. `adaptTanstackForm(tanstackInstance, config)` — TanStack Form 이 state owner. @tanstack/react-form 은 peerDependency.",
-    "calendar": "내부 캘린더 위젯 (DatePicker 가 사용). single / multiple / range 모드. CalendarMessages 로 a11y 텍스트 override. 일반적으로 직접 사용보다 DatePicker / DateRangePicker 권장."
+    "calendar": "내부 캘린더 위젯 (DatePicker 가 사용). single / multiple / range 모드. CalendarMessages 로 a11y 텍스트 override. 일반적으로 직접 사용보다 DatePicker / DateRangePicker 권장.",
+    "scroll-area": "커스텀 스크롤 컨테이너 — composite export ScrollArea (Base UI). 내부에서 viewport + scrollbar + thumb + corner 를 자동 구성하며 OS-native 스크롤바를 대체한다. orientation: \"vertical\" | \"horizontal\" | \"both\" (기본 vertical). 외부 height/width 가 정해진 컨테이너 안에서 사용. viewportClassName 으로 viewport 의 패딩/레이아웃 분리 적용. 스크롤바는 hover/scrolling 시 fade in, prefers-reduced-motion 존중.",
+    "sheet": "화면 가장자리에서 슬라이드 인 하는 side drawer — separate exports: Sheet / SheetTrigger / SheetClose / SheetContent / SheetTitle / SheetDescription / SheetHeader / SheetFooter / SheetCloseX (Base UI Drawer 래핑, 포커스 트랩). 글로벌 알림함 · 작업 큐 · 보조 패널 같은 사이드바 무관 모달 시트용. 사이드바 인근 detail 패널은 SidebarPanel, 중앙 강제 모달은 Dialog 권장. SheetContent 의 side: \"right\" | \"left\" | \"top\" | \"bottom\" (기본 right) 으로 진입 방향 지정. SheetTrigger·SheetClose 는 자체 button — 다른 엘리먼트 슬롯은 `render` prop. ESC/바깥 클릭/포커스 복귀 자동, prefers-reduced-motion 시 transform 트랜지션 제거."
   }
 }

package/data/tokens/src/primitives.json

@@ -94,6 +94,14 @@
     "bold":     { "$value": 700, "$type": "fontWeight" }
   },
 
+  "letterSpacing": {
+    "tighter": { "$value": "-0.04em", "$type": "dimension" },
+    "tight":   { "$value": "-0.02em", "$type": "dimension" },
+    "normal":  { "$value": "0",        "$type": "dimension" },
+    "wide":    { "$value": "0.02em",   "$type": "dimension" },
+    "wider":   { "$value": "0.04em",   "$type": "dimension" }
+  },
+
   "shadow": {
     "sm": { "$value": "0 1px 2px rgba(0, 0, 0, 0.08)",   "$type": "shadow" },
     "md": { "$value": "0 4px 12px rgba(0, 0, 0, 0.12)",  "$type": "shadow" },

package/data/tokens/src/semantic.json

@@ -4,8 +4,8 @@
   "light": {
     "background": {
       "default": { "$value": "{color.white}", "$type": "color" },
-      "subtle":   { "$value": "{color.{base}.50}", "$type": "color" },
-      "muted":    { "$value": "{color.{base}.100}", "$type": "color" },
+      "subtle":   { "$value": "{color.{base}.100}", "$type": "color" },
+      "muted":    { "$value": "{color.{base}.200}", "$type": "color" },
       "inverse":  { "$value": "{color.{base}.950}", "$type": "color" }
     },
     "foreground": {
@@ -23,6 +23,11 @@
       "foreground": { "$value": "{color.{base}.50}", "$type": "color" },
       "hover":      { "$value": "{color.{base}.800}", "$type": "color" }
     },
+    "accent": {
+      "default":    { "$value": "{color.{base}.900}", "$type": "color" },
+      "foreground": { "$value": "{color.{base}.50}", "$type": "color" },
+      "hover":      { "$value": "{color.{base}.800}", "$type": "color" }
+    },
     "danger": {
       "default":    { "$value": "{color.red.600}", "$type": "color" },
       "foreground": { "$value": "{color.white}", "$type": "color" },
@@ -30,10 +35,10 @@
     },
     "ring": { "$value": "{color.{base}.400}", "$type": "color" },
     "sidebar": {
-      "bg":         { "$value": "{color.{base}.50}",  "$type": "color" },
+      "bg":         { "$value": "{color.{base}.100}", "$type": "color" },
       "fg":         { "$value": "{color.{base}.950}", "$type": "color" },
       "border":     { "$value": "{color.{base}.200}", "$type": "color" },
-      "accent":     { "$value": "{color.{base}.100}", "$type": "color" },
+      "accent":     { "$value": "{color.{base}.200}", "$type": "color" },
       "accent-fg":  { "$value": "{color.{base}.950}", "$type": "color" }
     }
   },
@@ -60,6 +65,11 @@
       "foreground": { "$value": "{color.{base}.900}", "$type": "color" },
       "hover":      { "$value": "{color.{base}.200}", "$type": "color" }
     },
+    "accent": {
+      "default":    { "$value": "{color.{base}.50}", "$type": "color" },
+      "foreground": { "$value": "{color.{base}.900}", "$type": "color" },
+      "hover":      { "$value": "{color.{base}.200}", "$type": "color" }
+    },
     "danger": {
       "default":    { "$value": "{color.red.600}", "$type": "color" },
       "foreground": { "$value": "{color.white}", "$type": "color" },
@@ -76,7 +86,12 @@
   },
 
   "radius": {
-    "default": { "$value": "{radius.{radius}}", "$type": "dimension" }
+    "default": { "$value": "{radius.{radius}}", "$type": "dimension" },
+    "sm":   { "$value": "{radius.sm}",   "$type": "dimension" },
+    "md":   { "$value": "{radius.md}",   "$type": "dimension" },
+    "lg":   { "$value": "{radius.lg}",   "$type": "dimension" },
+    "xl":   { "$value": "{radius.xl}",   "$type": "dimension" },
+    "full": { "$value": "{radius.full}", "$type": "dimension" }
   },
 
   "space": {
@@ -112,11 +127,22 @@
   },
 
   "shadow": {
-    "sm":   { "$value": "{shadow.sm}", "$type": "shadow" },
-    "md":   { "$value": "{shadow.md}", "$type": "shadow" },
-    "lg":   { "$value": "{shadow.lg}", "$type": "shadow" },
-    "xl":   { "$value": "{shadow.xl}", "$type": "shadow" },
-    "menu": { "$value": "{shadow.lg}", "$type": "shadow" }
+    "sm":      { "$value": "{shadow.sm}", "$type": "shadow" },
+    "md":      { "$value": "{shadow.md}", "$type": "shadow" },
+    "lg":      { "$value": "{shadow.lg}", "$type": "shadow" },
+    "xl":      { "$value": "{shadow.xl}", "$type": "shadow" },
+    "menu":    { "$value": "{shadow.lg}", "$type": "shadow" },
+    "popover": { "$value": "{shadow.lg}", "$type": "shadow" },
+    "modal":   { "$value": "{shadow.xl}", "$type": "shadow" },
+    "toast":   { "$value": "{shadow.md}", "$type": "shadow" }
+  },
+
+  "tracking": {
+    "tighter": { "$value": "{letterSpacing.tighter}", "$type": "dimension" },
+    "tight":   { "$value": "{letterSpacing.tight}",   "$type": "dimension" },
+    "normal":  { "$value": "{letterSpacing.normal}",  "$type": "dimension" },
+    "wide":    { "$value": "{letterSpacing.wide}",    "$type": "dimension" },
+    "wider":   { "$value": "{letterSpacing.wider}",   "$type": "dimension" }
   },
 
   "duration": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh-ui-cli",
-  "version": "0.98.0",
+  "version": "0.109.1",
   "description": "sh-ui CLI — 프로젝트 스캐폴드(create) + 컴포넌트 추가(add/list/remove) + IDE-내 AI용 MCP 서버",
   "license": "MIT",
   "repository": {

package/src/add.mjs

@@ -16,6 +16,8 @@ import {
   stripStylesImport,
   isStyleFile,
   isTsxFile,
+  hasCrossComponentImport,
+  rewriteCrossComponentImports,
 } from "./css-bundle.mjs";
 
 /**
@@ -96,26 +98,49 @@ function resolveDest(template, config) {
 }
 
 /**
- * registry source 안의 placeholder 를 사용자 config 값으로 치환.
- * 현재 지원: `@SH_UI_UTILS@` → `aliases.utils` (예: `@/src/shared/lib/utils`).
+ * registry source 안의 placeholder / 상대 import 를 사용자 config 값으로 치환.
  *
- * registry 컴포넌트는 cn 유틸을 `import { cn } from "@SH_UI_UTILS@"` 로 import 한다 —
- * CLI 가 add 시점에 사용자 프로젝트의 alias 로 치환해 TS module resolution 이 동작.
+ * 1) `@SH_UI_UTILS@` → `aliases.utils` (예: `@/src/shared/lib/utils`).
+ *    registry 컴포넌트는 cn 유틸을 `import { cn } from "@SH_UI_UTILS@"` 로
+ *    import 한다 — add 시점에 사용자 프로젝트 alias 로 치환해 module resolution 동작.
+ * 2) 크로스컴포넌트 상대 import (`from "../popover"` /
+ *    `from "../popover/index.tsx"` / `from "../form/types"`) →
+ *    `aliases.components` 경유 (예: `@workspace/ui-core/components/popover`).
+ *    상대경로/명시적 `.tsx` 확장자가 그대로 emit 되면 NodeNext 소비자가 깨지므로
+ *    (TS5097 → `allowImportingTsExtensions`+`noEmit` 강요), utils 와 동일하게
+ *    add 시점에 alias 로 정규화한다. 변환 규칙은 css-bundle.mjs 의
+ *    rewriteCrossComponentImports 참조 (remove.mjs 가 동일 함수로 대칭 replay).
  *
- * aliases.utils 가 미설정인데 placeholder 가 등장하면 친절 에러로 안내. 사용자가 매 컴포넌트
- * 추가 후 import 깨진 것을 발견하기 전에 시점에 잡는다.
+ * 해당 alias 가 미설정인데 placeholder/상대 import 가 등장하면 친절 에러로
+ * 안내 — 사용자가 매 컴포넌트 추가 후 import 깨진 것을 발견하기 전에 잡는다.
  */
 function substitutePlaceholders(content, config, srcRel) {
+  let out = content;
+
   const PLACEHOLDER = "@SH_UI_UTILS@";
-  if (!content.includes(PLACEHOLDER)) return content;
-  const alias = config.aliases?.utils;
-  if (!alias) {
-    throw new Error(
-      `${srcRel} 가 cn 유틸을 import 합니다. sh-ui.config.json 에 aliases.utils 를 설정하세요.\n` +
-        `  예: "aliases": { "utils": "@/src/lib/utils" }`,
-    );
+  if (out.includes(PLACEHOLDER)) {
+    const alias = config.aliases?.utils;
+    if (!alias) {
+      throw new Error(
+        `${srcRel} 가 cn 유틸을 import 합니다. sh-ui.config.json 에 aliases.utils 를 설정하세요.\n` +
+          `  예: "aliases": { "utils": "@/src/lib/utils" }`,
+      );
+    }
+    out = out.replaceAll(PLACEHOLDER, alias);
   }
-  return content.replaceAll(PLACEHOLDER, alias);
+
+  if (hasCrossComponentImport(out)) {
+    const componentsAlias = config.aliases?.components;
+    if (!componentsAlias) {
+      throw new Error(
+        `${srcRel} 가 다른 sh-ui 컴포넌트를 import 합니다. sh-ui.config.json 에 aliases.components 를 설정하세요.\n` +
+          `  예: "aliases": { "components": "@/src/components" }`,
+      );
+    }
+    out = rewriteCrossComponentImports(out, componentsAlias);
+  }
+
+  return out;
 }
 
 async function ensureDir(filePath) {

package/src/create/cli-args.js

@@ -13,8 +13,12 @@ const VALID_STRUCTURES = CREATE_STRUCTURES;
 const VALID_PLUGINS = allPlugins.map((p) => p.name);
 const VALID_ARCHES = allArchitectures.map((a) => a.name);
 
-const VALUE_FLAGS = ['platform', 'structure', 'plugins', 'theme', 'app', 'css', 'arch', 'port', 'i18n', 'locales'];
-const BOOL_FLAGS = ['yes', 'help', 'dry-run'];
+const VALUE_FLAGS = ['platform', 'structure', 'plugins', 'theme', 'app', 'css', 'arch', 'port', 'i18n', 'locales', 'locale'];
+
+// `locale` (단수) 은 한국어/일본어 같은 사용자 지역 디폴트 가정 (폰트 등) 을 활성화하는
+// 옵션. `locales` (복수) 와 다르다: locales 는 i18n 활성화 시 생성할 locale 코드 목록.
+const VALID_LOCALES = ['default', 'ko'];
+const BOOL_FLAGS = ['yes', 'help', 'dry-run', 'no-git-init', 'git-init'];
 
 const SUBCOMMANDS = ['add-app', 'add-component'];
 
@@ -40,9 +44,11 @@ export const parseArgs = (argv) => {
     }
     const name = arg.slice(2);
     if (BOOL_FLAGS.includes(name)) {
-      // dry-run 은 dryRun 으로 캐멀 케이스
-      const key = name === 'dry-run' ? 'dryRun' : name;
-      flags[key] = true;
+      // dry-run → dryRun. --no-git-init → gitInit:false. --git-init → gitInit:true.
+      if (name === 'dry-run') flags.dryRun = true;
+      else if (name === 'no-git-init') flags.gitInit = false;
+      else if (name === 'git-init') flags.gitInit = true;
+      else flags[name] = true;
       continue;
     }
     if (!VALUE_FLAGS.includes(name)) {
@@ -79,6 +85,13 @@ export const parseArgs = (argv) => {
     if (name === 'i18n' && !I18N_LIBRARIES.includes(value)) {
       throw new Error(`--i18n 은 ${I18N_LIBRARIES.join('/')} 중 하나여야 함 (받은 값: ${value})`);
     }
+    if (name === 'locale' && !VALID_LOCALES.includes(value)) {
+      throw new Error(
+        `--locale 은 ${VALID_LOCALES.join('/')} 중 하나여야 함 (받은 값: ${value}). ` +
+        `'ko' 선택 시 Pretendard 폰트가 globals.css 에 자동 적용됩니다. ` +
+        `(주의: --locales (복수) 는 i18n 활성화 시 생성할 locale 코드 목록 — 다른 의미).`,
+      );
+    }
     if (name === 'css' && !CSS_FRAMEWORKS_SUPPORTED.includes(value)) {
       // planned 값은 '곧 옵니다' 신호로 분기 — 사용자 의도가 더 명확히 전달.
       if (CSS_FRAMEWORKS_PLANNED.includes(value)) {

package/src/create/generator.js

@@ -320,7 +320,7 @@ export async function createProject(options = {}) {
 
   if (platform === 'flutter') {
     await generateFlutter(targetDir, projectName, theme, cssFramework, themeBase);
-    await finalizeProject(targetDir, { dryRun: options.dryRun });
+    await finalizeProject(targetDir, { dryRun: options.dryRun, gitInit: options.gitInit, locale: options.locale });
     console.log(`\n✅ ${projectName} Flutter 프로젝트가 생성되었습니다!`);
     console.log(`\n  cd ${projectName}`);
     console.log('  flutter pub get');
@@ -355,7 +355,7 @@ export async function createProject(options = {}) {
       });
     }
 
-    await finalizeProject(targetDir, { dryRun: options.dryRun });
+    await finalizeProject(targetDir, { dryRun: options.dryRun, gitInit: options.gitInit, locale: options.locale });
 
     if (options.dryRun) {
       const files = await listAllFiles(targetDir);
@@ -401,7 +401,7 @@ export async function createProject(options = {}) {
     });
   }
 
-  await finalizeProject(targetDir, { dryRun: options.dryRun });
+  await finalizeProject(targetDir, { dryRun: options.dryRun, gitInit: options.gitInit, locale: options.locale });
 
   if (options.dryRun) {
     const files = await listAllFiles(targetDir);
@@ -1650,15 +1650,38 @@ async function stripTailwindFromPrettier(prettierPath) {
  * strip 한다(없으면 `.npmignore` fallback 으로 사용). 사용자에게 도착하지 않으니
  * 템플릿엔 `gitignore` 로 두고 복사 직후 dot-prefix 를 붙인다.
  *
+ * gitInit 옵션:
+ *   - undefined (auto): parent 가 이미 git tree 안이면 스킵, 아니면 init. nested .git
+ *     충돌 방지 — 기존 monorepo / 사용자 작업 트리 안에서 호출 시 안전.
+ *   - true: 무조건 init (parent 가 git tree 안이어도). nested 가 의도된 경우.
+ *   - false: 무조건 스킵.
+ *
  * git init 은 dry-run 에서는 스킵하고, 실패해도(git 미설치 등) 조용히 넘어간다.
  */
-async function finalizeProject(targetDir, { dryRun = false } = {}) {
+async function finalizeProject(targetDir, { dryRun = false, gitInit, locale } = {}) {
   // 모노레포 / sub-app 까지 모든 `gitignore` 를 `.gitignore` 로 rename.
   // root 만 처리하면 apps/<name>/gitignore 가 그대로 남아 node_modules/dist 가 staged 된다 (v0.93.0 버그).
   await renameAllGitignoreRecursive(targetDir);
 
+  // locale 후처리 — 한국어면 globals.css 들에 Pretendard 자동 적용 (Aifice 피드백 3.1).
+  // dryRun 이면 skip — globals.css 가 디스크에 안 써졌을 수 있다.
+  if (!dryRun && locale === 'ko') {
+    await injectLocaleFont(targetDir, 'ko');
+  }
+
   if (dryRun) return;
 
+  const decision = resolveGitInit(targetDir, gitInit);
+  if (!decision.init) {
+    if (decision.reason === 'nested') {
+      console.log(
+        `\n  ℹ 이미 git tree 안이라 .git 초기화를 스킵했습니다 (parent: ${decision.parentRepo}).\n` +
+        `    nested git repo 가 의도된 경우 --git-init 으로 강제할 수 있습니다.`,
+      );
+    }
+    return;
+  }
+
   try {
     execSync('git init -q', { cwd: targetDir, stdio: 'ignore' });
   } catch {
@@ -1666,6 +1689,95 @@ async function finalizeProject(targetDir, { dryRun = false } = {}) {
   }
 }
 
+/**
+ * `locale` 옵션 후처리 — locale=ko 면 스캐폴드된 모든 globals.css 에 Pretendard 폰트 적용.
+ *
+ * 한국어 사용자가 sh-ui 를 init 한 직후 "Pretendard 로 교체" 가 거의 100% 첫 작업이라
+ * (Aifice 피드백 3.1), 이를 옵션 하나로 자동화. 적용 방식:
+ *   - external-imports 마커 안에 Pretendard CDN @import 라인 prepend (Tailwind import 보다 먼저)
+ *   - 파일 끝에 `body { font-family: 'Pretendard Variable', ... }` rule 추가
+ *
+ * idempotent: 이미 'Pretendard Variable' 문자열이 있으면 skip.
+ * monorepo 도 안전 — targetDir 하위 모든 globals.css 를 재귀 스캔 (node_modules / .git / _arch 제외).
+ * Flutter 는 globals.css 가 없어 자동 no-op.
+ */
+async function injectLocaleFont(targetDir, locale) {
+  if (locale !== 'ko') return;
+
+  const PRETENDARD_IMPORT =
+    "@import url('https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/dist/web/static/pretendard.css');\n";
+  const FONT_FAMILY_RULE =
+    "\n/* sh-ui:locale=ko — Pretendard 기본 적용. 사용자 정의로 override 가능. */\n" +
+    "body { font-family: 'Pretendard Variable', ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, sans-serif; }\n";
+  const END_MARKER = '/* sh-ui:external-imports-end */';
+
+  const targets = [];
+  async function walk(dir) {
+    let entries;
+    try {
+      entries = await fs.readdir(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      const full = path.join(dir, e.name);
+      if (e.isDirectory()) {
+        if (['node_modules', '.git', '.next', 'dist', '_arch'].includes(e.name)) continue;
+        await walk(full);
+      } else if (e.isFile() && e.name === 'globals.css') {
+        targets.push(full);
+      }
+    }
+  }
+  await walk(targetDir);
+
+  for (const abs of targets) {
+    let css = await fs.readFile(abs, 'utf-8');
+    if (css.includes("'Pretendard Variable'")) continue;
+    if (!css.includes(END_MARKER)) continue; // 우리 마커 없는 파일은 안전상 건드리지 않음
+    css = css.replace(END_MARKER, `${PRETENDARD_IMPORT}${END_MARKER}`);
+    css += FONT_FAMILY_RULE;
+    await fs.writeFile(abs, css);
+  }
+}
+
+/**
+ * git init 실행 여부 결정. auto 모드는 parent 가 git tree 안이면 스킵 — nested .git
+ * 충돌 방지. 명시 override (true/false) 가 있으면 그대로 따른다.
+ *
+ * 감지: `git -C <parentDir> rev-parse --is-inside-work-tree` 출력이 "true" 면 안.
+ * git 미설치 / 권한 문제 등으로 명령이 실패하면 트리 밖으로 간주 (안전 디폴트: init 시도).
+ */
+function resolveGitInit(targetDir, override) {
+  if (override === false) return { init: false, reason: 'explicit-skip' };
+  if (override === true) return { init: true, reason: 'explicit-force' };
+
+  const parentDir = path.dirname(targetDir);
+  try {
+    const result = execSync('git rev-parse --is-inside-work-tree', {
+      cwd: parentDir,
+      stdio: ['ignore', 'pipe', 'ignore'],
+    })
+      .toString()
+      .trim();
+    if (result === 'true') {
+      let parentRepo = parentDir;
+      try {
+        parentRepo = execSync('git rev-parse --show-toplevel', {
+          cwd: parentDir,
+          stdio: ['ignore', 'pipe', 'ignore'],
+        })
+          .toString()
+          .trim() || parentDir;
+      } catch {}
+      return { init: false, reason: 'nested', parentRepo };
+    }
+  } catch {
+    // parent 가 git tree 밖 (또는 git 미설치) — 안전 디폴트: init 시도.
+  }
+  return { init: true, reason: 'auto' };
+}
+
 /**
  * CLAUDE.md 의 `{{PLATFORM_APP_DESCRIPTION}}` 치환용 문장 — AI 에이전트에게 어떤 플랫폼인지
  * 정확히 전달해서 잘못된 컨벤션 (예: vite 프로젝트에 App Router 가정) 적용 방지.

package/src/create/index.mjs

@@ -30,8 +30,11 @@ export const HELP_TEXT = `sh-ui create — sh-ui 프로젝트 스캐폴드 (Next
   --css <${CSS_FRAMEWORKS_SUPPORTED.join('|')}>                        CSS 프레임워크. base 파일까지 분기 emit (tailwind/plain/css-modules)
   --i18n <react-i18next|none>        vite 전용 — react-i18next 셋업 emit (i18n config + I18nProvider). 기본 none (v0.92.0+)
   --locales <ko,en>                  i18n 활성화 시 생성할 locale 코드 (comma-separated). 기본 'ko,en'
+  --locale <default|ko>              사용자 지역 디폴트 가정 — 'ko' 선택 시 globals.css 에 Pretendard 자동 적용 (v0.103.0+)
   --yes                              디렉토리 덮어쓰기 + 모노레포 기본값 자동 채택
   --dry-run                          파일을 쓰지 않고 작성될 파일 목록만 출력
+  --no-git-init                      git init 스킵 (기존 git tree 안에서 호출 시 nested .git 충돌 방지). 기본 auto — parent 가 git tree 안이면 자동 스킵
+  --git-init                         git init 무조건 실행 (nested 가 의도된 경우)
   -h, --help                         이 도움말
 
 예 (대화형):

package/src/create/plugins/nextIntl.js

@@ -231,6 +231,9 @@ export function RootLayout({
 export const routing = defineRouting({
   locales: ['ko', 'en'],
   defaultLocale: 'ko',
+  // ko 는 prefix 없이 '/', en 만 '/en/...' — 한국 사용자 베이스 + 영문 보조 페어가 흔한 패턴.
+  // 모든 locale 에 prefix 강제하고 싶으면 'always', 절대 prefix 안 붙이면 'never'.
+  localePrefix: 'as-needed',
 });
 `,
 

package/src/create/theme/decode.js

@@ -24,6 +24,9 @@ const OPTIONAL_TOKEN_KEYS = [
   // fallback 을 두지만, Tailwind @theme inline 의 --color-sidebar-* 가 :root 에서 해석되도록
   // tokens.css 에도 끌어올린다.
   'sidebar-bg', 'sidebar-fg', 'sidebar-border', 'sidebar-accent', 'sidebar-accent-fg',
+  // v0.100.0+ — accent 토큰. primary 와 의미 분리: primary = 브랜드 action color,
+  // accent = signature highlight (선택 상태·링크·hover bg 등). 디폴트는 primary 와 동일.
+  'accent', 'accent-foreground', 'accent-hover',
 ];
 
 /**