components — 通用组件 API

构建器 → schema 节点 (Component/dict)
   → 加入视图模型树（snapshot / patch 发送）
   → _wire_nodes 把事件处理函数压成 {event: True} 标记
   → IDE 按组件注册表校验并渲染
   → 用户操作 → IDE 回发 ide.view.event 帧（含 component_id + event + payload）
   → SDK 在本地查表调用对应 handler

from pyrite_sdk.api.components import Button

btn = Button(id="save", label="保存", on_press=lambda e: print("保存"))
print(btn.to_json())

from pyrite_sdk.api import components as c
from pyrite_sdk.api.icons import Icons

page = c.Scaffold(
    c.VirtualList(id="results", items=[]),
    app_bar=c.AppBar(
        c.IconButton(
            id="refresh",
            icon=Icons.refresh,
            tooltip="刷新",
            on_press=lambda event: refresh(),
        ),
        title="分析结果",
    ),
)

items = [
    MenuItem(id="copy", label="复制", shortcut=MenuShortcut("c", primary=True)),
    MenuCheckboxItem(id="bold", label="加粗", checked=True),
    MenuDivider(),
    Submenu(label="插入", children=[
        MenuItem(id="image", label="图片"),
    ]),
]

from pyrite_sdk.api import canvas
from pyrite_sdk.api.components import Canvas, Scaffold
from pyrite_sdk.core.plugin import UiPlugin


class ScopePlugin(UiPlugin):
    def __init__(self):
        super().__init__()
        self.view = self.views.create("scope-plugin.main")
        self.surface = Canvas(
            id="scope",
            width=320,
            height=180,
            interactive=True,
            viewport={
                "scale": 1.0,
                "minScale": 0.25,
                "maxScale": 8.0,
                "panEnabled": True,
                "zoomEnabled": True,
            },
            ops=[
                canvas.rect(
                    0,
                    0,
                    320,
                    180,
                    paint=canvas.paint(color=canvas.Color.surface),
                ),
                canvas.line(
                    12,
                    90,
                    308,
                    90,
                    id="zero-line",
                    paint=canvas.paint(
                        color=canvas.Color.primary,
                        stroke_width=2,
                    ),
                ),
            ],
            on_tap=self._on_tap,
        )
        self.view.snapshot([Scaffold(self.surface)])

    def on_start(self):
        self.view.open()

    def _on_tap(self, event):
        x = event.get("x", 0)
        y = event.get("y", 0)
        self.surface.controller.set_ops(
            [
                canvas.circle(
                    x,
                    y,
                    5,
                    paint=canvas.paint(color=canvas.Color.primary),
                )
            ],
            layer="cursor",
        )


plugin = ScopePlugin()
plugin.start()

logo = self.resources.asset("assets/logo.png")
op = canvas.image(logo, 16, 16, width=64, height=64, id="logo")

surface.controller.set_ops(preview_ops, layer="preview")
surface.controller.push_ops(marker_ops, layer="markers")
surface.controller.clear_layer("preview")
surface.controller.hit_test(120, 80, callback=lambda **result: print(result))

from pyrite_sdk.api.components import (
    Column, TextField, Button, Text, COMPONENT_SCHEMA_VERSION,
)

assert COMPONENT_SCHEMA_VERSION == 1

def build_form():
    return Column(
        Text("配置", style="headline"),
        TextField(
            id="name",
            label="名称",
            on_change=lambda payload: print(payload),
        ),
        Button(
            id="submit",
            label="提交",
            on_press=lambda e: print("已提交"),
        ),
        gap=8,
    )

field = TextField(id="name", label="名称")
field.on("change", lambda payload: print(payload.get("value")))