luvatrix 0.1.0__py3-none-any.whl

luvatrix-0.1.0.dist-info/METADATA

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: luvatrix
+Version: 0.1.0
+Summary: Luvatrix runtime and plotting toolkit
+Requires-Python: <3.15,>=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: numpy>=2.4.2
+Requires-Dist: torch>=2.4.0
+Provides-Extra: plot
+Provides-Extra: macos
+Requires-Dist: pyobjc-core>=12.1; extra == "macos"
+Requires-Dist: pyobjc-framework-cocoa>=12.1; extra == "macos"
+Requires-Dist: pyobjc-framework-quartz>=12.1; extra == "macos"
+Provides-Extra: vulkan
+Requires-Dist: vulkan>=1.3.275.1; extra == "vulkan"
+Provides-Extra: dev
+Requires-Dist: matplotlib>=3.10.8; extra == "dev"
+
+# Luvatrix
+
+Custom app protocol + custom rendering protocol runtime in Python.
+
+## Current Focus
+
+Phase 1 is a macOS-first OS-level renderer:
+- Window Matrix protocol (`H x W x 4` RGBA255, PyTorch)
+- Vulkan presentation loop (`init -> loop -> stop`)
+- HDI thread + Sensor manager thread
+- In-process app protocol (`app.toml` + Python entrypoint)
+
+## Planning Document
+
+See `planning.md` for the integrated Phase 1 spec and visual TLDR protocol models.
+
+## Repository Layout
+
+- Core engine/runtime source lives in `luvatrix_core/`.
+- In-repo UI contracts/components live in `luvatrix_ui/` (`text/`, `controls/`, `style/`).
+
+## `luvatrix_ui` (In-Repo, v0)
+
+`luvatrix_ui` is a first-party in-repo UI layer with explicit, future-extractable boundaries.
+
+Current v0 surface:
+
+- `TextRenderer` + text command/style contracts in `luvatrix_ui/text/renderer.py`.
+- `SVGRenderer` + `SVGComponent` contracts in `luvatrix_ui/controls/svg_renderer.py` and
+  `luvatrix_ui/controls/svg_component.py`.
+- `ButtonModel` state machine in `luvatrix_ui/controls/button.py`:
+  `idle`, `hover`, `press_down`, `press_hold`, `disabled`.
+- `ThemeTokens` + validation/default merging in `luvatrix_ui/style/theme.py`.
+
+Runtime-side compiler:
+
+- `MatrixUIFrameRenderer` in `luvatrix_core/core/ui_frame_renderer.py` compiles first-party
+  component batches (including SVG) into matrix frame tensors for `WriteBatch` submission.
+
+Interaction model:
+
+- Consumes standardized HDI `press` phases (`down`, `hold_start`, `hold_tick`, `up`, `cancel`, etc.).
+- Keeps runtime/platform internals out of `luvatrix_ui`; integrations should adapt events/renderers at the boundary.
+
+See:
+
+- `docs/ui_component_protocol.md` for component contracts
+- `docs/app_protocol.md` for runtime contract
+- `docs/json_ui_compiler.md` for JSON page/lottie-oriented compiler design
+
+## macOS Visualizer Examples
+
+Run stretch mode:
+```bash
+uv run --python 3.14 python examples/macos_visualizer/stretch_mode.py
+```
+
+Run preserve-aspect mode (black bars when needed):
+```bash
+uv run --python 3.14 python examples/macos_visualizer/preserve_aspect_mode.py
+```
+
+Run the full interactive suite app-protocol example (runs until window closes):
+```bash
+uv run --python 3.14 python examples/app_protocol/run_full_suite_interactive.py --aspect stretch
+uv run --python 3.14 python examples/app_protocol/run_full_suite_interactive.py --aspect preserve
+```
+
+Force experimental Vulkan path:
+```bash
+LUVATRIX_ENABLE_EXPERIMENTAL_VULKAN=1 uv run --python 3.14 python examples/macos_visualizer/stretch_mode.py
+```
+
+Force fallback layer-blit path:
+```bash
+unset LUVATRIX_ENABLE_EXPERIMENTAL_VULKAN
+uv run --python 3.14 python examples/macos_visualizer/stretch_mode.py
+```
+
+Quick Vulkan environment probe (no window):
+```bash
+uv run --python 3.14 python examples/macos_visualizer/vulkan_probe.py
+```
+
+## App Protocol Example
+
+Minimal input + sensor logger app:
+```bash
+uv run --python 3.14 python examples/app_protocol/run_input_sensor_logger.py --simulate-hdi --simulate-sensors
+```
+
+Choose which sensors to log:
+```bash
+uv run --python 3.14 python examples/app_protocol/run_input_sensor_logger.py \
+  --simulate-hdi \
+  --sensor thermal.temperature \
+  --sensor power.voltage_current
+```
+
+Additional available sensor metadata types:
+`sensor.motion`, `camera.device`, `microphone.device`, `speaker.device`.
+
+Open a macOS logger window and report real mouse hover coordinates (window-relative only, gated by active/focused window):
+```bash
+uv run --python 3.14 python examples/app_protocol/run_input_sensor_logger.py \
+  --open-window \
+  --sensor thermal.temperature \
+  --sensor power.voltage_current
+```
+
+Notes:
+- `--simulate-hdi` intentionally emits synthetic keyboard events (`key='a'`) for test visibility.
+- With `--open-window` and without `--simulate-hdi`, logger emits real window-gated mouse and keyboard input.
+
+## Unified Runtime CLI
+
+App manifests can now include optional `platform_support` and `[[variants]]` blocks so runtime picks only the host-compatible variant entrypoint/module root.
+
+Run any app protocol folder (`app.toml` + entrypoint) headless:
+```bash
+uv run --python 3.14 python main.py run-app examples/app_protocol/input_sensor_logger --render headless --ticks 300
+```
+
+Run it with macOS window rendering:
+```bash
+uv run --python 3.14 python main.py run-app examples/app_protocol/input_sensor_logger --render macos --width 640 --height 360
+```
+
+Use real macOS sensor providers:
+```bash
+uv run --python 3.14 python main.py run-app examples/app_protocol/input_sensor_logger --render headless --sensor-backend macos
+```
+
+Enable runtime energy safety monitoring (throttles on warn, can enforce shutdown on sustained critical telemetry):
+```bash
+uv run --python 3.14 python main.py run-app examples/app_protocol/input_sensor_logger \
+  --sensor-backend macos \
+  --energy-safety monitor
+```
+
+Enforce shutdown instead of monitor-only mode:
+```bash
+uv run --python 3.14 python main.py run-app examples/app_protocol/input_sensor_logger \
+  --sensor-backend macos \
+  --energy-safety enforce \
+  --energy-critical-streak 3
+```
+
+Persist audit events to SQLite or JSONL:
+```bash
+uv run --python 3.14 python main.py run-app examples/app_protocol/input_sensor_logger --audit-sqlite ./.luvatrix/audit.db
+uv run --python 3.14 python main.py run-app examples/app_protocol/input_sensor_logger --audit-jsonl ./.luvatrix/audit.jsonl
+```
+
+With the logger example, you can explicitly include motion:
+```bash
+uv run --python 3.14 python examples/app_protocol/run_input_sensor_logger.py \
+  --open-window \
+  --sensor sensor.motion \
+  --sensor thermal.temperature \
+  --simulate-sensors
+```

