Safari web extension support

.gitignore

@@ -1,6 +1,5 @@
-dist
-# Created by https://www.toptal.com/developers/gitignore/api/node,macos,windows,linux,webstorm,visualstudiocode
-# Edit at https://www.toptal.com/developers/gitignore?templates=node,macos,windows,linux,webstorm,visualstudiocode
+# Created by https://www.toptal.com/developers/gitignore/api/node,linux,macos,windows,webstorm,visualstudiocode,xcode
+# Edit at https://www.toptal.com/developers/gitignore?templates=node,linux,macos,windows,webstorm,visualstudiocode,xcode
 
 ### Linux ###
 *~
@@ -219,7 +218,6 @@ dist
 .idea/**/usage.statistics.xml
 .idea/**/dictionaries
 .idea/**/shelf
-.idea
 
 # AWS User-specific
 .idea/**/aws.xml
@@ -323,8 +321,6 @@ fabric.properties
 # https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij
 .idea/**/azureSettings.xml
 
-.idea/**/*.xml
-
 ### Windows ###
 # Windows thumbnail cache files
 Thumbs.db
@@ -351,4 +347,21 @@ $RECYCLE.BIN/
 # Windows shortcuts
 *.lnk
 
-# End of https://www.toptal.com/developers/gitignore/api/node,macos,windows,linux,webstorm,visualstudiocode
+### Xcode ###
+## User settings
+xcuserdata/
+
+## Xcode 8 and earlier
+*.xcscmblueprint
+*.xccheckout
+
+### Xcode Patch ###
+*.xcodeproj/*
+!*.xcodeproj/project.pbxproj
+!*.xcodeproj/xcshareddata/
+!*.xcodeproj/project.xcworkspace/
+!*.xcworkspace/contents.xcworkspacedata
+/*.gcno
+**/xcshareddata/WorkspaceSettings.xcsettings
+
+# End of https://www.toptal.com/developers/gitignore/api/node,linux,macos,windows,webstorm,visualstudiocode,xcode

safari/README.md

@@ -0,0 +1,38 @@
+## Building
+
+This belongs in `package.json`. Later.
+
+```sh
+❯ # `npm run dev` does not work, hot module reloading is broken in Safari
+
+❯ npm run build
+
+❯ xcodebuild -scheme RowsX -configuration Release -project ./safari/RowsX/RowsX.xcodeproj/
+```
+
+## Safari extension development for Chrome developers
+
+Official, [long version](https://developer.apple.com/documentation/safariservices/safari_web_extensions/running_your_safari_web_extension#3744467).
+
+### Developer mode toggle on chrome://extensions/
+
+For Safari > 17.0
+
+1. Safari > Settings...
+2. `Advanced` tab
+3. Check `Show features for web developers` at bottom
+4. `Developer` tab
+5. Check `Extensions: Allow unsigned extensions` at bottom
+
+### Inspect views service worker
+
+Develop > Web Extension Background Content > RowsX Personal
+
+### Reloading
+
+The `xcodebuild` command reloads the extension automatically.
+
+Indicators that it has reloaded:
+
+- The Inspector window will close
+- If you have `RowsX` selected in the Extensions tab of Preferences, it will deselect

safari/RowsX/RowsX Extension/Info.plist

@@ -0,0 +1,13 @@
+<?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>
+	<key>NSExtension</key>
+	<dict>
+		<key>NSExtensionPointIdentifier</key>
+		<string>com.apple.Safari.web-extension</string>
+		<key>NSExtensionPrincipalClass</key>
+		<string>$(PRODUCT_MODULE_NAME).SafariWebExtensionHandler</string>
+	</dict>
+</dict>
+</plist>

safari/RowsX/RowsX Extension/RowsX_Extension.entitlements

@@ -0,0 +1,10 @@
+<?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>
+    <key>com.apple.security.app-sandbox</key>
+    <true/>
+    <key>com.apple.security.files.user-selected.read-only</key>
+    <true/>
+</dict>
+</plist>

safari/RowsX/RowsX Extension/SafariWebExtensionHandler.swift

@@ -0,0 +1,38 @@
+//
+//  SafariWebExtensionHandler.swift
+//  RowsX Extension
+//
+//  Created by rusty on 4/23/24.
+//
+
+import SafariServices
+import os.log
+
+class SafariWebExtensionHandler: NSObject, NSExtensionRequestHandling {
+
+    func beginRequest(with context: NSExtensionContext) {
+        let request = context.inputItems.first as? NSExtensionItem
+
+        let profile: UUID?
+        if #available(iOS 17.0, macOS 14.0, *) {
+            profile = request?.userInfo?[SFExtensionProfileKey] as? UUID
+        } else {
+            profile = request?.userInfo?["profile"] as? UUID
+        }
+
+        let message: Any?
+        if #available(iOS 17.0, macOS 14.0, *) {
+            message = request?.userInfo?[SFExtensionMessageKey]
+        } else {
+            message = request?.userInfo?["message"]
+        }
+
+        os_log(.default, "Received message from browser.runtime.sendNativeMessage: %@ (profile: %@)", String(describing: message), profile?.uuidString ?? "none")
+
+        let response = NSExtensionItem()
+        response.userInfo = [ SFExtensionMessageKey: [ "echo": message ] ]
+
+        context.completeRequest(returningItems: [ response ], completionHandler: nil)
+    }
+
+}