solve-engine 1.0.0-beta.4 → 1.0.0-beta.5

package/dist/packages.d.ts

@@ -102,6 +102,48 @@ declare const FUNCTION_PACKAGE: IEnginePackage;
  */
 declare const DATETIME_PACKAGE: IEnginePackage;
 
+/**
+ * Clock-time-of-day arithmetic: `9:00am`, `16:00`, `4pm` (anchored to
+ * today's calendar date), `7:30 to 20:45` / `4pm to 3am` interval
+ * durations (midnight-rollover aware), `30 fps` frame-rate literals (a
+ * `Rate` value. See `vm/Value.ts`), and `03:04:05` / `00:00:01.5`
+ * lap-time/stopwatch-split durations (two colons, vs clock-time's one).
+ * Distinct from the Datetime package's calendar-date arithmetic. See
+ * `packages/time/` vs `packages/datetime/`.
+ *
+ * Full HH:MM:SS:FF video-timecode literal parsing + fps-aware carry
+ * arithmetic: `01:02:03:04 at 30 fps` / `... @ 30 fps` (a `Uom(totalFrames,
+ * "timecode@<fps>")` value. See `vm/Value.ts`'s timecode section)
+ * `timecode + N frames` / `+ <duration>` / `+ timecode` (sum) / `-
+ * timecode` (difference), all special-cased in `vm/VM.ts`'s ADD/SUB
+ * dispatch (`combineTimecode()`), plus `timecode in frames` and the
+ * reverse `<N> frames @ <fps>` -> `HH:MM:SS:FF` string conversion (see
+ * `parselets/VideoTimecodeParselet.ts`/`FrameCountParselet.ts` and
+ * `timecode/TimecodeMath.ts`). `30 fps × <duration>` frame-count math
+ * (below) composes with this unchanged, the fps literal itself is
+ * unaffected by any of the above. Likewise, pretty-printing a duration
+ * back as `"3 hours 15 min"` (`as timespan`) or `"03:04:05"` (`as
+ * laptime`) is a `converters` package (Phase 1c) concern. This package
+ * only produces the underlying `Uom` values.
+ *
+ * Also: timezone conversion (`6pm Sydney in Chicago`), current
+ * time/date-in-a-zone queries (`time in Paris`, `date in Vancouver`), and
+ * zone-offset deltas (`time difference between Seattle and Moscow`). See
+ * `timezones/CityZones.ts`/`ZoneMath.ts`. Built entirely on native
+ * `Intl.DateTimeFormat`/IANA data, no external dependency. Results are
+ * `String` values (formatted, human-readable), not `Datetime`. This
+ * engine's `Datetime` representation is a bare epoch-ms number with no
+ * zone tag, so there's no way to represent "this instant, but interpreted
+ * through zone X" as anything other than a pre-formatted string; see
+ * `ZoneMath.ts`'s doc comment.
+ *
+ * SCOPE DECISION: the alternate phrasing `<City> time` (e.g. "Tokyo
+ * time", city first) is deliberately NOT implemented, it would need
+ * "time" registered as a keyword reachable from a BARE city identifier's
+ * infix position, and "time" is exactly the kind of common noun this
+ * session found real trouble with (see MathPhrasesPackage.ts's "total"
+ * regression note). `time in <city>` covers the same need unambiguously.
+ */
 declare const TIME_PACKAGE: IEnginePackage;
 
 /** `roll(min, max)`, returns a random integer in the inclusive `[min, max]` range. */

package/dist/packages.js

@@ -1,10 +1,10 @@
-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-FIFQPKBA.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-GVWHCL2N.js';
 import './chunk-6GCKCWLB.js';
 import './chunk-OFXOTECC.js';
 import './chunk-PFSDGGYL.js';
 import './chunk-YU2CUNFO.js';
 import './chunk-NLNDMWZC.js';
-import './chunk-KHJUSHFU.js';
+import './chunk-MVBEL57Q.js';
 import './chunk-GCM5JHMX.js';
 import './chunk-UKPGSAZW.js';
 import './chunk-75JP4BZX.js';

package/dist/vm.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkM4Q47KHF_cjs = require('./chunk-M4Q47KHF.cjs');
+var chunkQDMPOAI7_cjs = require('./chunk-QDMPOAI7.cjs');
 require('./chunk-47LRVGOT.cjs');
