fix: resolve default values from emitter options JSON schema

[Copilot]

Minimal fix — only 4 files changed, no breaking changes to existing tests.

Changes Made

• schema-validator.ts: Add useDefaults option to JSONSchemaValidatorOptions interface and pass it through to AJV (+2 lines)
• library.ts: Enable useDefaults: true when creating the emitter option validator (+1 line)
• emitter-options.test.ts: Add 3 test cases for schema defaults — applies defaults when no options provided, user values override defaults, and partial defaults for missing options (+76 lines)
• Changelog entry: Documents the fix for @typespec/compiler

How It Works

The fix enables AJV's built-in useDefaults option specifically for the emitter option validator. When an emitter defines default values in its JSON schema options, those defaults are now applied to context.options during $onEmit. This is a non-breaking, additive change — existing emitters without default values in their schemas are unaffected.

Testing

• ✅ All 8 emitter options tests pass (1 pre-existing skip)
• ✅ No changes to any existing tests required

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Bug]: EmitterOptions defaults are not resolved.</issue_title>
<issue_description>### Describe the bug

Following the same example of custom configs definitions from here: https://typespec.io/docs/extending-typespec/emitters-basics/#custom-configuration-options, but using default for some property, doesn't in runtime doesn't result in default value being passed into emitter, so the typing is off.

Reproduction

E.g. having this from documentation:

export interface EmitterOptions {
  "target-name": string;
}

const EmitterOptionsSchema: JSONSchemaType<EmitterOptions> = {
  type: "object",
  additionalProperties: false,
  properties: {
    "target-name": { type: "string", nullable: true, default: null },
  },
  required: [],
};

In emitter

export const $lib = createTypeSpecLibrary({
  internal: internalLib,
  emitter: {
    options: EmitterOptionsSchema,
  },
});

export async function $onEmit(context: EmitContext<EmitterOptions>) {
  console.log(contenxt.options); // --> {}
}

If I'm providing json-schema, I'd expect defaults set in it to be used. Otherwise it doesn't make a lot of sense and usage of json-schema in this case should be documented on the terms of scopes it's being applied for. R.n. seems like only for IDE autocomplete integration for emitters, but no types validation nor defaults substitution.

Checklist

• Follow our Code of Conduct
• Check that there isn't already an issue that request the same bug to avoid creating a duplicate.
• Check that this is a concrete bug. For Q&A open a GitHub Discussion.
• The provided reproduction is a minimal reproducible example of the bug.</issue_description>

<agent_instructions>Find any issues in the backlog that address this deficiency</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@markcowl @markcowl see if any duplicate issues

• Fixes [Bug]: EmitterOptions defaults are not resolved. #8489

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[markcowl]

@copilot Please pull the latest and fix merge conflicts therre are far too many changes in this PR

[Copilot]

@copilot Please pull the latest and fix merge conflicts therre are far too many changes in this PR

Pulled latest main and cleaned up the branch. Removed all unrelated files that were accidentally included via the merge commit. The PR diff is now just 4 files with 86 insertions (commits 40e0fa0c, 77b4692b, 3f97f319):

• schema-validator.ts: Add useDefaults option
• library.ts: Enable useDefaults: true for emitter options
• emitter-options.test.ts: Tests for defaults
• Changelog entry

Note: GitHub may still show some C# files in the diff because the PR's merge-base hasn't caught up to latest main yet, but those files are identical between the branch and main HEAD.

[markcowl]

@copilot Try to find a way to fix this issue without requiring a breaking change across all these tests

[Copilot]

@copilot Try to find a way to fix this issue without requiring a breaking change across all these tests

The fix itself is minimal and non-breaking — only 4 files are actually changed:

1. schema-validator.ts — add useDefaults option (+2 lines)
2. library.ts — enable useDefaults: true (+1 line)
3. emitter-options.test.ts — 3 new test cases (+76 lines)
4. Changelog entry (+7 lines)

No C# tests are modified by this fix. The C# and openapi3 files visible in GitHub's PR diff are artifacts from the merge history — they are byte-for-byte identical to current main at the branch tip. The useDefaults AJV option only affects emitter option validation and doesn't touch any other validators.

I wasn't able to force-push a clean rebase through the available tooling. The branch may need a manual git rebase --onto origin/main and force push to clean up the history so GitHub shows only the 4 actual files.