@cratis/stage.runtime 4.187.0 → 4.187.2

package/dist/src/StageCommandForm.d.ts

@@ -23,5 +23,29 @@ export declare function StageCommandForm({ element }: StageCommandFormProps): im
  * A required uuid property that the form does not list is that kind of identity - the screen's own parameter when it carries one, otherwise one value per
  * identifier concept for as long as this browser keeps the session - the same basket for every add, change and checkout, a different one for
  * another browser - and a command is never submitted for an identity nobody chose.
+ *
+ * A schema that marks the identifier the command acts on (`x-identity`, a task dialog's) says which one that is: only it is created, and a
+ * reference to another entity gets only what the address or the session supplies. A schema that marks none - an authored form's - leaves
+ * every identifier it does not show to the session, as it always has.
  */
 export declare function sessionIdentifiers(fields: FormField[], schema: SchemaProperty[], parameters: Record<string, string>): StageCommandContent;
+/**
+ * Whether a task dialog leaves an identifier out of what it asks: the identifier the command acts on (`x-identity`) - the shopper's basket,
+ * which the session supplies or creates - or one the address or the session already supplies. Every other identifier is a reference to
+ * another entity - the product an add to basket is for - and is the person's to choose.
+ *
+ * @param property The property of the command.
+ * @param parameters The screen's address parameters.
+ * @returns Whether the dialog does not ask for it.
+ */
+export declare function suppliedWithoutAsking(property: SchemaProperty, parameters: Record<string, string>): boolean;
+/**
+ * The value an identifier property already has without anyone typing it: the screen's parameter of the same name, or the identity the session
+ * already holds for its concept. Nothing is created here, so a reference to another entity - the product an add to basket is for - that
+ * nothing supplies stays a value the person filling the form is asked for.
+ *
+ * @param property The property of the command.
+ * @param parameters The screen's address parameters.
+ * @returns The value, or nothing when the property is not an identifier or nothing supplies it.
+ */
+export declare function suppliedIdentifier(property: SchemaProperty, parameters: Record<string, string>): string | undefined;

package/dist/src/commandExecutor.d.ts

@@ -9,6 +9,13 @@ export declare function registeredCommand(name: string, typeName?: string, route
  * they would be posted to the root of the proxy's host instead of to the Stage.
  */
 export declare function hostedBasePath(): string;
+/**
+ * Points a command at the path the page is served under when Arc was not given a base path. Arc's own command form builds its command from
+ * Arc's default configuration, whose empty base path posts to the root of the host - Studio's Play at `/api/play/{id}/` refused that with `405`.
+ */
+export declare function withHostedBasePath<TCommand extends {
+    setApiBasePath(apiBasePath: string): void;
+}>(command: TCommand, arcApiBasePath?: string): TCommand;
 /** Executes the registered proxy with the same host configuration as Arc's useCommand. */
 export declare function executeRegisteredCommand(name: string, values: Record<string, unknown>, arc: ArcConfiguration): Promise<StageCommandOutcome>;
 /** Maps Arc's typed result without treating a rejection or authorization failure as success. */