tera-system-ui 0.1.63 → 0.1.66

package/dist/llms/dropdown-menu.md

@@ -0,0 +1,112 @@
+# DropdownMenu
+
+Contextual menu. Parts: DropdownMenu, DropdownMenuItem, DropdownMenuGroup, DropdownMenuHeader, DropdownMenuSeparator.
+
+Parts: DropdownMenu, DropdownMenuItem, DropdownMenuGroup, DropdownMenuHeader, DropdownMenuSeparator. Built on BitsUI DropdownMenu primitive.
+
+## Import
+
+  import { DropdownMenu, DropdownMenuItem, DropdownMenuGroup, DropdownMenuHeader, DropdownMenuSeparator } from 'tera-system-ui';
+  import { DropdownMenu } from 'tera-system-ui/dropdown-menu';  // subpath
+
+## DropdownMenu
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  children                  Snippet                                 optional  
+  trigger                   Snippet                                 optional  Snippet used as the clickable trigger that opens the menu.
+  class                     string                                  optional  Additional CSS classes for the menu content panel.
+  open                      boolean                                 optional  Whether the menu is open. Bindable.
+  side                      'top' | 'bottom' | 'left' | 'right'     optional  Which side of the trigger the menu appears on.
+  align                     'start' | 'center' | 'end'              optional  Alignment of the menu relative to the trigger.
+  sideOffset                number                                  optional  Distance in pixels between the trigger and menu panel.
+  loop                      boolean                                 optional  Whether keyboard navigation wraps from the last item back to the first.
+  preventScroll             boolean                                 optional  Prevent the page from scrolling while the menu is open.
+  ref                       HTMLElement                             optional  Bindable reference to the menu content element.
+
+### Usage
+
+  <script>
+    import { DropdownMenu } from 'tera-system-ui';
+  </script>
+
+  <DropdownMenu>Content</DropdownMenu>
+
+## DropdownMenuItem
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  children                  Snippet                                 optional  
+  class                     string                                  optional  Additional CSS classes for the item.
+  danger                    boolean                                 optional  Renders the item in a destructive/danger visual style.
+  disabled                  boolean                                 optional  Prevents selecting this item.
+  href                      string                                  optional  When set, renders the item as an anchor link instead of a button.
+  onclick                   (e: MouseEvent) => void                 optional  Called when the item is clicked.
+  closeOnSelect             boolean                                 optional  Whether selecting this item closes the menu. Defaults to true.
+  textValue                 string                                  optional  Alternative text value for typeahead matching — defaults to the item's text content.
+  ref                       HTMLElement                             optional  Bindable reference to the item element.
+
+### Usage
+
+  <script>
+    import { DropdownMenuItem } from 'tera-system-ui';
+  </script>
+
+  <DropdownMenuItem>Content</DropdownMenuItem>
+
+## DropdownMenuGroup
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  children                  Snippet                                 optional  
+  class                     string                                  optional  Additional CSS classes for the group wrapper.
+  ref                       HTMLElement                             optional  (bindable)
+
+### Usage
+
+  <script>
+    import { DropdownMenuGroup } from 'tera-system-ui';
+  </script>
+
+  <DropdownMenuGroup>Content</DropdownMenuGroup>
+
+## DropdownMenuHeader
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  children                  Snippet                                 optional  
+  class                     string                                  optional  Additional CSS classes for the header.
+  ref                       HTMLElement                             optional  (bindable)
+
+### Usage
+
+  <script>
+    import { DropdownMenuHeader } from 'tera-system-ui';
+  </script>
+
+  <DropdownMenuHeader>Content</DropdownMenuHeader>
+
+## DropdownMenuSeparator
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  class                     string                                  optional  Additional CSS classes for the separator line.
+  ref                       HTMLElement                             optional  (bindable)
+
+### Usage
+
+  <script>
+    import { DropdownMenuSeparator } from 'tera-system-ui';
+  </script>
+
+  <DropdownMenuSeparator />

package/dist/llms/fonts.md

