V10.0.1/service update

.docfx/Dockerfile.docfx

@@ -1,4 +1,4 @@
-ARG NGINX_VERSION=1.29.3-alpine
+ARG NGINX_VERSION=1.29.4-alpine
 
 FROM --platform=$BUILDPLATFORM nginx:${NGINX_VERSION} AS base
 RUN rm -rf /usr/share/nginx/html/*

.docfx/docfx.json

@@ -45,7 +45,7 @@
     ],
     "globalMetadata": {
       "_appTitle": "Extensions for Globalization by Codebelt",
-      "_appFooter": "<span>Generated by <strong>DocFX</strong>. Copyright 2024-2025 Geekle. All rights reserved.</span>",
+      "_appFooter": "<span>Generated by <strong>DocFX</strong>. Copyright 2024-2026 Geekle. All rights reserved.</span>",
       "_appLogoPath": "images/50x50.png",
       "_appFaviconPath": "images/favicon.ico",
       "_googleAnalyticsTagId": "G-R07CSX4Z91",

.github/prompts/benchmark.prompt.md

@@ -0,0 +1,164 @@
+---
+mode: agent
+description: 'Writing Performance Benchmarks'
+---
+
+# Benchmark Fixture Prompt (Tuning Benchmarks)
+
+This prompt defines how to generate performance tests (“benchmarks”) for a project/solution using BenchmarkDotNet.  
+Benchmarks are *not* unit tests — they are micro- or component-level performance measurements that belong under the `tuning/` directory and follow strict conventions.
+
+Copilot must follow these guidelines when generating benchmark fixtures.
+
+---
+
+## 1. Naming and Placement
+
+- All benchmark projects live under the `tuning/` folder.  
+  Examples:
+  - `tuning/<ProjectName>.Benchmarks/`
+  - `tuning/<ProjectName>.Console.Benchmarks/`
+
+- **Namespaces must NOT end with `.Benchmarks`.**  
+  They must mirror the production assembly’s namespace.
+
+  Example:  
+  If benchmarking a type inside `YourProject.Console`, then:
+
+  ```csharp
+  namespace YourProject.Console
+  {
+      public class Sha512256Benchmark { … }
+  }
+  ```
+
+* **Benchmark class names must end with `Benchmark`.**
+  Example: `DateSpanBenchmark`, `FowlerNollVoBenchmark`.
+
+* Benchmark files should be located in the matching benchmark project
+  (e.g., benchmarks for `YourProject.Console` go in `YourProject.Console.Benchmarks.csproj`).
+
+* In the `.csproj` for each benchmark project, set the root namespace to the production namespace, for example:
+
+  ```xml
+  <RootNamespace>YourProject.Console</RootNamespace>
+  ```
+
+---
+
+## 2. Attributes and Configuration
+
+Each benchmark class should use:
+
+```csharp
+[MemoryDiagnoser]
+[GroupBenchmarksBy(BenchmarkLogicalGroupRule.ByCategory)]
+```
+
+Optional but strongly recommended where meaningful:
+
+* `[Params(...)]` — define small, medium, large input sizes.
+* `[GlobalSetup]` — deterministic initialization of benchmark data.
+* `[Benchmark(Description = "...")]` — always add descriptions.
+* `[Benchmark(Baseline = true)]` — when comparing two implementations.
+
+Avoid complex global configs; prefer explicit attributes inside the class.
+
+---
+
+## 3. Structure and Best Practices
+
+A benchmark fixture must:
+
+* Measure a **single logical operation** per benchmark method.
+* Avoid I/O, networking, disk access, logging, or side effects.
+* Avoid expensive setup inside `[Benchmark]` methods.
+* Use deterministic data (e.g., seeded RNG or predefined constants).
+* Use `[GlobalSetup]` to allocate buffers, random payloads, or reusable test data only once.
+* Avoid shared mutable state unless reset per iteration.
+
+Use representative input sizes such as:
+
+```csharp
+[Params(8, 256, 4096)]
+public int Count { get; set; }
+```
+
+BenchmarkDotNet will run each benchmark for each parameter value.
+
+---
+
+## 4. Method Naming Conventions
+
+Use descriptive names that communicate intent:
+
+* `Parse_Short`
+* `Parse_Long`
+* `ComputeHash_Small`
+* `ComputeHash_Large`
+* `Serialize_Optimized`
+* `Serialize_Baseline`
+
+When comparing approaches, always list them clearly and tag one as the baseline.
+
+---
+
+## 5. Example Benchmark Fixture
+
+```csharp
+using BenchmarkDotNet.Attributes;
+using BenchmarkDotNet.Configs;
+
+namespace YourProject
+{
+    [MemoryDiagnoser]
+    [GroupBenchmarksBy(BenchmarkLogicalGroupRule.ByCategory)]
+    public class SampleOperationBenchmark
+    {
+        [Params(8, 256, 4096)]
+        public int Count { get; set; }
+
+        private byte[] _payload;
+
+        [GlobalSetup]
+        public void Setup()
+        {
+            _payload = new byte[Count];
+            // deterministic initialization
+        }
+
+        [Benchmark(Baseline = true, Description = "Operation - baseline")]
+        public int Operation_Baseline() => SampleOperation.Process(_payload);
+
+        [Benchmark(Description = "Operation - optimized")]
+        public int Operation_Optimized() => SampleOperation.ProcessOptimized(_payload);
+    }
+}
+```
+
+---
+
+## 6. Reporting and CI
+
+* Benchmark projects live exclusively under `tuning/`. They must not affect production builds.
+* Heavy BenchmarkDotNet runs should *not* run in CI unless explicitly configured.
+* Reports are produced by the benchmark runner and stored under the configured artifacts directory.
+
+---
+
+## 7. Additional Guidelines
+
+* Keep benchmark fixtures focused and readable.
+* Document non-obvious reasoning in short comments.
+* Prefer realistic but deterministic data sets.
+* When benchmarks reveal regressions or improvements, reference the associated PR or issue in a comment.
+* Shared benchmark helpers belong in `tuning/` projects, not in production code.
+
+---
+
+## Final Notes
+
+* Benchmarks are performance tests, not unit tests.
+* Use `[Benchmark]` only for pure performance measurement.
+* Avoid `MethodImplOptions.NoInlining` unless absolutely necessary.
+* Use small sets of meaningful benchmark scenarios — avoid combinatorial explosion.

.github/workflows/pipelines.yml → .github/workflows/ci-pipeline.yml

@@ -1,12 +1,7 @@
-name: Globalization Ext. CI/CD Pipeline
+name: Globalization Ext. CI Pipeline
 on:
   pull_request:
-    paths-ignore:
-      - .codecov
-      - .docfx
-      - .github
-      - .nuget
-      - '**.md'
+    branches: [main]
   workflow_dispatch:
     inputs:
       configuration:
@@ -18,6 +13,9 @@ on:
           - Debug
           - Release
 
+permissions:
+  contents: read
+
 jobs:
   build:
     name: call-build
@@ -48,7 +46,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-24.04, windows-2022]
+        os: [ubuntu-24.04, windows-2025, ubuntu-24.04-arm, windows-11-arm]
         configuration: [Debug, Release]
     uses: codebeltnet/jobs-dotnet-test/.github/workflows/default.yml@v3
     with:
@@ -78,17 +76,17 @@ jobs:
       repository: codebeltnet/globalization
     secrets: inherit
 
-  # codeql:
-  #   name: call-codeql
-  #   needs: [build,test]
-  #   uses: codebeltnet/jobs-codeql/.github/workflows/default.yml@v3
-  #   with:
-  #     projects: src/**/*.csproj
+  codeql:
+    name: call-codeql
+    needs: [build,test]
+    uses: codebeltnet/jobs-codeql/.github/workflows/default.yml@v3
+    with:
+      projects: src/**/*.csproj
 
   deploy:
     if: github.event_name != 'pull_request'
     name: call-nuget
