@arbidocs/blocks 0.5.106 → 0.5.107

package/dist/connect/viewer.cjs

@@ -1,13 +1,13 @@
 "use client";
 'use strict';
 
-var chunkS7NJVJJX_cjs = require('../chunk-S7NJVJJX.cjs');
-require('../chunk-JXKNPKU6.cjs');
-var chunkRNX5LAQK_cjs = require('../chunk-RNX5LAQK.cjs');
+var chunkAHMRYY7J_cjs = require('../chunk-AHMRYY7J.cjs');
+require('../chunk-4CIVQWAX.cjs');
+var chunkC42WBPH4_cjs = require('../chunk-C42WBPH4.cjs');
 require('../chunk-6NSKIS35.cjs');
 require('../chunk-6KQVTMRL.cjs');
 require('../chunk-IWLNDDPN.cjs');
-require('../chunk-LM5CPXJO.cjs');
+require('../chunk-CRLFLMTK.cjs');
 require('../chunk-OKUXM2N4.cjs');
 require('../chunk-223D4727.cjs');
 require('../chunk-SNUBQMIS.cjs');
@@ -17,14 +17,14 @@ require('../chunk-JH6JTI76.cjs');
 require('../chunk-QQMMCXBP.cjs');
 require('../chunk-DTMBAFIL.cjs');
 require('../chunk-ZESMRGDV.cjs');
-require('../chunk-O4X7HXLF.cjs');
+require('../chunk-VCEX7COE.cjs');
 require('../chunk-34HQO4ZQ.cjs');
-require('../chunk-KGUBKE3V.cjs');
+require('../chunk-PL7O3RJJ.cjs');
 require('../chunk-MZZ3SBQL.cjs');
 require('../chunk-HKGO2GUG.cjs');
 require('../chunk-7LIPW6ZK.cjs');
 require('../chunk-ZPPMAL5P.cjs');
-require('../chunk-C4TGESIB.cjs');
+require('../chunk-ORELHENJ.cjs');
 require('../chunk-NWNVWO6L.cjs');
 require('../chunk-SK6HQ46Q.cjs');
 require('../chunk-MNIQDXM6.cjs');
@@ -46,9 +46,9 @@ require('../chunk-U2FFG2B3.cjs');
 require('../chunk-KKYNTWDU.cjs');
 require('../chunk-M74FWYNL.cjs');
 require('../chunk-VZOOGA47.cjs');
-require('../chunk-D3GZWKHW.cjs');
-require('../chunk-TJQMC7GJ.cjs');
-require('../chunk-LUO46ELJ.cjs');
+require('../chunk-EKSHUNJI.cjs');
+require('../chunk-NNBL3HPG.cjs');
+require('../chunk-3YZKDCWY.cjs');
 require('../chunk-SJSGSHIT.cjs');
 require('../chunk-ZW6FPIFC.cjs');
 require('../chunk-CT3SLXB7.cjs');
@@ -74,11 +74,11 @@ require('../chunk-DES3K4SD.cjs');
 
 Object.defineProperty(exports, "ConnectedDocumentViewer", {
   enumerable: true,
-  get: function () { return chunkS7NJVJJX_cjs.ConnectedDocumentViewer; }
+  get: function () { return chunkAHMRYY7J_cjs.ConnectedDocumentViewer; }
 });
 Object.defineProperty(exports, "ConnectedDocumentToolsProvider", {
   enumerable: true,
-  get: function () { return chunkRNX5LAQK_cjs.ConnectedDocumentToolsProvider; }
+  get: function () { return chunkC42WBPH4_cjs.ConnectedDocumentToolsProvider; }
 });
 //# sourceMappingURL=viewer.cjs.map
 //# sourceMappingURL=viewer.cjs.map

package/dist/connect/viewer.js

@@ -1,11 +1,11 @@
 "use client";
-export { ConnectedDocumentViewer } from '../chunk-ET3W24JV.js';
-import '../chunk-QTSNHGSI.js';
-export { ConnectedDocumentToolsProvider } from '../chunk-KYLQRS3O.js';
+export { ConnectedDocumentViewer } from '../chunk-TNKPQ3EF.js';
+import '../chunk-WFM6E7DD.js';
+export { ConnectedDocumentToolsProvider } from '../chunk-IHOV6OTA.js';
 import '../chunk-E6ISR55S.js';
 import '../chunk-3PV25ICC.js';
 import '../chunk-GOJ5GHFS.js';
-import '../chunk-632JXVXY.js';
+import '../chunk-KIXFXCHL.js';
 import '../chunk-JWUCDK2F.js';
 import '../chunk-RC6VTY2H.js';
 import '../chunk-OHRWYRTH.js';
@@ -15,14 +15,14 @@ import '../chunk-2YOVK524.js';
 import '../chunk-PBQNZWSX.js';
 import '../chunk-UIHNCQAA.js';
 import '../chunk-IA5BYEO7.js';
