@hex-core/components 1.8.0 → 1.9.0

package/dist/_tsup-dts-rollup.d.ts

@@ -401,6 +401,275 @@ export { AudioWaveformProps as AudioWaveformProps_alias_1 }
 
 export declare const audioWaveformSchema: ComponentSchemaDefinition;
 
+declare interface AuthAdapter {
+    signInWithPassword?(p: {
+        email: string;
+        password: string;
+        remember: boolean;
+    }): Promise<AuthAdapterResult>;
+    signUpWithPassword?(p: {
+        email: string;
+        password: string;
+        name?: string;
+    }): Promise<AuthAdapterResult>;
+    signInWithSocial?(p: {
+        provider: AuthSocialProvider;
+    }): Promise<AuthAdapterResult>;
+    sendMagicLink?(p: {
+        email: string;
+    }): Promise<AuthAdapterResult>;
+    verifyOtp?(p: {
+        code: string;
+        intent: AuthOtpIntent;
+    }): Promise<AuthAdapterResult>;
+    requestPasswordReset?(p: {
+        email: string;
+    }): Promise<AuthAdapterResult>;
+    resetPassword?(p: {
+        token: string;
+        password: string;
+    }): Promise<AuthAdapterResult>;
+    registerPasskey?(): Promise<AuthAdapterResult>;
+    signInWithPasskey?(): Promise<AuthAdapterResult>;
+    /**
+     * Re-send a magic link to the same address. Distinct from {@link sendMagicLink}
+     * so consumers can throttle resends and surface different analytics / error
+     * copy for the second-and-onward attempt. Used by the verify-email block.
+     */
+    resendMagicLink?(p: {
+        email: string;
+    }): Promise<AuthAdapterResult>;
+    /**
+     * Re-send a one-time code for the given intent. Distinct from the initial
+     * code dispatch so consumers can throttle and log resends separately. Used
+     * by the verify-otp block.
+     */
+    resendOtp?(p: {
+        intent: AuthOtpIntent;
+    }): Promise<AuthAdapterResult>;
+}
+export { AuthAdapter }
+export { AuthAdapter as AuthAdapter_alias_1 }
+export { AuthAdapter as AuthAdapter_alias_2 }
+
+/**
+ * The contract every Hex Core auth block consumes via its `adapter` prop.
+ *
+ * Hex Core does not ship session management — auth blocks are presentation-
+ * only and delegate every credential, OTP, and OAuth handoff to whatever
+ * the consumer wires up (better-auth, Clerk, NextAuth, Supabase Auth, a
+ * custom server, …). The adapter is the single seam.
+ *
+ * Every method is **optional**. A block that needs `signInWithPassword` but
+ * not passkeys passes an adapter implementing only the methods it needs;
+ * the block surfaces a runtime error if the user hits a code path the
+ * adapter doesn't implement, rather than failing to render. This lets a
+ * consumer ship password-only on day one and add passkeys later without
+ * forking the block source.
+ *
+ * A reference {@link mockAuthAdapter} lives below — used by the docs
+ * showcase routes and unit tests; never ship it in production.
+ */
+declare interface AuthAdapterResult {
+    ok: boolean;
+    error?: {
+        code: string;
+        message: string;
+    };
+    redirect?: string;
+}
+export { AuthAdapterResult }
+export { AuthAdapterResult as AuthAdapterResult_alias_1 }
+export { AuthAdapterResult as AuthAdapterResult_alias_2 }
+
+/**
+ * "Forgot password" page. Single email field; on success swaps to a
+ * confirmation state composed from `Empty` ("we sent you a link") plus a
+ * "back to sign in" affordance. Routes the dispatch through
+ * `adapter.requestPasswordReset`.
+ */
+declare function AuthForgotPassword({ adapter, signInHref, className, onSuccess, }: AuthForgotPasswordProps): JSX.Element;
+export { AuthForgotPassword }
+export { AuthForgotPassword as AuthForgotPassword_alias_1 }
+export { AuthForgotPassword as AuthForgotPassword_alias_2 }
+
+declare interface AuthForgotPasswordProps {
+    adapter: AuthAdapter;
+    signInHref?: string;
+    className?: string;
+    onSuccess?: () => void;
+}
+export { AuthForgotPasswordProps }
+export { AuthForgotPasswordProps as AuthForgotPasswordProps_alias_1 }
+export { AuthForgotPasswordProps as AuthForgotPasswordProps_alias_2 }
+
+export declare const authForgotPasswordSchema: ComponentSchemaDefinition;
+
+declare type AuthOtpIntent = "sign-in" | "verify-email" | "mfa";
+export { AuthOtpIntent }
+export { AuthOtpIntent as AuthOtpIntent_alias_1 }
+export { AuthOtpIntent as AuthOtpIntent_alias_2 }
+
+/**
+ * "Reset password" page. Two fields (new password + confirm) with manual
+ * confirm-match and minLength validation. The opaque `token` is forwarded
+ * verbatim to `adapter.resetPassword`. Routes the consumer-supplied adapter
+ * is responsible for binding the token to a user account on the backend.
+ */
+declare function AuthResetPassword({ adapter, token, signInHref, passwordMinLength, className, onSuccess, }: AuthResetPasswordProps): JSX.Element;
+export { AuthResetPassword }
+export { AuthResetPassword as AuthResetPassword_alias_1 }
+export { AuthResetPassword as AuthResetPassword_alias_2 }
+
+declare interface AuthResetPasswordProps {
+    adapter: AuthAdapter;
+    /** Reset token, typically read from `?token=…` by the showcase / consumer route. */
+    token: string;
+    signInHref?: string;
+    passwordMinLength?: number;
+    className?: string;
+    onSuccess?: (redirect: string | undefined) => void;
+}
+export { AuthResetPasswordProps }
+export { AuthResetPasswordProps as AuthResetPasswordProps_alias_1 }
+export { AuthResetPasswordProps as AuthResetPasswordProps_alias_2 }
+
+export declare const authResetPasswordSchema: ComponentSchemaDefinition;
+
+declare interface AuthSignInSocialProvider {
+    provider: AuthSocialProvider;
+    label: string;
+    icon?: React_2.ReactNode;
+}
+export { AuthSignInSocialProvider }
+export { AuthSignInSocialProvider as AuthSignInSocialProvider_alias_1 }
+export { AuthSignInSocialProvider as AuthSignInSocialProvider_alias_2 }
+
+/**
+ * Split-screen sign-in page. Marketing panel on the left (≥lg), credential
+ * form on the right. All submit paths route through the supplied
+ * `AuthAdapter` — Hex Core never touches credentials directly.
+ */
+declare function AuthSignInSplit({ adapter, socialProviders, brand, marketing, signUpHref, forgotPasswordHref, className, onSuccess, }: AuthSignInSplitProps): JSX.Element;
+export { AuthSignInSplit }
+export { AuthSignInSplit as AuthSignInSplit_alias_1 }
+export { AuthSignInSplit as AuthSignInSplit_alias_2 }
+
+declare interface AuthSignInSplitProps {
+    /** Wires every credential / OAuth call to the consumer's auth library. */
+    adapter: AuthAdapter;
+    /** Optional list of social-login buttons rendered above the email field. */
+    socialProviders?: ReadonlyArray<AuthSignInSocialProvider>;
+    /** Brand block (logo + product name) shown at the top of the marketing panel. */
+    brand?: React_2.ReactNode;
+    /** Marketing copy / quote / illustration shown below the brand block. */
+    marketing?: React_2.ReactNode;
+    /** Href for the "Sign up" link rendered below the form. */
+    signUpHref?: string;
+    /** Href for the "Forgot?" link inline with the password label. */
+    forgotPasswordHref?: string;
+    /** Additional classes applied to the root grid wrapper. */
+    className?: string;
+    /** Called after a successful sign-in (any flow) with the adapter's redirect target. */
+    onSuccess?: (redirect: string | undefined) => void;
+}
+export { AuthSignInSplitProps }
+export { AuthSignInSplitProps as AuthSignInSplitProps_alias_1 }
+export { AuthSignInSplitProps as AuthSignInSplitProps_alias_2 }
+
+export declare const authSignInSplitSchema: ComponentSchemaDefinition;
+
+/** Centered-card sign-up page. Composes Card + form fields + optional social. */
+declare function AuthSignUpCard({ adapter, socialProviders, signInHref, termsHref, privacyHref, passwordMinLength, className, onSuccess, }: AuthSignUpCardProps): JSX.Element;
+export { AuthSignUpCard }
+export { AuthSignUpCard as AuthSignUpCard_alias_1 }
+export { AuthSignUpCard as AuthSignUpCard_alias_2 }
+
+declare interface AuthSignUpCardProps {
+    adapter: AuthAdapter;
+    socialProviders?: ReadonlyArray<AuthSignUpCardSocialProvider>;
+    signInHref?: string;
+    termsHref?: string;
+    privacyHref?: string;
+    passwordMinLength?: number;
+    className?: string;
+    onSuccess?: (redirect: string | undefined) => void;
+}
+export { AuthSignUpCardProps }
+export { AuthSignUpCardProps as AuthSignUpCardProps_alias_1 }
+export { AuthSignUpCardProps as AuthSignUpCardProps_alias_2 }
+
+export declare const authSignUpCardSchema: ComponentSchemaDefinition;
+
+declare interface AuthSignUpCardSocialProvider {
+    provider: AuthSocialProvider;
+    label: string;
+    icon?: React_2.ReactNode;
+}
+export { AuthSignUpCardSocialProvider }
+export { AuthSignUpCardSocialProvider as AuthSignUpCardSocialProvider_alias_1 }
+export { AuthSignUpCardSocialProvider as AuthSignUpCardSocialProvider_alias_2 }
+
+declare type AuthSocialProvider = "github" | "google" | "microsoft" | (string & {});
+export { AuthSocialProvider }
+export { AuthSocialProvider as AuthSocialProvider_alias_1 }
+export { AuthSocialProvider as AuthSocialProvider_alias_2 }
+
+/**
+ * Transactional "verify your email" page. Mostly visual — composes the
+ * `Empty` primitive with a mail icon plus an optional resend button. The
+ * resend button is hidden when `adapter.resendMagicLink` is absent. Rate-
+ * limit pressure handled client-side via a cooldown timer.
+ */
+declare function AuthVerifyEmail({ adapter, email, resendCooldownSeconds, signInHref, className, }: AuthVerifyEmailProps): JSX.Element;
+export { AuthVerifyEmail }
+export { AuthVerifyEmail as AuthVerifyEmail_alias_1 }
+export { AuthVerifyEmail as AuthVerifyEmail_alias_2 }
+
+declare interface AuthVerifyEmailProps {
+    adapter: AuthAdapter;
+    /** Optional address shown in the description ("we sent a link to <email>"). */
+    email?: string;
+    /** Seconds to disable the resend button after each successful resend. */
+    resendCooldownSeconds?: number;
+    /** Href for the "Back to sign in" affordance. */
+    signInHref?: string;
+    className?: string;
+}
+export { AuthVerifyEmailProps }
+export { AuthVerifyEmailProps as AuthVerifyEmailProps_alias_1 }
+export { AuthVerifyEmailProps as AuthVerifyEmailProps_alias_2 }
+
+export declare const authVerifyEmailSchema: ComponentSchemaDefinition;
+
+/**
+ * One-time-code verification page. Renders an `InputOTP` of `length` slots
+ * and submits automatically when the code is full. Routes verification
+ * through `adapter.verifyOtp({ code, intent })`. Optional resend button
+ * calls `adapter.resendOtp({ intent })` when implemented.
+ */
+declare function AuthVerifyOtp({ adapter, intent, length, resendCooldownSeconds, className, onSuccess, }: AuthVerifyOtpProps): JSX.Element;
+export { AuthVerifyOtp }
+export { AuthVerifyOtp as AuthVerifyOtp_alias_1 }
+export { AuthVerifyOtp as AuthVerifyOtp_alias_2 }
+
+declare interface AuthVerifyOtpProps {
+    adapter: AuthAdapter;
+    /** Forwarded verbatim to adapter.verifyOtp({ code, intent }). */
+    intent: AuthOtpIntent;
+    /** Total number of digits in the code. Defaults to 6. */
+    length?: number;
+    /** Seconds the resend button stays disabled after each successful resend. */
+    resendCooldownSeconds?: number;
+    className?: string;
+    onSuccess?: (redirect: string | undefined) => void;
+}
+export { AuthVerifyOtpProps }
+export { AuthVerifyOtpProps as AuthVerifyOtpProps_alias_1 }
+export { AuthVerifyOtpProps as AuthVerifyOtpProps_alias_2 }
+
+export declare const authVerifyOtpSchema: ComponentSchemaDefinition;
+
 /** Root container for an avatar (image + fallback). */
 declare const Avatar: React_2.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarProps & React_2.RefAttributes<HTMLSpanElement>, "ref"> & React_2.RefAttributes<HTMLSpanElement>>;
 export { Avatar }
