@caleuche/core 0.1.2

package/README.md

@@ -0,0 +1,61 @@
+# Caleuche Library
+
+This package provides core logic for compiling code samples and generating project files for multiple languages. It is designed to be consumed by the CLI or other tools.
+
+## Features
+
+- Compile code samples for C#, Go, Java, Python, and JavaScript.
+- Generate language-specific project files (e.g., `Sample.csproj`, `go.mod`, `pom.xml`, `requirements.txt`, `package.json`).
+- Supports template input validation and dependency injection.
+
+## Installation
+
+Install via npm:
+
+```sh
+npm install caleuche
+```
+
+## Usage
+
+Import the main API in your TypeScript/JavaScript project:
+
+```ts
+import { compileSample, Sample, CompileOptions, CompileOutput } from "caleuche";
+```
+
+### Example
+
+```ts
+const sample: Sample = {
+  template: 'console.log("Hello, <%= name %>!");',
+  type: "javascript",
+  dependencies: [],
+  input: [{ name: "name", type: "string", required: true }],
+};
+
+const options: CompileOptions = { project: true };
+
+const output: CompileOutput = compileSample(sample, { name: "World" }, options);
+// output.items will contain the generated files
+```
+
+## API
+
+### Types
+
+- `Language`: `"csharp" | "java" | "python" | "go" | "javascript"`
+- `Dependency`: `{ name: string; version: string }`
+- `TemplateInput`: Input parameter definition for templates.
+- `Sample`: Describes a code sample, its language, dependencies, and inputs.
+- `CompileOptions`: `{ project: boolean }`
+- `CompileOutput`: `{ items: Array<{ fileName: string; content: string }> }`
+
+### Functions
+
+- `compileSample(sample, input, options): CompileOutput`
+  Compiles a code sample and returns generated files.
+
+## License
+
+MIT

package/dist/index.cjs.js

