hatui-kit 0.1.0__py3-none-any.whl

hatui/demo/screens/dashboard/tabs/hacker.yaml

@@ -0,0 +1,80 @@
+title: Hacker
+route: hacker
+child:
+  type: column
+  name: hacker_screen
+  children:
+    - type: box
+      name: hacker_strip_box
+      title: channels
+      padding: 0
+      weight: 2
+      child:
+        type: signal_strip
+        name: hacker_signal_strip_widget
+        items_key: hacker.signal_strip
+    - type: row
+      name: hacker_primary_row
+      weight: 4
+      children:
+        - type: box
+          name: hacker_matrix_box
+          title: status matrix
+          padding: 1
+          weight: 3
+          child:
+            type: status_matrix
+            name: hacker_status_matrix
+            items_key: hacker.entities
+            selectable: true
+            selected_index_key: selection.matrix_index
+            selected_item_key: selection.matrix_item
+            columns: 2
+            density: normal
+        - type: box
+          name: hacker_histogram_box
+          title: burst distribution
+          padding: 1
+          weight: 2
+          child:
+            type: histogram
+            name: hacker_packet_histogram
+            buckets_key: hacker.packet_histogram
+            label_width: 9
+    - type: row
+      name: hacker_secondary_row
+      weight: 5
+      children:
+        - type: box
+          name: hacker_alert_stack_box
+          title: alert stack
+          padding: 1
+          weight: 2
+          child:
+            type: alert_stack
+            name: hacker_alert_stack
+            items_key: hacker.alerts
+            focusable: false
+        - type: box
+          name: hacker_heatmap_box
+          title: activity field
+          padding: 1
+          weight: 1
+          child:
+            type: heatmap
+            name: hacker_heatmap
+            matrix_key: viz.heatmap
+        - type: box
+          name: hacker_inspector_box
+          title: entity inspector
+          padding: 1
+          weight: 2
+          child:
+            type: kv_inspector
+            name: hacker_kv_inspector
+            data_key: hacker.selected_detail
+    - type: status_strip
+      name: hacker_status_strip
+      segments_key: ui.status_strip
+      bg_color: "@surface_alt"
+      weight: 1

hatui/demo/screens/dashboard/tabs/logs.yaml

@@ -0,0 +1,39 @@
+title: Logs
+route: logs
+child:
+  type: column
+  name: logs_screen
+  children:
+    - type: box
+      name: logs_box
+      title: event log
+      padding: 1
+      weight: 8
+      child:
+        type: scroll
+        name: log_scroll
+        focus_fg_color: "@focus_fg"
+        child:
+          type: log
+          name: log_widget
+          lines_key: logs.main
+          max_lines: 80
+          show_timestamp: true
+    - type: box
+      name: status_box
+      title: operator note
+      padding: 1
+      weight: 2
+      child:
+        type: scroll
+        name: logs_note_scroll
+        focus_fg_color: "@focus_fg"
+        child:
+          type: paragraph
+          name: logs_note
+          text_key: ui.logs_note
+    - type: status_strip
+      name: logs_status_strip
+      segments_key: ui.status_strip
+      bg_color: "@surface_alt"
+      weight: 1

hatui/demo/screens/dashboard/tabs/overview.yaml

