@stacksjs/components 0.2.3

package/dist/ui/form/index.d.ts

@@ -0,0 +1,48 @@
+import type { PropSchema, ValidationResult } from '../../utils/prop-validation';
+/**
+ * Form prop validation schema
+ */
+export declare const formPropSchema: PropSchema;
+/**
+ * Validate Form component props
+ */
+export declare const validateFormProps: (props: Record<string, any>) => ValidationResult;
+export declare interface FieldSchema {
+  required?: boolean
+  requiredMessage?: string
+  minLength?: number
+  minLengthMessage?: string
+  maxLength?: number
+  maxLengthMessage?: string
+  pattern?: RegExp
+  patternMessage?: string
+  validate?: (value: any, values: Record<string, any>) => string | null | undefined
+}
+export declare interface ValidationSchema {
+
+}
+export declare interface FormHelpers {
+  setErrors: (errors: Record<string, string>) => void
+  setValues: (values: Record<string, any>) => void
+  resetForm: () => void
+}
+export declare interface FormProps {
+  action?: string
+  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
+  validationSchema?: ValidationSchema
+  initialValues?: Record<string, any>
+  validateOnChange?: boolean
+  validateOnBlur?: boolean
+  onSubmit?: (values: Record<string, any>, helpers: FormHelpers) => void | Promise<void>
+  onError?: (errors: Record<string, string> | Error) => void
+  className?: string
+}
+export declare interface FieldProps {
+  name: string
+  value: any
+  error?: string
+  touched?: boolean
+  onChange: (event: Event) => void
+  onBlur: (event: Event) => void
+}
+export { default as Form } from './Form.stx';

package/dist/ui/image/index.d.ts

@@ -0,0 +1,21 @@
+export declare interface ImageProps {
+  src: string
+  srcSet?: string
+  sizes?: string
+  webpSrc?: string
+  webpSrcSet?: string
+  alt: string
+  width?: number | string
+  height?: number | string
+  lazy?: boolean
+  placeholder?: string
+  blurDataURL?: string
+  onLoad?: (event: Event) => void
+  onError?: (event: Event) => void
+  aspectRatio?: number
+  objectFit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down'
+  rounded?: boolean | 'full' | 'sm' | 'md' | 'lg' | 'xl' | '2xl'
+  zoomOnHover?: boolean
+  className?: string
+}
+export { default as Image } from './Image.stx';

package/dist/ui/input/index.d.ts

@@ -0,0 +1,73 @@
+import type { PropSchema, ValidationResult } from '../../utils/prop-validation';
+/**
+ * TextInput prop validation schema
+ */
+export declare const textInputPropSchema: PropSchema;
+/**
+ * NumberInput prop validation schema
+ */
+export declare const numberInputPropSchema: PropSchema;
+/**
+ * Validate TextInput component props
+ */
+export declare const validateTextInputProps: (props: Record<string, any>) => ValidationResult;
+/**
+ * Validate EmailInput component props
+ */
+export declare const validateEmailInputProps: (props: Record<string, any>) => ValidationResult;
+/**
+ * Validate PasswordInput component props
+ */
+export declare const validatePasswordInputProps: (props: Record<string, any>) => ValidationResult;
+/**
+ * Validate NumberInput component props
+ */
+export declare const validateNumberInputProps: (props: Record<string, any>) => ValidationResult;
+/**
+ * Validate SearchInput component props
+ */
+export declare const validateSearchInputProps: (props: Record<string, any>) => ValidationResult;
+export declare interface BaseInputProps {
+  value?: string
+  onChange?: (value: string) => void
+  placeholder?: string
+  disabled?: boolean
+  readonly?: boolean
+  size?: 'sm' | 'md' | 'lg'
+  error?: boolean
+  label?: string
+  helperText?: string
+  required?: boolean
+  className?: string
+  inputClassName?: string
+}
+export declare interface TextInputProps extends BaseInputProps {
+  leftIcon?: string
+  rightIcon?: string
+  clearable?: boolean
+  maxLength?: number
+  showCount?: boolean
+}
+export declare interface EmailInputProps extends Omit<BaseInputProps, 'placeholder'> {
+  placeholder?: string
+}
+export declare interface PasswordInputProps extends Omit<BaseInputProps, 'placeholder'> {
+  placeholder?: string
+  showStrength?: boolean
+}
+export declare interface NumberInputProps extends BaseInputProps {
+  min?: number
+  max?: number
+  step?: number
+  showControls?: boolean
+}
+export declare interface SearchInputProps extends Omit<BaseInputProps, 'placeholder'> {
+  placeholder?: string
+  onSearch?: (value: string) => void
+  loading?: boolean
+}
+export { default as EmailInput } from './EmailInput.stx';
+export { default as NumberInput } from './NumberInput.stx';
+export { default as PasswordInput } from './PasswordInput.stx';
+export { default as SearchInput } from './SearchInput.stx';
+export { default as TextInput } from './TextInput.stx';

