@toife/vue 3.1.3 → 3.1.4

package/src/components/radio/radio-group/radio-group.md

@@ -1,62 +0,0 @@
-# `<t-radio-group>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Radio group with shared `v-model`; provides variant/readonly/disabled/shadow to child `t-radio` via provide/inject.
-
-## Requirements / dependencies
-
-| Item  | Notes                                |
-| ----- | ------------------------------------ |
-| Vue   | ^3.5                                 |
-| Other | Wrap one or more `t-radio` children. |
-
-## Basic usage
-
-```vue
-<t-radio-group v-model="choice" direction="vertical">
-  <t-radio value="a">A</t-radio>
-  <t-radio value="b">B</t-radio>
-</t-radio-group>
-```
-
-## Props
-
-| Prop         | Type                         | Default      | Description                           |
-| ------------ | ---------------------------- | ------------ | ------------------------------------- |
-| `modelValue` | `string \| number`           | —            | Selected value (`v-model`).           |
-| `role`       | `string`                     | —            | Theme; default from app.              |
-| `variant`    | `RadioVariant`               | `"fill"`     | Default for radios unless overridden. |
-| `disabled`   | `boolean`                    | `false`      | Whole group.                          |
-| `readonly`   | `boolean`                    | `false`      |                                       |
-| `shadow`     | `boolean`                    | —            | Default from app.                     |
-| `direction`  | `"horizontal" \| "vertical"` | `"vertical"` | Flex layout.                          |
-
-**Type source:** `src/components/radio/radio-group/radio-group.type.ts`
-
-## Events (emits)
-
-| Event               | Payload            | Description                     |
-| ------------------- | ------------------ | ------------------------------- |
-| `update:modelValue` | `string \| number` | When a child radio is selected. |
-
-## Slots
-
-| Slot      | Description         |
-| --------- | ------------------- |
-| `default` | `t-radio` children. |
-
-## `v-model`
-
-`modelValue` / `update:modelValue`.
-
-## Provide / inject
-
-`RADIO_GROUP_PROVIDER_STATE_KEY`: `modelValue`, `role`, `variant`, `disabled`, `readonly`, `shadow`, `setValue`.
-
-## See also
-
-- Source: `src/components/radio/radio-group`
-- [radio.md](../radio/radio.md)

package/src/components/refresher/refresher.md

@@ -1,53 +0,0 @@
-# `<t-refresher>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Pull-to-refresh using `@toife/gesture` on the scroll container; two variants control when refresh fires (`max` vs `up`).
-
-## Requirements / dependencies
-
-| Item  | Notes             |
-| ----- | ----------------- |
-| Vue   | ^3.5              |
-| Other | `@toife/gesture`. |
-
-## Basic usage
-
-```vue
-<t-refresher variant="up" :threshold="120" @refresh="(done) => load().finally(done)">
-  <template #icon="{ offset, refreshing }">…</template>
-  <div class="scroll-area">…</div>
-</t-refresher>
-```
-
-## Props
-
-| Prop        | Type            | Default | Description                                                                              |
-| ----------- | --------------- | ------- | ---------------------------------------------------------------------------------------- |
-| `threshold` | `number`        | `120`   | Pull threshold (px) depending on `variant`.                                              |
-| `variant`   | `"max" \| "up"` | `"max"` | `max`: fire during `move` when threshold reached; `up`: fire on `up` when threshold met. |
-| `offset`    | `number`        | —       | Override displayed offset (default `moveOffset / 2`).                                    |
-
-**Type source:** `src/components/refresher/refresher.type.ts`
-
-## Events (emits)
-
-| Event     | Payload             | Description                                       |
-| --------- | ------------------- | ------------------------------------------------- |
-| `refresh` | `close: () => void` | Call `close()` when refresh finishes to reset UI. |
-| `move`    | `offset: number`    | While pulling.                                    |
-| `cancel`  | —                   | Pull cancelled.                                   |
-| `start`   | —                   | Gesture started.                                  |
-
-## Slots
-
-| Slot      | Slot props               | Description                               |
-| --------- | ------------------------ | ----------------------------------------- |
-| `icon`    | `{ offset, refreshing }` | Indicator above the scroll area.          |
-| `default` | —                        | Scroll region (internal ref for gesture). |
-
-## See also
-
-- Source: `src/components/refresher`

