@ncds/ui-admin 1.8.25-alpha.2 → 1.8.25

package/dist/temp/src/hooks/__tests__/useFloatingPosition.test.js

@@ -203,3 +203,27 @@ describe('useFloatingPosition — 프롭 변경 재구독 (E-5)', () => {
         hook.unmount();
     });
 });
+describe('useFloatingPosition — 좌표 불변 갱신', () => {
+    it('scroll 뒤에도 top·left·minWidth 가 같으면 이전 style 참조를 유지해 하위 트리 리렌더를 건너뛴다', () => {
+        installResizeObserverStub();
+        const hook = renderHook(baseParams({
+            triggerRef: makeRef(createAnchor()),
+            floatingRef: makeRef(createPanel()),
+            matchTriggerWidth: true,
+        }));
+        const styleBeforeScroll = hook.latest();
+        dispatchScroll();
+        expect(hook.latest()).toBe(styleBeforeScroll);
+        hook.unmount();
+    });
+    it('scroll 로 좌표가 바뀌면 새 style 로 다시 렌더링한다', () => {
+        installResizeObserverStub();
+        const anchor = createAnchor();
+        const hook = renderHook(baseParams({ triggerRef: makeRef(anchor), floatingRef: makeRef(createPanel()) }));
+        const moved = makeAnchorRect({ top: 300, bottom: 340 });
+        vi.spyOn(anchor, 'getBoundingClientRect').mockReturnValue(toDomRect(moved));
+        dispatchScroll();
+        expect(hook.latest()).toMatchObject({ top: moved.bottom + DEFAULT_OFFSET });
+        hook.unmount();
+    });
+});

package/dist/temp/src/hooks/useFloatingPosition.js

@@ -1,6 +1,7 @@
 import { useState } from 'react';
-import { trackPortalPosition } from '../utils/portal-position';
+import { trackPortalPosition, } from '../utils/portal-position';
 import { useIsomorphicLayoutEffect } from './useIsomorphicLayoutEffect';
