sh-ui-cli 0.78.0 → 0.79.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.79.0",
+      "date": "2026-05-12",
+      "title": "no-restricted toLocaleDateString — SSR hydration mismatch 회귀 가드",
+      "type": "minor",
+      "highlights": [
+        "**ESLint `no-restricted-syntax` 룰 추가** — 인자 0개의 `.toLocaleDateString()` / `.toLocaleString()` / `.toLocaleTimeString()` 호출을 error 로 차단. Node 기본 로케일(en-US) 과 브라우저 로케일(ko-KR) 이 달라 SSR 출력이 hydrate 시 mismatch 나던 함정의 회귀 가드.",
+        "**대체 경로 안내가 에러 메시지에 박힘** — `@/src/shared/lib/formatDate` 의 `formatDate` / `formatDateTime` (default `ko-KR`), next-intl locale 추종이면 `useFormatDate` 훅, 숫자는 `formatPrice`. AST selector 가 `arguments.length === 0` 만 매칭하므로 의도된 locale 명시 호출 (`toLocaleDateString('ko-KR', { ... })`) 은 통과.",
+        "**적용 범위** — monorepo `@workspace/eslint-config/base` (next.js · react-internal 등 모든 워크스페이스 config 가 상속) + `nextjs-standalone` 의 fsd / flat / mes arch 오버레이 3종.",
+        "**템플릿 CLAUDE.md 추가** — `nextjs-standalone` / `monorepo` 시작 템플릿에 `CLAUDE.md` 신규. 날짜·숫자 포맷 컨벤션 + sh-ui 컴포넌트 우선 + 토큰 사용 원칙 명시. AI 에이전트가 코드 작성 시점에 컨텍스트로 읽고 미리 피할 수 있게."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.79.0"
+    },
     {
       "version": "0.78.0",
       "date": "2026-05-12",

package/package.json

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

package/templates/monorepo/CLAUDE.md

@@ -0,0 +1,40 @@
+# 프로젝트 작업 규칙
+
+sh-ui CLI 가 스캐폴드한 monorepo (Turborepo + pnpm workspace). AI 에이전트
+(Claude / Cursor / Codex 등) 가 이 파일을 컨텍스트로 읽고 아래 규칙을 따른다.
+
+## 구조
+
+- `apps/<name>/` — Next.js 앱. 라우트 + 비즈니스 로직.
+- `packages/ui/ui-core/` — 모든 앱이 공유하는 sh-ui 컴포넌트 / 훅 / 유틸 SoT.
+  컴포넌트 추가는 여기에 한 번만.
+- `packages/ui/ui-apps/ui-<name>/` — 앱별 토큰 (color/spacing/font) 만 보관.
+  컴포넌트는 두지 않음 (v0.65+ `tokens-only` 마커).
+- `packages/eslint-config/` · `packages/typescript-config/` — 공용 설정.
+
+## 날짜 / 숫자 포맷
+
+- raw `Date.prototype.toLocaleDateString()` / `toLocaleString()` / `toLocaleTimeString()`
+  호출 **금지** — SSR(Node) 와 브라우저의 기본 로케일이 달라 hydration mismatch 의
+  원인. ESLint `no-restricted-syntax` 룰이 인자 0개의 호출을 막는다
+  (`@workspace/eslint-config/base` 에 정의).
+- 대신 `@/src/shared/lib/formatDate` 의 `formatDate(date)` / `formatDateTime(date)`
+  사용 (default locale `ko-KR`, 서버·클라이언트 동일 출력 보장).
+- next-intl locale 추종이 필요하면 `@/src/shared/hooks/useFormatDate` 훅 사용.
+- 동일 원칙이 숫자에도 적용 — raw `Number.prototype.toLocaleString()` 금지,
+  `formatPrice` 사용.
+- 인자가 명시된 호출 (`toLocaleDateString('ko-KR', { ... })`) 은 의도된 사용이므로
+  허용. 다만 SSR 출력 결정성을 위해서는 util 경유가 안전.
+
+## 새 앱 추가
+
+`sh_ui_add_app` MCP 툴 또는 `npx sh-ui-cli add app <name>` — `apps/<name>/` +
+`packages/ui/ui-apps/ui-<name>/` 를 한 번에 만든다. 앱별로 다른 톤 가능 (예:
+marketing = rose, admin = emerald). 컴포넌트는 `ui-core` 단일 SoT 라 두 앱이
+자동 공유.
+
+## 토큰 사용
+
+- 색상 / 간격 / 폰트 크기는 항상 토큰 변수 경유 (`var(--space-3)`, `bg-fg`,
+  `text-fg-muted` 등). 매직 px / hex 직접 하드코딩 금지.
+- 토큰 정의부는 `packages/ui/ui-apps/ui-<name>/src/styles/tokens.css`.

package/templates/monorepo/packages/eslint-config/base.js

@@ -18,6 +18,15 @@ export const config = [
         "warn",
         { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
       ],
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector:
+            "CallExpression[arguments.length=0][callee.type='MemberExpression'][callee.property.name=/^toLocale(Date|Time)?String$/]",
+          message:
+            "Argument-less .toLocaleDateString() / .toLocaleString() / .toLocaleTimeString() causes SSR hydration mismatch (Node default locale ≠ browser locale). Use `formatDate` from `@/src/shared/lib/formatDate`, or the `useFormatDate` hook for i18n-aware locale (numbers: `formatPrice`).",
+        },
+      ],
     },
   },
   {

package/templates/nextjs-standalone/CLAUDE.md

@@ -0,0 +1,30 @@
+# 프로젝트 작업 규칙
+
+sh-ui CLI 가 스캐폴드한 Next.js standalone 프로젝트. AI 에이전트 (Claude / Cursor /
+Codex 등) 가 이 파일을 컨텍스트로 읽고 아래 규칙을 따른다.
+
+## 날짜 / 숫자 포맷
+
+- raw `Date.prototype.toLocaleDateString()` / `toLocaleString()` / `toLocaleTimeString()`
+  호출 **금지** — SSR(Node) 와 브라우저의 기본 로케일이 달라 hydration mismatch 의
+  원인. ESLint `no-restricted-syntax` 룰이 인자 0개의 호출을 막는다.
+- 대신 `@/src/shared/lib/formatDate` 의 `formatDate(date)` / `formatDateTime(date)`
+  사용 (default locale `ko-KR`, 서버·클라이언트 동일 출력 보장).
+- next-intl locale 추종이 필요하면 `@/src/shared/hooks/useFormatDate` 훅 사용.
+- 동일 원칙이 숫자에도 적용 — raw `Number.prototype.toLocaleString()` 금지,
+  `@/src/shared/lib/formatPrice` 의 `formatPrice` 사용.
+- 인자가 명시된 호출 (`toLocaleDateString('ko-KR', { ... })`) 은 의도된 사용이므로
+  허용. 다만 SSR 출력 결정성을 위해서는 util 경유가 안전.
+
+## sh-ui 컴포넌트 우선
+
+- shadcn/ui 류 외부 라이브러리 대신 이 프로젝트의 `components/ui/*` (sh-ui 레지스트리)
+  사용. Base UI (`@base-ui-components/react`) 위에 빌드되어 있음.
+- 새 컴포넌트가 필요하면 `npx sh-ui-cli add <name>` 또는 sh-ui MCP 의
+  `sh_ui_add_component` 사용.
+
+## 토큰 사용
+
+- 색상 / 간격 / 폰트 크기는 항상 토큰 변수 경유 (`var(--space-3)`, `bg-fg`,
+  `text-fg-muted` 등). 매직 px / hex 직접 하드코딩 금지.
+- 토큰 정의부는 `app/globals.css` 또는 `src/shared/styles/tokens.css`.

package/templates/nextjs-standalone/_arch/flat/eslint.config.js

@@ -27,6 +27,15 @@ export default [
         "warn",
         { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
       ],
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector:
+            "CallExpression[arguments.length=0][callee.type='MemberExpression'][callee.property.name=/^toLocale(Date|Time)?String$/]",
+          message:
+            "Argument-less .toLocaleDateString() / .toLocaleString() / .toLocaleTimeString() causes SSR hydration mismatch (Node default locale ≠ browser locale). Use `formatDate` from `lib/utils/formatDate`, or the `useFormatDate` hook for i18n-aware locale (numbers: `formatPrice`).",
+        },
+      ],
     },
   },
 

