@uniai-fe/ui-legacy 0.1.1

package/src/types/style-option.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 개수가 지정된 배열 정의
+ * @example
+ * type DataArray = FixedLengthArray<number | string, 3>;
+ */
+export type FixedLengthArray<ItemType, Length extends number> = [
+  ItemType,
+  ...ItemType[],
+] & { length: Length };
+
+/**
+ * 스타일 옵션 타입; margin, padding을 배열로 받는 경우
+ * @desc
+ * - [상하좌우]: 일괄적용 처리
+ * - [상하, 좌우]: [top-bottom, left-right]
+ * - [상, 좌우, 하]: [top, left-right, bottom]
+ * - [상, 우, 하, 좌]: [top, right, bottom, left]
+ */
+export type StyleSpacingArray = FixedLengthArray<
+  number | string,
+  1 | 2 | 3 | 4
+>;
+
+/**
+ * 스타일 옵션 타입; margin, padding
+ * @desc
+ * - number | string: 단일 값
+ * - [상하좌우]: 일괄적용 처리
+ * - [상하, 좌우]
+ * - [상, 좌우, 하]
+ * - [상, 우, 하, 좌]
+ */
+export type StyleSpacingType = number | string | StyleSpacingArray;

package/src/types/tab-menu/index.d.ts

@@ -0,0 +1 @@
+export type * from "./tab-menu";

package/src/types/tab-menu/tab-menu.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 탭메뉴; 모드변경 스타일 데이터 타입
+ * @property {string} code 탭메뉴 항목 코드
+ * @property {React.ReactNode} name 탭메뉴 항목 표현
+ * @property {boolean} isSelected 선택 여부
+ */
+export type TabMenuBaseListDataType = {
+  /**
+   * 탭메뉴 항목 코드
+   */
+  code: string;
+  /**
+   * 탭메뉴 항목 표현
+   */
+  name: React.ReactNode;
+  /**
+   * 선택 여부
+   */
+  isSelected: boolean;
+};
+
+/**
+ * 탭메뉴; 페이지 타입 리스트 데이터 타입
+ * @property {string} code 탭메뉴 항목 코드
+ * @property {string} url 페이지 URL
+ * @property {React.ReactNode} name 탭메뉴 항목 표현
+ * @property {boolean} isSelected 선택 여부
+ */
+export type TabMenuPageListDataType = Omit<
+  TabMenuBaseListDataType,
+  "isSelected"
+> & {
+  /**
+   * 페이지 URL
+   */
+  path: string;
+};

package/src/types/table/components/pagination.d.ts

@@ -0,0 +1,7 @@
+export type TablePagerUtilType = "first" | "prev" | "next" | "last";
+
+interface TablePaginationListType {
+  key: string;
+  paginationIndex: number;
+  pageNo: number;
+}

package/src/types/table/components/props.d.ts

