@toife/vue 3.1.3 → 3.1.5

package/src/components/action/action.md

@@ -1,115 +0,0 @@
-# `<t-action>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Action sheet: groups of buttons rendered inside `Present`, typically for quick choices or secondary menus. Control via props or the `useAction()` composable wired by `t-app`.
-
-## Requirements / dependencies
-
-| Item  | Notes                                                                                     |
-| ----- | ----------------------------------------------------------------------------------------- |
-| Vue   | ^3.5                                                                                      |
-| Other | Prefer `t-app` for theme/context (`inject`). Depends on `Present`, `FormGroup`, `Button`. |
-
-## Basic usage
-
-```vue
-<template>
-  <t-action
-    :visible="show"
-    :actions="[[{ text: 'Confirm', variant: 'fill', handler: onOk }]]"
-    placement="bottom"
-    @close="show = false"
-    @choose="onChoose"
-  />
-</template>
-```
-
-Or open via `useAction()` (wired by `t-app`):
-
-```ts
-import { useAction } from "@toife/vue";
-
-const action = useAction();
-action.open({
-  actions: [[{ text: "OK", handler: () => {} }]],
-  onClose: () => {},
-  onChoose: (btn) => {},
-});
-```
-
-## Props
-
-| Prop        | Type                    | Default      | Description                                                    |
-| ----------- | ----------------------- | ------------ | -------------------------------------------------------------- |
-| `visible`   | `boolean`               | `false`      | Show the action layer.                                         |
-| `dismiss`   | `string[]`              | —            | `Present` close reasons that emit `close` (e.g. `'backdrop'`). |
-| `actions`   | `Array<ActionButton[]>` | _(required)_ | Rows of button groups; each row is an array of buttons.        |
-| `role`      | `string`                | —            | Theme role override; default from `t-app`.                     |
-| `shape`     | `string`                | —            | Shape override; default from `t-app`.                          |
-| `divider`   | `boolean`               | —            | Divider; default from `t-app`.                                 |
-| `shadow`    | `boolean`               | —            | Shadow; default from `t-app`.                                  |
-| `placement` | `PresentPlacement`      | `"bottom"`   | `Present` placement (`top`, `bottom`, …).                      |
-
-**Type source:** `src/components/action/action.type.ts`
-
-`ActionButton`: `text`, `role`, `variant`, `shadow`, `handler`, `data`.
-
-## Events (emits)
-
-| Event    | Payload             | Description                                               |
-| -------- | ------------------- | --------------------------------------------------------- |
-| `close`  | `type?: string`     | When `dismiss` matches the close reason.                  |
-| `choose` | `btn: ActionButton` | After a button is chosen (after that button’s `handler`). |
-
-## Slots
-
-| Slot   | Slot props | Description                                  |
-| ------ | ---------- | -------------------------------------------- |
-| `body` | —          | Replaces the default button layout entirely. |
-
-## `v-model`
-
-No `v-model` support.
-
-## Provide / inject / context
-
-Injects `APP_PROVIDER_STATE_KEY` from `t-app` for `divider`, `shadow`, `shape`, `role` when props are omitted.
-
-## Expose (template ref)
-
-Nothing exposed.
-
-## Special behavior
-
-- Backdrop close: if the payload is not in `dismiss`, a short `pop` animation runs instead of emitting `close`.
-
-## Accessibility (a11y)
-
-Inherits from `Present` (backdrop, focus). Buttons use inner `Button`.
-
-## Style / class notes
-
-BEM-style classes via `withPrefix`: `action`, `layer`, `surface`, `role`, `shape`, placement, `pop`, `divider`, `shadow`.
-
-## Advanced example
-
-```vue
-<t-action
-  :visible="open"
-  :dismiss="['backdrop']"
-  :actions="[
-    [{ text: 'Cancel', variant: 'text', handler: cancel }],
-    [{ text: 'Delete', variant: 'fill', role: 'danger', handler: remove }],
-  ]"
-  placement="bottom"
-  @close="(t) => console.log(t)"
-/>
-```
-
-## See also
-
-- Source: `src/components/action`
-- Composable: `action.composable.ts` (`useAction`)