-import '../chunk-Q5U6Y2NO.js';
+import '../chunk-E2P4JJLJ.js';
 import '../chunk-IRPDQJNT.js';
-import '../chunk-OG3TI5GX.js';
+import '../chunk-6M5NAAWX.js';
 import '../chunk-3EWS6ECM.js';
 import '../chunk-2UP73FZT.js';
 import '../chunk-JS66ZT33.js';
 import '../chunk-3SBEWWKT.js';
-import '../chunk-MHFWGIF4.js';
+import '../chunk-NFK2SEUD.js';
 import '../chunk-NHZK64TQ.js';
 import '../chunk-ELA7Y5YW.js';
 import '../chunk-3IT5LPLF.js';
@@ -44,9 +44,9 @@ import '../chunk-Z42EEBON.js';
 import '../chunk-GIVU67LY.js';
 import '../chunk-I6F6RBKV.js';
 import '../chunk-WNDIVNPT.js';
-import '../chunk-LWEX3AOZ.js';
-import '../chunk-NUOMPVKQ.js';
-import '../chunk-BH4MK2J5.js';
+import '../chunk-TG4IICWO.js';
+import '../chunk-OWHO2TO3.js';
+import '../chunk-QG6MRLZG.js';
 import '../chunk-USTSEENR.js';
 import '../chunk-P6GHJSLR.js';
 import '../chunk-OEXUYGKJ.js';

package/dist/connection/account-cluster/ConnectedAccountCluster.d.ts