+const isSamePlacement = (prev, next) => prev !== null && prev.top === next.top && prev.left === next.left && prev.minWidth === next.minWidth;
 export const useFloatingPosition = ({ enabled, isOpen, triggerRef, floatingRef, direction, offset, align, matchTriggerWidth = false, }) => {
     const [style, setStyle] = useState(null);
     useIsomorphicLayoutEffect(() => {
@@ -15,7 +16,7 @@ export const useFloatingPosition = ({ enabled, isOpen, triggerRef, floatingRef,
             align,
             offset,
             matchAnchorWidth: matchTriggerWidth,
-            onUpdate: setStyle,
+            onUpdate: (next) => setStyle((prev) => (isSamePlacement(prev, next) ? prev : next)),
         });
     }, [enabled, isOpen, direction, offset, align, matchTriggerWidth, triggerRef, floatingRef]);
     return style;

package/dist/temp/src/utils/portal-position/__tests__/portalPosition.tracking.test.js

@@ -71,6 +71,19 @@ describe('observeAnchorGeometry — 구독 (E-6)', () => {
         expect(onChange).toHaveBeenCalledTimes(ON_CHANGE_CALLS.afterScroll);
         cleanup();
     });
+    it('panel 자신과 그 내부 요소의 scroll 은 anchor 를 움직이지 않으므로 onChange 를 호출하지 않는다', () => {
+        installResizeObserverStub();
+        const anchor = createAnchor();
+        const panel = createPanel();
+        const optionList = document.createElement('ul');
+        panel.appendChild(optionList);
+        const onChange = vi.fn();
+        const cleanup = observeAnchorGeometry({ getAnchor: () => anchor.element, getPanel: () => panel, onChange });
+        panel.dispatchEvent(new Event('scroll', { bubbles: false }));
+        optionList.dispatchEvent(new Event('scroll', { bubbles: false }));
+        expect(onChange).toHaveBeenCalledTimes(ON_CHANGE_CALLS.initial);
+        cleanup();
+    });
     it('anchor 와 panel 각각에 ResizeObserver 를 붙인다', () => {
         const { instances } = installResizeObserverStub();
         const anchor = createAnchor();

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

@@ -2,7 +2,7 @@ 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<{
+export type ComputePortalPositionParams = Readonly<{
     anchorRect: AnchorRect;
     panelHeight: number;
     panelWidth: number;
@@ -14,15 +14,15 @@ export type PortalPosition = Readonly<{
     top: number;
     left: number;
 }>;
-export declare const computePortalPosition: ({ anchorRect, panelHeight, panelWidth, direction, align, offset, }: ComputePortalPositionInput) => PortalPosition;
-export type ResolveDropdownDirectionInput = Readonly<{
+export declare const computePortalPosition: ({ anchorRect, panelHeight, panelWidth, direction, align, offset, }: ComputePortalPositionParams) => PortalPosition;
+export type ResolveDropdownDirectionParams = 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<{
+export declare const resolveDropdownDirection: ({ anchorRect, panelHeight, viewportHeight, gap, }: ResolveDropdownDirectionParams) => PortalDirection;
+export type BuildPortalPanelStyleParams = Readonly<{
     anchorRect: AnchorRect;
     panelHeight: number;
     panelWidth: number | null;
@@ -42,18 +42,15 @@ export type PortalPanelStyle = Readonly<{
     zIndex: number;
     minWidth?: number;
 }>;
-export declare const buildPortalPanelStyle: ({ anchorRect, panelHeight, panelWidth, direction, align, offset, matchAnchorWidth, }: BuildPortalPanelStyleInput) => PortalPanelStyle;
-export type AnchorGeometryObserverOptions = Readonly<{
+export declare const buildPortalPanelStyle: ({ anchorRect, panelHeight, panelWidth, direction, align, offset, matchAnchorWidth, }: BuildPortalPanelStyleParams) => PortalPanelStyle;
+export type ObserveAnchorGeometryParams = Readonly<{
     getAnchor: () => HTMLElement | null;
-    /**
-     * 구독 시점에 1회 호출되어 ResizeObserver 가 부착된다.
-     * 구독 후 패널이 교체·마운트되어도 옵저버는 갱신되지 않는다.
-     */
+    /** ResizeObserver 는 구독 시점의 패널에만 부착된다 — 이후 교체·마운트되어도 옵저버는 갱신되지 않는다. */
     getPanel: () => HTMLElement | null;
     onChange: () => void;
 }>;
-export declare const observeAnchorGeometry: ({ getAnchor, getPanel, onChange, }: AnchorGeometryObserverOptions) => (() => void);
-export type TrackPortalPositionOptions = Readonly<{
+export declare const observeAnchorGeometry: ({ getAnchor, getPanel, onChange }: ObserveAnchorGeometryParams) => (() => void);
+export type TrackPortalPositionParams = Readonly<{
     getAnchor: () => HTMLElement | null;
     getPanel: () => HTMLElement | null;
     /** 함수를 넘기면 갱신마다 다시 읽는다 — 열린 뒤 패널 높이가 변하는 소비자가 방향을 재판정할 수 있다 */
@@ -63,5 +60,5 @@ export type TrackPortalPositionOptions = Readonly<{
     matchAnchorWidth?: boolean;
     onUpdate: (style: PortalPanelStyle) => void;
 }>;
-export declare const trackPortalPosition: ({ onUpdate, ...measureOptions }: TrackPortalPositionOptions) => (() => void);
+export declare const trackPortalPosition: ({ onUpdate, ...measureOptions }: TrackPortalPositionParams) => (() => void);
 export declare const applyPortalPanelStyle: (element: HTMLElement, style: PortalPanelStyle) => void;

package/dist/temp/src/utils/portal-position/portalPosition.js

@@ -47,17 +47,23 @@ export const buildPortalPanelStyle = ({ anchorRect, panelHeight, panelWidth, dir
     // 옵션이 짧으면 앵커 너비, 길면 자연 확장 — Portal 이전 absolute 모드와 동일한 UX.
     return matchAnchorWidth ? { ...base, minWidth: anchorRect.width } : base;
 };
-export const observeAnchorGeometry = ({ getAnchor, getPanel, onChange, }) => {
+export const observeAnchorGeometry = ({ getAnchor, getPanel, onChange }) => {
     const anchor = getAnchor();
     if (anchor === null) {
         return noop;
     }
     onChange();
-    window.addEventListener('scroll', onChange, { passive: true, capture: true });
+    // 패널 내부 스크롤은 anchor 를 움직이지 않는다
+    const onScroll = (event) => {
+        if (event.target instanceof Node && getPanel()?.contains(event.target))
+            return;
+        onChange();
+    };
+    window.addEventListener('scroll', onScroll, { passive: true, capture: true });
     window.addEventListener('resize', onChange);
     const observers = [observeElementResize(anchor, onChange), observeElementResize(getPanel(), onChange)];
     return () => {
-        window.removeEventListener('scroll', onChange, { capture: true });
+        window.removeEventListener('scroll', onScroll, { capture: true });
         window.removeEventListener('resize', onChange);
         for (const observer of observers) {
             observer?.disconnect();
@@ -74,7 +80,6 @@ export const trackPortalPosition = ({ onUpdate, ...measureOptions }) => observeA
         }
     },
 });
-// TODO(#497): vanilla 어댑터 도입 시 소비
 export const applyPortalPanelStyle = (element, style) => {
     element.style.position = style.position;
     element.style.top = `${style.top}px`;

package/dist/types/src/components/feedback-and-status/badge/Badge.d.ts

@@ -16,4 +16,4 @@ type BadgeProps = {
 };
 declare const Badge: ({ label, type, color, className, leadingIcon, trailingIcon, size, }: BadgeProps) => import("react/jsx-runtime").JSX.Element;
 export { Badge };
-export type { BadgeColor, BadgeProps, BadgeSize, BadgeType };
+export type { BadgeType, BadgeColor, BadgeSize, BadgeProps };

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

@@ -10,7 +10,7 @@ interface ComboBoxProps extends Omit<ComponentPropsWithRef<'div'>, 'size' | 'onC
     destructive?: boolean;
     size?: Extract<Size, 'xs' | 'sm'>;
     optionItems?: OptionType[];
-    value?: OptionValue;
+    value?: OptionValue | null;
     onChange?: OptionChangeHandler;
     onSearch?: (searchValue: string) => void;
     disabled?: boolean;

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

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

package/dist/types/src/components/forms-and-input/combo-box/utils.d.ts

@@ -0,0 +1,27 @@
+import type { CSSProperties, ReactNode } from 'react';
+type PortalPanelBinding = {
+    className?: string;
+    style?: CSSProperties;
+};
+type DropdownMounts = {
+    inlineDropdown: ReactNode;
+    portaledDropdown: ReactNode;
+};
+type ResolveDropdownMountsParams = {
+    node: ReactNode;
+    shouldPortal: boolean;
+    portalContainer: HTMLElement | null;
+    isOpen: boolean;
+};
+/**
+ * Portal 모드에서만 패널에 `--portal` 클래스와 fixed 좌표를 얹는다.
+ * floatingStyle 이 null 인 초기 레이아웃 직전에는 클래스만 붙지만,
+ * useLayoutEffect 가 paint 전에 좌표를 채우므로 빈 fixed 가 노출되지 않는다.
+ */
+export declare const resolvePortalPanelBinding: (shouldPortal: boolean, floatingStyle: CSSProperties | null) => PortalPanelBinding;
+/**
+ * 패널 노드를 인라인·Portal 두 마운트 지점 중 한 곳에만 넘긴다. 양쪽에 두면 dropdownRef 가
+ * 나중 노드로 덮여 외부 클릭 판정과 키보드 스크롤이 유령 노드를 가리키게 된다.
+ */
+export declare const resolveDropdownMounts: ({ node, shouldPortal, portalContainer, isOpen, }: ResolveDropdownMountsParams) => DropdownMounts;
+export {};

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

@@ -2,7 +2,7 @@ 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<{
+export type ComputePortalPositionParams = Readonly<{
     anchorRect: AnchorRect;
     panelHeight: number;
     panelWidth: number;
@@ -14,15 +14,15 @@ export type PortalPosition = Readonly<{
     top: number;
     left: number;
 }>;
-export declare const computePortalPosition: ({ anchorRect, panelHeight, panelWidth, direction, align, offset, }: ComputePortalPositionInput) => PortalPosition;
-export type ResolveDropdownDirectionInput = Readonly<{
+export declare const computePortalPosition: ({ anchorRect, panelHeight, panelWidth, direction, align, offset, }: ComputePortalPositionParams) => PortalPosition;
+export type ResolveDropdownDirectionParams = 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<{
+export declare const resolveDropdownDirection: ({ anchorRect, panelHeight, viewportHeight, gap, }: ResolveDropdownDirectionParams) => PortalDirection;
+export type BuildPortalPanelStyleParams = Readonly<{
     anchorRect: AnchorRect;
     panelHeight: number;
     panelWidth: number | null;
@@ -42,18 +42,15 @@ export type PortalPanelStyle = Readonly<{
     zIndex: number;
     minWidth?: number;
 }>;
-export declare const buildPortalPanelStyle: ({ anchorRect, panelHeight, panelWidth, direction, align, offset, matchAnchorWidth, }: BuildPortalPanelStyleInput) => PortalPanelStyle;
-export type AnchorGeometryObserverOptions = Readonly<{
+export declare const buildPortalPanelStyle: ({ anchorRect, panelHeight, panelWidth, direction, align, offset, matchAnchorWidth, }: BuildPortalPanelStyleParams) => PortalPanelStyle;
+export type ObserveAnchorGeometryParams = Readonly<{
     getAnchor: () => HTMLElement | null;
-    /**
-     * 구독 시점에 1회 호출되어 ResizeObserver 가 부착된다.
-     * 구독 후 패널이 교체·마운트되어도 옵저버는 갱신되지 않는다.
-     */
+    /** ResizeObserver 는 구독 시점의 패널에만 부착된다 — 이후 교체·마운트되어도 옵저버는 갱신되지 않는다. */
     getPanel: () => HTMLElement | null;
     onChange: () => void;
 }>;
-export declare const observeAnchorGeometry: ({ getAnchor, getPanel, onChange, }: AnchorGeometryObserverOptions) => (() => void);
-export type TrackPortalPositionOptions = Readonly<{
+export declare const observeAnchorGeometry: ({ getAnchor, getPanel, onChange }: ObserveAnchorGeometryParams) => (() => void);
+export type TrackPortalPositionParams = Readonly<{
     getAnchor: () => HTMLElement | null;
     getPanel: () => HTMLElement | null;
     /** 함수를 넘기면 갱신마다 다시 읽는다 — 열린 뒤 패널 높이가 변하는 소비자가 방향을 재판정할 수 있다 */
@@ -63,5 +60,5 @@ export type TrackPortalPositionOptions = Readonly<{
     matchAnchorWidth?: boolean;
     onUpdate: (style: PortalPanelStyle) => void;
 }>;
-export declare const trackPortalPosition: ({ onUpdate, ...measureOptions }: TrackPortalPositionOptions) => (() => void);
+export declare const trackPortalPosition: ({ onUpdate, ...measureOptions }: TrackPortalPositionParams) => (() => void);
 export declare const applyPortalPanelStyle: (element: HTMLElement, style: PortalPanelStyle) => void;

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

@@ -67,6 +67,9 @@
   --shadow-xs-focused-3px-primary-100: 0px 1px 2px 0px #1018280d, 0px 0px 0px 3px #ffeaee;
   --shadow-xs-focused-3px-gray-100: 0px 1px 2px 0px #1018280d, 0px 0px 0px 3px #f2f4f7;
   --shadow-xs-focused-3px-error-100: 0px 1px 2px 0px #1018280d, 0px 0px 0px 3px #fee4e2;
+  --shadow-xs-focused-4px-primary-100: 0px 1px 2px 0px #1018280d, 0px 0px 0px 4px #ffeaee;
+  --shadow-xs-focused-4px-gray-100: 0px 1px 2px 0px #1018280d, 0px 0px 0px 4px #f2f4f7;
+  --shadow-xs-focused-4px-error-100: 0px 1px 2px 0px #1018280d, 0px 0px 0px 4px #fee4e2;
   --shadow-sm: 0px 1px 3px 0px #1018281a, 0px 1px 2px 0px #1018280f;
   --shadow-sm-focused-4px-primary-100: 0px 1px 2px 0px #1018280d, 0px 0px 0px 4px #ffeaee;
   --shadow-sm-focused-4px-gray-100: 0px 1px 3px 0px #1018281a, 0px 1px 2px 0px #1018280f, 0px 0px 0px 4px #f2f4f7;
@@ -324,7 +327,7 @@ button {
   background-color: var(--primary-red-450);
   border: 1px solid var(--primary-red-500);
   color: var(--base-white);
-  box-shadow: var(--shadow-sm-focused-4px-primary-100);
+  box-shadow: var(--shadow-xs-focused-4px-primary-100);
 }
 .ncua-btn--primary:disabled, .ncua-btn--primary.is-disable {
   background-color: var(--primary-red-100);
@@ -370,7 +373,7 @@ button {
   background-color: var(--base-white);
   border: 1px solid var(--gray-200);
   color: var(--gray-700);
-  box-shadow: var(--shadow-sm-focused-4px-gray-100);
+  box-shadow: var(--shadow-xs-focused-4px-gray-100);
 }
 .ncua-btn--secondary-gray:disabled, .ncua-btn--secondary-gray.is-disable {
   background-color: var(--base-white);
@@ -956,7 +959,7 @@ button {
 }
 .ncua-checkbox-input.destructive :where(input):focus {
   border-color: var(--primary-red-600);
-  box-shadow: var(--shadow-sm-focused-4px-error-100);
+  box-shadow: var(--shadow-xs-focused-4px-error-100);
 }
 .ncua-checkbox-input:hover {
   border-color: var(--gray-600);
@@ -1739,7 +1742,7 @@ button {
   border-color: var(--primary-red-600);
 }
 .ncua-input.destructive:where(:focus-within) .ncua-input__field {
-  box-shadow: var(--shadow-sm-focused-4px-error-100);
+  box-shadow: var(--shadow-xs-focused-4px-error-100);
 }
 .ncua-input.is-disabled .ncua-input__content > :not(button) {
   background-color: var(--gray-50);
@@ -1929,7 +1932,7 @@ button {
   border-color: var(--primary-red-600);
 }
 .ncua-input--textarea.destructive textarea:focus {
-  box-shadow: var(--shadow-sm-focused-4px-error-100);
+  box-shadow: var(--shadow-xs-focused-4px-error-100);
 }
 
 .ncua-input--textarea--xs textarea {
@@ -3191,7 +3194,7 @@ button {
 }
 .ncua-radio-input.destructive :where(input):focus {
   border-color: var(--primary-red-600);
-  box-shadow: var(--shadow-sm-focused-4px-error-100);
+  box-shadow: var(--shadow-xs-focused-4px-error-100);
 }
 
 .ncua-radio-field {
@@ -3693,7 +3696,7 @@ button {
   border-color: var(--primary-red-600);
 }
 .ncua-select.destructive .ncua-select__content:focus-within {
-  box-shadow: var(--shadow-sm-focused-4px-error-100);
+  box-shadow: var(--shadow-xs-focused-4px-error-100);
 }
 .ncua-select--xs .ncua-select__content {
   height: var(--select-height-xs);
@@ -4034,7 +4037,7 @@ button {
   border-color: var(--primary-red-600);
 }
 .ncua-selectbox.destructive .ncua-selectbox__content:focus {
-  box-shadow: var(--shadow-sm-focused-4px-error-100);
+  box-shadow: var(--shadow-xs-focused-4px-error-100);
 }
 .ncua-selectbox--xs .ncua-selectbox__content {
   height: var(--select-height-xs);
@@ -5337,16 +5340,15 @@ button {
   justify-content: center;
   color: var(--pink-600);
   background-color: var(--pink-200);
+  border-radius: 5px;
 }
 .ncua-badge--new-badge-sm {
   width: 16px;
   height: 16px;
-  border-radius: 3px;
 }
 .ncua-badge--new-badge-md {
   width: 20px;
   height: 20px;
-  border-radius: 4px;
 }
 
 .ncua-badge-group {
@@ -6608,7 +6610,7 @@ button {
   bottom: 0;
   width: 3px;
   background: var(--base-black);
-  z-index: var(--z-index-1);
+  z-index: 1;
 }
 .ncua-table__row--warning.ncua-table__row--selected:nth-child(n) {
   background: var(--orange-50);
@@ -6753,7 +6755,7 @@ button {
 .ncua-table--fixed-header .ncua-table__header-cell {
   position: sticky;
   top: 0;
-  z-index: var(--z-index-sticky);
+  z-index: 10;
   padding: 0 var(--spacing-m);
   height: var(--ncua-table-header-height);
 }

package/package.json

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