@caleuche/core 0.1.2 → 0.3.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Brandon Miller
+Copyright (c) 2025 Gerardo Lecaros
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -40,6 +40,19 @@ const output: CompileOutput = compileSample(sample, { name: "World" }, options);
 // output.items will contain the generated files
 ```
 
+### Template Built-ins
+
+For use in authoring templates. All functions described below are ingested by Caleuche when compiling code files.
+
+#### Universal
+
+- `<language>.valueOrEnvironment(useEnvironmentVariable: boolean, variableName: string, environmentVariable: string, value: string)` Generates code to assign a variable from a specified environment variable `environmentVariable` at runtime or from a provided value `value`.
+
+#### Language Specific
+- `go.includes(...items: string | {module: string; condition?: boolean})` Generates go import statement from list of dependencies. Exclude a dependency by setting condition to false.
+
+- `csharp.usings(...items: string | {namespace: string; condition?: boolean})` Generates C# using statements from a list of namespaces. Exclude a namespace by setting condition to false.
+
 ## API
 
 ### Types

package/dist/index.cjs.js

@@ -2,28 +2,40 @@
 
 var _ = require('lodash');
 
+function formatError(variableName, environmentVariable) {
+    if (variableName.trim() !== "") {
+        return new Error(`No value provided for variable "${variableName}" or environment variable.`);
+    }
+    else if (environmentVariable.trim() !== "") {
+        return new Error(`No value provided for environment variable "${environmentVariable}".`);
+    }
+    else {
+        return new Error("No value provided for variable or environment variable.");
+    }
+}
+
 function usings(...items) {
     return items
         .filter((u) => typeof u === "string" || u.condition)
         .map((u) => `using ${typeof u === "string" ? u : u.namespace};`)
         .join("\n");
 }
-function valueOrEnvironment$2(useEnvironmentVariable, variableName, environmentVariable, value) {
+function valueOrEnvironment$4(useEnvironmentVariable, variableName, environmentVariable, value) {
     if (useEnvironmentVariable && environmentVariable) {
-        return `var ${variableName} = Environment.GetEnvironmentVariable("${environmentVariable}") ?? throw new InvalidOperationException("${environmentVariable} environment variable is not set.")`;
+        return `var ${variableName} = Environment.GetEnvironmentVariable("${environmentVariable}") ?? throw new InvalidOperationException("${environmentVariable} environment variable is not set.");`;
     }
     else if (value) {
         return `const string ${variableName} = "${value}";`;
     }
     else {
-        throw new Error("No value provided for variable or environment variable.");
+        throw formatError(variableName, environmentVariable);
     }
 }
 
 var csharp = /*#__PURE__*/Object.freeze({
     __proto__: null,
     usings: usings,
-    valueOrEnvironment: valueOrEnvironment$2
+    valueOrEnvironment: valueOrEnvironment$4
 });
 
 function includes(...items) {
@@ -47,7 +59,7 @@ function includes(...items) {
     imports += "\n)";
     return imports;
 }
-function valueOrEnvironment$1(useEnvironmentVariable, variableName, environmentVariable, value, indentationLevel = 1) {
+function valueOrEnvironment$3(useEnvironmentVariable, variableName, environmentVariable, value, indentationLevel = 1) {
     if (!variableName) {
         throw new Error("Variable name must be provided.");
     }
@@ -63,17 +75,17 @@ function valueOrEnvironment$1(useEnvironmentVariable, variableName, environmentV
         return `const ${variableName} = "${value}"`;
     }
     else {
-        throw new Error("No value provided for variable or environment variable.");
+        throw formatError(variableName, environmentVariable);
     }
 }
 
 var go = /*#__PURE__*/Object.freeze({
     __proto__: null,
     includes: includes,
-    valueOrEnvironment: valueOrEnvironment$1
+    valueOrEnvironment: valueOrEnvironment$3
 });
 
-function valueOrEnvironment(useEnvironmentVariable, variableName, environmentVariable, value, indentationLevel = 0) {
+function valueOrEnvironment$2(useEnvironmentVariable, variableName, environmentVariable, value, indentationLevel = 0) {
     if (!variableName) {
         throw new Error("Variable name must be provided.");
     }
@@ -87,11 +99,61 @@ function valueOrEnvironment(useEnvironmentVariable, variableName, environmentVar
         return `${variableName} = "${value}"`;
     }
     else {
-        throw new Error("No value provided for variable or environment variable.");
+        throw formatError(variableName, environmentVariable);
     }
 }
 
 var python = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    valueOrEnvironment: valueOrEnvironment$2
+});
+
+function valueOrEnvironment$1(useEnvironmentVariable, variableName, environmentVariable, value, indentationLevel = 1) {
+    if (!variableName) {
+        throw new Error("Variable name must be provided.");
+    }
+    const indent = "    ".repeat(indentationLevel);
+    if (useEnvironmentVariable && environmentVariable) {
+        return (`String ${variableName} = System.getenv("${environmentVariable}");\n` +
+            `${indent}if (${variableName} == null || ${variableName}.isEmpty()) {\n` +
+            `${indent}    System.out.println("Please set the ${environmentVariable} environment variable.");\n` +
+            `${indent}    System.exit(1);\n` +
+            `${indent}}`);
+    }
+    else if (value) {
+        return `String ${variableName} = "${value}";`;
+    }
+    else {
+        throw formatError(variableName, environmentVariable);
+    }
+}
+
+var java = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    valueOrEnvironment: valueOrEnvironment$1
+});
+
+function valueOrEnvironment(useEnvironmentVariable, variableName, environmentVariable, value, indentationLevel = 0) {
+    if (!variableName) {
+        throw new Error("Variable name must be provided.");
+    }
+    const indent = "  ".repeat(indentationLevel);
+    if (useEnvironmentVariable && environmentVariable) {
+        return (`const ${variableName} = process.env["${environmentVariable}"];\n` +
+            `${indent}if (!${variableName}) {\n` +
+            `${indent}  console.error("Please set the ${environmentVariable} environment variable.");\n` +
+            `${indent}  process.exit(1);\n` +
+            `${indent}}`);
+    }
+    else if (value) {
+        return `const ${variableName} = "${value}";`;
+    }
+    else {
+        throw formatError(variableName, environmentVariable);
+    }
+}
+
+var javascript = /*#__PURE__*/Object.freeze({
     __proto__: null,
     valueOrEnvironment: valueOrEnvironment
 });
@@ -200,6 +262,8 @@ function compileSample(sample, input, options) {
             csharp: csharp,
             go: go,
             python: python,
+            java: java,
+            javascript: javascript,
         },
     });
     const targetFileName = getTargetFileName(sample);

package/package.json

@@ -1,53 +1,54 @@
-{
-  "name": "@caleuche/core",
-  "version": "0.1.2",
-  "main": "dist/index.cjs.js",
-  "exports": {
-    ".": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/index.esm.js",
-      "require": "./dist/index.cjs.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "types": "dist/types/index.d.ts",
-  "scripts": {
-    "build": "rollup -c",
-    "build:watch": "rollup -c -w",
-    "build:clean": "rimraf dist && rollup -c",
-    "build:clean:watch": "rimraf dist && rollup -c -w",
-    "clean": "rimraf dist",
-    "format": "prettier --write .",
-    "prepare": "npm run build"
-  },
-  "author": "",
-  "license": "MIT",
-  "description": "",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/brandor64/caleuche"
-  },
-  "dependencies": {
-    "lodash": "^4.17.21",
-    "tslib": "^2.8.1"
-  },
-  "devDependencies": {
-    "@rollup/plugin-commonjs": "^28.0.3",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-typescript": "^12.1.2",
-    "@types/lodash": "^4.17.17",
-    "prettier": "^3.5.3",
-    "rimraf": "^6.0.1",
-    "rollup": "^4.42.0",
-    "typescript": "^5.8.3"
-  },
-  "files": [
-    "./project-templates/Sample.csproj.template",
-    "./project-templates/go.mod.template",
-    "./project-templates/package.json.template",
-    "./project-templates/pom.xml.template",
-    "./project-templates/requirements.txt.template",
-    "./project-templates/Sample.csproj.template"
-  ],
-  "bin": {}
-}
+{
+  "name": "@caleuche/core",
+  "version": "0.3.0",
+  "main": "dist/index.cjs.js",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "dist/types/index.d.ts",
+  "scripts": {
+    "build": "rollup -c",
+    "build:watch": "rollup -c -w",
+    "build:clean": "rimraf dist && rollup -c",
+    "build:clean:watch": "rimraf dist && rollup -c -w",
+    "clean": "rimraf dist",
+    "format": "prettier --write .",
+    "test": "vitest run"
+  },
+  "author": "",
+  "license": "MIT",
+  "description": "",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/brandor64/caleuche"
+  },
+  "dependencies": {
+    "lodash": "^4.17.21",
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/lodash": "^4.17.17",
+    "prettier": "^3.5.3",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.42.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.3"
+  },
+  "files": [
+    "./project-templates/Sample.csproj.template",
+    "./project-templates/go.mod.template",
+    "./project-templates/package.json.template",
+    "./project-templates/pom.xml.template",
+    "./project-templates/requirements.txt.template",
+    "./project-templates/Sample.csproj.template"
+  ],
+  "bin": {}
+}