From bfee0bdf9b6a59603ad716355bcbd571d5b694c9 Mon Sep 17 00:00:00 2001
From: Roland Conybeare <rconybeare@gmail.com>
Date: Sat, 15 Nov 2025 18:18:22 -0500
Subject: [PATCH] xo-interpreter: initial commit [wip]

---
 xo-interpreter/CMakeLists.txt                 |  42 ++++
 xo-interpreter/docs/README                    |  41 ++++
 xo-interpreter/docs/_static/README            |   1 +
 xo-interpreter/docs/_static/img/favicon.ico   | Bin 0 -> 309936 bytes
 xo-interpreter/docs/index.rst                 |  12 ++
 xo-interpreter/docs/install.rst               | 202 ++++++++++++++++++
 .../include/xo/interpreter/StackFrame.hpp     |  24 +++
 .../interpreter/VirtualSchematikaMachine.hpp  |  11 +-
 .../interpreter/{VmInstr.hpp => VsmInstr.hpp} |  10 +-
 .../interpreter/VirtualSchematikaMachine.cpp  |  12 ++
 10 files changed, 349 insertions(+), 6 deletions(-)
 create mode 100644 xo-interpreter/CMakeLists.txt
 create mode 100644 xo-interpreter/docs/README
 create mode 100644 xo-interpreter/docs/_static/README
 create mode 100644 xo-interpreter/docs/_static/img/favicon.ico
 create mode 100644 xo-interpreter/docs/index.rst
 create mode 100644 xo-interpreter/docs/install.rst
 create mode 100644 xo-interpreter/include/xo/interpreter/StackFrame.hpp
 rename xo-interpreter/include/xo/interpreter/{VmInstr.hpp => VsmInstr.hpp} (79%)
 create mode 100644 xo-interpreter/src/interpreter/VirtualSchematikaMachine.cpp

diff --git a/xo-interpreter/CMakeLists.txt b/xo-interpreter/CMakeLists.txt
new file mode 100644
index 00000000..132e7b86
--- /dev/null
+++ b/xo-interpreter/CMakeLists.txt
@@ -0,0 +1,42 @@
+# xo-interpreter/CMakeLists.txt
+
+cmake_minimum_required(VERSION 3.10)
+
+project (xo_interpreter VERSION 0.1)
+
+include(GNUInstallDirs)
+include(cmake/xo-bootstrap-macros.cmake)
+
+xo_cxx_toplevel_options3()
+
+# ----------------------------------------------------------------
+# c++ settings
+
+set(PROJECT_CXX_FLAGS "")
+#set(PROJECT_CXX_FLAGS "-fconcepts-diagnostics-depth=2")  # gcc-only!
+add_definitions(${PROJECT_CXX_FLAGS})
+
+# ----------------------------------------------------------------
+
+# note on ordering: must read .cmake defn of lib before configuring any examples
+add_subdirectory(src/interpreter)
+
+xo_export_cmake_config(${PROJECT_NAME} ${PROJECT_VERSION} ${PROJECT_NAME}Targets)
+
+# ----------------------------------------------------------------
+
+#add_subdirectory(example)
+#add_subdirectory(utest)
+
+# ----------------------------------------------------------------
+
+#if (XO_ENABLE_EXAMPLES)
+#    install(TARGETS xo_interpreter_ex1 DESTINATION bin/xo/example)
+#endif()
+
+# ----------------------------------------------------------------
+# docs targets depend on all other library/utest targets
+#
+#add_subdirectory(docs)
+
+# end CMakeLists.txt
diff --git a/xo-interpreter/docs/README b/xo-interpreter/docs/README
new file mode 100644
index 00000000..6aff5d41
--- /dev/null
+++ b/xo-interpreter/docs/README
@@ -0,0 +1,41 @@
+standalone build
+
+        +-----------------------------------------------+
+        | cmake                                         |
+        |   CMakeLists.txt                              |
+        |   $PREFIX/share/cmake/xo_macros/xo_cxx.cmake  |
+        +-----------------------------------------------+
+           |
+           |                                                  +----------------------+
+           +------------------------------------------------->| .build/docs/Doxyfile |
+           |                                                  +----------------------+
+           |                                                     ^
+           |                                 (cmake)             |
+           |                                        /------------/
+           |                                        |
+           |     +---------------------------------------+          +-----------------+
+           +---->| doxygen                               |--------->| .build/docs/dox |
+           |     |   $PREFIX/share/xo-macros/Doxyfile.in | (doxygen)|   +- html/      |
+           |     +---------------------------------------+          |   +- xml/       |
+           |                                                        +-----------------+
+           |                                                             |
+           |                                                             |(sphinx)
+           |                                                             |
+           |                                                             v
+           |     +---------------------------------------+        +--------------------+
+           \---->| sphinx                                |------->| .build/docs/sphinx |
+                 |   +- conf.py                          |        |   +- html/         |
+                 |   +- _static/                         |        +--------------------+
+                 |   +- *.rst                            |
+                 +---------------------------------------+
+
+umbrella build relies on top-level cmake macros
+
+files
+
+   README            this file
+   CMakeLists.txt    build entry point
+   conf.py           sphinx config
+   _static           static files for sphinx
+
+   index.rst         toplevel sphinx document; entry point
diff --git a/xo-interpreter/docs/_static/README b/xo-interpreter/docs/_static/README
new file mode 100644
index 00000000..8230095c
--- /dev/null
+++ b/xo-interpreter/docs/_static/README
@@ -0,0 +1 @@
+add any static {.html, .js, ..} files for sphinx to pickup here
\ No newline at end of file
diff --git a/xo-interpreter/docs/_static/img/favicon.ico b/xo-interpreter/docs/_static/img/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..4163dd69c734f8186cf1ce5e726213cebd231c31
GIT binary patch
literal 309936
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

