sh-ui-cli 0.59.9 → 0.61.1

package/templates/nextjs-standalone/_arch/fsd/src/shared/hooks/useAppMutation.ts

@@ -5,7 +5,8 @@ import {
 } from '@tanstack/react-query';
 import { toast } from 'sonner';
 
-import { ApiError } from '../api/error';
+import { ApiError } from '@/src/shared/api/error';
+import { resolveErrorMessage } from '@/src/shared/api/errorMessages';
 
 type AppMutationOptions<
   TData = unknown,
@@ -13,13 +14,19 @@ type AppMutationOptions<
   TVariables = void,
   TContext = unknown,
 > = UseMutationOptions<TData, TError, TVariables, TContext> & {
+  /** ApiError 가 아니거나 mapping 에 없을 때의 fallback 메시지. */
   errorMessage?: string;
+  /** false 면 toast 띄우지 않음. */
   showErrorToast?: boolean;
 };
 
 /**
- * useMutation 래퍼 — 에러 발생 시 ApiError.message 를 toast 로 띄운다.
- * showErrorToast: false 로 끌 수 있고, errorMessage 로 fallback 메시지 지정.
+ * useMutation 래퍼 — 에러 발생 시 `resolveErrorMessage` 를 통해 안전한
+ * 사용자 facing 메시지를 toast 로 띄운다. backend 가 보낸 raw 메시지를 그대로
+ * 띄우지 않고 `errorMessages.ts` 의 mapping 을 우선 사용해 일관된 사용자
+ * 경험과 i18n 친화성을 확보.
+ *
+ * showErrorToast: false 로 자동 toast 끌 수 있고, errorMessage 로 fallback 지정.
  */
 export const useAppMutation = <
   TData = unknown,
@@ -39,10 +46,7 @@ export const useAppMutation = <
       if (!showErrorToast) return;
 
       const [error] = args;
-      const message =
-        error instanceof ApiError
-          ? (error.data?.message ?? errorMessage)
-          : errorMessage;
+      const message = resolveErrorMessage(error, errorMessage);
 
       if (message) {
         toast.error(message);
@@ -50,3 +54,6 @@ export const useAppMutation = <
     },
   });
 };
+
+// re-export ApiError 타입을 쓰는 사용처 편의용 (선택).
+export type { ApiError };

package/templates/nextjs-standalone/_arch/fsd/src/shared/lib/formatDate.ts

