Code Generation Tool

.eslintrc.json

@@ -6,7 +6,7 @@
         "jest": true
     },
     "parserOptions": {
-        "ecmaVersion": 2018,
+        "ecmaVersion": 2020,
         "sourceType": "module"
     },
     "globals": {

package.json

@@ -28,6 +28,6 @@
         "lint:fix": "npx eslint . --config .eslintrc.json --fix",
         "format": "prettier --write . && npm run format --silent --workspaces --if-present",
         "format:quick": "pretty-quick",
-        "test": "npm test -w packages/core -w packages/assertions -w packages/defaults -w packages/cli"
+        "test": "npm test -w packages/core -w packages/assertions -w packages/defaults -w packages/cli -w packages/code-gen"
     }
 }

packages/code-gen/README.md

@@ -0,0 +1,78 @@
+# @thingweb/code-gen
+
+Generates code snippets for interacting with [Thing Descriptions (TD)](https://www.w3.org/TR/wot-thing-description11/). Supports multiple programming languages and libraries. For unsupported language/library combinations, it generates a prompt for an LLM to complete the task.
+
+## Usage
+
+### As a Library
+
+```js
+import { generateCode, isProtocolSupported } from "@thingweb/code-gen";
+
+const result = generateCode({
+    td,
+    affordanceType: "properties",
+    affordanceKey: "temperature",
+    operation: "readproperty",
+    language: "javascript",
+    library: "fetch",
+});
+
+if ("code" in result) {
+    console.log(result.code);
+} else {
+    console.log(result.prompt); // LLM prompt for unsupported combinations
+}
+```
+
+### CLI
+
+The package provides both interactive and non-interactive CLI modes.
+
+**Interactive mode** — run without arguments to be guided through prompts:
+
+```bash
+npm run cli
+```
+
+**Non-interactive mode** — pass all options as flags. When running the CLI through the npm script, parameters are added after `--`:
+
+```bash
+npm run cli -- --td ./my-thing.td.jsonld --affordance-type properties --affordance-key temperature --operation readproperty --language javascript --library fetch --output ./output
+```
+
+#### CLI Options
+
+| Flag                    | Description                                                |
+| ----------------------- | ---------------------------------------------------------- |
+| `-t, --td`              | Path to the TD JSON file (relative or absolute)            |
+| `-a, --affordance-type` | Affordance type: `properties`, `actions`, or `events`      |
+| `-k, --affordance-key`  | Key name of the affordance                                 |
+| `-o, --operation`       | Operation to perform (e.g. `readproperty`, `invokeaction`) |
+| `-l, --language`        | Programming language                                       |
+| `-b, --library`         | Library to use                                             |
+| `-O, --output`          | Output folder path (relative or absolute, default: `./`)   |
+
+## Supported Languages and Libraries
+
+| Language   | Libraries                                     |
+| ---------- | --------------------------------------------- |
+| JavaScript | fetch, node-wot, webthing, modbus-serial      |
+| Python     | requests, wotpy, PyModbus                     |
+| Java       | httpclient, wot-servient, digitalpetri/modbus |
+| Rust       | reqwest                                       |
+| Go         | net-http                                      |
+| C#         | httpclient, WoT.Net                           |
+| PHP        | curl                                          |
+| Ruby       | net-http                                      |
+| Dart       | dart-wot, http                                |
+
+## Scripts
+
+-   `npm run build` — Compile TypeScript to `dist/`
+-   `npm run cli` — Run the CLI
+-   `npm test` — Run tests
+
+## License
+
+Licensed under the MIT license, see [License](../../LICENSE.md).