Render a union type for parsed instructions in js-experimental

[mcintyre94]

This PR adds a new union type to each program, where each variant is an instructionType from its instruction types enum together with the parsed type. Eg:

export type ParsedMplTokenAuthRulesInstruction =
  | ({
      instructionType: MplTokenAuthRulesInstruction.CreateRuleSet;
    } & ParsedCreateRuleSetInstruction)
  | ({
      instructionType: MplTokenAuthRulesInstruction.Validate;
    } & ParsedValidateInstruction)
  | ({
      instructionType: MplTokenAuthRulesInstruction.CreateFrequencyRule;
    } & ParsedCreateFrequencyRuleInstruction);

This allows consumers to parse instructions and then pass them around as eg ParsedMplTokenAuthRulesInstruction. They can then use instructionType to distinguish the variants, and then access the known parsed type. Passing around ParsedCreateRuleSetInstruction is insufficient because it doesn't have an instruction type field that we can discriminate on.

This gives more flexibility, particularly to consumers that are dealing with parsed instructions from multiple programs.

[lorisleiva]

This is great, thank you! Just a few comments and LGTM.

You might want to write a small test on the programsPage.test.ts file for that union type. It should be fairly similar to that one:

kinobi/test/renderers/js-experimental/programsPage.test.ts

Lines 108 to 127 in 761b969

	test('it renders an enum of all available instructions for a program', (t) => {
	// Given the following program.
	const node = programNode({
	name: 'splToken',
	publicKey: 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
	instructions: [
	instructionNode({ name: 'mintTokens' }),
	instructionNode({ name: 'transferTokens' }),
	instructionNode({ name: 'updateAuthority' }),
	],
	});
	// When we render it.
	const renderMap = visit(node, getRenderMapVisitor());
	// Then we expect the following program instruction enum.
	renderMapContains(t, renderMap, 'programs/splToken.ts', [
	'export enum SplTokenInstruction { MintTokens, TransferTokens, UpdateAuthority };',
	]);
	});

Finally, don't forget to mark this PR as a patch update by running changeset and providing a description of the change (you can just copy the PR title).

[changeset-bot]

🦋 Changeset detected

Latest commit: 3856336

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@metaplex-foundation/kinobi	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[mcintyre94]

Thanks Loris! Updated those, and added a test and changeset :)

[lorisleiva]

Perfection 🫶