@makershq/react 0.0.0-stage → 0.3.1

package/dist/tauri/remote-settings-client.js

@@ -0,0 +1,265 @@
+/** Connects an existing local settings window to the one native main host.
+ *
+ * Receives presentation snapshots and forwards only bounded settings actions.
+ *
+ * Keep updater resources, installation and background notifications in the main window.
+ */
+import { emitTo } from '@tauri-apps/api/event';
+import { getCurrentWebviewWindow } from '@tauri-apps/api/webviewWindow';
+import { readPreferences } from './preferences.js';
+import { STATE_EVENT, hasPresentationState, } from './protocol.js';
+import { PEER_ACTION_EVENT, PEER_CONNECT_EVENT, PEER_RESULT_EVENT, } from './peer-protocol.js';
+/** Internal read/presentation client for one existing settings window. */
+export class RemoteSettingsClient {
+    projectId;
+    hostLabel;
+    state;
+    listeners = new Set();
+    token = null;
+    snapshotRevision = -1;
+    nonce = crypto.randomUUID();
+    disposers = [];
+    pending = new Map();
+    connectionWaiters = new Set();
+    connectionFailure = null;
+    disposed = false;
+    label = getCurrentWebviewWindow().label;
+    /** Connects to the main host without invoking consumer updater callbacks.
+     * @param projectId - Expected release-note project.
+     * @param hostLabel - Existing callback-owning main window.
+     */
+    constructor(projectId, hostLabel) {
+        this.projectId = projectId;
+        this.hostLabel = hostLabel;
+        this.state = {
+            ready: false,
+            presentation: 'native',
+            readerRequest: null,
+            updateRequest: null,
+            projectId,
+            name: '',
+            currentVersion: '',
+            icon: '',
+            theme: 'system',
+            preferences: readPreferences(null),
+            status: 'idle',
+            candidate: null,
+            progress: null,
+            canCancel: false,
+            error: null,
+            readerVersion: null,
+        };
+        void this.initialize();
+    }
+    /** Subscribes to main-host state.
+     * @param listener - React external-store listener.
+     * @returns Unsubscribe callback.
+     */
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    };
+    /** Reads the stable presentation snapshot.
+     * @returns Latest authenticated main-host state.
+     */
+    getSnapshot = () => this.state;
+    patch(patch) {
+        if (this.disposed)
+            return;
+        this.state = { ...this.state, ...patch };
+        for (const listener of this.listeners)
+            listener();
+    }
+    async initialize() {
+        try {
+            const current = getCurrentWebviewWindow();
+            const stateCleanup = await current.listen(STATE_EVENT, ({ payload }) => {
+                if (!payload || typeof payload !== 'object')
+                    return;
+                const message = payload;
+                if (message.sender !== this.hostLabel ||
+                    message.connectionNonce !== this.nonce ||
+                    typeof message.token !== 'string' ||
+                    !/^[a-f0-9-]{36}$/.test(message.token) ||
+                    (this.token !== null && this.token !== message.token) ||
+                    typeof message.revision !== 'number' ||
+                    !Number.isSafeInteger(message.revision) ||
+                    message.revision < 0 ||
+                    !message.state ||
+                    typeof message.state !== 'object')
+                    return;
+                const state = message.state;
+                if (!hasPresentationState(message.state) ||
+                    state.projectId !== this.projectId ||
+                    typeof state.currentVersion !== 'string' ||
+                    !state.preferences ||
+                    typeof state.preferences.showAfterUpdate !== 'boolean')
+                    return;
+                this.token = message.token;
+                if (message.revision <= this.snapshotRevision)
+                    return;
+                this.snapshotRevision = message.revision;
+                this.patch(state);
+                this.settleConnection();
+            });
+            if (this.disposed) {
+                stateCleanup();
+                return;
+            }
+            this.disposers.push(stateCleanup);
+            const resultCleanup = await current.listen(PEER_RESULT_EVENT, ({ payload }) => {
+                if (!payload || typeof payload !== 'object')
+                    return;
+                const message = payload;
+                if (message.sender !== this.hostLabel ||
+                    message.token !== this.token ||
+                    typeof message.request !== 'string' ||
+                    typeof message.ok !== 'boolean')
+                    return;
+                const pending = this.pending.get(message.request);
+                if (!pending)
+                    return;
+                clearTimeout(pending.timer);
+                this.pending.delete(message.request);
+                if (message.ok)
+                    pending.resolve();
+                else
+                    pending.reject(new Error('The app could not complete this settings action. Please try again.'));
+            });
+            if (this.disposed) {
+                resultCleanup();
+                return;
+            }
+            this.disposers.push(resultCleanup);
+            const connect = () => {
+                if (!this.token && !this.disposed)
+                    void emitTo({ kind: 'WebviewWindow', label: this.hostLabel }, PEER_CONNECT_EVENT, { sender: this.label, nonce: this.nonce }).catch(() => this.patch({
+                        error: 'Could not connect to the app. Check local native event capabilities.',
+                    }));
+            };
+            connect();
+            const interval = setInterval(connect, 500);
+            const timeout = setTimeout(() => {
+                clearInterval(interval);
+                if (!this.token) {
+                    const error = new Error('Could not connect to the app. Keep ReleaseNotesHost mounted in its main window and check local native event capabilities.');
+                    this.patch({ error: error.message });
+                    this.settleConnection(error);
+                }
+            }, 15000);
+            this.disposers.push(() => {
+                clearInterval(interval);
+                clearTimeout(timeout);
+            });
+        }
+        catch {
+            const error = new Error('Could not connect to the app. Check local native event capabilities.');
+            this.patch({ error: error.message });
+            this.settleConnection(error);
+        }
+    }
+    settleConnection(error) {
+        this.connectionFailure = error ?? null;
+        for (const waiter of this.connectionWaiters) {
+            clearTimeout(waiter.timer);
+            if (error)
+                waiter.reject(error);
+            else
+                waiter.resolve();
+        }
+        this.connectionWaiters.clear();
+    }
+    waitForConnection() {
+        if (this.disposed)
+            return Promise.reject(new Error('The settings window closed.'));
+        if (this.token)
+            return Promise.resolve();
+        if (this.connectionFailure)
+            return Promise.reject(this.connectionFailure);
+        return new Promise((resolve, reject) => {
+            const waiter = {
+                resolve,
+                reject,
+                timer: setTimeout(() => {
+                    this.connectionWaiters.delete(waiter);
+                    reject(new Error('The settings window could not connect to the main app.'));
+                }, 15000),
+            };
+            this.connectionWaiters.add(waiter);
+        });
+    }
+    async send(action) {
+        try {
+            await this.waitForConnection();
+            if (this.disposed)
+                throw new Error('The settings window closed.');
+            const request = crypto.randomUUID();
+            await new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    this.pending.delete(request);
+                    reject(new Error('The main app did not complete this settings action.'));
+                }, 30000);
+                this.pending.set(request, { resolve, reject, timer });
+                void emitTo({ kind: 'WebviewWindow', label: this.hostLabel }, PEER_ACTION_EVENT, { sender: this.label, token: this.token, request, action }).catch(() => {
+                    clearTimeout(timer);
+                    this.pending.delete(request);
+                    reject(new Error('The settings action could not reach the main app.'));
+                });
+            });
+        }
+        catch (error) {
+            const failure = error instanceof Error
+                ? error
+                : new Error('The settings action failed.');
+            this.patch({ error: failure.message });
+            throw failure;
+        }
+    }
+    /** Opens a reader owned by main and returning focus to this settings window.
+     * @returns Completion after the native reader is ready.
+     */
+    open = () => this.send({ type: 'open' });
+    /** Runs the main host's manual check, bypassing its skipped candidate.
+     * @returns Completion after the host finishes presenting its result.
+     */
+    check = () => this.send({ type: 'check' });
+    /** Saves the main host's shared preference.
+     * @param value - New after-update preference.
+     * @returns Completion after host persistence and synchronization.
+     */
+    setShowAfterUpdate = (value) => this.send({ type: 'preference', value });
+    /** Sends one bounded command for a captured headless presentation.
+     * @param kind - Reader or update role.
+     * @param generation - Private identity from the authenticated snapshot.
+     * @param action - Bounded presentation command.
+     * @param action.type - Fixed command discriminator.
+     * @param action.version - Exact displayed candidate or rendered release version.
+     * @param action.cached - Whether rendered content came from offline storage.
+     * @returns Command acceptance; long operations report through synchronized state.
+     */
+    presentationAction = (kind, generation, action) => this.send({ type: 'presentation', kind, generation, action });
+    /** Rejects secondary-window background notifications.
+     * @returns A rejected promise; consumer background checking belongs in the main host.
+     */
+    notifyUpdateAvailable = () => Promise.reject(new Error('Send background update notifications only from the configured main host window.'));
+    /** Releases secondary-window listeners without touching main's updater resources. */
+    dispose() {
+        if (this.token)
+            void emitTo({ kind: 'WebviewWindow', label: this.hostLabel }, PEER_ACTION_EVENT, {
+                sender: this.label,
+                token: this.token,
+                request: crypto.randomUUID(),
+                action: { type: 'disconnect' },
+            }).catch(() => undefined);
+        this.disposed = true;
+        this.settleConnection(new Error('The settings window closed.'));
+        for (const dispose of this.disposers)
+            dispose();
+        for (const pending of this.pending.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error('The settings window closed.'));
+        }
+        this.pending.clear();
+        this.listeners.clear();
+    }
+}

