solve-engine 1.0.0-beta.7 → 1.0.0

package/dist/packages.js

@@ -1,23 +1,23 @@
-export { ARITHMETIC_PACKAGE, BIGINT_PACKAGE, BUILTIN_PACKAGES, CONDITIONALS_PACKAGE, CONVERTERS_PACKAGE, CURRENCY_PACKAGE, DATETIME_PACKAGE, DICE_PACKAGE, FINANCE_PACKAGE, FUNCTION_PACKAGE, LINES_PACKAGE, MAPREDUCE_PACKAGE, MATHPHRASES_PACKAGE, MATRIX_PACKAGE, PERCENTAGE_PACKAGE, SYMBOLIC_PACKAGE, TIME_PACKAGE, UOM_PACKAGE, VARIABLES_PACKAGE, VECTOR_PACKAGE, WEATHER_PACKAGE, createKnowledgePackage, createStocksPackage } from './chunk-GVWHCL2N.js';
-import './chunk-6GCKCWLB.js';
-import './chunk-OFXOTECC.js';
-import './chunk-PFSDGGYL.js';
-import './chunk-YU2CUNFO.js';
+export { ARITHMETIC_PACKAGE, BIGINT_PACKAGE, BUILTIN_PACKAGES, CONDITIONALS_PACKAGE, CONVERTERS_PACKAGE, CURRENCY_PACKAGE, DATETIME_PACKAGE, DICE_PACKAGE, FINANCE_PACKAGE, FUNCTION_PACKAGE, LINES_PACKAGE, MAPREDUCE_PACKAGE, MATHPHRASES_PACKAGE, MATRIX_PACKAGE, PERCENTAGE_PACKAGE, SYMBOLIC_PACKAGE, TIME_PACKAGE, UOM_PACKAGE, VARIABLES_PACKAGE, VECTOR_PACKAGE, WEATHER_PACKAGE, createKnowledgePackage, createStocksPackage } from './chunk-HMOISHXR.js';
+import './chunk-526PMQOA.js';
+import './chunk-YPPPYLSR.js';
+import './chunk-3BOK2LDK.js';
+import './chunk-KV7UW6T6.js';
 import './chunk-NLNDMWZC.js';
-import './chunk-MVBEL57Q.js';
+import './chunk-Y7FT4IQT.js';
 import './chunk-GCM5JHMX.js';
-import './chunk-UKPGSAZW.js';
-import './chunk-75JP4BZX.js';
+import './chunk-TMA4RCEN.js';
+import './chunk-UQ3UIZJC.js';
 import './chunk-Z4X2RWOF.js';
-import './chunk-CYFK5SY2.js';
-import './chunk-BVAR5J2F.js';
-import './chunk-WC5FFSHB.js';
-import './chunk-SFQWJMKT.js';
-import './chunk-GPPLSM2Z.js';
+import './chunk-O3ANBHSA.js';
+import './chunk-GQCOSXMG.js';
+import './chunk-R3PY4G7J.js';
+import './chunk-QY25VWBF.js';
+import './chunk-VB37OC6I.js';
 import './chunk-XBTEO4OB.js';
-import './chunk-M5E34VG5.js';
-import './chunk-PCPX42KL.js';
-import './chunk-6RDSQURE.js';
+import './chunk-SBUFNJVE.js';
+import './chunk-V4XG5QF6.js';
+import './chunk-3D7V24DG.js';
 import './chunk-YLJ4XMA6.js';
 //# sourceMappingURL=packages.js.map
 //# sourceMappingURL=packages.js.map

package/dist/parser.cjs

@@ -1,55 +1,55 @@
 'use strict';
 
-var chunkMTX2KVU7_cjs = require('./chunk-MTX2KVU7.cjs');
+var chunkHVQFNJKE_cjs = require('./chunk-HVQFNJKE.cjs');
 require('./chunk-47LRVGOT.cjs');
-var chunkNZFKROS7_cjs = require('./chunk-NZFKROS7.cjs');
-var chunkMZOVP3WI_cjs = require('./chunk-MZOVP3WI.cjs');
-require('./chunk-R24DI24X.cjs');
+var chunkPA4VC73I_cjs = require('./chunk-PA4VC73I.cjs');
+var chunk6KFYJ6TD_cjs = require('./chunk-6KFYJ6TD.cjs');
+require('./chunk-5LI5EPGJ.cjs');
 require('./chunk-OUHT5Z36.cjs');
