@igamingcareer/igaming-components 1.2.23 → 1.2.25

package/dist/types/src/components/Shared/Taxonomy/ExamplesPanel.d.ts

@@ -0,0 +1,7 @@
+interface ExamplesPanelProps {
+    title?: string;
+    examples?: string[];
+    emptyState?: string;
+}
+declare const ExamplesPanel: ({ title, examples, emptyState, }: ExamplesPanelProps) => import("react/jsx-runtime").JSX.Element;
+export default ExamplesPanel;

package/dist/types/src/components/Shared/Taxonomy/TaxonomyApproveForm.d.ts

@@ -0,0 +1,15 @@
+import type { TaxonomyApprovalPayload } from "./types";
+interface TaxonomyApproveFormProps {
+    namespaceOptions: string[];
+    scopeOptions: string[];
+    defaultNamespace?: string;
+    defaultCanonical?: string;
+    defaultScopes?: string[];
+    isSubmitting?: boolean;
+    onApprove: (payload: TaxonomyApprovalPayload) => void | Promise<void>;
+    onReject: () => void | Promise<void>;
+    approveLabel?: string;
+    rejectLabel?: string;
+}
+declare const TaxonomyApproveForm: ({ namespaceOptions, scopeOptions, defaultNamespace, defaultCanonical, defaultScopes, isSubmitting, onApprove, onReject, approveLabel, rejectLabel, }: TaxonomyApproveFormProps) => import("react/jsx-runtime").JSX.Element;
+export default TaxonomyApproveForm;

package/dist/types/src/components/Shared/Taxonomy/TaxonomySuggestionDetail.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+import type { TaxonomySuggestion } from "./types";
+interface TaxonomySuggestionDetailProps {
+    suggestion: TaxonomySuggestion | null;
+    title?: string;
+    description?: string;
+    emptyState?: string;
+    approveForm?: React.ReactNode;
+}
+declare const TaxonomySuggestionDetail: ({ suggestion, title, description, emptyState, approveForm, }: TaxonomySuggestionDetailProps) => import("react/jsx-runtime").JSX.Element;
+export default TaxonomySuggestionDetail;

package/dist/types/src/components/Shared/Taxonomy/TaxonomySuggestionTable.d.ts

@@ -0,0 +1,12 @@
+import type { TaxonomySuggestion } from "./types";
+interface TaxonomySuggestionTableProps {
+    suggestions: TaxonomySuggestion[];
+    selectedId?: string;
+    onSelect?: (suggestion: TaxonomySuggestion) => void;
+    onApprove?: (suggestion: TaxonomySuggestion) => void;
+    onReject?: (suggestion: TaxonomySuggestion) => void;
+    emptyState?: string;
+    title?: string;
+}
+declare const TaxonomySuggestionTable: ({ suggestions, selectedId, onSelect, onApprove, onReject, emptyState, title, }: TaxonomySuggestionTableProps) => import("react/jsx-runtime").JSX.Element;
+export default TaxonomySuggestionTable;

package/dist/types/src/components/Shared/Taxonomy/types.d.ts

@@ -0,0 +1,18 @@
+export interface TaxonomySuggestion {
+    id: string;
+    term: string;
+    namespace?: string;
+    canonical?: string;
+    scopes: string[];
+    count?: number;
+    status?: "pending" | "approved" | "rejected";
+    createdAt?: string;
+    updatedAt?: string;
+    examples?: string[];
+    source?: string;
+}
+export interface TaxonomyApprovalPayload {
+    namespace: string;
+    canonical: string;
+    scopes: string[];
+}

package/dist/types/src/components/Shared/ViewControls.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+interface ViewControlsProps {
+    viewMode: "grid" | "list";
+    onToggleViewMode: () => void;
+    selectedItemsPerPage: number;
+    onItemsPerPageChange: (value: number) => void;
+    totalCount: number;
+    startIndex: number;
+    endIndex: number;
+    title: string;
+}
+declare const ViewControls: React.FC<ViewControlsProps>;
+export default ViewControls;

