@multivendorx/zyra 1.0.64 → 1.0.65

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 (125) hide show
  1. package/build/index.d.ts +1 -0
  2. package/build/index.js +6770 -6158
  3. package/build/index.js.map +1 -1
  4. package/build/index.mjs +6770 -6158
  5. package/build/index.mjs.map +1 -1
  6. package/build/types/builderform/src/EmailBuilder.d.ts +29 -0
  7. package/build/types/builderform/src/EmailTemplateEditorPopup.d.ts +16 -0
  8. package/build/types/builderform/src/FormBuilder/Builder.d.ts +11 -0
  9. package/build/types/builderform/src/FormBuilder/Canvas.d.ts +23 -0
  10. package/build/types/builderform/src/FormBuilder/FormBuilder.d.ts +13 -0
  11. package/build/types/builderform/src/FormBuilder/FormSettings.d.ts +19 -0
  12. package/build/types/builderform/src/FormBuilder/Inspector.d.ts +14 -0
  13. package/build/types/builderform/src/FormBuilder/Share.d.ts +10 -0
  14. package/build/types/builderform/src/FormBuilder/When.d.ts +20 -0
  15. package/build/types/builderform/src/FormBuilder/extensions.d.ts +97 -0
  16. package/build/types/builderform/src/FormBuilder/fields.d.ts +36 -0
  17. package/build/types/builderform/src/FormBuilder/index.d.ts +5 -0
  18. package/build/types/builderform/src/FormBuilder/route.d.ts +10 -0
  19. package/build/types/builderform/src/FormBuilder/runtime.d.ts +87 -0
  20. package/build/types/builderform/src/FormBuilder/types.d.ts +151 -0
  21. package/build/types/builderform/src/Switch.d.ts +9 -0
  22. package/build/types/builderform/src/emailBlockTypes.d.ts +89 -0
  23. package/build/types/builderform/src/index.d.ts +9 -0
  24. package/build/types/builderform/src/legacyEmailAdapter.d.ts +40 -0
  25. package/build/types/bundle/src/fieldRegistry.d.ts +1 -0
  26. package/build/types/bundle/src/index.d.ts +6 -0
  27. package/build/types/components/src/ActivityListComponent.d.ts +39 -0
  28. package/build/types/components/src/AnalyticsComponent.d.ts +56 -0
  29. package/build/types/components/src/AppShellComponent.d.ts +64 -0
  30. package/build/types/components/src/AuthLayoutComponent.d.ts +26 -0
  31. package/build/types/components/src/AvatarComponent.d.ts +13 -0
  32. package/build/types/components/src/BadgeComponent.d.ts +30 -0
  33. package/build/types/components/src/BrandComponent.d.ts +18 -0
  34. package/build/types/components/src/CardComponent.d.ts +25 -0
  35. package/build/types/components/src/ChartComponent.d.ts +58 -0
  36. package/build/types/components/src/ChoiceCardComponent.d.ts +41 -0
  37. package/build/types/components/src/ClipboardComponent.d.ts +13 -0
  38. package/build/types/components/src/ColumnComponent.d.ts +11 -0
  39. package/build/types/components/src/ContainerComponent.d.ts +11 -0
  40. package/build/types/components/src/CustomRecaptchaComponent.d.ts +2 -0
  41. package/build/types/components/src/EntityCellComponent.d.ts +30 -0
  42. package/build/types/components/src/FilterComponent.d.ts +20 -0
  43. package/build/types/components/src/FormGroupComponent.d.ts +19 -0
  44. package/build/types/components/src/FormGroupWrapperComponent.d.ts +10 -0
  45. package/build/types/components/src/FullPageLoadingComponent.d.ts +14 -0
  46. package/build/types/components/src/HeaderComponent.d.ts +93 -0
  47. package/build/types/components/src/HeaderSearchComponent.d.ts +32 -0
  48. package/build/types/components/src/IconComponent.d.ts +12 -0
  49. package/build/types/components/src/InformationItemComponent.d.ts +38 -0
  50. package/build/types/components/src/LegendComponent.d.ts +52 -0
  51. package/build/types/components/src/ListComponent.d.ts +47 -0
  52. package/build/types/components/src/ListToolbarComponent.d.ts +53 -0
  53. package/build/types/components/src/MapComponent.d.ts +33 -0
  54. package/build/types/components/src/MetricTileComponent.d.ts +174 -0
  55. package/build/types/components/src/ModuleGridComponent.d.ts +74 -0
  56. package/build/types/components/src/ModuleGuardComponent.d.ts +17 -0
  57. package/build/types/components/src/NavigatorComponent.d.ts +111 -0
  58. package/build/types/components/src/NoticeComponent.d.ts +48 -0
  59. package/build/types/components/src/PopupComponent.d.ts +28 -0
  60. package/build/types/components/src/RecaptchaComponent.d.ts +11 -0
  61. package/build/types/components/src/SaveStatusComponent.d.ts +18 -0
  62. package/build/types/components/src/ScoreRingComponent.d.ts +16 -0
  63. package/build/types/components/src/SectionComponent.d.ts +18 -0
  64. package/build/types/components/src/SettingRowComponent.d.ts +134 -0
  65. package/build/types/components/src/SettingsSectionComponent.d.ts +24 -0
  66. package/build/types/components/src/SetupWizardComponent.d.ts +75 -0
  67. package/build/types/components/src/SkeletonComponent.d.ts +11 -0
  68. package/build/types/components/src/SystemInfoComponent.d.ts +11 -0
  69. package/build/types/components/src/TabsComponent.d.ts +34 -0
  70. package/build/types/components/src/ThemeChoiceComponent.d.ts +19 -0
  71. package/build/types/components/src/TooltipComponent.d.ts +12 -0
  72. package/build/types/components/src/TourComponent.d.ts +26 -0
  73. package/build/types/components/src/TrendIndicatorComponent.d.ts +21 -0
  74. package/build/types/components/src/TrendStatComponent.d.ts +34 -0
  75. package/build/types/components/src/TypographyComponent.d.ts +58 -0
  76. package/build/types/components/src/index.d.ts +84 -0
  77. package/build/types/components/src/paletteClass.d.ts +3 -0
  78. package/build/types/core/src/ModuleContext.d.ts +8 -0
  79. package/build/types/core/src/SettingContext.d.ts +17 -0
  80. package/build/types/core/src/ThemeContext.d.ts +20 -0
  81. package/build/types/core/src/apiService.d.ts +38 -0
  82. package/build/types/core/src/blockStyle.d.ts +63 -0
  83. package/build/types/core/src/colorPalette.d.ts +41 -0
  84. package/build/types/core/src/index.d.ts +14 -0
  85. package/build/types/core/src/utils.d.ts +1165 -0
  86. package/build/types/inputs/src/AddressInput.d.ts +24 -0
  87. package/build/types/inputs/src/ButtonInput.d.ts +53 -0
  88. package/build/types/inputs/src/CalendarInput.d.ts +46 -0
  89. package/build/types/inputs/src/DecoratedInput.d.ts +11 -0
  90. package/build/types/inputs/src/DynamicRowInput.d.ts +42 -0
  91. package/build/types/inputs/src/EmailInput.d.ts +15 -0
  92. package/build/types/inputs/src/EndpointInput.d.ts +4 -0
  93. package/build/types/inputs/src/EventCalendarInput.d.ts +25 -0
  94. package/build/types/inputs/src/ExpandablePanelInput.d.ts +116 -0
  95. package/build/types/inputs/src/FileInput.d.ts +39 -0
  96. package/build/types/inputs/src/InputRenderer.d.ts +94 -0
  97. package/build/types/inputs/src/LogViewerInput.d.ts +13 -0
  98. package/build/types/inputs/src/MultiCheckboxInput.d.ts +48 -0
  99. package/build/types/inputs/src/NestedInput.d.ts +54 -0
  100. package/build/types/inputs/src/PhoneInput.d.ts +29 -0
  101. package/build/types/inputs/src/PickerInput.d.ts +77 -0
  102. package/build/types/inputs/src/RandomkeyInput.d.ts +14 -0
  103. package/build/types/inputs/src/RichTextInput.d.ts +30 -0
  104. package/build/types/inputs/src/SelectInput.d.ts +40 -0
  105. package/build/types/inputs/src/SetupWizardInput.d.ts +50 -0
  106. package/build/types/inputs/src/ShortcodeTableInput.d.ts +23 -0
  107. package/build/types/inputs/src/TableInput.d.ts +72 -0
  108. package/build/types/inputs/src/TaskExecutorInput.d.ts +30 -0
  109. package/build/types/inputs/src/TextAreaInput.d.ts +27 -0
  110. package/build/types/inputs/src/TextInput.d.ts +33 -0
  111. package/build/types/inputs/src/ToggleInput.d.ts +37 -0
  112. package/build/types/inputs/src/index.d.ts +53 -0
  113. package/build/types/table/src/Table.d.ts +4 -0
  114. package/build/types/table/src/TableActionButtons.d.ts +16 -0
  115. package/build/types/table/src/TableBulkActions.d.ts +19 -0
  116. package/build/types/table/src/TableCard.d.ts +10 -0
  117. package/build/types/table/src/TableEditable.d.ts +18 -0
  118. package/build/types/table/src/TableFilter.d.ts +19 -0
  119. package/build/types/table/src/TablePagination.d.ts +17 -0
  120. package/build/types/table/src/TableRowActions.d.ts +17 -0
  121. package/build/types/table/src/TableUtils.d.ts +3 -0
  122. package/build/types/table/src/index.d.ts +5 -0
  123. package/build/types/table/src/tableLabels.d.ts +14 -0
  124. package/build/types/table/src/types.d.ts +166 -0
  125. package/package.json +2 -3
