@verbb/plugin-kit-vue 2.0.0

package/dist/forms/SchemaFormEngine.js

@@ -0,0 +1,372 @@
+import { Separator } from "../components/Separator.js";
+import { SchemaEngineContextKey } from "./engine/context.js";
+import { getFormComponentRegistry } from "./registry.js";
+import { SchemaFormFieldNode } from "./SchemaFormFieldNode.js";
+import { isRecord, normalizeAttrs, readEventValue } from "./utils.js";
+import { defineComponent, h, inject, onBeforeUnmount, onMounted, provide, ref, shallowRef } from "vue";
+import { FormStateStore, buildGroupedMessage, createValidationEngine, evaluateCondition, normalizeSchema } from "@verbb/plugin-kit-forms";
+//#region src/forms/SchemaFormEngine.ts
+var normalizeServerErrors = (rawErrors) => {
+	const normalized = {};
+	if (!rawErrors) return normalized;
+	const appendMessages = (path, messages) => {
+		if (!path) return;
+		const nextMessages = messages.filter((message) => message !== void 0 && message !== null && message !== "").map((message) => String(message));
+		if (!nextMessages.length) return;
+		if (!normalized[path]) normalized[path] = [];
+		normalized[path].push(...nextMessages);
+	};
+	const collectErrors = (node, path) => {
+		if (Array.isArray(node)) {
+			if (node.length === 0) return;
+			if (node.every((entry) => typeof entry === "string")) {
+				appendMessages(path, node);
+				return;
+			}
+			if (!path) {
+				node.forEach((entry) => collectErrors(entry, path));
+				return;
+			}
+			node.forEach((entry, index) => {
+				collectErrors(entry, `${path}.${index}`);
+			});
+			return;
+		}
+		if (!isRecord(node)) return;
+		Object.entries(node).forEach(([key, value]) => {
+			collectErrors(value, path ? `${path}.${key}` : key);
+		});
+	};
+	if (Array.isArray(rawErrors)) {
+		collectErrors(rawErrors, "");
+		return normalized;
+	}
+	if (isRecord(rawErrors) && "errors" in rawErrors) {
+		collectErrors(rawErrors.errors, "");
+		return normalized;
+	}
+	collectErrors(rawErrors, "");
+	return normalized;
+};
+var createEngineFieldComponent = (formRef) => defineComponent({
+	name: "SchemaEngineField",
+	props: { name: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const version = ref(0);
+		let unsubscribe;
+		onMounted(() => {
+			unsubscribe = formRef.value?.store.subscribe(() => {
+				version.value += 1;
+			});
+		});
+		onBeforeUnmount(() => {
+			unsubscribe?.();
+		});
+		return () => {
+			const form = formRef.value;
+			if (!form) return null;
+			version.value;
+			const fieldApi = {
+				state: { value: form.getFieldValue(props.name) },
+				handleChange: (valueOrEvent) => {
+					form.setFieldValue(props.name, readEventValue(valueOrEvent));
+				},
+				handleBlur: () => {
+					form.store.setTouched(props.name, true);
+				},
+				errors: form.getErrorMapFields()[props.name] || []
+			};
+			return slots.default?.(fieldApi);
+		};
+	}
+});
+var buildConditionData = (form, field, values) => {
+	const scopePath = typeof field._scopePath === "string" ? field._scopePath : "";
+	const scopedValues = scopePath ? form.getFieldValue(scopePath) : null;
+	const scopedObject = isRecord(scopedValues) ? scopedValues : {};
+	const conditionContext = form.getConditionContext?.(values, field);
+	const normalizedConditionContext = isRecord(conditionContext) ? conditionContext : {};
+	const fieldData = isRecord(field._data) ? field._data : {};
+	return {
+		...values,
+		...scopedObject,
+		...fieldData,
+		...normalizedConditionContext
+	};
+};
+var renderSchemaItem = (schemaItem, index, form) => {
+	return h(SchemaItem, {
+		key: typeof schemaItem._id === "string" ? schemaItem._id : `schema-item-${index}`,
+		field: schemaItem,
+		form
+	}, { default: () => h(SchemaRenderer, { schema: schemaItem }) });
+};
+var renderFormField = (schema, form) => {
+	const { $field, ...props } = schema.$field ? {
+		$field: schema.$field,
+		...schema
+	} : {
+		$field: schema.type,
+		...schema
+	};
+	return h(SchemaFormFieldNode, {
+		fieldType: String($field ?? ""),
+		schema,
+		field: { ...props },
+		form
+	}, { default: () => props.children ? h(SchemaRenderer, { schema: props.children }) : null });
+};
+var renderHtmlElement = (schema) => {
+	const { $el, children, attrs = {} } = schema;
+	const normalizedAttrs = normalizeAttrs(isRecord(attrs) ? attrs : {});
+	if (typeof $el !== "string" || !$el) return null;
+	if ($el === "hr") return h(Separator, normalizedAttrs);
+	return h($el, normalizedAttrs, children ? () => h(SchemaRenderer, { schema: children }) : void 0);
+};
+var renderFormComponent = (schema) => {
+	const { $cmp, props = {}, children, ...rest } = schema;
+	const Component = getFormComponentRegistry()[$cmp];
+	if (!Component) {
+		console.warn(`Unknown form component: ${$cmp}`);
+		return null;
+	}
+	const componentProps = {
+		...isRecord(props) ? props : {},
+		...rest
+	};
+	if (Boolean(Component.usesSchemaNode)) componentProps.schemaNode = schema;
+	else if ("schemaNode" in componentProps) delete componentProps.schemaNode;
+	return h(Component, componentProps, { default: () => children ? h(SchemaRenderer, { schema: children }) : null });
+};
+var SchemaItem = defineComponent({
+	name: "SchemaItem",
+	props: {
+		field: {
+			type: Object,
+			required: true
+		},
+		form: {
+			type: Object,
+			required: true
+		}
+	},
+	setup(props, { slots }) {
+		const shouldShow = ref(true);
+		const resolveVisibility = (values) => {
+			if (!props.field.if) return true;
+			return Boolean(evaluateCondition(props.field.if, buildConditionData(props.form, props.field, values)));
+		};
+		const update = () => {
+			shouldShow.value = resolveVisibility(props.form.store.state.values);
+		};
+		update();
+		onBeforeUnmount(props.form.store.subscribe(update));
+		return () => {
+			if (!shouldShow.value) return props.field.hideOnIf ? h("div", { style: { display: "none" } }, slots.default?.()) : null;
+			return slots.default?.();
+		};
+	}
+});
+var SchemaRenderer = defineComponent({
+	name: "SchemaRenderer",
+	props: { schema: {
+		type: null,
+		required: true
+	} },
+	setup(props) {
+		const form = provideAwareForm();
+		return () => {
+			const schema = props.schema;
+			if (typeof schema === "string") return schema;
+			if (Array.isArray(schema)) return schema.map((schemaItem, index) => {
+				if (typeof schemaItem === "string") return schemaItem;
+				if (!isRecord(schemaItem)) return null;
+				return renderSchemaItem(schemaItem, index, form);
+			});
+			if (schema.$field || schema.$cmp === "Field") return renderFormField(schema, form);
+			if (schema.$el) return renderHtmlElement(schema);
+			if (schema.$cmp) return renderFormComponent(schema);
+			console.warn("Unknown schema item:", schema);
+			return null;
+		};
+	}
+});
+var provideAwareForm = () => {
+	const form = inject(SchemaEngineContextKey, null);
+	if (!form) throw new Error("SchemaRenderer must be used within SchemaFormEngine.");
+	return form;
+};
+var useSchemaFormEngine = ({ schemaIndex = null, defaultValues = {}, errors, onChange, getConditionContext, parentForm, parentPath }) => {
+	if (!schemaIndex) throw new Error("SchemaFormEngine requires a compiled schemaIndex.");
+	const index = {
+		...schemaIndex,
+		schema: normalizeSchema(schemaIndex.schema)
+	};
+	const store = new FormStateStore(defaultValues);
+	const validationEngine = createValidationEngine(index, { conditionDataResolver: getConditionContext });
+	const labelMap = /* @__PURE__ */ new Map();
+	const nestedForms = /* @__PURE__ */ new Map();
+	const formRef = shallowRef(null);
+	const Field = createEngineFieldComponent(formRef);
+	index.fieldEntries.forEach((entry) => {
+		if (entry.path) {
+			const label = String(entry.field?.label || entry.field?.name || entry.path);
+			labelMap.set(entry.path, label);
+		}
+	});
+	let onSubmitHandler = null;
+	let onErrorHandler = null;
+	let onSuccessHandler = null;
+	let onChangeHandler = onChange ? (value) => {
+		if (formRef.value) onChange(value, formRef.value);
+	} : null;
+	const validateNestedForms = () => {
+		const nestedErrors = {};
+		nestedForms.forEach((api, path) => {
+			const result = api.validate();
+			if (result?.fields) Object.entries(result.fields).forEach(([fieldPath, messages]) => {
+				const mergedPath = fieldPath ? `${path}.${fieldPath}` : path;
+				nestedErrors[mergedPath] = messages;
+			});
+		});
+		return nestedErrors;
+	};
+	const getGroupedErrorsForPath = (path) => {
+		if (!path) return [];
+		const currentErrors = store.state.errors || {};
+		const rootErrors = currentErrors[path] || [];
+		const childKeys = Object.keys(currentErrors).filter((key) => key.startsWith(`${path}.`));
+		if (!childKeys.length) return rootErrors;
+		const parentLabel = labelMap.get(path);
+		const groupedMessages = [];
+		childKeys.forEach((key) => {
+			const wildcardPath = key.replace(/\.\d+(?=\.|$)/g, ".*");
+			const childLabel = labelMap.get(wildcardPath) || key.split(".").slice(-1)[0];
+			(currentErrors[key] || []).forEach((message) => {
+				if (parentLabel) {
+					groupedMessages.push(buildGroupedMessage(String(message), parentLabel, childLabel));
+					return;
+				}
+				groupedMessages.push(String(message));
+			});
+		});
+		return Array.from(new Set([...rootErrors, ...groupedMessages]));
+	};
+	const handleSubmit = async () => {
+		const errorsMap = validationEngine.validate(store.state.values)?.fields || {};
+		const nestedErrors = validateNestedForms();
+		const mergedErrors = {
+			...errorsMap,
+			...nestedErrors
+		};
+		if (Object.keys(mergedErrors).length > 0) {
+			store.setErrors(mergedErrors);
+			onErrorHandler?.(mergedErrors);
+			return;
+		}
+		store.clearErrors();
+		await onSubmitHandler?.(store.state.values);
+		if (parentForm && parentPath) parentForm.setFieldValue(parentPath, store.state.values);
+		onSuccessHandler?.(store.state.values);
+	};
+	const form = {
+		schema: index.schema,
+		store,
+		index,
+		Field,
+		getFieldValue: (path) => store.getValue(path),
+		setFieldValue: (path, value) => store.setValue(path, value),
+		getErrorMapFields: () => store.state.errors || {},
+		SchemaRenderer,
+		handleSubmit,
+		onChange: (handler) => {
+			onChangeHandler = handler;
+		},
+		onSubmit: (handler) => {
+			onSubmitHandler = handler;
+		},
+		onError: (handler) => {
+			onErrorHandler = handler;
+		},
+		onSuccess: (handler) => {
+			onSuccessHandler = handler;
+		},
+		registerNestedForm: (path, api) => {
+			nestedForms.set(path, api);
+		},
+		unregisterNestedForm: (path) => {
+			nestedForms.delete(path);
+		},
+		getGroupedErrorsForPath,
+		getConditionContext: (values, field) => getConditionContext?.(values, field) || {}
+	};
+	formRef.value = form;
+	onBeforeUnmount(store.subscribe(() => {
+		onChangeHandler?.(store.state.values);
+	}));
+	const normalized = normalizeServerErrors(errors);
+	if (Object.keys(normalized).length) store.setErrors(normalized);
+	if (parentForm && parentPath) {
+		const nestedApi = {
+			path: parentPath,
+			validate: () => {
+				const result = validationEngine.validate(store.state.values);
+				const fieldErrors = result?.fields || {};
+				if (Object.keys(fieldErrors).length) store.setErrors(fieldErrors);
+				else store.clearErrors();
+				return result;
+			},
+			getValues: () => store.state.values
+		};
+		parentForm.registerNestedForm(parentPath, nestedApi);
+		onBeforeUnmount(() => {
+			parentForm.unregisterNestedForm(parentPath);
+		});
+	}
+	return form;
+};
+var SchemaFormEngine = defineComponent({
+	name: "SchemaFormEngine",
+	props: {
+		form: {
+			type: Object,
+			required: true
+		},
+		class: {
+			type: null,
+			default: void 0
+		},
+		withoutForm: {
+			type: Boolean,
+			default: false
+		}
+	},
+	setup(props, { expose }) {
+		expose(props.form);
+		provide(SchemaEngineContextKey, props.form);
+		return () => {
+			const content = h(SchemaRenderer, { schema: props.form.schema });
+			if (props.withoutForm) return h("div", { class: props.class }, content);
+			return h("form", {
+				class: props.class,
+				onSubmit: (event) => {
+					event.preventDefault();
+					event.stopPropagation();
+					props.form.handleSubmit();
+				}
+			}, [content, h("button", {
+				type: "submit",
+				tabindex: -1,
+				"aria-hidden": "true",
+				class: "sr-only"
+			})]);
+		};
+	}
+});
+//#endregion
+export { SchemaFormEngine, useSchemaFormEngine };
+
+//# sourceMappingURL=SchemaFormEngine.js.map