package/dist/types/src/components/Shared/ViewModeToggle.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+interface ViewModeToggleProps {
+    viewMode: "grid" | "list";
+    onToggle?: () => void;
+    onViewModeChange?: (mode: "grid" | "list") => void;
+    className?: string;
+}
+declare const ViewModeToggle: React.FC<ViewModeToggleProps>;
+export default ViewModeToggle;

package/dist/types/src/components/Shared/extractTagsFromTitle.d.ts

@@ -0,0 +1,3 @@
+export declare function extractTopTagFromTitle(title: string): string | null;
+export declare function extractTopTagSmart(title: string): string | null;
+export declare function extractTopKeyword(title: string): string | null;

package/dist/types/src/components/Shared/helpers/api.d.ts

@@ -0,0 +1,21 @@
+export type Ok<T> = {
+    ok: true;
+    data: T;
+};
+export type Err = {
+    ok: false;
+    error: AppError;
+};
+export type Result<T> = Ok<T> | Err;
+export type AppErrorCode = "BAD_REQUEST" | "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "CONFLICT" | "RATE_LIMITED" | "SERVER" | "NETWORK" | "TIMEOUT" | "PARSING" | "UNKNOWN";
+export type AppError = {
+    code: AppErrorCode;
+    message: string;
+    friendly?: string;
+    status?: number;
+    details?: unknown;
+};
+export declare function friendlyMessage(err: AppError): string;
+export declare function apiFetch<T>(url: string, init?: RequestInit & {
+    timeoutMs?: number;
+}): Promise<Result<T>>;

package/dist/types/src/components/Shared/helpers/filters.d.ts

@@ -0,0 +1,10 @@
+import { DateFilterOption } from "../../GenericListing/DateFilter";
+import { JobFilters } from "../../GenericListing/SidebarFilter";
+import { FilterableItem } from "../types/shared-types";
+export declare const applyDateFilter: <T extends FilterableItem>(items: T[], dateFilterOption: DateFilterOption, dateField?: string) => T[];
+export declare const applyAdvancedFilters: <T extends FilterableItem>(items: T[], filters: JobFilters) => T[];
+export declare const populateFilters: <T extends Record<string, any>>(items: T[], filterKeys: string[]) => Record<string, string[]>;
+export declare const updateUrlWithDateFilter: (filter: DateFilterOption) => void;
+export declare const applyAllFilters: <T extends FilterableItem>(items: T[], dropdownFilters: Record<string, string>, textFilters: string[], dateFilter: DateFilterOption, dateField?: string) => T[];
+export type SortOptionKey = "date_desc" | "date_asc" | "views_desc" | "views_asc" | "relevance" | "title_asc";
+export declare const sortItems: <T extends FilterableItem>(items: T[], sortBy: SortOptionKey, searchTerms?: string[], dateField?: string) => T[];

package/dist/types/src/components/Shared/helpers/jobsHelpers.d.ts

@@ -0,0 +1,6 @@
+import { JobDetail, SimilarJob } from "../../JobsDetails/utils/types";
+declare function normalizeJob(jobLike?: Partial<JobDetail> | null): JobDetail;
+declare function normalizeSimilar(list?: Partial<SimilarJob>[] | null): SimilarJob[];
+declare const mockJobDetail: JobDetail;
+declare const mockSimilarJobs: SimilarJob[];
+export { normalizeJob, normalizeSimilar, mockJobDetail, mockSimilarJobs };

package/dist/types/src/components/Shared/types/shared-types.d.ts

