@toife/vue 3.1.3 → 3.1.5

package/src/components/modal/modal.md

@@ -1,65 +0,0 @@
-# `<t-modal>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Modal content inside `Present`, integrated with `@toife/gesture` for swipe-to-dismiss along `placement` (except `center`). Optional fullscreen and gesture indicator.
-
-## Requirements / dependencies
-
-| Item  | Notes                                |
-| ----- | ------------------------------------ |
-| Vue   | ^3.5                                 |
-| Other | `@toife/gesture`; `t-app` for theme. |
-
-## Basic usage
-
-```vue
-<t-modal :visible="open" placement="bottom" @close="() => (open = false)">
-  <p>Content</p>
-</t-modal>
-```
-
-## Props
-
-| Prop              | Type                                   | Default     | Description                                  |
-| ----------------- | -------------------------------------- | ----------- | -------------------------------------------- |
-| `visible`         | `boolean`                              | `false`     | Visibility.                                  |
-| `placement`       | `PresentPlacement`                     | `"bottom"`  | Position + gesture direction.                |
-| `backdrop`        | `"display" \| "none" \| "transparent"` | `"display"` | Backdrop.                                    |
-| `keepalive`       | `boolean`                              | `true`      | Keep DOM when closed (`Present`).            |
-| `gesture`         | `boolean`                              | `true`      | Enable swipe to close.                       |
-| `fullscreen`      | `boolean`                              | `false`     | Full-screen panel.                           |
-| `indicator`       | `boolean`                              | `true`      | Show `GestureIndicator` (when not `center`). |
-| `duration`        | `number`                               | `200`       | `Present` transition (ms).                   |
-| `bounce`          | `number \| string`                     | `0`         | `Present` bounce.                            |
-| `role` / `shape`  | `string`                               | —           | Theme.                                       |
-| `class` / `style` | `unknown`                              | —           | Passed to `Present` / root.                  |
-
-**Type source:** `src/components/modal/modal.type.ts`
-
-## Events (emits)
-
-| Event   | Payload         | Description                                           |
-| ------- | --------------- | ----------------------------------------------------- |
-| `close` | `type?: string` | From `Present` or gesture (`backdrop`, `gesture`, …). |
-
-## Slots
-
-| Slot      | Description |
-| --------- | ----------- |
-| `default` | Modal body. |
-
-## Expose
-
-Nothing public (internal refs to `Present` / gesture).
-
-## Accessibility (a11y)
-
-Add focus trap / `aria-modal` at the app layer if you need strict WCAG compliance.
-
-## See also
-
-- Source: `src/components/modal`
-- [present.md](../../present/present.md)

package/src/components/page/page.md

@@ -1,39 +0,0 @@
-# `<t-page>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Simple page wrapper with the themed `page` class.
-
-## Requirements / dependencies
-
-| Item  | Notes |
-| ----- | ----- |
-| Vue   | ^3.5  |
-| Other | None. |
-
-## Basic usage
-
-```vue
-<t-app>
-  <t-page>
-    <t-toolbar />
-    <t-container>Content</t-container>
-  </t-page>
-</t-app>
-```
-
-## Props
-
-_None._
-
-## Slots
-
-| Slot      | Description     |
-| --------- | --------------- |
-| `default` | Page structure. |
-
-## See also
-
-- Source: `src/components/page`

package/src/components/present/present.md

@@ -1,60 +0,0 @@
-# `Present` _(named export; not in default `createToife`)_
-
-> **Not** registered by `createToife()` — import: `import { Present } from "@toife/vue"` and register globally yourself if needed.
-
-## Description
-
-Overlay layer: backdrop + animated panel, stacking z-index via `usePresent`. Used internally by `Modal`, `Action`, `DecisionModal`.
-
-## Requirements / dependencies
-
-| Item  | Notes |
-| ----- | ----- |
-| Vue   | ^3.5  |
-| Other | None. |
-
-## Basic usage
-
-```vue
-<Present :visible="show" placement="bottom" backdrop="display" @close="onClose">
-  <div>Content</div>
-</Present>
-```
-
-## Props
-
-| Prop              | Type                                   | Default     | Description                         |
-| ----------------- | -------------------------------------- | ----------- | ----------------------------------- |
-| `visible`         | `boolean`                              | `false`     | Open/close (with `duration` delay). |
-| `backdrop`        | `"display" \| "none" \| "transparent"` | `"display"` | Backdrop.                           |
-| `placement`       | `PresentPlacement`                     | `"bottom"`  | Animation direction.                |
-| `keepalive`       | `boolean`                              | `false`     | Keep DOM when closed.               |
-| `duration`        | `number`                               | `200`       | ms.                                 |
-| `bounce`          | `number \| string \| boolean`          | `false`     | Open bounce.                        |
-| `class` / `style` | `unknown`                              | —           | Panel.                              |
-
-**Type source:** `src/components/present/present.type.ts`
-
-## Events (emits)
-
-| Event   | Payload         | Description                                 |
-| ------- | --------------- | ------------------------------------------- |
-| `close` | `type?: string` | e.g. `'backdrop'` when backdrop is clicked. |
-
-## Slots
-
-| Slot      | Description    |
-| --------- | -------------- |
-| `default` | Panel content. |
-
-## Expose (template ref)
-
-| API                              | Description                                       |
-| -------------------------------- | ------------------------------------------------- |
-| `render(options: RenderOptions)` | Update transition styles (translate, opacity, …). |
-| `open()` / `close()`             | Manual animation control.                         |
-
-## See also
-
-- Source: `src/components/present`
-- `present.composable.ts` — `usePresent` (z-index stack)

package/src/components/radio/radio/radio.md

@@ -1,53 +0,0 @@
-# `<t-radio>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Single choice in a group — **must** be used inside `t-radio-group` so selection updates via inject.
-
-## Requirements / dependencies
-
-| Item  | Notes                            |
-| ----- | -------------------------------- |
-| Vue   | ^3.5                             |
-| Other | Parent `t-radio-group` required. |
-
-## Basic usage
-
-```vue
-<t-radio-group v-model="x">
-  <t-radio value="1">One</t-radio>
-</t-radio-group>
-```
-
-## Props
-
-| Prop       | Type               | Default      | Description               |
-| ---------- | ------------------ | ------------ | ------------------------- |
-| `value`    | `string \| number` | _(required)_ | Value when selected.      |
-| `role`     | `string`           | —            | Overrides group/app role. |
-| `variant`  | `RadioVariant`     | —            | Overrides group variant.  |
-| `disabled` | `boolean`          | `false`      | Or from group.            |
-| `readonly` | `boolean`          | `false`      | Or from group.            |
-| `shadow`   | `boolean`          | —            | Group/app default.        |
-
-**Type source:** `src/components/radio/radio/radio.type.ts`
-
-## Events (emits)
-
-_None_ — selection goes through the group’s `setValue`.
-
-## Slots
-
-| Slot      | Description |
-| --------- | ----------- |
-| `default` | Label.      |
-
-## Accessibility (a11y)
-
-`tabindex` 0/-1; Space/Enter selects. Consider `role="radiogroup"` on the container in your app if needed.
-
-## See also
-
-- Source: `src/components/radio/radio`

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`