@alneas/appkit-react 0.1.0 → 0.2.0

package/dist/tools/lib/hooks/useAsyncWithTimeout.d.ts

@@ -1,51 +1,104 @@
 import { AppError, ErrorDisplayMode } from '../error/index.js';
+/**
+ * Host asynchronous operation and timeout/presentation settings.
+ * @typeParam T - Operation result shape.
+ * @see useAsyncWithTimeout for usage.
+ */
 export interface UseAsyncWithTimeoutOptions<T> {
-    /** 実行する非同期関数 */
+    /**
+   * Host operation invoked with no abort signal.
+   * @returns Promise resolving the operation result; rejection is normalized by execute.
+   */
     fn: () => Promise<T>;
-    /** タイムアウト時間 (ミリ秒)。デフォルト: 30000 */
+    /**
+   * Timeout in milliseconds; defaults to 30000. Does not cancel underlying work.
+   */
     timeout?: number;
-    /** エラー発生時の表示モード */
+    /**
+   * Display hint for newly wrapped errors; defaults to notification.
+   */
     errorDisplayMode?: ErrorDisplayMode;
-    /** エラー発生時に自動で表示するか。デフォルト: true */
+    /**
+   * Add normalized failure to the shared error store; defaults to true.
+   */
     showErrorOnFailure?: boolean;
-    /** 成功時のコールバック */
+    /**
+   * Optional synchronous callback after a mounted success; errors are handled as execution failures.
+   * @param data - Resolved operation result.
+   * @returns No value.
+   */
     onSuccess?: (data: T) => void;
-    /** エラー時のコールバック */
+    /**
+   * Optional synchronous callback after mounted failure normalization/presentation.
+   * @param error - Normalized AppError.
+   * @returns No value; thrown callback errors reject execute.
+   */
     onError?: (error: AppError) => void;
 }
+/**
+ * Last result/status with explicit execute/reset controls.
+ * @typeParam T - Host operation result shape.
+ * @see useAsyncWithTimeout for usage.
+ */
 export interface UseAsyncWithTimeoutReturn<T> {
-    /** 非同期処理を実行 */
+    /**
+   * Race a new host operation against a timeout.
+   * @returns Host result on success, or undefined on handled failure/unmounted rejection.
+   * @throws Errors from onError/error-presentation callbacks may reject.
+   */
     execute: () => Promise<T | undefined>;
-    /** 現在読み込み中か */
+    /**
+   * Whether execute last set pending state; overlapping completions can overwrite this flag.
+   */
     isLoading: boolean;
-    /** 最後に発生したエラー */
+    /**
+   * Most recent mounted execution failure or null.
+   */
     error: AppError | null;
-    /** 成功したデータ */
+    /**
+   * Last mounted success, initially undefined; errors do not clear prior data.
+   */
     data: T | undefined;
-    /** エラー状態をリセット */
+    /**
+   * Clear displayed loading/error/data state.
+   * @returns No value; in-flight host work can still finish and update state on this mount.
+   */
     reset: () => void;
 }
 /**
- * タイムアウト付き非同期処理フック
- *
+ * Runs explicit asynchronous work against a display timeout and tracks the last completion.
+ * @typeParam T - Host operation result shape.
+ * @param options - Host operation, timeout, presentation settings and synchronous outcome callbacks.
+ * @returns Execute/reset controls and displayed loading, result and normalized error state.
+ * @remarks Requires React and the shared error store; no context or styles are required by
+ * the hook. The internal AbortController is never passed to fn: new executes, reset and
+ * unmount do not cancel host work. Unmount suppresses state/callback updates; overlapping
+ * operations on one mount can complete out of order. Timeout timers are not cleared on
+ * settlement. onSuccess errors enter failure handling; onError errors may reject execute.
+ * To display errors, mount a host renderer for useError's shared store.
  * @example
  * ```tsx
- * const { execute, isLoading, error, data } = useAsyncWithTimeout({
- *     fn: async () => await api.fetchData(),
- *     timeout: 10000, // 10秒
- *     errorDisplayMode: 'notification',
- *     onSuccess: (data) => console.log('Success:', data),
- * });
- *
- * // ボタンクリックで実行
- * <button onClick={execute} disabled={isLoading}>
- *     {isLoading ? 'Loading...' : 'Fetch Data'}
- * </button>
+ * import { useAsyncWithTimeout } from '@alneas/appkit-react/tools/core';
+ * export function Load({ load }: { load: () => Promise<string> }) {
+ *   const task = useAsyncWithTimeout({ fn: load, timeout: 10000 });
+ *   return <button disabled={task.isLoading} onClick={() => { void task.execute(); }}>{task.data ?? 'Load'}</button>;
+ * }
  * ```
  */
 export declare function useAsyncWithTimeout<T>(options: UseAsyncWithTimeoutOptions<T>): UseAsyncWithTimeoutReturn<T>;
 /**
- * タイムアウト付きで Promise を実行するユーティリティ関数
- * (フック外で使用する場合)
+ * Races an existing promise against a timeout rejection without cancelling either task.
+ * @typeParam T - Promise result shape.
+ * @param promise - Already-started host operation.
+ * @param timeout - Delay in milliseconds before TimeoutError rejection; defaults to 30000.
+ * @returns Original result if it wins the race.
+ * @throws Rejects with the original rejection or TimeoutError, whichever settles first.
+ * @remarks No React context is required. The timer is not cleared when the host promise
+ * settles; timeout does not abort the operation or roll back its effects.
+ * @example
+ * ```ts
+ * import { withTimeout } from '@alneas/appkit-react/tools/core';
+ * export function limited<T>(operation: Promise<T>) { return withTimeout(operation, 5000); }
+ * ```
  */
 export declare function withTimeout<T>(promise: Promise<T>, timeout?: number): Promise<T>;

