Creation of consolidation transaction for stock

[arthur-clara]

What type of PR is this?

/kind feature

This is the first cut of the addition of the stock consolidation. For review and discussion.

What this PR does / why we need it:

This PR creates a new Stock Transaction called "Consolidation".
See the discussion by VictorMimo on issue 449 on why it is needed.

Which issue(s) this PR fixes:

Fixes #449

[JSv4]

Looks good, @arthur-clara! Couple minor things:

1. Can you merge the latest changes from main back in? I just merged a bunch of PRs and there are a few conflicts and a change to the doc generator which will change the headers in your docs in this PR.
2. I'd suggest doing minItems: 2 and uniqueItems: True attrs on the Consolidation Transaction primitive.

[JSv4]

@arthur-clara, can you use a minItems validation here to ensure there are two or more ids? See here for an example:

Open-Cap-Format-OCF/schema/primitives/objects/transactions/transfer/Transfer.schema.json

Lines 16 to 24 in 7abfda1

	"resulting_security_ids": {
	"title": "Security Transfer - Resulting Security ID Array",
	"description": "Array of identifiers for new security (or securities) created as a result of the transaction",
	"type": "array",
	"items": {
	"type": "string"
	},
	"minItems": 1,
	"uniqueItems": true

[JSv4]

Actually, thinking about #471, @arthur-clara, maybe we can make this more general purpose? Like a multiple security transaction primitive which you can compose into your consolidation transaction. See more here - #471 (comment)

[JSv4]

This should be "MultipleSecurityTransaction" or something similar. Don't put in the resulting_security_ids in the primitive. Also, let's keep the Consolidation primitive even if it's empty as we've done elsewhere.