@cratis/scene.blueprint.components 2.0.0 → 3.0.0

package/.storybook/preview.tsx

@@ -2,20 +2,16 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import type { Preview } from '@storybook/react';
+import { PrimeReactProvider } from '@primereact/core';
 import { CratisComponentsProvider } from '@cratis/components/Common';
 
-// The stylesheet layers a page in this blueprint needs, in the order they resolve. PrimeReact 11 ships
-// zero CSS - `primereact/resources/themes/*` does not exist any more - and `@cratis/components` 3.0.0 took
-// its own CSS out of the JavaScript module graph, so every sheet below is an explicit import rather than
-// something a bundler injects behind an `import './Foo.css'`.
+// The stylesheet layers a page in this blueprint needs, in the order they resolve. Components 4 owns its
+// own CSS outright and keeps it out of the JavaScript module graph, so every sheet below is an explicit
+// import rather than something a bundler injects behind an `import './Foo.css'`.
 //
 // `tokens` defines the `--cratis-*` layer, `styles` is every component stylesheet plus the Tailwind
 // utilities that consume it, and `theme` is the Cratis-authored MIT baseline that assigns those tokens
-// actual values. That order matters: the last two both read the first. `theme` is what gives this preview
-// a look at all, because with no `@primeuix/themes` preset there are no `--p-*` values for the tokens to
-// resolve to - which also means the raw PrimeReact widgets the default blueprint's shell renders come out
-// structural rather than styled. That is the honest picture of an unstyled-first host, and this package
-// takes no dependency on a preset to paper over it.
+// actual values. That order matters: the last two both read the first.
 //
 // The Scene package's bridge puts Scene's `--scene-*` tokens in front of that, and the default blueprint's
 // `layout.css` draws the shell every one of these pages sits inside - which is the sheet this package does
@@ -31,24 +27,31 @@ import 'primeicons/primeicons.css';
 import '../../components/theme/sceneTokenBridge.css';
 import '../../blueprint.default/shell/layout.css';
 
