@narrative.io/jsonforms-provider-protocols 3.0.0-beta.2 → 3.0.0-beta.20

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/vue/primevue/index.ts"],"sourcesContent":["import JfText from \"./JfText.vue\";\nimport JfTextArea from \"./JfTextArea.vue\";\nimport JfNumber from \"./JfNumber.vue\";\nimport JfEnum from \"./JfEnum.vue\";\nimport JfEnumArray from \"./JfEnumArray.vue\";\nimport JfBoolean from \"./JfBoolean.vue\";\nimport { getProjectedSchema } from \"../../core/projection\";\nimport { resolveScopeSchema } from \"../../core/resolveScope\";\n\n// Auto-inject layout styles\nconst injectLayoutStyles = () => {\n  if (typeof window !== \"undefined\" && typeof document !== \"undefined\") {\n    if (!document.getElementById(\"jsonforms-primevue-styles\")) {\n      const style = document.createElement(\"style\");\n      style.id = \"jsonforms-primevue-styles\";\n      style.textContent = `\n/* JSONForms PrimeVue Provider Protocols Layout Styles */\n.vertical-layout {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 1rem;\n  width: 100%;\n}\n\n.vertical-layout-item {\n  width: 100%;\n}\n      `;\n      document.head.appendChild(style);\n    }\n  }\n};\n\n// Inject styles when this module is imported\ninjectLayoutStyles();\n\n// Track whether renderers have been registered to avoid duplicate registrations\nlet renderersInitialized = false;\n\n// Return empty renderers array initially\nexport const primevueRenderers: unknown[] = [];\n\n// Export a function that can be called by the consumer to register renderers\n// This should only be called once during application initialization\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function registerPrimevueRenderers(jsonformsCore: any): unknown[] {\n  // Prevent duplicate registration which causes AJV schema recompilation\n  if (renderersInitialized) {\n    return primevueRenderers as unknown[];\n  }\n\n  const {\n    rankWith,\n    isStringControl,\n    isNumberControl,\n    isIntegerControl,\n    and,\n    or,\n    isControl,\n    schemaMatches,\n    isBooleanControl,\n  } = jsonformsCore;\n\n  // Give PrimeVue renderers a high base rank; vanilla commonly uses small ranks (2–5)\n  const PRIME = 100;\n\n  // helpers for enum detection - using simple schema checks instead of JSONForms internal functions\n  const isScalarEnum = (s?: object) => {\n    const schema = s as {\n      type?: string;\n      enum?: unknown[];\n      oneOf?: unknown[];\n    };\n    return (\n      schema &&\n      schema.type !== \"array\" &&\n      (Array.isArray(schema.enum) || Array.isArray(schema.oneOf))\n    );\n  };\n\n  const isEnumArray = (s?: object) => {\n    const schema = s as {\n      type?: string;\n      items?: { enum?: unknown[]; oneOf?: unknown[] };\n    };\n    return (\n      schema?.type === \"array\" &&\n      (Array.isArray(schema.items?.enum) || Array.isArray(schema.items?.oneOf))\n    );\n  };\n\n  // helper for multiline detection\n  const isMultilineString = (uischema: unknown, schema: unknown) => {\n    const controlUischema = uischema as { options?: { multi?: boolean } };\n    return and(isStringControl, () => controlUischema?.options?.multi === true)(\n      uischema as Parameters<typeof isStringControl>[0],\n      schema as Parameters<typeof isStringControl>[1],\n      {} as Parameters<typeof isStringControl>[2],\n    );\n  };\n\n  // Projection-aware schema check: when options.projection is set,\n  // resolve the projected schema and test against it instead of the original\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const projectedSchemaMatches = (check: (schema: any) => boolean) =>\n    (uischema: unknown, schema: unknown): boolean => {\n      const ui = uischema as { type?: string; scope?: string; options?: { projection?: string } };\n      const projection = ui?.options?.projection;\n      if (!projection || ui?.type !== \"Control\" || !ui?.scope) return false;\n\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const propertySchema = resolveScopeSchema(ui.scope, schema as Record<string, any>);\n      if (!propertySchema) return false;\n\n      return check(getProjectedSchema(propertySchema, projection));\n    };\n\n  const isMultilineProjection = (uischema: unknown, schema: unknown) => {\n    const ui = uischema as { options?: { multi?: boolean } };\n    return ui?.options?.multi === true &&\n      projectedSchemaMatches((s) => s?.type === \"string\")(uischema, schema);\n  };\n\n  const renderers = [\n    // Multiline text has higher priority than regular text\n    { tester: rankWith(PRIME + 4, or(isMultilineString, isMultilineProjection)), renderer: JfTextArea },\n    { tester: rankWith(PRIME + 3, or(isStringControl, projectedSchemaMatches((s) => s?.type === \"string\"))), renderer: JfText },\n    {\n      tester: rankWith(PRIME + 6, or(isIntegerControl, projectedSchemaMatches((s) => s?.type === \"integer\"))),\n      renderer: JfNumber,\n    },\n    {\n      tester: rankWith(PRIME + 4, or(isNumberControl, projectedSchemaMatches((s) => s?.type === \"number\"))),\n      renderer: JfNumber,\n    },\n    {\n      tester: rankWith(PRIME + 7, or(and(isControl, schemaMatches(isScalarEnum)), and(isControl, projectedSchemaMatches(isScalarEnum)))),\n      renderer: JfEnum,\n    },\n    {\n      tester: rankWith(PRIME + 8, or(and(isControl, schemaMatches(isEnumArray)), and(isControl, projectedSchemaMatches(isEnumArray)))),\n      renderer: JfEnumArray,\n    },\n    { tester: rankWith(PRIME + 3, or(isBooleanControl, projectedSchemaMatches((s) => s?.type === \"boolean\"))), renderer: JfBoolean },\n  ];\n\n  // Update the exported array\n  primevueRenderers.splice(0, primevueRenderers.length, ...renderers);\n\n  // Mark as initialized to prevent duplicate registrations\n  renderersInitialized = true;\n\n  return renderers;\n}\n\nexport { JfText, JfTextArea, JfNumber, JfEnum, JfEnumArray, JfBoolean };\n"],"names":["JfTextArea","JfText","JfNumber","JfEnum","JfEnumArray","JfBoolean"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../src/vue/primevue/index.ts"],"sourcesContent":["import JfText from \"./JfText.vue\";\nimport JfTextArea from \"./JfTextArea.vue\";\nimport JfNumber from \"./JfNumber.vue\";\nimport JfEnum from \"./JfEnum.vue\";\nimport JfEnumArray from \"./JfEnumArray.vue\";\nimport JfBoolean from \"./JfBoolean.vue\";\nimport { getProjectedSchema } from \"../../core/projection\";\nimport { resolveScopeSchema } from \"../../core/resolveScope\";\n\n// Auto-inject layout styles\nconst injectLayoutStyles = () => {\n  if (typeof window !== \"undefined\" && typeof document !== \"undefined\") {\n    if (!document.getElementById(\"jsonforms-primevue-styles\")) {\n      const style = document.createElement(\"style\");\n      style.id = \"jsonforms-primevue-styles\";\n      style.textContent = `\n/* JSONForms PrimeVue Provider Protocols Layout Styles */\n.vertical-layout {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 24px;\n  width: 100%;\n}\n\n.vertical-layout-item {\n  width: 100%;\n}\n\n/* Form control wrapper */\n.jf-control {\n  display: flex;\n  flex-direction: column;\n  gap: 12px;\n}\n\n/* Form control label typography */\n.jf-label {\n  font-weight: 600;\n  font-size: 14px;\n  line-height: 14px;\n  color: #031553;\n  text-align: left;\n}\n\n/* Form control description typography */\n.jf-description {\n  font-weight: 400;\n  font-size: 14px;\n  line-height: 14px;\n  color: #415290;\n  text-align: left;\n}\n      `;\n      document.head.appendChild(style);\n    }\n  }\n};\n\n// Inject styles when this module is imported\ninjectLayoutStyles();\n\n// Track whether renderers have been registered to avoid duplicate registrations\nlet renderersInitialized = false;\n\n// Return empty renderers array initially\nexport const primevueRenderers: unknown[] = [];\n\n// Export a function that can be called by the consumer to register renderers\n// This should only be called once during application initialization\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function registerPrimevueRenderers(jsonformsCore: any): unknown[] {\n  // Prevent duplicate registration which causes AJV schema recompilation\n  if (renderersInitialized) {\n    return primevueRenderers as unknown[];\n  }\n\n  const {\n    rankWith,\n    isStringControl,\n    isNumberControl,\n    isIntegerControl,\n    and,\n    or,\n    isControl,\n    schemaMatches,\n    isBooleanControl,\n  } = jsonformsCore;\n\n  // Give PrimeVue renderers a high base rank; vanilla commonly uses small ranks (2–5)\n  const PRIME = 100;\n\n  // helpers for enum detection - using simple schema checks instead of JSONForms internal functions\n  const isScalarEnum = (s?: object) => {\n    const schema = s as {\n      type?: string;\n      enum?: unknown[];\n      oneOf?: unknown[];\n    };\n    return (\n      schema &&\n      schema.type !== \"array\" &&\n      (Array.isArray(schema.enum) || Array.isArray(schema.oneOf))\n    );\n  };\n\n  const isEnumArray = (s?: object) => {\n    const schema = s as {\n      type?: string;\n      items?: { enum?: unknown[]; oneOf?: unknown[] };\n    };\n    return (\n      schema?.type === \"array\" &&\n      (Array.isArray(schema.items?.enum) || Array.isArray(schema.items?.oneOf))\n    );\n  };\n\n  // helper for multiline detection\n  const isMultilineString = (uischema: unknown, schema: unknown) => {\n    const controlUischema = uischema as { options?: { multi?: boolean } };\n    return and(isStringControl, () => controlUischema?.options?.multi === true)(\n      uischema as Parameters<typeof isStringControl>[0],\n      schema as Parameters<typeof isStringControl>[1],\n      {} as Parameters<typeof isStringControl>[2],\n    );\n  };\n\n  // Projection-aware schema check: when options.projection is set,\n  // resolve the projected schema and test against it instead of the original\n\n  const projectedSchemaMatches =\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (check: (schema: any) => boolean) =>\n      (uischema: unknown, schema: unknown): boolean => {\n        const ui = uischema as {\n          type?: string;\n          scope?: string;\n          options?: { projection?: string };\n        };\n        const projection = ui?.options?.projection;\n        if (!projection || ui?.type !== \"Control\" || !ui?.scope) return false;\n\n        const propertySchema = resolveScopeSchema(\n          ui.scope,\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          schema as Record<string, any>,\n        );\n        if (!propertySchema) return false;\n\n        return check(getProjectedSchema(propertySchema, projection));\n      };\n\n  const isMultilineProjection = (uischema: unknown, schema: unknown) => {\n    const ui = uischema as { options?: { multi?: boolean } };\n    return (\n      ui?.options?.multi === true &&\n      projectedSchemaMatches((s) => s?.type === \"string\")(uischema, schema)\n    );\n  };\n\n  const renderers = [\n    // Multiline text has higher priority than regular text\n    {\n      tester: rankWith(PRIME + 4, or(isMultilineString, isMultilineProjection)),\n      renderer: JfTextArea,\n    },\n    {\n      tester: rankWith(\n        PRIME + 3,\n        or(\n          isStringControl,\n          projectedSchemaMatches((s) => s?.type === \"string\"),\n        ),\n      ),\n      renderer: JfText,\n    },\n    {\n      tester: rankWith(\n        PRIME + 6,\n        or(\n          isIntegerControl,\n          projectedSchemaMatches((s) => s?.type === \"integer\"),\n        ),\n      ),\n      renderer: JfNumber,\n    },\n    {\n      tester: rankWith(\n        PRIME + 4,\n        or(\n          isNumberControl,\n          projectedSchemaMatches((s) => s?.type === \"number\"),\n        ),\n      ),\n      renderer: JfNumber,\n    },\n    {\n      tester: rankWith(\n        PRIME + 7,\n        or(\n          and(isControl, schemaMatches(isScalarEnum)),\n          and(isControl, projectedSchemaMatches(isScalarEnum)),\n        ),\n      ),\n      renderer: JfEnum,\n    },\n    {\n      tester: rankWith(\n        PRIME + 8,\n        or(\n          and(isControl, schemaMatches(isEnumArray)),\n          and(isControl, projectedSchemaMatches(isEnumArray)),\n        ),\n      ),\n      renderer: JfEnumArray,\n    },\n    {\n      tester: rankWith(\n        PRIME + 3,\n        or(\n          isBooleanControl,\n          projectedSchemaMatches((s) => s?.type === \"boolean\"),\n        ),\n      ),\n      renderer: JfBoolean,\n    },\n  ];\n\n  // Update the exported array\n  primevueRenderers.splice(0, primevueRenderers.length, ...renderers);\n\n  // Mark as initialized to prevent duplicate registrations\n  renderersInitialized = true;\n\n  return renderers;\n}\n\nexport { JfText, JfTextArea, JfNumber, JfEnum, JfEnumArray, JfBoolean };\n"],"names":["JfTextArea","JfText","JfNumber","JfEnum","JfEnumArray","JfBoolean"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"autoSelect.js","sources":["../../../src/vue/utils/autoSelect.ts"],"sourcesContent":["import type { ProviderItem } from \"../../core/types\";\n\nexport interface AutoSelectParams {\n  autoSelectSingle: boolean;\n  isLoading: boolean;\n  items: ProviderItem[];\n  currentValue: unknown;\n}\n\n/**\n * Determines if auto-select should trigger for single-select dropdowns.\n * Returns null if auto-select should not trigger.\n *\n * Auto-select triggers when:\n * - autoSelectSingle option is enabled (default: true for single-select)\n * - Provider has finished loading\n * - Exactly one item is available\n * - Current value is empty (undefined/null) OR not in the current options\n */\nexport function shouldAutoSelect(params: AutoSelectParams): unknown | null {\n  const { autoSelectSingle, isLoading, items, currentValue } = params;\n\n  if (!autoSelectSingle || isLoading || items.length !== 1) {\n    return null;\n  }\n\n  const singleItem = items[0];\n  if (!singleItem) {\n    return null;\n  }\n\n  const isValueEmpty = currentValue === undefined || currentValue === null;\n  const isValueInOptions = items.some((item) => item.value === currentValue);\n\n  if (isValueEmpty || !isValueInOptions) {\n    return singleItem.value;\n  }\n\n  return null;\n}\n\nexport interface AutoSelectMultiParams {\n  autoSelectSingle: boolean;\n  isLoading: boolean;\n  items: ProviderItem[];\n  currentValue: unknown[];\n}\n\n/**\n * Determines if auto-select should trigger for multiselect dropdowns.\n * Returns null if auto-select should not trigger, otherwise returns an array with the single value.\n *\n * Auto-select triggers when:\n * - autoSelectSingle option is explicitly enabled (default: false for multiselect)\n * - Provider has finished loading\n * - Exactly one item is available\n * - Current value is empty array OR current selection is not in the current options\n */\nexport function shouldAutoSelectMulti(\n  params: AutoSelectMultiParams\n): unknown[] | null {\n  const { autoSelectSingle, isLoading, items, currentValue } = params;\n\n  if (!autoSelectSingle || isLoading || items.length !== 1) {\n    return null;\n  }\n\n  const singleItem = items[0];\n  if (!singleItem) {\n    return null;\n  }\n\n  const currentArray = Array.isArray(currentValue) ? currentValue : [];\n  const isValueEmpty = currentArray.length === 0;\n  const hasValidSelection = currentArray.some((val) =>\n    items.some((item) => item.value === val)\n  );\n\n  if (isValueEmpty || !hasValidSelection) {\n    return [singleItem.value];\n  }\n\n  return null;\n}\n"],"names":[],"mappings":"AAmBO,SAAS,iBAAiB,QAA0C;AACzE,QAAM,EAAE,kBAAkB,WAAW,OAAO,iBAAiB;AAE7D,MAAI,CAAC,oBAAoB,aAAa,MAAM,WAAW,GAAG;AACxD,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,MAAM,CAAC;AAC1B,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,iBAAiB,UAAa,iBAAiB;AACpE,QAAM,mBAAmB,MAAM,KAAK,CAAC,SAAS,KAAK,UAAU,YAAY;AAEzE,MAAI,gBAAgB,CAAC,kBAAkB;AACrC,WAAO,WAAW;AAAA,EACpB;AAEA,SAAO;AACT;AAmBO,SAAS,sBACd,QACkB;AAClB,QAAM,EAAE,kBAAkB,WAAW,OAAO,iBAAiB;AAE7D,MAAI,CAAC,oBAAoB,aAAa,MAAM,WAAW,GAAG;AACxD,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,MAAM,CAAC;AAC1B,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,MAAM,QAAQ,YAAY,IAAI,eAAe,CAAA;AAClE,QAAM,eAAe,aAAa,WAAW;AAC7C,QAAM,oBAAoB,aAAa;AAAA,IAAK,CAAC,QAC3C,MAAM,KAAK,CAAC,SAAS,KAAK,UAAU,GAAG;AAAA,EAAA;AAGzC,MAAI,gBAAgB,CAAC,mBAAmB;AACtC,WAAO,CAAC,WAAW,KAAK;AAAA,EAC1B;AAEA,SAAO;AACT;"}
+{"version":3,"file":"autoSelect.js","sources":["../../../src/vue/utils/autoSelect.ts"],"sourcesContent":["import type { ProviderItem } from \"../../core/types\";\n\nexport interface AutoSelectParams {\n  autoSelectSingle: boolean;\n  isLoading: boolean;\n  items: ProviderItem[];\n  currentValue: unknown;\n}\n\n/**\n * Determines if auto-select should trigger for single-select dropdowns.\n * Returns null if auto-select should not trigger.\n *\n * Auto-select triggers when:\n * - autoSelectSingle option is enabled (default: true for single-select)\n * - Provider has finished loading\n * - Exactly one item is available\n * - Current value is empty (undefined/null) OR not in the current options\n */\nexport function shouldAutoSelect(params: AutoSelectParams): unknown | null {\n  const { autoSelectSingle, isLoading, items, currentValue } = params;\n\n  if (!autoSelectSingle || isLoading || items.length !== 1) {\n    return null;\n  }\n\n  const singleItem = items[0];\n  if (!singleItem) {\n    return null;\n  }\n\n  const isValueEmpty = currentValue === undefined || currentValue === null;\n  const isValueInOptions = items.some((item) => item.value === currentValue);\n\n  if (isValueEmpty || !isValueInOptions) {\n    return singleItem.value;\n  }\n\n  return null;\n}\n\nexport interface AutoSelectMultiParams {\n  autoSelectSingle: boolean;\n  isLoading: boolean;\n  items: ProviderItem[];\n  currentValue: unknown[];\n}\n\n/**\n * Determines if auto-select should trigger for multiselect dropdowns.\n * Returns null if auto-select should not trigger, otherwise returns an array with the single value.\n *\n * Auto-select triggers when:\n * - autoSelectSingle option is explicitly enabled (default: false for multiselect)\n * - Provider has finished loading\n * - Exactly one item is available\n * - Current value is empty array OR current selection is not in the current options\n */\nexport function shouldAutoSelectMulti(\n  params: AutoSelectMultiParams,\n): unknown[] | null {\n  const { autoSelectSingle, isLoading, items, currentValue } = params;\n\n  if (!autoSelectSingle || isLoading || items.length !== 1) {\n    return null;\n  }\n\n  const singleItem = items[0];\n  if (!singleItem) {\n    return null;\n  }\n\n  const currentArray = Array.isArray(currentValue) ? currentValue : [];\n  const isValueEmpty = currentArray.length === 0;\n  const hasValidSelection = currentArray.some((val) =>\n    items.some((item) => item.value === val),\n  );\n\n  if (isValueEmpty || !hasValidSelection) {\n    return [singleItem.value];\n  }\n\n  return null;\n}\n"],"names":[],"mappings":"AAmBO,SAAS,iBAAiB,QAA0C;AACzE,QAAM,EAAE,kBAAkB,WAAW,OAAO,iBAAiB;AAE7D,MAAI,CAAC,oBAAoB,aAAa,MAAM,WAAW,GAAG;AACxD,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,MAAM,CAAC;AAC1B,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,iBAAiB,UAAa,iBAAiB;AACpE,QAAM,mBAAmB,MAAM,KAAK,CAAC,SAAS,KAAK,UAAU,YAAY;AAEzE,MAAI,gBAAgB,CAAC,kBAAkB;AACrC,WAAO,WAAW;AAAA,EACpB;AAEA,SAAO;AACT;AAmBO,SAAS,sBACd,QACkB;AAClB,QAAM,EAAE,kBAAkB,WAAW,OAAO,iBAAiB;AAE7D,MAAI,CAAC,oBAAoB,aAAa,MAAM,WAAW,GAAG;AACxD,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,MAAM,CAAC;AAC1B,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,MAAM,QAAQ,YAAY,IAAI,eAAe,CAAA;AAClE,QAAM,eAAe,aAAa,WAAW;AAC7C,QAAM,oBAAoB,aAAa;AAAA,IAAK,CAAC,QAC3C,MAAM,KAAK,CAAC,SAAS,KAAK,UAAU,GAAG;AAAA,EAAA;AAGzC,MAAI,gBAAgB,CAAC,mBAAmB;AACtC,WAAO,CAAC,WAAW,KAAK;AAAA,EAC1B;AAEA,SAAO;AACT;"}

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.2",
+	"version": "3.0.0-beta.20",
 	"description": "Dynamic data provider capabilities for JSONForms with Vue 3 integration",
 	"type": "module",
 	"author": "Narrative I/O",
