@gv-tech/ui-core 1.1.0

package/src/contracts/menubar.ts

@@ -0,0 +1,86 @@
+import * as React from 'react';
+
+export interface MenubarBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  defaultValue?: string;
+  value?: string;
+  onValueChange?: (value: string) => void;
+  dir?: 'ltr' | 'rtl';
+  loop?: boolean;
+}
+
+export interface MenubarMenuBaseProps {
+  children?: React.ReactNode;
+  value?: string;
+}
+
+export interface MenubarTriggerBaseProps {
+  children: React.ReactNode;
+  className?: string;
+  disabled?: boolean;
+}
+
+export interface MenubarContentBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  align?: 'start' | 'center' | 'end';
+  alignOffset?: number;
+  sideOffset?: number;
+}
+
+export interface MenubarItemBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  disabled?: boolean;
+  inset?: boolean;
+  onSelect?: (event: Event) => void;
+}
+
+export interface MenubarCheckboxItemBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  checked?: boolean | 'indeterminate';
+  onCheckedChange?: (checked: boolean) => void;
+  disabled?: boolean;
+}
+
+export interface MenubarRadioItemBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  value: string;
+  disabled?: boolean;
+}
+
+export interface MenubarLabelBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  inset?: boolean;
+}
+
+export interface MenubarSeparatorBaseProps {
+  className?: string;
+}
+
+export interface MenubarShortcutBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export interface MenubarSubBaseProps {
+  children?: React.ReactNode;
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+}
+
+export interface MenubarSubTriggerBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  disabled?: boolean;
+  inset?: boolean;
+}
+
+export interface MenubarSubContentBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+}

package/src/contracts/navigation-menu.ts

@@ -0,0 +1,55 @@
+import * as React from 'react';
+
+export interface NavigationMenuBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  value?: string;
+  onValueChange?: (value: string) => void;
+  dir?: 'ltr' | 'rtl';
+  orientation?: 'horizontal' | 'vertical';
+  delayDuration?: number;
+  skipDelayDuration?: number;
+}
+
+export interface NavigationMenuListBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export interface NavigationMenuItemBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  value?: string;
+}
+
+export interface NavigationMenuTriggerBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  disabled?: boolean;
+}
+
+export interface NavigationMenuContentBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  forceMount?: true;
+}
+
+export interface NavigationMenuLinkBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  active?: boolean;
+  onSelect?: (event: Event) => void;
+  href?: string;
+}
+
+export interface NavigationMenuViewportBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  forceMount?: true;
+}
+
+export interface NavigationMenuIndicatorBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  forceMount?: true;
+}

package/src/contracts/pagination.ts

@@ -0,0 +1,38 @@
+import * as React from 'react';
+import { ButtonSize } from './button';
+
+export interface PaginationBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export interface PaginationContentBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export interface PaginationItemBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export interface PaginationLinkBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  isActive?: boolean;
+  size?: ButtonSize;
+}
+
+export interface PaginationEllipsisBaseProps {
+  className?: string;
+}
+
+export interface PaginationNextBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export interface PaginationPreviousBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+}

package/src/contracts/popover.ts

@@ -0,0 +1,28 @@
+import * as React from 'react';
+
+export interface PopoverBaseProps {
+  children?: React.ReactNode;
+  defaultOpen?: boolean;
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  modal?: boolean;
+}
+
+export interface PopoverTriggerBaseProps {
+  children: React.ReactNode;
+  className?: string;
+  asChild?: boolean;
+}
+
+export interface PopoverContentBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  align?: 'start' | 'center' | 'end';
+  sideOffset?: number;
+}
+
+export interface PopoverAnchorBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  asChild?: boolean;
+}

package/src/contracts/progress.ts

@@ -0,0 +1,4 @@
+export interface ProgressBaseProps {
+  className?: string;
+  value?: number | null;
+}

package/src/contracts/radio.ts

@@ -0,0 +1,16 @@
+// Shared Radio contracts.
+// Both ui-web and ui-native implementations must satisfy these types.
+
+// Platform-agnostic props shared by every RadioGroup implementation.
+// Avoids value/onValueChange that conflict with Radix's prop typings.
+export interface RadioGroupBaseProps {
+  disabled?: boolean;
+  className?: string;
+}
+
+// Platform-agnostic props shared by every RadioGroupItem implementation.
+export interface RadioGroupItemBaseProps {
+  value: string;
+  disabled?: boolean;
+  className?: string;
+}

package/src/contracts/resizable.ts

