@specverse/engines 4.1.5 → 4.1.7

package/dist/libs/instance-factories/scaffolding/templates/generic/readme-generator.js

@@ -0,0 +1,159 @@
+function generateReadme(context) {
+  const { spec, manifest } = context;
+  const sections = [];
+  sections.push(`# ${spec.metadata?.component || "SpecVerse Application"}`);
+  sections.push("");
+  sections.push(spec.metadata?.description || "Generated with SpecVerse");
+  sections.push("");
+  const techStack = inferTechStack(manifest);
+  if (techStack.length > 0) {
+    sections.push("## Tech Stack");
+    sections.push("");
+    for (const tech of techStack) {
+      sections.push(`- **${tech.category}**: ${tech.items.join(", ")}`);
+    }
+    sections.push("");
+  }
+  sections.push("## Getting Started");
+  sections.push("");
+  sections.push("### Prerequisites");
+  sections.push("");
+  sections.push("- Node.js 18+");
+  sections.push("- npm or yarn");
+  if (usesPrisma(manifest)) {
+    sections.push("- PostgreSQL (or your database of choice)");
+  }
+  sections.push("");
+  sections.push("### Installation");
+  sections.push("");
+  sections.push("```bash");
+  sections.push("npm install");
+  sections.push("```");
+  sections.push("");
+  const hasEnvVars = manifestHasEnvVars(manifest);
+  if (hasEnvVars) {
+    sections.push("### Environment Setup");
+    sections.push("");
+    sections.push("```bash");
+    sections.push("cp .env.example .env");
+    sections.push("```");
+    sections.push("");
+    sections.push("Configure your environment variables in `.env`");
+    sections.push("");
+  }
+  if (usesPrisma(manifest)) {
+    sections.push("### Database Setup");
+    sections.push("");
+    sections.push("**Important**: Create the database before running Prisma commands.");
+    sections.push("");
+    sections.push("```bash");
+    sections.push("# Create database (PostgreSQL example)");
+    sections.push("createdb your_database_name");
+    sections.push("");
+    sections.push("# Or using psql:");
+    sections.push("# psql postgres");
+    sections.push("# CREATE DATABASE your_database_name;");
+    sections.push("# \\q");
+    sections.push("");
+    sections.push("# Update DATABASE_URL in .env with your database name");
+    sections.push('# DATABASE_URL="postgresql://localhost:5432/your_database_name"');
+    sections.push("");
+    sections.push("# Generate Prisma client");
+    sections.push("npm run db:generate");
+    sections.push("");
+    sections.push("# Push schema to database (for development)");
+    sections.push("npm run db:push");
+    sections.push("");
+    sections.push("# Or use migrations (for production)");
+    sections.push("npm run db:migrate");
+    sections.push("```");
+    sections.push("");
+  }
+  sections.push("### Development");
+  sections.push("");
+  sections.push("```bash");
+  sections.push("npm run dev");
+  sections.push("```");
+  sections.push("");
+  sections.push("### Production Build");
+  sections.push("");
+  sections.push("```bash");
+  sections.push("npm run build");
+  sections.push("npm start");
+  sections.push("```");
+  sections.push("");
+  if (hasRestAPI(manifest)) {
+    sections.push("## API");
+    sections.push("");
+    sections.push("The API server runs on `http://localhost:${PORT}` (default: 3000)");
+    sections.push("");
+    if (spec.controllers && spec.controllers.length > 0) {
+      sections.push("### Endpoints");
+      sections.push("");
+      for (const controller of spec.controllers) {
+        sections.push(`- **${controller.name}**: \`${controller.basePath || "/api"}\``);
+      }
+      sections.push("");
+    }
+  }
+  sections.push("---");
+  sections.push("");
+  sections.push("_Generated with [SpecVerse](https://github.com/specverse/specverse-lang)_");
+  return sections.join("\n");
+}
+function inferTechStack(manifest) {
+  const stack = [];
+  if (!manifest || !manifest.capabilityMappings) {
+    return stack;
+  }
+  stack.push({
+    category: "Runtime",
+    items: ["Node.js", "TypeScript"]
+  });
+  const apiMapping = manifest.capabilityMappings.find(
+    (m) => m.capability === "api.rest"
+  );
+  if (apiMapping) {
+    stack.push({
+      category: "Web Framework",
+      items: [apiMapping.instanceFactory]
+    });
+  }
+  const ormMapping = manifest.capabilityMappings.find(
+    (m) => m.capability === "orm.client" || m.capability === "orm.schema"
+  );
+  if (ormMapping) {
+    stack.push({
+      category: "ORM",
+      items: [ormMapping.instanceFactory]
+    });
+  }
+  return stack;
+}
+function usesPrisma(manifest) {
+  if (!manifest || !manifest.capabilityMappings) {
+    return false;
+  }
+  return manifest.capabilityMappings.some(
+    (m) => m.instanceFactory?.toLowerCase().includes("prisma")
+  );
+}
+function hasRestAPI(manifest) {
+  if (!manifest || !manifest.capabilityMappings) {
+    return false;
+  }
+  return manifest.capabilityMappings.some(
+    (m) => m.capability === "api.rest"
+  );
+}
+function manifestHasEnvVars(manifest) {
+  if (!manifest || !manifest.capabilityMappings) {
+    return false;
+  }
+  return manifest.capabilityMappings.some(
+    (m) => m.capability === "storage.database" || m.capability === "api.rest"
+  );
+}
+export {
+  generateReadme as default
+};