package/dist/website/components/update-toast/index.d.ts

@@ -0,0 +1,14 @@
+/** Presents one pending website deployment.
+ * @param props - Refresh state and current-candidate callbacks.
+ * @param props.refreshing - Whether the consumer save barrier is pending.
+ * @param props.error - Safe retryable refresh failure.
+ * @param props.onRefresh - Requests a single consumer save and document reload.
+ * @param props.onDismiss - Defers only the displayed build in this tab.
+ * @returns The compact deployment notification.
+ */
+export declare function UpdateToast({ refreshing, error, onRefresh, onDismiss, }: {
+    refreshing: boolean;
+    error: string | null;
+    onRefresh: () => void;
+    onDismiss: () => void;
+}): import("react").JSX.Element;

package/dist/website/components/update-toast/index.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Presents the latest deployment candidate without interrupting the running website.
+ *
+ * Owns native Refresh and Not now controls with safe save-barrier feedback.
+ *
+ * Keep detection and reload ownership in the private website connector.
+ */
+import { useId } from 'react';
+import { IconAction, RefreshIcon } from '../../../components/icons/index.js';
+/** Presents one pending website deployment.
+ * @param props - Refresh state and current-candidate callbacks.
+ * @param props.refreshing - Whether the consumer save barrier is pending.
+ * @param props.error - Safe retryable refresh failure.
+ * @param props.onRefresh - Requests a single consumer save and document reload.
+ * @param props.onDismiss - Defers only the displayed build in this tab.
+ * @returns The compact deployment notification.
+ */
+export function UpdateToast({ refreshing, error, onRefresh, onDismiss, }) {
+    const title = useId();
+    return (_jsxs("section", { className: "flwu-toast", role: "status", "aria-labelledby": title, children: [_jsxs("div", { className: "flwu-toast-topline", children: [_jsx(RefreshIcon, { size: 16, "aria-hidden": "true" }), _jsxs("div", { children: [_jsx("h2", { id: title, children: "Update available" }), _jsx("p", { children: "Refresh to get the latest version." })] })] }), error && (_jsx("p", { className: "flwu-error", role: "alert", children: error })), _jsxs("div", { className: "flwu-actions", children: [_jsx("button", { type: "button", disabled: refreshing, onClick: onDismiss, children: "Not now" }), _jsx(IconAction, { disabled: refreshing, children: _jsx("button", { type: "button", className: "flwu-primary", disabled: refreshing, onClick: onRefresh, children: refreshing ? 'Refreshing…' : 'Refresh' }) })] })] }));
+}

