nostr-components 0.3.0 → 0.3.1

package/dist/src/nostr-comment/nostr-comment.d.ts

@@ -0,0 +1,60 @@
+import { NDKUserProfile } from '@nostr-dev-kit/ndk';
+interface Comment {
+    id: string;
+    pubkey: string;
+    content: string;
+    created_at: number;
+    replies: Comment[];
+    userProfile?: NDKUserProfile;
+    replyTo?: string;
+    depth?: number;
+}
+export default class NostrComment extends HTMLElement {
+    private rendered;
+    private nostrService;
+    private shadow;
+    private theme;
+    private isLoading;
+    private isError;
+    private errorMessage;
+    private comments;
+    private baseUrl;
+    private userPublicKey;
+    private userPrivateKey;
+    private currentUserProfile;
+    private isSubmitting;
+    private replyingToComment;
+    private commentAs;
+    private hasNip07;
+    private anonPrivateKeyHex;
+    private eventListeners;
+    private nip07MonitoringInterval;
+    private loadVersion;
+    constructor();
+    getRelays: () => string[];
+    getTheme: () => void;
+    getBaseUrl: () => string;
+    private detectNip07Extension;
+    private handleNip07StateChange;
+    private setupNip07StateMonitoring;
+    loadComments: () => Promise<void>;
+    buildCommentTree: (allComments: Comment[]) => Comment[];
+    initializeUser: () => Promise<void>;
+    submitComment: (content: string) => Promise<void>;
+    addReplyToComment: (newComment: Comment, parentId: string) => void;
+    private findRootAndParent;
+    startReply: (commentId: string) => void;
+    cancelReply: () => void;
+    connectedCallback(): Promise<void>;
+    static get observedAttributes(): string[];
+    attributeChangedCallback(name: string, _oldValue: string, _newValue: string): Promise<void>;
+    disconnectedCallback(): void;
+    attachEventListeners(): void;
+    attachAvatarErrorHandlers(): void;
+    private removeEventListeners;
+    private showError;
+    private getDefaultAvatarUrl;
+    private ensureAnonKey;
+    render(): void;
+}
+export {};

package/dist/src/nostr-comment/render.d.ts

@@ -0,0 +1,15 @@
+import { Theme } from '../common/types';
+import { NDKUserProfile } from '@nostr-dev-kit/ndk';
+interface Comment {
+    id: string;
+    pubkey: string;
+    content: string;
+    created_at: number;
+    replies: Comment[];
+    userProfile?: NDKUserProfile;
+    replyTo?: string;
+    depth?: number;
+}
+export declare function renderCommentWidget(isLoading: boolean, isError: boolean, errorMessage: string, comments: Comment[], readonly: boolean, placeholder: string, isSubmitting: boolean, currentUserProfile?: NDKUserProfile | null, replyingToComment?: string | null, identityMode?: 'user' | 'anon', hasNip07?: boolean): string;
+export declare function getCommentStyles(theme: Theme): string;
+export {};

package/dist/src/nostr-comment/utils.d.ts

