@vllnt/ui 0.2.1-canary.ab2c69a → 0.2.1-canary.bb791f1

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 (57) hide show
  1. package/dist/components/alert-pulse/alert-pulse.js +93 -0
  2. package/dist/components/alert-pulse/index.js +6 -0
  3. package/dist/components/bottom-activity-strip/bottom-activity-strip.js +91 -0
  4. package/dist/components/bottom-activity-strip/index.js +6 -0
  5. package/dist/components/comment-pin/comment-pin.js +104 -0
  6. package/dist/components/comment-pin/index.js +6 -0
  7. package/dist/components/context-lens/context-lens.js +98 -0
  8. package/dist/components/context-lens/index.js +6 -0
  9. package/dist/components/floating-toolbar/floating-toolbar.js +66 -0
  10. package/dist/components/floating-toolbar/index.js +6 -0
  11. package/dist/components/follow-mode/follow-mode.js +89 -0
  12. package/dist/components/follow-mode/index.js +6 -0
  13. package/dist/components/handoff-beacon/handoff-beacon.js +78 -0
  14. package/dist/components/handoff-beacon/index.js +6 -0
  15. package/dist/components/heat-overlay/heat-overlay.js +92 -0
  16. package/dist/components/heat-overlay/index.js +6 -0
  17. package/dist/components/index.js +108 -0
  18. package/dist/components/jarvis-dock/index.js +6 -0
  19. package/dist/components/jarvis-dock/jarvis-dock.js +98 -0
  20. package/dist/components/live-cursor/index.js +6 -0
  21. package/dist/components/live-cursor/live-cursor.js +62 -0
  22. package/dist/components/metric-cluster/index.js +6 -0
  23. package/dist/components/metric-cluster/metric-cluster.js +96 -0
  24. package/dist/components/multi-select-lasso/index.js +6 -0
  25. package/dist/components/multi-select-lasso/multi-select-lasso.js +76 -0
  26. package/dist/components/object-inspector/index.js +6 -0
  27. package/dist/components/object-inspector/object-inspector.js +136 -0
  28. package/dist/components/playback-ghost/index.js +6 -0
  29. package/dist/components/playback-ghost/playback-ghost.js +83 -0
  30. package/dist/components/policy-delivery-panel/index.js +6 -0
  31. package/dist/components/policy-delivery-panel/policy-delivery-panel.js +99 -0
  32. package/dist/components/presence-sync-indicator/index.js +6 -0
  33. package/dist/components/presence-sync-indicator/presence-sync-indicator.js +73 -0
  34. package/dist/components/property-section/index.js +6 -0
  35. package/dist/components/property-section/property-section.js +101 -0
  36. package/dist/components/relationship-inspector/index.js +6 -0
  37. package/dist/components/relationship-inspector/relationship-inspector.js +102 -0
  38. package/dist/components/routing-assignment-panel/index.js +6 -0
  39. package/dist/components/routing-assignment-panel/routing-assignment-panel.js +122 -0
  40. package/dist/components/run-timeline/index.js +6 -0
  41. package/dist/components/run-timeline/run-timeline.js +221 -0
  42. package/dist/components/runtime-overview-panel/index.js +6 -0
  43. package/dist/components/runtime-overview-panel/runtime-overview-panel.js +89 -0
  44. package/dist/components/selection-halo/index.js +6 -0
  45. package/dist/components/selection-halo/selection-halo.js +72 -0
  46. package/dist/components/snap-guides/index.js +6 -0
  47. package/dist/components/snap-guides/snap-guides.js +45 -0
  48. package/dist/components/state-badge-overlay/index.js +6 -0
  49. package/dist/components/state-badge-overlay/state-badge-overlay.js +90 -0
  50. package/dist/components/sticky-metric/index.js +6 -0
  51. package/dist/components/sticky-metric/sticky-metric.js +83 -0
  52. package/dist/components/threshold-ring/index.js +6 -0
  53. package/dist/components/threshold-ring/threshold-ring.js +160 -0
  54. package/dist/components/timeline-scrubber/index.js +6 -0
  55. package/dist/components/timeline-scrubber/timeline-scrubber.js +179 -0
  56. package/dist/index.d.ts +2168 -107
  57. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -3219,6 +3219,208 @@ type FloatingActionButtonProps = {
3219
3219
  declare function FloatingActionButtonImpl({ "aria-label": ariaLabel, children, className, onClick, position, }: FloatingActionButtonProps): React.ReactNode;
3220
3220
  declare const FloatingActionButton: react.MemoExoticComponent<typeof FloatingActionButtonImpl>;
3221
3221
 
3222
+ /**
3223
+ * One toolbar action.
3224
+ *
3225
+ * @public
3226
+ */
3227
+ type FloatingToolbarAction = {
3228
+ /** Optional aria-label override (defaults to the visible label). */
3229
+ ariaLabel?: string;
3230
+ /** When `true`, renders dimmed and ignores clicks. */
3231
+ disabled?: boolean;
3232
+ /** Optional leading glyph. */
3233
+ glyph?: ReactNode;
3234
+ /** Stable identifier. */
3235
+ id: string;
3236
+ /** Visible label. */
3237
+ label: ReactNode;
3238
+ /** Click handler. */
3239
+ onActivate: () => void;
3240
+ /** Optional emphasis level. Defaults to `"ghost"`. */
3241
+ variant?: "destructive" | "ghost" | "primary";
3242
+ };
3243
+ /**
3244
+ * Localizable strings.
3245
+ *
3246
+ * @public
3247
+ */
3248
+ type FloatingToolbarLabels = {
3249
+ /** Aria-label for the toolbar. Defaults to `"Selection actions"`. */
3250
+ region?: string;
3251
+ };
3252
+ /**
3253
+ * Props for {@link FloatingToolbar}.
3254
+ *
3255
+ * @public
3256
+ */
3257
+ type FloatingToolbarProps = {
3258
+ /** Toolbar actions in render order. */
3259
+ actions: FloatingToolbarAction[];
3260
+ /** Localizable strings. */
3261
+ labels?: FloatingToolbarLabels;
3262
+ /** X coordinate in container px (left edge of the toolbar). */
3263
+ x: number;
3264
+ /** Y coordinate in container px (bottom edge of the toolbar — the bar floats above this point). */
3265
+ y: number;
3266
+ } & Omit<ComponentPropsWithoutRef<"div">, "style">;
3267
+ /**
3268
+ * Compact action bar that floats above a selection. Pair with
3269
+ * {@link SelectionHalo} — surface the toolbar at the halo's top edge so
3270
+ * the user sees the available actions for the current selection.
3271
+ *
3272
+ * @example
3273
+ * ```tsx
3274
+ * <FloatingToolbar
3275
+ * x={120}
3276
+ * y={80}
3277
+ * actions={[
3278
+ * { id: "rename", label: "Rename", onActivate: rename, variant: "primary" },
3279
+ * { id: "duplicate", label: "Duplicate", onActivate: duplicate },
3280
+ * { id: "delete", label: "Delete", onActivate: remove, variant: "destructive" },
3281
+ * ]}
3282
+ * />
3283
+ * ```
3284
+ *
3285
+ * @public
3286
+ */
3287
+ declare const FloatingToolbar: react.ForwardRefExoticComponent<{
3288
+ /** Toolbar actions in render order. */
3289
+ actions: FloatingToolbarAction[];
3290
+ /** Localizable strings. */
3291
+ labels?: FloatingToolbarLabels;
3292
+ /** X coordinate in container px (left edge of the toolbar). */
3293
+ x: number;
3294
+ /** Y coordinate in container px (bottom edge of the toolbar — the bar floats above this point). */
3295
+ y: number;
3296
+ } & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "style"> & react.RefAttributes<HTMLDivElement>>;
3297
+
3298
+ /**
3299
+ * Geometric bounds of the selection in container px.
3300
+ *
3301
+ * @public
3302
+ */
3303
+ type SelectionBounds = {
3304
+ height: number;
3305
+ width: number;
3306
+ x: number;
3307
+ y: number;
3308
+ };
3309
+ /**
3310
+ * Localizable strings.
3311
+ *
3312
+ * @public
3313
+ */
3314
+ type SelectionHaloLabels = {
3315
+ /** Aria-label for the halo. Defaults to `"Selection"`. */
3316
+ region?: string;
3317
+ };
3318
+ /**
3319
+ * Props for {@link SelectionHalo}.
3320
+ *
3321
+ * @public
3322
+ */
3323
+ type SelectionHaloProps = {
3324
+ /** Selection bounds in container pixels. */
3325
+ bounds: SelectionBounds;
3326
+ /** Optional label rendered above the top-left corner. */
3327
+ label?: ReactNode;
3328
+ /** Localizable strings. */
3329
+ labels?: SelectionHaloLabels;
3330
+ /** When `true`, the ring pulses (use during multi-step transitions). */
3331
+ pulsing?: boolean;
3332
+ } & Omit<ComponentPropsWithoutRef<"div">, "style">;
3333
+ /**
3334
+ * Local-user selection halo for a canvas. Outlines a rectangular
3335
+ * region with a primary ring + handles at every corner. Pure
3336
+ * presentation — the host computes bounds (single object, group
3337
+ * bounding box, lasso result) and toggles the wrapper.
3338
+ *
3339
+ * Distinct from {@link SelectionPresence}: this halo represents the
3340
+ * **local** user's selection (with corner handles + label slot), while
3341
+ * `SelectionPresence` represents a remote participant's selection.
3342
+ *
3343
+ * @example
3344
+ * ```tsx
3345
+ * <SelectionHalo bounds={{ x: 80, y: 60, width: 200, height: 120 }} label="3 selected" />
3346
+ * ```
3347
+ *
3348
+ * @public
3349
+ */
3350
+ declare const SelectionHalo: react.ForwardRefExoticComponent<{
3351
+ /** Selection bounds in container pixels. */
3352
+ bounds: SelectionBounds;
3353
+ /** Optional label rendered above the top-left corner. */
3354
+ label?: ReactNode;
3355
+ /** Localizable strings. */
3356
+ labels?: SelectionHaloLabels;
3357
+ /** When `true`, the ring pulses (use during multi-step transitions). */
3358
+ pulsing?: boolean;
3359
+ } & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "style"> & react.RefAttributes<HTMLDivElement>>;
3360
+
3361
+ /**
3362
+ * One alignment line.
3363
+ *
3364
+ * @public
3365
+ */
3366
+ type SnapGuide = {
3367
+ /** Stable id (used as React key). */
3368
+ id: string;
3369
+ /** Horizontal guide — runs left to right at this `y` in container px. */
3370
+ orientation: "horizontal";
3371
+ y: number;
3372
+ } | {
3373
+ /** Stable id (used as React key). */
3374
+ id: string;
3375
+ /** Vertical guide — runs top to bottom at this `x` in container px. */
3376
+ orientation: "vertical";
3377
+ x: number;
3378
+ };
3379
+ /**
3380
+ * Localizable strings.
3381
+ *
3382
+ * @public
3383
+ */
3384
+ type SnapGuidesLabels = {
3385
+ /** Aria-label for the layer. Defaults to `"Snap guides"`. */
3386
+ region?: string;
3387
+ };
3388
+ /**
3389
+ * Props for {@link SnapGuides}.
3390
+ *
3391
+ * @public
3392
+ */
3393
+ type SnapGuidesProps = {
3394
+ /** Active alignment lines. Pass an empty array to hide all. */
3395
+ guides: SnapGuide[];
3396
+ /** Localizable strings. */
3397
+ labels?: SnapGuidesLabels;
3398
+ } & ComponentPropsWithoutRef<"div">;
3399
+ /**
3400
+ * Alignment guide overlay for a canvas. Renders dashed lines at the
3401
+ * `x` / `y` coordinates supplied by the host snapper. Pure
3402
+ * presentation — the host computes which guides are active during a
3403
+ * drag and unmounts them on release.
3404
+ *
3405
+ * @example
3406
+ * ```tsx
3407
+ * <SnapGuides
3408
+ * guides={[
3409
+ * { id: "x-200", orientation: "vertical", x: 200 },
3410
+ * { id: "y-160", orientation: "horizontal", y: 160 },
3411
+ * ]}
3412
+ * />
3413
+ * ```
3414
+ *
3415
+ * @public
3416
+ */
3417
+ declare const SnapGuides: react.ForwardRefExoticComponent<{
3418
+ /** Active alignment lines. Pass an empty array to hide all. */
3419
+ guides: SnapGuide[];
3420
+ /** Localizable strings. */
3421
+ labels?: SnapGuidesLabels;
3422
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
3423
+
3222
3424
  type KeyboardShortcut = {
3223
3425
  description: string;
3224
3426
  keys: readonly string[];
@@ -3399,6 +3601,133 @@ type HorizontalScrollRowProps = {
3399
3601
  };
3400
3602
  declare const HorizontalScrollRow: react.NamedExoticComponent<HorizontalScrollRowProps>;
3401
3603
 
3604
+ /**
3605
+ * Color theme for the follow ring + chip.
3606
+ *
3607
+ * @public
3608
+ */
3609
+ type FollowModeColor = "amber" | "blue" | "emerald" | "purple" | "red" | "rose";
3610
+ /**
3611
+ * Localizable strings.
3612
+ *
3613
+ * @public
3614
+ */
3615
+ type FollowModeLabels = {
3616
+ /** Aria-label for the follow chrome. Defaults to `"Follow mode"`. */
3617
+ region?: string;
3618
+ /** Stop-following button copy. Defaults to `"Stop"`. */
3619
+ stop?: string;
3620
+ };
3621
+ /**
3622
+ * Props for {@link FollowMode}.
3623
+ *
3624
+ * @public
3625
+ */
3626
+ type FollowModeProps = {
3627
+ /** Color theme. Defaults to `"blue"`. */
3628
+ color?: FollowModeColor;
3629
+ /** Localizable strings. */
3630
+ labels?: FollowModeLabels;
3631
+ /** Display name of the followed participant. */
3632
+ name: ReactNode;
3633
+ /** Fires when the user picks the stop-following button. */
3634
+ onStop?: () => void;
3635
+ } & Omit<ComponentPropsWithoutRef<"div">, "color">;
3636
+ /**
3637
+ * Follow-mode chrome. Wrap any region (typically the whole canvas) to
3638
+ * outline it with the followed participant's color and surface a
3639
+ * pinned chip + stop-following button. Pure presentation — the host
3640
+ * drives viewport sync and toggles the wrapper on / off.
3641
+ *
3642
+ * @example
3643
+ * ```tsx
3644
+ * <FollowMode color="emerald" name="Sam" onStop={stop}>
3645
+ * <CanvasView … />
3646
+ * </FollowMode>
3647
+ * ```
3648
+ *
3649
+ * @public
3650
+ */
3651
+ declare const FollowMode: react.ForwardRefExoticComponent<{
3652
+ /** Color theme. Defaults to `"blue"`. */
3653
+ color?: FollowModeColor;
3654
+ /** Localizable strings. */
3655
+ labels?: FollowModeLabels;
3656
+ /** Display name of the followed participant. */
3657
+ name: ReactNode;
3658
+ /** Fires when the user picks the stop-following button. */
3659
+ onStop?: () => void;
3660
+ } & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color"> & react.RefAttributes<HTMLDivElement>>;
3661
+
3662
+ /**
3663
+ * Beacon urgency.
3664
+ *
3665
+ * @public
3666
+ */
3667
+ type HandoffBeaconLevel = "info" | "request" | "urgent";
3668
+ /**
3669
+ * Localizable strings.
3670
+ *
3671
+ * @public
3672
+ */
3673
+ type HandoffBeaconLabels = {
3674
+ /** Aria-label for the beacon. Defaults to `"Attention"`. */
3675
+ region?: string;
3676
+ };
3677
+ /**
3678
+ * Props for {@link HandoffBeacon}.
3679
+ *
3680
+ * @public
3681
+ */
3682
+ type HandoffBeaconProps = {
3683
+ /** Localizable strings. */
3684
+ labels?: HandoffBeaconLabels;
3685
+ /** Urgency level. Defaults to `"info"`. */
3686
+ level?: HandoffBeaconLevel;
3687
+ /** Optional message body rendered inside the beacon. */
3688
+ message?: ReactNode;
3689
+ /** Origin participant name (who is requesting attention). */
3690
+ source?: ReactNode;
3691
+ /** X coordinate in container px. */
3692
+ x: number;
3693
+ /** Y coordinate in container px. */
3694
+ y: number;
3695
+ } & Omit<ComponentPropsWithoutRef<"div">, "style">;
3696
+ /**
3697
+ * Attention-routing beacon. Drop a beacon at the position a remote
3698
+ * participant wants to redirect attention to — the local user sees a
3699
+ * pulsing ring + optional message at that coordinate. Pure
3700
+ * presentation; the host pipes the request through your realtime
3701
+ * channel and unmounts the beacon on dismiss.
3702
+ *
3703
+ * @example
3704
+ * ```tsx
3705
+ * <HandoffBeacon
3706
+ * x={120}
3707
+ * y={80}
3708
+ * level="urgent"
3709
+ * source="Sam"
3710
+ * message="Take this — schema mismatch"
3711
+ * />
3712
+ * ```
3713
+ *
3714
+ * @public
3715
+ */
3716
+ declare const HandoffBeacon: react.ForwardRefExoticComponent<{
3717
+ /** Localizable strings. */
3718
+ labels?: HandoffBeaconLabels;
3719
+ /** Urgency level. Defaults to `"info"`. */
3720
+ level?: HandoffBeaconLevel;
3721
+ /** Optional message body rendered inside the beacon. */
3722
+ message?: ReactNode;
3723
+ /** Origin participant name (who is requesting attention). */
3724
+ source?: ReactNode;
3725
+ /** X coordinate in container px. */
3726
+ x: number;
3727
+ /** Y coordinate in container px. */
3728
+ y: number;
3729
+ } & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "style"> & react.RefAttributes<HTMLDivElement>>;
3730
+
3402
3731
  type ViewOption = {
3403
3732
  key: string;
3404
3733
  label: string;
@@ -3602,6 +3931,76 @@ declare const FlowFullscreen: react.NamedExoticComponent<FlowFullscreenProps>;
3602
3931
  */
3603
3932
  declare function useFlowDiagram(options?: UseFlowDiagramOptions): UseFlowDiagramReturn;
3604
3933
 
3934
+ /**
3935
+ * Severity tone of an alert pulse — drives the ring color.
3936
+ *
3937
+ * @public
3938
+ */
3939
+ type AlertPulseSeverity = "error" | "info" | "warn";
3940
+ /**
3941
+ * Localizable strings.
3942
+ *
3943
+ * @public
3944
+ */
3945
+ type AlertPulseLabels = {
3946
+ /** Override for the aria-label. Defaults to severity name. */
3947
+ region?: string;
3948
+ };
3949
+ /**
3950
+ * Props for {@link AlertPulse}.
3951
+ *
3952
+ * @public
3953
+ */
3954
+ type AlertPulseProps = {
3955
+ /** Center X of the pulse in canvas pixels. */
3956
+ cx: number;
3957
+ /** Center Y of the pulse in canvas pixels. */
3958
+ cy: number;
3959
+ /** Localizable strings. */
3960
+ labels?: AlertPulseLabels;
3961
+ /** Outer ring radius in pixels. Defaults to `36`. */
3962
+ radius?: number;
3963
+ /** Disable the pulse animation. Useful for snapshots. Defaults to `false`. */
3964
+ reducedMotion?: boolean;
3965
+ /** Severity tone. Defaults to `"warn"`. */
3966
+ severity?: AlertPulseSeverity;
3967
+ } & ComponentPropsWithoutRef<"svg">;
3968
+ /**
3969
+ * Pulsing ring overlay drawn around an alerting canvas object. The
3970
+ * outer ring expands and fades to communicate "attention here";
3971
+ * the inner ring stays put so the object remains anchored. Pure
3972
+ * presentation; the host computes the center + severity from the
3973
+ * runtime alert stream.
3974
+ *
3975
+ * Render inside a `position: relative` parent that shares the canvas
3976
+ * pixel coordinate space; the SVG is `pointer-events: none` so host
3977
+ * gestures pass through.
3978
+ *
3979
+ * @example
3980
+ * ```tsx
3981
+ * <div className="relative h-screen w-screen">
3982
+ * <Canvas />
3983
+ * <AlertPulse cx={480} cy={320} severity="error" />
3984
+ * </div>
3985
+ * ```
3986
+ *
3987
+ * @public
3988
+ */
3989
+ declare const AlertPulse: react.ForwardRefExoticComponent<{
3990
+ /** Center X of the pulse in canvas pixels. */
3991
+ cx: number;
3992
+ /** Center Y of the pulse in canvas pixels. */
3993
+ cy: number;
3994
+ /** Localizable strings. */
3995
+ labels?: AlertPulseLabels;
3996
+ /** Outer ring radius in pixels. Defaults to `36`. */
3997
+ radius?: number;
3998
+ /** Disable the pulse animation. Useful for snapshots. Defaults to `false`. */
3999
+ reducedMotion?: boolean;
4000
+ /** Severity tone. Defaults to `"warn"`. */
4001
+ severity?: AlertPulseSeverity;
4002
+ } & Omit<react.SVGProps<SVGSVGElement>, "ref"> & react.RefAttributes<SVGSVGElement>>;
4003
+
3605
4004
  type AnchorPortProps = React.ComponentPropsWithoutRef<"span"> & {
3606
4005
  side?: "bottom" | "left" | "right" | "top";
3607
4006
  state?: "active" | "blocked" | "idle";
@@ -3613,34 +4012,264 @@ declare const AnchorPort: react.ForwardRefExoticComponent<Omit<react.DetailedHTM
3613
4012
  tone?: "bidirectional" | "input" | "output";
3614
4013
  } & react.RefAttributes<HTMLSpanElement>>;
3615
4014
 
3616
- type ConnectorEdgePoint = {
3617
- x: number;
3618
- y: number;
3619
- };
3620
- type ConnectorEdgeProps = React.ComponentPropsWithoutRef<"div"> & {
3621
- end: ConnectorEdgePoint;
3622
- label?: string;
3623
- start: ConnectorEdgePoint;
3624
- state?: "active" | "blocked" | "idle";
4015
+ /**
4016
+ * Tone of an event — drives the leading dot color.
4017
+ *
4018
+ * @public
4019
+ */
4020
+ type ActivityStripTone = "danger" | "info" | "neutral" | "success" | "warn";
4021
+ /**
4022
+ * One event in the strip.
4023
+ *
4024
+ * @public
4025
+ */
4026
+ type ActivityEvent = {
4027
+ /** Stable identifier — used as the React key + analytics hook. */
4028
+ id: string;
4029
+ /** Short label (e.g. `"deploy completed"`). */
4030
+ label: ReactNode;
4031
+ /** Optional click handler — when provided, the chip becomes a button. */
4032
+ onActivate?: () => void;
4033
+ /** Optional tone for the leading dot. Defaults to `"neutral"`. */
4034
+ tone?: ActivityStripTone;
4035
+ /** Pre-formatted timestamp (host owns formatting). */
4036
+ ts: ReactNode;
3625
4037
  };
3626
- declare const ConnectorEdge: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
3627
- end: ConnectorEdgePoint;
3628
- label?: string;
3629
- start: ConnectorEdgePoint;
3630
- state?: "active" | "blocked" | "idle";
3631
- } & react.RefAttributes<HTMLDivElement>>;
3632
-
3633
- type EdgeLabelProps = React.ComponentPropsWithoutRef<"span"> & {
3634
- emphasis?: "active" | "subtle";
4038
+ /**
4039
+ * Localizable strings.
4040
+ *
4041
+ * @public
4042
+ */
4043
+ type BottomActivityStripLabels = {
4044
+ /** Empty-state copy. Defaults to `"No recent activity"`. */
4045
+ empty?: string;
4046
+ /** Aria-label for the strip. Defaults to `"Recent activity"`. */
4047
+ region?: string;
3635
4048
  };
3636
- declare const EdgeLabel: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & {
3637
- emphasis?: "active" | "subtle";
3638
- } & react.RefAttributes<HTMLSpanElement>>;
4049
+ /**
4050
+ * Props for {@link BottomActivityStrip}.
4051
+ *
4052
+ * @public
4053
+ */
4054
+ type BottomActivityStripProps = {
4055
+ /** Event entries — newest first. */
4056
+ events: ActivityEvent[];
4057
+ /** Localizable strings. */
4058
+ labels?: BottomActivityStripLabels;
4059
+ /** Cap the rendered events. The component drops the tail without warning. */
4060
+ maxEvents?: number;
4061
+ } & ComponentPropsWithoutRef<"section">;
4062
+ /**
4063
+ * Slim bottom strip showing a horizontally-scrolling row of recent
4064
+ * canvas events. The lowest-noise live execution surface — keep
4065
+ * `ObjectCard`, panels, and overlays for high-value surfaces; let the
4066
+ * strip carry the steady drip of activity.
4067
+ *
4068
+ * Pure presentation; the host computes the event list (newest first)
4069
+ * and supplies an optional `onActivate` per event to jump to the
4070
+ * related object.
4071
+ *
4072
+ * Distinct from `ActivityLog` (vertical, persistent) and `LiveFeed`
4073
+ * (full-height feed): this primitive is a single horizontal row that
4074
+ * lives at the bottom of the canvas.
4075
+ *
4076
+ * @example
4077
+ * ```tsx
4078
+ * <BottomActivityStrip
4079
+ * events={[
4080
+ * { id: "1", label: "deploy ok", ts: "12s", tone: "success" },
4081
+ * { id: "2", label: "queue spike", ts: "1m", tone: "warn" },
4082
+ * ]}
4083
+ * maxEvents={20}
4084
+ * />
4085
+ * ```
4086
+ *
4087
+ * @public
4088
+ */
4089
+ declare const BottomActivityStrip: react.ForwardRefExoticComponent<{
4090
+ /** Event entries — newest first. */
4091
+ events: ActivityEvent[];
4092
+ /** Localizable strings. */
4093
+ labels?: BottomActivityStripLabels;
4094
+ /** Cap the rendered events. The component drops the tail without warning. */
4095
+ maxEvents?: number;
4096
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
3639
4097
 
3640
- type GroupHullProps = React.ComponentPropsWithoutRef<"section"> & {
3641
- description?: string;
3642
- eyebrow?: ReactNode;
3643
- title: string;
4098
+ /**
4099
+ * Resolution state of a pinned comment.
4100
+ *
4101
+ * @public
4102
+ */
4103
+ type CommentPinState = "open" | "resolved";
4104
+ /**
4105
+ * Localizable strings.
4106
+ *
4107
+ * @public
4108
+ */
4109
+ type CommentPinLabels = {
4110
+ /** Aria-label override. Defaults to `"Comment"`. */
4111
+ region?: string;
4112
+ /** Suffix appended after the unread count for screen readers. */
4113
+ unreadSuffix?: string;
4114
+ };
4115
+ /**
4116
+ * Props for {@link CommentPin}.
4117
+ *
4118
+ * @public
4119
+ */
4120
+ type CommentPinProps = {
4121
+ /** Optional author initial / glyph rendered inside the pin. */
4122
+ authorInitial?: ReactNode;
4123
+ /** Optional accent color for the pin. Defaults to the foreground. */
4124
+ color?: string;
4125
+ /** Localizable strings. */
4126
+ labels?: CommentPinLabels;
4127
+ /** Click handler — when provided, the pin becomes a button. */
4128
+ onActivate?: () => void;
4129
+ /** State of the underlying thread. Defaults to `"open"`. */
4130
+ state?: CommentPinState;
4131
+ /** Optional unread reply count. Renders as a small numeric badge. */
4132
+ unread?: number;
4133
+ /** Anchor X in canvas pixels. */
4134
+ x: number;
4135
+ /** Anchor Y in canvas pixels. */
4136
+ y: number;
4137
+ } & ComponentPropsWithoutRef<"div">;
4138
+ /**
4139
+ * Anchored discussion pin rendered at canvas coordinates. Use to mark
4140
+ * an object-anchored comment thread; click to expand into a
4141
+ * {@link "../thread-bubble/thread-bubble".ThreadBubble} (or whatever the host wires up).
4142
+ *
4143
+ * Pure presentation; the host owns the thread store + supplies the
4144
+ * unread count and resolution state.
4145
+ *
4146
+ * @example
4147
+ * ```tsx
4148
+ * <div className="relative h-screen w-screen">
4149
+ * <Canvas />
4150
+ * <CommentPin
4151
+ * x={420} y={180}
4152
+ * authorInitial="B"
4153
+ * unread={3}
4154
+ * onActivate={() => openThread("c-1")}
4155
+ * />
4156
+ * </div>
4157
+ * ```
4158
+ *
4159
+ * @public
4160
+ */
4161
+ declare const CommentPin: react.ForwardRefExoticComponent<{
4162
+ /** Optional author initial / glyph rendered inside the pin. */
4163
+ authorInitial?: ReactNode;
4164
+ /** Optional accent color for the pin. Defaults to the foreground. */
4165
+ color?: string;
4166
+ /** Localizable strings. */
4167
+ labels?: CommentPinLabels;
4168
+ /** Click handler — when provided, the pin becomes a button. */
4169
+ onActivate?: () => void;
4170
+ /** State of the underlying thread. Defaults to `"open"`. */
4171
+ state?: CommentPinState;
4172
+ /** Optional unread reply count. Renders as a small numeric badge. */
4173
+ unread?: number;
4174
+ /** Anchor X in canvas pixels. */
4175
+ x: number;
4176
+ /** Anchor Y in canvas pixels. */
4177
+ y: number;
4178
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
4179
+
4180
+ type ConnectorEdgePoint = {
4181
+ x: number;
4182
+ y: number;
4183
+ };
4184
+ type ConnectorEdgeProps = React.ComponentPropsWithoutRef<"div"> & {
4185
+ end: ConnectorEdgePoint;
4186
+ label?: string;
4187
+ start: ConnectorEdgePoint;
4188
+ state?: "active" | "blocked" | "idle";
4189
+ };
4190
+ declare const ConnectorEdge: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
4191
+ end: ConnectorEdgePoint;
4192
+ label?: string;
4193
+ start: ConnectorEdgePoint;
4194
+ state?: "active" | "blocked" | "idle";
4195
+ } & react.RefAttributes<HTMLDivElement>>;
4196
+
4197
+ /**
4198
+ * Focus point — pixel coordinates relative to the canvas viewport.
4199
+ *
4200
+ * @public
4201
+ */
4202
+ type ContextLensFocus = {
4203
+ /** Center X of the lens. */
4204
+ cx: number;
4205
+ /** Center Y of the lens. */
4206
+ cy: number;
4207
+ /** Inner radius — fully transparent inside this circle. */
4208
+ inner: number;
4209
+ /** Outer radius — full dim beyond this circle. */
4210
+ outer: number;
4211
+ };
4212
+ /**
4213
+ * Localizable strings.
4214
+ *
4215
+ * @public
4216
+ */
4217
+ type ContextLensLabels = {
4218
+ /** Aria-label for the lens layer. Defaults to `"Context lens"`. */
4219
+ region?: string;
4220
+ };
4221
+ /**
4222
+ * Props for {@link ContextLens}.
4223
+ *
4224
+ * @public
4225
+ */
4226
+ type ContextLensProps = {
4227
+ /** Lens geometry. When `null`, no lens renders (full surface unobscured). */
4228
+ focus: ContextLensFocus | null;
4229
+ /** Localizable strings. */
4230
+ labels?: ContextLensLabels;
4231
+ /** Dim opacity outside the outer ring (0..1). Defaults to `0.55`. */
4232
+ opacity?: number;
4233
+ } & ComponentPropsWithoutRef<"svg">;
4234
+ /**
4235
+ * Vignette overlay that dims the canvas outside a circular focus
4236
+ * region. Use to draw the eye to a selection, an active run, or any
4237
+ * single object the user must attend to. Pure presentation; the host
4238
+ * computes the focus center + radii from the active selection's
4239
+ * bounding box.
4240
+ *
4241
+ * The lens is `pointer-events: none` — host gestures pass through.
4242
+ *
4243
+ * @example
4244
+ * ```tsx
4245
+ * <div className="relative h-screen w-screen">
4246
+ * <Canvas />
4247
+ * <ContextLens focus={{ cx: 480, cy: 320, inner: 90, outer: 180 }} />
4248
+ * </div>
4249
+ * ```
4250
+ *
4251
+ * @public
4252
+ */
4253
+ declare const ContextLens: react.ForwardRefExoticComponent<{
4254
+ /** Lens geometry. When `null`, no lens renders (full surface unobscured). */
4255
+ focus: ContextLensFocus | null;
4256
+ /** Localizable strings. */
4257
+ labels?: ContextLensLabels;
4258
+ /** Dim opacity outside the outer ring (0..1). Defaults to `0.55`. */
4259
+ opacity?: number;
4260
+ } & Omit<react.SVGProps<SVGSVGElement>, "ref"> & react.RefAttributes<SVGSVGElement>>;
4261
+
4262
+ type EdgeLabelProps = React.ComponentPropsWithoutRef<"span"> & {
4263
+ emphasis?: "active" | "subtle";
4264
+ };
4265
+ declare const EdgeLabel: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & {
4266
+ emphasis?: "active" | "subtle";
4267
+ } & react.RefAttributes<HTMLSpanElement>>;
4268
+
4269
+ type GroupHullProps = React.ComponentPropsWithoutRef<"section"> & {
4270
+ description?: string;
4271
+ eyebrow?: ReactNode;
4272
+ title: string;
3644
4273
  };
3645
4274
  declare const GroupHull: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & {
3646
4275
  description?: string;
@@ -3648,128 +4277,1226 @@ declare const GroupHull: react.ForwardRefExoticComponent<Omit<react.DetailedHTML
3648
4277
  title: string;
3649
4278
  } & react.RefAttributes<HTMLElement>>;
3650
4279
 
3651
- type ObjectCardMetric = {
3652
- label: string;
3653
- value: ReactNode;
4280
+ /**
4281
+ * Tone of the heat gradient — drives the inner circle color.
4282
+ *
4283
+ * @public
4284
+ */
4285
+ type HeatOverlayTone = "cool" | "danger" | "neutral" | "warn";
4286
+ /**
4287
+ * One heat sample.
4288
+ *
4289
+ * @public
4290
+ */
4291
+ type HeatPoint = {
4292
+ /** Stable identifier — used as the React key. */
4293
+ id: string;
4294
+ /** Optional per-point tone override. */
4295
+ tone?: HeatOverlayTone;
4296
+ /** Sample weight `0..1` — drives the circle opacity + radius. */
4297
+ weight: number;
4298
+ /** X coordinate in canvas pixels. */
4299
+ x: number;
4300
+ /** Y coordinate in canvas pixels. */
4301
+ y: number;
3654
4302
  };
3655
- type ObjectCardAction = {
3656
- label: string;
3657
- onClick?: () => void;
4303
+ /**
4304
+ * Localizable strings.
4305
+ *
4306
+ * @public
4307
+ */
4308
+ type HeatOverlayLabels = {
4309
+ /** Aria-label override. Defaults to `"Heat overlay"`. */
4310
+ region?: string;
3658
4311
  };
3659
- type ObjectCardProps = React.ComponentPropsWithoutRef<"article"> & {
3660
- actions?: ObjectCardAction[];
3661
- footer?: ReactNode;
3662
- kind?: string;
3663
- metrics?: ObjectCardMetric[];
3664
- ports?: ReactNode;
3665
- state?: "blocked" | "complete" | "idle" | "running";
3666
- summary?: string;
3667
- title: string;
4312
+ /**
4313
+ * Props for {@link HeatOverlay}.
4314
+ *
4315
+ * @public
4316
+ */
4317
+ type HeatOverlayProps = {
4318
+ /** Optional global tone applied to every point that omits its own. Defaults to `"warn"`. */
4319
+ defaultTone?: HeatOverlayTone;
4320
+ /** Sample radius in pixels at full weight. Defaults to `48`. */
4321
+ intensity?: number;
4322
+ /** Localizable strings. */
4323
+ labels?: HeatOverlayLabels;
4324
+ /** Sample points in render order. */
4325
+ points: HeatPoint[];
4326
+ } & ComponentPropsWithoutRef<"svg">;
4327
+ /**
4328
+ * Heatmap-style overlay drawn on top of a canvas. Each sample renders
4329
+ * as a soft radial blob whose radius + opacity scale with its weight.
4330
+ * Pure presentation; the host computes the point list from the
4331
+ * activity stream.
4332
+ *
4333
+ * Render inside a `position: relative` parent that shares the canvas
4334
+ * pixel coordinate space; the SVG is `pointer-events: none` so host
4335
+ * gestures pass through.
4336
+ *
4337
+ * @example
4338
+ * ```tsx
4339
+ * <div className="relative h-screen w-screen">
4340
+ * <Canvas />
4341
+ * <HeatOverlay
4342
+ * points={[
4343
+ * { id: "a", x: 120, y: 80, weight: 1.0, tone: "danger" },
4344
+ * { id: "b", x: 320, y: 220, weight: 0.4 },
4345
+ * ]}
4346
+ * />
4347
+ * </div>
4348
+ * ```
4349
+ *
4350
+ * @public
4351
+ */
4352
+ declare const HeatOverlay: react.ForwardRefExoticComponent<{
4353
+ /** Optional global tone applied to every point that omits its own. Defaults to `"warn"`. */
4354
+ defaultTone?: HeatOverlayTone;
4355
+ /** Sample radius in pixels at full weight. Defaults to `48`. */
4356
+ intensity?: number;
4357
+ /** Localizable strings. */
4358
+ labels?: HeatOverlayLabels;
4359
+ /** Sample points in render order. */
4360
+ points: HeatPoint[];
4361
+ } & Omit<react.SVGProps<SVGSVGElement>, "ref"> & react.RefAttributes<SVGSVGElement>>;
4362
+
4363
+ /**
4364
+ * Tone of a dock action — drives its accent color.
4365
+ *
4366
+ * @public
4367
+ */
4368
+ type JarvisDockTone = "danger" | "neutral" | "primary" | "success";
4369
+ /**
4370
+ * One action button slotted in the dock.
4371
+ *
4372
+ * @public
4373
+ */
4374
+ type JarvisDockAction = {
4375
+ /** Optional badge value rendered as a small dot or count. */
4376
+ badge?: ReactNode;
4377
+ /** Glyph rendered above the label (single character or icon). */
4378
+ glyph: ReactNode;
4379
+ /** Stable identifier — used as the React key + analytics hook. */
4380
+ id: string;
4381
+ /** Short label shown beneath the glyph. */
4382
+ label: ReactNode;
4383
+ /** Click handler. */
4384
+ onActivate: () => void;
4385
+ /** Optional tone. Defaults to `"neutral"`. */
4386
+ tone?: JarvisDockTone;
3668
4387
  };
3669
- declare const ObjectCard: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & {
3670
- actions?: ObjectCardAction[];
3671
- footer?: ReactNode;
3672
- kind?: string;
3673
- metrics?: ObjectCardMetric[];
3674
- ports?: ReactNode;
3675
- state?: "blocked" | "complete" | "idle" | "running";
3676
- summary?: string;
3677
- title: string;
3678
- } & react.RefAttributes<HTMLElement>>;
4388
+ /**
4389
+ * Localizable strings.
4390
+ *
4391
+ * @public
4392
+ */
4393
+ type JarvisDockLabels = {
4394
+ /** Aria-label for the command-palette trigger. Defaults to `"Open command palette"`. */
4395
+ paletteTrigger?: string;
4396
+ /** Aria-label for the dock. Defaults to `"Jarvis dock"`. */
4397
+ region?: string;
4398
+ };
4399
+ /**
4400
+ * Props for {@link JarvisDock}.
4401
+ *
4402
+ * @public
4403
+ */
4404
+ type JarvisDockProps = {
4405
+ /** Action buttons in render order. */
4406
+ actions: JarvisDockAction[];
4407
+ /** Localizable strings. */
4408
+ labels?: JarvisDockLabels;
4409
+ /** Optional handler for the "..." command-palette trigger. */
4410
+ onOpenPalette?: () => void;
4411
+ } & ComponentPropsWithoutRef<"nav">;
4412
+ /**
4413
+ * Floating bottom dock for the spatial canvas. Renders a compact row
4414
+ * of agent / quick-action buttons plus a trailing command-palette
4415
+ * trigger. Pure presentation; the host wires `onActivate` per action
4416
+ * and `onOpenPalette` for the palette button.
4417
+ *
4418
+ * @example
4419
+ * ```tsx
4420
+ * <JarvisDock
4421
+ * actions={[
4422
+ * { id: "summon", glyph: "+", label: "Summon", tone: "primary",
4423
+ * onActivate: () => spawnAgent() },
4424
+ * { id: "review", glyph: "✓", label: "Review", tone: "success",
4425
+ * onActivate: () => openReview() },
4426
+ * ]}
4427
+ * onOpenPalette={() => openCommandPalette()}
4428
+ * />
4429
+ * ```
4430
+ *
4431
+ * @public
4432
+ */
4433
+ declare const JarvisDock: react.ForwardRefExoticComponent<{
4434
+ /** Action buttons in render order. */
4435
+ actions: JarvisDockAction[];
4436
+ /** Localizable strings. */
4437
+ labels?: JarvisDockLabels;
4438
+ /** Optional handler for the "..." command-palette trigger. */
4439
+ onOpenPalette?: () => void;
4440
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
3679
4441
 
3680
- type ObjectHandleProps = Omit<React.ComponentPropsWithoutRef<"button">, "type"> & {
3681
- hint?: ReactNode;
4442
+ /**
4443
+ * Localizable strings.
4444
+ *
4445
+ * @public
4446
+ */
4447
+ type LiveCursorLabels = {
4448
+ /** Aria-label override. Defaults to `"Live cursor"`. */
4449
+ region?: string;
4450
+ };
4451
+ /**
4452
+ * Props for {@link LiveCursor}.
4453
+ *
4454
+ * @public
4455
+ */
4456
+ type LiveCursorProps = {
4457
+ /** Tailwind / arbitrary CSS color used for the pointer + name chip. Defaults to `var(--foreground)`. */
4458
+ color?: string;
4459
+ /** Localizable strings. */
4460
+ labels?: LiveCursorLabels;
4461
+ /** Display name shown in the chip. Pass `null` to hide the chip. */
4462
+ name?: ReactNode;
4463
+ /** Optional secondary line in the chip (e.g. status, role). */
4464
+ status?: ReactNode;
4465
+ /** Cursor X in canvas pixels. */
4466
+ x: number;
4467
+ /** Cursor Y in canvas pixels. */
4468
+ y: number;
4469
+ } & ComponentPropsWithoutRef<"div">;
4470
+ /**
4471
+ * Remote user's cursor rendered at canvas coordinates with an optional
4472
+ * name + status chip. Pure presentation; the host owns the websocket
4473
+ * stream + maps user ids to colors.
4474
+ *
4475
+ * The wrapper is `pointer-events: none` so host gestures pass through.
4476
+ *
4477
+ * @example
4478
+ * ```tsx
4479
+ * <div className="relative h-screen w-screen">
4480
+ * <Canvas />
4481
+ * <LiveCursor x={420} y={180} name="Bea" color="#5b8def" />
4482
+ * </div>
4483
+ * ```
4484
+ *
4485
+ * @public
4486
+ */
4487
+ declare const LiveCursor: react.ForwardRefExoticComponent<{
4488
+ /** Tailwind / arbitrary CSS color used for the pointer + name chip. Defaults to `var(--foreground)`. */
4489
+ color?: string;
4490
+ /** Localizable strings. */
4491
+ labels?: LiveCursorLabels;
4492
+ /** Display name shown in the chip. Pass `null` to hide the chip. */
4493
+ name?: ReactNode;
4494
+ /** Optional secondary line in the chip (e.g. status, role). */
4495
+ status?: ReactNode;
4496
+ /** Cursor X in canvas pixels. */
4497
+ x: number;
4498
+ /** Cursor Y in canvas pixels. */
4499
+ y: number;
4500
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
4501
+
4502
+ /**
4503
+ * Tone of a single metric line — drives the dot color.
4504
+ *
4505
+ * @public
4506
+ */
4507
+ type MetricClusterTone = "danger" | "neutral" | "success" | "warn";
4508
+ /**
4509
+ * Anchor corner relative to the canvas object the cluster attaches to.
4510
+ *
4511
+ * @public
4512
+ */
4513
+ type MetricClusterAnchor = "bottom-left" | "bottom-right" | "top-left" | "top-right";
4514
+ /**
4515
+ * One metric in the cluster.
4516
+ *
4517
+ * @public
4518
+ */
4519
+ type MetricClusterEntry = {
4520
+ /** Stable identifier — used as the React key + analytics hook. */
4521
+ id: string;
4522
+ /** Short label (e.g. `"errs/min"`). */
4523
+ label: ReactNode;
4524
+ /** Optional tone for the leading dot. Defaults to `"neutral"`. */
4525
+ tone?: MetricClusterTone;
4526
+ /** Display value (already formatted by host). */
4527
+ value: ReactNode;
4528
+ };
4529
+ /**
4530
+ * Localizable strings.
4531
+ *
4532
+ * @public
4533
+ */
4534
+ type MetricClusterLabels = {
4535
+ /** Aria-label override. Defaults to `"Metric cluster"`. */
4536
+ region?: string;
4537
+ };
4538
+ /**
4539
+ * Props for {@link MetricCluster}.
4540
+ *
4541
+ * @public
4542
+ */
4543
+ type MetricClusterProps = {
4544
+ /** Anchor corner. Defaults to `"top-right"`. */
4545
+ anchor?: MetricClusterAnchor;
4546
+ /** Localizable strings. */
4547
+ labels?: MetricClusterLabels;
4548
+ /** Metric entries in render order. */
4549
+ metrics: MetricClusterEntry[];
4550
+ /** Optional cluster title rendered above the rows. */
4551
+ title?: ReactNode;
4552
+ /** Anchor X in canvas pixels. */
4553
+ x: number;
4554
+ /** Anchor Y in canvas pixels. */
4555
+ y: number;
4556
+ } & ComponentPropsWithoutRef<"div">;
4557
+ /**
4558
+ * Compact stack of related metrics pinned to a canvas object's corner.
4559
+ * Use when a single `StickyMetric` doesn't carry enough signal — for
4560
+ * runs whose throughput, latency, and error rate must all be visible
4561
+ * at once. Pure presentation; the host supplies the anchor coords + the
4562
+ * metric list.
4563
+ *
4564
+ * The wrapper is `pointer-events: none` — host gestures pass through.
4565
+ *
4566
+ * @example
4567
+ * ```tsx
4568
+ * <MetricCluster
4569
+ * x={420} y={180}
4570
+ * anchor="top-right"
4571
+ * title="research-2025"
4572
+ * metrics={[
4573
+ * { id: "qps", label: "qps", value: "240", tone: "success" },
4574
+ * { id: "errs", label: "errs", value: "14", tone: "danger" },
4575
+ * { id: "p95", label: "p95", value: "180ms" },
4576
+ * ]}
4577
+ * />
4578
+ * ```
4579
+ *
4580
+ * @public
4581
+ */
4582
+ declare const MetricCluster: react.ForwardRefExoticComponent<{
4583
+ /** Anchor corner. Defaults to `"top-right"`. */
4584
+ anchor?: MetricClusterAnchor;
4585
+ /** Localizable strings. */
4586
+ labels?: MetricClusterLabels;
4587
+ /** Metric entries in render order. */
4588
+ metrics: MetricClusterEntry[];
4589
+ /** Optional cluster title rendered above the rows. */
4590
+ title?: ReactNode;
4591
+ /** Anchor X in canvas pixels. */
4592
+ x: number;
4593
+ /** Anchor Y in canvas pixels. */
4594
+ y: number;
4595
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
4596
+
4597
+ /**
4598
+ * Lasso geometry — pixel coordinates on the underlying canvas.
4599
+ *
4600
+ * @public
4601
+ */
4602
+ type LassoRect = {
4603
+ /** Height in pixels (always positive after normalization). */
4604
+ height: number;
4605
+ /** Width in pixels (always positive after normalization). */
4606
+ width: number;
4607
+ /** Left edge in pixels. */
4608
+ x: number;
4609
+ /** Top edge in pixels. */
4610
+ y: number;
4611
+ };
4612
+ /**
4613
+ * Localizable strings.
4614
+ *
4615
+ * @public
4616
+ */
4617
+ type MultiSelectLassoLabels = {
4618
+ /** Plural noun for the count badge. Defaults to `"items"`. */
4619
+ plural?: string;
4620
+ /** Aria-label for the lasso layer. Defaults to `"Multi-select lasso"`. */
4621
+ region?: string;
4622
+ /** Singular noun for the count badge. Defaults to `"item"`. */
4623
+ singular?: string;
4624
+ };
4625
+ /**
4626
+ * Props for {@link MultiSelectLasso}.
4627
+ *
4628
+ * @public
4629
+ */
4630
+ type MultiSelectLassoProps = {
4631
+ /** Optional count badge — rendered near the bottom-right corner. */
4632
+ count?: number;
4633
+ /** Optional override slot rendered inside the lasso (e.g. a label). */
4634
+ hint?: ReactNode;
4635
+ /** Localizable strings. */
4636
+ labels?: MultiSelectLassoLabels;
4637
+ /** Drag rectangle in pixels. When `null`, nothing renders. */
4638
+ rect: LassoRect | null;
4639
+ } & ComponentPropsWithoutRef<"div">;
4640
+ /**
4641
+ * Selection rectangle for canvas multi-select. Render as a sibling of
4642
+ * the canvas with `position: absolute` parent so the `rect` coordinates
4643
+ * land in the same pixel space. Pure presentation; the host owns the
4644
+ * pointer-down/move/up lifecycle and produces the rect (or `null` to
4645
+ * hide the lasso).
4646
+ *
4647
+ * @example
4648
+ * ```tsx
4649
+ * <div className="relative h-screen w-screen" onPointerDown={…}>
4650
+ * <Canvas />
4651
+ * <MultiSelectLasso rect={lassoRect} count={hoveredIds.length} />
4652
+ * </div>
4653
+ * ```
4654
+ *
4655
+ * @public
4656
+ */
4657
+ declare const MultiSelectLasso: react.ForwardRefExoticComponent<{
4658
+ /** Optional count badge — rendered near the bottom-right corner. */
4659
+ count?: number;
4660
+ /** Optional override slot rendered inside the lasso (e.g. a label). */
4661
+ hint?: ReactNode;
4662
+ /** Localizable strings. */
4663
+ labels?: MultiSelectLassoLabels;
4664
+ /** Drag rectangle in pixels. When `null`, nothing renders. */
4665
+ rect: LassoRect | null;
4666
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
4667
+
4668
+ type ObjectCardMetric = {
4669
+ label: string;
4670
+ value: ReactNode;
4671
+ };
4672
+ type ObjectCardAction = {
4673
+ label: string;
4674
+ onClick?: () => void;
4675
+ };
4676
+ type ObjectCardProps = React.ComponentPropsWithoutRef<"article"> & {
4677
+ actions?: ObjectCardAction[];
4678
+ footer?: ReactNode;
4679
+ kind?: string;
4680
+ metrics?: ObjectCardMetric[];
4681
+ ports?: ReactNode;
4682
+ state?: "blocked" | "complete" | "idle" | "running";
4683
+ summary?: string;
4684
+ title: string;
4685
+ };
4686
+ declare const ObjectCard: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & {
4687
+ actions?: ObjectCardAction[];
4688
+ footer?: ReactNode;
4689
+ kind?: string;
4690
+ metrics?: ObjectCardMetric[];
4691
+ ports?: ReactNode;
4692
+ state?: "blocked" | "complete" | "idle" | "running";
4693
+ summary?: string;
4694
+ title: string;
4695
+ } & react.RefAttributes<HTMLElement>>;
4696
+
4697
+ type ObjectHandleProps = Omit<React.ComponentPropsWithoutRef<"button">, "type"> & {
4698
+ hint?: ReactNode;
4699
+ label?: ReactNode;
4700
+ };
4701
+ declare const ObjectHandle: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "type"> & {
4702
+ hint?: ReactNode;
4703
+ label?: ReactNode;
4704
+ } & react.RefAttributes<HTMLButtonElement>>;
4705
+
4706
+ /**
4707
+ * Object kind — drives the chip glyph + label.
4708
+ *
4709
+ * @public
4710
+ */
4711
+ type ObjectInspectorKind = "agent" | "artifact" | "input" | "output" | "run" | "task";
4712
+ /**
4713
+ * Live status — drives the colored dot.
4714
+ *
4715
+ * @public
4716
+ */
4717
+ type ObjectInspectorStatus = "complete" | "failed" | "idle" | "queued" | "running";
4718
+ /**
4719
+ * Localizable strings.
4720
+ *
4721
+ * @public
4722
+ */
4723
+ type ObjectInspectorLabels = {
4724
+ /** Empty-state copy. Defaults to `"No selection"`. */
4725
+ empty?: string;
4726
+ /** Aria-label for the inspector. Defaults to `"Object inspector"`. */
4727
+ region?: string;
4728
+ };
4729
+ /**
4730
+ * Props for {@link ObjectInspector}.
4731
+ *
4732
+ * @public
4733
+ */
4734
+ type ObjectInspectorProps = {
4735
+ /** Object kind. When omitted, the inspector renders the empty state. */
4736
+ kind?: ObjectInspectorKind;
4737
+ /** Localizable strings. */
4738
+ labels?: ObjectInspectorLabels;
4739
+ /** Object status. Defaults to `"idle"`. */
4740
+ status?: ObjectInspectorStatus;
4741
+ /** Optional subtitle (id, owner, model). */
4742
+ subtitle?: ReactNode;
4743
+ /** Object title. */
4744
+ title?: ReactNode;
4745
+ } & ComponentPropsWithoutRef<"section">;
4746
+ /**
4747
+ * Inspector header for the right dock. Renders kind chip + status dot
4748
+ * + title + subtitle, then any children below (typically a stack of
4749
+ * {@link "../property-section/property-section".PropertySection} blocks). Pure presentation; the host
4750
+ * derives props from the current selection and slots the property
4751
+ * sections.
4752
+ *
4753
+ * @example
4754
+ * ```tsx
4755
+ * <ObjectInspector
4756
+ * kind="run"
4757
+ * status="running"
4758
+ * title="research-2025-04-15"
4759
+ * subtitle="claude-3.7"
4760
+ * >
4761
+ * <PropertySection title="Layout" entries={…} />
4762
+ * <PropertySection title="State" entries={…} />
4763
+ * </ObjectInspector>
4764
+ * ```
4765
+ *
4766
+ * @public
4767
+ */
4768
+ declare const ObjectInspector: react.ForwardRefExoticComponent<{
4769
+ /** Object kind. When omitted, the inspector renders the empty state. */
4770
+ kind?: ObjectInspectorKind;
4771
+ /** Localizable strings. */
4772
+ labels?: ObjectInspectorLabels;
4773
+ /** Object status. Defaults to `"idle"`. */
4774
+ status?: ObjectInspectorStatus;
4775
+ /** Optional subtitle (id, owner, model). */
4776
+ subtitle?: ReactNode;
4777
+ /** Object title. */
4778
+ title?: ReactNode;
4779
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
4780
+
4781
+ /**
4782
+ * Object kind — drives the ghost glyph.
4783
+ *
4784
+ * @public
4785
+ */
4786
+ type PlaybackGhostKind = "agent" | "artifact" | "input" | "output" | "run" | "task";
4787
+ /**
4788
+ * Localizable strings.
4789
+ *
4790
+ * @public
4791
+ */
4792
+ type PlaybackGhostLabels = {
4793
+ /** Aria-label override. Defaults to `"Playback ghost"`. */
4794
+ region?: string;
4795
+ };
4796
+ /**
4797
+ * Props for {@link PlaybackGhost}.
4798
+ *
4799
+ * @public
4800
+ */
4801
+ type PlaybackGhostProps = {
4802
+ /** Optional kind glyph + tooltip. */
4803
+ kind?: PlaybackGhostKind;
4804
+ /** Optional label rendered next to the glyph (e.g. id, run name). */
4805
+ label?: ReactNode;
4806
+ /** Localizable strings. */
4807
+ labels?: PlaybackGhostLabels;
4808
+ /** Ghost opacity `0..1`. Defaults to `0.4`. */
4809
+ opacity?: number;
4810
+ /** Ghost size in pixels. Defaults to `40`. */
4811
+ size?: number;
4812
+ /** Center X in canvas pixels. */
4813
+ x: number;
4814
+ /** Center Y in canvas pixels. */
4815
+ y: number;
4816
+ } & ComponentPropsWithoutRef<"div">;
4817
+ /**
4818
+ * Translucent overlay marking where a canvas object was at a previous
4819
+ * timestamp during state playback. Renders a kind glyph (and optional
4820
+ * label) at the historical position so the user can compare the
4821
+ * present canvas against earlier state without losing context.
4822
+ *
4823
+ * Pure presentation; the host computes the historical position from the
4824
+ * scrubbed timestamp. The wrapper is `pointer-events: none` so host
4825
+ * gestures pass through.
4826
+ *
4827
+ * @example
4828
+ * ```tsx
4829
+ * <div className="relative h-screen w-screen">
4830
+ * <Canvas />
4831
+ * <PlaybackGhost x={420} y={180} kind="run" label="research-2025" />
4832
+ * </div>
4833
+ * ```
4834
+ *
4835
+ * @public
4836
+ */
4837
+ declare const PlaybackGhost: react.ForwardRefExoticComponent<{
4838
+ /** Optional kind glyph + tooltip. */
4839
+ kind?: PlaybackGhostKind;
4840
+ /** Optional label rendered next to the glyph (e.g. id, run name). */
4841
+ label?: ReactNode;
4842
+ /** Localizable strings. */
4843
+ labels?: PlaybackGhostLabels;
4844
+ /** Ghost opacity `0..1`. Defaults to `0.4`. */
4845
+ opacity?: number;
4846
+ /** Ghost size in pixels. Defaults to `40`. */
4847
+ size?: number;
4848
+ /** Center X in canvas pixels. */
4849
+ x: number;
4850
+ /** Center Y in canvas pixels. */
4851
+ y: number;
4852
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
4853
+
4854
+ /**
4855
+ * Enforcement status for a policy.
4856
+ *
4857
+ * @public
4858
+ */
4859
+ type PolicyStatus = "advisory" | "disabled" | "enforced";
4860
+ /**
4861
+ * One policy row.
4862
+ *
4863
+ * @public
4864
+ */
4865
+ type PolicyEntry = {
4866
+ /** Optional secondary line (rationale, owner, last-updated). */
4867
+ description?: ReactNode;
4868
+ /** Stable identifier — used as the React key. */
4869
+ id: string;
4870
+ /** Display name (e.g. `"PII redaction"`). */
4871
+ name: ReactNode;
4872
+ /** Optional toggle handler — when provided, the row becomes a button. */
4873
+ onToggle?: () => void;
4874
+ /** Enforcement status. */
4875
+ status: PolicyStatus;
4876
+ };
4877
+ /**
4878
+ * Localizable strings.
4879
+ *
4880
+ * @public
4881
+ */
4882
+ type PolicyDeliveryPanelLabels = {
4883
+ /** Empty-state copy. Defaults to `"No policies"`. */
4884
+ empty?: string;
4885
+ /** Aria-label for the panel. Defaults to `"Policy delivery"`. */
4886
+ region?: string;
4887
+ };
4888
+ /**
4889
+ * Props for {@link PolicyDeliveryPanel}.
4890
+ *
4891
+ * @public
4892
+ */
4893
+ type PolicyDeliveryPanelProps = {
4894
+ /** Localizable strings. */
4895
+ labels?: PolicyDeliveryPanelLabels;
4896
+ /** Policy entries in render order. */
4897
+ policies: PolicyEntry[];
4898
+ /** Panel title. Defaults to `"Policies"`. */
4899
+ title?: ReactNode;
4900
+ } & ComponentPropsWithoutRef<"section">;
4901
+ /**
4902
+ * Right-dock panel listing the policies / guardrails that apply to the
4903
+ * active route or run. Each row shows the policy name, enforcement
4904
+ * status chip, and optional rationale. Pure presentation; the host
4905
+ * computes the policy list from the live config and supplies an
4906
+ * optional toggle handler for admin views.
4907
+ *
4908
+ * @example
4909
+ * ```tsx
4910
+ * <PolicyDeliveryPanel
4911
+ * policies={[
4912
+ * { id: "pii", name: "PII redaction", status: "enforced" },
4913
+ * { id: "rate", name: "Rate limiting", status: "advisory", description: "60 / s soft cap" },
4914
+ * { id: "exp", name: "Experiment B", status: "disabled" },
4915
+ * ]}
4916
+ * />
4917
+ * ```
4918
+ *
4919
+ * @public
4920
+ */
4921
+ declare const PolicyDeliveryPanel: react.ForwardRefExoticComponent<{
4922
+ /** Localizable strings. */
4923
+ labels?: PolicyDeliveryPanelLabels;
4924
+ /** Policy entries in render order. */
4925
+ policies: PolicyEntry[];
4926
+ /** Panel title. Defaults to `"Policies"`. */
4927
+ title?: ReactNode;
4928
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
4929
+
4930
+ /**
4931
+ * Presence status — drives the corner dot color.
4932
+ *
4933
+ * @public
4934
+ */
4935
+ type PresenceStatus = "active" | "away" | "idle" | "offline";
4936
+ /**
4937
+ * One user in the presence stack.
4938
+ *
4939
+ * @public
4940
+ */
4941
+ type PresenceUser = {
4942
+ /** Optional accent color (hex / oklch / var). Drives the avatar fill. */
4943
+ color?: string;
4944
+ /** Stable identifier — used as the React key. */
4945
+ id: string;
4946
+ /** Avatar initial / glyph. */
4947
+ initial: ReactNode;
4948
+ /** Display name shown on hover (`title` attribute). */
4949
+ name?: string;
4950
+ /** Optional status. Defaults to `"active"`. */
4951
+ status?: PresenceStatus;
4952
+ };
4953
+ /**
4954
+ * Localizable strings.
4955
+ *
4956
+ * @public
4957
+ */
4958
+ type PresenceStackLabels = {
4959
+ /** Suffix for the overflow chip. Defaults to `"more"`. */
4960
+ overflowSuffix?: string;
4961
+ /** Aria-label override. Defaults to `"Live presence"`. */
4962
+ region?: string;
4963
+ };
4964
+ /**
4965
+ * Props for {@link PresenceStack}.
4966
+ *
4967
+ * @public
4968
+ */
4969
+ type PresenceStackProps = {
4970
+ /** Localizable strings. */
4971
+ labels?: PresenceStackLabels;
4972
+ /** Cap the rendered users; the rest collapse into a `+N` chip. Defaults to `5`. */
4973
+ max?: number;
4974
+ /** Optional click handler for the overflow chip. */
4975
+ onOverflowActivate?: () => void;
4976
+ /** Users sorted in render order (most-relevant first). */
4977
+ users: PresenceUser[];
4978
+ } & ComponentPropsWithoutRef<"div">;
4979
+ /**
4980
+ * Overlapping live-presence avatars showing who is in the canvas right
4981
+ * now. Each avatar carries an accent color, an initial, and a status
4982
+ * dot. Distinct from `AvatarGroup` (a static participant grouping):
4983
+ * this primitive centers on live status, a sane overflow, and
4984
+ * interactive expansion.
4985
+ *
4986
+ * Pure presentation; the host owns the websocket roster + maps user
4987
+ * ids to colors.
4988
+ *
4989
+ * @example
4990
+ * ```tsx
4991
+ * <PresenceStack
4992
+ * max={4}
4993
+ * users={[
4994
+ * { id: "1", initial: "B", color: "#5b8def", name: "Bea" },
4995
+ * { id: "2", initial: "L", color: "#10b981", name: "Lior", status: "away" },
4996
+ * { id: "3", initial: "S", color: "#f59e0b", name: "Sam", status: "idle" },
4997
+ * ]}
4998
+ * onOverflowActivate={() => openRoster()}
4999
+ * />
5000
+ * ```
5001
+ *
5002
+ * @public
5003
+ */
5004
+ declare const PresenceStack: react.ForwardRefExoticComponent<{
5005
+ /** Localizable strings. */
5006
+ labels?: PresenceStackLabels;
5007
+ /** Cap the rendered users; the rest collapse into a `+N` chip. Defaults to `5`. */
5008
+ max?: number;
5009
+ /** Optional click handler for the overflow chip. */
5010
+ onOverflowActivate?: () => void;
5011
+ /** Users sorted in render order (most-relevant first). */
5012
+ users: PresenceUser[];
5013
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
5014
+
5015
+ /**
5016
+ * Connection / sync state — drives the dot color + animation.
5017
+ *
5018
+ * @public
5019
+ */
5020
+ type PresenceSyncState = "error" | "live" | "offline" | "reconnecting" | "syncing";
5021
+ /**
5022
+ * Localizable strings.
5023
+ *
5024
+ * @public
5025
+ */
5026
+ type PresenceSyncIndicatorLabels = {
5027
+ /** Aria-label override. Defaults to `"Presence sync"`. */
5028
+ region?: string;
5029
+ };
5030
+ /**
5031
+ * Props for {@link PresenceSyncIndicator}.
5032
+ *
5033
+ * @public
5034
+ */
5035
+ type PresenceSyncIndicatorProps = {
5036
+ /** Optional override label (defaults to humanized state name). */
5037
+ label?: ReactNode;
5038
+ /** Localizable strings. */
5039
+ labels?: PresenceSyncIndicatorLabels;
5040
+ /** Connection state. */
5041
+ state: PresenceSyncState;
5042
+ /** Optional secondary line (peer count, latency). */
5043
+ status?: ReactNode;
5044
+ } & ComponentPropsWithoutRef<"div">;
5045
+ /**
5046
+ * Compact pill that surfaces live connection + sync health for the
5047
+ * canvas. Stays calm: a single dot + one-line label, with a subtle
5048
+ * pulse for transient `syncing` / `reconnecting` states.
5049
+ *
5050
+ * Pure presentation; the host owns the websocket / CRDT loop and maps
5051
+ * its diagnostics into one of five canonical states.
5052
+ *
5053
+ * @example
5054
+ * ```tsx
5055
+ * <PresenceSyncIndicator state="live" status="3 peers" />
5056
+ * <PresenceSyncIndicator state="reconnecting" status="retry 2/5" />
5057
+ * ```
5058
+ *
5059
+ * @public
5060
+ */
5061
+ declare const PresenceSyncIndicator: react.ForwardRefExoticComponent<{
5062
+ /** Optional override label (defaults to humanized state name). */
5063
+ label?: ReactNode;
5064
+ /** Localizable strings. */
5065
+ labels?: PresenceSyncIndicatorLabels;
5066
+ /** Connection state. */
5067
+ state: PresenceSyncState;
5068
+ /** Optional secondary line (peer count, latency). */
5069
+ status?: ReactNode;
5070
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
5071
+
5072
+ /**
5073
+ * One row in the property grid.
5074
+ *
5075
+ * @public
5076
+ */
5077
+ type PropertyEntry = {
5078
+ /** Stable id (used as React key + analytics hook). */
5079
+ id: string;
5080
+ /** Property label (left column). */
5081
+ label: ReactNode;
5082
+ /** Optional sublabel rendered beneath the label. */
5083
+ sublabel?: ReactNode;
5084
+ /** Property value (right column). */
5085
+ value: ReactNode;
5086
+ };
5087
+ /**
5088
+ * Localizable strings.
5089
+ *
5090
+ * @public
5091
+ */
5092
+ type PropertySectionLabels = {
5093
+ /** Aria-label for the section. Defaults to `"Properties"`. */
5094
+ region?: string;
5095
+ };
5096
+ /**
5097
+ * Props for {@link PropertySection}.
5098
+ *
5099
+ * @public
5100
+ */
5101
+ type PropertySectionProps = {
5102
+ /** Optional collapsible affordance. Pass `false` to render the body inline (default). */
5103
+ collapsible?: boolean;
5104
+ /** Property entries in render order. */
5105
+ entries: PropertyEntry[];
5106
+ /** Localizable strings. */
5107
+ labels?: PropertySectionLabels;
5108
+ /** Optional title rendered as a small uppercase heading above the grid. */
5109
+ title?: ReactNode;
5110
+ } & ComponentPropsWithoutRef<"section">;
5111
+ /**
5112
+ * Compact key / value grid for an inspector panel. Use one
5113
+ * `PropertySection` per logical group (Identity, Layout, State, etc.)
5114
+ * so the right dock stays scannable. Pure presentation — the host
5115
+ * computes the entries from the current selection.
5116
+ *
5117
+ * @example
5118
+ * ```tsx
5119
+ * <PropertySection
5120
+ * title="Layout"
5121
+ * entries={[
5122
+ * { id: "x", label: "X", value: "120" },
5123
+ * { id: "y", label: "Y", value: "80" },
5124
+ * { id: "size", label: "Size", value: "240 × 120" },
5125
+ * ]}
5126
+ * />
5127
+ * ```
5128
+ *
5129
+ * @public
5130
+ */
5131
+ declare const PropertySection: react.ForwardRefExoticComponent<{
5132
+ /** Optional collapsible affordance. Pass `false` to render the body inline (default). */
5133
+ collapsible?: boolean;
5134
+ /** Property entries in render order. */
5135
+ entries: PropertyEntry[];
5136
+ /** Localizable strings. */
5137
+ labels?: PropertySectionLabels;
5138
+ /** Optional title rendered as a small uppercase heading above the grid. */
5139
+ title?: ReactNode;
5140
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
5141
+
5142
+ /**
5143
+ * Direction of an edge relative to the focused object.
5144
+ *
5145
+ * @public
5146
+ */
5147
+ type RelationshipDirection = "inbound" | "outbound";
5148
+ /**
5149
+ * One edge in the relationship list.
5150
+ *
5151
+ * @public
5152
+ */
5153
+ type RelationshipEdge = {
5154
+ /** Direction of the edge relative to the focused object. */
5155
+ direction: RelationshipDirection;
5156
+ /** Stable identifier — used as the React key. */
5157
+ id: string;
5158
+ /** Optional click handler — when provided, the row becomes a button. */
5159
+ onActivate?: () => void;
5160
+ /** Relation kind (e.g. `"calls"`, `"emits"`, `"depends-on"`). */
5161
+ relation: string;
5162
+ /** Target id (when outbound) or source id (when inbound). */
5163
+ target: ReactNode;
5164
+ /** Optional secondary line beneath the row. */
5165
+ targetSublabel?: ReactNode;
5166
+ };
5167
+ /**
5168
+ * Localizable strings.
5169
+ *
5170
+ * @public
5171
+ */
5172
+ type RelationshipInspectorLabels = {
5173
+ /** Empty-state copy. Defaults to `"No relationships"`. */
5174
+ empty?: string;
5175
+ /** Header for inbound edges. Defaults to `"Inbound"`. */
5176
+ inbound?: string;
5177
+ /** Header for outbound edges. Defaults to `"Outbound"`. */
5178
+ outbound?: string;
5179
+ /** Aria-label for the inspector. Defaults to `"Relationship inspector"`. */
5180
+ region?: string;
5181
+ };
5182
+ /**
5183
+ * Props for {@link RelationshipInspector}.
5184
+ *
5185
+ * @public
5186
+ */
5187
+ type RelationshipInspectorProps = {
5188
+ /** Edges to render. Empty list shows the empty state. */
5189
+ edges: RelationshipEdge[];
5190
+ /** Localizable strings. */
5191
+ labels?: RelationshipInspectorLabels;
5192
+ /** Optional inspector title. Defaults to `"Relationships"`. */
5193
+ title?: ReactNode;
5194
+ } & ComponentPropsWithoutRef<"section">;
5195
+ /**
5196
+ * Inspector panel listing inbound + outbound edges of the focused
5197
+ * object. Each row shows direction arrow, target id, optional sublabel,
5198
+ * and the relation kind chip. Pure presentation; the host computes
5199
+ * edges from the runtime graph and supplies an optional click handler
5200
+ * to jump to the related object.
5201
+ *
5202
+ * @example
5203
+ * ```tsx
5204
+ * <RelationshipInspector
5205
+ * edges={[
5206
+ * { id: "1", direction: "inbound", target: "research-2025", relation: "spawned-by" },
5207
+ * { id: "2", direction: "outbound", target: "summary.md", relation: "emits" },
5208
+ * ]}
5209
+ * />
5210
+ * ```
5211
+ *
5212
+ * @public
5213
+ */
5214
+ declare const RelationshipInspector: react.ForwardRefExoticComponent<{
5215
+ /** Edges to render. Empty list shows the empty state. */
5216
+ edges: RelationshipEdge[];
5217
+ /** Localizable strings. */
5218
+ labels?: RelationshipInspectorLabels;
5219
+ /** Optional inspector title. Defaults to `"Relationships"`. */
5220
+ title?: ReactNode;
5221
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
5222
+
5223
+ /**
5224
+ * Role of an agent in the routing graph.
5225
+ *
5226
+ * @public
5227
+ */
5228
+ type RoutingRole = "fallback" | "primary" | "shadow";
5229
+ /**
5230
+ * One row in the routing assignment list.
5231
+ *
5232
+ * @public
5233
+ */
5234
+ type RoutingAssignment = {
5235
+ /** Display name (e.g. `"researcher"`, `"ranker"`). */
5236
+ agent: ReactNode;
5237
+ /** Stable identifier — used as the React key. */
5238
+ id: string;
5239
+ /** Optional load fraction `0..1` rendered as a thin progress bar. */
5240
+ load?: number;
5241
+ /** Optional click handler — when provided, the row becomes a button. */
5242
+ onActivate?: () => void;
5243
+ /** Role of the agent for this slot. */
5244
+ role: RoutingRole;
5245
+ };
5246
+ /**
5247
+ * Localizable strings.
5248
+ *
5249
+ * @public
5250
+ */
5251
+ type RoutingAssignmentPanelLabels = {
5252
+ /** Empty-state copy. Defaults to `"No assignments"`. */
5253
+ empty?: string;
5254
+ /** Aria-label for the panel. Defaults to `"Routing assignments"`. */
5255
+ region?: string;
5256
+ };
5257
+ /**
5258
+ * Props for {@link RoutingAssignmentPanel}.
5259
+ *
5260
+ * @public
5261
+ */
5262
+ type RoutingAssignmentPanelProps = {
5263
+ /** Assignments in render order. */
5264
+ assignments: RoutingAssignment[];
5265
+ /** Localizable strings. */
5266
+ labels?: RoutingAssignmentPanelLabels;
5267
+ /** Panel title. Defaults to `"Routing"`. */
5268
+ title?: ReactNode;
5269
+ } & ComponentPropsWithoutRef<"section">;
5270
+ /**
5271
+ * Right-dock panel listing the agent slots that the active route
5272
+ * dispatches to: primary handler + fallbacks + shadow probes. Each row
5273
+ * shows the agent name, role chip, and optional load bar. Pure
5274
+ * presentation; the host computes the assignments from the routing
5275
+ * config + observed traffic.
5276
+ *
5277
+ * @example
5278
+ * ```tsx
5279
+ * <RoutingAssignmentPanel
5280
+ * assignments={[
5281
+ * { id: "1", agent: "researcher", role: "primary", load: 0.82 },
5282
+ * { id: "2", agent: "researcher-mini", role: "fallback", load: 0.04 },
5283
+ * { id: "3", agent: "shadow-eval", role: "shadow" },
5284
+ * ]}
5285
+ * />
5286
+ * ```
5287
+ *
5288
+ * @public
5289
+ */
5290
+ declare const RoutingAssignmentPanel: react.ForwardRefExoticComponent<{
5291
+ /** Assignments in render order. */
5292
+ assignments: RoutingAssignment[];
5293
+ /** Localizable strings. */
5294
+ labels?: RoutingAssignmentPanelLabels;
5295
+ /** Panel title. Defaults to `"Routing"`. */
5296
+ title?: ReactNode;
5297
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
5298
+
5299
+ /**
5300
+ * Phase state — drives the bar tone.
5301
+ *
5302
+ * @public
5303
+ */
5304
+ type RunPhaseState = "complete" | "failed" | "queued" | "running" | "stopped";
5305
+ /**
5306
+ * One lane in a multi-lane run timeline.
5307
+ *
5308
+ * @public
5309
+ */
5310
+ type RunTimelineLane = {
5311
+ /** Stable identifier — used as the React key + phase routing. */
5312
+ id: string;
5313
+ /** Display label rendered to the left of the lane. */
5314
+ label: ReactNode;
5315
+ };
5316
+ /**
5317
+ * One phase block in the run timeline.
5318
+ *
5319
+ * @public
5320
+ */
5321
+ type RunTimelinePhase = {
5322
+ /** End timestamp in the same units as `start` / `end`. */
5323
+ end: number;
5324
+ /** Stable identifier — used as the React key + analytics hook. */
5325
+ id: string;
5326
+ /** Optional label rendered inside the phase bar. */
3682
5327
  label?: ReactNode;
5328
+ /** Lane id this phase belongs to. Defaults to `"default"` (single-lane mode). */
5329
+ laneId?: string;
5330
+ /** Optional click handler — when provided, the phase becomes a button. */
5331
+ onActivate?: () => void;
5332
+ /** Start timestamp `>= timeline start`. */
5333
+ start: number;
5334
+ /** Phase state. Defaults to `"running"`. */
5335
+ state?: RunPhaseState;
3683
5336
  };
3684
- declare const ObjectHandle: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "type"> & {
3685
- hint?: ReactNode;
3686
- label?: ReactNode;
3687
- } & react.RefAttributes<HTMLButtonElement>>;
5337
+ /**
5338
+ * Localizable strings.
5339
+ *
5340
+ * @public
5341
+ */
5342
+ type RunTimelineLabels = {
5343
+ /** Empty-state copy. Defaults to `"No phases"`. */
5344
+ empty?: string;
5345
+ /** Aria-label override. Defaults to `"Run timeline"`. */
5346
+ region?: string;
5347
+ };
5348
+ /**
5349
+ * Props for {@link RunTimeline}.
5350
+ *
5351
+ * @public
5352
+ */
5353
+ type RunTimelineProps = {
5354
+ /** Optional cursor position in the same units as the range. Renders a vertical line. */
5355
+ cursor?: number;
5356
+ /** End of the time range. Must be `> start`. */
5357
+ end: number;
5358
+ /** Optional formatter for the start / cursor / end labels. */
5359
+ formatValue?: (value: number) => ReactNode;
5360
+ /** Localizable strings. */
5361
+ labels?: RunTimelineLabels;
5362
+ /** Optional explicit lane definitions in render order. Required for multi-lane mode. */
5363
+ lanes?: RunTimelineLane[];
5364
+ /** Phase blocks — order is irrelevant; routed to lanes by `laneId`. */
5365
+ phases: RunTimelinePhase[];
5366
+ /** Start of the time range. */
5367
+ start: number;
5368
+ } & ComponentPropsWithoutRef<"section">;
5369
+ /**
5370
+ * Multi-lane execution timeline showing run phases over time. Each
5371
+ * phase renders as a colored bar positioned by its start / end and
5372
+ * routed to a lane by `laneId`. Optional cursor draws a thin vertical
5373
+ * line for the current playback position.
5374
+ *
5375
+ * Pure presentation; the host computes the phase list from the run's
5376
+ * execution history. Pair with {@link "../timeline-scrubber/timeline-scrubber".TimelineScrubber}
5377
+ * to drive the cursor.
5378
+ *
5379
+ * Distinct from `MapTimeline` (geo-aware), `Stepper` (sequential
5380
+ * steps), and the timeline family `#32`–`#35`: this primitive is
5381
+ * specifically the run history surface inside the canvas.
5382
+ *
5383
+ * @example
5384
+ * ```tsx
5385
+ * <RunTimeline
5386
+ * start={0} end={3600}
5387
+ * cursor={1800}
5388
+ * lanes={[
5389
+ * { id: "ingest", label: "Ingest" },
5390
+ * { id: "rank", label: "Rank" },
5391
+ * ]}
5392
+ * phases={[
5393
+ * { id: "1", laneId: "ingest", start: 0, end: 600, state: "complete", label: "load" },
5394
+ * { id: "2", laneId: "rank", start: 600, end: 2400, state: "running", label: "score" },
5395
+ * ]}
5396
+ * />
5397
+ * ```
5398
+ *
5399
+ * @public
5400
+ */
5401
+ declare const RunTimeline: react.ForwardRefExoticComponent<{
5402
+ /** Optional cursor position in the same units as the range. Renders a vertical line. */
5403
+ cursor?: number;
5404
+ /** End of the time range. Must be `> start`. */
5405
+ end: number;
5406
+ /** Optional formatter for the start / cursor / end labels. */
5407
+ formatValue?: (value: number) => ReactNode;
5408
+ /** Localizable strings. */
5409
+ labels?: RunTimelineLabels;
5410
+ /** Optional explicit lane definitions in render order. Required for multi-lane mode. */
5411
+ lanes?: RunTimelineLane[];
5412
+ /** Phase blocks — order is irrelevant; routed to lanes by `laneId`. */
5413
+ phases: RunTimelinePhase[];
5414
+ /** Start of the time range. */
5415
+ start: number;
5416
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
3688
5417
 
3689
5418
  /**
3690
- * Presence status — drives the corner dot color.
5419
+ * Trend direction for a runtime metric.
3691
5420
  *
3692
5421
  * @public
3693
5422
  */
3694
- type PresenceStatus = "active" | "away" | "idle" | "offline";
5423
+ type RuntimeMetricTrend = "down" | "flat" | "up";
3695
5424
  /**
3696
- * One user in the presence stack.
5425
+ * Tone of the metric value — drives the dot color.
3697
5426
  *
3698
5427
  * @public
3699
5428
  */
3700
- type PresenceUser = {
3701
- /** Optional accent color (hex / oklch / var). Drives the avatar fill. */
3702
- color?: string;
5429
+ type RuntimeMetricTone = "danger" | "neutral" | "success" | "warn";
5430
+ /**
5431
+ * One metric tile in the runtime overview.
5432
+ *
5433
+ * @public
5434
+ */
5435
+ type RuntimeMetric = {
5436
+ /** Optional secondary line (delta, target, owner). */
5437
+ detail?: ReactNode;
3703
5438
  /** Stable identifier — used as the React key. */
3704
5439
  id: string;
3705
- /** Avatar initial / glyph. */
3706
- initial: ReactNode;
3707
- /** Display name shown on hover (`title` attribute). */
3708
- name?: string;
3709
- /** Optional status. Defaults to `"active"`. */
3710
- status?: PresenceStatus;
5440
+ /** Short label (e.g. `"Active runs"`). */
5441
+ label: ReactNode;
5442
+ /** Optional tone for the dot. Defaults to `"neutral"`. */
5443
+ tone?: RuntimeMetricTone;
5444
+ /** Optional trend arrow next to the value. */
5445
+ trend?: RuntimeMetricTrend;
5446
+ /** Display value (already formatted by the host). */
5447
+ value: ReactNode;
3711
5448
  };
3712
5449
  /**
3713
5450
  * Localizable strings.
3714
5451
  *
3715
5452
  * @public
3716
5453
  */
3717
- type PresenceStackLabels = {
3718
- /** Suffix for the overflow chip. Defaults to `"more"`. */
3719
- overflowSuffix?: string;
3720
- /** Aria-label override. Defaults to `"Live presence"`. */
5454
+ type RuntimeOverviewPanelLabels = {
5455
+ /** Empty-state copy. Defaults to `"No runtime metrics"`. */
5456
+ empty?: string;
5457
+ /** Aria-label for the panel. Defaults to `"Runtime overview"`. */
3721
5458
  region?: string;
3722
5459
  };
3723
5460
  /**
3724
- * Props for {@link PresenceStack}.
5461
+ * Props for {@link RuntimeOverviewPanel}.
3725
5462
  *
3726
5463
  * @public
3727
5464
  */
3728
- type PresenceStackProps = {
5465
+ type RuntimeOverviewPanelProps = {
3729
5466
  /** Localizable strings. */
3730
- labels?: PresenceStackLabels;
3731
- /** Cap the rendered users; the rest collapse into a `+N` chip. Defaults to `5`. */
3732
- max?: number;
3733
- /** Optional click handler for the overflow chip. */
3734
- onOverflowActivate?: () => void;
3735
- /** Users sorted in render order (most-relevant first). */
3736
- users: PresenceUser[];
3737
- } & ComponentPropsWithoutRef<"div">;
5467
+ labels?: RuntimeOverviewPanelLabels;
5468
+ /** Metric tiles in render order. */
5469
+ metrics: RuntimeMetric[];
5470
+ /** Panel title. Defaults to `"Runtime"`. */
5471
+ title?: ReactNode;
5472
+ } & ComponentPropsWithoutRef<"section">;
3738
5473
  /**
3739
- * Overlapping live-presence avatars showing who is in the canvas right
3740
- * now. Each avatar carries an accent color, an initial, and a status
3741
- * dot. Distinct from `AvatarGroup` (a static participant grouping):
3742
- * this primitive centers on live status, a sane overflow, and
3743
- * interactive expansion.
3744
- *
3745
- * Pure presentation; the host owns the websocket roster + maps user
3746
- * ids to colors.
5474
+ * Top-of-dock summary for the runtime when nothing on the canvas is
5475
+ * selected. Renders a compact grid of metric tiles (active runs,
5476
+ * throughput, error rate, etc.). Pure presentation; the host computes
5477
+ * the metric list from the runtime stream.
3747
5478
  *
3748
5479
  * @example
3749
5480
  * ```tsx
3750
- * <PresenceStack
3751
- * max={4}
3752
- * users={[
3753
- * { id: "1", initial: "B", color: "#5b8def", name: "Bea" },
3754
- * { id: "2", initial: "L", color: "#10b981", name: "Lior", status: "away" },
3755
- * { id: "3", initial: "S", color: "#f59e0b", name: "Sam", status: "idle" },
5481
+ * <RuntimeOverviewPanel
5482
+ * metrics={[
5483
+ * { id: "runs", label: "Active runs", value: 3, tone: "success" },
5484
+ * { id: "errs", label: "Errors / hr", value: 0, tone: "neutral", trend: "flat" },
5485
+ * { id: "tps", label: "Throughput", value: "120 / s", tone: "success", trend: "up" },
3756
5486
  * ]}
3757
- * onOverflowActivate={() => openRoster()}
3758
5487
  * />
3759
5488
  * ```
3760
5489
  *
3761
5490
  * @public
3762
5491
  */
3763
- declare const PresenceStack: react.ForwardRefExoticComponent<{
5492
+ declare const RuntimeOverviewPanel: react.ForwardRefExoticComponent<{
3764
5493
  /** Localizable strings. */
3765
- labels?: PresenceStackLabels;
3766
- /** Cap the rendered users; the rest collapse into a `+N` chip. Defaults to `5`. */
3767
- max?: number;
3768
- /** Optional click handler for the overflow chip. */
3769
- onOverflowActivate?: () => void;
3770
- /** Users sorted in render order (most-relevant first). */
3771
- users: PresenceUser[];
3772
- } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
5494
+ labels?: RuntimeOverviewPanelLabels;
5495
+ /** Metric tiles in render order. */
5496
+ metrics: RuntimeMetric[];
5497
+ /** Panel title. Defaults to `"Runtime"`. */
5498
+ title?: ReactNode;
5499
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
3773
5500
 
3774
5501
  /**
3775
5502
  * Localizable strings.
@@ -3841,6 +5568,168 @@ declare const SelectionPresence: react.ForwardRefExoticComponent<{
3841
5568
  y: number;
3842
5569
  } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
3843
5570
 
5571
+ /**
5572
+ * State name — drives the badge tone.
5573
+ *
5574
+ * @public
5575
+ */
5576
+ type StateBadgeState = "complete" | "failed" | "idle" | "queued" | "running" | "stopped";
5577
+ /**
5578
+ * Anchor corner relative to the canvas object the badge attaches to.
5579
+ *
5580
+ * @public
5581
+ */
5582
+ type StateBadgeAnchor = "bottom-left" | "bottom-right" | "top-left" | "top-right";
5583
+ /**
5584
+ * Localizable strings.
5585
+ *
5586
+ * @public
5587
+ */
5588
+ type StateBadgeOverlayLabels = {
5589
+ /** Aria-label override. Defaults to `"State"`. */
5590
+ region?: string;
5591
+ };
5592
+ /**
5593
+ * Props for {@link StateBadgeOverlay}.
5594
+ *
5595
+ * @public
5596
+ */
5597
+ type StateBadgeOverlayProps = {
5598
+ /** Anchor corner. Defaults to `"top-right"`. */
5599
+ anchor?: StateBadgeAnchor;
5600
+ /** Optional override label (defaults to humanized state name). */
5601
+ label?: ReactNode;
5602
+ /** Localizable strings. */
5603
+ labels?: StateBadgeOverlayLabels;
5604
+ /** State to display. */
5605
+ state: StateBadgeState;
5606
+ /** Anchor X in canvas pixels. */
5607
+ x: number;
5608
+ /** Anchor Y in canvas pixels. */
5609
+ y: number;
5610
+ } & ComponentPropsWithoutRef<"div">;
5611
+ /**
5612
+ * State chip pinned to a canvas object's corner. Use when a single-
5613
+ * letter glyph in `ObjectCard` doesn't carry enough signal — for
5614
+ * runs that have transitioned, jobs that failed, agents idling. Pure
5615
+ * presentation; the host computes the anchor from the object's
5616
+ * bounding box.
5617
+ *
5618
+ * The wrapper is `pointer-events: none` — host gestures pass through.
5619
+ *
5620
+ * @example
5621
+ * ```tsx
5622
+ * <div className="relative h-screen w-screen">
5623
+ * <Canvas />
5624
+ * <StateBadgeOverlay state="running" x={420} y={180} anchor="top-right" />
5625
+ * </div>
5626
+ * ```
5627
+ *
5628
+ * @public
5629
+ */
5630
+ declare const StateBadgeOverlay: react.ForwardRefExoticComponent<{
5631
+ /** Anchor corner. Defaults to `"top-right"`. */
5632
+ anchor?: StateBadgeAnchor;
5633
+ /** Optional override label (defaults to humanized state name). */
5634
+ label?: ReactNode;
5635
+ /** Localizable strings. */
5636
+ labels?: StateBadgeOverlayLabels;
5637
+ /** State to display. */
5638
+ state: StateBadgeState;
5639
+ /** Anchor X in canvas pixels. */
5640
+ x: number;
5641
+ /** Anchor Y in canvas pixels. */
5642
+ y: number;
5643
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
5644
+
5645
+ /**
5646
+ * Tone of the metric — drives the dot color.
5647
+ *
5648
+ * @public
5649
+ */
5650
+ type StickyMetricTone = "danger" | "neutral" | "success" | "warn";
5651
+ /**
5652
+ * Anchor corner relative to the canvas object the metric sticks to.
5653
+ *
5654
+ * @public
5655
+ */
5656
+ type StickyMetricAnchor = "bottom-left" | "bottom-right" | "top-left" | "top-right";
5657
+ /**
5658
+ * Localizable strings.
5659
+ *
5660
+ * @public
5661
+ */
5662
+ type StickyMetricLabels = {
5663
+ /** Aria-label override. Defaults to `"Sticky metric"`. */
5664
+ region?: string;
5665
+ };
5666
+ /**
5667
+ * Props for {@link StickyMetric}.
5668
+ *
5669
+ * @public
5670
+ */
5671
+ type StickyMetricProps = {
5672
+ /** Anchor corner. Defaults to `"top-right"`. */
5673
+ anchor?: StickyMetricAnchor;
5674
+ /** Optional secondary slot rendered after the value (delta, unit). */
5675
+ detail?: ReactNode;
5676
+ /** Short metric label (e.g. `"errs/min"`). */
5677
+ label: ReactNode;
5678
+ /** Localizable strings. */
5679
+ labels?: StickyMetricLabels;
5680
+ /** Tone for the leading dot. Defaults to `"neutral"`. */
5681
+ tone?: StickyMetricTone;
5682
+ /** Display value (already formatted by host). */
5683
+ value: ReactNode;
5684
+ /** Anchor X in canvas pixels. */
5685
+ x: number;
5686
+ /** Anchor Y in canvas pixels. */
5687
+ y: number;
5688
+ } & ComponentPropsWithoutRef<"div">;
5689
+ /**
5690
+ * Pinned metric pill that sticks to a canvas object's corner. Use to
5691
+ * overlay a single live value (errors / min, p95 latency, queue depth)
5692
+ * on a runtime object without consuming card real-estate. Pure
5693
+ * presentation; the host computes the anchor coords from the object's
5694
+ * bounding box and the value from the runtime stream.
5695
+ *
5696
+ * The wrapper is `pointer-events: none` — host gestures pass through.
5697
+ *
5698
+ * @example
5699
+ * ```tsx
5700
+ * <div className="relative h-screen w-screen">
5701
+ * <Canvas />
5702
+ * <StickyMetric
5703
+ * x={420} y={180}
5704
+ * anchor="top-right"
5705
+ * label="errs / min"
5706
+ * value="14"
5707
+ * tone="danger"
5708
+ * />
5709
+ * </div>
5710
+ * ```
5711
+ *
5712
+ * @public
5713
+ */
5714
+ declare const StickyMetric: react.ForwardRefExoticComponent<{
5715
+ /** Anchor corner. Defaults to `"top-right"`. */
5716
+ anchor?: StickyMetricAnchor;
5717
+ /** Optional secondary slot rendered after the value (delta, unit). */
5718
+ detail?: ReactNode;
5719
+ /** Short metric label (e.g. `"errs/min"`). */
5720
+ label: ReactNode;
5721
+ /** Localizable strings. */
5722
+ labels?: StickyMetricLabels;
5723
+ /** Tone for the leading dot. Defaults to `"neutral"`. */
5724
+ tone?: StickyMetricTone;
5725
+ /** Display value (already formatted by host). */
5726
+ value: ReactNode;
5727
+ /** Anchor X in canvas pixels. */
5728
+ x: number;
5729
+ /** Anchor Y in canvas pixels. */
5730
+ y: number;
5731
+ } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
5732
+
3844
5733
  /**
3845
5734
  * One message in a thread bubble.
3846
5735
  *
@@ -3923,6 +5812,178 @@ declare const ThreadBubble: react.ForwardRefExoticComponent<{
3923
5812
  title?: ReactNode;
3924
5813
  } & Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & react.RefAttributes<HTMLElement>>;
3925
5814
 
5815
+ /**
5816
+ * Tone of the active arc — drives its stroke color.
5817
+ *
5818
+ * @public
5819
+ */
5820
+ type ThresholdRingTone = "danger" | "neutral" | "success" | "warn";
5821
+ /**
5822
+ * Localizable strings.
5823
+ *
5824
+ * @public
5825
+ */
5826
+ type ThresholdRingLabels = {
5827
+ /** Aria-label override. Defaults to `"Threshold ring"`. */
5828
+ region?: string;
5829
+ };
5830
+ /**
5831
+ * Props for {@link ThresholdRing}.
5832
+ *
5833
+ * @public
5834
+ */
5835
+ type ThresholdRingProps = {
5836
+ /** Optional center label (formatted by host — e.g. `"82%"`). */
5837
+ centerLabel?: ReactNode;
5838
+ /** Localizable strings. */
5839
+ labels?: ThresholdRingLabels;
5840
+ /** Upper bound of the ring's value range. Defaults to `1`. */
5841
+ max?: number;
5842
+ /** Outer diameter in pixels. Defaults to `64`. */
5843
+ size?: number;
5844
+ /** Stroke width in pixels. Defaults to `6`. */
5845
+ stroke?: number;
5846
+ /** Optional threshold marker `0..max` rendered as a small notch. */
5847
+ threshold?: number;
5848
+ /** Tone of the active arc. Defaults to `"neutral"`. */
5849
+ tone?: ThresholdRingTone;
5850
+ /** Current value `0..max`. */
5851
+ value: number;
5852
+ } & ComponentPropsWithoutRef<"svg">;
5853
+ /**
5854
+ * Compact ring gauge expressing how close a value is to a threshold.
5855
+ * Pure presentation; the host supplies the value, threshold, and tone.
5856
+ * Use to overlay budget / quota / SLA indicators on canvas objects
5857
+ * without consuming card real-estate.
5858
+ *
5859
+ * Distinct from `MetricGauge`: this primitive is small, headless, and
5860
+ * meant to attach to a runtime object — not a dashboard tile.
5861
+ *
5862
+ * @example
5863
+ * ```tsx
5864
+ * <ThresholdRing value={0.82} threshold={0.7} tone="warn" centerLabel="82%" />
5865
+ * ```
5866
+ *
5867
+ * @public
5868
+ */
5869
+ declare const ThresholdRing: react.ForwardRefExoticComponent<{
5870
+ /** Optional center label (formatted by host — e.g. `"82%"`). */
5871
+ centerLabel?: ReactNode;
5872
+ /** Localizable strings. */
5873
+ labels?: ThresholdRingLabels;
5874
+ /** Upper bound of the ring's value range. Defaults to `1`. */
5875
+ max?: number;
5876
+ /** Outer diameter in pixels. Defaults to `64`. */
5877
+ size?: number;
5878
+ /** Stroke width in pixels. Defaults to `6`. */
5879
+ stroke?: number;
5880
+ /** Optional threshold marker `0..max` rendered as a small notch. */
5881
+ threshold?: number;
5882
+ /** Tone of the active arc. Defaults to `"neutral"`. */
5883
+ tone?: ThresholdRingTone;
5884
+ /** Current value `0..max`. */
5885
+ value: number;
5886
+ } & Omit<react.SVGProps<SVGSVGElement>, "ref"> & react.RefAttributes<SVGSVGElement>>;
5887
+
5888
+ /**
5889
+ * One milestone tick rendered along the scrubber track.
5890
+ *
5891
+ * @public
5892
+ */
5893
+ type TimelineTick = {
5894
+ /** Stable identifier — used as the React key + analytics hook. */
5895
+ id: string;
5896
+ /** Optional accessible label (e.g. `"deploy"`, `"alert"`). */
5897
+ label?: ReactNode;
5898
+ /** Optional tone for the tick. Defaults to `"neutral"`. */
5899
+ tone?: TimelineScrubberTone;
5900
+ /** Time value of the tick. */
5901
+ value: number;
5902
+ };
5903
+ /**
5904
+ * Tone of the scrubber's filled track + handle.
5905
+ *
5906
+ * @public
5907
+ */
5908
+ type TimelineScrubberTone = "danger" | "neutral" | "primary" | "success" | "warn";
5909
+ /**
5910
+ * Localizable strings.
5911
+ *
5912
+ * @public
5913
+ */
5914
+ type TimelineScrubberLabels = {
5915
+ /** Aria-label for the slider. Defaults to `"Timeline scrubber"`. */
5916
+ region?: string;
5917
+ };
5918
+ /**
5919
+ * Props for {@link TimelineScrubber}.
5920
+ *
5921
+ * @public
5922
+ */
5923
+ type TimelineScrubberProps = {
5924
+ /** End of the time range. Must be `> start`. */
5925
+ end: number;
5926
+ /** Optional formatter for the cursor + endpoint labels. Receives the raw value. */
5927
+ formatValue?: (value: number) => ReactNode;
5928
+ /** Localizable strings. */
5929
+ labels?: TimelineScrubberLabels;
5930
+ /** Change handler — receives the new clamped value. */
5931
+ onValueChange: (value: number) => void;
5932
+ /** Start of the time range. */
5933
+ start: number;
5934
+ /** Step granularity for the underlying range input. Defaults to `1`. */
5935
+ step?: number;
5936
+ /** Optional milestone ticks rendered along the track. */
5937
+ ticks?: TimelineTick[];
5938
+ /** Tone of the filled track + handle. Defaults to `"primary"`. */
5939
+ tone?: TimelineScrubberTone;
5940
+ /** Current scrub value `start..end`. */
5941
+ value: number;
5942
+ } & Omit<ComponentPropsWithoutRef<"div">, "onChange">;
5943
+ /**
5944
+ * Range slider for scrubbing through canvas state playback. Renders a
5945
+ * thin track with optional milestone ticks plus the current value
5946
+ * cursor; the underlying `<input type="range">` keeps keyboard +
5947
+ * pointer + screen-reader semantics for free.
5948
+ *
5949
+ * Pure presentation; the host owns the value + drives playback in its
5950
+ * own loop. Pair with {@link "../playback-ghost/playback-ghost".PlaybackGhost} to fade the canvas
5951
+ * back to historical state as the user scrubs.
5952
+ *
5953
+ * @example
5954
+ * ```tsx
5955
+ * <TimelineScrubber
5956
+ * start={0} end={3600}
5957
+ * value={cursor}
5958
+ * onValueChange={setCursor}
5959
+ * ticks={milestones}
5960
+ * formatValue={(v) => formatDuration(v)}
5961
+ * />
5962
+ * ```
5963
+ *
5964
+ * @public
5965
+ */
5966
+ declare const TimelineScrubber: react.ForwardRefExoticComponent<{
5967
+ /** End of the time range. Must be `> start`. */
5968
+ end: number;
5969
+ /** Optional formatter for the cursor + endpoint labels. Receives the raw value. */
5970
+ formatValue?: (value: number) => ReactNode;
5971
+ /** Localizable strings. */
5972
+ labels?: TimelineScrubberLabels;
5973
+ /** Change handler — receives the new clamped value. */
5974
+ onValueChange: (value: number) => void;
5975
+ /** Start of the time range. */
5976
+ start: number;
5977
+ /** Step granularity for the underlying range input. Defaults to `1`. */
5978
+ step?: number;
5979
+ /** Optional milestone ticks rendered along the track. */
5980
+ ticks?: TimelineTick[];
5981
+ /** Tone of the filled track + handle. Defaults to `"primary"`. */
5982
+ tone?: TimelineScrubberTone;
5983
+ /** Current scrub value `start..end`. */
5984
+ value: number;
5985
+ } & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onChange"> & react.RefAttributes<HTMLDivElement>>;
5986
+
3926
5987
  /** A single tool call made by the assistant. */
3927
5988
  type ToolCall = {
3928
5989
  id: string;
@@ -4186,4 +6247,4 @@ declare function useHorizontalScroll(): UseHorizontalScrollReturn;
4186
6247
 
4187
6248
  declare function cn(...inputs: ClassValue[]): string;
4188
6249
 
4189
- export { AIChatInput, type AIChatInputProps, AIMessageBubble, type AIMessageBubbleProps, AISourceCitation, type AISourceCitationProps, AIStreamingText, type AIStreamingTextProps, AIToolCallDisplay, type AIToolCallDisplayProps, type AIToolCallStatus, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, ActivityHeatmap, type ActivityHeatmapItem, type ActivityHeatmapProps, ActivityLog, type ActivityLogItem, type ActivityLogProps, type ActivityLogTone, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AnchorPort, type AnchorPortProps, AnimatedText, type AnimatedTextProps, Annotation, type AnnotationProps, AreaChart, AspectRatio, Avatar, AvatarFallback, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, AvatarImage, Badge, type BadgeProps, BarChart, BeforeAfter, type BeforeAfterProps, BlogCard, BorderBeam, type BorderBeamProps, BottomBar, type BottomBarProps, Breadcrumb, type BreadcrumbItem, Button, type ButtonProps, Calendar, type CalendarProps, Callout, type CalloutProps, type CalloutVariant, CandlestickChart, type CandlestickChartProps, type CandlestickDatum, CanvasShell, type CanvasShellInsets, type CanvasShellProps, type CanvasShellRouteConfig, CanvasView, type CanvasViewHandle, type CanvasViewProps, type CanvasViewport, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, CategoryFilter, type ChatDockMessage, ChatDockSection, type ChatDockSectionProps, Checkbox, Checklist, type ChecklistItem, type ChecklistProps, CodeBlock, CodePlayground, type CodePlaygroundProps, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, type ComboboxOption, type ComboboxProps, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, CommonMistake, type CommonMistakeProps, Comparison, type ComparisonProps, CompletionDialog, type CompletionDialogProps, ConnectorEdge, type ConnectorEdgePoint, type ConnectorEdgeProps, Content, ContentCard$1 as ContentCard, ContentIntro, type ContentIntroLabels, type ContentIntroProps, type ContentIntroSection, type ContentMeta, type ContentProgress, type ContentSection, type ContentSectionMinimal, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ConversationEmpty, type ConversationEmptyProps, ConversationHeader, type ConversationHeaderProps, ConversationLoading, type ConversationLoadingProps, type ConversationMessage, ConversationMessages, type ConversationMessagesProps, ConversationScrollButton, type ConversationScrollButtonProps, ConversationSuggestions, type ConversationSuggestionsProps, ConversationThread, type ConversationThreadProps, ConversationTitle, type ConversationTitleProps, CookieConsent, type CookieConsentProps, type CopyStatus, CountdownTimer, type CountdownTimerProps, CreditBadge, type CreditBadgeProps, type CreditBadgeStatus, Curriculum, CurriculumLesson, type CurriculumLessonProps, CurriculumModule, type CurriculumModuleProps, type CurriculumProps, DataList, DataListItem, type DataListItemProps, DataListLabel, type DataListProps, DataListValue, DataTableComponent as DataTable, type DataTableFilter, type DataTableFilterOption, type DataTableProps, DatePicker, type DatePickerProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type DifficultyLevel, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EdgeLabel, type EdgeLabelProps, Exercise, type ExerciseProps, FAQ, FAQItem, type FAQItemProps, type FAQProps, FileTree, type FileTreeProps, FileUpload, type FileUploadProps, FilterBar, type FilterBarLabels, type FilterBarProps, type FilterOption, type FilterUpdates, Flashcard, type FlashcardProps, FloatingActionButton, type FloatingActionButtonProps, FlowControls, type FlowControlsProps, FlowDiagram, type FlowDiagramEdge, type FlowDiagramNode, type FlowDiagramProps, FlowErrorBoundary, FlowFullscreen, type FlowFullscreenProps, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, type FormProps, GlassPanel, type GlassPanelProps, Glossary, type GlossaryProps, GroupHull, type GroupHullProps, Highlight, type HighlightProps, HorizontalScrollRow, type HorizontalScrollRowProps, HoverCard, HoverCardContent, HoverCardTrigger, InfinitePlane, type InfinitePlaneLabels, type InfinitePlanePattern, type InfinitePlaneProps, InlineInput, type InlineInputProps, Input, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, KeyConcept, type KeyConceptProps, type KeyboardShortcut, KeyboardShortcutsHelp, type KeyboardShortcutsHelpProps, LANGUAGE_NAMES, Label, LangProvider, LearningObjectives, type LearningObjectivesProps, LeftRail, type LeftRailProps, type LessonDifficulty, type LessonStatus, LineChart, LiveFeed, type LiveFeedEvent, type LiveFeedProps, MDXContent, MarketTreemap, type MarketTreemapItem, type MarketTreemapProps, Marquee, type MarqueeProps, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MetricGauge, type MetricGaugeProps, type MetricGaugeThreshold, type MiniMapMarker, MiniMapPanel, type MiniMapPanelProps, type ModelInfo, ModelSelector, type ModelSelectorProps, MultiSelect, type MultiSelectOption, type MultiSelectProps, type NavItem, NavbarSaas, type NavbarSaasProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NumberInput, type NumberInputProps, NumberTicker, type NumberTickerProps, ObjectCard, type ObjectCardAction, type ObjectCardMetric, type ObjectCardProps, ObjectHandle, type ObjectHandleProps, OrderBook, type OrderBookLevel, type OrderBookProps, OverviewBoard, type OverviewBoardItem, type OverviewBoardProps, OverviewCard, type OverviewCardProps, type OverviewCardTone, Pagination, type PaginationProps, PasswordInput, type PasswordInputProps, PlanBadge, type PlanBadgeProps, type PlanBadgeState, type PlanBadgeTier, type PlatformConfig, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Prerequisites, type PrerequisitesProps, PresenceStack, type PresenceStackLabels, type PresenceStackProps, type PresenceStatus, type PresenceUser, ProTip, type ProTipProps, type ProTipVariant, ProfileSection, ProgressBar, type ProgressBarProps, ContentCard as ProgressCard, type ContentCardProgress as ProgressCardProgress, type ContentCardProps as ProgressCardProps, ProgressTracker, ProgressTrackerBadge, type ProgressTrackerBadgeProps, ProgressTrackerModule, type ProgressTrackerModuleItem, type ProgressTrackerModuleProps, type ProgressTrackerModuleStatus, ProgressTrackerModules, type ProgressTrackerModulesProps, ProgressTrackerOverview, type ProgressTrackerOverviewProps, type ProgressTrackerProps, ProgressTrackerStat, type ProgressTrackerStatProps, ProgressTrackerStats, type ProgressTrackerStatsProps, Quiz, type QuizOption, type QuizProps, RadioGroup, RadioGroupItem, Rating, type RatingProps, ResizableHandle, ResizablePanel, ResizablePanelGroup, RightDock, type RightDockProps, RoleBadge, type RoleBadgeProps, type RoleBadgeRole, ScopeSelector, type ScopeSelectorNode, type ScopeSelectorProps, type ScopeSelectorSelection, ScrollArea, ScrollBar, SearchBar, SearchDialog, SegmentedControl, SegmentedControlItem, type SegmentedControlItemProps, type SegmentedControlProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SelectionPresence, type SelectionPresenceLabels, type SelectionPresenceProps, Separator, SeverityBadge, type SeverityBadgeLevel, type SeverityBadgeProps, ShareDialog, type ShareDialogLabels, type SharePlatform as ShareDialogPlatform, type ShareDialogProps, type SharePlatform$1 as SharePlatform, type SharePlatformConfig, ShareSection, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, type SidebarItem, SidebarProvider, type SidebarSection, SidebarToggle, type SidebarToggleProps, SimpleTerminal, type SimpleTerminalProps, Skeleton, Slider, Slideshow, type SlideshowLabels, type SlideshowProps, type SlideshowSection, SocialFAB, type SocialFabActionConfig, type SocialFabLabels, type SocialFabProps, SparklineGrid, type SparklineGridItem, type SparklineGridProps, Spinner, type SpinnerProps, StatCard, type StatCardProps, StatusBoard, type StatusBoardItem, type StatusBoardProps, type StatusBoardStatus, StatusIndicator, type StatusIndicatorProps, Step, StepByStep, type StepByStepProps, StepNavigation, type StepNavigationProps, type StepProps, Stepper, type StepperProps, type StepperStep, SubscriptionCard, type SubscriptionCardProps, type SubscriptionCardStatus, Summary, type SummaryProps, Switch, TLDRSection, type TOCSection, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableOfContents, TableOfContentsPanel, type TableOfContentsPanelProps, TableRow, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, TagsInput, type TagsInputProps, Terminal, type TerminalLine, type TerminalProps, Textarea, type TextareaProps, ThemeProvider, ThemeToggle, ThinkingBlock, type ThinkingBlockProps, ThreadBubble, type ThreadBubbleLabels, type ThreadBubbleProps, type ThreadMessage, TickerTape, type TickerTapeItem, type TickerTapeProps, Toast, ToastAction, ToastClose, ToastDescription, type ToastProps, ToastTitle, Toaster, Toggle, ToggleGroup, ToggleGroupItem, type ToolCall, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopBar, type TopBarProps, Tour, type TourProps, type TourStep, TruncatedText, type TruncatedTextProps, TutorialCard, type TutorialCardLabels, type TutorialCardMeta, type TutorialCardProgress, type TutorialCardProps, TutorialComplete, type TutorialCompleteLabels, type TutorialCompleteProps, type TutorialCompleteRelatedContent, type TutorialCompleteSection, TutorialFilters, type TutorialFiltersLabels, type TutorialFiltersProps, TutorialIntroContent, type TutorialIntroContentProps, TutorialMDX, type TutorialMDXProps, type SupportedLanguage as UISupportedLanguage, UnicodeSpinner, type UnicodeSpinnerAnimation, type UnicodeSpinnerProps, UsageBreakdown, type UsageBreakdownItem, type UsageBreakdownProps, type UsageBreakdownTone, type UseFlowDiagramOptions, type UseFlowDiagramReturn, VideoEmbed, type VideoEmbedProps, type ViewOption, ViewSwitcher, type ViewSwitcherProps, type ViewportBookmark, ViewportBookmarks, type ViewportBookmarksLabels, type ViewportBookmarksProps, WalletCard, type WalletCardProps, Watchlist, type WatchlistItem, type WatchlistProps, type WorkspaceOption, WorkspaceSwitcher, type WorkspaceSwitcherProps, WorldBreadcrumbs, type WorldBreadcrumbsLabels, type WorldBreadcrumbsProps, WorldClockBar, type WorldClockBarProps, type WorldClockBarZone, type WorldCrumb, type WorldCrumbKind, ZoomHUD, type ZoomHUDProps, alertVariants, avatarGroupVariants, avatarItemVariants, badgeVariants, buttonVariants, cn, cookieConsentVariants, dataListItemVariants, dataListVariants, dotVariants, getOtherLanguage, mdxComponents, navigationMenuTriggerStyle, segmentedControlItemVariants, segmentedControlVariants, severityBadgeVariants, statCardVariants, statusIndicatorVariants, toggleVariants, useDebounce, useFlowDiagram, useFormField, useHorizontalScroll, useMobile, useProgressTrackerContext, useSidebar, useSocialFab };
6250
+ export { AIChatInput, type AIChatInputProps, AIMessageBubble, type AIMessageBubbleProps, AISourceCitation, type AISourceCitationProps, AIStreamingText, type AIStreamingTextProps, AIToolCallDisplay, type AIToolCallDisplayProps, type AIToolCallStatus, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type ActivityEvent, ActivityHeatmap, type ActivityHeatmapItem, type ActivityHeatmapProps, ActivityLog, type ActivityLogItem, type ActivityLogProps, type ActivityLogTone, type ActivityStripTone, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertPulse, type AlertPulseLabels, type AlertPulseProps, type AlertPulseSeverity, AlertTitle, AnchorPort, type AnchorPortProps, AnimatedText, type AnimatedTextProps, Annotation, type AnnotationProps, AreaChart, AspectRatio, Avatar, AvatarFallback, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, AvatarImage, Badge, type BadgeProps, BarChart, BeforeAfter, type BeforeAfterProps, BlogCard, BorderBeam, type BorderBeamProps, BottomActivityStrip, type BottomActivityStripLabels, type BottomActivityStripProps, BottomBar, type BottomBarProps, Breadcrumb, type BreadcrumbItem, Button, type ButtonProps, Calendar, type CalendarProps, Callout, type CalloutProps, type CalloutVariant, CandlestickChart, type CandlestickChartProps, type CandlestickDatum, CanvasShell, type CanvasShellInsets, type CanvasShellProps, type CanvasShellRouteConfig, CanvasView, type CanvasViewHandle, type CanvasViewProps, type CanvasViewport, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, CategoryFilter, type ChatDockMessage, ChatDockSection, type ChatDockSectionProps, Checkbox, Checklist, type ChecklistItem, type ChecklistProps, CodeBlock, CodePlayground, type CodePlaygroundProps, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, type ComboboxOption, type ComboboxProps, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, CommentPin, type CommentPinLabels, type CommentPinProps, type CommentPinState, CommonMistake, type CommonMistakeProps, Comparison, type ComparisonProps, CompletionDialog, type CompletionDialogProps, ConnectorEdge, type ConnectorEdgePoint, type ConnectorEdgeProps, Content, ContentCard$1 as ContentCard, ContentIntro, type ContentIntroLabels, type ContentIntroProps, type ContentIntroSection, type ContentMeta, type ContentProgress, type ContentSection, type ContentSectionMinimal, ContextLens, type ContextLensFocus, type ContextLensLabels, type ContextLensProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ConversationEmpty, type ConversationEmptyProps, ConversationHeader, type ConversationHeaderProps, ConversationLoading, type ConversationLoadingProps, type ConversationMessage, ConversationMessages, type ConversationMessagesProps, ConversationScrollButton, type ConversationScrollButtonProps, ConversationSuggestions, type ConversationSuggestionsProps, ConversationThread, type ConversationThreadProps, ConversationTitle, type ConversationTitleProps, CookieConsent, type CookieConsentProps, type CopyStatus, CountdownTimer, type CountdownTimerProps, CreditBadge, type CreditBadgeProps, type CreditBadgeStatus, Curriculum, CurriculumLesson, type CurriculumLessonProps, CurriculumModule, type CurriculumModuleProps, type CurriculumProps, DataList, DataListItem, type DataListItemProps, DataListLabel, type DataListProps, DataListValue, DataTableComponent as DataTable, type DataTableFilter, type DataTableFilterOption, type DataTableProps, DatePicker, type DatePickerProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type DifficultyLevel, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EdgeLabel, type EdgeLabelProps, Exercise, type ExerciseProps, FAQ, FAQItem, type FAQItemProps, type FAQProps, FileTree, type FileTreeProps, FileUpload, type FileUploadProps, FilterBar, type FilterBarLabels, type FilterBarProps, type FilterOption, type FilterUpdates, Flashcard, type FlashcardProps, FloatingActionButton, type FloatingActionButtonProps, FloatingToolbar, type FloatingToolbarAction, type FloatingToolbarLabels, type FloatingToolbarProps, FlowControls, type FlowControlsProps, FlowDiagram, type FlowDiagramEdge, type FlowDiagramNode, type FlowDiagramProps, FlowErrorBoundary, FlowFullscreen, type FlowFullscreenProps, FollowMode, type FollowModeColor, type FollowModeLabels, type FollowModeProps, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, type FormProps, GlassPanel, type GlassPanelProps, Glossary, type GlossaryProps, GroupHull, type GroupHullProps, HandoffBeacon, type HandoffBeaconLabels, type HandoffBeaconLevel, type HandoffBeaconProps, HeatOverlay, type HeatOverlayLabels, type HeatOverlayProps, type HeatOverlayTone, type HeatPoint, Highlight, type HighlightProps, HorizontalScrollRow, type HorizontalScrollRowProps, HoverCard, HoverCardContent, HoverCardTrigger, InfinitePlane, type InfinitePlaneLabels, type InfinitePlanePattern, type InfinitePlaneProps, InlineInput, type InlineInputProps, Input, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, JarvisDock, type JarvisDockAction, type JarvisDockLabels, type JarvisDockProps, type JarvisDockTone, KeyConcept, type KeyConceptProps, type KeyboardShortcut, KeyboardShortcutsHelp, type KeyboardShortcutsHelpProps, LANGUAGE_NAMES, Label, LangProvider, type LassoRect, LearningObjectives, type LearningObjectivesProps, LeftRail, type LeftRailProps, type LessonDifficulty, type LessonStatus, LineChart, LiveCursor, type LiveCursorLabels, type LiveCursorProps, LiveFeed, type LiveFeedEvent, type LiveFeedProps, MDXContent, MarketTreemap, type MarketTreemapItem, type MarketTreemapProps, Marquee, type MarqueeProps, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MetricCluster, type MetricClusterAnchor, type MetricClusterEntry, type MetricClusterLabels, type MetricClusterProps, type MetricClusterTone, MetricGauge, type MetricGaugeProps, type MetricGaugeThreshold, type MiniMapMarker, MiniMapPanel, type MiniMapPanelProps, type ModelInfo, ModelSelector, type ModelSelectorProps, MultiSelect, MultiSelectLasso, type MultiSelectLassoLabels, type MultiSelectLassoProps, type MultiSelectOption, type MultiSelectProps, type NavItem, NavbarSaas, type NavbarSaasProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NumberInput, type NumberInputProps, NumberTicker, type NumberTickerProps, ObjectCard, type ObjectCardAction, type ObjectCardMetric, type ObjectCardProps, ObjectHandle, type ObjectHandleProps, ObjectInspector, type ObjectInspectorKind, type ObjectInspectorLabels, type ObjectInspectorProps, type ObjectInspectorStatus, OrderBook, type OrderBookLevel, type OrderBookProps, OverviewBoard, type OverviewBoardItem, type OverviewBoardProps, OverviewCard, type OverviewCardProps, type OverviewCardTone, Pagination, type PaginationProps, PasswordInput, type PasswordInputProps, PlanBadge, type PlanBadgeProps, type PlanBadgeState, type PlanBadgeTier, type PlatformConfig, PlaybackGhost, type PlaybackGhostKind, type PlaybackGhostLabels, type PlaybackGhostProps, PolicyDeliveryPanel, type PolicyDeliveryPanelLabels, type PolicyDeliveryPanelProps, type PolicyEntry, type PolicyStatus, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Prerequisites, type PrerequisitesProps, PresenceStack, type PresenceStackLabels, type PresenceStackProps, type PresenceStatus, PresenceSyncIndicator, type PresenceSyncIndicatorLabels, type PresenceSyncIndicatorProps, type PresenceSyncState, type PresenceUser, ProTip, type ProTipProps, type ProTipVariant, ProfileSection, ProgressBar, type ProgressBarProps, ContentCard as ProgressCard, type ContentCardProgress as ProgressCardProgress, type ContentCardProps as ProgressCardProps, ProgressTracker, ProgressTrackerBadge, type ProgressTrackerBadgeProps, ProgressTrackerModule, type ProgressTrackerModuleItem, type ProgressTrackerModuleProps, type ProgressTrackerModuleStatus, ProgressTrackerModules, type ProgressTrackerModulesProps, ProgressTrackerOverview, type ProgressTrackerOverviewProps, type ProgressTrackerProps, ProgressTrackerStat, type ProgressTrackerStatProps, ProgressTrackerStats, type ProgressTrackerStatsProps, type PropertyEntry, PropertySection, type PropertySectionLabels, type PropertySectionProps, Quiz, type QuizOption, type QuizProps, RadioGroup, RadioGroupItem, Rating, type RatingProps, type RelationshipDirection, type RelationshipEdge, RelationshipInspector, type RelationshipInspectorLabels, type RelationshipInspectorProps, ResizableHandle, ResizablePanel, ResizablePanelGroup, RightDock, type RightDockProps, RoleBadge, type RoleBadgeProps, type RoleBadgeRole, type RoutingAssignment, RoutingAssignmentPanel, type RoutingAssignmentPanelLabels, type RoutingAssignmentPanelProps, type RoutingRole, type RunPhaseState, RunTimeline, type RunTimelineLabels, type RunTimelineLane, type RunTimelinePhase, type RunTimelineProps, type RuntimeMetric, type RuntimeMetricTone, type RuntimeMetricTrend, RuntimeOverviewPanel, type RuntimeOverviewPanelLabels, type RuntimeOverviewPanelProps, ScopeSelector, type ScopeSelectorNode, type ScopeSelectorProps, type ScopeSelectorSelection, ScrollArea, ScrollBar, SearchBar, SearchDialog, SegmentedControl, SegmentedControlItem, type SegmentedControlItemProps, type SegmentedControlProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, type SelectionBounds, SelectionHalo, type SelectionHaloLabels, type SelectionHaloProps, SelectionPresence, type SelectionPresenceLabels, type SelectionPresenceProps, Separator, SeverityBadge, type SeverityBadgeLevel, type SeverityBadgeProps, ShareDialog, type ShareDialogLabels, type SharePlatform as ShareDialogPlatform, type ShareDialogProps, type SharePlatform$1 as SharePlatform, type SharePlatformConfig, ShareSection, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, type SidebarItem, SidebarProvider, type SidebarSection, SidebarToggle, type SidebarToggleProps, SimpleTerminal, type SimpleTerminalProps, Skeleton, Slider, Slideshow, type SlideshowLabels, type SlideshowProps, type SlideshowSection, type SnapGuide, SnapGuides, type SnapGuidesLabels, type SnapGuidesProps, SocialFAB, type SocialFabActionConfig, type SocialFabLabels, type SocialFabProps, SparklineGrid, type SparklineGridItem, type SparklineGridProps, Spinner, type SpinnerProps, StatCard, type StatCardProps, type StateBadgeAnchor, StateBadgeOverlay, type StateBadgeOverlayLabels, type StateBadgeOverlayProps, type StateBadgeState, StatusBoard, type StatusBoardItem, type StatusBoardProps, type StatusBoardStatus, StatusIndicator, type StatusIndicatorProps, Step, StepByStep, type StepByStepProps, StepNavigation, type StepNavigationProps, type StepProps, Stepper, type StepperProps, type StepperStep, StickyMetric, type StickyMetricAnchor, type StickyMetricLabels, type StickyMetricProps, type StickyMetricTone, SubscriptionCard, type SubscriptionCardProps, type SubscriptionCardStatus, Summary, type SummaryProps, Switch, TLDRSection, type TOCSection, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableOfContents, TableOfContentsPanel, type TableOfContentsPanelProps, TableRow, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, TagsInput, type TagsInputProps, Terminal, type TerminalLine, type TerminalProps, Textarea, type TextareaProps, ThemeProvider, ThemeToggle, ThinkingBlock, type ThinkingBlockProps, ThreadBubble, type ThreadBubbleLabels, type ThreadBubbleProps, type ThreadMessage, ThresholdRing, type ThresholdRingLabels, type ThresholdRingProps, type ThresholdRingTone, TickerTape, type TickerTapeItem, type TickerTapeProps, TimelineScrubber, type TimelineScrubberLabels, type TimelineScrubberProps, type TimelineScrubberTone, type TimelineTick, Toast, ToastAction, ToastClose, ToastDescription, type ToastProps, ToastTitle, Toaster, Toggle, ToggleGroup, ToggleGroupItem, type ToolCall, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopBar, type TopBarProps, Tour, type TourProps, type TourStep, TruncatedText, type TruncatedTextProps, TutorialCard, type TutorialCardLabels, type TutorialCardMeta, type TutorialCardProgress, type TutorialCardProps, TutorialComplete, type TutorialCompleteLabels, type TutorialCompleteProps, type TutorialCompleteRelatedContent, type TutorialCompleteSection, TutorialFilters, type TutorialFiltersLabels, type TutorialFiltersProps, TutorialIntroContent, type TutorialIntroContentProps, TutorialMDX, type TutorialMDXProps, type SupportedLanguage as UISupportedLanguage, UnicodeSpinner, type UnicodeSpinnerAnimation, type UnicodeSpinnerProps, UsageBreakdown, type UsageBreakdownItem, type UsageBreakdownProps, type UsageBreakdownTone, type UseFlowDiagramOptions, type UseFlowDiagramReturn, VideoEmbed, type VideoEmbedProps, type ViewOption, ViewSwitcher, type ViewSwitcherProps, type ViewportBookmark, ViewportBookmarks, type ViewportBookmarksLabels, type ViewportBookmarksProps, WalletCard, type WalletCardProps, Watchlist, type WatchlistItem, type WatchlistProps, type WorkspaceOption, WorkspaceSwitcher, type WorkspaceSwitcherProps, WorldBreadcrumbs, type WorldBreadcrumbsLabels, type WorldBreadcrumbsProps, WorldClockBar, type WorldClockBarProps, type WorldClockBarZone, type WorldCrumb, type WorldCrumbKind, ZoomHUD, type ZoomHUDProps, alertVariants, avatarGroupVariants, avatarItemVariants, badgeVariants, buttonVariants, cn, cookieConsentVariants, dataListItemVariants, dataListVariants, dotVariants, getOtherLanguage, mdxComponents, navigationMenuTriggerStyle, segmentedControlItemVariants, segmentedControlVariants, severityBadgeVariants, statCardVariants, statusIndicatorVariants, toggleVariants, useDebounce, useFlowDiagram, useFormField, useHorizontalScroll, useMobile, useProgressTrackerContext, useSidebar, useSocialFab };