Modernization to Swift & SwuiftUI

.github/copilot-instructions.md

@@ -0,0 +1,56 @@
+# ClipMenu — Agent Instructions
+
+## Migration Status Rule
+
+**Every agent that completes or advances a migration step MUST update `migration_status.md` before finishing.**
+
+This applies to any work that:
+- Implements or stubs a file listed in `Sources/`
+- Changes `project.yml` or regenerates `ClipMenu.xcodeproj`
+- Adds, removes, or modifies a package dependency
+- Makes a structural change to `Sources/`
+- Completes or partially completes any task listed under "Not Started" or "In Progress" in `migration_status.md`
+
+**How to update:**
+1. Move the completed task from "Not Started" → "Completed" (or update its checkbox).
+2. If a task is partially done, move it to "In Progress" with a short note on what remains.
+3. Update the "Overall progress" summary line at the top.
+4. Do **not** remove the "Key Decisions" table entries without explicit user instruction.
+
+## Architecture
+
+- New Swift source lives in `Sources/` (see `doc/migration.md` for the full directory spec).
+- Legacy Objective-C source was removed from this repository after migration completion.
+- Build system: XcodeGen — edit `project.yml`, then run `xcodegen generate` to regenerate `ClipMenu.xcodeproj`.
+- The `.xcodeproj` is generated output; never hand-edit `project.pbxproj`.
+
+## SwiftUI View Rule
+
+**Every SwiftUI `View` in `Sources/UI/` MUST have at least one `#Preview` block.**
+
+- The preview must compile and render without requiring a live app or device.
+- Use in-memory `ModelContainer` when SwiftData models are needed:
+  ```swift
+  .modelContainer(for: [ClipEntry.self, ...], inMemory: true)
+  ```
+- Inject required environment values using test instances:
+  ```swift
+  .environment(ClipMenuSettings())
+  .environment(\.clipsService, ClipsService(settings: ClipMenuSettings()))
+  ```
+- A view file without a `#Preview` block must not be marked completed in `migration_status.md`.
+
+## Build & Verify
+
+```sh
+xcodegen generate
+xcodebuild -project ClipMenu.xcodeproj -scheme ClipMenu -configuration Debug build \
+  CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO
+```
+
+Both commands must succeed with no errors before a task is marked completed.
+
+## Behavior Reference
+
+Legacy source references are historical only and are no longer available in this repository.
+When implementing behavior changes, rely on the current Swift implementation and documented behavior in `doc/features.md`.

.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "chat.tools.terminal.autoApprove": {
+        "xcodebuild": true,
+        "defaults": true,
+        "true": true
+    }
+}

Assets.xcassets/AppIcon.appiconset/Contents.json

@@ -0,0 +1,68 @@
+{
+  "images" : [
+    {
+      "filename" : "AppIcon-16.png",
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "16x16"
+    },
+    {
+      "filename" : "AppIcon-16@2x.png",
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "16x16"
+    },
+    {
+      "filename" : "AppIcon-32.png",
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "32x32"
+    },
+    {
+      "filename" : "AppIcon-32@2x.png",
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "32x32"
+    },
+    {
+      "filename" : "AppIcon-128.png",
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "128x128"
+    },
+    {
+      "filename" : "AppIcon-128@2x.png",
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "128x128"
+    },
+    {
+      "filename" : "AppIcon-256.png",
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "256x256"
+    },
+    {
+      "filename" : "AppIcon-256@2x.png",
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "256x256"
+    },
+    {
+      "filename" : "AppIcon-512.png",
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "512x512"
+    },
+    {
+      "filename" : "AppIcon-512@2x.png",
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "512x512"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

Assets.xcassets/Contents.json

@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

BUILD.md

@@ -0,0 +1,65 @@
+# Build And Release Guide
+
+This repository contains the active Swift/XcodeGen ClipMenu project.
+
+## Prerequisites
+
+```sh
+xcode-select -p
+brew install xcodegen
+```
+
+## Generate Project
+
+Run whenever `project.yml` changes:
+
+```sh
+xcodegen generate
+```
+
+## Build (Debug)
+
+```sh
+xcodebuild -project ClipMenu.xcodeproj -scheme ClipMenu -configuration Debug build \
+  CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO
+```
+
+## Build (Release)
+
+```sh
+xcodebuild -project ClipMenu.xcodeproj -scheme ClipMenu -configuration Release build \
+  CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO
+```
+
+## Run From Xcode
+
+1. Open `ClipMenu.xcodeproj`.
+2. Select scheme `ClipMenu`.
+3. Run with `Debug` configuration.
+
+ClipMenu is a menu bar app (`LSUIElement = YES`), so it does not appear in the Dock while running.
+
+## Accessibility Note
+
+Paste simulation uses CGEvent and requires Accessibility permission:
+
+- System Settings -> Privacy & Security -> Accessibility
+
+## Release Direction
+
+- Legacy Sparkle/appcast release scripts were removed during repository cleanup.
+- Packaging/notarization should be implemented through a modern, explicit archive/export pipeline when needed.
+
+## Troubleshooting
+
+`xcodegen: command not found`
+
+```sh
+brew install xcodegen
+```
+
+Code signing errors in local/CI builds
+
+- Use `CODE_SIGN_IDENTITY=""`
+- Use `CODE_SIGNING_REQUIRED=NO`
+- Use `CODE_SIGNING_ALLOWED=NO`

ClipMenu.entitlements

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <!--
+        ClipMenu is NOT sandboxed.
+        CGEvent-based paste (kCGSessionEventTap) requires Accessibility permission,
+        which is incompatible with the App Sandbox. The user grants this once at
+        runtime via the standard system prompt in AppDelegate.
+    -->
+
+    <!-- Required for CGEvent Cmd+V synthesis -->
+    <key>com.apple.security.automation.apple-events</key>
+    <true/>
+</dict>
+</plist>