@gimloader/external-svelte-plugin 1.0.0

package/README.md

@@ -0,0 +1,26 @@
+# @gimloader/external-svelte-plugin
+
+A plugin for the Gimloader [build tools](https://github.com/Gimloader/build) which makes scripts automatically use Gimloader's exposed Svelte exports, cutting down script size by 1-2k lines.
+
+This plugin requires Svelte v5.43.0 exactly. Should Gimloader update its svelte version in the future, there will be a short grace period before the old version is removed.
+
+## Usage
+
+Import the plugin and add it to the plugins array of your `gimloader.config.ts/js` file. This should be used alongside the [esbuild-svelte](https://github.com/EMH333/esbuild-svelte) plugin.
+
+```js
+import svelte from "esbuild-svelte";
+import { externalSvelte } from "@gimloader/external-svelte-plugin";
+
+export default {
+    // ...
+    plugins: [
+        svelte({
+            compilerOptions: {
+                css: "injected"
+            }
+        }),
+        externalSvelte()
+    ]
+}
+```

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@gimloader/external-svelte-plugin",
+  "description": "Allows bundled Gimloader plugins to use Gimloader's exposed svelte exports",
+  "version": "1.0.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "peerDependencies": {
+    "esbuild": ">=0.17.0",
+    "svelte": "5.43.0",
+    "typescript": "^5"
+  },
+  "type": "module"
+}

package/src/index.ts

@@ -0,0 +1,66 @@
+import type { Plugin } from "esbuild";
+
+const keysCache = new Map<string, string[]>();
+const imports: Record<string, string> = {
+    "svelte": "Index",
+    "svelte/internal/client": "Client",
+    "svelte/animate": "Animate",
+    "svelte/attachments": "Attachments",
+    "svelte/easing": "Easing",
+    "svelte/events": "Events",
+    "svelte/motion": "Motion",
+    "svelte/reactivity/window": "WindowReactivity",
+    "svelte/reactivity": "Reactivity",
+    "svelte/store": "Store",
+    "svelte/transition": "Transition"
+}
+
+const reserved = ["if", "await"];
+const svelteVersion = "5_43_0";
+
+export function externalSvelte(): Plugin {
+    return {
+        name: "external-svelte",
+        setup(build) {
+            build.onResolve({ filter: /^svelte/ }, async (args) => {
+                if(imports[args.path]) {
+                    return { path: args.path, namespace: "external-svelte" };
+                }
+
+                return { path: args.path, namespace: "external-svelte-ignore" }
+            }); 
+
+            build.onLoad({ filter: /.*/, namespace: "external-svelte" }, async (args) => {
+                const contents = await createContents(args.path);
+                return { contents, loader: "js" }
+            });
+
+            build.onLoad({ filter: /.*/, namespace: "external-svelte-ignore" }, () => {
+                return { contents: "", loader: "js" }
+            });
+        }
+    }
+}
+
+async function createContents(path: string){ 
+    const type = imports[path];
+    let keys = keysCache.get(path);
+    if(!keys) {
+        keys = Object.keys(await import(path));
+        keysCache.set(path, keys);
+    }
+
+    const normalKeys = keys.filter(k => !reserved.includes(k));
+    const reservedKeys = keys.filter(k => reserved.includes(k));
+
+    // Add normal exports
+    let contents = normalKeys.map(k => `const ${k} = /** @__PURE__ */ (() => GL.svelte_${svelteVersion}.${type}.${k})();`).join("\n")
+        + `export { ${normalKeys.join(", ")} };\n`;
+    
+    // Add exports with a reserved keyword, if applicable
+    if(reservedKeys.length === 0) return contents;
+    contents += reservedKeys.map(k => `const ${k}_export = /** @__PURE__ */ (() => GL.svelte_${svelteVersion}.${type}.${k})();`).join("\n")
+        + `export { ${reservedKeys.map(k => `${k}_export as ${k}`)} };\n`;
+
+    return contents;
+}

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+    "outDir": "dist",
+    "declaration": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "verbatimModuleSyntax": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}