@cjlapao/ui-kit 0.2.3 → 0.2.5

package/dist/CapsuleBlueprint-CRy04iCR.d.ts

@@ -1,695 +0,0 @@
-import React__default from 'react';
-
-/**
- * common/theme/glass.ts — Framework-agnostic glass utility module.
- *
- * Extracts all glass logic from Panel into reusable functions and types
- * so that any control (Button, IconButton, DropdownButton, etc.) can
- * compose glass styling without duplicating the Panel implementation.
- *
- * This file is pure TypeScript — no React, Vue, or DOM imports.
- */
-
-/**
- * Backdrop vibrancy level for glass surfaces.
- * - `"low"`     → 1.0× saturation
- * - `"medium"`  → 1.2× saturation (default)
- * - `"high"`    → 1.4× saturation
- * - `number`    → arbitrary multiplier (0 – 2 recommended)
- */
-type GlassVibrancy = "low" | "medium" | "high" | number;
-/**
- * Glass fill transparency level.
- * - `"frosted"` → 65 % light / 25 % dark  (default)
- * - `"light"`   → 85 % light / 35 % dark
- * - `"clear"`   → 30 % light / 10 % dark  (sheer — pair with a light backdrop)
- * - `number`    → 0–1 fraction; light = round(frac × 100), dark = min(round(frac × 30), 30)
- *
- * Only the three presets (and their +10 hover steps) are safelisted. A numeric
- * value emits an arbitrary opacity that Tailwind's scanner cannot see, so the
- * fill silently disappears unless that exact step happens to be generated —
- * see `scripts/generate-safelist.mjs`.
- */
-type GlassOpacity = "frosted" | "light" | "clear" | number;
-/**
- * Specular highlight mode for glass surfaces.
- * - `"none"`    → no specular overlay
- * - `"classic"` → sheen falling from the top edge
- * - `"halo"`    → broad bloom plus two off-centre corner glints
- */
-type SpecularMode = "none" | "classic" | "halo";
-
-declare const BUTTON_VARIANTS: readonly ["solid", "soft", "outline", "ghost", "link", "clear", "icon", "glass"];
-type ButtonVariant = (typeof BUTTON_VARIANTS)[number];
-/** Label weight. Derived from the runtime list for the same reason. */
-declare const BUTTON_WEIGHTS: readonly ["normal", "medium", "semibold", "bold"];
-type ButtonWeight = (typeof BUTTON_WEIGHTS)[number];
-/**
- * The 21 Tailwind palette colours the kit supports.
- *
- * `TrueColor` is derived from this array rather than declared alongside it, so
- * the runtime list and the type can never drift — adding a colour here adds it
- * to the type, the generated theme, and every consumer that enumerates colours.
- */
-declare const TRUE_COLORS: readonly ["red", "orange", "amber", "yellow", "lime", "green", "emerald", "teal", "cyan", "sky", "blue", "indigo", "violet", "purple", "fuchsia", "rose", "slate", "gray", "zinc", "neutral", "stone"];
-/**
- * TrueColor is the only valid color type in the ui-kit theme system.
- * All components, tokens, and utilities must use TrueColor exclusively.
- */
-type TrueColor = (typeof TRUE_COLORS)[number];
-/**
- * Shared size type used across all frameworks and components.
- * Replaces both the old ThemeSize (dead code) and ModalSize.
- */
-type Size = "xs" | "sm" | "md" | "lg" | "xl" | "xxl" | "xxxl" | "2xl" | "3xl" | "full";
-/**
- * The size scale every interactive control shares. Derived from the runtime
- * list so the two cannot drift, and so demos/docs can enumerate it.
- */
-declare const CONTROL_SIZES: readonly ["xs", "sm", "md", "lg", "xl"];
-type ControlSize = (typeof CONTROL_SIZES)[number];
-/**
- * The geometry of an interactive control at each shared size.
- *
- * Every control in the trigger family needs the same answer to "how big is the
- * icon, the box, the spinner at this size". That table was copy-pasted into
- * `Button` (text padding, icon-only padding, icon and spinner sizes) and
- * `IconButton` (square box, icon, `<Spinner>` size) — two copies of one scale,
- * drifting independently. It lives here once; the components import it.
- */
-type ControlSizeTokens = {
-    /** Font size and padding of a labelled control. */
-    text: string;
-    /** Padding of a square (icon-only) control. */
-    iconOnly: string;
-    /** Fixed box of a square control (`IconButton`). */
-    box: string;
-    /** Space between an icon and its label. */
-    gap: string;
-    /** Icon dimensions at this control size — identical across controls. */
-    icon: string;
-    /** Dimensions of the inline spinner inside a labelled control. */
-    spinner: string;
-    /** Size to pass to `<Spinner>` inside a square control. */
-    spinnerSize: ControlSize;
-};
-declare const getControlSizeTokens: (size: ControlSize) => ControlSizeTokens;
-/**
- * The corner radius every trigger-family control shares, so a `Button` next to
- * an `Input` is the same box (both `rounded-lg`). Panel-family containers use
- * `DEFAULT_SURFACE_CORNER` instead — a different scale, deliberately.
- */
-declare const DEFAULT_TRIGGER_CORNER = "rounded-lg";
-/**
- * Strength of a decorative glow behind a control (currently `SearchBar`'s
- * gradient variant).
- */
-declare const GLOW_INTENSITIES: readonly ["subtle", "soft", "medium", "strong"];
-type GlowIntensity = (typeof GLOW_INTENSITIES)[number];
-/**
- * Surface treatments shared by every text-entry control — `Input`, `Textarea`,
- * `SearchBar`. Defined once here so the three are the same box when they sit
- * next to each other in a form.
- */
-declare const INPUT_VARIANTS: readonly ["flat", "elevated", "ghost", "underline", "glass", "gradient"];
-type InputVariant = (typeof INPUT_VARIANTS)[number];
-type InputVariantTokens = {
-    /** Border, fill, radius, shadow, backdrop. */
-    surface: string;
-    /** Text and placeholder colours. */
-    text: string;
-    /** Resting colour for a leading icon or other adornment. */
-    icon: string;
-    /** True when the surface is see-through and sits over unknown content. */
-    translucent: boolean;
-};
-/**
- * The variant's surface with its border colour removed, keeping the width and
- * sides.
- *
- * A validation state paints its own border colour, and `border-rose-500`
- * beside the variant's `border-neutral-300` is a same-specificity collision
- * whose winner is emission order — measured in the built stylesheet,
- * `.border-emerald-500` lands *before* `.border-neutral-300` and
- * `.border-rose-500` after it, so an errored field turned rose and a
- * successful one stayed grey. Strip the colour so only one class can apply.
- */
-declare const stripBorderColor: (surface: string) => string;
-declare const getInputVariantTokens: (variant: InputVariant) => InputVariantTokens;
-/**
- * Surface treatments for containers — `Panel` and anything built on it
- * (`FormSection`). Kept here so the type and the text that sits on those
- * surfaces are defined once, not per component.
- */
-declare const SURFACE_VARIANTS: readonly ["elevated", "outlined", "subtle", "tonal", "default", "glass", "simple", "liquid-glass"];
-type SurfaceVariant = (typeof SURFACE_VARIANTS)[number];
-type SurfaceTextTokens = {
-    /** Section and card headings. */
-    heading: string;
-    /** Body copy. */
-    body: string;
-    /** Secondary copy — descriptions under a label. */
-    description: string;
-    /** Tertiary copy — hints, counters, "optional" markers. */
-    muted: string;
-    /** Hairline between regions of the surface. */
-    divider: string;
-    translucent: boolean;
-};
-declare const getSurfaceTextTokens: (variant: SurfaceVariant) => SurfaceTextTokens;
-/**
- * A full-bleed interactive region on a container surface — a disclosure header,
- * a clickable card row.
- *
- * Two rules learned the hard way, both encoded here so callers cannot get them
- * wrong: a ring colour is inert without a ring *width*, and an outer ring is
- * clipped by any ancestor with `overflow: hidden` (which every `Panel` has), so
- * the ring is inset.
- */
-type SurfaceTriggerTokens = {
-    /** Background wash on hover. Low-alpha, so it works on glass too. */
-    hover: string;
-    /** Complete focus indicator: outline reset, width, inset, colour. */
-    focusRing: string;
-};
-declare const getSurfaceTriggerTokens: (color: TrueColor) => SurfaceTriggerTokens;
-/**
- * Corner radius scale for container surfaces.
- *
- * The token names are historical and do NOT map 1:1 onto Tailwind's radius
- * utilities — `rounded-sm` here is Tailwind's `rounded-lg`. They are kept as
- * they are because the whole kit already calls them by these names and the
- * scale itself is monotonic and correct; renaming would silently reshape every
- * existing card. `getSurfaceCornerRem` exposes the real radius so a demo can
- * label them honestly.
- *
- * `pill` used to be a duplicate of `rounded-lg` (both `rounded-3xl`), which is
- * not what a pill is; it is now a true capsule.
- */
-declare const SURFACE_CORNERS: readonly ["none", "rounded", "rounded-sm", "rounded-md", "rounded-lg", "rounded-xl", "rounded-full", "pill"];
-type SurfaceCorner = (typeof SURFACE_CORNERS)[number];
-/** The radius a container uses when the caller does not pick one. */
-declare const DEFAULT_SURFACE_CORNER: SurfaceCorner;
-declare const getSurfaceCornerClass: (corner: SurfaceCorner) => string;
-declare const getSurfaceCornerRem: (corner: SurfaceCorner) => string;
-/**
- * Container padding, on the same scale every control uses plus a `none` step,
- * so a Panel's padding and the Button inside it are described in one language.
- */
-declare const SURFACE_PADDINGS: readonly ["none", "xs", "sm", "md", "lg", "xl"];
-type SurfacePadding = "none" | ControlSize;
-declare const getSurfacePaddingClass: (padding: SurfacePadding) => string;
-/** Every padding token but `none`, for the callers that require a real inset. */
-declare const getSurfacePaddingClasses: () => Record<SurfacePadding, string>;
-/**
- * Geometry and opacity of the `gradient` variant's glow.
- *
- * `pad` is reserved on the control's own wrapper and `inset` positions the glow
- * inside it, so the halo is drawn **within the control's layout box**. Painting
- * it outside — the obvious way — means any ancestor with `overflow: auto`
- * clips it, and `Panel`'s body is `overflow-auto` by default. Same rule as the
- * inset focus ring.
- */
-type GlowTokens = {
-    /** Padding reserved on the wrapper to hold the halo. */
-    pad: string;
-    /** Glow position inside that padding. The gap left over absorbs the blur. */
-    inset: string;
-    blur: string;
-    idleOpacity: number;
-    focusOpacity: number;
-};
-declare const getGlowTokens: (intensity: GlowIntensity) => GlowTokens;
-/**
- * Glow gradient stops: the tone's 600 and 400 shades, read from Tailwind's own
- * custom properties rather than a hard-coded hex table.
- */
-declare const resolveGlowGradient: (tone: TrueColor, from?: string, to?: string) => [string, string];
-/**
- * Surface treatments for the `SideMenu` container.
- *
- * `sidebar` is the kit's standing look (a translucent blur pushed into the
- * layout), `inset` is a flat panel with a hairline on the content edge,
- * `floating` is a detached rounded card, and `glass` is the kit's liquid-glass
- * language tinted with the menu's tone. The rows inside a menu take the
- * matching treatment automatically.
- */
-declare const SIDEBAR_VARIANTS: readonly ["sidebar", "inset", "floating", "glass"];
-type SidebarVariant = (typeof SIDEBAR_VARIANTS)[number];
-/**
- * How a `SideMenu` collapses on desktop.
- *
- * `icon` shrinks it to an icon rail, `offcanvas` removes the panel from the
- * layout entirely (a small handle at the edge opens it again), and `none`
- * makes the panel non-collapsible.
- */
-declare const SIDEBAR_COLLAPSIBLE_MODES: readonly ["icon", "offcanvas", "none"];
-type SidebarCollapsible = (typeof SIDEBAR_COLLAPSIBLE_MODES)[number];
-/** Which edge of the layout the `SideMenu` sits on. */
-declare const SIDEBAR_SIDES: readonly ["left", "right"];
-type SidebarSide = (typeof SIDEBAR_SIDES)[number];
-/**
- * The media query at which a responsive `SideMenu` becomes an offcanvas
- * overlay (below it) instead of using its desktop collapsible mode (above it).
- */
-declare const SIDEBAR_MOBILE_QUERY = "(max-width: 1023px)";
-interface SideMenuItemTokens {
-    /** Fill of the active row. */
-    bg: string;
-    /** Copy of the active row. */
-    text: string;
-    /** Wash under the cursor on an idle row. */
-    hoverBg: string;
-    /** Copy of an idle row under the cursor. */
-    hoverText: string;
-    /** Icon of the active row. */
-    iconActive: string;
-    /** Icon of an idle row under the cursor. */
-    iconHover: string;
-}
-declare const getSideMenuItemTokens: (color: TrueColor) => SideMenuItemTokens;
-/**
- * Resting copy for an idle `SideMenu` row, per surface context.
- *
- * A see-through surface composites over unknown content, so the light end of
- * the neutral scale disappears on it — the same two-step rule as
- * `getSurfaceTextTokens`.
- */
-declare const SIDEBAR_IDLE_COPY: {
-    readonly solid: {
-        readonly text: "text-neutral-600 dark:text-neutral-400";
-        readonly icon: "text-neutral-400 dark:text-neutral-500";
-    };
-    readonly glass: {
-        readonly text: "text-neutral-800 dark:text-neutral-100";
-        readonly icon: "text-neutral-600 dark:text-neutral-300";
-    };
-};
-type SidebarIdleCopyKind = keyof typeof SIDEBAR_IDLE_COPY;
-interface SidebarSurfaceTokens {
-    /** Fill and blur of the layer painted behind the content. */
-    fill: string;
-    /**
-     * Opaque counterpart of `fill`, for states where the panel grows over other
-     * content (the hover-rail expansion) and must not show it through. A
-     * translucent `fill` there reads as a second, see-through layer.
-     */
-    solidFill: string;
-    /** Edge treatment. Empty when the panel is flush and borderless. */
-    border: string;
-    /** Which edges carry the border: the content-facing one only, or all. */
-    borderSides: "start" | "all";
-    /** Shadow cast toward the content (left-side panel). */
-    shadow: string;
-    /** Shadow cast toward the content (right-side panel). */
-    shadowRight: string;
-    /** Corner radius. Empty when flush. */
-    radius: string;
-    /** Offset from the layout edges ("" = flush, a margin when detached). */
-    offset: string;
-    /** Whether to paint the dither-noise layer. */
-    noise: boolean;
-    /** Whether the row copy needs the see-through contrast step. */
-    idleCopy: SidebarIdleCopyKind;
-}
-/**
- * The container treatment for a `SideMenu` variant. `glass` is resolved from
- * the shared glass module at the call site, so its fill is tinted with the
- * menu's tone and cannot drift from `Panel`'s glass.
- */
-declare const getSidebarSurfaceTokens: (variant: SidebarVariant, color: TrueColor) => SidebarSurfaceTokens;
-type ButtonTheme = Record<ButtonVariant, Record<TrueColor, string>>;
-type ButtonHoverTheme = Record<ButtonVariant, Record<TrueColor, string>>;
-type ButtonActiveTheme = Record<ButtonVariant, Record<TrueColor, string>>;
-type ButtonActiveHoverTheme = Record<ButtonVariant, Record<TrueColor, string>>;
-type ToggleTheme = Record<TrueColor, string>;
-type CheckboxTheme = Record<TrueColor, string>;
-type SpinnerTheme = Record<TrueColor, [string, string, string, string]>;
-type LoaderTheme = Record<TrueColor, {
-    track: string;
-    bar: string;
-}>;
-type MultiToggleTheme = Record<TrueColor, {
-    active: string;
-    activeText: string;
-    indicator: string;
-    hover: string;
-}>;
-type MultiToggleVariantTokens = {
-    softIndicator: string;
-    activeText: string;
-    hover: string;
-};
-type MultiToggleVariantTheme = Record<TrueColor, MultiToggleVariantTokens>;
-type TabsColorTokens = {
-    hoverText: string;
-    activeText: string;
-    onAccentText: string;
-    focusRing: string;
-    accentBg: string;
-    subtleBg: string;
-    subtleHoverBg: string;
-    segmentedContainer: string;
-    badgeSubtle: string;
-    badgeStrong: string;
-    badgeOnAccent: string;
-    underlineActive: string;
-};
-type TabsTheme = Record<TrueColor, TabsColorTokens>;
-type PanelToneConfig = {
-    border: string;
-    /**
-     * Hairline for the `outlined` variant. Deliberately lighter than `border`
-     * and paired with a low-alpha dark value, so the outline reads as a hairline
-     * in both modes instead of a hard rule in light mode.
-     */
-    outlineBorder: string;
-    heading: string;
-    muted: string;
-    badge: string;
-    subtleBg: string;
-    tonalBg: string;
-    glassBg: string;
-    glassBorder: string;
-    liquidBg: string;
-    liquidBorder: string;
-    liquidShadow: string;
-    liquidHeading: string;
-    overlayGradient: string;
-    decorationShape: string;
-    decorationGradient: string;
-};
-type PanelTheme = Record<TrueColor, PanelToneConfig>;
-type StepperToneConfig = {
-    activeBg: string;
-    activeText: string;
-    completedBg: string;
-    completedText: string;
-    pendingBorder: string;
-    pendingText: string;
-    underlineBase: string;
-};
-type StepperTheme = Record<TrueColor, StepperToneConfig>;
-type BadgeTheme = Record<TrueColor, string>;
-type PillTheme = Record<TrueColor, Record<"solid" | "soft" | "outline", {
-    base: string;
-    border?: string;
-}>>;
-type AlertTheme = Record<TrueColor, {
-    subtle: string;
-    solid: string;
-    outline: string;
-    icon: string;
-    text: string;
-    border: string;
-    dismiss: string;
-}>;
-type StatTileTheme = Record<TrueColor, {
-    decorationBg: string;
-    iconColor: string;
-    divider: string;
-}>;
-type ButtonSelectorColorTokens = {
-    selectedBorder: string;
-    selectedBg: string;
-    selectedIcon: string;
-    selectedLabel: string;
-    selectedIndicatorBg: string;
-    selectedIndicatorBorder: string;
-    selectedIndicatorDot: string;
-};
-type ButtonSelectorTheme = Record<TrueColor, ButtonSelectorColorTokens>;
-interface ThemeDefinition {
-    button: ButtonTheme;
-    buttonHover: ButtonHoverTheme;
-    buttonActive: ButtonActiveTheme;
-    buttonActiveHover: ButtonActiveHoverTheme;
-    toggle: ToggleTheme;
-    checkbox: CheckboxTheme;
-    spinner: SpinnerTheme;
-    loader: LoaderTheme;
-    multiToggle: MultiToggleTheme;
-    multiToggleVariant: MultiToggleVariantTheme;
-    tabs: TabsTheme;
-    panel: PanelTheme;
-    stepper: StepperTheme;
-    badge: BadgeTheme;
-    pill: PillTheme;
-    alert: AlertTheme;
-    statTile: StatTileTheme;
-    buttonSelector: ButtonSelectorTheme;
-}
-type DeepPartial<T> = {
-    [K in keyof T]?: T[K] extends Record<string, unknown> ? DeepPartial<T[K]> : T[K];
-};
-declare const configureTheme: (overrides: DeepPartial<ThemeDefinition>) => void;
-declare const resetTheme: () => void;
-declare const getButtonColorClasses: (variant: ButtonVariant, color: TrueColor) => string;
-declare const getButtonHoverClasses: (variant: ButtonVariant, color: TrueColor) => string;
-declare const getButtonActiveClasses: (variant: ButtonVariant, color: TrueColor) => string;
-declare const getButtonActiveHoverClasses: (variant: ButtonVariant, color: TrueColor) => string;
-declare const getButtonBaseClasses: (variant: ButtonVariant, color: TrueColor) => string;
-/**
- * The `ButtonVariant`s that read as a slider.
- *
- * `link` and `clear` are text treatments — a slider has no text to treat —
- * and `icon` is a square affordance, so all three are excluded rather than
- * aliased onto something else. What remains covers the full range a track
- * can express: a saturated fill, a tinted one, a bordered wash, a quiet
- * translucent one and a frosted one.
- */
-declare const SLIDER_VARIANTS: readonly ["solid", "soft", "outline", "ghost", "glass"];
-type SliderVariant = (typeof SLIDER_VARIANTS)[number];
-interface SliderVariantTokens {
-    /** Paint for the active track segment, from the start (or min handle) to the value. */
-    fill: string;
-    /** Border of the handle. */
-    handle: string;
-    /** The handle's focus-ring colour, including its `focus-visible:` prefix. */
-    ring: string;
-}
-/**
- * Slider treatments — the same visual language `Button` uses, mapped onto a
- * slider's two paintable surfaces (the track segment and the handle) so a
- * slider dropped next to a button row reads as part of the same UI.
- */
-declare const getSliderVariantTokens: (color: TrueColor, variant: SliderVariant) => SliderVariantTokens;
-/**
- * The `ButtonVariant`s that read as a toggle.
- *
- * Same rationale as `SLIDER_VARIANTS`: `link` and `clear` are text treatments
- * a track has nothing to treat, and `icon` is a square affordance. What
- * remains covers the full range a track can express — a saturated fill, a
- * tinted one, a bordered wash, a quiet translucent one and a frosted one.
- */
-declare const TOGGLE_VARIANTS: readonly ["solid", "soft", "outline", "ghost", "glass"];
-type ToggleVariant = (typeof TOGGLE_VARIANTS)[number];
-interface ToggleVariantTokens {
-    /** Paint for the track when the switch is on (carries `peer-checked:`). */
-    track: string;
-    /** The thumb's focus-ring colour, driven off the input's `focus-visible`. */
-    ring: string;
-    /** True when the on-state fill is see-through and sits over unknown content. */
-    translucent: boolean;
-}
-/**
- * Toggle treatments — the same visual language `Button` and `Slider` use,
- * mapped onto the toggle's one paintable surface (the on-state track fill) so
- * a toggle dropped next to a button or slider reads as part of the same UI.
- *
- * The off-state track is deliberately identical across variants — the neutral
- * base — so the on-state fill is what expresses the treatment, exactly as a
- * slider's neutral track does.
- *
- * The `glass` token only carries the frosted fill; the backdrop blur,
- * vibrancy and specular overlay stay with the component, because they depend
- * on the `glassOpacity` / `vibrancy` / `specularMode` props. The same numeric
- * opacity caveat as `getGlassFillClass` applies: only the three presets are
- * safelisted.
- */
-declare const getToggleVariantTokens: (color: TrueColor, variant: ToggleVariant, glassOpacity?: GlassOpacity) => ToggleVariantTokens;
-declare const getToggleColorClasses: (color: TrueColor) => string;
-/**
- * @deprecated Returns `accent-{color}-600`, which only paints a *native*
- * checkbox — and a native checkbox ignores border, radius and background, so
- * every other class the control carried was dead. Use
- * `getCheckboxControlTokens`, which styles a real box.
- */
-declare const getCheckboxColorClasses: (color: TrueColor) => string;
-interface CheckboxControlTokens {
-    /** Fill and border of the box once checked or indeterminate. */
-    checked: string;
-    /** Focus ring, driven off the sibling input's focus. */
-    ring: string;
-    /** Colour of the tick/dash glyph, which sits on the checked fill. */
-    glyph: string;
-}
-/**
- * Fills step to `-700` light / `-400` dark rather than the `-600` / `-500` the
- * native `accent-color` used, for the same reason `Alert`'s solid variant does:
- * a white glyph on `{color}-600` measures 2.94:1 on yellow and 3.06 on lime,
- * under even the 3:1 that WCAG asks of a *graphical* object, and on a `-500`
- * fill it is worse. At `-700` under white and `-400` under `{color}-950` the
- * worst case across all 21 tones is 4.93:1.
- */
-interface CheckboxVariantTokens {
-    /** Fill, shadow and backdrop of the resting box. */
-    fill: string;
-    /** Resting border colour. Replaced wholesale by the error state. */
-    border: string;
-    /** Border colour under the cursor. */
-    hover: string;
-    /** True when the box is see-through and sits over unknown content. */
-    translucent: boolean;
-}
-declare const getCheckboxVariantTokens: (variant: InputVariant) => CheckboxVariantTokens;
-declare const getCheckboxControlTokens: (color: TrueColor) => CheckboxControlTokens;
-declare const getSpinnerColorTokens: (color: TrueColor) => [string, string, string, string];
-declare const getLoaderProgressColors: (color: TrueColor) => {
-    track: string;
-    bar: string;
-};
-declare const getMultiToggleColorTokens: (color: TrueColor) => {
-    active: string;
-    activeText: string;
-    indicator: string;
-    hover: string;
-};
-declare const getMultiToggleVariantTokens: (color: TrueColor) => MultiToggleVariantTokens;
-declare const getTabsColorTokens: (color: TrueColor) => TabsColorTokens;
-declare const getPanelToneStyles: (tone: TrueColor) => PanelToneConfig;
-declare const getStepperTonePalette: (tone: TrueColor) => StepperToneConfig;
-declare const getBadgeColorClasses: (color: TrueColor) => string;
-declare const getPillColorClasses: (color: TrueColor, variant: "solid" | "soft" | "outline") => {
-    base: string;
-    border?: string;
-};
-/**
- * @deprecated Use `getAlertVariantTokens(color, variant)`. This bag hands the
- * same icon/text/dismiss classes to every variant, which is unreadable on
- * `solid`. Kept so existing call sites keep compiling.
- */
-declare const getAlertColorClasses: (color: TrueColor) => AlertTheme[TrueColor];
-/**
- * Alert treatments. `glass` and `liquid-glass` are the same pair `Panel` and
- * `Pill` offer, so a callout dropped on a glass card no longer has to be the
- * one opaque slab in the layout.
- */
-declare const ALERT_VARIANTS: readonly ["subtle", "solid", "outline", "glass", "liquid-glass"];
-type AlertVariant = (typeof ALERT_VARIANTS)[number];
-/**
- * Where the leading icon sits against the callout's content.
- *
- * `top` is the default and the only one that was previously possible: the icon
- * centres on the *title's* line box, which is what you want for a one- or
- * two-line callout. `center` centres it against the whole block — right when
- * the body runs long enough that a top-aligned glyph looks stranded — and
- * `bottom` pins it to the last line.
- */
-declare const ALERT_ICON_ALIGNMENTS: readonly ["top", "center", "bottom"];
-type AlertIconAlign = (typeof ALERT_ICON_ALIGNMENTS)[number];
-/**
- * What the callout *means*, as opposed to what colour it is.
- *
- * Both kits' demos have been passing `tone="info"` / `"success"` / `"warning"`
- * / `"danger"` since tone became a `TrueColor` — none of them are one, so every
- * such alert fell through to the blue fallback and four "different" tones
- * rendered identically. The semantics were real and worth keeping; they just
- * belong in their own prop, which resolves to a tone *and* the right icon *and*
- * the right live-region politeness.
- */
-declare const ALERT_INTENTS: readonly ["info", "success", "warning", "danger", "neutral"];
-type AlertIntent = (typeof ALERT_INTENTS)[number];
-interface AlertIntentConfig {
-    tone: TrueColor;
-    /** Registry icon name used when the caller does not supply one. */
-    icon: string;
-    /**
-     * How assistive technology should announce it. `role="alert"` is an
-     * *assertive* live region: it interrupts whatever the user is reading, which
-     * is right for a failure and wrong for a page that merely renders an
-     * informational banner on load.
-     */
-    live: "assertive" | "polite";
-}
-declare const ALERT_INTENT_CONFIG: Record<AlertIntent, AlertIntentConfig>;
-interface AlertVariantTokens {
-    /** Fill plus the callout's base copy colour. */
-    surface: string;
-    /** Border colour. The `border` utility itself is on the base class. */
-    border: string;
-    /** Leading icon. */
-    icon: string;
-    /** Secondary copy under the title. */
-    text: string;
-    /** Dismiss button: rest, hover and focus ring. */
-    dismiss: string;
-}
-/**
- * Replaces the old flat `getAlertColorClasses` bag, which handed the *same*
- * `icon`, `text` and `dismiss` classes to every variant. On `solid` — a
- * `{color}-600` fill — that painted the description `{color}-700` and the icon
- * `{color}-500`, i.e. a dark tone on a saturated tone of itself. It was
- * unreadable at every tone and no test could see it.
- */
-declare const getAlertVariantTokens: (color: TrueColor, variant: AlertVariant) => AlertVariantTokens;
-declare const getStatTileColorClasses: (color: TrueColor) => StatTileTheme[TrueColor];
-
-type IconName = "Add" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "Attached" | "Attachment" | "Back" | "Blueprint" | "Bug" | "Chat" | "CheckCircle" | "ChevronLeft" | "ChevronRight" | "Clean" | "Close" | "Close1" | "CloudOff" | "Cog" | "Complete" | "Container" | "CopyClipboard" | "Dashboard" | "Details" | "Docker copy" | "Docker" | "Dots" | "Download" | "Edit" | "Equal" | "Error" | "Export" | "EyeClosed" | "EyeOpen" | "Globe" | "Help" | "Idea" | "Image" | "Info" | "Key" | "LXC-Old" | "LXC" | "Log" | "Moon" | "Notification" | "Official" | "Offline" | "OpenApp" | "Parameter" | "Pause" | "Praise" | "ReportFeedback" | "Reset" | "Restart" | "Rocket" | "Run" | "Save" | "Scale" | "Script" | "Search" | "Send" | "Settings" | "Shop" | "Star" | "Stop" | "Sun" | "Suspend" | "ThemeAuto" | "ThemeDark" | "ThemeLight" | "Trash" | "UX" | "User" | "Users" | "Verified" | "ViewGrid" | "ViewRows" | "Library" | "Host" | "VirtualMachine" | "Role" | "Roles" | "Cache" | "Claim" | "Claims" | "KeyManagement" | "Windows" | "Ubuntu" | "Debian" | "Apple" | "KaliLinux" | "RedHat" | "Fedora" | "CentOS" | "Clone" | "Copy" | "Live" | "HealthCheck" | "ReverseProxy" | "ReverseProxyCORS" | "ReverseProxyRoutes" | "ReverseProxyFrom" | "ReverseProxyHeadersRequest" | "ReverseProxyHeadersResponse" | "ReverseProxyHTTP" | "ReverseProxyTo" | "ReverseProxyTLS" | "ReverseProxyTCP" | "Refresh" | "Calendar" | "Folder" | "Jobs" | "Warning" | "Artifactory" | "Azure" | "Minio" | "Aws" | "Orchestrator" | "Podman" | "PodmanDesktop" | "Group" | "Pin" | "Database" | "RemoteHost" | "Login" | "Logout" | "Snapshot" | "Revert" | "CleanBrush" | "Pull" | "Push" | "CatalogVersion" | "File" | "Revoke" | "Taint" | "Unlock" | "Check" | "ArrowChevronLeft" | "ArrowChevronRight" | "Drag";
-declare const iconRegistry: Record<IconName, React__default.ForwardRefExoticComponent<React__default.SVGProps<SVGSVGElement>>>;
-
-type HelpButtonPlacement = "top" | "bottom" | "left" | "right" | "auto";
-interface HelpButtonProps {
-    /**
-     * Help content to display in the panel.
-     * Pass a `string` to render as Markdown (tables and URLs supported).
-     * Pass a `ReactNode` to render arbitrary JSX directly.
-     */
-    content: string | React__default.ReactNode;
-    /** Optional title shown in the panel header. Defaults to "Help". */
-    title?: React__default.ReactNode;
-    /**
-     * Preferred placement of the floating panel relative to the trigger button.
-     * "auto" (default) picks the side with the most available space.
-     */
-    placement?: HelpButtonPlacement;
-    /** Accent color for the trigger button and the panel header stripe. */
-    color?: TrueColor;
-    /** Size of the trigger icon button. */
-    size?: "xs" | "sm" | "md" | "lg";
-    /** Icon for the trigger button. Defaults to "Help". */
-    icon?: IconName;
-    /** Maximum width of the floating panel in px. Defaults to 360. */
-    maxWidth?: number;
-    /** Extra class applied to the root wrapper. */
-    className?: string;
-}
-declare const HelpButton: React__default.FC<HelpButtonProps>;
-
-declare enum CapsuleBlueprintValueType {
-    String = "string",
-    Int = "int",
-    Boolean = "boolean",
-    Select = "select",
-    List = "list",
-    Map = "map"
-}
-interface CapsuleBlueprintParameter {
-    name: string;
-    key: string;
-    description?: string;
-    type?: string;
-    value_type?: CapsuleBlueprintValueType;
-    default?: any;
-    required?: boolean;
-    is_required?: boolean;
-    is_secret?: boolean;
-    options?: any;
-    hint?: string;
-    help?: string;
-    service_name?: string;
-    depends_on?: string[];
-    [key: string]: any;
-}
-
-export { type SideMenuItemTokens as $, type AlertIntent as A, type ButtonVariant as B, type ControlSize as C, CapsuleBlueprintValueType as D, type CheckboxControlTokens as E, type CheckboxVariantTokens as F, type GlassOpacity as G, type HelpButtonProps as H, type IconName as I, type ControlSizeTokens as J, DEFAULT_SURFACE_CORNER as K, DEFAULT_TRIGGER_CORNER as L, GLOW_INTENSITIES as M, type GlowTokens as N, INPUT_VARIANTS as O, type InputVariantTokens as P, SIDEBAR_COLLAPSIBLE_MODES as Q, SIDEBAR_IDLE_COPY as R, type SurfaceCorner as S, type TrueColor as T, SIDEBAR_MOBILE_QUERY as U, SIDEBAR_SIDES as V, SIDEBAR_VARIANTS as W, SLIDER_VARIANTS as X, SURFACE_CORNERS as Y, SURFACE_PADDINGS as Z, SURFACE_VARIANTS as _, type AlertVariant as a, type SidebarIdleCopyKind as a0, type SidebarSurfaceTokens as a1, type SliderVariantTokens as a2, type SurfaceTriggerTokens as a3, TOGGLE_VARIANTS as a4, TRUE_COLORS as a5, type ToggleVariantTokens as a6, configureTheme as a7, getAlertColorClasses as a8, getAlertVariantTokens as a9, getSurfacePaddingClasses as aA, getSurfaceTextTokens as aB, getSurfaceTriggerTokens as aC, getTabsColorTokens as aD, getToggleColorClasses as aE, getToggleVariantTokens as aF, iconRegistry as aG, resetTheme as aH, resolveGlowGradient as aI, stripBorderColor as aJ, HelpButton as aK, getBadgeColorClasses as aa, getButtonActiveClasses as ab, getButtonActiveHoverClasses as ac, getButtonBaseClasses as ad, getButtonColorClasses as ae, getButtonHoverClasses as af, getCheckboxColorClasses as ag, getCheckboxControlTokens as ah, getCheckboxVariantTokens as ai, getControlSizeTokens as aj, getGlowTokens as ak, getInputVariantTokens as al, getLoaderProgressColors as am, getMultiToggleColorTokens as an, getMultiToggleVariantTokens as ao, getPanelToneStyles as ap, getPillColorClasses as aq, getSideMenuItemTokens as ar, getSidebarSurfaceTokens as as, getSliderVariantTokens as at, getSpinnerColorTokens as au, getStatTileColorClasses as av, getStepperTonePalette as aw, getSurfaceCornerClass as ax, getSurfaceCornerRem as ay, getSurfacePaddingClass as az, type AlertIconAlign as b, type GlassVibrancy as c, type SpecularMode as d, type ButtonWeight as e, type SurfacePadding as f, type SurfaceVariant as g, type InputVariant as h, type GlowIntensity as i, type SliderVariant as j, type ToggleVariant as k, type Size as l, type SidebarVariant as m, type SidebarSide as n, type SidebarCollapsible as o, type CapsuleBlueprintParameter as p, type SurfaceTextTokens as q, ALERT_ICON_ALIGNMENTS as r, ALERT_INTENTS as s, ALERT_INTENT_CONFIG as t, ALERT_VARIANTS as u, type AlertIntentConfig as v, type AlertVariantTokens as w, BUTTON_VARIANTS as x, BUTTON_WEIGHTS as y, CONTROL_SIZES as z };