@wllzhang/afsim-compiler 0.3.0

package/README.md

@@ -0,0 +1,77 @@
+# @wllzhang/afsim-compiler
+
+JSON to AFSIM DSL compiler. Native Rust library with Node.js FFI bindings.
+
+Pass a JavaScript object describing your AFSIM scenario and get back the compiled DSL text — all in memory, no temp files needed.
+
+## Install
+
+```bash
+npm install @wllzhang/afsim-compiler
+```
+
+The correct native binary for your platform is installed automatically via `optionalDependencies`.
+
+## Usage
+
+```javascript
+import { compile } from '@wllzhang/afsim-compiler';
+
+const scenario = {
+  "my_tracker": {
+    "type": "processor",
+    "parent_model": "WSF_PERFECT_TRACKER",
+    "update_interval": "1 s"
+  },
+  "my_fuse": {
+    "type": "processor",
+    "parent_model": "WSF_AIR_TARGET_FUSE"
+  },
+  "my_platform": {
+    "type": "platform_type",
+    "parent_model": "WSF_PLATFORM",
+    "icon": "missile",
+    "processors": ["my_tracker", "my_fuse"]
+  }
+};
+
+const dsl = compile(scenario);
+console.log(dsl);
+```
+
+Output:
+
+```
+platform_type my_platform WSF_PLATFORM
+    icon missile
+    processor my_tracker WSF_PERFECT_TRACKER
+        update_interval 1 s
+    end_processor
+    processor my_fuse WSF_AIR_TARGET_FUSE
+    end_processor
+end_platform_type
+```
+
+## API
+
+### `compile(data)`
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `data` | `object \| string` | Scenario definition as a JS object or JSON string |
+| **Returns** | `string` | Compiled AFSIM DSL text |
+| **Throws** | `Error` | On invalid input or compilation failure |
+
+## Supported Platforms
+
+| OS | Arch | Binary |
+|----|------|--------|
+| Windows | x64 | `afsim_compiler.dll` |
+| Linux | x64 | `libafsim_compiler.so` |
+| Linux | arm64 | `libafsim_compiler.so` |
+| macOS | x64 | `libafsim_compiler.dylib` |
+| macOS | arm64 | `libafsim_compiler.dylib` |
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Compile a JSON object into AFSIM DSL text.
+ *
+ * @param data - The scenario definition as a plain JS object (or a JSON string).
+ * @returns The compiled AFSIM DSL output.
+ * @throws If the input is invalid or compilation fails.
+ */
+export declare function compile(data: Record<string, any> | string): string;

package/index.mjs

@@ -0,0 +1,66 @@
+import koffi from 'koffi';
+import { createRequire } from 'module';
+import path from 'path';
+
+const require = createRequire(import.meta.url);
+
+const PLATFORMS = {
+  'win32-x64':    { pkg: '@wllzhang/afsim-compiler-win32-x64',    file: 'afsim_compiler.dll' },
+  'linux-x64':    { pkg: '@wllzhang/afsim-compiler-linux-x64',    file: 'libafsim_compiler.so' },
+  'linux-arm64':  { pkg: '@wllzhang/afsim-compiler-linux-arm64',  file: 'libafsim_compiler.so' },
+  'darwin-x64':   { pkg: '@wllzhang/afsim-compiler-darwin-x64',   file: 'libafsim_compiler.dylib' },
+  'darwin-arm64': { pkg: '@wllzhang/afsim-compiler-darwin-arm64', file: 'libafsim_compiler.dylib' },
+};
+
+function loadLibrary() {
+  const key = `${process.platform}-${process.arch}`;
+  const entry = PLATFORMS[key];
+  if (!entry) {
+    throw new Error(
+      `@wllzhang/afsim-compiler: unsupported platform ${key}. ` +
+      `Supported: ${Object.keys(PLATFORMS).join(', ')}`
+    );
+  }
+
+  let pkgDir;
+  try {
+    const pkgJson = require.resolve(`${entry.pkg}/package.json`);
+    pkgDir = path.dirname(pkgJson);
+  } catch {
+    throw new Error(
+      `@wllzhang/afsim-compiler: platform package ${entry.pkg} is not installed. ` +
+      `Run: npm install ${entry.pkg}`
+    );
+  }
+
+  return koffi.load(path.join(pkgDir, entry.file));
+}
+
+const lib = loadLibrary();
+const _compile_json = lib.func('compile_json', 'str', ['str']);
+const _free_string  = lib.func('free_string', 'void', ['str']);
+
+/**
+ * Compile a JSON object into AFSIM DSL text.
+ *
+ * @param {Record<string, any>} data - The scenario definition as a plain JS object.
+ * @returns {string} The compiled AFSIM DSL output.
+ * @throws {Error} If the input is invalid or compilation fails.
+ */
+export function compile(data) {
+  if (data === null || data === undefined) {
+    throw new Error('compile: input must be a non-null object');
+  }
+
+  const jsonStr = typeof data === 'string' ? data : JSON.stringify(data);
+  const result = _compile_json(jsonStr);
+
+  if (!result) {
+    throw new Error('compile: received null from native library');
+  }
+  if (result.startsWith('ERROR:')) {
+    throw new Error(result);
+  }
+
+  return result;
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@wllzhang/afsim-compiler",
+  "version": "0.3.0",
+  "description": "JSON to AFSIM DSL compiler — native Rust library with Node.js FFI bindings",
+  "type": "module",
+  "main": "index.mjs",
+  "exports": {
+    ".": {
+      "import": "./index.mjs",
+      "types": "./index.d.ts"
+    }
+  },
+  "types": "index.d.ts",
+  "files": [
+    "index.mjs",
+    "index.d.ts",
+    "README.md"
+  ],
+  "dependencies": {
+    "koffi": "^2"
+  },
+  "optionalDependencies": {
+    "@wllzhang/afsim-compiler-win32-x64": "0.3.0",
+    "@wllzhang/afsim-compiler-linux-x64": "0.3.0",
+    "@wllzhang/afsim-compiler-linux-arm64": "0.3.0",
+    "@wllzhang/afsim-compiler-darwin-x64": "0.3.0",
+    "@wllzhang/afsim-compiler-darwin-arm64": "0.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wllzhang/AFScriptGenerator.git",
+    "directory": "npm"
+  },
+  "homepage": "https://github.com/wllzhang/AFScriptGenerator#readme",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}