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

package/dist/core/seedProjectionTargets.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Materialize array indices targeted by `options.projection` controls in a
+ * UI schema, so that JSON Schema validators (AJV / cfworker) emit
+ * `items.required` errors on otherwise-empty arrays.
+ *
+ * Why this exists:
+ *   `initFormDataFromSchema` omits optional fields, so an optional array
+ *   like `data_rates: { type: 'array', items: { $ref: '#/$defs/DataRate' } }`
+ *   produces `undefined` (or, historically, `[]`). Both shapes pass schema
+ *   validation: `undefined` doesn't trigger `type: array`, and `[]` has no
+ *   items to apply `items.required` to. As a result, a projection-targeted
+ *   field rendered with `Video CPM rate *` lies — the asterisk says
+ *   "required" but the validator never enforces it on an untouched form.
+ *
+ *   This utility opts the consumer into per-item enforcement by walking the
+ *   UI schema, finding every `Control` with `options.projection` that
+ *   addresses an array index, and ensuring the corresponding data path has
+ *   that index materialized as at least `{}`. With the empty object in
+ *   place, the schema's `items.required` fires and the projected control's
+ *   error string surfaces at form-validity time.
+ *
+ * Tradeoff:
+ *   This re-introduces "noise" on untouched forms — required-field errors
+ *   for fields the user hasn't seen yet. Use it when validation enforcement
+ *   on projection targets matters more than a clean initial form state.
+ *   The alternative is to declare these arrays as `required` + `minItems: 1`
+ *   + `default: [{}]` at the schema level, which avoids needing this helper.
+ *
+ * Properties:
+ *   - Idempotent: running twice yields the same result as running once.
+ *   - Non-destructive: existing values at target paths are preserved.
+ *   - Pure: returns a new object; does not mutate `data`.
+ *
+ * Example:
+ *   ```ts
+ *   const data = initFormDataFromSchema(schema);
+ *   const seeded = seedProjectionTargets(data, uischema);
+ *   // For uischema controls like
+ *   //   { type: 'Control', scope: '#/properties/data_rates',
+ *   //     options: { projection: '0.video_rate_usd' } }
+ *   // seeded.data_rates is now `[{}]` (was `undefined` or `[]`).
+ *   ```
+ */
+export declare function seedProjectionTargets(data: unknown, uischema: UISchemaLike | UISchemaLike[] | undefined): unknown;
+/**
+ * Minimal UI schema shape this utility traverses. Compatible with
+ * `@jsonforms/core`'s `UISchemaElement` but kept local to avoid a runtime
+ * dep on `@jsonforms/core` (it's a peer dep — types only).
+ */
+export interface UISchemaLike {
+    type?: string;
+    scope?: string;
+    options?: {
+        projection?: string;
+        [key: string]: unknown;
+    };
+    elements?: UISchemaLike[];
+    [key: string]: unknown;
+}
+//# sourceMappingURL=seedProjectionTargets.d.ts.map

package/dist/core/seedProjectionTargets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seedProjectionTargets.d.ts","sourceRoot":"","sources":["../../src/core/seedProjectionTargets.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,YAAY,GAAG,YAAY,EAAE,GAAG,SAAS,GAClD,OAAO,CA8BT;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1D,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/core/seedProjectionTargets.js

