@uniai-fe/uds-templates 0.3.15 → 0.4.1

package/README.md

@@ -29,6 +29,59 @@ Next.js 서비스에서 primitives와 동일한 방식으로 **Raw TypeScript**
   - **templates**는 레이아웃/플로우/상태 표현까지 담당하고,
   - API 호출, 인증 토큰 관리, 라우팅, i18n 등 비즈니스 로직은 서비스 앱에서 구현합니다.
 
+## 확인 완료 도구 목록
+
+- `/modal`
+  - `Modal.Provider`
+  - `Modal.StackProvider`
+  - `Modal.RouteReset`
+  - `Modal.useModal`
+  - `Modal.Alert`
+  - `Modal.Dialog`
+  - `createAlertModal`
+  - `createDialogModal`
+  - `modalStackAtom`
+  - `ModalState`
+  - `ModalStatePatch`
+  - `ModalProps`
+  - `ModalFooterButton`
+  - `AlertTemplateOptions`
+  - `DialogTemplateOptions`
+  - `UseModalReturn`
+- `/weather`
+  - `WeatherComponents.PageHeader`
+  - `WeatherPageHeaderContainer`
+  - `WeatherMockProvider`
+  - `weatherCoordinate`
+  - `useWeatherKorea`
+  - `useOpenWeatherMap`
+- `/cctv`
+  - `CCTV.Provider`
+  - `CCTV.CamList.Container`
+  - `CCTV.Video.Container`
+  - `CCTV.Video.Contents`
+  - `CCTV.Video.Overlay.Container`
+  - `CCTV.Pagination.Container`
+  - `CCTV.Pagination.List.Container`
+  - `CCTV.Pagination.Button.Prev`
+  - `CCTV.Pagination.Button.Next`
+  - `CCTV.Viewer.Desktop.Container`
+  - `useCctvCompanyData`
+  - `useCctvContext`
+  - `useCctvRtcStream`
+  - `getServerCompanyList`
+  - `getServerCctvToken`
+  - `postCctvRtcToken`
+- `/page-frame`
+  - `Frame`
+  - `Frame.Mobile`
+  - `MobileFrame`
+  - `Frame.Desktop`
+  - `DesktopFrame`
+  - `MobileFrameProps`
+  - `PageFrameDesktopNavProps`
+  - `SitemapDataType`
+
 ## 현재 제공 템플릿/모듈
 
 - `/auth/**`
@@ -42,6 +95,12 @@ Next.js 서비스에서 primitives와 동일한 방식으로 **Raw TypeScript**
 - `/modal/**`
   - ui-legacy 스택 기반 모달 Provider/Root/Container + 템플릿(`Modal.Alert`, `Modal.Dialog`)
   - Storybook(`apps/design-storybook/src/stories/templates/modal`)에서 Alert/Confirm 케이스를 검증한다.
+- `/weather/**`
+  - page-frame header utility에 결합되는 weather header 템플릿과 weather data hook/mock 도구를 제공한다.
+- `/cctv/**`
+  - finder/viewer/video/pagination 조합과 rtc/company-list API helper를 제공한다.
+- `/page-frame/**`
+  - mobile/desktop private route frame, nav/header/popup 조합을 제공한다.
 
 각 템플릿의 상세한 범위와 의사결정은 `CONTEXT-*.md` 문서에서 관리합니다.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniai-fe/uds-templates",
-  "version": "0.3.15",
+  "version": "0.4.1",
   "description": "UNIAI Design System; UI Templates Package",
   "type": "module",
   "private": false,
@@ -12,7 +12,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "packageManager": "pnpm@10.32.0",
+  "packageManager": "pnpm@10.32.1",
   "engines": {
     "node": ">=24",
     "pnpm": ">=10"
@@ -66,11 +66,11 @@
   },
   "dependencies": {
     "clsx": "^2.1.1",
-    "dayjs": "^1.11.19"
+    "dayjs": "^1.11.20"
   },
   "devDependencies": {
     "@svgr/webpack": "^8.1.0",
-    "@tanstack/react-query": "^5.90.21",
+    "@tanstack/react-query": "^5.91.2",
     "@types/node": "^24.10.2",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
@@ -90,7 +90,7 @@
     "next": "^15.5.11",
     "prettier": "^3.8.1",
     "react-hook-form": "^7.71.2",
-    "sass": "^1.97.3",
+    "sass": "^1.98.0",
     "typescript": "~5.9.3"
   }
 }