package/dist/tools/lib/hooks/useAsyncWithTimeout.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncWithTimeout.js","names":["DEFAULT_TIMEOUT","useAsyncWithTimeout","options","isLoading","setIsLoading","useState","error","setError","data","setData","useError","abortControllerRef","useRef","isMountedRef","useEffect","useCallback","timeoutPromise","TimeoutError","timeout","result","fn","onSuccess","err","appError","AppError","errorDisplayMode","showErrorOnFailure","showError","onError","withTimeout","promise"],"sources":["../../../../src/tools/lib/hooks/useAsyncWithTimeout.ts"],"sourcesContent":["import { useState, useCallback, useRef, useEffect } from 'react';\nimport { AppError, TimeoutError, ErrorDisplayMode } from \"../error\";\nimport { useError } from './useError';\n\n/** デフォルトのタイムアウト時間 (30秒) */\nconst DEFAULT_TIMEOUT = 30000;\n\nexport interface UseAsyncWithTimeoutOptions<T> {\n  /** 実行する非同期関数 */\n  fn: () => Promise<T>;\n  /** タイムアウト時間 (ミリ秒)。デフォルト: 30000 */\n  timeout?: number;\n  /** エラー発生時の表示モード */\n  errorDisplayMode?: ErrorDisplayMode;\n  /** エラー発生時に自動で表示するか。デフォルト: true */\n  showErrorOnFailure?: boolean;\n  /** 成功時のコールバック */\n  onSuccess?: (data: T) => void;\n  /** エラー時のコールバック */\n  onError?: (error: AppError) => void;\n}\n\nexport interface UseAsyncWithTimeoutReturn<T> {\n  /** 非同期処理を実行 */\n  execute: () => Promise<T | undefined>;\n  /** 現在読み込み中か */\n  isLoading: boolean;\n  /** 最後に発生したエラー */\n  error: AppError | null;\n  /** 成功したデータ */\n  data: T | undefined;\n  /** エラー状態をリセット */\n  reset: () => void;\n}\n\n/**\n * タイムアウト付き非同期処理フック\n *\n * @example\n * ```tsx\n * const { execute, isLoading, error, data } = useAsyncWithTimeout({\n *     fn: async () => await api.fetchData(),\n *     timeout: 10000, // 10秒\n *     errorDisplayMode: 'notification',\n *     onSuccess: (data) => console.log('Success:', data),\n * });\n *\n * // ボタンクリックで実行\n * <button onClick={execute} disabled={isLoading}>\n *     {isLoading ? 'Loading...' : 'Fetch Data'}\n * </button>\n * ```\n */\nexport function useAsyncWithTimeout<T>(\n  options: UseAsyncWithTimeoutOptions<T>,\n): UseAsyncWithTimeoutReturn<T> {\n  const {\n    fn,\n    timeout = DEFAULT_TIMEOUT,\n    errorDisplayMode = 'notification',\n    showErrorOnFailure = true,\n    onSuccess,\n    onError,\n  } = options;\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<AppError | null>(null);\n  const [data, setData] = useState<T | undefined>(undefined);\n\n  const { showError } = useError();\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const isMountedRef = useRef(true);\n\n  // コンポーネントのアンマウント時にクリーンアップ\n  useEffect(() => {\n    isMountedRef.current = true;\n    return () => {\n      isMountedRef.current = false;\n      abortControllerRef.current?.abort();\n    };\n  }, []);\n\n  const execute = useCallback(async (): Promise<T | undefined> => {\n    // 既存のリクエストをキャンセル\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = new AbortController();\n\n    setIsLoading(true);\n    setError(null);\n\n    // タイムアウト用のPromise\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      setTimeout(() => {\n        reject(new TimeoutError('The operation timed out', timeout));\n      }, timeout);\n    });\n\n    try {\n      // fetchとtimeoutのレース\n      const result = await Promise.race([fn(), timeoutPromise]);\n\n      if (isMountedRef.current) {\n        setData(result);\n        setIsLoading(false);\n        onSuccess?.(result);\n      }\n\n      return result;\n    } catch (err) {\n      if (!isMountedRef.current) return undefined;\n\n      const appError = AppError.from(err, errorDisplayMode);\n      setError(appError);\n      setIsLoading(false);\n\n      if (showErrorOnFailure) {\n        showError(appError);\n      }\n\n      onError?.(appError);\n      return undefined;\n    }\n  }, [fn, timeout, errorDisplayMode, showErrorOnFailure, showError, onSuccess, onError]);\n\n  const reset = useCallback(() => {\n    setIsLoading(false);\n    setError(null);\n    setData(undefined);\n    abortControllerRef.current?.abort();\n  }, []);\n\n  return {\n    execute,\n    isLoading,\n    error,\n    data,\n    reset,\n  };\n}\n\n/**\n * タイムアウト付きで Promise を実行するユーティリティ関数\n * (フック外で使用する場合)\n */\nexport async function withTimeout<T>(\n  promise: Promise<T>,\n  timeout: number = DEFAULT_TIMEOUT,\n): Promise<T> {\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    setTimeout(() => {\n      reject(new TimeoutError('The operation timed out', timeout));\n    }, timeout);\n  });\n\n  return Promise.race([promise, timeoutPromise]);\n}\n"],"mappings":";;;;;AAKA,IAAMA,IAAkB;AAgDxB,SAAgBC,EACd,GAC8B;CAC9B,IAAM,EACJ,OACA,aAAUD,GACV,sBAAmB,gBACnB,wBAAqB,IACrB,cACA,eACEE,GAEE,CAACC,GAAWC,KAAgBC,EAAS,EAAK,GAC1C,CAACC,GAAOC,KAAYF,EAA0B,IAAI,GAClD,CAACG,GAAMC,KAAWJ,EAAwB,KAAA,CAAS,GAEnD,EAAE,iBAAcK,EAAS,GACzBC,IAAqBC,EAA+B,IAAI,GACxDC,IAAeD,EAAO,EAAI;CA4DhC,OAzDAE,SACE,EAAa,UAAU,UACV;EAEX,AADA,EAAa,UAAU,IACvBH,EAAmB,SAAS,MAAM;CACpC,IACC,CAAC,CAAC,GAmDE;EACL,SAlDcI,EAAY,YAAoC;GAM9D,AAJAJ,EAAmB,SAAS,MAAM,GAClC,EAAmB,UAAU,IAAI,gBAAgB,GAEjDP,EAAa,EAAI,GACjBG,EAAS,IAAI;GAGb,IAAMS,IAAiB,IAAI,SAAgB,GAAG,MAAW;IACvD,iBAAiB;KACf,EAAO,IAAIC,EAAa,2BAA2BC,CAAO,CAAC;IAC7D,GAAGA,CAAO;GACZ,CAAC;GAED,IAAI;IAEF,IAAMC,IAAS,MAAM,QAAQ,KAAK,CAACC,EAAG,GAAGJ,CAAc,CAAC;IAQxD,OANIH,EAAa,YACfJ,EAAQU,CAAM,GACdf,EAAa,EAAK,GAClBiB,IAAYF,CAAM,IAGbA;GACT,SAASG,GAAK;IACZ,IAAI,CAACT,EAAa,SAAS;IAE3B,IAAMU,IAAWC,EAAS,KAAKF,GAAKG,CAAgB;IAQpD,AAPAlB,EAASgB,CAAQ,GACjBnB,EAAa,EAAK,GAEdsB,KACFC,EAAUJ,CAAQ,GAGpBK,IAAUL,CAAQ;IAClB;GACF;EACF,GAAG;GAACH;GAAIF;GAASO;GAAkBC;GAAoBC;GAAWN;GAAWO;EAAO,CAUlF;EACA;EACA;EACA;EACA,OAZYb,QAAkB;GAI9B,AAHAX,EAAa,EAAK,GAClBG,EAAS,IAAI,GACbE,EAAQ,KAAA,CAAS,GACjBE,EAAmB,SAAS,MAAM;EACpC,GAAG,CAAC,CAOF;CACF;AACF;AAMA,eAAsBkB,EACpB,GACA,IAAkB7B,GACN;CACZ,IAAMgB,IAAiB,IAAI,SAAgB,GAAG,MAAW;EACvD,iBAAiB;GACf,EAAO,IAAIC,EAAa,2BAA2BC,CAAO,CAAC;EAC7D,GAAGA,CAAO;CACZ,CAAC;CAED,OAAO,QAAQ,KAAK,CAACY,GAASd,CAAc,CAAC;AAC/C"}
+{"version":3,"file":"useAsyncWithTimeout.js","names":["DEFAULT_TIMEOUT","useAsyncWithTimeout","options","isLoading","setIsLoading","useState","error","setError","data","setData","useError","abortControllerRef","useRef","isMountedRef","useEffect","useCallback","timeoutPromise","TimeoutError","timeout","result","fn","onSuccess","err","appError","AppError","errorDisplayMode","showErrorOnFailure","showError","onError","withTimeout","promise"],"sources":["../../../../src/tools/lib/hooks/useAsyncWithTimeout.ts"],"sourcesContent":["import { useState, useCallback, useRef, useEffect } from 'react';\nimport { AppError, TimeoutError, ErrorDisplayMode } from \"../error\";\nimport { useError } from './useError';\n\n/** Default timeout delay in milliseconds (30 seconds). */\nconst DEFAULT_TIMEOUT = 30000;\n\n/**\n * Host asynchronous operation and timeout/presentation settings.\n * @typeParam T - Operation result shape.\n * @see useAsyncWithTimeout for usage.\n */\nexport interface UseAsyncWithTimeoutOptions<T> {\n    /**\n   * Host operation invoked with no abort signal.\n   * @returns Promise resolving the operation result; rejection is normalized by execute.\n   */\n  fn: () => Promise<T>;\n    /**\n   * Timeout in milliseconds; defaults to 30000. Does not cancel underlying work.\n   */\n  timeout?: number;\n    /**\n   * Display hint for newly wrapped errors; defaults to notification.\n   */\n  errorDisplayMode?: ErrorDisplayMode;\n    /**\n   * Add normalized failure to the shared error store; defaults to true.\n   */\n  showErrorOnFailure?: boolean;\n    /**\n   * Optional synchronous callback after a mounted success; errors are handled as execution failures.\n   * @param data - Resolved operation result.\n   * @returns No value.\n   */\n  onSuccess?: (data: T) => void;\n    /**\n   * Optional synchronous callback after mounted failure normalization/presentation.\n   * @param error - Normalized AppError.\n   * @returns No value; thrown callback errors reject execute.\n   */\n  onError?: (error: AppError) => void;\n}\n\n/**\n * Last result/status with explicit execute/reset controls.\n * @typeParam T - Host operation result shape.\n * @see useAsyncWithTimeout for usage.\n */\nexport interface UseAsyncWithTimeoutReturn<T> {\n    /**\n   * Race a new host operation against a timeout.\n   * @returns Host result on success, or undefined on handled failure/unmounted rejection.\n   * @throws Errors from onError/error-presentation callbacks may reject.\n   */\n  execute: () => Promise<T | undefined>;\n    /**\n   * Whether execute last set pending state; overlapping completions can overwrite this flag.\n   */\n  isLoading: boolean;\n    /**\n   * Most recent mounted execution failure or null.\n   */\n  error: AppError | null;\n    /**\n   * Last mounted success, initially undefined; errors do not clear prior data.\n   */\n  data: T | undefined;\n    /**\n   * Clear displayed loading/error/data state.\n   * @returns No value; in-flight host work can still finish and update state on this mount.\n   */\n  reset: () => void;\n}\n\n/**\n * Runs explicit asynchronous work against a display timeout and tracks the last completion.\n * @typeParam T - Host operation result shape.\n * @param options - Host operation, timeout, presentation settings and synchronous outcome callbacks.\n * @returns Execute/reset controls and displayed loading, result and normalized error state.\n * @remarks Requires React and the shared error store; no context or styles are required by\n * the hook. The internal AbortController is never passed to fn: new executes, reset and\n * unmount do not cancel host work. Unmount suppresses state/callback updates; overlapping\n * operations on one mount can complete out of order. Timeout timers are not cleared on\n * settlement. onSuccess errors enter failure handling; onError errors may reject execute.\n * To display errors, mount a host renderer for useError's shared store.\n * @example\n * ```tsx\n * import { useAsyncWithTimeout } from '@alneas/appkit-react/tools/core';\n * export function Load({ load }: { load: () => Promise<string> }) {\n *   const task = useAsyncWithTimeout({ fn: load, timeout: 10000 });\n *   return <button disabled={task.isLoading} onClick={() => { void task.execute(); }}>{task.data ?? 'Load'}</button>;\n * }\n * ```\n */\nexport function useAsyncWithTimeout<T>(\n  options: UseAsyncWithTimeoutOptions<T>,\n): UseAsyncWithTimeoutReturn<T> {\n  const {\n    fn,\n    timeout = DEFAULT_TIMEOUT,\n    errorDisplayMode = 'notification',\n    showErrorOnFailure = true,\n    onSuccess,\n    onError,\n  } = options;\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<AppError | null>(null);\n  const [data, setData] = useState<T | undefined>(undefined);\n\n  const { showError } = useError();\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const isMountedRef = useRef(true);\n\n  // コンポーネントのアンマウント時にクリーンアップ\n  useEffect(() => {\n    isMountedRef.current = true;\n    return () => {\n      isMountedRef.current = false;\n      abortControllerRef.current?.abort();\n    };\n  }, []);\n\n  const execute = useCallback(async (): Promise<T | undefined> => {\n    // 既存のリクエストをキャンセル\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = new AbortController();\n\n    setIsLoading(true);\n    setError(null);\n\n    // タイムアウト用のPromise\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      setTimeout(() => {\n        reject(new TimeoutError('The operation timed out', timeout));\n      }, timeout);\n    });\n\n    try {\n      // fetchとtimeoutのレース\n      const result = await Promise.race([fn(), timeoutPromise]);\n\n      if (isMountedRef.current) {\n        setData(result);\n        setIsLoading(false);\n        onSuccess?.(result);\n      }\n\n      return result;\n    } catch (err) {\n      if (!isMountedRef.current) return undefined;\n\n      const appError = AppError.from(err, errorDisplayMode);\n      setError(appError);\n      setIsLoading(false);\n\n      if (showErrorOnFailure) {\n        showError(appError);\n      }\n\n      onError?.(appError);\n      return undefined;\n    }\n  }, [fn, timeout, errorDisplayMode, showErrorOnFailure, showError, onSuccess, onError]);\n\n  const reset = useCallback(() => {\n    setIsLoading(false);\n    setError(null);\n    setData(undefined);\n    abortControllerRef.current?.abort();\n  }, []);\n\n  return {\n    execute,\n    isLoading,\n    error,\n    data,\n    reset,\n  };\n}\n\n/**\n * Races an existing promise against a timeout rejection without cancelling either task.\n * @typeParam T - Promise result shape.\n * @param promise - Already-started host operation.\n * @param timeout - Delay in milliseconds before TimeoutError rejection; defaults to 30000.\n * @returns Original result if it wins the race.\n * @throws Rejects with the original rejection or TimeoutError, whichever settles first.\n * @remarks No React context is required. The timer is not cleared when the host promise\n * settles; timeout does not abort the operation or roll back its effects.\n * @example\n * ```ts\n * import { withTimeout } from '@alneas/appkit-react/tools/core';\n * export function limited<T>(operation: Promise<T>) { return withTimeout(operation, 5000); }\n * ```\n */\nexport async function withTimeout<T>(\n  promise: Promise<T>,\n  timeout: number = DEFAULT_TIMEOUT,\n): Promise<T> {\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    setTimeout(() => {\n      reject(new TimeoutError('The operation timed out', timeout));\n    }, timeout);\n  });\n\n  return Promise.race([promise, timeoutPromise]);\n}\n"],"mappings":";;;;;AAKA,IAAMA,IAAkB;AA0FxB,SAAgBC,EACd,GAC8B;CAC9B,IAAM,EACJ,OACA,aAAUD,GACV,sBAAmB,gBACnB,wBAAqB,IACrB,cACA,eACEE,GAEE,CAACC,GAAWC,KAAgBC,EAAS,EAAK,GAC1C,CAACC,GAAOC,KAAYF,EAA0B,IAAI,GAClD,CAACG,GAAMC,KAAWJ,EAAwB,KAAA,CAAS,GAEnD,EAAE,iBAAcK,EAAS,GACzBC,IAAqBC,EAA+B,IAAI,GACxDC,IAAeD,EAAO,EAAI;CA4DhC,OAzDAE,SACE,EAAa,UAAU,UACV;EAEX,AADA,EAAa,UAAU,IACvBH,EAAmB,SAAS,MAAM;CACpC,IACC,CAAC,CAAC,GAmDE;EACL,SAlDcI,EAAY,YAAoC;GAM9D,AAJAJ,EAAmB,SAAS,MAAM,GAClC,EAAmB,UAAU,IAAI,gBAAgB,GAEjDP,EAAa,EAAI,GACjBG,EAAS,IAAI;GAGb,IAAMS,IAAiB,IAAI,SAAgB,GAAG,MAAW;IACvD,iBAAiB;KACf,EAAO,IAAIC,EAAa,2BAA2BC,CAAO,CAAC;IAC7D,GAAGA,CAAO;GACZ,CAAC;GAED,IAAI;IAEF,IAAMC,IAAS,MAAM,QAAQ,KAAK,CAACC,EAAG,GAAGJ,CAAc,CAAC;IAQxD,OANIH,EAAa,YACfJ,EAAQU,CAAM,GACdf,EAAa,EAAK,GAClBiB,IAAYF,CAAM,IAGbA;GACT,SAASG,GAAK;IACZ,IAAI,CAACT,EAAa,SAAS;IAE3B,IAAMU,IAAWC,EAAS,KAAKF,GAAKG,CAAgB;IAQpD,AAPAlB,EAASgB,CAAQ,GACjBnB,EAAa,EAAK,GAEdsB,KACFC,EAAUJ,CAAQ,GAGpBK,IAAUL,CAAQ;IAClB;GACF;EACF,GAAG;GAACH;GAAIF;GAASO;GAAkBC;GAAoBC;GAAWN;GAAWO;EAAO,CAUlF;EACA;EACA;EACA;EACA,OAZYb,QAAkB;GAI9B,AAHAX,EAAa,EAAK,GAClBG,EAAS,IAAI,GACbE,EAAQ,KAAA,CAAS,GACjBE,EAAmB,SAAS,MAAM;EACpC,GAAG,CAAC,CAOF;CACF;AACF;AAiBA,eAAsBkB,EACpB,GACA,IAAkB7B,GACN;CACZ,IAAMgB,IAAiB,IAAI,SAAgB,GAAG,MAAW;EACvD,iBAAiB;GACf,EAAO,IAAIC,EAAa,2BAA2BC,CAAO,CAAC;EAC7D,GAAGA,CAAO;CACZ,CAAC;CAED,OAAO,QAAQ,KAAK,CAACY,GAASd,CAAc,CAAC;AAC/C"}