luvatrix-0.1.0.dist-info/RECORD

@@ -0,0 +1,72 @@
+luvatrix_core/__init__.py,sha256=cNWr4-Lwdf1vMzbqind_39eDvnpUCdtYbQA-tUdYpZs,73
+luvatrix_core/core/__init__.py,sha256=2kO7mWsfUdJ-2kT6hiqS-GgNLNabMDWH2_Vg_M1js2E,2714
+luvatrix_core/core/app_runtime.py,sha256=jEiKZSXrLBOP1Zu90Pc6nY4jc7ZObxa7Q7hRWUG99ms,28003
+luvatrix_core/core/audit.py,sha256=7VBaykivfZ_cWIfUH4NsvOS3lU1BCznPO-8BLi1Pc3I,5069
+luvatrix_core/core/coordinates.py,sha256=YKA5IMK46gtWfF4t5_6Z74wF9NzyhlfBmOmLfH5E0Nw,5720
+luvatrix_core/core/display_runtime.py,sha256=evFRPFI7ouorsuiKwbttcquix8Ks5k7g4Ma034-y82Y,4222
+luvatrix_core/core/energy_safety.py,sha256=VHAIfvbZUpT1WbpGCp0qC3DHQHvzqdkMgKgi5BVfcBU,5205
+luvatrix_core/core/engine.py,sha256=7gvc4tykSszuMcLfJWMSMCWGp6R1e5h5pNWUf1hzhvY,3596
+luvatrix_core/core/events.py,sha256=SHg3iUrqYFwux5qFw2Zj6zz7aBpqmaiBazKSoGF9uXc,598
+luvatrix_core/core/frame_rate_controller.py,sha256=xS_MEuFfwiYlYV4Fiwq000peKSsVSaMyaAfD-b--d-4,1612
+luvatrix_core/core/hdi_thread.py,sha256=zCToezAB53h-kU16wVEUPoqDv-Y9pqpHnAme_jj9VJk,16725
+luvatrix_core/core/protocol_governance.py,sha256=878w_MjOae3WnfHUd_yQrs90BieeOnb6p_67Mp6kPc0,1657
+luvatrix_core/core/sensor_manager.py,sha256=r3VsuVvKyLl6oHLBqtlu3Vy0F6LySWvKA_u1_fhuGkA,7190
+luvatrix_core/core/ui_frame_renderer.py,sha256=NYqTSpOcLuH_RnwhLrdHuqlFpp3A3Et6g-ye-KxKv3o,18217
+luvatrix_core/core/unified_runtime.py,sha256=Kadig6yVXZbb2xxrRzoah7jQYtCDsqL7UuDrz-wm5WM,5546
+luvatrix_core/core/window_matrix.py,sha256=3sjr0vL5VFFtcAwVdbF5RXHukqQg2fxn9y_d98eZ7IE,8220
+luvatrix_core/platform/__init__.py,sha256=XrzBKH61ASH5zjcMvmdbgP19mcb9IgiKYbEgHtG6d4Y,373
+luvatrix_core/platform/frame_pipeline.py,sha256=YuvISdWyGaILvCy6Z-QC7FtXmWO9a489uK8LLVdc5Uo,1464
+luvatrix_core/platform/vulkan_compat.py,sha256=5BtI6RpXcj5qfXQcn9_2NT9eEX2HK8LZRPwky6Ro0cc,17242
+luvatrix_core/platform/vulkan_scaling.py,sha256=6fL7MQCpo_bCQs7IqrPIEMILDpUIq7Y8sQpKjbzduCQ,3695
+luvatrix_core/platform/macos/__init__.py,sha256=puvfwtZ0grAFJ1XJviOTwe41pk613U68eTsNR0l_9tU,1036
+luvatrix_core/platform/macos/hdi_source.py,sha256=Yoj1PD8uMoJuGQQEA3tm649dKKiOEBI4zce8uZpKQQE,8700
+luvatrix_core/platform/macos/sensors.py,sha256=rw_RapmZhkSDP8j5cg-Ws7G7yrsrFcixvflnmYXNw8Y,7898
+luvatrix_core/platform/macos/vulkan_backend.py,sha256=1Hckdy6GqxRz6lBVIFq1DCey5MolWCStsOriFhHR83s,69222
+luvatrix_core/platform/macos/vulkan_presenter.py,sha256=wu8buy0Y8aA5Er0nmcXdgMQXynO75o6dyeVgtEcgX-k,6919
+luvatrix_core/platform/macos/window_system.py,sha256=6Us4pYo81Psdl8MH6-fWvH5EHxtbig-UYfuBWr_attY,5225
+luvatrix_core/render/__init__.py,sha256=QC8K_Gess0WmHUhVU3fjWufhO5KNB-80lEOZruDsNOc,108
+luvatrix_core/render/framebuffer.py,sha256=iNT91zegZd4cWaamySC0obGN1olysTAEE7t117foDQ0,4350
+luvatrix_core/render/svg.py,sha256=UdQeAkbsXF5B3eslLilRidlfD6R_3GVq3NhrpeBYkao,11282
+luvatrix_core/targets/__init__.py,sha256=xSmmgFvY3-Y8YkAr_QGZJEfmuqPEIESLp50QCYUdlS4,192
+luvatrix_core/targets/base.py,sha256=mCeUcG2MxvbfrUZg7cfDBiB2B0xmX1ug6nrV78hFuDg,820
+luvatrix_core/targets/vulkan_target.py,sha256=dCBW8-zTqXIMRc5LiGJaYWMRzsC-1ssF1Fb9bD6qY6I,1374
+luvatrix_core/targets/web_target.py,sha256=b_dz-p9ShkRqVIhUVu6S04f-15pL-5QszRhWrLP5LRw,447
+luvatrix_core/ui/__init__.py,sha256=VYaQyhMW81EnuW9sUPiJ-fyXm0JgNo-59rPAzBGEkBA,114
+luvatrix_core/ui/element.py,sha256=J5HCUxazgZxQ7qe45b1R8S43CuCrhZC01Bjlx30YL-8,320
+luvatrix_core/ui/page_loader.py,sha256=yssl11PjepGlv07AvpT39yUNpfPRs9WOiL-KHxKpCFM,1479
+luvatrix_plot/__init__.py,sha256=mWUC1oZdE3q7kyUZSF56KdnxCosoOnVTB7oBk8ySjS0,566
+luvatrix_plot/api.py,sha256=ySSF0wd9GeGx0CFIUJxHXk1I-aZPNBluNC5RcnISEcc,1245
+luvatrix_plot/display.py,sha256=Y7PNf6dpyjsJ1RbSs5dPYqgGxTYRvgr5K0S680qbJH8,1899
+luvatrix_plot/dynamic_axis.py,sha256=e_seT5K6WGf_sPN3IXSOeho-TSNE9OPNK-q7f-_9Veg,5530
+luvatrix_plot/errors.py,sha256=jxNZQ0XdMCQiwUDoUGa5IR6pCTlactUEFn1et9kJFJ0,108
+luvatrix_plot/figure.py,sha256=cpA96m6kjLw30qhCNPrcDE42Eg2y1JiMWPCj2zRYNQQ,46907
+luvatrix_plot/live.py,sha256=AWCIhIdLvfO5wIeiCPYj312e7C5LpXzBa1v5swi0Dso,6848
+luvatrix_plot/scales.py,sha256=8rQ1i_9k_u4xiGjVDbBmQFUdhJjJq8Bx6xJ-NfxnMHg,6495
+luvatrix_plot/series.py,sha256=m8ushvImMssuDdviILy17zLyeERKWt3nwKw8HO-xkQw,604
+luvatrix_plot/adapters/__init__.py,sha256=_ONvq6y16uW82FYsZw_fl4W4xBP9DCYeIseRHp6ebOY,64
+luvatrix_plot/adapters/normalize.py,sha256=vEceesHFYs3iV05Oc5trJ5Hpv30npmzSm_5LjFpNHw4,4380
+luvatrix_plot/compile/__init__.py,sha256=oWfOGziTiBL2K1GTy38lBe_EYm3BW0yq-ZqELILFeaQ,317
+luvatrix_plot/compile/app_protocol.py,sha256=R3Xq5F16V5eaTkCHUwgRtd8ozFFVRTxUwx0BF-YEhB8,2867
+luvatrix_plot/raster/__init__.py,sha256=7hPAvZ3SWFBGi8a2LHycQ-TiOQ4gS46jTvSwgxrXCPg,417
+luvatrix_plot/raster/canvas.py,sha256=6gQL-FXF1vY8NamJt49Y8gwQRajQ5nC9EfQdZIG1V-Y,2146
+luvatrix_plot/raster/draw_lines.py,sha256=mVet_lTz0uD8QdkMmzcstKkgv7z_cK1VKKj2qRk6ZNQ,1190
+luvatrix_plot/raster/draw_markers.py,sha256=xCWJSpKHdrHTOvZ1eG9qi_Oa_-_hLG4kH4-OMgpwbFo,612
+luvatrix_plot/raster/draw_text.py,sha256=ZTt_S4MqLyrpdARDGZT0oREE7q4wcf6OMAmRcPnZ_DU,6315
+luvatrix_plot/raster/layers.py,sha256=LbX092d2NyBSka-yXCtvAolaIkuzAgAzBOeYiXEBDrw,806
+luvatrix_ui/__init__.py,sha256=7OufqL_8l_DRlLbxXlrJznbOz26vZbJKT8QL08iS_RA,1901
+luvatrix_ui/component_schema.py,sha256=nhVVw_AFk2s_DnM8viU7bM2cn05tb912uGCDsSgHGjc,4884
+luvatrix_ui/ui_ir.py,sha256=Rox3eLVG1czPymRw6QPRlW6bmBwBtP9Rdgc0M11c21E,26796
+luvatrix_ui/controls/__init__.py,sha256=5vK5IZgPSCDHJeCy1Sac9nCmLzgSf3hRqpvAxqBiC54,446
+luvatrix_ui/controls/button.py,sha256=QWD7OQhX6hLTGNNjLAePxF24TRlx8ZUJ0i90opp2jfg,2013
+luvatrix_ui/controls/interaction.py,sha256=oa_zLqj8RiKNbcAAhJq3YDuYuquU84e26EWpRtFah0U,1440
+luvatrix_ui/controls/svg_component.py,sha256=74TZxH6K_1FPzm60mWfESTf28ZY7lM8-LhHjqFx-cRs,2267
+luvatrix_ui/controls/svg_renderer.py,sha256=67wySp9ck_9wy3ingvZXgHT2a8TtfGrXsTzQZsLDvgc,788
+luvatrix_ui/style/__init__.py,sha256=sIwasD-sG0HmT_kdbveA6AWbYvRe0-64OwZd8hftlH4,149
+luvatrix_ui/style/theme.py,sha256=Jgb_djHq1UW6Eoq8SvOtx5_lArBFCu2cT6lnUp-BzhY,2251
+luvatrix_ui/text/__init__.py,sha256=RkQgy-RiPn3h_x5x7WwETBGPnzPpQRuH9i-p5b7haUg,492
+luvatrix_ui/text/component.py,sha256=J-rTNQnbo-HW0C89DjGfqwgM3V65GGk2hxoFeTHT9t0,3545
+luvatrix_ui/text/renderer.py,sha256=_UqC3arX_GGmvYLz1zPxXZvM2_WlsCNMQKYq3Wco4LE,3851
+luvatrix-0.1.0.dist-info/METADATA,sha256=1NgFbFL4XeZTrmvb78Ty8nFbHl_W8vQUZhk0IpvuvTQ,6211
+luvatrix-0.1.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+luvatrix-0.1.0.dist-info/top_level.txt,sha256=VJSeIapQPxO46ZqRvtGn9BCZiWWAjCSOu1ajv1jNkJc,40
+luvatrix-0.1.0.dist-info/RECORD,,

