jilt 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sandro Hawke
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,432 @@
+# jilt - JSON object filtering
+
+Toolkit for turning human-readable/human-writable filter expressions
+into executable functions which check if a JSON object matches.
+
+Vibe coded by codex using model gpt-5.2-codex.
+
+## Quickstart
+
+```js
+import jilt from '@walkable/jilt'
+
+const expr1 = jilt.parse('color = "red" and weight < 3.2 and size.x > 1')
+
+console.log(expr1.tree())
+// ['and', ['eq', ['field', 'color'], ['literal', 'red']], ...]
+
+const func1 = expr1.compile()
+
+console.log(func1({color: 'red', weight: 3, size: {x: 2, y: 2}}))
+// => true
+
+console.log(func1({color: 'red', weight: 3, size: {x: 1, y: 2}}))
+// => false
+```
+
+## CLI
+
+```bash
+# Test an expression against JSON input
+echo '{"color": "red", "weight": 3}' | jilt 'color = "red" and weight < 5'
+# => true
+
+# Parse and display the AST
+jilt --tree 'color = "red" and weight < 5'
+# => ['and', ['eq', ['field', 'color'], ['literal', 'red']], ['lt', ['field', 'weight'], ['literal', 5]]]
+
+# Interactive mode - enter JSON objects, see if they match
+jilt -i 'price < 100 and inStock = true'
+> {"price": 50, "inStock": true}
+true
+> {"price": 150, "inStock": true}
+false
+```
+
+## Expression Syntax
+
+### Literals
+
+| Type | Examples |
+|------|----------|
+| String | `"hello"`, `'hello'` |
+| Number | `42`, `3.14`, `-10`, `2.5e10` |
+| Boolean | `true`, `false` |
+| Null | `null` |
+
+### Field Access
+
+Access object properties using dot notation or bracket notation:
+
+```
+name                  # top-level field
+user.name             # nested field
+user.address.city     # deeply nested
+items[0]              # array index
+items[0].name         # array index then field
+user["first name"]    # bracket notation for special characters
+```
+
+### Comparison Operators
+
+| Operator | Aliases | Description |
+|----------|---------|-------------|
+| `=` | `==`, `eq` | Equal |
+| `!=` | `<>`, `ne` | Not equal |
+| `<` | `lt` | Less than |
+| `<=` | `le` | Less than or equal |
+| `>` | `gt` | Greater than |
+| `>=` | `ge` | Greater than or equal |
+
+### Logical Operators
+
+| Operator | Description |
+|----------|-------------|
+| `and` | Logical AND |
+| `or` | Logical OR |
+| `not` | Logical NOT |
+
+Parentheses control precedence:
+
+```
+(color = "red" or color = "blue") and weight < 5
+not (status = "deleted")
+```
+
+### Arithmetic Operators
+
+| Operator | Description |
+|----------|-------------|
+| `+` | Addition |
+| `-` | Subtraction |
+| `*` | Multiplication |
+| `/` | Division |
+| `%` | Modulo |
+
+```
+price * quantity > 100
+(width + height) / 2 >= 10
+count % 2 = 0
+```
+
+### String Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `length(s)` | String length | `length(name) > 5` |
+| `upper(s)` | Uppercase | `upper(status) = "ACTIVE"` |
+| `lower(s)` | Lowercase | `lower(email) = "test@example.com"` |
+| `trim(s)` | Remove leading/trailing whitespace | `trim(input) != ""` |
+| `contains(s, sub)` | Check if string contains substring | `contains(title, "urgent")` |
+| `startsWith(s, prefix)` | Check if string starts with prefix | `startsWith(id, "usr_")` |
+| `endsWith(s, suffix)` | Check if string ends with suffix | `endsWith(filename, ".json")` |
+| `substr(s, start)` | Substring from start index | `substr(code, 0, 2) = "US"` |
+| `substr(s, start, len)` | Substring with length | `substr(code, 0, 2) = "US"` |
+| `concat(s1, s2, ...)` | Concatenate strings | `concat(first, " ", last)` |
+| `replace(s, old, new)` | Replace first occurrence | `replace(path, "/old/", "/new/")` |
+| `split(s, delim)` | Split string into array | `length(split(tags, ",")) > 2` |
+
+### Pattern Matching
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `regex(s, pattern)` | Match against regular expression | `regex(email, "^[a-z]+@[a-z]+\\.[a-z]+$")` |
+| `like(s, pattern)` | SQL-style wildcards: `%` = any chars, `_` = single char | `like(email, "%@gmail.com")` |
+| `glob(s, pattern)` | Shell-style wildcards: `*` = any chars, `?` = single char | `glob(filename, "*.json")` |
+
+Pattern matching examples:
+
+```
+# SQL-style LIKE
+like(name, "John%")           # starts with "John"
+like(code, "A_B")             # "A" + any single char + "B"
+like(email, "%@%.com")        # contains "@" and ends with ".com"
+
+# Shell-style glob
+glob(file, "*.txt")           # ends with ".txt"
+glob(path, "/home/*/docs")    # any user's docs folder
+glob(name, "test?.js")        # test1.js, testA.js, etc.
+
+# Regular expressions
+regex(phone, "^\\d{3}-\\d{4}$")           # 123-4567
+regex(id, "^[A-Z]{2}\\d{6}$")             # US123456
+regex(version, "^v\\d+\\.\\d+\\.\\d+$")   # v1.2.3
+```
+
+### Path Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `basename(path)` | Get filename from path | `basename("/foo/bar.txt") = "bar.txt"` |
+| `dirname(path)` | Get directory from path | `dirname("/foo/bar.txt") = "/foo"` |
+| `ext(path)` | Get file extension (without dot) | `ext("/foo/bar.txt") = "txt"` |
+
+Path function examples:
+
+```
+ext(filename) = "json"
+basename(path) = "config.yaml"
+dirname(file) = "/etc/myapp"
+startsWith(dirname(path), "/home/admin")
+```
+
+### Array Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `length(arr)` | Array length | `length(items) > 0` |
+| `contains(arr, val)` | Check if array contains value | `contains(tags, "featured")` |
+| `first(arr)` | First element | `first(scores) > 90` |
+| `last(arr)` | Last element | `last(events).type = "complete"` |
+| `at(arr, index)` | Element at index | `at(items, 2).price < 10` |
+| `sum(arr)` | Sum of numeric array | `sum(prices) < 1000` |
+| `avg(arr)` | Average of numeric array | `avg(scores) >= 70` |
+| `min(arr)` | Minimum value | `min(bids) > 100` |
+| `max(arr)` | Maximum value | `max(temperatures) < 30` |
+| `join(arr, delim)` | Join array into string | `join(names, ", ")` |
+| `reverse(arr)` | Reverse array | `first(reverse(items))` |
+| `sort(arr)` | Sort array ascending | `first(sort(scores))` |
+| `unique(arr)` | Remove duplicates | `length(unique(tags)) = length(tags)` |
+
+### Array Predicates
+
+Test conditions across array elements using `@` to reference the current element:
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `any(arr, pred)` | True if any element matches | `any(items, @.price > 100)` |
+| `all(arr, pred)` | True if all elements match | `all(scores, @ >= 60)` |
+| `none(arr, pred)` | True if no elements match | `none(items, @.status = "error")` |
+| `count(arr, pred)` | Count matching elements | `count(items, @.inStock) > 5` |
+| `filter(arr, pred)` | Filter to matching elements | `length(filter(users, @.active)) > 0` |
+| `map(arr, expr)` | Transform elements | `sum(map(items, @.price * @.qty))` |
+
+### Type Checking
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `type(val)` | Get type as string | `type(data) = "array"` |
+| `isString(val)` | Check if string | `isString(name)` |
+| `isNumber(val)` | Check if number | `isNumber(count)` |
+| `isBool(val)` | Check if boolean | `isBool(enabled)` |
+| `isNull(val)` | Check if null | `isNull(deletedAt)` |
+| `isArray(val)` | Check if array | `isArray(tags)` |
+| `isObject(val)` | Check if object | `isObject(metadata)` |
+
+### Conditional
+
+```
+if(condition, thenValue, elseValue)
+```
+
+Example:
+```
+if(premium, price * 0.9, price) < 50
+```
+
+### Null Handling
+
+| Operator | Description | Example |
+|----------|-------------|---------|
+| `??` | Null coalescing | `(nickname ?? name) = "Admin"` |
+| `?.` | Optional chaining | `user?.profile?.avatar != null` |
+
+## Operator Precedence
+
+From highest to lowest:
+
+1. Parentheses `()`
+2. Function calls, field access `.`, `[]`, `?.`
+3. Unary `not`, `-`
+4. Multiplicative `*`, `/`, `%`
+5. Additive `+`, `-`
+6. Comparison `=`, `!=`, `<`, `<=`, `>`, `>=`
+7. Logical `and`
+8. Logical `or`
+9. Null coalescing `??`
+
+## Complex Examples
+
+### Computed string comparison
+
+Check if concatenated name fields match the full name:
+
+```
+concat(firstName, " ", lastName) = fullName
+```
+
+With case-insensitive comparison:
+
+```
+lower(concat(firstName, " ", lastName)) = lower(fullName)
+```
+
+### Validating data consistency
+
+Check that line items sum to the total:
+
+```
+sum(map(items, @.price * @.quantity)) = orderTotal
+```
+
+Verify no duplicate IDs in an array:
+
+```
+length(unique(map(items, @.id))) = length(items)
+```
+
+### Complex filtering conditions
+
+Find orders with at least one high-value item that's in stock:
+
+```
+any(items, @.price > 100 and @.inStock = true) and status != "cancelled"
+```
+
+Filter files by extension and location:
+
+```
+ext(path) = "log" and startsWith(dirname(path), "/var/log")
+```
+
+Match versioned config files:
+
+```
+glob(filename, "config-v*.json") and dirname(path) = "/etc/myapp"
+```
+
+### Conditional pricing logic
+
+Apply tiered discount based on quantity:
+
+```
+price * quantity * if(quantity > 100, 0.8, if(quantity > 50, 0.9, 1.0)) < budget
+```
+
+### Working with nested data
+
+Check that all addresses in a user's profile have a valid zip code:
+
+```
+all(user.addresses, regex(@.zipCode, "^\\d{5}(-\\d{4})?$"))
+```
+
+Find users who have made a purchase in a specific category:
+
+```
+any(purchases, @.category = "electronics" and @.amount > 500)
+```
+
+### Null-safe operations
+
+Handle potentially missing nested fields:
+
+```
+(user?.profile?.email ?? user?.email ?? "unknown") != "unknown"
+```
+
+Check optional array:
+
+```
+length(tags ?? []) > 0
+```
+
+## AST Format
+
+The parsed expression is represented as a JSON-compatible tree:
+
+```js
+// Input: 'color = "red" and price < 100'
+// AST:
+['and',
+  ['eq', ['field', 'color'], ['literal', 'red']],
+  ['lt', ['field', 'price'], ['literal', 100]]
+]
+```
+
+### Node Types
+
+| Node | Format |
+|------|--------|
+| Literal | `['literal', value]` |
+| Field access | `['field', 'name']` or `['field', 'parent', 'child']` |
+| Comparison | `['eq' \| 'ne' \| 'lt' \| 'le' \| 'gt' \| 'ge', left, right]` |
+| Logical | `['and' \| 'or', ...children]` or `['not', child]` |
+| Arithmetic | `['add' \| 'sub' \| 'mul' \| 'div' \| 'mod', left, right]` |
+| Function call | `['call', 'funcName', ...args]` |
+| Array index | `['index', array, indexExpr]` |
+| Conditional | `['if', condition, thenExpr, elseExpr]` |
+| Null coalesce | `['coalesce', left, right]` |
+| Optional chain | `['optfield', base, 'fieldName']` |
+
+## JavaScript API
+
+### `jilt.parse(expression: string): Expression`
+
+Parse an expression string into an Expression object.
+
+```js
+const expr = jilt.parse('status = "active"')
+```
+
+### `Expression.tree(): Array`
+
+Get the AST representation.
+
+```js
+expr.tree()
+// => ['eq', ['field', 'status'], ['literal', 'active']]
+```
+
+### `Expression.compile(): (obj: any) => boolean`
+
+Compile to an executable function.
+
+```js
+const match = expr.compile()
+match({status: 'active'})  // => true
+match({status: 'deleted'}) // => false
+```
+
+### `Expression.toString(): string`
+
+Convert back to expression string (normalized form).
+
+```js
+jilt.parse('x=1 AND y = 2').toString()
+// => 'x = 1 and y = 2'
+```
+
+### `jilt.evaluate(expression: string, obj: any): boolean`
+
+Parse, compile, and evaluate in one step.
+
+```js
+jilt.evaluate('price < 100', {price: 50})
+// => true
+```
+
+### `jilt.evaluateConstant(node: ExprNode, options?): unknown`
+
+Evaluate an AST node as a constant expression (no input object needed).
+
+```js
+const expr = jilt.parse('2 + 3 * 4')
+jilt.evaluateConstant(expr.tree())
+// => 14
+```
+
+## Error Handling
+
+Parse errors include position information:
+
+```js
+try {
+  jilt.parse('name = ')
+} catch (e) {
+  console.log(e.message)
+  // => "Unexpected end of expression at position 7"
+  console.log(e.position)
+  // => 7
+}
+```