@@ -0,0 +1,180 @@
+title: Overview
+route: overview
+child:
+  type: column
+  name: overview_screen
+  children:
+    - type: box
+      name: header_box
+      title: msys
+      title_align: center
+      padding: 1
+      style: rounded
+      fg_color: "@accent_alt"
+      weight: 4
+      child:
+        type: column
+        name: header_column
+        children:
+          - type: banner
+            name: header_banner
+            text_key: ui.header_text
+            fg_color: "@accent_alt"
+            weight: 3
+          - type: label
+            name: header_label
+            text_key: ui.header_subtitle
+            align: center
+            fg_color: "@text_muted"
+            weight: 1
+    - type: row
+      name: stats_row
+      weight: 3
+      children:
+        - type: box
+          name: cpu_box
+          title: cpu
+          padding: 1
+          weight: 1
+          child:
+            type: stat
+            name: cpu_stat
+            label: load avg
+            data_key: stats.cpu
+            accent_color: "@error"
+        - type: box
+          name: mem_box
+          title: memory
+          padding: 1
+          weight: 1
+          child:
+            type: stat
+            name: mem_stat
+            label: resident
+            data_key: stats.memory
+            accent_color: "@success"
+        - type: box
+          name: net_box
+          title: network
+          padding: 1
+          weight: 1
+          child:
+            type: stat
+            name: net_stat
+            label: rx / tx
+            data_key: stats.network
+            accent_color: "@accent"
+    - type: row
+      name: telemetry_row
+      weight: 7
+      children:
+        - type: box
+          name: overview_box
+          title: overview
+          padding: 1
+          weight: 3
+          child:
+            type: column
+            name: overview_column
+            children:
+              - type: scroll
+                name: overview_text_scroll
+                focus_fg_color: "@focus_fg"
+                weight: 3
+                child:
+                  type: paragraph
+                  name: overview_text
+                  text_key: ui.overview_text
+                  fg_color: "@text"
+              - type: alert
+                name: overview_alert
+                message_key: alerts.message
+                level_key: alerts.level
+                weight: 1
+              - type: menu
+                name: quick_actions
+                selected_index_key: selection.quick_action_index
+                selected_fg_color: "@selection_fg"
+                selected_bg_color: "@selection_bg"
+                bullet: "» "
+                weight: 2
+                items:
+                  - label: route overview
+                    action: route_set
+                    payload:
+                      route: overview
+                  - label: route forensics
+                    action: route_set
+                    payload:
+                      route: forensics
+                  - label: route logs
+                    action: route_set
+                    payload:
+                      route: logs
+                  - label: route visuals
+                    action: route_set
+                    payload:
+                      route: visuals
+                  - label: route analysis
+                    action: route_set
+                    payload:
+                      route: analysis
+                  - label: route hacker
+                    action: route_set
+                    payload:
+                      route: hacker
+                  - label: open help overlay
+                    action: route_push
+                    payload:
+                      route: help_modal
+                  - label: toggle compact mode
+                    action: store_toggle
+                    payload:
+                      path: flags.compact_mode
+              - type: progress_bar
+                name: scan_bar
+                label: deep scan
+                value_key: signals.scan_progress
+                show_percentage: true
+                fill_color: "@error"
+                weight: 1
+              - type: progress_bar
+                name: uplink_bar
+                label: uplink sync
+                value_key: signals.uplink_progress
+                show_percentage: true
+                fill_color: "@success"
+                weight: 1
+        - type: box
+          name: telemetry_box
+          title: telemetry
+          padding: 1
+          weight: 2
+          child:
+            type: column
+            name: telemetry_column
+            children:
+              - type: label
+                name: sparkline_label
+                text: packet burst
+                fg_color: "@text"
+                weight: 1
+              - type: sparkline
+                name: telemetry_sparkline
+                values_key: telemetry.packet_series
+                fg_color: "@accent"
+                weight: 1
+              - type: mini_chart
+                name: telemetry_mini_chart
+                values_key: telemetry.mini_chart
+                fg_color: "@success"
+                weight: 4
+              - type: paragraph
+                name: telemetry_copy
+                text_key: telemetry.summary
+                weight: 2
+    - type: status_strip
+      name: overview_status_strip
+      segments_key: ui.status_strip
+      bg_color: bright_black
+      weight: 1

hatui/demo/screens/dashboard/tabs/visuals.yaml

@@ -0,0 +1,84 @@
+title: Visuals
+route: visuals
+child:
+  type: column
+  name: visuals_screen
+  children:
+    - type: row
+      name: visuals_charts_row
+      weight: 5
+      children:
+        - type: box
+          name: line_chart_box
+          title: line chart
+          padding: 1
+          weight: 2
+          child:
+            type: line_chart
+            name: link_line_chart
+            series_key: viz.line_chart_series
+            show_scale: true
+        - type: box
+          name: area_chart_box
+          title: area chart
+          padding: 1
+          weight: 2
+          child:
+            type: area_chart
+            name: latency_area_chart
+            series_key: viz.area_chart_series
+            show_scale: true
+    - type: row
+      name: visuals_density_row
+      weight: 5
+      children:
+        - type: box
+          name: bar_chart_box
+          title: throughput bars
+          padding: 1
+          weight: 2
+          child:
+            type: bar_chart
+            name: throughput_bar_chart
+            bars_key: viz.throughput_bars
+            show_labels: true
+        - type: box
+          name: gauge_box
+          title: gauges
+          padding: 1
+          weight: 1
+          child:
+            type: column
+            name: gauge_column
+            children:
+              - type: gauge
+                name: burst_gauge
+                label: burst
+                value_key: signals.packet_sample
+                weight: 1
+              - type: gauge
+                name: sync_gauge
+                label: uplink
+                value_key: signals.uplink_progress
+                fill_color: "@success"
+                weight: 1
+              - type: gauge
+                name: scan_gauge
+                label: scan
+                value_key: signals.scan_progress
+                fill_color: "@warn"
+                weight: 1
+        - type: box
+          name: heatmap_box
+          title: heatmap
+          padding: 1
+          weight: 2
+          child:
+            type: heatmap
+            name: queue_heatmap
+            matrix_key: viz.heatmap
+    - type: status_strip
+      name: visuals_status_strip
+      segments_key: ui.status_strip
+      bg_color: "@surface_alt"
+      weight: 1