package/dist/ui/listbox/index.d.ts

@@ -0,0 +1,34 @@
+export declare interface ListboxProps {
+  value?: any
+  onChange?: (value: any) => void
+  multiple?: boolean
+  className?: string
+  as?: string
+}
+export declare interface ListboxButtonProps {
+  className?: string
+  as?: string
+  disabled?: boolean
+}
+export declare interface ListboxOptionsProps {
+  className?: string
+  as?: string
+  static?: boolean
+}
+export declare interface ListboxOptionProps {
+  value: any
+  disabled?: boolean
+  className?: string
+  as?: string
+  currentValue?: any
+  onChange?: (value: any) => void
+}
+export declare interface ListboxLabelProps {
+  className?: string
+  as?: string
+}
+export { default as Listbox } from './Listbox.stx';
+export { default as ListboxButton } from './ListboxButton.stx';
+export { default as ListboxLabel } from './ListboxLabel.stx';
+export { default as ListboxOption } from './ListboxOption.stx';
+export { default as ListboxOptions } from './ListboxOptions.stx';

package/dist/ui/navigator/index.d.ts

@@ -0,0 +1,18 @@
+export declare interface NavigatorItem {
+  id?: string
+  label: string
+  href?: string
+  icon?: string
+  badge?: string | number
+  disabled?: boolean
+}
+export declare interface NavigatorProps {
+  items: NavigatorItem[]
+  active?: string
+  orientation?: 'horizontal' | 'vertical'
+  variant?: 'default' | 'pills' | 'underline' | 'sidebar'
+  size?: 'sm' | 'md' | 'lg'
+  onNavigate?: (item: NavigatorItem) => void
+  className?: string
+}
+export { default as Navigator } from './Navigator.stx';

package/dist/ui/notification/index.d.ts

@@ -0,0 +1,11 @@
+export declare interface NotificationProps {
+  show?: boolean
+  title?: string
+  message?: string
+  type?: 'info' | 'success' | 'warning' | 'error'
+  position?: 'top-left' | 'top-right' | 'top-center' | 'bottom-left' | 'bottom-right' | 'bottom-center'
+  duration?: number
+  onClose?: () => void
+  className?: string
+}
+export { default as Notification } from './Notification.stx';

package/dist/ui/pagination/index.d.ts

@@ -0,0 +1,10 @@
+export declare interface PaginationProps {
+  currentPage: number
+  totalPages: number
+  siblingCount?: number
+  showFirstLast?: boolean
+  showPrevNext?: boolean
+  onChange?: (page: number) => void
+  className?: string
+}
+export { default as Pagination } from './Pagination.stx';

package/dist/ui/payment/index.d.ts

@@ -0,0 +1,53 @@
+export declare interface PaymentMethod {
+  id: string | number
+  brand: string
+  last_four: string
+  exp_month: number
+  exp_year: number
+  is_default?: boolean
+}
+export declare interface PaymentMethodsProps {
+  paymentMethods: PaymentMethod[]
+  onDeletePaymentMethod?: (id: string | number) => void
+  onMakeDefault?: (id: string | number) => void
+  isLoading?: boolean
+  className?: string
+}
+export declare interface DefaultPaymentMethodProps {
+  paymentMethod: PaymentMethod | null
+  isLoading?: boolean
+  className?: string
+}
+export declare interface Product {
+  id: string | number
+  name: string
+  price: number
+  images?: string
+  quantity?: number
+}
+export declare interface SubscriptionCheckoutProps {
+  products: Product[]
+  stripePublicKey: string
+  apiUrl: string
+  onSubmit?: (result: { success: boolean }) => void
+  onRemoveProduct?: (id: string | number) => void
+  shipping?: number
+  taxes?: number
+  className?: string
+}
+export declare interface CheckoutProps {
+  products: Product[]
+  redirectUrl: string
+  mode: 'one-time' | 'subscription'
+  stripePublicKey: string
+  apiUrl: string
+  onSubmit?: (result: { success: boolean }) => void
+  onRemoveProduct?: (id: string | number) => void
+  shipping?: number
+  taxes?: number
+  className?: string
+}
+export { default as Checkout } from './Checkout.stx';
+export { default as DefaultPaymentMethod } from './DefaultPaymentMethod.stx';
+export { default as PaymentMethods } from './PaymentMethods.stx';
+export { default as SubscriptionCheckout } from './SubscriptionCheckout.stx';

