@narrative.io/jsonforms-provider-protocols 3.0.0-beta.11 → 3.0.0-beta.13

package/dist/core/initFormData.d.ts

@@ -2,9 +2,16 @@
  * Initialize a form data object from a JSON Schema.
  * Resolves $ref, const, default, oneOf/discriminator, and typed empty values.
  *
+ * Optional fields (not listed in the parent schema's `required` array) that
+ * have no `const`, no single-value `enum`, and no `default` are omitted
+ * entirely from the result. This avoids seeding values (e.g. `null` for
+ * `type: "integer"`) that fail AJV's type check and surface spurious errors
+ * on untouched fields. Required fields retain legacy typed-empty seeding
+ * (`""`, `null`, `false`, `[]`) so that "is required" surfaces cleanly.
+ *
  * @param schema - The full JSON Schema (must include $defs if $refs are used)
  * @param seed   - Optional existing data to merge (seed values take priority)
- * @returns A data object with all schema-defined fields initialized
+ * @returns A data object with schema-defined fields initialized
  */
 export declare function initFormDataFromSchema(schema: Record<string, unknown>, seed?: Record<string, unknown>): Record<string, unknown>;
 //# sourceMappingURL=initFormData.d.ts.map

package/dist/core/initFormData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initFormData.d.ts","sourceRoot":"","sources":["../../src/core/initFormData.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB"}
+{"version":3,"file":"initFormData.d.ts","sourceRoot":"","sources":["../../src/core/initFormData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB"}

package/dist/core/initFormData.js

@@ -1,18 +1,19 @@
 function initFormDataFromSchema(schema, seed) {
-  const result = initProperty(schema, schema, seed);
-  if (result && typeof result === "object" && !Array.isArray(result) && seed && typeof seed === "object") {
+  const result = initProperty(schema, schema, seed, true);
+  const base = result && typeof result === "object" && !Array.isArray(result) ? result : {};
+  if (seed && typeof seed === "object") {
     const schemaKeys = new Set(
       Object.keys(
         resolveRef(schema, schema)?.properties ?? {}
       )
     );
     for (const key of Object.keys(seed)) {
-      if (!schemaKeys.has(key) && !(key in result)) {
-        result[key] = seed[key];
+      if (!schemaKeys.has(key) && !(key in base)) {
+        base[key] = seed[key];
       }
     }
   }
-  return result ?? {};
+  return base;
 }
 function resolveRef(property, root, seen) {
   if (!property || typeof property !== "object") return property;
@@ -38,12 +39,11 @@ function resolvePointer(obj, pointer) {
   }
   return current;
 }
-function initProperty(property, root, seed) {
-  if (!property || typeof property !== "object") return null;
-  const resolved = resolveRef(property, root);
-  if (Array.isArray(resolved.oneOf)) {
-    return initOneOf(resolved, root, seed);
+function initProperty(property, root, seed, required) {
+  if (!property || typeof property !== "object") {
+    return required ? null : void 0;
   }
+  const resolved = resolveRef(property, root);
   const type = resolved.type;
   if (seed !== void 0 && seed !== null && type !== "object") {
     return seed;
@@ -57,9 +57,22 @@ function initProperty(property, root, seed) {
   if ("default" in resolved) {
     return resolved.default;
   }
+  if (Array.isArray(resolved.oneOf)) {
+    if (!required) return void 0;
+    return initOneOf(resolved, root, seed);
+  }
+  if (type === "object") {
+    const obj = initObject(
+      resolved,
+      root,
+      seed,
+      required
+    );
+    if (!required && Object.keys(obj).length === 0) return void 0;
+    return obj;
+  }
+  if (!required) return void 0;
   switch (type) {
-    case "object":
-      return initObject(resolved, root, seed);
     case "array":
       return seed !== void 0 && seed !== null ? seed : [];
     case "string":
@@ -68,20 +81,26 @@ function initProperty(property, root, seed) {
       return false;
     case "number":
     case "integer":
-      return null;
     default:
       return null;
   }
 }
-function initObject(schema, root, seed) {
+function initObject(schema, root, seed, parentRequired) {
   const properties = schema.properties;
   if (!properties) {
     return seed && typeof seed === "object" ? { ...seed } : {};
   }
+  const requiredSet = new Set(
+    Array.isArray(schema.required) ? schema.required : []
+  );
   const result = {};
   for (const [key, propSchema] of Object.entries(properties)) {
     const seedValue = seed && typeof seed === "object" ? seed[key] : void 0;
-    result[key] = initProperty(propSchema, root, seedValue);
+    const effectiveRequired = parentRequired && requiredSet.has(key);
+    const value = initProperty(propSchema, root, seedValue, effectiveRequired);
+    if (value !== void 0) {
+      result[key] = value;
+    }
   }
   return result;
 }
@@ -91,7 +110,7 @@ function initOneOf(schema, root, seed) {
   const first = variants[0];
   if (!first) return null;
   const firstVariant = resolveRef(first, root);
-  return initProperty(firstVariant, root, seed);
+  return initProperty(firstVariant, root, seed, true);
 }
 export {
   initFormDataFromSchema

package/dist/core/initFormData.js.map

@@ -1 +1 @@
-{"version":3,"file":"initFormData.js","sources":["../../src/core/initFormData.ts"],"sourcesContent":["/**\n * Initialize a form data object from a JSON Schema.\n * Resolves $ref, const, default, oneOf/discriminator, and typed empty values.\n *\n * @param schema - The full JSON Schema (must include $defs if $refs are used)\n * @param seed   - Optional existing data to merge (seed values take priority)\n * @returns A data object with all schema-defined fields initialized\n */\nexport function initFormDataFromSchema(\n  schema: Record<string, unknown>,\n  seed?: Record<string, unknown>,\n): Record<string, unknown> {\n  const result = initProperty(schema, schema, seed) as Record<string, unknown>;\n\n  // If result is an object and seed has extra keys not in schema, preserve them\n  if (\n    result &&\n    typeof result === \"object\" &&\n    !Array.isArray(result) &&\n    seed &&\n    typeof seed === \"object\"\n  ) {\n    const schemaKeys = new Set(\n      Object.keys(\n        (resolveRef(schema, schema) as Record<string, unknown>)?.properties ??\n          {},\n      ),\n    );\n    for (const key of Object.keys(seed)) {\n      if (!schemaKeys.has(key) && !(key in result)) {\n        result[key] = seed[key];\n      }\n    }\n  }\n\n  return result ?? {};\n}\n\n/**\n * Resolve a $ref pointer against the root schema's $defs.\n * Supports nested $ref chains.\n */\nfunction resolveRef(\n  property: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seen?: Set<string>,\n): Record<string, unknown> {\n  if (!property || typeof property !== \"object\") return property;\n\n  const ref = property.$ref as string | undefined;\n  if (!ref) return property;\n\n  // Guard against circular refs\n  const visited = seen ?? new Set<string>();\n  if (visited.has(ref)) return property;\n  visited.add(ref);\n\n  const resolved = resolvePointer(root, ref);\n  if (!resolved) return property;\n\n  // Continue resolving if the result itself has a $ref\n  return resolveRef(resolved as Record<string, unknown>, root, visited);\n}\n\n/**\n * Resolve a JSON pointer like \"#/$defs/Price\" against an object.\n */\nfunction resolvePointer(\n  obj: Record<string, unknown>,\n  pointer: string,\n): unknown {\n  if (!pointer.startsWith(\"#/\")) return undefined;\n  const parts = pointer.slice(2).split(\"/\");\n  let current: unknown = obj;\n  for (const part of parts) {\n    if (current && typeof current === \"object\" && part in current) {\n      current = (current as Record<string, unknown>)[part];\n    } else {\n      return undefined;\n    }\n  }\n  return current;\n}\n\n/**\n * Initialize a single property value based on its schema definition.\n */\nfunction initProperty(\n  property: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed?: unknown,\n): unknown {\n  if (!property || typeof property !== \"object\") return null;\n\n  // Resolve $ref first\n  const resolved = resolveRef(property, root);\n\n  // Handle oneOf with discriminator — pick first variant\n  if (Array.isArray(resolved.oneOf)) {\n    return initOneOf(resolved, root, seed);\n  }\n\n  // Priority 1: seed wins (for object types, we merge recursively below)\n  // For non-object types, return seed directly if present\n  const type = resolved.type as string | undefined;\n  if (seed !== undefined && seed !== null && type !== \"object\") {\n    return seed;\n  }\n\n  // Priority 2: const\n  if (\"const\" in resolved) {\n    return resolved.const;\n  }\n\n  // Priority 3: single-value enum\n  if (\n    Array.isArray(resolved.enum) &&\n    (resolved.enum as unknown[]).length === 1\n  ) {\n    return (resolved.enum as unknown[])[0];\n  }\n\n  // Priority 4: default\n  if (\"default\" in resolved) {\n    return resolved.default;\n  }\n\n  // Priority 5: typed empty values\n  switch (type) {\n    case \"object\":\n      return initObject(resolved, root, seed as Record<string, unknown>);\n    case \"array\":\n      return seed !== undefined && seed !== null ? seed : [];\n    case \"string\":\n      return \"\";\n    case \"boolean\":\n      return false;\n    case \"number\":\n    case \"integer\":\n      return null;\n    default:\n      return null;\n  }\n}\n\n/**\n * Initialize an object type by recursing into its properties.\n */\nfunction initObject(\n  schema: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed?: Record<string, unknown>,\n): Record<string, unknown> {\n  const properties = schema.properties as\n    | Record<string, Record<string, unknown>>\n    | undefined;\n  if (!properties) {\n    // Object with no defined properties — return seed or empty object\n    return seed && typeof seed === \"object\" ? { ...seed } : {};\n  }\n\n  const result: Record<string, unknown> = {};\n\n  for (const [key, propSchema] of Object.entries(properties)) {\n    const seedValue = seed && typeof seed === \"object\" ? seed[key] : undefined;\n    result[key] = initProperty(propSchema, root, seedValue);\n  }\n\n  return result;\n}\n\n/**\n * Handle oneOf schemas — pick the first variant and initialize it.\n */\nfunction initOneOf(\n  schema: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed?: unknown,\n): unknown {\n  const variants = schema.oneOf as Record<string, unknown>[];\n  if (!variants || variants.length === 0) return null;\n\n  const first = variants[0];\n  if (!first) return null;\n\n  // Pick first variant, resolve its $ref if needed\n  const firstVariant = resolveRef(first, root);\n  return initProperty(firstVariant, root, seed);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"initFormData.js","sources":["../../src/core/initFormData.ts"],"sourcesContent":["/**\n * Initialize a form data object from a JSON Schema.\n * Resolves $ref, const, default, oneOf/discriminator, and typed empty values.\n *\n * Optional fields (not listed in the parent schema's `required` array) that\n * have no `const`, no single-value `enum`, and no `default` are omitted\n * entirely from the result. This avoids seeding values (e.g. `null` for\n * `type: \"integer\"`) that fail AJV's type check and surface spurious errors\n * on untouched fields. Required fields retain legacy typed-empty seeding\n * (`\"\"`, `null`, `false`, `[]`) so that \"is required\" surfaces cleanly.\n *\n * @param schema - The full JSON Schema (must include $defs if $refs are used)\n * @param seed   - Optional existing data to merge (seed values take priority)\n * @returns A data object with schema-defined fields initialized\n */\nexport function initFormDataFromSchema(\n  schema: Record<string, unknown>,\n  seed?: Record<string, unknown>,\n): Record<string, unknown> {\n  const result = initProperty(schema, schema, seed, true) as\n    | Record<string, unknown>\n    | undefined;\n\n  const base =\n    result && typeof result === \"object\" && !Array.isArray(result)\n      ? result\n      : {};\n\n  // Preserve seed keys not described by the schema's properties.\n  if (seed && typeof seed === \"object\") {\n    const schemaKeys = new Set(\n      Object.keys(\n        (resolveRef(schema, schema) as Record<string, unknown>)?.properties ??\n          {},\n      ),\n    );\n    for (const key of Object.keys(seed)) {\n      if (!schemaKeys.has(key) && !(key in base)) {\n        base[key] = seed[key];\n      }\n    }\n  }\n\n  return base;\n}\n\n/**\n * Resolve a $ref pointer against the root schema's $defs.\n * Supports nested $ref chains.\n */\nfunction resolveRef(\n  property: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seen?: Set<string>,\n): Record<string, unknown> {\n  if (!property || typeof property !== \"object\") return property;\n\n  const ref = property.$ref as string | undefined;\n  if (!ref) return property;\n\n  const visited = seen ?? new Set<string>();\n  if (visited.has(ref)) return property;\n  visited.add(ref);\n\n  const resolved = resolvePointer(root, ref);\n  if (!resolved) return property;\n\n  return resolveRef(resolved as Record<string, unknown>, root, visited);\n}\n\n/**\n * Resolve a JSON pointer like \"#/$defs/Price\" against an object.\n */\nfunction resolvePointer(\n  obj: Record<string, unknown>,\n  pointer: string,\n): unknown {\n  if (!pointer.startsWith(\"#/\")) return undefined;\n  const parts = pointer.slice(2).split(\"/\");\n  let current: unknown = obj;\n  for (const part of parts) {\n    if (current && typeof current === \"object\" && part in current) {\n      current = (current as Record<string, unknown>)[part];\n    } else {\n      return undefined;\n    }\n  }\n  return current;\n}\n\n/**\n * Initialize a single property value based on its schema definition.\n * Returns `undefined` when the property is optional and has nothing\n * concrete to seed — the caller then omits the key from its result.\n */\nfunction initProperty(\n  property: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed: unknown,\n  required: boolean,\n): unknown {\n  if (!property || typeof property !== \"object\") {\n    return required ? null : undefined;\n  }\n\n  const resolved = resolveRef(property, root);\n  const type = resolved.type as string | undefined;\n\n  // Priority 1: seed wins for non-object types.\n  if (seed !== undefined && seed !== null && type !== \"object\") {\n    return seed;\n  }\n\n  // Priority 2: const (schema-invariant — always set).\n  if (\"const\" in resolved) {\n    return resolved.const;\n  }\n\n  // Priority 3: single-value enum (same reasoning — only one valid value).\n  if (\n    Array.isArray(resolved.enum) &&\n    (resolved.enum as unknown[]).length === 1\n  ) {\n    return (resolved.enum as unknown[])[0];\n  }\n\n  // Priority 4: default (explicit author intent — always honored).\n  if (\"default\" in resolved) {\n    return resolved.default;\n  }\n\n  // Priority 5: oneOf. For required fields, materialize the first variant\n  // so the discriminator and shape are present. For optional fields, leave\n  // undefined so the user isn't forced into a variant they haven't chosen.\n  if (Array.isArray(resolved.oneOf)) {\n    if (!required) return undefined;\n    return initOneOf(resolved, root, seed);\n  }\n\n  // Priority 6: objects recurse. The `required` flag propagates downward:\n  // inside an optional ancestor, nested required primitives also collapse,\n  // so an optional object with nested required fields stays absent instead\n  // of materializing a shell that AJV would flag.\n  if (type === \"object\") {\n    const obj = initObject(\n      resolved,\n      root,\n      seed as Record<string, unknown>,\n      required,\n    );\n    if (!required && Object.keys(obj).length === 0) return undefined;\n    return obj;\n  }\n\n  // Priority 7: optional primitives — omit.\n  if (!required) return undefined;\n\n  // Priority 8: required primitives — legacy typed empty.\n  switch (type) {\n    case \"array\":\n      return seed !== undefined && seed !== null ? seed : [];\n    case \"string\":\n      return \"\";\n    case \"boolean\":\n      return false;\n    case \"number\":\n    case \"integer\":\n    default:\n      return null;\n  }\n}\n\n/**\n * Initialize an object type by recursing into its properties.\n * Keys whose initialization returns `undefined` are omitted.\n *\n * `parentRequired` controls how schema.required propagates: a child is\n * treated as required only if both its parent is required AND it appears in\n * the parent's required array. Inside an optional ancestor the whole\n * subtree collapses (except for author-forced values: const, default,\n * single-value enum, or seeded values).\n */\nfunction initObject(\n  schema: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed: Record<string, unknown> | undefined,\n  parentRequired: boolean,\n): Record<string, unknown> {\n  const properties = schema.properties as\n    | Record<string, Record<string, unknown>>\n    | undefined;\n  if (!properties) {\n    return seed && typeof seed === \"object\" ? { ...seed } : {};\n  }\n\n  const requiredSet = new Set<string>(\n    Array.isArray(schema.required) ? (schema.required as string[]) : [],\n  );\n\n  const result: Record<string, unknown> = {};\n\n  for (const [key, propSchema] of Object.entries(properties)) {\n    const seedValue = seed && typeof seed === \"object\" ? seed[key] : undefined;\n    const effectiveRequired = parentRequired && requiredSet.has(key);\n    const value = initProperty(propSchema, root, seedValue, effectiveRequired);\n    if (value !== undefined) {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Handle oneOf schemas — pick the first variant and initialize it.\n * The variant is treated as required so its own required discriminator\n * and structure seed cleanly.\n */\nfunction initOneOf(\n  schema: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed?: unknown,\n): unknown {\n  const variants = schema.oneOf as Record<string, unknown>[];\n  if (!variants || variants.length === 0) return null;\n\n  const first = variants[0];\n  if (!first) return null;\n\n  const firstVariant = resolveRef(first, root);\n  return initProperty(firstVariant, root, seed, true);\n}\n"],"names":[],"mappings":"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"}

package/dist/vue/composables/useProjection.d.ts

@@ -4,6 +4,7 @@ interface ProjectionControl {
     path: string;
     errors: string;
     label?: string;
+    required?: boolean;
     schema: Record<string, any>;
     uischema: {
         options?: {

package/dist/vue/composables/useProjection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useProjection.d.ts","sourceRoot":"","sources":["../../../src/vue/composables/useProjection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAOnE,UAAU,iBAAiB;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;CACzE;AAyDD,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,aAAa,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,gEAAgE;IAEhE,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAClD,8DAA8D;IAC9D,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9D,mCAAmC;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,sFAAsF;IACtF,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,qEAAqE;IACrE,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAC/B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GACnD,gBAAgB,CA+ElB"}
+{"version":3,"file":"useProjection.d.ts","sourceRoot":"","sources":["../../../src/vue/composables/useProjection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAQnE,UAAU,iBAAiB;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;CACzE;AA8FD,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,aAAa,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,gEAAgE;IAEhE,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAClD,8DAA8D;IAC9D,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9D,mCAAmC;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,sFAAsF;IACtF,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,qEAAqE;IACrE,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAC/B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GACnD,gBAAgB,CAyFlB"}

package/dist/vue/composables/useProjection.js

@@ -1,7 +1,26 @@
 import { computed, inject } from "vue";
-import { getProjectedValue, getProjectedSchema, setProjectedValue } from "../../core/projection.js";
-function resolveLabel(ctrl, schemaTitle) {
-  return ctrl.uischema?.options?.label ?? schemaTitle ?? ctrl.label ?? "";
+import { getProjectedValue, getProjectedSchema, parseProjectionPath, setProjectedValue } from "../../core/projection.js";
+function resolveLabel(ctrl, schemaTitle, required) {
+  const base = ctrl.uischema?.options?.label ?? schemaTitle ?? ctrl.label ?? "";
+  if (!base) return base;
+  return required ? `${base} *` : base;
+}
+function isProjectedFieldRequired(schema, path) {
+  const segments = parseProjectionPath(path);
+  if (segments.length === 0) return false;
+  let current = schema;
+  for (let i = 0; i < segments.length - 1; i++) {
+    const seg = segments[i];
+    if (typeof seg === "number") {
+      current = current?.items;
+    } else {
+      current = current?.properties?.[seg];
+    }
+    if (!current) return false;
+  }
+  const last = segments[segments.length - 1];
+  if (typeof last !== "string") return false;
+  return Array.isArray(current?.required) && current.required.includes(last);
 }
 function normalizeErrors(errors) {
   if (!errors) return errors;
@@ -21,7 +40,9 @@ function getErrorPath(error) {
 function useProjection(control, handleChange) {
   const projection = control.value.uischema?.options?.projection;
   if (!projection) {
-    const label2 = computed(() => resolveLabel(control.value));
+    const label2 = computed(
+      () => resolveLabel(control.value, void 0, control.value.required)
+    );
     return {
       projectedData: computed(() => control.value.data),
       projectedSchema: computed(() => control.value.schema),
@@ -47,8 +68,15 @@ function useProjection(control, handleChange) {
   const projectedSchema = computed(
     () => getProjectedSchema(control.value.schema, projection)
   );
+  const projectedRequired = computed(
+    () => isProjectedFieldRequired(control.value.schema, projection)
+  );
   const label = computed(
-    () => resolveLabel(control.value, projectedSchema.value?.title)
+    () => resolveLabel(
+      control.value,
+      projectedSchema.value?.title,
+      projectedRequired.value
+    )
   );
   const projectedErrors = computed(() => {
     const baseErrors = normalizeErrors(control.value.errors || "");

package/dist/vue/composables/useProjection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useProjection.js","sources":["../../../src/vue/composables/useProjection.ts"],"sourcesContent":["import { computed, inject, type ComputedRef, type Ref } from \"vue\";\nimport {\n  getProjectedValue,\n  setProjectedValue,\n  getProjectedSchema,\n} from \"../../core/projection\";\n\ninterface ProjectionControl {\n  data: unknown;\n  path: string;\n  errors: string;\n  label?: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schema: Record<string, any>;\n  uischema: { options?: { projection?: string; [key: string]: unknown } };\n}\n\n// Minimal AJV ErrorObject shape for filtering\ninterface ErrorLike {\n  instancePath?: string;\n  keyword?: string;\n  message?: string;\n  params?: { missingProperty?: string };\n}\n\n/**\n * Resolve the display label for a control.\n * Priority: uischema options.label → schemaTitle (projected sub-schema) → control.label.\n */\nfunction resolveLabel(ctrl: ProjectionControl, schemaTitle?: string): string {\n  return (\n    (ctrl.uischema?.options?.label as string) ?? schemaTitle ?? ctrl.label ?? \"\"\n  );\n}\n\n/**\n * Normalize AJV error message fragments into user-friendly text.\n * e.g. \"is a required property\" → \"is required\"\n */\nfunction normalizeErrors(errors: string): string {\n  if (!errors) return errors;\n  return errors\n    .replace(/is a required property/g, \"is required\")\n    .replace(/must have required property '[^']*'/g, \"is required\");\n}\n\n/**\n * Prefix each error message line with the field label so that AJV fragments\n * like \"is required\" become \"Name is required\".\n */\nfunction prefixErrors(label: string, errors: string): string {\n  if (!label || !errors) return errors;\n  return errors\n    .split(\"\\n\")\n    .map((line) => `${label} ${line}`)\n    .join(\"\\n\");\n}\n\n/**\n * Convert an AJV ErrorObject's instancePath to a dot-separated control path.\n * Replicates the logic from @jsonforms/core getControlPath.\n */\nfunction getErrorPath(error: ErrorLike): string {\n  let p = (error.instancePath || \"\").replace(/\\//g, \".\").replace(/^\\./, \"\");\n  if (error.keyword === \"required\" && error.params?.missingProperty) {\n    p = p\n      ? p + \".\" + error.params.missingProperty\n      : error.params.missingProperty;\n  }\n  return p;\n}\n\nexport interface ProjectionResult {\n  /** The value at the projected path (for rendering) */\n  projectedData: ComputedRef<unknown>;\n  /** The schema at the projected path (for renderer selection) */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  projectedSchema: ComputedRef<Record<string, any>>;\n  /** Wrapped handleChange that writes through the projection */\n  handleProjectedChange: (path: string, value: unknown) => void;\n  /** Whether projection is active */\n  hasProjection: boolean;\n  /** Resolved display label (options.label → projected schema title → control.label) */\n  projectedLabel: ComputedRef<string>;\n  /** Error string combining base-path and projected sub-path errors */\n  projectedErrors: ComputedRef<string>;\n}\n\n/**\n * Composable that wraps a JSON Forms control with projection support.\n *\n * When `options.projection` is set on the uischema, this composable:\n * - Reads the projected sub-value from the control data\n * - Resolves the projected sub-schema for renderer type resolution\n * - Wraps handleChange to write back through the projection path (preserving siblings)\n *\n * When no projection is set, it passes through control data/schema/handleChange unchanged.\n */\nexport function useProjection(\n  control: Ref<ProjectionControl>,\n  handleChange: (path: string, value: unknown) => void,\n): ProjectionResult {\n  const projection = control.value.uischema?.options?.projection as\n    | string\n    | undefined;\n\n  if (!projection) {\n    const label = computed(() => resolveLabel(control.value));\n    return {\n      projectedData: computed(() => control.value.data),\n      projectedSchema: computed(() => control.value.schema),\n      handleProjectedChange: handleChange,\n      hasProjection: false,\n      projectedLabel: label,\n      projectedErrors: computed(() =>\n        prefixErrors(\n          label.value.replace(/\\*$/, \"\").trim(),\n          normalizeErrors(control.value.errors),\n        ),\n      ),\n    };\n  }\n\n  // Inject JSONForms state to access raw AJV errors for projected sub-paths.\n  // control.errors only contains errors at the exact control path (e.g. \"data_rates\"),\n  // but projected fields need errors at the full path (e.g. \"data_rates.0.video_rate_usd\").\n  const jsonforms = inject<{ core?: { errors?: ErrorLike[] } } | null>(\n    \"jsonforms\",\n    null,\n  );\n\n  const fullProjectedPath = control.value.path + \".\" + projection;\n\n  const projectedData = computed(() =>\n    getProjectedValue(control.value.data, projection),\n  );\n\n  const projectedSchema = computed(() =>\n    getProjectedSchema(control.value.schema, projection),\n  );\n\n  const label = computed(() =>\n    resolveLabel(control.value, projectedSchema.value?.title),\n  );\n\n  const projectedErrors = computed(() => {\n    const baseErrors = normalizeErrors(control.value.errors || \"\");\n\n    const rawErrors = jsonforms?.core?.errors ?? [];\n    const matching = rawErrors.filter(\n      (err) => getErrorPath(err) === fullProjectedPath,\n    );\n\n    let errStr: string;\n    if (matching.length === 0) {\n      errStr = baseErrors;\n    } else {\n      const projMsg = matching\n        .map((e) => (e.keyword === \"required\" ? \"is required\" : e.message))\n        .filter(Boolean)\n        .join(\"\\n\");\n      errStr = [baseErrors, projMsg].filter(Boolean).join(\"\\n\");\n    }\n\n    return prefixErrors(label.value.replace(/\\*$/, \"\").trim(), errStr);\n  });\n\n  const handleProjectedChange = (path: string, value: unknown) => {\n    const fullValue = setProjectedValue(control.value.data, projection, value);\n    handleChange(path, fullValue);\n  };\n\n  return {\n    projectedData,\n    projectedSchema,\n    handleProjectedChange,\n    hasProjection: true,\n    projectedLabel: label,\n    projectedErrors,\n  };\n}\n"],"names":["label"],"mappings":";;AA6BA,SAAS,aAAa,MAAyB,aAA8B;AAC3E,SACG,KAAK,UAAU,SAAS,SAAoB,eAAe,KAAK,SAAS;AAE9E;AAMA,SAAS,gBAAgB,QAAwB;AAC/C,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,OACJ,QAAQ,2BAA2B,aAAa,EAChD,QAAQ,wCAAwC,aAAa;AAClE;AAMA,SAAS,aAAa,OAAe,QAAwB;AAC3D,MAAI,CAAC,SAAS,CAAC,OAAQ,QAAO;AAC9B,SAAO,OACJ,MAAM,IAAI,EACV,IAAI,CAAC,SAAS,GAAG,KAAK,IAAI,IAAI,EAAE,EAChC,KAAK,IAAI;AACd;AAMA,SAAS,aAAa,OAA0B;AAC9C,MAAI,KAAK,MAAM,gBAAgB,IAAI,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,EAAE;AACxE,MAAI,MAAM,YAAY,cAAc,MAAM,QAAQ,iBAAiB;AACjE,QAAI,IACA,IAAI,MAAM,MAAM,OAAO,kBACvB,MAAM,OAAO;AAAA,EACnB;AACA,SAAO;AACT;AA4BO,SAAS,cACd,SACA,cACkB;AAClB,QAAM,aAAa,QAAQ,MAAM,UAAU,SAAS;AAIpD,MAAI,CAAC,YAAY;AACf,UAAMA,SAAQ,SAAS,MAAM,aAAa,QAAQ,KAAK,CAAC;AACxD,WAAO;AAAA,MACL,eAAe,SAAS,MAAM,QAAQ,MAAM,IAAI;AAAA,MAChD,iBAAiB,SAAS,MAAM,QAAQ,MAAM,MAAM;AAAA,MACpD,uBAAuB;AAAA,MACvB,eAAe;AAAA,MACf,gBAAgBA;AAAAA,MAChB,iBAAiB;AAAA,QAAS,MACxB;AAAA,UACEA,OAAM,MAAM,QAAQ,OAAO,EAAE,EAAE,KAAA;AAAA,UAC/B,gBAAgB,QAAQ,MAAM,MAAM;AAAA,QAAA;AAAA,MACtC;AAAA,IACF;AAAA,EAEJ;AAKA,QAAM,YAAY;AAAA,IAChB;AAAA,IACA;AAAA,EAAA;AAGF,QAAM,oBAAoB,QAAQ,MAAM,OAAO,MAAM;AAErD,QAAM,gBAAgB;AAAA,IAAS,MAC7B,kBAAkB,QAAQ,MAAM,MAAM,UAAU;AAAA,EAAA;AAGlD,QAAM,kBAAkB;AAAA,IAAS,MAC/B,mBAAmB,QAAQ,MAAM,QAAQ,UAAU;AAAA,EAAA;AAGrD,QAAM,QAAQ;AAAA,IAAS,MACrB,aAAa,QAAQ,OAAO,gBAAgB,OAAO,KAAK;AAAA,EAAA;AAG1D,QAAM,kBAAkB,SAAS,MAAM;AACrC,UAAM,aAAa,gBAAgB,QAAQ,MAAM,UAAU,EAAE;AAE7D,UAAM,YAAY,WAAW,MAAM,UAAU,CAAA;AAC7C,UAAM,WAAW,UAAU;AAAA,MACzB,CAAC,QAAQ,aAAa,GAAG,MAAM;AAAA,IAAA;AAGjC,QAAI;AACJ,QAAI,SAAS,WAAW,GAAG;AACzB,eAAS;AAAA,IACX,OAAO;AACL,YAAM,UAAU,SACb,IAAI,CAAC,MAAO,EAAE,YAAY,aAAa,gBAAgB,EAAE,OAAQ,EACjE,OAAO,OAAO,EACd,KAAK,IAAI;AACZ,eAAS,CAAC,YAAY,OAAO,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI;AAAA,IAC1D;AAEA,WAAO,aAAa,MAAM,MAAM,QAAQ,OAAO,EAAE,EAAE,KAAA,GAAQ,MAAM;AAAA,EACnE,CAAC;AAED,QAAM,wBAAwB,CAAC,MAAc,UAAmB;AAC9D,UAAM,YAAY,kBAAkB,QAAQ,MAAM,MAAM,YAAY,KAAK;AACzE,iBAAa,MAAM,SAAS;AAAA,EAC9B;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,eAAe;AAAA,IACf,gBAAgB;AAAA,IAChB;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useProjection.js","sources":["../../../src/vue/composables/useProjection.ts"],"sourcesContent":["import { computed, inject, type ComputedRef, type Ref } from \"vue\";\nimport {\n  getProjectedValue,\n  setProjectedValue,\n  getProjectedSchema,\n  parseProjectionPath,\n} from \"../../core/projection\";\n\ninterface ProjectionControl {\n  data: unknown;\n  path: string;\n  errors: string;\n  label?: string;\n  required?: boolean;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schema: Record<string, any>;\n  uischema: { options?: { projection?: string; [key: string]: unknown } };\n}\n\n// Minimal AJV ErrorObject shape for filtering\ninterface ErrorLike {\n  instancePath?: string;\n  keyword?: string;\n  message?: string;\n  params?: { missingProperty?: string };\n}\n\n/**\n * Resolve the display label for a control.\n * Priority: uischema options.label → schemaTitle (projected sub-schema) → control.label.\n * Appends a trailing asterisk when the control is for a required property.\n */\nfunction resolveLabel(\n  ctrl: ProjectionControl,\n  schemaTitle?: string,\n  required?: boolean,\n): string {\n  const base =\n    (ctrl.uischema?.options?.label as string) ??\n    schemaTitle ??\n    ctrl.label ??\n    \"\";\n  if (!base) return base;\n  return required ? `${base} *` : base;\n}\n\n/**\n * Determine whether the leaf of a projection path is listed in its parent\n * schema's `required` array. Numeric leaf segments (array indices) are not\n * considered \"required properties\".\n */\nfunction isProjectedFieldRequired(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schema: Record<string, any>,\n  path: string,\n): boolean {\n  const segments = parseProjectionPath(path);\n  if (segments.length === 0) return false;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let current: Record<string, any> = schema;\n  for (let i = 0; i < segments.length - 1; i++) {\n    const seg = segments[i]!;\n    if (typeof seg === \"number\") {\n      current = current?.items;\n    } else {\n      current = current?.properties?.[seg];\n    }\n    if (!current) return false;\n  }\n  const last = segments[segments.length - 1];\n  if (typeof last !== \"string\") return false;\n  return Array.isArray(current?.required) && current.required.includes(last);\n}\n\n/**\n * Normalize AJV error message fragments into user-friendly text.\n * e.g. \"is a required property\" → \"is required\"\n */\nfunction normalizeErrors(errors: string): string {\n  if (!errors) return errors;\n  return errors\n    .replace(/is a required property/g, \"is required\")\n    .replace(/must have required property '[^']*'/g, \"is required\");\n}\n\n/**\n * Prefix each error message line with the field label so that AJV fragments\n * like \"is required\" become \"Name is required\".\n */\nfunction prefixErrors(label: string, errors: string): string {\n  if (!label || !errors) return errors;\n  return errors\n    .split(\"\\n\")\n    .map((line) => `${label} ${line}`)\n    .join(\"\\n\");\n}\n\n/**\n * Convert an AJV ErrorObject's instancePath to a dot-separated control path.\n * Replicates the logic from @jsonforms/core getControlPath.\n */\nfunction getErrorPath(error: ErrorLike): string {\n  let p = (error.instancePath || \"\").replace(/\\//g, \".\").replace(/^\\./, \"\");\n  if (error.keyword === \"required\" && error.params?.missingProperty) {\n    p = p\n      ? p + \".\" + error.params.missingProperty\n      : error.params.missingProperty;\n  }\n  return p;\n}\n\nexport interface ProjectionResult {\n  /** The value at the projected path (for rendering) */\n  projectedData: ComputedRef<unknown>;\n  /** The schema at the projected path (for renderer selection) */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  projectedSchema: ComputedRef<Record<string, any>>;\n  /** Wrapped handleChange that writes through the projection */\n  handleProjectedChange: (path: string, value: unknown) => void;\n  /** Whether projection is active */\n  hasProjection: boolean;\n  /** Resolved display label (options.label → projected schema title → control.label) */\n  projectedLabel: ComputedRef<string>;\n  /** Error string combining base-path and projected sub-path errors */\n  projectedErrors: ComputedRef<string>;\n}\n\n/**\n * Composable that wraps a JSON Forms control with projection support.\n *\n * When `options.projection` is set on the uischema, this composable:\n * - Reads the projected sub-value from the control data\n * - Resolves the projected sub-schema for renderer type resolution\n * - Wraps handleChange to write back through the projection path (preserving siblings)\n *\n * When no projection is set, it passes through control data/schema/handleChange unchanged.\n */\nexport function useProjection(\n  control: Ref<ProjectionControl>,\n  handleChange: (path: string, value: unknown) => void,\n): ProjectionResult {\n  const projection = control.value.uischema?.options?.projection as\n    | string\n    | undefined;\n\n  if (!projection) {\n    const label = computed(() =>\n      resolveLabel(control.value, undefined, control.value.required),\n    );\n    return {\n      projectedData: computed(() => control.value.data),\n      projectedSchema: computed(() => control.value.schema),\n      handleProjectedChange: handleChange,\n      hasProjection: false,\n      projectedLabel: label,\n      projectedErrors: computed(() =>\n        prefixErrors(\n          label.value.replace(/\\*$/, \"\").trim(),\n          normalizeErrors(control.value.errors),\n        ),\n      ),\n    };\n  }\n\n  // Inject JSONForms state to access raw AJV errors for projected sub-paths.\n  // control.errors only contains errors at the exact control path (e.g. \"data_rates\"),\n  // but projected fields need errors at the full path (e.g. \"data_rates.0.video_rate_usd\").\n  const jsonforms = inject<{ core?: { errors?: ErrorLike[] } } | null>(\n    \"jsonforms\",\n    null,\n  );\n\n  const fullProjectedPath = control.value.path + \".\" + projection;\n\n  const projectedData = computed(() =>\n    getProjectedValue(control.value.data, projection),\n  );\n\n  const projectedSchema = computed(() =>\n    getProjectedSchema(control.value.schema, projection),\n  );\n\n  const projectedRequired = computed(() =>\n    isProjectedFieldRequired(control.value.schema, projection),\n  );\n\n  const label = computed(() =>\n    resolveLabel(\n      control.value,\n      projectedSchema.value?.title,\n      projectedRequired.value,\n    ),\n  );\n\n  const projectedErrors = computed(() => {\n    const baseErrors = normalizeErrors(control.value.errors || \"\");\n\n    const rawErrors = jsonforms?.core?.errors ?? [];\n    const matching = rawErrors.filter(\n      (err) => getErrorPath(err) === fullProjectedPath,\n    );\n\n    let errStr: string;\n    if (matching.length === 0) {\n      errStr = baseErrors;\n    } else {\n      const projMsg = matching\n        .map((e) => (e.keyword === \"required\" ? \"is required\" : e.message))\n        .filter(Boolean)\n        .join(\"\\n\");\n      errStr = [baseErrors, projMsg].filter(Boolean).join(\"\\n\");\n    }\n\n    return prefixErrors(label.value.replace(/\\*$/, \"\").trim(), errStr);\n  });\n\n  const handleProjectedChange = (path: string, value: unknown) => {\n    const fullValue = setProjectedValue(control.value.data, projection, value);\n    handleChange(path, fullValue);\n  };\n\n  return {\n    projectedData,\n    projectedSchema,\n    handleProjectedChange,\n    hasProjection: true,\n    projectedLabel: label,\n    projectedErrors,\n  };\n}\n"],"names":["label"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narrative.io/jsonforms-provider-protocols",
-	"version": "3.0.0-beta.11",
+	"version": "3.0.0-beta.13",
 	"description": "Dynamic data provider capabilities for JSONForms with Vue 3 integration",
 	"type": "module",
 	"author": "Narrative I/O",

package/src/core/initFormData.ts

@@ -2,24 +2,32 @@
  * Initialize a form data object from a JSON Schema.
  * Resolves $ref, const, default, oneOf/discriminator, and typed empty values.
  *
+ * Optional fields (not listed in the parent schema's `required` array) that
+ * have no `const`, no single-value `enum`, and no `default` are omitted
+ * entirely from the result. This avoids seeding values (e.g. `null` for
+ * `type: "integer"`) that fail AJV's type check and surface spurious errors
+ * on untouched fields. Required fields retain legacy typed-empty seeding
+ * (`""`, `null`, `false`, `[]`) so that "is required" surfaces cleanly.
+ *
  * @param schema - The full JSON Schema (must include $defs if $refs are used)
  * @param seed   - Optional existing data to merge (seed values take priority)
- * @returns A data object with all schema-defined fields initialized
+ * @returns A data object with schema-defined fields initialized
  */
 export function initFormDataFromSchema(
   schema: Record<string, unknown>,
   seed?: Record<string, unknown>,
 ): Record<string, unknown> {
-  const result = initProperty(schema, schema, seed) as Record<string, unknown>;
+  const result = initProperty(schema, schema, seed, true) as
+    | Record<string, unknown>
+    | undefined;
 
-  // If result is an object and seed has extra keys not in schema, preserve them
-  if (
-    result &&
-    typeof result === "object" &&
-    !Array.isArray(result) &&
-    seed &&
-    typeof seed === "object"
-  ) {
+  const base =
+    result && typeof result === "object" && !Array.isArray(result)
+      ? result
+      : {};
+
+  // Preserve seed keys not described by the schema's properties.
+  if (seed && typeof seed === "object") {
     const schemaKeys = new Set(
       Object.keys(
         (resolveRef(schema, schema) as Record<string, unknown>)?.properties ??
@@ -27,13 +35,13 @@ export function initFormDataFromSchema(
       ),
     );
     for (const key of Object.keys(seed)) {
-      if (!schemaKeys.has(key) && !(key in result)) {
-        result[key] = seed[key];
+      if (!schemaKeys.has(key) && !(key in base)) {
+        base[key] = seed[key];
       }
     }
   }
 
-  return result ?? {};
+  return base;
 }
 
 /**
@@ -50,7 +58,6 @@ function resolveRef(
   const ref = property.$ref as string | undefined;
   if (!ref) return property;
 
-  // Guard against circular refs
   const visited = seen ?? new Set<string>();
   if (visited.has(ref)) return property;
   visited.add(ref);
@@ -58,7 +65,6 @@ function resolveRef(
   const resolved = resolvePointer(root, ref);
   if (!resolved) return property;
 
-  // Continue resolving if the result itself has a $ref
   return resolveRef(resolved as Record<string, unknown>, root, visited);
 }
 
@@ -84,35 +90,33 @@ function resolvePointer(
 
 /**
  * Initialize a single property value based on its schema definition.
+ * Returns `undefined` when the property is optional and has nothing
+ * concrete to seed — the caller then omits the key from its result.
  */
 function initProperty(
   property: Record<string, unknown>,
   root: Record<string, unknown>,
-  seed?: unknown,
+  seed: unknown,
+  required: boolean,
 ): unknown {
-  if (!property || typeof property !== "object") return null;
-
-  // Resolve $ref first
-  const resolved = resolveRef(property, root);
-
-  // Handle oneOf with discriminator — pick first variant
-  if (Array.isArray(resolved.oneOf)) {
-    return initOneOf(resolved, root, seed);
+  if (!property || typeof property !== "object") {
+    return required ? null : undefined;
   }
 
-  // Priority 1: seed wins (for object types, we merge recursively below)
-  // For non-object types, return seed directly if present
+  const resolved = resolveRef(property, root);
   const type = resolved.type as string | undefined;
+
+  // Priority 1: seed wins for non-object types.
   if (seed !== undefined && seed !== null && type !== "object") {
     return seed;
   }
 
-  // Priority 2: const
+  // Priority 2: const (schema-invariant — always set).
   if ("const" in resolved) {
     return resolved.const;
   }
 
-  // Priority 3: single-value enum
+  // Priority 3: single-value enum (same reasoning — only one valid value).
   if (
     Array.isArray(resolved.enum) &&
     (resolved.enum as unknown[]).length === 1
@@ -120,15 +124,39 @@ function initProperty(
     return (resolved.enum as unknown[])[0];
   }
 
-  // Priority 4: default
+  // Priority 4: default (explicit author intent — always honored).
   if ("default" in resolved) {
     return resolved.default;
   }
 
-  // Priority 5: typed empty values
+  // Priority 5: oneOf. For required fields, materialize the first variant
+  // so the discriminator and shape are present. For optional fields, leave
+  // undefined so the user isn't forced into a variant they haven't chosen.
+  if (Array.isArray(resolved.oneOf)) {
+    if (!required) return undefined;
+    return initOneOf(resolved, root, seed);
+  }
+
+  // Priority 6: objects recurse. The `required` flag propagates downward:
+  // inside an optional ancestor, nested required primitives also collapse,
+  // so an optional object with nested required fields stays absent instead
+  // of materializing a shell that AJV would flag.
+  if (type === "object") {
+    const obj = initObject(
+      resolved,
+      root,
+      seed as Record<string, unknown>,
+      required,
+    );
+    if (!required && Object.keys(obj).length === 0) return undefined;
+    return obj;
+  }
+
+  // Priority 7: optional primitives — omit.
+  if (!required) return undefined;
+
+  // Priority 8: required primitives — legacy typed empty.
   switch (type) {
-    case "object":
-      return initObject(resolved, root, seed as Record<string, unknown>);
     case "array":
       return seed !== undefined && seed !== null ? seed : [];
     case "string":
@@ -137,7 +165,6 @@ function initProperty(
       return false;
     case "number":
     case "integer":
-      return null;
     default:
       return null;
   }
@@ -145,25 +172,40 @@ function initProperty(
 
 /**
  * Initialize an object type by recursing into its properties.
+ * Keys whose initialization returns `undefined` are omitted.
+ *
+ * `parentRequired` controls how schema.required propagates: a child is
+ * treated as required only if both its parent is required AND it appears in
+ * the parent's required array. Inside an optional ancestor the whole
+ * subtree collapses (except for author-forced values: const, default,
+ * single-value enum, or seeded values).
  */
 function initObject(
   schema: Record<string, unknown>,
   root: Record<string, unknown>,
-  seed?: Record<string, unknown>,
+  seed: Record<string, unknown> | undefined,
+  parentRequired: boolean,
 ): Record<string, unknown> {
   const properties = schema.properties as
     | Record<string, Record<string, unknown>>
     | undefined;
   if (!properties) {
-    // Object with no defined properties — return seed or empty object
     return seed && typeof seed === "object" ? { ...seed } : {};
   }
 
+  const requiredSet = new Set<string>(
+    Array.isArray(schema.required) ? (schema.required as string[]) : [],
+  );
+
   const result: Record<string, unknown> = {};
 
   for (const [key, propSchema] of Object.entries(properties)) {
     const seedValue = seed && typeof seed === "object" ? seed[key] : undefined;
-    result[key] = initProperty(propSchema, root, seedValue);
+    const effectiveRequired = parentRequired && requiredSet.has(key);
+    const value = initProperty(propSchema, root, seedValue, effectiveRequired);
+    if (value !== undefined) {
+      result[key] = value;
+    }
   }
 
   return result;
@@ -171,6 +213,8 @@ function initObject(
 
 /**
  * Handle oneOf schemas — pick the first variant and initialize it.
+ * The variant is treated as required so its own required discriminator
+ * and structure seed cleanly.
  */
 function initOneOf(
   schema: Record<string, unknown>,
@@ -183,7 +227,6 @@ function initOneOf(
   const first = variants[0];
   if (!first) return null;
 
-  // Pick first variant, resolve its $ref if needed
   const firstVariant = resolveRef(first, root);
-  return initProperty(firstVariant, root, seed);
+  return initProperty(firstVariant, root, seed, true);
 }

package/src/vue/composables/useProjection.ts

@@ -3,6 +3,7 @@ import {
   getProjectedValue,
   setProjectedValue,
   getProjectedSchema,
+  parseProjectionPath,
 } from "../../core/projection";
 
 interface ProjectionControl {
@@ -10,6 +11,7 @@ interface ProjectionControl {
   path: string;
   errors: string;
   label?: string;
+  required?: boolean;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   schema: Record<string, any>;
   uischema: { options?: { projection?: string; [key: string]: unknown } };
@@ -26,11 +28,48 @@ interface ErrorLike {
 /**
  * Resolve the display label for a control.
  * Priority: uischema options.label → schemaTitle (projected sub-schema) → control.label.
+ * Appends a trailing asterisk when the control is for a required property.
  */
-function resolveLabel(ctrl: ProjectionControl, schemaTitle?: string): string {
-  return (
-    (ctrl.uischema?.options?.label as string) ?? schemaTitle ?? ctrl.label ?? ""
-  );
+function resolveLabel(
+  ctrl: ProjectionControl,
+  schemaTitle?: string,
+  required?: boolean,
+): string {
+  const base =
+    (ctrl.uischema?.options?.label as string) ??
+    schemaTitle ??
+    ctrl.label ??
+    "";
+  if (!base) return base;
+  return required ? `${base} *` : base;
+}
+
+/**
+ * Determine whether the leaf of a projection path is listed in its parent
+ * schema's `required` array. Numeric leaf segments (array indices) are not
+ * considered "required properties".
+ */
+function isProjectedFieldRequired(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  schema: Record<string, any>,
+  path: string,
+): boolean {
+  const segments = parseProjectionPath(path);
+  if (segments.length === 0) return false;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  let current: Record<string, any> = schema;
+  for (let i = 0; i < segments.length - 1; i++) {
+    const seg = segments[i]!;
+    if (typeof seg === "number") {
+      current = current?.items;
+    } else {
+      current = current?.properties?.[seg];
+    }
+    if (!current) return false;
+  }
+  const last = segments[segments.length - 1];
+  if (typeof last !== "string") return false;
+  return Array.isArray(current?.required) && current.required.includes(last);
 }
 
 /**
@@ -105,7 +144,9 @@ export function useProjection(
     | undefined;
 
   if (!projection) {
-    const label = computed(() => resolveLabel(control.value));
+    const label = computed(() =>
+      resolveLabel(control.value, undefined, control.value.required),
+    );
     return {
       projectedData: computed(() => control.value.data),
       projectedSchema: computed(() => control.value.schema),
@@ -139,8 +180,16 @@ export function useProjection(
     getProjectedSchema(control.value.schema, projection),
   );
 
+  const projectedRequired = computed(() =>
+    isProjectedFieldRequired(control.value.schema, projection),
+  );
+
   const label = computed(() =>
-    resolveLabel(control.value, projectedSchema.value?.title),
+    resolveLabel(
+      control.value,
+      projectedSchema.value?.title,
+      projectedRequired.value,
+    ),
   );
 
   const projectedErrors = computed(() => {