package/src/components/route/route-navigator/route-navigator.md

@@ -1,50 +0,0 @@
-# `<t-route-navigator>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Displays a stack of screens with transitions and optional edge swipe to `router.back()` when `variant="swipe"`. Listens to `stack` from `RouteProvider`.
-
-## Requirements / dependencies
-
-| Item         | Notes                                                                    |
-| ------------ | ------------------------------------------------------------------------ |
-| Vue          | ^3.5                                                                     |
-| `vue-router` | **Required**                                                             |
-| Other        | `@toife/gesture`; `RouteProvider` ancestor (usually via `RouteWrapper`). |
-
-## Basic usage
-
-```vue
-<t-route-wrapper>
-  <t-route-navigator variant="swipe" direction="right" />
-</t-route-wrapper>
-```
-
-## Props
-
-| Prop        | Type                | Default   | Description                               |
-| ----------- | ------------------- | --------- | ----------------------------------------- |
-| `direction` | `"left" \| "right"` | `"right"` | Gesture / animation direction.            |
-| `variant`   | `"none" \| "swipe"` | `"none"`  | Enables swipe navigation when not `none`. |
-| `keepalive` | `boolean`           | `false`   | Reserved for stack/DOM retention.         |
-
-**Type source:** `src/components/route/route-navigator/route-navigator.type.ts`
-
-## Events (emits)
-
-_None._
-
-## Slots
-
-_None_ — fixed structure: stack loop → `RouteProvider` + `RouteOutlet`.
-
-## Special behavior
-
-- Swipe along `direction`: preview transform; release past ~60% width → `goBack()`.
-- `fast` swipe calls `router.back()`.
-
-## See also
-
-- Source: `src/components/route/route-navigator`

package/src/components/route/route-outlet/route-outlet.md

@@ -1,30 +0,0 @@
-# `<t-route-outlet>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Resolves and renders a route component (sync or async dynamic import).
-
-## Requirements / dependencies
-
-| Item  | Notes                                                         |
-| ----- | ------------------------------------------------------------- |
-| Vue   | ^3.5                                                          |
-| Other | Used inside `RouteNavigator` with `component` from the stack. |
-
-## Props
-
-| Prop        | Type      | Description                                                |
-| ----------- | --------- | ---------------------------------------------------------- |
-| `component` | `unknown` | Route component (may be `{ default: () => import(...) }`). |
-
-_(Inline type in `route-outlet.vue`.)_
-
-## Slots
-
-_None_ — renders `<component :is="…">`.
-
-## See also
-
-- Source: `src/components/route/route-outlet`

package/src/components/route/route-provider/route-provider.md

@@ -1,46 +0,0 @@
-# `<t-route-provider>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Provides `stack` (`RouteStack[]`) to `RouteNavigator` / children via inject.
-
-## Requirements / dependencies
-
-| Item  | Notes                                                  |
-| ----- | ------------------------------------------------------ |
-| Vue   | ^3.5                                                   |
-| Other | Usually created by `RouteWrapper` or `RouteNavigator`. |
-
-## Basic usage
-
-```vue
-<!-- Rarely used directly; RouteNavigator wraps children -->
-<t-route-provider :stack="myStack">
-  <slot />
-</t-route-provider>
-```
-
-## Props
-
-| Prop    | Type           | Description                        |
-| ------- | -------------- | ---------------------------------- |
-| `stack` | `RouteStack[]` | Route stack (see `route.type.ts`). |
-
-**Type source:** `src/components/route/route-provider/route-provider.type.ts`
-
-## Slots
-
-| Slot      | Description                           |
-| --------- | ------------------------------------- |
-| `default` | Children (often outlet or navigator). |
-
-## Provide / inject
-
-`ROUTE_PROVIDER_STATE_KEY` → `{ stack }` (computed).
-
-## See also
-
-- Source: `src/components/route/route-provider`
-- `src/components/route/route.type.ts`

package/src/components/route/route-wrapper/route-wrapper.md

