@secondstaxorg/sscomp 1.4.4 → 1.4.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (95) hide show
  1. package/dist/index.es.js +63 -61
  2. package/dist/index.es.js.map +1 -1
  3. package/dist/index.js +1163 -1024
  4. package/dist/index.js.map +1 -1
  5. package/dist/index.min.js +14 -12
  6. package/dist/index.min.js.map +1 -1
  7. package/package.json +3 -1
  8. package/types/components/CookieConsent/CookieConsent.d.ts +3 -0
  9. package/types/components/CookieConsent/type.d.ts +9 -0
  10. package/types/components/CountrySelector/CountrySelector.d.ts +3 -0
  11. package/types/components/CountrySelector/type.d.ts +24 -0
  12. package/types/components/CurrencyPairs/CurrencyPairsTable.d.ts +3 -0
  13. package/types/components/CurrencyPairs/type.d.ts +6 -0
  14. package/types/components/DatePicker/DatePicker.d.ts +3 -0
  15. package/types/components/DatePicker/type.d.ts +18 -0
  16. package/types/components/DateRangePicker/DateRangePicker.d.ts +3 -0
  17. package/types/components/DateRangePicker/type.d.ts +16 -0
  18. package/types/components/DropdownList/DropdownList.d.ts +3 -0
  19. package/types/components/DropdownList/type.d.ts +21 -0
  20. package/types/components/ExchangeRates/ExchangeRates.d.ts +4 -0
  21. package/types/components/ExchangeRates/type.d.ts +15 -0
  22. package/types/components/Indices/Indices.d.ts +3 -0
  23. package/types/components/Indices/type.d.ts +9 -0
  24. package/types/components/LPRequestTable/LPRequestTable.d.ts +3 -0
  25. package/types/components/LPRequestTable/type.d.ts +15 -0
  26. package/types/components/LPSideNav/LPSideNav.d.ts +1 -2
  27. package/types/components/LPSideNav/type.d.ts +9 -0
  28. package/types/components/LPTopBar/LPTopBar.d.ts +3 -0
  29. package/types/components/LPTopBar/type.d.ts +15 -0
  30. package/types/components/LoadingShimmer/LoadingShimmer.d.ts +3 -0
  31. package/types/components/LoadingShimmer/type.d.ts +9 -0
  32. package/types/components/LoadingSpinner/LoadingSpinner.d.ts +6 -0
  33. package/types/components/MarketData/MarketData.d.ts +3 -0
  34. package/types/components/MarketData/type.d.ts +3 -0
  35. package/types/components/MarketMovers/MarketMovers.d.ts +3 -0
  36. package/types/components/MarketMovers/type.d.ts +6 -0
  37. package/types/components/MenuBar/MenuBar.d.ts +3 -0
  38. package/types/components/MenuBar/type.d.ts +6 -0
  39. package/types/components/NewsCard/NewsCard.d.ts +3 -0
  40. package/types/components/NewsCard/type.d.ts +24 -0
  41. package/types/components/NewsFilterBar/NewsFilterBar.d.ts +3 -0
  42. package/types/components/NewsFilterBar/type.d.ts +12 -0
  43. package/types/components/NewsSourceTag/NewsSourceTag.d.ts +3 -0
  44. package/types/components/NewsSourceTag/type.d.ts +9 -0
  45. package/types/components/NewsTitleBar/NewsTitleBar.d.ts +3 -0
  46. package/types/components/NewsTitleBar/type.d.ts +3 -0
  47. package/types/components/OffersCard/type.d.ts +12 -0
  48. package/types/components/PasswordField/PasswordField.d.ts +3 -0
  49. package/types/components/PasswordField/type.d.ts +15 -0
  50. package/types/components/PaymentMethodsTable/PaymentMethods.d.ts +3 -0
  51. package/types/components/PaymentMethodsTable/type.d.ts +6 -0
  52. package/types/components/PopupModal/PopupModal.d.ts +3 -0
  53. package/types/components/PopupModal/type.d.ts +21 -0
  54. package/types/components/ProvidersTable/ProvidersTable.d.ts +3 -0
  55. package/types/components/ProvidersTable/type.d.ts +6 -0
  56. package/types/components/RateHistory/RateHistory.d.ts +3 -0
  57. package/types/components/RateHistory/type.d.ts +3 -0
  58. package/types/components/ReportsTable/type.d.ts +6 -0
  59. package/types/components/RequestForm/RequestForm.d.ts +3 -0
  60. package/types/components/RequestForm/type.d.ts +9 -0
  61. package/types/components/Ribbon/Ribbon.d.ts +3 -0
  62. package/types/components/Ribbon/type.d.ts +6 -0
  63. package/types/components/SearchBar/SearchBar.d.ts +3 -0
  64. package/types/components/SearchBar/type.d.ts +6 -0
  65. package/types/components/SearchResultsBar/SearchResultsBar.d.ts +3 -0
  66. package/types/components/SearchResultsBar/type.d.ts +9 -0
  67. package/types/components/Selector/types.d.ts +6 -0
  68. package/types/components/SmallNewsCard/SmallNewsCard.d.ts +3 -0
  69. package/types/components/SmallNewsCard/type.d.ts +21 -0
  70. package/types/components/StatusBadge/StatusBadge.d.ts +3 -0
  71. package/types/components/StatusBadge/type.d.ts +9 -0
  72. package/types/components/StocksTicker/StocksTicker.d.ts +3 -0
  73. package/types/components/StocksTicker/type.d.ts +3 -0
  74. package/types/components/SystemConfigTable/SystemConfigTable.d.ts +3 -0
  75. package/types/components/SystemConfigTable/type.d.ts +12 -1
  76. package/types/components/Tab/Tab.d.ts +3 -0
  77. package/types/components/Tab/type.d.ts +12 -0
  78. package/types/components/TextArea/TextArea.d.ts +3 -0
  79. package/types/components/TextArea/type.d.ts +12 -0
  80. package/types/components/TextField/TextField.d.ts +3 -0
  81. package/types/components/TextField/type.d.ts +12 -0
  82. package/types/components/TransactionDetails/TransactionDetails.d.ts +3 -0
  83. package/types/components/TransactionDetails/type.d.ts +18 -0
  84. package/types/components/TransactionDetailsWithPayment/TransactionDetailsWithPayment.d.ts +3 -0
  85. package/types/components/TransactionDetailsWithPayment/type.d.ts +15 -0
  86. package/types/components/UpdateUserActions/UpdateUserActions.d.ts +3 -0
  87. package/types/components/UpdateUserActions/type.d.ts +15 -0
  88. package/types/components/UserActions/UserActions.d.ts +3 -0
  89. package/types/components/UserActions/type.d.ts +18 -0
  90. package/types/components/UserRolesTable/UserRolesTable.d.ts +3 -0
  91. package/types/components/UserRolesTable/type.d.ts +6 -0
  92. package/types/components/UsersTable/UsersTable.d.ts +3 -0
  93. package/types/components/UsersTable/type.d.ts +13 -1
  94. package/types/components/WidgetTitle/WidgetTitle.d.ts +3 -0
  95. package/types/components/WidgetTitle/type.d.ts +3 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@secondstaxorg/sscomp",