package/dist/libs/instance-factories/scaffolding/templates/generic/tsconfig-generator.js

@@ -0,0 +1,56 @@
+function generateTsConfig(context) {
+  const { manifest, spec } = context;
+  const mergedOptions = extractTsConfigOptions(context.implementationTypes || []);
+  const hasViews = spec && (spec.views || Array.isArray(spec.views) && spec.views.length > 0);
+  const usesReact = hasViews && (context.implementationTypes || []).some(
+    (implType) => implType.capabilities?.provides?.includes("ui.components") && implType.technology?.framework === "react"
+  );
+  const tsconfig = {
+    compilerOptions: {
+      // Defaults
+      target: "ES2022",
+      module: "ESNext",
+      moduleResolution: "node",
+      lib: ["ES2022"],
+      outDir: "./dist",
+      rootDir: "./src",
+      // Strict mode
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      forceConsistentCasingInFileNames: true,
+      // Module resolution
+      resolveJsonModule: true,
+      allowSyntheticDefaultImports: true,
+      // Output
+      declaration: true,
+      declarationMap: true,
+      sourceMap: true,
+      // Merge options from implementation types
+      ...mergedOptions
+    },
+    include: usesReact ? ["src/**/*.ts"] : ["src/**/*"],
+    // Exclude .tsx files if React is used
+    exclude: usesReact ? ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts", "src/components/**", "src/hooks/**", "src/types/**"] : ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"],
+    ...usesReact && {
+      references: [{ path: "./tsconfig.react.json" }]
+      // Reference React config
+    }
+  };
+  return JSON.stringify(tsconfig, null, 2);
+}
+function extractTsConfigOptions(implementationTypes) {
+  const options = {};
+  if (!implementationTypes || implementationTypes.length === 0) {
+    return options;
+  }
+  for (const implType of implementationTypes) {
+    if (implType.requirements?.configuration?.tsconfig?.compilerOptions) {
+      Object.assign(options, implType.requirements.configuration.tsconfig.compilerOptions);
+    }
+  }
+  return options;
+}
+export {
+  generateTsConfig as default
+};

package/dist/libs/instance-factories/scaffolding/templates/generic/tsconfig-react-generator.js

@@ -0,0 +1,37 @@
+function generateReactTsConfig(context) {
+  const tsconfigReact = {
+    extends: "./tsconfig.json",
+    compilerOptions: {
+      // React/Vite specific settings
+      moduleResolution: "bundler",
+      lib: ["ES2022", "DOM", "DOM.Iterable"],
+      jsx: "react-jsx",
+      jsxImportSource: "react",
+      types: ["vite/client"],
+      // Allow importing .ts/.tsx files with extensions
+      allowImportingTsExtensions: true,
+      // Project reference settings
+      composite: true,
+      outDir: "./dist/react"
+    },
+    include: ["src/**/*.tsx", "src/**/*.ts"],
+    exclude: [
+      "node_modules",
+      "dist",
+      "**/*.test.ts",
+      "**/*.spec.ts",
+      "src/main.ts",
+      // Backend entry point
+      "src/controllers/**",
+      // Backend controllers
+      "src/routes/**",
+      // Backend routes
+      "src/services/**"
+      // Backend services (if any)
+    ]
+  };
+  return JSON.stringify(tsconfigReact, null, 2);
+}
+export {
+  generateReactTsConfig as default
+};