package/src/components/app/app.md

@@ -1,77 +0,0 @@
-# `<t-app>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Library root layout: provides theme/context (`provide`) for descendants, mounts multiple `Toast` regions by placement, and hosts `Action` / `DecisionModal` when using `useAction` / `useDecisionModal`.
-
-## Requirements / dependencies
-
-| Item  | Notes                |
-| ----- | -------------------- |
-| Vue   | ^3.5                 |
-| Other | Router not required. |
-
-## Basic usage
-
-```vue
-<template>
-  <t-app>
-    <t-page>App content</t-page>
-  </t-app>
-</template>
-```
-
-## Props
-
-| Prop        | Type                | Default  | Description                                      |
-| ----------- | ------------------- | -------- | ------------------------------------------------ |
-| `shape`     | `string`            | `"pill"` | Default shape for children (buttons, fields, …). |
-| `divider`   | `boolean`           | `false`  | Default divider flag.                            |
-| `role`      | `string`            | `"mode"` | Default theme role.                              |
-| `shadow`    | `boolean`           | `false`  | Default shadow.                                  |
-| `triple`    | `boolean`           | `false`  | Layout flag (provided to children).              |
-| `direction` | `"left" \| "right"` | `"left"` | Direction (fields, …).                           |
-
-**Type source:** `src/components/app/app.type.ts`
-
-## Events (emits)
-
-_No public emits._
-
-## Slots
-
-| Slot      | Description                                           |
-| --------- | ----------------------------------------------------- |
-| `default` | Main app content.                                     |
-| `global`  | Extra slot (after default, before internal overlays). |
-
-## `v-model`
-
-No.
-
-## Provide / inject / context
-
-`provide(APP_PROVIDER_STATE_KEY)`: `{ shape, divider, role, shadow, triple, direction }` — children inject for consistent theming.
-
-## Expose
-
-Nothing.
-
-## Special behavior
-
-- Renders several `Toast` instances with fixed placements (top/bottom × start/center/end).
-- When `useAction()` / `useDecisionModal()` has `data`, renders the matching `Action` / `DecisionModal`.
-
-## Accessibility (a11y)
-
-Wrapper only; no special root role.
-
-## Style / class notes
-
-Classes: `layer`, `base`, `shape`, `app`.
-
-## See also
-
-- Source: `src/components/app`

package/src/components/avatar/avatar.md

@@ -1,64 +0,0 @@
-# `<t-avatar>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Displays an avatar image as a CSS `background-image` inside a themed frame (shape/role from app when omitted).
-
-## Requirements / dependencies
-
-| Item  | Notes                                             |
-| ----- | ------------------------------------------------- |
-| Vue   | ^3.5                                              |
-| Other | `t-app` recommended for default `role` / `shape`. |
-
-## Basic usage
-
-```vue
-<t-avatar src="/user.png" size="40px" />
-```
-
-## Props
-
-| Prop    | Type               | Default  | Description                           |
-| ------- | ------------------ | -------- | ------------------------------------- |
-| `shape` | `string`           | —        | Shape override; default from `t-app`. |
-| `size`  | `string \| number` | `"22px"` | Size (number is treated as px).       |
-| `src`   | `string`           | `""`     | Image URL for background.             |
-
-**Type source:** `src/components/avatar/avatar.type.ts`
-
-## Events (emits)
-
-_None._
-
-## Slots
-
-| Slot      | Description                    |
-| --------- | ------------------------------ |
-| `default` | Optional inner content (rare). |
-
-## `v-model`
-
-No.
-
-## Provide / inject
-
-Injects `AppProviderState` for `role` / `shape`.
-
-## Expose
-
-Nothing.
-
-## Accessibility (a11y)
-
-Decorative background image — add `aria-label` on a parent if a name must be announced.
-
-## Style / class notes
-
-CSS variable `--<prefix>-width` via `property("width")`.
-
-## See also
-
-- Source: `src/components/avatar`

