@arbidocs/blocks 0.4.144 → 0.4.145

package/dist/provider/BlocksProvider.d.ts

@@ -43,7 +43,11 @@ export interface BlocksEnvironment {
     openConversation: (conversationId: string, options?: {
         messageId?: string;
     }) => void;
-    /** Open the user's settings, optionally at a section. Default: no-op. */
+    /**
+     * Open the user's settings, optionally at a section (a `ConnectedSettingsPage` section id).
+     * The section is always recorded for `ConnectedSettingsPage` first (`requestSettingsSection`);
+     * the host's handler then shows its settings. Default: only that record.
+     */
     openSettings: (section?: string) => void;
     /** Open a project. Default: no-op. */
     openProject: (projectId: string) => void;

package/dist/provider/settings-section.d.ts

@@ -0,0 +1,9 @@
+export interface SettingsSectionRequest {
+    section: string;
+    /** Increases with every request, so asking again for the same section is a new request. */
+    seq: number;
+}
+/** Ask for a settings section; no section asks for none (the page stays where it is). */
+export declare function requestSettingsSection(section?: string): void;
+/** The last settings-section request (`undefined` until there is one). */
+export declare function useRequestedSettingsSection(): SettingsSectionRequest | undefined;

package/dist/retrieval/index.cjs

@@ -2,9 +2,9 @@
 'use strict';
 
 var chunkQI6AIHWP_cjs = require('../chunk-QI6AIHWP.cjs');
-var chunkHFGXA5CL_cjs = require('../chunk-HFGXA5CL.cjs');
+var chunkUTTTJSQU_cjs = require('../chunk-UTTTJSQU.cjs');
 require('../chunk-MHVNT4J3.cjs');
-require('../chunk-C4WSHRR6.cjs');
+require('../chunk-KPZZ5FHE.cjs');
 require('../chunk-ULWRNGGE.cjs');
 require('../chunk-DES3K4SD.cjs');
 
@@ -152,11 +152,11 @@ Object.defineProperty(exports, "stripMarkdownLinks", {
 });
 Object.defineProperty(exports, "DEFAULT_SEARCH_HIT_LABELS", {
   enumerable: true,
-  get: function () { return chunkHFGXA5CL_cjs.DEFAULT_SEARCH_HIT_LABELS; }
+  get: function () { return chunkUTTTJSQU_cjs.DEFAULT_SEARCH_HIT_LABELS; }
 });
 Object.defineProperty(exports, "SearchHit", {
   enumerable: true,
-  get: function () { return chunkHFGXA5CL_cjs.SearchHit; }
+  get: function () { return chunkUTTTJSQU_cjs.SearchHit; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/retrieval/index.js

@@ -1,8 +1,8 @@
 "use client";
 export { ApplyLabelButton, ApplyLabelDialog, DEFAULT_APPLY_LABEL_DIALOG_LABELS, DEFAULT_RELEVANCE_STEPS, DEFAULT_SEARCH_BAR_LABELS, DEFAULT_SEARCH_EMPTY_STATE_LABELS, DEFAULT_SEARCH_GROUP_HEADER_LABELS, DEFAULT_SEARCH_NO_RESULTS_LABELS, DEFAULT_SEARCH_PAGINATION_LABELS, DEFAULT_SEARCH_TOTALS_LABELS, DOCUMENT_SEARCH_NOUNS, Highlight, RelevanceThreshold, SearchBar, SearchControlsBar, SearchEmptyState, SearchErrorBanner, SearchGroupCard, SearchGroupHeader, SearchNoResults, SearchPageBody, SearchPageFrame, SearchPageHeader, SearchPagination, SearchPillToggle, SearchResultList, SearchResultsInner, SearchResultsMain, SearchToolbarRow, SearchTotalsHeadline, getPageNumbers, highlightTerms, searchNouns, splitByTerms, stripMarkdownLinks } from '../chunk-2MJWWPHY.js';
-export { DEFAULT_SEARCH_HIT_LABELS, SearchHit } from '../chunk-RI6DZA5X.js';
+export { DEFAULT_SEARCH_HIT_LABELS, SearchHit } from '../chunk-EF4ZLKRM.js';
 import '../chunk-7F6CBP3Z.js';
-import '../chunk-YNIBUKV5.js';
+import '../chunk-TBEVGWY3.js';
 import '../chunk-TX2ZICS7.js';
 import '../chunk-VUNV25KB.js';
 //# sourceMappingURL=index.js.map

package/dist/settings/AppearanceSettings.d.ts

@@ -0,0 +1,18 @@
+export type AppearanceColorScheme = 'light' | 'dark';
+export type AppearanceTextSize = 'default' | 'large' | 'larger';
+/** The typefaces offered by default: a spread across `FONT_PAIRINGS`. */
+export declare const DEFAULT_APPEARANCE_PAIRING_IDS: readonly ["office", "inter", "fraunces-inter", "montserrat-nunito"];
+export interface AppearanceSettingsProps {
+    colorScheme: AppearanceColorScheme;
+    onColorSchemeChange: (scheme: AppearanceColorScheme) => void;
+    textSize: AppearanceTextSize;
+    onTextSizeChange: (size: AppearanceTextSize) => void;
+    /** The typeface (a `FONT_PAIRINGS` id). */
+    pairingId: string;
+    onPairingChange: (pairingId: string) => void;
+    /** Typefaces to offer; default {@link DEFAULT_APPEARANCE_PAIRING_IDS}. */
+    pairingIds?: readonly string[];
+    /** Shown while the choice differs from the defaults. */
+    onReset?: () => void;
+}
+export declare function AppearanceSettings({ colorScheme, onColorSchemeChange, textSize, onTextSizeChange, pairingId, onPairingChange, pairingIds, onReset, }: AppearanceSettingsProps): import("react").JSX.Element;

package/dist/settings/ServerConnectionControls.d.ts

@@ -29,3 +29,19 @@ export declare const DEFAULT_WORK_OFFLINE_LABELS: {
 };
 /** Icon toggle that forces the app offline even while the server is reachable. */
 export declare function WorkOfflineToggle({ isOffline, onToggle, labels, testId, }: WorkOfflineToggleProps): import("react").JSX.Element;
+/** The live server connection as a host knows it. */
+export interface ServerConnectionStatus {
+    /** The socket to the server. */
+    status: 'connected' | 'connecting' | 'disconnected' | 'error';
+    /** The user chose to work offline (`WorkOfflineToggle`). */
+    forcedOffline?: boolean;
+    /** The device has no network at all: offline, and it comes back by itself. */
+    deviceOffline?: boolean;
+}
+export interface ServerConnectionView {
+    state: ServerConnectionState;
+    label: string;
+    description: string;
+}
+/** What the server-connection row shows for a status, naming the deployment `domain`. */
+export declare function serverConnectionView({ status, forcedOffline, deviceOffline }: ServerConnectionStatus, domain: string): ServerConnectionView;

package/dist/settings/SettingsPage.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A settings page: a tab per section, the open section's body under a page title. Each section is
+ * addressable by its id, so a host (or `openSettings(section)`) can open the page at one.
+ */
+import type { ReactNode } from 'react';
+export interface SettingsPageSection {
+    /** Addressable id, e.g. `account`; the tab's test id is `<id>-tab`. */
+    id: string;
+    label: ReactNode;
+    icon?: ReactNode;
+    /** The section's body, rendered only while it is open. */
+    render: () => ReactNode;
+    /** Controls at the right of the tab row while this section is open. */
+    actions?: ReactNode;
+}
+export interface SettingsPageProps {
+    sections: readonly SettingsPageSection[];
+    /** The open section's id; an id with no section opens the first. */
+    activeSectionId: string | undefined;
+    onSectionChange: (id: string) => void;
+    /** Page heading above the section body; default `Settings`. */
+    title?: ReactNode;
+    /** Controls at the right of the tab row on every section (e.g. the panel's mode switcher). */
+    headerActions?: ReactNode;
+    /** Dialogs and other content outside the frame. */
+    children?: ReactNode;
+    testId?: string;
+}
+/** The section a page opens at: the one asked for when it exists, else the first. */
+export declare function resolveSettingsSection(sections: readonly SettingsPageSection[], id: string | undefined): SettingsPageSection | undefined;
+export declare function SettingsPage({ sections, activeSectionId, onSectionChange, title, headerActions, children, testId, }: SettingsPageProps): import("react").JSX.Element;