feat: update project configuration and tools to net10 (#143)

* feat: update project configuration and tools

- Add global.json for SDK versioning
- Update Directory.Build.props to include versioning
- Modify Perla.fsproj to target net10.0 and add runtime identifiers
- Refactor tools.fsx to correct project references and streamline NuGet packaging

* chore: formatting

* fix(ProxyService): handle multipart/form-data requests

- Added check for multipart/form-data in Content-Type header.
- Implemented handling of form fields and file uploads in multipart requests.
- Updated content assignment based on request type.

* chore(launch.json): update configurations

- Changed preLaunchTask from "build" to "Build: Perla.fsproj"
- Updated program path to use net10.0 instead of net9.0
- Modified cwd for "Perla serve" configuration

* fix(ProxyService): improve header writing and add cancellation support

- Ensure proper handling of exceptions during stream transfer.

* fix(ProxyService): enhance header writing and support for chunked transfer

- Added `writeHeaders` function to handle response headers.
- Implemented `transferChunkedPipe` and `transferPlainPipe` for streaming responses.
- Updated logic to check for chunked responses and handle them appropriately.
- Improved header handling for various request types.

* feat(Commands, Handlers, Program): Enable interactive mode

- Renamed 'Install' command to 'Restore' for clarity.
- Added aliases for commands to improve usability.
- Introduced interactive mode for command execution.
- Updated logging for command success and failure.

* refactor(Interactive): simplify command execution logic

* refactor(descriptions.json): update schema and improve descriptions

- Replaced outdated keys and descriptions with updated schema versioning.
- Enhanced clarity of configuration options for better understanding.
- Deprecated several keys and added new ones for improved functionality.

* chore: bump the dotnet version

* feat: don't make the dotnet tool run self-contained

Author: AngelMunoz

.vscode/launch.json

@@ -13,8 +13,8 @@
       "name": "Perla serve",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": ["serve"],
       "cwd": "${workspaceFolder}/docs",
       "stopAtEntry": false,
@@ -24,8 +24,8 @@
       "name": "Perla install",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": ["install"],
       "cwd": "${workspaceFolder}/sample",
       "stopAtEntry": false,
@@ -35,19 +35,19 @@
       "name": "Perla build",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": ["build"],
-      "cwd": "${workspaceFolder}/docs",
+      "cwd": "${workspaceFolder}/sample",
       "stopAtEntry": false,
       "console": "integratedTerminal"
     },
     {
       "name": "Perla new",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": ["new", "samplixor"],
       "cwd": "${workspaceFolder}/../",
       "stopAtEntry": false,
@@ -57,8 +57,8 @@
       "name": "Perla test",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": ["test"],
       "cwd": "${workspaceFolder}/sample",
       "stopAtEntry": false,
@@ -68,8 +68,8 @@
       "name": "Perla test watch headless false",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": ["test", "--headless", "false", "-w"],
       "cwd": "${workspaceFolder}/sample",
       "stopAtEntry": false,
@@ -79,8 +79,8 @@
       "name": "Perla serve docs",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": ["serve"],
       "cwd": "${workspaceFolder}/docs",
       "stopAtEntry": false,
@@ -90,8 +90,8 @@
       "name": "Perla add @shoelace-style/shoelace",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": ["add", "@shoelace-style/shoelace"],
       "cwd": "${workspaceFolder}/docs",
       "stopAtEntry": false,
@@ -101,8 +101,8 @@
       "name": "Build Docs",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": ["build"],
       "cwd": "${workspaceFolder}/docs",
       "stopAtEntry": false,
@@ -112,8 +112,8 @@
       "name": "Describe ",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": [
         "describe",
         "fable",
@@ -132,8 +132,8 @@
       "name": "Describe Current",
       "type": "coreclr",
       "request": "launch",
-      "preLaunchTask": "build",
-      "program": "${workspaceFolder}/src/Perla/bin/Debug/net9.0/Perla.dll",
+      "preLaunchTask": "Build: Perla.fsproj",
+      "program": "${workspaceFolder}/src/Perla/bin/Debug/net10.0/Perla.dll",
       "args": ["describe", "--current"],
       "cwd": "${workspaceFolder}/sample",
       "stopAtEntry": false,

docs/assets/content/migrate.md

@@ -308,9 +308,9 @@ Options:
 
 Commands:
   create, generate, n, new <name>        Creates a new project based on the selected template if it exists
-  install                                Installs the project dependencies from the perla.json file
-  add <packages>                         Adds a package to the project dependencies
-  remove <packages>                      Removes a package from the project dependencies
+  r, restore                             Restores the project dependencies from the perla.json file
+  a, add, i, install <packages>          Adds a package to the project dependencies
+  remove, rm <packages>                  Removes a package from the project dependencies
   list, ls                               Lists the current dependencies in a table or an npm style json string
   s, serve, start                        Starts the development server and if fable projects are present it also takes
                                          care of it.

docs/assets/docs/v1/features/fable.md

@@ -138,7 +138,7 @@ Your HTML file should look along these lines
 
 5. Install your dependencies. Example:
 
-   - `dotnet perla add react react-dom react-dom/client`
+   - `perla add react react-dom react-dom/client`
 
    To identify which dependencies are the ones you actually need, they are usually in the `dependencies` object inside your `package.json`
 

docs/assets/docs/v1/features/package-manager.md

@@ -112,12 +112,12 @@ When removing a package, Perla will:
 
 Note that when using `useLocalPkgs: true`, Perla will regenerate the import map with the remaining packages to ensure consistency between your `perla.json` and the local `node_modules` directory.
 
-## Install Packages
+## Restore Packages
 
-To install or reinstall all dependencies listed in your `perla.json` file, run:
+To restore or reinstall all dependencies listed in your `perla.json` file, run:
 
 ```bash
-perla install
+perla restore
 ```
 
 This command will:
@@ -126,18 +126,18 @@ This command will:
 2. Generate an import map for all dependencies
 3. If `useLocalPkgs` is `true`, download all package files and create a local `node_modules` structure
 
-### Installation Options
+### Restore Options
 
-You can modify the installation behavior with these flags however, to make them permanent you have to update the perla.json configuration file:
+You can modify the restore behavior with these flags however, to make them permanent you have to update the perla.json configuration file:
 
 ```bash
-# Change the provider for this installation
-perla install --source jspm     # Use JSPM (default)
-perla install --source unpkg    # Use Unpkg
-perla install --source jsdelivr # Use JsDelivr
+# Change the provider for this restore
+perla restore --source jspm     # Use JSPM (default)
+perla restore --source unpkg    # Use Unpkg
+perla restore --source jsdelivr # Use JsDelivr
 
 # Control offline mode
-perla install --offline         # Enable local packages mode
+perla restore --offline         # Enable local packages mode
 ```
 
 These options can also be configured in your `perla.json` file:

docs/assets/docs/v1/reference/cli.md

@@ -47,11 +47,11 @@ Removes a package from the project dependencies.
 
 - `packages`: One or more package names to remove (required)
 
-### Install - `perla install`
+### Restore - `perla restore`
 
-Installs the project dependencies from the perla.json file.
+Restores the project dependencies from the perla.json file.
 
-- `-o`, `--offline`: Install packages without network access
+- `-o`, `--offline`: Restore packages without network access
 - `-s`, `--source <provider>`: The source to download packages from (jspm.io, unpkg, jsdelivr)
 
 ### List - `perla list`

docs/perla.json

@@ -2,7 +2,10 @@
   "$schema": "../perla.schema.json",
   "schema-version": "2025-07",
   "provider": "jspm",
-  "plugins": ["perla-esbuild-plugin", "markdown-plugin"],
+  "plugins": [
+    "perla-esbuild-plugin",
+    "markdown-plugin"
+  ],
   "useLocalPkgs": true,
   "mountDirectories": {
     "/": "./sw",
@@ -14,7 +17,10 @@
     "jsxImportSource": "preact"
   },
   "build": {
-    "includes": ["lfs:**/src/*.ico", "vfs:**/assets/**/*.html"]
+    "includes": [
+      "lfs:**/src/*.ico",
+      "vfs:**/assets/**/*.html"
+    ]
   },
   "dependencies": {
     "@ctrl/tinycolor": "4.1.0",
@@ -48,4 +54,4 @@
     "preact/jsx-runtime": "10.26.9",
     "qr-creator": "1.0.0"
   }
-}
+}

