@chenyqthu/omada-ui-kit 0.0.0-stage → 0.1.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 (91) hide show
  1. package/README.md +88 -2
  2. package/dist/catalog.json +13396 -0
  3. package/dist/index.js +22452 -0
  4. package/dist/standalone.js +2490 -0
  5. package/dist/style.css +2 -0
  6. package/dist/types/lib/index.d.ts +1 -0
  7. package/dist/types/lib/standalone.d.ts +10 -0
  8. package/dist/types/omada/assets/SBrandAsset.d.ts +17 -0
  9. package/dist/types/omada/assets/SClientIcon.d.ts +16 -0
  10. package/dist/types/omada/assets/SIcon.d.ts +21 -0
  11. package/dist/types/omada/assets/SIllustration.d.ts +22 -0
  12. package/dist/types/omada/assets/SProductImage.d.ts +20 -0
  13. package/dist/types/omada/assets/ThemedAssetImage.d.ts +26 -0
  14. package/dist/types/omada/assets/assetsManifest.d.ts +19 -0
  15. package/dist/types/omada/assets/iconsManifest.d.ts +15 -0
  16. package/dist/types/omada/components/SAlert.d.ts +34 -0
  17. package/dist/types/omada/components/SAnchor.d.ts +32 -0
  18. package/dist/types/omada/components/SApDistributionRuler.d.ts +32 -0
  19. package/dist/types/omada/components/SAvatar.d.ts +28 -0
  20. package/dist/types/omada/components/SBadge.d.ts +17 -0
  21. package/dist/types/omada/components/SBreadcrumb.d.ts +36 -0
  22. package/dist/types/omada/components/SButton.d.ts +11 -0
  23. package/dist/types/omada/components/SCard.d.ts +28 -0
  24. package/dist/types/omada/components/SCascader.d.ts +20 -0
  25. package/dist/types/omada/components/SCategoryKpiCarousel.d.ts +26 -0
  26. package/dist/types/omada/components/SChannelUtilization.d.ts +25 -0
  27. package/dist/types/omada/components/SChart.d.ts +135 -0
  28. package/dist/types/omada/components/SCheckbox.d.ts +41 -0
  29. package/dist/types/omada/components/SClientOverviewStrip.d.ts +29 -0
  30. package/dist/types/omada/components/SCollapse.d.ts +28 -0
  31. package/dist/types/omada/components/SColorPicker.d.ts +17 -0
  32. package/dist/types/omada/components/SDatePicker.d.ts +57 -0
  33. package/dist/types/omada/components/SDescriptions.d.ts +21 -0
  34. package/dist/types/omada/components/SDeviceHealthSummary.d.ts +34 -0
  35. package/dist/types/omada/components/SDevicePortGraphic.d.ts +90 -0
  36. package/dist/types/omada/components/SDeviceStatus.d.ts +11 -0
  37. package/dist/types/omada/components/SDivider.d.ts +26 -0
  38. package/dist/types/omada/components/SDonutSummaryCard.d.ts +60 -0
  39. package/dist/types/omada/components/SDrawer.d.ts +36 -0
  40. package/dist/types/omada/components/SDropdown.d.ts +36 -0
  41. package/dist/types/omada/components/SEmpty.d.ts +17 -0
  42. package/dist/types/omada/components/SForm.d.ts +56 -0
  43. package/dist/types/omada/components/SHealthGauge.d.ts +43 -0
  44. package/dist/types/omada/components/SHealthTrendBar.d.ts +21 -0
  45. package/dist/types/omada/components/SInput.d.ts +47 -0
  46. package/dist/types/omada/components/SIpInput.d.ts +36 -0
  47. package/dist/types/omada/components/SLoading.d.ts +66 -0
  48. package/dist/types/omada/components/SMacInput.d.ts +26 -0
  49. package/dist/types/omada/components/SModal.d.ts +121 -0
  50. package/dist/types/omada/components/SNotification.d.ts +60 -0
  51. package/dist/types/omada/components/SPagination.d.ts +23 -0
  52. package/dist/types/omada/components/SPopover.d.ts +27 -0
  53. package/dist/types/omada/components/SPortPanel.d.ts +28 -0
  54. package/dist/types/omada/components/SProgress.d.ts +32 -0
  55. package/dist/types/omada/components/SRadio.d.ts +40 -0
  56. package/dist/types/omada/components/SRate.d.ts +20 -0
  57. package/dist/types/omada/components/SSchedule.d.ts +55 -0
  58. package/dist/types/omada/components/SSelect.d.ts +25 -0
  59. package/dist/types/omada/components/SSettingsPageShell.d.ts +104 -0
  60. package/dist/types/omada/components/SSlider.d.ts +31 -0
  61. package/dist/types/omada/components/SSteps.d.ts +41 -0
  62. package/dist/types/omada/components/SSwitch.d.ts +23 -0
  63. package/dist/types/omada/components/STable.d.ts +81 -0
  64. package/dist/types/omada/components/STabs.d.ts +27 -0
  65. package/dist/types/omada/components/STag.d.ts +23 -0
  66. package/dist/types/omada/components/STerminalConsole.d.ts +57 -0
  67. package/dist/types/omada/components/STile.d.ts +66 -0
  68. package/dist/types/omada/components/STimePicker.d.ts +16 -0
  69. package/dist/types/omada/components/STooltip.d.ts +34 -0
  70. package/dist/types/omada/components/STopologyCanvas.d.ts +66 -0
  71. package/dist/types/omada/components/STransfer.d.ts +34 -0
  72. package/dist/types/omada/components/STreeSelect.d.ts +24 -0
  73. package/dist/types/omada/components/SUpload.d.ts +58 -0
  74. package/dist/types/omada/icons/OmadaLogo.d.ts +20 -0
  75. package/dist/types/omada/index.d.ts +38 -0
  76. package/dist/types/omada/layout/SAppShell.d.ts +84 -0
  77. package/dist/types/omada/layout/SEmulatorShell.d.ts +80 -0
  78. package/dist/types/omada/layout/SPageHeader.d.ts +13 -0
  79. package/dist/types/omada/modules/data-charts.d.ts +8 -0
  80. package/dist/types/omada/modules/emulator-v6.d.ts +13 -0
  81. package/dist/types/omada/modules/feedback-overlays.d.ts +7 -0
  82. package/dist/types/omada/modules/nav-shell.d.ts +6 -0
  83. package/dist/types/omada/modules/select-inputs.d.ts +8 -0
  84. package/dist/types/omada/modules/time-schedule.d.ts +5 -0
  85. package/dist/types/omada/theme/OmadaProvider.d.ts +22 -0
  86. package/dist/types/omada/theme/antdTheme.d.ts +6 -0
  87. package/dist/types/omada/theme/tokens.d.ts +138 -0
  88. package/package.json +76 -4
  89. package/skills/omada-ui-kit/SKILL.md +170 -0
  90. package/skills/omada-ui-kit/references/catalog.json +13396 -0
  91. package/skills/omada-ui-kit/scripts/query-catalog.mjs +202 -0