@@ -0,0 +1,50 @@
+import { parseProjectionPath, getProjectedValue, setProjectedValue } from "./projection.js";
+function seedProjectionTargets(data, uischema) {
+  if (!uischema) return data;
+  const controls = [];
+  collectProjectionControls(uischema, controls);
+  let result = data;
+  for (const { scope, projection } of controls) {
+    const dataPath = scopeToDataPath(scope);
+    const segments = parseProjectionPath(projection);
+    for (let i = 0; i < segments.length; i++) {
+      if (typeof segments[i] !== "number") continue;
+      const partial = segments.slice(0, i + 1).map((s) => String(s)).join(".");
+      const fullPath = dataPath ? `${dataPath}.${partial}` : partial;
+      if (getProjectedValue(result, fullPath) === void 0) {
+        result = setProjectedValue(result, fullPath, {});
+      }
+    }
+  }
+  return result;
+}
+function collectProjectionControls(ui, out) {
+  if (!ui) return;
+  if (Array.isArray(ui)) {
+    for (const el of ui) collectProjectionControls(el, out);
+    return;
+  }
+  if (typeof ui !== "object") return;
+  const projection = ui.options?.projection;
+  if (ui.type === "Control" && typeof ui.scope === "string" && typeof projection === "string") {
+    out.push({ scope: ui.scope, projection });
+  }
+  if (Array.isArray(ui.elements)) {
+    for (const el of ui.elements) collectProjectionControls(el, out);
+  }
+}
+function scopeToDataPath(scope) {
+  if (!scope.startsWith("#/")) return "";
+  const parts = scope.slice(2).split("/");
+  const out = [];
+  for (let i = 0; i < parts.length; i++) {
+    if (parts[i] === "properties" && i + 1 < parts.length) {
+      out.push(parts[++i]);
+    }
+  }
+  return out.join(".");
+}
+export {
+  seedProjectionTargets
+};
+//# sourceMappingURL=seedProjectionTargets.js.map

