react-aiops 0.0.1

package/dist/AIOPsDashboard.d.ts

@@ -0,0 +1,46 @@
+import { default as React } from 'react';
+import { ComponentStatus } from './types';
+import { ServiceDialogMetric, ServiceDialogAlert } from './components/ServiceDialog';
+/**
+ * Minimal metadata for each service in the carousel.
+ * Used to populate the {@link ServiceDialog} when a service is selected.
+ */
+export interface ServiceMeta {
+    /** Service display name (must match the service component's `name`). */
+    name: string;
+    /** Overall health status of this service. */
+    status: ComponentStatus;
+    /** Whether the service's databases are in sync. Defaults to `true`. */
+    dbSync?: boolean;
+    /** Service-level KPI metrics for the stats dialog. */
+    metrics?: ServiceDialogMetric[];
+    /** System alerts for the stats dialog. */
+    alerts?: ServiceDialogAlert[];
+}
+export interface AIOPsDashboardProps {
+    /** Dashboard title displayed in the header. */
+    title?: string;
+    /** Brand name shown with the pulse indicator. Defaults to `"BUSAUD AIOps"`. */
+    brandName?: string;
+    /** Tag badge in the header corner. Defaults to `"3D MONITOR"`. */
+    brandTag?: string;
+    /**
+     * Metadata for each service — used for the service-level stats dialog.
+     * Each entry should match a child service component by `name`.
+     */
+    services?: ServiceMeta[];
+    /**
+     * Service components to display in the carousel.
+     * Each child should be a service component (e.g. `<SAPService>`)
+     * that internally renders the library `<Service>` container.
+     */
+    children: React.ReactNode;
+}
+/**
+ * Full AIOps infrastructure dashboard.
+ *
+ * Renders a branded header, a 3D carousel of services, and a
+ * controls footer. All interaction state is self-contained.
+ */
+export default function AIOPsDashboard({ brandName, brandTag, services, children, }: AIOPsDashboardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AIOPsDashboard.d.ts.map

package/dist/AIOPsDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIOPsDashboard.d.ts","sourceRoot":"","sources":["../src/AIOPsDashboard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AAExC,OAAO,KAAK,EAAgC,eAAe,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAO1F;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,eAAe,CAAC;IACxB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAChC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB;;;;OAIG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAMD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,EACnC,SAA0B,EAC1B,QAAuB,EACvB,QAAa,EACb,QAAQ,GACX,EAAE,mBAAmB,2CAiJrB"}

package/dist/components/Carousel.d.ts

@@ -0,0 +1,60 @@
+import { default as React } from 'react';
+import { ViewState, SelectedComponent, ComponentStatus } from '../types';
+import { ServiceDialogMetric, ServiceDialogAlert } from './ServiceDialog';
+export interface CarouselProps {
+    /** Service components to display in the carousel. Each must be a `<Service>`. */
+    children: React.ReactNode;
+    /** Current view state of the carousel. */
+    viewState: ViewState;
+    /** Current expansion animation phase (0–6). */
+    animPhase: number;
+    /** Name of the currently selected/expanded system, or `null`. */
+    selectedSystem: string | null;
+    /** Currently selected component for drill-down, or `null`. */
+    selectedComponent: SelectedComponent | null;
+    /** Drill-down animation phase (0–1). */
+    drillAnimPhase: number;
+    /** Y-axis rotation for all 3D components (degrees). */
+    rotateY?: number;
+    /** Whether 3D components auto-rotate around the Y axis. */
+    autoRotateComponents?: boolean;
+    /** Scale factor for components in expanded view (0.3–1.5). */
+    componentScale?: number;
+    /** Zoom factor when drilling into a component (1.5–6). Defaults to `3.3`. */
+    drillZoom?: number;
+    /** Whether the carousel auto-rotates when in compact view. Defaults to `true`. */
+    autoRotateCarousel?: boolean;
+    /** Angular speed of the carousel rotation (radians per frame). Defaults to `0.006`. */
+    carouselSpeed?: number;
+    /** Width of the scene container in pixels. Defaults to `660`. */
+    width?: number;
+    /** Height of the scene container in pixels. Defaults to `600`. */
+    height?: number;
+    /** Called when a service is clicked in compact view. */
+    onSelectSystem: (name: string) => void;
+    /** Called when the background is clicked (collapse or close drill). */
+    onBackgroundClick: () => void;
+    /** Called when a component node is clicked for drill-down. */
+    onComponentClick: (info: SelectedComponent) => void;
+    /** Called when the drill-down view close button is clicked. */
+    onCloseDrill: () => void;
+    /**
+     * Overall status of the currently selected system.
+     * Used to populate the {@link ServiceDialog}. Defaults to `"online"`.
+     */
+    selectedSystemStatus?: ComponentStatus;
+    /** Whether the selected system's databases are in sync. Defaults to `true`. */
+    selectedSystemDbSync?: boolean;
+    /** Service-level KPI metrics for the stats dialog. */
+    selectedSystemMetrics?: ServiceDialogMetric[];
+    /** System alerts for the stats dialog. */
+    selectedSystemAlerts?: ServiceDialogAlert[];
+}
+/**
+ * Grand carousel container.
+ *
+ * Positions child services on a 3D elliptical orbit, manages the
+ * rotation animation, and renders overlay dialogs.
+ */
+export default function Carousel({ children, viewState, animPhase, selectedSystem, selectedComponent, drillAnimPhase, rotateY, autoRotateComponents, componentScale, drillZoom, autoRotateCarousel, carouselSpeed, width, height, onSelectSystem, onBackgroundClick: _onBackgroundClick, onComponentClick, onCloseDrill, selectedSystemStatus, selectedSystemDbSync, selectedSystemMetrics, selectedSystemAlerts, }: CarouselProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Carousel.d.ts.map

package/dist/components/Carousel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Carousel.d.ts","sourceRoot":"","sources":["../../src/components/Carousel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI/E,MAAM,WAAW,aAAa;IAC1B,iFAAiF;IACjF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAI1B,0CAA0C;IAC1C,SAAS,EAAE,SAAS,CAAC;IACrB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8DAA8D;IAC9D,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IAIvB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IAIvB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAIhB,wDAAwD;IACxD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,8DAA8D;IAC9D,gBAAgB,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpD,+DAA+D;IAC/D,YAAY,EAAE,MAAM,IAAI,CAAC;IAIzB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,eAAe,CAAC;IACvC,+EAA+E;IAC/E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC9C,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC/C;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,EAC7B,QAAQ,EACR,SAAS,EACT,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,OAAY,EACZ,oBAA2B,EAC3B,cAAqB,EACrB,SAAe,EACf,kBAAyB,EACzB,aAAqB,EACrB,KAAW,EACX,MAAY,EACZ,cAAc,EACd,iBAAiB,EAAE,kBAAkB,EACrC,gBAAgB,EAChB,YAAY,EACZ,oBAA+B,EAC/B,oBAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,GACvB,EAAE,aAAa,2CAmGf"}

package/dist/components/ComponentDialog.d.ts

@@ -0,0 +1,10 @@
+import { SelectedComponent } from '../types';
+export interface ComponentDialogProps {
+    component: SelectedComponent;
+    onClose: () => void;
+    visible: boolean;
+    sceneWidth?: number;
+    sceneHeight?: number;
+}
+export default function ComponentDialog({ component, onClose, visible, sceneWidth, sceneHeight, }: ComponentDialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ComponentDialog.d.ts.map

package/dist/components/ComponentDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentDialog.d.ts","sourceRoot":"","sources":["../../src/components/ComponentDialog.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAIlD,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AA2BD,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,EACpC,SAAS,EACT,OAAO,EACP,OAAO,EACP,UAAgB,EAChB,WAAiB,GACpB,EAAE,oBAAoB,2CAqTtB"}

package/dist/components/ComponentDrillView.d.ts

@@ -0,0 +1,98 @@
+import { ComponentStatus } from '../theme';
+import { SubComponentConfig, GraphSeries } from '../types';
+/**
+ * Discriminator for the four infrastructure component categories.
+ * Determines which internal sub-components are shown inside the drill-down.
+ */
+export type ComponentType = "server" | "dispatcher" | "messageServer" | "database";
+/**
+ * Describes a single sub-component inside a drilled-down infrastructure node.
+ *
+ * @property id     - Unique identifier (e.g. `"cpu-0"`, `"platter-1"`).
+ * @property label  - Human-readable label rendered on the 3D block.
+ * @property status - Health status that colours the sub-component.
+ * @property detail - Optional short description shown on fault conditions.
+ */
+export interface InternalComponent {
+    id: string;
+    label: string;
+    status: ComponentStatus;
+    detail?: string;
+}
+/**
+ * Returns the list of internal sub-components for a given infrastructure type,
+ * propagating the parent's health status to individual sub-items based on
+ * contextual load/capacity thresholds.
+ *
+ * @param type    - The infrastructure category.
+ * @param name    - Hostname of the parent component (used for node-specific rules).
+ * @param status  - Overall parent health status.
+ * @param context - Optional runtime metrics used to derive per-item statuses.
+ * @returns An array of {@link InternalComponent} descriptors.
+ *
+ * @example
+ * ```ts
+ * const parts = getInternalComponents("server", "APP-03", "critical", { cpuLoad: 95 });
+ * ```
+ */
+export declare function getInternalComponents(type: ComponentType, name: string, status: ComponentStatus, context?: {
+    cpuLoad?: number;
+    memLoad?: number;
+    traffic?: number;
+    queueDepth?: number;
+    capacity?: number;
+}): InternalComponent[];
+/**
+ * Props for the {@link ComponentDrillView} overlay.
+ *
+ * @property type      - Infrastructure category controlling which interior is rendered.
+ * @property name      - Hostname of the node being inspected.
+ * @property status    - Current health status of the parent node.
+ * @property onClose   - Callback invoked when the user dismisses the overlay.
+ * @property animPhase - Animation progress from `0` (closed) to `1` (fully open).
+ * @property context   - Optional runtime metrics forwarded to sub-components and graphs.
+ */
+export interface ComponentDrillViewProps {
+    type: ComponentType;
+    name: string;
+    status: ComponentStatus;
+    onClose: () => void;
+    animPhase: number;
+    context?: {
+        cpuLoad?: number;
+        memLoad?: number;
+        traffic?: number;
+        queueDepth?: number;
+        capacity?: number;
+    };
+    /**
+     * When provided, the drill-down interior renders these sub-components
+     * instead of using the built-in type-based defaults. This makes the
+     * drill-down fully composable.
+     */
+    subComponents?: SubComponentConfig[];
+    /**
+     * When provided, the historical graph panel renders these series
+     * instead of generating type-based defaults.
+     */
+    graphSeries?: GraphSeries[];
+}
+/**
+ * Full-screen drill-down overlay showing the internal sub-components and
+ * historical graphs for a selected infrastructure node. Features a
+ * double-door opening animation driven by `animPhase`.
+ *
+ * @example
+ * ```tsx
+ * <ComponentDrillView
+ *   type="server"
+ *   name="APP-03"
+ *   status="critical"
+ *   animPhase={1}
+ *   onClose={() => setOpen(false)}
+ *   context={{ cpuLoad: 92, memLoad: 78 }}
+ * />
+ * ```
+ */
+export default function ComponentDrillView({ type, name, status, onClose, animPhase, context, subComponents, graphSeries, }: ComponentDrillViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ComponentDrillView.d.ts.map

package/dist/components/ComponentDrillView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentDrillView.d.ts","sourceRoot":"","sources":["../../src/components/ComponentDrillView.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAchE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,eAAe,GAAG,UAAU,CAAC;AAEnF;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACjC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE;IACN,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GACF,iBAAiB,EAAE,CAgKrB;AAKD;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF;;;;OAIG;IACH,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACrC;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;CAC/B;AA6UD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EACvC,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,OAAO,EACP,SAAS,EACT,OAAY,EACZ,aAAa,EACb,WAAW,GACd,EAAE,uBAAuB,2CA6MzB"}

package/dist/components/Database3D.d.ts

@@ -0,0 +1,38 @@
+import { ComponentStatus } from '../theme';
+/**
+ * Props for the {@link Database3D} component.
+ *
+ * @property rotateX    - Rotation around the X axis in degrees.
+ * @property rotateY    - Rotation around the Y axis in degrees.
+ * @property rotateZ    - Rotation around the Z axis in degrees.
+ * @property scale      - Uniform scale multiplier (default `1`).
+ * @property autoRotate - Continuously spin the cylinder on its Y axis.
+ * @property status     - Current health status governing colour palette.
+ * @property name       - Hostname label for the database instance.
+ * @property capacity   - Storage capacity percentage (0–100) shown as a fill bar.
+ * @property connections - Number of active connections (informational).
+ */
+export interface Database3DProps {
+    rotateX?: number;
+    rotateY?: number;
+    rotateZ?: number;
+    scale?: number;
+    autoRotate?: boolean;
+    status?: ComponentStatus;
+    name?: string;
+    capacity?: number;
+    connections?: number;
+    /** @internal Injected by FloatWrap — uses opaque face backgrounds. */
+    _compact?: boolean;
+}
+/**
+ * Renders a CSS-3D database cylinder with three stacked platters, status-aware
+ * colouring, optional auto-rotation, and an ambient glow.
+ *
+ * @example
+ * ```tsx
+ * <Database3D status="online" capacity={72} name="DB-PRI" />
+ * ```
+ */
+export default function Database3D({ rotateX, rotateY, rotateZ, scale, autoRotate, status, capacity, _compact, }: Database3DProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Database3D.d.ts.map

package/dist/components/Database3D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database3D.d.ts","sourceRoot":"","sources":["../../src/components/Database3D.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAc,KAAK,eAAe,EAAkB,MAAM,UAAU,CAAC;AAkB5E;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAoPD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EAC/B,OAAa,EACb,OAAa,EACb,OAAW,EACX,KAAS,EACT,UAAkB,EAClB,MAAiB,EAEjB,QAAa,EAEb,QAAQ,GACX,EAAE,eAAe,2CA6HjB"}

package/dist/components/HistoricalGraphPanel.d.ts

@@ -0,0 +1,61 @@
+import { ComponentType } from './ComponentDrillView';
+import { GraphSeries } from '../types';
+/**
+ * Configuration for a single sparkline metric series.
+ *
+ * @property id    - Unique key used as the React list key.
+ * @property label - Display name rendered above the sparkline.
+ * @property unit  - Unit suffix shown next to the latest value (e.g. `"%"`, `"kbps"`).
+ * @property color - Hex accent colour for the sparkline stroke and label.
+ * @property data  - Array of numeric data points (most recent last).
+ */
+export interface SeriesConfig {
+    id: string;
+    label: string;
+    unit: string;
+    color: string;
+    data: number[];
+}
+/**
+ * Props for the {@link HistoricalGraphPanel} component.
+ *
+ * @property type      - Infrastructure category controlling which series are generated.
+ * @property name      - Hostname label displayed at the panel header.
+ * @property context   - Optional runtime metrics seeding the mock sparkline data.
+ * @property status    - Health status string governing accent colour.
+ * @property animPhase - Animation progress (0–1) driving the slide-in and fade.
+ */
+export interface HistoricalGraphPanelProps {
+    type: ComponentType;
+    name: string;
+    context?: {
+        cpuLoad?: number;
+        memLoad?: number;
+        traffic?: number;
+        queueDepth?: number;
+        capacity?: number;
+    };
+    status?: string;
+    animPhase: number;
+    /**
+     * When provided, renders these series instead of generating
+     * type-based defaults. Makes the graph panel fully composable.
+     */
+    series?: GraphSeries[];
+}
+/**
+ * Slide-in panel that renders a vertical stack of sparkline charts for every
+ * sub-component metric, animated into view by `animPhase`.
+ *
+ * @example
+ * ```tsx
+ * <HistoricalGraphPanel
+ *   type="server"
+ *   name="APP-01"
+ *   context={{ cpuLoad: 72, memLoad: 60 }}
+ *   animPhase={1}
+ * />
+ * ```
+ */
+export default function HistoricalGraphPanel({ type, name, context, status, animPhase, series: externalSeries, }: HistoricalGraphPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=HistoricalGraphPanel.d.ts.map

package/dist/components/HistoricalGraphPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoricalGraphPanel.d.ts","sourceRoot":"","sources":["../../src/components/HistoricalGraphPanel.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAU5C;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AA0BD;;;;;;;;GAQG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAC3C,IAAI,EACJ,IAAI,EACJ,OAAY,EACZ,MAAiB,EACjB,SAAS,EACT,MAAM,EAAE,cAAc,GACvB,EAAE,yBAAyB,2CAqE3B"}

package/dist/components/HoloBase.d.ts

@@ -0,0 +1,41 @@
+import { ReactNode } from 'react';
+/**
+ * Props accepted by {@link HoloBase}.
+ *
+ * @property children   - The 3D component rendered above the holographic platform.
+ * @property size       - Diameter of the outermost ring in pixels (default `230`).
+ * @property widthRatio - Horizontal stretch multiplier; `1` = normal, `2` = twice as wide.
+ * @property color      - Primary holographic accent colour (default `"#00e5ff"`).
+ * @property label      - Optional label displayed below the base in uppercase monospace.
+ */
+interface HoloBaseProps {
+    children: ReactNode;
+    /** Diameter of the outermost ring px */
+    size?: number;
+    /**
+     * Horizontal stretch multiplier.
+     * 1 = normal (default), 2 = twice as wide, 0.5 = half as wide.
+     * Height is always unchanged.
+     */
+    widthRatio?: number;
+    /** Primary holographic color */
+    color?: string;
+    /** Label displayed below the base */
+    label?: string;
+}
+/**
+ * Holographic projection base component.
+ *
+ * Wraps `children` in a floating animation, overlays a scan-line, renders a
+ * multi-layer neon beam, concentric platform rings, and an optional label.
+ *
+ * @example
+ * ```tsx
+ * <HoloBase size={200} color="#00e5ff" label="SRV-001">
+ *   <Server3D />
+ * </HoloBase>
+ * ```
+ */
+export default function HoloBase({ children, size, widthRatio, color, label, }: HoloBaseProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=HoloBase.d.ts.map

package/dist/components/HoloBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HoloBase.d.ts","sourceRoot":"","sources":["../../src/components/HoloBase.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;;GAQG;AACH,UAAU,aAAa;IACrB,QAAQ,EAAE,SAAS,CAAC;IACpB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,EAC/B,QAAQ,EACR,IAAU,EACV,UAAc,EACd,KAAiB,EACjB,KAAK,GACN,EAAE,aAAa,2CA+Of"}

package/dist/components/Human3D.d.ts

@@ -0,0 +1,27 @@
+import { ComponentStatus } from '../theme';
+/**
+ * Props for the {@link Human3D} component.
+ *
+ * @property name   - Display name label below the figure (default `"USR-01"`).
+ * @property role   - Role or department label (default `"HR EMPLOYEE"`).
+ * @property status - Current health status governing accent colour.
+ * @property scale  - Uniform scale multiplier (default `1`).
+ */
+export interface Human3DProps {
+    name?: string;
+    role?: string;
+    status?: ComponentStatus;
+    scale?: number;
+}
+/**
+ * Renders a holographic SVG person-icon silhouette (head + shoulders) with
+ * name, role, and active-status indicator. Includes a floating animation
+ * and scan-line overlay.
+ *
+ * @example
+ * ```tsx
+ * <Human3D name="USR-42" role="SAP ADMIN" status="online" />
+ * ```
+ */
+export default function Human3D({ status, scale }: Human3DProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Human3D.d.ts.map

package/dist/components/Human3D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Human3D.d.ts","sourceRoot":"","sources":["../../src/components/Human3D.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,MAAiB,EAAE,KAAS,EAAE,EAAE,YAAY,2CA2G7E"}

package/dist/components/Internal3DComponents.d.ts

@@ -0,0 +1,132 @@
+import { ComponentStatus } from '../theme';
+/**
+ * Miniature CPU chip with a heat-spreader outline and a load-percentage fill bar.
+ *
+ * @param props.color  - Accent colour for borders and the load bar.
+ * @param props.label  - Text label rendered below the chip.
+ * @param props.status - Health status; non-`"online"` shows a blinking LED.
+ * @param props.load   - CPU load percentage (0–100) controlling the fill bar width.
+ *
+ * @example
+ * ```tsx
+ * <CPU3D color="#00e5ff" label="CPU-0" load={72} status="online" />
+ * ```
+ */
+export declare function CPU3D({ color, label, status, load, }: {
+    color?: string;
+    label?: string;
+    status?: ComponentStatus;
+    load?: number;
+    delay?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Miniature DIMM memory stick with four bank cells showing used-percentage fill.
+ *
+ * @param props.color       - Accent colour for borders and fill bars.
+ * @param props.label       - Text label rendered below the stick.
+ * @param props.status      - Health status; non-`"online"` shows a blinking LED.
+ * @param props.usedPercent - Memory utilisation percentage (0–100).
+ *
+ * @example
+ * ```tsx
+ * <Memory3D color="#8855ee" label="HEAP-0" usedPercent={82} status="warning" />
+ * ```
+ */
+export declare function Memory3D({ color, label, status, usedPercent, }: {
+    color?: string;
+    label?: string;
+    status?: ComponentStatus;
+    usedPercent?: number;
+    delay?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Small drive-bay block with an activity LED and a drive body slab.
+ *
+ * @param props.color    - Accent colour for borders and LED.
+ * @param props.label    - Text label rendered below the bay.
+ * @param props.status   - Health status forwarded to the inner {@link HoloBlock}.
+ * @param props.activity - When `true`, the activity LED is lit.
+ *
+ * @example
+ * ```tsx
+ * <DriveBay3D label="DRIVE-1" activity={true} status="online" />
+ * ```
+ */
+export declare function DriveBay3D({ color, label, status, activity, }: {
+    color?: string;
+    label?: string;
+    status?: ComponentStatus;
+    activity?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Miniature network interface block with four port outlines.
+ *
+ * @param props.color  - Accent colour for borders and port outlines.
+ * @param props.label  - Text label rendered below the block.
+ * @param props.status - Health status (currently unused visually but accepted for consistency).
+ *
+ * @example
+ * ```tsx
+ * <NetworkBlock3D label="NET" status="online" />
+ * ```
+ */
+export declare function NetworkBlock3D({ color, label, status: _status, }: {
+    color?: string;
+    label?: string;
+    status?: ComponentStatus;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Generic holographic block used for thread pools, worker pools, queues, and
+ * similar abstract sub-components.
+ *
+ * @param props.color  - Accent colour for borders and glow.
+ * @param props.label  - Text label rendered inside the block.
+ * @param props.status - Health status forwarded to the inner {@link HoloBlock}.
+ *
+ * @example
+ * ```tsx
+ * <ThreadPool3D label="THREAD-POOL" status="critical" />
+ * ```
+ */
+export declare function ThreadPool3D({ color, label, status, }: {
+    color?: string;
+    label?: string;
+    status?: ComponentStatus;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Miniature circular disk platter with a conic capacity-fill indicator.
+ *
+ * @param props.color           - Accent colour for borders and fill arc.
+ * @param props.label           - Text label rendered below the disk.
+ * @param props.status          - Health status; non-`"online"` shows a blinking LED.
+ * @param props.capacityPercent - Storage fill percentage (0–100) displayed as a conic gradient.
+ *
+ * @example
+ * ```tsx
+ * <Platter3D label="PLATTER-0" capacityPercent={72} status="online" />
+ * ```
+ */
+export declare function Platter3D({ color, label, status, capacityPercent, }: {
+    color?: string;
+    label?: string;
+    status?: ComponentStatus;
+    capacityPercent?: number;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Miniature network port with a top status LED and a socket body.
+ *
+ * @param props.color  - Accent colour for borders and LED.
+ * @param props.label  - Text label rendered below the port.
+ * @param props.status - Health status; non-`"online"` turns the LED red/orange and blinks.
+ *
+ * @example
+ * ```tsx
+ * <Port3D label="PORT-3" status="critical" />
+ * ```
+ */
+export declare function Port3D({ color, label, status, }: {
+    color?: string;
+    label?: string;
+    status?: ComponentStatus;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Internal3DComponents.d.ts.map

package/dist/components/Internal3DComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Internal3DComponents.d.ts","sourceRoot":"","sources":["../../src/components/Internal3DComponents.tsx"],"names":[],"mappings":"AAQA,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAgG1E;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,EAClB,KAAiB,EACjB,KAAe,EACf,MAAiB,EACjB,IAAQ,GACX,EAAE;IACC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,2CA2FA;AAGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,EACrB,KAAiB,EACjB,KAAgB,EAChB,MAAiB,EACjB,WAAe,GAClB,EAAE;IACC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,2CAkFA;AAGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EACvB,KAAiB,EACjB,KAAiB,EACjB,MAAiB,EACjB,QAAgB,GACnB,EAAE;IACC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,2CA+BA;AAGD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAC3B,KAAiB,EACjB,KAAa,EACb,MAAM,EAAE,OAAkB,GAC7B,EAAE;IACC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;CAC5B,2CAuDA;AAGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,EACzB,KAAiB,EACjB,KAAgB,EAChB,MAAiB,GACpB,EAAE;IACC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;CAC5B,2CAEA;AAGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,EACtB,KAAiB,EACjB,KAAmB,EACnB,MAAiB,EACjB,eAAmB,GACtB,EAAE;IACC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,2CAoEA;AAGD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,EACnB,KAAiB,EACjB,KAAgB,EAChB,MAAiB,GACpB,EAAE;IACC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;CAC5B,2CA4DA"}

package/dist/components/MessageServer3D.d.ts

@@ -0,0 +1,44 @@
+import { ComponentStatus } from '../theme';
+/**
+ * Props for the {@link MessageServer3D} component.
+ *
+ * @property rotateX    - Rotation around the X axis in degrees.
+ * @property rotateY    - Rotation around the Y axis in degrees.
+ * @property rotateZ    - Rotation around the Z axis in degrees.
+ * @property scale      - Uniform scale multiplier (default `1`).
+ * @property autoRotate - Continuously spin the appliance on its Y axis.
+ * @property status     - Current health status governing colour palette.
+ * @property name       - Hostname label rendered on the front face.
+ * @property queueDepth - Queue depth percentage (0–100).
+ * @property msgsPerSec - Message throughput in messages per second.
+ * @property instances  - Number of connected ABAP instances (max 5).
+ */
+export interface MessageServer3DProps {
+    rotateX?: number;
+    rotateY?: number;
+    rotateZ?: number;
+    scale?: number;
+    autoRotate?: boolean;
+    status?: ComponentStatus;
+    name?: string;
+    /** Queue depth 0–100 */
+    queueDepth?: number;
+    /** Messages per second */
+    msgsPerSec?: number;
+    /** Number of connected ABAP instances (max 5) */
+    instances?: number;
+    /** @internal Injected by FloatWrap — uses opaque face backgrounds. */
+    _compact?: boolean;
+}
+/**
+ * Renders a CSS-3D message server appliance with ABAP instance LEDs,
+ * queue-depth and MSG/s metrics, purple accent colouring, and optional
+ * auto-rotation.
+ *
+ * @example
+ * ```tsx
+ * <MessageServer3D status="online" queueDepth={45} msgsPerSec={230} instances={3} />
+ * ```
+ */
+export default function MessageServer3D({ rotateX, rotateY, rotateZ, scale, autoRotate, status, name, queueDepth, msgsPerSec, instances, _compact, }: MessageServer3DProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MessageServer3D.d.ts.map

package/dist/components/MessageServer3D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageServer3D.d.ts","sourceRoot":"","sources":["../../src/components/MessageServer3D.tsx"],"names":[],"mappings":"AAOA,OAAO,EAA4C,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAiB1F;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAmbD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,EACpC,OAAa,EACb,OAAY,EACZ,OAAW,EACX,KAAS,EACT,UAAkB,EAClB,MAAiB,EACjB,IAAmB,EACnB,UAAe,EACf,UAAgB,EAChB,SAAa,EACb,QAAQ,GACX,EAAE,oBAAoB,2CA2ItB"}

package/dist/components/NodeCallout.d.ts

@@ -0,0 +1,31 @@
+import { ComponentStatus } from '../theme';
+export interface NodeCalloutProps {
+    /** X position of the node this callout references (expanded topology). */
+    ex: number;
+    /** Y position of the node this callout references (expanded topology). */
+    ey: number;
+    /** Health status of the referenced component. Hidden when `"online"`. */
+    status: ComponentStatus | "offline";
+    /** Component display name (e.g. "WEB-DISP", "APP-01"). */
+    title: string;
+    /** Short diagnostic message shown in the callout body. */
+    msg: string;
+    /** Horizontal offset (px) from the node center to the label position. */
+    offsetX: number;
+    /** Vertical offset (px) from the node center to the label position. */
+    offsetY: number;
+    /** Whether the callout is visible (typically tied to the expanded view state). */
+    isVisible: boolean;
+    /** Callout alignment direction relative to its anchor point. Defaults to `"right"`. */
+    align?: "left" | "right" | "top" | "bottom";
+    /** Optional internal sub-component ID that is experiencing the issue (e.g. "HEAP-0", "PORT-3"). */
+    internalRef?: string;
+}
+/**
+ * Alert callout for a topology node.
+ *
+ * Renders nothing when `status` is `"online"`. Otherwise displays a
+ * leader line and diagnostic card in the specified direction.
+ */
+export default function NodeCallout({ ex, ey, status, title, msg, offsetX, offsetY, isVisible, align, internalRef, }: NodeCalloutProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=NodeCallout.d.ts.map

package/dist/components/NodeCallout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeCallout.d.ts","sourceRoot":"","sources":["../../src/components/NodeCallout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhD,MAAM,WAAW,gBAAgB;IAC7B,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,SAAS,EAAE,OAAO,CAAC;IACnB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC5C,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,EAChC,EAAE,EACF,EAAE,EACF,MAAM,EACN,KAAK,EACL,GAAG,EACH,OAAO,EACP,OAAO,EACP,SAAS,EACT,KAAe,EACf,WAAW,GACd,EAAE,gBAAgB,kDAgIlB"}