nostr-components 0.2.0

package/dist/nostr-dm.d.ts

@@ -0,0 +1,4 @@
+export {}
+import _default from './src/nostr-dm/nostr-dm'
+export default _default
+export {}

package/dist/nostr-follow-button.d.ts

@@ -0,0 +1,4 @@
+export {}
+import _default from './src/nostr-follow-button/nostr-follow-button'
+export default _default
+export {}

package/dist/nostr-like.d.ts

@@ -0,0 +1,4 @@
+export {}
+import _default from './src/nostr-like/nostr-like'
+export default _default
+export {}

package/dist/nostr-live-chat.d.ts

@@ -0,0 +1,4 @@
+export {}
+import _default from './src/nostr-live-chat/nostr-live-chat'
+export default _default
+export {}

package/dist/nostr-post.d.ts

@@ -0,0 +1,4 @@
+export {}
+import _default from './src/nostr-post/nostr-post'
+export default _default
+export {}

package/dist/nostr-profile-badge.d.ts

@@ -0,0 +1,4 @@
+export {}
+import _default from './src/nostr-profile-badge/nostr-profile-badge'
+export default _default
+export {}

package/dist/nostr-profile.d.ts

@@ -0,0 +1,4 @@
+export {}
+import _default from './src/nostr-profile/nostr-profile'
+export default _default
+export {}

package/dist/nostr-zap.d.ts

@@ -0,0 +1,4 @@
+export {}
+import _default from './src/nostr-zap/nostr-zap'
+export default _default
+export {}

package/dist/src/base/base-component/nostr-base-component.d.ts

@@ -0,0 +1,116 @@
+import { NostrService } from '../../common/nostr-service';
+import { Theme } from '../../common/types';
+export declare enum NCStatus {
+    Idle = 0,// 0
+    Loading = 1,// 1
+    Ready = 2,// 2
+    Error = 3
+}
+/**
+ * NostrBaseComponent
+ * ==================
+ * Foundation for all Nostr web components in this library.
+ *
+ * Overview
+ * - Manages relay connectivity via a shared `NostrService`.
+ * - Parses common attributes (`theme`, `relays`) and applies theme.
+ * - Provides a generic status management logic, that is extensible by derived classes.
+ * - Offers small utilities useful to subclasses (event delegation, error snippet).
+ *
+ * Observed attributes
+ * - `data-theme`  — "light" | "dark"
+ * - `relays` — CSV of relay URLs
+ *
+ * Events
+ * - `nc:status` — from base, reflects connection and user/profile loading status
+ *
+ * TODO: Is this class doing too much work? Time to split into smaller components?
+ */
+export declare abstract class NostrBaseComponent extends HTMLElement {
+    protected nostrService: NostrService;
+    protected theme: Theme;
+    protected errorMessage: string;
+    protected nostrReady: Promise<void>;
+    protected nostrReadyResolve?: () => void;
+    protected nostrReadyReject?: (e: unknown) => void;
+    protected conn: {
+        set: (s: NCStatus, e?: string) => void;
+        get: () => NCStatus;
+    };
+    private _statuses;
+    private _overall;
+    private connectSeq;
+    constructor(shadow?: boolean);
+    /** Lifecycle methods */
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** Status map API */
+    protected setStatusFor(key: string, next: NCStatus, error?: string): void;
+    protected getStatusFor(key: string): NCStatus;
+    protected snapshotStatuses(): Record<string, NCStatus>;
+    /** Overall status change hook */
+    protected onStatusChange(_overall: NCStatus): void;
+    /** Hook for subclasses to react when relays are connected */
+    protected onNostrRelaysConnected(): void;
+    protected computeOverall(): NCStatus;
+    /**
+     * Before first channel.set(), the map won't be set and hence get() will return `idle`.
+     * In some cases (or maybe in all cases), this is not ideal.
+     * In UserComponent, 'user' not set and hence returning `idle`, while
+     *  'connect' switched between idle -> loading -> ready
+     * and then
+     *  'user' switches to loading -> ready,
+     * results in loading -> ready -> loading -> ready in profile-badge onStatusChange.
+     *
+     * To avoid this, this function is called from UserComponent constructor,
+     * to set default value as 'loading' without emitting onStatusChange event.
+     *
+     * Makes sense?
+     * Try commenting this function call in UserComponent()
+     * and add a log in ProfileBadge :: onStatusChange. You will get it.
+     */
+    protected initChannelStatus(key: string, status: NCStatus, opts?: {
+        reflectOverall: boolean;
+    }): void;
+    protected channel(key: string): {
+        set: (s: NCStatus, e?: string) => void;
+        get: () => NCStatus;
+    };
+    /** Protected methods */
+    protected validateInputs(): boolean;
+    protected connectToNostr(): Promise<void>;
+    protected ensureNostrConnected(): Promise<void>;
+    protected getRelays(): string[];
+    protected getTheme(): void;
+    /**
+     * Delegate events within shadow DOM.
+     * Example: this.delegateEvent('click', '#npub-copy', (e) => this.copyNpub(e));
+    */
+    protected delegateEvent<K extends keyof HTMLElementEventMap>(type: K, selector: string, handler: (event: HTMLElementEventMap[K]) => void): void;
+    protected addDelegatedListener<K extends keyof HTMLElementEventMap>(type: K, selector: string, handler: (event: HTMLElementEventMap[K]) => void): void;
+    protected renderError(errorMessage: string): string;
+    /**
+     * Updates host element classes based on component status
+     * This is a common pattern used by all components
+     */
+    protected updateHostClasses(): void;
+    /**
+     * Base render method that handles common render logic
+     * Subclasses should override renderContent() instead of render()
+     */
+    protected render(): void;
+    /**
+     * Handles click events with njump.me default action
+     * Creates custom event, dispatches it, and opens njump.me if not prevented
+     */
+    protected handleNjumpClick(eventType: string, detail: any, njumpPath: string): void;
+    /**
+     * Abstract method for component-specific rendering
+     * Must be implemented by subclasses
+     */
+    protected abstract renderContent(): void;
+    /** Private methods */
+    private resetNostrReadyBarrier;
+}