package/dist/ast.d.ts

@@ -0,0 +1,62 @@
+export type LiteralValue = string | number | boolean | null | unknown[];
+export type LiteralNode = {
+    type: 'literal';
+    value: LiteralValue;
+};
+export type FieldNode = {
+    type: 'field';
+    base: ExprNode | null;
+    parts: string[];
+};
+export type OptFieldNode = {
+    type: 'optfield';
+    base: ExprNode;
+    field: string;
+};
+export type IndexNode = {
+    type: 'index';
+    base: ExprNode;
+    index: ExprNode;
+};
+export type CallNode = {
+    type: 'call';
+    name: string;
+    args: ExprNode[];
+};
+export type CompareOp = 'eq' | 'ne' | 'lt' | 'le' | 'gt' | 'ge';
+export type CompareNode = {
+    type: 'compare';
+    op: CompareOp;
+    left: ExprNode;
+    right: ExprNode;
+};
+export type LogicalNode = {
+    type: 'and' | 'or';
+    left: ExprNode;
+    right: ExprNode;
+};
+export type UnaryNode = {
+    type: 'not' | 'neg';
+    expr: ExprNode;
+};
+export type BinaryOp = 'add' | 'sub' | 'mul' | 'div' | 'mod';
+export type BinaryNode = {
+    type: 'binary';
+    op: BinaryOp;
+    left: ExprNode;
+    right: ExprNode;
+};
+export type IfNode = {
+    type: 'if';
+    cond: ExprNode;
+    thenExpr: ExprNode;
+    elseExpr: ExprNode;
+};
+export type CoalesceNode = {
+    type: 'coalesce';
+    left: ExprNode;
+    right: ExprNode;
+};
+export type ExprNode = LiteralNode | FieldNode | OptFieldNode | IndexNode | CallNode | CompareNode | LogicalNode | UnaryNode | BinaryNode | IfNode | CoalesceNode;
+export type TreeNode = ['literal', LiteralValue] | ['field', ...string[]] | ['field', TreeNode, ...string[]] | ['optfield', TreeNode, string] | ['index', TreeNode, TreeNode] | ['call', string, ...TreeNode[]] | ['eq' | 'ne' | 'lt' | 'le' | 'gt' | 'ge', TreeNode, TreeNode] | ['and' | 'or', ...TreeNode[]] | ['not', TreeNode] | ['add' | 'sub' | 'mul' | 'div' | 'mod', TreeNode, TreeNode] | ['if', TreeNode, TreeNode, TreeNode] | ['coalesce', TreeNode, TreeNode];
+//# sourceMappingURL=ast.d.ts.map