@@ -47,6 +47,10 @@
 			"import": "./dist/protocols/rest_api.js",
 			"types": "./dist/protocols/rest_api.d.ts"
 		},
+		"./no-eval-ajv": {
+			"import": "./dist/no-eval-ajv.js",
+			"types": "./dist/no-eval-ajv.d.ts"
+		},
 		"./style.css": "./dist/jsonforms-provider-protocols.css"
 	},
 	"files": [
@@ -84,12 +88,14 @@
 		"@vitejs/plugin-vue": "^6.0.1",
 		"@vue/eslint-config-typescript": "^14.6.0",
 		"@vue/runtime-core": "^3.5.20",
+		"@vue/test-utils": "^2.4.6",
 		"bun-git-hooks": "^0.2.19",
 		"commitlint": "^20.0.0",
 		"eslint": "^9.34.0",
 		"eslint-config-prettier": "^10.1.8",
 		"eslint-plugin-vue": "^10.4.0",
 		"globals": "^16.3.0",
+		"happy-dom": "^20.6.3",
 		"prettier": "^3.6.2",
 		"primevue": "^4.3.8",
 		"typescript": "^5.9.2",
@@ -105,5 +111,7 @@
 		"@jsonforms/vue": "^3.6.0",
 		"@jsonforms/vue-vanilla": "^3.6.0"
 	},
