@exegia/corpora-ui 0.6.0 → 0.8.0

package/dist-lib/components/blocks/auth/__tests__/linked-accounts-block.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/components/blocks/auth/__tests__/onboarding-block.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/components/blocks/auth/__tests__/passkey-manager-block.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/components/blocks/auth/__tests__/passkey-sign-in-block.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/components/blocks/auth/__tests__/signup-block.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/components/blocks/auth/__tests__/update-password-block.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/components/blocks/auth/linked-accounts-block.d.ts

@@ -0,0 +1,30 @@
+import { SocialProvider } from '../../composed/social-providers';
+import * as React from "react";
+/** One sign-in identity attached to the account. */
+export interface LinkedIdentity {
+    id: string;
+    provider: SocialProvider;
+    /** Account address shown under the provider name, when known. */
+    email?: string | null;
+}
+export interface LinkedAccountsBlockProps {
+    title?: string;
+    description?: string;
+    /** Identities already attached to the account. */
+    identities?: LinkedIdentity[];
+    /** Providers offered as connect candidates; connected ones are filtered out. */
+    providers?: SocialProvider[];
+    /** Shows the loading row instead of the list. */
+    loading?: boolean;
+    /** Reject (or throw) to show the inline error. */
+    onLink?: (provider: SocialProvider) => Promise<void> | void;
+    onUnlink?: (id: string) => Promise<void> | void;
+    className?: string;
+}
+/**
+ * Settings panel for the sign-in identities attached to an account: lists the
+ * connected ones, offers connect buttons for the rest, and guards the last
+ * remaining method from being disconnected — the guard is a disabled button
+ * plus an explanation rather than an error after the fact.
+ */
+export declare function LinkedAccountsBlock({ title, description, identities, providers, loading, onLink, onUnlink, className, }: LinkedAccountsBlockProps): React.JSX.Element;

package/dist-lib/components/blocks/auth/onboarding/profile-step.d.ts

@@ -0,0 +1,19 @@
+import { OnboardingStepConfig, OnboardingValue } from '../onboarding-block';
+import * as React from "react";
+export interface ProfileStepProps {
+    step: OnboardingStepConfig;
+    /** Seed values, so drafts survive back/forward navigation. */
+    values: Record<string, OnboardingValue>;
+    submitting?: boolean;
+    submitLabel: string;
+    onSubmit: (values: Record<string, OnboardingValue>) => void | Promise<void>;
+    onBack?: () => void;
+    /** Reports every edit so the flow can restore drafts across navigation. */
+    onDraftChange?: (name: string, value: OnboardingValue) => void;
+}
+/**
+ * Renders one declared profile step: `OnboardingFieldConfig[]` → labeled
+ * controls, validated locally before anything is handed to `onSubmit`. Mounted
+ * keyed by `step.id` so drafts re-seed per step.
+ */
+export declare function ProfileStep({ step, values, submitting, submitLabel, onSubmit, onBack, onDraftChange, }: ProfileStepProps): React.JSX.Element;

package/dist-lib/components/blocks/auth/onboarding-block.d.ts

@@ -0,0 +1,69 @@
+import { AuthAccent } from '../../../lib/auth-accent';
+import * as React from "react";
+/** Value a single onboarding field can hold. */
+export type OnboardingValue = string | boolean;
+export interface OnboardingSelectOption {
+    value: string;
+    label: string;
+}
+interface OnboardingFieldBase {
+    /** Key the value is collected under; unique within the flow. */
+    name: string;
+    label: string;
+    /** Required fields gate the step's advance. */
+    required?: boolean;
+    placeholder?: string;
+    /** Extra validation; return a message to reject, `null` to accept. */
+    validate?: (value: string) => string | null;
+}
+export interface OnboardingTextField extends OnboardingFieldBase {
+    kind: "text" | "textarea" | "url";
+}
+export interface OnboardingCheckboxField extends OnboardingFieldBase {
+    kind: "checkbox";
+}
+export interface OnboardingSelectField extends OnboardingFieldBase {
+    kind: "select";
+    options: OnboardingSelectOption[];
+}
+/** Discriminated on `kind`. */
+export type OnboardingFieldConfig = OnboardingTextField | OnboardingCheckboxField | OnboardingSelectField;
+export interface OnboardingStepConfig {
+    /** Unique within the flow and stable across releases. */
+    id: string;
+    title: string;
+    description?: string;
+    fields: OnboardingFieldConfig[];
+}
+/** Default configuration: a single required display-name step. */
+export declare const DEFAULT_ONBOARDING_STEPS: OnboardingStepConfig[];
+export interface OnboardingBlockProps {
+    /** Declared profile steps. */
+    steps?: OnboardingStepConfig[];
+    /** Brand mark rendered above the title. Omit for no logo row at all. */
+    logo?: React.ReactNode;
+    /** Brand accent for the primary action. Omit to keep the default primary. */
+    accent?: AuthAccent;
+    /**
+     * Fires per step as it is submitted. Reject (or throw) to keep the user on
+     * the step and show the error.
+     */
+    onStepSubmit?: (stepId: string, values: Record<string, OnboardingValue>) => Promise<void> | void;
+    /** Fires once, after the final step is accepted, with the merged profile. */
+    onComplete?: (profile: Record<string, OnboardingValue>) => Promise<void> | void;
+    /** Shows a brief success screen once onboarding completes. */
+    showCompleteScreen?: boolean;
+    className?: string;
+}
+/**
+ * Multi-step profile onboarding: a declared `steps` config renders as
+ * progress-tracked forms with back/forward navigation, per-step submission and
+ * a single completion signal. Drafts survive back-navigation, and the step
+ * heading takes focus on advance so a screen reader announces where the flow
+ * moved.
+ *
+ * Account creation and email confirmation are separate blocks (`SignupBlock`,
+ * `CodeAuthBlock`) — this one picks up once the account exists.
+ */
+export declare function OnboardingBlock({ steps, logo, accent, onStepSubmit, onComplete, showCompleteScreen, className, }: OnboardingBlockProps): React.JSX.Element | null;
+export {};

