The myst-spec packages uses JSON Schema as a source of truth. Given that the primary consumers of myst-spec are our own TypeScript packages, and that JSON Schema cannot express the kinds of types that the mdast ecosystem uses, it would be nicer to rewrite this package as mdast types.
This work will not involve upgrading to mdast@4, which is a longer-term goal that will let us upgrade more of our stack.
The
myst-specpackages uses JSON Schema as a source of truth. Given that the primary consumers ofmyst-specare our own TypeScript packages, and that JSON Schema cannot express the kinds of types that themdastecosystem uses, it would be nicer to rewrite this package asmdasttypes.This work will not involve upgrading to
mdast@4, which is a longer-term goal that will let us upgrade more of our stack.