feat: add third-party license management and in-app viewer

.github/workflows/licenses.yml

@@ -0,0 +1,54 @@
+name: Update Third-Party Licenses
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'package-lock.json'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update-licenses:
+    name: Update Licenses
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - run: npm ci
+
+      - name: Generate third-party license file
+        run: npx generate-license-file --input package.json --output THIRD_PARTY_LICENSES.txt --overwrite
+
+      - name: Check for changes
+        id: check
+        run: |
+          if git diff --quiet THIRD_PARTY_LICENSES.txt; then
+            echo "changed=false" >> $GITHUB_OUTPUT
+          else
+            echo "changed=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create Pull Request
+        if: steps.check.outputs.changed == 'true'
+        uses: peter-evans/create-pull-request@v7
+        with:
+          commit-message: 'chore: update third-party licenses'
+          title: 'chore: update third-party licenses'
+          body: |
+            This PR updates the THIRD_PARTY_LICENSES.txt file with the latest
+            license information from npm dependencies.
+
+            Auto-generated by the licenses workflow.
+          branch: chore/update-licenses
+          delete-branch: true
+          labels: dependencies

messages/en.json

@@ -90,6 +90,11 @@
   "settings_licenseModal_agree": "By installing this model, you agree to the terms of the {license} license.",
   "settings_licenseModal_acceptInstall": "Accept & Install",
 
+  "licenses_title": "Third Party Licenses",
+  "licenses_notFound": "License information is not available.",
+
+  "common_button_close": "Close",
+
   "sidebar_analysis": "Analysis",
   "sidebar_detections": "Detections",
   "sidebar_map": "Map",

package.json

@@ -43,6 +43,12 @@
     "files": [
       "out/**/*"
     ],
+    "extraResources": [
+      {
+        "from": "THIRD_PARTY_LICENSES.txt",
+        "to": "THIRD_PARTY_LICENSES.txt"
+      }
+    ],
     "extraMetadata": {
       "main": "out/main/index.js"
     },

src/main/index.ts

@@ -123,6 +123,11 @@
           click: () => mainWindow?.webContents.send('menu:setup-wizard'),
         },
         { type: 'separator' },