@@ -0,0 +1,81 @@
+import { NDKEvent } from '@nostr-dev-kit/ndk';
+export interface CommentEvent {
+    id: string;
+    pubkey: string;
+    content: string;
+    created_at: number;
+    tags: string[][];
+    sig: string;
+}
+export interface ParsedComment {
+    id: string;
+    pubkey: string;
+    content: string;
+    created_at: number;
+    replyTo?: string;
+    rootUrl?: string;
+}
+/**
+ * Normalize URL for consistent comment identification
+ */
+export declare function normalizeURL(raw: string): string;
+/**
+ * Parse Nostr event into comment structure
+ */
+export declare function parseCommentEvent(event: NDKEvent): ParsedComment | null;
+/**
+ * Create a comment event for publishing
+ */
+export declare function createCommentEvent(content: string, pubkey: string, url: string, replyTo?: string): Omit<CommentEvent, 'id' | 'sig'>;
+/**
+ * Validate if a string is a valid Nostr public key
+ */
+export declare function isValidPublicKey(pubkey: string): boolean;
+/**
+ * Validate if a string is a valid Nostr event ID
+ */
+export declare function isValidEventId(eventId: string): boolean;
+/**
+ * Truncate public key for display
+ */
+export declare function truncatePublicKey(pubkey: string, length?: number): string;
+/**
+ * Format timestamp to relative time
+ */
+export declare function formatRelativeTime(timestamp: number): string;
+/**
+ * Sanitize HTML content to prevent XSS
+ */
+export declare function sanitizeContent(content: string): string;
+/**
+ * Parse URLs in content and make them clickable
+ */
+export declare function linkifyContent(content: string): string;
+/**
+ * Generate a simple hash for content deduplication
+ */
+export declare function hashContent(content: string, pubkey: string): string;
+/**
+ * Check if user has a Nostr extension (NIP-07)
+ */
+export declare function hasNostrExtension(): boolean;
+/**
+ * Get stored private key from localStorage
+ */
+export declare function getStoredPrivateKey(): string | null;
+/**
+ * Store private key in localStorage
+ */
+export declare function storePrivateKey(privateKey: string): boolean;
+/**
+ * Validate if a string is a valid private key
+ */
+export declare function isValidPrivateKey(privateKey: string): boolean;
+/**
+ * Clear stored private key (for logout functionality)
+ */
+export declare function clearStoredPrivateKey(): void;
+/**
+ * Debounce function for rate limiting
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;

package/dist/src/nostr-dm/nostr-dm.d.ts

@@ -0,0 +1,34 @@
+export default class NostrDm extends HTMLElement {
+    private rendered;
+    private nostrService;
+    private theme;
+    private recipientNpub;
+    private recipientNip05;
+    private recipientName;
+    private recipientPicture;
+    private recipientPubkey;
+    private message;
+    private isLoading;
+    private isFinding;
+    private isError;
+    private errorMessage;
+    private isSent;
+    private boundHandleFind;
+    private boundHandleSend;
+    private boundHandleTextareaChange;
+    constructor();
+    getRelays: () => readonly ["wss://relay.damus.io", "wss://nostr.wine", "wss://relay.nostr.net", "wss://nos.lol", "wss://nostr-pub.wellorder.net", "wss://relay.getalby.com", "wss://relay.primal.net"] | string[];
+    getTheme: () => Promise<void>;
+    getRecipient: () => void;
+    connectedCallback(): void;
+    static get observedAttributes(): string[];
+    attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
+    private lookupRecipient;
+    private lookupRecipientByNip05;
+    private handleFindClick;
+    private handleSendClick;
+    private handleTextareaChange;
+    attachEventListeners(): void;
+    disconnectedCallback(): void;
+    private render;
+}

package/dist/src/nostr-dm/render.d.ts

@@ -0,0 +1,15 @@
+import { Theme } from '../common/types';
+export interface RenderDmOptions {
+    theme: Theme;
+    recipientNpub: string | null;
+    recipientName: string | null;
+    recipientPicture: string | null;
+    message: string;
+    isLoading: boolean;
+    isFinding: boolean;
+    isError: boolean;
+    errorMessage: string;
+    isSent: boolean;
+}
+export declare function renderDm({ theme, recipientNpub, recipientName, recipientPicture, message, isLoading, isFinding, isError, errorMessage, isSent, }: RenderDmOptions): string;
+export declare function getDmStyles(theme: Theme): string;

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

@@ -0,0 +1,24 @@
+import { NostrUserComponent } from '../base/user-component/nostr-user-component';
+import { NCStatus } from '../base/base-component/nostr-base-component';
+/**
+ * TODO:
+ *  1. To have a text attribute. Default value being "Follow me on Nostr"
+ *  2. show-avatar attribute to show the avatar of the user, instead of nostr logo.
+ */
+export default class NostrFollowButton extends NostrUserComponent {
+    protected followStatus: {
+        set: (s: NCStatus, e?: string) => void;
+        get: () => NCStatus;
+    };
+    private isFollowed;
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** Base class functions */
+    protected onStatusChange(_status: NCStatus): void;
+    protected onUserReady(_user: any, _profile: any): void;
+    /** Private functions */
+    private handleFollowClick;
+    private attachDelegatedListeners;
+    protected renderContent(): void;
+}

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

