@shipengine/elements 0.32.2 → 0.34.0

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 (26) hide show
  1. package/index.cjs +311 -130
  2. package/index.js +313 -133
  3. package/package.json +5 -10
  4. package/src/components/add-funds-form/add-funds-form.d.ts +2 -0
  5. package/src/components/templates/add-carrier-form/add-carrier-form-schema.d.ts +1 -1
  6. package/src/components/templates/address-form/address-form-schema.d.ts +153 -2
  7. package/src/components/templates/address-form/address-form.d.ts +2 -1
  8. package/src/components/templates/address-form/address-schema.d.ts +1 -1
  9. package/src/components/templates/carrier-recovery-form/carrier-recovery-form-schema.d.ts +5 -2
  10. package/src/components/templates/carrier-terms-form/carrier-terms-form.styles.d.ts +1 -0
  11. package/src/components/templates/landing-page/landing-page.d.ts +2 -1
  12. package/src/components/templates/onboarding/onboarding.d.ts +4 -1
  13. package/src/components/templates/onboarding/onboarding.styles.d.ts +10 -0
  14. package/src/components/templates/wallet-form/wallet-form.d.ts +1 -0
  15. package/src/components/templates/wallet-form/wallet-schema.d.ts +5 -2
  16. package/src/components/templates/warehouse-form/warehouse-form-schema.d.ts +3 -3
  17. package/src/components/templates/warehouse-form/warehouse-form.d.ts +1 -1
  18. package/src/elements/account-settings/account-settings.d.ts +8 -2
  19. package/src/elements/onboarding/onboarding.d.ts +11 -3
  20. package/src/elements/purchase-label/purchase-label.d.ts +8 -2
  21. package/src/elements/view-shipment/view-shipment.d.ts +8 -2
  22. package/src/elements/void-label/void-label.d.ts +8 -2
  23. package/src/hooks/index.d.ts +1 -0
  24. package/src/hooks/use-black-box-detection.d.ts +23 -0
  25. package/src/locales/en/index.d.ts +8 -2
  26. package/src/testing/extensions/queries/by-icon-name.d.ts +1 -1
@@ -8,7 +8,7 @@ export declare const warehouseSchema: z.ZodDiscriminatedUnion<"returnToAddressIs
8
8
  cityLocality: z.ZodString;
9
9
  companyName: z.ZodEffects<z.ZodUnion<[z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodString>>, string | undefined, string | null | undefined>, z.ZodLiteral<"">]>, string | undefined, string | null | undefined>;
10
10
  countryCode: z.ZodEnum<["AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "CA", "KH", "CM", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "CI", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "VI", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW"]>;
11
- name: z.ZodEffects<z.ZodString, string, string>;
11
+ name: z.ZodString;
12
12
  phone: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodString>>, string, string | null | undefined>;
13
13
  postalCode: z.ZodString;
14
14
  stateProvince: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodString>>, string, string | null | undefined>;
@@ -111,7 +111,7 @@ export declare const warehouseSchema: z.ZodDiscriminatedUnion<"returnToAddressIs
111
111
  cityLocality: z.ZodString;
112
112
  companyName: z.ZodEffects<z.ZodUnion<[z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodString>>, string | undefined, string | null | undefined>, z.ZodLiteral<"">]>, string | undefined, string | null | undefined>;
113
113
  countryCode: z.ZodEnum<["AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "CA", "KH", "CM", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "CI", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "VI", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW"]>;
114
- name: z.ZodEffects<z.ZodString, string, string>;
114
+ name: z.ZodString;
115
115
  phone: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodString>>, string, string | null | undefined>;
116
116
  postalCode: z.ZodString;
117
117
  stateProvince: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodString>>, string, string | null | undefined>;
@@ -274,7 +274,7 @@ export declare const warehouseSchema: z.ZodDiscriminatedUnion<"returnToAddressIs
274
274
  cityLocality: z.ZodString;
275
275
  companyName: z.ZodEffects<z.ZodUnion<[z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodString>>, string | undefined, string | null | undefined>, z.ZodLiteral<"">]>, string | undefined, string | null | undefined>;
