@alneas/appkit-react 0.1.0 → 0.3.0

package/dist/tools/components/auth/ProtectedRoute.d.ts

@@ -1,112 +1,127 @@
 import { default as React } from 'react';
 import { BaseProfile } from './types.js';
+/**
+ * Route display restrictions and client redirects.
+ *
+ * @typeParam T - Profile shape extending BaseProfile; defaults to BaseProfile.
+ *
+ * @see ProtectedRoute for provider setup and semantics.
+ */
 export interface ProtectedRouteProps<T extends BaseProfile = BaseProfile> {
+    /**
+     * Content rendered only after loading and successful display checks.
+     */
     children: React.ReactNode;
     /**
-     * ログインページへのパス
-     * @default '/login'
+     * Unauthenticated redirect destination; defaults to /login.
      */
     loginPath?: string;
     /**
-     * 認可エラー時のリダイレクトパス (403)
-     * @default undefined (リダイレクトしない)
+     * Optional denied-access destination; omission renders unauthorizedFallback.
      */
     unauthorizedPath?: string;
     /**
-     * 許可されるロールの配列
-     * @example ['admin', 'manager']
+     * Any one listed role must match; omission or an empty array skips role restriction.
      */
     roles?: string[];
     /**
-     * プロファイル内のロールフィールド名
-     * @default 'role'
+     * Profile scalar/array role property; defaults to role.
      */
     roleField?: keyof T;
     /**
-     * カスタムアクセス条件
-     * @example (profile) => profile?.subscription === 'premium'
+     * Additional synchronous predicate receiving the profile or null; must pass after role checks. Thrown errors propagate from render.
      */
     condition?: (profile: T | null) => boolean;
     /**
-     * ロード中に表示するコンポーネント
+     * Loading content; defaults to null.
      */
     fallback?: React.ReactNode;
     /**
-     * 認可エラー時に表示するコンポーネント (unauthorizedPath が未設定の場合)
+     * Denied-access content when unauthorizedPath is omitted; defaults to null.
      */
     unauthorizedFallback?: React.ReactNode;
     /**
-     * リダイレクト処理をカスタマイズ
-     * @example (path) => navigate(path)
+     * Optional synchronous navigation callback receiving the destination; omission assigns window.location.href.
      */
     onRedirect?: (path: string) => void;
 }
 /**
- * ルート保護コンポーネント
+ * Renders or redirects according to current auth, optional roles and an optional predicate.
  *
- * 認証状態とロール/条件に基づいてページアクセスを制御します。
+ * @typeParam T - Profile shape used by roleField and condition; defaults to BaseProfile.
  *
- * @example
- * ```tsx
- * // 認証ユーザーのみ
- * <ProtectedRoute>
- *   <DashboardPage />
- * </ProtectedRoute>
- *
- * // 特定ロールのみ
- * <ProtectedRoute roles={['admin']} unauthorizedPath="/403">
- *   <AdminPage />
- * </ProtectedRoute>
- *
- * // カスタム条件
- * <ProtectedRoute
- *   condition={(profile) => profile?.plan === 'premium'}
- *   unauthorizedPath="/upgrade"
- * >
- *   <PremiumPage />
- * </ProtectedRoute>
- * ```
- */
-export declare function ProtectedRoute<T extends BaseProfile = BaseProfile>({ children, loginPath, unauthorizedPath, roles, roleField, condition, fallback, unauthorizedFallback, onRedirect, }: ProtectedRouteProps<T>): React.JSX.Element | null;
-/**
- * ロールベースの表示制御フック
+ * @param props - Children, access predicates, loading/denial content and navigation settings.
+ *
+ * @returns Loading fallback, permitted children, denied fallback or null while redirecting.
+ *
+ * @throws Error without AuthProvider; condition errors propagate during rendering.
+ *
+ * @remarks Requires AuthProvider inside QueryClientProvider. UserProfileProvider is optional
+ * but needed for profile-based roles. Redirects run in effects; missing profiles fail a
+ * nonempty role restriction. This uses display user state without isSessionVerified;
+ * backend authorization is still required. No CSS is required.
  *
  * @example
  * ```tsx
- * function MyComponent() {
- *   const { hasRole, hasAnyRole } = useRoleCheck();
- *
- *   return (
- *     <div>
- *       {hasRole('admin') && <AdminPanel />}
- *       {hasAnyRole(['admin', 'manager']) && <ManageButton />}
- *     </div>
- *   );
+ * import type { ReactNode } from 'react';
+ * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+ * import { AuthProvider, ProtectedRoute, type AuthAdapter } from '@alneas/appkit-react/tools/auth';
+ *
+ * function Content() { return <ProtectedRoute><span>Account</span></ProtectedRoute>; }
+ * export function Example({ adapter, queryClient }: { adapter: AuthAdapter; queryClient: QueryClient }) {
+ *   return <QueryClientProvider client={queryClient}><AuthProvider adapter={adapter}><Content /></AuthProvider></QueryClientProvider>;
  * }
  * ```
  */
+export declare function ProtectedRoute<T extends BaseProfile = BaseProfile>({ children, loginPath, unauthorizedPath, roles, roleField, condition, fallback, unauthorizedFallback, onRedirect, }: ProtectedRouteProps<T>): React.JSX.Element | null;
 /**
- * 条件付き表示コンポーネント
+ * Conditional display settings; see ShowFor for usage.
  *
- * @example
- * ```tsx
- * <ShowFor roles={['admin']}>
- *   <AdminOnlyContent />
- * </ShowFor>
+ * @typeParam T - Profile shape extending BaseProfile; defaults to BaseProfile.
  *
- * <ShowFor condition={(profile) => profile?.plan === 'premium'}>
- *   <PremiumContent />
- * </ShowFor>
- * ```
+ * @see ShowFor for the canonical usage example.
  */
 export interface ShowForProps<T extends BaseProfile = BaseProfile> {
+    /**
+     * Content to render when all supplied checks pass.
+     */
     children: React.ReactNode;
+    /**
+     * Any one role must match; omission or empty array imposes no restriction.
+     */
     roles?: string[];
+    /**
+     * Profile role property; defaults to role.
+     */
     roleField?: keyof T;
+    /**
+     * Optional synchronous predicate receiving the current profile or null.
+     */
     condition?: (profile: T | null) => boolean;
+    /**
+     * Content when a check fails; defaults to null.
+     */
     fallback?: React.ReactNode;
 }
 /**
- * ユーザーのロールやカスタム条件に基づいて、子要素の表示・非表示を切り替える条件付き表示コンポーネント。
+ * Conditionally displays children using profile roles and an optional predicate.
+ *
+ * @typeParam T - Profile shape extending BaseProfile; defaults to BaseProfile.
+ *
+ * @param props - Role checks, profile predicate, children and optional fallback.
+ *
+ * @returns Children when checks pass; otherwise fallback, defaulting to null.
+ *
+ * @throws Predicate errors propagate from render.
+ *
+ * @remarks UserProfileProvider supplies profile data but is optional; without it profile
+ * is null. With no restrictions children render even without a profile. Does not redirect,
+ * wait for loading, verify authentication or enforce backend access. No CSS is required.
+ *
+ * @example
+ * ```tsx
+ * import { ShowFor } from '@alneas/appkit-react/tools/auth';
+ * export function RoleLabel() { return <ShowFor roles={['admin']}><span>Admin controls</span></ShowFor>; }
+ * ```
  */
 export declare function ShowFor<T extends BaseProfile = BaseProfile>({ children, roles, roleField, condition, fallback, }: ShowForProps<T>): React.JSX.Element;

