@revisium/schema-toolkit 0.21.5 → 0.22.1

package/README.md

@@ -49,7 +49,41 @@ row.getValue('name');           // string (typed!)
 row.setValue('price', 19.99);   // OK
 row.setValue('price', 'wrong'); // TS Error!
 row.getPlainValue();            // { name: string, price: number }
-row.getPatches();               // JSON Patch operations
+row.patches;                    // JSON Patch operations
+row.root;                       // typed root node (InferNode<S>)
+row.reset({ name: 'New', price: 0 }); // reset to new data, commit
+row.reset();                    // reset to schema defaults
+```
+
+### Array Search
+
+Arrays expose `find` and `findIndex` for searching elements by node properties:
+
+```typescript
+import { obj, str, arr, createRowModel } from '@revisium/schema-toolkit';
+
+const schema = obj({
+  sorts: arr(obj({ field: str(), direction: str() })),
+});
+
+const row = createRowModel({
+  rowId: 'row-1',
+  schema,
+  data: { sorts: [
+    { field: 'name', direction: 'asc' },
+    { field: 'age', direction: 'desc' },
+  ]},
+});
+
+const sortsNode = row.get('sorts');
+// find returns the typed node
+const ageSort = sortsNode.find(
+  (node) => node.child('field').getPlainValue() === 'age',
+);
+// findIndex returns the index
+const idx = sortsNode.findIndex(
+  (node) => node.child('field').getPlainValue() === 'age',
+); // 1
 ```
 
 ### TableModel
@@ -215,6 +249,33 @@ See [ForeignKeyResolver docs](src/model/foreign-key-resolver/README.md) for cach
 | `createRowModel(options)` | Create a row model (typed overload when schema is typed) |
 | `createTableModel(options)` | Create a table model (typed overload when schema is typed) |
 
+#### RowModel
+
+| Property / Method | Description |
+|-------------------|-------------|
+| `root` | Typed root node (`InferNode<S>` for typed, `ValueNode` for untyped) |
+| `get(path)` | Get node at path |
+| `getValue(path)` | Get plain value at path |
+| `setValue(path, value)` | Set value at path |
+| `getPlainValue()` | Get full plain value |
+| `patches` | JSON Patch operations (`JsonValuePatch[]`) for current changes |
+| `reset(data?)` | Reset to given data (or schema defaults) and commit |
+| `commit()` | Commit current state as base |
+| `revert()` | Revert to last committed state |
+
+#### ArrayValueNode
+
+| Method | Description |
+|--------|-------------|
+| `at(index)` | Get element at index (supports negative) |
+| `find(predicate)` | Find first element matching predicate, or `undefined` |
+| `findIndex(predicate)` | Find index of first matching element, or `-1` |
+| `push(node)` | Append element |
+| `pushValue(value?)` | Create and append element from value |
+| `removeAt(index)` | Remove element at index |
+| `move(from, to)` | Move element between positions |
+| `clear()` | Remove all elements |
+
 ### Value Tree
 
 | Function | Description |
@@ -268,7 +329,7 @@ See [ForeignKeyResolver docs](src/model/foreign-key-resolver/README.md) for cach
 | `InferNode<S>` | Schema → typed ValueNode interface |
 | `SchemaFromValue<T>` | Plain TS type → virtual schema shape |
 | `SchemaPaths<S>` | Union of all valid dot-separated paths |
-| `TypedRowModel<S>` | RowModel with typed `getValue`, `setValue`, `getPlainValue` |
+| `TypedRowModel<S>` | RowModel with typed `root`, `getValue`, `setValue`, `getPlainValue`, `reset` |
 | `TypedTableModel<S>` | TableModel with typed rows, `addRow`, `getRow` |
 
 See [Typed API documentation](src/types/TYPED-API.md) for the full reference.

package/dist/chunk-5G3AVY57.js

@@ -0,0 +1 @@
+

package/dist/chunk-5M74TGFQ.cjs

@@ -0,0 +1,2 @@
+'use strict';
+

package/dist/{chunk-XKWWCXGB.js → chunk-6IMYMTFF.js}

@@ -317,25 +317,6 @@ var jsonPatchSchema = {
   type: "array"
 };
 
-// src/validation-schemas/history-patches-schema.ts
-var historyPatchesSchema = {
-  $id: "history-patches-schema.json",
-  type: "array",
-  minItems: 1,
-  items: {
-    type: "object",
-    properties: {
-      patches: {
-        $ref: "json-patch-schema.json"
-      },
-      hash: {
-        type: "string"
-      }
-    },
-    required: ["patches", "hash"]
-  }
-};
-
 // src/validation-schemas/table-migrations-schema.ts
 var tableMigrationsSchema = {
   $id: "table-migrations-schema.json",
@@ -395,4 +376,147 @@ var tableMigrationsSchema = {
   title: "JSON Schema for a Single Migration"
 };
 
-export { arrayMetaSchema, baseStringFields, booleanMetaSchema, foreignKeyExcludesFormula, historyPatchesSchema, jsonPatchSchema, metaSchema, noForeignKeyStringMetaSchema, notForeignKeyMetaSchema, numberMetaSchema, objectMetaSchema, refMetaSchema, sharedFields, stringMetaSchema, tableMigrationsSchema, xFormulaRequiresReadOnly, xFormulaSchema };
+// src/validation-schemas/history-patches-schema.ts
+var historyPatchesSchema = {
+  $id: "history-patches-schema.json",
+  type: "array",
+  minItems: 1,
+  items: {
+    type: "object",
+    properties: {
+      patches: {
+        $ref: "json-patch-schema.json"
+      },
+      hash: {
+        type: "string"
+      }
+    },
+    required: ["patches", "hash"]
+  }
+};
+
+// src/validation-schemas/table-views-schema.ts
+var tableViewsSchema = {
+  $id: "table-views-schema.json",
+  type: "object",
+  additionalProperties: false,
+  required: ["version", "views"],
+  properties: {
+    version: {
+      type: "integer",
+      minimum: 1,
+      default: 1
+    },
+    defaultViewId: {
+      type: "string",
+      default: "default"
+    },
+    views: {
+      type: "array",
+      items: { $ref: "#/$defs/View" },
+      default: []
+    }
+  },
+  $defs: {
+    View: {
+      type: "object",
+      additionalProperties: false,
+      required: ["id", "name"],
+      properties: {
+        id: { type: "string", minLength: 1 },
+        name: { type: "string", minLength: 1, maxLength: 100 },
+        description: { type: "string", maxLength: 500, default: "" },
+        columns: {
+          oneOf: [
+            { type: "null" },
+            { type: "array", items: { $ref: "#/$defs/Column" } }
+          ],
+          default: null
+        },
+        filters: { $ref: "#/$defs/FilterGroup" },
+        sorts: {
+          type: "array",
+          items: { $ref: "#/$defs/Sort" },
+          default: []
+        },
+        search: {
+          type: "string",
+          default: ""
+        }
+      }
+    },
+    Column: {
+      type: "object",
+      additionalProperties: false,
+      required: ["field"],
+      properties: {
+        field: { type: "string", minLength: 1 },
+        width: { type: "number", minimum: 40 },
+        pinned: { type: "string", enum: ["left", "right"] }
+      }
+    },
+    FilterGroup: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        logic: {
+          type: "string",
+          enum: ["and", "or"],
+          default: "and"
+        },
+        conditions: {
+          type: "array",
+          items: { $ref: "#/$defs/FilterCondition" },
+          default: []
+        },
+        groups: {
+          type: "array",
+          items: { $ref: "#/$defs/FilterGroup" },
+          default: []
+        }
+      }
+    },
+    FilterCondition: {
+      type: "object",
+      additionalProperties: false,
+      required: ["field", "operator"],
+      properties: {
+        field: { type: "string", minLength: 1 },
+        operator: {
+          type: "string",
+          enum: [
+            "equals",
+            "not_equals",
+            "contains",
+            "not_contains",
+            "starts_with",
+            "ends_with",
+            "is_empty",
+            "is_not_empty",
+            "gt",
+            "gte",
+            "lt",
+            "lte",
+            "is_true",
+            "is_false"
+          ]
+        },
+        value: {}
+      }
+    },
+    Sort: {
+      type: "object",
+      additionalProperties: false,
+      required: ["field", "direction"],
+      properties: {
+        field: { type: "string", minLength: 1 },
+        direction: {
+          type: "string",
+          enum: ["asc", "desc"]
+        }
+      }
+    }
+  }
+};
+
+export { arrayMetaSchema, baseStringFields, booleanMetaSchema, foreignKeyExcludesFormula, historyPatchesSchema, jsonPatchSchema, metaSchema, noForeignKeyStringMetaSchema, notForeignKeyMetaSchema, numberMetaSchema, objectMetaSchema, refMetaSchema, sharedFields, stringMetaSchema, tableMigrationsSchema, tableViewsSchema, xFormulaRequiresReadOnly, xFormulaSchema };

package/dist/{chunk-RXPIMS7W.js → chunk-B3W5BASK.js}

@@ -1742,6 +1742,12 @@ var ArrayValueNode = class extends BaseValueNode {
     }
     return this._items[index];
   }
+  find(predicate) {
+    return this._items.find((node, index) => predicate(node, index));
+  }
+  findIndex(predicate) {
+    return this._items.findIndex((node, index) => predicate(node, index));
+  }
   push(node) {
     node.parent = this;
     this._items.push(node);
@@ -3137,12 +3143,16 @@ var ValueTree = class {
 // src/model/table/row/RowModelImpl.ts
 var UNSET_INDEX = -1;
 var RowModelImpl = class {
-  constructor(_rowId, _tree) {
+  constructor(_rowId, _tree, _schema, _refSchemas) {
     this._rowId = _rowId;
     this._tree = _tree;
+    this._schema = _schema;
+    this._refSchemas = _refSchemas;
     makeAutoObservable(this, {
       _rowId: false,
       _tree: false,
+      _schema: false,
+      _refSchemas: false,
       _tableModel: "observable.ref"
     });
   }
@@ -3156,6 +3166,9 @@ var RowModelImpl = class {
   get tree() {
     return this._tree;
   }
+  get root() {
+    return this._tree.root;
+  }
   get index() {
     if (!this._tableModel) {
       return UNSET_INDEX;
@@ -3215,6 +3228,11 @@ var RowModelImpl = class {
   revert() {
     this._tree.revert();
   }
+  reset(data) {
+    const value = data ?? generateDefaultValue(this._schema, { refSchemas: this._refSchemas });
+    this._tree.setValue("", value);
+    this._tree.commit();
+  }
   dispose() {
     this._tree.dispose();
   }
@@ -3232,7 +3250,7 @@ function createRowModel(options) {
   const valueTree = new ValueTree(rootNode);
   const formulaEngine = new FormulaEngine(valueTree);
   valueTree.setFormulaEngine(formulaEngine);
-  return new RowModelImpl(options.rowId, valueTree);
+  return new RowModelImpl(options.rowId, valueTree, options.schema, options.refSchemas);
 }
 
 // src/model/table/TableModelImpl.ts

package/dist/{chunk-QKA7DJDN.cjs → chunk-C3HDJOTY.cjs}

@@ -319,25 +319,6 @@ var jsonPatchSchema = {
   type: "array"
 };
 
-// src/validation-schemas/history-patches-schema.ts
-var historyPatchesSchema = {
-  $id: "history-patches-schema.json",
-  type: "array",
-  minItems: 1,
-  items: {
-    type: "object",
-    properties: {
-      patches: {
-        $ref: "json-patch-schema.json"
-      },
-      hash: {
-        type: "string"
-      }
-    },
-    required: ["patches", "hash"]
-  }
-};
-
 // src/validation-schemas/table-migrations-schema.ts
 var tableMigrationsSchema = {
   $id: "table-migrations-schema.json",
@@ -397,6 +378,149 @@ var tableMigrationsSchema = {
   title: "JSON Schema for a Single Migration"
 };
 
+// src/validation-schemas/history-patches-schema.ts
+var historyPatchesSchema = {
+  $id: "history-patches-schema.json",
+  type: "array",
+  minItems: 1,
+  items: {
+    type: "object",
+    properties: {
+      patches: {
+        $ref: "json-patch-schema.json"
+      },
+      hash: {
+        type: "string"
+      }
+    },
+    required: ["patches", "hash"]
+  }
+};
+
+// src/validation-schemas/table-views-schema.ts
+var tableViewsSchema = {
+  $id: "table-views-schema.json",
+  type: "object",
+  additionalProperties: false,
+  required: ["version", "views"],
+  properties: {
+    version: {
+      type: "integer",
+      minimum: 1,
+      default: 1
+    },
+    defaultViewId: {
+      type: "string",
+      default: "default"
+    },
+    views: {
+      type: "array",
+      items: { $ref: "#/$defs/View" },
+      default: []
+    }
+  },
+  $defs: {
+    View: {
+      type: "object",
+      additionalProperties: false,
+      required: ["id", "name"],
+      properties: {
+        id: { type: "string", minLength: 1 },
+        name: { type: "string", minLength: 1, maxLength: 100 },
+        description: { type: "string", maxLength: 500, default: "" },
+        columns: {
+          oneOf: [
+            { type: "null" },
+            { type: "array", items: { $ref: "#/$defs/Column" } }
+          ],
+          default: null
+        },
+        filters: { $ref: "#/$defs/FilterGroup" },
+        sorts: {
+          type: "array",
+          items: { $ref: "#/$defs/Sort" },
+          default: []
+        },
+        search: {
+          type: "string",
+          default: ""
+        }
+      }
+    },
+    Column: {
+      type: "object",
+      additionalProperties: false,
+      required: ["field"],
+      properties: {
+        field: { type: "string", minLength: 1 },
+        width: { type: "number", minimum: 40 },
+        pinned: { type: "string", enum: ["left", "right"] }
+      }
+    },
+    FilterGroup: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        logic: {
+          type: "string",
+          enum: ["and", "or"],
+          default: "and"
+        },
+        conditions: {
+          type: "array",
+          items: { $ref: "#/$defs/FilterCondition" },
+          default: []
+        },
+        groups: {
+          type: "array",
+          items: { $ref: "#/$defs/FilterGroup" },
+          default: []
+        }
+      }
+    },
+    FilterCondition: {
+      type: "object",
+      additionalProperties: false,
+      required: ["field", "operator"],
+      properties: {
+        field: { type: "string", minLength: 1 },
+        operator: {
+          type: "string",
+          enum: [
+            "equals",
+            "not_equals",
+            "contains",
+            "not_contains",
+            "starts_with",
+            "ends_with",
+            "is_empty",
+            "is_not_empty",
+            "gt",
+            "gte",
+            "lt",
+            "lte",
+            "is_true",
+            "is_false"
+          ]
+        },
+        value: {}
+      }
+    },
+    Sort: {
+      type: "object",
+      additionalProperties: false,
+      required: ["field", "direction"],
+      properties: {
+        field: { type: "string", minLength: 1 },
+        direction: {
+          type: "string",
+          enum: ["asc", "desc"]
+        }
+      }
+    }
+  }
+};
+
 exports.arrayMetaSchema = arrayMetaSchema;
 exports.baseStringFields = baseStringFields;
 exports.booleanMetaSchema = booleanMetaSchema;
@@ -412,5 +536,6 @@ exports.refMetaSchema = refMetaSchema;
 exports.sharedFields = sharedFields;
 exports.stringMetaSchema = stringMetaSchema;
 exports.tableMigrationsSchema = tableMigrationsSchema;
+exports.tableViewsSchema = tableViewsSchema;
 exports.xFormulaRequiresReadOnly = xFormulaRequiresReadOnly;
 exports.xFormulaSchema = xFormulaSchema;

package/dist/{chunk-DN2C3T5D.cjs → chunk-JHNATNUI.cjs}

@@ -1744,6 +1744,12 @@ var ArrayValueNode = class extends BaseValueNode {
     }
     return this._items[index];
   }
+  find(predicate) {
+    return this._items.find((node, index) => predicate(node, index));
+  }
+  findIndex(predicate) {
+    return this._items.findIndex((node, index) => predicate(node, index));
+  }
   push(node) {
     node.parent = this;
     this._items.push(node);
@@ -3139,12 +3145,16 @@ var ValueTree = class {
 // src/model/table/row/RowModelImpl.ts
 var UNSET_INDEX = -1;
 var RowModelImpl = class {
-  constructor(_rowId, _tree) {
+  constructor(_rowId, _tree, _schema, _refSchemas) {
     this._rowId = _rowId;
     this._tree = _tree;
+    this._schema = _schema;
+    this._refSchemas = _refSchemas;
     chunkPJ5OFCLO_cjs.makeAutoObservable(this, {
       _rowId: false,
       _tree: false,
+      _schema: false,
+      _refSchemas: false,
       _tableModel: "observable.ref"
     });
   }
@@ -3158,6 +3168,9 @@ var RowModelImpl = class {
   get tree() {
     return this._tree;
   }
+  get root() {
+    return this._tree.root;
+  }
   get index() {
     if (!this._tableModel) {
       return UNSET_INDEX;
@@ -3217,6 +3230,11 @@ var RowModelImpl = class {
   revert() {
     this._tree.revert();
   }
+  reset(data) {
+    const value = data ?? generateDefaultValue(this._schema, { refSchemas: this._refSchemas });
+    this._tree.setValue("", value);
+    this._tree.commit();
+  }
   dispose() {
     this._tree.dispose();
   }
@@ -3234,7 +3252,7 @@ function createRowModel(options) {
   const valueTree = new ValueTree(rootNode);
   const formulaEngine = new FormulaEngine(valueTree);
   valueTree.setFormulaEngine(formulaEngine);
-  return new RowModelImpl(options.rowId, valueTree);
+  return new RowModelImpl(options.rowId, valueTree, options.schema, options.refSchemas);
 }
 
 // src/model/table/TableModelImpl.ts