@narrative.io/jsonforms-provider-protocols 3.0.0-beta.4 → 3.0.0-beta.5

package/dist/jsonforms-provider-protocols.css

@@ -1,5 +1,5 @@
 
-[data-v-140d349a] .p-dropdown-label {
+[data-v-310ec8e4] .p-dropdown-label {
   text-align: left;
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"ProviderSelect.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/components/ProviderSelect.vue"],"names":[],"mappings":"AAoHA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQlE,KAAK,WAAW,GAAG;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;;AAgLF,wBAEG"}
+{"version":3,"file":"ProviderSelect.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/components/ProviderSelect.vue"],"names":[],"mappings":"AAwHA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AASlE,KAAK,WAAW,GAAG;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;;AAmLF,wBAEG"}

package/dist/vue/components/ProviderSelect.vue.js

@@ -1,7 +1,7 @@
 import _sfc_main from "./ProviderSelect.vue2.js";
 /* empty css                    */
 import _export_sfc from "../../_virtual/_plugin-vue_export-helper.js";
-const ProviderSelect = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-140d349a"]]);
+const ProviderSelect = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-310ec8e4"]]);
 export {
   ProviderSelect as default
 };

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

@@ -1,6 +1,7 @@
 import { defineComponent, computed, inject, watch, createElementBlock, openBlock, createCommentVNode, createVNode, unref, toDisplayString } from "vue";
 import { useJsonFormsControl } from "@jsonforms/vue";
 import { useProvider } from "../composables/useProvider.js";
+import { useDeriveInitialValue } from "../composables/useDeriveInitialValue.js";
 import { useProjection } from "../composables/useProjection.js";
 import { shouldAutoSelect } from "../utils/autoSelect.js";
 import Dropdown from "primevue/dropdown";
@@ -51,6 +52,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       path: control.value.path,
       dependsOnValues: depValues.value
     });
