@gv-tech/ui-core 1.1.0

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@gv-tech/ui-core",
+  "version": "1.1.0",
+  "description": "Shared component contracts (props, variants, sizes) for the GV Tech design system",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Garcia-Ventures/gvtech-design.git",
+    "directory": "packages/ui-core"
+  },
+  "license": "MIT",
+  "author": "Eric N. Garcia <eng618@garciaericn.com>",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./contracts/*": {
+      "types": "./src/contracts/*.ts",
+      "default": "./src/contracts/*.ts"
+    }
+  },
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "build": "echo 'No build step — consumed as TS source by sibling packages'",
+    "lint": "echo 'Linted from workspace root'",
+    "test": "echo 'No tests yet'",
+    "typecheck": "npx tsc --noEmit"
+  },
+  "dependencies": {
+    "class-variance-authority": "^0.7.1"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/contracts/accordion.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+
+export interface AccordionBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AccordionItemBaseProps {
+  value: string;
+  disabled?: boolean;
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AccordionTriggerBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AccordionContentBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/alert-dialog.ts

@@ -0,0 +1,48 @@
+import * as React from 'react';
+
+export interface AlertDialogBaseProps {
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  children?: React.ReactNode;
+}
+
+export interface AlertDialogContentBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AlertDialogHeaderBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AlertDialogFooterBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AlertDialogTitleBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AlertDialogDescriptionBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AlertDialogActionBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AlertDialogCancelBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AlertDialogTriggerBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  asChild?: boolean;
+}

package/src/contracts/alert.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+
+export interface AlertBaseProps {
+  variant?: 'default' | 'destructive' | 'warning' | 'info';
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AlertTitleBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AlertDescriptionBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/aspect-ratio.ts

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

package/src/contracts/avatar.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+
+export interface AvatarBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface AvatarImageBaseProps {
+  className?: string;
+  src?: string;
+  alt?: string;
+}
+
+export interface AvatarFallbackBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/badge.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+
+export interface BadgeBaseProps {
+  variant?: 'default' | 'secondary' | 'destructive' | 'outline';
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/breadcrumb.ts

@@ -0,0 +1,37 @@
+import * as React from 'react';
+
+export interface BreadcrumbBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface BreadcrumbListBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface BreadcrumbItemBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface BreadcrumbLinkBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  asChild?: boolean;
+}
+
+export interface BreadcrumbPageBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface BreadcrumbSeparatorBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface BreadcrumbEllipsisBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/button.ts

@@ -0,0 +1,17 @@
+// Shared Button variant and size contracts.
+// Both ui-web and ui-native implementations must satisfy these types.
+
+export const buttonVariantValues = ['default', 'destructive', 'outline', 'secondary', 'ghost', 'link'] as const;
+export type ButtonVariant = (typeof buttonVariantValues)[number];
+
+export const buttonSizeValues = ['default', 'sm', 'lg', 'icon'] as const;
+export type ButtonSize = (typeof buttonSizeValues)[number];
+
+// Platform-agnostic props shared by every Button implementation.
+// Does NOT include variant/size — those come from platform-specific CVA bindings
+// to avoid type conflicts with VariantProps.
+export interface ButtonBaseProps {
+  disabled?: boolean;
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/calendar.ts

@@ -0,0 +1,4 @@
+export interface CalendarBaseProps {
+  className?: string;
+  showOutsideDays?: boolean;
+}

package/src/contracts/card.ts

@@ -0,0 +1,11 @@
+// Shared Card contracts.
+// Both ui-web and ui-native implementations must satisfy these types.
+
+// Platform-agnostic props shared by every Card sub-component.
+export interface CardBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+// Card exports the same sub-components on both platforms.
+export type CardSubComponent = 'Card' | 'CardHeader' | 'CardTitle' | 'CardDescription' | 'CardContent' | 'CardFooter';

package/src/contracts/carousel.ts

@@ -0,0 +1,29 @@
+import * as React from 'react';
+
+export interface CarouselBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  orientation?: 'horizontal' | 'vertical';
+}
+
+export interface CarouselContentBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface CarouselItemBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface CarouselPreviousBaseProps {
+  className?: string;
+  variant?: string;
+  size?: string;
+}
+
+export interface CarouselNextBaseProps {
+  className?: string;
+  variant?: string;
+  size?: string;
+}

package/src/contracts/chart.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+
+export type ChartConfig = {
+  [k in string]: {
+    label?: React.ReactNode;
+    icon?: React.ComponentType;
+  } & ({ color?: string; theme?: never } | { color?: never; theme: Record<string, string> });
+};
+
+export interface ChartContainerBaseProps {
+  config: ChartConfig;
+  className?: string;
+  children?: React.ReactNode;
+  id?: string;
+}
+
+export interface ChartTooltipContentBaseProps {
+  hideLabel?: boolean;
+  hideIndicator?: boolean;
+  indicator?: 'line' | 'dot' | 'dashed';
+  nameKey?: string;
+  labelKey?: string;
+  className?: string;
+  labelClassName?: string;
+}
+
+export interface ChartLegendContentBaseProps {
+  hideIcon?: boolean;
+  nameKey?: string;
+  className?: string;
+}

package/src/contracts/checkbox.ts

@@ -0,0 +1,11 @@
+// Shared Checkbox contracts.
+// Both ui-web and ui-native implementations must satisfy these types.
+
+// Platform-agnostic props shared by every Checkbox implementation.
+export interface CheckboxBaseProps {
+  checked?: boolean;
+  defaultChecked?: boolean;
+  disabled?: boolean;
+  className?: string;
+  onCheckedChange?: (checked: boolean) => void;
+}

package/src/contracts/collapsible.ts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+
+export interface CollapsibleBaseProps {
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  disabled?: boolean;
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export interface CollapsibleTriggerBaseProps {
+  asChild?: boolean;
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export interface CollapsibleContentBaseProps {
+  asChild?: boolean;
+  children?: React.ReactNode;
+  className?: string;
+}

package/src/contracts/command.ts

@@ -0,0 +1,43 @@
+import * as React from 'react';
+
+export interface CommandBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface CommandInputBaseProps {
+  className?: string;
+  placeholder?: string;
+}
+
+export interface CommandListBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface CommandEmptyBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface CommandGroupBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  heading?: React.ReactNode;
+}
+
+export interface CommandItemBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  onSelect?: (value: string) => void;
+  value?: string;
+}
+
+export interface CommandSeparatorBaseProps {
+  className?: string;
+}
+
+export interface CommandShortcutBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/context-menu.ts

@@ -0,0 +1,78 @@
+import * as React from 'react';
+
+export interface ContextMenuBaseProps {
+  children?: React.ReactNode;
+}
+
+export interface ContextMenuTriggerBaseProps {
+  children: React.ReactNode;
+  disabled?: boolean;
+}
+
+export interface ContextMenuContentBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface ContextMenuItemBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  inset?: boolean;
+  disabled?: boolean;
+  onSelect?: (event: Event) => void;
+}
+
+export interface ContextMenuCheckboxItemBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  checked?: boolean | 'indeterminate';
+  onCheckedChange?: (checked: boolean) => void;
+  disabled?: boolean;
+}
+
+export interface ContextMenuRadioItemBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  value: string;
+  disabled?: boolean;
+}
+
+export interface ContextMenuLabelBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  inset?: boolean;
+}
+
+export interface ContextMenuSeparatorBaseProps {
+  className?: string;
+}
+
+export interface ContextMenuShortcutBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface ContextMenuSubBaseProps {
+  children?: React.ReactNode;
+}
+
+export interface ContextMenuSubTriggerBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  inset?: boolean;
+}
+
+export interface ContextMenuSubContentBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface ContextMenuGroupBaseProps {
+  children?: React.ReactNode;
+}
+
+export interface ContextMenuRadioGroupBaseProps {
+  children?: React.ReactNode;
+  value?: string;
+  onValueChange?: (value: string) => void;
+}

package/src/contracts/dialog.ts

@@ -0,0 +1,29 @@
+// Shared Dialog / Sheet contracts.
+// Maps to Dialog on web, BottomSheet / Modal on native.
+
+// Platform-agnostic props shared by every Dialog implementation.
+export interface DialogBaseProps {
+  open?: boolean;
+  defaultOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  children?: React.ReactNode;
+}
+
+// Platform-agnostic props for Dialog content area.
+export interface DialogContentBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  title?: string;
+  description?: string;
+}
+
+// Dialog exports the same sub-components on both platforms.
+export type DialogSubComponent =
+  | 'Dialog'
+  | 'DialogTrigger'
+  | 'DialogContent'
+  | 'DialogHeader'
+  | 'DialogTitle'
+  | 'DialogDescription'
+  | 'DialogFooter'
+  | 'DialogClose';

package/src/contracts/drawer.ts

@@ -0,0 +1,39 @@
+import * as React from 'react';
+
+export interface DrawerBaseProps {
+  children?: React.ReactNode;
+  shouldScaleBackground?: boolean;
+}
+
+export interface DrawerTriggerBaseProps {
+  children: React.ReactNode;
+}
+
+export interface DrawerContentBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface DrawerHeaderBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface DrawerFooterBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface DrawerTitleBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface DrawerDescriptionBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface DrawerCloseBaseProps {
+  children?: React.ReactNode;
+}

package/src/contracts/dropdown-menu.ts

@@ -0,0 +1,87 @@
+import * as React from 'react';
+
+export interface DropdownMenuBaseProps {
+  children?: React.ReactNode;
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  modal?: boolean;
+}
+
+export interface DropdownMenuTriggerBaseProps {
+  children: React.ReactNode;
+  asChild?: boolean;
+}
+
+export interface DropdownMenuContentBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  side?: 'top' | 'right' | 'bottom' | 'left';
+  align?: 'start' | 'center' | 'end';
+  sideOffset?: number;
+  alignOffset?: number;
+}
+
+export interface DropdownMenuItemBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  inset?: boolean;
+  disabled?: boolean;
+  onSelect?: (event: Event) => void;
+}
+
+export interface DropdownMenuCheckboxItemBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  checked?: boolean | 'indeterminate';
+  onCheckedChange?: (checked: boolean) => void;
+  disabled?: boolean;
+}
+
+export interface DropdownMenuRadioItemBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  value: string;
+  disabled?: boolean;
+}
+
+export interface DropdownMenuLabelBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  inset?: boolean;
+}
+
+export interface DropdownMenuSeparatorBaseProps {
+  className?: string;
+}
+
+export interface DropdownMenuShortcutBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface DropdownMenuSubBaseProps {
+  children?: React.ReactNode;
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+}
+
+export interface DropdownMenuSubTriggerBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  inset?: boolean;
+}
+
+export interface DropdownMenuSubContentBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface DropdownMenuGroupBaseProps {
+  children?: React.ReactNode;
+}
+
+export interface DropdownMenuRadioGroupBaseProps {
+  children?: React.ReactNode;
+  value?: string;
+  onValueChange?: (value: string) => void;
+}

package/src/contracts/form.ts

@@ -0,0 +1,29 @@
+import * as React from 'react';
+
+export interface FormBaseProps {
+  children?: React.ReactNode;
+}
+
+export interface FormItemBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface FormLabelBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface FormControlBaseProps {
+  children?: React.ReactNode;
+}
+
+export interface FormDescriptionBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export interface FormMessageBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+}

package/src/contracts/hover-card.ts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+
+export interface HoverCardBaseProps {
+  children?: React.ReactNode;
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  openDelay?: number;
+  closeDelay?: number;
+}
+
+export interface HoverCardTriggerBaseProps {
+  children: React.ReactNode;
+  asChild?: boolean;
+}
+
+export interface HoverCardContentBaseProps {
+  className?: string;
+  children?: React.ReactNode;
+  align?: 'start' | 'center' | 'end';
+  sideOffset?: number;
+}

package/src/contracts/input.ts

@@ -0,0 +1,11 @@
+// Shared Input contracts.
+// Both ui-web and ui-native implementations must satisfy these types.
+
+// Platform-agnostic props shared by every Input implementation.
+// Avoids generic HTML props (value, defaultValue) that conflict with
+// platform-specific typings (React DOM vs React Native).
+export interface InputBaseProps {
+  placeholder?: string;
+  disabled?: boolean;
+  className?: string;
+}

package/src/contracts/label.ts

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