@jarenjs/linq 0.84.3 → 0.85.0

package/docs/DB-CLIENT.md

@@ -843,10 +843,10 @@ never builds one; the migration between two of them is
 
 ## 7. Cost
 
-`@jarenjs/linq/db` builds to **<!--fact:bundle.db-->675,752<!--/fact--> bytes** as a minified,
+`@jarenjs/linq/db` builds to **<!--fact:bundle.db-->724,099<!--/fact--> bytes** as a minified,
 tree-shaken ESM bundle — the figure `scripts/check-tree-shaking.js`
 measures and `npm run test:tree-shaking` reports, published rounded
-(<!--fact:bundle.db.kb-->676<!--/fact--> kB) beside the other nine subpath prices in
+(<!--fact:bundle.db.kb-->724<!--/fact--> kB) beside the other nine subpath prices in
 [docs/CONSUMING.md](../../../docs/CONSUMING.md).
 
 It is by far the largest of the ten, and the reason is §1.1's edge rather

package/docs/LINQ-FORMAT.md

@@ -37,7 +37,7 @@ is the index of those guides, and it is how a reader reaches any of them.
 | Document | Lines | What it writes, and when to open it |
 |---|---:|---|
 | [LINQ-FORMAT.md](LINQ-FORMAT.md) | 944 | this file, the binder and the family's **normative reference**: what a pen is, the rules all of them keep, the shared `JL01xx` table, and the cross-pen views derived from the guides it indexes. **Read it when** you want a rule that is true of every pen, an index of the documents, or one place to look up a method without knowing which pen owns it |
-| [QUERY-PEN.md](QUERY-PEN.md) | 1,752 | the chain, `.` — query documents (`jaren-query`) and the provider seam. **Read it when** you are querying data, or implementing a provider that answers a query document |
+| [QUERY-PEN.md](QUERY-PEN.md) | 1,761 | the chain, `.` — query documents (`jaren-query`) and the provider seam. **Read it when** you are querying data, or implementing a provider that answers a query document |
 | [SCHEMA-PEN.md](SCHEMA-PEN.md) | 1,205 | `./schema` — JSON Schema 2020-12: the structural keywords, the constraints and the annotations, each with a method of its own, plus `$query`, `$defs`/`$ref` recursion and the normalizer's per-field predicates. **Read it when** you are describing the shape of data — for validation, for a form, or as the base of an entity |
 | [MODEL-PEN.md](MODEL-PEN.md) | 1,116 | `./model` — the `x-entity` vocabulary on JSON Schema, and the `$model` 0.1 document `openStore` accepts unchanged. **Read it when** you are declaring a store's entities, their keys and their relations |
 | [JSLT-PEN.md](JSLT-PEN.md) | 955 | `./jslt` — `$jslt` 0.1 stylesheets: the envelope and its rules, whose bodies are captured over the matched value. **Read it when** you are transforming one document into another |
@@ -204,7 +204,7 @@ and the bundle is the byte count the tree-shaking probe builds.
 | Document | Subpath | Lines | Mapping rows | Worked examples | Refusals | Bundle |
 |---|---|---:|---:|---:|---:|---:|
 | [LINQ-FORMAT.md](LINQ-FORMAT.md) | — | 944 | — | — | — | — |
-| [QUERY-PEN.md](QUERY-PEN.md) | `.` | 1,752 | 34 | 8 | 15 | 175,221 B |
+| [QUERY-PEN.md](QUERY-PEN.md) | `.` | 1,761 | 34 | 8 | 15 | 175,560 B |
 | [SCHEMA-PEN.md](SCHEMA-PEN.md) | `./schema` | 1,205 | 82 | 10 | 4 | 35,285 B |
 | [MODEL-PEN.md](MODEL-PEN.md) | `./model` | 1,116 | 30 | 6 | 3 | 44,143 B |
 | [JSLT-PEN.md](JSLT-PEN.md) | `./jslt` | 955 | 17 | 8 | 3 | 18,424 B |
@@ -217,9 +217,9 @@ and the bundle is the byte count the tree-shaking probe builds.
 | [JTLT-PEN.md](JTLT-PEN.md) | `./jtlt` | 83 | 13 | 1 | 2 | 15,293 B |
 | [PROJECT-PEN.md](PROJECT-PEN.md) | `./project` | 81 | 9 | 1 | 1 | 13,793 B |
 | [CHARTS-PEN.md](CHARTS-PEN.md) | `./charts` | 94 | 21 | 1 | 1 | 15,582 B |
-| [DB-CLIENT.md](DB-CLIENT.md) | `./db` | 1,085 | 46 | 4 | 2 | 675,752 B |
+| [DB-CLIENT.md](DB-CLIENT.md) | `./db` | 1,085 | 46 | 4 | 2 | 724,099 B |
 | [FORMULA-PEN.md](FORMULA-PEN.md) | `./formula` | 41 | 2 | — | — | 14,850 B |
