Public UI kit

@ephemeral-ai/mayfly-ui is the pure renderer-neutral construction layer. It exports ui, defineMayflyComponent(), and the wire types from @ephemeral-ai/mayfly-ui. It has no Cordis plugin, service registration, or terminal dependency.

import { ui } from '@ephemeral-ai/mayfly-ui'

const node = ui.surface({
  title: 'Build',
  child: ui.stack.column([
    ui.text('healthy', { tone: 'success' }),
    ui.progress({ value: 42, max: 100, label: 'Context' }),
  ]),
})

Builders clone caller data and deeply freeze their result. Cycles throw. Core still owns final schema, quota, control-character, and width admission.

Reusable components

import { defineMayflyComponent, ui } from '@ephemeral-ai/mayfly-ui'

export const summaryMetric = defineMayflyComponent<{
  label: string
  value: string
}>({
  id: '@acme/summary-metric',
  render: props => ui.richText([
    { text: props.label, tone: 'muted' },
    { text: ` ${props.value}`, tone: 'accent', emphasis: 'strong' },
  ]),
})

defineMayflyComponent validates only id and render, then deeply freezes each rendered node. It does not register a node kind or bind a Fiber.

A component kit is an ordinary npm library and cannot change Mayfly by itself. Consumer plugins place rendered output in mayflyPanes, mayflyStatus, mayflyOverlays, or mayflyEditorExtensions.