@growflowstudio/billing-admin-ui 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present GrowFlow Studio
+
+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/index.d.mts

@@ -0,0 +1,329 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React$1 from 'react';
+import { Fetcher, AdminPlan, AdminPlanPricingModel, RecurringInterval, AdminProduct, AdminInvoice } from '@growflowstudio/billing-admin-core';
+
+interface LimitFieldConfig {
+    key: string;
+    label: string;
+    defaultValue?: number;
+}
+interface FeaturesConfig {
+    enabled: boolean;
+    fetchFn?: () => Promise<{
+        features: Array<{
+            slug: string;
+            name: string;
+            description?: string;
+        }>;
+    }>;
+}
+interface PublicPlansConfig {
+    enabled: boolean;
+    fetchFn?: () => Promise<{
+        public_plan_slugs: string[];
+    }>;
+    updateFn?: (slugs: string[]) => Promise<{
+        public_plan_slugs: string[];
+    }>;
+}
+/**
+ * Configure which billing modules are enabled for this project.
+ * By default, all modules are enabled.
+ *
+ * Examples:
+ * - Booking/WineTracking: { plans: true, subscriptions: true, products: false, features: false }
+ * - SweatMate: { plans: true, subscriptions: true, products: true, features: true }
+ * - ShopBrain: all enabled (default)
+ */
+interface BillingModulesConfig {
+    plans?: boolean;
+    subscriptions?: boolean;
+    products?: boolean;
+    payments?: boolean;
+    invoices?: boolean;
+    features?: boolean;
+}
+interface BillingAdminConfig {
+    /** Base path for billing admin API (e.g., '/api/v1/billing-admin') */
+    basePath: string;
+    /** HTTP fetcher function from the host application (handles auth) */
+    fetcher: Fetcher;
+    /** Locale for number/date formatting (default: 'it-IT') */
+    locale?: string;
+    /** Default currency (default: 'EUR') */
+    currency?: string;
+    /**
+     * Enable/disable billing modules per project.
+     * All modules are enabled by default.
+     */
+    modules?: BillingModulesConfig;
+    /** Plan-specific configurations */
+    plans?: {
+        /** Configurable limit fields for plan forms */
+        limitFields?: LimitFieldConfig[];
+        /** Feature selection in plan forms */
+        features?: FeaturesConfig;
+        /** Public plans toggle (ShopBrain-specific) */
+        publicPlans?: PublicPlansConfig;
+    };
+    /** Product-specific configurations */
+    products?: {
+        /** Feature linking in product forms */
+        features?: FeaturesConfig;
+    };
+}
+declare function useBillingAdminConfig(): BillingAdminConfig;
+/** Returns the resolved modules config (with defaults applied) */
+declare function useEnabledModules(): Required<BillingModulesConfig>;
+interface BillingAdminProviderProps {
+    config: BillingAdminConfig;
+    children: React$1.ReactNode;
+}
+declare function BillingAdminProvider({ config, children }: BillingAdminProviderProps): react_jsx_runtime.JSX.Element;
+
+interface PlansPageProps {
+    /** Optional wrapper component for the page content */
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    /** Optional header component */
+    header?: React.ReactNode;
+}
+declare function PlansPage({ wrapper: Wrapper, header }: PlansPageProps): react_jsx_runtime.JSX.Element;
+
+interface ProductsPageProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    header?: React.ReactNode;
+}
+declare function ProductsPage({ wrapper: Wrapper, header }: ProductsPageProps): react_jsx_runtime.JSX.Element;
+
+interface SubscriptionsPageProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    header?: React.ReactNode;
+}
+declare function SubscriptionsPage({ wrapper: Wrapper, header }: SubscriptionsPageProps): react_jsx_runtime.JSX.Element;
+
+interface PaymentsPageProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    header?: React.ReactNode;
+}
+declare function PaymentsPage({ wrapper: Wrapper, header }: PaymentsPageProps): react_jsx_runtime.JSX.Element;
+
+interface InvoicesPageProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    header?: React.ReactNode;
+}
+declare function InvoicesPage({ wrapper: Wrapper, header }: InvoicesPageProps): react_jsx_runtime.JSX.Element;
+
+interface FeaturesPageProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    header?: React.ReactNode;
+}
+declare function FeaturesPage({ wrapper: Wrapper, header }: FeaturesPageProps): react_jsx_runtime.JSX.Element;
+
+interface PlansTableProps {
+    plans: AdminPlan[];
+    isLoading: boolean;
+    onEdit: (plan: AdminPlan) => void;
+    onDelete: (plan: AdminPlan) => void;
+    onSync: (planId: string) => void;
+    isSyncing: boolean;
+}
+declare function PlansTable({ plans, isLoading, onEdit, onDelete, onSync, isSyncing, }: PlansTableProps): react_jsx_runtime.JSX.Element;
+
+interface PlanFormData {
+    slug: string;
+    name: string;
+    description: string;
+    pricing_model: AdminPlanPricingModel;
+    price_monthly: string;
+    price_yearly: string;
+    currency: string;
+    trial_days: number;
+    is_active: boolean;
+    contact_sales: boolean;
+    is_public: boolean;
+    color: string;
+    limits: Record<string, number>;
+    limits_unlimited: Record<string, boolean>;
+    features: string;
+    sort_order: number;
+}
+declare function createDefaultPlanFormData(limitFields?: LimitFieldConfig[]): PlanFormData;
+interface PlanFormDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    formData: PlanFormData;
+    onFormDataChange: (data: Partial<PlanFormData>) => void;
+    formErrors: Record<string, string>;
+    selectedPlan: AdminPlan | null;
+    onSubmit: () => void;
+    isPending: boolean;
+}
+declare function PlanFormDialog({ open, onOpenChange, formData, onFormDataChange, formErrors, selectedPlan, onSubmit, isPending, }: PlanFormDialogProps): react_jsx_runtime.JSX.Element | null;
+
+interface LimitInputProps {
+    id: string;
+    label: string;
+    value: number;
+    isUnlimited: boolean;
+    onValueChange: (value: number) => void;
+    onUnlimitedChange: (unlimited: boolean) => void;
+    min?: number;
+}
+declare function LimitInput({ id, label, value, isUnlimited, onValueChange, onUnlimitedChange, min, }: LimitInputProps): react_jsx_runtime.JSX.Element;
+
+declare const PLAN_COLORS: readonly [{
+    readonly value: "gray";
+    readonly label: "Grigio";
+    readonly className: "bg-gray-100 text-gray-700 dark:bg-gray-800 dark:text-gray-400";
+}, {
+    readonly value: "green";
+    readonly label: "Verde";
+    readonly className: "bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400";
+}, {
+    readonly value: "blue";
+    readonly label: "Blu";
+    readonly className: "bg-blue-100 text-blue-700 dark:bg-blue-900/30 dark:text-blue-400";
+}, {
+    readonly value: "purple";
+    readonly label: "Viola";
+    readonly className: "bg-purple-100 text-purple-700 dark:bg-purple-900/30 dark:text-purple-400";
+}, {
+    readonly value: "amber";
+    readonly label: "Ambra";
+    readonly className: "bg-amber-100 text-amber-700 dark:bg-amber-900/30 dark:text-amber-400";
+}, {
+    readonly value: "red";
+    readonly label: "Rosso";
+    readonly className: "bg-red-100 text-red-700 dark:bg-red-900/30 dark:text-red-400";
+}, {
+    readonly value: "pink";
+    readonly label: "Rosa";
+    readonly className: "bg-pink-100 text-pink-700 dark:bg-pink-900/30 dark:text-pink-400";
+}, {
+    readonly value: "indigo";
+    readonly label: "Indaco";
+    readonly className: "bg-indigo-100 text-indigo-700 dark:bg-indigo-900/30 dark:text-indigo-400";
+}];
+type PlanColorValue = typeof PLAN_COLORS[number]['value'];
+declare function getPlanColorClass(color: string | undefined): string;
+
+interface ProductFormData {
+    name: string;
+    description: string;
+    price_cents: string;
+    currency: string;
+    recurring_interval: RecurringInterval | '';
+    category: string;
+    is_active: boolean;
+    sync_stripe: boolean;
+    feature_slug: string;
+    extra_data: string;
+}
+declare const defaultProductFormData: ProductFormData;
+interface AvailableFeature {
+    slug: string;
+    name: string;
+}
+interface ProductFormDialogProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    mode: 'create' | 'edit';
+    product?: AdminProduct | null;
+    features?: AvailableFeature[];
+    onSubmit: (data: ProductFormData) => void;
+    isSubmitting: boolean;
+}
+declare function ProductFormDialog({ isOpen, onOpenChange, mode, product, features, onSubmit, isSubmitting, }: ProductFormDialogProps): react_jsx_runtime.JSX.Element | null;
+
+interface InvoiceDetailsDialogProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    invoice: AdminInvoice | null | undefined;
+}
+declare function InvoiceDetailsDialog({ isOpen, onOpenChange, invoice }: InvoiceDetailsDialogProps): react_jsx_runtime.JSX.Element | null;
+
+interface DeleteConfirmDialogProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    title?: string;
+    description: React$1.ReactNode;
+    onConfirm: () => void;
+    isDeleting: boolean;
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+/**
+ * Reusable confirmation dialog for destructive actions.
+ * Uses native HTML dialog to avoid requiring shadcn AlertDialog as peer dependency.
+ * Consumer projects can override this component via the provider if needed.
+ */
+declare function DeleteConfirmDialog({ isOpen, onOpenChange, title, description, onConfirm, isDeleting, confirmLabel, cancelLabel, }: DeleteConfirmDialogProps): react_jsx_runtime.JSX.Element | null;
+
+interface CursorPaginationProps {
+    cursor: string | undefined;
+    hasMore: boolean;
+    items: Array<{
+        id: string;
+    }>;
+    onFirstPage: () => void;
+    onNextPage: (lastItemId: string) => void;
+}
+declare function CursorPagination({ cursor, hasMore, items, onFirstPage, onNextPage, }: CursorPaginationProps): react_jsx_runtime.JSX.Element;
+
+interface FilterOption {
+    value: string;
+    label: string;
+}
+interface FilterBarProps {
+    searchPlaceholder?: string;
+    searchValue: string;
+    onSearchChange: (value: string) => void;
+    statusFilter?: string;
+    onStatusFilterChange?: (value: string) => void;
+    statusOptions?: FilterOption[];
+    onRefresh: () => void;
+}
+declare function FilterBar({ searchPlaceholder, searchValue, onSearchChange, statusFilter, onStatusFilterChange, statusOptions, onRefresh, }: FilterBarProps): react_jsx_runtime.JSX.Element;
+
+interface StatusBadgeProps {
+    label: string;
+    colorClass: string;
+    className?: string;
+}
+declare function StatusBadge({ label, colorClass, className }: StatusBadgeProps): react_jsx_runtime.JSX.Element;
+
+interface SkeletonRowsProps {
+    rows?: number;
+    columns?: number;
+}
+declare function SkeletonRows({ rows, columns }: SkeletonRowsProps): react_jsx_runtime.JSX.Element;
+
+interface BillingNavItem {
+    key: string;
+    label: string;
+    /** Lucide icon name (consumer maps to actual icon component) */
+    icon: string;
+    /** Suggested href path (consumer can override) */
+    href: string;
+}
+/**
+ * Returns navigation items filtered by enabled modules.
+ *
+ * @param modules - The modules config from BillingAdminProvider
+ * @param basePath - Optional base path prefix (e.g., '/dashboard')
+ */
+declare function getBillingNavItems(modules?: BillingModulesConfig, basePath?: string): BillingNavItem[];
+
+export { type BillingAdminConfig, BillingAdminProvider, type BillingAdminProviderProps, type BillingModulesConfig, type BillingNavItem, CursorPagination, DeleteConfirmDialog, type FeaturesConfig, FeaturesPage, type FeaturesPageProps, FilterBar, InvoiceDetailsDialog, InvoicesPage, type InvoicesPageProps, type LimitFieldConfig, LimitInput, PLAN_COLORS, PaymentsPage, type PaymentsPageProps, type PlanColorValue, type PlanFormData, PlanFormDialog, PlansPage, type PlansPageProps, PlansTable, type ProductFormData, ProductFormDialog, ProductsPage, type ProductsPageProps, type PublicPlansConfig, SkeletonRows, StatusBadge, SubscriptionsPage, type SubscriptionsPageProps, createDefaultPlanFormData, defaultProductFormData, getBillingNavItems, getPlanColorClass, useBillingAdminConfig, useEnabledModules };

