@arbidocs/blocks 0.5.22 → 0.5.24

package/dist/connection/auth/CompactLogin.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The compact sign-in of embedded hosts (an Office task pane, a browser extension): email and
+ * password, or SSO in a popup (the host opens it, `onSsoSignIn`) followed by the master password
+ * the account's keys are derived from. The same actions as the sign-in page (`useLoginActions`)
+ * and the same SSO completion as the callback page (`completeSsoSignIn`), arranged for a narrow
+ * pane, with errors shown in place.
+ */
+import { type ReactElement } from 'react';
+import { type SsoUser } from './support';
+export interface CompactLoginOptions {
+    /**
+     * Sign in at the SSO provider in a popup: the provider's token and user, or `null` when the
+     * popup closed without one. Absent: no SSO.
+     */
+    onSsoSignIn?: () => Promise<{
+        accessToken: string;
+        user: SsoUser;
+    } | null>;
+    /** Signed in, with the person's first name. */
+    onSignedIn?: (name: string) => void;
+    /** The product name in the copy ("Sign in with …", "your … master password"). */
+    appName?: string;
+    /** The SSO provider's name on its buttons. Default: the product name. */
+    ssoName?: string;
+}
+export declare function CompactLogin({ onSsoSignIn, onSignedIn, appName, ssoName, }: CompactLoginOptions): ReactElement;

package/dist/connection/auth/ConnectedLoginPage.d.ts

@@ -6,4 +6,12 @@
  * configuration's `auth` (and `sso`), see `./support`.
  */
 import { type ReactElement } from 'react';
-export declare function ConnectedLoginPage(): ReactElement;
+import { type CompactLoginOptions } from './CompactLogin';
+export interface ConnectedLoginPageProps extends CompactLoginOptions {
+    /**
+     * `page` (default): the full sign-in and registration page. `compact`: the sign-in of an embedded
+     * host's narrow pane (email and password, or SSO in a popup, `onSsoSignIn`).
+     */
+    layout?: 'page' | 'compact';
+}
+export declare function ConnectedLoginPage({ layout, ...compact }?: ConnectedLoginPageProps): ReactElement;

package/dist/connection/auth/index.d.ts

@@ -1,4 +1,6 @@
-export { ConnectedLoginPage } from './ConnectedLoginPage';
+export { ConnectedLoginPage, type ConnectedLoginPageProps } from './ConnectedLoginPage';
+export { type CompactLoginOptions } from './CompactLogin';
+export { openSsoPopup } from './sso-popup';
 export { ConnectedSsoCallback } from './ConnectedSsoCallback';
 export { SsoResendVerificationButton } from './SsoResendVerificationButton';
 export { resolveSsoName, type NameSource, type ResolvedName } from './sso-name';

package/dist/connection/auth/sso-popup.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SSO in a popup, for hosts that cannot leave their page (an Office task pane, an extension): open
+ * the provider's sign-in, and wait for the callback page in the popup to post the provider's token
+ * and user back (`window.opener.postMessage({ accessToken, user }, origin)`). Resolves `null` when
+ * the popup is closed first; rejects with the provider's error.
+ */
+import type { SsoUser } from './support';
+export declare function openSsoPopup(url: string, { features }?: {
+    features?: string;
+}): Promise<{
+    accessToken: string;
+    user: SsoUser;
+} | null>;

