@narrative.io/jsonforms-provider-protocols 3.0.0-beta.23 → 3.0.0-beta.25

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export type { UISchemaLike } from "./core/seedProjectionTargets";
 export { RestApiProtocol } from "./protocols/rest_api";
 export { createNoEvalAjv, transformUnit, transformErrors, } from "./no-eval-ajv";
 export type { NoEvalAjv, NoEvalErrorObject, NoEvalValidateFunction, CreateNoEvalAjvOptions, } from "./no-eval-ajv";
-export { providerRenderers, primevueRenderers, ProviderAutocomplete, ProviderSelect, ProviderMultiSelect, useProvider, createDataLayer, useDataLayer, JfText, JfTextArea, JfNumber, JfEnum, JfEnumArray, JfBoolean, } from "./vue";
+export { providerRenderers, primevueRenderers, ProviderAutocomplete, ProviderSelect, ProviderMultiSelect, ProviderObjectMultiSelect, useProvider, createDataLayer, useDataLayer, JfText, JfTextArea, JfNumber, JfEnum, JfEnumArray, JfBoolean, } from "./vue";
 export type { DataLayer } from "./vue";
 export interface ProviderConfig {
     protocols?: Protocol[];

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG/B,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EACL,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,MAAM,EACN,UAAU,EACV,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,GACV,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;;iBAGc,GAAG,SAAS,cAAc;;AADzC,wBAYE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG/B,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EACL,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,MAAM,EACN,UAAU,EACV,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,GACV,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;;iBAGc,GAAG,SAAS,cAAc;;AADzC,wBAYE"}

package/dist/index.js

@@ -20,6 +20,7 @@ import { default as default8 } from "./vue/primevue/JfBoolean.vue.js";
 import { primevueRenderers } from "./vue/primevue/index.js";
 import { default as default9 } from "./vue/components/ProviderSelect.vue.js";
 import { default as default10 } from "./vue/components/ProviderMultiSelect.vue.js";
+import { default as default11 } from "./vue/components/ProviderObjectMultiSelect.vue.js";
 import { useProvider } from "./vue/composables/useProvider.js";
 import { createDataLayer, useDataLayer } from "./vue/composables/useDataLayer.js";
 const index = {
@@ -44,6 +45,7 @@ export {
   default4 as JfTextArea,
   default2 as ProviderAutocomplete,
   default10 as ProviderMultiSelect,
+  default11 as ProviderObjectMultiSelect,
   default9 as ProviderSelect,
   RestApiProtocol,
   applyTransformPipeline,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import type { App } from \"vue\";\nimport { cache as globalCache } from \"./core/cache\";\nimport { registry as globalRegistry } from \"./core/registry\";\nimport type { Protocol, AuthConfig } from \"./core/types\";\n\nexport { cache } from \"./core/cache\";\nexport * from \"./core/jsonpath\";\nexport { registry } from \"./core/registry\";\nexport * from \"./core/templating\";\nexport * from \"./core/transforms\";\nexport * from \"./core/projection\";\nexport * from \"./core/resolveScope\";\n// Core exports\nexport * from \"./core/types\";\nexport { initFormDataFromSchema } from \"./core/initFormData\";\nexport { seedProjectionTargets } from \"./core/seedProjectionTargets\";\nexport type { UISchemaLike } from \"./core/seedProjectionTargets\";\n\n// Protocol exports\nexport { RestApiProtocol } from \"./protocols/rest_api\";\n\n// CSP-safe validator\nexport {\n  createNoEvalAjv,\n  transformUnit,\n  transformErrors,\n} from \"./no-eval-ajv\";\nexport type {\n  NoEvalAjv,\n  NoEvalErrorObject,\n  NoEvalValidateFunction,\n  CreateNoEvalAjvOptions,\n} from \"./no-eval-ajv\";\n\n// Vue exports - using named imports to avoid potential bundling issues\nexport {\n  providerRenderers,\n  primevueRenderers,\n  ProviderAutocomplete,\n  ProviderSelect,\n  ProviderMultiSelect,\n  useProvider,\n  createDataLayer,\n  useDataLayer,\n  JfText,\n  JfTextArea,\n  JfNumber,\n  JfEnum,\n  JfEnumArray,\n  JfBoolean,\n} from \"./vue\";\nexport type { DataLayer } from \"./vue\";\n\nexport interface ProviderConfig {\n  protocols?: Protocol[];\n  auth?: AuthConfig;\n}\n\nexport default {\n  install(app: App, opts?: ProviderConfig) {\n    const reg = globalRegistry;\n    if (opts?.protocols) {\n      for (const p of opts.protocols) {\n        reg.register(p);\n      }\n    }\n    app.provide(\"providerRegistry\", reg);\n    app.provide(\"providerCache\", globalCache);\n    app.provide(\"providerAuth\", opts?.auth ?? {});\n  },\n};\n"],"names":["globalRegistry","globalCache"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA0DA,MAAA,QAAe;AAAA,EACb,QAAQ,KAAU,MAAuB;AACvC,UAAM,MAAMA;AACZ,QAAI,MAAM,WAAW;AACnB,iBAAW,KAAK,KAAK,WAAW;AAC9B,YAAI,SAAS,CAAC;AAAA,MAChB;AAAA,IACF;AACA,QAAI,QAAQ,oBAAoB,GAAG;AACnC,QAAI,QAAQ,iBAAiBC,KAAW;AACxC,QAAI,QAAQ,gBAAgB,MAAM,QAAQ,CAAA,CAAE;AAAA,EAC9C;AACF;"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import type { App } from \"vue\";\nimport { cache as globalCache } from \"./core/cache\";\nimport { registry as globalRegistry } from \"./core/registry\";\nimport type { Protocol, AuthConfig } from \"./core/types\";\n\nexport { cache } from \"./core/cache\";\nexport * from \"./core/jsonpath\";\nexport { registry } from \"./core/registry\";\nexport * from \"./core/templating\";\nexport * from \"./core/transforms\";\nexport * from \"./core/projection\";\nexport * from \"./core/resolveScope\";\n// Core exports\nexport * from \"./core/types\";\nexport { initFormDataFromSchema } from \"./core/initFormData\";\nexport { seedProjectionTargets } from \"./core/seedProjectionTargets\";\nexport type { UISchemaLike } from \"./core/seedProjectionTargets\";\n\n// Protocol exports\nexport { RestApiProtocol } from \"./protocols/rest_api\";\n\n// CSP-safe validator\nexport {\n  createNoEvalAjv,\n  transformUnit,\n  transformErrors,\n} from \"./no-eval-ajv\";\nexport type {\n  NoEvalAjv,\n  NoEvalErrorObject,\n  NoEvalValidateFunction,\n  CreateNoEvalAjvOptions,\n} from \"./no-eval-ajv\";\n\n// Vue exports - using named imports to avoid potential bundling issues\nexport {\n  providerRenderers,\n  primevueRenderers,\n  ProviderAutocomplete,\n  ProviderSelect,\n  ProviderMultiSelect,\n  ProviderObjectMultiSelect,\n  useProvider,\n  createDataLayer,\n  useDataLayer,\n  JfText,\n  JfTextArea,\n  JfNumber,\n  JfEnum,\n  JfEnumArray,\n  JfBoolean,\n} from \"./vue\";\nexport type { DataLayer } from \"./vue\";\n\nexport interface ProviderConfig {\n  protocols?: Protocol[];\n  auth?: AuthConfig;\n}\n\nexport default {\n  install(app: App, opts?: ProviderConfig) {\n    const reg = globalRegistry;\n    if (opts?.protocols) {\n      for (const p of opts.protocols) {\n        reg.register(p);\n      }\n    }\n    app.provide(\"providerRegistry\", reg);\n    app.provide(\"providerCache\", globalCache);\n    app.provide(\"providerAuth\", opts?.auth ?? {});\n  },\n};\n"],"names":["globalRegistry","globalCache"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA2DA,MAAA,QAAe;AAAA,EACb,QAAQ,KAAU,MAAuB;AACvC,UAAM,MAAMA;AACZ,QAAI,MAAM,WAAW;AACnB,iBAAW,KAAK,KAAK,WAAW;AAC9B,YAAI,SAAS,CAAC;AAAA,MAChB;AAAA,IACF;AACA,QAAI,QAAQ,oBAAoB,GAAG;AACnC,QAAI,QAAQ,iBAAiBC,KAAW;AACxC,QAAI,QAAQ,gBAAgB,MAAM,QAAQ,CAAA,CAAE;AAAA,EAC9C;AACF;"}

package/dist/jsonforms-provider-protocols.css

@@ -6,3 +6,7 @@
 [data-v-0d0d0f03] .p-multiselect-label {
   text-align: left;
 }
+
+[data-v-2ee6c7be] .p-multiselect-label {
+  text-align: left;
+}

package/dist/vue/components/ProviderObjectMultiSelect.vue.d.ts

@@ -0,0 +1,9 @@
+import type { ControlElement, JsonSchema } from "@jsonforms/core";
+type __VLS_Props = {
+    uischema: ControlElement;
+    schema: JsonSchema;
+    path: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=ProviderObjectMultiSelect.vue.d.ts.map

package/dist/vue/components/ProviderObjectMultiSelect.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderObjectMultiSelect.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/components/ProviderObjectMultiSelect.vue"],"names":[],"mappings":"AA2KA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiBlE,KAAK,WAAW,GAAG;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;;AAgOF,wBAEG"}

package/dist/vue/components/ProviderObjectMultiSelect.vue.js

@@ -0,0 +1,8 @@
+import _sfc_main from "./ProviderObjectMultiSelect.vue2.js";
+/* empty css                               */
+import _export_sfc from "../../_virtual/_plugin-vue_export-helper.js";
+const ProviderObjectMultiSelect = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-2ee6c7be"]]);
+export {
+  ProviderObjectMultiSelect as default
+};
+//# sourceMappingURL=ProviderObjectMultiSelect.vue.js.map

package/dist/vue/components/ProviderObjectMultiSelect.vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderObjectMultiSelect.vue.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/vue/components/ProviderObjectMultiSelect.vue2.js

@@ -0,0 +1,142 @@
+import { defineComponent, inject, computed, watch, createElementBlock, openBlock, createCommentVNode, createVNode, unref, toDisplayString } from "vue";
+import { useJsonFormsControl } from "@jsonforms/vue";
+import { useProvider } from "../composables/useProvider.js";
+import { useProjection } from "../composables/useProjection.js";
+import { resolvePlaceholder } from "../utils/placeholder.js";
+import { resolveItemsSchema, resolveObjectKeys, fromMultiSelectShape, sameObjectSet, toMultiSelectShape } from "../utils/objectMultiSelect.js";
+import MultiSelect from "primevue/multiselect";
+const _hoisted_1 = { class: "jf-control" };
+const _hoisted_2 = {
+  key: 0,
+  class: "jf-label"
+};
+const _hoisted_3 = {
+  key: 1,
+  class: "jf-description"
+};
+const _hoisted_4 = {
+  key: 2,
+  class: "p-error",
+  role: "alert"
+};
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  __name: "ProviderObjectMultiSelect",
+  props: {
+    uischema: {},
+    schema: {},
+    path: {}
+  },
+  setup(__props) {
+    const props = __props;
+    const { control, handleChange: rawHandleChange } = useJsonFormsControl(props);
+    const {
+      projectedData,
+      projectedLabel,
+      handleProjectedChange: handleChange
+    } = useProjection(control, rawHandleChange);
+    const jsonforms = inject("jsonforms", null);
+    const rootSchema = computed(
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      () => jsonforms?.core?.schema ?? control.value.schema
+    );
+    const itemsSchema = computed(
+      () => resolveItemsSchema(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        control.value.schema,
+        rootSchema.value
+      )
+    );
+    const objectKeys = computed(() => {
+      const resolved = resolveObjectKeys(
+        control.value.uischema?.options,
+        itemsSchema.value
+      );
+      if (!resolved) {
+        throw new Error(
+          "[ProviderObjectMultiSelect] objectKeys could not be resolved. Specify `uischema.options.objectKeys = { value, label }` or declare exactly two `required` properties on the array's items schema so they can be inferred."
+        );
+      }
+      return resolved;
+    });
+    const binding = computed(() => {
+      const provider = control.value.uischema?.options?.provider;
+      if (provider && typeof provider === "object" && !provider.load) {
+        return { ...provider, load: "mount" };
+      }
+      return provider;
+    });
+    const deps = computed(
+      () => control.value.schema?.["x-provider"]?.dependsOn ?? []
+    );
+    const depValues = computed(() => deps.value.map(() => null));
+    const injectedFormData = inject("formData", { value: {} });
+    const rootData = computed(() => injectedFormData.value || {});
+    const { items, loading, error } = useProvider(binding, {
+      data: rootData,
+      path: control.value.path,
+      dependsOnValues: depValues
+    });
+    watch(
+      [items, loading],
+      ([newItems, isLoading]) => {
+        if (!control.value.uischema?.options?.autoSelectSingle || isLoading || newItems.length !== 1) {
+          return;
+        }
+        const single = newItems[0];
+        const current = Array.isArray(projectedData.value) ? projectedData.value : [];
+        if (current.length === 0) {
+          handleChange(control.value.path, [
+            {
+              [objectKeys.value.value]: single.value,
+              [objectKeys.value.label]: single.label
+            }
+          ]);
+        }
+      },
+      { immediate: true }
+    );
+    const value = computed({
+      get() {
+        return toMultiSelectShape(projectedData.value, objectKeys.value);
+      },
+      set(val) {
+        const next = fromMultiSelectShape(val, objectKeys.value);
+        const curr = Array.isArray(projectedData.value) ? projectedData.value : [];
+        if (!sameObjectSet(curr, next, objectKeys.value.value)) {
+          handleChange(control.value.path, next);
+        }
+      }
+    });
+    const placeholder = computed(() => {
+      if (loading.value) return "Loading…";
+      return resolvePlaceholder(
+        control.value.uischema,
+        projectedLabel.value,
+        "select"
+      );
+    });
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("div", _hoisted_1, [
+        unref(projectedLabel) ? (openBlock(), createElementBlock("label", _hoisted_2, toDisplayString(unref(projectedLabel)), 1)) : createCommentVNode("", true),
+        unref(control).description ? (openBlock(), createElementBlock("div", _hoisted_3, toDisplayString(unref(control).description), 1)) : createCommentVNode("", true),
+        createVNode(unref(MultiSelect), {
+          modelValue: value.value,
+          "onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => value.value = $event),
+          class: "w-full!",
+          options: unref(items),
+          "option-label": "label",
+          "data-key": "value",
+          display: "chip",
+          placeholder: placeholder.value,
+          disabled: !unref(control).enabled || unref(loading),
+          "show-clear": true
+        }, null, 8, ["modelValue", "options", "placeholder", "disabled"]),
+        unref(error) ? (openBlock(), createElementBlock("small", _hoisted_4, "Failed to load: " + toDisplayString(unref(error)), 1)) : createCommentVNode("", true)
+      ]);
+    };
+  }
+});
+export {
+  _sfc_main as default
+};
+//# sourceMappingURL=ProviderObjectMultiSelect.vue2.js.map

package/dist/vue/components/ProviderObjectMultiSelect.vue2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderObjectMultiSelect.vue2.js","sources":["../../../src/vue/components/ProviderObjectMultiSelect.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport type { ControlElement, JsonSchema } from \"@jsonforms/core\";\nimport { useJsonFormsControl } from \"@jsonforms/vue\";\nimport { computed, inject, watch } from \"vue\";\nimport { useProvider } from \"../composables/useProvider\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { resolvePlaceholder } from \"../utils/placeholder\";\nimport {\n  fromMultiSelectShape,\n  resolveItemsSchema,\n  resolveObjectKeys,\n  sameObjectSet,\n  toMultiSelectShape,\n  type MultiSelectOption,\n  type ObjectKeys,\n} from \"../utils/objectMultiSelect\";\nimport MultiSelect from \"primevue/multiselect\";\n\nconst props = defineProps<{\n  uischema: ControlElement;\n  schema: JsonSchema;\n  path: string;\n}>();\nconst { control, handleChange: rawHandleChange } = useJsonFormsControl(props);\nconst {\n  projectedData,\n  projectedLabel,\n  handleProjectedChange: handleChange,\n} = useProjection(control, rawHandleChange);\n\n// Pull root schema so item-schema $refs resolve against the consumer's $defs.\nconst jsonforms = inject<{\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  core?: { schema?: Record<string, any> };\n} | null>(\"jsonforms\", null);\nconst rootSchema = computed(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  () => (jsonforms?.core?.schema ?? control.value.schema) as Record<string, any>,\n);\n\nconst itemsSchema = computed(() =>\n  resolveItemsSchema(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    control.value.schema as Record<string, any>,\n    rootSchema.value,\n  ),\n);\n\nconst objectKeys = computed<ObjectKeys>(() => {\n  const resolved = resolveObjectKeys(\n    control.value.uischema?.options as\n      | { objectKeys?: { value?: unknown; label?: unknown } }\n      | undefined,\n    itemsSchema.value,\n  );\n  if (!resolved) {\n    throw new Error(\n      \"[ProviderObjectMultiSelect] objectKeys could not be resolved. \" +\n        \"Specify `uischema.options.objectKeys = { value, label }` or declare \" +\n        \"exactly two `required` properties on the array's items schema so \" +\n        \"they can be inferred.\",\n    );\n  }\n  return resolved;\n});\n\nconst binding = computed(() => {\n  const provider = control.value.uischema?.options?.provider;\n  if (provider && typeof provider === \"object\" && !provider.load) {\n    return { ...provider, load: \"mount\" };\n  }\n  return provider;\n});\n\nconst deps = computed(\n  () =>\n    ((\n      (control.value.schema as Record<string, unknown>)?.[\n        \"x-provider\"\n      ] as Record<string, unknown>\n    )?.dependsOn as string[]) ?? [],\n);\nconst depValues = computed(() => deps.value.map(() => null));\n\nconst injectedFormData = inject<{ value: unknown }>(\"formData\", { value: {} });\nconst rootData = computed(() => injectedFormData.value || {});\n\nconst { items, loading, error } = useProvider(binding, {\n  data: rootData,\n  path: control.value.path,\n  dependsOnValues: depValues,\n});\n\n// Auto-select when provider returns only one item — paired-object variant.\nwatch(\n  [items, loading],\n  ([newItems, isLoading]) => {\n    if (\n      !control.value.uischema?.options?.autoSelectSingle ||\n      isLoading ||\n      newItems.length !== 1\n    ) {\n      return;\n    }\n    const single = newItems[0]!;\n    const current = Array.isArray(projectedData.value) ? projectedData.value : [];\n    if (current.length === 0) {\n      handleChange(control.value.path, [\n        {\n          [objectKeys.value.value]: single.value,\n          [objectKeys.value.label]: single.label,\n        },\n      ]);\n    }\n  },\n  { immediate: true },\n);\n\nconst value = computed<MultiSelectOption[]>({\n  get() {\n    return toMultiSelectShape(projectedData.value, objectKeys.value);\n  },\n  set(val) {\n    const next = fromMultiSelectShape(val, objectKeys.value);\n    const curr = Array.isArray(projectedData.value) ? projectedData.value : [];\n    if (!sameObjectSet(curr, next, objectKeys.value.value)) {\n      handleChange(control.value.path, next);\n    }\n  },\n});\n\nconst placeholder = computed(() => {\n  if (loading.value) return \"Loading…\";\n  return resolvePlaceholder(\n    control.value.uischema,\n    projectedLabel.value,\n    \"select\",\n  );\n});\n</script>\n\n<template>\n  <div class=\"jf-control\">\n    <label v-if=\"projectedLabel\" class=\"jf-label\">{{ projectedLabel }}</label>\n    <div v-if=\"control.description\" class=\"jf-description\">\n      {{ control.description }}\n    </div>\n    <MultiSelect\n      v-model=\"value\"\n      class=\"w-full!\"\n      :options=\"items\"\n      option-label=\"label\"\n      data-key=\"value\"\n      display=\"chip\"\n      :placeholder=\"placeholder\"\n      :disabled=\"!control.enabled || loading\"\n      :show-clear=\"true\"\n    />\n    <small v-if=\"error\" class=\"p-error\" role=\"alert\"\n      >Failed to load: {{ error }}</small\n    >\n  </div>\n</template>\n\n<style scoped>\n:deep(.p-multiselect-label) {\n  text-align: left;\n}\n</style>\n"],"names":["_openBlock","_createElementBlock","_unref","_toDisplayString","_createVNode"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,UAAM,QAAQ;AAKd,UAAM,EAAE,SAAS,cAAc,gBAAA,IAAoB,oBAAoB,KAAK;AAC5E,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA,uBAAuB;AAAA,IAAA,IACrB,cAAc,SAAS,eAAe;AAG1C,UAAM,YAAY,OAGR,aAAa,IAAI;AAC3B,UAAM,aAAa;AAAA;AAAA,MAEjB,MAAO,WAAW,MAAM,UAAU,QAAQ,MAAM;AAAA,IAAA;AAGlD,UAAM,cAAc;AAAA,MAAS,MAC3B;AAAA;AAAA,QAEE,QAAQ,MAAM;AAAA,QACd,WAAW;AAAA,MAAA;AAAA,IACb;AAGF,UAAM,aAAa,SAAqB,MAAM;AAC5C,YAAM,WAAW;AAAA,QACf,QAAQ,MAAM,UAAU;AAAA,QAGxB,YAAY;AAAA,MAAA;AAEd,UAAI,CAAC,UAAU;AACb,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAKJ;AACA,aAAO;AAAA,IACT,CAAC;AAED,UAAM,UAAU,SAAS,MAAM;AAC7B,YAAM,WAAW,QAAQ,MAAM,UAAU,SAAS;AAClD,UAAI,YAAY,OAAO,aAAa,YAAY,CAAC,SAAS,MAAM;AAC9D,eAAO,EAAE,GAAG,UAAU,MAAM,QAAA;AAAA,MAC9B;AACA,aAAO;AAAA,IACT,CAAC;AAED,UAAM,OAAO;AAAA,MACX,MAEK,QAAQ,MAAM,SACb,YACF,GACC,aAA0B,CAAA;AAAA,IAAC;AAElC,UAAM,YAAY,SAAS,MAAM,KAAK,MAAM,IAAI,MAAM,IAAI,CAAC;AAE3D,UAAM,mBAAmB,OAA2B,YAAY,EAAE,OAAO,CAAA,GAAI;AAC7E,UAAM,WAAW,SAAS,MAAM,iBAAiB,SAAS,CAAA,CAAE;AAE5D,UAAM,EAAE,OAAO,SAAS,MAAA,IAAU,YAAY,SAAS;AAAA,MACrD,MAAM;AAAA,MACN,MAAM,QAAQ,MAAM;AAAA,MACpB,iBAAiB;AAAA,IAAA,CAClB;AAGD;AAAA,MACE,CAAC,OAAO,OAAO;AAAA,MACf,CAAC,CAAC,UAAU,SAAS,MAAM;AACzB,YACE,CAAC,QAAQ,MAAM,UAAU,SAAS,oBAClC,aACA,SAAS,WAAW,GACpB;AACA;AAAA,QACF;AACA,cAAM,SAAS,SAAS,CAAC;AACzB,cAAM,UAAU,MAAM,QAAQ,cAAc,KAAK,IAAI,cAAc,QAAQ,CAAA;AAC3E,YAAI,QAAQ,WAAW,GAAG;AACxB,uBAAa,QAAQ,MAAM,MAAM;AAAA,YAC/B;AAAA,cACE,CAAC,WAAW,MAAM,KAAK,GAAG,OAAO;AAAA,cACjC,CAAC,WAAW,MAAM,KAAK,GAAG,OAAO;AAAA,YAAA;AAAA,UACnC,CACD;AAAA,QACH;AAAA,MACF;AAAA,MACA,EAAE,WAAW,KAAA;AAAA,IAAK;AAGpB,UAAM,QAAQ,SAA8B;AAAA,MAC1C,MAAM;AACJ,eAAO,mBAAmB,cAAc,OAAO,WAAW,KAAK;AAAA,MACjE;AAAA,MACA,IAAI,KAAK;AACP,cAAM,OAAO,qBAAqB,KAAK,WAAW,KAAK;AACvD,cAAM,OAAO,MAAM,QAAQ,cAAc,KAAK,IAAI,cAAc,QAAQ,CAAA;AACxE,YAAI,CAAC,cAAc,MAAM,MAAM,WAAW,MAAM,KAAK,GAAG;AACtD,uBAAa,QAAQ,MAAM,MAAM,IAAI;AAAA,QACvC;AAAA,MACF;AAAA,IAAA,CACD;AAED,UAAM,cAAc,SAAS,MAAM;AACjC,UAAI,QAAQ,MAAO,QAAO;AAC1B,aAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,eAAe;AAAA,QACf;AAAA,MAAA;AAAA,IAEJ,CAAC;;AAIC,aAAAA,UAAA,GAAAC,mBAmBM,OAnBN,YAmBM;AAAA,QAlBSC,MAAA,cAAA,kBAAbD,mBAA0E,SAA1E,YAA0EE,gBAAzBD,MAAA,cAAA,CAAc,GAAA,CAAA;QACpDA,MAAA,OAAA,EAAQ,eAAnBF,UAAA,GAAAC,mBAEM,OAFN,YAEME,gBADDD,MAAA,OAAA,EAAQ,WAAW,GAAA,CAAA;QAExBE,YAUEF,MAAA,WAAA,GAAA;AAAA,sBATS,MAAA;AAAA,uEAAA,MAAK,QAAA;AAAA,UACd,OAAM;AAAA,UACL,SAASA,MAAA,KAAA;AAAA,UACV,gBAAa;AAAA,UACb,YAAS;AAAA,UACT,SAAQ;AAAA,UACP,aAAa,YAAA;AAAA,UACb,UAAQ,CAAGA,MAAA,OAAA,EAAQ,WAAWA,MAAA,OAAA;AAAA,UAC9B,cAAY;AAAA,QAAA;QAEFA,MAAA,KAAA,KAAbF,aAAAC,mBAEC,SAFD,YACG,qCAAmBC,MAAA,KAAA,CAAK,GAAA,CAAA;;;;;"}

package/dist/vue/index.d.ts

@@ -2,6 +2,7 @@ import type { UISchemaElement } from "@jsonforms/core";
 import ProviderAutocomplete from "./components/ProviderAutocomplete.vue";
 import ProviderSelect from "./components/ProviderSelect.vue";
 import ProviderMultiSelect from "./components/ProviderMultiSelect.vue";
+import ProviderObjectMultiSelect from "./components/ProviderObjectMultiSelect.vue";
 export declare const providerRenderers: {
     tester: (uischema: UISchemaElement, schema: import("@jsonforms/core").JsonSchema, context: import("@jsonforms/core").TesterContext) => number;
     renderer: import("vue").DefineComponent<{
@@ -15,7 +16,7 @@ export declare const providerRenderers: {
     }> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 }[];
 export { primevueRenderers, registerPrimevueRenderers } from "./primevue";
-export { ProviderAutocomplete, ProviderSelect, ProviderMultiSelect };
+export { ProviderAutocomplete, ProviderSelect, ProviderMultiSelect, ProviderObjectMultiSelect, };
 export { useProvider } from "./composables/useProvider";
 export { useProjection } from "./composables/useProjection";
 export type { ProjectionResult } from "./composables/useProjection";

package/dist/vue/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAWvD,OAAO,oBAAoB,MAAM,uCAAuC,CAAC;AACzE,OAAO,cAAc,MAAM,iCAAiC,CAAC;AAC7D,OAAO,mBAAmB,MAAM,sCAAsC,CAAC;AAqEvE,eAAO,MAAM,iBAAiB;;;;;;;;;;;GAI7B,CAAC;AAGF,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAG1E,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC3E,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,cAAc,WAAW,CAAC;AAG1B,OAAO,EACL,MAAM,EACN,UAAU,EACV,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAYvD,OAAO,oBAAoB,MAAM,uCAAuC,CAAC;AACzE,OAAO,cAAc,MAAM,iCAAiC,CAAC;AAC7D,OAAO,mBAAmB,MAAM,sCAAsC,CAAC;AACvE,OAAO,yBAAyB,MAAM,4CAA4C,CAAC;AAoGnF,eAAO,MAAM,iBAAiB;;;;;;;;;;;GAQ7B,CAAC;AAGF,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAG1E,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,GAC1B,CAAC;AACF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC3E,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,cAAc,WAAW,CAAC;AAG1B,OAAO,EACL,MAAM,EACN,UAAU,EACV,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/vue/index.js

@@ -1,8 +1,10 @@
 import { rankWith, and, or, isStringControl, isNumberControl, isIntegerControl, isControl } from "@jsonforms/core";
 import { resolveScopeSchema } from "../core/resolveScope.js";
+import { resolveItemsSchema } from "./utils/objectMultiSelect.js";
 import _sfc_main from "./components/ProviderAutocomplete.vue.js";
 import ProviderSelect from "./components/ProviderSelect.vue.js";
 import ProviderMultiSelect from "./components/ProviderMultiSelect.vue.js";
+import ProviderObjectMultiSelect from "./components/ProviderObjectMultiSelect.vue.js";
 import { primevueRenderers, registerPrimevueRenderers } from "./primevue/index.js";
 import { useProvider } from "./composables/useProvider.js";
 import { useProjection } from "./composables/useProjection.js";
@@ -57,24 +59,51 @@ const providerAutocompleteTester = rankWith(
     (uischema) => uischema?.options?.autocomplete === true
   )
 );
-const isArrayControl = (uischema, schema) => {
+const getArraySchema = (uischema, schema) => {
   const controlSchema = uischema;
-  if (controlSchema.type !== "Control" || !controlSchema.scope) {
-    return false;
-  }
+  if (controlSchema.type !== "Control" || !controlSchema.scope) return void 0;
   const propertySchema = resolveScopeSchema(
     controlSchema.scope,
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     schema
   );
-  return propertySchema?.type === "array";
+  if (propertySchema?.type !== "array") return void 0;
+  return propertySchema;
 };
+const isObjectArrayControl = (uischema, schema) => {
+  const arr = getArraySchema(uischema, schema);
+  if (!arr) return false;
+  const items = resolveItemsSchema(
+    arr,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    schema
+  );
+  return items?.type === "object";
+};
+const isScalarArrayControl = (uischema, schema) => {
+  const arr = getArraySchema(uischema, schema);
+  if (!arr) return false;
+  const items = resolveItemsSchema(
+    arr,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    schema
+  );
+  return items?.type !== "object";
+};
+const providerObjectMultiSelectTester = rankWith(
+  110,
+  // One higher than scalar multi-select so object-item arrays match first.
+  and(isObjectArrayControl, hasProvider)
+);
 const providerMultiSelectTester = rankWith(
   109,
-  // Highest priority for array controls with providers
-  and(isArrayControl, hasProvider)
+  and(isScalarArrayControl, hasProvider)
 );
 const providerRenderers = [
+  {
+    tester: providerObjectMultiSelectTester,
+    renderer: ProviderObjectMultiSelect
+  },
   { tester: providerMultiSelectTester, renderer: ProviderMultiSelect },
   { tester: providerAutocompleteTester, renderer: _sfc_main },
   { tester: providerSelectTester, renderer: ProviderSelect }
@@ -88,6 +117,7 @@ export {
   default3 as JfTextArea,
   _sfc_main as ProviderAutocomplete,
   ProviderMultiSelect,
+  ProviderObjectMultiSelect,
   ProviderSelect,
   createDataLayer,
   primevueRenderers,

package/dist/vue/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/vue/index.ts"],"sourcesContent":["import type { UISchemaElement } from \"@jsonforms/core\";\nimport {\n  and,\n  isIntegerControl,\n  isNumberControl,\n  isStringControl,\n  or,\n  rankWith,\n  isControl,\n} from \"@jsonforms/core\";\nimport { resolveScopeSchema } from \"../core/resolveScope\";\nimport ProviderAutocomplete from \"./components/ProviderAutocomplete.vue\";\nimport ProviderSelect from \"./components/ProviderSelect.vue\";\nimport ProviderMultiSelect from \"./components/ProviderMultiSelect.vue\";\n\n// Custom tester that checks if provider option exists (as object or boolean)\nconst hasProvider = (uischema: UISchemaElement) => {\n  return uischema?.options?.provider !== undefined;\n};\n\n// Integer fallback tester — handles nested scopes like #/properties/parent/properties/child\nconst isIntegerScope = (uischema: unknown, schema: unknown) => {\n  const ui = uischema as { type?: string; scope?: string };\n  if (ui?.type !== \"Control\" || !ui?.scope) return false;\n\n  const propertySchema = resolveScopeSchema(\n    ui.scope,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    schema as Record<string, any>,\n  );\n  return propertySchema?.type === \"integer\";\n};\n\n// Create specific testers for each component type\nconst providerSelectTester = rankWith(\n  107, // Higher than PrimeVue JfNumber integer renderer (106) so provider wins\n  and(\n    or(\n      isStringControl,\n      isNumberControl,\n      isIntegerControl,\n      and(isControl, isIntegerScope),\n    ),\n    hasProvider,\n    (uischema) => !uischema?.options?.autocomplete,\n  ),\n);\n\nconst providerAutocompleteTester = rankWith(\n  108, // Higher than providerSelectTester so autocomplete variant wins when flagged\n  and(\n    or(\n      isStringControl,\n      isNumberControl,\n      isIntegerControl,\n      and(isControl, isIntegerScope),\n    ),\n    hasProvider,\n    (uischema) => uischema?.options?.autocomplete === true,\n  ),\n);\n\n// Custom array tester - supports nested scope paths\nconst isArrayControl = (uischema: UISchemaElement, schema: unknown) => {\n  const controlSchema = uischema as { type: string; scope?: string };\n  if (controlSchema.type !== \"Control\" || !controlSchema.scope) {\n    return false;\n  }\n\n  const propertySchema = resolveScopeSchema(\n    controlSchema.scope,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    schema as Record<string, any>,\n  );\n  return propertySchema?.type === \"array\";\n};\n\nconst providerMultiSelectTester = rankWith(\n  109, // Highest priority for array controls with providers\n  and(isArrayControl, hasProvider),\n);\n\nexport const providerRenderers = [\n  { tester: providerMultiSelectTester, renderer: ProviderMultiSelect },\n  { tester: providerAutocompleteTester, renderer: ProviderAutocomplete },\n  { tester: providerSelectTester, renderer: ProviderSelect },\n];\n\n// Export PrimeVue renderers (styles are auto-injected)\nexport { primevueRenderers, registerPrimevueRenderers } from \"./primevue\";\n\n// Export individual components\nexport { ProviderAutocomplete, ProviderSelect, ProviderMultiSelect };\nexport { useProvider } from \"./composables/useProvider\";\nexport { useProjection } from \"./composables/useProjection\";\nexport type { ProjectionResult } from \"./composables/useProjection\";\nexport { createDataLayer, useDataLayer } from \"./composables/useDataLayer\";\nexport type { DataLayer } from \"./composables/useDataLayer\";\nexport { useDeriveInitialValue } from \"./composables/useDeriveInitialValue\";\nexport type { DeriveInitialValueCfg } from \"./composables/useDeriveInitialValue\";\nexport { useDirtyValidation } from \"./composables/useDirtyValidation\";\nexport * from \"./testers\";\n\n// Export individual PrimeVue components using lazy evaluation to avoid circular deps\nexport {\n  JfText,\n  JfTextArea,\n  JfNumber,\n  JfEnum,\n  JfEnumArray,\n  JfBoolean,\n} from \"./primevue\";\n"],"names":["ProviderAutocomplete"],"mappings":";;;;;;;;;;;;;;;;;;AAgBA,MAAM,cAAc,CAAC,aAA8B;AACjD,SAAO,UAAU,SAAS,aAAa;AACzC;AAGA,MAAM,iBAAiB,CAAC,UAAmB,WAAoB;AAC7D,QAAM,KAAK;AACX,MAAI,IAAI,SAAS,aAAa,CAAC,IAAI,MAAO,QAAO;AAEjD,QAAM,iBAAiB;AAAA,IACrB,GAAG;AAAA;AAAA,IAEH;AAAA,EAAA;AAEF,SAAO,gBAAgB,SAAS;AAClC;AAGA,MAAM,uBAAuB;AAAA,EAC3B;AAAA;AAAA,EACA;AAAA,IACE;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA,IAAI,WAAW,cAAc;AAAA,IAAA;AAAA,IAE/B;AAAA,IACA,CAAC,aAAa,CAAC,UAAU,SAAS;AAAA,EAAA;AAEtC;AAEA,MAAM,6BAA6B;AAAA,EACjC;AAAA;AAAA,EACA;AAAA,IACE;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA,IAAI,WAAW,cAAc;AAAA,IAAA;AAAA,IAE/B;AAAA,IACA,CAAC,aAAa,UAAU,SAAS,iBAAiB;AAAA,EAAA;AAEtD;AAGA,MAAM,iBAAiB,CAAC,UAA2B,WAAoB;AACrE,QAAM,gBAAgB;AACtB,MAAI,cAAc,SAAS,aAAa,CAAC,cAAc,OAAO;AAC5D,WAAO;AAAA,EACT;AAEA,QAAM,iBAAiB;AAAA,IACrB,cAAc;AAAA;AAAA,IAEd;AAAA,EAAA;AAEF,SAAO,gBAAgB,SAAS;AAClC;AAEA,MAAM,4BAA4B;AAAA,EAChC;AAAA;AAAA,EACA,IAAI,gBAAgB,WAAW;AACjC;AAEO,MAAM,oBAAoB;AAAA,EAC/B,EAAE,QAAQ,2BAA2B,UAAU,oBAAA;AAAA,EAC/C,EAAE,QAAQ,4BAA4B,UAAUA,UAAA;AAAA,EAChD,EAAE,QAAQ,sBAAsB,UAAU,eAAA;AAC5C;"}
+{"version":3,"file":"index.js","sources":["../../src/vue/index.ts"],"sourcesContent":["import type { UISchemaElement } from \"@jsonforms/core\";\nimport {\n  and,\n  isIntegerControl,\n  isNumberControl,\n  isStringControl,\n  or,\n  rankWith,\n  isControl,\n} from \"@jsonforms/core\";\nimport { resolveScopeSchema } from \"../core/resolveScope\";\nimport { resolveItemsSchema } from \"./utils/objectMultiSelect\";\nimport ProviderAutocomplete from \"./components/ProviderAutocomplete.vue\";\nimport ProviderSelect from \"./components/ProviderSelect.vue\";\nimport ProviderMultiSelect from \"./components/ProviderMultiSelect.vue\";\nimport ProviderObjectMultiSelect from \"./components/ProviderObjectMultiSelect.vue\";\n\n// Custom tester that checks if provider option exists (as object or boolean)\nconst hasProvider = (uischema: UISchemaElement) => {\n  return uischema?.options?.provider !== undefined;\n};\n\n// Integer fallback tester — handles nested scopes like #/properties/parent/properties/child\nconst isIntegerScope = (uischema: unknown, schema: unknown) => {\n  const ui = uischema as { type?: string; scope?: string };\n  if (ui?.type !== \"Control\" || !ui?.scope) return false;\n\n  const propertySchema = resolveScopeSchema(\n    ui.scope,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    schema as Record<string, any>,\n  );\n  return propertySchema?.type === \"integer\";\n};\n\n// Create specific testers for each component type\nconst providerSelectTester = rankWith(\n  107, // Higher than PrimeVue JfNumber integer renderer (106) so provider wins\n  and(\n    or(\n      isStringControl,\n      isNumberControl,\n      isIntegerControl,\n      and(isControl, isIntegerScope),\n    ),\n    hasProvider,\n    (uischema) => !uischema?.options?.autocomplete,\n  ),\n);\n\nconst providerAutocompleteTester = rankWith(\n  108, // Higher than providerSelectTester so autocomplete variant wins when flagged\n  and(\n    or(\n      isStringControl,\n      isNumberControl,\n      isIntegerControl,\n      and(isControl, isIntegerScope),\n    ),\n    hasProvider,\n    (uischema) => uischema?.options?.autocomplete === true,\n  ),\n);\n\n// Resolve the array schema at a control's scope, or undefined if the\n// control isn't an array. Shared by both array testers below.\nconst getArraySchema = (uischema: UISchemaElement, schema: unknown) => {\n  const controlSchema = uischema as { type: string; scope?: string };\n  if (controlSchema.type !== \"Control\" || !controlSchema.scope) return undefined;\n  const propertySchema = resolveScopeSchema(\n    controlSchema.scope,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    schema as Record<string, any>,\n  );\n  if (propertySchema?.type !== \"array\") return undefined;\n  return propertySchema;\n};\n\n// Object-item arrays — render with paired-object MultiSelect.\nconst isObjectArrayControl = (uischema: UISchemaElement, schema: unknown) => {\n  const arr = getArraySchema(uischema, schema);\n  if (!arr) return false;\n  const items = resolveItemsSchema(\n    arr,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    schema as Record<string, any>,\n  );\n  return items?.type === \"object\";\n};\n\n// Scalar-item arrays — the original tester. Excludes object-item arrays so\n// the new ObjectMultiSelect renderer can claim them at a higher rank.\nconst isScalarArrayControl = (uischema: UISchemaElement, schema: unknown) => {\n  const arr = getArraySchema(uischema, schema);\n  if (!arr) return false;\n  const items = resolveItemsSchema(\n    arr,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    schema as Record<string, any>,\n  );\n  // Treat unknown / no-items shapes as scalar (matches prior behavior where\n  // any array control was eligible for ProviderMultiSelect).\n  return items?.type !== \"object\";\n};\n\nconst providerObjectMultiSelectTester = rankWith(\n  110, // One higher than scalar multi-select so object-item arrays match first.\n  and(isObjectArrayControl, hasProvider),\n);\n\nconst providerMultiSelectTester = rankWith(\n  109,\n  and(isScalarArrayControl, hasProvider),\n);\n\nexport const providerRenderers = [\n  {\n    tester: providerObjectMultiSelectTester,\n    renderer: ProviderObjectMultiSelect,\n  },\n  { tester: providerMultiSelectTester, renderer: ProviderMultiSelect },\n  { tester: providerAutocompleteTester, renderer: ProviderAutocomplete },\n  { tester: providerSelectTester, renderer: ProviderSelect },\n];\n\n// Export PrimeVue renderers (styles are auto-injected)\nexport { primevueRenderers, registerPrimevueRenderers } from \"./primevue\";\n\n// Export individual components\nexport {\n  ProviderAutocomplete,\n  ProviderSelect,\n  ProviderMultiSelect,\n  ProviderObjectMultiSelect,\n};\nexport { useProvider } from \"./composables/useProvider\";\nexport { useProjection } from \"./composables/useProjection\";\nexport type { ProjectionResult } from \"./composables/useProjection\";\nexport { createDataLayer, useDataLayer } from \"./composables/useDataLayer\";\nexport type { DataLayer } from \"./composables/useDataLayer\";\nexport { useDeriveInitialValue } from \"./composables/useDeriveInitialValue\";\nexport type { DeriveInitialValueCfg } from \"./composables/useDeriveInitialValue\";\nexport { useDirtyValidation } from \"./composables/useDirtyValidation\";\nexport * from \"./testers\";\n\n// Export individual PrimeVue components using lazy evaluation to avoid circular deps\nexport {\n  JfText,\n  JfTextArea,\n  JfNumber,\n  JfEnum,\n  JfEnumArray,\n  JfBoolean,\n} from \"./primevue\";\n"],"names":["ProviderAutocomplete"],"mappings":";;;;;;;;;;;;;;;;;;;;AAkBA,MAAM,cAAc,CAAC,aAA8B;AACjD,SAAO,UAAU,SAAS,aAAa;AACzC;AAGA,MAAM,iBAAiB,CAAC,UAAmB,WAAoB;AAC7D,QAAM,KAAK;AACX,MAAI,IAAI,SAAS,aAAa,CAAC,IAAI,MAAO,QAAO;AAEjD,QAAM,iBAAiB;AAAA,IACrB,GAAG;AAAA;AAAA,IAEH;AAAA,EAAA;AAEF,SAAO,gBAAgB,SAAS;AAClC;AAGA,MAAM,uBAAuB;AAAA,EAC3B;AAAA;AAAA,EACA;AAAA,IACE;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA,IAAI,WAAW,cAAc;AAAA,IAAA;AAAA,IAE/B;AAAA,IACA,CAAC,aAAa,CAAC,UAAU,SAAS;AAAA,EAAA;AAEtC;AAEA,MAAM,6BAA6B;AAAA,EACjC;AAAA;AAAA,EACA;AAAA,IACE;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA,IAAI,WAAW,cAAc;AAAA,IAAA;AAAA,IAE/B;AAAA,IACA,CAAC,aAAa,UAAU,SAAS,iBAAiB;AAAA,EAAA;AAEtD;AAIA,MAAM,iBAAiB,CAAC,UAA2B,WAAoB;AACrE,QAAM,gBAAgB;AACtB,MAAI,cAAc,SAAS,aAAa,CAAC,cAAc,MAAO,QAAO;AACrE,QAAM,iBAAiB;AAAA,IACrB,cAAc;AAAA;AAAA,IAEd;AAAA,EAAA;AAEF,MAAI,gBAAgB,SAAS,QAAS,QAAO;AAC7C,SAAO;AACT;AAGA,MAAM,uBAAuB,CAAC,UAA2B,WAAoB;AAC3E,QAAM,MAAM,eAAe,UAAU,MAAM;AAC3C,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,QAAQ;AAAA,IACZ;AAAA;AAAA,IAEA;AAAA,EAAA;AAEF,SAAO,OAAO,SAAS;AACzB;AAIA,MAAM,uBAAuB,CAAC,UAA2B,WAAoB;AAC3E,QAAM,MAAM,eAAe,UAAU,MAAM;AAC3C,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,QAAQ;AAAA,IACZ;AAAA;AAAA,IAEA;AAAA,EAAA;AAIF,SAAO,OAAO,SAAS;AACzB;AAEA,MAAM,kCAAkC;AAAA,EACtC;AAAA;AAAA,EACA,IAAI,sBAAsB,WAAW;AACvC;AAEA,MAAM,4BAA4B;AAAA,EAChC;AAAA,EACA,IAAI,sBAAsB,WAAW;AACvC;AAEO,MAAM,oBAAoB;AAAA,EAC/B;AAAA,IACE,QAAQ;AAAA,IACR,UAAU;AAAA,EAAA;AAAA,EAEZ,EAAE,QAAQ,2BAA2B,UAAU,oBAAA;AAAA,EAC/C,EAAE,QAAQ,4BAA4B,UAAUA,UAAA;AAAA,EAChD,EAAE,QAAQ,sBAAsB,UAAU,eAAA;AAC5C;"}

package/dist/vue/primevue/JfBoolean.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JfBoolean.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfBoolean.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2FA,wBAoLK"}
+{"version":3,"file":"JfBoolean.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfBoolean.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgGA,wBAiMK"}

package/dist/vue/primevue/JfBoolean.vue.js

@@ -1,17 +1,19 @@
-import { defineComponent, getCurrentInstance, createElementBlock, openBlock, createVNode, createCommentVNode, unref, normalizeClass, toDisplayString } from "vue";
+import { defineComponent, getCurrentInstance, createElementBlock, openBlock, createElementVNode, createCommentVNode, createVNode, unref, normalizeClass, toDisplayString } from "vue";
 import { useJsonFormsControl } from "@jsonforms/vue";
 import { useProjection } from "../composables/useProjection.js";
 import { useDirtyValidation } from "../composables/useDirtyValidation.js";
 import Checkbox from "primevue/checkbox";
-const _hoisted_1 = {
-  class: "jf-control",
-  style: { "flex-direction": "row", "align-items": "center" }
-};
-const _hoisted_2 = {
+const _hoisted_1 = { class: "jf-control" };
+const _hoisted_2 = { style: { "display": "flex", "flex-direction": "row", "align-items": "center" } };
+const _hoisted_3 = {
   key: 0,
   class: "jf-label"
 };
-const _hoisted_3 = {
+const _hoisted_4 = {
+  key: 0,
+  class: "jf-description"
+};
+const _hoisted_5 = {
   key: 1,
   class: "p-error"
 };
@@ -70,16 +72,19 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
     return (_ctx, _cache) => {
       return openBlock(), createElementBlock("div", _hoisted_1, [
-        createVNode(unref(Checkbox), {
-          binary: true,
-          "model-value": !!unref(projectedData),
-          disabled: !unref(control).enabled,
-          class: normalizeClass({ "p-invalid": unref(showErrors) }),
-          "aria-invalid": unref(showErrors) || void 0,
-          "onUpdate:modelValue": onToggle
-        }, null, 8, ["model-value", "disabled", "class", "aria-invalid"]),
-        unref(projectedLabel) ? (openBlock(), createElementBlock("label", _hoisted_2, toDisplayString(unref(projectedLabel)), 1)) : createCommentVNode("", true),
-        unref(showErrors) ? (openBlock(), createElementBlock("small", _hoisted_3, toDisplayString(unref(projectedErrors)), 1)) : createCommentVNode("", true)
+        createElementVNode("div", _hoisted_2, [
+          createVNode(unref(Checkbox), {
+            binary: true,
+            "model-value": !!unref(projectedData),
+            disabled: !unref(control).enabled,
+            class: normalizeClass({ "p-invalid": unref(showErrors) }),
+            "aria-invalid": unref(showErrors) || void 0,
+            "onUpdate:modelValue": onToggle
+          }, null, 8, ["model-value", "disabled", "class", "aria-invalid"]),
+          unref(projectedLabel) ? (openBlock(), createElementBlock("label", _hoisted_3, toDisplayString(unref(projectedLabel)), 1)) : createCommentVNode("", true)
+        ]),
+        unref(control).description ? (openBlock(), createElementBlock("div", _hoisted_4, toDisplayString(unref(control).description), 1)) : createCommentVNode("", true),
+        unref(showErrors) ? (openBlock(), createElementBlock("small", _hoisted_5, toDisplayString(unref(projectedErrors)), 1)) : createCommentVNode("", true)
       ]);
     };
   }

package/dist/vue/primevue/JfBoolean.vue.js.map

@@ -1 +1 @@
-{"version":3,"file":"JfBoolean.vue.js","sources":["../../../src/vue/primevue/JfBoolean.vue"],"sourcesContent":["<script lang=\"ts\">\nexport default {\n  name: \"JfBoolean\",\n  props: {\n    uischema: {\n      type: Object,\n      required: true,\n    },\n    schema: {\n      type: Object,\n      required: true,\n    },\n    path: {\n      type: String,\n      required: true,\n    },\n    enabled: {\n      type: Boolean,\n      default: undefined,\n    },\n    renderers: {\n      type: Array,\n      required: false,\n      default: undefined,\n    },\n    cells: {\n      type: Array,\n      required: false,\n      default: undefined,\n    },\n    config: {\n      type: Object,\n      required: false,\n      default: undefined,\n    },\n  },\n};\n</script>\n\n<script setup lang=\"ts\">\nimport type { ControlProps } from \"@jsonforms/vue\";\nimport { useJsonFormsControl } from \"@jsonforms/vue\";\nimport { getCurrentInstance } from \"vue\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { useDirtyValidation } from \"../composables/useDirtyValidation\";\nimport Checkbox from \"primevue/checkbox\";\n\n// Access props from the component instance\nconst instance = getCurrentInstance()!;\nconst props = instance.props as unknown as ControlProps;\nconst { control, handleChange: rawHandleChange } = useJsonFormsControl(props);\nconst {\n  projectedData,\n  handleProjectedChange: handleChange,\n  projectedErrors,\n  projectedLabel,\n} = useProjection(control, rawHandleChange);\n\n// Track user interaction — errors only show after first toggle\nconst { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);\n\nconst onToggle = (val: boolean) => {\n  markDirty();\n  handleChange(control.value.path, val);\n};\n</script>\n\n<template>\n  <div class=\"jf-control\" style=\"flex-direction: row; align-items: center\">\n    <Checkbox\n      :binary=\"true\"\n      :model-value=\"!!projectedData\"\n      :disabled=\"!control.enabled\"\n      :class=\"{ 'p-invalid': showErrors }\"\n      :aria-invalid=\"showErrors || undefined\"\n      @update:model-value=\"onToggle\"\n    />\n    <label v-if=\"projectedLabel\" class=\"jf-label\">{{ projectedLabel }}</label>\n    <small v-if=\"showErrors\" class=\"p-error\">{{ projectedErrors }}</small>\n  </div>\n</template>\n"],"names":["_openBlock","_createElementBlock","_createVNode","_unref","_toDisplayString"],"mappings":";;;;;;;;;;;;;;;;;AACA,MAAA,cAAe;AAAA,EACb,MAAM;AAAA,EACN,OAAO;AAAA,IACL,UAAU;AAAA,MACR,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,IAEZ,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,IAEZ,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,IAEZ,SAAS;AAAA,MACP,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA,IAEX,WAAW;AAAA,MACT,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,IAAA;AAAA,IAEX,OAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,IAAA;AAAA,IAEX,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,IAAA;AAAA,EACX;AAEJ;;;;AAYA,UAAM,WAAW,mBAAA;AACjB,UAAM,QAAQ,SAAS;AACvB,UAAM,EAAE,SAAS,cAAc,gBAAA,IAAoB,oBAAoB,KAAK;AAC5E,UAAM;AAAA,MACJ;AAAA,MACA,uBAAuB;AAAA,MACvB;AAAA,MACA;AAAA,IAAA,IACE,cAAc,SAAS,eAAe;AAG1C,UAAM,EAAE,YAAY,UAAA,IAAc,mBAAmB,SAAS,eAAe;AAE7E,UAAM,WAAW,CAAC,QAAiB;AACjC,gBAAA;AACA,mBAAa,QAAQ,MAAM,MAAM,GAAG;AAAA,IACtC;;AAIE,aAAAA,UAAA,GAAAC,mBAWM,OAXN,YAWM;AAAA,QAVJC,YAOEC,MAAA,QAAA,GAAA;AAAA,UANC,QAAQ;AAAA,UACR,iBAAeA,MAAA,aAAA;AAAA,UACf,UAAQ,CAAGA,MAAA,OAAA,EAAQ;AAAA,UACnB,qCAAsBA,MAAA,UAAA,GAAU;AAAA,UAChC,gBAAcA,MAAA,UAAA,KAAc;AAAA,UAC5B,uBAAoB;AAAA,QAAA;QAEVA,MAAA,cAAA,kBAAbF,mBAA0E,SAA1E,YAA0EG,gBAAzBD,MAAA,cAAA,CAAc,GAAA,CAAA;QAClDA,MAAA,UAAA,kBAAbF,mBAAsE,SAAtE,YAAsEG,gBAA1BD,MAAA,eAAA,CAAe,GAAA,CAAA;;;;;"}
+{"version":3,"file":"JfBoolean.vue.js","sources":["../../../src/vue/primevue/JfBoolean.vue"],"sourcesContent":["<script lang=\"ts\">\nexport default {\n  name: \"JfBoolean\",\n  props: {\n    uischema: {\n      type: Object,\n      required: true,\n    },\n    schema: {\n      type: Object,\n      required: true,\n    },\n    path: {\n      type: String,\n      required: true,\n    },\n    enabled: {\n      type: Boolean,\n      default: undefined,\n    },\n    renderers: {\n      type: Array,\n      required: false,\n      default: undefined,\n    },\n    cells: {\n      type: Array,\n      required: false,\n      default: undefined,\n    },\n    config: {\n      type: Object,\n      required: false,\n      default: undefined,\n    },\n  },\n};\n</script>\n\n<script setup lang=\"ts\">\nimport type { ControlProps } from \"@jsonforms/vue\";\nimport { useJsonFormsControl } from \"@jsonforms/vue\";\nimport { getCurrentInstance } from \"vue\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { useDirtyValidation } from \"../composables/useDirtyValidation\";\nimport Checkbox from \"primevue/checkbox\";\n\n// Access props from the component instance\nconst instance = getCurrentInstance()!;\nconst props = instance.props as unknown as ControlProps;\nconst { control, handleChange: rawHandleChange } = useJsonFormsControl(props);\nconst {\n  projectedData,\n  handleProjectedChange: handleChange,\n  projectedErrors,\n  projectedLabel,\n} = useProjection(control, rawHandleChange);\n\n// Track user interaction — errors only show after first toggle\nconst { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);\n\nconst onToggle = (val: boolean) => {\n  markDirty();\n  handleChange(control.value.path, val);\n};\n</script>\n\n<template>\n  <div class=\"jf-control\">\n    <div style=\"display: flex; flex-direction: row; align-items: center\">\n      <Checkbox\n        :binary=\"true\"\n        :model-value=\"!!projectedData\"\n        :disabled=\"!control.enabled\"\n        :class=\"{ 'p-invalid': showErrors }\"\n        :aria-invalid=\"showErrors || undefined\"\n        @update:model-value=\"onToggle\"\n      />\n      <label v-if=\"projectedLabel\" class=\"jf-label\">{{ projectedLabel }}</label>\n    </div>\n    <div v-if=\"control.description\" class=\"jf-description\">\n      {{ control.description }}\n    </div>\n    <small v-if=\"showErrors\" class=\"p-error\">{{ projectedErrors }}</small>\n  </div>\n</template>\n"],"names":["_openBlock","_createElementBlock","_createElementVNode","_createVNode","_unref","_toDisplayString"],"mappings":";;;;;;;;;;;;;;;;;;;AACA,MAAA,cAAe;AAAA,EACb,MAAM;AAAA,EACN,OAAO;AAAA,IACL,UAAU;AAAA,MACR,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,IAEZ,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,IAEZ,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,IAEZ,SAAS;AAAA,MACP,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA,IAEX,WAAW;AAAA,MACT,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,IAAA;AAAA,IAEX,OAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,IAAA;AAAA,IAEX,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,IAAA;AAAA,EACX;AAEJ;;;;AAYA,UAAM,WAAW,mBAAA;AACjB,UAAM,QAAQ,SAAS;AACvB,UAAM,EAAE,SAAS,cAAc,gBAAA,IAAoB,oBAAoB,KAAK;AAC5E,UAAM;AAAA,MACJ;AAAA,MACA,uBAAuB;AAAA,MACvB;AAAA,MACA;AAAA,IAAA,IACE,cAAc,SAAS,eAAe;AAG1C,UAAM,EAAE,YAAY,UAAA,IAAc,mBAAmB,SAAS,eAAe;AAE7E,UAAM,WAAW,CAAC,QAAiB;AACjC,gBAAA;AACA,mBAAa,QAAQ,MAAM,MAAM,GAAG;AAAA,IACtC;;AAIE,aAAAA,UAAA,GAAAC,mBAgBM,OAhBN,YAgBM;AAAA,QAfJC,mBAUM,OAVN,YAUM;AAAA,UATJC,YAOEC,MAAA,QAAA,GAAA;AAAA,YANC,QAAQ;AAAA,YACR,iBAAeA,MAAA,aAAA;AAAA,YACf,UAAQ,CAAGA,MAAA,OAAA,EAAQ;AAAA,YACnB,qCAAsBA,MAAA,UAAA,GAAU;AAAA,YAChC,gBAAcA,MAAA,UAAA,KAAc;AAAA,YAC5B,uBAAoB;AAAA,UAAA;UAEVA,MAAA,cAAA,kBAAbH,mBAA0E,SAA1E,YAA0EI,gBAAzBD,MAAA,cAAA,CAAc,GAAA,CAAA;;QAEtDA,MAAA,OAAA,EAAQ,eAAnBJ,UAAA,GAAAC,mBAEM,OAFN,YAEMI,gBADDD,MAAA,OAAA,EAAQ,WAAW,GAAA,CAAA;QAEXA,MAAA,UAAA,kBAAbH,mBAAsE,SAAtE,YAAsEI,gBAA1BD,MAAA,eAAA,CAAe,GAAA,CAAA;;;;;"}

package/dist/vue/utils/objectMultiSelect.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Helpers for `ProviderObjectMultiSelect`: bidirectional translation between
+ * the form-data shape (paired objects with consumer-named keys) and the
+ * MultiSelect model shape (`{ value, label }` matching the provider's `map`
+ * config), plus `objectKeys` inference when the consumer doesn't specify
+ * them on the uischema.
+ *
+ * Pure functions — no Vue, no rendering — so the renderer can compose them
+ * and tests can exercise the logic in isolation.
+ */
+export interface ObjectKeys {
+    /** Property name on the form-data object that holds the identifier. */
+    value: string;
+    /** Property name on the form-data object that holds the display string. */
+    label: string;
+}
+export interface MultiSelectOption {
+    value: unknown;
+    label: string;
+    [key: string]: unknown;
+}
+/**
+ * Translate form-data items (`[{ [valueKey]: v, [labelKey]: l }]`) into the
+ * shape PrimeVue's `<MultiSelect>` expects (`[{ value, label }]`). Items
+ * already in `{ value, label }` shape pass through; missing keys yield
+ * `undefined` / `""` so the renderer doesn't blow up on partial data.
+ */
+export declare function toMultiSelectShape(formData: unknown, keys: ObjectKeys): MultiSelectOption[];
+/**
+ * Inverse of `toMultiSelectShape`. Translates `<MultiSelect>` model items
+ * back into form-data shape using the consumer-specified property names.
+ */
+export declare function fromMultiSelectShape(modelData: unknown, keys: ObjectKeys): Record<string, unknown>[];
+/**
+ * Order-insensitive equality of two object-shape selections by the
+ * identifier property. Used to short-circuit redundant `handleChange`
+ * calls when the model emits the same selection under reference inequality.
+ */
+export declare function sameObjectSet(a: unknown, b: unknown, identifierKey: string): boolean;
+/**
+ * Resolve the items schema of an array control, dereferencing `items.$ref`
+ * against the root if present. Returns `undefined` if no items schema exists.
+ */
+export declare function resolveItemsSchema(arraySchema: Record<string, any> | undefined, rootSchema: Record<string, any>): Record<string, any> | undefined;
+/**
+ * Infer `objectKeys` from a resolved items schema when the consumer hasn't
+ * specified them on the uischema.
+ *
+ * Strategy: look at `items.required`. If it has exactly two entries, the
+ * one whose property has `format: 'uuid'` becomes `value`; the other
+ * becomes `label`. If neither has a uuid format, the first entry is
+ * `value`, the second is `label`. Returns `undefined` (and the renderer
+ * throws at mount) for any other shape — explicit `objectKeys` is required.
+ */
+export declare function inferObjectKeys(itemsSchema: Record<string, any> | undefined): ObjectKeys | undefined;
+/**
+ * Resolve the active `objectKeys` for a control: prefer the explicit
+ * `uischema.options.objectKeys`, fall back to schema-driven inference.
+ * Returns `undefined` when neither is available; the renderer surfaces a
+ * runtime error in that case so the consumer knows to be explicit.
+ */
+export declare function resolveObjectKeys(uischemaOptions: {
+    objectKeys?: {
+        value?: unknown;
+        label?: unknown;
+    };
+} | undefined, itemsSchema: Record<string, any> | undefined): ObjectKeys | undefined;
+//# sourceMappingURL=objectMultiSelect.d.ts.map

package/dist/vue/utils/objectMultiSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectMultiSelect.d.ts","sourceRoot":"","sources":["../../../src/vue/utils/objectMultiSelect.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,UAAU,GACf,iBAAiB,EAAE,CAqBrB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,OAAO,EAClB,IAAI,EAAE,UAAU,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAW3B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,OAAO,EACV,CAAC,EAAE,OAAO,EACV,aAAa,EAAE,MAAM,GACpB,OAAO,CAaT;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAEhC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EAE5C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAE9B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAOjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAE7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAC3C,UAAU,GAAG,SAAS,CAcxB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE;IAAE,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,EAElF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAC3C,UAAU,GAAG,SAAS,CAUxB"}

package/dist/vue/utils/objectMultiSelect.js

@@ -0,0 +1,72 @@
+import { deref } from "../../core/refs.js";
+function toMultiSelectShape(formData, keys) {
+  if (!Array.isArray(formData)) return [];
+  return formData.filter((item) => item !== null && typeof item === "object").map((item) => {
+    const obj = item;
+    if (!(keys.value in obj) && !(keys.label in obj) && "value" in obj && "label" in obj) {
+      return obj;
+    }
+    return {
+      value: obj[keys.value],
+      label: typeof obj[keys.label] === "string" ? obj[keys.label] : ""
+    };
+  });
+}
+function fromMultiSelectShape(modelData, keys) {
+  if (!Array.isArray(modelData)) return [];
+  return modelData.filter((item) => item !== null && typeof item === "object").map((item) => {
+    const obj = item;
+    return {
+      [keys.value]: obj.value,
+      [keys.label]: obj.label
+    };
+  });
+}
+function sameObjectSet(a, b, identifierKey) {
+  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) {
+    return false;
+  }
+  const ids = new Set(
+    b.filter((x) => x !== null && typeof x === "object").map((x) => x[identifierKey])
+  );
+  return a.every((x) => {
+    if (x === null || typeof x !== "object") return false;
+    return ids.has(x[identifierKey]);
+  });
+}
+function resolveItemsSchema(arraySchema, rootSchema) {
+  if (!arraySchema || typeof arraySchema !== "object") return void 0;
+  const items = arraySchema.items;
+  if (!items || typeof items !== "object" || Array.isArray(items)) {
+    return void 0;
+  }
+  return deref(items, rootSchema);
+}
+function inferObjectKeys(itemsSchema) {
+  if (!itemsSchema || itemsSchema.type !== "object") return void 0;
+  const required = itemsSchema.required;
+  if (!Array.isArray(required) || required.length !== 2) return void 0;
+  const [a, b] = required;
+  const props = itemsSchema.properties ?? {};
+  const aIsUuid = props[a]?.format === "uuid";
+  const bIsUuid = props[b]?.format === "uuid";
+  if (aIsUuid && !bIsUuid) return { value: a, label: b };
+  if (bIsUuid && !aIsUuid) return { value: b, label: a };
+  return { value: a, label: b };
+}
+function resolveObjectKeys(uischemaOptions, itemsSchema) {
+  const explicit = uischemaOptions?.objectKeys;
+  if (explicit && typeof explicit.value === "string" && typeof explicit.label === "string") {
+    return { value: explicit.value, label: explicit.label };
+  }
+  return inferObjectKeys(itemsSchema);
+}
+export {
+  fromMultiSelectShape,
+  inferObjectKeys,
+  resolveItemsSchema,
+  resolveObjectKeys,
+  sameObjectSet,
+  toMultiSelectShape
+};
+//# sourceMappingURL=objectMultiSelect.js.map

package/dist/vue/utils/objectMultiSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectMultiSelect.js","sources":["../../../src/vue/utils/objectMultiSelect.ts"],"sourcesContent":["import { deref } from \"../../core/refs\";\n\n/**\n * Helpers for `ProviderObjectMultiSelect`: bidirectional translation between\n * the form-data shape (paired objects with consumer-named keys) and the\n * MultiSelect model shape (`{ value, label }` matching the provider's `map`\n * config), plus `objectKeys` inference when the consumer doesn't specify\n * them on the uischema.\n *\n * Pure functions — no Vue, no rendering — so the renderer can compose them\n * and tests can exercise the logic in isolation.\n */\n\nexport interface ObjectKeys {\n  /** Property name on the form-data object that holds the identifier. */\n  value: string;\n  /** Property name on the form-data object that holds the display string. */\n  label: string;\n}\n\nexport interface MultiSelectOption {\n  value: unknown;\n  label: string;\n  [key: string]: unknown;\n}\n\n/**\n * Translate form-data items (`[{ [valueKey]: v, [labelKey]: l }]`) into the\n * shape PrimeVue's `<MultiSelect>` expects (`[{ value, label }]`). Items\n * already in `{ value, label }` shape pass through; missing keys yield\n * `undefined` / `\"\"` so the renderer doesn't blow up on partial data.\n */\nexport function toMultiSelectShape(\n  formData: unknown,\n  keys: ObjectKeys,\n): MultiSelectOption[] {\n  if (!Array.isArray(formData)) return [];\n  return formData\n    .filter((item) => item !== null && typeof item === \"object\")\n    .map((item) => {\n      const obj = item as Record<string, unknown>;\n      // Tolerate already-translated items: if both `value` and `label` are\n      // present and the form-data keys aren't, assume MultiSelect shape.\n      if (\n        !(keys.value in obj) &&\n        !(keys.label in obj) &&\n        \"value\" in obj &&\n        \"label\" in obj\n      ) {\n        return obj as MultiSelectOption;\n      }\n      return {\n        value: obj[keys.value],\n        label: typeof obj[keys.label] === \"string\" ? (obj[keys.label] as string) : \"\",\n      };\n    });\n}\n\n/**\n * Inverse of `toMultiSelectShape`. Translates `<MultiSelect>` model items\n * back into form-data shape using the consumer-specified property names.\n */\nexport function fromMultiSelectShape(\n  modelData: unknown,\n  keys: ObjectKeys,\n): Record<string, unknown>[] {\n  if (!Array.isArray(modelData)) return [];\n  return modelData\n    .filter((item) => item !== null && typeof item === \"object\")\n    .map((item) => {\n      const obj = item as Record<string, unknown>;\n      return {\n        [keys.value]: obj.value,\n        [keys.label]: obj.label,\n      };\n    });\n}\n\n/**\n * Order-insensitive equality of two object-shape selections by the\n * identifier property. Used to short-circuit redundant `handleChange`\n * calls when the model emits the same selection under reference inequality.\n */\nexport function sameObjectSet(\n  a: unknown,\n  b: unknown,\n  identifierKey: string,\n): boolean {\n  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) {\n    return false;\n  }\n  const ids = new Set(\n    b\n      .filter((x) => x !== null && typeof x === \"object\")\n      .map((x) => (x as Record<string, unknown>)[identifierKey]),\n  );\n  return a.every((x) => {\n    if (x === null || typeof x !== \"object\") return false;\n    return ids.has((x as Record<string, unknown>)[identifierKey]);\n  });\n}\n\n/**\n * Resolve the items schema of an array control, dereferencing `items.$ref`\n * against the root if present. Returns `undefined` if no items schema exists.\n */\nexport function resolveItemsSchema(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  arraySchema: Record<string, any> | undefined,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  rootSchema: Record<string, any>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Record<string, any> | undefined {\n  if (!arraySchema || typeof arraySchema !== \"object\") return undefined;\n  const items = arraySchema.items;\n  if (!items || typeof items !== \"object\" || Array.isArray(items)) {\n    return undefined;\n  }\n  return deref(items, rootSchema);\n}\n\n/**\n * Infer `objectKeys` from a resolved items schema when the consumer hasn't\n * specified them on the uischema.\n *\n * Strategy: look at `items.required`. If it has exactly two entries, the\n * one whose property has `format: 'uuid'` becomes `value`; the other\n * becomes `label`. If neither has a uuid format, the first entry is\n * `value`, the second is `label`. Returns `undefined` (and the renderer\n * throws at mount) for any other shape — explicit `objectKeys` is required.\n */\nexport function inferObjectKeys(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  itemsSchema: Record<string, any> | undefined,\n): ObjectKeys | undefined {\n  if (!itemsSchema || itemsSchema.type !== \"object\") return undefined;\n  const required = itemsSchema.required;\n  if (!Array.isArray(required) || required.length !== 2) return undefined;\n  const [a, b] = required as [string, string];\n  const props = (itemsSchema.properties ?? {}) as Record<\n    string,\n    { format?: string }\n  >;\n  const aIsUuid = props[a]?.format === \"uuid\";\n  const bIsUuid = props[b]?.format === \"uuid\";\n  if (aIsUuid && !bIsUuid) return { value: a, label: b };\n  if (bIsUuid && !aIsUuid) return { value: b, label: a };\n  return { value: a, label: b };\n}\n\n/**\n * Resolve the active `objectKeys` for a control: prefer the explicit\n * `uischema.options.objectKeys`, fall back to schema-driven inference.\n * Returns `undefined` when neither is available; the renderer surfaces a\n * runtime error in that case so the consumer knows to be explicit.\n */\nexport function resolveObjectKeys(\n  uischemaOptions: { objectKeys?: { value?: unknown; label?: unknown } } | undefined,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  itemsSchema: Record<string, any> | undefined,\n): ObjectKeys | undefined {\n  const explicit = uischemaOptions?.objectKeys;\n  if (\n    explicit &&\n    typeof explicit.value === \"string\" &&\n    typeof explicit.label === \"string\"\n  ) {\n    return { value: explicit.value, label: explicit.label };\n  }\n  return inferObjectKeys(itemsSchema);\n}\n"],"names":[],"mappings":";AAgCO,SAAS,mBACd,UACA,MACqB;AACrB,MAAI,CAAC,MAAM,QAAQ,QAAQ,UAAU,CAAA;AACrC,SAAO,SACJ,OAAO,CAAC,SAAS,SAAS,QAAQ,OAAO,SAAS,QAAQ,EAC1D,IAAI,CAAC,SAAS;AACb,UAAM,MAAM;AAGZ,QACE,EAAE,KAAK,SAAS,QAChB,EAAE,KAAK,SAAS,QAChB,WAAW,OACX,WAAW,KACX;AACA,aAAO;AAAA,IACT;AACA,WAAO;AAAA,MACL,OAAO,IAAI,KAAK,KAAK;AAAA,MACrB,OAAO,OAAO,IAAI,KAAK,KAAK,MAAM,WAAY,IAAI,KAAK,KAAK,IAAe;AAAA,IAAA;AAAA,EAE/E,CAAC;AACL;AAMO,SAAS,qBACd,WACA,MAC2B;AAC3B,MAAI,CAAC,MAAM,QAAQ,SAAS,UAAU,CAAA;AACtC,SAAO,UACJ,OAAO,CAAC,SAAS,SAAS,QAAQ,OAAO,SAAS,QAAQ,EAC1D,IAAI,CAAC,SAAS;AACb,UAAM,MAAM;AACZ,WAAO;AAAA,MACL,CAAC,KAAK,KAAK,GAAG,IAAI;AAAA,MAClB,CAAC,KAAK,KAAK,GAAG,IAAI;AAAA,IAAA;AAAA,EAEtB,CAAC;AACL;AAOO,SAAS,cACd,GACA,GACA,eACS;AACT,MAAI,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ;AACnE,WAAO;AAAA,EACT;AACA,QAAM,MAAM,IAAI;AAAA,IACd,EACG,OAAO,CAAC,MAAM,MAAM,QAAQ,OAAO,MAAM,QAAQ,EACjD,IAAI,CAAC,MAAO,EAA8B,aAAa,CAAC;AAAA,EAAA;AAE7D,SAAO,EAAE,MAAM,CAAC,MAAM;AACpB,QAAI,MAAM,QAAQ,OAAO,MAAM,SAAU,QAAO;AAChD,WAAO,IAAI,IAAK,EAA8B,aAAa,CAAC;AAAA,EAC9D,CAAC;AACH;AAMO,SAAS,mBAEd,aAEA,YAEiC;AACjC,MAAI,CAAC,eAAe,OAAO,gBAAgB,SAAU,QAAO;AAC5D,QAAM,QAAQ,YAAY;AAC1B,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AAC/D,WAAO;AAAA,EACT;AACA,SAAO,MAAM,OAAO,UAAU;AAChC;AAYO,SAAS,gBAEd,aACwB;AACxB,MAAI,CAAC,eAAe,YAAY,SAAS,SAAU,QAAO;AAC1D,QAAM,WAAW,YAAY;AAC7B,MAAI,CAAC,MAAM,QAAQ,QAAQ,KAAK,SAAS,WAAW,EAAG,QAAO;AAC9D,QAAM,CAAC,GAAG,CAAC,IAAI;AACf,QAAM,QAAS,YAAY,cAAc,CAAA;AAIzC,QAAM,UAAU,MAAM,CAAC,GAAG,WAAW;AACrC,QAAM,UAAU,MAAM,CAAC,GAAG,WAAW;AACrC,MAAI,WAAW,CAAC,QAAS,QAAO,EAAE,OAAO,GAAG,OAAO,EAAA;AACnD,MAAI,WAAW,CAAC,QAAS,QAAO,EAAE,OAAO,GAAG,OAAO,EAAA;AACnD,SAAO,EAAE,OAAO,GAAG,OAAO,EAAA;AAC5B;AAQO,SAAS,kBACd,iBAEA,aACwB;AACxB,QAAM,WAAW,iBAAiB;AAClC,MACE,YACA,OAAO,SAAS,UAAU,YAC1B,OAAO,SAAS,UAAU,UAC1B;AACA,WAAO,EAAE,OAAO,SAAS,OAAO,OAAO,SAAS,MAAA;AAAA,EAClD;AACA,SAAO,gBAAgB,WAAW;AACpC;"}

