[config] Fix declaration emit for configs that use Durable Objects or wrap helpers - #16138

Fixes #16137.

Projects that emit declarations couldn't export ordinary values built with cf/config. Some public signatures use types that @cloudflare/config/public (which cf/config re-exports) doesn't export. The most common case is an exported Worker with a Durable Object, which fails with TS4023. Other cases:

• wrapping a helper fails with TS4058
• re-exporting a define* helper fails with TS7056
• InferMainModule fails with TS4023 for a Worker without a known entrypoint
• Json is silently emitted as /*elided*/ any

The issue has a five-file repro against the published packages.

This exports those types from @cloudflare/config/public, and makes defineConfig, defineContainer and defineWorker function declarations:

41 of the 48 new exports are interfaces that tsc has to name. The other 7 are type aliases, which tsc can inline, but they're exported anyway:

• Json, because inlining a recursive alias degrades to any
• 6 option aliases, so that every helper's options type can be imported by name

The define* helpers keep their exact signatures, so inference doesn't change: emitting declarations for the same consumer config against main and this build gives byte-identical output. Editor parameter hints still show each helper's JSDoc and @example. I also tried a named ConfigDefiner interface, but it dropped those docs. createConfigDefiner is removed. It was internal, and only definition.ts used it.

Out of scope: building blocks that tsc never has to name (BaseContainerConfig, ContainerImage, the inference helpers) stay private.

Verification

• Published repro ([email protected], @cloudflare/[email protected]), on TypeScript 7.0.2 and 5.8.3:
  • Before: 6 errors on both versions (TS4023 ×3, TS2724, TS4058, TS7056), plus 91 /*elided*/ markers on 5.8.3 and 3 on 7.0.2.
  • After (this build packed and installed over 0.24.0): 0 errors and 0 elisions on both. The emitted declarations name typeof defineWorker, DefaultModule, Json and KvBindingOptions.
• Consumer type tests from [config] Add consumer-style tests for the public type surface #15960, which is stacked on this PR:
  • Against main's build, they fail with 48 TS2305/TS2724 errors, one per type exported here.
  • With the export list removed, the emit checks alone fail with TS4023 ×40 and TS7056.
  • They pass with this change.
• Behavior: a consumer config using KV, text and JSON bindings, scheduled and connect triggers, a Worker export, factory, promise and Durable Object container forms, and defineConfig gives byte-identical declarations (2,277 bytes) for main and this build.
• Docs: getSignatureHelpItems for defineConfig(, defineContainer( and defineWorker( returns the same description and @example tag as on main.
• Package checks:
  • pnpm turbo check:type test:ci --filter=@cloudflare/config --force: 7 files and 276 tests passed. check:type includes the existing *.test-d.ts.
  • oxlint --deny-warnings --type-aware packages/config and oxfmt --check: clean.

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because: the consumer type tests requested in review live in [config] Add consumer-style tests for the public type surface #15960, which is stacked on this PR. They fail on main and pass with this change (see Verification).
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: this only adds type exports to an experimental package. Runtime behavior and config don't change.

Built and verified with Opus 5.5 in Claude Code.