package/dist/tools/components/auth/ProtectedRoute.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProtectedRoute.js","names":["_Fragment","ProtectedRoute","isAuthLoading","useAuth","profile","isProfileLoading","profileContext","useUserProfile","isLoading","isAuthenticated","user","isAuthorized","roles","userRole","roleField","role","condition","useEffect","performRedirect","onRedirect","path","unauthorizedPath","loginPath","Fragment","fallback","unauthorizedFallback","ShowFor","useRoleCheck","hasAnyRole"],"sources":["../../../../src/tools/components/auth/ProtectedRoute.tsx"],"sourcesContent":["import React, { useEffect } from 'react';\nimport { useAuth } from './useAuth';\nimport { useUserProfile } from './useUserProfile';\nimport { useRoleCheck } from './useRoleCheck';\nimport { BaseProfile } from './types';\n\nexport interface ProtectedRouteProps<T extends BaseProfile = BaseProfile> {\n  children: React.ReactNode;\n  /**\n   * ログインページへのパス\n   * @default '/login'\n   */\n  loginPath?: string;\n  /**\n   * 認可エラー時のリダイレクトパス (403)\n   * @default undefined (リダイレクトしない)\n   */\n  unauthorizedPath?: string;\n  /**\n   * 許可されるロールの配列\n   * @example ['admin', 'manager']\n   */\n  roles?: string[];\n  /**\n   * プロファイル内のロールフィールド名\n   * @default 'role'\n   */\n  roleField?: keyof T;\n  /**\n   * カスタムアクセス条件\n   * @example (profile) => profile?.subscription === 'premium'\n   */\n  condition?: (profile: T | null) => boolean;\n  /**\n   * ロード中に表示するコンポーネント\n   */\n  fallback?: React.ReactNode;\n  /**\n   * 認可エラー時に表示するコンポーネント (unauthorizedPath が未設定の場合)\n   */\n  unauthorizedFallback?: React.ReactNode;\n  /**\n   * リダイレクト処理をカスタマイズ\n   * @example (path) => navigate(path)\n   */\n  onRedirect?: (path: string) => void;\n}\n\n/**\n * ルート保護コンポーネント\n *\n * 認証状態とロール/条件に基づいてページアクセスを制御します。\n *\n * @example\n * ```tsx\n * // 認証ユーザーのみ\n * <ProtectedRoute>\n *   <DashboardPage />\n * </ProtectedRoute>\n *\n * // 特定ロールのみ\n * <ProtectedRoute roles={['admin']} unauthorizedPath=\"/403\">\n *   <AdminPage />\n * </ProtectedRoute>\n *\n * // カスタム条件\n * <ProtectedRoute\n *   condition={(profile) => profile?.plan === 'premium'}\n *   unauthorizedPath=\"/upgrade\"\n * >\n *   <PremiumPage />\n * </ProtectedRoute>\n * ```\n */\nexport function ProtectedRoute<T extends BaseProfile = BaseProfile>({\n  children,\n  loginPath = '/login',\n  unauthorizedPath,\n  roles,\n  roleField = 'role' as keyof T,\n  condition,\n  fallback = null,\n  unauthorizedFallback = null,\n  onRedirect,\n}: ProtectedRouteProps<T>) {\n  const { user, isLoading: isAuthLoading } = useAuth();\n\n  // UserProfileProvider はオプショナル\n  let profile: T | null = null;\n  let isProfileLoading = false;\n\n  try {\n    const profileContext = useUserProfile<T>();\n    profile = profileContext.profile;\n    isProfileLoading = profileContext.isLoading;\n  } catch {\n    // UserProfileProvider が存在しない場合は無視\n  }\n\n  const isLoading = isAuthLoading || isProfileLoading;\n\n  // 認証チェック\n  const isAuthenticated = !!user;\n\n  // ロールチェック\n  const hasRequiredRole = (): boolean => {\n    if (!roles || roles.length === 0) return true;\n    if (!profile) return false;\n\n    const userRole = profile[roleField];\n    if (Array.isArray(userRole)) {\n      // ユーザーが複数ロールを持つ場合\n      return roles.some((role) => userRole.includes(role));\n    }\n    return roles.includes(userRole as string);\n  };\n\n  // カスタム条件チェック\n  const meetsCondition = (): boolean => {\n    if (!condition) return true;\n    return condition(profile);\n  };\n\n  // 認可チェック (ロール + 条件)\n  const isAuthorized = hasRequiredRole() && meetsCondition();\n\n  // リダイレクト処理 (useEffect内でのみwindow操作)\n  useEffect(() => {\n    if (isLoading) return;\n\n    const performRedirect = (path: string) => {\n      if (onRedirect) {\n        onRedirect(path);\n      } else {\n        window.location.href = path;\n      }\n    };\n\n    if (!isAuthenticated) {\n      performRedirect(loginPath);\n      return;\n    }\n\n    if (!isAuthorized && unauthorizedPath) {\n      performRedirect(unauthorizedPath);\n    }\n  }, [isLoading, isAuthenticated, isAuthorized, loginPath, unauthorizedPath, onRedirect]);\n\n  // ローディング中\n  if (isLoading) {\n    return <>{fallback}</>;\n  }\n\n  // 未認証\n  if (!isAuthenticated) {\n    return null; // リダイレクト処理中\n  }\n\n  // 認可エラー\n  if (!isAuthorized) {\n    if (unauthorizedPath) {\n      return null; // リダイレクト処理中\n    }\n    return <>{unauthorizedFallback}</>;\n  }\n\n  // 認証・認可OK\n  return <>{children}</>;\n}\n\n/**\n * ロールベースの表示制御フック\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { hasRole, hasAnyRole } = useRoleCheck();\n *\n *   return (\n *     <div>\n *       {hasRole('admin') && <AdminPanel />}\n *       {hasAnyRole(['admin', 'manager']) && <ManageButton />}\n *     </div>\n *   );\n * }\n * ```\n */\n/**\n * 条件付き表示コンポーネント\n *\n * @example\n * ```tsx\n * <ShowFor roles={['admin']}>\n *   <AdminOnlyContent />\n * </ShowFor>\n *\n * <ShowFor condition={(profile) => profile?.plan === 'premium'}>\n *   <PremiumContent />\n * </ShowFor>\n * ```\n */\nexport interface ShowForProps<T extends BaseProfile = BaseProfile> {\n  children: React.ReactNode;\n  roles?: string[];\n  roleField?: keyof T;\n  condition?: (profile: T | null) => boolean;\n  fallback?: React.ReactNode;\n}\n\n/**\n * ユーザーのロールやカスタム条件に基づいて、子要素の表示・非表示を切り替える条件付き表示コンポーネント。\n */\nexport function ShowFor<T extends BaseProfile = BaseProfile>({\n  children,\n  roles,\n  roleField = 'role' as keyof T,\n  condition,\n  fallback = null,\n}: ShowForProps<T>) {\n  const { hasAnyRole, profile } = useRoleCheck<T>(roleField);\n\n  const shouldShow = (): boolean => {\n    if (roles && roles.length > 0) {\n      if (!hasAnyRole(roles)) return false;\n    }\n    if (condition) {\n      if (!condition(profile)) return false;\n    }\n    return true;\n  };\n\n  return shouldShow() ? <>{children}</> : <>{fallback}</>;\n}\n"],"mappings":";;;;;;;AA0EA,SAAgBC,EAAoD,EAClE,aACA,eAAY,UACZ,qBACA,UACA,eAAY,QACZ,cACA,cAAW,MACX,0BAAuB,MACvB,iBACyB;CACzB,IAAM,EAAE,SAAM,WAAWC,MAAkBC,EAAQ,GAG/CC,IAAoB,MACpBC,IAAmB;CAEvB,IAAI;EACF,IAAMC,IAAiBC,EAAkB;EAEzC,AADA,IAAUD,EAAe,SACzB,IAAmBA,EAAe;CACpC,QAAQ,CAER;CAEA,IAAME,IAAYN,KAAiBG,GAG7BI,IAAkB,CAAC,CAACC,GAsBpBC,WAnBiC;EACrC,IAAI,CAACC,KAASA,EAAM,WAAW,GAAG,OAAO;EACzC,IAAI,CAACR,GAAS,OAAO;EAErB,IAAMS,IAAWT,EAAQU;EAKzB,OAJI,MAAM,QAAQD,CAAQ,IAEjBD,EAAM,MAAM,MAASC,EAAS,SAASE,CAAI,CAAC,IAE9CH,EAAM,SAASC,CAAkB;CAC1C,EASqB,CAAgB,MALnC,CAAKG,KACEA,EAAUZ,CAAO;CA+C1B,OAxCAa,QAAgB;EACd,IAAIT,GAAW;EAEf,IAAMU,KAAmB,MAAiB;GACxC,AAAIC,IACFA,EAAWC,CAAI,IAEf,OAAO,SAAS,OAAOA;EAE3B;EAEA,AAAKX,IAKD,CAACE,KAAgBU,KACnBH,EAAgBG,CAAgB,IALhCH,EAAgBI,CAAS;CAO7B,GAAG;EAACd;EAAWC;EAAiBE;EAAcW;EAAWD;EAAkBF;CAAU,CAAC,GAGlFX,IACK,kBAAAR,GAAA,EAAA,UAAGwB,EAAW,CAAA,IAIlBf,IAKAE,IAQE,kBAAAX,GAAA,EAAG,YAAW,CAAA,IAPfqB,IACK,OAEF,kBAAArB,GAAA,EAAA,UAAGyB,EAAuB,CAAA,IAR1B;AAaX;AA4CA,SAAgBC,EAA6C,EAC3D,aACA,UACA,eAAY,QACZ,cACA,cAAW,QACO;CAClB,IAAM,EAAE,eAAY,eAAYC,EAAgBb,CAAS;CAYzD,OATMF,KAASA,EAAM,SAAS,KACtB,CAACgB,EAAWhB,CAAK,KAEnBI,KACE,CAACA,EAAUZ,CAAO,IAKc,kBAAAJ,GAAA,EAAA,UAAGwB,EAAW,CAAA,IAAhC,kBAAAxB,GAAA,EAAG,YAAW,CAAA;AACtC"}
+{"version":3,"file":"ProtectedRoute.js","names":["_Fragment","ProtectedRoute","isAuthLoading","useAuth","profile","isProfileLoading","profileContext","useUserProfile","isLoading","isAuthenticated","user","isAuthorized","roles","userRole","roleField","role","condition","useEffect","performRedirect","onRedirect","path","unauthorizedPath","loginPath","Fragment","fallback","unauthorizedFallback","ShowFor","useRoleCheck","hasAnyRole"],"sources":["../../../../src/tools/components/auth/ProtectedRoute.tsx"],"sourcesContent":["import React, { useEffect } from 'react';\nimport { useAuth } from './useAuth';\nimport { useUserProfile } from './useUserProfile';\nimport { useRoleCheck } from './useRoleCheck';\nimport { BaseProfile } from './types';\n\n/**\n * Route display restrictions and client redirects.\n *\n * @typeParam T - Profile shape extending BaseProfile; defaults to BaseProfile.\n *\n * @see ProtectedRoute for provider setup and semantics.\n */\nexport interface ProtectedRouteProps<T extends BaseProfile = BaseProfile> {\n  /**\n   * Content rendered only after loading and successful display checks.\n   */\n  children: React.ReactNode;\n    /**\n     * Unauthenticated redirect destination; defaults to /login.\n     */\n  loginPath?: string;\n    /**\n     * Optional denied-access destination; omission renders unauthorizedFallback.\n     */\n  unauthorizedPath?: string;\n    /**\n     * Any one listed role must match; omission or an empty array skips role restriction.\n     */\n  roles?: string[];\n    /**\n     * Profile scalar/array role property; defaults to role.\n     */\n  roleField?: keyof T;\n    /**\n     * Additional synchronous predicate receiving the profile or null; must pass after role checks. Thrown errors propagate from render.\n     */\n  condition?: (profile: T | null) => boolean;\n    /**\n     * Loading content; defaults to null.\n     */\n  fallback?: React.ReactNode;\n    /**\n     * Denied-access content when unauthorizedPath is omitted; defaults to null.\n     */\n  unauthorizedFallback?: React.ReactNode;\n    /**\n     * Optional synchronous navigation callback receiving the destination; omission assigns window.location.href.\n     */\n  onRedirect?: (path: string) => void;\n}\n\n/**\n * Renders or redirects according to current auth, optional roles and an optional predicate.\n *\n * @typeParam T - Profile shape used by roleField and condition; defaults to BaseProfile.\n *\n * @param props - Children, access predicates, loading/denial content and navigation settings.\n *\n * @returns Loading fallback, permitted children, denied fallback or null while redirecting.\n *\n * @throws Error without AuthProvider; condition errors propagate during rendering.\n *\n * @remarks Requires AuthProvider inside QueryClientProvider. UserProfileProvider is optional\n * but needed for profile-based roles. Redirects run in effects; missing profiles fail a\n * nonempty role restriction. This uses display user state without isSessionVerified;\n * backend authorization is still required. No CSS is required.\n *\n * @example\n * ```tsx\n * import type { ReactNode } from 'react';\n * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';\n * import { AuthProvider, ProtectedRoute, type AuthAdapter } from '@alneas/appkit-react/tools/auth';\n *\n * function Content() { return <ProtectedRoute><span>Account</span></ProtectedRoute>; }\n * export function Example({ adapter, queryClient }: { adapter: AuthAdapter; queryClient: QueryClient }) {\n *   return <QueryClientProvider client={queryClient}><AuthProvider adapter={adapter}><Content /></AuthProvider></QueryClientProvider>;\n * }\n * ```\n */\nexport function ProtectedRoute<T extends BaseProfile = BaseProfile>({\n  children,\n  loginPath = '/login',\n  unauthorizedPath,\n  roles,\n  roleField = 'role' as keyof T,\n  condition,\n  fallback = null,\n  unauthorizedFallback = null,\n  onRedirect,\n}: ProtectedRouteProps<T>) {\n  const { user, isLoading: isAuthLoading } = useAuth();\n\n  // UserProfileProvider はオプショナル\n  let profile: T | null = null;\n  let isProfileLoading = false;\n\n  try {\n    const profileContext = useUserProfile<T>();\n    profile = profileContext.profile;\n    isProfileLoading = profileContext.isLoading;\n  } catch {\n    // UserProfileProvider が存在しない場合は無視\n  }\n\n  const isLoading = isAuthLoading || isProfileLoading;\n\n  // 認証チェック\n  const isAuthenticated = !!user;\n\n  // ロールチェック\n  const hasRequiredRole = (): boolean => {\n    if (!roles || roles.length === 0) return true;\n    if (!profile) return false;\n\n    const userRole = profile[roleField];\n    if (Array.isArray(userRole)) {\n      // ユーザーが複数ロールを持つ場合\n      return roles.some((role) => userRole.includes(role));\n    }\n    return roles.includes(userRole as string);\n  };\n\n  // カスタム条件チェック\n  const meetsCondition = (): boolean => {\n    if (!condition) return true;\n    return condition(profile);\n  };\n\n  // 認可チェック (ロール + 条件)\n  const isAuthorized = hasRequiredRole() && meetsCondition();\n\n  // リダイレクト処理 (useEffect内でのみwindow操作)\n  useEffect(() => {\n    if (isLoading) return;\n\n    const performRedirect = (path: string) => {\n      if (onRedirect) {\n        onRedirect(path);\n      } else {\n        window.location.href = path;\n      }\n    };\n\n    if (!isAuthenticated) {\n      performRedirect(loginPath);\n      return;\n    }\n\n    if (!isAuthorized && unauthorizedPath) {\n      performRedirect(unauthorizedPath);\n    }\n  }, [isLoading, isAuthenticated, isAuthorized, loginPath, unauthorizedPath, onRedirect]);\n\n  // ローディング中\n  if (isLoading) {\n    return <>{fallback}</>;\n  }\n\n  // 未認証\n  if (!isAuthenticated) {\n    return null; // リダイレクト処理中\n  }\n\n  // 認可エラー\n  if (!isAuthorized) {\n    if (unauthorizedPath) {\n      return null; // リダイレクト処理中\n    }\n    return <>{unauthorizedFallback}</>;\n  }\n\n  // 認証・認可OK\n  return <>{children}</>;\n}\n\n/**\n * Conditional display settings; see ShowFor for usage.\n *\n * @typeParam T - Profile shape extending BaseProfile; defaults to BaseProfile.\n *\n * @see ShowFor for the canonical usage example.\n */\nexport interface ShowForProps<T extends BaseProfile = BaseProfile> {\n  /**\n   * Content to render when all supplied checks pass.\n   */\n  children: React.ReactNode;\n  /**\n   * Any one role must match; omission or empty array imposes no restriction.\n   */\n  roles?: string[];\n  /**\n   * Profile role property; defaults to role.\n   */\n  roleField?: keyof T;\n  /**\n   * Optional synchronous predicate receiving the current profile or null.\n   */\n  condition?: (profile: T | null) => boolean;\n  /**\n   * Content when a check fails; defaults to null.\n   */\n  fallback?: React.ReactNode;\n}\n\n/**\n * Conditionally displays children using profile roles and an optional predicate.\n *\n * @typeParam T - Profile shape extending BaseProfile; defaults to BaseProfile.\n *\n * @param props - Role checks, profile predicate, children and optional fallback.\n *\n * @returns Children when checks pass; otherwise fallback, defaulting to null.\n *\n * @throws Predicate errors propagate from render.\n *\n * @remarks UserProfileProvider supplies profile data but is optional; without it profile\n * is null. With no restrictions children render even without a profile. Does not redirect,\n * wait for loading, verify authentication or enforce backend access. No CSS is required.\n *\n * @example\n * ```tsx\n * import { ShowFor } from '@alneas/appkit-react/tools/auth';\n * export function RoleLabel() { return <ShowFor roles={['admin']}><span>Admin controls</span></ShowFor>; }\n * ```\n */\nexport function ShowFor<T extends BaseProfile = BaseProfile>({\n  children,\n  roles,\n  roleField = 'role' as keyof T,\n  condition,\n  fallback = null,\n}: ShowForProps<T>) {\n  const { hasAnyRole, profile } = useRoleCheck<T>(roleField);\n\n  const shouldShow = (): boolean => {\n    if (roles && roles.length > 0) {\n      if (!hasAnyRole(roles)) return false;\n    }\n    if (condition) {\n      if (!condition(profile)) return false;\n    }\n    return true;\n  };\n\n  return shouldShow() ? <>{children}</> : <>{fallback}</>;\n}\n"],"mappings":";;;;;;;AAgFA,SAAgBC,EAAoD,EAClE,aACA,eAAY,UACZ,qBACA,UACA,eAAY,QACZ,cACA,cAAW,MACX,0BAAuB,MACvB,iBACyB;CACzB,IAAM,EAAE,SAAM,WAAWC,MAAkBC,EAAQ,GAG/CC,IAAoB,MACpBC,IAAmB;CAEvB,IAAI;EACF,IAAMC,IAAiBC,EAAkB;EAEzC,AADA,IAAUD,EAAe,SACzB,IAAmBA,EAAe;CACpC,QAAQ,CAER;CAEA,IAAME,IAAYN,KAAiBG,GAG7BI,IAAkB,CAAC,CAACC,GAsBpBC,WAnBiC;EACrC,IAAI,CAACC,KAASA,EAAM,WAAW,GAAG,OAAO;EACzC,IAAI,CAACR,GAAS,OAAO;EAErB,IAAMS,IAAWT,EAAQU;EAKzB,OAJI,MAAM,QAAQD,CAAQ,IAEjBD,EAAM,MAAM,MAASC,EAAS,SAASE,CAAI,CAAC,IAE9CH,EAAM,SAASC,CAAkB;CAC1C,EASqB,CAAgB,MALnC,CAAKG,KACEA,EAAUZ,CAAO;CA+C1B,OAxCAa,QAAgB;EACd,IAAIT,GAAW;EAEf,IAAMU,KAAmB,MAAiB;GACxC,AAAIC,IACFA,EAAWC,CAAI,IAEf,OAAO,SAAS,OAAOA;EAE3B;EAEA,AAAKX,IAKD,CAACE,KAAgBU,KACnBH,EAAgBG,CAAgB,IALhCH,EAAgBI,CAAS;CAO7B,GAAG;EAACd;EAAWC;EAAiBE;EAAcW;EAAWD;EAAkBF;CAAU,CAAC,GAGlFX,IACK,kBAAAR,GAAA,EAAA,UAAGwB,EAAW,CAAA,IAIlBf,IAKAE,IAQE,kBAAAX,GAAA,EAAG,YAAW,CAAA,IAPfqB,IACK,OAEF,kBAAArB,GAAA,EAAA,UAAGyB,EAAuB,CAAA,IAR1B;AAaX;AAqDA,SAAgBC,EAA6C,EAC3D,aACA,UACA,eAAY,QACZ,cACA,cAAW,QACO;CAClB,IAAM,EAAE,eAAY,eAAYC,EAAgBb,CAAS;CAYzD,OATMF,KAASA,EAAM,SAAS,KACtB,CAACgB,EAAWhB,CAAK,KAEnBI,KACE,CAACA,EAAUZ,CAAO,IAKc,kBAAAJ,GAAA,EAAA,UAAGwB,EAAW,CAAA,IAAhC,kBAAAxB,GAAA,EAAG,YAAW,CAAA;AACtC"}

package/dist/tools/components/auth/SignInButton.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"SignInButton.cjs","names":["useAuth","useState","useIsClient","Dialog","DialogTrigger","Button","DialogContent","Tabs","DialogHeader","TabsList","TabsTrigger","TabsContent","LoginForm","RegisterForm","_Fragment","DialogTitle","require_ui_components_ui_button_components","require_ui_components_ui_dialog","require_ui_components_ui_tabs_components","require_ui_lib_hooks_use_is_client","require_signin1","require_signup1","require_tools_components_auth_useAuth","require_tools_components_auth_AuthForms","react_jsx_runtime","react","SignInButton","open","setOpen","tab","setTab","user","nextOpen","mode","v","registerFields"],"sources":["../../../../src/tools/components/auth/SignInButton.tsx"],"sourcesContent":["import { useState } from 'react';\nimport { useAuth } from './useAuth';\nimport { Button } from '../ui/button';\nimport { Dialog, DialogContent, DialogHeader, DialogTitle, DialogTrigger } from '../ui/dialog';\nimport { Tabs, TabsList, TabsTrigger, TabsContent } from '../ui/tabs';\nimport { LoginForm, RegisterForm, type RegisterFieldConfig, type RegisterExtraField } from './AuthForms';\nimport * as m from '../../paraglide/messages.js';\nimport { useIsClient } from '../../lib/hooks/use-is-client';\n\n/**\n * ログイン用のダイアログを表示するサインインボタンコンポーネント。\n *\n * @param props - コンポーネントのプロパティ\n * @param props.mode - 表示モード。`'login'` はログインのみ、`'combined'` はログイン/登録のタブ切り替え\n * @param props.registerFields - 登録フォームの既存フィールドカスタマイズ（mode='combined' 時）\n * @param props.extraFields - 登録フォームの追加フィールド（mode='combined' 時）\n *\n * @example\n * ```tsx\n * // ログインのみ（デフォルト）\n * <SignInButton />\n *\n * // ログイン・新規登録の切り替えタブ付き\n * <SignInButton mode=\"combined\" />\n *\n * // 登録フォームに電話番号を追加\n * <SignInButton\n *   mode=\"combined\"\n *   extraFields={[\n *     { name: 'phone', label: 'Phone', type: 'tel' },\n *   ]}\n * />\n * ```\n */\nexport function SignInButton({\n  mode = 'login',\n  registerFields,\n  extraFields,\n}: {\n  mode?: 'login' | 'combined';\n  registerFields?: RegisterFieldConfig;\n  extraFields?: RegisterExtraField[];\n}) {\n  const { user } = useAuth();\n  const [open, setOpen] = useState(false);\n  const [tab, setTab] = useState<'login' | 'register'>('login');\n  const isClient = useIsClient();\n\n  if (!isClient) return null;\n  if (user) return null;\n\n  return (\n    <Dialog\n      open={open}\n      onOpenChange={(nextOpen) => {\n        setOpen(nextOpen);\n        if (nextOpen) setTab('login');\n      }}\n    >\n      <DialogTrigger\n        render={<Button variant='secondary' size='sm' className='transition-colors' />}\n      >\n        {m.signIn()}\n      </DialogTrigger>\n      <DialogContent className='sm:max-w-md'>\n        {mode === 'combined' ? (\n          <Tabs value={tab} onValueChange={(v) => setTab(v as 'login' | 'register')}>\n            <DialogHeader>\n              <TabsList className='grid w-full grid-cols-2'>\n                <TabsTrigger value='login'>{m.signIn()}</TabsTrigger>\n                <TabsTrigger value='register'>{m.signUp()}</TabsTrigger>\n              </TabsList>\n            </DialogHeader>\n            <TabsContent value='login'>\n              <LoginForm\n                onSuccess={() => setOpen(false)}\n                onRegisterClick={() => setTab('register')}\n                showRegisterLink\n              />\n            </TabsContent>\n            <TabsContent value='register'>\n              <RegisterForm\n                onSuccess={() => setOpen(false)}\n                fields={registerFields}\n                extraFields={extraFields}\n                onLoginClick={() => setTab('login')}\n                showLoginLink\n              />\n            </TabsContent>\n          </Tabs>\n        ) : (\n          <>\n            <DialogHeader>\n              <DialogTitle>{m.signIn()}</DialogTitle>\n            </DialogHeader>\n            <LoginForm\n              onSuccess={() => setOpen(false)}\n              socialProviders={[{ provider: 'google', label: 'Googleでログイン' }]}\n            />\n          </>\n        )}\n      </DialogContent>\n    </Dialog>\n  );\n}\n"],"mappings":"A,ugBAkCA,SAAgB0B,EAAa,CAC3B,OAAO,QACP,iBACA,eAKC,CACD,GAAM,CAAE,QAAS1B,EAAAA,QAAQ,EACnB,CAAC2B,EAAMC,IAAA,EAAW3B,EAAAA,SAAAA,CAAS,EAAK,EAChC,CAAC4B,EAAKC,IAAA,EAAU7B,EAAAA,SAAAA,CAA+B,OAAO,EAM5D,MAHI,CAFaC,EAAAA,YAEZ,GACD6B,EAAa,MAGf,EAAAP,EAAA,KAAA,CAACrB,EAAAA,OAAD,CACQ,OACN,aAAe,GAAa,CAC1ByB,EAAQI,CAAQ,EACZA,GAAUF,EAAO,OAAO,CAC9B,EALF,SAAA,EAOE,EAAAN,EAAA,IAAA,CAACpB,EAAAA,cAAD,CACE,QAAQ,EAAAoB,EAAA,IAAA,CAACnB,EAAAA,OAAD,CAAQ,QAAQ,YAAY,KAAK,KAAK,UAAU,mBAAqB,CAAA,EAE5E,SAAAe,EAAA,OAAS,CACG,CAAA,GACf,EAAAI,EAAA,IAAA,CAAClB,EAAAA,cAAD,CAAe,UAAU,cACtB,SAAA2B,IAAS,YACR,EAAAT,EAAA,KAAA,CAACjB,EAAAA,KAAD,CAAM,MAAOsB,EAAK,cAAgB,GAAMC,EAAOI,CAAyB,EAAxE,SAAA,EACE,EAAAV,EAAA,IAAA,CAAChB,EAAAA,aAAD,CAAA,UACE,EAAAgB,EAAA,KAAA,CAACf,EAAAA,SAAD,CAAU,UAAU,0BAApB,SAAA,EACE,EAAAe,EAAA,IAAA,CAACd,EAAAA,YAAD,CAAa,MAAM,QAAS,SAAAU,EAAA,OAAS,CAAe,CAAA,GACpD,EAAAI,EAAA,IAAA,CAACd,EAAAA,YAAD,CAAa,MAAM,WAAY,SAAAW,EAAA,OAAS,CAAe,CAAA,CAC/C,CACE,CAAA,CAAA,CAAA,GACd,EAAAG,EAAA,IAAA,CAACb,EAAAA,YAAD,CAAa,MAAM,QACjB,UAAA,EAAAa,EAAA,IAAA,CAACZ,EAAAA,UAAD,CACE,cAAiBgB,EAAQ,EAAK,EAC9B,oBAAuBE,EAAO,UAAU,EACxC,iBAAA,EACD,CAAA,CACU,CAAA,GACb,EAAAN,EAAA,IAAA,CAACb,EAAAA,YAAD,CAAa,MAAM,WACjB,UAAA,EAAAa,EAAA,IAAA,CAACX,EAAAA,aAAD,CACE,cAAiBe,EAAQ,EAAK,EAC9B,OAAQO,EACK,cACb,iBAAoBL,EAAO,OAAO,EAClC,cAAA,EACD,CAAA,CACU,CAAA,CACT,CAEN,CAAA,GAAA,EAAAN,EAAA,KAAA,CAAAV,EAAAA,SAAA,CAAA,SAAA,EACE,EAAAU,EAAA,IAAA,CAAChB,EAAAA,aAAD,CAAA,UACE,EAAAgB,EAAA,IAAA,CAACT,EAAAA,YAAD,CAAA,SAAAK,EAAA,OAAuB,CAAe,CAAA,CAC1B,CAAA,GACd,EAAAI,EAAA,IAAA,CAACZ,EAAAA,UAAD,CACE,cAAiBgB,EAAQ,EAAK,EAC9B,gBAAiB,CAAC,CAAE,SAAU,SAAU,MAAO,aAAc,CAAC,CAC/D,CAAA,CACD,CAAA,CAAA,CAES,CAAA,CACT,C,EAEZ,C"}
+{"version":3,"file":"SignInButton.cjs","names":["useAuth","useState","useIsClient","Dialog","DialogTrigger","Button","DialogContent","Tabs","DialogHeader","TabsList","TabsTrigger","TabsContent","LoginForm","RegisterForm","_Fragment","DialogTitle","require_ui_components_ui_button_components","require_ui_components_ui_dialog","require_ui_components_ui_tabs_components","require_ui_lib_hooks_use_is_client","require_signin1","require_signup1","require_tools_components_auth_useAuth","require_tools_components_auth_AuthForms","react_jsx_runtime","react","SignInButton","open","setOpen","tab","setTab","user","nextOpen","mode","v","registerFields"],"sources":["../../../../src/tools/components/auth/SignInButton.tsx"],"sourcesContent":["import { useState } from 'react';\nimport { useAuth } from './useAuth';\nimport { Button } from '../ui/button';\nimport { Dialog, DialogContent, DialogHeader, DialogTitle, DialogTrigger } from '../ui/dialog';\nimport { Tabs, TabsList, TabsTrigger, TabsContent } from '../ui/tabs';\nimport { LoginForm, RegisterForm, type RegisterFieldConfig, type RegisterExtraField } from './AuthForms';\nimport * as m from '../../paraglide/messages.js';\nimport { useIsClient } from '../../lib/hooks/use-is-client';\n\n/**\n * Opens a login dialog or tabbed login/registration dialog for signed-out users.\n *\n * @param props - Dialog mode and optional registration field configuration.\n *\n * @returns Sign-in button/dialog after client mount; null during SSR or when a user exists.\n *\n * @throws Error without AuthProvider.\n *\n * @remarks Requires AuthProvider inside QueryClientProvider and Appkit styles. Defaults\n * to login mode with a Google OAuth button (shown only if adapter support exists).\n * Combined mode provides login/register tabs; successful email login/registration closes\n * the dialog. Each opening resets the selected tab to login.\n *\n * @example\n * ```tsx\n * import '@alneas/appkit-react/styles';\n * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';\n * import { AuthProvider, SignInButton, type AuthAdapter } from '@alneas/appkit-react/tools/auth';\n * export function FormExample({ adapter, queryClient }: { adapter: AuthAdapter; queryClient: QueryClient }) {\n *   return <QueryClientProvider client={queryClient}><AuthProvider adapter={adapter}><SignInButton mode=\"combined\" /></AuthProvider></QueryClientProvider>;\n * }\n * ```\n */\nexport function SignInButton({\n  mode = 'login',\n  registerFields,\n  extraFields,\n}: {\n  /**\n   * Dialog contents: login by default, combined adds registration tabs.\n   */\n  mode?: 'login' | 'combined';\n  /**\n   * Built-in registration input overrides, used only in combined mode.\n   */\n  registerFields?: RegisterFieldConfig;\n  /**\n   * Additional locally validated registration inputs, used only in combined mode; not saved by RegisterForm.\n   */\n  extraFields?: RegisterExtraField[];\n}) {\n  const { user } = useAuth();\n  const [open, setOpen] = useState(false);\n  const [tab, setTab] = useState<'login' | 'register'>('login');\n  const isClient = useIsClient();\n\n  if (!isClient) return null;\n  if (user) return null;\n\n  return (\n    <Dialog\n      open={open}\n      onOpenChange={(nextOpen) => {\n        setOpen(nextOpen);\n        if (nextOpen) setTab('login');\n      }}\n    >\n      <DialogTrigger\n        render={<Button variant='secondary' size='sm' className='transition-colors' />}\n      >\n        {m.signIn()}\n      </DialogTrigger>\n      <DialogContent className='sm:max-w-md'>\n        {mode === 'combined' ? (\n          <Tabs value={tab} onValueChange={(v) => setTab(v as 'login' | 'register')}>\n            <DialogHeader>\n              <TabsList className='grid w-full grid-cols-2'>\n                <TabsTrigger value='login'>{m.signIn()}</TabsTrigger>\n                <TabsTrigger value='register'>{m.signUp()}</TabsTrigger>\n              </TabsList>\n            </DialogHeader>\n            <TabsContent value='login'>\n              <LoginForm\n                onSuccess={() => setOpen(false)}\n                onRegisterClick={() => setTab('register')}\n                showRegisterLink\n              />\n            </TabsContent>\n            <TabsContent value='register'>\n              <RegisterForm\n                onSuccess={() => setOpen(false)}\n                fields={registerFields}\n                extraFields={extraFields}\n                onLoginClick={() => setTab('login')}\n                showLoginLink\n              />\n            </TabsContent>\n          </Tabs>\n        ) : (\n          <>\n            <DialogHeader>\n              <DialogTitle>{m.signIn()}</DialogTitle>\n            </DialogHeader>\n            <LoginForm\n              onSuccess={() => setOpen(false)}\n              socialProviders={[{ provider: 'google', label: 'Googleでログイン' }]}\n            />\n          </>\n        )}\n      </DialogContent>\n    </Dialog>\n  );\n}\n"],"mappings":"A,ugBAiCA,SAAgB0B,EAAa,CAC3B,OAAO,QACP,iBACA,eAcC,CACD,GAAM,CAAE,QAAS1B,EAAAA,QAAQ,EACnB,CAAC2B,EAAMC,IAAA,EAAW3B,EAAAA,SAAAA,CAAS,EAAK,EAChC,CAAC4B,EAAKC,IAAA,EAAU7B,EAAAA,SAAAA,CAA+B,OAAO,EAM5D,MAHI,CAFaC,EAAAA,YAEZ,GACD6B,EAAa,MAGf,EAAAP,EAAA,KAAA,CAACrB,EAAAA,OAAD,CACQ,OACN,aAAe,GAAa,CAC1ByB,EAAQI,CAAQ,EACZA,GAAUF,EAAO,OAAO,CAC9B,EALF,SAAA,EAOE,EAAAN,EAAA,IAAA,CAACpB,EAAAA,cAAD,CACE,QAAQ,EAAAoB,EAAA,IAAA,CAACnB,EAAAA,OAAD,CAAQ,QAAQ,YAAY,KAAK,KAAK,UAAU,mBAAqB,CAAA,EAE5E,SAAAe,EAAA,OAAS,CACG,CAAA,GACf,EAAAI,EAAA,IAAA,CAAClB,EAAAA,cAAD,CAAe,UAAU,cACtB,SAAA2B,IAAS,YACR,EAAAT,EAAA,KAAA,CAACjB,EAAAA,KAAD,CAAM,MAAOsB,EAAK,cAAgB,GAAMC,EAAOI,CAAyB,EAAxE,SAAA,EACE,EAAAV,EAAA,IAAA,CAAChB,EAAAA,aAAD,CAAA,UACE,EAAAgB,EAAA,KAAA,CAACf,EAAAA,SAAD,CAAU,UAAU,0BAApB,SAAA,EACE,EAAAe,EAAA,IAAA,CAACd,EAAAA,YAAD,CAAa,MAAM,QAAS,SAAAU,EAAA,OAAS,CAAe,CAAA,GACpD,EAAAI,EAAA,IAAA,CAACd,EAAAA,YAAD,CAAa,MAAM,WAAY,SAAAW,EAAA,OAAS,CAAe,CAAA,CAC/C,CACE,CAAA,CAAA,CAAA,GACd,EAAAG,EAAA,IAAA,CAACb,EAAAA,YAAD,CAAa,MAAM,QACjB,UAAA,EAAAa,EAAA,IAAA,CAACZ,EAAAA,UAAD,CACE,cAAiBgB,EAAQ,EAAK,EAC9B,oBAAuBE,EAAO,UAAU,EACxC,iBAAA,EACD,CAAA,CACU,CAAA,GACb,EAAAN,EAAA,IAAA,CAACb,EAAAA,YAAD,CAAa,MAAM,WACjB,UAAA,EAAAa,EAAA,IAAA,CAACX,EAAAA,aAAD,CACE,cAAiBe,EAAQ,EAAK,EAC9B,OAAQO,EACK,cACb,iBAAoBL,EAAO,OAAO,EAClC,cAAA,EACD,CAAA,CACU,CAAA,CACT,CAEN,CAAA,GAAA,EAAAN,EAAA,KAAA,CAAAV,EAAAA,SAAA,CAAA,SAAA,EACE,EAAAU,EAAA,IAAA,CAAChB,EAAAA,aAAD,CAAA,UACE,EAAAgB,EAAA,IAAA,CAACT,EAAAA,YAAD,CAAA,SAAAK,EAAA,OAAuB,CAAe,CAAA,CAC1B,CAAA,GACd,EAAAI,EAAA,IAAA,CAACZ,EAAAA,UAAD,CACE,cAAiBgB,EAAQ,EAAK,EAC9B,gBAAiB,CAAC,CAAE,SAAU,SAAU,MAAO,aAAc,CAAC,CAC/D,CAAA,CACD,CAAA,CAAA,CAES,CAAA,CACT,C,EAEZ,C"}

