Jakar.Extensions 10.11.1

• net10.0

  • CommunityToolkit.Diagnostics (>= 8.4.2)
  • Jakar.Json (>= 10.3.0)
  • Jakar.Spans (>= 10.1.0)
  • JetBrains.Annotations (>= 2026.2.0)
  • Microsoft.CodeAnalysis.CSharp (>= 5.9.0)
  • Microsoft.Extensions.Configuration.Binder (>= 10.0.13)
  • Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
  • Microsoft.Extensions.Http (>= 10.0.13)
  • Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
  • Microsoft.Extensions.Options (>= 10.0.13)
  • Microsoft.IdentityModel.JsonWebTokens (>= 8.23.0)
  • Microsoft.IdentityModel.Tokens (>= 8.23.0)
  • Nito.Collections.Deque (>= 1.2.1)
  • OneOf (>= 3.0.271)
  • OneOf.Extended (>= 3.0.271)
  • OneOf.SourceGenerator (>= 3.0.271)
  • OpenTelemetry.Exporter.OpenTelemetryProtocol (>= 1.20.1)
  • OpenTelemetry.Instrumentation.Http (>= 1.20.1)
  • OpenTelemetry.Instrumentation.Runtime (>= 1.20.1)
  • Otp.NET (>= 1.4.1)
  • Serilog (>= 4.4.0)
  • Serilog.Formatting.Compact (>= 3.0.0)
  • Serilog.Sinks.Async (>= 2.1.0)
  • Serilog.Sinks.Console (>= 6.1.1)
  • Serilog.Sinks.Debug (>= 3.0.0)
  • Serilog.Sinks.File (>= 7.0.0)
  • System.ComponentModel.Annotations (>= 5.0.0)
  • System.IO.Hashing (>= 10.0.13)
  • ZLinq (>= 1.5.6)
  • ZLinq.FileSystem (>= 1.5.6)
  • ZXing.Net (>= 0.16.11)

