@makershq/react 0.0.0-stage → 0.3.1

package/dist/connectors/use-release-note-list-connector.js

@@ -0,0 +1,219 @@
+/**
+ * Coordinates anonymous release-note requests for the reader.
+ *
+ * Owns cancellation, pagination, isolated offline copies and retry state.
+ *
+ * Keep presentation and native window lifecycle callbacks in their components.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { fetchReleasePage, normalizeReleaseVersion, ReleaseUnavailableError, } from '../api.js';
+import { readReleaseCache, writeReleaseCache } from '../cache.js';
+/**
+ * Loads anonymous notes with isolated offline copies and bounded pagination.
+ * @param options - Project and optional exact version.
+ * @param options.projectId - Public project identifier.
+ * @param options.version - Optional exact version.
+ * @returns Reader state, continuation and retry operations.
+ */
+export function useReleaseNoteListConnector({ projectId, version, }) {
+    let requestedVersion = version?.trim();
+    if (version !== undefined) {
+        try {
+            requestedVersion = normalizeReleaseVersion(version);
+        }
+        catch {
+            /* The request reports invalid versions through the error state. */
+        }
+    }
+    const identity = JSON.stringify([projectId, requestedVersion ?? null]);
+    const [attempt, setAttempt] = useState(0);
+    const [state, setState] = useState({
+        identity,
+        loading: true,
+        loadingMore: false,
+        cached: false,
+        error: false,
+        unavailable: false,
+    });
+    const activeIdentity = useRef(identity);
+    activeIdentity.current = identity;
+    const requestId = useRef(0);
+    const activeController = useRef(null);
+    const paging = useRef(false);
+    const current = state.identity === identity
+        ? state
+        : {
+            identity,
+            loading: true,
+            loadingMore: false,
+            cached: false,
+            error: false,
+            unavailable: false,
+        };
+    useEffect(() => {
+        const controller = new AbortController();
+        activeController.current = controller;
+        paging.current = false;
+        const id = ++requestId.current;
+        setState({
+            identity,
+            loading: true,
+            loadingMore: false,
+            cached: false,
+            error: false,
+            unavailable: false,
+        });
+        void fetchReleasePage(projectId, {
+            version: requestedVersion,
+            signal: controller.signal,
+        })
+            .then((page) => {
+            if (controller.signal.aborted || id !== requestId.current)
+                return;
+            writeReleaseCache(projectId, requestedVersion, page);
+            setState({
+                identity,
+                page,
+                loading: false,
+                loadingMore: false,
+                cached: false,
+                error: false,
+                unavailable: false,
+            });
+        })
+            .catch((error) => {
+            if (controller.signal.aborted || id !== requestId.current)
+                return;
+            const unavailable = error instanceof ReleaseUnavailableError;
+            if (unavailable)
+                writeReleaseCache(projectId, requestedVersion, null);
+            const saved = unavailable
+                ? undefined
+                : readReleaseCache(projectId, requestedVersion);
+            setState({
+                identity,
+                page: saved,
+                loading: false,
+                loadingMore: false,
+                cached: !!saved,
+                error: true,
+                unavailable,
+            });
+        });
+        return () => {
+            ++requestId.current;
+            paging.current = false;
+            controller.abort();
+        };
+    }, [projectId, requestedVersion, identity, attempt]);
+    async function loadMore() {
+        const cursor = current.page?.nextCursor;
+        if (!cursor || current.loadingMore || current.cached || paging.current)
+            return;
+        const controller = activeController.current;
+        if (!controller || controller.signal.aborted)
+            return;
+        paging.current = true;
+        const id = requestId.current;
+        setState((previous) => ({ ...previous, loadingMore: true, error: false }));
+        try {
+            const page = await fetchReleasePage(projectId, {
+                cursor,
+                signal: controller.signal,
+            });
+            if (id !== requestId.current || controller.signal.aborted)
+                return;
+            setState((previous) => {
+                if (previous.identity !== identity || !previous.page)
+                    return previous;
+                const seen = new Set(previous.page.items.map((release) => release.id));
+                return {
+                    ...previous,
+                    page: {
+                        items: [
+                            ...previous.page.items,
+                            ...page.items.filter((release) => !seen.has(release.id)),
+                        ],
+                        nextCursor: page.nextCursor === cursor ? null : page.nextCursor,
+                    },
+                    loadingMore: false,
+                };
+            });
+        }
+        catch (error) {
+            if (id !== requestId.current || controller.signal.aborted)
+                return;
+            if (error instanceof ReleaseUnavailableError) {
+                writeReleaseCache(projectId, requestedVersion, null);
+                setState({
+                    identity,
+                    loading: false,
+                    loadingMore: false,
+                    cached: false,
+                    error: true,
+                    unavailable: true,
+                });
+            }
+            else
+                setState((previous) => ({
+                    ...previous,
+                    loadingMore: false,
+                    error: true,
+                }));
+        }
+        finally {
+            if (id === requestId.current)
+                paging.current = false;
+        }
+    }
+    function retry() {
+        if (current.page && !current.cached)
+            void loadMore();
+        else
+            setAttempt((value) => value + 1);
+    }
+    const loadMoreOperation = useRef(loadMore);
+    loadMoreOperation.current = loadMore;
+    const retryOperation = useRef(retry);
+    retryOperation.current = retry;
+    useEffect(() => {
+        if (current.loading ||
+            current.loadingMore ||
+            (!current.cached && !current.error))
+            return;
+        let requested = false;
+        function revalidate() {
+            if (requested)
+                return;
+            requested = true;
+            retryOperation.current();
+        }
+        window.addEventListener('online', revalidate);
+        return () => window.removeEventListener('online', revalidate);
+    }, [
+        identity,
+        current.cached,
+        current.error,
+        current.loading,
+        current.loadingMore,
+    ]);
+    const generation = requestId.current;
+    const loadMoreAction = useCallback(() => {
+        if (activeIdentity.current === identity && generation === requestId.current)
+            return loadMoreOperation.current();
+    }, [identity, generation]);
+    const retryAction = useCallback(() => {
+        if (activeIdentity.current === identity && generation === requestId.current)
+            retryOperation.current();
+    }, [identity, generation]);
+    return {
+        page: current.page,
+        loading: current.loading,
+        loadingMore: current.loadingMore,
+        cached: current.cached,
+        error: current.error,
+        unavailable: current.unavailable,
+        loadMore: loadMoreAction,
+        retry: retryAction,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Exposes the browser-only Maker’s HQ React integration.
+ *
+ * Owns the small public component and HTTP data contracts without native imports.
+ *
+ * Add native capabilities only to the separate optional tauri entry point.
+ */
+export { ReleaseNotes } from './components/release-notes/index.js';
+export type { ReleaseNotesProps } from './components/release-notes/index.js';
+export type { Release, ReleasePage } from './api.js';
+export { WebsiteUpdates } from './website/components/website-updates/index.js';
+export type { WebsiteUpdatesProps } from './website/components/website-updates/index.js';
+export type { WebsiteBuild } from './website/version.js';
+export { useReleaseNoteListConnector as useReleaseNotesReader } from './connectors/use-release-note-list-connector.js';
+export type { ReleaseNotesReaderOptions } from './connectors/use-release-note-list-connector.js';
+export { ReleaseMarkdown } from './components/release-markdown/index.js';
+export type { ReleaseMarkdownProps } from './components/release-markdown/index.js';
+export { releaseImageUrl } from './api.js';
+export { useWebsiteUpdatesConnector as useWebsiteUpdates } from './website/use-website-updates-connector.js';
+export type { WebsiteUpdatesOptions } from './website/use-website-updates-connector.js';

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * Exposes the browser-only Maker’s HQ React integration.
+ *
+ * Owns the small public component and HTTP data contracts without native imports.
+ *
+ * Add native capabilities only to the separate optional tauri entry point.
+ */
+export { ReleaseNotes } from './components/release-notes/index.js';
+export { WebsiteUpdates } from './website/components/website-updates/index.js';
+export { useReleaseNoteListConnector as useReleaseNotesReader } from './connectors/use-release-note-list-connector.js';
+export { ReleaseMarkdown } from './components/release-markdown/index.js';
+export { releaseImageUrl } from './api.js';
+export { useWebsiteUpdatesConnector as useWebsiteUpdates } from './website/use-website-updates-connector.js';

package/dist/styles.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+.flrn-native{--text-sm:.875rem;--text-sm--line-height:1.25rem;--text-base:1rem;--text-base--line-height:1.5rem;--text-xl:1.25rem;--text-xl--line-height:1.75rem;--fl-background:var(--background,#fff);--fl-foreground:var(--foreground,#202020);--fl-muted:var(--muted-foreground,#686868);--fl-border:var(--border,#e4e4e4);--fl-primary:var(--primary,#252525);--fl-primary-fg:var(--primary-foreground,#fff);color:var(--fl-foreground);background:var(--fl-background);color-scheme:light;font-size:var(--text-base,1rem);line-height:var(--tw-leading,var(--text-base--line-height,calc(1.5 / 1)));line-height:var(--leading-normal,1.5);font-family:inherit}.flrn-native[data-theme=dark]{--fl-background:var(--background,#1c1c1e);--fl-foreground:var(--foreground,#f1f1f1);--fl-muted:var(--muted-foreground,#aaa);--fl-border:var(--border,#3b3b3d);--fl-primary:var(--primary,#f0f0f0);--fl-primary-fg:var(--primary-foreground,#202020);color-scheme:dark}@media (prefers-color-scheme:dark){.flrn-native[data-theme=system]{--fl-background:var(--background,#1c1c1e);--fl-foreground:var(--foreground,#f1f1f1);--fl-muted:var(--muted-foreground,#aaa);--fl-border:var(--border,#3b3b3d);--fl-primary:var(--primary,#f0f0f0);--fl-primary-fg:var(--primary-foreground,#202020);color-scheme:dark}}.flrn-native,.flrn-native *{box-sizing:border-box}.flrn-native h1{font-size:var(--text-xl,1.25rem);line-height:var(--tw-leading,var(--text-xl--line-height,calc(1.75 / 1.25)));line-height:var(--leading-snug,1.375);margin:0 0 16px;font-weight:600}.flrn-native p{margin:0}.flrn-native .flrn-muted{color:var(--fl-muted);font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)))}.flrn-native button{border:1px solid var(--fl-primary);font:inherit;font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));height:2.25rem;color:var(--fl-primary-fg);background:var(--fl-primary);cursor:pointer;border-radius:8px;flex-shrink:0;justify-content:center;align-items:center;gap:8px;padding:.5rem 1rem;font-weight:500;display:inline-flex}.flrn-native button:has(>svg){padding-inline:.75rem}.flrn-native button svg{flex-shrink:0;width:1rem;height:1rem}.flrn-native button.flrn-secondary{color:var(--fl-foreground);border-color:var(--fl-border);background:0 0}.flrn-native button:disabled{opacity:.5;cursor:default}.flrn-native :focus-visible{outline-offset:3px;outline:2px solid highlight}.flrn-native input{accent-color:var(--fl-primary);flex-shrink:0;width:16px;height:16px}.flrn-native.flrn-settings{max-width:760px;padding:24px}.flrn-native .flrn-setting-row{border-bottom:1px solid var(--fl-border);justify-content:space-between;align-items:center;gap:24px;padding:20px 0;display:flex}.flrn-native .flrn-setting-row label span{display:block}.flrn-native.flrn-child{flex-direction:column;width:100%;height:100vh;display:flex;overflow:hidden}.flrn-native .flrn-child-scroll{overscroll-behavior:contain;flex:1;min-height:0;overflow:auto}.flrn-native.flrn-child>footer{border-top:1px solid var(--fl-border);background:var(--fl-background);flex:none;justify-content:space-between;align-items:center;gap:16px;padding:16px 24px;display:flex}.flrn-native .flrn-preference{font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));align-items:center;gap:8px;display:flex}.flrn-native .flrn-update-intro{border-bottom:1px solid var(--fl-border);align-items:flex-start;gap:20px;padding:28px 28px 20px;display:flex}.flrn-native .flrn-update-intro img{object-fit:contain;width:72px;height:72px}.flrn-native .flrn-update-intro h1{margin-bottom:8px}.flrn-native .flrn-update-intro p+p{margin-top:8px}.flrn-native .flrn-current{text-align:center;padding:48px 24px}.flrn-native .flrn-progress{width:100%}.flrn-native .flrn-progress progress{width:100%;accent-color:var(--fl-primary);margin:8px 0 0}.flrn-native .flrn-updater-notes{margin:20px 28px}.flrn-native .flrn-updater-notes p{white-space:pre-wrap;margin-top:12px}.flrn-native [role=alert]{padding:12px 24px}@media (max-width:440px){.flrn-native .flrn-update-intro{gap:12px;padding:20px}.flrn-native .flrn-update-intro img{width:48px;height:48px}.flrn-native.flrn-child>footer{flex-wrap:wrap;padding:16px}.flrn-native.flrn-settings{padding:20px}.flrn-native .flrn-setting-row{flex-wrap:wrap;gap:16px}}.flrn-native .flrn-update-notes-panel{border:1px solid var(--fl-border);border-radius:8px;margin:0 24px 20px}.flrn-native .flrn-update-intro{border-bottom:0}.flrn-native.flrn-child{height:auto;position:fixed;inset:0}.flrn-native input[role=switch]{appearance:none;border:1px solid var(--fl-border);background:var(--fl-border);cursor:pointer;border-radius:999px;width:36px;height:20px;margin:0;position:relative}.flrn-native input[role=switch]:before{content:"";background:var(--fl-background);border-radius:50%;width:14px;height:14px;position:absolute;top:2px;left:2px}.flrn-native input[role=switch]:checked{background:var(--fl-primary);border-color:var(--fl-primary)}.flrn-native input[role=switch]:checked:before{background:var(--fl-primary-fg);transform:translate(16px)}.fl-website-updates{--text-sm:.875rem;--text-sm--line-height:1.25rem;--text-lg:1.125rem;--text-lg--line-height:1.75rem;--flwu-background:var(--popover,var(--background,#fff));--flwu-foreground:var(--popover-foreground,var(--foreground,#171717));--flwu-muted:var(--muted-foreground,#737373);--flwu-border:var(--border,#e5e5e5);--flwu-accent:var(--accent,#f5f5f5);--flwu-primary:var(--primary,#171717);--flwu-primary-foreground:var(--primary-foreground,#fafafa);--flwu-ring:var(--ring,#737373);font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));color:var(--flwu-foreground);color-scheme:light;z-index:50;overflow-wrap:anywhere;width:380px;max-width:calc(100% - 32px);font-family:inherit;position:fixed;bottom:24px;right:24px}.fl-website-updates[data-theme=dark]{--flwu-background:var(--popover,var(--background,#262626));--flwu-foreground:var(--popover-foreground,var(--foreground,#fafafa));--flwu-muted:var(--muted-foreground,#a3a3a3);--flwu-border:var(--border,#404040);--flwu-accent:var(--accent,#404040);--flwu-primary:var(--primary,#e5e5e5);--flwu-primary-foreground:var(--primary-foreground,#171717);color-scheme:dark}@media (prefers-color-scheme:dark){.fl-website-updates[data-theme=system]{--flwu-background:var(--popover,var(--background,#262626));--flwu-foreground:var(--popover-foreground,var(--foreground,#fafafa));--flwu-muted:var(--muted-foreground,#a3a3a3);--flwu-border:var(--border,#404040);--flwu-accent:var(--accent,#404040);--flwu-primary:var(--primary,#e5e5e5);--flwu-primary-foreground:var(--primary-foreground,#171717);color-scheme:dark}}.fl-website-updates *{box-sizing:border-box}.fl-website-updates .flwu-toast,.fl-website-updates .flwu-panel{background:var(--flwu-background);border:1px solid var(--flwu-border);border-radius:16px;padding:16px;box-shadow:0 10px 15px -3px #0000001a,0 4px 6px -4px #0000001a}.fl-website-updates .flwu-toast-topline{align-items:flex-start;gap:10px;display:flex}.fl-website-updates .flwu-toast-topline>svg{flex-shrink:0;margin-top:3px}.fl-website-updates h2,.fl-website-updates h3,.fl-website-updates p{margin:0}.fl-website-updates h2{font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));font-weight:500}.fl-website-updates p{color:var(--flwu-muted)}.fl-website-updates .flwu-toast p{margin-top:4px}.fl-website-updates button,.fl-website-updates a{font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));color:inherit;cursor:pointer;background:0 0;border:1px solid #0000;border-radius:8px;justify-content:center;align-items:center;gap:8px;min-height:32px;padding:6px 10px;font-family:inherit;font-weight:500;text-decoration:none;display:inline-flex}.fl-website-updates svg{flex-shrink:0}.fl-website-updates button:hover,.fl-website-updates a:hover{background:var(--flwu-accent)}.fl-website-updates button:focus-visible,.fl-website-updates a:focus-visible{outline:2px solid var(--flwu-ring);outline-offset:2px}.fl-website-updates button:disabled{opacity:.5;cursor:default}.fl-website-updates .flwu-primary{background:var(--flwu-primary);color:var(--flwu-primary-foreground)}.fl-website-updates .flwu-primary:hover{background:var(--flwu-primary);opacity:.9}.fl-website-updates .flwu-actions{justify-content:flex-end;gap:8px;margin-top:16px;display:flex}.fl-website-updates .flwu-panel{flex-direction:column;gap:16px;max-height:calc(100svh - 48px);display:flex;overflow-y:auto}.fl-website-updates .flwu-panel header{justify-content:space-between;align-items:center;gap:12px;display:flex}.fl-website-updates .flwu-panel header h2{align-items:center;gap:8px;display:flex}.fl-website-updates .flwu-close{width:32px;margin:-8px -6px -8px 0;padding:0}.fl-website-updates .flwu-content{flex-direction:column;gap:12px;display:flex}.fl-website-updates .flwu-content img{object-fit:contain;border-radius:0;width:100%;height:auto;display:block}.fl-website-updates .flwu-content h3{font-size:var(--text-lg,1.125rem);line-height:var(--tw-leading,var(--text-lg--line-height,calc(1.75 / 1.125)));line-height:var(--leading-snug,1.375);font-weight:500}.fl-website-updates .flwu-panel footer a{border-color:var(--flwu-border);width:100%;min-height:36px}.fl-website-updates .flwu-error{margin-top:12px}@media (max-width:620px){.fl-website-updates{bottom:16px;right:16px}.fl-website-updates .flwu-panel{max-height:calc(100svh - 32px)}}.fl-release-notes{--tw-leading:initial;--text-sm:.875rem;--text-sm--line-height:1.25rem;--text-base:1rem;--text-base--line-height:1.5rem;--text-lg:1.125rem;--text-lg--line-height:1.75rem;--text-xl:1.25rem;--text-xl--line-height:1.75rem;--text-2xl:1.5rem;--text-2xl--line-height:2rem;--text-3xl:1.875rem;--text-3xl--line-height:2.25rem;--fl-background:var(--background,#fff);--fl-foreground:var(--foreground,#1a1c1f);--fl-muted:var(--muted-foreground,#66686b);--fl-border:var(--border,#e4e4e5);--fl-accent:var(--accent,#f0f1f1);--fl-ring:var(--ring,#777);font-size:var(--text-base,1rem);line-height:var(--tw-leading,var(--text-base--line-height,calc(1.5 / 1)));line-height:var(--leading-relaxed,1.625);color:var(--fl-foreground);background:var(--fl-background);color-scheme:light;overflow-wrap:anywhere;min-width:0;padding:2rem;font-family:inherit}.fl-release-notes[data-theme=dark]{--fl-background:var(--background,#181818);--fl-foreground:var(--foreground,#fff);--fl-muted:var(--muted-foreground,#aaa);--fl-border:var(--border,#343434);--fl-accent:var(--accent,#333);color-scheme:dark}@media (prefers-color-scheme:dark){.fl-release-notes[data-theme=system]{--fl-background:var(--background,#181818);--fl-foreground:var(--foreground,#fff);--fl-muted:var(--muted-foreground,#aaa);--fl-border:var(--border,#343434);--fl-accent:var(--accent,#333);color-scheme:dark}}.fl-release-notes .fl-notes-release+.fl-notes-release{margin-top:3rem}.fl-release-notes .fl-notes-heading{flex-wrap:wrap;align-items:baseline;gap:1rem;margin-bottom:1rem;display:flex}.fl-release-notes .fl-notes-heading h2{font-size:var(--text-3xl,1.875rem);line-height:var(--tw-leading,var(--text-3xl--line-height,calc(2.25 / 1.875)));line-height:var(--leading-tight,1.25);letter-spacing:var(--tracking-tight,-.025em);margin:0;font-weight:600}.fl-release-notes .fl-notes-heading time{font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));color:var(--fl-muted);margin-left:auto}.fl-release-notes .fl-notes-title{font-size:var(--text-lg,1.125rem);line-height:var(--tw-leading,var(--text-lg--line-height,calc(1.75 / 1.125)));margin:0 0 1rem;font-weight:600}.fl-release-notes .fl-notes-status{text-align:center;flex-direction:column;justify-content:center;align-items:center;gap:.75rem;min-height:12rem;display:flex}.fl-release-notes .fl-notes-status h2{font-size:var(--text-xl,1.25rem);line-height:var(--tw-leading,var(--text-xl--line-height,calc(1.75 / 1.25)));margin:0;font-weight:600}.fl-release-notes .fl-notes-status p{font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));color:var(--fl-muted);margin:0}.fl-release-notes .fl-notes-notice{font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));color:var(--fl-muted);margin:0 0 1.5rem}.fl-release-notes .fl-notes-footer{border-top:1px solid var(--fl-border);flex-wrap:wrap;align-items:center;gap:1rem;margin-top:2rem;padding-top:1rem;display:flex}.fl-release-notes .fl-notes-footer a{font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));color:var(--fl-muted);margin-left:auto}.fl-release-notes .fl-notes-button{font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));color:inherit;background:var(--fl-background);border:1px solid var(--fl-border);cursor:pointer;border-radius:.375rem;padding:.5rem .875rem;font-family:inherit}.fl-release-notes .fl-notes-button:hover{background:var(--fl-accent)}.fl-release-notes .fl-notes-button:disabled{opacity:.6;cursor:wait}.fl-release-notes .fl-notes-back{margin-bottom:1.5rem}.fl-release-notes :is(a,button,input):focus-visible{outline:2px solid var(--fl-ring);outline-offset:3px}.fl-release-notes .fl-notes-markdown{font-size:var(--text-base,1rem);line-height:var(--tw-leading,var(--text-base--line-height,calc(1.5 / 1)));line-height:var(--leading-relaxed,1.625)}.fl-release-notes .fl-notes-markdown :is(h1,h2){font-size:var(--text-2xl,1.5rem);line-height:var(--tw-leading,var(--text-2xl--line-height,calc(2 / 1.5)));margin:1.75rem 0 .75rem;font-weight:600}.fl-release-notes .fl-notes-markdown :is(h3,h4,h5,h6){font-size:var(--text-lg,1.125rem);line-height:var(--tw-leading,var(--text-lg--line-height,calc(1.75 / 1.125)));margin:1.5rem 0 .75rem;font-weight:600}.fl-release-notes .fl-notes-markdown p{margin:.75rem 0}.fl-release-notes .fl-notes-markdown :is(ul,ol){margin:1rem 0;padding-left:1.5rem}.fl-release-notes .fl-notes-markdown ul{list-style:outside}.fl-release-notes .fl-notes-markdown ol{list-style:decimal}.fl-release-notes .fl-notes-markdown li{margin:.5rem 0}.fl-release-notes .fl-notes-markdown a{color:inherit;text-underline-offset:3px;text-decoration:underline}.fl-release-notes .fl-notes-markdown img{object-fit:contain;border-radius:.375rem;max-width:100%;height:auto}.fl-release-notes .fl-notes-markdown pre{font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));background:var(--fl-accent);border-radius:.375rem;padding:1rem;overflow:auto}.fl-release-notes .fl-notes-markdown code{font-size:var(--text-sm,.875rem);line-height:var(--tw-leading,var(--text-sm--line-height,calc(1.25 / .875)));font-family:ui-monospace,monospace}.fl-release-notes .fl-notes-markdown blockquote{border-left:3px solid var(--fl-border);color:var(--fl-muted);margin:1rem 0;padding-left:1rem}.fl-release-notes .fl-notes-markdown table{border-collapse:collapse;width:100%;display:block;overflow:auto}.fl-release-notes .fl-notes-markdown :is(td,th){border:1px solid var(--fl-border);text-align:left;padding:.5rem .75rem}.fl-release-notes .fl-notes-markdown hr{border:0;border-top:1px solid var(--fl-border);margin:1.5rem 0}@media (max-width:480px){.fl-release-notes{padding:1.25rem}.fl-release-notes .fl-notes-heading h2{font-size:var(--text-2xl,1.5rem);line-height:var(--tw-leading,var(--text-2xl--line-height,calc(2 / 1.5)))}.fl-release-notes .fl-notes-heading time{flex-basis:100%;margin-left:0}}

package/dist/styles.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Declares the package's precompiled stylesheet imports.
+ *
+ * Owns CSS module recognition for declaration and native entry-point builds.
+ *
+ * Keep styles side-effect-only without consumer bundler-specific types.
+ */
+export {}

package/dist/tauri/components/native-child/index.d.ts

@@ -0,0 +1,19 @@
+/** Presents release notes and consumer-owned updates in native Tauri windows.
+ *
+ * Mounts SDK child views before app children and keeps all updater callbacks in the host.
+ *
+ * Import this optional entry point only in Tauri apps with the documented capabilities.
+ */
+import { type ChildKind } from '../../protocol.js';
+/** Renders one SDK-owned native child before consumer app boot.
+ * @param props - Validated child route.
+ * @param props.kind - Fixed reader or update role.
+ * @param props.host - Sole callback-owning window label.
+ * @param props.token - Random child capability token.
+ * @returns Native child presentation.
+ */
+export declare function NativeChild({ kind, host, token, }: {
+    kind: ChildKind;
+    host: string;
+    token: string;
+}): import("react").JSX.Element;

package/dist/tauri/components/native-child/index.js

@@ -0,0 +1,146 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/** Presents release notes and consumer-owned updates in native Tauri windows.
+ *
+ * Mounts SDK child views before app children and keeps all updater callbacks in the host.
+ *
+ * Import this optional entry point only in Tauri apps with the documented capabilities.
+ */
+import { useEffect, useState, useRef } from 'react';
+import { emitTo } from '@tauri-apps/api/event';
+import { getCurrentWebviewWindow } from '@tauri-apps/api/webviewWindow';
+import { openUrl } from '@tauri-apps/plugin-opener';
+import { ReleaseNotesReader } from '../../../components/release-notes/index.js';
+import { safeHttpUrl } from '../../../api.js';
+import { ACTION_EVENT, hasPresentationState, CHILD_PREFIX, STATE_EVENT, } from '../../protocol.js';
+import { UpdateWindow } from '../update-window/index.js';
+import { synchronizeChildTheme } from './theme.js';
+async function openExternal(url) {
+    const safe = safeHttpUrl(url);
+    if (safe)
+        await openUrl(safe);
+}
+/** Renders one SDK-owned native child before consumer app boot.
+ * @param props - Validated child route.
+ * @param props.kind - Fixed reader or update role.
+ * @param props.host - Sole callback-owning window label.
+ * @param props.token - Random child capability token.
+ * @returns Native child presentation.
+ */
+export function NativeChild({ kind, host, token, }) {
+    const rootRef = useRef(null);
+    const ordering = useRef({ identity: '', revision: -1 });
+    const [revision, setRevision] = useState(-1);
+    const [state, setState] = useState(null);
+    const [error, setError] = useState(null);
+    const send = (action) => emitTo({ kind: 'WebviewWindow', label: host }, ACTION_EVENT, {
+        sender: CHILD_PREFIX + kind,
+        token,
+        action,
+        generation: (kind === 'reader'
+            ? state?.readerRequest
+            : state?.updateRequest)?.generation,
+    });
+    useEffect(() => {
+        const identity = JSON.stringify([kind, host, token]);
+        if (ordering.current.identity !== identity)
+            ordering.current = { identity, revision: -1 };
+        let disposed = false;
+        let unlisten;
+        const timeout = setTimeout(() => {
+            if (!disposed)
+                setError('Release notes could not connect to the app. Check native event capabilities.');
+        }, 15000);
+        void getCurrentWebviewWindow()
+            .listen(STATE_EVENT, ({ payload }) => {
+            if (disposed || !validStateEnvelope(payload, host, token))
+                return;
+            // A valid handshake resend establishes readiness even when its revision
+            // is already rendered (for example after a StrictMode effect replay).
+            clearTimeout(timeout);
+            setError(null);
+            if (payload.revision <= ordering.current.revision)
+                return;
+            ordering.current.revision = payload.revision;
+            setRevision(payload.revision);
+            setState(payload.state);
+        })
+            .then(async (cleanup) => {
+            if (disposed) {
+                cleanup();
+                return;
+            }
+            unlisten = cleanup;
+            await send({ type: 'ready' });
+        })
+            .catch(() => {
+            if (!disposed)
+                setError('Release notes could not connect to the app. Check native event capabilities.');
+        });
+        return () => {
+            disposed = true;
+            clearTimeout(timeout);
+            unlisten?.();
+        };
+        // The token and fixed route identify one child lifecycle.
+    }, [kind, host, token]);
+    useEffect(() => {
+        if (rootRef.current && state)
+            return synchronizeChildTheme(rootRef.current, state.theme);
+    }, [state?.theme, state?.icon, Boolean(state)]);
+    const act = (action) => {
+        void send(action).catch(() => setError('The app could not receive this action. Please try again.'));
+    };
+    if (!state)
+        return (_jsx("main", { ref: rootRef, className: "flrn-native flrn-child", children: _jsx("p", { role: error ? 'alert' : 'status', children: error || 'Loading…' }) }));
+    const close = () => {
+        void getCurrentWebviewWindow()
+            .close()
+            .catch(() => setError('The window could not be closed.'));
+    };
+    return (_jsxs("main", { ref: rootRef, className: "flrn-native flrn-child", "data-snapshot-revision": revision, "data-theme": state.theme, "data-app-icon": state.icon, onAuxClick: (event) => {
+            if (event.defaultPrevented || event.button !== 1)
+                return;
+            const anchor = event.target.closest?.('a');
+            if (!anchor)
+                return;
+            event.preventDefault();
+            void openExternal(anchor.href).catch(() => setError('The link could not be opened.'));
+        }, onClick: (event) => {
+            if (event.defaultPrevented)
+                return;
+            const anchor = event.target.closest?.('a');
+            if (!anchor)
+                return;
+            event.preventDefault();
+            void openExternal(anchor.href).catch(() => setError('The link could not be opened.'));
+        }, children: [kind === 'reader' ? (_jsxs(_Fragment, { children: [_jsx("div", { className: "flrn-child-scroll", children: _jsx(ReleaseNotesReader, { projectId: state.projectId, version: state.readerVersion ?? undefined, theme: state.theme, openExternal: openExternal, onReleaseRendered: (release, info) => {
+                                if (!info.cached && release.version)
+                                    act({ type: 'rendered', version: release.version });
+                            } }) }), _jsxs("footer", { children: [_jsxs("label", { className: "flrn-preference", children: [_jsx("input", { type: "checkbox", checked: state.preferences.showAfterUpdate, onChange: (event) => act({ type: 'preference', value: event.target.checked }) }), "Show changelog after each update"] }), _jsx("button", { onClick: close, children: "Close" })] })] })) : (_jsx(UpdateWindow, { state: state, act: act, close: close })), error && _jsx("p", { role: "alert", children: error })] }));
+}
+function validStateEnvelope(value, host, token) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const message = value;
+    if (message.sender !== host ||
+        message.token !== token ||
+        typeof message.revision !== 'number' ||
+        !Number.isSafeInteger(message.revision) ||
+        message.revision < 0 ||
+        !message.state ||
+        typeof message.state !== 'object')
+        return false;
+    const state = message.state;
+    // Host data is authenticated, then checked before it reaches native views.
+    return (hasPresentationState(state) &&
+        typeof state.projectId === 'string' &&
+        typeof state.name === 'string' &&
+        typeof state.currentVersion === 'string' &&
+        typeof state.icon === 'string' &&
+        ['system', 'light', 'dark'].includes(String(state.theme)) &&
+        ['idle', 'checking', 'available', 'current', 'progress', 'error'].includes(String(state.status)) &&
+        Boolean(state.preferences &&
+            typeof state.preferences === 'object' &&
+            typeof state.preferences.showAfterUpdate ===
+                'boolean'));
+}

package/dist/tauri/components/native-child/theme.d.ts

@@ -0,0 +1,12 @@
+/** Synchronizes themes only inside the SDK-owned child document.
+ *
+ * Applies the consumer's root dark convention without mounting its app theme provider.
+ *
+ * Preserve host document ownership and restore child document styles during teardown.
+ */
+/** Keeps consumer root tokens, native content and live system appearance in agreement.
+ * @param root - SDK child root whose resolved background fills the dedicated document.
+ * @param theme - Selected consumer theme.
+ * @returns Cleanup restoring the previous dedicated-document theme and listeners.
+ */
+export declare function synchronizeChildTheme(root: HTMLElement, theme: 'system' | 'light' | 'dark'): () => void;

package/dist/tauri/components/native-child/theme.js

@@ -0,0 +1,45 @@
+/** Synchronizes themes only inside the SDK-owned child document.
+ *
+ * Applies the consumer's root dark convention without mounting its app theme provider.
+ *
+ * Preserve host document ownership and restore child document styles during teardown.
+ */
+/** Keeps consumer root tokens, native content and live system appearance in agreement.
+ * @param root - SDK child root whose resolved background fills the dedicated document.
+ * @param theme - Selected consumer theme.
+ * @returns Cleanup restoring the previous dedicated-document theme and listeners.
+ */
+export function synchronizeChildTheme(root, theme) {
+    const documentRoot = root.ownerDocument.documentElement;
+    const body = root.ownerDocument.body;
+    const media = window.matchMedia('(prefers-color-scheme: dark)');
+    const previous = {
+        dark: documentRoot.classList.contains('dark'),
+        theme: documentRoot.getAttribute('data-theme'),
+        colorScheme: documentRoot.style.colorScheme,
+        background: documentRoot.style.backgroundColor,
+        bodyBackground: body.style.backgroundColor,
+    };
+    const apply = () => {
+        const resolved = theme === 'system' ? (media.matches ? 'dark' : 'light') : theme;
+        documentRoot.classList.toggle('dark', resolved === 'dark');
+        documentRoot.setAttribute('data-theme', resolved);
+        documentRoot.style.colorScheme = resolved;
+        const background = window.getComputedStyle(root).backgroundColor;
+        documentRoot.style.backgroundColor = background;
+        body.style.backgroundColor = background;
+    };
+    apply();
+    media.addEventListener('change', apply);
+    return () => {
+        media.removeEventListener('change', apply);
+        documentRoot.classList.toggle('dark', previous.dark);
+        if (previous.theme === null)
+            documentRoot.removeAttribute('data-theme');
+        else
+            documentRoot.setAttribute('data-theme', previous.theme);
+        documentRoot.style.colorScheme = previous.colorScheme;
+        documentRoot.style.backgroundColor = previous.background;
+        body.style.backgroundColor = previous.bodyBackground;
+    };
+}

package/dist/tauri/components/release-notes-host/index.d.ts

@@ -0,0 +1,36 @@
+/** Presents release notes and consumer-owned updates in native Tauri windows.
+ *
+ * Mounts SDK child views before app children and keeps all updater callbacks in the host.
+ *
+ * Import this optional entry point only in Tauri apps with the documented capabilities.
+ */
+import { type ReactNode } from 'react';
+import type { AppUpdater } from '../../contracts.js';
+/** Native host properties; app updates remain completely consumer-owned. */
+export interface ReleaseNotesHostProps {
+    projectId: string;
+    /** Public Maker’s HQ project ID. */
+    icon: string;
+    /** Consumer app icon URL, resolved against the same entry point in child windows. */
+    updater: AppUpdater;
+    /** App-owned eligibility, installation, state flush and restart callbacks; main only. */
+    theme?: 'system' | 'light' | 'dark';
+    /** Consumer app theme; system follows the OS live. */
+    hostWindowLabel?: string;
+    /** Sole native updater owner; defaults to main. */
+    presentation?: 'native' | 'headless';
+    /** Fixed for this mount; remount the host to change presentation policy. */
+    children: ReactNode;
+}
+/** Mounts native SDK views before mounting the consuming application's children.
+ * @param props - Project, app branding and consumer-owned updater callbacks.
+ * @param props.projectId - Public release-note project.
+ * @param props.icon - Consumer-owned app icon URL.
+ * @param props.updater - Consumer-owned updater callbacks.
+ * @param props.theme - Consumer theme preference.
+ * @param props.hostWindowLabel - Sole callback-owning native window.
+ * @param props.presentation - Fixed native or headless presentation policy.
+ * @param props.children - Consumer app mounted in main and ordinary secondary windows, never SDK children.
+ * @returns The host application or a standalone native SDK child window.
+ */
+export declare function ReleaseNotesHost({ projectId, icon, updater, theme, hostWindowLabel, presentation, children, }: ReleaseNotesHostProps): import("react").JSX.Element;

package/dist/tauri/components/release-notes-host/index.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** Presents release notes and consumer-owned updates in native Tauri windows.
+ *
+ * Mounts SDK child views before app children and keeps all updater callbacks in the host.
+ *
+ * Import this optional entry point only in Tauri apps with the documented capabilities.
+ */
+import { useEffect, useState } from 'react';
+import { isTauri } from '@tauri-apps/api/core';
+import { getCurrentWebviewWindow } from '@tauri-apps/api/webviewWindow';
+import { createNativeHostController, } from '../../host-controller.js';
+import { HostContext } from '../../context.js';
+import { childRoute } from '../../protocol.js';
+import { RemoteSettingsClient } from '../../remote-settings-client.js';
+import { NativeChild } from '../native-child/index.js';
+const owners = new Set();
+/** Mounts native SDK views before mounting the consuming application's children.
+ * @param props - Project, app branding and consumer-owned updater callbacks.
+ * @param props.projectId - Public release-note project.
+ * @param props.icon - Consumer-owned app icon URL.
+ * @param props.updater - Consumer-owned updater callbacks.
+ * @param props.theme - Consumer theme preference.
+ * @param props.hostWindowLabel - Sole callback-owning native window.
+ * @param props.presentation - Fixed native or headless presentation policy.
+ * @param props.children - Consumer app mounted in main and ordinary secondary windows, never SDK children.
+ * @returns The host application or a standalone native SDK child window.
+ */
+export function ReleaseNotesHost({ projectId, icon, updater, theme = 'system', hostWindowLabel = 'main', presentation = 'native', children, }) {
+    const [mode] = useState(presentation);
+    if (presentation !== mode)
+        throw new Error('Remount ReleaseNotesHost to change presentation mode.');
+    const [route] = useState(() => {
+        if (!isTauri())
+            throw new Error('ReleaseNotesHost requires a Tauri 2 app. Use ReleaseNotes in a browser.');
+        return mode === 'headless'
+            ? null
+            : childRoute(window.location.href, getCurrentWebviewWindow().label);
+    });
+    if (route)
+        return (_jsx(NativeChild, { kind: route.kind, host: route.host, token: route.token }));
+    if (getCurrentWebviewWindow().label !== hostWindowLabel)
+        return (_jsx(RemoteHostProvider, { projectId: projectId, hostWindowLabel: hostWindowLabel, children: children }));
+    return (_jsx(HostProvider, { projectId: projectId, icon: icon, updater: updater, theme: theme, hostWindowLabel: hostWindowLabel, presentation: mode, children: children }));
+}
+function HostProvider({ projectId, icon, updater, theme = 'system', hostWindowLabel = 'main', presentation = 'native', children, }) {
+    const [controller, setController] = useState(null);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (owners.has(hostWindowLabel)) {
+            setError('Mount one ReleaseNotesHost per app host window.');
+            return;
+        }
+        owners.add(hostWindowLabel);
+        const owner = createNativeHostController(projectId, icon, updater, theme, hostWindowLabel, presentation);
+        setController(owner);
+        return () => {
+            owners.delete(hostWindowLabel);
+            void owner.dispose();
+        };
+        // Consumer rerenders update callbacks and appearance without reopening resources.
+    }, [projectId, hostWindowLabel]);
+    useEffect(() => {
+        controller?.configure(updater, icon, theme);
+    }, [controller, updater, icon, theme]);
+    if (error && presentation === 'headless')
+        throw new Error(error);
+    if (error)
+        return (_jsx("div", { className: "flrn-native", role: "alert", children: error }));
+    if (!controller)
+        return null;
+    return (_jsx(HostContext.Provider, { value: controller, children: children }));
+}
+function RemoteHostProvider({ projectId, hostWindowLabel, children, }) {
+    const [client, setClient] = useState(null);
+    useEffect(() => {
+        const client = new RemoteSettingsClient(projectId, hostWindowLabel);
+        setClient(client);
+        return () => client.dispose();
+    }, [projectId, hostWindowLabel]);
+    return client ? (_jsx(HostContext.Provider, { value: client, children: children })) : null;
+}

package/dist/tauri/components/release-notes-settings/index.d.ts

@@ -0,0 +1,10 @@
+/** Presents release notes and consumer-owned updates in native Tauri windows.
+ *
+ * Mounts SDK child views before app children and keeps all updater callbacks in the host.
+ *
+ * Import this optional entry point only in Tauri apps with the documented capabilities.
+ */
+/** Renders the approved Updates settings content using its enclosing native host.
+ * @returns Current version, manual update check, preference and changelog actions.
+ */
+export declare function ReleaseNotesSettings(): import("react").JSX.Element;