@adobe/data 0.2.0 → 0.2.2

package/dist/core/schema/dynamic/enumerate-patches.test.d.ts

@@ -0,0 +1,134 @@
+export declare const PersonSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly name: {
+            readonly type: "string";
+            readonly ui: {
+                readonly name: "Name";
+                readonly placeholder: "John Doe";
+            };
+        };
+        readonly age: {
+            readonly type: "number";
+            readonly default: 30;
+            readonly minimum: 0;
+            readonly maximum: 100;
+            readonly ui: {
+                readonly name: "Age";
+            };
+            readonly conditionals: readonly [{
+                readonly path: "$.properties.email.ui";
+                readonly value: {
+                    readonly visible: false;
+                };
+                readonly match: {
+                    readonly exclusiveMaximum: 18;
+                };
+            }];
+        };
+        readonly email: {
+            readonly type: "string";
+            readonly ui: {
+                readonly name: "Email";
+                readonly placeholder: "john.doe@example.com";
+            };
+        };
+    };
+    readonly additionalProperties: false;
+};
+export declare const PersonSchemaWithOneOf: {
+    readonly type: "object";
+    readonly properties: {
+        readonly name: {
+            readonly type: "string";
+            readonly ui: {
+                readonly name: "Name";
+                readonly placeholder: "John Doe";
+            };
+        };
+        readonly species: {
+            readonly type: "string";
+            readonly oneOf: readonly [{
+                readonly const: "human";
+                readonly conditionals: readonly [{
+                    readonly path: "$.properties.email.ui";
+                    readonly value: {
+                        readonly visible: true;
+                    };
+                }];
+            }, {
+                readonly const: "robot";
+                readonly conditionals: readonly [{
+                    readonly path: "$.properties.email.ui";
+                    readonly value: {
+                        readonly enabled: false;
+                    };
+                }];
+            }];
+        };
+        readonly email: {
+            readonly type: "string";
+            readonly ui: {
+                readonly name: "Email";
+                readonly placeholder: "john.doe@example.com";
+            };
+        };
+    };
+    readonly additionalProperties: false;
+};
+export declare const PersonSchemaRootConditions: {
+    readonly type: "object";
+    readonly properties: {
+        readonly name: {
+            readonly type: "string";
+            readonly ui: {
+                readonly name: "Name";
+                readonly placeholder: "John Doe";
+            };
+        };
+        readonly species: {
+            readonly type: "string";
+            readonly oneOf: readonly [{
+                readonly const: "human";
+            }, {
+                readonly const: "robot";
+            }];
+        };
+        readonly email: {
+            readonly type: "string";
+            readonly ui: {
+                readonly name: "Email";
+                readonly placeholder: "john.doe@example.com";
+            };
+        };
+    };
+    readonly conditionals: readonly [{
+        readonly path: "$.properties.email.ui";
+        readonly value: {
+            readonly visible: false;
+        };
+        readonly match: {
+            readonly properties: {
+                readonly name: {
+                    readonly maxLength: 2;
+                };
+            };
+        };
+    }, {
+        readonly path: "$.properties.email.ui";
+        readonly value: {
+            readonly visible: true;
+        };
+        readonly match: {
+            readonly properties: {
+                readonly name: {
+                    readonly minLength: 3;
+                };
+                readonly species: {
+                    readonly const: "human";
+                };
+            };
+        };
+    }];
+    readonly additionalProperties: false;
+};

package/dist/core/schema/dynamic/enumerate-patches.test.js

