sh-ui-cli 0.96.2 → 0.97.0

package/data/changelog/versions.json

@@ -2,6 +2,32 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.97.0",
+      "date": "2026-05-16",
+      "title": "Tauri 통합 제거 — 스캐폴더에서 src-tauri/ shell 및 --tauri 옵션 삭제 (breaking)",
+      "type": "minor",
+      "highlights": [
+        "**`--tauri` / MCP `tauri` 옵션 제거 (breaking)** — `sh-ui-cli create` / `add-app` 의 `--tauri` 플래그, `sh_ui_create_project` · `sh_ui_add_app` · `sh_ui_describe_template` 의 `tauri` 인자, `DescribeTemplateOptions.tauri` 타입을 모두 삭제. 이제 `--tauri` 는 '알 수 없는 플래그' 에러로 거부된다.",
+        "**`tauri-shell` 템플릿 + `emitTauri`/`patchViteForTauri` 삭제** — `src-tauri/` (Cargo.toml·tauri.conf.json·Rust 소스) 를 더 이상 emit 하지 않는다. `@tauri-apps/*` 의존성·`tauri:dev`/`tauri:build` scripts·`src-tauri/target/` gitignore 주입도 제거. Tauri 가 필요하면 공식 `@tauri-apps/cli init` 을 직접 쓰면 된다 (vite 의 `dist/` 표준 산출물과 그대로 호환).",
+        "**docs `/create` UI 정리** — Tauri 데스크탑 셸 토글 제거, `/api/template-content` 의 src-tauri resolve 분기 삭제. vite 의 mobile/PWA 친화 디폴트(`viewport-fit=cover`·`theme-color`·webview reset)는 그대로 유지 — Tauri 전용이 아니라 일반 모바일 하드닝이라 보존.",
+        "**smoke 정리** — tauri 전용 시나리오(V7a–f, V12–14) 삭제, all-options 가드(V20a)는 i18n+sentry 조합으로 축소 유지. 마이그레이션: `--tauri` 쓰던 사용자는 플래그를 빼고 생성 후 `@tauri-apps/cli init` 으로 desktop shell 을 별도 추가."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.97.0"
+    },
+    {
+      "version": "0.96.3",
+      "date": "2026-05-16",
+      "title": "vite 스캐폴드 fix — vite 7 전환 + turbo outputs/env + tsconfig 누수 + ThemeProvider",
+      "type": "patch",
+      "highlights": [
+        "**vite `^5` → `^7` (+ `vite-plugin-static-copy` `^3.2.0`)** — vitest 4 와 vite 5 의 메이저 불일치로 `pnpm test` 가 테스트 0개에서도 startup 에서 죽던 문제 해소. i18n 이 끌어오는 static-copy peer 도 vite 7 라인으로 동반 상향.",
+        "**monorepo `turbo.json` 플랫폼 인지** — vite 앱은 `build.outputs` 가 `dist/**`, `globalEnv` 의 `API_URL` → `VITE_API_URL`. 그동안 `.next/**` 잔재로 turbo build 캐시가 전혀 안 잡히던 것 교정 (이제 FULL TURBO).",
+        "**`observability=sentry` + monorepo** — `MODE`·`SENTRY_ORG`·`SENTRY_PROJECT`·`SENTRY_AUTH_TOKEN` 를 turbo `globalEnv` 에 자동 선언해 깨끗한 scaffold 가 `turbo/no-undeclared-env-vars` 경고 없이 lint clean.",
+        "**tsconfig 누수 + ThemeProvider** — `tsc -b` 가 `vite.config.js`/`*.tsbuildinfo` 를 소스 옆에 흘리던 것을 `noEmit` + `node_modules/.tmp` 로 차단하고 `*.tsbuildinfo` gitignore. ThemeProvider 는 `useSyncExternalStore` 로 재작성해 React 19 set-state-in-effect 경고 제거."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.96.3"
+    },
     {
       "version": "0.96.2",
       "date": "2026-05-15",

package/package.json

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

package/src/api.d.ts

@@ -139,8 +139,6 @@ export interface DescribeTemplateOptions {
   projectName?: string;
   /** monorepo 첫 앱 이름. 기본 'web'. */
   appName?: string;
-  /** platform=vite + structure=standalone 일 때 Tauri 2.x 셸(`src-tauri/`) 동시 emit. */
-  tauri?: boolean;
   /** vite 전용 — react-i18next opt-in. v0.92.0+ */
   i18n?: 'none' | 'react-i18next';
   /** i18n 활성화 시 생성할 locale 코드 (comma-separated). 기본 'ko,en' */

package/src/create/cli-args.js

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

package/src/create/describeTemplate.js

@@ -35,7 +35,6 @@ 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 (standalone/monorepo 둘 다) 일 때 Tauri 2.x 셸 같이 emit
  * @property {'none'|'react-i18next'} [i18n]          vite 전용 — react-i18next 셋업
  * @property {string} [locales]                       i18n 활성화 시 생성할 locale 코드 (comma-separated, default 'ko,en')
  * @property {'none'|'sentry'} [observability]        vite 전용 — Sentry 셋업 (v0.93.0+)
@@ -66,7 +65,6 @@ export function describeTemplate(opts = {}) {
     plugins: pluginNames = [],
     cssFramework = CSS_FRAMEWORK_DEFAULT,
     appName: rawAppName = 'web',
-    tauri = false,
     i18n = 'none',
     locales = 'ko,en',
     observability = 'none',
@@ -97,14 +95,6 @@ export function describeTemplate(opts = {}) {
         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));
-      }
       if (i18n === 'react-i18next') {
         const isFsd = safeArchName === 'fsd';
         const i18nBase = isFsd ? 'src/shared/i18n' : 'src/lib/i18n';
@@ -170,15 +160,6 @@ export function describeTemplate(opts = {}) {
       ),
     ));
 
-    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) => `apps/${appName}/src-tauri/${p}`);
-      groups.push(makeGroup('tauri', `Tauri 셸 (apps/${appName}/src-tauri/)`, tauriFiles));
-    }
-
     if (i18n === 'react-i18next') {
       const isFsd = safeArchName === 'fsd';
       const i18nBase = isFsd ? 'src/shared/i18n' : 'src/lib/i18n';
@@ -426,7 +407,7 @@ function finalize(groups) {
  * 현재 규칙:
  *  - basename 이 정확히 'gitignore' 인 경로 → '.gitignore' 로 prefix dot 추가.
  *    (npm publish 가 .gitignore 를 strip 하므로 템플릿엔 점 없이 두고 emit 후 dot-prefix.)
- *  - 이미 '.gitignore' 인 경로 (예: tauri-shell 의 src-tauri/.gitignore) 는 그대로.
+ *  - 이미 '.gitignore' 인 경로는 그대로.
  *
  * 미래에 다른 fs-level rename 이 추가되면 여기에 같이 등록 (describeTemplate 의
  * file-plan ↔ create_project 의 실제 emit 1:1 정합성 유지).

package/src/create/generator.js

@@ -213,17 +213,6 @@ 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 사용.`,
-      );
-    }
-  }
-
   // i18n 옵션도 vite preset 전용. v0.92.0+.
   if (options.i18n && options.i18n !== 'none' && platform !== 'vite') {
     throw new Error(
@@ -359,7 +348,6 @@ export async function createProject(options = {}) {
 
     if (projectType === 'standalone') {
       await generateViteStandalone(targetDir, projectName, theme, cssFramework, arch, themeBase, {
-        tauri: !!options.tauri,
         i18n: options.i18n ?? 'none',
         locales: options.locales ?? 'ko,en',
         observability: options.observability ?? 'none',
@@ -368,7 +356,6 @@ export async function createProject(options = {}) {
       await generateMonorepo(targetDir, projectName, [], {
         yes: options.yes, theme, css: cssFramework, arch, themeBase,
         platform: 'vite',
-        tauri: options.tauri,
         i18n: options.i18n ?? 'none',
         locales: options.locales ?? 'ko,en',
         observability: options.observability ?? 'none',
@@ -392,14 +379,6 @@ export async function createProject(options = {}) {
     console.log(`\n  cd ${projectName}`);
     console.log('  pnpm install');
     console.log('  pnpm dev\n');
-    if (options.tauri) {
-      console.log('Tauri 데스크탑 셸:');
-      if (projectType === 'monorepo') {
-        console.log('  cd apps/web   # 또는 첫 앱 이름');
-      }
-      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;
@@ -534,11 +513,6 @@ export async function addApp(options = {}) {
       `add-app 는 platform=next 또는 vite 만 지원 (받은 값: ${platform}). flutter 는 standalone 만 지원.`,
     );
   }
-  if (options.tauri && platform !== 'vite') {
-    throw new Error(
-      `tauri 는 platform=vite 일 때만 지원합니다 (현재 platform=${platform}). --platform vite 사용 또는 tauri 옵션 제거.`,
-    );
-  }
   if (options.i18n && options.i18n !== 'none' && platform !== 'vite') {
     throw new Error(
       `i18n='${options.i18n}' 은 platform=vite 일 때만 지원합니다 (현재 platform=${platform}).`,
@@ -600,7 +574,6 @@ export async function addApp(options = {}) {
 
   if (platform === 'vite') {
     await generateViteApp(appsDir, appName, port, arch, css, {
-      tauri: !!options.tauri,
       i18n: options.i18n ?? 'none',
       locales: options.locales ?? 'ko,en',
       observability: options.observability ?? 'none',
@@ -620,13 +593,6 @@ export async function addApp(options = {}) {
   console.log(`\n✅ apps/${appName} 이 추가되었습니다!`);
   console.log('\n  pnpm install');
   console.log(`  pnpm --filter ${appName} dev\n`);
-
-  if (platform === 'vite' && options.tauri) {
-    console.log('Tauri 데스크탑 셸:');
-    console.log(`  cd apps/${appName}`);
-    console.log('  pnpm tauri dev     # Rust 처음 빌드는 5~10분 — 캐시 후 5~10초');
-    console.log('  (Rust 미설치 시 https://rustup.rs/ 참고)\n');
-  }
 }
 
 /**
@@ -867,7 +833,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, { tauri = false, i18n = 'none', locales = 'ko,en', observability = 'none' } = {}) {
+async function generateViteStandalone(targetDir, projectName, theme, css, arch, themeBase, { i18n = 'none', locales = 'ko,en', observability = 'none' } = {}) {
   // 베이스 (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`),
@@ -903,12 +869,6 @@ async function generateViteStandalone(targetDir, projectName, theme, css, 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, { devPort: 5173 });
-    await patchViteForTauri(targetDir, { port: 5173 });
-  }
-
   if (i18n === 'react-i18next') {
     const localesArr = parseLocales(locales);
     await emitI18n(targetDir, { arch, locales: localesArr });
@@ -919,101 +879,6 @@ async function generateViteStandalone(targetDir, projectName, theme, css, arch,
   }
 }
 
