@lostgradient/cinder 0.4.0 → 0.5.0

package/src/components/input/README.md

@@ -1,52 +0,0 @@
-# Input
-
-Single-line text input with support for labels, addons, validation states, and helper text.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import Input from '@lostgradient/cinder/input';
-</script>
-
-<Input />
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                  | Type                                                                                                | Required | Default | Description                                                                                                                                                                             |
-| --------------------- | --------------------------------------------------------------------------------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `description`         | `string`                                                                                            | no       | —       | Helper text rendered below the input and associated via `aria-describedby`.                                                                                                             |
-| `disabled`            | `boolean`                                                                                           | no       | —       | When true, disables the input, matching the native `disabled` attribute.                                                                                                                |
-| `error`               | `string`                                                                                            | no       | —       | Error message rendered below the input; also sets `aria-invalid` on the input.                                                                                                          |
-| `id`                  | `string`                                                                                            | yes      | —       | HTML `id` for the underlying input, used to associate the `<label>` and ARIA attributes. Required.                                                                                      |
-| `label`               | `string`                                                                                            | no       | —       | Visible label text rendered above the input and linked via `for`/`id`.                                                                                                                  |
-| `leadingInteractive`  | `boolean`                                                                                           | no       | —       | When true, the leading adornment is interactive and included in the accessibility tree. Default `false`.                                                                                |
-| `required`            | `boolean`                                                                                           | no       | —       | Marks the input as required for form validation, matching the native `required` attribute.                                                                                              |
-| `trailingInteractive` | `boolean`                                                                                           | no       | —       | When true, the trailing adornment is interactive and included in the accessibility tree. Default `false`.                                                                               |
-| `type`                | `"number"` \| `"date"` \| `"email"` \| `"password"` \| `"search"` \| `"tel"` \| `"text"` \| `"url"` | no       | —       | Input type controlling the browser's built-in validation and keyboard. Default `"text"`.                                                                                                |
-| `class`               | `(opaque)`                                                                                          | no       | —       | A prop whose shape is not captured by the JSON schema; see the component types for the exact signature.                                                                                 |
-| `leading`             | `(opaque)`                                                                                          | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature.                                                              |
-| `onValueChange`       | `(opaque)`                                                                                          | no       | —       | Intercept a proposed value 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. |
-| `trailing`            | `(opaque)`                                                                                          | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature.                                                              |
-| `value`               | `(opaque)`                                                                                          | yes      | —       | Bindable current text value of the input. 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/invocation-rule-builder/README.md

