BEACON-6 add documentation for up-arrow functionality

Author: wing-it

content/docs/components/actions.md

@@ -37,6 +37,7 @@ actions: {
     method: (props: {
       dispatch: Dispatch,
       character: Character,
+      actionId?: string,
       messageId?: string,
       rolls?: RollResults 
     }, ...args: string[]): void | Promise<void>
@@ -50,6 +51,7 @@ The action's `method` receives a `props` object from the host containing the fol
 
 - `dispatch`: A `Dispatch` object.
 - `character`: The data of the character performing the action. Currently, the action will not receive the character’s bio or GM notes, regardless of whether the player has access to those fields.
+- `actionId` (optional): A unique ID for the action. If this id is provided to a `post` or `postRaw` call, the action will be added to the chat's action history and will be filled in the chat box when the user presses the up arrow key.
 - `messageId` (optional): A unique ID for an existing chat message. It's included in actions triggered from chat buttons to provide context for the original roll.
 - `rolls` (optional): Included when action is triggered from a chat button. Contains the roll results of the original roll.
 

content/docs/components/dispatch.md

@@ -63,6 +63,7 @@ The method returns a promise that resolves with an object containing the message
 dispatch.post({
   characterId: string,
   messageId?: string,
+  actionId?: string,
   content: string,
   options?: {
     whisper?: 'gm',
@@ -78,11 +79,14 @@ The secret option is ignored unless whisper is also set, toggling to true will c
 
 Like roll, messageId can be provided to update an existing chat message, but if omitted the method will generate a new messageId and post a new chat message.  The method returns the messageId.
 
+Post can also accept an actionId. When provided a valid actionId from a triggered action, that action's signature will be added to the chat's action history and will be filled in the chat box when the user presses the up arrow key.
+
 #### postRaw
 ```javascript
 dispatch.postRaw({
   characterId: string,
   messageId?: string,
+  actionId?: string,
   content: string,
   options?: {
     whisper?: 'gm',

content/docs/components/roll.md

@@ -54,6 +54,9 @@ dispatch.post({
 })
 ```
 
+## Adding to Chat History (Up-Arrow)
+In order to provide support for adding a roll to the chat history, the roll must have originated from an [action](/beacon-docs/docs/components/actions). Actions provide a string argument, `actionId`, which must be provided in the `post` method when the roll is posted to chat. When the user presses the up arrow key, the chat input will be filled with a macro for this action including any provided arguments.
+
 ## Additional Roll Posting Options
 
 ## data-rollname