@igamingcareer/igaming-components 1.2.23 → 1.2.25

package/dist/types/src/hooks/use-lead-form.d.ts

@@ -0,0 +1,21 @@
+/**
+ * useLeadForm Hook
+ * Manages form state and API submission for lead capture
+ */
+import { UseFormSetError } from 'react-hook-form';
+import { LeadFormData, LeadFormResponse, LeadFormConfig } from '../types/lead';
+/**
+ * Hook for managing lead form submission
+ */
+export declare const useLeadForm: (config?: LeadFormConfig) => {
+    submitLead: (formData: LeadFormData, setError?: UseFormSetError<LeadFormData>) => Promise<LeadFormResponse | null>;
+    resetState: () => void;
+    isLoading: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+    error?: string;
+};
+/**
+ * Hook for getting auto-populated metadata without submitting
+ */
+export declare const useLeadMetadata: (sourcePage?: string, campaign?: string, language?: "es" | "en") => Partial<LeadFormData> | null;

package/dist/types/src/hooks/useCareerAssistant.d.ts

@@ -0,0 +1,7 @@
+import { ChatMessage } from "@/types/chat-messages";
+export declare function useCareerAssistant(): {
+    messages: ChatMessage[];
+    isLoading: boolean;
+    sendMessage: (text: string) => Promise<void>;
+    setMessages: import("react").Dispatch<import("react").SetStateAction<ChatMessage[]>>;
+};

package/dist/types/src/hooks/useLocalStorage.d.ts

@@ -0,0 +1,36 @@
+export declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((prev: T) => T)) => void, () => void];
+export interface SavedEvaluation {
+    ticker: string;
+    companyName: string;
+    scores: Record<string, number>;
+    gates: Record<string, boolean>;
+    thesis: string;
+    savedAt: number;
+    verdict: string;
+    total: number | null;
+}
+export declare function useSavedEvaluations(): {
+    evals: SavedEvaluation[];
+    saveEvaluation: (evaluation: SavedEvaluation) => void;
+    deleteEvaluation: (ticker: string) => void;
+    getEvaluation: (ticker: string) => SavedEvaluation | null;
+    clearEvals: () => void;
+};
+export declare function useWatchlistTickers(): {
+    tickers: string[];
+    add: (ticker: string) => void;
+    remove: (ticker: string) => void;
+    has: (ticker: string) => boolean;
+    clearTickers: () => void;
+};
+export interface MonthlySnapshot {
+    savedAt: number;
+    scores: Record<string, number | null>;
+}
+export declare function useMonthlySnapshot(): {
+    snapshot: MonthlySnapshot | null;
+    saveSnapshot: (scores: Record<string, number | null>) => void;
+    getDelta: (ticker: string, currentScore: number | null) => number | null;
+    clearSnapshot: () => void;
+    daysSinceSnapshot: number | null;
+};

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

