@ncds/ui-admin 1.8.20 → 1.8.21-alpha.1

package/dist/esm/src/components/forms-and-input/input-base/__tests__/InputBase.test.js

@@ -1,4 +1,5 @@
 // @vitest-environment jsdom
+import { SearchLg } from '@ncds/ui-admin-icon';
 import { createElement } from 'react';
 import { createRoot } from 'react-dom/client';
 import { act } from 'react-dom/test-utils';
@@ -66,4 +67,115 @@ describe('InputBase — clearText prop DOM 누출', () => {
     expect(view.container.querySelector('.ncua-input__clear')).toBeNull();
     view.unmount();
   });
+});
+describe('InputBase — 아이콘 사이즈', () => {
+  const iconSizeOf = (container, selector) => {
+    const svg = container.querySelector(selector);
+    return {
+      width: svg?.getAttribute('width'),
+      height: svg?.getAttribute('height')
+    };
+  };
+  // 슬롯 아이콘과 상태 아이콘은 같은 크기를 쓴다 — 과거 상태 아이콘만 sm=16으로 어긋나 있었다
+  it.each([['xs', '14'], ['sm', '20']])('size=%s 일 때 슬롯 아이콘과 상태 아이콘이 모두 %spx로 렌더된다', (size, expected) => {
+    // Given/When: 슬롯 아이콘과 clear 버튼, destructive 상태를 함께 렌더하면
+    const view = mountInputBase({
+      size,
+      destructive: true,
+      clearText: true,
+      onClearText: vi.fn(),
+      leadingElement: {
+        type: 'icon',
+        icon: SearchLg
+      }
+    });
+    // Then: 슬롯·clear·destructive 아이콘의 크기가 서로 어긋나지 않는다
+    const expectedSize = {
+      width: expected,
+      height: expected
+    };
+    expect(iconSizeOf(view.container, '.ncua-input__left-icon')).toEqual(expectedSize);
+    expect(iconSizeOf(view.container, '.ncua-input__clear-icon')).toEqual(expectedSize);
+    expect(iconSizeOf(view.container, '.ncua-input__destructive-icon')).toEqual(expectedSize);
+    view.unmount();
+  });
+  it.each([['xs', '14'], ['sm', '20']])('size=%s 일 때 validation 아이콘도 %spx로 렌더된다', (size, expected) => {
+    // Given/When: validation 상태로 렌더하면
+    const view = mountInputBase({
+      size,
+      validation: true
+    });
+    // Then: 다른 아이콘과 같은 크기다
+    expect(iconSizeOf(view.container, '.ncua-input__validation-icon')).toEqual({
+      width: expected,
+      height: expected
+    });
+    view.unmount();
+  });
+  it('slot.size를 직접 주면 기본 사이즈보다 우선한다', () => {
+    // Given/When: 슬롯에 size를 명시해 렌더하면
+    const view = mountInputBase({
+      size: 'xs',
+      leadingElement: {
+        type: 'icon',
+        icon: SearchLg,
+        size: 24
+      }
+    });
+    // Then: 기본값(14)이 아니라 명시한 값이 적용된다
+    expect(iconSizeOf(view.container, '.ncua-input__left-icon')).toEqual({
+      width: '24',
+      height: '24'
+    });
+    view.unmount();
+  });
+});
+describe('InputBase — has-value 상태 클래스', () => {
+  const typeInto = (container, text) => {
+    const input = container.querySelector('input');
+    if (!input) throw new Error('input이 렌더되지 않았습니다');
+    act(() => {
+      input.value = text;
+      input.dispatchEvent(new Event('input', {
+        bubbles: true
+      }));
+    });
+  };
+  it('값이 비어 있으면 has-value가 붙지 않는다', () => {
+    // Given/When: 빈 상태로 렌더하면
+    const view = mountInputBase();
+    // Then: 루트에 has-value가 없다
+    expect(view.container.querySelector('.ncua-input')?.classList.contains('has-value')).toBe(false);
+    view.unmount();
+  });
+  // props.value 로 판정하면 uncontrolled 에서 영원히 빈 값으로 보인다 — 자물쇠 아이콘 색상이 반영되지 않던 원인
+  it('uncontrolled Input에 입력하면 has-value가 붙는다', () => {
+    // Given: value를 넘기지 않은 uncontrolled 상태에서
+    const view = mountInputBase();
+    // When: 실제로 입력하면
+    typeInto(view.container, 'hello');
+    // Then: has-value가 붙는다
+    expect(view.container.querySelector('.ncua-input')?.classList.contains('has-value')).toBe(true);
+    view.unmount();
+  });
+  it('입력값을 지우면 has-value가 떨어진다', () => {
+    // Given: 값이 있는 상태에서
+    const view = mountInputBase();
+    typeInto(view.container, 'hello');
+    // When: 값을 비우면
+    typeInto(view.container, '');
+    // Then: has-value가 사라진다
+    expect(view.container.querySelector('.ncua-input')?.classList.contains('has-value')).toBe(false);
+    view.unmount();
+  });
+  it('controlled Input은 value prop만으로도 has-value가 붙는다', () => {
+    // Given/When: value를 직접 넘겨 렌더하면 (input 이벤트 없이)
+    const view = mountInputBase({
+      value: 'preset',
+      onChange: vi.fn()
+    });
+    // Then: has-value가 붙는다
+    expect(view.container.querySelector('.ncua-input')?.classList.contains('has-value')).toBe(true);
+    view.unmount();
+  });
 });

