├── .gitignore ├── gradle.properties ├── beasts ├── frog.jpg ├── snake.jpg └── turtle.jpg ├── icons ├── beasts-32.png ├── beasts-48.png ├── beasts-32-light.png └── LICENSE ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── popup ├── choose_beast.css ├── choose_beast.html └── src │ └── main │ └── kotlin │ └── popup.kt ├── settings.gradle ├── README.md ├── manifest.json ├── content_script └── src │ └── main │ └── kotlin │ └── content_script.kt ├── gradlew.bat └── gradlew /.gitignore: -------------------------------------------------------------------------------- 1 | /.gradle 2 | /.idea 3 | build -------------------------------------------------------------------------------- /gradle.properties: -------------------------------------------------------------------------------- 1 | kotlin.incremental.js=false -------------------------------------------------------------------------------- /beasts/frog.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/cypressious/second-firefox-extension-kotlin/HEAD/beasts/frog.jpg -------------------------------------------------------------------------------- /beasts/snake.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/cypressious/second-firefox-extension-kotlin/HEAD/beasts/snake.jpg -------------------------------------------------------------------------------- /beasts/turtle.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/cypressious/second-firefox-extension-kotlin/HEAD/beasts/turtle.jpg -------------------------------------------------------------------------------- /icons/beasts-32.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/cypressious/second-firefox-extension-kotlin/HEAD/icons/beasts-32.png -------------------------------------------------------------------------------- /icons/beasts-48.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/cypressious/second-firefox-extension-kotlin/HEAD/icons/beasts-48.png -------------------------------------------------------------------------------- /icons/beasts-32-light.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/cypressious/second-firefox-extension-kotlin/HEAD/icons/beasts-32-light.png -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/cypressious/second-firefox-extension-kotlin/HEAD/gradle/wrapper/gradle-wrapper.jar -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | distributionBase=GRADLE_USER_HOME 2 | distributionPath=wrapper/dists 3 | zipStoreBase=GRADLE_USER_HOME 4 | zipStorePath=wrapper/dists 5 | distributionUrl=https\://services.gradle.org/distributions/gradle-4.10.2-all.zip 6 | -------------------------------------------------------------------------------- /icons/LICENSE: -------------------------------------------------------------------------------- 1 | 2 | The icon "beasts-32.png" is taken from the IconBeast Lite iconset, and used under the terms of its license (http://www.iconbeast.com/faq/), with a link back to the website: http://www.iconbeast.com/free/. 3 | 4 | The icon "beasts-48.png" is taken from Aha-Soft’s Free Retina iconset, and used under the terms of its license (http://www.aha-soft.com/free-icons/free-retina-icon-set/), with a link back to the website: http://www.aha-soft.com/. 5 | -------------------------------------------------------------------------------- /popup/choose_beast.css: -------------------------------------------------------------------------------- 1 | html, body { 2 | width: 100px; 3 | } 4 | 5 | .hidden { 6 | display: none; 7 | } 8 | 9 | .button { 10 | margin: 3% auto; 11 | padding: 4px; 12 | text-align: center; 13 | font-size: 1.5em; 14 | cursor: pointer; 15 | } 16 | 17 | .beast:hover { 18 | background-color: #CFF2F2; 19 | } 20 | 21 | .beast { 22 | background-color: #E5F2F2; 23 | } 24 | 25 | .reset { 26 | background-color: #FBFBC9; 27 | } 28 | 29 | .reset:hover { 30 | background-color: #EAEA9D; 31 | } 32 | -------------------------------------------------------------------------------- /settings.gradle: -------------------------------------------------------------------------------- 1 | pluginManagement { 2 | repositories { 3 | gradlePluginPortal() 4 | jcenter() 5 | google() 6 | } 7 | 8 | resolutionStrategy { 9 | eachPlugin { 10 | def plugin = requested.id.id 11 | def module = Config.pluginsResolution.get(plugin) 12 | if (module != null) { 13 | useModule(module) 14 | } else { 15 | // println("No resolutionStrategy for plugin=$plugin") 16 | } 17 | } 18 | } 19 | } 20 | rootProject.name = 'kt-beastify' 21 | include ':popup', ':content_script' 22 | -------------------------------------------------------------------------------- /popup/choose_beast.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 16 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | This is a port of the ["Your second WebExtension"](https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Your_second_WebExtension) for Firefox to Kotlin. 2 | 3 | Blog post: https://medium.com/@Cypressious/your-second-firefox-extension-in-kotlin-bafd91d87c41 4 | 5 | ## Requirements 6 | 7 | - JDK 8 8 | - node.js 9 | - `npm install --global web-ext` 10 | 11 | ## Build instructions 12 | 13 | ``` 14 | ./gradlew runDceKotlinJs --continuous 15 | ``` 16 | 17 | In a separate terminal 18 | 19 | ``` 20 | web-ext run 21 | ``` 22 | 23 | ## Working in an IDE 24 | 25 | Open IntelliJ IDEA and import the project as a Gradle project. 26 | 27 | Create a run configuration for the Gradle task `runDceKotlinJs` with the arguments `--continuous`. Execute the run configuration for continuous building of the Kotlin code. 28 | 29 | Run `web-ext run` in a terminal to launch a Firefox instance with the extension installed. -------------------------------------------------------------------------------- /manifest.json: -------------------------------------------------------------------------------- 1 | { 2 | 3 | "description": "Adds a browser action icon to the toolbar. Click the button to choose a beast. The active tab's body content is then replaced with a picture of the chosen beast. See https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Examples#beastify", 4 | "manifest_version": 2, 5 | "name": "Beastify", 6 | "version": "1.0", 7 | "homepage_url": "https://github.com/cypressious/second-firefox-extension-kotlin", 8 | "icons": { 9 | "48": "icons/beasts-48.png" 10 | }, 11 | 12 | "permissions": [ 13 | "activeTab" 14 | ], 15 | 16 | "browser_action": { 17 | "default_icon": "icons/beasts-32.png", 18 | "theme_icons": [{ 19 | "light": "icons/beasts-32-light.png", 20 | "dark": "icons/beasts-32.png", 21 | "size": 32 22 | }], 23 | "default_title": "Beastify", 24 | "default_popup": "popup/choose_beast.html" 25 | }, 26 | 27 | "web_accessible_resources": [ 28 | "beasts/frog.jpg", 29 | "beasts/turtle.jpg", 30 | "beasts/snake.jpg" 31 | ] 32 | 33 | } 34 | -------------------------------------------------------------------------------- /content_script/src/main/kotlin/content_script.kt: -------------------------------------------------------------------------------- 1 | import org.w3c.dom.HTMLElement 2 | import org.w3c.dom.asList 3 | import webextensions.browser 4 | import kotlin.browser.document 5 | import kotlin.browser.window 6 | 7 | fun main(args: Array) { 8 | if (window.asDynamic().hasRun == true) { 9 | return 10 | } 11 | window.asDynamic().hasRun = true 12 | 13 | browser.runtime.onMessage.addListener { message,_,_ -> 14 | if (message.command === "beastify") { 15 | insertBeast(message.beastURL as String) 16 | } else if (message.command === "reset") { 17 | removeExistingBeasts() 18 | } 19 | } 20 | } 21 | 22 | fun insertBeast(beastURL: String) { 23 | removeExistingBeasts() 24 | 25 | val beastImage = document.createElement("img") as HTMLElement 26 | beastImage.run { 27 | setAttribute("src", beastURL) 28 | style.height = "100vh" 29 | className = "beastify-image" 30 | } 31 | 32 | document.body?.appendChild(beastImage) 33 | } 34 | 35 | fun removeExistingBeasts() { 36 | val existingBeasts = document.querySelectorAll(".beastify-image") 37 | 38 | for (beast in existingBeasts.asList()) { 39 | beast.parentNode?.removeChild(beast) 40 | } 41 | } -------------------------------------------------------------------------------- /gradlew.bat: -------------------------------------------------------------------------------- 1 | @if "%DEBUG%" == "" @echo off 2 | @rem ########################################################################## 3 | @rem 4 | @rem Gradle startup script for Windows 5 | @rem 6 | @rem ########################################################################## 7 | 8 | @rem Set local scope for the variables with windows NT shell 9 | if "%OS%"=="Windows_NT" setlocal 10 | 11 | set DIRNAME=%~dp0 12 | if "%DIRNAME%" == "" set DIRNAME=. 13 | set APP_BASE_NAME=%~n0 14 | set APP_HOME=%DIRNAME% 15 | 16 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 17 | set DEFAULT_JVM_OPTS= 18 | 19 | @rem Find java.exe 20 | if defined JAVA_HOME goto findJavaFromJavaHome 21 | 22 | set JAVA_EXE=java.exe 23 | %JAVA_EXE% -version >NUL 2>&1 24 | if "%ERRORLEVEL%" == "0" goto init 25 | 26 | echo. 27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 28 | echo. 29 | echo Please set the JAVA_HOME variable in your environment to match the 30 | echo location of your Java installation. 31 | 32 | goto fail 33 | 34 | :findJavaFromJavaHome 35 | set JAVA_HOME=%JAVA_HOME:"=% 36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe 37 | 38 | if exist "%JAVA_EXE%" goto init 39 | 40 | echo. 41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 42 | echo. 43 | echo Please set the JAVA_HOME variable in your environment to match the 44 | echo location of your Java installation. 45 | 46 | goto fail 47 | 48 | :init 49 | @rem Get command-line arguments, handling Windows variants 50 | 51 | if not "%OS%" == "Windows_NT" goto win9xME_args 52 | 53 | :win9xME_args 54 | @rem Slurp the command line arguments. 55 | set CMD_LINE_ARGS= 56 | set _SKIP=2 57 | 58 | :win9xME_args_slurp 59 | if "x%~1" == "x" goto execute 60 | 61 | set CMD_LINE_ARGS=%* 62 | 63 | :execute 64 | @rem Setup the command line 65 | 66 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar 67 | 68 | @rem Execute Gradle 69 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% 70 | 71 | :end 72 | @rem End local scope for the variables with windows NT shell 73 | if "%ERRORLEVEL%"=="0" goto mainEnd 74 | 75 | :fail 76 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of 77 | rem the _cmd.exe /c_ return code! 78 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 79 | exit /b 1 80 | 81 | :mainEnd 82 | if "%OS%"=="Windows_NT" endlocal 83 | 84 | :omega 85 | -------------------------------------------------------------------------------- /popup/src/main/kotlin/popup.kt: -------------------------------------------------------------------------------- 1 | import extensionTypes.InjectDetails 2 | import org.w3c.dom.Element 3 | import tabs.QueryInfo 4 | import webextensions.browser 5 | import kotlin.browser.document 6 | import kotlin.js.Promise 7 | 8 | const val SCRIPT_PATH = "/content_script/build/kotlin-js-min/main" 9 | 10 | fun main(args: Array) { 11 | Promise.all(arrayOf( 12 | browser.tabs.executeScript( 13 | details = InjectDetails(file = "$SCRIPT_PATH/kotlin.js")), 14 | browser.tabs.executeScript( 15 | details = InjectDetails(file = "$SCRIPT_PATH/declarations.js")), 16 | browser.tabs.executeScript( 17 | details = InjectDetails(file = "$SCRIPT_PATH/content_script.js")) 18 | )) 19 | .then({ listenForClicks() }) 20 | .catch(::reportExecuteScriptError) 21 | } 22 | 23 | fun getUrl(name: String?): String { 24 | val relative = "beasts/${name?.toLowerCase()}.jpg" 25 | return browser.extension.getURL(relative) 26 | } 27 | 28 | fun listenForClicks() { 29 | document.addEventListener("click", { e -> 30 | val target = e.target as? Element ?: return@addEventListener 31 | 32 | browser.tabs.query(QueryInfo(active = true, currentWindow = true)) 33 | .then({ tabs -> handleClick(target, tabs[0].id!!) }) 34 | .catch(::reportError) 35 | }) 36 | } 37 | 38 | const val CSS_HIDE_PAGE = """ 39 | body > :not(.beastify-image) { 40 | display: none; 41 | } 42 | """ 43 | 44 | fun handleClick(target: Element, id: Int) { 45 | if (target.classList.contains("beast")) { 46 | val url = getUrl(target.textContent) 47 | 48 | browser.tabs.insertCSS(id, InjectDetails(code = CSS_HIDE_PAGE)) 49 | browser.tabs.sendMessage(id, jsObject { 50 | command = "beastify" 51 | beastURL = url 52 | }) 53 | } else { 54 | browser.tabs.removeCSS(id, InjectDetails(code = CSS_HIDE_PAGE)) 55 | browser.tabs.sendMessage(id, jsObject { 56 | command = "reset" 57 | }) 58 | } 59 | } 60 | 61 | inline fun jsObject(init: dynamic.() -> Unit): dynamic { 62 | val o = js("{}") 63 | init(o) 64 | return o 65 | } 66 | 67 | fun reportError(error: Any) = console.error("Could not beastify: $error") 68 | 69 | fun reportExecuteScriptError(error: Throwable) { 70 | document.querySelector("#popup-content")?.classList?.add("hidden") 71 | document.querySelector("#error-content")?.classList?.remove("hidden") 72 | console.error("Failed to execute beastify content script: ${error.message}") 73 | } -------------------------------------------------------------------------------- /gradlew: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env sh 2 | 3 | ############################################################################## 4 | ## 5 | ## Gradle start up script for UN*X 6 | ## 7 | ############################################################################## 8 | 9 | # Attempt to set APP_HOME 10 | # Resolve links: $0 may be a link 11 | PRG="$0" 12 | # Need this for relative symlinks. 13 | while [ -h "$PRG" ] ; do 14 | ls=`ls -ld "$PRG"` 15 | link=`expr "$ls" : '.*-> \(.*\)$'` 16 | if expr "$link" : '/.*' > /dev/null; then 17 | PRG="$link" 18 | else 19 | PRG=`dirname "$PRG"`"/$link" 20 | fi 21 | done 22 | SAVED="`pwd`" 23 | cd "`dirname \"$PRG\"`/" >/dev/null 24 | APP_HOME="`pwd -P`" 25 | cd "$SAVED" >/dev/null 26 | 27 | APP_NAME="Gradle" 28 | APP_BASE_NAME=`basename "$0"` 29 | 30 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 31 | DEFAULT_JVM_OPTS="" 32 | 33 | # Use the maximum available, or set MAX_FD != -1 to use that value. 34 | MAX_FD="maximum" 35 | 36 | warn () { 37 | echo "$*" 38 | } 39 | 40 | die () { 41 | echo 42 | echo "$*" 43 | echo 44 | exit 1 45 | } 46 | 47 | # OS specific support (must be 'true' or 'false'). 48 | cygwin=false 49 | msys=false 50 | darwin=false 51 | nonstop=false 52 | case "`uname`" in 53 | CYGWIN* ) 54 | cygwin=true 55 | ;; 56 | Darwin* ) 57 | darwin=true 58 | ;; 59 | MINGW* ) 60 | msys=true 61 | ;; 62 | NONSTOP* ) 63 | nonstop=true 64 | ;; 65 | esac 66 | 67 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar 68 | 69 | # Determine the Java command to use to start the JVM. 70 | if [ -n "$JAVA_HOME" ] ; then 71 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 72 | # IBM's JDK on AIX uses strange locations for the executables 73 | JAVACMD="$JAVA_HOME/jre/sh/java" 74 | else 75 | JAVACMD="$JAVA_HOME/bin/java" 76 | fi 77 | if [ ! -x "$JAVACMD" ] ; then 78 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME 79 | 80 | Please set the JAVA_HOME variable in your environment to match the 81 | location of your Java installation." 82 | fi 83 | else 84 | JAVACMD="java" 85 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 86 | 87 | Please set the JAVA_HOME variable in your environment to match the 88 | location of your Java installation." 89 | fi 90 | 91 | # Increase the maximum file descriptors if we can. 92 | if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then 93 | MAX_FD_LIMIT=`ulimit -H -n` 94 | if [ $? -eq 0 ] ; then 95 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then 96 | MAX_FD="$MAX_FD_LIMIT" 97 | fi 98 | ulimit -n $MAX_FD 99 | if [ $? -ne 0 ] ; then 100 | warn "Could not set maximum file descriptor limit: $MAX_FD" 101 | fi 102 | else 103 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" 104 | fi 105 | fi 106 | 107 | # For Darwin, add options to specify how the application appears in the dock 108 | if $darwin; then 109 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" 110 | fi 111 | 112 | # For Cygwin, switch paths to Windows format before running java 113 | if $cygwin ; then 114 | APP_HOME=`cygpath --path --mixed "$APP_HOME"` 115 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` 116 | JAVACMD=`cygpath --unix "$JAVACMD"` 117 | 118 | # We build the pattern for arguments to be converted via cygpath 119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` 120 | SEP="" 121 | for dir in $ROOTDIRSRAW ; do 122 | ROOTDIRS="$ROOTDIRS$SEP$dir" 123 | SEP="|" 124 | done 125 | OURCYGPATTERN="(^($ROOTDIRS))" 126 | # Add a user-defined pattern to the cygpath arguments 127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then 128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" 129 | fi 130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh 131 | i=0 132 | for arg in "$@" ; do 133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` 134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option 135 | 136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition 137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` 138 | else 139 | eval `echo args$i`="\"$arg\"" 140 | fi 141 | i=$((i+1)) 142 | done 143 | case $i in 144 | (0) set -- ;; 145 | (1) set -- "$args0" ;; 146 | (2) set -- "$args0" "$args1" ;; 147 | (3) set -- "$args0" "$args1" "$args2" ;; 148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;; 149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; 150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; 151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; 152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; 153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; 154 | esac 155 | fi 156 | 157 | # Escape application args 158 | save () { 159 | for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done 160 | echo " " 161 | } 162 | APP_ARGS=$(save "$@") 163 | 164 | # Collect all arguments for the java command, following the shell quoting and substitution rules 165 | eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS" 166 | 167 | # by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong 168 | if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then 169 | cd "$(dirname "$0")" 170 | fi 171 | 172 | exec "$JAVACMD" "$@" 173 | --------------------------------------------------------------------------------