@@ -0,0 +1,104 @@
+import type { ComponentBaseProps } from "../../common";
+import type { TableColumnGroupDataType } from "../data/column";
+import type { TableGridDataType } from "../layout/grid";
+
+/**
+ * 테이블 기본 props
+ * @property {TableColumnDataType[]} column - 테이블 컬럼 데이터
+ * @property {boolean} [isCustom] - 레이아웃 커스텀 여부노드
+ * @property {React.ReactNode} [foot] - tfoot
+ */
+export type TableDefaultProps = {
+  column: TableColumnGroupDataType[];
+} & Partial<{
+  isCustom: boolean;
+  foot: React.ReactNode;
+}>;
+
+/**
+ * 테이블 내부 공통 템플릿 props
+ * @property {string} [className] - 컴포넌트 클래스명
+ * @property {React.ReactNode} children - 테이블 컴포넌트 자식
+ * @property {TableColumnDataType[]} column - 테이블 컬럼 데이터
+ * @property {boolean} [isCustom] - 레이아웃 커스텀 여부노드
+ */
+export type TableDefaultTemplateProps = ComponentBaseProps & TableDefaultProps;
+
+/**
+ * 테이블 기본 props
+ * @property {TableColumnDataType[]} column - 테이블 컬럼 데이터
+ * @property {boolean} [isCustom] - 레이아웃 커스텀 여부노드
+ * @property {boolean} [isSideBorder] - 좌우 테두리 적용 여부
+ */
+export type TableBasicProps = TableDefaultProps &
+  Partial<{
+    isSideBorder: boolean;
+    isBorderTop: boolean;
+  }>;
+
+/**
+ * 테이블 그리드 컨텐츠 props
+ * @property {number} [columnLength] - 테이블 컬럼 개수
+ * @property {TableGridDataType[]} data - 테이블 그리드 데이터
+ */
+export type TableGridContentsProps = {
+  columnLength: number;
+  data: TableGridDataType[];
+};
+
+/**
+ * 테이블 그리드 props
+ * @property {number} [columnLength] - 테이블 컬럼 개수
+ * @property {TableGridDataType[]} data - 테이블 그리드 데이터
+ * @property {boolean} [isScroll] - 스크롤 여부
+ */
+export type TableGridProps = TableGridContentsProps &
+  Partial<{
+    isScroll: boolean;
+  }>;
+
+/**
+ * 테이블 스프레드시트 props
+ * @property {TableColumnDataType[]} column - 테이블 컬럼 데이터
+ */
+export type TableSheetProps = TableDefaultProps &
+  Partial<{
+    isSideBorder: boolean;
+    isBorderTop: boolean;
+  }>;
+
+/**
+ * 테이블 레이아웃 옵션
+ * @property {string} [className] 테이블 클래스명
+ * @property {React.ReactNode} children 테이블 컴포넌트 자식 노드
+ * @property {TableBasicProps} [basic] 기본형 옵션
+ * @property {TableDefaultProps} [list] 리스트형 옵션
+ * @property {boolean} [grid] 그리드형 옵션
+ * @property {TableSheetProps} [sheet] 스프레드시트형 옵션
+ */
+export type TableLayoutProps = ComponentBaseProps &
+  Partial<{
+    basic: TableBasicProps;
+    list: TableDefaultProps;
+    grid: boolean;
+    sheet: TableSheetProps;
+    scroll: boolean;
+  }>;
+
+export type TableRowProps = ComponentBaseProps &
+  Partial<{
+    htmlAttrs: HTMLCustomAttrProps;
+  }>;
+
+export type TableCellProps = ComponentBaseProps &
+  Partial<{
+    colSpan: number;
+    rowSpan: number;
+    htmlAttrs: HTMLCustomAttrProps;
+    /**
+     * 네이티브 툴팁
+     */
+    title: string;
+    onMouseEnter: (e?: React.MouseEvent<HTMLTableCellElement>) => void;
+    onMouseLeave: (e?: React.MouseEvent<HTMLTableCellElement>) => void;
+  }>;

package/src/types/table/data/column.d.ts

@@ -0,0 +1,60 @@
+export type TableColumnGroupDataType = {
+  /**
+   * 고유 키
+   */
+  key: string;
+  /**
+   * 컬럼 너비
+   */
+  width: number | string;
+  /**
+   * 컬럼 데이터 키
+   */
+  dataKey: string;
+  /**
+   * 컬럼 타이틀 내용 (컬럼 이름)
+   */
+  cellContents: React.ReactNode;
+} & Partial<{
+  /**
+   * 현재 정렬된 컬럼 키
+   */
+  sortedKey: string;
+  /**
+   * 컬럼 이름 locale code
+   */
+  localeCode: string;
+  /**
+   * 컬럼 카테고리
+   */
+  category: string;
+  /**
+   * 컬럼 정렬실행 함수
+   */
+  sortEvent: () => void;
+}>;
+
+export type TableColumnGroupCollectionType = {
+  [tableKey: string]: TableColumnGroupDataType[];
+};
+
+/**
+ * 테이블 정렬 방향
+ */
+export type TableColumnSortDirectionType = "asc" | "desc";
+
+/**
+ * 테이블 컬럼 정렬 옵션
+ * @property {string} [dataKey] - 테이블 정렬 적용할 데이터 키
+ * @property {"asc"|"desc"} [direction] - 테이블 정렬 방향
+ */
+export type TableColumnSortProps = {
+  /**
+   * 테이블 정렬 적용할 데이터 키
+   */
+  dataKey: string;
+  /**
+   * 테이블 정렬 방향
+   */
+  direction: TableColumnSortDirectionType;
+};

