@verbb/plugin-kit-react 1.0.0

package/dist/forms/components/ModalTabs.js

@@ -0,0 +1,84 @@
+import { cn } from "../../utils/classes.js";
+import { hasSchemaErrorsCached } from "../../utils/schemaIndexCache.js";
+import "../../utils/index.js";
+import { ModalTabs as ModalTabs$1, ModalTabsContent as ModalTabsContent$1, ModalTabsList as ModalTabsList$1, ModalTabsTrigger as ModalTabsTrigger$1 } from "../../components/ModalTabs.js";
+import "../../components/index.js";
+import { SchemaEngineContext } from "../engine/context.js";
+import { createContext, useCallback, useContext, useEffect, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { FontAwesomeIcon } from "@fortawesome/react-fontawesome";
+import { faTriangleExclamation } from "@fortawesome/pro-solid-svg-icons";
+//#region src/forms/components/ModalTabs.tsx
+var ModalTabsErrorsContext = createContext({});
+var useModalTabsErrors = () => {
+	return useContext(ModalTabsErrorsContext);
+};
+var ModalTabs = Object.assign(({ children, schema, schemaNode, ...props }) => {
+	const form = useContext(SchemaEngineContext);
+	const node = schemaNode ?? schema;
+	const [tabErrors, setTabErrors] = useState({});
+	const getTabErrors = useCallback(() => {
+		const errors = {};
+		if (!node?.children || !form?.getErrorMapFields) return errors;
+		const formErrors = form.getErrorMapFields?.() || {};
+		Object.values(node.children).forEach((item) => {
+			if (typeof item !== "object" || item === null || Array.isArray(item)) return;
+			const childNode = item;
+			const value = typeof childNode.props?.value === "string" ? childNode.props.value : "";
+			if (childNode.$cmp === "ModalTabsContent" && value) errors[value] = hasSchemaErrorsCached(formErrors, childNode.children || []);
+		});
+		return errors;
+	}, [form, node]);
+	useEffect(() => {
+		if (!form?.store?.subscribe) {
+			setTabErrors(getTabErrors());
+			return;
+		}
+		const update = () => {
+			setTabErrors(getTabErrors());
+		};
+		update();
+		return form.store.subscribe(update);
+	}, [form, getTabErrors]);
+	return /* @__PURE__ */ jsx(ModalTabsErrorsContext.Provider, {
+		value: tabErrors,
+		children: /* @__PURE__ */ jsx(ModalTabs$1, {
+			...props,
+			children
+		})
+	});
+}, { usesSchemaNode: true });
+function ModalTabsList({ children, ...props }) {
+	return /* @__PURE__ */ jsx(ModalTabsList$1, {
+		...props,
+		children
+	});
+}
+function ModalTabsTrigger({ children, value, ...props }) {
+	const tabErrors = useModalTabsErrors();
+	const hasErrors = Boolean(tabErrors[value]);
+	return /* @__PURE__ */ jsxs(ModalTabsTrigger$1, {
+		value,
+		"data-has-errors": hasErrors,
+		className: cn("flex items-center gap-1", hasErrors && "text-error"),
+		...props,
+		children: [children, hasErrors && /* @__PURE__ */ jsx(FontAwesomeIcon, {
+			icon: faTriangleExclamation,
+			className: "block size-3"
+		})]
+	});
+}
+function ModalTabsContent({ children, value, ...props }) {
+	return /* @__PURE__ */ jsx(ModalTabsContent$1, {
+		value,
+		...props,
+		children: /* @__PURE__ */ jsx("div", {
+			className: cn("grid grid-cols-1 gap-4"),
+			children
+		})
+	});
+}
+//#endregion
+export { ModalTabs, ModalTabsContent, ModalTabsList, ModalTabsTrigger, useModalTabsErrors };
+
+//# sourceMappingURL=ModalTabs.js.map

package/dist/forms/components/ModalTabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalTabs.js","names":[],"sources":["../../../src/forms/components/ModalTabs.tsx"],"sourcesContent":["import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';\nimport { faTriangleExclamation } from '@fortawesome/pro-solid-svg-icons';\n\nimport {\n    ModalTabs as BaseModalTabs,\n    ModalTabsList as BaseModalTabsList,\n    ModalTabsTrigger as BaseModalTabsTrigger,\n    ModalTabsContent as BaseModalTabsContent,\n} from '../../components';\n\nimport { cn } from '../../utils';\nimport { hasSchemaErrorsCached } from '../../utils/schemaIndexCache';\n\nimport {\n    createContext, useCallback, useContext, useEffect, useState,\n} from 'react';\n\nimport type { SchemaFormComponentProps } from '../engine/context';\nimport { SchemaEngineContext } from '../engine/context';\nimport type { SchemaNode } from '../engine/SchemaIndex';\n\n// Create a context to pass tab error information down\nconst ModalTabsErrorsContext = createContext<Record<string, boolean>>({});\n\nexport const useModalTabsErrors = () => {\n    return useContext(ModalTabsErrorsContext);\n};\n\nconst ModalTabs = Object.assign(({\n    children, schema, schemaNode, ...props\n}: SchemaFormComponentProps) => {\n    const form = useContext(SchemaEngineContext);\n    const node = schemaNode ?? schema;\n\n    const [tabErrors, setTabErrors] = useState<Record<string, boolean>>({});\n\n    const getTabErrors = useCallback(() => {\n        const errors: Record<string, boolean> = {};\n\n        if (!node?.children || !form?.getErrorMapFields) {\n            return errors;\n        }\n\n        const formErrors = form.getErrorMapFields?.() || {};\n\n        // Process schema children to find tab content\n        Object.values(node.children as Record<string, unknown>).forEach((item) => {\n            if (typeof item !== 'object' || item === null || Array.isArray(item)) {\n                return;\n            }\n\n            const childNode = item as SchemaNode;\n            const value = typeof childNode.props?.value === 'string' ? childNode.props.value : '';\n            if (childNode.$cmp === 'ModalTabsContent' && value) {\n                errors[value] = hasSchemaErrorsCached(formErrors, childNode.children || []);\n            }\n        });\n\n        return errors;\n    }, [form, node]);\n\n    useEffect(() => {\n        if (!form?.store?.subscribe) {\n            setTabErrors(getTabErrors());\n            return;\n        }\n\n        const update = () => {\n            setTabErrors(getTabErrors());\n        };\n\n        update();\n        const unsubscribe = form.store.subscribe(update);\n        return unsubscribe;\n    }, [form, getTabErrors]);\n\n    return (\n        <ModalTabsErrorsContext.Provider value={tabErrors}>\n            <BaseModalTabs {...props}>{children}</BaseModalTabs>\n        </ModalTabsErrorsContext.Provider>\n    );\n}, { usesSchemaNode: true as const });\n\nfunction ModalTabsList({ children, ...props }) {\n    return <BaseModalTabsList {...props}>{children}</BaseModalTabsList>;\n}\n\nfunction ModalTabsTrigger({ children, value, ...props }) {\n    // Get tab errors from context\n    const tabErrors = useModalTabsErrors();\n\n    // Check if this specific tab has errors\n    const hasErrors = Boolean(tabErrors[value]);\n\n    return <BaseModalTabsTrigger\n        value={value}\n        data-has-errors={hasErrors}\n        className={cn(\n            'flex items-center gap-1',\n            hasErrors && 'text-error',\n        )}\n        {...props}\n    >\n        {children}\n\n        {hasErrors && (\n            <FontAwesomeIcon icon={faTriangleExclamation} className=\"block size-3\" />\n        )}\n    </BaseModalTabsTrigger>;\n}\n\nfunction ModalTabsContent({\n    children, value, ...props\n}) {\n    return (\n        <BaseModalTabsContent value={value} {...props}>\n            <div className={cn(\n                'grid grid-cols-1 gap-4',\n            )}>{children}</div>\n        </BaseModalTabsContent>\n    );\n}\n\nexport {\n    ModalTabs,\n    ModalTabsList,\n    ModalTabsTrigger,\n    ModalTabsContent,\n};\n"],"mappings":";;;;;;;;;;;AAsBA,IAAM,yBAAyB,cAAuC,EAAE,CAAC;AAEzE,IAAa,2BAA2B;AACpC,QAAO,WAAW,uBAAuB;;AAG7C,IAAM,YAAY,OAAO,QAAQ,EAC7B,UAAU,QAAQ,YAAY,GAAG,YACL;CAC5B,MAAM,OAAO,WAAW,oBAAoB;CAC5C,MAAM,OAAO,cAAc;CAE3B,MAAM,CAAC,WAAW,gBAAgB,SAAkC,EAAE,CAAC;CAEvE,MAAM,eAAe,kBAAkB;EACnC,MAAM,SAAkC,EAAE;AAE1C,MAAI,CAAC,MAAM,YAAY,CAAC,MAAM,kBAC1B,QAAO;EAGX,MAAM,aAAa,KAAK,qBAAqB,IAAI,EAAE;AAGnD,SAAO,OAAO,KAAK,SAAoC,CAAC,SAAS,SAAS;AACtE,OAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,MAAM,QAAQ,KAAK,CAChE;GAGJ,MAAM,YAAY;GAClB,MAAM,QAAQ,OAAO,UAAU,OAAO,UAAU,WAAW,UAAU,MAAM,QAAQ;AACnF,OAAI,UAAU,SAAS,sBAAsB,MACzC,QAAO,SAAS,sBAAsB,YAAY,UAAU,YAAY,EAAE,CAAC;IAEjF;AAEF,SAAO;IACR,CAAC,MAAM,KAAK,CAAC;AAEhB,iBAAgB;AACZ,MAAI,CAAC,MAAM,OAAO,WAAW;AACzB,gBAAa,cAAc,CAAC;AAC5B;;EAGJ,MAAM,eAAe;AACjB,gBAAa,cAAc,CAAC;;AAGhC,UAAQ;AAER,SADoB,KAAK,MAAM,UAAU,OAClC;IACR,CAAC,MAAM,aAAa,CAAC;AAExB,QACI,oBAAC,uBAAuB,UAAxB;EAAiC,OAAO;YACpC,oBAAC,aAAD;GAAe,GAAI;GAAQ;GAAyB,CAAA;EACtB,CAAA;GAEvC,EAAE,gBAAgB,MAAe,CAAC;AAErC,SAAS,cAAc,EAAE,UAAU,GAAG,SAAS;AAC3C,QAAO,oBAAC,iBAAD;EAAmB,GAAI;EAAQ;EAA6B,CAAA;;AAGvE,SAAS,iBAAiB,EAAE,UAAU,OAAO,GAAG,SAAS;CAErD,MAAM,YAAY,oBAAoB;CAGtC,MAAM,YAAY,QAAQ,UAAU,OAAO;AAE3C,QAAO,qBAAC,oBAAD;EACI;EACP,mBAAiB;EACjB,WAAW,GACP,2BACA,aAAa,aAChB;EACD,GAAI;YAPD,CASF,UAEA,aACG,oBAAC,iBAAD;GAAiB,MAAM;GAAuB,WAAU;GAAiB,CAAA,CAE1D;;;AAG3B,SAAS,iBAAiB,EACtB,UAAU,OAAO,GAAG,SACrB;AACC,QACI,oBAAC,oBAAD;EAA6B;EAAO,GAAI;YACpC,oBAAC,OAAD;GAAK,WAAW,GACZ,yBACH;GAAG;GAAe,CAAA;EACA,CAAA"}

package/dist/forms/components/index.d.ts

@@ -0,0 +1,3 @@
+export * from './FieldWrap';
+export * from './ModalTabs';
+//# sourceMappingURL=index.d.ts.map

package/dist/forms/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/forms/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/forms/components/index.js

@@ -0,0 +1,3 @@
+import { FieldWrap } from "./FieldWrap.js";
+import { ModalTabs, ModalTabsContent, ModalTabsList, ModalTabsTrigger, useModalTabsErrors } from "./ModalTabs.js";
+export { FieldWrap, ModalTabs, ModalTabsContent, ModalTabsList, ModalTabsTrigger, useModalTabsErrors };

package/dist/forms/contexts/VariableCategoriesContext.d.ts

@@ -0,0 +1,17 @@
+import { VariableTransformerRegistry } from '../../components/tiptap/VariablePickerContext';
+export type VariableConfig = Record<string, unknown>;
+export type VariableCategoriesGetter = (variableConfig: VariableConfig, options?: {
+    form?: unknown;
+}) => Record<string, Array<{
+    label: string;
+    value: string;
+}>>;
+export type VariableCategoriesContextValue = {
+    getVariableCategories: VariableCategoriesGetter | null;
+    variableCategoryLabels?: Record<string, string>;
+    variableCategoryOrder?: string[];
+    variableTransformerRegistry?: VariableTransformerRegistry;
+};
+export declare const VariableCategoriesProvider: import('react').Provider<VariableCategoriesContextValue | null>;
+export declare const useVariableCategoriesContext: () => VariableCategoriesContextValue;
+//# sourceMappingURL=VariableCategoriesContext.d.ts.map

package/dist/forms/contexts/VariableCategoriesContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableCategoriesContext.d.ts","sourceRoot":"","sources":["../../../src/forms/contexts/VariableCategoriesContext.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AAEnH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,MAAM,MAAM,wBAAwB,GAAG,CACnC,cAAc,EAAE,cAAc,EAC9B,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,KAC3B,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAE7D,MAAM,MAAM,8BAA8B,GAAG;IACzC,qBAAqB,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACvD,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;CAC7D,CAAC;AAIF,eAAO,MAAM,0BAA0B,iEAAqC,CAAC;AAE7E,eAAO,MAAM,4BAA4B,QAAO,8BAY/C,CAAC"}

package/dist/forms/contexts/VariableCategoriesContext.js

@@ -0,0 +1,18 @@
+import { createContext, useContext } from "react";
+//#region src/forms/contexts/VariableCategoriesContext.tsx
+var VariableCategoriesContext = createContext(null);
+var VariableCategoriesProvider = VariableCategoriesContext.Provider;
+var useVariableCategoriesContext = () => {
+	const value = useContext(VariableCategoriesContext);
+	if (value == null) return { getVariableCategories: null };
+	return {
+		getVariableCategories: value.getVariableCategories ?? null,
+		variableCategoryLabels: value.variableCategoryLabels,
+		variableCategoryOrder: value.variableCategoryOrder,
+		variableTransformerRegistry: value.variableTransformerRegistry
+	};
+};
+//#endregion
+export { VariableCategoriesProvider, useVariableCategoriesContext };
+
+//# sourceMappingURL=VariableCategoriesContext.js.map

package/dist/forms/contexts/VariableCategoriesContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableCategoriesContext.js","names":[],"sources":["../../../src/forms/contexts/VariableCategoriesContext.tsx"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { VariableTransformerRegistry } from '@verbb/plugin-kit-react/components/tiptap/VariablePickerContext';\n\nexport type VariableConfig = Record<string, unknown>;\n\nexport type VariableCategoriesGetter = (\n    variableConfig: VariableConfig,\n    options?: { form?: unknown },\n) => Record<string, Array<{ label: string; value: string }>>;\n\nexport type VariableCategoriesContextValue = {\n    getVariableCategories: VariableCategoriesGetter | null;\n    variableCategoryLabels?: Record<string, string>;\n    variableCategoryOrder?: string[];\n    variableTransformerRegistry?: VariableTransformerRegistry;\n};\n\nconst VariableCategoriesContext = createContext<VariableCategoriesContextValue | null>(null);\n\nexport const VariableCategoriesProvider = VariableCategoriesContext.Provider;\n\nexport const useVariableCategoriesContext = (): VariableCategoriesContextValue => {\n    const value = useContext(VariableCategoriesContext);\n    if (value == null) {\n        return { getVariableCategories: null };\n    }\n\n    return {\n        getVariableCategories: value.getVariableCategories ?? null,\n        variableCategoryLabels: value.variableCategoryLabels,\n        variableCategoryOrder: value.variableCategoryOrder,\n        variableTransformerRegistry: value.variableTransformerRegistry,\n    };\n};\n"],"mappings":";;AAiBA,IAAM,4BAA4B,cAAqD,KAAK;AAE5F,IAAa,6BAA6B,0BAA0B;AAEpE,IAAa,qCAAqE;CAC9E,MAAM,QAAQ,WAAW,0BAA0B;AACnD,KAAI,SAAS,KACT,QAAO,EAAE,uBAAuB,MAAM;AAG1C,QAAO;EACH,uBAAuB,MAAM,yBAAyB;EACtD,wBAAwB,MAAM;EAC9B,uBAAuB,MAAM;EAC7B,6BAA6B,MAAM;EACtC"}

