@lostgradient/cinder 0.4.0 → 0.5.0

package/src/components/dropdown-label/README.md

@@ -1,38 +0,0 @@
-# DropdownLabel
-
-Non-interactive section heading within a dropdown menu for grouping related items.
-
-## Usage
-
-`DropdownLabel` is a compose-only leaf of [`Dropdown`](../dropdown/README.md).
-The idiomatic API is `Dropdown.Label`, reached through the parent
-namespace — see the [dropdown README](../dropdown/README.md#usage) for the composed
-snippet. The flat `@lostgradient/cinder/dropdown-label` subpath remains exported for
-à-la-carte builds that import the leaf directly.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop       | Type       | Required | Default | Description                                                                                                                |
-| ---------- | ---------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `class`    | `string`   | no       | —       | Additional class names merged with the component's root class.                                                             |
-| `children` | `(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/dropdown-menu/README.md

@@ -1,38 +0,0 @@
-# DropdownMenu
-
-Floating list of actions or options that opens from a trigger element.
-
-## Usage
-
-`DropdownMenu` is a compose-only leaf of [`Dropdown`](../dropdown/README.md).
-The idiomatic API is `Dropdown.Menu`, reached through the parent
-namespace — see the [dropdown README](../dropdown/README.md#usage) for the composed
-snippet. The flat `@lostgradient/cinder/dropdown-menu` subpath remains exported for
-à-la-carte builds that import the leaf directly.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop       | Type       | Required | Default | Description                                                                                                                |
-| ---------- | ---------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `class`    | `string`   | no       | —       | Additional class names merged with the component's root class.                                                             |
-| `children` | `(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/dropdown-separator/README.md

@@ -1,37 +0,0 @@
-# DropdownSeparator
-
-Visual divider between groups of items within a dropdown menu.
-
-## Usage
-
-`DropdownSeparator` is a compose-only leaf of [`Dropdown`](../dropdown/README.md).
-The idiomatic API is `Dropdown.Separator`, reached through the parent
-namespace — see the [dropdown README](../dropdown/README.md#usage) for the composed
-snippet. The flat `@lostgradient/cinder/dropdown-separator` subpath remains exported for
-à-la-carte builds that import the leaf directly.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop    | Type     | Required | Default | Description                                                    |
-| ------- | -------- | -------- | ------- | -------------------------------------------------------------- |
-| `class` | `string` | no       | —       | Additional class names merged with the component's root class. |
-
-<!-- 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/dropdown-trigger/README.md

@@ -1,39 +0,0 @@
-# DropdownTrigger
-
-Activates the associated dropdown menu on click or keyboard interaction.
-
-## Usage
-
-`DropdownTrigger` is a compose-only leaf of [`Dropdown`](../dropdown/README.md).
-The idiomatic API is `Dropdown.Trigger`, reached through the parent
-namespace — see the [dropdown README](../dropdown/README.md#usage) for the composed
-snippet. The flat `@lostgradient/cinder/dropdown-trigger` subpath remains exported for
-à-la-carte builds that import the leaf directly.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop        | Type       | Required | Default | Description                                                                                                                |
-| ----------- | ---------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `class`     | `string`   | no       | —       | Additional class names merged with the component's root class.                                                             |
-| `showCaret` | `boolean`  | no       | —       | Render the trailing disclosure caret. Defaults to true.                                                                    |
-| `children`  | `(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/empty-state/README.md

@@ -1,44 +0,0 @@
-# EmptyState
-
-Placeholder layout for zero-data views, with optional illustration, heading, and action.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import EmptyState from '@lostgradient/cinder/empty-state';
-</script>
-
-<EmptyState />
-```
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop           | Type                                   | Required | Default | Description                                                                                                                |
-| -------------- | -------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `class`        | `string`                               | no       | —       | Additional class merged onto the `.cinder-empty-state` root element.                                                       |
-| `description`  | `string`                               | no       | —       | Secondary descriptive text rendered as a paragraph below the title.                                                        |
-| `headingLevel` | `1` \| `2` \| `3` \| `4` \| `5` \| `6` | no       | `3`     | Heading level for the title element.                                                                                       |
-| `title`        | `string`                               | yes      | —       | Primary heading text rendered as a heading element at the configured `headingLevel`.                                       |
-| `action`       | `(opaque)`                             | no       | —       | 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. |
-
-<!-- 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/event-stream-viewer/README.md

@@ -1,169 +0,0 @@
-# EventStreamViewer
-
-Dense append-only viewer for timestamped operational events. Use it for workflow run logs, job output streams, webhook traces, activity completion feeds, and other real-time or historical event consoles.
-
-## Overview
-
-EventStreamViewer renders a scrollable list of timestamped events, each with a severity tone, optional source label, a one-line summary, and optional expandable JSON details. It handles follow-latest scrolling (auto-scroll to bottom as events arrive), a paused state when the user scrolls away, filtering hooks, copy actions, reconnect boundaries, and sequence-gap markers. Empty, loading, disconnected, and truncated states are built in.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { EventStreamViewer } from '@lostgradient/cinder/event-stream-viewer';
-  import type { StreamEvent } from '@lostgradient/cinder/event-stream-viewer';
-
-  let events: StreamEvent[] = $state([]);
-</script>
-
-<EventStreamViewer {events} label="Workflow run events" connectionState="connected" />
-```
-
-### With filtering
-
-When you pass an `onfilter` callback, the viewer renders a search input. Your component is responsible for filtering the `events` array in response to the callback.
-
-```svelte
-<script lang="ts">
-  import { EventStreamViewer } from '@lostgradient/cinder/event-stream-viewer';
-  import type { StreamEvent } from '@lostgradient/cinder/event-stream-viewer';
-
-  let allEvents: StreamEvent[] = $state([]);
-  let query = $state('');
-
-  const filteredEvents = $derived(
-    query
-      ? allEvents.filter((e) => e.summary.toLowerCase().includes(query.toLowerCase()))
-      : allEvents,
-  );
-</script>
-
-<EventStreamViewer
-  events={filteredEvents}
-  filterQuery={query}
-  onfilter={(q) => {
-    query = q;
-  }}
-  label="Filtered event stream"
-/>
-```
-
-### With copy-visible action
-
-```svelte
-<script lang="ts">
-  import { EventStreamViewer } from '@lostgradient/cinder/event-stream-viewer';
-  import type { StreamEvent } from '@lostgradient/cinder/event-stream-viewer';
-
-  let events: StreamEvent[] = $state([]);
-
-  function handleCopyVisible(text: string) {
-    navigator.clipboard.writeText(text);
-  }
-</script>
-
-<EventStreamViewer {events} oncopyvisible={handleCopyVisible} label="Event stream" />
-```
-
-### Follow-latest with bindable state
-
-The `followLatest` prop is bindable. Bind it to read whether the viewer is paused or to programmatically resume following.
-
-```svelte
-<script lang="ts">
-  import { EventStreamViewer } from '@lostgradient/cinder/event-stream-viewer';
-  import type { StreamEvent } from '@lostgradient/cinder/event-stream-viewer';
-
-  let events: StreamEvent[] = $state([]);
-  let followLatest = $state(true);
-</script>
-
-<p>Status: {followLatest ? 'Following' : 'Paused'}</p>
-<EventStreamViewer {events} bind:followLatest label="Event stream" />
-```
-
-## Event structure
-
-Each event in the `events` array can be a normal `StreamEvent` or an additive reconnect boundary:
-
-```ts
-type StreamEvent = {
-  id: string; // Stable unique identifier (required)
-  sequence?: number; // Optional integer sequence for gap detection
-  datetime: string; // ISO 8601 datetime (required, used for machine-readable time)
-  timestamp?: string; // Human-readable label e.g. "14:32:01" (falls back to datetime)
-  severity?: 'debug' | 'info' | 'success' | 'warning' | 'error';
-  source?: string; // Origin label e.g. "worker-1", "payment-service"
-  summary: string; // One-line event description (required)
-  details?: unknown; // Optional JSON payload rendered in a collapsible JsonViewer
-};
-
-type StreamReconnectedBoundary = {
-  id: string; // Stable unique identifier (required)
-  kind: 'reconnected';
-  datetime?: string; // Optional ISO 8601 reconnect time
-  timestamp?: string; // Optional human-readable reconnect label
-  replayedCount: number; // Number of events replayed after reconnecting
-};
-
-type EventStreamEntry = StreamEvent | StreamReconnectedBoundary;
-```
-
-### Reconnect and gap markers
-
-Pass `EventStreamEntry[]` when a retained stream can resume after a network reconnect. A `{ kind: 'reconnected' }` entry renders a visible divider labeled `Reconnected — N events replayed`.
-
-Set `detectSequenceGaps` only when `events` is the complete, unfiltered stream. When consecutive rendered `StreamEvent` entries both provide integer `sequence` values and the later value is not the previous value plus one, the viewer inserts a sequence-gap marker before the later event. The marker shows the expected and received sequence numbers, for example `Sequence gap — expected 8, received 10`.
-
-The `oncopyvisible` callback includes reconnect and sequence-gap markers in the copied text, so the copied stream preserves the same replay and continuity context users saw on screen.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                 | Type                                                                                                                                                                                                                                                                                                                                         | Required | Default | Description                                                                                                                                                                                                                                                              |
-| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `class`              | `string`                                                                                                                                                                                                                                                                                                                                     | no       | —       | Additional CSS classes applied to the root element.                                                                                                                                                                                                                      |
-| `connectionState`    | `"error"` \| `"connected"` \| `"connecting"` \| `"disconnected"`                                                                                                                                                                                                                                                                             | no       | —       | Current connection state. When provided, renders a StatusDot in the toolbar. Omit when the stream has no live transport.                                                                                                                                                 |
-| `detectSequenceGaps` | `boolean`                                                                                                                                                                                                                                                                                                                                    | no       | —       | Enables sequence-gap markers when `events` is the complete, unfiltered stream. Leave false for retained windows, severity-filtered subsets, search results, or any other caller-trimmed event array.                                                                     |
-| `events`             | ({ datetime: `string`; details?: `unknown`; id: `string`; sequence?: `integer`; severity?: `"debug"` \| `"info"` \| `"success"` \| `"warning"` \| `"error"`; source?: `string`; summary: `string`; timestamp?: `string` } \| { datetime?: `string`; id: `string`; kind: `"reconnected"`; replayedCount: `integer`; timestamp?: `string` })[] | yes      | —       | Events and additive boundary entries to render in chronological order, oldest first.                                                                                                                                                                                     |
-| `filterQuery`        | `string`                                                                                                                                                                                                                                                                                                                                     | no       | —       | Current filter query value, for controlled usage. Pairs with `onfilter`.                                                                                                                                                                                                 |
-| `followLatest`       | `boolean`                                                                                                                                                                                                                                                                                                                                    | no       | —       | When true, new events automatically scroll the list to the bottom. Set to false to pause follow-latest (e.g. while the user reads earlier events). Bindable so the parent can read the paused state the component sets internally.                                       |
-| `label`              | `string`                                                                                                                                                                                                                                                                                                                                     | no       | —       | Accessible label for the event list region. Required for accessibility. Defaults to "Event stream".                                                                                                                                                                      |
-| `loading`            | `boolean`                                                                                                                                                                                                                                                                                                                                    | no       | —       | Show a loading skeleton instead of the event list. Use while the first batch of events is in flight.                                                                                                                                                                     |
-| `truncated`          | `boolean`                                                                                                                                                                                                                                                                                                                                    | no       | —       | Whether to show the "events were truncated" notice. This is a boolean flag, not a count: the viewer never slices `events` itself. Set it to `true` when you have already trimmed the array (e.g. capped retention) and want users to know earlier events are not shown.  |
-| `oncopyvisible`      | `(opaque)`                                                                                                                                                                                                                                                                                                                                   | no       | —       | Callback fired when the user clicks the "Copy visible" toolbar action. Receives the text of all currently visible events. When omitted the copy action is hidden. Not expressible in JSON Schema; see the component types for the signature.                             |
-| `onfilter`           | `(opaque)`                                                                                                                                                                                                                                                                                                                                   | no       | —       | Callback fired when the user updates the filter query in the toolbar's search field. The consumer is responsible for filtering `events` in response. When omitted the filter input is hidden. Not expressible in JSON Schema; see the component types for the signature. |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-- `--cinder-event-stream-viewer-severity-color`
-<!-- generated:variables:end -->
-
-## Accessibility
-
-The viewer exposes a `role="log"` region, which carries implicit polite live-region semantics so screen readers announce newly appended events. The region is keyboard focusable (`tabindex="0"`) to support arrow-key scrolling.
-
-Each event's timestamp is wrapped in a `<time datetime="...">` element with the machine-readable ISO value, so assistive technology can parse the precise moment. The visible label is separate from the machine-readable `datetime` attribute.
-
-Severity tones are conveyed both visually (color bar, badge text) and through an `aria-label` on the badge element. Source labels and summary text are part of the document flow and are read naturally.
-
-The JSON details panel is toggled by a button with `aria-expanded` and `aria-controls`. Copy actions have descriptive `aria-label` attributes.
-
-Reconnect boundaries render as visible dividers with `role="separator"` and a matching accessible label. Sequence gaps render as visible notes with `role="note"` and an accessible label that includes the expected and received sequence numbers.
-
-A visually-hidden live region (always in the DOM, never removed with `{#if}`) announces copy confirmation to screen readers without double-announcing on the interactive buttons.
-
-See `event-stream-viewer.a11y.md` for the full accessibility contract.
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-This component composes `StatusDot`, `CopyButton`, and `JsonViewer` internally. They are not exposed as sub-namespace exports.
-
-<!-- generated:subcomponents:end -->

package/src/components/faceted-filter-bar/README.md

@@ -1,170 +0,0 @@
-# FacetedFilterBar
-
-Composed filtering toolbar with a leading search field, select-based or custom facet controls, removable applied-filter chips, and a clear-all action. Designed for dense operational list views such as workflow queues, failure triage dashboards, and schedule browsers.
-
-## Overview
-
-`FacetedFilterBar` composes `SearchField`, `Chip` (removable mode), and native select controls into one accessible filtering surface. It owns no routing, persistence, or data fetching — it emits change events and the consumer owns the filter state and data loading.
-
-The bar supports two facet types:
-
-- **`select`** — a fixed list of options rendered as a styled native select. Use for status, category, queue, or any enumerable dimension.
-- **`custom`** — a consumer-supplied snippet that renders any control (combobox, date-range picker, etc.) and receives the current value plus a change callback.
-
-Applied filters are displayed as removable chips. A visually-hidden live region announces the active filter count and each applied value to screen readers whenever the filter state changes.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { FacetedFilterBar } from '@lostgradient/cinder/faceted-filter-bar';
-  import type { AppliedFilter, FacetDefinition } from '@lostgradient/cinder/faceted-filter-bar';
-
-  const facets: FacetDefinition[] = [
-    {
-      type: 'select',
-      key: 'status',
-      label: 'Status',
-      placeholder: 'All statuses',
-      options: [
-        { value: 'running', label: 'Running' },
-        { value: 'failed', label: 'Failed' },
-        { value: 'paused', label: 'Paused' },
-      ],
-    },
-    {
-      type: 'select',
-      key: 'queue',
-      label: 'Queue',
-      placeholder: 'All queues',
-      options: [
-        { value: 'default', label: 'Default' },
-        { value: 'priority', label: 'Priority' },
-      ],
-    },
-  ];
-
-  let appliedFilters = $state<AppliedFilter[]>([]);
-  let searchQuery = $state('');
-
-  function handleFacetChange(key: string, value: string) {
-    if (!value) {
-      appliedFilters = appliedFilters.filter((f) => f.key !== key);
-      return;
-    }
-    const facet = facets.find((f) => f.key === key);
-    appliedFilters = [
-      ...appliedFilters.filter((f) => f.key !== key),
-      { key, value, label: facet?.label ?? key },
-    ];
-  }
-
-  function handleFilterRemove(key: string) {
-    appliedFilters = appliedFilters.filter((f) => f.key !== key);
-  }
-
-  function handleClearAll() {
-    appliedFilters = [];
-    searchQuery = '';
-  }
-</script>
-
-<FacetedFilterBar
-  aria-label="Workflow filters"
-  {facets}
-  {appliedFilters}
-  {searchQuery}
-  onsearchchange={(q) => (searchQuery = q)}
-  onfacetchange={handleFacetChange}
-  onfilterremove={handleFilterRemove}
-  onclearall={handleClearAll}
-/>
-```
-
-### Custom facet (snippet escape-hatch)
-
-Use `type: 'custom'` with a `control` snippet for any facet that cannot be expressed as a select list, such as a date-range picker or combobox:
-
-```svelte
-<script lang="ts">
-  import { FacetedFilterBar } from '@lostgradient/cinder/faceted-filter-bar';
-  import type { FacetDefinition } from '@lostgradient/cinder/faceted-filter-bar';
-</script>
-
-{#snippet dateRangeControl({ value, onchange }: { value: string; onchange: (v: string) => void })}
-  <!-- render your date-range control here; call onchange(value) on selection -->
-{/snippet}
-
-<FacetedFilterBar
-  aria-label="Order filters"
-  facets={[
-    {
-      type: 'custom',
-      key: 'dateRange',
-      label: 'Date range',
-      control: dateRangeControl,
-    },
-  ]}
-/>
-```
-
-## Props
-
-| Prop                | Type                                   | Default     | Description                                                                           |
-| ------------------- | -------------------------------------- | ----------- | ------------------------------------------------------------------------------------- |
-| `aria-label`        | `string`                               | `'Filters'` | Accessible label for the filter toolbar region.                                       |
-| `searchQuery`       | `string`                               | —           | Controlled search query. When provided, the search field is controlled by the parent. |
-| `searchPlaceholder` | `string`                               | `'Search…'` | Placeholder text shown in the leading search field.                                   |
-| `searchAriaLabel`   | `string`                               | `'Search'`  | Accessible label for the search input.                                                |
-| `facets`            | `FacetDefinition[]`                    | `[]`        | Facet definitions rendered as filter controls after the search field.                 |
-| `appliedFilters`    | `AppliedFilter[]`                      | `[]`        | Applied filters displayed as removable chips.                                         |
-| `disabled`          | `boolean`                              | `false`     | When true, all filter controls and chips are disabled.                                |
-| `class`             | `string`                               | —           | Additional CSS classes applied to the root element.                                   |
-| `onsearchchange`    | `(query: string) => void`              | —           | Fires when the search query changes.                                                  |
-| `onfacetchange`     | `(key: string, value: string) => void` | —           | Fires when a facet value changes.                                                     |
-| `onfilterremove`    | `(key: string) => void`                | —           | Fires when a specific applied filter chip is removed.                                 |
-| `onclearall`        | `() => void`                           | —           | Fires when the clear-all button is clicked.                                           |
-
-### FacetDefinition
-
-```ts
-// Select facet — fixed options list
-type SelectFacet = {
-  type: 'select';
-  key: string;
-  label: string;
-  placeholder?: string;
-  options: { value: string; label: string; disabled?: boolean }[];
-  disabled?: boolean;
-};
-
-// Custom facet — consumer-supplied snippet
-type CustomFacet = {
-  type: 'custom';
-  key: string;
-  label: string;
-  control: Snippet<[{ value: string; onchange: (value: string) => void }]>;
-};
-```
-
-### AppliedFilter
-
-```ts
-type AppliedFilter = {
-  key: string; // matches a FacetDefinition key
-  value: string; // the selected value
-  label: string; // human-readable label shown in the chip
-};
-```
-
-## Accessibility
-
-`FacetedFilterBar` uses `role="search"` on the root element to expose the filtering surface as a landmark. Consumers should provide a meaningful `aria-label` prop (e.g. `"Workflow filters"`) so screen reader users can navigate to it by landmark.
-
-Each select facet receives an `aria-label` attribute equal to its `label` prop, and an associated visually-hidden `label` element is rendered via the `cinder-sr-only` class for redundancy.
-
-Applied-filter chip remove buttons are labeled `"Remove filter: {label}: {value}"` so screen reader users know exactly which filter they are removing.
-
-A `role="status"` live region (polite) always stays in the DOM and announces the active filter count and each applied value whenever the `appliedFilters` prop changes. The region is never conditionally rendered with `{#if}` — this ensures assistive technologies register it before any content is injected.
-
-See `faceted-filter-bar.a11y.md` for the full keyboard and pointer interaction model.

package/src/components/feed/README.md

@@ -1,58 +0,0 @@
-# Feed
-
-Scrollable chronological list of activity events with optional load-more pagination.
-
-## Usage
-
-`Feed` is a compound component. Import the parent and compose `Feed.Event` via
-the namespace API.
-
-```svelte
-<script lang="ts">
-  import { Feed } from '@lostgradient/cinder/feed';
-</script>
-
-<Feed aria-label="Project activity">
-  <Feed.Event datetime="2025-05-12T15:30:00Z" timestamp="2m ago">
-    {#snippet icon()}
-      <span aria-hidden="true">★</span>
-    {/snippet}
-    <p>Ada Lovelace starred the repository.</p>
-  </Feed.Event>
-</Feed>
-```
-
-The event body is the default child content. The visible time label is the
-`timestamp` string (use the `timestampLabel` snippet only when the label needs
-markup); if omitted, it falls back to the raw `datetime` value.
-
-The leaf remains importable individually for à-la-carte builds — see
-`@lostgradient/cinder/feed-event`.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop       | Type       | Required | Default | Description                                                                                                                                                                                                                                                                               |
-| ---------- | ---------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `class`    | `string`   | no       | —       | Additional class merged onto the `.cinder-feed` root element.                                                                                                                                                                                                                             |
-| `live`     | `boolean`  | no       | —       | When true, the wrapper becomes an ARIA live region: `aria-live="polite"` and `aria-atomic="false"`. Use for feeds that mutate while the user is on the page (streaming notifications, log tails, chat-like activity). Defaults to false — a polite live region on a static feed is noise. |
-| `children` | `(opaque)` | yes      | —       | Feed events (typically `<FeedEvent>` children). Not expressible in JSON Schema; see the component types for the signature.                                                                                                                                                                |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-- `--cinder-feed-rail-size`
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-- `Feed.Event` — a dated event entry with `icon` or `minimal` variant; see
-  [`feed-event`](../feed-event/README.md).
-
-<!-- generated:subcomponents:end -->

package/src/components/feed-event/README.md

@@ -1,43 +0,0 @@
-# FeedEvent
-
-Individual timestamped entry within a chronological activity feed.
-
-## Usage
-
-`FeedEvent` is a compose-only leaf of [`Feed`](../feed/README.md).
-The idiomatic API is `Feed.Event`, reached through the parent
-namespace — see the [feed README](../feed/README.md#usage) for the composed
-snippet. The flat `@lostgradient/cinder/feed-event` subpath remains exported for
-à-la-carte builds that import the leaf directly.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop             | Type                    | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| ---------------- | ----------------------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `class`          | `string`                | no       | —       | Additional class merged onto the `.cinder-feed-event` root element.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `datetime`       | `string`                | yes      | —       | ISO 8601 datetime string. Rendered as `<time datetime={datetime}>` so assistive tech and parsers receive a machine-readable timestamp. This is always the authoritative value; the visible label is separate (see `timestamp` / `timestampLabel`).                                                                                                                                                                                                                                                                                                                                                                                                                                       |
-| `timestamp`      | `string`                | no       | —       | Visible time label, as plain text — the common case (`"2m ago"`, `"May 12, 3:30 PM"`). Rendered inside the `<time>` element. Optional, with a deliberate three-way contract: - **omitted** (`undefined`) and no `timestampLabel` → falls back to the raw `datetime` string, which is deterministic and SSR-safe (no locale or timezone dependence). - **explicit empty string** (`timestamp=""`) → renders no visible label. This is treated as "intentionally blank", NOT as omitted, so it does **not** trigger the `datetime` fallback. Use it to hide the label while keeping the machine-readable `<time datetime>` for assistive tech. - **non-empty string** → rendered verbatim. |
-| `variant`        | `"icon"` \| `"minimal"` | no       | —       | Icon variant: renders a circular badge on the rail with the icon inside.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| `children`       | `(opaque)`              | no       | —       | Main event body — the description, links, and secondary metadata. Passed as the default children snippet: `svelte <FeedEvent datetime="…" timestamp="2m ago">   <strong>{user.name}</strong> pushed 3 commits </FeedEvent> ` Not expressible in JSON Schema; see the component types for the signature.                                                                                                                                                                                                                                                                                                                                                                                  |
-| `icon`           | `(opaque)`              | no       | —       | Required for the icon variant. Type-enforced by the discriminated union. Not expressible in JSON Schema; see the component types for the signature.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `timestampLabel` | `(opaque)`              | no       | —       | Rich visible time label, for the rare case where the label needs markup (e.g. an `<abbr>` or nested element). Takes precedence over `timestamp` when both are supplied. Most consumers should use the `timestamp` string instead. 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 -->