@silkweaver/build 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @silkweaver/build — the Silkweaver toolchain.
+ *
+ * Turns a project folder into a runnable game:
+ *   - build_preview      → exports/game.js (in-IDE preview)
+ *   - export_html5       → a portable, self-contained HTML5 folder
+ *   - export_executable  → a packaged desktop application
+ *
+ * Also re-exports the class-file object read/write layer (object_format) used by the
+ * IDE's object editor. Pure Node — drives both the IDE (over IPC) and the CLI.
+ */
+export * from './build.js';
+export * from './object_format.js';

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * @silkweaver/build — the Silkweaver toolchain.
+ *
+ * Turns a project folder into a runnable game:
+ *   - build_preview      → exports/game.js (in-IDE preview)
+ *   - export_html5       → a portable, self-contained HTML5 folder
+ *   - export_executable  → a packaged desktop application
+ *
+ * Also re-exports the class-file object read/write layer (object_format) used by the
+ * IDE's object editor. Pure Node — drives both the IDE (over IPC) and the 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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./build.js"), exports);
+__exportStar(require("./object_format.js"), exports);

package/dist/object_format.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Read/write layer for class-per-object files (`objects/<name>.ts`).
+ *
+ * The object editor's GUI is driven by this: `parse_object` extracts an object's
+ * metadata / variables / events from its class, and the `set_*` / `add_*` /
+ * `remove_*` helpers patch the source *surgically* (preserving the user's code and
+ * formatting) when the GUI changes something. Uses the real TypeScript compiler API
+ * for parsing, then string-splices at AST positions so unrelated code is untouched.
+ *
+ * Pure Node (typescript only) — unit-testable and reusable outside the IPC layer.
+ */
+/** Known static-metadata field names an object class may declare. */
+export type meta_field = 'sprite' | 'solid' | 'visible' | 'persistent' | 'depth' | 'parent';
+export interface object_model {
+    class_name: string;
+    sprite: string | null;
+    parent: string | null;
+    solid: boolean;
+    visible: boolean;
+    persistent: boolean;
+    depth: number;
+    variables: {
+        name: string;
+        value: string;
+    }[];
+    events: string[];
+}
+/** Extracts the object model from a class-file source. */
+export declare function parse_object(src: string): object_model;
+/**
+ * Sets (adds or updates) a static metadata field. `expr` is the raw initializer
+ * text (e.g. `'spr_player'`, `true`, `-5`, `obj_base`).
+ */
+export declare function set_static(src: string, name: meta_field, expr: string): string;
+/** Removes a static metadata field if present (e.g. clearing the sprite). */
+export declare function remove_static(src: string, name: meta_field): string;
+/** Sets (adds or updates) an instance variable field. */
+export declare function set_field(src: string, name: string, expr: string): string;
+/** Removes an instance variable field. */
+export declare function remove_field(src: string, name: string): string;
+/** Adds an `on_*` event method stub if it is not already present. */
+export declare function add_method(src: string, method: string, params?: string, body?: string): string;
+/** Removes an event method by name. */
+export declare function remove_method(src: string, method: string): string;
+/** Generates a minimal class-file source for a new object. Imports are auto-managed (none needed). */
+export declare function scaffold_object(class_name: string): string;