package/dist/src/base/copy-delegation.d.ts

@@ -0,0 +1,5 @@
+interface DelegatedHost {
+    addDelegatedListener(type: string, selector: string, handler: (e: Event) => void): void;
+}
+export declare function attachCopyDelegation(host: DelegatedHost): void;
+export {};

package/dist/src/base/dialog-component/dialog-component.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Base dialog component that extends HTMLElement
+ * Provides common dialog functionality with header, close button, and content area
+ *
+ * Usage:
+ * ```typescript
+ * const dialog = document.createElement('dialog-component');
+ * dialog.setAttribute('header', 'Dialog Title');
+ * dialog.innerHTML = '<p>Your content goes here</p>';
+ * dialog.showModal(); // Don't append to body, just call showModal()
+ * ```
+ *
+ * Features:
+ * - Header with customizable text
+ * - Close button
+ * - Click outside to close
+ * - ESC key to close
+ * - Automatic cleanup on close
+ *
+ * Important: Only one instance of this component should be added to the DOM at any time.
+ * Multiple instances may cause conflicts with event listeners and cleanup behavior.
+ */
+export declare class DialogComponent extends HTMLElement {
+    private dialog;
+    constructor();
+    /**
+     * Observed attributes for the component
+     */
+    static get observedAttributes(): string[];
+    /**
+     * Inject dialog styles into document head
+     * Prevents duplicate injection by checking for existing styles
+     */
+    private injectStyles;
+    /**
+     * Render the dialog
+     */
+    private render;
+    /**
+     * Setup event listeners for closing the dialog
+     */
+    private setupEventListeners;
+    /**
+     * Show the dialog (alias for showModal)
+     */
+    show(): void;
+    /**
+     * Show the dialog as modal
+     */
+    showModal(): void;
+    /**
+     * Close the dialog
+     */
+    close(): void;
+    /**
+     * Cleanup when dialog is closed
+     */
+    private cleanup;
+    /**
+     * Called when component is removed from DOM
+     */
+    disconnectedCallback(): void;
+    /**
+     * Called when observed attributes change
+     */
+    attributeChangedCallback(name: string, _oldValue: string, newValue: string): void;
+}

package/dist/src/base/dialog-component/style.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Base dialog component styles
+ * Provides common styling for all dialog components
+ */
+export declare const getDialogComponentStyles: () => string;

package/dist/src/base/event-component/nostr-event-component.d.ts

