More consistently handle schema metadata APIs

[CraigMacomber]

Description

Expose schema metadata in more internal and beta API surfaces.

This is a subset of #25656, but with the public SchemaFactory changes reverted.

Reviewer Guidance

The review process is outlined on this wiki page.

[Copilot]

Pull Request Overview

This PR exposes schema metadata APIs more consistently across internal and beta API surfaces, specifically adding support for metadata options in the record method of SchemaFactoryBeta.

• Adds metadata support to SchemaFactoryBeta.record() method by including options parameter
• Updates various schema factory implementations to use consistent option handling patterns
• Refactors schema functions to accept unified options objects instead of separate metadata parameters

Reviewed Changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/framework/fluid-framework/api-report/*.api.md	Updates API signatures to include metadata parameter for record method
packages/dds/tree/api-report/*.api.md	Updates API signatures and type definitions to support metadata
packages/dds/tree/src/simple-tree/node-kinds/record/recordNodeTypes.ts	Changes TConstructorExtra from never to undefined
packages/dds/tree/src/simple-tree/node-kinds/record/recordNode.ts	Refactors to use nodeOptions instead of separate metadata parameters
packages/dds/tree/src/simple-tree/node-kinds/object/objectNode.ts	Updates to use unified nodeOptions parameter
packages/dds/tree/src/simple-tree/node-kinds/map/mapNode.ts	Updates to use unified nodeOptions parameter
packages/dds/tree/src/simple-tree/node-kinds/array/arrayNode.ts	Updates to use unified nodeOptions parameter
packages/dds/tree/src/simple-tree/api/schemaFactoryBeta.ts	Adds options parameter to record method and refactors implementation
packages/dds/tree/src/simple-tree/api/schemaFactoryAlpha.ts	Updates to use unified nodeOptions pattern
packages/dds/tree/src/simple-tree/api/schemaFactory.ts	Adds debugAssert and updates method signatures
packages/dds/tree/src/test/simple-tree/core/treeNodeSchema.spec.ts	Updates test to use empty object instead of false
.changeset/all-glasses-grab.md	Documents the changes

[github-actions]

🔗 Found some broken links! 💔

Run a link check locally to find them. See
https://github.com/microsoft/FluidFramework/wiki/Checking-for-broken-links-in-the-documentation for more information.

linkcheck output

> fluid-framework-docs-site@0.0.0 ci:check-links /home/runner/work/FluidFramework/FluidFramework/docs
> start-server-and-test "npm run serve -- --no-open" 3000 check-links

1: starting server using command "npm run serve -- --no-open"
and when url "[ 'http://127.0.0.1:3000' ]" is responding with HTTP status code 200
running tests using command "npm run check-links"


> fluid-framework-docs-site@0.0.0 serve
> docusaurus serve --no-open

[SUCCESS] Serving "build" directory at: http://localhost:3000/

> fluid-framework-docs-site@0.0.0 check-links
> linkcheck http://localhost:3000 --skip-file skipped-urls.txt

 ELIFECYCLE  Command failed with exit code 1.