@arbidocs/blocks 0.4.141 → 0.4.143

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;