@iyulab/modern-app 0.35.0 → 0.35.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.35.1] - 2026-10-06
+
+### Fixed
+
+- **`u-wizard`'s `step-change`, `u-master-detail-layout`'s `detail-close` and `u-sidebar-layout`'s
+  `overlay-close` are typed for TypeScript listeners** (`WizardEventMap`, `MasterDetailLayoutEventMap`,
+  `SidebarLayoutEventMap`, exported). `wizard.addEventListener('step-change', (e) => e.detail.to)` no
+  longer needs a cast; the React `onStepChange`/`onOverlayClose` props use the same types.
+
 ## [0.35.0] - 2026-10-06
 
 ### Changed

package/dist/components/MasterDetailLayout.d.ts

@@ -86,6 +86,20 @@ export declare class MasterDetailLayout extends StyledElement<ElementParts> {
     private handleDetailSlotChange;
     render(): import('lit-html').TemplateResult<1>;
 }
+/** Events `<u-master-detail-layout>` dispatches — bubbling and composed. */
+export interface MasterDetailLayoutEventMap {
+    /** The detail pane's close button was pressed (narrow width, overlay mode). Clearing the `detail` slot is yours. */
+    'detail-close': CustomEvent<null>;
+}
+/** Typed listeners for {@link MasterDetailLayoutEventMap} — element-scoped, the DOM's own pattern (`HTMLMediaElementEventMap`). */
+export interface MasterDetailLayout {
+    addEventListener<K extends keyof MasterDetailLayoutEventMap>(type: K, listener: (this: MasterDetailLayout, ev: MasterDetailLayoutEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: MasterDetailLayout, ev: HTMLElementEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof MasterDetailLayoutEventMap>(type: K, listener: (this: MasterDetailLayout, ev: MasterDetailLayoutEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: MasterDetailLayout, ev: HTMLElementEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
 declare global {
     interface HTMLElementTagNameMap {
         'u-master-detail-layout': MasterDetailLayout;

package/dist/components/Wizard.d.ts

@@ -89,6 +89,20 @@ export declare class Wizard extends StyledElement<ElementParts> {
     private renderStep;
     render(): import('lit-html').TemplateResult<1>;
 }
+/** Events `<u-wizard>` dispatches — bubbling and composed. */
+export interface WizardEventMap {
+    /** Cancelable: `preventDefault()` keeps the wizard on `from` (validation, unsaved work). */
+    'step-change': CustomEvent<WizardStepChangeDetail>;
+}
+/** Typed listeners for {@link WizardEventMap} — element-scoped, the DOM's own pattern (`HTMLMediaElementEventMap`). */
+export interface Wizard {
+    addEventListener<K extends keyof WizardEventMap>(type: K, listener: (this: Wizard, ev: WizardEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: Wizard, ev: HTMLElementEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof WizardEventMap>(type: K, listener: (this: Wizard, ev: WizardEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: Wizard, ev: HTMLElementEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
 declare global {
     interface HTMLElementTagNameMap {
         'u-wizard': Wizard;

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export type * from './types/AppOptions';
 export type * from './types/AuthConfig';
 export type { SidebarPermissionGuard } from './layouts/SidebarPermission';
 export type { SidebarIconsConfig } from './layouts/SidebarLayout.types';
+export type { SidebarLayoutEventMap } from './layouts/SidebarLayout.js';
 export { filterSidebarItems } from './layouts/filterSidebarItems.js';
 export { PageHeader } from './components/PageHeader.js';
 export { GroupBox } from './components/GroupBox.js';
@@ -12,8 +13,9 @@ export { InfoField, isBlank } from './components/InfoField.js';
 export { EmptyState } from './components/EmptyState.js';
 export { ActionBar } from './components/ActionBar.js';
 export { MasterDetailLayout } from './components/MasterDetailLayout.js';
+export type { MasterDetailLayoutEventMap } from './components/MasterDetailLayout.js';
 export { Wizard } from './components/Wizard.js';
-export type { WizardStep, WizardStepState, WizardStepChangeDetail } from './components/Wizard.js';
+export type { WizardStep, WizardStepState, WizardStepChangeDetail, WizardEventMap } from './components/Wizard.js';
 export { translate } from './translate.js';
 export { modernAppLocale, registerLocale, setDefaultLocale, getLocaleStrings, getDefaultLocale, } from './internals/locale.js';
 export type { ModernAppLocaleStrings, ModernAppMessageKey } from './internals/locale.js';

package/dist/layouts/SidebarLayout.d.ts

@@ -156,6 +156,20 @@ export declare class SidebarLayout extends StyledElement<SidebarParts> {
     /** 화면 크기 변경에 따른 사이드바 상태 업데이트 */
     private handleScreenResize;
 }
+/** Events `<u-sidebar-layout>` dispatches — bubbling and composed. */
+export interface SidebarLayoutEventMap {
+    /** The overlay's close button was pressed, or Escape with focus inside the panel. Emptying the `overlay` slot is yours. */
+    'overlay-close': CustomEvent<null>;
+}
+/** Typed listeners for {@link SidebarLayoutEventMap} — element-scoped, the DOM's own pattern (`HTMLMediaElementEventMap`). */
+export interface SidebarLayout {
+    addEventListener<K extends keyof SidebarLayoutEventMap>(type: K, listener: (this: SidebarLayout, ev: SidebarLayoutEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: SidebarLayout, ev: HTMLElementEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof SidebarLayoutEventMap>(type: K, listener: (this: SidebarLayout, ev: SidebarLayoutEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: SidebarLayout, ev: HTMLElementEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
 declare global {
     interface HTMLElementTagNameMap {
         'u-sidebar-layout': SidebarLayout;

package/dist/react.d.ts

@@ -1,7 +1,7 @@
 import { default as React } from 'react';
 import { EventName } from '@lit/react';
-import { SidebarLayout as SidebarLayoutElement } from './layouts/SidebarLayout.js';
-import { Wizard as WizardElement, WizardStepChangeDetail } from './components/Wizard.js';
+import { SidebarLayout as SidebarLayoutElement, SidebarLayoutEventMap } from './layouts/SidebarLayout.js';
+import { Wizard as WizardElement, WizardEventMap } from './components/Wizard.js';
 import { GroupBoxLevel } from './components/GroupBox.js';
 import { InfoFieldFormat, InfoFieldSize, InfoFieldTrend, InfoFieldTone } from './components/InfoField.js';
 export { ScreenObserver } from './internals/ScreenObserver.js';
@@ -12,7 +12,7 @@ export type { ScreenSize, ScreenObserverConfig, ScreenResizeEvent } from './inte
  * React 18 (JSX attributes stringify), so this wrapper keeps `config` working on both.
  */
 export declare const SidebarLayout: import('@lit/react').ReactWebComponent<SidebarLayoutElement, {
-    onOverlayClose: EventName<CustomEvent>;
+    onOverlayClose: EventName<SidebarLayoutEventMap["overlay-close"]>;
 }>;
 export type SidebarLayoutProps = React.ComponentProps<typeof SidebarLayout>;
 /**
@@ -23,7 +23,7 @@ export type SidebarLayoutProps = React.ComponentProps<typeof SidebarLayout>;
  * wrapper keeps working on React 18 the same way it does for `SidebarLayout`'s `config`.
  */
 export declare const Wizard: import('@lit/react').ReactWebComponent<WizardElement, {
-    onStepChange: EventName<CustomEvent<WizardStepChangeDetail>>;
+    onStepChange: EventName<WizardEventMap["step-change"]>;
 }>;
 export type WizardProps = React.ComponentProps<typeof Wizard>;
 export type { SidebarLayoutElement, WizardElement };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/modern-app",
   "description": "web-framework by iyulab based on lit-element",
-  "version": "0.35.0",
+  "version": "0.35.1",
   "keywords": [
     "iyulab",
     "web-framework",