Feature/avalonia font (#193)

* Change Avalonia apps to use Fira Sans and Fire Code fonts.
Unicode symbols were not rendered correct in Avalonia Browser, so those symbols remade as controls with drawn vector graphics.

* Tweak Avalonia layout

* Secure docs publish by forcing hash verification of pip dependencies.

* Bump VSCode extension node dependencies with security vulnerabilities

Author: highbyte

.github/workflows/docs-publish-to-gh-pages.yml

@@ -10,7 +10,9 @@ on:
       - 'docs/**'
       - 'includes/**'
       - 'mkdocs.yml'
+      - 'requirements-docs.in'
       - 'requirements-docs.txt'
+      - '.pip-tools.toml'
       - '.github/workflows/docs-publish-to-gh-pages.yml'
 
 # Prevent concurrent deployments to GitHub Pages
@@ -38,7 +40,7 @@ jobs:
           cache-dependency-path: requirements-docs.txt
 
       - name: Install MkDocs and dependencies
-        run: "pip install --only-binary :all: -r requirements-docs.txt"
+        run: "pip install --require-hashes --only-binary :all: -r requirements-docs.txt"
 
       - name: Build static site with MkDocs
         run: mkdocs build --strict --site-dir ${{ env.BUILD_OUTPUT_WORKING_DIR }}

.pip-tools.toml

@@ -0,0 +1,2 @@
+[tool.pip-tools]
+generate-hashes = true

.pre-commit-config.yaml

@@ -0,0 +1,10 @@
+repos:
+  - repo: https://github.com/jazzband/pip-tools
+    rev: v7.5.3
+    hooks:
+      - id: pip-compile
+        name: pip-compile requirements-docs.in
+        files: ^requirements-docs\.(in|txt)$
+        args:
+          - --output-file=requirements-docs.txt
+          - requirements-docs.in

BUILD_DOCS.md

@@ -65,18 +65,27 @@ pip install -r requirements-docs.txt
 
 ## 3. Upgrade dependencies
 
-Dependencies are managed with [`pip-tools`](https://pip-tools.readthedocs.io/). The file you edit is `requirements-docs.in` (top-level only); the lock file `requirements-docs.txt` is auto-generated.
+Dependencies are managed with [`pip-tools`](https://pip-tools.readthedocs.io/). The file you edit is `requirements-docs.in` (top-level only); the lock file `requirements-docs.txt` is auto-generated and includes artifact hashes.
 
 **One-time setup:**
 
 ```bash
 python3 -m pip install pip-tools
 ```
 
+**Optional: auto-regenerate the lock file on commit:**
+
+```bash
+python3 -m pip install pre-commit
+pre-commit install
+```
+
+With the pre-commit hook installed, editing `requirements-docs.in` will automatically refresh `requirements-docs.txt` during commit.
+
 **To upgrade mkdocs-material** (or add new deps):
 
 1. Edit `requirements-docs.in` — e.g. change `mkdocs-material==9.7.6` to a newer version.
-2. Regenerate the lock file:
+2. Regenerate the lock file (if you are not using the pre-commit hook):
 
 ```bash
 python3 -m piptools compile requirements-docs.in -o requirements-docs.txt

README.md

@@ -70,4 +70,5 @@ For the full list of missing features and constraints, see [Limitations](https:/
 
 # Credits
 
-- [Kristoffer Strube](https://github.com/KristofferStrube) for the original Blazor WASM async interop code for [WebAudio](https://github.com/KristofferStrube/Blazor.WebAudio), [DOM](https://github.com/KristofferStrube/Blazor.DOM), and [IDL](https://github.com/KristofferStrube/Blazor.WebIDL) that was the basis for a synchronous implementation in this repo. Copyright notice [here](src/libraries/Highbyte.DotNet6502.Impl.AspNet/JSInterop/JSInterop_OriginalLicense.MD).
+- Third-party credits, including bundled fonts, are listed in [References](docs/home/references.md#credits).
+

docs/home/references.md

@@ -66,4 +66,6 @@ Used during development to verify behavior of the 6502 CPU and C64.
 
 ## Credits
 
-- [Kristoffer Strube](https://github.com/KristofferStrube) for the original Blazor WASM async interop code for [WebAudio](https://github.com/KristofferStrube/Blazor.WebAudio), [DOM](https://github.com/KristofferStrube/Blazor.DOM), and [IDL](https://github.com/KristofferStrube/Blazor.WebIDL) that was the basis for a synchronous implementation in this repo.
+- Bundled UI fonts: [Fira Sans](https://fonts.google.com/specimen/Fira+Sans) from [Google Fonts](https://fonts.google.com/) and [Fira Code](https://github.com/tonsky/FiraCode) from the official project. Both are distributed under the [SIL Open Font License 1.1](https://openfontlicense.org/), with license text included alongside the bundled font files in the repository.
+
+- [Kristoffer Strube](https://github.com/KristofferStrube) for the original Blazor WASM async interop code for [WebAudio](https://github.com/KristofferStrube/Blazor.WebAudio), [DOM](https://github.com/KristofferStrube/Blazor.DOM), and [IDL](https://github.com/KristofferStrube/Blazor.WebIDL) that was the basis for a synchronous implementation in this repo. Copyright notice [here](https://github.com/highbyte/dotnet-6502/blob/master/src/libraries/Highbyte.DotNet6502.Impl.AspNet/Audio/WebAudioAPISynth/JSInterop/JSInterop_OriginalLicense.MD).

requirements-docs.txt

@@ -17,10 +17,10 @@
     </AndroidResource>
   </ItemGroup>
 
-  <ItemGroup>
-    <PackageReference Include="Avalonia.Android" />
-    <PackageReference Include="Xamarin.AndroidX.Core.SplashScreen" />
-  </ItemGroup>
+  <ItemGroup>
+    <PackageReference Include="Avalonia.Android" />
+    <PackageReference Include="Xamarin.AndroidX.Core.SplashScreen" />
+  </ItemGroup>
 
   <ItemGroup>
     <ProjectReference Include="..\Highbyte.DotNet6502.App.Avalonia.Core\Highbyte.DotNet6502.App.Avalonia.Core.csproj" />

src/apps/Avalonia/Highbyte.DotNet6502.App.Avalonia.Android/Highbyte.DotNet6502.App.Avalonia.Android.csproj

@@ -1,7 +1,6 @@
 using Android.App;
 using Android.Content.PM;
 using Android.Runtime;
-using Avalonia;
 using Avalonia.Android;
 using Highbyte.DotNet6502.App.Avalonia.Core;
 
@@ -24,7 +23,4 @@ protected AndroidApp(IntPtr javaReference, JniHandleOwnership transfer)
         : base(javaReference, transfer)
     {
     }
-
-    protected override AppBuilder CustomizeAppBuilder(AppBuilder builder)
-        => base.CustomizeAppBuilder(builder).WithInterFont();
 }

src/apps/Avalonia/Highbyte.DotNet6502.App.Avalonia.Android/MainActivity.cs

@@ -535,10 +535,9 @@ await AutomatedStartupHandler.ExecuteAsync(
         // Start Avalonia app
         try
         {
-            WriteBootstrapLog("Starting Avalonia Browser app...");
-            await BuildAvaloniaApp(configuration, emulatorConfig, logStore, logConfig, loggerFactory, avaloniaLoggerBridge, browserGamepad, scriptingEngine, LoadScript, SaveScript, DeleteScript, LoadExamplesAsync, automatedStartupRunner: automatedStartupRunner)
-                .WithInterFont()
-                .StartBrowserAppAsync("out");
+            WriteBootstrapLog("Starting Avalonia Browser app...");
+            await BuildAvaloniaApp(configuration, emulatorConfig, logStore, logConfig, loggerFactory, avaloniaLoggerBridge, browserGamepad, scriptingEngine, LoadScript, SaveScript, DeleteScript, LoadExamplesAsync, automatedStartupRunner: automatedStartupRunner)
+                .StartBrowserAppAsync("out");
 
             WriteBootstrapLog("Avalonia Browser app exiting.");
         }