@uniai-fe/uds-templates 0.1.15 → 0.1.17

package/src/page-frame/desktop/components/header/util/Logout.tsx

@@ -0,0 +1,26 @@
+"use client";
+
+import Image from "next/image";
+import Link from "next/link";
+import assetsUrl from "../../../../../../asset-url";
+import PageHeaderUtilityItem from "./Item";
+import PageHeaderUtilityButton from "./Button";
+
+export default function PageHeaderLogoutButton({
+  path = "/logout",
+}: {
+  path?: string;
+}) {
+  return (
+    <PageHeaderUtilityItem>
+      <PageHeaderUtilityButton href={path} as={Link}>
+        <Image
+          src={`${assetsUrl}/img/page-header/logout-v2.svg`}
+          alt="로그아웃"
+          width={24}
+          height={24}
+        />
+      </PageHeaderUtilityButton>
+    </PageHeaderUtilityItem>
+  );
+}

package/src/page-frame/desktop/components/header/util/setting/Button.tsx

@@ -0,0 +1,39 @@
+import Image from "next/image";
+import assetUrl from "../../../../../../../asset-url";
+import PageHeaderUtilityItem from "../Item";
+import PageHeaderUtilityButton from "../Button";
+
+/**
+ * 페이지 header; 환경설정 버튼 컴포넌트
+ * - 페이지 프레임 구성요소 > pageHeader
+ * @component
+ * @description
+ * - 테마 설정
+ * - 날씨 알림 설정
+ * - 시세 알림 설정
+ * - 이상감지 알림 설정
+ * - SNS 메시지 알림 설정
+ * - 비밀번호 재설정
+ */
+export default function PageHeaderSettingButton({
+  className,
+  onOpen,
+}: {
+  className?: string;
+  onOpen: () => void;
+}) {
+  return (
+    <PageHeaderUtilityItem>
+      <PageHeaderUtilityButton className={className} onClick={onOpen}>
+        <figure>
+          <Image
+            src={`${assetUrl}/img/page-header/setting-v2.svg`}
+            alt="설정"
+            width={24}
+            height={24}
+          />
+        </figure>
+      </PageHeaderUtilityButton>
+    </PageHeaderUtilityItem>
+  );
+}

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

@@ -0,0 +1,15 @@
+import Page from "./page";
+import Nav from "./nav";
+import Header from "./header";
+import Popup from "./popup";
+
+const Frame = {
+  Page: {
+    ...Page,
+    Nav,
+    Header,
+  },
+  Popup,
+};
+
+export default Frame;

package/src/page-frame/desktop/components/nav/Button.tsx

@@ -0,0 +1,24 @@
+"use client";
+
+import clsx from "clsx";
+import Link from "next/link";
+import type { PageFrameDesktopNavItemProps } from "../../types/nav";
+
+export default function PageNavButton({
+  path,
+  icon,
+  menuName,
+  isHideName,
+}: PageFrameDesktopNavItemProps) {
+  return (
+    <Link
+      href={path}
+      className={clsx("page-frame-nav-category", { "icon-only": isHideName })}
+    >
+      {icon && <span className="page-frame-nav-category-icon">{icon}</span>}
+      {!isHideName && (
+        <span className="page-frame-nav-category-label">{menuName}</span>
+      )}
+    </Link>
+  );
+}

package/src/page-frame/desktop/components/nav/Container.tsx

@@ -0,0 +1,70 @@
+"use client";
+
+import clsx from "clsx";
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+import { useCallback } from "react";
+
+import PageNavButton from "./Button";
+import PageNavLogo from "./Logo";
+
+import type { SitemapDataType } from "../../../types";
+import type { PageFrameDesktopNavProps } from "../../types/nav";
+
+export default function PageNavContainer({
+  logo,
+  sitemap,
+  currentPath,
+}: PageFrameDesktopNavProps) {
+  const pathnameValue = usePathname();
+  // currentPath를 명시하면 Next 라우터가 없는 환경에서도 선택 상태를 제어할 수 있다.
+  const resolvedPath = currentPath ?? pathnameValue ?? "";
+  const isSelected = useCallback(
+    (path: string): boolean => resolvedPath.startsWith(path),
+    [resolvedPath],
+  );
+
+  const formatRoutes = useCallback(
+    (routes?: SitemapDataType[]) =>
+      Array.isArray(routes)
+        ? routes.map(route => ({
+            ...route,
+            routeKey: `nav/${route.routeKey}`,
+          }))
+        : [],
+    [],
+  );
+
+  return (
+    <nav className="page-frame-nav">
+      {logo && <PageNavLogo {...logo} />}
+      <ul className="page-frame-nav-list">
+        {formatRoutes(sitemap).map(
+          ({ routeKey, icon, name, path, depth, navDepthDisabled }) => (
+            <li
+              key={routeKey}
+              className={clsx("page-frame-nav-item", {
+                "is-selected": isSelected(path),
+              })}
+            >
+              <PageNavButton icon={icon} menuName={name} path={path} />
+              {!navDepthDisabled && depth.length > 0 && (
+                <div className="page-frame-nav-depth">
+                  {formatRoutes(depth).map(({ routeKey, path, name }) => (
+                    <Link
+                      key={routeKey}
+                      href={path}
+                      className="page-frame-nav-depth-item"
+                    >
+                      <span>{name}</span>
+                    </Link>
+                  ))}
+                </div>
+              )}
+            </li>
+          ),
+        )}
+      </ul>
+    </nav>
+  );
+}

