@flisk-sh/flisk 0.0.0-stage → 1.3.190

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

@@ -0,0 +1,67 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# ⚡ TILT SDK - VITE LIBRARY GENERATOR
+
+# === INLINED CONSTANTS for pure extension loading ===
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load('../../../../topologies/tilt/manifest/constants.star', 'GENERATED_CONFIG_FILENAMES')
+# =============================================================================
+# Path: .tilt/providers/vite/library.star
+# Purpose: Vite config generator for Library packages
+# =============================================================================
+
+load('./templates.star', 'TEMPLATE_VITE_LIBRARY')
+load('./helpers.star', 'build_header')
+
+# Constants for output paths
+VITE_LIBRARY_CONFIG_PATH = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['vite_library']
+
+def generate_library(manifest, write_fn=None):
+    """
+    Generate vite.config.ts for LIBRARY packages.
+    
+    Library-specific features:
+    1. vite-plugin-dts: Auto-generate .d.ts type definitions (only if in deps)
+    2. External all dependencies (peer deps pattern)
+    3. Both ESM and CJS output formats
+    4. Vitest for testing
+    """
+    resource_path = manifest.get('_resource_path', '')
+    app_name = manifest.get('appName', 'unknown')
+    
+    has_react = manifest.get('hasReact', False)
+    has_dts = manifest.get('hasDts', False)
+    
+    plugin_imports = ''
+    plugins = []
+    
+    if has_dts:
+        plugin_imports = "import dts from 'vite-plugin-dts';"
+        plugins.append('dts({ insertTypesEntry: true, tsconfigPath: resolve(__dirname, \'./tsconfig.autogenerated.json\') })')
+    
+    if has_react:
+        if plugin_imports:
+            plugin_imports += "\nimport react from '@vitejs/plugin-react';"
+        else:
+            plugin_imports = "import react from '@vitejs/plugin-react';"
+        plugins.insert(0, 'react()')
+    
+    plugins_str = ', '.join(plugins)
+    header = build_header('Vite.library()', app_name, 'Library (Build + DTS + Vitest)')
+    lib_name = app_name.replace('-', '_')
+    
+    config = TEMPLATE_VITE_LIBRARY.format(
+        header=header,
+        plugin_imports=plugin_imports,
+        plugins_str=plugins_str,
+        lib_name=lib_name,
+    )
+    
+    if write_fn:
+        write_fn(resource_path + VITE_LIBRARY_CONFIG_PATH, config)
+    
+    return config

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

@@ -0,0 +1,75 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# ⚡ TILT SDK - VITE SDK GENERATOR
+
+# === INLINED CONSTANTS for pure extension loading ===
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load('../../../../topologies/tilt/manifest/constants.star', 'GENERATED_CONFIG_FILENAMES')
+# =============================================================================
+# Path: .tilt/providers/vite/sdk.star
+# Purpose: Vite config generator for SDK packages (Module Federation)
+# =============================================================================
+
+load('./templates.star', 'TEMPLATE_VITE_SDK')
+load('./helpers.star', 'build_header')
+
+# Constants for output paths
+VITE_SDK_CONFIG_PATH = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['vite_sdk']
+
+def generate_sdk(manifest, write_fn=None):
+    """
+    Generate vite.config.ts for SDK packages with Module Federation.
+    
+    SDK features:
+    1. @module-federation/vite for runtime module sharing
+    2. Exposes configured modules
+    3. Shared React/React-DOM as singletons
+    4. Remote entry generation
+    """
+    resource_path = manifest.get('_resource_path', '')
+    app_name = manifest.get('appName', 'unknown')
+    port = manifest.get('port', 3001)
+    
+    federation_name = app_name.replace('-', '_')
+    
+    exposes = manifest.get('federationExposes', {
+        './App': './src/App.tsx',
+        './client': './src/clients/main-client.ts',
+    })
+    
+    exposes_lines = []
+    for key, value in exposes.items():
+        exposes_lines.append("        '" + key + "': '" + value + "',")
+    exposes_str = '\n'.join(exposes_lines)
+    
+    shared_deps = manifest.get('federationShared', [
+        'react',
+        'react-dom',
+        'react-router-dom',
+        '@tanstack/react-query',
+        'zod',
+    ])
+    
+    shared_lines = []
+    for dep in shared_deps:
+        shared_lines.append("        '" + dep + "': { singleton: true },")
+    shared_str = '\n'.join(shared_lines)
+    
+    header = build_header('Vite.sdk()', app_name, 'SDK (Module Federation)')
+    
+    config = TEMPLATE_VITE_SDK.format(
+        header=header,
+        federation_name=federation_name,
+        port=port,
+        exposes_str=exposes_str,
+        shared_str=shared_str,
+    )
+    
+    if write_fn:
+        write_fn(resource_path + VITE_SDK_CONFIG_PATH, config)
+    
+    return config

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