-| **16 documents** | | **12,579** | **368** | **72** | | |
+| **16 documents** | | **12,588** | **368** | **72** | | |
 <!--/fact-->
 
 A pen whose mapping rows are far below its worked examples is a pen
@@ -261,7 +261,7 @@ it and each document publishes it. The rounded column is what
 <!--fact:pens.cost-->
 | Subpath | Document | Bundle | Rounded |
 |---|---|---:|---:|
-| `@jarenjs/linq` | [QUERY-PEN.md](QUERY-PEN.md) | 175,221 B | 175 kB |
+| `@jarenjs/linq` | [QUERY-PEN.md](QUERY-PEN.md) | 175,560 B | 176 kB |
 | `@jarenjs/linq/schema` | [SCHEMA-PEN.md](SCHEMA-PEN.md) | 35,285 B | 35 kB |
 | `@jarenjs/linq/model` | [MODEL-PEN.md](MODEL-PEN.md) | 44,143 B | 44 kB |
 | `@jarenjs/linq/jslt` | [JSLT-PEN.md](JSLT-PEN.md) | 18,424 B | 18 kB |
@@ -274,7 +274,7 @@ it and each document publishes it. The rounded column is what
 | `@jarenjs/linq/jtlt` | [JTLT-PEN.md](JTLT-PEN.md) | 15,293 B | 15 kB |
 | `@jarenjs/linq/project` | [PROJECT-PEN.md](PROJECT-PEN.md) | 13,793 B | 14 kB |
 | `@jarenjs/linq/charts` | [CHARTS-PEN.md](CHARTS-PEN.md) | 15,582 B | 16 kB |
-| `@jarenjs/linq/db` | [DB-CLIENT.md](DB-CLIENT.md) | 675,752 B | 676 kB |
+| `@jarenjs/linq/db` | [DB-CLIENT.md](DB-CLIENT.md) | 724,099 B | 724 kB |
 | `@jarenjs/linq/formula` | [FORMULA-PEN.md](FORMULA-PEN.md) | 14,850 B | 15 kB |
 <!--/fact-->
 

package/docs/QUERY-PEN.md

@@ -1683,14 +1683,14 @@ are shorter:
 ## 17. Cost
 
 A consumer importing `from` from `@jarenjs/linq` and calling one
