[Feature Request] Top level entry points for js/py might need native code

[kMutagene]

Currently using ARCtrl in pythomn for the first time at BioHackEU24, first off it works great!

However, the API has same weird inconsistencies that i guess come from the general transpilation process. Example:

• This is fine:

  from arctrl.arc import ARC
  ARC.from_rocrate_json_string(...)

• This is weird:

  from arctrl.json import JsonController # <-- weird namespace
  JsonController.Investigation().from_rocrate_json_string # <-- class instantiation necessary
  ```

I'd suggest to write top-level entry points that are designed for transpiled languages only (as i suspect is the case for the JsonController module) in the native language. It is completely fine to have diverging APIs for convenience IMO, however i can see the additional maintenance overhead.

cc @HLWeil @feserm

[HLWeil]

I think it's doable, especially as this is only about 10-30 single line functions?

Would be great to have someone with knowledge about actual python libraries do it though 😉

[Freymaurer]

Adding to this, we should add json access points for all types. currently adding person json parsing in js and i have to look up the place in the node modules

[Freymaurer]

To make this issue more pressing @HLWeil :

I am pretty sure this will break on every single ARCtrl update as it contains a hash

[HLWeil]

True that..

Maybe there's another way to fixate the name for these functions? Otherwise this will be a lot of functions to explicitly maintain across the three languages.

[Freymaurer]

https://fable.io/repl/#?code=PYBwpgdgBAYghgIwDZgHQGFgCcwFgBQoksiKG2aAUgM4CSEALmFqAQQLbAAmArilABUAnuGpQAvG3xQZUBiLBQAgtWpwhmRiyQosEqAVlGoAb0PGLA4DWAQAXFGoMsASwgBzKAFoAfFB4QLgzmFkZWAEoA8uhYcEw29o7Obp6+-oHB0qFhwLQAykoJDk6uHt5+AUEhxgC+Ukby4FAJms7AOswS1UZmWdkyKmpCDoPqrdq63bJ1+ARE0MKiUigMzdS24+26+tW92aNC+nv9MlYJ+gBmAY7lUCClDBfQAEQAEmA6wFAApNTPjlNLMAojE4mBzuIoFdoGI0vc3I8XgB1bBILg-P4Avr9Kz5QrraCQ6E3OEPJ5QZ6UYAAC2gv3+1EBUBmRhmBBatjaHSwqAOqDOBIpKKwaOeQA&html=Q&css=Q

[kMutagene]

https://fable.io/repl/#?code=PYBwpgdgBAYghgIwDZgHQGFgCcwFgBQoksiKG2aAUgM4CSEALmFqAQQLbAAmArilABUAnuGpQAvG3xQZUBiLBQAgtWpwhmRiyQosEqAVlGoAb0PGLA4DWAQAXFGoMsASwgBzKAFoAfFB4QLgzmFkZWAEoA8uhYcEw29o7Obp6+-oHB0qFhwLQAykoJDk6uHt5+AUEhxgC+Ukby4FAJms7AOswS1UZmWdkyKmpCDoPqrdq63bJ1+ARE0MKiUigMzdS24+26+tW92aNC+nv9MlYJ+gBmAY7lUCClDBfQAEQAEmA6wFAApNTPjlNLMAojE4mBzuIoFdoGI0vc3I8XgB1bBILg-P4Avr9Kz5QrraCQ6E3OEPJ5QZ6UYAAC2gv3+1EBUBmRhmBBatjaHSwqAOqDOBIpKKwaOeQA&html=Q&css=Q

Looks to me like this has the issues of the object not having any discoverable members right? So no 'dotting into' or discovering API via exports