sh-ui-cli 0.87.0 → 0.88.0

package/data/changelog/versions.json

@@ -2,6 +2,19 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.88.0",
+      "date": "2026-05-14",
+      "title": "Tauri 2.x 데스크탑 셸 — sh_ui_create_project platform=vite tauri=true",
+      "type": "minor",
+      "highlights": [
+        "**`--tauri` 플래그 + MCP `tauri: true` 옵션** — `sh-ui-cli create --platform vite --structure standalone --tauri` 한 줄로 Vite SPA + Tauri 2.x 네이티브 셸 (`src-tauri/`) 일괄 emit. ai-org 같은 local-first 데스크탑 앱의 1급 진입점. v0.86.0 의 vite 프리셋과 짝 (Q1-Q5 design decisions 모두 confirmed: assume Rust installed, `src-tauri/` sibling layout, minimal capabilities, identifier placeholder, Tauri 2.x only).",
+        "**Tauri 2.x idioms 표준 준수** — `Cargo.toml` 의 lib name 은 snake_case (`{tauri_crate_name}_lib`), `tauri.conf.json` 의 `identifier` 는 `app.{crate}.dev` 플레이스홀더 (README 에 production 전 교체 TODO 명시), `capabilities/default.json` 은 `core:default` + `opener:default` 만 — fs/dialog/shell 권한은 사용자가 명시적 opt-in.",
+        "**Vite 패치 자동 적용** — Tauri 권장값(`clearScreen: false`, `server.strictPort: true`, `server.host: false`, `server.port: 5173`) 을 `vite.config.ts` 에 emit. `@tauri-apps/cli` (devDep), `@tauri-apps/api` + `@tauri-apps/plugin-opener` (dep) + `tauri`/`tauri:dev`/`tauri:build` scripts 자동 추가. `.gitignore` 에 `src-tauri/target/` 추가 (Rust 빌드 산출물 보호).",
+        "**가드 + 회귀 테스트** — `tauri: true + platform != vite` 또는 `tauri: true + structure == monorepo` 는 CLI 진입점 + MCP 진입점 양쪽에서 명시적 Korean 에러. monorepo + Tauri 는 v0.89 후속. smoke V7a-f 6 개 시나리오로 회귀 가드 (file emission, placeholder substitution, package/vite/gitignore patches, opt-out 회귀, 잘못된 조합 거부)."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.88.0"
+    },
     {
       "version": "0.87.0",
       "date": "2026-05-14",

package/package.json

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

package/src/create/cli-args.js

@@ -13,7 +13,7 @@ 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'];
-const BOOL_FLAGS = ['yes', 'help', 'dry-run'];
+const BOOL_FLAGS = ['yes', 'help', 'dry-run', 'tauri'];
 
 const SUBCOMMANDS = ['add-app', 'add-component'];
 

package/src/create/describeTemplate.js

@@ -35,6 +35,7 @@ import { CSS_FRAMEWORK_DEFAULT } from '../constants.js';
  * @property {'tailwind'|'plain'|'css-modules'} [cssFramework]
  * @property {string} [projectName]
  * @property {string} [appName]                       monorepo 첫 앱 이름. 기본 'web'
+ * @property {boolean} [tauri]                        platform=vite + structure=standalone 일 때 Tauri 2.x 셸 같이 emit
  */
 
 /**
@@ -62,6 +63,7 @@ export function describeTemplate(opts = {}) {
     plugins: pluginNames = [],
     cssFramework = CSS_FRAMEWORK_DEFAULT,
     appName: rawAppName = 'web',
+    tauri = false,
   } = opts;
 
   if (platform === 'flutter') {
@@ -85,10 +87,19 @@ export function describeTemplate(opts = {}) {
       }
       const baseFiles = tpl.base.slice();
       const archFiles = (tpl.arches?.[safeArchName] ?? []).slice();
-      return finalize([
+      const groups = [
         makeGroup('base', '베이스 (vite-standalone)', baseFiles),
         makeGroup('arch', `Arch (${safeArchName})`, archFiles),
-      ]);
+      ];
+      if (tauri) {
+        const tauriTpl = TEMPLATE_MANIFEST['tauri-shell'];
+        if (!tauriTpl) {
+          throw new Error("Template manifest missing entry for 'tauri-shell'.");
+        }
+        const tauriFiles = tauriTpl.base.map((p) => `src-tauri/${p}`);
+        groups.push(makeGroup('tauri', 'Tauri 셸 (src-tauri/)', tauriFiles));
+      }
+      return finalize(groups);
     }
 
     // monorepo — vite app 변형. Next monorepo 브랜치와 동일 구조이지만 vite-app 템플릿

package/src/create/generator.js

@@ -213,6 +213,23 @@ export async function createProject(options = {}) {
     ],
   });
 
+  // tauri 옵션은 platform=vite + structure=standalone 일 때만 의미. 다른 조합은 명시적 에러.
+  // (MCP 진입점은 mcp.mjs 가 이미 동일 가드 — CLI 직접 호출에도 동일 안전망.)
+  if (options.tauri) {
+    if (platform !== 'vite') {
+      throw new Error(
+        `tauri: true 는 platform=vite 일 때만 지원합니다 (현재 platform=${platform}). ` +
+        `--tauri 옵션 제거 또는 --platform vite 사용.`,
+      );
+    }
+    if (options.structure === 'monorepo') {
+      throw new Error(
+        'platform=vite + structure=monorepo + tauri=true 는 아직 지원 안 함 (v0.89 후속). ' +
+        'standalone 으로 시도하거나 tauri 옵션 제거.',
+      );
+    }
+  }
+
   // arch 결정 — platform 확정 후. 사용자가 --arch 미지정 시:
   //   - next  → DEFAULT_ARCH ('fsd')
   //   - flutter → 현재 Flutter arch 디스크립터 없음 → null. 미래에 flutter arch 추가되면
@@ -333,8 +350,15 @@ export async function createProject(options = {}) {
     });
 
     if (projectType === 'standalone') {
-      await generateViteStandalone(targetDir, projectName, theme, cssFramework, arch, themeBase);
+      await generateViteStandalone(targetDir, projectName, theme, cssFramework, arch, themeBase, { tauri: !!options.tauri });
     } else {
+      // monorepo + tauri 는 v0.89 후속 — 명시적 에러
+      if (options.tauri) {
+        throw new Error(
+          'platform=vite + structure=monorepo + tauri=true 는 아직 지원 안 함 (v0.89 후속). ' +
+          'standalone 으로 시도하거나 tauri 옵션 제거.',
+        );
+      }
       await generateMonorepo(targetDir, projectName, [], { yes: options.yes, theme, css: cssFramework, arch, themeBase, platform: 'vite' });
     }
 
@@ -353,6 +377,11 @@ export async function createProject(options = {}) {
     console.log(`\n  cd ${projectName}`);
     console.log('  pnpm install');
     console.log('  pnpm dev\n');
+    if (options.tauri && projectType === 'standalone') {
+      console.log('Tauri 데스크탑 셸:');
+      console.log('  pnpm tauri dev     # Rust 처음 빌드는 5~10분 — 캐시 후 5~10초');
+      console.log('  (Rust 미설치 시 https://rustup.rs/ 참고)\n');
+    }
     console.log('다음 단계 — 베이스 컴포넌트 추가 (예시):');
     console.log('  npx sh-ui-cli add button card input dialog\n');
     return;
@@ -731,7 +760,7 @@ async function generateStandalone(targetDir, projectName, plugins, theme, css, a
   await patchShUiConfig(path.join(targetDir, 'sh-ui.config.json'), css, themeBase);
 }
 
-async function generateViteStandalone(targetDir, projectName, theme, css, arch, themeBase) {
+async function generateViteStandalone(targetDir, projectName, theme, css, arch, themeBase, { tauri = false } = {}) {
   // 베이스 (arch-neutral) + arch 오버레이 — generateStandalone 과 같은 패턴.
   await fs.copy(path.join(TEMPLATES_DIR, 'vite-standalone'), targetDir, {
     filter: (src) => !src.includes(`${path.sep}_arch${path.sep}`) && !src.endsWith(`${path.sep}_arch`),
@@ -766,6 +795,106 @@ async function generateViteStandalone(targetDir, projectName, theme, css, arch,
   await applyCssFrameworkVariant(targetDir, css, { isMonorepo: false, plugins: [], arch });
   await injectCssTheme(targetDir, theme);
   await patchShUiConfig(path.join(targetDir, 'sh-ui.config.json'), css, themeBase);
+
+  // Tauri 셸 emit (옵션) — vite SPA + native window. standalone 만 v1 지원.
+  if (tauri) {
+    await emitTauri(targetDir, projectName);
+    await patchViteForTauri(targetDir);
+  }
+}
+
+/**
+ * tauri-shell 템플릿을 `<targetDir>/src-tauri/` 로 복사하고 placeholder 치환.
+ *
+ * - `{{project_name}}` → projectName (kebab-case 유지, npm 패키지명과 동일)
+ * - `{{tauri_crate_name}}` → snake_case 변환 (Rust crate name 규칙: 영숫자+언더스코어).
+ *   하이픈/점/대문자가 들어 있으면 모두 안전한 형태로 정규화.
+ *
+ * generateViteStandalone 에서 tauri: true 인 경우 호출. monorepo+tauri 는 v0.89 후속.
+ */
+async function emitTauri(targetDir, projectName) {
+  const srcTauriDir = path.join(targetDir, 'src-tauri');
+  await fs.copy(path.join(TEMPLATES_DIR, 'tauri-shell'), srcTauriDir);
+
+  // crate name: snake_case 강제 — Rust 식별자는 영숫자+'_' 만 허용
+  const tauriCrateName = projectName
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '_')
+    .replace(/^_+|_+$/g, '');
+
+  await replaceInAllFiles(srcTauriDir, '{{tauri_crate_name}}', tauriCrateName);
+  await replaceInAllFiles(srcTauriDir, '{{project_name}}', projectName);
+}
+
+/**
+ * vite 앱의 package.json + vite.config.ts 를 Tauri 친화적으로 패치.
+ *
+ * - package.json: `@tauri-apps/cli` (devDep), `@tauri-apps/api` (dep), `tauri`/`tauri:dev`/`tauri:build` scripts 추가
+ * - vite.config.ts: Tauri 공식 권장값 추가 — `clearScreen: false`, `server.strictPort: true`,
+ *   `server.host: false`, `server.port: 5173`. 그래야 Tauri 가 dev server 를 안정적으로 wrap.
+ *
+ * NOTE: vite.config.ts 를 전부 재작성한다. 현재 base template 의 vite.config.ts 는 arch-neutral
+ * 이라 안전. 후속 task 에서 arch-specific vite.config.ts overlay 가 생기면 이 자리에서 머지 전략
+ * 필요 (현재는 단순 overwrite).
+ */
+async function patchViteForTauri(targetDir) {
+  const pkgPath = path.join(targetDir, 'package.json');
+  const pkg = await fs.readJson(pkgPath);
+
+  pkg.dependencies = pkg.dependencies ?? {};
+  pkg.devDependencies = pkg.devDependencies ?? {};
+  pkg.scripts = pkg.scripts ?? {};
+
+  pkg.dependencies['@tauri-apps/api'] = '^2.0.0';
+  pkg.dependencies['@tauri-apps/plugin-opener'] = '^2.0.0';
+  pkg.devDependencies['@tauri-apps/cli'] = '^2.0.0';
+
+  pkg.scripts.tauri = 'tauri';
+  pkg.scripts['tauri:dev'] = 'tauri dev';
+  pkg.scripts['tauri:build'] = 'tauri build';
+
+  pkg.dependencies = sortObjectKeys(pkg.dependencies);
+  pkg.devDependencies = sortObjectKeys(pkg.devDependencies);
+  await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+
+  // vite.config.ts 재작성 — Tauri 공식 권장 설정 추가.
+  const viteCfgPath = path.join(targetDir, 'vite.config.ts');
+  const viteCfg = `import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import tailwindcss from '@tailwindcss/vite';
+import tsconfigPaths from 'vite-tsconfig-paths';
+
+// Tauri 권장 설정 (https://v2.tauri.app/start/frontend/vite/)
+//  - clearScreen: false   — Rust 컴파일 에러가 터미널을 가리지 않게
+//  - server.strictPort    — Tauri 가 사용할 포트를 고정 (충돌 시 에러)
+//  - server.host: false   — Tauri dev 가 host network 안 열어도 됨
+export default defineConfig({
+  plugins: [react(), tailwindcss(), tsconfigPaths()],
+  clearScreen: false,
+  server: {
+    port: 5173,
+    strictPort: true,
+    host: false,
+  },
+});
+`;
+  await fs.writeFile(viteCfgPath, viteCfg);
+
+  // .gitignore 에 src-tauri/target 추가 — Rust 빌드 산출물 (수 GB 가능).
+  // 스캐폴드 단계에서는 파일명이 `gitignore` (점 없음); finalizeProject 가 나중에 `.gitignore` 로 rename.
+  // 양쪽 이름 모두 시도해서 호출 순서가 달라져도 안전하게 적용.
+  const gitignoreCandidates = ['.gitignore', 'gitignore'];
+  for (const name of gitignoreCandidates) {
+    const p = path.join(targetDir, name);
+    if (await fs.pathExists(p)) {
+      let ignore = await fs.readFile(p, 'utf-8');
+      if (!ignore.includes('src-tauri/target')) {
+        ignore += `\n# Tauri build artifacts\nsrc-tauri/target/\n`;
+        await fs.writeFile(p, ignore);
+      }
+      break;
+    }
+  }
 }
 
 async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch, themeBase, platform = 'next' } = {}) {

package/src/create/index.mjs

@@ -89,6 +89,7 @@ export async function runCreate(rest) {
       arch: flags.arch,
       theme: flags.theme,
       css: flags.css,
+      tauri: flags.tauri,
       yes: flags.yes,
       dryRun: flags.dryRun,
     });

