@anri1214/dynamic-forms-mui-mcp 0.1.5

package/dist/prompts/generateFormConfig.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns a prompt that helps generate a FormSchema JSON configuration.
+ */
+export declare function generateFormConfigPrompt(formDescription: string, fieldHints?: string): string;
+//# sourceMappingURL=generateFormConfig.d.ts.map

package/dist/prompts/generateFormConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateFormConfig.d.ts","sourceRoot":"","sources":["../../src/prompts/generateFormConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA0FR"}

package/dist/prompts/generateFormConfig.js

@@ -0,0 +1,94 @@
+/**
+ * Returns a prompt that helps generate a FormSchema JSON configuration.
+ */
+export function generateFormConfigPrompt(formDescription, fieldHints) {
+    return `You are a form configuration expert for the @ai-hub/dynamic-forms-mui library.
+Generate a complete, valid FormSchema JSON object based on the requirements below.
+
+## Form Requirements
+${formDescription}
+
+${fieldHints ? `## Additional Field Hints\n${fieldHints}` : ''}
+
+## FormSchema Structure
+
+The output must be a JSON object with this structure:
+\`\`\`json
+{
+  "sections": [
+    {
+      "id": "string (unique section ID)",
+      "title": "string (section heading)",
+      "description": "string (optional)",
+      "fields": ["fieldKey1", "fieldKey2"]
+    }
+  ],
+  "fields": {
+    "fieldKey": {
+      "type": "text|password|email|number|textarea|select|multiselect|checkbox|radio|switch|date|dateRange|file",
+      "label": "string (field label)",
+      "placeholder": "string (optional)",
+      "helperText": "string (optional)",
+      "defaultValue": "any (optional)",
+      "disabled": "boolean (optional)",
+      "showIf": "Condition (optional)",
+      "validation": "ValidationRules (optional)"
+    }
+  }
+}
+\`\`\`
+
+## Field Type Quick Reference
+
+| Type | Extra Props | Key Validations |
+|------|-------------|-----------------|
+| text | autoComplete | required, minLength, maxLength, pattern |
+| password | autoComplete | required, minLength, hasUppercase, hasLowercase, hasNumber, hasSpecialChar, matchField |
+| email | autoComplete | required, email, asyncValidation |
+| number | min, max, step | required, min, max |
+| textarea | rows | required, minLength, maxLength |
+| select | options, optionsSource | required |
+| multiselect | options, optionsSource | required |
+| checkbox | — | required |
+| radio | options, optionsSource, direction | required |
+| switch | — | required |
+| date | includeTime, minDate, maxDate, format | required, minDate, maxDate |
+| dateRange | includeTime, minDate, maxDate, format | required |
+| file | accept, maxSize, multiple | required, maxSize, minFiles, maxFiles |
+
+## Validation Messages
+Add custom messages via \`validation.messages\` for better UX:
+\`\`\`json
+"validation": {
+  "required": true,
+  "messages": { "required": "This field is required" }
+}
+\`\`\`
+
+## Conditional Visibility (showIf)
+\`\`\`json
+"showIf": { "field": "otherField", "operator": "equals", "value": "someValue" }
+\`\`\`
+Operators: equals, notEquals, in, notIn, isEmpty, isNotEmpty, gt, gte, lt, lte
+Composite: { "and": [...conditions] } or { "or": [...conditions] }
+
+## Dynamic Options (optionsSource)
+\`\`\`json
+"optionsSource": {
+  "apiUrl": "/api/items",
+  "queryParams": [{ "key": "parentId", "dependsOn": "parentField" }],
+  "valueKey": "id",
+  "labelKey": "name"
+}
+\`\`\`
+
+## Rules
+1. Group related fields into logical sections
+2. Use meaningful field keys (camelCase)
+3. Add validation for all required fields
+4. Include helpful placeholder text and helper text
+5. Use cross-field validation (matchField) for confirmation fields
+6. Output ONLY valid JSON — no comments, no trailing commas
+
+Generate the FormSchema JSON now.`;
+}