@@ -1,128 +0,0 @@
-# InvocationRuleBuilder
-
-A presentation component for building and reviewing conditional automation rules. Each rule is composed of one or more conditions (field / operator / value) and one or more actions (a target agent or service). Cinder renders the UI and reports every edit through a callback — it owns no rule execution, persistence, or validation semantics.
-
-## Ownership boundary
-
-Cinder does not execute, validate, or persist rules. The consumer provides the complete rule model through the `rules` prop and handles every change emitted by `onchange`. Cinder is responsible only for rendering the controls with correct accessible names and emitting pure (non-mutating) change descriptors.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { InvocationRuleBuilder } from '@lostgradient/cinder/invocation-rule-builder';
-  import type {
-    InvocationRule,
-    InvocationRuleChange,
-    InvocationRuleOption,
-  } from '@lostgradient/cinder/invocation-rule-builder';
-
-  let rules = $state<InvocationRule[]>([]);
-
-  const fieldOptions: InvocationRuleOption[] = [
-    { value: 'path', label: 'Path' },
-    { value: 'label', label: 'Label' },
-    { value: 'author', label: 'Author' },
-  ];
-
-  const operatorOptions: InvocationRuleOption[] = [
-    { value: 'matches', label: 'matches' },
-    { value: 'is', label: 'is' },
-    { value: 'is-not', label: 'is not' },
-  ];
-
-  const actionOptions: InvocationRuleOption[] = [
-    { value: 'security-review', label: 'Security Review Agent' },
-    { value: 'code-review', label: 'Code Review Agent' },
-  ];
-
-  function handleChange(nextRules: InvocationRule[], change: InvocationRuleChange): void {
-    rules = nextRules;
-    // Persist or validate here — cinder does not do this for you.
-  }
-</script>
-
-<InvocationRuleBuilder
-  {rules}
-  onchange={handleChange}
-  {fieldOptions}
-  {operatorOptions}
-  {actionOptions}
-  label="PR routing rules"
-/>
-```
-
-## Data model
-
-```ts
-type InvocationRule = {
-  id: string;
-  label: string;
-  conditions: InvocationRuleCondition[];
-  actions: InvocationRuleAction[];
-};
-
-type InvocationRuleCondition = {
-  id: string;
-  field: string; // consumer-defined, e.g. "path"
-  operator: string; // consumer-defined, e.g. "matches"
-  value: string; // consumer-defined, e.g. "src/**"
-};
-
-type InvocationRuleAction = {
-  id: string;
-  target: string; // consumer-defined, e.g. "security-review"
-};
-```
-
-A rule fires when ALL of its conditions match (implicit AND). Boolean grouping, OR logic, and nested condition trees are out of scope for this component.
-
-## Modes
-
-Pass `readonly={true}` to render a read-only summary instead of editable controls. Schema-driven usage is read-only because callbacks are not representable in JSON Schema. Runtime consumers can render editable controls by passing `onchange` and leaving `readonly` false.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                | Type                                                                                                                                                                     | Required | Default | Description                                                                                                                                                                                                                                                                                                                                             |
-| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `actionOptions`     | { label: `string`; value: `string` }[]                                                                                                                                   | yes      | —       | Options for the action target selector. Consumer-provided list of targets, e.g. review-agent slugs or step identifiers.                                                                                                                                                                                                                                 |
-| `addActionLabel`    | `string`                                                                                                                                                                 | no       | —       | Label for the "Add action" button. Defaults to "Add action".                                                                                                                                                                                                                                                                                            |
-| `addConditionLabel` | `string`                                                                                                                                                                 | no       | —       | Label for the "Add condition" button. Defaults to "Add condition".                                                                                                                                                                                                                                                                                      |
-| `addRuleLabel`      | `string`                                                                                                                                                                 | no       | —       | Label for the "Add rule" button. Defaults to "Add rule".                                                                                                                                                                                                                                                                                                |
-| `class`             | `string`                                                                                                                                                                 | no       | —       | Additional CSS classes applied to the root element.                                                                                                                                                                                                                                                                                                     |
-| `fieldOptions`      | { label: `string`; value: `string` }[]                                                                                                                                   | yes      | —       | Options for the condition field selector. Consumer-provided list of fields that a condition can test, e.g. "path", "label", "author".                                                                                                                                                                                                                   |
-| `label`             | `string`                                                                                                                                                                 | no       | —       | Accessible label for the entire rule builder region.                                                                                                                                                                                                                                                                                                    |
-| `operatorOptions`   | { label: `string`; value: `string` }[]                                                                                                                                   | yes      | —       | Options for the condition operator selector. Consumer-provided list of operators, e.g. "matches", "is", "is-not", "contains".                                                                                                                                                                                                                           |
-| `readonly`          | `true`                                                                                                                                                                   | yes      | —       | Must be true for schema-driven usage because editable mode requires the unsupported `onchange` callback. Runtime consumers may omit this when passing `onchange` directly.                                                                                                                                                                              |
-| `rules`             | { actions: { id: `string`; target: `string` }[]; conditions: { field: `string`; id: `string`; operator: `string`; value: `string` }[]; id: `string`; label: `string` }[] | yes      | —       | The current list of automation rules. Controlled — pass the updated list returned from `onchange` back into this prop to commit a change.                                                                                                                                                                                                               |
-| `onchange`          | `(opaque)`                                                                                                                                                               | no       | —       | Called whenever the user makes any edit. Required for editable runtime usage because editable controls must commit controlled state changes. Receives the next rule array (pure, not mutated) and a change descriptor. Consumer owns persistence, validation, and execution. 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 -->
-
-## Accessibility
-
-Each condition's field selector, operator selector, value input, and remove button carry accessible labels that identify which condition and rule they belong to (e.g. "Field for condition 2 of Rule 1"). Each action's target selector and remove button are similarly labeled. Rule reorder buttons are labeled "Move Rule 1 up" and "Move Rule 1 down". Add buttons describe their destination rule. A live region announces add, remove, and move events to screen reader users.
-
-In readonly mode all controls are replaced by visible text, so no interaction is possible and keyboard navigation follows the natural document order.
-
-Focus management on remove: when a condition or action row is removed, focus moves to the preceding row's remove button, or to the "Add condition" / "Add action" button if the removed row was the last one.
-
-The component uses semantic HTML: the root is a `section` with an `aria-label`, condition and action lists use `role="list"` with `aria-labelledby` pointing to the "Conditions" / "Actions" section heading, and each row uses `role="listitem"`.

package/src/components/json-schema-editor/README.md

@@ -1,59 +0,0 @@
-# JsonSchemaEditor
-
-Multi-view editor for authoring JSON Schema documents with form, raw JSON, and diff modes plus undo history and validation.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { JsonSchemaEditor } from '@lostgradient/cinder/json-schema-editor';
-</script>
-```
-
-## Guidance
-
-### Use When
-
-- Letting users edit a JSON Schema with a guided form alongside the raw source.
-- Reviewing schema changes against a baseline via the built-in diff view.
-
-### Avoid When
-
-- Editing arbitrary free-form JSON with no schema semantics — use a plain code editor instead.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop            | Type                                       | Required | Default | Description                                                                                                                                          |
-| --------------- | ------------------------------------------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `class`         | `string`                                   | no       | —       | Additional class merged onto the `.cinder-jse` root element.                                                                                         |
-| `draftOverride` | `"2020-12"` \| `"2019-09"` \| `"draft-07"` | no       | —       | Force a draft override regardless of $schema.                                                                                                        |
-| `id`            | `string`                                   | yes      | —       | Required for ARIA wiring.                                                                                                                            |
-| `maxHistory`    | `number`                                   | no       | —       | Maximum history entries (default 100).                                                                                                               |
-| `readonly`      | `boolean`                                  | no       | —       | Read-only mode disables all mutations.                                                                                                               |
-| `schemaKey`     | `string`                                   | no       | —       | Changing this triggers a full reset (history clears).                                                                                                |
-| `view`          | `"form"` \| `"json"` \| `"diff"`           | no       | —       | Active view: form / json / diff. Bindable.                                                                                                           |
-| `onchange`      | `(opaque)`                                 | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature.                           |
-| `onrevert`      | `(opaque)`                                 | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature.                           |
-| `onvalidate`    | `(opaque)`                                 | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature.                           |
-| `original`      | `(opaque)`                                 | no       | —       | Optional explicit baseline; defaults to the initial `schema`. Not expressible in JSON Schema; see the component types for the signature.             |
-| `schema`        | `(opaque)`                                 | yes      | —       | The schema being edited. May be a string (JSON text) or pre-parsed value. 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/json-viewer/README.md

