sh-ui-cli 0.98.1 → 0.110.0

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.1",
+  "version": "0.110.0",
   "description": "sh-ui CLI — 프로젝트 스캐폴드(create) + 컴포넌트 추가(add/list/remove) + IDE-내 AI용 MCP 서버",
   "license": "MIT",
   "repository": {

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', 'in-place'];
 
 const SUBCOMMANDS = ['add-app', 'add-component'];
 
@@ -40,9 +44,13 @@ 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.
+      // --in-place → inPlace: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 if (name === 'in-place') flags.inPlace = true;
+      else flags[name] = true;
       continue;
     }
     if (!VALUE_FLAGS.includes(name)) {
@@ -79,6 +87,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/describeTemplate.js

@@ -375,18 +375,20 @@ function finalize(groups) {
  * generator.js 의 `finalizeProject` 가 실제 fs 단계에서 적용하는 rename 을
  * file plan 텍스트 레벨에서 mock-apply (v0.96.0+ — 피드백 #3 buglet).
  *
- * 현재 규칙:
- *  - basename 이 정확히 'gitignore' 인 경로 → '.gitignore' 로 prefix dot 추가.
- *    (npm publish 가 .gitignore 를 strip 하므로 템플릿엔 점 없이 두고 emit 후 dot-prefix.)
- *  - 이미 '.gitignore' 인 경로는 그대로.
+ * 현재 규칙 — npm publish 가 strip 하는 dotfile 의 점 없는 템플릿 이름을 복원:
+ *  - 'gitignore' → '.gitignore'  (npm 이 strip, generator 의 STRIPPED_DOTFILES 와 일치)
+ *  - 'npmrc'     → '.npmrc'      (npm 이 publish 시 항상 strip)
+ *  - 이미 점 붙은 경로는 그대로.
  *
- * 미래에 다른 fs-level rename 이 추가되면 여기에 같이 등록 (describeTemplate 의
- * file-plan ↔ create_project 의 실제 emit 1:1 정합성 유지).
+ * 미래에 다른 fs-level rename 이 추가되면 generator.js 의 STRIPPED_DOTFILES 와
+ * 함께 여기에 등록 (describeTemplate 의 file-plan ↔ create_project 실제 emit 1:1 정합성).
  */
+const STRIPPED_DOTFILES = { gitignore: '.gitignore', npmrc: '.npmrc' };
+
 function applyFinalizeRenames(p) {
   const slash = p.lastIndexOf('/');
   const dir = slash === -1 ? '' : p.slice(0, slash + 1);
   const base = slash === -1 ? p : p.slice(slash + 1);
-  if (base === 'gitignore') return dir + '.gitignore';
+  if (STRIPPED_DOTFILES[base]) return dir + STRIPPED_DOTFILES[base];
   return p;
 }

package/src/create/generator.js

@@ -290,19 +290,28 @@ export async function createProject(options = {}) {
     }
   }
 
-  // dry-run 은 tmpdir 에 그대로 생성한 뒤 파일 목록 출력 + 정리.
-  // 사용자 cwd 를 건드리지 않으면서 실제 generation 흐름을 그대로 검증한다.
+  // inPlace — 이미 커스터마이즈된 디렉토리(루트 docs·git 보존)에 비파괴 머지.
+  // generation 은 dry-run 과 동일하게 tmpdir 에서 돌린 뒤, 이미 있는 파일은
+  // 건드리지 않고 새 파일만 realTargetDir 로 복사한다.
+  const inPlace = options.inPlace === true && !options.dryRun;
+  const realTargetDir = path.resolve(process.cwd(), projectName);
+
+  // dry-run / inPlace 는 tmpdir 에 생성. dry-run 은 목록 출력 후 정리,
+  // inPlace 는 realTargetDir 로 비파괴 머지. 일반 모드는 cwd/name 에 직접 생성.
   const targetDir = options.dryRun
     ? await fs.mkdtemp(path.join(os.tmpdir(), 'sh-ui-dry-'))
-    : path.resolve(process.cwd(), projectName);
+    : inPlace
+      ? await fs.mkdtemp(path.join(os.tmpdir(), 'sh-ui-inplace-'))
+      : realTargetDir;
 
-  // 방어 가드 — projectName 검증을 이미 통과했어도 `fs.remove` 직전에 한 번 더 확인.
-  // dry-run 은 tmpdir 이라 parent 가 cwd 가 아니므로 스킵.
+  // 방어 가드 — projectName 검증을 이미 통과했어도 fs 쓰기 직전에 한 번 더 확인.
+  // dry-run / inPlace 의 targetDir 는 tmpdir 이므로 실제 목적지를 검증한다.
   if (!options.dryRun) {
-    assertWithin(process.cwd(), targetDir);
+    assertWithin(process.cwd(), realTargetDir);
   }
 
-  if (!options.dryRun && await fs.pathExists(targetDir)) {
+  // 일반 모드만 기존 디렉토리 덮어쓰기 확인. inPlace 는 비파괴라 remove 하지 않는다.
+  if (!options.dryRun && !inPlace && await fs.pathExists(targetDir)) {
     if (options.yes) {
       await fs.remove(targetDir);
     } else {
@@ -318,9 +327,29 @@ export async function createProject(options = {}) {
     }
   }
 
+  // finalizeProject + (inPlace 면) temp → realTargetDir 비파괴 머지.
+  // 세 플랫폼 경로(flutter/vite/next)가 공통으로 호출한다.
+  async function finalizeAndCommit() {
+    await finalizeProject(targetDir, {
+      dryRun: options.dryRun,
+      // inPlace 는 temp 에서 git init 해봐야 버려지므로 스킵 — realTargetDir 의
+      // 기존 .git 을 그대로 둔다 (gitignore/npmrc 복원은 finalize 안에서 수행됨).
+      gitInit: inPlace ? false : options.gitInit,
+      locale: options.locale,
+    });
+    if (inPlace) {
+      await fs.ensureDir(realTargetDir);
+      await fs.copy(targetDir, realTargetDir, { overwrite: false, errorOnExist: false });
+      await fs.remove(targetDir);
+      console.log(
+        `\n  ℹ inPlace — 기존 디렉토리에 비파괴 머지 완료 (이미 있는 파일은 보존).`,
+      );
+    }
+  }
+
   if (platform === 'flutter') {
     await generateFlutter(targetDir, projectName, theme, cssFramework, themeBase);
-    await finalizeProject(targetDir, { dryRun: options.dryRun });
+    await finalizeAndCommit();
     console.log(`\n✅ ${projectName} Flutter 프로젝트가 생성되었습니다!`);
     console.log(`\n  cd ${projectName}`);
     console.log('  flutter pub get');
@@ -355,7 +384,7 @@ export async function createProject(options = {}) {
       });
     }
 
-    await finalizeProject(targetDir, { dryRun: options.dryRun });
+    await finalizeAndCommit();
 
     if (options.dryRun) {
       const files = await listAllFiles(targetDir);
@@ -401,7 +430,7 @@ export async function createProject(options = {}) {
     });
   }
 
-  await finalizeProject(targetDir, { dryRun: options.dryRun });
+  await finalizeAndCommit();
 
   if (options.dryRun) {
     const files = await listAllFiles(targetDir);
@@ -1644,21 +1673,50 @@ async function stripTailwindFromPrettier(prettierPath) {
 }
 
 /**
- * 스캐폴드 마무리 — `gitignore` 파일을 `.gitignore` 로 되돌리고 `git init` 실행.
+ * npm publish 가 패키지 tarball 에서 strip/변형하는 dotfile 들 — 템플릿엔 점 없는
+ * 이름으로 두고 스캐폴드 직후 점을 복원한다.
+ *   - `.gitignore` → npm 이 strip (없으면 `.npmignore` fallback 으로 사용)
+ *   - `.npmrc`     → npm 이 항상 strip (publish 시 레지스트리 토큰 유출 방지)
+ * 둘 다 published CLI 엔 도착하지 않으므로 템플릿엔 `gitignore` / `npmrc` 로 둔다.
+ */
+const STRIPPED_DOTFILES = { gitignore: '.gitignore', npmrc: '.npmrc' };
+
+/**
+ * 스캐폴드 마무리 — strip 된 dotfile(`gitignore`/`npmrc`) 을 점 붙은 이름으로
+ * 되돌리고 `git init` 실행.
  *
- * 왜 이름을 우회하는가: npm publish 는 패키지 안의 `.gitignore` 를 자동으로
- * 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 } = {}) {
-  // 모노레포 / sub-app 까지 모든 `gitignore` 를 `.gitignore` 로 rename.
+async function finalizeProject(targetDir, { dryRun = false, gitInit, locale } = {}) {
+  // 모노레포 / sub-app 까지 strip 된 dotfile(gitignore/npmrc) 을 점 붙은 이름으로 복원.
   // root 만 처리하면 apps/<name>/gitignore 가 그대로 남아 node_modules/dist 가 staged 된다 (v0.93.0 버그).
-  await renameAllGitignoreRecursive(targetDir);
+  await restoreStrippedDotfilesRecursive(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 +1724,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 가정) 적용 방지.
@@ -1678,7 +1825,7 @@ function describeAppPlatform(platform) {
   return 'Next.js 앱 (App Router + Server Components). 라우트 + 비즈니스 로직.';
 }
 
-async function renameAllGitignoreRecursive(dir) {
+async function restoreStrippedDotfilesRecursive(dir) {
   let entries;
   try {
     entries = await fs.readdir(dir, { withFileTypes: true });
@@ -1690,9 +1837,9 @@ async function renameAllGitignoreRecursive(dir) {
     if (entry.isDirectory()) {
       // 스캐폴드 직후엔 node_modules / .git 가 없지만 방어적으로.
       if (entry.name === 'node_modules' || entry.name === '.git') continue;
-      await renameAllGitignoreRecursive(fullPath);
-    } else if (entry.name === 'gitignore') {
-      await fs.move(fullPath, path.join(dir, '.gitignore'), { overwrite: true });
+      await restoreStrippedDotfilesRecursive(fullPath);
+    } else if (STRIPPED_DOTFILES[entry.name]) {
+      await fs.move(fullPath, path.join(dir, STRIPPED_DOTFILES[entry.name]), { overwrite: true });
     }
   }
 }

package/src/create/index.mjs

@@ -30,8 +30,12 @@ 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                              디렉토리 덮어쓰기 + 모노레포 기본값 자동 채택
+  --in-place                         기존 디렉토리에 비파괴 머지 — 이미 있는 파일은 보존, 없는 파일만 채움. 커스텀 루트 docs·.git 보존하며 재생성 (디렉토리 삭제 안 함)
   --dry-run                          파일을 쓰지 않고 작성될 파일 목록만 출력
+  --no-git-init                      git init 스킵 (기존 git tree 안에서 호출 시 nested .git 충돌 방지). 기본 auto — parent 가 git tree 안이면 자동 스킵
+  --git-init                         git init 무조건 실행 (nested 가 의도된 경우)
   -h, --help                         이 도움말
 
 예 (대화형):
@@ -102,6 +106,11 @@ export async function runCreate(rest) {
       port: flags.port,
       yes: flags.yes,
       dryRun: flags.dryRun,
+      // gitInit / locale / inPlace — 이전엔 파싱만 하고 createProject 로
+      // 전달하지 않아 무시되던 버그. v0.110.0 에서 함께 연결.
+      gitInit: flags.gitInit,
+      locale: flags.locale,
+      inPlace: flags.inPlace,
     });
   }
 }

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/templateManifest.js

@@ -17,11 +17,11 @@ export const TEMPLATE_MANIFEST = {
   "monorepo": {
     "base": [
       ".dockerignore",
-      ".npmrc",
       ".prettierrc",
       "CLAUDE.md",
       "README.md",
       "gitignore",
+      "npmrc",
       "package.json",
       "packages/eslint-config/base.js",
       "packages/eslint-config/flat.js",

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',
 ];
 
 /**