@logicplanes/kaeso-ui 0.1.0

package/dist/types/components/tabs/docs.d.ts

@@ -0,0 +1,22 @@
+export declare const docs: {
+    PillTabs: {
+        description: string;
+        props: {
+            children: string;
+            defaultValue: string;
+            onValueChange: string;
+            value: string;
+            variant: string;
+        };
+    };
+    Tabs: {
+        description: string;
+        props: {
+            children: string;
+            defaultValue: string;
+            onValueChange: string;
+            value: string;
+            variant: string;
+        };
+    };
+};

package/dist/types/components/tabs/index.d.ts

@@ -0,0 +1 @@
+export * from "./tabs.js";

package/dist/types/components/tabs/tabs.d.ts

@@ -0,0 +1,61 @@
+import { type ReactNode } from "react";
+import { type IconData } from "../icon/icon.js";
+export declare const KAESO_TABS_VARIANTS: {
+    readonly variant: {
+        readonly underline: {
+            readonly classes: "";
+            readonly description: "Underline tabs for detail pages: 40px, a 2px ink indicator that slides";
+        };
+        readonly pill: {
+            readonly classes: "";
+            readonly description: "Header tabs: separate 32px pills, the active one filled";
+        };
+    };
+};
+export declare const KAESO_TABS_DEFAULT_VARIANTS: {
+    readonly variant: "underline";
+};
+type Variant = keyof typeof KAESO_TABS_VARIANTS.variant;
+export interface TabsProps {
+    value?: string | undefined;
+    defaultValue?: string | undefined;
+    onValueChange?: ((value: string) => void) | undefined;
+    variant?: Variant | undefined;
+    className?: string | undefined;
+    children: ReactNode;
+}
+export interface TabsListProps {
+    className?: string | undefined;
+    children: ReactNode;
+    "aria-label"?: string | undefined;
+}
+export interface TabProps {
+    value: string;
+    children: ReactNode;
+    icon?: IconData | undefined;
+    count?: number | undefined;
+    disabled?: boolean | undefined;
+    className?: string | undefined;
+    "data-force"?: string | undefined;
+}
+export declare const Tabs: import("react").ForwardRefExoticComponent<TabsProps & import("react").RefAttributes<HTMLDivElement>> & {
+    List: import("react").ForwardRefExoticComponent<TabsListProps & import("react").RefAttributes<HTMLDivElement>>;
+    Tab: import("react").ForwardRefExoticComponent<TabProps & import("react").RefAttributes<HTMLButtonElement>>;
+    Panel: import("react").ForwardRefExoticComponent<{
+        value: string;
+        className?: string | undefined;
+        children: ReactNode;
+        keepMounted?: boolean | undefined;
+    } & import("react").RefAttributes<HTMLDivElement>>;
+};
+export declare const PillTabs: import("react").ForwardRefExoticComponent<TabsProps & import("react").RefAttributes<HTMLDivElement>> & {
+    List: import("react").ForwardRefExoticComponent<TabsListProps & import("react").RefAttributes<HTMLDivElement>>;
+    Tab: import("react").ForwardRefExoticComponent<TabProps & import("react").RefAttributes<HTMLButtonElement>>;
+    Panel: import("react").ForwardRefExoticComponent<{
+        value: string;
+        className?: string | undefined;
+        children: ReactNode;
+        keepMounted?: boolean | undefined;
+    } & import("react").RefAttributes<HTMLDivElement>>;
+};
+export {};

package/dist/types/components/tag/docs.d.ts

@@ -0,0 +1,30 @@
+export declare const docs: {
+    Pill: {
+        description: string;
+        props: {
+            children: string;
+            icon: string;
+            invalid: string;
+            onClick: string;
+            onRemove: string;
+            pressed: string;
+            removeLabel: string;
+            size: string;
+            variant: string;
+        };
+    };
+    Tag: {
+        description: string;
+        props: {
+            children: string;
+            icon: string;
+            invalid: string;
+            onClick: string;
+            onRemove: string;
+            pressed: string;
+            removeLabel: string;
+            size: string;
+            variant: string;
+        };
+    };
+};