package/src/components/button/button.md

@@ -1,66 +0,0 @@
-# `<t-button>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Button with variants, sizes, loading state, and theming from `t-app`.
-
-## Requirements / dependencies
-
-| Item  | Notes                                                |
-| ----- | ---------------------------------------------------- |
-| Vue   | ^3.5                                                 |
-| Other | `t-app` recommended for `shape` / `role` / `shadow`. |
-
-## Basic usage
-
-```vue
-<t-button variant="fill" @click="save">Save</t-button>
-<t-button loading>Loading</t-button>
-```
-
-## Props
-
-| Prop      | Type                               | Default      | Description                              |
-| --------- | ---------------------------------- | ------------ | ---------------------------------------- |
-| `role`    | `string`                           | —            | Theme role; default from app.            |
-| `size`    | `"small" \| "standard" \| "large"` | `"standard"` | Size.                                    |
-| `shape`   | `string`                           | —            | Shape; default from app.                 |
-| `block`   | `boolean`                          | `false`      | Full-width button.                       |
-| `loading` | `boolean`                          | `false`      | Hides label, shows `loading` slot.       |
-| `variant` | `ButtonVariant`                    | `"fill"`     | `fill` \| `outline` \| `text` \| `link`. |
-| `shadow`  | `boolean`                          | —            | Default from app if unset.               |
-
-**Type source:** `src/components/button/button.type.ts`
-
-## Events (emits)
-
-_No declared emits_ — use native DOM listeners (`@click`).
-
-## Slots
-
-| Slot      | Description                           |
-| --------- | ------------------------------------- |
-| `default` | Button label (hidden when `loading`). |
-| `loading` | Content when `loading`.               |
-
-## `v-model`
-
-No.
-
-## Provide / inject
-
-Injects theme from `t-app`.
-
-## Expose
-
-Nothing.
-
-## Accessibility (a11y)
-
-Native `<button>`; focus/blur styling handled internally.
-
-## See also
-
-- Source: `src/components/button`

package/src/components/cable/cable.md

@@ -1,57 +0,0 @@
-# `<t-cable>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Layout region for dock-style UI; provides `placement` to descendants (e.g. `Toolbar`) via inject.
-
-## Requirements / dependencies
-
-| Item  | Notes                                                |
-| ----- | ---------------------------------------------------- |
-| Vue   | ^3.5                                                 |
-| Other | Toolbar is often placed inside to inherit placement. |
-
-## Basic usage
-
-```vue
-<t-cable placement="bottom">
-  <t-toolbar><t-button>Home</t-button></t-toolbar>
-</t-cable>
-```
-
-## Props
-
-| Prop        | Type      | Default    | Description                             |
-| ----------- | --------- | ---------- | --------------------------------------- |
-| `keyboard`  | `boolean` | `false`    | Reserved for keyboard-related behavior. |
-| `placement` | `string`  | `"bottom"` | Cable placement (class on root).        |
-
-**Type source:** `src/components/cable/cable.type.ts`
-
-## Events (emits)
-
-_None._
-
-## Slots
-
-| Slot      | Description                    |
-| --------- | ------------------------------ |
-| `default` | Content (toolbar, buttons, …). |
-
-## Provide / inject
-
-`provide(CABLE_PROVIDER_STATE_KEY)`: `{ placement }` — `Toolbar` injects it for placement classes.
-
-## Expose
-
-Nothing.
-
-## Style / class notes
-
-Classes: `layer`, `base`, `cable`, plus placement.
-
-## See also
-
-- Source: `src/components/cable`

package/src/components/card/card/card.md

