@tdk-landscape/tdk-cli-core 1.3.86 → 1.3.88

package/cli/dist/frontend-frameworks/preact.js

@@ -0,0 +1,63 @@
+export const preactFrontendProvider = {
+    id: "preact",
+    label: "Preact + Vite",
+    dependencies: {
+        preact: "^10.26.0",
+    },
+    devDependencies: {
+        "@preact/preset-vite": "^2.10.0",
+    },
+    compilerOptions: {
+        jsx: "react-jsx",
+        jsxImportSource: "preact",
+    },
+    createFiles(name) {
+        return [
+            {
+                filename: "index.html",
+                content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`,
+                description: "Generating HTML template",
+                emoji: "💻",
+            },
+            {
+                filename: "src/main.tsx",
+                content: `import { render } from 'preact';
+import App from './App';
+
+render(<App />, document.getElementById('app')!);
+`,
+                description: "Generating Preact entry",
+                emoji: "💻",
+            },
+            {
+                filename: "src/App.tsx",
+                content: `function App() {
+  return (
+    <div style={{ padding: '2rem', fontFamily: 'system-ui' }}>
+      <h1>${name}</h1>
+      <p>Frontend resource created with TDK</p>
+    </div>
+  );
+}
+
+export default App;
+`,
+                description: "Generating Preact app",
+                emoji: "💻",
+            },
+        ];
+    },
+};
+//# sourceMappingURL=preact.js.map

package/cli/dist/frontend-frameworks/qwik.js

@@ -0,0 +1,62 @@
+export const qwikFrontendProvider = {
+    id: "qwik",
+    label: "Qwik + Vite",
+    dependencies: {
+        "@builder.io/qwik": "^1.12.0",
+    },
+    devDependencies: {},
+    compilerOptions: {
+        jsx: "react-jsx",
+        jsxImportSource: "@builder.io/qwik",
+    },
+    createFiles(name) {
+        return [
+            {
+                filename: "index.html",
+                content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`,
+                description: "Generating HTML template",
+                emoji: "💻",
+            },
+            {
+                filename: "src/main.tsx",
+                content: `import '@builder.io/qwik/qwikloader.js';
+import { render } from '@builder.io/qwik';
+import { App } from './App';
+
+render(document.getElementById('app') as HTMLElement, <App />);
+`,
+                description: "Generating Qwik entry",
+                emoji: "💻",
+            },
+            {
+                filename: "src/App.tsx",
+                content: `import { component$ } from '@builder.io/qwik';
+
+export const App = component$(() => {
+  return (
+    <div style={{ padding: '2rem', fontFamily: 'system-ui' }}>
+      <h1>${name}</h1>
+      <p>Frontend resource created with TDK</p>
+    </div>
+  );
+});
+`,
+                description: "Generating Qwik app",
+                emoji: "💻",
+            },
+        ];
+    },
+};
+//# sourceMappingURL=qwik.js.map

package/cli/dist/frontend-frameworks/registry.js

@@ -1,10 +1,20 @@
 import { TdkError } from "../utils/errors.js";
+import { litFrontendProvider } from "./lit.js";
+import { preactFrontendProvider } from "./preact.js";
+import { qwikFrontendProvider } from "./qwik.js";
 import { reactFrontendProvider } from "./react.js";
