Add optional author 'link' field to packages

dooly123 · dooly123 · commit 43f9a35834c0 · 2026-07-05T19:24:46.000+10:00
A per-package homepage / showcase / docs URL (validated http(s)). Shown as a 'Website' link on the app's package cards and the website's package detail, with a matching submit-form field. Flows seed -&gt; RegistryPackage -&gt; packages.json + (via BuildCatalog) catalog.json -&gt; CatalogPackageVersion. Adds a reusable Button.link style.
diff --git a/src/BasisPM.App/Styles/BasisTheme.axaml b/src/BasisPM.App/Styles/BasisTheme.axaml
@@ -369,6 +369,25 @@
         <Setter Property="TextElement.Foreground" Value="#FFFFFF"/>
     </Style>
 
+    <!-- Small inline text link (brand-coloured, no chrome) -->
+    <Style Selector="Button.link">
+        <Setter Property="Background" Value="Transparent"/>
+        <Setter Property="BorderThickness" Value="0"/>
+        <Setter Property="Padding" Value="0"/>
+        <Setter Property="FontSize" Value="11"/>
+        <Setter Property="FontWeight" Value="SemiBold"/>
+        <Setter Property="Foreground" Value="{StaticResource BasisBrandBrush}"/>
+        <Setter Property="Cursor" Value="Hand"/>
+    </Style>
+    <Style Selector="Button.link /template/ ContentPresenter">
+        <Setter Property="Background" Value="Transparent"/>
+        <Setter Property="TextElement.Foreground" Value="{StaticResource BasisBrandBrush}"/>
+    </Style>
+    <Style Selector="Button.link:pointerover /template/ ContentPresenter">
+        <Setter Property="Background" Value="Transparent"/>
+        <Setter Property="TextElement.Foreground" Value="{StaticResource BasisBrandHoverBrush}"/>
+    </Style>
+
     <!-- Expander: a frosted-glass collapsible section that matches Border.card -->
     <Style Selector="Expander">
         <Setter Property="Background" Value="{StaticResource BasisGlassBrush}"/>
diff --git a/src/BasisPM.App/ViewModels/PackagesViewModel.cs b/src/BasisPM.App/ViewModels/PackagesViewModel.cs
@@ -75,12 +75,14 @@ public bool IsGridView
     public string LayoutToggleLabel => _isGridView ? L.Tr("packages.button.listView") : L.Tr("packages.button.gridView");
 
     public RelayCommand<CatalogPackageVersion> InstallCommand { get; }
+    public RelayCommand<CatalogPackageVersion> RemoveCommand { get; }
     public RelayCommand<InstalledPackageRow> UninstallCommand { get; }
     public RelayCommand RefreshCommand { get; }
     public RelayCommand AddFromGitHubCommand { get; }
     public RelayCommand CreateBundleCommand { get; }
     public RelayCommand<CatalogPackageVersion> ChooseVersionCommand { get; }
     public RelayCommand ToggleLayoutCommand { get; }
