@flisk-sh/flisk 0.0.0-stage → 1.3.190

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

@@ -0,0 +1,92 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# Vanilla TypeScript-specific Vite templates for frontend resources.
+
+VANILLA_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}
+  }},
+}});
+"""
+
+VANILLA_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'],
+  }},
+}});
+"""

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

@@ -0,0 +1,94 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# Vue-specific Vite templates for frontend resources.
+
+VUE_VITE_FRONTEND = """{header}
+import {{ resolve }} from 'node:path';
+import vue from '@vitejs/plugin-vue';
+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: [vue()],
+  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}
+  }},
+}});
+"""
+
+VUE_VITE_FRONTEND_BUILD = """{header}
+import {{ resolve }} from 'node:path';
+import vue from '@vitejs/plugin-vue';
+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: [vue()],
+  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'],
+  }},
+}});
+"""

package/engine/topologies/tilt/generators/vite/frontend.star

@@ -0,0 +1,153 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# ⚡ TILT SDK - VITE FRONTEND GENERATOR
+
+# === INLINED CONSTANTS for pure extension loading ===
+BASE_PORT_FRONTEND = 3000
+BASE_PORT_BACKEND = 4000
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load('../../../../topologies/tilt/manifest/constants.star', 'GENERATED_CONFIG_FILENAMES')
+# =============================================================================
+# Path: .tilt/providers/vite/frontend.star
+# Purpose: Vite config generator for Frontend services
+# =============================================================================
+
+
+load('./frameworks/react.star', 'REACT_VITE_FRONTEND', 'REACT_VITE_FRONTEND_BUILD')
+load('./frameworks/vue.star', 'VUE_VITE_FRONTEND', 'VUE_VITE_FRONTEND_BUILD')
+load('./frameworks/svelte.star', 'SVELTE_VITE_FRONTEND', 'SVELTE_VITE_FRONTEND_BUILD')
+load('./frameworks/preact.star', 'PREACT_VITE_FRONTEND', 'PREACT_VITE_FRONTEND_BUILD')
+load('./frameworks/lit.star', 'LIT_VITE_FRONTEND', 'LIT_VITE_FRONTEND_BUILD')
+load('./frameworks/solid.star', 'SOLID_VITE_FRONTEND', 'SOLID_VITE_FRONTEND_BUILD')
+load('./frameworks/qwik.star', 'QWIK_VITE_FRONTEND', 'QWIK_VITE_FRONTEND_BUILD')
+load('./frameworks/vanilla.star', 'VANILLA_VITE_FRONTEND', 'VANILLA_VITE_FRONTEND_BUILD')
+load('../../../platform/docker/networking/api_path_constants.star', 'get_frontend_base_path')
+load('./helpers.star', 
+    'build_header', 
+    'generate_frontend_internal_aliases', 
+    'generate_frontend_optimize_deps', 
+    'generate_proxy_block'
+)
+
+# Constants for output paths
+VITE_FRONTEND_CONFIG_PATH = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['vite_frontend']
+VITE_FRONTEND_BUILD_CONFIG_PATH = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['vite_build']
+
+_FRAMEWORK_TEMPLATES = {
+    'react': {
+        'dev': REACT_VITE_FRONTEND,
+        'build': REACT_VITE_FRONTEND_BUILD,
+    },
+    'vue': {
+        'dev': VUE_VITE_FRONTEND,
+        'build': VUE_VITE_FRONTEND_BUILD,
+    },
+    'svelte': {
+        'dev': SVELTE_VITE_FRONTEND,
+        'build': SVELTE_VITE_FRONTEND_BUILD,
+    },
+    'preact': {
+        'dev': PREACT_VITE_FRONTEND,
+        'build': PREACT_VITE_FRONTEND_BUILD,
+    },
+    'lit': {
+        'dev': LIT_VITE_FRONTEND,
+        'build': LIT_VITE_FRONTEND_BUILD,
+    },
+    'solid': {
+        'dev': SOLID_VITE_FRONTEND,
+        'build': SOLID_VITE_FRONTEND_BUILD,
+    },
+    'qwik': {
+        'dev': QWIK_VITE_FRONTEND,
+        'build': QWIK_VITE_FRONTEND_BUILD,
+    },
+    'vanilla': {
+        'dev': VANILLA_VITE_FRONTEND,
+        'build': VANILLA_VITE_FRONTEND_BUILD,
+    },
+    # A React SPA with TanStack Router: same plugin, same config, only the app code differs.
+    'tanstack-router': {
+        'dev': REACT_VITE_FRONTEND,
+        'build': REACT_VITE_FRONTEND_BUILD,
+    },
+}
+
+def _normalize_vite_base_path(base_path):
+    """Vite subpath deploys are more reliable with a trailing slash."""
+    if not base_path:
+        return '/'
+    if not base_path.startswith('/'):
+        base_path = '/' + base_path
+    if base_path != '/' and not base_path.endswith('/'):
+        base_path = base_path + '/'
+    return base_path
+
+def generate_frontend(manifest, backend_manifest=None, write_fn=None):
+    """
+    Generate dev and build Vite configs under the resource's .autogenerated/ directory.
+    
+    Features:
+    - Auto-proxy to backend based on backend manifest port
+    - HMR configuration with correct ports
+    - Base path configuration
+    - TypeScript path aliases
+    - 🔥 Auto-generated internal dependency aliases from package.json
+    - 🔥 optimizeDeps.include for faster dev startup
+    """
+    if manifest.get('appType') != 'frontend':
+        fail("Vite.frontend() requires a frontend manifest, got: " + manifest.get('appType', 'unknown'))
+
+    framework_id = manifest.get('framework', 'react')
+    framework_templates = _FRAMEWORK_TEMPLATES.get(framework_id)
+    if framework_templates == None:
+        fail("Unknown frontend framework for Vite generation: " + str(framework_id))
+    
+    resource_path = manifest.get('_resource_path', '')
+    stack = manifest.get('stack', 'app')
+    port = manifest.get('port', BASE_PORT_FRONTEND)
+    hmr_port = port + 1000  # HMR port is always port + 1000
+    base_path = get_frontend_base_path(manifest)
+    vite_base_path = _normalize_vite_base_path(base_path)
+    app_name = manifest.get('appName', 'unknown')
+
+    backend_port = BASE_PORT_BACKEND
+    if backend_manifest:
+        backend_port = backend_manifest.get('port', BASE_PORT_BACKEND)
+
+    # Use traefik pathPrefix for API base path (modern pattern)
+    traefik_config = manifest.get('traefik', {})
+    api_base_path = traefik_config.get('pathPrefix', '/api')
+
+    proxy_config = generate_proxy_block(api_base_path, backend_port, [], stack)
+    header = build_header('Vite.frontend()', app_name)
+    # Config is written under .autogenerated/, so aliases need one extra ".." level.
+    internal_aliases = generate_frontend_internal_aliases(resource_path, manifest, 1)
+    optimize_deps_include = generate_frontend_optimize_deps(manifest)
+    
+    config = framework_templates['dev'].format(
+        header=header,
+        base_path=vite_base_path,
+        port=port,
+        hmr_port=hmr_port,
+        proxy_config=proxy_config,
+        internal_aliases=internal_aliases,
+        optimize_deps_include=optimize_deps_include,
+    )
+
+    build_cfg_header = build_header('Vite.frontend()', app_name, 'Build-only Vite config')
+    build_config = framework_templates['build'].format(
+        header=build_cfg_header,
+        base_path=vite_base_path,
+        optimize_deps_include=optimize_deps_include,
+    )
+    
+    if write_fn:
+        write_fn(resource_path + VITE_FRONTEND_CONFIG_PATH, config)
+        write_fn(resource_path + VITE_FRONTEND_BUILD_CONFIG_PATH, build_config)
+    
+    return config

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