package/dist/forms/engine/FormStateStore.d.ts

@@ -0,0 +1,24 @@
+type FormSubscriber = () => void;
+export type FormState = {
+    values: Record<string, unknown>;
+    errors: Record<string, string[]>;
+    touched: Set<string>;
+    dirty: Set<string>;
+};
+export declare class FormStateStore {
+    state: FormState;
+    private listeners;
+    private initialValues;
+    constructor(initialValues?: Record<string, unknown>);
+    subscribe(listener: FormSubscriber): () => void;
+    notify(): void;
+    getValue(path: string): unknown;
+    setValue(path: string, value: unknown): void;
+    setValues(values: Record<string, unknown>): void;
+    setErrors(errors: Record<string, string[]>): void;
+    clearErrors(): void;
+    setTouched(path: string, touched?: boolean): void;
+    reset(values?: Record<string, unknown>): void;
+}
+export {};
+//# sourceMappingURL=FormStateStore.d.ts.map

package/dist/forms/engine/FormStateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormStateStore.d.ts","sourceRoot":"","sources":["../../../src/forms/engine/FormStateStore.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG,MAAM,IAAI,CAAC;AAEjC,MAAM,MAAM,SAAS,GAAG;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACtB,CAAC;AAEF,qBAAa,cAAc;IACvB,KAAK,EAAE,SAAS,CAAC;IAEjB,OAAO,CAAC,SAAS,CAAkC;IAEnD,OAAO,CAAC,aAAa,CAA0B;gBAEnC,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAUvD,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI;IAO/C,MAAM;IAIN,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IA+BrC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQzC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAQ1C,WAAW;IAQX,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,UAAO;IAoBvC,KAAK,CAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAsB;CAU7D"}

