Center-overlay panel

from __future__ import annotations

from imperal_sdk import Extension, ui

ext = Extension(
    "my-ext",
    display_name="My Extension",
    description="An extension with a full-bleed center-overlay editor.",
    actions_explicit=True,
)

# ── Inline stub data — replace with your real data fetch in production ─────
_NOTES = [
    {"id": "note-1", "title": "First note",  "body": "Body of note one."},
    {"id": "note-2", "title": "Second note", "body": "Body of note two."},
]


def _get_note(note_id: str) -> dict | None:
    return next((n for n in _NOTES if n["id"] == note_id), None)


# ── Left sidebar — discovery-safe, sets auto_action to open overlay ────────

@ext.panel(
    "sidebar",
    slot="left",
    title="Notes",
    icon="🗒️",
    default_width=280,
    min_width=200,
    max_width=500,
)
async def sidebar(
    ctx: object,
    active_note_id: str = "",
    view: str = "notes",
    **kwargs: object,
) -> object:
    notes = _NOTES  # replace with: notes = await fetch_notes(ctx)

    items = [
        ui.ListItem(
            id=note["id"],
            title=note["title"],
            selected=(note["id"] == active_note_id),
            # Dispatching the "editor" panel (declared with center_overlay=True)
            # opens it as a full-bleed center overlay over the main content area.
            on_click=ui.Call("__panel__editor", note_id=note["id"]),
        )
        for note in notes
    ]

    root = ui.Stack(
        children=[ui.List(items=items)],
        gap=2,
    )

    # auto_action: open the most-recent note on first load.
    # Conditional: only when no note is already active and we are in the
    # normal view (not trash). The host fires this once after discovery
    # (the discovery-once guard). Navigating away and returning to
    # the same extension page does NOT re-fire auto_action within the
    # same session.
    if notes and not active_note_id and view != "trash":
        root.props["auto_action"] = ui.Call(
            "__panel__editor", note_id=notes[0]["id"]
        )

    return root


# ── Center-overlay editor ──────────────────────────────────────────────────
# center_overlay=True is what makes this panel render as a full-bleed overlay
# (v4.1.8+). The panel_id can be any name you choose; here it is "editor".
# This handler is only reached via an explicit ui.Call or auto_action — center
# panels are not called during batch discovery.

@ext.panel(
    "editor",
    slot="center",
    center_overlay=True,
    title="Editor",
    icon="📝",
)
async def editor(ctx: object, note_id: str = "", **kwargs: object) -> object:
    # At batch discovery the center panel is NOT called (only left/right are
    # called at init). This handler is only reached via an explicit
    # ui.Call or auto_action. When called without note_id, return ui.Empty()
    # rather than None — ui.Empty() is the correct "no content yet" signal.
    if not note_id:
        return ui.Empty(message="Select a note to edit", icon="📄")

    note = _get_note(note_id)
    if note is None:
        return ui.Error(message="Note not found")

    return ui.Stack(
        children=[
            ui.Text(note["title"], variant="h2"),
            ui.RichEditor(
                content=note["body"],
                on_change=ui.Call("save_note", note_id=note_id),
            ),
        ],
        gap=4,
    )