@ball-lang/engine 1.3.5 → 1.3.7

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ball-lang/engine",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "description": "Ball language engine — interprets Ball programs in TypeScript/JavaScript. Runs in Node.js and browsers.",
   "type": "module",
   "main": "dist/index.js",

package/src/compiled_engine.ts

@@ -677,17 +677,9 @@ function __ball_cascade(target: any, ops: any[]): any {
   Object.defineProperty(sp, 'isNotEmpty', {
     configurable: true, get() { return this.length !== 0; },
   });
-  // Make undefined/null safe for .isEmpty/.isNotEmpty via a global wrapper.
-  // Proto3 JSON omits empty strings, so code like call.module.isEmpty needs
-  // to handle undefined gracefully.
-  const _origObjDefProp = Object.defineProperty;
-  for (const boolProp of ['isEmpty', 'isNotEmpty']) {
-    if (!(undefined as any)?.[boolProp]) {
-      // Can't add properties to undefined/null, but we handle it in the
-      // generated code via ?.isEmpty fallback patterns. The preamble's
-      // protoWrap handles most cases.
-    }
-  }
+  // Note: undefined/null safety for .isEmpty/.isNotEmpty is handled in the
+  // generated code via optional-chaining (?.isEmpty) patterns and protoWrap;
+  // properties cannot be installed on undefined/null directly.
   // Dart String methods not on JS String.
   if (!sp.contains) sp.contains = function (s: any) { return this.includes(s); };
   if (!sp.replaceFirst) sp.replaceFirst = function (from: any, to: any) {
@@ -893,7 +885,6 @@ function __ball_cascade(target: any, ops: any[]): any {
     return Object.keys(this).filter((k: string) => !k.startsWith('__')).length;
   });
 
-  // Number polyfills moved earlier (see "Dart Number polyfills" block above).
   // runtimeType — Dart's Object.runtimeType. Returns the Dart-style
   // type name for any JS value. Used by the compiled engine for type
   // checking and error messages.
@@ -1894,6 +1885,10 @@ export class BallEngine {
               } else {
                 if ((('arg' + __ball_to_string(i)) in inputMap)) {
                   scope.bind(p, __ball_index(inputMap, ('arg' + __ball_to_string(i))));
+                } else {
+                  if ((((__ball_eq(i, 0) && __ball_eq(params.length, 1)) && ('value' in inputMap)) && this._isSetter(func))) {
+                    scope.bind(p, __ball_index(inputMap, 'value'));
+                  }
                 }
               }
             }

package/src/engine_setup.ts