@@ -1,43 +0,0 @@
-# JsonViewer
-
-Collapsible tree visualization of an arbitrary JSON value with hard depth and byte caps and a fallback for oversized payloads.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import JsonViewer from '@lostgradient/cinder/json-viewer';
-</script>
-
-<JsonViewer value={{ status: 'ok', items: [1, 2, 3] }} />
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop           | Type       | Required | Default | Description                                                                                                                      |
-| -------------- | ---------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `class`        | `string`   | no       | —       | Additional class names merged with `.cinder-json-viewer`.                                                                        |
-| `initialDepth` | `number`   | no       | —       | Initial collapse depth. Nodes deeper than this start collapsed. Default 1.                                                       |
-| `maxBytes`     | `number`   | no       | —       | Hard byte cap on the serialized payload. Default 1_048_576 (1 MB).                                                               |
-| `maxDepth`     | `number`   | no       | —       | Hard depth cap. Nodes deeper than this never render their children. Default 50.                                                  |
-| `value`        | `(opaque)` | yes      | —       | The value to render. Any JSON-serializable structure. 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/kanban-board/README.md

@@ -1,62 +0,0 @@
-# KanbanBoard
-
-Controlled multi-column board for reordering cards within and across workflow columns with keyboard, pointer, and live-region feedback.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { KanbanBoard } from '@lostgradient/cinder/kanban-board';
-</script>
-```
-
-## Guidance
-
-### Use When
-
-- Presenting a workflow board where users move cards between ordered columns.
-- Consumers own card rendering and need cinder to manage reorder affordances and change metadata.
-
-### Avoid When
-
-- Showing a single ordered list — use sortable-list instead.
-- Sorting by computed fields rather than direct manual placement.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop             | Type       | Required | Default | Description                                                                                                                |
-| ---------------- | ---------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `class`          | `string`   | no       | —       | Additional class merged onto the `.cinder-kanban-board` root element.                                                      |
-| `collapsible`    | `boolean`  | no       | —       | When true, each column renders a collapse/expand button that toggles its card list.                                        |
-| `label`          | `string`   | no       | —       | Accessible label applied to the board's `<section>` root via `aria-label`.                                                 |
-| `reorderColumns` | `boolean`  | no       | —       | When true (default), columns can be reordered by dragging or keyboard. Set to false to make column order fixed.            |
-| `card`           | `(opaque)` | yes      | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `columnActions`  | `(opaque)` | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `columnHeader`   | `(opaque)` | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `columns`        | `(opaque)` | yes      | —       | A prop whose shape is not captured by the JSON schema; see the component types for the exact signature.                    |
-| `emptyColumn`    | `(opaque)` | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `getCardKey`     | `(opaque)` | yes      | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `getCardLabel`   | `(opaque)` | yes      | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `onchange`       | `(opaque)` | yes      | —       | 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-kanban-card-background`
-- `--cinder-kanban-column-background`
-- `--cinder-kanban-column-gap`
-- `--cinder-kanban-column-width`
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-None.
-
-<!-- generated:subcomponents:end -->