@@ -0,0 +1,170 @@
+export { Button } from '../components/ui/button';
+export { Input } from '../components/ui/input';
+export { Textarea } from '../components/ui/textarea';
+export { TagPicker } from './components/TagPicker/TagPicker';
+export { TagBadge } from './components/TagBadge/TagBadge';
+export { Badge } from '../components/ui/badge';
+export { default as GroupPrices } from './components/Prices/Group/GroupPrices';
+export { default as SlidingSummary } from './components/Prices/Summary/SlidingSummary';
+export { default as HomePage } from './components/HomePage/HomePage';
+export { default as Hero } from './components/HomePage/Hero';
+export { default as ServicesNoIcons } from './components/HomePage/ServicesNoIcons';
+export { default as Advantages } from './components/HomePage/Advantages';
+export { default as Features } from './components/HomePage/Features';
+export { default as Gallery } from './components/HomePage/Gallery';
+export { default as Destinations } from './components/HomePage/Destinations';
+export { default as Courses } from './components/HomePage/Courses';
+export { default as Cart } from './components/HomePage/Cart';
+export { default as Videos } from './components/HomePage/Videos';
+export { default as Testimonials } from './components/HomePage/Testimonials';
+export { default as FAQ } from './components/HomePage/FAQ';
+export { default as Chatbot } from './components/HomePage/Chatbot';
+export { default as Services } from './components/HomePage/Services';
+export { default as CourseTypes } from './components/HomePage/CourseTypes';
+export { default as FeatureJobs } from './components/HomePage/FeatureJobs';
+export { default as ForEmployers } from './components/HomePage/ForEmployers';
+export { default as HeroAlternative } from './components/HomePage/HeroAlternative';
+export { default as IgamingCareerHome } from './components/HomePage/IgamingCareerHome';
+export { default as FooterLib } from './components/Footer/Footer';
+export { default as JobSearchWidget } from './components/HomePage/JobsSearchWidget';
+export { default as Partners } from './components/HomePage/Partners';
+export { default as Newsletter } from './components/HomePage/Newsletter';
+export { default as NewsletterV2 } from './components/HomePage/NewsletterV2';
+export { default as TrustSignals } from './components/HomePage/TrustSignals';
+export { default as ValueProposition } from './components/HomePage/ValueProposition';
+export { default as SidebarNewsletter } from './components/HomePage/SidebarNewsletter';
+export { default as SidebarNewsletterV2 } from './components/HomePage/SidebarNewsletterV2';
+export { default as NotificationModal } from './components/HomePage/NotificationModal';
+export { default as JobListings } from './components/JobListing/JobListing';
+export { default as Footer } from './components/JobListing/components/Footer';
+export { default as Navbar } from './components/JobListing/components/Navbar';
+export { default as Banner } from './components/GenericListing/Banner';
+export { default as MobileNav } from './components/GenericListing/MobileNav';
+export { default as SearchableSelect } from './components/GenericListing/SearchableSelect';
+export { default as Listing } from './components/GenericListing/Listing';
+export { default as JobsList } from './components/Jobs/JobsList';
+export { default as EventsList } from './components/Events/EventsList';
+export { default as PlacesList } from './components/Places/PlacesList';
+export { default as ProductCategoriesList } from './components/ProductCategories/ProductCategoriesList';
+export { default as ProductCategoryDetail } from './components/ProductCategories/ProductCategoryDetail';
+export { default as MarketsList } from './components/Markets/MarketsList';
+export { default as RegulatorsList } from './components/Regulators/RegulatorsList';
+export { default as JurisdictionsList } from './components/Regulators/JurisdictionsList';
+export { default as Complaints } from './components/Complaints/Complaints';
+export { default as Reviews } from './components/Reviews/Reviews';
+export { default as MarketDetail } from './components/MarketDetail/MarketDetail';
+export { default as RegulatorDetail } from './components/RegulatorDetail/RegulatorDetail';
+export { default as JobDetailPage } from './components/JobsDetails/JobDetail';
+export { default as HeaderAlternative } from './components/Header/HeaderAlternative';
+export { default as Header } from './components/Header/Header';
+export { default as NewsPage } from './components/NewsPage/NewsPage';
+export { default as NewsList } from './components/News/NewsList';
+export { default as CoursesPage } from './components/IgamingCoursesPage/IgamingCoursesPage';
+export { default as CoursesList } from './components/Courses/CoursesList';
+export { default as CandidateProfile } from './components/CandidateProfile/CandidateProfile';
+export { default as CompanyDirectory } from './components/Companies/CompanyDirectory';
+export { default as CompaniesList } from './components/Companies/CompaniesList';
+export { default as CompanyDetail } from './components/Companies/CompanyDetail';
+export { default as CompanyGroupDetail } from './components/Companies/CompanyGroupDetail';
+export { default as CompanyDirectoryContainer } from './components/Companies/CompanyDirectoryContainer';
+export { default as CompanyClaim } from './components/Companies/components/CompanyClaim';
+export { default as CompanyAdminShell } from './components/Companies/components/CompanyAdminShell';
+export { default as CompanyAdminEditDialog } from './components/Companies/components/CompanyAdminEditDialog';
+export { default as CompanyAdminOverview } from './components/Companies/components/admin/CompanyAdminOverview';
+export { default as CompanyAdminProducts } from './components/Companies/components/admin/CompanyAdminProducts';
+export { default as CompanyAdminPeople } from './components/Companies/components/admin/CompanyAdminPeople';
+export { default as CompanyAdminJobs } from './components/Companies/components/admin/CompanyAdminJobs';
+export { default as CompanyAdminCandidates } from './components/Companies/components/admin/CompanyAdminCandidates';
+export { default as CompanyAdminEvents } from './components/Companies/components/admin/CompanyAdminEvents';
+export { default as CompanyAdminNews } from './components/Companies/components/admin/CompanyAdminNews';
+export { default as CompanyAdminSettings } from './components/Companies/components/admin/CompanyAdminSettings';
+export type { Company, CompanyClaimRequestPayload, CompanyDetailTab, CompanyDetailTabChangeEvent, CompanyFollowActionPayload, SaveCompanyPayload, SimilarCompanyItem, } from './components/Companies/types';
+export type { ToastActionElement, ToastProps, } from '../components/ui/toast';
+export type { AdminTab, CompanyAdminCompanyMeta, CompanyAdminPermissions, CompanyAdminRole, CompanyAdminShellProps, CompanyAdminSummaryStat, } from './components/Companies/components/CompanyAdminShell';
+export type { CompanyAdminUpdateEvent, CandidatesUpdatePayload } from './components/Companies/types/companyAdmin';
+export type { CompanyAdminEditPayload } from './components/Companies/components/CompanyAdminEditDialog';
+export { canEditSection, getEnabledPermissions } from './components/Companies/utils/permissions';
+export { safeArray } from './utils/safeArray';
+export { default as CandidateCard } from './components/Companies/components/admin/CandidateCard';
+export { default as LoadingShadowCard } from "./components/Shared/LoadingShadowCard";
+export type { Candidate, CandidateStatus, CandidateRating, CandidateNote } from './types/candidate';
+export { default as CareerPathCard } from './components/Shared/Cards/CareerPathCard';
+export { default as DepartmentCard } from './components/Shared/Cards/DepartmentCard';
+export { default as PlaybookCard } from './components/Shared/Cards/PlaybookCard';
+export { default as RoleGuideCard } from './components/Shared/Cards/RoleGuideCard';
+export { default as TermCard } from './components/Shared/Cards/TermCard';
+export { default as VideoCard } from './components/Shared/Cards/VideoCard';
+export { default as ChannelCard } from './components/Shared/Cards/ChannelCard';
+export { default as GamblingVerticalCard } from './components/Shared/Cards/GamblingVerticalCard';
+export { default as DepartmentEntityCard } from './components/Shared/Cards/DepartmentEntityCard';
+export { default as CompanyTypeCard } from './components/Shared/Cards/CompanyTypeCard';
+export { default as DirectoryDetailCard } from './components/Shared/Cards/DirectoryDetailCard';
+export { default as DirectoryKeyRolesList } from './components/Shared/Cards/DirectoryKeyRolesList';
+export { default as DirectoryInfoPanel } from './components/Shared/Cards/DirectoryInfoPanel';
+export { default as ConsentBanner } from './components/Consent/ConsentBanner';
+export { ConsentProvider, useConsent } from './components/Consent/ConsentContext';
+export { default as Analytics } from './components/Consent/Analytics';
+export { default as Login } from './components/Auth/Login';
+export type { LoginProps } from './components/Auth/Login';
+export { default as Register } from './components/Auth/Register';
+export { default as RegisterV2 } from './components/Auth/RegisterV2';
+export type { RegisterV2Props } from './components/Auth/RegisterV2';
+export { default as ForgotPassword } from './components/Auth/ForgotPassword';
+export { default as SignInPromptModal } from './components/Auth/SignInPromptModal';
+export { SocialDivider } from './components/Auth/SocialDivider';
+export type { SocialDividerProps } from './components/Auth/SocialDivider';
+export { default as VerificationBanner } from './components/Auth/VerificationBanner';
+export type { VerificationBannerProps } from './components/Auth/VerificationBanner';
+export { SocialButton } from './components/Auth/SocialButton';
+export type { SocialButtonProps, SocialProvider } from './components/Auth/SocialButton';
+export { default as Dashboard } from './components/Dashboard/Dashboard';
+export { default as CompanyDashboard } from './components/Dashboard/CompanyDashboard';
+export { default as OnboardingDashboard } from './components/Onboarding/OnboardingDashboard';
+export type { OnboardingDashboardProps } from './components/Onboarding/OnboardingDashboard';
+export { default as OnboardingChecklist } from './components/Onboarding/OnboardingChecklist';
+export type { OnboardingChecklistProps } from './components/Onboarding/OnboardingChecklist';
+export { default as OnboardingModal } from "./components/Onboarding/OnboardingModal";
+export { OnboardingProvider, useOnboardingContext } from "./components/Onboarding/OnboardingContext";
+export { default as DashboardOnboardingSection } from "./components/Onboarding/DashboardOnboardingSection";
+export type { OnboardingBackendFlags, OnboardingStep, OnboardingStepAction, OnboardingStepId, OnboardingStepStatus, ChecklistStep, } from "./types/onboarding";
+export { mapBackendFlagsToSteps, calculateOnboardingProgress } from "./types/onboarding";
+export { default as ShieldedActionButton } from './components/Shared/ShieldedActionButton';
+export type { ShieldedActionButtonProps } from './components/Shared/ShieldedActionButton';
+export { DirectoryShell, DirectoryToolbar, ViewModeToggle as DirectoryViewModeToggle } from "./components/Shared/Directory";
+export type { DirectoryActiveFilter, DirectoryFilterOption, DirectoryFilterSection, DirectoryFilterValues, DirectoryPagination, DirectorySearchProps, DirectorySortOption, DirectorySortProps, DirectoryViewMode, } from "./components/Shared/Directory";
+export type { CompanyDashboardData, CompanyEmployeeDashboardData, CompanyOwnerDashboardData, CompanyRecruiterDashboardData, DashboardRole, DashboardTab, DashboardTabChangeEvent, } from './types/dashboard';
+export type { EmittedEvent, EmittedEventHandler, ListingEventContext } from './types/events';
+export type { JobsListingEvent } from './types/events.jobs';
+export type { CoursesListingEvent } from './types/events.courses';
+export type { NewsListingEvent } from './types/events.news';
+export type { FreelancersListingEvent } from './types/events.freelancers';
+export type { NewsletterEvent } from './types/events.newsletter';
+export type { NewsletterV2Props, NewsletterSubscribePayload } from './components/HomePage/NewsletterV2';
+export type { SidebarNewsletterV2Props } from './components/HomePage/SidebarNewsletterV2';
+export { default as FreelancerProfile } from './components/Freelancer/FreelancerProfile';
+export { default as Freelancers } from './components/Freelancer/Freelancers';
+export { default as FreelancersList } from './components/Freelancer/FreelancersList';
+export { default as FreelancersContainer } from './components/Freelancer/FreelancersContainer';
+export { default as FreelancerProfileContainer } from './components/Freelancer/FreelancerProfileContainer';
+export { default as UserIdentityMenu } from "./components/Shared/Mobile/UserIdentityMenu";
+export { default as TaxonomySuggestionTable } from "./components/Shared/Taxonomy/TaxonomySuggestionTable";
+export { default as TaxonomySuggestionDetail } from "./components/Shared/Taxonomy/TaxonomySuggestionDetail";
+export { default as TaxonomyApproveForm } from "./components/Shared/Taxonomy/TaxonomyApproveForm";
+export { default as ExamplesPanel } from "./components/Shared/Taxonomy/ExamplesPanel";
+export { default as OnboardingPopup } from "./components/Onboarding/OnboardingPopup";
+export { CompanyOnboardingModal } from "./components/CompanyOnboarding";
+export type { TaxonomySuggestion, TaxonomyApprovalPayload } from "./components/Shared/Taxonomy/types";
+export { NotificationProvider, useNotification, NotificationViewport, NotificationTester, notify, dismiss, updateNotification, clearNotifications, } from "./components/Notification";
+export { default as LanguageSchoolsList } from './components/LanguageSchools/LanguageSchoolsList';
+export { default as LanguageSchoolDetail } from './components/LanguageSchools/LanguageSchoolDetail';
+export { default as SchoolCard } from './components/LanguageSchools/components/SchoolCard';
+export type { School, SchoolCourse, SchoolAccommodation, SchoolAddress, SchoolTaxonomyTerm, SchoolListingTier, SchoolsApiResponse, SchoolApiResponse, } from './types/school';
+export type { NotificationAction, NotificationContextValue, NotificationPayload, NotificationPlacement, NotificationState, NotificationType, } from "./components/Notification";
+export { LeadForm } from "./components/LeadForm";
+export type { LeadFormProps } from "./components/LeadForm";
+export { useLeadForm, useLeadMetadata } from "./hooks/use-lead-form";
+export type { LeadFormData, LeadFormState, LeadFormResponse, LeadFormConfig, } from "./types/lead";
+export { BUDGET_OPTIONS, TIMEFRAME_OPTIONS, LANGUAGE_OPTIONS, } from "./types/lead";
+export { leadFormSchema, sanitizeLead, extractUtmParams, getCurrentLanguage, getAutoPopulatedMetadata, validateLeadData, } from "./services/lead-validation";
+export { default as ProfileStrengthWidget } from "./components/Companies/components/admin/ProfileStrengthWidget";
+export { default as InviteModal } from "./components/Companies/components/admin/InviteModal";