+// The baseline theme is scoped to a `cratis-theme` ancestor rather than to `:root`, so something has to
+// carry the class, and overlays portal to the body rather than into the story's subtree.
+document.body.classList.add('cratis-theme');
+
 /**
- * Every story renders inside `CratisComponentsProvider`, the library's own configuration provider over
- * PrimeReact's. Without it the wrapped components fall back to PrimeReact's defaults rather than Cratis',
- * so a story would show something subtly different from what an application renders - which defeats the
- * point of having stories at all.
+ * Two providers, because these pages are two things at once.
+ *
+ * The page bodies are Components 4, which owns its own markup and configuration and no longer sits on
+ * PrimeReact at all - `CratisComponentsProvider` now carries only what the library itself owns.
  *
- * On PrimeReact 11 it is also load-bearing rather than merely advisable: every v11 component resolves its
- * configuration, theme and z-index registry through `PrimeReactProvider`, which this wraps, and throws
- * outright without one. These pages sit inside the default blueprint's shell, which reaches for PrimeReact
- * directly in five places, so removing this decorator would not degrade the stories - it would stop them
- * rendering.
+ * The shell they sit inside is the default blueprint's, and that reaches for PrimeReact directly in five
+ * places (`Topbar`, `Sidebar`, `Breadcrumb`, `UserMenu`, `ConfigPanel`). Every PrimeReact 11 component
+ * resolves its configuration, theme and z-index registry through `PrimeReactProvider` and throws without
+ * one. Until Components 3 that provider came for free, because `CratisComponentsProvider` wrapped it;
+ * under Components 4 it does not, so this preview supplies it explicitly. Dropping it would not degrade
+ * these stories - it would stop them rendering.
  */
 const preview: Preview = {
     decorators: [
         Story => (
-            <CratisComponentsProvider>
-                <Story />
-            </CratisComponentsProvider>
+            <PrimeReactProvider>
+                <CratisComponentsProvider value={{ locale: 'en-US' }}>
+                    <Story />
+                </CratisComponentsProvider>
+            </PrimeReactProvider>
         ),
     ],
     parameters: {

package/README.md

@@ -1,5 +1,8 @@
 # Scene
 
+**Describing a user interface without describing a platform** — Scene is the UI model of the Cratis
+model-first layer (experimental).
+
 The object model and runtime for Screenplay-based UIs: `Scene.Model` (platform-agnostic screens, layouts,
 forms, contribution points, ui profiles and themes), `Scene.Engine` (binding/resolution runtime), and
 `Scene.React` (the React renderer).
@@ -18,8 +21,13 @@ forms, contribution points, ui profiles and themes), `Scene.Engine` (binding/res
 
 ## Description
 
-Scene owns the *object model and runtime* half of the Screenplay stack. `Scene.Model` is the platform-agnostic
-C# object model that Stage translates Screenplay's parsed language constructs into, and that Studio's
+Scene owns the *object model and runtime* half of the Screenplay stack. In the model-first pipeline,
+[Screenplay](https://github.com/Cratis/Screenplay) describes an event-sourced, CQRS system,
+[Stage](https://github.com/Cratis/Stage) renders it into a running application, and Scene is how that
+application's user interface is described — independently of any rendering platform.
+
+`Scene.Model` is the platform-agnostic
+C# object model that [Stage](https://github.com/Cratis/Stage) translates Screenplay's parsed language constructs into, and that [Studio](https://github.com/Cratis/Studio)'s
 design-time tooling reads and writes. `Scene.Engine` walks that graph, resolves bindings (data, action, form,
 navigation contribution) and drives whichever renderer is plugged in — it does not know React exists.
 `Scene.React` is one renderer implementing the abstract vocabulary against real React/DOM; sibling positions
@@ -38,3 +46,22 @@ Cratis is an open community, and we are glad to help users, teams evaluating the
 | Discord | Join the community on [Discord](https://discord.gg/kt4AMpV8WV) for questions and discussions |
 | GitHub Issues | [Report bugs or request features](https://github.com/Cratis/Scene/issues) |
 | Documentation | Read the docs at [cratis.io](https://cratis.io) |
+
+## The Cratis ecosystem
+
+This project is part of [Cratis](https://www.cratis.io) — free, MIT-licensed tools for building event-sourced and CQRS applications.
+
+- **[Chronicle](https://github.com/Cratis/Chronicle)** — event-sourcing database and runtime. Orleans-based kernel, pluggable storage (MongoDB default; PostgreSQL, SQL Server, SQLite, in-memory), language-agnostic gRPC contracts. [Docs](https://www.cratis.io/chronicle/)
+- **Chronicle clients** — first-class [.NET SDK](https://github.com/Cratis/Chronicle), plus [TypeScript](https://github.com/Cratis/Chronicle.TypeScript), [Kotlin/Java](https://github.com/Cratis/Chronicle.Kotlin), and [Elixir](https://github.com/Cratis/Chronicle.Elixir); [Python](https://github.com/Cratis/Chronicle.Python) coming soon (pre-alpha). AI agents connect through the [Chronicle MCP server](https://github.com/Cratis/Chronicle.Mcp).
+- **[Arc](https://github.com/Cratis/Arc)** — opinionated CQRS framework for ASP.NET Core with commands, queries, validation, authorization, and TypeScript proxy generation. Works without event sourcing. [Docs](https://www.cratis.io/arc/)
+- **[Components](https://github.com/Cratis/Components)** — React components aligned with Arc patterns. [Docs](https://www.cratis.io/components/)
+- **[CLI](https://github.com/Cratis/cli) + Workbench** — inspect and diagnose Chronicle from the terminal or the browser. [Docs](https://www.cratis.io/cli/)
+- **Model-first layer (experimental)** — [Studio](https://github.com/Cratis/Studio), [Screenplay](https://github.com/Cratis/Screenplay), [Stage](https://github.com/Cratis/Stage), Scene (this repository), [Prologue](https://github.com/Cratis/Prologue)
+- **Supporting** — [Fundamentals](https://github.com/Cratis/Fundamentals), [Specifications](https://github.com/Cratis/Specifications), [Synopsis](https://github.com/Cratis/Synopsis), [Lens](https://github.com/Cratis/Lens), [Narrator](https://github.com/Cratis/Narrator), and free [AI tooling](https://github.com/Cratis/AI) (preview); [Ensemble](https://github.com/Cratis/Ensemble) coming soon (pre-release)
+- **[Samples](https://github.com/Cratis/Samples)** — runnable event sourcing and CQRS samples for the whole stack
+
+Everything Cratis publishes today is MIT licensed and free to use.
+
+---
+
+Part of the [Cratis](https://www.cratis.io) platform · [MIT](./LICENSE)