@@ -0,0 +1,209 @@
+import { describe, it, expect } from 'vitest';
+import { enumeratePatches } from './enumerate-patches.js';
+export const PersonSchema = {
+    type: "object",
+    properties: {
+        name: {
+            type: "string",
+            ui: {
+                name: "Name",
+                placeholder: "John Doe",
+            }
+        },
+        age: {
+            type: "number",
+            default: 30,
+            minimum: 0,
+            maximum: 100,
+            ui: {
+                name: "Age",
+            },
+            conditionals: [
+                // when the age is less than 18 then email is not visible.
+                {
+                    path: "$.properties.email.ui",
+                    value: {
+                        visible: false,
+                    },
+                    match: {
+                        exclusiveMaximum: 18,
+                    }
+                }
+            ]
+        },
+        email: {
+            type: "string",
+            ui: {
+                name: "Email",
+                placeholder: "john.doe@example.com",
+            }
+        },
+    },
+    additionalProperties: false,
+};
+export const PersonSchemaWithOneOf = {
+    type: "object",
+    properties: {
+        name: {
+            type: "string",
+            ui: {
+                name: "Name",
+                placeholder: "John Doe",
+            }
+        },
+        species: {
+            type: "string",
+            oneOf: [
+                {
+                    const: "human",
+                    conditionals: [
+                        {
+                            path: "$.properties.email.ui",
+                            value: {
+                                visible: true,
+                            }
+                        }
+                    ]
+                },
+                {
+                    const: "robot",
+                    conditionals: [
+                        {
+                            path: "$.properties.email.ui",
+                            value: {
+                                enabled: false,
+                            }
+                        }
+                    ]
+                }
+            ]
+        },
+        email: {
+            type: "string",
+            ui: {
+                name: "Email",
+                placeholder: "john.doe@example.com",
+            }
+        },
+    },
+    additionalProperties: false,
+};
+export const PersonSchemaRootConditions = {
+    type: "object",
+    properties: {
+        name: {
+            type: "string",
+            ui: {
+                name: "Name",
+                placeholder: "John Doe",
+            }
+        },
+        species: {
+            type: "string",
+            oneOf: [
+                {
+                    const: "human",
+                },
+                {
+                    const: "robot",
+                }
+            ]
+        },
+        email: {
+            type: "string",
+            ui: {
+                name: "Email",
+                placeholder: "john.doe@example.com",
+            }
+        },
+    },
+    conditionals: [
+        // if the name length is less than 3 then the email is not visible.
+        {
+            path: "$.properties.email.ui",
+            value: {
+                visible: false,
+            },
+            match: {
+                properties: {
+                    name: {
+                        maxLength: 2,
+                    }
+                }
+            }
+        },
+        // if the name length is greater than 3 and the species is human then the email is visible.
+        {
+            path: "$.properties.email.ui",
+            value: {
+                visible: true,
+            },
+            match: {
+                properties: {
+                    name: {
+                        minLength: 3,
+                    },
+                    species: {
+                        const: "human",
+                    }
+                }
+            }
+        }
+    ],
+    additionalProperties: false,
+};
+describe('enumeratePatches', () => {
+    it('should not enumerate patches when the local condition is not met', () => {
+        const patches = [...enumeratePatches(PersonSchema, {
+                name: "John Doe",
+                age: 20,
+            })];
+        expect(patches).toEqual([]);
+    });
+    it('should enumerate patches when the local condition is met', () => {
+        const patches = [...enumeratePatches(PersonSchema, {
+                name: "John Doe",
+                age: 10,
+            })];
+        expect(patches).toEqual([
+            { path: ["$", "properties", "email", "ui"], fragment: { visible: false } },
+        ]);
+    });
+    it('should match on oneOf cases for human', () => {
+        const patches = [...enumeratePatches(PersonSchemaWithOneOf, {
+                name: "John Doe",
+                species: "human",
+            })];
+        expect(patches).toEqual([
+            { path: ["$", "properties", "email", "ui"], fragment: { visible: true } },
+        ]);
+    });
+    it('should match on oneOf cases for robot', () => {
+        const patches = [...enumeratePatches(PersonSchemaWithOneOf, {
+                name: "John Doe",
+                species: "robot",
+            })];
+        expect(patches).toEqual([
+            { path: ["$", "properties", "email", "ui"], fragment: { enabled: false } },
+        ]);
+    });
+    it('should match on complex root conditions', () => {
+        const patches = [...enumeratePatches(PersonSchemaRootConditions, {
+                name: "John Doe",
+                species: "human",
+            })];
+        expect(patches).toEqual([
+            { path: ["$", "properties", "email", "ui"], fragment: { visible: true } },
+        ]);
+    });
+    it('should match on simple root conditions', () => {
+        const patches = [...enumeratePatches(PersonSchemaRootConditions, {
+                name: "ab",
+                species: "human",
+            })];
+        expect(patches).toEqual([
+            { path: ["$", "properties", "email", "ui"], fragment: { visible: false } },
+        ]);
+    });
+});
+//# sourceMappingURL=enumerate-patches.test.js.map