package/dist/forms/SchemaFormEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaFormEngine.js","names":[],"sources":["../../src/forms/SchemaFormEngine.ts"],"sourcesContent":["import {\n    defineComponent,\n    h,\n    inject,\n    onBeforeUnmount,\n    onMounted,\n    provide,\n    ref,\n    shallowRef,\n    type PropType,\n    type VNodeChild,\n} from 'vue';\nimport {\n    FormStateStore,\n    buildGroupedMessage,\n    createValidationEngine,\n    evaluateCondition,\n    normalizeSchema,\n} from '@verbb/plugin-kit-forms';\nimport type { SchemaIndex, SchemaNode, SchemaRenderable } from '@verbb/plugin-kit-forms';\n\nimport { Separator } from '../components/Separator.js';\nimport { getFormComponentRegistry } from './registry.js';\nimport { SchemaFormFieldNode } from './SchemaFormFieldNode.js';\nimport type {\n    FormValues,\n    NestedFormApi,\n    SchemaFieldApi,\n    SchemaFormEngineApi,\n} from './engine/context.js';\nimport { SchemaEngineContextKey } from './engine/context.js';\nimport { isRecord, normalizeAttrs, readEventValue } from './utils.js';\n\ntype SchemaFormEngineErrors = Record<string, unknown> | { errors?: unknown } | unknown[];\n\ntype SchemaFormEngineOptions = {\n    schemaIndex: SchemaIndex | null;\n    defaultValues?: FormValues;\n    errors?: SchemaFormEngineErrors;\n    onChange?: (values: Record<string, unknown>, form: SchemaFormEngineApi) => void;\n    getConditionContext?: (values: FormValues, field?: SchemaNode) => Record<string, unknown>;\n    parentForm?: SchemaFormEngineApi | null;\n    parentPath?: string;\n};\n\nconst normalizeServerErrors = (rawErrors: SchemaFormEngineErrors | undefined): Record<string, string[]> => {\n    const normalized: Record<string, string[]> = {};\n\n    if (!rawErrors) {\n        return normalized;\n    }\n\n    const appendMessages = (path: string, messages: unknown[]) => {\n        if (!path) {\n            return;\n        }\n\n        const nextMessages = messages\n            .filter((message) => message !== undefined && message !== null && message !== '')\n            .map((message) => String(message));\n\n        if (!nextMessages.length) {\n            return;\n        }\n\n        if (!normalized[path]) {\n            normalized[path] = [];\n        }\n\n        normalized[path].push(...nextMessages);\n    };\n\n    const collectErrors = (node: unknown, path: string) => {\n        if (Array.isArray(node)) {\n            if (node.length === 0) {\n                return;\n            }\n\n            const isMessageArray = node.every((entry) => typeof entry === 'string');\n            if (isMessageArray) {\n                appendMessages(path, node);\n                return;\n            }\n\n            if (!path) {\n                node.forEach((entry) => collectErrors(entry, path));\n                return;\n            }\n\n            node.forEach((entry, index) => {\n                collectErrors(entry, `${path}.${index}`);\n            });\n            return;\n        }\n\n        if (!isRecord(node)) {\n            return;\n        }\n\n        Object.entries(node).forEach(([key, value]) => {\n            const nextPath = path ? `${path}.${key}` : key;\n            collectErrors(value, nextPath);\n        });\n    };\n\n    if (Array.isArray(rawErrors)) {\n        collectErrors(rawErrors, '');\n        return normalized;\n    }\n\n    if (isRecord(rawErrors) && 'errors' in rawErrors) {\n        collectErrors(rawErrors.errors, '');\n        return normalized;\n    }\n\n    collectErrors(rawErrors, '');\n    return normalized;\n};\n\nconst createEngineFieldComponent = (formRef: { value: SchemaFormEngineApi | null }) => defineComponent({\n    name: 'SchemaEngineField',\n    props: {\n        name: { type: String, required: true },\n    },\n    setup(props, { slots }) {\n        const version = ref(0);\n        let unsubscribe: (() => void) | undefined;\n\n        onMounted(() => {\n            unsubscribe = formRef.value?.store.subscribe(() => {\n                version.value += 1;\n            });\n        });\n        onBeforeUnmount(() => {\n            unsubscribe?.();\n        });\n\n        return () => {\n            const form = formRef.value;\n            if (!form) {\n                return null;\n            }\n\n            version.value;\n            const fieldApi: SchemaFieldApi = {\n                state: { value: form.getFieldValue(props.name) },\n                handleChange: (valueOrEvent: unknown) => {\n                    form.setFieldValue(props.name, readEventValue(valueOrEvent));\n                },\n                handleBlur: () => {\n                    form.store.setTouched(props.name, true);\n                },\n                errors: form.getErrorMapFields()[props.name] || [],\n            };\n\n            return slots.default?.(fieldApi);\n        };\n    },\n});\n\nconst buildConditionData = (\n    form: SchemaFormEngineApi,\n    field: SchemaNode,\n    values: FormValues,\n): Record<string, unknown> => {\n    const scopePath = typeof field._scopePath === 'string' ? field._scopePath : '';\n    const scopedValues = scopePath ? form.getFieldValue(scopePath) : null;\n    const scopedObject = isRecord(scopedValues) ? scopedValues : {};\n    const conditionContext = form.getConditionContext?.(values, field);\n    const normalizedConditionContext = isRecord(conditionContext) ? conditionContext : {};\n    const fieldData = isRecord(field._data) ? field._data : {};\n\n    return {\n        ...values,\n        ...scopedObject,\n        ...fieldData,\n        ...normalizedConditionContext,\n    };\n};\n\nconst renderSchemaItem = (schemaItem: SchemaNode, index: number, form: SchemaFormEngineApi): VNodeChild => {\n    const key = typeof schemaItem._id === 'string' ? schemaItem._id : `schema-item-${index}`;\n\n    return h(SchemaItem, { key, field: schemaItem, form }, {\n        default: () => h(SchemaRenderer, { schema: schemaItem }),\n    });\n};\n\nconst renderFormField = (schema: SchemaNode, form: SchemaFormEngineApi): VNodeChild => {\n    const fieldProps = schema.$field ? { $field: schema.$field, ...schema } : { $field: schema.type, ...schema };\n    const { $field, ...props } = fieldProps;\n    const fieldType = String($field ?? '');\n\n    return h(SchemaFormFieldNode, {\n        fieldType,\n        schema,\n        field: { ...props },\n        form,\n    }, {\n        default: () => (props.children ? h(SchemaRenderer, { schema: props.children as SchemaRenderable }) : null),\n    });\n};\n\nconst renderHtmlElement = (schema: SchemaNode): VNodeChild => {\n    const { $el, children, attrs = {} } = schema;\n    const normalizedAttrs = normalizeAttrs(isRecord(attrs) ? attrs : {});\n\n    if (typeof $el !== 'string' || !$el) {\n        return null;\n    }\n\n    if ($el === 'hr') {\n        return h(Separator, normalizedAttrs);\n    }\n\n    return h($el, normalizedAttrs, children ? () => h(SchemaRenderer, { schema: children }) : undefined);\n};\n\nconst renderFormComponent = (schema: SchemaNode): VNodeChild => {\n    const {\n        $cmp, props = {}, children, ...rest\n    } = schema;\n    const Component = getFormComponentRegistry()[$cmp as string];\n\n    if (!Component) {\n        console.warn(`Unknown form component: ${$cmp}`);\n        return null;\n    }\n\n    const componentProps = { ...(isRecord(props) ? props : {}), ...rest } as Record<string, unknown>;\n    const usesSchemaNode = Boolean(Component.usesSchemaNode);\n\n    if (usesSchemaNode) {\n        componentProps.schemaNode = schema;\n    } else if ('schemaNode' in componentProps) {\n        delete componentProps.schemaNode;\n    }\n\n    return h(Component, componentProps, {\n        default: () => (children ? h(SchemaRenderer, { schema: children as SchemaRenderable }) : null),\n    });\n};\n\nconst SchemaItem = defineComponent({\n    name: 'SchemaItem',\n    props: {\n        field: { type: Object as PropType<SchemaNode>, required: true },\n        form: { type: Object as PropType<SchemaFormEngineApi>, required: true },\n    },\n    setup(props, { slots }) {\n        const shouldShow = ref(true);\n\n        const resolveVisibility = (values: FormValues): boolean => {\n            if (!props.field.if) {\n                return true;\n            }\n\n            return Boolean(evaluateCondition(props.field.if, buildConditionData(props.form, props.field, values)));\n        };\n\n        const update = () => {\n            shouldShow.value = resolveVisibility(props.form.store.state.values);\n        };\n\n        update();\n        const unsubscribe = props.form.store.subscribe(update);\n        onBeforeUnmount(unsubscribe);\n\n        return () => {\n            if (!shouldShow.value) {\n                return props.field.hideOnIf ? h('div', { style: { display: 'none' } }, slots.default?.()) : null;\n            }\n\n            return slots.default?.();\n        };\n    },\n});\n\nconst SchemaRenderer = defineComponent({\n    name: 'SchemaRenderer',\n    props: {\n        schema: { type: null as unknown as PropType<SchemaRenderable>, required: true },\n    },\n    setup(props) {\n        const form = provideAwareForm();\n\n        return () => {\n            const schema = props.schema;\n\n            if (typeof schema === 'string') {\n                return schema;\n            }\n\n            if (Array.isArray(schema)) {\n                return schema.map((schemaItem, index) => {\n                    if (typeof schemaItem === 'string') {\n                        return schemaItem;\n                    }\n\n                    if (!isRecord(schemaItem)) {\n                        return null;\n                    }\n\n                    return renderSchemaItem(schemaItem as SchemaNode, index, form);\n                });\n            }\n\n            if (schema.$field || schema.$cmp === 'Field') {\n                return renderFormField(schema, form);\n            }\n\n            if (schema.$el) {\n                return renderHtmlElement(schema);\n            }\n\n            if (schema.$cmp) {\n                return renderFormComponent(schema);\n            }\n\n            console.warn('Unknown schema item:', schema);\n            return null;\n        };\n    },\n});\n\nconst provideAwareForm = (): SchemaFormEngineApi => {\n    const form = inject(SchemaEngineContextKey, null);\n    if (!form) {\n        throw new Error('SchemaRenderer must be used within SchemaFormEngine.');\n    }\n    return form;\n};\n\nexport const useSchemaFormEngine = ({\n    schemaIndex = null,\n    defaultValues = {},\n    errors,\n    onChange,\n    getConditionContext,\n    parentForm,\n    parentPath,\n}: SchemaFormEngineOptions): SchemaFormEngineApi => {\n    if (!schemaIndex) {\n        throw new Error('SchemaFormEngine requires a compiled schemaIndex.');\n    }\n\n    const index = {\n        ...schemaIndex,\n        schema: normalizeSchema(schemaIndex.schema),\n    };\n    const store = new FormStateStore(defaultValues);\n    const validationEngine = createValidationEngine(index, { conditionDataResolver: getConditionContext });\n    const labelMap = new Map<string, string>();\n    const nestedForms = new Map<string, NestedFormApi>();\n    const formRef = shallowRef<SchemaFormEngineApi | null>(null);\n    const Field = createEngineFieldComponent(formRef);\n\n    index.fieldEntries.forEach((entry) => {\n        if (entry.path) {\n            const label = String(entry.field?.label || entry.field?.name || entry.path);\n            labelMap.set(entry.path, label);\n        }\n    });\n\n    let onSubmitHandler: ((value: FormValues) => Promise<void> | void) | null = null;\n    let onErrorHandler: ((errors: Record<string, unknown>) => void) | null = null;\n    let onSuccessHandler: ((value: FormValues) => void) | null = null;\n    let onChangeHandler: ((value: FormValues) => void) | null = onChange\n        ? (value) => {\n            if (formRef.value) {\n                onChange(value, formRef.value);\n            }\n        }\n        : null;\n\n    const validateNestedForms = (): Record<string, string[]> => {\n        const nestedErrors: Record<string, string[]> = {};\n\n        nestedForms.forEach((api, path) => {\n            const result = api.validate();\n            if (result?.fields) {\n                Object.entries(result.fields).forEach(([fieldPath, messages]) => {\n                    const mergedPath = fieldPath ? `${path}.${fieldPath}` : path;\n                    nestedErrors[mergedPath] = messages;\n                });\n            }\n        });\n\n        return nestedErrors;\n    };\n\n    const getGroupedErrorsForPath = (path: string): string[] => {\n        if (!path) {\n            return [];\n        }\n\n        const currentErrors = store.state.errors || {};\n        const rootErrors = currentErrors[path] || [];\n        const childKeys = Object.keys(currentErrors).filter((key) => key.startsWith(`${path}.`));\n\n        if (!childKeys.length) {\n            return rootErrors;\n        }\n\n        const parentLabel = labelMap.get(path);\n        const groupedMessages: string[] = [];\n\n        childKeys.forEach((key) => {\n            const wildcardPath = key.replace(/\\.\\d+(?=\\.|$)/g, '.*');\n            const childLabel = labelMap.get(wildcardPath) || key.split('.').slice(-1)[0];\n            (currentErrors[key] || []).forEach((message) => {\n                if (parentLabel) {\n                    groupedMessages.push(buildGroupedMessage(String(message), parentLabel, childLabel));\n                    return;\n                }\n\n                groupedMessages.push(String(message));\n            });\n        });\n\n        return Array.from(new Set([...rootErrors, ...groupedMessages]));\n    };\n\n    const handleSubmit = async (): Promise<void> => {\n        const result = validationEngine.validate(store.state.values);\n        const errorsMap = result?.fields || {};\n        const nestedErrors = validateNestedForms();\n        const mergedErrors = { ...errorsMap, ...nestedErrors };\n\n        if (Object.keys(mergedErrors).length > 0) {\n            store.setErrors(mergedErrors);\n            onErrorHandler?.(mergedErrors);\n            return;\n        }\n\n        store.clearErrors();\n        await onSubmitHandler?.(store.state.values);\n\n        if (parentForm && parentPath) {\n            parentForm.setFieldValue(parentPath, store.state.values);\n        }\n\n        onSuccessHandler?.(store.state.values);\n    };\n\n    const form: SchemaFormEngineApi = {\n        schema: index.schema,\n        store,\n        index,\n        Field,\n        getFieldValue: (path: string) => store.getValue(path),\n        setFieldValue: (path: string, value: unknown) => store.setValue(path, value),\n        getErrorMapFields: () => store.state.errors || {},\n        SchemaRenderer,\n        handleSubmit,\n        onChange: (handler) => {\n            onChangeHandler = handler;\n        },\n        onSubmit: (handler) => {\n            onSubmitHandler = handler;\n        },\n        onError: (handler) => {\n            onErrorHandler = handler;\n        },\n        onSuccess: (handler) => {\n            onSuccessHandler = handler;\n        },\n        registerNestedForm: (path, api) => {\n            nestedForms.set(path, api);\n        },\n        unregisterNestedForm: (path) => {\n            nestedForms.delete(path);\n        },\n        getGroupedErrorsForPath,\n        getConditionContext: (values, field) => getConditionContext?.(values, field) || {},\n    };\n\n    formRef.value = form;\n\n    const unsubscribeChange = store.subscribe(() => {\n        onChangeHandler?.(store.state.values);\n    });\n    onBeforeUnmount(unsubscribeChange);\n\n    const normalized = normalizeServerErrors(errors);\n    if (Object.keys(normalized).length) {\n        store.setErrors(normalized);\n    }\n\n    if (parentForm && parentPath) {\n        const nestedApi: NestedFormApi = {\n            path: parentPath,\n            validate: () => {\n                const result = validationEngine.validate(store.state.values);\n                const fieldErrors = result?.fields || {};\n\n                if (Object.keys(fieldErrors).length) {\n                    store.setErrors(fieldErrors);\n                } else {\n                    store.clearErrors();\n                }\n\n                return result;\n            },\n            getValues: () => store.state.values,\n        };\n\n        parentForm.registerNestedForm(parentPath, nestedApi);\n        onBeforeUnmount(() => {\n            parentForm.unregisterNestedForm(parentPath);\n        });\n    }\n\n    return form;\n};\n\nexport const SchemaFormEngine = defineComponent({\n    name: 'SchemaFormEngine',\n    props: {\n        form: { type: Object as PropType<SchemaFormEngineApi>, required: true },\n        class: { type: null as unknown as PropType<unknown>, default: undefined },\n        withoutForm: { type: Boolean, default: false },\n    },\n    setup(props, { expose }) {\n        expose(props.form);\n        provide(SchemaEngineContextKey, props.form);\n\n        return () => {\n            const content = h(SchemaRenderer, { schema: props.form.schema });\n\n            if (props.withoutForm) {\n                return h('div', { class: props.class }, content);\n            }\n\n            return h(\n                'form',\n                {\n                    class: props.class,\n                    onSubmit: (event: Event) => {\n                        event.preventDefault();\n                        event.stopPropagation();\n                        void props.form.handleSubmit();\n                    },\n                },\n                [\n                    content,\n                    h('button', {\n                        type: 'submit',\n                        tabindex: -1,\n                        'aria-hidden': 'true',\n                        class: 'sr-only',\n                    }),\n                ],\n            );\n        };\n    },\n});\n"],"mappings":"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"}