package/dist/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../src/ast.ts"],"names":[],"mappings":"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"}

package/dist/ast.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ast.js.map

package/dist/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../src/ast.ts"],"names":[],"mappings":""}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import { parse } from './index.js';
+import { getHelp } from './help.js';
+import { createInterface } from 'node:readline';
+function printUsage() {
+    console.log(`jilt - JSON object filtering\n\nUsage:\n  jilt help [topic]\n  jilt [--tree] '<expr>'\n  jilt -i '<expr>'\n\nExamples:\n  echo '{"color":"red"}' | jilt 'color = "red"'\n  jilt --tree 'color = "red" and weight < 5'\n  jilt -i 'price < 100 and inStock = true'\n`);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const helpFlag = args.includes('--help') || args.includes('-h');
+    const helpCommand = args[0] === 'help';
+    if (helpFlag || helpCommand) {
+        const topic = helpCommand
+            ? args[1]
+            : args.find((arg) => arg !== '--help' && arg !== '-h');
+        console.log(getHelp(topic));
+        return;
+    }
+    const hasTree = args.includes('--tree');
+    const interactive = args.includes('-i');
+    const exprArg = args.filter((arg) => arg !== '--tree' && arg !== '-i')[0];
+    if (!exprArg) {
+        printUsage();
+        process.exit(1);
+    }
+    const expression = parse(exprArg);
+    if (hasTree) {
+        console.log(JSON.stringify(expression.tree()));
+        return;
+    }
+    if (interactive) {
+        const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: true });
+        rl.on('line', (line) => {
+            const trimmed = line.trim();
+            if (!trimmed)
+                return;
+            try {
+                const obj = JSON.parse(trimmed);
+                const result = expression.compile()(obj);
+                console.log(String(result));
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error(message);
+            }
+        });
+        return;
+    }
+    const input = await readStdin();
+    if (!input.trim()) {
+        throw new Error('Expected JSON input on stdin');
+    }
+    const obj = JSON.parse(input);
+    const result = expression.compile()(obj);
+    console.log(String(result));
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(message);
+    process.exit(1);
+});
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/compiler.d.ts