package/dist/resources/examples.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns available example names for a given library version.
+ */
+export declare function listExamples(version: string): string[];
+/**
+ * Returns a specific example by name for a given library version, or null if not found.
+ */
+export declare function getExample(version: string, name: string): string | null;
+//# sourceMappingURL=examples.d.ts.map

package/dist/resources/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../src/resources/examples.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvE"}

package/dist/resources/examples.js

@@ -0,0 +1,16 @@
+import { loadExampleNames, loadExample } from '../schemaLoader.js';
+/**
+ * Returns available example names for a given library version.
+ */
+export function listExamples(version) {
+    return loadExampleNames(version);
+}
+/**
+ * Returns a specific example by name for a given library version, or null if not found.
+ */
+export function getExample(version, name) {
+    const example = loadExample(version, name);
+    if (!example)
+        return null;
+    return JSON.stringify(example, null, 2);
+}

package/dist/resources/fieldDocs.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns a formatted documentation string for all field types for a given library version.
+ */
+export declare function getFieldDocsResource(version: string): string;
+//# sourceMappingURL=fieldDocs.d.ts.map

package/dist/resources/fieldDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldDocs.d.ts","sourceRoot":"","sources":["../../src/resources/fieldDocs.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAyC5D"}

package/dist/resources/fieldDocs.js

@@ -0,0 +1,39 @@
+import { loadFieldTypes } from '../schemaLoader.js';
+/**
+ * Returns a formatted documentation string for all field types for a given library version.
+ */
+export function getFieldDocsResource(version) {
+    const fieldTypesData = loadFieldTypes(version);
+    const docs = fieldTypesData.fieldTypes.map((ft) => {
+        const lines = [
+            `## ${ft.type}`,
+            '',
+            ft.description,
+            '',
+            `**Config interface:** \`${ft.config}\``,
+            '',
+        ];
+        if (ft.specificProps.length > 0) {
+            lines.push(`**Specific props:** ${ft.specificProps.map((p) => `\`${p}\``).join(', ')}`);
+        }
+        else {
+            lines.push('**Specific props:** none');
+        }
+        lines.push('');
+        lines.push(`**Applicable validations:** ${ft.applicableValidations.map((v) => `\`${v}\``).join(', ')}`);
+        lines.push('');
+        lines.push('**Example:**');
+        lines.push('```json');
+        lines.push(JSON.stringify(ft.example, null, 2));
+        lines.push('```');
+        lines.push('');
+        return lines.join('\n');
+    });
+    return [
+        `# Dynamic Forms MUI — Field Types Reference (v${version})`,
+        '',
+        `Total field types: ${fieldTypesData.fieldTypes.length}`,
+        '',
+        ...docs,
+    ].join('\n');
+}

package/dist/resources/jsonSchema.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns the full FormSchema JSON Schema as a formatted string for a given library version.
+ */
+export declare function getFormSchemaResource(version: string): string;
+//# sourceMappingURL=jsonSchema.d.ts.map

package/dist/resources/jsonSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSchema.d.ts","sourceRoot":"","sources":["../../src/resources/jsonSchema.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/resources/jsonSchema.js

@@ -0,0 +1,8 @@
+import { loadFormSchema } from '../schemaLoader.js';
+/**
+ * Returns the full FormSchema JSON Schema as a formatted string for a given library version.
+ */
+export function getFormSchemaResource(version) {
+    const formSchema = loadFormSchema(version);
+    return JSON.stringify(formSchema, null, 2);
+}

package/dist/schema/0.1/examples/crud.json