package/dist/tools/components/auth/SignInButton.d.cts

@@ -1,31 +1,39 @@
 import { RegisterFieldConfig, RegisterExtraField } from './AuthForms.cjs';
 /**
- * ログイン用のダイアログを表示するサインインボタンコンポーネント。
+ * Opens a login dialog or tabbed login/registration dialog for signed-out users.
  *
- * @param props - コンポーネントのプロパティ
- * @param props.mode - 表示モード。`'login'` はログインのみ、`'combined'` はログイン/登録のタブ切り替え
- * @param props.registerFields - 登録フォームの既存フィールドカスタマイズ（mode='combined' 時）
- * @param props.extraFields - 登録フォームの追加フィールド（mode='combined' 時）
+ * @param props - Dialog mode and optional registration field configuration.
  *
- * @example
- * ```tsx
- * // ログインのみ（デフォルト）
- * <SignInButton />
+ * @returns Sign-in button/dialog after client mount; null during SSR or when a user exists.
+ *
+ * @throws Error without AuthProvider.
  *
- * // ログイン・新規登録の切り替えタブ付き
- * <SignInButton mode="combined" />
+ * @remarks Requires AuthProvider inside QueryClientProvider and Appkit styles. Defaults
+ * to login mode with a Google OAuth button (shown only if adapter support exists).
+ * Combined mode provides login/register tabs; successful email login/registration closes
+ * the dialog. Each opening resets the selected tab to login.
  *
- * // 登録フォームに電話番号を追加
- * <SignInButton
- *   mode="combined"
- *   extraFields={[
- *     { name: 'phone', label: 'Phone', type: 'tel' },
- *   ]}
- * />
+ * @example
+ * ```tsx
+ * import '@alneas/appkit-react/styles';
+ * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+ * import { AuthProvider, SignInButton, type AuthAdapter } from '@alneas/appkit-react/tools/auth';
+ * export function FormExample({ adapter, queryClient }: { adapter: AuthAdapter; queryClient: QueryClient }) {
+ *   return <QueryClientProvider client={queryClient}><AuthProvider adapter={adapter}><SignInButton mode="combined" /></AuthProvider></QueryClientProvider>;
+ * }
  * ```
  */
 export declare function SignInButton({ mode, registerFields, extraFields, }: {
+    /**
+     * Dialog contents: login by default, combined adds registration tabs.
+     */
     mode?: 'login' | 'combined';
+    /**
+     * Built-in registration input overrides, used only in combined mode.
+     */
     registerFields?: RegisterFieldConfig;
+    /**
+     * Additional locally validated registration inputs, used only in combined mode; not saved by RegisterForm.
+     */
     extraFields?: RegisterExtraField[];
 }): import('react').JSX.Element | null;