package/src/components/kbd/README.md

@@ -1,42 +0,0 @@
-# Kbd
-
-A styled keyboard key element for displaying keyboard shortcuts in help text and command palettes.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import Kbd from '@lostgradient/cinder/kbd';
-</script>
-
-<Kbd label="⌘K" />
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop       | Type             | Required | Default | Description                                                                                   |
-| ---------- | ---------------- | -------- | ------- | --------------------------------------------------------------------------------------------- |
-| `class`    | `string`         | no       | —       | Additional class names merged with `.cinder-kbd`.                                             |
-| `label`    | `string`         | no       | —       | Key label content.                                                                            |
-| `size`     | `"sm"` \| `"md"` | no       | `"md"`  | Keyboard key size.                                                                            |
-| `children` | `(opaque)`       | no       | —       | Key label 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 -->

package/src/components/keyboard-shortcuts/README.md

@@ -1,51 +0,0 @@
-# KeyboardShortcuts
-
-Grouped keyboard-shortcut reference that renders key combos via Kbd with accessible labels not reliant only on visual keycaps.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { KeyboardShortcuts } from '@lostgradient/cinder/keyboard-shortcuts';
-</script>
-```
-
-## Guidance
-
-### Use When
-
-- Displaying a reference panel of keyboard shortcuts grouped by feature area.
-- Embedding a shortcut table inside a modal, sheet, popover, or help page.
-
-### Avoid When
-
-- Showing a single inline shortcut hint — use shortcut-hint instead.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop       | Type       | Required | Default | Description                                                                                                         |
-| ---------- | ---------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
-| `class`    | `string`   | no       | —       | Additional class names merged with `.cinder-keyboard-shortcuts`.                                                    |
-| `heading`  | `string`   | no       | —       | Optional heading for the entire shortcuts panel.                                                                    |
-| `children` | `(opaque)` | no       | —       | Intro content rendered above the groups. Not expressible in JSON Schema; see the component types for the signature. |
-| `groups`   | `(opaque)` | yes      | —       | Groups of shortcuts to display. 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/label/README.md

@@ -1,43 +0,0 @@
-# Label
-
-Accessible form label that associates descriptive text with its input element.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import Label from '@lostgradient/cinder/label';
-</script>
-
-<Label for="my-input">Email address</Label>
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop       | Type       | Required | Default | Description                                                                                                                    |
-| ---------- | ---------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
-| `disabled` | `boolean`  | no       | —       | When true, render the label in the disabled color treatment.                                                                   |
-| `for`      | `string`   | yes      | —       | The id of the form control this label labels. Sets `for` on the rendered `<label>`.                                            |
-| `required` | `boolean`  | no       | —       | When true, append a visual indicator that the field is required.                                                               |
-| `children` | `(opaque)` | yes      | —       | The label text or composed content. Not expressible in JSON Schema; see the component types for the signature.                 |
-| `class`    | `(opaque)` | no       | —       | Additional class names merged with `.cinder-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/line-chart/README.md

