@cedros/data-react-native 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,816 @@
+import { ReactNode } from 'react';
+
+export declare interface BlogIndexEntry {
+    slug: string;
+    title: string;
+    excerpt?: string;
+    category?: string;
+    tags?: string[];
+    publishedAt?: string;
+}
+
+export declare interface BlogIndexQuery {
+    query?: string;
+    category?: string;
+    tag?: string;
+    sort?: "newest" | "oldest" | "title-asc" | "title-desc";
+    page?: number;
+    pageSize?: number;
+    dimensions?: FilterDimensionValues;
+}
+
+export declare function BlogIndexTemplate({ siteTitle, navigation, posts, title, description, query, category, tag, sort, page, pageSize, filterDimensions, activeFilters, onFilterChange, onSearch, onPageChange, bookmarkedSlugs, onBookmarkToggle, onNavigate, currentPath, }: BlogIndexTemplateProps): React.JSX.Element;
+
+export declare interface BlogIndexTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    posts: BlogPostSummary[];
+    title?: string;
+    description?: string;
+    query?: string;
+    category?: string;
+    tag?: string;
+    sort?: "newest" | "oldest" | "title-asc" | "title-desc";
+    page?: number;
+    pageSize?: number;
+    filterDimensions?: FilterDimension[];
+    activeFilters?: FilterDimensionValues;
+    onFilterChange?: (key: string, value: string) => void;
+    onSearch?: (query: string) => void;
+    onPageChange?: (page: number) => void;
+    bookmarkedSlugs?: Set<string>;
+    onBookmarkToggle?: (slug: string) => void;
+    onNavigate?: (route: string) => void;
+    currentPath?: string;
+}
+
+export declare interface BlogPaywallConfig {
+    mode: "free" | "preview" | "locked";
+    previewParagraphs?: number;
+    price?: PaywallPrice;
+    unlocked: boolean;
+    payClient: PaywallPayClient;
+    subscriptionLabel?: string;
+    purchaseLabel?: string;
+    /** Remaining metered free reads this month (undefined = metering disabled). */
+    remainingFreeReads?: number;
+}
+
+export declare interface BlogPostSummary extends BlogIndexEntry {
+    author?: string;
+    readingMinutes?: number;
+}
+
+export declare function BlogPostTemplate({ siteTitle, navigation, title, bodyMarkdown, bodyHtml, allowUnsafeHtmlFallback, publishedAt, updatedAt, author, category, tags, readingMinutes, breadcrumbs, relatedPosts, isBookmarked, onBookmarkToggle, slug, tipping, paywall, onNavigate, currentPath, }: BlogPostTemplateProps): React.JSX.Element;
+
+export declare interface BlogPostTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    title: string;
+    bodyMarkdown?: string;
+    bodyHtml?: string;
+    allowUnsafeHtmlFallback?: boolean;
+    publishedAt?: string;
+    updatedAt?: string;
+    author?: string;
+    category?: string;
+    tags?: string[];
+    readingMinutes?: number;
+    breadcrumbs?: Array<{
+        label: string;
+        href: string;
+    }>;
+    relatedPosts?: Array<{
+        slug: string;
+        title: string;
+        excerpt?: string;
+    }>;
+    isBookmarked?: boolean;
+    onBookmarkToggle?: (slug: string) => void;
+    slug?: string;
+    tipping?: BlogTippingConfig;
+    paywall?: BlogPaywallConfig;
+    onNavigate?: (route: string) => void;
+    currentPath?: string;
+}
+
+export declare function BlogSearchInput({ defaultValue, onSearch, placeholder, }: BlogSearchInputProps): React.JSX.Element;
+
+export declare interface BlogSearchInputProps {
+    defaultValue?: string;
+    onSearch: (query: string) => void;
+    placeholder?: string;
+}
+
+export declare interface BlogTippingConfig {
+    enabled: boolean;
+    label?: string;
+    description?: string;
+    recipient?: string;
+    currencies?: TipCurrency[];
+    presets?: Record<string, number[]>;
+    dataServerUrl?: string;
+    /** When true, `recipientOverride` takes precedence over `recipient`. */
+    allowPerPostRecipient?: boolean;
+    /** Per-post tip recipient (used when `allowPerPostRecipient` is true). */
+    recipientOverride?: string;
+    /** Sender wallet address. */
+    senderAddress?: string;
+    /** Signs a base64 serialized transaction, returns signed base64. */
+    signTransaction?: (serializedTx: string) => Promise<string>;
+}
+
+export declare function BookmarkButton({ slug, isBookmarked, onToggle, }: BookmarkButtonProps): React.JSX.Element;
+
+export declare interface BookmarkButtonProps {
+    slug: string;
+    isBookmarked: boolean;
+    onToggle: (slug: string) => void;
+}
+
+export declare function Breadcrumbs({ trail, onNavigate, }: BreadcrumbsProps): React.JSX.Element | null;
+
+export declare interface BreadcrumbsProps {
+    trail: Array<{
+        label: string;
+        href: string;
+    }>;
+    onNavigate?: (route: string) => void;
+}
+
+export declare function buildContentListHref(basePath: string, query: Record<string, string | number | undefined>): string;
+
+/**
+ * Builds a deep link URL from structured components.
+ *
+ * @param contentType - The content type
+ * @param slug - Optional slug (omit for index pages)
+ * @param filters - Optional query filters
+ * @param anchor - Optional anchor/heading ID
+ * @returns A path string like `/blog/my-post?tag=api#install`
+ */
+export declare function buildDeepLink(contentType: DeepLinkResult["contentType"], slug?: string, filters?: DeepLinkResult["filters"], anchor?: string): string;
+
+export declare function buildDocsSidebarSections(docs: DocsIndexEntry[], basePath?: string): DocsSidebarSection[];
+
+/**
+ * Theme provider for cedros-data React Native components.
+ *
+ * Wraps children in a `View` and provides resolved tokens via context.
+ */
+export declare function CedrosDataProvider({ theme, tokenOverrides, unstyled, children, }: CedrosDataProviderProps): React.JSX.Element;
+
+export declare interface CedrosDataProviderProps {
+    /** Light or dark mode. */
+    theme?: ThemeMode;
+    /** Token overrides merged on top of the mode defaults. */
+    tokenOverrides?: Partial<CedrosDataThemeTokens>;
+    /** When true, components skip default styling. */
+    unstyled?: boolean;
+    children: ReactNode;
+}
+
+/**
+ * Theme token type for React Native.
+ *
+ * CamelCase keys mapping 1:1 to the web `--cedros-*` CSS variable namespace
+ * shared across cedros-login, cedros-pay, and cedros-data.
+ */
+export declare interface CedrosDataThemeTokens {
+    background: string;
+    foreground: string;
+    muted: string;
+    mutedForeground: string;
+    border: string;
+    link: string;
+    primary: string;
+    primaryForeground: string;
+    accent: string;
+    ring: string;
+    /** Border radius in pixels (not rem). */
+    radius: number;
+    success: string;
+    error: string;
+}
+
+/** Value returned by `useCedrosDataTheme()`. */
+export declare interface CedrosDataThemeValue {
+    mode: ThemeMode;
+    isDark: boolean;
+    tokens: CedrosDataThemeTokens;
+    unstyled: boolean;
+}
+
+/**
+ * Renders pre-rendered CMS HTML content.
+ *
+ * Uses `react-native-render-html` when installed as an optional peer dependency.
+ * Falls back to a plain-text message when the dependency is not available.
+ */
+export declare function CmsContent({ html, contentWidth, onLinkPress, }: CmsContentProps): React.JSX.Element;
+
+export declare interface CmsContentProps {
+    /** Raw HTML content from the CMS to render. */
+    html: string;
+    /** Content width hint for react-native-render-html layout. */
+    contentWidth?: number;
+    /** Optional callback invoked when a link inside the content is tapped. */
+    onLinkPress?: (href: string) => void;
+}
+
+/**
+ * A CMS page record as returned by the cedros-data entries API.
+ */
+export declare interface CmsPageRecord {
+    entry_key: string;
+    payload: {
+        key?: string;
+        title?: string;
+        description?: string;
+        route?: string;
+        section?: string;
+        status?: string;
+        body?: string;
+        bodyHtml?: string;
+        ogTitle?: string;
+        ogDescription?: string;
+        ogImage?: string;
+        twitterTitle?: string;
+        twitterDescription?: string;
+        author?: string;
+        publishedAt?: string;
+        updatedAt?: string;
+        category?: string;
+        tags?: string[];
+        slug?: string;
+        readingMinutes?: number;
+        wordCount?: number;
+        _metering?: MeteredReadsInfo;
+        [key: string]: unknown;
+    };
+    updated_at: string;
+}
+
+/**
+ * Code block with copy-to-clipboard button.
+ *
+ * Renders monospace text with a "Copy" button. Requires
+ * `@react-native-clipboard/clipboard` for clipboard functionality.
+ */
+export declare function CodeBlock({ code, language }: CodeBlockProps): React.JSX.Element;
+
+export declare interface CodeBlockProps {
+    code: string;
+    language?: string;
+}
+
+export declare function collectDimensionValues(entries: object[], dimensionKeys: string[]): Record<string, string[]>;
+
+export declare function collectFilterValues(entries: Array<{
+    category?: string;
+    tags?: string[];
+}>): {
+    categories: string[];
+    tags: string[];
+};
+
+export declare interface ContactDetail {
+    label: string;
+    value: string;
+    href?: string;
+}
+
+export declare function ContactPageTemplate({ siteTitle, navigation, title, description, details, onNavigate, onLinkPress, currentPath, }: ContactPageTemplateProps): React.JSX.Element;
+
+export declare interface ContactPageTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    title?: string;
+    description?: string;
+    details: ContactDetail[];
+    onNavigate?: (route: string) => void;
+    onLinkPress?: (href: string) => void;
+    currentPath?: string;
+}
+
+export declare function ContentPagination({ page, totalPages, onPageChange, }: ContentPaginationProps): React.JSX.Element | null;
+
+export declare interface ContentPaginationProps {
+    page: number;
+    totalPages: number;
+    onPageChange?: (page: number) => void;
+}
+
+/**
+ * Content paywall gate for premium articles.
+ *
+ * In "preview" mode, renders truncated markdown content.
+ * In "locked" mode, shows a lock icon and unlock prompt.
+ */
+export declare function ContentPaywall({ mode, previewContent, price, payClient, purchaseLabel, subscriptionLabel, }: ContentPaywallProps): React.JSX.Element;
+
+export declare interface ContentPaywallProps {
+    mode: "preview" | "locked";
+    previewContent?: string;
+    price?: PaywallPrice;
+    payClient: PaywallPayClient;
+    purchaseLabel?: string;
+    subscriptionLabel?: string;
+}
+
+/** Content type identifiers used across cedros-data. */
+export declare type ContentType = "page" | "blog" | "docs" | "learn" | "project" | "airdrop";
+
+/** Parsed result from a deep link URL. */
+export declare interface DeepLinkResult {
+    contentType: ContentType | "home" | "contact" | "legal" | "not-found";
+    slug?: string;
+    /** Query parameters parsed from the URL. */
+    filters?: {
+        query?: string;
+        category?: string;
+        tag?: string;
+        sort?: string;
+        page?: number;
+    };
+    /** Anchor/hash fragment (e.g. a heading ID to scroll to). */
+    anchor?: string;
+}
+
+/** Dark theme defaults matching web CSS values. */
+export declare const defaultDarkTokens: Readonly<CedrosDataThemeTokens>;
+
+/** Light theme defaults matching web CSS values. */
+export declare const defaultLightTokens: Readonly<CedrosDataThemeTokens>;
+
+export declare function DocArticleTemplate({ siteTitle, navigation, title, bodyMarkdown, bodyHtml, allowUnsafeHtmlFallback, lastUpdated, readingMinutes, basePath, currentPath, docs, sidebarSections, sidebarTitle, breadcrumbs, previousDoc, nextDoc, onNavigate, }: DocArticleTemplateProps): React.JSX.Element;
+
+export declare interface DocArticleTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    title: string;
+    bodyMarkdown?: string;
+    bodyHtml?: string;
+    allowUnsafeHtmlFallback?: boolean;
+    lastUpdated?: string;
+    readingMinutes?: number;
+    basePath?: string;
+    currentPath?: string;
+    docs?: DocsIndexEntry[];
+    sidebarSections?: DocsSidebarSection[];
+    sidebarTitle?: string;
+    breadcrumbs?: Array<{
+        label: string;
+        href: string;
+    }>;
+    previousDoc?: {
+        title: string;
+        href: string;
+    };
+    nextDoc?: {
+        title: string;
+        href: string;
+    };
+    onNavigate?: (route: string) => void;
+}
+
+export declare interface DocsIndexEntry {
+    slug: string;
+    title: string;
+    description?: string;
+    category?: string;
+    tags?: string[];
+    lastUpdated?: string;
+}
+
+export declare interface DocsIndexItem extends DocsIndexEntry {
+}
+
+export declare interface DocsIndexQuery {
+    query?: string;
+    category?: string;
+    tag?: string;
+    sort?: "updated-desc" | "updated-asc" | "title-asc" | "title-desc";
+    page?: number;
+    pageSize?: number;
+}
+
+export declare function DocsIndexTemplate({ siteTitle, navigation, docs, title, description, basePath, currentPath, query, category, tag, sort, page, pageSize, sidebarSections, sidebarTitle, onNavigate, onPageChange, }: DocsIndexTemplateProps): React.JSX.Element;
+
+export declare interface DocsIndexTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    docs: DocsIndexItem[];
+    title?: string;
+    description?: string;
+    basePath?: string;
+    currentPath?: string;
+    query?: string;
+    category?: string;
+    tag?: string;
+    sort?: "updated-desc" | "updated-asc" | "title-asc" | "title-desc";
+    page?: number;
+    pageSize?: number;
+    sidebarSections?: DocsSidebarSection[];
+    sidebarTitle?: string;
+    onNavigate?: (route: string) => void;
+    onPageChange?: (page: number) => void;
+}
+
+/**
+ * Collapsible docs sidebar navigation.
+ *
+ * Each section can be expanded/collapsed. Items show active state.
+ */
+export declare function DocsSidebar({ title, sections, onNavigate, }: DocsSidebarProps): React.JSX.Element;
+
+export declare interface DocsSidebarItem {
+    key: string;
+    label: string;
+    href: string;
+    isActive?: boolean;
+    depth?: 0 | 1 | 2;
+    badge?: string;
+}
+
+export declare interface DocsSidebarProps {
+    title: string;
+    sections: DocsSidebarSection[];
+    onNavigate?: (route: string) => void;
+}
+
+export declare interface DocsSidebarSection {
+    key: string;
+    label: string;
+    items: DocsSidebarItem[];
+    /** When true, section renders collapsed by default in the sidebar. */
+    collapsed?: boolean;
+}
+
+/**
+ * Extracts a table-of-contents from raw markdown.
+ *
+ * Walks top-level heading nodes (h2-h4), slugifies the text content to
+ * produce `id` values matching `rehype-slug` output.
+ *
+ * @param markdown - Raw markdown string
+ * @returns Array of TOC entries ordered by document position
+ */
+export declare function extractTocFromMarkdown(markdown: string): TocEntry[];
+
+/**
+ * JSON fetch wrapper for cedros-data API calls.
+ *
+ * React Native has `fetch` globally available — no polyfill needed.
+ */
+export declare function fetchJson<T>(serverUrl: string, path: string, init?: {
+    method?: string;
+    body?: unknown;
+    apiKey?: string;
+}): Promise<T>;
+
+/** Options for fetching data from the cedros-data server. */
+export declare interface FetchOptions {
+    /** Base URL of the cedros-data server. */
+    serverUrl: string;
+    /** API key sent as x-api-key header. */
+    apiKey?: string;
+    /** Visitor ID for metered-reads tracking. */
+    visitorId?: string;
+}
+
+export declare interface FilterDimension {
+    /** Payload field name, e.g. "category", "knowledgeLevel" */
+    key: string;
+    /** Display label, e.g. "Category", "Level" */
+    label: string;
+    /** Available values, e.g. ["Beginner", "Advanced"] */
+    values: string[];
+}
+
+export declare function FilterDimensionChips({ dimensions, active, onChange, }: FilterDimensionChipsProps): React.JSX.Element;
+
+export declare interface FilterDimensionChipsProps {
+    dimensions: FilterDimension[];
+    active: FilterDimensionValues;
+    onChange: (key: string, value: string) => void;
+}
+
+export declare interface FilterDimensionValues {
+    [dimensionKey: string]: string;
+}
+
+/** Layout options for the site footer. */
+export declare interface FooterLayoutOptions {
+    /** Full-width removes horizontal padding. Default: "contained". */
+    width?: "contained" | "full";
+}
+
+/**
+ * Client-side visitor identification via AsyncStorage.
+ *
+ * Returns a stable UUID stored in `cedros_vid` key.
+ * Falls back to a per-session random ID when AsyncStorage is unavailable.
+ */
+/**
+ * Returns a stable visitor ID, persisted via AsyncStorage when available.
+ *
+ * On first call, attempts to load from AsyncStorage. If not found, generates
+ * a new UUID and persists it. Returns synchronously from cache on subsequent calls.
+ *
+ * @returns The visitor ID (or a fresh in-memory one if AsyncStorage is unavailable).
+ */
+export declare function getOrCreateVisitorId(): Promise<string>;
+
+/**
+ * Returns the cached visitor ID synchronously, or `null` if not yet loaded.
+ * Call `getOrCreateVisitorId()` first to ensure the ID is loaded.
+ */
+export declare function getVisitorIdSync(): string | null;
+
+export declare interface HomeFeature {
+    title: string;
+    description: string;
+}
+
+export declare function HomePageTemplate({ siteTitle, navigation, headline, subheadline, ctaLabel, ctaRoute, features, onNavigate, currentPath, }: HomePageTemplateProps): React.JSX.Element;
+
+export declare interface HomePageTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    headline: string;
+    subheadline?: string;
+    ctaLabel?: string;
+    ctaRoute?: string;
+    features?: HomeFeature[];
+    onNavigate?: (route: string) => void;
+    currentPath?: string;
+}
+
+export declare function isRouteActive(route: string, currentPath: string, options?: RouteMatcherOptions): boolean;
+
+export declare function LegalPageTemplate({ siteTitle, navigation, pageType, title, bodyMarkdown, bodyHtml, allowUnsafeHtmlFallback, effectiveDate, onNavigate, currentPath, }: LegalPageTemplateProps): React.JSX.Element;
+
+export declare interface LegalPageTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    pageType: "privacy-policy" | "terms-of-service";
+    title: string;
+    bodyMarkdown?: string;
+    bodyHtml?: string;
+    allowUnsafeHtmlFallback?: boolean;
+    effectiveDate?: string;
+    onNavigate?: (route: string) => void;
+    currentPath?: string;
+}
+
+/**
+ * Renders markdown content using react-native-markdown-display.
+ *
+ * Falls back to plain Text when bodyMarkdown is unavailable or
+ * the peer dependency is not installed.
+ */
+export declare function MarkdownContent({ bodyMarkdown, bodyHtml, allowUnsafeHtmlFallback, }: MarkdownContentProps): React.JSX.Element;
+
+export declare interface MarkdownContentProps {
+    bodyMarkdown?: string;
+    bodyHtml?: string;
+    allowUnsafeHtmlFallback?: boolean;
+}
+
+export declare function matchesFilterDimensions(entry: object, activeFilters: FilterDimensionValues): boolean;
+
+/** Metering status injected into entry payloads when visitor_id is provided. */
+export declare interface MeteredReadsInfo {
+    remainingFreeReads: number;
+    freeReadsPerMonth: number;
+    readsUsed: number;
+}
+
+/** Layout options for the top navigation bar. */
+export declare interface NavLayoutOptions {
+    /** Full-width removes horizontal padding. Default: "contained". */
+    width?: "contained" | "full";
+    /** Where the main nav links sit. Default: "right". */
+    linkPosition?: "center" | "right";
+    /** Visual style for nav links. Default: "pill". */
+    linkStyle?: "text" | "pill";
+}
+
+export declare function normalizeRoutePath(route: string): string;
+
+export declare function NotFoundTemplate({ siteTitle, navigation, title, message, onNavigate, currentPath, }: NotFoundTemplateProps): React.JSX.Element;
+
+export declare interface NotFoundTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    title?: string;
+    message?: string;
+    onNavigate?: (route: string) => void;
+    currentPath?: string;
+}
+
+export declare interface PaginationResult<T> {
+    items: T[];
+    page: number;
+    pageSize: number;
+    totalItems: number;
+    totalPages: number;
+}
+
+/**
+ * Parses a deep link URL into a structured navigation target.
+ *
+ * Handles both full URLs (`https://example.com/blog/my-post?tag=api#install`)
+ * and path-only strings (`/blog/my-post`).
+ *
+ * @param url - The URL or path to parse
+ * @returns Parsed deep link result with content type, slug, filters, and anchor
+ */
+export declare function parseDeepLink(url: string): DeepLinkResult;
+
+/** Provided by @cedros/pay-react-native (or any compatible implementation). */
+export declare interface PaywallPayClient {
+    purchase?: () => Promise<void>;
+    subscribe?: () => Promise<void>;
+    useCredits?: () => Promise<void>;
+    creditsBalance?: number;
+}
+
+export declare interface PaywallPrice {
+    amount: number;
+    currency: string;
+}
+
+export declare function prepareBlogIndex<T extends BlogIndexEntry>(entries: T[], query: BlogIndexQuery): PaginationResult<T>;
+
+export declare function prepareDocsIndex<T extends DocsIndexEntry>(entries: T[], query: DocsIndexQuery): PaginationResult<T>;
+
+/**
+ * Resolves the cedros-data server URL from options.
+ * Throws if no URL is available.
+ */
+export declare function resolveServerUrl(options: FetchOptions): string;
+
+export declare interface RouteAwareItem {
+    route: string;
+    isActive?: boolean;
+}
+
+export declare interface RouteMatcherOptions {
+    exact?: boolean;
+}
+
+/** Site-level settings record from the site_settings collection. */
+export declare interface SiteDataRecord {
+    siteTitle?: string;
+    siteName?: string;
+    siteDescription?: string;
+    defaultDescription?: string;
+    defaultOgImage?: string;
+    locale?: string;
+    timezone?: string;
+    [key: string]: unknown;
+}
+
+export declare function SiteFooter({ siteTitle, note, links, rightSlot, onNavigate, layout, }: SiteFooterProps): React.JSX.Element;
+
+export declare interface SiteFooterLink {
+    key: string;
+    label: string;
+    route: string;
+}
+
+export declare interface SiteFooterProps {
+    siteTitle: string;
+    note?: string;
+    links?: SiteFooterLink[];
+    rightSlot?: ReactNode;
+    onNavigate?: (route: string) => void;
+    layout?: FooterLayoutOptions;
+}
+
+/**
+ * Full-page layout shell with SafeAreaView, TopNav, ScrollView content, and SiteFooter.
+ */
+export declare function SiteLayout({ siteTitle, navigation, children, currentPath, footerNote, onNavigate, layout, }: SiteLayoutProps): React.JSX.Element;
+
+/** Combined layout options for the full site shell. */
+export declare interface SiteLayoutOptions {
+    nav?: NavLayoutOptions;
+    footer?: FooterLayoutOptions;
+}
+
+export declare interface SiteLayoutProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    children: ReactNode;
+    currentPath?: string;
+    footerNote?: string;
+    onNavigate?: (route: string) => void;
+    layout?: SiteLayoutOptions;
+}
+
+/** Navigation item used by layout components. */
+export declare interface SiteNavigationItem {
+    key: string;
+    label: string;
+    route: string;
+}
+
+export declare const SOL_CURRENCY: TipCurrency;
+
+/** Theme mode selector. */
+export declare type ThemeMode = "light" | "dark";
+
+export declare interface TipCurrency {
+    symbol: string;
+    decimals: number;
+    logo: string;
+    mint?: string;
+}
+
+/**
+ * Tipping widget for Solana-based cryptocurrency tips.
+ *
+ * Requires `@cedros/trade-react` at runtime for transaction building.
+ * In React Native, the consumer must provide `senderAddress` and `signTransaction`
+ * since there is no browser wallet.
+ */
+export declare function TipWidget({ dataServerUrl, recipient: recipientProp, currencies: currenciesProp, presets: presetsProp, label: labelProp, description: descriptionProp, senderAddress, signTransaction: signProp, }: TipWidgetProps): React.JSX.Element | null;
+
+export declare interface TipWidgetProps {
+    /** cedros-data server URL for config fetch. */
+    dataServerUrl?: string;
+    /** Tip recipient address. When provided, config fetch is skipped. */
+    recipient?: string;
+    currencies?: TipCurrency[];
+    presets?: Record<string, number[]>;
+    label?: string;
+    description?: string;
+    /** Sender wallet address. */
+    senderAddress?: string;
+    /** Signs a base64 serialized transaction, returns signed base64. */
+    signTransaction?: (serializedTx: string) => Promise<string>;
+}
+
+export declare interface TocEntry {
+    id: string;
+    label: string;
+    depth: 2 | 3 | 4;
+}
+
+/**
+ * Table of contents component with active state tracking.
+ *
+ * Unlike the web version (which uses IntersectionObserver), the RN version
+ * accepts `activeId` as a prop. Consumers should track scroll position in
+ * their ScrollView and pass the current heading ID.
+ *
+ * If `activeId` is not provided, tracks selection state internally on press.
+ */
+export declare function TocScrollSpy({ entries, activeId: externalActiveId, onPress, }: TocScrollSpyProps): React.JSX.Element;
+
+export declare interface TocScrollSpyProps {
+    entries: Array<{
+        id: string;
+        label: string;
+        depth?: 2 | 3 | 4;
+    }>;
+    activeId?: string;
+    onPress?: (id: string) => void;
+}
+
+export declare function TopNav({ siteTitle, navigation, currentPath, rightSlot, onNavigate, onBrandPress, layout, }: TopNavProps): React.JSX.Element;
+
+export declare interface TopNavProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    currentPath?: string;
+    rightSlot?: ReactNode;
+    onNavigate?: (route: string) => void;
+    onBrandPress?: () => void;
+    layout?: NavLayoutOptions;
+}
+
+export declare const USDC_CURRENCY: TipCurrency;
+
+/**
+ * Returns the current theme context.
+ *
+ * Must be called inside a `<CedrosDataProvider>`.
+ */
+export declare function useCedrosDataTheme(): CedrosDataThemeValue;
+
+/**
+ * Returns the current theme context, or `null` when outside a provider.
+ */
+export declare function useCedrosDataThemeOptional(): CedrosDataThemeValue | null;
+
+export declare function withActiveDocsSidebar(sections: DocsSidebarSection[], currentPath?: string): DocsSidebarSection[];
+
+export declare function withActiveRouteState<T extends RouteAwareItem>(items: T[], currentPath: string, options?: RouteMatcherOptions): Array<T & {
+    isActive: boolean;
+}>;
+
+export { }