@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 @@
1
+ export * from '../omada';
@@ -0,0 +1,10 @@
1
+ import * as ReactNS from 'react';
2
+ import * as ReactDOMNS from 'react-dom/client';
3
+ import * as antd from 'antd';
4
+ import * as AntdIcons from '@ant-design/icons';
5
+ export * from '../omada';
6
+ export { ReactNS as React, ReactDOMNS as ReactDOM, antd, AntdIcons };
7
+ /**
8
+ * Convenience mount helper for zero-build single-file HTML demos (`window.OmadaUI.render(...)`).
9
+ */
10
+ export declare function render(element: ReactNS.ReactElement, target?: string | HTMLElement): ReactDOMNS.Root;
@@ -0,0 +1,17 @@
1
+ import React from 'react';
2
+ import { type OmadaBrandAssetName } from './assetsManifest';
3
+ export interface SBrandAssetProps {
4
+ name: OmadaBrandAssetName;
5
+ theme?: 'light' | 'dark' | 'auto';
6
+ width?: number | string;
7
+ height?: number | string;
8
+ alt?: string;
9
+ className?: string;
10
+ style?: React.CSSProperties;
11
+ loading?: 'lazy' | 'eager';
12
+ fallback?: React.ReactNode;
13
+ }
14
+ /**
15
+ * Official Omada wordmark, app icon, and OAuth brand asset backed by `src/assets/brand/`.
16
+ */
17
+ export declare const SBrandAsset: React.FC<SBrandAssetProps>;
@@ -0,0 +1,16 @@
1
+ import React from 'react';
2
+ import { type OmadaClientIconName } from './assetsManifest';
3
+ export interface SClientIconProps {
4
+ name: OmadaClientIconName;
5
+ size?: number | string;
6
+ theme?: 'light' | 'dark' | 'auto';
7
+ alt?: string;
8
+ className?: string;
9
+ style?: React.CSSProperties;
10
+ loading?: 'lazy' | 'eager';
11
+ fallback?: React.ReactNode;
12
+ }
13
+ /**
14
+ * Theme-aware Omada client device / OS / vendor icon backed by `src/assets/clients/{light,dark}/`.
15
+ */
16
+ export declare const SClientIcon: React.FC<SClientIconProps>;
@@ -0,0 +1,21 @@
1
+ import React from 'react';
2
+ import { type OmadaIconName } from './iconsManifest';
3
+ export interface SIconProps {
4
+ name: OmadaIconName;
5
+ size?: number | string;
6
+ color?: string;
7
+ className?: string;
8
+ style?: React.CSSProperties;
9
+ title?: string;
10
+ 'aria-label'?: string;
11
+ 'aria-hidden'?: boolean;
12
+ }
13
+ /**
14
+ * Checks whether an icon slug exists in the bundled Figma icon library.
15
+ */
16
+ export declare function hasOmadaIcon(name: string): boolean;
17
+ /**
18
+ * Official Omada SVG icon component backed by the 586 Figma icons in `src/assets/icons/`.
19
+ * Monochrome icons inherit `currentColor`; multi-color icons preserve Figma fills.
20
+ */
21
+ export declare const SIcon: React.FC<SIconProps>;
@@ -0,0 +1,22 @@
1
+ import React from 'react';
2
+ import { type OmadaIllustrationName } from './assetsManifest';
3
+ export interface SIllustrationProps {
4
+ name: OmadaIllustrationName;
5
+ theme?: 'light' | 'dark' | 'auto';
6
+ width?: number | string;
7
+ height?: number | string;
8
+ alt?: string;
9
+ className?: string;
10
+ style?: React.CSSProperties;
11
+ loading?: 'lazy' | 'eager';
12
+ fallback?: React.ReactNode;
13
+ }
14
+ /**
15
+ * Checks whether an illustration slug exists in the bundled Figma illustration library.
16
+ */
17
+ export declare function hasOmadaIllustration(name: string): boolean;
18
+ /**
19
+ * Theme-aware Omada illustration backed by `src/assets/illustrations/{light,dark}/`.
20
+ * Automatically selects the dark variant in Dark Mode when available.
21
+ */
22
+ export declare const SIllustration: React.FC<SIllustrationProps>;
@@ -0,0 +1,20 @@
1
+ import React from 'react';
2
+ import { type OmadaProductName } from './assetsManifest';
3
+ export interface SProductImageProps {
4
+ name: OmadaProductName;
5
+ size?: number | string;
6
+ theme?: 'light' | 'dark' | 'auto';
7
+ alt?: string;
8
+ className?: string;
9
+ style?: React.CSSProperties;
10
+ loading?: 'lazy' | 'eager';
11
+ fallback?: React.ReactNode;
12
+ }
13
+ /**
14
+ * Checks whether a hardware product slug exists in the bundled Figma product library.
15
+ */
16
+ export declare function hasOmadaProductImage(name: string): boolean;
17
+ /**
18
+ * Theme-aware Omada hardware product thumbnail backed by `src/assets/products/{light,dark}/`.
19
+ */
20
+ export declare const SProductImage: React.FC<SProductImageProps>;
@@ -0,0 +1,26 @@
1
+ import React from 'react';
2
+ import type { OmadaAssetMeta } from './assetsManifest';
3
+ export interface ThemedAssetImageProps {
4
+ name: string;
5
+ entries: readonly OmadaAssetMeta[];
6
+ urlMap: Record<string, string>;
7
+ urlPrefix: string;
8
+ theme?: 'light' | 'dark' | 'auto';
9
+ width?: number | string;
10
+ height?: number | string;
11
+ alt?: string;
12
+ className?: string;
13
+ style?: React.CSSProperties;
14
+ loading?: 'lazy' | 'eager';
15
+ fallback?: React.ReactNode;
16
+ }
17
+ /**
18
+ * Resolves a themed asset entry matching `preferredTheme` (`light` | `dark`) first,
19
+ * falling back to any available variant with the same logical `name`.
20
+ */
21
+ export declare function resolveThemedAssetEntry(entries: readonly OmadaAssetMeta[], name: string, preferredTheme: 'light' | 'dark'): OmadaAssetMeta | undefined;
22
+ /**
23
+ * Shared image renderer for theme-aware Figma assets (illustrations, client icons,
24
+ * product model images, and brand assets).
25
+ */
26
+ export declare const ThemedAssetImage: React.FC<ThemedAssetImageProps>;
@@ -0,0 +1,19 @@
1
+ export interface OmadaAssetMeta {
2
+ name: string;
3
+ category: string;
4
+ figmaName: string;
5
+ figmaId: string;
6
+ theme: 'light' | 'dark';
7
+ format: 'svg' | 'png';
8
+ width: number;
9
+ height: number;
10
+ relPath: string;
11
+ }
12
+ export declare const OMADA_ILLUSTRATIONS: readonly OmadaAssetMeta[];
13
+ export declare const OMADA_CLIENTS: readonly OmadaAssetMeta[];
14
+ export declare const OMADA_PRODUCTS: readonly OmadaAssetMeta[];
15
+ export declare const OMADA_BRAND_ASSETS: readonly OmadaAssetMeta[];
16
+ export type OmadaIllustrationName = (typeof OMADA_ILLUSTRATIONS)[number]['name'];
17
+ export type OmadaClientIconName = (typeof OMADA_CLIENTS)[number]['name'];
18
+ export type OmadaProductName = (typeof OMADA_PRODUCTS)[number]['name'];
19
+ export type OmadaBrandAssetName = (typeof OMADA_BRAND_ASSETS)[number]['name'];
@@ -0,0 +1,15 @@
1
+ export interface OmadaIconMeta {
2
+ name: string;
3
+ category: string;
4
+ figmaName: string;
5
+ figmaCategory: string;
6
+ figmaId: string;
7
+ relPath: string;
8
+ format: 'svg' | 'png';
9
+ width: number;
10
+ height: number;
11
+ monochrome: boolean;
12
+ }
13
+ export declare const OMADA_ICON_CATEGORIES: readonly ["app-category", "button", "custom", "dashboard", "event", "general", "map", "other", "quick-action", "scene", "sidebar", "status", "system", "table", "topbar", "topo"];
14
+ export declare const OMADA_ICONS: readonly OmadaIconMeta[];
15
+ export type OmadaIconName = (typeof OMADA_ICONS)[number]['name'];
@@ -0,0 +1,34 @@
1
+ import React from 'react';
2
+ export type SAlertType = 'success' | 'error' | 'warning' | 'info';
3
+ export interface SAlertProps {
4
+ type?: SAlertType;
5
+ title?: React.ReactNode;
6
+ description?: React.ReactNode;
7
+ closable?: boolean;
8
+ onClose?: () => void;
9
+ action?: React.ReactNode;
10
+ align?: 'left' | 'center';
11
+ className?: string;
12
+ }
13
+ /**
14
+ * Omada borderless 12%-tinted banner alert (`6px` radius, `12px 16px` padding).
15
+ */
16
+ export declare const SAlert: React.FC<SAlertProps>;
17
+ /**
18
+ * Theme-aware Toast (`message`) and Notification (`notification`) hooks backed by `App.useApp()`.
19
+ */
20
+ export declare function useOmadaFeedback(): {
21
+ toast: {
22
+ success: (content: React.ReactNode, duration?: number) => import("antd/es/message/interface").MessageType;
23
+ error: (content: React.ReactNode, duration?: number) => import("antd/es/message/interface").MessageType;
24
+ warning: (content: React.ReactNode, duration?: number) => import("antd/es/message/interface").MessageType;
25
+ info: (content: React.ReactNode, duration?: number) => import("antd/es/message/interface").MessageType;
26
+ loading: (content: React.ReactNode, duration?: number) => import("antd/es/message/interface").MessageType;
27
+ };
28
+ notify: {
29
+ success: (title: React.ReactNode, description?: React.ReactNode) => void;
30
+ error: (title: React.ReactNode, description?: React.ReactNode) => void;
31
+ warning: (title: React.ReactNode, description?: React.ReactNode) => void;
32
+ info: (title: React.ReactNode, description?: React.ReactNode) => void;
33
+ };
34
+ };
@@ -0,0 +1,32 @@
1
+ import React from 'react';
2
+ import { type AnchorProps } from 'antd';
3
+ export type SAnchorDirection = 'vertical' | 'horizontal';
4
+ export interface SAnchorItem {
5
+ key: React.Key;
6
+ href: string;
7
+ title: React.ReactNode;
8
+ target?: string;
9
+ disabled?: boolean;
10
+ /** Marks a section anchor as having validation errors or alerts. */
11
+ status?: 'default' | 'error';
12
+ /** Convenience boolean alias for `status="error"`. */
13
+ error?: boolean;
14
+ children?: SAnchorItem[];
15
+ className?: string;
16
+ }
17
+ export interface SAnchorProps extends Omit<AnchorProps, 'items' | 'children' | 'direction'> {
18
+ /** Anchor TOC items supporting L1 + L2 nesting (in vertical direction). */
19
+ items: SAnchorItem[];
20
+ /** Optional TOC rail heading rendered above the anchor list. */
21
+ title?: React.ReactNode;
22
+ /** Layout orientation (`vertical` right-rail TOC or `horizontal` strip). */
23
+ direction?: SAnchorDirection;
24
+ /** Optional controlled/highlighted active href when not relying solely on scroll spy. */
25
+ activeHref?: string;
26
+ }
27
+ /**
28
+ * Omada Anchor (`35368:149692`):
29
+ * - Right-rail vertical TOC (and horizontal strip) with optional section `title`
30
+ * - Supports L1 + L2 indented links plus Normal, Hover, Active, Disabled, and Error states.
31
+ */
32
+ export declare const SAnchor: React.FC<SAnchorProps>;
@@ -0,0 +1,32 @@
1
+ import React from 'react';
2
+ import type { OmadaProductName } from '../assets/assetsManifest';
3
+ export interface SApDistributionCluster {
4
+ id: string;
5
+ /** Signal strength in dBm (`-90` .. `-30`). */
6
+ dbm: number;
7
+ /** Number of APs grouped at this RSSI bucket. */
8
+ count: number;
9
+ /** Ring highlight color status (`warning` = amber/yellow ring, `good` = green ring). */
10
+ status: 'good' | 'warning' | 'poor';
11
+ /** Product thumbnail inside the circular AP bubble. */
12
+ productSlug: OmadaProductName;
13
+ /** AP names included in this cluster for hover tooltip. */
14
+ apNames: string[];
15
+ }
16
+ export interface SApDistributionRulerProps {
17
+ /** AP signal distribution clusters plotted along the `-90dBm .. -30dBm` ruler. */
18
+ clusters: SApDistributionCluster[];
19
+ /** Minimum scale value in dBm (defaults to `-90`). */
20
+ minDbm?: number;
21
+ /** Maximum scale value in dBm (defaults to `-30`). */
22
+ maxDbm?: number;
23
+ /** Step between ruler tick marks (defaults to `5`). */
24
+ step?: number;
25
+ className?: string;
26
+ style?: React.CSSProperties;
27
+ }
28
+ /**
29
+ * RSSI AP Distribution ruler (`-90dBm` to `-30`) with rainbow signal-quality gradient bar,
30
+ * 5 dBm tick marks, and circular AP device cluster markers with green count badges.
31
+ */
32
+ export declare const SApDistributionRuler: React.FC<SApDistributionRulerProps>;
@@ -0,0 +1,28 @@
1
+ import React from 'react';
2
+ import { Avatar, type AvatarProps, type GetProps } from 'antd';
3
+ export type SAvatarSize = 'xs' | 'sm' | 'md' | 'lg' | number;
4
+ export type SAvatarStatus = 'online' | 'offline' | 'busy' | 'away';
5
+ export interface SAvatarProps extends Omit<AvatarProps, 'size'> {
6
+ /** Named Omada presets (`xs`: 20px, `sm`: 24px, `md`: 32px, `lg`: 48px) or numeric px. */
7
+ size?: SAvatarSize;
8
+ /** User display name; renders initials when no `src` or `icon` is given. */
9
+ name?: string;
10
+ /** Render neutral guest avatar state instead of authenticated brand tint. */
11
+ guest?: boolean;
12
+ /** Optional presence dot rendered at the bottom-right corner. */
13
+ status?: SAvatarStatus;
14
+ }
15
+ /**
16
+ * Omada Avatar component supporting `20px` (`xs`), `24px` (`sm`), `32px` (`md`), and `48px` (`lg`) sizes,
17
+ * image with graceful fallback, initials, guest/authenticated states, and optional status indicator.
18
+ */
19
+ export declare const SAvatar: React.FC<SAvatarProps>;
20
+ export interface SAvatarGroupProps extends Omit<GetProps<typeof Avatar.Group>, 'size' | 'maxCount' | 'maxStyle' | 'maxPopoverPlacement' | 'maxPopoverTrigger'> {
21
+ size?: SAvatarSize;
22
+ /** Maximum avatars shown before collapsing into a `+N` overflow badge (AntD 6 `max.count`). */
23
+ maxCount?: number;
24
+ }
25
+ /**
26
+ * Omada Avatar stack wrapper using AntD 6 `max` overflow popover config.
27
+ */
28
+ export declare const SAvatarGroup: React.FC<SAvatarGroupProps>;
@@ -0,0 +1,17 @@
1
+ import React from 'react';
2
+ import { type BadgeProps } from 'antd';
3
+ export type SBadgeStatus = 'success' | 'warning' | 'error' | 'processing' | 'default';
4
+ export type SBadgeTone = 'error' | 'brand' | 'info' | 'warning' | 'neutral';
5
+ export interface SBadgeProps extends Omit<BadgeProps, 'size' | 'status'> {
6
+ /** AntD 6 size (`'small' | 'medium'`; never deprecated `'default'`). */
7
+ size?: 'small' | 'medium';
8
+ /** Semantic status dot mode (`success`, `warning`, `error`, `processing`, `default`). */
9
+ status?: SBadgeStatus;
10
+ /** Count/dot semantic color tone when `color` is not manually provided. */
11
+ tone?: SBadgeTone;
12
+ }
13
+ /**
14
+ * Omada Badge supporting `20px`-tall capsule counts (`99+` overflow), standalone dots,
15
+ * and semantic status indicators (`success`, `warning`, `error`, `processing`, `default`).
16
+ */
17
+ export declare const SBadge: React.FC<SBadgeProps>;
@@ -0,0 +1,36 @@
1
+ import React from 'react';
2
+ import { type BreadcrumbProps } from 'antd';
3
+ import type { ItemType as AntdBreadcrumbItem } from 'antd/es/breadcrumb/Breadcrumb';
4
+ export interface SBreadcrumbItem {
5
+ key?: React.Key;
6
+ /** Display label for this breadcrumb node. */
7
+ title?: React.ReactNode;
8
+ /** Convenience alias for `title`. */
9
+ label?: React.ReactNode;
10
+ /** Optional leading icon. */
11
+ icon?: React.ReactNode;
12
+ /** Render only the icon inside the breadcrumb item while keeping `tooltip` / `ariaLabel` accessible. */
13
+ iconOnly?: boolean;
14
+ href?: string;
15
+ onClick?: React.MouseEventHandler<HTMLAnchorElement | HTMLSpanElement>;
16
+ menu?: AntdBreadcrumbItem['menu'];
17
+ tooltip?: React.ReactNode;
18
+ ariaLabel?: string;
19
+ className?: string;
20
+ style?: React.CSSProperties;
21
+ }
22
+ export interface SBreadcrumbProps extends Omit<BreadcrumbProps, 'items' | 'routes' | 'children'> {
23
+ /** Breadcrumb hierarchy items (AntD 6 `items` API). */
24
+ items: SBreadcrumbItem[];
25
+ /** Built-in separator glyph when `separator` prop is omitted. */
26
+ separatorVariant?: 'chevron' | 'slash';
27
+ /** Maximum visible items before middle ancestors collapse into a `...` dropdown menu. */
28
+ maxItems?: number;
29
+ /** Optional pixel width cap on item text triggering ellipsis truncation + hover Tooltip. */
30
+ maxItemWidth?: number;
31
+ }
32
+ /**
33
+ * Omada Breadcrumb (`35368:151120`) supporting text, icon-only, icon + text,
34
+ * automatic middle `...` collapse dropdown for deep paths, and truncated ellipsis tooltips.
35
+ */
36
+ export declare const SBreadcrumb: React.FC<SBreadcrumbProps>;
@@ -0,0 +1,11 @@
1
+ import React from 'react';
2
+ import { type ButtonProps } from 'antd';
3
+ export type SButtonVariant = 'primary' | 'secondary' | 'outline' | 'dashed' | 'text' | 'link' | 'danger' | 'danger-outline';
4
+ export interface SButtonProps extends Omit<ButtonProps, 'type' | 'variant' | 'danger'> {
5
+ variant?: SButtonVariant;
6
+ }
7
+ /**
8
+ * Omada-styled button supporting primary green, neutral filled secondary,
9
+ * green outline, dashed, text, link, danger solid, and danger outline variants.
10
+ */
11
+ export declare const SButton: React.ForwardRefExoticComponent<SButtonProps & React.RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
@@ -0,0 +1,28 @@
1
+ import React from 'react';
2
+ export interface SCardProps {
3
+ title?: React.ReactNode;
4
+ subtitle?: React.ReactNode;
5
+ extra?: React.ReactNode;
6
+ padding?: 'none' | 'sm' | 'md' | 'lg';
7
+ children: React.ReactNode;
8
+ className?: string;
9
+ style?: React.CSSProperties;
10
+ }
11
+ /**
12
+ * Omada surface card (`#FFFFFF` light / `#1A1A1A` dark, 8px radius, 1px hairline border).
13
+ */
14
+ export declare const SCard: React.FC<SCardProps>;
15
+ export interface SKpiCardProps {
16
+ title: string;
17
+ value: React.ReactNode;
18
+ icon?: React.ReactNode;
19
+ meta?: React.ReactNode;
20
+ accentColor?: string;
21
+ onClick?: () => void;
22
+ active?: boolean;
23
+ className?: string;
24
+ }
25
+ /**
26
+ * Compact Omada KPI metric tile with tabular numerals, optional icon, and breakdown meta line.
27
+ */
28
+ export declare const SKpiCard: React.FC<SKpiCardProps>;
@@ -0,0 +1,20 @@
1
+ import React from 'react';
2
+ import { type CascaderAutoProps } from 'antd';
3
+ import type { CascaderRef, DefaultOptionType } from 'antd/es/cascader';
4
+ export type SCascaderOption = DefaultOptionType;
5
+ export type SCascaderProps<OptionType extends DefaultOptionType = SCascaderOption, ValueField extends keyof OptionType = keyof OptionType> = CascaderAutoProps<OptionType, ValueField> & {
6
+ /** Separator rendered between path segments in the default `displayRender` (defaults to `' / '`). */
7
+ displaySeparator?: React.ReactNode;
8
+ /** Ref forwarded to the underlying AntD 6 Cascader instance. */
9
+ ref?: React.Ref<CascaderRef>;
10
+ };
11
+ /**
12
+ * Omada Cascader control defaulting to `variant="filled"`, supporting single and
13
+ * multi-select hierarchical paths with customizable `displayRender` and removable Omada tags.
14
+ */
15
+ export declare function SCascader<OptionType extends DefaultOptionType = SCascaderOption, ValueField extends keyof OptionType = keyof OptionType>({ variant, displaySeparator, displayRender, tagRender, multiple, className, classNames, styles, ref, ...rest }: SCascaderProps<OptionType, ValueField>): React.JSX.Element;
16
+ export declare namespace SCascader {
17
+ var SHOW_PARENT: "SHOW_PARENT";
18
+ var SHOW_CHILD: "SHOW_CHILD";
19
+ var Panel: typeof import("antd/es/cascader/Panel").default;
20
+ }
@@ -0,0 +1,26 @@
1
+ import React from 'react';
2
+ import type { OmadaIconName } from '../assets/iconsManifest';
3
+ export interface CategoryKpiItem {
4
+ key: string;
5
+ label: string;
6
+ count: number;
7
+ /** Optional Figma `SIcon` slug or custom icon element. */
8
+ icon?: OmadaIconName | React.ReactNode;
9
+ }
10
+ export interface SCategoryKpiCarouselProps {
11
+ /** Category KPI cards rendered horizontally inside the carousel. */
12
+ items?: CategoryKpiItem[];
13
+ /** Controlled active category key. */
14
+ activeKey?: string;
15
+ /** Uncontrolled initial active category key (defaults to `'overview'`). */
16
+ defaultActiveKey?: string;
17
+ /** Fired when a category card is selected. */
18
+ onSelect?: (key: string) => void;
19
+ className?: string;
20
+ }
21
+ export declare const DEFAULT_INCIDENT_CATEGORY_ITEMS: CategoryKpiItem[];
22
+ /**
23
+ * Horizontal scrollable KPI category strip with `<` / `>` scroll arrows,
24
+ * active `#00A870` border + subtle tint highlight, and Light/Dark theme support.
25
+ */
26
+ export declare const SCategoryKpiCarousel: React.FC<SCategoryKpiCarouselProps>;
@@ -0,0 +1,25 @@
1
+ import React from 'react';
2
+ export type SChannelUtilizationLevel = 'low' | 'medium' | 'high';
3
+ export interface SChannelItem {
4
+ channel: number;
5
+ /** Utilization percentage (`0..100`). `0` renders an idle track bar. */
6
+ utilization: number;
7
+ /** Utilization severity override (auto-derived from `utilization` if omitted). */
8
+ level?: SChannelUtilizationLevel;
9
+ }
10
+ export interface SChannelBand {
11
+ key: string;
12
+ label: string;
13
+ channels: SChannelItem[];
14
+ }
15
+ export interface SChannelUtilizationProps {
16
+ /** Radio band groups (`2.4 GHz`, `5 GHz`, `6 GHz`) rendered side by side. */
17
+ bands: SChannelBand[];
18
+ className?: string;
19
+ style?: React.CSSProperties;
20
+ }
21
+ /**
22
+ * Multi-band wireless Channel Utilization mini-bar chart across `2.4 GHz`, `5 GHz`, and `6 GHz`
23
+ * with color-coded Low / Medium / High utilization levels and band underline labels.
24
+ */
25
+ export declare const SChannelUtilization: React.FC<SChannelUtilizationProps>;
@@ -0,0 +1,135 @@
1
+ import React from 'react';
2
+ import type { EChartsOption } from 'echarts';
3
+ export interface SChartProps {
4
+ option: EChartsOption;
5
+ height?: number | string;
6
+ loading?: boolean;
7
+ empty?: boolean;
8
+ emptyTitle?: React.ReactNode;
9
+ emptyDescription?: React.ReactNode;
10
+ renderer?: 'canvas' | 'svg';
11
+ className?: string;
12
+ style?: React.CSSProperties;
13
+ }
14
+ /**
15
+ * ECharts 5 chart wrapper pre-configured with Omada's 20-color categorical palette,
16
+ * `Manrope` typography, dashed gridlines, Light/Dark live theme sync, `ResizeObserver`,
17
+ * loading skeleton, and `<SEmpty>` empty state.
18
+ */
19
+ export declare const SChart: React.FC<SChartProps>;
20
+ export interface SLineChartSeries {
21
+ name: string;
22
+ data: (number | null)[];
23
+ color?: string;
24
+ area?: boolean;
25
+ smooth?: boolean;
26
+ dashed?: boolean;
27
+ showSymbol?: boolean;
28
+ stack?: string;
29
+ }
30
+ export interface SLineChartProps {
31
+ xData: string[];
32
+ series: SLineChartSeries[];
33
+ area?: boolean;
34
+ smooth?: boolean;
35
+ /** Fixes Y-axis to 0%–100% with 6 ticks (`0, 20, 40, 60, 80, 100`). */
36
+ percentage?: boolean;
37
+ yUnit?: string;
38
+ yMin?: number;
39
+ yMax?: number;
40
+ showLegend?: boolean;
41
+ legendPosition?: 'top' | 'bottom';
42
+ height?: number | string;
43
+ loading?: boolean;
44
+ empty?: boolean;
45
+ emptyTitle?: React.ReactNode;
46
+ emptyDescription?: React.ReactNode;
47
+ className?: string;
48
+ style?: React.CSSProperties;
49
+ optionOverride?: EChartsOption;
50
+ }
51
+ /**
52
+ * Omada multi-series Line / Area chart preset with 5-tick default or 6-tick percentage Y-axis,
53
+ * gradient area fill, interactive legend toggling, loading skeleton, and empty state.
54
+ */
55
+ export declare const SLineChart: React.FC<SLineChartProps>;
56
+ export interface SBarChartSeries {
57
+ name: string;
58
+ data: number[];
59
+ color?: string;
60
+ stack?: string;
61
+ }
62
+ export interface SBarChartProps {
63
+ categories: string[];
64
+ series: SBarChartSeries[];
65
+ layout?: 'vertical' | 'horizontal';
66
+ stacked?: boolean;
67
+ barWidth?: number;
68
+ percentage?: boolean;
69
+ unit?: string;
70
+ showLegend?: boolean;
71
+ legendPosition?: 'top' | 'bottom';
72
+ height?: number | string;
73
+ loading?: boolean;
74
+ empty?: boolean;
75
+ emptyTitle?: React.ReactNode;
76
+ emptyDescription?: React.ReactNode;
77
+ className?: string;
78
+ style?: React.CSSProperties;
79
+ optionOverride?: EChartsOption;
80
+ }
81
+ /**
82
+ * Omada Bar chart preset supporting vertical, stacked, and horizontal layouts
83
+ * with 5-tick (or 6-tick percentage) axis scaling, loading skeleton, and empty state.
84
+ */
85
+ export declare const SBarChart: React.FC<SBarChartProps>;
86
+ export interface SDonutChartDatum {
87
+ name: string;
88
+ value: number;
89
+ color?: string;
90
+ }
91
+ export interface SDonutChartProps {
92
+ data: SDonutChartDatum[];
93
+ centerValue?: React.ReactNode;
94
+ centerLabel?: React.ReactNode;
95
+ radius?: [string, string];
96
+ showLegend?: boolean;
97
+ legendPosition?: 'bottom' | 'right';
98
+ unit?: string;
99
+ height?: number | string;
100
+ loading?: boolean;
101
+ empty?: boolean;
102
+ emptyTitle?: React.ReactNode;
103
+ emptyDescription?: React.ReactNode;
104
+ className?: string;
105
+ style?: React.CSSProperties;
106
+ optionOverride?: EChartsOption;
107
+ }
108
+ /**
109
+ * Omada Donut ring chart preset with optional center KPI metric overlay,
110
+ * interactive legend, loading skeleton, and empty state.
111
+ */
112
+ export declare const SDonutChart: React.FC<SDonutChartProps>;
113
+ export interface SSparkChartProps {
114
+ data: number[];
115
+ labels?: string[];
116
+ seriesName?: string;
117
+ variant?: 'line' | 'area' | 'bar';
118
+ color?: string;
119
+ unit?: string;
120
+ /** Shows strictly 2 Y-axis ticks (`min` and `max`) per Omada widget spec. */
121
+ showAxisTicks?: boolean;
122
+ height?: number | string;
123
+ loading?: boolean;
124
+ empty?: boolean;
125
+ emptyTitle?: React.ReactNode;
126
+ emptyDescription?: React.ReactNode;
127
+ className?: string;
128
+ style?: React.CSSProperties;
129
+ optionOverride?: EChartsOption;
130
+ }
131
+ /**
132
+ * Compact dashboard widget spark chart featuring strictly 2 Y-axis ticks (`min` and `max`),
133
+ * supporting `area`, `line`, and `bar` modes.
134
+ */
135
+ export declare const SSparkChart: React.FC<SSparkChartProps>;
@@ -0,0 +1,41 @@
1
+ import React from 'react';
2
+ import { type CheckboxOptionType, type CheckboxProps, type CheckboxRef } from 'antd';
3
+ import type { CheckboxGroupProps } from 'antd/es/checkbox';
4
+ export type SCheckboxGroupVariant = 'default' | 'button';
5
+ export interface SCheckboxProps extends CheckboxProps {
6
+ /** Optional explanatory copy rendered 4px beneath the checkbox label. */
7
+ description?: React.ReactNode;
8
+ /** Ref forwarded to the underlying AntD 6 Checkbox instance. */
9
+ ref?: React.Ref<CheckboxRef>;
10
+ }
11
+ /**
12
+ * Omada Checkbox with optional secondary `description` line aligned cleanly under the label.
13
+ */
14
+ export declare const SCheckbox: React.FC<SCheckboxProps> & {
15
+ Group: typeof SCheckboxGroup;
16
+ };
17
+ export interface SCheckboxOption<T = string | number> extends CheckboxOptionType<T> {
18
+ /** Optional secondary description line shown below the option label (default variant). */
19
+ description?: React.ReactNode;
20
+ /** Optional leading icon inside the option label or button pill. */
21
+ icon?: React.ReactNode;
22
+ }
23
+ export interface SCheckboxGroupProps<T = string | number> extends Omit<CheckboxGroupProps<T>, 'options'> {
24
+ /** Visual variant: standard checkboxes (`default`) or linear selectable button pills (`button`). */
25
+ variant?: SCheckboxGroupVariant;
26
+ /** Array of checkbox options or primitive values. */
27
+ options?: Array<SCheckboxOption<T> | string | number>;
28
+ /** Renders a Select All header checkbox with automatic indeterminate state. */
29
+ showSelectAll?: boolean;
30
+ /** Label for the Select All header checkbox (defaults to `'Select All'`). */
31
+ selectAllLabel?: React.ReactNode;
32
+ /** Arrangement axis of group items (`horizontal` wraps cleanly; `vertical` stacks). */
33
+ direction?: 'horizontal' | 'vertical';
34
+ /** Optional fixed width per item (e.g. `160` for Figma's 160px grid alignment). */
35
+ itemWidth?: number | string;
36
+ }
37
+ /**
38
+ * Omada Checkbox Group supporting `default` and linear `button` variants,
39
+ * option descriptions, fixed-width grid alignment, and an integrated `showSelectAll` toggle.
40
+ */
41
+ export declare function SCheckboxGroup<T extends string | number = string | number>({ variant, options, showSelectAll, selectAllLabel, direction, itemWidth, value, defaultValue, onChange, disabled, name, className, style, children, ...rest }: SCheckboxGroupProps<T>): React.JSX.Element;