✨ Add csv-table directive

[agoose77]

Implements https://docutils.sourceforge.io/docs/ref/rst/directives.html#csv-table-1, addressing need on #189

• Support URL / file?
• Support headings?
• Handle invalid markup

See #893.

[agoose77]

@rowanc1 this PR will probably be easier to use to audit #1091

[rowanc1]

@agoose77 there needs to be some fixing of the git history now that #1091 is in! In this case, it is just the last commit.

[agoose77]

@rowanc1 I've held off adding file/URL support for this pass - I don't think it should block this PR. I'll discuss that on Discord!

The only outstanding challenge is where to add tests ... I'm somewhat happy to skip tests here, as I think those are more end-to-end features that we might need to do another pass of down the road. That might also be a lazy developer's hat.

[rowanc1]

I think that a small test would be great to have on the directive or main part of the run function (which we will likely need to export later if we are doing a delayed, async load of the CSV in a transform). The test should at least cover the error state of bad CSV. I can add that when I test/export if I get there first!

[rowanc1]

Probably a try catch and errorFile on this if the csv is malformed!

[agoose77]

I've made the change to use fileError, but I want to dig in to examples of fileError that seem to pull the nodes for the options, rather than the directive itself, from the pre-AST. Not quite au-fait with that logic yet, but this is an example:

select('mystDirectiveOption[name="tags"]', data.node) ?? data.node

[rowanc1]

Providing a node with the option reports the correct line number of the option in the error, rather than the directive itself. It falls back to the directive in that case if it can't find the specific option. When we get column numbers and language server support, these will be correctly-placed red-underlines. :)

[agoose77]

Oh yes, I'm following the use-case! What I meant was, I wasn't sure of the AST layout of these raw nodes. But, I think I've found it! I'll revise the change.