package/dist/connection/auth/sso-sign-in.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Finishing a sign-in through SSO, once the provider has signed the person in: what their account
+ * is for the provider's email (`arbi.sso.status`), then, with the master password, register a new
+ * account (and back it up), link a local one, or sign in. One implementation for the full-page
+ * callback (`ConnectedSsoCallback`) and the compact sign-in of embedded hosts.
+ */
+import type { components, LoginResult } from '@arbidocs/client';
+import type { useArbi } from '@arbidocs/react';
+import type { SsoUser } from './support';
+export type SsoAccountStatus = components['schemas']['SSOStatusResponse'];
+type Arbi = ReturnType<typeof useArbi>;
+/** What the provider's account is on this deployment (`new_user`, `sso_exists`, `local_exists`). */
+export declare function ssoAccountStatus(arbi: Arbi, token: string, user: SsoUser): Promise<{
+    status: string;
+    email: string;
+    given_name?: string | null;
+    family_name?: string | null;
+}>;
+export interface CompleteSsoSignIn {
+    token: string;
+    user: SsoUser;
+    status: SsoAccountStatus;
+    /** The master password: a new one for `new_user`, the account's otherwise. */
+    password: string;
+    /** A new account: download its recovery key (default on). */
+    saveRecoveryKey?: boolean;
+}
+/**
+ * Sign in with the master password by account status. A new account is registered (the SSO token
+ * stands in for the verification code), backed up, and signed in with the provider's name and
+ * picture; `registered` says so. A local account is linked to SSO (`linked`).
+ */
+export declare function completeSsoSignIn(arbi: Arbi, { token, user, status, password, saveRecoveryKey }: CompleteSsoSignIn): Promise<{
+    login: LoginResult | undefined;
+    registered: boolean;
+    linked: boolean;
+}>;
+export {};

package/dist/connection/auth/support.d.ts

