@pollinations/ui 0.0.2 → 0.1.0-alpha.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { FC, ComponentPropsWithoutRef, ReactNode, ButtonHTMLAttributes, PropsWithChildren, CSSProperties } from 'react';
-export { B as Button, a as ButtonProps } from './Button-CWUBCiIc.cjs';
+export { B as Button, a as ButtonProps } from './Button-BvLF_Km2.cjs';
 export { C as Chip } from './Chip-SM52sUbZ.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Dialog as Dialog$1 } from '@ark-ui/react/dialog';
@@ -11,6 +11,12 @@ export { Field } from '@ark-ui/react/field';
 /** Class merge for apps consuming the unprefixed Tailwind bridge in app.css. */
 declare function cn(...inputs: (string | undefined | null | false)[]): string;
 
+type RejectReason = "type" | "size" | "count";
+type RejectedFile = {
+    file: File;
+    reason: RejectReason;
+};
+
 type PeriodGranularity = "day" | "week" | "month";
 type PeriodSelection = {
     granularity: PeriodGranularity;
@@ -128,22 +134,43 @@ type DropdownProps = {
     /** Controlled open state. Omit to let the Dropdown manage its own. */
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
-    /** Replaces the default themed surface (e.g. a differently-coloured menu). */
-    panelClassName?: string;
     /** Appended after the surface (widths, padding, max-height…). */
     className?: string;
 };
 declare const Dropdown: FC<DropdownProps>;
 
+type BaseDropdownItemProps = {
+    className?: string;
+};
+type DropdownItemProps<T extends React.ElementType = "button"> = PropsWithChildren<BaseDropdownItemProps> & {
+    as?: T;
+} & Omit<React.ComponentPropsWithoutRef<T>, keyof BaseDropdownItemProps | "as">;
+declare function DropdownItem<T extends React.ElementType = "button">({ as, className, children, ...rest }: DropdownItemProps<T>): react_jsx_runtime.JSX.Element;
+
 type ExternalLinkButtonProps = {
     theme: ThemeName;
     href: string;
-    size?: "small" | "medium" | "large";
+    size?: "sm" | "md" | "lg";
     className?: string;
     children: ReactNode;
 };
 declare const ExternalLinkButton: FC<ExternalLinkButtonProps>;
 
+type FileUploadProps = {
+    value: File[];
+    onChange: (files: File[]) => void;
+    onReject?: (rejected: RejectedFile[]) => void;
+    maxFiles?: number;
+    maxSizeBytes?: number;
+    accept?: string;
+    /** Fully locks the field: no add, no remove, drops ignored. */
+    disabled?: boolean;
+    /** Optional cascade override; defaults to the inherited `[data-theme]`. */
+    theme?: ThemeName;
+    className?: string;
+};
+declare function FileUpload({ value, onChange, onReject, maxFiles, maxSizeBytes, accept, disabled, theme, className, }: FileUploadProps): react_jsx_runtime.JSX.Element;
+
 /** IconButton only supports `danger` (delete icons). */
 type IconButtonIntent = "danger";
 type IconButtonProps = {
@@ -170,6 +197,19 @@ type InfoTipProps = {
  */
 declare const InfoTip: FC<InfoTipProps>;
 
+type BaseInlineLinkProps = {
+    /** Override the cascade theme for this link's subtree. */
+    theme?: ThemeName;
+    /** Set explicitly for non-http external links, or false for custom routing components. */
+    external?: boolean;
+    showIcon?: boolean;
+    className?: string;
+};
+type InlineLinkProps<T extends React.ElementType = "a"> = PropsWithChildren<BaseInlineLinkProps> & {
+    as?: T;
+} & Omit<React.ComponentPropsWithoutRef<T>, keyof BaseInlineLinkProps | "as">;
+declare function InlineLink<T extends React.ElementType = "a">({ as, theme, external, showIcon, className, children, ...linkProps }: InlineLinkProps<T>): react_jsx_runtime.JSX.Element;
+
 type InputProps = React.ComponentPropsWithoutRef<"input"> & {
     error?: boolean;
     hideNumberSteppers?: boolean;
@@ -204,6 +244,26 @@ declare function TrendUpIcon(props: IconProps): react_jsx_runtime.JSX.Element;
 declare function WalletIcon(props: IconProps): react_jsx_runtime.JSX.Element;
 declare function XIcon(props: IconProps): react_jsx_runtime.JSX.Element;
 
+type BaseLinkCardProps = {
+    /** Override the cascade theme for this card's subtree. */
+    theme?: ThemeName;
+    external?: boolean;
+    showIcon?: boolean;
+    className?: string;
+    surfaceClassName?: string;
+};
+type LinkCardProps<T extends React.ElementType = "a"> = PropsWithChildren<BaseLinkCardProps> & {
+    as?: T;
+} & Omit<React.ComponentPropsWithoutRef<T>, keyof BaseLinkCardProps | "as">;
+declare function LinkCard<T extends React.ElementType = "a">({ as, theme, external, showIcon, className, surfaceClassName, children, ...linkProps }: LinkCardProps<T>): react_jsx_runtime.JSX.Element;
+
+type MarkdownProps = {
+    children: string;
+    className?: string;
+};
+/** Compact markdown for cards and snippets. Use Prose for document-style content. */
+declare function Markdown({ children, className }: MarkdownProps): react_jsx_runtime.JSX.Element;
+
 type MultiSelectOption = {
     value: string;
     label: string;
@@ -221,6 +281,24 @@ type MultiSelectProps = {
 };
 declare const MultiSelect: FC<MultiSelectProps>;
 
+type BaseNavItemProps = {
+    /** Section color via the `[data-theme]` cascade — tints the dot + active fill. */
+    theme?: ThemeName;
+    /** Current/selected item — fills with the section color + sets `aria-current`. */
+    active?: boolean;
+    className?: string;
+};
+type NavItemProps<T extends React.ElementType = "button"> = PropsWithChildren<BaseNavItemProps> & {
+    as?: T;
+} & Omit<React.ComponentPropsWithoutRef<T>, keyof BaseNavItemProps | "as">;
+/**
+ * Minimal nav item — a themed pill with a persistent section-color dot, neutral
+ * when inactive and filled with the section color when active. Polymorphic:
+ * `<NavItem>` (button) for in-page nav, `<NavItem as={Link} active={…}>` for
+ * routed nav. Mirrors enter's sidebar item so both apps share one design.
+ */
+declare function NavItem<T extends React.ElementType = "button">({ as, theme, active, className, children, ...rest }: NavItemProps<T>): react_jsx_runtime.JSX.Element;
+
 type PeriodPickerProps = {
     value: PeriodSelection;
     onChange: (value: PeriodSelection) => void;
@@ -230,6 +308,12 @@ type PeriodPickerProps = {
 };
 declare const PeriodPicker: FC<PeriodPickerProps>;
 
+type ProseProps = {
+    children: string;
+    className?: string;
+};
+declare function Prose({ children, className }: ProseProps): react_jsx_runtime.JSX.Element;
+
 type ScrollAxis = "y" | "x";
 type ScrollAreaOwnProps = {
     /** Override the ambient cascade theme for this scroller's thumb. */
@@ -252,8 +336,11 @@ type SectionProps = {
     theme: ThemeName;
     id?: string;
     framed?: boolean;
+    intro?: ReactNode;
     action?: ReactNode;
     actionClassName?: string;
+    panelClassName?: string;
+    titleClassName?: string;
     children: ReactNode;
     className?: string;
 };
@@ -323,7 +410,8 @@ type TabButtonProps = {
     children: ReactNode;
     /** Optional cascade override; defaults to inherited [data-theme]. */
     theme?: ThemeName;
-    size?: "medium" | "small";
+    size?: "md" | "sm";
+    variant?: "default" | "ghost";
     ariaLabel?: string;
     disabled?: boolean;
     className?: string;
@@ -358,6 +446,13 @@ type TableCellProps = ComponentPropsWithoutRef<"td"> & {
 };
 declare const TableCell: FC<TableCellProps>;
 
+type TextareaProps = React.ComponentPropsWithoutRef<"textarea"> & {
+    error?: boolean;
+};
+declare const Textarea: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement>, "ref"> & {
+    error?: boolean;
+} & react.RefAttributes<HTMLTextAreaElement>>;
+
 type TooltipProps = {
     children: ReactNode;
     content: ReactNode;
@@ -375,4 +470,4 @@ type TooltipProps = {
 };
 declare const Tooltip: FC<TooltipProps>;
 
-export { Alert, type AlertProps, AppIcon, BeakerIcon, BookIcon, ButtonGroup, type ButtonGroupProps, CheckIcon, ChevronIcon, ClipboardIcon, ClockIcon, Collapsible, type CollapsibleProps, CopyButton, type CopyButtonProps, Dialog, type DialogProps, DialogTitle, DiscordIcon, DownloadIcon, Dropdown, type DropdownProps, ExternalLinkButton, type ExternalLinkButtonProps, ExternalLinkIcon, GenApiIcon, GitHubIcon, IconButton, type IconProps, ImageIcon, InfoTip, Input, type InputProps, LockIcon, MailIcon, McpIcon, MenuIcon, MultiSelect, type MultiSelectProps, type PeriodGranularity, PeriodPicker, type PeriodPickerProps, type PeriodSelection, ScrollArea, type ScrollAreaProps, Section, type SectionProps, Slider, type SliderProps, StatCard, type StatCardProps, Surface, Switch, type SwitchProps, type SwitchStatus, TabButton, type TabButtonProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHead, type TableHeadProps, TableHeaderCell, type TableHeaderCellProps, type TableProps, TableRow, type TableRowProps, TerminalIcon, ThemeName, TokensIcon, Tooltip, TrendUpIcon, WalletIcon, XIcon, cn, currentPeriod, getPeriodBucketKeys, periodBucketKeyToDate, useScrollLock };
+export { Alert, type AlertProps, AppIcon, BeakerIcon, BookIcon, ButtonGroup, type ButtonGroupProps, CheckIcon, ChevronIcon, ClipboardIcon, ClockIcon, Collapsible, type CollapsibleProps, CopyButton, type CopyButtonProps, Dialog, type DialogProps, DialogTitle, DiscordIcon, DownloadIcon, Dropdown, DropdownItem, type DropdownItemProps, type DropdownProps, ExternalLinkButton, type ExternalLinkButtonProps, ExternalLinkIcon, FileUpload, type FileUploadProps, GenApiIcon, GitHubIcon, IconButton, type IconProps, ImageIcon, InfoTip, InlineLink, type InlineLinkProps, Input, type InputProps, LinkCard, type LinkCardProps, LockIcon, MailIcon, Markdown, type MarkdownProps, McpIcon, MenuIcon, MultiSelect, type MultiSelectProps, NavItem, type NavItemProps, type PeriodGranularity, PeriodPicker, type PeriodPickerProps, type PeriodSelection, Prose, type ProseProps, type RejectReason, type RejectedFile, ScrollArea, type ScrollAreaProps, Section, type SectionProps, Slider, type SliderProps, StatCard, type StatCardProps, Surface, Switch, type SwitchProps, type SwitchStatus, TabButton, type TabButtonProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHead, type TableHeadProps, TableHeaderCell, type TableHeaderCellProps, type TableProps, TableRow, type TableRowProps, TerminalIcon, Textarea, type TextareaProps, ThemeName, TokensIcon, Tooltip, TrendUpIcon, WalletIcon, XIcon, cn, currentPeriod, getPeriodBucketKeys, periodBucketKeyToDate, useScrollLock };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { FC, ComponentPropsWithoutRef, ReactNode, ButtonHTMLAttributes, PropsWithChildren, CSSProperties } from 'react';
-export { B as Button, a as ButtonProps } from './Button-Bn8pGg6N.js';
+export { B as Button, a as ButtonProps } from './Button-DQAZzvyQ.js';
 export { C as Chip } from './Chip-C5impfYd.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Dialog as Dialog$1 } from '@ark-ui/react/dialog';
@@ -11,6 +11,12 @@ export { Field } from '@ark-ui/react/field';
 /** Class merge for apps consuming the unprefixed Tailwind bridge in app.css. */
 declare function cn(...inputs: (string | undefined | null | false)[]): string;
 
+type RejectReason = "type" | "size" | "count";
+type RejectedFile = {
+    file: File;
+    reason: RejectReason;
+};
+
 type PeriodGranularity = "day" | "week" | "month";
 type PeriodSelection = {
     granularity: PeriodGranularity;
@@ -128,22 +134,43 @@ type DropdownProps = {
     /** Controlled open state. Omit to let the Dropdown manage its own. */
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
-    /** Replaces the default themed surface (e.g. a differently-coloured menu). */
-    panelClassName?: string;
     /** Appended after the surface (widths, padding, max-height…). */
     className?: string;
 };
 declare const Dropdown: FC<DropdownProps>;
 
+type BaseDropdownItemProps = {
+    className?: string;
+};
+type DropdownItemProps<T extends React.ElementType = "button"> = PropsWithChildren<BaseDropdownItemProps> & {
+    as?: T;
+} & Omit<React.ComponentPropsWithoutRef<T>, keyof BaseDropdownItemProps | "as">;
+declare function DropdownItem<T extends React.ElementType = "button">({ as, className, children, ...rest }: DropdownItemProps<T>): react_jsx_runtime.JSX.Element;
+
 type ExternalLinkButtonProps = {
     theme: ThemeName;
     href: string;
-    size?: "small" | "medium" | "large";
+    size?: "sm" | "md" | "lg";
     className?: string;
     children: ReactNode;
 };
 declare const ExternalLinkButton: FC<ExternalLinkButtonProps>;
 
+type FileUploadProps = {
+    value: File[];
+    onChange: (files: File[]) => void;
+    onReject?: (rejected: RejectedFile[]) => void;
+    maxFiles?: number;
+    maxSizeBytes?: number;
+    accept?: string;
+    /** Fully locks the field: no add, no remove, drops ignored. */
+    disabled?: boolean;
+    /** Optional cascade override; defaults to the inherited `[data-theme]`. */
+    theme?: ThemeName;
+    className?: string;
+};
+declare function FileUpload({ value, onChange, onReject, maxFiles, maxSizeBytes, accept, disabled, theme, className, }: FileUploadProps): react_jsx_runtime.JSX.Element;
+
 /** IconButton only supports `danger` (delete icons). */
 type IconButtonIntent = "danger";
 type IconButtonProps = {
@@ -170,6 +197,19 @@ type InfoTipProps = {
  */
 declare const InfoTip: FC<InfoTipProps>;
 
+type BaseInlineLinkProps = {
+    /** Override the cascade theme for this link's subtree. */
+    theme?: ThemeName;
+    /** Set explicitly for non-http external links, or false for custom routing components. */
+    external?: boolean;
+    showIcon?: boolean;
+    className?: string;
+};
+type InlineLinkProps<T extends React.ElementType = "a"> = PropsWithChildren<BaseInlineLinkProps> & {
+    as?: T;
+} & Omit<React.ComponentPropsWithoutRef<T>, keyof BaseInlineLinkProps | "as">;
+declare function InlineLink<T extends React.ElementType = "a">({ as, theme, external, showIcon, className, children, ...linkProps }: InlineLinkProps<T>): react_jsx_runtime.JSX.Element;
+
 type InputProps = React.ComponentPropsWithoutRef<"input"> & {
     error?: boolean;
     hideNumberSteppers?: boolean;
@@ -204,6 +244,26 @@ declare function TrendUpIcon(props: IconProps): react_jsx_runtime.JSX.Element;
 declare function WalletIcon(props: IconProps): react_jsx_runtime.JSX.Element;
 declare function XIcon(props: IconProps): react_jsx_runtime.JSX.Element;
 
+type BaseLinkCardProps = {
+    /** Override the cascade theme for this card's subtree. */
+    theme?: ThemeName;
+    external?: boolean;
+    showIcon?: boolean;
+    className?: string;
+    surfaceClassName?: string;
+};
+type LinkCardProps<T extends React.ElementType = "a"> = PropsWithChildren<BaseLinkCardProps> & {
+    as?: T;
+} & Omit<React.ComponentPropsWithoutRef<T>, keyof BaseLinkCardProps | "as">;
+declare function LinkCard<T extends React.ElementType = "a">({ as, theme, external, showIcon, className, surfaceClassName, children, ...linkProps }: LinkCardProps<T>): react_jsx_runtime.JSX.Element;
+
+type MarkdownProps = {
+    children: string;
+    className?: string;
+};
+/** Compact markdown for cards and snippets. Use Prose for document-style content. */
+declare function Markdown({ children, className }: MarkdownProps): react_jsx_runtime.JSX.Element;
+
 type MultiSelectOption = {
     value: string;
     label: string;
@@ -221,6 +281,24 @@ type MultiSelectProps = {
 };
 declare const MultiSelect: FC<MultiSelectProps>;
 
+type BaseNavItemProps = {
+    /** Section color via the `[data-theme]` cascade — tints the dot + active fill. */
+    theme?: ThemeName;
+    /** Current/selected item — fills with the section color + sets `aria-current`. */
+    active?: boolean;
+    className?: string;
+};
+type NavItemProps<T extends React.ElementType = "button"> = PropsWithChildren<BaseNavItemProps> & {
+    as?: T;
+} & Omit<React.ComponentPropsWithoutRef<T>, keyof BaseNavItemProps | "as">;
+/**
+ * Minimal nav item — a themed pill with a persistent section-color dot, neutral
+ * when inactive and filled with the section color when active. Polymorphic:
+ * `<NavItem>` (button) for in-page nav, `<NavItem as={Link} active={…}>` for
+ * routed nav. Mirrors enter's sidebar item so both apps share one design.
+ */
+declare function NavItem<T extends React.ElementType = "button">({ as, theme, active, className, children, ...rest }: NavItemProps<T>): react_jsx_runtime.JSX.Element;
+
 type PeriodPickerProps = {
     value: PeriodSelection;
     onChange: (value: PeriodSelection) => void;
@@ -230,6 +308,12 @@ type PeriodPickerProps = {
 };
 declare const PeriodPicker: FC<PeriodPickerProps>;
 
+type ProseProps = {
+    children: string;
+    className?: string;
+};
+declare function Prose({ children, className }: ProseProps): react_jsx_runtime.JSX.Element;
+
 type ScrollAxis = "y" | "x";
 type ScrollAreaOwnProps = {
     /** Override the ambient cascade theme for this scroller's thumb. */
@@ -252,8 +336,11 @@ type SectionProps = {
     theme: ThemeName;
     id?: string;
     framed?: boolean;
+    intro?: ReactNode;
     action?: ReactNode;
     actionClassName?: string;
+    panelClassName?: string;
+    titleClassName?: string;
     children: ReactNode;
     className?: string;
 };
@@ -323,7 +410,8 @@ type TabButtonProps = {
     children: ReactNode;
     /** Optional cascade override; defaults to inherited [data-theme]. */
     theme?: ThemeName;
-    size?: "medium" | "small";
+    size?: "md" | "sm";
+    variant?: "default" | "ghost";
     ariaLabel?: string;
     disabled?: boolean;
     className?: string;
@@ -358,6 +446,13 @@ type TableCellProps = ComponentPropsWithoutRef<"td"> & {
 };
 declare const TableCell: FC<TableCellProps>;
 
+type TextareaProps = React.ComponentPropsWithoutRef<"textarea"> & {
+    error?: boolean;
+};
+declare const Textarea: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement>, "ref"> & {
+    error?: boolean;
+} & react.RefAttributes<HTMLTextAreaElement>>;
+
 type TooltipProps = {
     children: ReactNode;
     content: ReactNode;
@@ -375,4 +470,4 @@ type TooltipProps = {
 };
 declare const Tooltip: FC<TooltipProps>;
 
-export { Alert, type AlertProps, AppIcon, BeakerIcon, BookIcon, ButtonGroup, type ButtonGroupProps, CheckIcon, ChevronIcon, ClipboardIcon, ClockIcon, Collapsible, type CollapsibleProps, CopyButton, type CopyButtonProps, Dialog, type DialogProps, DialogTitle, DiscordIcon, DownloadIcon, Dropdown, type DropdownProps, ExternalLinkButton, type ExternalLinkButtonProps, ExternalLinkIcon, GenApiIcon, GitHubIcon, IconButton, type IconProps, ImageIcon, InfoTip, Input, type InputProps, LockIcon, MailIcon, McpIcon, MenuIcon, MultiSelect, type MultiSelectProps, type PeriodGranularity, PeriodPicker, type PeriodPickerProps, type PeriodSelection, ScrollArea, type ScrollAreaProps, Section, type SectionProps, Slider, type SliderProps, StatCard, type StatCardProps, Surface, Switch, type SwitchProps, type SwitchStatus, TabButton, type TabButtonProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHead, type TableHeadProps, TableHeaderCell, type TableHeaderCellProps, type TableProps, TableRow, type TableRowProps, TerminalIcon, ThemeName, TokensIcon, Tooltip, TrendUpIcon, WalletIcon, XIcon, cn, currentPeriod, getPeriodBucketKeys, periodBucketKeyToDate, useScrollLock };
+export { Alert, type AlertProps, AppIcon, BeakerIcon, BookIcon, ButtonGroup, type ButtonGroupProps, CheckIcon, ChevronIcon, ClipboardIcon, ClockIcon, Collapsible, type CollapsibleProps, CopyButton, type CopyButtonProps, Dialog, type DialogProps, DialogTitle, DiscordIcon, DownloadIcon, Dropdown, DropdownItem, type DropdownItemProps, type DropdownProps, ExternalLinkButton, type ExternalLinkButtonProps, ExternalLinkIcon, FileUpload, type FileUploadProps, GenApiIcon, GitHubIcon, IconButton, type IconProps, ImageIcon, InfoTip, InlineLink, type InlineLinkProps, Input, type InputProps, LinkCard, type LinkCardProps, LockIcon, MailIcon, Markdown, type MarkdownProps, McpIcon, MenuIcon, MultiSelect, type MultiSelectProps, NavItem, type NavItemProps, type PeriodGranularity, PeriodPicker, type PeriodPickerProps, type PeriodSelection, Prose, type ProseProps, type RejectReason, type RejectedFile, ScrollArea, type ScrollAreaProps, Section, type SectionProps, Slider, type SliderProps, StatCard, type StatCardProps, Surface, Switch, type SwitchProps, type SwitchStatus, TabButton, type TabButtonProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHead, type TableHeadProps, TableHeaderCell, type TableHeaderCellProps, type TableProps, TableRow, type TableRowProps, TerminalIcon, Textarea, type TextareaProps, ThemeName, TokensIcon, Tooltip, TrendUpIcon, WalletIcon, XIcon, cn, currentPeriod, getPeriodBucketKeys, periodBucketKeyToDate, useScrollLock };