@@ -0,0 +1,11 @@
+import { IRenderOptions } from '../base/render-options';
+import { NDKUser, NDKUserProfile } from '@nostr-dev-kit/ndk';
+export interface RenderFollowButtonOptions extends IRenderOptions {
+    isFollowed: boolean;
+    isFollowing: boolean;
+    showAvatar?: boolean;
+    user?: NDKUser | null;
+    profile?: NDKUserProfile | null;
+    customText?: string;
+}
+export declare function renderFollowButton({ isLoading, isError, errorMessage, isFollowed, isFollowing, showAvatar, user, profile, customText, }: RenderFollowButtonOptions): string;

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

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

package/dist/src/nostr-like/dialog-help-style.d.ts

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

package/dist/src/nostr-like/dialog-help.d.ts

@@ -0,0 +1,2 @@
+export declare const injectHelpDialogStyles: () => void;
+export declare const showHelpDialog: (theme?: "light" | "dark") => Promise<void>;

package/dist/src/nostr-like/dialog-likers-style.d.ts

@@ -0,0 +1 @@
+export declare function getLikersDialogStyles(theme?: 'light' | 'dark'): string;

package/dist/src/nostr-like/dialog-likers.d.ts

@@ -0,0 +1,24 @@
+import { DialogComponent } from '../base/dialog-component/dialog-component';
+import { LikeDetails } from './like-utils';
+/**
+ * Modal dialog for displaying individual like details (likers).
+ *
+ * Shows a list of all users who liked a URL with:
+ * - User's name
+ * - User's profile picture
+ * - Time of like (relative time)
+ * - Clickable links to user profiles via njump.me
+ */
+export interface OpenLikersModalParams {
+    likeDetails: LikeDetails[];
+    theme?: 'light' | 'dark';
+}
+/**
+ * Inject likers dialog content styles into document head
+ * Prevents duplicate injection by checking for existing styles
+ */
+export declare const injectLikersDialogStyles: (theme?: "light" | "dark") => void;
+/**
+ * Opens the likers dialog showing individual like details
+ */
+export declare function openLikersDialog(params: OpenLikersModalParams): Promise<DialogComponent>;

package/dist/src/nostr-like/like-utils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Helper utilities for Nostr like operations using NIP-25 External Content Reactions.
+ * These are deliberately kept self-contained so `nostr-like` Web Component can import
+ * everything from a single module without polluting the rest of the codebase.
+ */
+export interface LikeDetails {
+    authorPubkey: string;
+    date: Date;
+    content: string;
+}
+export interface LikeCountResult {
+    totalCount: number;
+    likeDetails: LikeDetails[];
+    likedCount: number;
+    dislikedCount: number;
+}
+/**
+ * Fetch all likes for a URL using NIP-25 kind 17 events
+ */
+export declare function fetchLikesForUrl(url: string, relays: string[]): Promise<LikeCountResult>;
+/**
+ * Create reaction event (kind 17)
+ * @param url - URL to react to
+ * @param content - '+' for like, '-' for unlike
+ */
+export declare function createReactionEvent(url: string, content: '+' | '-'): any;
+/**
+ * Create like event (kind 17)
+ * @deprecated Use createReactionEvent(url, '+') instead
+ */
+export declare function createLikeEvent(url: string): any;
+/**
+ * Create unlike event (kind 17 with '-' content)
+ * @deprecated Use createReactionEvent(url, '-') instead
+ */
+export declare function createUnlikeEvent(url: string): any;
+/**
+ * Check if user has liked a URL
+ */
+export declare function hasUserLiked(url: string, userPubkey: string, relays: string[]): Promise<boolean>;
+/**
+ * Get user's pubkey from NostrLogin
+ */
+export declare function getUserPubkey(): Promise<string | null>;
+/**
+ * Sign event with NostrLogin
+ */
+export declare function signEvent(event: any): Promise<any>;

package/dist/src/nostr-like/nostr-like.d.ts