package/dist/core/seedProjectionTargets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seedProjectionTargets.js","sources":["../../src/core/seedProjectionTargets.ts"],"sourcesContent":["import {\n  getProjectedValue,\n  parseProjectionPath,\n  setProjectedValue,\n} from \"./projection\";\n\n/**\n * Materialize array indices targeted by `options.projection` controls in a\n * UI schema, so that JSON Schema validators (AJV / cfworker) emit\n * `items.required` errors on otherwise-empty arrays.\n *\n * Why this exists:\n *   `initFormDataFromSchema` omits optional fields, so an optional array\n *   like `data_rates: { type: 'array', items: { $ref: '#/$defs/DataRate' } }`\n *   produces `undefined` (or, historically, `[]`). Both shapes pass schema\n *   validation: `undefined` doesn't trigger `type: array`, and `[]` has no\n *   items to apply `items.required` to. As a result, a projection-targeted\n *   field rendered with `Video CPM rate *` lies — the asterisk says\n *   \"required\" but the validator never enforces it on an untouched form.\n *\n *   This utility opts the consumer into per-item enforcement by walking the\n *   UI schema, finding every `Control` with `options.projection` that\n *   addresses an array index, and ensuring the corresponding data path has\n *   that index materialized as at least `{}`. With the empty object in\n *   place, the schema's `items.required` fires and the projected control's\n *   error string surfaces at form-validity time.\n *\n * Tradeoff:\n *   This re-introduces \"noise\" on untouched forms — required-field errors\n *   for fields the user hasn't seen yet. Use it when validation enforcement\n *   on projection targets matters more than a clean initial form state.\n *   The alternative is to declare these arrays as `required` + `minItems: 1`\n *   + `default: [{}]` at the schema level, which avoids needing this helper.\n *\n * Properties:\n *   - Idempotent: running twice yields the same result as running once.\n *   - Non-destructive: existing values at target paths are preserved.\n *   - Pure: returns a new object; does not mutate `data`.\n *\n * Example:\n *   ```ts\n *   const data = initFormDataFromSchema(schema);\n *   const seeded = seedProjectionTargets(data, uischema);\n *   // For uischema controls like\n *   //   { type: 'Control', scope: '#/properties/data_rates',\n *   //     options: { projection: '0.video_rate_usd' } }\n *   // seeded.data_rates is now `[{}]` (was `undefined` or `[]`).\n *   ```\n */\nexport function seedProjectionTargets(\n  data: unknown,\n  uischema: UISchemaLike | UISchemaLike[] | undefined,\n): unknown {\n  if (!uischema) return data;\n\n  const controls: { scope: string; projection: string }[] = [];\n  collectProjectionControls(uischema, controls);\n\n  let result = data;\n  for (const { scope, projection } of controls) {\n    const dataPath = scopeToDataPath(scope);\n    const segments = parseProjectionPath(projection);\n\n    // Seed each numeric prefix in the projection path. For\n    // `projection: '0.bars.0.name'`, that means seeding both\n    // `<dataPath>.0` and `<dataPath>.0.bars.0`.\n    for (let i = 0; i < segments.length; i++) {\n      if (typeof segments[i] !== \"number\") continue;\n\n      const partial = segments\n        .slice(0, i + 1)\n        .map((s) => String(s))\n        .join(\".\");\n      const fullPath = dataPath ? `${dataPath}.${partial}` : partial;\n\n      if (getProjectedValue(result, fullPath) === undefined) {\n        result = setProjectedValue(result, fullPath, {});\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Minimal UI schema shape this utility traverses. Compatible with\n * `@jsonforms/core`'s `UISchemaElement` but kept local to avoid a runtime\n * dep on `@jsonforms/core` (it's a peer dep — types only).\n */\nexport interface UISchemaLike {\n  type?: string;\n  scope?: string;\n  options?: { projection?: string; [key: string]: unknown };\n  elements?: UISchemaLike[];\n  [key: string]: unknown;\n}\n\nfunction collectProjectionControls(\n  ui: UISchemaLike | UISchemaLike[] | undefined,\n  out: { scope: string; projection: string }[],\n): void {\n  if (!ui) return;\n  if (Array.isArray(ui)) {\n    for (const el of ui) collectProjectionControls(el, out);\n    return;\n  }\n  if (typeof ui !== \"object\") return;\n\n  const projection = ui.options?.projection;\n  if (\n    ui.type === \"Control\" &&\n    typeof ui.scope === \"string\" &&\n    typeof projection === \"string\"\n  ) {\n    out.push({ scope: ui.scope, projection });\n  }\n\n  if (Array.isArray(ui.elements)) {\n    for (const el of ui.elements) collectProjectionControls(el, out);\n  }\n}\n\n/**\n * Convert a JsonForms scope pointer (`#/properties/foo/properties/bar`) to\n * a dot-separated data path (`foo.bar`). Drops `items` segments — array\n * indices are added at runtime via the projection path, not the scope.\n */\nfunction scopeToDataPath(scope: string): string {\n  if (!scope.startsWith(\"#/\")) return \"\";\n  const parts = scope.slice(2).split(\"/\");\n  const out: string[] = [];\n  for (let i = 0; i < parts.length; i++) {\n    if (parts[i] === \"properties\" && i + 1 < parts.length) {\n      out.push(parts[++i]!);\n    }\n  }\n  return out.join(\".\");\n}\n"],"names":[],"mappings":";AAiDO,SAAS,sBACd,MACA,UACS;AACT,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,WAAoD,CAAA;AAC1D,4BAA0B,UAAU,QAAQ;AAE5C,MAAI,SAAS;AACb,aAAW,EAAE,OAAO,WAAA,KAAgB,UAAU;AAC5C,UAAM,WAAW,gBAAgB,KAAK;AACtC,UAAM,WAAW,oBAAoB,UAAU;AAK/C,aAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;AACxC,UAAI,OAAO,SAAS,CAAC,MAAM,SAAU;AAErC,YAAM,UAAU,SACb,MAAM,GAAG,IAAI,CAAC,EACd,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC,EACpB,KAAK,GAAG;AACX,YAAM,WAAW,WAAW,GAAG,QAAQ,IAAI,OAAO,KAAK;AAEvD,UAAI,kBAAkB,QAAQ,QAAQ,MAAM,QAAW;AACrD,iBAAS,kBAAkB,QAAQ,UAAU,CAAA,CAAE;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAeA,SAAS,0BACP,IACA,KACM;AACN,MAAI,CAAC,GAAI;AACT,MAAI,MAAM,QAAQ,EAAE,GAAG;AACrB,eAAW,MAAM,GAAI,2BAA0B,IAAI,GAAG;AACtD;AAAA,EACF;AACA,MAAI,OAAO,OAAO,SAAU;AAE5B,QAAM,aAAa,GAAG,SAAS;AAC/B,MACE,GAAG,SAAS,aACZ,OAAO,GAAG,UAAU,YACpB,OAAO,eAAe,UACtB;AACA,QAAI,KAAK,EAAE,OAAO,GAAG,OAAO,YAAY;AAAA,EAC1C;AAEA,MAAI,MAAM,QAAQ,GAAG,QAAQ,GAAG;AAC9B,eAAW,MAAM,GAAG,SAAU,2BAA0B,IAAI,GAAG;AAAA,EACjE;AACF;AAOA,SAAS,gBAAgB,OAAuB;AAC9C,MAAI,CAAC,MAAM,WAAW,IAAI,EAAG,QAAO;AACpC,QAAM,QAAQ,MAAM,MAAM,CAAC,EAAE,MAAM,GAAG;AACtC,QAAM,MAAgB,CAAA;AACtB,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,QAAI,MAAM,CAAC,MAAM,gBAAgB,IAAI,IAAI,MAAM,QAAQ;AACrD,UAAI,KAAK,MAAM,EAAE,CAAC,CAAE;AAAA,IACtB;AAAA,EACF;AACA,SAAO,IAAI,KAAK,GAAG;AACrB;"}

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export * from "./core/projection";
 export * from "./core/resolveScope";
 export * from "./core/types";
 export { initFormDataFromSchema } from "./core/initFormData";
