@tempoxyz/ds 0.3.11 → 0.3.13

package/dist/docs/{patterns → product/patterns}/errors-and-validation.md

@@ -10,13 +10,13 @@ An error message states what happened and how to fix it, beside the problem. It
 * **Network Failure:** A request did not complete, so nothing changed. Show it beside the failed action.
 * **Transaction Failure (Failed):** The network received a transaction and rejected it, such as a transfer without funds for its fee.
 
-[Forms](/docs/patterns/forms) covers layout. [Feedback and Status](/docs/patterns/feedback-and-status) defines the Couldn't load and Failed states.
+[Forms](forms.md) covers layout. [Feedback and Status](feedback-and-status.md) defines the Couldn't load and Failed states.
 
 ## Structure
 
 1. **Field errors:** Each invalid field shows its own `Field.Error`, which replaces the field's description.
-2. **Summary:** If a submit finds two or more problems, a negative [Alert](/docs/components/alert) at the top lists them.
-3. **Failed request:** The form keeps its values, and an [Alert](/docs/components/alert) above the actions states the failure.
+2. **Summary:** If a submit finds two or more problems, a negative [Alert](../components/alert.md) at the top lists them.
+3. **Failed request:** The form keeps its values, and an [Alert](../components/alert.md) above the actions states the failure.
 4. **Retry:** The primary action stays enabled, so a second press retries.
 
 ```tsx
@@ -205,16 +205,16 @@ namespace styles {
 
 [View example source](https://github.com/tempoxyz/ds/blob/main/docs/src/examples/demos/Patterns/PaymentValidation.tsx)
 
-This reference layout uses [Field](/docs/components/field), [AmountInput](/docs/components/amount-input), and [Alert](/docs/components/alert). A short address shows a format error on Tab. An empty amount on submit shows the summary.
+This reference layout uses [Field](../components/field.md), [AmountInput](../components/amount-input.md), and [Alert](../components/alert.md). A short address shows a format error on Tab. An empty amount on submit shows the summary.
 
 ## Guidelines
 
 ### Place Errors Near Their Cause
 
-* **One Field (Field.Error):** Set `invalid` on the [Field](/docs/components/field), with the error below.
-* **A Section or Action (Alert):** Show a negative [Alert](/docs/components/alert) above what it describes.
-* **The Whole Page (Banner):** Show a negative [Banner](/docs/components/banner) at the top of the page.
-* **A Background Task (Toast):** Show a [Toast](/docs/components/toast). If a retry exists, add it as an action.
+* **One Field (Field.Error):** Set `invalid` on the [Field](../components/field.md), with the error below.
+* **A Section or Action (Alert):** Show a negative [Alert](../components/alert.md) above what it describes.
+* **The Whole Page (Banner):** Show a negative [Banner](../components/banner.md) at the top of the page.
+* **A Background Task (Toast):** Show a [Toast](../components/toast.md). If a retry exists, add it as an action.
 
 ### Validate at the Right Moment
 
@@ -380,7 +380,7 @@ namespace styles {
 ### Summarize Several Errors
 
 * **One problem:** On submit, move focus to its field.
-* **Two or more:** Render a negative [Alert](/docs/components/alert) at the top of the form. It names the count, lists each error as a link that focuses its field, and receives focus.
+* **Two or more:** Render a negative [Alert](../components/alert.md) at the top of the form. It names the count, lists each error as a link that focuses its field, and receives focus.
 
 **Do:** Keep each `Field.Error` beside its field, and link each summary item to it.
 
@@ -486,7 +486,7 @@ namespace styles {
 
 ### Report Failed Requests Where They Happen
 
-If a submit fails on the network, keep the form open with its values, so a retry takes one press. State the failure in a negative [Alert](/docs/components/alert) above the actions.
+If a submit fails on the network, keep the form open with its values, so a retry takes one press. State the failure in a negative [Alert](../components/alert.md) above the actions.
 
 * **Outcome First:** Lead with what did not happen, such as "Payment not sent".
 * **Say Where the Money Is:** For payments, always state whether funds moved. An unsure reader often pays twice.
@@ -544,13 +544,13 @@ namespace styles {
 }
 ```
 