@@ -0,0 +1,36 @@
+import * as React from 'react';
+
+export interface ResizablePanelGroupBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  direction: 'horizontal' | 'vertical';
+  autoSaveId?: string;
+  storage?: unknown;
+}
+
+export interface ResizablePanelBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  defaultSize?: number;
+  minSize?: number;
+  maxSize?: number;
+  collapsible?: boolean;
+  collapsedSize?: number;
+  minPixelSize?: number;
+  maxPixelSize?: number;
+  order?: number;
+  tagName?: string;
+  id?: string;
+  onCollapse?: () => void;
+  onExpand?: () => void;
+  onResize?: (size: number, prevSize: number | undefined) => void;
+}
+
+export interface ResizableHandleBaseProps {
+  className?: string;
+  withHandle?: boolean;
+  disabled?: boolean;
+  tagName?: string;
+  id?: string;
+  hitAreaMargins?: { top?: number; bottom?: number; left?: number; right?: number };
+}

package/src/contracts/scroll-area.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+
+export interface ScrollAreaBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  type?: 'auto' | 'always' | 'scroll' | 'hover';
+  scrollHideDelay?: number;
+  dir?: 'ltr' | 'rtl';
+}
+
+export interface ScrollBarBaseProps {
+  className?: string;
+  orientation?: 'horizontal' | 'vertical';
+  forceMount?: true;
+}

package/src/contracts/search.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+
+export interface SearchBaseProps {
+  children?: React.ReactNode;
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+}
+
+export interface SearchTriggerBaseProps {
+  className?: string;
+  placeholder?: string;
+  variant?: 'default' | 'compact';
+}

package/src/contracts/select.ts

@@ -0,0 +1,64 @@
+import * as React from 'react';
+
+export interface SelectBaseProps {
+  children?: React.ReactNode;
+  value?: string;
+  defaultValue?: string;
+  onValueChange?: (value: string) => void;
+  open?: boolean;
+  defaultOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  dir?: 'ltr' | 'rtl';
+  name?: string;
+  autoComplete?: string;
+  disabled?: boolean;
+  required?: boolean;
+}
+
+export interface SelectGroupBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export interface SelectValueBaseProps {
+  className?: string;
+  placeholder?: React.ReactNode;
+}
+
+export interface SelectTriggerBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  disabled?: boolean;
+}
+
+export interface SelectContentBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  position?: 'popper' | 'item-aligned';
+  sideOffset?: number;
+  align?: 'start' | 'center' | 'end';
+}
+
+export interface SelectLabelBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export interface SelectItemBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  value: string;
+  disabled?: boolean;
+}
+
+export interface SelectSeparatorBaseProps {
+  className?: string;
+}
+
+export interface SelectScrollUpButtonBaseProps {
+  className?: string;
+}
+
+export interface SelectScrollDownButtonBaseProps {
+  className?: string;
+}

package/src/contracts/separator.ts

@@ -0,0 +1,5 @@
+export interface SeparatorBaseProps {
+  className?: string;
+  orientation?: 'horizontal' | 'vertical';
+  decorative?: boolean;
+}

package/src/contracts/sheet.ts

@@ -0,0 +1,58 @@
+import * as React from 'react';
+
+export interface SheetBaseProps {
+  children?: React.ReactNode;
+  open?: boolean;
+  defaultOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  modal?: boolean;
+}
+
+export interface SheetTriggerBaseProps {
+  children: React.ReactNode;
+  className?: string;
+  asChild?: boolean;
+}
+
+export interface SheetCloseBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  asChild?: boolean;
+}
+
+export interface SheetPortalBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  forceMount?: true;
+}
+
+export interface SheetOverlayBaseProps {
+  className?: string;
+  forceMount?: true;
+}
+
+export interface SheetContentBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  side?: 'top' | 'bottom' | 'left' | 'right';
+}
+
+export interface SheetHeaderBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface SheetFooterBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface SheetTitleBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface SheetDescriptionBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/skeleton.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+
+export interface SkeletonBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/slider.ts

@@ -0,0 +1,15 @@
+export interface SliderBaseProps {
+  className?: string;
+  name?: string;
+  defaultValue?: number[];
+  value?: number[];
+  onValueChange?: (value: number[]) => void;
+  onValueCommit?: (value: number[]) => void;
+  min?: number;
+  max?: number;
+  step?: number;
+  minStepsBetweenThumbs?: number;
+  dir?: 'ltr' | 'rtl';
+  inverted?: boolean;
+  disabled?: boolean;
+}

package/src/contracts/sonner.ts

@@ -0,0 +1,15 @@
+export interface SonnerBaseProps {
+  theme?: 'light' | 'dark' | 'system';
+  className?: string;
+  toastOptions?: {
+    classNames?: {
+      toast?: string;
+      description?: string;
+      actionButton?: string;
+      cancelButton?: string;
+      [key: string]: string | undefined;
+    };
+    [key: string]: unknown;
+  };
+  [key: string]: unknown;
+}

