feat(sdk): allow custom factors via parseBoxToScreenCoords api

[ulivz]

Summary

While SDK support custom factors in the input stage via custom Model:

import { ChatCompletionMessageParam } from 'openai/resources/chat/completions';
import { UITarsModel } from '@ui-tars/sdk/core';

export class MyCustomModel extends UITarsModel {
  private readonly openai: AzureOpenAI;

  override get factors(): [number, number] {
    return [1366, 768];
  }

  // ...
}

The action processing stage(Operator) should also support custom

import { Operator, parseBoxToScreenCoords } from '@ui-tars/sdk/core';

export class MyCustomOperator extends Operator {
  public async execute(params: ExecuteParams): Promise<ExecuteOutput> {
    const coords = parseBoxToScreenCoords({
       boxStr: startBoxStr,
 <screenWidth>,  <screenHeight>,  [1366, 768]
   });
  }
}

This pull request# Summary

While SDK support custom factors in the input stage via custom Model:

import { ChatCompletionMessageParam } from 'openai/resources/chat/completions';
import { UITarsModel } from '@ui-tars/sdk/core';

export class MyCustomModel extends UITarsModel {
  private readonly openai: AzureOpenAI;

  override get factors(): [number, number] {
    return [1366, 768];
  }

  // ...
}

The action processing stage(Operator) should also support custom

import { Operator, parseBoxToScreenCoords } from '@ui-tars/sdk/core';

export class MyCustomOperator extends Operator {
  public async execute(params: ExecuteParams): Promise<ExecuteOutput> {
    const coords = parseBoxToScreenCoords({
       boxStr: params.startBoxStr,
       screenWidth: <screenWidth>, 
       screenHeight: <screenHeight>,  
       factors: [1366, 768]
   });
  }
}

This pull request also refactor the factors related code.

[ycjcl868]

There may be factors scattered in various places, I suggest passing factors into execute

Because the operator should not concern itself with factors

[codecov]

Codecov Report

Attention: Patch coverage is 91.66667% with 1 line in your changes missing coverage. Please review.

Project coverage is 24.93%. Comparing base (2845023) to head (bfe1b19).
Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/main/shared/setOfMarks.ts	50.00%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #162      +/-   ##
==========================================
+ Coverage   24.75%   24.93%   +0.18%     
==========================================
  Files          69       67       -2     
  Lines        1515     1516       +1     
  Branches      237      238       +1     
==========================================
+ Hits          375      378       +3     
+ Misses       1096     1094       -2     
  Partials       44       44              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.