@@ -0,0 +1,215 @@
+'use strict';
+
+var _ = require('lodash');
+
+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) {
+    if (useEnvironmentVariable && environmentVariable) {
+        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.");
+    }
+}
+
+var csharp = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    usings: usings,
+    valueOrEnvironment: valueOrEnvironment$2
+});
+
+function includes(...items) {
+    let imports = "import (\n";
+    const included = items
+        .filter((i) => typeof i === "string" || i.condition)
+        .map((i) => (typeof i === "string" ? i : i.module));
+    const system = included
+        .filter((i) => !i.startsWith("github.com/") && !i.startsWith("golang.org/"))
+        .sort()
+        .map((i) => `\t"${i}"`)
+        .join("\n");
+    const nonSystem = included
+        .filter((i) => i.startsWith("github.com/") || i.startsWith("golang.org/"))
+        .sort()
+        .map((i) => `\t"${i}"`)
+        .join("\n");
+    imports += [system, nonSystem]
+        .filter((i) => i !== null && i.length > 0)
+        .join("\n\n");
+    imports += "\n)";
+    return imports;
+}
+function valueOrEnvironment$1(useEnvironmentVariable, variableName, environmentVariable, value, indentationLevel = 1) {
+    if (!variableName) {
+        throw new Error("Variable name must be provided.");
+    }
+    const indent = "\t".repeat(indentationLevel);
+    if (useEnvironmentVariable && environmentVariable) {
+        return (`${variableName} := os.Getenv("${environmentVariable}")\n` +
+            `${indent}if len(${variableName}) == 0 {\n` +
+            `${indent}\tfmt.Println("Please set the ${environmentVariable} environment variable.")\n` +
+            `${indent}\tos.Exit(1)\n` +
+            `${indent}}`);
+    }
+    else if (value) {
+        return `const ${variableName} = "${value}"`;
+    }
+    else {
+        throw new Error("No value provided for variable or environment variable.");
+    }
+}
+
+var go = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    includes: includes,
+    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 (`${variableName} = os.environ.get("${environmentVariable}")\n` +
+            `${indent}if not ${variableName}:\n` +
+            `${indent}  raise ValueError("Please set the ${environmentVariable} environment variable.")\n`);
+    }
+    else if (value) {
+        return `${variableName} = "${value}"`;
+    }
+    else {
+        throw new Error("No value provided for variable or environment variable.");
+    }
+}
+
+var python = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    valueOrEnvironment: valueOrEnvironment
+});
+
+var csproj = "<Project Sdk=\"Microsoft.NET.Sdk\">\n\n  <PropertyGroup>\n    <OutputType>Exe</OutputType>\n    <TargetFramework>net9.0</TargetFramework>\n    <ImplicitUsings>enable</ImplicitUsings>\n    <Nullable>enable</Nullable>\n  </PropertyGroup>\n\n  <ItemGroup>\n  <%  _.forEach(dependencies, function(dependency) { %>\n    <PackageReference Include=\"<%= dependency.name %>\" Version=\"<%= dependency.version  %>\" />\n  <% }); %>\n  </ItemGroup>\n\n</Project>\n";
+
+var gomod = "module sample\n\ngo 1.24.3\n\nrequire (\n<% _.forEach(dependencies, function(dependency) { %>\n    <%= dependency.name %> <%= dependency.version %>\n<% }) %>\n)\n";
+
+var packageJson = "{\n  \"name\": \"sample\",\n  \"version\": \"1.0.0\",\n  \"type\": \"module\",\n  \"dependencies\": {\n<% _.forEach(dependencies, function(dependency, i) { %>\n    \"<%= dependency.name %>\": \"<%= dependency.version %>\"<% if (i < dependencies.length - 1) { %>,<% } %>\n<% }); %>\n  }\n}\n";
+
+var pomXml = "<project xmlns=\"http://maven.apache.org/POM/4.0.0\"\n         xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n         xsi:schemaLocation=\"http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd\">\n    <modelVersion>4.0.0</modelVersion>\n    <groupId>sample</groupId>\n    <artifactId>sample</artifactId>\n    <version>1.0-SNAPSHOT</version>\n    <dependencies>\n    <% _.forEach(dependencies, function(dependency) { %>\n        <dependency>\n            <groupId><%= dependency.name.split(\":\")[0] %></groupId>\n            <artifactId><%= dependency.name.split(\":\")[1] %></artifactId>\n            <version><%= dependency.version %></version>\n        </dependency>\n    <% }); %>\n    </dependencies>\n    <build>\n        <plugins>\n            <plugin>\n                <groupId>org.codehaus.mojo</groupId>\n                <artifactId>build-helper-maven-plugin</artifactId>\n                <version>3.6.0</version>\n                <executions>\n                    <execution>\n                        <id>add-source</id>\n                        <phase>generate-sources</phase>\n                        <goals>\n                            <goal>add-source</goal>\n                        </goals>\n                        <configuration>\n                            <sources>\n                                <source>.</source>\n                            </sources>\n                        </configuration>\n                    </execution>\n                </executions>\n            </plugin>\n        </plugins>\n    </build>\n</project>\n";
+
+var requirementsTxt = "<% _.forEach(dependencies, function(dependency) { %>\n<%= dependency.name %>==<%= dependency.version %>\n<% }) %>";
+
+function fillInputObject(sample, inputData) {
+    const inputObject = {};
+    for (const { name, required, default: defaultValue } of sample.input) {
+        if (name in inputData) {
+            /* TODO: Check type */
+            inputObject[name] = inputData[name];
+        }
+        else {
+            if (!required) {
+                inputObject[name] = defaultValue;
+                continue;
+            }
+            throw new Error(`Missing required input: ${name}. Please provide a value for this input.`);
+        }
+    }
+    return inputObject;
+}
+const regex = /[ \t]*(<%(?!=)[^%]+%>)\r?\n/g;
+function preprocessTemplate(template) {
+    return template.replace(regex, "$1");
+}
+function getProjectFileTemplate(sample) {
+    const language = sample.type;
+    switch (language) {
+        case "csharp":
+            return {
+                targetFileName: `Sample.csproj`,
+                template: preprocessTemplate(csproj),
+            };
+        case "go":
+            return {
+                targetFileName: `go.mod`,
+                template: preprocessTemplate(gomod),
+            };
+        case "javascript":
+            return {
+                targetFileName: `package.json`,
+                template: preprocessTemplate(packageJson),
+            };
+        case "java":
+            return {
+                targetFileName: `pom.xml`,
+                template: preprocessTemplate(pomXml),
+            };
+        case "python":
+            return {
+                targetFileName: `requirements.txt`,
+                template: preprocessTemplate(requirementsTxt),
+            };
+        default:
+            throw new Error(`Unsupported language: ${language}. Cannot generate project file.`);
+    }
+}
+function generateProjectFile(sample) {
+    const { targetFileName, template } = getProjectFileTemplate(sample);
+    const compiledTemplate = _.template(template);
+    const instantiatedTemplate = compiledTemplate({
+        dependencies: sample.dependencies,
+    });
+    return {
+        fileName: targetFileName,
+        content: instantiatedTemplate,
+    };
+}
+function getTargetFileName(sample) {
+    const language = sample.type;
+    switch (language) {
+        case "csharp":
+            return "Sample.cs";
+        case "go":
+            return "sample.go";
+        case "javascript":
+            return "sample.js";
+        case "java":
+            return "Sample.java";
+        case "python":
+            return "sample.py";
+        default:
+            throw new Error(`Unsupported language: ${language}. Cannot generate sample file.`);
+    }
+}
+function compileSample(sample, input, options) {
+    const output = { items: [] };
+    if (options.project) {
+        const projectFile = generateProjectFile(sample);
+        output.items.push(projectFile);
+    }
+    const inputObject = fillInputObject(sample, input);
+    const processedTemplate = preprocessTemplate(sample.template);
+    const compiledTemplate = _.template(processedTemplate, {
+        imports: {
+            csharp: csharp,
+            go: go,
+            python: python,
+        },
+    });
+    const targetFileName = getTargetFileName(sample);
+    const outputFileContent = compiledTemplate(inputObject);
+    output.items.push({
+        fileName: targetFileName,
+        content: outputFileContent,
+    });
+    return output;
+}
+
+exports.compileSample = compileSample;
+//# sourceMappingURL=index.cjs.js.map