package/dist/types/components/tag/index.d.ts

@@ -0,0 +1 @@
+export * from "./tag.js";

package/dist/types/components/tag/tag.d.ts

@@ -0,0 +1,63 @@
+import type * as React from "react";
+import { type HTMLAttributes, type MouseEvent, type ReactNode } from "react";
+import { type IconData } from "../icon/icon.js";
+export declare const TAG_DOT: {
+    readonly "viz-1": "bg-viz-1";
+    readonly "viz-2": "bg-viz-2";
+    readonly "viz-3": "bg-viz-3";
+    readonly "viz-4": "bg-viz-4";
+    readonly "viz-5": "bg-viz-5";
+    readonly "viz-6": "bg-viz-6";
+    readonly "viz-7": "bg-viz-7";
+    readonly "viz-8": "bg-viz-8";
+    readonly success: "bg-success";
+    readonly warning: "bg-warning";
+    readonly danger: "bg-danger";
+    readonly info: "bg-info";
+    readonly neutral: "bg-fg-tertiary";
+};
+export type TagDot = keyof typeof TAG_DOT;
+export declare const KAESO_TAG_VARIANTS: {
+    readonly size: {
+        readonly md: {
+            readonly classes: "h-28 px-10 gap-6 text-small";
+            readonly description: "28px: metadata pills in lists and toolbars (default)";
+        };
+        readonly sm: {
+            readonly classes: "h-24 px-8 gap-4 text-caption";
+            readonly description: "24px: inside table rows";
+        };
+    };
+    readonly variant: {
+        readonly raised: {
+            readonly classes: "bg-raised shadow-control text-fg";
+            readonly description: "Raised with a ring: metadata pills (default)";
+        };
+        readonly outline: {
+            readonly classes: "bg-transparent shadow-ring text-fg-secondary";
+            readonly description: "Ring only: unselected toggle pills";
+        };
+        readonly soft: {
+            readonly classes: "bg-fill-2 text-fg";
+            readonly description: "Filled: selected toggle pills";
+        };
+    };
+};
+export declare const KAESO_TAG_DEFAULT_VARIANTS: {
+    readonly size: "md";
+    readonly variant: "raised";
+};
+export interface TagProps extends Omit<HTMLAttributes<HTMLElement>, "children"> {
+    children: ReactNode;
+    size?: keyof typeof KAESO_TAG_VARIANTS.size | undefined;
+    variant?: keyof typeof KAESO_TAG_VARIANTS.variant | undefined;
+    icon?: IconData | undefined;
+    onRemove?: ((e: MouseEvent<HTMLButtonElement>) => void) | undefined;
+    removeLabel?: string | undefined;
+    onClick?: ((e: MouseEvent<HTMLElement>) => void) | undefined;
+    pressed?: boolean | undefined;
+    invalid?: boolean | undefined;
+    "data-force"?: string | undefined;
+}
+export declare const Tag: React.ForwardRefExoticComponent<TagProps & React.RefAttributes<HTMLElement>>;
+export declare const Pill: React.ForwardRefExoticComponent<TagProps & React.RefAttributes<HTMLElement>>;

package/dist/types/components/text/docs.d.ts

@@ -0,0 +1,15 @@
+export declare const docs: {
+    Text: {
+        description: string;
+        props: {
+            as: string;
+            children: string;
+            mono: string;
+            tabular: string;
+            tone: string;
+            truncate: string;
+            variant: string;
+            weight: string;
+        };
+    };
+};

package/dist/types/components/text/index.d.ts

@@ -0,0 +1 @@
+export * from "./text.js";

package/dist/types/components/text/text.d.ts

