sh-ui-cli 0.61.1 → 0.61.3

package/data/changelog/versions.json

@@ -2,6 +2,28 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.61.3",
+      "date": "2026-05-08",
+      "title": "fix — `sh-ui add tokens` 가 base=custom 테마에서 깨지던 회귀",
+      "type": "patch",
+      "highlights": [
+        "**`sh-ui add tokens` 가 `theme.base: \"custom\"` 일 때 `해석 실패: {color.custom.50}` 로 깨지던 회귀 수정** — v0.61.2 에서 base64 테마 입력 시 `theme.base` 를 `'custom'` 으로 기록하기 시작했는데, 토큰 빌더가 `{color.<base>.<shade>}` placeholder 를 풀려다 'custom' 스케일을 못 찾아 throw 했음. base64 는 사후 색상 재해석이 불가능한 원본이므로 add tokens 를 no-op 으로 처리하고 안내 메시지 출력 (tokens.css 는 create 시점에 이미 정확히 주입됨)."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.61.3"
+    },
+    {
+      "version": "0.61.2",
+      "date": "2026-05-08",
+      "title": "fix — create 산출물의 sh-ui.config.json 누수 두 건 (paths.styles · theme.base)",
+      "type": "patch",
+      "highlights": [
+        "**템플릿의 `sh-ui.config.json` 에 `paths.styles` 추가** — `base.css` 같은 스타일 산출물이 `{styles}` placeholder 를 참조하는데 기존 템플릿(ui-app-template, nextjs-standalone fsd/flat) 이 `paths.styles` 를 안 박아 줘서 `sh-ui add base` 가 'paths.styles 가 sh-ui.config.json에 없습니다' 로 실패하던 문제. 이제 `create` 직후 추가 패치 없이 `add` 가 동작.",
+        "**`create --theme <preset|base64>` 결과가 `sh-ui.config.json` 의 `theme.base` 에 반영** — 기존엔 어떤 테마를 골라도 `theme.base` 가 템플릿 기본값(`neutral`)으로 남아 있어 의미 불일치. 이제 프리셋 이름이면 그 이름(`violet`/`rose`/...), base64 입력이면 `custom` 으로 기록.",
+        "**`init.mjs` 의 `PATHS.react` 에도 `styles` 추가** — `sh-ui init` 으로 만든 config 도 같은 시드 가짐."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.61.2"
+    },
     {
       "version": "0.61.1",
       "date": "2026-05-07",

package/package.json

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

package/src/add.mjs

@@ -172,6 +172,19 @@ async function addTokens(config, cwd, diffMode, summary, conflictResolver) {
   if (!destRel) throw new Error("paths.tokens 가 설정에 없습니다.");
   const dest = resolve(cwd, destRel);
 
+  // theme.base === 'custom' 이면 토큰 빌더가 color.custom.X 스케일을 못 찾아 throw 한다 —
+  // base64 테마는 사후 색상 재생성 자체가 불가능 (원본 base64 가 단일 진실, 재해석 X).
+  // create 시점에 tokens.css 가 이미 정확히 주입돼 있으므로 보존하고 사용자에게 안내한다.
+  if (config.theme?.base === 'custom') {
+    if (!diffMode) {
+      console.log(
+        `↷ tokens → ${relative(cwd, dest)} (custom 테마 — tokens.css 보존, ` +
+        `색 조정은 파일 직접 편집 또는 sh_ui_encode_theme 으로 새 base64 생성 후 재스캐폴드)`
+      );
+    }
+    return;
+  }
+
   const { buildTokens } = await loadTokensBuilder();
   const content = await buildTokens(config);
 

package/src/create/generator.js

@@ -78,7 +78,7 @@ import {
   DEFAULT_ARCH,
 } from './architectures/index.js';
 import { resolveTheme } from './theme/decode.js';
-import { THEME_PRESETS, getThemePreset } from './theme/presets.js';
+import { THEME_PRESETS, THEME_PRESET_NAMES, getThemePreset } from './theme/presets.js';
 import {
   replaceSection,
   buildCssColorsBlock,
@@ -114,12 +114,15 @@ import {
 const TEMPLATES_DIR = getTemplatesRoot();
 
 /**
- * 템플릿 복사 직후 sh-ui.config.json 의 cssFramework 필드를 갱신.
+ * 템플릿 복사 직후 sh-ui.config.json 의 cssFramework + theme.base 필드를 갱신.
  *
  * Flutter 는 cssFramework 가 의미 없으므로 platform=flutter 면 필드 자체를 안 쓴다.
  * Next.js 는 plain/tailwind/css-modules 따라 컴포넌트 변종 결정 + base 파일도 분기 emit.
+ *
+ * themeBase 는 사용자가 고른 프리셋 이름(neutral/slate/rose/emerald/violet) 또는
+ * 커스텀 base64 였을 때 'custom'. null 이면 템플릿 기본값 유지.
  */
-async function patchShUiConfig(configPath, cssFramework) {
+async function patchShUiConfig(configPath, cssFramework, themeBase) {
   if (!(await fs.pathExists(configPath))) return;
   const config = await fs.readJson(configPath);
   // Flutter 는 cssFramework 무관 — 필드 자체를 두지 않는다.
@@ -128,6 +131,10 @@ async function patchShUiConfig(configPath, cssFramework) {
   } else {
     config.cssFramework = cssFramework ?? CSS_FRAMEWORK_DEFAULT;
   }
+  if (themeBase != null) {
+    config.theme = config.theme ?? {};
+    config.theme.base = themeBase;
+  }
   await fs.writeJson(configPath, config, { spaces: 2 });
 }
 
@@ -208,8 +215,12 @@ export async function createProject(options = {}) {
   }
 
   let theme = null;
+  // themeBase: 'neutral'|'slate'|'rose'|'emerald'|'violet'|'custom'|null.
+  // sh-ui.config.json 의 theme.base 가 실제 사용된 팔레트를 반영하게 한다 (이전엔 항상 템플릿 기본값으로 남아 있던 문제).
+  let themeBase = null;
   if (options.theme) {
     theme = resolveTheme(options.theme);
+    themeBase = THEME_PRESET_NAMES.includes(options.theme) ? options.theme : 'custom';
   } else if (process.stdin.isTTY && !options.yes) {
     // --yes 는 "선택 옵션은 기본값으로" 의미. 테마는 옵션이므로 prompt 우회.
     const NONE = '__none__';
@@ -224,7 +235,10 @@ export async function createProject(options = {}) {
         })),
       ],
     });
-    if (choice !== NONE) theme = getThemePreset(choice);
+    if (choice !== NONE) {
+      theme = getThemePreset(choice);
+      themeBase = choice;
+    }
   }
 
   // dry-run 은 tmpdir 에 그대로 생성한 뒤 파일 목록 출력 + 정리.
@@ -250,7 +264,7 @@ export async function createProject(options = {}) {
   }
 
   if (platform === 'flutter') {
-    await generateFlutter(targetDir, projectName, theme, cssFramework);
+    await generateFlutter(targetDir, projectName, theme, cssFramework, themeBase);
     await finalizeProject(targetDir, { dryRun: options.dryRun });
     console.log(`\n✅ ${projectName} Flutter 프로젝트가 생성되었습니다!`);
     console.log(`\n  cd ${projectName}`);
@@ -276,9 +290,9 @@ export async function createProject(options = {}) {
   plugins.sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
 
   if (projectType === 'standalone') {
-    await generateStandalone(targetDir, projectName, plugins, theme, cssFramework, arch);
+    await generateStandalone(targetDir, projectName, plugins, theme, cssFramework, arch, themeBase);
   } else {
-    await generateMonorepo(targetDir, projectName, plugins, { yes: options.yes, theme, css: cssFramework, arch });
+    await generateMonorepo(targetDir, projectName, plugins, { yes: options.yes, theme, css: cssFramework, arch, themeBase });
   }
 
   await finalizeProject(targetDir, { dryRun: options.dryRun });
@@ -444,14 +458,14 @@ export async function addComponent(componentName, appName) {
 
 // ─── Generators ───
 
-async function generateFlutter(targetDir, projectName, theme, css) {
+async function generateFlutter(targetDir, projectName, theme, css, themeBase) {
   await fs.copy(path.join(TEMPLATES_DIR, 'flutter-standalone'), targetDir);
   await replaceInAllFiles(targetDir, '{{project_name}}', projectName);
   await injectDartTheme(targetDir, theme);
-  await patchShUiConfig(path.join(targetDir, 'sh-ui.config.json'), css);
+  await patchShUiConfig(path.join(targetDir, 'sh-ui.config.json'), css, themeBase);
 }
 
-async function generateStandalone(targetDir, projectName, plugins, theme, css, arch) {
+async function generateStandalone(targetDir, projectName, plugins, theme, css, arch, themeBase) {
   // 베이스 (arch-neutral) + arch 오버레이 — generateApp 과 같은 패턴.
   await fs.copy(path.join(TEMPLATES_DIR, 'nextjs-standalone'), targetDir, {
     filter: (src) => !src.includes(`${path.sep}_arch${path.sep}`) && !src.endsWith(`${path.sep}_arch`),
@@ -488,10 +502,10 @@ async function generateStandalone(targetDir, projectName, plugins, theme, css, a
   await applyTransforms(targetDir, plugins, arch);
   await applyCssFrameworkVariant(targetDir, css, { isMonorepo: false, plugins, arch });
   await injectCssTheme(targetDir, theme);
-  await patchShUiConfig(path.join(targetDir, 'sh-ui.config.json'), css);
+  await patchShUiConfig(path.join(targetDir, 'sh-ui.config.json'), css, themeBase);
 }
 
-async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch } = {}) {
+async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch, themeBase } = {}) {
   await fs.copy(path.join(TEMPLATES_DIR, 'monorepo'), targetDir);
 
   // Update root package.json
@@ -526,7 +540,7 @@ async function generateMonorepo(targetDir, projectName, plugins, { yes = false,
   // generateApp 이 ui-{app} 패키지의 cssFramework 변종까지 처리. 여기선 theme + sh-ui.config.json 만.
   const uiAppDir = path.join(targetDir, 'packages', 'ui', 'ui-apps', `ui-${appName}`);
   await injectCssTheme(uiAppDir, theme);
-  await patchShUiConfig(path.join(uiAppDir, 'sh-ui.config.json'), css);
+  await patchShUiConfig(path.join(uiAppDir, 'sh-ui.config.json'), css, themeBase);
 }
 
 async function generateApp(targetDir, appName, port, plugins, arch, css = 'tailwind') {

package/src/init.mjs

@@ -26,6 +26,7 @@ const DEFAULTS = INIT_DEFAULTS;
 const PATHS = {
   react: {
     tokens: "src/styles/tokens.css",
+    styles: "src/styles",
     components: "src/components/ui",
     utils: "src/lib/utils.ts",
   },

package/templates/nextjs-standalone/_arch/flat/sh-ui.config.json

@@ -8,6 +8,7 @@
   },
   "paths": {
     "tokens": "lib/styles/tokens.css",
+    "styles": "lib/styles",
     "components": "components/common",
     "utils": "lib/utils/utils.ts"
   },

package/templates/nextjs-standalone/_arch/fsd/sh-ui.config.json

@@ -8,6 +8,7 @@
   },
   "paths": {
     "tokens": "src/shared/styles/tokens.css",
+    "styles": "src/shared/styles",
     "components": "src/shared/ui",
     "utils": "src/shared/lib/utils.ts"
   },

package/templates/ui-app-template/sh-ui.config.json

@@ -8,6 +8,7 @@
   },
   "paths": {
     "tokens": "src/styles/tokens.css",
+    "styles": "src/styles",
     "components": "src/components",
     "utils": "src/lib/utils.ts"
   },