@igamingcareer/igaming-components 1.1.21 → 1.1.22

package/dist/types/src/components/Shared/Listing/ListingHeader.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+import { PopularTag } from "./types";
+interface ListingHeaderProps {
+    title: string;
+    description?: string;
+    popularTags?: PopularTag[];
+    selectedTags?: string[];
+    onTagClick?: (tag: string) => void;
+    onTagRemove?: (tag: string) => void;
+    className?: string;
+}
+/**
+ * ListingHeader - Displays page title, description and popular tags
+ * STATELESS: All state and actions handled by parent page
+ */
+declare const ListingHeader: React.FC<ListingHeaderProps>;
+export default ListingHeader;

package/dist/types/src/components/Shared/Listing/ListingMobileFilters.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+import { FilterSection } from "./types";
+interface FilterSectionData extends FilterSection {
+    selectedValues: string[];
+}
+interface ListingMobileFiltersProps {
+    isOpen: boolean;
+    onClose: () => void;
+    title?: string;
+    sections: FilterSectionData[];
+    onFilterChange: (key: string, values: string[]) => void;
+    onApply: () => void;
+    onClearAll: () => void;
+    savedCount?: number;
+    showSavedOnly?: boolean;
+    onToggleSavedOnly?: () => void;
+    savedLabel?: string;
+}
+/**
+ * ListingMobileFilters - Full-screen mobile filter drawer
+ * STATELESS: All state and actions handled by parent page
+ */
+declare const ListingMobileFilters: React.FC<ListingMobileFiltersProps>;
+export default ListingMobileFilters;

package/dist/types/src/components/Shared/Listing/ListingPagination.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+import { PaginationInfo } from "./types";
+interface ListingPaginationProps {
+    pagination: PaginationInfo;
+    onPageChange: (page: number) => void;
+    maxPagesToShow?: number;
+    showFirstLast?: boolean;
+    className?: string;
+}
+/**
+ * ListingPagination - Page navigation controls
+ * STATELESS: All state and actions handled by parent page
+ */
+declare const ListingPagination: React.FC<ListingPaginationProps>;
+export default ListingPagination;

package/dist/types/src/components/Shared/Listing/ListingSearchBar.d.ts

@@ -0,0 +1,20 @@
+import React from "react";
+interface ListingSearchBarProps {
+    value: string;
+    onChange: (value: string) => void;
+    onSubmit: (value: string) => void;
+    onClear?: () => void;
+    onFilterClick?: () => void;
+    placeholder?: string;
+    suggestions?: string[];
+    onSuggestionSelect?: (suggestion: string) => void;
+    showFilterButton?: boolean;
+    filterCount?: number;
+    className?: string;
+}
+/**
+ * ListingSearchBar - Search input with suggestions and filter toggle
+ * STATELESS: All state and actions handled by parent page
+ */
+declare const ListingSearchBar: React.FC<ListingSearchBarProps>;
+export default ListingSearchBar;

package/dist/types/src/components/Shared/Listing/ListingSidebar.d.ts

@@ -0,0 +1,25 @@
+import React from "react";
+import { FilterSection, RangeConfig } from "./types";
+interface FilterSectionData extends FilterSection {
+    selectedValues: string[];
+}
+interface ListingSidebarProps {
+    title?: string;
+    sections: FilterSectionData[];
+    onFilterChange: (key: string, values: string[]) => void;
+    onClearAll: () => void;
+    activeFiltersCount: number;
+    maxVisible?: number;
+    rangeConfig?: RangeConfig;
+    savedCount?: number;
+    showSavedOnly?: boolean;
+    onToggleSavedOnly?: () => void;
+    savedLabel?: string;
+    className?: string;
+}
+/**
+ * ListingSidebar - Collapsible filter sections with search within long filters
+ * STATELESS: All state and actions handled by parent page
+ */
+declare const ListingSidebar: React.FC<ListingSidebarProps>;
+export default ListingSidebar;

package/dist/types/src/components/Shared/Listing/ListingToolbar.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+import { LucideIcon } from "lucide-react";
+import { ViewMode, SortOption, PaginationInfo } from "./types";
+interface ListingToolbarProps {
+    viewMode: ViewMode;
+    onViewModeChange: (mode: ViewMode) => void;
+    itemsPerPage: number;
+    onItemsPerPageChange: (value: number) => void;
+    itemsPerPageOptions?: number[];
+    sortBy: string;
+    onSortChange: (value: string) => void;
+    sortOptions: SortOption[];
+    pagination: PaginationInfo;
+    title?: string;
+    itemLabel?: string;
+    icon?: LucideIcon;
+    className?: string;
+}
+/**
+ * ListingToolbar - View mode toggle, items per page, sort by, count display
+ * STATELESS: All state and actions handled by parent page
+ */
+declare const ListingToolbar: React.FC<ListingToolbarProps>;
+export default ListingToolbar;

