sparkdesign 0.4.8 → 0.4.10

package/dist/registry/basic/ellipsis-text.d.ts

@@ -0,0 +1,45 @@
+/**
+ * [WHO]: EllipsisText — overflow-aware text with optional tooltip disclosure.
+ * [FROM]: react, clsx, registry/basic/tooltip.
+ * [TO]: sparkdesign package consumers; CLI `add ellipsis-text`; Showcase demos.
+ * [HERE]: registry/basic/ellipsis-text.tsx — canonical source for copied and packaged EllipsisText.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
+ */
+import { type ReactNode, type CSSProperties } from 'react';
+export interface EllipsisTextProps {
+    /** Text or inline content to display. */
+    children: ReactNode;
+    /**
+     * Maximum visible lines before truncation.
+     * @default 1
+     */
+    lines?: number;
+    /** Extra className for the text node. */
+    className?: string;
+    /**
+     * Tooltip placement when overflow is detected.
+     * @default 'top'
+     */
+    placement?: 'top' | 'bottom' | 'left' | 'right';
+    /** Extra className for Tooltip content. */
+    tooltipClassName?: string;
+    /** Custom tooltip content. Defaults to children. */
+    tooltipContent?: ReactNode;
+    /**
+     * Disable tooltip even when content overflows.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Inline style for the text node. */
+    style?: CSSProperties;
+    /**
+     * Rendered text element.
+     * @default 'span'
+     */
+    as?: 'span' | 'div' | 'p';
+}
+export declare const EllipsisText: import("react").ForwardRefExoticComponent<EllipsisTextProps & import("react").RefAttributes<HTMLElement>>;

package/dist/registry/basic/form.d.ts

@@ -0,0 +1,23 @@
+import * as React from "react";
+import * as LabelPrimitive from "@radix-ui/react-label";
+import { type ControllerProps, type FieldPath, type FieldValues } from "react-hook-form";
+declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>(props: import("react-hook-form").FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
+declare function FormField<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ ...props }: ControllerProps<TFieldValues, TName>): import("react/jsx-runtime").JSX.Element;
+declare function useFormField(): {
+    invalid: boolean;
+    isDirty: boolean;
+    isTouched: boolean;
+    isValidating: boolean;
+    error?: import("react-hook-form").FieldError;
+    id: string;
+    name: string;
+    formItemId: string;
+    formDescriptionId: string;
+    formMessageId: string;
+};
+declare const FormItem: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const FormLabel: React.ForwardRefExoticComponent<Omit<LabelPrimitive.LabelProps & React.RefAttributes<HTMLLabelElement>, "ref"> & React.RefAttributes<HTMLLabelElement>>;
+declare const FormControl: React.ForwardRefExoticComponent<Omit<import("@radix-ui/react-slot").SlotProps & React.RefAttributes<HTMLElement>, "ref"> & React.RefAttributes<HTMLElement>>;
+declare const FormDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+declare const FormMessage: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+export { useFormField, Form, FormItem, FormLabel, FormControl, FormDescription, FormMessage, FormField, };

package/dist/registry/basic/icon-button.d.ts

