@ng-forge/dynamic-form-mcp 0.5.1

package/src/registry/field-types.json

@@ -0,0 +1,490 @@
+[
+  {
+    "type": "input",
+    "category": "value",
+    "description": "Text-based input field with HTML5 type support (text, email, password, number, tel, url)",
+    "valueType": "string | number",
+    "baseInterface": "BaseValueField",
+    "props": {
+      "type": {
+        "name": "type",
+        "type": "'text' | 'email' | 'password' | 'number' | 'tel' | 'url'",
+        "description": "HTML input type",
+        "required": false,
+        "default": "text"
+      },
+      "placeholder": {
+        "name": "placeholder",
+        "type": "DynamicText",
+        "description": "Placeholder text displayed when field is empty",
+        "required": false
+      }
+    },
+    "validationSupported": true,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'email',\n  type: 'input',\n  label: 'Email Address',\n  required: true,\n  email: true,\n  props: { type: 'email', placeholder: 'user@example.com' }\n}",
+    "minimalExample": "{ key: 'name', type: 'input', label: 'Name' }"
+  },
+  {
+    "type": "textarea",
+    "category": "value",
+    "description": "Multi-line text input field for longer content",
+    "valueType": "string",
+    "baseInterface": "BaseValueField",
+    "props": {
+      "rows": {
+        "name": "rows",
+        "type": "number",
+        "description": "Number of visible text lines",
+        "required": false,
+        "default": 3
+      },
+      "placeholder": {
+        "name": "placeholder",
+        "type": "DynamicText",
+        "description": "Placeholder text displayed when field is empty",
+        "required": false
+      }
+    },
+    "validationSupported": true,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'description',\n  type: 'textarea',\n  label: 'Description',\n  props: { rows: 5, placeholder: 'Enter description...' }\n}",
+    "minimalExample": "{ key: 'bio', type: 'textarea', label: 'Bio' }"
+  },
+  {
+    "type": "select",
+    "category": "value",
+    "description": "Dropdown selection field with single or multiple selection",
+    "valueType": "T | T[]",
+    "baseInterface": "BaseValueField",
+    "props": {
+      "options": {
+        "name": "options",
+        "type": "FieldOption[]",
+        "description": "Array of selectable options with label and value. IMPORTANT: options goes at FIELD level, NOT inside props",
+        "required": true
+      },
+      "multiple": {
+        "name": "multiple",
+        "type": "boolean",
+        "description": "Allow multiple selections",
+        "required": false,
+        "default": false
+      },
+      "placeholder": {
+        "name": "placeholder",
+        "type": "DynamicText",
+        "description": "Placeholder text for empty selection",
+        "required": false
+      }
+    },
+    "validationSupported": true,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'country',\n  type: 'select',\n  label: 'Country',\n  required: true,\n  options: [\n    { label: 'United States', value: 'us' },\n    { label: 'Canada', value: 'ca' }\n  ]\n}",
+    "minimalExample": "{ key: 'status', type: 'select', label: 'Status', options: [{ label: 'Active', value: 'active' }] }"
+  },
+  {
+    "type": "checkbox",
+    "category": "value",
+    "description": "Boolean toggle checkbox field",
+    "valueType": "boolean",
+    "baseInterface": "BaseCheckedField",
+    "props": {},
+    "validationSupported": true,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'acceptTerms',\n  type: 'checkbox',\n  label: 'I accept the terms and conditions',\n  required: true\n}",
+    "minimalExample": "{ key: 'agree', type: 'checkbox', label: 'I agree' }"
+  },
+  {
+    "type": "multi-checkbox",
+    "category": "value",
+    "description": "Multiple checkbox group for selecting multiple values from options",
+    "valueType": "T[]",
+    "baseInterface": "BaseValueField",
+    "props": {
+      "options": {
+        "name": "options",
+        "type": "FieldOption[]",
+        "description": "Array of selectable options. IMPORTANT: options goes at FIELD level, NOT inside props",
+        "required": true
+      }
+    },
+    "validationSupported": true,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'interests',\n  type: 'multi-checkbox',\n  label: 'Select your interests',\n  options: [\n    { label: 'Sports', value: 'sports' },\n    { label: 'Music', value: 'music' },\n    { label: 'Art', value: 'art' },\n    { label: 'Technology', value: 'tech' }\n  ]\n}",
+    "minimalExample": "{ key: 'tags', type: 'multi-checkbox', label: 'Tags', options: [{ label: 'A', value: 'a' }] }"
+  },
+  {
+    "type": "radio",
+    "category": "value",
+    "description": "Radio button group for single selection from options",
+    "valueType": "T",
+    "baseInterface": "BaseValueField",
+    "props": {
+      "options": {
+        "name": "options",
+        "type": "FieldOption[]",
+        "description": "Array of selectable options. IMPORTANT: options goes at FIELD level, NOT inside props",
+        "required": true
+      }
+    },
+    "validationSupported": true,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'gender',\n  type: 'radio',\n  label: 'Gender',\n  options: [\n    { label: 'Male', value: 'male' },\n    { label: 'Female', value: 'female' },\n    { label: 'Other', value: 'other' }\n  ]\n}",
+    "minimalExample": "{ key: 'choice', type: 'radio', label: 'Choice', options: [{ label: 'Yes', value: 'yes' }, { label: 'No', value: 'no' }] }"
+  },
+  {
+    "type": "datepicker",
+    "category": "value",
+    "description": "Date selection field with calendar picker",
+    "valueType": "Date | string",
+    "baseInterface": "BaseValueField",
+    "props": {
+      "minDate": {
+        "name": "minDate",
+        "type": "Date | string",
+        "description": "Minimum selectable date",
+        "required": false
+      },
+      "maxDate": {
+        "name": "maxDate",
+        "type": "Date | string",
+        "description": "Maximum selectable date",
+        "required": false
+      }
+    },
+    "validationSupported": true,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'birthDate',\n  type: 'datepicker',\n  label: 'Date of Birth',\n  required: true,\n  props: { maxDate: new Date() }\n}",
+    "minimalExample": "{ key: 'date', type: 'datepicker', label: 'Date' }"
+  },
+  {
+    "type": "toggle",
+    "category": "value",
+    "description": "Switch/toggle control for boolean values",
+    "valueType": "boolean",
+    "baseInterface": "BaseCheckedField",
+    "props": {},
+    "validationSupported": true,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'notifications',\n  type: 'toggle',\n  label: 'Enable notifications'\n}",
+    "minimalExample": "{ key: 'enabled', type: 'toggle', label: 'Enable' }"
+  },
+  {
+    "type": "slider",
+    "category": "value",
+    "description": "Numeric range slider for value selection",
+    "valueType": "number",
+    "baseInterface": "BaseValueField",
+    "props": {
+      "minValue": {
+        "name": "minValue",
+        "type": "number",
+        "description": "Minimum value. IMPORTANT: This is at FIELD level, NOT inside props",
+        "required": false,
+        "default": 0
+      },
+      "maxValue": {
+        "name": "maxValue",
+        "type": "number",
+        "description": "Maximum value. IMPORTANT: This is at FIELD level, NOT inside props",
+        "required": false,
+        "default": 100
+      },
+      "step": {
+        "name": "step",
+        "type": "number",
+        "description": "Step increment. IMPORTANT: This is at FIELD level, NOT inside props",
+        "required": false,
+        "default": 1
+      }
+    },
+    "validationSupported": true,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'volume',\n  type: 'slider',\n  label: 'Volume',\n  value: 50,\n  minValue: 0,\n  maxValue: 100,\n  step: 5\n}",
+    "minimalExample": "{ key: 'rating', type: 'slider', label: 'Rating' }"
+  },
+  {
+    "type": "hidden",
+    "category": "value",
+    "description": "Hidden field that participates in form values without rendering. REQUIRED: The \"value\" property MUST be provided (string, number, boolean, or array). FORBIDDEN: label, logic, validators, required, props, disabled, readonly, hidden, col, tabIndex, meta - hidden fields are purely for passing values through the form. IMPORTANT: In multi-page forms, hidden fields must go INSIDE a page, not at the root level.",
+    "valueType": "string | number | boolean | (string | number | boolean)[]",
+    "baseInterface": "FieldDef",
+    "props": {},
+    "validationSupported": false,
+    "source": "core",
+    "allowedIn": ["top-level (single-page forms only)", "page.fields", "group.fields", "array.fields"],
+    "notAllowedIn": ["row", "top-level when using pages"],
+    "example": "// Hidden field - value is REQUIRED!\n{\n  key: 'userId',\n  type: 'hidden',\n  value: 'abc123'  // REQUIRED: string, number, boolean, or array\n}\n\n// Valid value types:\n{ key: 'count', type: 'hidden', value: 42 }           // number\n{ key: 'active', type: 'hidden', value: true }        // boolean\n{ key: 'tags', type: 'hidden', value: [1, 2, 3] }     // array\n\n// ❌ FORBIDDEN (will cause validation error):\n// - label, logic, validators, required, props\n// - disabled, readonly, hidden, col, tabIndex, meta\n// - Validation shorthand: email, min, max, minLength, maxLength, pattern",
+    "minimalExample": "{ key: 'id', type: 'hidden', value: 'abc123' }"
+  },
+  {
+    "type": "text",
+    "category": "display",
+    "description": "Static text display element (headings, paragraphs, spans). The text content comes from the label property.",
+    "baseInterface": "FieldDef",
+    "props": {
+      "elementType": {
+        "name": "elementType",
+        "type": "'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'span'",
+        "description": "HTML element type for rendering",
+        "required": false,
+        "default": "p"
+      }
+    },
+    "validationSupported": false,
+    "source": "core",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'sectionTitle',\n  type: 'text',\n  label: 'Personal Information',\n  props: { elementType: 'h2' }\n}",
+    "minimalExample": "{ key: 'header', type: 'text', label: 'Section Title' }"
+  },
+  {
+    "type": "row",
+    "category": "container",
+    "description": "Horizontal layout container for grouping fields in columns. Rows do NOT have a label property and do NOT support logic blocks.",
+    "baseInterface": "FieldDef",
+    "props": {
+      "fields": {
+        "name": "fields",
+        "type": "RowAllowedChildren[]",
+        "description": "Child fields to render horizontally. Allowed: groups, arrays, VALUE fields (input, select, etc). NOT ALLOWED: pages, rows, hidden fields",
+        "required": true
+      }
+    },
+    "validationSupported": false,
+    "source": "core",
+    "allowedIn": ["top-level", "page", "group", "array"],
+    "notAllowedIn": ["row"],
+    "canContain": [
+      "group",
+      "array",
+      "input",
+      "textarea",
+      "select",
+      "checkbox",
+      "multi-checkbox",
+      "radio",
+      "datepicker",
+      "toggle",
+      "slider",
+      "text",
+      "button",
+      "submit",
+      "next",
+      "previous"
+    ],
+    "cannotContain": ["page", "row", "hidden"],
+    "example": "{\n  key: 'nameRow',\n  type: 'row',\n  // NOTE: Rows do NOT have label or logic properties\n  fields: [\n    { key: 'firstName', type: 'input', label: 'First Name', col: 6 },\n    { key: 'lastName', type: 'input', label: 'Last Name', col: 6 }\n  ]\n}\n// NOT ALLOWED in rows:\n// - type: 'hidden' (hidden fields cannot be inside rows)\n// - type: 'page' (pages are top-level only)\n// - type: 'row' (no nested rows)",
+    "minimalExample": "{ key: 'row1', type: 'row', fields: [...] }"
+  },
+  {
+    "type": "group",
+    "category": "container",
+    "description": "Nested form group container creating a sub-object in form values. Groups are logical containers only and do NOT have a label property.",
+    "valueType": "object",
+    "baseInterface": "FieldDef",
+    "props": {
+      "fields": {
+        "name": "fields",
+        "type": "GroupAllowedChildren[]",
+        "description": "Child fields in the group. Allowed: rows, leaf fields (NOT pages or other groups)",
+        "required": true
+      }
+    },
+    "validationSupported": true,
+    "source": "core",
+    "allowedIn": ["top-level", "page", "row", "array"],
+    "notAllowedIn": ["group"],
+    "canContain": [
+      "row",
+      "input",
+      "textarea",
+      "select",
+      "checkbox",
+      "multi-checkbox",
+      "radio",
+      "datepicker",
+      "toggle",
+      "slider",
+      "hidden",
+      "text",
+      "button",
+      "submit",
+      "next",
+      "previous"
+    ],
+    "cannotContain": ["page", "group"],
+    "example": "{\n  key: 'address',\n  type: 'group',\n  // NOTE: Groups do NOT have a label property\n  fields: [\n    { key: 'street', type: 'input', label: 'Street' },\n    { key: 'city', type: 'input', label: 'City' },\n    { key: 'zip', type: 'input', label: 'ZIP Code' }\n  ]\n}",
+    "minimalExample": "{ key: 'address', type: 'group', fields: [...] }"
+  },
+  {
+    "type": "array",
+    "category": "container",
+    "description": "Repeatable field group for dynamic lists/arrays. Arrays do NOT have label, minItems, or maxItems properties. Use \"fields\" (not \"template\") to define the item template.",
+    "valueType": "T[]",
+    "baseInterface": "FieldDef",
+    "props": {
+      "fields": {
+        "name": "fields",
+        "type": "ArrayAllowedChildren[]",
+        "description": "Template field(s) for each array item. Allowed: rows, groups, leaf fields (NOT pages or other arrays)",
+        "required": true
+      }
+    },
+    "validationSupported": false,
+    "source": "core",
+    "allowedIn": ["top-level", "page", "row", "group"],
+    "notAllowedIn": ["array"],
+    "canContain": [
+      "row",
+      "group",
+      "input",
+      "textarea",
+      "select",
+      "checkbox",
+      "multi-checkbox",
+      "radio",
+      "datepicker",
+      "toggle",
+      "slider",
+      "hidden",
+      "text",
+      "button",
+      "submit",
+      "next",
+      "previous"
+    ],
+    "cannotContain": ["page", "array"],
+    "example": "// Flat array (primitive values)\n{\n  key: 'tags',\n  type: 'array',\n  // NOTE: Arrays do NOT have label, minItems, or maxItems\n  fields: [\n    { key: 'tag', type: 'input', label: 'Tag' }\n  ]\n}\n// Result: { tags: ['value1', 'value2'] }\n\n// Object array (nested groups)\n{\n  key: 'contacts',\n  type: 'array',\n  fields: [{\n    type: 'group',\n    fields: [\n      { key: 'name', type: 'input', label: 'Name' },\n      { key: 'email', type: 'input', label: 'Email' }\n    ]\n  }]\n}\n// Result: { contacts: [{name: '', email: ''}, ...] }",
+    "minimalExample": "{ key: 'items', type: 'array', fields: [...] }"
+  },
+  {
+    "type": "page",
+    "category": "container",
+    "description": "Multi-step form page container for wizard-style forms. Pages do NOT have label or title properties. ALL top-level fields must be pages if using multi-page mode. IMPORTANT: Navigation buttons (next, previous) must be added as fields WITHIN each page that needs them.",
+    "baseInterface": "FieldDef",
+    "props": {
+      "fields": {
+        "name": "fields",
+        "type": "PageAllowedChildren[]",
+        "description": "Fields in this page. Allowed: rows, groups, arrays, leaf fields (NOT other pages). Include next/previous buttons as needed.",
+        "required": true
+      }
+    },
+    "validationSupported": false,
+    "source": "core",
+    "allowedIn": ["top-level"],
+    "notAllowedIn": ["page", "row", "group", "array"],
+    "canContain": [
+      "row",
+      "group",
+      "array",
+      "input",
+      "textarea",
+      "select",
+      "checkbox",
+      "multi-checkbox",
+      "radio",
+      "datepicker",
+      "toggle",
+      "slider",
+      "hidden",
+      "text",
+      "button",
+      "submit",
+      "next",
+      "previous"
+    ],
+    "cannotContain": ["page"],
+    "example": "{\n  key: 'step1',\n  type: 'page',\n  // NOTE: Pages do NOT have label or title properties\n  // Navigation buttons are fields WITHIN the page\n  fields: [\n    { key: 'firstName', type: 'input', label: 'First Name' },\n    { key: 'lastName', type: 'input', label: 'Last Name' },\n    { key: 'next', type: 'next', label: 'Next' }\n  ]\n}",
+    "minimalExample": "{ key: 'step1', type: 'page', fields: [...] }"
+  },
+  {
+    "type": "next",
+    "category": "button",
+    "description": "Navigation button to go to next page in multi-step forms. Must be placed INSIDE a page's fields array.",
+    "baseInterface": "FieldDef",
+    "props": {},
+    "validationSupported": false,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'next',\n  type: 'next',\n  label: 'Next'\n}",
+    "minimalExample": "{ key: 'next', type: 'next', label: 'Next' }"
+  },
+  {
+    "type": "previous",
+    "category": "button",
+    "description": "Navigation button to go to previous page in multi-step forms. Must be placed INSIDE a page's fields array.",
+    "baseInterface": "FieldDef",
+    "props": {},
+    "validationSupported": false,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'back',\n  type: 'previous',\n  label: 'Back'\n}",
+    "minimalExample": "{ key: 'back', type: 'previous', label: 'Back' }"
+  },
+  {
+    "type": "button",
+    "category": "button",
+    "description": "Generic button for custom actions. IMPORTANT: The generic 'button' type REQUIRES the 'event' property with a FormEventConstructor. For simple use cases, prefer 'submit', 'next', or 'previous' which don't require event configuration.",
+    "baseInterface": "FieldDef",
+    "props": {
+      "event": {
+        "name": "event",
+        "type": "FormEventConstructor<TEvent>",
+        "description": "REQUIRED. Event constructor that will be emitted when button is clicked. Must be registered with provideFormEvents().",
+        "required": true
+      }
+    },
+    "validationSupported": false,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "// RECOMMENDED: Use pre-defined button types for common actions\n{ key: 'submit', type: 'submit', label: 'Submit Form' }\n{ key: 'next', type: 'next', label: 'Next' }\n{ key: 'back', type: 'previous', label: 'Back' }\n\n// ADVANCED: Generic button with custom event (requires setup)\n// 1. Create event class: class MyCustomEvent extends FormEvent {}\n// 2. Register with: provideFormEvents([MyCustomEvent])\n// 3. Use in config:\n{\n  key: 'customAction',\n  type: 'button',\n  label: 'Custom Action',\n  event: MyCustomEvent  // Must be the class reference\n}",
+    "minimalExample": "{ key: 'action', type: 'button', label: 'Action', event: MyEvent }"
+  },
+  {
+    "type": "submit",
+    "category": "button",
+    "description": "Form submit button",
+    "baseInterface": "FieldDef",
+    "props": {},
+    "validationSupported": false,
+    "source": "adapter",
+    "allowedIn": ["top-level", "page", "row", "group", "array"],
+    "example": "{\n  key: 'submit',\n  type: 'submit',\n  label: 'Submit Form'\n}",
+    "minimalExample": "{ key: 'submit', type: 'submit', label: 'Submit' }"
+  },
+  {
+    "type": "addArrayItem",
+    "category": "button",
+    "description": "Button to add a new item to an array field. Must be placed within or near the array container.",
+    "baseInterface": "FieldDef",
+    "props": {},
+    "validationSupported": false,
+    "source": "adapter",
+    "allowedIn": ["array", "row", "group"],
+    "example": "{\n  key: 'addContact',\n  type: 'addArrayItem',\n  label: 'Add Contact'\n}",
+    "minimalExample": "{ key: 'add', type: 'addArrayItem', label: 'Add Item' }"
+  },
+  {
+    "type": "removeArrayItem",
+    "category": "button",
+    "description": "Button to remove the current item from an array field. Typically placed within each array item template.",
+    "baseInterface": "FieldDef",
+    "props": {},
+    "validationSupported": false,
+    "source": "adapter",
+    "allowedIn": ["array", "row", "group"],
+    "example": "{\n  key: 'removeContact',\n  type: 'removeArrayItem',\n  label: 'Remove'\n}",
+    "minimalExample": "{ key: 'remove', type: 'removeArrayItem', label: 'Remove' }"
+  }
+]