package/src/contracts/switch.ts

@@ -0,0 +1,11 @@
+export interface SwitchBaseProps {
+  className?: string;
+  checked?: boolean;
+  defaultChecked?: boolean;
+  required?: boolean;
+  onCheckedChange?: (checked: boolean) => void;
+  disabled?: boolean;
+  name?: string;
+  value?: string;
+  id?: string;
+}

package/src/contracts/table.ts

@@ -0,0 +1,41 @@
+import * as React from 'react';
+
+export interface TableBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface TableHeaderBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface TableBodyBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface TableFooterBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface TableRowBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface TableHeadBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface TableCellBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface TableCaptionBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/tabs.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+
+export interface TabsBaseProps {
+  children?: React.ReactNode;
+  defaultValue?: string;
+  value?: string;
+  onValueChange?: (value: string) => void;
+  orientation?: 'horizontal' | 'vertical';
+  dir?: 'ltr' | 'rtl';
+  activationMode?: 'automatic' | 'manual';
+}
+
+export interface TabsListBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  loop?: boolean;
+}
+
+export interface TabsTriggerBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  value: string;
+  disabled?: boolean;
+}
+
+export interface TabsContentBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  value: string;
+  forceMount?: true;
+}

package/src/contracts/text.ts

@@ -0,0 +1,12 @@
+// Shared Text contracts.
+// Foundation typography component for cross-platform text rendering.
+
+export const textVariantValues = ['h1', 'h2', 'h3', 'h4', 'body', 'bodySmall', 'caption', 'label', 'overline'] as const;
+export type TextVariant = (typeof textVariantValues)[number];
+
+// Platform-agnostic props shared by every Text implementation.
+// Does NOT include variant — that comes from platform-specific CVA bindings.
+export interface TextBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/textarea.ts

@@ -0,0 +1,7 @@
+export interface TextareaBaseProps {
+  className?: string;
+  placeholder?: string;
+  value?: string;
+  defaultValue?: string;
+  disabled?: boolean;
+}

package/src/contracts/theme-provider.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+
+export interface ThemeProviderBaseProps {
+  children?: React.ReactNode;
+  attribute?: string | string[];
+  defaultTheme?: string;
+  enableSystem?: boolean;
+  disableTransitionOnChange?: boolean;
+  themes?: string[];
+  forcedTheme?: string;
+  storageKey?: string;
+  nonce?: string;
+  [key: string]: unknown;
+}

package/src/contracts/theme-toggle.ts

@@ -0,0 +1,15 @@
+export interface ThemeToggleBaseProps {
+  /**
+   * The mode of the theme toggle. 'binary' allows toggling between light and dark. 'ternary' allows choosing between
+   * light, dark, and system.
+   *
+   * @default 'binary'
+   */
+  variant?: 'binary' | 'ternary';
+  /** Optional callback when the theme changes. */
+  onThemeChange?: (theme: string) => void;
+  /** Optional current theme value for external control. */
+  customTheme?: string;
+  /** Optional className for the button. */
+  className?: string;
+}

package/src/contracts/toast.ts

@@ -0,0 +1,15 @@
+// Shared Toast contracts.
+// Feedback pattern — web uses shadcn/sonner, native uses a custom View.
+
+export const toastVariantValues = ['default', 'destructive'] as const;
+export type ToastVariant = (typeof toastVariantValues)[number];
+
+// Platform-agnostic props shared by every Toast implementation.
+export interface ToastBaseProps {
+  variant?: ToastVariant;
+  title?: string;
+  description?: string;
+  action?: React.ReactNode;
+  className?: string;
+  onDismiss?: () => void;
+}

package/src/contracts/toaster.ts

@@ -0,0 +1,3 @@
+export interface ToasterBaseProps {
+  [key: string]: unknown;
+}

package/src/contracts/toggle-group.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+import { ToggleSize, ToggleVariant } from './toggle';
+
+export interface ToggleGroupBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  variant?: ToggleVariant;
+  size?: ToggleSize;
+  type?: 'single' | 'multiple';
+  defaultValue?: string | string[];
+  value?: string | string[];
+  onValueChange?: (value: string | string[]) => void;
+  disabled?: boolean;
+}
+
+export interface ToggleGroupItemBaseProps {
+  children?: React.ReactNode;
+  className?: string;
+  value: string;
+  variant?: ToggleVariant;
+  size?: ToggleSize;
+  disabled?: boolean;
+}