-terminal bundles **<!--fact:bundle.chain-->175,221<!--/fact--> bytes** (esbuild, ESM, minified, tree-shaken,
+terminal bundles **<!--fact:bundle.chain-->175,560<!--/fact--> bytes** (esbuild, ESM, minified, tree-shaken,
 `platform: 'neutral'`). The figure is measured by
 `scripts/check-tree-shaking.js`'s chain probe and compared with this
 section on every `npm run test:tree-shaking`: it is derived, never typed,
 and a stale one is red here rather than wrong in a document somebody
 reads.
 
-Of that, **<!--fact:bundle.chain.own-->38,701<!--/fact--> bytes** are the chain's own modules — `sequence.js`,
+Of that, **<!--fact:bundle.chain.own-->39,040<!--/fact--> bytes** are the chain's own modules — `sequence.js`,
 `async.js`, `expression.js`, `document.js`, `provider.js`,
 `concurrency.js`, `errors.js` and `schema-of.js`. The remaining ~134 kB
 is the query ENGINE and the core it stands on: a chain's document has to
@@ -1716,8 +1716,8 @@ making:
 
 `docs/CONSUMING.md` states the rounded price of all ten subpaths in one
 table, each figure held equal to the same measurements. Two of its rows
-are the ones to read together: the chain at <!--fact:bundle.chain.kb-->175<!--/fact--> kB and
-`./db` at <!--fact:bundle.db.kb-->676<!--/fact--> kB.
+are the ones to read together: the chain at <!--fact:bundle.chain.kb-->176<!--/fact--> kB and
+`./db` at <!--fact:bundle.db.kb-->724<!--/fact--> kB.
 The client costs what the store costs, by construction, and the chain
 costs what running a query costs.
 
@@ -1726,7 +1726,7 @@ the reason is worth knowing: a bundler counts a shared module once, and
 the chain and every pen share the expression capture (`expression.js`)
 and the coded errors under it (`errors.js`, and `@jarenjs/core`'s error
 and object helpers). A consumer importing the chain AND the schema pen
-bundles **<!--fact:bundle.chain.withSchemaPen-->199,375<!--/fact--> bytes** — **<!--fact:bundle.chain.shared-->11,131<!--/fact--> bytes** less than the sum of the
+bundles **<!--fact:bundle.chain.withSchemaPen-->199,716<!--/fact--> bytes** — **<!--fact:bundle.chain.shared-->11,129<!--/fact--> bytes** less than the sum of the
 figure above and [SCHEMA-PEN.md](SCHEMA-PEN.md#7-cost) §7's, which is
 what those shared modules weigh. The probe measures that pair too, so
 the saving is derived like everything else here. What the chain does NOT
@@ -1750,3 +1750,12 @@ never builds an index or runs a second ranker. Compile the emitted document with
 `createLexicalProvider` capability that a hand-written query uses. The ordinary
 sequence provider has no implicit search catalog. Filters/facets run before top-k,
 continuations bind the source snapshot, and `$search` remains regex-based.
+
+For synchronous providers, iteration uses an available `syncQuery(document,
+options)` cursor and propagates early return to release it. Providers without
+that member retain their collecting behavior. SQLite entity planning flattens
+safe identity/object projection chains and projected joins followed by filters
+and ordering; it retains barriers around windows, grouping and inner ordering.
+Standalone supported physical min/max and integer sum/average use guarded native
+aggregates. Explicit SQLite null, collation, raw JSON text and byte semantics are
+available through [the data layer native surface](../../db/docs/SQLITE-RELATIONAL.md).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jarenjs/linq",
   "private": false,
-  "version": "0.84.3",
+  "version": "0.85.0",
   "type": "module",
   "main": "./src/index.js",
   "types": "./types/index.d.ts",
@@ -108,13 +108,13 @@
     "prepack": "npm run build:types"
   },
   "dependencies": {
-    "@jarenjs/core": "^0.84.3",
-    "@jarenjs/json": "^0.84.3"
+    "@jarenjs/core": "^0.85.0",
+    "@jarenjs/json": "^0.85.0"
   },
   "peerDependencies": {
-    "@jarenjs/db": "^0.84.3",
-    "@jarenjs/formats": "^0.84.3",
-    "@jarenjs/validate": "^0.84.3"
+    "@jarenjs/db": "^0.85.0",
+    "@jarenjs/formats": "^0.85.0",
+    "@jarenjs/validate": "^0.85.0"
   },
   "peerDependenciesMeta": {
     "@jarenjs/db": {

package/src/sequence.js

@@ -507,6 +507,16 @@ export class Sequence {
   }
 
   * [Symbol.iterator]() {
+    if (this.#sourceKind === 'provider' && typeof this.#source.syncQuery === 'function') {
+      const document = this.toDocument();
+      const cursor = this.#source.syncQuery(document === this.#root
+        ? { $for: { it: this.#root }, $return: '$it' } : document,
+      { externals: Object.fromEntries(this.#params) });
+      if (cursor == null || typeof cursor[Symbol.iterator] !== 'function')
+        throw new LinqRuntimeError('JL2004', 'syncQuery() must return a synchronous iterable cursor');
+      yield* cursor;
+      return;
+    }
     yield* this.toArray();
   }
 

package/types/index.d.ts

@@ -457,6 +457,8 @@ export interface Provider<T = unknown> {
   /** The item phantom: never present at runtime; what `from` infers `T` from. */
   readonly __item?: T;
   execute(document: unknown, options: { externals: Record<string, unknown> }): unknown;
+  /** Optional native synchronous cursor; iteration closes it on early return. */
+  syncQuery?(document: unknown, options: { externals: Record<string, unknown> }): Iterable<T>;
   /** The root expression the items are bound through (`'$.Post[*]'`);
    * absent means the whole input, `'$[*]'`. */
   readonly root?: string;

package/types/model.d.ts

@@ -66,12 +66,24 @@ export interface PhysicalLayout {
   readonly table: string;
   readonly kind?: 'table' | 'view';
   readonly keys?: readonly string[];
+  readonly constraints?: readonly object[];
+  readonly indexes?: readonly object[];
+  readonly triggers?: readonly object[];
+  readonly strict?: boolean;
+  readonly withoutRowid?: boolean;
   readonly columns: Readonly<Record<string, {
     readonly name: string;
     readonly codec: 'text' | 'integer' | 'number' | 'boolean' | 'json' | 'date' | 'datetime' | 'epoch-ms' | 'bigint' | 'decimal' | 'blob-hex';
     readonly null: 'null' | 'absent' | 'reject';
     readonly default?: 'database';
     readonly generated?: boolean;
+    readonly type?: 'INTEGER' | 'REAL' | 'TEXT' | 'BLOB' | 'NUMERIC';
+    readonly defaultValue?: unknown;
+    readonly collation?: 'BINARY' | 'NOCASE' | 'RTRIM';
+    readonly identity?: 'rowid' | 'autoincrement';
+    readonly check?: unknown;
+    readonly generatedExpression?: unknown;
+    readonly stored?: boolean;
   }>>;
 }