+    useDeriveInitialValue({ control, handleChange });
     watch(
       [items, loading],
       ([newItems, isLoading]) => {

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

@@ -1 +1 @@
-{"version":3,"file":"ProviderSelect.vue2.js","sources":["../../../src/vue/components/ProviderSelect.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 { shouldAutoSelect } from \"../utils/autoSelect\";\nimport Dropdown from \"primevue/dropdown\";\n\nconst props = defineProps<{\n  uischema: ControlElement;\n  schema: JsonSchema;\n  path: string;\n}>();\nconst { control, handleChange: rawHandleChange } = useJsonFormsControl(props);\nconst { projectedData, handleProjectedChange: handleChange } = useProjection(\n  control,\n  rawHandleChange,\n);\n\nconst binding = computed(() => {\n  const provider = control.value.uischema?.options?.provider;\n  // Ensure load property is set to 'mount' by default\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)); // you can resolve actual values via control.value.data & pointers\n\n// Get the root form data from JSONForms context for template URL resolution\nconst injectedFormData = inject<{ value: unknown }>(\"formData\", { value: {} });\nconst rootData = computed(() => injectedFormData.value || {});\n\nconst { items, loading, error } = useProvider(binding, {\n  data: rootData, // Pass the reactive reference\n  path: control.value.path,\n  dependsOnValues: depValues.value,\n});\n\n// Provider will automatically reload when rootData changes due to reactive cache key\n\n// Auto-select when provider returns only one item (enabled by default)\nwatch(\n  [items, loading],\n  ([newItems, isLoading]) => {\n    const valueToSelect = shouldAutoSelect({\n      autoSelectSingle:\n        control.value.uischema?.options?.autoSelectSingle !== false,\n      isLoading,\n      items: newItems,\n      currentValue: projectedData.value,\n    });\n\n    if (valueToSelect !== null) {\n      handleChange(control.value.path, valueToSelect);\n    }\n  },\n  { immediate: true },\n);\n\nconst value = computed({\n  get: () => projectedData.value,\n  set: (v) => handleChange(control.value.path, v),\n});\n\nconst placeholder = computed(() => {\n  if (loading.value) return \"Loading…\";\n  // Check for placeholder in uischema options\n  const uischemaPlaceholder = (\n    control.value.uischema as { options?: { placeholder?: string } }\n  )?.options?.placeholder;\n  return uischemaPlaceholder || \"Select…\";\n});\n</script>\n\n<template>\n  <div class=\"jf-control\">\n    <label v-if=\"control.schema.title\" class=\"jf-label\">{{\n      control.schema.title\n    }}</label>\n    <div v-if=\"control.description\" class=\"jf-description\">\n      {{ control.description }}\n    </div>\n    <Dropdown\n      v-model=\"value\"\n      class=\"w-full!\"\n      :options=\"items\"\n      option-label=\"label\"\n      option-value=\"value\"\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-dropdown-label) {\n  text-align: left;\n}\n</style>\n"],"names":["_openBlock","_createElementBlock","_unref","_toDisplayString","_createVNode"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,UAAM,QAAQ;AAKd,UAAM,EAAE,SAAS,cAAc,gBAAA,IAAoB,oBAAoB,KAAK;AAC5E,UAAM,EAAE,eAAe,uBAAuB,aAAA,IAAiB;AAAA,MAC7D;AAAA,MACA;AAAA,IAAA;AAGF,UAAM,UAAU,SAAS,MAAM;AAC7B,YAAM,WAAW,QAAQ,MAAM,UAAU,SAAS;AAElD,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;AAG3D,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;AAAA,MACN,MAAM,QAAQ,MAAM;AAAA,MACpB,iBAAiB,UAAU;AAAA,IAAA,CAC5B;AAKD;AAAA,MACE,CAAC,OAAO,OAAO;AAAA,MACf,CAAC,CAAC,UAAU,SAAS,MAAM;AACzB,cAAM,gBAAgB,iBAAiB;AAAA,UACrC,kBACE,QAAQ,MAAM,UAAU,SAAS,qBAAqB;AAAA,UACxD;AAAA,UACA,OAAO;AAAA,UACP,cAAc,cAAc;AAAA,QAAA,CAC7B;AAED,YAAI,kBAAkB,MAAM;AAC1B,uBAAa,QAAQ,MAAM,MAAM,aAAa;AAAA,QAChD;AAAA,MACF;AAAA,MACA,EAAE,WAAW,KAAA;AAAA,IAAK;AAGpB,UAAM,QAAQ,SAAS;AAAA,MACrB,KAAK,MAAM,cAAc;AAAA,MACzB,KAAK,CAAC,MAAM,aAAa,QAAQ,MAAM,MAAM,CAAC;AAAA,IAAA,CAC/C;AAED,UAAM,cAAc,SAAS,MAAM;AACjC,UAAI,QAAQ,MAAO,QAAO;AAE1B,YAAM,sBACJ,QAAQ,MAAM,UACb,SAAS;AACZ,aAAO,uBAAuB;AAAA,IAChC,CAAC;;AAIC,aAAAA,UAAA,GAAAC,mBAoBM,OApBN,YAoBM;AAAA,QAnBSC,MAAA,OAAA,EAAQ,OAAO,SAA5BF,aAAAC,mBAEU,SAFV,YAEUE,gBADRD,eAAQ,OAAO,KAAK,GAAA,CAAA;QAEXA,MAAA,OAAA,EAAQ,eAAnBF,UAAA,GAAAC,mBAEM,OAFN,YAEME,gBADDD,MAAA,OAAA,EAAQ,WAAW,GAAA,CAAA;QAExBE,YASEF,MAAA,QAAA,GAAA;AAAA,sBARS,MAAA;AAAA,uEAAA,MAAK,QAAA;AAAA,UACd,OAAM;AAAA,UACL,SAASA,MAAA,KAAA;AAAA,UACV,gBAAa;AAAA,UACb,gBAAa;AAAA,UACZ,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;;;;;"}
+{"version":3,"file":"ProviderSelect.vue2.js","sources":["../../../src/vue/components/ProviderSelect.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 { useDeriveInitialValue } from \"../composables/useDeriveInitialValue\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { shouldAutoSelect } from \"../utils/autoSelect\";\nimport Dropdown from \"primevue/dropdown\";\n\nconst props = defineProps<{\n  uischema: ControlElement;\n  schema: JsonSchema;\n  path: string;\n}>();\nconst { control, handleChange: rawHandleChange } = useJsonFormsControl(props);\nconst { projectedData, handleProjectedChange: handleChange } = useProjection(\n  control,\n  rawHandleChange,\n);\n\nconst binding = computed(() => {\n  const provider = control.value.uischema?.options?.provider;\n  // Ensure load property is set to 'mount' by default\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)); // you can resolve actual values via control.value.data & pointers\n\n// Get the root form data from JSONForms context for template URL resolution\nconst injectedFormData = inject<{ value: unknown }>(\"formData\", { value: {} });\nconst rootData = computed(() => injectedFormData.value || {});\n\nconst { items, loading, error } = useProvider(binding, {\n  data: rootData, // Pass the reactive reference\n  path: control.value.path,\n  dependsOnValues: depValues.value,\n});\n\n// Provider will automatically reload when rootData changes due to reactive cache key\n\n// deriveInitialValue — async API-based initial value seeding\nuseDeriveInitialValue({ control, handleChange });\n\n// Auto-select when provider returns only one item (enabled by default)\nwatch(\n  [items, loading],\n  ([newItems, isLoading]) => {\n    const valueToSelect = shouldAutoSelect({\n      autoSelectSingle:\n        control.value.uischema?.options?.autoSelectSingle !== false,\n      isLoading,\n      items: newItems,\n      currentValue: projectedData.value,\n    });\n\n    if (valueToSelect !== null) {\n      handleChange(control.value.path, valueToSelect);\n    }\n  },\n  { immediate: true },\n);\n\nconst value = computed({\n  get: () => projectedData.value,\n  set: (v) => handleChange(control.value.path, v),\n});\n\nconst placeholder = computed(() => {\n  if (loading.value) return \"Loading…\";\n  // Check for placeholder in uischema options\n  const uischemaPlaceholder = (\n    control.value.uischema as { options?: { placeholder?: string } }\n  )?.options?.placeholder;\n  return uischemaPlaceholder || \"Select…\";\n});\n</script>\n\n<template>\n  <div class=\"jf-control\">\n    <label v-if=\"control.schema.title\" class=\"jf-label\">{{\n      control.schema.title\n    }}</label>\n    <div v-if=\"control.description\" class=\"jf-description\">\n      {{ control.description }}\n    </div>\n    <Dropdown\n      v-model=\"value\"\n      class=\"w-full!\"\n      :options=\"items\"\n      option-label=\"label\"\n      option-value=\"value\"\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-dropdown-label) {\n  text-align: left;\n}\n</style>\n"],"names":["_openBlock","_createElementBlock","_unref","_toDisplayString","_createVNode"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,UAAM,QAAQ;AAKd,UAAM,EAAE,SAAS,cAAc,gBAAA,IAAoB,oBAAoB,KAAK;AAC5E,UAAM,EAAE,eAAe,uBAAuB,aAAA,IAAiB;AAAA,MAC7D;AAAA,MACA;AAAA,IAAA;AAGF,UAAM,UAAU,SAAS,MAAM;AAC7B,YAAM,WAAW,QAAQ,MAAM,UAAU,SAAS;AAElD,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;AAG3D,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;AAAA,MACN,MAAM,QAAQ,MAAM;AAAA,MACpB,iBAAiB,UAAU;AAAA,IAAA,CAC5B;AAKD,0BAAsB,EAAE,SAAS,cAAc;AAG/C;AAAA,MACE,CAAC,OAAO,OAAO;AAAA,MACf,CAAC,CAAC,UAAU,SAAS,MAAM;AACzB,cAAM,gBAAgB,iBAAiB;AAAA,UACrC,kBACE,QAAQ,MAAM,UAAU,SAAS,qBAAqB;AAAA,UACxD;AAAA,UACA,OAAO;AAAA,UACP,cAAc,cAAc;AAAA,QAAA,CAC7B;AAED,YAAI,kBAAkB,MAAM;AAC1B,uBAAa,QAAQ,MAAM,MAAM,aAAa;AAAA,QAChD;AAAA,MACF;AAAA,MACA,EAAE,WAAW,KAAA;AAAA,IAAK;AAGpB,UAAM,QAAQ,SAAS;AAAA,MACrB,KAAK,MAAM,cAAc;AAAA,MACzB,KAAK,CAAC,MAAM,aAAa,QAAQ,MAAM,MAAM,CAAC;AAAA,IAAA,CAC/C;AAED,UAAM,cAAc,SAAS,MAAM;AACjC,UAAI,QAAQ,MAAO,QAAO;AAE1B,YAAM,sBACJ,QAAQ,MAAM,UACb,SAAS;AACZ,aAAO,uBAAuB;AAAA,IAChC,CAAC;;AAIC,aAAAA,UAAA,GAAAC,mBAoBM,OApBN,YAoBM;AAAA,QAnBSC,MAAA,OAAA,EAAQ,OAAO,SAA5BF,aAAAC,mBAEU,SAFV,YAEUE,gBADRD,eAAQ,OAAO,KAAK,GAAA,CAAA;QAEXA,MAAA,OAAA,EAAQ,eAAnBF,UAAA,GAAAC,mBAEM,OAFN,YAEME,gBADDD,MAAA,OAAA,EAAQ,WAAW,GAAA,CAAA;QAExBE,YASEF,MAAA,QAAA,GAAA;AAAA,sBARS,MAAA;AAAA,uEAAA,MAAK,QAAA;AAAA,UACd,OAAM;AAAA,UACL,SAASA,MAAA,KAAA;AAAA,UACV,gBAAa;AAAA,UACb,gBAAa;AAAA,UACZ,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/composables/useDeriveInitialValue.d.ts

@@ -0,0 +1,36 @@
+import { type Ref, type ComputedRef } from "vue";
+import { type ControlElement } from "@jsonforms/core";
+import { type TransformPipeline } from "../../core/transforms";
+import type { AuthConfig } from "../../core/types";
+export interface DeriveInitialValueCfg {
+    protocol: string;
+    config: {
+        url: string;
+        method?: "GET" | "POST";
+        headers?: Record<string, string>;
+        query?: Record<string, unknown>;
+        body?: unknown;
+        auth?: AuthConfig;
+        items: string;
+        map: {
+            value: string;
+        };
+        transforms?: TransformPipeline;
+        showError?: boolean;
+    };
+}
+interface DeriveInitialValueOptions {
+    control: Ref<{
+        uischema: ControlElement;
+        path: string;
+        data: unknown;
+    }>;
+    handleChange: (path: string, value: unknown) => void;
+    data?: Ref<unknown> | ComputedRef<unknown>;
+}
+export declare function useDeriveInitialValue({ control, handleChange, }: DeriveInitialValueOptions): {
+    loading: Ref<boolean, boolean>;
+    error: Ref<string | undefined, string | undefined>;
+};
+export {};
+//# sourceMappingURL=useDeriveInitialValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDeriveInitialValue.d.ts","sourceRoot":"","sources":["../../../src/vue/composables/useDeriveInitialValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,GAAG,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAC/E,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACvB,UAAU,CAAC,EAAE,iBAAiB,CAAC;QAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAED,UAAU,yBAAyB;IACjC,OAAO,EAAE,GAAG,CAAC;QACX,QAAQ,EAAE,cAAc,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC;KACf,CAAC,CAAC;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;CAC5C;AAsDD,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,YAAY,GACb,EAAE,yBAAyB;;;EAuG3B"}

package/dist/vue/composables/useDeriveInitialValue.js

@@ -0,0 +1,125 @@
+import { inject, computed, ref, watch } from "vue";
+import "@jsonforms/core";
+import { renderTpl, renderObj } from "../../core/templating.js";
+import { jp } from "../../core/jsonpath.js";
+import { applyTransformPipeline } from "../../core/transforms.js";
+function buildAuthHeaders(auth, globalAuth) {
+  const headers = {};
+  if (!auth) return headers;
+  if (auth.use && globalAuth?.[auth.use]) {
+    const globalValue = globalAuth[auth.use];
+    const value = typeof globalValue === "function" ? globalValue() : globalValue;
+    if (auth.use === "apiKey") headers["X-API-Key"] = String(value);
+    else if (auth.use === "bearer")
+      headers["Authorization"] = `Bearer ${value}`;
+    else if (auth.use === "token") headers["Authorization"] = `Token ${value}`;
+    return headers;
+  }
+  if (auth.bearer) {
+    const v = typeof auth.bearer === "function" ? auth.bearer() : auth.bearer;
+    headers["Authorization"] = `Bearer ${v}`;
+  }
+  if (auth.apiKey) {
+    const v = typeof auth.apiKey === "function" ? auth.apiKey() : auth.apiKey;
+    headers["X-API-Key"] = String(v);
+  }
+  if (auth.token) {
+    const v = typeof auth.token === "function" ? auth.token() : auth.token;
+    headers["Authorization"] = `Token ${v}`;
+  }
+  return headers;
+}
+function hasUnresolvedTemplates(templateUrl, renderedUrl) {
+  if (!templateUrl.includes("{{")) return false;
+  const pathPart = renderedUrl.replace(/^https?:\/\/[^/]+/, "");
+  if (pathPart.includes("//")) return true;
+  if (renderedUrl.endsWith("/") && !templateUrl.endsWith("/")) return true;
+  return false;
+}
+function useDeriveInitialValue({
+  control,
+  handleChange
+}) {
+  const injectedFormData = inject("formData", {
+    value: {}
+  });
+  const rootData = computed(() => injectedFormData.value || {});
+  const auth = inject("providerAuth", {});
+  const cfg = computed(() => {
+    return control.value.uischema?.options?.deriveInitialValue;
+  });
+  const resolvedUrl = computed(() => {
+    const c = cfg.value;
+    if (!c?.config?.url) return null;
+    const rendered = renderTpl(c.config.url, { data: rootData.value });
+    if (hasUnresolvedTemplates(c.config.url, rendered)) return null;
+    return rendered;
+  });
+  const lastFetchedUrl = ref(null);
+  const loading = ref(false);
+  const error = ref(void 0);
+  watch(
+    resolvedUrl,
+    async (url) => {
+      if (!url || !cfg.value) return;
+      if (url === lastFetchedUrl.value) return;
+      lastFetchedUrl.value = url;
+      loading.value = true;
+      error.value = void 0;
+      try {
+        const c = cfg.value.config;
+        const fullUrl = new URL(url);
+        const q = renderObj(c.query ?? {}, {
+          data: rootData.value
+        });
+        for (const [k, v] of Object.entries(q)) {
+          if (v !== void 0 && v !== "")
+            fullUrl.searchParams.set(k, String(v));
+        }
+        const baseHeaders = renderObj(c.headers ?? {}, {
+          data: rootData.value
+        });
+        const authHeaders = buildAuthHeaders(c.auth, auth);
+        const headers = { ...baseHeaders, ...authHeaders };
+        const method = c.method ?? "GET";
+        const requestInit = { method, headers };
+        if (method !== "GET" && c.body) {
+          requestInit.body = JSON.stringify(
+            renderObj(c.body, { data: rootData.value })
+          );
+        }
+        const res = await fetch(fullUrl.toString(), requestInit);
+        if (!res.ok) {
+          if (c.showError !== false) {
+            throw new Error(`REST ${res.status}`);
+          }
+          return;
+        }
+        const json = await res.json();
+        let items = jp(json, c.items);
+        if (c.transforms && c.transforms.length > 0) {
+          items = applyTransformPipeline(items, c.transforms);
+        }
+        if (items.length === 0) return;
+        const derivedValue = jp(items[0], c.map.value)[0];
+        if (derivedValue !== void 0) {
+          handleChange(control.value.path, derivedValue);
+        }
+      } catch (e) {
+        error.value = e?.message ?? String(e);
+        console.warn(
+          `deriveInitialValue fetch failed for ${control.value.path}:`,
+          e
+        );
+      } finally {
+        loading.value = false;
+      }
+    },
+    { immediate: true }
+  );
+  return { loading, error };
+}
+export {
+  useDeriveInitialValue
+};
+//# sourceMappingURL=useDeriveInitialValue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDeriveInitialValue.js","sources":["../../../src/vue/composables/useDeriveInitialValue.ts"],"sourcesContent":["import { computed, inject, ref, watch, type Ref, type ComputedRef } from \"vue\";\nimport { type ControlElement } from \"@jsonforms/core\";\nimport { renderTpl, renderObj } from \"../../core/templating\";\nimport { jp } from \"../../core/jsonpath\";\nimport {\n  applyTransformPipeline,\n  type TransformPipeline,\n} from \"../../core/transforms\";\nimport type { AuthConfig } from \"../../core/types\";\n\nexport interface DeriveInitialValueCfg {\n  protocol: string;\n  config: {\n    url: string;\n    method?: \"GET\" | \"POST\";\n    headers?: Record<string, string>;\n    query?: Record<string, unknown>;\n    body?: unknown;\n    auth?: AuthConfig;\n    items: string;\n    map: { value: string };\n    transforms?: TransformPipeline;\n    showError?: boolean;\n  };\n}\n\ninterface DeriveInitialValueOptions {\n  control: Ref<{\n    uischema: ControlElement;\n    path: string;\n    data: unknown;\n  }>;\n  handleChange: (path: string, value: unknown) => void;\n  data?: Ref<unknown> | ComputedRef<unknown>;\n}\n\nfunction buildAuthHeaders(\n  auth?: AuthConfig,\n  globalAuth?: Record<string, unknown>,\n): Record<string, string> {\n  const headers: Record<string, string> = {};\n  if (!auth) return headers;\n\n  if (auth.use && globalAuth?.[auth.use]) {\n    const globalValue = globalAuth[auth.use];\n    const value =\n      typeof globalValue === \"function\" ? globalValue() : globalValue;\n    if (auth.use === \"apiKey\") headers[\"X-API-Key\"] = String(value);\n    else if (auth.use === \"bearer\")\n      headers[\"Authorization\"] = `Bearer ${value}`;\n    else if (auth.use === \"token\") headers[\"Authorization\"] = `Token ${value}`;\n    return headers;\n  }\n\n  if (auth.bearer) {\n    const v = typeof auth.bearer === \"function\" ? auth.bearer() : auth.bearer;\n    headers[\"Authorization\"] = `Bearer ${v}`;\n  }\n  if (auth.apiKey) {\n    const v = typeof auth.apiKey === \"function\" ? auth.apiKey() : auth.apiKey;\n    headers[\"X-API-Key\"] = String(v);\n  }\n  if (auth.token) {\n    const v = typeof auth.token === \"function\" ? auth.token() : auth.token;\n    headers[\"Authorization\"] = `Token ${v}`;\n  }\n\n  return headers;\n}\n\n/**\n * Returns true when the template URL contains `{{…}}` placeholders but\n * one or more of those placeholders resolved to an empty string, which\n * means a required data dependency hasn't been set yet.\n */\nfunction hasUnresolvedTemplates(\n  templateUrl: string,\n  renderedUrl: string,\n): boolean {\n  if (!templateUrl.includes(\"{{\")) return false;\n  // After protocol, empty segments indicate unresolved vars\n  const pathPart = renderedUrl.replace(/^https?:\\/\\/[^/]+/, \"\");\n  if (pathPart.includes(\"//\")) return true;\n  // Trailing slash when the template didn't have one\n  if (renderedUrl.endsWith(\"/\") && !templateUrl.endsWith(\"/\")) return true;\n  return false;\n}\n\nexport function useDeriveInitialValue({\n  control,\n  handleChange,\n}: DeriveInitialValueOptions) {\n  const injectedFormData = inject<{ value: unknown }>(\"formData\", {\n    value: {},\n  });\n  const rootData = computed(() => injectedFormData.value || {});\n  const auth = inject(\"providerAuth\", {}) as Record<string, unknown>;\n\n  const cfg = computed<DeriveInitialValueCfg | undefined>(() => {\n    return control.value.uischema?.options?.deriveInitialValue as\n      | DeriveInitialValueCfg\n      | undefined;\n  });\n\n  // Compute the resolved URL reactively\n  const resolvedUrl = computed<string | null>(() => {\n    const c = cfg.value;\n    if (!c?.config?.url) return null;\n    const rendered = renderTpl(c.config.url, { data: rootData.value });\n    if (hasUnresolvedTemplates(c.config.url, rendered)) return null;\n    return rendered;\n  });\n\n  const lastFetchedUrl = ref<string | null>(null);\n  const loading = ref(false);\n  const error = ref<string | undefined>(undefined);\n\n  watch(\n    resolvedUrl,\n    async (url) => {\n      if (!url || !cfg.value) return;\n      // Only fetch when the URL changes (new context).\n      // Same URL = same context; don't override user selection.\n      if (url === lastFetchedUrl.value) return;\n      lastFetchedUrl.value = url;\n\n      loading.value = true;\n      error.value = undefined;\n\n      try {\n        const c = cfg.value.config;\n        const fullUrl = new URL(url);\n\n        // Query params\n        const q = renderObj(c.query ?? {}, {\n          data: rootData.value,\n        }) as Record<string, unknown>;\n        for (const [k, v] of Object.entries(q)) {\n          if (v !== undefined && v !== \"\")\n            fullUrl.searchParams.set(k, String(v));\n        }\n\n        // Headers\n        const baseHeaders = renderObj(c.headers ?? {}, {\n          data: rootData.value,\n        }) as Record<string, string>;\n        const authHeaders = buildAuthHeaders(c.auth, auth);\n        const headers = { ...baseHeaders, ...authHeaders };\n\n        const method = c.method ?? \"GET\";\n        const requestInit: RequestInit = { method, headers };\n        if (method !== \"GET\" && c.body) {\n          requestInit.body = JSON.stringify(\n            renderObj(c.body, { data: rootData.value }),\n          );\n        }\n\n        const res = await fetch(fullUrl.toString(), requestInit);\n        if (!res.ok) {\n          if (c.showError !== false) {\n            throw new Error(`REST ${res.status}`);\n          }\n          return;\n        }\n\n        const json = await res.json();\n        let items = jp(json, c.items);\n\n        // Apply transforms if provided\n        if (c.transforms && c.transforms.length > 0) {\n          items = applyTransformPipeline(items, c.transforms);\n        }\n\n        if (items.length === 0) return; // No items → leave field empty\n\n        // Extract value from first item\n        const derivedValue = jp(items[0], c.map.value)[0];\n        if (derivedValue !== undefined) {\n          handleChange(control.value.path, derivedValue);\n        }\n      } catch (e) {\n        error.value = (e as Error)?.message ?? String(e);\n        console.warn(\n          `deriveInitialValue fetch failed for ${control.value.path}:`,\n          e,\n        );\n      } finally {\n        loading.value = false;\n      }\n    },\n    { immediate: true },\n  );\n\n  return { loading, error };\n}\n"],"names":[],"mappings":"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"}

package/dist/vue/index.d.ts

@@ -21,6 +21,8 @@ export { useProjection } from "./composables/useProjection";
 export type { ProjectionResult } from "./composables/useProjection";
 export { createDataLayer, useDataLayer } from "./composables/useDataLayer";
 export type { DataLayer } from "./composables/useDataLayer";
+export { useDeriveInitialValue } from "./composables/useDeriveInitialValue";
+export type { DeriveInitialValueCfg } from "./composables/useDeriveInitialValue";
 export { useDirtyValidation } from "./composables/useDirtyValidation";
 export * from "./testers";
 export { JfText, JfTextArea, JfNumber, JfEnum, JfEnumArray, JfBoolean, } from "./primevue";

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;AAUvD,OAAO,oBAAoB,MAAM,uCAAuC,CAAC;AACzE,OAAO,cAAc,MAAM,iCAAiC,CAAC;AAC7D,OAAO,mBAAmB,MAAM,sCAAsC,CAAC;AA2DvE,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,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;AAUvD,OAAO,oBAAoB,MAAM,uCAAuC,CAAC;AACzE,OAAO,cAAc,MAAM,iCAAiC,CAAC;AAC7D,OAAO,mBAAmB,MAAM,sCAAsC,CAAC;AA2DvE,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"}

package/dist/vue/index.js

@@ -7,6 +7,7 @@ import { primevueRenderers, registerPrimevueRenderers } from "./primevue/index.j
 import { useProvider } from "./composables/useProvider.js";
 import { useProjection } from "./composables/useProjection.js";
 import { createDataLayer, useDataLayer } from "./composables/useDataLayer.js";
+import { useDeriveInitialValue } from "./composables/useDeriveInitialValue.js";
 import { useDirtyValidation } from "./composables/useDirtyValidation.js";
 import { providerTester } from "./testers.js";
 import { default as default2 } from "./primevue/JfText.vue.js";
@@ -84,6 +85,7 @@ export {
   providerTester,
   registerPrimevueRenderers,
   useDataLayer,
+  useDeriveInitialValue,
   useDirtyValidation,
   useProjection,
   useProvider

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  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  106, // Higher than PrimeVue base (100) to ensure providers take precedence\n  and(\n    or(isStringControl, isNumberControl, and(isControl, isIntegerScope)),\n    hasProvider,\n    (uischema) => !uischema?.options?.autocomplete,\n  ),\n);\n\nconst providerAutocompleteTester = rankWith(\n  107, // Higher than PrimeVue base (100) to ensure providers take precedence\n  and(\n    or(isStringControl, isNumberControl, and(isControl, isIntegerScope)),\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  108, // 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 { 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":";;;;;;;;;;;;;;;;;AAeA,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,GAAG,iBAAiB,iBAAiB,IAAI,WAAW,cAAc,CAAC;AAAA,IACnE;AAAA,IACA,CAAC,aAAa,CAAC,UAAU,SAAS;AAAA,EAAA;AAEtC;AAEA,MAAM,6BAA6B;AAAA,EACjC;AAAA;AAAA,EACA;AAAA,IACE,GAAG,iBAAiB,iBAAiB,IAAI,WAAW,cAAc,CAAC;AAAA,IACnE;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  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  106, // Higher than PrimeVue base (100) to ensure providers take precedence\n  and(\n    or(isStringControl, isNumberControl, and(isControl, isIntegerScope)),\n    hasProvider,\n    (uischema) => !uischema?.options?.autocomplete,\n  ),\n);\n\nconst providerAutocompleteTester = rankWith(\n  107, // Higher than PrimeVue base (100) to ensure providers take precedence\n  and(\n    or(isStringControl, isNumberControl, and(isControl, isIntegerScope)),\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  108, // 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":";;;;;;;;;;;;;;;;;;AAeA,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,GAAG,iBAAiB,iBAAiB,IAAI,WAAW,cAAc,CAAC;AAAA,IACnE;AAAA,IACA,CAAC,aAAa,CAAC,UAAU,SAAS;AAAA,EAAA;AAEtC;AAEA,MAAM,6BAA6B;AAAA,EACjC;AAAA;AAAA,EACA;AAAA,IACE,GAAG,iBAAiB,iBAAiB,IAAI,WAAW,cAAc,CAAC;AAAA,IACnE;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;"}

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

@@ -1 +1 @@
-{"version":3,"file":"JfEnum.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfEnum.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwNA,wBAqUK"}
+{"version":3,"file":"JfEnum.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfEnum.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6NA,wBAwUK"}

package/dist/vue/primevue/JfEnum.vue.js

@@ -2,6 +2,7 @@ import { defineComponent, getCurrentInstance, computed, inject, watch, createEle
 import { useJsonFormsControl } from "@jsonforms/vue";
 import { useProvider } from "../composables/useProvider.js";
 import { useDerive } from "../composables/useDerive.js";
+import { useDeriveInitialValue } from "../composables/useDeriveInitialValue.js";
 import { useProjection } from "../composables/useProjection.js";
 import { useDirtyValidation } from "../composables/useDirtyValidation.js";
 import { shouldAutoSelect } from "../utils/autoSelect.js";
@@ -131,6 +132,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       return toOptions(control.value.schema);
     });
     useDerive({ control, handleChange, data: projectedData });
+    useDeriveInitialValue({ control, handleChange });
     watch(
       [providerItems, loading],
       ([items, isLoading]) => {

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

@@ -1 +1 @@
-{"version":3,"file":"JfEnum.vue.js","sources":["../../../src/vue/primevue/JfEnum.vue"],"sourcesContent":["<script lang=\"ts\">\n// Define props manually to avoid any potential circular dependency issues\nexport default {\n  name: \"JfEnum\",\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 { JsonSchema } from \"@jsonforms/core\";\nimport type { ControlProps } from \"@jsonforms/vue\";\nimport { useJsonFormsControl } from \"@jsonforms/vue\";\nimport { computed, inject, getCurrentInstance, watch } from \"vue\";\nimport { useProvider } from \"../composables/useProvider\";\nimport { useDerive } from \"../composables/useDerive\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { useDirtyValidation } from \"../composables/useDirtyValidation\";\nimport { shouldAutoSelect } from \"../utils/autoSelect\";\nimport Dropdown from \"primevue/dropdown\";\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\ntype Opt = { label: string; value: unknown };\nconst toOptions = (schema?: JsonSchema): Opt[] => {\n  if (!schema) return [];\n  const s = schema as {\n    enum?: unknown[];\n    oneOf?: Array<{ title?: string; const: unknown }>;\n  };\n  if (Array.isArray(s.enum))\n    return s.enum.map((v: unknown) => ({ label: String(v), value: v }));\n  if (Array.isArray(s.oneOf))\n    return s.oneOf.map((o) => ({\n      label: o.title ?? String(o.const),\n      value: o.const,\n    }));\n  return [];\n};\n\n// Provider support\nconst binding = computed(() => {\n  const provider = control.value.uischema?.options?.provider;\n  // Ensure load property is set to 'mount' by default\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(() => {\n  return deps.value.map((dep) => {\n    // Resolve dependency value from form data using JSON pointer-like path\n    const path = dep.startsWith(\"#/\") ? dep.slice(2) : dep;\n    const keys = path.replace(/\\//g, \".\").split(\".\");\n    let value: unknown = rootData.value;\n    for (const key of keys) {\n      if (value && typeof value === \"object\" && key in value) {\n        value = (value as Record<string, unknown>)[key];\n      } else {\n        return null;\n      }\n    }\n    return value;\n  });\n});\n\n// Get the root form data from JSONForms context for template URL resolution\nconst injectedFormData = inject<{ value: unknown }>(\"formData\", { value: {} });\nconst rootData = computed(() => injectedFormData.value || {});\n\n// Use provider if available, otherwise fall back to schema enum/oneOf\nconst {\n  items: providerItems,\n  loading,\n  error,\n} = useProvider(binding, {\n  data: rootData,\n  path: control.value.path,\n  dependsOnValues: depValues.value,\n});\n\nconst placeholder = computed<string | undefined>(() => {\n  if (loading.value) return \"Loading…\";\n  return (\n    (control.value.uischema as { options?: { placeholder?: string } })?.options\n      ?.placeholder ?? control.value.description\n  );\n});\n\nconst options = computed(() => {\n  // Use provider items if available, otherwise fall back to schema enum/oneOf\n  if (binding.value && providerItems.value.length > 0) {\n    return providerItems.value;\n  }\n  return toOptions(control.value.schema);\n});\n\n// Add derive functionality\nuseDerive({ control, handleChange, data: projectedData });\n\n// Auto-select when provider returns only one item (enabled by default)\nwatch(\n  [providerItems, loading],\n  ([items, isLoading]) => {\n    const valueToSelect = shouldAutoSelect({\n      autoSelectSingle:\n        control.value.uischema?.options?.autoSelectSingle !== false,\n      isLoading,\n      items,\n      currentValue: projectedData.value,\n    });\n\n    if (valueToSelect !== null) {\n      handleChange(control.value.path, valueToSelect);\n    }\n  },\n  { immediate: true },\n);\n\n// Track user interaction — errors only show after blur\nconst { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);\n\nconst onSelect = (val: unknown) => {\n  handleChange(control.value.path, val);\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    <Dropdown\n      :class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :options=\"options\"\n      option-label=\"label\"\n      option-value=\"value\"\n      :model-value=\"projectedData ?? null\"\n      :placeholder=\"placeholder\"\n      :disabled=\"!control.enabled || loading\"\n      :aria-invalid=\"showErrors || undefined\"\n      :show-clear=\"true\"\n      @update:model-value=\"onSelect\"\n      @blur=\"markDirty\"\n    />\n    <small v-if=\"error\" class=\"p-error\" role=\"alert\"\n      >Failed to load: {{ error }}</small\n    >\n    <small v-else-if=\"showErrors\" class=\"p-error\">{{ projectedErrors }}</small>\n  </div>\n</template>\n"],"names":["_openBlock","_createElementBlock","_unref","_toDisplayString","_createVNode"],"mappings":"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"}
+{"version":3,"file":"JfEnum.vue.js","sources":["../../../src/vue/primevue/JfEnum.vue"],"sourcesContent":["<script lang=\"ts\">\n// Define props manually to avoid any potential circular dependency issues\nexport default {\n  name: \"JfEnum\",\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 { JsonSchema } from \"@jsonforms/core\";\nimport type { ControlProps } from \"@jsonforms/vue\";\nimport { useJsonFormsControl } from \"@jsonforms/vue\";\nimport { computed, inject, getCurrentInstance, watch } from \"vue\";\nimport { useProvider } from \"../composables/useProvider\";\nimport { useDerive } from \"../composables/useDerive\";\nimport { useDeriveInitialValue } from \"../composables/useDeriveInitialValue\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { useDirtyValidation } from \"../composables/useDirtyValidation\";\nimport { shouldAutoSelect } from \"../utils/autoSelect\";\nimport Dropdown from \"primevue/dropdown\";\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\ntype Opt = { label: string; value: unknown };\nconst toOptions = (schema?: JsonSchema): Opt[] => {\n  if (!schema) return [];\n  const s = schema as {\n    enum?: unknown[];\n    oneOf?: Array<{ title?: string; const: unknown }>;\n  };\n  if (Array.isArray(s.enum))\n    return s.enum.map((v: unknown) => ({ label: String(v), value: v }));\n  if (Array.isArray(s.oneOf))\n    return s.oneOf.map((o) => ({\n      label: o.title ?? String(o.const),\n      value: o.const,\n    }));\n  return [];\n};\n\n// Provider support\nconst binding = computed(() => {\n  const provider = control.value.uischema?.options?.provider;\n  // Ensure load property is set to 'mount' by default\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(() => {\n  return deps.value.map((dep) => {\n    // Resolve dependency value from form data using JSON pointer-like path\n    const path = dep.startsWith(\"#/\") ? dep.slice(2) : dep;\n    const keys = path.replace(/\\//g, \".\").split(\".\");\n    let value: unknown = rootData.value;\n    for (const key of keys) {\n      if (value && typeof value === \"object\" && key in value) {\n        value = (value as Record<string, unknown>)[key];\n      } else {\n        return null;\n      }\n    }\n    return value;\n  });\n});\n\n// Get the root form data from JSONForms context for template URL resolution\nconst injectedFormData = inject<{ value: unknown }>(\"formData\", { value: {} });\nconst rootData = computed(() => injectedFormData.value || {});\n\n// Use provider if available, otherwise fall back to schema enum/oneOf\nconst {\n  items: providerItems,\n  loading,\n  error,\n} = useProvider(binding, {\n  data: rootData,\n  path: control.value.path,\n  dependsOnValues: depValues.value,\n});\n\nconst placeholder = computed<string | undefined>(() => {\n  if (loading.value) return \"Loading…\";\n  return (\n    (control.value.uischema as { options?: { placeholder?: string } })?.options\n      ?.placeholder ?? control.value.description\n  );\n});\n\nconst options = computed(() => {\n  // Use provider items if available, otherwise fall back to schema enum/oneOf\n  if (binding.value && providerItems.value.length > 0) {\n    return providerItems.value;\n  }\n  return toOptions(control.value.schema);\n});\n\n// Add derive functionality\nuseDerive({ control, handleChange, data: projectedData });\n\n// Add deriveInitialValue — async API-based initial value seeding\nuseDeriveInitialValue({ control, handleChange });\n\n// Auto-select when provider returns only one item (enabled by default)\nwatch(\n  [providerItems, loading],\n  ([items, isLoading]) => {\n    const valueToSelect = shouldAutoSelect({\n      autoSelectSingle:\n        control.value.uischema?.options?.autoSelectSingle !== false,\n      isLoading,\n      items,\n      currentValue: projectedData.value,\n    });\n\n    if (valueToSelect !== null) {\n      handleChange(control.value.path, valueToSelect);\n    }\n  },\n  { immediate: true },\n);\n\n// Track user interaction — errors only show after blur\nconst { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);\n\nconst onSelect = (val: unknown) => {\n  handleChange(control.value.path, val);\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    <Dropdown\n      :class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :options=\"options\"\n      option-label=\"label\"\n      option-value=\"value\"\n      :model-value=\"projectedData ?? null\"\n      :placeholder=\"placeholder\"\n      :disabled=\"!control.enabled || loading\"\n      :aria-invalid=\"showErrors || undefined\"\n      :show-clear=\"true\"\n      @update:model-value=\"onSelect\"\n      @blur=\"markDirty\"\n    />\n    <small v-if=\"error\" class=\"p-error\" role=\"alert\"\n      >Failed to load: {{ error }}</small\n    >\n    <small v-else-if=\"showErrors\" class=\"p-error\">{{ projectedErrors }}</small>\n  </div>\n</template>\n"],"names":["_openBlock","_createElementBlock","_unref","_toDisplayString","_createVNode"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"JfText.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfText.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8MA,wBA4WK"}
+{"version":3,"file":"JfText.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfText.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmNA,wBA+WK"}

package/dist/vue/primevue/JfText.vue.js

@@ -2,6 +2,7 @@ import { defineComponent, getCurrentInstance, computed, inject, ref, watch, crea
 import { useJsonFormsControl } from "@jsonforms/vue";
 import { useProvider } from "../composables/useProvider.js";
 import { useDerive } from "../composables/useDerive.js";
+import { useDeriveInitialValue } from "../composables/useDeriveInitialValue.js";
 import { useProjection } from "../composables/useProjection.js";
 import { useDirtyValidation } from "../composables/useDirtyValidation.js";
 import InputText from "primevue/inputtext";
@@ -115,6 +116,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     });
     const isAutocomplete = computed(() => !!binding.value);
     useDerive({ control, handleChange, data: projectedData });
+    useDeriveInitialValue({ control, handleChange });
     const { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);
     function onInput(val) {
       const newValue = val && val.trim() !== "" ? val : void 0;

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

@@ -1 +1 @@
-{"version":3,"file":"JfText.vue.js","sources":["../../../src/vue/primevue/JfText.vue"],"sourcesContent":["<script lang=\"ts\">\nexport default {\n  name: \"JfText\",\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 { computed, ref, inject, watch, getCurrentInstance } from \"vue\";\nimport { useProvider } from \"../composables/useProvider\";\nimport { useDerive } from \"../composables/useDerive\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { useDirtyValidation } from \"../composables/useDirtyValidation\";\nimport InputText from \"primevue/inputtext\";\nimport AutoComplete from \"primevue/autocomplete\";\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// Provider support for autocomplete functionality\nconst binding = computed(() => {\n  const provider = control.value.uischema?.options?.provider;\n  // Ensure load property is set to 'query' by default for autocomplete\n  if (provider && typeof provider === \"object\" && !provider.load) {\n    return { ...provider, load: \"query\" };\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(() => {\n  return deps.value.map((dep) => {\n    // Resolve dependency value from form data using JSON pointer-like path\n    const path = dep.startsWith(\"#/\") ? dep.slice(2) : dep;\n    const keys = path.replace(/\\//g, \".\").split(\".\");\n    let value: unknown = rootData.value;\n    for (const key of keys) {\n      if (value && typeof value === \"object\" && key in value) {\n        value = (value as Record<string, unknown>)[key];\n      } else {\n        return null;\n      }\n    }\n    return value;\n  });\n});\n\n// Get the root form data from JSONForms context for template URL resolution\nconst injectedFormData = inject<{ value: unknown }>(\"formData\", { value: {} });\nconst rootData = computed(() => injectedFormData.value || {});\n\nconst query = ref(\"\");\nconst { items, loading, error, reload } = useProvider(binding, {\n  data: rootData,\n  path: control.value.path,\n  uiQuery: query.value,\n  dependsOnValues: depValues.value,\n});\n\nwatch(query, () => {\n  if (binding.value?.load === \"query\") reload();\n});\n\nconst placeholder = computed<string | undefined>(() => {\n  if (loading.value) return \"Loading…\";\n  return (\n    (control.value.uischema as { options?: { placeholder?: string } })?.options\n      ?.placeholder ?? control.value.description\n  );\n});\n\nconst isAutocomplete = computed(() => !!binding.value);\n\n// Add derive functionality\nuseDerive({ control, handleChange, data: projectedData });\n\n// Track user interaction — errors only show after blur\nconst { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);\n\nfunction onInput(val: string | undefined) {\n  // Convert empty strings to undefined for proper required field validation\n  const newValue = val && val.trim() !== \"\" ? val : undefined;\n  if (projectedData.value !== newValue) {\n    handleChange(control.value.path, newValue);\n  }\n}\n\nfunction onBlur() {\n  markDirty();\n  // Normalize empty strings to undefined so required validation fires\n  const val = projectedData.value;\n  if (typeof val === \"string\" && val.trim() === \"\") {\n    handleChange(control.value.path, undefined);\n  }\n}\n\n// Autocomplete specific handlers\nconst onComplete = (event: { query: string }) => {\n  query.value = event.query;\n};\n\nconst onSelect = (event: { value?: { value?: unknown } | unknown }) => {\n  const newValue = (event.value as { value?: unknown })?.value ?? event.value;\n  handleChange(control.value.path, newValue);\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    <AutoComplete\n      v-if=\"isAutocomplete\"\n      :class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :model-value=\"projectedData ?? ''\"\n      :suggestions=\"items\"\n      option-label=\"label\"\n      :placeholder=\"placeholder\"\n      :disabled=\"!control.enabled\"\n      :aria-invalid=\"showErrors || undefined\"\n      @complete=\"onComplete\"\n      @item-select=\"onSelect\"\n      @update:model-value=\"onInput\"\n      @blur=\"onBlur\"\n    />\n    <InputText\n      v-else\n      :class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :model-value=\"(projectedData as string) ?? ''\"\n      :disabled=\"!control.enabled\"\n      :aria-invalid=\"showErrors || undefined\"\n      :placeholder=\"placeholder\"\n      autocapitalize=\"off\"\n      autocomplete=\"off\"\n      spellcheck=\"false\"\n      @update:model-value=\"onInput\"\n      @blur=\"onBlur\"\n    />\n    <small v-if=\"error\" class=\"p-error\" role=\"alert\">Failed: {{ error }}</small>\n    <small v-else-if=\"showErrors\" class=\"p-error\">{{ projectedErrors }}</small>\n  </div>\n</template>\n"],"names":["_openBlock","_createElementBlock","_unref","_toDisplayString","_createBlock"],"mappings":"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"}
+{"version":3,"file":"JfText.vue.js","sources":["../../../src/vue/primevue/JfText.vue"],"sourcesContent":["<script lang=\"ts\">\nexport default {\n  name: \"JfText\",\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 { computed, ref, inject, watch, getCurrentInstance } from \"vue\";\nimport { useProvider } from \"../composables/useProvider\";\nimport { useDerive } from \"../composables/useDerive\";\nimport { useDeriveInitialValue } from \"../composables/useDeriveInitialValue\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { useDirtyValidation } from \"../composables/useDirtyValidation\";\nimport InputText from \"primevue/inputtext\";\nimport AutoComplete from \"primevue/autocomplete\";\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// Provider support for autocomplete functionality\nconst binding = computed(() => {\n  const provider = control.value.uischema?.options?.provider;\n  // Ensure load property is set to 'query' by default for autocomplete\n  if (provider && typeof provider === \"object\" && !provider.load) {\n    return { ...provider, load: \"query\" };\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(() => {\n  return deps.value.map((dep) => {\n    // Resolve dependency value from form data using JSON pointer-like path\n    const path = dep.startsWith(\"#/\") ? dep.slice(2) : dep;\n    const keys = path.replace(/\\//g, \".\").split(\".\");\n    let value: unknown = rootData.value;\n    for (const key of keys) {\n      if (value && typeof value === \"object\" && key in value) {\n        value = (value as Record<string, unknown>)[key];\n      } else {\n        return null;\n      }\n    }\n    return value;\n  });\n});\n\n// Get the root form data from JSONForms context for template URL resolution\nconst injectedFormData = inject<{ value: unknown }>(\"formData\", { value: {} });\nconst rootData = computed(() => injectedFormData.value || {});\n\nconst query = ref(\"\");\nconst { items, loading, error, reload } = useProvider(binding, {\n  data: rootData,\n  path: control.value.path,\n  uiQuery: query.value,\n  dependsOnValues: depValues.value,\n});\n\nwatch(query, () => {\n  if (binding.value?.load === \"query\") reload();\n});\n\nconst placeholder = computed<string | undefined>(() => {\n  if (loading.value) return \"Loading…\";\n  return (\n    (control.value.uischema as { options?: { placeholder?: string } })?.options\n      ?.placeholder ?? control.value.description\n  );\n});\n\nconst isAutocomplete = computed(() => !!binding.value);\n\n// Add derive functionality\nuseDerive({ control, handleChange, data: projectedData });\n\n// Add deriveInitialValue — async API-based initial value seeding\nuseDeriveInitialValue({ control, handleChange });\n\n// Track user interaction — errors only show after blur\nconst { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);\n\nfunction onInput(val: string | undefined) {\n  // Convert empty strings to undefined for proper required field validation\n  const newValue = val && val.trim() !== \"\" ? val : undefined;\n  if (projectedData.value !== newValue) {\n    handleChange(control.value.path, newValue);\n  }\n}\n\nfunction onBlur() {\n  markDirty();\n  // Normalize empty strings to undefined so required validation fires\n  const val = projectedData.value;\n  if (typeof val === \"string\" && val.trim() === \"\") {\n    handleChange(control.value.path, undefined);\n  }\n}\n\n// Autocomplete specific handlers\nconst onComplete = (event: { query: string }) => {\n  query.value = event.query;\n};\n\nconst onSelect = (event: { value?: { value?: unknown } | unknown }) => {\n  const newValue = (event.value as { value?: unknown })?.value ?? event.value;\n  handleChange(control.value.path, newValue);\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    <AutoComplete\n      v-if=\"isAutocomplete\"\n      :class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :model-value=\"projectedData ?? ''\"\n      :suggestions=\"items\"\n      option-label=\"label\"\n      :placeholder=\"placeholder\"\n      :disabled=\"!control.enabled\"\n      :aria-invalid=\"showErrors || undefined\"\n      @complete=\"onComplete\"\n      @item-select=\"onSelect\"\n      @update:model-value=\"onInput\"\n      @blur=\"onBlur\"\n    />\n    <InputText\n      v-else\n      :class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :model-value=\"(projectedData as string) ?? ''\"\n      :disabled=\"!control.enabled\"\n      :aria-invalid=\"showErrors || undefined\"\n      :placeholder=\"placeholder\"\n      autocapitalize=\"off\"\n      autocomplete=\"off\"\n      spellcheck=\"false\"\n      @update:model-value=\"onInput\"\n      @blur=\"onBlur\"\n    />\n    <small v-if=\"error\" class=\"p-error\" role=\"alert\">Failed: {{ error }}</small>\n    <small v-else-if=\"showErrors\" class=\"p-error\">{{ projectedErrors }}</small>\n  </div>\n</template>\n"],"names":["_openBlock","_createElementBlock","_unref","_toDisplayString","_createBlock"],"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;;;;AAgBA,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,UAAU,SAAS,MAAM;AAC7B,YAAM,WAAW,QAAQ,MAAM,UAAU,SAAS;AAElD,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;AAC/B,aAAO,KAAK,MAAM,IAAI,CAAC,QAAQ;AAE7B,cAAM,OAAO,IAAI,WAAW,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI;AACnD,cAAM,OAAO,KAAK,QAAQ,OAAO,GAAG,EAAE,MAAM,GAAG;AAC/C,YAAI,QAAiB,SAAS;AAC9B,mBAAW,OAAO,MAAM;AACtB,cAAI,SAAS,OAAO,UAAU,YAAY,OAAO,OAAO;AACtD,oBAAS,MAAkC,GAAG;AAAA,UAChD,OAAO;AACL,mBAAO;AAAA,UACT;AAAA,QACF;AACA,eAAO;AAAA,MACT,CAAC;AAAA,IACH,CAAC;AAGD,UAAM,mBAAmB,OAA2B,YAAY,EAAE,OAAO,CAAA,GAAI;AAC7E,UAAM,WAAW,SAAS,MAAM,iBAAiB,SAAS,CAAA,CAAE;AAE5D,UAAM,QAAQ,IAAI,EAAE;AACpB,UAAM,EAAE,OAAO,SAAS,OAAO,OAAA,IAAW,YAAY,SAAS;AAAA,MAC7D,MAAM;AAAA,MACN,MAAM,QAAQ,MAAM;AAAA,MACpB,SAAS,MAAM;AAAA,MACf,iBAAiB,UAAU;AAAA,IAAA,CAC5B;AAED,UAAM,OAAO,MAAM;AACjB,UAAI,QAAQ,OAAO,SAAS,QAAS,QAAA;AAAA,IACvC,CAAC;AAED,UAAM,cAAc,SAA6B,MAAM;AACrD,UAAI,QAAQ,MAAO,QAAO;AAC1B,aACG,QAAQ,MAAM,UAAqD,SAChE,eAAe,QAAQ,MAAM;AAAA,IAErC,CAAC;AAED,UAAM,iBAAiB,SAAS,MAAM,CAAC,CAAC,QAAQ,KAAK;AAGrD,cAAU,EAAE,SAAS,cAAc,MAAM,eAAe;AAGxD,0BAAsB,EAAE,SAAS,cAAc;AAG/C,UAAM,EAAE,YAAY,UAAA,IAAc,mBAAmB,SAAS,eAAe;AAE7E,aAAS,QAAQ,KAAyB;AAExC,YAAM,WAAW,OAAO,IAAI,KAAA,MAAW,KAAK,MAAM;AAClD,UAAI,cAAc,UAAU,UAAU;AACpC,qBAAa,QAAQ,MAAM,MAAM,QAAQ;AAAA,MAC3C;AAAA,IACF;AAEA,aAAS,SAAS;AAChB,gBAAA;AAEA,YAAM,MAAM,cAAc;AAC1B,UAAI,OAAO,QAAQ,YAAY,IAAI,KAAA,MAAW,IAAI;AAChD,qBAAa,QAAQ,MAAM,MAAM,MAAS;AAAA,MAC5C;AAAA,IACF;AAGA,UAAM,aAAa,CAAC,UAA6B;AAC/C,YAAM,QAAQ,MAAM;AAAA,IACtB;AAEA,UAAM,WAAW,CAAC,UAAqD;AACrE,YAAM,WAAY,MAAM,OAA+B,SAAS,MAAM;AACtE,mBAAa,QAAQ,MAAM,MAAM,QAAQ;AAAA,IAC3C;;AAIE,aAAAA,UAAA,GAAAC,mBAkCM,OAlCN,YAkCM;AAAA,QAjCSC,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;QAGhB,eAAA,sBADRE,YAaEF,MAAA,YAAA,GAAA;AAAA;UAXC,iDAAkCA,MAAA,UAAA,EAAA,CAAU,CAAA;AAAA,UAC5C,eAAaA,MAAA,aAAA,KAAa;AAAA,UAC1B,aAAaA,MAAA,KAAA;AAAA,UACd,gBAAa;AAAA,UACZ,aAAa,YAAA;AAAA,UACb,UAAQ,CAAGA,MAAA,OAAA,EAAQ;AAAA,UACnB,gBAAcA,MAAA,UAAA,KAAc;AAAA,UAC5B;AAAA,UACA,cAAa;AAAA,UACb,uBAAoB;AAAA,UACpB;AAAA,QAAA,iHAEHE,YAYEF,MAAA,SAAA,GAAA;AAAA;UAVC,iDAAkCA,MAAA,UAAA,EAAA,CAAU,CAAA;AAAA,UAC5C,eAAcA,MAAA,aAAA,KAAa;AAAA,UAC3B,UAAQ,CAAGA,MAAA,OAAA,EAAQ;AAAA,UACnB,gBAAcA,MAAA,UAAA,KAAc;AAAA,UAC5B,aAAa,YAAA;AAAA,UACd,gBAAe;AAAA,UACf,cAAa;AAAA,UACb,YAAW;AAAA,UACV,uBAAoB;AAAA,UACpB;AAAA,QAAA;QAEUA,MAAA,KAAA,KAAbF,UAAA,GAAAC,mBAA4E,SAA5E,YAAiD,6BAAWC,MAAA,KAAA,CAAK,GAAA,CAAA,KAC/CA,MAAA,UAAA,kBAAlBD,mBAA2E,SAA3E,YAA2EE,gBAA1BD,MAAA,eAAA,CAAe,GAAA,CAAA;;;;;"}

package/package.json

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

package/src/vue/components/ProviderSelect.vue

@@ -3,6 +3,7 @@ import type { ControlElement, JsonSchema } from "@jsonforms/core";
 import { useJsonFormsControl } from "@jsonforms/vue";
 import { computed, inject, watch } from "vue";
 import { useProvider } from "../composables/useProvider";
+import { useDeriveInitialValue } from "../composables/useDeriveInitialValue";
 import { useProjection } from "../composables/useProjection";
 import { shouldAutoSelect } from "../utils/autoSelect";
 import Dropdown from "primevue/dropdown";
@@ -49,6 +50,9 @@ const { items, loading, error } = useProvider(binding, {
 
 // Provider will automatically reload when rootData changes due to reactive cache key
 
+// deriveInitialValue — async API-based initial value seeding
+useDeriveInitialValue({ control, handleChange });
+
 // Auto-select when provider returns only one item (enabled by default)
 watch(
   [items, loading],

package/src/vue/composables/useDeriveInitialValue.ts

@@ -0,0 +1,195 @@
+import { computed, inject, ref, watch, type Ref, type ComputedRef } from "vue";
+import { type ControlElement } from "@jsonforms/core";
+import { renderTpl, renderObj } from "../../core/templating";
+import { jp } from "../../core/jsonpath";
+import {
+  applyTransformPipeline,
+  type TransformPipeline,
+} from "../../core/transforms";
+import type { AuthConfig } from "../../core/types";
+
+export interface DeriveInitialValueCfg {
+  protocol: string;
+  config: {
+    url: string;
+    method?: "GET" | "POST";
+    headers?: Record<string, string>;
+    query?: Record<string, unknown>;
+    body?: unknown;
+    auth?: AuthConfig;
+    items: string;
+    map: { value: string };
+    transforms?: TransformPipeline;
+    showError?: boolean;
+  };
+}
+
+interface DeriveInitialValueOptions {
+  control: Ref<{
+    uischema: ControlElement;
+    path: string;
+    data: unknown;
+  }>;
+  handleChange: (path: string, value: unknown) => void;
+  data?: Ref<unknown> | ComputedRef<unknown>;
+}
+
+function buildAuthHeaders(
+  auth?: AuthConfig,
+  globalAuth?: Record<string, unknown>,
+): Record<string, string> {
+  const headers: Record<string, string> = {};
+  if (!auth) return headers;
+
+  if (auth.use && globalAuth?.[auth.use]) {
+    const globalValue = globalAuth[auth.use];
+    const value =
+      typeof globalValue === "function" ? globalValue() : globalValue;
+    if (auth.use === "apiKey") headers["X-API-Key"] = String(value);
+    else if (auth.use === "bearer")
+      headers["Authorization"] = `Bearer ${value}`;
+    else if (auth.use === "token") headers["Authorization"] = `Token ${value}`;
+    return headers;
+  }
+
+  if (auth.bearer) {
+    const v = typeof auth.bearer === "function" ? auth.bearer() : auth.bearer;
+    headers["Authorization"] = `Bearer ${v}`;
+  }
+  if (auth.apiKey) {
+    const v = typeof auth.apiKey === "function" ? auth.apiKey() : auth.apiKey;
+    headers["X-API-Key"] = String(v);
+  }
+  if (auth.token) {
+    const v = typeof auth.token === "function" ? auth.token() : auth.token;
+    headers["Authorization"] = `Token ${v}`;
+  }
+
+  return headers;
+}
+
+/**
+ * Returns true when the template URL contains `{{…}}` placeholders but
+ * one or more of those placeholders resolved to an empty string, which
+ * means a required data dependency hasn't been set yet.
+ */
+function hasUnresolvedTemplates(
+  templateUrl: string,
+  renderedUrl: string,
+): boolean {
+  if (!templateUrl.includes("{{")) return false;
+  // After protocol, empty segments indicate unresolved vars
+  const pathPart = renderedUrl.replace(/^https?:\/\/[^/]+/, "");
+  if (pathPart.includes("//")) return true;
+  // Trailing slash when the template didn't have one
+  if (renderedUrl.endsWith("/") && !templateUrl.endsWith("/")) return true;
+  return false;
+}
+
+export function useDeriveInitialValue({
+  control,
+  handleChange,
+}: DeriveInitialValueOptions) {
+  const injectedFormData = inject<{ value: unknown }>("formData", {
+    value: {},
+  });
+  const rootData = computed(() => injectedFormData.value || {});
+  const auth = inject("providerAuth", {}) as Record<string, unknown>;
+
+  const cfg = computed<DeriveInitialValueCfg | undefined>(() => {
+    return control.value.uischema?.options?.deriveInitialValue as
+      | DeriveInitialValueCfg
+      | undefined;
+  });
+
+  // Compute the resolved URL reactively
+  const resolvedUrl = computed<string | null>(() => {
+    const c = cfg.value;
+    if (!c?.config?.url) return null;
+    const rendered = renderTpl(c.config.url, { data: rootData.value });
+    if (hasUnresolvedTemplates(c.config.url, rendered)) return null;
+    return rendered;
+  });
+
+  const lastFetchedUrl = ref<string | null>(null);
+  const loading = ref(false);
+  const error = ref<string | undefined>(undefined);
+
+  watch(
+    resolvedUrl,
+    async (url) => {
+      if (!url || !cfg.value) return;
+      // Only fetch when the URL changes (new context).
+      // Same URL = same context; don't override user selection.
+      if (url === lastFetchedUrl.value) return;
+      lastFetchedUrl.value = url;
+
+      loading.value = true;
+      error.value = undefined;
+
+      try {
+        const c = cfg.value.config;
+        const fullUrl = new URL(url);
+
+        // Query params
+        const q = renderObj(c.query ?? {}, {
+          data: rootData.value,
+        }) as Record<string, unknown>;
+        for (const [k, v] of Object.entries(q)) {
+          if (v !== undefined && v !== "")
+            fullUrl.searchParams.set(k, String(v));
+        }
+
+        // Headers
+        const baseHeaders = renderObj(c.headers ?? {}, {
+          data: rootData.value,
+        }) as Record<string, string>;
+        const authHeaders = buildAuthHeaders(c.auth, auth);
+        const headers = { ...baseHeaders, ...authHeaders };
+
+        const method = c.method ?? "GET";
+        const requestInit: RequestInit = { method, headers };
+        if (method !== "GET" && c.body) {
+          requestInit.body = JSON.stringify(
+            renderObj(c.body, { data: rootData.value }),
+          );
+        }
+
+        const res = await fetch(fullUrl.toString(), requestInit);
+        if (!res.ok) {
+          if (c.showError !== false) {
+            throw new Error(`REST ${res.status}`);
+          }
+          return;
+        }
+
+        const json = await res.json();
+        let items = jp(json, c.items);
+
+        // Apply transforms if provided
+        if (c.transforms && c.transforms.length > 0) {
+          items = applyTransformPipeline(items, c.transforms);
+        }
+
+        if (items.length === 0) return; // No items → leave field empty
+
+        // Extract value from first item
+        const derivedValue = jp(items[0], c.map.value)[0];
+        if (derivedValue !== undefined) {
+          handleChange(control.value.path, derivedValue);
+        }
+      } catch (e) {
+        error.value = (e as Error)?.message ?? String(e);
+        console.warn(
+          `deriveInitialValue fetch failed for ${control.value.path}:`,
+          e,
+        );
+      } finally {
+        loading.value = false;
+      }
+    },
+    { immediate: true },
+  );
+
+  return { loading, error };
+}

package/src/vue/index.ts

@@ -85,6 +85,8 @@ export { useProjection } from "./composables/useProjection";
 export type { ProjectionResult } from "./composables/useProjection";
 export { createDataLayer, useDataLayer } from "./composables/useDataLayer";
 export type { DataLayer } from "./composables/useDataLayer";
+export { useDeriveInitialValue } from "./composables/useDeriveInitialValue";
+export type { DeriveInitialValueCfg } from "./composables/useDeriveInitialValue";
 export { useDirtyValidation } from "./composables/useDirtyValidation";
 export * from "./testers";
 

package/src/vue/primevue/JfEnum.vue

@@ -45,6 +45,7 @@ import { useJsonFormsControl } from "@jsonforms/vue";
 import { computed, inject, getCurrentInstance, watch } from "vue";
 import { useProvider } from "../composables/useProvider";
 import { useDerive } from "../composables/useDerive";
+import { useDeriveInitialValue } from "../composables/useDeriveInitialValue";
 import { useProjection } from "../composables/useProjection";
 import { useDirtyValidation } from "../composables/useDirtyValidation";
 import { shouldAutoSelect } from "../utils/autoSelect";
@@ -147,6 +148,9 @@ const options = computed(() => {
 // Add derive functionality
 useDerive({ control, handleChange, data: projectedData });
 
+// Add deriveInitialValue — async API-based initial value seeding
+useDeriveInitialValue({ control, handleChange });
+
 // Auto-select when provider returns only one item (enabled by default)
 watch(
   [providerItems, loading],

package/src/vue/primevue/JfText.vue

@@ -43,6 +43,7 @@ import { useJsonFormsControl } from "@jsonforms/vue";
 import { computed, ref, inject, watch, getCurrentInstance } from "vue";
 import { useProvider } from "../composables/useProvider";
 import { useDerive } from "../composables/useDerive";
+import { useDeriveInitialValue } from "../composables/useDeriveInitialValue";
 import { useProjection } from "../composables/useProjection";
 import { useDirtyValidation } from "../composables/useDirtyValidation";
 import InputText from "primevue/inputtext";
@@ -123,6 +124,9 @@ const isAutocomplete = computed(() => !!binding.value);
 // Add derive functionality
 useDerive({ control, handleChange, data: projectedData });
 
+// Add deriveInitialValue — async API-based initial value seeding
+useDeriveInitialValue({ control, handleChange });
+
 // Track user interaction — errors only show after blur
 const { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);