@@ -36,7 +36,7 @@ export interface ConnectedAccountClusterProps {
     /** The Contacts row (default true, while the host has `openContacts`). */
     showContacts?: boolean;
     showNotifications?: boolean;
-    /** A live status pill (`bar` only), e.g. remote control. */
+    /** A live status pill (`bar` only). Default: remote control's, while it is on. */
     status?: ReactNode;
     /** The report-a-problem row. */
     report?: ReactNode;

package/dist/connection/dashboards/ConnectedDashboardsPage.d.ts

@@ -13,6 +13,8 @@ export interface DashboardsPageLabels {
     panels: (count: number) => string;
     back: string;
     edit: string;
+    /** The "…" menu of an open dashboard (its rarer actions: delete). */
+    more: string;
     delete: string;
     confirmDelete: (title: string) => string;
     save: string;
@@ -33,7 +35,11 @@ export interface DashboardsPageLabels {
 }
 export declare const DEFAULT_DASHBOARDS_PAGE_LABELS: DashboardsPageLabels;
 export interface ConnectedDashboardsPageProps {
-    /** Starting points for a new dashboard. Default: an overview of the built-in sources. */
+    /**
+     * Starting points for a new dashboard. Default: an overview and one per area (documents, tags and
+     * facts, workflows, AI usage, recent activity) over the built-in sources; Workflows only while
+     * the host's `workflows` feature is on.
+     */
     templates?: readonly DashboardSpec[];
     /** The open dashboard (controlled, for a route): `null` is the list. */
     dashboardId?: string | null;
@@ -41,6 +47,11 @@ export interface ConnectedDashboardsPageProps {
     labels?: Partial<DashboardsPageLabels>;
     panelLabels?: Partial<DashboardPanelLabels>;
     editorLabels?: Partial<PanelEditorLabels>;
+    /**
+     * Classes on the page's scrolling frame, merged over its padding (`p-4 sm:p-6`): a host whose
+     * own frame pads its pages passes `p-0`.
+     */
+    className?: string;
     testId?: string;
 }
-export declare function ConnectedDashboardsPage({ templates, dashboardId, onDashboardChange, labels, panelLabels, editorLabels, testId, }: ConnectedDashboardsPageProps): import("react").JSX.Element;
+export declare function ConnectedDashboardsPage({ templates: siteTemplates, dashboardId, onDashboardChange, labels, panelLabels, editorLabels, className, testId, }: ConnectedDashboardsPageProps): import("react").JSX.Element;

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

@@ -1,4 +1,4 @@
 export { ConnectedDashboardsPage, DEFAULT_DASHBOARDS_PAGE_LABELS, type ConnectedDashboardsPageProps, type DashboardsPageLabels, } from './ConnectedDashboardsPage';
 export { DashboardPanel, DEFAULT_DASHBOARD_PANEL_LABELS, PANEL_FORMATTERS, type DashboardPanelLabels, type DashboardPanelProps, } from './DashboardPanel';
 export { DEFAULT_PANEL_EDITOR_LABELS, PanelEditor, type PanelEditorLabels, type PanelEditorProps, } from './PanelEditor';
-export { OVERVIEW_DASHBOARD, newPanel, newPanelId } from './templates';
+export { DASHBOARD_TEMPLATES, OVERVIEW_DASHBOARD, newPanel, newPanelId } from './templates';

package/dist/connection/dashboards/templates.d.ts

@@ -1,10 +1,21 @@
 /**
- * The starting point a new dashboard is offered by default: one panel of each kind over the
- * built-in sources. A site passes its own (`ConnectedDashboardsPage templates`), in its words.
+ * The starting points a new dashboard is offered by default (`DASHBOARD_TEMPLATES`): an overview,
+ * then one dashboard per area (documents, tags and facts, workflows, AI usage, recent activity),
+ * over the built-in sources and their default words. A site passes its own
+ * (`ConnectedDashboardsPage templates`), in its words.
  */
-import type { DashboardSpec, PanelSpec } from '@arbidocs/react';
+import { type DashboardSpec, type PanelSpec } from '@arbidocs/react';
 /** A fresh panel id. */
 export declare function newPanelId(): string;
 /** A new panel: a bar chart of the documents by type, ready to be changed. */
 export declare function newPanel(): PanelSpec;
 export declare const OVERVIEW_DASHBOARD: DashboardSpec;
+/**
+ * The templates a host's features allow: one with a panel over the workflows source only while
+ * the `workflows` feature is on.
+ */
+export declare function templatesFor(templates: readonly DashboardSpec[], features: {
+    workflows: boolean;
+}): readonly DashboardSpec[];
+/** The default templates under "New dashboard", in order (`templatesFor` narrows them). */
+export declare const DASHBOARD_TEMPLATES: readonly DashboardSpec[];

package/dist/connection/remote-control/ConnectedRemoteControlConsent.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ConnectedRemoteControlConsent — the consent gate for backend-driven remote control.
+ *
+ * Opens whenever an `agt-…` agent has requested to drive the UI over the websocket and remote
+ * control is not already enabled this session (the request sits in the session's remote-control
+ * `pending`). It names the requesting agent explicitly (GUARANTEE #3) so the user knows which of
+ * their assistants is asking, and offers three choices:
+ *  - Allow for this session (primary) — enables it until the session ends.
+ *  - Just this once — runs the one requested action, stays off afterwards.
+ *  - Deny (cancel) — runs nothing.
+ * It says what will run (the run's name, or the inline steps' notes and targets), and opens on
+ * "Just this once", so Enter never grants the whole session. Nothing shows while the site has not
+ * turned remote control on (`guided.remoteControl`).
+ *
+ * Mounted once by `ConnectedAppRuntime`. Its state lives in the session, so no props.
+ */
+export declare function ConnectedRemoteControlConsent(): React.ReactElement | null;

package/dist/connection/remote-control/ConnectedRemoteControlIndicator.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ConnectedRemoteControlIndicator: the persistent remote-control pill (`RemoteControlPill`) on the
+ * session's state. Shown while remote control is enabled this session (or a run is executing);
+ * labels WHO is driving while a websocket-driven run executes, and always offers an immediate
+ * disable (GUARANTEE #5). Hidden entirely when remote control is off and no run is active, and
+ * while the site has not turned remote control on (`guided.remoteControl`).
+ */
+export declare function ConnectedRemoteControlIndicator(): React.ReactElement | null;

package/dist/connection/remote-control/ConnectedRemoteControlSwitch.d.ts

@@ -0,0 +1 @@
+export declare function ConnectedRemoteControlSwitch(): import("react").JSX.Element | null;

package/dist/connection/remote-control/index.d.ts

@@ -0,0 +1,4 @@
+export { createRemoteControl, useRemoteControlActions, useRemoteControlHandlers, type RemoteControl, } from './remoteControl';
+export { ConnectedRemoteControlConsent } from './ConnectedRemoteControlConsent';
+export { ConnectedRemoteControlIndicator } from './ConnectedRemoteControlIndicator';
+export { ConnectedRemoteControlSwitch } from './ConnectedRemoteControlSwitch';

package/dist/connection/remote-control/remoteControl.d.ts

@@ -0,0 +1,40 @@
+import { type ArbiWsHandlers, type RemoteControlMessage, type RemoteControlSession } from '@arbidocs/react';
+import type { GuidedRuns } from '../../guided/sequences';
+export interface RemoteControl {
+    /** The websocket entry point, for a `remote_control` message. Gated (see the file header). */
+    handleMessage(msg: RemoteControlMessage): void;
+    /**
+     * Grant the pending consent and run it. `forSession: true` keeps remote control enabled so
+     * later websocket runs go without re-prompting; `false` runs the one pending run and leaves it
+     * disabled ("just this once").
+     */
+    grantAndRun(opts: {
+        forSession: boolean;
+    }): void;
+    /** Deny the pending consent — clears it and runs nothing. */
+    deny(): void;
+    /**
+     * Turn remote control OFF and revoke immediately (GUARANTEE #5): clears the enabled flag, the
+     * pending prompt and the pill, and cancels any in-flight run so the guided cursor stops at once.
+     */
+    disable(): void;
+    /** Turn remote control ON directly — the user's own explicit choice. Runs nothing by itself. */
+    enable(): void;
+}
+/** Remote control on a session's state, running the site's guided runs. */
+export declare function createRemoteControl(session: RemoteControlSession, guided: Pick<GuidedRuns, 'isSequenceId' | 'run' | 'remoteControl'>): RemoteControl;
+/** Remote control on the host's session and guided runs. */
+export declare function useRemoteControlActions(): RemoteControl;
+/**
+ * Drop remote control's grant, its pending request and the guided run in flight on every sign-in,
+ * sign-out and session expiry of the host's `Arbi`, and whenever the signed-in user changes (a
+ * host that signs in its own way), so nothing carries over to the next person in the tab.
+ */
+export declare function useRemoteControlSessionReset(): void;
+/**
+ * The live connection's handler for remote control (`ArbiWebSocketProvider` `handlers`): an
+ * `agt-…` agent asking to drive the UI goes to the consent-gated entry point. None while the
+ * site has not turned remote control on (`guided.remoteControl`). It also drops the grant and
+ * the run in flight at every sign-in and sign-out (`useRemoteControlSessionReset`).
+ */
+export declare function useRemoteControlHandlers(): ArbiWsHandlers;

package/dist/connection/routes/useDeepLinkSync.d.ts

@@ -20,7 +20,10 @@ export interface DeepLinkSyncOptions {
     }) => void;
     /** The layout panel that shows the viewed document. */
     viewerPanel: string;
-    /** Run a UI action link (`/action/<name>`); the address then returns to the start. */
+    /**
+     * Run a UI action link (`/action/<name>`); the address then returns to the start. Default: the
+     * kit's links (`authorize-agent`: the invite dialog, on its agent tab).
+     */
     onAction?: (action: string) => void;
     /**
      * A workspace a link names could not be opened: true when the host has explained why (an access

package/dist/connection/runtime/ConnectedAppRuntime.d.ts

@@ -1,5 +1,5 @@
 import { type RuntimeMeasure } from './useSessionBootstrap';
-export type AppRuntimeEffect = 'liveUpdates' | 'releaseStaleModals' | 'retiredModelNotice' | 'pausedMutationNotice' | 'paymentReturn' | 'userNameFromWorkspaces' | 'firstLoginRouting' | 'welcomeDialog' | 'pendingWorkspaceShare' | 'pendingNotification' | 'pendingAccessReview' | 'addonNotice' | 'connectorAutoSync' | 'pageTransition' | 'freshChatModel' | 'workspaceOpenMetrics' | 'prefetch';
+export type AppRuntimeEffect = 'liveUpdates' | 'releaseStaleModals' | 'retiredModelNotice' | 'pausedMutationNotice' | 'paymentReturn' | 'userNameFromWorkspaces' | 'firstLoginRouting' | 'welcomeDialog' | 'pendingWorkspaceShare' | 'pendingNotification' | 'pendingAccessReview' | 'addonNotice' | 'connectorAutoSync' | 'pageTransition' | 'freshChatModel' | 'workspaceOpenMetrics' | 'prefetch' | 'guidedRuns';
 export interface ConnectedAppRuntimeProps {
     /** Effects to turn off (`{ paymentReturn: false }`). Default: every effect on. */
     effects?: Partial<Record<AppRuntimeEffect, boolean>>;

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

@@ -15,7 +15,7 @@ export declare const JUST_CONNECTED_VIEW = "settings.justConnected";
 export interface SettingsSectionsOptions {
     /** The reader's appearance store (typeface, colour scheme, text size). */
     appearance: AppearanceBundle;
-    /** The host's own privacy rows, after the kit's (a remote-control switch, say). */
+    /** The host's own privacy rows, after the kit's remote-control switch. */
     privacyRows?: ReactNode;
     /** Where a mailbox's OAuth consent returns to. */
     mailOAuthReturnPath?: string;

package/dist/connection/tags/ConnectedTagTable.d.ts

@@ -80,7 +80,7 @@ export declare function useTagValueOptions(): {
     tagOptions: {
         value: string;
         label: string;
-        kind: "label" | "search" | "person" | "annotation" | "organisation" | "issue";
+        kind: "label" | "search" | "person" | "annotation" | "issue" | "organisation";
     }[];
 };
 export interface ConnectedTagTableProps extends Pick<TagTableProps, 'onOpenDocument' | 'onOpenFact' | 'onOpenThread' | 'onOpenRow' | 'onOpenTaggedItems' | 'onOpenTag' | 'actions' | 'secondaryActions' | 'labels' | 'className' | 'testId'> {