package/src/registry/index.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Registry module for loading generated JSON metadata
+ *
+ * This module provides access to field types, validators, and UI adapters
+ * that are generated at build time from the ng-forge packages.
+ *
+ * JSON data is imported directly to work correctly with esbuild bundling.
+ */
+export interface PropertyInfo {
+    name: string;
+    type: string;
+    description: string;
+    required: boolean;
+    default?: unknown;
+}
+export interface FieldTypeInfo {
+    type: string;
+    category: 'value' | 'container' | 'button' | 'display';
+    description: string;
+    valueType?: string;
+    baseInterface?: string;
+    props: Record<string, PropertyInfo>;
+    validationSupported: boolean;
+    example: string;
+    /** Field types that this container can contain (for containers only) */
+    canContain?: string[];
+    /** Field types that this container CANNOT contain (for containers only) */
+    cannotContain?: string[];
+    /** Where this field type is allowed to be placed */
+    allowedIn?: string[];
+    /** Where this field type is NOT allowed to be placed */
+    notAllowedIn?: string[];
+    /** Whether this field type is part of core library or requires an adapter */
+    source: 'core' | 'adapter';
+    /** Minimal valid example (just required properties) */
+    minimalExample?: string;
+}
+export interface ValidatorInfo {
+    type: string;
+    category: 'built-in' | 'custom' | 'async' | 'http';
+    description: string;
+    parameters: Record<string, PropertyInfo>;
+    example: string;
+}
+export interface UIAdapterFieldType {
+    type: string;
+    componentName: string;
+    additionalProps: Record<string, PropertyInfo>;
+}
+export interface UIAdapterInfo {
+    library: string;
+    package: string;
+    fieldTypes: UIAdapterFieldType[];
+    providerFunction: string;
+}
+export interface DocTopic {
+    id: string;
+    title: string;
+    category: string;
+    content: string;
+}
+/**
+ * Get all available field types
+ */
+export declare function getFieldTypes(): FieldTypeInfo[];
+/**
+ * Get a specific field type by name
+ */
+export declare function getFieldType(type: string): FieldTypeInfo | undefined;
+/**
+ * Get field types by category
+ */
+export declare function getFieldTypesByCategory(category: 'value' | 'container' | 'button' | 'display'): FieldTypeInfo[];
+/**
+ * Get all available validators
+ */
+export declare function getValidators(): ValidatorInfo[];
+/**
+ * Get a specific validator by type
+ */
+export declare function getValidator(type: string): ValidatorInfo | undefined;
+/**
+ * Get validators by category
+ */
+export declare function getValidatorsByCategory(category: 'built-in' | 'custom' | 'async' | 'http'): ValidatorInfo[];
+/**
+ * Get all UI adapters
+ */
+export declare function getUIAdapters(): UIAdapterInfo[];
+/**
+ * Get a specific UI adapter by library name
+ */
+export declare function getUIAdapter(library: 'material' | 'bootstrap' | 'primeng' | 'ionic'): UIAdapterInfo | undefined;
+/**
+ * Get UI adapter field type configuration
+ */
+export declare function getUIAdapterFieldType(library: 'material' | 'bootstrap' | 'primeng' | 'ionic', fieldType: string): UIAdapterFieldType | undefined;
+/**
+ * Get all documentation topics
+ */
+export declare function getDocs(): DocTopic[];
+/**
+ * Get a specific documentation topic by ID
+ */
+export declare function getDoc(id: string): DocTopic | undefined;
+/**
+ * Get documentation topics by category
+ */
+export declare function getDocsByCategory(category: string): DocTopic[];
+//# sourceMappingURL=index.d.ts.map

