@cjlapao/ui-kit 0.2.3 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cjlapao/ui-kit",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cjlapao/ui-kit.git",
@@ -63,7 +63,7 @@
   },
   "devDependencies": {
     "@tailwindcss/cli": "^4.3.3",
-    "@tailwindcss/postcss": "4.3.1",
+    "@tailwindcss/postcss": "4.3.3",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@types/d3-array": "^3.2.2",
@@ -81,7 +81,7 @@
     "eslint": "^9.39.5",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "jsdom": "^29.1.1",
-    "postcss": "^8.5.15",
+    "postcss": "^8.5.31",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "tailwindcss": "4.3.1",

package/dist/CapsuleBlueprint--CgRT7dr.d.cts

@@ -1,426 +0,0 @@
-import React__default from 'react';
-
-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];
-/**
- * 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;
-};
-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];
-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;
-declare const getToggleColorClasses: (color: TrueColor) => string;
-declare const getCheckboxColorClasses: (color: TrueColor) => string;
-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 { getPillColorClasses as $, type AlertIntent as A, type ButtonVariant as B, type ControlSize as C, DEFAULT_SURFACE_CORNER as D, type SurfaceTriggerTokens as E, TRUE_COLORS as F, type GlowIntensity as G, type HelpButtonProps as H, type IconName as I, configureTheme as J, getAlertColorClasses as K, getAlertVariantTokens as L, getBadgeColorClasses as M, getButtonActiveClasses as N, getButtonActiveHoverClasses as O, getButtonBaseClasses as P, getButtonColorClasses as Q, getButtonHoverClasses as R, type SurfaceCorner as S, type TrueColor as T, getCheckboxColorClasses as U, getGlowTokens as V, getInputVariantTokens as W, getLoaderProgressColors as X, getMultiToggleColorTokens as Y, getMultiToggleVariantTokens as Z, getPanelToneStyles as _, type AlertVariant as a, getSpinnerColorTokens as a0, getStatTileColorClasses as a1, getStepperTonePalette as a2, getSurfaceCornerClass as a3, getSurfaceCornerRem as a4, getSurfacePaddingClass as a5, getSurfacePaddingClasses as a6, getSurfaceTextTokens as a7, getSurfaceTriggerTokens as a8, getTabsColorTokens as a9, getToggleColorClasses as aa, iconRegistry as ab, resetTheme as ac, resolveGlowGradient as ad, HelpButton as ae, type AlertIconAlign as b, type ButtonWeight as c, type SurfacePadding as d, type SurfaceVariant as e, type InputVariant as f, type Size as g, type CapsuleBlueprintParameter as h, type SurfaceTextTokens as i, ALERT_ICON_ALIGNMENTS as j, ALERT_INTENTS as k, ALERT_INTENT_CONFIG as l, ALERT_VARIANTS as m, type AlertIntentConfig as n, type AlertVariantTokens as o, BUTTON_VARIANTS as p, BUTTON_WEIGHTS as q, CONTROL_SIZES as r, CapsuleBlueprintValueType as s, GLOW_INTENSITIES as t, type GlowTokens as u, INPUT_VARIANTS as v, type InputVariantTokens as w, SURFACE_CORNERS as x, SURFACE_PADDINGS as y, SURFACE_VARIANTS as z };