Forward per-format compiler options from setup()

[adrianbw]

setupKolay spreads userland options into the docs service, but setup() picks a fixed set of option names and builds the compiler options internally — so repl-sdk's supported per-format options (gjs, gmd, hbs, md, …) can't be supplied from an app. The one we need is a custom owner for rendered snippets: ember-repl already defaults each format's owner and spreads user entries over it (gjs: { owner, ...(options.gjs ?? {}) }), so the only missing link is kolay forwarding them.

This adds a formatOptions option to setup() (and the kolay/setup types), keyed by format. Entries merge over the options kolay configures for each format:

await setupKolay(this, {
  formatOptions: {
    gjs: { owner: myOwner },
    gmd: { owner: myOwner },
  },
});

Formats kolay doesn't configure (like gjs) pass straight through; for md/gmd/hbs the user's entries win key-by-key over kolay's. The JSDoc steers plugin additions to the existing remarkPlugins/rehypePlugins options so kolay's own plugins (frontmatter, link rebasing) aren't accidentally replaced.

Testing

Integration test in markdown-and-gjs-md-app: the application route injects a probe owner via formatOptions, and a live gjs snippet on a runtime-compiled page asserts getOwner(this).lookup(...) resolves through it. (The probe page is plain .md on purpose — .gjs.md pages compile at build time and never consult the runtime compiler.)

All five test-apps pass, pnpm lint clean.

Motivation

Our docs app needs to hand rendered snippets an owner that can answer environment-scoped lookups (the ember-provide-consume-context interaction described in customerio/ember-provide-consume-context#58 — providers register on the snippet island's Environment while consumer reads resolve through the host app's renderer). This passthrough is the supported surface for that kind of customization; discussed with @NullVoxPopuli.

---

🤖 Generated with Claude Code

AI attribution: drafted by Claude Code (Fable 5), directed by @adrianbw; the approach (forwarding per-format options through setup()) is per NullVoxPopuli's guidance. Tested as described above; reviewed by the author before opening.

[bolt-new-by-stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[vercel]

@adrianbw is attempting to deploy a commit to the universal-ember Team on Vercel.

A member of the Team first needs to authorize it.