3
- "version": "1.4.4",
3
+ "version": "1.4.6",
4
4
  "publishConfig": {
5
5
  "registry": "https://registry.npmjs.org/"
6
6
  },
@@ -78,6 +78,8 @@
78
78
  "heroicons": "^2.0.12",
79
79
  "postcss": "^8.4.21",
80
80
  "react-chartjs-2": "^4.3.1",
81
+ "react": "^18.2.0",
82
+ "react-dom": "^18.2.0",
81
83
  "react-fast-marquee": "^1.3.5",
82
84
  "react-is": "^18.2.0",
83
85
  "rollup-plugin-copy": "^3.4.0",
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { CookieConsentProps } from "./type";
3
+ /**
4
+ * Cookie consent dialogue at the bottom of the page across SSX applications
5
+ */
3
6
  declare const CookieConsent: (props: CookieConsentProps) => JSX.Element;
4
7
  export default CookieConsent;
@@ -1,5 +1,14 @@
1
1
  export interface CookieConsentProps {
2
+ /**
3
+ * Function that should be run when the accept button is clicked
4
+ */
2
5
  acceptFxn: () => void;
6
+ /**
7
+ * Function that should be run when the decline button is clicked
8
+ */
3
9
  declineFxn: () => void;
10
+ /**
11
+ * Function that should be run to close the dialogue
12
+ */
4
13
  closeFxn?: () => void;
5
14
  }
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { SelectorProps } from "./type";
3
+ /**
4
+ * Dropdown selector for selecting countries and currencies
5
+ */
3
6
  declare const CountrySelector: (props: SelectorProps) => JSX.Element;