-var chunk2NPS5DQ3_cjs = require('./chunk-2NPS5DQ3.cjs');
+var chunkBXKJLM5R_cjs = require('./chunk-BXKJLM5R.cjs');
 require('./chunk-FEAIOR7N.cjs');
 require('./chunk-2MV4HBKC.cjs');
 require('./chunk-MZOVP3WI.cjs');
@@ -193,47 +193,47 @@ var VMCheckpointer = class {
 
 Object.defineProperty(exports, "DependencyGraph", {
   enumerable: true,
-  get: function () { return chunkM4Q47KHF_cjs.DependencyGraph; }
+  get: function () { return chunkQDMPOAI7_cjs.DependencyGraph; }
 });
 Object.defineProperty(exports, "ScopeManager", {
   enumerable: true,
-  get: function () { return chunkM4Q47KHF_cjs.ScopeManager; }
+  get: function () { return chunkQDMPOAI7_cjs.ScopeManager; }
 });
 Object.defineProperty(exports, "createVM", {
   enumerable: true,
-  get: function () { return chunkM4Q47KHF_cjs.createVM; }
+  get: function () { return chunkQDMPOAI7_cjs.createVM; }
 });
 Object.defineProperty(exports, "executeBytecode", {
   enumerable: true,
-  get: function () { return chunkM4Q47KHF_cjs.executeBytecode; }
+  get: function () { return chunkQDMPOAI7_cjs.executeBytecode; }
 });
 Object.defineProperty(exports, "OpRegistry", {
   enumerable: true,
-  get: function () { return chunk2NPS5DQ3_cjs.OpRegistry; }
+  get: function () { return chunkBXKJLM5R_cjs.OpRegistry; }
 });
 Object.defineProperty(exports, "allocatePluginFunctionIndex", {
   enumerable: true,
-  get: function () { return chunk2NPS5DQ3_cjs.allocatePluginFunctionIndex; }
+  get: function () { return chunkBXKJLM5R_cjs.allocatePluginFunctionIndex; }
 });
 Object.defineProperty(exports, "binaryOp", {
   enumerable: true,
-  get: function () { return chunk2NPS5DQ3_cjs.binaryOp; }
+  get: function () { return chunkBXKJLM5R_cjs.binaryOp; }
 });
 Object.defineProperty(exports, "builtinFunctions", {
   enumerable: true,
-  get: function () { return chunk2NPS5DQ3_cjs.builtinFunctions; }
+  get: function () { return chunkBXKJLM5R_cjs.builtinFunctions; }
 });
 Object.defineProperty(exports, "pluginFunctionRegistry", {
   enumerable: true,
-  get: function () { return chunk2NPS5DQ3_cjs.pluginFunctionRegistry; }
+  get: function () { return chunkBXKJLM5R_cjs.pluginFunctionRegistry; }
 });
 Object.defineProperty(exports, "sharedOpRegistry", {
   enumerable: true,
-  get: function () { return chunk2NPS5DQ3_cjs.sharedOpRegistry; }
+  get: function () { return chunkBXKJLM5R_cjs.sharedOpRegistry; }
 });
 Object.defineProperty(exports, "unifyUom", {
   enumerable: true,
-  get: function () { return chunk2NPS5DQ3_cjs.unifyUom; }
+  get: function () { return chunkBXKJLM5R_cjs.unifyUom; }
 });
 Object.defineProperty(exports, "Value", {
   enumerable: true,

package/dist/vm.js

@@ -1,6 +1,6 @@
-export { DependencyGraph, ScopeManager, createVM, executeBytecode } from './chunk-3MNKQZ77.js';
+export { DependencyGraph, ScopeManager, createVM, executeBytecode } from './chunk-BAMZT3GL.js';
 import './chunk-G535KJEG.js';
-export { OpRegistry, allocatePluginFunctionIndex, binaryOp, builtinFunctions, pluginFunctionRegistry, sharedOpRegistry, unifyUom } from './chunk-KHJUSHFU.js';
+export { OpRegistry, allocatePluginFunctionIndex, binaryOp, builtinFunctions, pluginFunctionRegistry, sharedOpRegistry, unifyUom } from './chunk-MVBEL57Q.js';
 import './chunk-GCM5JHMX.js';
 import './chunk-UKPGSAZW.js';
 import './chunk-75JP4BZX.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solve-engine",
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0-beta.5",
   "description": "The expression evaluation engine behind Solve — lexer, parser, bytecode VM, and an extensible package system.",
   "keywords": [
     "expression-evaluator",