@@ -0,0 +1,7 @@
+# fonts
+
+Font loader components: TeraFontMono, TeraFontSansSerif.
+
+## Import
+
+  import {  } from 'tera-system-ui';

package/dist/llms/header.md

@@ -0,0 +1,26 @@
+# Header
+
+Application header / navigation bar.
+
+## Import
+
+  import { Header } from 'tera-system-ui';
+  import { Header } from 'tera-system-ui/header';  // subpath
+
+## Header
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  children                  Snippet                                 optional  
+  onHamburgerClick          () => void                              optional  
+  ref                       HTMLElement                             optional  (bindable)
+
+### Usage
+
+  <script>
+    import { Header } from 'tera-system-ui';
+  </script>
+
+  <Header>Content</Header>

package/dist/llms/icons.md

@@ -0,0 +1,43 @@
+# Icons
+
+Icon components wrapping @tabler/icons-svelte with consistent sizing.
+
+## Import
+
+  import { IconSearch, IconX, IconCheck } from 'tera-system-ui';
+  import { IconSearch } from 'tera-system-ui/icons';  // subpath
+
+## Available Icons
+
+  IconArrowBigRightFilled
+  IconBook
+  IconBookmarkPlus
+  IconCalculator
+  IconCheck
+  IconChevronDown
+  IconCoin
+  IconCoinConvert
+  IconCopy
+  IconCopyCheckFilled
+  IconHamburger
+  IconLanguage
+  IconLoader2
+  IconLogout
+  IconMoon
+  IconPointFilled
+  IconSearch
+  IconSettings
+  IconSun
+  IconSwitchHorizontal
+  IconSwitchVertical
+  IconTransform
+  IconX
+
+## Usage
+
+  <script>
+    import { IconSearch, IconX } from 'tera-system-ui';
+  </script>
+
+  <IconSearch />
+  <IconX class="size-4 text-error-default" />

package/dist/llms/index.md

@@ -0,0 +1,65 @@
+# tera-system-ui
+
+> Svelte 5 component library with multi-theme support and design tokens.
+
+## Installation
+
+  npm install tera-system-ui
+
+## Setup
+
+  // Add base theme CSS once in your app entry
+  import 'tera-system-ui/themes/tera-ui-base';
+
+  // Wrap your app in the context provider
+  import { TeraUiContext } from 'tera-system-ui';
+
+## Basic Usage
+
+  import { Button, Input, Card } from 'tera-system-ui';
+
+## Component Guides
+
+Each path below is relative to this file (dist/llms/index.md).
+Read a component file for its props, variants, and usage examples.
+
+  Colors                         ./colors.md
+  Accordion                      ./accordion.md
+  Ai                             ./ai.md
+  Alert                          ./alert.md
+  Avatar                         ./avatar.md
+  Badge                          ./badge.md
+  BrandLogo                      ./brand-logo.md
+  Button                         ./button.md
+  Card                           ./card.md
+  Checkbox                       ./checkbox.md
+  DateRangePicker                ./date-range-picker.md
+  Combobox                       ./combobox.md
+  Command                        ./command.md
+  Dialog                         ./dialog.md
+  Drawer                         ./drawer.md
+  DropdownMenu                   ./dropdown-menu.md
+  Fonts                          ./fonts.md
+  Header                         ./header.md
+  Icons                          ./icons.md
+  Input                          ./input.md
+  Label                          ./label.md
+  LanguagePickerButton           ./language-picker-button.md
+  LightDarkToggle                ./light-dark-toggle.md
+  Marketing                      ./marketing.md
+  Popover                        ./popover.md
+  PopoverResponsive              ./popover-responsive.md
+  Select                         ./select.md
+  SideNavigation                 ./side-navigation.md
+  Skeleton                       ./skeleton.md
+  Slider                         ./slider.md
+  Spinner                        ./spinner.md
+  StarRating                     ./star-rating.md
+  Switch                         ./switch.md
+  Table                          ./table.md
+  Tabs                           ./tabs.md
+  TeraUiContext                  ./tera-ui-context.md
+  TextArea                       ./text-area.md
+  Toast                          ./toast.md
+  Tooltip                        ./tooltip.md
+  UserAvatarWithMenu             ./user-avatar-with-menu.md

