✨ Add a built-in asset gallery of CC0/WTFPL assets

.gitmodules

@@ -7,3 +7,6 @@
 [submodule "docs"]
 	path = docs
 	url = https://github.com/ct-js/docs.ctjs.rocks.git
+[submodule "bundledAssets"]
+	path = bundledAssets
+	url = https://github.com/ct-js/bundled-assets.git

app/data/i18n/English.json

@@ -79,7 +79,18 @@
         "addToNotes": "Add to notes",
         "noRooms": "You need at least one room to compile your app.",
         "tileLayer": "tile layer",
-        "ctSite": "ct.js homepage"
+        "ctSite": "ct.js homepage",
+        "openAssetGallery": "Gallery",
+        "assetTypes": {
+            "textures": ["texture", "textures", "textures"],
+            "templates": ["template", "templates", "templates"],
+            "emitterTandems": ["emitter tandem", "emitter tandems", "emitter tandems"],
+            "rooms": ["room", "rooms", "rooms"],
+            "fonts": ["font", "fonts", "fonts"],
+            "styles": ["style", "styles", "styles"],
+            "sounds": ["sound", "sounds", "sounds"],
+            "skeletons": ["skeletal sprite", "skeletal sprites", "skeletal sprites"]
+        }
     },
     "assetInput": {
         "changeAsset": "Press to change the asset",
@@ -92,6 +103,20 @@
         "newGroupName": "New group",
         "groupDeletionConfirmation": "Are you sure you want to delete this group? All its assets will be ungrouped."
     },