@@ -0,0 +1,128 @@
+{
+  "name": "Product CRUD Form",
+  "description": "A CRUD form for creating/editing a product entity with categories, pricing, and image upload",
+  "schema": {
+    "sections": [
+      {
+        "id": "basic",
+        "title": "Basic Information",
+        "fields": ["name", "description", "category"]
+      },
+      {
+        "id": "pricing",
+        "title": "Pricing",
+        "fields": ["price", "currency", "discount"]
+      },
+      {
+        "id": "media",
+        "title": "Media",
+        "fields": ["images"]
+      },
+      {
+        "id": "settings",
+        "title": "Settings",
+        "fields": ["isActive", "isFeatured"]
+      }
+    ],
+    "fields": {
+      "name": {
+        "type": "text",
+        "label": "Product Name",
+        "placeholder": "Enter product name",
+        "validation": {
+          "required": true,
+          "minLength": 3,
+          "maxLength": 200
+        }
+      },
+      "description": {
+        "type": "textarea",
+        "label": "Description",
+        "rows": 4,
+        "placeholder": "Describe the product...",
+        "validation": {
+          "maxLength": 2000
+        }
+      },
+      "category": {
+        "type": "select",
+        "label": "Category",
+        "optionsSource": {
+          "apiUrl": "/api/categories",
+          "valueKey": "id",
+          "labelKey": "name"
+        },
+        "validation": {
+          "required": true
+        }
+      },
+      "price": {
+        "type": "number",
+        "label": "Price",
+        "min": 0,
+        "step": 0.01,
+        "validation": {
+          "required": true,
+          "min": 0
+        }
+      },
+      "currency": {
+        "type": "select",
+        "label": "Currency",
+        "options": [
+          { "value": "USD", "label": "USD ($)" },
+          { "value": "EUR", "label": "EUR (\u20ac)" },
+          { "value": "UAH", "label": "UAH (\u20b4)" }
+        ],
+        "validation": {
+          "required": true
+        }
+      },
+      "discount": {
+        "type": "number",
+        "label": "Discount (%)",
+        "min": 0,
+        "max": 100,
+        "step": 1,
+        "helperText": "Optional discount percentage",
+        "showIf": {
+          "field": "price",
+          "operator": "gt",
+          "value": 0
+        }
+      },
+      "images": {
+        "type": "file",
+        "label": "Product Images",
+        "accept": "image/*",
+        "multiple": true,
+        "maxSize": 10485760,
+        "validation": {
+          "maxSize": 10485760,
+          "maxFiles": 5,
+          "messages": {
+            "maxSize": "Each image must be under 10MB",
+            "maxFiles": "Maximum 5 images allowed"
+          }
+        }
+      },
+      "isActive": {
+        "type": "switch",
+        "label": "Active",
+        "defaultValue": true,
+        "helperText": "Whether the product is visible to customers"
+      },
+      "isFeatured": {
+        "type": "switch",
+        "label": "Featured",
+        "defaultValue": false,
+        "showIf": {
+          "field": "isActive",
+          "operator": "equals",
+          "value": true
+        }
+      }
+    }
+  }
+}
+

package/dist/schema/0.1/examples/filters.json

@@ -0,0 +1,82 @@
+{
+  "name": "Search & Filter Form",
+  "description": "A filter/search form with dependent dropdowns and date range filtering",
+  "schema": {
+    "sections": [
+      {
+        "id": "search",
+        "title": "Search",
+        "fields": ["query", "status"]
+      },
+      {
+        "id": "dateFilter",
+        "title": "Date Filter",
+        "fields": ["dateRange"]
+      },
+      {
+        "id": "categoryFilter",
+        "title": "Category Filter",
+        "description": "City depends on the selected country",
+        "fields": ["country", "city", "tags"]
+      }
+    ],
+    "fields": {
+      "query": {
+        "type": "text",
+        "label": "Search",
+        "placeholder": "Search by name or keyword..."
+      },
+      "status": {
+        "type": "select",
+        "label": "Status",
+        "options": [
+          { "value": "all", "label": "All" },
+          { "value": "active", "label": "Active" },
+          { "value": "inactive", "label": "Inactive" },
+          { "value": "pending", "label": "Pending" }
+        ]
+      },
+      "dateRange": {
+        "type": "dateRange",
+        "label": "Date Range",
+        "format": "dd/MM/yyyy"
+      },
+      "country": {
+        "type": "select",
+        "label": "Country",
+        "optionsSource": {
+          "apiUrl": "/api/countries",
+          "valueKey": "code",
+          "labelKey": "name"
+        }
+      },
+      "city": {
+        "type": "select",
+        "label": "City",
+        "helperText": "Select a country first",
+        "optionsSource": {
+          "apiUrl": "/api/cities",
+          "queryParams": [
+            { "key": "countryCode", "dependsOn": "country" }
+          ],
+          "valueKey": "id",
+          "labelKey": "name"
+        },
+        "showIf": {
+          "field": "country",
+          "operator": "isNotEmpty"
+        }
+      },
+      "tags": {
+        "type": "multiselect",
+        "label": "Tags",
+        "optionsSource": {
+          "apiUrl": "/api/tags",
+          "valueKey": "id",
+          "labelKey": "name"
+        }
+      }
+    }
+  }
+}
+

