feat(zotero-plugin-uts): add Zotero 7/8 compatible plugin with UTS APA 7th citation style

- Add CSL-based bibliography copy functionality
- Implement Zotero 8 Menu API with legacy fallback for Zotero 7
- Add context menu, tools menu, and keyboard shortcut (Ctrl+Shift+U)
- Add preference pane with about section and funding links
- Add first-run welcome notification
- Add plugin state management with encapsulated class
- Add Result pattern for error handling in citation copy
- Add vitest tests for utils and plugin state
- Add path aliases (@/*) for clean imports
- Configure ES2022 target with minification
- Add manifest.json with author, homepage, icons, and update URL
- Add package.json with funding info (GitHub Sponsors)
- Reference UTS Library APA 7th Referencing Guide (Jan 2025)

Amp-Thread-ID: https://ampcode.com/threads/T-019bff93-4aab-77ab-98d1-d838ab1a3fa9
Co-authored-by: Amp <amp@ampcode.com>

Author: gracefullight

biome.json

@@ -14,7 +14,8 @@
       "!**/apps/ng-daum-address-example/**/*.html",
       "!**/packages/mcp-cafe24-admin/src/assets/**/*.html",
       "!**/apps/mcp-cafe24-admin-example/next-env.d.ts",
-      "!**/.opencode/mimic/state.json"
+      "!**/.opencode/mimic/state.json",
+      "!**/packages/zotero-plugin-uts/addon/*.js"
     ]
   },
   "plugins": ["packages/biome-plugin/rules/no-relative-imports.grit"],

bun.lock

@@ -1,36 +1,64 @@
-# Zotero Plugin UTS
+# UTS APA 7th Copy - Zotero Plugin
 
-This is a Zotero plugin that adds a "Copy UTS APA 7th Citation" option to the item context menu.
+A Zotero plugin that copies bibliography in UTS APA 7th format to clipboard.
+
+> **Citation Style Reference**: This plugin uses the citation format based on the
+> [APA 7th Referencing Guide (January 2025)](https://www.lib.uts.edu.au/help/referencing/apa-referencing-guide)
+> from UTS Library.
 
 ## Features
 
-- Copies the bibliography of selected items in APA 7th edition format (UTS standard).
-- Supports Zotero 7+.
+- 📋 **Context Menu**: Right-click on items → "Copy UTS APA 7th Citation"
+- 🔧 **Tools Menu**: Tools → "Copy UTS APA 7th Citation"
+- ⌨️ **Keyboard Shortcut**: `Ctrl+Shift+U` (Windows/Linux) or `Cmd+Shift+U` (Mac)
+- 🔔 **Notifications**: Visual feedback on copy success/failure
+- 🎨 **Icons**: Custom menu icons for easy identification
 
-## Development
+## Installation
+
+1. Download the latest `.xpi` file from [Releases](https://github.com/gracefullight/pkgs/releases)
+2. In Zotero, go to Tools → Add-ons
+3. Click the gear icon → Install Add-on From File
+4. Select the downloaded `.xpi` file
+
+## Compatibility
+
+- Zotero 7.0+
+- Zotero 8.x
+
+## Usage
 
-### Build
+1. Select one or more items in your Zotero library
+2. Use any of the following methods:
+   - Right-click and select "Copy UTS APA 7th Citation"
+   - Go to Tools → "Copy UTS APA 7th Citation"
+   - Press `Ctrl+Shift+U` (or `Cmd+Shift+U` on Mac)
+3. Paste the citation wherever you need it
+
+## Development
 
 ```bash
+# Install dependencies
 bun install
+
+# Run tests
+bun run test
+
+# Build
 bun run build
 ```
 
-The built addon files are located in `addon/`.
+## Support Development
+
+If you find this plugin helpful, please consider supporting:
+
+- [♥ GitHub Sponsors](https://github.com/sponsors/gracefullight)
+- [☕ Buy Me a Coffee](https://buymeacoffee.com/gracefullight)
 
-### Installation
+## License
 
-1. Build the project.
-2. Zip the contents of the `addon` directory (not the directory itself, just the files inside).
-   ```bash
-   cd addon && zip -r ../zotero-plugin-uts.xpi *
-   ```
-3. Open Zotero -> Tools -> Add-ons.
-4. Click the gear icon -> Install Add-on From File...
-5. Select the `.xpi` file.
+MIT License - see [LICENSE](../../LICENSE) for details.
 
-## Structure
+## Author
 
-- `addon/`: Contains the plugin manifest, bootstrap loader, and built assets.
-- `src/`: TypeScript source code.
-- `tsup.config.ts`: Bundler configuration.
+**gracefullight** - [GitHub](https://github.com/gracefullight)

packages/zotero-plugin-uts/README.md

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE window>
+<window
+  xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
+  xmlns:html="http://www.w3.org/1999/xhtml"
+>
+  <vbox id="uts-copy-preferences" class="main-section">
+    <groupbox>
+      <label><html:h2>UTS APA 7th Copy</html:h2></label>
+
+      <vbox class="uts-copy-about">
+        <label value="Copy bibliography in UTS APA 7th format to clipboard" />
+        <label value="Based on APA 7th Referencing Guide (Jan 2025) from UTS Library" />
+
+        <separator class="thin" />
+
+        <label><html:strong>Keyboard Shortcut</html:strong></label>
+        <label value="Ctrl+Shift+U (Cmd+Shift+U on Mac)" />
+
+        <separator />
+
+        <label><html:strong>About</html:strong></label>
+        <label value="Author: gracefullight" />
+        <hbox>
+          <label value="Homepage: " />
+          <label
+            class="zotero-text-link"
+            value="GitHub"
+            href="https://github.com/gracefullight/pkgs/tree/main/packages/zotero-plugin-uts"
+          />
+        </hbox>
+
+        <separator />
+
+        <label><html:strong>Support Development</html:strong></label>
+        <label value="If you find this plugin helpful, please consider supporting:" />
+
+        <hbox align="center">
+          <button
+            id="uts-copy-github-sponsor"
+            label="♥ GitHub Sponsors"
+            oncommand="Zotero.launchURL('https://github.com/sponsors/gracefullight')"
+          />
+          <button
+            id="uts-copy-coffee"
+            label="☕ Buy Me a Coffee"
+            oncommand="Zotero.launchURL('https://buymeacoffee.com/gracefullight')"
+          />
+        </hbox>
+
+        <separator />
+
+        <label><html:strong>License</html:strong></label>
+        <label value="MIT License" />
+      </vbox>
+    </groupbox>
+  </vbox>
+</window>

packages/zotero-plugin-uts/addon/bootstrap.js

@@ -3,10 +3,22 @@
   "name": "UTS APA 7th Copy",
   "version": "1.0.0",
   "description": "Copy bibliography in UTS APA 7th format to clipboard",
+  "author": "gracefullight",
+  "homepage_url": "https://github.com/gracefullight/pkgs/tree/main/packages/zotero-plugin-uts",
+  "developer": {
+    "name": "gracefullight",
+    "url": "https://github.com/gracefullight"
+  },
+  "icons": {
+    "48": "icon.svg",
+    "96": "icon.svg"
+  },
   "applications": {
     "zotero": {
       "id": "uts-copy@gracefullight.dev",
-      "strict_min_version": "7.0"
+      "update_url": "https://raw.githubusercontent.com/gracefullight/pkgs/main/packages/zotero-plugin-uts/updates.json",
+      "strict_min_version": "7.0",
+      "strict_max_version": "8.*"
     }
   }
 }