@myghf/ui 0.3.0 → 0.4.0

package/README.md

@@ -1,42 +1,35 @@
-# @myghf/ui
-
-[![npm version](https://img.shields.io/npm/v/@myghf/ui.svg)](https://www.npmjs.com/package/@myghf/ui)
-[![license](https://img.shields.io/npm/l/@myghf/ui.svg)](./LICENSE)
-
-The **Magdi Yacoub Global Heart Foundation (MYGHF)** shared Vue 3 design system — Tailwind-based,
-app-agnostic, accessible components for MYGHF / Aswan Heart Centre applications.
-
-- **Built on** [Vue 3](https://vuejs.org) + [Reka UI](https://reka-ui.com) primitives, styled with
-  [Tailwind CSS](https://tailwindcss.com).
-- **Brand-aligned** to the MYGHF palette, typography, and spacing (see [DESIGN.md](./DESIGN.md)).
-- **Bilingual-ready**: English and Arabic, with RTL support.
-- **Tree-shakeable** ESM output with bundled TypeScript types.
-- **Accessible**: keyboard-operable primitives, focus-visible states, and WCAG-minded contrast.
+<div align="center">
+  <img src="https://raw.githubusercontent.com/myghf/ui/main/docs/public/logo.png" alt="MYGHF heart logo" width="140" />
+  <h1>@myghf/ui</h1>
+  <p>The shared Vue 3 + Tailwind design system for the <strong>Magdi Yacoub Global Heart Foundation (MYGHF)</strong> and Aswan Heart Centre.</p>
+  <p>
+    <a href="https://www.npmjs.com/package/@myghf/ui"><img src="https://img.shields.io/npm/v/@myghf/ui.svg" alt="npm version" /></a>
+    <a href="./LICENSE"><img src="https://img.shields.io/npm/l/@myghf/ui.svg" alt="license" /></a>
+  </p>
+  <p><a href="https://ui.myfegypt.org"><strong>📖 Full documentation →</strong></a></p>
+</div>
 
 ## Requirements
 
 | Dependency | Version |
 | --- | --- |
-| `vue` | `^3.5.0` (peer) |
-| `tailwindcss` | `^3.4.0` (peer) |
+| [`vue`](https://vuejs.org) | `^3.5.0` (peer) |
+| [`tailwindcss`](https://tailwindcss.com) | `^3.4.0` (peer) |
 
-## Install
+## Installation
 
 ```bash
 npm install @myghf/ui
 ```
 
-## Setup
-
-Import the design tokens once, in your app entry stylesheet:
+Import the design tokens once in your app entry stylesheet:
 
 ```css
 /* app.css */
 @import '@myghf/ui/tokens.css';
 ```
 
-Then load the Tailwind preset and make sure your `content` globs include the library's output so its
-utility classes are generated:
+Then load the Tailwind preset and include the library's output in your `content` globs:
 
 ```js
 // tailwind.config.js
@@ -48,219 +41,30 @@ export default {
 }
 ```
 
-The preset provides the brand colour scale (`primary`, `secondary`, `success`, `warning`, `error`,
-`info`), semantic colours (`background`, `foreground`, `surface`, `surface-muted`, `border`,
-`muted`), and the font families (`font-sans`, `font-serif`, `font-ar`).
-
 ## Usage
 
-```ts
-import { Button, Input, DataTable } from '@myghf/ui'
-```
-
 ```vue
+<script setup>
+import { Button, Input } from '@myghf/ui'
+</script>
+
 <template>
   <form @submit.prevent="submit">
     <Input v-model="email" type="email" placeholder="you@example.com" />
-    <Button type="submit" variant="primary">Continue</Button>
+    <Button type="submit">Continue</Button>
   </form>
 </template>
 ```
 
-### Components
-
-| Area | Exports |
-| --- | --- |
-| Actions & display | `Button`, `Tag`, `Icon`, `ThemeToggle`, `Alert`, `Message` |
-| Feedback | `Toaster`, `useToast`, `createToastStore` |
-| Form controls | `Input`, `InputNumber`, `Textarea`, `Password`, `Checkbox`, `Select`, `SelectButton`, `DatePicker`, `TreeSelect` |
-| Navigation & overlays | `Tabs`, `TabsList`, `TabsTrigger`, `TabsContent`, `Dialog`, `Drawer`, `DropdownMenu`, `DropdownMenuTrigger`, `DropdownMenuContent`, `DropdownMenuItem` |
-| Data | `Table`, `TableHeader`, `TableBody`, `TableRow`, `TableHead`, `TableCell`, `TableEmpty`, `TablePagination`, `DataTable`, `TreeTable`, `TransferList` |
-| Utilities & types | `cn`, date and locale helpers, `toNumberOrNull`, `mergeFormatOptions`, `toPascalCase`, `resolveIconName`, `toneClasses`, `useTheme`, `createTheme`, `toastKey`, `TagTone`, `Tone`, `AlertVariant`, `DatePickerLabels`, `DrawerPosition`, `DrawerSize`, `ThemeMode`, `ToastSeverity`, `ToastPosition`, `DataTableFeatures`, `TreeTableColumn`, `TreeNode`, `FlatTreeRow`, `CheckedState` |
-
-### Component examples
-
-**Toasts** — mount one `<Toaster>` near the root and call `useToast()` from a descendant setup:
-
-```vue
-<!-- App.vue -->
-<template>
-  <Toaster position="top-end" :max="4" />
-  <SaveButton />
-</template>
-```
-
-```vue
-<!-- SaveButton.vue -->
-<script setup lang="ts">
-import { useToast } from '@myghf/ui'
-
-const toast = useToast() // setup-only; requires an ancestor <Toaster />
-toast.success('Saved', 'Your changes were saved.')
-toast.add({ title: 'Uploading…', severity: 'info', duration: 0 }) // 0 = persistent
-</script>
-```
-
-`useToast()` throws unless a `<Toaster>` is mounted above the calling component. Positions are
-logical (`top-start`…`bottom-end`, default `top-end`); severities are `info`, `success`, `warning`,
-`danger`, `secondary`. For tests or a pre-seeded queue, build a store with `createToastStore()` and
-pass it via `<Toaster :store="store">`.
-
-**Alert / Message** — the same component under two names, sharing Tag's tones:
-
-```vue
-<Alert tone="success" title="Payment received" description="Receipt sent by email." show-icon />
-<Message tone="danger" variant="outline" closable @close="dismissed = true">Something failed.</Message>
-```
-
-Tones: `info` (default), `success`, `warning`, `danger`, `secondary`; `variant` is `soft` (default)
-or `outline`. Pass `duration` (ms) to auto-dismiss, pausable on hover/focus; `0`/omitted is
-persistent.
-
-**InputNumber** — numeric `v-model` that emits `number | null`:
-
-```vue
-<InputNumber v-model="amount" :min="0" :max="100" :step="5" integer show-buttons />
-<InputNumber v-model="price" currency="USD" locale="en-US" prefix="$" />
-```
-
-Empty input emits `null`. Supports `min`/`max`/`step`/`stepSnapping`/`integer`, `locale`,
-`formatOptions`/`currency`, `prefix`/`suffix`, `showButtons`, and `size`; reka's input renders
-`role="spinbutton"` with `aria-roledescription`, `aria-valuenow`, `aria-valuemin`, and `aria-valuemax`
-(via the underlying `NumberFieldInput`).
-
-**Drawer** — controlled via `v-model:open`:
-
-```vue
-<Drawer v-model:open="open" position="end" size="md" title="Filters">
-  <p>Drawer body</p>
-  <template #footer><Button @click="open = false">Done</Button></template>
-</Drawer>
-```
-
-Positions: `left`, `right` (default), `top`, `bottom`, plus logical `start`/`end` that mirror them
-and flip in RTL. Sizes: `sm`, `md`, `lg`, `full`. Also supports `backdrop`, `closeOnEscape`,
-`closeOnOutside`, `showClose`, and `preventScroll`.
-
-> **Drawer caveat:** `preventScroll: false` only takes effect with `backdrop: false`; when a
-> backdrop is shown, reka's overlay owns the body scroll lock.
-
-**DatePicker i18n/time** — `DatePicker` accepts `hourFormat` (`'12' | '24'`, default `'24'`),
-`minuteStep` (default `1`), `locale` (BCP-47, default runtime locale), `labels` (partial overrides
-for `placeholder`, `previousMonth`, `nextMonth`, `clear`, `apply`, `today`, `time`, `hour`,
-`minute`, `am`, `pm`), `weekStartsOn`, and `defaultOpen`. Month and weekday headers and the display
-text are locale-formatted, and the nav chevrons flip in RTL. Override individual labels with
-`label-<key>` slots.
-
-### Entry points
-
-| Import | Contents |
-| --- | --- |
-| `@myghf/ui` | Components, utilities, and types |
-| `@myghf/ui/tokens.css` | CSS custom properties (`--myghf-*`) |
-| `@myghf/ui/tailwind-preset` | Tailwind preset |
-
-## Theming
-
-Tokens are space-separated RGB channels so Tailwind's `<alpha-value>` opacity modifiers keep working.
-Override any `--myghf-*` variable after importing `tokens.css`:
-
-```css
-:root {
-  --myghf-primary-500: 0 130 177; /* custom brand blue */
-  --myghf-background: 255 255 255; /* brand-white page background */
-}
-```
-
-Do not hard-code hex values in component code — use the tokens or the Tailwind classes. See
-[DESIGN.md](./DESIGN.md) for the full palette and rules.
-
-### Dark mode
-
-The preset sets `darkMode: ['class', '.dark']`, and importing `@myghf/ui/tokens.css` ships a dark
-token block under both `[data-theme='dark']` and `.dark`. It overrides **only** the six semantic
-variables; the brand colour scales are unchanged, so your own `--myghf-*` overrides still apply in
-dark mode:
-
-```css
-/* shipped by tokens.css */
-[data-theme='dark'],
-.dark {
-  color-scheme: dark;
-  --myghf-background: 15 18 23;
-  --myghf-foreground: 243 244 246;
-  --myghf-surface: 26 30 37;
-  --myghf-surface-muted: 39 44 53;
-  --myghf-border: 55 61 71;
-  --myghf-muted: 156 163 175;
-}
-```
-
-Use `useTheme()` — a shared singleton — or `createTheme()` for an independent controller:
-
-```ts
-import { useTheme } from '@myghf/ui'
-
-const { mode, resolved, isDark, setMode, toggle, enable, disable, reset } = useTheme()
-// defaults: storageKey 'myghf-theme', attribute 'both', defaultMode 'system'
-```
-
-```vue
-<ThemeToggle />
-```
-
-`useTheme` follows the OS preference when `mode` is `'system'`, persists explicit choices to
-`localStorage`, and writes **both** `.dark` and `data-theme="dark"` on `<html>` (`attribute: 'both'`).
-`createTheme()` accepts the same options and returns an isolated instance.
-
-> **Caveat:** Tailwind `dark:` utilities only activate under the `.dark` class. Setting
-> `data-theme="dark"` by hand drives the token block but **not** `dark:` utilities. `useTheme` sets
-> both so they always agree — if you apply the theme yourself, add `class="dark"` as well.
-
-## Bilingual & RTL
-
-Wrap RTL content with `dir="rtl"` and the Arabic font:
-
-```vue
-<div dir="rtl" class="font-ar">
-  <!-- Arabic content -->
-</div>
-```
-
-Prefer logical utilities (`ps-*`, `pe-*`, `ms-*`, `me-*`, `text-start`, `text-end`) over physical
-ones, and use the `rtl:` variant for directional icons.
-
-## Design system
-
-Brand rules, the colour/token reference, typography, and logo usage live in
-[DESIGN.md](./DESIGN.md). It is written for both developers and AI agents — follow it when building
-MYGHF UI.
-
-## Development
-
-```bash
-npm ci             # install from the lockfile
-npm run typecheck  # vue-tsc --noEmit
-npm test           # vitest run
-npm run build      # vite build + copy tokens/preset into dist/
-```
-
-Contributor and release conventions are documented in [AGENTS.md](./AGENTS.md).
-
-## Releasing
+## Documentation
 
-This package uses [Changesets](https://changesets.dev) for versioning and publishing, and ships
-from CI via npm Trusted Publishing (OIDC) — there is no `NPM_TOKEN`.
+Full guides, live component examples, API reference, theming, and RTL notes live at
+**[ui.myfegypt.org](https://ui.myfegypt.org)**.
 
-1. Add a changeset describing your change and commit it with your work:
-   ```bash
-   npx changeset
-   ```
-2. Open a pull request into `main` as usual.
-3. When it merges, CI opens (or updates) a **Version Packages** pull request that bumps `version`
-   and updates `CHANGELOG.md`.
-4. Merge that pull request to publish to npm. CI creates the git tag and GitHub Release
-   automatically, with provenance.
+- [Getting started](https://ui.myfegypt.org/guide/introduction)
+- [Components](https://ui.myfegypt.org/components/index)
+- [Theming & dark mode](https://ui.myfegypt.org/guide/theming)
+- [Brand rules (`DESIGN.md`)](./DESIGN.md)
 
 ## License
 

package/dist/components/avatar/Avatar.vue.d.ts

@@ -0,0 +1,12 @@
+type __VLS_Props = {
+    src?: string;
+    alt?: string;
+    name?: string;
+    initials?: string;
+    size?: 'sm' | 'default' | 'lg' | 'xl';
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: "sm" | "default" | "lg" | "xl";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=Avatar.vue.d.ts.map

package/dist/components/avatar/Avatar.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Avatar.vue.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/Avatar.vue"],"names":[],"mappings":"AAwFA,KAAK,WAAW,GAAG;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAAA;CACtC,CAAC;;UADO,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI;;AA+GzC,wBAOG"}

package/dist/components/button/Button.vue.d.ts

@@ -53,6 +53,12 @@ type __VLS_Props = {
     loading?: boolean;
     /** Text label; equivalent to slot content. PrimeVue parity for the app migration. */
     label?: string;
+    /** Leading icon name (lucide). Ignored while `loading` shows the spinner. */
+    icon?: string;
+    /** Trailing icon name (lucide); implies end placement. */
+    iconTrailing?: string;
+    /** Side the `icon` renders on. Defaults to `start`. */
+    iconPos?: 'start' | 'end';
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -69,6 +75,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
     variant: "secondary" | "default" | "destructive" | "outline" | "ghost";
     disabled: boolean;
     loading: boolean;
+    iconPos: "start" | "end";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLButtonElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

package/dist/components/button/Button.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.vue.d.ts","sourceRoot":"","sources":["../../../src/components/button/Button.vue"],"names":[],"mappings":"AAyDA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEzD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2ZAmBlB,CAAA;AAEF,KAAK,WAAW,GAAG;IACf,OAAO,CAAC,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC,SAAS,CAAC,CAAA;IACxD,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;IAClD,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAC;AAYJ,iBAAS,cAAc;WAqCT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAYD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;UAxEV,QAAQ,GAAG,QAAQ,GAAG,OAAO;;cACzB,OAAO;aACR,OAAO;2FA8EnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"Button.vue.d.ts","sourceRoot":"","sources":["../../../src/components/button/Button.vue"],"names":[],"mappings":"AA2EA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGzD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2ZAmBlB,CAAA;AAEF,KAAK,WAAW,GAAG;IACf,OAAO,CAAC,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC,SAAS,CAAC,CAAA;IACxD,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;IAClD,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;CAC1B,CAAC;AA0BJ,iBAAS,cAAc;WAoFT,OAAO,IAA6B;;yBAVpB,GAAG;;;;EAehC;AAaD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;UA5IV,QAAQ,GAAG,QAAQ,GAAG,OAAO;;cACzB,OAAO;aACR,OAAO;aAQP,OAAO,GAAG,KAAK;2FA0I3B,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/dropdown-menu/DropdownMenuGroup.vue.d.ts

@@ -0,0 +1,18 @@
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=DropdownMenuGroup.vue.d.ts.map

package/dist/components/dropdown-menu/DropdownMenuGroup.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DropdownMenuGroup.vue.d.ts","sourceRoot":"","sources":["../../../src/components/dropdown-menu/DropdownMenuGroup.vue"],"names":[],"mappings":"AAeA,iBAAS,cAAc;WA8BT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAQD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,+QAMnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAEpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/dropdown-menu/DropdownMenuItem.vue.d.ts

@@ -17,6 +17,8 @@ declare const itemVariants: import('tailwind-variants').TVReturnType<{
 }, undefined, "relative flex w-full cursor-pointer select-none items-center gap-2 rounded px-2 py-1.5 text-sm outline-none transition-colors focus:bg-surface-muted data-[highlighted]:bg-surface-muted data-[highlighted]:text-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50", unknown, unknown, undefined>>;
 type __VLS_Props = {
     variant?: VariantProps<typeof itemVariants>['variant'];
+    icon?: string;
+    disabled?: boolean;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -31,7 +33,9 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
     select: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onSelect?: (() => any) | undefined;
-}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+}>, {
+    disabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/dist/components/dropdown-menu/DropdownMenuItem.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DropdownMenuItem.vue.d.ts","sourceRoot":"","sources":["../../../src/components/dropdown-menu/DropdownMenuItem.vue"],"names":[],"mappings":"AA2BA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEzD,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;yUAShB,CAAA;AAEF,KAAK,WAAW,GAAG;IAAE,OAAO,CAAC,EAAE,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC,SAAS,CAAC,CAAA;CAAE,CAAC;AAO9E,iBAAS,cAAc;WAyCT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAYD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;kFAQnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"DropdownMenuItem.vue.d.ts","sourceRoot":"","sources":["../../../src/components/dropdown-menu/DropdownMenuItem.vue"],"names":[],"mappings":"AAyCA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGzD,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;yUAShB,CAAA;AAEF,KAAK,WAAW,GAAG;IACf,OAAO,CAAC,EAAE,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC,SAAS,CAAC,CAAA;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAC;AAgBJ,iBAAS,cAAc;WAuDT,OAAO,IAA6B;;yBAVpB,GAAG;;;;EAehC;AAcD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;cA5FN,OAAO;6EAqGpB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/dropdown-menu/DropdownMenuLabel.vue.d.ts

@@ -0,0 +1,18 @@
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=DropdownMenuLabel.vue.d.ts.map

package/dist/components/dropdown-menu/DropdownMenuLabel.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DropdownMenuLabel.vue.d.ts","sourceRoot":"","sources":["../../../src/components/dropdown-menu/DropdownMenuLabel.vue"],"names":[],"mappings":"AAeA,iBAAS,cAAc;WAiCT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAQD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,+QAMnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAEpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/dropdown-menu/DropdownMenuSeparator.vue.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+//# sourceMappingURL=DropdownMenuSeparator.vue.d.ts.map

package/dist/components/dropdown-menu/DropdownMenuSeparator.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DropdownMenuSeparator.vue.d.ts","sourceRoot":"","sources":["../../../src/components/dropdown-menu/DropdownMenuSeparator.vue"],"names":[],"mappings":";AAwDA,wBAMG"}

package/dist/components/form-field/FormDescription.vue.d.ts

@@ -0,0 +1,22 @@
+type __VLS_Props = {
+    /** The id of the element the description describes. */
+    id?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=FormDescription.vue.d.ts.map

package/dist/components/form-field/FormDescription.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormDescription.vue.d.ts","sourceRoot":"","sources":["../../../src/components/form-field/FormDescription.vue"],"names":[],"mappings":"AAcA,KAAK,WAAW,GAAG;IACjB,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAC;AAKF,iBAAS,cAAc;WA2BT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAQD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,kSAMnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/form-field/FormField.vue.d.ts

@@ -0,0 +1,37 @@
+type __VLS_Props = {
+    /** Label text; can also be supplied through the `label` slot. */
+    label?: string;
+    /** Description text; rendered below the control when present. */
+    description?: string;
+    /** Error text; marks the field invalid and renders an alert below the control. */
+    error?: string;
+    /** Marks the field required (adds the label marker and context flag). */
+    required?: boolean;
+    /** Overrides the invalid state. Defaults to `Boolean(error)`. */
+    invalid?: boolean;
+    /** Explicit control id. Defaults to a stable generated id. */
+    id?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        label?(_: {}): any;
+        default?(_: {}): any;
+        description?(_: {}): any;
+        error?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    invalid: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=FormField.vue.d.ts.map

package/dist/components/form-field/FormField.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormField.vue.d.ts","sourceRoot":"","sources":["../../../src/components/form-field/FormField.vue"],"names":[],"mappings":"AAqFA,KAAK,WAAW,GAAG;IACf,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAC;AA2CJ,iBAAS,cAAc;WAgFT,OAAO,IAA6B;;uBAbvB,GAAG;yBACD,GAAG;6BACE,GAAG;uBACT,GAAG;;;;EAe9B;AAcD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;aAlJP,OAAO;wFA0JnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/form-field/FormMessage.vue.d.ts

@@ -0,0 +1,22 @@
+type __VLS_Props = {
+    /** The id of the element the message describes. */
+    id?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=FormMessage.vue.d.ts.map

package/dist/components/form-field/FormMessage.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormMessage.vue.d.ts","sourceRoot":"","sources":["../../../src/components/form-field/FormMessage.vue"],"names":[],"mappings":"AAcA,KAAK,WAAW,GAAG;IACjB,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAC;AAKF,iBAAS,cAAc;WA4BT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAQD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,kSAMnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/input/Input.vue.d.ts

@@ -6,6 +6,11 @@ type __VLS_Props = {
     leadingIcon?: string;
     trailingIcon?: string;
     size?: 'sm' | 'default' | 'lg';
+    type?: string;
+    id?: string;
+    name?: string;
+    autocomplete?: string;
+    required?: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {
     focus: () => void | undefined;
@@ -15,6 +20,9 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
     size: "sm" | "default" | "lg";
+    type: string;
+    required: boolean;
+    invalid: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     inputRef: HTMLInputElement;
 }, HTMLDivElement>;

package/dist/components/input/Input.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Input.vue.d.ts","sourceRoot":"","sources":["../../../src/components/input/Input.vue"],"names":[],"mappings":"AAkDA,KAAK,WAAW,GAAG;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,CAAA;CAC/B,CAAC;;;;;;;;UADO,IAAI,GAAG,SAAS,GAAG,IAAI;;;;AAyGlC,wBAWG"}
+{"version":3,"file":"Input.vue.d.ts","sourceRoot":"","sources":["../../../src/components/input/Input.vue"],"names":[],"mappings":"AAwEA,KAAK,WAAW,GAAG;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAC;;;;;;;;UANO,IAAI,GAAG,SAAS,GAAG,IAAI;UACvB,MAAM;cAIF,OAAO;aARR,OAAO;;;;AAoIrB,wBAWG"}

package/dist/components/label/Label.vue.d.ts

@@ -0,0 +1,24 @@
+type __VLS_Props = {
+    /** The id of the control this label belongs to. Falls back to the field context. */
+    for?: string;
+    /** Renders an accessible-hidden required marker. */
+    required?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLLabelElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLLabelElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=Label.vue.d.ts.map

package/dist/components/label/Label.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Label.vue.d.ts","sourceRoot":"","sources":["../../../src/components/label/Label.vue"],"names":[],"mappings":"AA0BA,KAAK,WAAW,GAAG;IACjB,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAC;AAQF,iBAAS,cAAc;WA+BT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AASD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,+SAOnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/select/Select.vue.d.ts

@@ -10,6 +10,8 @@ type __VLS_Props = {
     multiple?: boolean;
     size?: 'sm' | 'default';
     invalid?: boolean;
+    id?: string;
+    required?: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: unknown) => any;
@@ -17,7 +19,9 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     "onUpdate:modelValue"?: ((value: unknown) => any) | undefined;
 }>, {
     size: "sm" | "default";
+    required: boolean;
     placeholder: string;
+    invalid: boolean;
     optionLabel: string;
     optionValue: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;

package/dist/components/select/Select.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Select.vue.d.ts","sourceRoot":"","sources":["../../../src/components/select/Select.vue"],"names":[],"mappings":"AAqIA,OAAO,EAQL,KAAK,eAAe,EACrB,MAAM,SAAS,CAAA;AAIhB,KAAK,WAAW,GAAG;IACf,UAAU,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAA;IAChD,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAC;;;;;;UAFO,IAAI,GAAG,SAAS;iBAJT,MAAM;iBAFN,MAAM;iBACN,MAAM;;AA2QxB,wBASG"}
+{"version":3,"file":"Select.vue.d.ts","sourceRoot":"","sources":["../../../src/components/select/Select.vue"],"names":[],"mappings":"AAoJA,OAAO,EAQL,KAAK,eAAe,EACrB,MAAM,SAAS,CAAA;AAKhB,KAAK,WAAW,GAAG;IACf,UAAU,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAA;IAChD,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAC;;;;;;UAJO,IAAI,GAAG,SAAS;cAGZ,OAAO;iBAPJ,MAAM;aAKV,OAAO;iBAPH,MAAM;iBACN,MAAM;;AAiSxB,wBASG"}