package/src/types/table/data/row.d.ts

@@ -0,0 +1,26 @@
+export type TableRowGroupDataType = {
+  /**
+   * 고유 키
+   */
+  key: string;
+  /**
+   * 행 데이터 키
+   */
+  dataKey: string;
+  /**
+   * 행 타이틀 내용 (행 이름)
+   */
+  cellContents: React.ReactNode;
+  /**
+   * 행 이름 locale code
+   */
+  localeCode?: string;
+  /**
+   * 행 카테고리
+   */
+  category?: string;
+};
+
+export type TableRowGroupCollectionType = {
+  [tableKey: string]: TableRowGroupDataType[];
+};

package/src/types/table/index.d.ts

@@ -0,0 +1,10 @@
+export type * from "./layout/layout";
+export type * from "./layout/grid";
+
+export type * from "./data/column";
+export type * from "./data/row";
+
+export type * from "./components/props";
+export type * from "./components/pagination";
+
+export type * from "./utils/row.check";

package/src/types/table/layout/grid.d.ts

@@ -0,0 +1,8 @@
+export type TableGridCellProps = {
+  cellTitle: React.ReactNode;
+  cellValue: React.ReactNode;
+};
+
+export type TableGridDataType = {
+  cellKey: string;
+} & TableGridCellProps;

package/src/types/table/layout/layout.d.ts

@@ -0,0 +1,3 @@
+export type TableLayoutType = "basic" | "list" | "grid" | "sheet";
+
+export type TableCellType = "head" | "body";

package/src/types/table/utils/row.check.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 테이블 row 체크 유틸리티; 공통 데이터
+ */
+type TableCheckCommonType<TableRowDataType extends object> = {
+  /**
+   * selector id
+   * - <input id={checkId} />
+   * - <label htmlFor={checkId} />
+   * - 상태관리에서도 key로 사용
+   */
+  selectorId: string;
+  rowData: TableRowDataType;
+};
+
+/**
+ * 테이블 row 체크 유틸리티; 체크할 index 리스트 데이터
+ */
+export type TableRowCheckListType<TableRowDataType extends object> =
+  TableCheckCommonType<TableRowDataType> & {
+    idx: number | string;
+  };
+
+/**
+ * 테이블 row 체크 유틸리티; 체크상태 관리를 위한 각 key별 상태
+ */
+export type TableRowCheckStateType<TableRowDataType extends object> =
+  TableCheckCommonType<TableRowDataType> & {
+    key: string;
+    checked: boolean;
+  };
+
+/**
+ * 테이블 row 체크 유틸리티; 체크상태 관리 객체
+ */
+export type TypeRowCheckStateCollectionType<TableRowDataType extends object> = {
+  [selectorId: string]: TableRowCheckStateType<TableRowDataType>;
+};

package/src/types/template/compare/chart.d.ts

@@ -0,0 +1,8 @@
+import type { ChartLegendBaseType } from "../../chart";
+
+export type CompareChartLegendCategoryDataType = {
+  [categoryDataKey: string]: string | ChartLegendBaseType[];
+  key: string;
+  title: string;
+  legend: ChartLegendBaseType[];
+};

