save the (...) bits into srcref

[mengwong]

Currently the parser discards any cells of the form /^\(.*\)$/. We are using these cells to record upstream source citations, e.g. (Act1.2.3.a) or (Contract.pg3.para5).

Instead of discarding these elements, save them into a sourceCitation map of input line number to list of strings, saved inside the rule's srcref property.

It would be nice to add more granularity. Suppose we have a multiline rule; how do we preserve the citations for particular lines into the particular resulting syntactic structures in the AST?

Consider https://www.microsoft.com/en-us/research/uploads/prod/2016/11/trees-that-grow.pdf

[ym-han]

It's also worth noting this sort of simpler approach to adding annotations / metadata / citations; the "as per" approach that Joe is taking can be thought of as an example of that. https://reasonablypolymorphic.com/blog/extension-patterns/index.html

[ym-han]

FYI for the current usecase, Joe already has a convention for this / way of dealing with this. So no need to worry about this for now. We can make things even nicer, but that's not high priority.