@@ -0,0 +1,125 @@
+export type FilterOption = {
+    label: string;
+    value: string;
+};
+export type FilterType = "checkbox" | "dropdown" | "search" | "radio";
+export interface FilterConfig {
+    type: FilterType;
+    label: string;
+    options?: FilterOption[];
+}
+export type FilterState = {
+    [key: string]: string | string[] | [string, string] | [number, number];
+};
+export type FilterableItem = {
+    title?: string;
+    overview?: string;
+    date?: string;
+    [key: string]: any;
+};
+export interface CompanyTypeSubtype {
+    slug: string;
+    name: string;
+}
+export interface CompanyTypeKeyRole {
+    role: string;
+    demand: "High" | "Medium" | "Low";
+}
+export interface CompanyType {
+    id: string;
+    slug: string;
+    name: string;
+    label: string;
+    description: string;
+    businessModel: "b2b" | "b2c" | "both";
+    isB2b: boolean;
+    isB2c: boolean;
+    isRegulated: boolean;
+    parentType: string | null;
+    subtypes: CompanyTypeSubtype[];
+    synonyms: string[];
+    relatedTypes: string[];
+    jobCount: number;
+    companyCount: number;
+    colorHex: string;
+    icon: string;
+    careerImplications: string;
+    keyRoles: CompanyTypeKeyRole[];
+    isFeatured: boolean;
+    isActive: boolean;
+}
+export interface GamblingVerticalKeyRole {
+    role: string;
+    demand: "High" | "Medium" | "Low";
+}
+export interface GamblingVertical {
+    id: string;
+    slug: string;
+    name: string;
+    label: string;
+    description: string;
+    channel: string;
+    parentVertical: string | null;
+    subVerticals: string[];
+    synonyms: string[];
+    regulationLevel: "low" | "medium" | "high";
+    isFastGrowing: boolean;
+    companyCount: number;
+    jobCount: number;
+    topMarkets: string[];
+    keyRegulators: string[];
+    relatedCompanyTypes: string[];
+    careerImplications: string;
+    keyRoles: GamblingVerticalKeyRole[];
+    colorHex: string;
+    icon: string;
+    isFeatured: boolean;
+    isActive: boolean;
+}
+export interface Channel {
+    id: string;
+    slug: string;
+    name: string;
+    label: string;
+    description: string;
+    channelType: string;
+    synonyms: string[];
+    isDigital: boolean;
+    isRegulatedDifferently: boolean;
+    typicalCompanyTypes: string[];
+    notes: string;
+    companyCount: number;
+    isActive: boolean;
+}
+export interface DepartmentSubDept {
+    slug: string;
+    name: string;
+}
+export interface DepartmentEntity {
+    id: string;
+    slug: string;
+    name: string;
+    label: string;
+    description: string;
+    parentDepartment: string | null;
+    subDepartments: DepartmentSubDept[];
+    scraperAliases: string[];
+    synonyms: string[];
+    isTechnical: boolean;
+    isRegulated: boolean;
+    isIgamingSpecific: boolean;
+    typicalSeniority: string;
+    companyTypes: string[];
+    topSkills: string[];
+    avgSalaryRange: {
+        min: number;
+        max: number;
+        currency: string;
+    };
+    jobCount: number;
+    growthTrend: "growing" | "stable" | "declining";
+    careerImplications: string;
+    icon: string;
+    colorHex: string;
+    isActive: boolean;
+}

package/dist/types/src/components/Shared/useSavedJobs.d.ts

@@ -0,0 +1,5 @@
+export declare function useSavedJobs(): {
+    savedJobs: string[];
+    toggleJob: (jobId: string) => void;
+    isSaved: (jobId: string | undefined) => boolean;
+};

package/dist/types/src/components/TagBadge/TagBadge.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+export interface TagBadgeProps {
+    name: string;
+    color: string;
+    size?: 'sm' | 'md' | 'lg';
+    removable?: boolean;
+    onRemove?: () => void;
+    onClick?: () => void;
+    href?: string;
+    className?: string;
+}
+export declare const TagBadge: React.FC<TagBadgeProps>;