package/src/page-frame/desktop/components/nav/Logo.tsx

@@ -0,0 +1,46 @@
+"use client";
+
+import Image from "next/image";
+import Link from "next/link";
+import type { PageFrameDesktopNavLogoProps } from "../../types/nav";
+
+/**
+ * PageFrame; Desktop Nav Logo 컴포넌트
+ * @component
+ * @param {PageFrameDesktopNavLogoProps} props - 컴포넌트 props
+ * @param {string} [props.href="/"] - 로고 클릭 시 이동할 링크 주소
+ * @param {string} props.src - 로고 이미지 src 속성 값
+ * @param {string} props.alt - 로고 이미지 alt 속성 값
+ * @param {number} props.width - 로고 이미지 width 속성 값
+ * @param {number} props.height - 로고 이미지 height 속성 값
+ * @param {boolean} [props.priority=false] - 로고 이미지 priority 속성 값
+ * @param {ReactNode} [props.children] - 커스텀 로고 콘텐츠
+ */
+export default function PageNavLogo({
+  src,
+  alt,
+  width,
+  height,
+  priority,
+  href,
+  children,
+}: PageFrameDesktopNavLogoProps) {
+  return (
+    <div className="page-frame-nav-logo">
+      <Link href={href || "/"} aria-label={alt}>
+        {children ?? (
+          <figure>
+            <Image
+              src={src}
+              alt={alt}
+              width={width}
+              height={height}
+              priority={priority}
+              aria-hidden="true"
+            />
+          </figure>
+        )}
+      </Link>
+    </div>
+  );
+}

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

@@ -0,0 +1,5 @@
+import PageNavContainer from "./Container";
+
+const Nav = PageNavContainer;
+
+export default Nav;

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

@@ -0,0 +1,13 @@
+"use client";
+
+import clsx from "clsx";
+import type { ComponentBaseProps } from "../../../types";
+
+export default function PageContainer({
+  className,
+  children,
+}: ComponentBaseProps) {
+  return (
+    <main className={clsx("page-frame-container", className)}>{children}</main>
+  );
+}

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

@@ -0,0 +1,15 @@
+"use client";
+
+import clsx from "clsx";
+import type { ComponentBaseProps } from "../../../types";
+
+export default function PageServiceFrame({
+  className,
+  children,
+}: ComponentBaseProps) {
+  return (
+    <div className={clsx("page-frame-service-frame", className)}>
+      {children}
+    </div>
+  );
+}

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

@@ -0,0 +1,13 @@
+"use client";
+
+import clsx from "clsx";
+import type { ComponentBaseProps } from "../../../types";
+
+export default function PageServiceMain({
+  className,
+  children,
+}: ComponentBaseProps) {
+  return (
+    <div className={clsx("page-frame-service-main", className)}>{children}</div>
+  );
+}

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

@@ -0,0 +1,24 @@
+"use client";
+
+import clsx from "clsx";
+
+import type { ComponentBaseProps } from "../../../types";
+
+export default function PageServiceMainWrapper({
+  className,
+  noPadding,
+  children,
+}: ComponentBaseProps &
+  Partial<{
+    noPadding: boolean;
+  }>) {
+  return (
+    <div
+      className={clsx("page-frame-service-main-wrapper", className, {
+        "no-padding": noPadding,
+      })}
+    >
+      {children}
+    </div>
+  );
+}

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

@@ -0,0 +1,14 @@
+import PageContainer from "./Container";
+import PageServiceFrame from "./ServiceFrame";
+import PageServiceMain from "./ServiceMain";
+import PageServiceMainWrapper from "./ServiceMainWrapper";
+
+const Page = {
+  Container: PageContainer,
+  Service: {
+    Frame: PageServiceFrame,
+    Main: PageServiceMain,
+    MainWrapper: PageServiceMainWrapper,
+  },
+};
+export default Page;