package/dist/core/schema/dynamic/enumerate-patches.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enumerate-patches.test.js","sourceRoot":"","sources":["../../../../src/core/schema/dynamic/enumerate-patches.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE;gBACA,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,UAAU;aAC1B;SACJ;QACD,GAAG,EAAE;YACD,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,GAAG;YACZ,EAAE,EAAE;gBACA,IAAI,EAAE,KAAK;aACd;YACD,YAAY,EAAE;gBACV,0DAA0D;gBAC1D;oBACI,IAAI,EAAE,uBAAuB;oBAC7B,KAAK,EAAE;wBACH,OAAO,EAAE,KAAK;qBACjB;oBACD,KAAK,EAAE;wBACH,gBAAgB,EAAE,EAAE;qBACvB;iBACJ;aACJ;SACJ;QACD,KAAK,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE;gBACA,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,sBAAsB;aACtC;SACJ;KACJ;IACD,oBAAoB,EAAE,KAAK;CACJ,CAAC;AAE5B,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE;gBACA,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,UAAU;aAC1B;SACJ;QACD,OAAO,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE;gBACH;oBACI,KAAK,EAAE,OAAO;oBACd,YAAY,EAAE;wBACV;4BACI,IAAI,EAAE,uBAAuB;4BAC7B,KAAK,EAAE;gCACH,OAAO,EAAE,IAAI;6BAChB;yBACJ;qBACJ;iBACJ;gBACD;oBACI,KAAK,EAAE,OAAO;oBACd,YAAY,EAAE;wBACV;4BACI,IAAI,EAAE,uBAAuB;4BAC7B,KAAK,EAAE;gCACH,OAAO,EAAE,KAAK;6BACjB;yBACJ;qBACJ;iBACJ;aACJ;SACJ;QACD,KAAK,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE;gBACA,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,sBAAsB;aACtC;SACJ;KACJ;IACD,oBAAoB,EAAE,KAAK;CACJ,CAAC;AAE5B,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACtC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE;gBACA,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,UAAU;aAC1B;SACJ;QACD,OAAO,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE;gBACH;oBACI,KAAK,EAAE,OAAO;iBACjB;gBACD;oBACI,KAAK,EAAE,OAAO;iBACjB;aACJ;SACJ;QACD,KAAK,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE;gBACA,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,sBAAsB;aACtC;SACJ;KACJ;IACD,YAAY,EAAE;QACV,mEAAmE;QACnE;YACI,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE;gBACH,OAAO,EAAE,KAAK;aACjB;YACD,KAAK,EAAE;gBACH,UAAU,EAAE;oBACR,IAAI,EAAE;wBACF,SAAS,EAAE,CAAC;qBACf;iBACJ;aACJ;SACJ;QACD,2FAA2F;QAC3F;YACI,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE;gBACH,OAAO,EAAE,IAAI;aAChB;YACD,KAAK,EAAE;gBACH,UAAU,EAAE;oBACR,IAAI,EAAE;wBACF,SAAS,EAAE,CAAC;qBACf;oBACD,OAAO,EAAE;wBACL,KAAK,EAAE,OAAO;qBACjB;iBACJ;aACJ;SACJ;KACJ;IACD,oBAAoB,EAAE,KAAK;CACJ,CAAC;AAE5B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QACxE,MAAM,OAAO,GAAG,CAAC,GAAG,gBAAgB,CAAC,YAAY,EAAE;gBAC/C,IAAI,EAAE,UAAU;gBAChB,GAAG,EAAE,EAAE;aACV,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EACvB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAChE,MAAM,OAAO,GAAG,CAAC,GAAG,gBAAgB,CAAC,YAAY,EAAE;gBAC/C,IAAI,EAAE,UAAU;gBAChB,GAAG,EAAE,EAAE;aACV,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACpB,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;SAC7E,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC7C,MAAM,OAAO,GAAG,CAAC,GAAG,gBAAgB,CAAC,qBAAqB,EAAE;gBACxD,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,OAAO;aACnB,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACpB,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;SAC5E,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC7C,MAAM,OAAO,GAAG,CAAC,GAAG,gBAAgB,CAAC,qBAAqB,EAAE;gBACxD,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,OAAO;aACnB,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACpB,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;SAC7E,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAG,CAAC,GAAG,gBAAgB,CAAC,0BAA0B,EAAE;gBAC7D,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,OAAO;aACnB,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACpB,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;SAC5E,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAC9C,MAAM,OAAO,GAAG,CAAC,GAAG,gBAAgB,CAAC,0BAA0B,EAAE;gBAC7D,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,OAAO;aACnB,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACpB,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;SAC7E,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/core/schema/dynamic/get-dynamic-schema.d.ts

