Koya/Compositor

import * as Compositor from 'Koya/Compositor';

const displays = await Compositor.listDisplays({backend: 'drm'});
if (!displays.length) throw new Error('No DRM output found');
const win = await Compositor.createWindow({
    role: 'raw',
    display: displays[0].display,
    position: {x: 0, y: 0},
    keyboardInteractivity: 'exclusive',
    acceptPointerEvents: true
});
await Compositor.setClearColor(win, 0.04, 0.05, 0.08, 1);
await Compositor.focusWindow(win);
// Attach UI through the same APIs used by Wayland windows.
// Window.create({role: 'raw', ...}) also works in the standard UI library.

import * as Compositor from 'Koya/Compositor';

const win = await Compositor.createWindow({
    role: 'window',
    title: 'My App',
    appId: 'org.example.myapp',
    size: { x: 800, y: 600 },
    state: { maximized: false, fullscreen: false },
    deviceSelector: ({ devices, preferredDeviceId }) =>
        devices.find(device => device.type === 'discrete' && device.suitable)?.id ?? preferredDeviceId
});

await Compositor.setTitle(win, 'New Title');
await Compositor.setAppId(win, 'org.example.newid');
await Compositor.setMaximized(win, true);
await Compositor.setFullscreen(win, false);
await Compositor.minimize(win);

import * as Compositor from 'Koya/Compositor';

import * as Event from 'Helix/Event';

Event.on('windowFocusChanged', ({id, focused}) => {
    // Update application focus indication.
});
Event.on('windowOutputStateChanged', ({id, state}) => {
    // Retain this window/UI while state is 'suspended'.
});
Event.on('displaysChanged', async () => {
    const outputs = await Compositor.listDisplays({backend: 'drm'});
    // Reconcile output IDs with windows already created.
});

import * as Event from 'Helix/Event';

Event.on('keyDown', ({ key, time, id }) => { /* one-shot physical key down */ });
Event.on('keyUp',   ({ key, time, id }) => { /* ... */ });
Event.on('keyRepeat', ({ key, time, id }) => { /* held-key repeats */ });
Event.on('textInput', ({ text, id }) => { /* composed text typed once */ });
Event.on('textRepeat', ({ text, id }) => { /* composed text repeats while held */ });
Event.on('keyModifiers', ({ depressed, latched, locked, group, id }) => { /* modifier state */ });
Event.on('windowResized', ({ id, width, height }) => {
    if (id !== win) return;
    // width and height are logical pixels, including for layer-shell windows.
    updatePageCapacity(width, height);
});

import * as Compositor from 'Koya/Compositor';
import * as Log from 'Helix/Log';

const displays = await Compositor.listDisplays({backend: 'wayland'});
const display = displays.length ? displays[0].display : '';

// Bar attached to the top, reserves space equal to thickness
const topBar = await Compositor.createWindow({
    role: 'bar', edge: 'top', thickness: 26,
    reserveSpace: true, namespace: 'koya-top-bar', display
});

// Floating overlay at top-left with offset
const win = await Compositor.createWindow({
    role: 'overlay', anchor: 'top-left',
    size: { x: 400, y: 200 }, offset: { x: 100, y: 100 },
    namespace: 'koya-overlay', display
});
await Compositor.setClearColor(win, 0.1, 0.1, 0.12, 1.0);
Log.info(JSON.stringify(await Compositor.getWindowInfo(win)));

await Compositor.setKeyboardInteractivity(win, 'on_demand');
await Compositor.setPointerEvents(win, true);
await Compositor.setCursor(win, 'hand');
await Compositor.elevateWindow(win);
setTimeout(async () => {
    await Compositor.lowerWindow(win);
    await Compositor.destroyWindow(win);
}, 3000);

// Full-screen background layer
const bg = await Compositor.createWindow({
    role: 'background', namespace: 'koya-background', display
});
await Compositor.setClearColor(bg, 0.0, 0.0, 0.0, 1.0);

// Hyprland: fill under bars regardless of exclusive zones
const bgFull = await Compositor.createWindow({
    role: 'background', display,
    exclusiveZone: -1, namespace: 'koya-background-full'
});