@makershq/react 0.0.0-stage → 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maker’s HQ contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,57 @@
-# Temporary Holding Version
+# @makershq/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Add Maker’s HQ release notes and update notifications to your React app.
+
+- Embed a release history or a specific app version.
+- Notify website visitors when a new deployment is ready.
+- Build custom UI with hooks and a safe Markdown renderer.
+- Integrate with Tauri using native windows or your own UI.
+
+## Installation
+
+Requires React 19.
+
+```sh
+npm install @makershq/react
+```
+
+Or with pnpm:
+
+```sh
+pnpm add @makershq/react
+```
+
+## Quickstart
+
+```tsx
+import { ReleaseNotes } from '@makershq/react'
+import '@makershq/react/styles.css'
+
+export default function App() {
+  return (
+    <main>
+      <h1>What's new</h1>
+      <ReleaseNotes projectId="YOUR_PROJECT_ID" theme="system" />
+    </main>
+  )
+}
+```
+
+Find your public project ID in **Release notes → Add to app** in Maker’s HQ. No API key or authentication provider is required.
+
+Omit `version` to show the full history, or pass `version="1.2.3"` to open a specific release. Import the stylesheet once; it inherits your app's font and color variables.
+
+For default Tauri native windows, give only the main host `core:window:allow-set-theme` and pass the app’s Light, Dark or System preference through `theme`. Native title bars and content update together. Headless mode leaves native appearance to your app and requires no SDK theme permission.
+
+## Documentation
+
+- [React reader](https://docs.makershq.dev/integrations/release-notes/react#embedded-release-reader)
+- [Website update notifications](https://docs.makershq.dev/integrations/release-notes/react)
+- [Custom UI](https://docs.makershq.dev/integrations/release-notes/react#custom-ui)
+- [Tauri integration](https://docs.makershq.dev/integrations/release-notes/tauri)
+- [Headless Tauri UI](https://docs.makershq.dev/integrations/release-notes/tauri#headless-tauri-ui)
+- [HTTP API](https://docs.makershq.dev/integrations/release-notes/http-api)
+
+## License
+
+[MIT](https://opensource.org/license/mit). Third-party notices are included in `THIRD_PARTY_NOTICES.md` in the installed package.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,77 @@
+# Third-party notices
+
+The SDK uses Animate UI icon implementations and original Lucide/Feather artwork privately within its release interfaces. Their licenses remain applicable to those portions; the SDK’s MIT license covers its own code.
+
+## Animate UI icon source
+
+MIT + Commons Clause License Condition
+
+Copyright (c) 2025 Elliot Sutton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, and distribute the Software **as part of an application, website, or product**, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+## Commons Clause Restriction
+
+You may use this Software, including for any commercial purpose, **so long as you do not sell or redistribute the components themselves in their original form—whether alone or in a bundle.**
+
+## No Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## Lucide and Feather artwork
+
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+The following Lucide icons are derived from the Feather project:
+
+airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2013-present Cole Bemis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/api.d.ts

@@ -0,0 +1,82 @@
+/** A published release returned by the anonymous API. */
+export interface Release {
+    id: string;
+    /** Stable public release identifier. */
+    version: string | null;
+    /** Optional exact application version. */
+    title: string;
+    /** Human-readable title. */
+    excerpt?: string;
+    /** Optional plain-text preview, at most 240 Unicode characters. */
+    previewImageSource?: string | null;
+    /** Optional managed or safe HTTP(S) image source; null when no preview is available. */
+    markdown: string;
+    /** Complete release document, including managed image references. */
+    date: string;
+    /** Calendar publication date in YYYY-MM-DD form. */
+    url: string;
+}
+/** A publication-ordered page of at most ten releases. */
+export interface ReleasePage {
+    items: Release[];
+    /** Published notes, newest publication first. */
+    nextCursor: string | null;
+}
+/** Signals an authoritative unavailable project. */
+export declare class ReleaseUnavailableError extends Error {
+    /** Creates a safe unavailable error without exposing gateway details. */
+    constructor();
+}
+/**
+ * Builds a canonical anonymous project timeline URL.
+ * @param projectId - Public project identifier.
+ * @returns An encoded public timeline URL.
+ */
+export declare function releaseProjectUrl(projectId: string): string;
+/**
+ * Accepts only explicit HTTP(S) destinations.
+ * @param value - Untrusted Markdown or API URL.
+ * @returns A normalized safe URL, or undefined for unsafe destinations.
+ */
+export declare function safeHttpUrl(value: string): string | undefined;
+/**
+ * Resolves private image references through the release-scoped public gateway.
+ * @param projectId - Public project identifier.
+ * @param releaseId - Release which owns the image.
+ * @param source - Untrusted Markdown image source.
+ * @returns A managed gateway URL or a safe external image URL.
+ */
+export declare function releaseImageUrl(projectId: string, releaseId: string, source: string): string | undefined;
+/**
+ * Parses an untrusted HTTP response before it reaches renderers or storage.
+ * @param value - JSON obtained from the gateway or local cache.
+ * @returns A fresh validated release page.
+ * @throws Error when the payload violates the bounded public contract.
+ */
+export declare function parseReleasePage(value: unknown): ReleasePage;
+/** Options for one anonymous request. */
+export interface FetchReleasePageOptions {
+    version?: string;
+    /** Exact application version; mutually exclusive with cursor. */
+    cursor?: string;
+    /** Opaque continuation token from a previous page. */
+    signal?: AbortSignal;
+}
+/**
+ * Canonicalizes a strict semantic version while retaining build metadata.
+ * @param value - Consumer or server version string.
+ * @returns Canonical exact version, including prerelease and build identifiers.
+ * @throws Error when the version is not valid semantic version syntax.
+ */
+export declare function normalizeReleaseVersion(value: string): string;
+/**
+ * Requests one validated page without credentials or customer configuration.
+ * @param projectId - Public project identifier.
+ * @param options - Exact version or continuation and cancellation signal.
+ * @param options.version - Optional exact semantic version.
+ * @param options.cursor - Optional opaque pagination cursor.
+ * @param options.signal - Optional cancellation signal.
+ * @returns A publication-ordered validated page.
+ * @throws ReleaseUnavailableError on authoritative 404; Error on other failures.
+ */
+export declare function fetchReleasePage(projectId: string, options?: FetchReleasePageOptions): Promise<ReleasePage>;

package/dist/api.js

@@ -0,0 +1,183 @@
+/**
+ * Defines and validates the anonymous release-note HTTP contract.
+ *
+ * Owns fixed-origin requests, safe public links and managed image addressing.
+ *
+ * Keep this wire contract compatible with the gateway when extending fields.
+ */
+import { SemVer, valid } from 'semver';
+const origin = 'https://makershq.dev';
+const managedImageSourcePattern = /^\.\/images\/[a-zA-Z0-9_-]+$/;
+/** Signals an authoritative unavailable project. */
+export class ReleaseUnavailableError extends Error {
+    /** Creates a safe unavailable error without exposing gateway details. */
+    constructor() {
+        super('These release notes are unavailable.');
+        this.name = 'ReleaseUnavailableError';
+    }
+}
+/**
+ * Builds a canonical anonymous project timeline URL.
+ * @param projectId - Public project identifier.
+ * @returns An encoded public timeline URL.
+ */
+export function releaseProjectUrl(projectId) {
+    return `${origin}/p/${encodeURIComponent(projectId)}/release-notes`;
+}
+/**
+ * Accepts only explicit HTTP(S) destinations.
+ * @param value - Untrusted Markdown or API URL.
+ * @returns A normalized safe URL, or undefined for unsafe destinations.
+ */
+export function safeHttpUrl(value) {
+    try {
+        const parsed = new URL(value);
+        return ['https:', 'http:'].includes(parsed.protocol) &&
+            !parsed.username &&
+            !parsed.password
+            ? parsed.href
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolves private image references through the release-scoped public gateway.
+ * @param projectId - Public project identifier.
+ * @param releaseId - Release which owns the image.
+ * @param source - Untrusted Markdown image source.
+ * @returns A managed gateway URL or a safe external image URL.
+ */
+export function releaseImageUrl(projectId, releaseId, source) {
+    if (managedImageSourcePattern.test(source)) {
+        return `${origin}/api/v1/projects/${encodeURIComponent(projectId)}/releases/${encodeURIComponent(releaseId)}/image?source=${encodeURIComponent(source)}`;
+    }
+    return safeHttpUrl(source);
+}
+/**
+ * Parses an untrusted HTTP response before it reaches renderers or storage.
+ * @param value - JSON obtained from the gateway or local cache.
+ * @returns A fresh validated release page.
+ * @throws Error when the payload violates the bounded public contract.
+ */
+export function parseReleasePage(value) {
+    if (!value || typeof value !== 'object')
+        throw new Error('Invalid release notes response.');
+    const page = value;
+    if (!Array.isArray(page.items) ||
+        page.items.length > 10 ||
+        !(page.nextCursor === null || typeof page.nextCursor === 'string') ||
+        (typeof page.nextCursor === 'string' && page.nextCursor.length > 4096))
+        throw new Error('Invalid release notes response.');
+    const items = page.items.map((item) => {
+        if (!item || typeof item !== 'object')
+            throw new Error('Invalid release note.');
+        const release = item;
+        if (typeof release.id !== 'string' ||
+            !release.id ||
+            release.id.length > 512 ||
+            !(release.version === null ||
+                (typeof release.version === 'string' && release.version.length <= 256)) ||
+            typeof release.title !== 'string' ||
+            release.title.length > 1000 ||
+            typeof release.markdown !== 'string' ||
+            release.markdown.length > 500000 ||
+            typeof release.date !== 'string' ||
+            !/^\d{4}-\d{2}-\d{2}$/.test(release.date) ||
+            Number.isNaN(Date.parse(`${release.date}T12:00:00Z`)) ||
+            new Date(`${release.date}T12:00:00Z`).toISOString().slice(0, 10) !==
+                release.date ||
+            typeof release.url !== 'string' ||
+            !safeHttpUrl(release.url) ||
+            (release.excerpt !== undefined &&
+                (typeof release.excerpt !== 'string' ||
+                    [...release.excerpt].length > 240)) ||
+            (release.previewImageSource !== undefined &&
+                release.previewImageSource !== null &&
+                (typeof release.previewImageSource !== 'string' ||
+                    release.previewImageSource.length > 2048)))
+            throw new Error('Invalid release note.');
+        return {
+            id: release.id,
+            version: release.version,
+            title: release.title,
+            ...(release.excerpt === undefined ? {} : { excerpt: release.excerpt }),
+            ...(release.previewImageSource === undefined
+                ? {}
+                : {
+                    previewImageSource: release.previewImageSource !== null &&
+                        (managedImageSourcePattern.test(release.previewImageSource) ||
+                            safeHttpUrl(release.previewImageSource))
+                        ? release.previewImageSource
+                        : null,
+                }),
+            markdown: release.markdown,
+            date: release.date,
+            url: release.url,
+        };
+    });
+    if (new Set(items.map((item) => item.id)).size !== items.length)
+        throw new Error('Invalid release notes response.');
+    return { items, nextCursor: page.nextCursor };
+}
+/**
+ * Canonicalizes a strict semantic version while retaining build metadata.
+ * @param value - Consumer or server version string.
+ * @returns Canonical exact version, including prerelease and build identifiers.
+ * @throws Error when the version is not valid semantic version syntax.
+ */
+export function normalizeReleaseVersion(value) {
+    if (!valid(value.trim()))
+        throw new Error('A valid semantic version is required.');
+    const version = new SemVer(value.trim());
+    return (version.version +
+        (version.build.length ? `+${version.build.join('.')}` : ''));
+}
+/**
+ * Requests one validated page without credentials or customer configuration.
+ * @param projectId - Public project identifier.
+ * @param options - Exact version or continuation and cancellation signal.
+ * @param options.version - Optional exact semantic version.
+ * @param options.cursor - Optional opaque pagination cursor.
+ * @param options.signal - Optional cancellation signal.
+ * @returns A publication-ordered validated page.
+ * @throws ReleaseUnavailableError on authoritative 404; Error on other failures.
+ */
+export async function fetchReleasePage(projectId, options = {}) {
+    if (options.version !== undefined && options.cursor !== undefined)
+        throw new Error('Version and cursor cannot be combined.');
+    const exactVersion = options.version === undefined
+        ? undefined
+        : normalizeReleaseVersion(options.version);
+    if (!projectId.trim() || projectId.length > 512)
+        throw new Error('A project ID is required.');
+    const url = new URL(`${origin}/api/v1/projects/${encodeURIComponent(projectId)}/releases`);
+    if (options.version !== undefined)
+        url.searchParams.set('version', exactVersion);
+    else if (options.cursor)
+        url.searchParams.set('cursor', options.cursor);
+    const response = await fetch(url, {
+        credentials: 'omit',
+        cache: 'no-store',
+        signal: options.signal,
+        headers: { Accept: 'application/json' },
+    });
+    if (response.status === 404)
+        throw new ReleaseUnavailableError();
+    if (!response.ok)
+        throw new Error('Release notes could not be loaded.');
+    const contentLength = Number(response.headers.get('content-length'));
+    if (contentLength > 6000000)
+        throw new Error('Release notes response is too large.');
+    const body = await response.text();
+    if (body.length > 6000000)
+        throw new Error('Release notes response is too large.');
+    const page = parseReleasePage(JSON.parse(body));
+    if (options.version !== undefined &&
+        (page.items.length > 1 ||
+            page.items.some((release) => release.version !== exactVersion) ||
+            page.nextCursor !== null))
+        throw new Error('Invalid exact-version release response.');
+    return page;
+}

package/dist/cache.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Stores a small best-effort offline copy of recently viewed public notes.
+ *
+ * Owns bounded, project-and-version-isolated local storage and invalidation.
+ *
+ * Keep storage optional and never allow cached data to override a server 404.
+ */
+import { type ReleasePage } from './api.js';
+/**
+ * Reads one isolated offline snapshot.
+ * @param projectId - Public project identifier.
+ * @param version - Exact application version, or full-history first page.
+ * @returns Validated saved notes, when available.
+ */
+export declare function readReleaseCache(projectId: string, version?: string): ReleasePage | undefined;
+/**
+ * Replaces one snapshot or invalidates every cached view of an unavailable project.
+ * @param projectId - Public project identifier.
+ * @param version - Exact requested version, or history.
+ * @param page - Validated first page; null removes all cached views for this project.
+ */
+export declare function writeReleaseCache(projectId: string, version: string | undefined, page: ReleasePage | null): void;

package/dist/cache.js

@@ -0,0 +1,86 @@
+/**
+ * Stores a small best-effort offline copy of recently viewed public notes.
+ *
+ * Owns bounded, project-and-version-isolated local storage and invalidation.
+ *
+ * Keep storage optional and never allow cached data to override a server 404.
+ */
+import { parseReleasePage } from './api.js';
+const key = 'makershq.release-notes.v1';
+const maxEntries = 5;
+const maxBytes = 1000000;
+function cacheKey(projectId, version) {
+    return JSON.stringify([projectId, version?.trim() ?? null]);
+}
+function entries() {
+    try {
+        const raw = localStorage.getItem(key);
+        if (!raw ||
+            raw.length > maxBytes ||
+            new TextEncoder().encode(raw).length > maxBytes)
+            return [];
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.slice(0, maxEntries).flatMap((item) => {
+            if (!item || typeof item !== 'object')
+                return [];
+            const entry = item;
+            if (typeof entry.key !== 'string')
+                return [];
+            try {
+                return [
+                    {
+                        key: entry.key,
+                        page: parseReleasePage(entry.page),
+                    },
+                ];
+            }
+            catch {
+                return [];
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Reads one isolated offline snapshot.
+ * @param projectId - Public project identifier.
+ * @param version - Exact application version, or full-history first page.
+ * @returns Validated saved notes, when available.
+ */
+export function readReleaseCache(projectId, version) {
+    const page = entries().find((entry) => entry.key === cacheKey(projectId, version))?.page;
+    if (version !== undefined &&
+        page?.items.some((release) => release.version !== version.trim()))
+        return undefined;
+    return page;
+}
+/**
+ * Replaces one snapshot or invalidates every cached view of an unavailable project.
+ * @param projectId - Public project identifier.
+ * @param version - Exact requested version, or history.
+ * @param page - Validated first page; null removes all cached views for this project.
+ */
+export function writeReleaseCache(projectId, version, page) {
+    try {
+        const id = cacheKey(projectId, version);
+        const retained = entries().filter((entry) => page
+            ? entry.key !== id
+            : !entry.key.startsWith(JSON.stringify([projectId]).slice(0, -1) + ','));
+        if (page)
+            retained.unshift({ key: id, page });
+        let serialized = JSON.stringify(retained.slice(0, maxEntries));
+        while (new TextEncoder().encode(serialized).length > maxBytes &&
+            retained.length) {
+            retained.pop();
+            serialized = JSON.stringify(retained);
+        }
+        localStorage.setItem(key, serialized);
+    }
+    catch {
+        /* Storage denial must not prevent reading public notes. */
+    }
+}

package/dist/components/icons/external-link/index.d.ts

@@ -0,0 +1,52 @@
+import { type IconProps } from '@animate-ui/react/icons';
+type ExternalLinkProps = IconProps<keyof typeof animations>;
+declare const animations: {
+    readonly default: {
+        group: {
+            initial: {
+                x: number;
+                y: number;
+                transition: {
+                    duration: number;
+                    ease: "easeInOut";
+                };
+            };
+            animate: {
+                x: number;
+                y: number;
+                transition: {
+                    duration: number;
+                    ease: "easeInOut";
+                };
+            };
+        };
+        path1: {};
+        path2: {};
+        path3: {};
+    };
+    readonly 'default-loop': {
+        group: {
+            initial: {
+                x: number;
+                y: number;
+            };
+            animate: {
+                x: number[];
+                y: number[];
+                transition: {
+                    duration: number;
+                    ease: "easeInOut";
+                };
+            };
+        };
+        path1: {};
+        path2: {};
+        path3: {};
+    };
+};
+/** Renders Animate UI's original external-link icon.
+ * @param props - Upstream SVG presentation and playback controls.
+ * @returns The original vector artwork and animation.
+ */
+export declare function ExternalLink(props: ExternalLinkProps): import("react").JSX.Element;
+export {};

package/dist/components/icons/external-link/index.js

@@ -0,0 +1,60 @@
+/**
+ * Provides Animate UI's original external-link 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: {
+        group: {
+            initial: {
+                x: 0,
+                y: 0,
+                transition: { duration: 0.3, ease: 'easeInOut' },
+            },
+            animate: {
+                x: 2,
+                y: -2,
+                transition: { duration: 0.3, ease: 'easeInOut' },
+            },
+        },
+        path1: {},
+        path2: {},
+        path3: {},
+    },
+    'default-loop': {
+        group: {
+            initial: {
+                x: 0,
+                y: 0,
+            },
+            animate: {
+                x: [0, 2, 0],
+                y: [0, -2, 0],
+                transition: { duration: 0.6, ease: 'easeInOut' },
+            },
+        },
+        path1: {},
+        path2: {},
+        path3: {},
+    },
+};
+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: [_jsxs(motion.g, { variants: variants.group, initial: "initial", animate: reduced ? 'initial' : controls, children: [_jsx(motion.path, { d: "M15 3h6v6", variants: variants.path1, initial: "initial", animate: reduced ? 'initial' : controls }), _jsx(motion.path, { d: "M10 14 21 3", variants: variants.path2, initial: "initial", animate: reduced ? 'initial' : controls })] }), _jsx(motion.path, { d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6", variants: variants.path3, initial: "initial", animate: reduced ? 'initial' : controls })] }, reduced ? 'static' : 'animated'));
+}
+/** Renders Animate UI's original external-link icon.
+ * @param props - Upstream SVG presentation and playback controls.
+ * @returns The original vector artwork and animation.
+ */
+export function ExternalLink(props) {
+    return _jsx(IconWrapper, { icon: IconComponent, ...props });
+}