genroc

docs / Reference

Project file

`.genroc`, a project's configuration file.

Keys

FieldTypeRequiredDescription
definitionsstring[]What genctl apply, types and schema read when given no -f: files or globs (** matches any depth), resolved against this file.
resolversResolver[]Source resolvers, tried in order and taken first-match on name and suffix; the built-in “process” is appended last, so listing one under that name overrides it.

Resolver

One entry of resolvers.

FieldTypeRequiredDescription
commandstring[]yesThe resolver binary and its arguments, run from this file’s directory with the manifest on stdin.
namestringyesWhat a directive names: ”$<name>: <argument>”.
phasecode | structuralyesWhat the resolver may do. “code” fills a slot with text and runs after inference, with types in hand; “structural” fills a slot or spreads a mapping with any value and runs before it, so it is handed no types.
extstring[]Argument suffixes this resolver accepts (“.ts”, “.genroc.yaml”). Whole suffixes, not extensions; empty accepts anything.
typesobjectDeclarations the resolver wants generated, as name to address: a genctl schema type address, relative to the task the directive sits in, e.g. task.action.input.input.