package/dist/types/src/components/Shared/Listing/index.d.ts

@@ -0,0 +1,9 @@
+export { default as ListingHeader } from "./ListingHeader";
+export { default as ListingSearchBar } from "./ListingSearchBar";
+export { default as ListingToolbar } from "./ListingToolbar";
+export { default as ListingSidebar } from "./ListingSidebar";
+export { default as ListingPagination } from "./ListingPagination";
+export { default as ListingEmptyState } from "./ListingEmptyState";
+export { default as ListingMobileFilters } from "./ListingMobileFilters";
+export { default as ListingActiveFilters } from "./ListingActiveFilters";
+export type { ViewMode, SortOption, PopularTag, FilterOption, FilterSection, ActiveFilter, PaginationInfo, } from "./types";

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

@@ -0,0 +1,50 @@
+export type ViewMode = "grid" | "list";
+export type SortOption = {
+    value: string;
+    label: string;
+};
+export interface PopularTag {
+    label: string;
+    value: string;
+    color?: string;
+}
+export interface FilterOption {
+    value: string;
+    label: string;
+    count?: number;
+}
+export interface RangeConfig {
+    min: number;
+    max: number;
+    step?: number;
+    unit?: string;
+    unitPosition?: "prefix" | "suffix";
+    formatLabel?: (value: number) => string;
+}
+export interface FilterSection {
+    key: string;
+    label: string;
+    type: "checkbox" | "select" | "searchable-select" | "range" | "toggle";
+    options?: FilterOption[];
+    searchable?: boolean;
+    collapsible?: boolean;
+    defaultExpanded?: boolean;
+    /** Max visible items before "View more" button */
+    maxVisible?: number;
+    /** Config for range type filters */
+    rangeConfig?: RangeConfig;
+}
+export interface ActiveFilter {
+    key: string;
+    label: string;
+    value: string;
+    displayValue?: string;
+}
+export interface PaginationInfo {
+    currentPage: number;
+    totalPages: number;
+    totalItems: number;
+    itemsPerPage: number;
+    startIndex: number;
+    endIndex: number;
+}

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

@@ -0,0 +1,5 @@
+interface LoadingShadowCardProps {
+    totalColumns?: number;
+}
+declare const LoadingShadowCard: ({ totalColumns }: LoadingShadowCardProps) => import("react/jsx-runtime").JSX.Element;
+export default LoadingShadowCard;

package/dist/types/src/components/Shared/Mobile/BottomSheetFilter.d.ts

@@ -0,0 +1,23 @@
+import React from "react";
+interface FilterOption {
+    value: string;
+    label: string;
+    count?: number;
+}
+interface BottomSheetFilterProps {
+    isOpen: boolean;
+    onClose: () => void;
+    title: string;
+    options: FilterOption[];
+    selectedValues: string[];
+    onApply: (values: string[]) => void;
+    multiSelect?: boolean;
+    searchable?: boolean;
+}
+/**
+ * BottomSheetFilter - Bottom sheet for filter selection
+ * Replaces heavy modals with lighter bottom sheets
+ * Each tag in HorizontalTagSlider opens a bottom sheet, not a full modal
+ */
+declare const BottomSheetFilter: React.FC<BottomSheetFilterProps>;
+export default BottomSheetFilter;

package/dist/types/src/components/Shared/Mobile/FloatingActionButton.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+interface QuickAction {
+    id: string;
+    label: string;
+    icon: React.ReactNode;
+    onClick: () => void;
+    color?: string;
+}
+interface FloatingActionButtonProps {
+    actions: QuickAction[];
+    mainIcon?: React.ReactNode;
+    className?: string;
+}
+/**
+ * FloatingActionButton - Context-aware FAB for quick actions
+ * Inspired by Instagram/TikTok patterns
+ * Possible actions: Save search, Create alert, Quick apply, Claim company
+ */
+declare const FloatingActionButton: React.FC<FloatingActionButtonProps>;
+export declare const JobsQuickActions: QuickAction[];
+export declare const CompaniesQuickActions: QuickAction[];
+export default FloatingActionButton;

package/dist/types/src/components/Shared/Mobile/HorizontalTagSlider.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+interface Tag {
+    label: string;
+    value: string;
+    icon?: React.ReactNode;
+    category?: "popular" | "role" | "location" | "company" | "more";
+}
+interface HorizontalTagSliderProps {
+    tags: Tag[];
+    selectedTags: string[];
+    onTagClick: (tag: string) => void;
+    onTagRemove?: (tag: string) => void;
+    onMoreClick?: () => void;
+    showCategoryIcons?: boolean;
+    className?: string;
+}
+/**
+ * HorizontalTagSlider - Instagram-style horizontal scrolling tags
+ * MVP improvement: Replace static vertical tags with horizontal slider
+ */
+declare const HorizontalTagSlider: React.FC<HorizontalTagSliderProps>;
+export default HorizontalTagSlider;