-    needs: [build, pack, test, sonarcloud, codecov]
+    needs: [build, pack, test, sonarcloud, codecov, codeql]
     uses: codebeltnet/jobs-nuget-push/.github/workflows/default.yml@v2
     with:
       version: ${{ needs.build.outputs.version }}

.nuget/Codebelt.Extensions.Globalization/PackageReleaseNotes.txt

@@ -1,4 +1,10 @@
-Version 10.0.0
+Version 10.0.1
+Availability: .NET 10, .NET 9 and .NET Standard 2.0
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
+Version 10.0.0
 Availability: .NET 10, .NET 9 and .NET Standard 2.0
 
 # ALM

CHANGELOG.md

@@ -7,6 +7,10 @@ For more details, please refer to `PackageReleaseNotes.txt` on a per assembly ba
 > [!NOTE]  
 > Changelog entries prior to version 9.0.1 was migrated from previous versions of Cuemon.Extensions.Globalization.
 
+## [10.0.1] - 2026-01-22
+
+This is a service update that focuses on package dependencies.
+
 ## [10.0.0] - 2025-11-13
 
 This is a major release that focuses on adapting the latest `.NET 10` release (LTS) in exchange for current `.NET 8` (LTS).

Codebelt.Extensions.Globalization.slnx

@@ -0,0 +1,11 @@
+<Solution>
+  <Folder Name="/src/">
+    <Project Path="src/Codebelt.Extensions.Globalization/Codebelt.Extensions.Globalization.csproj" />
+  </Folder>
+  <Folder Name="/test/">
+    <Project Path="test/Codebelt.Extensions.Globalization.Tests/Codebelt.Extensions.Globalization.Tests.csproj" />
+  </Folder>
+  <Folder Name="/tooling/">
+    <Project Path="tooling/gse/gse.csproj" />
+  </Folder>
+</Solution>