package/dist/libs/instance-factories/sdks/templates/python/sdk-generator.js

@@ -0,0 +1,29 @@
+import { generatePythonSDK } from "../../../../../scripts/generate-sdk-python.js";
+function generateSDK(context) {
+  const { spec, implType, outputDir } = context;
+  if (!spec) {
+    throw new Error("Specification is required in template context");
+  }
+  const config = implType.configuration || {};
+  const options = {
+    packageName: config.packageName || "specverse_client",
+    packageVersion: config.packageVersion || "1.0.0",
+    includeAuth: config.includeAuth !== false,
+    includeRetry: config.includeRetry !== false,
+    includeAsync: config.includeAsync !== false,
+    timeout: config.timeout || 3e4,
+    retries: config.retries || 3
+  };
+  const result = generatePythonSDK(spec, outputDir || "./sdk-python", options);
+  return JSON.stringify({
+    message: "Python SDK generated successfully",
+    packageName: result.packageName,
+    resourceCount: result.resourceCount,
+    endpointCount: result.endpointCount,
+    outputDir: result.outputDir,
+    files: result.files
+  }, null, 2);
+}
+export {
+  generateSDK as default
+};

package/dist/libs/instance-factories/sdks/templates/typescript/sdk-generator.js

@@ -0,0 +1,28 @@
+import { generateTypeScriptSDK } from "../../../../../scripts/generate-sdk-typescript.js";
+function generateSDK(context) {
+  const { spec, implType, outputDir } = context;
+  if (!spec) {
+    throw new Error("Specification is required in template context");
+  }
+  const config = implType.configuration || {};
+  const options = {
+    packageName: config.packageName || "@specverse/sdk",
+    packageVersion: config.packageVersion || "1.0.0",
+    includeAuth: config.includeAuth !== false,
+    includeRetry: config.includeRetry !== false,
+    timeout: config.timeout || 3e4,
+    retries: config.retries || 3
+  };
+  const result = generateTypeScriptSDK(spec, outputDir || "./sdk-typescript", options);
+  return JSON.stringify({
+    message: "TypeScript SDK generated successfully",
+    packageName: result.packageName,
+    resourceCount: result.resourceCount,
+    endpointCount: result.endpointCount,
+    outputDir: result.outputDir,
+    files: result.files
+  }, null, 2);
+}
+export {
+  generateSDK as default
+};

package/dist/libs/instance-factories/services/templates/memory/generate-interpreter.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env npx tsx
+import { generateInterpreterModule } from "./step-conventions-memory.js";
+const args = process.argv.slice(2);
+const outputIdx = args.indexOf("-o");
+const source = generateInterpreterModule();
+if (outputIdx !== -1 && args[outputIdx + 1]) {
+  const { writeFileSync } = await import("fs");
+  const { resolve } = await import("path");
+  const outPath = resolve(args[outputIdx + 1]);
+  writeFileSync(outPath, source, "utf8");
+  console.log(`Generated ${outPath} (${source.split("\n").length} lines)`);
+} else {
+  console.log(source);
+}