package/dist/types/src/lib/utils.d.ts

@@ -0,0 +1,15 @@
+import { type ClassValue } from "clsx";
+/**
+ * Merges Tailwind CSS classes with intelligent conflict resolution
+ * Combines clsx and tailwind-merge to handle Tailwind class conflicts
+ *
+ * @param inputs - Class values to merge
+ * @returns Merged class string
+ *
+ * @example
+ * ```tsx
+ * cn("px-4 py-2", isActive && "bg-primary")
+ * cn("text-sm", "text-lg") // "text-lg" wins due to merge
+ * ```
+ */
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/types/src/services/alphaVantageResearch.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Alpha Vantage Research Service — Quality Compounder Framework
+ *
+ * Provider: Alpha Vantage (https://www.alphavantage.co)
+ * Free tier: 25 requests/day · All global symbols · No symbol restrictions
+ * API key:   Free at https://www.alphavantage.co/support/#api-key
+ *
+ * CORS note: AV does not allow direct browser calls (no CORS headers).
+ *   In development (Vite), requests go through the /proxy/av proxy defined in
+ *   vite.config.js which forwards to alphavantage.co server-side.
+ *   Set NEXT_PUBLIC_AV_API_KEY in .env.local, or enter the key in the UI.
+ *
+ * Endpoints used:
+ *   OVERVIEW      → ReturnOnEquityTTM (f1 proxy), QuarterlyRevenueGrowthYOY (f4),
+ *                   PEGRatio (v2), AnalystTargetPrice (v3 proxy), Name, Symbol
+ *   GLOBAL_QUOTE  → Current price (for margin of safety calc in v3)
+ *
+ * Limitations vs FMP:
+ *   f2 FCF conversion — not in OVERVIEW (manual)
+ *   f3 Net debt/EBITDA — not in OVERVIEW (manual)
+ *   v1 FCF yield      — not in OVERVIEW (manual)
+ *
+ * v3 uses analyst consensus target vs current price as a margin-of-safety proxy
+ * (not a DCF). This is less rigorous but directionally useful.
+ */
+import type { ResearchResult } from "./research";
+/**
+ * Research a company via Alpha Vantage.
+ * Accepts any global ticker (no symbol restrictions on free plan).
+ * Uses 2 of your 25 daily API calls.
+ */
+export declare function autoResearchAV(ticker: string, apiKey?: string): Promise<ResearchResult>;

package/dist/types/src/services/careerAssistant.mock.d.ts

@@ -0,0 +1,53 @@
+export declare function sendCareerAssistantMessageMock(messages: {
+    role: string;
+    content: string;
+}[]): Promise<{
+    reply: string;
+    toolCalls: {
+        name: string;
+        args: {};
+        result: {
+            jobs: {
+                id: string;
+                title: string;
+                company: string;
+                location: string;
+                salary: string;
+                tags: string[];
+                remote: boolean;
+            }[];
+        };
+    }[];
+} | {
+    reply: string;
+    toolCalls: {
+        name: string;
+        args: {};
+        result: {
+            companies: {
+                id: string;
+                name: string;
+                type: string;
+                location: string;
+                openRoles: number;
+                licenses: string[];
+            }[];
+        };
+    }[];
+} | {
+    reply: string;
+    toolCalls: {
+        name: string;
+        args: {};
+        result: {
+            market: string;
+            avgSalary: string;
+            hiringTrend: string;
+            remoteRatio: string;
+            topRoles: string[];
+        };
+    }[];
+} | {
+    reply: string;
+    toolCalls?: undefined;
+}>;

package/dist/types/src/services/fmpService.d.ts

@@ -0,0 +1,74 @@
+export interface FMPProfile {
+    symbol: string;
+    companyName: string;
+    sector: string;
+    industry: string;
+    mktCap: number;
+    description: string;
+    country: string;
+    exchange: string;
+    image: string;
+}
+export interface FMPKeyMetrics {
+    roicTTM: number | null;
+    fcfYieldTTM: number | null;
+    netDebtToEBITDATTM: number | null;
+    pegRatioTTM: number | null;
+    pfcfRatioTTM: number | null;
+    peRatioTTM: number | null;
+    marketCapTTM: number | null;
+    dividendYieldTTM: number | null;
+}
+export interface FMPRatios {
+    grossProfitMarginTTM: number | null;
+    operatingProfitMarginTTM: number | null;
+    netProfitMarginTTM: number | null;
+    freeCashFlowPerShareTTM: number | null;
+    netIncomePerShareTTM: number | null;
+    currentRatioTTM: number | null;
+    debtToEquityTTM: number | null;
+}
+export interface FMPGrowth {
+    revenueGrowth: number | null;
+    freeCashFlowGrowth: number | null;
+    epsgrowth: number | null;
+    operatingCashFlowGrowth: number | null;
+    netIncomeGrowth: number | null;
+}
+export interface FMPScore {
+    piotroskiScore: number | null;
+    altmanZScore: number | null;
+}
+export interface FMPAnalystRec {
+    strongBuy: number;
+    buy: number;
+    hold: number;
+    sell: number;
+    strongSell: number;
+}
+export interface EnrichedCompanyData {
+    ticker: string;
+    profile: FMPProfile | null;
+    keyMetrics: FMPKeyMetrics | null;
+    ratios: FMPRatios | null;
+    growth: FMPGrowth | null;
+    score: FMPScore | null;
+    analystRec: FMPAnalystRec | null;
+    fetchedAt: number;
+}
+export declare function clearCache(ticker: string): void;
+export declare function clearAllCache(): void;
+export declare function fetchEnrichedCompany(ticker: string, apiKey: string, forceRefresh?: boolean): Promise<EnrichedCompanyData>;
+export interface SearchResult {
+    symbol: string;
+    name: string;
+    exchangeShortName: string;
+    stockExchange: string;
+}
+export declare function searchTicker(query: string, apiKey: string): Promise<SearchResult[]>;
+export interface BatchProgress {
+    done: number;
+    total: number;
+    current: string;
+}
+export declare function fetchWatchlistBatch(tickers: string[], apiKey: string, onProgress?: (p: BatchProgress) => void, delayMs?: number): Promise<Map<string, EnrichedCompanyData>>;

package/dist/types/src/services/lead-validation.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Lead Form Validation Schema and Utilities
+ */
+import { z } from 'zod';
+import { LeadFormData } from '../types/lead';
+/**
+ * Zod validation schema for lead form
+ */
+export declare const leadFormSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    phone: z.ZodString;
+    country: z.ZodString;
+    budget: z.ZodEffects<z.ZodOptional<z.ZodEnum<["not-decided", "1k-2k", "2k-4k", "4k-6k", "6k+"]>>, "not-decided" | "1k-2k" | "2k-4k" | "4k-6k" | "6k+" | undefined, unknown>;
+    timeframe: z.ZodEffects<z.ZodOptional<z.ZodEnum<["immediate", "1-3-months", "3-6-months", "not-decided"]>>, "not-decided" | "immediate" | "1-3-months" | "3-6-months" | undefined, unknown>;
+    source_page: z.ZodOptional<z.ZodString>;
+    campaign: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodEnum<["es", "en"]>>;
+    utm_source: z.ZodOptional<z.ZodString>;
+    utm_medium: z.ZodOptional<z.ZodString>;
+    utm_campaign: z.ZodOptional<z.ZodString>;
+    referrer: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    email: string;
+    country: string;
+    phone: string;
+    timestamp?: number | undefined;
+    referrer?: string | null | undefined;
+    language?: "en" | "es" | undefined;
+    source_page?: string | undefined;
+    campaign?: string | undefined;
+    utm_source?: string | undefined;
+    utm_medium?: string | undefined;
+    utm_campaign?: string | undefined;
+    budget?: "not-decided" | "1k-2k" | "2k-4k" | "4k-6k" | "6k+" | undefined;
+    timeframe?: "not-decided" | "immediate" | "1-3-months" | "3-6-months" | undefined;
+}, {
+    name: string;
+    email: string;
+    country: string;
+    phone: string;
+    timestamp?: number | undefined;
+    referrer?: string | null | undefined;
+    language?: "en" | "es" | undefined;
+    source_page?: string | undefined;
+    campaign?: string | undefined;
+    utm_source?: string | undefined;
+    utm_medium?: string | undefined;
+    utm_campaign?: string | undefined;
+    budget?: unknown;
+    timeframe?: unknown;
+}>;
+export type LeadFormValidation = z.infer<typeof leadFormSchema>;
+/**
+ * Sanitize and prepare lead data for submission
+ */
+export declare const sanitizeLead: (data: LeadFormData) => LeadFormValidation;
+/**
+ * Extract UTM parameters from URL query string
+ */
+export declare const extractUtmParams: () => {
+    utm_source?: undefined;
+    utm_medium?: undefined;
+    utm_campaign?: undefined;
+} | {
+    utm_source: string | undefined;
+    utm_medium: string | undefined;
+    utm_campaign: string | undefined;
+};
+/**
+ * Get current language from document or navigator
+ */
+export declare const getCurrentLanguage: () => "es" | "en";
+/**
+ * Auto-populate hidden metadata fields
+ */
+export declare const getAutoPopulatedMetadata: (sourcePage?: string, campaign?: string, language?: "es" | "en") => {
+    source_page?: undefined;
+    campaign?: undefined;
+    language?: undefined;
+    utm_source?: undefined;
+    utm_medium?: undefined;
+    utm_campaign?: undefined;
+    referrer?: undefined;
+    timestamp?: undefined;
+} | {
+    source_page: string;
+    campaign: string | undefined;
+    language: "en" | "es";
+    utm_source: string | undefined;
+    utm_medium: string | undefined;
+    utm_campaign: string | undefined;
+    referrer: string | undefined;
+    timestamp: number;
+};
+/**
+ * Validate lead data
+ */
+export declare const validateLeadData: (data: unknown) => Promise<{
+    success: boolean;
+    data?: LeadFormValidation;
+    errors?: Record<string, string>;
+}>;