package/dist/website/components/website-updates/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Adds deployment refresh prompts and exact after-refresh release previews to a website.
+ *
+ * Owns the default nonmodal presentation over the shared browser updates connector.
+ *
+ * Compile currentBuild into the JavaScript bundle and publish its manifest after deploying assets.
+ */
+import { type WebsiteUpdatesOptions } from '../../use-website-updates-connector.js';
+/** Configuration for one website updates mount. */
+export interface WebsiteUpdatesProps extends WebsiteUpdatesOptions {
+    theme?: 'system' | 'light' | 'dark';
+}
+/** Displays the latest deployment prompt or the loaded version's fresh release preview.
+ * @param props - Public project, compiled build, appearance and optional save barrier.
+ * @param props.projectId - Public project which owns release notes.
+ * @param props.currentBuild - Build compiled into the loaded JavaScript.
+ * @param props.currentBuild.buildId - Opaque loaded deployment identity.
+ * @param props.currentBuild.releaseVersion - Optional loaded semantic version.
+ * @param props.manifestUrl - Deployment manifest location, default /version.json.
+ * @param props.theme - Notification color scheme, default system.
+ * @param props.beforeRefresh - Consumer synchronous or asynchronous save barrier.
+ * @returns One nonmodal notification, or null when there is nothing to show.
+ */
+export declare function WebsiteUpdates({ projectId, currentBuild, manifestUrl, theme, beforeRefresh, }: WebsiteUpdatesProps): import("react").JSX.Element | null;