@@ -1445,7 +1714,7 @@ export { DataTable }
 export { DataTable as DataTable_alias_1 }
 
 /**
- * Generic DataTable wrapper that renders a TanStack Table model using Hex UI's
+ * Generic DataTable wrapper that renders a TanStack Table model using Hex Core's
  * Table primitives. Pass columns + data; use TanStack hooks for sorting,
  * filtering, pagination, row-selection as needed.
  * @template TData - Row data type. Cell value types are inferred per column by TanStack.
@@ -1461,7 +1730,7 @@ declare interface DataTableProps<TData> {
     /**
      * Accessible label for the table when no visible caption is shown.
      * Forwarded as `aria-label` on the underlying `<table>` element. Kebab-case
-     * to match the canonical ARIA prop convention used elsewhere in Hex UI.
+     * to match the canonical ARIA prop convention used elsewhere in Hex Core.
      */
     "aria-label"?: string;
 }
@@ -2525,7 +2794,7 @@ export { hslToRgb as hslToRgb_alias_1 }
  * `@hex-core/tokens` themes (`H S% L%`, e.g. `"240 5.9% 10%"` — no `hsl()`
  * wrapper, no commas).
  *
- * The triplet is the round-trip-safe serialization for Hex UI: tokens flow
+ * The triplet is the round-trip-safe serialization for Hex Core: tokens flow
  * triplet → CSS `hsl(var(--token))` → rendered color, and the ColorPicker
  * component edits triplets directly. Hex/RGB conversions are display
  * adapters, not the source of truth.