@@ -1,5 +1,9 @@
 /**
  * Date → 로케일 기반 날짜 포맷 (시간 없음).
+ *
+ * 비-i18n 프로젝트면 default 'ko-KR' 사용. next-intl 활성 시엔 이 util 을 직접
+ * 부르지 말고 같은 모듈의 hook (`useFormatDate`) 을 사용하세요 — 현재 locale 을
+ * 자동으로 따릅니다 (next-intl 플러그인이 emit).
  */
 export const formatDate = (date: Date, locale = 'ko-KR'): string =>
   new Intl.DateTimeFormat(locale, {

package/templates/nextjs-standalone/_arch/fsd/src/shared/lib/formatPrice.ts

@@ -1,10 +1,18 @@
 /**
- * 숫자 → 한국 원화(KRW) 포맷. 소수점 없음.
- * 예: 12000 → "₩12,000"
+ * 숫자 → 통화 포맷. default ko-KR + KRW 이지만 두 인자 모두 override 가능.
+ * 예: formatPrice(12000)            → "₩12,000"
+ *     formatPrice(99.5, 'en-US', 'USD') → "$99.50"
+ *
+ * next-intl 활성 시엔 같은 모듈의 hook (`useFormatPrice`) 을 사용하면 현재
+ * locale 을 자동으로 따릅니다 (next-intl 플러그인이 emit).
  */
-export const formatPrice = (amount: number, locale = 'ko-KR'): string =>
+export const formatPrice = (
+  amount: number,
+  locale = 'ko-KR',
+  currency = 'KRW',
+): string =>
   new Intl.NumberFormat(locale, {
     style: 'currency',
-    currency: 'KRW',
-    maximumFractionDigits: 0,
+    currency,
+    maximumFractionDigits: currency === 'KRW' ? 0 : 2,
   }).format(amount);

package/templates/nextjs-standalone/_arch/fsd/src/shared/lib/getQueryClient.ts

@@ -9,6 +9,6 @@ import {
  * RSC 와 클라이언트 양쪽에서 안전하게 호출 가능한 QueryClient 핸들.
  * 서버에서는 React `cache()` 로 요청 단위 싱글턴, 브라우저에서는 모듈 싱글턴.
  */
-export default function getQueryClient() {
+export function getQueryClient() {
   return isServer ? getServerQueryClient() : getBrowserQueryClient();
 }

package/templates/nextjs-standalone/_arch/fsd/src/shared/test/renderWithProviders.tsx

@@ -1,4 +1,4 @@
-import type { ReactElement, ReactNode } from 'react';
+import type { ComponentType, ReactElement, ReactNode } from 'react';
 
 import {
   render,
@@ -7,11 +7,17 @@ import {
 } from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { ThemeProvider } from 'next-themes';
 
 import { createTestQueryClient } from './createTestQueryClient';
 
 type Options = Omit<RenderOptions, 'wrapper'> & {
   queryClient?: QueryClient;
+  /**
+   * 외부 Provider 가 필요할 때 (예: next-intl 활성 프로젝트에서
+   * `NextIntlClientProvider`) 사용. ThemeProvider 안쪽 / QueryClientProvider 바깥에 wrap.
+   */
+  extraWrapper?: ComponentType<{ children: ReactNode }>;
 };
 
 type Result = RenderResult & {
@@ -20,18 +26,37 @@ type Result = RenderResult & {
 };
 
 /**
- * RTL render + QueryClientProvider + userEvent setup 한 번에.
- * 추가 Provider 가 필요하면 이 파일을 직접 수정하거나 wrapper 옵션을 쓴다.
+ * RTL render + ThemeProvider + QueryClientProvider + userEvent setup 한 번에.
+ *
+ * next-intl 프로젝트에서 `useTranslations` 사용 컴포넌트 테스트 시:
+ *
+ *   const Intl = ({ children }) => (
+ *     <NextIntlClientProvider locale='ko' messages={ko}>
+ *       {children}
+ *     </NextIntlClientProvider>
+ *   );
+ *   renderWithProviders(<MyComponent />, { extraWrapper: Intl });
  */
 export const renderWithProviders = (
   ui: ReactElement,
   options: Options = {},
 ): Result => {
-  const { queryClient = createTestQueryClient(), ...rtlOptions } = options;
+  const {
+    queryClient = createTestQueryClient(),
+    extraWrapper: Extra,
+    ...rtlOptions
+  } = options;
 
-  const Wrapper = ({ children }: { children: ReactNode }) => (
-    <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
-  );
+  const Wrapper = ({ children }: { children: ReactNode }) => {
+    const inner = (
+      <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+    );
+    return (
+      <ThemeProvider attribute='class' defaultTheme='light' enableSystem={false}>
+        {Extra ? <Extra>{inner}</Extra> : inner}
+      </ThemeProvider>
+    );
+  };
 
   const result = render(ui, { wrapper: Wrapper, ...rtlOptions });
   const user = userEvent.setup();

package/templates/nextjs-standalone/_arch/fsd/src/shared/ui/PrefetchBoundary/index.tsx

@@ -6,7 +6,7 @@ import {
   HydrationBoundary,
 } from '@tanstack/react-query';
 
-import getQueryClient from '@/src/shared/lib/getQueryClient';
+import { getQueryClient } from '@/src/shared/lib/getQueryClient';
 
 export type FetchOptions = Pick<FetchQueryOptions, 'queryKey' | 'queryFn'>;
 

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

@@ -3,13 +3,11 @@ import pluginNext from "@next/eslint-plugin-next"
 import eslintConfigPrettier from "eslint-config-prettier"
 import boundaries from "eslint-plugin-boundaries"
 import checkFile from "eslint-plugin-check-file"
-import importX from "eslint-plugin-import-x"
 import onlyWarn from "eslint-plugin-only-warn"
 import pluginReact from "eslint-plugin-react"
 import pluginReactHooks from "eslint-plugin-react-hooks"
 import globals from "globals"
 import tseslint from "typescript-eslint"
-import { createTypeScriptImportResolver } from "eslint-import-resolver-typescript"
 
 export default [
   {
@@ -146,17 +144,4 @@ export default [
     },
   },
 
-  // ── import-x ──
-  {
-    plugins: { "import-x": importX },
-    settings: {
-      "import-x/resolver-next": [
-        createTypeScriptImportResolver({ alwaysTryTypes: true }),
-      ],
-    },
-    rules: {
-      "import-x/order": "off",
-      "import-x/no-unresolved": "off",
-    },
-  },
 ]

package/templates/nextjs-standalone/package.json

@@ -45,10 +45,8 @@
     "babel-plugin-react-compiler": "^1.0.0",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-boundaries": "^5.4.0",
     "eslint-plugin-check-file": "^3.3.1",
-    "eslint-plugin-import-x": "^4.16.1",
     "eslint-plugin-only-warn": "^1.1.0",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.0.1",

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

@@ -9,13 +9,13 @@
   "dependencies": {
     "@base-ui/react": "^1.4.1",
     "@workspace/ui-core": "workspace:*",
-    "lucide-react": "^0.575.0",
+    "lucide-react": "^0.563.0",
     "next-themes": "^0.4.6",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "react-hook-form": "^7.56.4",
     "sonner": "^2.0.7",
-    "zod": "^3.25.76"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.18",

package/templates/ui-app-template/postcss.config.mjs

@@ -1,5 +1,5 @@
 const config = {
-    plugins: { "@tailwindcss/postcss": {} },
+  plugins: { '@tailwindcss/postcss': {} },
 };
 
 export default config;

package/templates/monorepo/.eslintrc.js

@@ -1,8 +0,0 @@
-module.exports = {
-  ignorePatterns: ["apps/**", "packages/**"],
-  extends: ["@workspace/eslint-config/library.js"],
-  parser: "@typescript-eslint/parser",
-  parserOptions: {
-    project: true,
-  },
-}

package/templates/nextjs-app/Dockerfile

@@ -1,11 +0,0 @@
-FROM node:22-alpine
-
-COPY . /app
-
-WORKDIR /app/apps/app-name
-
-EXPOSE 3000
-ENV PORT=3000
-ENV HOSTNAME="0.0.0.0"
-
-CMD ["node", "server.js"]

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

@@ -1,12 +0,0 @@
-'use client';
-
-import { ThemeProvider } from 'next-themes';
-import type { ReactNode } from 'react';
-
-export function ThemeProviders({ children }: { children: ReactNode }) {
-  return (
-    <ThemeProvider attribute='class' defaultTheme='system' enableSystem>
-      {children}
-    </ThemeProvider>
-  );
-}

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

@@ -1,12 +0,0 @@
-'use client';
-
-import { ThemeProvider } from 'next-themes';
-import type { ReactNode } from 'react';
-
-export function ThemeProviders({ children }: { children: ReactNode }) {
-  return (
-    <ThemeProvider attribute='class' defaultTheme='system' enableSystem>
-      {children}
-    </ThemeProvider>
-  );
-}

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

@@ -1,12 +0,0 @@
-'use client';
-
-import { ThemeProvider } from 'next-themes';
-import type { ReactNode } from 'react';
-
-export function ThemeProviders({ children }: { children: ReactNode }) {
-  return (
-    <ThemeProvider attribute='class' defaultTheme='system' enableSystem>
-      {children}
-    </ThemeProvider>
-  );
-}

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

@@ -1,12 +0,0 @@
-'use client';
-
-import { ThemeProvider } from 'next-themes';
-import type { ReactNode } from 'react';
-
-export function ThemeProviders({ children }: { children: ReactNode }) {
-  return (
-    <ThemeProvider attribute='class' defaultTheme='system' enableSystem>
-      {children}
-    </ThemeProvider>
-  );
-}