@narrative.io/jsonforms-provider-protocols 2.11.0 → 3.0.0-beta.10

package/README.md

@@ -190,7 +190,9 @@ Recursively flattens nested tree structures into a single-level array:
 - Adds `_depth`, `_parent`, and `_formattedLabel` metadata to items
 
 **Filter Transform**
-Filters items based on property values:
+Filters items based on conditions. Supports a simple single-key syntax and a multi-condition syntax with operators.
+
+Simple syntax (single key/values):
 
 ```json
 {
@@ -200,8 +202,31 @@ Filters items based on property values:
 }
 ```
 
-- `key`: The property to check
-- `values` (optional): Array of values to match. If omitted, filters by key existence
+Multi-condition syntax (AND logic):
+
+```json
+{
+  "name": "filter",
+  "conditions": [
+    { "key": "status", "values": ["active"] },
+    { "key": "connections", "operator": "empty" }
+  ]
+}
+```
+
+Available operators:
+
+| Operator | Description |
+|----------|-------------|
+| `eq` | Value matches one of `values` (default) |
+| `neq` | Value does NOT match any of `values` |
+| `empty` | Value is null, undefined, empty array, or empty string |
+| `notEmpty` | Inverse of `empty` |
+| `gt` | Value > `values[0]` |
+| `gte` | Value >= `values[0]` |
+| `lt` | Value < `values[0]` |
+| `lte` | Value <= `values[0]` |
+| `contains` | String includes substring, or array includes value |
 
 **Combining Transforms**
 Transforms are applied sequentially in pipeline order:
@@ -215,20 +240,6 @@ Transforms are applied sequentially in pipeline order:
 }
 ```
 
-**Custom Transforms**
-Register custom transforms for your specific needs:
-
-```typescript
-import { registerTransform } from '@narrative.io/jsonforms-provider-protocols'
-
-registerTransform('uppercase', (items, config) => {
-  return items.map(item => ({
-    ...item,
-    name: item.name.toUpperCase()
-  }))
-})
-```
-
 ### Template Variables
 Create dynamic URLs using form data:
 
@@ -247,7 +258,7 @@ Control when data is fetched:
 - `query` - Load when user types (autocomplete)
 
 ### Derive Functionality
-Auto-populate fields from form data or external sources:
+Auto-populate fields from form data or the dataLayer:
 
 ```json
 {
@@ -261,33 +272,56 @@ Auto-populate fields from form data or external sources:
 }
 ```
 
-#### External Data Support
-Access external data sources separate from form data using the `externalData()` syntax:
+#### DataLayer Support
+Inject external data into forms using the `createDataLayer` API and reference it with the `dataLayer()` derive syntax:
 
 ```vue
 <script setup>
-// Provide external data to the form
-const externalData = ref({
-  user: { preferences: { theme: "dark" } },
-  tree: { name: "Oak", type: "Deciduous" }
-})
+import { createDataLayer } from '@narrative.io/jsonforms-provider-protocols'
 
-provide('externalData', externalData)
+const dataLayer = createDataLayer()
+dataLayer.push({ dataset_name: "My Dataset" })
+
+// Merge additional data at any time
+dataLayer.push({ dataset_id: 42 })
 </script>
 ```
 
 ```json
 {
-  "type": "Control", 
-  "scope": "#/properties/tree_preference",
+  "type": "Control",
+  "scope": "#/properties/audience",
   "options": {
-    "derive": "externalData(tree.name)",
+    "derive": "dataLayer(dataset_name)",
     "mode": "follow",
     "readonly": true
   }
 }
 ```
 
+The `ConnectorDataLayer` type defines available properties:
+
+```typescript
+interface ConnectorDataLayer {
+  dataset_name?: string
+  dataset_description?: string
+  dataset_id?: number
+  profile_id?: string
+  profile_name?: string
+}
+```
+
+You can also read the dataLayer state directly in components:
+
+```vue
+<script setup>
+import { useDataLayer } from '@narrative.io/jsonforms-provider-protocols'
+
+const dataLayerState = useDataLayer()
+// dataLayerState.value.dataset_name
+</script>
+```
+
 ### Error Handling
 Control error display behavior with the `showError` property:
 
@@ -307,6 +341,44 @@ Control error display behavior with the `showError` property:
 
 When `showError` is `false`, failed requests return empty results instead of throwing errors. Defaults to `true`.
 
+### Projection
+Render simple controls (text, number) against deeply nested or array-wrapped data structures using the `projection` UISchema option. The control sees a simple value, while the underlying form data maintains the full structure.
+
+The projection path is **relative to the control's `scope`**. So when `scope` is `#/properties/data_rates` and the projection is `"0.video_rate_usd"`, it resolves to `data_rates[0].video_rate_usd` in the form data:
+
+```json
+{
+  "type": "Control",
+  "scope": "#/properties/data_rates",
+  "options": {
+    "placeholder": "Enter video rate...",
+    "projection": "0.video_rate_usd"
+  }
+}
+```
+
+With form data `{ data_rates: [{ video_rate_usd: 2.5, display_rate_usd: 1.5 }] }`, the control renders `2.5` as a simple number input. When the user changes the value, only `video_rate_usd` is updated — all sibling properties are preserved.
+
+**Path syntax:** Dot-separated segments (similar to Lodash `_.get`) where numeric segments are array indices and string segments are object keys.
+
+| Projection Path | Data Shape | Control Sees |
+|-----------------|-----------|-------------|
+| `0` | `[123]` | `123` |
+| `0.video_rate_usd` | `[{ video_rate_usd: 2.5 }]` | `2.5` |
+| `include` | `{ include: ["a", "b"] }` | `["a", "b"]` |
+
+The schema is also resolved through the projection path, so validation works correctly on the projected value.
+
+Use `useProjection` directly in custom components:
+
+```vue
+<script setup>
+import { useProjection } from '@narrative.io/jsonforms-provider-protocols'
+
+const { projectedData, projectedSchema, handleProjectedChange, hasProjection } = useProjection(control, handleChange)
+</script>
+```
+
 ### Composables
 Use providers directly in your components:
 

