helix-lang 11.0.0

package/dist/services/SupabaseDeployer.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupabaseDeployer = void 0;
+const pg_1 = require("pg");
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const chalk_1 = __importDefault(require("chalk"));
+class SupabaseDeployer {
+    /**
+     * Deploys the content of a SQL file to the configured Supabase database.
+     * @param connectionString The Postgres connection string (postgres://user:pass@host:port/db)
+     * @param sqlFilePath Path to the SQL file to execute
+     */
+    static async deploySchema(connectionString, sqlFilePath) {
+        console.log(chalk_1.default.blue(`\n⚡ [Supabase Autopilot] Connecting to database...`));
+        const client = new pg_1.Client({
+            connectionString: connectionString,
+            ssl: { rejectUnauthorized: false }, // Required for Supabase in many envs
+        });
+        try {
+            await client.connect();
+            console.log(chalk_1.default.green(`✔ Connected.`));
+            console.log(chalk_1.default.blue(`Reading schema from: ${sqlFilePath}`));
+            const sqlContent = await fs_extra_1.default.readFile(sqlFilePath, 'utf-8');
+            console.log(chalk_1.default.yellow(`Executing SQL migration...`));
+            await client.query(sqlContent);
+            console.log(chalk_1.default.green(`✔ Schema deployed successfully.`));
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(`\n❌ Deployment Failed:`));
+            if (err.message.includes('password authentication failed')) {
+                console.error(chalk_1.default.red(`   -> Invalid Password in Connection String.`));
+            }
+            else if (err.message.includes('addr not available')) {
+                console.error(chalk_1.default.red(`   -> Host unreachable. Check your internet connection.`));
+            }
+            else {
+                console.error(chalk_1.default.red(`   -> ${err.message}`));
+            }
+            throw err;
+        }
+        finally {
+            await client.end();
+        }
+    }
+}
+exports.SupabaseDeployer = SupabaseDeployer;
+//# sourceMappingURL=SupabaseDeployer.js.map

package/dist/services/SupabaseDeployer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SupabaseDeployer.js","sourceRoot":"","sources":["../../src/services/SupabaseDeployer.ts"],"names":[],"mappings":";;;;;;AAAA,2BAA4B;AAC5B,wDAA0B;AAC1B,kDAA0B;AAE1B,MAAa,gBAAgB;IACzB;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAwB,EAAE,WAAmB;QACnE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC,CAAC;QAE9E,MAAM,MAAM,GAAG,IAAI,WAAM,CAAC;YACtB,gBAAgB,EAAE,gBAAgB;YAClC,GAAG,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,EAAE,qCAAqC;SAC5E,CAAC,CAAC;QAEH,IAAI,CAAC;YACD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;YAEzC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,wBAAwB,WAAW,EAAE,CAAC,CAAC,CAAC;YAC/D,MAAM,UAAU,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAE3D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACxD,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAE/B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;YACnD,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,CAAC;gBACzD,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC,CAAC;YAC7E,CAAC;iBAAM,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACpD,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC,CAAC;YACxF,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,GAAG,CAAC;QACd,CAAC;gBAAS,CAAC;YACP,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC;IACL,CAAC;CACJ;AAvCD,4CAuCC"}

package/dist/test-generator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Helix Auto Test Generator
+ * Generates Vitest test files for spawned API routes and React components
+ */
+import { HelixStrand } from './parser';
+/**
+ * Generate Vitest test file for an API route
+ */
+export declare function generateAPITests(strand: HelixStrand): string;
+/**
+ * Generate React Testing Library test for a component page
+ */
+export declare function generateComponentTests(strand: HelixStrand): string;
+/**
+ * Generate vitest.config.ts for a Next.js project
+ */
+export declare function generateTestConfig(): string;
+//# sourceMappingURL=test-generator.d.ts.map

package/dist/test-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-generator.d.ts","sourceRoot":"","sources":["../src/test-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAc,MAAM,UAAU,CAAC;AAEnD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAgF5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAuClE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAqB3C"}