package/src/auth/common/find/markup/InfoStep.tsx

@@ -91,7 +91,8 @@ export function AuthFindAccountInfoStep({
         <div className="auth-find-account-fields">
           <AuthFindAccountFieldBase
             className={clsx("auth-find-field-name", nameField.className)}
-            label="이름"
+            // 첫 번째 필드 라벨도 서비스 앱이 주입한 값을 우선 따르도록 preset 하드코딩을 제거한다.
+            label={nameField.label ?? "이름"}
             templateProps={nameField.templateProps}
             inputProps={{
               name: nameFieldName,

package/src/auth/login/markup/FormField.tsx

@@ -81,7 +81,10 @@ export default function AuthLoginFormField({
           register={register.id}
           helper={idHelper}
           label={idField?.label ?? "아이디"}
-          placeholder={idField?.placeholder ?? "아이디를 입력해 주세요"}
+          placeholder={
+            idField?.placeholder ??
+            `${idField?.label ?? "아이디"}를 입력해 주세요`
+          }
           inputProps={idField?.inputProps}
           templateProps={idField?.templateProps}
         />

package/src/cctv/components/index.tsx

@@ -4,6 +4,9 @@ import CCTVProvider from "./Provider";
 import { CCTVVideo } from "./video";
 import { CCTVViewer } from "./viewer";
 
+/**
+ * CCTV Components; CCTV component namespace 집계
+ */
 export const CCTV = {
   Provider: CCTVProvider,
   Video: CCTVVideo,

package/src/cctv/index.tsx

@@ -1,5 +1,8 @@
 import "./index.scss";
 
+/**
+ * CCTV; viewer, cam-list, pagination, api/hook/jotai 도구를 함께 제공하는 엔트리
+ */
 export * from "./apis";
 export * from "./data";
 export * from "./components";

package/src/modal/index.tsx

@@ -11,6 +11,9 @@ import {
   createDialogModal,
 } from "./components";
 
+/**
+ * Modal; namespace와 direct export를 함께 제공하는 modal 엔트리
+ */
 export const Modal = ModalNamespace;
 
 export {

package/src/page-frame/desktop/components/index.tsx

@@ -3,6 +3,9 @@ import Nav from "./nav";
 import Header from "./header";
 import Popup from "./popup";
 
+/**
+ * Page Frame Desktop Components; desktop frame namespace 집계
+ */
 const Frame = {
   Page: {
     ...Page,

package/src/page-frame/desktop/index.tsx

@@ -2,6 +2,9 @@ import "./index.scss";
 
 import Frame from "./components";
 
+/**
+ * Page Frame Desktop; desktop frame 엔트리
+ */
 export type * from "./types";
 export * from "./data/setting";
 

package/src/page-frame/index.tsx

@@ -1,6 +1,9 @@
 import { DesktopFrame } from "./desktop";
 import { MobileFrame } from "./mobile";
 
+/**
+ * Frame; desktop/mobile page-frame namespace 집계
+ */
 export * from "./mobile";
 export * from "./types";
 export * from "./desktop";

package/src/page-frame/mobile/components/index.tsx

@@ -2,6 +2,9 @@ import Page from "./page";
 import Header from "./header";
 import Navigation from "./navigation";
 
+/**
+ * Page Frame Mobile Components; mobile frame namespace 집계
+ */
 const Frame = {
   Page,
   Header,

package/src/page-frame/mobile/index.tsx

@@ -2,6 +2,9 @@ import "./index.scss";
 
 import { MobileFrame } from "./components/page/Frame";
 
+/**
+ * Page Frame Mobile; mobile frame 엔트리
+ */
 export type { MobileFrameProps } from "./types";
 export * from "./components";
 export { MobileFrame };

package/src/weather/components/index.tsx

@@ -1,5 +1,8 @@
 import WeatherPageHeaderContainer from "./page-header/Container";
 
+/**
+ * Weather Components; weather component namespace 집계
+ */
 const Weather = {
   PageHeader: WeatherPageHeaderContainer,
 };

package/src/weather/index.tsx

@@ -1,6 +1,9 @@
 // Weather UI 컴포넌트 전용 스타일을 로드한다.
 import "./styles/weather.scss";
 
+/**
+ * Weather; page-header 템플릿과 api/hook/jotai/mock 도구를 함께 제공하는 엔트리
+ */
 export * from "./utils";
 export * from "./apis";
 export * from "./jotai";