@moyarich/console-core 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +83 -2
- package/dist/index.cjs +702 -0
- package/dist/index.d.ts +648 -0
- package/dist/index.js +702 -0
- package/package.json +48 -4
package/README.md
CHANGED
|
@@ -1,3 +1,84 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @moyarich/console
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
A React console toolkit for **capturing and displaying runtime output**.
|
|
4
|
+
|
|
5
|
+
Bring browser-style `console.*` messages, inspectable JavaScript values, and ANSI-formatted process output into your application. Console works well in code playgrounds, developer tools, embedded previews, and applications connected to remote runtimes.
|
|
6
|
+
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
- **Structured messages:** Render familiar console levels and inspect JavaScript values.
|
|
10
|
+
- **Process output:** Display ANSI-formatted `stdout` and `stderr`.
|
|
11
|
+
- **Flexible capture:** Work with React state, runtime proxies, iframes, and remote message sources.
|
|
12
|
+
- **Customizable UI:** Extend rendering, appearance, and interactions with optional addons.
|
|
13
|
+
- **Large logs:** Opt into virtualized rendering when displaying high-volume output.
|
|
14
|
+
|
|
15
|
+
Console handles presentation and message transport; your application remains in control of runtime execution and lifecycle.
|
|
16
|
+
|
|
17
|
+
## Installation
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npm install @moyarich/console
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Requires React 18 or newer. The package includes TypeScript declarations and loads its core stylesheet automatically.
|
|
24
|
+
|
|
25
|
+
## Quick start
|
|
26
|
+
|
|
27
|
+
```tsx
|
|
28
|
+
import { Console, useConsoleMessages } from "@moyarich/console";
|
|
29
|
+
|
|
30
|
+
export function AppConsole() {
|
|
31
|
+
const { messages, console, clear } = useConsoleMessages();
|
|
32
|
+
|
|
33
|
+
return (
|
|
34
|
+
<>
|
|
35
|
+
<button onClick={() => console.log("Hello", { ready: true })}>
|
|
36
|
+
Add message
|
|
37
|
+
</button>
|
|
38
|
+
<Console messages={messages} onClear={clear} />
|
|
39
|
+
</>
|
|
40
|
+
);
|
|
41
|
+
}
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Use the console-compatible producer from event handlers or runtime callbacks to add messages, and `<Console />` to display them.
|
|
45
|
+
|
|
46
|
+
## Explore
|
|
47
|
+
|
|
48
|
+
**[Interactive playground and documentation](https://moyarich.github.io/console/)** — browse runnable examples, API reference, rendering modes, customization, and addons.
|
|
49
|
+
|
|
50
|
+
- [Console examples and guides](packages/console/examples/page.mdx)
|
|
51
|
+
- [High-volume output accessibility](packages/console/examples/36-high-volume-accessibility/page.mdx)
|
|
52
|
+
- [Virtualized output guide](packages/console/examples/38-virtualization/page.mdx)
|
|
53
|
+
|
|
54
|
+
## Packages and addons
|
|
55
|
+
|
|
56
|
+
Console is a family of independently installable packages. Start with `@moyarich/console`, then add only the capabilities your application needs.
|
|
57
|
+
|
|
58
|
+
| Package | What it provides |
|
|
59
|
+
| ---------------------------------------------- | ----------------------------------------------------------- |
|
|
60
|
+
| `@moyarich/console` | React console UI for structured messages and process output |
|
|
61
|
+
| `@moyarich/console-core` | Shared contracts for building and integrating addons |
|
|
62
|
+
| `@moyarich/console-addon-animation` | Animated process-output display |
|
|
63
|
+
| `@moyarich/console-addon-annotations` | Message annotations and labels |
|
|
64
|
+
| `@moyarich/console-addon-console-feed` | Console feed integration |
|
|
65
|
+
| `@moyarich/console-addon-data-export` | Export console output data |
|
|
66
|
+
| `@moyarich/console-addon-diagnostics` | Console diagnostics |
|
|
67
|
+
| `@moyarich/console-addon-filtering` | Filter output |
|
|
68
|
+
| `@moyarich/console-addon-imperative-scrolling` | Programmatic scrolling and viewport controls |
|
|
69
|
+
| `@moyarich/console-addon-links` | Detect and interact with links |
|
|
70
|
+
| `@moyarich/console-addon-markdown` | Render GitHub Flavored Markdown |
|
|
71
|
+
| `@moyarich/console-addon-metadata` | Display message metadata |
|
|
72
|
+
| `@moyarich/console-addon-navigation` | Navigate between messages |
|
|
73
|
+
| `@moyarich/console-addon-process-state` | Represent process execution state |
|
|
74
|
+
| `@moyarich/console-addon-resizable` | Resize the console frame |
|
|
75
|
+
| `@moyarich/console-addon-search` | Search console output |
|
|
76
|
+
| `@moyarich/console-addon-selection` | Select messages |
|
|
77
|
+
| `@moyarich/console-addon-session` | Serialize console sessions |
|
|
78
|
+
| `@moyarich/console-addon-xterm` | Render output with xterm.js |
|
|
79
|
+
|
|
80
|
+
Core console features work without optional addons. Each addon is installed separately. See the [interactive documentation](https://moyarich.github.io/console/) for usage examples and integration guidance.
|
|
81
|
+
|
|
82
|
+
## License
|
|
83
|
+
|
|
84
|
+
MIT
|