package/package.json

@@ -0,0 +1,53 @@
+{
+  "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": {}
+}

package/project-templates/Sample.csproj.template

@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net9.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+  <%  _.forEach(dependencies, function(dependency) { %>
+    <PackageReference Include="<%= dependency.name %>" Version="<%= dependency.version  %>" />
+  <% }); %>
+  </ItemGroup>
+
+</Project>

package/project-templates/go.mod.template

@@ -0,0 +1,9 @@
+module sample
+
+go 1.24.3
+
+require (
+<% _.forEach(dependencies, function(dependency) { %>
+    <%= dependency.name %> <%= dependency.version %>
+<% }) %>
+)

package/project-templates/package.json.template

@@ -0,0 +1,10 @@
+{
+  "name": "sample",
+  "version": "1.0.0",
+  "type": "module",
+  "dependencies": {
+<% _.forEach(dependencies, function(dependency, i) { %>
+    "<%= dependency.name %>": "<%= dependency.version %>"<% if (i < dependencies.length - 1) { %>,<% } %>
+<% }); %>
+  }
+}

package/project-templates/pom.xml.template

@@ -0,0 +1,40 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>sample</groupId>
+    <artifactId>sample</artifactId>
+    <version>1.0-SNAPSHOT</version>
+    <dependencies>
+    <% _.forEach(dependencies, function(dependency) { %>
+        <dependency>
+            <groupId><%= dependency.name.split(":")[0] %></groupId>
+            <artifactId><%= dependency.name.split(":")[1] %></artifactId>
+            <version><%= dependency.version %></version>
+        </dependency>
+    <% }); %>
+    </dependencies>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>build-helper-maven-plugin</artifactId>
+                <version>3.6.0</version>
+                <executions>
+                    <execution>
+                        <id>add-source</id>
+                        <phase>generate-sources</phase>
+                        <goals>
+                            <goal>add-source</goal>
+                        </goals>
+                        <configuration>
+                            <sources>
+                                <source>.</source>
+                            </sources>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

package/project-templates/requirements.txt.template

@@ -0,0 +1,3 @@
+<% _.forEach(dependencies, function(dependency) { %>
+<%= dependency.name %>==<%= dependency.version %>
+<% }) %>