package/dist/forms/engine/FormStateStore.js

@@ -0,0 +1,97 @@
+import { get, set } from "lodash-es";
+//#region src/forms/engine/FormStateStore.ts
+var FormStateStore = class {
+	state;
+	listeners = /* @__PURE__ */ new Set();
+	initialValues;
+	constructor(initialValues = {}) {
+		this.initialValues = { ...initialValues };
+		this.state = {
+			values: { ...initialValues },
+			errors: {},
+			touched: /* @__PURE__ */ new Set(),
+			dirty: /* @__PURE__ */ new Set()
+		};
+	}
+	subscribe(listener) {
+		this.listeners.add(listener);
+		return () => {
+			this.listeners.delete(listener);
+		};
+	}
+	notify() {
+		this.listeners.forEach((listener) => {
+			listener();
+		});
+	}
+	getValue(path) {
+		return get(this.state.values, path);
+	}
+	setValue(path, value) {
+		const nextErrors = { ...this.state.errors };
+		if (path in nextErrors) delete nextErrors[path];
+		if (Array.isArray(value)) {
+			const descendantPrefix = `${path}.`;
+			Object.keys(nextErrors).forEach((key) => {
+				if (key.startsWith(descendantPrefix)) delete nextErrors[key];
+			});
+		}
+		this.state = {
+			...this.state,
+			values: (() => {
+				const cloneRoot = Array.isArray(this.state.values) ? [...this.state.values] : { ...this.state.values ?? {} };
+				set(cloneRoot, path, value);
+				return cloneRoot;
+			})(),
+			dirty: new Set(this.state.dirty).add(path),
+			errors: nextErrors
+		};
+		this.notify();
+	}
+	setValues(values) {
+		this.state = {
+			...this.state,
+			values: { ...values }
+		};
+		this.notify();
+	}
+	setErrors(errors) {
+		this.state = {
+			...this.state,
+			errors: { ...errors }
+		};
+		this.notify();
+	}
+	clearErrors() {
+		this.state = {
+			...this.state,
+			errors: {}
+		};
+		this.notify();
+	}
+	setTouched(path, touched = true) {
+		if (this.state.touched.has(path) === touched) return;
+		const nextTouched = new Set(this.state.touched);
+		if (touched) nextTouched.add(path);
+		else nextTouched.delete(path);
+		this.state = {
+			...this.state,
+			touched: nextTouched
+		};
+		this.notify();
+	}
+	reset(values = this.initialValues) {
+		this.initialValues = { ...values };
+		this.state = {
+			values: { ...values },
+			errors: {},
+			touched: /* @__PURE__ */ new Set(),
+			dirty: /* @__PURE__ */ new Set()
+		};
+		this.notify();
+	}
+};
+//#endregion
+export { FormStateStore };
+
+//# sourceMappingURL=FormStateStore.js.map