@@ -0,0 +1,460 @@
+# Copyright (c) 2026 Flisk contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# ⚡ TILT SDK - VITE PROVIDER TEMPLATES
+# =============================================================================
+# Path: .tilt/providers/vite/templates.star
+# Purpose: Vite config templates used by generators
+# =============================================================================
+
+# 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()
+
+def _with_npm_scope(template):
+    # Fill in the scope here so callers' .format() calls need no extra argument; '{npm_scope}' is not a .format() field afterwards.
+    return template.replace('{npm_scope}', _NPM_SCOPE)
+
+TEMPLATE_VITE_BACKEND_WITH_NODE = """{header}
+import path from 'node:path';
+import {{ VitePluginNode }} from 'vite-plugin-node';
+import {{ defineConfig }} from 'vitest/config';
+
+export default defineConfig({{
+  plugins: [
+    ...VitePluginNode({{
+      adapter: 'express',
+      appPath: '{entry_point}',
+      exportName: 'app',
+      tsCompiler: 'swc',
+    }}),
+  ],
+  resolve: {{
+    alias: {{
+{path_aliases}
+    }},
+  }},
+  server: {{
+    port: {port},
+  }},
+  build: {{
+    ssr: true,
+    target: 'node20',
+    rollupOptions: {{
+      external: {externals_config},
+    }},
+  }},
+  test: {{
+    coverage: {{
+      all: true,
+      exclude: [
+        'node_modules/**',
+        'dist/**',
+        'docs/**',
+        'src/tests/**',
+        'src/**/*.test.ts',
+        'src/**/*.spec.ts',
+        'src/**/*.d.ts',
+        'src/test-*.ts',
+        'prisma/**',
+        '**/*.config.{{ts,js}}',
+        '**/coverage/**',
+      ],
+      include: ['src/**/*.{{ts,js}}'],
+      provider: 'v8',
+      reporter: ['text', 'json', 'html', 'lcov'],
+      thresholds: {{
+        branches: 70,
+        functions: 70,
+        lines: 70,
+        statements: 70,
+      }},
+    }},
+    deps: {{
+      inline: [{vitest_inline_deps}],
+    }},
+    environment: 'node',
+    exclude: ['node_modules', 'dist', 'docs/node_modules', '**/tests/e2e/**'],
+    globals: true,
+    include: ['src/**/*.{{spec,test}}.{{ts,js}}'],
+  }},
+}});
+"""
+
+TEMPLATE_VITE_BACKEND_VITEST_ONLY = """{header}
+import path from 'node:path';
+import {{ defineConfig }} from 'vitest/config';
+
+export default defineConfig({{
+  resolve: {{
+    alias: {{
+{path_aliases}
+    }},
+  }},
+  test: {{
+    coverage: {{
+      all: true,
+      exclude: [
+        'node_modules/**',
+        'dist/**',
+        'docs/**',
+        'src/tests/**',
+        'src/**/*.test.ts',
+        'src/**/*.spec.ts',
+        'src/**/*.d.ts',
+        'src/test-*.ts',
+        'prisma/**',
+        '**/*.config.{{ts,js}}',
+        '**/coverage/**',
+      ],
+      include: ['src/**/*.{{ts,js}}'],
+      provider: 'v8',
+      reporter: ['text', 'json', 'html', 'lcov'],
+      thresholds: {{
+        branches: 70,
+        functions: 70,
+        lines: 70,
+        statements: 70,
+      }},
+    }},
+    deps: {{
+      inline: [{vitest_inline_deps}],
+    }},
+    environment: 'node',
+    exclude: ['node_modules', 'dist', 'docs/node_modules', '**/tests/e2e/**'],
+    globals: true,
+    include: ['src/**/*.{{spec,test}}.{{ts,js}}'],
+  }},
+}});
+"""
+
+TEMPLATE_VITE_LIBRARY = _with_npm_scope("""{header}
+import {{ resolve }} from 'node:path';
+{plugin_imports}
+import {{ defineConfig }} from 'vitest/config';
+
+export default defineConfig({{
+  mode: 'production',
+  define: {{
+    __DEV__: 'false',
+    'process.env.NODE_ENV': '"production"',
+  }},
+  esbuild: {{
+    jsx: 'automatic',
+    jsxDev: false,
+    jsxImportSource: 'react',
+  }},
+  plugins: [{plugins_str}],
+  build: {{
+    lib: {{
+      entry: resolve(__dirname, '../src/index.ts'),
+      name: '{lib_name}',
+      formats: ['es', 'cjs'],
+      fileName: (format) => `index.${{format === 'es' ? 'mjs' : 'cjs'}}`,
+    }},
+    // Disable code splitting to prevent lazy chunks with CJS require() calls
+    codeSplitting: false,
+    rollupOptions: {{
+      external: [
+        /^node:.*/,
+        /^@{npm_scope}\\/.*$/,
+        'react',
+        'react-dom',
+        'react/jsx-runtime',
+        'react/jsx-dev-runtime',
+        'react-dom/client',
+        'react-is',
+        'zod',
+        'hono',
+        'nats',
+        /^@mantine\\//,
+        /^@tabler\\//,
+        'framer-motion',
+        'lucide-react',
+        'date-fns',
+        'date-fns-tz',
+        'dayjs',
+        'clsx',
+        'class-variance-authority',
+        'tailwind-merge',
+        '@tanstack/react-table',
+        '@tanstack/react-query',
+        '@hookform/resolvers',
+        'react-hook-form',
+        'react-day-picker',
+        'react-resizable-panels',
+        'react-remove-scroll',
+        'react-textarea-autosize',
+        'react-number-format',
+        'embla-carousel-react',
+        'recharts',
+        'sonner',
+        'next-themes',
+        '@glideapps/glide-data-grid',
+      ],
+      output: {{
+        globals: {{
+          react: 'React',
+          'react-dom': 'ReactDOM',
+        }},
+      }},
+    }},
+    sourcemap: true,
+    target: 'esnext',
+  }},
+  resolve: {{
+    alias: {{
+      '@': resolve(__dirname, '../src'),
+      // Force production JSX runtime - alias dev runtime to production runtime
+      'react/jsx-dev-runtime': 'react/jsx-runtime',
+    }},
+  }},
+  test: {{
+    environment: 'node',
+    exclude: ['node_modules', 'dist'],
+    globals: true,
+    include: ['src/**/*.{{test,spec}}.{{ts,tsx}}'],
+  }},
+}});
+""")
+
+TEMPLATE_VITE_SDK = """{header}
+import {{ federation }} from '@module-federation/vite';
+import react from '@vitejs/plugin-react';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  build: {{
+    cssCodeSplit: false,
+    minify: false,
+    modulePreload: false,
+    target: 'esnext',
+  }},
+  plugins: [
+    react(),
+    federation({{
+      name: '{federation_name}',
+      filename: 'remoteEntry.js',
+      exposes: {{
+{exposes_str}
+      }},
+      shared: {{
+{shared_str}
+      }},
+    }}),
+  ],
+  server: {{
+    host: true,
+    port: {port},
+  }},
+}});
+"""
+
+# =============================================================================
+# Environment-Specific Library Templates
+# =============================================================================
+
+TEMPLATE_VITE_LIBRARY_DEV = _with_npm_scope("""{header}
+import {{ resolve }} from 'node:path';
+{plugin_imports}
+import {{ defineConfig }} from 'vitest/config';
+
+export default defineConfig({{
+  mode: 'development',
+  define: {{
+    __DEV__: 'true',
+    'process.env.NODE_ENV': '"development"',
+  }},
+  plugins: [{plugins_str}],
+  build: {{
+    lib: {{
+      entry: resolve(__dirname, '../src/index.ts'),
+      name: '{lib_name}',
+      formats: ['es', 'cjs'],
+      fileName: (format) => `index.${{format === 'es' ? 'mjs' : 'cjs'}}`,
+    }},
+    codeSplitting: false,
+    rollupOptions: {{
+      external: [
+        /^node:.*/,
+        /^@{npm_scope}\\/.*$/,
+        'react',
+        'react-dom',
+        'react/jsx-runtime',
+        'react/jsx-dev-runtime',
+        'react-dom/client',
+        'react-is',
+        'zod',
+        'hono',
+        'nats',
+        /^@mantine\\//,
+        /^@tabler\\//,
+        'framer-motion',
+        'lucide-react',
+        'date-fns',
+        'date-fns-tz',
+        'dayjs',
+        'clsx',
+        'class-variance-authority',
+        'tailwind-merge',
+        '@tanstack/react-table',
+        '@tanstack/react-query',
+        '@hookform/resolvers',
+        'react-hook-form',
+        'react-day-picker',
+        'react-resizable-panels',
+        'react-remove-scroll',
+        'react-textarea-autosize',
+        'react-number-format',
+        'embla-carousel-react',
+        'recharts',
+        'sonner',
+        'next-themes',
+        '@glideapps/glide-data-grid',
+      ],
+      output: {{
+        globals: {{
+          react: 'React',
+          'react-dom': 'ReactDOM',
+        }},
+      }},
+    }},
+    sourcemap: true,
+    target: 'esnext',
+  }},
+  resolve: {{
+    alias: {{
+      '@': resolve(__dirname, '../src'),
+    }},
+  }},
+  test: {{
+    environment: 'node',
+    exclude: ['node_modules', 'dist'],
+    globals: true,
+    include: ['src/**/*.{{test,spec}}.{{ts,tsx}}'],
+  }},
+}});
+""")
+
+TEMPLATE_VITE_LIBRARY_PROD = _with_npm_scope("""{header}
+import {{ resolve }} from 'node:path';
+{plugin_imports}
+import {{ defineConfig }} from 'vitest/config';
+
+export default defineConfig({{
+  mode: 'production',
+  define: {{
+    __DEV__: 'false',
+    'process.env.NODE_ENV': '"production"',
+  }},
+  esbuild: {{
+    jsx: 'automatic',
+    jsxDev: false,
+    jsxImportSource: 'react',
+  }},
+  plugins: [{plugins_str}],
+  build: {{
+    lib: {{
+      entry: resolve(__dirname, '../src/index.ts'),
+      name: '{lib_name}',
+      formats: ['es', 'cjs'],
+      fileName: (format) => `index.${{format === 'es' ? 'mjs' : 'cjs'}}`,
+    }},
+    codeSplitting: false,
+    minify: true,
+    rollupOptions: {{
+      external: [
+        /^node:.*/,
+        /^@{npm_scope}\\/.*$/,
+        'react',
+        'react-dom',
+        'react/jsx-runtime',
+        'react/jsx-dev-runtime',
+        'react-dom/client',
+        'react-is',
+        'zod',
+        'hono',
+        'nats',
+        /^@mantine\\//,
+        /^@tabler\\//,
+        'framer-motion',
+        'lucide-react',
+        'date-fns',
+        'date-fns-tz',
+        'dayjs',
+        'clsx',
+        'class-variance-authority',
+        'tailwind-merge',
+        '@tanstack/react-table',
+        '@tanstack/react-query',
+        '@hookform/resolvers',
+        'react-hook-form',
+        'react-day-picker',
+        'react-resizable-panels',
+        'react-remove-scroll',
+        'react-textarea-autosize',
+        'react-number-format',
+        'embla-carousel-react',
+        'recharts',
+        'sonner',
+        'next-themes',
+        '@glideapps/glide-data-grid',
+      ],
+      output: {{
+        globals: {{
+          react: 'React',
+          'react-dom': 'ReactDOM',
+        }},
+      }},
+    }},
+    sourcemap: true,
+    target: 'esnext',
+  }},
+  resolve: {{
+    alias: {{
+      '@': resolve(__dirname, '../src'),
+      'react/jsx-dev-runtime': 'react/jsx-runtime',
+    }},
+  }},
+  test: {{
+    environment: 'node',
+    exclude: ['node_modules', 'dist'],
+    globals: true,
+    include: ['src/**/*.{{test,spec}}.{{ts,tsx}}'],
+  }},
+}});
+""")
+
+# =============================================================================
+# Template Generation Functions
+# =============================================================================
+
+def get_library_template(environment = 'production'):
+    """
+    Get the appropriate library template based on environment.
+    
+    Args:
+        environment: 'development', 'production', or 'dev'/'prod' shortcuts
+    
+    Returns:
+        Template string for the specified environment
+    """
+    env = environment.lower()
+    if env in ['development', 'dev']:
+        return TEMPLATE_VITE_LIBRARY_DEV
+    elif env in ['production', 'prod']:
+        return TEMPLATE_VITE_LIBRARY_PROD
+    else:
+        # Default to production for safety
+        return TEMPLATE_VITE_LIBRARY_PROD

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