literal 0
HcmV?d00001

diff --git a/xo-interpreter/docs/index.rst b/xo-interpreter/docs/index.rst
new file mode 100644
index 00000000..e5b5a1c2
--- /dev/null
+++ b/xo-interpreter/docs/index.rst
@@ -0,0 +1,12 @@
+.. xo-interpreter documentation master file.
+
+xo-interpreter documentation
+============================
+
+xo-interpreter provides an interpreter for the Schematika language
+
+.. toctree::
+   :maxdepth: 2
+   :caption: xo-interpreter contents
+
+   install
diff --git a/xo-interpreter/docs/install.rst b/xo-interpreter/docs/install.rst
new file mode 100644
index 00000000..827bb1b0
--- /dev/null
+++ b/xo-interpreter/docs/install.rst
@@ -0,0 +1,202 @@
+.. _install:
+
+.. toctree:
+   :maxdepth: 2
+
+Source
+======
+
+Source code lives on github `here`_
+
+.. _here: https://github.com/rconybea/xo-interpreter
+
+To clone from git:
+
+.. code-block:: bash
+
+    git clone https://github.com/rconybea/xo-interpreter
+
+Tested with gcc 14.2
+
+Install
+=======
+
+One-step Install
+----------------
+
+Install xo-interpreter along with the rest of *XO* from `xo-umbrella2 source`_:
+see install instructions for xo-umbrella2.
+
+.. _xo-umbrella2 source: https://github.com/rconybea/xo-umbrella2
+
+Essential Xo Dependencies
+-------------------------
+
+``xo-interpreter`` uses several supporting libraries from elsewhere in the *XO* project:
+
+- `xo-reader source`_ (Schematika expression parser)
+- `xo-expression source`_ (Schematika AST representation)
+- `xo-tokenizer source`_ (Schematika lexer)
+- `xo-object source`_ (gc-eligible runtime polymorphism)
+- `xo-randomgen source`_ (fast pseudo-random number generators)
+- `xo-alloc source`_ (arena allocators, garbage collector)
+- `xo-unit source`_ (dimension checking library)
+- `xo-ratio source`_ (exact ratio library)
+- `xo-flatstring source`_ (no-allocation string library)
+- `xo-callback source`_ (callback library)
+- `xo-reflectutil source`_ (reflection utils for participating libs)
+- `xo-reflect source`_ (reflection library)
+- `xo-refcnt source`_ (reference-counting library)
+- `xo-subsys source`_ (utility library)
+- `xo-indentlog source`_ (structured logging, pretty-printing)
+- `xo-cmake source`_ (shared cmake macros)
+
+.. _xo-reader source: https://github.com/rconybea/xo-reader
+.. _xo-expression source: https://github.com/rconybea/xo-expression
+.. _xo-tokenizer source: https://github.com/rconybea/xo-tokenizer
+.. _xo-object source: https://github.com/rconybea/xo-object
+.. _xo-randomgen source: https://github.com/rconybea/xo-randomgen
+.. _xo-alloc source: https://github.com/rconybea/xo-alloc
+.. _xo-unit source: https://github.com/rconybea/xo-unit
+.. _xo-ratio source: https://github.com/rconybea/xo-ratio
+.. _xo-flatstring source: https://github.comr/rconybea/xo-flatstring
+.. _xo-callback source: https://github.com/rconybea/xo-callback
+.. _xo-reflect source: https://github.com/rconybea/xo-reflect
+.. _xo-refcnt source: https://github.com/rconybea/refcnt
+.. _xo-subsys source: https://github.com/rconybea/subsys
+.. _xo-indentlog source: https://github.com/rconybea/indentlog
+.. _xo-cmake source: https://github.com/rconybea/xo-cmake
+
+Building from source
+--------------------
+
+Instructions for building xo-interpreter from source, along with only its essential dependencies.
+
+Install scripts for XO libraries depend on helper scripts installed from `xo-cmake`.
+
+Preamble:
+
+.. code-block:: bash
+
+    mkdir -p ~/proj/xo
+    cd ~/proj/xo
+
+    git clone https://github.com/rconybea/xo-cmake
+
+    PREFIX=$HOME/local  # or desired installation path
+
+    # will want PREFIX/bin in PATH to use xo-cmake helpers
+    PATH=$PREFIX/bin:$PATH
+
+Isntall `xo-cmake`:
+
+.. code-block:: bash
+
+    cmake -B xo-cmake/.build -S xo-cmake
+    cmake --install xo-cmake/.build
+
+Now that we have xo-build in PATH, can build+install XO components in topological order:
+
+.. code-block:: bash
+
+    xo-build --clone --configure --build --install xo-indentlog
+    xo-build --clone --configure --build --install xo-subsys
+    xo-build --clone --configure --build --install xo-refcnt
+    xo-build --clone --configure --build --install xo-reflect
+    xo-build --clone --configure --build --install xo-reflectutil
+    xo-build --clone --configure --build --install xo-callback
+    xo-build --clone --configure --build --install xo-flatstring
+    xo-build --clone --configure --build --install xo-ratio
+    xo-build --clone --configure --build --install xo-unit
+    xo-build --clone --configure --build --install xo-alloc
+    xo-build --clone --configure --build --install xo-randomgen
+    xo-build --clone --configure --build --install xo-object
+    xo-build --clone --configure --build --install xo-tokenizer
+    xo-build --clone --configure --build --install xo-expression
+    xo-build --clone --configure --build --install xo-reader
+
+Directories under ``PREFIX`` will then contain something like:
+
+.. code-block::
+
+    PREFIX
+    += bin
+    |  +- xo-build
+    │  +- xo-cmake-config
+    │  \- xo-cmake-lcov-harness
+    +─ include
+    |  \- xo
+    │     +- alloc/
+    |     +- callback/
+    |     +- cxxutil/
+    |     +- expression/
+    |     |  +- typeinf/
+    |     |  ..
+    |     +- flatstring/
+    |     +- indentlog/
+    |     |  +- machdep/
+    |     |  +- print/
+    |     |  +- timeutil/
+    |     |  ..
+    |     +- object/
+    |     +- randomgen/
+    |     +- ratio/
+    |     +- reader/
+    |     +- refcnt/
+    |     +- reflect/
+    |     |  +- atomic/
+    |     |  +- function/
+    |     |  +- pointer/
+    |     |  +- struct/
+    |     |  +- vector/
+    |     |  ..
+    |     +- reflectutil/
+    |     +- subsys/
+    |     +- tokenizer/
+    |     \- unit/
+    +- lib
+    |  +- cmake
+    |  |  +- callback/
+    |  |  +- indentlog/
+    |  |  +- randomgen/
+    |  |  +- refcnt/
+    |  |  +- reflect/
+    |  |  +- subsys/
+    |  |  +- xo_alloc/
+    |  |  +- xo_expression/
+    |  |  +- xo_flatstring/
+    |  |  +- xo_object/
+    |  |  +- xo_ratio/
+    |  |  +- xo_reader/
+    |  |  +- xo_reflectutil/
+    |  |  +- xo_tokenizer/
+    |  |  \- xo_unit/
+    |  +- librefcnt.so
+    |  ..
+    \- share
+       +- cmake
+       |  \- xo-macros
+       |     +- code-coverage.cmake
+       |     +- xo_cxx.cmake
+       |     \- xo-project-macros.cmake
+       +- etc
+       |  \- xo
+       |     \- subsystem_list
+       +- xo-macros
+          +- Doxyfile.in
+          +- gen-ccov.in
+          \- xo-bootstrap-macros.cmake
+
+CMake Support
+-------------
+
+To use built-in cmake support, when using ``xo-interpreter`` from another project:
+
+Make sure ``PREFIX/lib/cmake`` is searched by cmake (for example include it in ``CMAKE_PREFIX_PATH``)
+
+Add to your ``CMakeLists.txt``:
+
+.. code-block:: cmake
+
+    FindPackage(xo_interpreter CONFIG REQUIRED)
+    target_link_libraries(mytarget PUBLIC xo_interpreter)
diff --git a/xo-interpreter/include/xo/interpreter/StackFrame.hpp b/xo-interpreter/include/xo/interpreter/StackFrame.hpp
new file mode 100644
index 00000000..c18f6bae
--- /dev/null
+++ b/xo-interpreter/include/xo/interpreter/StackFrame.hpp
@@ -0,0 +1,24 @@
+/** @file StackFrame.hpp **/
+
+#include "xo/alloc/Object.hpp"
+
+namespace xo {
+    namespace scm {
+        /** @class StackFrame
+         *  @brief Represent a single runtime stack frame for a Schematika function
+         *
+         *  StackFrame intended to be used for interpreted functions.
+         *  Compiled functions will stil likely have stack frames, but need not use the
+         *  @ref StackFrame class
+         **/
+        class StackFrame : public Object {
+        public:
+            StackFrame(std::size_t n_slot)
+
+        private:
+
+        };
+    } /*namespace scm*/
+} /*namespace xo*/
+
+/* end StackFrame.hpp */
diff --git a/xo-interpreter/include/xo/interpreter/VirtualSchematikaMachine.hpp b/xo-interpreter/include/xo/interpreter/VirtualSchematikaMachine.hpp
index eca9368c..edcd9706 100644
--- a/xo-interpreter/include/xo/interpreter/VirtualSchematikaMachine.hpp
+++ b/xo-interpreter/include/xo/interpreter/VirtualSchematikaMachine.hpp
@@ -2,17 +2,26 @@
 
 #pragma once
 
