@alneas/appkit-react 0.1.0 → 0.3.0

package/dist/ui/lib/hooks/use-keyboard-shortcut.d.cts

@@ -1,39 +1,68 @@
 /**
- * キーボードショートカットの定義
- * Keyboard shortcut configuration
+ * A case-insensitive key match and handler for useKeyboardShortcuts.
+ *
+ * @see useKeyboardShortcuts for registration and cleanup.
  */
 export interface KeyboardShortcut {
-    /** キー名（e.g. 's', 'Enter', 'Escape'） */
+    /**
+     * KeyboardEvent.key value, compared case-insensitively.
+     */
     key: string;
-    /** Ctrl/Cmd キーが必要か（Mac では Cmd も許容） */
+    /**
+     * When true accept Ctrl or Meta; false excludes both; omission ignores this modifier.
+     */
     ctrlKey?: boolean;
-    /** Meta (Cmd) キーが必要か */
+    /**
+     * Require exact Meta state when provided; omission ignores Meta.
+     */
     metaKey?: boolean;
-    /** Shift キーが必要か */
+    /**
+     * Require exact Shift state when provided; omission ignores Shift.
+     */
     shiftKey?: boolean;
-    /** Alt キーが必要か */
+    /**
+     * Require exact Alt state when provided; omission ignores Alt.
+     */
     altKey?: boolean;
-    /** ショートカットが押された時のハンドラ */
+    /**
+     * Callback receiving the original keydown event after a match; only the first matching shortcut runs.
+     *
+     * @param e - Original matched keydown event.
+     *
+     * @returns No value after the handler completes.
+     */
     handler: (e: KeyboardEvent) => void;
-    /** 説明（ヘルプ表示用） */
+    /**
+     * Optional application help text; not read by the hook.
+     */
     description?: string;
-    /** preventDefault を呼ぶか（デフォルト: true） */
+    /**
+     * Prevent the matched event default unless explicitly false; defaults to true.
+     */
     preventDefault?: boolean;
 }
 /**
- * キーボードショートカットを登録するフック。
+ * Registers ordered keyboard shortcuts on the browser window.
+ *
+ * @param shortcuts - Match definitions; the first matching definition receives the original event.
+ *
+ * @param enabled - Enable the listener; defaults to true.
  *
- * `ctrlKey: true` の場合、Windows/Linux では Ctrl、Mac では Cmd (metaKey) の両方にマッチします。
+ * @returns No value; effect cleanup removes the listener on unmount or when disabled.
  *
- * @param shortcuts - ショートカット定義の配列
- * @param enabled - ショートカットの有効/無効（デフォルト: true）
+ * @remarks Omitted modifiers are ignored. ctrlKey:true accepts Ctrl or Meta on every
+ * platform. Events in inputs, composition and repeats are not filtered. Handlers run
+ * synchronously and their exceptions propagate through the browser event dispatch.
+ * No providers or styles are required. Definitions and handlers use their latest committed
+ * values without resubscribing; only enabled controls the subscription.
  *
  * @example
  * ```tsx
- * useKeyboardShortcuts([
- *   { key: 's', ctrlKey: true, handler: () => save(), description: '保存' },
- *   { key: 'Escape', handler: () => close(), description: '閉じる' },
- * ]);
+ * import { useKeyboardShortcuts } from '@alneas/appkit-react/ui/hooks';
+ * export function SaveShortcut({ save }: { save: () => void }) {
+ *   useKeyboardShortcuts([{ key: 's', ctrlKey: true, handler: save }]);
+ *   return null;
+ * }
  * ```
  */
 export declare function useKeyboardShortcuts(shortcuts: KeyboardShortcut[], enabled?: boolean): void;

package/dist/ui/lib/hooks/use-keyboard-shortcut.d.ts

@@ -1,39 +1,68 @@
 /**
- * キーボードショートカットの定義
- * Keyboard shortcut configuration
+ * A case-insensitive key match and handler for useKeyboardShortcuts.
+ *
+ * @see useKeyboardShortcuts for registration and cleanup.
  */
 export interface KeyboardShortcut {
-    /** キー名（e.g. 's', 'Enter', 'Escape'） */
+    /**
+     * KeyboardEvent.key value, compared case-insensitively.
+     */
     key: string;
-    /** Ctrl/Cmd キーが必要か（Mac では Cmd も許容） */
+    /**
+     * When true accept Ctrl or Meta; false excludes both; omission ignores this modifier.
+     */
     ctrlKey?: boolean;
-    /** Meta (Cmd) キーが必要か */
+    /**
+     * Require exact Meta state when provided; omission ignores Meta.
+     */
     metaKey?: boolean;
-    /** Shift キーが必要か */
+    /**
+     * Require exact Shift state when provided; omission ignores Shift.
+     */
     shiftKey?: boolean;
-    /** Alt キーが必要か */
+    /**
+     * Require exact Alt state when provided; omission ignores Alt.
+     */
     altKey?: boolean;
-    /** ショートカットが押された時のハンドラ */
+    /**
+     * Callback receiving the original keydown event after a match; only the first matching shortcut runs.
+     *
+     * @param e - Original matched keydown event.
+     *
+     * @returns No value after the handler completes.
+     */
     handler: (e: KeyboardEvent) => void;
-    /** 説明（ヘルプ表示用） */
+    /**
+     * Optional application help text; not read by the hook.
+     */
     description?: string;
-    /** preventDefault を呼ぶか（デフォルト: true） */
+    /**
+     * Prevent the matched event default unless explicitly false; defaults to true.
+     */
     preventDefault?: boolean;
 }
 /**
- * キーボードショートカットを登録するフック。
+ * Registers ordered keyboard shortcuts on the browser window.
+ *
+ * @param shortcuts - Match definitions; the first matching definition receives the original event.
+ *
+ * @param enabled - Enable the listener; defaults to true.
  *
- * `ctrlKey: true` の場合、Windows/Linux では Ctrl、Mac では Cmd (metaKey) の両方にマッチします。
+ * @returns No value; effect cleanup removes the listener on unmount or when disabled.
  *
- * @param shortcuts - ショートカット定義の配列
- * @param enabled - ショートカットの有効/無効（デフォルト: true）
+ * @remarks Omitted modifiers are ignored. ctrlKey:true accepts Ctrl or Meta on every
+ * platform. Events in inputs, composition and repeats are not filtered. Handlers run
+ * synchronously and their exceptions propagate through the browser event dispatch.
+ * No providers or styles are required. Definitions and handlers use their latest committed
+ * values without resubscribing; only enabled controls the subscription.
  *
  * @example
  * ```tsx
- * useKeyboardShortcuts([
- *   { key: 's', ctrlKey: true, handler: () => save(), description: '保存' },
- *   { key: 'Escape', handler: () => close(), description: '閉じる' },
- * ]);
+ * import { useKeyboardShortcuts } from '@alneas/appkit-react/ui/hooks';
+ * export function SaveShortcut({ save }: { save: () => void }) {
+ *   useKeyboardShortcuts([{ key: 's', ctrlKey: true, handler: save }]);
+ *   return null;
+ * }
  * ```
  */
 export declare function useKeyboardShortcuts(shortcuts: KeyboardShortcut[], enabled?: boolean): void;

package/dist/ui/lib/hooks/use-keyboard-shortcut.js

@@ -1,22 +1,23 @@
 "use client";
-import { useEffect as e } from "react";
+import { useEffect as e, useEffectEvent as t } from "react";
 //#region src/ui/lib/hooks/use-keyboard-shortcut.ts
