Skip to content

StatInput

  • CommonInput

optional actions?: BlipAction[]

At most 4 are kept; surfaces with less room show the first one or two.

CommonInput.actions


optional facts?: Fact[]

At most 4 are kept.

CommonInput.facts


optional icon?: string

SF Symbol name. Falls back to the extension’s icon when omitted.

CommonInput.icon


key: string

The part of id this extension owns: the full id becomes <extensionId>/<key>.

CommonInput.key


optional period?: string

Names the delta’s window: "today", "24h".


optional reference?: TypedValue

What the delta is measured against, e.g. the day’s opening value.


optional relay?: Relay

Whether this item may be shared beyond this Mac: "allow" (the default) or "deny". Blipbar shares nothing beyond the Mac today, so it has no effect.

CommonInput.relay


optional series?: number[]

Recent history for the sparkline, oldest first. At most 48 points are kept.


optional short?: string

A short form of the title for the ear’s label-and-value chip ("LDN"), at most 8 characters.

CommonInput.short


optional staleAfter?: DateInput

After this, every surface renders the item stale without another message. A Date/ISO string is absolute; a plain number under 1e9 is “N seconds from now”.

CommonInput.staleAfter


optional state?: BlipState

CommonInput.state


optional subtitle?: string

One line of context: the current step, the question an agent is asking.

CommonInput.subtitle


title: string

CommonInput.title


optional upIsGood?: boolean

Whether an increase is good news. Defaults to true; set false for latency, error rate…


optional url?: string

Opened when the item itself is clicked.

CommonInput.url


value: TypedValue