package/dist/object_format.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * Read/write layer for class-per-object files (`objects/<name>.ts`).
+ *
+ * The object editor's GUI is driven by this: `parse_object` extracts an object's
+ * metadata / variables / events from its class, and the `set_*` / `add_*` /
+ * `remove_*` helpers patch the source *surgically* (preserving the user's code and
+ * formatting) when the GUI changes something. Uses the real TypeScript compiler API
+ * for parsing, then string-splices at AST positions so unrelated code is untouched.
+ *
+ * Pure Node (typescript only) — unit-testable and reusable outside the IPC layer.
+ */
+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.parse_object = parse_object;
+exports.set_static = set_static;
+exports.remove_static = remove_static;
+exports.set_field = set_field;
+exports.remove_field = remove_field;
+exports.add_method = add_method;
+exports.remove_method = remove_method;
+exports.scaffold_object = scaffold_object;
+const ts = __importStar(require("typescript"));
+// =========================================================================
+// Parsing
+// =========================================================================
+function _source(src) {
+    return ts.createSourceFile('object.ts', src, ts.ScriptTarget.Latest, /*setParentNodes*/ true);
+}
+function _find_class(sf) {
+    return sf.statements.find(ts.isClassDeclaration);
+}
+function _is_static(m) {
+    return !!ts.canHaveModifiers(m) && (ts.getModifiers(m) ?? []).some(mod => mod.kind === ts.SyntaxKind.StaticKeyword);
+}
+function _name_of(m) {
+    return m.name && ts.isIdentifier(m.name) ? m.name.text : null;
+}
+/** Extracts the object model from a class-file source. */
+function parse_object(src) {
+    const sf = _source(src);
+    const cls = _find_class(sf);
+    const model = {
+        class_name: cls?.name?.text ?? '',
+        sprite: null, parent: null,
+        solid: false, visible: true, persistent: false, depth: 0,
+        variables: [], events: [],
+    };
+    if (!cls)
+        return model;
+    for (const m of cls.members) {
+        if (ts.isMethodDeclaration(m)) {
+            const n = _name_of(m);
+            if (n && n.startsWith('on_'))
+                model.events.push(n);
+            continue;
+        }
+        if (ts.isPropertyDeclaration(m)) {
+            const n = _name_of(m);
+            if (!n)
+                continue;
+            const init = m.initializer ? m.initializer.getText(sf) : '';
+            if (_is_static(m)) {
+                switch (n) {
+                    case 'sprite':
+                        model.sprite = _string_literal(m.initializer);
+                        break;
+                    case 'parent':
+                        model.parent = m.initializer ? init : null;
+                        break;
+                    case 'solid':
+                        model.solid = init === 'true';
+                        break;
+                    case 'visible':
+                        model.visible = init !== 'false';
+                        break;
+                    case 'persistent':
+                        model.persistent = init === 'true';
+                        break;
+                    case 'depth':
+                        model.depth = Number(init) || 0;
+                        break;
+                }
+            }
+            else {
+                model.variables.push({ name: n, value: init });
+            }
+        }
+    }
+    return model;
+}
+function _string_literal(node) {
+    if (node && ts.isStringLiteral(node))
+        return node.text;
+    return null;
+}
+function _apply(src, e) {
+    return src.slice(0, e.start) + e.text + src.slice(e.end);
+}
+/** Inserts a member declaration on its own line just before the class's closing brace. */
+function _insert_member(src, text) {
+    const sf = _source(src);
+    const cls = _find_class(sf);
+    if (!cls)
+        return src;
+    const pos = cls.end - 1; // the `}` of the class body
+    const prefix = pos > 0 && src[pos - 1] !== '\n' ? '\n' : ''; // guard against mashing onto the prior line
+    return _apply(src, { start: pos, end: pos, text: prefix + text });
+}
+function _find_member(cls, pred) {
+    return cls.members.find(pred);
+}
+/**
+ * Sets (adds or updates) a static metadata field. `expr` is the raw initializer
+ * text (e.g. `'spr_player'`, `true`, `-5`, `obj_base`).
+ */
+function set_static(src, name, expr) {
+    const sf = _source(src);
+    const cls = _find_class(sf);
+    if (!cls)
+        return src;
+    const existing = _find_member(cls, m => ts.isPropertyDeclaration(m) && _is_static(m) && _name_of(m) === name);
+    if (existing?.initializer) {
+        return _apply(src, { start: existing.initializer.getStart(sf), end: existing.initializer.getEnd(), text: expr });
+    }
+    if (existing) {
+        // declared without initializer — replace the whole member
+        return _apply(src, { start: existing.getStart(sf), end: existing.getEnd(), text: `static ${name} = ${expr}` });
+    }
+    return _insert_member(src, `    static ${name} = ${expr}\n`);
+}
+/** Removes a static metadata field if present (e.g. clearing the sprite). */
+function remove_static(src, name) {
+    return _remove_member(src, m => ts.isPropertyDeclaration(m) && _is_static(m) && _name_of(m) === name);
+}
+/** Sets (adds or updates) an instance variable field. */
+function set_field(src, name, expr) {
+    const sf = _source(src);
+    const cls = _find_class(sf);
+    if (!cls)
+        return src;
+    const existing = _find_member(cls, m => ts.isPropertyDeclaration(m) && !_is_static(m) && _name_of(m) === name);
+    if (existing?.initializer) {
+        return _apply(src, { start: existing.initializer.getStart(sf), end: existing.initializer.getEnd(), text: expr });
+    }
+    if (existing) {
+        return _apply(src, { start: existing.getStart(sf), end: existing.getEnd(), text: `${name} = ${expr}` });
+    }
+    return _insert_member(src, `    ${name} = ${expr}\n`);
+}
+/** Removes an instance variable field. */
+function remove_field(src, name) {
+    return _remove_member(src, m => ts.isPropertyDeclaration(m) && !_is_static(m) && _name_of(m) === name);
+}
+/** Adds an `on_*` event method stub if it is not already present. */
+function add_method(src, method, params = '', body = '') {
+    const sf = _source(src);
+    const cls = _find_class(sf);
+    if (!cls)
+        return src;
+    if (_find_member(cls, m => ts.isMethodDeclaration(m) && _name_of(m) === method))
+        return src;
+    const stub = `    ${method}(${params}): void {\n${body ? '        ' + body + '\n' : ''}    }\n`;
+    return _insert_member(src, stub);
+}
+/** Removes an event method by name. */
+function remove_method(src, method) {
+    return _remove_member(src, m => ts.isMethodDeclaration(m) && _name_of(m) === method);
+}
+function _remove_member(src, pred) {
+    const sf = _source(src);
+    const cls = _find_class(sf);
+    if (!cls)
+        return src;
+    const m = _find_member(cls, pred);
+    if (!m)
+        return src;
+    // Remove the member's own line: back up over its leading indentation (but NOT the
+    // preceding newline — that belongs to the previous member), and consume the trailing newline.
+    let start = m.getStart(sf);
+    while (start > 0 && (src[start - 1] === ' ' || src[start - 1] === '\t'))
+        start--;
+    let end = m.getEnd();
+    while (end < src.length && (src[end] === ' ' || src[end] === '\t'))
+        end++;
+    if (src[end] === '\r')
+        end++;
+    if (src[end] === '\n')
+        end++;
+    return _apply(src, { start, end, text: '' });
+}
+// =========================================================================
+// Scaffolding
+// =========================================================================
+/** Generates a minimal class-file source for a new object. Imports are auto-managed (none needed). */
+function scaffold_object(class_name) {
+    return `export class ${class_name} extends gm_object {
+    on_create(): void {
+
+    }
+}
+`;
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+    "name": "@silkweaver/build",
+    "version": "1.0.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",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/NicoNicoCip/Silkweaver",
+        "directory": "packages/build"
+    },
+    "homepage": "https://github.com/NicoNicoCip/Silkweaver#readme",
+    "publishConfig": {
+        "access": "public"
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "assets"
+    ],
+    "scripts": {
+        "build": "tsc -p ."
+    },
+    "dependencies": {
+        "@silkweaver/engine": "1.0.0",
+        "@silkweaver/project": "1.0.0",
+        "@electron/packager": "^19.0.5",
+        "esbuild": "^0.27.2",
+        "typescript": "^5.9.3"
+    },
+    "peerDependencies": {
+        "electron": "*"
+    },
+    "peerDependenciesMeta": {
+        "electron": {
+            "optional": true
+        }
+    }
+}