orbital-discussion 0.1.1

Composable discussion and reply-thread components for Orbital
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

# orbital-discussion

Composable Leptos **Discussion** library — threaded reply trees (Tree, Flat, Compact view modes), markdown bodies, citations, attachments, composer, and agent reply parts.

Consumers own data via Leptos signals and wire backends through integration APIs (adapter trait, hooks, callbacks).

## Quick start

```toml
[dependencies]
orbital-discussion = { version = "0.1", default-features = false }
orbital-ui = { version = "0.1", default-features = false, features = ["hydrate"] }
leptos = { version = "0.8", default-features = false, features = ["nightly"] }
```

Use `default-features = false` in production; enable `preview` only for the doc host.

## Key types

- `DiscussionThread`, `DiscussionReply`, `DiscussionComposer`
- `DiscussionFeatures`, `DiscussionEvents`, `DiscussionAdapter`
- Markdown: [`orbital-markdown`](../orbital-markdown/)

## Preview

[Discussion preview](https://unified-field-dev.github.io/orbital/discussion) · local `http://127.0.0.1:3010/orbital/discussion` (with `cargo leptos watch -p orbital-preview`)

## Scope

**In scope:** reply tree + composer, focus navigation, collapse/expand, citations, attachments, custom `*_view` callbacks, composition regions, agent part rendering.

**Out of scope:** conversation lists, feeds, moderation UI, HTTP/WebSocket transport (host wires those).

## Deferred (not in current charter)

- Auto-scroll, read receipts, unread highlight styling, image lightbox

## Docs

Consumer API: component rustdoc and preview catalog. CSS prefix: `orbital-discussion__*`. See [orbital-macros/README.md — consumer feature flags](../orbital-macros/README.md#consumer-feature-flags).