+    public RelayCommand<string> OpenLinkCommand { get; }
 
     public PackagesViewModel(UserSettingsService settingsService, CatalogService catalogService, UnityProjectService projectService, MainWindowViewModel shell)
     {
@@ -91,12 +93,14 @@ public PackagesViewModel(UserSettingsService settingsService, CatalogService cat
         _shell = shell;
 
         InstallCommand = new RelayCommand<CatalogPackageVersion>(InstallCuratedAsync);
+        RemoveCommand = new RelayCommand<CatalogPackageVersion>(RemoveAvailableAsync);
         UninstallCommand = new RelayCommand<InstalledPackageRow>(UninstallAsync);
         RefreshCommand = new RelayCommand(RefreshAsync);
         AddFromGitHubCommand = new RelayCommand(AddFromGitHubAsync);
         CreateBundleCommand = new RelayCommand(CreateBundleAsync);
         ChooseVersionCommand = new RelayCommand<CatalogPackageVersion>(ChooseVersionAsync);
         ToggleLayoutCommand = new RelayCommand(() => IsGridView = !IsGridView);
+        OpenLinkCommand = new RelayCommand<string>(url => { if (!string.IsNullOrWhiteSpace(url)) ExternalLink.Open(url!); });
     }
 
     /// <summary>Applies the persisted layout choice at startup without re-saving it.</summary>
@@ -372,11 +376,24 @@ private async Task ChooseVersionAsync(CatalogPackageVersion? entry)
 
     private async Task UninstallAsync(InstalledPackageRow? row)
     {
-        if (row is null || _install is null) return;
-        if (_install.Manifest.Dependencies.Remove(row.Name))
+        if (row is null) return;
+        await RemoveByNameAsync(row.Name, row.DisplayName);
+    }
+
+    /// <summary>Removes an already-installed package straight from the "Available" list.</summary>
+    private async Task RemoveAvailableAsync(CatalogPackageVersion? entry)
+    {
+        if (entry is null) return;
+        await RemoveByNameAsync(entry.Name, entry.DisplayName);
+    }
+
+    private async Task RemoveByNameAsync(string name, string displayName)
+    {
+        if (_install is null) return;
+        if (_install.Manifest.Dependencies.Remove(name))
         {
             await _projectService.SaveManifestAsync(_install.UnityProjectPath, _install.Manifest);
-            _shell.SetStatus(L.Tr("packages.status.removed", row.DisplayName), StatusKind.Success);
+            _shell.SetStatus(L.Tr("packages.status.removed", displayName), StatusKind.Success);
             RefreshInstalled();
         }
     }
@@ -624,6 +641,8 @@ public sealed record PackageRow(CatalogPackageVersion Entry, string? InstalledVe
     public string Owner => PackagesViewModel.OwnerOf(Entry.Name);
     public string Initial => string.IsNullOrWhiteSpace(DisplayName) ? "?" : DisplayName.TrimStart()[..1].ToUpperInvariant();
     public bool HasGit => !string.IsNullOrWhiteSpace(Entry.Url);
+    public string? Link => Entry.Link;
+    public bool HasLink => !string.IsNullOrWhiteSpace(Entry.Link);
 }
 
 public sealed record InstalledPackageRow(string Name, string DisplayName, string Version, bool IsFromGit);
diff --git a/src/BasisPM.App/Views/PackagesView.axaml b/src/BasisPM.App/Views/PackagesView.axaml
@@ -99,6 +99,10 @@
                                                         </Border>
                                                         <TextBlock Text="{Binding Author, StringFormat='by {0}'}" Classes="dim" FontSize="11" VerticalAlignment="Center" IsVisible="{Binding HasAuthor}"/>
                                                         <TextBlock Text="{Binding Unity, StringFormat='Unity {0}'}" Classes="dim" FontSize="11" VerticalAlignment="Center" IsVisible="{Binding HasUnity}"/>
+                                                        <Button Content="Website ↗" Classes="link" VerticalAlignment="Center" IsVisible="{Binding HasLink}"
+                                                                ToolTip.Tip="{Binding Link}"
+                                                                Command="{Binding #Root.((vm:PackagesViewModel)DataContext).OpenLinkCommand}"
+                                                                CommandParameter="{Binding Link}"/>
                                                     </StackPanel>
                                                 </StackPanel>
                                                 <StackPanel Grid.Column="2" Width="160" Spacing="8" VerticalAlignment="Center">
@@ -110,6 +114,10 @@
                                                             ToolTip.Tip="{loc:Tr packages.tooltip.chooseVersion}"
                                                             Command="{Binding #Root.((vm:PackagesViewModel)DataContext).ChooseVersionCommand}"
                                                             CommandParameter="{Binding Entry}"/>
+                                                    <Button Content="{loc:Tr packages.button.remove}" Classes="danger" HorizontalAlignment="Stretch" FontSize="11" Padding="10,6"
+                                                            IsVisible="{Binding IsInstalled}"
+                                                            Command="{Binding #Root.((vm:PackagesViewModel)DataContext).RemoveCommand}"
+                                                            CommandParameter="{Binding Entry}"/>
                                                 </StackPanel>
                                             </Grid>
                                         </Border>
@@ -151,6 +159,10 @@
                                                             ToolTip.Tip="{loc:Tr packages.label.license}">
                                                         <TextBlock Text="{Binding License, StringFormat='⚖ {0}'}" FontSize="10" Classes="muted"/>
                                                     </Border>
+                                                    <Button Content="Website ↗" Classes="link" VerticalAlignment="Center" IsVisible="{Binding HasLink}"
+                                                            ToolTip.Tip="{Binding Link}"
+                                                            Command="{Binding #Root.((vm:PackagesViewModel)DataContext).OpenLinkCommand}"
+                                                            CommandParameter="{Binding Link}"/>
                                                 </StackPanel>
                                                 <Button Content="{Binding ButtonLabel}" Classes="primary" HorizontalAlignment="Stretch"
                                                         Command="{Binding #Root.((vm:PackagesViewModel)DataContext).InstallCommand}"
@@ -160,6 +172,10 @@
                                                         ToolTip.Tip="{loc:Tr packages.tooltip.chooseVersion}"
                                                         Command="{Binding #Root.((vm:PackagesViewModel)DataContext).ChooseVersionCommand}"
                                                         CommandParameter="{Binding Entry}"/>
+                                                <Button Content="{loc:Tr packages.button.remove}" Classes="danger" HorizontalAlignment="Stretch" FontSize="11" Padding="10,6"
+                                                        IsVisible="{Binding IsInstalled}"
+                                                        Command="{Binding #Root.((vm:PackagesViewModel)DataContext).RemoveCommand}"
+                                                        CommandParameter="{Binding Entry}"/>
                                             </StackPanel>
                                         </Border>
                                     </DataTemplate>
diff --git a/src/BasisPM.Core/Models/CatalogEntry.cs b/src/BasisPM.Core/Models/CatalogEntry.cs
@@ -30,6 +30,8 @@ public sealed class CatalogPackageVersion
     [JsonPropertyName("author")] public CatalogAuthor? Author { get; set; }
     // Optional self-hosted promo image URL (served from the registry's icons/ folder).
     [JsonPropertyName("image")] public string? Image { get; set; }
+    // Optional author-provided link (homepage / showcase / docs), surfaced in the desktop client.
+    [JsonPropertyName("link")] public string? Link { get; set; }
 }
 
 public sealed class CatalogAuthor
