V2 (#216)

* Add support for 'extras' disk and bundling application resources

* Change path to extras

* add webPreferences to docs

* update packages

* update filament resources

* duplicate v1 docs

* update namespaces to `Native\Desktop`

* update installation instructions

* target v2 branch

* target v2 branch

* fix namespace

* add `native:init` to the broadcasting docs

* basic version switcher

* page-switcher fallback

fallback to introduction when target page doesn't exist

* add context

* version switcher styling

* update vertical margins

* version switcher - final touches

* add fill currentColor

* add desktop repo to release notes

* added v2 upgrade guide

* spelling & sentence flow

* wip - wording

* update links

* rename `native:serve` to `native:run`

* wip - missed a `native:serve` reference

* remove references to Tauri

* improve wording & open outbound links in new tab

* add `ChildProcess::node()` to docs

* updated node example

* update upgdrade guide

* update upgrade guide

* add `assertNode` to childprocess fake

* add `Shell` fake

* improve assertion naming

* Fix link

* Update links

* More links

* Update support policy

* Remove Tauri

---------

Co-authored-by: Simon Hamp <[email protected]>

Author: gwleuverink

README.md

@@ -10,4 +10,4 @@ Also, be sure to read our [contributing guidelines](CONTRIBUTING.md) for help ge
 
 ## Issues
 
-Please raise any issues on the [NativePHP/laravel](https://github.com/NativePHP/laravel/issues) repo.
+Please raise any issues on the [NativePHP/desktop](https://github.com/nativephp/desktop/issues) repo.

app/Livewire/VersionSwitcher.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Livewire;
+
+use Illuminate\View\ViewException;
+use Livewire\Component;
+
+class VersionSwitcher extends Component
+{
+    public string $platform;
+
+    public array $versions;
+
+    public int $version;
+
+    public string $page;
+
+    public function mount(array $versions)
+    {
+        // Since the props are always bound to the uri we fetch them
+        // from the route instead of prop drilling or adding
+        // single-use view data to the controller
+
+        throw_unless(
+            request()->route()->named('docs.show'),
+            ViewException::class,
+            "The version switcher can only be used on the 'docs.show' route."
+        );
+
+        $this->platform = request()->route()->parameter('platform');
+        $this->version = request()->route()->parameter('version');
+        $this->page = request()->route()->parameter('page');
+        $this->versions = $versions;
+    }
+
+    public function updatedVersion()
+    {
+        if (! $this->pageExists($this->platform, $this->version, $this->page)) {
+            $this->page = 'introduction';
+        }
+
+        return redirect()->route('docs.show', [
+            'platform' => $this->platform,
+            'version' => $this->version,
+            'page' => $this->page,
+        ]);
+    }
+
+    protected function pageExists(string $platform, int $version, string $page): bool
+    {
+        return file_exists(resource_path("views/docs/{$platform}/{$version}/{$page}.md"));
+    }
+}

app/Providers/AppServiceProvider.php

@@ -48,10 +48,10 @@ private function registerSharedViewVariables(): void
             ? GitHub::electron()->latestVersion()
             : 'dev'
         );
-        View::share('discordLink', 'https://discord.gg/X62tWNStZK');
+        View::share('discordLink', 'https://discord.gg/nativephp');
         View::share('bskyLink', 'https://bsky.app/profile/nativephp.bsky.social');
         View::share('openCollectiveLink', 'https://opencollective.com/nativephp');
-        View::share('githubLink', 'https://github.com/NativePHP');
+        View::share('githubLink', 'https://github.com/nativephp');
     }
 
     private function sendFailingJobsToSentry(): void

app/Support/GitHub.php

@@ -13,17 +13,26 @@ class GitHub
 
     public const PACKAGE_LARAVEL = 'nativephp/laravel';
 
+    public const PACKAGE_DESKTOP = 'nativephp/desktop';
+
     public const PACKAGE_PHP_BIN = 'nativephp/php-bin';
 
     public function __construct(
         private string $package
     ) {}
 
+    public static function desktop(): static
+    {
+        return new static(static::PACKAGE_DESKTOP);
+    }
+
+    // V1
     public static function electron(): static
     {
         return new static(static::PACKAGE_ELECTRON);
     }
 
+    // V1
     public static function laravel(): static
     {
         return new static(static::PACKAGE_LARAVEL);