package/dist/tools/lib/hooks/useError.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useError.cjs","names":["useErrorStore","useCallback","AppError","m","require_messages","require_tools_lib_error_AppError","require_tools_lib_state_error_store","react","useError","appError","error","showOptions","options","addError","i18nKey","code","messageFunc","message","removeError","id","clearErrors"],"sources":["../../../../src/tools/lib/hooks/useError.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport * as m from '../../paraglide/messages.js';\nimport { AppError, ErrorDisplayMode } from \"../error\";\nimport { useErrorStore } from \"../state/error-store\";\n\nexport interface UseErrorOptions {\n  /** デフォルトの表示モード */\n  defaultDisplayMode?: ErrorDisplayMode;\n  /** デフォルトの自動消去時間 (ミリ秒)。undefined で自動消去しない */\n  defaultAutoDismiss?: number;\n}\n\nexport interface ShowErrorOptions {\n  /** 表示モードを上書き */\n  displayMode?: ErrorDisplayMode;\n  /** 自動消去時間 (ミリ秒) */\n  autoDismiss?: number;\n}\n\n/**\n * エラー表示を管理するフック\n *\n * @example\n * ```tsx\n * const { showError, showErrorByCode, clearError, clearAll } = useError();\n *\n * // AppError を表示\n * showError(new AppError('auth/user-not-found', 'Not found'));\n *\n * // エラーコードから表示\n * showErrorByCode('auth/wrong-password');\n *\n * // 任意のエラーを表示 (自動変換)\n * showError(unknownError);\n * ```\n */\nexport function useError(options?: UseErrorOptions) {\n  const { addError, removeError, clearErrors, errors, getErrorsByMode } = useErrorStore();\n\n  /**\n   * エラーを表示\n   * @param error - エラーオブジェクト (AppError または任意の Error)\n   * @param showOptions - 追加オプション\n   * @returns エラー ID\n   */\n  const showError = useCallback(\n    (error: unknown, showOptions?: ShowErrorOptions): string => {\n      const appError = AppError.from(\n        error,\n        showOptions?.displayMode ?? options?.defaultDisplayMode,\n      );\n\n      return addError(appError, {\n        autoDismiss: showOptions?.autoDismiss ?? options?.defaultAutoDismiss,\n      });\n    },\n    [addError, options?.defaultDisplayMode, options?.defaultAutoDismiss],\n  );\n\n  /**\n   * エラーコードから i18n メッセージを取得して表示\n   * @param code - エラーコード (例: 'auth/user-not-found')\n   * @param showOptions - 追加オプション\n   * @returns エラー ID\n   */\n  const showErrorByCode = useCallback(\n    (code: string, showOptions?: ShowErrorOptions & { displayMode?: ErrorDisplayMode }): string => {\n      // i18n からメッセージを取得 (見つからなければコードをそのまま使用)\n      // code format example: \"auth/user-not-found\" -> \"errors_auth_user_not_found\"\n      const i18nKey = `errors_${code.replace(/[/.]/g, '_')}`;\n      const messageFunc = (m as unknown as Record<string, () => string>)[i18nKey];\n      const message = typeof messageFunc === 'function' ? messageFunc() : code;\n\n      const appError = new AppError(code, message, {\n        displayMode: showOptions?.displayMode ?? options?.defaultDisplayMode ?? 'notification',\n      });\n\n      return addError(appError, {\n        autoDismiss: showOptions?.autoDismiss ?? options?.defaultAutoDismiss,\n      });\n    },\n    [addError, options?.defaultDisplayMode, options?.defaultAutoDismiss],\n  );\n\n  /**\n   * i18n からエラーメッセージを取得\n   * (表示せずにメッセージだけ取得したい場合)\n   */\n  const getErrorMessage = useCallback((code: string): string => {\n    const i18nKey = `errors_${code.replace(/[/.]/g, '_')}`;\n    const messageFunc = (m as unknown as Record<string, () => string>)[i18nKey];\n    return typeof messageFunc === 'function' ? messageFunc() : code;\n  }, []);\n\n  /**\n   * 特定のエラーを消去\n   */\n  const clearError = useCallback(\n    (id: string) => {\n      removeError(id);\n    },\n    [removeError],\n  );\n\n  /**\n   * すべてのエラーを消去\n   */\n  const clearAll = useCallback(() => {\n    clearErrors();\n  }, [clearErrors]);\n\n  return {\n    showError,\n    showErrorByCode,\n    getErrorMessage,\n    clearError,\n    clearAll,\n    errors,\n    getErrorsByMode,\n  };\n}\n"],"mappings":"A,gOAoCA,SAAgBQ,EAAS,EAA2B,CAClD,GAAM,CAAE,WAAU,cAAa,cAAa,SAAQ,mBAAoBR,EAAAA,cAAc,EA0EtF,MAAO,CACL,WAAA,EAnEgBC,EAAAA,YAAAA,EACf,EAAgB,IAA2C,CAC1D,IAAMQ,EAAWP,EAAAA,SAAS,KACxBQ,EACAC,GAAa,aAAeC,GAAS,kBACvC,EAEA,OAAOC,EAASJ,EAAU,CACxB,YAAaE,GAAa,aAAeC,GAAS,kBACpD,CAAC,CACH,EACA,CAACC,EAAUD,GAAS,mBAAoBA,GAAS,kBAAkB,CAwDnE,EACA,iBAAA,EAhDsBX,EAAAA,YAAAA,EACrB,EAAc,IAAgF,CAG7F,IAAMa,EAAU,UAAUC,EAAK,QAAQ,QAAS,GAAG,IAC7CC,EAAeb,EAAAA,iBAA8CW,GAC7DG,EAAU,OAAOD,GAAgB,WAAaA,EAAY,EAAID,EAE9DN,EAAW,IAAIP,EAAAA,SAASa,EAAME,EAAS,CAC3C,YAAaN,GAAa,aAAeC,GAAS,oBAAsB,cAC1E,CAAC,EAED,OAAOC,EAASJ,EAAU,CACxB,YAAaE,GAAa,aAAeC,GAAS,kBACpD,CAAC,CACH,EACA,CAACC,EAAUD,GAAS,mBAAoBA,GAAS,kBAAkB,CAgCnE,EACA,iBAAA,EA1BsBX,EAAAA,YAAAA,CAAa,GAAyB,CAC5D,IAAMa,EAAU,UAAUC,EAAK,QAAQ,QAAS,GAAG,IAC7CC,EAAeb,EAAAA,iBAA8CW,GACnE,OAAO,OAAOE,GAAgB,WAAaA,EAAY,EAAID,CAC7D,EAAG,CAAC,CAsBF,EACA,YAAA,EAlBiBd,EAAAA,YAAAA,CAChB,GAAe,CACdiB,EAAYC,CAAE,CAChB,EACA,CAACD,CAAW,CAcZ,EACA,UAAA,EATejB,EAAAA,YAAAA,KAAkB,CACjCmB,EAAY,CACd,EAAG,CAACA,CAAW,CAOb,EACA,SACA,iBACF,CACF,C"}
+{"version":3,"file":"useError.cjs","names":["useErrorStore","useCallback","AppError","m","require_messages","require_tools_lib_error_AppError","require_tools_lib_state_error_store","react","useError","appError","error","showOptions","options","addError","i18nKey","code","messageFunc","message","removeError","id","clearErrors"],"sources":["../../../../src/tools/lib/hooks/useError.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport * as m from '../../paraglide/messages.js';\nimport { AppError, ErrorDisplayMode } from \"../error\";\nimport { useErrorStore } from \"../state/error-store\";\n\n/**\n * Default normalization and queued-error lifetime settings.\n * @see useError for usage.\n */\nexport interface UseErrorOptions {\n    /**\n   * Default hint for newly wrapped errors; omission uses notification. Existing AppError values retain their own mode.\n   */\n  defaultDisplayMode?: ErrorDisplayMode;\n    /**\n   * Default positive removal delay in milliseconds; omission leaves errors queued.\n   */\n  defaultAutoDismiss?: number;\n}\n\n/**\n * Per-call display/lifetime overrides for queued errors.\n * @see useError for usage.\n */\nexport interface ShowErrorOptions {\n    /**\n   * Per-call hint for newly wrapped errors; does not override an existing AppError instance.\n   */\n  displayMode?: ErrorDisplayMode;\n    /**\n   * Per-call removal delay in milliseconds, overriding the default when non-nullish; positive values schedule removal.\n   */\n  autoDismiss?: number;\n}\n\n/**\n * Normalizes unknown errors and manages their entries in the shared error queue.\n * @param options - Optional default display hint and auto-dismiss delay.\n * @returns Queue, display/filter/message helpers and individual/all removal controls.\n * @remarks Requires React; no provider or CSS is needed by the hook. A host renderer must\n * display queued errors. Existing AppError values retain their mode even when a display\n * option is supplied. Code localization replaces slash/dot with underscores; unsupported\n * message keys fall back to the code. State/timers belong to the module, not this hook.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Report({ failure }: { failure: unknown }) { const { showError } = useError(); return <button onClick={() => showError(failure)}>Report</button>; }\n * ```\n */\nexport function useError(options?: UseErrorOptions) {\n  const { addError, removeError, clearErrors, errors, getErrorsByMode } = useErrorStore();\n\n  /**\n * Normalize and enqueue an unknown error.\n * @param error - AppError, Error or arbitrary thrown value.\n * @param showOptions - Optional display hint and removal delay.\n * @returns Generated error ID.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Controls() { const errors = useError(); return <button onClick={() => errors.showError(new Error('Unavailable'))}>Error action</button>; }\n * ```\n */\n  const showError = useCallback(\n    (error: unknown, showOptions?: ShowErrorOptions): string => {\n      const appError = AppError.from(\n        error,\n        showOptions?.displayMode ?? options?.defaultDisplayMode,\n      );\n\n      return addError(appError, {\n        autoDismiss: showOptions?.autoDismiss ?? options?.defaultAutoDismiss,\n      });\n    },\n    [addError, options?.defaultDisplayMode, options?.defaultAutoDismiss],\n  );\n\n  /**\n * Enqueue a new AppError using a localized code lookup.\n * @param code - Host error code; unknown codes are displayed unchanged.\n * @param showOptions - Optional display hint and removal delay.\n * @returns Generated error ID.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Controls() { const errors = useError(); return <button onClick={() => errors.showErrorByCode('error/example')}>Error action</button>; }\n * ```\n */\n  const showErrorByCode = useCallback(\n    (code: string, showOptions?: ShowErrorOptions & {\n      /** Per-call display hint, defaulting to hook settings then notification. */\n      displayMode?: ErrorDisplayMode;\n    }): string => {\n      // i18n からメッセージを取得 (見つからなければコードをそのまま使用)\n      // code format example: \"auth/user-not-found\" -> \"errors_auth_user_not_found\"\n      const i18nKey = `errors_${code.replace(/[/.]/g, '_')}`;\n      const messageFunc = (m as unknown as Record<string, () => string>)[i18nKey];\n      const message = typeof messageFunc === 'function' ? messageFunc() : code;\n\n      const appError = new AppError(code, message, {\n        displayMode: showOptions?.displayMode ?? options?.defaultDisplayMode ?? 'notification',\n      });\n\n      return addError(appError, {\n        autoDismiss: showOptions?.autoDismiss ?? options?.defaultAutoDismiss,\n      });\n    },\n    [addError, options?.defaultDisplayMode, options?.defaultAutoDismiss],\n  );\n\n  /**\n * Resolve the current localized error message without queuing it.\n * @param code - Error code mapped by replacing slash/dot with underscores.\n * @returns Localized message or the original code when no message function exists.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Controls() { const errors = useError(); return <button onClick={() => console.log(errors.getErrorMessage('error/example'))}>Error action</button>; }\n * ```\n */\n  const getErrorMessage = useCallback((code: string): string => {\n    const i18nKey = `errors_${code.replace(/[/.]/g, '_')}`;\n    const messageFunc = (m as unknown as Record<string, () => string>)[i18nKey];\n    return typeof messageFunc === 'function' ? messageFunc() : code;\n  }, []);\n\n  /**\n * Remove one error from the queue.\n * @param id - Generated error ID; unknown IDs are ignored.\n * @returns No value after removal.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Controls() { const errors = useError(); return <button onClick={() => errors.clearError('host-selected-id')}>Error action</button>; }\n * ```\n */\n  const clearError = useCallback(\n    (id: string) => {\n      removeError(id);\n    },\n    [removeError],\n  );\n\n  /**\n * Remove all currently queued errors.\n * @returns No value; scheduled timers remain harmlessly pending.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Controls() { const errors = useError(); return <button onClick={() => errors.clearAll()}>Error action</button>; }\n * ```\n */\n  const clearAll = useCallback(() => {\n    clearErrors();\n  }, [clearErrors]);\n\n  return {\n/**\n * Normalize and queue errors; see the local showError declaration for argument/result details.\n */\n    showError,\n/**\n * Queue a localized code; see the local showErrorByCode declaration.\n */\n    showErrorByCode,\n/**\n * Look up localized text; see the local getErrorMessage declaration.\n */\n    getErrorMessage,\n/**\n * Remove an error by ID; see the local clearError declaration.\n */\n    clearError,\n/**\n * Clear queued errors; see the local clearAll declaration.\n */\n    clearAll,\n/**\n * Current errors in insertion order.\n */\n    errors,\n/**\n * Current store filter operation; see ErrorState.getErrorsByMode.\n */\n    getErrorsByMode,\n  };\n}\n"],"mappings":"A,gOAiDA,SAAgBQ,EAAS,EAA2B,CAClD,GAAM,CAAE,WAAU,cAAa,cAAa,SAAQ,mBAAoBR,EAAAA,cAAc,EA0GtF,MAAO,CAIL,WAAA,EAjGgBC,EAAAA,YAAAA,EACf,EAAgB,IAA2C,CAC1D,IAAMQ,EAAWP,EAAAA,SAAS,KACxBQ,EACAC,GAAa,aAAeC,GAAS,kBACvC,EAEA,OAAOC,EAASJ,EAAU,CACxB,YAAaE,GAAa,aAAeC,GAAS,kBACpD,CAAC,CACH,EACA,CAACC,EAAUD,GAAS,mBAAoBA,GAAS,kBAAkB,CAsFnE,EAIA,iBAAA,EA5EsBX,EAAAA,YAAAA,EACrB,EAAc,IAGD,CAGZ,IAAMa,EAAU,UAAUC,EAAK,QAAQ,QAAS,GAAG,IAC7CC,EAAeb,EAAAA,iBAA8CW,GAC7DG,EAAU,OAAOD,GAAgB,WAAaA,EAAY,EAAID,EAE9DN,EAAW,IAAIP,EAAAA,SAASa,EAAME,EAAS,CAC3C,YAAaN,GAAa,aAAeC,GAAS,oBAAsB,cAC1E,CAAC,EAED,OAAOC,EAASJ,EAAU,CACxB,YAAaE,GAAa,aAAeC,GAAS,kBACpD,CAAC,CACH,EACA,CAACC,EAAUD,GAAS,mBAAoBA,GAAS,kBAAkB,CAyDnE,EAIA,iBAAA,EAhDsBX,EAAAA,YAAAA,CAAa,GAAyB,CAC5D,IAAMa,EAAU,UAAUC,EAAK,QAAQ,QAAS,GAAG,IAC7CC,EAAeb,EAAAA,iBAA8CW,GACnE,OAAO,OAAOE,GAAgB,WAAaA,EAAY,EAAID,CAC7D,EAAG,CAAC,CA4CF,EAIA,YAAA,EApCiBd,EAAAA,YAAAA,CAChB,GAAe,CACdiB,EAAYC,CAAE,CAChB,EACA,CAACD,CAAW,CAgCZ,EAIA,UAAA,EAxBejB,EAAAA,YAAAA,KAAkB,CACjCmB,EAAY,CACd,EAAG,CAACA,CAAW,CAsBb,EAIA,SAIA,iBACF,CACF,C"}

