Architecture#

As-Is#

These are how we think everything works in the current main branch.

Front End#

---------------------------------------------------------------------------
AttributeError                            Traceback (most recent call last)
Cell In[2], line 1
----> 1 get_ipython().run_line_magic('dot', 'dot/as-is/frontend.dot')

File ~/checkouts/readthedocs.org/user_builds/jupyterlab-lsp/conda/stable/lib/python3.12/site-packages/IPython/core/interactiveshell.py:2480, in InteractiveShell.run_line_magic(self, magic_name, line, _stack_depth)
   2478     kwargs['local_ns'] = self.get_local_scope(stack_depth)
   2479 with self.builtin_trap:
-> 2480     result = fn(*args, **kwargs)
   2482 # The code below prevents the output from being displayed
   2483 # when using magics with decorator @output_can_be_silenced
   2484 # when the last Python token in the expression is a ';'.
   2485 if getattr(fn, magic.MAGIC_OUTPUT_CAN_BE_SILENCED, False):

Cell In[1], line 10, in dot(line, cell)
      8 @IPython.core.magic.register_line_cell_magic
      9 def dot(line, cell=None):
---> 10     src = graphviz.Source(pathlib.Path(line).read_text() if line else cell)._repr_svg_()
     11     src = re.sub(r"<svg (.*)viewBox", "<svg viewBox", src, flags=re.M | re.DOTALL)
     12     return IPython.display.SVG(data=src)

AttributeError: 'Source' object has no attribute '_repr_svg_'

Positioning system#

positioning system

Back End#

Proposals#

Some fragments of how the architecture could change in the future, and why (or why not) they might be a good idea.

  • Reorganize client source with lerna and typescript projects #76

  • Add DiagnosticsManager, refactor DiagnosticPanel #176

  • Multiple sources of LSP messages on frontend and backend #184

  • Formalize and extend language transclusion #191