@@ -0,0 +1,53 @@
+import { NDKEvent, NDKUser, NDKUserProfile } from '@nostr-dev-kit/ndk';
+import { NostrBaseComponent, NCStatus } from '../base-component/nostr-base-component';
+/**
+ * NostrEventComponent
+ * ==================
+ * Extension of `NostrBaseComponent` that resolves and manages a Nostr Event.
+ *
+ * Overview
+ * - Accepts identity attributes (`hex`, `noteid`, or `eventid`) and validates them.
+ * - Resolves an `NDKEvent` via the shared `nostrService` and fetches the event.
+ * - Exposes resolved `event` to subclasses for rendering or logic.
+ * - Emits lifecycle events for status and event readiness.
+ *
+ * Observed attributes
+ * - `hex`     — raw hex-encoded event ID
+ * - `noteid`  — bech32-encoded event ID starting with 'note1...'
+ * - `eventid` — bech32-encoded event pointer starting with 'nevent1...' (encodes extra metadata)
+ *
+ * Events
+ * - `nc:status` — from base, reflects connection and event loading status
+ * - `nc:event`  — fired when an event is successfully resolved
+ */
+export declare class NostrEventComponent extends NostrBaseComponent {
+    protected event: NDKEvent | null;
+    protected author: NDKUser | null;
+    protected authorProfile: NDKUserProfile | null;
+    protected formattedDate: string;
+    protected eventStatus: {
+        set: (s: NCStatus, e?: string) => void;
+        get: () => NCStatus;
+    };
+    protected authorStatus: {
+        set: (s: NCStatus, e?: string) => void;
+        get: () => NCStatus;
+    };
+    private loadSeq;
+    private eventResolver;
+    private userResolver;
+    constructor(shadow?: boolean);
+    /** Lifecycle methods */
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** Protected methods */
+    protected validateInputs(): boolean;
+    protected resolveEventAndLoad(): Promise<void>;
+    private loadAuthorProfile;
+    private checkEventAndAuthorReady;
+    private formatEventDate;
+    protected renderContent(): void;
+    /** Hook for subclasses to react when event is ready (e.g., render). */
+    protected onEventReady(_event: NDKEvent): void;
+}

package/dist/src/base/render-options.d.ts

@@ -0,0 +1,5 @@
+export interface IRenderOptions {
+    isLoading: boolean;
+    isError: boolean;
+    errorMessage?: string;
+}

package/dist/src/base/resolvers/event-resolver.d.ts

@@ -0,0 +1,20 @@
+import { NDKEvent } from '@nostr-dev-kit/ndk';
+import { NostrService } from '../../common/nostr-service';
+export declare class EventResolver {
+    private nostrService;
+    constructor(nostrService: NostrService);
+    validateInputs({ hex, noteid, eventid }: {
+        hex?: string | null;
+        noteid?: string | null;
+        eventid?: string | null;
+    }): string | null;
+    /**
+     * Normalize bech32 identifiers to hex format
+     */
+    private normalizeToHex;
+    resolveEvent({ hex, noteid, eventid }: {
+        hex?: string | null;
+        noteid?: string | null;
+        eventid?: string | null;
+    }): Promise<NDKEvent>;
+}

package/dist/src/base/resolvers/user-resolver.d.ts

@@ -0,0 +1,19 @@
+import { NDKUser, NDKUserProfile } from '@nostr-dev-kit/ndk';
+import { NostrService } from '../../common/nostr-service';
+export declare class UserResolver {
+    private nostrService;
+    constructor(nostrService: NostrService);
+    validateInputs({ npub, pubkey, nip05 }: {
+        npub?: string | null;
+        pubkey?: string | null;
+        nip05?: string | null;
+    }): string | null;
+    resolveUser({ npub, pubkey, nip05 }: {
+        npub?: string | null;
+        pubkey?: string | null;
+        nip05?: string | null;
+    }): Promise<{
+        user: NDKUser;
+        profile: NDKUserProfile | null;
+    }>;
+}

package/dist/src/base/text-row/render-name.d.ts

@@ -0,0 +1,7 @@
+export interface RenderNameOptions {
+    name: string;
+    className?: string;
+    title?: string;
+    showCopyButton?: boolean;
+}
+export declare function renderName(options: RenderNameOptions): string;

package/dist/src/base/text-row/render-nip05.d.ts

@@ -0,0 +1 @@
+export declare function renderNip05(nip05: string): string;

package/dist/src/base/text-row/render-npub.d.ts

@@ -0,0 +1 @@
+export declare function renderNpub(npub: string): string;

package/dist/src/base/text-row/render-text-row.d.ts