10.10.0: ValueStringBuilder and Sizes moved to the new dependency Jakar.Spans (same namespace, type-forwarded, so no source or binary change); Jakar.Spans adds ValueUtf8Builder and ValueSpanReader<T>. BREAKING: System.Text.Json replaces Newtonsoft.Json; the library is trim and Native AOT compatible (source-generated metadata only). New dependency Jakar.Json (IJsonModel<TSelf>, the [JsonModel] source generator and analyzers, pooled element-wise JSON arrays, SerializeAsStringJsonConverter<T>, plus the Jakar.Json serializer, which [JsonModel] uses behind IJsonModel when it supports the type: most models' ToJson/FromJson now run on it, laid out as Jakar.Json writes ("name" : value) with the context's options mirrored; JsonTypeInfo stays System.Text.Json's); types stay in the Jakar.Extensions namespace. IJsonModel<TSelf> requires static JsonTypeInfo (add [JsonModel]). JToken/JObject/JValue removed: AdditionalData is Dictionary<string, JsonElement>?, ErrorResponse/WebHandler.AsJson/FeedBackTrackerException use JsonNode, ExceptionDetails.Data is JsonObject, LoginRequestValue uses JsonElement. Json.Settings/LoadSettings replaced by Json.Options/AddResolver/GetTypeInfo; generic ToJson<T>(this T) only for IJsonModel types (else Json.Serialize). Typed JsonNode/JsonElement get/add/update/remove helpers. JSON written by 10.x still reads (case-insensitive names, numbers in strings, comments, trailing commas); output keeps PascalCase. PreferenceFile stores {TSelf}.json and imports an existing .ini. Observable collections serialize their unfiltered contents and read in bulk. LocalFile/LocalDirectory serialize as {"FullPath"}. ExceptionDetails(Exception, bool) became Create / CreateWithMethodInfo. WebRequester: AsJson(JsonTypeInfo), AsJsonArray/AsJsonList, BaseClass bodies serialized as their runtime type. Fixes: Json.ToJson(ReadOnlySpan) serialized the whole pooled rental; LocalFile.WriteAsync(string) wrote empty files; LoginRequest copy constructors passed the login as the password; Email.TryParse returned the inverse; GcInfo did not deserialize MemoryInfo. Removed the unused ValueOf package. 10.11.0: BREAKING: built on Jakar.Json 10.3.0, which no longer has System.Text.Json: the library serializes with Jakar.Json only. IJsonModel<TSelf>, the System.Text.Json contexts (JakarExtensionsContext, UserGuidJsonContext, UserLongJsonContext), Json.Options/AddResolver/GetTypeInfo and every JsonTypeInfo overload are removed: models are [JsonModel] types (IJsonSerializable<TSelf>), and generic helpers are constrained to IJsonSerializable<T> or take an IJsonConverter<T> (Json.Serialize<T, TConverter> / Json.Deserialize<T, TConverter>). JsonNode/JsonElement/JsonObject became Jakar.Json's JNode/JObjectNode: AdditionalData (JObjectNode?, ordinal keys, [JsonOverflow]), ErrorResponse, FeedBackTrackerException, ExceptionDetails.Data, LoginRequestValue.Data, IniConfig.ToJsonObject/FromJsonObject and the typed get/add/update helpers; the JsonElement helpers are gone. Output uses Jakar.Json's layout, compact by default; preference files are written indented. PreferenceFile<TSelf> subclasses implement CopyFrom(TSelf). AppVersion is no longer a [JsonModel] (it is written as a JSON string, as before; ToJson/FromJson remain). Observable collections: the System.Text.Json converters are removed; IJsonCollection<TSelf, T> covers [JsonModel] members, root ToJson/FromJson need [JsonModel] elements (or ObservableJson.ToJson/FromJson with a converter). LocalFile/LocalDirectory no longer read a plain path string. WebRequester.CreateJsonContent/CreateJsonArrayContent take JsonWriterOptions, and CreateJsonContentOfRuntimeType resolves the type with JsonCodecRegistry. Jakar.Json's attributes are kept in this assembly's metadata (JAKAR_JSON_KEEP_ATTRIBUTES), so [JsonModel] types in other assemblies see [JsonOverflow] on BaseClass.AdditionalData. New: NullAsEmptyArrayConverter<T, TConverter>; StringTags reads missing or null Tags/Entries as empty. BREAKING: IIObservableCollection<TValue> renamed to IObservableCollection<TValue>. BREAKING: Command<TValue> now follows CommunityToolkit.Mvvm AsyncRelayCommand<T> semantics and implements the new IAsyncCommand<TValue>: ExecutionTask, IsRunning, CanBeCanceled, IsCancellationRequested (with PropertyChanged), ExecuteAsync returning Task, Cancel(), NotifyCanExecuteChanged() (CanExecute no longer raises CanExecuteChanged itself), CommandOptions (AllowConcurrentExecutions, FlowExceptionsToTaskScheduler), CreateCancelCommand(); CanExecute is false while running by default; starting a cancellable handler cancels the previous token; Execute rethrows handler failures on the calling context unless FlowExceptionsToTaskScheduler; object parameters of the wrong type throw ArgumentException. Command<TValue>.Executable accepts CancellationToken-taking handlers, adds Execute(object?, TValue?, CancellationToken), is 16 bytes instead of 72, and no longer drops the Task from Func<TValue?, Task> handlers (it is now awaited). Fixed SelfLogger.WriteLine throwing FormatException for named template holes such as {Error}. Internal folder restructure. Removed the unused Portable.BouncyCastle dependency and System.* package references that are part of the net10.0 shared framework. 10.11.1: Fixed ArrayBuffer<T>.Create / ToArrayBuffer() on sources that cannot report their count (e.g. after Order()): the result held 64 slots padded with default values instead of exactly the source's items. 10.10.0: TelemetrySource uses W3C activity IDs: the process-wide hierarchical default is gone and the StartActivity idFormat default is now Unknown (default parameter values are compiled into call sites, so recompile callers). StartActivity respects the sampler: it returns null instead of throwing when sampled out, no longer forces IsAllDataRequested, the Recorded trace flag (traceFlags is now ActivityTraceFlags?) or Ok status, and keeps the parent tracestate. Constructing a TelemetrySource no longer clears Activity.Current. AppVersion has a TypeConverter, so it binds from configuration strings. TelemetrySpan can target a specific TelemetrySource via TelemetrySpan.Create(TelemetrySource, string).