package/dist/forms/engine/FormStateStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormStateStore.js","names":[],"sources":["../../../src/forms/engine/FormStateStore.ts"],"sourcesContent":["import { get, set } from 'lodash-es';\n\ntype FormSubscriber = () => void;\n\nexport type FormState = {\n    values: Record<string, unknown>;\n    errors: Record<string, string[]>;\n    touched: Set<string>;\n    dirty: Set<string>;\n};\n\nexport class FormStateStore {\n    state: FormState;\n\n    private listeners: Set<FormSubscriber> = new Set();\n\n    private initialValues: Record<string, unknown>;\n\n    constructor(initialValues: Record<string, unknown> = {}) {\n        this.initialValues = { ...initialValues };\n        this.state = {\n            values: { ...initialValues },\n            errors: {},\n            touched: new Set(),\n            dirty: new Set(),\n        };\n    }\n\n    subscribe(listener: FormSubscriber): () => void {\n        this.listeners.add(listener);\n        return () => {\n            this.listeners.delete(listener);\n        };\n    }\n\n    notify() {\n        this.listeners.forEach((listener) => { listener(); });\n    }\n\n    getValue(path: string): unknown {\n        return get(this.state.values, path);\n    }\n\n    setValue(path: string, value: unknown) {\n        const nextErrors = { ...this.state.errors };\n        if (path in nextErrors) {\n            delete nextErrors[path];\n        }\n        // When replacing an array (e.g. options), clear errors for descendant paths\n        // so indices stay in sync after add/remove/reorder\n        if (Array.isArray(value)) {\n            const descendantPrefix = `${path}.`;\n            Object.keys(nextErrors).forEach((key) => {\n                if (key.startsWith(descendantPrefix)) {\n                    delete nextErrors[key];\n                }\n            });\n        }\n\n        this.state = {\n            ...this.state,\n            values: (() => {\n                const cloneRoot: Record<string, unknown> = Array.isArray(this.state.values)\n                    ? ([...this.state.values] as unknown as Record<string, unknown>)\n                    : { ...(this.state.values ?? {}) };\n                set(cloneRoot, path, value);\n                return cloneRoot;\n            })(),\n            dirty: new Set(this.state.dirty).add(path),\n            errors: nextErrors,\n        };\n        this.notify();\n    }\n\n    setValues(values: Record<string, unknown>) {\n        this.state = {\n            ...this.state,\n            values: { ...values },\n        };\n        this.notify();\n    }\n\n    setErrors(errors: Record<string, string[]>) {\n        this.state = {\n            ...this.state,\n            errors: { ...errors },\n        };\n        this.notify();\n    }\n\n    clearErrors() {\n        this.state = {\n            ...this.state,\n            errors: {},\n        };\n        this.notify();\n    }\n\n    setTouched(path: string, touched = true) {\n        const currentlyTouched = this.state.touched.has(path);\n        if (currentlyTouched === touched) {\n            return;\n        }\n\n        const nextTouched = new Set(this.state.touched);\n        if (touched) {\n            nextTouched.add(path);\n        } else {\n            nextTouched.delete(path);\n        }\n\n        this.state = {\n            ...this.state,\n            touched: nextTouched,\n        };\n        this.notify();\n    }\n\n    reset(values: Record<string, unknown> = this.initialValues) {\n        this.initialValues = { ...values };\n        this.state = {\n            values: { ...values },\n            errors: {},\n            touched: new Set(),\n            dirty: new Set(),\n        };\n        this.notify();\n    }\n}\n"],"mappings":";;AAWA,IAAa,iBAAb,MAA4B;CACxB;CAEA,4BAAyC,IAAI,KAAK;CAElD;CAEA,YAAY,gBAAyC,EAAE,EAAE;AACrD,OAAK,gBAAgB,EAAE,GAAG,eAAe;AACzC,OAAK,QAAQ;GACT,QAAQ,EAAE,GAAG,eAAe;GAC5B,QAAQ,EAAE;GACV,yBAAS,IAAI,KAAK;GAClB,uBAAO,IAAI,KAAK;GACnB;;CAGL,UAAU,UAAsC;AAC5C,OAAK,UAAU,IAAI,SAAS;AAC5B,eAAa;AACT,QAAK,UAAU,OAAO,SAAS;;;CAIvC,SAAS;AACL,OAAK,UAAU,SAAS,aAAa;AAAE,aAAU;IAAI;;CAGzD,SAAS,MAAuB;AAC5B,SAAO,IAAI,KAAK,MAAM,QAAQ,KAAK;;CAGvC,SAAS,MAAc,OAAgB;EACnC,MAAM,aAAa,EAAE,GAAG,KAAK,MAAM,QAAQ;AAC3C,MAAI,QAAQ,WACR,QAAO,WAAW;AAItB,MAAI,MAAM,QAAQ,MAAM,EAAE;GACtB,MAAM,mBAAmB,GAAG,KAAK;AACjC,UAAO,KAAK,WAAW,CAAC,SAAS,QAAQ;AACrC,QAAI,IAAI,WAAW,iBAAiB,CAChC,QAAO,WAAW;KAExB;;AAGN,OAAK,QAAQ;GACT,GAAG,KAAK;GACR,eAAe;IACX,MAAM,YAAqC,MAAM,QAAQ,KAAK,MAAM,OAAO,GACpE,CAAC,GAAG,KAAK,MAAM,OAAO,GACvB,EAAE,GAAI,KAAK,MAAM,UAAU,EAAE,EAAG;AACtC,QAAI,WAAW,MAAM,MAAM;AAC3B,WAAO;OACP;GACJ,OAAO,IAAI,IAAI,KAAK,MAAM,MAAM,CAAC,IAAI,KAAK;GAC1C,QAAQ;GACX;AACD,OAAK,QAAQ;;CAGjB,UAAU,QAAiC;AACvC,OAAK,QAAQ;GACT,GAAG,KAAK;GACR,QAAQ,EAAE,GAAG,QAAQ;GACxB;AACD,OAAK,QAAQ;;CAGjB,UAAU,QAAkC;AACxC,OAAK,QAAQ;GACT,GAAG,KAAK;GACR,QAAQ,EAAE,GAAG,QAAQ;GACxB;AACD,OAAK,QAAQ;;CAGjB,cAAc;AACV,OAAK,QAAQ;GACT,GAAG,KAAK;GACR,QAAQ,EAAE;GACb;AACD,OAAK,QAAQ;;CAGjB,WAAW,MAAc,UAAU,MAAM;AAErC,MADyB,KAAK,MAAM,QAAQ,IAAI,KAC5C,KAAqB,QACrB;EAGJ,MAAM,cAAc,IAAI,IAAI,KAAK,MAAM,QAAQ;AAC/C,MAAI,QACA,aAAY,IAAI,KAAK;MAErB,aAAY,OAAO,KAAK;AAG5B,OAAK,QAAQ;GACT,GAAG,KAAK;GACR,SAAS;GACZ;AACD,OAAK,QAAQ;;CAGjB,MAAM,SAAkC,KAAK,eAAe;AACxD,OAAK,gBAAgB,EAAE,GAAG,QAAQ;AAClC,OAAK,QAAQ;GACT,QAAQ,EAAE,GAAG,QAAQ;GACrB,QAAQ,EAAE;GACV,yBAAS,IAAI,KAAK;GAClB,uBAAO,IAAI,KAAK;GACnB;AACD,OAAK,QAAQ"}

package/dist/forms/engine/SchemaIndex.d.ts

@@ -0,0 +1,33 @@
+export type SchemaNode = {
+    _id?: string;
+    _data?: Record<string, unknown>;
+    _scopePath?: string;
+    name?: string;
+    label?: string;
+    required?: boolean;
+    validation?: string;
+    columns?: unknown[];
+    children?: SchemaRenderable;
+    schema?: SchemaRenderable;
+    schemaChildPrefix?: string;
+    $field?: string;
+    $cmp?: string;
+    $el?: string;
+    type?: string;
+    if?: string;
+    hideOnIf?: boolean;
+    attrs?: Record<string, unknown>;
+    props?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+export type SchemaRenderable = SchemaNode | string | SchemaRenderable[];
+export type FieldEntry = {
+    path: string;
+    field: SchemaNode;
+};
+export type SchemaIndex = {
+    schema: SchemaRenderable;
+    fieldEntries: FieldEntry[];
+};
+export declare const normalizeSchema: (items: SchemaRenderable, path?: string) => SchemaRenderable;
+//# sourceMappingURL=SchemaIndex.d.ts.map

package/dist/forms/engine/SchemaIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaIndex.d.ts","sourceRoot":"","sources":["../../../src/forms/engine/SchemaIndex.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,MAAM,GAAG,gBAAgB,EAAE,CAAC;AAExE,MAAM,MAAM,UAAU,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,UAAU,EAAE,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,gBAAgB,EAAE,aAAa,KAAG,gBA+BxE,CAAC"}

package/dist/forms/engine/SchemaIndex.js

@@ -0,0 +1,21 @@
+//#region src/forms/engine/SchemaIndex.ts
+var normalizeSchema = (items, path = "root") => {
+	if (Array.isArray(items)) return items.map((item, index) => {
+		return normalizeSchema(item, `${path}.${index}`);
+	});
+	if (!items || typeof items !== "object") return items;
+	const itemWithId = { ...items };
+	const itemPath = path || "root";
+	if (!itemWithId._id) itemWithId._id = `schema_${itemPath}`;
+	if (Array.isArray(itemWithId.children)) itemWithId.children = itemWithId.children.map((child, index) => {
+		return normalizeSchema(child, `${itemPath}.children.${index}`);
+	});
+	if (Array.isArray(itemWithId.schema)) itemWithId.schema = itemWithId.schema.map((child, index) => {
+		return normalizeSchema(child, `${itemPath}.schema.${index}`);
+	});
+	return itemWithId;
+};
+//#endregion
+export { normalizeSchema };
+
+//# sourceMappingURL=SchemaIndex.js.map

package/dist/forms/engine/SchemaIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaIndex.js","names":[],"sources":["../../../src/forms/engine/SchemaIndex.ts"],"sourcesContent":["export type SchemaNode = {\n    _id?: string;\n    _data?: Record<string, unknown>;\n    _scopePath?: string;\n    name?: string;\n    label?: string;\n    required?: boolean;\n    validation?: string;\n    columns?: unknown[];\n    children?: SchemaRenderable;\n    schema?: SchemaRenderable;\n    schemaChildPrefix?: string;\n    $field?: string;\n    $cmp?: string;\n    $el?: string;\n    type?: string;\n    if?: string;\n    hideOnIf?: boolean;\n    attrs?: Record<string, unknown>;\n    props?: Record<string, unknown>;\n    [key: string]: unknown;\n};\n\nexport type SchemaRenderable = SchemaNode | string | SchemaRenderable[];\n\nexport type FieldEntry = {\n    path: string;\n    field: SchemaNode;\n};\n\nexport type SchemaIndex = {\n    schema: SchemaRenderable;\n    fieldEntries: FieldEntry[];\n};\n\nexport const normalizeSchema = (items: SchemaRenderable, path = 'root'): SchemaRenderable => {\n    if (Array.isArray(items)) {\n        return items.map((item, index) => {\n            return normalizeSchema(item, `${path}.${index}`);\n        });\n    }\n\n    if (!items || typeof items !== 'object') {\n        return items;\n    }\n\n    const itemWithId: SchemaNode = { ...items };\n    const itemPath = path || 'root';\n\n    if (!itemWithId._id) {\n        itemWithId._id = `schema_${itemPath}`;\n    }\n\n    if (Array.isArray(itemWithId.children)) {\n        itemWithId.children = itemWithId.children.map((child, index) => {\n            return normalizeSchema(child, `${itemPath}.children.${index}`);\n        });\n    }\n\n    if (Array.isArray(itemWithId.schema)) {\n        itemWithId.schema = itemWithId.schema.map((child, index) => {\n            return normalizeSchema(child, `${itemPath}.schema.${index}`);\n        });\n    }\n\n    return itemWithId;\n};\n"],"mappings":";AAmCA,IAAa,mBAAmB,OAAyB,OAAO,WAA6B;AACzF,KAAI,MAAM,QAAQ,MAAM,CACpB,QAAO,MAAM,KAAK,MAAM,UAAU;AAC9B,SAAO,gBAAgB,MAAM,GAAG,KAAK,GAAG,QAAQ;GAClD;AAGN,KAAI,CAAC,SAAS,OAAO,UAAU,SAC3B,QAAO;CAGX,MAAM,aAAyB,EAAE,GAAG,OAAO;CAC3C,MAAM,WAAW,QAAQ;AAEzB,KAAI,CAAC,WAAW,IACZ,YAAW,MAAM,UAAU;AAG/B,KAAI,MAAM,QAAQ,WAAW,SAAS,CAClC,YAAW,WAAW,WAAW,SAAS,KAAK,OAAO,UAAU;AAC5D,SAAO,gBAAgB,OAAO,GAAG,SAAS,YAAY,QAAQ;GAChE;AAGN,KAAI,MAAM,QAAQ,WAAW,OAAO,CAChC,YAAW,SAAS,WAAW,OAAO,KAAK,OAAO,UAAU;AACxD,SAAO,gBAAgB,OAAO,GAAG,SAAS,UAAU,QAAQ;GAC9D;AAGN,QAAO"}

package/dist/forms/engine/ValidationEngine.d.ts

@@ -0,0 +1,13 @@
+import { SchemaIndex, SchemaNode } from './SchemaIndex';
+import { FormValues } from './context';
+type ConditionDataResolver = (values: FormValues, field?: SchemaNode) => Record<string, unknown>;
+export type ValidationResult = {
+    fields: Record<string, string[]>;
+} | undefined;
+export declare const createValidationEngine: (index: SchemaIndex, options?: {
+    conditionDataResolver?: ConditionDataResolver;
+}) => {
+    validate: (values: FormValues) => ValidationResult;
+};
+export {};
+//# sourceMappingURL=ValidationEngine.d.ts.map

package/dist/forms/engine/ValidationEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationEngine.d.ts","sourceRoot":"","sources":["../../../src/forms/engine/ValidationEngine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,WAAW,EAAE,UAAU,EAAoB,MAAM,eAAe,CAAC;AAG3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAU5C,KAAK,qBAAqB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAsMjG,MAAM,MAAM,gBAAgB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAAE,GAAG,SAAS,CAAC;AAEhF,eAAO,MAAM,sBAAsB,GAC/B,OAAO,WAAW,EAClB,UAAS;IAAE,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;CAAO;uBAUrC,UAAU,KAAG,gBAAgB;CAmC1D,CAAC"}

package/dist/forms/engine/ValidationEngine.js

@@ -0,0 +1,155 @@
+import { evaluateCondition } from "../../utils/schema.js";
+import { isEmptyValue } from "./rules/utils.js";
+import { ruleHandlers } from "./rules/index.js";
+import { get } from "lodash-es";
+//#region src/forms/engine/ValidationEngine.ts
+var isRecord = (value) => {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+};
+var parseRules = (field) => {
+	const tokens = (typeof field.validation === "string" ? field.validation : "").split("|").map((token) => {
+		return token.trim();
+	}).filter(Boolean);
+	const hasRequiredRule = tokens.some((rule) => {
+		return rule === "required" || rule.startsWith("required");
+	});
+	if (field.required && !hasRequiredRule) tokens.unshift("required");
+	return tokens.map((token) => {
+		const [name, ...rest] = token.split(":");
+		return {
+			name,
+			args: rest.length > 0 ? rest.join(":").split(",") : []
+		};
+	});
+};
+var expandWildcardPaths = (values, path) => {
+	if (!path.includes("*")) return [path];
+	const parts = path.split(".");
+	const results = [];
+	const walk = (current, index, acc) => {
+		if (index >= parts.length) {
+			results.push(acc.join("."));
+			return;
+		}
+		const part = parts[index];
+		if (part === "*") {
+			if (Array.isArray(current)) current.forEach((item, idx) => {
+				walk(item, index + 1, [...acc, String(idx)]);
+			});
+			return;
+		}
+		if (isRecord(current) && part in current) {
+			walk(current[part], index + 1, [...acc, part]);
+			return;
+		}
+		walk(void 0, index + 1, [...acc, part]);
+	};
+	walk(values, 0, []);
+	return results;
+};
+var validateValue = (field, rules, value, context) => {
+	const label = String(field.label || field.name || "");
+	const isRequired = rules.some((rule) => {
+		return rule.name === "required";
+	});
+	for (const rule of rules) {
+		const { name, args } = rule;
+		if (!isRequired && isEmptyValue(value)) continue;
+		const handler = ruleHandlers[name];
+		if (!handler) continue;
+		const message = handler(value, label, args, context);
+		if (message) return message;
+	}
+	return null;
+};
+var buildConditionData = (field, values, conditionDataResolver) => {
+	const scopePath = typeof field?._scopePath === "string" ? field._scopePath : "";
+	const scopedValues = scopePath ? get(values, scopePath) : null;
+	const scopedObject = isRecord(scopedValues) ? scopedValues : {};
+	const conditionContext = conditionDataResolver?.(values, field);
+	const normalizedConditionContext = isRecord(conditionContext) ? conditionContext : {};
+	const fieldData = isRecord(field._data) ? field._data : {};
+	return {
+		...values,
+		...scopedObject,
+		...fieldData,
+		...normalizedConditionContext
+	};
+};
+var shouldValidateField = (field, values, conditionDataResolver) => {
+	const condition = field?.if;
+	if (!condition) return true;
+	try {
+		return evaluateCondition(condition, buildConditionData(field, values, conditionDataResolver));
+	} catch {
+		return true;
+	}
+};
+var collectPathConditions = (schema) => {
+	const pathConditions = /* @__PURE__ */ new Map();
+	const walk = (node, currentPath = "", inherited = []) => {
+		if (Array.isArray(node)) {
+			node.forEach((child) => {
+				walk(child, currentPath, inherited);
+			});
+			return;
+		}
+		if (!isRecord(node)) return;
+		const name = typeof node.name === "string" && node.name ? node.name : "";
+		let nodePath = currentPath;
+		if (name) nodePath = currentPath ? `${currentPath}.${name}` : name;
+		const ownCondition = typeof node.if === "string" && node.if ? [{
+			condition: node.if,
+			field: node
+		}] : [];
+		const nextInherited = [...inherited, ...ownCondition];
+		if (nodePath && nextInherited.length) pathConditions.set(nodePath, nextInherited);
+		if (Array.isArray(node.children)) walk(node.children, nodePath, nextInherited);
+		if (Array.isArray(node.schema)) walk(node.schema, nodePath, nextInherited);
+	};
+	walk(schema, "", []);
+	return pathConditions;
+};
+var shouldValidatePathConditions = (path, fallbackField, values, pathConditions, conditionDataResolver) => {
+	const conditions = pathConditions.get(path) || [];
+	if (!conditions.length) return true;
+	return conditions.every(({ condition, field }) => {
+		try {
+			return evaluateCondition(condition, buildConditionData(field || fallbackField, values, conditionDataResolver));
+		} catch {
+			return true;
+		}
+	});
+};
+var createValidationEngine = (index, options = {}) => {
+	const { conditionDataResolver } = options;
+	const fieldRules = /* @__PURE__ */ new Map();
+	const pathConditions = collectPathConditions(index.schema);
+	index.fieldEntries.forEach((entry) => {
+		fieldRules.set(entry, parseRules(entry.field));
+	});
+	const validate = (values) => {
+		const fieldErrors = {};
+		index.fieldEntries.forEach((entry) => {
+			const rules = fieldRules.get(entry) || [];
+			if (!rules.length) return;
+			if (!shouldValidateField(entry.field, values, conditionDataResolver)) return;
+			expandWildcardPaths(values, entry.path).forEach((path) => {
+				if (!shouldValidatePathConditions(path, entry.field, values, pathConditions, conditionDataResolver)) return;
+				const value = get(values, path);
+				const message = validateValue(entry.field, rules, value, {
+					path,
+					values,
+					field: entry.field
+				});
+				if (message) fieldErrors[path] = [message];
+			});
+		});
+		return Object.keys(fieldErrors).length > 0 ? { fields: fieldErrors } : void 0;
+	};
+	return { validate };
+};
+//#endregion
+export { createValidationEngine };
+
+//# sourceMappingURL=ValidationEngine.js.map

package/dist/forms/engine/ValidationEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationEngine.js","names":[],"sources":["../../../src/forms/engine/ValidationEngine.ts"],"sourcesContent":["import { get } from 'lodash-es';\nimport { evaluateCondition } from '@verbb/plugin-kit-react/utils/schema';\n\nimport type { FieldEntry, SchemaIndex, SchemaNode, SchemaRenderable } from './SchemaIndex';\nimport { ruleHandlers, RuleHandlerContext } from './rules';\nimport { isEmptyValue } from './rules/utils';\nimport type { FormValues } from './context';\n\ntype RuleToken = {\n    name: string;\n    args: string[];\n};\ntype ConditionContext = {\n    condition: string;\n    field: SchemaNode;\n};\ntype ConditionDataResolver = (values: FormValues, field?: SchemaNode) => Record<string, unknown>;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => {\n    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);\n};\n\nconst parseRules = (field: { validation?: string; required?: boolean }): RuleToken[] => {\n    const rawRules = typeof field.validation === 'string' ? field.validation : '';\n    const tokens = rawRules\n        .split('|')\n        .map((token) => { return token.trim(); })\n        .filter(Boolean);\n\n    const hasRequiredRule = tokens.some((rule) => { return rule === 'required' || rule.startsWith('required'); });\n    if (field.required && !hasRequiredRule) {\n        tokens.unshift('required');\n    }\n\n    return tokens.map((token) => {\n        const [name, ...rest] = token.split(':');\n        const args = rest.length > 0 ? rest.join(':').split(',') : [];\n        return { name, args };\n    });\n};\n\nconst expandWildcardPaths = (values: FormValues, path: string) => {\n    if (!path.includes('*')) {\n        return [path];\n    }\n\n    const parts = path.split('.');\n    const results: string[] = [];\n\n    const walk = (current: unknown, index: number, acc: string[]) => {\n        if (index >= parts.length) {\n            results.push(acc.join('.'));\n            return;\n        }\n\n        const part = parts[index];\n        if (part === '*') {\n            if (Array.isArray(current)) {\n                current.forEach((item, idx) => {\n                    walk(item, index + 1, [...acc, String(idx)]);\n                });\n            }\n            return;\n        }\n\n        if (isRecord(current) && part in current) {\n            walk(current[part], index + 1, [...acc, part]);\n            return;\n        }\n\n        walk(undefined, index + 1, [...acc, part]);\n    };\n\n    walk(values, 0, []);\n    return results;\n};\n\nconst validateValue = (\n    field: SchemaNode,\n    rules: RuleToken[],\n    value: unknown,\n    context: RuleHandlerContext,\n) => {\n    const label = String(field.label || field.name || '');\n    const isRequired = rules.some((rule) => { return rule.name === 'required'; });\n\n    for (const rule of rules) {\n        const { name, args } = rule;\n        const shouldSkip = !isRequired && isEmptyValue(value);\n\n        if (shouldSkip) {\n            continue;\n        }\n\n        const handler = ruleHandlers[name];\n        if (!handler) {\n            continue;\n        }\n\n        const message = handler(value, label, args, context);\n        if (message) {\n            return message;\n        }\n    }\n\n    return null;\n};\n\nconst buildConditionData = (\n    field: SchemaNode,\n    values: FormValues,\n    conditionDataResolver?: ConditionDataResolver,\n) => {\n    const scopePath = typeof field?._scopePath === 'string' ? field._scopePath : '';\n    const scopedValues = scopePath ? get(values, scopePath) : null;\n    const scopedObject = isRecord(scopedValues) ? scopedValues : {};\n    const conditionContext = conditionDataResolver?.(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 shouldValidateField = (\n    field: SchemaNode,\n    values: FormValues,\n    conditionDataResolver?: ConditionDataResolver,\n) => {\n    const condition = field?.if;\n\n    if (!condition) {\n        return true;\n    }\n\n    try {\n        return evaluateCondition(condition, buildConditionData(field, values, conditionDataResolver));\n    } catch {\n        // Fail-open to avoid accidentally blocking saves due to malformed conditions.\n        return true;\n    }\n};\n\nconst collectPathConditions = (schema: SchemaRenderable) => {\n    const pathConditions = new Map<string, ConditionContext[]>();\n\n    const walk = (node: SchemaRenderable, currentPath = '', inherited: ConditionContext[] = []) => {\n        if (Array.isArray(node)) {\n            node.forEach((child) => {\n                walk(child, currentPath, inherited);\n            });\n            return;\n        }\n\n        if (!isRecord(node)) {\n            return;\n        }\n\n        const name = typeof node.name === 'string' && node.name ? node.name : '';\n        let nodePath = currentPath;\n        if (name) {\n            nodePath = currentPath ? `${currentPath}.${name}` : name;\n        }\n\n        const ownCondition = typeof node.if === 'string' && node.if\n            ? [{ condition: node.if, field: node }]\n            : [];\n        const nextInherited = [...inherited, ...ownCondition];\n\n        if (nodePath && nextInherited.length) {\n            pathConditions.set(nodePath, nextInherited);\n        }\n\n        if (Array.isArray(node.children)) {\n            walk(node.children, nodePath, nextInherited);\n        }\n\n        if (Array.isArray(node.schema)) {\n            walk(node.schema, nodePath, nextInherited);\n        }\n    };\n\n    walk(schema, '', []);\n\n    return pathConditions;\n};\n\nconst shouldValidatePathConditions = (\n    path: string,\n    fallbackField: SchemaNode,\n    values: FormValues,\n    pathConditions: Map<string, ConditionContext[]>,\n    conditionDataResolver?: ConditionDataResolver,\n) => {\n    const conditions = pathConditions.get(path) || [];\n\n    if (!conditions.length) {\n        return true;\n    }\n\n    return conditions.every(({ condition, field }) => {\n        try {\n            return evaluateCondition(condition, buildConditionData(field || fallbackField, values, conditionDataResolver));\n        } catch {\n            // Fail-open to avoid accidental save blocking on malformed conditions.\n            return true;\n        }\n    });\n};\n\nexport type ValidationResult = { fields: Record<string, string[]> } | undefined;\n\nexport const createValidationEngine = (\n    index: SchemaIndex,\n    options: { conditionDataResolver?: ConditionDataResolver } = {},\n) => {\n    const { conditionDataResolver } = options;\n    const fieldRules = new Map<FieldEntry, RuleToken[]>();\n    const pathConditions = collectPathConditions(index.schema);\n\n    index.fieldEntries.forEach((entry) => {\n        fieldRules.set(entry, parseRules(entry.field));\n    });\n\n    const validate = (values: FormValues): ValidationResult => {\n        const fieldErrors: Record<string, string[]> = {};\n        index.fieldEntries.forEach((entry) => {\n            const rules = fieldRules.get(entry) || [];\n            if (!rules.length) {\n                return;\n            }\n\n            if (!shouldValidateField(entry.field, values, conditionDataResolver)) {\n                return;\n            }\n\n            const paths = expandWildcardPaths(values, entry.path);\n            paths.forEach((path) => {\n                if (!shouldValidatePathConditions(path, entry.field, values, pathConditions, conditionDataResolver)) {\n                    return;\n                }\n\n                const value = get(values, path);\n                const message = validateValue(entry.field, rules, value, {\n                    path,\n                    values,\n                    field: entry.field,\n                });\n                if (message) {\n                    fieldErrors[path] = [message];\n\n                }\n            });\n        });\n\n        return Object.keys(fieldErrors).length > 0 ? { fields: fieldErrors } : undefined;\n    };\n\n    return { validate };\n};\n"],"mappings":"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"}

package/dist/forms/engine/buildGroupedMessage.d.ts

@@ -0,0 +1,2 @@
+export declare const buildGroupedMessage: (message: string, parentLabel?: string, childLabel?: string) => string;
+//# sourceMappingURL=buildGroupedMessage.d.ts.map

package/dist/forms/engine/buildGroupedMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGroupedMessage.d.ts","sourceRoot":"","sources":["../../../src/forms/engine/buildGroupedMessage.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,mBAAmB,GAC5B,SAAS,MAAM,EACf,cAAc,MAAM,EACpB,aAAa,MAAM,WAkBtB,CAAC"}

package/dist/forms/engine/buildGroupedMessage.js

@@ -0,0 +1,20 @@
+//#region src/forms/engine/buildGroupedMessage.ts
+var buildGroupLabel = (parentLabel, childLabel) => {
+	if (parentLabel && childLabel) return `${parentLabel}: ${childLabel}`;
+	return parentLabel || childLabel || "";
+};
+var ATTRIBUTE_MESSAGE_PATTERN = /^(.+?) (cannot be blank\.|must be .+)$/;
+var buildGroupedMessage = (message, parentLabel, childLabel) => {
+	const groupLabel = buildGroupLabel(parentLabel, childLabel);
+	if (!groupLabel) return message;
+	const match = String(message).match(ATTRIBUTE_MESSAGE_PATTERN);
+	if (match) {
+		const [, attribute, suffix] = match;
+		return `${buildGroupLabel(parentLabel, (childLabel && attribute !== childLabel ? attribute : childLabel) || attribute)} ${suffix}`;
+	}
+	return `${groupLabel} ${message}`;
+};
+//#endregion
+export { buildGroupedMessage };
+
+//# sourceMappingURL=buildGroupedMessage.js.map

package/dist/forms/engine/buildGroupedMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGroupedMessage.js","names":[],"sources":["../../../src/forms/engine/buildGroupedMessage.ts"],"sourcesContent":["const buildGroupLabel = (parentLabel?: string, childLabel?: string) => {\n    if (parentLabel && childLabel) {\n        return `${parentLabel}: ${childLabel}`;\n    }\n\n    return parentLabel || childLabel || '';\n};\n\n// Matches \"{attribute} cannot be blank.\" and similar validation messages\nconst ATTRIBUTE_MESSAGE_PATTERN = /^(.+?) (cannot be blank\\.|must be .+)$/;\n\nexport const buildGroupedMessage = (\n    message: string,\n    parentLabel?: string,\n    childLabel?: string,\n) => {\n    const groupLabel = buildGroupLabel(parentLabel, childLabel);\n    if (!groupLabel) {\n        return message;\n    }\n\n    const match = String(message).match(ATTRIBUTE_MESSAGE_PATTERN);\n    if (match) {\n        const [, attribute, suffix] = match;\n        // Use attribute in groupLabel (fixes \"label\" -> \"Option Label\") and only append suffix\n        // to avoid \"Options: Option Label Option Label cannot be blank.\"\n        const displayLabel = (childLabel && attribute !== childLabel) ? attribute : childLabel;\n        const finalGroupLabel = buildGroupLabel(parentLabel, displayLabel || attribute);\n        return `${finalGroupLabel} ${suffix}`;\n    }\n\n    return `${groupLabel} ${message}`;\n};\n"],"mappings":";AAAA,IAAM,mBAAmB,aAAsB,eAAwB;AACnE,KAAI,eAAe,WACf,QAAO,GAAG,YAAY,IAAI;AAG9B,QAAO,eAAe,cAAc;;AAIxC,IAAM,4BAA4B;AAElC,IAAa,uBACT,SACA,aACA,eACC;CACD,MAAM,aAAa,gBAAgB,aAAa,WAAW;AAC3D,KAAI,CAAC,WACD,QAAO;CAGX,MAAM,QAAQ,OAAO,QAAQ,CAAC,MAAM,0BAA0B;AAC9D,KAAI,OAAO;EACP,MAAM,GAAG,WAAW,UAAU;AAK9B,SAAO,GADiB,gBAAgB,cADlB,cAAc,cAAc,aAAc,YAAY,eACP,UAC3D,CAAgB,GAAG;;AAGjC,QAAO,GAAG,WAAW,GAAG"}