package/dist/tools/lib/hooks/useError.d.cts

@@ -1,41 +1,76 @@
 import { ErrorDisplayMode } from '../error/index.cjs';
+/**
+ * Default normalization and queued-error lifetime settings.
+ * @see useError for usage.
+ */
 export interface UseErrorOptions {
-    /** デフォルトの表示モード */
+    /**
+   * Default hint for newly wrapped errors; omission uses notification. Existing AppError values retain their own mode.
+   */
     defaultDisplayMode?: ErrorDisplayMode;
-    /** デフォルトの自動消去時間 (ミリ秒)。undefined で自動消去しない */
+    /**
+   * Default positive removal delay in milliseconds; omission leaves errors queued.
+   */
     defaultAutoDismiss?: number;
 }
+/**
+ * Per-call display/lifetime overrides for queued errors.
+ * @see useError for usage.
+ */
 export interface ShowErrorOptions {
-    /** 表示モードを上書き */
+    /**
+   * Per-call hint for newly wrapped errors; does not override an existing AppError instance.
+   */
     displayMode?: ErrorDisplayMode;
-    /** 自動消去時間 (ミリ秒) */
+    /**
+   * Per-call removal delay in milliseconds, overriding the default when non-nullish; positive values schedule removal.
+   */
     autoDismiss?: number;
 }
 /**
- * エラー表示を管理するフック
- *
+ * Normalizes unknown errors and manages their entries in the shared error queue.
+ * @param options - Optional default display hint and auto-dismiss delay.
+ * @returns Queue, display/filter/message helpers and individual/all removal controls.
+ * @remarks Requires React; no provider or CSS is needed by the hook. A host renderer must
+ * display queued errors. Existing AppError values retain their mode even when a display
+ * option is supplied. Code localization replaces slash/dot with underscores; unsupported
+ * message keys fall back to the code. State/timers belong to the module, not this hook.
  * @example
  * ```tsx
- * const { showError, showErrorByCode, clearError, clearAll } = useError();
- *
- * // AppError を表示
- * showError(new AppError('auth/user-not-found', 'Not found'));
- *
- * // エラーコードから表示
- * showErrorByCode('auth/wrong-password');
- *
- * // 任意のエラーを表示 (自動変換)
- * showError(unknownError);
+ * import { useError } from '@alneas/appkit-react/tools/core';
+ * export function Report({ failure }: { failure: unknown }) { const { showError } = useError(); return <button onClick={() => showError(failure)}>Report</button>; }
  * ```
  */
 export declare function useError(options?: UseErrorOptions): {
+    /**
+     * Normalize and queue errors; see the local showError declaration for argument/result details.
+     */
     showError: (error: unknown, showOptions?: ShowErrorOptions) => string;
+    /**
+     * Queue a localized code; see the local showErrorByCode declaration.
+     */
     showErrorByCode: (code: string, showOptions?: ShowErrorOptions & {
+        /** Per-call display hint, defaulting to hook settings then notification. */
         displayMode?: ErrorDisplayMode;
     }) => string;
+    /**
+     * Look up localized text; see the local getErrorMessage declaration.
+     */
     getErrorMessage: (code: string) => string;
+    /**
+     * Remove an error by ID; see the local clearError declaration.
+     */
     clearError: (id: string) => void;
+    /**
+     * Clear queued errors; see the local clearAll declaration.
+     */
     clearAll: () => void;
+    /**
+     * Current errors in insertion order.
+     */
     errors: import('../state/error-store.cjs').ErrorItem[];
+    /**
+     * Current store filter operation; see ErrorState.getErrorsByMode.
+     */
     getErrorsByMode: (mode: ErrorDisplayMode) => import('../state/error-store.cjs').ErrorItem[];
 };

package/dist/tools/lib/hooks/useError.d.ts

@@ -1,41 +1,76 @@
 import { ErrorDisplayMode } from '../error/index.js';