@@ -1,57 +0,0 @@
-# `<t-card>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Card surface with optional divider; provides context for `CardHeader` / `CardBody` / `CardFooter`.
-
-## Requirements / dependencies
-
-| Item  | Notes                |
-| ----- | -------------------- |
-| Vue   | ^3.5                 |
-| Other | `t-app` recommended. |
-
-## Basic usage
-
-```vue
-<t-card>
-  <t-card-header>Title</t-card-header>
-  <t-card-body>Content</t-card-body>
-  <t-card-footer>Footer</t-card-footer>
-</t-card>
-```
-
-## Props
-
-| Prop      | Type      | Default | Description                         |
-| --------- | --------- | ------- | ----------------------------------- |
-| `role`    | `string`  | —       | Default from app.                   |
-| `shape`   | `string`  | —       | Default from app.                   |
-| `divider` | `boolean` | —       | Section dividers; default from app. |
-
-**Type source:** `src/components/card/card/card.type.ts`
-
-## Events (emits)
-
-_None._
-
-## Slots
-
-| Slot      | Description       |
-| --------- | ----------------- |
-| `default` | Entire card body. |
-
-## Provide / inject
-
-`provide(CARD_PROVIDER_STATE_KEY)`: `{ role, shape, divider }` for header/footer.
-
-## Expose
-
-Nothing.
-
-## See also
-
-- Source: `src/components/card/card`
-- [card-header.md](../card-header/card-header.md), [card-body.md](../card-body/card-body.md), [card-footer.md](../card-footer/card-footer.md)

package/src/components/card/card-body/card-body.md

@@ -1,34 +0,0 @@
-# `<t-card-body>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Main content region of a card.
-
-## Requirements / dependencies
-
-| Item  | Notes                    |
-| ----- | ------------------------ |
-| Vue   | ^3.5                     |
-| Other | Usually inside `t-card`. |
-
-## Basic usage
-
-```vue
-<t-card-body>Main content</t-card-body>
-```
-
-## Props
-
-_None._
-
-## Slots
-
-| Slot      | Description |
-| --------- | ----------- |
-| `default` | Content.    |
-
-## See also
-
-- Source: `src/components/card/card-body`

package/src/components/card/card-footer/card-footer.md

@@ -1,42 +0,0 @@
-# `<t-card-footer>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Card footer region; divider follows `t-card` context.
-
-## Requirements / dependencies
-
-| Item  | Notes                                         |
-| ----- | --------------------------------------------- |
-| Vue   | ^3.5                                          |
-| Other | Should be inside `t-card` for correct inject. |
-
-## Basic usage
-
-```vue
-<t-card>
-  <t-card-footer>
-    <t-button>OK</t-button>
-  </t-card-footer>
-</t-card>
-```
-
-## Props
-
-_None._
-
-## Slots
-
-| Slot      | Description     |
-| --------- | --------------- |
-| `default` | Footer content. |
-
-## Provide / inject
-
-Injects `CardProviderState` from `t-card`.
-
-## See also
-
-- Source: `src/components/card/card-footer`

package/src/components/card/card-header/card-header.md

@@ -1,44 +0,0 @@
-# `<t-card-header>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Card header region; divider follows context from `t-card`.
-
-## Requirements / dependencies
-
-| Item  | Notes                                                        |
-| ----- | ------------------------------------------------------------ |
-| Vue   | ^3.5                                                         |
-| Other | Must be inside `t-card` (injects `CARD_PROVIDER_STATE_KEY`). |
-
-## Basic usage
-
-```vue
-<t-card>
-  <t-card-header>Title</t-card-header>
-</t-card>
-```
-
-## Props
-
-_No own props._
-
-## Events (emits)
-
-_None._
-
-## Slots
-
-| Slot      | Description     |
-| --------- | --------------- |
-| `default` | Header content. |
-
-## Provide / inject
-
-Injects `CardProviderState` from `t-card`.
-
-## See also
-
-- Source: `src/components/card/card-header`

