@lostgradient/cinder 0.4.0 → 0.5.0

package/src/components/toast-region.md

@@ -1,185 +0,0 @@
-# ToastRegion
-
-A region-scoped queue for transient notifications. `<ToastRegion>` owns the two stacked aria-live regions (polite for `info`/`success`, assertive for `warning`/`danger`); `useToast()` returns the dispatcher API to any descendant. See [`./toast-region.a11y.md`](./toast-region.a11y.md) for the ARIA contract.
-
-## Placement
-
-Mount one `<ToastRegion />` near the root of the app — `+layout.svelte` for SvelteKit, the top-level component for a single-page app.
-
-```svelte
-<!-- +layout.svelte -->
-<script lang="ts">
-  import { ToastRegion } from '@lostgradient/cinder';
-  let { children } = $props();
-</script>
-
-<ToastRegion>
-  {@render children()}
-</ToastRegion>
-```
-
-Wrap the app inside the region so route components (descendants) can call `useToast()`. `useToast()` throws (see below) if no region is mounted above the caller. Multiple regions are legal: each owns an independent queue scoped to its subtree (see [Region scope](./toast-region.a11y.md#region-scope)).
-
-## `<ToastRegion>` props
-
-| Prop              | Type                                                                                              | Default          | Description                                                                                                                                                                                                                                                                                                              |
-| ----------------- | ------------------------------------------------------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `maxStack`        | `number`                                                                                          | `5`              | Maximum simultaneous toasts in **each** region (polite and assertive each hold up to this many). Overflow drops the oldest.                                                                                                                                                                                              |
-| `defaultDuration` | `number`                                                                                          | `5000`           | Auto-dismiss duration in milliseconds. `0` makes a toast sticky. Overridable per-call via `ToastOptions.duration`.                                                                                                                                                                                                       |
-| `position`        | `'top-left' \| 'top-center' \| 'top-right' \| 'bottom-left' \| 'bottom-center' \| 'bottom-right'` | `'bottom-right'` | Viewport anchor for both live-region channels.                                                                                                                                                                                                                                                                           |
-| `class`           | `string`                                                                                          | —                | Additional class names merged with `.cinder-toast-region`.                                                                                                                                                                                                                                                               |
-| `children`        | `Snippet`                                                                                         | —                | Optional snippet rendered inside the region. Supply it when callers need access to this region's `useToast()` context — either via `{@const toast = useToast()}` inside the snippet, or in any descendant component rendered through `{@render children()}`. Callers outside the region's subtree cannot dispatch to it. |
-
-The `ToastRegionProps` type is re-exported from the package root for wrapper components.
-
-## `useToast()`
-
-Import the hook from the package root — there is no `@lostgradient/cinder/use-toast` subpath. Call `useToast()` from anywhere inside the region's subtree: a descendant component's `<script>`, or a `{@const}` binding inside a `{#snippet children()}` of the region. Both resolve the same context.
-
-```svelte
-<script lang="ts">
-  import { useToast } from '@lostgradient/cinder';
-  const toast = useToast();
-</script>
-
-<button onclick={() => toast.show('Saved your changes.', { variant: 'success' })}> Save </button>
-```
-
-`useToast()` throws `'useToast() must be called inside a <ToastRegion />. Mount one in your root layout.'` when no region is mounted above the caller. This is intentional: it surfaces a misconfigured layout immediately rather than silently swallowing dispatches.
-
-## `ToastOptions`
-
-| Field         | Type                                                          | Default                                 | Description                                                                                                                                                       |
-| ------------- | ------------------------------------------------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `variant`     | `'info' \| 'success' \| 'warning' \| 'danger'`                | `'info'`                                | Drives visual treatment **and** live-region routing (see [Variant routing](#variant-routing-polite-vs-assertive)).                                                |
-| `duration`    | `number`                                                      | region's `defaultDuration` (`5000`)     | Auto-dismiss after N ms. `0` keeps the toast until dismissed manually.                                                                                            |
-| `dismissible` | `boolean`                                                     | `true`                                  | When `true`, enables user dismissal affordances: X button, Escape, and swipe. Programmatic dismissal, overflow, and action default-dismiss still work when false. |
-| `id`          | `string`                                                      | `cinder-toast-${n}` (auto-incrementing) | Pass a stable id to deduplicate — calling `show` again with the same id replaces the existing toast instead of stacking a duplicate.                              |
-| `icon`        | `Snippet`                                                     | —                                       | Renders a decorative leading icon before the message. The icon is `aria-hidden`; keep the status meaning in the message text and variant.                         |
-| `action`      | `{ label: string; onAction: () => void; keepOpen?: boolean }` | —                                       | Renders a button after the message. Clicking invokes `onAction` then dismisses the toast unless `keepOpen` is `true` (defaults to `false`).                       |
-
-## Variant routing (polite vs assertive)
-
-`variant` is not just a visual prop — it picks which live region the toast announces through. Polite variants (`info`, `success`) queue behind the user's current screen-reader focus; assertive variants (`warning`, `danger`) interrupt. See the [Two regions, two priorities](./toast-region.a11y.md#two-regions-two-priorities) table in the a11y doc for the exact ARIA mapping.
-
-`maxStack` applies _per stack_: a region can hold up to `maxStack` polite toasts **and** `maxStack` assertive toasts simultaneously.
-
-> [!TIP]
-> Match urgency to variant. `success` ("Saved") is informational and belongs on the polite stack. `danger` ("Failed to save") interrupts because the user needs to know _now_. Reserve `warning` for conditions the user must address before continuing — session expiry, unsaved-changes risk — not ambient status updates; if no action is required, `info` is more honest.
-
-## `show()` return value
-
-`show()` returns a `string` — the assigned toast id. Capture it to enable targeted dismiss:
-
-```ts
-const id = toast.show('Saving…', { duration: 0 });
-// …later, when the operation completes:
-toast.dismiss(id);
-```
-
-Auto-generated ids (`cinder-toast-N`) are instance-local: stable for the lifetime of the mounted region and reset when it unmounts. Use them transiently within the current session, or pass a stable `options.id` when you need cross-render deduplication.
-
-## Promise toasts
-
-Use `toast.promise()` when one operation needs a sticky loading notification that turns into success or error output.
-
-```ts
-toast.promise(saveSettings(), {
-  id: 'settings-save',
-  loading: 'Saving settings...',
-  success: 'Settings saved.',
-  error: (error) => (error instanceof Error ? error.message : 'Save failed.'),
-});
-```
-
-The loading phase is sticky and polite. Success stays polite; errors move to the assertive `danger` channel. If the loading toast is dismissed or replaced before the promise settles, the late settlement is ignored.
-
-## Decorative icons
-
-Pass `icon` to show a leading visual marker next to the message. The icon is decorative (`aria-hidden="true"`), so do not rely on it as the only status signal.
-
-```svelte
-{#snippet savedIcon()}
-  <CheckIcon />
-{/snippet}
-```
-
-```ts
-toast.show('Settings saved.', {
-  variant: 'success',
-  icon: savedIcon,
-});
-```
-
-## Action buttons
-
-Pass `action: { label, onAction, keepOpen? }` to render a button after the message.
-
-```ts
-toast.show('Item moved to trash.', {
-  variant: 'info',
-  action: {
-    label: 'Undo',
-    onAction: () => restoreItem(),
-  },
-});
-```
-
-By default the toast dismisses immediately after `onAction` fires. Set `keepOpen: true` to persist the toast after the action runs — useful when the action kicks off async work the user should keep visible feedback about. The action button is focusable inside the live region so keyboard users can Tab to it after the announcement (see [Action button](./toast-region.a11y.md#action-button) in the a11y doc).
-
-> [!WARNING]
-> For destructive-action undo flows (`'Item moved to trash.'` → `Undo`), set `dismissible: false`. With the default `dismissible: true`, the user can close the toast via the X button without ever firing `onAction` — and the destructive operation stays committed. Forcing dismissal through the action button (or auto-dismiss after `duration`) keeps the undo path explicit.
-
-## Modal-scoped regions via `children`
-
-`<ToastRegion>` accepts a `children` snippet. Nesting a region inside a modal scopes dispatched toasts to that modal's lifecycle — when the modal unmounts, the region's `onDestroy` clears any pending timers.
-
-```svelte
-<Modal bind:open title="Edit profile">
-  <ToastRegion>
-    {#snippet children()}
-      {@const toast = useToast()}
-      <!-- form inputs… -->
-      <Button label="Save" onclick={() => toast.show('Saved.', { variant: 'success' })} />
-    {/snippet}
-  </ToastRegion>
-</Modal>
-```
-
-`useToast()` inside the snippet resolves to the nearest enclosing region — in this case, the modal-scoped one. Toasts dispatched here do not appear in any outer app-root region.
-
-> [!WARNING]
-> Don't dispatch to the _outer_ region from inside a modal. Toasts from the modal-scoped region render inside the modal's DOM subtree, so their action and dismiss buttons participate in the modal's focus trap as expected. Toasts dispatched to an app-root region from inside a modal render _outside_ the trap — keyboard users can't reach the dismiss or action buttons until the modal closes. Keep modal-originated toasts on the modal-scoped region.
-
-## Dismiss patterns
-
-There are six ways a toast leaves the screen:
-
-- **User-driven** via the X button (when `dismissible: true`, the default).
-- **Keyboard-driven** via Escape while focus is inside a dismissible toast.
-- **Gesture-driven** via horizontal swipe when `dismissible: true`.
-- **Auto-dismiss** after `duration` ms (when `duration > 0`).
-- **Targeted programmatic** via `toast.dismiss(id)`. No-op if the id is not active.
-- **Clear-all** via `toast.dismissAll()`. Clears polite **and** assertive stacks together.
-
-```ts
-toast.dismiss(id); // remove a specific toast
-toast.dismissAll(); // clear everything in this region
-```
-
-Hovering or focusing the region pauses active auto-dismiss timers. Timers resume when both pointer and focus leave, so keyboard users can reach action and dismiss buttons without the toast expiring mid-interaction.
-
-## Feature coverage
-
-| Feature                 | Status                                                                                         |
-| ----------------------- | ---------------------------------------------------------------------------------------------- |
-| Stacked toasts          | Present: each live-region channel keeps its own bounded stack.                                 |
-| Stagger / offset        | Present: stack index is exposed as `--cinder-toast-stack-index` for visual depth.              |
-| Swipe-to-dismiss        | Present for pointer input when `dismissible` is true.                                          |
-| Action button           | Present via `ToastOptions.action`; default dismisses after action.                             |
-| Pause-on-hover/focus    | Present across the whole region.                                                               |
-| Position variants       | Present via `position` prop, six viewport anchors.                                             |
-| Promise/loading variant | Present via `toast.promise()`, with late-settlement guards.                                    |
-| ARIA live regions       | Present and preserved as split polite/assertive channels.                                      |
-| Keyboard dismiss        | Present via Escape for dismissible toasts.                                                     |
-| Focus return            | Present for focused user dismissals; focus moves to the next toast control or `document.body`. |

package/src/components/toggle/README.md

@@ -1,48 +0,0 @@
-# Toggle
-
-On/off switch input for binary settings, presented as a sliding pill control.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import Toggle from '@lostgradient/cinder/toggle';
-</script>
-
-<Toggle id="email-notifications" label="Email notifications" />
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop            | Type       | Required | Default | Description                                                                                                                                                                                                        |
-| --------------- | ---------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `checked`       | `boolean`  | no       | —       | Whether the toggle is currently checked. Bindable — defaults to false.                                                                                                                                             |
-| `class`         | `string`   | no       | —       | Additional class names merged with `.cinder-toggle` on the switch button.                                                                                                                                          |
-| `disabled`      | `boolean`  | no       | —       | Prevents interaction when true. Sets `disabled` attribute.                                                                                                                                                         |
-| `form`          | `string`   | no       | —       | Associates the hidden checkbox with a form by id, matching the native `form` attribute. Lets the toggle submit with a form it is not nested in. Ignored when `name` is unset.                                      |
-| `hideLabel`     | `boolean`  | no       | —       | Visually hide the rendered label while keeping it as the accessible name. Use for icon-only or inline contexts.                                                                                                    |
-| `id`            | `string`   | yes      | —       | Native id placed on the `<button>`; the rendered label uses `aria-labelledby` to name it (label id is derived as `${id}-label`).                                                                                   |
-| `label`         | `string`   | yes      | —       | Visible label text. Always the accessible name, even when `hideLabel` is set. Required.                                                                                                                            |
-| `name`          | `string`   | no       | —       | Form field name. When set, a hidden checkbox mirrors `checked` so the toggle participates in native form submission. Omit for purely client-side toggles (no hidden input is rendered, so there is zero overhead). |
-| `value`         | `string`   | no       | —       | Value submitted for the hidden checkbox when `checked` and `name` is set. Mirrors native checkbox semantics: the pair `name=value` is sent only while checked. Defaults to `'on'`. Ignored when `name` is unset.   |
-| `onValueChange` | `(opaque)` | no       | —       | Intercept a proposed checked state before the bindable value is written. Return a replacement value to transform it. Not expressible in JSON Schema; see the component types for the signature.                    |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-This component does not declare any local CSS variables.
-
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-None.
-
-<!-- generated:subcomponents:end -->

package/src/components/toolbar/README.md

@@ -1,52 +0,0 @@
-# Toolbar
-
-A named grouping of related controls that implements the WAI-ARIA toolbar pattern with roving tabindex.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import Toolbar from '@lostgradient/cinder/toolbar';
-  import { Button } from '@lostgradient/cinder/button';
-</script>
-
-<Toolbar aria-label="Document actions">
-  <Toolbar.Group>
-    <Button variant="secondary">Save</Button>
-    <Button variant="secondary">Share</Button>
-  </Toolbar.Group>
-  <Toolbar.Spacer />
-  <Toolbar.Group>
-    <Button>Publish</Button>
-  </Toolbar.Group>
-</Toolbar>
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop          | Type                           | Required | Default        | Description                                                                                                      |
-| ------------- | ------------------------------ | -------- | -------------- | ---------------------------------------------------------------------------------------------------------------- |
-| `class`       | `string`                       | no       | —              | Additional class merged with `.cinder-toolbar`.                                                                  |
-| `orientation` | `"horizontal"` \| `"vertical"` | no       | `"horizontal"` | Layout direction for keyboard ownership and separator placement.                                                 |
-| `children`    | `(opaque)`                     | yes      | —              | Controls rendered inside the toolbar. Not expressible in JSON Schema; see the component types for the signature. |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-This component does not declare any local CSS variables.
-
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-- `Toolbar.Group` — cluster related controls and let the toolbar draw separators between groups.
-- `Toolbar.Spacer` — consume remaining space and push later groups to the far edge.
-
-<!-- generated:subcomponents:end -->

package/src/components/tooltip/README.md

@@ -1,45 +0,0 @@
-# Tooltip
-
-Hover-and-focus triggered hint for terse controls, anchored to a focusable child element.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import Tooltip from '@lostgradient/cinder/tooltip';
-</script>
-
-<Tooltip text="Refresh data" describe={false}>
-  <button type="button" aria-label="Refresh data">R</button>
-</Tooltip>
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop        | Type                                           | Required | Default | Description                                                                                                                     |
-| ----------- | ---------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `class`     | `string`                                       | no       | —       | Additional class names merged with the component's root class.                                                                  |
-| `describe`  | `boolean`                                      | no       | —       | Whether to wire tooltip text to the trigger via aria-describedby.                                                               |
-| `placement` | `"top"` \| `"right"` \| `"bottom"` \| `"left"` | no       | —       | Preferred side of the trigger on which the tooltip appears. Default `top`.                                                      |
-| `text`      | `string`                                       | yes      | —       | Text content rendered inside the tooltip.                                                                                       |
-| `children`  | `(opaque)`                                     | yes      | —       | The trigger element that the tooltip is anchored to. Not expressible in JSON Schema; see the component types for the signature. |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-This component does not declare any local CSS variables.
-
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-None.
-
-<!-- generated:subcomponents:end -->

package/src/components/transfer-list/README.md

@@ -1,52 +0,0 @@
-# TransferList
-
-TransferList renders two listboxes and transfer controls for assigning items
-from an available pool to a selected set.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { TransferList } from '@lostgradient/cinder/transfer-list';
-
-  const items = [
-    { id: 'read', label: 'Read' },
-    { id: 'write', label: 'Write' },
-  ];
-
-  let value = $state(['read']);
-</script>
-
-<TransferList {items} bind:value leftLabel="Available permissions" rightLabel="Granted" />
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop         | Type                                                      | Required | Default       | Description                                                                                                                                     |
-| ------------ | --------------------------------------------------------- | -------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| `class`      | `string`                                                  | no       | —             | Custom class merged with `.cinder-transfer-list`.                                                                                               |
-| `items`      | { disabled?: `boolean`; id: `string`; label: `string` }[] | yes      | —             | Full item pool. Item IDs must be unique; duplicate IDs after the first are ignored. The component never mutates this array.                     |
-| `leftLabel`  | `string`                                                  | no       | `"Available"` | Accessible and visible label for the left list.                                                                                                 |
-| `rightLabel` | `string`                                                  | no       | `"Selected"`  | Accessible and visible label for the right list.                                                                                                |
-| `value`      | `string`[]                                                | no       | —             | Unique IDs currently assigned to the right-side selected list. Supports `bind:value`. Unknown IDs are ignored and dropped on the next transfer. |
-| `onchange`   | `(opaque)`                                                | no       | —             | Called with the next right-side value after a transfer. Not expressible in JSON Schema; see the component types for the signature.              |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-This component does not declare any local CSS variables.
-
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-None.
-
-<!-- generated:subcomponents:end -->

package/src/components/tree/README.md

@@ -1,83 +0,0 @@
-# Tree
-
-Hierarchical tree view for navigating or selecting nested data structures.
-
-## Usage
-
-`Tree` is a compound component. Import the parent and compose `Tree.Item` via
-the namespace API.
-
-```svelte
-<script lang="ts">
-  import { Tree } from '@lostgradient/cinder/tree';
-
-  let expandedIds = $state<string[]>(['fruit']);
-</script>
-
-<Tree aria-label="Pantry" bind:expandedIds>
-  <Tree.Item id="fruit" label="Fruit" branch>
-    <Tree.Item id="apple" label="Apple" />
-    <Tree.Item id="banana" label="Banana" />
-  </Tree.Item>
-  <Tree.Item id="grain" label="Grain" branch>
-    <Tree.Item id="rice" label="Rice" />
-  </Tree.Item>
-</Tree>
-```
-
-The leaf remains importable individually for à-la-carte builds — see
-`@lostgradient/cinder/tree-item`.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                               | Type                                   | Required | Default | Description                                                                                                                                                                    |
-| ---------------------------------- | -------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `aria-label`                       | `string`                               | no       | —       | Accessible label for the tree. One of aria-label or aria-labelledby is required.                                                                                               |
-| `aria-labelledby`                  | `string`                               | no       | —       | The `id` of a visible element whose text serves as the accessible label for the tree. One of `aria-label` or `aria-labelledby` is required.                                    |
-| `checkboxSelection`                | `boolean`                              | no       | —       | Render tree-owned checkbox indicators when selectionMode is multiple. Default: false.                                                                                          |
-| `class`                            | `string`                               | no       | —       | Additional CSS class merged with `.cinder-tree`.                                                                                                                               |
-| `disableTypeahead`                 | `boolean`                              | no       | —       | Disable typeahead. Default: false.                                                                                                                                             |
-| `expandedIds`                      | `string`[]                             | no       | —       | Currently expanded branch ids. Bindable.                                                                                                                                       |
-| `filterPlaceholder`                | `string`                               | no       | —       | Placeholder and accessible label for the built-in search input. Default: 'Search tree'.                                                                                        |
-| `filterValue`                      | `string`                               | no       | —       | Controlled filter query. When provided, matching is driven by this value.                                                                                                      |
-| `selectedIds`                      | `string`[]                             | no       | —       | Currently selected node ids. Bindable.                                                                                                                                         |
-| `selectionBehavior`                | `"independent"` \| `"cascade"`         | no       | —       | Select only the target item or cascade through its selectable scope. Default: 'independent'.                                                                                   |
-| `selectionMode`                    | `"none"` \| `"single"` \| `"multiple"` | no       | —       | Selection model. Default: 'none'.                                                                                                                                              |
-| `showSearch`                       | `boolean`                              | no       | —       | Render the built-in search input before the role="tree" element. Default: false.                                                                                               |
-| `virtualizationEstimatedRowHeight` | `number`                               | no       | —       | Estimated row height for virtualized Tree rows. Default: 36.                                                                                                                   |
-| `virtualizationHeight`             | `string` \| `number`                   | no       | —       | Block size for the virtualized scroll viewport. Default: '20rem'.                                                                                                              |
-| `virtualizationOverscan`           | `number`                               | no       | —       | Extra rows rendered before and after the viewport. Default: 4.                                                                                                                 |
-| `virtualized`                      | `boolean`                              | no       | —       | Use the data-driven virtualized render path for large trees. Default: false.                                                                                                   |
-| `children`                         | `(opaque)`                             | no       | —       | Tree items (snippet). Required when virtualized is false or omitted; mutually exclusive with items. Not expressible in JSON Schema; see the component types for the signature. |
-| `filterPredicate`                  | `(opaque)`                             | no       | —       | Custom filter predicate. Default: case-insensitive label substring matching. Not expressible in JSON Schema; see the component types for the signature.                        |
-| `items`                            | `(opaque)`                             | no       | —       | Data-driven Tree items. Required when virtualized is true; mutually exclusive with children. Not expressible in JSON Schema; see the component types for the signature.        |
-| `onfilterchange`                   | `(opaque)`                             | no       | —       | Fires whenever the built-in search input changes the filter query. Not expressible in JSON Schema; see the component types for the signature.                                  |
-| `onreorder`                        | `(opaque)`                             | no       | —       | Called when a draggable item is dropped before, after, or into another tree item. Not expressible in JSON Schema; see the component types for the signature.                   |
-| `ref`                              | `(opaque)`                             | no       | —       | Typed programmatic handle. Use `bind:ref` to receive it. Not expressible in JSON Schema; see the component types for the signature.                                            |
-| `selectionControls`                | `(opaque)`                             | no       | —       | Optional selection controls rendered before the role="tree" element. Not expressible in JSON Schema; see the component types for the signature.                                |
-| `virtualizedItem`                  | `(opaque)`                             | no       | —       | Optional custom virtualized row renderer. Not expressible in JSON Schema; see the component types for the signature.                                                           |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-- `--cinder-tree-drop-line-color`
-- `--cinder-tree-drop-line-thickness`
-- `--cinder-tree-item-dragging-opacity`
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-- `Tree.Item` — a tree node, branch or leaf; see [`tree-item`](../tree-item/README.md).
-- `Tree.SelectAll` — the root-level select-all/none control. It reads Tree's
-  selection context and is namespace-only: there is no standalone
-  `@lostgradient/cinder/tree-select-all` import, because rendering it outside a Tree always
-  throws.
-
-<!-- generated:subcomponents:end -->

package/src/components/tree-item/README.md

@@ -1,48 +0,0 @@
-# TreeItem
-
-Expandable or leaf node within a tree view for hierarchical data navigation.
-
-## Usage
-
-`TreeItem` is a compose-only leaf of [`Tree`](../tree/README.md).
-The idiomatic API is `Tree.Item`, reached through the parent
-namespace — see the [tree README](../tree/README.md#usage) for the composed
-snippet. The flat `@lostgradient/cinder/tree-item` subpath remains exported for
-à-la-carte builds that import the leaf directly.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                | Type       | Required | Default | Description                                                                                                                                                                                                                                                                                                                                             |
-| ------------------- | ---------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `branch`            | `boolean`  | no       | —       | Marks the node as an expandable branch. A node is a leaf unless it sets `branch` or `loadChildren`; supplying a `children` snippet alone is not enough. Marking the node as a branch lets the tree render the correct expand affordance and `aria-expanded` state before any children exist (for example, before an async `loadChildren` resolves).     |
-| `class`             | `string`   | no       | —       | Additional CSS class merged with `.cinder-tree-item`.                                                                                                                                                                                                                                                                                                   |
-| `disabled`          | `boolean`  | no       | —       | When true, the item cannot be selected or actioned. Still keyboard-reachable.                                                                                                                                                                                                                                                                           |
-| `draggable`         | `boolean`  | no       | —       | Render a reorder handle when the parent Tree provides onreorder.                                                                                                                                                                                                                                                                                        |
-| `id`                | `string`   | yes      | —       | Stable unique id within the tree.                                                                                                                                                                                                                                                                                                                       |
-| `label`             | `string`   | yes      | —       | Accessible name for the item. Also used as the typeahead key.                                                                                                                                                                                                                                                                                           |
-| `selectionScopeIds` | `string`[] | no       | —       | Explicit selectable ids controlled by this item in cascade checkbox-selection mode.                                                                                                                                                                                                                                                                     |
-| `children`          | `(opaque)` | no       | —       | Nested TreeItem children for branch nodes. Not expressible in JSON Schema; see the component types for the signature.                                                                                                                                                                                                                                   |
-| `loadChildren`      | `(opaque)` | no       | —       | Async loader called the first time the item is expanded. Implies `branch=true`. The loader mutates consumer-owned reactive state; it returns no data. Errors are forwarded to `onloaderror` if provided, otherwise logged via `console.error` with a `[cinder-tree]` prefix. Not expressible in JSON Schema; see the component types for the signature. |
-| `onloaderror`       | `(opaque)` | no       | —       | Called when `loadChildren` rejects with a non-abort error. Not expressible in JSON Schema; see the component types for the signature.                                                                                                                                                                                                                   |
-| `onrename`          | `(opaque)` | no       | —       | Called when inline label editing commits a new label. Not expressible in JSON Schema; see the component types for the signature.                                                                                                                                                                                                                        |
-| `row`               | `(opaque)` | no       | —       | Optional row content snippet override. Default renders `label`. Not expressible in JSON Schema; see the component types for the signature.                                                                                                                                                                                                              |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-This component does not declare any local CSS variables.
-
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-None.
-
-<!-- generated:subcomponents:end -->

package/src/components/typography/README.md

@@ -1,52 +0,0 @@
-# Typography
-
-Renders text with a named typographic variant mapped to the design token scale.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { Typography } from '@lostgradient/cinder/typography';
-</script>
-```
-
-## Guidance
-
-### Use When
-
-- Applying a named typographic style (heading, body, caption) with semantic HTML.
-
-### Avoid When
-
-- Rendering inline text inside a paragraph — use a plain `<span>` with CSS.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop           | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Required | Default   | Description                                                                                                             |
-| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------- | ----------------------------------------------------------------------------------------------------------------------- |
-| `class`        | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | no       | —         | Additional class names merged with `.cinder-typography`.                                                                |
-| `component`    | `"object"` \| `"h1"` \| `"h2"` \| `"h3"` \| `"h4"` \| `"h5"` \| `"h6"` \| `"caption"` \| `"label"` \| `"a"` \| `"abbr"` \| `"address"` \| `"article"` \| `"aside"` \| `"audio"` \| `"b"` \| `"bdi"` \| `"bdo"` \| `"blockquote"` \| `"body"` \| `"button"` \| `"canvas"` \| `"cite"` \| `"code"` \| `"colgroup"` \| `"data"` \| `"datalist"` \| `"dd"` \| `"del"` \| `"details"` \| `"dfn"` \| `"dialog"` \| `"div"` \| `"dl"` \| `"dt"` \| `"em"` \| `"fieldset"` \| `"figcaption"` \| `"figure"` \| `"footer"` \| `"form"` \| `"head"` \| `"header"` \| `"hgroup"` \| `"html"` \| `"i"` \| `"iframe"` \| `"ins"` \| `"kbd"` \| `"legend"` \| `"li"` \| `"main"` \| `"map"` \| `"mark"` \| `"menu"` \| `"meter"` \| `"nav"` \| `"noscript"` \| `"ol"` \| `"optgroup"` \| `"option"` \| `"output"` \| `"p"` \| `"picture"` \| `"pre"` \| `"progress"` \| `"q"` \| `"rp"` \| `"rt"` \| `"ruby"` \| `"s"` \| `"samp"` \| `"script"` \| `"search"` \| `"section"` \| `"select"` \| `"slot"` \| `"small"` \| `"span"` \| `"strong"` \| `"style"` \| `"sub"` \| `"summary"` \| `"sup"` \| `"table"` \| `"tbody"` \| `"td"` \| `"template"` \| `"textarea"` \| `"tfoot"` \| `"th"` \| `"thead"` \| `"time"` \| `"title"` \| `"tr"` \| `"u"` \| `"ul"` \| `"var"` \| `"video"` | no       | —         | Override the rendered HTML element while keeping the variant's visual style.                                            |
-| `gutterBottom` | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | no       | `false`   | When true, adds bottom margin using the space scale.                                                                    |
-| `noWrap`       | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | no       | `false`   | When true, constrains to a single line with ellipsis overflow.                                                          |
-| `variant`      | `"h1"` \| `"h2"` \| `"h3"` \| `"h4"` \| `"h5"` \| `"h6"` \| `"subtitle1"` \| `"subtitle2"` \| `"body1"` \| `"body2"` \| `"caption"` \| `"overline"` \| `"label"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | no       | `"body1"` | Named typographic style to apply.                                                                                       |
-| `children`     | `(opaque)`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | yes      | —         | The text content or composed inline content. Not expressible in JSON Schema; see the component types for the signature. |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-This component does not declare any local CSS variables.
-
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-None.
-
-<!-- generated:subcomponents:end -->