@bestow-ui/react 1.0.0 → 1.2.0

package/README.md

@@ -50,7 +50,9 @@ function SaveButton() {
 }
 ```
 
-With the Next.js App Router, put the providers in a `'use client'` file and wrap them in `app/layout.tsx`. See the [Introduction](https://dev-bestow.github.io/BestOW-UI/) page for the full setup.
+With the Next.js App Router, put the providers in a `'use client'` file and wrap them in `app/layout.tsx`. Components can be rendered from Server Components — display components without state (`Typography`, `Stack`, `Card`, `Badge`, `Divider`, `Progress`, `Skeleton`) render as Server Components themselves (no client JS) — and plain functions and values (`createTheme`, `createIntentColors`, `vars`, `formatKoreanAmount`, …) can be called there directly. See the [Introduction](https://dev-bestow.github.io/BestOW-UI/) page for the full setup.
+
+Upgrading from 0.x? See the [migration guide](https://github.com/Dev-BestOW/BestOW-UI/blob/main/docs/MIGRATION-1.0.md).
 
 ## Dark mode
 
@@ -100,10 +102,10 @@ import { LocaleProvider, en } from '@bestow-ui/react';
 | Layout | `Stack`, `Divider`, `Card` |
 | Typography | `Typography` |
 | Actions | `Button`, `IconButton`, `Link` |
-| Forms | `Input`, `TextField`, `Textarea`, `Select`, `Combobox`, `Checkbox`, `RadioGroup`, `Switch`, `Slider` |
+| Forms | `Input`, `TextField`, `Textarea`, `Select`, `Combobox`, `NumberInput`, `Checkbox`, `RadioGroup`, `Switch`, `Slider` |
 | Feedback | `Alert`, `Progress`, `ToastProvider` + `useToast`, `Spinner`, `Skeleton`, `Badge` |
 | Overlays | `Modal`, `Drawer`, `Popover`, `Tooltip`, `DropdownMenu` |
-| Navigation | `Tabs`, `Accordion`, `Pagination`, `Breadcrumb` |
+| Navigation | `Tabs`, `SegmentedControl`, `Accordion`, `Pagination`, `Breadcrumb`, `SkipLink` |
 | Display | `Avatar`, `Table` |
 | Korean kit | `AgreementGroup` (약관 동의), `VerificationCodeInput` (인증번호), `PhoneNumberInput`, `BusinessNumberInput`, `AmountInput`, `AddressInput`, `DatePicker`, `Calendar` (+ `formatPhoneNumber`, `formatBusinessNumber`, `isValidBusinessNumber`, `formatKoreanAmount`, `formatKoreanDate`, `parseISODate`, `toISODate`) |
 | Locale | `LocaleProvider`, `en` (English messages) |

package/dist/{chunk-PFEZ3D2H.js → chunk-LHT64JDG.js}

@@ -185,7 +185,13 @@ function formatKoreanDate(date, withWeekday = true) {
   return withWeekday ? `${base} ${KOREAN_WEEKDAYS[date.getDay()]}\uC694\uC77C` : base;
 }
 
+// src/utils/cx.ts
+function cx(...classNames) {
+  return classNames.filter(Boolean).join(" ");
+}
+
 export {
+  cx,
   themeClass,
   vars,
   createTheme,
@@ -209,4 +215,4 @@ export {
   KOREAN_WEEKDAYS,
   formatKoreanDate
 };
-//# sourceMappingURL=chunk-PFEZ3D2H.js.map
+//# sourceMappingURL=chunk-LHT64JDG.js.map

package/dist/chunk-LHT64JDG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/theme/contract.css.ts","../src/theme/createTheme.ts","../src/components/AddressInput/addressProviders.ts","../src/utils/koreanFormat.ts","../src/utils/date.ts","../src/utils/cx.ts"],"sourcesContent":["import 'src/theme/contract.css.ts.vanilla.css?source=#H4sIAAAAAAAAA-2XXYvbOBSG7_srDpmbLdiDJX8kVq-2LF3YpWXpQO9lW8qY2laQ7E6mS__7IsdxEufIE7YsDKyHmYTJeXWk8-rI0cO0Ui38_QbA9zNhWvXkmx3PhR8wCN5df0wYRLs9EqAMNmggZEAoGokYkASNxAxogEYSBhRfwIZBiM9DAgYRno5QBhG-bpIwSKZTaV6UnfEb1YipP0PI1NcODaG6uPZoCFVbxKUhtq8Qn4aY7KqKQZqm6SQuVdP6ktdl9ewb3hgGq7-0aEVTcF3AF65LnlVi5cHpUw98vttVwjfPphW1B--rsvn6kecP_f8fVNN6cIj5XenB6lerhoff4HfVPpY5fBJq5cHqk2oVPPDGwJ-fVx7Y2X0jdCmdC6xVoxis_hDte83LxsBH1dhUXdmH-v3w4OGD_dj_LLZdxbUHH0VTKQ9GxXV6U34X_t4g1p7Cdr_IdMNOYbtnV-afwv2-Tff0bO4KaeRTmPZx9-ShjYfu8VEfR1f3JMrtY-vrg1m2_wOnqBZF2dUM4hmNEXWZqapgkMyoDoo1pqjKRviPB1lrXxmQexrPCxula27b__4FoRYV3wu7V_frS2nRad6WqvElN3ZOGtQGFxwno4FTYir1ZB8zU8F3v2wKsfcLrXaFemoYkGBiwlGivgld8WcGJHQoalX0NYcEj7fqUMl0S09xVbXljgGZbmiuKqX9bOsXQvKuahncyf4HV5kuaythRRuZSo6L6q61vt9JIkMZ45qy-Sa0sZkooTFNcdXojN5m_JfAg-H3PorfIiPkeRnOvPK0wiiNg3iNa8ZSkyQR6wQXncpwu6Z0IfTZwgohqMDyDUrTatVsGdzxIouzwi2UKu8Mg7swS6TEEu50WXP97BtVlbZcGseRyF4S-o_WdgZ3pIhosZmR56ppdd957vLH1Ec7hZDRDcpxFUUmEilm9K3Yt3OrbUTXal6NLoRRyCPsFFwIx_mdfXSU3-LCmHo8P66zcakcVyFSkYu5zIMLzuIK3mxtcw0mFDlNKNYz57px9iwlOcnd6lssOCYeHRCSSvqScFyCtKdmRj7U71yp6fJcGDMaQOJNEGKH60J4OgtJEofRjPwWC8bUoweBLORc1ulZyGUusOfVUX88C67inrhuymY7uiDjVATYE-FCeJo_Xa8DrGuO8jMXnOdmTD26IGWGPpYulWetIMMcc-GoH1xIaRQEl08O88gL-1YzCIDs9kB3-6svlyB5iw2y977AXuT7u-P1qA06yl4Hg8OIEBtG6Nt3b368uW-_8m2bBQt3Ldy1cNfCXQt3Ldy1cNfCXQt3Ldy1cNfCXQt3_afcRRbuWrhr4a6Fuxbu-t9xF0nIhmBfg-fcNUdLR6px3gEvuGuO4JzclbzMXc68Z9zlRKBz7nLij7wNH6fc5YS9f8tdSZAGaKWvkbv6nYxTDwghHtAo6S8fCbadOIihCehsguM9LMwiifk5JbMXIefSpxcZ6pbb6JTM-jJpHHtwerm-3M2xGp6BRHMZBqecFb02ejvUGKYeJJvDn6uZUJrDhuOtdEl3Mucxx_x5jXTXFxlGHpB07UEauT3CaQ8bj5s0ob9NIiTH9vsn6U9mmaSYSz9Df4dWiGIPSLyxDxe3TTgOoglwnyZ8KPMijC6b5CY-jGfwMBjGOR8j3hxD4pkPCDmfmfSJ3Zhp_fjxD9z9vDBSKQAA';\nexport var themeClass = {light:'tkagtb0',dark:'tkagtb1'};\nexport var vars = {space:{'0':'var(--bestow-space-0)','1':'var(--bestow-space-1)','2':'var(--bestow-space-2)','3':'var(--bestow-space-3)','4':'var(--bestow-space-4)','5':'var(--bestow-space-5)','6':'var(--bestow-space-6)','8':'var(--bestow-space-8)','10':'var(--bestow-space-10)','12':'var(--bestow-space-12)','16':'var(--bestow-space-16)'},radius:{none:'var(--bestow-radius-none)',sm:'var(--bestow-radius-sm)',md:'var(--bestow-radius-md)',lg:'var(--bestow-radius-lg)',xl:'var(--bestow-radius-xl)',full:'var(--bestow-radius-full)'},font:{family:{sans:'var(--bestow-font-family-sans)',mono:'var(--bestow-font-family-mono)'},size:{xs:'var(--bestow-font-size-xs)',sm:'var(--bestow-font-size-sm)',md:'var(--bestow-font-size-md)',lg:'var(--bestow-font-size-lg)',xl:'var(--bestow-font-size-xl)','2xl':'var(--bestow-font-size-2xl)','3xl':'var(--bestow-font-size-3xl)','4xl':'var(--bestow-font-size-4xl)'},weight:{regular:'var(--bestow-font-weight-regular)',medium:'var(--bestow-font-weight-medium)',semibold:'var(--bestow-font-weight-semibold)',bold:'var(--bestow-font-weight-bold)'},lineHeight:{tight:'var(--bestow-font-line-height-tight)',normal:'var(--bestow-font-line-height-normal)',relaxed:'var(--bestow-font-line-height-relaxed)'}},duration:{fast:'var(--bestow-duration-fast)',normal:'var(--bestow-duration-normal)',slow:'var(--bestow-duration-slow)'},zIndex:{dropdown:'var(--bestow-z-index-dropdown)',overlay:'var(--bestow-z-index-overlay)',modal:'var(--bestow-z-index-modal)',toast:'var(--bestow-z-index-toast)',tooltip:'var(--bestow-z-index-tooltip)'},color:{bg:{'default':'var(--bestow-color-bg-default)',subtle:'var(--bestow-color-bg-subtle)',muted:'var(--bestow-color-bg-muted)',inverse:'var(--bestow-color-bg-inverse)',overlay:'var(--bestow-color-bg-overlay)'},fg:{'default':'var(--bestow-color-fg-default)',muted:'var(--bestow-color-fg-muted)',subtle:'var(--bestow-color-fg-subtle)',inverse:'var(--bestow-color-fg-inverse)'},border:{'default':'var(--bestow-color-border-default)',strong:'var(--bestow-color-border-strong)',focus:'var(--bestow-color-border-focus)'},primary:{solid:'var(--bestow-color-primary-solid)',solidHover:'var(--bestow-color-primary-solid-hover)',contrast:'var(--bestow-color-primary-contrast)',subtle:'var(--bestow-color-primary-subtle)',subtleHover:'var(--bestow-color-primary-subtle-hover)',text:'var(--bestow-color-primary-text)'},neutral:{solid:'var(--bestow-color-neutral-solid)',solidHover:'var(--bestow-color-neutral-solid-hover)',contrast:'var(--bestow-color-neutral-contrast)',subtle:'var(--bestow-color-neutral-subtle)',subtleHover:'var(--bestow-color-neutral-subtle-hover)',text:'var(--bestow-color-neutral-text)'},danger:{solid:'var(--bestow-color-danger-solid)',solidHover:'var(--bestow-color-danger-solid-hover)',contrast:'var(--bestow-color-danger-contrast)',subtle:'var(--bestow-color-danger-subtle)',subtleHover:'var(--bestow-color-danger-subtle-hover)',text:'var(--bestow-color-danger-text)'},success:{solid:'var(--bestow-color-success-solid)',solidHover:'var(--bestow-color-success-solid-hover)',contrast:'var(--bestow-color-success-contrast)',subtle:'var(--bestow-color-success-subtle)',subtleHover:'var(--bestow-color-success-subtle-hover)',text:'var(--bestow-color-success-text)'},warning:{solid:'var(--bestow-color-warning-solid)',solidHover:'var(--bestow-color-warning-solid-hover)',contrast:'var(--bestow-color-warning-contrast)',subtle:'var(--bestow-color-warning-subtle)',subtleHover:'var(--bestow-color-warning-subtle-hover)',text:'var(--bestow-color-warning-text)'}},shadow:{sm:'var(--bestow-shadow-sm)',md:'var(--bestow-shadow-md)',lg:'var(--bestow-shadow-lg)'}};","import { assignInlineVars } from '@vanilla-extract/dynamic';\nimport { vars, type ThemeName, type ThemeTokens } from './contract.css';\n\nexport type DeepPartial<T> = { [K in keyof T]?: T[K] extends string ? string : DeepPartial<T[K]> };\n\nexport type ThemeOverrides = DeepPartial<ThemeTokens>;\n\n/** createTheme 에 넘기는 입력. common 은 라이트·다크 공통, light/dark 는 모드별 값 (common 보다 우선). */\nexport interface ThemeInput {\n  common?: ThemeOverrides;\n  light?: ThemeOverrides;\n  dark?: ThemeOverrides;\n}\n\n/** createTheme 의 결과. ThemeProvider 의 overrides 로 넘긴다. */\nexport interface BestowTheme {\n  readonly light: ThemeOverrides;\n  readonly dark: ThemeOverrides;\n}\n\ntype Tree = { [key: string]: string | Tree };\n\nfunction deepMerge(target: Tree, source: Tree | undefined): Tree {\n  if (!source) return target;\n  const out: Tree = { ...target };\n  for (const [key, value] of Object.entries(source)) {\n    if (value === undefined) continue;\n    const prev = out[key];\n    out[key] = typeof value === 'object' && typeof prev === 'object' ? deepMerge(prev, value) : value;\n  }\n  return out;\n}\n\n/**\n * 브랜드 테마를 만든다. 여러 입력을 넘기면 순서대로 깊게 병합한다 (뒤가 우선).\n *\n * @example\n * const brand = createTheme(\n *   createIntentColors('primary', '#7c3aed'),\n *   { common: { radius: { md: '6px' }, font: { family: { sans: 'Inter, sans-serif' } } } },\n * );\n * <ThemeProvider theme=\"dark\" overrides={brand}>…</ThemeProvider>\n */\nexport function createTheme(...inputs: ThemeInput[]): BestowTheme {\n  let light: Tree = {};\n  let dark: Tree = {};\n  for (const input of inputs) {\n    light = deepMerge(deepMerge(light, input.common as Tree), input.light as Tree);\n    dark = deepMerge(deepMerge(dark, input.common as Tree), input.dark as Tree);\n  }\n  return Object.freeze({ light, dark }) as BestowTheme;\n}\n\n/** 두 테마를 병합한다 (b 가 우선). 중첩 ThemeProvider 가 바깥 테마를 이어받을 때 쓴다. */\nexport function mergeThemes(a: BestowTheme | undefined, b: BestowTheme | undefined): BestowTheme | undefined {\n  if (!a) return b;\n  if (!b) return a;\n  return createTheme(a, b);\n}\n\n/** 부분 토큰을 { 'var(--bestow-…)': 값 } 으로 펼친다. 알 수 없는 키는 무시한다. */\nfunction flatten(partial: Tree, contract: Tree, out: Record<string, string>) {\n  for (const [key, value] of Object.entries(partial)) {\n    const target = contract[key];\n    if (target === undefined) continue;\n    if (typeof target === 'string' && typeof value === 'string') out[target] = value;\n    else if (typeof target === 'object' && typeof value === 'object') flatten(value, target, out);\n  }\n  return out;\n}\n\n/** 현재 모드의 오버라이드를 인라인 style 로 바꾼다. */\nexport function themeToStyle(theme: BestowTheme | undefined, mode: ThemeName): Record<string, string> | undefined {\n  if (!theme) return undefined;\n  const map = flatten(theme[mode] as Tree, vars as unknown as Tree, {});\n  return Object.keys(map).length ? assignInlineVars(map) : undefined;\n}\n","/** 주소 검색 결과 */\nexport interface AddressSearchResult {\n  /** 우편번호 (5자리 국가기초구역번호) */\n  zonecode: string;\n  /** 기본 주소 (도로명 또는 지번) */\n  address: string;\n  /** 참고 항목 (도로명 주소일 때 법정동·건물명, 예: \" (역삼동, 래미안아파트)\") */\n  extraAddress?: string;\n}\n\n/**\n * 주소 검색 공급자. container 안에 검색 화면을 그리고, 사용자가 고르면 onSelect 를 부른다.\n * 정리 함수를 돌려주면 검색 창이 닫힐 때 부른다. 다른 주소 서비스(행정안전부 도로명주소 API 등)로 바꿔 끼울 수 있다.\n */\nexport type AddressProvider = (\n  container: HTMLElement,\n  onSelect: (result: AddressSearchResult) => void,\n) => void | (() => void) | Promise<void | (() => void)>;\n\n// 카카오 우편번호 서비스 (https://postcode.map.kakao.com/guide)\nconst KAKAO_POSTCODE_SRC = 'https://t1.kakaocdn.net/mapjsapi/bundle/postcode/prod/postcode.v2.js';\n\ninterface KakaoPostcodeData {\n  zonecode: string;\n  userSelectedType: 'R' | 'J';\n  roadAddress: string;\n  jibunAddress: string;\n  autoJibunAddress?: string;\n  bname: string;\n  buildingName: string;\n  apartment: 'Y' | 'N';\n}\n\ntype PostcodeConstructor = new (options: {\n  oncomplete: (data: KakaoPostcodeData) => void;\n  width?: string | number;\n  height?: string | number;\n}) => { embed: (element: HTMLElement) => void };\n\ninterface PostcodeWindow {\n  kakao?: { Postcode?: PostcodeConstructor };\n  daum?: { Postcode?: PostcodeConstructor };\n}\n\nlet loading: Promise<PostcodeConstructor> | null = null;\n\nfunction loadKakaoPostcode(): Promise<PostcodeConstructor> {\n  const w = window as unknown as PostcodeWindow;\n  const existing = w.kakao?.Postcode ?? w.daum?.Postcode;\n  if (existing) return Promise.resolve(existing);\n  loading ??= new Promise<PostcodeConstructor>((resolve, reject) => {\n    const script = document.createElement('script');\n    script.src = KAKAO_POSTCODE_SRC;\n    script.async = true;\n    script.onload = () => {\n      const ctor = w.kakao?.Postcode ?? w.daum?.Postcode;\n      if (ctor) resolve(ctor);\n      else reject(new Error('우편번호 서비스를 찾지 못했어요'));\n    };\n    script.onerror = () => {\n      loading = null; // 다음에 다시 시도할 수 있게\n      reject(new Error('우편번호 서비스를 불러오지 못했어요'));\n    };\n    document.head.appendChild(script);\n  });\n  return loading;\n}\n\n/** 카카오 가이드의 방식으로 도로명 주소의 참고 항목(법정동, 공동주택 건물명)을 만든다 */\nexport function composeExtraAddress(\n  data: Pick<KakaoPostcodeData, 'userSelectedType' | 'bname' | 'buildingName' | 'apartment'>,\n) {\n  if (data.userSelectedType !== 'R') return '';\n  const parts: string[] = [];\n  // 법정동명은 \"동·로·가\" 로 끝날 때만 (법정리는 제외)\n  if (data.bname && /[동로가]$/.test(data.bname)) parts.push(data.bname);\n  if (data.buildingName && data.apartment === 'Y') parts.push(data.buildingName);\n  return parts.length ? ` (${parts.join(', ')})` : '';\n}\n\n/**\n * 기본 공급자: 카카오(다음) 우편번호 서비스. 처음 쓸 때 스크립트를 불러오므로 코어 번들 크기에 영향이 없다.\n * 사용 조건은 서비스 가이드를 따른다.\n */\nexport const kakaoPostcodeProvider: AddressProvider = async (container, onSelect) => {\n  const Postcode = await loadKakaoPostcode();\n  new Postcode({\n    width: '100%',\n    height: '100%',\n    oncomplete: (data) => {\n      const address =\n        data.userSelectedType === 'R' ? data.roadAddress : data.jibunAddress || data.autoJibunAddress || '';\n      onSelect({ zonecode: data.zonecode, address, extraAddress: composeExtraAddress(data) });\n    },\n  }).embed(container);\n};\n","// 한국 서비스에서 자주 쓰는 서식·검증 함수. 컴포넌트와 함께 공개 API 로 export 한다.\n\nconst onlyDigits = (input: string) => input.replace(/\\D/g, '');\n\n/** 전화번호 최대 자릿수: 02 는 10, 15xx·16xx·18xx 대표번호는 8, 나머지(010, 031, 070 …)는 11 */\nexport function phoneNumberMaxDigits(digits: string): number {\n  if (digits.startsWith('02')) return 10;\n  if (/^1[568]/.test(digits)) return 8;\n  return 11;\n}\n\n/**\n * 숫자만 있는 전화번호에 하이픈을 넣는다. 입력 중인 값도 자연스럽게 나눈다.\n * @example formatPhoneNumber('01012345678') // '010-1234-5678'\n * @example formatPhoneNumber('021234567')   // '02-123-4567'\n * @example formatPhoneNumber('15881234')    // '1588-1234'\n */\nexport function formatPhoneNumber(input: string): string {\n  const d = onlyDigits(input).slice(0, phoneNumberMaxDigits(onlyDigits(input)));\n  if (d.startsWith('02')) {\n    if (d.length <= 2) return d;\n    if (d.length <= 5) return `${d.slice(0, 2)}-${d.slice(2)}`;\n    if (d.length <= 9) return `${d.slice(0, 2)}-${d.slice(2, 5)}-${d.slice(5)}`;\n    return `${d.slice(0, 2)}-${d.slice(2, 6)}-${d.slice(6)}`;\n  }\n  if (/^1[568]/.test(d)) {\n    return d.length <= 4 ? d : `${d.slice(0, 4)}-${d.slice(4)}`;\n  }\n  if (d.length <= 3) return d;\n  if (d.length <= 6) return `${d.slice(0, 3)}-${d.slice(3)}`;\n  if (d.length <= 10) return `${d.slice(0, 3)}-${d.slice(3, 6)}-${d.slice(6)}`;\n  return `${d.slice(0, 3)}-${d.slice(3, 7)}-${d.slice(7)}`;\n}\n\n/**\n * 사업자등록번호(10자리)에 하이픈을 넣는다.\n * @example formatBusinessNumber('1234567890') // '123-45-67890'\n */\nexport function formatBusinessNumber(input: string): string {\n  const d = onlyDigits(input).slice(0, 10);\n  if (d.length <= 3) return d;\n  if (d.length <= 5) return `${d.slice(0, 3)}-${d.slice(3)}`;\n  return `${d.slice(0, 3)}-${d.slice(3, 5)}-${d.slice(5)}`;\n}\n\n/**\n * 사업자등록번호 검증 공식(가중치 1,3,7,1,3,7,1,3,5)으로 확인한다. 실제로 등록된 번호인지는 국세청 조회가 필요하다.\n * @example isValidBusinessNumber('124-81-00998') // true\n */\nexport function isValidBusinessNumber(input: string): boolean {\n  const d = onlyDigits(input);\n  if (d.length !== 10) return false;\n  const weights = [1, 3, 7, 1, 3, 7, 1, 3, 5];\n  const digits = [...d].map(Number);\n  let sum = weights.reduce((acc, w, i) => acc + w * digits[i]!, 0);\n  sum += Math.floor((digits[8]! * 5) / 10);\n  return (10 - (sum % 10)) % 10 === digits[9];\n}\n\n/**\n * 금액을 만·억·조 단위로 읽기 쉽게 쓴다.\n * @example formatKoreanAmount(125000)     // '12만 5,000원'\n * @example formatKoreanAmount(150000000)  // '1억 5,000만원'\n * @example formatKoreanAmount(0)          // '0원'\n */\nexport function formatKoreanAmount(amount: number, unit = '원'): string {\n  const n = Math.floor(Math.abs(amount));\n  if (n === 0) return `0${unit}`;\n  const units = [\n    { value: 1e12, label: '조' },\n    { value: 1e8, label: '억' },\n    { value: 1e4, label: '만' },\n    { value: 1, label: '' },\n  ];\n  let rest = n;\n  const parts: string[] = [];\n  for (const u of units) {\n    const q = Math.floor(rest / u.value);\n    rest %= u.value;\n    if (q > 0) parts.push(`${q.toLocaleString('ko-KR')}${u.label}`);\n  }\n  return `${amount < 0 ? '-' : ''}${parts.join(' ')}${unit}`;\n}\n","// 날짜 계산 유틸. 값은 시간대 문제가 없도록 'YYYY-MM-DD' 문자열로 다루고, 계산할 때만 로컬 Date 로 바꾼다.\n\nconst pad = (n: number) => String(n).padStart(2, '0');\n\n/** Date → 'YYYY-MM-DD' (로컬 기준) */\nexport function toISODate(date: Date): string {\n  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;\n}\n\n/** 'YYYY-MM-DD' → Date (로컬 자정). 형식이 틀리거나 없는 날짜(2월 30일 등)면 null */\nexport function parseISODate(value: string | null | undefined): Date | null {\n  const m = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(value ?? '');\n  if (!m) return null;\n  const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];\n  const date = new Date(y, mo - 1, d);\n  return date.getFullYear() === y && date.getMonth() === mo - 1 && date.getDate() === d ? date : null;\n}\n\nexport function addDays(date: Date, days: number): Date {\n  return new Date(date.getFullYear(), date.getMonth(), date.getDate() + days);\n}\n\n/** 달을 옮긴다. 옮긴 달에 같은 날이 없으면 그 달의 마지막 날 (1월 31일 + 1달 → 2월 28/29일) */\nexport function addMonths(date: Date, months: number): Date {\n  const target = new Date(date.getFullYear(), date.getMonth() + months, 1);\n  const lastDay = new Date(target.getFullYear(), target.getMonth() + 1, 0).getDate();\n  return new Date(target.getFullYear(), target.getMonth(), Math.min(date.getDate(), lastDay));\n}\n\nexport function isSameDay(a: Date | null, b: Date | null): boolean {\n  return !!a && !!b && toISODate(a) === toISODate(b);\n}\n\nexport function isSameMonth(a: Date, b: Date): boolean {\n  return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth();\n}\n\n/** 날짜만 비교 (-1, 0, 1) */\nexport function compareDays(a: Date, b: Date): number {\n  const x = toISODate(a);\n  const y = toISODate(b);\n  return x < y ? -1 : x > y ? 1 : 0;\n}\n\n/** 일요일부터 시작하는 달력의 주 목록 (앞뒤 달 날짜 포함, 항상 6주) */\nexport function getCalendarWeeks(year: number, month: number): Date[][] {\n  const first = new Date(year, month, 1);\n  const start = addDays(first, -first.getDay());\n  return Array.from({ length: 6 }, (_, week) => Array.from({ length: 7 }, (_, day) => addDays(start, week * 7 + day)));\n}\n\nexport const KOREAN_WEEKDAYS = ['일', '월', '화', '수', '목', '금', '토'] as const;\n\n/**\n * 한국어 날짜. 스크린리더용 날짜 이름 등에 쓴다.\n * @example formatKoreanDate(new Date(2026, 9, 15)) // '2026년 10월 15일 목요일'\n */\nexport function formatKoreanDate(date: Date, withWeekday = true): string {\n  const base = `${date.getFullYear()}년 ${date.getMonth() + 1}월 ${date.getDate()}일`;\n  return withWeekday ? `${base} ${KOREAN_WEEKDAYS[date.getDay()]}요일` : base;\n}\n","export function cx(...classNames: Array<string | false | null | undefined>): string {\n  return classNames.filter(Boolean).join(' ');\n}\n"],"mappings":"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","names":["_"]}