4
7
  export default CountrySelector;
@@ -1,15 +1,39 @@
1
1
  export interface SelectorProps {
2
+ /**
3
+ * Array of countries containing objects of country name, country short name, country flag and subname to be used in the case of selecting currencies
4
+ */
2
5
  options: {
3
6
  optionName: string;
4
7
  optionShortName: string;
5
8
  optionFlag?: string;
6
9
  subName?: string;
7
10
  }[];
11
+ /**
12
+ * Function to receive the object of the selected item from the dropdown
13
+ */
8
14
  selectedOption: (a: any) => void;
15
+ /**
16
+ * Initial text to be displayed in the field. Suitable to for when there is the need to display the current value of when updating a form
17
+ */
9
18
  initialText?: string;
19
+ /**
20
+ * Initial flag to be displayed in the field along with the initial text. Suitable to for when there is the need to display the current value of when updating a form
21
+ */
10
22
  initialFlag?: string;
23
+ /**
24
+ * Label for the field
25
+ */
11
26
  label?: string;
27
+ /**
28
+ * Placeholder text for the field
29
+ */
12
30
  placeholder?: string;
31
+ /**
32
+ * Boolean to specify whether the dropdown is searchable
33
+ */
13
34
  searchable?: boolean;
35
+ /**
36
+ * Division in the list to segment different groups of options
37
+ */
14
38
  sectionTitle?: string;
15
39
  }
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { CurrencyPairsProps } from "./type";
3
+ /**
4
+ * Table with a list of all currency pairs in the LP platform
5
+ */
3
6
  declare const CurrencyPairsTable: (props: CurrencyPairsProps) => JSX.Element;
4
7
  export default CurrencyPairsTable;
