react-semaphor 0.1.543 → 0.1.544

package/dist/types/components/briefings/briefing-author/run-ui.d.ts

@@ -1,81 +0,0 @@
-import { BriefingPreviewPlan, BriefingPreviewRun, BriefingRun } from '../../../lib/types/briefing-types.js';
-import { EmailPreviewArtifact, SlackPreviewArtifact } from './run-model.js';
-type PendingAction = 'save' | 'run' | 'plan' | 'preview' | 'pause' | 'resume' | 'delete' | 'cancelRun' | 'deleteRun' | null;
-export declare function BriefingPlanReview({ previewPlan, previewRun, scopeLabel, }: {
-    previewPlan: BriefingPreviewPlan;
-    previewRun: BriefingPreviewRun | null;
-    scopeLabel?: string | null;
-}): import("react").JSX.Element;
-export declare function LatestRunSummary({ run, onViewOutput, onDeleteRun, onRetryRun, retryDisabled, retryDisabledReason, deletePending, }: {
-    run: BriefingRun;
-    onViewOutput: () => void;
-    onDeleteRun?: () => void;
-    onRetryRun?: () => void;
-    retryDisabled?: boolean;
-    retryDisabledReason?: string;
-    deletePending?: boolean;
-}): import("react").JSX.Element;
-export declare function RunProgressDetails({ run }: {
-    run: BriefingPreviewRun | BriefingRun;
-}): import("react").JSX.Element;
-export declare function RunExpectationBanner(): import("react").JSX.Element;
-export declare function BackgroundRunPill({ run, onExpand, }: {
-    run: BriefingPreviewRun | BriefingRun;
-    onExpand: () => void;
-}): import("react").JSX.Element;
-export declare function RunCompletionBanner({ title, durationSeconds, status, onView, onDismiss, }: {
-    title: string;
-    durationSeconds: number | null;
-    status: 'success' | 'failed';
-    onView: () => void;
-    onDismiss: () => void;
-}): import("react").JSX.Element;
-export declare function StickyActivityBar({ pendingAction, previewRun, savedActiveRun, onShowDetails, onCancelPreviewRun, onCancelSavedRun, onMinimizeRun, detailsVisible, }: {
-    pendingAction: PendingAction;
-    previewRun: BriefingPreviewRun | null;
-    savedActiveRun: BriefingRun | null;
-    onShowDetails: () => void;
-    onCancelPreviewRun?: () => void;
-    onCancelSavedRun?: () => void;
-    onMinimizeRun?: () => void;
-    detailsVisible: boolean;
-}): import("react").JSX.Element | null;
-export declare function EmailPackagePreview({ preview, onExpand, reportMode, }: {
-    preview: EmailPreviewArtifact;
-    onExpand?: () => void;
-    reportMode?: boolean;
-}): import("react").JSX.Element;
-export declare function SlackMessagePreview({ preview, onExpand, trustLine, reactions, }: {
-    preview: SlackPreviewArtifact;
-    onExpand?: () => void;
-    /** Optional italic footer line ("Runs with X's permissions · …"). */
-    trustLine?: string;
-    /** Mock reaction counts for the preview surface. Real reactions come back
-        after send and are surfaced separately on the briefing detail. */
-    reactions?: Array<{
-        emoji: string;
-        count: number;
-    }>;
-}): import("react").JSX.Element;
-export declare function BriefingPreviewResult({ previewRun, onExpand, fullWidth, reportMode, }: {
-    previewRun: BriefingPreviewRun;
-    onExpand?: () => void;
-    fullWidth?: boolean;
-    reportMode?: boolean;
-}): import("react").JSX.Element;
-export declare function SavedRunResult({ run, onExpand, reportMode, onDeleteRun, onRetryRun, retryDisabled, retryDisabledReason, deletePending, }: {
-    run: BriefingRun;
-    onExpand?: () => void;
-    reportMode?: boolean;
-    onDeleteRun?: () => void;
-    onRetryRun?: () => void;
-    retryDisabled?: boolean;
-    retryDisabledReason?: string;
-    deletePending?: boolean;
-}): import("react").JSX.Element;
-export declare function LocalPreviewOutputCallout({ previewRun, isStale, onViewOutput, }: {
-    previewRun: BriefingPreviewRun;
-    isStale: boolean;
-    onViewOutput: () => void;
-}): import("react").JSX.Element;
-export {};

package/dist/types/components/briefings/use-briefing-run-polling.d.ts