@@ -0,0 +1,111 @@
+import { type ElementType, type HTMLAttributes, type ReactNode } from "react";
+export declare const KAESO_TEXT_VARIANTS: {
+    readonly variant: {
+        readonly micro: {
+            readonly classes: "text-micro font-medium";
+            readonly description: "11/14 500: keyboard keys and chart ticks only";
+        };
+        readonly caption: {
+            readonly classes: "text-caption font-medium";
+            readonly description: "12/16 500: group labels, badges, table headers";
+        };
+        readonly small: {
+            readonly classes: "text-small";
+            readonly description: "13/18: descriptions, secondary cells, hints";
+        };
+        readonly body: {
+            readonly classes: "text-body";
+            readonly description: "14/20: the default";
+        };
+        readonly "body-lg": {
+            readonly classes: "text-body-lg font-medium";
+            readonly description: "15/22 500: settings row titles, dialog body";
+        };
+        readonly "title-sm": {
+            readonly classes: "text-title-sm font-semibold";
+            readonly description: "17/24 600: section and dialog titles";
+        };
+        readonly title: {
+            readonly classes: "text-title font-semibold";
+            readonly description: "20/28 600: empty-state and compact page titles";
+        };
+        readonly "title-lg": {
+            readonly classes: "text-title-lg font-semibold";
+            readonly description: "28/34 600: settings page titles, auth screens";
+        };
+        readonly display: {
+            readonly classes: "text-display font-semibold";
+            readonly description: "40/44 600: showcase headings, the setup screen";
+        };
+        readonly metric: {
+            readonly classes: "text-metric font-semibold tabular";
+            readonly description: "28/32 600 tabular: big numbers";
+        };
+    };
+    readonly tone: {
+        readonly default: {
+            readonly classes: "text-fg";
+            readonly description: "Primary text";
+        };
+        readonly secondary: {
+            readonly classes: "text-fg-secondary";
+            readonly description: "Descriptions and metadata";
+        };
+        readonly tertiary: {
+            readonly classes: "text-fg-tertiary";
+            readonly description: "Placeholders and redundant hints; never the only carrier of meaning";
+        };
+        readonly danger: {
+            readonly classes: "text-danger-text";
+            readonly description: "Errors, next to an icon or a word";
+        };
+        readonly success: {
+            readonly classes: "text-success-text";
+            readonly description: "Confirmation, next to an icon or a word";
+        };
+        readonly warning: {
+            readonly classes: "text-warning-text";
+            readonly description: "Warnings, next to an icon or a word";
+        };
+        readonly info: {
+            readonly classes: "text-info-text";
+            readonly description: "Information in progress (syncing, queued), next to an icon or a word";
+        };
+        readonly inherit: {
+            readonly classes: "text-inherit";
+            readonly description: "Inherit from the parent";
+        };
+    };
+    readonly weight: {
+        readonly regular: {
+            readonly classes: "font-regular";
+            readonly description: "400";
+        };
+        readonly medium: {
+            readonly classes: "font-medium";
+            readonly description: "500 (480 in dark mode)";
+        };
+        readonly semibold: {
+            readonly classes: "font-semibold";
+            readonly description: "600 (580 in dark mode)";
+        };
+    };
+};
+export declare const KAESO_TEXT_DEFAULT_VARIANTS: {
+    readonly variant: "body";
+    readonly tone: "default";
+};
+export type TextVariant = keyof typeof KAESO_TEXT_VARIANTS.variant;
+export type TextTone = keyof typeof KAESO_TEXT_VARIANTS.tone;
+export type TextWeight = keyof typeof KAESO_TEXT_VARIANTS.weight;
+export interface TextProps extends HTMLAttributes<HTMLElement> {
+    variant?: TextVariant | undefined;
+    tone?: TextTone | undefined;
+    weight?: TextWeight | undefined;
+    mono?: boolean | undefined;
+    tabular?: boolean | undefined;
+    truncate?: boolean | undefined;
+    as?: ElementType | undefined;
+    children?: ReactNode | undefined;
+}
+export declare const Text: import("react").ForwardRefExoticComponent<TextProps & import("react").RefAttributes<HTMLElement>>;