-require('./chunk-M4N5GA5Z.cjs');
+require('./chunk-5KMIY374.cjs');
 require('./chunk-B7LXJ6LC.cjs');
 
 
 
 Object.defineProperty(exports, "ParseletRegistry", {
   enumerable: true,
-  get: function () { return chunkMTX2KVU7_cjs.ParseletRegistry; }
+  get: function () { return chunkHVQFNJKE_cjs.ParseletRegistry; }
 });
 Object.defineProperty(exports, "Parser", {
   enumerable: true,
-  get: function () { return chunkMTX2KVU7_cjs.PrecedenceParser; }
+  get: function () { return chunkHVQFNJKE_cjs.PrecedenceParser; }
 });
 Object.defineProperty(exports, "PrecedenceParser", {
   enumerable: true,
-  get: function () { return chunkMTX2KVU7_cjs.PrecedenceParser; }
+  get: function () { return chunkHVQFNJKE_cjs.PrecedenceParser; }
 });
 Object.defineProperty(exports, "sharedParseletRegistry", {
   enumerable: true,
-  get: function () { return chunkMTX2KVU7_cjs.sharedParseletRegistry; }
+  get: function () { return chunkHVQFNJKE_cjs.sharedParseletRegistry; }
 });
 Object.defineProperty(exports, "BindingPower", {
   enumerable: true,
-  get: function () { return chunkNZFKROS7_cjs.BindingPower; }
+  get: function () { return chunkPA4VC73I_cjs.BindingPower; }
 });
 Object.defineProperty(exports, "BytecodeBuilder", {
   enumerable: true,
-  get: function () { return chunkNZFKROS7_cjs.BytecodeBuilder; }
+  get: function () { return chunkPA4VC73I_cjs.BytecodeBuilder; }
 });
 Object.defineProperty(exports, "buildBindingPowerTable", {
   enumerable: true,
-  get: function () { return chunkNZFKROS7_cjs.buildBindingPowerTable; }
+  get: function () { return chunkPA4VC73I_cjs.buildBindingPowerTable; }
 });
 Object.defineProperty(exports, "invalidateBindingPowerTable", {
   enumerable: true,
-  get: function () { return chunkNZFKROS7_cjs.invalidateBindingPowerTable; }
+  get: function () { return chunkPA4VC73I_cjs.invalidateBindingPowerTable; }
 });
 Object.defineProperty(exports, "OpCode", {
   enumerable: true,
-  get: function () { return chunkMZOVP3WI_cjs.OpCode; }
+  get: function () { return chunk6KFYJ6TD_cjs.OpCode; }
 });
 Object.defineProperty(exports, "getOpCodeName", {
   enumerable: true,
-  get: function () { return chunkMZOVP3WI_cjs.getOpCodeName; }
+  get: function () { return chunk6KFYJ6TD_cjs.getOpCodeName; }
 });
 //# sourceMappingURL=parser.cjs.map
 //# sourceMappingURL=parser.cjs.map

package/dist/parser.d.cts

@@ -1,8 +1,8 @@
-export { I as InfixParselet, P as ParseletRegistry, a as Parser, a as PrecedenceParser, b as PrefixParselet, s as sharedParseletRegistry } from './Parselet-Cu0bLSis.cjs';
-export { B as BytecodeBuilder, a as BytecodeProgram, O as OpCode, g as getOpCodeName } from './BytecodeBuilder-3egMyuDi.cjs';
+export { I as InfixParselet, P as ParseletRegistry, a as Parser, a as PrecedenceParser, b as PrefixParselet, s as sharedParseletRegistry } from './Parselet-DuI1Pjiq.cjs';
+export { B as BytecodeBuilder, a as BytecodeProgram, O as OpCode, g as getOpCodeName } from './BytecodeBuilder-B0xskcv5.cjs';
 import './Token-BzG5G4ja.cjs';
