1ls 0.0.2 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Jeff Wainwright
+
+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

@@ -1,6 +1,20 @@
-# 1ls - One Line Script
+# 1ls
 
-A 0 dependency, lightweight, fast data processor with family JavaScript syntax. 
+[![CI](https://github.com/yowainwright/1ls/actions/workflows/ci.yml/badge.svg)](https://github.com/yowainwright/1ls/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/yowainwright/1ls/branch/main/graph/badge.svg)](https://codecov.io/gh/yowainwright/1ls)
+
+> One-line script
+
+A 0 dependency, lightweight, fast data processor with familiar JavaScript syntax.
+
+This is useful for writing 1ls, one-line scripts, in the terminal or for short scripts 
+that are as concise as possible in a familiar syntax, JavaScript, with dot notation, 
+fuzzy matching, and shortening capabilities for maximum efficiency.
+
+On top of that, the library is very small because it has no dependencies. 
+And, it is compiled with QuickJs for binary builds.
+This means you get good speed compared to jq and fx but it's still, just JS, 
+the language y'all know.
 
 ## Why 1ls?
 
@@ -14,14 +28,15 @@ A 0 dependency, lightweight, fast data processor with family JavaScript syntax.
 ## Installation
 
 ```bash
-# Using Bun
-bun install -g 1ls
-
-# Using npm
-npm install -g 1ls
+# Using bun (or npm, pnpm, etc)
+# works in the commandline or the web
+bun add -g 1ls
 
+# Or via binaries. here you get a QuickJs build
+# Using Homebrew (macOS/Linux)
+brew install yowainwright/1ls/1ls
 # Using curl
-curl -fsSL https://raw.githubusercontent.com/yowainwright/1ls/main/install.sh | bash
+curl -fsSL https://raw.githubusercontent.com/yowainwright/1ls/main/scripts/install.sh | bash
 ```
 
 ## Quick Start
@@ -42,10 +57,94 @@ echo '[1, 2, 3]' | 1ls '.map(x => x * 2)'
 # Chain operations
 echo '[{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}]' | 1ls '.filter(x => x.age > 26).map(x => x.name)'
 # Output: ["Alice"]
+
+# Interactive mode - explore JSON with fuzzy search
+1ls readFile data.json
+# Opens interactive explorer with fuzzy search, arrow key navigation, and live preview
 ```
 
 ## Examples
 
+### Interactive Mode
+
+Explore JSON interactively with fuzzy search and build expressions with method discovery:
+
+```bash
+# Open interactive explorer from a file (automatic when no expression)
+1ls readFile data.json
+
+# Works with all supported formats
+1ls readFile config.yaml
+1ls readFile config.toml
+
+# For remote data, save to a file first
+curl https://api.github.com/users/github > /tmp/user.json
+1ls readFile /tmp/user.json
+
+# Or use an expression directly (non-interactive)
+1ls readFile data.json '.users.filter(x => x.active)'
+```
+
+#### Mode 1: Path Explorer
+
+Navigate and search JSON paths:
+
+- **Fuzzy search**: Type to filter paths (e.g., "user.name" matches `.users[0].name`, `.user.username`, etc.)
+- **Live preview**: See values as you navigate
+- **Type information**: Shows String, Number, Array, Object, Boolean, or null
+- **↑/↓**: Navigate, **Enter**: Select, **Tab**: Build expression, **Esc/q**: Quit
+
+#### Mode 2: Expression Builder
+
+Build complex expressions with guided method selection:
+
+**Workflow:**
+1. Navigate to a path in Explorer mode → Press **Tab**
+2. Type to fuzzy search methods → **→** to accept
+3. Type to fuzzy search properties → **→** to complete
+4. Repeat to chain methods
+5. Press **Enter** to execute
+
+**Example Session:**
+```
+1. Navigate to .users (Array) → Tab
+2. Type "fil" → → (accepts .filter(x => ...))
+3. Type "act" → → (completes with x.active, back to method selection)
+4. Type "map" → → (accepts .map(x => ...))
+5. Type "name" → → (completes with x.name)
+6. Enter → executes: .users.filter(x => x.active).map(x => x.name)
+```
+
+**Undo mistakes:**
+- Press **←** at any time to undo the last segment
+- Example: `.users.filter(x => x.active).map(x => x.name)` → **←** → `.users.filter(x => x.active)`
+
+**Available Methods by Type:**
+
+**Array**: map, filter, reduce, find, findIndex, some, every, sort, reverse, slice, concat, join, flat, flatMap, length
+
+**String**: toUpperCase, toLowerCase, trim, trimStart, trimEnd, split, replace, replaceAll, substring, slice, startsWith, endsWith, includes, match, length
+
+**Object**: {keys}, {values}, {entries}, {length}
+
+**Number**: toFixed, toString
+
+**Keyboard Shortcuts:**
+- **↑/↓**: Navigate methods/properties
+- **→ or Tab**: Accept/complete method or property (autocomplete-style)
+- **←**: Undo last segment (remove to previous dot)
+- **Enter**: Execute expression
+- **Type**: Fuzzy search methods/properties
+- **Esc**: Go back to Explorer / Quit
+- **q**: Quit (from Explorer)
+
+**Use cases:**
+- Exploring unfamiliar API responses
+- Building filter/map chains interactively
+- Discovering available methods for each type
+- Learning JavaScript array/string methods
+- Prototyping complex data transformations
+
 ### Working with JSON
 
 ```bash
@@ -180,6 +279,7 @@ echo '["a", "b"]' | 1ls '.jn(",")'           # Short for .join()
 |--------|-------|-------------|
 | `--help` | `-h` | Show help |
 | `--version` | `-v` | Show version |
+| `--interactive` | | Interactive fuzzy search explorer |
 | `--raw` | `-r` | Output raw strings, not JSON |
 | `--pretty` | `-p` | Pretty print output |
 | `--compact` | `-c` | Compact output |
@@ -317,6 +417,26 @@ done
 - Efficient streaming for large files
 - Native binary compilation
 
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/yowainwright/1ls.git
+cd 1ls
+
+# Install dependencies
+bun install
+
+# Run tests
+bun test
+
+# Build
+bun run build
+
+# Build binaries
+bun run build:binary:all
+```
+
 ## Contributing
 
 Contributions are welcome! Please check out the [Contributing Guide](CONTRIBUTING.md).
@@ -332,10 +452,11 @@ MIT © Jeff Wainwright
 | Syntax | JavaScript | DSL | JavaScript |
 | Performance | ⚡ Fast (Bun) | ⚡ Fast | 🚀 Good |
 | Learning Curve | Easy | Steep | Easy |
-| Multi-format | ✅ | ❌ | ❌ |
-| Shortcuts | ✅ | ❌ | ❌ |
-| Arrow Functions | ✅ | ❌ | ✅ |
-| File Operations | ✅ | ❌ | ❌ |
+| Multi-format | ✓ | x | x |
+| Interactive Mode | ✓ | x | ✓ |
+| Shortcuts | ✓ | x | x |
+| Arrow Functions | ✓ | x | ✓ |
+| File Operations | ✓ | x | x |
 
 ## Troubleshooting
 

package/dist/browser/constants.d.ts

@@ -0,0 +1,3 @@
+import type { ShortcutMapping } from "../utils/types";
+export declare const REGEX_SPECIAL_CHARS: RegExp;
+export declare const SHORTCUTS: ShortcutMapping[];

package/dist/browser/index.d.ts

@@ -0,0 +1,15 @@
+import { Lexer } from "../lexer";
+import { ExpressionParser } from "../expression";
+import { JsonNavigator } from "../navigator/json";
+import { parseYAML } from "../formats/yaml";
+import { parseCSV } from "../formats/csv";
+import { parseTOML } from "../formats/toml";
+export { Lexer, ExpressionParser, JsonNavigator };
+export { parseYAML, parseCSV, parseTOML };
+export declare function escapeRegExp(str: string): string;
+export declare const EXPAND_PATTERNS: {
+    regex: RegExp;
+    replacement: string;
+}[];
+export declare function expandShortcuts(expression: string): string;
+export declare function evaluate(data: unknown, expression: string): unknown;

package/dist/browser/index.js

@@ -0,0 +1,15 @@
+var q={".":"DOT","[":"LEFT_BRACKET","]":"RIGHT_BRACKET","{":"LEFT_BRACE","}":"RIGHT_BRACE","(":"LEFT_PAREN",")":"RIGHT_PAREN",":":"COLON",",":"COMMA"},z="+-*/%<>!&|=",Z=[" ","\t",`
+`,"\r"];function O(t,e,n){return{type:t,value:e,position:n}}class _{input;position=0;current;constructor(t){this.input=t,this.current=this.input[0]||""}tokenize(){let t=[];while(this.position<this.input.length){if(this.skipWhitespace(),this.position>=this.input.length)break;let e=this.nextToken();if(e)t.push(e)}return t.push(O("EOF","",this.position)),t}nextToken(){let t=this.position,e=q[this.current];if(e){let h=this.current;return this.advance(),O(e,h,t)}if(this.current==="="&&this.peek()===">")return this.advance(),this.advance(),O("ARROW","=>",t);if(this.current==='"'||this.current==="'")return this.readString();let r=this.isDigit(this.current),o=this.current==="-"&&this.isDigit(this.peek());if(r||o)return this.readNumber();if(this.isIdentifierStart(this.current))return this.readIdentifier();if(this.isOperator(this.current))return this.readOperator();return this.advance(),null}readString(){let t=this.position,e=this.current,n=[];this.advance();while(this.current!==e&&this.position<this.input.length){if(this.current==="\\"){if(this.advance(),this.position<this.input.length)n.push(this.current),this.advance();continue}n.push(this.current),this.advance()}if(this.current===e)this.advance();return O("STRING",n.join(""),t)}readNumber(){let t=this.position,e="";if(this.current==="-")e+=this.current,this.advance();while(this.isDigit(this.current))e+=this.current,this.advance();if(this.current==="."&&this.isDigit(this.peek())){e+=this.current,this.advance();while(this.isDigit(this.current))e+=this.current,this.advance()}return O("NUMBER",e,t)}readIdentifier(){let t=this.position,e="";while(this.isIdentifierChar(this.current))e+=this.current,this.advance();return O("IDENTIFIER",e,t)}readOperator(){let t=this.position,e="";while(this.isOperator(this.current))e+=this.current,this.advance();return O("OPERATOR",e,t)}skipWhitespace(){while(this.isWhitespace(this.current))this.advance()}advance(){this.position++,this.current=this.input[this.position]||""}peek(){return this.input[this.position+1]||""}isWhitespace(t){return Z.includes(t)}isDigit(t){return t>="0"&&t<="9"}isIdentifierStart(t){let e=t>="a"&&t<="z",n=t>="A"&&t<="Z";return e||n||t==="_"||t==="$"}isIdentifierChar(t){return this.isIdentifierStart(t)||this.isDigit(t)}isOperator(t){return z.includes(t)}}var T=(t)=>{return{type:"Literal",value:t}},P=(t)=>{if(t==="true")return T(!0);if(t==="false")return T(!1);if(t==="null")return T(null);return};function E(t,e){return`${e} at position ${t.position} (got ${t.type}: "${t.value}")`}function b(t,e){return{type:"PropertyAccess",property:t,object:e}}function dt(t,e){return{type:"IndexAccess",index:t,object:e}}function ft(t,e,n){return{type:"SliceAccess",start:t,end:e,object:n}}function tt(t,e,n){return{type:"MethodCall",method:t,args:e,object:n}}function mt(t,e){return{type:"ObjectOperation",operation:t,object:e}}function At(t){return{type:"ArraySpread",object:t}}function yt(t,e){return{type:"ArrowFunction",params:t,body:e}}function I(t){return{type:"Root",expression:t}}var et=["keys","values","entries","length"];function gt(t){return et.includes(t)}class M{tokens;position=0;current;constructor(t){this.tokens=t,this.current=this.tokens[0]}parse(){if(this.current.type==="EOF")return I();let e=this.parseExpression();return I(e)}parseExpression(){return this.parsePrimary()}parsePrimary(){let t=this.parsePrimaryNode();return this.parsePostfix(t)}parsePrimaryNode(){let t=this.current.type;if(t==="DOT")return this.advance(),this.parseAccessChain();if(t==="LEFT_BRACKET")return this.parseArrayAccess();if(t==="IDENTIFIER")return this.parseIdentifierOrFunction();if(t==="STRING"){let e=this.current.value;return this.advance(),T(e)}if(t==="NUMBER"){let e=Number(this.current.value);return this.advance(),T(e)}if(t==="LEFT_PAREN"){let e=this.parseFunctionParams();return this.parseArrowFunction(e)}throw Error(E(this.current,"Unexpected token"))}parseAccessChain(t){let e=this.current.type;if(e==="IDENTIFIER"){let n=this.current.value;return this.advance(),b(n,t)}if(e==="LEFT_BRACKET")return this.parseBracketAccess(t);if(e==="LEFT_BRACE")return this.parseObjectOperation(t);throw Error(E(this.current,"Expected property name after dot"))}parseBracketAccess(t){if(this.advance(),this.current.type==="RIGHT_BRACKET")return this.advance(),At(t);if(this.current.type==="STRING"){let a=this.current.value;return this.advance(),this.expect("RIGHT_BRACKET"),b(a,t)}let s=this.current.type==="NUMBER",r=this.current.type==="OPERATOR"&&this.current.value==="-",o=this.current.type==="COLON";if(s||r||o)return this.parseNumericIndexOrSlice(t);throw Error(E(this.current,"Unexpected token in bracket access"))}parseNumericIndexOrSlice(t){if(this.current.type==="COLON")return this.parseSliceFromColon(void 0,t);let n=this.parseNumber();if(this.advance(),this.current.type==="COLON")return this.parseSliceFromColon(n,t);return this.expect("RIGHT_BRACKET"),dt(n,t)}parseSliceFromColon(t,e){this.advance();let n=this.current.type==="NUMBER",s=this.current.type==="OPERATOR"&&this.current.value==="-",r=n||s,o=r?this.parseNumber():void 0;if(r)this.advance();return this.expect("RIGHT_BRACKET"),ft(t,o,e)}parseArrayAccess(){return this.parseBracketAccess()}parseObjectOperation(t){if(this.advance(),this.current.type!=="IDENTIFIER")throw Error(E(this.current,"Expected operation name after {"));let n=this.current.value;if(!gt(n)){let s=et.join(", ");throw Error(E(this.current,`Invalid object operation "${n}". Valid operations: ${s}`))}return this.advance(),this.expect("RIGHT_BRACE"),mt(n,t)}parseIdentifierOrFunction(){let t=this.current.value;if(this.advance(),this.current.type==="ARROW")return this.parseArrowFunction([t]);let n=P(t);if(n)return n;return b(t)}parseArrowFunction(t){this.expect("ARROW");let e=this.parseFunctionBody();return yt(t,e)}parseFunctionBody(){if(this.current.type==="LEFT_BRACE"){this.advance();let e=this.parseBinaryExpression();return this.expect("RIGHT_BRACE"),e}return this.parseBinaryExpression()}parseBinaryExpression(){let t=this.parseFunctionTerm();while(this.current.type==="OPERATOR"){let e=this.current.value;this.advance();let n=this.parseFunctionTerm();t=tt(`__operator_${e}__`,[n],t)}return t}parseFunctionTerm(){let t=this.current.type;if(t==="IDENTIFIER")return this.parseIdentifierChain();if(t==="NUMBER"){let e=Number(this.current.value);return this.advance(),T(e)}if(t==="STRING"){let e=this.current.value;return this.advance(),T(e)}if(t==="LEFT_PAREN"){this.advance();let e=this.parseBinaryExpression();return this.expect("RIGHT_PAREN"),e}throw Error(E(this.current,"Unexpected token in function body"))}parseIdentifierChain(){let t=this.current.value;this.advance();let e=P(t);if(e)return e;let n=b(t),s=()=>this.current.type==="DOT",r=()=>this.current.type==="IDENTIFIER",o=()=>this.current.type==="LEFT_PAREN";while(s()||o()){if(o()){let a=n,u=a.property,h=a.object;n=this.parseMethodCall(h?h:I(),u);continue}if(this.advance(),!r())break;let i=this.current.value;this.advance(),n=b(i,n)}return n}parseMethodCall(t,e){this.expect("LEFT_PAREN");let n=this.parseMethodArguments();return this.expect("RIGHT_PAREN"),tt(e,n,t)}parseMethodArguments(){let t=[];while(this.current.type!=="RIGHT_PAREN"&&this.current.type!=="EOF"){let e=this.parseMethodArgument();if(t.push(e),this.current.type==="COMMA")this.advance()}return t}parseMethodArgument(){let t=this.current.type;if(t==="LEFT_PAREN"){let e=this.parseFunctionParams();return this.parseArrowFunction(e)}if(t==="IDENTIFIER"){let e=this.current.value;if(this.advance(),this.current.type==="ARROW")return this.parseArrowFunction([e]);return b(e)}if(t==="NUMBER"){let e=Number(this.current.value);return this.advance(),T(e)}if(t==="STRING"){let e=this.current.value;return this.advance(),T(e)}return this.parseExpression()}parseFunctionParams(){this.expect("LEFT_PAREN");let t=[];while(this.current.type!=="RIGHT_PAREN"&&this.current.type!=="EOF"){if(this.current.type==="IDENTIFIER")t.push(this.current.value),this.advance();if(this.current.type==="COMMA")this.advance()}return this.expect("RIGHT_PAREN"),t}parsePostfix(t){let e=t;while(!0){let n=this.current.type;if(n==="DOT"){e=this.parsePostfixDot(e);continue}if(n==="LEFT_BRACKET"){e=this.parseBracketAccess(e);continue}if(n==="LEFT_PAREN"){if(e.type==="PropertyAccess"&&!e.object){let o=e.property;e=this.parseMethodCall(I(),o);continue}}break}return e}parsePostfixDot(t){this.advance();let e=this.current.type;if(e==="IDENTIFIER"){let n=this.current.value;if(this.advance(),this.current.type==="LEFT_PAREN")return this.parseMethodCall(t,n);return b(n,t)}if(e==="LEFT_BRACKET")return this.parseBracketAccess(t);if(e==="LEFT_BRACE")return this.parseObjectOperation(t);throw Error(E(this.current,"Expected property name after dot"))}parseNumber(){let t=this.current.value==="-";if(t)this.advance();if(this.current.type!=="NUMBER")throw Error(E(this.current,"Expected number after minus sign"));let n=Number(this.current.value);return t?-n:n}advance(){if(this.position++,this.position<this.tokens.length)this.current=this.tokens[this.position]}expect(t){if(this.current.type!==t)throw Error(E(this.current,`Expected ${t} but got ${this.current.type}`));this.advance()}}var Tt={"+":(t,e)=>t+e,"-":(t,e)=>t-e,"*":(t,e)=>t*e,"/":(t,e)=>t/e,"%":(t,e)=>t%e,">":(t,e)=>t>e,"<":(t,e)=>t<e,">=":(t,e)=>t>=e,"<=":(t,e)=>t<=e,"==":(t,e)=>t==e,"===":(t,e)=>t===e,"!=":(t,e)=>t!=e,"!==":(t,e)=>t!==e,"&&":(t,e)=>t&&e,"||":(t,e)=>t||e};function nt(t){return t.startsWith("__operator_")&&t.endsWith("__")}function rt(t){return t.slice(11,-2)}function st(t,e,n){let s=Tt[e];if(!s)throw Error(`Unknown operator: ${e}`);return s(t,n)}function Nt(t,e){return Object.fromEntries(t.map((n,s)=>[n,e[s]]))}function j(t){return Object.values(t)[0]}function it(t){return t!==null&&typeof t==="object"}function B(t,e){if(!it(t))return;return t[e]}function D(t,e){return t<0?e+t:t}function Et(t,e){if(!Array.isArray(t))return;let n=D(e,t.length);return t[n]}function xt(t,e,n){if(!Array.isArray(t))return;let s=t.length,r=e!==void 0?D(e,s):0,o=n!==void 0?D(n,s):s;return t.slice(r,o)}function vt(t,e){if(!it(t))return;switch(e){case"keys":return Object.keys(t);case"values":return Object.values(t);case"entries":return Object.entries(t);case"length":return Array.isArray(t)?t.length:Object.keys(t).length}}var Ot=(t,e)=>{if(t===null||t===void 0)return!1;return typeof t[e]==="function"},bt=(t)=>t instanceof Error?t.message:String(t);function ot(t,e,n){if(!Ot(t,e))throw Error(`Method ${e} does not exist on ${typeof t}`);try{return t[e].call(t,...n)}catch(r){let o=bt(r);throw Error(`Error executing method ${e}: ${o}`)}}class G{evaluate(t,e){switch(t.type){case"Root":return t.expression?this.evaluate(t.expression,e):e;case"PropertyAccess":return this.evaluatePropertyAccess(t,e);case"IndexAccess":return Et(t.object?this.evaluate(t.object,e):e,t.index);case"SliceAccess":return xt(t.object?this.evaluate(t.object,e):e,t.start,t.end);case"ArraySpread":return t.object?this.evaluate(t.object,e):e;case"MethodCall":return this.evaluateMethodCall(t,e);case"ObjectOperation":return vt(t.object?this.evaluate(t.object,e):e,t.operation);case"Literal":return t.value;case"ArrowFunction":return this.createFunction(t);default:throw Error(`Unknown AST node type: ${t.type}`)}}evaluatePropertyAccess(t,e){let n=t.object?this.evaluate(t.object,e):e;return B(n,t.property)}evaluateArg(t,e){return t.type==="ArrowFunction"?this.createFunction(t):this.evaluate(t,e)}evaluateMethodCall(t,e){let n=t.object?this.evaluate(t.object,e):e;if(nt(t.method)){let o=rt(t.method),i=this.evaluate(t.args[0],e);return st(n,o,i)}let r=t.args.map((o)=>this.evaluateArg(o,e));return ot(n,t.method,r)}createFunction(t){return(...e)=>{let n=Nt(t.params,e);return this.evaluateFunctionBody(t.body,n)}}evaluateFunctionBody(t,e){switch(t.type){case"PropertyAccess":return this.evaluatePropertyAccessInFunction(t,e);case"MethodCall":return this.evaluateMethodCallInFunction(t,e);case"Literal":return t.value;case"Root":return t.expression?this.evaluateFunctionBody(t.expression,e):e;default:return this.evaluate(t,j(e))}}evaluatePropertyAccessInFunction(t,e){if(t.object!==void 0){let o=this.evaluateFunctionBody(t.object,e);return B(o,t.property)}if(Object.prototype.hasOwnProperty.call(e,t.property))return e[t.property];let r=j(e);return B(r,t.property)}evaluateMethodCallInFunction(t,e){let n=t.object?this.evaluateFunctionBody(t.object,e):j(e);if(nt(t.method)){let o=rt(t.method),i=this.evaluateFunctionBody(t.args[0],e);return st(n,o,i)}let r=t.args.map((o)=>this.evaluateFunctionBody(o,e));return ot(n,t.method,r)}}var U=[{short:".mp",full:".map",description:"Transform each element",type:"array"},{short:".flt",full:".filter",description:"Filter elements",type:"array"},{short:".rd",full:".reduce",description:"Reduce to single value",type:"array"},{short:".fnd",full:".find",description:"Find first match",type:"array"},{short:".sm",full:".some",description:"Test if any match",type:"array"},{short:".evr",full:".every",description:"Test if all match",type:"array"},{short:".srt",full:".sort",description:"Sort elements",type:"array"},{short:".rvs",full:".reverse",description:"Reverse order",type:"array"},{short:".jn",full:".join",description:"Join to string",type:"array"},{short:".slc",full:".slice",description:"Extract portion",type:"array"},{short:".kys",full:".{keys}",description:"Get object keys",type:"object"},{short:".vls",full:".{values}",description:"Get object values",type:"object"},{short:".ents",full:".{entries}",description:"Get object entries",type:"object"},{short:".len",full:".{length}",description:"Get length/size",type:"object"},{short:".lc",full:".toLowerCase",description:"Convert to lowercase",type:"string"},{short:".uc",full:".toUpperCase",description:"Convert to uppercase",type:"string"},{short:".trm",full:".trim",description:"Remove whitespace",type:"string"},{short:".splt",full:".split",description:"Split string to array",type:"string"},{short:".incl",full:".includes",description:"Check if includes",type:"array"}];var W=(t,e)=>{let s=U.filter((r)=>r.type===t).map((r)=>`  ${r.short.padEnd(6)} -> ${r.full.padEnd(14)} ${r.description}`);return`${e}:
+${s.join(`
+`)}`},Te=`Expression Shortcuts:
+
+${W("array","Array Methods")}
+
+${W("object","Object Methods")}
+
+${W("string","String Methods")}
+`;var ct=/[.*+?^${}()|[\]\\]/g,at=U;var St=/^-?\d+$/,wt=/^[+-]?\d+$/,Rt=/^-?\d+\.\d+$/,kt=/^[+-]?\d+\.\d+$/;var V={INTEGER:St,FLOAT:Rt},H={INTEGER:wt,FLOAT:kt};var It=["true","yes","on"],Ct=["false","no","off"],Ft=["null","~",""],Lt=(t)=>It.includes(t),_t=(t)=>Ct.includes(t),Pt=(t)=>Ft.includes(t),C=(t)=>{if(Lt(t))return!0;if(_t(t))return!1;return},F=(t)=>{if(Pt(t))return null;return},ut=(t)=>{if(t==="")return;let e=Number(t);return isNaN(e)?void 0:e};function Mt(t){if(t.startsWith("!!")){let e=t.indexOf(" ");if(e>0)return{tag:t.substring(2,e),content:t.substring(e+1)}}return{tag:null,content:t}}function k(t){let{tag:e,content:n}=Mt(t);if(e==="str")return n;let s=n.startsWith('"')&&n.endsWith('"'),r=n.startsWith("'")&&n.endsWith("'");if(s||r)return n.slice(1,-1);let i=C(n);if(i!==void 0)return i;let a=F(n);if(a!==void 0)return a;if(V.INTEGER.test(n))return parseInt(n,10);if(V.FLOAT.test(n))return parseFloat(n);if(n.startsWith("[")&&n.endsWith("]"))return n.slice(1,-1).split(",").map((c)=>k(c.trim()));if(n.startsWith("{")&&n.endsWith("}")){let c={};return n.slice(1,-1).split(",").forEach((J)=>{let[S,y]=J.split(":").map((p)=>p.trim());if(S&&y)c[S]=k(y)}),c}return n}function jt(t,e){return Array.from({length:e},(s,r)=>e-1-r).reduce((s,r)=>{if(s!==null)return s;let o=t[r],i=o.indexOf("#");if(i>=0){let f=o.substring(0,i);if((f.match(/["']/g)||[]).length%2===0)o=f}let u=o.trim();if(u&&!u.startsWith("-")&&u.includes(":")){let f=u.indexOf(":"),g=u.substring(0,f).trim(),c=u.substring(f+1).trim();if(!c||c==="|"||c===">"||c==="|+"||c===">-")return g}return null},null)}function $(t){let e=t.indexOf("#");if(e<0)return t;let n=t.substring(0,e);return(n.match(/["']/g)||[]).length%2===0?n:t}function Bt(t){let e=t.indexOf(":");if(e<=0)return!1;let n=t.substring(0,e);return!n.includes(" ")||n.startsWith('"')||n.startsWith("'")}function K(t){return t.length-t.trimStart().length}function Dt(t,e,n,s){let r=[],o=e;while(o<t.length){let a=t[o];if(!a.trim()){r.push(""),o++;continue}if(K(a)<=n)break;r.push(a.substring(n+2)),o++}while(r.length>0&&r[r.length-1]==="")r.pop();return{value:s==="|"?r.join(`
+`):r.join(" ").replace(/\s+/g," ").trim(),endIdx:o-1}}function Q(t,e){if(typeof t==="string"&&t.startsWith("*")){let n=t.substring(1);return e[n]!==void 0?e[n]:t}if(Array.isArray(t))return t.map((n)=>Q(n,e));if(typeof t==="object"&&t!==null){let n={};for(let[s,r]of Object.entries(t))if(s==="<<"&&typeof r==="string"&&r.startsWith("*")){let o=r.substring(1),i=e[o];if(typeof i==="object"&&i!==null&&!Array.isArray(i))Object.assign(n,i)}else n[s]=Q(r,e);return n}return t}function Gt(t){let e=t.trim().split(`
+`),n={},o=e.find((h)=>{let f=$(h).trim();return f&&f!=="---"&&f!=="..."})?.trim().startsWith("- ")?[]:{},i=[{container:o,indent:-1}];function a(){return i[i.length-1]}function u(h){while(i.length>1&&h(a()))i.pop()}for(let h=0;h<e.length;h++){let f=e[h],g=$(f),c=g.trim();if(!c||c==="---"||c==="...")continue;let d=K(g);if(c.startsWith("- ")||c==="-"){let y=c==="-"?"":c.substring(2).trim();u((A)=>A.indent>d||A.indent>=d&&!Array.isArray(A.container));let l,p=a();if(Array.isArray(p.container)&&(p.indent===d||p.indent===-1&&d===0)){if(l=p.container,p.indent===-1)p.indent=d}else{if(l=[],p.pendingKey)p.container[p.pendingKey]=l,p.pendingKey=void 0;else if(!Array.isArray(p.container)){let A=jt(e,h);if(A)p.container[A]=l}i.push({container:l,indent:d})}if(Bt(y)){let A=y.indexOf(":"),m=y.substring(0,A).trim(),N=y.substring(A+1).trim(),x=null;if(m.includes(" &")){let w=m.split(" &");m=w[0],x=w[1]}let v={[m]:N?k(N):null};if(l.push(v),x)n[x]=v;i.push({container:v,indent:d+2})}else if(y)l.push(k(y));else{let A={};l.push(A),i.push({container:A,indent:d+2})}continue}let S=c.indexOf(":");if(S>0){let y=c.substring(0,S).trim(),l=c.substring(S+1).trim(),p=null;if(l.startsWith("&")){let m=l.indexOf(" ");if(m>0)p=l.substring(1,m),l=l.substring(m+1);else p=l.substring(1),l=""}u((m)=>m.indent>d||m.indent===d&&Array.isArray(m.container));let L=a(),A=L.container;if(Array.isArray(A))continue;if(l==="|"||l===">"||l==="|+"||l===">-"||l==="|-"||l===">+"){let m=l.startsWith("|")?"|":">",{value:N,endIdx:x}=Dt(e,h+1,d,m);if(A[y]=N,p)n[p]=N;h=x}else if(l){let m=k(l);if(A[y]=m,p)n[p]=m}else{let m=h+1,N=m<e.length,x=N?$(e[m]):"",v=x.trim(),w=N?K(x):-1,lt=v.startsWith("- ")||v==="-",ht=N&&w>d&&v;if(lt&&w>d){if(L.pendingKey=y,p){let R={};n[p]=R}}else if(ht){let R={};if(A[y]=R,p)n[p]=R;i.push({container:R,indent:w})}else if(A[y]=null,p)n[p]=null}}}return Q(o,n)}function pt(t,e){let n=[],s="",r=!1,o=t.split("");return o.forEach((i,a)=>{let u=o[a+1];if(i==='"'){if(r&&u==='"'){s+='"',o.splice(a+1,1);return}r=!r;return}if(i===e&&!r){n.push(s),s="";return}s+=i}),n.push(s),n.map((i)=>i.trim())}function Wt(t){let e=t.trim();if(e.startsWith('"')&&e.endsWith('"'))return e.slice(1,-1).replace(/""/g,'"');let s=ut(e);if(s!==void 0)return s;let r=e.toLowerCase(),o=C(r);if(o!==void 0)return o;let i=F(r);if(i!==void 0)return i;return e}function Ut(t,e=","){let n=t.trim().split(`
+`);if(n.length===0)return[];let s=pt(n[0],e);if(n.length===1)return[];return n.slice(1).reduce((r,o)=>{let i=pt(o,e);if(i.length===0)return r;let a=Object.fromEntries(s.map((u,h)=>[u,Wt(i[h]||"")]));return[...r,a]},[])}function Y(t){if(t.startsWith('"')&&t.endsWith('"'))return t.slice(1,-1).replace(/\\"/g,'"');if(t.startsWith("'")&&t.endsWith("'"))return t.slice(1,-1);if(t==="true")return!0;if(t==="false")return!1;if(H.INTEGER.test(t))return parseInt(t,10);if(H.FLOAT.test(t))return parseFloat(t);if(t.startsWith("[")&&t.endsWith("]"))return t.slice(1,-1).split(",").map((u)=>Y(u.trim()));if(t.startsWith("{")&&t.endsWith("}")){let a={};return t.slice(1,-1).split(",").forEach((h)=>{let[f,g]=h.split("=").map((c)=>c.trim());if(f&&g)a[f]=Y(g)}),a}return t}function Vt(t){let e=t.trim().split(`
+`),n={},s=n,r=[];return e.forEach((o)=>{let i=o,a=i.indexOf("#");if(a>=0){let c=i.substring(0,a);if((c.match(/["']/g)||[]).length%2===0)i=c}let u=i.trim();if(!u)return;if(u.startsWith("[")&&u.endsWith("]")){let c=u.slice(1,-1).split(".");s=n,r=[],c.forEach((d)=>{if(!s[d])s[d]={};s=s[d],r.push(d)});return}let f=u.indexOf("=");if(f>0){let c=u.substring(0,f).trim(),d=u.substring(f+1).trim();s[c]=Y(d)}}),n}function Ht(t){return t.replace(ct,"\\$&")}var $t=at.map((t)=>({regex:new RegExp(`${Ht(t.short)}(?![a-zA-Z])`,"g"),replacement:t.full})).sort((t,e)=>e.replacement.length-t.replacement.length);function Kt(t){return $t.reduce((e,{regex:n,replacement:s})=>e.replace(n,s),t)}function De(t,e){let n=Kt(e),r=new _(n).tokenize(),i=new M(r).parse();return new G().evaluate(i,t)}export{Gt as parseYAML,Vt as parseTOML,Ut as parseCSV,Kt as expandShortcuts,De as evaluate,Ht as escapeRegExp,_ as Lexer,G as JsonNavigator,M as ExpressionParser,$t as EXPAND_PATTERNS};

package/dist/cli/constants.d.ts

@@ -1,3 +1,5 @@
 import { DataFormat } from "../utils/types";
+import { CliOptions } from "../types";
 export declare const VALID_OUTPUT_FORMATS: readonly ["json", "yaml", "csv", "table"];
 export declare const VALID_INPUT_FORMATS: DataFormat[];
+export declare const DEFAULT_OPTIONS: CliOptions;

package/dist/cli/index.d.ts

@@ -1,2 +1,7 @@
 #!/usr/bin/env bun
+import { CliOptions } from "../types";
+export declare const getInteractive: () => Promise<typeof import("../interactive/app")>;
+export declare function handleGrepOperation(options: CliOptions): Promise<void>;
+export declare function loadData(options: CliOptions, args: string[]): Promise<unknown>;
+export declare function processExpression(options: CliOptions, jsonData: unknown): Promise<void>;
 export declare function main(args: string[]): Promise<void>;

package/dist/completions/1ls.bash

@@ -0,0 +1,63 @@
+#!/bin/bash
+# Bash completion for 1ls
+
+_1ls_complete() {
+    local cur prev opts
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+
+    # Main options
+    opts="--help --version --raw --pretty --compact --type --format --list --grep --find --recursive --ignore-case --line-numbers --ext --max-depth --shortcuts --shorten --expand readFile"
+
+    # Format options
+    format_opts="json yaml csv table"
+
+    # Common JSON path starters
+    json_paths=". .[] .{keys} .{values} .{entries}"
+
+    # Common shorthand methods
+    shortcuts=".mp .flt .rd .fnd .sm .evr .srt .rvs .jn .kys .vls .ents .lc .uc .trm"
+
+    case "${prev}" in
+        --format)
+            COMPREPLY=( $(compgen -W "${format_opts}" -- ${cur}) )
+            return 0
+            ;;
+        --list|--find|readFile)
+            # File/directory completion
+            COMPREPLY=( $(compgen -f -- ${cur}) )
+            return 0
+            ;;
+        --ext)
+            # Common extensions
+            COMPREPLY=( $(compgen -W "js ts tsx jsx json md txt yml yaml xml html css" -- ${cur}) )
+            return 0
+            ;;
+        --shorten|--expand)
+            # JSON expressions
+            COMPREPLY=( $(compgen -W "${json_paths}" -- ${cur}) )
+            return 0
+            ;;
+        *)
+            ;;
+    esac
+
+    # If current word starts with -, show options
+    if [[ ${cur} == -* ]]; then
+        COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )
+        return 0
+    fi
+
+    # If current word starts with ., suggest JSON paths and shortcuts
+    if [[ ${cur} == .* ]]; then
+        all_paths="${json_paths} ${shortcuts}"
+        COMPREPLY=( $(compgen -W "${all_paths}" -- ${cur}) )
+        return 0
+    fi
+
+    # Default to options
+    COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )
+}
+
+complete -F _1ls_complete 1ls

package/dist/completions/1ls.zsh

@@ -0,0 +1,79 @@
+#compdef 1ls
+# Zsh completion for 1ls
+
+_1ls() {
+    local -a opts format_opts shortcuts json_paths
+
+    # Main options
+    opts=(
+        '--help[Show help]'
+        '--version[Show version]'
+        '--raw[Raw output (no formatting)]'
+        '--pretty[Pretty print JSON]'
+        '--compact[Compact JSON]'
+        '--type[Show value type info]'
+        '--format[Output format]:format:(json yaml csv table)'
+        '--list[List files in directory]:directory:_files -/'
+        '--grep[Search for pattern]:pattern:'
+        '--find[Path to search in]:path:_files'
+        '--recursive[Recursive search]'
+        '--ignore-case[Case insensitive search]'
+        '--line-numbers[Show line numbers]'
+        '--ext[Filter by extensions]:extensions:'
+        '--max-depth[Maximum recursion depth]:depth:'
+        '--shortcuts[Show all available shortcuts]'
+        '--shorten[Convert expression to shorthand]:expression:'
+        '--expand[Convert shorthand to full form]:expression:'
+        'readFile[Read from file]:file:_files'
+    )
+
+    # Common shorthand methods
+    shortcuts=(
+        '.mp:map - Transform each element'
+        '.flt:filter - Filter elements'
+        '.rd:reduce - Reduce to single value'
+        '.fnd:find - Find first match'
+        '.sm:some - Test if any match'
+        '.evr:every - Test if all match'
+        '.srt:sort - Sort elements'
+        '.rvs:reverse - Reverse order'
+        '.jn:join - Join to string'
+        '.kys:keys - Get object keys'
+        '.vls:values - Get object values'
+        '.ents:entries - Get object entries'
+        '.lc:toLowerCase - Convert to lowercase'
+        '.uc:toUpperCase - Convert to uppercase'
+        '.trm:trim - Remove whitespace'
+    )
+
+    # JSON path examples
+    json_paths=(
+        '.:Root object'
+        '.[]:All array elements'
+        '.{keys}:Object keys'
+        '.{values}:Object values'
+        '.{entries}:Object entries'
+    )
+
+    # Check context and provide appropriate completions
+    local curcontext="$curcontext" state line
+    typeset -A opt_args
+
+    _arguments -C \
+        "${opts[@]}" \
+        '*:: :->args'
+
+    case $state in
+        args)
+            # If typing starts with ., offer shortcuts and paths
+            if [[ $words[$CURRENT] == .* ]]; then
+                _describe -t shortcuts 'shortcuts' shortcuts
+                _describe -t paths 'json paths' json_paths
+            else
+                _arguments "${opts[@]}"
+            fi
+            ;;
+    esac
+}
+
+_1ls "$@"

package/dist/completions/install-completions.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+
+echo "Installing 1ls shell completions..."
+
+# Detect shell
+if [ -n "$BASH_VERSION" ]; then
+    SHELL_NAME="bash"
+elif [ -n "$ZSH_VERSION" ]; then
+    SHELL_NAME="zsh"
+else
+    echo "Unsupported shell. Only bash and zsh are supported."
+    exit 1
+fi
+
+# Get the directory of this script
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+if [ "$SHELL_NAME" = "bash" ]; then
+    # Bash installation
+    if [ -d "$HOME/.bash_completion.d" ]; then
+        cp "$SCRIPT_DIR/1ls.bash" "$HOME/.bash_completion.d/"
+        echo "Installed to ~/.bash_completion.d/"
+        echo "Add this to your ~/.bashrc if not already present:"
+        echo "  source ~/.bash_completion.d/1ls.bash"
+    elif [ -f "$HOME/.bashrc" ]; then
+        echo "" >> "$HOME/.bashrc"
+        echo "# 1ls completions" >> "$HOME/.bashrc"
+        echo "source $SCRIPT_DIR/1ls.bash" >> "$HOME/.bashrc"
+        echo "Added to ~/.bashrc"
+    else
+        echo "Could not find suitable location for bash completions"
+        echo "Please manually source: $SCRIPT_DIR/1ls.bash"
+    fi
+elif [ "$SHELL_NAME" = "zsh" ]; then
+    # Zsh installation
+    if [ -d "$HOME/.zsh/completions" ]; then
+        cp "$SCRIPT_DIR/1ls.zsh" "$HOME/.zsh/completions/_1ls"
+        echo "Installed to ~/.zsh/completions/"
+    elif [ -d "/usr/local/share/zsh/site-functions" ]; then
+        cp "$SCRIPT_DIR/1ls.zsh" "/usr/local/share/zsh/site-functions/_1ls"
+        echo "Installed to /usr/local/share/zsh/site-functions/"
+    else
+        mkdir -p "$HOME/.zsh/completions"
+        cp "$SCRIPT_DIR/1ls.zsh" "$HOME/.zsh/completions/_1ls"
+        echo "Installed to ~/.zsh/completions/"
+        echo "Add this to your ~/.zshrc if not already present:"
+        echo "  fpath=(~/.zsh/completions \$fpath)"
+        echo "  autoload -U compinit && compinit"
+    fi
+fi
+
+echo "Reload your shell or run 'source ~/.${SHELL_NAME}rc' to enable completions"

package/dist/expression/utils.d.ts

@@ -1,4 +1,5 @@
 import { LiteralNode } from "../types";
-export declare const isBooleanLiteral: (value: string) => boolean;
+import { BOOLEAN_LITERALS } from "./constants";
+export declare const isBooleanLiteral: (value: string) => value is (typeof BOOLEAN_LITERALS)[number];
 export declare const createLiteralNode: (value: string | number | boolean | null) => LiteralNode;
 export declare const tryParseLiteralIdentifier: (identifier: string) => LiteralNode | undefined;

package/dist/formats/constants.d.ts

@@ -1,3 +1,22 @@
+export declare const INTEGER: RegExp;
+export declare const INTEGER_WITH_SIGN: RegExp;
+export declare const FLOAT: RegExp;
+export declare const FLOAT_WITH_SIGN: RegExp;
+export declare const NUMBER: RegExp;
+export declare const ATTRIBUTES: RegExp;
+export declare const SELF_CLOSING: RegExp;
+export declare const OPEN_TAG: RegExp;
+export declare const NESTED_TAGS: RegExp;
+export declare const COMPLETE_TAGS: RegExp;
+export declare const XML_DECLARATION: RegExp;
+export declare const TRAILING_COMMA: RegExp;
+export declare const UNQUOTED_KEY: RegExp;
+export declare const JSON5_FEATURES: RegExp;
+export declare const SECTION_HEADER: RegExp;
+export declare const TOML_SECTION: RegExp;
+export declare const TOML_QUOTED_VALUES: RegExp;
+export declare const TOML_SYNTAX: RegExp;
+export declare const INI_SYNTAX: RegExp;
 export declare const CSV: {
     readonly NUMBER: RegExp;
 };

package/dist/formats/ini.d.ts

@@ -1,2 +1,5 @@
+import { INIParseState } from "./types";
 export declare function parseINIValue(value: string): unknown;
+export declare function stripINIComments(line: string): string;
+export declare function processINILine(state: INIParseState, line: string): INIParseState;
 export declare function parseINI(input: string): Record<string, unknown>;

package/dist/formats/javascript.d.ts

@@ -1,2 +1,8 @@
+import { ParseState } from "./types";
+export declare function isQuoteChar(char: string): boolean;
+export declare function findCommentEnd(chars: string[], startIndex: number, endPattern: string): number;
+export declare function findMultiLineCommentEnd(chars: string[], startIndex: number): number;
+export declare function handleStringChar(state: ParseState, char: string, nextChar: string | undefined): ParseState;
+export declare function handleNormalChar(state: ParseState, char: string, nextChar: string | undefined, chars: string[], index: number): ParseState;
 export declare function stripJSComments(input: string): string;
 export declare function parseJavaScript(input: string): unknown;

package/dist/formats/json5.d.ts

@@ -1,3 +1,9 @@
+import { ParseState } from "./types";
+export declare function isQuoteChar(char: string): boolean;
+export declare function findCommentEnd(chars: string[], startIndex: number, endPattern: string): number;
+export declare function findMultiLineCommentEnd(chars: string[], startIndex: number): number;
+export declare function handleStringChar(state: ParseState, char: string, nextChar: string | undefined): ParseState;
+export declare function handleNormalChar(state: ParseState, char: string, nextChar: string | undefined, chars: string[], index: number): ParseState;
 export declare function stripJSON5Comments(input: string): string;
 export declare function normalizeJSON5(input: string): string;
 export declare function parseJSON5(input: string): unknown;

package/dist/formats/utils.d.ts

@@ -1,9 +1,9 @@
 export declare const TRUTHY_VALUES: readonly ["true", "yes", "on"];
 export declare const FALSY_VALUES: readonly ["false", "no", "off"];
 export declare const NULL_VALUES: readonly ["null", "~", ""];
-export declare const isTruthyValue: (value: string) => boolean;
-export declare const isFalsyValue: (value: string) => boolean;
-export declare const isNullValue: (value: string) => boolean;
+export declare const isTruthyValue: (value: string) => value is (typeof TRUTHY_VALUES)[number];
+export declare const isFalsyValue: (value: string) => value is (typeof FALSY_VALUES)[number];
+export declare const isNullValue: (value: string) => value is (typeof NULL_VALUES)[number];
 export declare const parseBooleanValue: (value: string) => boolean | undefined;
 export declare const parseNullValue: (value: string) => null | undefined;
 export declare const tryParseNumber: (value: string) => number | undefined;

package/dist/formatter/colors.d.ts

@@ -1,3 +1,21 @@
+export declare const COLORS: {
+    reset: string;
+    bright: string;
+    dim: string;
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+};
+export declare const COLOR_PATTERNS: {
+    regex: RegExp;
+    replacement: string;
+}[];
 export declare function colorize(json: string): string;
 export declare function error(message: string): string;
 export declare function success(message: string): string;

package/dist/formatter/output.d.ts

@@ -2,7 +2,7 @@ import { CliOptions } from "../types";
 export declare class Formatter {
     private options;
     constructor(options: CliOptions);
-    format(data: any): string;
+    format(data: unknown): string;
     private formatRaw;
     private formatJson;
     private formatWithType;