package/dist/types/components/theme-menu/docs.d.ts

@@ -0,0 +1,9 @@
+export declare const docs: {
+    ThemeMenu: {
+        description: string;
+        props: {
+            size: string;
+            variant: string;
+        };
+    };
+};

package/dist/types/components/theme-menu/index.d.ts

@@ -0,0 +1 @@
+export * from "./theme-menu.js";

package/dist/types/components/theme-menu/theme-menu.d.ts

@@ -0,0 +1,22 @@
+export declare const KAESO_THEME_MENU_VARIANTS: {
+    readonly variant: {
+        readonly ghost: {
+            readonly classes: "";
+            readonly description: "A ghost circle (default)";
+        };
+        readonly secondary: {
+            readonly classes: "";
+            readonly description: "A raised circle";
+        };
+    };
+};
+export declare const KAESO_THEME_MENU_DEFAULT_VARIANTS: {
+    readonly variant: "ghost";
+};
+export declare function ThemeMenu({ variant, size }: {
+    variant?: "ghost" | "secondary" | undefined;
+    size?: "sm" | "md" | undefined;
+}): import("react/jsx-runtime").JSX.Element;
+export declare namespace ThemeMenu {
+    var displayName: string;
+}

package/dist/types/components/timeline/docs.d.ts

@@ -0,0 +1,8 @@
+export declare const docs: {
+    Timeline: {
+        description: string;
+        props: {
+            events: string;
+        };
+    };
+};

package/dist/types/components/timeline/index.d.ts

@@ -0,0 +1 @@
+export * from "./timeline.js";

package/dist/types/components/timeline/timeline.d.ts

@@ -0,0 +1,41 @@
+import { type ReactNode } from "react";
+export declare const KAESO_TIMELINE_VARIANTS: {
+    readonly tone: {
+        readonly neutral: {
+            readonly classes: "bg-line-strong";
+            readonly description: "Ordinary events (default)";
+        };
+        readonly success: {
+            readonly classes: "bg-success";
+            readonly description: "Something completed";
+        };
+        readonly warning: {
+            readonly classes: "bg-warning";
+            readonly description: "Something changed that needs attention";
+        };
+        readonly danger: {
+            readonly classes: "bg-danger";
+            readonly description: "Something failed or was removed";
+        };
+        readonly info: {
+            readonly classes: "bg-info";
+            readonly description: "Informational";
+        };
+    };
+};
+export declare const KAESO_TIMELINE_DEFAULT_VARIANTS: {
+    readonly tone: "neutral";
+};
+export interface TimelineEvent {
+    id: string;
+    title: ReactNode;
+    description?: ReactNode | undefined;
+    time: ReactNode;
+    datetime?: string | undefined;
+    tone?: keyof typeof KAESO_TIMELINE_VARIANTS.tone | undefined;
+    marker?: ReactNode | undefined;
+}
+export declare const Timeline: import("react").ForwardRefExoticComponent<{
+    events: TimelineEvent[];
+    className?: string | undefined;
+} & import("react").RefAttributes<HTMLOListElement>>;

package/dist/types/components/toast/docs.d.ts

@@ -0,0 +1,26 @@
+export declare const docs: {
+    Toast: {
+        description: string;
+        props: {
+            limit: string;
+            timeout: string;
+        };
+    };
+    ToastCapsule: {
+        description: string;
+        props: {
+            action: string;
+            closable: string;
+            description: string;
+            title: string;
+            tone: string;
+        };
+    };
+    Toaster: {
+        description: string;
+        props: {
+            limit: string;
+            timeout: string;
+        };
+    };
+};