Directory.Build.props

@@ -2,10 +2,14 @@
 
   <PropertyGroup>
     <IsTestProject>$(MSBuildProjectName.EndsWith('Tests'))</IsTestProject>
+    <IsBenchmarkProject>$(MSBuildProjectName.EndsWith('Benchmarks'))</IsBenchmarkProject>
+    <IsSourceProject>$(MSBuildProjectDirectory.ToLower().StartsWith('$(MSBuildThisFileDirectory.ToLower())src'))</IsSourceProject>
+    <IsToolingProject>$(MSBuildProjectDirectory.ToLower().StartsWith('$(MSBuildThisFileDirectory.ToLower())tooling'))</IsToolingProject>
     <IsLinux>$([MSBuild]::IsOSPlatform('Linux'))</IsLinux>
     <IsWindows>$([MSBuild]::IsOSPlatform('Windows'))</IsWindows>
     <IsMainAuthor Condition="'$(EMAIL)' == 'michael@geekle.io'">true</IsMainAuthor>
     <SkipSignAssembly>false</SkipSignAssembly>
+    <PackageReleaseNotesFile>..\..\.nuget\$(MSBuildProjectName)\PackageReleaseNotes.txt</PackageReleaseNotesFile>
     <LangVersion>latest</LangVersion>
   </PropertyGroup>
 
@@ -14,9 +18,9 @@
     <Deterministic>true</Deterministic>
   </PropertyGroup>
 
-  <PropertyGroup Condition="'$(IsTestProject)' == 'false'">
+  <PropertyGroup Condition="'$(IsSourceProject)' == 'true'">
     <TargetFrameworks>net10.0;net9.0;netstandard2.0</TargetFrameworks>
-    <Copyright>Copyright © Geekle 2025. All rights reserved.</Copyright>
+    <Copyright>Copyright © Geekle 2025-2026. All rights reserved.</Copyright>
     <Authors>gimlichael</Authors>
     <Company>Geekle</Company>
     <Product>Extensions for Globalization API by Codebelt</Product>
@@ -42,7 +46,7 @@
     <SourceRoot Include="$(NuGetPackageRoot)" RepositoryUrl="https://github.com/codebeltnet/globalization" />
   </ItemGroup>
 
-  <ItemGroup Condition="'$(IsTestProject)' == 'false'">
+  <ItemGroup Condition="'$(IsSourceProject)' == 'true'">
     <PackageReference Include="MinVer" PrivateAssets="all" />
     <None Include="..\..\.nuget\icon.png" Pack="true" Visible="false" PackagePath="\" />
     <None Include="..\..\.nuget\$(MSBuildProjectName)\README.md" Pack="true" PackagePath="\" />
@@ -70,6 +74,12 @@
     <UseMicrosoftTestingPlatformRunner>true</UseMicrosoftTestingPlatformRunner>
   </PropertyGroup>
 
+  <PropertyGroup Condition="'$(IsToolingProject)' == 'true'">
+    <IsPackable>false</IsPackable>
+    <OutputType>Exe</OutputType>
+    <SonarQubeExclude>true</SonarQubeExclude>
+  </PropertyGroup>
+
   <ItemGroup Condition="'$(IsTestProject)' == 'true'">
     <PackageReference Include="Microsoft.NET.Test.Sdk" />
     <PackageReference Include="xunit.v3" />
@@ -89,4 +99,22 @@
     <PackageReference Include="Codebelt.Extensions.Xunit" />
   </ItemGroup>
 
+  <PropertyGroup Condition="'$(IsBenchmarkProject)' == 'true'">
+    <TargetFrameworks>net10.0;net9.0;netstandard2.0</TargetFrameworks>
+    <IsPackable>false</IsPackable>
+    <RunAnalyzers>false</RunAnalyzers>
+    <RunAnalyzersDuringBuild>false</RunAnalyzersDuringBuild>
+    <RunAnalyzersDuringLiveAnalysis>false</RunAnalyzersDuringLiveAnalysis>
+    <SonarQubeExclude>true</SonarQubeExclude>
+    <AnalysisLevel>none</AnalysisLevel>
+    <NoWarn>NU1701,NU1902,NU1903</NoWarn>
+    <CheckEolTargetFramework>false</CheckEolTargetFramework>
+    <NuGetAudit>false</NuGetAudit>
+  </PropertyGroup>
+
+  <ItemGroup Condition="'$(IsBenchmarkProject)' == 'true'">
+    <PackageReference Include="BenchmarkDotNet" />
+    <PackageReference Include="BenchmarkDotNet.Diagnostics.Windows" />
+  </ItemGroup>
+
 </Project>