@cratis/stage.runtime 4.187.0 → 4.187.1

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;