@@ -1,63 +0,0 @@
-# LineChart
-
-Responsive SVG line chart for comparing one or more numeric series over an ordered x domain.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { LineChart } from '@lostgradient/cinder/line-chart';
-</script>
-```
-
-## Guidance
-
-### Use When
-
-- Showing trends over time or another ordered domain.
-- Comparing several metric series on the same numeric axis.
-
-### Avoid When
-
-- Comparing discrete category totals — use bar-chart instead.
-- Showing cumulative filled trends — use area-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`.                         |
-| `series`                   | ({ color?: `string`; data: ({ x: `string` \| `number`; y?: `number` \| `null` })[]; id: `string`; label: `string` })[] | yes      | —       | Series to render as one or more connected line paths.                                                                      |
-| `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/link/README.md

@@ -1,55 +0,0 @@
-# Link
-
-Inline text link with consistent focus ring and underline behavior.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { Link } from '@lostgradient/cinder/link';
-</script>
-```
-
-## Guidance
-
-### Use When
-
-- Embedding a navigable link inside body text or prose content.
-
-### Avoid When
-
-- Navigating between pages in a sidebar or nav bar — use NavigationItem.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop        | Type                                | Required | Default     | Description                                                                                                                                                                                                                                                                                                                       |
-| ----------- | ----------------------------------- | -------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `class`     | `string`                            | no       | —           | Additional class names merged with `.cinder-link`.                                                                                                                                                                                                                                                                                |
-| `color`     | `"primary"` \| `"inherit"`          | no       | `"primary"` | Controls the link color. - `'primary'` — uses the accent/primary color token. - `'inherit'` — inherits the surrounding text color.                                                                                                                                                                                                |
-| `disabled`  | `boolean`                           | no       | `false`     | When true, renders a `<span aria-disabled="true">` instead of `<a>`. The href is not emitted and pointer-events are disabled. Use to show a link that is contextually unavailable without removing it from the visual layout.                                                                                                     |
-| `external`  | `boolean`                           | no       | `false`     | When true, automatically adds `target="_blank"` and merges `rel="noopener noreferrer"` with any consumer-supplied `rel`. Consumer-supplied `target` is preserved if provided.                                                                                                                                                     |
-| `href`      | `string`                            | no       | —           | The URL the link points to. Optional ONLY because a `disabled` link renders a `<span>` with no href. For any enabled (non-disabled) link you must provide it — an `<a>` without `href` is not keyboard-focusable and is not exposed as a link to assistive technology, so an enabled Link without `href` is a bug, not a feature. |
-| `rel`       | `string` \| `null`                  | no       | —           | Forwarded to the rendered `<a>`. `"noopener noreferrer"` is merged in whenever the link opens in a new tab — `external` is true OR the resolved target is `"_blank"` (case-insensitive) — and the whole value is de-duplicated case-insensitively.                                                                                |
-| `underline` | `"always"` \| `"hover"` \| `"none"` | no       | `"hover"`   | Controls text-decoration behavior. - `'always'` — underline is always visible. - `'hover'` — underline appears on hover and focus (default). - `'none'` — underline is never shown.                                                                                                                                               |
-| `children`  | `(opaque)`                          | yes      | —           | The link text or composed content. Required. Not expressible in JSON Schema; see the component types for the signature.                                                                                                                                                                                                           |
-| `target`    | `(opaque)`                          | no       | —           | Forwarded to the rendered `<a>`. `external` supplies `"_blank"` only when no target is given. 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 -->