package/dist/types/src/components/TagPicker/TagPicker.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+export interface TagPickerProps {
+    availableTags: Array<{
+        id: string;
+        name: string;
+        color: string;
+        category?: string;
+    }>;
+    selectedTagIds: string[];
+    onTagSelect: (tagId: string) => void;
+    onTagDeselect: (tagId: string) => void;
+    onCreateTag: (tagData: {
+        name: string;
+        color: string;
+        category?: string;
+    }) => Promise<void>;
+    maxTags?: number;
+    placeholder?: string;
+}
+export declare const TagPicker: React.FC<TagPickerProps>;

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

@@ -0,0 +1,30 @@
+/**
+ * Hook for lead form submission logic
+ */
+import { LeadFormData, LeadFormConfig } from '../types/lead';
+import { UseFormSetError } from 'react-hook-form';
+interface UseLeadFormProps extends Partial<LeadFormConfig> {
+    apiEndpoint?: string;
+    sourcePage?: string;
+    campaign?: string;
+    autoPopulateMetadata?: boolean;
+    onSuccess?: (response: any) => void;
+    onError?: (error: any) => void;
+}
+export declare const useLeadForm: ({ apiEndpoint, sourcePage, campaign, autoPopulateMetadata, onSuccess, onError, }: UseLeadFormProps) => {
+    submitLead: (data: LeadFormData, setFormError?: UseFormSetError<LeadFormData>) => Promise<any>;
+    isLoading: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+    error: string | null;
+    resetState: () => void;
+};
+/**
+ * Hook to get auto-populated metadata
+ */
+export declare const useLeadMetadata: (sourcePage?: string, campaign?: string, language?: string) => {
+    sourcePage: string;
+    campaign: string;
+    language: string;
+};
+export {};

package/dist/types/src/components/hooks/useFilters.d.ts

@@ -0,0 +1,5 @@
+export declare const useFilters: <T extends Record<string, any>>(initialFilters: T) => {
+    filters: T;
+    updateFilter: <K extends keyof T>(key: K, value: T[K]) => void;
+    resetFilters: () => void;
+};

package/dist/types/src/components/hooks/useOnboarding.d.ts

@@ -0,0 +1,19 @@
+import type { OnboardingStep, OnboardingBackendFlags } from "@/types/onboarding";
+export interface OnboardingState {
+    emailVerified: boolean;
+    profileComplete: boolean;
+    steps: OnboardingStep[];
+    progress: number;
+    showModal: boolean;
+    isDismissed: boolean;
+}
+export interface UseOnboardingReturn extends OnboardingState {
+    openModal: () => void;
+    closeModal: () => void;
+    dismissOnboarding: () => void;
+    resetDismissal: () => void;
+    updateFromBackend: (flags: OnboardingBackendFlags) => void;
+    markStepComplete: (stepId: string) => void;
+    isComplete: boolean;
+}
+export declare function useOnboarding(): UseOnboardingReturn;

package/dist/types/src/components/hooks/usePagination.d.ts

@@ -0,0 +1,6 @@
+export declare const usePagination: (initialItemsPerPage?: number) => {
+    currentPage: number;
+    itemsPerPage: number;
+    handlePageChange: (page: number) => void;
+    handleItemsPerPageChange: (value: number) => void;
+};

package/dist/types/src/components/hooks/useSubscription.d.ts

@@ -0,0 +1,4 @@
+export declare function useSubscription(): {
+    isSubscribed: boolean;
+    email: string | null;
+};

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

@@ -0,0 +1,30 @@
+/**
+ * Lead form validation schema
+ */
+import { z } from 'zod';
+export declare const leadFormSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    phone: z.ZodEffects<z.ZodString, string, string>;
+    country: z.ZodString;
+    budget: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    timeframe: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    language: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    email: string;
+    country: string;
+    phone: string;
+    language?: string | undefined;
+    budget?: string | undefined;
+    timeframe?: string | undefined;
+}, {
+    name: string;
+    email: string;
+    country: string;
+    phone: string;
+    language?: string | undefined;
+    budget?: string | undefined;
+    timeframe?: string | undefined;
+}>;
+export type LeadFormSchema = z.infer<typeof leadFormSchema>;

