@cjlapao/ui-kit 0.2.3 → 0.2.4

package/dist/CapsuleBlueprint-CpHqUsJK.d.cts

@@ -1,786 +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 two layouts a linear control can take.
- *
- * This union was declared independently in `Slider`, `Rating`, `AppDivider`,
- * `Stepper` and `Tabs` (five names for one scale), so a rename or addition in
- * the theme would never reach any of them. It lives here once; each control
- * keeps its own alias (`SliderOrientation`, …) so call sites and the barrels
- * are unaffected.
- */
-declare const ORIENTATIONS: readonly ["horizontal", "vertical"];
-type Orientation = (typeof ORIENTATIONS)[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.
- *
- * Capsule radii (`rounded-full` / `pill`) are not part of the container scale:
- * a capsule is a shape, and the `Pill` component owns it. Containers that need
- * one take a `rounded-full` class directly.
- */
-declare const SURFACE_CORNERS: readonly ["none", "rounded", "rounded-sm", "rounded-md", "rounded-lg", "rounded-xl"];
-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>;
-/**
- * The tones that read as "no tint". Consumers that tint chrome per tone
- * (Table's header band, for instance) route these through the neutral
- * treatment instead of painting a grey-blue header.
- */
-declare const NEUTRAL_TONES: TrueColor[];
-/**
- * Cell density for data grids. Deliberately orthogonal to the surface
- * variant: the variant decides how the container is drawn, the density how
- * tight the cells inside it sit. A compact table on glass must read the same
- * as a compact table on an outlined card.
- */
-declare const TABLE_DENSITIES: readonly ["default", "compact", "minimal"];
-type TableDensity = (typeof TABLE_DENSITIES)[number];
-type TableDensityTokens = {
-    /** Padding + text size for body and header cells. */
-    cell: string;
-    /** Leading cell of a row (overrides `cell`'s left padding). */
-    sideLeft: string;
-    /** Trailing cell of a row (overrides `cell`'s right padding). */
-    sideRight: string;
-    /** Vertical padding inside the cell's inner flex wrapper. */
-    contentVertical: string;
-};
-declare const getTableDensityTokens: (density: TableDensity) => TableDensityTokens;
-/**
- * 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, `floating-glass` is that card in the
- * kit's liquid-glass language, and `glass` is the liquid-glass language flush
- * in the layout — both glass treatments are tinted with the menu's tone. The
- * rows inside a menu take the matching treatment automatically.
- */
-declare const SIDEBAR_VARIANTS: readonly ["sidebar", "inset", "floating", "floating-glass", "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 the row copy needs the see-through contrast step. */
-    idleCopy: SidebarIdleCopyKind;
-}
-/**
- * The container treatment for a `SideMenu` variant. The glass treatments are
- * resolved from the shared glass module at the call site, so their fill is
- * tinted with the menu's tone and cannot drift from `Panel`'s glass.
- * `floating-glass` is the glass treatment with the floating card's geometry
- * (offset, radius) layered on top.
- */
-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];
-/**
- * The geometry of a `StatusSpinner` at each shared control size.
- *
- * The wrapper is the same circle `Spinner` draws at that size, so the two can
- * sit side by side and line up; the dot and the ring width scale with it.
- */
-interface StatusSpinnerSizeTokens {
-    /** Outer circle. Matches `Spinner`'s diameter at the same size. */
-    wrapper: string;
-    /** Centre dot. */
-    dot: string;
-    /** Ring border width. */
-    border: string;
-}
-declare const getStatusSpinnerSizeTokens: (size: ControlSize) => StatusSpinnerSizeTokens;
-/**
- * The paint of a `StatusSpinner` in one tone.
- *
- * Generated from `TRUE_COLORS` — there is no hand-written per-colour map to
- * drift. `dot` is the one class-shaped token (both steps are already in the
- * generated safelist); the arc and track are CSS colours rather than classes,
- * because the four border sides carry four different values and a `dark:`
- * variant cannot reach an inline style. They read the tone's own Tailwind
- * variable — emitted for all 21 tones — and `color-mix` derives the track and
- * the glow from it, so a tone can never render as another colour.
- */
-interface StatusSpinnerToneTokens {
-    /** Centre dot fill. */
-    dot: string;
-    /** The rotating arc, as a CSS colour. */
-    arc: string;
-    /** The idle ring (30% of the tone), as a CSS colour. */
-    track: string;
-    /** The halo around the dot, as a CSS colour. */
-    glow: string;
-}
-declare const getStatusSpinnerToneTokens: (tone: TrueColor) => StatusSpinnerToneTokens;
-/**
- * The paint of a `ProgressSpinner` in one tone.
- *
- * The same generated-from-`TRUE_COLORS` approach as `StatusSpinner`: the arc
- * reads the tone's own Tailwind variable and `color-mix` derives the idle
- * track from it, so a tone can never render as another colour. The inline
- * SVG cannot use `dark:` variants, which is why these are CSS colours rather
- * than classes.
- */
-interface ProgressSpinnerToneTokens {
-    /** The moving arc (or the determinate range), as a CSS colour. */
-    arc: string;
-    /** The idle ring (30% of the tone), as a CSS colour. */
-    track: string;
-}
-declare const getProgressSpinnerToneTokens: (tone: TrueColor) => ProgressSpinnerToneTokens;
-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" | "ChartLine";
-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 { SIDEBAR_VARIANTS as $, type AlertIntent as A, type ButtonVariant as B, type ControlSize as C, CONTROL_SIZES as D, CapsuleBlueprintValueType as E, type CheckboxControlTokens as F, type GlassOpacity as G, type HelpButtonProps as H, type IconName as I, type CheckboxVariantTokens as J, type ControlSizeTokens as K, DEFAULT_SURFACE_CORNER as L, DEFAULT_TRIGGER_CORNER as M, GLOW_INTENSITIES as N, type Orientation as O, type GlowTokens as P, INPUT_VARIANTS as Q, type InputVariantTokens as R, type SurfaceCorner as S, type TrueColor as T, NEUTRAL_TONES as U, ORIENTATIONS as V, type ProgressSpinnerToneTokens as W, SIDEBAR_COLLAPSIBLE_MODES as X, SIDEBAR_IDLE_COPY as Y, SIDEBAR_MOBILE_QUERY as Z, SIDEBAR_SIDES as _, type AlertVariant as a, SLIDER_VARIANTS as a0, SURFACE_CORNERS as a1, SURFACE_PADDINGS as a2, SURFACE_VARIANTS as a3, type SideMenuItemTokens as a4, type SidebarIdleCopyKind as a5, type SidebarSurfaceTokens as a6, type SliderVariantTokens as a7, type StatusSpinnerSizeTokens as a8, type StatusSpinnerToneTokens as a9, getProgressSpinnerToneTokens as aA, getSideMenuItemTokens as aB, getSidebarSurfaceTokens as aC, getSliderVariantTokens as aD, getSpinnerColorTokens as aE, getStatTileColorClasses as aF, getStatusSpinnerSizeTokens as aG, getStatusSpinnerToneTokens as aH, getStepperTonePalette as aI, getSurfaceCornerClass as aJ, getSurfaceCornerRem as aK, getSurfacePaddingClass as aL, getSurfacePaddingClasses as aM, getSurfaceTextTokens as aN, getSurfaceTriggerTokens as aO, getTableDensityTokens as aP, getTabsColorTokens as aQ, getToggleColorClasses as aR, getToggleVariantTokens as aS, iconRegistry as aT, resetTheme as aU, resolveGlowGradient as aV, stripBorderColor as aW, HelpButton as aX, type SurfaceTriggerTokens as aa, TABLE_DENSITIES as ab, TOGGLE_VARIANTS as ac, TRUE_COLORS as ad, type TableDensityTokens as ae, type ToggleVariantTokens as af, configureTheme as ag, getAlertColorClasses as ah, getAlertVariantTokens as ai, getBadgeColorClasses as aj, getButtonActiveClasses as ak, getButtonActiveHoverClasses as al, getButtonBaseClasses as am, getButtonColorClasses as an, getButtonHoverClasses as ao, getCheckboxColorClasses as ap, getCheckboxControlTokens as aq, getCheckboxVariantTokens as ar, getControlSizeTokens as as, getGlowTokens as at, getInputVariantTokens as au, getLoaderProgressColors as av, getMultiToggleColorTokens as aw, getMultiToggleVariantTokens as ax, getPanelToneStyles as ay, getPillColorClasses 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 TableDensity as p, type CapsuleBlueprintParameter as q, type SurfaceTextTokens as r, ALERT_ICON_ALIGNMENTS as s, ALERT_INTENTS as t, ALERT_INTENT_CONFIG as u, ALERT_VARIANTS as v, type AlertIntentConfig as w, type AlertVariantTokens as x, BUTTON_VARIANTS as y, BUTTON_WEIGHTS as z };