@narrative.io/jsonforms-provider-protocols 3.0.0-beta.14 → 3.0.0-beta.17

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

@@ -6,6 +6,7 @@ import { useDeriveInitialValue } from "../composables/useDeriveInitialValue.js";
 import { useProjection } from "../composables/useProjection.js";
 import { useDirtyValidation } from "../composables/useDirtyValidation.js";
 import { shouldAutoSelect } from "../utils/autoSelect.js";
+import { resolvePlaceholder } from "../utils/placeholder.js";
 import Dropdown from "primevue/dropdown";
 const _hoisted_1 = { class: "jf-control" };
 const _hoisted_2 = {
@@ -123,7 +124,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     });
     const placeholder = computed(() => {
       if (loading.value) return "Loading…";
-      return control.value.uischema?.options?.placeholder ?? control.value.description;
+      return resolvePlaceholder(
+        control.value.uischema,
+        projectedLabel.value,
+        "select"
+      );
     });
     const options = computed(() => {
       if (binding.value && providerItems.value.length > 0) {

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 { 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,\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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"}
+{"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 { resolvePlaceholder } from \"../utils/placeholder\";\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,\n});\n\nconst placeholder = computed<string | undefined>(() => {\n  if (loading.value) return \"Loading…\";\n  return resolvePlaceholder(\n    control.value.uischema,\n    projectedLabel.value,\n    \"select\",\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/JfEnumArray.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JfEnumArray.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfEnumArray.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8OA,wBA+UK"}
+{"version":3,"file":"JfEnumArray.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfEnumArray.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiPA,wBAgVK"}

package/dist/vue/primevue/JfEnumArray.vue.js

@@ -5,6 +5,7 @@ import { useDerive } from "../composables/useDerive.js";
 import { useProjection } from "../composables/useProjection.js";
 import { useDirtyValidation } from "../composables/useDirtyValidation.js";
 import { shouldAutoSelectMulti } from "../utils/autoSelect.js";
+import { resolvePlaceholder } from "../utils/placeholder.js";
 import MultiSelect from "primevue/multiselect";
 const _hoisted_1 = { class: "jf-control" };
 const _hoisted_2 = {
@@ -145,7 +146,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     );
     const placeholder = computed(() => {
       if (loading.value) return "Loading…";
-      return control.value.uischema?.options?.placeholder ?? control.value.description;
+      return resolvePlaceholder(
+        control.value.uischema,
+        projectedLabel.value,
+        "select"
+      );
     });
     const sameSet = (a, b) => {
       if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)

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

@@ -1 +1 @@
-{"version":3,"file":"JfEnumArray.vue.js","sources":["../../../src/vue/primevue/JfEnumArray.vue"],"sourcesContent":["<script lang=\"ts\">\nexport default {\n  name: \"JfEnumArray\",\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 { shouldAutoSelectMulti } from \"../utils/autoSelect\";\nimport MultiSelect from \"primevue/multiselect\";\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,\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 as { items?: JsonSchema })?.items);\n});\n\n// Add derive functionality\nuseDerive({ control, handleChange, data: projectedData });\n\n// Track user interaction — errors only show after first change\nconst { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);\n\n// Auto-select when provider returns only one item (opt-in for multiselect)\nwatch(\n  [providerItems, loading],\n  ([items, isLoading]) => {\n    const valueToSelect = shouldAutoSelectMulti({\n      autoSelectSingle:\n        control.value.uischema?.options?.autoSelectSingle === true,\n      isLoading,\n      items,\n      currentValue: Array.isArray(projectedData.value)\n        ? projectedData.value\n        : [],\n    });\n\n    if (valueToSelect !== null) {\n      handleChange(control.value.path, valueToSelect);\n    }\n  },\n  { immediate: true },\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\n// order-insensitive shallow equality for primitive enums\nconst sameSet = (a: unknown[], b: unknown[]) => {\n  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)\n    return false;\n  const s = new Set(b);\n  return a.every((v) => s.has(v));\n};\n\n// v-model with guard to avoid recursive updates\nconst model = computed<unknown[]>({\n  get() {\n    const curr = Array.isArray(projectedData.value) ? projectedData.value : [];\n    // return a fresh copy so PrimeMultiSelect can't mutate JSONForms' array in place\n    return [...curr];\n  },\n  set(val) {\n    const next = Array.isArray(val) ? [...val] : [];\n    const curr = Array.isArray(projectedData.value) ? projectedData.value : [];\n    if (!sameSet(curr, next)) {\n      markDirty();\n      handleChange(control.value.path, next);\n    }\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\n    <MultiSelect\n      v-model=\"model\"\n      :class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :options=\"options\"\n      option-label=\"label\"\n      option-value=\"value\"\n      data-key=\"value\"\n      display=\"chip\"\n      :disabled=\"!control.enabled || loading\"\n      :aria-invalid=\"showErrors || undefined\"\n      :placeholder=\"placeholder\"\n    />\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":"JfEnumArray.vue.js","sources":["../../../src/vue/primevue/JfEnumArray.vue"],"sourcesContent":["<script lang=\"ts\">\nexport default {\n  name: \"JfEnumArray\",\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 { shouldAutoSelectMulti } from \"../utils/autoSelect\";\nimport { resolvePlaceholder } from \"../utils/placeholder\";\nimport MultiSelect from \"primevue/multiselect\";\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,\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 as { items?: JsonSchema })?.items);\n});\n\n// Add derive functionality\nuseDerive({ control, handleChange, data: projectedData });\n\n// Track user interaction — errors only show after first change\nconst { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);\n\n// Auto-select when provider returns only one item (opt-in for multiselect)\nwatch(\n  [providerItems, loading],\n  ([items, isLoading]) => {\n    const valueToSelect = shouldAutoSelectMulti({\n      autoSelectSingle:\n        control.value.uischema?.options?.autoSelectSingle === true,\n      isLoading,\n      items,\n      currentValue: Array.isArray(projectedData.value)\n        ? projectedData.value\n        : [],\n    });\n\n    if (valueToSelect !== null) {\n      handleChange(control.value.path, valueToSelect);\n    }\n  },\n  { immediate: true },\n);\n\nconst placeholder = computed<string | undefined>(() => {\n  if (loading.value) return \"Loading…\";\n  return resolvePlaceholder(\n    control.value.uischema,\n    projectedLabel.value,\n    \"select\",\n  );\n});\n\n// order-insensitive shallow equality for primitive enums\nconst sameSet = (a: unknown[], b: unknown[]) => {\n  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)\n    return false;\n  const s = new Set(b);\n  return a.every((v) => s.has(v));\n};\n\n// v-model with guard to avoid recursive updates\nconst model = computed<unknown[]>({\n  get() {\n    const curr = Array.isArray(projectedData.value) ? projectedData.value : [];\n    // return a fresh copy so PrimeMultiSelect can't mutate JSONForms' array in place\n    return [...curr];\n  },\n  set(val) {\n    const next = Array.isArray(val) ? [...val] : [];\n    const curr = Array.isArray(projectedData.value) ? projectedData.value : [];\n    if (!sameSet(curr, next)) {\n      markDirty();\n      handleChange(control.value.path, next);\n    }\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\n    <MultiSelect\n      v-model=\"model\"\n      :class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :options=\"options\"\n      option-label=\"label\"\n      option-value=\"value\"\n      data-key=\"value\"\n      display=\"chip\"\n      :disabled=\"!control.enabled || loading\"\n      :aria-invalid=\"showErrors || undefined\"\n      :placeholder=\"placeholder\"\n    />\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;AAiBA,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,YAAY,CAAC,WAA+B;AAChD,UAAI,CAAC,OAAQ,QAAO,CAAA;AACpB,YAAM,IAAI;AAIV,UAAI,MAAM,QAAQ,EAAE,IAAI;AACtB,eAAO,EAAE,KAAK,IAAI,CAAC,OAAgB,EAAE,OAAO,OAAO,CAAC,GAAG,OAAO,EAAA,EAAI;AACpE,UAAI,MAAM,QAAQ,EAAE,KAAK;AACvB,eAAO,EAAE,MAAM,IAAI,CAAC,OAAO;AAAA,UACzB,OAAO,EAAE,SAAS,OAAO,EAAE,KAAK;AAAA,UAChC,OAAO,EAAE;AAAA,QAAA,EACT;AACJ,aAAO,CAAA;AAAA,IACT;AAGA,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;AAG5D,UAAM;AAAA,MACJ,OAAO;AAAA,MACP;AAAA,MACA;AAAA,IAAA,IACE,YAAY,SAAS;AAAA,MACvB,MAAM;AAAA,MACN,MAAM,QAAQ,MAAM;AAAA,MACpB,iBAAiB;AAAA,IAAA,CAClB;AAED,UAAM,UAAU,SAAS,MAAM;AAE7B,UAAI,QAAQ,SAAS,cAAc,MAAM,SAAS,GAAG;AACnD,eAAO,cAAc;AAAA,MACvB;AACA,aAAO,UAAW,QAAQ,MAAM,QAAmC,KAAK;AAAA,IAC1E,CAAC;AAGD,cAAU,EAAE,SAAS,cAAc,MAAM,eAAe;AAGxD,UAAM,EAAE,YAAY,UAAA,IAAc,mBAAmB,SAAS,eAAe;AAG7E;AAAA,MACE,CAAC,eAAe,OAAO;AAAA,MACvB,CAAC,CAAC,OAAO,SAAS,MAAM;AACtB,cAAM,gBAAgB,sBAAsB;AAAA,UAC1C,kBACE,QAAQ,MAAM,UAAU,SAAS,qBAAqB;AAAA,UACxD;AAAA,UACA;AAAA,UACA,cAAc,MAAM,QAAQ,cAAc,KAAK,IAC3C,cAAc,QACd,CAAA;AAAA,QAAC,CACN;AAED,YAAI,kBAAkB,MAAM;AAC1B,uBAAa,QAAQ,MAAM,MAAM,aAAa;AAAA,QAChD;AAAA,MACF;AAAA,MACA,EAAE,WAAW,KAAA;AAAA,IAAK;AAGpB,UAAM,cAAc,SAA6B,MAAM;AACrD,UAAI,QAAQ,MAAO,QAAO;AAC1B,aAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,eAAe;AAAA,QACf;AAAA,MAAA;AAAA,IAEJ,CAAC;AAGD,UAAM,UAAU,CAAC,GAAc,MAAiB;AAC9C,UAAI,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE;AAC3D,eAAO;AACT,YAAM,IAAI,IAAI,IAAI,CAAC;AACnB,aAAO,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAAA,IAChC;AAGA,UAAM,QAAQ,SAAoB;AAAA,MAChC,MAAM;AACJ,cAAM,OAAO,MAAM,QAAQ,cAAc,KAAK,IAAI,cAAc,QAAQ,CAAA;AAExE,eAAO,CAAC,GAAG,IAAI;AAAA,MACjB;AAAA,MACA,IAAI,KAAK;AACP,cAAM,OAAO,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAA;AAC7C,cAAM,OAAO,MAAM,QAAQ,cAAc,KAAK,IAAI,cAAc,QAAQ,CAAA;AACxE,YAAI,CAAC,QAAQ,MAAM,IAAI,GAAG;AACxB,oBAAA;AACA,uBAAa,QAAQ,MAAM,MAAM,IAAI;AAAA,QACvC;AAAA,MACF;AAAA,IAAA,CACD;;AAIC,aAAAA,UAAA,GAAAC,mBAuBM,OAvBN,YAuBM;AAAA,QAtBSC,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;QAGxBE,YAWEF,MAAA,WAAA,GAAA;AAAA,sBAVS,MAAA;AAAA,uEAAA,MAAK,QAAA;AAAA,UACb,iDAAkCA,MAAA,UAAA,EAAA,CAAU,CAAA;AAAA,UAC5C,SAAS,QAAA;AAAA,UACV,gBAAa;AAAA,UACb,gBAAa;AAAA,UACb,YAAS;AAAA,UACT,SAAQ;AAAA,UACP,UAAQ,CAAGA,MAAA,OAAA,EAAQ,WAAWA,MAAA,OAAA;AAAA,UAC9B,gBAAcA,MAAA,UAAA,KAAc;AAAA,UAC5B,aAAa,YAAA;AAAA,QAAA;QAGHA,MAAA,KAAA,KAAbF,UAAA,GAAAC,mBAEC,SAFD,YACG,qCAAmBC,MAAA,KAAA,CAAK,GAAA,CAAA,KAETA,MAAA,UAAA,kBAAlBD,mBAA2E,SAA3E,YAA2EE,gBAA1BD,MAAA,eAAA,CAAe,GAAA,CAAA;;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"JfNumber.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfNumber.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4JA,wBA0QK"}
+{"version":3,"file":"JfNumber.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfNumber.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8JA,wBA0QK"}

package/dist/vue/primevue/JfNumber.vue.js

@@ -4,6 +4,7 @@ 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 { resolvePlaceholder } from "../utils/placeholder.js";
 import InputNumber from "primevue/inputnumber";
 const _hoisted_1 = { class: "jf-control" };
 const _hoisted_2 = {
@@ -70,7 +71,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       () => control.value.uischema?.options ?? {}
     );
     const placeholder = computed(
-      () => options.value.placeholder ?? control.value.description
+      () => resolvePlaceholder(control.value.uischema, projectedLabel.value, "input")
     );
     useDerive({ control, handleChange, data: projectedData });
     useDeriveInitialValue({ control, handleChange });

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

@@ -1 +1 @@
-{"version":3,"file":"JfNumber.vue.js","sources":["../../../src/vue/primevue/JfNumber.vue"],"sourcesContent":["<script lang=\"ts\">\nexport default {\n  name: \"JfNumber\",\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, getCurrentInstance } from \"vue\";\nimport { useDerive } from \"../composables/useDerive\";\nimport { useDeriveInitialValue } from \"../composables/useDeriveInitialValue\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { useDirtyValidation } from \"../composables/useDirtyValidation\";\nimport InputNumber from \"primevue/inputnumber\";\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\nconst options = computed(\n  () =>\n    (control.value.uischema as { options?: Record<string, unknown> })\n      ?.options ?? {},\n);\n\nconst placeholder = computed<string | undefined>(\n  () => (options.value.placeholder as string) ?? control.value.description,\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// Currency and decimal configuration\nconst mode = computed(() => {\n  if (options.value.currency) return \"currency\";\n  if (options.value.decimal || typeof options.value.precision === \"number\")\n    return \"decimal\";\n  return undefined;\n});\n\nconst currency = computed(() =>\n  typeof options.value.currency === \"string\" ? options.value.currency : \"USD\",\n);\n\nconst minFractionDigits = computed(() => {\n  // For integer types, no fractional digits\n  if (control.value.schema?.type === \"integer\") return 0;\n  if (mode.value === \"currency\") return 2;\n  if (typeof options.value.precision === \"number\")\n    return options.value.precision;\n  return undefined;\n});\n\nconst maxFractionDigits = computed(() => {\n  // For integer types, no fractional digits\n  if (control.value.schema?.type === \"integer\") return 0;\n  if (mode.value === \"currency\") return 2;\n  if (typeof options.value.precision === \"number\")\n    return options.value.precision;\n  return undefined;\n});\n\nconst useGrouping = computed(() => {\n  // Enable grouping for currency by default, or if explicitly set\n  if (mode.value === \"currency\") return true;\n  return options.value.useGrouping === true;\n});\n\n// Track user interaction — errors only show after blur\nconst { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);\n\nconst onNumber = (val: number | null) => {\n  handleChange(control.value.path, val ?? undefined);\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    <InputNumber\n      :class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :input-class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :use-grouping=\"useGrouping\"\n      :mode=\"mode\"\n      :currency=\"currency\"\n      :min-fraction-digits=\"minFractionDigits\"\n      :max-fraction-digits=\"maxFractionDigits\"\n      :model-value=\"typeof projectedData === 'number' ? projectedData : null\"\n      :placeholder=\"placeholder\"\n      :disabled=\"!control.enabled\"\n      :aria-invalid=\"showErrors || undefined\"\n      @update:model-value=\"onNumber\"\n      @blur=\"markDirty\"\n    />\n    <small v-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":"JfNumber.vue.js","sources":["../../../src/vue/primevue/JfNumber.vue"],"sourcesContent":["<script lang=\"ts\">\nexport default {\n  name: \"JfNumber\",\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, getCurrentInstance } from \"vue\";\nimport { useDerive } from \"../composables/useDerive\";\nimport { useDeriveInitialValue } from \"../composables/useDeriveInitialValue\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { useDirtyValidation } from \"../composables/useDirtyValidation\";\nimport { resolvePlaceholder } from \"../utils/placeholder\";\nimport InputNumber from \"primevue/inputnumber\";\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\nconst options = computed(\n  () =>\n    (control.value.uischema as { options?: Record<string, unknown> })\n      ?.options ?? {},\n);\n\nconst placeholder = computed<string | undefined>(() =>\n  resolvePlaceholder(control.value.uischema, projectedLabel.value, \"input\"),\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// Currency and decimal configuration\nconst mode = computed(() => {\n  if (options.value.currency) return \"currency\";\n  if (options.value.decimal || typeof options.value.precision === \"number\")\n    return \"decimal\";\n  return undefined;\n});\n\nconst currency = computed(() =>\n  typeof options.value.currency === \"string\" ? options.value.currency : \"USD\",\n);\n\nconst minFractionDigits = computed(() => {\n  // For integer types, no fractional digits\n  if (control.value.schema?.type === \"integer\") return 0;\n  if (mode.value === \"currency\") return 2;\n  if (typeof options.value.precision === \"number\")\n    return options.value.precision;\n  return undefined;\n});\n\nconst maxFractionDigits = computed(() => {\n  // For integer types, no fractional digits\n  if (control.value.schema?.type === \"integer\") return 0;\n  if (mode.value === \"currency\") return 2;\n  if (typeof options.value.precision === \"number\")\n    return options.value.precision;\n  return undefined;\n});\n\nconst useGrouping = computed(() => {\n  // Enable grouping for currency by default, or if explicitly set\n  if (mode.value === \"currency\") return true;\n  return options.value.useGrouping === true;\n});\n\n// Track user interaction — errors only show after blur\nconst { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);\n\nconst onNumber = (val: number | null) => {\n  handleChange(control.value.path, val ?? undefined);\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    <InputNumber\n      :class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :input-class=\"['w-full!', { 'p-invalid': showErrors }]\"\n      :use-grouping=\"useGrouping\"\n      :mode=\"mode\"\n      :currency=\"currency\"\n      :min-fraction-digits=\"minFractionDigits\"\n      :max-fraction-digits=\"maxFractionDigits\"\n      :model-value=\"typeof projectedData === 'number' ? projectedData : null\"\n      :placeholder=\"placeholder\"\n      :disabled=\"!control.enabled\"\n      :aria-invalid=\"showErrors || undefined\"\n      @update:model-value=\"onNumber\"\n      @blur=\"markDirty\"\n    />\n    <small v-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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmNA,wBA+WK"}
+{"version":3,"file":"JfText.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfText.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4NA,wBAsXK"}

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

@@ -5,6 +5,7 @@ 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 { resolvePlaceholder } from "../utils/placeholder.js";
 import InputText from "primevue/inputtext";
 import AutoComplete from "primevue/autocomplete";
 const _hoisted_1 = { class: "jf-control" };
@@ -110,11 +111,18 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     watch(query, () => {
       if (binding.value?.load === "query") reload();
     });
+    const isAutocomplete = computed(() => !!binding.value);
     const placeholder = computed(() => {
       if (loading.value) return "Loading…";
-      return control.value.uischema?.options?.placeholder ?? control.value.description;
+      const explicit = control.value.uischema?.options?.placeholder;
+      if (explicit) return explicit;
+      if (isAutocomplete.value) return "Type to search…";
+      return resolvePlaceholder(
+        control.value.uischema,
+        projectedLabel.value,
+        "input"
+      );
     });
-    const isAutocomplete = computed(() => !!binding.value);
     useDerive({ control, handleChange, data: projectedData });
     useDeriveInitialValue({ control, handleChange });
     const { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);

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 { 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,\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":"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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 { resolvePlaceholder } from \"../utils/placeholder\";\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,\n});\n\nwatch(query, () => {\n  if (binding.value?.load === \"query\") reload();\n});\n\nconst isAutocomplete = computed(() => !!binding.value);\n\nconst placeholder = computed<string | undefined>(() => {\n  if (loading.value) return \"Loading…\";\n  const explicit = (\n    control.value.uischema as { options?: { placeholder?: string } }\n  )?.options?.placeholder;\n  if (explicit) return explicit;\n  // In autocomplete mode the input is really a search box — use matching UX.\n  if (isAutocomplete.value) return \"Type to search…\";\n  return resolvePlaceholder(\n    control.value.uischema,\n    projectedLabel.value,\n    \"input\",\n  );\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// 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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"}

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

@@ -1 +1 @@
-{"version":3,"file":"JfTextArea.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfTextArea.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmHA,wBA4NK"}
+{"version":3,"file":"JfTextArea.vue.d.ts","sourceRoot":"","sources":["../../../src/vue/primevue/JfTextArea.vue"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmHA,wBA0NK"}

package/dist/vue/primevue/JfTextArea.vue.js

@@ -2,6 +2,7 @@ import { defineComponent, getCurrentInstance, computed, createElementBlock, open
 import { useJsonFormsControl } from "@jsonforms/vue";
 import { useProjection } from "../composables/useProjection.js";
 import { useDirtyValidation } from "../composables/useDirtyValidation.js";
+import { resolvePlaceholder } from "../utils/placeholder.js";
 import Textarea from "primevue/textarea";
 const _hoisted_1 = { class: "jf-control" };
 const _hoisted_2 = {
@@ -65,7 +66,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       projectedLabel
     } = useProjection(control, rawHandleChange);
     const placeholder = computed(
-      () => control.value.uischema?.options?.placeholder ?? control.value.description
+      () => resolvePlaceholder(control.value.uischema, projectedLabel.value, "input")
     );
     const { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);
     function onInput(val) {

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

@@ -1 +1 @@
-{"version":3,"file":"JfTextArea.vue.js","sources":["../../../src/vue/primevue/JfTextArea.vue"],"sourcesContent":["<script lang=\"ts\">\nexport default {\n  name: \"JfTextArea\",\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, getCurrentInstance } from \"vue\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { useDirtyValidation } from \"../composables/useDirtyValidation\";\nimport Textarea from \"primevue/textarea\";\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\nconst placeholder = computed<string | undefined>(\n  () =>\n    (control.value.uischema as { options?: { placeholder?: string } })?.options\n      ?.placeholder ?? control.value.description,\n);\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</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    <Textarea\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      :rows=\"4\"\n      :auto-resize=\"true\"\n      @update:model-value=\"onInput\"\n      @blur=\"onBlur\"\n    />\n    <small v-if=\"showErrors\" class=\"p-error\">{{ projectedErrors }}</small>\n  </div>\n</template>\n"],"names":["_openBlock","_createElementBlock","_unref","_toDisplayString","_createVNode"],"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;AAE1C,UAAM,cAAc;AAAA,MAClB,MACG,QAAQ,MAAM,UAAqD,SAChE,eAAe,QAAQ,MAAM;AAAA,IAAA;AAIrC,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;;AAIE,aAAAA,UAAA,GAAAC,mBAiBM,OAjBN,YAiBM;AAAA,QAhBSC,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,QAAA,GAAA;AAAA,UATC,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,UACb,MAAM;AAAA,UACN,eAAa;AAAA,UACb,uBAAoB;AAAA,UACpB;AAAA,QAAA;QAEUA,MAAA,UAAA,kBAAbD,mBAAsE,SAAtE,YAAsEE,gBAA1BD,MAAA,eAAA,CAAe,GAAA,CAAA;;;;;"}
+{"version":3,"file":"JfTextArea.vue.js","sources":["../../../src/vue/primevue/JfTextArea.vue"],"sourcesContent":["<script lang=\"ts\">\nexport default {\n  name: \"JfTextArea\",\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, getCurrentInstance } from \"vue\";\nimport { useProjection } from \"../composables/useProjection\";\nimport { useDirtyValidation } from \"../composables/useDirtyValidation\";\nimport { resolvePlaceholder } from \"../utils/placeholder\";\nimport Textarea from \"primevue/textarea\";\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\nconst placeholder = computed<string | undefined>(() =>\n  resolvePlaceholder(control.value.uischema, projectedLabel.value, \"input\"),\n);\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</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    <Textarea\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      :rows=\"4\"\n      :auto-resize=\"true\"\n      @update:model-value=\"onInput\"\n      @blur=\"onBlur\"\n    />\n    <small v-if=\"showErrors\" class=\"p-error\">{{ projectedErrors }}</small>\n  </div>\n</template>\n"],"names":["_openBlock","_createElementBlock","_unref","_toDisplayString","_createVNode"],"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;;;;AAaA,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;AAE1C,UAAM,cAAc;AAAA,MAA6B,MAC/C,mBAAmB,QAAQ,MAAM,UAAU,eAAe,OAAO,OAAO;AAAA,IAAA;AAI1E,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;;AAIE,aAAAA,UAAA,GAAAC,mBAiBM,OAjBN,YAiBM;AAAA,QAhBSC,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,QAAA,GAAA;AAAA,UATC,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,UACb,MAAM;AAAA,UACN,eAAa;AAAA,UACb,uBAAoB;AAAA,UACpB;AAAA,QAAA;QAEUA,MAAA,UAAA,kBAAbD,mBAAsE,SAAtE,YAAsEE,gBAA1BD,MAAA,eAAA,CAAe,GAAA,CAAA;;;;;"}

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

@@ -0,0 +1,17 @@
+/**
+ * Placeholder resolution for form controls.
+ *
+ * Precedence:
+ *   1. `uischema.options.placeholder` (explicit author intent — always wins)
+ *   2. `Select ${label}` or `Enter ${label}` when a label is resolvable
+ *   3. Kind-appropriate bare fallback
+ *
+ * Never falls back to `schema.description` — descriptions are rendered as
+ * prose above the field by our renderers, so re-using them as placeholder
+ * produces a duplicated, truncated string inside the input.
+ */
+export type PlaceholderKind = "select" | "input";
+export declare function resolvePlaceholder(uischema: {
+    options?: unknown;
+} | undefined, resolvedLabel: string | undefined, kind: PlaceholderKind): string | undefined;
+//# sourceMappingURL=placeholder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.d.ts","sourceRoot":"","sources":["../../../src/vue/utils/placeholder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AAUjD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EAC3C,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,IAAI,EAAE,eAAe,GACpB,MAAM,GAAG,SAAS,CAcpB"}

package/dist/vue/utils/placeholder.js

@@ -0,0 +1,17 @@
+function stripRequiredMarker(label) {
+  return label.replace(/\s*\*\s*$/, "").trim();
+}
+function resolvePlaceholder(uischema, resolvedLabel, kind) {
+  const options = uischema?.options;
+  const explicit = options && typeof options === "object" ? options.placeholder : void 0;
+  if (typeof explicit === "string" && explicit.length > 0) return explicit;
+  const label = resolvedLabel ? stripRequiredMarker(resolvedLabel) : "";
+  if (label) {
+    return kind === "select" ? `Select ${label}` : `Enter ${label}`;
+  }
+  return kind === "select" ? "Select…" : void 0;
+}
+export {
+  resolvePlaceholder
+};
+//# sourceMappingURL=placeholder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.js","sources":["../../../src/vue/utils/placeholder.ts"],"sourcesContent":["/**\n * Placeholder resolution for form controls.\n *\n * Precedence:\n *   1. `uischema.options.placeholder` (explicit author intent — always wins)\n *   2. `Select ${label}` or `Enter ${label}` when a label is resolvable\n *   3. Kind-appropriate bare fallback\n *\n * Never falls back to `schema.description` — descriptions are rendered as\n * prose above the field by our renderers, so re-using them as placeholder\n * produces a duplicated, truncated string inside the input.\n */\n\nexport type PlaceholderKind = \"select\" | \"input\";\n\n/**\n * Strip a trailing required-indicator asterisk (\" *\" or \"*\") that `resolveLabel`\n * appends for required fields, so composed placeholders read naturally.\n */\nfunction stripRequiredMarker(label: string): string {\n  return label.replace(/\\s*\\*\\s*$/, \"\").trim();\n}\n\nexport function resolvePlaceholder(\n  uischema: { options?: unknown } | undefined,\n  resolvedLabel: string | undefined,\n  kind: PlaceholderKind,\n): string | undefined {\n  const options = uischema?.options;\n  const explicit =\n    options && typeof options === \"object\"\n      ? (options as Record<string, unknown>).placeholder\n      : undefined;\n  if (typeof explicit === \"string\" && explicit.length > 0) return explicit;\n\n  const label = resolvedLabel ? stripRequiredMarker(resolvedLabel) : \"\";\n  if (label) {\n    return kind === \"select\" ? `Select ${label}` : `Enter ${label}`;\n  }\n\n  return kind === \"select\" ? \"Select…\" : undefined;\n}\n"],"names":[],"mappings":"AAmBA,SAAS,oBAAoB,OAAuB;AAClD,SAAO,MAAM,QAAQ,aAAa,EAAE,EAAE,KAAA;AACxC;AAEO,SAAS,mBACd,UACA,eACA,MACoB;AACpB,QAAM,UAAU,UAAU;AAC1B,QAAM,WACJ,WAAW,OAAO,YAAY,WACzB,QAAoC,cACrC;AACN,MAAI,OAAO,aAAa,YAAY,SAAS,SAAS,EAAG,QAAO;AAEhE,QAAM,QAAQ,gBAAgB,oBAAoB,aAAa,IAAI;AACnE,MAAI,OAAO;AACT,WAAO,SAAS,WAAW,UAAU,KAAK,KAAK,SAAS,KAAK;AAAA,EAC/D;AAEA,SAAO,SAAS,WAAW,YAAY;AACzC;"}

package/package.json

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

package/src/core/initFormData.ts

@@ -44,49 +44,7 @@ export function initFormDataFromSchema(
   return base;
 }
 
-/**
- * Resolve a $ref pointer against the root schema's $defs.
- * Supports nested $ref chains.
- */
-function resolveRef(
-  property: Record<string, unknown>,
-  root: Record<string, unknown>,
-  seen?: Set<string>,
-): Record<string, unknown> {
-  if (!property || typeof property !== "object") return property;
-
-  const ref = property.$ref as string | undefined;
-  if (!ref) return property;
-
-  const visited = seen ?? new Set<string>();
-  if (visited.has(ref)) return property;
-  visited.add(ref);
-
-  const resolved = resolvePointer(root, ref);
-  if (!resolved) return property;
-
-  return resolveRef(resolved as Record<string, unknown>, root, visited);
-}
-
-/**
- * Resolve a JSON pointer like "#/$defs/Price" against an object.
- */
-function resolvePointer(
-  obj: Record<string, unknown>,
-  pointer: string,
-): unknown {
-  if (!pointer.startsWith("#/")) return undefined;
-  const parts = pointer.slice(2).split("/");
-  let current: unknown = obj;
-  for (const part of parts) {
-    if (current && typeof current === "object" && part in current) {
-      current = (current as Record<string, unknown>)[part];
-    } else {
-      return undefined;
-    }
-  }
-  return current;
-}
+import { resolveRef } from "./refs";
 
 /**
  * Initialize a single property value based on its schema definition.

package/src/core/projection.ts

@@ -1,3 +1,5 @@
+import { deref as derefSchema } from "./refs";
+
 /**
  * Projection utilities for navigating complex data structures
  * through a dot-separated path where numeric segments are array indices.
@@ -97,6 +99,10 @@ function setAtPath(
  * Resolve the schema at the projected path.
  * Numeric segments traverse into `items` (array item schema).
  * String segments traverse into `properties[segment]`.
+ *
+ * `$ref` nodes are dereferenced transparently at every step, so projections
+ * that cross a `$ref` boundary (e.g. `items: { $ref: "#/$defs/X" }`) resolve
+ * to the target schema rather than collapsing to `{}`.
  */
 export function getProjectedSchema(
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -106,9 +112,10 @@ export function getProjectedSchema(
 ): Record<string, any> {
   const segments = parseProjectionPath(path);
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  let current: Record<string, any> = schema;
+  let current: Record<string, any> | undefined = schema;
 
   for (const seg of segments) {
+    current = derefSchema(current, schema);
     if (!current) return {};
 
     if (typeof seg === "number") {
@@ -132,5 +139,6 @@ export function getProjectedSchema(
     }
   }
 
-  return current;
+  const resolved = derefSchema(current, schema);
+  return resolved ?? {};
 }

package/src/core/refs.ts

@@ -0,0 +1,114 @@
+/**
+ * JSON Schema $ref resolution helpers.
+ *
+ * Supports the pointer grammar used across consumer schemas:
+ *   - "#/$defs/Name"
+ *   - "#/properties/foo/items"
+ *
+ * External refs (URIs, file refs) are intentionally out of scope. A ref that
+ * doesn't resolve leaves the node untouched — callers can still inspect the
+ * unresolved `$ref` for debugging.
+ */
+
+/**
+ * Resolve a JSON pointer (`#/a/b/c`) against an object. Returns the node at
+ * that path, or `undefined` if any segment is missing or the pointer doesn't
+ * start with `#/`.
+ */
+export function resolvePointer(
+  obj: Record<string, unknown>,
+  pointer: string,
+): unknown {
+  if (!pointer.startsWith("#/")) return undefined;
+  const parts = pointer.slice(2).split("/");
+  let current: unknown = obj;
+  for (const part of parts) {
+    if (current && typeof current === "object" && part in current) {
+      current = (current as Record<string, unknown>)[part];
+    } else {
+      return undefined;
+    }
+  }
+  return current;
+}
+
+/**
+ * Dereference a schema node along a chain of `$ref`s. Follows `A → B → C`
+ * transitively. A cycle (same `$ref` seen twice in one chain) returns the
+ * last unresolved node rather than hanging. An unresolvable pointer returns
+ * the current node unchanged.
+ */
+export function resolveRef(
+  property: Record<string, unknown>,
+  root: Record<string, unknown>,
+  seen?: Set<string>,
+): Record<string, unknown> {
+  if (!property || typeof property !== "object") return property;
+
+  const ref = property.$ref as string | undefined;
+  if (!ref) return property;
+
+  const visited = seen ?? new Set<string>();
+  if (visited.has(ref)) return property;
+  visited.add(ref);
+
+  const resolved = resolvePointer(root, ref);
+  if (!resolved) return property;
+
+  return resolveRef(resolved as Record<string, unknown>, root, visited);
+}
+
+/**
+ * Convenience wrapper around `resolveRef` that starts a fresh cycle-detection
+ * set. Intended for schema walkers that need to dereference at every step;
+ * each call is an independent resolution.
+ */
+export function deref(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  node: Record<string, any> | undefined,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  root: Record<string, any>,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+): Record<string, any> | undefined {
+  if (!node || typeof node !== "object") return node;
+  return resolveRef(node, root) as Record<string, unknown> | undefined;
+}
+
+/**
+ * Recursively dereference every `$ref` in a schema subtree, producing a
+ * concrete schema with no remaining refs. Cycles along any single chain are
+ * handled by leaving the first recursion back into a seen ref as the
+ * unresolved node — matching `resolveRef`'s semantics.
+ *
+ * Intended for use at API boundaries (e.g. `resolveScopeSchema`'s return)
+ * so downstream walkers can operate on self-contained schemas without
+ * needing the original root.
+ */
+export function deepDeref(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  node: any,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  root: Record<string, any>,
+  seen: Set<string> = new Set(),
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+): any {
+  if (!node || typeof node !== "object") return node;
+  if (Array.isArray(node)) return node.map((n) => deepDeref(n, root, seen));
+
+  const ref = (node as Record<string, unknown>).$ref as string | undefined;
+  if (typeof ref === "string") {
+    if (seen.has(ref)) return node;
+    const resolved = resolvePointer(root, ref);
+    if (!resolved || typeof resolved !== "object") return node;
+    const nextSeen = new Set(seen);
+    nextSeen.add(ref);
+    return deepDeref(resolved, root, nextSeen);
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const result: Record<string, any> = {};
+  for (const [key, value] of Object.entries(node)) {
+    result[key] = deepDeref(value, root, seen);
+  }
+  return result;
+}