package/dist/llms/input.md

@@ -0,0 +1,37 @@
+# Input
+
+Text input with prefix/suffix snippet slots, clear button, and status variants.
+
+## Import
+
+  import { Input } from 'tera-system-ui';
+  import { Input } from 'tera-system-ui/input';  // subpath
+
+## Input
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  variant                   outlined | filled | borderless          optional  (default: outlined)
+  disabled                  boolean                                 optional  
+  size                      sm | md | lg                            optional  (default: md)
+  status                    error | warning                         optional  
+  children                  Snippet                                 optional  
+  class                     string                                  optional  
+  value                     string                                  optional  
+  ref                       HTMLInputElement                        optional  (bindable)
+  prefix                    Snippet                                 optional  
+  suffix                    Snippet                                 optional  
+  allowClear                boolean                                 optional  
+
+### Usage
+
+  <script>
+    import { Input } from 'tera-system-ui';
+  </script>
+
+  <Input>Content</Input>
+  <Input variant="filled">Content</Input>
+  <Input disabled>Content</Input>
+  <Input size="sm">Content</Input>

package/dist/llms/label.md

@@ -0,0 +1,30 @@
+# Label
+
+Accessible form label.
+
+## Import
+
+  import { Label } from 'tera-system-ui';
+  import { Label } from 'tera-system-ui/label';  // subpath
+
+## Label
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  size                      sm | md | lg                            optional  (default: md)
+  required                  boolean                                 optional  
+  children                  Snippet                                 optional  
+  class                     string                                  optional  
+  ref                       HTMLLabelElement                        optional  (bindable)
+
+### Usage
+
+  <script>
+    import { Label } from 'tera-system-ui';
+  </script>
+
+  <Label>Content</Label>
+  <Label size="sm">Content</Label>
+  <Label required>Content</Label>

package/dist/llms/language-picker-button.md

@@ -0,0 +1,30 @@
+# LanguagePickerButton
+
+Language selection button for i18n switching.
+
+## Import
+
+  import { LanguagePickerButton } from 'tera-system-ui';
+  import { LanguagePickerButton } from 'tera-system-ui/language-picker-button';  // subpath
+
+## LanguagePickerButton
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  children                  Snippet                                 optional  
+  class                     string                                  optional  
+  language                  string                                  optional  
+  supportLanguages          string[]                                optional  
+  basePath                  string                                  optional  
+  open                      boolean                                 optional  
+  ref                       HTMLButtonElement                       optional  (bindable)
+
+### Usage
+
+  <script>
+    import { LanguagePickerButton } from 'tera-system-ui';
+  </script>
+
+  <LanguagePickerButton>Content</LanguagePickerButton>

package/dist/llms/light-dark-toggle.md

@@ -0,0 +1,26 @@
+# LightDarkToggle
+
+Toggle switch between light and dark theme.
+
+## Import
+
+  import { LightDarkToggle } from 'tera-system-ui';
+  import { LightDarkToggle } from 'tera-system-ui/light-dark-toggle';  // subpath
+
+## LightDarkToggle
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  children                  Snippet                                 optional  
+  class                     string                                  optional  
+  ref                       HTMLButtonElement                       optional  (bindable)
+
+### Usage
+
+  <script>
+    import { LightDarkToggle } from 'tera-system-ui';
+  </script>
+
+  <LightDarkToggle>Content</LightDarkToggle>

package/dist/llms/marketing.md