@@ -1,45 +0,0 @@
-# `<t-route-wrapper>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Syncs the route stack with `vue-router` and wraps content in `RouteProvider` — main entry for stack-based navigation (with `RouteNavigator`).
-
-## Requirements / dependencies
-
-| Item         | Notes                                    |
-| ------------ | ---------------------------------------- |
-| Vue          | ^3.5                                     |
-| `vue-router` | **Required** — `useRoute` / `useRouter`. |
-
-## Basic usage
-
-```vue
-<t-route-wrapper home-route-name="home">
-  <t-route-navigator />
-</t-route-wrapper>
-```
-
-## Props
-
-| Prop            | Type     | Default  | Description                                    |
-| --------------- | -------- | -------- | ---------------------------------------------- |
-| `homeRouteName` | `string` | `"home"` | Name of the root route used to seed the stack. |
-
-**Type source:** `src/components/route/route-wrapper/route-wrapper.type.ts`
-
-## Slots
-
-| Slot      | Description                        |
-| --------- | ---------------------------------- |
-| `default` | Child tree (navigator, layout, …). |
-
-## Provide / inject
-
-Renders `RouteProvider` with `stack` from `useRouteWrapper`.
-
-## See also
-
-- Source: `src/components/route/route-wrapper`
-- [route-provider.md](../route-provider/route-provider.md), [route-navigator.md](../route-navigator/route-navigator.md)

package/src/components/segmented-field/segmented-field.md

@@ -1,58 +0,0 @@
-# `<t-segmented-field>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-OTP-style segmented input: each segment is a `t-field`; coordinates focus and `v-model` as a character array.
-
-## Requirements / dependencies
-
-| Item  | Notes                                    |
-| ----- | ---------------------------------------- |
-| Vue   | ^3.5                                     |
-| Other | `t-app` recommended; depends on `Field`. |
-
-## Basic usage
-
-```vue
-<t-segmented-field v-model="otp" :length="6" @complete="submit" />
-```
-
-## Props
-
-| Prop                    | Type       | Default                  | Description                                   |
-| ----------------------- | ---------- | ------------------------ | --------------------------------------------- |
-| `modelValue`            | `string[]` | —                        | Character array (`v-model`).                  |
-| `value`                 | `string[]` | —                        | May be used instead of `modelValue` when set. |
-| `length`                | `number`   | `6`                      | Number of segments.                           |
-| `variant` / `size`      | —          | Passed to inner `Field`. |
-| `disabled` / `readonly` | `boolean`  | `false`                  |                                               |
-| `type`                  | `string`   | `"text"`                 | Field input type.                             |
-| `role` / `shape`        | `string`   | —                        | Theme.                                        |
-| `shadow`                | `boolean`  | —                        | Default from app.                             |
-| `message` / `help`      | `string`   | `""`                     | Message / help.                               |
-| `pattern`               | `string[]` | `[]`                     | Reserved for per-cell validation.             |
-
-**Type source:** `src/components/segmented-field/segmented-field.type.ts`
-
-## Events (emits)
-
-| Event               | Payload      | Description                          |
-| ------------------- | ------------ | ------------------------------------ |
-| `update:modelValue` | `string[]`   | Value update.                        |
-| `complete`          | `string[]`   | When `length` characters are filled. |
-| `focus` / `blur`    | `FocusEvent` | From inner fields.                   |
-| `input`             | `string[]`   | On each change.                      |
-
-## Slots
-
-_None_ — layout is fixed with repeated `Field`.
-
-## `v-model`
-
-`modelValue` / `update:modelValue` (`string[]`).
-
-## See also
-
-- Source: `src/components/segmented-field`

package/src/components/skeleton/skeleton.md

@@ -1,47 +0,0 @@
-# `<t-skeleton>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Loading placeholder block with configurable size (CSS variables), themed from app.
-
-## Requirements / dependencies
-
-| Item  | Notes                         |
-| ----- | ----------------------------- |
-| Vue   | ^3.5                          |
-| Other | `t-app` for `role` / `shape`. |
-
-## Basic usage
-
-```vue
-<t-skeleton width="100%" height="12px" />
-```
-
-## Props
-
-| Prop     | Type               | Default  | Description          |
-| -------- | ------------------ | -------- | -------------------- |
-| `width`  | `string \| number` | `"100%"` | Width (number = px). |
-| `height` | `string \| number` | `"1rem"` | Height.              |
-| `role`   | `string`           | —        | Theme.               |
-| `shape`  | `string`           | —        | Shape.               |
-
-**Type source:** `src/components/skeleton/skeleton.type.ts`
-
-## Events (emits)
-
-_None._
-
-## Slots
-
-_None._
-
-## Style / class notes
-
-Variables `--<prefix>-skeleton-width`, `--<prefix>-skeleton-height` via `property(["skeleton","width"])` / `height`.
-
-## See also
-
-- Source: `src/components/skeleton`