+    "builtinAssetGallery": {
+        "galleryTip": "This is a free, built-in gallery of various textures and sounds. All the assets are CC0 or WTFPL, or are released under special terms for use in ct.js. In any way, you can use these assets however you like, in commercial and other projects.",
+        "assetGalleryHeader": "Assets",
+        "importIntoProject": "Import into the current project",
+        "importAll": "Import all",
+        "byAuthorPrefix": "by",
+        "cannotImportExplanation": "The name that this asset would take is taken by some other asset. You may need to rename existing assets; or maybe you've already imported this asset?",
+        "nameOccupied": "Name occupied",
+        "cannotImportNameOccupied": "Cannot import $1 as such name is already occupied.",
+        "visitSource": "Open the store page of this asset pack",
+        "visitAuthorsItch": "Visit author's itch.io page",
+        "visitAuthorsTwitter": "Visit author's Twitter page",
+        "tipAuthor": "Tip the author for their hard work :D"
+    },
     "colorPicker": {
         "current": "New",
         "globalPalette": "Global Palette",

src/node_requires/extendGlobals.d.ts

@@ -1,15 +1,28 @@
+// eslint-disable-next-line spaced-comment
+/// <reference types="../../app/node_modules/pixi.js/" />
+
 export {};
 declare global {
+    var signals: any;
+    var orders: any;
+    var alertify: any;
+    var languageJSON: any;
+    var monaco: any;
+    var currentProject: IProject;
+    var projdir: string;
+    function showOpenDialog(options: any): Promise<string | false>;
+    function showSaveDialog(options: any): Promise<string | false>;
     interface Window {
         signals: any;
         orders: any;
         alertify: any;
-        currentProject: any;
+        currentProject: IProject;
+        languageJSON: any;
+        monaco: any;
+        projdir: string;
+        showOpenDialog(options: any): Promise<string | false>;
+        showSaveDialog(options: any): Promise<string | false>;
     }
-    var signals: any;
-    var orders: any;
-    var alertify: any;
-    var currentProject: any;
 }
 declare namespace PIXI {
     var Texture: any;

src/node_requires/imageUtils.ts

@@ -164,7 +164,7 @@ const outputCanvasToFile = function (canvas: HTMLCanvasElement, targetFile: stri
     return fs.outputFile(targetFile, buffer);
 };
 
-module.exports = {
+export {
     imageCover,
     imageContain,
     imagePlaceInRect,

src/node_requires/platformUtils.js → src/node_requires/platformUtils.ts

@@ -6,6 +6,14 @@ const isWin = (/win[0-9]+/).test(os.platform());
 const isLinux = os.platform() === 'linux';
 const isMac = !(isWin || isLinux);
 
+// We compute a directory once and store it forever
+let exportDir: string,
+    exportDirPromise: Promise<string>,
+    buildDir: string,
+    buildDirPromise: Promise<string>,
+    projectsDir: string,
+    projectsDirPromise: Promise<string>;
+
 const mod = {
     isWin,
     isWindows: isWin,
@@ -18,10 +26,10 @@ const mod = {
      * @param {String} way A path to check against
      * @returns {Promise<Boolean>} Resolves into either `true` (if writable) or `false`
      */
-    checkWritable(way) {
+    checkWritable(way: string): Promise<boolean> {
         return new Promise(resolve => {
             // eslint-disable-next-line no-bitwise
-            fs.access(way, fs.constants.R_OK | fs.constants.W_OK, err => {
+            fs.access(way, fs.constants.R_OK | fs.constants.W_OK, (err: Error) => {
                 if (err) {
                     resolve(false);
                 } else {
@@ -36,7 +44,7 @@ const mod = {
      *
      * @returns {Promise<String>} A writable directory
      */
-    async getWritableDir() {
+    async getWritableDir(): Promise<string> {
         if (localStorage.customWritableDir) {
             if (!(await mod.checkWritable(localStorage.customWritableDir))) {
                 throw new Error(`Custom data folder ${localStorage.customWritableDir} is read-only`);
@@ -72,71 +80,16 @@ const mod = {
         }
         return exec;
     },
-    async getTempDir() {
+    async getTempDir(): Promise<{dir: string, remove: () => void}> {
         const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'ctjs-'));
         return {
             dir,
             remove() {
                 return fs.remove(dir);
             }
         };
-    }
-};
-
-{
-    let exportDir,
-        exportDirPromise,
-        buildDir,
-        buildDirPromise,
-        projectsDir,
-        projectsDirPromise;
-    // We compute a directory once and store it forever
-    mod.getExportDir = () => {
-        if (exportDir) {
-            return Promise.resolve(exportDir);
-        }
-        if (exportDirPromise) {
-            return exportDirPromise;
-        }
-        exportDirPromise = mod.getWritableDir().then(async ctjsDir => {
-            const dir = require('path').join(ctjsDir, 'Exported');
-            await fs.ensureDir(dir);
-            exportDir = dir;
-            return exportDir;
-        });
-        return exportDirPromise;
-    };
-    mod.getBuildDir = () => {
-        if (buildDir) {
-            return Promise.resolve(buildDir);
-        }
-        if (buildDirPromise) {
-            return buildDirPromise;
-        }
-        buildDirPromise = mod.getWritableDir().then(async ctjsDir => {
-            const dir = require('path').join(ctjsDir, 'Builds');
-            await fs.ensureDir(dir);
-            buildDir = dir;
-            return buildDir;
-        });
-        return buildDirPromise;
-    };
-    mod.getProjectsDir = () => {
-        if (projectsDir) {
-            return Promise.resolve(projectsDir);
-        }
-        if (projectsDirPromise) {
-            return projectsDirPromise;
-        }
-        projectsDirPromise = mod.getWritableDir().then(async ctjsDir => {
-            const dir = require('path').join(ctjsDir, 'Projects');
-            await fs.ensureDir(dir);
-            projectsDir = dir;
-            return projectsDir;
-        });
-        return projectsDirPromise;
-    };
-    mod.requestWritableDir = async () => {
+    },
+    requestWritableDir: async (): Promise<boolean> => {
         const voc = window.languageJSON.writableFolderSelector;
         const folder = await window.showOpenDialog({
             openDirectory: true,
@@ -161,7 +114,58 @@ const mod = {
             window.alertify.error(voc.folderDoesNotExist);
         }
         return false;
-    };
-}
-
-module.exports = mod;
+    },
+    getGalleryDir(createHref?: boolean): string {
+        const path = require('path');
+        if (createHref) {
+            return ('file://' + path.posix.normalize(path.join((nw.App as any).startPath, 'bundledAssets')));
+        }
+        return path.join((nw.App as any).startPath, 'bundledAssets');
+    },
+    getProjectsDir(): Promise<string> {
+        if (projectsDir) {
+            return Promise.resolve(projectsDir);
+        }
+        if (projectsDirPromise) {
+            return projectsDirPromise;
+        }
+        projectsDirPromise = mod.getWritableDir().then(async (ctjsDir: string) => {
+            const dir = require('path').join(ctjsDir, 'Projects');
+            await fs.ensureDir(dir);
+            projectsDir = dir;
+            return projectsDir;
+        });
+        return projectsDirPromise;
+    },
+    getBuildDir(): Promise<string> {
+        if (buildDir) {
+            return Promise.resolve(buildDir);
+        }
+        if (buildDirPromise) {
+            return buildDirPromise;
+        }
+        buildDirPromise = mod.getWritableDir().then(async (ctjsDir: string) => {
+            const dir = require('path').join(ctjsDir, 'Builds');
+            await fs.ensureDir(dir);
+            buildDir = dir;
+            return buildDir;
+        });
+        return buildDirPromise;
+    },
+    getExportDir(): Promise<string> {
+        if (exportDir) {
+            return Promise.resolve(exportDir);
+        }
+        if (exportDirPromise) {
+            return exportDirPromise;
+        }
+        exportDirPromise = mod.getWritableDir().then(async ctjsDir => {
+            const dir = require('path').join(ctjsDir, 'Exported');
+            await fs.ensureDir(dir);
+            exportDir = dir;
+            return exportDir;
+        });
+        return exportDirPromise;
+    }
+};
+export = mod;

src/node_requires/resources/IAsset.d.ts

@@ -2,4 +2,5 @@ interface IAsset {
     readonly type: resourceType;
     readonly uid: string;
     lastmod: number;
+    group?: string;
 }

src/node_requires/resources/emitterTandems/index.ts

@@ -2,7 +2,7 @@ const getThumbnail = function getThumbnail(): string {
     return 'sparkles';
 };
 const getById = function getById(id: string): ITandem {
-    const tandem = global.currentProject.tandems.find((t: ITandem) => t.uid === id);
+    const tandem = (window as Window).currentProject.tandems.find((t: ITandem) => t.uid === id);
     if (!tandem) {
         throw new Error(`Attempt to get a non-existent tandem with ID ${id}`);
     }

src/node_requires/resources/projects/IProject.d.ts

@@ -0,0 +1,9 @@
+declare interface IProject {
+    textures: ITexture[];
+    templates: ITemplate[];
+    sounds: ISound[];
+    rooms: IRoom[];
+    tandems: ITandem[];
+    fonts: IFont[];
+    [key: string]: any;
+}

src/node_requires/resources/sounds/index.ts

@@ -11,12 +11,12 @@ const getById = function getById(id: string): ISound {
     return sound;
 };
 
-const createNewSound = function (): ISound {
+const createNewSound = function (name?: string): ISound {
     const generateGUID = require('./../../generateGUID');
     var id = generateGUID(),
         slice = id.slice(-6);
     var newSound = {
-        name: 'Sound_' + slice,
+        name: name || ('Sound_' + slice),
         uid: id,
         isMusic: false,
         type: 'sound' as resourceType,
@@ -36,7 +36,7 @@ const addSoundFile = async function addSoundFile(sound: ISound, file: string): P
         sound.lastmod = Number(new Date());
     } catch (e) {
         console.error(e);
-        alertify.error(e);
+        (window as Window).alertify.error(e);
         throw e;
     }
 };

src/node_requires/resources/textures/ITexture.d.ts

@@ -0,0 +1,26 @@
+interface ITexture extends IAsset {
+    type: 'texture';
+    uid: string;
+    name: string;
+    origname: string;
+    grid: [number, number];
+    axis: [number, number];
+    width: number;
+    height: number;
+    imgWidth: number;
+    imgHeight: number;
+    offx: number;
+    offy: number;
+    marginx: number;
+    marginy: number;
+    padding: number;
+    untill: number;
+    lastmod: number;
+    source?: string;
+    shape: 'rect' | 'strip' | 'circle',
+    left?: number;
+    right?: number;
+    top?: number;
+    bottom?: number;
+    tiled?: boolean;
+}