@uniai-fe/uds-templates 0.10.3 → 0.11.0

package/src/cctv/styles/viewer.scss

@@ -1,7 +1,78 @@
+.cctv-viewer-desktop-container {
+  display: grid;
+  gap: var(--spacing-gap-6);
+  width: min(100%, 1216px);
+  margin: 0 auto;
+}
+
+.cctv-viewer-desktop-headline {
+  min-height: 34px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--spacing-gap-6);
+
+  h3 {
+    min-width: 0;
+    margin: 0;
+    overflow: hidden;
+    color: var(--color-label-strong);
+    font-size: var(--font-heading-medium-size);
+    line-height: 1.4;
+    font-weight: 700;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+}
+
+.cctv-viewer-desktop-time {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--spacing-gap-3);
+  color: var(--color-label-neutral);
+  font-size: var(--font-label-small-size);
+  line-height: var(--font-label-small-line-height);
+  font-weight: var(--font-label-small-weight);
+  white-space: nowrap;
+}
+
 .cctv-viewer-desktop-video-container {
-  max-height: 500px;
+  --cctv-video-radius: var(--cctv-viewer-video-radius);
+  --cctv-overlay-padding-x: var(--cctv-viewer-overlay-padding-x);
+  --cctv-overlay-padding-y: var(--cctv-viewer-overlay-padding-y);
+
+  max-height: var(--cctv-viewer-video-max-height);
+  min-height: 0;
+  aspect-ratio: 608 / 309;
+}
+
+.cctv-viewer-desktop-overlay-body {
+  flex-direction: row;
+  justify-content: space-between;
+}
+
+.cctv-viewer-desktop-move-button.cctv-pagination-move-button {
+  width: 42px;
+  height: 42px;
+  background: var(--cctv-pagination-move-button-active);
+}
+
+.cctv-viewer-desktop-video-container .cctv-video-overlay-footer {
+  justify-content: flex-end;
+}
+
+.cctv-visually-hidden {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
 }
 
 .cctv-viewer-desktop-pagination-container {
-  margin-top: var(--spacing-gap-8);
+  margin-top: var(--spacing-gap-2);
 }

package/src/cctv/types/props.ts

@@ -112,6 +112,10 @@ export interface CctvVideoOverlayHeaderProps {
  */
 export interface CctvVideoOverlayFooterProps {
   className?: string;
+  /**
+   * 제목/버튼과 함께 배치할 추가 콘텐츠
+   */
+  children?: React.ReactNode;
   /**
    * 하단 타이틀 노출 여부
    */
@@ -130,6 +134,48 @@ export interface CctvVideoOverlayFooterProps {
   isLive?: boolean;
 }
 
+/**
+ * CCTV; sensor metric 표시 상태
+ */
+export type CctvVideoMetricState = "normal" | "attention" | "unavailable";
+
+/**
+ * CCTV; sensor metric props
+ * @property {React.ReactNode} children 표시할 센서 값
+ * @property {CctvVideoMetricState} [state] state dot 표시 상태
+ */
+export interface CctvVideoMetricProps {
+  /**
+   * 표시할 센서 값
+   */
+  children: React.ReactNode;
+  /**
+   * state dot 표시 상태
+   */
+  state?: CctvVideoMetricState;
+}
+
+/**
+ * CCTV; Video Card props
+ * @property {React.ReactNode} children video/media 영역
+ * @property {React.ReactNode} [settings] media 하단 서비스 설정 영역
+ * @property {string} [className] 카드 루트 클래스
+ */
+export interface CctvVideoCardProps {
+  /**
+   * video/media 영역
+   */
+  children: React.ReactNode;
+  /**
+   * media 하단 서비스 설정 영역
+   */
+  settings?: React.ReactNode;
+  /**
+   * 카드 루트 클래스
+   */
+  className?: string;
+}
+
 /**
  * CCTV; 비디오 상태 관련 props
  * @property {boolean} [isError] 에러 상태 여부
@@ -169,6 +215,7 @@ export interface CctvVideoStateProps {
 /**
  * CCTV; Video Template props
  * @property {string} [className] 루트 컨테이너에 적용할 클래스
+ * @property {"card" | "carousel" | "viewer"} [layout] 공용 video layout preset
  * @property {CctvVideoOverlayHeaderProps} [headerOptions] 헤더 구성 옵션
  * @property {CctvVideoOverlayFooterProps} [footerOptions] 푸터 구성 옵션
  * @property {boolean} [isError] 에러 상태 여부
@@ -183,6 +230,10 @@ export interface CctvVideoTemplateProps extends CctvVideoStateProps {
    */
   cam?: CctvCompanyCameraData;
   className?: string;
+  /**
+   * 공용 video layout preset
+   */
+  layout?: "card" | "carousel" | "viewer";
   /**
    * <CCtvVideoOverlayHeader /> 속성
    */
@@ -262,6 +313,18 @@ export interface CctvViewerDesktopVideoProps {
    * custom overlay 렌더 함수
    */
   renderOverlay?: CctvVideoRenderOverlay;
+  /**
+   * viewer 하단 sensor metric 영역
+   */
+  metrics?: React.ReactNode;
+  /**
+   * 이전 카메라 이동 핸들러
+   */
+  onPrev?: () => void;
+  /**
+   * 다음 카메라 이동 핸들러
+   */
+  onNext?: () => void;
 }
 
 /**
@@ -271,6 +334,10 @@ export interface CctvViewerDesktopVideoProps {
  * @property {CctvCompanyCameraData} [selectedCam] 외부에서 직접 주입하는 선택 카메라 데이터
  * @property {CctvCompanyCameraData[]} [camList] 외부에서 직접 주입하는 카메라 리스트
  * @property {CctvVideoRenderOverlay} [renderOverlay] viewer video용 custom overlay 렌더 함수
+ * @property {React.ReactNode} [time] viewer headline 확인 시각
+ * @property {React.ReactNode} [metrics] viewer 하단 sensor metric 영역
+ * @property {() => void} [onPrev] 이전 카메라 이동 핸들러
+ * @property {() => void} [onNext] 다음 카메라 이동 핸들러
  */
 export interface CctvViewerDesktopContainerProps {
   /**
@@ -293,4 +360,20 @@ export interface CctvViewerDesktopContainerProps {
    * viewer video용 custom overlay 렌더 함수
    */
   renderOverlay?: CctvVideoRenderOverlay;
+  /**
+   * viewer headline 확인 시각
+   */
+  time?: React.ReactNode;
+  /**
+   * viewer 하단 sensor metric 영역
+   */
+  metrics?: React.ReactNode;
+  /**
+   * 이전 카메라 이동 핸들러
+   */
+  onPrev?: () => void;
+  /**
+   * 다음 카메라 이동 핸들러
+   */
+  onNext?: () => void;
 }