@alneas/appkit-react 0.1.0 → 0.2.0

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

@@ -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 };

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

@@ -1 +1 @@
-{"version":3,"file":"use-toast.js","names":["React","React$1","TOAST_LIMIT","TOAST_REMOVE_DELAY","count","genId","toastTimeouts","addToRemoveQueue","toastId","timeout","dispatch","reducer","action","state","t","toast","listeners","memoryState","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":";;;AAEA,IAAME,IAAc,GACdC,IAAqB,KAoBvBC,IAAQ;AAEZ,SAASC,IAAQ;CAEf,OADA,KAASD,IAAQ,oBACVA,EAAM,SAAS;AACxB;AA0BA,IAAME,oBAAgB,IAAI,IAA2C,GAE/DC,KAAoB,MAAoB;CAC5C,IAAID,EAAc,IAAIE,CAAO,GAC3B;CAGF,IAAMC,IAAU,iBAAiB;EAE/B,AADAH,EAAc,OAAOE,CAAO,GAC5BE,EAAS;GACP,MAAM;GACG;EACX,CAAC;CACH,GAAGP,CAAkB;CAErB,EAAc,IAAIK,GAASC,CAAO;AACpC,GAQaE,KAAW,GAAc,MAA0B;CAC9D,QAAQC,EAAO,MAAf;EACE,KAAK,aACH,OAAO;GACL,GAAGC;GACH,QAAQ,CAACD,EAAO,OAAO,GAAGC,EAAM,MAAM,CAAC,CAAC,MAAM,GAAGX,CAAW;EAC9D;EAEF,KAAK,gBACH,OAAO;GACL,GAAGW;GACH,QAAQA,EAAM,OAAO,KAAK,MAAOC,EAAE,OAAOF,EAAO,MAAM,KAAK;IAAE,GAAGE;IAAG,GAAGF,EAAO;GAAM,IAAIE,CAAE;EAC5F;EAEF,KAAK,iBAAiB;GACpB,IAAM,EAAE,eAAYF;GAUpB,OARIJ,IACFD,EAAiBC,CAAO,IAExBK,EAAM,OAAO,SAAS,MAAU;IAC9B,EAAiBE,EAAM,EAAE;GAC3B,CAAC,GAGI;IACL,GAAGF;IACH,QAAQA,EAAM,OAAO,KAAK,MACxBC,EAAE,OAAON,KAAWA,MAAY,KAAA,IAC5B;KACE,GAAGM;KACH,MAAM;IACR,IACAA,CACN;GACF;EACF;EACA,KAAK,gBAOH,OANIF,EAAO,YAAY,KAAA,IACd;GACL,GAAGC;GACH,QAAQ,CAAC;EACX,IAEK;GACL,GAAGA;GACH,QAAQA,EAAM,OAAO,QAAQ,MAAMC,EAAE,OAAOF,EAAO,OAAO;EAC5D;CACJ;AACF,GAEMI,IAA2C,CAAC,GAE9CC,IAAqB,EAAE,QAAQ,CAAC,EAAE;AAEtC,SAASP,EAAS,GAAgB;CAEhC,AADA,IAAcC,EAAQM,GAAaL,CAAM,GACzCI,EAAU,SAAS,MAAa;EAC9B,EAASC,CAAW;CACtB,CAAC;AACH;AAYA,SAASF,EAAM,EAAE,aAAU,GAAGG,KAAwC;CACpE,IAAMC,IAAKd,EAAM,GAGXe,IAAiBC,MAAaH,EAAM,YAAY,gBAAgB,MAAO,MAEvEI,KAAU,MACdZ,EAAS;EACP,MAAM;EACN,OAAO;GAAE,GAAGQ;GAAO;EAAG;CACxB,CAAC,GACGK,UAAgBb,EAAS;EAAE,MAAM;EAAiB,SAASS;CAAG,CAAC;CAerE,OAbAT,EAAS;EACP,MAAM;EACN,OAAO;GACL,GAAGQ;GACH;GACA,UAAUE;GACV,MAAM;GACN,eAAe,MAAkB;IAC/B,AAAKI,KAAMD,EAAQ;GACrB;EACF;CACF,CAAC,GAEM;EACD;EACJ;EACA;CACF;AACF;AAKA,EAAM,WAAW,GAAwB,MACvCR,EAAM;CAAE;CAAO,GAAGU;CAAS,SAAS;AAAU,CAAC,GAKjD,EAAM,SAAS,GAAwB,MACrCV,EAAM;CAAE;CAAO,GAAGU;CAAS,SAAS;AAAc,CAAC,GAKrD,EAAM,QAAQ,GAAwB,MACpCV,EAAM;CAAE;CAAO,GAAGU;CAAS,SAAS;AAAU,CAAC;AAejD,SAASC,IAAW;CAClB,IAAM,CAACb,GAAOc,KAAY3B,EAAM,SAAgBiB,CAAW;CAY3D,OAVAhB,EAAM,iBACJe,EAAU,KAAKW,CAAQ,SACV;EACX,IAAMC,IAAQZ,EAAU,QAAQW,CAAQ;EACxC,AAAIC,IAAQ,MACVZ,EAAU,OAAOY,GAAO,CAAC;CAE7B,IACC,CAACf,CAAK,CAAC,GAEH;EACL,GAAGA;EACH;EACA,UAAU,MAAqBH,EAAS;GAAE,MAAM;GAAiB;EAAQ,CAAC;CAC5E;AACF"}
+{"version":3,"file":"use-toast.js","names":["React","React$1","TOAST_LIMIT","TOAST_REMOVE_DELAY","count","genId","toastTimeouts","addToRemoveQueue","toastId","timeout","dispatch","reducer","action","state","t","toast","listeners","memoryState","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/ime-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ime-utils.cjs","names":["toHalfWidth","str","s","normalizeNumericInput","val","getNextNumericValue","base","current","result","direction","step","precision"],"sources":["../../../src/ui/lib/ime-utils.ts"],"sourcesContent":["/**\n * 全角文字（数字、記号）を半角に変換します。\n * @param str - 変換対象の文字列\n * @returns 半角変換後の文字列\n */\nexport function toHalfWidth(str: string): string {\n  return str\n    .replace(/[！-～]/g, (s) => {\n      return String.fromCharCode(s.charCodeAt(0) - 0xfee0);\n    })\n    .replace(/\\u3000/g, ' ');\n}\n\n/**\n * 数値入力フィールド用に、全角を半角に変換し、不正な文字を除去します。\n * 0-9, '.', '-' 以外の文字を除去します。\n * @param val - 正規化対象の文字列\n * @returns 正規化後の文字列\n */\nexport function normalizeNumericInput(val: string): string {\n  if (!val) return '';\n  const hw = toHalfWidth(val);\n  return hw.replace(/[^0-9.-]/g, '');\n}\n\n/**\n * 上下キーによる数値増減の計算を行います。\n * 浮動小数点の計算誤差を考慮した結果を返します。\n * @param current - 現在の数値（文字列または数値）\n * @param direction - 増減の方向 ('up' | 'down')\n * @param step - 増減のステップ量\n * @returns 次の数値\n */\nexport function getNextNumericValue(\n  current: string | number | null | undefined,\n  direction: 'up' | 'down',\n  step: number = 1,\n): number {\n  const base = typeof current === 'number' ? current : parseFloat(String(current || '0'));\n  const validBase = isNaN(base) ? 0 : base;\n  const delta = direction === 'up' ? step : -step;\n\n  const result = validBase + delta;\n  const precision = (String(step).split('.')[1] || '').length;\n  return parseFloat(result.toFixed(precision));\n}\n"],"mappings":"A,gFAKA,SAAgBA,EAAY,EAAqB,CAC/C,OAAOC,EACJ,QAAQ,SAAW,GACX,OAAO,aAAaC,EAAE,WAAW,CAAC,EAAI,KAAM,CACpD,CAAC,CACD,QAAQ,UAAW,GAAG,CAC3B,CAQA,SAAgBC,EAAsB,EAAqB,CAGzD,OAFKC,EACMJ,EAAYI,CAChB,CAAA,CAAG,QAAQ,YAAa,EAAE,EAFhB,EAGnB,CAUA,SAAgBC,EACd,EACA,EACA,EAAe,EACP,CACR,IAAMC,EAAO,OAAOC,GAAY,SAAWA,EAAU,WAAW,OAAOA,GAAW,GAAG,CAAC,EAIhFC,GAHY,MAAMF,CAAI,EAAI,EAAIA,IACtBG,IAAc,KAAOC,EAAO,CAACA,GAGrCC,GAAa,OAAOD,CAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAM,GAAA,CAAI,OACrD,OAAO,WAAWF,EAAO,QAAQG,CAAS,CAAC,CAC7C,C"}
+{"version":3,"file":"ime-utils.cjs","names":["toHalfWidth","str","s","normalizeNumericInput","val","getNextNumericValue","base","current","result","direction","step","precision"],"sources":["../../../src/ui/lib/ime-utils.ts"],"sourcesContent":["/**\n * Converts full-width ASCII punctuation/letters/digits and ideographic spaces to ASCII.\n *\n * @param str - Input text; other Unicode characters are retained.\n *\n * @returns Converted text without mutating the input.\n *\n * @example\n * ```ts\n * import { toHalfWidth } from '@alneas/appkit-react/ui/utils';\n * const text = toHalfWidth('１２３　Ａ'); // '123 A'\n * ```\n */\nexport function toHalfWidth(str: string): string {\n  return str\n    .replace(/[！-～]/g, (s) => {\n      return String.fromCharCode(s.charCodeAt(0) - 0xfee0);\n    })\n    .replace(/\\u3000/g, ' ');\n}\n\n/**\n * Converts full-width ASCII and removes characters other than digits, dots and hyphens.\n *\n * @param val - Raw numeric input text; empty input remains empty.\n *\n * @returns Filtered text; repeated signs/dots are retained, so this is not numeric validation.\n *\n * @example\n * ```ts\n * import { normalizeNumericInput } from '@alneas/appkit-react/ui/utils';\n * const text = normalizeNumericInput('￥１２.３'); // '12.3'\n * ```\n */\nexport function normalizeNumericInput(val: string): string {\n  if (!val) return '';\n  const hw = toHalfWidth(val);\n  return hw.replace(/[^0-9.-]/g, '');\n}\n\n/**\n * Adds or subtracts a step and rounds using the step's decimal spelling.\n *\n * @param current - Number or parseFloat-compatible text; missing, empty or NaN input uses zero.\n *\n * @param direction - Up adds step; down subtracts it.\n *\n * @param step - Delta magnitude, default 1; decimal precision is derived from String(step).\n *\n * @returns Next number rounded with toFixed; no min/max clamp is applied.\n *\n * @remarks Exponential step spellings have no decimal digits in this calculation; this\n * helper is not arbitrary-precision arithmetic.\n *\n * @example\n * ```ts\n * import { getNextNumericValue } from '@alneas/appkit-react/ui/utils';\n * const next = getNextNumericValue('1.2', 'up', 0.1); // 1.3\n * ```\n */\nexport function getNextNumericValue(\n  current: string | number | null | undefined,\n  direction: 'up' | 'down',\n  step: number = 1,\n): number {\n  const base = typeof current === 'number' ? current : parseFloat(String(current || '0'));\n  const validBase = isNaN(base) ? 0 : base;\n  const delta = direction === 'up' ? step : -step;\n\n  const result = validBase + delta;\n  const precision = (String(step).split('.')[1] || '').length;\n  return parseFloat(result.toFixed(precision));\n}\n"],"mappings":"A,gFAaA,SAAgBA,EAAY,EAAqB,CAC/C,OAAOC,EACJ,QAAQ,SAAW,GACX,OAAO,aAAaC,EAAE,WAAW,CAAC,EAAI,KAAM,CACpD,CAAC,CACD,QAAQ,UAAW,GAAG,CAC3B,CAeA,SAAgBC,EAAsB,EAAqB,CAGzD,OAFKC,EACMJ,EAAYI,CAChB,CAAA,CAAG,QAAQ,YAAa,EAAE,EAFhB,EAGnB,CAsBA,SAAgBC,EACd,EACA,EACA,EAAe,EACP,CACR,IAAMC,EAAO,OAAOC,GAAY,SAAWA,EAAU,WAAW,OAAOA,GAAW,GAAG,CAAC,EAIhFC,GAHY,MAAMF,CAAI,EAAI,EAAIA,IACtBG,IAAc,KAAOC,EAAO,CAACA,GAGrCC,GAAa,OAAOD,CAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAM,GAAA,CAAI,OACrD,OAAO,WAAWF,EAAO,QAAQG,CAAS,CAAC,CAC7C,C"}

package/dist/ui/lib/ime-utils.d.cts

@@ -1,22 +1,49 @@
 /**
- * 全角文字（数字、記号）を半角に変換します。
- * @param str - 変換対象の文字列
- * @returns 半角変換後の文字列
+ * Converts full-width ASCII punctuation/letters/digits and ideographic spaces to ASCII.
+ *
+ * @param str - Input text; other Unicode characters are retained.
+ *
+ * @returns Converted text without mutating the input.
+ *
+ * @example
+ * ```ts
+ * import { toHalfWidth } from '@alneas/appkit-react/ui/utils';
+ * const text = toHalfWidth('１２３　Ａ'); // '123 A'
+ * ```
  */
 export declare function toHalfWidth(str: string): string;
 /**
- * 数値入力フィールド用に、全角を半角に変換し、不正な文字を除去します。
- * 0-9, '.', '-' 以外の文字を除去します。
- * @param val - 正規化対象の文字列
- * @returns 正規化後の文字列
+ * Converts full-width ASCII and removes characters other than digits, dots and hyphens.
+ *
+ * @param val - Raw numeric input text; empty input remains empty.
+ *
+ * @returns Filtered text; repeated signs/dots are retained, so this is not numeric validation.
+ *
+ * @example
+ * ```ts
+ * import { normalizeNumericInput } from '@alneas/appkit-react/ui/utils';
+ * const text = normalizeNumericInput('￥１２.３'); // '12.3'
+ * ```
  */
 export declare function normalizeNumericInput(val: string): string;
 /**
- * 上下キーによる数値増減の計算を行います。
- * 浮動小数点の計算誤差を考慮した結果を返します。
- * @param current - 現在の数値（文字列または数値）
- * @param direction - 増減の方向 ('up' | 'down')
- * @param step - 増減のステップ量
- * @returns 次の数値
+ * Adds or subtracts a step and rounds using the step's decimal spelling.
+ *
+ * @param current - Number or parseFloat-compatible text; missing, empty or NaN input uses zero.
+ *
+ * @param direction - Up adds step; down subtracts it.
+ *
+ * @param step - Delta magnitude, default 1; decimal precision is derived from String(step).
+ *
+ * @returns Next number rounded with toFixed; no min/max clamp is applied.
+ *
+ * @remarks Exponential step spellings have no decimal digits in this calculation; this
+ * helper is not arbitrary-precision arithmetic.
+ *
+ * @example
+ * ```ts
+ * import { getNextNumericValue } from '@alneas/appkit-react/ui/utils';
+ * const next = getNextNumericValue('1.2', 'up', 0.1); // 1.3
+ * ```
  */
 export declare function getNextNumericValue(current: string | number | null | undefined, direction: 'up' | 'down', step?: number): number;

package/dist/ui/lib/ime-utils.d.ts

@@ -1,22 +1,49 @@
 /**
- * 全角文字（数字、記号）を半角に変換します。
- * @param str - 変換対象の文字列
- * @returns 半角変換後の文字列
+ * Converts full-width ASCII punctuation/letters/digits and ideographic spaces to ASCII.
+ *
+ * @param str - Input text; other Unicode characters are retained.
+ *
+ * @returns Converted text without mutating the input.
+ *
+ * @example
+ * ```ts
+ * import { toHalfWidth } from '@alneas/appkit-react/ui/utils';
+ * const text = toHalfWidth('１２３　Ａ'); // '123 A'
+ * ```
  */
 export declare function toHalfWidth(str: string): string;
 /**
- * 数値入力フィールド用に、全角を半角に変換し、不正な文字を除去します。
- * 0-9, '.', '-' 以外の文字を除去します。
- * @param val - 正規化対象の文字列
- * @returns 正規化後の文字列
+ * Converts full-width ASCII and removes characters other than digits, dots and hyphens.
+ *
+ * @param val - Raw numeric input text; empty input remains empty.
+ *
+ * @returns Filtered text; repeated signs/dots are retained, so this is not numeric validation.
+ *
+ * @example
+ * ```ts
+ * import { normalizeNumericInput } from '@alneas/appkit-react/ui/utils';
+ * const text = normalizeNumericInput('￥１２.３'); // '12.3'
+ * ```
  */
 export declare function normalizeNumericInput(val: string): string;
 /**
- * 上下キーによる数値増減の計算を行います。
- * 浮動小数点の計算誤差を考慮した結果を返します。
- * @param current - 現在の数値（文字列または数値）
- * @param direction - 増減の方向 ('up' | 'down')
- * @param step - 増減のステップ量
- * @returns 次の数値
+ * Adds or subtracts a step and rounds using the step's decimal spelling.
+ *
+ * @param current - Number or parseFloat-compatible text; missing, empty or NaN input uses zero.
+ *
+ * @param direction - Up adds step; down subtracts it.
+ *
+ * @param step - Delta magnitude, default 1; decimal precision is derived from String(step).
+ *
+ * @returns Next number rounded with toFixed; no min/max clamp is applied.
+ *
+ * @remarks Exponential step spellings have no decimal digits in this calculation; this
+ * helper is not arbitrary-precision arithmetic.
+ *
+ * @example
+ * ```ts
+ * import { getNextNumericValue } from '@alneas/appkit-react/ui/utils';
+ * const next = getNextNumericValue('1.2', 'up', 0.1); // 1.3
+ * ```
  */
 export declare function getNextNumericValue(current: string | number | null | undefined, direction: 'up' | 'down', step?: number): number;

package/dist/ui/lib/ime-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"ime-utils.js","names":["toHalfWidth","str","s","normalizeNumericInput","val","getNextNumericValue","base","current","result","direction","step","precision"],"sources":["../../../src/ui/lib/ime-utils.ts"],"sourcesContent":["/**\n * 全角文字（数字、記号）を半角に変換します。\n * @param str - 変換対象の文字列\n * @returns 半角変換後の文字列\n */\nexport function toHalfWidth(str: string): string {\n  return str\n    .replace(/[！-～]/g, (s) => {\n      return String.fromCharCode(s.charCodeAt(0) - 0xfee0);\n    })\n    .replace(/\\u3000/g, ' ');\n}\n\n/**\n * 数値入力フィールド用に、全角を半角に変換し、不正な文字を除去します。\n * 0-9, '.', '-' 以外の文字を除去します。\n * @param val - 正規化対象の文字列\n * @returns 正規化後の文字列\n */\nexport function normalizeNumericInput(val: string): string {\n  if (!val) return '';\n  const hw = toHalfWidth(val);\n  return hw.replace(/[^0-9.-]/g, '');\n}\n\n/**\n * 上下キーによる数値増減の計算を行います。\n * 浮動小数点の計算誤差を考慮した結果を返します。\n * @param current - 現在の数値（文字列または数値）\n * @param direction - 増減の方向 ('up' | 'down')\n * @param step - 増減のステップ量\n * @returns 次の数値\n */\nexport function getNextNumericValue(\n  current: string | number | null | undefined,\n  direction: 'up' | 'down',\n  step: number = 1,\n): number {\n  const base = typeof current === 'number' ? current : parseFloat(String(current || '0'));\n  const validBase = isNaN(base) ? 0 : base;\n  const delta = direction === 'up' ? step : -step;\n\n  const result = validBase + delta;\n  const precision = (String(step).split('.')[1] || '').length;\n  return parseFloat(result.toFixed(precision));\n}\n"],"mappings":";;AAKA,SAAgBA,EAAY,GAAqB;CAC/C,OAAOC,EACJ,QAAQ,WAAW,MACX,OAAO,aAAaC,EAAE,WAAW,CAAC,IAAI,KAAM,CACpD,CAAC,CACD,QAAQ,WAAW,GAAG;AAC3B;AAQA,SAAgBC,EAAsB,GAAqB;CAGzD,OAFKC,IACMJ,EAAYI,CAChB,CAAA,CAAG,QAAQ,aAAa,EAAE,IAFhB;AAGnB;AAUA,SAAgBC,EACd,GACA,GACA,IAAe,GACP;CACR,IAAMC,IAAO,OAAOC,KAAY,WAAWA,IAAU,WAAW,OAAOA,KAAW,GAAG,CAAC,GAIhFC,KAHY,MAAMF,CAAI,IAAI,IAAIA,MACtBG,MAAc,OAAOC,IAAO,CAACA,IAGrCC,KAAa,OAAOD,CAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAA,CAAI;CACrD,OAAO,WAAWF,EAAO,QAAQG,CAAS,CAAC;AAC7C"}
+{"version":3,"file":"ime-utils.js","names":["toHalfWidth","str","s","normalizeNumericInput","val","getNextNumericValue","base","current","result","direction","step","precision"],"sources":["../../../src/ui/lib/ime-utils.ts"],"sourcesContent":["/**\n * Converts full-width ASCII punctuation/letters/digits and ideographic spaces to ASCII.\n *\n * @param str - Input text; other Unicode characters are retained.\n *\n * @returns Converted text without mutating the input.\n *\n * @example\n * ```ts\n * import { toHalfWidth } from '@alneas/appkit-react/ui/utils';\n * const text = toHalfWidth('１２３　Ａ'); // '123 A'\n * ```\n */\nexport function toHalfWidth(str: string): string {\n  return str\n    .replace(/[！-～]/g, (s) => {\n      return String.fromCharCode(s.charCodeAt(0) - 0xfee0);\n    })\n    .replace(/\\u3000/g, ' ');\n}\n\n/**\n * Converts full-width ASCII and removes characters other than digits, dots and hyphens.\n *\n * @param val - Raw numeric input text; empty input remains empty.\n *\n * @returns Filtered text; repeated signs/dots are retained, so this is not numeric validation.\n *\n * @example\n * ```ts\n * import { normalizeNumericInput } from '@alneas/appkit-react/ui/utils';\n * const text = normalizeNumericInput('￥１２.３'); // '12.3'\n * ```\n */\nexport function normalizeNumericInput(val: string): string {\n  if (!val) return '';\n  const hw = toHalfWidth(val);\n  return hw.replace(/[^0-9.-]/g, '');\n}\n\n/**\n * Adds or subtracts a step and rounds using the step's decimal spelling.\n *\n * @param current - Number or parseFloat-compatible text; missing, empty or NaN input uses zero.\n *\n * @param direction - Up adds step; down subtracts it.\n *\n * @param step - Delta magnitude, default 1; decimal precision is derived from String(step).\n *\n * @returns Next number rounded with toFixed; no min/max clamp is applied.\n *\n * @remarks Exponential step spellings have no decimal digits in this calculation; this\n * helper is not arbitrary-precision arithmetic.\n *\n * @example\n * ```ts\n * import { getNextNumericValue } from '@alneas/appkit-react/ui/utils';\n * const next = getNextNumericValue('1.2', 'up', 0.1); // 1.3\n * ```\n */\nexport function getNextNumericValue(\n  current: string | number | null | undefined,\n  direction: 'up' | 'down',\n  step: number = 1,\n): number {\n  const base = typeof current === 'number' ? current : parseFloat(String(current || '0'));\n  const validBase = isNaN(base) ? 0 : base;\n  const delta = direction === 'up' ? step : -step;\n\n  const result = validBase + delta;\n  const precision = (String(step).split('.')[1] || '').length;\n  return parseFloat(result.toFixed(precision));\n}\n"],"mappings":";;AAaA,SAAgBA,EAAY,GAAqB;CAC/C,OAAOC,EACJ,QAAQ,WAAW,MACX,OAAO,aAAaC,EAAE,WAAW,CAAC,IAAI,KAAM,CACpD,CAAC,CACD,QAAQ,WAAW,GAAG;AAC3B;AAeA,SAAgBC,EAAsB,GAAqB;CAGzD,OAFKC,IACMJ,EAAYI,CAChB,CAAA,CAAG,QAAQ,aAAa,EAAE,IAFhB;AAGnB;AAsBA,SAAgBC,EACd,GACA,GACA,IAAe,GACP;CACR,IAAMC,IAAO,OAAOC,KAAY,WAAWA,IAAU,WAAW,OAAOA,KAAW,GAAG,CAAC,GAIhFC,KAHY,MAAMF,CAAI,IAAI,IAAIA,MACtBG,MAAc,OAAOC,IAAO,CAACA,IAGrCC,KAAa,OAAOD,CAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAA,CAAI;CACrD,OAAO,WAAWF,EAAO,QAAQG,CAAS,CAAC;AAC7C"}

package/dist/ui/lib/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":["twMerge","clsx","tailwind_merge","cn","inputs"],"sources":["../../../src/ui/lib/utils.ts"],"sourcesContent":["import { type ClassValue, clsx } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\n/**\n * Tailwind CSS のクラス名を安全に結合し、競合を解決します。\n * clsx で条件付きクラスを処理し、tailwind-merge で重複するスタイルを上書きします。\n *\n * @param inputs - 結合するクラス名の配列（文字列、オブジェクト、ブール値など）\n * @returns 最適化されたクラス名文字列\n *\n * @example\n * ```typescript\n * cn('px-2 py-1', isPrimary && 'bg-blue-500', className)\n * ```\n */\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n"],"mappings":"A,kIAeA,SAAgBG,EAAG,GAAGC,EAAsB,CAC1C,OAAA,EAAOJ,EAAAA,QAAAA,EAAAA,EAAQC,EAAA,KAAA,CAAKG,CAAM,CAAC,CAC7B,C"}
+{"version":3,"file":"utils.cjs","names":["twMerge","clsx","tailwind_merge","cn","inputs"],"sources":["../../../src/ui/lib/utils.ts"],"sourcesContent":["import { type ClassValue, clsx } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\n/**\n * Combines conditional class values with clsx and resolves Tailwind conflicts with tailwind-merge.\n *\n * @param inputs - Class strings, arrays or conditional objects accepted by clsx.\n *\n * @returns A merged class string; later conflicting Tailwind utilities generally win.\n *\n * @remarks Pure formatting helper; no React provider or stylesheet is required to call it.\n *\n * @example\n * ```ts\n * import { cn } from '@alneas/appkit-react/ui/utils';\n * const className = cn('px-2 py-1', { 'bg-blue-500': true }, 'px-4');\n * ```\n */\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n"],"mappings":"A,kIAkBA,SAAgBG,EAAG,GAAGC,EAAsB,CAC1C,OAAA,EAAOJ,EAAAA,QAAAA,EAAAA,EAAQC,EAAA,KAAA,CAAKG,CAAM,CAAC,CAC7B,C"}

package/dist/ui/lib/utils.d.cts

@@ -1,14 +1,17 @@
 import { ClassValue } from 'clsx';
 /**
- * Tailwind CSS のクラス名を安全に結合し、競合を解決します。
- * clsx で条件付きクラスを処理し、tailwind-merge で重複するスタイルを上書きします。
+ * Combines conditional class values with clsx and resolves Tailwind conflicts with tailwind-merge.
  *
- * @param inputs - 結合するクラス名の配列（文字列、オブジェクト、ブール値など）
- * @returns 最適化されたクラス名文字列
+ * @param inputs - Class strings, arrays or conditional objects accepted by clsx.
+ *
+ * @returns A merged class string; later conflicting Tailwind utilities generally win.
+ *
+ * @remarks Pure formatting helper; no React provider or stylesheet is required to call it.
  *
  * @example
- * ```typescript
- * cn('px-2 py-1', isPrimary && 'bg-blue-500', className)
+ * ```ts
+ * import { cn } from '@alneas/appkit-react/ui/utils';
+ * const className = cn('px-2 py-1', { 'bg-blue-500': true }, 'px-4');
  * ```
  */
 export declare function cn(...inputs: ClassValue[]): string;

package/dist/ui/lib/utils.d.ts

@@ -1,14 +1,17 @@
 import { ClassValue } from 'clsx';
 /**
- * Tailwind CSS のクラス名を安全に結合し、競合を解決します。
- * clsx で条件付きクラスを処理し、tailwind-merge で重複するスタイルを上書きします。
+ * Combines conditional class values with clsx and resolves Tailwind conflicts with tailwind-merge.
  *
- * @param inputs - 結合するクラス名の配列（文字列、オブジェクト、ブール値など）
- * @returns 最適化されたクラス名文字列
+ * @param inputs - Class strings, arrays or conditional objects accepted by clsx.
+ *
+ * @returns A merged class string; later conflicting Tailwind utilities generally win.
+ *
+ * @remarks Pure formatting helper; no React provider or stylesheet is required to call it.
  *
  * @example
- * ```typescript
- * cn('px-2 py-1', isPrimary && 'bg-blue-500', className)
+ * ```ts
+ * import { cn } from '@alneas/appkit-react/ui/utils';
+ * const className = cn('px-2 py-1', { 'bg-blue-500': true }, 'px-4');
  * ```
  */
 export declare function cn(...inputs: ClassValue[]): string;

package/dist/ui/lib/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":["cn","inputs","twMerge","clsx"],"sources":["../../../src/ui/lib/utils.ts"],"sourcesContent":["import { type ClassValue, clsx } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\n/**\n * Tailwind CSS のクラス名を安全に結合し、競合を解決します。\n * clsx で条件付きクラスを処理し、tailwind-merge で重複するスタイルを上書きします。\n *\n * @param inputs - 結合するクラス名の配列（文字列、オブジェクト、ブール値など）\n * @returns 最適化されたクラス名文字列\n *\n * @example\n * ```typescript\n * cn('px-2 py-1', isPrimary && 'bg-blue-500', className)\n * ```\n */\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n"],"mappings":";;;;AAeA,SAAgBA,EAAG,GAAGC,GAAsB;CAC1C,OAAOC,EAAQC,EAAKF,CAAM,CAAC;AAC7B"}
+{"version":3,"file":"utils.js","names":["cn","inputs","twMerge","clsx"],"sources":["../../../src/ui/lib/utils.ts"],"sourcesContent":["import { type ClassValue, clsx } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\n/**\n * Combines conditional class values with clsx and resolves Tailwind conflicts with tailwind-merge.\n *\n * @param inputs - Class strings, arrays or conditional objects accepted by clsx.\n *\n * @returns A merged class string; later conflicting Tailwind utilities generally win.\n *\n * @remarks Pure formatting helper; no React provider or stylesheet is required to call it.\n *\n * @example\n * ```ts\n * import { cn } from '@alneas/appkit-react/ui/utils';\n * const className = cn('px-2 py-1', { 'bg-blue-500': true }, 'px-4');\n * ```\n */\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n"],"mappings":";;;;AAkBA,SAAgBA,EAAG,GAAGC,GAAsB;CAC1C,OAAOC,EAAQC,EAAKF,CAAM,CAAC;AAC7B"}

package/docs/ai.md

@@ -1,8 +1,11 @@
 ---
 title: "Review AI proposals in React"
 description: "React proposal review and generative UI bindings"
+sidebar:
+  order: 2
 archetype: how-to
-project: tools
+project: appkit
+tags: ["appkit", "ai"]
 ---
 
 # Review AI proposals in React
@@ -35,3 +38,33 @@ Type-check this example in your application. See [the export reference](exports.
 ## Troubleshooting / Common Pitfalls
 
 React proposal review and generative UI bindings. The optional chat transport requires the ai SDK peer. Proposals do not authorize execution or stored-record changes.
+
+## Prompt injection and review permissions
+
+Transport text, tool-call arguments, retrieved files and tool outputs are untrusted. The optional `ai` peer is needed only by the SDK chat binding; a chat transport never approves or executes a tool. Keep provider secrets in a server-owned endpoint.
+
+Use the [Core validation and approval sequence](../../appkit-core/docs/ai.md) before presenting a proposal. Display the exact immutable target and arguments, require explicit approval for writes or sensitive disclosure, and invalidate approval when the call, session or registration changes. The server must independently enforce resource permissions, concurrency and durable idempotency at execution time. A React component, assistant message or SDK tool-output event is not authorization.
+
+Render registered components only, keep React text rendering escaped, and project minimal validated outputs. Do not evaluate generated code or embed arbitrary model HTML. Cancellation cannot roll back completed writes; reconcile uncertain effects before retrying. See [Core error recovery](../../appkit-core/docs/ai-errors.md).
+
+## Application review controls
+
+These host-owned controls consume the application's pending snapshot. Supply the Core example's controller or equivalent server-backed application flow. `onSettled` refreshes application state. No provider, database or theme provider is required just to render these controls; the larger application retains its documented providers and explicit styles.
+
+```tsx
+import {useState} from 'react';
+/** Host-owned review controls; rendering or receiving a tool event never grants permission. */
+export function RenameToolReview({example,pending,onSettled}:{
+ example:{approve:(id:string)=>Promise<unknown>;reject:(id:string)=>void};
+ pending:{approvalId:string;recordId:string;name:string}|null;onSettled:()=>void;
+}){
+ const [busy,setBusy]=useState(false),[failure,setFailure]=useState(false);
+ if(!pending)return null;
+ return <section aria-label="Review proposed rename">
+  <p>Rename record {pending.recordId} to {pending.name}</p>
+  <button disabled={busy} onClick={async()=>{setBusy(true);setFailure(false);try{await example.approve(pending.approvalId);}catch{setFailure(true);}finally{setBusy(false);onSettled();}}}>Approve</button>
+  <button disabled={busy} onClick={()=>{example.reject(pending.approvalId);onSettled();}}>Reject</button>
+  {failure&&<p role="alert">Execution could not complete. Check the application outcome before retrying.</p>}
+ </section>;
+}
+```

package/docs/exports.md

@@ -1,8 +1,11 @@
 ---
 title: "Public exports and optional peers"
 description: "Exact install package, public import subpaths and optional peer requirements."
+sidebar:
+  order: 10
 archetype: reference
-project: tools
+project: appkit
+tags: ["appkit", "exports"]
 ---
 
 # Public exports and optional peers
@@ -58,6 +61,7 @@ bun add @alneas/appkit-react
 | `@alneas/appkit-react/tools/styles` | CSS |
 | `@alneas/appkit-react/ai-instructions` | Metadata |
 | `@alneas/appkit-react/package-context.json` | Metadata |
+| `@alneas/appkit-react/api-index.json` | Metadata |
 
 ## Optional peers