package/dist/schema/0.1/examples/registration.json

@@ -0,0 +1,119 @@
+{
+  "name": "User Registration Form",
+  "description": "A typical user registration form with email, password, and personal information",
+  "schema": {
+    "sections": [
+      {
+        "id": "credentials",
+        "title": "Account Credentials",
+        "fields": ["email", "password", "confirmPassword"]
+      },
+      {
+        "id": "personalInfo",
+        "title": "Personal Information",
+        "fields": ["firstName", "lastName", "dateOfBirth"]
+      },
+      {
+        "id": "preferences",
+        "title": "Preferences",
+        "fields": ["newsletter", "termsAccepted"]
+      }
+    ],
+    "fields": {
+      "email": {
+        "type": "email",
+        "label": "Email Address",
+        "placeholder": "user@example.com",
+        "validation": {
+          "required": true,
+          "email": true,
+          "asyncValidation": {
+            "apiUrl": "/api/check-email",
+            "queryParams": [{ "key": "email" }],
+            "debounce": 500,
+            "message": "This email is already registered"
+          },
+          "messages": {
+            "required": "Email is required",
+            "email": "Please enter a valid email address"
+          }
+        }
+      },
+      "password": {
+        "type": "password",
+        "label": "Password",
+        "validation": {
+          "required": true,
+          "minLength": 8,
+          "hasUppercase": true,
+          "hasLowercase": true,
+          "hasNumber": true,
+          "hasSpecialChar": true,
+          "messages": {
+            "required": "Password is required",
+            "minLength": "Password must be at least 8 characters",
+            "hasUppercase": "Must contain at least one uppercase letter",
+            "hasLowercase": "Must contain at least one lowercase letter",
+            "hasNumber": "Must contain at least one digit",
+            "hasSpecialChar": "Must contain at least one special character"
+          }
+        }
+      },
+      "confirmPassword": {
+        "type": "password",
+        "label": "Confirm Password",
+        "validation": {
+          "required": true,
+          "matchField": "password",
+          "messages": {
+            "required": "Please confirm your password",
+            "matchField": "Passwords do not match"
+          }
+        }
+      },
+      "firstName": {
+        "type": "text",
+        "label": "First Name",
+        "validation": {
+          "required": true,
+          "minLength": 2,
+          "maxLength": 50
+        }
+      },
+      "lastName": {
+        "type": "text",
+        "label": "Last Name",
+        "validation": {
+          "required": true,
+          "minLength": 2,
+          "maxLength": 50
+        }
+      },
+      "dateOfBirth": {
+        "type": "date",
+        "label": "Date of Birth",
+        "format": "dd/MM/yyyy",
+        "validation": {
+          "required": true
+        }
+      },
+      "newsletter": {
+        "type": "switch",
+        "label": "Subscribe to newsletter",
+        "defaultValue": false
+      },
+      "termsAccepted": {
+        "type": "checkbox",
+        "label": "I accept the Terms of Service and Privacy Policy",
+        "defaultValue": false,
+        "validation": {
+          "required": true,
+          "messages": {
+            "required": "You must accept the terms to continue"
+          }
+        }
+      }
+    }
+  }
+}
+