package/dist/types/components/toast/index.d.ts

@@ -0,0 +1 @@
+export * from "./toast.js";

package/dist/types/components/toast/toast.d.ts

@@ -0,0 +1,91 @@
+import { type ReactNode } from "react";
+export declare const KAESO_TOAST_VARIANTS: {
+    readonly tone: {
+        readonly neutral: {
+            readonly classes: "";
+            readonly description: "A plain message (default)";
+        };
+        readonly success: {
+            readonly classes: "text-success";
+            readonly description: "Success: a green check before the words";
+        };
+        readonly error: {
+            readonly classes: "text-danger";
+            readonly description: "Errors: a red mark; announced as an alert";
+        };
+        readonly warning: {
+            readonly classes: "text-warning";
+            readonly description: "Warnings";
+        };
+        readonly info: {
+            readonly classes: "text-info";
+            readonly description: "Information";
+        };
+        readonly loading: {
+            readonly classes: "text-toast-fg-secondary";
+            readonly description: "Work underway: a spinner";
+        };
+    };
+};
+export declare const KAESO_TOAST_DEFAULT_VARIANTS: {
+    readonly tone: "neutral";
+};
+type Tone = keyof typeof KAESO_TOAST_VARIANTS.tone;
+export declare const toastManager: import("@base-ui/react/toast").ToastManager<any>;
+export interface ToastOptions {
+    description?: ReactNode | undefined;
+    action?: {
+        label: string;
+        onClick: () => void;
+    } | undefined;
+    timeout?: number | undefined;
+    id?: string | undefined;
+}
+export declare const toast: ((title: ReactNode, o?: ToastOptions) => string) & {
+    success: (title: ReactNode, o?: ToastOptions) => string;
+    error: (title: ReactNode, o?: ToastOptions) => string;
+    warning: (title: ReactNode, o?: ToastOptions) => string;
+    info: (title: ReactNode, o?: ToastOptions) => string;
+    dismiss: (id?: string) => void;
+    promise: <T>(p: Promise<T>, m: {
+        loading: string;
+        success: string | ((v: T) => string);
+        error: string | ((e: unknown) => string);
+    }) => Promise<T>;
+};
+export declare function ToastCapsule({ tone, title, description, action, closable, "data-force": force, }: {
+    tone?: Tone | undefined;
+    title: ReactNode;
+    description?: ReactNode | undefined;
+    action?: string | undefined;
+    closable?: boolean | undefined;
+    "data-force"?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element;
+export declare namespace ToastCapsule {
+    var displayName: string;
+}
+export declare function Toaster({ limit, timeout }: {
+    limit?: number | undefined;
+    timeout?: number | undefined;
+}): import("react/jsx-runtime").JSX.Element;
+export declare namespace Toaster {
+    var displayName: string;
+}
+export declare const Toast: ((props: {
+    limit?: number | undefined;
+    timeout?: number | undefined;
+}) => import("react/jsx-runtime").JSX.Element) & {
+    add: ((title: ReactNode, o?: ToastOptions) => string) & {
+        success: (title: ReactNode, o?: ToastOptions) => string;
+        error: (title: ReactNode, o?: ToastOptions) => string;
+        warning: (title: ReactNode, o?: ToastOptions) => string;
+        info: (title: ReactNode, o?: ToastOptions) => string;
+        dismiss: (id?: string) => void;
+        promise: <T>(p: Promise<T>, m: {
+            loading: string;
+            success: string | ((v: T) => string);
+            error: string | ((e: unknown) => string);
+        }) => Promise<T>;
+    };
+};
+export {};

package/dist/types/components/toc/docs.d.ts

@@ -0,0 +1,10 @@
+export declare const docs: {
+    TableOfContents: {
+        description: string;
+        props: {
+            active: string;
+            items: string;
+            title: string;
+        };
+    };
+};

package/dist/types/components/toc/index.d.ts

@@ -0,0 +1 @@
+export * from "./toc.js";

package/dist/types/components/toc/toc.d.ts

@@ -0,0 +1,27 @@
+export declare const KAESO_TABLE_OF_CONTENTS_VARIANTS: {
+    readonly state: {
+        readonly default: {
+            readonly classes: "text-fg-secondary hover:text-fg";
+            readonly description: "A heading";
+        };
+        readonly active: {
+            readonly classes: "text-fg";
+            readonly description: "The heading in view, with a 2px ink bar";
+        };
+    };
+};
+export declare const KAESO_TABLE_OF_CONTENTS_DEFAULT_VARIANTS: {
+    readonly state: "default";
+};
+export interface TocItem {
+    id: string;
+    label: string;
+    depth?: 0 | 1 | undefined;
+}
+export interface TableOfContentsProps {
+    items: TocItem[];
+    title?: string | undefined;
+    active?: string | undefined;
+    className?: string | undefined;
+}
+export declare const TableOfContents: import("react").ForwardRefExoticComponent<TableOfContentsProps & import("react").RefAttributes<HTMLElement>>;

package/dist/types/components/toolbar/docs.d.ts

@@ -0,0 +1,9 @@
+export declare const docs: {
+    Toolbar: {
+        description: string;
+        props: {
+            "aria-label": string;
+            size: string;
+        };
+    };
+};

package/dist/types/components/toolbar/index.d.ts

@@ -0,0 +1 @@
+export * from "./toolbar.js";

package/dist/types/components/toolbar/toolbar.d.ts

@@ -0,0 +1,28 @@
+import { type HTMLAttributes } from "react";
+export declare const KAESO_TOOLBAR_VARIANTS: {
+    readonly size: {
+        readonly md: {
+            readonly classes: "min-h-48 gap-8 px-24 py-6";
+            readonly description: "48px, 24px side padding, under the page header (default)";
+        };
+        readonly inset: {
+            readonly classes: "min-h-48 gap-8 px-0 py-6";
+            readonly description: "48px without side padding, inside padded content";
+        };
+    };
+};
+export declare const KAESO_TOOLBAR_DEFAULT_VARIANTS: {
+    readonly size: "md";
+};
+export interface ToolbarProps extends HTMLAttributes<HTMLDivElement> {
+    size?: keyof typeof KAESO_TOOLBAR_VARIANTS.size | undefined;
+    "aria-label": string;
+}
+declare function Spacer(): import("react/jsx-runtime").JSX.Element;
+declare namespace Spacer {
+    var displayName: string;
+}
+export declare const Toolbar: import("react").ForwardRefExoticComponent<ToolbarProps & import("react").RefAttributes<HTMLDivElement>> & {
+    Spacer: typeof Spacer;
+};
+export {};

package/dist/types/components/tooltip/docs.d.ts

@@ -0,0 +1,33 @@
+export declare const docs: {
+    Tooltip: {
+        description: string;
+        props: {
+            children: string;
+            content: string;
+            defaultOpen: string;
+            delay: string;
+            disabled: string;
+            onOpenChange: string;
+            open: string;
+            shape: string;
+            shortcut: string;
+            side: string;
+            sideOffset: string;
+        };
+    };
+    TooltipProvider: {
+        description: string;
+        props: {
+            children: string;
+            delay: string;
+        };
+    };
+    TooltipSurface: {
+        description: string;
+        props: {
+            children: string;
+            shape: string;
+            shortcut: string;
+        };
+    };
+};

package/dist/types/components/tooltip/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./tooltip.js";
+export * from "./tooltip-provider.js";

package/dist/types/components/tooltip/tooltip-provider.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+export declare function TooltipProvider({ children, delay }: {
+    children: ReactNode;
+    delay?: number | undefined;
+}): import("react/jsx-runtime").JSX.Element;
+export declare namespace TooltipProvider {
+    var displayName: string;
+}