@@ -0,0 +1,49 @@
+import { NostrBaseComponent, NCStatus } from '../base/base-component/nostr-base-component';
+/**
+ * <nostr-like>
+ * Attributes:
+ *   - url          (optional) : URL to like (default: current page URL)
+ *   - text         (optional) : custom text (default "Like") (Max 32 characters)
+ *   - relays       (optional) : comma-separated relay URLs
+ *   - data-theme   (optional) : "light" | "dark" (default light)
+ *
+ * Features:
+ *   - URL-based likes using NIP-25 kind 17 events
+ *   - Click count to view likers
+ */
+export default class NostrLike extends NostrBaseComponent {
+    protected likeActionStatus: {
+        set: (s: NCStatus, e?: string) => void;
+        get: () => NCStatus;
+    };
+    protected likeListStatus: {
+        set: (s: NCStatus, e?: string) => void;
+        get: () => NCStatus;
+    };
+    private currentUrl;
+    private isLiked;
+    private likeCount;
+    private cachedLikeDetails;
+    private loadSeq;
+    constructor();
+    connectedCallback(): void;
+    static get observedAttributes(): string[];
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** Base class functions */
+    protected validateInputs(): boolean;
+    protected onStatusChange(_status: NCStatus): void;
+    protected onNostrRelaysConnected(): void;
+    /** Private functions */
+    /**
+     * Lazy initializer for currentUrl - ensures it's set before like/unlike operations
+     */
+    private ensureCurrentUrl;
+    private updateLikeCount;
+    private handleLikeClick;
+    private handleLike;
+    private handleUnlike;
+    private handleCountClick;
+    private handleHelpClick;
+    private attachDelegatedListeners;
+    protected renderContent(): void;
+}

package/dist/src/nostr-like/render.d.ts

@@ -0,0 +1,10 @@
+import { IRenderOptions } from '../base/render-options';
+export interface RenderLikeButtonOptions extends IRenderOptions {
+    buttonText: string;
+    isLiked: boolean;
+    likeCount: number;
+    hasLikes?: boolean;
+    isCountLoading?: boolean;
+    theme?: 'light' | 'dark';
+}
+export declare function renderLikeButton({ isLoading, isError, errorMessage, buttonText, isLiked, likeCount, hasLikes, isCountLoading, theme, }: RenderLikeButtonOptions): string;

package/dist/src/nostr-like/style.d.ts

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

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

@@ -0,0 +1,65 @@
+export default class NostrLiveChat extends HTMLElement {
+    private rendered;
+    private nostrService;
+    private dmSubscription;
+    private theme;
+    private recipientNpub;
+    private recipientNip05;
+    private recipientName;
+    private recipientPicture;
+    private recipientPubkey;
+    private message;
+    private messages;
+    private currentUserPubkey;
+    private currentUserNpub;
+    private currentUserName;
+    private currentUserPicture;
+    private static readonly DEFAULT_WELCOME_TEXT;
+    private static readonly DEFAULT_START_CHAT_TEXT;
+    private static readonly DEFAULT_ONLINE_TEXT;
+    private static readonly DEFAULT_HELP_TEXT;
+    private displayType;
+    private isOpen;
+    private showWelcome;
+    private welcomeText;
+    private startChatText;
+    private onlineText;
+    private helpText;
+    private readonly MESSAGE_MAX_LENGTH;
+    private isLoading;
+    private isFinding;
+    private isError;
+    private errorMessage;
+    private keySupplier;
+    private boundHandleFind;
+    private boundHandleSend;
+    private boundHandleTextareaChange;
+    private boundHandleLauncherClick;
+    private boundHandleCloseClick;
+    private boundHandleStartChat;
+    private boundHandleNpubKeydown;
+    private resubscribeTimer;
+    constructor();
+    getRelays: () => readonly ["wss://relay.damus.io", "wss://nostr.wine", "wss://relay.nostr.net", "wss://nos.lol", "wss://nostr-pub.wellorder.net", "wss://relay.getalby.com", "wss://relay.primal.net"] | string[];
+    private getCurrentUserInfo;
+    private getDisplayType;
+    getTheme: () => void;
+    getRecipient: () => void;
+    connectedCallback(): void;
+    static get observedAttributes(): string[];
+    private unsubscribeFromDms;
+    private clearRecipientAndChatState;
+    attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
+    private lookupRecipient;
+    private lookupRecipientByNip05;
+    private handleFindClick;
+    private handleSendClick;
+    private handleTextareaChange;
+    private handleStartChat;
+    private subscribeToDms;
+    private attachEventListeners;
+    disconnectedCallback(): void;
+    setKeySupplier(supplier: (() => string | Promise<string>) | null): void;
+    private escapeHtml;
+    private render;
+}

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