package/src/components/checkbox/checkbox.md

@@ -1,60 +0,0 @@
-# `<t-checkbox>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Custom boolean checkbox (not a native `<input type="checkbox">`), with `v-model` and readonly/disabled states.
-
-## Requirements / dependencies
-
-| Item  | Notes                |
-| ----- | -------------------- |
-| Vue   | ^3.5                 |
-| Other | `t-app` recommended. |
-
-## Basic usage
-
-```vue
-<t-checkbox v-model="checked">I agree</t-checkbox>
-```
-
-## Props
-
-| Prop         | Type                  | Default  | Description              |
-| ------------ | --------------------- | -------- | ------------------------ |
-| `modelValue` | `boolean`             | `false`  | Value (`v-model`).       |
-| `role`       | `string`              | —        | Theme; default from app. |
-| `shape`      | `string`              | —        | Shape; default from app. |
-| `variant`    | `"fill" \| "outline"` | `"fill"` | Visual variant.          |
-| `readonly`   | `boolean`             | `false`  | Read-only.               |
-| `disabled`   | `boolean`             | `false`  | Disabled.                |
-| `shadow`     | `boolean`             | —        | Default from app.        |
-
-**Type source:** `src/components/checkbox/checkbox.type.ts`
-
-## Events (emits)
-
-| Event               | Payload   | Description                           |
-| ------------------- | --------- | ------------------------------------- |
-| `update:modelValue` | `boolean` | Updates `v-model`.                    |
-| `focus`             | —         | When focused (not disabled/readonly). |
-| `blur`              | —         | When blurred.                         |
-
-## Slots
-
-| Slot      | Description             |
-| --------- | ----------------------- |
-| `default` | Label next to the icon. |
-
-## `v-model`
-
-`modelValue` / `update:modelValue`.
-
-## Accessibility (a11y)
-
-`role="checkbox"`, `aria-checked`, `tabindex` 0 or -1; Space/Enter toggles.
-
-## See also
-
-- Source: `src/components/checkbox`

package/src/components/collapse/collapse.md

@@ -1,59 +0,0 @@
-# `<t-collapse>`
-
-> Default prefix is `t-` — change via `createToife({ prefix: "..." })`.
-
-## Description
-
-Expand/collapse panel with height animation; separate slots for trigger and content.
-
-## Requirements / dependencies
-
-| Item  | Notes                |
-| ----- | -------------------- |
-| Vue   | ^3.5                 |
-| Other | `t-app` recommended. |
-
-## Basic usage
-
-```vue
-<t-collapse v-model="open">
-  <template #trigger>Expand</template>
-  <p>Hidden content</p>
-</t-collapse>
-```
-
-## Props
-
-| Prop         | Type      | Default | Description                                        |
-| ------------ | --------- | ------- | -------------------------------------------------- |
-| `modelValue` | `boolean` | `false` | Open (`true`) / closed.                            |
-| `duration`   | `number`  | —       | Transition duration (ms), mapped to CSS variables. |
-| `role`       | `string`  | —       | Theme role.                                        |
-| `disabled`   | `boolean` | `false` | Disables toggling.                                 |
-
-**Type source:** `src/components/collapse/collapse.type.ts`
-
-## Events (emits)
-
-| Event               | Payload   | Description   |
-| ------------------- | --------- | ------------- |
-| `update:modelValue` | `boolean` | After toggle. |
-
-## Slots
-
-| Slot      | Description                         |
-| --------- | ----------------------------------- |
-| `trigger` | Clickable header (`role="button"`). |
-| `default` | Collapsible content.                |
-
-## `v-model`
-
-`modelValue` / `update:modelValue`.
-
-## Accessibility (a11y)
-
-Trigger: `role="button"`, `aria-expanded`, `aria-disabled`; Enter/Space toggles.
-
-## See also
-
-- Source: `src/components/collapse`