@@ -0,0 +1,24 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+load('./vite/generators.star',
+    'generate_frontend',
+    'generate_backend',
+    'generate_library',
+    'generate_sdk',
+    'generate_for_manifest',
+)
+
+# =============================================================================
+# 📦 VITE STRUCT (Public API)
+# =============================================================================
+
+Vite = struct(
+    # Specific generators
+    frontend = generate_frontend,
+    backend = generate_backend,
+    library = generate_library,
+    sdk = generate_sdk,
+    
+    # Universal dispatcher
+    for_manifest = generate_for_manifest,
+)

package/engine/topologies/tilt/manifest/AGENTS.md

@@ -0,0 +1,61 @@
+# AGENTS.md - Manifest System
+
+## Purpose
+
+General-purpose manifest parsing and loading system. Used across Tilt infrastructure, not just discovery.
+
+## Key Files
+
+### Core
+- **`constants.star`** - `MANIFEST_FILENAME`, validation constants
+- **`loader.star`** - `ManifestLoader` struct with `load_from_file()` method
+- **`parser.star`** - Path parsing, stack extraction from paths
+- **`schema.star`** - JSON schema definitions for manifests
+- **`validator.star`** - Comprehensive manifest validation
+
+### Specialized
+- **`errors.star`** - Manifest error types and formatting
+- **`integration.star`** - Integration with other systems
+- **`mapper.star`** - Manifest-to-resource mapping
+
+## Important Distinction
+
+**This folder** (`tilt/manifest/`) vs **discovery/manifest/**:
+- **This:** General-purpose, reusable across all of Tilt
+- **discovery/manifest/:** Discovery-specific logic (default syncs, normalization)
+
+## Common Usage
+
+### Load a manifest
+```starlark
+load("./loader.star", "ManifestLoader")
+result = ManifestLoader.load_from_file(path)
+if result.error:
+    print(result.error)
+manifest = result.manifest
+```
+
+### Get constants
+```starlark
+load("./constants.star", "MANIFEST_FILENAME")
+# Returns: "service.json"
+```
+
+## Manifest Structure
+
+```json
+{
+  "appName": "resource-name-backend",
+  "appType": "backend",  // frontend, backend, library, migrator, sdk, worker, bring-your-own
+  "stack": "order",
+  "port": 4000,
+  "features": ["nats", "prisma", "vite-node"],
+  "dependsOn": ["identity"]
+}
+```
+
+## Integration Points
+
+- Used by `discovery/` - to find and load resource manifests
+- Used by `generators/` - to read manifest and generate configs
+- Used by `resources/` - to understand resource structure