package/dist-lib/components/blocks/auth/passkey-manager-block.d.ts

@@ -0,0 +1,38 @@
+import * as React from "react";
+/** One registered passkey, as rendered by {@link PasskeyManagerBlock}. */
+export interface PasskeyRecord {
+    id: string;
+    /** Server-derived name; falls back to "Passkey" when absent. */
+    name?: string | null;
+    /** ISO timestamps. Unparseable values are simply not shown. */
+    createdAt?: string | null;
+    lastUsedAt?: string | null;
+}
+export interface PasskeyManagerBlockProps {
+    title?: string;
+    description?: string;
+    /** The account's passkeys, newest first. */
+    passkeys?: PasskeyRecord[];
+    /** Whether this device can register passkeys at all. */
+    available?: boolean;
+    /** Shows the loading row instead of the list. */
+    loading?: boolean;
+    /**
+     * Reject (or throw) to show the error. Resolving with `{ cancelled: true }`
+     * returns silently to idle — a dismissed OS prompt is not a failure.
+     */
+    onRegister?: () => Promise<{
+        cancelled?: boolean;
+    } | void> | void;
+    onRename?: (id: string, name: string) => Promise<void> | void;
+    onDelete?: (id: string) => Promise<void> | void;
+    className?: string;
+}
+/**
+ * Settings panel for the passkeys on an account: register, inline rename with
+ * field-level validation, and delete behind an explicit confirmation. Deleting
+ * the last passkey is allowed — it is the account's passkey method that goes
+ * away, not its only way in — so the confirmation carries a warning instead of
+ * a block.
+ */
+export declare function PasskeyManagerBlock({ title, description, passkeys, available, loading, onRegister, onRename, onDelete, className, }: PasskeyManagerBlockProps): React.JSX.Element;

package/dist-lib/components/blocks/auth/passkey-sign-in-block.d.ts

@@ -0,0 +1,27 @@
+import * as React from "react";
+export interface PasskeySignInBlockProps {
+    /**
+     * Whether this device can use passkeys. `false` renders nothing at all —
+     * a passkey button that is guaranteed to fail is worse than no button.
+     */
+    available?: boolean;
+    /** Button label. */
+    label?: string;
+    /**
+     * Reject (or throw) to show the inline error. Resolving with
+     * `{ cancelled: true }` returns silently to idle — a dismissed OS prompt is
+     * not a failure and must not surface an error.
+     */
+    onSignIn?: () => Promise<{
+        cancelled?: boolean;
+    } | void> | void;
+    /** Hint shown under an error, pointing at the remaining sign-in methods. */
+    fallbackHint?: React.ReactNode;
+    className?: string;
+}
+/**
+ * Passkey sign-in entry point — a single button plus its error state, sized
+ * to drop into a login card next to the password form rather than to stand on
+ * its own. Renders `null` while passkeys are unavailable.
+ */
+export declare function PasskeySignInBlock({ available, label, onSignIn, fallbackHint, className, }: PasskeySignInBlockProps): React.JSX.Element | null;

package/dist-lib/components/blocks/auth/signup-block.d.ts

