@ng-forge/dynamic-form-mcp 0.5.1 → 0.6.0

package/src/registry/api-reference.json

@@ -6,9 +6,9 @@
     "columns": ["hidden", "disabled", "required", "readonly", "derivation"],
     "fields": {
       "page": ["Y", "N", "N", "N", "N"],
-      "group": ["N", "N", "N", "N", "N"],
-      "row": ["N", "N", "N", "N", "N"],
-      "array": ["N", "N", "N", "N", "N"],
+      "group": ["Y", "N", "N", "N", "N"],
+      "row": ["Y", "N", "N", "N", "N"],
+      "array": ["Y", "N", "N", "N", "N"],
       "input": ["Y", "Y", "Y", "Y", "Y"],
       "select": ["Y", "Y", "Y", "Y", "Y"],
       "checkbox": ["Y", "Y", "Y", "Y", "Y"],
@@ -56,7 +56,8 @@
     },
     "group": {
       "hasLabel": false,
-      "supportsLogic": false,
+      "supportsLogic": true,
+      "logicTypes": ["hidden"],
       "allowedChildren": [
         "row",
         "input",
@@ -78,7 +79,8 @@
     },
     "row": {
       "hasLabel": false,
-      "supportsLogic": false,
+      "supportsLogic": true,
+      "logicTypes": ["hidden"],
       "allowedChildren": [
         "group",
         "array",
@@ -100,7 +102,8 @@
     },
     "array": {
       "hasLabel": false,
-      "supportsLogic": false,
+      "supportsLogic": true,
+      "logicTypes": ["hidden"],
       "allowedChildren": [
         "row",
         "group",
@@ -116,7 +119,7 @@
         "text"
       ],
       "notAllowedChildren": ["page", "array", "hidden"],
-      "notes": "Use 'fields' (NOT 'template'). No minItems/maxItems properties."
+      "notes": "Use 'fields' (NOT 'template'). Supports minLength/maxLength for array size validation."
     }
   },
   "fieldReference": {
@@ -141,7 +144,10 @@
         "col",
         "logic",
         "validators",
-        "validationMessages"
+        "validationMessages",
+        "excludeValueIfHidden",
+        "excludeValueIfDisabled",
+        "excludeValueIfReadonly"
       ],
       "propsObject": ["type", "placeholder", "appearance", "hint"],
       "copyPaste": "{ type: 'input', key: 'name', label: 'Name', value: '' }",
@@ -164,7 +170,10 @@
         "col",
         "logic",
         "validators",
-        "validationMessages"
+        "validationMessages",
+        "excludeValueIfHidden",
+        "excludeValueIfDisabled",
+        "excludeValueIfReadonly"
       ],
       "propsObject": ["multiple", "placeholder", "appearance"],
       "copyPaste": "{ type: 'select', key: 'country', label: 'Country', options: [{ value: 'us', label: 'USA' }], value: 'us' }",
@@ -186,7 +195,10 @@
         "col",
         "logic",
         "validators",
-        "validationMessages"
+        "validationMessages",
+        "excludeValueIfHidden",
+        "excludeValueIfDisabled",
+        "excludeValueIfReadonly"
       ],
       "propsObject": [],
       "copyPaste": "{ type: 'radio', key: 'gender', label: 'Gender', options: [{ value: 'm', label: 'Male' }, { value: 'f', label: 'Female' }] }",
@@ -207,7 +219,10 @@
         "col",
         "logic",
         "validators",
-        "validationMessages"
+        "validationMessages",
+        "excludeValueIfHidden",
+        "excludeValueIfDisabled",
+        "excludeValueIfReadonly"
       ],
       "propsObject": ["color"],
       "copyPaste": "{ type: 'checkbox', key: 'accept', label: 'Accept terms', value: false }"
@@ -228,7 +243,10 @@
         "col",
         "logic",
         "validators",