package/dist/website/components/website-updates/index.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Adds deployment refresh prompts and exact after-refresh release previews to a website.
+ *
+ * Owns the default nonmodal presentation over the shared browser updates connector.
+ *
+ * Compile currentBuild into the JavaScript bundle and publish its manifest after deploying assets.
+ */
+import { useWebsiteUpdatesConnector, } from '../../use-website-updates-connector.js';
+import { UpdateToast } from '../update-toast/index.js';
+import { WhatsNewPanel } from '../whats-new-panel/index.js';
+/** Displays the latest deployment prompt or the loaded version's fresh release preview.
+ * @param props - Public project, compiled build, appearance and optional save barrier.
+ * @param props.projectId - Public project which owns release notes.
+ * @param props.currentBuild - Build compiled into the loaded JavaScript.
+ * @param props.currentBuild.buildId - Opaque loaded deployment identity.
+ * @param props.currentBuild.releaseVersion - Optional loaded semantic version.
+ * @param props.manifestUrl - Deployment manifest location, default /version.json.
+ * @param props.theme - Notification color scheme, default system.
+ * @param props.beforeRefresh - Consumer synchronous or asynchronous save barrier.
+ * @returns One nonmodal notification, or null when there is nothing to show.
+ */
+export function WebsiteUpdates({ projectId, currentBuild, manifestUrl = '/version.json', theme = 'system', beforeRefresh, }) {
+    const updates = useWebsiteUpdatesConnector({
+        projectId,
+        currentBuild,
+        manifestUrl,
+        beforeRefresh,
+    });
+    if (!updates.displayedRelease && !updates.candidate)
+        return null;
+    return (_jsx("div", { className: "fl-website-updates", "data-theme": theme, children: updates.displayedRelease ? (_jsx(WhatsNewPanel, { projectId: projectId, release: updates.displayedRelease, onRendered: updates.onReleaseRendered, onDismiss: updates.dismissRelease }, updates.displayedRelease.id)) : updates.candidate ? (_jsx(UpdateToast, { refreshing: updates.refreshing, error: updates.error, onRefresh: () => {
+                void updates.refresh();
+            }, onDismiss: updates.dismissCandidate })) : null }));
+}

package/dist/website/components/whats-new-panel/index.d.ts

@@ -0,0 +1,23 @@
+import { type Release } from '../../../api.js';
+/** Presents a single latched release preview.
+ * @param props - Public release data and private render/dismiss callbacks.
+ * @param props.projectId - Project which owns the preview image.
+ * @param props.release - Exact installed release to preview.
+ * @param props.release.id - Stable public release identifier.
+ * @param props.release.version - Optional exact application version.
+ * @param props.release.title - Human-readable title.
+ * @param props.release.excerpt - Optional plain-text preview.
+ * @param props.release.previewImageSource - Optional preview image source.
+ * @param props.release.markdown - Complete release document.
+ * @param props.release.date - Publication calendar date.
+ * @param props.release.url - Public article URL.
+ * @param props.onRendered - Acknowledges this matching fresh release after commit.
+ * @param props.onDismiss - Removes the panel without changing the loaded website.
+ * @returns A nonmodal release region with a real external article anchor.
+ */
+export declare function WhatsNewPanel({ projectId, release, onRendered, onDismiss, }: {
+    projectId: string;
+    release: Release;
+    onRendered: () => void;
+    onDismiss: () => void;
+}): import("react").JSX.Element;

