@makershq/react 0.0.0-stage → 0.3.1

package/dist/components/icons/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Provides isolated private SDK icons using original Lucide geometry and Animate UI defaults.
+ *
+ * Owns reduced-motion gates and native control boundaries without consumer app imports.
+ *
+ * Retain third-party notices and upstream playback defaults when adding artwork.
+ */
+import type { ReactElement } from 'react';
+import { type IconProps } from '@animate-ui/react/icons';
+export { X } from './x/index.js';
+export { ExternalLink } from './external-link/index.js';
+/** Renders the original Lucide Newspaper with Animate UI's built-in path variant.
+ * @param props - Private SVG and upstream playback controls.
+ * @returns The accessible-hidden icon artwork.
+ */
+export declare function NewspaperIcon(props: IconProps<'path'>): import("react").JSX.Element;
+/** Renders the original Lucide RefreshCw using the built-in path variant.
+ * @param props - Private SVG presentation controls.
+ * @returns The refresh icon artwork.
+ */
+export declare function RefreshIcon(props: IconProps<'path'>): import("react").JSX.Element;
+/** Attaches upstream hover/tap animation to the actual button or anchor.
+ * @param props - Native control child and its disabled state.
+ * @param props.children - The single native actionable element.
+ * @param props.disabled - Whether the control is temporarily unavailable.
+ * @returns The unchanged native control with reduced-motion-safe triggers.
+ */
+export declare function IconAction({ children, disabled, }: {
+    children: ReactElement;
+    disabled?: boolean;
+}): import("react").JSX.Element;