+/**
+ * Default normalization and queued-error lifetime settings.
+ * @see useError for usage.
+ */
 export interface UseErrorOptions {
-    /** デフォルトの表示モード */
+    /**
+   * Default hint for newly wrapped errors; omission uses notification. Existing AppError values retain their own mode.
+   */
     defaultDisplayMode?: ErrorDisplayMode;
-    /** デフォルトの自動消去時間 (ミリ秒)。undefined で自動消去しない */
+    /**
+   * Default positive removal delay in milliseconds; omission leaves errors queued.
+   */
     defaultAutoDismiss?: number;
 }
+/**
+ * Per-call display/lifetime overrides for queued errors.
+ * @see useError for usage.
+ */
 export interface ShowErrorOptions {
-    /** 表示モードを上書き */
+    /**
+   * Per-call hint for newly wrapped errors; does not override an existing AppError instance.
+   */
     displayMode?: ErrorDisplayMode;
-    /** 自動消去時間 (ミリ秒) */
+    /**
+   * Per-call removal delay in milliseconds, overriding the default when non-nullish; positive values schedule removal.
+   */
     autoDismiss?: number;
 }
 /**
- * エラー表示を管理するフック
- *
+ * Normalizes unknown errors and manages their entries in the shared error queue.
+ * @param options - Optional default display hint and auto-dismiss delay.
+ * @returns Queue, display/filter/message helpers and individual/all removal controls.
+ * @remarks Requires React; no provider or CSS is needed by the hook. A host renderer must
+ * display queued errors. Existing AppError values retain their mode even when a display
+ * option is supplied. Code localization replaces slash/dot with underscores; unsupported
+ * message keys fall back to the code. State/timers belong to the module, not this hook.
  * @example
  * ```tsx
- * const { showError, showErrorByCode, clearError, clearAll } = useError();
- *
- * // AppError を表示
- * showError(new AppError('auth/user-not-found', 'Not found'));
- *
- * // エラーコードから表示
- * showErrorByCode('auth/wrong-password');
- *
- * // 任意のエラーを表示 (自動変換)
- * showError(unknownError);
+ * import { useError } from '@alneas/appkit-react/tools/core';
+ * export function Report({ failure }: { failure: unknown }) { const { showError } = useError(); return <button onClick={() => showError(failure)}>Report</button>; }
  * ```
  */
 export declare function useError(options?: UseErrorOptions): {
+    /**
+     * Normalize and queue errors; see the local showError declaration for argument/result details.
+     */
     showError: (error: unknown, showOptions?: ShowErrorOptions) => string;
+    /**
+     * Queue a localized code; see the local showErrorByCode declaration.
+     */
     showErrorByCode: (code: string, showOptions?: ShowErrorOptions & {
+        /** Per-call display hint, defaulting to hook settings then notification. */
         displayMode?: ErrorDisplayMode;
     }) => string;
+    /**
+     * Look up localized text; see the local getErrorMessage declaration.
+     */
     getErrorMessage: (code: string) => string;
+    /**
+     * Remove an error by ID; see the local clearError declaration.
+     */
     clearError: (id: string) => void;
+    /**
+     * Clear queued errors; see the local clearAll declaration.
+     */
     clearAll: () => void;
+    /**
+     * Current errors in insertion order.
+     */
     errors: import('../state/error-store.js').ErrorItem[];
+    /**
+     * Current store filter operation; see ErrorState.getErrorsByMode.
+     */
     getErrorsByMode: (mode: ErrorDisplayMode) => import('../state/error-store.js').ErrorItem[];
 };

package/dist/tools/lib/hooks/useError.js.map

@@ -1 +1 @@
-{"version":3,"file":"useError.js","names":["m","useError","useErrorStore","useCallback","appError","AppError","error","showOptions","options","addError","i18nKey","code","messageFunc","messages_exports","message","id","removeError","clearErrors"],"sources":["../../../../src/tools/lib/hooks/useError.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport * as m from '../../paraglide/messages.js';\nimport { AppError, ErrorDisplayMode } from \"../error\";\nimport { useErrorStore } from \"../state/error-store\";\n\nexport interface UseErrorOptions {\n  /** デフォルトの表示モード */\n  defaultDisplayMode?: ErrorDisplayMode;\n  /** デフォルトの自動消去時間 (ミリ秒)。undefined で自動消去しない */\n  defaultAutoDismiss?: number;\n}\n\nexport interface ShowErrorOptions {\n  /** 表示モードを上書き */\n  displayMode?: ErrorDisplayMode;\n  /** 自動消去時間 (ミリ秒) */\n  autoDismiss?: number;\n}\n\n/**\n * エラー表示を管理するフック\n *\n * @example\n * ```tsx\n * const { showError, showErrorByCode, clearError, clearAll } = useError();\n *\n * // AppError を表示\n * showError(new AppError('auth/user-not-found', 'Not found'));\n *\n * // エラーコードから表示\n * showErrorByCode('auth/wrong-password');\n *\n * // 任意のエラーを表示 (自動変換)\n * showError(unknownError);\n * ```\n */\nexport function useError(options?: UseErrorOptions) {\n  const { addError, removeError, clearErrors, errors, getErrorsByMode } = useErrorStore();\n\n  /**\n   * エラーを表示\n   * @param error - エラーオブジェクト (AppError または任意の Error)\n   * @param showOptions - 追加オプション\n   * @returns エラー ID\n   */\n  const showError = useCallback(\n    (error: unknown, showOptions?: ShowErrorOptions): string => {\n      const appError = AppError.from(\n        error,\n        showOptions?.displayMode ?? options?.defaultDisplayMode,\n      );\n\n      return addError(appError, {\n        autoDismiss: showOptions?.autoDismiss ?? options?.defaultAutoDismiss,\n      });\n    },\n    [addError, options?.defaultDisplayMode, options?.defaultAutoDismiss],\n  );\n\n  /**\n   * エラーコードから i18n メッセージを取得して表示\n   * @param code - エラーコード (例: 'auth/user-not-found')\n   * @param showOptions - 追加オプション\n   * @returns エラー ID\n   */\n  const showErrorByCode = useCallback(\n    (code: string, showOptions?: ShowErrorOptions & { displayMode?: ErrorDisplayMode }): string => {\n      // i18n からメッセージを取得 (見つからなければコードをそのまま使用)\n      // code format example: \"auth/user-not-found\" -> \"errors_auth_user_not_found\"\n      const i18nKey = `errors_${code.replace(/[/.]/g, '_')}`;\n      const messageFunc = (m as unknown as Record<string, () => string>)[i18nKey];\n      const message = typeof messageFunc === 'function' ? messageFunc() : code;\n\n      const appError = new AppError(code, message, {\n        displayMode: showOptions?.displayMode ?? options?.defaultDisplayMode ?? 'notification',\n      });\n\n      return addError(appError, {\n        autoDismiss: showOptions?.autoDismiss ?? options?.defaultAutoDismiss,\n      });\n    },\n    [addError, options?.defaultDisplayMode, options?.defaultAutoDismiss],\n  );\n\n  /**\n   * i18n からエラーメッセージを取得\n   * (表示せずにメッセージだけ取得したい場合)\n   */\n  const getErrorMessage = useCallback((code: string): string => {\n    const i18nKey = `errors_${code.replace(/[/.]/g, '_')}`;\n    const messageFunc = (m as unknown as Record<string, () => string>)[i18nKey];\n    return typeof messageFunc === 'function' ? messageFunc() : code;\n  }, []);\n\n  /**\n   * 特定のエラーを消去\n   */\n  const clearError = useCallback(\n    (id: string) => {\n      removeError(id);\n    },\n    [removeError],\n  );\n\n  /**\n   * すべてのエラーを消去\n   */\n  const clearAll = useCallback(() => {\n    clearErrors();\n  }, [clearErrors]);\n\n  return {\n    showError,\n    showErrorByCode,\n    getErrorMessage,\n    clearError,\n    clearAll,\n    errors,\n    getErrorsByMode,\n  };\n}\n"],"mappings":";;;;;;AAoCA,SAAgBC,EAAS,GAA2B;CAClD,IAAM,EAAE,aAAU,gBAAa,gBAAa,WAAQ,uBAAoBC,EAAc;CA0EtF,OAAO;EACL,WAnEgBC,GACf,GAAgB,MAA2C;GAC1D,IAAMC,IAAWC,EAAS,KACxBC,GACAC,GAAa,eAAeC,GAAS,kBACvC;GAEA,OAAOC,EAASL,GAAU,EACxB,aAAaG,GAAa,eAAeC,GAAS,mBACpD,CAAC;EACH,GACA;GAACC;GAAUD,GAAS;GAAoBA,GAAS;EAAkB,CAwDnE;EACA,iBAhDsBL,GACrB,GAAc,MAAgF;GAG7F,IAAMO,IAAU,UAAUC,EAAK,QAAQ,SAAS,GAAG,KAC7CC,IAAeZ,EAA8CU,IAC7DI,IAAU,OAAOF,KAAgB,aAAaA,EAAY,IAAID,GAE9DP,IAAW,IAAIC,EAASM,GAAMG,GAAS,EAC3C,aAAaP,GAAa,eAAeC,GAAS,sBAAsB,eAC1E,CAAC;GAED,OAAOC,EAASL,GAAU,EACxB,aAAaG,GAAa,eAAeC,GAAS,mBACpD,CAAC;EACH,GACA;GAACC;GAAUD,GAAS;GAAoBA,GAAS;EAAkB,CAgCnE;EACA,iBA1BsBL,GAAa,MAAyB;GAC5D,IAAMO,IAAU,UAAUC,EAAK,QAAQ,SAAS,GAAG,KAC7CC,IAAeZ,EAA8CU;GACnE,OAAO,OAAOE,KAAgB,aAAaA,EAAY,IAAID;EAC7D,GAAG,CAAC,CAsBF;EACA,YAlBiBR,GAChB,MAAe;GACd,EAAYY,CAAE;EAChB,GACA,CAACC,CAAW,CAcZ;EACA,UATeb,QAAkB;GACjC,EAAY;EACd,GAAG,CAACc,CAAW,CAOb;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"useError.js","names":["m","useError","useErrorStore","useCallback","appError","AppError","error","showOptions","options","addError","i18nKey","code","messageFunc","messages_exports","message","id","removeError","clearErrors"],"sources":["../../../../src/tools/lib/hooks/useError.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport * as m from '../../paraglide/messages.js';\nimport { AppError, ErrorDisplayMode } from \"../error\";\nimport { useErrorStore } from \"../state/error-store\";\n\n/**\n * Default normalization and queued-error lifetime settings.\n * @see useError for usage.\n */\nexport interface UseErrorOptions {\n    /**\n   * Default hint for newly wrapped errors; omission uses notification. Existing AppError values retain their own mode.\n   */\n  defaultDisplayMode?: ErrorDisplayMode;\n    /**\n   * Default positive removal delay in milliseconds; omission leaves errors queued.\n   */\n  defaultAutoDismiss?: number;\n}\n\n/**\n * Per-call display/lifetime overrides for queued errors.\n * @see useError for usage.\n */\nexport interface ShowErrorOptions {\n    /**\n   * Per-call hint for newly wrapped errors; does not override an existing AppError instance.\n   */\n  displayMode?: ErrorDisplayMode;\n    /**\n   * Per-call removal delay in milliseconds, overriding the default when non-nullish; positive values schedule removal.\n   */\n  autoDismiss?: number;\n}\n\n/**\n * Normalizes unknown errors and manages their entries in the shared error queue.\n * @param options - Optional default display hint and auto-dismiss delay.\n * @returns Queue, display/filter/message helpers and individual/all removal controls.\n * @remarks Requires React; no provider or CSS is needed by the hook. A host renderer must\n * display queued errors. Existing AppError values retain their mode even when a display\n * option is supplied. Code localization replaces slash/dot with underscores; unsupported\n * message keys fall back to the code. State/timers belong to the module, not this hook.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Report({ failure }: { failure: unknown }) { const { showError } = useError(); return <button onClick={() => showError(failure)}>Report</button>; }\n * ```\n */\nexport function useError(options?: UseErrorOptions) {\n  const { addError, removeError, clearErrors, errors, getErrorsByMode } = useErrorStore();\n\n  /**\n * Normalize and enqueue an unknown error.\n * @param error - AppError, Error or arbitrary thrown value.\n * @param showOptions - Optional display hint and removal delay.\n * @returns Generated error ID.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Controls() { const errors = useError(); return <button onClick={() => errors.showError(new Error('Unavailable'))}>Error action</button>; }\n * ```\n */\n  const showError = useCallback(\n    (error: unknown, showOptions?: ShowErrorOptions): string => {\n      const appError = AppError.from(\n        error,\n        showOptions?.displayMode ?? options?.defaultDisplayMode,\n      );\n\n      return addError(appError, {\n        autoDismiss: showOptions?.autoDismiss ?? options?.defaultAutoDismiss,\n      });\n    },\n    [addError, options?.defaultDisplayMode, options?.defaultAutoDismiss],\n  );\n\n  /**\n * Enqueue a new AppError using a localized code lookup.\n * @param code - Host error code; unknown codes are displayed unchanged.\n * @param showOptions - Optional display hint and removal delay.\n * @returns Generated error ID.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Controls() { const errors = useError(); return <button onClick={() => errors.showErrorByCode('error/example')}>Error action</button>; }\n * ```\n */\n  const showErrorByCode = useCallback(\n    (code: string, showOptions?: ShowErrorOptions & {\n      /** Per-call display hint, defaulting to hook settings then notification. */\n      displayMode?: ErrorDisplayMode;\n    }): string => {\n      // i18n からメッセージを取得 (見つからなければコードをそのまま使用)\n      // code format example: \"auth/user-not-found\" -> \"errors_auth_user_not_found\"\n      const i18nKey = `errors_${code.replace(/[/.]/g, '_')}`;\n      const messageFunc = (m as unknown as Record<string, () => string>)[i18nKey];\n      const message = typeof messageFunc === 'function' ? messageFunc() : code;\n\n      const appError = new AppError(code, message, {\n        displayMode: showOptions?.displayMode ?? options?.defaultDisplayMode ?? 'notification',\n      });\n\n      return addError(appError, {\n        autoDismiss: showOptions?.autoDismiss ?? options?.defaultAutoDismiss,\n      });\n    },\n    [addError, options?.defaultDisplayMode, options?.defaultAutoDismiss],\n  );\n\n  /**\n * Resolve the current localized error message without queuing it.\n * @param code - Error code mapped by replacing slash/dot with underscores.\n * @returns Localized message or the original code when no message function exists.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Controls() { const errors = useError(); return <button onClick={() => console.log(errors.getErrorMessage('error/example'))}>Error action</button>; }\n * ```\n */\n  const getErrorMessage = useCallback((code: string): string => {\n    const i18nKey = `errors_${code.replace(/[/.]/g, '_')}`;\n    const messageFunc = (m as unknown as Record<string, () => string>)[i18nKey];\n    return typeof messageFunc === 'function' ? messageFunc() : code;\n  }, []);\n\n  /**\n * Remove one error from the queue.\n * @param id - Generated error ID; unknown IDs are ignored.\n * @returns No value after removal.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Controls() { const errors = useError(); return <button onClick={() => errors.clearError('host-selected-id')}>Error action</button>; }\n * ```\n */\n  const clearError = useCallback(\n    (id: string) => {\n      removeError(id);\n    },\n    [removeError],\n  );\n\n  /**\n * Remove all currently queued errors.\n * @returns No value; scheduled timers remain harmlessly pending.\n * @example\n * ```tsx\n * import { useError } from '@alneas/appkit-react/tools/core';\n * export function Controls() { const errors = useError(); return <button onClick={() => errors.clearAll()}>Error action</button>; }\n * ```\n */\n  const clearAll = useCallback(() => {\n    clearErrors();\n  }, [clearErrors]);\n\n  return {\n/**\n * Normalize and queue errors; see the local showError declaration for argument/result details.\n */\n    showError,\n/**\n * Queue a localized code; see the local showErrorByCode declaration.\n */\n    showErrorByCode,\n/**\n * Look up localized text; see the local getErrorMessage declaration.\n */\n    getErrorMessage,\n/**\n * Remove an error by ID; see the local clearError declaration.\n */\n    clearError,\n/**\n * Clear queued errors; see the local clearAll declaration.\n */\n    clearAll,\n/**\n * Current errors in insertion order.\n */\n    errors,\n/**\n * Current store filter operation; see ErrorState.getErrorsByMode.\n */\n    getErrorsByMode,\n  };\n}\n"],"mappings":";;;;;;AAiDA,SAAgBC,EAAS,GAA2B;CAClD,IAAM,EAAE,aAAU,gBAAa,gBAAa,WAAQ,uBAAoBC,EAAc;CA0GtF,OAAO;EAIL,WAjGgBC,GACf,GAAgB,MAA2C;GAC1D,IAAMC,IAAWC,EAAS,KACxBC,GACAC,GAAa,eAAeC,GAAS,kBACvC;GAEA,OAAOC,EAASL,GAAU,EACxB,aAAaG,GAAa,eAAeC,GAAS,mBACpD,CAAC;EACH,GACA;GAACC;GAAUD,GAAS;GAAoBA,GAAS;EAAkB,CAsFnE;EAIA,iBA5EsBL,GACrB,GAAc,MAGD;GAGZ,IAAMO,IAAU,UAAUC,EAAK,QAAQ,SAAS,GAAG,KAC7CC,IAAeZ,EAA8CU,IAC7DI,IAAU,OAAOF,KAAgB,aAAaA,EAAY,IAAID,GAE9DP,IAAW,IAAIC,EAASM,GAAMG,GAAS,EAC3C,aAAaP,GAAa,eAAeC,GAAS,sBAAsB,eAC1E,CAAC;GAED,OAAOC,EAASL,GAAU,EACxB,aAAaG,GAAa,eAAeC,GAAS,mBACpD,CAAC;EACH,GACA;GAACC;GAAUD,GAAS;GAAoBA,GAAS;EAAkB,CAyDnE;EAIA,iBAhDsBL,GAAa,MAAyB;GAC5D,IAAMO,IAAU,UAAUC,EAAK,QAAQ,SAAS,GAAG,KAC7CC,IAAeZ,EAA8CU;GACnE,OAAO,OAAOE,KAAgB,aAAaA,EAAY,IAAID;EAC7D,GAAG,CAAC,CA4CF;EAIA,YApCiBR,GAChB,MAAe;GACd,EAAYY,CAAE;EAChB,GACA,CAACC,CAAW,CAgCZ;EAIA,UAxBeb,QAAkB;GACjC,EAAY;EACd,GAAG,CAACc,CAAW,CAsBb;EAIA;EAIA;CACF;AACF"}