276
276
  countryCode: z.ZodEnum<["AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "CA", "KH", "CM", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "CI", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "VI", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW"]>;
277
- name: z.ZodEffects<z.ZodString, string, string>;
277
+ name: z.ZodString;
278
278
  phone: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodString>>, string, string | null | undefined>;
279
279
  postalCode: z.ZodString;
280
280
  stateProvince: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodString>>, string, string | null | undefined>;
@@ -6,6 +6,6 @@ export type WarehouseFormProps = {
6
6
  onDelete?: () => void;
7
7
  onSubmit: (payload: WarehousePayload) => void;
8
8
  submitButtonTitle: string;
9
- warehouse?: SE.Warehouse;
9
+ warehouse?: SE.Warehouse | Pick<SE.Warehouse, "name" | "isDefault" | "originAddress" | "returnAddress">;
10
10
  };
11
11
  export declare const WarehouseForm: ({ isOnboarding, onCancel, onDelete, onSubmit, submitButtonTitle, warehouse, }: WarehouseFormProps) => import("@emotion/react/jsx-runtime").JSX.Element;
@@ -108,6 +108,9 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
108
108
  confirmAddress: string;
109
109
  description: string;
110
110
  };
111
+ blackBox: {
112
+ description: string;
113
+ };
111
114
  };
112
115
  };
113
116
  settings: {
@@ -228,13 +231,14 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
228
231
  subtitle: string;
229
232
  welcome: string;
230
233
  messageLine1: string;
234
+ partnerMessageLine1: string;
231
235
  messageLine2: string;
232
236
  };
233
237
  steps: {
234
- login: string;
238
+ register: string;
235
239
  carriers: string;
236
240
  addresses: string;
237
- payment: string;
241
+ billing: string;
238
242
  };
239
243
  warehouse: {
240
244
  title: string;
@@ -525,6 +529,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
525
529
  accountSettings: string;
526
530
  carrier: string;
527
531
  carriers: string;
532
+ connectingCarriers: string;
528
533
  data: string;
529
534
  importingSalesOrder: string;
530
535
  label: string;
@@ -565,6 +570,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
565
570
  allMeasurementsOrNone: string;
566
571
  };
567
572
  invalidAddressName: string;
573
+ invalidAddressNameStrict: string;
568
574
  invalidAddressPoBox: string;
569
575
  invalidCreditCardType: string;
570
576
  invalidExpiration: string;
@@ -2,9 +2,11 @@
2
2
  import { OnboardingProps } from "../../components/templates";
3
3
  export type ComponentProps = {
4
4
  features?: OnboardingProps["features"];
5
+ onboardingAddress?: OnboardingProps["onboardingAddress"];
5
6
  onCompleteOnboarding: () => void;
7
+ partnerName?: OnboardingProps["partnerName"];
6
8
  };
7
- export declare const Component: ({ features, onCompleteOnboarding }: ComponentProps) => import("@emotion/react/jsx-runtime").JSX.Element;
9
+ export declare const Component: ({ features, onboardingAddress, onCompleteOnboarding, partnerName, }: ComponentProps) => import("@emotion/react/jsx-runtime").JSX.Element;
8
10
  export declare const Element: ({ resources, ...props }: ComponentProps & {
9
11
  resources?: {
10
12
  en: {
@@ -110,6 +112,9 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
110
112
  confirmAddress: string;
111
113
  description: string;
112
114
  };
115
+ blackBox: {
116
+ description: string;
117
+ };
113
118
  };
114
119
  };
115
120
  settings: {
@@ -230,13 +235,14 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
230
235
  subtitle: string;
231
236
  welcome: string;
232
237
  messageLine1: string;
238
+ partnerMessageLine1: string;
233
239
  messageLine2: string;
234
240
  };
235
241
  steps: {
236
- login: string;
242
+ register: string;
237
243
  carriers: string;
238
244
  addresses: string;
239
- payment: string;
245
+ billing: string;
240
246
  };
241
247
  warehouse: {
242
248
  title: string;
@@ -527,6 +533,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
527
533
  accountSettings: string;
528
534
  carrier: string;
529
535
  carriers: string;
536
+ connectingCarriers: string;
530
537
  data: string;
531
538
  importingSalesOrder: string;
532
539
  label: string;
@@ -567,6 +574,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
567
574
  allMeasurementsOrNone: string;
568
575
  };
569
576
  invalidAddressName: string;
577
+ invalidAddressNameStrict: string;
570
578
  invalidAddressPoBox: string;
571
579
  invalidCreditCardType: string;
572
580
  invalidExpiration: string;
@@ -129,6 +129,9 @@ export declare const Element: ({ resources, ...props }: ElementProps & {
129
129
  confirmAddress: string;
130
130
  description: string;
131
131
  };
132
+ blackBox: {
133
+ description: string;
134
+ };
132
135
  };
133
136
  };