luvatrix-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

luvatrix-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+luvatrix_core
+luvatrix_plot
+luvatrix_ui

luvatrix_core/__init__.py

@@ -0,0 +1,4 @@
+"""Luvatrix runtime."""
+
+__all__ = ["__version__"]
+__version__ = "0.1.0"

luvatrix_core/core/__init__.py

@@ -0,0 +1,109 @@
+from .audit import JsonlAuditSink, SQLiteAuditSink
+from .app_runtime import (
+    APP_PROTOCOL_VERSION,
+    AppContext,
+    AppLifecycle,
+    AppManifest,
+    AppRuntime,
+    AppUIRenderer,
+    AppVariant,
+    ResolvedAppVariant,
+)
+from .display_runtime import DisplayRuntime, RenderTick
+from .frame_rate_controller import FrameRateController
+from .ui_frame_renderer import MatrixUIFrameRenderer
+from .coordinates import (
+    CoordinateFrame,
+    CoordinateFrameRegistry,
+    PRESET_CARTESIAN_BL,
+    PRESET_CARTESIAN_CENTER,
+    PRESET_SCREEN_TL,
+)
+from .energy_safety import EnergySafetyController, EnergySafetyDecision, EnergySafetyPolicy, SensorEnergySafetyController
+from .engine import Engine
+from .hdi_thread import HDIEvent, HDIEventSource, HDIThread
+from .events import InputEvent
+from .protocol_governance import (
+    CURRENT_PROTOCOL_VERSION,
+    DEPRECATED_PROTOCOL_VERSIONS,
+    SUPPORTED_PROTOCOL_VERSIONS,
+    ProtocolCompatibility,
+    check_protocol_compatibility,
+)
+from .sensor_manager import (
+    DEFAULT_ENABLED_SENSORS,
+    FallbackSensorProvider,
+    SensorReadDeniedError,
+    SensorReadUnavailableError,
+    SensorManagerThread,
+    SensorProvider,
+    SensorSample,
+)
+from .unified_runtime import UnifiedRunResult, UnifiedRuntime
+from .window_matrix import (
+    CallBlitEvent,
+    FullRewrite,
+    Multiply,
+    PushColumn,
+    PushRow,
+    ReplaceRect,
+    ReplaceColumn,
+    ReplaceRow,
+    WriteBatch,
+    WindowMatrix,
+)
+
+__all__ = [
+    "CallBlitEvent",
+    "APP_PROTOCOL_VERSION",
+    "AppContext",
+    "AppLifecycle",
+    "AppManifest",
+    "AppRuntime",
+    "AppUIRenderer",
+    "AppVariant",
+    "ResolvedAppVariant",
+    "JsonlAuditSink",
+    "DisplayRuntime",
+    "FrameRateController",
+    "Engine",
+    "FullRewrite",
+    "HDIEvent",
+    "HDIEventSource",
+    "HDIThread",
+    "InputEvent",
+    "Multiply",
+    "PushColumn",
+    "PushRow",
+    "ReplaceRect",
+    "ReplaceColumn",
+    "ReplaceRow",
+    "RenderTick",
+    "MatrixUIFrameRenderer",
+    "CoordinateFrame",
+    "CoordinateFrameRegistry",
+    "PRESET_SCREEN_TL",
+    "PRESET_CARTESIAN_BL",
+    "PRESET_CARTESIAN_CENTER",
+    "EnergySafetyController",
+    "EnergySafetyDecision",
+    "EnergySafetyPolicy",
+    "SensorEnergySafetyController",
+    "DEFAULT_ENABLED_SENSORS",
+    "CURRENT_PROTOCOL_VERSION",
+    "DEPRECATED_PROTOCOL_VERSIONS",
+    "SUPPORTED_PROTOCOL_VERSIONS",
+    "ProtocolCompatibility",
+    "check_protocol_compatibility",
+    "FallbackSensorProvider",
+    "SensorReadDeniedError",
+    "SensorReadUnavailableError",
+    "SensorManagerThread",
+    "SensorProvider",
+    "SensorSample",
+    "SQLiteAuditSink",
+    "UnifiedRunResult",
+    "UnifiedRuntime",
+    "WriteBatch",
+    "WindowMatrix",
+]