package/dist/ui/popover/index.d.ts

@@ -0,0 +1,19 @@
+export declare interface PopoverProps {
+  className?: string
+  as?: string
+}
+export declare interface PopoverButtonProps {
+  className?: string
+  as?: string
+  disabled?: boolean
+  onClick?: (e: Event) => void
+}
+export declare interface PopoverPanelProps {
+  className?: string
+  as?: string
+  static?: boolean
+  position?: 'top' | 'bottom' | 'left' | 'right'
+}
+export { default as Popover } from './Popover.stx';
+export { default as PopoverButton } from './PopoverButton.stx';
+export { default as PopoverPanel } from './PopoverPanel.stx';

package/dist/ui/portal/index.d.ts

@@ -0,0 +1,5 @@
+export declare interface PortalProps {
+  target?: string | HTMLElement
+  disabled?: boolean
+}
+export { default as Portal } from './Portal.stx';

package/dist/ui/progress/index.d.ts

@@ -0,0 +1,11 @@
+export declare interface ProgressProps {
+  value?: number
+  max?: number
+  variant?: 'linear' | 'circular'
+  size?: 'sm' | 'md' | 'lg'
+  color?: 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info'
+  showLabel?: boolean
+  indeterminate?: boolean
+  className?: string
+}
+export { default as Progress } from './Progress.stx';

package/dist/ui/radio/index.d.ts

@@ -0,0 +1,14 @@
+export declare interface RadioProps {
+  checked?: boolean
+  onChange?: (value: string, checked: boolean) => void
+  disabled?: boolean
+  size?: 'sm' | 'md' | 'lg'
+  label?: string
+  description?: string
+  error?: boolean
+  required?: boolean
+  value?: string
+  name?: string
+  className?: string
+}
+export { default as Radio } from './Radio.stx';

package/dist/ui/radio-group/index.d.ts

@@ -0,0 +1,26 @@
+export declare interface RadioGroupProps {
+  value?: any
+  onChange?: (value: any) => void
+  className?: string
+  as?: string
+}
+export declare interface RadioGroupLabelProps {
+  className?: string
+  as?: string
+}
+export declare interface RadioGroupOptionProps {
+  value: any
+  disabled?: boolean
+  className?: string
+  as?: string
+  currentValue?: any
+  onChange?: (value: any) => void
+}
+export declare interface RadioGroupDescriptionProps {
+  className?: string
+  as?: string
+}
+export { default as RadioGroup } from './RadioGroup.stx';
+export { default as RadioGroupDescription } from './RadioGroupDescription.stx';
+export { default as RadioGroupLabel } from './RadioGroupLabel.stx';
+export { default as RadioGroupOption } from './RadioGroupOption.stx';

package/dist/ui/select/index.d.ts

@@ -0,0 +1,19 @@
+export declare interface SelectOption {
+  value: string | number
+  label: string
+  disabled?: boolean
+}
+export declare interface SelectProps {
+  value?: string | number
+  onChange?: (value: string | number) => void
+  options?: SelectOption[]
+  placeholder?: string
+  disabled?: boolean
+  size?: 'sm' | 'md' | 'lg'
+  error?: boolean
+  label?: string
+  helperText?: string
+  required?: boolean
+  className?: string
+}
+export { default as Select } from './Select.stx';

package/dist/ui/sidebar/index.d.ts