docs/perla.json.importmap

@@ -1,6 +1,6 @@
 {
   "imports": {
-    "@ctrl/tinycolor": "/node_modules/@ctrl/tinycolor/dist/public_api.js",
+    "@ctrl/tinycolor": "/node_modules/@ctrl/tinycolor/dist/module/public_api.js",
     "@floating-ui/core": "/node_modules/@floating-ui/core/dist/floating-ui.core.mjs",
     "@floating-ui/dom": "/node_modules/@floating-ui/dom/dist/floating-ui.dom.mjs",
     "@floating-ui/utils": "/node_modules/@floating-ui/utils/dist/floating-ui.utils.mjs",

global.json

@@ -0,0 +1,7 @@
+{
+  "sdk": {
+    "version": "10.0.100-preview.7.25380.108",
+    "allowPrerelease": true,
+    "rollForward": "latestFeature"
+  }
+}

src/Directory.Build.props

@@ -13,6 +13,7 @@
         <WarnOn>3390;$(WarnOn)</WarnOn>
         <Nullable>enable</Nullable>
         <LangVersion>preview</LangVersion>
+        <Version>1.0.0-rc-001</Version>
     </PropertyGroup>
     <ItemGroup>
         <None Include="$(MSBuildThisFileDirectory)\..\LICENSE" Pack="true" PackagePath="\"/>

src/Perla.Logger/Library.fs

@@ -285,7 +285,7 @@ type SpectreSink() =
 
       try
         AnsiConsole.MarkupLine
-          $"[[[grey]{timestamp}[/] [{levelColor}]{levelString}[/] {prefix}]]  {message}"
+          $"[[[grey]{timestamp}[/] [{levelColor}]{levelString}[/] {prefix}]]  {message.EscapeMarkup()}"
       with :? InvalidOperationException ->
         ()