package/dist/test-generator.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * Helix Auto Test Generator
+ * Generates Vitest test files for spawned API routes and React components
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAPITests = generateAPITests;
+exports.generateComponentTests = generateComponentTests;
+exports.generateTestConfig = generateTestConfig;
+/**
+ * Generate Vitest test file for an API route
+ */
+function generateAPITests(strand) {
+    const name = strand.name;
+    const lower = name.toLowerCase();
+    const requiredFields = strand.fields.filter(f => !f.constraints?.includes('optional'));
+    const sampleData = {};
+    const invalidData = {};
+    for (const field of requiredFields) {
+        sampleData[field.name] = getSampleValue(field);
+        invalidData[field.name] = '';
+    }
+    const sampleJson = JSON.stringify(sampleData, null, 4);
+    return `// Auto-generated by Helix Test Generator
+import { describe, it, expect, beforeAll } from 'vitest';
+
+const BASE_URL = process.env.TEST_URL || 'http://localhost:3000';
+
+describe('${name} API', () => {
+  let createdId: string | null = null;
+
+  it('GET /api/${lower} — should return paginated list', async () => {
+    const res = await fetch(\`\${BASE_URL}/api/${lower}\`);
+    expect(res.status).toBe(200);
+
+    const json = await res.json();
+    // Helix APIs return { data: [...], pagination: {...} }
+    expect(json).toHaveProperty('data');
+    expect(json).toHaveProperty('pagination');
+    expect(Array.isArray(json.data)).toBe(true);
+    expect(json.pagination).toHaveProperty('page');
+    expect(json.pagination).toHaveProperty('total');
+  });
+
+  it('POST /api/${lower} — should create a new ${lower}', async () => {
+    const res = await fetch(\`\${BASE_URL}/api/${lower}\`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(${sampleJson}),
+    });
+    expect(res.status).toBe(201);
+
+    const json = await res.json();
+    expect(json).toHaveProperty('id');
+${requiredFields.map(f => `    expect(json).toHaveProperty('${f.name}');`).join('\n')}
+    createdId = json.id;
+  });
+
+  it('POST /api/${lower} — should reject empty body', async () => {
+    const res = await fetch(\`\${BASE_URL}/api/${lower}\`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({}),
+    });
+    // Should return 400 for missing required fields
+    expect(res.status).toBe(400);
+  });
+
+  it('GET /api/${lower} — should include created item', async () => {
+    const res = await fetch(\`\${BASE_URL}/api/${lower}\`);
+    const json = await res.json();
+    const items = json.data || json;
+
+    if (createdId) {
+      const found = items.find((item: any) => item.id === createdId);
+      expect(found).toBeDefined();
+    }
+  });
+
+  it('GET /api/${lower}?page=1&limit=5 — should respect pagination', async () => {
+    const res = await fetch(\`\${BASE_URL}/api/${lower}?page=1&limit=5\`);
+    expect(res.status).toBe(200);
+
+    const json = await res.json();
+    expect(json.data.length).toBeLessThanOrEqual(5);
+    expect(json.pagination.limit).toBe(5);
+  });
+});
+`;
+}
+/**
+ * Generate React Testing Library test for a component page
+ */
+function generateComponentTests(strand) {
+    const name = strand.name;
+    const lower = name.toLowerCase();
+    return `// Auto-generated by Helix Test Generator
+import { describe, it, expect } from 'vitest';
+import { render, screen } from '@testing-library/react';
+import '@testing-library/jest-dom';
+
+// Note: Import the actual page component when running
+// import ${name}Page from '@/app/${lower}/page';
+
+describe('${name} Page', () => {
+  it('should be importable', () => {
+    // Verify the module exists
+    expect(true).toBe(true);
+  });
+
+  // Uncomment when running with Next.js test setup:
+  /*
+  it('should render the page heading', () => {
+    render(<${name}Page />);
+    expect(screen.getByRole('heading')).toBeInTheDocument();
+  });
+
+  it('should have form elements for ${name} fields', () => {
+    render(<${name}Page />);
+${strand.fields.map(f => `    // Check for ${f.name} field
+    // expect(screen.getByLabelText(/${f.name}/i)).toBeInTheDocument();`).join('\n')}
+  });
+
+  it('should display loading state initially', () => {
+    render(<${name}Page />);
+    // Check for loading indicator
+    expect(screen.getByText(/loading/i)).toBeInTheDocument();
+  });
+  */
+});
+`;
+}
+/**
+ * Generate vitest.config.ts for a Next.js project
+ */
+function generateTestConfig() {
+    return `import { defineConfig } from 'vitest/config';
+import react from '@vitejs/plugin-react';
+import path from 'path';
+
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    environment: 'jsdom',
+    globals: true,
+    setupFiles: [],
+    include: ['__tests__/**/*.{test,spec}.{ts,tsx}'],
+    exclude: ['node_modules', '.next'],
+  },
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
+    },
+  },
+});
+`;
+}
+/**
+ * Get a sample value for a field type (for test data)
+ */
+function getSampleValue(field) {
+    switch (field.type) {
+        case 'String':
+            return `Test ${field.name}`;
+        case 'Int':
+            return '42';
+        case 'Float':
+        case 'Decimal':
+            return '3.14';
+        case 'Boolean':
+            return 'true';
+        case 'DateTime':
+            return new Date().toISOString();
+        case 'Json':
+            return '{}';
+        default:
+            return `test-${field.name}`;
+    }
+}
+//# sourceMappingURL=test-generator.js.map

package/dist/test-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-generator.js","sourceRoot":"","sources":["../src/test-generator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAOH,4CAgFC;AAKD,wDAuCC;AAKD,gDAqBC;AAzJD;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAAmB;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACvF,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/C,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEvD,OAAO;;;;;YAKG,IAAI;;;iBAGC,KAAK;iDAC2B,KAAK;;;;;;;;;;;;kBAYpC,KAAK,0BAA0B,KAAK;iDACL,KAAK;;;6BAGzB,UAAU;;;;;;EAMrC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,oCAAoC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;kBAInE,KAAK;iDAC0B,KAAK;;;;;;;;;iBASrC,KAAK;iDAC2B,KAAK;;;;;;;;;;iBAUrC,KAAK;iDAC2B,KAAK;;;;;;;;CAQrD,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,MAAmB;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAEjC,OAAO;;;;;;YAMG,IAAI,oBAAoB,KAAK;;YAE7B,IAAI;;;;;;;;;cASF,IAAI;;;;sCAIoB,IAAI;cAC5B,IAAI;EAChB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,IAAI;uCACZ,CAAC,CAAC,IAAI,2BAA2B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;cAItE,IAAI;;;;;;CAMjB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;CAmBR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,KAAiB;IACvC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QAC9B,KAAK,KAAK;YACR,OAAO,IAAI,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAClC,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd;YACE,OAAO,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/themes/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Helix Theme Engine - Data-driven theme definitions
+ * V2.0 - Replaces hardcoded Deep Void CSS with selectable themes
+ */
+export interface HelixTheme {
+    name: string;
+    description: string;
+    css: {
+        themeVars: string;
+        body: string;
+        glass: string;
+        inputs: string;
+        inputFocus: string;
+        inputPlaceholder: string;
+    };
+    /** Tailwind class hints for generated UI components */
+    componentClasses: {
+        primaryButton: string;
+        secondaryButton: string;
+        card: string;
+        text: string;
+        textMuted: string;
+        heading: string;
+        badge: string;
+        statusColors: {
+            success: string;
+            warning: string;
+            info: string;
+        };
+    };
+}
+export declare const THEMES: Record<string, HelixTheme>;
+/**
+ * Resolve a theme name from a .helix AST view property.
+ * Handles case-insensitive matching and common aliases.
+ */
+export declare function resolveTheme(themeName?: string): HelixTheme;
+/**
+ * Generate the full globals.css content for a given theme.
+ */
+export declare function generateThemeCSS(theme: HelixTheme): string;
+/**
+ * Get complete CSS variables string for a theme by name.
+ * Resolves aliases (e.g. "dark" -> glassmorphism, "pro" -> professional).
+ */
+export declare function getThemeCSS(themeName?: string): string;
+/**
+ * Get Tailwind class mappings for UI components by theme name.
+ * Returns classes for cards, buttons, inputs, text, and backgrounds.
+ */
+export declare function getThemeClasses(themeName?: string): HelixTheme['componentClasses'];
+//# sourceMappingURL=index.d.ts.map

package/dist/themes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/themes/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE;QACH,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,uDAAuD;IACvD,gBAAgB,EAAE;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAClE,CAAC;CACH;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAoM7C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CA4B3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAgB1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAGlF"}

package/dist/themes/index.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * Helix Theme Engine - Data-driven theme definitions
+ * V2.0 - Replaces hardcoded Deep Void CSS with selectable themes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THEMES = void 0;
+exports.resolveTheme = resolveTheme;
+exports.generateThemeCSS = generateThemeCSS;
+exports.getThemeCSS = getThemeCSS;
+exports.getThemeClasses = getThemeClasses;
+exports.THEMES = {
+    glassmorphism: {
+        name: 'Glassmorphism',
+        description: 'Dark gradient, gold accent — the Deep Void default',
+        css: {
+            themeVars: `@theme {
+  --color-deep-void: #0f0f1a;
+  --color-helix-gold: #FFD700;
+}`,
+            body: `body {
+  background: linear-gradient(135deg, #0f0f1a 0%, #1a0a2e 50%, #0d1117 100%);
+  color: white;
+  min-height: 100vh;
+  font-family: system-ui, -apple-system, sans-serif;
+}`,
+            glass: `.glass {
+  background: rgba(255, 255, 255, 0.05);
+  backdrop-filter: blur(10px);
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 0.75rem;
+}`,
+            inputs: `input, select, textarea {
+  background: rgba(255, 255, 255, 0.05) !important;
+  border: 1px solid rgba(255, 255, 255, 0.1) !important;
+  color: white !important;
+  border-radius: 0.375rem;
+  padding: 0.75rem;
+}`,
+            inputFocus: `input:focus, select:focus, textarea:focus {
+  outline: none !important;
+  border-color: #f59e0b !important;
+  box-shadow: 0 0 0 1px #f59e0b !important;
+}`,
+            inputPlaceholder: `input::placeholder, textarea::placeholder {
+  color: rgba(255, 255, 255, 0.5);
+}`,
+        },
+        componentClasses: {
+            primaryButton: 'bg-indigo-600 hover:bg-indigo-500 text-white',
+            secondaryButton: 'bg-white/5 hover:bg-white/10 border border-white/10 text-gray-300',
+            card: 'glass',
+            text: 'text-white',
+            textMuted: 'text-gray-400',
+            heading: 'text-white',
+            badge: 'bg-amber-500/20 text-amber-300 border border-amber-500/30',
+            statusColors: { success: '#10b981', warning: '#f59e0b', info: '#6366f1' },
+        },
+    },
+    professional: {
+        name: 'Professional',
+        description: 'Clean white, indigo accent — SaaS / business apps',
+        css: {
+            themeVars: `@theme {
+  --color-primary: #4f46e5;
+  --color-primary-light: #6366f1;
+  --color-surface: #ffffff;
+  --color-surface-alt: #f8fafc;
+}`,
+            body: `body {
+  background: #f8fafc;
+  color: #1e293b;
+  min-height: 100vh;
+  font-family: system-ui, -apple-system, sans-serif;
+}`,
+            glass: `.glass {
+  background: #ffffff;
+  border: 1px solid #e2e8f0;
+  border-radius: 0.75rem;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.05);
+}`,
+            inputs: `input, select, textarea {
+  background: #ffffff !important;
+  border: 1px solid #d1d5db !important;
+  color: #1e293b !important;
+  border-radius: 0.375rem;
+  padding: 0.75rem;
+}`,
+            inputFocus: `input:focus, select:focus, textarea:focus {
+  outline: none !important;
+  border-color: #4f46e5 !important;
+  box-shadow: 0 0 0 2px rgba(79, 70, 229, 0.2) !important;
+}`,
+            inputPlaceholder: `input::placeholder, textarea::placeholder {
+  color: #9ca3af;
+}`,
+        },
+        componentClasses: {
+            primaryButton: 'bg-indigo-600 hover:bg-indigo-700 text-white',
+            secondaryButton: 'bg-white hover:bg-gray-50 border border-gray-300 text-gray-700',
+            card: 'glass',
+            text: 'text-slate-800',
+            textMuted: 'text-slate-500',
+            heading: 'text-slate-900',
+            badge: 'bg-indigo-50 text-indigo-700 border border-indigo-200',
+            statusColors: { success: '#059669', warning: '#d97706', info: '#4f46e5' },
+        },
+    },
+    minimal: {
+        name: 'Minimal',
+        description: 'Pure white, black accent — productivity / tools',
+        css: {
+            themeVars: `@theme {
+  --color-primary: #000000;
+  --color-surface: #ffffff;
+  --color-border: #e5e5e5;
+}`,
+            body: `body {
+  background: #ffffff;
+  color: #171717;
+  min-height: 100vh;
+  font-family: system-ui, -apple-system, sans-serif;
+}`,
+            glass: `.glass {
+  background: #ffffff;
+  border: 1px solid #e5e5e5;
+  border-radius: 0.5rem;
+}`,
+            inputs: `input, select, textarea {
+  background: #fafafa !important;
+  border: 1px solid #e5e5e5 !important;
+  color: #171717 !important;
+  border-radius: 0.375rem;
+  padding: 0.75rem;
+}`,
+            inputFocus: `input:focus, select:focus, textarea:focus {
+  outline: none !important;
+  border-color: #000000 !important;
+  box-shadow: 0 0 0 1px #000000 !important;
+}`,
+            inputPlaceholder: `input::placeholder, textarea::placeholder {
+  color: #a3a3a3;
+}`,
+        },
+        componentClasses: {
+            primaryButton: 'bg-black hover:bg-neutral-800 text-white',
+            secondaryButton: 'bg-white hover:bg-neutral-50 border border-neutral-300 text-neutral-700',
+            card: 'glass',
+            text: 'text-neutral-900',
+            textMuted: 'text-neutral-500',
+            heading: 'text-black',
+            badge: 'bg-neutral-100 text-neutral-700 border border-neutral-200',
+            statusColors: { success: '#16a34a', warning: '#ca8a04', info: '#171717' },
+        },
+    },
+    vibrant: {
+        name: 'Vibrant',
+        description: 'Gradient UI, pink accent — social / consumer apps',
+        css: {
+            themeVars: `@theme {
+  --color-primary: #ec4899;
+  --color-primary-light: #f472b6;
+  --color-accent: #8b5cf6;
+}`,
+            body: `body {
+  background: linear-gradient(135deg, #fdf2f8 0%, #ede9fe 50%, #f0f9ff 100%);
+  color: #1e1b4b;
+  min-height: 100vh;
+  font-family: system-ui, -apple-system, sans-serif;
+}`,
+            glass: `.glass {
+  background: rgba(255, 255, 255, 0.7);
+  backdrop-filter: blur(12px);
+  border: 1px solid rgba(236, 72, 153, 0.15);
+  border-radius: 1rem;
+  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.04);
+}`,
+            inputs: `input, select, textarea {
+  background: rgba(255, 255, 255, 0.8) !important;
+  border: 1px solid rgba(236, 72, 153, 0.2) !important;
+  color: #1e1b4b !important;
+  border-radius: 0.5rem;
+  padding: 0.75rem;
+}`,
+            inputFocus: `input:focus, select:focus, textarea:focus {
+  outline: none !important;
+  border-color: #ec4899 !important;
+  box-shadow: 0 0 0 2px rgba(236, 72, 153, 0.2) !important;
+}`,
+            inputPlaceholder: `input::placeholder, textarea::placeholder {
+  color: #a78bfa;
+}`,
+        },
+        componentClasses: {
+            primaryButton: 'bg-gradient-to-r from-pink-500 to-violet-500 hover:from-pink-600 hover:to-violet-600 text-white',
+            secondaryButton: 'bg-white/70 hover:bg-white border border-pink-200 text-pink-700',
+            card: 'glass',
+            text: 'text-indigo-950',
+            textMuted: 'text-indigo-400',
+            heading: 'text-indigo-900',
+            badge: 'bg-pink-100 text-pink-700 border border-pink-200',
+            statusColors: { success: '#10b981', warning: '#f59e0b', info: '#8b5cf6' },
+        },
+    },
+};
+/**
+ * Resolve a theme name from a .helix AST view property.
+ * Handles case-insensitive matching and common aliases.
+ */
+function resolveTheme(themeName) {
+    if (!themeName)
+        return exports.THEMES.glassmorphism;
+    const normalized = themeName.toLowerCase().replace(/[\s-_]/g, '');
+    const aliases = {
+        'glassmorphism': 'glassmorphism',
+        'glass': 'glassmorphism',
+        'deepvoid': 'glassmorphism',
+        'dark': 'glassmorphism',
+        'professional': 'professional',
+        'pro': 'professional',
+        'saas': 'professional',
+        'business': 'professional',
+        'clean': 'professional',
+        'minimal': 'minimal',
+        'minimalist': 'minimal',
+        'simple': 'minimal',
+        'productivity': 'minimal',
+        'vibrant': 'vibrant',
+        'colorful': 'vibrant',
+        'social': 'vibrant',
+        'gradient': 'vibrant',
+        'fun': 'vibrant',
+    };
+    const resolved = aliases[normalized];
+    return resolved ? exports.THEMES[resolved] : exports.THEMES.glassmorphism;
+}
+/**
+ * Generate the full globals.css content for a given theme.
+ */
+function generateThemeCSS(theme) {
+    return `@import "tailwindcss";
+@source "../**/*.tsx";
+
+${theme.css.themeVars}
+
+${theme.css.body}
+
+${theme.css.glass}
+
+${theme.css.inputs}
+
+${theme.css.inputFocus}
+
+${theme.css.inputPlaceholder}
+`;
+}
+/**
+ * Get complete CSS variables string for a theme by name.
+ * Resolves aliases (e.g. "dark" -> glassmorphism, "pro" -> professional).
+ */
+function getThemeCSS(themeName) {
+    const theme = resolveTheme(themeName);
+    return generateThemeCSS(theme);
+}
+/**
+ * Get Tailwind class mappings for UI components by theme name.
+ * Returns classes for cards, buttons, inputs, text, and backgrounds.
+ */
+function getThemeClasses(themeName) {
+    const theme = resolveTheme(themeName);
+    return theme.componentClasses;
+}
+//# sourceMappingURL=index.js.map

package/dist/themes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/themes/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Helix Language - Type Definitions and System Prompts
+ * v11.0 - With Deep Research Capabilities
+ */
+export declare const HELIX_SYNTAX_GUIDE = "\nHELIX SYNTAX RULES:\n1. 'strand Name {}' defines a stateful entity.\n2. 'field name: Type' defines data structure. Types: String, Int, Float, Boolean, DateTime.\n3. 'relation name: OtherStrand' defines a belongs-to relationship (foreign key).\n4. 'relation name: OtherStrand[]' defines a has-many relationship.\n5. 'strategy Name: Action -> Fallback' defines error handling.\n6. 'view Name {}' defines UI layout.\n7. 'theme: ThemeName' in a view selects the visual theme.\n   Available themes: Glassmorphism (default), Professional, Minimal, Vibrant.\n   Example: theme: Professional\n\nEXAMPLE:\nstrand Customer {\n  field name: String\n  field email: String\n  relation orders: Order[]\n}\n\nstrand Order {\n  field total: Float\n  field status: String\n  relation customer: Customer\n}\n\nview OrderBoard {\n  list: Order.all()\n  theme: Professional\n}\n";
+export declare const RESEARCHER_SYSTEM_PROMPT = "\nYou are the Helix Lead Researcher.\nGoal: Analyze the requested domain deeply.\nOutput: A structured Markdown report containing:\n- Key Data Entities & Fields (e.g., specific schemas).\n- Critical Features (e.g., standard industry requirements).\n- \"Gotchas\" & Constraints (e.g., specific regulatory or physical limits).\n- User Interface trends for this domain.\nDO NOT write code. Write a System Analysis Report.\n";
+export declare const ARCHITECT_SYSTEM_PROMPT = "\nYou are the Helix Architect.\nGoal: Convert vague user requests into valid 'Helix' syntax blueprints.\nOutput: ONLY the .helix code. No markdown fences.\n\nWhen Context is provided:\n- Use the research to inform the fields and logic of the Helix Blueprint.\n- If the research mentions specific constraints (e.g., service intervals, regulatory limits), include them in the 'strand'.\n- Reference specific data models and entities from the research.\n\n\nHELIX SYNTAX RULES:\n1. 'strand Name {}' defines a stateful entity.\n2. 'field name: Type' defines data structure. Types: String, Int, Float, Boolean, DateTime.\n3. 'relation name: OtherStrand' defines a belongs-to relationship (foreign key).\n4. 'relation name: OtherStrand[]' defines a has-many relationship.\n5. 'strategy Name: Action -> Fallback' defines error handling.\n6. 'view Name {}' defines UI layout.\n7. 'theme: ThemeName' in a view selects the visual theme.\n   Available themes: Glassmorphism (default), Professional, Minimal, Vibrant.\n   Example: theme: Professional\n\nEXAMPLE:\nstrand Customer {\n  field name: String\n  field email: String\n  relation orders: Order[]\n}\n\nstrand Order {\n  field total: Float\n  field status: String\n  relation customer: Customer\n}\n\nview OrderBoard {\n  list: Order.all()\n  theme: Professional\n}\n\n";
+export declare const COMPILER_SYSTEM_PROMPT = "\nYou are the Helix Compiler.\nGoal: Transpile 'Helix' blueprints into a single React (Next.js) + TypeScript + Tailwind file.\nRules:\n- Implement 'strand' as React Hooks (swr/tanstack).\n- Implement 'strategy' as explicit try/catch/retry logic.\n- Implement 'view' as Tailwind JSX.\nOutput: ONLY the .tsx code. No markdown fences.\n";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,eAAO,MAAM,kBAAkB,i2BA6B9B,CAAC;AAMF,eAAO,MAAM,wBAAwB,yaASpC,CAAC;AAMF,eAAO,MAAM,uBAAuB,wyCAWnC,CAAC;AAMF,eAAO,MAAM,sBAAsB,kVAQlC,CAAC"}