package/dist/tools/components/auth/SignInButton.d.ts

@@ -1,31 +1,39 @@
 import { RegisterFieldConfig, RegisterExtraField } from './AuthForms.js';
 /**
- * ログイン用のダイアログを表示するサインインボタンコンポーネント。
+ * Opens a login dialog or tabbed login/registration dialog for signed-out users.
  *
- * @param props - コンポーネントのプロパティ
- * @param props.mode - 表示モード。`'login'` はログインのみ、`'combined'` はログイン/登録のタブ切り替え
- * @param props.registerFields - 登録フォームの既存フィールドカスタマイズ（mode='combined' 時）
- * @param props.extraFields - 登録フォームの追加フィールド（mode='combined' 時）
+ * @param props - Dialog mode and optional registration field configuration.
  *
- * @example
- * ```tsx
- * // ログインのみ（デフォルト）
- * <SignInButton />
+ * @returns Sign-in button/dialog after client mount; null during SSR or when a user exists.
+ *
+ * @throws Error without AuthProvider.
  *
- * // ログイン・新規登録の切り替えタブ付き
- * <SignInButton mode="combined" />
+ * @remarks Requires AuthProvider inside QueryClientProvider and Appkit styles. Defaults
+ * to login mode with a Google OAuth button (shown only if adapter support exists).
+ * Combined mode provides login/register tabs; successful email login/registration closes
+ * the dialog. Each opening resets the selected tab to login.
  *
- * // 登録フォームに電話番号を追加
- * <SignInButton
- *   mode="combined"
- *   extraFields={[
- *     { name: 'phone', label: 'Phone', type: 'tel' },
- *   ]}
- * />
+ * @example
+ * ```tsx
+ * import '@alneas/appkit-react/styles';
+ * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+ * import { AuthProvider, SignInButton, type AuthAdapter } from '@alneas/appkit-react/tools/auth';
+ * export function FormExample({ adapter, queryClient }: { adapter: AuthAdapter; queryClient: QueryClient }) {
+ *   return <QueryClientProvider client={queryClient}><AuthProvider adapter={adapter}><SignInButton mode="combined" /></AuthProvider></QueryClientProvider>;
+ * }
  * ```
  */
 export declare function SignInButton({ mode, registerFields, extraFields, }: {
+    /**
+     * Dialog contents: login by default, combined adds registration tabs.
+     */
     mode?: 'login' | 'combined';
+    /**
+     * Built-in registration input overrides, used only in combined mode.
+     */
     registerFields?: RegisterFieldConfig;
+    /**
+     * Additional locally validated registration inputs, used only in combined mode; not saved by RegisterForm.
+     */
     extraFields?: RegisterExtraField[];
 }): import('react').JSX.Element | null;