-/**
- * 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, { devPort = 5173 } = {}) {
-  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);
-  await replaceInAllFiles(srcTauriDir, '{{tauri_dev_url}}', `http://localhost:${devPort}`);
-}
-
-/**
- * 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, { port = 5173 } = {}) {
-  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: ${port},
-    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;
-    }
-  }
-}
-
 /**
  * react-i18next 셋업을 emit. arch 에 따라 경로가 달라짐:
  *  - fsd: src/shared/i18n/* + src/app/providers/I18nProvider.tsx
@@ -1054,7 +919,6 @@ import { initReactI18next } from 'react-i18next';
 // 클라이언트 측 lazy-load — 빌드 산출물에서 public/locales/{lng}/{ns}.json 경로로 fetch.
 // 원본 locale 파일은 ${i18nDirRel}/locales/* 에 두고, vite-plugin-static-copy 가
 // dev/build 양쪽에서 public/locales/* 로 자동 미러링한다 (vite.config.ts 참고).
-// Tauri 빌드의 경우도 dist/locales 에 그대로 포함된다.
 
 i18n
   .use(HttpBackend)
@@ -1144,7 +1008,7 @@ export function GlobalProvider({ children }: { children: ReactNode }) {
   pkg.devDependencies = pkg.devDependencies ?? {};
   // dev/build 양쪽에서 src/shared/i18n/locales/* (또는 src/lib/i18n/locales/*) 를
   // public/locales/* 로 자동 미러 → i18next-http-backend 의 /locales/{{lng}}/{{ns}}.json 이 동작.
-  pkg.devDependencies['vite-plugin-static-copy'] = '^2.2.0';
+  pkg.devDependencies['vite-plugin-static-copy'] = '^3.2.0';
   pkg.devDependencies = sortObjectKeys(pkg.devDependencies);
   await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 
@@ -1532,7 +1396,7 @@ async function patchViteConfigForSentry(targetDir) {
   await fs.writeFile(viteCfgPath, cfg);
 }
 
-async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch, themeBase, platform = 'next', tauri = false, i18n = 'none', locales = 'ko,en', observability = 'none', appName: appNameOpt = null, port: portOpt = null } = {}) {
+async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch, themeBase, platform = 'next', i18n = 'none', locales = 'ko,en', observability = 'none', appName: appNameOpt = null, port: portOpt = null } = {}) {
   await fs.copy(path.join(TEMPLATES_DIR, 'monorepo'), targetDir);
 
   // Update root package.json
@@ -1543,7 +1407,7 @@ async function generateMonorepo(targetDir, projectName, plugins, { yes = false,
 
   // CLAUDE.md 의 platform 분기 placeholder 치환. AI 에이전트가 Next.js 가정으로
   // 잘못된 컨벤션을 적용하지 않도록 (v0.94.0+).
-  const platformAppDesc = describeAppPlatform(platform, { tauri });
+  const platformAppDesc = describeAppPlatform(platform);
   await replaceInAllFiles(targetDir, '{{PLATFORM_APP_DESCRIPTION}}', platformAppDesc);
 
   // Update turbo.json
@@ -1554,6 +1418,18 @@ async function generateMonorepo(targetDir, projectName, plugins, { yes = false,
       turbo.globalEnv.push(...plugin.turboEnvVars);
     }
   }
+  // 템플릿 turbo.json 은 .next/** 기준이라 vite 앱에선 turbo 가 산출물을
+  // 못 찾아 build 캐시가 전혀 안 잡힌다 — 플랫폼별 outputs 로 교정.
+  if (platform === 'vite') {
+    turbo.tasks.build.outputs = ['dist/**'];
+    // vite 는 클라이언트 노출 env 가 VITE_ 접두사 관례.
+    turbo.globalEnv = turbo.globalEnv.map((e) => (e === 'API_URL' ? 'VITE_API_URL' : e));
+    // sentry observability 는 플러그인 turboEnvVars 훅을 안 타므로 직접 선언.
+    if (observability === 'sentry') {
+      turbo.globalEnv.push('MODE', 'SENTRY_ORG', 'SENTRY_PROJECT', 'SENTRY_AUTH_TOKEN');
+    }
+  }
+  turbo.globalEnv = [...new Set(turbo.globalEnv)];
   await fs.writeJson(turboPath, turbo, { spaces: 2 });
 
   // Create first app — `appName` 인자가 주어지면 그대로, 아니면 yes 모드 default 'web' / 대화모드 prompt.
@@ -1572,7 +1448,7 @@ async function generateMonorepo(targetDir, projectName, plugins, { yes = false,
 
   const appsDir = path.join(targetDir, 'apps', appName);
   if (platform === 'vite') {
-    await generateViteApp(appsDir, appName, port, arch, css, { tauri, i18n, locales, observability });
+    await generateViteApp(appsDir, appName, port, arch, css, { i18n, locales, observability });
   } else {
     await generateApp(appsDir, appName, port, plugins, arch, css);
   }
@@ -1673,7 +1549,7 @@ async function generateApp(targetDir, appName, port, plugins, arch, css = 'tailw
   }
 }
 
-async function generateViteApp(targetDir, appName, port, arch, css = 'tailwind', { tauri = false, i18n = 'none', locales = 'ko,en', observability = 'none' } = {}) {
+async function generateViteApp(targetDir, appName, port, arch, css = 'tailwind', { i18n = 'none', locales = 'ko,en', observability = 'none' } = {}) {
   // 베이스 (arch-neutral) + arch 오버레이 — generateApp 과 동일 패턴.
   await fs.copy(path.join(TEMPLATES_DIR, 'vite-app'), targetDir, {
     filter: (src) => !src.includes(`${path.sep}_arch${path.sep}`) && !src.endsWith(`${path.sep}_arch`),
@@ -1733,15 +1609,6 @@ async function generateViteApp(targetDir, appName, port, arch, css = 'tailwind',
     await applyCssFrameworkVariant(uiPkgDir, css, { isMonorepo: true, plugins: [], arch, isUiPackage: true });
   }
 
-  // tauri 가 켜져 있으면 이 app 안에 src-tauri/ shell 을 떨어뜨린다 (v0.90.0+).
-  // standalone 과 달리 monorepo 에서는 app 단위로 별도 dev port (default 3000) 가 있고,
-  // tauri 의 devUrl 이 그 port 와 일치해야 한다. frontendDist 는 src-tauri 기준 `../dist`.
-  if (tauri) {
-    const devPort = Number(port) || 3000;
-    await emitTauri(targetDir, appName, { devPort });
-    await patchViteForTauri(targetDir, { port: devPort });
-  }
-
   if (i18n === 'react-i18next') {
     const localesArr = parseLocales(locales);
     await emitI18n(targetDir, { arch, locales: localesArr });
@@ -2384,12 +2251,9 @@ async function finalizeProject(targetDir, { dryRun = false } = {}) {
  * CLAUDE.md 의 `{{PLATFORM_APP_DESCRIPTION}}` 치환용 문장 — AI 에이전트에게 어떤 플랫폼인지
  * 정확히 전달해서 잘못된 컨벤션 (예: vite 프로젝트에 App Router 가정) 적용 방지.
  */