+        {
+          label: 'Third Party Licenses',
+          click: () => mainWindow?.webContents.send('menu:show-licenses'),
+        },
+        { type: 'separator' },
         {
           label: 'About Birda GUI',
           click: () => {
@@ -205,7 +210,7 @@
       // Read saved language preference
       let language = 'en';
       try {
         const settingsRaw = await fs.promises.readFile(
           path.join(app.getPath('userData'), 'birda-gui-settings.json'),
           'utf-8',
         );

src/main/ipc/handlers.ts

@@ -2,6 +2,7 @@ import { registerAnalysisHandlers } from './analysis';
 import { registerCatalogHandlers } from './catalog';
 import { registerFileHandlers } from './files';
 import { registerLabelHandlers } from './labels';
+import { registerLicenseHandlers } from './licenses';
 import { registerModelHandlers } from './models';
 import { registerSettingsHandlers } from './settings';
 
@@ -10,6 +11,7 @@ export async function registerHandlers(): Promise<void> {
   registerCatalogHandlers();
   registerFileHandlers();
   registerLabelHandlers();
+  registerLicenseHandlers();
   registerModelHandlers();
   await registerSettingsHandlers();
 }

src/main/ipc/licenses.ts

@@ -0,0 +1,17 @@
+import { ipcMain, app } from 'electron';
+import fs from 'fs';
+import path from 'path';
+
+export function registerLicenseHandlers(): void {
+  ipcMain.handle('app:get-licenses', async () => {
+    const licensePath = app.isPackaged
+      ? path.join(process.resourcesPath, 'THIRD_PARTY_LICENSES.txt')
+      : path.join(app.getAppPath(), 'THIRD_PARTY_LICENSES.txt');
+
+    try {
+      return await fs.promises.readFile(licensePath, 'utf-8');
+    } catch {
+      return null;
+    }
+  });
+}

src/preload/index.ts

@@ -37,6 +37,7 @@ const ALLOWED_INVOKE_CHANNELS = new Set([
   'fs:read-coordinates',
   'fs:scan-source',
   'fs:open-in-explorer',
+  'app:get-licenses',
 ]);
 
 const ALLOWED_RECEIVE_CHANNELS = new Set([
@@ -49,6 +50,7 @@ const ALLOWED_RECEIVE_CHANNELS = new Set([
   'menu:focus-search',
   'menu:toggle-log',
   'menu:setup-wizard',
+  'menu:show-licenses',
 ]);
 
 contextBridge.exposeInMainWorld('birda', {

src/renderer/src/App.svelte

@@ -4,6 +4,7 @@
   import ProgressPanel from '$lib/components/ProgressPanel.svelte';
   import LogPanel from '$lib/components/LogPanel.svelte';
   import SetupWizard from '$lib/components/SetupWizard.svelte';
+  import LicenseViewer from '$lib/components/LicenseViewer.svelte';
   import AnalysisPage from './pages/AnalysisPage.svelte';
   import DetectionsPage from './pages/DetectionsPage.svelte';
   import MapPage from './pages/MapPage.svelte';
@@ -27,12 +28,15 @@
     offLog,
     onSetupWizard,
     offSetupWizard,
+    onShowLicenses,
+    offShowLicenses,
   } from '$lib/utils/ipc';
   import { setupMenuListeners } from '$lib/utils/shortcuts';
   import { onMount, onDestroy } from 'svelte';
 
   let cleanupMenu: (() => void) | null = null;
   let showWizard = $state<boolean | null>(null); // null = loading, true/false = resolved
+  let showLicenses = $state(false);
 
   async function handleWizardComplete() {
     try {
@@ -142,6 +146,10 @@
       showWizard = true;
     });
 
+    onShowLicenses(() => {
+      showLicenses = true;
+    });
+
     cleanupMenu = setupMenuListeners({
       onOpenFile: (path: string) => {
         appState.sourcePath = path;
@@ -173,6 +181,7 @@
     offAnalysisProgress();
     offLog();
     offSetupWizard();
+    offShowLicenses();
     cleanupMenu?.();
   });
 </script>
@@ -207,3 +216,5 @@
     </div>
   </main>
 {/if}
+
+<LicenseViewer bind:open={showLicenses} />

src/renderer/src/lib/components/LicenseViewer.svelte

@@ -0,0 +1,68 @@
+<script lang="ts">
+  import { X, Loader } from '@lucide/svelte';
+  import { getLicenses } from '$lib/utils/ipc';
+  import * as m from '$paraglide/messages';
+
+  let {
+    open = $bindable(), // eslint-disable-line @typescript-eslint/no-useless-default-assignment -- $bindable() required for Svelte bind:
+  }: { open: boolean } = $props();
+
+  let licenseText = $state<string | null>(null);
+  let loading = $state(false);
+  let error = $state<string | null>(null);
+
+  $effect(() => {
+    if (open && licenseText === null) {
+      loading = true;
+      error = null;
+      getLicenses()
+        .then((text) => {
+          licenseText = text;
+        })
+        .catch((e: unknown) => {
+          error = (e as Error).message;
+        })
+        .finally(() => {
+          loading = false;
+        });
+    }
+  });
+
+  function close() {
+    open = false;
+  }
+</script>
+
+{#if open}
+  <dialog class="modal modal-open">
+    <div class="modal-box flex h-[80vh] max-w-4xl flex-col">
+      <div class="flex items-center justify-between">
+        <h2 class="text-lg font-semibold">{m.licenses_title()}</h2>
+        <button onclick={close} class="btn btn-ghost btn-sm btn-square">
+          <X size={20} />
+        </button>
+      </div>
+
+      <div class="mt-4 flex-1 overflow-auto">
+        {#if loading}
+          <div class="flex items-center justify-center py-12">
+            <Loader size={24} class="animate-spin" />
+          </div>
+        {:else if error}
+          <p class="text-error text-sm">{error}</p>
+        {:else if licenseText}
+          <pre class="text-base-content/70 font-mono text-xs leading-relaxed whitespace-pre-wrap">{licenseText}</pre>
+        {:else}
+          <p class="text-base-content/50 text-sm">{m.licenses_notFound()}</p>
+        {/if}
+      </div>
+
+      <div class="modal-action">
+        <button onclick={close} class="btn">{m.common_button_close()}</button>
+      </div>
+    </div>
+    <form method="dialog" class="modal-backdrop">
+      <button onclick={close}>close</button>
+    </form>
+  </dialog>
+{/if}

src/renderer/src/lib/utils/ipc.ts

@@ -212,6 +212,19 @@ export function exportRegionAsWav(wavBytes: Uint8Array, defaultName?: string): P
   return window.birda.invoke('clip:export-region', base64, defaultName) as Promise<string | null>;
 }
 
+// Licenses
+export function getLicenses(): Promise<string | null> {
+  return window.birda.invoke('app:get-licenses') as Promise<string | null>;
+}
+
+export function onShowLicenses(callback: () => void): void {
+  window.birda.on('menu:show-licenses', callback as (...args: unknown[]) => void);
+}
+
+export function offShowLicenses(): void {
+  window.birda.removeAllListeners('menu:show-licenses');
+}
+
 // Spectrogram cache
 export function saveSpectrogram(clipPath: string, freqMax: number, height: number, dataUrl: string): Promise<string> {
   return window.birda.invoke('clip:save-spectrogram', clipPath, freqMax, height, dataUrl) as Promise<string>;