package/dist/website/components/whats-new-panel/index.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Shows a compact published preview for the release currently loaded in the website.
+ *
+ * Owns original image proportions, text-only fallback and explicit article dismissal.
+ *
+ * Acknowledge only after this release renders; keep its lifetime independent of storage updates.
+ */
+import { useEffect, useId, useState } from 'react';
+import { releaseImageUrl } from '../../../api.js';
+import { ExternalLink, IconAction, NewspaperIcon, X, } from '../../../components/icons/index.js';
+/** Presents a single latched release preview.
+ * @param props - Public release data and private render/dismiss callbacks.
+ * @param props.projectId - Project which owns the preview image.
+ * @param props.release - Exact installed release to preview.
+ * @param props.release.id - Stable public release identifier.
+ * @param props.release.version - Optional exact application version.
+ * @param props.release.title - Human-readable title.
+ * @param props.release.excerpt - Optional plain-text preview.
+ * @param props.release.previewImageSource - Optional preview image source.
+ * @param props.release.markdown - Complete release document.
+ * @param props.release.date - Publication calendar date.
+ * @param props.release.url - Public article URL.
+ * @param props.onRendered - Acknowledges this matching fresh release after commit.
+ * @param props.onDismiss - Removes the panel without changing the loaded website.
+ * @returns A nonmodal release region with a real external article anchor.
+ */
+export function WhatsNewPanel({ projectId, release, onRendered, onDismiss, }) {
+    const title = useId();
+    const [failedImage, setFailedImage] = useState(null);
+    const source = release.previewImageSource
+        ? releaseImageUrl(projectId, release.id, release.previewImageSource)
+        : undefined;
+    useEffect(() => {
+        onRendered();
+    }, [release, onRendered]);
+    return (_jsxs("section", { className: "flwu-panel", role: "region", "aria-labelledby": title, children: [_jsxs("header", { children: [_jsxs("h2", { id: title, children: [_jsx(NewspaperIcon, { size: 16, animateOnView: true, animateOnViewOnce: true, "aria-hidden": "true" }), "What\u2019s new"] }), _jsx(IconAction, { children: _jsx("button", { type: "button", className: "flwu-close", "aria-label": "Dismiss what's new", onClick: onDismiss, children: _jsx(X, { size: 16, "aria-hidden": "true" }) }) })] }), _jsxs("div", { className: "flwu-content", children: [source && failedImage !== source && (_jsx("img", { src: source, alt: "", onError: () => setFailedImage(source) })), _jsx("h3", { children: release.title }), release.excerpt && _jsx("p", { children: release.excerpt })] }), _jsx("footer", { children: _jsx(IconAction, { children: _jsxs("a", { href: release.url, target: "_blank", rel: "noopener noreferrer", onClick: onDismiss, children: ["Read release notes", _jsx(ExternalLink, { size: 16, "aria-hidden": "true" })] }) }) })] }));
+}

package/dist/website/preferences.d.ts

@@ -0,0 +1,32 @@
+/** One durable release acknowledgement. */
+export interface WebsitePreferences {
+    acknowledgedVersion: string | null;
+}
+/** Creates one storage scope for a public project and resolved deployment manifest.
+ * @param projectId - Public project identifier.
+ * @param manifestUrl - Fully resolved manifest URL.
+ * @returns The isolated preferences key.
+ */
+export declare function websitePreferenceKey(projectId: string, manifestUrl: string): string;
+/** Loads or establishes a silent first-visit baseline.
+ * @param key - Isolated project/manifest key.
+ * @param baseline - Currently loaded semantic version, or null.
+ * @returns Durable preferences, or null when storage cannot be safely used.
+ */
+export declare function readWebsitePreferences(key: string, baseline: string | null): WebsitePreferences | null;
+/** Acknowledges rendered notes without overwriting a newer tab's acknowledgement.
+ * @param key - Isolated project/manifest key.
+ * @param version - Exact release which rendered successfully.
+ * @returns Whether durable storage is available.
+ */
+export declare function acknowledgeWebsiteVersion(key: string, version: string): boolean;
+/** Reads this tab's most recently dismissed deployment.
+ * @param key - Isolated project/manifest key.
+ * @returns An opaque build ID, or null when unavailable.
+ */
+export declare function readDismissedWebsiteBuild(key: string): string | null;
+/** Remembers a deployment dismissal only in this tab.
+ * @param key - Isolated project/manifest key.
+ * @param buildId - Candidate dismissed by the user.
+ */
+export declare function dismissWebsiteBuild(key: string, buildId: string): void;

package/dist/website/preferences.js