package/dist/tools/lib/schema/ajv.cjs

@@ -1,2 +1,2 @@
-"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../paraglide/runtime.cjs");let t=require("@alneas/appkit-core/data");function n(n,r={}){let i=(0,t.createAjvValidator)(r);return async a=>{let o=r.locale||(typeof window<`u`?e.getLocale():`ja`),s=r.cast?(0,t.castValuesBySchema)(a,n,r.cast):a,c=r.emptyStrings===`preserve`?s:Object.fromEntries(Object.entries(s).map(([e,t])=>[e,t===``?void 0:t])),{valid:l,rawErrors:u}=i(n,c,{...r,locale:o});if(l)return{values:c,errors:{}};let d={};return u?.forEach(e=>{let t=(e.instancePath?e.instancePath.substring(1).split(`/`):[]).map(e=>e.replace(/~1/g,`/`).replace(/~0/g,`~`));e.keyword===`required`&&e.params?.missingProperty&&t.push(e.params.missingProperty);let n=t.length?t.flatMap(e=>e.split(`.`)):[`root`];if(n.some(e=>[`__proto__`,`constructor`,`prototype`].includes(e))){d.root={type:e.keyword,message:`Unsupported field path`};return}let r=d;for(let e of n.slice(0,-1))Object.hasOwn(r,e)||Object.defineProperty(r,e,{value:{},enumerable:!0,configurable:!0,writable:!0}),r=r[e];let i=n.at(-1);Object.hasOwn(r,i)||Object.defineProperty(r,i,{value:{message:e.message,type:e.keyword},enumerable:!0,configurable:!0})}),{values:{},errors:d}}}exports.createAjvResolver=n,Object.defineProperty(exports,"createAjvValidator",{enumerable:!0,get:function(){return t.createAjvValidator}});
+"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../paraglide/runtime.cjs");let t=require("@alneas/appkit-core/data");function n(n,r={}){let i=(0,t.createAjvValidator)(r);return async a=>{let o=r.locale||(typeof window<`u`?e.getLocale():`ja`),s=r.cast?(0,t.castValuesBySchema)(a,n,r.cast):a,c=r.emptyStrings===`preserve`?s:Object.fromEntries(Object.entries(s).map(([e,t])=>[e,t===``?void 0:t])),{valid:l,rawErrors:u}=i(n,c,{...r,locale:o});if(l)return{values:c,errors:{}};let d={};return u?.forEach(e=>{let t=(e.instancePath?e.instancePath.substring(1).split(`/`):[]).map(e=>e.replace(/~1/g,`/`).replace(/~0/g,`~`));e.keyword===`required`&&e.params?.missingProperty&&t.push(e.params.missingProperty);let n=t.length?t.flatMap(e=>e.split(`.`)):[`root`];if(n.some(e=>[`__proto__`,`constructor`,`prototype`].includes(e))){d.root={type:e.keyword,message:`Unsupported field path`};return}let r=d;for(let e of n.slice(0,-1))Object.hasOwn(r,e)||Object.defineProperty(r,e,{value:{},enumerable:!0,configurable:!0,writable:!0}),r=r[e];let i=n.at(-1);Object.hasOwn(r,i)||Object.defineProperty(r,i,{value:{message:e.message,type:e.keyword},enumerable:!0,configurable:!0,writable:!0})}),{values:{},errors:d}}}exports.createAjvResolver=n,Object.defineProperty(exports,"createAjvValidator",{enumerable:!0,get:function(){return t.createAjvValidator}});
 //# sourceMappingURL=ajv.cjs.map