@@ -35,6 +35,23 @@ export interface AuthPagesSupport {
     passwordRules?: PasswordRules;
     /** Only SSO: the page hands straight over to the provider. */
     ssoOnly?: boolean;
+    /**
+     * Visitors can create an account here. Default: on. Off (a staff-only site whose accounts are
+     * made for people): the page signs in only, with no Register tab.
+     */
+    allowRegistration?: boolean;
+    /** The sign-in heading and the line under it. Default: "Welcome back". */
+    heading?: {
+        title: string;
+        description?: ReactNode;
+    };
+    /** The email field's label on sign-in. Default: "Email". */
+    emailLabel?: string;
+    /**
+     * Sign in from `#email=…&password=…[&next=…]` (mock and demo deployments only; see
+     * `useFragmentCredentials`). A `next` path goes to `onReturnPath`. Default: off.
+     */
+    fragmentSignIn?: boolean;
     /** The visitor started to sign in: warm what the signed-in app needs. */
     onIntent?: () => void;
     /** An invitation link carries where to go once signed in. */

package/dist/connection/auth/useLoginActions.d.ts

@@ -5,16 +5,23 @@
  * session in, and the site's sign-in hooks run around it.
  */
 import type { LoginFormActions, LoginFormState } from './useLoginForm';
-export declare function useLoginActions({ formState, formActions, }: {
+export declare function useLoginActions({ formState, formActions, onError, }: {
     formState: LoginFormState;
     formActions: LoginFormActions;
+    /** Show a refusal in the form itself. Default: a notice. */
+    onError?: (message: string) => void;
 }): {
     isAuthenticating: boolean;
     isRequestingCode: boolean;
     handleSsoLogin: (connection?: string) => void;
     handleLocalLogin: (opts?: {
         isFreshRegistration?: boolean;
-    }) => Promise<void>;
+        /** Sign in with these, not the form's (a sign-in link's). */
+        credentials?: {
+            email: string;
+            password: string;
+        };
+    }) => Promise<import("@arbidocs/client").LoginResult | undefined>;
     handleRegister: (saveRecoveryKey?: boolean) => Promise<void>;
     handleRequestVerificationCode: () => Promise<void>;
 };

package/dist/connection/billing/ConnectedQuotaDialog.d.ts

@@ -1,7 +1,8 @@
 /**
  * The dialog shown when a project's AI usage for the month is used up (a 402 `QUOTA_EXCEEDED`: an
  * API call, a chat send, a document's processing). The host decides when (`info`), and what a Box
- * deployment's admin opens (`box`); billing opens through `environment.openProject`.
+ * deployment's admin opens the portal (`runtimeConfig.licenceUrl`); billing opens through
+ * `environment.openProject`.
  *
  * One sentence and the actions that get the user going again, by project (the add-on state is only
  * visible to the owner of a Pro project). The usage cap limits automatic top-ups only, so adding AI
@@ -11,8 +12,8 @@
  *   - Pro, cap reached → "Usage cap reached: no more automatic top-ups this month." / Add and "Raise cap".
  *   - Pro otherwise (the automatic top-up failed) → the billing error / Add.
  *   - Free (or not the owner) → "Upgrade", which opens the plan picker of the project.
- *   - Box deployment (`box`) → members: "Ask your Box admin to add more." (no purchase); Box admins:
- *     "Open the ARBI portal" (`box.portalUrl`), where the Box is administered. No Box billing here.
+ *   - Box deployment → members: "Ask your Box admin to add more." (no purchase); Box admins:
+ *     "Open the ARBI portal", where the Box is administered. No Box billing here.
  */
 /** What used up: the project's spend against its budget (£), and the server's message. */
 export interface QuotaExceededInfo {
@@ -21,18 +22,9 @@ export interface QuotaExceededInfo {
     projectExtId: string | null;
     message?: string;
 }
-/** A Box deployment: its AI usage is the firm's, administered in the ARBI portal. */
-export interface QuotaDialogBox {
-    /** The viewer administers the Box (else they ask their admin). */
-    isAdmin: boolean;
-    /** The Box's licence page in the portal. */
-    portalUrl: string;
-}
 export interface ConnectedQuotaDialogProps {
     /** Open with what was used up; `null`: closed. */
     info: QuotaExceededInfo | null;
     onClose: () => void;
-    /** On a Box deployment. Absent: a project's own billing. */
-    box?: QuotaDialogBox;
 }
-export declare function ConnectedQuotaDialog({ info, onClose: close, box }: ConnectedQuotaDialogProps): import("react").JSX.Element;
+export declare function ConnectedQuotaDialog({ info, onClose: close }: ConnectedQuotaDialogProps): import("react").JSX.Element;

package/dist/connection/billing/index.d.ts

@@ -20,6 +20,6 @@ export { REFERRAL_OFFER, useReferralReward } from './referral-reward';
 export { isProProject, planBadgeView, planName } from './plan-badge';
 export { aiUsageResetTimestamp, formatResetDate, getQuotaItems } from './quota-items';
 export { CAP_REACHED_MESSAGE, ZERO_BUDGET_MESSAGE, isAddonBudgetZero } from './addon-pricing';
-export { ConnectedQuotaDialog, type ConnectedQuotaDialogProps, type QuotaDialogBox, type QuotaExceededInfo, } from './ConnectedQuotaDialog';
+export { ConnectedQuotaDialog, type ConnectedQuotaDialogProps, type QuotaExceededInfo, } from './ConnectedQuotaDialog';
 export { ConnectedWelcomeDialog, type ConnectedWelcomeDialogProps } from './ConnectedWelcomeDialog';
 export { ProjectUsageContent, type ProjectUsageContentProps, type UsageBreakdownKey, } from './ProjectUsageContent';

package/dist/connection/connectors/ConnectedSharePointAdminConsentPage.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SharePoint org admin-consent page — PUBLIC (no sign-in). Requests go to the environment's API
+ * base URL (`runtimeConfig.apiBaseUrl`).
+ *
+ * The enterprise story: a user wants SharePoint sync, but their Microsoft
+ * tenant requires an IT admin to approve the app's Sites.Read.All scope. The
+ * admin almost never has (or wants) an ARBI account, so this page gives them a
+ * standalone place to grant the org-wide consent:
+ *
+ *  1. A user copies this page's link from the SharePoint connector row and
+ *     sends it to their admin.
+ *  2. The admin opens it, reviews what will be granted, and clicks Approve —
+ *     which redirects to Microsoft's admin-consent screen
+ *     (GET /v1/connectors/microsoft_sharepoint/admin-consent, public endpoint).
+ *  3. Microsoft sends them back here with ?result=granted|declined and this
+ *     page shows the outcome.
+ *
+ * After the grant, users in that tenant connect SharePoint themselves — this
+ * page only unlocks the org-level permission wall; it grants no data access by
+ * itself (per-user OAuth + sealed tokens still gate every mailbox/site).
+ */
+export interface ConnectedSharePointAdminConsentPageProps {
+    /** The outcome Microsoft sends back (`?result=granted|declined`). Default: the page's query. */
+    result?: string | null;
+}
+export declare function ConnectedSharePointAdminConsentPage({ result: givenResult, }?: ConnectedSharePointAdminConsentPageProps): import("react").JSX.Element;

package/dist/connection/connectors/index.d.ts

@@ -2,3 +2,4 @@ export { ConnectedAppsSettings, type ConnectedAppsSettingsProps } from './Connec
 export { ConnectedMailboxSyncDialog, type ConnectedMailboxSyncDialogProps, } from './ConnectedMailboxSyncDialog';
 export { ConnectedDriveSyncDialog, type ConnectedDriveSyncDialogProps, } from './ConnectedDriveSyncDialog';
 export { BACKFILL_OPTIONS, windowLabel } from './sync-labels';
+export { ConnectedSharePointAdminConsentPage, type ConnectedSharePointAdminConsentPageProps, } from './ConnectedSharePointAdminConsentPage';

package/dist/connection/projects/ConnectedProjectsPanel.d.ts

@@ -8,6 +8,7 @@
  * (`tabs`); without it the panel keeps them and opens its own projects' tabs.
  */
 import { type ReactNode } from 'react';
+import { type ProjectsListPageProps } from './ProjectsListPage';
 /** The base tab's id. */
 export declare const PROJECTS_BASE_TAB_ID = "projects";
 /** The panel's project tabs, kept by a host. */
@@ -21,6 +22,13 @@ export interface ProjectPanelTabs {
     onClose: (projectId: string) => void;
 }
 export interface ConnectedProjectsPanelProps {
+    /**
+     * `panel` (default): the Plan & Usage panel with a tab per open project. `page`: the projects
+     * list as a page (`page` options), a row opening the project through `environment.openProject`.
+     */
+    layout?: 'panel' | 'page';
+    /** The list page's words, columns and header actions (`layout="page"`). */
+    page?: ProjectsListPageProps;
     /** Host-kept tabs; the panel keeps its own without. */
     tabs?: ProjectPanelTabs;
     /** A project's storage section, at the foot of its detail. */
@@ -31,4 +39,4 @@ export interface ConnectedProjectsPanelProps {
     headerRight?: ReactNode;
     className?: string;
 }
-export declare function ConnectedProjectsPanel({ tabs: hostTabs, projectStorage, footer, headerRight, className, }: ConnectedProjectsPanelProps): import("react").JSX.Element;
+export declare function ConnectedProjectsPanel({ layout, page, ...panel }: ConnectedProjectsPanelProps): import("react").JSX.Element;

package/dist/connection/projects/ProjectsListPage.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The projects list as a page (`ConnectedProjectsPanel layout="page"`): every project with its
+ * client, stage, documents, threads, people and storage (`useProjectSummaries`), searchable by
+ * project or workspace name; a row opens the project (`environment.openProject`). A site names
+ * things its own way (`labels`) and picks the columns (`columns`).
+ */
+import { type ReactNode } from 'react';
+/** The list's columns, in order. */
+export type ProjectListColumn = 'name' | 'client' | 'stage' | 'documents' | 'conversations' | 'members' | 'storage';
+export declare const DEFAULT_PROJECT_LIST_COLUMNS: readonly ProjectListColumn[];
+export interface ProjectsListLabels {
+    eyebrow?: ReactNode;
+    title: string;
+    description?: ReactNode;
+    searchPlaceholder: string;
+    /** Column headers. */
+    columns: Record<ProjectListColumn, string>;
+    /** "opened 3 Oct 2026" under a project's name. */
+    opened: string;
+    loadingTitle: string;
+    loadingDescription?: string;
+    emptyTitle: string;
+    emptyDescription?: string;
+}
+export declare const DEFAULT_PROJECTS_LIST_LABELS: ProjectsListLabels;
+export interface ProjectsListPageProps {
+    /** The site's words; each field falls back to the default. */
+    labels?: Partial<Omit<ProjectsListLabels, 'columns'>> & {
+        columns?: Partial<Record<ProjectListColumn, string>>;
+    };
+    /** The columns shown, in order. Default: all. */
+    columns?: readonly ProjectListColumn[];
+    /** The header's actions (a "new project" button). */
+    actions?: ReactNode;
+    /** The page's test-id prefix. Default: `projects`. */
+    testId?: string;
+}
+/** One decimal GB, or MB when tiny; "—" with nothing stored. */
+export declare function formatStorageGb(gb: number): string;
+export declare function ProjectsListPage({ labels: given, columns: shown, actions, testId, }: ProjectsListPageProps): import("react").JSX.Element;

package/dist/connection/projects/index.d.ts

@@ -1,2 +1,3 @@
 export { ConnectedProjectsPanel, PROJECTS_BASE_TAB_ID, type ConnectedProjectsPanelProps, type ProjectPanelTabs, } from './ConnectedProjectsPanel';
 export { buildProjectSummaries, primaryProjectWorkspace, useProjectSummaries, useProjectSummary, type ProjectMemberSummary, type ProjectSummary, type ProjectWorkspaceSummary, } from './useProjectSummaries';
+export { DEFAULT_PROJECT_LIST_COLUMNS, DEFAULT_PROJECTS_LIST_LABELS, formatStorageGb, type ProjectListColumn, type ProjectsListLabels, type ProjectsListPageProps, } from './ProjectsListPage';

package/dist/connection/settings-page/ConnectedAccountSettings.d.ts

@@ -1,6 +1,7 @@
 /**
  * The Account section of a settings page, bound to the signed-in account: profile and ID check,
- * security, the session card (server connection, active sessions, sign out) and the danger zone.
+ * a Box admin's portal link, security, the session card (server connection, active sessions, sign
+ * out) and the danger zone.
  * What only the host knows is a prop: the recovery-key download, its admin links, its socket and
  * its billing page.
  */

package/dist/connection/settings-page/ConnectedBoxPortalSection.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Account settings, Box admins only: one row linking to the Box's page in the ARBI portal
+ * (`runtimeConfig.licenceUrl`), where the Box is administered (users, storage, AI usage, budget,
+ * billing). Nothing for anyone else, or where the host gives no portal.
+ */
+export declare function ConnectedBoxPortalSection(): import("react").JSX.Element | null;

package/dist/connection/settings-page/appearanceSection.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Appearance, as a settings section a site adds as data (`ConnectedSettingsPage sections`).
+ *
+ * Two parts, each shown when the site supplies its store:
+ * - `appearance`: the reader's colour scheme, text size and typeface on this device
+ *   ({@link createAppearanceStore});
+ * - `theme`: the site's brand tokens, edited live ({@link createThemeStore} + `ThemeEditor`).
+ */
+import type { ReactNode } from 'react';
+import type { SettingsPageSection } from '../../settings/SettingsPage';
+import type { AppearanceBundle } from '../../theme/appearance';
+import type { ThemeBundle } from '../../theme/store';
+import { type ThemeEditorProps } from '../../theme/ThemeEditor';
+export interface AppearanceSettingsSectionOptions {
+    /** The reader's appearance store: shows colour scheme, text size and typeface. */
+    appearance?: AppearanceBundle;
+    /** The site's theme bundle: shows the token editor. */
+    theme?: ThemeBundle;
+    /** The theme editor's live preview card. */
+    themePreview?: ThemeEditorProps['preview'];
+    /** The theme editor's heading icon (a site's accent). Default: a palette. */
+    icon?: ReactNode;
+    /** The theme editor's description. */
+    description?: string;
+}
+/**
+ * Appearance. The tab shows a palette when the section edits the theme's colours, a type glyph
+ * when it only sets the reader's own scheme, size and typeface.
+ */
+export declare function appearanceSettingsSection(options: AppearanceSettingsSectionOptions): SettingsPageSection;

package/dist/connection/settings-page/index.d.ts

@@ -5,3 +5,4 @@ export { ConnectedPrivacySettings, type ConnectedPrivacySettingsProps, } from '.
 export { ConnectedPremiumModels } from './ConnectedPremiumModels';
 export { SessionStatusIcon, renderSessionStatusIcon } from './SessionStatusIcon';
 export { usageSettingsSection, connectionSettingsSection, organisationSettingsSection, type UsageSettingsSectionOptions, type ConnectionSettingsSectionOptions, type OrganisationSettingsSectionOptions, } from './sections';
+export { appearanceSettingsSection, type AppearanceSettingsSectionOptions, } from './appearanceSection';