@@ -0,0 +1,95 @@
+# FeatureCard
+
+Marketing page blocks: FeatureCard, PricingCard, StatBlock, TestimonialCard.
+
+## Import
+
+  import { FeatureCard, PricingCard, StatBlock, TestimonialCard } from 'tera-system-ui';
+
+## FeatureCard
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  icon                      Snippet                                 optional  
+  title                     string                                  required  
+  description               string                                  optional  
+  variant                   FeatureVariant                          optional  
+  href                      string                                  optional  
+  class                     string                                  optional  
+
+### Usage
+
+  <script>
+    import { FeatureCard } from 'tera-system-ui';
+  </script>
+
+  <FeatureCard />
+
+## PricingCard
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  plan                      string                                  required  
+  price                     string                                  required  
+  period                    string                                  required  
+  description               string                                  required  
+  features                  string[]                                required  
+  cta                       string                                  required  
+  popular                   boolean                                 optional  
+  variant                   'default' | 'featured'                  optional  
+  onclick                   () => void                              optional  
+  class                     string                                  optional  
+
+### Usage
+
+  <script>
+    import { PricingCard } from 'tera-system-ui';
+  </script>
+
+  <PricingCard />
+
+## StatBlock
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  value                     string                                  required  
+  label                     string                                  required  
+  trend                     string                                  optional  
+  trendDirection            'up' | 'down' | 'neutral'               optional  
+  class                     string                                  optional  
+
+### Usage
+
+  <script>
+    import { StatBlock } from 'tera-system-ui';
+  </script>
+
+  <StatBlock />
+
+## TestimonialCard
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  quote                     string                                  required  
+  name                      string                                  required  
+  role                      string                                  required  
+  company                   string                                  optional  
+  avatarSrc                 string                                  optional  
+  rating                    number                                  optional  
+  class                     string                                  optional  
+
+### Usage
+
+  <script>
+    import { TestimonialCard } from 'tera-system-ui';
+  </script>
+
+  <TestimonialCard />

package/dist/llms/popover-responsive.md

@@ -0,0 +1,32 @@
+# PopoverResponsive
+
+Popover on desktop, drawer on mobile.
+
+Automatically switches at the 640 px breakpoint.
+
+## Import
+
+  import { PopoverResponsive } from 'tera-system-ui';
+  import { PopoverResponsive } from 'tera-system-ui/popover-responsive';  // subpath
+
+## PopoverResponsive
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  children                  Snippet                                 optional  Content rendered inside the popover/dialog panel.
+  trigger                   Snippet                                 optional  Snippet used as the clickable trigger.
+  class                     string                                  optional  Additional CSS classes for the content panel.
+  open                      boolean                                 optional  Whether the panel is open. Bindable.
+  side                      'top' | 'bottom' | 'left' | 'right'     optional  Which side of the trigger the desktop popover appears on.
+  sideOffset                number                                  optional  Distance in pixels between the trigger and popover (desktop only).
+  align                     'start' | 'center' | 'end'              optional  Alignment of the popover relative to the trigger (desktop only).
+
+### Usage
+
+  <script>
+    import { PopoverResponsive } from 'tera-system-ui';
+  </script>
+
+  <PopoverResponsive>Content</PopoverResponsive>

package/dist/llms/popover.md

@@ -0,0 +1,40 @@
+# Popover
+
+Floating popover panel anchored to a trigger element.
+
+Built on BitsUI Popover primitive with portal rendering.
+
+## Import
+
+  import { Popover } from 'tera-system-ui';
+  import { Popover } from 'tera-system-ui/popover';  // subpath
+
+## Popover
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  children                  Snippet                                 optional  
+  trigger                   Snippet                                 optional  Snippet used as the clickable trigger that opens the popover.
+  class                     string                                  optional  Additional CSS classes for the popover content panel.
+  open                      boolean                                 optional  Whether the popover is open. Bindable.
+  side                      'top' | 'bottom' | 'left' | 'right'     optional  Which side of the trigger the popover appears on.
+  sideOffset                number                                  optional  Distance in pixels between the trigger and popover panel.
+  align                     'start' | 'center' | 'end'              optional  Alignment of the popover relative to the trigger.
+  alignOffset               number                                  optional  Additional offset in pixels along the alignment axis.
+  closeOnClickOutside       boolean                                 optional  Whether clicking outside the popover closes it.
+  closeOnEscape             boolean                                 optional  Whether pressing Escape closes the popover. Defaults to true.
+  trapFocus                 boolean                                 optional  Whether focus is trapped inside the popover content while open.
+  preventScroll             boolean                                 optional  Prevent the page from scrolling while the popover is open.
+  onInteractOutside         () => void                              optional  Called when the user interacts outside the popover boundaries.
+  role                      string                                  optional  ARIA role for the popover content element.
+  ref                       HTMLElement                             optional  Bindable reference to the popover content element.
+
+### Usage
+
+  <script>
+    import { Popover } from 'tera-system-ui';
+  </script>
+
+  <Popover>Content</Popover>