package/src/types/template/filter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 템플릿; 필터 그룹 하위 데이터
+ * @property {string} dataKey 데이터 키
+ * @property {string} name 이름
+ */
+export type FilterGroupItemDataType = {
+  /**
+   * register data key
+   * categoryKey 프로퍼티의 값
+   * - string 값이 아닌 경우, `{categoryKey}_{value}` 형태로 사용
+   */
+  value: string;
+  name: string;
+};
+
+/**
+ * 템플릿; 필터 그룹 데이터
+ * @property {string} key 렌더링 키
+ * @property {string} categoryKey 그룹 카테고리 키 (컬럼 또는 차트 레전드 데이터 키)
+ * @property {string} categoryName 그룹 카테고리 이름
+ * @property {FilterGroupItemDataType[]} items 필터그룹 하위 아이템 데이터
+ */
+export type FilterGroupDataType = {
+  groupKey: string;
+  categoryKey: string;
+  categoryName: string;
+  items: FilterGroupItemDataType[];
+};
+
+export type FilterStateItemDataType = {
+  [itemKey: string]: boolean;
+  all: boolean;
+};
+export type FilterGroupStateDataType = {
+  [categoryKey: string]: FilterStateItemDataType;
+};
+export type FilterStateFormType = {
+  filter: FilterGroupStateDataType;
+};

package/src/types/template/index.d.ts

@@ -0,0 +1,2 @@
+export type * from "./filter";
+export type * from "./compare/chart";

package/src/types/weather/api.d.ts

