@june-ai/june-ui 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## [Unreleased] (planned 0.2.0)
+
+### Added
+- `JuneRenderer` and `@june-ai/june-ui/core` entry (no built-in library import).
+- Theme support: `theme` ("light" | "dark" | "system"), `themeVars`, `className`, `style`;
+  `@june-ai/june-ui/styles.css`.
+- Error boundary, `onJuneError` structured errors (`JuneError`), fallbacks, `resetKeys`.
+- Streaming: `useJuneStream`, `consumeStream`, `fetchStream`, `sseToText`, abort + unmount cleanup.
+- Actions: `defineJuneAction`, `actions` prop, schema validation, confirmation for sensitive actions.
+- `createJuneLibrary` (validation, allow/deny lists) on top of OpenUI's `createLibrary`.
+- All other OpenUI `Renderer` props are forwarded and typed from the installed OpenUI version.
+
+### Changed
+- `@openuidev/react-lang` is now a peer dependency (single shared parser); `zod`, `zustand`,
+  `@openuidev/react-headless` declared as peers.
+- React peer range widened to `^18.3.1 || ^19.0.0`.
+- `onAction` is typed with OpenUI's event type (handlers typed `(event: unknown) => void` still work).
+
+### Compatibility
+- `<JuneUI response isStreaming onAction onError />` from 0.1.0 works unchanged.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 June AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,66 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @june-ai/june-ui
+
+React Generative UI SDK built on [OpenUI](https://github.com/thesysdev/openui). June adds streaming
+helpers, themes, safe actions, error recovery, and library validation. OpenUI does all parsing and
+rendering.
+
+## Install
+
+```bash
+npm install @june-ai/june-ui
+```
+
+Import styles once in your app entry:
+
+```ts
+import "@openuidev/react-ui/components.css"; // OpenUI built-in components
+import "@june-ai/june-ui/styles.css";        // June theme variables
+```
+
+## Usage
+
+```tsx
+import { JuneUI } from "@june-ai/june-ui";
+
+<JuneUI response={response} isStreaming={isStreaming} theme="system" onJuneError={console.error} />
+```
+
+### Streaming (works with any backend)
+
+```tsx
+const stream = useJuneStream();
+stream.startFetch("/api/generate", { method: "POST", body, sse: false }); // sse: true for SSE
+<JuneUI response={stream.response} isStreaming={stream.isStreaming} />
+```
+
+### Custom library
+
+```tsx
+import { createJuneLibrary } from "@june-ai/june-ui";
+const library = createJuneLibrary({ root: "Stack", components: [Stack, Card] }); // module scope
+<JuneUI library={library} response={response} />
+```
+
+### Actions
+
+```tsx
+const actions = { submit: defineJuneAction({ schema, sensitive: true, handler }) };
+<JuneUI actions={actions} confirmAction={({ name }) => window.confirm(name)} ... />
+```
+Model output never executes code. Only actions you registered by name can run, and sensitive
+actions are denied unless confirmed.
+
+### Lightweight entry
+
+`@june-ai/june-ui/core` exports `JuneRenderer`, which requires your own `library` and does not
+import OpenUI's built-in component library.
+
+## OpenUI features
+
+Tool providers, query loaders, state callbacks, and parse-result callbacks are forwarded to
+OpenUI's `Renderer` as props. See OpenUI's docs for their behaviour. Never put API keys in the
+browser; do tool/MCP calls in your backend.
+
+## Requirements
+
+React 18.3.1+ or 19, plus the OpenUI peer dependencies listed in package.json.