@cratis/stage.runtime 5.1.1 → 5.2.0

package/dist/src/readableValue.d.ts

@@ -2,7 +2,8 @@
  * A value of a table cell the way a person reads it, recognised by its runtime type or its ISO format.
  *
  * A boolean reads Yes or No; an ISO date or date-time reads in the user's locale. Anything else - or a text that only looks like a date
- * but is not one - is left as it is.
+ * but is not one - is left as it is. A collection reads as its values joined with a comma when it holds scalars or objects with a single
+ * field, and as its item count when its objects carry several fields.
  *
  * @param value The value the row carries.
  * @returns The text to show, or undefined when the value is not one this reads.

package/dist/src/sandboxActingUser.d.ts

@@ -0,0 +1,19 @@
+import { type StageSource } from './stageSource';
+/** A modeled name and its display-only description. Identity is always resolved by the host. */
+export interface SandboxActingUser {
+    name: string;
+    displayName: string;
+    personas: string[];
+}
+/** The live sandbox's browser-local selection. Static and published sources do not offer it. */
+export interface SandboxActingUserState {
+    enabled: true;
+    users: SandboxActingUser[];
+    current: string | null;
+}
+/** Reads only the host-gated surface, relative to the current sandbox base URL. */
+export declare function readSandboxActingUser(signal: AbortSignal, fetcher?: typeof fetch): Promise<SandboxActingUserState | undefined>;
+/** Writes only a modeled name (or clears it); no caller-supplied roles or claims travel in the selection. */
+export declare function writeSandboxActingUser(name: string | null, fetcher?: typeof fetch): Promise<void>;
+/** Refreshes identity, authorization and subscriptions together, only after the host accepts the selection. */
+export declare function changeSandboxActingUser(source: StageSource, name: string | null, reload: () => void): Promise<void>;

package/dist/src/stageFormSchema.d.ts

@@ -19,6 +19,11 @@ export interface SchemaProperty {
      * another entity, such as the product it adds. Only the schema a task dialog is built from says so.
      */
     identity?: boolean;
+    /**
+     * Set when the schema marks the identifier the command acts on and this identifier is not it - the company a link-to-company command assigns. A row
+     * that happens to carry a value of this name does not bind it: the field stays visible and editable.
+     */
+    otherEntity?: boolean;
     type?: 'text' | 'number' | 'boolean' | 'date';
     required: boolean;
     unsupportedReason?: string;
@@ -36,8 +41,12 @@ export declare function createsEntity(schema: string): boolean;
 /**
  * The properties a command's JSON schema declares, with the type the native form gives each and whether it is required. A toolbar
  * slice's task dialog is built from the same reading, so a command is the same fields wherever it is presented.
+ *
+ * @param schema The schema to read.
+ * @param identitySchema The schema the host serves for the command, which marks the identifier it acts on (`x-identity`) when the schema a
+ * rendered scene carries on an action does not.
  */
-export declare function schemaPropertiesOf(schema: string): SchemaProperty[];
+export declare function schemaPropertiesOf(schema: string, identitySchema?: string): SchemaProperty[];
 /** Humanizes a member name the way a field label reads: `postalCode` is “Postal code”. */
 export { humanize };
 /**

package/dist/src/stageSource.d.ts

@@ -3,6 +3,7 @@ import type { StringsDictionary } from '@cratis/scene.engine';
 import type { StageRoutes } from './stageRoutes';
 import type { StageSceneApplication } from './App';
 import type { StageNotesState } from './stageNotes';
+import type { SandboxActingUserState } from './sandboxActingUser';
 /** The content supplied by the host of a Stage application. */
 export interface StageSource {
     scene(signal: AbortSignal): Promise<StageSceneApplication>;
@@ -11,6 +12,9 @@ export interface StageSource {
     strings(locale: string, signal: AbortSignal): Promise<StringsDictionary>;
     /** What the host says about feedback: whether Notes is served, and the model references. A source with nothing to say omits it. */
     notes?(signal: AbortSignal): Promise<StageNotesState>;
+    /** A live sandbox's host-gated caller selection. Never supplied by a static application. */
+    actingUser?(signal: AbortSignal): Promise<SandboxActingUserState | undefined>;
+    selectActingUser?(name: string | null): Promise<void>;
 }
 /** What a generated application already holds when it is built. */
 export interface StageStaticContent {
@@ -26,6 +30,7 @@ export declare const stageEndpoints: {
     routes: string;
     locales: string;
     modelReferences: string;
+    actingUser: string;
     strings: (locale: string) => string;
 };
 /** Supplies the source the runtime below reads from. Transport belongs to the host. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cratis/stage.runtime",
-  "version": "5.1.1",
+  "version": "5.2.0",
   "description": "The Cratis Stage application runtime for Arc and Scene",
   "author": "Cratis",
   "type": "module",