@lostgradient/cinder 0.4.1 → 0.5.0

package/src/components/alert/README.md

@@ -1,41 +0,0 @@
-# Alert
-
-A status message that communicates contextual feedback and can optionally be dismissed.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import Alert from '@lostgradient/cinder/alert';
-</script>
-
-<Alert variant="success">Saved successfully.</Alert>
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop          | Type                                                 | Required | Default  | Description                                                                                                                |
-| ------------- | ---------------------------------------------------- | -------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `class`       | `string`                                             | no       | —        | Custom class merged with `.cinder-alert`.                                                                                  |
-| `dismissible` | `boolean`                                            | no       | `false`  | Allow the alert to be dismissed.                                                                                           |
-| `variant`     | `"info"` \| `"success"` \| `"warning"` \| `"danger"` | no       | `"info"` | Visual severity variant. `danger` is the canonical failure-severity spelling, consistent with banner and callout.          |
-| `children`    | `(opaque)`                                           | yes      | —        | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `icon`        | `(opaque)`                                           | no       | —        | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `ondismiss`   | `(opaque)`                                           | no       | —        | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-- `--cinder-alert-info`
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-<!-- generated:subcomponents:end -->

package/src/components/alert-dialog/README.md

@@ -1,75 +0,0 @@
-# AlertDialog
-
-Sticky blocking acknowledgement dialog that cannot be dismissed by Escape or backdrop click. The user must click an explicit action button to proceed.
-
-## Dialog model
-
-AlertDialog is one of three dialog-level components:
-
-- **`Modal`** — generic shell for rich content and forms.
-- **`ConfirmDialog`** — preset for user-initiated binary decisions; Escape is a safe exit; cancel is the default focus.
-- **`AlertDialog`** — this component. Preset for system-initiated or out-of-band urgency. No Escape exit. No backdrop dismiss. No close button. Acknowledgement is mandatory.
-
-The key distinction between AlertDialog and ConfirmDialog is _who initiates_ the interruption and _whether dismissal without acting is safe_:
-
-- ConfirmDialog is for user-initiated actions that need a safety gate. Pressing Escape means "never mind" — a safe, expected exit. This includes high-impact destructive actions the user initiated, even ones that affect other people.
-- AlertDialog is for conditions the _system_ surfaces that require the user to acknowledge before continuing. Pressing Escape would bypass acknowledgement, which is unsafe because the session state has already changed and proceeding without reading the message is incorrect.
-
-## Choosing this component
-
-- Session expiry, authentication loss, or network disconnection that requires the user to re-authenticate before continuing.
-- System-level errors or process failures where the user must acknowledge the condition before taking any other action.
-- Any situation where the dialog is triggered by a system event — not a user click — and dismissal by Escape or backdrop click would be incorrect because the user _must_ read and respond.
-
-## Choosing something else
-
-- User-initiated destructive actions (including high-impact ones like "Delete workspace" or "Remove all collaborators") — use [`ConfirmDialog`](../confirm-dialog/README.md). Even when the action is irreversible or affects other people, Escape is a valid "never mind" because the _user_ chose to open the dialog. ConfirmDialog's cancel-button autofocus is the right affordance.
-- Rich body content (markup, lists, multiple paragraphs) — `description` is a plain-text string. For rich body, compose [`Modal`](../modal/README.md) with `role="alertdialog"` directly (see Modal's `role` prop documentation for the required companion props).
-- Non-blocking notifications — use a toast or inline alert that does not interrupt the flow.
-
-`cancelLabel` creates an explicit _alternative_ action button (e.g. "Stay signed in" alongside "Sign out"). It is not an implicit dismiss path — there is no Escape, no backdrop click, no close-X.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import AlertDialog from '@lostgradient/cinder/alert-dialog';
-</script>
-
-<AlertDialog />
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop               | Type       | Required | Default | Description                                                                                                                                                                           |
-| ------------------ | ---------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `acknowledgeLabel` | `string`   | no       | —       | Label for the primary acknowledgement button. Default `OK`.                                                                                                                           |
-| `cancelLabel`      | `string`   | no       | —       | Label for the optional cancel button. When omitted, no cancel button is rendered.                                                                                                     |
-| `class`            | `string`   | no       | —       | Additional class names merged with the component's root class.                                                                                                                        |
-| `description`      | `string`   | yes      | —       | Explanatory paragraph displayed in the dialog body and wired to the dialog via aria-describedby.                                                                                      |
-| `destructive`      | `boolean`  | no       | —       | When true, styles the acknowledgement button as a danger action and, when a cancel button is rendered, gives it initial focus instead of the acknowledgement button. Default `false`. |
-| `open`             | `boolean`  | yes      | —       | Controls whether the alert dialog is open; bindable for controlled usage.                                                                                                             |
-| `title`            | `string`   | yes      | —       | Text rendered as the dialog's visible heading and accessible label.                                                                                                                   |
-| `onacknowledge`    | `(opaque)` | yes      | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature.                                                            |
-| `oncancel`         | `(opaque)` | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature.                                                            |
-| `triggerRef`       | `(opaque)` | no       | —       | A prop whose shape is not captured by the JSON schema; see the component types for the exact 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/approval-card/README.md

@@ -1,92 +0,0 @@
-# ApprovalCard
-
-Presentational human-in-the-loop approval surface for reviewing a tool operation
-before the host application executes it.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { ApprovalCard } from '@lostgradient/cinder/approval-card';
-</script>
-
-<ApprovalCard
-  tool={{ name: 'deploy-cloud', risk: 'medium' }}
-  sandbox={{
-    provider: 'codex',
-    name: 'workspace-write',
-    workingDir: '/workspace/project',
-  }}
-  operation={{
-    kind: 'command',
-    command: 'bun run --filter=@lostgradient/cinder validate',
-    argsPreview: { package: '@lostgradient/cinder' },
-  }}
-  env={['DATABASE_URL', 'OPENAI_API_KEY']}
-  policyVersion="policy-2026-06"
-  idempotencyKey="approval-01JZ8T"
-  state="pending"
-  onapprove={() => approve()}
-  ondeny={() => deny()}
-/>
-```
-
-`ApprovalCard` is fully controlled. It does not execute commands, apply patches,
-persist policy decisions, or read environment values. The component only renders
-the supplied context and invokes callback props for host-owned actions.
-
-## Operation rendering
-
-- `operation.kind: 'command'` renders the command with `CodeBlock`.
-- `operation.kind: 'patch'` renders the supplied unified patch as diff code.
-- `operation.argsPreview` renders through `PayloadInspector`; oversized previews
-  are replaced with a bounded truncation notice before rendering.
-- `env` renders variable names only. Values are not accepted and are stripped if
-  a caller accidentally passes `NAME=value`.
-
-## Approval states
-
-Pending requests render action buttons. Non-pending requests render a read-only
-summary. When `expiresAt` passes while `state` is still `pending`, the effective
-state becomes `expired`, actions disappear, and no callback fires automatically.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                 | Type                                                                                                                                                                                                                                                                                                                                              | Required | Default | Description                                                                                                                                              |
-| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `class`              | `string`                                                                                                                                                                                                                                                                                                                                          | no       | —       | Additional CSS classes applied to the root element.                                                                                                      |
-| `editableArgs`       | `boolean`                                                                                                                                                                                                                                                                                                                                         | no       | —       | Whether approving with edited JSON arguments is available. Default `false`.                                                                              |
-| `env`                | `string`[]                                                                                                                                                                                                                                                                                                                                        | no       | —       | Environment variable names only. Values are ignored if accidentally supplied as `NAME=value`.                                                            |
-| `expiresAt`          | `string`                                                                                                                                                                                                                                                                                                                                          | no       | —       | Optional ISO timestamp after which a pending approval is treated as expired.                                                                             |
-| `idempotencyKey`     | `string`                                                                                                                                                                                                                                                                                                                                          | yes      | —       | Idempotency key that makes repeated decisions durable.                                                                                                   |
-| `operation`          | { argsPreview?: `unknown`; command: `string`; filesTouched?: `string`[]; kind: `"command"` } \| { argsPreview?: `unknown`; filesTouched: `string`[]; kind: `"file-write"` } \| { argsPreview?: `unknown`; diff: `string`; filesTouched?: `string`[]; kind: `"patch"` } \| { argsPreview?: `unknown`; filesTouched?: `string`[]; kind: `"other"` } | yes      | —       | Operation details shown to the approver.                                                                                                                 |
-| `policyVersion`      | `string`                                                                                                                                                                                                                                                                                                                                          | yes      | —       | Policy version that produced the approval request.                                                                                                       |
-| `sandbox`            | { name: `string`; provider: `string`; workingDir: `string` }                                                                                                                                                                                                                                                                                      | no       | —       | Optional sandbox context in which the operation will run.                                                                                                |
-| `snapshotId`         | `string`                                                                                                                                                                                                                                                                                                                                          | no       | —       | Snapshot identifier for the pending approval context.                                                                                                    |
-| `state`              | `"pending"` \| `"approved"` \| `"approved_with_edits"` \| `"denied"` \| `"expired"` \| `"cancelled"`                                                                                                                                                                                                                                              | yes      | —       | Persisted approval state.                                                                                                                                |
-| `tool`               | { name: `string`; risk: `"low"` \| `"medium"` \| `"high"` }                                                                                                                                                                                                                                                                                       | yes      | —       | Tool requesting approval.                                                                                                                                |
-| `onapprove`          | `(opaque)`                                                                                                                                                                                                                                                                                                                                        | no       | —       | Called when the approver accepts the operation as presented. Not expressible in JSON Schema; see the component types for the signature.                  |
-| `onapprovewithedits` | `(opaque)`                                                                                                                                                                                                                                                                                                                                        | no       | —       | Called with parsed JSON arguments when the approver accepts edited arguments. Not expressible in JSON Schema; see the component types for the signature. |
-| `oncancel`           | `(opaque)`                                                                                                                                                                                                                                                                                                                                        | no       | —       | Called when the approver cancels the approval prompt. Not expressible in JSON Schema; see the component types for the signature.                         |
-| `ondeny`             | `(opaque)`                                                                                                                                                                                                                                                                                                                                        | no       | —       | Called when the approver denies the operation. Not expressible in JSON Schema; see the component types for the signature.                                |
-| `onremember`         | `(opaque)`                                                                                                                                                                                                                                                                                                                                        | no       | —       | Called when the approver asks the host application to remember the decision. 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/area-chart/README.md

@@ -1,64 +0,0 @@
-# AreaChart
-
-Filled SVG area chart for showing magnitude and cumulative trends across an ordered x domain.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { AreaChart } from '@lostgradient/cinder/area-chart';
-</script>
-```
-
-## Guidance
-
-### Use When
-
-- Showing magnitude under a trend line.
-- Comparing cumulative or stacked contribution over an ordered domain.
-
-### Avoid When
-
-- Exact point comparison matters more than area magnitude — use line-chart instead.
-- Comparing discrete category totals — use bar-chart instead.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                       | Type                                                                                                                   | Required | Default | Description                                                                                                                |
-| -------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `class`                    | `string`                                                                                                               | no       | —       | Custom class applied to the root element.                                                                                  |
-| `dataTableCaption`         | `string`                                                                                                               | no       | —       | Custom data table caption; falls back to `label`.                                                                          |
-| `dataTableVisibility`      | `"screen-reader-only"` \| `"visible"` \| `"hidden"`                                                                    | no       | —       | Controls data table visibility. Default `screen-reader-only`.                                                              |
-| `description`              | `string`                                                                                                               | no       | —       | Optional description rendered below the label.                                                                             |
-| `height`                   | `number`                                                                                                               | no       | —       | Pixel height of the chart viewport. Default `280`.                                                                         |
-| `hiddenSeriesIds`          | `string`[]                                                                                                             | no       | —       | IDs of series currently hidden from the chart. Can be two-way bound with `bind:hiddenSeriesIds`.                           |
-| `label`                    | `string`                                                                                                               | yes      | —       | Accessible label for the chart. Required for screen readers.                                                               |
-| `legendPosition`           | `"top"` \| `"bottom"` \| `"none"`                                                                                      | no       | —       | Where to render the series legend relative to the chart. Default `top`.                                                    |
-| `loading`                  | `boolean`                                                                                                              | no       | —       | Whether the chart is in a loading state. Default `false`.                                                                  |
-| `maximumInteractivePoints` | `number`                                                                                                               | no       | —       | Maximum number of interactive focus targets before keyboard navigation is disabled. Default `500`.                         |
-| `mode`                     | `"single"` \| `"stacked"`                                                                                              | no       | —       | Area rendering mode. Default `single`.                                                                                     |
-| `series`                   | ({ color?: `string`; data: ({ x: `string` \| `number`; y?: `number` \| `null` })[]; id: `string`; label: `string` })[] | yes      | —       | Series rendered as independent filled areas or stacked areas.                                                              |
-| `xAxis`                    | { label?: `string`; tickCount?: `number` }                                                                             | no       | —       | Configuration for the x-axis label and tick count.                                                                         |
-| `yAxis`                    | { label?: `string`; tickCount?: `number` }                                                                             | no       | —       | Configuration for the y-axis label and tick count.                                                                         |
-| `empty`                    | `(opaque)`                                                                                                             | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `loadingContent`           | `(opaque)`                                                                                                             | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact 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/aspect-ratio/README.md

@@ -1,54 +0,0 @@
-# AspectRatio
-
-Generic wrapper that preserves a fixed aspect ratio for arbitrary embedded content using the native CSS `aspect-ratio` property.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import AspectRatio from '@lostgradient/cinder/aspect-ratio';
-</script>
-
-<AspectRatio>
-  <div>Media content</div>
-</AspectRatio>
-```
-
-For iframe and video embeds, make the child fill the positioned wrapper:
-
-```svelte
-<AspectRatio ratio="16 / 9">
-  <iframe
-    title="Example video"
-    src="https://example.com/embed"
-    style="position: absolute; inset: 0; inline-size: 100%; block-size: 100%; border: 0;"
-  ></iframe>
-</AspectRatio>
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop       | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Required | Default    | Description                                                                                                                |
-| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `as`       | `"object"` \| `"a"` \| `"abbr"` \| `"address"` \| `"article"` \| `"aside"` \| `"audio"` \| `"b"` \| `"bdi"` \| `"bdo"` \| `"blockquote"` \| `"body"` \| `"button"` \| `"canvas"` \| `"caption"` \| `"cite"` \| `"code"` \| `"colgroup"` \| `"data"` \| `"datalist"` \| `"dd"` \| `"del"` \| `"details"` \| `"dfn"` \| `"dialog"` \| `"div"` \| `"dl"` \| `"dt"` \| `"em"` \| `"fieldset"` \| `"figcaption"` \| `"figure"` \| `"footer"` \| `"form"` \| `"h1"` \| `"h2"` \| `"h3"` \| `"h4"` \| `"h5"` \| `"h6"` \| `"head"` \| `"header"` \| `"hgroup"` \| `"html"` \| `"i"` \| `"iframe"` \| `"ins"` \| `"kbd"` \| `"label"` \| `"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       | `"div"`    | Element tag to render.                                                                                                     |
-| `class`    | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | no       | —          | Additional classes merged onto the root element.                                                                           |
-| `overflow` | `"hidden"` \| `"visible"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | no       | `"hidden"` | Overflow behavior for overflowing content.                                                                                 |
-| `ratio`    | `string` \| `number`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | no       | `"16/9"`   | Aspect ratio to apply. Accepts any valid native CSS aspect-ratio value.                                                    |
-| `children` | `(opaque)`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | yes      | —          | Required content rendered inside the ratio box. 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 -->
-<!-- generated:subcomponents:end -->

package/src/components/autocomplete/README.md

@@ -1,47 +0,0 @@
-# Autocomplete
-
-Free-form text input with suggestion hints.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import Autocomplete from '@lostgradient/cinder/autocomplete';
-</script>
-
-<Autocomplete />
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                    | Type       | Required | Default | Description                                                                                                                |
-| ----------------------- | ---------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `class`                 | `string`   | no       | —       | Additional class names merged onto the root wrapper element.                                                               |
-| `description`           | `string`   | no       | —       | Helper text rendered below the input and associated via `aria-describedby`.                                                |
-| `disabled`              | `boolean`  | no       | —       | When true, disables the input and prevents interaction, matching the native `disabled` attribute.                          |
-| `emptyMessage`          | `string`   | no       | —       | Message shown in the listbox when the suggestion source returns no results. Default `"No suggestions"`.                    |
-| `error`                 | `string`   | no       | —       | Error message rendered below the input; also sets `aria-invalid` on the input.                                             |
-| `id`                    | `string`   | no       | —       | HTML `id` for the underlying input, used to associate the `<label>` and ARIA attributes.                                   |
-| `label`                 | `string`   | no       | —       | Visible label text rendered above the input and linked via `for`/`id`.                                                     |
-| `loadingMessage`        | `string`   | no       | —       | Message shown in the listbox while the suggestion source is fetching results. Default `"Loading suggestions"`.             |
-| `maxVisibleSuggestions` | `number`   | no       | —       | Maximum number of suggestions rendered in the listbox at once. Default `50`.                                               |
-| `minQueryLength`        | `number`   | no       | —       | Minimum number of characters the user must type before suggestions are requested. Default `1`.                             |
-| `placeholder`           | `string`   | no       | —       | Placeholder text shown inside the input when it is empty.                                                                  |
-| `readonly`              | `boolean`  | no       | —       | When true, the input value cannot be changed by the user, matching the native `readonly` attribute.                        |
-| `required`              | `boolean`  | no       | —       | Marks the input as required for form validation, matching the native `required` attribute.                                 |
-| `value`                 | `string`   | no       | —       | Bindable current text value of the input.                                                                                  |
-| `oncomplete`            | `(opaque)` | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `oninput`               | `(opaque)` | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `suggestionSource`      | `(opaque)` | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-This component does not declare any local CSS variables.
-
-<!-- generated:variables:end -->

package/src/components/avatar/README.md

@@ -1,44 +0,0 @@
-# Avatar
-
-Displays a user's profile photo, initials, or fallback icon at a consistent size.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import Avatar from '@lostgradient/cinder/avatar';
-</script>
-
-<Avatar />
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop    | Type                                           | Required | Default | Description                                                                                                                     |
-| ------- | ---------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `alt`   | `string`                                       | no       | —       | Alternative text for the image. Defaults to `name` when present.                                                                |
-| `name`  | `string`                                       | no       | —       | Display name used to compute initials when no image is available. Also used as the default `alt` for the image.                 |
-| `shape` | `"circle"` \| `"square"`                       | no       | —       | Shape. Default `circle`.                                                                                                        |
-| `size`  | `"xs"` \| `"sm"` \| `"md"` \| `"lg"` \| `"xl"` | no       | —       | Size token. Default `md`.                                                                                                       |
-| `src`   | `string`                                       | no       | —       | Image source. When omitted, the initials fallback renders.                                                                      |
-| `class` | `(opaque)`                                     | no       | —       | Additional class names merged with `.cinder-avatar`. 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/avatar-group/README.md

@@ -1,44 +0,0 @@
-# AvatarGroup
-
-Overlapping collaborator stack built on Avatar, with focusable names and an overflow count.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import AvatarGroup from '@lostgradient/cinder/avatar-group';
-</script>
-
-<AvatarGroup avatars={[{ name: 'Ada Lovelace' }, { name: 'Grace Hopper' }]} />
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop            | Type                                                | Required | Default           | Description                                                                      |
-| --------------- | --------------------------------------------------- | -------- | ----------------- | -------------------------------------------------------------------------------- |
-| `avatars`       | { id?: `string`; name: `string`; src?: `string` }[] | yes      | —                 | Collaborators to render in the stack.                                            |
-| `class`         | `string`                                            | no       | —                 | Additional class names merged with `.cinder-avatar-group`.                       |
-| `label`         | `string`                                            | no       | `"Collaborators"` | Accessible name for the avatar stack list.                                       |
-| `maxVisible`    | `number`                                            | no       | `5`               | Maximum visible avatars before overflow.                                         |
-| `overflowLabel` | `string`                                            | no       | —                 | Accessible label for the overflow indicator.                                     |
-| `overlap`       | `string`                                            | no       | `"0.75rem"`       | Non-negative CSS length token for the amount each item overlaps its predecessor. |
-| `shape`         | `"circle"` \| `"square"`                            | no       | `"circle"`        | Shape forwarded to each visible Avatar.                                          |
-| `size`          | `"xs"` \| `"sm"` \| `"md"` \| `"lg"` \| `"xl"`      | no       | `"md"`            | Size token forwarded to each visible Avatar.                                     |
-| `zOrder`        | `"first-on-top"` \| `"last-on-top"`                 | no       | `"last-on-top"`   | Stacking order for visible avatars.                                              |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-- `--cinder-avatar-group-overlap`
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-<!-- generated:subcomponents:end -->

package/src/components/backdrop/README.md

@@ -1,56 +0,0 @@
-# Backdrop
-
-Full-viewport fixed scrim primitive for custom overlay patterns such as loading dimmers and image lightboxes.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { Backdrop } from '@lostgradient/cinder/backdrop';
-</script>
-```
-
-## Guidance
-
-### Use When
-
-- Providing a full-screen dimming layer behind a custom overlay that is not modal, drawer, or sheet.
-- Building a loading state that dims the full viewport while an async operation runs.
-
-### Avoid When
-
-- Interrupting the user for a decision — use modal or alert-dialog which manage focus and Escape automatically.
-- Showing a side panel — use drawer instead.
-- Showing structured content in a dialog — use modal, drawer, or sheet, which render their own native `<dialog>::backdrop` scrim.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                 | Type       | Required | Default | Description                                                                                                                                                |
-| -------------------- | ---------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `class`              | `string`   | no       | —       | Additional class names merged onto the root element.                                                                                                       |
-| `invisible`          | `boolean`  | no       | `false` | When true the backdrop is transparent but still captures pointer events, enabling click-to-close without dimming content behind it.                        |
-| `lockScroll`         | `boolean`  | no       | `true`  | Lock body scroll while the backdrop is open (counted lock — safe to nest with other overlays). Set false when the consumer manages scrolling itself.       |
-| `open`               | `boolean`  | yes      | —       | Whether the backdrop is visible and active.                                                                                                                |
-| `transitionDuration` | `number`   | no       | —       | Enter/leave animation duration in milliseconds. Collapses to 0 under `prefers-reduced-motion`. Overrides the default when provided.                        |
-| `children`           | `(opaque)` | no       | —       | Optional content rendered above the scrim (e.g. a Spinner for a loading state). Not expressible in JSON Schema; see the component types for the signature. |
-| `onclick`            | `(opaque)` | no       | —       | Click handler — use this to wire click-to-close on the scrim. 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/badge/README.md

@@ -1,46 +0,0 @@
-# Badge
-
-A small inline label for status, category, or count display.
-
-Use Badge for attached counts, statuses, and compact annotations; use `Chip mode="display"` when the item is an issue label or tag.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import Badge from '@lostgradient/cinder/badge';
-</script>
-
-<Badge variant="success">Published</Badge>
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                | Type                                                                                      | Required | Default     | Description                                                                                                                                                                                          |
-| ------------------- | ----------------------------------------------------------------------------------------- | -------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `class`             | `string`                                                                                  | no       | —           | Custom class merged with `.cinder-badge`.                                                                                                                                                            |
-| `mono`              | `boolean`                                                                                 | no       | `false`     | Render the badge label in a monospace font. Useful for version strings, error codes, or other technical labels.                                                                                      |
-| `size`              | `"xs"` \| `"sm"` \| `"md"`                                                                | no       | `"md"`      | Size of the badge.                                                                                                                                                                                   |
-| `subscriptionState` | `"active"` \| `"trialing"` \| `"past-due"` \| `"canceled"` \| `"expired"` \| `"refunded"` | no       | —           | Render a standardized subscription lifecycle badge without hand-wiring tone, icon, and label.                                                                                                        |
-| `variant`           | `"neutral"` \| `"success"` \| `"warning"` \| `"danger"` \| `"info"` \| `"accent"`         | no       | `"neutral"` | Visual style.                                                                                                                                                                                        |
-| `children`          | `(opaque)`                                                                                | no       | —           | Required badge content unless subscriptionState is provided; optional content override for the subscription preset 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 -->