package/src/create/templateManifest.js

@@ -314,6 +314,18 @@ export const TEMPLATE_MANIFEST = {
       ]
     }
   },
+  "tauri-shell": {
+    "base": [
+      ".gitignore",
+      "Cargo.toml",
+      "README.md",
+      "build.rs",
+      "capabilities/default.json",
+      "src/lib.rs",
+      "src/main.rs",
+      "tauri.conf.json"
+    ]
+  },
   "ui-app-template": {
     "base": [
       "eslint.config.js",

package/src/mcp.mjs

@@ -367,6 +367,7 @@ export async function startMcpServer() {
     {
       description:
         "빈 폴더에 sh-ui 프로젝트 스캐폴드 — Next.js (standalone/monorepo) | Vite (standalone/monorepo) | Flutter. " +
+        "+ vite + standalone 인 경우 `tauri: true` 로 Tauri 2.x 데스크탑 셸 (`src-tauri/`) 까지 한 번에 emit (Rust toolchain 필요). " +
         `FSD 폴더 구조 + 토큰 + sh-ui.config.json 일괄 생성. 사용자가 '새 프로젝트' / '빈 폴더' / '스캐폴드부터' 류 요청을 하면 이 툴 사용 (Bash 로 npx ${cliName} create 직접 호출보다 우선). ` +
         "**단일 진입점** — theme/plugins/cssFramework/structure 모두 호출 시점에 정해서 한 번에 박는다. 호출 후 sh-ui.config.json/tokens.css 를 손으로 패치하지 말 것 (다음 재스캐폴드 시 유실). " +
         "산출물: theme 인자가 프리셋이면 sh-ui.config.json 의 theme.base 가 그 이름, base64 면 'custom'. paths.styles · paths.tokens 도 자동 박혀서 sh_ui_add_component 가 사후 패치 없이 동작.",
@@ -394,6 +395,12 @@ export async function startMcpServer() {
           .describe("부모 디렉토리. 기본 process.cwd()"),
         force: z.boolean().optional()
           .describe("기존 디렉토리 덮어쓰기. 기본 false (안전)"),
+        tauri: z.boolean().optional()
+          .describe(
+            "Tauri 2.x 데스크탑 셸 (`src-tauri/`) 함께 emit. platform=vite + structure=standalone 일 때만 지원. " +
+            "Rust toolchain (`cargo`/`rustc`) 가 시스템에 설치되어 있어야 첫 `pnpm tauri dev` 가 동작. " +
+            "기본 false. monorepo + tauri 는 v0.89 후속.",
+          ),
       },
     },
     async (input) => {
@@ -415,6 +422,24 @@ export async function startMcpServer() {
       } catch (e) {
         return { isError: true, content: [{ type: "text", text: e.message }] };
       }
+      if (input.tauri && input.platform !== "vite") {
+        return {
+          isError: true,
+          content: [{
+            type: "text",
+            text: "tauri: true 는 platform=vite 일 때만 지원합니다 (현재 platform=" + input.platform + ").",
+          }],
+        };
+      }
+      if (input.tauri && input.structure === "monorepo") {
+        return {
+          isError: true,
+          content: [{
+            type: "text",
+            text: "platform=vite + structure=monorepo + tauri=true 는 아직 지원 안 함 (v0.89 후속). standalone 으로 시도하거나 tauri 옵션 제거.",
+          }],
+        };
+      }
       const targetParent = resolveCwd(input);
       const targetDir = resolve(targetParent, input.name);
       if (existsSync(targetDir) && !input.force) {
@@ -440,6 +465,7 @@ export async function startMcpServer() {
             arch: input.arch,
             theme: input.theme,
             css: input.cssFramework,
+            tauri: input.tauri,
             yes: true, // 사전 검사를 마쳤으니 generator 의 confirm 프롬프트 우회
           }),
         );

package/templates/tauri-shell/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "{{tauri_crate_name}}"
+version = "0.1.0"
+description = "{{project_name}} desktop shell"
+authors = ["you"]
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[lib]
+name = "{{tauri_crate_name}}_lib"
+crate-type = ["staticlib", "cdylib", "rlib"]
+
+[build-dependencies]
+tauri-build = { version = "2", features = [] }
+
+[dependencies]
+tauri = { version = "2", features = [] }
+tauri-plugin-opener = "2"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"

package/templates/tauri-shell/README.md

@@ -0,0 +1,49 @@
+# {{project_name}} — Tauri 데스크탑 셸
+
+이 디렉토리는 Tauri 2.x 의 Rust 코드입니다. 부모 디렉토리의 vite SPA 가
+프론트엔드, 이 디렉토리가 native 윈도우 셸.
+
+## 첫 실행
+
+```bash
+# 부모 디렉토리에서 (vite 앱 루트)
+pnpm install
+pnpm tauri dev    # Rust 처음 빌드는 5~10분 — 캐시되면 이후 5~10초
+```
+
+Rust toolchain (`cargo`, `rustc`) 이 시스템에 설치되어 있어야 합니다. 없으면
+https://rustup.rs/ 참고.
+
+## 프로덕션 빌드 전 체크리스트
+
+1. **Bundle identifier** — `tauri.conf.json` 의 `identifier: "app.{{tauri_crate_name}}.dev"` 를
+   실제 도메인 기반 unique ID 로 교체 (예: `com.yourcompany.{{tauri_crate_name}}`).
+   동일 ID 로 publish 된 다른 앱과 충돌 시 OS install 이 깨질 수 있음.
+2. **Icons** — `tauri.conf.json` 의 `bundle.icon: []` 가 비어 있습니다. 프로덕션 빌드 시:
+   - 1024x1024 PNG 준비 (square, 투명 배경 권장)
+   - 부모 디렉토리에서 `pnpm tauri icon path/to/source.png` 실행 — `src-tauri/icons/` 에
+     플랫폼별 variants 자동 emit + `bundle.icon` 자동 채워짐
+3. **Capabilities** — `capabilities/default.json` 은 최소 권한. fs / dialog / shell 등
+   확장 API 가 필요하면 https://v2.tauri.app/security/ 참고.
+4. **Window 옵션** — `tauri.conf.json` 의 `app.windows[0]` 에 `decorations`, `transparent`,
+   `alwaysOnTop` 등 추가 가능.
+
+## Rust 코드 추가
+
+`src/lib.rs` 의 `invoke_handler![]` 안에 새 command 등록:
+
+```rust
+#[tauri::command]
+fn my_command(name: &str) -> String {
+    format!("Hello, {}!", name)
+}
+
+// run() 안의 .invoke_handler 에:
+.invoke_handler(tauri::generate_handler![my_command])
+```
+
+프론트엔드에서:
+```ts
+import { invoke } from '@tauri-apps/api/core';
+const greeting = await invoke<string>('my_command', { name: 'World' });
+```

package/templates/tauri-shell/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+    tauri_build::build()
+}

package/templates/tauri-shell/capabilities/default.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "../gen/schemas/desktop-schema.json",
+  "identifier": "default",
+  "description": "기본 capability — 핵심 Tauri API 만 허용. 추가 권한 (fs / dialog / shell 등) 은 https://v2.tauri.app/security/ 참고해서 명시적 추가.",
+  "windows": [
+    "main"
+  ],
+  "permissions": [
+    "core:default",
+    "opener:default"
+  ]
+}

package/templates/tauri-shell/src/lib.rs

@@ -0,0 +1,8 @@
+#[cfg_attr(mobile, tauri::mobile_entry_point)]
+pub fn run() {
+    tauri::Builder::default()
+        .plugin(tauri_plugin_opener::init())
+        .invoke_handler(tauri::generate_handler![])
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
+}

package/templates/tauri-shell/src/main.rs

@@ -0,0 +1,6 @@
+// Prevents additional console window on Windows in release.
+#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
+
+fn main() {
+    {{tauri_crate_name}}_lib::run()
+}

package/templates/tauri-shell/tauri.conf.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://schema.tauri.app/config/2",
+  "productName": "{{project_name}}",
+  "version": "0.1.0",
+  "identifier": "app.{{tauri_crate_name}}.dev",
+  "build": {
+    "beforeDevCommand": "pnpm dev",
+    "devUrl": "http://localhost:5173",
+    "beforeBuildCommand": "pnpm build",
+    "frontendDist": "../dist"
+  },
+  "app": {
+    "windows": [
+      {
+        "title": "{{project_name}}",
+        "width": 1200,
+        "height": 800
+      }
+    ],
+    "security": {
+      "csp": null
+    }
+  },
+  "bundle": {
+    "active": true,
+    "targets": "all",
+    "icon": []
+  }
+}