134
137
  settings: {
@@ -249,13 +252,14 @@ export declare const Element: ({ resources, ...props }: ElementProps & {
249
252
  subtitle: string;
250
253
  welcome: string;
251
254
  messageLine1: string;
255
+ partnerMessageLine1: string;
252
256
  messageLine2: string;
253
257
  };
254
258
  steps: {
255
- login: string;
259
+ register: string;
256
260
  carriers: string;
257
261
  addresses: string;
258
- payment: string;
262
+ billing: string;
259
263
  };
260
264
  warehouse: {
261
265
  title: string;
@@ -546,6 +550,7 @@ export declare const Element: ({ resources, ...props }: ElementProps & {
546
550
  accountSettings: string;
547
551
  carrier: string;
548
552
  carriers: string;
553
+ connectingCarriers: string;
549
554
  data: string;
550
555
  importingSalesOrder: string;
551
556
  label: string;
@@ -586,6 +591,7 @@ export declare const Element: ({ resources, ...props }: ElementProps & {
586
591
  allMeasurementsOrNone: string;
587
592
  };
588
593
  invalidAddressName: string;
594
+ invalidAddressNameStrict: string;
589
595
  invalidAddressPoBox: string;
590
596
  invalidCreditCardType: string;
591
597
  invalidExpiration: string;
@@ -114,6 +114,9 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
114
114
  confirmAddress: string;
115
115
  description: string;
116
116
  };
117
+ blackBox: {
118
+ description: string;
119
+ };
117
120
  };
118
121
  };
119
122
  settings: {
@@ -234,13 +237,14 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
234
237
  subtitle: string;
235
238
  welcome: string;
236
239
  messageLine1: string;
240
+ partnerMessageLine1: string;
237
241
  messageLine2: string;
238
242
  };
239
243
  steps: {
240
- login: string;
244
+ register: string;
241
245
  carriers: string;
242
246
  addresses: string;
243
- payment: string;
247
+ billing: string;
244
248
  };
245
249
  warehouse: {
246
250
  title: string;
@@ -531,6 +535,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
531
535
  accountSettings: string;
532
536
  carrier: string;
533
537
  carriers: string;
538
+ connectingCarriers: string;
534
539
  data: string;
535
540
  importingSalesOrder: string;
536
541
  label: string;
@@ -571,6 +576,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
571
576
  allMeasurementsOrNone: string;
572
577
  };
573
578
  invalidAddressName: string;
579
+ invalidAddressNameStrict: string;
574
580
  invalidAddressPoBox: string;
575
581
  invalidCreditCardType: string;
576
582
  invalidExpiration: string;
@@ -117,6 +117,9 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
117
117
  confirmAddress: string;
118
118
  description: string;
119
119
  };
120
+ blackBox: {
121
+ description: string;
122
+ };
120
123
  };
121
124
  };
122
125
  settings: {
@@ -237,13 +240,14 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
237
240
  subtitle: string;
238
241
  welcome: string;
239
242
  messageLine1: string;
243
+ partnerMessageLine1: string;
240
244
  messageLine2: string;
241
245
  };
242
246
  steps: {
243
- login: string;
247
+ register: string;
244
248
  carriers: string;
245
249
  addresses: string;
246
- payment: string;
250
+ billing: string;
247
251
  };