package/dist/types/src/services/research.d.ts

@@ -0,0 +1,71 @@
+/**
+ * FMP Research Service — Quality Compounder Framework
+ *
+ * Endpoint reference: docs/FMP_api_docs_free_tier.md
+ *
+ * ALL v3/v4 endpoints are legacy-blocked as of Aug 2025.
+ * Only /stable/* endpoints work on the current free tier.
+ *
+ * Verified working stable endpoints (tested April 2026):
+ *   Search  : GET /stable/search-name?query={q}&limit=1       → any symbol ✅
+ *   Metrics : GET /stable/key-metrics?symbol={sym}&period=annual
+ *   Ratios  : GET /stable/ratios?symbol={sym}&period=annual
+ *   Growth  : GET /stable/financial-growth?symbol={sym}&period=annual&limit=1
+ *   DCF     : GET /stable/discounted-cash-flow?symbol={sym}
+ *   Company : GET /stable/financial-statement-symbol-list      → any symbol ✅
+ *
+ * FREE TIER SYMBOL RESTRICTION (key-metrics, ratios, financial-growth, DCF):
+ *   Only the ~80 symbols in FREE_TIER_SYMBOLS below return data.
+ *   Any other ticker will get an empty array → auto-research silently returns nulls.
+ *   Upgrade to Starter ($) to unlock all US exchange symbols.
+ *
+ * NOT available on stable free tier (return empty arrays):
+ *   - Piotroski / financial score
+ *   - Earnings surprises
+ *   - Insider trading
+ *
+ * API key: set NEXT_PUBLIC_FMP_API_KEY in .env.local (never hardcode)
+ */
+export declare const FREE_TIER_SYMBOLS: Set<string>;
+/** Returns true if the ticker is available for financial data on the free plan */
+export declare function isFreeTierSupported(ticker: string): boolean;
+export interface ResearchResult {
+    ticker: string;
+    company: string;
+    scores: Record<string, number | null>;
+    raw: {
+        roic: number | null;
+        fcfYield: number | null;
+        fcfConversion: number | null;
+        netDebtEbitda: number | null;
+        revenueGrowth: number | null;
+        pegRatio: number | null;
+        pfcf: number | null;
+        dcfValue: number | null;
+        currentPrice: number | null;
+        marginOfSafety: number | null;
+    };
+}
+/**
+ * Fetch and score a company from FMP.
+ * Pass apiKey to override the environment variable (e.g. from component prop).
+ */
+export declare function autoResearch(companyName: string, apiKey?: string): Promise<ResearchResult>;
+/**
+ * Fetch and cache the full list of companies with financial statements.
+ * Hits the API once per 24 hours, then returns the cached list.
+ */
+export declare function getCompanyList(): Promise<Array<{
+    symbol: string;
+    name: string;
+}>>;
+/**
+ * Filter the cached company list locally by symbol or name.
+ */
+export declare function searchCompanies(query: string, companies: Array<{
+    symbol: string;
+    name: string;
+}>, limit?: number): Array<{
+    symbol: string;
+    name: string;
+}>;