@@ -0,0 +1,9 @@
+export interface TextRowOptions {
+    value: string;
+    display?: string;
+    className?: string;
+    monospace?: boolean;
+    title?: string;
+    showCopyButton?: boolean;
+}
+export declare function renderTextRow(opts: TextRowOptions): string;

package/dist/src/base/user-component/nostr-user-component.d.ts

@@ -0,0 +1,43 @@
+import { NDKUser, NDKUserProfile } from '@nostr-dev-kit/ndk';
+import { NostrBaseComponent, NCStatus } from '../base-component/nostr-base-component';
+/**
+ * NostrUserComponent
+ * ==================
+ * Extension of `NostrBaseComponent` that resolves and manages a Nostr user.
+ *
+ * Overview
+ * - Accepts identity attributes (`npub`, `nip05`, or `pubkey`) and validates them.
+ * - Resolves an `NDKUser` via the shared `nostrService` and fetches its profile.
+ * - Exposes resolved `user` and `profile` to subclasses for rendering or logic.
+ * - Emits lifecycle events for status and user readiness.
+ *
+ * Observed attributes
+ * - `npub`   — user's Nostr public key (bech32 npub)
+ * - `nip05`  — NIP-05 identifier (e.g. `alice@example.com`)
+ * - `pubkey` — raw hex-encoded public key
+ *
+ * Events
+ * - `nc:status` — from base, reflects connection and user/profile loading status
+ * - `nc:user`   — fired when a user and profile are successfully resolved
+ */
+export declare class NostrUserComponent extends NostrBaseComponent {
+    protected user: NDKUser | null;
+    protected profile: NDKUserProfile | null;
+    protected userStatus: {
+        set: (s: NCStatus, e?: string) => void;
+        get: () => NCStatus;
+    };
+    private loadSeq;
+    private resolver;
+    constructor(shadow?: boolean);
+    /** Lifecycle methods */
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** Protected methods */
+    protected validateInputs(): boolean;
+    protected resolveUserAndProfile(): Promise<void>;
+    protected renderContent(): void;
+    /** Hook for subclasses to react when user/profile are ready (e.g., render). */
+    protected onUserReady(_user: NDKUser, _profile: NDKUserProfile | null): void;
+}

package/dist/src/common/base-styles.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Base Styles Utility for Nostr Components
+ * =========================================
+ *
+ * This utility provides common base styles that can be shared across components.
+ * It includes design tokens, common patterns, and utility functions.
+ */
+/**
+ * Generates minimal base styles for any Nostr component
+ * Includes only essential design tokens and base component styles
+ * Uses generic CSS variables that can be overridden by data-theme
+ */
+export declare function getBaseStyles(): string;
+/**
+ * Generates component-specific styles by combining base styles with custom styles
+ * Uses CSS theme variables instead of theme prop
+ */
+export declare function getComponentStyles(customStyles: string): string;
+export declare const styleUtils: {
+    /**
+     * Generates error state styles
+     */
+    error: () => string;
+    /**
+     * Generates skeleton loading styles
+     */
+    skeleton: () => string;
+    /**
+     * Generates copy button styles
+     */
+    copyButton: () => string;
+    /**
+     * Generates profile name styles
+     */
+    profileName: () => string;
+    /**
+     * Generates text row styles
+     */
+    textRow: () => string;
+    /**
+     * Generates error icon styles
+     */
+    errorIcon: () => string;
+};

package/dist/src/common/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_RELAYS: readonly ["wss://relay.damus.io", "wss://nostr.wine", "wss://relay.nostr.net", "wss://relay.nostr.band", "wss://nos.lol", "wss://nostr-pub.wellorder.net", "wss://relay.getalby.com", "wss://relay.primal.net"];
+export declare const MILLISATS_PER_SAT = 1000;
+export declare const NPUB_LENGTH = 63;
+export declare const DEFAULT_PROFILE_IMAGE = "./assets/default_dp.png";

package/dist/src/common/date-utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared date formatting utilities for Nostr components
+ */
+/**
+ * Formats a Unix timestamp to a readable date string
+ * @param createdAt Unix timestamp in seconds
+ * @returns Formatted date string (e.g., "Jan 15, 2024")
+ */
+export declare function formatEventDate(createdAt: number | undefined): string;

package/dist/src/common/icons.d.ts