package/templates/nextjs-standalone/_arch/mes/eslint.config.js

@@ -27,6 +27,15 @@ export default [
         "warn",
         { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
       ],
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector:
+            "CallExpression[arguments.length=0][callee.type='MemberExpression'][callee.property.name=/^toLocale(Date|Time)?String$/]",
+          message:
+            "Argument-less .toLocaleDateString() / .toLocaleString() / .toLocaleTimeString() causes SSR hydration mismatch (Node default locale ≠ browser locale). Use `formatDate` from `src/lib/utils/formatDate`, or the `useFormatDate` hook for i18n-aware locale (numbers: `formatPrice`).",
+        },
+      ],
     },
   },
 

package/templates/nextjs-standalone/eslint.config.js

@@ -27,6 +27,15 @@ export default [
         "warn",
         { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
       ],
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector:
+            "CallExpression[arguments.length=0][callee.type='MemberExpression'][callee.property.name=/^toLocale(Date|Time)?String$/]",
+          message:
+            "Argument-less .toLocaleDateString() / .toLocaleString() / .toLocaleTimeString() causes SSR hydration mismatch (Node default locale ≠ browser locale). Use `formatDate` from `@/src/shared/lib/formatDate`, or the `useFormatDate` hook for i18n-aware locale (numbers: `formatPrice`).",
+        },
+      ],
     },
   },