@@ -4,6 +4,11 @@ import * as React from "react";
 export interface SignupBlockProps {
     title?: string;
     description?: string;
+    /**
+     * Replaces the built-in "terms" link inside the consent label — pass your
+     * own dialog trigger to render it inline instead of wiring `onTerms`.
+     */
+    termsComponent?: React.ReactNode;
     /** Brand mark rendered above the title. Omit for no logo row at all. */
     logo?: React.ReactNode;
     /** Brand accent for the primary action. Omit to keep the default primary. */
@@ -12,6 +17,16 @@ export interface SignupBlockProps {
     showNameField?: boolean;
     /** Require the terms checkbox before submitting. */
     showTerms?: boolean;
+    /**
+     * Controls the terms checkbox. Pass it with `onTermsCheckedChange` when
+     * something outside the block has to tick the box — an "I agree" action in
+     * your own terms dialog, say. Omit to let the block own the state.
+     */
+    termsChecked?: boolean;
+    /** Starting state of the terms checkbox while it is uncontrolled. */
+    defaultTermsChecked?: boolean;
+    /** Fires on every change, controlled or not. */
+    onTermsCheckedChange?: (checked: boolean) => void;
     /** Block submission until every password requirement is met. */
     enforceStrongPassword?: boolean;
     onSubmit?: (data: {
@@ -23,4 +38,4 @@ export interface SignupBlockProps {
     onLogin?: () => void;
     onTerms?: () => void;
 }
-export declare function SignupBlock({ title, description, logo, accent, providers, showNameField, showTerms, enforceStrongPassword, onSubmit, onProviderSelect, onLogin, onTerms, }: SignupBlockProps): React.JSX.Element;
+export declare function SignupBlock({ title, description, logo, accent, providers, showNameField, showTerms, termsChecked, defaultTermsChecked, onTermsCheckedChange, enforceStrongPassword, onSubmit, termsComponent, onProviderSelect, onLogin, onTerms, }: SignupBlockProps): React.JSX.Element;

package/dist-lib/components/blocks/auth/update-password-block.d.ts

@@ -0,0 +1,28 @@
+import { AuthAccent } from '../../../lib/auth-accent';
+import * as React from "react";
+export interface UpdatePasswordBlockProps {
+    title?: string;
+    description?: string;
+    /** Brand mark rendered above the title. Omit for no logo row at all. */
+    logo?: React.ReactNode;
+    /** Brand accent for the primary action. Omit to keep the default primary. */
+    accent?: AuthAccent;
+    /**
+     * Minimum strength (0-4, as scored by `getPasswordStrength`) the new
+     * password must reach before the confirm field is revealed. 0 disables the
+     * gate.
+     */
+    minStrength?: number;
+    /** Reject (or throw) to show the error state with the error's message. */
+    onSubmit?: (data: {
+        password: string;
+    }) => Promise<void> | void;
+    onDone?: () => void;
+}
+/**
+ * Password change form for an already-authenticated user: a strength-metered
+ * new password gates the confirm field, which in turn gates the submit
+ * button. Mismatch is caught client-side; everything else comes back as a
+ * rejection from `onSubmit`.
+ */
+export declare function UpdatePasswordBlock({ title, description, logo, accent, minStrength, onSubmit, onDone, }: UpdatePasswordBlockProps): React.JSX.Element;

package/dist-lib/components/composed/social-providers.d.ts

@@ -1,5 +1,12 @@
 import type * as React from "react";
 export type SocialProvider = "google" | "apple" | "github" | "x";
+/** Label + brand mark per provider, shared with the auth blocks. */
+export declare const SOCIAL_PROVIDERS: Record<SocialProvider, {
+    label: string;
+    Icon: React.ComponentType<{
+        className?: string;
+    }>;
+}>;
 declare const ACTION_LABELS: {
     readonly login: "Login with";
     readonly signup: "Sign up with";

package/dist-lib/index.d.ts

@@ -22,8 +22,13 @@ export * from './components/composed/social-providers';
 export * from './components/blocks/auth/auth-shell';
 export * from './components/blocks/auth/code-auth-block';
 export * from './components/blocks/auth/forgot-password-block';
+export * from './components/blocks/auth/linked-accounts-block';
 export * from './components/blocks/auth/login-block';
+export * from './components/blocks/auth/onboarding-block';
+export * from './components/blocks/auth/passkey-manager-block';
+export * from './components/blocks/auth/passkey-sign-in-block';
 export * from './components/blocks/auth/signup-block';
+export * from './components/blocks/auth/update-password-block';
 export * from './lib/auth-accent';
 export * from './lib/sound';
 export * from './lib/utils';