hatui/demo/screens/dashboard.yaml

@@ -0,0 +1,166 @@
+theme:
+  preset: clean_ops
+  colors:
+    text: "#d7d7e0"
+    text_muted: "#5a5a78"
+    surface: default
+    surface_alt: "#1d2533"
+    border: "#5a5a78"
+    accent: "#59d0ff"
+    accent_alt: "#cbb7ff"
+    accent_hot: "#ff4d6d"
+    focus_fg: "#59d0ff"
+    focus_bg: "#1d2533"
+    selection_fg: "#10131a"
+    selection_bg: "#59d0ff"
+    info: "#59d0ff"
+    warn: "#ffd166"
+    error: "#ff4d6d"
+    success: "#4de0a8"
+  fonts:
+    text: JetBrains Mono
+    border: JetBrains Mono
+    heading: JetBrains Mono
+  border:
+    style: sharp
+  text:
+    font_name: "@font:text"
+  widgets:
+    tabs:
+      fg_color: "@text_muted"
+      bg_color: "@surface"
+      active_fg_color: "@focus_fg"
+      active_bg_color: "@surface_alt"
+    status_strip:
+      fg_color: "@text"
+      bg_color: "@surface_alt"
+    signal_strip:
+      fg_color: "@text"
+      bg_color: "@surface"
+      info_fg_color: "@info"
+      warn_fg_color: "@warn"
+      error_fg_color: "@error"
+      success_fg_color: "@success"
+    status_matrix:
+      active_fg_color: "@selection_fg"
+      active_bg_color: "@selection_bg"
+      info_fg_color: "@info"
+      warn_fg_color: "@warn"
+      error_fg_color: "@error"
+      success_fg_color: "@success"
+      unknown_fg_color: "@text_muted"
+    stat:
+      accent_color: "@accent"
+    metric_grid:
+      accent_color: "@accent_alt"
+    progress_bar:
+      fill_color: "@accent"
+    chart:
+      axis_color: "@border"
+      fill_color: "@accent"
+    gauge:
+      fill_color: "@accent"
+      empty_color: "@border"
+    histogram:
+      fill_color: "@accent_alt"
+    alert:
+      info_fg_color: "@info"
+      warn_fg_color: "@warn"
+      error_fg_color: "@error"
+      success_fg_color: "@success"
+    alert_stack:
+      selected_fg_color: "@selection_fg"
+      selected_bg_color: "@selection_bg"
+      info_fg_color: "@info"
+      warn_fg_color: "@warn"
+      error_fg_color: "@error"
+      success_fg_color: "@success"
+    heatmap:
+      fg_color: "@accent"
+      color_ramp: ["@text_muted", "@accent", "@success", "@warn", "@error"]
+      bg_ramp: ["@surface", "@surface_alt", "@success", "@warn", "@error"]
+      cell_char: " "
+    list:
+      selected_fg_color: "@selection_fg"
+      selected_bg_color: "@selection_bg"
+    tree:
+      selected_fg_color: "@selection_fg"
+      selected_bg_color: "@selection_bg"
+    table:
+      header_color: "@text"
+      selected_fg_color: "@selection_fg"
+      selected_bg_color: "@selection_bg"
+    scroll:
+      scrollbar_fg_color: "@border"
+      scrollbar_bg_color: "@surface_alt"
+    code_block:
+      line_number_color: "@text_muted"
+    hex_dump:
+      offset_color: "@text_muted"
+    divider:
+      fg_color: "@border"
+      bg_color: "@surface"
+    log:
+      warn_fg_color: "@warn"
+      error_fg_color: "@error"
+      success_fg_color: "@success"
+    timeline:
+      info_fg_color: "@info"
+      warn_fg_color: "@warn"
+      error_fg_color: "@error"
+      success_fg_color: "@success"
+    event_feed:
+      info_fg_color: "@info"
+      warn_fg_color: "@warn"
+      error_fg_color: "@error"
+      success_fg_color: "@success"
+    inspector:
+      key_color: "@text_muted"
+      value_color: "@text"
+    kv_inspector:
+      title_color: "@accent"
+      key_color: "@text_muted"
+      value_color: "@text"
+    diff_viewer:
+      added_fg_color: "@success"
+      removed_fg_color: "@error"
+      hint_fg_color: "@warn"
+    flow:
+      active_fg_color: "@accent"
+      idle_fg_color: "@text_muted"
+    modal:
+      backdrop_bg_color: "#11131a"
+
+state:
+  flags:
+    compact_mode: false
+  selection:
+    quick_action_index: 0
+    relay_index: 0
+    matrix_index: 0
+
+router:
+  routes:
+    - overview
+    - forensics
+    - visuals
+    - analysis
+    - hacker
+    - logs
+    - debug_modal
+    - help_modal
+  initial: overview
+
+dev:
+  watch:
+    enabled: false
+    interval: 0.25
+    debounce: 0.2
+    paths:
+      - dashboard/**/*.yaml
+
+providers:
+  include: dashboard/providers.yaml
+
+screen:
+  include: dashboard/screen.yaml