@@ -0,0 +1,5 @@
+import { Schema } from "../schema.js";
+/**
+ * Gets a dynamic schema from a static schema with conditionals and a current value.
+ */
+export declare function getDynamicSchema(schema: Schema, value: unknown): Schema;

package/dist/core/schema/dynamic/get-dynamic-schema.js

@@ -0,0 +1,26 @@
+import { normalize } from "../../data.js";
+import { deepMerge } from "../../functions/deep-merge.js";
+import { enumeratePatches } from "./enumerate-patches.js";
+import jp from "jsonpath";
+/**
+ * Gets a dynamic schema from a static schema with conditionals and a current value.
+ */
+export function getDynamicSchema(schema, value) {
+    let input = schema;
+    for (let i = 0; i < 20; i++) {
+        const output = structuredClone(input);
+        for (const { path, fragment } of enumeratePatches(input, value)) {
+            const node = jp.value(output, jp.stringify(path));
+            if (typeof node !== "object" || node === null) {
+                throw new Error(`Target node MUST be an object, found: ${JSON.stringify(node)} at ${jp.stringify(path)}`);
+            }
+            Object.assign(node, deepMerge(node, fragment, { mergeArrays: false }));
+        }
+        if (JSON.stringify(normalize(input)) === JSON.stringify(normalize(output))) {
+            return output;
+        }
+        input = output;
+    }
+    throw new Error("Failed resolve stable dynamic schema");
+}
+//# sourceMappingURL=get-dynamic-schema.js.map

package/dist/core/schema/dynamic/get-dynamic-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dynamic-schema.js","sourceRoot":"","sources":["../../../../src/core/schema/dynamic/get-dynamic-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1B;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAc;IAC3D,IAAI,KAAK,GAAG,MAAM,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAClD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9G,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACzE,OAAO,MAAM,CAAC;QAClB,CAAC;QACD,KAAK,GAAG,MAAM,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/core/schema/dynamic/get-dynamic-schema.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/schema/dynamic/get-dynamic-schema.test.js

@@ -0,0 +1,94 @@
+import { describe, it, expect } from 'vitest';
+import { getDynamicSchema } from './get-dynamic-schema.js';
+import { PersonSchema, PersonSchemaWithOneOf, PersonSchemaRootConditions } from './enumerate-patches.test.js';
+describe('getDynamicSchema', () => {
+    it('should not modify schema when local condition is not met', () => {
+        const dynamicSchema = getDynamicSchema(PersonSchema, {
+            name: "John Doe",
+            age: 20,
+        });
+        // Email UI should remain unchanged
+        expect(dynamicSchema.properties?.email?.ui).toEqual({
+            name: "Email",
+            placeholder: "john.doe@example.com",
+        });
+    });
+    it('should modify schema when local condition is met', () => {
+        const dynamicSchema = getDynamicSchema(PersonSchema, {
+            name: "John Doe",
+            age: 10,
+        });
+        // Email UI should be hidden
+        expect(dynamicSchema.properties?.email?.ui).toEqual({
+            name: "Email",
+            placeholder: "john.doe@example.com",
+            visible: false,
+        });
+    });
+    it('should apply oneOf conditions for human', () => {
+        const dynamicSchema = getDynamicSchema(PersonSchemaWithOneOf, {
+            name: "John Doe",
+            species: "human",
+        });
+        // Email UI should be visible
+        expect(dynamicSchema.properties?.email?.ui).toEqual({
+            name: "Email",
+            placeholder: "john.doe@example.com",
+            visible: true,
+        });
+    });
+    it('should apply oneOf conditions for robot', () => {
+        const dynamicSchema = getDynamicSchema(PersonSchemaWithOneOf, {
+            name: "John Doe",
+            species: "robot",
+        });
+        // Email UI should be disabled
+        expect(dynamicSchema.properties?.email?.ui).toEqual({
+            name: "Email",
+            placeholder: "john.doe@example.com",
+            enabled: false,
+        });
+    });
+    it('should apply complex root conditions', () => {
+        const dynamicSchema = getDynamicSchema(PersonSchemaRootConditions, {
+            name: "John Doe",
+            species: "human",
+        });
+        // Email UI should be visible due to name length > 3 and species being human
+        expect(dynamicSchema.properties?.email?.ui).toEqual({
+            name: "Email",
+            placeholder: "john.doe@example.com",
+            visible: true,
+        });
+    });
+    it('should apply simple root conditions', () => {
+        const dynamicSchema = getDynamicSchema(PersonSchemaRootConditions, {
+            name: "ab",
+            species: "human",
+        });
+        // Email UI should be hidden due to name length <= 2
+        expect(dynamicSchema.properties?.email?.ui).toEqual({
+            name: "Email",
+            placeholder: "john.doe@example.com",
+            visible: false,
+        });
+    });
+    it('should throw error when target node is not an object', () => {
+        const invalidSchema = {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    conditionals: [{
+                            path: "$.type", // targeting a string, not an object
+                            value: { visible: false }
+                        }]
+                }
+            }
+        };
+        expect(() => getDynamicSchema(invalidSchema, {
+            name: "John Doe"
+        })).toThrow('Target node MUST be an object');
+    });
+});
+//# sourceMappingURL=get-dynamic-schema.test.js.map

