cogsbox-shape 0.5.218 → 0.5.220

package/cogsbox-shape-state/dist/plugin.d.ts

@@ -68,7 +68,12 @@ type ShapeKeyValidationParams = {
     path: string[];
     keys?: readonly string[];
     getState?: () => unknown;
+    /** When true (default), writes filtered issues to shadow validation metadata. */
+    persist?: boolean;
+    /** When true, clears existing errors on sibling fields outside `keys`. */
+    clearOutsideKeys?: boolean;
 };
+export type ValidateGroupOptions = Pick<ShapeKeyValidationParams, "persist" | "clearOutsideKeys">;
 export declare function wireShapeValidationOptions(box: ShapeSchemaBox, params: TransformStateParams): void;
 /** Cross-field refine errors only — field rules are handled by state via setOptions. */
 export declare function validateShapeRefines(box: ShapeSchemaBox, params: FormUpdateParams): void;

package/cogsbox-shape-state/dist/plugin.js

@@ -117,6 +117,102 @@ function addValidationIssues(params, issues) {
     params.addZodErrors(issues);
     notifyValidationPaths(params.stateKey, issues.map((issue) => issue.path));
 }
+function createShadowValidationBridge(stateKey) {
+    const store = getGlobalStore.getState();
+    return {
+        stateKey,
+        getState: () => store.getShadowValue(stateKey, []),
+        addZodErrors: (issues) => {
+            for (const error of issues) {
+                const errorPath = error.path;
+                const currentMeta = store.getShadowMetadata(stateKey, errorPath) || {};
+                store.setShadowMetadata(stateKey, errorPath, {
+                    ...currentMeta,
+                    validation: {
+                        status: "INVALID",
+                        errors: [
+                            {
+                                source: "client",
+                                message: error.message,
+                                severity: "error",
+                                code: error.code,
+                            },
+                        ],
+                        lastValidated: Date.now(),
+                        validatedValue: undefined,
+                    },
+                });
+            }
+        },
+        clearZodErrors: (paths) => {
+            for (const path of paths) {
+                const currentMeta = store.getShadowMetadata(stateKey, path) || {};
+                store.setShadowMetadata(stateKey, path, {
+                    ...currentMeta,
+                    validation: {
+                        status: "NOT_VALIDATED",
+                        errors: [],
+                        lastValidated: Date.now(),
+                        validatedValue: undefined,
+                    },
+                });
+            }
+        },
+    };
+}
+function notifyStateComponents(stateKey) {
+    const store = getGlobalStore.getState();
+    const stateEntry = store.getShadowMetadata(stateKey, []);
+    if (!stateEntry?.components)
+        return;
+    const updates = new Set();
+    stateEntry.components.forEach((component) => {
+        const reactiveTypes = component
+            ? Array.isArray(component.reactiveType)
+                ? component.reactiveType
+                : [component.reactiveType || "component"]
+            : null;
+        if (!reactiveTypes?.includes("none")) {
+            updates.add(() => component.forceUpdate());
+        }
+    });
+    queueMicrotask(() => {
+        updates.forEach((update) => update());
+    });
+}
+function persistValidateGroupResults(params, keys, mapped) {
+    const validationParams = createShadowValidationBridge(params.stateKey);
+    if (params.clearOutsideKeys === true) {
+        clearOutsideGroupValidation(params, keys, validationParams);
+    }
+    const keyPaths = keys.map((key) => [...params.path, key]);
+    const activeKeys = new Set(mapped.map((issue) => pathKey(issue.path)));
+    const stalePaths = keyPaths.filter((targetPath) => !activeKeys.has(pathKey(targetPath)));
+    clearValidationPaths(validationParams, stalePaths);
+    if (mapped.length > 0) {
+        addValidationIssues(validationParams, mapped);
+    }
+    notifyStateComponents(params.stateKey);
+}
+function clearOutsideGroupValidation(params, keys, validationParams) {
+    const store = getGlobalStore.getState();
+    const parentNode = store.getShadowNode(params.stateKey, params.path);
+    if (!parentNode)
+        return;
+    const keySet = new Set(keys);
+    const outsidePaths = [];
+    for (const childKey of Object.keys(parentNode)) {
+        if (childKey === "_meta" || keySet.has(childKey))
+            continue;
+        const fieldPath = [...params.path, childKey];
+        const status = store.getShadowMetadata(params.stateKey, fieldPath)
+            ?.validation?.status;
+        if (status === "INVALID") {
+            outsidePaths.push(fieldPath);
+        }
+    }
+    clearValidationPaths(validationParams, outsidePaths);
+}
 function issueMatchesSelectedKeys(issue, parentPath, selectedKeys) {
     const issuePath = issue.path.map(String);
     if (issuePath.length <= parentPath.length)
@@ -196,6 +292,22 @@ function resolveUpdateRefineTarget(entry, updatePath, oldValue, newValue) {
         relatedPaths: resolveRelatedPaths(updatePath, relatedFields),
     };
 }