-function describeAppPlatform(platform, { tauri = false } = {}) {
+function describeAppPlatform(platform) {
   if (platform === 'vite') {
-    const tauriSuffix = tauri
-      ? ' Tauri 데스크탑 셸이 동봉되어 있어 `src-tauri/` 가 native 진입점이다.'
-      : '';
-    return `Vite SPA (React + TypeScript). 라우트 + 비즈니스 로직. RSC / App Router 없음 — 모든 코드가 클라이언트 사이드 실행이다.${tauriSuffix}`;
+    return `Vite SPA (React + TypeScript). 라우트 + 비즈니스 로직. RSC / App Router 없음 — 모든 코드가 클라이언트 사이드 실행이다.`;
   }
   // 디폴트: Next.js. 향후 platform 추가 시 분기 늘릴 것.
   return 'Next.js 앱 (App Router + Server Components). 라우트 + 비즈니스 로직.';

package/src/create/index.mjs

@@ -18,7 +18,7 @@ export const HELP_TEXT = `sh-ui create — sh-ui 프로젝트 스캐폴드 (Next
 
 사용법:
   sh-ui create [name] [options] [--observability <none|sentry>]
-  sh-ui create add-app [name] [--port <n>] [--platform <next|vite>] [--plugins ..] [--theme ..] [--css ..] [--tauri] [--i18n <react-i18next|none>] [--locales ko,en] [--observability <none|sentry>]
+  sh-ui create add-app [name] [--port <n>] [--platform <next|vite>] [--plugins ..] [--theme ..] [--css ..] [--i18n <react-i18next|none>] [--locales ko,en] [--observability <none|sentry>]
   sh-ui create add-component <name> [--app <name>]
 
 옵션:
@@ -77,7 +77,6 @@ export async function runCreate(rest) {
       theme: flags.theme,
       css: flags.css,
       platform: flags.platform,
-      tauri: flags.tauri,
       i18n: flags.i18n,
       locales: flags.locales,
       observability: flags.observability,
@@ -97,7 +96,6 @@ export async function runCreate(rest) {
       arch: flags.arch,
       theme: flags.theme,
       css: flags.css,
-      tauri: flags.tauri,
       i18n: flags.i18n,
       locales: flags.locales,
       observability: flags.observability,

package/src/create/templateManifest.js

@@ -314,18 +314,6 @@ 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

@@ -432,7 +432,6 @@ export async function startMcpServer() {
     {
       description:
         "빈 폴더에 sh-ui 프로젝트 스캐폴드 — Next.js (standalone/monorepo) | Vite (standalone/monorepo) | Flutter. " +
-        "+ vite 인 경우 `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 가 사후 패치 없이 동작.",
@@ -461,13 +460,6 @@ 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 (standalone/monorepo 둘 다) 일 때만 지원. " +
-            "monorepo 의 경우 src-tauri/ 는 apps/{appName}/ 안에 emit, devUrl 은 해당 app 의 dev port 와 자동 동기화. " +
-            "Rust toolchain (`cargo`/`rustc`) 가 시스템에 설치되어 있어야 첫 `pnpm tauri dev` 가 동작. " +
-            "기본 false.",
-          ),
         i18n: z.enum(I18N_LIBRARIES).optional()
           .describe(
             "i18n 라이브러리 — platform=vite 일 때만 의미. 'react-i18next' 로 설정 시 i18next + react-i18next + browser-languagedetector + http-backend 셋업 + " +
@@ -513,15 +505,6 @@ 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.i18n && input.i18n !== "none" && input.platform !== "vite") {
         return {
           isError: true,
@@ -565,7 +548,6 @@ export async function startMcpServer() {
             arch: input.arch,
             theme: input.theme,
             css: input.cssFramework,
-            tauri: input.tauri,
             i18n: input.i18n,
             locales: input.locales,
             observability: input.observability,
@@ -589,7 +571,7 @@ export async function startMcpServer() {
         "사용자가 '앱 추가' / 'monorepo 에 새 앱' / 'add admin app' 류 요청을 하면 이 툴 사용 (Bash 로 npx " + cliName + " add-app 직접 호출보다 우선). " +
         "v0.65+ 레이아웃 준수 — ui-{name} 은 tokens-only role, 컴포넌트는 sibling ui-core 가 SoT. " +
         "theme/css 는 새 ui-app 에만 적용 (다른 앱 영향 없음). monorepo 가 아니면 (pnpm-workspace.yaml 없음) 에러. " +
-        "platform 미지정 시 기존 apps/* 스캔해 추론 (모든 앱이 같은 플랫폼이면 그것으로). vite + tauri:true 면 apps/{name}/src-tauri/ 도 함께 emit.",
+        "platform 미지정 시 기존 apps/* 스캔해 추론 (모든 앱이 같은 플랫폼이면 그것으로).",
       inputSchema: {
         name: z.string().min(1)
           .describe("앱 이름 — apps/{name}/ + packages/ui/ui-apps/ui-{name}/ 디렉토리명. 영숫자 + 하이픈."),
@@ -603,8 +585,6 @@ export async function startMcpServer() {
           .describe("CSS 프레임워크. 기본 plain. 새 앱의 컴포넌트 변종 결정 — 같은 모노레포 내 다른 앱과 다른 값 가능."),
         platform: z.enum(["next", "vite"]).optional()
           .describe("플랫폼 — next | vite. 미지정 시 기존 apps/* 의 deps 로 추론 (모든 앱이 같은 플랫폼이면 그것으로, 혼재면 명시 필요)."),
-        tauri: z.boolean().optional()
-          .describe("Tauri 2.x 데스크탑 셸 — platform=vite 일 때만 의미. apps/{name}/src-tauri/ 에 emit. 기본 false."),
         i18n: z.enum(I18N_LIBRARIES).optional()
           .describe(
             "i18n 라이브러리 — platform=vite 일 때만 의미. 'react-i18next' 로 설정 시 i18next + react-i18next + " +
@@ -629,15 +609,6 @@ export async function startMcpServer() {
       } catch (e) {
         return { isError: true, content: [{ type: "text", text: e.message }] };
       }
-      if (input.tauri && input.platform === "next") {
-        return {
-          isError: true,
-          content: [{
-            type: "text",
-            text: "tauri 는 platform=vite 일 때만 지원합니다. --platform vite 사용 또는 tauri 옵션 제거.",
-          }],
-        };
-      }
       if (input.i18n && input.i18n !== "none" && input.platform && input.platform !== "vite") {
         return {
           isError: true,
@@ -664,7 +635,6 @@ export async function startMcpServer() {
           theme: input.theme,
           css: input.cssFramework,
           platform: input.platform,
-          tauri: input.tauri,
           i18n: input.i18n,
           locales: input.locales,
           observability: input.observability,
@@ -1017,8 +987,6 @@ export async function startMcpServer() {
           .describe("monorepo 첫 앱 이름. 기본 web"),
         // vite 전용 — sh_ui_create_project 의 동일 옵션과 1:1 대응. describe ↔ create 가 같은
         // file-plan 을 보장하려면 여기서 받아 describeTemplate 에 전달해야 한다 (v0.95.0+).
-        tauri: z.boolean().optional()
-          .describe("Tauri 2.x 데스크탑 셸 emit (platform=vite 전용). 기본 false"),
         i18n: z.enum(I18N_LIBRARIES).optional()
           .describe(`i18n 라이브러리 (platform=vite 전용). 옵션: ${I18N_LIBRARIES.join(', ')}. 기본 none`),
         locales: z.string().optional()
@@ -1036,7 +1004,6 @@ export async function startMcpServer() {
           plugins: input.plugins,
           cssFramework: input.cssFramework,
           appName: input.appName,
-          tauri: input.tauri,
           i18n: input.i18n,
           locales: input.locales,
           observability: input.observability,

package/templates/vite-app/_arch/flat/src/components/providers/theme/ThemeProvider.tsx

@@ -1,4 +1,12 @@
-import { createContext, useCallback, useEffect, useMemo, useState, type ReactNode } from 'react';
+import {
+  createContext,
+  useCallback,
+  useEffect,
+  useMemo,
+  useState,
+  useSyncExternalStore,
+  type ReactNode,
+} from 'react';
 
 export type Theme = 'light' | 'dark' | 'system';
 
@@ -12,13 +20,14 @@ export const ThemeContext = createContext<ThemeContextValue | null>(null);
 
 const STORAGE_KEY = 'theme';
 
-function getSystemTheme(): 'light' | 'dark' {
-  if (typeof window === 'undefined') return 'light';
-  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+function subscribeSystemTheme(onChange: () => void): () => void {
+  const mq = window.matchMedia('(prefers-color-scheme: dark)');
+  mq.addEventListener('change', onChange);
+  return () => mq.removeEventListener('change', onChange);
 }
 
-function resolveTheme(theme: Theme): 'light' | 'dark' {
-  return theme === 'system' ? getSystemTheme() : theme;
+function getSystemTheme(): 'light' | 'dark' {
+  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
 }
 
 export function ThemeProvider({ children }: { children: ReactNode }) {
@@ -27,25 +36,19 @@ export function ThemeProvider({ children }: { children: ReactNode }) {
     return (localStorage.getItem(STORAGE_KEY) as Theme) ?? 'system';
   });
 
-  const [resolvedTheme, setResolvedTheme] = useState<'light' | 'dark'>(() => resolveTheme(theme));
+  // 시스템 테마는 외부 스토어(matchMedia) — useSyncExternalStore 로 구독해
+  // effect 안에서 setState 하지 않는다 (React 19 set-state-in-effect 회피).
+  const systemTheme = useSyncExternalStore(
+    subscribeSystemTheme,
+    getSystemTheme,
+    () => 'light' as const,
+  );
 
-  useEffect(() => {
-    const resolved = resolveTheme(theme);
-    setResolvedTheme(resolved);
-    document.documentElement.classList.toggle('dark', resolved === 'dark');
-  }, [theme]);
+  const resolvedTheme: 'light' | 'dark' = theme === 'system' ? systemTheme : theme;
 
   useEffect(() => {
-    if (theme !== 'system') return;
-    const mq = window.matchMedia('(prefers-color-scheme: dark)');
-    const handler = () => {
-      const resolved = getSystemTheme();
-      setResolvedTheme(resolved);
-      document.documentElement.classList.toggle('dark', resolved === 'dark');
-    };
-    mq.addEventListener('change', handler);
-    return () => mq.removeEventListener('change', handler);
-  }, [theme]);
+    document.documentElement.classList.toggle('dark', resolvedTheme === 'dark');
+  }, [resolvedTheme]);
 
   const setTheme = useCallback((next: Theme) => {
     setThemeState(next);
@@ -53,7 +56,10 @@ export function ThemeProvider({ children }: { children: ReactNode }) {
     else localStorage.setItem(STORAGE_KEY, next);
   }, []);
 
-  const value = useMemo(() => ({ theme, resolvedTheme, setTheme }), [theme, resolvedTheme, setTheme]);
+  const value = useMemo(
+    () => ({ theme, resolvedTheme, setTheme }),
+    [theme, resolvedTheme, setTheme],
+  );
 
   return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;
 }

package/templates/vite-app/_arch/flat/tsconfig.app.json

@@ -7,6 +7,7 @@
     "moduleResolution": "Bundler",
     "jsx": "react-jsx",
     "noEmit": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
     "baseUrl": ".",
     "paths": {
       "@/lib/*": ["./src/lib/*"],

package/templates/vite-app/_arch/fsd/src/app/providers/theme/ThemeProvider.tsx

@@ -1,4 +1,12 @@
-import { createContext, useCallback, useEffect, useMemo, useState, type ReactNode } from 'react';
+import {
+  createContext,
+  useCallback,
+  useEffect,
+  useMemo,
+  useState,
+  useSyncExternalStore,
+  type ReactNode,
+} from 'react';
 
 export type Theme = 'light' | 'dark' | 'system';
 
@@ -12,13 +20,14 @@ export const ThemeContext = createContext<ThemeContextValue | null>(null);
 
 const STORAGE_KEY = 'theme';
 
-function getSystemTheme(): 'light' | 'dark' {
-  if (typeof window === 'undefined') return 'light';
-  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+function subscribeSystemTheme(onChange: () => void): () => void {
+  const mq = window.matchMedia('(prefers-color-scheme: dark)');
+  mq.addEventListener('change', onChange);
+  return () => mq.removeEventListener('change', onChange);
 }
 
-function resolveTheme(theme: Theme): 'light' | 'dark' {
-  return theme === 'system' ? getSystemTheme() : theme;
+function getSystemTheme(): 'light' | 'dark' {
+  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
 }
 
 export function ThemeProvider({ children }: { children: ReactNode }) {
@@ -27,25 +36,19 @@ export function ThemeProvider({ children }: { children: ReactNode }) {
     return (localStorage.getItem(STORAGE_KEY) as Theme) ?? 'system';
   });
 
-  const [resolvedTheme, setResolvedTheme] = useState<'light' | 'dark'>(() => resolveTheme(theme));
+  // 시스템 테마는 외부 스토어(matchMedia) — useSyncExternalStore 로 구독해
+  // effect 안에서 setState 하지 않는다 (React 19 set-state-in-effect 회피).
+  const systemTheme = useSyncExternalStore(
+    subscribeSystemTheme,
+    getSystemTheme,
+    () => 'light' as const,
+  );
 
-  useEffect(() => {
-    const resolved = resolveTheme(theme);
-    setResolvedTheme(resolved);
-    document.documentElement.classList.toggle('dark', resolved === 'dark');
-  }, [theme]);
+  const resolvedTheme: 'light' | 'dark' = theme === 'system' ? systemTheme : theme;
 
   useEffect(() => {
-    if (theme !== 'system') return;
-    const mq = window.matchMedia('(prefers-color-scheme: dark)');
-    const handler = () => {
-      const resolved = getSystemTheme();
-      setResolvedTheme(resolved);
-      document.documentElement.classList.toggle('dark', resolved === 'dark');
-    };
-    mq.addEventListener('change', handler);
-    return () => mq.removeEventListener('change', handler);
-  }, [theme]);
+    document.documentElement.classList.toggle('dark', resolvedTheme === 'dark');
+  }, [resolvedTheme]);
 
   const setTheme = useCallback((next: Theme) => {
     setThemeState(next);
@@ -53,7 +56,10 @@ export function ThemeProvider({ children }: { children: ReactNode }) {
     else localStorage.setItem(STORAGE_KEY, next);
   }, []);
 
-  const value = useMemo(() => ({ theme, resolvedTheme, setTheme }), [theme, resolvedTheme, setTheme]);
+  const value = useMemo(
+    () => ({ theme, resolvedTheme, setTheme }),
+    [theme, resolvedTheme, setTheme],
+  );
 
   return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;
 }

package/templates/vite-app/_arch/fsd/tsconfig.app.json

@@ -7,6 +7,7 @@
     "moduleResolution": "Bundler",
     "jsx": "react-jsx",
     "noEmit": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
     "baseUrl": ".",
     "paths": {
       "@/*": ["./src/*"],

package/templates/vite-app/gitignore

@@ -6,3 +6,4 @@ dist/
 .env.*.local
 .vite/
 coverage/
+*.tsbuildinfo

package/templates/vite-app/package.json

@@ -41,7 +41,7 @@
     "jsdom": "^29.0.0",
     "tailwindcss": "^4.1.18",
     "typescript": "^5.9.3",
-    "vite": "^5.4.0",
+    "vite": "^7.0.0",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^4.1.0"
   }

package/templates/vite-app/tsconfig.node.json

@@ -1,6 +1,8 @@
 {
   "compilerOptions": {
     "composite": true,
+    "noEmit": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
     "skipLibCheck": true,
     "module": "ESNext",
     "moduleResolution": "Bundler",

package/templates/vite-standalone/_arch/flat/index.html

@@ -3,9 +3,9 @@
   <head>
     <meta charset="UTF-8" />
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <!-- viewport-fit=cover: iOS safe-area inset / Android edge-to-edge / Tauri mobile 호환 -->
+    <!-- viewport-fit=cover: iOS safe-area inset / Android edge-to-edge -->
     <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
-    <!-- theme-color: 모바일 브라우저 / PWA / Tauri WebView 의 status bar 톤. dark default 에 맞춰 어두운 톤. -->
+    <!-- theme-color: 모바일 브라우저 / PWA 의 status bar 톤. dark default 에 맞춰 어두운 톤. -->
     <meta name="theme-color" content="#0A0A0A" media="(prefers-color-scheme: dark)" />
     <meta name="theme-color" content="#FFFFFF" media="(prefers-color-scheme: light)" />
     <title>sh-ui app</title>

package/templates/vite-standalone/_arch/flat/src/components/providers/theme/ThemeProvider.tsx

@@ -1,4 +1,12 @@
-import { createContext, useCallback, useEffect, useMemo, useState, type ReactNode } from 'react';
+import {
+  createContext,
+  useCallback,
+  useEffect,
+  useMemo,
+  useState,
+  useSyncExternalStore,
+  type ReactNode,
+} from 'react';
 
 export type Theme = 'light' | 'dark' | 'system';
 
@@ -12,13 +20,14 @@ export const ThemeContext = createContext<ThemeContextValue | null>(null);
 
 const STORAGE_KEY = 'theme';
 
-function getSystemTheme(): 'light' | 'dark' {
-  if (typeof window === 'undefined') return 'light';
-  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+function subscribeSystemTheme(onChange: () => void): () => void {
+  const mq = window.matchMedia('(prefers-color-scheme: dark)');
+  mq.addEventListener('change', onChange);
+  return () => mq.removeEventListener('change', onChange);
 }
 
-function resolveTheme(theme: Theme): 'light' | 'dark' {
-  return theme === 'system' ? getSystemTheme() : theme;
+function getSystemTheme(): 'light' | 'dark' {
+  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
 }
 
 export function ThemeProvider({ children }: { children: ReactNode }) {
@@ -27,25 +36,19 @@ export function ThemeProvider({ children }: { children: ReactNode }) {
     return (localStorage.getItem(STORAGE_KEY) as Theme) ?? 'system';
   });
 
-  const [resolvedTheme, setResolvedTheme] = useState<'light' | 'dark'>(() => resolveTheme(theme));
+  // 시스템 테마는 외부 스토어(matchMedia) — useSyncExternalStore 로 구독해
+  // effect 안에서 setState 하지 않는다 (React 19 set-state-in-effect 회피).
+  const systemTheme = useSyncExternalStore(
+    subscribeSystemTheme,
+    getSystemTheme,
+    () => 'light' as const,
+  );
 
-  useEffect(() => {
-    const resolved = resolveTheme(theme);
-    setResolvedTheme(resolved);
-    document.documentElement.classList.toggle('dark', resolved === 'dark');
-  }, [theme]);
+  const resolvedTheme: 'light' | 'dark' = theme === 'system' ? systemTheme : theme;
 
   useEffect(() => {
-    if (theme !== 'system') return;
-    const mq = window.matchMedia('(prefers-color-scheme: dark)');
-    const handler = () => {
-      const resolved = getSystemTheme();
-      setResolvedTheme(resolved);
-      document.documentElement.classList.toggle('dark', resolved === 'dark');
-    };
-    mq.addEventListener('change', handler);
-    return () => mq.removeEventListener('change', handler);
-  }, [theme]);
+    document.documentElement.classList.toggle('dark', resolvedTheme === 'dark');
+  }, [resolvedTheme]);
 
   const setTheme = useCallback((next: Theme) => {
     setThemeState(next);
@@ -53,7 +56,10 @@ export function ThemeProvider({ children }: { children: ReactNode }) {
     else localStorage.setItem(STORAGE_KEY, next);
   }, []);
 
-  const value = useMemo(() => ({ theme, resolvedTheme, setTheme }), [theme, resolvedTheme, setTheme]);
+  const value = useMemo(
+    () => ({ theme, resolvedTheme, setTheme }),
+    [theme, resolvedTheme, setTheme],
+  );
 
   return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;
 }

package/templates/vite-standalone/_arch/flat/src/lib/styles/globals.css

@@ -34,8 +34,8 @@
   --color-sidebar-bg: var(--sidebar-bg);
 }
 
-/* sh-ui:webview-base-start — 모바일 브라우저 / Tauri WebView / PWA 공통 기본값.
- * v0.88.1+: Tauri 통합 + iOS/Android 친화. 사용자가 텍스트 셀렉트 필요한 곳은 input/textarea/
+/* sh-ui:webview-base-start — 모바일 브라우저 / PWA 공통 기본값.
+ * iOS/Android 친화. 사용자가 텍스트 셀렉트 필요한 곳은 input/textarea/
  * contenteditable 에 명시적으로 user-select: text 로 복원. 토큰이 아니라 reset 성 규칙이라
  * @theme inline 밖에 둠. */
 @layer base {

package/templates/vite-standalone/_arch/flat/tsconfig.app.json

@@ -13,6 +13,7 @@
     "resolveJsonModule": true,
     "allowSyntheticDefaultImports": true,
     "noEmit": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
     "baseUrl": ".",
     "paths": {
       "@/lib/*": ["./src/lib/*"],

package/templates/vite-standalone/_arch/fsd/index.html

@@ -3,9 +3,9 @@
   <head>
     <meta charset="UTF-8" />
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <!-- viewport-fit=cover: iOS safe-area inset / Android edge-to-edge / Tauri mobile 호환 -->
+    <!-- viewport-fit=cover: iOS safe-area inset / Android edge-to-edge -->
     <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
-    <!-- theme-color: 모바일 브라우저 / PWA / Tauri WebView 의 status bar 톤. dark default 에 맞춰 어두운 톤. -->
+    <!-- theme-color: 모바일 브라우저 / PWA 의 status bar 톤. dark default 에 맞춰 어두운 톤. -->
     <meta name="theme-color" content="#0A0A0A" media="(prefers-color-scheme: dark)" />
     <meta name="theme-color" content="#FFFFFF" media="(prefers-color-scheme: light)" />
     <title>sh-ui app</title>

package/templates/vite-standalone/_arch/fsd/src/app/providers/theme/ThemeProvider.tsx

@@ -1,4 +1,12 @@
-import { createContext, useCallback, useEffect, useMemo, useState, type ReactNode } from 'react';
+import {
+  createContext,
+  useCallback,
+  useEffect,
+  useMemo,
+  useState,
+  useSyncExternalStore,
+  type ReactNode,
+} from 'react';
 
 export type Theme = 'light' | 'dark' | 'system';
 
@@ -12,13 +20,14 @@ export const ThemeContext = createContext<ThemeContextValue | null>(null);
 
 const STORAGE_KEY = 'theme';
 
-function getSystemTheme(): 'light' | 'dark' {
-  if (typeof window === 'undefined') return 'light';
-  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+function subscribeSystemTheme(onChange: () => void): () => void {
+  const mq = window.matchMedia('(prefers-color-scheme: dark)');
+  mq.addEventListener('change', onChange);
+  return () => mq.removeEventListener('change', onChange);
 }
 
-function resolveTheme(theme: Theme): 'light' | 'dark' {
-  return theme === 'system' ? getSystemTheme() : theme;
+function getSystemTheme(): 'light' | 'dark' {
+  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
 }
 
 export function ThemeProvider({ children }: { children: ReactNode }) {
@@ -27,25 +36,19 @@ export function ThemeProvider({ children }: { children: ReactNode }) {
     return (localStorage.getItem(STORAGE_KEY) as Theme) ?? 'system';
   });
 
-  const [resolvedTheme, setResolvedTheme] = useState<'light' | 'dark'>(() => resolveTheme(theme));
+  // 시스템 테마는 외부 스토어(matchMedia) — useSyncExternalStore 로 구독해
+  // effect 안에서 setState 하지 않는다 (React 19 set-state-in-effect 회피).
+  const systemTheme = useSyncExternalStore(
+    subscribeSystemTheme,
+    getSystemTheme,
+    () => 'light' as const,
+  );
 
-  useEffect(() => {
-    const resolved = resolveTheme(theme);
-    setResolvedTheme(resolved);
-    document.documentElement.classList.toggle('dark', resolved === 'dark');
-  }, [theme]);
+  const resolvedTheme: 'light' | 'dark' = theme === 'system' ? systemTheme : theme;
 
   useEffect(() => {
-    if (theme !== 'system') return;
-    const mq = window.matchMedia('(prefers-color-scheme: dark)');
-    const handler = () => {
-      const resolved = getSystemTheme();
-      setResolvedTheme(resolved);
-      document.documentElement.classList.toggle('dark', resolved === 'dark');
-    };
-    mq.addEventListener('change', handler);
-    return () => mq.removeEventListener('change', handler);
-  }, [theme]);
+    document.documentElement.classList.toggle('dark', resolvedTheme === 'dark');
+  }, [resolvedTheme]);
 
   const setTheme = useCallback((next: Theme) => {
     setThemeState(next);
@@ -53,7 +56,10 @@ export function ThemeProvider({ children }: { children: ReactNode }) {
     else localStorage.setItem(STORAGE_KEY, next);
   }, []);
 
-  const value = useMemo(() => ({ theme, resolvedTheme, setTheme }), [theme, resolvedTheme, setTheme]);
+  const value = useMemo(
+    () => ({ theme, resolvedTheme, setTheme }),
+    [theme, resolvedTheme, setTheme],
+  );
 
   return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;
 }

package/templates/vite-standalone/_arch/fsd/src/shared/styles/globals.css

@@ -34,8 +34,8 @@
   --color-sidebar-bg: var(--sidebar-bg);
 }
 
-/* sh-ui:webview-base-start — 모바일 브라우저 / Tauri WebView / PWA 공통 기본값.
- * v0.88.1+: Tauri 통합 + iOS/Android 친화. 사용자가 텍스트 셀렉트 필요한 곳은 input/textarea/
+/* sh-ui:webview-base-start — 모바일 브라우저 / PWA 공통 기본값.
+ * iOS/Android 친화. 사용자가 텍스트 셀렉트 필요한 곳은 input/textarea/
  * contenteditable 에 명시적으로 user-select: text 로 복원. 토큰이 아니라 reset 성 규칙이라
  * @theme inline 밖에 둠. */
 @layer base {

package/templates/vite-standalone/_arch/fsd/tsconfig.app.json

@@ -13,6 +13,7 @@
     "resolveJsonModule": true,
     "allowSyntheticDefaultImports": true,
     "noEmit": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
     "baseUrl": ".",
     "paths": {
       "@/*": ["./src/*"]

package/templates/vite-standalone/gitignore

@@ -6,3 +6,4 @@ dist/
 .env.*.local
 .vite/
 coverage/
+*.tsbuildinfo

package/templates/vite-standalone/package.json

@@ -53,7 +53,7 @@
     "tailwindcss": "^4.1.18",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.54.0",
-    "vite": "^5.4.0",
+    "vite": "^7.0.0",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^4.1.0"
   },

package/templates/vite-standalone/tsconfig.node.json

@@ -1,6 +1,8 @@
 {
   "compilerOptions": {
     "composite": true,
+    "noEmit": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
     "skipLibCheck": true,
     "module": "ESNext",
     "moduleResolution": "Bundler",

package/templates/tauri-shell/Cargo.toml

@@ -1,21 +0,0 @@
-[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

@@ -1,49 +0,0 @@
-# {{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

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

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

@@ -1,12 +0,0 @@
-{
-  "$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

@@ -1,8 +0,0 @@
-#[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

@@ -1,6 +0,0 @@
-// 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

@@ -1,29 +0,0 @@
-{
-  "$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": "{{tauri_dev_url}}",
-    "beforeBuildCommand": "pnpm build",
-    "frontendDist": "../dist"
-  },
-  "app": {
-    "windows": [
-      {
-        "title": "{{project_name}}",
-        "width": 1200,
-        "height": 800
-      }
-    ],
-    "security": {
-      "csp": null
-    }
-  },
-  "bundle": {
-    "active": true,
-    "targets": "all",
-    "icon": []
-  }
-}