248
252
  warehouse: {
249
253
  title: string;
@@ -534,6 +538,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
534
538
  accountSettings: string;
535
539
  carrier: string;
536
540
  carriers: string;
541
+ connectingCarriers: string;
537
542
  data: string;
538
543
  importingSalesOrder: string;
539
544
  label: string;
@@ -574,6 +579,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
574
579
  allMeasurementsOrNone: string;
575
580
  };
576
581
  invalidAddressName: string;
582
+ invalidAddressNameStrict: string;
577
583
  invalidAddressPoBox: string;
578
584
  invalidCreditCardType: string;
579
585
  invalidExpiration: string;
@@ -6,3 +6,4 @@ export * from "./use-root-portal";
6
6
  export * from "./use-run-once-on-true";
7
7
  export * from "./use-toggle";
8
8
  export * from "./use-address-validation";
9
+ export * from "./use-black-box-detection";
@@ -0,0 +1,23 @@
1
+ export type BlackBoxDetectionProps = {
2
+ onError: () => void;
3
+ onSuccess: (blackbox: string) => void;
4
+ };
5
+ type IoBlackBox = () => {
6
+ blackbox: string;
7
+ finished: boolean;
8
+ };
9
+ declare global {
10
+ interface Window {
11
+ io_enable_rip?: boolean;
12
+ io_exclude_stm?: number;
13
+ io_install_flash?: boolean;
14
+ io_install_stm?: boolean;
15
+ }
16
+ let ioGetBlackbox: IoBlackBox | undefined;
17
+ }
18
+ /**
19
+ * Creates an encoded device fingerprint string - aka black box - containing information about the end-user's computing device such as OS, browser, etc.
20
+ * https://developer.bazaarvoice.com/conversations-api/deprecations/iovation-web#snare_js_only
21
+ */
22
+ export declare const useBlackboxDetection: ({ onSuccess, onError }: BlackBoxDetectionProps) => void;
23
+ export {};
@@ -101,6 +101,9 @@ declare const _default: {
101
101
  confirmAddress: string;
102
102
  description: string;
103
103
  };
104
+ blackBox: {
105
+ description: string;
106
+ };
104
107
  };
105
108
  };
106
109
  settings: {
@@ -221,13 +224,14 @@ declare const _default: {
221
224
  subtitle: string;
222
225
  welcome: string;
223
226
  messageLine1: string;
227
+ partnerMessageLine1: string;
224
228
  messageLine2: string;
225
229
  };
226
230
  steps: {
227
- login: string;
231
+ register: string;
228
232
  carriers: string;
229
233
  addresses: string;
230
- payment: string;
234
+ billing: string;
231
235
  };
232
236
  warehouse: {
233
237
  title: string;
@@ -518,6 +522,7 @@ declare const _default: {
518
522
  accountSettings: string;
519
523
  carrier: string;
520
524
  carriers: string;
525
+ connectingCarriers: string;
521
526
  data: string;
522
527
  importingSalesOrder: string;
523
528
  label: string;
@@ -558,6 +563,7 @@ declare const _default: {
558
563
  allMeasurementsOrNone: string;
559
564
  };
560
565
  invalidAddressName: string;
566
+ invalidAddressNameStrict: string;
561
567
  invalidAddressPoBox: string;
562
568
  invalidCreditCardType: string;
563
569
  invalidExpiration: string;
@@ -1,4 +1,4 @@
1
1
  import { MatcherOptions, queryHelpers } from "@testing-library/react";
2
- import { IconNames } from "@packlink/brands";
2
+ import { IconNames } from "@packlink/giger-theme";
3
3
  export declare const queryAllByIconName: (container: HTMLElement, iconName: IconNames, options?: MatcherOptions | undefined) => HTMLElement[];
4
4
  export declare const queryByIconName: queryHelpers.QueryBy<[dataIdValue: IconNames]>, getAllByIconName: queryHelpers.GetAllBy<[dataIdValue: IconNames]>, getByIconName: queryHelpers.GetBy<[dataIdValue: IconNames]>, findAllByIconName: queryHelpers.FindAllBy<[dataIdValue: IconNames]>, findByIconName: queryHelpers.FindBy<[dataIdValue: IconNames]>;