package/src/page-frame/desktop/components/popup/Container.tsx

@@ -0,0 +1,18 @@
+"use client";
+
+import clsx from "clsx";
+import type { ReactNode } from "react";
+
+export default function PopupContainer({
+  className,
+  children,
+}: {
+  className?: string;
+  children: ReactNode;
+}) {
+  return (
+    <main id="pagePopup" className={clsx("popup-container", className)}>
+      {children}
+    </main>
+  );
+}

package/src/page-frame/desktop/components/popup/frame/Body.tsx

@@ -0,0 +1,14 @@
+"use client";
+
+import clsx from "clsx";
+import type { ReactNode } from "react";
+
+export default function PopupFrameBody({
+  className,
+  children,
+}: {
+  className?: string;
+  children: ReactNode;
+}) {
+  return <div className={clsx("popup-frame-body", className)}>{children}</div>;
+}

package/src/page-frame/desktop/components/popup/frame/Container.tsx

@@ -0,0 +1,16 @@
+"use client";
+
+import clsx from "clsx";
+import type { ReactNode } from "react";
+
+export default function PopupFrameContainer({
+  className,
+  children,
+}: {
+  className?: string;
+  children: ReactNode;
+}) {
+  return (
+    <div className={clsx("popup-frame-container", className)}>{children}</div>
+  );
+}

package/src/page-frame/desktop/components/popup/frame/Header.tsx

@@ -0,0 +1,26 @@
+"use client";
+
+import clsx from "clsx";
+import type { ReactNode } from "react";
+
+export default function PopupFrameHeader({
+  className,
+  title,
+  util,
+  children,
+}: {
+  className?: string;
+  title: ReactNode;
+  util?: ReactNode;
+  children?: ReactNode;
+}) {
+  return (
+    <header className={clsx("popup-frame-header", className)}>
+      <div className="popup-frame-header-title-container">
+        <h2 className="popup-frame-header-title">{title}</h2>
+        {util && <div className="popup-frame-header-util">{util}</div>}
+      </div>
+      {children}
+    </header>
+  );
+}

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

@@ -0,0 +1,11 @@
+import PopupFrameContainer from "./Container";
+import PopupFrameHeader from "./Header";
+import PopupFrameBody from "./Body";
+
+const PopupPageFrame = {
+  Container: PopupFrameContainer,
+  Header: PopupFrameHeader,
+  Body: PopupFrameBody,
+};
+
+export default PopupPageFrame;

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

@@ -0,0 +1,9 @@
+import PopupContainer from "./Container";
+import PopupPageFrame from "./frame";
+
+const Popup = {
+  Container: PopupContainer,
+  Frame: PopupPageFrame,
+};
+
+export default Popup;

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

@@ -0,0 +1,5 @@
+@use "./styles/variables.scss" as frameVariables;
+@use "./styles/page/common.scss" as pageCommon;
+@use "./styles/page/header.scss" as pageHeader;
+@use "./styles/page/nav.scss" as pageNav;
+@use "./styles/popup/popup.scss" as popup;

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

@@ -0,0 +1,5 @@
+import "./index.scss";
+
+import Frame from "./components";
+
+export default Frame;

package/src/page-frame/desktop/styles/page/common.scss

@@ -0,0 +1,40 @@
+// 페이지 프레임: 레이아웃 뼈대를 담당한다.
+.page-frame-container {
+  width: 100%;
+  min-height: 100vh;
+  background-color: var(--uds-page-frame-background);
+}
+
+// 서비스 본문과 내비게이션을 병렬 배치한다.
+.page-frame-service-frame {
+  width: 100%;
+  min-height: 100vh;
+  display: flex;
+}
+
+// 내비게이션을 제외한 콘텐츠 영역.
+.page-frame-service-main {
+  width: calc(100% - var(--uds-page-nav-width));
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+}
+
+// 본문 스크롤 영역: 헤더 높이를 제외하고 padding을 CSS 변수로 제어한다.
+.page-frame-service-main-wrapper {
+  width: 100%;
+  height: calc(100% - var(--uds-page-header-height));
+  padding: var(--uds-page-body-padding-vertical)
+    var(--uds-page-body-padding-horizontal);
+  background-color: var(--uds-page-body-background);
+  overflow-y: auto;
+
+  position: relative;
+  z-index: 0;
+
+  // noPadding 상태일 때 padding/background를 제거한다.
+  &.no-padding {
+    --uds-page-body-background: var(--color-bg-standard-neutral);
+    padding: 0px;
+  }
+}

package/src/page-frame/desktop/styles/page/header.scss