package/dist/forms/SchemaFormFieldNode.d.ts

@@ -0,0 +1,41 @@
+import { PropType } from 'vue';
+import { SchemaNode } from '@verbb/plugin-kit-forms';
+import { SchemaFormEngineApi } from './engine/context.js';
+export declare const SchemaFormFieldNode: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    fieldType: {
+        type: StringConstructor;
+        required: true;
+    };
+    schema: {
+        type: PropType<SchemaNode>;
+        required: true;
+    };
+    field: {
+        type: PropType<SchemaNode>;
+        required: true;
+    };
+    form: {
+        type: PropType<SchemaFormEngineApi>;
+        required: true;
+    };
+}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}> | null, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    fieldType: {
+        type: StringConstructor;
+        required: true;
+    };
+    schema: {
+        type: PropType<SchemaNode>;
+        required: true;
+    };
+    field: {
+        type: PropType<SchemaNode>;
+        required: true;
+    };
+    form: {
+        type: PropType<SchemaFormEngineApi>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+//# sourceMappingURL=SchemaFormFieldNode.d.ts.map

package/dist/forms/SchemaFormFieldNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaFormFieldNode.d.ts","sourceRoot":"","sources":["../../src/forms/SchemaFormFieldNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAMH,KAAK,QAAQ,EAChB,MAAM,KAAK,CAAC;AACb,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,mBAAmB,EAA4B,MAAM,qBAAqB,CAAC;AAMzF,eAAO,MAAM,mBAAmB;;;;;;cAIE,QAAQ,CAAC,UAAU,CAAC;;;;cACrB,QAAQ,CAAC,UAAU,CAAC;;;;cACrB,QAAQ,CAAC,mBAAmB,CAAC;;;;;;;;;;;cAF3B,QAAQ,CAAC,UAAU,CAAC;;;;cACrB,QAAQ,CAAC,UAAU,CAAC;;;;cACrB,QAAQ,CAAC,mBAAmB,CAAC;;;iGAiE3D,CAAC"}

package/dist/forms/SchemaFormFieldNode.js

@@ -0,0 +1,73 @@
+import { cacheLoadedBuiltinFormField, getRegisteredFormField } from "./registry.js";
+import { isBuiltinFormFieldType, loadBuiltinFormField } from "./builtin-field-loaders.js";
+import { defineComponent, h, onMounted, ref, watch } from "vue";
+//#region src/forms/SchemaFormFieldNode.ts
+var SchemaFormFieldNode = defineComponent({
+	name: "SchemaFormFieldNode",
+	props: {
+		fieldType: {
+			type: String,
+			required: true
+		},
+		schema: {
+			type: Object,
+			required: true
+		},
+		field: {
+			type: Object,
+			required: true
+		},
+		form: {
+			type: Object,
+			required: true
+		}
+	},
+	setup(props, { slots }) {
+		const component = ref(getRegisteredFormField(props.fieldType) ?? null);
+		const loadFailed = ref(false);
+		const loadComponent = async (fieldType) => {
+			const registeredField = getRegisteredFormField(fieldType);
+			if (registeredField) {
+				component.value = registeredField;
+				loadFailed.value = false;
+				return;
+			}
+			if (!isBuiltinFormFieldType(fieldType)) {
+				console.warn(`Unknown form field type: ${fieldType}`);
+				component.value = null;
+				loadFailed.value = true;
+				return;
+			}
+			loadFailed.value = false;
+			try {
+				const loaded = await loadBuiltinFormField(fieldType);
+				if (!loaded || fieldType !== props.fieldType) return;
+				cacheLoadedBuiltinFormField(fieldType, loaded);
+				component.value = loaded;
+			} catch (error) {
+				if (fieldType !== props.fieldType) return;
+				console.error(`Failed to load form field "${fieldType}":`, error);
+				component.value = null;
+				loadFailed.value = true;
+			}
+		};
+		onMounted(() => {
+			loadComponent(props.fieldType);
+		});
+		watch(() => props.fieldType, (fieldType) => {
+			loadComponent(fieldType);
+		});
+		return () => {
+			if (loadFailed.value || !component.value) return null;
+			return h(component.value, {
+				schema: props.schema,
+				field: props.field,
+				form: props.form
+			}, slots);
+		};
+	}
+});
+//#endregion
+export { SchemaFormFieldNode };
+
+//# sourceMappingURL=SchemaFormFieldNode.js.map

package/dist/forms/SchemaFormFieldNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaFormFieldNode.js","names":[],"sources":["../../src/forms/SchemaFormFieldNode.ts"],"sourcesContent":["import {\n    defineComponent,\n    h,\n    onMounted,\n    ref,\n    watch,\n    type PropType,\n} from 'vue';\nimport type { SchemaNode } from '@verbb/plugin-kit-forms';\n\nimport { isBuiltinFormFieldType, loadBuiltinFormField } from './builtin-field-loaders.js';\nimport type { SchemaFormEngineApi, SchemaFormFieldComponent } from './engine/context.js';\nimport {\n    cacheLoadedBuiltinFormField,\n    getRegisteredFormField,\n} from './registry.js';\n\nexport const SchemaFormFieldNode = defineComponent({\n    name: 'SchemaFormFieldNode',\n    props: {\n        fieldType: { type: String, required: true },\n        schema: { type: Object as PropType<SchemaNode>, required: true },\n        field: { type: Object as PropType<SchemaNode>, required: true },\n        form: { type: Object as PropType<SchemaFormEngineApi>, required: true },\n    },\n    setup(props, { slots }) {\n        const component = ref<SchemaFormFieldComponent | null>(getRegisteredFormField(props.fieldType) ?? null);\n        const loadFailed = ref(false);\n\n        const loadComponent = async (fieldType: string): Promise<void> => {\n            const registeredField = getRegisteredFormField(fieldType);\n            if (registeredField) {\n                component.value = registeredField;\n                loadFailed.value = false;\n                return;\n            }\n\n            if (!isBuiltinFormFieldType(fieldType)) {\n                console.warn(`Unknown form field type: ${fieldType}`);\n                component.value = null;\n                loadFailed.value = true;\n                return;\n            }\n\n            loadFailed.value = false;\n\n            try {\n                const loaded = await loadBuiltinFormField(fieldType);\n                if (!loaded || fieldType !== props.fieldType) {\n                    return;\n                }\n\n                cacheLoadedBuiltinFormField(fieldType, loaded);\n                component.value = loaded;\n            } catch (error) {\n                if (fieldType !== props.fieldType) {\n                    return;\n                }\n\n                console.error(`Failed to load form field \"${fieldType}\":`, error);\n                component.value = null;\n                loadFailed.value = true;\n            }\n        };\n\n        onMounted(() => {\n            void loadComponent(props.fieldType);\n        });\n        watch(() => props.fieldType, (fieldType) => {\n            void loadComponent(fieldType);\n        });\n\n        return () => {\n            if (loadFailed.value || !component.value) {\n                return null;\n            }\n\n            return h(\n                component.value,\n                {\n                    schema: props.schema,\n                    field: props.field,\n                    form: props.form,\n                },\n                slots,\n            );\n        };\n    },\n});\n"],"mappings":";;;;AAiBA,IAAa,sBAAsB,gBAAgB;CAC/C,MAAM;CACN,OAAO;EACH,WAAW;GAAE,MAAM;GAAQ,UAAU;GAAM;EAC3C,QAAQ;GAAE,MAAM;GAAgC,UAAU;GAAM;EAChE,OAAO;GAAE,MAAM;GAAgC,UAAU;GAAM;EAC/D,MAAM;GAAE,MAAM;GAAyC,UAAU;GAAM;EAC1E;CACD,MAAM,OAAO,EAAE,SAAS;EACpB,MAAM,YAAY,IAAqC,uBAAuB,MAAM,UAAU,IAAI,KAAK;EACvG,MAAM,aAAa,IAAI,MAAM;EAE7B,MAAM,gBAAgB,OAAO,cAAqC;GAC9D,MAAM,kBAAkB,uBAAuB,UAAU;AACzD,OAAI,iBAAiB;AACjB,cAAU,QAAQ;AAClB,eAAW,QAAQ;AACnB;;AAGJ,OAAI,CAAC,uBAAuB,UAAU,EAAE;AACpC,YAAQ,KAAK,4BAA4B,YAAY;AACrD,cAAU,QAAQ;AAClB,eAAW,QAAQ;AACnB;;AAGJ,cAAW,QAAQ;AAEnB,OAAI;IACA,MAAM,SAAS,MAAM,qBAAqB,UAAU;AACpD,QAAI,CAAC,UAAU,cAAc,MAAM,UAC/B;AAGJ,gCAA4B,WAAW,OAAO;AAC9C,cAAU,QAAQ;YACb,OAAO;AACZ,QAAI,cAAc,MAAM,UACpB;AAGJ,YAAQ,MAAM,8BAA8B,UAAU,KAAK,MAAM;AACjE,cAAU,QAAQ;AAClB,eAAW,QAAQ;;;AAI3B,kBAAgB;AACP,iBAAc,MAAM,UAAU;IACrC;AACF,cAAY,MAAM,YAAY,cAAc;AACnC,iBAAc,UAAU;IAC/B;AAEF,eAAa;AACT,OAAI,WAAW,SAAS,CAAC,UAAU,MAC/B,QAAO;AAGX,UAAO,EACH,UAAU,OACV;IACI,QAAQ,MAAM;IACd,OAAO,MAAM;IACb,MAAM,MAAM;IACf,EACD,MACH;;;CAGZ,CAAC"}

package/dist/forms/assertSchemaRegistry.d.ts

@@ -0,0 +1,17 @@
+import { SchemaIndex, SchemaRenderable } from '@verbb/plugin-kit-forms';
+export type AssertSchemaRegistryOptions = {
+    /** When true, throw on the first missing registry key instead of collecting all. */
+    failFast?: boolean;
+};
+export type SchemaRegistryIssue = {
+    path: string;
+    kind: 'field' | 'component';
+    key: string;
+};
+/**
+ * Walk a SchemaForm tree and verify every `$field` / `$cmp` key can resolve.
+ * Useful in dev/test bootstraps before shipping large CP schemas.
+ */
+export declare const assertSchemaRegistry: (schema: SchemaRenderable, options?: AssertSchemaRegistryOptions) => SchemaRegistryIssue[];
+export declare const debugSchemaRegistry: (schemaIndex: SchemaIndex | null | undefined, options?: AssertSchemaRegistryOptions) => SchemaRegistryIssue[];
+//# sourceMappingURL=assertSchemaRegistry.d.ts.map

package/dist/forms/assertSchemaRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertSchemaRegistry.d.ts","sourceRoot":"","sources":["../../src/forms/assertSchemaRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAMzF,MAAM,MAAM,2BAA2B,GAAG;IACtC,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAwCF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC7B,QAAQ,gBAAgB,EACxB,UAAS,2BAAgC,KAC1C,mBAAmB,EA+BrB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC5B,aAAa,WAAW,GAAG,IAAI,GAAG,SAAS,EAC3C,UAAU,2BAA2B,KACtC,mBAAmB,EAYrB,CAAC"}

package/dist/forms/assertSchemaRegistry.js

@@ -0,0 +1,68 @@
+import { getFormComponentRegistry, getFormFieldRegistry } from "./registry.js";
+import { isBuiltinFormFieldType } from "./builtin-field-loaders.js";
+import { isRecord } from "./utils.js";
+//#region src/forms/assertSchemaRegistry.ts
+var walkSchema = (schema, path, visit) => {
+	if (typeof schema === "string") return;
+	if (Array.isArray(schema)) {
+		schema.forEach((item, index) => {
+			if (typeof item === "string" || !isRecord(item)) return;
+			const itemPath = `${path}[${index}]`;
+			visit(item, itemPath);
+			walkSchema(item, itemPath, visit);
+		});
+		return;
+	}
+	if (!isRecord(schema)) return;
+	const node = schema;
+	visit(node, path);
+	if (node.children) walkSchema(node.children, `${path}.children`, visit);
+	if (node.schema) walkSchema(node.schema, `${path}.schema`, visit);
+};
+/**
+* Walk a SchemaForm tree and verify every `$field` / `$cmp` key can resolve.
+* Useful in dev/test bootstraps before shipping large CP schemas.
+*/
+var assertSchemaRegistry = (schema, options = {}) => {
+	const { failFast = false } = options;
+	const fieldRegistry = getFormFieldRegistry();
+	const componentRegistry = getFormComponentRegistry();
+	const issues = [];
+	walkSchema(schema, "schema", (node, nodePath) => {
+		if (node.$field) {
+			const key = String(node.$field);
+			if (!fieldRegistry[key] && !isBuiltinFormFieldType(key)) {
+				const issue = {
+					path: nodePath,
+					kind: "field",
+					key
+				};
+				issues.push(issue);
+				if (failFast) throw new Error(`SchemaForm: unregistered field "${key}" at ${nodePath}`);
+			}
+		}
+		if (node.$cmp) {
+			const key = String(node.$cmp);
+			if (!componentRegistry[key]) {
+				const issue = {
+					path: nodePath,
+					kind: "component",
+					key
+				};
+				issues.push(issue);
+				if (failFast) throw new Error(`SchemaForm: unregistered component "${key}" at ${nodePath}`);
+			}
+		}
+	});
+	return issues;
+};
+var debugSchemaRegistry = (schemaIndex, options) => {
+	if (!schemaIndex?.schema) return [];
+	const issues = assertSchemaRegistry(schemaIndex.schema, options);
+	if (issues.length) console.warn("[plugin-kit] SchemaForm registry gaps:", issues);
+	return issues;
+};
+//#endregion
+export { assertSchemaRegistry, debugSchemaRegistry };
+
+//# sourceMappingURL=assertSchemaRegistry.js.map

package/dist/forms/assertSchemaRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertSchemaRegistry.js","names":[],"sources":["../../src/forms/assertSchemaRegistry.ts"],"sourcesContent":["import type { SchemaIndex, SchemaNode, SchemaRenderable } from '@verbb/plugin-kit-forms';\n\nimport { isBuiltinFormFieldType } from './builtin-field-loaders.js';\nimport { getFormComponentRegistry, getFormFieldRegistry } from './registry.js';\nimport { isRecord } from './utils.js';\n\nexport type AssertSchemaRegistryOptions = {\n    /** When true, throw on the first missing registry key instead of collecting all. */\n    failFast?: boolean;\n};\n\nexport type SchemaRegistryIssue = {\n    path: string;\n    kind: 'field' | 'component';\n    key: string;\n};\n\nconst walkSchema = (\n    schema: SchemaRenderable,\n    path: string,\n    visit: (node: SchemaNode, path: string) => void,\n): void => {\n    if (typeof schema === 'string') {\n        return;\n    }\n\n    if (Array.isArray(schema)) {\n        schema.forEach((item, index) => {\n            if (typeof item === 'string' || !isRecord(item)) {\n                return;\n            }\n\n            const itemPath = `${path}[${index}]`;\n            visit(item as SchemaNode, itemPath);\n            walkSchema(item as SchemaRenderable, itemPath, visit);\n        });\n        return;\n    }\n\n    if (!isRecord(schema)) {\n        return;\n    }\n\n    const node = schema as SchemaNode;\n    visit(node, path);\n\n    if (node.children) {\n        walkSchema(node.children as SchemaRenderable, `${path}.children`, visit);\n    }\n\n    if (node.schema) {\n        walkSchema(node.schema as SchemaRenderable, `${path}.schema`, visit);\n    }\n};\n\n/**\n * Walk a SchemaForm tree and verify every `$field` / `$cmp` key can resolve.\n * Useful in dev/test bootstraps before shipping large CP schemas.\n */\nexport const assertSchemaRegistry = (\n    schema: SchemaRenderable,\n    options: AssertSchemaRegistryOptions = {},\n): SchemaRegistryIssue[] => {\n    const { failFast = false } = options;\n    const fieldRegistry = getFormFieldRegistry();\n    const componentRegistry = getFormComponentRegistry();\n    const issues: SchemaRegistryIssue[] = [];\n\n    walkSchema(schema, 'schema', (node, nodePath) => {\n        if (node.$field) {\n            const key = String(node.$field);\n            if (!fieldRegistry[key] && !isBuiltinFormFieldType(key)) {\n                const issue: SchemaRegistryIssue = { path: nodePath, kind: 'field', key };\n                issues.push(issue);\n                if (failFast) {\n                    throw new Error(`SchemaForm: unregistered field \"${key}\" at ${nodePath}`);\n                }\n            }\n        }\n\n        if (node.$cmp) {\n            const key = String(node.$cmp);\n            if (!componentRegistry[key]) {\n                const issue: SchemaRegistryIssue = { path: nodePath, kind: 'component', key };\n                issues.push(issue);\n                if (failFast) {\n                    throw new Error(`SchemaForm: unregistered component \"${key}\" at ${nodePath}`);\n                }\n            }\n        }\n    });\n\n    return issues;\n};\n\nexport const debugSchemaRegistry = (\n    schemaIndex: SchemaIndex | null | undefined,\n    options?: AssertSchemaRegistryOptions,\n): SchemaRegistryIssue[] => {\n    if (!schemaIndex?.schema) {\n        return [];\n    }\n\n    const issues = assertSchemaRegistry(schemaIndex.schema, options);\n\n    if (issues.length) {\n        console.warn('[plugin-kit] SchemaForm registry gaps:', issues);\n    }\n\n    return issues;\n};\n"],"mappings":";;;;AAiBA,IAAM,cACF,QACA,MACA,UACO;AACP,KAAI,OAAO,WAAW,SAClB;AAGJ,KAAI,MAAM,QAAQ,OAAO,EAAE;AACvB,SAAO,SAAS,MAAM,UAAU;AAC5B,OAAI,OAAO,SAAS,YAAY,CAAC,SAAS,KAAK,CAC3C;GAGJ,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM;AAClC,SAAM,MAAoB,SAAS;AACnC,cAAW,MAA0B,UAAU,MAAM;IACvD;AACF;;AAGJ,KAAI,CAAC,SAAS,OAAO,CACjB;CAGJ,MAAM,OAAO;AACb,OAAM,MAAM,KAAK;AAEjB,KAAI,KAAK,SACL,YAAW,KAAK,UAA8B,GAAG,KAAK,YAAY,MAAM;AAG5E,KAAI,KAAK,OACL,YAAW,KAAK,QAA4B,GAAG,KAAK,UAAU,MAAM;;;;;;AAQ5E,IAAa,wBACT,QACA,UAAuC,EAAE,KACjB;CACxB,MAAM,EAAE,WAAW,UAAU;CAC7B,MAAM,gBAAgB,sBAAsB;CAC5C,MAAM,oBAAoB,0BAA0B;CACpD,MAAM,SAAgC,EAAE;AAExC,YAAW,QAAQ,WAAW,MAAM,aAAa;AAC7C,MAAI,KAAK,QAAQ;GACb,MAAM,MAAM,OAAO,KAAK,OAAO;AAC/B,OAAI,CAAC,cAAc,QAAQ,CAAC,uBAAuB,IAAI,EAAE;IACrD,MAAM,QAA6B;KAAE,MAAM;KAAU,MAAM;KAAS;KAAK;AACzE,WAAO,KAAK,MAAM;AAClB,QAAI,SACA,OAAM,IAAI,MAAM,mCAAmC,IAAI,OAAO,WAAW;;;AAKrF,MAAI,KAAK,MAAM;GACX,MAAM,MAAM,OAAO,KAAK,KAAK;AAC7B,OAAI,CAAC,kBAAkB,MAAM;IACzB,MAAM,QAA6B;KAAE,MAAM;KAAU,MAAM;KAAa;KAAK;AAC7E,WAAO,KAAK,MAAM;AAClB,QAAI,SACA,OAAM,IAAI,MAAM,uCAAuC,IAAI,OAAO,WAAW;;;GAI3F;AAEF,QAAO;;AAGX,IAAa,uBACT,aACA,YACwB;AACxB,KAAI,CAAC,aAAa,OACd,QAAO,EAAE;CAGb,MAAM,SAAS,qBAAqB,YAAY,QAAQ,QAAQ;AAEhE,KAAI,OAAO,OACP,SAAQ,KAAK,0CAA0C,OAAO;AAGlE,QAAO"}