hatui/demo_assets.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from contextlib import contextmanager
+from importlib.resources import as_file, files
+from pathlib import Path
+from typing import Iterator
+
+
+_BUNDLED_DEMO_SPEC = files("hatui.demo").joinpath("screens/dashboard.yaml")
+
+
+@contextmanager
+def bundled_demo_spec_path() -> Iterator[Path]:
+    """Yield a filesystem path to the bundled demo spec."""
+    with as_file(_BUNDLED_DEMO_SPEC) as spec_path:
+        yield spec_path

hatui/providers/__init__.py

@@ -0,0 +1,54 @@
+"""Built-in provider implementations."""
+
+from hatui.providers.base import Provider, ProviderResult
+from hatui.providers.builtins import (
+    ClockProvider,
+    CommandOutputProvider,
+    ComposeProvider,
+    ConstantProvider,
+    DemoLogsProvider,
+    EnvProvider,
+    FileProvider,
+    FrameProvider,
+    HostInfoProvider,
+    HttpJsonProvider,
+    NormalizeStateProvider,
+    RandomProvider,
+    RecordsProvider,
+    RollingWindowProvider,
+    BucketProvider,
+    SystemStatsProvider,
+    ThresholdProvider,
+    TemplateProvider,
+    TransformProvider,
+    WaveformProvider,
+    EventStreamProvider,
+    GridHistoryProvider
+)
+
+__all__ = [
+    "ClockProvider",
+    "CommandOutputProvider",
+    "ComposeProvider",
+    "ConstantProvider",
+    "DemoLogsProvider",
+    "EnvProvider",
+    "EventStreamProvider",
+    "FileProvider",
+    "FrameProvider",
+    "GridHistoryProvider",
+    "HostInfoProvider",
+    "HttpJsonProvider",
+    "NormalizeStateProvider",
+    "Provider",
+    "ProviderResult",
+    "RandomProvider",
+    "RecordsProvider",
+    "BucketProvider",
+    "RollingWindowProvider",
+    "SystemStatsProvider",
+    "TemplateProvider",
+    "ThresholdProvider",
+    "TransformProvider",
+    "WaveformProvider",
+]

hatui/providers/base.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from hatui.runtime.bindings import resolve_path
+
+
+@dataclass
+class ProviderResult:
+    state: str
+    value: object = None
+    reason: str | None = None
+
+
+SKIP_RESULT = "skip"
+VALUE_RESULT = "value"
+
+
+class Provider:
+    spec_schema: dict[str, object] = {}
+    required_spec_keys: set[str] = set()
+
+    def __init__(self, spec: dict):
+        self.spec = spec
+        self.name = spec.get("name", spec.get("type", self.__class__.__name__))
+        self.target = spec.get("target")
+        self.metadata_target = spec.get("metadata_target")
+        self.interval = float(spec.get("interval", 0.0) or 0.0)
+        self.group = spec.get("group", "default")
+        self.depends_on = list(spec.get("depends_on", []) or [])
+        self.enabled = spec.get("enabled", True)
+        self._last_run = 0.0
+
+    def setup(self, context):
+        pass
+
+    def is_enabled(self, context) -> bool:
+        if isinstance(self.enabled, bool):
+            return self.enabled
+        if isinstance(self.enabled, str):
+            return bool(resolve_path(context.data, self.enabled, False))
+        return bool(self.enabled)
+
+    def should_run(self, context) -> bool:
+        if self.interval <= 0:
+            return True
+        return (context.elapsed_time - self._last_run) >= self.interval
+
+    def update(self, delta_time: float, context):
+        if not self.is_enabled(context):
+            return ProviderResult(state=SKIP_RESULT, reason="disabled")
+        if not self.should_run(context):
+            return ProviderResult(state=SKIP_RESULT, reason="interval")
+        self._last_run = context.elapsed_time
+        return ProviderResult(state=VALUE_RESULT, value=self.provide(delta_time, context))
+
+    def provide(self, delta_time: float, context):
+        raise NotImplementedError
+
+    def teardown(self, context):
+        pass