polybundle 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,6 +4,11 @@ Simple (heavily clanker-made) Lua script bundler for Polytoria.
 
 ## Installation
 
+install globally
+```
+npm install -g polybundle
+```
+
 install from this repo:
 
 ```
@@ -43,6 +48,8 @@ An array of entry script paths (order matters):
 ```
 
 ## Example Output:
+[Instance2Lua](https://github.com/geringverdien/Polytoria-Instance2Lua) is built using polybundle! Below is the bundled output from the boilerplate init scripts
+
 ```lua
 local __module_env = {}
 
@@ -58,18 +65,18 @@ return returnedLib
 end)()
 
 -- polybundle: begin scripts\init1.lua
-coroutine.wrap(function()
+spawn(function()
 local lib = __module_env["scripts/lib/library1.module.lua"]
 
 local addResult = lib.Add(2, 50)
 
 print(addResult)
 print("added successfully in init1")
-end)()
+end)
 -- polybundle: end scripts\init1.lua
 
 -- polybundle: begin scripts\init2.lua
-coroutine.wrap(function()
+spawn(function()
 local addLib = __module_env["scripts/lib/library1.module.lua"]
 
 local addResult = addLib.Add(9, 10)
@@ -79,6 +86,6 @@ local res = "add result is "
 local final = res .. tostring(addResult)
 
 print(final)
-end)()
+end)
 -- polybundle: end scripts\init2.lua
-```
+```

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "polybundle",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Lua script bundler for Polytoria.",
   "license": "MIT",
   "bin": {
-    "polybundle": "./bin/polybundle.js"
+    "polybundle": "bin/polybundle.js"
   },
   "files": [
     "bin/",

package/src/bundler.js

@@ -140,7 +140,7 @@ function bundleEntries(entries, rootDir) {
 
     const entrySource = fs.readFileSync(entryPath, "utf8");
     const replaced = replaceRequiresWithModuleRefs(entrySource, entryPath, rootDir, moduleKeyMap);
-    const wrapped = `coroutine.wrap(function()\n${normalizeLuaSource(replaced)}end)()`;
+    const wrapped = `spawn(function()\n${normalizeLuaSource(replaced)}end)`;
     const header = `-- polybundle: begin ${path.relative(rootDir, entryPath)}\n`;
     const footer = `-- polybundle: end ${path.relative(rootDir, entryPath)}\n`;
     chunks.push(header + normalizeLuaSource(wrapped) + footer);

package/src/cli.js

@@ -123,7 +123,14 @@ function run(args) {
     : path.resolve(cwd, "dist", "bundle.lua");
 
   try {
+    // save output file, warn user about localscript string lenght limit if output exceeds 65,535 characters
     const bundled = bundleEntries(entries, cwd);
+    if (bundled.length > 65535) {
+      console.warn(
+        "Warning: Output exceeds 65,535 characters, which is the limit for LocalScripts in Polytoria.\n" +
+        "Consider splitting your code into multiple bundles or optimizing your code to reduce size."
+      );
+    }
     fs.mkdirSync(path.dirname(outFile), { recursive: true });
     fs.writeFileSync(outFile, bundled, "utf8");
     console.log(`Bundled ${entries.length} entries into ${outFile}`);