Morphir.Myriad.SystemTextJson.Annotations 0.5.0-alpha.2

Prefix Reserved
This is a prerelease version of Morphir.Myriad.SystemTextJson.Annotations.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Morphir.Myriad.SystemTextJson.Annotations --version 0.5.0-alpha.2
                    
NuGet\Install-Package Morphir.Myriad.SystemTextJson.Annotations -Version 0.5.0-alpha.2
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Morphir.Myriad.SystemTextJson.Annotations" Version="0.5.0-alpha.2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Morphir.Myriad.SystemTextJson.Annotations" Version="0.5.0-alpha.2" />
                    
Directory.Packages.props
<PackageReference Include="Morphir.Myriad.SystemTextJson.Annotations" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Morphir.Myriad.SystemTextJson.Annotations --version 0.5.0-alpha.2
                    
#r "nuget: Morphir.Myriad.SystemTextJson.Annotations, 0.5.0-alpha.2"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Morphir.Myriad.SystemTextJson.Annotations@0.5.0-alpha.2
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Morphir.Myriad.SystemTextJson.Annotations&version=0.5.0-alpha.2&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Morphir.Myriad.SystemTextJson.Annotations&version=0.5.0-alpha.2&prerelease
                    
Install as a Cake Tool

Morphir.Myriad.SystemTextJson.Annotations

Attributes and options for Morphir.Myriad.SystemTextJson, a Myriad plugin that generates trim-safe and Native AOT-safe System.Text.Json converters and contexts for F# records, unions and enums at build time.

This package has no dependency and targets netstandard2.0. Nothing in it runs: the generator reads the attributes from the F# source at build time.

open Morphir.Myriad.SystemTextJson

[<JsonUnion(BaseEncoding = (JsonUnionEncoding.InternalTag ||| JsonUnionEncoding.NamedFields), TagName = "kind")>]
type Shape =
    | [<JsonName "circle">] Circle of radius: float
    | [<JsonName "square">] Square of side: float
Attribute Use
JsonUnion The encoding of one union: base encoding and flags, tag and fields names, naming.
JsonRecord The member rules of one record: naming, skippable options, unknown members, null fields.
JsonName The JSON name of a case or field. More names are accepted when reading.
JsonParsedValue A type that is written as text and read only through its parser.
JsonIgnoreType Leave a type out of the context.
JsonDefaultValue A string, Boolean or numeric literal for an absent record member.
JsonDefaultEmpty An empty sequence or map for an absent member.
JsonDefaultValueProvider A direct call to an accessible static method with no arguments, returning the field's type.
JsonDefaultJson An explicit JSON-literal default read through the generated field codec.
JsonOmitEmpty Leave an empty record collection out on writing.
JsonOmitDefault Leave a Boolean record field out on writing when it equals its JsonDefaultValue.
JsonVersionAlias Read one exact legacy member/version pair and normalize it to the current form.
JsonKnownPaths Require every critical path in a string collection to match the exact allowlist.

Scalar strings are ordinary values, without JSON quoting. Decimal and domain defaults can use JsonDefaultValueProvider(typeof<Defaults>, nameof Defaults.Create); provider code runs only for an absent member at deserialization, and the generated call is checked by the F# compiler. It does not use reflection. Each field can declare only one default. Explicit null retains the field's normal rules.

The generator also supports System.Text.Json's JsonPropertyName and JsonExtensionData attributes; extension data requires a string-keyed JsonElement map record field. Unknown members are preserved beside the named members without a wrapper. New member rules are opt-in; unannotated fields retain their encodings and required-member checks.

The union encodings use the names and meanings of FSharp.SystemTextJson. See the Morphir.Myriad.SystemTextJson guide for the full reference.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Morphir.Myriad.SystemTextJson.Annotations:

Package Downloads
Morphir.Mep

Shared Morphir Extension Protocol messages and transports

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.5.0-alpha.3 57 11/14/2026
0.5.0-alpha.2 62 11/13/2026
0.5.0-alpha.1 60 11/13/2026
0.4.0-alpha.5 60 11/13/2026
0.4.0-alpha.4 67 11/10/2026
0.4.0-alpha.3 80 11/9/2026
0.4.0-alpha.2 53 11/8/2026

### Fixed

- `morphirup setup --yes` and extension package installation work on macOS 15. Before, they failed with `extension.io_error: Cannot access '…/store/extensions/packages/sha256': native error 13.` macOS 15 refuses to rename a directory that is not writable, even when the directory stays in the same parent, and the installer sealed a package (mode 0555) before it published it with a rename. macOS 26 allows that rename, so the macos-latest jobs passed. The installer now seals the package's contents before publication and the package root after it, while it still holds the state lock. An installation of a package that is already in the store seals the root if a publication was interrupted before it did.
- Build: the release and its dry run also run the osx-arm64 setup journey on macOS 15 (`build-morphirup`, `os: macos-15`), beside macos-latest (macOS 26). That leg uploads nothing: the new `morphirup-build.yml` input `upload` (default `true`) is `false` for it, and the macos-latest leg still produces the osx-arm64 assets. Pull requests do not run it.

### Changed

- `morphirup setup` sets up from the [finos/morphir releases](https://github.com/finos/morphir/releases), the official place for Morphir releases, from the next release, `0.5.0-alpha.2`, on. It downloads from `https://github.com/finos/morphir/releases/download/v<version>/`, with the same `v<version>` tag and the same three redirect hosts (`github.com`, `release-assets.githubusercontent.com`, `objects.githubusercontent.com`, at most three redirects), and keeps its `release-checksum` assurance. There is no fallback to the finos/morphir-dotnet releases: a bundle whose asset URLs name finos/morphir-dotnet is refused. A release generation records `https://github.com/finos/morphir` as its repository; the candidate's `sourceRepository` still names finos/morphir-dotnet, where the code is built from.
- The composed local-toolchains family moves from `0.1.0-preview.4` to `0.1.0-preview.5` ([finos/morphir#1171](https://github.com/finos/morphir/pull/1171), merged as `00a48d4a`), which differs from preview.4 only in the release repository of the bundle's asset URLs and of the generation's `acquisition.repository`. The producer writes preview.5, and `morphirup` reads preview.5 only: candidates, bundles, receipts, selections and generations of preview.4 (written by 0.5.0-alpha.1) are not read and are not converted. `select`, `show` and `run` read only the preview.5 selection pointer: in a Home set up with preview.2, preview.3 or preview.4 they refuse with `local.setup_required`, which says to run `morphirup setup --yes` again (and then `select`, for a local candidate). Setup in that Home installs preview.5 beside the earlier generations without reading them, and replaces the selection pointer. A refused `setup`, `select` or `show` writes a preview.5 result. The historical preview.1 local route is unchanged.
- Build: finos/morphir can call `morphirup-build.yml` at a pinned commit of this repository, as it calls `cli-offering.yml`. The new inputs `repository` and `ref` (a full commit SHA) choose what the job checks out and builds, and the Windows source check compares the checkout with `ref`. With the new input `upload-host-offering: true`, a job that packs a toolchain (win-x64, win-arm64, or osx-arm64 with `toolchain: true`) also uploads its self-contained host as the artifact `morphir-dotnet-self-contained-<rid>`: the archive with its `.build-launch.json`, `.build-contents.json` and `.sha256`, the files `cli-offering.yml` uploads for that offering. The inputs default to empty and `false`, so `morphirup.yml` and `deployment.yml` work as before. The checkout no longer keeps the workflow token in the Git configuration.