package/dist/core/initFormData.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Initialize a form data object from a JSON Schema.
+ * Resolves $ref, const, default, oneOf/discriminator, and typed empty values.
+ *
+ * @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 all schema-defined fields initialized
+ */
+export declare function initFormDataFromSchema(schema: Record<string, unknown>, seed?: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=initFormData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initFormData.d.ts","sourceRoot":"","sources":["../../src/core/initFormData.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB"}

package/dist/core/initFormData.js

@@ -0,0 +1,99 @@
+function initFormDataFromSchema(schema, seed) {
+  const result = initProperty(schema, schema, seed);
+  if (result && typeof result === "object" && !Array.isArray(result) && seed && typeof seed === "object") {
+    const schemaKeys = new Set(
+      Object.keys(
+        resolveRef(schema, schema)?.properties ?? {}
+      )
+    );
+    for (const key of Object.keys(seed)) {
+      if (!schemaKeys.has(key) && !(key in result)) {
+        result[key] = seed[key];
+      }
+    }
+  }
+  return result ?? {};
+}
+function resolveRef(property, root, seen) {
+  if (!property || typeof property !== "object") return property;
+  const ref = property.$ref;
+  if (!ref) return property;
+  const visited = seen ?? /* @__PURE__ */ new Set();
+  if (visited.has(ref)) return property;
+  visited.add(ref);
+  const resolved = resolvePointer(root, ref);
+  if (!resolved) return property;
+  return resolveRef(resolved, root, visited);
+}
+function resolvePointer(obj, pointer) {
+  if (!pointer.startsWith("#/")) return void 0;
+  const parts = pointer.slice(2).split("/");
+  let current = obj;
+  for (const part of parts) {
+    if (current && typeof current === "object" && part in current) {
+      current = current[part];
+    } else {
+      return void 0;
+    }
+  }
+  return current;
+}
+function initProperty(property, root, seed) {
+  if (!property || typeof property !== "object") return null;
+  const resolved = resolveRef(property, root);
+  if (Array.isArray(resolved.oneOf)) {
+    return initOneOf(resolved, root, seed);
+  }
+  const type = resolved.type;
+  if (seed !== void 0 && seed !== null && type !== "object") {
+    return seed;
+  }
+  if ("const" in resolved) {
+    return resolved.const;
+  }
+  if (Array.isArray(resolved.enum) && resolved.enum.length === 1) {
+    return resolved.enum[0];
+  }
+  if ("default" in resolved) {
+    return resolved.default;
+  }
+  switch (type) {
+    case "object":
+      return initObject(resolved, root, seed);
+    case "array":
+      return seed !== void 0 && seed !== null ? seed : [];
+    case "string":
+      return "";
+    case "boolean":
+      return false;
+    case "number":
+    case "integer":
+      return null;
+    default:
+      return null;
+  }
+}
+function initObject(schema, root, seed) {
+  const properties = schema.properties;
+  if (!properties) {
+    return seed && typeof seed === "object" ? { ...seed } : {};
+  }
+  const result = {};
+  for (const [key, propSchema] of Object.entries(properties)) {
+    const seedValue = seed && typeof seed === "object" ? seed[key] : void 0;
+    result[key] = initProperty(propSchema, root, seedValue);
+  }
+  return result;
+}
+function initOneOf(schema, root, seed) {
+  const variants = schema.oneOf;
+  if (!variants || variants.length === 0) return null;
+  const first = variants[0];
+  if (!first) return null;
+  const firstVariant = resolveRef(first, root);
+  return initProperty(firstVariant, root, seed);
+}
+export {
+  initFormDataFromSchema
+};
+//# sourceMappingURL=initFormData.js.map

package/dist/core/initFormData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initFormData.js","sources":["../../src/core/initFormData.ts"],"sourcesContent":["/**\n * Initialize a form data object from a JSON Schema.\n * Resolves $ref, const, default, oneOf/discriminator, and typed empty values.\n *\n * @param schema - The full JSON Schema (must include $defs if $refs are used)\n * @param seed   - Optional existing data to merge (seed values take priority)\n * @returns A data object with all schema-defined fields initialized\n */\nexport function initFormDataFromSchema(\n  schema: Record<string, unknown>,\n  seed?: Record<string, unknown>,\n): Record<string, unknown> {\n  const result = initProperty(schema, schema, seed) as Record<string, unknown>;\n\n  // If result is an object and seed has extra keys not in schema, preserve them\n  if (\n    result &&\n    typeof result === \"object\" &&\n    !Array.isArray(result) &&\n    seed &&\n    typeof seed === \"object\"\n  ) {\n    const schemaKeys = new Set(\n      Object.keys(\n        (resolveRef(schema, schema) as Record<string, unknown>)?.properties ??\n          {},\n      ),\n    );\n    for (const key of Object.keys(seed)) {\n      if (!schemaKeys.has(key) && !(key in result)) {\n        result[key] = seed[key];\n      }\n    }\n  }\n\n  return result ?? {};\n}\n\n/**\n * Resolve a $ref pointer against the root schema's $defs.\n * Supports nested $ref chains.\n */\nfunction resolveRef(\n  property: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seen?: Set<string>,\n): Record<string, unknown> {\n  if (!property || typeof property !== \"object\") return property;\n\n  const ref = property.$ref as string | undefined;\n  if (!ref) return property;\n\n  // Guard against circular refs\n  const visited = seen ?? new Set<string>();\n  if (visited.has(ref)) return property;\n  visited.add(ref);\n\n  const resolved = resolvePointer(root, ref);\n  if (!resolved) return property;\n\n  // Continue resolving if the result itself has a $ref\n  return resolveRef(resolved as Record<string, unknown>, root, visited);\n}\n\n/**\n * Resolve a JSON pointer like \"#/$defs/Price\" against an object.\n */\nfunction resolvePointer(\n  obj: Record<string, unknown>,\n  pointer: string,\n): unknown {\n  if (!pointer.startsWith(\"#/\")) return undefined;\n  const parts = pointer.slice(2).split(\"/\");\n  let current: unknown = obj;\n  for (const part of parts) {\n    if (current && typeof current === \"object\" && part in current) {\n      current = (current as Record<string, unknown>)[part];\n    } else {\n      return undefined;\n    }\n  }\n  return current;\n}\n\n/**\n * Initialize a single property value based on its schema definition.\n */\nfunction initProperty(\n  property: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed?: unknown,\n): unknown {\n  if (!property || typeof property !== \"object\") return null;\n\n  // Resolve $ref first\n  const resolved = resolveRef(property, root);\n\n  // Handle oneOf with discriminator — pick first variant\n  if (Array.isArray(resolved.oneOf)) {\n    return initOneOf(resolved, root, seed);\n  }\n\n  // Priority 1: seed wins (for object types, we merge recursively below)\n  // For non-object types, return seed directly if present\n  const type = resolved.type as string | undefined;\n  if (seed !== undefined && seed !== null && type !== \"object\") {\n    return seed;\n  }\n\n  // Priority 2: const\n  if (\"const\" in resolved) {\n    return resolved.const;\n  }\n\n  // Priority 3: single-value enum\n  if (\n    Array.isArray(resolved.enum) &&\n    (resolved.enum as unknown[]).length === 1\n  ) {\n    return (resolved.enum as unknown[])[0];\n  }\n\n  // Priority 4: default\n  if (\"default\" in resolved) {\n    return resolved.default;\n  }\n\n  // Priority 5: typed empty values\n  switch (type) {\n    case \"object\":\n      return initObject(resolved, root, seed as Record<string, unknown>);\n    case \"array\":\n      return seed !== undefined && seed !== null ? seed : [];\n    case \"string\":\n      return \"\";\n    case \"boolean\":\n      return false;\n    case \"number\":\n    case \"integer\":\n      return null;\n    default:\n      return null;\n  }\n}\n\n/**\n * Initialize an object type by recursing into its properties.\n */\nfunction initObject(\n  schema: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed?: Record<string, unknown>,\n): Record<string, unknown> {\n  const properties = schema.properties as\n    | Record<string, Record<string, unknown>>\n    | undefined;\n  if (!properties) {\n    // Object with no defined properties — return seed or empty object\n    return seed && typeof seed === \"object\" ? { ...seed } : {};\n  }\n\n  const result: Record<string, unknown> = {};\n\n  for (const [key, propSchema] of Object.entries(properties)) {\n    const seedValue = seed && typeof seed === \"object\" ? seed[key] : undefined;\n    result[key] = initProperty(propSchema, root, seedValue);\n  }\n\n  return result;\n}\n\n/**\n * Handle oneOf schemas — pick the first variant and initialize it.\n */\nfunction initOneOf(\n  schema: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed?: unknown,\n): unknown {\n  const variants = schema.oneOf as Record<string, unknown>[];\n  if (!variants || variants.length === 0) return null;\n\n  const first = variants[0];\n  if (!first) return null;\n\n  // Pick first variant, resolve its $ref if needed\n  const firstVariant = resolveRef(first, root);\n  return initProperty(firstVariant, root, seed);\n}\n"],"names":[],"mappings":"AAQO,SAAS,uBACd,QACA,MACyB;AACzB,QAAM,SAAS,aAAa,QAAQ,QAAQ,IAAI;AAGhD,MACE,UACA,OAAO,WAAW,YAClB,CAAC,MAAM,QAAQ,MAAM,KACrB,QACA,OAAO,SAAS,UAChB;AACA,UAAM,aAAa,IAAI;AAAA,MACrB,OAAO;AAAA,QACJ,WAAW,QAAQ,MAAM,GAA+B,cACvD,CAAA;AAAA,MAAC;AAAA,IACL;AAEF,eAAW,OAAO,OAAO,KAAK,IAAI,GAAG;AACnC,UAAI,CAAC,WAAW,IAAI,GAAG,KAAK,EAAE,OAAO,SAAS;AAC5C,eAAO,GAAG,IAAI,KAAK,GAAG;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAEA,SAAO,UAAU,CAAA;AACnB;AAMA,SAAS,WACP,UACA,MACA,MACyB;AACzB,MAAI,CAAC,YAAY,OAAO,aAAa,SAAU,QAAO;AAEtD,QAAM,MAAM,SAAS;AACrB,MAAI,CAAC,IAAK,QAAO;AAGjB,QAAM,UAAU,QAAQ,oBAAI,IAAA;AAC5B,MAAI,QAAQ,IAAI,GAAG,EAAG,QAAO;AAC7B,UAAQ,IAAI,GAAG;AAEf,QAAM,WAAW,eAAe,MAAM,GAAG;AACzC,MAAI,CAAC,SAAU,QAAO;AAGtB,SAAO,WAAW,UAAqC,MAAM,OAAO;AACtE;AAKA,SAAS,eACP,KACA,SACS;AACT,MAAI,CAAC,QAAQ,WAAW,IAAI,EAAG,QAAO;AACtC,QAAM,QAAQ,QAAQ,MAAM,CAAC,EAAE,MAAM,GAAG;AACxC,MAAI,UAAmB;AACvB,aAAW,QAAQ,OAAO;AACxB,QAAI,WAAW,OAAO,YAAY,YAAY,QAAQ,SAAS;AAC7D,gBAAW,QAAoC,IAAI;AAAA,IACrD,OAAO;AACL,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAKA,SAAS,aACP,UACA,MACA,MACS;AACT,MAAI,CAAC,YAAY,OAAO,aAAa,SAAU,QAAO;AAGtD,QAAM,WAAW,WAAW,UAAU,IAAI;AAG1C,MAAI,MAAM,QAAQ,SAAS,KAAK,GAAG;AACjC,WAAO,UAAU,UAAU,MAAM,IAAI;AAAA,EACvC;AAIA,QAAM,OAAO,SAAS;AACtB,MAAI,SAAS,UAAa,SAAS,QAAQ,SAAS,UAAU;AAC5D,WAAO;AAAA,EACT;AAGA,MAAI,WAAW,UAAU;AACvB,WAAO,SAAS;AAAA,EAClB;AAGA,MACE,MAAM,QAAQ,SAAS,IAAI,KAC1B,SAAS,KAAmB,WAAW,GACxC;AACA,WAAQ,SAAS,KAAmB,CAAC;AAAA,EACvC;AAGA,MAAI,aAAa,UAAU;AACzB,WAAO,SAAS;AAAA,EAClB;AAGA,UAAQ,MAAA;AAAA,IACN,KAAK;AACH,aAAO,WAAW,UAAU,MAAM,IAA+B;AAAA,IACnE,KAAK;AACH,aAAO,SAAS,UAAa,SAAS,OAAO,OAAO,CAAA;AAAA,IACtD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EAAA;AAEb;AAKA,SAAS,WACP,QACA,MACA,MACyB;AACzB,QAAM,aAAa,OAAO;AAG1B,MAAI,CAAC,YAAY;AAEf,WAAO,QAAQ,OAAO,SAAS,WAAW,EAAE,GAAG,KAAA,IAAS,CAAA;AAAA,EAC1D;AAEA,QAAM,SAAkC,CAAA;AAExC,aAAW,CAAC,KAAK,UAAU,KAAK,OAAO,QAAQ,UAAU,GAAG;AAC1D,UAAM,YAAY,QAAQ,OAAO,SAAS,WAAW,KAAK,GAAG,IAAI;AACjE,WAAO,GAAG,IAAI,aAAa,YAAY,MAAM,SAAS;AAAA,EACxD;AAEA,SAAO;AACT;AAKA,SAAS,UACP,QACA,MACA,MACS;AACT,QAAM,WAAW,OAAO;AACxB,MAAI,CAAC,YAAY,SAAS,WAAW,EAAG,QAAO;AAE/C,QAAM,QAAQ,SAAS,CAAC;AACxB,MAAI,CAAC,MAAO,QAAO;AAGnB,QAAM,eAAe,WAAW,OAAO,IAAI;AAC3C,SAAO,aAAa,cAAc,MAAM,IAAI;AAC9C;"}

package/dist/core/projection.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Projection utilities for navigating complex data structures
+ * through a dot-separated path where numeric segments are array indices.
+ *
+ * Examples:
+ *   "0"                → first element of an array
+ *   "include"          → the `include` property of an object
+ *   "0.video_rate_usd" → nested property inside the first array element
+ */
+export type ProjectionSegment = string | number;
+/**
+ * Parse a projection path string into typed segments.
+ * Numeric strings become numbers (array indices), others stay as strings (object keys).
+ */
+export declare 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 declare function getProjectedValue(data: unknown, path: string): unknown;
+/**
+ * Immutably set a value at the projection path, preserving all sibling data.
+ * Constructs missing intermediate structures (arrays for numeric segments, objects for string segments).
+ */
+export declare function setProjectedValue(data: unknown, path: string, value: unknown): unknown;
+/**
+ * Resolve the schema at the projected path.
+ * Numeric segments traverse into `items` (array item schema).
+ * String segments traverse into `properties[segment]`.
+ */
+export declare function getProjectedSchema(schema: Record<string, any>, path: string): Record<string, any>;
+//# sourceMappingURL=projection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/core/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAMrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,OAAO,CAGT;AAqCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAEhC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,IAAI,EAAE,MAAM,GAEX,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA8BrB"}

package/dist/core/projection.js

@@ -0,0 +1,74 @@
+function parseProjectionPath(path) {
+  if (!path) return [];
+  return path.split(".").map((s) => {
+    const n = Number(s);
+    return Number.isInteger(n) && n >= 0 ? n : s;
+  });
+}
+function getProjectedValue(data, path) {
+  const segments = parseProjectionPath(path);
+  let current = data;
+  for (const seg of segments) {
+    if (current === null || current === void 0) return void 0;
+    if (typeof seg === "number") {
+      if (!Array.isArray(current)) return void 0;
+      current = current[seg];
+    } else {
+      if (typeof current !== "object") return void 0;
+      current = current[seg];
+    }
+  }
+  return current;
+}
+function setProjectedValue(data, path, value) {
+  const segments = parseProjectionPath(path);
+  return setAtPath(data, segments, 0, value);
+}
+function setAtPath(current, segments, index, value) {
+  if (index === segments.length) {
+    return value;
+  }
+  const seg = segments[index];
+  if (typeof seg === "number") {
+    const arr = Array.isArray(current) ? [...current] : [];
+    while (arr.length <= seg) {
+      arr.push(void 0);
+    }
+    arr[seg] = setAtPath(arr[seg], segments, index + 1, value);
+    return arr;
+  } else {
+    const obj = current !== null && current !== void 0 && typeof current === "object" && !Array.isArray(current) ? { ...current } : {};
+    obj[seg] = setAtPath(obj[seg], segments, index + 1, value);
+    return obj;
+  }
+}
+function getProjectedSchema(schema, path) {
+  const segments = parseProjectionPath(path);
+  let current = schema;
+  for (const seg of segments) {
+    if (!current) return {};
+    if (typeof seg === "number") {
+      const items = current.items;
+      if (items && typeof items === "object") {
+        current = items;
+      } else {
+        return {};
+      }
+    } else {
+      const properties = current.properties;
+      if (properties && properties[seg]) {
+        current = properties[seg];
+      } else {
+        return {};
+      }
+    }
+  }
+  return current;
+}
+export {
+  getProjectedSchema,
+  getProjectedValue,
+  parseProjectionPath,
+  setProjectedValue
+};
+//# sourceMappingURL=projection.js.map

package/dist/core/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sources":["../../src/core/projection.ts"],"sourcesContent":["/**\n * Projection utilities for navigating complex data structures\n * through a dot-separated path where numeric segments are array indices.\n *\n * Examples:\n *   \"0\"                → first element of an array\n *   \"include\"          → the `include` property of an object\n *   \"0.video_rate_usd\" → nested property inside the first array element\n */\n\nexport type ProjectionSegment = string | number;\n\n/**\n * Parse a projection path string into typed segments.\n * Numeric strings become numbers (array indices), others stay as strings (object keys).\n */\nexport function parseProjectionPath(path: string): ProjectionSegment[] {\n  if (!path) return [];\n  return path.split(\".\").map((s) => {\n    const n = Number(s);\n    return Number.isInteger(n) && n >= 0 ? n : s;\n  });\n}\n\n/**\n * Read a value from `data` by following the projection path.\n * Returns `undefined` if any segment along the path is missing.\n */\nexport function getProjectedValue(data: unknown, path: string): unknown {\n  const segments = parseProjectionPath(path);\n  let current: unknown = data;\n\n  for (const seg of segments) {\n    if (current === null || current === undefined) return undefined;\n\n    if (typeof seg === \"number\") {\n      if (!Array.isArray(current)) return undefined;\n      current = current[seg];\n    } else {\n      if (typeof current !== \"object\") return undefined;\n      current = (current as Record<string, unknown>)[seg];\n    }\n  }\n\n  return current;\n}\n\n/**\n * Immutably set a value at the projection path, preserving all sibling data.\n * Constructs missing intermediate structures (arrays for numeric segments, objects for string segments).\n */\nexport function setProjectedValue(\n  data: unknown,\n  path: string,\n  value: unknown,\n): unknown {\n  const segments = parseProjectionPath(path);\n  return setAtPath(data, segments, 0, value);\n}\n\nfunction setAtPath(\n  current: unknown,\n  segments: ProjectionSegment[],\n  index: number,\n  value: unknown,\n): unknown {\n  if (index === segments.length) {\n    return value;\n  }\n\n  const seg = segments[index]!;\n\n  if (typeof seg === \"number\") {\n    // Array index — ensure we have an array\n    const arr = Array.isArray(current) ? [...current] : [];\n    // Pad array if index is out of bounds\n    while (arr.length <= seg) {\n      arr.push(undefined);\n    }\n    arr[seg] = setAtPath(arr[seg], segments, index + 1, value);\n    return arr;\n  } else {\n    // Object key — ensure we have an object\n    const obj: Record<string, unknown> =\n      current !== null &&\n      current !== undefined &&\n      typeof current === \"object\" &&\n      !Array.isArray(current)\n        ? { ...(current as Record<string, unknown>) }\n        : {};\n    obj[seg] = setAtPath(obj[seg], segments, index + 1, value);\n    return obj;\n  }\n}\n\n/**\n * Resolve the schema at the projected path.\n * Numeric segments traverse into `items` (array item schema).\n * String segments traverse into `properties[segment]`.\n */\nexport function getProjectedSchema(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schema: Record<string, any>,\n  path: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Record<string, any> {\n  const segments = parseProjectionPath(path);\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let current: Record<string, any> = schema;\n\n  for (const seg of segments) {\n    if (!current) return {};\n\n    if (typeof seg === \"number\") {\n      // Array index → traverse into items schema\n      const items = current.items;\n      if (items && typeof items === \"object\") {\n        current = items as Record<string, unknown>;\n      } else {\n        return {};\n      }\n    } else {\n      // Object key → traverse into properties[key]\n      const properties = current.properties as\n        | Record<string, Record<string, unknown>>\n        | undefined;\n      if (properties && properties[seg]) {\n        current = properties[seg];\n      } else {\n        return {};\n      }\n    }\n  }\n\n  return current;\n}\n"],"names":[],"mappings":"AAgBO,SAAS,oBAAoB,MAAmC;AACrE,MAAI,CAAC,KAAM,QAAO,CAAA;AAClB,SAAO,KAAK,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM;AAChC,UAAM,IAAI,OAAO,CAAC;AAClB,WAAO,OAAO,UAAU,CAAC,KAAK,KAAK,IAAI,IAAI;AAAA,EAC7C,CAAC;AACH;AAMO,SAAS,kBAAkB,MAAe,MAAuB;AACtE,QAAM,WAAW,oBAAoB,IAAI;AACzC,MAAI,UAAmB;AAEvB,aAAW,OAAO,UAAU;AAC1B,QAAI,YAAY,QAAQ,YAAY,OAAW,QAAO;AAEtD,QAAI,OAAO,QAAQ,UAAU;AAC3B,UAAI,CAAC,MAAM,QAAQ,OAAO,EAAG,QAAO;AACpC,gBAAU,QAAQ,GAAG;AAAA,IACvB,OAAO;AACL,UAAI,OAAO,YAAY,SAAU,QAAO;AACxC,gBAAW,QAAoC,GAAG;AAAA,IACpD;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,kBACd,MACA,MACA,OACS;AACT,QAAM,WAAW,oBAAoB,IAAI;AACzC,SAAO,UAAU,MAAM,UAAU,GAAG,KAAK;AAC3C;AAEA,SAAS,UACP,SACA,UACA,OACA,OACS;AACT,MAAI,UAAU,SAAS,QAAQ;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,MAAM,SAAS,KAAK;AAE1B,MAAI,OAAO,QAAQ,UAAU;AAE3B,UAAM,MAAM,MAAM,QAAQ,OAAO,IAAI,CAAC,GAAG,OAAO,IAAI,CAAA;AAEpD,WAAO,IAAI,UAAU,KAAK;AACxB,UAAI,KAAK,MAAS;AAAA,IACpB;AACA,QAAI,GAAG,IAAI,UAAU,IAAI,GAAG,GAAG,UAAU,QAAQ,GAAG,KAAK;AACzD,WAAO;AAAA,EACT,OAAO;AAEL,UAAM,MACJ,YAAY,QACZ,YAAY,UACZ,OAAO,YAAY,YACnB,CAAC,MAAM,QAAQ,OAAO,IAClB,EAAE,GAAI,QAAA,IACN,CAAA;AACN,QAAI,GAAG,IAAI,UAAU,IAAI,GAAG,GAAG,UAAU,QAAQ,GAAG,KAAK;AACzD,WAAO;AAAA,EACT;AACF;AAOO,SAAS,mBAEd,QACA,MAEqB;AACrB,QAAM,WAAW,oBAAoB,IAAI;AAEzC,MAAI,UAA+B;AAEnC,aAAW,OAAO,UAAU;AAC1B,QAAI,CAAC,QAAS,QAAO,CAAA;AAErB,QAAI,OAAO,QAAQ,UAAU;AAE3B,YAAM,QAAQ,QAAQ;AACtB,UAAI,SAAS,OAAO,UAAU,UAAU;AACtC,kBAAU;AAAA,MACZ,OAAO;AACL,eAAO,CAAA;AAAA,MACT;AAAA,IACF,OAAO;AAEL,YAAM,aAAa,QAAQ;AAG3B,UAAI,cAAc,WAAW,GAAG,GAAG;AACjC,kBAAU,WAAW,GAAG;AAAA,MAC1B,OAAO;AACL,eAAO,CAAA;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;"}

package/dist/core/resolveScope.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve a JSON Forms scope path to its schema within a root schema.
+ * Handles nested paths like "#/properties/parent/properties/child".
+ *
+ * Follows JSON Schema structure:
+ *   - "properties" segments navigate into object `.properties`
+ *   - "items" segments navigate into array `.items`
+ *   - all other segments index directly into the current object
+ */
+export declare function resolveScopeSchema(scope: string, rootSchema: Record<string, any>): Record<string, any> | undefined;
+//# sourceMappingURL=resolveScope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveScope.d.ts","sourceRoot":"","sources":["../../src/core/resolveScope.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EAEb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAE9B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAwBjC"}

package/dist/core/resolveScope.js

@@ -0,0 +1,22 @@
+function resolveScopeSchema(scope, rootSchema) {
+  if (!scope || !rootSchema) return void 0;
+  const path = scope.replace(/^#\/?/, "");
+  if (!path) return rootSchema;
+  const segments = path.split("/");
+  let current = rootSchema;
+  for (const segment of segments) {
+    if (!current || typeof current !== "object") return void 0;
+    if (segment === "properties") {
+      current = current.properties;
+    } else if (segment === "items") {
+      current = current.items;
+    } else {
+      current = current[segment];
+    }
+  }
+  return current;
+}
+export {
+  resolveScopeSchema
+};
+//# sourceMappingURL=resolveScope.js.map

package/dist/core/resolveScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveScope.js","sources":["../../src/core/resolveScope.ts"],"sourcesContent":["/**\n * Resolve a JSON Forms scope path to its schema within a root schema.\n * Handles nested paths like \"#/properties/parent/properties/child\".\n *\n * Follows JSON Schema structure:\n *   - \"properties\" segments navigate into object `.properties`\n *   - \"items\" segments navigate into array `.items`\n *   - all other segments index directly into the current object\n */\nexport function resolveScopeSchema(\n  scope: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  rootSchema: Record<string, any>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Record<string, any> | undefined {\n  if (!scope || !rootSchema) return undefined;\n\n  // Remove the leading \"#/\" and split into segments\n  const path = scope.replace(/^#\\/?/, \"\");\n  if (!path) return rootSchema;\n\n  const segments = path.split(\"/\");\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let current: any = rootSchema;\n\n  for (const segment of segments) {\n    if (!current || typeof current !== \"object\") return undefined;\n\n    if (segment === \"properties\") {\n      current = current.properties;\n    } else if (segment === \"items\") {\n      current = current.items;\n    } else {\n      current = current[segment];\n    }\n  }\n\n  return current;\n}\n"],"names":[],"mappings":"AASO,SAAS,mBACd,OAEA,YAEiC;AACjC,MAAI,CAAC,SAAS,CAAC,WAAY,QAAO;AAGlC,QAAM,OAAO,MAAM,QAAQ,SAAS,EAAE;AACtC,MAAI,CAAC,KAAM,QAAO;AAElB,QAAM,WAAW,KAAK,MAAM,GAAG;AAE/B,MAAI,UAAe;AAEnB,aAAW,WAAW,UAAU;AAC9B,QAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AAEpD,QAAI,YAAY,cAAc;AAC5B,gBAAU,QAAQ;AAAA,IACpB,WAAW,YAAY,SAAS;AAC9B,gBAAU,QAAQ;AAAA,IACpB,OAAO;AACL,gBAAU,QAAQ,OAAO;AAAA,IAC3B;AAAA,EACF;AAEA,SAAO;AACT;"}

package/dist/core/transforms.d.ts

@@ -11,24 +11,22 @@ export interface FlattenTransform extends Transform {
     key: string;
     labelFormat?: string;
 }
+export type FilterOperator = "eq" | "neq" | "empty" | "notEmpty" | "gt" | "gte" | "lt" | "lte" | "contains";
+export interface FilterCondition {
+    key: string;
+    operator?: FilterOperator;
+    values?: unknown[];
+}
 export interface FilterTransform extends Transform {
     name: "filter";
-    key: string;
+    key?: string;
     values?: unknown[];
+    conditions?: FilterCondition[];
 }
 export type TransformStep = FlattenTransform | FilterTransform;
 export type TransformPipeline = TransformStep[];
-/**
- * Registry of transform functions
- */
-type TransformFunction = (items: unknown[], config: Transform) => unknown[];
-/**
- * Register a transform function
- */
-export declare function registerTransform(name: string, fn: TransformFunction): void;
 /**
  * Apply a pipeline of transforms to data
  */
 export declare function applyTransformPipeline(items: unknown[], pipeline: TransformPipeline): unknown[];
-export {};
 //# sourceMappingURL=transforms.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../src/core/transforms.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAE/D,MAAM,MAAM,iBAAiB,GAAG,aAAa,EAAE,CAAC;AAEhD;;GAEG;AACH,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,EAAE,CAAC;AAI5E;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAE3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EAAE,EAChB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,EAAE,CAYX"}
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../src/core/transforms.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,KAAK,GACL,OAAO,GACP,UAAU,GACV,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAE/D,MAAM,MAAM,iBAAiB,GAAG,aAAa,EAAE,CAAC;AAMhD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EAAE,EAChB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,EAAE,CAYX"}

package/dist/core/transforms.js

@@ -1,7 +1,4 @@
 const transformRegistry = {};
-function registerTransform(name, fn) {
-  transformRegistry[name] = fn;
-}
 function applyTransformPipeline(items, pipeline) {
   let result = items;
   for (const transform of pipeline) {
@@ -59,23 +56,71 @@ function flattenTransform(items, config) {
   }
   return flattened;
 }
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (Array.isArray(value)) return value.length === 0;
+  if (typeof value === "string") return value.length === 0;
+  return false;
+}
+function evaluateCondition(itemObj, condition) {
+  const value = itemObj[condition.key];
+  const operator = condition.operator ?? (condition.values ? "eq" : "eq");
+  switch (operator) {
+    case "eq":
+      if (!condition.values || condition.values.length === 0) {
+        return condition.key in itemObj;
+      }
+      return condition.values.includes(value);
+    case "neq":
+      if (!condition.values || condition.values.length === 0) {
+        return !(condition.key in itemObj);
+      }
+      return !condition.values.includes(value);
+    case "empty":
+      return isEmpty(value);
+    case "notEmpty":
+      return !isEmpty(value);
+    case "gt":
+      return typeof value === "number" && condition.values !== void 0 && value > condition.values[0];
+    case "gte":
+      return typeof value === "number" && condition.values !== void 0 && value >= condition.values[0];
+    case "lt":
+      return typeof value === "number" && condition.values !== void 0 && value < condition.values[0];
+    case "lte":
+      return typeof value === "number" && condition.values !== void 0 && value <= condition.values[0];
+    case "contains":
+      if (typeof value === "string" && condition.values) {
+        return condition.values.some((v) => value.includes(String(v)));
+      }
+      if (Array.isArray(value) && condition.values) {
+        return condition.values.some((v) => value.includes(v));
+      }
+      return false;
+    default:
+      return false;
+  }
+}
 function filterTransform(items, config) {
   const filterConfig = config;
-  const { key, values } = filterConfig;
+  let conditions;
+  if (filterConfig.conditions) {
+    conditions = filterConfig.conditions;
+  } else if (filterConfig.key) {
+    conditions = [{ key: filterConfig.key, values: filterConfig.values }];
+  } else {
+    return items;
+  }
   return items.filter((item) => {
     if (typeof item !== "object" || item === null) return false;
     const itemObj = item;
-    if (!values || values.length === 0) {
-      return key in itemObj;
-    }
-    const itemValue = itemObj[key];
-    return values.includes(itemValue);
+    return conditions.every(
+      (condition) => evaluateCondition(itemObj, condition)
+    );
   });
 }
-registerTransform("flatten", flattenTransform);
-registerTransform("filter", filterTransform);
+transformRegistry["flatten"] = flattenTransform;
+transformRegistry["filter"] = filterTransform;
 export {
-  applyTransformPipeline,
-  registerTransform
+  applyTransformPipeline
 };
 //# sourceMappingURL=transforms.js.map