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

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.12",
 	"description": "Dynamic data provider capabilities for JSONForms with Vue 3 integration",
 	"type": "module",
 	"author": "Narrative I/O",

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(() => {