@@ -0,0 +1,111 @@
1
+ import React, { ReactNode, JSX } from 'react';
2
+ import { LinkProps } from 'react-router-dom';
3
+ import './NavigatorComponent.scss';
4
+ import { type SaveStatus, type SaveStatusLabels } from './SaveStatusComponent';
5
+ export type Content = {
6
+ id: string;
7
+ headerTitle: string;
8
+ headerDescription?: string;
9
+ headerIcon?: string;
10
+ count?: string;
11
+ settingTitle?: string;
12
+ settingSubTitle?: string;
13
+ hideSettingHeader?: boolean;
14
+ /**
15
+ * Content shown on the right of this file's own settings header row
16
+ * (next to `settingTitle`/`settingSubTitle`) — e.g. a "Send Test
17
+ * Alert" button. Passed straight through to `SectionComponent`'s own
18
+ * `rightContent`. Ignored when `hideSettingHeader` is set.
19
+ */
20
+ settingAction?: React.ReactNode;
21
+ };
22
+ type SettingContent = {
23
+ name?: string;
24
+ type: 'file' | 'folder' | 'heading';
25
+ content: Content | SettingContent[];
26
+ /** `menuIcon`-gated tab-bar icon for this folder — same field name as `Content`'s own file-level `headerIcon`, which already renders one; folders had no equivalent until now. */
27
+ headerIcon?: string;
28
+ };
29
+ interface Button {
30
+ label: string;
31
+ onClick: () => void;
32
+ icon: string;
33
+ color: string;
34
+ }
35
+ interface Badge {
36
+ text: string;
37
+ color?: string;
38
+ }
39
+ type SettingsNavigatorProps = {
40
+ settingContent: SettingContent[];
41
+ className?: string;
42
+ currentSetting: string;
43
+ /**
44
+ * `activeFile` is this file's own resolved `Content` (the same object
45
+ * `renderSettingHeaderInfo` reads its own header from) — lets a caller
46
+ * whose form is e.g. an `InputRenderer` read `hideSettingHeader` (or
47
+ * any other per-file config) straight off it instead of re-deriving it
48
+ * from its own separate copy of `settingContent`.
49
+ */
50
+ getForm: (settingId: string, activeFile?: Content) => ReactNode;
51
+ prepareUrl: (settingId: string) => string;
52
+ HeaderSection?: () => JSX.Element;
53
+ Link: React.ElementType<LinkProps>;
54
+ settingName?: string;
55
+ onNavigate?: (url: string) => void;
56
+ settingTitleSection?: React.ReactNode;
57
+ menuIcon?: boolean;
58
+ variant?: 'default' | 'compact' | 'tab' | 'card' | 'small-card' | 'settings';
59
+ action?: React.ReactNode;
60
+ headerTitle?: string;
61
+ headerDescription?: string;
62
+ headerIcon?: string;
63
+ showPremiumLink?: boolean;
64
+ customContent?: React.ReactNode;
65
+ headerCustomContent?: React.ReactNode;
66
+ hideHeader?: boolean;
67
+ buttons?: Button[];
68
+ badges?: Badge[];
69
+ /** Autosave state shown as a pill in the header (spinner / "All changes saved" / error). Omit to hide it. */
70
+ saveStatus?: SaveStatus;
71
+ /** Override the pill's default English texts, e.g. with translated strings. */
72
+ saveStatusLabels?: SaveStatusLabels;
73
+ };
74
+ interface NavigatorHeaderProps {
75
+ /** A trail (e.g. `<BreadcrumbTrail>`) shown above the title. */
76
+ breadcrumbs?: React.ReactNode;
77
+ /** Small accent line above the title. */
78
+ eyebrow?: React.ReactNode;
79
+ headerIcon?: string;
80
+ headerTitle?: React.ReactNode;
81
+ headerDescription?: React.ReactNode;
82
+ showPremiumLink?: string;
83
+ buttons?: Button[];
84
+ headerCustomContent?: React.ReactNode;
85
+ badges?: Badge[];
86
+ /** Autosave state shown as a pill in the header (spinner / "All changes saved" / error). Omit to hide it. */
87
+ saveStatus?: SaveStatus;
88
+ /** Override the pill's default English texts, e.g. with translated strings. */
89
+ saveStatusLabels?: SaveStatusLabels;
90
+ /** Same `renderBreadcrumb` the standalone `Breadcrumb` component takes — rendered here instead, above the title, so it sits inside this header block rather than as `Breadcrumb`'s own separate row. */
91
+ renderBreadcrumb?: () => React.ReactNode;
92
+ }
93
+ export declare const NavigatorHeaderComponent: React.FC<NavigatorHeaderProps>;
94
+ export interface BreadcrumbTrailItem {
95
+ label: React.ReactNode;
96
+ href?: string;
97
+ onClick?: (e: React.MouseEvent) => void;
98
+ }
99
+ interface BreadcrumbTrailProps {
100
+ items: BreadcrumbTrailItem[];
101
+ linkComponent?: React.ElementType<{
102
+ href: string;
103
+ onClick?: (e: React.MouseEvent) => void;
104
+ children?: React.ReactNode;
105
+ }>;
106
+ ariaLabel?: string;
107
+ className?: string;
108
+ }
109
+ export declare const BreadcrumbTrail: React.FC<BreadcrumbTrailProps>;
110
+ declare const NavigatorComponent: React.FC<SettingsNavigatorProps>;
111
+ export default NavigatorComponent;
@@ -0,0 +1,48 @@
1
+ import React from 'react';
2
+ import './NoticeComponent.scss';
3
+ import type { FieldComponent } from '../../core/src/index';
4
+ export type NoticeType = 'info' | 'success' | 'warning' | 'error' | 'banner';
5
+ export type NoticePosition = 'float' | 'notice' | 'banner';
6
+ interface NoticeItem {
7
+ uniqueKey: string;
8
+ dismissStorageKey?: string;
9
+ title?: string;
10
+ message?: string | string[];
11
+ type?: NoticeType;
12
+ position: NoticePosition;
13
+ actionLabel?: string;
14
+ onAction?: () => void;
15
+ expiresAt?: number;
16
+ }
17
+ export declare const NoticeManager: {
18
+ subscribe(cb: (items: NoticeItem[]) => void): () => void;
19
+ add(notice: Omit<NoticeItem, "expiresAt">, validity?: number | "lifetime"): void;
20
+ remove(uniqueKey: string): void;
21
+ clearSession(): void;
22
+ };
23
+ export interface NoticeProps {
24
+ uniqueKey?: string;
25
+ dismissStorageKey?: string;
26
+ title?: string;
27
+ message?: string | string[];
28
+ type?: NoticeType;
29
+ displayPosition?: 'inline' | 'inline-notice' | NoticePosition;
30
+ actionLabel?: string;
31
+ onAction?: () => void;
32
+ validity?: number | 'lifetime';
33
+ /**
34
+ * Extra content rendered as a trailing flex sibling alongside the
35
+ * icon/message (e.g. a caller-owned `BadgeComponent`) — `'inline'`/
36
+ * `'inline-notice'` only, since every other `displayPosition` queues
37
+ * through `NoticeManager` instead of rendering directly here (see the
38
+ * effect below), so there's no real element to attach children to.
39
+ */
40
+ children?: React.ReactNode;
41
+ }
42
+ export declare const NoticeComponent: React.FC<NoticeProps>;
43
+ interface NoticeReceiverProps {
44
+ position: NoticePosition;
45
+ }
46
+ export declare const NoticeReceiverComponent: React.FC<NoticeReceiverProps>;
47
+ declare const NoticeFieldComponent: FieldComponent;
48
+ export default NoticeFieldComponent;
@@ -0,0 +1,28 @@
1
+ import React from 'react';
2
+ import type { FieldComponent } from '../../core/src/index';
3
+ import './PopupComponent.scss';
4
+ export type PopupPosition = 'menu-dropdown' | 'slide-right-to-left' | 'slide-left-to-right' | 'slide-top-to-bottom' | 'slide-bottom-to-top' | 'lightbox';
5
+ export interface PopupHeaderProps {
6
+ icon?: string;
7
+ title?: string;
8
+ description?: string;
9
+ }
10
+ export interface PopupProps {
11
+ position?: PopupPosition;
12
+ open?: boolean;
13
+ toggleIcon?: string;
14
+ tooltipName?: string;
15
+ tooltipPosition?: 'top' | 'bottom' | 'end' | 'start';
16
+ header?: PopupHeaderProps;
17
+ footer?: React.ReactNode;
18
+ width?: number | string;
19
+ height?: number | string;
20
+ className?: string;
21
+ showBackdrop?: boolean;
22
+ onOpen?: () => void;
23
+ onClose?: () => void;
24
+ children?: React.ReactNode;
25
+ }
26
+ export declare const PopupComponent: React.ForwardRefExoticComponent<PopupProps & React.RefAttributes<HTMLDivElement>>;
27
+ declare const PopupFieldComponent: FieldComponent;
28
+ export default PopupFieldComponent;
@@ -0,0 +1,11 @@
1
+ import React from 'react';
2
+ import type { FieldComponent } from '../../core/src/index';
3
+ interface RecaptchaProps {
4
+ formField?: {
5
+ sitekey?: string;
6
+ };
7
+ onChange?: (field: string, value: string | boolean | number | null) => void;
8
+ }
9
+ export declare const RecaptchaComponent: React.FC<RecaptchaProps>;
10
+ declare const RecaptchaFieldComponent: FieldComponent;
11
+ export default RecaptchaFieldComponent;
@@ -0,0 +1,18 @@
1
+ import React from 'react';
2
+ import './SaveStatusComponent.scss';
3
+ export type SaveStatus = 'idle' | 'pending' | 'saving' | 'saved' | 'error';
4
+ export interface SaveStatusLabels {
5
+ idle?: string;
6
+ saving?: string;
7
+ saved?: string;
8
+ error?: string;
9
+ }
10
+ export interface SaveStatusComponentProps {
11
+ /** Where an autosaving form is: `pending`/`saving` show a spinner, `saved` a check, `error` an alert. */
12
+ status: SaveStatus;
13
+ /** Override any of the default (English) texts, e.g. with translated strings. */
14
+ labels?: SaveStatusLabels;
15
+ }
16
+ /** One-line autosave indicator pill. */
17
+ export declare const SaveStatusComponent: React.FC<SaveStatusComponentProps>;
18
+ export default SaveStatusComponent;
@@ -0,0 +1,16 @@
1
+ import React from 'react';
2
+ import './ScoreRingComponent.scss';
3
+ type ScoreRingProps = {
4
+ score: number;
5
+ max?: number;
6
+ /** Diameter, in rem. */
7
+ size?: number;
8
+ strokeWidth?: number;
9
+ /** A shorthand key from the theme palette, or any valid CSS color (e.g. '#2563eb') for a caller-owned per-item color. */
10
+ color?: 'primary' | 'secondary' | 'accent' | 'good' | 'warn' | 'crit' | (string & {});
11
+ /** Text under the score number — defaults to `/ {max}`. */
12
+ label?: React.ReactNode;
13
+ isLoading?: boolean;
14
+ };
15
+ declare const ScoreRingComponent: React.FC<ScoreRingProps>;
16
+ export default ScoreRingComponent;
@@ -0,0 +1,18 @@
1
+ import React from 'react';
2
+ import type { FieldComponent } from '../../core/src/index';
3
+ import './SectionComponent.scss';
4
+ interface SectionProps {
5
+ wrapperClass?: string;
6
+ title?: string;
7
+ /** adminfont icon name shown before the title (e.g. `"settings"` renders `adminfont-settings`). */
8
+ icon?: string;
9
+ desc?: string;
10
+ withoutBorder?: boolean;
11
+ /** Content shown on the right of the title row — typically a button, but anything renderable is fine. */
12
+ rightContent?: React.ReactNode;
13
+ /** Renders a title/description skeleton instead of the real content — for a section heading whose data is still loading. */
14
+ isLoading?: boolean;
15
+ }
16
+ export declare const SectionComponent: React.FC<SectionProps>;
17
+ declare const SectionFieldComponent: FieldComponent;
18
+ export default SectionFieldComponent;
@@ -0,0 +1,134 @@
1
+ import React from 'react';
2
+ import './SettingRowComponent.scss';
3
+ import type { FieldComponent } from '../../core/src/index';
4
+ export interface SettingToggleProps {
5
+ checked: boolean;
6
+ onChange: (checked: boolean) => void;
7
+ /** Text next to the switch. Omit to show "Enabled"/"Disabled" (flips with `checked`); pass `false` to render no label at all. Ignored once `statusLabel` is given. */
8
+ label?: React.ReactNode | false;
9
+ /** A real on/off pair, e.g. `{ on: 'On', off: 'Off' }` — flips with `checked`, same as the `label`-omitted default, but with your own text for each state instead of "Enabled"/"Disabled". Takes priority over `label`. */
10
+ statusLabel?: {
11
+ on: string;
12
+ off: string;
13
+ };
14
+ disabled?: boolean;
15
+ }
16
+ /**
17
+ * A single boolean on/off switch — a `checked`/`onChange` wrapper around
18
+ * `MultiCheckboxInput`'s own `look="toggle"` option-array API (the same
19
+ * pill switch `ModuleGridComponent`'s module activate/deactivate control
20
+ * already renders), for the many places here that just need one real
21
+ * boolean rather than a list of toggle options.
22
+ */
23
+ export declare const SettingToggle: React.FC<SettingToggleProps>;
24
+ /**
25
+ * A declarative right-side control — a toggle, or a select + toggle pair,
26
+ * auto-built from this row's own `valueKey` slice of `SettingRowComponent`'s
27
+ * own `value`/`onChange` (see that component's own docblock), the same way
28
+ * `ExpandablePanelInput`'s own `formFields` derive their `value`/`onChange`
29
+ * from the panel's, instead of each row managing (and separately
30
+ * persisting) its own state.
31
+ */
32
+ export interface SettingRowControl {
33
+ /** Renders a `SettingToggle` bound to `value[row.valueKey].enable`. */
34
+ toggle?: boolean;
35
+ /** `toggle` only — a real on/off pair for the switch's own status text (`SettingToggle`'s own `statusLabel`), e.g. `{ on: 'On', off: 'Off' }`. Omit for the default "Enabled"/"Disabled". */
36
+ toggleStatusLabel?: {
37
+ on: string;
38
+ off: string;
39
+ };
40
+ /** Renders a labelled `SelectInput` next to the toggle, bound to `value[row.valueKey][select.key]`. Disabled while the toggle (when also given) is off. */
41
+ select?: {
42
+ key: string;
43
+ label?: React.ReactNode;
44
+ options: {
45
+ label: string;
46
+ value: string;
47
+ }[];
48
+ };
49
+ /**
50
+ * Renders a plain checkbox bound to array membership — checked when
51
+ * `value` (the whole field's own value, not a per-row slice) is an
52
+ * array containing this row's own `valueKey`; toggling adds/removes
53
+ * `valueKey` from that array. A different value shape than
54
+ * `toggle`/`select` above (which read/write one nested `value[valueKey]`
55
+ * object) — for a field whose rows are a flat multi-select list (e.g.
56
+ * "Security vulnerabilities"/"Malware detected"/... checkboxes sharing
57
+ * one `string[]`), same shape `MultiCheckboxInput`'s own array value
58
+ * already uses. Mutually exclusive with `toggle`/`select` on the same
59
+ * row — a row shouldn't mix the two value shapes.
60
+ */
61
+ checkbox?: boolean;
62
+ }
63
+ export interface SettingRowItem {
64
+ /**
65
+ * This row's own key within `SettingRowComponent`'s `value` object
66
+ * (`{ [valueKey]: { enable?, ...selectKeys } }`). Required whenever
67
+ * `control` is the declarative `SettingRowControl` shape below, rather
68
+ * than a plain node.
69
+ */
70
+ valueKey?: string;
71
+ /** adminfont icon name shown in a tinted box before the title. Omit to render no icon. */
72
+ icon?: string;
73
+ /** A palette color name (`"purple"`, `"green"`, `"red"`, ...) or any real CSS color — same "named palette | any real CSS color" convention `TypographyComponent`'s own `color` prop documents. Defaults to the theme color pair. */
74
+ iconColor?: string;
75
+ title: React.ReactNode;
76
+ desc?: React.ReactNode;
77
+ /**
78
+ * Right-side control. Either a plain `React.ReactNode` — a
79
+ * `SettingToggle`, a `SelectInput`, a plain checkbox, a caller-composed
80
+ * field, or any mix of these, fully self-contained — or the
81
+ * declarative `SettingRowControl` shape (`{ toggle?, select? }`),
82
+ * auto-built from this field's own `value`/`onChange` (see
83
+ * `SettingRowComponent`'s own docblock for why that's the one that
84
+ * should be reached for whenever this row's control needs to persist
85
+ * through the normal settings-save flow). Omit for a row with no
86
+ * control at all.
87
+ */
88
+ control?: React.ReactNode | SettingRowControl;
89
+ className?: string;
90
+ isLoading?: boolean;
91
+ }
92
+ /**
93
+ * `SettingRowComponent`'s own `value`/`onChange` shape for rows using the
94
+ * declarative `control` — either `{ [row.valueKey]: { enable?, ...each
95
+ * row's own `select.key`s } }` (`toggle`/`select` rows) or a flat
96
+ * `string[]` of every checked row's own `valueKey` (`checkbox` rows). A
97
+ * field's own `rows` should be homogeneous — all `toggle`/`select`, or all
98
+ * `checkbox` — since both variants share the one `value`/`onChange` pair.
99
+ */
100
+ export type SettingRowValue = Record<string, Record<string, unknown>> | string[];
101
+ export interface SettingRowProps extends Partial<SettingRowItem> {
102
+ /**
103
+ * Multiple rows — renders one row per entry instead of the single
104
+ * `icon`/`title`/`desc`/`control`/... props above (which are ignored
105
+ * once this is given) — same "one thing directly, or many via an
106
+ * array" duality `BadgeComponent`'s own `text`/`badges` pair already
107
+ * uses. A top-level `isLoading` here overrides every row's own.
108
+ */
109
+ rows?: SettingRowItem[];
110
+ /**
111
+ * The whole row list's own value, keyed by each row's `valueKey` —
112
+ * only read for rows whose `control` is the declarative
113
+ * `SettingRowControl` shape; ignored otherwise. Wired straight through
114
+ * from `SettingRowFieldComponent`'s own `value`/`onChange` (the
115
+ * `type: 'setting-row'` field type — see `packages/builders/src/Utils/
116
+ * fieldUtils.ts`), so persisting a row's toggle/select/checkbox goes
117
+ * through `InputRenderer`'s normal auto-save path — no bespoke
118
+ * `useSetting()`+`sendApiResponse()` component needed per row.
119
+ */
120
+ value?: SettingRowValue;
121
+ onChange?: (value: SettingRowValue) => void;
122
+ }
123
+ /**
124
+ * One "icon + title + description, control on the right" settings row —
125
+ * the atomic unit repeated throughout an alert/automation settings panel
126
+ * (e.g. "Cooldown" + a duration input, "Security vulnerabilities" + a
127
+ * checkbox, "AI crawler blocked" + a frequency select and a toggle). Pass
128
+ * the single-row props directly for one row, or `rows` for a whole list in
129
+ * one call. Meant to be stacked in a list inside a caller-owned card
130
+ * wrapper.
131
+ */
132
+ export declare const SettingRowComponent: React.FC<SettingRowProps>;
133
+ declare const SettingRowFieldComponent: FieldComponent;
134
+ export default SettingRowFieldComponent;
@@ -0,0 +1,24 @@
1
+ import React from 'react';
2
+ import './SettingsSectionComponent.scss';
3
+ export declare const SettingsPanelComponent: React.FC<{
4
+ children: React.ReactNode;
5
+ className?: string;
6
+ }>;
7
+ export interface SettingsSectionComponentProps {
8
+ icon?: string;
9
+ title?: string;
10
+ desc?: React.ReactNode;
11
+ action?: React.ReactNode;
12
+ leftContent?: React.ReactNode;
13
+ className?: string;
14
+ children: React.ReactNode;
15
+ }
16
+ export declare const SettingsSectionComponent: React.FC<SettingsSectionComponentProps>;
17
+ export declare const SettingsFieldComponent: React.FC<{
18
+ label?: string;
19
+ desc?: React.ReactNode;
20
+ children: React.ReactNode;
21
+ }>;
22
+ export declare const SettingsWideComponent: React.FC<{
23
+ children: React.ReactNode;
24
+ }>;
@@ -0,0 +1,75 @@
1
+ import React from 'react';
2
+ import './SetupWizardComponent.scss';
3
+ export interface SetupWizardStep {
4
+ key: string;
5
+ label: string;
6
+ /** Small grey line under the label in the step rail — e.g. "Optional". */
7
+ hint?: string;
8
+ }
9
+ export interface SetupWizardComponentProps {
10
+ brandName: string;
11
+ brandMark?: React.ReactNode;
12
+ railTitle?: string;
13
+ railFooter?: React.ReactNode;
14
+ steps: SetupWizardStep[];
15
+ currentStep: string;
16
+ title: React.ReactNode;
17
+ description?: React.ReactNode;
18
+ successIcon?: string;
19
+ children?: React.ReactNode;
20
+ actions?: React.ReactNode;
21
+ isLoading?: boolean;
22
+ hideSteps?: boolean;
23
+ className?: string;
24
+ }
25
+ export declare const SetupWizardComponent: React.FC<SetupWizardComponentProps>;
26
+ export type SetupWizardSectionProps = {
27
+ title?: React.ReactNode;
28
+ children: React.ReactNode;
29
+ };
30
+ export declare const SetupWizardSection: React.FC<SetupWizardSectionProps>;
31
+ export type SetupWizardFieldProps = {
32
+ label: React.ReactNode;
33
+ htmlFor?: string;
34
+ children: React.ReactNode;
35
+ };
36
+ export declare const SetupWizardField: React.FC<SetupWizardFieldProps>;
37
+ export declare const SetupWizardRow: React.FC<{
38
+ children: React.ReactNode;
39
+ }>;
40
+ export type SetupWizardActionsGroupProps = {
41
+ children: React.ReactNode;
42
+ };
43
+ export declare const SetupWizardActionsGroup: React.FC<SetupWizardActionsGroupProps>;
44
+ export type SetupCheckStatus = 'ok' | 'warn' | 'fail';
45
+ export interface SetupCheckItem {
46
+ name: string;
47
+ detail: React.ReactNode;
48
+ status: SetupCheckStatus;
49
+ }
50
+ export interface SetupChecksComponentProps {
51
+ checks: SetupCheckItem[];
52
+ statusLabels?: Partial<Record<SetupCheckStatus, string>>;
53
+ }
54
+ export declare const SetupChecksComponent: React.FC<SetupChecksComponentProps>;
55
+ export interface SetupSummaryRow {
56
+ /** adminfont icon name for the tinted tile. */
57
+ icon: string;
58
+ label: string;
59
+ value: React.ReactNode;
60
+ }
61
+ export interface SetupSummaryComponentProps {
62
+ rows: SetupSummaryRow[];
63
+ }
64
+ /** A bordered icon / label / value list — the "Review and save" step. */
65
+ export declare const SetupSummaryComponent: React.FC<SetupSummaryComponentProps>;
66
+ export interface SetupOverviewItem {
67
+ icon: string;
68
+ title: React.ReactNode;
69
+ desc: React.ReactNode;
70
+ }
71
+ /** A vertical list of icon + title + description rows — the welcome step's "what happens next". */
72
+ export declare const SetupOverviewComponent: React.FC<{
73
+ items: SetupOverviewItem[];
74
+ }>;
75
+ export default SetupWizardComponent;
@@ -0,0 +1,11 @@
1
+ import React from 'react';
2
+ import './SkeletonComponent.scss';
3
+ type SkeletonVariant = 'text' | 'circular' | 'rectangular';
4
+ interface SkeletonProps {
5
+ variant?: SkeletonVariant;
6
+ width?: number | string;
7
+ height?: number | string;
8
+ className?: string;
9
+ }
10
+ declare const SkeletonComponent: React.FC<SkeletonProps>;
11
+ export default SkeletonComponent;
@@ -0,0 +1,11 @@
1
+ import React from 'react';
2
+ import './SystemInfoComponent.scss';
3
+ import { FieldComponent } from '../../core/src/index';
4
+ interface SystemInfoProps {
5
+ apiLink: string;
6
+ copyButtonLabel?: string;
7
+ copiedLabel?: string;
8
+ }
9
+ export declare const SystemInfoComponent: React.FC<SystemInfoProps>;
10
+ declare const SystemInfoFieldComponent: FieldComponent;
11
+ export default SystemInfoFieldComponent;
@@ -0,0 +1,34 @@
1
+ import React from 'react';
2
+ import { FieldComponent } from '../../core/src/index';
3
+ interface TabFooter {
4
+ url: string;
5
+ icon?: string;
6
+ text: string;
7
+ }
8
+ interface Tab {
9
+ label: string;
10
+ content?: React.ReactNode;
11
+ icon?: string;
12
+ footer?: TabFooter;
13
+ type?: string;
14
+ value?: any;
15
+ key?: string;
16
+ }
17
+ interface TabsProps {
18
+ tabs: Tab[];
19
+ className?: string;
20
+ defaultActiveIndex?: number;
21
+ /** Controls which tab is shown from outside (e.g. a sibling "View all" link jumping to a specific tab). Omit for the default uncontrolled behavior. */
22
+ activeIndex?: number;
23
+ /** Fires on every tab click, controlled mode or not — required alongside `activeIndex` to actually move it. */
24
+ onTabChange?: (index: number) => void;
25
+ value?: any;
26
+ onChange?: (value: any) => void;
27
+ canAccess?: (capability: string) => boolean;
28
+ headerExtra?: React.ReactNode;
29
+ modules?: string[];
30
+ onBlocked?: (type: 'pro' | 'plugin' | 'module', payload?: {}) => void;
31
+ }
32
+ export declare const TabsComponent: React.FC<TabsProps>;
33
+ declare const TabsFieldComponent: FieldComponent;
34
+ export default TabsFieldComponent;
@@ -0,0 +1,19 @@
1
+ import React from 'react';
2
+ import './ThemeChoiceComponent.scss';
3
+ export type ThemeChoiceSwatch = 'light' | 'dark' | 'system';
4
+ export interface ThemeChoiceOption {
5
+ value: string;
6
+ label: string;
7
+ hint?: string;
8
+ swatch: ThemeChoiceSwatch;
9
+ }
10
+ export interface ThemeChoiceComponentProps {
11
+ legend: string;
12
+ name?: string;
13
+ options: ThemeChoiceOption[];
14
+ value: string;
15
+ onChange: (value: string) => void;
16
+ className?: string;
17
+ }
18
+ export declare const ThemeChoiceComponent: React.FC<ThemeChoiceComponentProps>;
19
+ export default ThemeChoiceComponent;
@@ -0,0 +1,12 @@
1
+ import React from 'react';
2
+ import './TooltipComponent.scss';
3
+ export type TooltipPosition = 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
4
+ interface TooltipProps {
5
+ text: string;
6
+ children: React.ReactNode;
7
+ position?: TooltipPosition;
8
+ withOutArrow?: boolean;
9
+ className?: string;
10
+ }
11
+ declare const TooltipComponent: React.FC<TooltipProps>;
12
+ export default TooltipComponent;
@@ -0,0 +1,26 @@
1
+ import React from 'react';
2
+ import { ProviderProps, StepType } from '@reactour/tour';
3
+ interface GuidedTourStep extends StepType {
4
+ title: string;
5
+ description: string;
6
+ next?: {
7
+ link: string;
8
+ step: number;
9
+ };
10
+ finish?: boolean;
11
+ }
12
+ interface TourLabels {
13
+ endTour?: string;
14
+ next?: string;
15
+ finishTour?: string;
16
+ }
17
+ interface GuidedTourProviderProps extends Omit<ProviderProps, 'steps'> {
18
+ steps: GuidedTourStep[];
19
+ storeId?: number;
20
+ labels?: TourLabels;
21
+ }
22
+ /**
23
+ * Provider wrapper
24
+ */
25
+ declare const TourComponent: React.FC<GuidedTourProviderProps>;
26
+ export default TourComponent;
@@ -0,0 +1,21 @@
1
+ import React from 'react';
2
+ import './TrendIndicatorComponent.scss';
3
+ type TrendIndicatorProps = {
4
+ /** Positive/zero renders a green up arrow, negative a red down arrow. */
5
+ value: number;
6
+ /** Appended after the formatted number, e.g. '%' or ' this week'. */
7
+ suffix?: string;
8
+ /** How many digits after the decimal point to show. */
9
+ decimals?: number;
10
+ size?: 'small' | 'default';
11
+ isLoading?: boolean;
12
+ };
13
+ /**
14
+ * A signed delta as an up/down arrow + colored value — e.g. a score card's
15
+ * "+6%" / "-3%" week-over-week trend. One shared component so every card
16
+ * that needs this renders the same arrow, color, and formatting instead of
17
+ * each consumer re-implementing its own admin-badge + adminfont-arrow-*
18
+ * markup.
19
+ */
20
+ declare const TrendIndicatorComponent: React.FC<TrendIndicatorProps>;
21
+ export default TrendIndicatorComponent;
@@ -0,0 +1,34 @@
1
+ import React from 'react';
2
+ import './TrendStatComponent.scss';
3
+ interface TrendStatItem {
4
+ icon: string;
5
+ label: React.ReactNode;
6
+ /** The tile's headline — a number ("12,458") or a status word ("Good"). */
7
+ value: React.ReactNode;
8
+ badge?: {
9
+ text: React.ReactNode;
10
+ color?: string;
11
+ };
12
+ /** Small muted line under the value, e.g. "12 the 30 days before". */
13
+ caption?: React.ReactNode;
14
+ /** Sparkline stroke color — any valid CSS color. */
15
+ color?: string;
16
+ /** Omit to render the tile without a sparkline. */
17
+ chartData?: Record<string, number | string>[];
18
+ chartDataKey?: string;
19
+ }
20
+ interface TrendStatProps {
21
+ items: TrendStatItem[];
22
+ cols?: number;
23
+ isLoading?: boolean;
24
+ }
25
+ /**
26
+ * A row of stat tiles — icon+label, a headline value, an optional trend
27
+ * badge, and an optional sparkline underneath. Same array-of-items shape
28
+ * as `AnalyticsComponent`, but that component's icon-beside-text layout
29
+ * has nowhere for a full-width sparkline to live, so this is a sibling
30
+ * rather than another `AnalyticsComponent` variant.
31
+ */
32
+ declare const TrendStatComponent: React.FC<TrendStatProps>;
33
+ export type { TrendStatItem, TrendStatProps };
34
+ export default TrendStatComponent;