package/dist/tools/components/auth/SignInButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"SignInButton.js","names":["m.signIn","m.signUp","_Fragment","signin1","signup1","SignInButton","useAuth","open","setOpen","useState","tab","setTab","useIsClient","user","Dialog","nextOpen","DialogTrigger","Button","DialogContent","mode","Tabs","v","DialogHeader","TabsList","TabsTrigger","TabsContent","LoginForm","RegisterForm","registerFields","Fragment","DialogTitle"],"sources":["../../../../src/tools/components/auth/SignInButton.tsx"],"sourcesContent":["import { useState } from 'react';\nimport { useAuth } from './useAuth';\nimport { Button } from '../ui/button';\nimport { Dialog, DialogContent, DialogHeader, DialogTitle, DialogTrigger } from '../ui/dialog';\nimport { Tabs, TabsList, TabsTrigger, TabsContent } from '../ui/tabs';\nimport { LoginForm, RegisterForm, type RegisterFieldConfig, type RegisterExtraField } from './AuthForms';\nimport * as m from '../../paraglide/messages.js';\nimport { useIsClient } from '../../lib/hooks/use-is-client';\n\n/**\n * ログイン用のダイアログを表示するサインインボタンコンポーネント。\n *\n * @param props - コンポーネントのプロパティ\n * @param props.mode - 表示モード。`'login'` はログインのみ、`'combined'` はログイン/登録のタブ切り替え\n * @param props.registerFields - 登録フォームの既存フィールドカスタマイズ（mode='combined' 時）\n * @param props.extraFields - 登録フォームの追加フィールド（mode='combined' 時）\n *\n * @example\n * ```tsx\n * // ログインのみ（デフォルト）\n * <SignInButton />\n *\n * // ログイン・新規登録の切り替えタブ付き\n * <SignInButton mode=\"combined\" />\n *\n * // 登録フォームに電話番号を追加\n * <SignInButton\n *   mode=\"combined\"\n *   extraFields={[\n *     { name: 'phone', label: 'Phone', type: 'tel' },\n *   ]}\n * />\n * ```\n */\nexport function SignInButton({\n  mode = 'login',\n  registerFields,\n  extraFields,\n}: {\n  mode?: 'login' | 'combined';\n  registerFields?: RegisterFieldConfig;\n  extraFields?: RegisterExtraField[];\n}) {\n  const { user } = useAuth();\n  const [open, setOpen] = useState(false);\n  const [tab, setTab] = useState<'login' | 'register'>('login');\n  const isClient = useIsClient();\n\n  if (!isClient) return null;\n  if (user) return null;\n\n  return (\n    <Dialog\n      open={open}\n      onOpenChange={(nextOpen) => {\n        setOpen(nextOpen);\n        if (nextOpen) setTab('login');\n      }}\n    >\n      <DialogTrigger\n        render={<Button variant='secondary' size='sm' className='transition-colors' />}\n      >\n        {m.signIn()}\n      </DialogTrigger>\n      <DialogContent className='sm:max-w-md'>\n        {mode === 'combined' ? (\n          <Tabs value={tab} onValueChange={(v) => setTab(v as 'login' | 'register')}>\n            <DialogHeader>\n              <TabsList className='grid w-full grid-cols-2'>\n                <TabsTrigger value='login'>{m.signIn()}</TabsTrigger>\n                <TabsTrigger value='register'>{m.signUp()}</TabsTrigger>\n              </TabsList>\n            </DialogHeader>\n            <TabsContent value='login'>\n              <LoginForm\n                onSuccess={() => setOpen(false)}\n                onRegisterClick={() => setTab('register')}\n                showRegisterLink\n              />\n            </TabsContent>\n            <TabsContent value='register'>\n              <RegisterForm\n                onSuccess={() => setOpen(false)}\n                fields={registerFields}\n                extraFields={extraFields}\n                onLoginClick={() => setTab('login')}\n                showLoginLink\n              />\n            </TabsContent>\n          </Tabs>\n        ) : (\n          <>\n            <DialogHeader>\n              <DialogTitle>{m.signIn()}</DialogTitle>\n            </DialogHeader>\n            <LoginForm\n              onSuccess={() => setOpen(false)}\n              socialProviders={[{ provider: 'google', label: 'Googleでログイン' }]}\n            />\n          </>\n        )}\n      </DialogContent>\n    </Dialog>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAkCA,SAAgBK,EAAa,EAC3B,UAAO,SACP,mBACA,kBAKC;CACD,IAAM,EAAE,YAASC,EAAQ,GACnB,CAACC,GAAMC,KAAWC,EAAS,EAAK,GAChC,CAACC,GAAKC,KAAUF,EAA+B,OAAO;CAM5D,OAHI,CAFaG,EAEZ,KACDC,IAAa,OAGf,kBAACC,GAAD;EACQ;EACN,eAAe,MAAa;GAE1B,AADAN,EAAQO,CAAQ,GACZA,KAAUJ,EAAO,OAAO;EAC9B;EALF,UAAA,CAOE,kBAACK,GAAD;GACE,QAAQ,kBAACC,GAAD;IAAQ,SAAQ;IAAY,MAAK;IAAK,WAAU;GAAqB,CAAA;GAE5E,UAAAjB,EAAS;EACG,CAAA,GACf,kBAACkB,GAAD;GAAe,WAAU;GACtB,UAAAC,MAAS,aACR,kBAACC,GAAD;IAAM,OAAOV;IAAK,gBAAgB,MAAMC,EAAOU,CAAyB;IAAxE,UAAA;KACE,kBAACC,GAAD,EAAA,UACE,kBAACC,GAAD;MAAU,WAAU;MAApB,UAAA,CACE,kBAACC,GAAD;OAAa,OAAM;OAAS,UAAAxB,EAAS;MAAe,CAAA,GACpD,kBAACwB,GAAD;OAAa,OAAM;OAAY,UAAAvB,EAAS;MAAe,CAAA,CAC/C;KACE,CAAA,EAAA,CAAA;KACd,kBAACwB,GAAD;MAAa,OAAM;MACjB,UAAA,kBAACC,GAAD;OACE,iBAAiBlB,EAAQ,EAAK;OAC9B,uBAAuBG,EAAO,UAAU;OACxC,kBAAA;MACD,CAAA;KACU,CAAA;KACb,kBAACc,GAAD;MAAa,OAAM;MACjB,UAAA,kBAACE,GAAD;OACE,iBAAiBnB,EAAQ,EAAK;OAC9B,QAAQoB;OACK;OACb,oBAAoBjB,EAAO,OAAO;OAClC,eAAA;MACD,CAAA;KACU,CAAA;IACT;GAEN,CAAA,IAAA,kBAAAT,GAAA,EAAA,UAAA,CACE,kBAACoB,GAAD,EAAA,UACE,kBAACQ,GAAD,EAAA,UAAc9B,EAAS,EAAe,CAAA,EAC1B,CAAA,GACd,kBAAC0B,GAAD;IACE,iBAAiBlB,EAAQ,EAAK;IAC9B,iBAAiB,CAAC;KAAE,UAAU;KAAU,OAAO;IAAc,CAAC;GAC/D,CAAA,CACD,EAAA,CAAA;EAES,CAAA,CACT;;AAEZ"}
+{"version":3,"file":"SignInButton.js","names":["m.signIn","m.signUp","_Fragment","signin1","signup1","SignInButton","useAuth","open","setOpen","useState","tab","setTab","useIsClient","user","Dialog","nextOpen","DialogTrigger","Button","DialogContent","mode","Tabs","v","DialogHeader","TabsList","TabsTrigger","TabsContent","LoginForm","RegisterForm","registerFields","Fragment","DialogTitle"],"sources":["../../../../src/tools/components/auth/SignInButton.tsx"],"sourcesContent":["import { useState } from 'react';\nimport { useAuth } from './useAuth';\nimport { Button } from '../ui/button';\nimport { Dialog, DialogContent, DialogHeader, DialogTitle, DialogTrigger } from '../ui/dialog';\nimport { Tabs, TabsList, TabsTrigger, TabsContent } from '../ui/tabs';\nimport { LoginForm, RegisterForm, type RegisterFieldConfig, type RegisterExtraField } from './AuthForms';\nimport * as m from '../../paraglide/messages.js';\nimport { useIsClient } from '../../lib/hooks/use-is-client';\n\n/**\n * Opens a login dialog or tabbed login/registration dialog for signed-out users.\n *\n * @param props - Dialog mode and optional registration field configuration.\n *\n * @returns Sign-in button/dialog after client mount; null during SSR or when a user exists.\n *\n * @throws Error without AuthProvider.\n *\n * @remarks Requires AuthProvider inside QueryClientProvider and Appkit styles. Defaults\n * to login mode with a Google OAuth button (shown only if adapter support exists).\n * Combined mode provides login/register tabs; successful email login/registration closes\n * the dialog. Each opening resets the selected tab to login.\n *\n * @example\n * ```tsx\n * import '@alneas/appkit-react/styles';\n * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';\n * import { AuthProvider, SignInButton, type AuthAdapter } from '@alneas/appkit-react/tools/auth';\n * export function FormExample({ adapter, queryClient }: { adapter: AuthAdapter; queryClient: QueryClient }) {\n *   return <QueryClientProvider client={queryClient}><AuthProvider adapter={adapter}><SignInButton mode=\"combined\" /></AuthProvider></QueryClientProvider>;\n * }\n * ```\n */\nexport function SignInButton({\n  mode = 'login',\n  registerFields,\n  extraFields,\n}: {\n  /**\n   * Dialog contents: login by default, combined adds registration tabs.\n   */\n  mode?: 'login' | 'combined';\n  /**\n   * Built-in registration input overrides, used only in combined mode.\n   */\n  registerFields?: RegisterFieldConfig;\n  /**\n   * Additional locally validated registration inputs, used only in combined mode; not saved by RegisterForm.\n   */\n  extraFields?: RegisterExtraField[];\n}) {\n  const { user } = useAuth();\n  const [open, setOpen] = useState(false);\n  const [tab, setTab] = useState<'login' | 'register'>('login');\n  const isClient = useIsClient();\n\n  if (!isClient) return null;\n  if (user) return null;\n\n  return (\n    <Dialog\n      open={open}\n      onOpenChange={(nextOpen) => {\n        setOpen(nextOpen);\n        if (nextOpen) setTab('login');\n      }}\n    >\n      <DialogTrigger\n        render={<Button variant='secondary' size='sm' className='transition-colors' />}\n      >\n        {m.signIn()}\n      </DialogTrigger>\n      <DialogContent className='sm:max-w-md'>\n        {mode === 'combined' ? (\n          <Tabs value={tab} onValueChange={(v) => setTab(v as 'login' | 'register')}>\n            <DialogHeader>\n              <TabsList className='grid w-full grid-cols-2'>\n                <TabsTrigger value='login'>{m.signIn()}</TabsTrigger>\n                <TabsTrigger value='register'>{m.signUp()}</TabsTrigger>\n              </TabsList>\n            </DialogHeader>\n            <TabsContent value='login'>\n              <LoginForm\n                onSuccess={() => setOpen(false)}\n                onRegisterClick={() => setTab('register')}\n                showRegisterLink\n              />\n            </TabsContent>\n            <TabsContent value='register'>\n              <RegisterForm\n                onSuccess={() => setOpen(false)}\n                fields={registerFields}\n                extraFields={extraFields}\n                onLoginClick={() => setTab('login')}\n                showLoginLink\n              />\n            </TabsContent>\n          </Tabs>\n        ) : (\n          <>\n            <DialogHeader>\n              <DialogTitle>{m.signIn()}</DialogTitle>\n            </DialogHeader>\n            <LoginForm\n              onSuccess={() => setOpen(false)}\n              socialProviders={[{ provider: 'google', label: 'Googleでログイン' }]}\n            />\n          </>\n        )}\n      </DialogContent>\n    </Dialog>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAiCA,SAAgBK,EAAa,EAC3B,UAAO,SACP,mBACA,kBAcC;CACD,IAAM,EAAE,YAASC,EAAQ,GACnB,CAACC,GAAMC,KAAWC,EAAS,EAAK,GAChC,CAACC,GAAKC,KAAUF,EAA+B,OAAO;CAM5D,OAHI,CAFaG,EAEZ,KACDC,IAAa,OAGf,kBAACC,GAAD;EACQ;EACN,eAAe,MAAa;GAE1B,AADAN,EAAQO,CAAQ,GACZA,KAAUJ,EAAO,OAAO;EAC9B;EALF,UAAA,CAOE,kBAACK,GAAD;GACE,QAAQ,kBAACC,GAAD;IAAQ,SAAQ;IAAY,MAAK;IAAK,WAAU;GAAqB,CAAA;GAE5E,UAAAjB,EAAS;EACG,CAAA,GACf,kBAACkB,GAAD;GAAe,WAAU;GACtB,UAAAC,MAAS,aACR,kBAACC,GAAD;IAAM,OAAOV;IAAK,gBAAgB,MAAMC,EAAOU,CAAyB;IAAxE,UAAA;KACE,kBAACC,GAAD,EAAA,UACE,kBAACC,GAAD;MAAU,WAAU;MAApB,UAAA,CACE,kBAACC,GAAD;OAAa,OAAM;OAAS,UAAAxB,EAAS;MAAe,CAAA,GACpD,kBAACwB,GAAD;OAAa,OAAM;OAAY,UAAAvB,EAAS;MAAe,CAAA,CAC/C;KACE,CAAA,EAAA,CAAA;KACd,kBAACwB,GAAD;MAAa,OAAM;MACjB,UAAA,kBAACC,GAAD;OACE,iBAAiBlB,EAAQ,EAAK;OAC9B,uBAAuBG,EAAO,UAAU;OACxC,kBAAA;MACD,CAAA;KACU,CAAA;KACb,kBAACc,GAAD;MAAa,OAAM;MACjB,UAAA,kBAACE,GAAD;OACE,iBAAiBnB,EAAQ,EAAK;OAC9B,QAAQoB;OACK;OACb,oBAAoBjB,EAAO,OAAO;OAClC,eAAA;MACD,CAAA;KACU,CAAA;IACT;GAEN,CAAA,IAAA,kBAAAT,GAAA,EAAA,UAAA,CACE,kBAACoB,GAAD,EAAA,UACE,kBAACQ,GAAD,EAAA,UAAc9B,EAAS,EAAe,CAAA,EAC1B,CAAA,GACd,kBAAC0B,GAAD;IACE,iBAAiBlB,EAAQ,EAAK;IAC9B,iBAAiB,CAAC;KAAE,UAAU;KAAU,OAAO;IAAc,CAAC;GAC/D,CAAA,CACD,EAAA,CAAA;EAES,CAAA,CACT;;AAEZ"}

package/dist/tools/components/auth/UserProfileProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"UserProfileProvider.cjs","names":["useAuth","useQueryClient","useMemo","useQuery","useMutation","useCallback","ProfileContext","require_runtime","require_tools_components_auth_useAuth","require_tools_components_auth_useUserProfile","react_jsx_runtime","react","_tanstack_react_query","UserProfileProvider","isAuthLoading","queryClient","queryKey","adapter","user","profile","isProfileLoading","profileData","createIfNotExists","defaultProfileData","currentProfile","isLoading","updateMutation","updatePayload","updates","updatedProfile","deleteMutation","updateProfile","refreshProfile","refetch","deleteProfile","contextValue","error"],"sources":["../../../../src/tools/components/auth/UserProfileProvider.tsx"],"sourcesContent":["import React, { useCallback, useMemo } from 'react';\nimport { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';\nimport { useAuth } from './useAuth';\nimport { ProfileAdapter, BaseProfile } from './types';\nimport { ProfileContext } from './useUserProfile';\n\nexport interface UserProfileProviderProps<T extends BaseProfile> {\n  children: React.ReactNode;\n  /** プロファイルアダプター */\n  adapter: ProfileAdapter<T>;\n  /** 新規ユーザー作成時の追加データ */\n  defaultProfileData?: Partial<T>;\n  /** プロファイルが見つからない場合に自動作成 */\n  createIfNotExists?: boolean;\n}\n\n/**\n * ユーザープロファイルプロバイダー\n *\n * 認証ユーザーに紐づくプロファイルデータを管理します。\n * AuthProvider の内側で使用してください。\n *\n * @example\n * ```tsx\n * interface MyProfile extends BaseProfile {\n *   name: string;\n *   role: 'admin' | 'user';\n *   organizationId?: string;\n * }\n *\n * const profileAdapter = createSupabaseProfileAdapter<MyProfile>(supabase, {\n *   tableName: 'profiles',\n * });\n *\n * <AuthProvider adapter={authAdapter}>\n *   <UserProfileProvider adapter={profileAdapter} createIfNotExists>\n *     <App />\n *   </UserProfileProvider>\n * </AuthProvider>\n * ```\n */\nexport function UserProfileProvider<T extends BaseProfile>({\n  children,\n  adapter,\n  defaultProfileData,\n  createIfNotExists = true,\n}: UserProfileProviderProps<T>) {\n  const { user, isLoading: isAuthLoading } = useAuth();\n  const queryClient = useQueryClient();\n\n  // Cache key aligned with data-access: [tableName, 'detail', id]\n  const queryKey = useMemo(\n    () => [adapter.tableName, 'detail', user?.id],\n    [adapter.tableName, user?.id],\n  );\n\n  // Query to fetch or create the profile\n  const {\n    data: profile = null,\n    isLoading: isProfileLoading,\n    error,\n    refetch,\n  } = useQuery({\n    queryKey,\n    queryFn: async (): Promise<T | null> => {\n      if (!user) return null;\n\n      // Try fetching the profile\n      let profileData = await adapter.get(user.id);\n\n      // If it doesn't exist, and createIfNotExists is true, create it\n      if (!profileData && createIfNotExists) {\n        profileData = await adapter.create(user.id, user, defaultProfileData);\n      }\n\n      return profileData;\n    },\n    enabled: !isAuthLoading && !!user,\n  });\n\n  const currentProfile = user ? (profile ?? null) : null;\n  const isLoading = isAuthLoading || (!!user && isProfileLoading);\n\n  // Mutation to update the profile\n  const updateMutation = useMutation({\n    mutationFn: async (updates: Partial<T>): Promise<T> => {\n      if (!currentProfile) {\n        throw new Error('No profile to update');\n      }\n      const updatePayload: Partial<T> = {\n        ...updates,\n        updated_at: new Date().toISOString() as T['updated_at'],\n      };\n      return adapter.update(currentProfile.id, updatePayload);\n    },\n    onSuccess: (updatedProfile) => {\n      queryClient.setQueryData(queryKey, updatedProfile);\n      // Invalidate list queries for this collection to keep any list views fresh\n      queryClient.invalidateQueries({ queryKey: [adapter.tableName, 'list'] });\n    },\n  });\n\n  // Mutation to delete the profile\n  const deleteMutation = useMutation({\n    mutationFn: async (): Promise<void> => {\n      if (!currentProfile) {\n        throw new Error('No profile to delete');\n      }\n      await adapter.delete(currentProfile.id);\n    },\n    onSuccess: () => {\n      queryClient.setQueryData(queryKey, null);\n      queryClient.invalidateQueries({ queryKey: [adapter.tableName, 'list'] });\n    },\n  });\n\n  const updateProfile = useCallback(\n    async (updates: Partial<T>): Promise<T> => {\n      return updateMutation.mutateAsync(updates);\n    },\n    [updateMutation],\n  );\n\n  const refreshProfile = useCallback(async () => {\n    if (!user) return;\n    await refetch();\n  }, [user, refetch]);\n\n  const deleteProfile = useCallback(async (): Promise<void> => {\n    await deleteMutation.mutateAsync();\n  }, [deleteMutation]);\n\n  const contextValue = {\n    profile: currentProfile,\n    isLoading,\n    error: (error || updateMutation.error || deleteMutation.error) as Error | null,\n    updateProfile: updateProfile as unknown as (\n      updates: Partial<BaseProfile>,\n    ) => Promise<BaseProfile>,\n    refreshProfile,\n    deleteProfile,\n  };\n\n  return <ProfileContext.Provider value={contextValue}>{children}</ProfileContext.Provider>;\n}\n"],"mappings":"A,sTAyCA,SAAgBa,EAA2C,CACzD,WACA,UACA,qBACA,oBAAoB,IACU,CAC9B,GAAM,CAAE,OAAM,UAAWC,GAAkBd,EAAAA,QAAQ,EAC7Ce,GAAA,EAAcd,EAAAA,eAAAA,CAAe,EAG7Be,GAAA,EAAWd,EAAAA,QAAAA,KACT,CAACe,EAAQ,UAAW,SAAUC,GAAM,EAAE,EAC5C,CAACD,EAAQ,UAAWC,GAAM,EAAE,CAC9B,EAGM,CACJ,KAAMC,EAAU,KAChB,UAAWC,EACX,QACA,YAAA,EACEjB,EAAAA,SAAAA,CAAS,CACX,WACA,QAAS,SAA+B,CACtC,GAAI,CAACe,EAAM,OAAO,KAGlB,IAAIG,EAAc,MAAMJ,EAAQ,IAAIC,EAAK,EAAE,EAO3C,MAJI,CAACG,GAAeC,IAClB,EAAc,MAAML,EAAQ,OAAOC,EAAK,GAAIA,EAAMK,CAAkB,GAG/DF,CACT,EACA,QAAS,CAACP,GAAiB,CAAC,CAACI,CAC/B,CAAC,EAEKM,EAAiBN,EAAQC,GAAW,KAAQ,KAC5CM,EAAYX,GAAkB,CAAC,CAACI,GAAQE,EAGxCM,GAAA,EAAiBtB,EAAAA,YAAAA,CAAY,CACjC,WAAY,KAAO,IAAoC,CACrD,GAAI,CAACoB,EACH,MAAU,MAAM,sBAAsB,EAExC,IAAMG,EAA4B,CAChC,GAAGC,EACH,WAAY,IAAI,KAAK,CAAA,CAAE,YAAY,CACrC,EACA,OAAOX,EAAQ,OAAOO,EAAe,GAAIG,CAAa,CACxD,EACA,UAAY,GAAmB,CAC7BZ,EAAY,aAAaC,EAAUa,CAAc,EAEjDd,EAAY,kBAAkB,CAAE,SAAU,CAACE,EAAQ,UAAW,MAAM,CAAE,CAAC,CACzE,CACF,CAAC,EAGKa,GAAA,EAAiB1B,EAAAA,YAAAA,CAAY,CACjC,WAAY,SAA2B,CACrC,GAAI,CAACoB,EACH,MAAU,MAAM,sBAAsB,EAExC,MAAMP,EAAQ,OAAOO,EAAe,EAAE,CACxC,EACA,cAAiB,CACfT,EAAY,aAAaC,EAAU,IAAI,EACvCD,EAAY,kBAAkB,CAAE,SAAU,CAACE,EAAQ,UAAW,MAAM,CAAE,CAAC,CACzE,CACF,CAAC,EAEKc,GAAA,EAAgB1B,EAAAA,YAAAA,CACpB,KAAO,IACEqB,EAAe,YAAYE,CAAO,EAE3C,CAACF,CAAc,CACjB,EAEMM,GAAA,EAAiB3B,EAAAA,YAAAA,CAAY,SAAY,CACxCa,GACL,MAAMe,EAAQ,CAChB,EAAG,CAACf,EAAMe,CAAO,CAAC,EAEZC,GAAA,EAAgB7B,EAAAA,YAAAA,CAAY,SAA2B,CAC3D,MAAMyB,EAAe,YAAY,CACnC,EAAG,CAACA,CAAc,CAAC,EAEbK,EAAe,CACnB,QAASX,EACT,YACA,MAAQY,GAASV,EAAe,OAASI,EAAe,MACzC,gBAGf,iBACA,eACF,EAEA,OAAO,EAAApB,EAAA,IAAA,CAACJ,EAAAA,eAAe,SAAhB,CAAyB,MAAO6B,EAAe,UAAkC,CAAA,CAC1F,C"}
+{"version":3,"file":"UserProfileProvider.cjs","names":["useAuth","useQueryClient","useMemo","useQuery","useMutation","useCallback","ProfileContext","require_runtime","require_tools_components_auth_useAuth","require_tools_components_auth_useUserProfile","react_jsx_runtime","react","_tanstack_react_query","UserProfileProvider","isAuthLoading","queryClient","queryKey","adapter","user","profile","isProfileLoading","profileData","createIfNotExists","defaultProfileData","currentProfile","isLoading","updateMutation","updatePayload","updates","updatedProfile","deleteMutation","updateProfile","refreshProfile","refetch","deleteProfile","contextValue","error"],"sources":["../../../../src/tools/components/auth/UserProfileProvider.tsx"],"sourcesContent":["import React, { useCallback, useMemo } from 'react';\nimport { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';\nimport { useAuth } from './useAuth';\nimport { ProfileAdapter, BaseProfile } from './types';\nimport { ProfileContext } from './useUserProfile';\n\n/**\n * Configuration for UserProfileProvider; see its provider example.\n *\n * @typeParam T - Application profile extending BaseProfile with its persisted fields.\n *\n * @see UserProfileProvider for the canonical usage example.\n */\nexport interface UserProfileProviderProps<T extends BaseProfile> {\n  /** Descendants that consume the profile context. */\n  children: React.ReactNode;\n  /** Host-supplied persistence operations and collection name. */\n  adapter: ProfileAdapter<T>;\n  /** Additional fields passed to adapter.create when a profile is missing. */\n  defaultProfileData?: Partial<T>;\n  /** Create a missing profile after authentication; defaults to true. */\n  createIfNotExists?: boolean;\n}\n\n/**\n * Loads and manages the authenticated user's profile through a host adapter.\n *\n *\n * @typeParam T - Persisted profile shape extending BaseProfile.\n *\n * @param props - Children, host persistence adapter and optional creation settings.\n *\n * @returns Profile context around the children; query and mutation errors are exposed in context.\n *\n * @remarks Requires outer QueryClientProvider and AuthProvider. Queries use\n * [adapter.tableName, 'detail', user.id]. Creation defaults to enabled; adapter.create\n * receives defaultProfileData. Updates add updated_at and refresh the detail cache;\n * updates/deletes invalidate collection list queries. Mutations reject if no profile\n * exists or the adapter fails. Query errors remain in context. No CSS is required.\n * The host implements ProfileAdapter and enforces access in its backend.\n *\n * @example\n * ```tsx\n * import type { ReactNode } from 'react';\n * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';\n * import {\n *   AuthProvider, UserProfileProvider,\n *   type AuthAdapter, type BaseProfile, type ProfileAdapter,\n * } from '@alneas/appkit-react/tools/auth';\n * interface MyProfile extends BaseProfile { name: string; }\n * // Supply real host adapters; Appkit does not provide a Supabase profile factory.\n * export function ProfileRoot({ authAdapter, profileAdapter, queryClient, children }: {\n *   authAdapter: AuthAdapter;\n *   profileAdapter: ProfileAdapter<MyProfile>;\n *   queryClient: QueryClient;\n *   children: ReactNode;\n * }) {\n *   return (\n *     <QueryClientProvider client={queryClient}>\n *       <AuthProvider adapter={authAdapter}>\n *         <UserProfileProvider adapter={profileAdapter} createIfNotExists>\n *           {children}\n *         </UserProfileProvider>\n *       </AuthProvider>\n *     </QueryClientProvider>\n *   );\n * }\n * ```\n */\nexport function UserProfileProvider<T extends BaseProfile>({\n  children,\n  adapter,\n  defaultProfileData,\n  createIfNotExists = true,\n}: UserProfileProviderProps<T>) {\n  const { user, isLoading: isAuthLoading } = useAuth();\n  const queryClient = useQueryClient();\n\n  // Cache key aligned with data-access: [tableName, 'detail', id]\n  const queryKey = useMemo(\n    () => [adapter.tableName, 'detail', user?.id],\n    [adapter.tableName, user?.id],\n  );\n\n  // Query to fetch or create the profile\n  const {\n    data: profile = null,\n    isLoading: isProfileLoading,\n    error,\n    refetch,\n  } = useQuery({\n    queryKey,\n    queryFn: async (): Promise<T | null> => {\n      if (!user) return null;\n\n      // Try fetching the profile\n      let profileData = await adapter.get(user.id);\n\n      // If it doesn't exist, and createIfNotExists is true, create it\n      if (!profileData && createIfNotExists) {\n        profileData = await adapter.create(user.id, user, defaultProfileData);\n      }\n\n      return profileData;\n    },\n    enabled: !isAuthLoading && !!user,\n  });\n\n  const currentProfile = user ? (profile ?? null) : null;\n  const isLoading = isAuthLoading || (!!user && isProfileLoading);\n\n  // Mutation to update the profile\n  const updateMutation = useMutation({\n    mutationFn: async (updates: Partial<T>): Promise<T> => {\n      if (!currentProfile) {\n        throw new Error('No profile to update');\n      }\n      const updatePayload: Partial<T> = {\n        ...updates,\n        updated_at: new Date().toISOString() as T['updated_at'],\n      };\n      return adapter.update(currentProfile.id, updatePayload);\n    },\n    onSuccess: (updatedProfile) => {\n      queryClient.setQueryData(queryKey, updatedProfile);\n      // Invalidate list queries for this collection to keep any list views fresh\n      queryClient.invalidateQueries({ queryKey: [adapter.tableName, 'list'] });\n    },\n  });\n\n  // Mutation to delete the profile\n  const deleteMutation = useMutation({\n    mutationFn: async (): Promise<void> => {\n      if (!currentProfile) {\n        throw new Error('No profile to delete');\n      }\n      await adapter.delete(currentProfile.id);\n    },\n    onSuccess: () => {\n      queryClient.setQueryData(queryKey, null);\n      queryClient.invalidateQueries({ queryKey: [adapter.tableName, 'list'] });\n    },\n  });\n\n  const updateProfile = useCallback(\n    async (updates: Partial<T>): Promise<T> => {\n      return updateMutation.mutateAsync(updates);\n    },\n    [updateMutation],\n  );\n\n  const refreshProfile = useCallback(async () => {\n    if (!user) return;\n    await refetch();\n  }, [user, refetch]);\n\n  const deleteProfile = useCallback(async (): Promise<void> => {\n    await deleteMutation.mutateAsync();\n  }, [deleteMutation]);\n\n  const contextValue = {\n    profile: currentProfile,\n    isLoading,\n    error: (error || updateMutation.error || deleteMutation.error) as Error | null,\n    updateProfile: updateProfile as unknown as (\n      updates: Partial<BaseProfile>,\n    ) => Promise<BaseProfile>,\n    refreshProfile,\n    deleteProfile,\n  };\n\n  return <ProfileContext.Provider value={contextValue}>{children}</ProfileContext.Provider>;\n}\n"],"mappings":"A,sTAqEA,SAAgBa,EAA2C,CACzD,WACA,UACA,qBACA,oBAAoB,IACU,CAC9B,GAAM,CAAE,OAAM,UAAWC,GAAkBd,EAAAA,QAAQ,EAC7Ce,GAAA,EAAcd,EAAAA,eAAAA,CAAe,EAG7Be,GAAA,EAAWd,EAAAA,QAAAA,KACT,CAACe,EAAQ,UAAW,SAAUC,GAAM,EAAE,EAC5C,CAACD,EAAQ,UAAWC,GAAM,EAAE,CAC9B,EAGM,CACJ,KAAMC,EAAU,KAChB,UAAWC,EACX,QACA,YAAA,EACEjB,EAAAA,SAAAA,CAAS,CACX,WACA,QAAS,SAA+B,CACtC,GAAI,CAACe,EAAM,OAAO,KAGlB,IAAIG,EAAc,MAAMJ,EAAQ,IAAIC,EAAK,EAAE,EAO3C,MAJI,CAACG,GAAeC,IAClB,EAAc,MAAML,EAAQ,OAAOC,EAAK,GAAIA,EAAMK,CAAkB,GAG/DF,CACT,EACA,QAAS,CAACP,GAAiB,CAAC,CAACI,CAC/B,CAAC,EAEKM,EAAiBN,EAAQC,GAAW,KAAQ,KAC5CM,EAAYX,GAAkB,CAAC,CAACI,GAAQE,EAGxCM,GAAA,EAAiBtB,EAAAA,YAAAA,CAAY,CACjC,WAAY,KAAO,IAAoC,CACrD,GAAI,CAACoB,EACH,MAAU,MAAM,sBAAsB,EAExC,IAAMG,EAA4B,CAChC,GAAGC,EACH,WAAY,IAAI,KAAK,CAAA,CAAE,YAAY,CACrC,EACA,OAAOX,EAAQ,OAAOO,EAAe,GAAIG,CAAa,CACxD,EACA,UAAY,GAAmB,CAC7BZ,EAAY,aAAaC,EAAUa,CAAc,EAEjDd,EAAY,kBAAkB,CAAE,SAAU,CAACE,EAAQ,UAAW,MAAM,CAAE,CAAC,CACzE,CACF,CAAC,EAGKa,GAAA,EAAiB1B,EAAAA,YAAAA,CAAY,CACjC,WAAY,SAA2B,CACrC,GAAI,CAACoB,EACH,MAAU,MAAM,sBAAsB,EAExC,MAAMP,EAAQ,OAAOO,EAAe,EAAE,CACxC,EACA,cAAiB,CACfT,EAAY,aAAaC,EAAU,IAAI,EACvCD,EAAY,kBAAkB,CAAE,SAAU,CAACE,EAAQ,UAAW,MAAM,CAAE,CAAC,CACzE,CACF,CAAC,EAEKc,GAAA,EAAgB1B,EAAAA,YAAAA,CACpB,KAAO,IACEqB,EAAe,YAAYE,CAAO,EAE3C,CAACF,CAAc,CACjB,EAEMM,GAAA,EAAiB3B,EAAAA,YAAAA,CAAY,SAAY,CACxCa,GACL,MAAMe,EAAQ,CAChB,EAAG,CAACf,EAAMe,CAAO,CAAC,EAEZC,GAAA,EAAgB7B,EAAAA,YAAAA,CAAY,SAA2B,CAC3D,MAAMyB,EAAe,YAAY,CACnC,EAAG,CAACA,CAAc,CAAC,EAEbK,EAAe,CACnB,QAASX,EACT,YACA,MAAQY,GAASV,EAAe,OAASI,EAAe,MACzC,gBAGf,iBACA,eACF,EAEA,OAAO,EAAApB,EAAA,IAAA,CAACJ,EAAAA,eAAe,SAAhB,CAAyB,MAAO6B,EAAe,UAAkC,CAAA,CAC1F,C"}