package/dist/types/src/services/scoringEngine.d.ts

@@ -0,0 +1,35 @@
+import type { EnrichedCompanyData } from "./fmpService";
+export interface DerivedScores {
+    f1: number | null;
+    f2: number | null;
+    f3: number | null;
+    f4: number | null;
+    v1: number | null;
+    v2: number | null;
+    v3: number | null;
+    m1: null;
+    m2: null;
+    m3: null;
+    m4: null;
+    g1: null;
+    g2: null;
+    g3: null;
+}
+export interface DerivedGateSuggestions {
+    gate3: boolean | null;
+    gate1: null;
+    gate2: null;
+    gate4: null;
+    gate5: null;
+}
+export interface ReasoningMap {
+    [criterionId: string]: string;
+}
+export interface ScoringResult {
+    scores: DerivedScores;
+    gateSuggestions: DerivedGateSuggestions;
+    reasoning: ReasoningMap;
+    dataQuality: "full" | "partial" | "minimal";
+}
+export declare function deriveScores(data: EnrichedCompanyData): ScoringResult;
+export declare function quickScore(data: EnrichedCompanyData): number | null;

package/dist/types/src/services/watchlistStore.d.ts

@@ -0,0 +1,18 @@
+import type { EnrichedCompanyData } from "./fmpService";
+export interface WatchlistEntry {
+    ticker: string;
+    addedAt: number;
+    notes?: string;
+}
+export interface MonthlySnapshot {
+    takenAt: number;
+    scores: Record<string, number | null>;
+}
+export declare function getWatchlist(): WatchlistEntry[];
+export declare function saveWatchlist(entries: WatchlistEntry[]): void;
+export declare function addToWatchlist(ticker: string, notes?: string): void;
+export declare function removeFromWatchlist(ticker: string): void;
+export declare function isInWatchlist(ticker: string): boolean;
+export declare function saveSnapshot(dataMap: Map<string, EnrichedCompanyData>): void;
+export declare function getLastSnapshot(): MonthlySnapshot | null;
+export declare function getScoreDelta(ticker: string, currentScore: number | null): number | null;

package/dist/types/src/stories/PageComponents.stories.d.ts

@@ -0,0 +1,7 @@
+import type { Meta, StoryObj } from '@storybook/react';
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+export declare const HeaderAlternativeShowcase: Story;
+export declare const NewsPageShowcase: Story;
+export declare const CoursesPageShowcase: Story;