package/dist/tools/lib/schema/ajv.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ajv.cjs","names":["createAjvValidator","getLocale","castValuesBySchema","require_runtime","_alneas_appkit_core_data","createAjvResolver","validator","options","currentLocale","normalized","values","schema","processedValues","key","value","valid","errors","rawErrors","parts","error","part","keys","target","leaf"],"sources":["../../../../src/tools/lib/schema/ajv.ts"],"sourcesContent":["import { createAjvValidator, type AjvValidatorOptions } from \"@alneas/appkit-core/data\";\nimport type { FieldValues, ResolverResult, FieldErrors } from 'react-hook-form';\nimport { castValuesBySchema, type SchemaCastOptions } from \"@alneas/appkit-core/data\";\nimport { getLocale } from '../../paraglide/runtime.js';\nexport { createAjvValidator, type AjvValidatorOptions };\n\n/** Options for schema forms. Legacy empty-string omission is retained unless preserve is selected. */\nexport interface SchemaFormValidationOptions extends AjvValidatorOptions {\n  /** Preserve empty strings for ordinary JSON Schema validation, or omit top-level empty strings (legacy default). */\n  emptyStrings?: 'preserve' | 'omit';\n  /** Optional non-mutating numeric normalization before validation; strict rejects partial numbers. */\n  cast?: SchemaCastOptions;\n}\n\n/**\n * Ajvを使用した React Hook Form 用の resolver を作成します。\n * このresolverは、アプリケーションの現在の言語設定（Paraglide）と自動的に連動します。\n *\n * @example\n * import { createAjvResolver } from '@alneas/appkit-react/tools/form';\n * const resolver = createAjvResolver({ type: 'object', properties: { hours: { type: 'number' } } }, { emptyStrings: 'preserve', cast: { numericMode: 'strict' } });\n * @param schema - バリデーションに使用する JSON Schema。\n * @param options - バリデーションオプション。localeを省略すると現在の言語設定が使用されます。\n * @returns React Hook Form の resolver プロパティに渡せる関数。\n */\nexport function createAjvResolver<T extends FieldValues = FieldValues>(schema: object, options: SchemaFormValidationOptions = {}): (values: T, context?: unknown, resolverOptions?: unknown) => Promise<ResolverResult<T>> {\n  const validator = createAjvValidator(options);\n\n  return async (values) => {\n    // Resolve current locale: priority is options.locale > paraglide.getLocale() > 'ja'\n    const currentLocale = options.locale || (typeof window !== 'undefined' ? getLocale() : 'ja');\n\n    // Pre-process values: convert empty strings to undefined.\n    // This is necessary because React Hook Form often defaults to \"\" for text inputs,\n    // which can trigger \"invalid format\" errors (e.g. for email) even if the field is not required.\n    const normalized = options.cast ? castValuesBySchema(values, schema, options.cast) : values;\n    const processedValues = options.emptyStrings === 'preserve' ? normalized : Object.fromEntries(\n      Object.entries(normalized).map(([key, value]) => [key, value === '' ? undefined : value]),\n    );\n\n    const {\n      valid,\n      rawErrors,\n    } = validator(schema, processedValues, {\n      ...options,\n      locale: currentLocale as any,\n    });\n\n    if (valid) {\n      return { values: processedValues, errors: {} };\n    }\n\n    const errors: any = {};\n    rawErrors?.forEach((error) => {\n      // Convert instancePath (/field/subfield) to dot notation (field.subfield)\n      const parts = (error.instancePath ? error.instancePath.substring(1).split('/') : []).map((part: string) => part.replace(/~1/g, '/').replace(/~0/g, '~'));\n      if (error.keyword === 'required' && error.params?.missingProperty) parts.push(error.params.missingProperty);\n      const keys: string[] = parts.length ? parts.flatMap((part: string) => part.split('.')) : ['root'];\n      if (keys.some(key => ['__proto__', 'constructor', 'prototype'].includes(key))) {\n        errors.root = { type: error.keyword, message: 'Unsupported field path' };\n        return;\n      }\n      let target = errors;\n      for (const key of keys.slice(0, -1)) {\n        if (!Object.hasOwn(target, key)) Object.defineProperty(target, key, {\n          value: {}, enumerable: true, configurable: true, writable: true,\n        });\n        target = target[key];\n      }\n      const leaf = keys.at(-1)!;\n      if (!Object.hasOwn(target, leaf)) Object.defineProperty(target, leaf, {\n        value: { message: error.message, type: error.keyword }, enumerable: true, configurable: true,\n      });\n    });\n\n    return {\n      values: {},\n      errors: errors as FieldErrors<T>,\n    };\n  };\n}\n"],"mappings":"A,yKAyBA,SAAgBK,EAAuD,EAAgB,EAAuC,CAAC,EAA4F,CACzN,IAAMC,GAAA,EAAYN,EAAAA,mBAAAA,CAAmBO,CAAO,EAE5C,OAAO,KAAO,IAAW,CAEvB,IAAMC,EAAgBD,EAAQ,SAAW,OAAO,OAAW,IAAcN,EAAAA,UAAU,EAAI,MAKjFQ,EAAaF,EAAQ,MAAA,EAAOL,EAAAA,mBAAAA,CAAmBQ,EAAQC,EAAQJ,EAAQ,IAAI,EAAIG,EAC/EE,EAAkBL,EAAQ,eAAiB,WAAaE,EAAa,OAAO,YAChF,OAAO,QAAQA,CAAU,CAAC,CAAC,KAAK,CAACI,EAAKC,KAAW,CAACD,EAAKC,IAAU,GAAK,IAAA,GAAYA,CAAK,CAAC,CAC1F,EAEM,CACJ,QACA,aACER,EAAUK,EAAQC,EAAiB,CACrC,GAAGL,EACH,OAAQC,CACV,CAAC,EAED,GAAIO,EACF,MAAO,CAAE,OAAQH,EAAiB,OAAQ,CAAC,CAAE,EAG/C,IAAMI,EAAc,CAAC,EAuBrB,OAtBAC,GAAW,QAAS,GAAU,CAE5B,IAAMC,GAASC,EAAM,aAAeA,EAAM,aAAa,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,EAAI,CAAC,EAAA,CAAG,IAAK,GAAiBC,EAAK,QAAQ,MAAO,GAAG,CAAC,CAAC,QAAQ,MAAO,GAAG,CAAC,EACnJD,EAAM,UAAY,YAAcA,EAAM,QAAQ,iBAAiBD,EAAM,KAAKC,EAAM,OAAO,eAAe,EAC1G,IAAME,EAAiBH,EAAM,OAASA,EAAM,QAAS,GAAiBE,EAAK,MAAM,GAAG,CAAC,EAAI,CAAC,MAAM,EAChG,GAAIC,EAAK,KAAK,GAAO,CAAC,YAAa,cAAe,WAAW,CAAC,CAAC,SAASR,CAAG,CAAC,EAAG,CAC7E,EAAO,KAAO,CAAE,KAAMM,EAAM,QAAS,QAAS,wBAAyB,EACvE,MACF,CACA,IAAIG,EAASN,EACb,IAAK,IAAMH,KAAOQ,EAAK,MAAM,EAAG,EAAE,EAC3B,OAAO,OAAOC,EAAQT,CAAG,GAAG,OAAO,eAAeS,EAAQT,EAAK,CAClE,MAAO,CAAC,EAAG,WAAY,GAAM,aAAc,GAAM,SAAU,EAC7D,CAAC,EACD,EAASS,EAAOT,GAElB,IAAMU,EAAOF,EAAK,GAAG,EAAE,EAClB,OAAO,OAAOC,EAAQC,CAAI,GAAG,OAAO,eAAeD,EAAQC,EAAM,CACpE,MAAO,CAAE,QAASJ,EAAM,QAAS,KAAMA,EAAM,OAAQ,EAAG,WAAY,GAAM,aAAc,EAC1F,CAAC,CACH,CAAC,EAEM,CACL,OAAQ,CAAC,EACD,QACV,CACF,CACF,C"}
+{"version":3,"file":"ajv.cjs","names":["createAjvValidator","getLocale","castValuesBySchema","require_runtime","_alneas_appkit_core_data","createAjvResolver","validator","options","currentLocale","normalized","values","schema","processedValues","key","value","valid","errors","rawErrors","parts","error","part","keys","target","leaf"],"sources":["../../../../src/tools/lib/schema/ajv.ts"],"sourcesContent":["import { createAjvValidator, type AjvValidatorOptions } from \"@alneas/appkit-core/data\";\nimport type { FieldValues, ResolverResult, FieldErrors } from 'react-hook-form';\nimport { castValuesBySchema, type SchemaCastOptions } from \"@alneas/appkit-core/data\";\nimport { getLocale } from '../../paraglide/runtime.js';\nexport { createAjvValidator, type AjvValidatorOptions };\n\n/**\n * JSON Schema validation/casting settings for React Hook Form.\n * @remarks Legacy top-level empty-string omission is default; preserve opts into ordinary schema validation.\n * @see createAjvResolver for usage.\n */\nexport interface SchemaFormValidationOptions extends AjvValidatorOptions {\n  /** Preserve empty strings for ordinary JSON Schema validation, or omit top-level empty strings (legacy default). */\n  emptyStrings?: 'preserve' | 'omit';\n  /** Optional non-mutating numeric normalization before validation; strict rejects partial numbers. */\n  cast?: SchemaCastOptions;\n}\n\n/**\n * Creates an asynchronous React Hook Form resolver using Core Ajv validation.\n * @typeParam T - Form values shape; defaults to FieldValues.\n * @param schema - JSON Schema accepted by Core validation.\n * @param options - Ajv options plus optional numeric casting and empty-string handling; defaults to {}.\n * @returns Resolver accepting values and optional ignored context/options, resolving normalized\n * values with no errors on success or empty values plus nested field errors on failure.\n * @throws Resolver rejects if schema compilation, casting or validator execution throws.\n * @remarks Optional cast runs first without mutating input. Unless emptyStrings is preserve,\n * top-level empty strings become undefined; nested empty strings are retained. Locale\n * uses options.locale, otherwise browser Paraglide locale, otherwise ja on the server.\n * Unsafe error-path keys map to a root error. No provider or CSS is required to create it.\n * @example\n * ```ts\n * import { createAjvResolver } from '@alneas/appkit-react/tools/form';\n * const resolver = createAjvResolver<{ hours: number }>({ type: 'object', properties: { hours: { type: 'number' } } }, { emptyStrings: 'preserve', cast: { numericMode: 'strict' } });\n * ```\n */\nexport function createAjvResolver<T extends FieldValues = FieldValues>(schema: object, options: SchemaFormValidationOptions = {}): (values: T, context?: unknown, resolverOptions?: unknown) => Promise<ResolverResult<T>> {\n  const validator = createAjvValidator(options);\n\n  return async (values) => {\n    // Resolve current locale: priority is options.locale > paraglide.getLocale() > 'ja'\n    const currentLocale = options.locale || (typeof window !== 'undefined' ? getLocale() : 'ja');\n\n    // Pre-process values: convert empty strings to undefined.\n    // This is necessary because React Hook Form often defaults to \"\" for text inputs,\n    // which can trigger \"invalid format\" errors (e.g. for email) even if the field is not required.\n    const normalized = options.cast ? castValuesBySchema(values, schema, options.cast) : values;\n    const processedValues = options.emptyStrings === 'preserve' ? normalized : Object.fromEntries(\n      Object.entries(normalized).map(([key, value]) => [key, value === '' ? undefined : value]),\n    );\n\n    const {\n      valid,\n      rawErrors,\n    } = validator(schema, processedValues, {\n      ...options,\n      locale: currentLocale as any,\n    });\n\n    if (valid) {\n      return { values: processedValues, errors: {} };\n    }\n\n    const errors: any = {};\n    rawErrors?.forEach((error) => {\n      // Convert instancePath (/field/subfield) to dot notation (field.subfield)\n      const parts = (error.instancePath ? error.instancePath.substring(1).split('/') : []).map((part: string) => part.replace(/~1/g, '/').replace(/~0/g, '~'));\n      if (error.keyword === 'required' && error.params?.missingProperty) parts.push(error.params.missingProperty);\n      const keys: string[] = parts.length ? parts.flatMap((part: string) => part.split('.')) : ['root'];\n      if (keys.some(key => ['__proto__', 'constructor', 'prototype'].includes(key))) {\n        errors.root = { type: error.keyword, message: 'Unsupported field path' };\n        return;\n      }\n      let target = errors;\n      for (const key of keys.slice(0, -1)) {\n        if (!Object.hasOwn(target, key)) Object.defineProperty(target, key, {\n          value: {}, enumerable: true, configurable: true, writable: true,\n        });\n        target = target[key];\n      }\n      const leaf = keys.at(-1)!;\n      if (!Object.hasOwn(target, leaf)) Object.defineProperty(target, leaf, {\n        value: { message: error.message, type: error.keyword }, enumerable: true, configurable: true, writable: true,\n      });\n    });\n\n    return {\n      values: {},\n      errors: errors as FieldErrors<T>,\n    };\n  };\n}\n"],"mappings":"A,yKAoCA,SAAgBK,EAAuD,EAAgB,EAAuC,CAAC,EAA4F,CACzN,IAAMC,GAAA,EAAYN,EAAAA,mBAAAA,CAAmBO,CAAO,EAE5C,OAAO,KAAO,IAAW,CAEvB,IAAMC,EAAgBD,EAAQ,SAAW,OAAO,OAAW,IAAcN,EAAAA,UAAU,EAAI,MAKjFQ,EAAaF,EAAQ,MAAA,EAAOL,EAAAA,mBAAAA,CAAmBQ,EAAQC,EAAQJ,EAAQ,IAAI,EAAIG,EAC/EE,EAAkBL,EAAQ,eAAiB,WAAaE,EAAa,OAAO,YAChF,OAAO,QAAQA,CAAU,CAAC,CAAC,KAAK,CAACI,EAAKC,KAAW,CAACD,EAAKC,IAAU,GAAK,IAAA,GAAYA,CAAK,CAAC,CAC1F,EAEM,CACJ,QACA,aACER,EAAUK,EAAQC,EAAiB,CACrC,GAAGL,EACH,OAAQC,CACV,CAAC,EAED,GAAIO,EACF,MAAO,CAAE,OAAQH,EAAiB,OAAQ,CAAC,CAAE,EAG/C,IAAMI,EAAc,CAAC,EAuBrB,OAtBAC,GAAW,QAAS,GAAU,CAE5B,IAAMC,GAASC,EAAM,aAAeA,EAAM,aAAa,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,EAAI,CAAC,EAAA,CAAG,IAAK,GAAiBC,EAAK,QAAQ,MAAO,GAAG,CAAC,CAAC,QAAQ,MAAO,GAAG,CAAC,EACnJD,EAAM,UAAY,YAAcA,EAAM,QAAQ,iBAAiBD,EAAM,KAAKC,EAAM,OAAO,eAAe,EAC1G,IAAME,EAAiBH,EAAM,OAASA,EAAM,QAAS,GAAiBE,EAAK,MAAM,GAAG,CAAC,EAAI,CAAC,MAAM,EAChG,GAAIC,EAAK,KAAK,GAAO,CAAC,YAAa,cAAe,WAAW,CAAC,CAAC,SAASR,CAAG,CAAC,EAAG,CAC7E,EAAO,KAAO,CAAE,KAAMM,EAAM,QAAS,QAAS,wBAAyB,EACvE,MACF,CACA,IAAIG,EAASN,EACb,IAAK,IAAMH,KAAOQ,EAAK,MAAM,EAAG,EAAE,EAC3B,OAAO,OAAOC,EAAQT,CAAG,GAAG,OAAO,eAAeS,EAAQT,EAAK,CAClE,MAAO,CAAC,EAAG,WAAY,GAAM,aAAc,GAAM,SAAU,EAC7D,CAAC,EACD,EAASS,EAAOT,GAElB,IAAMU,EAAOF,EAAK,GAAG,EAAE,EAClB,OAAO,OAAOC,EAAQC,CAAI,GAAG,OAAO,eAAeD,EAAQC,EAAM,CACpE,MAAO,CAAE,QAASJ,EAAM,QAAS,KAAMA,EAAM,OAAQ,EAAG,WAAY,GAAM,aAAc,GAAM,SAAU,EAC1G,CAAC,CACH,CAAC,EAEM,CACL,OAAQ,CAAC,EACD,QACV,CACF,CACF,C"}