package/dist/components/icons/index.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { motion } from 'motion/react';
+import { useIconReducedMotion } from './reduced-motion.js';
+import { AnimateIcon, IconWrapper, staticAnimations, useAnimateIconContext, } from '@animate-ui/react/icons';
+export { X } from './x/index.js';
+export { ExternalLink } from './external-link/index.js';
+function NewspaperDrawing({ size, ...props }) {
+    const { controls } = useAnimateIconContext();
+    const reduced = useIconReducedMotion();
+    const playback = {
+        variants: staticAnimations.path,
+        initial: 'initial',
+        animate: reduced === false ? controls : 'initial',
+    };
+    return (_jsxs(motion.svg, { xmlns: "http://www.w3.org/2000/svg", width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", ...props, children: [_jsx(motion.path, { d: "M15 18h-5", ...playback }), _jsx(motion.path, { d: "M18 14h-8", ...playback }), _jsx(motion.path, { d: "M4 22h16a2 2 0 0 0 2-2V4a2 2 0 0 0-2-2H8a2 2 0 0 0-2 2v16a2 2 0 0 1-4 0v-9a2 2 0 0 1 2-2h2", ...playback }), _jsx(motion.rect, { width: "8", height: "4", x: "10", y: "6", rx: "1", ...playback })] }, reduced ? 'static' : 'animated'));
+}
+function RefreshDrawing({ size, ...props }) {
+    const { controls } = useAnimateIconContext();
+    const reduced = useIconReducedMotion();
+    const playback = {
+        variants: staticAnimations.path,
+        initial: 'initial',
+        animate: reduced === false ? controls : 'initial',
+    };
+    return (_jsxs(motion.svg, { xmlns: "http://www.w3.org/2000/svg", width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", ...props, children: [_jsx(motion.path, { d: "M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8", ...playback }), _jsx(motion.path, { d: "M21 3v5h-5", ...playback }), _jsx(motion.path, { d: "M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16", ...playback }), _jsx(motion.path, { d: "M8 16H3v5", ...playback })] }, reduced ? 'static' : 'animated'));
+}
+/** Renders the original Lucide Newspaper with Animate UI's built-in path variant.
+ * @param props - Private SVG and upstream playback controls.
+ * @returns The accessible-hidden icon artwork.
+ */
+export function NewspaperIcon(props) {
+    const reduced = useIconReducedMotion();
+    return (_jsx(IconWrapper, { icon: NewspaperDrawing, ...props, animateOnView: props.animateOnView === undefined
+            ? undefined
+            : reduced === false && props.animateOnView }));
+}
+/** Renders the original Lucide RefreshCw using the built-in path variant.
+ * @param props - Private SVG presentation controls.
+ * @returns The refresh icon artwork.
+ */
+export function RefreshIcon(props) {
+    const reduced = useIconReducedMotion();
+    return (_jsx(IconWrapper, { icon: RefreshDrawing, ...props, animateOnView: props.animateOnView === undefined
+            ? undefined
+            : reduced === false && props.animateOnView }));
+}
+/** Attaches upstream hover/tap animation to the actual button or anchor.
+ * @param props - Native control child and its disabled state.
+ * @param props.children - The single native actionable element.
+ * @param props.disabled - Whether the control is temporarily unavailable.
+ * @returns The unchanged native control with reduced-motion-safe triggers.
+ */
+export function IconAction({ children, disabled = false, }) {
+    const reduced = useIconReducedMotion();
+    return (_jsx(AnimateIcon, { asChild: true, animateOnHover: !disabled && reduced === false, animateOnTap: !disabled && reduced === false, children: children }));
+}

package/dist/components/icons/reduced-motion.d.ts

@@ -0,0 +1,4 @@
+/** Reads live reduced motion without accessing browser state during SSR.
+ * @returns True when motion must be disabled or browser preference is unavailable.
+ */
+export declare function useIconReducedMotion(): boolean;

package/dist/components/icons/reduced-motion.js

@@ -0,0 +1,24 @@
+/**
+ * Tracks the browser's live reduced-motion preference for private SDK icons.
+ *
+ * Owns one native media subscription per mounted subscriber and an SSR-safe static snapshot.
+ *
+ * Keep this gate local to icons; do not replace Animate UI playback or timing.
+ */
+import { useSyncExternalStore } from 'react';
+const query = '(prefers-reduced-motion: reduce)';
+const serverSnapshot = () => true;
+const snapshot = () => typeof window.matchMedia !== 'function' || window.matchMedia(query).matches;
+const subscribe = (listener) => {
+    if (typeof window.matchMedia !== 'function')
+        return () => { };
+    const media = window.matchMedia(query);
+    media.addEventListener('change', listener);
+    return () => media.removeEventListener('change', listener);
+};
+/** Reads live reduced motion without accessing browser state during SSR.
+ * @returns True when motion must be disabled or browser preference is unavailable.
+ */
+export function useIconReducedMotion() {
+    return useSyncExternalStore(subscribe, snapshot, serverSnapshot);
+}

package/dist/components/icons/x/index.d.ts

@@ -0,0 +1,98 @@
+import { type IconProps } from '@animate-ui/react/icons';
+type XProps = IconProps<keyof typeof animations>;
+declare const animations: {
+    readonly default: {
+        line1: {
+            initial: {
+                rotate: number;
+                transition: {
+                    ease: "easeInOut";
+                    duration: number;
+                };
+            };
+            animate: {
+                rotate: number;
+                transition: {
+                    ease: "easeInOut";
+                    duration: number;
+                };
+            };
+        };
+        line2: {
+            initial: {
+                rotate: number;
+                transition: {
+                    ease: "easeInOut";
+                    duration: number;
+                    delay: number;
+                };
+            };
+            animate: {
+                rotate: number;
+                transition: {
+                    ease: "easeInOut";
+                    duration: number;
+                    delay: number;
+                };
+            };
+        };
+    };
+    readonly plus: {
+        line1: {
+            initial: {
+                rotate: number;
+                x1: number;
+                y1: number;
+                x2: number;
+                y2: number;
+                transition: {
+                    ease: "easeInOut";
+                    duration: number;
+                    delay: number;
+                };
+            };
+            animate: {
+                rotate: number;
+                x1: number;
+                y1: number;
+                x2: number;
+                y2: number;
+                transition: {
+                    ease: "easeInOut";
+                    duration: number;
+                    delay: number;
+                };
+            };
+        };
+        line2: {
+            initial: {
+                rotate: number;
+                x1: number;
+                y1: number;
+                x2: number;
+                y2: number;
+                transition: {
+                    ease: "easeInOut";
+                    duration: number;
+                };
+            };
+            animate: {
+                rotate: number;
+                x1: number;
+                y1: number;
+                x2: number;
+                y2: number;
+                transition: {
+                    ease: "easeInOut";
+                    duration: number;
+                };
+            };
+        };
+    };
+};
+/** Renders Animate UI's original x icon.
+ * @param props - Upstream SVG presentation and playback controls.
+ * @returns The original vector artwork and animation.
+ */
+export declare function X(props: XProps): import("react").JSX.Element;
+export {};

package/dist/components/icons/x/index.js

@@ -0,0 +1,87 @@
+/**
+ * Provides Animate UI's original x icon from the official registry.
+ *
+ * Preserves upstream rendering, variants, timing and easing without motion overrides.
+ *
+ * Follow README.md when updating registry sources; retain the adjacent license notices.
+ */
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { motion } from 'motion/react';
+import { useIconReducedMotion } from '../reduced-motion.js';
+import { getVariants, useAnimateIconContext, IconWrapper, } from '@animate-ui/react/icons';
+const animations = {
+    default: {
+        line1: {
+            initial: {
+                rotate: 0,
+                transition: { ease: 'easeInOut', duration: 0.4 },
+            },
+            animate: {
+                rotate: 90,
+                transition: { ease: 'easeInOut', duration: 0.4 },
+            },
+        },
+        line2: {
+            initial: {
+                rotate: 0,
+                transition: { ease: 'easeInOut', duration: 0.4, delay: 0.1 },
+            },
+            animate: {
+                rotate: 90,
+                transition: { ease: 'easeInOut', duration: 0.4, delay: 0.1 },
+            },
+        },
+    },
+    plus: {
+        line1: {
+            initial: {
+                rotate: 0,
+                x1: 6,
+                y1: 18,
+                x2: 18,
+                y2: 6,
+                transition: { ease: 'easeInOut', duration: 0.3, delay: 0.1 },
+            },
+            animate: {
+                rotate: 45,
+                x1: 7.1,
+                y1: 16.9,
+                x2: 16.9,
+                y2: 7.1,
+                transition: { ease: 'easeInOut', duration: 0.3, delay: 0.1 },
+            },
+        },
+        line2: {
+            initial: {
+                rotate: 0,
+                x1: 6,
+                y1: 6,
+                x2: 18,
+                y2: 18,
+                transition: { ease: 'easeInOut', duration: 0.3 },
+            },
+            animate: {
+                rotate: 45,
+                x1: 7.1,
+                y1: 7.1,
+                x2: 16.9,
+                y2: 16.9,
+                transition: { ease: 'easeInOut', duration: 0.3 },
+            },
+        },
+    },
+};
+function IconComponent({ size, ...props }) {
+    const { controls } = useAnimateIconContext();
+    const reduced = useIconReducedMotion();
+    const variants = getVariants(animations);
+    return (_jsxs(motion.svg, { xmlns: "http://www.w3.org/2000/svg", width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", ...props, children: [_jsx(motion.line, { x1: 6, y1: 18, x2: 18, y2: 6, variants: variants.line1, initial: "initial", animate: reduced ? 'initial' : controls }), _jsx(motion.line, { x1: 6, y1: 6, x2: 18, y2: 18, variants: variants.line2, initial: "initial", animate: reduced ? 'initial' : controls })] }, reduced ? 'static' : 'animated'));
+}
+/** Renders Animate UI's original x icon.
+ * @param props - Upstream SVG presentation and playback controls.
+ * @returns The original vector artwork and animation.
+ */
+export function X(props) {
+    return _jsx(IconWrapper, { icon: IconComponent, ...props });
+}

package/dist/components/release-markdown/index.d.ts

@@ -0,0 +1,22 @@
+import { type Release } from '../../api.js';
+/** Properties owned by the restricted Markdown renderer. */
+export interface ReleaseMarkdownProps {
+    projectId: string;
+    /** Project owning managed images. */
+    release: Release;
+    /** Validated public document. */
+    openExternal?: (url: string) => void | Promise<void>; /**
+     * Optional native HTTP(S) opener.
+     * @param url - Safe external destination.
+     * @returns Completion of the opening request.
+     */
+}
+/**
+ * Displays full safe release Markdown, including the editor's image dimensions.
+ * @param props - Validated document and image ownership.
+ * @param props.projectId - Project owning managed images.
+ * @param props.release - Validated complete release.
+ * @param props.openExternal - Optional native link opener.
+ * @returns Sanitized document elements with no executable HTML.
+ */
+export declare function ReleaseMarkdown({ projectId, release, openExternal, }: ReleaseMarkdownProps): import("react").JSX.Element;

package/dist/components/release-markdown/index.js

@@ -0,0 +1,101 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Renders untrusted release Markdown with a restricted HTML schema.
+ *
+ * Owns GFM, safe links, release-scoped images and editor image dimensions.
+ *
+ * Extend the explicit allowlist only after adding an adversarial rendering test.
+ */
+import Markdown from 'react-markdown';
+import remarkGfm from 'remark-gfm';
+import rehypeRaw from 'rehype-raw';
+import rehypeSanitize from 'rehype-sanitize';
+import { releaseImageUrl, safeHttpUrl } from '../../api.js';
+const schema = {
+    tagNames: [
+        'p',
+        'br',
+        'h1',
+        'h2',
+        'h3',
+        'h4',
+        'h5',
+        'h6',
+        'strong',
+        'em',
+        'del',
+        'blockquote',
+        'ul',
+        'ol',
+        'li',
+        'hr',
+        'pre',
+        'code',
+        'a',
+        'img',
+        'table',
+        'thead',
+        'tbody',
+        'tr',
+        'th',
+        'td',
+        'input',
+    ],
+    attributes: {
+        a: ['href', 'title'],
+        img: ['src', 'alt', 'title', 'width', 'height'],
+        ol: ['start'],
+        li: ['className'],
+        code: ['className'],
+        th: ['align'],
+        td: ['align'],
+        input: ['type', 'checked', 'disabled'],
+    },
+    protocols: { href: ['http', 'https'], src: ['http', 'https'] },
+    required: { input: { type: 'checkbox', disabled: true } },
+    clobberPrefix: 'fl-notes-',
+    strip: [
+        'script',
+        'style',
+        'iframe',
+        'object',
+        'embed',
+        'form',
+        'svg',
+        'math',
+    ],
+};
+/**
+ * Displays full safe release Markdown, including the editor's image dimensions.
+ * @param props - Validated document and image ownership.
+ * @param props.projectId - Project owning managed images.
+ * @param props.release - Validated complete release.
+ * @param props.openExternal - Optional native link opener.
+ * @returns Sanitized document elements with no executable HTML.
+ */
+export function ReleaseMarkdown({ projectId, release, openExternal, }) {
+    return (_jsx("div", { className: "fl-notes-markdown", children: _jsx(Markdown, { remarkPlugins: [remarkGfm], rehypePlugins: [rehypeRaw, [rehypeSanitize, schema]], urlTransform: (value, key) => key === 'src'
+                ? releaseImageUrl(projectId, release.id, value)
+                : safeHttpUrl(value), components: {
+                a({ href, children, title }) {
+                    return (_jsx("a", { href: href, title: title, target: "_blank", rel: "noopener noreferrer", onClick: openExternal && href
+                            ? (event) => {
+                                event.preventDefault();
+                                void openExternal(href);
+                            }
+                            : undefined, children: children }));
+                },
+                img({ src, alt, title, width, height }) {
+                    const safe = typeof src === 'string' ? safeHttpUrl(src) : undefined;
+                    if (!safe)
+                        return alt ? _jsx("span", { children: alt }) : null;
+                    const dimension = (value) => {
+                        const number = Number(value);
+                        return Number.isInteger(number) && number > 0 && number <= 10000
+                            ? number
+                            : undefined;
+                    };
+                    return (_jsx("img", { src: safe, alt: alt ?? '', title: title, width: dimension(width), height: dimension(height), loading: "lazy", referrerPolicy: "no-referrer" }));
+                },
+            }, children: release.markdown }) }));
+}

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

@@ -0,0 +1,51 @@
+import { type Release } from '../../api.js';
+import { type ReleaseNotesReaderOptions } from '../../connectors/use-release-note-list-connector.js';
+/** Public browser reader configuration. */
+export interface ReleaseNotesProps extends ReleaseNotesReaderOptions {
+    theme?: 'system' | 'light' | 'dark';
+    /** Reader color scheme; system follows the operating system. */
+    onReleaseRendered?: (release: Release, state: {
+        cached: boolean;
+    }) => void; /**
+     * Reports an exact note mounted in the reader.
+     * @param release - The rendered document.
+     * @param release.id - Stable public release identifier.
+     * @param release.version - Optional exact application version.
+     * @param release.title - Human-readable title.
+     * @param release.excerpt - Optional plain-text preview.
+     * @param release.previewImageSource - Optional preview image source.
+     * @param release.markdown - Complete release document.
+     * @param release.date - Publication calendar date.
+     * @param release.url - Public article URL.
+     * @param state - Whether the document came from offline storage.
+     * @param state.cached - True for an offline copy.
+     * @returns Nothing.
+     */
+    openExternal?: (url: string) => void | Promise<void>; /**
+     * Optional HTTP(S) link opener.
+     * @param url - Safe destination.
+     * @returns Opening completion.
+     */
+}
+/**
+ * Renders published project notes without providers, keys or native dependencies.
+ * @param props - Public project, initial exact version and color scheme.
+ * @param props.projectId - Public project identifier.
+ * @param props.version - Optional exact semantic version.
+ * @param props.theme - Reader color scheme.
+ * @param props.onReleaseRendered - Confirms an exact note mounted in the reader.
+ * @param props.openExternal - Optional safe HTTP(S) link opener.
+ * @returns A self-contained anonymous release-note reader.
+ */
+export declare function ReleaseNotes(props: ReleaseNotesProps): import("react").JSX.Element;
+/**
+ * Shares reader content with optional native window adapters.
+ * @param props - Public reader properties and optional presentation callbacks.
+ * @param props.projectId - Public project identifier.
+ * @param props.version - Optional exact semantic version.
+ * @param props.theme - Reader color scheme.
+ * @param props.onReleaseRendered - Optional exact-note render confirmation.
+ * @param props.openExternal - Optional native link opener.
+ * @returns The complete accessible release reader.
+ */
+export declare function ReleaseNotesReader({ projectId, version, theme, onReleaseRendered, openExternal, }: ReleaseNotesProps): import("react").JSX.Element;

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

@@ -0,0 +1,89 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Displays the version-first anonymous release reader.
+ *
+ * Owns exact-version navigation, display states and native render confirmation.
+ *
+ * Keep data loading in the reader connector and external links restricted to HTTP(S).
+ */
+import { useEffect, useRef, useState } from 'react';
+import { normalizeReleaseVersion, releaseProjectUrl, safeHttpUrl, } from '../../api.js';
+import { useReleaseNoteListConnector, } from '../../connectors/use-release-note-list-connector.js';
+import { ReleaseMarkdown } from '../release-markdown/index.js';
+/**
+ * Renders published project notes without providers, keys or native dependencies.
+ * @param props - Public project, initial exact version and color scheme.
+ * @param props.projectId - Public project identifier.
+ * @param props.version - Optional exact semantic version.
+ * @param props.theme - Reader color scheme.
+ * @param props.onReleaseRendered - Confirms an exact note mounted in the reader.
+ * @param props.openExternal - Optional safe HTTP(S) link opener.
+ * @returns A self-contained anonymous release-note reader.
+ */
+export function ReleaseNotes(props) {
+    return _jsx(ReleaseNotesReader, { ...props });
+}
+/**
+ * Shares reader content with optional native window adapters.
+ * @param props - Public reader properties and optional presentation callbacks.
+ * @param props.projectId - Public project identifier.
+ * @param props.version - Optional exact semantic version.
+ * @param props.theme - Reader color scheme.
+ * @param props.onReleaseRendered - Optional exact-note render confirmation.
+ * @param props.openExternal - Optional native link opener.
+ * @returns The complete accessible release reader.
+ */
+export function ReleaseNotesReader({ projectId, version, theme = 'system', onReleaseRendered, openExternal, }) {
+    let normalizedVersion = version?.trim();
+    if (version !== undefined) {
+        try {
+            normalizedVersion = normalizeReleaseVersion(version);
+        }
+        catch {
+            /* Request reports invalid versions through the reader error state. */
+        }
+    }
+    const [historyFor, setHistoryFor] = useState(null);
+    const inputIdentity = JSON.stringify([projectId, normalizedVersion ?? null]);
+    const requestedVersion = historyFor === inputIdentity ? undefined : normalizedVersion;
+    const { loadMore, retry, ...current } = useReleaseNoteListConnector({
+        projectId,
+        version: requestedVersion,
+    });
+    const renderCallback = useRef(onReleaseRendered);
+    renderCallback.current = onReleaseRendered;
+    useEffect(() => {
+        if (requestedVersion &&
+            !current.loading &&
+            current.page?.items.length === 1) {
+            renderCallback.current?.(current.page.items[0], {
+                cached: current.cached,
+            });
+        }
+    }, [
+        projectId,
+        requestedVersion,
+        current.page,
+        current.loading,
+        current.cached,
+    ]);
+    function externalClick(event) {
+        if (openExternal) {
+            event.preventDefault();
+            void openExternal(event.currentTarget.href);
+        }
+    }
+    const fallback = current.page?.items[0]?.url ?? releaseProjectUrl(projectId);
+    return (_jsxs("section", { className: "fl-release-notes", "data-theme": theme, "aria-label": "Release notes", "aria-busy": current.loading || current.loadingMore, children: [requestedVersion !== undefined && (_jsx("button", { className: "fl-notes-button fl-notes-back", onClick: () => setHistoryFor(inputIdentity), children: "\u2190 All versions" })), current.loading && (_jsxs("div", { className: "fl-notes-status", role: "status", children: [_jsx("h2", { children: "Loading release notes\u2026" }), _jsx("p", { children: "The latest published notes will appear here." })] })), !current.loading && current.cached && (_jsx("p", { className: "fl-notes-notice", role: "status", children: "You\u2019re viewing a saved copy. Connect to load the latest notes." })), !current.loading && current.error && !current.cached && (_jsxs("div", { className: "fl-notes-status", role: "alert", children: [_jsx("h2", { children: current.unavailable
+                            ? 'Release notes unavailable'
+                            : 'Couldn’t load release notes' }), _jsx("p", { children: current.unavailable
+                            ? 'This project or version is not available.'
+                            : 'Check your connection and try again.' })] })), !current.loading &&
+                !current.error &&
+                current.page?.items.length === 0 && (_jsxs("div", { className: "fl-notes-status", children: [_jsx("h2", { children: "No release notes yet" }), _jsx("p", { children: requestedVersion
+                            ? 'No published notes match this version.'
+                            : 'Published updates will appear here.' })] })), current.page?.items.map((release) => (_jsxs("article", { className: "fl-notes-release", children: [_jsxs("header", { className: "fl-notes-heading", children: [_jsx("h2", { children: release.version ?? release.title }), _jsx("time", { dateTime: release.date, children: new Intl.DateTimeFormat(undefined, {
+                                    dateStyle: 'long',
+                                    timeZone: 'UTC',
+                                }).format(new Date(`${release.date}T12:00:00Z`)) })] }), release.version && release.title !== release.version && (_jsx("h3", { className: "fl-notes-title", children: release.title })), _jsx(ReleaseMarkdown, { projectId: projectId, release: release, openExternal: openExternal })] }, release.id))), !current.loading && (_jsxs("footer", { className: "fl-notes-footer", children: [current.error && !current.unavailable && !current.cached && (_jsx("button", { className: "fl-notes-button", onClick: retry, children: "Try again" })), !current.cached && current.page?.nextCursor && !current.error && (_jsx("button", { className: "fl-notes-button", disabled: current.loadingMore, onClick: () => void loadMore(), children: current.loadingMore ? 'Loading…' : 'Load more' })), safeHttpUrl(fallback) && (_jsx("a", { href: fallback, target: "_blank", rel: "noopener noreferrer", onClick: externalClick, children: "View on the web \u2197" })), current.cached && (_jsx("button", { className: "fl-notes-button", onClick: retry, children: "Try again" }))] }))] }));
+}

package/dist/connectors/use-release-note-list-connector.d.ts

@@ -0,0 +1,24 @@
+import { type ReleasePage } from '../api.js';
+/** Public reader data configuration; navigation remains app-owned. */
+export interface ReleaseNotesReaderOptions {
+    projectId: string;
+    /** Public project identifier. */
+    version?: string;
+}
+/**
+ * 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 declare function useReleaseNoteListConnector({ projectId, version, }: ReleaseNotesReaderOptions): {
+    page: ReleasePage | undefined;
+    loading: boolean;
+    loadingMore: boolean;
+    cached: boolean;
+    error: boolean;
+    unavailable: boolean;
+    loadMore: () => Promise<void> | undefined;
+    retry: () => void;
+};