@@ -627,9 +627,23 @@ export function createEngineSetup(mod: EngineModule) {
   // for functions that the compiled engine's _buildStdDispatch doesn't cover
   // (collection higher-order functions, string helpers, etc.).
   
-  function registerExtraStdFunctions(stdHandler: StdHandler): void {
+  /**
+   * Register the hand-written std-function overrides on `stdHandler`.
+   *
+   * `engine` is the compiled BallEngine instance the handler is wired to.
+   * It is REQUIRED for handlers that allocate proportionally to their input
+   * (list_filled / list_generate): they charge the allocation against the
+   * engine's memory accounting so `maxMemoryBytes` is enforced (#24). The
+   * compiled engine's handler-call protocol passes a bound `callFunction`
+   * (not the engine) as the third argument, so the engine must be captured
+   * here at registration time.
+   */
+  function registerExtraStdFunctions(stdHandler: StdHandler, engine: any): void {
     const _r = stdHandler.register.bind(stdHandler);
     const _m = (i: any) => (typeof i === 'object' && i !== null) ? i : {};
+    // Mirrors the compiled engine's `_ballPointerBytes` accounting constant.
+    const _ptrBytes = 8;
+    const _track = (bytes: number) => engine._trackMemoryAllocation(bytes);
   
     // ── Collection: list_* ─────────────────────────────────────────────
     _r('list_foreach', async (i: any) => {
@@ -1054,12 +1068,17 @@ export function createEngineSetup(mod: EngineModule) {
       return val;
     });
   
-    // Override dart_list_generate (compiled version's lambda calling may fail)
+    // Override dart_list_generate (compiled version's lambda calling may fail).
+    // These overrides shadow the compiled `_stdListFilled`/`_stdListGenerate`
+    // implementations, which already track allocations — so they must charge
+    // the allocation against the engine's memory accounting themselves
+    // (maxMemoryBytes, #24).
     _r('dart_list_generate', async (i: any) => {
       const m = _m(i);
       const count = Number(m['count'] ?? m['arg0'] ?? 0);
       const gen = m['generator'] ?? m['arg1'];
       if (typeof gen !== 'function') return [];
+      _track(Math.max(0, count | 0) * _ptrBytes);
       const result: any[] = [];
       for (let idx = 0; idx < count; idx++) {
         let v = gen(idx);
@@ -1071,11 +1090,13 @@ export function createEngineSetup(mod: EngineModule) {
     _r('dart_list_filled', (i: any) => {
       const m = _m(i);
       const count = Number(m['count'] ?? m['length'] ?? m['arg0'] ?? 0);
+      _track(Math.max(0, count | 0) * _ptrBytes);
       return Array(Math.max(0, count | 0)).fill(m['value'] ?? m['arg1'] ?? null);
     });
     _r('list_filled', (i: any) => {
       const m = _m(i);
       const count = Number(m['count'] ?? m['length'] ?? m['arg0'] ?? 0);
+      _track(Math.max(0, count | 0) * _ptrBytes);
       return Array(Math.max(0, count | 0)).fill(m['value'] ?? m['arg1'] ?? null);
     });
     _r('list_generate', (i: any) => {
@@ -1083,6 +1104,7 @@ export function createEngineSetup(mod: EngineModule) {
       const count = Number(m['count'] ?? m['length'] ?? m['arg0'] ?? 0);
       const fn = m['function'] ?? m['generator'] ?? m['callback'] ?? m['value'];
       if (typeof fn !== 'function') return [];
+      _track(Math.max(0, count | 0) * _ptrBytes);
       const out: any[] = [];
       for (let i2 = 0; i2 < count; i2++) {
         let r = fn(i2);

package/src/index.ts

@@ -63,7 +63,22 @@ export class BallEngine {
     // the `@type` envelope (if present) before normalizing; callers passing an
     // already-unwrapped Program object are still supported.
     const parsed = typeof program === 'string' ? JSON.parse(program) : program;
-    const normalized = protoWrap(unwrapBallFile(parsed));
+    const unwrapped = unwrapBallFile(parsed);
+    const normalized = protoWrap(unwrapped);
+
+    // The compiled engine's program-size validation (run() →
+    // _validateProgramLimits) calls `program.writeToBuffer()` — the Dart
+    // protobuf binary encoding. Plain-JSON programs have no protobuf runtime
+    // here, so expose the UTF-8 JSON encoding of the (unwrapped) input as the
+    // byte-size source. Non-enumerable so program traversal never sees it.
+    if (typeof normalized === 'object' && normalized !== null) {
+      Object.defineProperty(normalized, 'writeToBuffer', {
+        value: () => new TextEncoder().encode(JSON.stringify(unwrapped)),
+        enumerable: false,
+        writable: true,
+        configurable: true,
+      });
+    }
 
     const stdHandler = new StdModuleHandler();
     const methodHandler = new MethodDispatchHandler();
@@ -108,7 +123,7 @@ export class BallEngine {
       patchScopeBindings(this._compiledEngine._globalScope);
     }
 
-    registerExtraStdFunctions(stdHandler);
+    registerExtraStdFunctions(stdHandler, this._compiledEngine);
     seedGlobalScope(this._compiledEngine);
     patchCompiledEngine(this._compiledEngine);