@@ -0,0 +1,184 @@
+import type {
+  KMA_Res_WeatherNow,
+  KMA_Res_WeatherForecast,
+  KMA_Res_Base,
+  KMA_Req_BaseGridCoordinate,
+  KMA_Req_BaseMoments,
+  KMA_Res_AlertType,
+  KMA_Res_AlertLevel,
+  KMA_Res_AlertCommand,
+} from "./korea";
+
+export type API_Req_WeatherKoreaGrid = KMA_Req_BaseGridCoordinate;
+export type API_Req_WeatherKoreaMoments = KMA_Req_BaseMoments;
+
+export type API_Req_WeatherKorea = API_Req_WeatherKoreaGrid &
+  Partial<API_Req_WeatherKoreaMoments>;
+
+/**
+ * 기상청 API; 특보 요청 파라미터
+ */
+export type API_Req_WeatherKoreaAlert = { farm_idx: number | null };
+
+/**
+ * 기상청 API; 특보 응답 타입 - 지역별 특보정보
+ */
+export type API_Res_WeatherKoreaAlertEach = {
+  /**
+   * 상위 지역 코드
+   * @see https://apihub.kma.go.kr/api/typ01/url/wrn_reg.php?tmfc=0&authKey=njld-D40Rb25Xfg-NAW9hA
+   */
+  upper_region_code: string;
+  /**
+   * 상위 지역 이름
+   * @see https://apihub.kma.go.kr/api/typ01/url/wrn_reg.php?tmfc=0&authKey=njld-D40Rb25Xfg-NAW9hA
+   */
+  upper_region_name: string;
+  /**
+   * 특보 지역 코드
+   * @see https://apihub.kma.go.kr/api/typ01/url/wrn_reg.php?tmfc=0&authKey=njld-D40Rb25Xfg-NAW9hA
+   */
+  alert_region_code: string;
+  /**
+   * 특보 지역 이름
+   * @see https://apihub.kma.go.kr/api/typ01/url/wrn_reg.php?tmfc=0&authKey=njld-D40Rb25Xfg-NAW9hA
+   */
+  alert_region_name: string;
+  /**
+   * 특보 발표시간
+   * - yyyymmddhhmm
+   */
+  announcement_time: string;
+  /**
+   * 특보 발효시간
+   * - yyyymmddhhmm
+   */
+  effective_time: string;
+  /**
+   * 특보 종류 (한글)
+   */
+  alert_type: KMA_Res_AlertType;
+  /**
+   * 특보 수준 (한글)
+   * - 경보, 주의, 예비
+   */
+  alert_level: KMA_Res_AlertLevel;
+  /**
+   * 특보 명령 (한글)
+   * - 발표, 변경, 해제
+   */
+  alert_command: KMA_Res_AlertCommand;
+  /**
+   * 특보 해제 예고시점 (한글)
+   * - dd일 오전/오후/밤(HH시 ~ HH시)
+   */
+  cancel_notice_time: string;
+};
+/**
+ * 기상청 API; 특보 응답 타입
+ */
+export type API_Res_WeatherKoreaAlert = {
+  /**
+   * 특보 발표 시간
+   */
+  api_announcement_time: string | null;
+  /**
+   * 총 특보 개수
+   */
+  total_count: number;
+  /**
+   * 지역별 특보
+   */
+  alerts: API_Res_WeatherKoreaAlertEach[];
+};
+
+/**
+ * 기상청 API; 기초 정보
+ * @property {string} condition - 개황 정보
+ */
+export type API_Res_WeatherKoreaBase = {
+  /**
+   * 하늘상태 코드
+   * - 1(맑음)
+   * - 2(구름조금)
+   * - 3(구름많음)
+   * - 4(흐림)
+   */
+  sky: string | null;
+  /**
+   * 강수형태 코드
+   * - 0(없음)
+   * - 1(비)
+   * - 2(비/눈)
+   * - 3(눈)
+   * - 4(소나기)
+   */
+  drop: string | null;
+  /**
+   * 강수량 코드
+   * - 1(약한 비); 3mm/h 미만
+   * - 2(보통 비); 3mm/h 이상 15mm/h 미만
+   * - 3(강한 비); 15mm/h 이상
+   */
+  rainAmount: string | null;
+  /**
+   * 강설량 코드
+   * - 1(보통 눈); 1cm/h 미만
+   * - 2(많은 눈); 1cm/h 이상
+   */
+  snowAmount: string | null;
+  /**
+   * 풍속 코드
+   * - 1(약한 바람); 4m/s 미만
+   * - 2(약간 강한 바람); 4m/s 이상 9m/s 미만
+   * - 3(강한 바람); 9m/s 이상
+   */
+  windSpeed: string | null;
+  /**
+   * 날씨 상태 코드
+   * - sky-1(맑음)
+   * - sky-2(구름조금)
+   * - sky-3(구름많음)
+   * - sky-4(흐림)
+   * - drop-rain-shower(소나기)
+   * - drop-rain(비)
+   * - drop-rain-1(약한 비)
+   * - drop-rain-2(보통 비)
+   * - drop-rain-3(강한 비)
+   * - drop-rain-snow(비/눈)
+   * - drop-rain-snow-1(약한 비/눈)
+   * - drop-rain-snow-2(보통 비/눈)
+   * - drop-rain-snow-3(강한 비/눈)
+   * - drop-snow(눈)
+   * - drop-snow-1(보통 눈)
+   * - drop-snow-2(많은 눈)
+   */
+  condition: string | null;
+  conditionName: string | null;
+};
+
+export type API_Res_WeatherKoreaToday = API_Res_WeatherKoreaBase & {
+  temperature: number | string | null;
+  humidity: number | string | null;
+};
+
+export type API_Res_WeatherKoreaNextDays = API_Res_WeatherKoreaBase & {
+  max_temperature: number | string | null;
+  min_temperature: number | string | null;
+};
+
+export type API_Res_WeatherKoreaRaw<RAW = KMA_Res_Base> = {
+  raw: RAW;
+};
+
+export type API_Res_WeatherKoreaNow =
+  API_Res_WeatherKoreaRaw<KMA_Res_WeatherNow> & {
+    today: API_Res_WeatherKoreaToday;
+  };
+
+export type API_Res_WeatherKoreaForecast =
+  API_Res_WeatherKoreaRaw<KMA_Res_WeatherForecast> & {
+    today: API_Res_WeatherKoreaToday;
+    day_1: API_Res_WeatherKoreaNextDays;
+    day_2: API_Res_WeatherKoreaNextDays;
+  };

package/src/types/weather/base.d.ts

@@ -0,0 +1,14 @@
+export type WeatherGeoCoordinate = {
+  lat: number | null;
+  lng: number | null;
+};
+export type WeatherCoordinate = {
+  address: string | null;
+} & WeatherGeoCoordinate;
+
+export type WeatherUtilDateTimeMoments = {
+  now: Date;
+  today: string;
+  tomorrow: string;
+  dayAfterTomorrow: string;
+};

package/src/types/weather/index.d.ts

@@ -0,0 +1,4 @@
+export type * from "./base";
+export type * from "./api";
+export type * from "./korea";
+export type * from "./open-weather-map";