Add valueTaskValueOption CE for ValueTask<'T voption> computation expressions

[Copilot]

• Create ValueTaskValueOption.fs with utility functions in src/FsToolkit.ErrorHandling/
• Create ValueTaskValueOptionCE.fs with computation expression builder (returning ValueTask<'T voption>) in src/FsToolkit.ErrorHandling/
• Create ValueTaskValueOptionOp.fs with operators in src/FsToolkit.ErrorHandling/
• Update FsToolkit.ErrorHandling.fsproj to include new files
• Create test file ValueTaskValueOptionCE.fs in tests/FsToolkit.ErrorHandling.Tests/
• Update FsToolkit.ErrorHandling.Tests.fsproj to include new test file
• Update Main.fs to include new tests
• Run tests to verify (40 new tests pass)
• Add gitbook documentation (valueTaskValueOption/ce.md, map.md, bind.md, apply.md, either.md, zip.md, others.md) and update SUMMARY.md
• Code review and security scan

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add taskValueOption and valueTaskValueOption CEs</issue_title>
<issue_description>Is your feature request related to a problem?
taskOption CE exists but taskValueOption does not

Describe the solution you'd like
Add taskValueOption and valueTaskValueOption CEs
</issue_description>

<agent_instructions>- Make sure you've added tests and they pass

• Make sure you've added documentation and doc comments</agent_instructions>

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

• Fixes Add taskValueOption and valueTaskValueOption CEs #319

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[TheAngryByrd]

@copilot this is missing docs under gitbook

[Copilot]

@copilot this is missing docs under gitbook

Added gitbook docs in commit 155fec2 — created gitbook/valueTaskValueOption/ with ce.md, map.md, bind.md, apply.md, either.md, zip.md, and others.md, and registered them in SUMMARY.md.

[Copilot]

Pull request overview

Adds a new valueTaskValueOption computation expression to FsToolkit.ErrorHandling, enabling ergonomic composition of ValueTask<'T voption> workflows in the same style as existing taskValueOption and related builders.

Changes:

• Introduces ValueTaskValueOption utility functions (map, bind, apply, zip, either, defaultValue, defaultWith) plus operator helpers.
• Adds the valueTaskValueOption computation expression builder (state-machine-based) for ValueTask<'T voption>.
• Adds comprehensive unit tests and GitBook documentation for the new API surface.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/FsToolkit.ErrorHandling/ValueTaskValueOption.fs	New utility functions for working with ValueTask<'T voption>.
src/FsToolkit.ErrorHandling/ValueTaskValueOptionCE.fs	New computation expression builder for ValueTask<'T voption> (including and!/applicative support).
src/FsToolkit.ErrorHandling/ValueTaskValueOptionOp.fs	Adds operators (<!>, <*>, >>=) for ValueTaskValueOption.
src/FsToolkit.ErrorHandling/FsToolkit.ErrorHandling.fsproj	Includes the new source files in the build (non-Fable).
tests/FsToolkit.ErrorHandling.Tests/ValueTaskValueOptionCE.fs	Adds CE behavior tests mirroring existing CE test coverage patterns.
tests/FsToolkit.ErrorHandling.Tests/FsToolkit.ErrorHandling.Tests.fsproj	Includes the new test file (non-Fable).
tests/FsToolkit.ErrorHandling.Tests/Main.fs	Registers the new test suite in the aggregate test list.
gitbook/valueTaskValueOption/*.md	Adds end-user documentation pages for the new ValueTaskValueOption module and CE.
gitbook/SUMMARY.md	Adds the new ValueTaskValueOption section to GitBook navigation.