-        "validationMessages"
+        "validationMessages",
+        "excludeValueIfHidden",
+        "excludeValueIfDisabled",
+        "excludeValueIfReadonly"
       ],
       "propsObject": [],
       "copyPaste": "{ type: 'multi-checkbox', key: 'tags', label: 'Tags', options: [{ value: 'a', label: 'A' }], value: [] }",
@@ -251,7 +269,10 @@
         "col",
         "logic",
         "validators",
-        "validationMessages"
+        "validationMessages",
+        "excludeValueIfHidden",
+        "excludeValueIfDisabled",
+        "excludeValueIfReadonly"
       ],
       "propsObject": ["rows", "placeholder", "appearance"],
       "copyPaste": "{ type: 'textarea', key: 'bio', label: 'Bio', props: { rows: 4 } }"
@@ -271,7 +292,10 @@
         "col",
         "logic",
         "validators",
-        "validationMessages"
+        "validationMessages",
+        "excludeValueIfHidden",
+        "excludeValueIfDisabled",
+        "excludeValueIfReadonly"
       ],
       "propsObject": ["minDate", "maxDate", "startView", "appearance"],
       "copyPaste": "{ type: 'datepicker', key: 'dob', label: 'Date of Birth', value: undefined }"
@@ -291,7 +315,10 @@
         "col",
         "logic",
         "validators",
-        "validationMessages"
+        "validationMessages",
+        "excludeValueIfHidden",
+        "excludeValueIfDisabled",
+        "excludeValueIfReadonly"
       ],
       "propsObject": ["color"],
       "copyPaste": "{ type: 'toggle', key: 'notify', label: 'Enable notifications', value: false }"
@@ -314,7 +341,10 @@
         "col",
         "logic",
         "validators",
-        "validationMessages"
+        "validationMessages",
+        "excludeValueIfHidden",
+        "excludeValueIfDisabled",
+        "excludeValueIfReadonly"
       ],
       "propsObject": ["thumbLabel", "tickInterval", "color"],
       "copyPaste": "{ type: 'slider', key: 'rating', label: 'Rating', minValue: 1, maxValue: 10, step: 1, value: 5 }",
@@ -339,26 +369,29 @@
     "group": {
       "category": "container",
       "valueType": "object",
-      "fieldLevelProps": ["key", "type", "fields"],
+      "fieldLevelProps": ["key", "type", "fields", "logic"],
       "propsObject": [],
       "copyPaste": "{ type: 'group', key: 'address', fields: [{ type: 'input', key: 'city', label: 'City' }] }",
-      "doesNotSupport": ["label", "logic"]
+      "doesNotSupport": ["label"],
+      "notes": "Only supports 'hidden' logic type for conditional visibility."
     },
     "row": {
       "category": "container",
       "valueType": null,
-      "fieldLevelProps": ["key", "type", "fields"],
+      "fieldLevelProps": ["key", "type", "fields", "logic"],
       "propsObject": [],
       "copyPaste": "{ type: 'row', key: 'nameRow', fields: [{ type: 'input', key: 'first', label: 'First', col: 6 }, { type: 'input', key: 'last', label: 'Last', col: 6 }] }",
-      "doesNotSupport": ["label", "logic"]
+      "doesNotSupport": ["label"],
+      "notes": "Only supports 'hidden' logic type for conditional visibility."
     },
     "array": {
       "category": "container",
       "valueType": "T[]",
-      "fieldLevelProps": ["key", "type", "fields"],
+      "fieldLevelProps": ["key", "type", "fields", "logic", "minLength", "maxLength"],
       "propsObject": [],
       "copyPaste": "{ type: 'array', key: 'contacts', fields: [{ type: 'group', key: 'item', fields: [{ type: 'input', key: 'name', label: 'Name' }] }] }",
-      "doesNotSupport": ["label", "logic", "minItems", "maxItems", "template"]
+      "doesNotSupport": ["label", "minItems", "maxItems", "template"],
+      "notes": "Only supports 'hidden' logic type for conditional visibility. Supports minLength/maxLength for array size validation."
     },
     "page": {
       "category": "container",
@@ -417,8 +450,10 @@
         "maxLength": "{ type: 'maxLength', value: 50 }",
         "pattern": "{ type: 'pattern', value: '^[A-Z]+$' }",
         "custom": "{ type: 'custom', expression: 'fieldValue !== formValue.other', kind: 'errorKind' }",
-        "customAsync": "{ type: 'customAsync', functionName: 'checkAvailability' }",
-        "customHttp": "{ type: 'customHttp', functionName: 'validateOnServer' }"
+        "async": "{ type: 'async', functionName: 'checkAvailability' }",
+        "customAsync": "DEPRECATED — use type: 'async'. { type: 'customAsync', functionName: 'checkAvailability' }",
+        "http (function-based)": "{ type: 'http', functionName: 'validateOnServer' }",
+        "customHttp": "DEPRECATED — use type: 'http' with functionName. { type: 'customHttp', functionName: 'validateOnServer' }"
       }
     },
     "errorMessages": {
@@ -433,6 +468,9 @@
       "javascript": "{ type: 'javascript', expression: 'formValue.age >= 18' }",
       "and": "{ type: 'and', conditions: [...] }",
       "or": "{ type: 'or', conditions: [...] }",
+      "http": "{ type: 'http', http: { url: '/api/check', queryParams: { field: 'formValue.x' } }, responseExpression: 'response.allowed', pendingValue: false, cacheDurationMs: 30000, debounceMs: 300 }",
+      "async": "{ type: 'async', asyncFunctionName: 'myAsyncCheck', pendingValue: false, debounceMs: 300 }",
+      "custom": "{ type: 'custom', functionName: 'myConditionFn' }",
       "true": "{ type: 'true' }",
       "false": "{ type: 'false' }"
     },