+export { seedProjectionTargets } from "./core/seedProjectionTargets";
+export type { UISchemaLike } from "./core/seedProjectionTargets";
 export { RestApiProtocol } from "./protocols/rest_api";
 export { createNoEvalAjv, transformUnit, transformErrors, } from "./no-eval-ajv";
 export type { NoEvalAjv, NoEvalErrorObject, NoEvalValidateFunction, CreateNoEvalAjvOptions, } from "./no-eval-ajv";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -6,6 +6,7 @@ import { applyTransformPipeline } from "./core/transforms.js";
 import { getProjectedSchema, getProjectedValue, parseProjectionPath, setProjectedValue } from "./core/projection.js";
 import { resolveScopeSchema } from "./core/resolveScope.js";
 import { initFormDataFromSchema } from "./core/initFormData.js";
+import { seedProjectionTargets } from "./core/seedProjectionTargets.js";
 import { RestApiProtocol } from "./protocols/rest_api.js";
 import { createNoEvalAjv, transformErrors, transformUnit } from "./no-eval-ajv.js";
 import { providerRenderers } from "./vue/index.js";
@@ -61,6 +62,7 @@ export {
   renderObj,
   renderTpl,
   resolveScopeSchema,
+  seedProjectionTargets,
   setProjectedValue,
   transformErrors,
   transformUnit,

package/dist/index.js.map

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

package/package.json

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

package/src/core/seedProjectionTargets.ts

@@ -0,0 +1,138 @@
+import {
+  getProjectedValue,
+  parseProjectionPath,
+  setProjectedValue,
+} from "./projection";
+
+/**
+ * Materialize array indices targeted by `options.projection` controls in a
+ * UI schema, so that JSON Schema validators (AJV / cfworker) emit
+ * `items.required` errors on otherwise-empty arrays.
+ *
+ * Why this exists:
+ *   `initFormDataFromSchema` omits optional fields, so an optional array
+ *   like `data_rates: { type: 'array', items: { $ref: '#/$defs/DataRate' } }`
+ *   produces `undefined` (or, historically, `[]`). Both shapes pass schema
+ *   validation: `undefined` doesn't trigger `type: array`, and `[]` has no
+ *   items to apply `items.required` to. As a result, a projection-targeted
+ *   field rendered with `Video CPM rate *` lies — the asterisk says
+ *   "required" but the validator never enforces it on an untouched form.
+ *
+ *   This utility opts the consumer into per-item enforcement by walking the
+ *   UI schema, finding every `Control` with `options.projection` that
+ *   addresses an array index, and ensuring the corresponding data path has
+ *   that index materialized as at least `{}`. With the empty object in
+ *   place, the schema's `items.required` fires and the projected control's
+ *   error string surfaces at form-validity time.
+ *
+ * Tradeoff:
+ *   This re-introduces "noise" on untouched forms — required-field errors
+ *   for fields the user hasn't seen yet. Use it when validation enforcement
+ *   on projection targets matters more than a clean initial form state.
+ *   The alternative is to declare these arrays as `required` + `minItems: 1`
+ *   + `default: [{}]` at the schema level, which avoids needing this helper.
+ *
+ * Properties:
+ *   - Idempotent: running twice yields the same result as running once.
+ *   - Non-destructive: existing values at target paths are preserved.
+ *   - Pure: returns a new object; does not mutate `data`.
+ *
+ * Example:
+ *   ```ts
+ *   const data = initFormDataFromSchema(schema);
+ *   const seeded = seedProjectionTargets(data, uischema);
+ *   // For uischema controls like
+ *   //   { type: 'Control', scope: '#/properties/data_rates',
+ *   //     options: { projection: '0.video_rate_usd' } }
+ *   // seeded.data_rates is now `[{}]` (was `undefined` or `[]`).
+ *   ```
+ */
+export function seedProjectionTargets(
+  data: unknown,
+  uischema: UISchemaLike | UISchemaLike[] | undefined,
+): unknown {
+  if (!uischema) return data;
+
+  const controls: { scope: string; projection: string }[] = [];
+  collectProjectionControls(uischema, controls);
+
+  let result = data;
+  for (const { scope, projection } of controls) {
+    const dataPath = scopeToDataPath(scope);
+    const segments = parseProjectionPath(projection);
+
+    // Seed each numeric prefix in the projection path. For
+    // `projection: '0.bars.0.name'`, that means seeding both
+    // `<dataPath>.0` and `<dataPath>.0.bars.0`.
+    for (let i = 0; i < segments.length; i++) {
+      if (typeof segments[i] !== "number") continue;
+
+      const partial = segments
+        .slice(0, i + 1)
+        .map((s) => String(s))
+        .join(".");
+      const fullPath = dataPath ? `${dataPath}.${partial}` : partial;
+
+      if (getProjectedValue(result, fullPath) === undefined) {
+        result = setProjectedValue(result, fullPath, {});
+      }
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Minimal UI schema shape this utility traverses. Compatible with
+ * `@jsonforms/core`'s `UISchemaElement` but kept local to avoid a runtime
+ * dep on `@jsonforms/core` (it's a peer dep — types only).
+ */
+export interface UISchemaLike {
+  type?: string;
+  scope?: string;
+  options?: { projection?: string; [key: string]: unknown };
+  elements?: UISchemaLike[];
+  [key: string]: unknown;
+}
+
+function collectProjectionControls(
+  ui: UISchemaLike | UISchemaLike[] | undefined,
+  out: { scope: string; projection: string }[],
+): void {
+  if (!ui) return;
+  if (Array.isArray(ui)) {
+    for (const el of ui) collectProjectionControls(el, out);
+    return;
+  }
+  if (typeof ui !== "object") return;
+
+  const projection = ui.options?.projection;
+  if (
+    ui.type === "Control" &&
+    typeof ui.scope === "string" &&
+    typeof projection === "string"
+  ) {
+    out.push({ scope: ui.scope, projection });
+  }
+
+  if (Array.isArray(ui.elements)) {
+    for (const el of ui.elements) collectProjectionControls(el, out);
+  }
+}
+
+/**
+ * Convert a JsonForms scope pointer (`#/properties/foo/properties/bar`) to
+ * a dot-separated data path (`foo.bar`). Drops `items` segments — array
+ * indices are added at runtime via the projection path, not the scope.
+ */
+function scopeToDataPath(scope: string): string {
+  if (!scope.startsWith("#/")) return "";
+  const parts = scope.slice(2).split("/");
+  const out: string[] = [];
+  for (let i = 0; i < parts.length; i++) {
+    if (parts[i] === "properties" && i + 1 < parts.length) {
+      out.push(parts[++i]!);
+    }
+  }
+  return out.join(".");
+}

package/src/index.ts

@@ -13,6 +13,8 @@ export * from "./core/resolveScope";
 // Core exports
 export * from "./core/types";
 export { initFormDataFromSchema } from "./core/initFormData";
+export { seedProjectionTargets } from "./core/seedProjectionTargets";
+export type { UISchemaLike } from "./core/seedProjectionTargets";
 
 // Protocol exports
 export { RestApiProtocol } from "./protocols/rest_api";