@@ -0,0 +1,49 @@
+// 페이지 헤더: 상단 고정 막대.
+.page-frame-header {
+  width: 100%;
+  height: var(--uds-page-header-height);
+  padding: var(--uds-page-header-padding-vertical)
+    var(--uds-page-header-padding-horizontal);
+  background: var(--uds-page-header-background);
+  border-bottom: 1px solid var(--uds-page-header-border);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--uds-page-header-item-gap);
+  position: relative;
+  z-index: 500;
+}
+
+// 섹션 래퍼: 좌측 브랜드, 중간 정보, 우측 유틸 등 원하는 대로 조합한다.
+.page-frame-header-section {
+  display: flex;
+  align-items: center;
+  gap: var(--uds-page-header-item-gap);
+}
+
+// 헤더 우측 유틸리티 컨테이너.
+.page-header-util-container {
+  display: flex;
+  align-items: center;
+  margin-left: auto;
+  gap: var(--uds-page-nav-item-gap, 0);
+  padding: 0;
+  margin-block: 0;
+  list-style: none;
+}
+
+// margin을 CSS 변수로 조정해 Item 별 여백을 만든다.
+.page-header-util-item {
+  display: flex;
+  align-items: center;
+  list-style: none;
+}
+
+// 공통 버튼: 높이/패딩을 토큰으로 통일한다.
+.page-header-util-button {
+  padding: 0px;
+}
+
+.page-header-util-logout {
+  font-size: 0;
+}

package/src/page-frame/desktop/styles/page/nav.scss

@@ -0,0 +1,128 @@
+.page-frame-nav {
+  width: var(--uds-page-nav-width);
+  border-right: 1px solid var(--uds-page-nav-border);
+  background-color: var(--uds-page-nav-background);
+
+  position: relative;
+  z-index: 500;
+}
+
+.page-frame-nav-logo {
+  width: 100%;
+  height: var(--uds-page-nav-logo-height);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+
+  a {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 0;
+  }
+}
+
+.page-frame-nav-list {
+  width: 100%;
+  padding: var(--uds-page-nav-list-padding-vertical)
+    var(--uds-page-nav-list-padding-horizontal);
+}
+
+.page-frame-nav-item {
+  width: 100%;
+  margin-bottom: var(--uds-page-nav-item-gap);
+  position: relative;
+}
+
+.page-frame-nav-category {
+  width: 100%;
+  height: var(--uds-page-nav-item-height);
+  text-decoration: none;
+  color: var(--uds-page-nav-item-color-default);
+  transition:
+    color 0.2s,
+    fill 0.2s;
+
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-direction: column;
+  gap: 0.2rem;
+
+  &.icon-only {
+    width: auto;
+    padding: 0.4rem;
+  }
+}
+
+.page-frame-nav-category-icon {
+  width: var(--uds-page-nav-icon-size);
+  height: var(--uds-page-nav-icon-size);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+
+  svg,
+  img {
+    width: 100%;
+    height: 100%;
+    object-fit: contain;
+  }
+
+  svg path {
+    fill: var(--uds-page-nav-item-color-default);
+  }
+}
+
+.page-frame-nav-category-label {
+  font-size: 1.2rem;
+  line-height: 1.4rem;
+  color: inherit;
+}
+
+.page-frame-nav-item.is-selected .page-frame-nav-category,
+.page-frame-nav-item:hover .page-frame-nav-category {
+  color: var(--uds-page-nav-item-color-active);
+}
+
+.page-frame-nav-item.is-selected .page-frame-nav-category-icon svg path,
+.page-frame-nav-item:hover .page-frame-nav-category-icon svg path {
+  fill: var(--uds-page-nav-item-color-active);
+}
+
+.page-frame-nav-depth {
+  display: none;
+  width: fit-content;
+  min-height: 100%;
+  padding: 1.1rem 1.6rem;
+  background: var(--uds-page-nav-bg-active);
+  position: absolute;
+  top: 0;
+  left: calc(100% - 0.8rem);
+  z-index: 1000;
+  flex-direction: column;
+  justify-content: center;
+  border-radius: 1.2rem;
+  box-shadow: 0 0.6rem 1.2rem rgba(0, 0, 0, 0.15);
+}
+
+.page-frame-nav-depth-item {
+  display: flex;
+  align-items: center;
+  width: 100%;
+  min-height: 2.4rem;
+  text-decoration: none;
+
+  span {
+    font-size: 1.2rem;
+    color: var(
+      --uds-page-nav-depth-color,
+      var(--uds-page-nav-item-color-active)
+    );
+    white-space: nowrap;
+  }
+}
+
+.page-frame-nav-item:hover .page-frame-nav-depth {
+  display: flex;
+}