-import './pipeline-DPUQt7yL.cjs';
-import './Value-KtAQNHur.cjs';
+import './pipeline-BEb3hujr.cjs';
+import './Value-CXJqDH9J.cjs';
 
 /**
  * Named precedence levels for the Pratt parser, from loosest (`Lowest`) to
@@ -20,10 +20,13 @@ declare const BindingPower: {
     readonly Assignment: 10;
     readonly LogicalOr: 12;
     readonly LogicalAnd: 14;
-    readonly Conditional: 20;
-    readonly Conjunction: 28;
+    readonly Conjunction: 16;
+    readonly BitwiseOr: 18;
+    readonly BitwiseXor: 20;
+    readonly BitwiseAnd: 22;
+    readonly Conditional: 24;
+    readonly Shift: 27;
     readonly Sum: 30;
-    readonly BitwiseXor: 35;
     readonly Product: 40;
     readonly Exponent: 50;
     readonly Prefix: 60;
@@ -39,8 +42,19 @@ declare const BindingPower: {
  */
 declare function buildBindingPowerTable(): Uint8Array;
 /**
- * Invalidate the cached BP table, call when plugins register new token types
- * that should participate in the built-in fast path.
+ * Drop the cached table, so the next {@link buildBindingPowerTable} call builds
+ * a fresh one sized to the token types registered by then.
+ *
+ * It does NOT add a plugin's operator to the Tier 1 fast path, which is what
+ * this comment used to promise. The values in the table come from
+ * `BUILTIN_INFIX_BP`, which is module-private and has no registration path, so
+ * a rebuilt table holds the same binding powers and a plugin token still reads
+ * 0. `PrecedenceParser.BP_TABLE` is a static initialized once at class
+ * definition time and never re-read, so it would not see a rebuild anyway.
+ *
+ * A plugin's infix operator takes the Tier 2 parselet-registry route instead,
+ * which is where an operator whose binding power the engine does not already
+ * know is meant to live.
  */
 declare function invalidateBindingPowerTable(): void;
 

package/dist/parser.d.ts

@@ -1,8 +1,8 @@
-export { I as InfixParselet, P as ParseletRegistry, a as Parser, a as PrecedenceParser, b as PrefixParselet, s as sharedParseletRegistry } from './Parselet-DEdF9I7n.js';
-export { B as BytecodeBuilder, a as BytecodeProgram, O as OpCode, g as getOpCodeName } from './BytecodeBuilder-3egMyuDi.js';
+export { I as InfixParselet, P as ParseletRegistry, a as Parser, a as PrecedenceParser, b as PrefixParselet, s as sharedParseletRegistry } from './Parselet-BaySkMV3.js';
+export { B as BytecodeBuilder, a as BytecodeProgram, O as OpCode, g as getOpCodeName } from './BytecodeBuilder-B0xskcv5.js';
 import './Token-BzG5G4ja.js';
-import './pipeline-CrsRPmsv.js';
-import './Value-KtAQNHur.js';
+import './pipeline-B6k5lCB7.js';
+import './Value-CXJqDH9J.js';
 
 /**
  * Named precedence levels for the Pratt parser, from loosest (`Lowest`) to
@@ -20,10 +20,13 @@ declare const BindingPower: {
     readonly Assignment: 10;
     readonly LogicalOr: 12;
     readonly LogicalAnd: 14;
-    readonly Conditional: 20;
-    readonly Conjunction: 28;
+    readonly Conjunction: 16;
+    readonly BitwiseOr: 18;
+    readonly BitwiseXor: 20;
+    readonly BitwiseAnd: 22;
+    readonly Conditional: 24;
+    readonly Shift: 27;
     readonly Sum: 30;
-    readonly BitwiseXor: 35;
     readonly Product: 40;
     readonly Exponent: 50;
     readonly Prefix: 60;
@@ -39,8 +42,19 @@ declare const BindingPower: {
  */
 declare function buildBindingPowerTable(): Uint8Array;
 /**
- * Invalidate the cached BP table, call when plugins register new token types
- * that should participate in the built-in fast path.
+ * Drop the cached table, so the next {@link buildBindingPowerTable} call builds
+ * a fresh one sized to the token types registered by then.
+ *
+ * It does NOT add a plugin's operator to the Tier 1 fast path, which is what
+ * this comment used to promise. The values in the table come from
+ * `BUILTIN_INFIX_BP`, which is module-private and has no registration path, so
+ * a rebuilt table holds the same binding powers and a plugin token still reads
+ * 0. `PrecedenceParser.BP_TABLE` is a static initialized once at class
+ * definition time and never re-read, so it would not see a rebuild anyway.
+ *
+ * A plugin's infix operator takes the Tier 2 parselet-registry route instead,
+ * which is where an operator whose binding power the engine does not already
+ * know is meant to live.
  */
 declare function invalidateBindingPowerTable(): void;
 