package/dist/core/schema/dynamic/get-dynamic-schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dynamic-schema.test.js","sourceRoot":"","sources":["../../../../src/core/schema/dynamic/get-dynamic-schema.test.ts"],"names":[],"mappings":"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"}

package/dist/core/schema/dynamic/index.d.ts

@@ -0,0 +1 @@
+export * from './get-dynamic-schema.js';

package/dist/core/schema/dynamic/index.js

@@ -0,0 +1,2 @@
+export * from './get-dynamic-schema.js';
+//# sourceMappingURL=index.js.map

package/dist/core/schema/dynamic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/schema/dynamic/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/core/schema/dynamic/schema-path-value-path.d.ts

@@ -0,0 +1,5 @@
+import { PathComponent } from "jsonpath";
+/**
+ * Given a JSPON path into a schema, return the JSON path to find the corresponding value in the value object.
+ */
+export declare function schemaPathValuePath(schemaPath: PathComponent[]): PathComponent[];

package/dist/core/schema/dynamic/schema-path-value-path.js

@@ -0,0 +1,12 @@
+/**
+ * Given a JSPON path into a schema, return the JSON path to find the corresponding value in the value object.
+ */
+export function schemaPathValuePath(schemaPath) {
+    return schemaPath.filter((p) => {
+        if (p === "properties" || p === "items" || p === "oneOf") {
+            return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=schema-path-value-path.js.map

package/dist/core/schema/dynamic/schema-path-value-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-path-value-path.js","sourceRoot":"","sources":["../../../../src/core/schema/dynamic/schema-path-value-path.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA2B;IAC3D,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAgB,EAAE,EAAE;QAC1C,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/core/schema/dynamic-schema.d.ts

@@ -0,0 +1,27 @@
+import { Data } from "../../index.js";
+import { Schema } from "./schema.js";
+type JSONPath = string;
+type JSONMergePatch = Data;
+/**
+ * Conditional patch applied to the path when the enclosing schema branch is active
+ * and `match` is not present or validates against the root.
+ */
+export interface Conditional {
+    readonly match?: Schema;
+    readonly path: JSONPath;
+    readonly value: JSONMergePatch;
+}
+/**
+ * A Dynamic Schema extends a base schema with conditional behaviour
+ * based upon the current state of the data the schema describes.
+ */
+export type DynamicSchema<B extends Schema> = B & {
+    readonly conditionals?: readonly Conditional[];
+    readonly items?: DynamicSchema<B>;
+    readonly properties?: {
+        readonly [key: string]: DynamicSchema<B>;
+    };
+    readonly additionalProperties?: boolean | DynamicSchema<B>;
+    readonly oneOf?: readonly DynamicSchema<B>[];
+};
+export {};

package/dist/core/schema/dynamic-schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dynamic-schema.js.map

package/dist/core/schema/dynamic-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-schema.js","sourceRoot":"","sources":["../../../src/core/schema/dynamic-schema.ts"],"names":[],"mappings":""}

package/dist/core/schema/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./schema.js";
+export * from "./schemas.js";
+export * from "./dynamic/index.js";
+export * from "./validation/with-validation.js";

package/dist/core/schema/index.js

@@ -0,0 +1,26 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+export * from "./schema.js";
+export * from "./schemas.js";
+export * from "./dynamic/index.js";
+export * from "./validation/with-validation.js";
+//# sourceMappingURL=index.js.map

package/dist/core/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC"}