@cratis/stage.runtime 4.190.12 → 4.191.0

package/dist/src/App.d.ts

@@ -21,7 +21,7 @@ export interface StageSceneApplication {
     commandSchemas?: Record<string, string>;
 }
 /**
- * The registry a Stage renders with: Scene's core vocabulary, PrimeReact and the default blueprint, then any
+ * The registry a Stage renders with: Scene's core vocabulary, the libraries the profile lists (PrimeReact only then) and the default blueprint, then any
  * components the host adds, then the Stage's own table, action, form and chrome - which always win, because they
  * are what reach the running application.
  * @param components Components the host adds, such as a package an application composes with.

package/dist/src/blueprint.d.ts

@@ -1,20 +1,43 @@
-import type { SceneElement, Screen, UiProfile } from '@cratis/scene.model';
-import type { PackageCatalog } from '@cratis/scene.engine';
+import { type SceneElement, type Screen, type UiProfile } from '@cratis/scene.model';
+import { type PackageCatalog } from '@cratis/scene.engine';
 import { type ComponentRegistry } from '@cratis/scene.react';
 /** The qualified name Stage registers its locale picker under. */
 export declare const stageLocaleComponent = "Stage:locale";
+/** The package a host renders with when the profile lists no component library: the Cratis component library, built on React Aria. */
+export declare const stageBaselinePackage = "Cratis.Components";
+/** The component library the profile opts in to by listing it; the application registers its support only then. */
+export declare const primeReactPackage = "PrimeReact";
+/**
+ * A component library a profile opted in to, registered by the host: the components it registers and what it declares.
+ */
+export interface StageLibrary {
+    /** The components the library adds to the registry. */
+    components: ComponentRegistry;
+    /** What the library declares, so a bare name resolves to it. */
+    declared: string[];
+}
+/** Whether the profiles the scene declares list PrimeReact. */
+export declare function listsPrimeReact(profiles: UiProfile[] | undefined): boolean;
+/**
+ * Registers a component library a profile opts in to. The application or live Stage that installs the library registers it
+ * before rendering; the runtime itself never imports one, so it stays fully usable with none registered.
+ *
+ * @param name The package name the library is listed under in a profile.
+ * @param library The components the library adds and what it declares.
+ */
+export declare function registerStageLibrary(name: string, library: StageLibrary): void;
 /**
  * The profile a scene renders against: the shared one - the model's own `ui profile` with the packages every host renders with
- * admitted - with the PrimeReact widgets the default blueprint is built from between Scene's core and the blueprint, so the
- * blueprint's component still wins a name both declare.
+ * admitted - ordered core, then Cratis.Components, then the libraries the profile lists (PrimeReact only when it lists it), then
+ * the blueprint, so the blueprint's component still wins a name another package also declares.
  *
  * @param profiles The profiles the scene declares.
  * @returns The profile to resolve component names with.
  */
 export declare function stageProfile(profiles: UiProfile[] | undefined): UiProfile;
-/** What each package declares, so a bare name resolves to the package that provides it. */
+/** What each package every Stage declares, so a bare name resolves to the package that provides it. */
 export declare const stageCatalog: PackageCatalog;
-/** Every component the Stage can render: Scene's core, PrimeReact, the default blueprint's shell, and the template wrapper the shared composition places screens in. */
+/** Every component the Stage can render: Scene's core, the Cratis component library, the libraries a profile opted in to, the default blueprint's shell, and the template wrapper the shared composition places screens in. */
 export declare function stageRegistry(overrides: ComponentRegistry): ComponentRegistry;
 /**
  * What every package the application renders with declares: the Stage's own packages, and the components of the

package/dist/src/index.d.ts

@@ -1,9 +1,11 @@
 export { App, App as StageApplication, composeStageScreen, stageApplicationRegistry, stageComposition, stageShellOf } from './App';
 export type { StageSceneApplication } from './App';
+export { stageDarkSelector } from './stageDarkSelector';
+export { listsPrimeReact, registerStageLibrary } from './blueprint';
+export type { StageLibrary } from './blueprint';
 export { StageSourceProvider, staticStageSource, useStageSource, stageEndpoints } from './stageSource';
 export type { StageSource, StageStaticContent } from './stageSource';
 export type { StageRoutes } from './stageRoutes';
-export { stageTheme, stageDarkSelector } from './stageTheme';
 export { executeRegisteredCommand, registeredCommand, useStageCommandExecutor } from './commandExecutor';
 export { hostedBasePath } from './hostedBasePath';
 export { registeredQuery, performQuery, subscribeQuery, registerQueryRouteResolver } from './queryExecutor';