package/dist/llms/select.md

@@ -0,0 +1,44 @@
+# Select
+
+Select dropdown with options array and keyboard navigation.
+
+Built on BitsUI Select primitive.
+
+## Import
+
+  import { Select } from 'tera-system-ui';
+  import { Select } from 'tera-system-ui/select';  // subpath
+
+## Select
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  variant                   outlined | filled | borderless          optional  (default: outlined)
+  size                      sm | md | lg                            optional  (default: md)
+  disabled                  boolean                                 optional  
+  status                    error | warning                         optional  
+  type                      'single' | 'multiple'                   optional  Selection mode. Use 'multiple' to allow picking several options.
+  options                   SelectOption[]                          optional  Flat list of options. Use `groups` instead for grouped options.
+  groups                    SelectGroup[]                           optional  Grouped options — renders labeled sections. Takes precedence over `options`.
+  value                     string | string[]                       optional  Currently selected value(s). Bindable. A string for type='single', a string[] for type='multiple'.
+  placeholder               string                                  optional  Text shown in the trigger when nothing is selected.
+  loop                      boolean                                 optional  Whether keyboard navigation wraps from the last item to the first.
+  allowDeselect             boolean                                 optional  Allow deselecting the current value by clicking it again (single mode only).
+  required                  boolean                                 optional  Whether the select is required for form submission.
+  name                      string                                  optional  Name attribute used when submitting within a form.
+  class                     string                                  optional  Additional CSS classes for the trigger button.
+  onchange                  (value: string | string[]) => void      optional  Called when the selected value changes.
+
+### Usage
+
+  <script>
+    import { Select } from 'tera-system-ui';
+  </script>
+
+  <Select />
+  <Select variant="filled" />
+  <Select size="sm" />
+  <Select disabled />
+  <Select onchange={(v) => console.log(v)} />

package/dist/llms/side-navigation.md

@@ -0,0 +1,30 @@
+# SideNavigation
+
+Sidebar navigation. Parts: SideNavigation, SideNavigationItem, SideNavigationLayout.
+
+## Import
+
+  import { SideNavigation } from 'tera-system-ui';
+  import { SideNavigation } from 'tera-system-ui/side-navigation';  // subpath
+
+## SideNavigation
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  children                  Snippet                                 optional  
+  class                     string                                  optional  
+  sideNavHref               string                                  optional  
+  language                  string                                  optional  
+  items                     SideNavigationItem[]                    optional  
+  bottomChildren            Snippet                                 optional  
+  ref                       HTMLElement                             optional  (bindable)
+
+### Usage
+
+  <script>
+    import { SideNavigation } from 'tera-system-ui';
+  </script>
+
+  <SideNavigation>Content</SideNavigation>

package/dist/llms/skeleton.md

@@ -0,0 +1,28 @@
+# Skeleton
+
+Loading skeleton placeholder for content areas.
+
+## Import
+
+  import { Skeleton } from 'tera-system-ui';
+
+## Skeleton
+
+### Props
+
+  Name                      Type                                    Required
+  ──────────────────────────────────────────────────────────────────────────
+  variant                   SkeletonVariant                         optional  
+  width                     string                                  optional  
+  height                    string                                  optional  
+  lines                     number                                  optional  
+  animate                   boolean                                 optional  
+  class                     string                                  optional  
+
+### Usage
+
+  <script>
+    import { Skeleton } from 'tera-system-ui';
+  </script>
+
+  <Skeleton />