-Do not report a failed payment only in a [Toast](/docs/components/toast). It dismisses itself before the reader decides what to do.
+Do not report a failed payment only in a [Toast](../components/toast.md). It dismisses itself before the reader decides what to do.
 
 ### Report Page-Wide Errors in a Banner
 
-If a problem affects the whole page, such as a lost connection, keep the [Banner](/docs/components/banner) visible until the problem resolves.
+If a problem affects the whole page, such as a lost connection, keep the [Banner](../components/banner.md) visible until the problem resolves.
 
-**Do:** Use a [Banner](/docs/components/banner) for a problem that affects the whole page.
+**Do:** Use a [Banner](../components/banner.md) for a problem that affects the whole page.
 
 ```tsx
 <Banner intent="negative">
@@ -558,7 +558,7 @@ If a problem affects the whole page, such as a lost connection, keep the [Banner
 </Banner>
 ```
 
-**Don't:** Report a field error in a [Banner](/docs/components/banner), away from the field.
+**Don't:** Report a field error in a [Banner](../components/banner.md), away from the field.
 
 ```tsx
 <Banner intent="negative">
@@ -568,7 +568,7 @@ If a problem affects the whole page, such as a lost connection, keep the [Banner
 
 ### Explain Transaction Failures
 
-A transaction that reached the network and failed differs from a request that never arrived. Mark it Failed with a [Badge](/docs/components/badge) and keep it in activity. A failed transfer moves no funds, but its network fee may still be charged, so state both.
+A transaction that reached the network and failed differs from a request that never arrived. Mark it Failed with a [Badge](../components/badge.md) and keep it in activity. A failed transfer moves no funds, but its network fee may still be charged, so state both.
 
 **Do:** Show the reason a transaction failed beside its Failed status.
 
@@ -772,37 +772,37 @@ A disabled button states no reason. An enabled one lets the reader submit and re
 * **Default:** Fields with descriptions and no errors. Nothing is checked before interaction.
 * **Loading (loading):** Earlier errors stay visible while a check or request runs.
 * **Disabled:** Skip validation for disabled fields. Screen readers do not announce an error on a disabled control.
-* **Success:** After a successful submit, confirm the result with a [Toast](/docs/components/toast) or the next screen.
+* **Success:** After a successful submit, confirm the result with a [Toast](../components/toast.md) or the next screen.
 
 ## Accessibility
 
 * **Linked Errors (aria-describedby):** A shown error is read when its control takes focus. `invalid` sets `aria-invalid`. `success` sets no state.
 * **Summary Links:** A negative alert announces the summary on render. Each link moves focus to its field.
 
-[Feedback and Status](/docs/patterns/feedback-and-status#accessibility) covers how alerts and banners announce.
+[Feedback and Status](feedback-and-status.md#accessibility) covers how alerts and banners announce.
 
 ## Related
 
-[Field](/docs/components/field)
+[Field](../components/field.md)
 
 Use for labels and error messages.
 
-[Alert](/docs/components/alert)
+[Alert](../components/alert.md)
 
 Use for summaries and failures.
 
-[Toast](/docs/components/toast)
+[Toast](../components/toast.md)
 
 Use for background failures.
 
-[Forms](/docs/patterns/forms)
+[Forms](forms.md)
 
 Covers layout and actions.
 
-[Feedback and Status](/docs/patterns/feedback-and-status)
+[Feedback and Status](feedback-and-status.md)
 
 Covers the Failed and Couldn't load states.
 
-[Empty States](/docs/patterns/empty-states)
+[Empty States](empty-states.md)
 
 Covers regions that couldn't load.

package/dist/docs/{patterns → product/patterns}/feedback-and-status.md

@@ -1,23 +1,23 @@
 # Feedback and Status
 
-Name each system state once, and choose [Toast](/docs/components/toast), [Alert](/docs/components/alert), or [Banner](/docs/components/banner) by urgency.
+Name each system state once, and choose [Toast](../components/toast.md), [Alert](../components/alert.md), or [Banner](../components/banner.md) by urgency.
 
 ## Overview
 
 Every action needs a response, and every change of state needs a visible result. Two questions pick the component: what the message describes (one action, one section, or the whole product), and how soon the reader must act. Match the weight of the message to the weight of the event, since overused loud feedback trains people to ignore it.
 
-[Loading](/docs/patterns/loading) and [Empty States](/docs/patterns/empty-states) cover the states before content arrives.
+[Loading](loading.md) and [Empty States](empty-states.md) cover the states before content arrives.
 
 ## Components
 
 | Component | Scope | Lifetime | Typical use |
 | --- | --- | --- | --- |
-| [Field](/docs/components/field) `Field.Error` | One value | Until corrected | Enter 1,250.00 USDC or less |
-| [Badge](/docs/components/badge), or `status` on a [Table](/docs/components/table) cell | One record | While the state holds | A transaction or a webhook delivery |
-| [Toast](/docs/components/toast) | One action | Seconds | The result of an action the reader started |
-| [Alert](/docs/components/alert) | One section | Until resolved | Couldn't load older activity |
-| [Banner](/docs/components/banner) | Whole product | Until resolved or dismissed | Testnet faucets are paused for maintenance |
-| [AlertDialog](/docs/components/alert-dialog) | One decision | Until answered | Revoke this API key? |
+| [Field](../components/field.md) `Field.Error` | One value | Until corrected | Enter 1,250.00 USDC or less |
+| [Badge](../components/badge.md), or `status` on a [Table](../components/table.md) cell | One record | While the state holds | A transaction or a webhook delivery |
+| [Toast](../components/toast.md) | One action | Seconds | The result of an action the reader started |
+| [Alert](../components/alert.md) | One section | Until resolved | Couldn't load older activity |
+| [Banner](../components/banner.md) | Whole product | Until resolved or dismissed | Testnet faucets are paused for maintenance |
+| [AlertDialog](../components/alert-dialog.md) | One decision | Until answered | Revoke this API key? |
 
 * **Toast:** Dismisses itself after five seconds by default, so never put information in it that the reader must keep or act on. Offer its action elsewhere too. Set `timeout: 0` for a toast with Undo, and show critical errors inline instead.
 * **Alert:** Sits beside the decision it affects, with one action at most. Do not use it for a passing confirmation such as Address copied.
@@ -28,13 +28,13 @@ Every action needs a response, and every change of state needs a visible result.
 Each state has one word, one component, and one icon.
 
 * **Unavailable (No icon):** The value does not exist now, such as a missing price. Show Unavailable in gray in its place.
-* **Couldn't Load (AlertCircle):** A request for the region's content failed. Use a negative [Alert](/docs/components/alert) or an [Empty](/docs/components/empty) state, with a retry.
-* **Pending (Pending):** Submitted and waiting for inclusion in a block. Use a [Badge](/docs/components/badge) with the icon.
-* **Confirmed (CheckCircle):** Included in a block. Use a [Badge](/docs/components/badge) with the icon.
-* **Failed (AlertCircle):** Rejected or reverted by the network. Use a [Badge](/docs/components/badge) with the icon, and the reason nearby.
+* **Couldn't Load (AlertCircle):** A request for the region's content failed. Use a negative [Alert](../components/alert.md) or an [Empty](../components/empty.md) state, with a retry.
+* **Pending (Pending):** Submitted and waiting for inclusion in a block. Use a [Badge](../components/badge.md) with the icon.
+* **Confirmed (CheckCircle):** Included in a block. Use a [Badge](../components/badge.md) with the icon.
+* **Failed (AlertCircle):** Rejected or reverted by the network. Use a [Badge](../components/badge.md) with the icon, and the reason nearby.
 * **Amount Hidden (EyeOff):** The reader hid amounts on this device. Show a fixed mask, read aloud as Amount hidden.
 
-In a [Table](/docs/components/table), set `status` on `Table.Cell` to `warning`, `positive`, or `negative` for Pending, Confirmed, and Failed. The cell colors its text, so keep the same word.
+In a [Table](../components/table.md), set `status` on `Table.Cell` to `warning`, `positive`, or `negative` for Pending, Confirmed, and Failed. The cell colors its text, so keep the same word.
 
 ```tsx
 import { Alert, Badge, ListGroup, style, Surface } from '@tempoxyz/ds'