@@ -1,34 +0,0 @@
-type PollableBriefingRun = {
-    id: string;
-    status: string;
-    error?: string | null;
-};
-type PollingStatus = 'idle' | 'polling' | 'terminal' | 'timed_out' | 'error';
-type PollingInput = {
-    apiServiceUrl: string;
-    token: string;
-    runId: string;
-};
-type UseBriefingRunPollingOptions<Run extends PollableBriefingRun> = {
-    apiServiceUrl?: string;
-    token?: string;
-    intervalMs: number;
-    timeoutMs: number;
-    fetchRun: (input: PollingInput) => Promise<Run>;
-    onRun: (run: Run) => void;
-    onTerminalRun?: (run: Run) => void;
-    onError?: (error: unknown) => void;
-    onTimeout?: (runId: string) => void;
-};
-export declare function isTerminalBriefingRunStatus(status: string | undefined): boolean;
-export declare function isActiveBriefingRunStatus(status: string | undefined): boolean;
-export declare function useBriefingRunPolling<Run extends PollableBriefingRun>({ apiServiceUrl, token, intervalMs, timeoutMs, fetchRun, onRun, onTerminalRun, onError, onTimeout, }: UseBriefingRunPollingOptions<Run>): {
-    activeRunId: string | null;
-    isPolling: boolean;
-    resetTerminalRun: () => void;
-    startRun: (run: Run) => void;
-    startRunId: (runId: string) => void;
-    status: PollingStatus;
-    stop: () => void;
-};
-export {};

package/dist/types/components/notifications/export-notification-item.d.ts

@@ -1,24 +0,0 @@
-import { default as React } from 'react';
-import { ActiveExport } from '../../lib/stores/export-store.js';
-export type ExportDownloadOutcome = 'opened' | 'denied';
-interface ExportNotificationItemProps {
-    /** The export data to display */
-    export: ActiveExport;
-    /** Called when user clicks dismiss/remove */
-    onRemove?: (id: string) => void;
-    /**
-     * Opens the file, resolving a fresh signed link first when the row holds
-     * none. Resolves 'denied' when the link could not be signed.
-     */
-    onDownload?: (exp: ActiveExport) => Promise<ExportDownloadOutcome>;
-}
-/**
- * One background export. Visual reference: semaphor-app /design/export-tray.
- *
- * A row is a status dot, the title, one metadata line and one text action.
- * At rest the metadata line shows only the time; rows and size disclose on
- * hover or focus, in the same gesture that reveals Remove. A ready export
- * always offers Download; the link is resolved on click when it is missing.
- */
-export declare function ExportNotificationItem({ export: exp, onRemove, onDownload, }: ExportNotificationItemProps): React.JSX.Element;
-export {};

package/dist/types/components/notifications/export-notification-list.d.ts

@@ -1,8 +0,0 @@
-import { default as React } from 'react';
-/**
- * List of export notifications.
- *
- * Displays all active and recent exports with their status,
- * progress, and download options.
- */
-export declare function ExportNotificationList(): React.JSX.Element;

package/dist/types/components/notifications/index.d.ts

@@ -1,3 +0,0 @@
-export { NotificationBell } from './notification-bell.js';
-export { ExportNotificationList } from './export-notification-list.js';
-export { ExportNotificationItem } from './export-notification-item.js';

package/dist/types/components/notifications/notification-bell.d.ts

@@ -1,13 +0,0 @@
-import { default as React } from 'react';
-/**
- * Notification bell icon with badge.
- *
- * Shows a badge when there are:
- * - In-progress exports (shows count)
- * - Completed exports that haven't been dismissed (shows dot)
- *
- * Clicking opens a popover with the full export notification list.
- */
-export declare function NotificationBell({ variant, }: {
-    variant?: 'outline' | 'ghost';
-}): React.JSX.Element;

package/dist/types/lib/exports/bounded-request.d.ts

@@ -1,12 +0,0 @@
-/**
- * One export status, list or download-link request never waits longer than
- * this (hotspot H-06: every wait that decides something is bounded). A
- * timed-out request counts as failed, and its fetch is aborted.
- */
-export declare const EXPORT_STATUS_TIMEOUT_MS = 15000;
-/**
- * Rejects when `work` outlasts `EXPORT_STATUS_TIMEOUT_MS`, and aborts its
- * request. `work` must pass `signal` to its fetch, or the timeout releases the
- * caller while the request stays open (a static test checks every caller).
- */
-export declare function boundedRequest<T>(work: (signal: AbortSignal) => Promise<T>): Promise<T>;

package/dist/types/lib/hooks/use-export-polling.d.ts