-	"dependencies": {}
+	"dependencies": {
+		"@cfworker/json-schema": "4.1.1"
+	}
 }

package/src/core/initFormData.ts

@@ -0,0 +1,208 @@
+/**
+ * Initialize a form data object from a JSON Schema.
+ * Resolves $ref, const, default, oneOf/discriminator, and typed empty values.
+ *
+ * Optional fields (not listed in the parent schema's `required` array) that
+ * have no `const`, no single-value `enum`, and no `default` are omitted
+ * entirely from the result. This avoids seeding values (e.g. `null` for
+ * `type: "integer"`) that fail AJV's type check and surface spurious errors
+ * on untouched fields. Required fields retain legacy typed-empty seeding
+ * (`""`, `null`, `false`, `[]`) so that "is required" surfaces cleanly.
+ *
+ * @param schema - The full JSON Schema (must include $defs if $refs are used)
+ * @param seed   - Optional existing data to merge (seed values take priority)
+ * @returns A data object with schema-defined fields initialized
+ */
+export function initFormDataFromSchema(
+  schema: Record<string, unknown>,
+  seed?: Record<string, unknown>,
+): Record<string, unknown> {
+  const result = initProperty(schema, schema, seed, true) as
+    | Record<string, unknown>
+    | undefined;
+
+  const base =
+    result && typeof result === "object" && !Array.isArray(result)
+      ? result
+      : {};
+
+  // Preserve seed keys not described by the schema's properties.
+  if (seed && typeof seed === "object") {
+    const schemaKeys = new Set(
+      Object.keys(
+        (resolveRef(schema, schema) as Record<string, unknown>)?.properties ??
+          {},
+      ),
+    );
+    for (const key of Object.keys(seed)) {
+      if (!schemaKeys.has(key) && !(key in base)) {
+        base[key] = seed[key];
+      }
+    }
+  }
+
+  return base;
+}
+
+import { resolveRef } from "./refs";
+
+/**
+ * Initialize a single property value based on its schema definition.
+ * Returns `undefined` when the property is optional and has nothing
+ * concrete to seed — the caller then omits the key from its result.
+ */
+function initProperty(
+  property: Record<string, unknown>,
+  root: Record<string, unknown>,
+  seed: unknown,
+  required: boolean,
+): unknown {
+  if (!property || typeof property !== "object") {
+    return required ? null : undefined;
+  }
+
+  const resolved = resolveRef(property, root);
+  const type = resolved.type as string | undefined;
+  const isOneOf = Array.isArray(resolved.oneOf);
+
+  // Priority 1: seed wins for non-object, non-oneOf types. For oneOf we still
+  // descend so that a partial seed (e.g. `{value: 5}` missing the
+  // discriminator) picks up the variant's const/default for untouched fields.
+  if (seed !== undefined && seed !== null && type !== "object" && !isOneOf) {
+    return seed;
+  }
+
+  // Priority 2: const (schema-invariant — always set).
+  if ("const" in resolved) {
+    return resolved.const;
+  }
+
+  // Priority 3: single-value enum (same reasoning — only one valid value).
+  if (
+    Array.isArray(resolved.enum) &&
+    (resolved.enum as unknown[]).length === 1
+  ) {
+    return (resolved.enum as unknown[])[0];
+  }
+
+  // Priority 4: default (explicit author intent — always honored).
+  if ("default" in resolved) {
+    return resolved.default;
+  }
+
+  // Priority 5: oneOf. Recurse into the first variant, propagating the
+  // `required` flag so that the variant's own schema-declared required fields
+  // only get typed-empty seeding when the container is required. For optional
+  // containers, the variant's const / default / single-value enum still seed
+  // (author intent is unconditional) but typed-empty placeholders do not.
+  // If recursion yields nothing forced, we collapse back to undefined.
+  if (isOneOf) {
+    const value = initOneOf(resolved, root, seed, required);
+    if (
+      !required &&
+      (value === undefined ||
+        (value !== null &&
+          typeof value === "object" &&
+          !Array.isArray(value) &&
+          Object.keys(value as Record<string, unknown>).length === 0))
+    ) {
+      return undefined;
+    }
+    return value;
+  }
+
+  // Priority 6: objects recurse. The `required` flag propagates downward:
+  // inside an optional ancestor, nested required primitives also collapse,
+  // so an optional object with nested required fields stays absent instead
+  // of materializing a shell that AJV would flag.
+  if (type === "object") {
+    const obj = initObject(
+      resolved,
+      root,
+      seed as Record<string, unknown>,
+      required,
+    );
+    if (!required && Object.keys(obj).length === 0) return undefined;
+    return obj;
+  }
+
+  // Priority 7: optional primitives — omit.
+  if (!required) return undefined;
+
+  // Priority 8: required primitives — legacy typed empty.
+  switch (type) {
+    case "array":
+      return seed !== undefined && seed !== null ? seed : [];
+    case "string":
+      return "";
+    case "boolean":
+      return false;
+    case "number":
+    case "integer":
+    default:
+      return null;
+  }
+}
+
+/**
+ * Initialize an object type by recursing into its properties.
+ * Keys whose initialization returns `undefined` are omitted.
+ *
+ * `parentRequired` controls how schema.required propagates: a child is
+ * treated as required only if both its parent is required AND it appears in
+ * the parent's required array. Inside an optional ancestor the whole
+ * subtree collapses (except for author-forced values: const, default,
+ * single-value enum, or seeded values).
+ */
+function initObject(
+  schema: Record<string, unknown>,
+  root: Record<string, unknown>,
+  seed: Record<string, unknown> | undefined,
+  parentRequired: boolean,
+): Record<string, unknown> {
+  const properties = schema.properties as
+    | Record<string, Record<string, unknown>>
+    | undefined;
+  if (!properties) {
+    return seed && typeof seed === "object" ? { ...seed } : {};
+  }
+
+  const requiredSet = new Set<string>(
+    Array.isArray(schema.required) ? (schema.required as string[]) : [],
+  );
+
+  const result: Record<string, unknown> = {};
+
+  for (const [key, propSchema] of Object.entries(properties)) {
+    const seedValue = seed && typeof seed === "object" ? seed[key] : undefined;
+    const effectiveRequired = parentRequired && requiredSet.has(key);
+    const value = initProperty(propSchema, root, seedValue, effectiveRequired);
+    if (value !== undefined) {
+      result[key] = value;
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Handle oneOf schemas — pick the first variant and initialize it.
+ * `required` propagates: if the outer oneOf is required, the variant is
+ * materialized with typed-empty seeding for its required fields; if optional,
+ * only author-forced values (const / default / single-enum / seed) survive.
+ */
+function initOneOf(
+  schema: Record<string, unknown>,
+  root: Record<string, unknown>,
+  seed: unknown,
+  required: boolean,
+): unknown {
+  const variants = schema.oneOf as Record<string, unknown>[];
+  if (!variants || variants.length === 0) return required ? null : undefined;
+
+  const first = variants[0];
+  if (!first) return required ? null : undefined;
+
+  const firstVariant = resolveRef(first, root);
+  return initProperty(firstVariant, root, seed, required);
+}

package/src/core/projection.ts

@@ -1,3 +1,5 @@
+import { deref as derefSchema, tryCombinatorBranches } from "./refs";
+
 /**
  * Projection utilities for navigating complex data structures
  * through a dot-separated path where numeric segments are array indices.
@@ -26,10 +28,7 @@ export function parseProjectionPath(path: string): ProjectionSegment[] {
  * Read a value from `data` by following the projection path.
  * Returns `undefined` if any segment along the path is missing.
  */
-export function getProjectedValue(
-  data: unknown,
-  path: string,
-): unknown {
+export function getProjectedValue(data: unknown, path: string): unknown {
   const segments = parseProjectionPath(path);
   let current: unknown = data;
 
@@ -85,7 +84,10 @@ function setAtPath(
   } else {
     // Object key — ensure we have an object
     const obj: Record<string, unknown> =
-      current !== null && current !== undefined && typeof current === "object" && !Array.isArray(current)
+      current !== null &&
+      current !== undefined &&
+      typeof current === "object" &&
+      !Array.isArray(current)
         ? { ...(current as Record<string, unknown>) }
         : {};
     obj[seg] = setAtPath(obj[seg], segments, index + 1, value);
@@ -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]`.
+ *
+ * Dereferences `$ref` nodes transparently at every step, and falls through
+ * to `oneOf` / `anyOf` / `allOf` branches when a segment can't resolve
+ * directly — picks the first branch that satisfies the navigation.
  */
 export function getProjectedSchema(
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -106,31 +112,36 @@ 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") {
-      // Array index → traverse into items schema
-      const items = current.items;
-      if (items && typeof items === "object") {
-        current = items as Record<string, unknown>;
-      } else {
-        return {};
+    const navigate = (
+      node: Record<string, unknown>,
+    ): Record<string, unknown> | undefined => {
+      if (typeof seg === "number") {
+        const items = (node as { items?: unknown }).items;
+        return items && typeof items === "object"
+          ? (items as Record<string, unknown>)
+          : undefined;
       }
-    } else {
-      // Object key → traverse into properties[key]
-      const properties = current.properties as
+      const properties = (node as { properties?: unknown }).properties as
         | Record<string, Record<string, unknown>>
         | undefined;
-      if (properties && properties[seg]) {
-        current = properties[seg];
-      } else {
-        return {};
-      }
+      if (properties && properties[seg]) return properties[seg];
+      return undefined;
+    };
+
+    let next = navigate(current);
+    if (next === undefined) {
+      next = tryCombinatorBranches(current, schema, navigate);
     }
+    if (!next) return {};
+    current = next;
   }
 
-  return current;
+  const resolved = derefSchema(current, schema);
+  return resolved ?? {};
 }

package/src/core/refs.ts

@@ -0,0 +1,166 @@
+/**
+ * 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;
+}
+
+/**
+ * Depth limit for combinator (oneOf/anyOf/allOf) branch descent. Schemas
+ * rarely nest combinators beyond one or two levels; this guard protects
+ * against pathological nesting and cycles (e.g. `oneOf: [$ref back to self]`).
+ */
+const COMBINATOR_DEPTH_LIMIT = 8;
+
+/**
+ * Try to navigate a segment through a schema node's combinator branches
+ * (`oneOf` / `anyOf` / `allOf`) when direct navigation has failed.
+ *
+ * Semantics: for walker purposes (renderer-tester matching), we only need
+ * ONE concrete schema that satisfies the next navigation step. First-match
+ * by structural shape wins, same convention as `initOneOf` uses for seeding.
+ *
+ * @param node     the schema node to search (already dereffed by caller)
+ * @param root     the root schema, for dereferencing branch `$ref`s
+ * @param tryFn    predicate that attempts navigation on a candidate branch
+ *                 and returns the navigated value, or `undefined` if the
+ *                 branch doesn't have what the caller's looking for
+ * @param depth    recursion depth (capped at `COMBINATOR_DEPTH_LIMIT`)
+ */
+export function tryCombinatorBranches<T>(
+  // 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
+  tryFn: (candidate: Record<string, any>) => T | undefined,
+  depth = 0,
+): T | undefined {
+  if (depth > COMBINATOR_DEPTH_LIMIT) return undefined;
+  if (!node || typeof node !== "object") return undefined;
+
+  const branches = (node.oneOf || node.anyOf || node.allOf) as
+    | Record<string, unknown>[]
+    | undefined;
+  if (!Array.isArray(branches)) return undefined;
+
+  for (const raw of branches) {
+    const branch = deref(raw as Record<string, unknown>, root);
+    if (!branch || typeof branch !== "object") continue;
+
+    const direct = tryFn(branch);
+    if (direct !== undefined) return direct;
+
+    const nested = tryCombinatorBranches(branch, root, tryFn, depth + 1);
+    if (nested !== undefined) return nested;
+  }
+  return 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;
+}