sh-ui-cli 0.63.0 → 0.64.0

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.64.0",
+      "date": "2026-05-08",
+      "title": "minor — proxy.ts 에 `HOME_REDIRECT` 자리 + input strict-indexing 회귀 fix",
+      "type": "minor",
+      "highlights": [
+        "**templates proxy.ts 에 `HOME_REDIRECT` 상수 추가** — `/` 진입 시 redirect 할 path 를 사용자가 한 줄로 지정. 빈 문자열이 기본이라 동작 변화 없음(= `app/page.tsx` 그대로 노출). `auth-jwt` 단독 / `next-intl` 단독 / `auth-jwt + next-intl` 합성 세 케이스 모두 동일 패턴. `/[locale]/page.tsx` 에 redirect RSC 를 따로 만들 필요 없이 미들웨어 한 곳에서 라우팅 게이트 처리.",
+        "**fix(input)**: `isValidBRN` 의 배열 인덱싱 4곳에 non-null assertion 추가 — `noUncheckedIndexedAccess: true` 인 사용자 프로젝트에서 `parseInt(d[i], 10)` 가 `string | undefined` 로 접혀 typecheck 실패하던 회귀. 직전 길이 가드(`d.length !== 10`) 로 모든 접근이 안전한 구간이라 런타임 동작 변경 없음. plain / tailwind / vanilla-extract / css-modules + `apps/docs` 듀얼카피본 동기화."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.64.0"
+    },
+    {
+      "version": "0.63.1",
+      "date": "2026-05-08",
+      "title": "patch — templates ThemeProvider 옵션 정비",
+      "type": "patch",
+      "highlights": [
+        "**templates 의 `ThemeProvider` 4곳에 `disableTransitionOnChange` 추가** — 토글 순간 transition 깜빡임 차단. nextjs-app / nextjs-standalone × flat / fsd 변종 모두 동일.",
+        "**옵션 의도 코멘트 보강** — attribute='class', defaultTheme/enableSystem, disableTransitionOnChange 가 왜 들어 있는지 + useTheme 는 next-themes 에서 직접 import 한다는 점을 파일 상단에 명시. 사용자가 RootLayout 작업 시 어디를 만져야 하는지 한눈에."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.63.1"
+    },
     {
       "version": "0.63.0",
       "date": "2026-05-08",

package/data/registry/react/components/input/index.module.tsx

@@ -352,10 +352,10 @@ export function isValidBRN(digits: string): boolean {
   if (d.length !== 10) return false;
   const w = [1, 3, 7, 1, 3, 7, 1, 3, 5];
   let sum = 0;
-  for (let i = 0; i < 9; i++) sum += parseInt(d[i], 10) * w[i];
-  sum += Math.floor((parseInt(d[8], 10) * 5) / 10);
+  for (let i = 0; i < 9; i++) sum += parseInt(d[i]!, 10) * w[i]!;
+  sum += Math.floor((parseInt(d[8]!, 10) * 5) / 10);
   const check = (10 - (sum % 10)) % 10;
-  return check === parseInt(d[9], 10);
+  return check === parseInt(d[9]!, 10);
 }
 
 export interface BusinessNumberInputProps

package/data/registry/react/components/input/index.tailwind.tsx

@@ -298,10 +298,10 @@ export function isValidBRN(digits: string): boolean {
   if (d.length !== 10) return false;
   const w = [1, 3, 7, 1, 3, 7, 1, 3, 5];
   let sum = 0;
-  for (let i = 0; i < 9; i++) sum += parseInt(d[i], 10) * w[i];
-  sum += Math.floor((parseInt(d[8], 10) * 5) / 10);
+  for (let i = 0; i < 9; i++) sum += parseInt(d[i]!, 10) * w[i]!;
+  sum += Math.floor((parseInt(d[8]!, 10) * 5) / 10);
   const check = (10 - (sum % 10)) % 10;
-  return check === parseInt(d[9], 10);
+  return check === parseInt(d[9]!, 10);
 }
 
 export interface BusinessNumberInputProps

package/data/registry/react/components/input/index.tsx

@@ -377,10 +377,10 @@ export function isValidBRN(digits: string): boolean {
   if (d.length !== 10) return false;
   const w = [1, 3, 7, 1, 3, 7, 1, 3, 5];
   let sum = 0;
-  for (let i = 0; i < 9; i++) sum += parseInt(d[i], 10) * w[i];
-  sum += Math.floor((parseInt(d[8], 10) * 5) / 10);
+  for (let i = 0; i < 9; i++) sum += parseInt(d[i]!, 10) * w[i]!;
+  sum += Math.floor((parseInt(d[8]!, 10) * 5) / 10);
   const check = (10 - (sum % 10)) % 10;
-  return check === parseInt(d[9], 10);
+  return check === parseInt(d[9]!, 10);
 }
 
 export interface BusinessNumberInputProps

package/data/registry/react/components/input/index.vanilla-extract.tsx

@@ -307,10 +307,10 @@ export function isValidBRN(digits: string): boolean {
   if (d.length !== 10) return false;
   const w = [1, 3, 7, 1, 3, 7, 1, 3, 5];
   let sum = 0;
-  for (let i = 0; i < 9; i++) sum += parseInt(d[i], 10) * w[i];
-  sum += Math.floor((parseInt(d[8], 10) * 5) / 10);
+  for (let i = 0; i < 9; i++) sum += parseInt(d[i]!, 10) * w[i]!;
+  sum += Math.floor((parseInt(d[8]!, 10) * 5) / 10);
   const check = (10 - (sum % 10)) % 10;
-  return check === parseInt(d[9], 10);
+  return check === parseInt(d[9]!, 10);
 }
 
 export interface BusinessNumberInputProps

package/package.json

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

package/src/create/generator.js

@@ -1348,6 +1348,13 @@ import { routing } from '${configAlias}/i18n/routing';
 
 const AUTH_ROUTES = ['/sign-in', '/sign-up'];
 
+/**
+ * 홈(\`/\`, \`/{locale}\`) 진입 시 redirect 할 path. 빈 문자열이면
+ * \`app/[locale]/page.tsx\` 가 그대로 노출. 예: '/dashboard', '/projects'.
+ * 인증 가드 위에서 동작하므로 미인증이면 그대로 \`/sign-in\` 으로 빠진다.
+ */
+const HOME_REDIRECT = '';
+
 const intl = createIntlMiddleware(routing);
 
 /**
@@ -1368,7 +1375,8 @@ const stripLocalePrefix = (pathname: string): string => {
  * Next 16+ proxy.ts (구 middleware.ts).
  * next-intl 라우팅 + auth-jwt 토큰 존재 체크 합성 버전.
  *
- * - intl 이 먼저 로케일 prefix 처리 + NEXT_LOCALE 쿠키 set
+ * - \`/\` + HOME_REDIRECT 설정 → 해당 경로로 리다이렉트 (인증 가드보다 먼저)
+ * - intl 이 로케일 prefix 처리 + NEXT_LOCALE 쿠키 set
  * - 그 위에 인증 가드 — 토큰 없고 인증 라우트도 아니면 /sign-in 으로 redirect
  * - AT 만료 검사나 refresh 는 하지 않는다 (BFF 가 처리)
  */
@@ -1378,6 +1386,10 @@ export default function proxy(req: NextRequest) {
   const hasToken = !!req.cookies.get('accessToken')?.value;
   const isAuthRoute = AUTH_ROUTES.some((r) => pathname.startsWith(r));
 
+  if (pathname === '/' && HOME_REDIRECT) {
+    return NextResponse.redirect(new URL(HOME_REDIRECT, req.url));
+  }
+
   if (isAuthRoute) return intlRes;
   if (!hasToken) return NextResponse.redirect(new URL('/sign-in', req.url));
 

package/src/create/plugins/authJwt.js

@@ -87,10 +87,18 @@ export default function SignInPage() {
 
 const AUTH_ROUTES = ['/sign-in', '/sign-up'];
 
+/**
+ * 홈(\`/\`) 진입 시 redirect 할 path. 빈 문자열이면 \`app/page.tsx\` 가 그대로 노출.
+ * 예: '/dashboard', '/projects'. 인증 가드 위에서 동작하므로 미인증이면
+ * 그대로 \`/sign-in\` 으로 빠진다.
+ */
+const HOME_REDIRECT = '';
+
 /**
  * Next 16+ 의 proxy.ts (구 middleware.ts).
  * 토큰 존재 여부만 검사한다 — 만료 검사나 refresh 는 하지 않는다.
  *
+ * - \`/\` + HOME_REDIRECT 설정 → 해당 경로로 리다이렉트
  * - AT 쿠키 없음 + 인증 라우트 아님 → /sign-in 으로 리다이렉트
  * - AT 쿠키 있음 또는 인증 라우트 → 통과
  *
@@ -102,6 +110,10 @@ export default function proxy(req: NextRequest) {
   const hasToken = !!req.cookies.get('accessToken')?.value;
   const isAuthRoute = AUTH_ROUTES.some((r) => pathname.startsWith(r));
 
+  if (pathname === '/' && HOME_REDIRECT) {
+    return NextResponse.redirect(new URL(HOME_REDIRECT, req.url));
+  }
+
   if (isAuthRoute) return NextResponse.next();
   if (!hasToken) return NextResponse.redirect(new URL('/sign-in', req.url));
 

package/src/create/plugins/nextIntl.js

@@ -325,11 +325,38 @@ export const { Link, redirect, usePathname, useRouter, getPathname } =
 `,
 
     'proxy.ts': `import createIntlMiddleware from 'next-intl/middleware';
+import { NextRequest, NextResponse } from 'next/server';
+
 import { routing } from '${arch.aliases.config}/i18n/routing';
 
+/**
+ * 홈(\`/\`, \`/{locale}\`) 진입 시 redirect 할 path. 빈 문자열이면
+ * \`app/[locale]/page.tsx\` 가 그대로 노출. 예: '/dashboard', '/projects'.
+ */
+const HOME_REDIRECT = '';
+
 const intl = createIntlMiddleware(routing);
 
-export default intl;
+/**
+ * 로케일 prefix (/ko, /en) 를 벗겨 홈 매칭 (\`/\`) 에 사용한다.
+ * 예: /ko → /, /ko/posts → /posts.
+ */
+const stripLocalePrefix = (pathname: string): string => {
+  const locales = routing.locales as readonly string[];
+  const segments = pathname.split('/').filter(Boolean);
+  if (segments[0] && locales.includes(segments[0])) {
+    const rest = segments.slice(1).join('/');
+    return \`/\${rest}\`.replace(/\\/$/, '') || '/';
+  }
+  return pathname;
+};
+
+export default function proxy(req: NextRequest) {
+  if (HOME_REDIRECT && stripLocalePrefix(req.nextUrl.pathname) === '/') {
+    return NextResponse.redirect(new URL(HOME_REDIRECT, req.url));
+  }
+  return intl(req);
+}
 
 export const config = {
   matcher: '/((?!api|trpc|_next|_vercel|monitoring|.*\\\\..*).*)',

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

@@ -3,9 +3,24 @@
 import { ThemeProvider as NextThemesProvider } from 'next-themes';
 import type { ReactNode } from 'react';
 
+/**
+ * 다크/라이트 테마 — next-themes ThemeProvider 를 wrap.
+ *
+ * - `attribute='class'` — `<html class="dark">` 토글 (Tailwind dark variant 와 호환)
+ * - `defaultTheme='system'` + `enableSystem` — OS 설정에 자동 동기화. light/dark 만
+ *   노출하려면 `enableSystem` 을 false 로
+ * - `disableTransitionOnChange` — 토글 순간 transition 깜빡임 차단
+ *
+ * useTheme 는 next-themes 에서 직접 import: `import { useTheme } from 'next-themes'`
+ */
 export function ThemeProvider({ children }: { children: ReactNode }) {
   return (
-    <NextThemesProvider attribute='class' defaultTheme='system' enableSystem>
+    <NextThemesProvider
+      attribute='class'
+      defaultTheme='system'
+      enableSystem
+      disableTransitionOnChange
+    >
       {children}
     </NextThemesProvider>
   );

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

@@ -3,9 +3,24 @@
 import { ThemeProvider as NextThemesProvider } from 'next-themes';
 import type { ReactNode } from 'react';
 
+/**
+ * 다크/라이트 테마 — next-themes ThemeProvider 를 wrap.
+ *
+ * - `attribute='class'` — `<html class="dark">` 토글 (Tailwind dark variant 와 호환)
+ * - `defaultTheme='system'` + `enableSystem` — OS 설정에 자동 동기화. light/dark 만
+ *   노출하려면 `enableSystem` 을 false 로
+ * - `disableTransitionOnChange` — 토글 순간 transition 깜빡임 차단
+ *
+ * useTheme 는 next-themes 에서 직접 import: `import { useTheme } from 'next-themes'`
+ */
 export function ThemeProvider({ children }: { children: ReactNode }) {
   return (
-    <NextThemesProvider attribute='class' defaultTheme='system' enableSystem>
+    <NextThemesProvider
+      attribute='class'
+      defaultTheme='system'
+      enableSystem
+      disableTransitionOnChange
+    >
       {children}
     </NextThemesProvider>
   );

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

@@ -3,9 +3,24 @@
 import { ThemeProvider as NextThemesProvider } from 'next-themes';
 import type { ReactNode } from 'react';
 
+/**
+ * 다크/라이트 테마 — next-themes ThemeProvider 를 wrap.
+ *
+ * - `attribute='class'` — `<html class="dark">` 토글 (Tailwind dark variant 와 호환)
+ * - `defaultTheme='system'` + `enableSystem` — OS 설정에 자동 동기화. light/dark 만
+ *   노출하려면 `enableSystem` 을 false 로
+ * - `disableTransitionOnChange` — 토글 순간 transition 깜빡임 차단
+ *
+ * useTheme 는 next-themes 에서 직접 import: `import { useTheme } from 'next-themes'`
+ */
 export function ThemeProvider({ children }: { children: ReactNode }) {
   return (
-    <NextThemesProvider attribute='class' defaultTheme='system' enableSystem>
+    <NextThemesProvider
+      attribute='class'
+      defaultTheme='system'
+      enableSystem
+      disableTransitionOnChange
+    >
       {children}
     </NextThemesProvider>
   );

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

@@ -3,9 +3,24 @@
 import { ThemeProvider as NextThemesProvider } from 'next-themes';
 import type { ReactNode } from 'react';
 
+/**
+ * 다크/라이트 테마 — next-themes ThemeProvider 를 wrap.
+ *
+ * - `attribute='class'` — `<html class="dark">` 토글 (Tailwind dark variant 와 호환)
+ * - `defaultTheme='system'` + `enableSystem` — OS 설정에 자동 동기화. light/dark 만
+ *   노출하려면 `enableSystem` 을 false 로
+ * - `disableTransitionOnChange` — 토글 순간 transition 깜빡임 차단
+ *
+ * useTheme 는 next-themes 에서 직접 import: `import { useTheme } from 'next-themes'`
+ */
 export function ThemeProvider({ children }: { children: ReactNode }) {
   return (
-    <NextThemesProvider attribute='class' defaultTheme='system' enableSystem>
+    <NextThemesProvider
+      attribute='class'
+      defaultTheme='system'
+      enableSystem
+      disableTransitionOnChange
+    >
       {children}
     </NextThemesProvider>
   );