package/src/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/dynamic-form-mcp/src/registry/index.ts"],"names":[],"mappings":"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"}

package/src/registry/instructions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ng-forge Best Practices
+ *
+ * This content is served via the ng-forge://instructions resource
+ * to guide AI assistants in generating FormConfig objects.
+ */
+export declare const INSTRUCTIONS = "# ng-forge Dynamic Forms - Best Practices\n\nYou MUST follow these practices when generating FormConfig objects for ng-forge.\n\n## Core Principles\n\n1. **Configuration-driven**: ng-forge wraps Angular Reactive Forms. Define structure declaratively via `FormConfig`, not imperatively.\n2. **Type-safe**: Use TypeScript interfaces for form values. The library provides full type inference.\n3. **Validation-first**: Always include validation and user-friendly error messages.\n\n## FormConfig Structure\n\n```typescript\nconst config: FormConfig = {\n  // Optional: Default validation messages for all fields\n  defaultValidationMessages: {\n    required: 'This field is required',\n    email: 'Please enter a valid email',\n    minLength: 'Must be at least {{requiredLength}} characters',\n  },\n  // Required: Array of field definitions\n  fields: [\n    // ... field definitions\n  ],\n};\n```\n\n## Field Definition Rules\n\n### Required Properties\n\nEvery field MUST have:\n\n- `key`: Unique identifier (except for `row` type which is layout-only)\n- `type`: One of the registered field types\n- `label`: Human-readable label (for accessibility)\n\n### Value Fields\n\nFor fields that collect user input (`input`, `textarea`, `select`, `checkbox`, `radio`, `datepicker`, `toggle`, `slider`):\n\n```typescript\n{\n  key: 'email',\n  type: 'input',\n  label: 'Email Address',\n  required: true,           // Shorthand validator\n  email: true,              // Shorthand validator\n  validationMessages: {     // Always provide clear messages\n    required: 'Email is required',\n    email: 'Please enter a valid email'\n  },\n  props: {\n    type: 'email',          // HTML input type\n    placeholder: 'user@example.com',\n    hint: 'We will never share your email'  // UI library specific\n  }\n}\n```\n\n### Select/Radio Fields\n\nMUST include `options` array:\n\n```typescript\n{\n  key: 'country',\n  type: 'select',\n  label: 'Country',\n  required: true,\n  options: [\n    { value: 'us', label: 'United States' },\n    { value: 'uk', label: 'United Kingdom' }\n  ],\n  props: { placeholder: 'Select a country' }\n}\n```\n\n### Container Fields\n\n#### Row (Horizontal Layout)\n\nUse for side-by-side fields. Row fields do NOT create nested values - children are flat.\n\n```typescript\n{\n  key: 'nameRow',\n  type: 'row',\n  fields: [\n    { key: 'firstName', type: 'input', label: 'First', col: 6 },\n    { key: 'lastName', type: 'input', label: 'Last', col: 6 }\n  ]\n}\n// Result: { firstName: '...', lastName: '...' }\n```\n\nUse `col` property (1-12) to control column widths.\n\n#### Group (Nested Object)\n\nUse when you need nested object structure in form values:\n\n```typescript\n{\n  key: 'address',\n  type: 'group',\n  fields: [\n    { key: 'street', type: 'input', label: 'Street' },\n    { key: 'city', type: 'input', label: 'City' }\n  ]\n}\n// Result: { address: { street: '...', city: '...' } }\n```\n\n#### Array (Repeatable Items)\n\nUse for dynamic lists:\n\n```typescript\n{\n  key: 'contacts',\n  type: 'array',\n  label: 'Emergency Contacts',\n  fields: [\n    {\n      key: 'contact',\n      type: 'group',\n      fields: [\n        { key: 'name', type: 'input', label: 'Name', required: true },\n        { key: 'phone', type: 'input', label: 'Phone', required: true }\n      ]\n    }\n  ]\n}\n// Result: { contacts: [{ name: '...', phone: '...' }, ...] }\n```\n\n#### Page (Multi-step Forms)\n\nUse for wizard-style forms:\n\n```typescript\n{\n  fields: [\n    {\n      key: 'step1',\n      type: 'page',\n      fields: [\n        { key: 'name', type: 'input', label: 'Name' },\n        { key: 'next', type: 'next', label: 'Continue' },\n      ],\n    },\n    {\n      key: 'step2',\n      type: 'page',\n      fields: [\n        { key: 'prev', type: 'previous', label: 'Back' },\n        { key: 'submit', type: 'submit', label: 'Submit' },\n      ],\n    },\n  ];\n}\n```\n\n## Validation\n\n### Shorthand Validators (Preferred)\n\nUse shorthand properties directly on field definitions:\n\n```typescript\n{\n  key: 'age',\n  type: 'input',\n  label: 'Age',\n  required: true,\n  min: 18,\n  max: 120,\n  validationMessages: {\n    required: 'Age is required',\n    min: 'Must be at least {{min}}',\n    max: 'Cannot exceed {{max}}'\n  }\n}\n```\n\nAvailable shorthands: `required`, `email`, `min`, `max`, `minLength`, `maxLength`, `pattern`\n\n### Validation Messages\n\nALWAYS provide validation messages. Use template variables:\n\n- `{{requiredLength}}` - for minLength/maxLength\n- `{{min}}`, `{{max}}` - for min/max\n- `{{requiredPattern}}` - for pattern\n\n## Conditional Logic\n\nUse `logic` array for conditional behavior:\n\n```typescript\n{\n  key: 'businessName',\n  type: 'input',\n  label: 'Business Name',\n  logic: [\n    {\n      type: 'hidden',\n      condition: {\n        type: 'fieldValue',\n        fieldPath: 'accountType',\n        operator: 'notEquals',\n        value: 'business'\n      }\n    },\n    {\n      type: 'required',\n      condition: {\n        type: 'fieldValue',\n        fieldPath: 'accountType',\n        operator: 'equals',\n        value: 'business'\n      }\n    }\n  ]\n}\n```\n\n### Logic Types\n\n- `hidden` - Show/hide field\n- `disabled` - Enable/disable field\n- `required` - Conditional requirement\n\n### Condition Operators\n\n- `equals`, `notEquals`\n- `greaterThan`, `lessThan`, `greaterThanOrEquals`, `lessThanOrEquals`\n- `contains`, `notContains`\n- `empty`, `notEmpty`\n\n## UI Library Integration\n\nng-forge supports multiple UI libraries. Configure in `app.config.ts`:\n\n```typescript\nimport { provideDynamicForm } from '@ng-forge/dynamic-forms';\nimport { withMaterialFields } from '@ng-forge/dynamic-forms-material';\n\nexport const appConfig = {\n  providers: [provideDynamicForm(...withMaterialFields())],\n};\n```\n\nAvailable adapters:\n\n- `@ng-forge/dynamic-forms-material` - Angular Material\n- `@ng-forge/dynamic-forms-bootstrap` - Bootstrap 5\n- `@ng-forge/dynamic-forms-primeng` - PrimeNG\n- `@ng-forge/dynamic-forms-ionic` - Ionic\n\n## Common Patterns\n\n### Always End with Submit Button\n\n```typescript\n{ type: 'submit', key: 'submit', label: 'Submit', props: { color: 'primary' } }\n```\n\n### Use Text Fields for Headings\n\n```typescript\n{ key: 'sectionTitle', type: 'text', label: 'Personal Info', props: { elementType: 'h3' } }\n```\n\n### Input Types via Props\n\n```typescript\n// Email input\n{ key: 'email', type: 'input', props: { type: 'email' } }\n\n// Password input\n{ key: 'password', type: 'input', props: { type: 'password' } }\n\n// Number input\n{ key: 'age', type: 'input', props: { type: 'number' } }\n\n// Phone input\n{ key: 'phone', type: 'input', props: { type: 'tel' } }\n```\n\n## Anti-patterns to Avoid\n\n1. **Missing labels** - Always include labels for accessibility\n2. **Missing validation messages** - Users need clear feedback\n3. **Duplicate keys** - Each key must be unique within its scope\n4. **Select without options** - Select/radio fields must have options\n5. **Array without fields** - Array fields need a fields template\n6. **Group without fields** - Group fields need child fields\n7. **min > max** - Ensure min values are less than max values\n\n## CRITICAL: UI Library Differences\n\nDifferent UI libraries support different properties. Always validate against the correct library using `ngforge_validate_form_config` with the appropriate `uiIntegration` parameter.\n\n### Property Differences by Library\n\n| Property | Material | Bootstrap | PrimeNG | Ionic |\n|----------|----------|-----------|---------|-------|\n| `appearance` | \u2713 (fill, outline) | \u2717 | \u2717 | \u2713 (fill, outline) |\n| `subscriptSizing` | \u2713 | \u2717 | \u2717 | \u2717 |\n| `floatLabel` | \u2713 | \u2717 | \u2713 | \u2717 |\n| `hint` | \u2713 | \u2713 (as `helpText`) | \u2713 | \u2713 |\n\n### Container Fields\n\nContainer fields (`page`, `group`, `row`) do NOT support these properties:\n- `label` - Use `text` field type for headings instead\n- `required`, `email`, `min`, `max`, etc. - Validation is for leaf fields only\n\n### Common Mistakes to Avoid\n\n1. **Using `expressions` on fields** - This property is NOT supported on standard fields. Use `derivation` for computed values or `logic` for conditional behavior.\n\n2. **Adding `label` to container fields** - Pages, groups, and rows don't have labels:\n   ```typescript\n   // \u274C WRONG\n   { key: 'address', type: 'group', label: 'Address', fields: [...] }\n\n   // \u2705 CORRECT - Use a text field for the heading\n   { key: 'addressTitle', type: 'text', label: 'Address', props: { elementType: 'h3' } }\n   { key: 'address', type: 'group', fields: [...] }\n   ```\n\n3. **Adding `id` to FormConfig** - The root FormConfig does not accept an `id` property.\n\n4. **Putting slider min/max in props** - For slider fields, `min`, `max`, and `step` are field-level properties:\n   ```typescript\n   // \u274C WRONG\n   { key: 'volume', type: 'slider', label: 'Volume', props: { min: 0, max: 100 } }\n\n   // \u2705 CORRECT\n   { key: 'volume', type: 'slider', label: 'Volume', min: 0, max: 100 }\n   ```\n\n5. **Using unsupported field types** - Each UI library supports specific field types. Use `ngforge_get_field_schema` to see available types.\n\n## Validation Before Use\n\nAlways validate your FormConfig using the `ngforge_validate_form_config` tool before using it. This tool uses the actual TypeScript/Zod schemas, so if validation passes, the config will work correctly at runtime.\n\n```typescript\n// Always specify the UI integration you're using\nngforge_validate_form_config({\n  uiIntegration: 'material',  // or 'bootstrap', 'primeng', 'ionic'\n  config: { fields: [...] }\n})\n```\n\nTo understand what properties are supported for each field type, use `ngforge_get_field_schema`:\n\n```typescript\nngforge_get_field_schema({ uiIntegration: 'material' })\n```\n";
+//# sourceMappingURL=instructions.d.ts.map

package/src/registry/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../../../packages/dynamic-form-mcp/src/registry/instructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,4rTA4WxB,CAAC"}