@schema-ts/core 0.1.1 → 0.1.3

package/dist/index.d.cts

@@ -196,6 +196,16 @@ type SchemaChangeEvent = {
     type: "schema" | "value" | "error";
     path: string;
 };
+interface SchemaRuntimeOptions {
+    /**
+     * Control how default values are applied when schema changes.
+     * - 'always': Fill all type-based defaults (e.g., [] for array, "" for string)
+     * - 'explicit': Only fill explicitly declared defaults (schema.default)
+     * - 'never': Never auto-fill defaults
+     * @default 'explicit'
+     */
+    autoFillDefaults?: "always" | "explicit" | "never";
+}
 declare class SchemaRuntime {
     private validator;
     private watchers;
@@ -206,19 +216,21 @@ declare class SchemaRuntime {
     private value;
     private version;
     private rootSchema;
+    private options;
     /**
      * Create a new SchemaRuntime instance.
      *
      * @param validator - The validator instance for schema validation
      * @param schema - The JSON Schema definition (will be normalized and dereferenced)
      * @param value - The initial data value to manage
+     * @param options - Runtime configuration options
      *
      * @example
      * const validator = new Validator();
      * const schema = { type: "object", properties: { name: { type: "string" } } };
      * const runtime = new SchemaRuntime(validator, schema, { name: "Alice" });
      */
-    constructor(validator: Validator, schema: Schema | unknown, value: unknown);
+    constructor(validator: Validator, schema: Schema | unknown, value: unknown, options?: SchemaRuntimeOptions);
     /**
      * Register a node as dependent on a path
      */
@@ -297,6 +309,15 @@ declare class SchemaRuntime {
      * runtime.getValue("/name"); // returns value at /name
      */
     getValue(path: string): unknown;
+    /**
+     * Internal helper to set a value at a normalized path.
+     * Handles both root and non-root paths.
+     *
+     * @param normalizedPath - The normalized JSON Pointer path
+     * @param value - The value to set
+     * @returns true if successful, false if the path cannot be set
+     */
+    private setValueAtPath;
     /**
      * Remove a node at the specified path.
      * This deletes the value from the data structure (array splice or object delete).
@@ -445,13 +466,7 @@ declare function extractReferencedPaths(conditionSchema: Schema, basePath?: stri
  * 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: []
+ *   3. Type-based defaults (controlled by strategy):
  *
  * 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.
@@ -460,10 +475,14 @@ declare function extractReferencedPaths(conditionSchema: Schema, basePath?: stri
  *
  * @param schema - The JSON Schema to generate a default value for
  * @param value - Optional existing value to fill defaults into
+ * @param strategy - Controls type-based default behavior:
+ *   - 'always' (default): Returns type-based defaults (e.g., "" for string, [] for array)
+ *   - 'explicit': Only returns explicitly declared schema.const or schema.default
  * @returns The generated default value, or undefined if type cannot be determined
  *
  * @example
  * getDefaultValue({ type: "string" }) // returns ""
+ * getDefaultValue({ type: "string" }, undefined, 'explicit') // returns undefined
  * getDefaultValue({ type: "number", default: 42 }) // returns 42
  * getDefaultValue({ const: "fixed" }) // returns "fixed"
  * getDefaultValue({
@@ -473,6 +492,6 @@ declare function extractReferencedPaths(conditionSchema: Schema, basePath?: stri
  * }) // returns { name: "" }
  * getDefaultValue({ type: "object", properties: { a: { default: 1 } } }, {}) // returns { a: 1 }
  */
-declare function getDefaultValue(schema: Schema, value?: unknown): unknown;
+declare function getDefaultValue(schema: Schema, value?: unknown, strategy?: "always" | "explicit"): 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 };
+export { DRAFT_URIS, type ErrorFormatter, type ErrorMessage, type FieldNode, MESSAGES, type NormalizerOptions, type Output, type Schema, type SchemaChangeEvent, type SchemaDraft, SchemaRuntime, type SchemaRuntimeOptions, 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

@@ -196,6 +196,16 @@ type SchemaChangeEvent = {
     type: "schema" | "value" | "error";
     path: string;
 };
+interface SchemaRuntimeOptions {
+    /**
+     * Control how default values are applied when schema changes.
+     * - 'always': Fill all type-based defaults (e.g., [] for array, "" for string)
+     * - 'explicit': Only fill explicitly declared defaults (schema.default)
+     * - 'never': Never auto-fill defaults
+     * @default 'explicit'
+     */
+    autoFillDefaults?: "always" | "explicit" | "never";
+}
 declare class SchemaRuntime {
     private validator;
     private watchers;
@@ -206,19 +216,21 @@ declare class SchemaRuntime {
     private value;
     private version;
     private rootSchema;
+    private options;
     /**
      * Create a new SchemaRuntime instance.
      *
      * @param validator - The validator instance for schema validation
      * @param schema - The JSON Schema definition (will be normalized and dereferenced)
      * @param value - The initial data value to manage
+     * @param options - Runtime configuration options
      *
      * @example
      * const validator = new Validator();
      * const schema = { type: "object", properties: { name: { type: "string" } } };
      * const runtime = new SchemaRuntime(validator, schema, { name: "Alice" });
      */
-    constructor(validator: Validator, schema: Schema | unknown, value: unknown);
+    constructor(validator: Validator, schema: Schema | unknown, value: unknown, options?: SchemaRuntimeOptions);
     /**
      * Register a node as dependent on a path
      */
@@ -297,6 +309,15 @@ declare class SchemaRuntime {
      * runtime.getValue("/name"); // returns value at /name
      */
     getValue(path: string): unknown;
+    /**
+     * Internal helper to set a value at a normalized path.
+     * Handles both root and non-root paths.
+     *
+     * @param normalizedPath - The normalized JSON Pointer path
+     * @param value - The value to set
+     * @returns true if successful, false if the path cannot be set
+     */
+    private setValueAtPath;
     /**
      * Remove a node at the specified path.
      * This deletes the value from the data structure (array splice or object delete).
@@ -445,13 +466,7 @@ declare function extractReferencedPaths(conditionSchema: Schema, basePath?: stri
  * 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: []
+ *   3. Type-based defaults (controlled by strategy):
  *
  * 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.
@@ -460,10 +475,14 @@ declare function extractReferencedPaths(conditionSchema: Schema, basePath?: stri
  *
  * @param schema - The JSON Schema to generate a default value for
  * @param value - Optional existing value to fill defaults into
+ * @param strategy - Controls type-based default behavior:
+ *   - 'always' (default): Returns type-based defaults (e.g., "" for string, [] for array)
+ *   - 'explicit': Only returns explicitly declared schema.const or schema.default
  * @returns The generated default value, or undefined if type cannot be determined
  *
  * @example
  * getDefaultValue({ type: "string" }) // returns ""
+ * getDefaultValue({ type: "string" }, undefined, 'explicit') // returns undefined
  * getDefaultValue({ type: "number", default: 42 }) // returns 42
  * getDefaultValue({ const: "fixed" }) // returns "fixed"
  * getDefaultValue({
@@ -473,6 +492,6 @@ declare function extractReferencedPaths(conditionSchema: Schema, basePath?: stri
  * }) // returns { name: "" }
  * getDefaultValue({ type: "object", properties: { a: { default: 1 } } }, {}) // returns { a: 1 }
  */
-declare function getDefaultValue(schema: Schema, value?: unknown): unknown;
+declare function getDefaultValue(schema: Schema, value?: unknown, strategy?: "always" | "explicit"): 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 };
+export { DRAFT_URIS, type ErrorFormatter, type ErrorMessage, type FieldNode, MESSAGES, type NormalizerOptions, type Output, type Schema, type SchemaChangeEvent, type SchemaDraft, SchemaRuntime, type SchemaRuntimeOptions, 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.js

@@ -1398,7 +1398,6 @@ function resolveEffectiveSchema(validator, schema, value, keywordLocation, insta
           instanceLocation
         );
         effective = mergeSchema(effective, res.effectiveSchema);
-        break;
       }
     }
     const { anyOf: _, ...rest } = effective;
@@ -1470,6 +1469,19 @@ function mergeSchemaArrays(a, b) {
   if (b === void 0) return a;
   return [...a, ...b];
 }
+function mergeSchemaMap(base, override) {
+  if (base === void 0) return override;
+  if (override === void 0) return base;
+  const merged = { ...base };
+  for (const [key, schema] of Object.entries(override)) {
+    if (merged[key]) {
+      merged[key] = mergeSchema(merged[key], schema);
+    } else {
+      merged[key] = schema;
+    }
+  }
+  return merged;
+}
 function mergeSchema(base, override) {
   if (!override) return base;
   const merged = {
@@ -1496,17 +1508,16 @@ function mergeSchema(base, override) {
       ...override.dependentRequired
     };
   }
-  if (base.properties || override.properties) {
-    merged.properties = {
-      ...base.properties,
-      ...override.properties
-    };
+  const mergedProperties = mergeSchemaMap(base.properties, override.properties);
+  if (mergedProperties !== void 0) {
+    merged.properties = mergedProperties;
   }
-  if (base.patternProperties || override.patternProperties) {
-    merged.patternProperties = {
-      ...base.patternProperties,
-      ...override.patternProperties
-    };
+  const mergedPatternProperties = mergeSchemaMap(
+    base.patternProperties,
+    override.patternProperties
+  );
+  if (mergedPatternProperties !== void 0) {
+    merged.patternProperties = mergedPatternProperties;
   }
   if (base.items && override.items) {
     merged.items = mergeSchema(base.items, override.items);
@@ -1541,11 +1552,12 @@ function mergeSchema(base, override) {
       merged[keyword] = mergedArray;
     }
   }
-  if (base.dependentSchemas || override.dependentSchemas) {
-    merged.dependentSchemas = {
-      ...base.dependentSchemas,
-      ...override.dependentSchemas
-    };
+  const mergedDependentSchemas = mergeSchemaMap(
+    base.dependentSchemas,
+    override.dependentSchemas
+  );
+  if (mergedDependentSchemas !== void 0) {
+    merged.dependentSchemas = mergedDependentSchemas;
   }
   return merged;
 }
@@ -1766,10 +1778,11 @@ function getSubSchema(schema, key) {
 }
 
 // src/default.ts
-function getDefaultValue(schema, value) {
+function getDefaultValue(schema, value, strategy = "explicit") {
   if (value === void 0) {
     if (schema.const !== void 0) return schema.const;
     if (schema.default !== void 0) return schema.default;
+    if (strategy === "explicit") return void 0;
   }
   const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;
   if (type === "object" || !type && schema.properties) {
@@ -1784,9 +1797,9 @@ function getDefaultValue(schema, value) {
     if (schema.properties) {
       for (const [key, subschema] of Object.entries(schema.properties)) {
         if (obj[key] !== void 0) {
-          obj[key] = getDefaultValue(subschema, obj[key]);
+          obj[key] = getDefaultValue(subschema, obj[key], strategy);
         } else if (schema.required?.includes(key)) {
-          obj[key] = getDefaultValue(subschema);
+          obj[key] = getDefaultValue(subschema, void 0, strategy);
         }
       }
     }
@@ -1804,16 +1817,16 @@ function getDefaultValue(schema, value) {
     if (schema.prefixItems) {
       schema.prefixItems.forEach((subschema, index) => {
         if (index < arr.length) {
-          arr[index] = getDefaultValue(subschema, arr[index]);
+          arr[index] = getDefaultValue(subschema, arr[index], strategy);
         } else if (value === void 0) {
-          arr.push(getDefaultValue(subschema));
+          arr.push(getDefaultValue(subschema, void 0, strategy));
         }
       });
     }
     if (value !== void 0 && schema.items) {
       const startIndex = schema.prefixItems ? schema.prefixItems.length : 0;
       for (let i = startIndex; i < arr.length; i++) {
-        arr[i] = getDefaultValue(schema.items, arr[i]);
+        arr[i] = getDefaultValue(schema.items, arr[i], strategy);
       }
     }
     return arr;
@@ -2027,21 +2040,24 @@ var SchemaRuntime = class {
   value;
   version = 0;
   rootSchema = {};
+  options;
   /**
    * Create a new SchemaRuntime instance.
    *
    * @param validator - The validator instance for schema validation
    * @param schema - The JSON Schema definition (will be normalized and dereferenced)
    * @param value - The initial data value to manage
+   * @param options - Runtime configuration options
    *
    * @example
    * const validator = new Validator();
    * const schema = { type: "object", properties: { name: { type: "string" } } };
    * const runtime = new SchemaRuntime(validator, schema, { name: "Alice" });
    */
-  constructor(validator, schema, value) {
+  constructor(validator, schema, value, options = {}) {
     this.validator = validator;
     this.value = value;
+    this.options = { autoFillDefaults: "explicit", ...options };
     const normalized = normalizeSchema(schema);
     this.rootSchema = dereferenceSchemaDeep(normalized, normalized);
     this.root = this.createEmptyNode("", "#");
@@ -2223,6 +2239,21 @@ var SchemaRuntime = class {
     if (normalizedPath === ROOT_PATH) return this.value;
     return getJsonPointer(this.value, normalizedPath);
   }
+  /**
+   * Internal helper to set a value at a normalized path.
+   * Handles both root and non-root paths.
+   *
+   * @param normalizedPath - The normalized JSON Pointer path
+   * @param value - The value to set
+   * @returns true if successful, false if the path cannot be set
+   */
+  setValueAtPath(normalizedPath, value) {
+    if (normalizedPath === ROOT_PATH) {
+      this.value = value;
+      return true;
+    }
+    return setJsonPointer(this.value, normalizedPath, value);
+  }
   /**
    * Remove a node at the specified path.
    * This deletes the value from the data structure (array splice or object delete).
@@ -2263,8 +2294,23 @@ var SchemaRuntime = class {
     if (!parentNode || !parentNode.canAdd) {
       return false;
     }
-    const parentValue = this.getValue(normalizedPath);
+    let parentValue = this.getValue(normalizedPath);
     const parentSchema = parentNode.schema;
+    if (parentNode.type === "array") {
+      if (Array.isArray(parentValue)) ; else if (parentValue === void 0 || parentValue === null) {
+        parentValue = [];
+        this.setValueAtPath(normalizedPath, parentValue);
+      } else {
+        return false;
+      }
+    } else if (parentNode.type === "object") {
+      if (parentValue && typeof parentValue === "object") ; else if (parentValue === void 0 || parentValue === null) {
+        parentValue = {};
+        this.setValueAtPath(normalizedPath, parentValue);
+      } else {
+        return false;
+      }
+    }
     if (parentNode.type === "array" && Array.isArray(parentValue)) {
       const newIndex = parentValue.length;
       const { schema: subschema, keywordLocationToken } = getSubSchema(
@@ -2276,8 +2322,12 @@ var SchemaRuntime = class {
       }
       const defaultValue = initialValue !== void 0 ? initialValue : getDefaultValue(subschema);
       const itemPath = jsonPointerJoin(normalizedPath, String(newIndex));
-      return this.setValue(itemPath, defaultValue);
-    } else if (parentNode.type === "object" && parentValue && typeof parentValue === "object") {
+      const success = setJsonPointer(this.value, itemPath, defaultValue);
+      if (!success) return false;
+      this.reconcile(normalizedPath);
+      this.notify({ type: "value", path: normalizedPath });
+      return true;
+    } else if (parentNode.type === "object" && typeof parentValue === "object") {
       if (!key) {
         return false;
       }
@@ -2290,7 +2340,11 @@ var SchemaRuntime = class {
       }
       const defaultValue = initialValue !== void 0 ? initialValue : getDefaultValue(subschema);
       const propertyPath = jsonPointerJoin(normalizedPath, key);
-      return this.setValue(propertyPath, defaultValue);
+      const success = setJsonPointer(this.value, propertyPath, defaultValue);
+      if (!success) return false;
+      this.reconcile(normalizedPath);
+      this.notify({ type: "value", path: normalizedPath });
+      return true;
     }
     return false;
   }
@@ -2309,12 +2363,8 @@ var SchemaRuntime = class {
    */
   setValue(path, value) {
     const normalizedPath = normalizeRootPath(path);
-    if (normalizedPath === ROOT_PATH) {
-      this.value = value;
-    } else {
-      const success = setJsonPointer(this.value, normalizedPath, value);
-      if (!success) return false;
-    }
+    const success = this.setValueAtPath(normalizedPath, value);
+    if (!success) return false;
     this.reconcile(normalizedPath);
     this.notify({ type: "value", path: normalizedPath });
     return true;
@@ -2383,6 +2433,9 @@ var SchemaRuntime = class {
    * @param type - The schema type
    */
   applySchemaDefaults(instanceLocation, newSchema, type) {
+    if (this.options.autoFillDefaults === "never") {
+      return;
+    }
     const value = this.getValue(instanceLocation);
     if (type === "object" && newSchema.properties) {
       const obj = value && typeof value === "object" ? value : null;
@@ -2390,7 +2443,11 @@ var SchemaRuntime = class {
       for (const [key, subschema] of Object.entries(newSchema.properties)) {
         const hasValue = obj[key] !== void 0;
         if (!hasValue) {
-          const defaultValue = getDefaultValue(subschema);
+          const defaultValue = getDefaultValue(
+            subschema,
+            void 0,
+            this.options.autoFillDefaults
+          );
           if (defaultValue !== void 0) {
             const propertyPath = jsonPointerJoin(instanceLocation, key);
             setJsonPointer(this.value, propertyPath, defaultValue);
@@ -2404,7 +2461,12 @@ var SchemaRuntime = class {
       if (!arr) return;
       for (let i = 0; i < newSchema.prefixItems.length; i++) {
         if (arr[i] === void 0) {
-          const defaultValue = getDefaultValue(newSchema.prefixItems[i]);
+          const itemSchema = newSchema.prefixItems[i];
+          const defaultValue = getDefaultValue(
+            itemSchema,
+            void 0,
+            this.options.autoFillDefaults
+          );
           if (defaultValue !== void 0) {
             const itemPath = jsonPointerJoin(instanceLocation, String(i));
             setJsonPointer(this.value, itemPath, defaultValue);