package/dist/esm/src/components/forms-and-input/password-input/PasswordInput.js

@@ -27,7 +27,8 @@ export const PasswordInput = /*#__PURE__*/forwardRef((_ref, ref) => {
     leadingElement: {
       type: 'icon',
       icon: Lock01,
-      color: props.value ? 'gray600' : 'gray300'
+      // 색은 CSS가 결정한다 — 여기서 props.value로 판정하면 uncontrolled Input에서 영원히 빈 값 취급된다
+      className: 'ncua-input__password-lock-icon'
     },
     trailingElement: {
       type: 'custom',

package/dist/esm/src/components/index.js

@@ -39,6 +39,7 @@ export * from './image-and-icons/featured-icon';
 export * from './layout/block-container';
 export * from './layout/block-header';
 export * from './layout/divider';
+export * from './layout/ncua-scope';
 export * from './layout/page-title';
 // Navigation
 export * from './navigation/bread-crumb';

package/dist/esm/src/components/layout/ncua-scope/NcuaScope.js

@@ -0,0 +1,67 @@
+'use client';
+
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import classnames from 'classnames';
+import { createContext, forwardRef, version as reactVersion, useContext } from 'react';
+import { NCUA_SCOPED_CSS } from '../../../generated/scoped-css';
+// 조상에 NcuaScope 가 이미 있으면 스타일을 다시 심지 않는다 (중첩 대응).
+const NcuaStyleMountedContext = /*#__PURE__*/createContext(false);
+// React 19 는 <style> 에 href·precedence 가 함께 있으면 <head> 로 올리고 href 로 중복을
+// 제거한다. 18 에는 그 기능도, 두 prop 의 타입 정의도 없어 Context 로 중첩만 막고
+// 타입은 우회한다.
+const STYLE_HOISTING_MIN_REACT_MAJOR = 19;
+const DECIMAL_RADIX = 10;
+const SUPPORTS_STYLE_HOISTING = Number.parseInt(reactVersion, DECIMAL_RADIX) >= STYLE_HOISTING_MIN_REACT_MAJOR;
+const STYLE_KEY = 'ncua-scoped';
+const STYLE_HOISTING_PROPS = {
+  href: STYLE_KEY,
+  precedence: 'default'
+};
+/**
+ * NCUA 스타일을 이 엘리먼트 하위로 한정하는 경계.
+ *
+ * 다른 디자인 시스템을 전역 적용한 사용처에서 NCUA 컴포넌트를 이걸로 감싼다.
+ * 스타일을 직접 들고 있으므로 **CSS 파일을 따로 import 하지 않는다.**
+ *
+ * ```tsx
+ * import { NcuaScope, Button } from '@ncds/ui-admin';
+ *
+ * <NcuaScope>
+ *   <Button label="신청하기" hierarchy="primary" size="md" />
+ * </NcuaScope>
+ * ```
+ *
+ * `document.body` 로 portal 되는 컴포넌트(Modal · Tooltip · Dropdown · SelectBox ·
+ * Notification)는 이 경계 밖에 놓이지만, 스코프 스타일시트가 그 루트 클래스들을 함께
+ * 지정하므로 토큰을 받는다 (`base/_scope.scss` 의 `$roots`). portal 목적지는 바뀌지
+ * 않으므로 어드민에서의 기존 동작과 같다.
+ *
+ * 어드민처럼 `style.css` 를 전역 적용하는 사용처는 이 컴포넌트가 필요 없다.
+ *
+ * 중첩해서 써도 스타일은 한 번만 들어간다. React 19 에서는 형제로 여러 개를 써도
+ * href 기준으로 중복이 제거된다. React 18 에서는 형제마다 `<style>` 이 하나씩 생기므로,
+ * 스코프가 여러 곳에 필요하면 공통 조상 한 곳에서 감싸는 편이 낫다.
+ */
+export const NcuaScope = /*#__PURE__*/forwardRef((_ref, ref) => {
+  let {
+    className,
+    children
+  } = _ref;
+  const styleAlreadyMounted = useContext(NcuaStyleMountedContext);
+  const shouldRenderStyle = SUPPORTS_STYLE_HOISTING || !styleAlreadyMounted;
+  return _jsxs(NcuaStyleMountedContext.Provider, {
+    value: true,
+    children: [shouldRenderStyle && (SUPPORTS_STYLE_HOISTING ? _jsx("style", {
+      ...STYLE_HOISTING_PROPS,
+      children: NCUA_SCOPED_CSS
+    }) : _jsx("style", {
+      "data-ncua-scope": STYLE_KEY,
+      children: NCUA_SCOPED_CSS
+    })), _jsx("div", {
+      ref: ref,
+      className: classnames('ncua-scope', className),
+      children: children
+    })]
+  });
+});
+NcuaScope.displayName = 'NcuaScope';

package/dist/esm/src/components/layout/ncua-scope/index.js

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