Merge branch 'main' into dogeiscutSets

Author: DogeisCut

.github/workflows/build.yml

@@ -0,0 +1,39 @@
+# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
+
+name: build
+
+on:
+  push: 
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: install node
+      uses: actions/setup-node@v4
+      with:
+        node-version: 22.x
+        cache: 'npm'
+    - run: npm ci
+    - run: npm run build
+    - name: Upload GitHub Pages artifact
+      uses: actions/upload-pages-artifact@v3.0.1
+      with:
+        # Path of the directory containing the static assets.
+        path: public/
+  deploy:
+    runs-on: ubuntu-latest
+    needs: build
+    #if: github.ref == 'refs/heads/main'
+    permissions:
+      id-token: write
+      pages: write
+    steps:
+    - name: Deploy to GitHub Pages
+      id: deployment
+      uses: actions/deploy-pages@v4.0.5

.gitignore

@@ -9,4 +9,6 @@ node_modules
 !.env.example
 vite.config.js.timestamp-*
 vite.config.ts.timestamp-*
-/temp
+/temp
+.dev
+desktop.ini

README.md

@@ -1,5 +1,15 @@
 # Extension Gallery
 
+## Licensing
+The source for [the extensions site](https://extensions.penguinmod.com)
+(including but not limited to: the source code, assets, extension thumbnails and extension documentation)
+are all licensed under [the MIT license](https://opensource.org/license/mit).
+
+### Extension code licensing
+See [the licensing file for extension code](/static/extensions/LICENSING.md).
+
+Extension thumbnails and documentation are under the MIT license.
+
 ## Submitting an extension
 
 ### NOTE!
@@ -16,10 +26,8 @@ Create your extension. You can find a lot of details [here](https://docs.turbowa
 and [Gallery page](https://extensions.penguinmod.com/) to confirm.
 - Your extension should be created for a specific purpose. An extension with random blocks someone might need will likely not get accepted if the blocks are not in a certain theme, like math or rendering.
 - Your extension should be easily explainable in 1-2 sentences or a single picture. This is what will determine whether you can be on the gallery or not.
-- Your extension should be MIT licensed (not compatible with the MIT license, should be the actual MIT license. This may change in the future.)
-    - `Ashime/MoreFields` is currently a **temporary** exception to this rule. (MIT & LGPL-3.0 license)
-    - `TheShovel/extexp` is currently a **temporary** exception to this rule. (MIT & LGPL-3.0 license)
-    - The above exceptions are accidental changes. Do not knowingly submit extensions under a seperate license to purposely cause licensing issues on our repository.
+- Your extension should be under the MIT license or the LGPL-3.0 license.
+    - See [Extension code licensing](#extension-code-licensing) for information.
 - If your extension uses external content such as JS libraries or CSS stylesheets, you must include them inside the extension code itself. You **CANNOT** fetch/import content from URLs that is a core part of your extension as it'll make the extension unusable offline, or in offline packaged projects. This does not apply to content that obviously requires internet, like an extension that allows projects to use a public API.
 - Your extension **CANNOT** be made entirely with AI or assistive tools such as TurboBuilder. You must understand the raw code your extension is running.
 - Your extension **CANNOT** rely on the use of any generative AI. This is mainly for extensions that respond to messages from AI like ChatGPT. Any extensions added before this rule are an exception.
@@ -208,7 +216,7 @@ Each extension is incased in `{}` brackets. Look below on how to copy it.
     name: "Evaluating Expressions", // The name of the extension.
     description: "Blocks to return the result of an expression.", // The description for the extension.
     code: "Username/extension.js", // The folder and file name for the code of the extension.
-    banner: "Username/Extension.png", // The folder and file name for the banner of the extension.
+    banner: "Username/Extension.avif", // The folder and file name for the banner of the extension. Ideally, use .avif format to save storage space.
     creator: "Username", // Your username. Adds a link to your profile.
 
     // Only applies if you created a documentation page.
@@ -221,4 +229,4 @@ Each extension is incased in `{}` brackets. Look below on how to copy it.
     unstableReason: "May break sometimes, Use at your own risk.", // Optional. Will change the reason that your extension is unstable.
     isGitHub: false, // Optional. false means this is your Scratch username, true means this is your GitHub username.
 },
-```
+```

src/lib/Documentation/PenguinAI.md

@@ -1,5 +1,11 @@
 # PenguinAI Extension Documentation
 
+# PENGUINAI IS NOW DEPRECATED. USE AT YOUR OWN RISK.
+
+Most of the models in this extension no longer work, and will not be fixed. See [This github issue](https://github.com/PenguinMod/PenguinMod-Home/issues/421) for more information. If this extension is present on an extension gallery, alert the owner to have it removed.
+
+## Documentation
+
 The PenguinAI extension brings the power of artificial intelligence to your PenguinMod projects. This extension provides blocks for AI text generation, image creation, streaming conversations, and advanced chatbot management. Perfect for creating interactive AI-powered games, educational tools, and creative projects.
 
 ## Getting Started

src/lib/Documentation/ProjectInterfaces.md

@@ -0,0 +1,59 @@
+# Project Interfaces
+
+---
+
+Project Interfaces is an extension to easily create GUI's inside your projects.
+This documentation will teach you the basics of how to use it.
+
+---
+
+## Getting started
+An "element" refers to an image, button, video, etc on the screen.
+This extension uses an ID system to keep track of GUI elements for later customization.
+
+To create an element, use the "create element block".
+```scratch
+    Create [Label v] element with ID [My element] :: #707eff
+```
+It's important to note that most elements (Like images) wont show up right away. They require more customization, like having the source url set to them.
+
+It's good practice to name your id's such that it gives you a clue of what it's purpose is.
+Example: profile-image, button-1, button-2, ..
+
+## Styling and Customization
+There are several element types to pick from, each with different attributes and ways to customize them.
+
+Blocks under the "Styling" section of the extension can modify any element.
+```scratch
+    Set position of ID [My element] to x: [50] y: [100] :: #707eff
+```
+Each element type also has its own section on the extension, with blocks that can customize that element specifically.
+
+Lets take an input element for example, under the "Inputs" section of the extension you'll find blocks that can customize its input type, placeholder, accent color, value, get the value of the input, and detect when the input is changed.
+
+```scratch
+    when gf clicked
+    Create [Input v] element with ID [My input] :: #707eff
+    Set placeholder of ID [My input] to [What's your name?] :: #707eff
+
+    When input with ID [My input] changed :: hat :: #707eff
+    Say (join [Hello ](Value of input with ID [My input] :: #707eff))
+```
+
+## Advanced
+It's important to note that Project Interfaces uses [HTML elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements) to create GUI's in projects.
+
+This extension has several blocks to further customize elements for those who have a deeper understanding of HTML and CSS.
+
+The "Create html element" block will allow you to create an element based of a HTML tag of your choice.
+The "Set custom CSS" block will override an elements CSS properties.
+
+```scratch
+Create html element [h1] with ID [HTML header] :: #707eff
+Set custom CSS of [HTML header] to [background-color: red] :: #707eff
+```
+
+## Security
+For security reasons, only Label elements (Or span tags) can have text set for them.
+This prevents script execution from <script></script> tags.
+If you wish to execute JavaScript inside your project, please use the JavaScript V2 extension.

src/lib/Documentation/YeetYourFiles.md

@@ -0,0 +1,204 @@
+# YeetYourFiles Extension Documentation
+
+*"Upload files to the cloud by throwing it into outer space!"*
+
+The YeetYourFiles extension allows you to upload files directly from your PenguinMod/TurboWarp projects to the YeetYourFiles hosting service. This extension provides blocks for uploading various types of files, tracking upload status, and retrieving file information.
+
+## File Upload Blocks
+
+### Upload File Data
+```scratch
+upload file data [data] name [file.txt] :: #FF8C00
+```
+Uploads file data with a specified filename to YeetYourFiles.
+
+Parameters:
+- **data**: The file content as a string, base64 encoded data, or data URL
+- **name**: The filename to use for the uploaded file
+
+Examples:
+- Upload text: `upload file data [Hello World!] name [greeting.txt]`
+- Upload base64 image: `upload file data [iVBORw0KGgoAAAANSUhEUg...] name [image.png]`
+- Upload JSON data: `upload file data [{"name": "John", "age": 30}] name [data.json]`
+- It can also upload data urls
+
+### Upload File from URL
+```scratch
+upload file from URL [https://example.com/image.png] :: #FF8C00
+```
+Downloads a file from a URL and uploads it to YeetYourFiles.
+
+Parameters:
+- **URL**: The web address of the file to download and upload
+
+Examples:
+- Upload remote image: `upload file from URL [https://picsum.photos/200/300]`
+- Upload remote document: `upload file from URL [https://example.com/document.pdf]`
+
+### Open File Dialog
+```scratch
+open file dialog and upload :: #FF8C00
+```
+Opens a file picker dialog allowing users to select and upload files from their device.
+
+This block:
+- Opens the native file selection dialog
+- Accepts any file type
+- Automatically uploads the selected file
+- Updates all file information blocks with the upload results
+
+## File Information Blocks
+
+### Last Uploaded File ID
+```scratch
+(last uploaded file ID :: #FF8C00)
+```
+Returns the unique identifier of the most recently uploaded file.
+
+Examples:
+- File ID: `3af5f431-b4a2-414a-8524-f878551e7c59`
+- Can be used to reference the file in other operations
+
+### Last Uploaded File URL
+```scratch
+(last uploaded file URL :: #FF8C00)
+```
+Returns the complete web address where the uploaded file can be accessed.
+
+Examples:
+- Full URL: `https://yyf.mubilop.com/file/abc123def456`
+- Direct access link to view or download the file
+
+### Last Uploaded File Short Hash
+```scratch
+(last uploaded file short hash :: #FF8C00)
+```
+Returns a the short hash used by the server on some routes.
+
+Examples:
+- Short hash: `abc123cd`
+
+### Last Uploaded File Data
+```scratch
+(last uploaded file data :: #FF8C00)
+```
+Returns the complete upload response as a JSON string containing the response from the server (should be used for advanced stuff)
+
+Example response:
+```json
+{
+   "message":"File uploaded successfully",
+   "fileId":"16fd17d4-0d36-4318-9452-f19cb3259374",
+   "fileUrl":"/file/123456ab/MubiIsCool.mov",
+   "shortHash":"123456ab"
+}
+```
+
+## Status and Monitoring Blocks
+
+### Upload Status
+```scratch
+(upload status :: #FF8C00)
+```
+Returns the current status of file uploads.
+
+Possible values:
+- `idle`: No upload in progress
+- `uploading`: File upload is currently in progress
+
+### Upload Successful?
+```scratch
+<upload successful? :: #FF8C00>
+```
+Returns true if the last upload operation completed successfully, false otherwise.
+
+Examples:
+- `true`: Last upload completed without errors
+- `false`: Last upload failed or encountered an error
+
+### Uploaded?
+```scratch
+<uploaded? :: #FF8C00>
+```
+Returns true if any file has been uploaded during the current session, false otherwise.
+
+Examples:
+- `true`: At least one file has been uploaded since the project started
+- `false`: No files have been uploaded yet
+
+### Total Files on YeetYourFiles
+```scratch
+(total files on YeetYourFiles :: #FF8C00)
+```
+Returns the total number of files currently hosted on the YeetYourFiles service.
+
+Examples:
+- `15234`: Total files across all users
+- Updates each time the block is used
+
+## Usage Examples
+
+### Basic Text Upload
+```scratch
+when flag clicked
+upload file data [Hello from Scratch!] name [message.txt]
+wait until <upload successful?>
+say (join [File uploaded: ] (last uploaded file URL)) for (2) seconds
+```
+
+### Upload with Status Monitoring
+```scratch
+when flag clicked
+upload file data [{"score": 100, "level": 5}] name [game-data.json]
+repeat until <not (upload status) = [uploading]>
+  say [Uploading...] for (0.1) seconds
+end
+if <upload successful?> then
+  say [Upload complete!] for (2) seconds
+else
+  say [Upload failed!] for (2) seconds
+end
+```
+
+### Interactive File Upload
+```scratch
+when [space v] key pressed
+open file dialog and upload
+wait until <uploaded?>
+if <upload successful?> then
+  set [file count v] to (total files on YeetYourFiles)
+  say (join [Uploaded! Total files: ] (file count)) for (2) seconds
+end
+```
+
+## Error Handling
+
+(You can use PenguinMod's Try and Catch block with it!)
+
+The extension includes built-in error handling for common issues:
+
+- **No file data**: Returns error when trying to upload empty data
+- **Invalid URL**: Returns error for malformed or inaccessible URLs  
+- **Network issues**: Handles connection failures gracefully
+- **Server errors**: Provides feedback for server-side upload issues
+
+When an upload fails:
+- The `upload successful?` block returns false
+- The `upload status` returns to "idle"
+- Error information is stored in the upload data for debugging
+
+## Service Information
+
+**YeetYourFiles Service**: https://yyf.mubilop.com
+- Free file hosting service
+- No registration required
+- Supports files up to reasonable size limits
+- Files are publicly accessible via direct URLs
+
+## Additional Notes
+
+- The extension requires unsandboxed mode to function properly
+- File uploads are performed asynchronously
+- All uploaded files become publicly accessible via their URLs
+- The service maintains a global counter of total uploaded files
+- File metadata is preserved including original filenames and upload timestamps