diff --git a/src/BasisPM.Server/Models/RegistryPackage.cs b/src/BasisPM.Server/Models/RegistryPackage.cs
@@ -37,6 +37,8 @@ public sealed class RegistryPackage
     // Optional per-package community + funding links, shown on the package's registry page.
     [JsonPropertyName("discord")] public string? Discord { get; set; }
     [JsonPropertyName("donate")] public string? Donate { get; set; }
+    // Optional author-provided link (homepage / showcase / docs / video), shown on the package's page.
+    [JsonPropertyName("link")] public string? Link { get; set; }
 }
 
 public sealed class RegistrySubmission
@@ -58,4 +60,5 @@ public sealed class RegistrySubmission
     [JsonPropertyName("dependencies")] public Dictionary<string, string>? Dependencies { get; set; }
     [JsonPropertyName("discord")] public string? Discord { get; set; }
     [JsonPropertyName("donate")] public string? Donate { get; set; }
+    [JsonPropertyName("link")] public string? Link { get; set; }
 }
diff --git a/src/BasisPM.Server/Services/PackageStore.cs b/src/BasisPM.Server/Services/PackageStore.cs
@@ -149,9 +149,11 @@ public RegistryPackage Upsert(RegistrySubmission sub)
             throw new ArgumentException("discord must be an http(s) URL.");
         if (!string.IsNullOrWhiteSpace(sub.Donate) && !GitUrlPolicy.IsWebUrl(sub.Donate))
             throw new ArgumentException("donate must be an http(s) URL.");