+function clearStaleRefineValidation(box, params, target, state) {
+    const entry = box[params.stateKey];
+    const clientSchema = entry?.validators?.client ?? entry?.schemas.client;
+    if (!entry || !clientSchema)
+        return;
+    const result = clientSchema.safeParse(state);
+    if (result.success) {
+        clearValidationPaths(params, target.relatedPaths);
+        return;
+    }
+    const issues = result.error.issues.filter((issue) => issueMatchesRelatedFields(issue, target.relatedFields));
+    const mapped = mapZodIssues(issues);
+    const activeKeys = new Set(mapped.map((entry) => pathKey(entry.path)));
+    const stalePaths = target.relatedPaths.filter((targetPath) => !activeKeys.has(pathKey(targetPath)));
+    clearValidationPaths(params, stalePaths);
+}
 function applyRefineValidation(box, params, target, state) {
     const entry = box[params.stateKey];
     const clientSchema = entry?.validators?.client ?? entry?.schemas.client;
@@ -253,7 +365,7 @@ export function validateShapeRefinesOnUpdate(box, params) {
     const target = resolveUpdateRefineTarget(entry, params.update.path, params.update.oldValue, params.update.newValue);
     if (!target)
         return;
-    applyRefineValidation(box, params, target, params.getState());
+    clearStaleRefineValidation(box, params, target, params.getState());
 }
 export function validateShapeKeys(box, params) {
     const entry = box[params.stateKey];
@@ -263,7 +375,11 @@ export function validateShapeKeys(box, params) {
     const rootState = params.getState?.() ?? getGlobalStore.getState().getShadowValue(params.stateKey, []);
     const result = clientSchema.safeParse(rootState);
     const selectedKeys = params.keys ? new Set(params.keys) : null;
+    const shouldPersist = params.persist !== false && !!params.keys?.length;
     if (result.success) {
+        if (shouldPersist) {
+            persistValidateGroupResults(params, params.keys, []);
+        }
         return {
             success: true,
             results: params.keys?.map((key) => ({
@@ -278,6 +394,9 @@ export function validateShapeKeys(box, params) {
         ? result.error.issues.filter((issue) => issueMatchesSelectedKeys(issue, params.path, selectedKeys))
         : result.error.issues;
     const mapped = mapZodIssues(issues);
+    if (shouldPersist) {
+        persistValidateGroupResults(params, params.keys, mapped);
+    }
     return {
         success: mapped.length === 0,
         results: params.keys?.map((key) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cogsbox-shape",
-  "version": "0.5.218",
+  "version": "0.5.220",
   "description": "A TypeScript library for creating type-safe database schemas with Zod validation, SQL type definitions, and automatic client/server transformations. Unifies client, server, and database types through a single schema definition, with built-in support for relationships and serialization.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",