package/dist/tools/components/auth/UserProfileProvider.d.cts

@@ -1,37 +1,65 @@
 import { default as React } from 'react';
 import { ProfileAdapter, BaseProfile } from './types.cjs';
+/**
+ * Configuration for UserProfileProvider; see its provider example.
+ *
+ * @typeParam T - Application profile extending BaseProfile with its persisted fields.
+ *
+ * @see UserProfileProvider for the canonical usage example.
+ */
 export interface UserProfileProviderProps<T extends BaseProfile> {
+    /** Descendants that consume the profile context. */
     children: React.ReactNode;
-    /** プロファイルアダプター */
+    /** Host-supplied persistence operations and collection name. */
     adapter: ProfileAdapter<T>;
-    /** 新規ユーザー作成時の追加データ */
+    /** Additional fields passed to adapter.create when a profile is missing. */
     defaultProfileData?: Partial<T>;
-    /** プロファイルが見つからない場合に自動作成 */
+    /** Create a missing profile after authentication; defaults to true. */
     createIfNotExists?: boolean;
 }
 /**
- * ユーザープロファイルプロバイダー
+ * Loads and manages the authenticated user's profile through a host adapter.
+ *
  *
- * 認証ユーザーに紐づくプロファイルデータを管理します。
- * AuthProvider の内側で使用してください。
+ * @typeParam T - Persisted profile shape extending BaseProfile.
+ *
+ * @param props - Children, host persistence adapter and optional creation settings.
+ *
+ * @returns Profile context around the children; query and mutation errors are exposed in context.
+ *
+ * @remarks Requires outer QueryClientProvider and AuthProvider. Queries use
+ * [adapter.tableName, 'detail', user.id]. Creation defaults to enabled; adapter.create
+ * receives defaultProfileData. Updates add updated_at and refresh the detail cache;
+ * updates/deletes invalidate collection list queries. Mutations reject if no profile
+ * exists or the adapter fails. Query errors remain in context. No CSS is required.
+ * The host implements ProfileAdapter and enforces access in its backend.
  *
  * @example
  * ```tsx
- * interface MyProfile extends BaseProfile {
- *   name: string;
- *   role: 'admin' | 'user';
- *   organizationId?: string;
+ * import type { ReactNode } from 'react';
+ * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+ * import {
+ *   AuthProvider, UserProfileProvider,
+ *   type AuthAdapter, type BaseProfile, type ProfileAdapter,
+ * } from '@alneas/appkit-react/tools/auth';
+ * interface MyProfile extends BaseProfile { name: string; }
+ * // Supply real host adapters; Appkit does not provide a Supabase profile factory.
+ * export function ProfileRoot({ authAdapter, profileAdapter, queryClient, children }: {
+ *   authAdapter: AuthAdapter;
+ *   profileAdapter: ProfileAdapter<MyProfile>;
+ *   queryClient: QueryClient;
+ *   children: ReactNode;
+ * }) {
+ *   return (
+ *     <QueryClientProvider client={queryClient}>
+ *       <AuthProvider adapter={authAdapter}>
+ *         <UserProfileProvider adapter={profileAdapter} createIfNotExists>
+ *           {children}
+ *         </UserProfileProvider>
+ *       </AuthProvider>
+ *     </QueryClientProvider>
+ *   );
  * }
- *
- * const profileAdapter = createSupabaseProfileAdapter<MyProfile>(supabase, {
- *   tableName: 'profiles',
- * });
- *
- * <AuthProvider adapter={authAdapter}>
- *   <UserProfileProvider adapter={profileAdapter} createIfNotExists>
- *     <App />
- *   </UserProfileProvider>
- * </AuthProvider>
  * ```
  */
 export declare function UserProfileProvider<T extends BaseProfile>({ children, adapter, defaultProfileData, createIfNotExists, }: UserProfileProviderProps<T>): React.JSX.Element;