lil-mocky 1.4.0

package/TODO

@@ -0,0 +1,57 @@
+# lil-mocky v2.0 API Design
+
+Breaking changes for a future major version.
+
+## Function Mocks
+
+```javascript
+mock.call(0)          // get single call (0-indexed)
+mock.calls            // count getter
+
+mock.ret('default')   // no index = default for all calls
+mock.ret('first', 0)  // 0-indexed for specific calls
+
+mock.data             // object, not function
+mock.reset()
+```
+
+## Class Mocks
+
+```javascript
+Mock.inst(0)          // get single instance (lazy creation)
+Mock.instance(0)      // synonym
+Mock.insts            // count getter
+Mock.instances        // synonym
+Mock.reset()
+```
+
+## Key Changes from v1
+
+- `mocky.fn()` synonym for `mocky.function()`
+- `mocky.obj()` synonym for `mocky.object()`
+- `mocky.cls()` synonym for `mocky.class()`
+- `calls(0)` → `call(0)` (singular for single item)
+- `calls()` array → `calls` getter for count
+- `inst()` unchanged, add `instance()` synonym
+- `numInsts()` → `insts` / `instances` getter
+- `ret` indexing: 0-indexed, no index = default (was 1-indexed with 0 as default)
+- `data()` function → `data` object
+
+## Additional Changes
+
+- `mock.throw(error)` / `mock.throw(error, 0)` - explicit error throwing
+- `argSelect()` → `pick()` - cleaner name
+- `ret()` on builder before `build()` - `mocky.fn().ret('value').build()`
+- Remove or improve `property()` builder
+- Add JSDoc comments for autocomplete (no TypeScript needed)
+- Use `structuredClone()` instead of custom deepClone (Node 17+)
+- Spy replacement: accept plain function with optional args param
+  `mocky.spy(obj, 'method', (ctx) => ..., ['x', 'y'])`
+
+## Rationale
+
+- Singular/plural pattern: `call(0)` gets one, `calls` is count
+- 0-indexed everywhere (matches JS arrays)
+- Getters for counts (they're just values, no args needed)
+- `ret('default')` more intuitive than `ret('default', 0)`
+- Synonyms for readability preference: `inst`/`instance`

package/init-docker.sh

@@ -0,0 +1,4 @@
+#!/bin/bash 
+docker build -t lil-mocky:latest .
+docker run -dit -v $(pwd):/app --name lil-mocky lil-mocky:latest
+docker exec -t lil-mocky npm install

package/lil-mocky.sublime-project

@@ -0,0 +1,8 @@
+{
+	"folders":
+	[
+		{
+			"path": "."
+		}
+	]
+}