@@ -0,0 +1,129 @@
+// Types
+export declare interface SidebarItemData {
+  id: string
+  label: string
+  icon?: string
+  href?: string
+  badge?: string | number
+  active?: boolean
+  disabled?: boolean
+}
+export declare interface SidebarSectionData {
+  id: string
+  label: string
+  icon?: string
+  items: SidebarItemData[]
+  expanded?: boolean
+  collapsible?: boolean
+}
+export declare interface SidebarProps {
+  sections?: SidebarSectionData[]
+  collapsed?: boolean
+  collapsible?: boolean
+  width?: number
+  minWidth?: number
+  variant?: 'tahoe' | 'vibrancy' | 'solid' | 'transparent'
+  position?: 'left' | 'right'
+  bordered?: boolean
+  className?: string
+  onCollapse?: (collapsed: boolean) => void
+  onSectionToggle?: (sectionId: string) => void
+  onItemClick?: (item: SidebarItemData, event: Event) => void
+}
+export declare interface SidebarSectionProps {
+  id: string
+  label: string
+  icon?: string
+  items: SidebarItemData[]
+  expanded?: boolean
+  collapsible?: boolean
+  showLabel?: boolean
+  onToggle?: (id: string) => void
+  onItemClick?: (item: SidebarItemData, event: Event) => void
+}
+export declare interface SidebarItemProps {
+  id: string
+  label: string
+  icon?: string
+  href?: string
+  badge?: string | number
+  active?: boolean
+  disabled?: boolean
+  indent?: boolean
+  onClick?: (event: Event) => void
+}
+export declare interface SidebarHeaderProps {
+  title?: string
+  subtitle?: string
+  logo?: string
+  logoIcon?: string
+  showSearch?: boolean
+  searchPlaceholder?: string
+  searchValue?: string
+  collapsed?: boolean
+  onSearch?: (value: string) => void
+}
+export declare interface SidebarFooterProps {
+  showSettings?: boolean
+  showThemeToggle?: boolean
+  settingsHref?: string
+  settingsLabel?: string
+  collapsed?: boolean
+  actions?: Array<{
+    label: string
+    icon?: string
+    href?: string
+    onClick?: () => void
+  }>
+  onThemeToggle?: () => void
+}
+/**
+ * Native Sidebar Configuration
+ *
+ * Used to configure the native macOS sidebar when running with Craft's --native-sidebar flag.
+ * The sidebar uses NSOutlineView with vibrancy for a true Tahoe-style appearance.
+ */
+export declare interface NativeSidebarConfig {
+  header?: {
+    title?: string
+    subtitle?: string
+    icon?: string // SF Symbol name (e.g., 'house.fill', 'message.fill')
+  }
+  searchPlaceholder?: string
+  sections: NativeSidebarSection[]
+  minWidth?: number
+  maxWidth?: number
+  canCollapse?: boolean
+}
+export declare interface NativeSidebarSection {
+  id: string
+  title: string
+  collapsible?: boolean
+  collapsed?: boolean
+  items: NativeSidebarItem[]
+}
+export declare interface NativeSidebarItem {
+  id: string
+  label: string
+  icon?: string
+  badge?: string | number
+  tintColor?: string
+  selected?: boolean
+  disabled?: boolean
+  children?: NativeSidebarItem[]
+  data?: Record<string, unknown>
+}
+/**
+ * Craft sidebar selection event
+ * Passed to window.craft._sidebarSelectHandler when user clicks a sidebar item
+ */
+export declare interface SidebarSelectEvent {
+  itemId: string
+  item: NativeSidebarItem
+  sectionId?: string
+}
+export { default as Sidebar } from './Sidebar.stx';
+export { default as SidebarSection } from './SidebarSection.stx';
+export { default as SidebarItem } from './SidebarItem.stx';
+export { default as SidebarHeader } from './SidebarHeader.stx';
+export { default as SidebarFooter } from './SidebarFooter.stx';

package/dist/ui/skeleton/index.d.ts

@@ -0,0 +1,10 @@
+export declare interface SkeletonProps {
+  variant?: 'text' | 'title' | 'avatar' | 'thumbnail' | 'button' | 'card' | 'rect'
+  count?: number
+  width?: string | number
+  height?: string | number
+  circle?: boolean
+  animate?: boolean
+  className?: string
+}
+export { default as Skeleton } from './Skeleton.stx';

package/dist/ui/spinner/index.d.ts

@@ -0,0 +1,8 @@
+export declare interface SpinnerProps {
+  variant?: 'circle' | 'dots' | 'bars' | 'ring'
+  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl'
+  color?: 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info' | 'white' | 'gray'
+  label?: string
+  className?: string
+}
+export { default as Spinner } from './Spinner.stx';

package/dist/ui/stepper/index.d.ts

@@ -0,0 +1,17 @@
+export declare interface StepperProps {
+  currentStep?: number
+  orientation?: 'horizontal' | 'vertical'
+  className?: string
+  as?: string
+}
+export declare interface StepperStepProps {
+  stepNumber: number
+  currentStep?: number
+  label?: string
+  description?: string
+  className?: string
+  as?: string
+  onClick?: (step: number) => void
+}
+export { default as Stepper } from './Stepper.stx';
+export { default as StepperStep } from './StepperStep.stx';