package/package.json

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

package/src/index.ts

@@ -39,6 +39,7 @@ export {
   ProviderAutocomplete,
   ProviderSelect,
   ProviderMultiSelect,
+  ProviderObjectMultiSelect,
   useProvider,
   createDataLayer,
   useDataLayer,

package/src/vue/components/ProviderObjectMultiSelect.vue

@@ -0,0 +1,169 @@
+<script setup lang="ts">
+import type { ControlElement, JsonSchema } from "@jsonforms/core";
+import { useJsonFormsControl } from "@jsonforms/vue";
+import { computed, inject, watch } from "vue";
+import { useProvider } from "../composables/useProvider";
+import { useProjection } from "../composables/useProjection";
+import { resolvePlaceholder } from "../utils/placeholder";
+import {
+  fromMultiSelectShape,
+  resolveItemsSchema,
+  resolveObjectKeys,
+  sameObjectSet,
+  toMultiSelectShape,
+  type MultiSelectOption,
+  type ObjectKeys,
+} from "../utils/objectMultiSelect";
+import MultiSelect from "primevue/multiselect";
+
+const props = defineProps<{
+  uischema: ControlElement;
+  schema: JsonSchema;
+  path: string;
+}>();
+const { control, handleChange: rawHandleChange } = useJsonFormsControl(props);
+const {
+  projectedData,
+  projectedLabel,
+  handleProjectedChange: handleChange,
+} = useProjection(control, rawHandleChange);
+
+// Pull root schema so item-schema $refs resolve against the consumer's $defs.
+const jsonforms = inject<{
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  core?: { schema?: Record<string, any> };
+} | null>("jsonforms", null);
+const rootSchema = computed(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  () => (jsonforms?.core?.schema ?? control.value.schema) as Record<string, any>,
+);
+
+const itemsSchema = computed(() =>
+  resolveItemsSchema(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    control.value.schema as Record<string, any>,
+    rootSchema.value,
+  ),
+);
+
+const objectKeys = computed<ObjectKeys>(() => {
+  const resolved = resolveObjectKeys(
+    control.value.uischema?.options as
+      | { objectKeys?: { value?: unknown; label?: unknown } }
+      | undefined,
+    itemsSchema.value,
+  );
+  if (!resolved) {
+    throw new Error(
+      "[ProviderObjectMultiSelect] objectKeys could not be resolved. " +
+        "Specify `uischema.options.objectKeys = { value, label }` or declare " +
+        "exactly two `required` properties on the array's items schema so " +
+        "they can be inferred.",
+    );
+  }
+  return resolved;
+});
+
+const binding = computed(() => {
+  const provider = control.value.uischema?.options?.provider;
+  if (provider && typeof provider === "object" && !provider.load) {
+    return { ...provider, load: "mount" };
+  }
+  return provider;
+});
+
+const deps = computed(
+  () =>
+    ((
+      (control.value.schema as Record<string, unknown>)?.[
+        "x-provider"
+      ] as Record<string, unknown>
+    )?.dependsOn as string[]) ?? [],
+);
+const depValues = computed(() => deps.value.map(() => null));
+
+const injectedFormData = inject<{ value: unknown }>("formData", { value: {} });
+const rootData = computed(() => injectedFormData.value || {});
+
+const { items, loading, error } = useProvider(binding, {
+  data: rootData,
+  path: control.value.path,
+  dependsOnValues: depValues,
+});
+
+// Auto-select when provider returns only one item — paired-object variant.
+watch(
+  [items, loading],
+  ([newItems, isLoading]) => {
+    if (
+      !control.value.uischema?.options?.autoSelectSingle ||
+      isLoading ||
+      newItems.length !== 1
+    ) {
+      return;
+    }
+    const single = newItems[0]!;
+    const current = Array.isArray(projectedData.value) ? projectedData.value : [];
+    if (current.length === 0) {
+      handleChange(control.value.path, [
+        {
+          [objectKeys.value.value]: single.value,
+          [objectKeys.value.label]: single.label,
+        },
+      ]);
+    }
+  },
+  { immediate: true },
+);
+
+const value = computed<MultiSelectOption[]>({
+  get() {
+    return toMultiSelectShape(projectedData.value, objectKeys.value);
+  },
+  set(val) {
+    const next = fromMultiSelectShape(val, objectKeys.value);
+    const curr = Array.isArray(projectedData.value) ? projectedData.value : [];
+    if (!sameObjectSet(curr, next, objectKeys.value.value)) {
+      handleChange(control.value.path, next);
+    }
+  },
+});
+
+const placeholder = computed(() => {
+  if (loading.value) return "Loading…";
+  return resolvePlaceholder(
+    control.value.uischema,
+    projectedLabel.value,
+    "select",
+  );
+});
+</script>
+
+<template>
+  <div class="jf-control">
+    <label v-if="projectedLabel" class="jf-label">{{ projectedLabel }}</label>
+    <div v-if="control.description" class="jf-description">
+      {{ control.description }}
+    </div>
+    <MultiSelect
+      v-model="value"
+      class="w-full!"
+      :options="items"
+      option-label="label"
+      data-key="value"
+      display="chip"
+      :placeholder="placeholder"
+      :disabled="!control.enabled || loading"
+      :show-clear="true"
+    />
+    <small v-if="error" class="p-error" role="alert"
+      >Failed to load: {{ error }}</small
+    >
+  </div>
+</template>
+
+<style scoped>
+:deep(.p-multiselect-label) {
+  text-align: left;
+}
+</style>

package/src/vue/index.ts

@@ -9,9 +9,11 @@ import {
   isControl,
 } from "@jsonforms/core";
 import { resolveScopeSchema } from "../core/resolveScope";
+import { resolveItemsSchema } from "./utils/objectMultiSelect";
 import ProviderAutocomplete from "./components/ProviderAutocomplete.vue";
 import ProviderSelect from "./components/ProviderSelect.vue";
 import ProviderMultiSelect from "./components/ProviderMultiSelect.vue";
+import ProviderObjectMultiSelect from "./components/ProviderObjectMultiSelect.vue";
 
 // Custom tester that checks if provider option exists (as object or boolean)
 const hasProvider = (uischema: UISchemaElement) => {
@@ -60,27 +62,62 @@ const providerAutocompleteTester = rankWith(
   ),
 );
 
-// Custom array tester - supports nested scope paths
-const isArrayControl = (uischema: UISchemaElement, schema: unknown) => {
+// Resolve the array schema at a control's scope, or undefined if the
+// control isn't an array. Shared by both array testers below.
+const getArraySchema = (uischema: UISchemaElement, schema: unknown) => {
   const controlSchema = uischema as { type: string; scope?: string };
-  if (controlSchema.type !== "Control" || !controlSchema.scope) {
-    return false;
-  }
-
+  if (controlSchema.type !== "Control" || !controlSchema.scope) return undefined;
   const propertySchema = resolveScopeSchema(
     controlSchema.scope,
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     schema as Record<string, any>,
   );
-  return propertySchema?.type === "array";
+  if (propertySchema?.type !== "array") return undefined;
+  return propertySchema;
+};
+
+// Object-item arrays — render with paired-object MultiSelect.
+const isObjectArrayControl = (uischema: UISchemaElement, schema: unknown) => {
+  const arr = getArraySchema(uischema, schema);
+  if (!arr) return false;
+  const items = resolveItemsSchema(
+    arr,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    schema as Record<string, any>,
+  );
+  return items?.type === "object";
 };
 
+// Scalar-item arrays — the original tester. Excludes object-item arrays so
+// the new ObjectMultiSelect renderer can claim them at a higher rank.
+const isScalarArrayControl = (uischema: UISchemaElement, schema: unknown) => {
+  const arr = getArraySchema(uischema, schema);
+  if (!arr) return false;
+  const items = resolveItemsSchema(
+    arr,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    schema as Record<string, any>,
+  );
+  // Treat unknown / no-items shapes as scalar (matches prior behavior where
+  // any array control was eligible for ProviderMultiSelect).
+  return items?.type !== "object";
+};
+
+const providerObjectMultiSelectTester = rankWith(
+  110, // One higher than scalar multi-select so object-item arrays match first.
+  and(isObjectArrayControl, hasProvider),
+);
+
 const providerMultiSelectTester = rankWith(
-  109, // Highest priority for array controls with providers
-  and(isArrayControl, hasProvider),
+  109,
+  and(isScalarArrayControl, hasProvider),
 );
 
 export const providerRenderers = [
+  {
+    tester: providerObjectMultiSelectTester,
+    renderer: ProviderObjectMultiSelect,
+  },
   { tester: providerMultiSelectTester, renderer: ProviderMultiSelect },
   { tester: providerAutocompleteTester, renderer: ProviderAutocomplete },
   { tester: providerSelectTester, renderer: ProviderSelect },
@@ -90,7 +127,12 @@ export const providerRenderers = [
 export { primevueRenderers, registerPrimevueRenderers } from "./primevue";
 
 // Export individual components
-export { ProviderAutocomplete, ProviderSelect, ProviderMultiSelect };
+export {
+  ProviderAutocomplete,
+  ProviderSelect,
+  ProviderMultiSelect,
+  ProviderObjectMultiSelect,
+};
 export { useProvider } from "./composables/useProvider";
 export { useProjection } from "./composables/useProjection";
 export type { ProjectionResult } from "./composables/useProjection";

package/src/vue/primevue/JfBoolean.vue

@@ -66,16 +66,21 @@ const onToggle = (val: boolean) => {
 </script>
 
 <template>
-  <div class="jf-control" style="flex-direction: row; align-items: center">
-    <Checkbox
-      :binary="true"
-      :model-value="!!projectedData"
-      :disabled="!control.enabled"
-      :class="{ 'p-invalid': showErrors }"
-      :aria-invalid="showErrors || undefined"
-      @update:model-value="onToggle"
-    />
-    <label v-if="projectedLabel" class="jf-label">{{ projectedLabel }}</label>
+  <div class="jf-control">
+    <div style="display: flex; flex-direction: row; align-items: center">
+      <Checkbox
+        :binary="true"
+        :model-value="!!projectedData"
+        :disabled="!control.enabled"
+        :class="{ 'p-invalid': showErrors }"
+        :aria-invalid="showErrors || undefined"
+        @update:model-value="onToggle"
+      />
+      <label v-if="projectedLabel" class="jf-label">{{ projectedLabel }}</label>
+    </div>
+    <div v-if="control.description" class="jf-description">
+      {{ control.description }}
+    </div>
     <small v-if="showErrors" class="p-error">{{ projectedErrors }}</small>
   </div>
 </template>

package/src/vue/utils/objectMultiSelect.ts

@@ -0,0 +1,171 @@
+import { deref } from "../../core/refs";
+
+/**
+ * Helpers for `ProviderObjectMultiSelect`: bidirectional translation between
+ * the form-data shape (paired objects with consumer-named keys) and the
+ * MultiSelect model shape (`{ value, label }` matching the provider's `map`
+ * config), plus `objectKeys` inference when the consumer doesn't specify
+ * them on the uischema.
+ *
+ * Pure functions — no Vue, no rendering — so the renderer can compose them
+ * and tests can exercise the logic in isolation.
+ */
+
+export interface ObjectKeys {
+  /** Property name on the form-data object that holds the identifier. */
+  value: string;
+  /** Property name on the form-data object that holds the display string. */
+  label: string;
+}
+
+export interface MultiSelectOption {
+  value: unknown;
+  label: string;
+  [key: string]: unknown;
+}
+
+/**
+ * Translate form-data items (`[{ [valueKey]: v, [labelKey]: l }]`) into the
+ * shape PrimeVue's `<MultiSelect>` expects (`[{ value, label }]`). Items
+ * already in `{ value, label }` shape pass through; missing keys yield
+ * `undefined` / `""` so the renderer doesn't blow up on partial data.
+ */
+export function toMultiSelectShape(
+  formData: unknown,
+  keys: ObjectKeys,
+): MultiSelectOption[] {
+  if (!Array.isArray(formData)) return [];
+  return formData
+    .filter((item) => item !== null && typeof item === "object")
+    .map((item) => {
+      const obj = item as Record<string, unknown>;
+      // Tolerate already-translated items: if both `value` and `label` are
+      // present and the form-data keys aren't, assume MultiSelect shape.
+      if (
+        !(keys.value in obj) &&
+        !(keys.label in obj) &&
+        "value" in obj &&
+        "label" in obj
+      ) {
+        return obj as MultiSelectOption;
+      }
+      return {
+        value: obj[keys.value],
+        label: typeof obj[keys.label] === "string" ? (obj[keys.label] as string) : "",
+      };
+    });
+}
+
+/**
+ * Inverse of `toMultiSelectShape`. Translates `<MultiSelect>` model items
+ * back into form-data shape using the consumer-specified property names.
+ */
+export function fromMultiSelectShape(
+  modelData: unknown,
+  keys: ObjectKeys,
+): Record<string, unknown>[] {
+  if (!Array.isArray(modelData)) return [];
+  return modelData
+    .filter((item) => item !== null && typeof item === "object")
+    .map((item) => {
+      const obj = item as Record<string, unknown>;
+      return {
+        [keys.value]: obj.value,
+        [keys.label]: obj.label,
+      };
+    });
+}
+
+/**
+ * Order-insensitive equality of two object-shape selections by the
+ * identifier property. Used to short-circuit redundant `handleChange`
+ * calls when the model emits the same selection under reference inequality.
+ */
+export function sameObjectSet(
+  a: unknown,
+  b: unknown,
+  identifierKey: string,
+): boolean {
+  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) {
+    return false;
+  }
+  const ids = new Set(
+    b
+      .filter((x) => x !== null && typeof x === "object")
+      .map((x) => (x as Record<string, unknown>)[identifierKey]),
+  );
+  return a.every((x) => {
+    if (x === null || typeof x !== "object") return false;
+    return ids.has((x as Record<string, unknown>)[identifierKey]);
+  });
+}
+
+/**
+ * Resolve the items schema of an array control, dereferencing `items.$ref`
+ * against the root if present. Returns `undefined` if no items schema exists.
+ */
+export function resolveItemsSchema(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  arraySchema: Record<string, any> | undefined,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  rootSchema: Record<string, any>,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+): Record<string, any> | undefined {
+  if (!arraySchema || typeof arraySchema !== "object") return undefined;
+  const items = arraySchema.items;
+  if (!items || typeof items !== "object" || Array.isArray(items)) {
+    return undefined;
+  }
+  return deref(items, rootSchema);
+}
+
+/**
+ * Infer `objectKeys` from a resolved items schema when the consumer hasn't
+ * specified them on the uischema.
+ *
+ * Strategy: look at `items.required`. If it has exactly two entries, the
+ * one whose property has `format: 'uuid'` becomes `value`; the other
+ * becomes `label`. If neither has a uuid format, the first entry is
+ * `value`, the second is `label`. Returns `undefined` (and the renderer
+ * throws at mount) for any other shape — explicit `objectKeys` is required.
+ */
+export function inferObjectKeys(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  itemsSchema: Record<string, any> | undefined,
+): ObjectKeys | undefined {
+  if (!itemsSchema || itemsSchema.type !== "object") return undefined;
+  const required = itemsSchema.required;
+  if (!Array.isArray(required) || required.length !== 2) return undefined;
+  const [a, b] = required as [string, string];
+  const props = (itemsSchema.properties ?? {}) as Record<
+    string,
+    { format?: string }
+  >;
+  const aIsUuid = props[a]?.format === "uuid";
+  const bIsUuid = props[b]?.format === "uuid";
+  if (aIsUuid && !bIsUuid) return { value: a, label: b };
+  if (bIsUuid && !aIsUuid) return { value: b, label: a };
+  return { value: a, label: b };
+}
+
+/**
+ * Resolve the active `objectKeys` for a control: prefer the explicit
+ * `uischema.options.objectKeys`, fall back to schema-driven inference.
+ * Returns `undefined` when neither is available; the renderer surfaces a
+ * runtime error in that case so the consumer knows to be explicit.
+ */
+export function resolveObjectKeys(
+  uischemaOptions: { objectKeys?: { value?: unknown; label?: unknown } } | undefined,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  itemsSchema: Record<string, any> | undefined,
+): ObjectKeys | undefined {
+  const explicit = uischemaOptions?.objectKeys;
+  if (
+    explicit &&
+    typeof explicit.value === "string" &&
+    typeof explicit.label === "string"
+  ) {
+    return { value: explicit.value, label: explicit.label };
+  }
+  return inferObjectKeys(itemsSchema);
+}