@@ -0,0 +1,31 @@
+import { Theme } from '../common/types';
+export interface ChatMessage {
+    id: string;
+    text: string;
+    sender: 'me' | 'them';
+    timestamp: number;
+    status: 'sending' | 'sent' | 'failed';
+}
+export interface RenderLiveChatOptions {
+    theme: Theme;
+    recipientNpub: string | null;
+    recipientName: string | null;
+    recipientPicture: string | null;
+    message: string;
+    messages: ChatMessage[];
+    isLoading: boolean;
+    isFinding: boolean;
+    isError: boolean;
+    errorMessage: string;
+    currentUserName?: string | null;
+    currentUserPicture?: string | null;
+    showWelcome?: boolean;
+    welcomeText?: string;
+    startChatText?: string;
+    onlineText?: string;
+    helpText?: string;
+    maxMessageLength: number;
+}
+export declare function renderLiveChat({ theme, recipientNpub, recipientName, recipientPicture, message, messages, isLoading, isFinding, isError, errorMessage, currentUserName, currentUserPicture, showWelcome, welcomeText, startChatText, onlineText, helpText, maxMessageLength, }: RenderLiveChatOptions): string;
+export declare function renderLiveChatInner({ theme, recipientNpub, recipientName, recipientPicture, message, messages, isLoading, isFinding, isError, errorMessage, currentUserName, currentUserPicture, showWelcome, welcomeText, startChatText, maxMessageLength, }: Omit<RenderLiveChatOptions, 'onlineText' | 'helpText'>): string;
+export declare function getLiveChatStyles(theme: Theme): string;

package/dist/src/nostr-post/nostr-post.d.ts

@@ -0,0 +1,25 @@
+import { NDKEvent } from '@nostr-dev-kit/ndk';
+import { Stats } from '../common/utils';
+import { NostrEventComponent } from '../base/event-component/nostr-event-component';
+import { NCStatus } from '../base/base-component/nostr-base-component';
+export default class NostrPost extends NostrEventComponent {
+    protected stats: Stats | null;
+    protected statsLoading: boolean;
+    protected embeddedPosts: Map<string, NDKEvent>;
+    private glideInitialized;
+    private cachedParsedContent;
+    private cachedHtmlToRender;
+    connectedCallback(): Promise<void>;
+    static get observedAttributes(): string[];
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** Base class functions */
+    protected onStatusChange(_status: NCStatus): void;
+    protected onEventReady(_event: any): Promise<void>;
+    private invalidateCache;
+    getPostStats(): Promise<void>;
+    private onPostClick;
+    private onAuthorClick;
+    private onMentionClick;
+    private attachDelegatedListeners;
+    protected renderContent(): Promise<void>;
+}

package/dist/src/nostr-post/parse-text.d.ts

@@ -0,0 +1,8 @@
+import { NDKEvent } from '@nostr-dev-kit/ndk';
+import { NostrService } from '../common/nostr-service';
+export type ContentItem = {
+    type: 'text' | 'image' | 'gif' | 'video' | 'link' | 'embedded-note';
+    value?: string;
+    noteId?: string;
+};
+export declare function parseText(text: string, post: NDKEvent | null, embeddedPosts: Map<string, NDKEvent>, nostrService: NostrService): Promise<ContentItem[]>;

package/dist/src/nostr-post/render-content.d.ts

@@ -0,0 +1,5 @@
+import { ContentItem } from './parse-text';
+import { NDKEvent } from '@nostr-dev-kit/ndk';
+export declare function renderContent(content: ContentItem[]): string;
+export declare function replaceEmbeddedPostPlaceholders(shadowRoot: ShadowRoot | null, embeddedPosts: Map<string, NDKEvent>, event: NDKEvent | null, nostrService: any): Promise<void>;
+export declare function renderEmbeddedPostContent(noteId: string, embeddedPosts: Map<string, NDKEvent>, event: NDKEvent | null, nostrService: any): Promise<string>;

package/dist/src/nostr-post/render.d.ts