package/src/components/switch/switch.md

@@ -1,57 +0,0 @@
-# `<t-switch>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Boolean toggle with `v-model`, keyboard support, and basic ARIA.
-
-## Requirements / dependencies
-
-| Item  | Notes                |
-| ----- | -------------------- |
-| Vue   | ^3.5                 |
-| Other | `t-app` recommended. |
-
-## Basic usage
-
-```vue
-<t-switch v-model="on">Notifications</t-switch>
-```
-
-## Props
-
-| Prop         | Type      | Default | Description           |
-| ------------ | --------- | ------- | --------------------- |
-| `modelValue` | `boolean` | `false` | On state.             |
-| `role`       | `string`  | —       | Theme when on.        |
-| `shape`      | `string`  | —       | Shape.                |
-| `disabled`   | `boolean` | —       | _(optional in types)_ |
-| `readonly`   | `boolean` | `false` | Read-only.            |
-| `shadow`     | `boolean` | —       | Default from app.     |
-
-**Type source:** `src/components/switch/switch.type.ts`
-
-## Events (emits)
-
-| Event               | Payload   | Description   |
-| ------------------- | --------- | ------------- |
-| `update:modelValue` | `boolean` | Toggle state. |
-
-## Slots
-
-| Slot      | Description             |
-| --------- | ----------------------- |
-| `default` | Label beside the track. |
-
-## `v-model`
-
-`modelValue` / `update:modelValue`.
-
-## Accessibility (a11y)
-
-`role="switch"`, `aria-checked`, Space/Enter.
-
-## See also
-
-- Source: `src/components/switch`

package/src/components/tabs/tab/tab.md

@@ -1,52 +0,0 @@
-# `Tab`
-
-> **Not** registered by `createToife()` — `import { Tab, Tabs } from "@toife/vue"` (see package README).
-
-## Description
-
-One item in `t-tabs`: renders `<li>` + `t-button`; click calls the provider’s `setValue`.
-
-## Requirements / dependencies
-
-| Item  | Notes                    |
-| ----- | ------------------------ |
-| Vue   | ^3.5                     |
-| Other | Must be inside `t-tabs`. |
-
-## Basic usage
-
-```vue
-<script setup lang="ts">
-import { Tabs, Tab } from "@toife/vue";
-</script>
-<template>
-  <Tabs v-model="active">
-    <Tab value="1">One</Tab>
-    <Tab value="2" disabled>Two</Tab>
-  </Tabs>
-</template>
-```
-
-## Props
-
-| Prop       | Type      | Default | Description                           |
-| ---------- | --------- | ------- | ------------------------------------- |
-| `value`    | `string`  | —       | Tab id (matches `Tabs` `modelValue`). |
-| `disabled` | `boolean` | `false` | Disables selection.                   |
-
-**Type source:** `src/components/tabs/tab/tab.type.ts`
-
-## Events (emits)
-
-_None._
-
-## Slots
-
-| Slot      | Description                  |
-| --------- | ---------------------------- |
-| `default` | Tab label (inside `Button`). |
-
-## See also
-
-- Source: `src/components/tabs/tab`
-- [tabs.md](../tabs/tabs.md)

package/src/components/tabs/tabs/tabs.md