@@ -452,6 +490,19 @@
     ],
     "buttonConditions": ["formInvalid", "formSubmitting", "pageInvalid"],
     "derivationExample": "{ key: 'fullName', derivation: 'formValue.first + \" \" + formValue.last' }",
+    "httpDerivationExample": "{ key: 'rate', logic: [{ type: 'derivation', source: 'http', http: { url: '/api/rate', queryParams: { from: 'formValue.currency' } }, responseExpression: 'response.rate', dependsOn: ['currency'] }] }",
+    "httpDerivationRules": {
+      "source": "REQUIRED - use source: 'http' to select HTTP derivation mode",
+      "dependsOn": "REQUIRED - prevents wildcard triggering on every keystroke",
+      "responseExpression": "REQUIRED - extracts value from HTTP response body",
+      "noArrays": "Array fields (items.$.rate) are NOT supported for HTTP derivations"
+    },
+    "asyncFunctionDerivationExample": "{ key: 'price', logic: [{ type: 'derivation', source: 'asyncFunction', asyncFunctionName: 'fetchSuggestedPrice', dependsOn: ['productId', 'quantity'] }] }",
+    "asyncFunctionDerivationRules": {
+      "source": "REQUIRED - use source: 'asyncFunction' to select async derivation mode",
+      "dependsOn": "REQUIRED - prevents wildcard triggering on every form change",
+      "noWildcard": "Wildcards ('*') are NOT allowed in dependsOn for async derivations"
+    },
     "expressionVariables": {
       "formValue": "Complete form value object",
       "fieldValue": "Current field's value"
@@ -500,7 +551,7 @@
     }
   },
   "commonPitfalls": [
-    "Container fields (group, row, array) do NOT support logic - apply to children instead",
+    "Container fields (group, row, array) only support 'hidden' logic type - for other logic types (disabled, required, readonly, derivation), apply to children instead",
     "options/minValue/maxValue/arrayKey go at FIELD level, NOT in props",
     "Validators use ctx.value() and ctx.valueOf(), NOT formValue",
     "Type annotation (: FormConfig) loses inference - use 'as const satisfies'",