@@ -3059,6 +3328,17 @@ declare const mindMapSchema: ComponentSchemaDefinition;
 export { mindMapSchema }
 export { mindMapSchema as mindMapSchema_alias_1 }
 
+/**
+ * In-memory mock adapter for docs showcase + tests. Every method delays
+ * 400ms to simulate a network round-trip and resolves `{ ok: true }`. Do
+ * not use in production — there is no validation, no persistence, and no
+ * security.
+ */
+declare const mockAuthAdapter: Required<AuthAdapter>;
+export { mockAuthAdapter }
+export { mockAuthAdapter as mockAuthAdapter_alias_1 }
+export { mockAuthAdapter as mockAuthAdapter_alias_2 }
+
 /**
  * Searchable multi-select input built on Command + Popover.
  *
@@ -4564,7 +4844,7 @@ export { Textarea as Textarea_alias_1 }
 
 /**
  * A styled multi-line text input with smooth focus transitions and shadow effects.
- * Extends the native HTML textarea element with Hex UI styling.
+ * Extends the native HTML textarea element with Hex Core styling.
  */
 declare type TextareaProps = React_2.TextareaHTMLAttributes<HTMLTextAreaElement>;
 export { TextareaProps }
@@ -4732,7 +5012,7 @@ export { toast as toast_alias_1 }
 
 /**
  * The global toast container. Render once in your app root.
- * Re-export of Sonner's Toaster styled to use Hex UI theme tokens.
+ * Re-export of Sonner's Toaster styled to use Hex Core theme tokens.
  * @param props - Sonner Toaster props (position, richColors, etc.)
  * @returns A styled portal container for toast notifications
  */

package/dist/auth-forgot-password.d.ts

@@ -0,0 +1,2 @@
+export { AuthForgotPassword_alias_2 as AuthForgotPassword } from './_tsup-dts-rollup.js';
+export { AuthForgotPasswordProps_alias_2 as AuthForgotPasswordProps } from './_tsup-dts-rollup.js';