@@ -0,0 +1,85 @@
+/**
+ * Persists website release acknowledgements and per-tab deployment dismissals.
+ *
+ * Owns project/manifest isolation, first-visit baselines and monotonic version writes.
+ *
+ * Treat denied or corrupt storage conservatively and never show an automatic panel from memory alone.
+ */
+import { gt } from 'semver';
+import { websiteReleaseVersion } from './version.js';
+/** Creates one storage scope for a public project and resolved deployment manifest.
+ * @param projectId - Public project identifier.
+ * @param manifestUrl - Fully resolved manifest URL.
+ * @returns The isolated preferences key.
+ */
+export function websitePreferenceKey(projectId, manifestUrl) {
+    return `makershq.website-updates.v1:${encodeURIComponent(projectId)}:${encodeURIComponent(manifestUrl)}`;
+}
+/** Loads or establishes a silent first-visit baseline.
+ * @param key - Isolated project/manifest key.
+ * @param baseline - Currently loaded semantic version, or null.
+ * @returns Durable preferences, or null when storage cannot be safely used.
+ */
+export function readWebsitePreferences(key, baseline) {
+    try {
+        const saved = window.localStorage.getItem(key);
+        if (saved !== null) {
+            const value = JSON.parse(saved);
+            if (value &&
+                (value.acknowledgedVersion === null ||
+                    (typeof value.acknowledgedVersion === 'string' &&
+                        websiteReleaseVersion(value.acknowledgedVersion) ===
+                            value.acknowledgedVersion)))
+                return { acknowledgedVersion: value.acknowledgedVersion };
+        }
+        const preferences = { acknowledgedVersion: baseline };
+        window.localStorage.setItem(key, JSON.stringify(preferences));
+        return preferences;
+    }
+    catch {
+        return null;
+    }
+}
+/** Acknowledges rendered notes without overwriting a newer tab's acknowledgement.
+ * @param key - Isolated project/manifest key.
+ * @param version - Exact release which rendered successfully.
+ * @returns Whether durable storage is available.
+ */
+export function acknowledgeWebsiteVersion(key, version) {
+    try {
+        const preferences = readWebsitePreferences(key, version);
+        if (!preferences)
+            return false;
+        if (!preferences.acknowledgedVersion ||
+            gt(version, preferences.acknowledgedVersion))
+            window.localStorage.setItem(key, JSON.stringify({ acknowledgedVersion: version }));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Reads this tab's most recently dismissed deployment.
+ * @param key - Isolated project/manifest key.
+ * @returns An opaque build ID, or null when unavailable.
+ */
+export function readDismissedWebsiteBuild(key) {
+    try {
+        return window.sessionStorage.getItem(key + ':dismissed');
+    }
+    catch {
+        return null;
+    }
+}
+/** Remembers a deployment dismissal only in this tab.
+ * @param key - Isolated project/manifest key.
+ * @param buildId - Candidate dismissed by the user.
+ */
+export function dismissWebsiteBuild(key, buildId) {
+    try {
+        window.sessionStorage.setItem(key + ':dismissed', buildId);
+    }
+    catch {
+        /* The mounted component still remembers the dismissal. */
+    }
+}

package/dist/website/use-website-updates-connector.d.ts

@@ -0,0 +1,34 @@
+import { type Release } from '../api.js';
+import { type WebsiteBuild } from './version.js';
+/** Configuration for browser deployment and after-refresh notifications. */
+export interface WebsiteUpdatesOptions {
+    projectId: string;
+    /** Public project identifier. */
+    currentBuild: WebsiteBuild;
+    /** Build identity compiled into the running JavaScript. */
+    manifestUrl?: string;
+    /** Deployment manifest location; defaults to /version.json. */
+    beforeRefresh?: () => void | Promise<void>; /** App-owned save barrier; rejection keeps refresh retryable.
+     * @returns Completion after pending app state is saved.
+     */
+}
+/** Coordinates deployment detection, fresh exact notes and safe refresh.
+ * @param options - Loaded build, release project and refresh configuration.
+ * @param options.projectId - Public project identifier.
+ * @param options.currentBuild - Build compiled into the running JavaScript.
+ * @param options.currentBuild.buildId - Opaque loaded deployment identity.
+ * @param options.currentBuild.releaseVersion - Optional loaded semantic release version.
+ * @param options.manifestUrl - Deployment manifest location.
+ * @param options.beforeRefresh - Consumer save barrier before reloading.
+ * @returns Visible release/candidate and actions bound to that presentation.
+ */
+export declare function useWebsiteUpdatesConnector({ projectId, currentBuild, manifestUrl, beforeRefresh, }: WebsiteUpdatesOptions): {
+    candidate: WebsiteBuild | null;
+    displayedRelease: Release | null;
+    refreshing: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+    dismissCandidate: () => void;
+    dismissRelease: () => void;
+    onReleaseRendered: () => void;
+};