@@ -0,0 +1,19 @@
+import { IRenderOptions } from '../base/render-options';
+import { NDKUserProfile } from '@nostr-dev-kit/ndk';
+export interface RenderPostOptions extends IRenderOptions {
+    author: NDKUserProfile | null | undefined;
+    date: string;
+    shouldShowStats: boolean;
+    stats: {
+        replies: number;
+        likes: number;
+    } | null;
+    statsLoading: boolean;
+    htmlToRender: string;
+}
+export declare function renderPost(options: RenderPostOptions): string;
+export declare function renderEmbeddedPost(noteId: string, authorProfile: {
+    displayName?: string;
+    image?: string;
+    nip05?: string;
+} | undefined, date: string, content: string): string;

package/dist/src/nostr-post/style.d.ts

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

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

@@ -0,0 +1,24 @@
+import { NCStatus } from '../base/base-component/nostr-base-component';
+import { NostrUserComponent } from '../base/user-component/nostr-user-component';
+export default class NostrProfile extends NostrUserComponent {
+    protected profileStatus: {
+        set: (s: NCStatus, e?: string) => void;
+        get: () => NCStatus;
+    };
+    private isStatsLoading;
+    private isStatsFollowsLoading;
+    private isStatsFollowersLoading;
+    private isZapsLoading;
+    private stats;
+    static get observedAttributes(): string[];
+    connectedCallback(): Promise<void>;
+    /** Base class functions */
+    protected onStatusChange(_status: NCStatus): void;
+    protected onUserReady(_user: any, _profile: any): void;
+    getUserStats: () => Promise<void>;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** Private functions */
+    private onProfileClick;
+    private attachDelegatedListeners;
+    protected renderContent(): void;
+}

package/dist/src/nostr-profile/render-stats.d.ts

@@ -0,0 +1 @@
+export declare function renderStats(label: string, value: number, isLoading: boolean): string;

package/dist/src/nostr-profile/render.d.ts

@@ -0,0 +1,22 @@
+import { NDKUserProfile } from '@nostr-dev-kit/ndk';
+import { IRenderOptions } from '../base/render-options';
+export interface Stats {
+    notes: number;
+    replies: number;
+    follows: number;
+    followers: number;
+    zaps: number;
+    relays: number;
+}
+export interface RenderProfileOptions extends IRenderOptions {
+    npub: string;
+    userProfile: NDKUserProfile;
+    isStatsLoading: boolean;
+    isStatsFollowersLoading: boolean;
+    isStatsFollowsLoading: boolean;
+    isZapsLoading: boolean;
+    stats: Stats;
+    showFollow: boolean;
+    showNpub: boolean;
+}
+export declare function renderProfile(options: RenderProfileOptions): string;

package/dist/src/nostr-profile/style.d.ts

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

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

@@ -0,0 +1,34 @@
+import { NCStatus } from '../base/base-component/nostr-base-component';
+import { NostrUserComponent } from '../base/user-component/nostr-user-component';
+import { NDKUser, NDKUserProfile } from '@nostr-dev-kit/ndk';
+/**
+ * NostrProfileBadge
+ * =================
+ * UI component (extends `NostrUserComponent`) that renders a compact user badge
+ * with avatar/name/nip05 and optional npub + follow button.
+ *
+ * Observed attributes
+ * - `show-npub`   — boolean-like attribute to display the masked npub + copy
+ * - `show-follow` — boolean-like attribute to display the follow button
+ *
+ * Events
+ * - `nc:status`         — (from base) status changes for connection/user
+ * - `nc:user`           — emitted when user & profile are ready (from parent)
+ * - `nc:profile_badge`  — fired on badge click (detail: `NDKUserProfile | null`);
+ *                         default action opens `https://njump.me/<nip05|npub>`
+ *
+ * Note: Follow button placement to be improved in future versions
+ */
+export default class NostrProfileBadge extends NostrUserComponent {
+    /** Lifecycle methods */
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** Base class functions */
+    protected onStatusChange(_status: NCStatus): void;
+    protected onUserReady(_user: NDKUser, _profile: NDKUserProfile | null): void;
+    /** Private functions */
+    private onProfileClick;
+    private attachDelegatedListeners;
+    protected renderContent(): void;
+}