@@ -1,4 +1,7 @@
1
1
  export interface CurrencyPairsProps {
2
+ /**
3
+ * Array containing objects with the keys for the pairs object
4
+ */
2
5
  pairs: {
3
6
  pairCode: string;
4
7
  baseCurrency: string;
@@ -7,6 +10,9 @@ export interface CurrencyPairsProps {
7
10
  exchangeFlag: string;
8
11
  pairName: string;
9
12
  }[];
13
+ /**
14
+ * Function that receives the selected row of currency pair when clicked
15
+ */
10
16
  callback: (a: {
11
17
  pairCode: string;
12
18
  baseCurrency: string;
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { DatePickerProps } from "./type";
3
+ /**
4
+ * Component for picking date
5
+ */
3
6
  declare const DatePicker: (props: DatePickerProps) => JSX.Element;
4
7
  export default DatePicker;
@@ -1,8 +1,26 @@
1
1
  export interface DatePickerProps {
2
+ /**
3
+ * Function that receives the date that is selected from the component
4
+ */
2
5
  onChange: (date: Date) => void;
6
+ /**
7
+ * Label for the datepicker field
8
+ */
3
9
  label?: string;
10
+ /**
11
+ * Subtext below the label
12
+ */
4
13
  subtext?: string;
14
+ /**
15
+ * Boolean to specify whether user can pick past dates
16
+ */
5
17
  disablePastDays?: boolean;
18
+ /**
19
+ * Boolean to specify whether user can pick future dates
20
+ */
6
21
  disableFutureDays?: boolean;
22
+ /**
23
+ * Placeholder text for the datepicker field
24
+ */
7
25
  placeholder?: string;
8
26
  }
@@ -1,4 +1,7 @@
1
1
  import React from 'react';
2
2
  import { DateRangePickerProps } from "./type";
3
+ /**
4
+ * Component for picking date ranges
5
+ */
3
6
  declare const DateRangePicker: React.FC<DateRangePickerProps>;
4
7
  export default DateRangePicker;
@@ -1,9 +1,25 @@
1
1
  export interface DateRangePickerProps {
2
+ /**
3
+ * Function to receive the selected dates
4
+ */
2
5
  selectedDateRange: (a: {
3
6
  startDate: Date | null;
4
7
  endDate: Date | null;
5
8
  }) => void;
9
+ /**
10
+ * Label for the date range picker field
11
+ */
6
12
  label?: string;
13
+ /**
14
+ * Subtext to go with the label
15
+ */
7
16
  subtext?: string;
17
+ /**
18
+ * Placeholder text for the date range picker field
19
+ */
8
20
  placeholder?: string;
21
+ /**
22
+ * Placeholder text for the date range picker field
23
+ */
24
+ showActionButtons?: boolean;
9
25
  }
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { DropdownProps } from "./type";
3
+ /**
4
+ * Dropdown component for selecting from a list of options
5
+ */
3
6
  declare const DropdownList: (props: DropdownProps) => JSX.Element;
4
7
  export default DropdownList;
@@ -1,15 +1,36 @@
1
1
  export interface DropdownProps {
2
+ /**
3
+ * Array with object containing the label and value for each item to be displayed in the list
4
+ */
2
5
  options: {
3
6
  label: string;
4
7
  value: string;
5
8
  }[];
9
+ /**
10
+ * Initial text to be displayed in the field. Ideal for when using an update form to display the current value of the field
11
+ */
6
12
  initialText?: string;
13
+ /**
14
+ * Placeholder text to be displayed in the field
15
+ */
7
16
  placeholder?: string;
17
+ /**
18
+ * Function to receive the object of the selected item
19
+ */
8
20
  returnedSelection: (a: {
9
21
  label: string;
10
22
  value: string;
11
23
  }) => void;
24
+ /**
25
+ * Boolean to specify whether the field is active or disabled
26
+ */
12
27
  disabled?: boolean;
28
+ /**
29
+ * Label of the field
30
+ */
13
31
  label?: string;
32
+ /**
33
+ * Boolean to specify whether the list is searchable
34
+ */
14
35
  searchable?: boolean;
15
36
  }
@@ -1,4 +1,8 @@
1
1
  /// <reference types="react" />
2
2
  import { ExchangeRatesProps } from "./type";
3
+ /**
4
+ * Cards to display exchange rates between currencies
5
+ *
6
+ */
3
7
  declare const ExchangeRates: (props: ExchangeRatesProps) => JSX.Element;
4
8
  export default ExchangeRates;
@@ -1,8 +1,23 @@
1
1
  export interface ExchangeRatesProps {
2
+ /**
3
+ * The base currency from which the conversion is done
4
+ */
2
5
  baseCurr: string;
6
+ /**
7
+ * Short name of the base currency
8
+ */
3
9
  baseCurrShortName: string;
10
+ /**
11
+ * The source of the rates data
12
+ */
4
13
  source: string;
14
+ /**
15
+ * Date when the rate was last updated
16
+ */
5
17
  lastUpdated: string;
18
+ /**
19
+ * Array of other currencies to which the conversion is being done along with their rates comparing to the base currency
20
+ */
6
21
  exchangeCurrs: {
7
22
  currName: string;
8
23
  rate: number;
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { IndicesType } from "./type";
3
+ /**
4
+ * Component for displaying a widget of indices for different commodities
5
+ */
3
6
  declare const Indices: (props: IndicesType) => JSX.Element;
4
7
  export default Indices;
@@ -1,9 +1,18 @@
1
1
  export interface IndicesType {
2
+ /**
3
+ * Array containing the commodities and their values
4
+ */
2
5
  indices: {
3
6
  itemName: string;
4
7
  value: number;
5
8
  changePercent: number;
6
9
  }[];
10
+ /**
11
+ * The source where the data is being taken from
12
+ */
7
13
  source?: string;
14
+ /**
15
+ * Date when the data was last updated
16
+ */
8
17
  lastUpdated: string;
9
18
  }
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { RequestsProps } from "./type";
3
+ /**
4
+ * Table for displaying a history of LP requests in the LP app
5
+ */
3
6
  declare const LPRequestTable: (props: RequestsProps) => JSX.Element;
4
7
  export default LPRequestTable;
@@ -1,4 +1,7 @@
1
1
  export interface RequestsProps {
2
+ /**
3
+ * Array of transactions and their associated information
4
+ */
2
5
  transactions: {
3
6
  providerLogo?: string;
4
7
  providerName: string;
@@ -14,6 +17,9 @@ export interface RequestsProps {
14
17
  broker: string;
15
18
  clientId: string;
16
19
  }[];
20
+ /**
21
+ * Callback function to receive the object of the selected item
22
+ */
17
23
  callback: (a: {
18
24
  providerLogo?: string;
19
25
  providerName: string;
@@ -29,7 +35,16 @@ export interface RequestsProps {
29
35
  broker: string;
30
36
  clientId: string;
31
37
  }) => void;
38
+ /**
39
+ * Function to trigger a new transaction
40
+ */
32
41
  newTransactionFxn: () => void;
42
+ /**
43
+ * Boolean to display a details arrow for when there are details to show
44
+ */
33
45
  showDetailsArrow: boolean;
46
+ /**
47
+ * Boolean to display a column in the table for the broker
48
+ */
34
49
  showBroker?: boolean;
35
50
  }
@@ -2,8 +2,7 @@
2
2
  import './icons.css';
3
3
  import { SideNavProps } from "./type";
4
4
  /**
5
- * NOTE<br>
6
- * currentPage (optional) -- passed to the component to match pageName from mainNavLinks to highlight the current page in the menu
5
+ * Component for displaying a side navigation menu
7
6
  * */
8
7
  declare const LPSideNav: (props: SideNavProps) => JSX.Element;
9
8
  export default LPSideNav;
@@ -1,6 +1,12 @@
1
1
  import React, { ReactNode } from "react";
2
2
  export interface SideNavProps {
3
+ /**
4
+ * passed to the component to match pageName from mainNavLinks to highlight the current page in the menu
5
+ * */
3
6
  currentPage?: string;
7
+ /**
8
+ * Array of links to be displayed in the side nav with their associated keys in each object
9
+ */
4
10
  mainNavLinks: {
5
11
  label: string;
6
12
  iconClass: string;
@@ -8,6 +14,9 @@ export interface SideNavProps {
8
14
  pageName: string;
9
15
  LinkComponent?: renderLink;
10
16
  }[];
17
+ /**
18
+ * Specify whether to display the code maintenance menu or not
19
+ */
11
20
  codeMaintenanceLinks: boolean;
12
21
  }
13
22
  interface LinkProps {
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { TopBarProps } from "./type";
3
+ /**
4
+ *
5
+ */
3
6
  declare const LPTopBar: (props: TopBarProps) => JSX.Element;
4
7
  export default LPTopBar;
@@ -1,6 +1,15 @@
1
1
  export interface TopBarProps {
2
+ /**
3
+ * Username of the logged-in user
4
+ */
2
5
  userName: string;
6
+ /**
7
+ * URL to the lp request page
8
+ */
3
9
  requestLpUrl: string;
10
+ /**
11
+ * Array of notifications to be displayed in the notifications panel
12
+ */
4
13
  notifications: {
5
14
  notifTitle: string;
6
15
  notifTime: string;
@@ -14,6 +23,12 @@ export interface TopBarProps {
14
23
  transactionNumber: string;
15
24
  notifRead: boolean;
16
25
  }[];
26
+ /**
27
+ * Logged-in user's profile image url
28
+ */
17
29
  myProfileUrl: string;
30
+ /**
31
+ * URL endpoint to perform a logout
32
+ */
18
33
  signOutApiUrl: string;
19
34
  }
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { LoaderType } from "./type";
3
+ /**
4
+ * Displaying skeleton loader in anticipation of data that is being loaded
5
+ */
3
6
  declare const LoadingShimmer: (props: LoaderType) => JSX.Element;
4
7
  export default LoadingShimmer;
@@ -1,5 +1,14 @@
1
1
  export interface LoaderType {
2
+ /**
3
+ * Shape of skeleton loader
4
+ */
2
5
  shape: 'circular' | 'rectangular';
6
+ /**
7
+ * Width of the skeleton loader. If not specified, it assumes the full width of the space available to it.
8
+ */
3
9
  width?: number;
10
+ /**
11
+ * Height of the skeleton loader. Unlike the width, this is required.
12
+ */
4
13
  height: number;
5
14
  }
@@ -1,7 +1,13 @@
1
1
  /// <reference types="react" />
2
2
  import './style.css';
3
3
  export interface LoaderProps {
4
+ /**
5
+ * Variant of the loader whether
6
+ */
4
7
  variant: 'primary' | 'error';
5
8
  }
9
+ /**
10
+ * Component for displaying a loading spinner for when data is being loaded
11
+ */
6
12
  declare const Loader: (props: LoaderProps) => JSX.Element;
7
13
  export default Loader;
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { MarketDataProps } from "./type";
3
+ /**
4
+ * Component to display cards of market data widget
5
+ */
3
6
  declare const MarketData: (props: MarketDataProps) => JSX.Element;
4
7
  export default MarketData;
@@ -1,4 +1,7 @@
1
1
  export interface MarketDataProps {
2
+ /**
3
+ * Array of data to be displayed in the cards
4
+ */
2
5
  marketData: {
3
6
  market: string;
4
7
  marketCountryFlag: string;
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { MarketMoversProps } from "./type";
3
+ /**
4
+ * Component to display a widget for market movers
5
+ */
3
6
  declare const MarketMovers: (props: MarketMoversProps) => JSX.Element;
4
7
  export default MarketMovers;
@@ -1,4 +1,7 @@
1
1
  export interface MarketMoversProps {
2
+ /**
3
+ * Array of data to be displayed in the cards
4
+ */
2
5
  movers: {
3
6
  entityName: string;
4
7
  entityShortName: string;
@@ -8,5 +11,8 @@ export interface MarketMoversProps {
8
11
  type: 'top' | 'worst';
9
12
  marketFlag: string;
10
13
  }[];
14
+ /**
15
+ * Date when the data was last updated
16
+ */
11
17
  lastUpdated: string;
12
18
  }
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { MenuBarProps } from "./type";
3
+ /**
4
+ * Menu bar displaying a menu at the top of the news app
5
+ */
3
6
  declare const MenuBar: (props: MenuBarProps) => JSX.Element;
4
7
  export default MenuBar;
@@ -1,8 +1,14 @@
1
1
  export interface MenuBarProps {
2
+ /**
3
+ * Array containing menu items to be displayed in the menu list
4
+ */
2
5
  menuItems: {
3
6
  label: string;
4
7
  url: string;
5
8
  pageName?: string;
6
9
  }[];
10
+ /**
11
+ * Name of the current page. Should match the <code>pageName</code> from the <code>menuItems</code> array for highlighting the current page
12
+ */
7
13
  currentPageName?: string;
8
14
  }
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { NewsProps } from "./type";
3
+ /**
4
+ * Card to display news items in the News application
5
+ */
3
6
  declare const NewsCard: (props: NewsProps) => JSX.Element;
4
7
  export default NewsCard;
@@ -1,10 +1,34 @@
1
1
  export interface NewsProps {
2
+ /**
3
+ * ID of the news item
4
+ */
2
5
  id: string;
6
+ /**
7
+ * Title of the news item
8
+ */
3
9
  title: string;
10
+ /**
11
+ * Excerpt of the news item
12
+ */
4
13
  excerpt: string;
14
+ /**
15
+ * Source of the news item
16
+ */
5
17
  source: string;
18
+ /**
19
+ * Country flag of the source
20
+ */
6
21
  sourceCountryFlag: string;
22
+ /**
23
+ * Date of the news item
24
+ */
7
25
  date: string;
26
+ /**
27
+ * Featured image of the news item
28
+ */
8
29
  featuredImg: string;
30
+ /**
31
+ * URL of the news item
32
+ */
9
33
  storyUrl: string;
10
34
  }
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { NewsFilterProps } from "./type";
3
+ /**
4
+ * Filter bar for news items on the news application
5
+ */
3
6
  declare const NewsFilterBar: (props: NewsFilterProps) => JSX.Element;
4
7
  export default NewsFilterBar;
@@ -1,13 +1,25 @@
1
1
  import React from "react";
2
2
  export interface NewsFilterProps extends React.HTMLAttributes<any> {
3
+ /**
4
+ * Array of source countries
5
+ */
3
6
  countries: {
4
7
  label: string;
5
8
  value: string;
6
9
  }[];
10
+ /**
11
+ * Array of source outlets
12
+ */
7
13
  outlets: {
8
14
  label: string;
9
15
  value: string;
10
16
  }[];
17
+ /**
18
+ * Callback function to receive the selected outlet
19
+ */
11
20
  selectedOutletFxn?: Function;
21
+ /**
22
+ * Callback function to receive the selected source country
23
+ */
12
24
  selectedCountryFxn?: Function;
13
25
  }
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { TagProps } from "./type";
3
+ /**
4
+ * Card tag to display the source and date of a news item
5
+ */
3
6
  declare const NewsSourceTag: (props: TagProps) => JSX.Element;
4
7
  export default NewsSourceTag;
@@ -1,5 +1,14 @@
1
1
  export interface TagProps {
2
+ /**
3
+ * URL to the flag of the source country
4
+ */
2
5
  flag: string;
6
+ /**
7
+ * Name of the source where the news item is coming from
8
+ */
3
9
  source: string;
10
+ /**
11
+ * Date when the news item was published
12
+ */
4
13
  date: string;
5
14
  }
@@ -1,4 +1,7 @@
1
1
  /// <reference types="react" />
2
2
  import { NewsBarProps } from "./type";
3
+ /**
4
+ * Component to display a section title on the news application where news items are displayed
5
+ */
3
6
  declare const NewsTitleBar: (props: NewsBarProps) => JSX.Element;
4
7
  export default NewsTitleBar;
@@ -1,4 +1,7 @@
1
1
  import React from "react";
2
2
  export interface NewsBarProps extends React.HTMLAttributes<any> {
3
+ /**
4
+ * Title of the section
5
+ */
3
6
  title: string;
4
7
  }