package/dist/ui/storage/index.d.ts

@@ -0,0 +1,40 @@
+export declare function createStorage(type?: 'local' | 'session', namespace?: string): StorageManager;
+// Convenience exports
+export declare const storage: {
+  local: StorageManager
+  session: StorageManager
+};
+// Storage utilities for localStorage and sessionStorage
+export declare interface StorageOptions {
+  expire?: number
+  namespace?: string
+  encrypt?: boolean
+  compress?: boolean
+}
+declare type StorageWatchCallback = (newValue: any, oldValue: any, key: string) => void
+export declare class StorageManager {
+  private storage: globalThis.Storage;
+  private namespace: string;
+  private watchers: Map<string, Set<StorageWatchCallback>>;
+  private encryptionKey: any;
+  constructor(type?: 'local' | 'session', namespace?: any);
+  private handleStorageEvent(event: StorageEvent): void;
+  private encrypt(data: string): string;
+  private decrypt(data: string): string;
+  private compress(data: string): string;
+  private decompress(data: string): string;
+  private getKey(key: string): string;
+  set(key: string, value: any, options?: StorageOptions): void;
+  get<T = any>(key: string): T | null;
+  watch(key: string, callback: StorageWatchCallback): () => void;
+  private notifyWatchers(key: string, newValue: any, oldValue: any): void;
+  remove(key: string): void;
+  clear(): void;
+  has(key: string): boolean;
+  keys(): string[];
+  size(): number;
+  getQuota(): { usage: number, quota: number, percentage: number } | null;
+  setMany(items: Record<string, any>, options?: StorageOptions): void;
+  getMany<T = any>(keys: string[]): Record<string, T | null>;
+  removeMany(keys: string[]): void;
+}

package/dist/ui/switch/index.d.ts

@@ -0,0 +1,9 @@
+export declare interface SwitchProps {
+  checked?: boolean
+  disabled?: boolean
+  size?: 'sm' | 'md' | 'lg'
+  className?: string
+  onChange?: (checked: boolean) => void
+  label?: string
+}
+export { default as Switch } from './Switch.stx';

package/dist/ui/table/index.d.ts

@@ -0,0 +1,29 @@
+export declare interface TableProps {
+  className?: string
+  striped?: boolean
+  hoverable?: boolean
+}
+export declare interface TableHeadProps {
+  className?: string
+}
+export declare interface TableBodyProps {
+  className?: string
+}
+export declare interface TableRowProps {
+  className?: string
+  hoverable?: boolean
+}
+export declare interface TableHeaderProps {
+  className?: string
+  sortable?: boolean
+  onClick?: () => void
+}
+export declare interface TableCellProps {
+  className?: string
+}
+export { default as Table } from './Table.stx';
+export { default as TableBody } from './TableBody.stx';
+export { default as TableCell } from './TableCell.stx';
+export { default as TableHead } from './TableHead.stx';
+export { default as TableHeader } from './TableHeader.stx';
+export { default as TableRow } from './TableRow.stx';

package/dist/ui/tabs/index.d.ts

@@ -0,0 +1,14 @@
+export declare interface Tab {
+  label: string
+  content: string
+  icon?: string
+}
+export declare interface TabsProps {
+  tabs: Tab[]
+  defaultTab?: number
+  orientation?: 'horizontal' | 'vertical'
+  variant?: 'line' | 'pills' | 'enclosed'
+  onChange?: (index: number, tab: Tab) => void
+  className?: string
+}
+export { default as Tabs } from './Tabs.stx';

package/dist/ui/teleport/index.d.ts

@@ -0,0 +1,6 @@
+export declare interface TeleportProps {
+  to?: string | HTMLElement
+  disabled?: boolean
+  defer?: boolean
+}
+export { default as Teleport } from './Teleport.stx';

package/dist/ui/textarea/index.d.ts

@@ -0,0 +1,19 @@
+export declare interface TextareaProps {
+  value?: string
+  onChange?: (value: string) => void
+  placeholder?: string
+  disabled?: boolean
+  readonly?: boolean
+  rows?: number
+  autoResize?: boolean
+  maxRows?: number
+  error?: boolean
+  label?: string
+  helperText?: string
+  required?: boolean
+  maxLength?: number
+  showCount?: boolean
+  resize?: 'none' | 'vertical' | 'horizontal' | 'both'
+  className?: string
+}
+export { default as Textarea } from './Textarea.stx';