@golemui/gui-mcp 1.5.1 → 1.6.0-rc.0

package/json/generate-from-json-schema.d.ts

@@ -1,20 +1,15 @@
-import { JsonSchemaLike } from './mapping/json-schema-to-gui';
+import { DeclarativeRule, WidgetPatch } from '@golemui/schemas/json-schema';
+import { JsonSchemaLike, MapResult } from './mapping/json-schema-to-gui';
 import { validateFormDefinition } from './validate-form-definition';
 export type GenerateFromJsonSchemaInput = {
     jsonSchema: JsonSchemaLike;
     submitAction?: boolean;
     submitLabel?: string;
     layout?: 'vertical' | 'horizontal' | 'grid';
+    rules?: DeclarativeRule[];
+    overrides?: Record<string, WidgetPatch>;
 };
-export type GenerateFromJsonSchemaResult = {
-    formDefinition: {
-        $schema: string;
-        form: unknown[];
-    };
-    unmapped: {
-        path: string;
-        reason: string;
-    }[];
+export type GenerateFromJsonSchemaResult = MapResult & {
     validation: ReturnType<typeof validateFormDefinition>;
 };
 export declare function generateFromJsonSchema(input: GenerateFromJsonSchemaInput): GenerateFromJsonSchemaResult;
@@ -24,6 +19,29 @@ export declare const JSON_GENERATE_FROM_SCHEMA_TOOL: {
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
+            readonly rules: {
+                type: "array";
+                description: string;
+                items: {
+                    type: "object";
+                    additionalProperties: boolean;
+                    properties: {
+                        match: {
+                            type: "object";
+                            additionalProperties: boolean;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            readonly overrides: {
+                type: "object";
+                description: string;
+                additionalProperties: {
+                    type: "object";
+                    additionalProperties: boolean;
+                };
+            };
             readonly jsonSchema: {
                 readonly type: "object";
                 readonly additionalProperties: true;

package/json/generate-from-openapi.d.ts

@@ -1,4 +1,5 @@
-import { JsonSchemaLike } from './mapping/json-schema-to-gui';
+import { DeclarativeRule, WidgetPatch } from '@golemui/schemas/json-schema';
+import { JsonSchemaLike, MapResult } from './mapping/json-schema-to-gui';
 import { validateFormDefinition } from './validate-form-definition';
 type OpenAPIDoc = {
     openapi?: string;
@@ -29,21 +30,15 @@ export type GenerateFromOpenapiInput = {
     operation: string;
     submitAction?: boolean;
     submitLabel?: string;
+    rules?: DeclarativeRule[];
+    overrides?: Record<string, WidgetPatch>;
 };
-export type GenerateFromOpenapiResult = {
+export type GenerateFromOpenapiResult = MapResult & {
     resolvedOperation: {
         method: string;
         path: string;
         operationId?: string;
     };
-    formDefinition: {
-        $schema: string;
-        form: unknown[];
-    };
-    unmapped: {
-        path: string;
-        reason: string;
-    }[];
     validation: ReturnType<typeof validateFormDefinition>;
 };
 export declare function generateFromOpenapi(input: GenerateFromOpenapiInput): Promise<GenerateFromOpenapiResult>;
@@ -53,6 +48,29 @@ export declare const JSON_GENERATE_FROM_OPENAPI_TOOL: {
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
+            readonly rules: {
+                type: "array";
+                description: string;
+                items: {
+                    type: "object";
+                    additionalProperties: boolean;
+                    properties: {
+                        match: {
+                            type: "object";
+                            additionalProperties: boolean;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            readonly overrides: {
+                type: "object";
+                description: string;
+                additionalProperties: {
+                    type: "object";
+                    additionalProperties: boolean;
+                };
+            };
             readonly documentUrl: {
                 readonly type: "string";
                 readonly description: "URL of a JSON OpenAPI document. Either this or `document` is required.";

package/json/mapping/json-schema-to-gui.d.ts

@@ -1,56 +1,51 @@
-/**
- * Deterministic mapping from a JSON Schema (the form-data shape) to a GolemUI form definition.
- *
- * Handles the practical 80% of API/Zod-derived schemas:
- *   - primitive properties (string/number/integer/boolean) with formats and constraints
- *   - enum strings as `select` (≤ 6 options) or `dropdown` (more)
- *   - nested objects rendered inline as `flex` layouts
- *   - arrays of objects as `repeater` with a `flex` template
- *
- * Constructs unmapped: anything we can't cleanly express. They're returned as `unmapped[]`
- * so the caller (and any LLM) can surface a partial form rather than a hard failure.
- */
-export type JsonSchemaLike = {
-    type?: string | string[];
-    format?: string;
-    title?: string;
-    description?: string;
-    enum?: unknown[];
-    const?: unknown;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    minimum?: number;
-    maximum?: number;
-    exclusiveMinimum?: number;
-    exclusiveMaximum?: number;
-    multipleOf?: number;
-    minItems?: number;
-    maxItems?: number;
-    uniqueItems?: boolean;
-    default?: unknown;
-    required?: string[];
-    properties?: Record<string, JsonSchemaLike>;
-    items?: JsonSchemaLike;
-    oneOf?: JsonSchemaLike[];
-    anyOf?: JsonSchemaLike[];
-    $ref?: string;
-    [k: string]: unknown;
-};
+import { DeclarativeRule, Diagnostic, FormDefinitionJson, JsonSchema, WidgetPatch } from '@golemui/schemas/json-schema';
+/** A JSON Schema object, under the name the tool types have always used. */
+export type JsonSchemaLike = JsonSchema;
 export type MapOptions = {
     submitAction?: boolean;
     submitLabel?: string;
     layout?: 'vertical' | 'horizontal' | 'grid';
+    /** Declarative rules, checked before the gui preset rules. */
+    rules?: DeclarativeRule[];
+    /** Widget fields by form data path or by `$defs/<Name>`. */
+    overrides?: Record<string, WidgetPatch>;
+    /** The document `$ref` values resolve against, e.g. an OpenAPI document. */
+    refRoot?: JsonSchema;
 };
 export type Unmapped = {
     path: string;
     reason: string;
 };
 export type MapResult = {
-    formDefinition: {
-        $schema: string;
-        form: unknown[];
-    };
+    formDefinition: FormDefinitionJson;
+    /** The warnings and errors of `diagnostics`: what is not rendered, or rendered approximately. */
     unmapped: Unmapped[];
+    diagnostics: Diagnostic[];
+};
+/** The `rules` and `overrides` inputs of the generate tools, in MCP input schema form. */
+export declare const CUSTOMIZATION_INPUT_PROPERTIES: {
+    rules: {
+        type: "array";
+        description: string;
+        items: {
+            type: "object";
+            additionalProperties: boolean;
+            properties: {
+                match: {
+                    type: "object";
+                    additionalProperties: boolean;
+                };
+            };
+            required: string[];
+        };
+    };
+    overrides: {
+        type: "object";
+        description: string;
+        additionalProperties: {
+            type: "object";
+            additionalProperties: boolean;
+        };
+    };
 };
-export declare function jsonSchemaToGui(schema: JsonSchemaLike, opts?: MapOptions): MapResult;
+export declare function jsonSchemaToGui(schema: JsonSchemaLike, options?: MapOptions): MapResult;

package/json.js

@@ -1,4 +1,4 @@
-import { G, J, a, b, c, g, d, e, f, v } from "./get-concept-MFKfeD4D.js";
+import { G, J, a, b, c, g, d, e, f, v } from "./get-concept-BqdUfdaO.js";
 export {
   G as GET_CONCEPT_TOOL,
   J as JSON_GENERATE_FROM_OPENAPI_TOOL,

package/lib.js

@@ -1,5 +1,5 @@
-import { G, J, a, b, c, g, d, e, f, v } from "./get-concept-MFKfeD4D.js";
-import { D, a as a2, b as b2, c as c2, d as d2, e as e2, g as g2, l, f as f2, t } from "./list-dx-factories-D3u4qsn1.js";
+import { G, J, a, b, c, g, d, e, f, v } from "./get-concept-BqdUfdaO.js";
+import { D, a as a2, b as b2, c as c2, d as d2, e as e2, g as g2, l, f as f2, t } from "./list-dx-factories-BKx43VHj.js";
 export {
   D as DX_CHECK_CODE_TOOL,
   a2 as DX_GET_SPEC_TOOL,

package/{list-dx-factories-D3u4qsn1.js → list-dx-factories-BKx43VHj.js}

@@ -1,4 +1,4 @@
-import { h as checkReactiveExpression, i as checkBooleanValidatorRules } from "./get-concept-MFKfeD4D.js";
+import { h as checkReactiveExpression, i as checkBooleanValidatorRules } from "./get-concept-BqdUfdaO.js";
 import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { resolve, join, dirname } from "node:path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@golemui/gui-mcp",
-  "version": "1.5.1",
+  "version": "1.6.0-rc.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -43,11 +43,12 @@
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "typescript": "^5.9.2",
-    "@golemui/gui-schemas": "1.5.1",
-    "@golemui/gui-shared": "1.5.1",
-    "@golemui/gui-validators": "1.5.1",
-    "@golemui/dx": "1.5.1",
-    "@golemui/core": "1.5.1",
+    "@golemui/gui-schemas": "1.6.0-rc.0",
+    "@golemui/schemas": "1.6.0-rc.0",
+    "@golemui/gui-shared": "1.6.0-rc.0",
+    "@golemui/gui-validators": "1.6.0-rc.0",
+    "@golemui/dx": "1.6.0-rc.0",
+    "@golemui/core": "1.6.0-rc.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^4.0.0",
     "@standard-schema/spec": "^1.0.0"

package/json/mapping/validator.d.ts

@@ -1,29 +0,0 @@
-import { JsonSchemaLike } from './json-schema-to-gui';
-export type StringValidator = {
-    type: 'string';
-    required?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    format?: string;
-    const?: unknown;
-    enum?: unknown[];
-};
-export type NumberValidator = {
-    type: 'number' | 'integer';
-    required?: boolean;
-    minimum?: number;
-    maximum?: number;
-    exclusiveMinimum?: number;
-    exclusiveMaximum?: number;
-    multipleOf?: number;
-};
-export type BooleanValidator = {
-    type: 'boolean';
-    required?: boolean;
-    const?: unknown;
-};
-export type Validator = StringValidator | NumberValidator | BooleanValidator;
-export declare function buildStringValidator(s: JsonSchemaLike, required: boolean): StringValidator | undefined;
-export declare function buildNumberValidator(s: JsonSchemaLike, required: boolean, t: 'number' | 'integer'): NumberValidator | undefined;
-export declare function buildBooleanValidator(s: JsonSchemaLike, required: boolean): BooleanValidator | undefined;