package/dist/tools/lib/schema/ajv.d.cts

@@ -1,7 +1,11 @@
 import { createAjvValidator, AjvValidatorOptions, SchemaCastOptions } from '@alneas/appkit-core/data';
 import { FieldValues, ResolverResult } from 'react-hook-form';
 export { createAjvValidator, type AjvValidatorOptions };
-/** Options for schema forms. Legacy empty-string omission is retained unless preserve is selected. */
+/**
+ * JSON Schema validation/casting settings for React Hook Form.
+ * @remarks Legacy top-level empty-string omission is default; preserve opts into ordinary schema validation.
+ * @see createAjvResolver for usage.
+ */
 export interface SchemaFormValidationOptions extends AjvValidatorOptions {
     /** Preserve empty strings for ordinary JSON Schema validation, or omit top-level empty strings (legacy default). */
     emptyStrings?: 'preserve' | 'omit';
@@ -9,14 +13,21 @@ export interface SchemaFormValidationOptions extends AjvValidatorOptions {
     cast?: SchemaCastOptions;
 }
 /**
- * Ajvを使用した React Hook Form 用の resolver を作成します。
- * このresolverは、アプリケーションの現在の言語設定（Paraglide）と自動的に連動します。
- *
+ * Creates an asynchronous React Hook Form resolver using Core Ajv validation.
+ * @typeParam T - Form values shape; defaults to FieldValues.
+ * @param schema - JSON Schema accepted by Core validation.
+ * @param options - Ajv options plus optional numeric casting and empty-string handling; defaults to {}.
+ * @returns Resolver accepting values and optional ignored context/options, resolving normalized
+ * values with no errors on success or empty values plus nested field errors on failure.
+ * @throws Resolver rejects if schema compilation, casting or validator execution throws.
+ * @remarks Optional cast runs first without mutating input. Unless emptyStrings is preserve,
+ * top-level empty strings become undefined; nested empty strings are retained. Locale
+ * uses options.locale, otherwise browser Paraglide locale, otherwise ja on the server.
+ * Unsafe error-path keys map to a root error. No provider or CSS is required to create it.
  * @example
+ * ```ts
  * import { createAjvResolver } from '@alneas/appkit-react/tools/form';
- * const resolver = createAjvResolver({ type: 'object', properties: { hours: { type: 'number' } } }, { emptyStrings: 'preserve', cast: { numericMode: 'strict' } });
- * @param schema - バリデーションに使用する JSON Schema。
- * @param options - バリデーションオプション。localeを省略すると現在の言語設定が使用されます。
- * @returns React Hook Form の resolver プロパティに渡せる関数。
+ * const resolver = createAjvResolver<{ hours: number }>({ type: 'object', properties: { hours: { type: 'number' } } }, { emptyStrings: 'preserve', cast: { numericMode: 'strict' } });
+ * ```
  */
 export declare function createAjvResolver<T extends FieldValues = FieldValues>(schema: object, options?: SchemaFormValidationOptions): (values: T, context?: unknown, resolverOptions?: unknown) => Promise<ResolverResult<T>>;

package/dist/tools/lib/schema/ajv.d.ts

@@ -1,7 +1,11 @@
 import { createAjvValidator, AjvValidatorOptions, SchemaCastOptions } from '@alneas/appkit-core/data';
 import { FieldValues, ResolverResult } from 'react-hook-form';
 export { createAjvValidator, type AjvValidatorOptions };
-/** Options for schema forms. Legacy empty-string omission is retained unless preserve is selected. */
+/**
+ * JSON Schema validation/casting settings for React Hook Form.
+ * @remarks Legacy top-level empty-string omission is default; preserve opts into ordinary schema validation.
+ * @see createAjvResolver for usage.
+ */
 export interface SchemaFormValidationOptions extends AjvValidatorOptions {
     /** Preserve empty strings for ordinary JSON Schema validation, or omit top-level empty strings (legacy default). */
     emptyStrings?: 'preserve' | 'omit';
@@ -9,14 +13,21 @@ export interface SchemaFormValidationOptions extends AjvValidatorOptions {
     cast?: SchemaCastOptions;
 }
 /**
- * Ajvを使用した React Hook Form 用の resolver を作成します。
- * このresolverは、アプリケーションの現在の言語設定（Paraglide）と自動的に連動します。
- *
+ * Creates an asynchronous React Hook Form resolver using Core Ajv validation.
+ * @typeParam T - Form values shape; defaults to FieldValues.
+ * @param schema - JSON Schema accepted by Core validation.
+ * @param options - Ajv options plus optional numeric casting and empty-string handling; defaults to {}.
+ * @returns Resolver accepting values and optional ignored context/options, resolving normalized
+ * values with no errors on success or empty values plus nested field errors on failure.
+ * @throws Resolver rejects if schema compilation, casting or validator execution throws.
+ * @remarks Optional cast runs first without mutating input. Unless emptyStrings is preserve,
+ * top-level empty strings become undefined; nested empty strings are retained. Locale
+ * uses options.locale, otherwise browser Paraglide locale, otherwise ja on the server.
+ * Unsafe error-path keys map to a root error. No provider or CSS is required to create it.
  * @example
+ * ```ts
  * import { createAjvResolver } from '@alneas/appkit-react/tools/form';
- * const resolver = createAjvResolver({ type: 'object', properties: { hours: { type: 'number' } } }, { emptyStrings: 'preserve', cast: { numericMode: 'strict' } });
- * @param schema - バリデーションに使用する JSON Schema。
- * @param options - バリデーションオプション。localeを省略すると現在の言語設定が使用されます。
- * @returns React Hook Form の resolver プロパティに渡せる関数。
+ * const resolver = createAjvResolver<{ hours: number }>({ type: 'object', properties: { hours: { type: 'number' } } }, { emptyStrings: 'preserve', cast: { numericMode: 'strict' } });
+ * ```
  */
 export declare function createAjvResolver<T extends FieldValues = FieldValues>(schema: object, options?: SchemaFormValidationOptions): (values: T, context?: unknown, resolverOptions?: unknown) => Promise<ResolverResult<T>>;

package/dist/tools/lib/schema/ajv.js

@@ -43,7 +43,8 @@ function r(r, i = {}) {
 					type: e.keyword
 				},
 				enumerable: !0,
-				configurable: !0
+				configurable: !0,
+				writable: !0
 			});
 		}), {
 			values: {},