@@ -0,0 +1,7 @@
+import { Theme } from './types';
+export declare const replyIcon = "\n  <svg width=\"18\" height=\"18\" fill=\"#00b3ff\">\n    <path xmlns=\"http://www.w3.org/2000/svg\" d=\"M12.2197 1.65717C7.73973 1.25408 5.14439 0.940234 3.12891 2.6623C0.948817 4.52502 0.63207 7.66213 2.35603 9.88052C3.01043 10.7226 4.28767 11.9877 5.51513 13.1462C6.75696 14.3184 7.99593 15.426 8.60692 15.9671C8.61074 15.9705 8.61463 15.9739 8.61859 15.9774C8.67603 16.0283 8.74753 16.0917 8.81608 16.1433C8.89816 16.2052 9.01599 16.2819 9.17334 16.3288C9.38253 16.3912 9.60738 16.3912 9.81656 16.3288C9.97391 16.2819 10.0917 16.2052 10.1738 16.1433C10.2424 16.0917 10.3139 16.0283 10.3713 15.9774C10.3753 15.9739 10.3792 15.9705 10.383 15.9671C10.994 15.426 12.2329 14.3184 13.4748 13.1462C14.7022 11.9877 15.9795 10.7226 16.6339 9.88052C18.3512 7.67065 18.0834 4.50935 15.8532 2.65572C13.8153 0.961905 11.2476 1.25349 9.49466 2.78774Z\"/>\n  </svg>\n";
+export declare const heartIcon = "\n  <svg width=\"18\" height=\"18\">\n    <g xmlns=\"http://www.w3.org/2000/svg\">\n      <path fill=\"#ff006d\" d=\"M12.2197 1.65717C7.73973 1.25408 5.14439 0.940234 3.12891 2.6623C0.948817 4.52502 0.63207 7.66213 2.35603 9.88052C3.01043 10.7226 4.28767 11.9877 5.51513 13.1462C6.75696 14.3184 7.99593 15.426 8.60692 15.9671C8.61074 15.9705 8.61463 15.9739 8.61859 15.9774C8.67603 16.0283 8.74753 16.0917 8.81608 16.1433C8.89816 16.2052 9.01599 16.2819 9.17334 16.3288C9.38253 16.3912 9.60738 16.3912 9.81656 16.3288C9.97391 16.2819 10.0917 16.2052 10.1738 16.1433C10.2424 16.0917 10.3139 16.0283 10.3713 15.9774C10.3753 15.9739 10.3792 15.9705 10.383 15.9671C10.994 15.426 12.2329 14.3184 13.4748 13.1462C14.7022 11.9877 15.9795 10.7226 16.6339 9.88052C18.3512 7.67065 18.0834 4.50935 15.8532 2.65572C13.8153 0.961905 11.2476 1.25349 9.49466 2.78774Z\"/>\n    </g>\n  </svg>\n";
+export declare const copyIcon = "\n  <svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\">\n    <path d=\"M16 1H4C2.9 1 2 1.9 2 3V17H4V3H16V1ZM19 5H8C6.9 5 6 5.9 6 7V21C6 22.1 6.9 23 8 23H19C20.1 23 21 22.1 21 21V7C21 5.9 20.1 5 19 5ZM19 21H8V7H19V21Z\" fill=\"currentColor\"/>\n  </svg>\n";
+export declare const checkmarkIcon: (theme?: Theme) => string;
+export declare const nostrLogo: (width?: number, height?: number) => string;
+export declare const loadingNostrich: () => string;

package/dist/src/common/nip05-utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * NIP-05 utility functions for resolving nostr identifiers
+ */
+/**
+ * Resolves a NIP-05 identifier to a nostr public key
+ * Includes input validation and request timeout for security
+ *
+ * @param nip05 - NIP-05 identifier in format username@domain.com
+ * @param timeoutMs - Timeout in milliseconds (default: 5000)
+ * @returns Resolved public key
+ * @throws Error if validation fails, timeout occurs, or resolution fails
+ */
+export declare function resolveNip05(nip05: string, timeoutMs?: number): Promise<string>;

package/dist/src/common/nostr-service.d.ts

