@silkweaver/build 1.0.0 → 1.1.0

package/dist/templates.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Starter templates for the New Project flow.
+ *
+ * Each template is a real, ready-to-build project folder bundled under `../templates/<id>/`
+ * (sprites and all). Creating a project from a template is just a recursive copy of that folder
+ * into the destination — no codegen — so the templates stay editable/diffable in the repo and a
+ * dogfooded example game *is* the template. Pure Node (fs/path), reusable from the IDE or CLI.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.list_templates = list_templates;
+exports.create_from_template = create_from_template;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/** Ordered registry of the bundled starter templates (folders live under ../templates/<id>). */
+const TEMPLATE_REGISTRY = [
+    { id: 'empty', label: 'Empty', description: 'A blank project with a single empty room.' },
+    { id: 'platformer', label: 'Platformer', description: 'A/D to move, Space to jump — gravity, solid platforms, parent-based collision.' },
+    { id: 'topdown', label: 'Top-down', description: 'WASD movement with parent-based wall collision (place_meeting + a _col parent).' },
+];
+/** Absolute path to the bundled templates directory (sibling of dist/). */
+function templates_dir() {
+    return path.join(__dirname, '..', 'templates');
+}
+/** Names never copied into a new project (build artifacts / VCS / deps), as a defensive guard. */
+const COPY_DENYLIST = new Set(['_entry.ts', '_engine_globals.ts', 'node_modules', '.git', 'exports', 'game.js']);
+/** Returns the available starter templates — only those whose folder is actually installed. */
+function list_templates() {
+    const out = [];
+    for (const t of TEMPLATE_REGISTRY) {
+        let display_color = '#1a1a2e';
+        try {
+            const j = JSON.parse(fs.readFileSync(path.join(templates_dir(), t.id, 'project.json'), 'utf8'));
+            if (typeof j?.settings?.displayColor === 'string')
+                display_color = j.settings.displayColor;
+        }
+        catch {
+            continue;
+        } // folder missing/unreadable → omit it
+        out.push({ id: t.id, label: t.label, description: t.description, display_color });
+    }
+    return out;
+}
+/**
+ * Materializes a starter template into `dest_folder` by recursively copying its bundled project
+ * folder, then (optionally) setting the display name in project.json.
+ * @param template_id - 'empty' | 'platformer' | 'topdown'
+ * @param dest_folder - Absolute path of the new project folder (created if missing)
+ * @param name        - Optional display name to write into project.json
+ */
+async function create_from_template(template_id, dest_folder, name) {
+    if (!TEMPLATE_REGISTRY.some(t => t.id === template_id))
+        throw new Error(`Unknown template: ${template_id}`);
+    const src = path.join(templates_dir(), template_id);
+    if (!fs.existsSync(path.join(src, 'project.json')))
+        throw new Error(`Template '${template_id}' is not installed`);
+    if (fs.existsSync(path.join(dest_folder, 'project.json')))
+        throw new Error('A project already exists in that folder');
+    await fs.promises.mkdir(dest_folder, { recursive: true });
+    await fs.promises.cp(src, dest_folder, {
+        recursive: true,
+        filter: (s) => !COPY_DENYLIST.has(path.basename(s)),
+    });
+    if (name && name.trim()) {
+        const proj_path = path.join(dest_folder, 'project.json');
+        try {
+            const j = JSON.parse(await fs.promises.readFile(proj_path, 'utf8'));
+            j.name = name.trim();
+            await fs.promises.writeFile(proj_path, JSON.stringify(j, null, 2) + '\n', 'utf8');
+        }
+        catch { /* keep the template's bundled name */ }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@silkweaver/build",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "description": "Silkweaver toolchain — compiles a project folder into a runnable game (HTML5 / desktop executable). Usable from a CLI or the IDE.",
     "type": "commonjs",
     "license": "GPL-3.0",
@@ -23,14 +23,15 @@
     },
     "files": [
         "dist",
-        "assets"
+        "assets",
+        "templates"
     ],
     "scripts": {
         "build": "tsc -p ."
     },
     "dependencies": {
-        "@silkweaver/engine": "1.0.0",
-        "@silkweaver/project": "1.0.0",
+        "@silkweaver/engine": "^1.0.0",
+        "@silkweaver/project": "^1.0.0",
         "@electron/packager": "^19.0.5",
         "esbuild": "^0.27.2",
         "typescript": "^5.9.3"

package/templates/empty/project.json

@@ -0,0 +1,27 @@
+{
+  "name": "Empty",
+  "version": "1.0.0",
+  "engineVersion": "1.0.0",
+  "settings": {
+    "roomSpeed": 60,
+    "windowWidth": 640,
+    "windowHeight": 480,
+    "startRoom": "room_main",
+    "displayColor": "#1a1a2e"
+  },
+  "resources": {
+    "sprites": {},
+    "sounds": {},
+    "backgrounds": {},
+    "paths": {},
+    "scripts": {},
+    "fonts": {},
+    "timelines": {},
+    "objects": {},
+    "rooms": {
+      "room_main": {
+        "name": "room_main"
+      }
+    }
+  }
+}

package/templates/empty/rooms/room_main/room.json

@@ -0,0 +1,16 @@
+{
+  "width": 640,
+  "height": 480,
+  "room_speed": 60,
+  "persistent": false,
+  "creation_code": "",
+  "instances": [],
+  "backgrounds": [],
+  "views": [],
+  "tiles": [],
+  "bg_color": "#1a1a2e",
+  "bg_show_color": true,
+  "physics_world": false,
+  "physics_gravity_x": 0,
+  "physics_gravity_y": 10
+}

package/templates/platformer/objects/_col.ts

@@ -0,0 +1,3 @@
+export class _col extends gm_object {
+    static visible = false
+}

package/templates/platformer/objects/obj_platform.ts

@@ -0,0 +1,10 @@
+export class obj_platform extends gm_object {
+    on_create(): void {
+    }
+
+    // block width
+    // block height
+
+    static parent = _col
+    static sprite = 'spr_platform'
+}

package/templates/platformer/objects/obj_player.ts

@@ -0,0 +1,73 @@
+export class obj_player extends gm_object {
+    spd = 5;
+    jump_force = 15;
+    weight = 1;
+
+    on_create(): void {
+        this.grounded = false;
+        this.vertical_acc = 0.0;
+        this.vertical_vel = 0.0;
+        this.horizontal_vel = 0.0;
+    }
+
+    on_step(): void {
+        // controlls
+        let key_left = keyboard_check(ord("A"));
+        let key_right = keyboard_check(ord("D"));
+        let key_jump = keyboard_check(vk_space);
+
+        // ------------------------------
+        // left to right
+        // ------------------------------
+
+        // motion
+        let dir = 0;
+        if (key_left) {
+            dir = -1;
+        }
+
+        if (key_right) {
+            dir = 1;
+        }
+
+        // movenemt
+        this.horizontal_vel = dir * this.spd;
+        if (!this.place_meeting(this.x + this.horizontal_vel, this.y, _col)) {
+            this.x += this.horizontal_vel;
+        }
+
+        // ------------------------------
+        // jump and gravity
+        // ------------------------------
+
+        // grounding
+        if (this.place_meeting(this.x, this.y + 1, _col)) {
+            this.grounded = true;
+            this.vertical_vel = 0;
+            this.vertical_acc = 0;
+        } else {
+            this.grounded = false;
+        }
+
+        // vertical acceleration (gravity pulls down while airborne)
+        if (!this.grounded) {
+            this.vertical_acc = -this.weight;
+        }
+
+        // jump
+        if (key_jump && this.grounded) {
+            this.vertical_acc = this.jump_force;
+        }
+
+        // apply acceleration, then move — snapping flush against anything in the way
+        this.vertical_vel += this.vertical_acc;
+        if (this.place_meeting(this.x, this.y - this.vertical_vel, _col)) {
+            while (!this.place_meeting(this.x, this.y - sign(this.vertical_vel), _col)) {
+                this.y -= sign(this.vertical_vel);
+            }
+            this.vertical_vel = 0;
+        }
+        this.y -= this.vertical_vel;
+    }
+    static sprite = 'spr_player'
+}

package/templates/platformer/project.json

@@ -0,0 +1,44 @@
+{
+  "name": "Platformer",
+  "version": "1.0.0",
+  "engineVersion": "1.0.0",
+  "settings": {
+    "roomSpeed": 60,
+    "windowWidth": 640,
+    "windowHeight": 480,
+    "startRoom": "room_main",
+    "displayColor": "#10131c"
+  },
+  "resources": {
+    "sprites": {
+      "spr_player": {
+        "name": "spr_player"
+      },
+      "spr_platform": {
+        "name": "spr_platform"
+      }
+    },
+    "sounds": {},
+    "backgrounds": {},
+    "paths": {},
+    "scripts": {},
+    "fonts": {},
+    "timelines": {},
+    "objects": {
+      "obj_player": {
+        "name": "obj_player"
+      },
+      "_col": {
+        "name": "_col"
+      },
+      "obj_platform": {
+        "name": "obj_platform"
+      }
+    },
+    "rooms": {
+      "room_main": {
+        "name": "room_main"
+      }
+    }
+  }
+}

package/templates/platformer/rooms/room_main/room.json

@@ -0,0 +1,327 @@
+{
+  "width": 640,
+  "height": 480,
+  "room_speed": 60,
+  "persistent": false,
+  "creation_code": "",
+  "instances": [
+    {
+      "id": 28,
+      "object_name": "obj_player",
+      "x": 96,
+      "y": 400,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 37,
+      "object_name": "obj_platform",
+      "x": 0,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 38,
+      "object_name": "obj_platform",
+      "x": 32,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 39,
+      "object_name": "obj_platform",
+      "x": 64,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 40,
+      "object_name": "obj_platform",
+      "x": 96,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 41,
+      "object_name": "obj_platform",
+      "x": 128,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 42,
+      "object_name": "obj_platform",
+      "x": 160,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 43,
+      "object_name": "obj_platform",
+      "x": 192,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 44,
+      "object_name": "obj_platform",
+      "x": 224,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 45,
+      "object_name": "obj_platform",
+      "x": 256,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 46,
+      "object_name": "obj_platform",
+      "x": 288,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 47,
+      "object_name": "obj_platform",
+      "x": 320,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 48,
+      "object_name": "obj_platform",
+      "x": 352,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 49,
+      "object_name": "obj_platform",
+      "x": 384,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 50,
+      "object_name": "obj_platform",
+      "x": 416,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 51,
+      "object_name": "obj_platform",
+      "x": 448,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 52,
+      "object_name": "obj_platform",
+      "x": 480,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 53,
+      "object_name": "obj_platform",
+      "x": 512,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 54,
+      "object_name": "obj_platform",
+      "x": 544,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 55,
+      "object_name": "obj_platform",
+      "x": 576,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 56,
+      "object_name": "obj_platform",
+      "x": 608,
+      "y": 448,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 59,
+      "object_name": "obj_platform",
+      "x": 224,
+      "y": 352,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 60,
+      "object_name": "obj_platform",
+      "x": 256,
+      "y": 352,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 62,
+      "object_name": "obj_platform",
+      "x": 192,
+      "y": 352,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 63,
+      "object_name": "obj_platform",
+      "x": 352,
+      "y": 288,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 64,
+      "object_name": "obj_platform",
+      "x": 384,
+      "y": 288,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 65,
+      "object_name": "obj_platform",
+      "x": 416,
+      "y": 288,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 66,
+      "object_name": "obj_platform",
+      "x": 448,
+      "y": 288,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 67,
+      "object_name": "obj_platform",
+      "x": 544,
+      "y": 256,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 68,
+      "object_name": "obj_platform",
+      "x": 576,
+      "y": 256,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    },
+    {
+      "id": 69,
+      "object_name": "obj_platform",
+      "x": 608,
+      "y": 256,
+      "scale_x": 1,
+      "scale_y": 1,
+      "rotation": 0,
+      "creation_code": ""
+    }
+  ],
+  "backgrounds": [],
+  "views": [],
+  "tiles": [],
+  "bg_color": "#10131c",
+  "bg_show_color": true,
+  "physics_world": false,
+  "physics_gravity_x": 0,
+  "physics_gravity_y": 10
+}

package/templates/platformer/sprites/spr_platform/meta.json

@@ -0,0 +1,17 @@
+{
+  "origin_x": 0,
+  "origin_y": 0,
+  "width": 32,
+  "height": 32,
+  "anim_speed": 15,
+  "mask_type": "rectangle",
+  "mask_x": 0,
+  "mask_y": 0,
+  "mask_w": 32,
+  "mask_h": 32,
+  "frames": [
+    {
+      "name": "0.png"
+    }
+  ]
+}

package/templates/platformer/sprites/spr_player/meta.json

@@ -0,0 +1,17 @@
+{
+  "origin_x": 16,
+  "origin_y": 16,
+  "width": 32,
+  "height": 32,
+  "anim_speed": 15,
+  "mask_type": "rectangle",
+  "mask_x": 0,
+  "mask_y": 0,
+  "mask_w": 32,
+  "mask_h": 32,
+  "frames": [
+    {
+      "name": "0.png"
+    }
+  ]
+}

package/templates/topdown/objects/_col.ts

@@ -0,0 +1,2 @@
+export class _col extends gm_object {
+}