docs(readme): refresh documentation and build configuration

- Adjust deno.json imports for new directory structure
- Update README badges and formatting
- Update build.config.ts entries for core/ and query/ modules
- Revise USAGE.md examples with latest query patterns

Author: NeaByteLab

README.md

@@ -58,7 +58,7 @@ const adults = db.where('age >= 18').get()
 const firstJohn = db.where('name = John').first()
 ```
 
-- [USAGE.md](USAGE.md) for more examples and query operator details.
+See [USAGE.md](USAGE.md) for more examples and query operator details.
 
 ## Build
 

USAGE.md

@@ -9,20 +9,29 @@ Querying, updating, and deleting records for `@neabyte/jsonary`.
 - [Nested Fields (Dot Paths)](#nested-fields-dot-paths)
 - [CRUD API](#crud-api)
 - [Query Builder API](#query-builder-api)
+  - [Chaining `where()`](#chaining-where)
 - [Notes and Limits](#notes-and-limits)
 
 ## Quick Start
 
 ```typescript
+// Import Jsonary
 import Jsonary from '@neabyte/jsonary'
 
+// Create database instance
 const db = new Jsonary({ path: './data.json' })
 
+// Insert records
 db.insert({ name: 'John', age: 30, profile: { role: 'user', active: false } })
 db.insert({ name: 'Jane', age: 25, profile: { role: 'admin', active: true } })
 
+// Query with dot-path nested field
 const admins = db.where('profile.role = admin').get()
+
+// Get first match
 const firstAdult = db.where('age >= 18').first()
+
+// Count matching records
 const countActive = db.where('profile.active = true').count()
 ```
 
@@ -43,8 +52,11 @@ Supported operators in string conditions:
 Examples:
 
 ```typescript
+// Comparison operators
 db.where('age >= 18').get()
 db.where('name != John').get()
+
+// String matching operators
 db.where('name contains "oh"').get()
 db.where('name startsWith J').get()
 db.where('name endsWith "e"').get()
@@ -58,14 +70,18 @@ db.where('name endsWith "e"').get()
 You can query nested properties using dot paths:
 
 ```typescript
+// Query nested object properties
 db.where('profile.role = admin').get()
 db.where('profile.settings.theme = dark').get()
 ```
 
 You can also update nested properties using dot paths:
 
 ```typescript
+// Update nested properties via dot-path
 db.updateWhere('name = John', { 'profile.active': true })
+
+// Works with query builder too
 db.where('profile.role = admin').update({ 'profile.verified': true })
 ```
 
@@ -84,6 +100,7 @@ const db = new Jsonary({ path: './data.json' })
 Insert one record.
 
 ```typescript
+// Insert single record
 db.insert({ name: 'John', age: 30 })
 ```
 
@@ -92,6 +109,7 @@ db.insert({ name: 'John', age: 30 })
 Insert multiple records.
 
 ```typescript
+// Insert multiple records at once
 db.insertMany([{ name: 'Jane' }, { name: 'Bob' }])
 ```
 
@@ -100,6 +118,7 @@ db.insertMany([{ name: 'Jane' }, { name: 'Bob' }])
 Return all records (copy).
 
 ```typescript
+// Get all records (returns a copy)
 const all = db.get()
 ```
 
@@ -108,22 +127,32 @@ const all = db.get()
 Update records matching condition. Returns number of updated records.
 
 ```typescript
+// Update records where age is greater than 30
 const updated = db.updateWhere('age > 30', { status: 'senior' })
+
+// Update records where age is greater than 30 using a function predicate
+const updatedFn = db.updateWhere(item => (item.age as number) > 30, { status: 'senior' })
 ```
 
 ### `db.deleteWhere(condition)`
 
 Delete records matching condition. Returns number of deleted records.
 
 ```typescript
+// Delete by string condition
 const deleted = db.deleteWhere('age < 18')
+
+// Delete by function predicate
+const deletedFn = db.deleteWhere(item => (item.age as number) < 18)
 ```
 
 ### `db.clear()`
 
 Clear all records (writes empty array to file).
 
 ```typescript
+// Remove all records
+// Note: Also persists empty array to file
 db.clear()
 ```
 
@@ -132,6 +161,8 @@ db.clear()
 Reload internal data from file.
 
 ```typescript
+// Reload data from file
+// Useful when file is modified externally
 db.reload()
 ```
 
@@ -142,15 +173,36 @@ db.reload()
 Create a query builder. `condition` can be a string condition or a predicate function.
 
 ```typescript
+// Query with string condition
 const qb = db.where('age >= 18')
+
+// Query with function predicate
 const qbFn = db.where(item => (item.age as number) >= 18)
 ```
 
+### Chaining `where()`
+
+You can chain multiple `where()` calls to refine your query:
+
+```typescript
+// Chain multiple where conditions (AND logic)
+db.where('age >= 18').where('profile.active = true').get()
+
+// Mix string conditions with function predicates
+db.where('age >= 18')
+  .where(item => (item.name as string).startsWith('J'))
+  .first()
+
+// Chaining works with all query builder methods
+db.where('age >= 18').where('profile.role = admin').count()
+```
+
 ### `where(...).get()`
 
 Get all matching records (copy).
 
 ```typescript
+// Get all matching records
 const adults = db.where('age >= 18').get()
 ```
 
@@ -159,6 +211,7 @@ const adults = db.where('age >= 18').get()
 Get the first matching record or `null`.
 
 ```typescript
+// Get first match or null if none found
 const first = db.where('profile.role = admin').first()
 ```
 
@@ -167,6 +220,7 @@ const first = db.where('profile.role = admin').first()
 Count matching records.
 
 ```typescript
+// Count matching records
 const count = db.where('profile.active = true').count()
 ```
 
@@ -175,7 +229,10 @@ const count = db.where('profile.active = true').count()
 Update all matching records (writes through to the database file when called from `db.where(...)`).
 
 ```typescript
+// Update all matching records
 db.where('profile.role = admin').update({ level: 'staff' })
+
+// Update nested properties
 db.where('profile.role = admin').update({ 'profile.verified': true })
 ```
 
@@ -184,6 +241,7 @@ db.where('profile.role = admin').update({ 'profile.verified': true })
 Delete all matching records (writes through to the database file when called from `db.where(...)`).
 
 ```typescript
+// Delete all matching records
 const deleted = db.where('age < 18').delete()
 ```
 

build.config.ts

@@ -14,7 +14,9 @@ export default defineBuildConfig({
   clean: true,
   /** Path alias for imports (e.g. @root → src). */
   alias: {
-    '@app': resolve(__dirname, 'src')
+    '@app': resolve(__dirname, 'src'),
+    '@core': resolve(__dirname, 'src', 'core'),
+    '@query': resolve(__dirname, 'src', 'query')
   },
   /** Rollup options: emit CJS and inline runtime deps. */
   rollup: {

deno.json

@@ -67,7 +67,10 @@
   "imports": {
     "@std/assert": "jsr:@std/assert@^1.0.19",
     "@neabyte/jsonary": "./src/index.ts",
-    "@app/": "./src/"
+    "@app/": "./src/",
+    "@core/": "./src/core/",
+    "@query/": "./src/query/",
+    "@tests/": "./tests/"
   },
   "publish": {
     "include": ["src/", "README.md", "LICENSE", "USAGE.md", "deno.json"]