+        if (!string.IsNullOrWhiteSpace(sub.Link) && !GitUrlPolicy.IsWebUrl(sub.Link))
+            throw new ArgumentException("link must be an http(s) URL.");
         if (TooLong(sub.Name) || TooLong(sub.Description) || TooLong(sub.Author) || TooLong(sub.Category)
             || TooLong(sub.Version) || TooLong(sub.Unity) || TooLong(sub.GitUrl) || TooLong(sub.RepoUrl) || TooLong(sub.AuthorUrl)
-            || TooLong(sub.BasisVersion) || TooLong(sub.License) || TooLong(sub.Discord) || TooLong(sub.Donate))
+            || TooLong(sub.BasisVersion) || TooLong(sub.License) || TooLong(sub.Discord) || TooLong(sub.Donate) || TooLong(sub.Link))
             throw new ArgumentException("One or more fields exceed the length limit.");
         if (sub.Dependencies is { Count: > MaxDependencies })
             throw new ArgumentException("Too many dependencies.");
@@ -192,6 +194,7 @@ public RegistryPackage Upsert(RegistrySubmission sub)
                 Icon = "📦",
                 Discord = sub.Discord?.Trim(),
                 Donate = sub.Donate?.Trim(),
+                Link = sub.Link?.Trim(),
             };
 
             _packages.Add(pkg);
@@ -228,6 +231,7 @@ public static Catalog BuildCatalog(IEnumerable<RegistryPackage> packages)
                         Dependencies = p.Dependencies,
                         Author = new CatalogAuthor { Name = p.Author, Url = p.AuthorUrl },
                         Image = p.Image,
+                        Link = p.Link,
                     },
                 },
             };
diff --git a/src/BasisPM.Server/wwwroot/index.html b/src/BasisPM.Server/wwwroot/index.html
@@ -418,6 +418,7 @@ <h2 class="flex flex-wrap items-center gap-2 text-xl font-bold">${esc(p.name)} <
       <div class="flex flex-wrap gap-2">
         ${p.repoUrl?`<a href="${esc(safeUrl(p.repoUrl))}" target="_blank" rel="noopener noreferrer" class="rounded-xl border border-gray-200 px-3 py-1.5 text-sm hover:border-brand hover:text-brand dark:border-white/10">${hostOf(p)?'View on '+hostOf(p):'Repository'} ↗</a>`:''}
         ${p.discord?`<a href="${esc(safeUrl(p.discord))}" target="_blank" rel="noopener noreferrer" class="inline-flex items-center gap-1.5 rounded-xl border border-gray-200 px-3 py-1.5 text-sm hover:border-brand hover:text-brand dark:border-white/10"><svg class="h-4 w-4" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M20.32 4.37A19.8 19.8 0 0 0 15.45 3c-.2.36-.43.83-.6 1.22a18.3 18.3 0 0 0-5.7 0A12.6 12.6 0 0 0 8.54 3a19.7 19.7 0 0 0-4.89 1.37C.53 9.05-.32 13.58.1 18.06a19.9 19.9 0 0 0 6.02 3.04c.49-.66.92-1.36 1.29-2.1-.71-.27-1.38-.6-2.01-.99.17-.12.34-.25.5-.38a14.2 14.2 0 0 0 12.2 0c.16.13.33.26.5.38-.63.39-1.31.72-2.02.99.37.74.8 1.44 1.29 2.1a19.8 19.8 0 0 0 6.02-3.04c.5-5.18-.85-9.67-3.56-13.69ZM8.02 15.33c-1.18 0-2.16-1.08-2.16-2.42 0-1.33.95-2.42 2.16-2.42 1.21 0 2.18 1.09 2.16 2.42 0 1.34-.95 2.42-2.16 2.42Zm7.97 0c-1.18 0-2.16-1.08-2.16-2.42 0-1.33.96-2.42 2.16-2.42 1.21 0 2.18 1.09 2.16 2.42 0 1.34-.95 2.42-2.16 2.42Z"/></svg>Discord ↗</a>`:''}
+        ${p.link?`<a href="${esc(safeUrl(p.link))}" target="_blank" rel="noopener noreferrer" class="inline-flex items-center gap-1.5 rounded-xl border border-gray-200 px-3 py-1.5 text-sm hover:border-brand hover:text-brand dark:border-white/10">🔗 Website ↗</a>`:''}
         ${p.donate?`<a href="${esc(safeUrl(p.donate))}" target="_blank" rel="noopener noreferrer" class="inline-flex items-center gap-1.5 rounded-xl border border-brand/30 bg-brand/5 px-3 py-1.5 text-sm text-brand hover:bg-brand/10 dark:border-brand/40">♥ Donate ↗</a>`:''}
       </div>
     </div>
