xray16 1.0.9 → 1.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xray16",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "author": "Neloreck",
   "repository": "https://github.com/stalker-xrts/xray-16-types",
   "private": false,

package/plugins/inline.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const typescript_1 = require("typescript");
+const typescript_to_lua_1 = require("typescript-to-lua");
+const diagnostics_1 = require("./utils/diagnostics");
+const INLINE_MACROS = "$inline";
+const expectedFunctionExpressionInInline = (0, diagnostics_1.createErrorDiagnosticFactory)("Expected a function expression in '__inline'.");
+/**
+ * Plugin for transformation of casting methods.
+ * Simplifies TS/Lua testing and interoperation.
+ *
+ * Reference: https://gist.github.com/Cheatoid/ea4573c6bd1992fc4940090543ec9380
+ */
+const plugin = {
+    visitors: {
+        [typescript_1.SyntaxKind.ExpressionStatement]: (node, context) => {
+            const result = context.superTransformStatements(node);
+            if ((0, typescript_1.isExpressionStatement)(node)) {
+                const expr = node.expression;
+                if ((0, typescript_1.isCallExpression)(expr) && (0, typescript_1.isIdentifier)(expr.expression)) {
+                    switch (expr.expression.text) {
+                        case INLINE_MACROS: {
+                            if (expr.arguments.length > 0) {
+                                let bodyArg = expr.arguments[0];
+                                if ((0, typescript_1.isIdentifier)(bodyArg)) {
+                                    try {
+                                        bodyArg = context.checker.getSymbolAtLocation(bodyArg).getDeclarations()[0];
+                                    }
+                                    catch (error) {
+                                        context.diagnostics.push(expectedFunctionExpressionInInline(node));
+                                        break;
+                                    }
+                                    if (!bodyArg) {
+                                        context.diagnostics.push(expectedFunctionExpressionInInline(node));
+                                        break;
+                                    }
+                                }
+                                const paramNames = [];
+                                let funcExpr;
+                                if ((0, typescript_1.isFunctionLike)(bodyArg)) {
+                                    const bodyNode = context.transformNode(bodyArg)[0];
+                                    if (!bodyNode) {
+                                        context.diagnostics.push(expectedFunctionExpressionInInline(node));
+                                        break;
+                                    }
+                                    if ((0, typescript_to_lua_1.isVariableDeclarationStatement)(bodyNode) && bodyNode.right) {
+                                        if ((0, typescript_to_lua_1.isFunctionExpression)(bodyNode.right[0])) {
+                                            funcExpr = bodyNode.right[0];
+                                        }
+                                    }
+                                    paramNames.push(...bodyArg.parameters.map((p) => p.name.getText()));
+                                }
+                                for (const stmt of result) {
+                                    if ((0, typescript_to_lua_1.isExpressionStatement)(stmt)) {
+                                        const callExpr = stmt.expression;
+                                        if ((0, typescript_to_lua_1.isCallExpression)(callExpr) &&
+                                            (0, typescript_to_lua_1.isIdentifier)(callExpr.expression) &&
+                                            callExpr.expression.text === expr.expression.text) {
+                                            const paramCount = callExpr.params.length;
+                                            if (paramCount > 0) {
+                                                let body = callExpr.params[0];
+                                                if ((0, typescript_to_lua_1.isIdentifier)(body)) {
+                                                    body = funcExpr;
+                                                }
+                                                if (body && (0, typescript_to_lua_1.isFunctionExpression)(body)) {
+                                                    const statements = body.body.statements;
+                                                    for (let index = 1; index < paramCount; ++index) {
+                                                        // Skip the body parameter.
+                                                        const param = callExpr.params[index];
+                                                        statements.unshift((0, typescript_to_lua_1.createVariableDeclarationStatement)([(0, typescript_to_lua_1.createIdentifier)(paramNames[index - 1])], [param]));
+                                                    }
+                                                    return (0, typescript_to_lua_1.createDoStatement)(statements, node);
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                            context.diagnostics.push(expectedFunctionExpressionInInline(node));
+                            break;
+                        }
+                    }
+                }
+            }
+            return result;
+        },
+    },
+};
+exports.default = plugin;

package/types/index.d.ts

@@ -49,4 +49,6 @@ import "./xr_ui/xr_ui_event";
 import "./xr_ui/xr_ui_interface";
 import "./xr_ui/xr_ui_menu";
 
+import "./xrf_plugin";
+
 declare module "xray16" {}

package/types/xrf_plugin.d.ts

@@ -0,0 +1,44 @@
+declare global {
+  /**
+   * Utility to get current filename, similar to __filename in nodejs.
+   *
+   * @group xrf_plugin
+   */
+  const $filename: string;
+
+  /**
+   * Utility to transform TS provided array to a lua one.
+   * Just wrapper that is stripped compile time, but simplifies unit testing with TS.
+   *
+   * @group xrf_plugin
+   */
+  function $fromArray<T>(array: Array<T>): LuaTable<number, T>;
+
+  /**
+   * Utility to transform LUA array to JS array.
+   * Just wrapper that is stripped compile time, but simplifies unit testing with TS.
+   *
+   * @group xrf_plugin
+   */
+  function $fromLuaArray<T>(array: LuaTable<number, T>): Array<T>;
+
+  /**
+   * Utility to transform TS provided object to a lua table.
+   * Just wrapper that is stripped compile time, but simplifies unit testing with TS.
+   *
+   * @group xrf_plugin
+   */
+  function $fromObject<K extends string | number, T>(object: Record<K, T>): LuaTable<K, T>;
+  function $fromObject<D>(object: D): LuaTable<keyof D, D[keyof D]>;
+
+  /**
+   * Utility to transform LUA provided table to a TS one.
+   * Just wrapper that is stripped compile time, but simplifies unit testing with TS.
+   *
+   * @group xrf_plugin
+   */
+  function $fromLuaTable<K extends string | number, T>(object: LuaTable<K, T>): Record<K, T>;
+  function $fromLuaTable<D>(object: LuaTable<keyof D, D[keyof D]>): D;
+}
+
+export {};