package/dist/types/src/components/Shared/Mobile/StickyFilterChips.d.ts

@@ -0,0 +1,20 @@
+import React from "react";
+interface FilterChip {
+    key: string;
+    label?: string;
+    value: string;
+    displayValue: string;
+}
+interface StickyFilterChipsProps {
+    chips: FilterChip[];
+    onRemove: (key: string, value: string) => void;
+    onClearAll?: () => void;
+    showCount?: boolean;
+    className?: string;
+}
+/**
+ * StickyFilterChips - Selected filters displayed as sticky chips under search
+ * MVP behavior: Chips removable with ✕, result counts update live
+ */
+declare const StickyFilterChips: React.FC<StickyFilterChipsProps>;
+export default StickyFilterChips;

package/dist/types/src/components/Shared/Mobile/UserIdentityMenu.d.ts

@@ -0,0 +1,36 @@
+import React from "react";
+import type { LucideIcon } from "lucide-react";
+interface UserData {
+    name?: string;
+    email?: string;
+    avatar?: string;
+    initials?: string;
+}
+interface SavedCounts {
+    jobs?: number;
+    companies?: number;
+    courses?: number;
+    alerts?: number;
+}
+interface UserIdentityMenuProps {
+    user?: UserData | null;
+    savedCounts?: SavedCounts;
+    menuItems?: UserIdentityMenuItem[];
+    onNavigate?: (path: string) => void;
+    onLogout?: () => void;
+    onSignIn?: () => void;
+    className?: string;
+}
+export interface UserIdentityMenuItem {
+    id: string;
+    label: string;
+    icon: LucideIcon;
+    path: string;
+    countKey?: keyof SavedCounts;
+}
+/**
+ * UserIdentityMenu - Always-visible avatar with bottom sheet menu
+ * Critical UX gap fix: Identity should always be visible
+ */
+declare const UserIdentityMenu: React.FC<UserIdentityMenuProps>;
+export default UserIdentityMenu;

package/dist/types/src/components/Shared/Mobile/index.d.ts

@@ -0,0 +1,5 @@
+export { default as HorizontalTagSlider } from "./HorizontalTagSlider";
+export { default as FloatingActionButton, JobsQuickActions, CompaniesQuickActions } from "./FloatingActionButton";
+export { default as UserIdentityMenu } from "./UserIdentityMenu";
+export { default as BottomSheetFilter } from "./BottomSheetFilter";
+export { default as StickyFilterChips } from "./StickyFilterChips";

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

@@ -0,0 +1,9 @@
+import React from "react";
+interface MobileDrawerProps {
+    isOpen: boolean;
+    onClose: () => void;
+    title?: string;
+    children: React.ReactNode;
+}
+declare const MobileDrawer: React.FC<MobileDrawerProps>;
+export default MobileDrawer;

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

@@ -0,0 +1,16 @@
+import React from "react";
+interface NewsHeaderProps {
+    onSearchChange: (query: string) => void;
+    title?: string;
+    description?: string;
+    popularTags?: string[];
+    searchPlaceholder?: string;
+    generateHref?: (tag: string) => string;
+    onTagClick?: (tag: string) => void;
+    onTagRemove?: (tag: string) => void;
+    popularTagColor?: string;
+    allowTagRemoval?: boolean;
+    sponsoredSlot?: React.ReactNode;
+}
+declare const PageTitleHeader: React.FC<NewsHeaderProps>;
+export default PageTitleHeader;

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

@@ -0,0 +1,11 @@
+interface SearchBoxProps {
+    data: string[];
+    onSelect: (value: string) => void;
+    placeholder?: string;
+    debounceMs?: number;
+    onTyping?: (value: string) => void;
+    className?: string;
+    showSubmitButton?: boolean;
+}
+declare const SearchBox: React.FC<SearchBoxProps>;
+export default SearchBox;

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

@@ -0,0 +1,14 @@
+import * as React from "react";
+export type ShieldedActionButtonProps = {
+    children: React.ReactNode;
+    onClick?: () => void;
+    emailVerified?: boolean;
+    profileComplete?: boolean;
+    requiredSteps?: string[];
+    isBlocked?: boolean;
+    blockedReason?: string;
+    ctaLabel?: string;
+    onCtaClick?: () => void;
+    variant?: "tooltip" | "modal";
+};
+export default function ShieldedActionButton({ children, onClick, emailVerified, profileComplete, requiredSteps, isBlocked, blockedReason, ctaLabel, onCtaClick, variant, }: ShieldedActionButtonProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,10 @@
+interface SubscriptionModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onSubscriptionSuccess?: () => void;
+    searchQuery?: string;
+    filters?: any;
+    apiUrl?: string;
+}
+export declare function SubscriptionModal({ open, onOpenChange, onSubscriptionSuccess, searchQuery, filters, apiUrl }: SubscriptionModalProps): import("react/jsx-runtime").JSX.Element;
+export {};

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 };