@@ -0,0 +1,17 @@
+import type { ExprNode, TreeNode } from './ast.js';
+export type Strictness = boolean | null | undefined;
+export declare class EvaluationError extends Error {
+    code?: 'missing' | 'type' | 'arity';
+    constructor(message: string, code?: 'missing' | 'type' | 'arity');
+}
+export type EvalOptions = {
+    strict?: Strictness;
+    allowFields?: boolean;
+};
+export declare function normalizeStrict(strict: Strictness): boolean;
+export declare function compile(node: ExprNode, options?: EvalOptions): (obj: unknown) => boolean;
+export declare function evaluate(node: ExprNode, obj: unknown, options?: EvalOptions): boolean;
+export declare function evaluateConstant(node: ExprNode, options?: EvalOptions): unknown;
+export declare function toTree(node: ExprNode): TreeNode;
+export type { TreeNode };
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,QAAQ,EAOR,QAAQ,EAET,MAAM,UAAU,CAAA;AAEjB,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;AAEnD,qBAAa,eAAgB,SAAQ,KAAK;IACxC,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAA;gBAEvB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO;CAKjE;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AASD,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAG3D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAO5F;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAEzF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAInF;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CA8B/C;AAisBD,YAAY,EAAE,QAAQ,EAAE,CAAA"}