+import { solidFrontendProvider } from "./solid.js";
+import { svelteFrontendProvider } from "./svelte.js";
 import { vueFrontendProvider } from "./vue.js";
 export const DEFAULT_FRONTEND_FRAMEWORK = "react";
 export const FRONTEND_FRAMEWORKS = {
     react: reactFrontendProvider,
     vue: vueFrontendProvider,
+    svelte: svelteFrontendProvider,
+    preact: preactFrontendProvider,
+    lit: litFrontendProvider,
+    solid: solidFrontendProvider,
+    qwik: qwikFrontendProvider,
 };
 export function getFrontendFramework(frameworkId) {
     const id = (frameworkId ?? DEFAULT_FRONTEND_FRAMEWORK).trim().toLowerCase();
@@ -17,9 +27,10 @@ export function getFrontendFramework(frameworkId) {
 }
 export function resolveFrontendFramework(resourceType, frameworkId) {
     if (resourceType !== "frontend") {
-        if (frameworkId !== undefined) {
-            throw new TdkError("--framework can only be used with --type frontend.", [
-                "Add --type frontend, or drop --framework for this resource type",
+        // Backends take their own framework ids (see backend-frameworks/registry.ts).
+        if (frameworkId !== undefined && resourceType !== "backend") {
+            throw new TdkError("--framework can only be used with --type frontend or --type backend.", [
+                "Add --type frontend or --type backend, or drop --framework for this resource type",
             ]);
         }
         return undefined;

package/cli/dist/frontend-frameworks/solid.js

@@ -0,0 +1,63 @@
+export const solidFrontendProvider = {
+    id: "solid",
+    label: "Solid + Vite",
+    dependencies: {
+        "solid-js": "^1.9.0",
+    },
+    devDependencies: {
+        "vite-plugin-solid": "^2.11.0",
+    },
+    compilerOptions: {
+        jsx: "preserve",
+        jsxImportSource: "solid-js",
+    },
+    createFiles(name) {
+        return [
+            {
+                filename: "index.html",
+                content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`,
+                description: "Generating HTML template",
+                emoji: "💻",
+            },
+            {
+                filename: "src/main.tsx",
+                content: `import { render } from 'solid-js/web';
+import App from './App';
+
+render(() => <App />, document.getElementById('app')!);
+`,
+                description: "Generating Solid entry",
+                emoji: "💻",
+            },
+            {
+                filename: "src/App.tsx",
+                content: `function App() {
+  return (
+    <div style={{ padding: '2rem', 'font-family': 'system-ui' }}>
+      <h1>${name}</h1>
+      <p>Frontend resource created with TDK</p>
+    </div>
+  );
+}
+
+export default App;
+`,
+                description: "Generating Solid app",
+                emoji: "💻",
+            },
+        ];
+    },
+};
+//# sourceMappingURL=solid.js.map

package/cli/dist/frontend-frameworks/svelte.js

@@ -0,0 +1,68 @@
+export const svelteFrontendProvider = {
+    id: "svelte",
+    label: "Svelte + Vite",
+    dependencies: {
+        svelte: "^5.0.0",
+    },
+    devDependencies: {
+        "@sveltejs/vite-plugin-svelte": "^4.0.4",
+    },
+    compilerOptions: {},
+    createFiles(name) {
+        return [
+            {
+                filename: "index.html",
+                content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
+`,
+                description: "Generating HTML template",
+                emoji: "💻",
+            },
+            {
+                filename: "src/main.ts",
+                content: `import { mount } from 'svelte';
+import App from './App.svelte';
+
+const app = mount(App, { target: document.getElementById('app')! });
+
+export default app;
+`,
+                description: "Generating Svelte entry",
+                emoji: "💻",
+            },
+            {
+                filename: "src/App.svelte",
+                content: `<script lang="ts">
+  const message: string = 'Frontend resource created with TDK';
+</script>
+
+<main style="padding: 2rem; font-family: system-ui">
+  <h1>${name}</h1>
+  <p>{message}</p>
+</main>
+`,
+                description: "Generating Svelte app",
+                emoji: "💻",
+            },
+            {
+                filename: "src/vite-env.d.ts",
+                content: `/// <reference types="svelte" />
+/// <reference types="vite/client" />
+`,
+                description: "Generating Svelte module types",
+                emoji: "⚙️",
+            },
+        ];
+    },
+};
+//# sourceMappingURL=svelte.js.map

package/cli/dist/utils/doctor-wiring.js

@@ -1,6 +1,7 @@
 import { execFileSync, execSync } from "node:child_process";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join, relative } from "node:path";
+import { BACKEND_LANGUAGES } from "../backend-languages/registry.js";
 import { execAsync } from "./exec-async.js";
 import { formatCount } from "./formatting.js";
 import { findProjectRoot } from "./paths.js";
@@ -44,9 +45,16 @@ function backendPorts(resources) {
     }
     return ports;
 }
+/** A backend whose language provider scaffolds its own runtime files (Python) has no package.json. */
+function ownsRuntimeFiles(resource) {
+    const language = resource.config?.language;
+    return (typeof language === "string" &&
+        Object.hasOwn(BACKEND_LANGUAGES, language) &&
+        BACKEND_LANGUAGES[language].createFiles !== undefined);
+}
 export function checkResourcePackageJson(projectRoot = findProjectRoot() ?? process.cwd()) {
     const missing = discoverResourcesFromRoot(projectRoot)
-        .filter((resource) => !existsSync(join(resource.path, "package.json")))
+        .filter((resource) => !ownsRuntimeFiles(resource) && !existsSync(join(resource.path, "package.json")))
         .map((resource) => resource.name);
     if (missing.length === 0) {
         return {

package/cli/dist/utils/service-manifest.js

@@ -20,12 +20,14 @@ const KNOWN_SERVICE_FIELDS = new Set([
     "framework",
     "healthCheckPath",
     "image",
+    "language",
     "name",
     "nats",
     "params",
     "playwright",
     "port",
     "replicas",
+    "restart",
     "runtime",
     "sablier",
     "schemaVersion",

package/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tdk-cli-internal",
   "private": true,
-  "version": "1.3.86",
+  "version": "1.3.88",
   "description": "TDK CLI — start services on your laptop.",
   "keywords": [
     "tdk",
@@ -53,7 +53,7 @@
     "prepack": "../scripts/stage-npm-engine.sh && npm run build"
   },
   "dependencies": {
-    "chalk": "^5.3.0",
+    "chalk": "^6.0.1",
     "commander": "^15.0.0",
     "handlebars": "^4.7.8",
     "ink": "^7.1.1",

package/engine/schemas/service-schema.json

@@ -107,7 +107,7 @@
       "type": "string"
     },
     "appType": {
-      "description": "Resource type determining build strategy:\n• backend - Hono/Express API server\n• frontend - Vite single-page application (React or Vue, see framework)\n• sdk - Shared library package\n• worker - Background job processor\n• migrator - Database migration runner\n• library - Shared code library\n• bring-your-own - Wrap an existing service. No app scaffold. Needs Dockerfile or --image.",
+      "description": "Resource type determining build strategy:\n• backend - Hono/Express API server\n• frontend - Vite single-page application (React, Vue, Svelte, Preact, Lit, Solid or Qwik, see framework)\n• sdk - Shared library package\n• worker - Background job processor\n• migrator - Database migration runner\n• library - Shared code library\n• bring-your-own - Wrap an existing service. No app scaffold. Needs Dockerfile or --image.",
       "enum": [
         "backend",
         "frontend",
@@ -153,6 +153,16 @@
       "description": "Whether this bring-your-own resource receives a Traefik route. Defaults to true.",
       "type": "boolean"
     },
+    "restart": {
+      "description": "Docker Compose restart policy for this bring-your-own resource. Use \"no\" or \"on-failure\" for one-shot jobs such as database migrations, so a finished job is not restarted. Defaults to unless-stopped.",
+      "enum": [
+        "no",
+        "on-failure",
+        "unless-stopped",
+        "always"
+      ],
+      "type": "string"
+    },
     "image": {
       "description": "Docker image name instead of building from Dockerfile. Optional for bring-your-own type.",
       "type": "string"
@@ -215,11 +225,28 @@
       "uniqueItems": true
     },
     "framework": {
-      "description": "Frontend SPA provider used to generate Vite and TypeScript config. Only meaningful for frontend resources; omitted means react (legacy manifests).",
-      "enum": [
+      "description": "Framework provider id. For frontend resources it selects the Vite and TypeScript config (omitted means react, legacy manifests). For backend resources it selects the HTTP framework on the Bun runtime (omitted means hono; not used with a language that owns its runtime, such as python). Valid ids come from the CLI provider registries, which reject unknown ids before writing a resource.",
+      "examples": [
         "react",
-        "vue"
+        "vue",
+        "svelte",
+        "preact",
+        "lit",
+        "solid",
+        "qwik",
+        "hono",
+        "express"
+      ],
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "type": "string"
+    },
+    "language": {
+      "description": "Backend language provider id used to scaffold and run the service. Only meaningful for backend resources; omitted means bun (legacy manifests). Valid ids come from the CLI provider registry.",
+      "examples": [
+        "bun",
+        "python"
       ],
+      "pattern": "^[a-z][a-z0-9-]*$",
       "type": "string"
     },
     "healthCheckPath": {

package/engine/topologies/platform/docker/compose/compose.star

@@ -267,6 +267,13 @@ def _generate_single_backend_entry(resource_path, resource_name, res, manifest,
         is_byo and not manifest.get('exposeViaProxy', True)
     ) if manifest else False
 
+    # One-shot jobs (migrations, seeders) must not be restarted after they exit 0, so a
+    # bring-your-own resource can choose its Compose restart policy. Default is unchanged.
+    restart_policy = 'unless-stopped'
+    if is_byo and manifest.get('restart') in ['no', 'on-failure', 'unless-stopped', 'always']:
+        restart_policy = manifest.get('restart')
+    restart_policy = '"no"' if restart_policy == 'no' else restart_policy
+
     if is_worker or is_proxy_disabled_byo:
         traefik_labels = '      - "traefik.enable=false"'
         healthcheck_section = "" if is_worker or is_byo else """    healthcheck:
@@ -299,7 +306,7 @@ def _generate_single_backend_entry(resource_path, resource_name, res, manifest,
   {resource_entry_name}:
     image: {image_name}
     init: true
-    restart: unless-stopped
+    restart: {restart_policy}
 {build_config}
 {ports_section}
     env_file:
@@ -350,6 +357,7 @@ def _generate_single_backend_entry(resource_path, resource_name, res, manifest,
         stack=stack,
         internal_port=internal_port,
         port_anchor=internal_port,
+        restart_policy=restart_policy,
         dev_port=dev_port,
         db_name=db_name,
         db_url_for_tilt=db_url_for_tilt,

package/engine/topologies/platform/docker/dockerfile/language_dockerfile.star

@@ -0,0 +1,62 @@
+# Dockerfiles for backends whose `language` is not the Bun default.
+#
+# Bun backends use the golden-image generator. Python backends are a small
+# standalone image: language-specific base image and reload command, while the build
+# context (project root), `production` target, health check, and PORT contract stay the
+# same as every other backend.
+
+BASE_PORT_BACKEND = 4000
+
+# Languages whose runtime files are owned by the provider (no Vite/tsconfig/Bun config).
+PROVIDER_OWNED_LANGUAGES = ["python"]
+
+_CURL = """RUN apt-get update && apt-get install -y --no-install-recommends curl \\
+  && rm -rf /var/lib/apt/lists/*
+"""
+
+_HEALTHCHECK = """HEALTHCHECK --interval=10s --timeout=5s --retries=3 \\
+  CMD curl -f http://localhost:${{PORT:-{port}}}/health || exit 1
+"""
+
+_PYTHON = """# Generated by TDK for a Python backend. Do not edit; change service.json instead.
+FROM python:3.12-slim AS base
+
+WORKDIR /app/{res_path}
+
+{curl}
+COPY {res_path}/pyproject.toml ./
+RUN pip install --no-cache-dir .
+
+COPY {res_path}/src ./src
+
+FROM base AS test
+RUN pip install --no-cache-dir ".[dev]"
+COPY {res_path}/tests ./tests
+RUN pytest
+
+FROM base AS production
+
+{healthcheck}
+EXPOSE {port}
+
+CMD ["sh", "-c", "uvicorn main:app --app-dir src --host 0.0.0.0 --port ${{PORT:-{port}}} --reload --reload-dir src"]
+"""
+
+def generate_language_dockerfile(res_path, language, port = BASE_PORT_BACKEND):
+    """Dockerfile text for a provider-owned backend language, or fail for an unknown one."""
+    template = {"python": _PYTHON}.get(language)
+    if template == None:
+        fail("No Dockerfile generator for backend language '{}'".format(language))
+    return template.format(
+        res_path = res_path,
+        port = port,
+        curl = _CURL,
+        healthcheck = _HEALTHCHECK.format(port = port),
+    )
+
+
+def is_provider_owned_language(manifest):
+    """True when the manifest selects Python (a missing language means Bun)."""
+    if not manifest:
+        return False
+    return manifest.get("appType", "backend") == "backend" and manifest.get("language", "bun") in PROVIDER_OWNED_LANGUAGES

package/engine/topologies/platform/docker/index.star

@@ -4,6 +4,11 @@ load(
     "generate_app_dockerfile",
     "generate_migrator_dockerfile",
 )
+load(
+    "./dockerfile/language_dockerfile.star",
+    "generate_language_dockerfile",
+    "is_provider_owned_language",
+)
 load("./config/dockerignore.star", "generate_dockerignore")
 load(
     "./compose/compose.star",
@@ -18,6 +23,8 @@ Docker = struct(
     frontend = generate_frontend_dockerfile,
     backend = generate_app_dockerfile,
     migrator = generate_migrator_dockerfile,
+    backend_language = generate_language_dockerfile,
+    is_provider_owned_language = is_provider_owned_language,
     generate_dockerignore = generate_dockerignore,
     frontend_compose = generate_frontend_compose,
     backend_compose = generate_backend_compose_entry,

package/engine/topologies/tilt/generators/typescript/frontend_tsconfig.star

@@ -77,7 +77,7 @@ def generate_frontend_tsconfig(resource_path, write_fn, internal_deps=None, is_d
                 resource_path
             ))
             print("   Docker build will resolve @{npm_scope}/* from node_modules")
-    if framework not in ['react', 'vue']:
+    if framework not in ['react', 'vue', 'svelte', 'preact', 'lit', 'solid', 'qwik']:
         fail("Unknown frontend framework for TypeScript generation: " + str(framework))
 
     compiler_options = {
@@ -99,6 +99,15 @@ def generate_frontend_tsconfig(resource_path, write_fn, internal_deps=None, is_d
     }
     if framework == 'react':
         compiler_options['jsx'] = 'react-jsx'
+    elif framework == 'preact':
+        compiler_options['jsx'] = 'react-jsx'
+        compiler_options['jsxImportSource'] = 'preact'
+    elif framework == 'qwik':
+        compiler_options['jsx'] = 'react-jsx'
+        compiler_options['jsxImportSource'] = '@builder.io/qwik'
+    elif framework == 'solid':
+        compiler_options['jsx'] = 'preserve'
+        compiler_options['jsxImportSource'] = 'solid-js'
 
     content = {
         "compilerOptions": compiler_options,

package/engine/topologies/tilt/generators/validators.star

@@ -555,9 +555,12 @@ def generate_resource_health_check(resource_name, resource_path, manifest, check
     health_checks = []
     
     # Check 1: Required files exist
-    frontend_entry = "src/main.ts" if manifest.get("framework", "react") == "vue" else "src/main.tsx"
+    frontend_entry = "src/main.ts" if manifest.get("framework", "react") in ["vue", "svelte", "lit"] else "src/main.tsx"
+    backend_files = {
+        "python": ["pyproject.toml", "src/main.py"],
+    }.get(manifest.get("language", "bun"), ["package.json", "prisma/schema.prisma"])
     required_files = {
-        "backend": ["package.json", "prisma/schema.prisma"],
+        "backend": backend_files,
         "frontend": ["package.json", "index.html", frontend_entry],
         "library": ["package.json"],
     }.get(app_type, ["package.json"])
@@ -570,8 +573,9 @@ if [ ! -f "{}" ]; then
 fi
 '''.format(req_file, req_file))
     
-    # Check 2: Package.json is valid JSON
-    health_checks.append('''
+    # Check 2: Package.json is valid JSON (Python backends have no package.json)
+    if manifest.get("language", "bun") != "python":
+        health_checks.append('''
 if ! cat package.json | head -1 > /dev/null 2>&1; then
     echo "❌ package.json is not valid"
     exit 1

package/engine/topologies/tilt/generators/vite/frameworks/lit.star

@@ -0,0 +1,90 @@
+# Lit-specific Vite templates for frontend resources.
+
+LIT_VITE_FRONTEND = """{header}
+import {{ resolve }} from 'node:path';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: false,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [],
+  preview: {{
+    host: '0.0.0.0',
+    port: {port},
+  }},
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+{internal_aliases}
+    }},
+  }},
+  server: {{
+    host: '0.0.0.0',
+    port: {port},
+    hmr: {{
+      port: {hmr_port},
+    }},
+{proxy_config}
+  }},
+}});
+"""
+
+LIT_VITE_FRONTEND_BUILD = """{header}
+import {{ resolve }} from 'node:path';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  mode: 'production',
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: true,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+        manualChunks: undefined,
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+    __DEV__: 'false',
+    'process.env.NODE_ENV': '"production"',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [],
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+    }},
+    conditions: ['browser', 'import', 'module', 'es2020', 'default'],
+    mainFields: ['browser', 'module', 'jsnext:main', 'jsnext', 'main'],
+  }},
+}});
+"""