-#include "VmInstr.hpp"
+#include "VsmInstr.hpp"
 
 namespace xo {
     namespace scm {
         /** @class VirtualSchematikaMachine
          *  @brief Virtual machine implementing a Schematika interpreter
+         *
          **/
         class VirtualSchematikaMachine {
         public:
+            VirtualSchematikaMachine();
+
+
         private:
+            /** program counter **/
+            const VsmInstr * pc_ = nullptr;
+
+
         };
+
     } /*namespace scm*/
 } /*namespace xo*/
 
diff --git a/xo-interpreter/include/xo/interpreter/VmInstr.hpp b/xo-interpreter/include/xo/interpreter/VsmInstr.hpp
similarity index 79%
rename from xo-interpreter/include/xo/interpreter/VmInstr.hpp
rename to xo-interpreter/include/xo/interpreter/VsmInstr.hpp
index 7502a3ac..8f4e1e97 100644
--- a/xo-interpreter/include/xo/interpreter/VmInstr.hpp
+++ b/xo-interpreter/include/xo/interpreter/VsmInstr.hpp
@@ -1,8 +1,8 @@
-/** @file VmInstr.hpp **/
+/** @file VsmInstr.hpp **/
 
 #pragma once
 
-#include <string>
+#include <string_view>
 
 namespace xo {
     namespace scm {
@@ -13,16 +13,16 @@ namespace xo {
          *
          *  A vsm instruction acts on a virtual schematika machine instance.
          **/
-        class VmInstr
+        class VsmInstr
         {
         public:
             using ActionFn = void (*)(VirtualSchematikaMachine * vm);
 
         private:
-            std::string name_;
+            std::string_view name_;
             ActionFn action_;
         };
     }
 }
 
-/* end VmInstr.hpp */
+/* end VsmInstr.hpp */
diff --git a/xo-interpreter/src/interpreter/VirtualSchematikaMachine.cpp b/xo-interpreter/src/interpreter/VirtualSchematikaMachine.cpp
new file mode 100644
index 00000000..d46b6433
--- /dev/null
+++ b/xo-interpreter/src/interpreter/VirtualSchematikaMachine.cpp
@@ -0,0 +1,12 @@
+/** @file VirtualSchematikaMachine.cpp **/
+
+#include "VirtualSchematikaMachine.hpp"
+
+#include "VsmInstr.hpp"
+
+namespace xo {
+    namespace scm {
+    } /*namespace scm*/
+} /*namespace xo*/
+
+/* end VirtualSchematikaMachine.hpp */