@ncds/ui-admin 1.8.25-alpha.0 → 1.8.25-alpha.1

package/dist/types/src/components/forms-and-input/combo-box/__tests__/ComboBox.portal.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/hooks/__tests__/useFloatingPosition.ssr.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/hooks/__tests__/useFloatingPosition.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/hooks/dropdown/useDropdown.d.ts

@@ -2,6 +2,8 @@ import { type RefObject } from 'react';
 interface UseDropdownConfig<T = any> {
     triggerRef: RefObject<HTMLElement>;
     dropdownRef?: RefObject<HTMLElement>;
+    /** direction 계산 전용 ref. 미지정 시 triggerRef 사용. Portal 모드에서 anchor box 가 다를 때 지정. */
+    positionRef?: RefObject<HTMLElement>;
     maxHeight: number;
     itemCount: number;
     optionItems: T[];
@@ -15,7 +17,7 @@ interface UseDropdownConfig<T = any> {
  */
 export declare const useDropdown: <T = any>(config: UseDropdownConfig<T>) => {
     isOpen: boolean;
-    direction: import("../../types").DropdownDirection;
+    direction: import("../../utils/portal-position").PortalDirection;
     focusedIndex: number;
     toggleDropdown: () => void;
     closeDropdown: () => void;

package/dist/types/src/hooks/dropdown/useDropdownPosition.d.ts

@@ -1,9 +1,9 @@
-import type { DropdownDirection, DropdownPositionConfig } from '../../types/dropdown';
+import type { DropdownPositionConfig } from '../../types/dropdown';
 /**
  * 드롭다운 위치 계산을 위한 커스텀 훅
  */
 export declare const useDropdownPosition: (config: DropdownPositionConfig) => {
-    direction: DropdownDirection;
+    direction: import("../../utils/portal-position").PortalDirection;
     updatePosition: () => import("../../types/dropdown").DropdownPositionResult;
-    setDirection: import("react").Dispatch<import("react").SetStateAction<DropdownDirection>>;
+    setDirection: import("react").Dispatch<import("react").SetStateAction<import("../../utils/portal-position").PortalDirection>>;
 };

package/dist/types/src/hooks/useFloatingPosition.d.ts

@@ -1,15 +1,17 @@
 import { type CSSProperties, type RefObject } from 'react';
-type FloatingDirection = 'up' | 'down';
+import { type PortalAlign, type PortalDirection } from '../utils/portal-position';
 type UseFloatingPositionParams = {
     enabled: boolean;
     isOpen: boolean;
     triggerRef: RefObject<HTMLElement | null>;
     floatingRef: RefObject<HTMLElement | null>;
-    direction: FloatingDirection;
+    direction: PortalDirection;
+    /** trigger 와 floating 요소 사이 간격. 미지정 시 4px */
     offset?: number;
-    align?: 'left' | 'right';
+    /** 미지정 시 'left' */
+    align?: PortalAlign;
     /**
-     * true면 floating 요소의 width를 trigger 너비에 맞춘다.
+     * true면 floating 요소의 min-width를 trigger 너비로 보장한다 (width 고정이 아니다).
      * Portal 모드에서 부모가 body로 바뀌면서 min-width: 100% 같은 CSS가 viewport 너비로
      * 폭주하는 것을 막는다 (예: SelectBox 옵션 패널).
      */

package/dist/types/src/types/dropdown/dropdown.d.ts

@@ -1,5 +1,6 @@
 import type { RefObject } from 'react';
-export type DropdownDirection = 'up' | 'down';
+import type { PortalDirection } from '../../utils/portal-position';
+export type DropdownDirection = PortalDirection;
 export type DropdownPositionConfig = {
     triggerRef: RefObject<HTMLElement>;
     maxHeight: number;

package/dist/types/src/utils/dropdown/__tests__/dropdownUtils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/utils/portal-position/__tests__/portalPosition.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/utils/portal-position/__tests__/portalPosition.tracking.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/utils/portal-position/index.d.ts

@@ -0,0 +1 @@
+export * from './portalPosition';

package/dist/types/src/utils/portal-position/portalPosition.d.ts

@@ -0,0 +1,67 @@
+export type PortalDirection = 'up' | 'down';
+export type PortalAlign = 'left' | 'right';
+export type AnchorRect = Readonly<Pick<DOMRectReadOnly, 'top' | 'bottom' | 'left' | 'right' | 'width'>>;
+export declare const PORTAL_PANEL_Z_INDEX = 1500;
+export type ComputePortalPositionInput = Readonly<{
+    anchorRect: AnchorRect;
+    panelHeight: number;
+    panelWidth: number;
+    direction: PortalDirection;
+    align?: PortalAlign;
+    offset?: number;
+}>;
+export type PortalPosition = Readonly<{
+    top: number;
+    left: number;
+}>;
+export declare const computePortalPosition: ({ anchorRect, panelHeight, panelWidth, direction, align, offset, }: ComputePortalPositionInput) => PortalPosition;
+export type ResolveDropdownDirectionInput = Readonly<{
+    anchorRect: Pick<AnchorRect, 'bottom'>;
+    panelHeight: number;
+    viewportHeight: number;
+    gap?: number;
+}>;
+export declare const resolveDropdownDirection: ({ anchorRect, panelHeight, viewportHeight, gap, }: ResolveDropdownDirectionInput) => PortalDirection;
+export type BuildPortalPanelStyleInput = Readonly<{
+    anchorRect: AnchorRect;
+    panelHeight: number;
+    panelWidth: number | null;
+    direction: PortalDirection;
+    align?: PortalAlign;
+    offset?: number;
+    /**
+     * true 이면 panelWidth 를 무시하고 anchorRect.width 로 minWidth 를 설정한다.
+     * align: 'right' 와 조합 시 콘텐츠가 앵커보다 넓으면 우측 정렬이 보장되지 않는다.
+     */
+    matchAnchorWidth?: boolean;
+}>;
+export type PortalPanelStyle = Readonly<{
+    position: 'fixed';
+    top: number;
+    left: number;
+    zIndex: number;
+    minWidth?: number;
+}>;
+export declare const buildPortalPanelStyle: ({ anchorRect, panelHeight, panelWidth, direction, align, offset, matchAnchorWidth, }: BuildPortalPanelStyleInput) => PortalPanelStyle;
+export type AnchorGeometryObserverOptions = Readonly<{
+    getAnchor: () => HTMLElement | null;
+    /**
+     * 구독 시점에 1회 호출되어 ResizeObserver 가 부착된다.
+     * 구독 후 패널이 교체·마운트되어도 옵저버는 갱신되지 않는다.
+     */
+    getPanel: () => HTMLElement | null;
+    onChange: () => void;
+}>;
+export declare const observeAnchorGeometry: ({ getAnchor, getPanel, onChange, }: AnchorGeometryObserverOptions) => (() => void);
+export type TrackPortalPositionOptions = Readonly<{
+    getAnchor: () => HTMLElement | null;
+    getPanel: () => HTMLElement | null;
+    /** 함수를 넘기면 갱신마다 다시 읽는다 — 열린 뒤 패널 높이가 변하는 소비자가 방향을 재판정할 수 있다 */
+    direction: PortalDirection | (() => PortalDirection);
+    align?: PortalAlign;
+    offset?: number;
+    matchAnchorWidth?: boolean;
+    onUpdate: (style: PortalPanelStyle) => void;
+}>;
+export declare const trackPortalPosition: ({ onUpdate, ...measureOptions }: TrackPortalPositionOptions) => (() => void);
+export declare const applyPortalPanelStyle: (element: HTMLElement, style: PortalPanelStyle) => void;

package/dist/ui-admin/assets/styles/style.css

@@ -1238,10 +1238,12 @@ button {
 }
 
 .ncua-dropdown {
-  --ncua-dropdown-item-height: 36px;
   position: relative;
   display: inline-block;
 }
+.ncua-dropdown, .ncua-dropdown__menu--portal-root {
+  --ncua-dropdown-item-height: 36px;
+}
 .ncua-dropdown__trigger {
   cursor: pointer;
   padding: 0;
@@ -5101,6 +5103,16 @@ button {
   margin-inline-start: -10px;
 }
 
+.ncua-date-picker--portal-input.ncua-date-picker--xs {
+  padding: 5px 10px;
+  font-size: var(--font-size-xs);
+}
+
+.ncua-date-picker--portal-input.ncua-date-picker--sm {
+  padding: 7px 12px;
+  font-size: var(--font-size-sm);
+}
+
 .ncua-range-date-picker {
   display: inline-flex;
   align-items: center;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ncds/ui-admin",
-  "version": "1.8.25-alpha.0",
+  "version": "1.8.25-alpha.1",
   "description": "nhn-commerce의 어드민 디자인 시스템입니다.",
   "scripts": {
     "barrel": "node barrel.js",