@iyulab/components 1.37.0 → 1.38.0

package/dist/react/UMenu.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UMenu as UMenuElement } from '../components/menu/UMenu';
+import { UMenu as UMenuElement } from '@iyulab/components/dist/components/menu/UMenu.js';
 
 export declare const UMenu: React.ForwardRefExoticComponent<
   Omit<Partial<UMenuElement>, keyof React.HTMLAttributes<UMenuElement>>

package/dist/react/UMenu.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UMenu as UMenuElement } from '../components/menu/UMenu.js';
+import { UMenu as UMenuElement } from '@iyulab/components/dist/components/menu/UMenu.js';
 
 export const UMenu = createComponent({
   react: React,

package/dist/react/UMenuItem.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { UMenuItem as UMenuItemElement } from '../components/menu-item/UMenuItem';
-import { type PickEventDetail } from '../events/PickEvent';
+import { UMenuItem as UMenuItemElement } from '@iyulab/components/dist/components/menu-item/UMenuItem.js';
+import { type PickEventDetail } from '@iyulab/components/dist/events/PickEvent.js';
 
 export declare const UMenuItem: React.ForwardRefExoticComponent<
   Omit<Partial<UMenuItemElement>, keyof React.HTMLAttributes<UMenuItemElement>>

package/dist/react/UMenuItem.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UMenuItem as UMenuItemElement } from '../components/menu-item/UMenuItem.js';
+import { UMenuItem as UMenuItemElement } from '@iyulab/components/dist/components/menu-item/UMenuItem.js';
 
 export const UMenuItem = createComponent({
   react: React,

package/dist/react/UOption.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UOption as UOptionElement } from '../components/option/UOption';
+import { UOption as UOptionElement } from '@iyulab/components/dist/components/option/UOption.js';
 
 export declare const UOption: React.ForwardRefExoticComponent<
   Omit<Partial<UOptionElement>, keyof React.HTMLAttributes<UOptionElement>>

package/dist/react/UOption.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UOption as UOptionElement } from '../components/option/UOption.js';
+import { UOption as UOptionElement } from '@iyulab/components/dist/components/option/UOption.js';
 
 export const UOption = createComponent({
   react: React,

package/dist/react/UPanel.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UPanel as UPanelElement } from '../components/panel/UPanel';
+import { UPanel as UPanelElement } from '@iyulab/components/dist/components/panel/UPanel.js';
 
 export declare const UPanel: React.ForwardRefExoticComponent<
   Omit<Partial<UPanelElement>, keyof React.HTMLAttributes<UPanelElement>>

package/dist/react/UPanel.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UPanel as UPanelElement } from '../components/panel/UPanel.js';
+import { UPanel as UPanelElement } from '@iyulab/components/dist/components/panel/UPanel.js';
 
 export const UPanel = createComponent({
   react: React,

package/dist/react/UPopover.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
-import { UPopover as UPopoverElement } from '../components/popover/UPopover';
-import { type ShowEventDetail } from '../events/ShowEvent';
-import { type HideEventDetail } from '../events/HideEvent';
+import { UPopover as UPopoverElement } from '@iyulab/components/dist/components/popover/UPopover.js';
+import { type ShowEventDetail } from '@iyulab/components/dist/events/ShowEvent.js';
+import { type HideEventDetail } from '@iyulab/components/dist/events/HideEvent.js';
 
 export declare const UPopover: React.ForwardRefExoticComponent<
   Omit<Partial<UPopoverElement>, keyof React.HTMLAttributes<UPopoverElement>>

package/dist/react/UPopover.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UPopover as UPopoverElement } from '../components/popover/UPopover.js';
+import { UPopover as UPopoverElement } from '@iyulab/components/dist/components/popover/UPopover.js';
 
 export const UPopover = createComponent({
   react: React,

package/dist/react/UProgressBar.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UProgressBar as UProgressBarElement } from '../components/progress-bar/UProgressBar';
+import { UProgressBar as UProgressBarElement } from '@iyulab/components/dist/components/progress-bar/UProgressBar.js';
 
 export declare const UProgressBar: React.ForwardRefExoticComponent<
   Omit<Partial<UProgressBarElement>, keyof React.HTMLAttributes<UProgressBarElement>>

package/dist/react/UProgressBar.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UProgressBar as UProgressBarElement } from '../components/progress-bar/UProgressBar.js';
+import { UProgressBar as UProgressBarElement } from '@iyulab/components/dist/components/progress-bar/UProgressBar.js';
 
 export const UProgressBar = createComponent({
   react: React,

package/dist/react/UProgressRing.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UProgressRing as UProgressRingElement } from '../components/progress-ring/UProgressRing';
+import { UProgressRing as UProgressRingElement } from '@iyulab/components/dist/components/progress-ring/UProgressRing.js';
 
 export declare const UProgressRing: React.ForwardRefExoticComponent<
   Omit<Partial<UProgressRingElement>, keyof React.HTMLAttributes<UProgressRingElement>>

package/dist/react/UProgressRing.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UProgressRing as UProgressRingElement } from '../components/progress-ring/UProgressRing.js';
+import { UProgressRing as UProgressRingElement } from '@iyulab/components/dist/components/progress-ring/UProgressRing.js';
 
 export const UProgressRing = createComponent({
   react: React,

package/dist/react/URadio.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { URadio as URadioElement } from '../components/radio/URadio';
+import { URadio as URadioElement } from '@iyulab/components/dist/components/radio/URadio.js';
 
 export declare const URadio: React.ForwardRefExoticComponent<
   Omit<Partial<URadioElement>, keyof React.HTMLAttributes<URadioElement>>

package/dist/react/URadio.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { URadio as URadioElement } from '../components/radio/URadio.js';
+import { URadio as URadioElement } from '@iyulab/components/dist/components/radio/URadio.js';
 
 export const URadio = createComponent({
   react: React,

package/dist/react/URating.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { URating as URatingElement } from '../components/rating/URating';
+import { URating as URatingElement } from '@iyulab/components/dist/components/rating/URating.js';
 
 export declare const URating: React.ForwardRefExoticComponent<
   Omit<Partial<URatingElement>, keyof React.HTMLAttributes<URatingElement>>

package/dist/react/URating.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { URating as URatingElement } from '../components/rating/URating.js';
+import { URating as URatingElement } from '@iyulab/components/dist/components/rating/URating.js';
 
 export const URating = createComponent({
   react: React,

package/dist/react/USelect.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { USelect as USelectElement } from '../components/select/USelect';
+import { USelect as USelectElement } from '@iyulab/components/dist/components/select/USelect.js';
 
 export declare const USelect: React.ForwardRefExoticComponent<
   Omit<Partial<USelectElement>, keyof React.HTMLAttributes<USelectElement>>

package/dist/react/USelect.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USelect as USelectElement } from '../components/select/USelect.js';
+import { USelect as USelectElement } from '@iyulab/components/dist/components/select/USelect.js';
 
 export const USelect = createComponent({
   react: React,

package/dist/react/USkeleton.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { USkeleton as USkeletonElement } from '../components/skeleton/USkeleton';
+import { USkeleton as USkeletonElement } from '@iyulab/components/dist/components/skeleton/USkeleton.js';
 
 export declare const USkeleton: React.ForwardRefExoticComponent<
   Omit<Partial<USkeletonElement>, keyof React.HTMLAttributes<USkeletonElement>>

package/dist/react/USkeleton.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USkeleton as USkeletonElement } from '../components/skeleton/USkeleton.js';
+import { USkeleton as USkeletonElement } from '@iyulab/components/dist/components/skeleton/USkeleton.js';
 
 export const USkeleton = createComponent({
   react: React,

package/dist/react/USlider.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { USlider as USliderElement } from '../components/slider/USlider';
+import { USlider as USliderElement } from '@iyulab/components/dist/components/slider/USlider.js';
 
 export declare const USlider: React.ForwardRefExoticComponent<
   Omit<Partial<USliderElement>, keyof React.HTMLAttributes<USliderElement>>

package/dist/react/USlider.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USlider as USliderElement } from '../components/slider/USlider.js';
+import { USlider as USliderElement } from '@iyulab/components/dist/components/slider/USlider.js';
 
 export const USlider = createComponent({
   react: React,

package/dist/react/USpinner.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { USpinner as USpinnerElement } from '../components/spinner/USpinner';
+import { USpinner as USpinnerElement } from '@iyulab/components/dist/components/spinner/USpinner.js';
 
 export declare const USpinner: React.ForwardRefExoticComponent<
   Omit<Partial<USpinnerElement>, keyof React.HTMLAttributes<USpinnerElement>>

package/dist/react/USpinner.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USpinner as USpinnerElement } from '../components/spinner/USpinner.js';
+import { USpinner as USpinnerElement } from '@iyulab/components/dist/components/spinner/USpinner.js';
 
 export const USpinner = createComponent({
   react: React,

package/dist/react/USplitPanel.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { USplitPanel as USplitPanelElement } from '../components/split-panel/USplitPanel';
-import { type ShiftEventDetail } from '../events/ShiftEvent';
+import { USplitPanel as USplitPanelElement } from '@iyulab/components/dist/components/split-panel/USplitPanel.js';
+import { type ShiftEventDetail } from '@iyulab/components/dist/events/ShiftEvent.js';
 
 export declare const USplitPanel: React.ForwardRefExoticComponent<
   Omit<Partial<USplitPanelElement>, keyof React.HTMLAttributes<USplitPanelElement>>

package/dist/react/USplitPanel.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USplitPanel as USplitPanelElement } from '../components/split-panel/USplitPanel.js';
+import { USplitPanel as USplitPanelElement } from '@iyulab/components/dist/components/split-panel/USplitPanel.js';
 
 export const USplitPanel = createComponent({
   react: React,

package/dist/react/USwitch.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { USwitch as USwitchElement } from '../components/switch/USwitch';
+import { USwitch as USwitchElement } from '@iyulab/components/dist/components/switch/USwitch.js';
 
 export declare const USwitch: React.ForwardRefExoticComponent<
   Omit<Partial<USwitchElement>, keyof React.HTMLAttributes<USwitchElement>>

package/dist/react/USwitch.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USwitch as USwitchElement } from '../components/switch/USwitch.js';
+import { USwitch as USwitchElement } from '@iyulab/components/dist/components/switch/USwitch.js';
 
 export const USwitch = createComponent({
   react: React,

package/dist/react/UTab.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { UTab as UTabElement } from '../components/tab/UTab';
-import { type RemoveEventDetail } from '../events/RemoveEvent';
+import { UTab as UTabElement } from '@iyulab/components/dist/components/tab/UTab.js';
+import { type RemoveEventDetail } from '@iyulab/components/dist/events/RemoveEvent.js';
 
 export declare const UTab: React.ForwardRefExoticComponent<
   Omit<Partial<UTabElement>, keyof React.HTMLAttributes<UTabElement>>

package/dist/react/UTab.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTab as UTabElement } from '../components/tab/UTab.js';
+import { UTab as UTabElement } from '@iyulab/components/dist/components/tab/UTab.js';
 
 export const UTab = createComponent({
   react: React,

package/dist/react/UTabPanel.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UTabPanel as UTabPanelElement } from '../components/tab-panel/UTabPanel';
+import { UTabPanel as UTabPanelElement } from '@iyulab/components/dist/components/tab-panel/UTabPanel.js';
 
 export declare const UTabPanel: React.ForwardRefExoticComponent<
   Omit<Partial<UTabPanelElement>, keyof React.HTMLAttributes<UTabPanelElement>>

package/dist/react/UTabPanel.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTabPanel as UTabPanelElement } from '../components/tab-panel/UTabPanel.js';
+import { UTabPanel as UTabPanelElement } from '@iyulab/components/dist/components/tab-panel/UTabPanel.js';
 
 export const UTabPanel = createComponent({
   react: React,

package/dist/react/UTag.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UTag as UTagElement } from '../components/tag/UTag';
+import { UTag as UTagElement } from '@iyulab/components/dist/components/tag/UTag.js';
 
 export declare const UTag: React.ForwardRefExoticComponent<
   Omit<Partial<UTagElement>, keyof React.HTMLAttributes<UTagElement>>

package/dist/react/UTag.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTag as UTagElement } from '../components/tag/UTag.js';
+import { UTag as UTagElement } from '@iyulab/components/dist/components/tag/UTag.js';
 
 export const UTag = createComponent({
   react: React,

package/dist/react/UText.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UText as UTextElement } from '../components/text/UText';
+import { UText as UTextElement } from '@iyulab/components/dist/components/text/UText.js';
 
 export declare const UText: React.ForwardRefExoticComponent<
   Omit<Partial<UTextElement>, keyof React.HTMLAttributes<UTextElement>>

package/dist/react/UText.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UText as UTextElement } from '../components/text/UText.js';
+import { UText as UTextElement } from '@iyulab/components/dist/components/text/UText.js';
 
 export const UText = createComponent({
   react: React,

package/dist/react/UTextarea.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UTextarea as UTextareaElement } from '../components/textarea/UTextarea';
+import { UTextarea as UTextareaElement } from '@iyulab/components/dist/components/textarea/UTextarea.js';
 
 export declare const UTextarea: React.ForwardRefExoticComponent<
   Omit<Partial<UTextareaElement>, keyof React.HTMLAttributes<UTextareaElement>>

package/dist/react/UTextarea.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTextarea as UTextareaElement } from '../components/textarea/UTextarea.js';
+import { UTextarea as UTextareaElement } from '@iyulab/components/dist/components/textarea/UTextarea.js';
 
 export const UTextarea = createComponent({
   react: React,

package/dist/react/UTooltip.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
-import { UTooltip as UTooltipElement } from '../components/tooltip/UTooltip';
-import { type ShowEventDetail } from '../events/ShowEvent';
-import { type HideEventDetail } from '../events/HideEvent';
+import { UTooltip as UTooltipElement } from '@iyulab/components/dist/components/tooltip/UTooltip.js';
+import { type ShowEventDetail } from '@iyulab/components/dist/events/ShowEvent.js';
+import { type HideEventDetail } from '@iyulab/components/dist/events/HideEvent.js';
 
 export declare const UTooltip: React.ForwardRefExoticComponent<
   Omit<Partial<UTooltipElement>, keyof React.HTMLAttributes<UTooltipElement>>

package/dist/react/UTooltip.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTooltip as UTooltipElement } from '../components/tooltip/UTooltip.js';
+import { UTooltip as UTooltipElement } from '@iyulab/components/dist/components/tooltip/UTooltip.js';
 
 export const UTooltip = createComponent({
   react: React,

package/dist/react/UTree.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UTree as UTreeElement } from '../components/tree/UTree';
+import { UTree as UTreeElement } from '@iyulab/components/dist/components/tree/UTree.js';
 
 export declare const UTree: React.ForwardRefExoticComponent<
   Omit<Partial<UTreeElement>, keyof React.HTMLAttributes<UTreeElement>>

package/dist/react/UTree.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTree as UTreeElement } from '../components/tree/UTree.js';
+import { UTree as UTreeElement } from '@iyulab/components/dist/components/tree/UTree.js';
 
 export const UTree = createComponent({
   react: React,

package/dist/react/UTreeItem.d.ts

@@ -1,9 +1,9 @@
 import React from 'react';
-import { UTreeItem as UTreeItemElement } from '../components/tree-item/UTreeItem';
-import { type ExpandEventDetail } from '../events/ExpandEvent';
-import { type CollapseEventDetail } from '../events/CollapseEvent';
-import { type PickEventDetail } from '../events/PickEvent';
-import { type CheckEventDetail } from '../events/CheckEvent';
+import { UTreeItem as UTreeItemElement } from '@iyulab/components/dist/components/tree-item/UTreeItem.js';
+import { type ExpandEventDetail } from '@iyulab/components/dist/events/ExpandEvent.js';
+import { type CollapseEventDetail } from '@iyulab/components/dist/events/CollapseEvent.js';
+import { type PickEventDetail } from '@iyulab/components/dist/events/PickEvent.js';
+import { type CheckEventDetail } from '@iyulab/components/dist/events/CheckEvent.js';
 
 export declare const UTreeItem: React.ForwardRefExoticComponent<
   Omit<Partial<UTreeItemElement>, keyof React.HTMLAttributes<UTreeItemElement>>

package/dist/react/UTreeItem.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTreeItem as UTreeItemElement } from '../components/tree-item/UTreeItem.js';
+import { UTreeItem as UTreeItemElement } from '@iyulab/components/dist/components/tree-item/UTreeItem.js';
 
 export const UTreeItem = createComponent({
   react: React,

package/dist/utilities/Locale.d.ts

@@ -47,7 +47,7 @@ export declare class Locale {
     private constructor();
     /** 전역 활성 로케일을 지정합니다. */
     static set(locale: LocaleTag): void;
-    /** 전역 활성 로케일을 반환합니다 (초기값은 브라우저 언어 자동 감지, 실패 시 'en'). */
+    /** 전역 활성 로케일을 반환합니다 (초기값은 `<html lang>` → 브라우저 언어 자동 감지, 실패 시 'en'). */
     static get(): LocaleTag;
     /**
      * 로케일 하나의 메시지 테이블(전체 또는 일부)을 등록합니다.

package/dist/utilities/Locale.js

@@ -32,10 +32,20 @@ var builtins = new Map(Object.entries(/* #__PURE__ */ Object.assign({
 	return [(path.split("/").pop()?.replace(".json", "") || "").toLowerCase(), mod];
 }));
 var overrides = /* @__PURE__ */ new Map();
-/** 브라우저 환경이면 `navigator.language`/`document.lang`으로 초기 로케일을 추측한다. */
+/**
+* 초기 로케일을 `document.documentElement.lang` → `navigator.language` → `'en'` 순으로 추측한다.
+*
+* ⚠**순서가 계약이다.** `<html lang>` 은 HTML 명세상 **문서 언어에 대한 저자의 선언**이고,
+* 보조기술은 그것으로 발음 규칙을 고른다(WCAG 3.1.1 Language of Page / 3.1.2 Language of
+* Parts). `navigator.language` 는 그 선언이 **없을 때**의 사용자 선호 폴백이지 저자 선언을
+* 덮어쓸 근거가 아니다 — 덮어쓰면 `lang="en"` 문서가 다른 언어의 접근성 이름을 내보내고,
+* 스크린리더는 그것을 영어 발음 규칙으로 읽으려 한다.
+*
+* 자동 감지가 맞지 않는 앱은 `Locale.set()` 으로 언제든 덮어쓸 수 있다.
+*/
 function detectLocale() {
-	if (typeof window !== "undefined" && typeof navigator !== "undefined" && navigator.language) return navigator.language;
 	if (typeof document !== "undefined" && document.documentElement?.lang) return document.documentElement.lang;
+	if (typeof window !== "undefined" && typeof navigator !== "undefined" && navigator.language) return navigator.language;
 	return "en";
 }
 var active = detectLocale();
@@ -72,7 +82,7 @@ var Locale = class {
 	static set(locale) {
 		active = locale;
 	}
-	/** 전역 활성 로케일을 반환합니다 (초기값은 브라우저 언어 자동 감지, 실패 시 'en'). */
+	/** 전역 활성 로케일을 반환합니다 (초기값은 `<html lang>` → 브라우저 언어 자동 감지, 실패 시 'en'). */
 	static get() {
 		return active;
 	}

package/dist/utilities/format.d.ts

@@ -19,7 +19,12 @@ export declare function formatCurrency(value: number, currency: string, options?
  * already-Invalid `Date`) degrades to `String(value)` rather than throwing —
  * `Intl.DateTimeFormat.format()` throws `RangeError` on an Invalid Date, and this
  * utility is called from render paths where an uncaught throw blanks the whole
- * component. Same degrade-instead-of-throw contract as `formatCurrency`'s
- * missing-`currency` fallback.
+ * component.
+ *
+ * ⚠This degrade is **deliberately not symmetric** with {@link formatCurrency}, which
+ * throws `RangeError` on an invalid currency code. A date arrives as *data* — from an
+ * API, a user, a stale cache — so a bad one is an expected runtime state. A currency
+ * code is written by the developer at the call site, so a bad one is a bug that should
+ * surface at the first render rather than be papered over with a wrong-looking amount.
  */
 export declare function formatDate(value: Date | string, options?: Intl.DateTimeFormatOptions, locale?: LocaleTag): string;

package/dist/utilities/format.js

@@ -49,8 +49,13 @@ function formatCurrency(value, currency, options, locale) {
 * already-Invalid `Date`) degrades to `String(value)` rather than throwing —
 * `Intl.DateTimeFormat.format()` throws `RangeError` on an Invalid Date, and this
 * utility is called from render paths where an uncaught throw blanks the whole
-* component. Same degrade-instead-of-throw contract as `formatCurrency`'s
-* missing-`currency` fallback.
+* component.
+*
+* ⚠This degrade is **deliberately not symmetric** with {@link formatCurrency}, which
+* throws `RangeError` on an invalid currency code. A date arrives as *data* — from an
+* API, a user, a stale cache — so a bad one is an expected runtime state. A currency
+* code is written by the developer at the call site, so a bad one is a bug that should
+* surface at the first render rather than be papered over with a wrong-looking amount.
 */
 function formatDate(value, options, locale) {
 	const date = resolve(value);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/components",
   "description": "web-components library based on lit-element made by iyulab",
-  "version": "1.37.0",
+  "version": "1.38.0",
   "keywords": [
     "iyulab",
     "components",
@@ -90,6 +90,7 @@
     "eslint": "^9.39.4",
     "eslint-plugin-lit": "^2.3.1",
     "globals": "^17.7.0",
+    "happy-dom": "^20.10.6",
     "react": "^19.2.7",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.64.0",

package/skills/iyulab-components/SKILL.md

@@ -126,6 +126,7 @@ import { UButton, UInput } from '@iyulab/components/react';
 - [`converters`](./references/utilities/converters.md) — Lit property attribute converters (array, JSON, date, url…)
 - [`Locale`](./references/utilities/locale.md) — Validation-message locale registry and lookup utility
 - [`elements`](./references/utilities/elements.md) — Shadow-DOM-aware DOM query helpers
+- [`format`](./references/utilities/format.md) — Locale-aware number, currency and date formatting
 - [`OverlayManager`](./references/utilities/overlay-manager.md) — Internal overlay stack and z-index manager
 
 ---

package/skills/iyulab-components/references/components/popover.md

@@ -49,7 +49,11 @@ Inherits all `UFloatingElement` properties (see [floating.md](../extensions/floa
 | `autofocus` | `boolean` | `false` | ✓ | Focus first focusable element on open |
 
 > **Placement fallback**: whenever `placement` is set, floating-ui's `flip` middleware is
-> always applied — if the placed side has no room, the element switches to the opposite side.
+> always applied — if the placed side has no room, the element switches to another side.
+> The opposite side on the same axis is tried first; only when that is also out of room does
+> it move to the perpendicular axis, so `right-end` falls back through `left-end` to
+> `top-end`/`bottom-end`. That last step is what a full-width trigger needs — with room on
+> neither the left nor the right, staying on the horizontal axis means going off-screen.
 > `shift` is a separate, narrower correction: it nudges the element along the cross axis
 > *within* whichever side ended up being used. Neither can be turned off independently.
 

package/skills/iyulab-components/references/components/tooltip.md

@@ -51,7 +51,11 @@ Inherits all `UFloatingElement` properties (see [floating.md](../extensions/floa
 | `tracking` | `boolean` | `false` | ✓ | Follow mouse cursor position |
 
 > **Placement fallback**: whenever `placement` is set, floating-ui's `flip` middleware is
-> always applied — if the placed side has no room, the element switches to the opposite side.
+> always applied — if the placed side has no room, the element switches to another side.
+> The opposite side on the same axis is tried first; only when that is also out of room does
+> it move to the perpendicular axis, so `right-end` falls back through `left-end` to
+> `top-end`/`bottom-end`. That last step is what a full-width trigger needs — with room on
+> neither the left nor the right, staying on the horizontal axis means going off-screen.
 > `shift` is a separate, narrower correction: it nudges the element along the cross axis
 > *within* whichever side ended up being used. Neither can be turned off independently.
 

package/skills/iyulab-components/references/utilities/browser-storage.md

@@ -11,6 +11,11 @@ Unified key-value storage API over `localStorage` or browser cookies.
 writing. `new BrowserStorage({ type: 'cookie' })` throws `"Cookies are not supported in this
 browser."` where it's unavailable; `localStorage` has no such restriction.
 
+⚠ The constructor also throws `"BrowserStorage can only be used in a browser environment."`
+when there is no `window` at all. Construct it inside a browser-only path (an event handler,
+`connectedCallback`, an effect) rather than at module scope, or an SSR/prerender build fails
+on import alone.
+
 ## Usage
 
 ```ts

package/skills/iyulab-components/references/utilities/elements.md

@@ -37,3 +37,20 @@ Same as `querySelectorWithin` but returns all matches.
 ```ts
 const inputs = querySelectorAllWithin(this, 'u-input');
 ```
+
+---
+
+### `isCoarsePointer(event)`
+
+Returns `true` for a pointer with no lasting hover state — touch and pen.
+
+Such a pointer fires `pointerleave` immediately after `pointerenter` on a tap, so a
+hover-triggered surface that does not check this opens and closes in the same gesture.
+Branch on it before treating `pointerenter` as "the user is hovering here".
+
+```ts
+private onPointerEnter(e: PointerEvent) {
+  if (isCoarsePointer(e)) return;   // let the click/tap handler own this instead
+  this.open = true;
+}
+```