@@ -145,13 +145,13 @@ namespace styles {
 
 [View example source](https://github.com/tempoxyz/ds/blob/main/docs/src/examples/demos/Patterns/StatusVocabulary.tsx)
 
-This reference layout shows five of the states, built from [Surface](/docs/components/surface), [ListGroup](/docs/components/list-group), [Badge](/docs/components/badge), and [Alert](/docs/components/alert).
+This reference layout shows five of the states, built from [Surface](../components/surface.md), [ListGroup](../components/list-group.md), [Badge](../components/badge.md), and [Alert](../components/alert.md).
 
 * **Unavailable:** Keep the rest of the row, since the token balance is still known. If the reason helps the reader act, state it nearby.
-* **Couldn't load:** Name the content, such as Couldn't load activity. If part of a region failed, keep what loaded and use an alert. If all of it failed, use an [empty state](/docs/patterns/empty-states) with Try again.
-* **Pending:** Keep the transaction in activity with its amount and recipient, from submission until inclusion in a block (see [Loading](/docs/patterns/loading#show-pending-transactions)).
-* **Failed:** Keep the row in activity and state the reason (see [Errors and Validation](/docs/patterns/errors-and-validation#explain-transaction-failures)).
-* **Amount hidden:** Mask every amount, as [Blockchain Values](/docs/patterns/blockchain-values#hidden-amounts) describes.
+* **Couldn't load:** Name the content, such as Couldn't load activity. If part of a region failed, keep what loaded and use an alert. If all of it failed, use an [empty state](empty-states.md) with Try again.
+* **Pending:** Keep the transaction in activity with its amount and recipient, from submission until inclusion in a block (see [Loading](loading.md#show-pending-transactions)).
+* **Failed:** Keep the row in activity and state the reason (see [Errors and Validation](errors-and-validation.md#explain-transaction-failures)).
+* **Amount hidden:** Mask every amount, as [Blockchain Values](blockchain-values.md#hidden-amounts) describes.
 
 ## Urgency
 
@@ -160,11 +160,11 @@ Rank each message before you choose how to show it.
 * **Low (Toast):** An expected confirmation, such as Address copied.
 * **Medium (Alert):** Information that affects a decision. Place it beside the decision.
 * **High (Banner or Alert):** A condition that blocks work or puts funds at risk. Keep it until the condition clears.
-* **Critical (AlertDialog):** A decision the reader must make first (see [Destructive Actions](/docs/patterns/destructive-actions)).
+* **Critical (AlertDialog):** A decision the reader must make first (see [Destructive Actions](destructive-actions.md)).
 
 ## Intent
 
-Choose the intent from the meaning of the message. Keep it consistent across [Toast](/docs/components/toast), [Alert](/docs/components/alert), and [Banner](/docs/components/banner).
+Choose the intent from the meaning of the message. Keep it consistent across [Toast](../components/toast.md), [Alert](../components/alert.md), and [Banner](../components/banner.md).
 
 * **Neutral (neutral):** General information with no judgment.
 * **Tip (tip):** Helpful context that does not need action.
@@ -471,8 +471,8 @@ namespace styles {
 
 * **Default:** No message. Records show their status badge.
 * **Error:** Couldn't load for a failed request, Failed for a rejected transaction, and a field error for a bad value.
-* **Empty:** An empty state that states the cause (see [Empty States](/docs/patterns/empty-states)).
-* **Success:** Confirmed on the record, and a positive [Toast](/docs/components/toast) for a finished action.
+* **Empty:** An empty state that states the cause (see [Empty States](empty-states.md)).
+* **Success:** Confirmed on the record, and a positive [Toast](../components/toast.md) for a finished action.
 
 ## Content
 
@@ -484,35 +484,35 @@ namespace styles {
 
 * **Toasts (F6):** Toasts are announced, and hover or focus pauses their timers. Pass `priority: 'high'` only for urgent toasts.
 * **Alerts (alert or status):** Warning and negative alerts interrupt the screen reader. Info and positive alerts announce politely.
-* **Banners (role):** A [Banner](/docs/components/banner) renders no live region. Add `role="status"` or `role="alert"` only if it renders after page load.
-* **Status Changes:** A change from Pending to Confirmed is not announced. If the reader started the transaction in this session, use a [Toast](/docs/components/toast).
+* **Banners (role):** A [Banner](../components/banner.md) renders no live region. Add `role="status"` or `role="alert"` only if it renders after page load.
+* **Status Changes:** A change from Pending to Confirmed is not announced. If the reader started the transaction in this session, use a [Toast](../components/toast.md).
 
 ## Related
 
-[Badge](/docs/components/badge)
+[Badge](../components/badge.md)
 
 Use for record status.
 
-[Alert](/docs/components/alert)
+[Alert](../components/alert.md)
 
 Use for section messages.
 
-[Banner](/docs/components/banner)
+[Banner](../components/banner.md)
 
 Use for product-wide messages.
 
-[Toast](/docs/components/toast)
+[Toast](../components/toast.md)
 
 Use for confirmations.
 
-[SecretValue](/docs/components/secret-value)
+[SecretValue](../components/secret-value.md)
 
 Use for masked secrets.
 
-[Loading](/docs/patterns/loading)
+[Loading](loading.md)
 
 Covers Pending transactions.
 
-[Blockchain Values](/docs/patterns/blockchain-values)
+[Blockchain Values](blockchain-values.md)
 
 Covers amounts and addresses.

package/dist/docs/{patterns → product/patterns}/forms.md

@@ -6,18 +6,18 @@ Order fields, labels, and actions so a person completes a form in one pass.
 
 Ask only for the values the task needs. Remove every field you can derive, default, or ask for later.
 
-This page covers layout, labels, save models, and actions. [Errors and Validation](/docs/patterns/errors-and-validation) covers checking values and reporting problems.
+This page covers layout, labels, save models, and actions. [Errors and Validation](errors-and-validation.md) covers checking values and reporting problems.
 
 ## Choosing a Control
 
 Choose the control from the shape of the value, not from its look.
 
-* **Free Text (TextInput):** For a name or address. Use a [Textarea](/docs/components/textarea) for a longer memo.
-* **An Amount of Money (AmountInput):** [AmountInput](/docs/components/amount-input) sets a decimal keyboard and rejects anything that is not a number.
-* **Five or Fewer Options (RadioGroup):** A [RadioGroup](/docs/components/radio-group) keeps every choice visible.
-* **Many Options (Select):** A [Select](/docs/components/select). If people need to search, use a [Combobox](/docs/components/combobox).
+* **Free Text (TextInput):** For a name or address. Use a [Textarea](../components/textarea.md) for a longer memo.
+* **An Amount of Money (AmountInput):** [AmountInput](../components/amount-input.md) sets a decimal keyboard and rejects anything that is not a number.
+* **Five or Fewer Options (RadioGroup):** A [RadioGroup](../components/radio-group.md) keeps every choice visible.
+* **Many Options (Select):** A [Select](../components/select.md). If people need to search, use a [Combobox](../components/combobox.md).
 
-**Do:** Show a short set of exclusive options in a [RadioGroup](/docs/components/radio-group).
+**Do:** Show a short set of exclusive options in a [RadioGroup](../components/radio-group.md).
 
 ```tsx
 <Fieldset.Root>
@@ -39,7 +39,7 @@ Choose the control from the shape of the value, not from its look.
 </Fieldset.Root>
 ```
 
-**Don't:** Use a [Checkbox](/docs/components/checkbox) for options that exclude each other.
+**Don't:** Use a [Checkbox](../components/checkbox.md) for options that exclude each other.
 
 ```tsx
 <Fieldset.Root>
@@ -225,7 +225,7 @@ namespace styles {
 
 [View example source](https://github.com/tempoxyz/ds/blob/main/docs/src/examples/demos/Patterns/WebhookForm.tsx)
 
-This reference layout uses [Surface](/docs/components/surface), [Frame](/docs/components/frame), [Fieldset](/docs/components/fieldset), and [Field](/docs/components/field). Submit an empty URL to show the error, then fix the URL to clear it.
+This reference layout uses [Surface](../components/surface.md), [Frame](../components/frame.md), [Fieldset](../components/fieldset.md), and [Field](../components/field.md). Submit an empty URL to show the error, then fix the URL to clear it.
 
 ### Use One Column
 
@@ -321,7 +321,7 @@ namespace styles {
 
 ### Group Related Fields
 
-Wrap the parts of one idea, such as an address, in a [Fieldset](/docs/components/fieldset) with a `Fieldset.Legend`. Set `variant` once on the fieldset, which passes it to every nested `Field.Root`. If a form outgrows two or three groups, split it into steps with a [Stepper](/docs/components/stepper).
+Wrap the parts of one idea, such as an address, in a [Fieldset](../components/fieldset.md) with a `Fieldset.Legend`. Set `variant` once on the fieldset, which passes it to every nested `Field.Root`. If a form outgrows two or three groups, split it into steps with a [Stepper](../components/stepper.md).
 
 **Do:** Group related fields under one legend and one variant.
 
@@ -369,7 +369,7 @@ Every control needs a visible `Field.Label`, written as a short noun. Put format
 
 ### Put Labels Above Fields
 
-[Field](/docs/components/field) puts the label 12px above every control. The label stays visible during input, and long labels wrap without narrowing the control.
+[Field](../components/field.md) puts the label 12px above every control. The label stays visible during input, and long labels wrap without narrowing the control.
 
 * **Text Field (TextInput):** The label sits above the field, and the message below it.
 * **Switch (Switch):** The label sits above the switch, as it does above a text field.
@@ -505,11 +505,11 @@ namespace styles {
 ### Choose a Save Model
 
 * **Save on Submit (Checkbox):** For values that work together. Nothing changes until you press the primary action.
-* **Save on Change (Switch):** For independent settings. Confirm each change with a [Toast](/docs/components/toast), and revert it if it fails.
+* **Save on Change (Switch):** For independent settings. Confirm each change with a [Toast](../components/toast.md), and revert it if it fails.
 
-Do not mix the two in one section. If a person leaves a long form with unsaved changes, confirm the discard (see [Destructive Actions](/docs/patterns/destructive-actions)).
+Do not mix the two in one section. If a person leaves a long form with unsaved changes, confirm the discard (see [Destructive Actions](destructive-actions.md)).
 
-**Do:** Use a [Switch](/docs/components/switch) for a setting that applies immediately.
+**Do:** Use a [Switch](../components/switch.md) for a setting that applies immediately.
 
 ```tsx
 <Field.Root>
@@ -532,7 +532,7 @@ Do not mix the two in one section. If a person leaves a long form with unsaved c
 
 ## Submitting
 
-Keep the submit button enabled and validate on press (see [Errors and Validation](/docs/patterns/errors-and-validation#keep-submit-buttons-enabled)). Set `loading` on it while the request runs, to block a second submit.
+Keep the submit button enabled and validate on press (see [Errors and Validation](errors-and-validation.md#keep-submit-buttons-enabled)). Set `loading` on it while the request runs, to block a second submit.
 
 ### Order Actions
 
@@ -631,10 +631,10 @@ Use one primary button, so Enter submits the form. Label it with the result, suc
 ## States
 
 * **Default:** Prefill a value when it is known, such as the connected address.
-* **Loading (Skeleton):** Wrap each control in a [Skeleton](/docs/components/skeleton) while saved values load.
-* **Error (Field.Error):** An error under each invalid field (see [Errors and Validation](/docs/patterns/errors-and-validation)).
+* **Loading (Skeleton):** Wrap each control in a [Skeleton](../components/skeleton.md) while saved values load.
+* **Error (Field.Error):** An error under each invalid field (see [Errors and Validation](errors-and-validation.md)).
 * **Disabled (disabled):** Set it on a fieldset to disable a whole group, and state the reason nearby.
-* **Success (success):** Close the form and confirm with a [Toast](/docs/components/toast). `success` sets no ARIA state, so confirm in text too.
+* **Success (success):** Close the form and confirm with a [Toast](../components/toast.md). `success` sets no ARIA state, so confirm in text too.
 
 ## Content
 
@@ -650,30 +650,30 @@ Use one primary button, so Enter submits the form. Label it with the result, suc
 
 ## Related
 
-[Field](/docs/components/field)
+[Field](../components/field.md)
 
 Use for labels, descriptions, and errors.
 
-[Fieldset](/docs/components/fieldset)
+[Fieldset](../components/fieldset.md)
 
 Use for grouping fields.
 
-[TextInput](/docs/components/text-input)
+[TextInput](../components/text-input.md)
 
 Use for text.
 
-[AmountInput](/docs/components/amount-input)
+[AmountInput](../components/amount-input.md)
 
 Use for amounts of money.
 
-[Button](/docs/components/button)
+[Button](../components/button.md)
 
 Use for submit and cancel actions.
 
-[Errors and Validation](/docs/patterns/errors-and-validation)
+[Errors and Validation](errors-and-validation.md)
 
 Covers checking values.
 
-[Loading](/docs/patterns/loading)
+[Loading](loading.md)
 
 Covers submit and load states.

package/dist/docs/{patterns → product/patterns}/loading.md

@@ -6,10 +6,10 @@ Show that content or an action is on its way, with an indicator to fit the wait.
 
 Loading applies at three scales: a region that fetches data, an action that waits for a response, and a transaction that waits for a block. At each scale, keep the layout still, block duplicate requests, and end in a result or an error.
 
-* **Shape Known (Skeleton):** The shape is known, such as a balance or a row value. Outline it with [Skeleton](/docs/components/skeleton).
-* **Shape Unknown (Spinner):** Only the arrival is known, such as for search results. Center one named [Spinner](/docs/components/spinner) in the region.
-* **Inside a Control (loading):** An action runs in place. Use a busy [Button](/docs/components/button), or [LoadingDots](/docs/components/loading-dots) inside a sentence.
-* **Progress Known (Progress):** The work is countable, such as months exported or files uploaded. Show [Progress](/docs/components/progress).
+* **Shape Known (Skeleton):** The shape is known, such as a balance or a row value. Outline it with [Skeleton](../components/skeleton.md).
+* **Shape Unknown (Spinner):** Only the arrival is known, such as for search results. Center one named [Spinner](../components/spinner.md) in the region.
+* **Inside a Control (loading):** An action runs in place. Use a busy [Button](../components/button.md), or [LoadingDots](../components/loading-dots.md) inside a sentence.
+* **Progress Known (Progress):** The work is countable, such as months exported or files uploaded. Show [Progress](../components/progress.md).
 
 ## Structure
 
@@ -112,7 +112,7 @@ namespace styles {
 
 [View example source](https://github.com/tempoxyz/ds/blob/main/docs/src/examples/demos/Patterns/BalanceSkeleton.tsx)
 
-This reference layout uses [Skeleton](/docs/components/skeleton) for the total and for each token value in [ListGroup](/docs/components/list-group), so the token labels stay on screen. A refresh keeps the old values on screen.
+This reference layout uses [Skeleton](../components/skeleton.md) for the total and for each token value in [ListGroup](../components/list-group.md), so the token labels stay on screen. A refresh keeps the old values on screen.
 
 ## Timing
 
@@ -127,7 +127,7 @@ Set `loading` on a pressed button immediately, whatever the wait.
 
 ## Skeleton
 
-Wrap the real content in a [Skeleton](/docs/components/skeleton) and set `show={false}` on arrival, instead of swapping elements. The skeleton takes the exact size of the content.
+Wrap the real content in a [Skeleton](../components/skeleton.md) and set `show={false}` on arrival, instead of swapping elements. The skeleton takes the exact size of the content.
 
 **Do:** Shape skeletons like the content, so the layout holds still when it arrives.
 
@@ -287,7 +287,7 @@ namespace styles {
 
 ## Pending Actions
 
-Show the pending state on the pressed [Button](/docs/components/button) itself. Inside a line of text, such as a balance that refreshes beside its label, use [LoadingDots](/docs/components/loading-dots).
+Show the pending state on the pressed [Button](../components/button.md) itself. Inside a line of text, such as a balance that refreshes beside its label, use [LoadingDots](../components/loading-dots.md).
 
 **Do:** Set `loading` on the button that started the action.
 
@@ -306,7 +306,7 @@ Show the pending state on the pressed [Button](/docs/components/button) itself.
 
 ### Update Optimistically Only When You Can Undo It
 
-Apply a change before the server confirms it only if the change is low-risk, easy to reverse, and almost always succeeds, such as renaming an API key or flipping a notification [Switch](/docs/components/switch).
+Apply a change before the server confirms it only if the change is low-risk, easy to reverse, and almost always succeeds, such as renaming an API key or flipping a notification [Switch](../components/switch.md).
 
 * **Restore on Failure (Toast):** Restore the previous value and state the failure, such as Couldn't rename key.
 * **Never for Onchain State:** Never update onchain state, such as balances, optimistically. Show the transaction as Pending.
@@ -526,7 +526,7 @@ namespace styles {
 
 ## Progress
 
-Use [Progress](/docs/components/progress) when the work is measurable, such as files uploaded or steps completed. Use `value={null}` only if the remaining work is unknown.
+Use [Progress](../components/progress.md) when the work is measurable, such as files uploaded or steps completed. Use `value={null}` only if the remaining work is unknown.
 
 **Do:** Show how much of a long task is done.
 
@@ -582,9 +582,9 @@ namespace styles {
 ## States
 
 * **Error:** Couldn't load in place of the placeholder, with Try again. Never leave an indicator spinning after a failure.
-* **Empty:** An [Empty](/docs/components/empty) state after loading finishes with no content. Never show it while loading.
+* **Empty:** An [Empty](../components/empty.md) state after loading finishes with no content. Never show it while loading.
 * **Disabled:** Controls that depend on the data stay disabled until it arrives, such as Send before balances load.
-* **Success:** The content replaces the placeholder. Confirm finished actions with a [Toast](/docs/components/toast).
+* **Success:** The content replaces the placeholder. Confirm finished actions with a [Toast](../components/toast.md).
 
 ## Content
 
@@ -593,7 +593,7 @@ namespace styles {
 
 ## Accessibility
 
-* **Named Indicators (aria-label):** [Spinner](/docs/components/spinner), [LoadingDots](/docs/components/loading-dots), and the row loaders are named Loading. Pass `aria-label` to name what loads.
+* **Named Indicators (aria-label):** [Spinner](../components/spinner.md), [LoadingDots](../components/loading-dots.md), and the row loaders are named Loading. Pass `aria-label` to name what loads.
 * **Skeleton (aria-busy):** Marks the region busy, blocks pointer input, and hides placeholder text from screen readers.
 * **Busy Buttons (aria-busy):** A loading button is marked busy. Announce the result separately, such as in a toast.
 * **Reduced Motion (prefers-reduced-motion):** Every sweep, rotation, and pulse stops. The indicators still mark work in progress.
@@ -601,30 +601,30 @@ namespace styles {
 
 ## Related
 
-[Skeleton](/docs/components/skeleton)
+[Skeleton](../components/skeleton.md)
 
 Use for content with a known shape.
 
-[Spinner](/docs/components/spinner)
+[Spinner](../components/spinner.md)
 
 Use for content with an unknown shape.
 
-[Progress](/docs/components/progress)
+[Progress](../components/progress.md)
 
 Use for measurable work.
 
-[Button](/docs/components/button)
+[Button](../components/button.md)
 
 Use for the `loading` state.
 
-[Feedback and Status](/docs/patterns/feedback-and-status)
+[Feedback and Status](feedback-and-status.md)
 
 Covers Pending and Confirmed.
 
-[Empty States](/docs/patterns/empty-states)
+[Empty States](empty-states.md)
 
 Covers what follows an empty result.
 
-[Payments](/docs/patterns/payments)
+[Payments](payments.md)
 
 Covers the send and review flow.