package/dist/types/src/components/types/lead.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Lead form types and constants
+ */
+export interface LeadFormData {
+    name: string;
+    email: string;
+    phone: string;
+    country: string;
+    budget: string;
+    timeframe: string;
+    language?: string;
+    source_page?: string;
+    campaign?: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    referrer?: string;
+    timestamp?: number;
+}
+export interface LeadFormConfig {
+    visibleFields?: (keyof Omit<LeadFormData, 'source_page' | 'campaign' | 'language' | 'utm_source' | 'utm_medium' | 'utm_campaign' | 'referrer' | 'timestamp'>)[];
+    sourcePage?: string;
+    campaign?: string;
+    language?: string;
+    onSuccess?: (response: any) => void;
+    onError?: (error: any) => void;
+    successMessage?: string;
+    submitButtonText?: string;
+    apiEndpoint?: string;
+    autoPopulateMetadata?: boolean;
+}
+export declare const BUDGET_OPTIONS: {
+    label: string;
+    value: string;
+}[];
+export declare const TIMEFRAME_OPTIONS: {
+    label: string;
+    value: string;
+}[];
+export declare const LANGUAGE_OPTIONS: {
+    label: string;
+    value: string;
+}[];

package/dist/types/src/components/ui/button.d.ts

@@ -0,0 +1,57 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+/**
+ * Button component with CVA variant system
+ *
+ * Provides semantic button styling with multiple variants, sizes, and states.
+ * Uses Tailwind CSS for all styling (no Material UI wrapping).
+ *
+ * @component
+ *
+ * @example
+ * ```tsx
+ * // Primary button
+ * <Button variant="primary">Click me</Button>
+ *
+ * // Secondary button with custom classes
+ * <Button variant="secondary" size="lg" className="custom-class">
+ *   Action
+ * </Button>
+ *
+ * // Icon button
+ * <Button variant="ghost" size="icon">
+ *   <IconComponent />
+ * </Button>
+ *
+ * // Disabled state
+ * <Button disabled>Disabled</Button>
+ * ```
+ */
+declare const buttonVariants: (props?: ({
+    variant?: "destructive" | "outline" | "secondary" | "ghost" | "link" | "accent" | "gaming" | "primary" | null | undefined;
+    size?: "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | null | undefined;
+    loading?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    /**
+     * Whether button is in loading state
+     * Use with a spinner/indicator inside the button
+     */
+    isLoading?: boolean;
+    /**
+     * Ref forwarding for parent access
+     */
+    ref?: React.Ref<HTMLButtonElement>;
+}
+/**
+ * Button component
+ *
+ * Semantic button element with responsive, accessible design
+ *
+ * @param props - Button props including variant, size, disabled state
+ * @param ref - Forwarded ref to button element
+ *
+ * @returns JSX.Element
+ */
+declare const Button: React.ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export { Button, buttonVariants };

package/dist/types/src/components/ui/button.stories.d.ts

@@ -0,0 +1,105 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { Button } from "./button";
+declare const meta: Meta<typeof Button>;
+export default meta;
+type Story = StoryObj<typeof Button>;
+/**
+ * Default button with primary variant
+ */
+export declare const Default: Story;
+/**
+ * Primary variant - main brand color (Navy)
+ */
+export declare const Primary: Story;
+/**
+ * Secondary variant - supporting brand color (Gold)
+ */
+export declare const Secondary: Story;
+/**
+ * Accent variant - high-emphasis CTA (Orange)
+ */
+export declare const Accent: Story;
+/**
+ * Destructive variant - warning/danger actions (Red)
+ */
+export declare const Destructive: Story;
+/**
+ * Outline variant - bordered with hover fill
+ */
+export declare const Outline: Story;
+/**
+ * Ghost variant - minimal, no border
+ */
+export declare const Ghost: Story;
+/**
+ * Link variant - text link appearance
+ */
+export declare const Link: Story;
+/**
+ * Gaming variant - iGaming themed with gradient
+ */
+export declare const Gaming: Story;
+/**
+ * Small size button
+ */
+export declare const Small: Story;
+/**
+ * Default size button (standard)
+ */
+export declare const DefaultSize: Story;
+/**
+ * Large size button for prominence
+ */
+export declare const Large: Story;
+/**
+ * Icon button - square for icon, default size
+ */
+export declare const Icon: Story;
+/**
+ * Small icon button
+ */
+export declare const IconSmall: Story;
+/**
+ * Large icon button
+ */
+export declare const IconLarge: Story;
+/**
+ * Disabled button - not clickable
+ */
+export declare const Disabled: Story;
+/**
+ * Loading state - typically paired with spinner
+ */
+export declare const Loading: Story;
+/**
+ * Loading with spinner icon
+ */
+export declare const LoadingWithSpinner: Story;
+/**
+ * All variants in a row
+ */
+export declare const AllVariants: Story;
+/**
+ * All sizes in a row
+ */
+export declare const AllSizes: Story;
+/**
+ * Button in different states (interactive demo)
+ */
+export declare const States: Story;
+/**
+ * Responsive button layout
+ */
+export declare const Responsive: Story;
+/**
+ * Full width button
+ */
+export declare const FullWidth: Story;
+/**
+ * Keyboard accessible button (test with Tab key)
+ */
+export declare const KeyboardAccessible: Story;
+/**
+ * Dark mode preview (toggle theme in Storybook to test)
+ */
+export declare const DarkMode: Story;

package/dist/types/src/components/ui/button.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,17 @@
+/**
+ * UI Components (Tier 1 - Atomic)
+ *
+ * This directory contains foundational, reusable UI components that:
+ * - Are single-responsibility and highly composable
+ * - Follow Tailwind CSS + CVA (class-variance-authority) patterns
+ * - Are fully accessible (WCAG 2.1 AA)
+ * - Have comprehensive Storybook documentation
+ * - Have >80% test coverage
+ *
+ * Exports:
+ * - Button: Semantic button with 8 variants and 6 sizes
+ * - Form components: Input, Label, Select, Checkbox, Radio (COMING)
+ * - Dialog: Canonical modal component (COMING)
+ */
+export { Button, buttonVariants, type ButtonProps } from "./button";
+export type { VariantProps as ButtonVariants } from "class-variance-authority";

package/dist/types/src/data/mockCandidates.d.ts

@@ -0,0 +1,2 @@
+import type { Candidate } from "@/types/candidate";
+export declare const generateMockCandidates: (count?: number) => Candidate[];

package/dist/types/src/data/mockCareerAssistant.d.ts

@@ -0,0 +1,6 @@
+export declare const QUICK_PROMPTS: {
+    icon: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    label: string;
+    message: string;
+}[];
+export declare const FOLLOW_UP_CHIPS: string[];

package/dist/types/src/data/mockComplaints.d.ts

@@ -0,0 +1,2 @@
+import type { Complaint } from "@/types/complaint";
+export declare const mockComplaints: Complaint[];

package/dist/types/src/data/mockReviews.d.ts

@@ -0,0 +1,6 @@
+import type { CompanyReview, ReviewSummary } from "@/types/review";
+export declare const mockReviews: CompanyReview[];
+export declare const getReviewsForCompany: (companySlug: string) => CompanyReview[];
+export declare const getReviewSummary: (companySlug: string) => ReviewSummary;
+/** Get all published reviews across all companies */
+export declare const getAllReviews: () => CompanyReview[];