package/dist/parser.js

@@ -1,10 +1,10 @@
-export { ParseletRegistry, PrecedenceParser as Parser, PrecedenceParser, sharedParseletRegistry } from './chunk-MEOHSQEH.js';
+export { ParseletRegistry, PrecedenceParser as Parser, PrecedenceParser, sharedParseletRegistry } from './chunk-3LAEG75D.js';
 import './chunk-G535KJEG.js';
-export { BindingPower, BytecodeBuilder, buildBindingPowerTable, invalidateBindingPowerTable } from './chunk-6GCKCWLB.js';
-export { OpCode, getOpCodeName } from './chunk-75JP4BZX.js';
-import './chunk-GPPLSM2Z.js';
+export { BindingPower, BytecodeBuilder, buildBindingPowerTable, invalidateBindingPowerTable } from './chunk-526PMQOA.js';
+export { OpCode, getOpCodeName } from './chunk-UQ3UIZJC.js';
+import './chunk-VB37OC6I.js';
 import './chunk-XBTEO4OB.js';
-import './chunk-6RDSQURE.js';
+import './chunk-3D7V24DG.js';
 import './chunk-YLJ4XMA6.js';
 //# sourceMappingURL=parser.js.map
 //# sourceMappingURL=parser.js.map

package/dist/{pipeline-CrsRPmsv.d.ts → pipeline-B6k5lCB7.d.ts}