@@ -0,0 +1,40 @@
+import { default as NDK, NDKUser, NDKUserProfile, NDKEvent } from '@nostr-dev-kit/ndk';
+export declare class NostrService {
+    private static instance;
+    private ndk;
+    private isConnected;
+    private constructor();
+    static getInstance(): NostrService;
+    connectToNostr(relays?: string[]): Promise<void>;
+    getRelays(): string[];
+    resolveNDKUser(identifier: {
+        npub?: string | null;
+        nip05?: string | null;
+        pubkey?: string | null;
+    }): Promise<NDKUser | null>;
+    resolveNDKEvent(identifier: {
+        hex?: string | null;
+    }): Promise<NDKEvent | null>;
+    /**
+     * Convenience helper to fetch zap count for a profile.
+     * It determines the user based on the provided identifier and
+     * returns the number of zap receipts found (count, **not** total sats).
+     */
+    getZapCount(identifier: {
+        npub?: string;
+        nip05?: string;
+        pubkey?: string;
+    }): Promise<number>;
+    getProfile(user: NDKUser | null): Promise<NDKUserProfile | null>;
+    getPost(eventId: string): Promise<NDKEvent | null>;
+    fetchFollows(user: NDKUser): Promise<number>;
+    fetchFollowers(user: NDKUser): Promise<number>;
+    fetchNotesAndReplies(user: NDKUser): Promise<[number, number]>;
+    fetchZaps(user: NDKUser): Promise<number>;
+    getNDK(): NDK;
+    /**
+     * Check if a Nostr signer is available
+     * @returns boolean indicating if a signer is available
+     */
+    hasSigner(): boolean;
+}

package/dist/src/common/theme.d.ts

@@ -0,0 +1,4 @@
+import { Theme } from './types';
+export declare function getNostrLogo(width?: number, height?: number): string;
+export declare function getLoadingNostrich(): string;
+export declare function getSuccessAnimation(theme?: Theme): string;

package/dist/src/common/types.d.ts

@@ -0,0 +1 @@
+export type Theme = 'light' | 'dark' | 'ocean-glass' | 'holographic' | 'neo-matrix' | 'bitcoin-orange';

package/dist/src/common/utils.d.ts

@@ -0,0 +1,34 @@
+import { default as NDK } from '@nostr-dev-kit/ndk';
+import { Theme } from './types';
+export declare const decodeNpub: (npub: string) => string;
+/**
+ * Convert hex pubkey to npub
+ */
+export declare function hexToNpub(hex: string): string;
+export declare const decodeNip19Entity: (entity: string) => any;
+export declare function maskNPub(npubString?: string, length?: number): string;
+export type Stats = {
+    likes: number;
+    reposts: number;
+    zaps: number;
+    replies: number;
+};
+export declare function getPostStats(ndk: NDK, postId: string): Promise<Stats>;
+export declare function parseRelays(relaysAttr: string | null): string[];
+export declare function parseTheme(themeAttr: string | null): Theme;
+export declare function parseBooleanAttribute(attr: string | null): boolean;
+export declare function escapeHtml(text: string): string;
+export declare function isValidUrl(url: string): boolean;
+export declare function isValidRelayUrl(url: string): boolean;
+export declare function isValidHex(hex: string): boolean;
+export declare function validateNpub(npub: string): boolean;
+export declare function validateNip05(nip05: string): boolean;
+export declare function validateNoteId(noteId: string): boolean;
+export declare function validateEventId(eventId: string): boolean;
+export declare function copyToClipboard(text: string): Promise<void>;
+/**
+ * Format timestamp as relative time (e.g., "2 mins ago", "1 month ago")
+ * @param ts Timestamp in seconds
+ * @returns Formatted relative time string
+ */
+export declare function formatRelativeTime(ts: number): string;

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+import { default as NostrProfileBadge } from './nostr-profile-badge/nostr-profile-badge.ts';
+import { default as NostrPost } from './nostr-post/nostr-post.ts';
+import { default as NostrProfile } from './nostr-profile/nostr-profile.ts';
+import { default as NostrFollowButton } from './nostr-follow-button/nostr-follow-button.ts';
+import { default as NostrZap } from './nostr-zap/nostr-zap.ts';
+import { default as NostrComment } from './nostr-comment/nostr-comment.ts';
+import { default as NostrDm } from './nostr-dm/nostr-dm.ts';
+import { default as NostrLiveChat } from './nostr-live-chat/nostr-live-chat.ts';
+import { default as NostrLike } from './nostr-like/nostr-like.ts';
+export { NostrProfileBadge, NostrPost, NostrProfile, NostrFollowButton, NostrZap, NostrComment, NostrDm, NostrLiveChat, NostrLike };