@@ -574,6 +575,7 @@ <h2 class="text-xl font-bold">${esc(b.name)}</h2>
       <label class="${SUB_field}"><span class="${SUB_label}">Unity version</span><input name="unity" class="${SUB_input}" value="${esc(p.unity||'')}" placeholder="6000.0"></label>
     </div>
     <label class="${SUB_field}"><span class="${SUB_label}">License <span class="text-xs text-gray-400">SPDX identifier — e.g. MIT</span></span><input name="license" class="${SUB_input}" value="${esc(p.license||'')}" placeholder="MIT"></label>
+    <label class="${SUB_field}"><span class="${SUB_label}">Website / link <span class="text-xs text-gray-400">optional — homepage, docs, or a showcase video</span></span><input name="link" class="${SUB_input}" placeholder="https://…"></label>
     <div class="grid gap-4 sm:grid-cols-2">
       <label class="${SUB_field}"><span class="${SUB_label}">Discord invite <span class="text-xs text-gray-400">optional</span></span><input name="discord" class="${SUB_input}" placeholder="https://discord.gg/…"></label>
       <label class="${SUB_field}"><span class="${SUB_label}">Donation link <span class="text-xs text-gray-400">optional</span></span><input name="donate" class="${SUB_input}" placeholder="https://ko-fi.com/…"></label>
@@ -625,7 +627,7 @@ <h2 class="text-xl font-bold">${esc(b.name)}</h2>
     source:deriveSource(g('repoUrl'), g('gitUrl')), gitUrl:g('gitUrl')||null, repoUrl:g('repoUrl')||null,
     image:resolveImageUrl(g('image'), g('repoUrl'), g('gitUrl'))||null,
     unity:g('unity')||null, version:g('version')||'1.0.0',
-    basisVersion:g('basisVersion')||null, license:g('license')||null, discord:g('discord')||null, donate:g('donate')||null
+    basisVersion:g('basisVersion')||null, license:g('license')||null, discord:g('discord')||null, donate:g('donate')||null, link:g('link')||null
   };
   const deps = submitState.pkg && submitState.pkg.dependencies;
   if(deps && Object.keys(deps).length) pkg.dependencies = deps;

Original file line number	Diff line number	Diff line change
`@@ -30,6 +30,8 @@ public sealed class CatalogPackageVersion`
`30`	`30`	`[JsonPropertyName("author")] public CatalogAuthor? Author { get; set; }`
`31`	`31`	`// Optional self-hosted promo image URL (served from the registry's icons/ folder).`
`32`	`32`	`[JsonPropertyName("image")] public string? Image { get; set; }`
	`33`	`+ // Optional author-provided link (homepage / showcase / docs), surfaced in the desktop client.`
	`34`	`+ [JsonPropertyName("link")] public string? Link { get; set; }`
`33`	`35`	`}`
`34`	`36`
`35`	`37`	`public sealed class CatalogAuthor`
Original file line number	Diff line number	Diff line change
`@@ -37,6 +37,8 @@ public sealed class RegistryPackage`
`37`	`37`	`// Optional per-package community + funding links, shown on the package's registry page.`
`38`	`38`	`[JsonPropertyName("discord")] public string? Discord { get; set; }`
`39`	`39`	`[JsonPropertyName("donate")] public string? Donate { get; set; }`
	`40`	`+ // Optional author-provided link (homepage / showcase / docs / video), shown on the package's page.`
	`41`	`+ [JsonPropertyName("link")] public string? Link { get; set; }`
`40`	`42`	`}`
`41`	`43`
`42`	`44`	`public sealed class RegistrySubmission`
`@@ -58,4 +60,5 @@ public sealed class RegistrySubmission`
`58`	`60`	`[JsonPropertyName("dependencies")] public Dictionary<string, string>? Dependencies { get; set; }`
`59`	`61`	`[JsonPropertyName("discord")] public string? Discord { get; set; }`
`60`	`62`	`[JsonPropertyName("donate")] public string? Donate { get; set; }`
	`63`	`+ [JsonPropertyName("link")] public string? Link { get; set; }`
`61`	`64`	`}`