@ng-forge/dynamic-form-mcp 1.0.0-rc.3 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +24 -25
  3. package/bin/ng-forge-mcp.js +313 -69
  4. package/index.d.ts +252 -0
  5. package/package.json +16 -13
  6. package/src/index.js +313 -69
  7. package/src/registry/addons.d.ts +3 -2
  8. package/src/registry/addons.d.ts.map +1 -1
  9. package/src/registry/field-types.d.ts.map +1 -1
  10. package/src/registry/index.d.ts +3 -2
  11. package/src/registry/index.d.ts.map +1 -1
  12. package/src/registry/instructions.d.ts +1 -1
  13. package/src/registry/instructions.d.ts.map +1 -1
  14. package/src/resources/schemas.resource.d.ts.map +1 -1
  15. package/src/resources/ui-adapters.resource.d.ts.map +1 -1
  16. package/src/tools/data/lookup-topics.d.ts.map +1 -1
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 ng-forge
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -17,9 +17,7 @@ MCP (Model Context Protocol) server for ng-forge dynamic forms - enables AI assi
17
17
 
18
18
  ## Installation
19
19
 
20
- ```bash
21
- npm install @ng-forge/dynamic-form-mcp
22
- ```
20
+ No manual install needed. This is a stdio MCP server that your MCP client launches on demand via `npx` (using the package name `@ng-forge/dynamic-form-mcp`); see the per-client config in Setup below.
23
21
 
24
22
  ## Setup
25
23
 
@@ -93,14 +91,15 @@ For development within the ng-forge monorepo:
93
91
 
94
92
  ## Available Tools
95
93
 
96
- The server provides 4 focused tools:
94
+ The server provides 5 focused tools:
97
95
 
98
- | Tool | Description | Read-only |
99
- | ------------------ | ----------------------------------------------------------- | --------- |
100
- | `ngforge_lookup` | Get documentation about field types, concepts, and patterns | ✅ |
101
- | `ngforge_examples` | Get working code examples for common form patterns | ✅ |
102
- | `ngforge_validate` | Validate FormConfig and get detailed error feedback | ✅ |
103
- | `ngforge_scaffold` | Generate valid FormConfig skeletons | ✅ |
96
+ | Tool | Description | Read-only |
97
+ | ------------------ | -------------------------------------------------------------- | --------- |
98
+ | `ngforge_lookup` | Get documentation about field types, concepts, and patterns | ✅ |
99
+ | `ngforge_examples` | Get working code examples for common form patterns | ✅ |
100
+ | `ngforge_validate` | Validate FormConfig and get detailed error feedback | ✅ |
101
+ | `ngforge_scaffold` | Generate valid FormConfig skeletons | ✅ |
102
+ | `ngforge_search` | Free-text search across topics, patterns, wrappers, and addons | ✅ |
104
103
 
105
104
  ---
106
105
 
@@ -116,12 +115,7 @@ Get documentation about any ng-forge topic.
116
115
 
117
116
  **Available Topics:**
118
117
 
119
- | Category | Topics |
120
- | ----------- | ------------------------------------------------------------------------------------------------------ |
121
- | Field Types | `input`, `select`, `radio`, `checkbox`, `textarea`, `datepicker`, `slider`, `toggle`, `hidden`, `text` |
122
- | Containers | `group`, `row`, `array`, `page` |
123
- | Concepts | `validation`, `conditional`, `derivation`, `options-format`, `expression-variables` |
124
- | Patterns | `golden-path`, `multi-page-gotchas`, `pitfalls`, `workflow` |
118
+ Run `ngforge_lookup topic="list"` for the complete, always-current list of topics. Categories include field types (`input`, `select`, `multi-checkbox`, ...), containers (`group`, `row`, `array`, `page`), concepts (`validation`, `conditional`, `derivation`, ...), wrappers, and addons.
125
119
 
126
120
  ---
127
121
 
@@ -136,15 +130,18 @@ Get working code examples for common patterns.
136
130
 
137
131
  **Available Patterns:**
138
132
 
139
- | Pattern | Description |
140
- | --------------------- | ---------------------------------------- |
141
- | `minimal-multipage` | Simplest 2-page wizard form |
142
- | `minimal-array` | Array with add/remove buttons |
143
- | `minimal-conditional` | Show/hide field based on condition |
144
- | `minimal-validation` | Password confirmation validation |
145
- | `minimal-hidden` | Hidden fields in multi-page form |
146
- | `complete` | Full form with all major features |
147
- | `mega` | Kitchen sink demonstrating every feature |
133
+ | Pattern | Description |
134
+ | -------------------------- | ------------------------------------------ |
135
+ | `minimal-multipage` | Simplest 2-page wizard form |
136
+ | `minimal-array` | Array with add/remove buttons |
137
+ | `minimal-simplified-array` | Array using the simplified-array shorthand |
138
+ | `minimal-conditional` | Show/hide a field based on a condition |
139
+ | `minimal-validation` | Password confirmation validation |
140
+ | `minimal-hidden` | Hidden fields in a multi-page form |
141
+ | `multi-page` | Multi-page wizard with navigation buttons |
142
+ | `property-derivation` | Derive a field property from another field |
143
+
144
+ Run `ngforge_examples pattern="list"` for the current set of patterns.
148
145
 
149
146
  ---
150
147
 
@@ -199,6 +196,8 @@ Generate valid FormConfig skeletons.
199
196
  | `ng-forge://examples/{id}` | Specific example by ID |
200
197
  | `ng-forge://field-types` | Field type reference |
201
198
  | `ng-forge://validators` | Validator reference |
199
+ | `ng-forge://wrappers` | Wrapper reference |
200
+ | `ng-forge://schemas` | Standard Schema validation reference |
202
201
  | `ng-forge://ui-adapters` | UI library configurations |
203
202
  | `ng-forge://docs` | Full documentation index |
204
203