Merge branch 'main' into recent-followers-and-following

Author: rgantzos

.github/scripts/extract-classnames.js

@@ -0,0 +1,45 @@
+const fs = require("fs");
+const path = require("path");
+
+const rootDir = path.resolve(__dirname, "../../features");
+const outputFile = path.resolve(__dirname, "../../class-names.json");
+
+let collected = new Set();
+
+function traverseDir(dir) {
+  const files = fs.readdirSync(dir);
+  for (const file of files) {
+    const fullPath = path.join(dir, file);
+    const stat = fs.statSync(fullPath);
+
+    if (stat.isDirectory()) {
+      traverseDir(fullPath);
+    } else if (stat.isFile() && file.endsWith(".js")) {
+      const content = fs.readFileSync(fullPath, "utf-8");
+      const regex = /className\(["'`](.*?)["'`]\)/g;
+      let match;
+      while ((match = regex.exec(content)) !== null) {
+        collected.add({
+          className: "ste-" + match[1].replaceAll(" ", "-"),
+          features: [
+            dir.split("/features/")[1].split("/")[0].replaceAll(".js", ""),
+          ],
+        });
+      }
+    }
+  }
+}
+
+traverseDir(rootDir);
+
+const mergedFeatures = Object.values(
+    [...collected].reduce((acc, item) => {
+      if (!acc[item.className]) {
+        acc[item.className] = { className: item.className, features: new Set() };
+      }
+      item.features.forEach(f => acc[item.className].features.add(f));
+      return acc;
+    }, {})
+  ).map(obj => ({ className: obj.className, features: [...obj.features] }));
+
+fs.writeFileSync(outputFile, JSON.stringify(mergedFeatures, null, 2));

.github/workflows/extract-classnames.yml

@@ -0,0 +1,48 @@
+name: Extract Class Names
+
+on:
+  push:
+    paths:
+      - "features/**.js"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  extract:
+    if: github.repository == 'STForScratch/ScratchTools'
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Run extraction script
+        run: node .github/scripts/extract-classnames.js
+
+      - name: Check for changes
+        id: git-diff
+        run: |
+          if git diff --quiet --exit-code class-names.json; then
+            echo "changed=false" >> $GITHUB_OUTPUT
+          else
+            echo "changed=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create or Update Pull Request
+        if: steps.git-diff.outputs.changed == 'true'
+        uses: peter-evans/create-pull-request@v6
+        with:
+          commit-message: "Update class-names.json"
+          branch: update-class-names
+          title: "Update class names"
+          body: "Automated update of class-names.json"
+          labels: automated
+          assignees: rgantzos
+          delete-branch: true

README.md

@@ -40,12 +40,12 @@ There are multiple ways of installing.
 - Chrome: You can download from Chrome's Extension Webstore [here](https://chrome.google.com/webstore/detail/scratchtools/jjnpbalpllpfdpgplpbcbadkgdmleopm). Then just press the Add to Chrome button, and you've downloaded ScratchTools!
 
 > [!NOTE]
-> If you are using a browser based on Chromium (eg. Brave), then this is your way of installing unless your browser has it's own extension store.
+> If you are using a browser based on Chromium (eg. Brave), then this is your way of installing unless your browser has its own extension store.
 
 - Firefox/Mozilla: You can download from Firefox Addons (Works on Firefox forks) [here](https://addons.mozilla.org/en-US/firefox/addon/scratchtools/). You can then just add it to Firefox, and then you have ScratchTools!
 
 > [!NOTE]
-> The Firefox version of Scratchtools is behind compared to the chrome version of Scratchtools due to technical difficulties. Until a solution is found, the Firefox version will remain behind.
+> The Firefox version of ScratchTools is behind compared to the Chrome version of ScratchTools due to technical difficulties. Until a solution is found, the Firefox version will remain behind.
 
 - Microsoft Edge: You can download from Edge's addon webstore [here](https://microsoftedge.microsoft.com/addons/detail/scratchtools/aaidjeidbnhpjhblbianjeghjopbimmk). You can then just add it to Edge, and then you have ScratchTools!
 - Safari (macOS, iPadOS and iOS): You can build the extension by typing `make` for macOS, and `make ios` for the iOS app (you will have to sign it on Xcode), make sure you have enabled Developer mode and allowed unsigned extensions.
@@ -55,7 +55,7 @@ There are multiple ways of installing.
 - GitHub (For Firefox & Firefox Forks): Download from the GitHub repository [here](https://github.com/STForScratch/ScratchTools/zipball/master). After the `.zip` file is downloaded, unpack it. Then, with the folder, go to `about:debugging`, click "This Firefox" and click "Load temporary extension", go into the extension folder and select the `manifest.json`.
 
 > [!WARNING]
-> Extensions loaded this way onto Safari indeed temporary. Once you close the window, it will be gone. In addition, ScratchTools is still outdated on Firefox at the time of writing this.
+> Extensions loaded this way onto Safari are temporary. Once you close the window, it will be gone.
 
 - Installing with Git: Open the code dropdown on the extension's repository, copy the HTTPS url and then execute `git clone https://github.com/STForScratch/ScratchTools.git -b main` in Git, and you have installed ScratchTools! To pull changes instead of cloning the repository, enter the folder and execute `git remote add upstream https://github.com/STForScratch/ScratchTools.git`. When a commit is made to the repository, you can just run `git pull upstream main` to pull the changes, note that sometimes you may need to refresh ScratchTools.
 
@@ -77,7 +77,7 @@ Using `ScratchTools.Auth`, you can access the authentication info for the signed
 Using `ScratchTools.Scratch.blockly` and `ScratchTools.Scratch.vm`, you can access the Blockly and Virtual Machine from inside the editor (or on the project page with vm). Blockly must wait for the editor to load, but the virtual machine is ready instantly.
 ##### Blockly Context Menus
 If you want to control what appears in a context menu, you easily can with the `ScratchTools.Scratch.waitForContextMenu()` API. The only input you need is JSON, which must include the block ID for the context menu, the ID you want to set for the context menu option (lets you change the context menu option, so don't use the same ID as another feature), and the callback for when the context menu is opened. The callback function will also have an input, which is the context menu itself. That way, you can add the context menu option when the context menu is opened.
-##### Sound , GUI and Paint-Mode
+##### Sound, GUI and Paint-Mode
 Using `ScratchTools.Scratch.scratchSound`and `ScratchTools.Scratch.scratchGui`, you can return sound from the editor as well as access Graphical User Interface inside the editor. `ScratchTools.Scratch.scratchPaint` can be used in selecting the paint editor mode.
 
 #### Logging

_locales/en/messages.json

@@ -6,7 +6,7 @@
     "message": "ScratchTools is fully customizable with tons of features, all for making the Scratch website better and easier to use!"
   },
   "supportButton": {
-    "message": "Get support"
+    "message": "Get live support"
   },
   "feedbackButton": {
     "message": "Give feedback"

api/feature.js

@@ -6,6 +6,9 @@ class Feature {
         finalFeature = el;
       }
     });
+    this.requestPermissions = async function(...permissions) {
+      return await ScratchTools.sendMessage("request-perms", permissions)
+    }
     this.data = finalFeature;
     this.msg = function (string) {
       return this.data.localesData[`${this.data.id}/`+string] || `ScratchTools.${this.data.id}.${string}`;
@@ -87,6 +90,9 @@ class Feature {
 
       return element[reactKey]
     }
+    this.getInternalKey = function(element) {
+      return Object.keys(element).find((key) => key.startsWith("__reactInternalInstance")) || null
+    }
     this.redux = document.querySelector("#app")?.[
         Object.keys(app).find((key) => key.startsWith("__reactContainer"))
       ].child.stateNode.store

api/main.js

@@ -101,6 +101,23 @@ if (
   ScratchTools.type = "Website";
 }
 
+ScratchTools.MESSAGES = []
+ScratchTools.sendMessage = function(id, content) {
+  let uuid = UUID()
+  chrome.runtime.sendMessage(ScratchTools.id, { message: id, content, source: "message-api", uuid });
+  return new Promise((resolve, reject) => {
+    ScratchTools.MESSAGES.push({ message: id, source: "message-api", uuid, resolve });
+  });
+}
+
+function UUID() {
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (char) {
+      const random = Math.random() * 16 | 0;
+      const value = char === 'x' ? random : (random & 0x3 | 0x8);
+      return value.toString(16);
+  });
+}
+
 var storagePromises = [];
 ScratchTools.storage = {
   get: async function (key) {
@@ -409,7 +426,7 @@ ScratchTools.waitForElements(
           scratchClass("menu_hoverable_");
 
         var div = document.createElement("div");
-        div.className = "settings-menu_option_3rMur";
+        div.className = "settings-menu_option_GGukG";
 
         var icon = document.createElement("img");
         icon.src = ScratchTools.icons.main;

api/module.js

@@ -21,6 +21,10 @@ function scratchClass(name) {
   }
 }
 
+function className(name) {
+  return "ste-" + name.toLowerCase().replaceAll(" ", "-")
+}
+
 ScratchTools.modules.forEach(async function (script) {
   var feature = await import(ScratchTools.dir + "/api/feature/index.js");
   var shouldBeRun = true;
@@ -41,6 +45,7 @@ ScratchTools.modules.forEach(async function (script) {
         fun.default({
           feature: featureGenerated,
           scratchClass,
+          className,
           console: {
             log: function (content) {
               ste.console.log(content, script.feature.id);
@@ -78,6 +83,7 @@ ScratchTools.injectModule = async function (script) {
         fun.default({
           feature: featureGenerated,
           scratchClass,
+          className,
           console: {
             log: function (content) {
               ste.console.log(content, script.feature.id);

api/update/changelogs/forum.json

@@ -0,0 +1,7 @@
+{
+    "active": false,
+    "title": "Forum Changes for {{ version }}",
+    "description": "",
+    "changes": []
+  }
+  

api/update/changelogs/project.json

@@ -0,0 +1,63 @@
+{
+  "active": true,
+  "title": "Project Page Changes for {{ version }}",
+  "description": "ScratchTools is introducing many new project page and editor features that will revolutionize the way that you use Scratch. You can enable them on the settings page.",
+  "changes": [
+    {
+      "icon": "gradient.svg",
+      "slogan": "Rotate gradient colors in the paint editor"
+    },
+    {
+      "icon": "align.svg",
+      "slogan": "Align shapes and objects in the paint editor"
+    },
+    {
+      "icon": "align.svg",
+      "slogan": "Quickly center text in your project instructions"
+    },
+    {
+      "icon": "extend.svg",
+      "slogan": "Extend C-blocks around code when dragging them"
+    },
+    {
+      "icon": "filesize.svg",
+      "slogan": "View file sizes for any asset"
+    },
+    {
+      "icon": "font.svg",
+      "slogan": "Use dozens of extra fonts in the paint editor"
+    },
+    {
+      "icon": "nocloud.svg",
+      "slogan": "Temporarily disable cloud variables in projects"
+    },
+    {
+      "icon": "opacity.svg",
+      "slogan": "Customize the opacity of stage variable monitors"
+    },
+    {
+      "icon": "outline.svg",
+      "slogan": "Customize and round lines and shape outlines"
+    },
+    {
+      "icon": "reaction.svg",
+      "slogan": "Add and view emoji reactions on any project"
+    },
+    {
+      "icon": "record.svg",
+      "slogan": "Record and save videos of your project stage"
+    },
+    {
+      "icon": "shapes.svg",
+      "slogan": "Unite, subtract, intersect, and exclude shapes"
+    },
+    {
+      "icon": "thumbnail.svg",
+      "slogan": "Upload custom project thumbnails"
+    },
+    {
+      "icon": "upload.svg",
+      "slogan": "Upload WEBP images as costumes and sprites"
+    }
+  ]
+}

api/update/changelogs/website.json

@@ -0,0 +1,28 @@
+{
+    "active": true,
+    "title": "Website Changes for {{ version }}",
+    "description": "ScratchTools is introducing many new features for the Scratch website. You can enable them on the settings page.",
+    "changes": [
+      {
+        "icon": "change.svg",
+        "slogan": "Customize what tag is used by default on the explore page"
+      },
+      {
+        "icon": "gift.svg",
+        "slogan": "A ScratchTools selection of featured projects"
+      },
+      {
+        "icon": "filter.svg",
+        "slogan": "Filter through studio, explore, and searched projects"
+      },
+      {
+        "icon": "date.svg",
+        "slogan": "See when a studio was created"
+      },
+      {
+        "icon": "countdown.svg",
+        "slogan": "View how many replies are left in a thread"
+      }
+    ]
+  }
+