@@ -1,4 +1,4 @@
-import { M as MatrixData, R as RangeData, S as SymbolicNode } from './Value-KtAQNHur.js';
+import { M as MatrixData, R as RangeData, S as SymbolicNode } from './Value-CXJqDH9J.js';
 
 /** Base event, all events include a timestamp relative to pipeline start */
 interface BaseEvent {

package/dist/{pipeline-DPUQt7yL.d.cts → pipeline-BEb3hujr.d.cts}

@@ -1,4 +1,4 @@
-import { M as MatrixData, R as RangeData, S as SymbolicNode } from './Value-KtAQNHur.cjs';
+import { M as MatrixData, R as RangeData, S as SymbolicNode } from './Value-CXJqDH9J.cjs';
 
 /** Base event, all events include a timestamp relative to pipeline start */
 interface BaseEvent {

package/dist/resolvers.d.cts

@@ -1,7 +1,7 @@
 import { QueryClient } from '@tanstack/query-core';
 import { T as Token } from './Token-BzG5G4ja.cjs';
-import { a as BytecodeProgram } from './BytecodeBuilder-3egMyuDi.cjs';
-import { V as Value } from './Value-KtAQNHur.cjs';
+import { a as BytecodeProgram } from './BytecodeBuilder-B0xskcv5.cjs';
+import { V as Value } from './Value-CXJqDH9J.cjs';
 
 /**
  * Result from a resolver's preflight() check.

package/dist/resolvers.d.ts

@@ -1,7 +1,7 @@
 import { QueryClient } from '@tanstack/query-core';
 import { T as Token } from './Token-BzG5G4ja.js';
-import { a as BytecodeProgram } from './BytecodeBuilder-3egMyuDi.js';
-import { V as Value } from './Value-KtAQNHur.js';
+import { a as BytecodeProgram } from './BytecodeBuilder-B0xskcv5.js';
+import { V as Value } from './Value-CXJqDH9J.js';
 
 /**
  * Result from a resolver's preflight() check.

package/dist/uom.cjs

@@ -1,56 +1,56 @@
 'use strict';
 
-var chunk4AVD7NZW_cjs = require('./chunk-4AVD7NZW.cjs');
-var chunk2MV4HBKC_cjs = require('./chunk-2MV4HBKC.cjs');
-require('./chunk-MZOVP3WI.cjs');
+var chunk4B2CNWQU_cjs = require('./chunk-4B2CNWQU.cjs');
+var chunkA2N2GFCG_cjs = require('./chunk-A2N2GFCG.cjs');
+require('./chunk-6KFYJ6TD.cjs');
 require('./chunk-VEKIWQ3F.cjs');
-require('./chunk-OC6LTXYS.cjs');
-var chunkNJTXJ5AG_cjs = require('./chunk-NJTXJ5AG.cjs');
-require('./chunk-MBNQVDVC.cjs');
-require('./chunk-M4N5GA5Z.cjs');
+require('./chunk-JMXUNXQS.cjs');
+var chunkPFUESQTW_cjs = require('./chunk-PFUESQTW.cjs');
+require('./chunk-AMOJYLG2.cjs');
+require('./chunk-5KMIY374.cjs');
 require('./chunk-B7LXJ6LC.cjs');
 
 
 
 Object.defineProperty(exports, "CurrencyAsyncResolver", {
   enumerable: true,
-  get: function () { return chunk4AVD7NZW_cjs.CurrencyAsyncResolver; }
+  get: function () { return chunk4B2CNWQU_cjs.CurrencyAsyncResolver; }
 });
 Object.defineProperty(exports, "CurrencyExchangeService", {
   enumerable: true,
-  get: function () { return chunk2MV4HBKC_cjs.CurrencyExchangeService; }
+  get: function () { return chunkA2N2GFCG_cjs.CurrencyExchangeService; }
 });
 Object.defineProperty(exports, "currencyExchangeService", {
   enumerable: true,
-  get: function () { return chunk2MV4HBKC_cjs.currencyExchangeService; }
+  get: function () { return chunkA2N2GFCG_cjs.currencyExchangeService; }
 });
 Object.defineProperty(exports, "sharedCurrencyExchange", {
   enumerable: true,
-  get: function () { return chunk2MV4HBKC_cjs.sharedCurrencyExchange; }
+  get: function () { return chunkA2N2GFCG_cjs.sharedCurrencyExchange; }
 });
 Object.defineProperty(exports, "canConvert", {
   enumerable: true,
-  get: function () { return chunkNJTXJ5AG_cjs.canConvert; }
+  get: function () { return chunkPFUESQTW_cjs.canConvert; }
 });
 Object.defineProperty(exports, "convertUnit", {
   enumerable: true,
-  get: function () { return chunkNJTXJ5AG_cjs.convertUnit; }
+  get: function () { return chunkPFUESQTW_cjs.convertUnit; }
 });
 Object.defineProperty(exports, "getBestUnit", {
   enumerable: true,
-  get: function () { return chunkNJTXJ5AG_cjs.getBestUnit; }
+  get: function () { return chunkPFUESQTW_cjs.getBestUnit; }
 });
 Object.defineProperty(exports, "getMeasure", {
   enumerable: true,
-  get: function () { return chunkNJTXJ5AG_cjs.getMeasure; }
+  get: function () { return chunkPFUESQTW_cjs.getMeasure; }
 });
 Object.defineProperty(exports, "isConvertibleUnit", {
   enumerable: true,
-  get: function () { return chunkNJTXJ5AG_cjs.isConvertibleUnit; }
+  get: function () { return chunkPFUESQTW_cjs.isConvertibleUnit; }
 });
 Object.defineProperty(exports, "resolveUnit", {
   enumerable: true,
-  get: function () { return chunkNJTXJ5AG_cjs.resolveUnit; }
+  get: function () { return chunkPFUESQTW_cjs.resolveUnit; }
 });
 //# sourceMappingURL=uom.cjs.map
 //# sourceMappingURL=uom.cjs.map

package/dist/uom.d.cts

@@ -1,8 +1,8 @@
 import { QueryClient } from '@tanstack/query-core';
 import { T as Token } from './Token-BzG5G4ja.cjs';
-import { a as BytecodeProgram } from './BytecodeBuilder-3egMyuDi.cjs';
+import { a as BytecodeProgram } from './BytecodeBuilder-B0xskcv5.cjs';
 import { IAsyncResolver, AsyncCheckResult } from './resolvers.cjs';
-import './Value-KtAQNHur.cjs';
+import './Value-CXJqDH9J.cjs';
 
 /**
  * Caches exchange rates fetched from an external source.

package/dist/uom.d.ts

@@ -1,8 +1,8 @@
 import { QueryClient } from '@tanstack/query-core';
 import { T as Token } from './Token-BzG5G4ja.js';
-import { a as BytecodeProgram } from './BytecodeBuilder-3egMyuDi.js';
+import { a as BytecodeProgram } from './BytecodeBuilder-B0xskcv5.js';
 import { IAsyncResolver, AsyncCheckResult } from './resolvers.js';
-import './Value-KtAQNHur.js';
+import './Value-CXJqDH9J.js';
 
 /**
  * Caches exchange rates fetched from an external source.

package/dist/uom.js

@@ -1,11 +1,11 @@
-export { CurrencyAsyncResolver } from './chunk-YU2CUNFO.js';
-export { CurrencyExchangeService, currencyExchangeService, sharedCurrencyExchange } from './chunk-UKPGSAZW.js';
-import './chunk-75JP4BZX.js';
+export { CurrencyAsyncResolver } from './chunk-KV7UW6T6.js';
+export { CurrencyExchangeService, currencyExchangeService, sharedCurrencyExchange } from './chunk-TMA4RCEN.js';
+import './chunk-UQ3UIZJC.js';
 import './chunk-Z4X2RWOF.js';
-import './chunk-BVAR5J2F.js';
-export { canConvert, convertUnit, getBestUnit, getMeasure, isConvertibleUnit, resolveUnit } from './chunk-WC5FFSHB.js';
-import './chunk-PCPX42KL.js';
-import './chunk-6RDSQURE.js';
+import './chunk-GQCOSXMG.js';
+export { canConvert, convertUnit, getBestUnit, getMeasure, isConvertibleUnit, resolveUnit } from './chunk-R3PY4G7J.js';
+import './chunk-V4XG5QF6.js';
+import './chunk-3D7V24DG.js';
 import './chunk-YLJ4XMA6.js';
 //# sourceMappingURL=uom.js.map
 //# sourceMappingURL=uom.js.map

package/dist/utilities.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 var chunk5X2PTP6F_cjs = require('./chunk-5X2PTP6F.cjs');
-var chunkCCJPSHGI_cjs = require('./chunk-CCJPSHGI.cjs');
-var chunkN5YFR4UP_cjs = require('./chunk-N5YFR4UP.cjs');
+var chunkN7FNVFXW_cjs = require('./chunk-N7FNVFXW.cjs');
+var chunkADBA3XBE_cjs = require('./chunk-ADBA3XBE.cjs');
 var chunkVEKIWQ3F_cjs = require('./chunk-VEKIWQ3F.cjs');
 require('./chunk-B7LXJ6LC.cjs');
 
@@ -18,11 +18,15 @@ Object.defineProperty(exports, "djb2Hash", {
 });
 Object.defineProperty(exports, "autoFormatIntegerOrFloat", {
   enumerable: true,
-  get: function () { return chunkCCJPSHGI_cjs.autoFormatIntegerOrFloat; }
+  get: function () { return chunkN7FNVFXW_cjs.autoFormatIntegerOrFloat; }
+});
+Object.defineProperty(exports, "countLines", {
+  enumerable: true,
+  get: function () { return chunkADBA3XBE_cjs.countLines; }
 });
 Object.defineProperty(exports, "stripQuotes", {
   enumerable: true,
-  get: function () { return chunkN5YFR4UP_cjs.stripQuotes; }
+  get: function () { return chunkADBA3XBE_cjs.stripQuotes; }
 });
 Object.defineProperty(exports, "createTimeoutSignal", {
   enumerable: true,

package/dist/utilities.d.cts

@@ -29,10 +29,26 @@ declare function autoFormatIntegerOrFloat(number: number, decimalPlaces?: number
  * Strips a single layer of matching double quotes from a string, if present.
  * Returns the input unchanged if it isn't fully wrapped in quotes.
  *
- * Used for STRING token values, which the lexer emits with their surrounding
- * `"..."` quotes still attached.
+ * Was needed for STRING token values, which the lexer used to emit with their
+ * surrounding `"..."` quotes still attached. `tokenizeString()` now strips them
+ * when it builds the token, so on that path this is a no-op kept as a defence
+ * against text arriving from somewhere else already quoted.
  */
 declare function stripQuotes(value: string): string;
+/**
+ * How many lines `text` has, without splitting it into an array.
+ *
+ * `split("\n").length` answers the same question and allocates the whole
+ * document to do it, which is the wrong shape for a caller whose next move may
+ * be to refuse the document for being too large. Counting stops as soon as the
+ * answer is "more than the caller cares about".
+ *
+ * @param text - The document.
+ * @param stopAfter - Stop counting once past this many lines.
+ * @returns The line count, or `stopAfter + 1` for anything longer. A document
+ * with no newline in it is one line, matching `split`.
+ */
+declare function countLines(text: string, stopAfter?: number): number;
 
 /**
  * Multiplex an optional caller AbortSignal with a hard timeout into a single
@@ -110,4 +126,4 @@ declare const abortLogger: {
     staleDataDiscarded(queryKey: string, context: string): void;
 };
 
-export { abortLogger, autoFormatIntegerOrFloat, createTimeoutSignal, djb2Hash, stripQuotes };
+export { abortLogger, autoFormatIntegerOrFloat, countLines, createTimeoutSignal, djb2Hash, stripQuotes };

package/dist/utilities.d.ts

@@ -29,10 +29,26 @@ declare function autoFormatIntegerOrFloat(number: number, decimalPlaces?: number
  * Strips a single layer of matching double quotes from a string, if present.
  * Returns the input unchanged if it isn't fully wrapped in quotes.
  *
- * Used for STRING token values, which the lexer emits with their surrounding
- * `"..."` quotes still attached.
+ * Was needed for STRING token values, which the lexer used to emit with their
+ * surrounding `"..."` quotes still attached. `tokenizeString()` now strips them
+ * when it builds the token, so on that path this is a no-op kept as a defence
+ * against text arriving from somewhere else already quoted.
  */
 declare function stripQuotes(value: string): string;
+/**
+ * How many lines `text` has, without splitting it into an array.
+ *
+ * `split("\n").length` answers the same question and allocates the whole
+ * document to do it, which is the wrong shape for a caller whose next move may
+ * be to refuse the document for being too large. Counting stops as soon as the
+ * answer is "more than the caller cares about".
+ *
+ * @param text - The document.
+ * @param stopAfter - Stop counting once past this many lines.
+ * @returns The line count, or `stopAfter + 1` for anything longer. A document
+ * with no newline in it is one line, matching `split`.
+ */
+declare function countLines(text: string, stopAfter?: number): number;
 
 /**
  * Multiplex an optional caller AbortSignal with a hard timeout into a single
@@ -110,4 +126,4 @@ declare const abortLogger: {
     staleDataDiscarded(queryKey: string, context: string): void;
 };
 
-export { abortLogger, autoFormatIntegerOrFloat, createTimeoutSignal, djb2Hash, stripQuotes };
+export { abortLogger, autoFormatIntegerOrFloat, countLines, createTimeoutSignal, djb2Hash, stripQuotes };

package/dist/utilities.js

@@ -1,6 +1,6 @@
 export { abortLogger, djb2Hash } from './chunk-IF532O7C.js';
-export { autoFormatIntegerOrFloat } from './chunk-DUEZFTK2.js';
-export { stripQuotes } from './chunk-PFSDGGYL.js';
+export { autoFormatIntegerOrFloat } from './chunk-UKQHXPGW.js';
+export { countLines, stripQuotes } from './chunk-3BOK2LDK.js';
 export { createTimeoutSignal } from './chunk-Z4X2RWOF.js';
 import './chunk-YLJ4XMA6.js';
 //# sourceMappingURL=utilities.js.map