@schema-ts/core 0.1.0 → 0.1.1

package/dist/index.d.cts

@@ -219,15 +219,6 @@ declare class SchemaRuntime {
      * const runtime = new SchemaRuntime(validator, schema, { name: "Alice" });
      */
     constructor(validator: Validator, schema: Schema | unknown, value: unknown);
-    /**
-     * Collect all dependencies for a node's schema.
-     *
-     * Key insight: We extract paths from condition keywords (if, oneOf, anyOf)
-     * using extractReferencedPaths, but for then/else/allOf keywords, we recursively
-     * call collectDependencies to ensure proper dependency isolation between
-     * parent and child nodes.
-     */
-    private collectDependencies;
     /**
      * Register a node as dependent on a path
      */
@@ -350,6 +341,26 @@ declare class SchemaRuntime {
      */
     findNode(path: string): FieldNode | undefined;
     private findNearestExistingNode;
+    /**
+     * Update node dependencies when schema changes.
+     * Unregisters old dependencies and registers new ones.
+     */
+    private updateNodeDependencies;
+    /**
+     * Apply default values when effective schema changes.
+     * This handles cases like if-then-else where new properties with defaults
+     * may appear when conditions change.
+     *
+     * @param instanceLocation - The path to the node
+     * @param newSchema - The new effective schema
+     * @param type - The schema type
+     */
+    private applySchemaDefaults;
+    /**
+     * Build children for object and array nodes.
+     * Reuses existing child nodes where possible.
+     */
+    private buildNodeChildren;
     /**
      * Build/update a FieldNode in place.
      * Updates the node's schema, type, error, and children based on the current value.
@@ -409,4 +420,59 @@ interface NormalizerOptions {
  */
 declare function normalizeSchema(schema: unknown, options?: NormalizerOptions): Schema;
 
-export { DRAFT_URIS, type ErrorFormatter, type ErrorMessage, type FieldNode, MESSAGES, type NormalizerOptions, type Output, type Schema, type SchemaChangeEvent, type SchemaDraft, SchemaRuntime, type SchemaType, StringFormatValidator, type StringFormatValidatorInterface, Validator, type ValidatorConfig, type ValidatorOptions, deepEqual, defaultErrorFormatter, detectSchemaDraft, detectSchemaType, get, getJsonPointer, jsonPointerEscape, jsonPointerJoin, jsonPointerUnescape, matchSchemaType, normalizeSchema, parseJsonPointer, removeJsonPointer, resolveAbsolutePath, safeRegexTest, setJsonPointer, stringFormatValidator, validateSchema };
+/**
+ * Collect all dependencies for a node's schema.
+ *
+ * Key insight: We extract paths from condition keywords (if, oneOf, anyOf)
+ * using extractReferencedPaths, but for then/else/allOf keywords, we recursively
+ * call collectDependencies to ensure proper dependency isolation between
+ * parent and child nodes.
+ */
+declare function collectDependencies(schema: Schema, instanceLocation: string): Set<string>;
+/**
+ * Extract referenced paths from a conditional schema (if, oneOf, anyOf, etc.)
+ * Returns paths relative to the current node
+ *
+ * @param conditionSchema - The schema to extract paths from
+ * @param basePath - Base path for relative paths
+ * @param depth - Current recursion depth (internal use)
+ */
+declare function extractReferencedPaths(conditionSchema: Schema, basePath?: string, depth?: number): string[];
+
+/**
+ * Generate a default value for a schema based on its type and constraints.
+ *
+ * Priority order for determining the default value:
+ *   1. const - if defined, returns the const value
+ *   2. default - if defined, returns the default value
+ *   3. Type-based defaults:
+ *      - string: ""
+ *      - number/integer: 0
+ *      - boolean: false
+ *      - null: null
+ *      - object: {} with required properties recursively initialized
+ *      - array: []
+ *
+ * For objects, only required properties are initialized with their default values.
+ * If no type is specified but properties exist, the schema is treated as an object.
+ *
+ * If a value is provided, it will be used as the base and missing defaults will be filled in.
+ *
+ * @param schema - The JSON Schema to generate a default value for
+ * @param value - Optional existing value to fill defaults into
+ * @returns The generated default value, or undefined if type cannot be determined
+ *
+ * @example
+ * getDefaultValue({ type: "string" }) // returns ""
+ * getDefaultValue({ type: "number", default: 42 }) // returns 42
+ * getDefaultValue({ const: "fixed" }) // returns "fixed"
+ * getDefaultValue({
+ *   type: "object",
+ *   properties: { name: { type: "string" } },
+ *   required: ["name"]
+ * }) // returns { name: "" }
+ * getDefaultValue({ type: "object", properties: { a: { default: 1 } } }, {}) // returns { a: 1 }
+ */
+declare function getDefaultValue(schema: Schema, value?: unknown): unknown;
+
+export { DRAFT_URIS, type ErrorFormatter, type ErrorMessage, type FieldNode, MESSAGES, type NormalizerOptions, type Output, type Schema, type SchemaChangeEvent, type SchemaDraft, SchemaRuntime, type SchemaType, StringFormatValidator, type StringFormatValidatorInterface, Validator, type ValidatorConfig, type ValidatorOptions, collectDependencies, deepEqual, defaultErrorFormatter, detectSchemaDraft, detectSchemaType, extractReferencedPaths, get, getDefaultValue, getJsonPointer, jsonPointerEscape, jsonPointerJoin, jsonPointerUnescape, matchSchemaType, normalizeSchema, parseJsonPointer, removeJsonPointer, resolveAbsolutePath, safeRegexTest, setJsonPointer, stringFormatValidator, validateSchema };

package/dist/index.d.ts

@@ -219,15 +219,6 @@ declare class SchemaRuntime {
      * const runtime = new SchemaRuntime(validator, schema, { name: "Alice" });
      */
     constructor(validator: Validator, schema: Schema | unknown, value: unknown);
-    /**
-     * Collect all dependencies for a node's schema.
-     *
-     * Key insight: We extract paths from condition keywords (if, oneOf, anyOf)
-     * using extractReferencedPaths, but for then/else/allOf keywords, we recursively
-     * call collectDependencies to ensure proper dependency isolation between
-     * parent and child nodes.
-     */
-    private collectDependencies;
     /**
      * Register a node as dependent on a path
      */
@@ -350,6 +341,26 @@ declare class SchemaRuntime {
      */
     findNode(path: string): FieldNode | undefined;
     private findNearestExistingNode;
+    /**
+     * Update node dependencies when schema changes.
+     * Unregisters old dependencies and registers new ones.
+     */
+    private updateNodeDependencies;
+    /**
+     * Apply default values when effective schema changes.
+     * This handles cases like if-then-else where new properties with defaults
+     * may appear when conditions change.
+     *
+     * @param instanceLocation - The path to the node
+     * @param newSchema - The new effective schema
+     * @param type - The schema type
+     */
+    private applySchemaDefaults;
+    /**
+     * Build children for object and array nodes.
+     * Reuses existing child nodes where possible.
+     */
+    private buildNodeChildren;
     /**
      * Build/update a FieldNode in place.
      * Updates the node's schema, type, error, and children based on the current value.
@@ -409,4 +420,59 @@ interface NormalizerOptions {
  */
 declare function normalizeSchema(schema: unknown, options?: NormalizerOptions): Schema;
 
-export { DRAFT_URIS, type ErrorFormatter, type ErrorMessage, type FieldNode, MESSAGES, type NormalizerOptions, type Output, type Schema, type SchemaChangeEvent, type SchemaDraft, SchemaRuntime, type SchemaType, StringFormatValidator, type StringFormatValidatorInterface, Validator, type ValidatorConfig, type ValidatorOptions, deepEqual, defaultErrorFormatter, detectSchemaDraft, detectSchemaType, get, getJsonPointer, jsonPointerEscape, jsonPointerJoin, jsonPointerUnescape, matchSchemaType, normalizeSchema, parseJsonPointer, removeJsonPointer, resolveAbsolutePath, safeRegexTest, setJsonPointer, stringFormatValidator, validateSchema };
+/**
+ * Collect all dependencies for a node's schema.
+ *
+ * Key insight: We extract paths from condition keywords (if, oneOf, anyOf)
+ * using extractReferencedPaths, but for then/else/allOf keywords, we recursively
+ * call collectDependencies to ensure proper dependency isolation between
+ * parent and child nodes.
+ */
+declare function collectDependencies(schema: Schema, instanceLocation: string): Set<string>;
+/**
+ * Extract referenced paths from a conditional schema (if, oneOf, anyOf, etc.)
+ * Returns paths relative to the current node
+ *
+ * @param conditionSchema - The schema to extract paths from
+ * @param basePath - Base path for relative paths
+ * @param depth - Current recursion depth (internal use)
+ */
+declare function extractReferencedPaths(conditionSchema: Schema, basePath?: string, depth?: number): string[];
+
+/**
+ * Generate a default value for a schema based on its type and constraints.
+ *
+ * Priority order for determining the default value:
+ *   1. const - if defined, returns the const value
+ *   2. default - if defined, returns the default value
+ *   3. Type-based defaults:
+ *      - string: ""
+ *      - number/integer: 0
+ *      - boolean: false
+ *      - null: null
+ *      - object: {} with required properties recursively initialized
+ *      - array: []
+ *
+ * For objects, only required properties are initialized with their default values.
+ * If no type is specified but properties exist, the schema is treated as an object.
+ *
+ * If a value is provided, it will be used as the base and missing defaults will be filled in.
+ *
+ * @param schema - The JSON Schema to generate a default value for
+ * @param value - Optional existing value to fill defaults into
+ * @returns The generated default value, or undefined if type cannot be determined
+ *
+ * @example
+ * getDefaultValue({ type: "string" }) // returns ""
+ * getDefaultValue({ type: "number", default: 42 }) // returns 42
+ * getDefaultValue({ const: "fixed" }) // returns "fixed"
+ * getDefaultValue({
+ *   type: "object",
+ *   properties: { name: { type: "string" } },
+ *   required: ["name"]
+ * }) // returns { name: "" }
+ * getDefaultValue({ type: "object", properties: { a: { default: 1 } } }, {}) // returns { a: 1 }
+ */
+declare function getDefaultValue(schema: Schema, value?: unknown): unknown;
+
+export { DRAFT_URIS, type ErrorFormatter, type ErrorMessage, type FieldNode, MESSAGES, type NormalizerOptions, type Output, type Schema, type SchemaChangeEvent, type SchemaDraft, SchemaRuntime, type SchemaType, StringFormatValidator, type StringFormatValidatorInterface, Validator, type ValidatorConfig, type ValidatorOptions, collectDependencies, deepEqual, defaultErrorFormatter, detectSchemaDraft, detectSchemaType, extractReferencedPaths, get, getDefaultValue, getJsonPointer, jsonPointerEscape, jsonPointerJoin, jsonPointerUnescape, matchSchemaType, normalizeSchema, parseJsonPointer, removeJsonPointer, resolveAbsolutePath, safeRegexTest, setJsonPointer, stringFormatValidator, validateSchema };