-function t(t, n = !0) {
-	e(() => {
-		if (!n) return;
-		let e = (e) => {
-			for (let n of t) {
-				let t = n.ctrlKey === void 0 ? !0 : n.ctrlKey ? e.ctrlKey || e.metaKey : !(e.ctrlKey || e.metaKey), r = n.metaKey === void 0 || n.metaKey === e.metaKey, i = n.shiftKey === void 0 || n.shiftKey === e.shiftKey, a = n.altKey === void 0 || n.altKey === e.altKey, o = e.key.toLowerCase() === n.key.toLowerCase();
-				if (t && r && i && a && o) {
-					n.preventDefault !== !1 && e.preventDefault(), n.handler(e);
-					break;
-				}
+function n(n, r = !0) {
+	let i = t((e) => {
+		for (let t of n) {
+			let n = t.ctrlKey === void 0 ? !0 : t.ctrlKey ? e.ctrlKey || e.metaKey : !(e.ctrlKey || e.metaKey), r = t.metaKey === void 0 || t.metaKey === e.metaKey, i = t.shiftKey === void 0 || t.shiftKey === e.shiftKey, a = t.altKey === void 0 || t.altKey === e.altKey, o = e.key.toLowerCase() === t.key.toLowerCase();
+			if (n && r && i && a && o) {
+				t.preventDefault !== !1 && e.preventDefault(), t.handler(e);
+				break;
 			}
-		};
+		}
+	});
+	e(() => {
+		if (!r) return;
+		let e = (e) => i(e);
 		return window.addEventListener("keydown", e), () => window.removeEventListener("keydown", e);
-	}, [t, n]);
+	}, [r]);
 }
 //#endregion
-export { t as useKeyboardShortcuts };
+export { n as useKeyboardShortcuts };
 
 //# sourceMappingURL=use-keyboard-shortcut.js.map

package/dist/ui/lib/hooks/use-keyboard-shortcut.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-keyboard-shortcut.js","names":["useKeyboardShortcuts","enabled","handleKeyDown","shortcut","shortcuts","ctrlMatch","metaMatch","shiftMatch","altMatch","keyMatch"],"sources":["../../../../src/ui/lib/hooks/use-keyboard-shortcut.ts"],"sourcesContent":["import { useEffect } from 'react';\n\n/**\n * キーボードショートカットの定義\n * Keyboard shortcut configuration\n */\nexport interface KeyboardShortcut {\n  /** キー名（e.g. 's', 'Enter', 'Escape'） */\n  key: string;\n  /** Ctrl/Cmd キーが必要か（Mac では Cmd も許容） */\n  ctrlKey?: boolean;\n  /** Meta (Cmd) キーが必要か */\n  metaKey?: boolean;\n  /** Shift キーが必要か */\n  shiftKey?: boolean;\n  /** Alt キーが必要か */\n  altKey?: boolean;\n  /** ショートカットが押された時のハンドラ */\n  handler: (e: KeyboardEvent) => void;\n  /** 説明（ヘルプ表示用） */\n  description?: string;\n  /** preventDefault を呼ぶか（デフォルト: true） */\n  preventDefault?: boolean;\n}\n\n/**\n * キーボードショートカットを登録するフック。\n *\n * `ctrlKey: true` の場合、Windows/Linux では Ctrl、Mac では Cmd (metaKey) の両方にマッチします。\n *\n * @param shortcuts - ショートカット定義の配列\n * @param enabled - ショートカットの有効/無効（デフォルト: true）\n *\n * @example\n * ```tsx\n * useKeyboardShortcuts([\n *   { key: 's', ctrlKey: true, handler: () => save(), description: '保存' },\n *   { key: 'Escape', handler: () => close(), description: '閉じる' },\n * ]);\n * ```\n */\nexport function useKeyboardShortcuts(shortcuts: KeyboardShortcut[], enabled: boolean = true) {\n  useEffect(() => {\n    if (!enabled) return;\n\n    const handleKeyDown = (e: KeyboardEvent) => {\n      for (const shortcut of shortcuts) {\n        // For ctrlKey, match either Ctrl (Windows/Linux) or Cmd (Mac)\n        const ctrlMatch =\n          shortcut.ctrlKey === undefined\n            ? true\n            : shortcut.ctrlKey\n              ? e.ctrlKey || e.metaKey\n              : !(e.ctrlKey || e.metaKey);\n\n        // For metaKey, only match Cmd on Mac\n        const metaMatch = shortcut.metaKey === undefined ? true : shortcut.metaKey === e.metaKey;\n\n        const shiftMatch =\n          shortcut.shiftKey === undefined ? true : shortcut.shiftKey === e.shiftKey;\n\n        const altMatch = shortcut.altKey === undefined ? true : shortcut.altKey === e.altKey;\n\n        const keyMatch = e.key.toLowerCase() === shortcut.key.toLowerCase();\n\n        if (ctrlMatch && metaMatch && shiftMatch && altMatch && keyMatch) {\n          if (shortcut.preventDefault !== false) {\n            e.preventDefault();\n          }\n          shortcut.handler(e);\n          break; // Only trigger one shortcut per keypress\n        }\n      }\n    };\n\n    window.addEventListener('keydown', handleKeyDown);\n    return () => window.removeEventListener('keydown', handleKeyDown);\n  }, [shortcuts, enabled]);\n}\n"],"mappings":";;;AAyCA,SAAgBA,EAAqB,GAA+B,IAAmB,IAAM;CAC3F,QAAgB;EACd,IAAI,CAACC,GAAS;EAEd,IAAMC,KAAiB,MAAqB;GAC1C,KAAK,IAAMC,KAAYC,GAAW;IAEhC,IAAMC,IACJF,EAAS,YAAY,KAAA,IACjB,KACAA,EAAS,UACP,EAAE,WAAW,EAAE,UACf,EAAE,EAAE,WAAW,EAAE,UAGnBG,IAAYH,EAAS,YAAY,KAAA,KAAmBA,EAAS,YAAY,EAAE,SAE3EI,IACJJ,EAAS,aAAa,KAAA,KAAmBA,EAAS,aAAa,EAAE,UAE7DK,IAAWL,EAAS,WAAW,KAAA,KAAmBA,EAAS,WAAW,EAAE,QAExEM,IAAW,EAAE,IAAI,YAAY,MAAMN,EAAS,IAAI,YAAY;IAElE,IAAIE,KAAaC,KAAaC,KAAcC,KAAYC,GAAU;KAIhE,AAHIN,EAAS,mBAAmB,MAC9B,EAAE,eAAe,GAEnBA,EAAS,QAAQ,CAAC;KAClB;IACF;GACF;EACF;EAGA,OADA,OAAO,iBAAiB,WAAWD,CAAa,SACnC,OAAO,oBAAoB,WAAWA,CAAa;CAClE,GAAG,CAACE,GAAWH,CAAO,CAAC;AACzB"}
+{"version":3,"file":"use-keyboard-shortcut.js","names":["useKeyboardShortcuts","onKeyDown","useEffectEvent","shortcut","shortcuts","ctrlMatch","metaMatch","shiftMatch","altMatch","keyMatch","enabled","handleKeyDown","event"],"sources":["../../../../src/ui/lib/hooks/use-keyboard-shortcut.ts"],"sourcesContent":["import { useEffect, useEffectEvent } from 'react';\n\n/**\n * A case-insensitive key match and handler for useKeyboardShortcuts.\n *\n * @see useKeyboardShortcuts for registration and cleanup.\n */\nexport interface KeyboardShortcut {\n  /**\n   * KeyboardEvent.key value, compared case-insensitively.\n   */\n  key: string;\n  /**\n   * When true accept Ctrl or Meta; false excludes both; omission ignores this modifier.\n   */\n  ctrlKey?: boolean;\n  /**\n   * Require exact Meta state when provided; omission ignores Meta.\n   */\n  metaKey?: boolean;\n  /**\n   * Require exact Shift state when provided; omission ignores Shift.\n   */\n  shiftKey?: boolean;\n  /**\n   * Require exact Alt state when provided; omission ignores Alt.\n   */\n  altKey?: boolean;\n  /**\n   * Callback receiving the original keydown event after a match; only the first matching shortcut runs.\n   *\n   * @param e - Original matched keydown event.\n   *\n   * @returns No value after the handler completes.\n   */\n  handler: (e: KeyboardEvent) => void;\n  /**\n   * Optional application help text; not read by the hook.\n   */\n  description?: string;\n  /**\n   * Prevent the matched event default unless explicitly false; defaults to true.\n   */\n  preventDefault?: boolean;\n}\n\n/**\n * Registers ordered keyboard shortcuts on the browser window.\n *\n * @param shortcuts - Match definitions; the first matching definition receives the original event.\n *\n * @param enabled - Enable the listener; defaults to true.\n *\n * @returns No value; effect cleanup removes the listener on unmount or when disabled.\n *\n * @remarks Omitted modifiers are ignored. ctrlKey:true accepts Ctrl or Meta on every\n * platform. Events in inputs, composition and repeats are not filtered. Handlers run\n * synchronously and their exceptions propagate through the browser event dispatch.\n * No providers or styles are required. Definitions and handlers use their latest committed\n * values without resubscribing; only enabled controls the subscription.\n *\n * @example\n * ```tsx\n * import { useKeyboardShortcuts } from '@alneas/appkit-react/ui/hooks';\n * export function SaveShortcut({ save }: { save: () => void }) {\n *   useKeyboardShortcuts([{ key: 's', ctrlKey: true, handler: save }]);\n *   return null;\n * }\n * ```\n */\nexport function useKeyboardShortcuts(shortcuts: KeyboardShortcut[], enabled: boolean = true) {\n  const onKeyDown = useEffectEvent((e: KeyboardEvent) => {\n    for (const shortcut of shortcuts) {\n      // For ctrlKey, match either Ctrl (Windows/Linux) or Cmd (Mac)\n      const ctrlMatch =\n        shortcut.ctrlKey === undefined\n          ? true\n          : shortcut.ctrlKey\n            ? e.ctrlKey || e.metaKey\n            : !(e.ctrlKey || e.metaKey);\n\n      // For metaKey, only match Cmd on Mac\n      const metaMatch = shortcut.metaKey === undefined ? true : shortcut.metaKey === e.metaKey;\n\n      const shiftMatch = shortcut.shiftKey === undefined ? true : shortcut.shiftKey === e.shiftKey;\n\n      const altMatch = shortcut.altKey === undefined ? true : shortcut.altKey === e.altKey;\n\n      const keyMatch = e.key.toLowerCase() === shortcut.key.toLowerCase();\n\n      if (ctrlMatch && metaMatch && shiftMatch && altMatch && keyMatch) {\n        if (shortcut.preventDefault !== false) {\n          e.preventDefault();\n        }\n        shortcut.handler(e);\n        break; // Only trigger one shortcut per keypress\n      }\n    }\n  });\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const handleKeyDown = (event: KeyboardEvent) => onKeyDown(event);\n    window.addEventListener('keydown', handleKeyDown);\n    return () => window.removeEventListener('keydown', handleKeyDown);\n  }, [enabled]);\n}\n"],"mappings":";;;AAsEA,SAAgBA,EAAqB,GAA+B,IAAmB,IAAM;CAC3F,IAAMC,IAAYC,GAAgB,MAAqB;EACrD,KAAK,IAAMC,KAAYC,GAAW;GAEhC,IAAMC,IACJF,EAAS,YAAY,KAAA,IACjB,KACAA,EAAS,UACP,EAAE,WAAW,EAAE,UACf,EAAE,EAAE,WAAW,EAAE,UAGnBG,IAAYH,EAAS,YAAY,KAAA,KAAmBA,EAAS,YAAY,EAAE,SAE3EI,IAAaJ,EAAS,aAAa,KAAA,KAAmBA,EAAS,aAAa,EAAE,UAE9EK,IAAWL,EAAS,WAAW,KAAA,KAAmBA,EAAS,WAAW,EAAE,QAExEM,IAAW,EAAE,IAAI,YAAY,MAAMN,EAAS,IAAI,YAAY;GAElE,IAAIE,KAAaC,KAAaC,KAAcC,KAAYC,GAAU;IAIhE,AAHIN,EAAS,mBAAmB,MAC9B,EAAE,eAAe,GAEnBA,EAAS,QAAQ,CAAC;IAClB;GACF;EACF;CACF,CAAC;CAED,QAAgB;EACd,IAAI,CAACO,GAAS;EAEd,IAAMC,KAAiB,MAAyBV,EAAUW,CAAK;EAE/D,OADA,OAAO,iBAAiB,WAAWD,CAAa,SACnC,OAAO,oBAAoB,WAAWA,CAAa;CAClE,GAAG,CAACD,CAAO,CAAC;AACd"}

package/dist/ui/lib/hooks/use-mobile.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-mobile.cjs","names":["React","require_runtime","react","MOBILE_BREAKPOINT","useIsMobile","mql","callback"],"sources":["../../../../src/ui/lib/hooks/use-mobile.ts"],"sourcesContent":["import * as React from 'react';\n\nconst MOBILE_BREAKPOINT = 768;\n\n/**\n * 現在の画面幅がモバイルサイズ（768px 未満）であるかどうかを判定し、動的に変更を追従するカスタムフック。\n * `useSyncExternalStore` を使用して、再レンダリングの最適化とハイドレーションの整合性を確保します。\n *\n * @returns モバイルサイズであれば true、それ以外は false\n */\nexport function useIsMobile() {\n  return React.useSyncExternalStore(\n    React.useCallback((callback) => {\n      const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);\n      mql.addEventListener('change', callback);\n      return () => mql.removeEventListener('change', callback);\n    }, []),\n    () => window.innerWidth < MOBILE_BREAKPOINT,\n    () => false, // サーバーサイドでは false をデフォルトとする\n  );\n}\n"],"mappings":"A,mLAEA,IAAMG,EAAoB,IAQ1B,SAAgBC,GAAc,CAC5B,OAAOJ,EAAM,qBACXA,EAAM,YAAa,GAAa,CAC9B,IAAMK,EAAM,OAAO,WAAW,oBAAyC,EAEvE,OADAA,EAAI,iBAAiB,SAAUC,CAAQ,MAC1BD,EAAI,oBAAoB,SAAUC,CAAQ,CACzD,EAAG,CAAC,CAAC,MACC,OAAO,WAAaH,MACpB,EACR,CACF,C"}
+{"version":3,"file":"use-mobile.cjs","names":["React","require_runtime","react","MOBILE_BREAKPOINT","useIsMobile","mql","callback"],"sources":["../../../../src/ui/lib/hooks/use-mobile.ts"],"sourcesContent":["import * as React from 'react';\n\nconst MOBILE_BREAKPOINT = 768;\n\n/**\n * Subscribes to whether the browser viewport is narrower than 768 CSS pixels.\n *\n * @returns False on the server; on the client, window.innerWidth < 768.\n *\n * @remarks Uses a max-width:767px media-query listener and removes it on cleanup. Requires\n * window.matchMedia in the browser; no provider or CSS import is required.\n *\n * @example\n * ```tsx\n * import { useIsMobile } from '@alneas/appkit-react/ui/hooks';\n * export function LayoutHint() { return <span>{useIsMobile() ? 'Compact' : 'Wide'}</span>; }\n * ```\n */\nexport function useIsMobile() {\n  return React.useSyncExternalStore(\n    React.useCallback((callback) => {\n      const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);\n      mql.addEventListener('change', callback);\n      return () => mql.removeEventListener('change', callback);\n    }, []),\n    () => window.innerWidth < MOBILE_BREAKPOINT,\n    () => false, // サーバーサイドでは false をデフォルトとする\n  );\n}\n"],"mappings":"A,mLAEA,IAAMG,EAAoB,IAgB1B,SAAgBC,GAAc,CAC5B,OAAOJ,EAAM,qBACXA,EAAM,YAAa,GAAa,CAC9B,IAAMK,EAAM,OAAO,WAAW,oBAAyC,EAEvE,OADAA,EAAI,iBAAiB,SAAUC,CAAQ,MAC1BD,EAAI,oBAAoB,SAAUC,CAAQ,CACzD,EAAG,CAAC,CAAC,MACC,OAAO,WAAaH,MACpB,EACR,CACF,C"}

package/dist/ui/lib/hooks/use-mobile.d.cts

@@ -1,7 +1,15 @@
 /**
- * 現在の画面幅がモバイルサイズ（768px 未満）であるかどうかを判定し、動的に変更を追従するカスタムフック。
- * `useSyncExternalStore` を使用して、再レンダリングの最適化とハイドレーションの整合性を確保します。
+ * Subscribes to whether the browser viewport is narrower than 768 CSS pixels.
  *
- * @returns モバイルサイズであれば true、それ以外は false
+ * @returns False on the server; on the client, window.innerWidth < 768.
+ *
+ * @remarks Uses a max-width:767px media-query listener and removes it on cleanup. Requires
+ * window.matchMedia in the browser; no provider or CSS import is required.
+ *
+ * @example
+ * ```tsx
+ * import { useIsMobile } from '@alneas/appkit-react/ui/hooks';
+ * export function LayoutHint() { return <span>{useIsMobile() ? 'Compact' : 'Wide'}</span>; }
+ * ```
  */
 export declare function useIsMobile(): boolean;

package/dist/ui/lib/hooks/use-mobile.d.ts

@@ -1,7 +1,15 @@
 /**
- * 現在の画面幅がモバイルサイズ（768px 未満）であるかどうかを判定し、動的に変更を追従するカスタムフック。
- * `useSyncExternalStore` を使用して、再レンダリングの最適化とハイドレーションの整合性を確保します。
+ * Subscribes to whether the browser viewport is narrower than 768 CSS pixels.
  *
- * @returns モバイルサイズであれば true、それ以外は false
+ * @returns False on the server; on the client, window.innerWidth < 768.
+ *
+ * @remarks Uses a max-width:767px media-query listener and removes it on cleanup. Requires
+ * window.matchMedia in the browser; no provider or CSS import is required.
+ *
+ * @example
+ * ```tsx
+ * import { useIsMobile } from '@alneas/appkit-react/ui/hooks';
+ * export function LayoutHint() { return <span>{useIsMobile() ? 'Compact' : 'Wide'}</span>; }
+ * ```
  */
 export declare function useIsMobile(): boolean;

package/dist/ui/lib/hooks/use-mobile.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-mobile.js","names":["React","React$1","MOBILE_BREAKPOINT","useIsMobile","mql","callback"],"sources":["../../../../src/ui/lib/hooks/use-mobile.ts"],"sourcesContent":["import * as React from 'react';\n\nconst MOBILE_BREAKPOINT = 768;\n\n/**\n * 現在の画面幅がモバイルサイズ（768px 未満）であるかどうかを判定し、動的に変更を追従するカスタムフック。\n * `useSyncExternalStore` を使用して、再レンダリングの最適化とハイドレーションの整合性を確保します。\n *\n * @returns モバイルサイズであれば true、それ以外は false\n */\nexport function useIsMobile() {\n  return React.useSyncExternalStore(\n    React.useCallback((callback) => {\n      const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);\n      mql.addEventListener('change', callback);\n      return () => mql.removeEventListener('change', callback);\n    }, []),\n    () => window.innerWidth < MOBILE_BREAKPOINT,\n    () => false, // サーバーサイドでは false をデフォルトとする\n  );\n}\n"],"mappings":";;;AAEA,IAAME,IAAoB;AAQ1B,SAAgBC,IAAc;CAC5B,OAAOH,EAAM,qBACXA,EAAM,aAAa,MAAa;EAC9B,IAAMI,IAAM,OAAO,WAAW,oBAAyC;EAEvE,OADAA,EAAI,iBAAiB,UAAUC,CAAQ,SAC1BD,EAAI,oBAAoB,UAAUC,CAAQ;CACzD,GAAG,CAAC,CAAC,SACC,OAAO,aAAaH,SACpB,EACR;AACF"}
+{"version":3,"file":"use-mobile.js","names":["React","React$1","MOBILE_BREAKPOINT","useIsMobile","mql","callback"],"sources":["../../../../src/ui/lib/hooks/use-mobile.ts"],"sourcesContent":["import * as React from 'react';\n\nconst MOBILE_BREAKPOINT = 768;\n\n/**\n * Subscribes to whether the browser viewport is narrower than 768 CSS pixels.\n *\n * @returns False on the server; on the client, window.innerWidth < 768.\n *\n * @remarks Uses a max-width:767px media-query listener and removes it on cleanup. Requires\n * window.matchMedia in the browser; no provider or CSS import is required.\n *\n * @example\n * ```tsx\n * import { useIsMobile } from '@alneas/appkit-react/ui/hooks';\n * export function LayoutHint() { return <span>{useIsMobile() ? 'Compact' : 'Wide'}</span>; }\n * ```\n */\nexport function useIsMobile() {\n  return React.useSyncExternalStore(\n    React.useCallback((callback) => {\n      const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);\n      mql.addEventListener('change', callback);\n      return () => mql.removeEventListener('change', callback);\n    }, []),\n    () => window.innerWidth < MOBILE_BREAKPOINT,\n    () => false, // サーバーサイドでは false をデフォルトとする\n  );\n}\n"],"mappings":";;;AAEA,IAAME,IAAoB;AAgB1B,SAAgBC,IAAc;CAC5B,OAAOH,EAAM,qBACXA,EAAM,aAAa,MAAa;EAC9B,IAAMI,IAAM,OAAO,WAAW,oBAAyC;EAEvE,OADAA,EAAI,iBAAiB,UAAUC,CAAQ,SAC1BD,EAAI,oBAAoB,UAAUC,CAAQ;CACzD,GAAG,CAAC,CAAC,SACC,OAAO,aAAaH,SACpB,EACR;AACF"}

package/dist/ui/lib/hooks/use-toast.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-toast.cjs","names":["React","require_runtime","react","TOAST_LIMIT","TOAST_REMOVE_DELAY","count","genId","toastTimeouts","addToRemoveQueue","toastId","timeout","dispatch","reducer","action","state","t","toast","listeners","memoryState","listener","props","id","actualDuration","duration","update","dismiss","open","options","useToast","setState","index"],"sources":["../../../../src/ui/lib/hooks/use-toast.ts"],"sourcesContent":["import * as React from 'react';\n\nconst TOAST_LIMIT = 5;\nconst TOAST_REMOVE_DELAY = 5000;\n\ntype ToasterToast = {\n  id: string;\n  title?: React.ReactNode;\n  description?: React.ReactNode;\n  action?: React.ReactNode;\n  open?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  variant?: 'default' | 'destructive';\n  duration?: number;\n};\n\nconst _actionTypes = {\n  ADD_TOAST: 'ADD_TOAST',\n  UPDATE_TOAST: 'UPDATE_TOAST',\n  DISMISS_TOAST: 'DISMISS_TOAST',\n  REMOVE_TOAST: 'REMOVE_TOAST',\n} as const;\n\nlet count = 0;\n\nfunction genId() {\n  count = (count + 1) % Number.MAX_SAFE_INTEGER;\n  return count.toString();\n}\n\ntype ActionType = typeof _actionTypes;\n\ntype Action =\n  | {\n      type: ActionType['ADD_TOAST'];\n      toast: ToasterToast;\n    }\n  | {\n      type: ActionType['UPDATE_TOAST'];\n      toast: Partial<ToasterToast>;\n    }\n  | {\n      type: ActionType['DISMISS_TOAST'];\n      toastId?: ToasterToast['id'];\n    }\n  | {\n      type: ActionType['REMOVE_TOAST'];\n      toastId?: ToasterToast['id'];\n    };\n\ninterface State {\n  toasts: ToasterToast[];\n}\n\nconst toastTimeouts = new Map<string, ReturnType<typeof setTimeout>>();\n\nconst addToRemoveQueue = (toastId: string) => {\n  if (toastTimeouts.has(toastId)) {\n    return;\n  }\n\n  const timeout = setTimeout(() => {\n    toastTimeouts.delete(toastId);\n    dispatch({\n      type: 'REMOVE_TOAST',\n      toastId: toastId,\n    });\n  }, TOAST_REMOVE_DELAY);\n\n  toastTimeouts.set(toastId, timeout);\n};\n\n/**\n * トースト状態を操作するためのステート reducer。\n * @param state 現在のトースト状態\n * @param action 実行するアクション定義\n * @returns 更新された新しいトースト状態\n */\nexport const reducer = (state: State, action: Action): State => {\n  switch (action.type) {\n    case 'ADD_TOAST':\n      return {\n        ...state,\n        toasts: [action.toast, ...state.toasts].slice(0, TOAST_LIMIT),\n      };\n\n    case 'UPDATE_TOAST':\n      return {\n        ...state,\n        toasts: state.toasts.map((t) => (t.id === action.toast.id ? { ...t, ...action.toast } : t)),\n      };\n\n    case 'DISMISS_TOAST': {\n      const { toastId } = action;\n\n      if (toastId) {\n        addToRemoveQueue(toastId);\n      } else {\n        state.toasts.forEach((toast) => {\n          addToRemoveQueue(toast.id);\n        });\n      }\n\n      return {\n        ...state,\n        toasts: state.toasts.map((t) =>\n          t.id === toastId || toastId === undefined\n            ? {\n                ...t,\n                open: false,\n              }\n            : t,\n        ),\n      };\n    }\n    case 'REMOVE_TOAST':\n      if (action.toastId === undefined) {\n        return {\n          ...state,\n          toasts: [],\n        };\n      }\n      return {\n        ...state,\n        toasts: state.toasts.filter((t) => t.id !== action.toastId),\n      };\n  }\n};\n\nconst listeners: Array<(state: State) => void> = [];\n\nlet memoryState: State = { toasts: [] };\n\nfunction dispatch(action: Action) {\n  memoryState = reducer(memoryState, action);\n  listeners.forEach((listener) => {\n    listener(memoryState);\n  });\n}\n\ntype Toast = Omit<ToasterToast, 'id'>;\n\n/**\n * トースト通知を表示します。\n *\n * デフォルトの表示時間は、通常時 3000ms、エラー（destructive）時 5000ms です。\n *\n * @param props - トーストのプロパティ\n * @returns トーストの制御オブジェクト\n */\nfunction toast({ duration, ...props }: Toast & { duration?: number }) {\n  const id = genId();\n\n  // デフォルトの表示時間: エラーは5秒、それ以外は3秒\n  const actualDuration = duration ?? (props.variant === 'destructive' ? 5000 : 3000);\n\n  const update = (props: ToasterToast) =>\n    dispatch({\n      type: 'UPDATE_TOAST',\n      toast: { ...props, id },\n    });\n  const dismiss = () => dispatch({ type: 'DISMISS_TOAST', toastId: id });\n\n  dispatch({\n    type: 'ADD_TOAST',\n    toast: {\n      ...props,\n      id,\n      duration: actualDuration,\n      open: true,\n      onOpenChange: (open: boolean) => {\n        if (!open) dismiss();\n      },\n    },\n  });\n\n  return {\n    id: id,\n    dismiss,\n    update,\n  };\n}\n\n/**\n * 成功通知を表示します（3000ms）。\n */\ntoast.success = (title: React.ReactNode, options?: Partial<Toast>) =>\n  toast({ title, ...options, variant: 'default' });\n\n/**\n * エラー通知を表示します（5000ms）。\n */\ntoast.error = (title: React.ReactNode, options?: Partial<Toast>) =>\n  toast({ title, ...options, variant: 'destructive' });\n\n/**\n * 情報通知を表示します（3000ms）。\n */\ntoast.info = (title: React.ReactNode, options?: Partial<Toast>) =>\n  toast({ title, ...options, variant: 'default' });\n\n/**\n * トースト通知を表示・管理するためのフック。\n *\n * @example\n * ```tsx\n * const { toast } = useToast();\n *\n * toast({\n *   title: \"送信完了\",\n *   description: \"メッセージを送信しました。\",\n * });\n * ```\n */\nfunction useToast() {\n  const [state, setState] = React.useState<State>(memoryState);\n\n  React.useEffect(() => {\n    listeners.push(setState);\n    return () => {\n      const index = listeners.indexOf(setState);\n      if (index > -1) {\n        listeners.splice(index, 1);\n      }\n    };\n  }, [state]);\n\n  return {\n    ...state,\n    toast,\n    dismiss: (toastId?: string) => dispatch({ type: 'DISMISS_TOAST', toastId }),\n  };\n}\n\nexport { useToast, toast };\n"],"mappings":"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"}
+{"version":3,"file":"use-toast.cjs","names":["React","require_runtime","react","TOAST_LIMIT","TOAST_REMOVE_DELAY","count","genId","toastTimeouts","addToRemoveQueue","toastId","timeout","dispatch","reducer","action","state","t","toast","listeners","memoryState","listener","props","id","actualDuration","duration","update","dismiss","open","options","useToast","setState","index"],"sources":["../../../../src/ui/lib/hooks/use-toast.ts"],"sourcesContent":["import * as React from 'react';\n\nconst TOAST_LIMIT = 5;\nconst TOAST_REMOVE_DELAY = 5000;\n\n/**\n * In-memory notification record read by a host renderer.\n *\n * @see useToast for subscription and display; see toast for creation.\n */\ntype ToasterToast = {\n  /**\n   * Generated decimal string identifier used for updates and dismissal.\n   */\n  id: string;\n  /**\n   * Optional heading content rendered by the host.\n   */\n  title?: React.ReactNode;\n  /**\n   * Optional body content rendered by the host.\n   */\n  description?: React.ReactNode;\n  /**\n   * Optional host-rendered action element.\n   */\n  action?: React.ReactNode;\n  /**\n   * Whether the host renderer should show this notification.\n   */\n  open?: boolean;\n  /**\n   * Optional host open-state callback; toast replaces it with dismissal handling.\n   *\n   * @param open - New host-rendered visibility.\n   *\n   * @returns No value.\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * Presentation intent; default is normal styling, destructive indicates an error.\n   */\n  variant?: 'default' | 'destructive';\n  /**\n   * Requested host display duration in milliseconds; toast defaults to 3000 or 5000 for destructive.\n   */\n  duration?: number;\n};\n\nconst _actionTypes = {\n  ADD_TOAST: 'ADD_TOAST',\n  UPDATE_TOAST: 'UPDATE_TOAST',\n  DISMISS_TOAST: 'DISMISS_TOAST',\n  REMOVE_TOAST: 'REMOVE_TOAST',\n} as const;\n\nlet count = 0;\n\nfunction genId() {\n  count = (count + 1) % Number.MAX_SAFE_INTEGER;\n  return count.toString();\n}\n\ntype ActionType = typeof _actionTypes;\n\n/**\n * Reducer message for adding, updating, closing or removing stored notifications.\n *\n * @see reducer for direct reduction; normal callers use toast/useToast.\n */\ntype Action =\n  | {\n      /** Insert a notification at the front and cap the list at five. */\n      type: ActionType['ADD_TOAST'];\n      /** Complete notification to insert. */\n      toast: ToasterToast;\n    }\n  | {\n      /** Merge fields into the matching notification ID. */\n      type: ActionType['UPDATE_TOAST'];\n      /** Fields to merge; id selects the existing notification. */\n      toast: Partial<ToasterToast>;\n    }\n  | {\n      /** Close matching notifications and queue removal after five seconds. */\n      type: ActionType['DISMISS_TOAST'];\n      /** Target ID; omission affects all notifications. */\n      toastId?: ToasterToast['id'];\n    }\n  | {\n      /** Remove matching notifications immediately. */\n      type: ActionType['REMOVE_TOAST'];\n      /** Target ID; omission affects all notifications. */\n      toastId?: ToasterToast['id'];\n    };\n\n/**\n * Current module-global notification list exposed by useToast.\n *\n * @see useToast for subscription.\n */\ninterface State {\n  /**\n   * Newest-first notifications, capped at five when a notification is added.\n   */\n  toasts: ToasterToast[];\n}\n\nconst toastTimeouts = new Map<string, ReturnType<typeof setTimeout>>();\n\nconst addToRemoveQueue = (toastId: string) => {\n  if (toastTimeouts.has(toastId)) {\n    return;\n  }\n\n  const timeout = setTimeout(() => {\n    toastTimeouts.delete(toastId);\n    dispatch({\n      type: 'REMOVE_TOAST',\n      toastId: toastId,\n    });\n  }, TOAST_REMOVE_DELAY);\n\n  toastTimeouts.set(toastId, timeout);\n};\n\n/**\n * Reduces notification actions, scheduling delayed removal when notifications are dismissed.\n *\n * @param state - Existing newest-first notification list.\n *\n * @param action - Add/update/dismiss/remove instruction; omitted IDs in dismiss/remove affect all.\n *\n * @returns New list state; unrecognized update IDs leave entries unchanged.\n *\n * @remarks Dismissal closes entries and schedules module-global removal timers for 5000 ms,\n * so this reducer has a timer side effect. Adding truncates to five; duration does not\n * schedule dismissal here. Normal application code should use toast/useToast.\n *\n * @example\n * ```ts\n * import { reducer } from '@alneas/appkit-react/ui/hooks';\n * const state = reducer({ toasts: [] }, { type: 'REMOVE_TOAST' });\n * ```\n */\nexport const reducer = (state: State, action: Action): State => {\n  switch (action.type) {\n    case 'ADD_TOAST':\n      return {\n        ...state,\n        toasts: [action.toast, ...state.toasts].slice(0, TOAST_LIMIT),\n      };\n\n    case 'UPDATE_TOAST':\n      return {\n        ...state,\n        toasts: state.toasts.map((t) => (t.id === action.toast.id ? { ...t, ...action.toast } : t)),\n      };\n\n    case 'DISMISS_TOAST': {\n      const { toastId } = action;\n\n      if (toastId) {\n        addToRemoveQueue(toastId);\n      } else {\n        state.toasts.forEach((toast) => {\n          addToRemoveQueue(toast.id);\n        });\n      }\n\n      return {\n        ...state,\n        toasts: state.toasts.map((t) =>\n          t.id === toastId || toastId === undefined\n            ? {\n                ...t,\n                open: false,\n              }\n            : t,\n        ),\n      };\n    }\n    case 'REMOVE_TOAST':\n      if (action.toastId === undefined) {\n        return {\n          ...state,\n          toasts: [],\n        };\n      }\n      return {\n        ...state,\n        toasts: state.toasts.filter((t) => t.id !== action.toastId),\n      };\n  }\n};\n\nconst listeners: Array<(state: State) => void> = [];\n\nlet memoryState: State = { toasts: [] };\n\nfunction dispatch(action: Action) {\n  memoryState = reducer(memoryState, action);\n  listeners.forEach((listener) => {\n    listener(memoryState);\n  });\n}\n\n/**\n * Notification creation inputs; IDs are generated by toast.\n *\n * @see toast for creation.\n */\ntype Toast = Omit<ToasterToast, 'id'>;\n\n/**\n * Adds an open notification to the module-global store and returns controls for it.\n *\n * @param props - Content, intent and optional duration; ID/open/onOpenChange are managed here.\n *\n * @returns Generated ID plus dismiss and update controls. Updates preserve the generated ID.\n *\n * @remarks Default duration is 3000 ms, or 5000 ms for destructive. Duration is metadata\n * for the host renderer; this store does not auto-dismiss after duration. Calling dismiss\n * closes the notification and queues removal five seconds later. At most five added\n * notifications are retained. State is shared across hook consumers in this module;\n * mount a renderer consuming useToast, and import Appkit styles for styled UI.\n *\n * @example\n * ```ts\n * import { toast } from '@alneas/appkit-react/ui/hooks';\n * const notice = toast({ title: 'Saved', description: 'The host operation completed.' });\n * notice.dismiss();\n * ```\n */\nfunction toast({ duration, ...props }: Toast & {\n  /** Display-duration metadata in milliseconds; not an internal auto-dismiss timer. */\n  duration?: number;\n}) {\n  const id = genId();\n\n  // デフォルトの表示時間: エラーは5秒、それ以外は3秒\n  const actualDuration = duration ?? (props.variant === 'destructive' ? 5000 : 3000);\n\n  /**\n   * Merges fields into this notification while preserving its generated ID.\n   *\n   * @param props - Notification fields; the supplied id is overwritten by this notification ID.\n   *\n   * @returns No value after the store update.\n   *\n   * @see toast for the creation/control example.\n   *\n   * @example\n   * ```ts\n   * import { toast } from '@alneas/appkit-react/ui/hooks';\n   * const notice = toast({ title: 'Working' });\n   * notice.update({ id: notice.id, title: 'Complete' });\n   * notice.dismiss();\n   * ```\n   */\n  const update = (props: ToasterToast) =>\n    dispatch({\n      type: 'UPDATE_TOAST',\n      toast: { ...props, id },\n    });\n  /**\n   * Closes this notification and queues its removal after five seconds.\n   *\n   * @returns No value after dispatching dismissal.\n   *\n   * @see toast for a complete example.\n   *\n   * @example\n   * ```ts\n   * import { toast } from '@alneas/appkit-react/ui/hooks';\n   * const notice = toast({ title: 'Status' });\n   * notice.dismiss();\n   * ```\n   */\n  const dismiss = () => dispatch({ type: 'DISMISS_TOAST', toastId: id });\n\n  dispatch({\n    type: 'ADD_TOAST',\n    toast: {\n      ...props,\n      id,\n      duration: actualDuration,\n      open: true,\n      onOpenChange: (open: boolean) => {\n        if (!open) dismiss();\n      },\n    },\n  });\n\n  return {\n    /** Generated notification identifier. */\n    id: id,\n    /**\n     * Close and queue removal; see toast for usage.\n     * @returns No value after dispatching dismissal.\n     *\n     * @see toast for the canonical control example.\n     */\n    dismiss,\n    /**\n     * Merge notification fields while preserving id; see toast.\n     * @param props - Fields to merge; id is replaced by the original generated ID.\n     *\n     * @returns No value after dispatching the update.\n     *\n     * @see toast for the canonical control example.\n     */\n    update,\n  };\n}\n\n/**\n * Adds a normal notification with a title and optional content overrides.\n *\n * @param title - Heading content; options.title can override this value.\n *\n * @param options - Other notification inputs; variant is forced to default.\n *\n * @returns Generated ID plus update/dismiss controls, as returned by toast.\n *\n * @remarks Duration defaults to 3000 ms as host-renderer metadata, and can be overridden.\n *\n * @example\n * ```ts\n * import { toast } from '@alneas/appkit-react/ui/hooks';\n * const notice = toast.success('Operation status');\n * notice.dismiss();\n * ```\n */\ntoast.success = (title: React.ReactNode, options?: Partial<Toast>) =>\n  toast({ title, ...options, variant: 'default' });\n\n/**\n * Adds a destructive notification with a title and optional content overrides.\n *\n * @param title - Heading content; options.title can override this value.\n *\n * @param options - Other notification inputs; variant is forced to destructive.\n *\n * @returns Generated ID plus update/dismiss controls, as returned by toast.\n *\n * @remarks Duration defaults to 5000 ms as host-renderer metadata, and can be overridden.\n *\n * @example\n * ```ts\n * import { toast } from '@alneas/appkit-react/ui/hooks';\n * const notice = toast.error('Operation status');\n * notice.dismiss();\n * ```\n */\ntoast.error = (title: React.ReactNode, options?: Partial<Toast>) =>\n  toast({ title, ...options, variant: 'destructive' });\n\n/**\n * Adds a normal notification with a title and optional content overrides.\n *\n * @param title - Heading content; options.title can override this value.\n *\n * @param options - Other notification inputs; variant is forced to default.\n *\n * @returns Generated ID plus update/dismiss controls, as returned by toast.\n *\n * @remarks Duration defaults to 3000 ms as host-renderer metadata, and can be overridden.\n *\n * @example\n * ```ts\n * import { toast } from '@alneas/appkit-react/ui/hooks';\n * const notice = toast.info('Operation status');\n * notice.dismiss();\n * ```\n */\ntoast.info = (title: React.ReactNode, options?: Partial<Toast>) =>\n  toast({ title, ...options, variant: 'default' });\n\n/**\n * Subscribes a component to the shared in-memory notification list.\n *\n * @returns Current notifications, the toast creator and dismiss(id?) that closes one or all entries.\n *\n * @remarks The hook renders nothing; the host must render toasts and honor open/duration.\n * Subscription cleanup removes its listener. Module state/timers survive component\n * unmounts, so this store is not isolated per provider or SSR request. No provider is\n * required; import Appkit styles when using Appkit notification UI.\n *\n * @example\n * ```tsx\n * import { useToast } from '@alneas/appkit-react/ui/hooks';\n * export function Notices() {\n *   const { toasts, dismiss } = useToast();\n *   return <div>{toasts.filter(item => item.open).map(item => <button key={item.id} onClick={() => dismiss(item.id)}>{item.title}</button>)}</div>;\n * }\n * ```\n */\nfunction useToast() {\n  const [state, setState] = React.useState<State>(memoryState);\n\n  React.useEffect(() => {\n    listeners.push(setState);\n    return () => {\n      const index = listeners.indexOf(setState);\n      if (index > -1) {\n        listeners.splice(index, 1);\n      }\n    };\n  }, [state]);\n\n  return {\n    ...state,\n    /**\n     * Add notifications; see toast for arguments, results and duration behavior.\n     * @param props - Notification content, presentation and optional duration metadata.\n     *\n     * @returns Generated ID and update/dismiss controls.\n     *\n     * @see toast for the canonical creation example.\n     */\n    toast,\n    /**\n     * Close one or all notifications and queue removal.\n     *\n     * @param toastId - ID to close; omission closes all current notifications.\n     *\n     * @returns No value after dispatching dismissal.\n     */\n    dismiss: (toastId?: string) => dispatch({ type: 'DISMISS_TOAST', toastId }),\n  };\n}\n\nexport { useToast, toast };\n"],"mappings":"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"}

package/dist/ui/lib/hooks/use-toast.d.cts

@@ -1,12 +1,45 @@
 import * as React from 'react';
+/**
+ * In-memory notification record read by a host renderer.
+ *
+ * @see useToast for subscription and display; see toast for creation.
+ */
 type ToasterToast = {
+    /**
+     * Generated decimal string identifier used for updates and dismissal.
+     */
     id: string;
+    /**
+     * Optional heading content rendered by the host.
+     */
     title?: React.ReactNode;
+    /**
+     * Optional body content rendered by the host.
+     */
     description?: React.ReactNode;
+    /**
+     * Optional host-rendered action element.
+     */
     action?: React.ReactNode;
+    /**
+     * Whether the host renderer should show this notification.
+     */
     open?: boolean;
+    /**
+     * Optional host open-state callback; toast replaces it with dismissal handling.
+     *
+     * @param open - New host-rendered visibility.
+     *
+     * @returns No value.
+     */
     onOpenChange?: (open: boolean) => void;
+    /**
+     * Presentation intent; default is normal styling, destructive indicates an error.
+     */
     variant?: 'default' | 'destructive';
+    /**
+     * Requested host display duration in milliseconds; toast defaults to 3000 or 5000 for destructive.
+     */
     duration?: number;
 };
 declare const _actionTypes: {
@@ -16,78 +49,214 @@ declare const _actionTypes: {
     readonly REMOVE_TOAST: "REMOVE_TOAST";
 };
 type ActionType = typeof _actionTypes;
+/**
+ * Reducer message for adding, updating, closing or removing stored notifications.
+ *
+ * @see reducer for direct reduction; normal callers use toast/useToast.
+ */
 type Action = {
+    /** Insert a notification at the front and cap the list at five. */
     type: ActionType['ADD_TOAST'];
+    /** Complete notification to insert. */
     toast: ToasterToast;
 } | {
+    /** Merge fields into the matching notification ID. */
     type: ActionType['UPDATE_TOAST'];
+    /** Fields to merge; id selects the existing notification. */
     toast: Partial<ToasterToast>;
 } | {
+    /** Close matching notifications and queue removal after five seconds. */
     type: ActionType['DISMISS_TOAST'];
+    /** Target ID; omission affects all notifications. */
     toastId?: ToasterToast['id'];
 } | {
+    /** Remove matching notifications immediately. */
     type: ActionType['REMOVE_TOAST'];
+    /** Target ID; omission affects all notifications. */
     toastId?: ToasterToast['id'];
 };
+/**
+ * Current module-global notification list exposed by useToast.
+ *
+ * @see useToast for subscription.
+ */
 interface State {
+    /**
+     * Newest-first notifications, capped at five when a notification is added.
+     */
     toasts: ToasterToast[];
 }
 /**
- * トースト状態を操作するためのステート reducer。
- * @param state 現在のトースト状態
- * @param action 実行するアクション定義
- * @returns 更新された新しいトースト状態
+ * Reduces notification actions, scheduling delayed removal when notifications are dismissed.
+ *
+ * @param state - Existing newest-first notification list.
+ *
+ * @param action - Add/update/dismiss/remove instruction; omitted IDs in dismiss/remove affect all.
+ *
+ * @returns New list state; unrecognized update IDs leave entries unchanged.
+ *
+ * @remarks Dismissal closes entries and schedules module-global removal timers for 5000 ms,
+ * so this reducer has a timer side effect. Adding truncates to five; duration does not
+ * schedule dismissal here. Normal application code should use toast/useToast.
+ *
+ * @example
+ * ```ts
+ * import { reducer } from '@alneas/appkit-react/ui/hooks';
+ * const state = reducer({ toasts: [] }, { type: 'REMOVE_TOAST' });
+ * ```
  */
 export declare const reducer: (state: State, action: Action) => State;
+/**
+ * Notification creation inputs; IDs are generated by toast.
+ *
+ * @see toast for creation.
+ */
 type Toast = Omit<ToasterToast, 'id'>;
 /**
- * トースト通知を表示します。
+ * Adds an open notification to the module-global store and returns controls for it.
+ *
+ * @param props - Content, intent and optional duration; ID/open/onOpenChange are managed here.
  *
- * デフォルトの表示時間は、通常時 3000ms、エラー（destructive）時 5000ms です。
+ * @returns Generated ID plus dismiss and update controls. Updates preserve the generated ID.
  *
- * @param props - トーストのプロパティ
- * @returns トーストの制御オブジェクト
+ * @remarks Default duration is 3000 ms, or 5000 ms for destructive. Duration is metadata
+ * for the host renderer; this store does not auto-dismiss after duration. Calling dismiss
+ * closes the notification and queues removal five seconds later. At most five added
+ * notifications are retained. State is shared across hook consumers in this module;
+ * mount a renderer consuming useToast, and import Appkit styles for styled UI.
+ *
+ * @example
+ * ```ts
+ * import { toast } from '@alneas/appkit-react/ui/hooks';
+ * const notice = toast({ title: 'Saved', description: 'The host operation completed.' });
+ * notice.dismiss();
+ * ```
  */
 declare function toast({ duration, ...props }: Toast & {
+    /** Display-duration metadata in milliseconds; not an internal auto-dismiss timer. */
     duration?: number;
 }): {
+    /** Generated notification identifier. */
     id: string;
+    /**
+     * Close and queue removal; see toast for usage.
+     * @returns No value after dispatching dismissal.
+     *
+     * @see toast for the canonical control example.
+     */
     dismiss: () => void;
+    /**
+     * Merge notification fields while preserving id; see toast.
+     * @param props - Fields to merge; id is replaced by the original generated ID.
+     *
+     * @returns No value after dispatching the update.
+     *
+     * @see toast for the canonical control example.
+     */
     update: (props: ToasterToast) => void;
 };
 declare namespace toast {
     var success: (title: React.ReactNode, options?: Partial<Toast>) => {
+        /** Generated notification identifier. */
         id: string;
+        /**
+         * Close and queue removal; see toast for usage.
+         * @returns No value after dispatching dismissal.
+         *
+         * @see toast for the canonical control example.
+         */
         dismiss: () => void;
+        /**
+         * Merge notification fields while preserving id; see toast.
+         * @param props - Fields to merge; id is replaced by the original generated ID.
+         *
+         * @returns No value after dispatching the update.
+         *
+         * @see toast for the canonical control example.
+         */
         update: (props: ToasterToast) => void;
     };
     var error: (title: React.ReactNode, options?: Partial<Toast>) => {
+        /** Generated notification identifier. */
         id: string;
+        /**
+         * Close and queue removal; see toast for usage.
+         * @returns No value after dispatching dismissal.
+         *
+         * @see toast for the canonical control example.
+         */
         dismiss: () => void;
+        /**
+         * Merge notification fields while preserving id; see toast.
+         * @param props - Fields to merge; id is replaced by the original generated ID.
+         *
+         * @returns No value after dispatching the update.
+         *
+         * @see toast for the canonical control example.
+         */
         update: (props: ToasterToast) => void;
     };
     var info: (title: React.ReactNode, options?: Partial<Toast>) => {
+        /** Generated notification identifier. */
         id: string;
+        /**
+         * Close and queue removal; see toast for usage.
+         * @returns No value after dispatching dismissal.
+         *
+         * @see toast for the canonical control example.
+         */
         dismiss: () => void;
+        /**
+         * Merge notification fields while preserving id; see toast.
+         * @param props - Fields to merge; id is replaced by the original generated ID.
+         *
+         * @returns No value after dispatching the update.
+         *
+         * @see toast for the canonical control example.
+         */
         update: (props: ToasterToast) => void;
     };
 }
 /**
- * トースト通知を表示・管理するためのフック。
+ * Subscribes a component to the shared in-memory notification list.
+ *
+ * @returns Current notifications, the toast creator and dismiss(id?) that closes one or all entries.
+ *
+ * @remarks The hook renders nothing; the host must render toasts and honor open/duration.
+ * Subscription cleanup removes its listener. Module state/timers survive component
+ * unmounts, so this store is not isolated per provider or SSR request. No provider is
+ * required; import Appkit styles when using Appkit notification UI.
  *
  * @example
  * ```tsx
- * const { toast } = useToast();
- *
- * toast({
- *   title: "送信完了",
- *   description: "メッセージを送信しました。",
- * });
+ * import { useToast } from '@alneas/appkit-react/ui/hooks';
+ * export function Notices() {
+ *   const { toasts, dismiss } = useToast();
+ *   return <div>{toasts.filter(item => item.open).map(item => <button key={item.id} onClick={() => dismiss(item.id)}>{item.title}</button>)}</div>;
+ * }
  * ```
  */
 declare function useToast(): {
+    /**
+     * Add notifications; see toast for arguments, results and duration behavior.
+     * @param props - Notification content, presentation and optional duration metadata.
+     *
+     * @returns Generated ID and update/dismiss controls.
+     *
+     * @see toast for the canonical creation example.
+     */
     toast: typeof toast;
+    /**
+     * Close one or all notifications and queue removal.
+     *
+     * @param toastId - ID to close; omission closes all current notifications.
+     *
+     * @returns No value after dispatching dismissal.
+     */
     dismiss: (toastId?: string) => void;
+    /**
+     * Newest-first notifications, capped at five when a notification is added.
+     */
     toasts: ToasterToast[];
 };
 export { useToast, toast };