@@ -1,59 +0,0 @@
-# `<t-tabs>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Tab bar: `modelValue` is the active `Tab`’s `value`; underline/highlight position is measured from the DOM (`getBoundingClientRect`). Provides state to child `Tab` components.
-
-## Requirements / dependencies
-
-| Item  | Notes                                                                  |
-| ----- | ---------------------------------------------------------------------- |
-| Vue   | ^3.5                                                                   |
-| Other | Children should be `Tab` (named export) — see [tab.md](../tab/tab.md). |
-
-## Basic usage
-
-```vue
-<t-tabs v-model="tab" variant="underline" placement="top-start">
-  <Tab value="a">Tab A</Tab>
-  <Tab value="b">Tab B</Tab>
-</t-tabs>
-```
-
-## Props
-
-| Prop             | Type            | Default       | Description                          |
-| ---------------- | --------------- | ------------- | ------------------------------------ |
-| `modelValue`     | `string`        | `""`          | Active tab value (`v-model`).        |
-| `placement`      | `TabsPlacement` | `"top-start"` | Bar placement + highlight direction. |
-| `variant`        | `TabsVariant`   | —             | `fill` \| `underline` \| `text`.     |
-| `role` / `shape` | `string`        | —             | Theme.                               |
-| `border`         | `number`        | `2`           | Underline thickness.                 |
-| `margin`         | `number[]`      | `[0, 0]`      | Margin around highlight.             |
-| `divider`        | `boolean`       | —             | Default from app.                    |
-| `transition`     | `boolean`       | `true`        | Animate highlight.                   |
-
-**Type source:** `src/components/tabs/tabs/tabs.type.ts`
-
-## Events (emits)
-
-| Event               | Payload  | Description |
-| ------------------- | -------- | ----------- |
-| `update:modelValue` | `string` | Tab change. |
-
-## Slots
-
-| Slot      | Description     |
-| --------- | --------------- |
-| `default` | `Tab` children. |
-
-## Provide / inject
-
-`TABS_PROVIDER_STATE_KEY`: `activeValue`, `role`, `shape`, `setValue`.
-
-## See also
-
-- Source: `src/components/tabs/tabs`
-- [tab.md](../tab/tab.md)

package/src/components/toast/toast/toast.md

@@ -1,56 +0,0 @@
-# `<t-toast>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Toast region for a given `placement`; messages come from the singleton `useToast()` store. `t-app` mounts several instances with different placements.
-
-## Requirements / dependencies
-
-| Item  | Notes                                                              |
-| ----- | ------------------------------------------------------------------ |
-| Vue   | ^3.5                                                               |
-| Other | Call `useToast().open()` anywhere to push messages (shared store). |
-
-## Basic usage
-
-```ts
-import { useToast } from "@toife/vue";
-
-const toast = useToast();
-toast.open({
-  message: "Saved",
-  placement: "bottom-center",
-  duration: 2000,
-});
-```
-
-```vue
-<!-- One region; placement must match `open` -->
-<t-toast placement="bottom-center" />
-```
-
-## Props
-
-| Prop        | Type             | Default        | Description                             |
-| ----------- | ---------------- | -------------- | --------------------------------------- |
-| `placement` | `ToastPlacement` | `"bottom-end"` | Only shows messages for this placement. |
-
-**Type source:** `src/components/toast/toast.type.ts`
-
-## Events (emits)
-
-_None._
-
-## Slots
-
-| Slot      | Description                               |
-| --------- | ----------------------------------------- |
-| `content` | Replaces the default `ToastContent` list. |
-
-## See also
-
-- Source: `src/components/toast/toast`
-- `toast.composable.ts` — `useToast`
-- [toast-content.md](../toast-content/toast-content.md)

package/src/components/toast/toast-content/toast-content.md

@@ -1,41 +0,0 @@
-# `<t-toast-content>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Single toast line: shows `message`, auto-dismisses after `duration`, emits `close` after the exit animation (usually handled by `t-toast` → `useToast().close(id)`).
-
-## Requirements / dependencies
-
-| Item  | Notes                                                          |
-| ----- | -------------------------------------------------------------- |
-| Vue   | ^3.5                                                           |
-| Other | `t-app` for theme; usually rendered by `t-toast` in a `v-for`. |
-
-## Props
-
-| Prop             | Type                  | Default  | Description                       |
-| ---------------- | --------------------- | -------- | --------------------------------- |
-| `id`             | `number`              | —        | Message id (`useToast` store).    |
-| `message`        | `string`              | `""`     | Text.                             |
-| `duration`       | `number`              | `2000`   | ms before close animation starts. |
-| `role` / `shape` | `string`              | —        | Theme.                            |
-| `variant`        | `ToastContentVariant` | `"fill"` | `fill` \| `text`.                 |
-| `placement`      | `ToastPlacement`      | —        | Set when pushing to the store.    |
-
-**Type source:** `src/components/toast/toast.type.ts`
-
-## Events (emits)
-
-| Event   | Payload | Description                      |
-| ------- | ------- | -------------------------------- |
-| `close` | —       | After delay + closing animation. |
-
-## Slots
-
-_None_ — single text `div`.
-
-## See also
-
-- Source: `src/components/toast/toast-content`