@netpad/mcp-server 2.2.1 → 2.3.1

package/dist/index.d.ts

@@ -1,2 +1,721 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
-export {  }
+declare const FIELD_TYPES: ({
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        required?: undefined;
+        validation?: undefined;
+        options?: undefined;
+        layout?: undefined;
+    };
+} | {
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        required: boolean;
+        validation?: undefined;
+        options?: undefined;
+        layout?: undefined;
+    };
+} | {
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        validation: {
+            min: number;
+            max: number;
+            maxSize?: undefined;
+            accept?: undefined;
+        };
+        required?: undefined;
+        options?: undefined;
+        layout?: undefined;
+    };
+} | {
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        options: {
+            label: string;
+            value: string;
+        }[];
+        required?: undefined;
+        validation?: undefined;
+        layout?: undefined;
+    };
+} | {
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        layout: {
+            type: string;
+            title: string;
+            subtitle: string;
+            content?: undefined;
+            height?: undefined;
+            imageUrl?: undefined;
+            alignment?: undefined;
+        };
+        required?: undefined;
+        validation?: undefined;
+        options?: undefined;
+    };
+} | {
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        layout: {
+            type: string;
+            content: string;
+            title?: undefined;
+            subtitle?: undefined;
+            height?: undefined;
+            imageUrl?: undefined;
+            alignment?: undefined;
+        };
+        required?: undefined;
+        validation?: undefined;
+        options?: undefined;
+    };
+} | {
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        layout: {
+            type: string;
+            title?: undefined;
+            subtitle?: undefined;
+            content?: undefined;
+            height?: undefined;
+            imageUrl?: undefined;
+            alignment?: undefined;
+        };
+        required?: undefined;
+        validation?: undefined;
+        options?: undefined;
+    };
+} | {
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        layout: {
+            type: string;
+            height: number;
+            title?: undefined;
+            subtitle?: undefined;
+            content?: undefined;
+            imageUrl?: undefined;
+            alignment?: undefined;
+        };
+        required?: undefined;
+        validation?: undefined;
+        options?: undefined;
+    };
+} | {
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        layout: {
+            type: string;
+            imageUrl: string;
+            alignment: string;
+            title?: undefined;
+            subtitle?: undefined;
+            content?: undefined;
+            height?: undefined;
+        };
+        required?: undefined;
+        validation?: undefined;
+        options?: undefined;
+    };
+} | {
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        validation: {
+            maxSize: number;
+            min?: undefined;
+            max?: undefined;
+            accept?: undefined;
+        };
+        required?: undefined;
+        options?: undefined;
+        layout?: undefined;
+    };
+} | {
+    type: string;
+    category: string;
+    description: string;
+    muiComponent: string;
+    example: {
+        path: string;
+        label: string;
+        type: string;
+        included: boolean;
+        validation: {
+            accept: string;
+            min?: undefined;
+            max?: undefined;
+            maxSize?: undefined;
+        };
+        required?: undefined;
+        options?: undefined;
+        layout?: undefined;
+    };
+})[];
+declare const OPERATORS: ({
+    operator: string;
+    label: string;
+    description: string;
+    requiresValue: boolean;
+    example: {
+        field: string;
+        operator: string;
+        value: string;
+    };
+} | {
+    operator: string;
+    label: string;
+    description: string;
+    requiresValue: boolean;
+    example: {
+        field: string;
+        operator: string;
+        value: number;
+    };
+} | {
+    operator: string;
+    label: string;
+    description: string;
+    requiresValue: boolean;
+    example: {
+        field: string;
+        operator: string;
+        value?: undefined;
+    };
+})[];
+declare const FORMULA_FUNCTIONS: {
+    name: string;
+    category: string;
+    description: string;
+    syntax: string;
+    example: string;
+}[];
+declare const VALIDATION_OPTIONS: ({
+    property: string;
+    type: string;
+    description: string;
+    fieldLevel: boolean;
+    example: {
+        required: boolean;
+        validation?: undefined;
+    };
+    validationLevel?: undefined;
+} | {
+    property: string;
+    type: string;
+    description: string;
+    validationLevel: boolean;
+    example: {
+        validation: {
+            min: number;
+            max?: undefined;
+            minLength?: undefined;
+            maxLength?: undefined;
+            pattern?: undefined;
+            errorMessage?: undefined;
+        };
+        required?: undefined;
+    };
+    fieldLevel?: undefined;
+} | {
+    property: string;
+    type: string;
+    description: string;
+    validationLevel: boolean;
+    example: {
+        validation: {
+            max: number;
+            min?: undefined;
+            minLength?: undefined;
+            maxLength?: undefined;
+            pattern?: undefined;
+            errorMessage?: undefined;
+        };
+        required?: undefined;
+    };
+    fieldLevel?: undefined;
+} | {
+    property: string;
+    type: string;
+    description: string;
+    validationLevel: boolean;
+    example: {
+        validation: {
+            minLength: number;
+            min?: undefined;
+            max?: undefined;
+            maxLength?: undefined;
+            pattern?: undefined;
+            errorMessage?: undefined;
+        };
+        required?: undefined;
+    };
+    fieldLevel?: undefined;
+} | {
+    property: string;
+    type: string;
+    description: string;
+    validationLevel: boolean;
+    example: {
+        validation: {
+            maxLength: number;
+            min?: undefined;
+            max?: undefined;
+            minLength?: undefined;
+            pattern?: undefined;
+            errorMessage?: undefined;
+        };
+        required?: undefined;
+    };
+    fieldLevel?: undefined;
+} | {
+    property: string;
+    type: string;
+    description: string;
+    validationLevel: boolean;
+    example: {
+        validation: {
+            pattern: string;
+            errorMessage: string;
+            min?: undefined;
+            max?: undefined;
+            minLength?: undefined;
+            maxLength?: undefined;
+        };
+        required?: undefined;
+    };
+    fieldLevel?: undefined;
+} | {
+    property: string;
+    type: string;
+    description: string;
+    validationLevel: boolean;
+    example: {
+        validation: {
+            errorMessage: string;
+            min?: undefined;
+            max?: undefined;
+            minLength?: undefined;
+            maxLength?: undefined;
+            pattern?: undefined;
+        };
+        required?: undefined;
+    };
+    fieldLevel?: undefined;
+})[];
+declare const THEME_OPTIONS: {
+    colors: {
+        property: string;
+        description: string;
+        default: string;
+    }[];
+    spacing: ({
+        value: string;
+        description: string;
+        default?: undefined;
+    } | {
+        value: string;
+        description: string;
+        default: boolean;
+    })[];
+    inputStyle: ({
+        value: string;
+        description: string;
+        default: boolean;
+    } | {
+        value: string;
+        description: string;
+        default?: undefined;
+    })[];
+    borderRadius: {
+        property: string;
+        description: string;
+        default: number;
+    }[];
+    other: ({
+        property: string;
+        description: string;
+        default: string;
+        values?: undefined;
+    } | {
+        property: string;
+        values: string[];
+        description: string;
+        default: string;
+    } | {
+        property: string;
+        description: string;
+        default?: undefined;
+        values?: undefined;
+    })[];
+};
+
+interface FieldConfig {
+    path: string;
+    label: string;
+    type: string;
+    included: boolean;
+    required?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    placeholder?: string;
+    helpText?: string;
+    fieldWidth?: 'full' | 'half' | 'third' | 'quarter';
+    defaultValue?: unknown;
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    validation?: {
+        min?: number;
+        max?: number;
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+        errorMessage?: string;
+    };
+    conditionalLogic?: ConditionalLogic;
+    computed?: ComputedConfig;
+    layout?: LayoutConfig;
+}
+interface ConditionalLogic {
+    action: 'show' | 'hide';
+    logicType: 'all' | 'any';
+    conditions: FieldCondition[];
+}
+interface FieldCondition {
+    field: string;
+    operator: string;
+    value?: string | number | boolean;
+}
+interface ComputedConfig {
+    formula: string;
+    dependencies: string[];
+    outputType?: 'string' | 'number' | 'boolean' | 'date';
+}
+interface LayoutConfig {
+    type: string;
+    title?: string;
+    subtitle?: string;
+    content?: string;
+    imageUrl?: string;
+    height?: number;
+    alignment?: 'left' | 'center' | 'right';
+}
+interface FormPage {
+    id: string;
+    title: string;
+    description?: string;
+    fields: string[];
+}
+interface MultiPageConfig {
+    enabled: boolean;
+    pages: FormPage[];
+    showProgressBar?: boolean;
+    showPageTitles?: boolean;
+    allowSkip?: boolean;
+    showReview?: boolean;
+}
+interface FormTheme {
+    primaryColor?: string;
+    backgroundColor?: string;
+    surfaceColor?: string;
+    textColor?: string;
+    errorColor?: string;
+    successColor?: string;
+    borderRadius?: number;
+    spacing?: 'compact' | 'comfortable' | 'spacious';
+    inputStyle?: 'outlined' | 'filled' | 'standard';
+    mode?: 'light' | 'dark';
+}
+interface FormConfiguration {
+    name: string;
+    description?: string;
+    fieldConfigs: FieldConfig[];
+    multiPage?: MultiPageConfig;
+    theme?: FormTheme;
+    submitButtonText?: string;
+    successMessage?: string;
+}
+interface GenerateFormOptions {
+    multiPage?: boolean;
+    theme?: boolean;
+}
+declare function generateFormSchema(description: string, formName: string, options?: GenerateFormOptions): FormConfiguration;
+declare function generateFieldConfig(params: {
+    path: string;
+    label: string;
+    type: string;
+    required?: boolean;
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    placeholder?: string;
+    helpText?: string;
+    fieldWidth?: 'full' | 'half' | 'third' | 'quarter';
+    validation?: {
+        min?: number;
+        max?: number;
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+        errorMessage?: string;
+    };
+}): FieldConfig;
+declare function generateConditionalLogic(action: 'show' | 'hide', logicType: 'all' | 'any', conditions: Array<{
+    field: string;
+    operator: string;
+    value?: string | number | boolean;
+}>): ConditionalLogic;
+declare function generateComputedField(path: string, label: string, formula: string, outputType?: 'string' | 'number' | 'boolean' | 'date'): FieldConfig;
+declare function generateMultiPageConfig(pages: Array<{
+    id: string;
+    title: string;
+    description?: string;
+    fields: string[];
+}>, options?: {
+    showProgressBar?: boolean;
+    showPageTitles?: boolean;
+    allowSkip?: boolean;
+    showReview?: boolean;
+}): MultiPageConfig;
+interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+declare function validateFormConfig(config: unknown): ValidationResult;
+
+declare const DOCUMENTATION: {
+    readme: string;
+    architecture: string;
+    apiClient: string;
+    extensions: string;
+};
+declare const QUICK_START_GUIDE = "# Quick Start Guide\n\n## 1. Installation\n\n```bash\nnpm install @netpad/forms @mui/material @mui/icons-material @emotion/react @emotion/styled\n```\n\n## 2. Create Your First Form\n\n```tsx\nimport { FormRenderer } from '@netpad/forms';\nimport type { FormConfiguration } from '@netpad/forms';\n\n// Define your form configuration\nconst contactFormConfig: FormConfiguration = {\n  name: 'Contact Form',\n  fieldConfigs: [\n    {\n      path: 'name',\n      label: 'Your Name',\n      type: 'short_text',\n      included: true,\n      required: true,\n      placeholder: 'Enter your full name',\n    },\n    {\n      path: 'email',\n      label: 'Email Address',\n      type: 'email',\n      included: true,\n      required: true,\n      placeholder: 'you@example.com',\n    },\n    {\n      path: 'subject',\n      label: 'Subject',\n      type: 'dropdown',\n      included: true,\n      options: [\n        { label: 'General Inquiry', value: 'general' },\n        { label: 'Support', value: 'support' },\n        { label: 'Feedback', value: 'feedback' },\n      ],\n    },\n    {\n      path: 'message',\n      label: 'Message',\n      type: 'long_text',\n      included: true,\n      required: true,\n      placeholder: 'How can we help you?',\n      validation: {\n        minLength: 10,\n        errorMessage: 'Please enter at least 10 characters',\n      },\n    },\n  ],\n  submitButtonText: 'Send Message',\n  successMessage: 'Thank you! We will get back to you soon.',\n};\n\n// Create your form component\nexport function ContactPage() {\n  const handleSubmit = async (data: Record<string, unknown>) => {\n    // Send data to your API\n    const response = await fetch('/api/contact', {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(data),\n    });\n\n    if (!response.ok) {\n      throw new Error('Submission failed');\n    }\n  };\n\n  return (\n    <div style={{ maxWidth: 600, margin: '0 auto', padding: 24 }}>\n      <FormRenderer\n        config={contactFormConfig}\n        onSubmit={handleSubmit}\n        mode=\"create\"\n      />\n    </div>\n  );\n}\n```\n\n## 3. Add Conditional Logic\n\nShow fields based on other field values:\n\n```tsx\n{\n  path: 'phoneNumber',\n  label: 'Phone Number',\n  type: 'phone',\n  included: true,\n  conditionalLogic: {\n    action: 'show',\n    logicType: 'any',\n    conditions: [\n      { field: 'subject', operator: 'equals', value: 'support' },\n    ],\n  },\n}\n```\n\n## 4. Create a Multi-Page Form\n\n```tsx\nconst wizardConfig: FormConfiguration = {\n  name: 'Registration',\n  fieldConfigs: [\n    // Personal info fields\n    { path: 'firstName', label: 'First Name', type: 'short_text', included: true, required: true },\n    { path: 'lastName', label: 'Last Name', type: 'short_text', included: true, required: true },\n    { path: 'email', label: 'Email', type: 'email', included: true, required: true },\n    // Account fields\n    { path: 'username', label: 'Username', type: 'short_text', included: true, required: true },\n    { path: 'password', label: 'Password', type: 'short_text', included: true, required: true },\n    // Preferences\n    { path: 'newsletter', label: 'Subscribe to newsletter', type: 'checkbox', included: true },\n    { path: 'interests', label: 'Interests', type: 'checkboxes', included: true, options: [...] },\n  ],\n  multiPage: {\n    enabled: true,\n    showProgressBar: true,\n    showPageTitles: true,\n    pages: [\n      {\n        id: 'personal',\n        title: 'Personal Information',\n        fields: ['firstName', 'lastName', 'email'],\n      },\n      {\n        id: 'account',\n        title: 'Account Setup',\n        fields: ['username', 'password'],\n      },\n      {\n        id: 'preferences',\n        title: 'Preferences',\n        fields: ['newsletter', 'interests'],\n      },\n    ],\n  },\n};\n```\n\n## 5. Add Computed Fields\n\n```tsx\n{\n  path: 'quantity',\n  label: 'Quantity',\n  type: 'number',\n  included: true,\n  validation: { min: 1 },\n},\n{\n  path: 'unitPrice',\n  label: 'Unit Price',\n  type: 'number',\n  included: true,\n},\n{\n  path: 'total',\n  label: 'Total',\n  type: 'number',\n  included: true,\n  disabled: true, // Read-only\n  computed: {\n    formula: 'quantity * unitPrice',\n    dependencies: ['quantity', 'unitPrice'],\n    outputType: 'number',\n  },\n}\n```\n\n## Next Steps\n\n- Explore all 28+ field types\n- Add custom validation rules\n- Customize the theme\n- Connect to the NetPad platform\n";
+declare const ARCHITECTURE_GUIDE: string;
+declare const EXAMPLES = "# @netpad/forms Examples\n\n## Contact Form\n\n```typescript\nconst contactForm: FormConfiguration = {\n  name: 'Contact Us',\n  fieldConfigs: [\n    { path: 'name', label: 'Full Name', type: 'short_text', included: true, required: true, fieldWidth: 'half' },\n    { path: 'email', label: 'Email', type: 'email', included: true, required: true, fieldWidth: 'half' },\n    { path: 'phone', label: 'Phone', type: 'phone', included: true, fieldWidth: 'half' },\n    { path: 'company', label: 'Company', type: 'short_text', included: true, fieldWidth: 'half' },\n    { path: 'subject', label: 'Subject', type: 'dropdown', included: true, required: true,\n      options: [\n        { label: 'General Inquiry', value: 'general' },\n        { label: 'Sales', value: 'sales' },\n        { label: 'Support', value: 'support' },\n        { label: 'Partnership', value: 'partnership' },\n      ]\n    },\n    { path: 'message', label: 'Message', type: 'long_text', included: true, required: true,\n      validation: { minLength: 20, errorMessage: 'Please provide more details (at least 20 characters)' }\n    },\n    { path: 'newsletter', label: 'Subscribe to our newsletter', type: 'checkbox', included: true },\n  ],\n  submitButtonText: 'Send Message',\n  successMessage: 'Thank you for contacting us! We will respond within 24 hours.',\n};\n```\n\n## Customer Survey (Multi-Page)\n\n```typescript\nconst surveyForm: FormConfiguration = {\n  name: 'Customer Satisfaction Survey',\n  fieldConfigs: [\n    // Page 1: About You\n    { path: 'name', label: 'Your Name (optional)', type: 'short_text', included: true },\n    { path: 'email', label: 'Email (optional)', type: 'email', included: true },\n    { path: 'howHeard', label: 'How did you hear about us?', type: 'dropdown', included: true,\n      options: [\n        { label: 'Search Engine', value: 'search' },\n        { label: 'Social Media', value: 'social' },\n        { label: 'Friend/Colleague', value: 'referral' },\n        { label: 'Advertisement', value: 'ad' },\n        { label: 'Other', value: 'other' },\n      ]\n    },\n    // Page 2: Your Experience\n    { path: 'overallSatisfaction', label: 'Overall Satisfaction', type: 'rating', included: true, required: true },\n    { path: 'npsScore', label: 'How likely are you to recommend us?', type: 'nps', included: true, required: true },\n    { path: 'likedMost', label: 'What did you like most?', type: 'checkboxes', included: true,\n      options: [\n        { label: 'Product Quality', value: 'quality' },\n        { label: 'Customer Service', value: 'service' },\n        { label: 'Ease of Use', value: 'ease' },\n        { label: 'Price', value: 'price' },\n        { label: 'Features', value: 'features' },\n      ]\n    },\n    { path: 'improvements', label: 'What could we improve?', type: 'long_text', included: true },\n    // Page 3: Follow-up\n    { path: 'canContact', label: 'May we contact you for follow-up?', type: 'yes_no', included: true },\n    { path: 'preferredContact', label: 'Preferred contact method', type: 'radio', included: true,\n      options: [\n        { label: 'Email', value: 'email' },\n        { label: 'Phone', value: 'phone' },\n      ],\n      conditionalLogic: {\n        action: 'show',\n        logicType: 'all',\n        conditions: [{ field: 'canContact', operator: 'isTrue' }],\n      }\n    },\n    { path: 'additionalComments', label: 'Any additional comments?', type: 'long_text', included: true },\n  ],\n  multiPage: {\n    enabled: true,\n    showProgressBar: true,\n    showPageTitles: true,\n    pages: [\n      { id: 'about', title: 'About You', fields: ['name', 'email', 'howHeard'] },\n      { id: 'experience', title: 'Your Experience', fields: ['overallSatisfaction', 'npsScore', 'likedMost', 'improvements'] },\n      { id: 'followup', title: 'Follow-up', fields: ['canContact', 'preferredContact', 'additionalComments'] },\n    ],\n  },\n  submitButtonText: 'Submit Survey',\n  successMessage: 'Thank you for your feedback!',\n};\n```\n\n## Order Form with Computed Fields\n\n```typescript\nconst orderForm: FormConfiguration = {\n  name: 'Product Order',\n  fieldConfigs: [\n    // Product selection\n    { path: 'product', label: 'Product', type: 'dropdown', included: true, required: true, fieldWidth: 'half',\n      options: [\n        { label: 'Basic Plan - $10/mo', value: 'basic' },\n        { label: 'Pro Plan - $25/mo', value: 'pro' },\n        { label: 'Enterprise - $99/mo', value: 'enterprise' },\n      ]\n    },\n    { path: 'quantity', label: 'Quantity (months)', type: 'number', included: true, required: true, fieldWidth: 'half',\n      defaultValue: 1,\n      validation: { min: 1, max: 24 }\n    },\n    { path: 'unitPrice', label: 'Unit Price', type: 'number', included: true, disabled: true, fieldWidth: 'third' },\n    { path: 'discount', label: 'Discount (%)', type: 'number', included: true, fieldWidth: 'third',\n      defaultValue: 0,\n      validation: { min: 0, max: 50 }\n    },\n    { path: 'total', label: 'Total', type: 'number', included: true, disabled: true, fieldWidth: 'third',\n      computed: {\n        formula: 'quantity * unitPrice * (1 - discount / 100)',\n        dependencies: ['quantity', 'unitPrice', 'discount'],\n        outputType: 'number',\n      }\n    },\n    // Customer info\n    { path: 'sectionCustomer', label: 'Customer Information', type: 'section-header', included: true,\n      layout: { type: 'section-header', title: 'Customer Information' }\n    },\n    { path: 'customerName', label: 'Name', type: 'short_text', included: true, required: true },\n    { path: 'customerEmail', label: 'Email', type: 'email', included: true, required: true },\n    // Billing address\n    { path: 'billing.street', label: 'Street Address', type: 'short_text', included: true, required: true },\n    { path: 'billing.city', label: 'City', type: 'short_text', included: true, required: true, fieldWidth: 'half' },\n    { path: 'billing.state', label: 'State', type: 'short_text', included: true, required: true, fieldWidth: 'quarter' },\n    { path: 'billing.zip', label: 'ZIP', type: 'short_text', included: true, required: true, fieldWidth: 'quarter' },\n  ],\n  submitButtonText: 'Place Order',\n};\n```\n\n## Employee Onboarding (Complex Multi-Page)\n\n```typescript\nconst onboardingForm: FormConfiguration = {\n  name: 'Employee Onboarding',\n  fieldConfigs: [\n    // Personal Information\n    { path: 'firstName', label: 'First Name', type: 'short_text', included: true, required: true, fieldWidth: 'half' },\n    { path: 'lastName', label: 'Last Name', type: 'short_text', included: true, required: true, fieldWidth: 'half' },\n    { path: 'email', label: 'Email', type: 'email', included: true, required: true, fieldWidth: 'half' },\n    { path: 'phone', label: 'Phone', type: 'phone', included: true, required: true, fieldWidth: 'half' },\n    { path: 'dateOfBirth', label: 'Date of Birth', type: 'date', included: true, required: true, fieldWidth: 'half' },\n    { path: 'address.street', label: 'Street Address', type: 'short_text', included: true, required: true },\n    { path: 'address.city', label: 'City', type: 'short_text', included: true, required: true, fieldWidth: 'half' },\n    { path: 'address.state', label: 'State', type: 'short_text', included: true, required: true, fieldWidth: 'quarter' },\n    { path: 'address.zip', label: 'ZIP Code', type: 'short_text', included: true, required: true, fieldWidth: 'quarter' },\n\n    // Employment Details\n    { path: 'department', label: 'Department', type: 'dropdown', included: true, required: true,\n      options: [\n        { label: 'Engineering', value: 'engineering' },\n        { label: 'Product', value: 'product' },\n        { label: 'Design', value: 'design' },\n        { label: 'Marketing', value: 'marketing' },\n        { label: 'Sales', value: 'sales' },\n        { label: 'HR', value: 'hr' },\n        { label: 'Finance', value: 'finance' },\n      ]\n    },\n    { path: 'jobTitle', label: 'Job Title', type: 'short_text', included: true, required: true },\n    { path: 'startDate', label: 'Start Date', type: 'date', included: true, required: true },\n    { path: 'workLocation', label: 'Work Location', type: 'radio', included: true, required: true,\n      options: [\n        { label: 'Remote', value: 'remote' },\n        { label: 'Hybrid', value: 'hybrid' },\n        { label: 'On-site', value: 'onsite' },\n      ]\n    },\n    { path: 'officeLocation', label: 'Office Location', type: 'dropdown', included: true,\n      options: [\n        { label: 'New York', value: 'nyc' },\n        { label: 'San Francisco', value: 'sf' },\n        { label: 'London', value: 'london' },\n        { label: 'Singapore', value: 'singapore' },\n      ],\n      conditionalLogic: {\n        action: 'show',\n        logicType: 'any',\n        conditions: [\n          { field: 'workLocation', operator: 'equals', value: 'hybrid' },\n          { field: 'workLocation', operator: 'equals', value: 'onsite' },\n        ],\n      }\n    },\n\n    // Emergency Contact\n    { path: 'emergencyContact.name', label: 'Emergency Contact Name', type: 'short_text', included: true, required: true },\n    { path: 'emergencyContact.relationship', label: 'Relationship', type: 'short_text', included: true, required: true, fieldWidth: 'half' },\n    { path: 'emergencyContact.phone', label: 'Phone', type: 'phone', included: true, required: true, fieldWidth: 'half' },\n  ],\n  multiPage: {\n    enabled: true,\n    showProgressBar: true,\n    showPageTitles: true,\n    pages: [\n      {\n        id: 'personal',\n        title: 'Personal Information',\n        description: 'Please provide your personal details',\n        fields: ['firstName', 'lastName', 'email', 'phone', 'dateOfBirth', 'address.street', 'address.city', 'address.state', 'address.zip'],\n      },\n      {\n        id: 'employment',\n        title: 'Employment Details',\n        description: 'Information about your role',\n        fields: ['department', 'jobTitle', 'startDate', 'workLocation', 'officeLocation'],\n      },\n      {\n        id: 'emergency',\n        title: 'Emergency Contact',\n        description: 'In case of emergency',\n        fields: ['emergencyContact.name', 'emergencyContact.relationship', 'emergencyContact.phone'],\n      },\n    ],\n  },\n  submitButtonText: 'Complete Onboarding',\n  successMessage: 'Welcome to the team! Your onboarding form has been submitted.',\n};\n```\n\n## Form with Layout Elements\n\n```typescript\nconst applicationForm: FormConfiguration = {\n  name: 'Job Application',\n  fieldConfigs: [\n    // Header section\n    { path: 'headerSection', label: '', type: 'section-header', included: true,\n      layout: { type: 'section-header', title: 'Job Application', subtitle: 'Please complete all required fields' }\n    },\n    { path: 'instructions', label: '', type: 'description', included: true,\n      layout: { type: 'description', content: 'Thank you for your interest in joining our team. This application should take about 10 minutes to complete.' }\n    },\n    { path: 'divider1', label: '', type: 'divider', included: true, layout: { type: 'divider' } },\n\n    // Personal section\n    { path: 'personalHeader', label: '', type: 'section-header', included: true,\n      layout: { type: 'section-header', title: 'Personal Information' }\n    },\n    { path: 'firstName', label: 'First Name', type: 'short_text', included: true, required: true, fieldWidth: 'half' },\n    { path: 'lastName', label: 'Last Name', type: 'short_text', included: true, required: true, fieldWidth: 'half' },\n    { path: 'email', label: 'Email', type: 'email', included: true, required: true, fieldWidth: 'half' },\n    { path: 'phone', label: 'Phone', type: 'phone', included: true, fieldWidth: 'half' },\n\n    { path: 'spacer1', label: '', type: 'spacer', included: true, layout: { type: 'spacer', height: 16 } },\n\n    // Position section\n    { path: 'positionHeader', label: '', type: 'section-header', included: true,\n      layout: { type: 'section-header', title: 'Position' }\n    },\n    { path: 'position', label: 'Position Applied For', type: 'dropdown', included: true, required: true,\n      options: [\n        { label: 'Software Engineer', value: 'swe' },\n        { label: 'Product Manager', value: 'pm' },\n        { label: 'Designer', value: 'design' },\n      ]\n    },\n    { path: 'experience', label: 'Years of Experience', type: 'number', included: true, required: true, fieldWidth: 'half' },\n    { path: 'salary', label: 'Expected Salary', type: 'number', included: true, fieldWidth: 'half' },\n\n    // Documents\n    { path: 'coverLetter', label: 'Cover Letter', type: 'long_text', included: true, required: true,\n      helpText: 'Tell us why you would be a great fit for this role',\n      validation: { minLength: 100 }\n    },\n\n    // Agreement\n    { path: 'divider2', label: '', type: 'divider', included: true, layout: { type: 'divider' } },\n    { path: 'agreeTerms', label: 'I certify that all information provided is accurate', type: 'checkbox', included: true, required: true },\n  ],\n  submitButtonText: 'Submit Application',\n};\n```\n";
+
+/**
+ * Extension Generation Tools for NetPad MCP Server
+ *
+ * Provides tools for creating custom NetPad extensions with workflow nodes.
+ * Extensions can add custom functionality to NetPad installations through
+ * modular, independently deployable packages.
+ */
+/**
+ * Node categories available for workflow nodes
+ */
+type NodeCategory = 'triggers' | 'logic' | 'integrations' | 'actions' | 'data' | 'ai' | 'forms' | 'custom' | 'annotations';
+/**
+ * Configuration field types for node editor UI
+ */
+type ConfigFieldType = 'text' | 'textarea' | 'number' | 'boolean' | 'select' | 'json' | 'expression' | 'connection';
+/**
+ * Configuration field definition for workflow node editor
+ */
+interface NodeConfigField {
+    name: string;
+    label: string;
+    type: ConfigFieldType;
+    defaultValue?: unknown;
+    placeholder?: string;
+    helpText?: string;
+    required?: boolean;
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+/**
+ * Node output definition
+ */
+interface NodeOutput {
+    id: string;
+    label: string;
+    description?: string;
+    primary?: boolean;
+}
+/**
+ * Workflow node definition for extension
+ */
+interface WorkflowNodeDefinition {
+    type: string;
+    label: string;
+    description: string;
+    category: NodeCategory;
+    color: string;
+    icon: string;
+    version: string;
+    configFields?: NodeConfigField[];
+    outputs?: NodeOutput[];
+}
+/**
+ * Extension metadata
+ */
+interface ExtensionMetadata {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+}
+/**
+ * Options for generating an extension
+ */
+interface GenerateExtensionOptions {
+    /** Extension metadata */
+    metadata: ExtensionMetadata;
+    /** Workflow nodes provided by this extension */
+    workflowNodes?: Array<{
+        definition: Omit<WorkflowNodeDefinition, 'type'> & {
+            type?: string;
+        };
+        /** Description of what the handler should do */
+        handlerDescription?: string;
+        /** Sample handler implementation (optional) */
+        handlerCode?: string;
+    }>;
+    /** Feature flags this extension provides */
+    features?: string[];
+    /** Whether to include API routes scaffolding */
+    includeRoutes?: boolean;
+    /** Whether to include services scaffolding */
+    includeServices?: boolean;
+}
+/**
+ * Available node categories with descriptions
+ */
+declare const NODE_CATEGORIES: Record<NodeCategory, {
+    label: string;
+    description: string;
+}>;
+/**
+ * Available config field types with descriptions
+ */
+declare const CONFIG_FIELD_TYPES: Record<ConfigFieldType, {
+    label: string;
+    description: string;
+}>;
+/**
+ * Common MUI icon names for workflow nodes
+ */
+declare const COMMON_ICONS: string[];
+/**
+ * Suggested colors for workflow nodes
+ */
+declare const SUGGESTED_COLORS: {
+    orange: string;
+    blue: string;
+    green: string;
+    purple: string;
+    pink: string;
+    teal: string;
+    amber: string;
+    indigo: string;
+    cyan: string;
+    red: string;
+    grey: string;
+    lime: string;
+};
+/**
+ * Generate a valid extension ID from a name
+ */
+declare function generateExtensionId(name: string): string;
+/**
+ * Generate a complete extension package
+ */
+declare function generateExtensionPackage(options: GenerateExtensionOptions): {
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    metadata: ExtensionMetadata;
+};
+
+/**
+ * Create a configured NetPad MCP server instance.
+ * This factory function can be used by both the CLI (stdio) and remote (HTTP) servers.
+ *
+ * @param options - Optional configuration for the server
+ * @returns A configured McpServer instance
+ */
+declare function createNetPadMcpServer(options?: {
+    name?: string;
+    version?: string;
+}): McpServer;
+
+export { ARCHITECTURE_GUIDE, COMMON_ICONS, CONFIG_FIELD_TYPES, type ConfigFieldType, DOCUMENTATION, EXAMPLES, FIELD_TYPES, FORMULA_FUNCTIONS, type GenerateExtensionOptions, NODE_CATEGORIES, type NodeCategory, OPERATORS, QUICK_START_GUIDE, SUGGESTED_COLORS, THEME_OPTIONS, VALIDATION_OPTIONS, createNetPadMcpServer, generateComputedField, generateConditionalLogic, generateExtensionId, generateExtensionPackage, generateFieldConfig, generateFormSchema, generateMultiPageConfig, validateFormConfig };