@@ -5,9 +5,22 @@ declare const iconButtonVariants: (props?: ({
     rounded?: "square" | "pill" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export interface IconButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof iconButtonVariants> {
+type IconButtonAccessibleName = {
+    'aria-label': string;
+    'aria-labelledby'?: string;
+    title?: string;
+} | {
+    'aria-label'?: string;
+    'aria-labelledby': string;
+    title?: string;
+} | {
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    title: string;
+};
+export type IconButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'aria-label' | 'aria-labelledby' | 'title'> & VariantProps<typeof iconButtonVariants> & IconButtonAccessibleName & {
     icon: ReactNode;
     asChild?: boolean;
-}
+};
 export declare const IconButton: import("react").ForwardRefExoticComponent<IconButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 export { iconButtonVariants };

package/dist/registry/basic/item.d.ts

@@ -11,7 +11,7 @@ declare function Item({ className, variant, size, asChild, ...props }: React.Com
     asChild?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
 declare const itemMediaVariants: (props?: ({
-    variant?: "default" | "icon" | "image" | null | undefined;
+    variant?: "default" | "image" | "icon" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function ItemMedia({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof itemMediaVariants>): import("react/jsx-runtime").JSX.Element;
 declare function ItemContent({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;

package/dist/registry/basic/popover.d.ts

@@ -18,6 +18,8 @@ export interface PopoverContentProps extends React.ComponentPropsWithoutRef<type
     /** When provided (e.g. from ThemeStyleProvider), used for portal wrapper */
     dataStyle?: string;
     dataTheme?: string;
+    /** Popover internal padding; keep default to avoid breaking existing usages */
+    contentPadding?: 'default' | 'compact' | 'none';
 }
 declare const PopoverContent: React.ForwardRefExoticComponent<PopoverContentProps & React.RefAttributes<HTMLDivElement>>;
 export { Popover, PopoverTrigger, PopoverAnchor, PopoverContent };

package/dist/registry/basic/rating.d.ts

@@ -0,0 +1,31 @@
+/**
+ * [WHO]: Rating component for tokenized star scoring and preference feedback.
+ * [FROM]: React, class-variance-authority, registry/lib/utils.
+ * [TO]: sparkdesign package consumers; Showcase; CLI registry copies.
+ * [HERE]: registry/basic/rating.tsx — interactive or read-only rating primitive.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
+ */
+import * as React from 'react';
+import { type VariantProps } from 'class-variance-authority';
+declare const ratingVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type RatingPrecision = 1 | 0.5;
+export interface RatingProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'>, VariantProps<typeof ratingVariants> {
+    value?: number;
+    defaultValue?: number;
+    onValueChange?: (value: number) => void;
+    max?: number;
+    precision?: RatingPrecision;
+    readOnly?: boolean;
+    disabled?: boolean;
+    showValue?: boolean;
+    label?: string;
+}
+declare const Rating: React.ForwardRefExoticComponent<RatingProps & React.RefAttributes<HTMLDivElement>>;
+export { Rating, ratingVariants };
+export type { RatingPrecision };

package/dist/registry/basic/sidebar.d.ts

@@ -0,0 +1,72 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+import { Button } from "./button";
+import { Input } from "./input";
+import { Separator } from "./separator";
+import { Tooltip } from "./tooltip";
+type SidebarContextValue = {
+    state: "expanded" | "collapsed";
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    openMobile: boolean;
+    setOpenMobile: (open: boolean) => void;
+    isMobile: boolean;
+    toggleSidebar: () => void;
+};
+declare function useSidebar(): SidebarContextValue;
+declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: setOpenProp, className, style, children, ...props }: React.ComponentProps<"div"> & {
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Sidebar({ side, variant, collapsible, className, children, ...props }: React.ComponentProps<"div"> & {
+    side?: "left" | "right";
+    variant?: "sidebar" | "floating" | "inset";
+    collapsible?: "offcanvas" | "icon" | "none";
+}): import("react/jsx-runtime").JSX.Element;
+declare function SidebarTrigger({ className, onClick, children, ...props }: Omit<React.ComponentProps<typeof Button>, "children" | "variant" | "size"> & {
+    children?: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function SidebarRail({ className, ...props }: React.ComponentProps<"button">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarInset({ className, ...props }: React.ComponentProps<"main">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarInput({ className, ...props }: React.ComponentProps<typeof Input>): import("react/jsx-runtime").JSX.Element;
+declare function SidebarHeader({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarFooter({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarSeparator({ className, ...props }: React.ComponentProps<typeof Separator>): import("react/jsx-runtime").JSX.Element;
+declare function SidebarContent({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarGroup({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarGroupLabel({ className, asChild, ...props }: React.ComponentProps<"div"> & {
+    asChild?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+declare function SidebarGroupAction({ className, asChild, ...props }: React.ComponentProps<"button"> & {
+    asChild?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+declare function SidebarGroupContent({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">): import("react/jsx-runtime").JSX.Element;
+declare const sidebarMenuButtonVariants: (props?: ({
+    variant?: "default" | "outline" | null | undefined;
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare function SidebarMenuButton({ asChild, isActive, variant, size, tooltip, className, ...props }: React.ComponentProps<"button"> & {
+    asChild?: boolean;
+    isActive?: boolean;
+    tooltip?: string | Omit<React.ComponentProps<typeof Tooltip>, "children">;
+} & VariantProps<typeof sidebarMenuButtonVariants>): import("react/jsx-runtime").JSX.Element;
+declare function SidebarMenuAction({ className, asChild, showOnHover, ...props }: React.ComponentProps<"button"> & {
+    asChild?: boolean;
+    showOnHover?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+declare function SidebarMenuBadge({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarMenuSkeleton({ className, showIcon, width, ...props }: React.ComponentProps<"div"> & {
+    showIcon?: boolean;
+    width?: string;
+}): import("react/jsx-runtime").JSX.Element;
+declare function SidebarMenuSub({ className, ...props }: React.ComponentProps<"ul">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarMenuSubItem({ className, ...props }: React.ComponentProps<"li">): import("react/jsx-runtime").JSX.Element;
+declare function SidebarMenuSubButton({ asChild, size, isActive, className, ...props }: React.ComponentProps<"a"> & {
+    asChild?: boolean;
+    size?: "sm" | "md";
+    isActive?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, sidebarMenuButtonVariants, useSidebar, };

package/dist/registry/basic/stepper.d.ts

@@ -0,0 +1,36 @@
+/**
+ * [WHO]: Stepper primitives for linear setup, checkout, and workflow progress.
+ * [FROM]: React, class-variance-authority, registry/lib/utils.
+ * [TO]: sparkdesign package consumers; Showcase; CLI registry copies.
+ * [HERE]: registry/basic/stepper.tsx — tokenized horizontal/vertical stepper.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
+ */
+import * as React from 'react';
+import { type VariantProps } from 'class-variance-authority';
+type StepStatus = 'complete' | 'current' | 'upcoming' | 'error';
+declare const stepperVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface StepperProps extends React.OlHTMLAttributes<HTMLOListElement>, VariantProps<typeof stepperVariants> {
+}
+export interface StepperItemProps extends React.LiHTMLAttributes<HTMLLIElement> {
+    status?: StepStatus;
+}
+export type StepperIndicatorProps = React.HTMLAttributes<HTMLSpanElement>;
+export type StepperContentProps = React.HTMLAttributes<HTMLDivElement>;
+export type StepperTitleProps = React.HTMLAttributes<HTMLDivElement>;
+export type StepperDescriptionProps = React.HTMLAttributes<HTMLDivElement>;
+export type StepperSeparatorProps = React.HTMLAttributes<HTMLSpanElement>;
+declare function Stepper({ className, orientation, ...props }: StepperProps): import("react/jsx-runtime").JSX.Element;
+declare function StepperItem({ className, status, ...props }: StepperItemProps): import("react/jsx-runtime").JSX.Element;
+declare function StepperIndicator({ className, children, ...props }: StepperIndicatorProps): import("react/jsx-runtime").JSX.Element;
+declare function StepperContent({ className, ...props }: StepperContentProps): import("react/jsx-runtime").JSX.Element;
+declare function StepperTitle({ className, ...props }: StepperTitleProps): import("react/jsx-runtime").JSX.Element;
+declare function StepperDescription({ className, ...props }: StepperDescriptionProps): import("react/jsx-runtime").JSX.Element;
+declare function StepperSeparator({ className, ...props }: StepperSeparatorProps): import("react/jsx-runtime").JSX.Element;
+export { Stepper, StepperItem, StepperIndicator, StepperContent, StepperTitle, StepperDescription, StepperSeparator, };
+export type { StepStatus };

package/dist/registry/basic/tag.d.ts

@@ -13,7 +13,7 @@ import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const tagVariants: (props?: ({
     appearance?: "outline" | "filled" | null | undefined;
-    color?: "link" | "primary" | "blue" | "lavender" | "orange" | "pink" | "purple" | "teal" | "yellow" | "error" | "warning" | "success" | "info" | "mauve" | "slate" | "sage" | null | undefined;
+    color?: "link" | "primary" | "error" | "blue" | "lavender" | "orange" | "pink" | "purple" | "teal" | "yellow" | "warning" | "success" | "info" | "mauve" | "slate" | "sage" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface TagProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'color'>, VariantProps<typeof tagVariants> {
     closable?: boolean;

package/dist/registry/basic/timeline.d.ts

@@ -0,0 +1,34 @@
+/**
+ * [WHO]: Timeline primitives for activity feeds, audits, and release histories.
+ * [FROM]: React, class-variance-authority, registry/lib/utils.
+ * [TO]: sparkdesign package consumers; Showcase; CLI registry copies.
+ * [HERE]: registry/basic/timeline.tsx — tokenized vertical timeline composition.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
+ */
+import * as React from 'react';
+import { type VariantProps } from 'class-variance-authority';
+declare const timelineMarkerVariants: (props?: ({
+    tone?: "default" | "primary" | "error" | "warning" | "success" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type TimelineProps = React.OlHTMLAttributes<HTMLOListElement>;
+export type TimelineItemProps = React.LiHTMLAttributes<HTMLLIElement>;
+export type TimelineContentProps = React.HTMLAttributes<HTMLDivElement>;
+export type TimelineTitleProps = React.HTMLAttributes<HTMLDivElement>;
+export type TimelineDescriptionProps = React.HTMLAttributes<HTMLDivElement>;
+export type TimelineTimeProps = React.TimeHTMLAttributes<HTMLTimeElement>;
+export type TimelineConnectorProps = React.HTMLAttributes<HTMLSpanElement>;
+export interface TimelineMarkerProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof timelineMarkerVariants> {
+}
+declare function Timeline({ className, ...props }: TimelineProps): import("react/jsx-runtime").JSX.Element;
+declare function TimelineItem({ className, ...props }: TimelineItemProps): import("react/jsx-runtime").JSX.Element;
+declare function TimelineMarker({ className, tone, ...props }: TimelineMarkerProps): import("react/jsx-runtime").JSX.Element;
+declare function TimelineConnector({ className, ...props }: TimelineConnectorProps): import("react/jsx-runtime").JSX.Element;
+declare function TimelineContent({ className, ...props }: TimelineContentProps): import("react/jsx-runtime").JSX.Element;
+declare function TimelineTitle({ className, ...props }: TimelineTitleProps): import("react/jsx-runtime").JSX.Element;
+declare function TimelineDescription({ className, ...props }: TimelineDescriptionProps): import("react/jsx-runtime").JSX.Element;
+declare function TimelineTime({ className, ...props }: TimelineTimeProps): import("react/jsx-runtime").JSX.Element;
+export { Timeline, TimelineItem, TimelineMarker, TimelineConnector, TimelineContent, TimelineTitle, TimelineDescription, TimelineTime, timelineMarkerVariants, };