@@ -1,32 +0,0 @@
-import { EXPORT_STATUS_TIMEOUT_MS } from '../exports/bounded-request.js';
-/**
- * The browser follows the server (MX-D9): it gives up on an export this long
- * after the server's `deadlineAt`, by which the server has settled the export.
- */
-export declare const EXPORT_POLL_GRACE_MS: number;
-export { EXPORT_STATUS_TIMEOUT_MS };
-/**
- * Hook that manages smart polling for export status updates.
- *
- * Features:
- * - Dynamic polling intervals (10s → 15s → 30s) based on export duration
- * - Page Visibility API integration (pauses when tab is hidden)
- * - Automatic download URL fetching when export completes
- * - Only polls when there are in-progress exports
- *
- * @returns Object with polling state
- */
-export declare function useExportPolling(): {
-    isPolling: boolean;
-    isTabVisible: boolean;
-    inProgressCount: number;
-};
-export declare const POLLING_INTERVALS: {
-    INITIAL: number;
-    MEDIUM: number;
-    LONG: number;
-    MEDIUM_THRESHOLD: number;
-    LONG_THRESHOLD: number;
-    EXPORT_POLL_GRACE_MS: number;
-    FALLBACK_POLLING_DURATION: number;
-};

package/dist/types/lib/hooks/use-export-recovery.d.ts

@@ -1,11 +0,0 @@
-/**
- * Hook that recovers active exports when the app mounts or page refreshes.
- *
- * This ensures that:
- * - Users don't lose track of their exports after a page refresh
- * - The notification tray shows all in-progress exports
- * - Polling resumes for any ongoing exports
- *
- * Should be called once at the app root level (e.g., in dashboard-plus.tsx).
- */
-export declare function useExportRecovery(): void;

package/dist/types/lib/stores/export-store.d.ts

@@ -1,62 +0,0 @@
-/**
- * Represents an active or recently completed export job.
- */
-export interface ActiveExport {
-    id: string;
-    status: 'pending' | 'processing' | 'chunking' | 'compacting' | 'completed' | 'failed' | 'cancelled';
-    progress: number | null;
-    title: string;
-    totalRows: number | null;
-    totalChunks: number | null;
-    rowsProcessed?: number;
-    completedChunks: number;
-    startedAt: Date;
-    lastUpdatedAt: Date;
-    completedAt?: Date;
-    downloadUrl?: string;
-    fileSize?: number;
-    error?: string;
-    expiresAt: Date;
-    /** Matrix exports: the server's phase, for the bell's stage text (M9, M10, M12). */
-    phase?: 'preparing' | 'acquiring' | 'finalizing' | 'completed';
-    /** When the server stops the export; polling gives up a grace period later (MX-D9). */
-    deadlineAt?: Date;
-}
-type ExportStoreState = {
-    /** Map of export ID to export data */
-    activeExports: Map<string, ActiveExport>;
-};
-type ExportStoreActions = {
-    /** Add a new export to the store */
-    addExport: (exportData: ActiveExport) => void;
-    /** Update an existing export */
-    updateExport: (id: string, updates: Partial<ActiveExport>) => void;
-    /**
-     * Applies a server answer (poll, refresh). An answer never moves an export
-     * that is final here back to in progress: a newer answer already settled it.
-     */
-    applyServerStatus: (id: string, updates: Partial<ActiveExport>) => void;
-    /** Adds a recovered export only if it is not tracked already (checked when adding). */
-    recoverExport: (exportData: ActiveExport) => void;
-    /** Remove an export from the store */
-    removeExport: (id: string) => void;
-    /** Get all in-progress exports */
-    getInProgressExports: () => ActiveExport[];
-    /** Get all exports as an array */
-    getAllExports: () => ActiveExport[];
-    /** Clear all completed/failed exports */
-    clearCompleted: () => void;
-    /** Check if there are any in-progress exports */
-    hasInProgressExports: () => boolean;
-};
-export type ExportStore = ExportStoreState & {
-    actions: ExportStoreActions;
-};
-export declare const useExportStore: import('zustand').UseBoundStore<Omit<import('zustand').StoreApi<ExportStore>, "setState"> & {
-    setState(nextStateOrUpdater: ExportStore | Partial<ExportStore> | ((state: import('immer').WritableDraft<ExportStore>) => void), shouldReplace?: false): void;
-    setState(nextStateOrUpdater: ExportStore | ((state: import('immer').WritableDraft<ExportStore>) => void), shouldReplace: true): void;
-}>;
-export declare const useExportActions: () => ExportStoreActions;
-export declare const useActiveExports: () => Map<string, ActiveExport>;
-export declare const useInProgressExportsCount: () => number;
-export {};