@cratis/stage.runtime 4.189.1 → 4.189.2

package/dist/src/StageCommandForm.d.ts

@@ -28,7 +28,7 @@ export declare function StageCommandForm({ element }: StageCommandFormProps): im
  * 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;
+export declare function sessionIdentifiers(fields: FormField[], schema: SchemaProperty[], parameters: Record<string, string>, selectedRows?: Record<string, unknown>[]): 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
@@ -49,3 +49,12 @@ export declare function suppliedWithoutAsking(property: SchemaProperty, paramete
  * @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;
+/**
+ * The identifier of the row the person selected on the screen: an action on a list acts on the selected item, so the identifier property of the same
+ * name takes that row's value and the session never invents the key of an entity that already exists. Rows that disagree about it supply nothing.
+ *
+ * @param property The property of the command.
+ * @param selectedRows The rows currently selected on the screen.
+ * @returns The selected row's value, or nothing when no selected row (or more than one, differently) carries one.
+ */
+export declare function selectedIdentifier(property: SchemaProperty, selectedRows: Record<string, unknown>[]): string | undefined;