@arbidocs/blocks 0.5.21 → 0.5.23

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

@@ -14,6 +14,11 @@ export declare function useLoginActions({ formState, formActions, }: {
     handleSsoLogin: (connection?: string) => void;
     handleLocalLogin: (opts?: {
         isFreshRegistration?: boolean;
+        /** Sign in with these, not the form's (a sign-in link's). */
+        credentials?: {
+            email: string;
+            password: string;
+        };
     }) => Promise<void>;
     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/ProjectUsageContent.d.ts

@@ -2,17 +2,20 @@
  * ProjectUsageContent — inline AI usage breakdown for a project.
  *
  * SVG line chart with composite color-coded lines.
- * Toggle between breakdowns: User (default), Workspace, Model Tier.
+ * Toggle between breakdowns: User (default), Workspace, Model Tier, and (opt in) Feature.
  * Resolves usr-xxx / wrk-xxx IDs to real names via workspace data.
  * Data from LiteLLM via /v1/user/projects/{id}/usage.
  *
  * Rendered inline in the project card expander (no dialog).
  */
-interface ProjectUsageContentProps {
+/** What the breakdown groups AI usage by. */
+export type UsageBreakdownKey = 'user' | 'workspace' | 'model' | 'feature';
+export interface ProjectUsageContentProps {
     projectExtId: string;
     projectName: string;
     /** Monthly AI usage quota in £ (quotas.ai_usage.limit) — enables the % indicator */
     aiUsageLimit?: number;
+    /** The breakdowns offered, the first selected. Default: user, workspace, model tier. */
+    breakdowns?: readonly UsageBreakdownKey[];
 }
-export declare function ProjectUsageContent({ projectExtId, projectName, aiUsageLimit, }: ProjectUsageContentProps): import("react").JSX.Element;
-export {};
+export declare function ProjectUsageContent({ projectExtId, projectName, aiUsageLimit, breakdowns, }: ProjectUsageContentProps): import("react").JSX.Element;

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

@@ -20,5 +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/defaultHost.d.ts

@@ -6,4 +6,4 @@ export interface DefaultHostOptions {
     queryClient?: QueryClient;
 }
 /** `arbi` and the sign-in layer (`connection`) for `<ArbiHost config>`. Call it once per site. */
-export declare function defaultHost(config: ArbiConnectionConfig, { queryClient }?: DefaultHostOptions): Pick<ArbiHostConfig, 'arbi' | 'connection'>;
+export declare function defaultHost(config: ArbiConnectionConfig, { queryClient }?: DefaultHostOptions): Pick<ArbiHostConfig, 'arbi' | 'connection' | 'documents'>;

package/dist/connection/entities/ConnectedProjectEntity.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A project, connected: the shared project pill (`ProjectEntity` in `@arbidocs/react/ui`), marked
+ * paid when its subscription is active and this site sells plans (`billing.stripeEnabled`).
+ */
+import type { ComponentProps } from 'react';
+import { ProjectEntity } from '@arbidocs/react/ui';
+export type ConnectedProjectEntityProps = Omit<ComponentProps<typeof ProjectEntity>, 'isPaid'>;
+export declare function ConnectedProjectEntity({ subscription, ...props }: ConnectedProjectEntityProps): import("react").JSX.Element;

package/dist/connection/entities/ConnectedUserEntity.d.ts

@@ -0,0 +1,20 @@
+import type { components } from '@arbidocs/client';
+type UserResponse = components['schemas']['UserResponse'];
+export interface ConnectedUserEntityProps {
+    user?: UserResponse | null;
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    variant?: 'icon' | 'pill';
+    className?: string;
+    /** Hovering shows their card (default true). */
+    showTooltip?: boolean;
+    /** The presence dot (default true). */
+    showPresence?: boolean;
+    /** A click opens the chat with them, or your settings (default true). */
+    interactive?: boolean;
+    /** An unread mark on the chat icon. */
+    hasUnreadMessages?: boolean;
+    /** Your own label in place of "You" (e.g. "Ada Lovelace (me)" in a call). */
+    selfLabel?: string;
+}
+export declare const ConnectedUserEntity: import("react").NamedExoticComponent<ConnectedUserEntityProps>;
+export {};

package/dist/connection/entities/ConnectedWorkspaceEntity.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A workspace, connected: its shield (in its status colour: private, shared or common) and name,
+ * with a hover card of its type, counts, storage and last update. A click on the pill opens the
+ * workspace (`useConnectedWorkspace().openWorkspace`: selected first under the sign-in layer, then
+ * the host's `openWorkspace`).
+ */
+import { type ComponentProps, type JSX } from 'react';
+import { ShieldIcon } from '@arbidocs/react/ui';
+import type { components } from '@arbidocs/client';
+type Workspace = components['schemas']['WorkspaceResponse'];
+export interface ConnectedWorkspaceEntityProps extends Omit<ComponentProps<typeof ShieldIcon>, 'char' | 'workspaceColor'> {
+    workspace: Workspace;
+    size?: number;
+    isSelected?: boolean;
+    className?: string;
+    /** `icon`: the shield alone; `pill` (default): the shield and the name. */
+    variant?: 'icon' | 'pill';
+    /** The pill's size: `sm` (default) for compact rows, `base` for tab headers. */
+    pillSize?: 'sm' | 'base';
+    /** A click on the pill opens the workspace (default true). */
+    interactive?: boolean;
+    /** Hovering shows its card (default true). */
+    showTooltip?: boolean;
+    /**
+     * The label's max-width class. Default `max-w-[10ch]`, a compact badge in dense rows; a wider
+     * class for primary listings, or `max-w-full` to truncate against a narrow parent.
+     */
+    labelMaxWidth?: string;
+}
+export declare function ConnectedWorkspaceEntity({ workspace, size, isSelected, className, variant, pillSize, interactive, showTooltip, labelMaxWidth, ...shieldProps }: ConnectedWorkspaceEntityProps): JSX.Element;
+export {};

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

@@ -0,0 +1,5 @@
+/** People, workspaces and projects, connected to the session (presence, "You", open on click). */
+export { ConnectedUserEntity, type ConnectedUserEntityProps } from './ConnectedUserEntity';
+export { ConnectedWorkspaceEntity, type ConnectedWorkspaceEntityProps, } from './ConnectedWorkspaceEntity';
+export { ConnectedProjectEntity, type ConnectedProjectEntityProps } from './ConnectedProjectEntity';
+export { renderConnectedUser } from './renderConnectedUser';

package/dist/connection/entities/renderConnectedUser.d.ts

@@ -0,0 +1,6 @@
+import type { DocumentsSupport } from '@arbidocs/react';
+/**
+ * People in the document kits (a version's author, a comment, an activity entry) as connected
+ * entities: the host configuration's `documents.renderUser`.
+ */
+export declare const renderConnectedUser: NonNullable<DocumentsSupport['renderUser']>;

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/index.d.ts

@@ -4,3 +4,4 @@ export { ConnectedMailSettings, type ConnectedMailSettingsProps } from './Connec
 export { ConnectedPrivacySettings, type ConnectedPrivacySettingsProps, } from './ConnectedPrivacySettings';
 export { ConnectedPremiumModels } from './ConnectedPremiumModels';
 export { SessionStatusIcon, renderSessionStatusIcon } from './SessionStatusIcon';
+export { usageSettingsSection, connectionSettingsSection, organisationSettingsSection, type UsageSettingsSectionOptions, type ConnectionSettingsSectionOptions, type OrganisationSettingsSectionOptions, } from './sections';

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

@@ -0,0 +1,44 @@
+/**
+ * Settings sections a site adds as data (`ConnectedSettingsPage sections`): the signed-in user's AI
+ * usage today, the connection to the backend (a `defaultHost` site's sign-in layer), and the site's
+ * own organisation details from config. Each is a factory returning a `SettingsPageSection`; a
+ * site's words (its brand, "Firm", a regulator's number) come in through the options.
+ */
+import type { ReactNode } from 'react';
+import type { SettingsPageSection } from '../../settings/SettingsPage';
+export interface UsageSettingsSectionOptions {
+    /** The section's icon (a site's accent). Default: a gauge. */
+    icon?: ReactNode;
+}
+/** Usage: the signed-in user's AI usage today, in £ ex VAT. */
+export declare function usageSettingsSection({ icon, }?: UsageSettingsSectionOptions): SettingsPageSection;
+export interface ConnectionSettingsSectionOptions {
+    /** The tab's and the section's name. Default: "Connection". */
+    label?: string;
+    /** More rows under the connection's own (what the site states about its backend). */
+    rows?: ReactNode;
+    /** The section's icon (a site's accent). Default: a cloud. */
+    icon?: ReactNode;
+}
+/**
+ * Connection: whether the site is connected to its backend, the backend's URL, who is signed in
+ * and the selected workspace. For a site on `defaultHost`'s sign-in layer; empty without one.
+ */
+export declare function connectionSettingsSection({ label, rows, icon, }?: ConnectionSettingsSectionOptions): SettingsPageSection;
+export interface OrganisationSettingsSectionOptions {
+    /** The tab's name. Default: "Organisation". */
+    label?: string;
+    /** The section's heading. Default: the label. */
+    title?: string;
+    /** A line under the heading (a regulatory statement, say). */
+    description?: ReactNode;
+    /** The section's icon. Default: a building. */
+    icon?: ReactNode;
+    /** The details, in order: a label and its value. */
+    rows: {
+        label: string;
+        value: ReactNode;
+    }[];
+}
+/** The site's own organisation details, from its config (name, registration, address…). */
+export declare function organisationSettingsSection({ label, title, description, icon, rows, }: OrganisationSettingsSectionOptions): SettingsPageSection;

package/dist/facts/index.cjs

@@ -4,7 +4,7 @@
 var chunkYD3RN2FY_cjs = require('../chunk-YD3RN2FY.cjs');
 require('../chunk-2WLXQGWC.cjs');
 var chunk5FYU7ZIU_cjs = require('../chunk-5FYU7ZIU.cjs');
-var chunkAPVKLXM5_cjs = require('../chunk-APVKLXM5.cjs');
+var chunkYBTKLOGG_cjs = require('../chunk-YBTKLOGG.cjs');
 require('../chunk-VPPX5XUF.cjs');
 var chunkRC25WMVB_cjs = require('../chunk-RC25WMVB.cjs');
 require('../chunk-V4ISCZJ7.cjs');
@@ -15,7 +15,7 @@ require('../chunk-MEMWZ72Y.cjs');
 var chunkUFEXJIEY_cjs = require('../chunk-UFEXJIEY.cjs');
 require('../chunk-FX3K6LNZ.cjs');
 require('../chunk-PPCATBOY.cjs');
-require('../chunk-R2HXGTVB.cjs');
+require('../chunk-2QQUGL2V.cjs');
 require('../chunk-SI222Z3A.cjs');
 require('../chunk-ULWRNGGE.cjs');
 var chunkMHVNT4J3_cjs = require('../chunk-MHVNT4J3.cjs');
@@ -331,7 +331,7 @@ function FactSearchResult({
       }
     ),
     /* @__PURE__ */ jsxRuntime.jsx(
-      chunkAPVKLXM5_cjs.SearchHit,
+      chunkYBTKLOGG_cjs.SearchHit,
       {
         className: "min-w-0 flex-1",
         testId: chunkMHVNT4J3_cjs.testIdOr(testIds?.hit?.(id), { testId: `facts-smart-search-hit-${id}` }),

package/dist/facts/index.js

@@ -3,7 +3,7 @@ import { DEFAULT_FACT_COLUMN_LABELS, createFactColumns, FactRowActions } from '.
 export { DEFAULT_FACTS_BULK_BAR_LABELS, DEFAULT_FACTS_EMPTY_STATE_LABELS, DEFAULT_FACTS_FIELDS_BUTTON_LABELS, DEFAULT_FACTS_TOOLBAR_LABELS, DEFAULT_FACTS_VIEW_TOGGLE_LABELS, DEFAULT_FACT_COLUMN_LABELS, DEFAULT_FACT_COLUMN_ORDER, DEFAULT_FACT_COMPOSER_LABELS, DEFAULT_FACT_DATE_INPUT_LABELS, DEFAULT_FACT_LABELS_CELL_LABELS, DEFAULT_FACT_ROW_ACTIONS_LABELS, DEFAULT_FACT_SOURCES_ROW_LABELS, DEFAULT_FACT_SOURCE_GROUP_LABELS, DEFAULT_FACT_TIMELINE_LABELS, EMPTY_FACT_DATE_FIELDS, FactComposer, FactDateInput, FactFieldRow, FactLabelsCell, FactRowActions, FactSourceGroup, FactSourcesRow, FactsBulkBar, FactsCalendar, FactsEmptyState, FactsFieldsButton, FactsGanttPane, FactsLoadError, FactsLoading, FactsToolbar, FactsViewToggle, ISO_DATE_FILTER_PARAMS, buildFactCitations, chronologyFactBodies, chunkIdsOf, citedVersionRef, createFactColumns, docIdsOf, enableFactTableColumnResize, factDateFieldsToSpan, factDateSpanToFields, hasChunk, isWholeDoc, parseChronologyDate, sourceDocCount, toFactCitations, withChunk, withDoc, withoutChunk, withoutDoc } from '../chunk-75Z5AUMM.js';
 import '../chunk-JJA6GQKH.js';
 export { DEFAULT_FACT_PASSAGES_LABELS, FactPassageItem, FactSourcesPanel, renderPreviewInline, toPreviewLine } from '../chunk-HFZ45FD3.js';
-import { SearchHit } from '../chunk-WYUFBKQ4.js';
+import { SearchHit } from '../chunk-V5HVPQP7.js';
 import '../chunk-4EZVCGRL.js';
 export { decodeWhitespaceEntities } from '../chunk-AF6RDAJF.js';
 import '../chunk-NUNKSZKU.js';
@@ -14,7 +14,7 @@ import '../chunk-ABEKUV6L.js';
 import { initials } from '../chunk-5VYJP6XD.js';
 import '../chunk-SLSBJRWW.js';
 import '../chunk-NPLYHR2E.js';
-import '../chunk-BQQTLZBN.js';
+import '../chunk-GRT4EH76.js';
 import '../chunk-U4HWVCRN.js';
 import '../chunk-TX2ZICS7.js';
 import { testIdOr } from '../chunk-7F6CBP3Z.js';