@@ -0,0 +1,45 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# ⚡ TILT SDK - VITE PROVIDER GENERATORS
+# =============================================================================
+# Path: .tilt/providers/vite/generators.star
+# Purpose: Vite config generators dispatcher
+# =============================================================================
+
+load('./frontend.star', _generate_frontend = 'generate_frontend')
+load('./backend.star', _generate_backend = 'generate_backend')
+load('./library.star', _generate_library = 'generate_library')
+load('./sdk.star', _generate_sdk = 'generate_sdk')
+
+generate_frontend = _generate_frontend
+generate_backend = _generate_backend
+generate_library = _generate_library
+generate_sdk = _generate_sdk
+
+def generate_for_manifest(manifest, backend_manifest=None, write_fn=None):
+    """
+    Universal dispatcher that generates the appropriate vite.config.ts
+    based on manifest appType.
+    
+    This is the main entry point that Tilt should call for ALL services.
+    """
+    app_type = manifest.get('appType', 'backend')
+    needs_vite = manifest.get('needsVite', True)
+    
+    if not needs_vite:
+        return None
+    
+    if app_type == 'frontend':
+        return generate_frontend(manifest, backend_manifest, write_fn)
+    elif app_type == 'backend':
+        return generate_backend(manifest, write_fn)
+    elif app_type == 'library':
+        return generate_library(manifest, write_fn)
+    elif app_type == 'sdk':
+        return generate_sdk(manifest, write_fn)
+    elif app_type == 'migrator':
+        return generate_backend(manifest, write_fn)
+    else:
+        print("   ⚠️  Unknown appType '" + app_type + "' for Vite config generation")
+        return None

