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

package/src/vue/primevue/JfEnumArray.vue

@@ -45,6 +45,7 @@ import { computed, inject, getCurrentInstance, watch } from "vue";
 import { useProvider } from "../composables/useProvider";
 import { useDerive } from "../composables/useDerive";
 import { useProjection } from "../composables/useProjection";
+import { useDirtyValidation } from "../composables/useDirtyValidation";
 import { shouldAutoSelectMulti } from "../utils/autoSelect";
 import MultiSelect from "primevue/multiselect";
 
@@ -52,7 +53,12 @@ import MultiSelect from "primevue/multiselect";
 const instance = getCurrentInstance()!;
 const props = instance.props as unknown as ControlProps;
 const { control, handleChange: rawHandleChange } = useJsonFormsControl(props);
-const { projectedData, handleProjectedChange: handleChange } = useProjection(control, rawHandleChange);
+const {
+  projectedData,
+  handleProjectedChange: handleChange,
+  projectedErrors,
+  projectedLabel,
+} = useProjection(control, rawHandleChange);
 
 type Opt = { label: string; value: unknown };
 const toOptions = (schema?: JsonSchema): Opt[] => {
@@ -118,7 +124,7 @@ const {
 } = useProvider(binding, {
   data: rootData,
   path: control.value.path,
-  dependsOnValues: depValues.value,
+  dependsOnValues: depValues,
 });
 
 const options = computed(() => {
@@ -132,6 +138,9 @@ const options = computed(() => {
 // Add derive functionality
 useDerive({ control, handleChange, data: projectedData });
 
+// Track user interaction — errors only show after first change
+const { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);
+
 // Auto-select when provider returns only one item (opt-in for multiselect)
 watch(
   [providerItems, loading],
@@ -141,14 +150,16 @@ watch(
         control.value.uischema?.options?.autoSelectSingle === true,
       isLoading,
       items,
-      currentValue: Array.isArray(projectedData.value) ? projectedData.value : [],
+      currentValue: Array.isArray(projectedData.value)
+        ? projectedData.value
+        : [],
     });
 
     if (valueToSelect !== null) {
       handleChange(control.value.path, valueToSelect);
     }
   },
-  { immediate: true }
+  { immediate: true },
 );
 
 const placeholder = computed<string | undefined>(() => {
@@ -177,38 +188,37 @@ const model = computed<unknown[]>({
   set(val) {
     const next = Array.isArray(val) ? [...val] : [];
     const curr = Array.isArray(projectedData.value) ? projectedData.value : [];
-    if (!sameSet(curr, next)) handleChange(control.value.path, next);
+    if (!sameSet(curr, next)) {
+      markDirty();
+      handleChange(control.value.path, next);
+    }
   },
 });
 </script>
 
 <template>
-  <div class="flex flex-column gap-2">
-    <label v-if="control.label" class="text-color text-left">{{
-      control.label
-    }}</label>
-    <div v-if="control.description" class="text-color-secondary text-left">
+  <div class="jf-control">
+    <label v-if="projectedLabel" class="jf-label">{{ projectedLabel }}</label>
+    <div v-if="control.description" class="jf-description">
       {{ control.description }}
     </div>
 
     <MultiSelect
       v-model="model"
-      class="w-full"
+      :class="['w-full!', { 'p-invalid': showErrors }]"
       :options="options"
       option-label="label"
       option-value="value"
       data-key="value"
       display="chip"
       :disabled="!control.enabled || loading"
-      :aria-invalid="!!control.errors || undefined"
+      :aria-invalid="showErrors || undefined"
       :placeholder="placeholder"
     />
 
     <small v-if="error" class="p-error" role="alert"
       >Failed to load: {{ error }}</small
     >
-    <small v-else-if="control.errors" class="p-error">{{
-      control.errors
-    }}</small>
+    <small v-else-if="showErrors" class="p-error">{{ projectedErrors }}</small>
   </div>
 </template>

package/src/vue/primevue/JfNumber.vue

@@ -40,16 +40,23 @@ export default {
 <script setup lang="ts">
 import type { ControlProps } from "@jsonforms/vue";
 import { useJsonFormsControl } from "@jsonforms/vue";
-import { computed, ref, getCurrentInstance } from "vue";
+import { computed, getCurrentInstance } from "vue";
 import { useDerive } from "../composables/useDerive";
+import { useDeriveInitialValue } from "../composables/useDeriveInitialValue";
 import { useProjection } from "../composables/useProjection";
+import { useDirtyValidation } from "../composables/useDirtyValidation";
 import InputNumber from "primevue/inputnumber";
 
 // Access props from the component instance
 const instance = getCurrentInstance()!;
 const props = instance.props as unknown as ControlProps;
 const { control, handleChange: rawHandleChange } = useJsonFormsControl(props);
-const { projectedData, handleProjectedChange: handleChange } = useProjection(control, rawHandleChange);
+const {
+  projectedData,
+  handleProjectedChange: handleChange,
+  projectedErrors,
+  projectedLabel,
+} = useProjection(control, rawHandleChange);
 
 const options = computed(
   () =>
@@ -64,6 +71,9 @@ const placeholder = computed<string | undefined>(
 // Add derive functionality
 useDerive({ control, handleChange, data: projectedData });
 
+// Add deriveInitialValue — async API-based initial value seeding
+useDeriveInitialValue({ control, handleChange });
+
 // Currency and decimal configuration
 const mode = computed(() => {
   if (options.value.currency) return "currency";
@@ -100,31 +110,23 @@ const useGrouping = computed(() => {
   return options.value.useGrouping === true;
 });
 
-// Track user interaction
-const hasInteracted = ref(false);
-
-const showErrors = computed(() => hasInteracted.value && control.value.errors);
+// Track user interaction — errors only show after blur
+const { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);
 
 const onNumber = (val: number | null) => {
   handleChange(control.value.path, val ?? undefined);
 };
-
-const onBlur = () => {
-  hasInteracted.value = true;
-};
 </script>
 
 <template>
-  <div class="flex flex-column gap-2">
-    <label v-if="control.label" class="text-color text-left">{{
-      control.label
-    }}</label>
-    <div v-if="control.description" class="text-color-secondary text-left">
+  <div class="jf-control">
+    <label v-if="projectedLabel" class="jf-label">{{ projectedLabel }}</label>
+    <div v-if="control.description" class="jf-description">
       {{ control.description }}
     </div>
     <InputNumber
-      class="w-full"
-      input-class="w-full"
+      :class="['w-full!', { 'p-invalid': showErrors }]"
+      :input-class="['w-full!', { 'p-invalid': showErrors }]"
       :use-grouping="useGrouping"
       :mode="mode"
       :currency="currency"
@@ -133,10 +135,10 @@ const onBlur = () => {
       :model-value="typeof projectedData === 'number' ? projectedData : null"
       :placeholder="placeholder"
       :disabled="!control.enabled"
-      :aria-invalid="!!showErrors || undefined"
+      :aria-invalid="showErrors || undefined"
       @update:model-value="onNumber"
-      @blur="onBlur"
+      @blur="markDirty"
     />
-    <small v-if="showErrors" class="p-error">{{ control.errors }}</small>
+    <small v-if="showErrors" class="p-error">{{ projectedErrors }}</small>
   </div>
 </template>

package/src/vue/primevue/JfText.vue

@@ -43,7 +43,9 @@ 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";
 import AutoComplete from "primevue/autocomplete";
 
@@ -51,7 +53,12 @@ import AutoComplete from "primevue/autocomplete";
 const instance = getCurrentInstance()!;
 const props = instance.props as unknown as ControlProps;
 const { control, handleChange: rawHandleChange } = useJsonFormsControl(props);
-const { projectedData, handleProjectedChange: handleChange } = useProjection(control, rawHandleChange);
+const {
+  projectedData,
+  handleProjectedChange: handleChange,
+  projectedErrors,
+  projectedLabel,
+} = useProjection(control, rawHandleChange);
 
 // Provider support for autocomplete functionality
 const binding = computed(() => {
@@ -97,7 +104,7 @@ const { items, loading, error, reload } = useProvider(binding, {
   data: rootData,
   path: control.value.path,
   uiQuery: query.value,
-  dependsOnValues: depValues.value,
+  dependsOnValues: depValues,
 });
 
 watch(query, () => {
@@ -117,11 +124,11 @@ const isAutocomplete = computed(() => !!binding.value);
 // Add derive functionality
 useDerive({ control, handleChange, data: projectedData });
 
-// Track user interaction
-const hasInteracted = ref(false);
-const hasFocused = ref(false);
+// Add deriveInitialValue — async API-based initial value seeding
+useDeriveInitialValue({ control, handleChange });
 
-const showErrors = computed(() => hasInteracted.value && control.value.errors);
+// Track user interaction — errors only show after blur
+const { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);
 
 function onInput(val: string | undefined) {
   // Convert empty strings to undefined for proper required field validation
@@ -132,15 +139,14 @@ function onInput(val: string | undefined) {
 }
 
 function onBlur() {
-  if (hasFocused.value) {
-    hasInteracted.value = true;
+  markDirty();
+  // Normalize empty strings to undefined so required validation fires
+  const val = projectedData.value;
+  if (typeof val === "string" && val.trim() === "") {
+    handleChange(control.value.path, undefined);
   }
 }
 
-function onFocus() {
-  hasFocused.value = true;
-}
-
 // Autocomplete specific handlers
 const onComplete = (event: { query: string }) => {
   query.value = event.query;
@@ -153,43 +159,39 @@ const onSelect = (event: { value?: { value?: unknown } | unknown }) => {
 </script>
 
 <template>
-  <div class="flex flex-column gap-2">
-    <label v-if="control.label" class="text-color text-left">{{
-      control.label
-    }}</label>
-    <div v-if="control.description" class="text-color-secondary text-left">
+  <div class="jf-control">
+    <label v-if="projectedLabel" class="jf-label">{{ projectedLabel }}</label>
+    <div v-if="control.description" class="jf-description">
       {{ control.description }}
     </div>
     <AutoComplete
       v-if="isAutocomplete"
-      class="w-full"
+      :class="['w-full!', { 'p-invalid': showErrors }]"
       :model-value="projectedData ?? ''"
       :suggestions="items"
       option-label="label"
       :placeholder="placeholder"
       :disabled="!control.enabled"
-      :aria-invalid="!!showErrors || undefined"
+      :aria-invalid="showErrors || undefined"
       @complete="onComplete"
       @item-select="onSelect"
       @update:model-value="onInput"
       @blur="onBlur"
-      @focus="onFocus"
     />
     <InputText
       v-else
-      class="w-full"
+      :class="['w-full!', { 'p-invalid': showErrors }]"
       :model-value="(projectedData as string) ?? ''"
       :disabled="!control.enabled"
-      :aria-invalid="!!showErrors || undefined"
+      :aria-invalid="showErrors || undefined"
       :placeholder="placeholder"
       autocapitalize="off"
       autocomplete="off"
       spellcheck="false"
       @update:model-value="onInput"
       @blur="onBlur"
-      @focus="onFocus"
     />
     <small v-if="error" class="p-error" role="alert">Failed: {{ error }}</small>
-    <small v-else-if="showErrors" class="p-error">{{ control.errors }}</small>
+    <small v-else-if="showErrors" class="p-error">{{ projectedErrors }}</small>
   </div>
 </template>

package/src/vue/primevue/JfTextArea.vue

@@ -40,15 +40,21 @@ export default {
 <script setup lang="ts">
 import type { ControlProps } from "@jsonforms/vue";
 import { useJsonFormsControl } from "@jsonforms/vue";
-import { computed, ref, getCurrentInstance } from "vue";
+import { computed, getCurrentInstance } from "vue";
 import { useProjection } from "../composables/useProjection";
+import { useDirtyValidation } from "../composables/useDirtyValidation";
 import Textarea from "primevue/textarea";
 
 // Access props from the component instance
 const instance = getCurrentInstance()!;
 const props = instance.props as unknown as ControlProps;
 const { control, handleChange: rawHandleChange } = useJsonFormsControl(props);
-const { projectedData, handleProjectedChange: handleChange } = useProjection(control, rawHandleChange);
+const {
+  projectedData,
+  handleProjectedChange: handleChange,
+  projectedErrors,
+  projectedLabel,
+} = useProjection(control, rawHandleChange);
 
 const placeholder = computed<string | undefined>(
   () =>
@@ -56,10 +62,8 @@ const placeholder = computed<string | undefined>(
       ?.placeholder ?? control.value.description,
 );
 
-// Track user interaction
-const hasInteracted = ref(false);
-
-const showErrors = computed(() => hasInteracted.value && control.value.errors);
+// Track user interaction — errors only show after blur
+const { showErrors, markDirty } = useDirtyValidation(control, projectedErrors);
 
 function onInput(val: string | undefined) {
   // Convert empty strings to undefined for proper required field validation
@@ -70,29 +74,32 @@ function onInput(val: string | undefined) {
 }
 
 function onBlur() {
-  hasInteracted.value = true;
+  markDirty();
+  // Normalize empty strings to undefined so required validation fires
+  const val = projectedData.value;
+  if (typeof val === "string" && val.trim() === "") {
+    handleChange(control.value.path, undefined);
+  }
 }
 </script>
 
 <template>
-  <div class="flex flex-column gap-2">
-    <label v-if="control.label" class="text-color text-left">{{
-      control.label
-    }}</label>
-    <div v-if="control.description" class="text-color-secondary text-left">
+  <div class="jf-control">
+    <label v-if="projectedLabel" class="jf-label">{{ projectedLabel }}</label>
+    <div v-if="control.description" class="jf-description">
       {{ control.description }}
     </div>
     <Textarea
-      class="w-full"
+      :class="['w-full!', { 'p-invalid': showErrors }]"
       :model-value="(projectedData as string) ?? ''"
       :disabled="!control.enabled"
-      :aria-invalid="!!showErrors || undefined"
+      :aria-invalid="showErrors || undefined"
       :placeholder="placeholder"
       :rows="4"
       :auto-resize="true"
       @update:model-value="onInput"
       @blur="onBlur"
     />
-    <small v-if="showErrors" class="p-error">{{ control.errors }}</small>
+    <small v-if="showErrors" class="p-error">{{ projectedErrors }}</small>
   </div>
 </template>

package/src/vue/primevue/index.ts

@@ -19,13 +19,38 @@ const injectLayoutStyles = () => {
   display: flex;
   flex-direction: column;
   align-items: flex-start;
-  gap: 1rem;
+  gap: 24px;
   width: 100%;
 }
 
 .vertical-layout-item {
   width: 100%;
 }
+
+/* Form control wrapper */
+.jf-control {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+/* Form control label typography */
+.jf-label {
+  font-weight: 600;
+  font-size: 14px;
+  line-height: 14px;
+  color: #031553;
+  text-align: left;
+}
+
+/* Form control description typography */
+.jf-description {
+  font-weight: 400;
+  font-size: 14px;
+  line-height: 14px;
+  color: #415290;
+  text-align: left;
+}
       `;
       document.head.appendChild(style);
     }
@@ -102,47 +127,103 @@ export function registerPrimevueRenderers(jsonformsCore: any): unknown[] {
 
   // Projection-aware schema check: when options.projection is set,
   // resolve the projected schema and test against it instead of the original
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  const projectedSchemaMatches = (check: (schema: any) => boolean) =>
-    (uischema: unknown, schema: unknown): boolean => {
-      const ui = uischema as { type?: string; scope?: string; options?: { projection?: string } };
-      const projection = ui?.options?.projection;
-      if (!projection || ui?.type !== "Control" || !ui?.scope) return false;
-
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const propertySchema = resolveScopeSchema(ui.scope, schema as Record<string, any>);
-      if (!propertySchema) return false;
-
-      return check(getProjectedSchema(propertySchema, projection));
-    };
+
+  const projectedSchemaMatches =
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (check: (schema: any) => boolean) =>
+      (uischema: unknown, schema: unknown): boolean => {
+        const ui = uischema as {
+          type?: string;
+          scope?: string;
+          options?: { projection?: string };
+        };
+        const projection = ui?.options?.projection;
+        if (!projection || ui?.type !== "Control" || !ui?.scope) return false;
+
+        const propertySchema = resolveScopeSchema(
+          ui.scope,
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          schema as Record<string, any>,
+        );
+        if (!propertySchema) return false;
+
+        return check(getProjectedSchema(propertySchema, projection));
+      };
 
   const isMultilineProjection = (uischema: unknown, schema: unknown) => {
     const ui = uischema as { options?: { multi?: boolean } };
-    return ui?.options?.multi === true &&
-      projectedSchemaMatches((s) => s?.type === "string")(uischema, schema);
+    return (
+      ui?.options?.multi === true &&
+      projectedSchemaMatches((s) => s?.type === "string")(uischema, schema)
+    );
   };
 
   const renderers = [
     // Multiline text has higher priority than regular text
-    { tester: rankWith(PRIME + 4, or(isMultilineString, isMultilineProjection)), renderer: JfTextArea },
-    { tester: rankWith(PRIME + 3, or(isStringControl, projectedSchemaMatches((s) => s?.type === "string"))), renderer: JfText },
     {
-      tester: rankWith(PRIME + 6, or(isIntegerControl, projectedSchemaMatches((s) => s?.type === "integer"))),
+      tester: rankWith(PRIME + 4, or(isMultilineString, isMultilineProjection)),
+      renderer: JfTextArea,
+    },
+    {
+      tester: rankWith(
+        PRIME + 3,
+        or(
+          isStringControl,
+          projectedSchemaMatches((s) => s?.type === "string"),
+        ),
+      ),
+      renderer: JfText,
+    },
+    {
+      tester: rankWith(
+        PRIME + 6,
+        or(
+          isIntegerControl,
+          projectedSchemaMatches((s) => s?.type === "integer"),
+        ),
+      ),
       renderer: JfNumber,
     },
     {
-      tester: rankWith(PRIME + 4, or(isNumberControl, projectedSchemaMatches((s) => s?.type === "number"))),
+      tester: rankWith(
+        PRIME + 4,
+        or(
+          isNumberControl,
+          projectedSchemaMatches((s) => s?.type === "number"),
+        ),
+      ),
       renderer: JfNumber,
     },
     {
-      tester: rankWith(PRIME + 7, or(and(isControl, schemaMatches(isScalarEnum)), and(isControl, projectedSchemaMatches(isScalarEnum)))),
+      tester: rankWith(
+        PRIME + 7,
+        or(
+          and(isControl, schemaMatches(isScalarEnum)),
+          and(isControl, projectedSchemaMatches(isScalarEnum)),
+        ),
+      ),
       renderer: JfEnum,
     },
     {
-      tester: rankWith(PRIME + 8, or(and(isControl, schemaMatches(isEnumArray)), and(isControl, projectedSchemaMatches(isEnumArray)))),
+      tester: rankWith(
+        PRIME + 8,
+        or(
+          and(isControl, schemaMatches(isEnumArray)),
+          and(isControl, projectedSchemaMatches(isEnumArray)),
+        ),
+      ),
       renderer: JfEnumArray,
     },
-    { tester: rankWith(PRIME + 3, or(isBooleanControl, projectedSchemaMatches((s) => s?.type === "boolean"))), renderer: JfBoolean },
+    {
+      tester: rankWith(
+        PRIME + 3,
+        or(
+          isBooleanControl,
+          projectedSchemaMatches((s) => s?.type === "boolean"),
+        ),
+      ),
+      renderer: JfBoolean,
+    },
   ];
 
   // Update the exported array

package/src/vue/styles.css

@@ -5,7 +5,7 @@
   display: flex;
   flex-direction: column;
   align-items: flex-start;
-  gap: 1rem;
+  gap: 24px;
   width: 100%;
 }
 
@@ -14,6 +14,31 @@
   width: 100%;
 }
 
+/* Form control wrapper */
+.jf-control {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+/* Form control label typography */
+.jf-label {
+  font-weight: 600;
+  font-size: 14px;
+  line-height: 14px;
+  color: #031553;
+  text-align: left;
+}
+
+/* Form control description typography */
+.jf-description {
+  font-weight: 400;
+  font-size: 14px;
+  line-height: 14px;
+  color: #415290;
+  text-align: left;
+}
+
 /* PrimeVue dropdown text alignment fix */
 .p-dropdown-label {
   text-align: left !important;

package/src/vue/utils/autoSelect.ts

@@ -57,7 +57,7 @@ export interface AutoSelectMultiParams {
  * - Current value is empty array OR current selection is not in the current options
  */
 export function shouldAutoSelectMulti(
-  params: AutoSelectMultiParams
+  params: AutoSelectMultiParams,
 ): unknown[] | null {
   const { autoSelectSingle, isLoading, items, currentValue } = params;
 
@@ -73,7 +73,7 @@ export function shouldAutoSelectMulti(
   const currentArray = Array.isArray(currentValue) ? currentValue : [];
   const isValueEmpty = currentArray.length === 0;
   const hasValidSelection = currentArray.some((val) =>
-    items.some((item) => item.value === val)
+    items.some((item) => item.value === val),
   );
 
   if (isValueEmpty || !hasValidSelection) {