package/dist/index.d.ts

@@ -0,0 +1,329 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React$1 from 'react';
+import { Fetcher, AdminPlan, AdminPlanPricingModel, RecurringInterval, AdminProduct, AdminInvoice } from '@growflowstudio/billing-admin-core';
+
+interface LimitFieldConfig {
+    key: string;
+    label: string;
+    defaultValue?: number;
+}
+interface FeaturesConfig {
+    enabled: boolean;
+    fetchFn?: () => Promise<{
+        features: Array<{
+            slug: string;
+            name: string;
+            description?: string;
+        }>;
+    }>;
+}
+interface PublicPlansConfig {
+    enabled: boolean;
+    fetchFn?: () => Promise<{
+        public_plan_slugs: string[];
+    }>;
+    updateFn?: (slugs: string[]) => Promise<{
+        public_plan_slugs: string[];
+    }>;
+}
+/**
+ * Configure which billing modules are enabled for this project.
+ * By default, all modules are enabled.
+ *
+ * Examples:
+ * - Booking/WineTracking: { plans: true, subscriptions: true, products: false, features: false }
+ * - SweatMate: { plans: true, subscriptions: true, products: true, features: true }
+ * - ShopBrain: all enabled (default)
+ */
+interface BillingModulesConfig {
+    plans?: boolean;
+    subscriptions?: boolean;
+    products?: boolean;
+    payments?: boolean;
+    invoices?: boolean;
+    features?: boolean;
+}
+interface BillingAdminConfig {
+    /** Base path for billing admin API (e.g., '/api/v1/billing-admin') */
+    basePath: string;
+    /** HTTP fetcher function from the host application (handles auth) */
+    fetcher: Fetcher;
+    /** Locale for number/date formatting (default: 'it-IT') */
+    locale?: string;
+    /** Default currency (default: 'EUR') */
+    currency?: string;
+    /**
+     * Enable/disable billing modules per project.
+     * All modules are enabled by default.
+     */
+    modules?: BillingModulesConfig;
+    /** Plan-specific configurations */
+    plans?: {
+        /** Configurable limit fields for plan forms */
+        limitFields?: LimitFieldConfig[];
+        /** Feature selection in plan forms */
+        features?: FeaturesConfig;
+        /** Public plans toggle (ShopBrain-specific) */
+        publicPlans?: PublicPlansConfig;
+    };
+    /** Product-specific configurations */
+    products?: {
+        /** Feature linking in product forms */
+        features?: FeaturesConfig;
+    };
+}
+declare function useBillingAdminConfig(): BillingAdminConfig;
+/** Returns the resolved modules config (with defaults applied) */
+declare function useEnabledModules(): Required<BillingModulesConfig>;
+interface BillingAdminProviderProps {
+    config: BillingAdminConfig;
+    children: React$1.ReactNode;
+}
+declare function BillingAdminProvider({ config, children }: BillingAdminProviderProps): react_jsx_runtime.JSX.Element;
+
+interface PlansPageProps {
+    /** Optional wrapper component for the page content */
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    /** Optional header component */
+    header?: React.ReactNode;
+}
+declare function PlansPage({ wrapper: Wrapper, header }: PlansPageProps): react_jsx_runtime.JSX.Element;
+
+interface ProductsPageProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    header?: React.ReactNode;
+}
+declare function ProductsPage({ wrapper: Wrapper, header }: ProductsPageProps): react_jsx_runtime.JSX.Element;
+
+interface SubscriptionsPageProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    header?: React.ReactNode;
+}
+declare function SubscriptionsPage({ wrapper: Wrapper, header }: SubscriptionsPageProps): react_jsx_runtime.JSX.Element;
+
+interface PaymentsPageProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    header?: React.ReactNode;
+}
+declare function PaymentsPage({ wrapper: Wrapper, header }: PaymentsPageProps): react_jsx_runtime.JSX.Element;
+
+interface InvoicesPageProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    header?: React.ReactNode;
+}
+declare function InvoicesPage({ wrapper: Wrapper, header }: InvoicesPageProps): react_jsx_runtime.JSX.Element;
+
+interface FeaturesPageProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    header?: React.ReactNode;
+}
+declare function FeaturesPage({ wrapper: Wrapper, header }: FeaturesPageProps): react_jsx_runtime.JSX.Element;
+
+interface PlansTableProps {
+    plans: AdminPlan[];
+    isLoading: boolean;
+    onEdit: (plan: AdminPlan) => void;
+    onDelete: (plan: AdminPlan) => void;
+    onSync: (planId: string) => void;
+    isSyncing: boolean;
+}
+declare function PlansTable({ plans, isLoading, onEdit, onDelete, onSync, isSyncing, }: PlansTableProps): react_jsx_runtime.JSX.Element;
+
+interface PlanFormData {
+    slug: string;
+    name: string;
+    description: string;
+    pricing_model: AdminPlanPricingModel;
+    price_monthly: string;
+    price_yearly: string;
+    currency: string;
+    trial_days: number;
+    is_active: boolean;
+    contact_sales: boolean;
+    is_public: boolean;
+    color: string;
+    limits: Record<string, number>;
+    limits_unlimited: Record<string, boolean>;
+    features: string;
+    sort_order: number;
+}
+declare function createDefaultPlanFormData(limitFields?: LimitFieldConfig[]): PlanFormData;
+interface PlanFormDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    formData: PlanFormData;
+    onFormDataChange: (data: Partial<PlanFormData>) => void;
+    formErrors: Record<string, string>;
+    selectedPlan: AdminPlan | null;
+    onSubmit: () => void;
+    isPending: boolean;
+}
+declare function PlanFormDialog({ open, onOpenChange, formData, onFormDataChange, formErrors, selectedPlan, onSubmit, isPending, }: PlanFormDialogProps): react_jsx_runtime.JSX.Element | null;
+
+interface LimitInputProps {
+    id: string;
+    label: string;
+    value: number;
+    isUnlimited: boolean;
+    onValueChange: (value: number) => void;
+    onUnlimitedChange: (unlimited: boolean) => void;
+    min?: number;
+}
+declare function LimitInput({ id, label, value, isUnlimited, onValueChange, onUnlimitedChange, min, }: LimitInputProps): react_jsx_runtime.JSX.Element;
+
+declare const PLAN_COLORS: readonly [{
+    readonly value: "gray";
+    readonly label: "Grigio";
+    readonly className: "bg-gray-100 text-gray-700 dark:bg-gray-800 dark:text-gray-400";
+}, {
+    readonly value: "green";
+    readonly label: "Verde";
+    readonly className: "bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400";
+}, {
+    readonly value: "blue";
+    readonly label: "Blu";
+    readonly className: "bg-blue-100 text-blue-700 dark:bg-blue-900/30 dark:text-blue-400";
+}, {
+    readonly value: "purple";
+    readonly label: "Viola";
+    readonly className: "bg-purple-100 text-purple-700 dark:bg-purple-900/30 dark:text-purple-400";
+}, {
+    readonly value: "amber";
+    readonly label: "Ambra";
+    readonly className: "bg-amber-100 text-amber-700 dark:bg-amber-900/30 dark:text-amber-400";
+}, {
+    readonly value: "red";
+    readonly label: "Rosso";
+    readonly className: "bg-red-100 text-red-700 dark:bg-red-900/30 dark:text-red-400";
+}, {
+    readonly value: "pink";
+    readonly label: "Rosa";
+    readonly className: "bg-pink-100 text-pink-700 dark:bg-pink-900/30 dark:text-pink-400";
+}, {
+    readonly value: "indigo";
+    readonly label: "Indaco";
+    readonly className: "bg-indigo-100 text-indigo-700 dark:bg-indigo-900/30 dark:text-indigo-400";
+}];
+type PlanColorValue = typeof PLAN_COLORS[number]['value'];
+declare function getPlanColorClass(color: string | undefined): string;
+
+interface ProductFormData {
+    name: string;
+    description: string;
+    price_cents: string;
+    currency: string;
+    recurring_interval: RecurringInterval | '';
+    category: string;
+    is_active: boolean;
+    sync_stripe: boolean;
+    feature_slug: string;
+    extra_data: string;
+}
+declare const defaultProductFormData: ProductFormData;
+interface AvailableFeature {
+    slug: string;
+    name: string;
+}
+interface ProductFormDialogProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    mode: 'create' | 'edit';
+    product?: AdminProduct | null;
+    features?: AvailableFeature[];
+    onSubmit: (data: ProductFormData) => void;
+    isSubmitting: boolean;
+}
+declare function ProductFormDialog({ isOpen, onOpenChange, mode, product, features, onSubmit, isSubmitting, }: ProductFormDialogProps): react_jsx_runtime.JSX.Element | null;
+
+interface InvoiceDetailsDialogProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    invoice: AdminInvoice | null | undefined;
+}
+declare function InvoiceDetailsDialog({ isOpen, onOpenChange, invoice }: InvoiceDetailsDialogProps): react_jsx_runtime.JSX.Element | null;
+
+interface DeleteConfirmDialogProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    title?: string;
+    description: React$1.ReactNode;
+    onConfirm: () => void;
+    isDeleting: boolean;
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+/**
+ * Reusable confirmation dialog for destructive actions.
+ * Uses native HTML dialog to avoid requiring shadcn AlertDialog as peer dependency.
+ * Consumer projects can override this component via the provider if needed.
+ */
+declare function DeleteConfirmDialog({ isOpen, onOpenChange, title, description, onConfirm, isDeleting, confirmLabel, cancelLabel, }: DeleteConfirmDialogProps): react_jsx_runtime.JSX.Element | null;
+
+interface CursorPaginationProps {
+    cursor: string | undefined;
+    hasMore: boolean;
+    items: Array<{
+        id: string;
+    }>;
+    onFirstPage: () => void;
+    onNextPage: (lastItemId: string) => void;
+}
+declare function CursorPagination({ cursor, hasMore, items, onFirstPage, onNextPage, }: CursorPaginationProps): react_jsx_runtime.JSX.Element;
+
+interface FilterOption {
+    value: string;
+    label: string;
+}
+interface FilterBarProps {
+    searchPlaceholder?: string;
+    searchValue: string;
+    onSearchChange: (value: string) => void;
+    statusFilter?: string;
+    onStatusFilterChange?: (value: string) => void;
+    statusOptions?: FilterOption[];
+    onRefresh: () => void;
+}
+declare function FilterBar({ searchPlaceholder, searchValue, onSearchChange, statusFilter, onStatusFilterChange, statusOptions, onRefresh, }: FilterBarProps): react_jsx_runtime.JSX.Element;
+
+interface StatusBadgeProps {
+    label: string;
+    colorClass: string;
+    className?: string;
+}
+declare function StatusBadge({ label, colorClass, className }: StatusBadgeProps): react_jsx_runtime.JSX.Element;
+
+interface SkeletonRowsProps {
+    rows?: number;
+    columns?: number;
+}
+declare function SkeletonRows({ rows, columns }: SkeletonRowsProps): react_jsx_runtime.JSX.Element;
+
+interface BillingNavItem {
+    key: string;
+    label: string;
+    /** Lucide icon name (consumer maps to actual icon component) */
+    icon: string;
+    /** Suggested href path (consumer can override) */
+    href: string;
+}
+/**
+ * Returns navigation items filtered by enabled modules.
+ *
+ * @param modules - The modules config from BillingAdminProvider
+ * @param basePath - Optional base path prefix (e.g., '/dashboard')
+ */
+declare function getBillingNavItems(modules?: BillingModulesConfig, basePath?: string): BillingNavItem[];
+
+export { type BillingAdminConfig, BillingAdminProvider, type BillingAdminProviderProps, type BillingModulesConfig, type BillingNavItem, CursorPagination, DeleteConfirmDialog, type FeaturesConfig, FeaturesPage, type FeaturesPageProps, FilterBar, InvoiceDetailsDialog, InvoicesPage, type InvoicesPageProps, type LimitFieldConfig, LimitInput, PLAN_COLORS, PaymentsPage, type PaymentsPageProps, type PlanColorValue, type PlanFormData, PlanFormDialog, PlansPage, type PlansPageProps, PlansTable, type ProductFormData, ProductFormDialog, ProductsPage, type ProductsPageProps, type PublicPlansConfig, SkeletonRows, StatusBadge, SubscriptionsPage, type SubscriptionsPageProps, createDefaultPlanFormData, defaultProductFormData, getBillingNavItems, getPlanColorClass, useBillingAdminConfig, useEnabledModules };