@@ -0,0 +1,104 @@
1
+ import React from 'react';
2
+ export interface SSettingsTabItem {
3
+ key: string;
4
+ label: React.ReactNode;
5
+ disabled?: boolean;
6
+ }
7
+ export interface SSettingsPageShellProps {
8
+ /** Optional 20px page heading (omitted on tab-first pages like LAN). */
9
+ title?: React.ReactNode;
10
+ /** Optional top-right circular green `(?)` Help icon (defaults to `true`). */
11
+ showHelp?: boolean;
12
+ /** Heading inside the Help popover when `(?)` is clicked. */
13
+ helpTitle?: React.ReactNode;
14
+ /** Body description inside the Help popover when `(?)` is clicked. */
15
+ helpDescription?: React.ReactNode;
16
+ /** Optional click callback overriding default Help popover behavior. */
17
+ onHelpClick?: () => void;
18
+ /** Extra controls placed left of the `(?)` Help button in the header bar. */
19
+ headerExtra?: React.ReactNode;
20
+ /** Optional underline sub-tabs (`18px` Omada tab bar). */
21
+ tabs?: SSettingsTabItem[];
22
+ /** Controlled active tab key. */
23
+ activeTab?: string;
24
+ /** Initial uncontrolled active tab key. */
25
+ defaultActiveTab?: string;
26
+ /** Invoked when an underline sub-tab is clicked. */
27
+ onTabChange?: (key: string) => void;
28
+ /** Accessible `aria-label` for the underline sub-tabs tablist. */
29
+ tabAriaLabel?: string;
30
+ /** Shows the sticky bottom `Apply` / `Cancel` bar when `true`. */
31
+ dirty?: boolean;
32
+ /** Callback invoked when the sticky `Apply` button is clicked. */
33
+ onApply?: () => void;
34
+ /** Callback invoked when the sticky `Cancel` button is clicked. */
35
+ onCancel?: () => void;
36
+ /** Custom primary action label (defaults to `'Apply'`). */
37
+ applyText?: string;
38
+ /** Custom secondary action label (defaults to `'Cancel'`). */
39
+ cancelText?: string;
40
+ /** Loading state for the sticky `Apply` button. */
41
+ applying?: boolean;
42
+ /** Disables the sticky `Apply` button while keeping `Cancel` active. */
43
+ applyDisabled?: boolean;
44
+ /** Optional auxiliary content shown on the right of the sticky footer bar. */
45
+ footerExtra?: React.ReactNode;
46
+ /** Optional data-testid applied to the root shell container. */
47
+ 'data-testid'?: string;
48
+ className?: string;
49
+ children: React.ReactNode;
50
+ }
51
+ /**
52
+ * Reusable Omada Controller v6.3 configuration page container providing:
53
+ * - `20px` title header + optional top-right circular green `(?)` Help trigger
54
+ * - Optional `18px` underline sub-tab bar
55
+ * - Clean borderless content workspace + optional dirty-state sticky `Apply` / `Cancel` footer bar
56
+ */
57
+ export declare const SSettingsPageShell: React.FC<SSettingsPageShellProps>;
58
+ export interface SSettingsSectionProps {
59
+ /** Section title (`16px` medium weight). */
60
+ title: React.ReactNode;
61
+ /** Optional muted subtitle rendered below the section title. */
62
+ description?: React.ReactNode;
63
+ /** Optional right-aligned header action slot. */
64
+ extra?: React.ReactNode;
65
+ /** Renders a hairline horizontal divider above this section. */
66
+ dividerTop?: boolean;
67
+ className?: string;
68
+ children: React.ReactNode;
69
+ }
70
+ /**
71
+ * Borderless Omada settings section block with optional hairline top divider and `16px` title.
72
+ */
73
+ export declare const SSettingsSection: React.FC<SSettingsSectionProps>;
74
+ export interface SSettingsRowProps {
75
+ /** Left column label (`210px` default width). */
76
+ label: React.ReactNode;
77
+ /** Optional tooltip shown via inline `(i)` icon next to the label. */
78
+ tooltip?: React.ReactNode;
79
+ /** Width of left label column in px (defaults to `210`). */
80
+ labelWidth?: number;
81
+ /** Width constraint for the control column (`350` default, or `'auto' | 'full'`). */
82
+ controlWidth?: number | 'auto' | 'full';
83
+ /** Optional muted helper description rendered directly below the control. */
84
+ hint?: React.ReactNode;
85
+ /** Optional trailing text or element rendered immediately right of the control box. */
86
+ after?: React.ReactNode;
87
+ /** Vertical alignment of label relative to control (`'center'` or `'start'`). */
88
+ align?: 'center' | 'start';
89
+ className?: string;
90
+ children: React.ReactNode;
91
+ }
92
+ /**
93
+ * Horizontal Omada settings field row (`210px` left label / `350px` right filled control).
94
+ */
95
+ export declare const SSettingsRow: React.FC<SSettingsRowProps>;
96
+ export interface SSettingsInfoBannerProps {
97
+ /** Numbered or rich informational items displayed inside the soft blue banner. */
98
+ children: React.ReactNode;
99
+ className?: string;
100
+ }
101
+ /**
102
+ * Soft blue `#F0F5FA` (Light) / `#1D2939` (Dark) informational banner for Omada settings pages.
103
+ */
104
+ export declare const SSettingsInfoBanner: React.FC<SSettingsInfoBannerProps>;
@@ -0,0 +1,31 @@
1
+ import React from 'react';
2
+ import type { SliderRangeProps, SliderRef, SliderSingleProps } from 'antd/es/slider';
3
+ export type SSliderPreset = 'default' | 'color-temp' | 'hue' | 'brightness';
4
+ export type SSliderHandleVariant = 'ring' | 'solid';
5
+ export type SSliderStepPreset = 'levels' | '1-3' | '1-5' | '1-10' | '0-5' | '0-10';
6
+ export interface SSliderExtraProps {
7
+ /** Renders paired filled `SNumberInput` field(s) synced with the slider and clamped on blur. */
8
+ showInput?: boolean;
9
+ /** Track color/gradient preset (`'default'` brand green, `'color-temp'`, `'hue'`, `'brightness'`). */
10
+ preset?: SSliderPreset;
11
+ /** Handle visual variant (`'ring'` bordered thumb vs `'solid'` filled thumb). */
12
+ handleVariant?: SSliderHandleVariant;
13
+ /** Renders vertical segmented tick bars on stepped sliders. */
14
+ segmented?: boolean;
15
+ /** Built-in Figma stepped mark presets (`'levels'`, `'1-3'`, `'1-5'`, `'1-10'`, `'0-5'`, `'0-10'`). */
16
+ stepPreset?: SSliderStepPreset;
17
+ /** Optional unit label appended in tooltips and paired inputs (e.g. `'K'`, `'%'`, `'dBm'`). */
18
+ unit?: string;
19
+ /** Optional leading icon rendered to the left of the slider track. */
20
+ startIcon?: React.ReactNode;
21
+ /** Optional trailing icon rendered to the right of the slider track. */
22
+ endIcon?: React.ReactNode;
23
+ /** Ref forwarded to the underlying AntD 6 Slider instance. */
24
+ ref?: React.Ref<SliderRef>;
25
+ }
26
+ export type SSliderProps = (SliderSingleProps | SliderRangeProps) & SSliderExtraProps;
27
+ /**
28
+ * Omada Slider supporting single, range, stepped `marks`/`stepPreset`,
29
+ * paired `showInput` numeric fields with blur clamping, and `color-temp` / `hue` / `brightness` presets.
30
+ */
31
+ export declare const SSlider: React.FC<SSliderProps>;
@@ -0,0 +1,41 @@
1
+ import React from 'react';
2
+ import { type StepsProps } from 'antd';
3
+ export type SStepsOrientation = 'horizontal' | 'vertical';
4
+ export type SStepsType = 'default' | 'navigation' | 'inline' | 'dot';
5
+ export type SStepsSize = 'small' | 'medium';
6
+ export interface SStepItem {
7
+ key?: React.Key;
8
+ title?: React.ReactNode;
9
+ subTitle?: React.ReactNode;
10
+ /** Primary step helper text (mapped directly to AntD 6 `content`). */
11
+ content?: React.ReactNode;
12
+ /** Convenience alias mapped cleanly to AntD 6 `content` without deprecation warnings. */
13
+ description?: React.ReactNode;
14
+ icon?: React.ReactNode;
15
+ status?: 'wait' | 'process' | 'finish' | 'error';
16
+ disabled?: boolean;
17
+ /** Renders a spinner inside the step icon when the step is actively running. */
18
+ loading?: boolean;
19
+ onClick?: React.MouseEventHandler<HTMLElement>;
20
+ className?: string;
21
+ style?: React.CSSProperties;
22
+ }
23
+ export interface SStepsProps extends Omit<StepsProps, 'direction' | 'labelPlacement' | 'progressDot' | 'size' | 'items' | 'type'> {
24
+ /** Step definitions rendered in sequence. */
25
+ items: SStepItem[];
26
+ /** Layout orientation (AntD 6 `orientation`; defaults to `'horizontal'`). */
27
+ orientation?: SStepsOrientation;
28
+ /** Visual style (`default`, `navigation`, `inline`, or `dot`). */
29
+ type?: SStepsType;
30
+ /** Title/content placement relative to icon (`horizontal` or `vertical`). */
31
+ titlePlacement?: 'horizontal' | 'vertical';
32
+ /** Step size (`small` or `medium`; never passes deprecated `size="default"`). */
33
+ size?: SStepsSize;
34
+ /** Displays a spinning loader on the active (`current`) step item. */
35
+ loading?: boolean;
36
+ }
37
+ /**
38
+ * Omada Steps (`3:64441`) supporting horizontal, vertical, navigation, dot, and loading states
39
+ * using AntD 6 `orientation`, `titlePlacement`, and `content` APIs.
40
+ */
41
+ export declare const SSteps: React.FC<SStepsProps>;
@@ -0,0 +1,23 @@
1
+ import React from 'react';
2
+ import { type SwitchProps } from 'antd';
3
+ export interface SSwitchProps extends Omit<SwitchProps, 'size'> {
4
+ /** Switch track geometry (`medium`: 36×22px default, `small`: 28×16px). */
5
+ size?: 'small' | 'medium';
6
+ /** Optional primary label rendered alongside the switch. */
7
+ label?: React.ReactNode;
8
+ /** Optional explanatory copy rendered beneath `label`. */
9
+ description?: React.ReactNode;
10
+ /** Companion text alignment relative to the switch (`horizontal` or `vertical`). */
11
+ layout?: 'horizontal' | 'vertical';
12
+ /** Placement of the companion text relative to the switch in horizontal mode. */
13
+ labelPlacement?: 'end' | 'start';
14
+ /** Spacing between the switch and companion label (`sm`: 4px, `md`: 8px, `lg`: 12px). */
15
+ gap?: 'sm' | 'md' | 'lg';
16
+ /** Ref forwarded to the underlying AntD 6 Switch button element. */
17
+ ref?: React.Ref<HTMLButtonElement>;
18
+ }
19
+ /**
20
+ * Omada Switch matching the exact `36×22px` (`medium`) and `28×16px` (`small`) pill geometry,
21
+ * with optional companion `label` and `description` in horizontal or vertical layouts.
22
+ */
23
+ export declare const SSwitch: React.FC<SSwitchProps>;
@@ -0,0 +1,81 @@
1
+ import React from 'react';
2
+ import { type TablePaginationConfig, type TableProps } from 'antd';
3
+ export type STableDensity = 'compact' | 'default';
4
+ export interface STableColumnSettingItem {
5
+ key: string;
6
+ label: React.ReactNode;
7
+ visible: boolean;
8
+ disabled?: boolean;
9
+ }
10
+ export interface STableToolbarProps {
11
+ tabs?: React.ReactNode;
12
+ searchPlaceholder?: string;
13
+ searchValue?: string;
14
+ onSearchChange?: (value: string) => void;
15
+ filters?: React.ReactNode;
16
+ actions?: React.ReactNode;
17
+ selectedCount?: number;
18
+ batchActions?: React.ReactNode;
19
+ onClearSelection?: () => void;
20
+ }
21
+ export interface STableProps<T extends object> extends Omit<TableProps<T>, 'pagination'> {
22
+ toolbar?: STableToolbarProps;
23
+ pagination?: false | TablePaginationConfig;
24
+ /** Show a column visibility checklist popover button in the toolbar. */
25
+ columnSettings?: boolean;
26
+ /** Show a `'default' | 'compact'` row density switcher in the toolbar. */
27
+ densityToggle?: boolean;
28
+ /** Controlled table density (`'default' | 'compact'`). */
29
+ density?: STableDensity;
30
+ /** Initial uncontrolled density when `densityToggle` is enabled. */
31
+ defaultDensity?: STableDensity;
32
+ /** Callback invoked when density changes via `densityToggle`. */
33
+ onDensityChange?: (density: STableDensity) => void;
34
+ }
35
+ /**
36
+ * Omada Data Table wrapping AntD `Table` with an integrated toolbar (tabs, search,
37
+ * filters, column settings popover, density toggle, slide-in batch action bar),
38
+ * expandable row styling, and Omada's `Showing X-Y of Z records` footer.
39
+ */
40
+ export declare function STable<T extends object>({ toolbar, pagination, dataSource, columns, expandable, components, columnSettings, densityToggle, density, defaultDensity, onDensityChange, size, className, ...rest }: STableProps<T>): React.JSX.Element;
41
+ export interface SEditableCellOption {
42
+ label: React.ReactNode;
43
+ value: string | number;
44
+ }
45
+ export interface SEditableCellProps<V extends string | number = string> {
46
+ /** Current committed cell value (or live value in controlled batch mode). */
47
+ value: V;
48
+ /** Invoked when the user commits an edit in single-cell mode (Enter, Save button, or blur). */
49
+ onSave?: (nextValue: V) => void | Promise<void>;
50
+ /** Immediate change callback for controlled / batch row editing. */
51
+ onChange?: (nextValue: V) => void;
52
+ /** Controlled editing state (set `true` on all cells in a row for batch editing). */
53
+ editing?: boolean;
54
+ /** Initial uncontrolled editing state. */
55
+ defaultEditing?: boolean;
56
+ /** Notifies when single-cell editing starts or exits. */
57
+ onEditingChange?: (editing: boolean) => void;
58
+ /** Input control variant rendered during edit mode. */
59
+ type?: 'text' | 'number' | 'select';
60
+ /** Select options when `type="select"`. */
61
+ options?: SEditableCellOption[];
62
+ placeholder?: string;
63
+ disabled?: boolean;
64
+ /** Render explicit Save / Cancel icon buttons next to the input (defaults to `true` when `editing` is uncontrolled). */
65
+ showActions?: boolean;
66
+ /** Commit on blur instead of requiring explicit Enter / Save click. */
67
+ saveOnBlur?: boolean;
68
+ /** Optional synchronous validator returning an error message string. */
69
+ validate?: (value: V) => string | null | undefined;
70
+ /** Custom display renderer when not editing. */
71
+ renderDisplay?: (value: V) => React.ReactNode;
72
+ /** Optional width constraint for the inline editor (e.g. `254`). */
73
+ inputWidth?: number | string;
74
+ ariaLabel?: string;
75
+ className?: string;
76
+ }
77
+ /**
78
+ * Compact `28px`-high inline editable table cell supporting both single-cell click-to-edit
79
+ * (Enter/Save/Cancel) and controlled `editing` mode for batch row editing.
80
+ */
81
+ export declare function SEditableCell<V extends string | number = string>({ value, onSave, onChange, editing, defaultEditing, onEditingChange, type, options, placeholder, disabled, showActions, saveOnBlur, validate, renderDisplay, inputWidth, ariaLabel, className, }: SEditableCellProps<V>): React.JSX.Element;
@@ -0,0 +1,27 @@
1
+ import React from 'react';
2
+ export type STabsVariant = 'line' | 'capsule' | 'segment';
3
+ export interface STabItem {
4
+ key: string;
5
+ label: React.ReactNode;
6
+ icon?: React.ReactNode;
7
+ dotColor?: string;
8
+ disabled?: boolean;
9
+ children?: React.ReactNode;
10
+ }
11
+ export interface STabsProps {
12
+ items: STabItem[];
13
+ activeKey?: string;
14
+ defaultActiveKey?: string;
15
+ onChange?: (key: string) => void;
16
+ variant?: STabsVariant;
17
+ pill?: boolean;
18
+ extra?: React.ReactNode;
19
+ className?: string;
20
+ }
21
+ /**
22
+ * Omada Tabs supporting:
23
+ * - `line`: primary page navigation underline tabs (`34px` height, `#00A870` indicator)
24
+ * - `capsule`: Omada green active capsule tabs (or `pill` rounded-full)
25
+ * - `segment`: neutral surface segmented switcher with optional legend dot
26
+ */
27
+ export declare const STabs: React.FC<STabsProps>;
@@ -0,0 +1,23 @@
1
+ import React from 'react';
2
+ export type STagColor = 'green' | 'orange' | 'blue' | 'red' | 'magenta' | 'purple' | 'grey';
3
+ export interface STagProps {
4
+ color?: STagColor;
5
+ variant?: 'subtle' | 'solid';
6
+ children: React.ReactNode;
7
+ className?: string;
8
+ }
9
+ /**
10
+ * Omada status/category tag (`20px` height, `3px` radius, `subtle` or `solid` fill).
11
+ */
12
+ export declare const STag: React.FC<STagProps>;
13
+ export interface SCustomTagProps {
14
+ children: React.ReactNode;
15
+ closable?: boolean;
16
+ onClose?: () => void;
17
+ onClick?: () => void;
18
+ className?: string;
19
+ }
20
+ /**
21
+ * 24px neutral tag for multi-select values and editable tag lists.
22
+ */
23
+ export declare const SCustomTag: React.FC<SCustomTagProps>;
@@ -0,0 +1,57 @@
1
+ import React from 'react';
2
+ export interface STerminalSessionItem {
3
+ /** Unique identifier for the session or diagnostic output entry. */
4
+ key: string;
5
+ /** Device name displayed in the `Device List` rail (e.g. `COOOffice_Eap_1`). */
6
+ deviceName: string;
7
+ /** Optional subtitle such as IP address or model displayed in the terminal bar. */
8
+ subtitle?: string;
9
+ /** Current execution or connection status. */
10
+ status?: 'active' | 'running' | 'completed' | 'closed' | 'error';
11
+ /** Monospace output lines rendered inside the dark terminal surface. */
12
+ lines: string[];
13
+ /** CLI prompt prefix shown when `interactive` mode is enabled. */
14
+ prompt?: string;
15
+ }
16
+ export interface STerminalConsoleProps {
17
+ /** Section title on the left of the header bar (e.g. `'Device Output'` or `'Sessions'`). */
18
+ title?: React.ReactNode;
19
+ /** Placeholder for the right-aligned filled search field. */
20
+ searchPlaceholder?: string;
21
+ /** Centered muted message displayed inside the dark terminal box when empty. */
22
+ emptyText?: React.ReactNode;
23
+ /** Diagnostic device outputs or interactive CLI sessions. */
24
+ sessions?: STerminalSessionItem[];
25
+ /** Controlled active session key. */
26
+ activeKey?: string | null;
27
+ /** Initial active session key for uncontrolled usage. */
28
+ defaultActiveKey?: string | null;
29
+ /** Callback fired when a device in `Device List` is clicked. */
30
+ onSelectSession?: (key: string) => void;
31
+ /** Optional callback fired when the close icon on a device pill is clicked. */
32
+ onCloseSession?: (key: string) => void;
33
+ /** Controlled search query string. */
34
+ searchQuery?: string;
35
+ /** Callback fired when the search input changes. */
36
+ onSearchChange?: (query: string) => void;
37
+ /** Callback fired when the Clear (broom) icon button is clicked. */
38
+ onClear?: () => void;
39
+ /** Callback fired when the Download icon button is clicked. */
40
+ onDownload?: (activeSession: STerminalSessionItem | null) => void;
41
+ /** Enables an interactive CLI command input prompt inside the terminal body. */
42
+ interactive?: boolean;
43
+ /** Callback fired when the user submits a CLI command in interactive mode. */
44
+ onSubmitCommand?: (sessionKey: string, command: string) => void;
45
+ /** Minimum height in pixels for the split `Device List` + dark terminal body. */
46
+ minHeight?: number;
47
+ /** Optional test identifier on the root container. */
48
+ 'data-testid'?: string;
49
+ className?: string;
50
+ }
51
+ /**
52
+ * Reusable Omada v6.3 split diagnostic terminal console featuring:
53
+ * - Header bar with title, right-aligned filled search input, and Clear / Download / `A+` controls
54
+ * - Left `Device List` rail (`200px` wide) displaying active session/output device pills
55
+ * - Right dark monospace terminal surface (`#242424`) with centered empty prompt and optional interactive CLI input
56
+ */
57
+ export declare const STerminalConsole: React.FC<STerminalConsoleProps>;
@@ -0,0 +1,66 @@
1
+ import React from 'react';
2
+ export type STileSelectionMode = 'single' | 'multiple';
3
+ export type STileLayout = 'horizontal' | 'vertical';
4
+ export interface STileOption {
5
+ value: string;
6
+ title: React.ReactNode;
7
+ description?: React.ReactNode;
8
+ icon?: React.ReactNode;
9
+ badge?: React.ReactNode;
10
+ disabled?: boolean;
11
+ }
12
+ export interface STileProps {
13
+ /** Option identifier when used inside `<STileGroup>`. */
14
+ value?: string;
15
+ title: React.ReactNode;
16
+ description?: React.ReactNode;
17
+ icon?: React.ReactNode;
18
+ badge?: React.ReactNode;
19
+ /** Controlled selection state when used standalone. */
20
+ checked?: boolean;
21
+ /** Default uncontrolled selection state when used standalone. */
22
+ defaultChecked?: boolean;
23
+ /** Change callback when used standalone. */
24
+ onChange?: (checked: boolean) => void;
25
+ onClick?: React.MouseEventHandler<HTMLButtonElement>;
26
+ disabled?: boolean;
27
+ layout?: STileLayout;
28
+ size?: 'sm' | 'md';
29
+ indicator?: 'corner-check' | 'check' | 'none';
30
+ selectionMode?: STileSelectionMode;
31
+ className?: string;
32
+ style?: React.CSSProperties;
33
+ }
34
+ /**
35
+ * Selectable Omada option tile (`Normal`, `Hover`, `Selected` green border + corner checkmark,
36
+ * `Disabled`) usable standalone or inside `<STileGroup>`.
37
+ */
38
+ export declare const STile: React.FC<STileProps>;
39
+ export interface STileGroupBaseProps {
40
+ options?: STileOption[];
41
+ children?: React.ReactNode;
42
+ columns?: 1 | 2 | 3 | 4 | 'auto';
43
+ layout?: STileLayout;
44
+ size?: 'sm' | 'md';
45
+ indicator?: 'corner-check' | 'check' | 'none';
46
+ disabled?: boolean;
47
+ className?: string;
48
+ }
49
+ export interface STileGroupSingleProps extends STileGroupBaseProps {
50
+ mode?: 'single';
51
+ value?: string;
52
+ defaultValue?: string;
53
+ onChange?: (value: string) => void;
54
+ }
55
+ export interface STileGroupMultiProps extends STileGroupBaseProps {
56
+ mode: 'multiple';
57
+ value?: string[];
58
+ defaultValue?: string[];
59
+ onChange?: (value: string[]) => void;
60
+ }
61
+ export type STileGroupProps = STileGroupSingleProps | STileGroupMultiProps;
62
+ /**
63
+ * Single- or multi-select Omada option tile group supporting declarative `options`
64
+ * or composable `<STile>` children.
65
+ */
66
+ export declare const STileGroup: React.FC<STileGroupProps>;
@@ -0,0 +1,16 @@
1
+ import React from 'react';
2
+ import { type TimePickerProps, type TimeRangePickerProps } from 'antd';
3
+ export interface STimePickerProps extends TimePickerProps {
4
+ }
5
+ export interface STimeRangePickerProps extends TimeRangePickerProps {
6
+ }
7
+ /**
8
+ * Omada single TimePicker defaulting to filled styling (`#F4F4F4` light / `#272727` dark),
9
+ * Figma clock icon, and 24-hour (`HH:mm:ss`) or 12-hour (`hh:mm A`) wheel popup.
10
+ */
11
+ export declare const STimePicker: React.FC<STimePickerProps>;
12
+ /**
13
+ * Omada TimeRangePicker defaulting to filled styling (`Start Time` - `End Time`),
14
+ * Figma clock icon, and Light/Dark popup parity.
15
+ */
16
+ export declare const STimeRangePicker: React.FC<STimeRangePickerProps>;
@@ -0,0 +1,34 @@
1
+ import React from 'react';
2
+ import { type TooltipProps } from 'antd';
3
+ import type { TooltipPlacement, TooltipRef } from 'antd/es/tooltip';
4
+ export type STooltipProps = TooltipProps;
5
+ /**
6
+ * Omada-styled Ant Design 6 Tooltip defaulting to Figma's 400ms (`0.4s`) hover delay,
7
+ * `#2B2B2B 96%` / `#333333` surface, `4px` radius, and `[6, 8]` compact padding.
8
+ */
9
+ export declare const STooltip: React.ForwardRefExoticComponent<TooltipProps & React.RefAttributes<TooltipRef>>;
10
+ export interface STruncatedTextProps {
11
+ /** Text string to display with ellipsis truncation */
12
+ text: string;
13
+ /** Optional custom tooltip content (defaults to `text`) */
14
+ tooltip?: React.ReactNode;
15
+ /** Tooltip placement (defaults to `'top'`) */
16
+ placement?: TooltipPlacement;
17
+ /** Hover delay in seconds (defaults to `0.2` — 200ms per Figma spec) */
18
+ mouseEnterDelay?: number;
19
+ /** Maximum width CSS value (e.g., `180`, `'12rem'`, `'100%'`) */
20
+ maxWidth?: number | string;
21
+ /** Number of visible lines before truncation (defaults to `1`) */
22
+ lines?: number;
23
+ /** Wrapper element tag (`'span' | 'div' | 'p'`, defaults to `'span'`) */
24
+ as?: 'span' | 'div' | 'p';
25
+ /** Force showing tooltip regardless of measured overflow */
26
+ forceTooltip?: boolean;
27
+ className?: string;
28
+ style?: React.CSSProperties;
29
+ }
30
+ /**
31
+ * Ellipsis-truncated text that automatically reveals a `200ms` `<STooltip>`
32
+ * ONLY when its rendered content overflows (`scrollWidth > clientWidth` or `scrollHeight > clientHeight`).
33
+ */
34
+ export declare const STruncatedText: React.FC<STruncatedTextProps>;
@@ -0,0 +1,66 @@
1
+ import React from 'react';
2
+ import type { OmadaClientIconName, OmadaProductName } from '../assets/assetsManifest';
3
+ export type TopologyLayoutMode = 'horizontal' | 'vertical';
4
+ export type TopologyHealthFilter = 'good' | 'fair' | 'poor' | 'no-data' | null;
5
+ export interface TopologyNodeData {
6
+ id: string;
7
+ name: string;
8
+ kind: 'internet' | 'device' | 'client' | 'controller';
9
+ category?: 'gateway' | 'switch' | 'ap' | 'olt';
10
+ productSlug?: OmadaProductName;
11
+ clientIcon?: OmadaClientIconName;
12
+ status: 'connected' | 'disconnected' | 'pending';
13
+ healthBucket?: 'good' | 'fair' | 'poor' | 'no-data';
14
+ statusDotTone?: 'good' | 'poor' | 'no-data';
15
+ ip?: string;
16
+ mac?: string;
17
+ model?: string;
18
+ network?: string;
19
+ ssid?: string;
20
+ portLabel?: string;
21
+ speedLabel?: string;
22
+ linkDashed?: boolean;
23
+ showLinkAlertBadge?: boolean;
24
+ collapsible?: boolean;
25
+ children?: TopologyNodeData[];
26
+ }
27
+ export interface TopologyDisplayOptions {
28
+ showLinkLabels: boolean;
29
+ showClients: boolean;
30
+ showController: boolean;
31
+ showHealthStatus: boolean;
32
+ }
33
+ export declare const DEFAULT_TOPOLOGY_DISPLAY_OPTIONS: TopologyDisplayOptions;
34
+ export declare const DEFAULT_TOPOLOGY_TREE: TopologyNodeData;
35
+ export interface STopologyCanvasProps {
36
+ /** Root topology tree node (defaults to Headquarters Building hierarchy). */
37
+ root?: TopologyNodeData;
38
+ /** Layout orientation (`'horizontal'` left-to-right or `'vertical'` top-to-bottom). */
39
+ layout?: TopologyLayoutMode;
40
+ /** Invoked when user toggles layout mode via bottom-left control. */
41
+ onLayoutChange?: (layout: TopologyLayoutMode) => void;
42
+ /** Filter query matched against node name, IP, model, or MAC. */
43
+ searchQuery?: string;
44
+ /** Optional health bucket highlight filter. */
45
+ healthFilter?: TopologyHealthFilter;
46
+ /** Optional network filter value (`'all'` shows all). */
47
+ networkFilter?: string;
48
+ /** Optional SSID filter value (`'all'` shows all). */
49
+ ssidFilter?: string;
50
+ /** Display toggles controlled from top-bar Display popover. */
51
+ displayOptions?: Partial<TopologyDisplayOptions>;
52
+ /** Invoked when a device node is clicked (opens DevicePropertiesDrawer). */
53
+ onOpenDeviceByName?: (deviceName: string) => void;
54
+ /** Invoked when any node (device, client, controller, internet) is clicked. */
55
+ onSelectNode?: (node: TopologyNodeData) => void;
56
+ /** Height of canvas container (defaults to `580`). */
57
+ height?: number | string;
58
+ className?: string;
59
+ }
60
+ /**
61
+ * Interactive Omada v6.3 Network Topology Canvas (`Dashboard -> Topology`).
62
+ * Renders hierarchical Gateway -> Switch -> AP -> Client connections with curved Bezier
63
+ * edges, port/speed badges, green collapsible subtree hubs, search/health dimming,
64
+ * horizontal/vertical layout toggle, zoom/pan, and node click-to-inspect callbacks.
65
+ */
66
+ export declare const STopologyCanvas: React.FC<STopologyCanvasProps>;
@@ -0,0 +1,34 @@
1
+ import React from 'react';
2
+ import { type TransferProps } from 'antd';
3
+ export interface STransferItem {
4
+ key: string;
5
+ title: string;
6
+ description?: string;
7
+ disabled?: boolean;
8
+ icon?: React.ReactNode;
9
+ /** Group identifier for 2-level grouped tree mode (`grouped={true}`). */
10
+ group?: string;
11
+ /** Display label for the group header in `grouped` mode. */
12
+ groupTitle?: string;
13
+ /** Optional nested children (automatically flattened into 2-level grouped items). */
14
+ children?: STransferItem[];
15
+ [key: string]: unknown;
16
+ }
17
+ export interface STransferProps extends Omit<TransferProps<STransferItem>, 'dataSource' | 'pagination' | 'listStyle' | 'operationStyle' | 'operations'> {
18
+ dataSource: STransferItem[];
19
+ /** Enable pagination in standard 2-column mode (`true` defaults to `{ pageSize: 8 }`). Ignored when `grouped` is true. */
20
+ pagination?: boolean | TransferProps<STransferItem>['pagination'];
21
+ /** Enable 2-level collapsible category/group tree mode. */
22
+ grouped?: boolean;
23
+ /** Render leading item icons when provided on `STransferItem.icon`. */
24
+ showIcon?: boolean;
25
+ /** Column width (Figma baseline: `240`). */
26
+ listWidth?: number | string;
27
+ /** Column height (Figma baseline: `368`). */
28
+ listHeight?: number | string;
29
+ }
30
+ /**
31
+ * Omada dual-list Transfer supporting search, pagination, item counts (`selected/total`),
32
+ * row icons, empty states, and 2-level collapsible grouped tree selection (`grouped`).
33
+ */
34
+ export declare const STransfer: React.FC<STransferProps>;
@@ -0,0 +1,24 @@
1
+ import React from 'react';
2
+ import { type RefSelectProps, type TreeSelectProps } from 'antd';
3
+ type TreeSelectDataNode = NonNullable<TreeSelectProps['treeData']>[number];
4
+ export type STreeSelectNode = TreeSelectDataNode;
5
+ export interface STreeSelectProps<ValueType = unknown, OptionType extends TreeSelectDataNode = TreeSelectDataNode> extends TreeSelectProps<ValueType, OptionType> {
6
+ /** Renders a dedicated filled search bar inside the dropdown popup header. */
7
+ popupSearch?: boolean;
8
+ /** Placeholder text for the popup search input when `popupSearch` is enabled. */
9
+ searchPlaceholder?: string;
10
+ /** Ref forwarded to the underlying AntD 6 TreeSelect instance. */
11
+ ref?: React.Ref<RefSelectProps>;
12
+ }
13
+ /**
14
+ * Omada TreeSelect control defaulting to `variant="filled"`, supporting single selection,
15
+ * checkable / multi-select trees with removable Omada tags, and inline or popup search filtering.
16
+ */
17
+ export declare function STreeSelect<ValueType = unknown, OptionType extends TreeSelectDataNode = TreeSelectDataNode>({ variant, listHeight, treeCheckable, multiple, showSearch, popupSearch, searchPlaceholder, popupRender, tagRender, fieldNames, className, classNames, styles, ref, ...rest }: STreeSelectProps<ValueType, OptionType>): React.JSX.Element;
18
+ export declare namespace STreeSelect {
19
+ var TreeNode;
20
+ var SHOW_ALL: "SHOW_ALL";
21
+ var SHOW_PARENT: "SHOW_PARENT";
22
+ var SHOW_CHILD: "SHOW_CHILD";
23
+ }
24
+ export {};