package/engine/topologies/tilt/generators/vite/helpers.star

@@ -0,0 +1,256 @@
+# Copyright (c) 2026 Flisk contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# ⚡ TILT SDK - VITE PROVIDER HELPERS
+# =============================================================================
+# Path: .tilt/providers/vite/helpers.star
+# Purpose: Shared helper functions for Vite generators
+# =============================================================================
+
+load('../../../../topologies/tilt/common/utils.star', 'Utils')
+
+# Load npm scope from project.json (or use project name as default)
+# Use TDK_PROJECT_ROOT env var set by Tilt, fallback to current directory
+def _load_npm_scope():
+    project_root = os.environ.get('TDK_PROJECT_ROOT', '')
+    project_json_path = '.tdk/project.json'
+    if project_root:
+        project_json_path = project_root + '/' + project_json_path
+    
+    if os.path.exists(project_json_path):
+        _project_json = read_json(project_json_path)
+        return _project_json.get('project', {}).get('name', 'tdk-project')
+    return 'tdk-project'
+
+_NPM_SCOPE = _load_npm_scope()
+# =============================================================================
+# API PATH CONSTANTS - Import for full descriptive API naming
+# =============================================================================
+load('../../../../topologies/platform/docker/networking/api_path_constants.star',
+     'get_api_path_for_stack',
+     'build_traefik_url')
+
+
+def build_header(generator_fn, app_name, extra_header=''):
+    """Build the standard file header using shared utility."""
+    return Utils.get_template_header(
+        'vite',
+        'Vite.' + generator_fn,
+        app_name,
+        extra_header
+    )
+
+
+def generate_frontend_internal_aliases(resource_path, manifest, config_depth_offset=0):
+    """
+    Generate internal package aliases for frontend Vite config.
+    
+    Convention over Configuration:
+        @{npm_scope}/platform-x → {rel_to_root}shared-platform-engineering/platform-x/src
+        @{npm_scope}/product-x  → {rel_to_root}shared-product-engineering/product-x/src
+    """
+    internal_deps = manifest.get('_internalDeps', [])
+
+    if not internal_deps:
+        return '      // No internal dependencies detected'
+
+    # Calculate depth for relative paths (Starlark-compatible)
+    resource_parts = []
+    for p in resource_path.split('/'):
+        if p:
+            resource_parts.append(p)
+    depth = len(resource_parts) + config_depth_offset
+    rel_to_root = '../' * depth
+
+    lines = ['      // 🔥 Auto-generated internal package aliases (from package.json)']
+
+    for dep in sorted(internal_deps):
+        if dep.startswith('@' + _NPM_SCOPE + '/'):
+            lib_name = dep.replace('@' + _NPM_SCOPE + '/', '')
+            
+            # Determine library root by naming convention
+            if lib_name.startswith('platform-'):
+                lib_path = rel_to_root + 'shared-platform-engineering/' + lib_name + '/dist'
+            elif lib_name.startswith('product-'):
+                lib_path = rel_to_root + 'shared-product-engineering/' + lib_name + '/dist'
+            elif lib_name in ['domain', 'application', 'infrastructure', 'presentation']:
+                lib_path = rel_to_root + 'shared-ddd-layers/' + lib_name + '/src'
+            else:
+                lib_path = rel_to_root + 'shared-platform-engineering/' + lib_name + '/src'
+            
+            lines.append("      '" + dep + "': resolve(__dirname, '" + lib_path + "'),")
+    
+    return '\n'.join(lines)
+
+
+def generate_frontend_optimize_deps(manifest):
+    """Generate optimizeDeps.include array for faster Vite dev startup."""
+    internal_deps = manifest.get('_internalDeps', [])
+    
+    if not internal_deps:
+        return ''
+    
+    # Filter optimize deps (Starlark-compatible)
+    optimize_deps = []
+    for dep in internal_deps:
+        if dep.startswith('@' + _NPM_SCOPE + '/'):
+            optimize_deps.append(dep)
+    
+    if not optimize_deps:
+        return ''
+    
+    # Build quoted deps list (Starlark-compatible)
+    quoted_deps = []
+    for dep in sorted(optimize_deps):
+        quoted_deps.append("'" + dep + "'")
+    
+    return '\n      ' + ',\n      '.join(quoted_deps) + ',\n    '
+
+
+def generate_proxy_block(api_base_path, backend_port, additional_routes, stack='app'):
+    """Generate Vite proxy config using full descriptive API paths.
+    
+    Uses API naming convention with full service names from manifest:
+    - Pattern: /api/v1/{app-name}
+    - Generated from manifest "stack" and "appName" fields
+    
+    Args:
+        api_base_path: The base API path (from manifest)
+        backend_port: Backend resource port (kept for compatibility)
+        additional_routes: Additional proxy routes
+        stack: Resource stack name (from manifest.json)
+    
+    Returns:
+        Vite proxy configuration string
+    """
+    # Get full descriptive API path for this stack using constants
+    # This replaces the old pattern: 'http://localhost:' + str(backend_port)
+    api_path = get_api_path_for_stack(stack)
+    
+    # Build Traefik gateway URL using the full API path
+    # Format: http://{project}.localhost/api/v1/{full-service-name}
+    local_target = build_traefik_url(api_path)
+    
+    routes = [
+        (api_base_path, local_target),
+        ('/health', local_target),
+        ('/trpc', local_target),
+    ]
+    
+    for route in additional_routes:
+        if type(route) == 'dict':
+            routes.append((route.get('path', '/'), route.get('target', local_target)))
+        else:
+            routes.append((route, local_target))
+    
+    lines = ['    proxy: {']
+    for path, target in routes:
+        lines.append("      '" + path + "': {")
+        lines.append("        target: '" + target + "',")
+        lines.append("        changeOrigin: true,")
+        lines.append("        secure: false,")
+        lines.append("      },")
+    lines.append('    },')
+    
+    return '\n'.join(lines)
+
+
+def generate_backend_path_aliases(resource_path, manifest):
+    """Generate TypeScript path aliases for DDD architecture (Premium - requires TDK_LICENSE_KEY)."""
+    lines = []
+
+    # DDD is a premium feature: requires both "ddd" in the resource's service.json
+    # features: [] AND a configured license key. The key presence check here is a
+    # cheap belt-and-suspenders guard (mirrors _load_verdaccio in infra-loader.star) -
+    # it can't verify the key actually grants "ddd" (Starlark has no fetch), so a
+    # hand-edited features: ["ddd"] with no key at all is still blocked, but real
+    # entitlement is checked client-side by hasDddLicense() in extension-fetch.ts
+    # before the CLI ever writes "ddd" into a resource's features array.
+    ddd_enabled = 'ddd' in manifest.get('featuresEnabled', []) and os.environ.get('TDK_LICENSE_KEY', '') != ''
+
+    if ddd_enabled:
+        ddd_aliases = [
+            ('@application', './src/application'),
+            ('@domain', './src/domain'),
+            ('@infrastructure', './src/infrastructure'),
+            ('@presentation', './src/presentation'),
+            ('@test', './src/tests'),
+        ]
+
+        for alias, rel_path in ddd_aliases:
+            lines.append("      '" + alias + "': path.resolve(__dirname, '" + rel_path + "'),")
+
+    resource_parts = []
+    for p in resource_path.split('/'):
+        if p:
+            resource_parts.append(p)
+    depth = len(resource_parts)
+    rel_to_root = '../' * depth
+    
+    internal_deps = manifest.get('_internalDeps', [])
+    for dep in sorted(internal_deps):
+        if dep.startswith('@' + _NPM_SCOPE + '/'):
+            lib_name = dep.replace('@' + _NPM_SCOPE + '/', '')
+            
+            if lib_name.startswith('platform-'):
+                lib_path = rel_to_root + 'shared-platform-engineering/' + lib_name + '/dist'
+            elif lib_name.startswith('product-'):
+                lib_path = rel_to_root + 'shared-product-engineering/' + lib_name + '/dist'
+            elif lib_name in ['domain', 'application', 'infrastructure', 'presentation']:
+                lib_path = rel_to_root + 'shared-ddd-layers/' + lib_name + '/src'
+            else:
+                lib_path = rel_to_root + 'shared-platform-engineering/' + lib_name + '/src'
+            
+            lines.append("      '" + dep + "': path.resolve(__dirname, '" + lib_path + "'),")
+    
+    return '\n'.join(lines)
+
+
+def generate_externals_config(manifest):
+    """Generate Rollup externals for Node.js backend build."""
+    externals = [
+        '/^node:.*/',
+        '@prisma/client',
+        'prisma',
+        'hono',
+        'nats',
+    ]
+    
+    if manifest.get('usePrisma'):
+        externals.extend(['.prisma/client', '@prisma/adapter-pg'])
+    
+    if manifest.get('useNats'):
+        externals.append('nats')
+    
+    # Build externals config (Starlark-compatible)
+    externals_quoted = []
+    for e in externals:
+        if not e.startswith('/'):
+            externals_quoted.append("'" + e + "'")
+        else:
+            externals_quoted.append(e)
+    
+    return '[' + ', '.join(externals_quoted) + ']'
+
+
+def generate_vitest_inline_deps(manifest):
+    """Generate Vitest inline deps for internal packages."""
+    internal_deps = manifest.get('_internalDeps', [])
+    
+    # Filter inline deps (Starlark-compatible)
+    inline_deps = []
+    for dep in internal_deps:
+        if dep.startswith('@' + _NPM_SCOPE + '/'):
+            inline_deps.append(dep)
+    
+    if not inline_deps:
+        return ''
+    
+    # Build quoted deps list (Starlark-compatible)
+    quoted_deps = []
+    for dep in inline_deps:
+        quoted_deps.append("'" + dep + "'")
+    
+    return '\n        ' + ',\n        '.join(quoted_deps) + ',\n      '
+
+CONSTANTS = {}