Name a port apart from its message in the node panel, two lines per port
The port name follows the message until it is typed by hand, and clearing it follows again. The second line holds the message, so a list port's item type no longer squeezes the name.
This commit is contained in:
@@ -35,11 +35,20 @@ the canvas with its panel open.
|
|||||||
|
|
||||||
Floats on the right; a full-screen sheet on a phone.
|
Floats on the right; a full-screen sheet on a phone.
|
||||||
|
|
||||||
**Consumes** and **Provides** are the ports. Each row is a message name, a
|
**Consumes** and **Provides** are the ports. Each port has two lines: its name
|
||||||
payload type, and, on an output, a *streaming* toggle for ports that publish
|
and payload type (a `list` also says what its items are), then the message it
|
||||||
repeatedly during one execution. The name field suggests messages already in
|
is bound to, how often at most it is delivered, and, on an output, a
|
||||||
the flow, which is usually how you wire something: type the name that already
|
*streaming* toggle for ports that publish repeatedly during one execution. The
|
||||||
exists.
|
message field suggests messages already in the flow, which is usually how you
|
||||||
|
wire something: type the name that already exists.
|
||||||
|
|
||||||
|
A port is named after its message until you name it yourself. Its name field
|
||||||
|
then stays empty and shows the name it follows. A name typed there stays when
|
||||||
|
the message changes, which is how a port is bound to a message called
|
||||||
|
something else, as a [`wren`](../reference/node-types.md#wren) target is;
|
||||||
|
clear it to follow the message again. The name is what the node's code sees,
|
||||||
|
so it is letters, digits and `_`, not starting with a digit, and no two inputs
|
||||||
|
or two outputs of a node share one. The field keeps the name it had otherwise.
|
||||||
|
|
||||||
Renaming an output renames the message everywhere it is read. Inputs are not
|
Renaming an output renames the message everywhere it is read. Inputs are not
|
||||||
renamed, because an input is more often re-pointed at a different message than
|
renamed, because an input is more often re-pointed at a different message than
|
||||||
|
|||||||
@@ -321,10 +321,10 @@ that is not wired to the node.
|
|||||||
`heat`, `boost` for heating; `media`, `music`, `tv`; `shutter`, `blind`,
|
`heat`, `boost` for heating; `media`, `music`, `tv`; `shutter`, `blind`,
|
||||||
`cover`; `water`, `watering`, `sprinkler`
|
`cover`; `water`, `watering`, `sprinkler`
|
||||||
|
|
||||||
A port naming anything else is refused when the flow is built. The editor
|
A port naming anything else is refused when the flow is built. A port is
|
||||||
names a port after its message, so there a target's message carries the name;
|
named after its message unless it is given a name of its own, in the node
|
||||||
binding a port to a message named otherwise, as `{"name": "setpoint", "port":
|
panel's port name field or as `{"name": "setpoint", "port":
|
||||||
"living_room_setpoint"}`, takes the flow API.
|
"living_room_setpoint"}` through the flow API.
|
||||||
|
|
||||||
Targets of one area and kind are one device to the model, and each takes what
|
Targets of one area and kind are one device to the model, and each takes what
|
||||||
a call means for its type. A target's current value is the state the model
|
a call means for its type. A target's current value is the state the model
|
||||||
|
|||||||
@@ -1,5 +1,11 @@
|
|||||||
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query"
|
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query"
|
||||||
import { Activity, Maximize2, Minimize2, X } from "lucide-react"
|
import {
|
||||||
|
Activity,
|
||||||
|
CornerDownRight,
|
||||||
|
Maximize2,
|
||||||
|
Minimize2,
|
||||||
|
X,
|
||||||
|
} from "lucide-react"
|
||||||
import {
|
import {
|
||||||
type ComponentProps,
|
type ComponentProps,
|
||||||
lazy,
|
lazy,
|
||||||
@@ -244,6 +250,14 @@ function MessageNameInput({
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Why a port cannot be called `name`, or null when it can. */
|
||||||
|
function portProblem(name: string, others: string[]): string | null {
|
||||||
|
if (!IDENTIFIER.test(name))
|
||||||
|
return "A port name is letters, digits and _, and does not start with a digit."
|
||||||
|
if (others.includes(name)) return `Another port here is called ${name}.`
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
function PortList({
|
function PortList({
|
||||||
title,
|
title,
|
||||||
specs,
|
specs,
|
||||||
@@ -252,6 +266,7 @@ function PortList({
|
|||||||
suggestions,
|
suggestions,
|
||||||
onChange,
|
onChange,
|
||||||
onRenamed,
|
onRenamed,
|
||||||
|
onPortRenamed,
|
||||||
onRemoved,
|
onRemoved,
|
||||||
streamable = false,
|
streamable = false,
|
||||||
}: {
|
}: {
|
||||||
@@ -262,6 +277,8 @@ function PortList({
|
|||||||
suggestions: string[]
|
suggestions: string[]
|
||||||
onChange: (next: MessageSpec[]) => void
|
onChange: (next: MessageSpec[]) => void
|
||||||
onRenamed?: (previous: string, next: string) => void
|
onRenamed?: (previous: string, next: string) => void
|
||||||
|
/** A port taking another name, reported just before the list that has it. */
|
||||||
|
onPortRenamed?: (from: string, to: string) => void
|
||||||
/** The port about to be dropped, reported just before the shorter list. */
|
/** The port about to be dropped, reported just before the shorter list. */
|
||||||
onRemoved?: (spec: MessageSpec) => void
|
onRemoved?: (spec: MessageSpec) => void
|
||||||
/** Outputs only: a port a node publishes on repeatedly while it runs. */
|
/** Outputs only: a port a node publishes on repeatedly while it runs. */
|
||||||
@@ -269,6 +286,11 @@ function PortList({
|
|||||||
}) {
|
}) {
|
||||||
// The port just added, so its name field can take focus.
|
// The port just added, so its name field can take focus.
|
||||||
const [freshIndex, setFreshIndex] = useState<number | null>(null)
|
const [freshIndex, setFreshIndex] = useState<number | null>(null)
|
||||||
|
// A port name is kept once its field is left, so what is typed lives here
|
||||||
|
// until then. Only one field has focus at a time, so one draft is enough.
|
||||||
|
const [naming, setNaming] = useState<{ index: number; text: string } | null>(
|
||||||
|
null,
|
||||||
|
)
|
||||||
|
|
||||||
const update = (index: number, patch: Partial<MessageSpec>) => {
|
const update = (index: number, patch: Partial<MessageSpec>) => {
|
||||||
const next = specs.map((spec, i) =>
|
const next = specs.map((spec, i) =>
|
||||||
@@ -298,116 +320,162 @@ function PortList({
|
|||||||
<p className="text-sm text-muted-foreground">{emptyHint}</p>
|
<p className="text-sm text-muted-foreground">{emptyHint}</p>
|
||||||
) : null}
|
) : null}
|
||||||
|
|
||||||
{specs.map((spec, index) => (
|
{specs.map((spec, index) => {
|
||||||
// The curve reads as its own thing rather than as part of the row
|
// A port follows its message until it is named by hand; the field
|
||||||
// above it, so it gets a little air.
|
// then holds that name, and is empty while there is none.
|
||||||
<div key={`port-${index}`} className="grid min-w-0 gap-1.5">
|
const own = ownsName(spec) ? (spec.port ?? "") : ""
|
||||||
<div className="flex min-w-0 items-center gap-1.5">
|
const typed = naming?.index === index ? naming.text.trim() : null
|
||||||
<MessageNameInput
|
const problem = typed
|
||||||
value={spec.name ?? ""}
|
? portProblem(
|
||||||
suggestions={suggestions}
|
typed,
|
||||||
placeholder={`name in ${flow}`}
|
specs.filter((_, i) => i !== index).map(portName),
|
||||||
autoFocus={index === freshIndex}
|
)
|
||||||
onChange={(name) => update(index, { name, port: "" })}
|
: null
|
||||||
onRenamed={onRenamed}
|
return (
|
||||||
/>
|
// The curve reads as its own thing rather than as part of the row
|
||||||
<Select
|
// above it, so it gets a little air.
|
||||||
value={spec.dtype ?? "float"}
|
<div key={`port-${index}`} className="grid min-w-0 gap-1.5">
|
||||||
onValueChange={(value) =>
|
<div className="flex min-w-0 items-center gap-1.5">
|
||||||
update(index, { dtype: value as DType })
|
<Input
|
||||||
}
|
value={naming?.index === index ? naming.text : own}
|
||||||
>
|
placeholder={portName({ name: spec.name }) || "port"}
|
||||||
<SelectTrigger
|
aria-label="Port name"
|
||||||
className="!h-8 w-[104px] text-sm"
|
aria-invalid={Boolean(problem)}
|
||||||
aria-label="Type"
|
title="The name the node sees this port by. Empty follows the message."
|
||||||
>
|
className="h-8 flex-1 font-mono text-sm"
|
||||||
<SelectValue />
|
onChange={(event) =>
|
||||||
</SelectTrigger>
|
setNaming({ index, text: event.target.value })
|
||||||
<SelectContent>
|
}
|
||||||
{DTYPES.map((dtype) => (
|
onBlur={() => {
|
||||||
<SelectItem key={dtype} value={dtype}>
|
if (typed !== null && !problem && typed !== own) {
|
||||||
{dtype}
|
const to = typed || portName({ name: spec.name })
|
||||||
</SelectItem>
|
if (to !== portName(spec))
|
||||||
))}
|
onPortRenamed?.(portName(spec), to)
|
||||||
</SelectContent>
|
update(index, { port: typed })
|
||||||
</Select>
|
}
|
||||||
{spec.dtype === "list" ? (
|
setNaming(null)
|
||||||
|
}}
|
||||||
|
/>
|
||||||
<Select
|
<Select
|
||||||
value={spec.item ?? "record"}
|
value={spec.dtype ?? "float"}
|
||||||
onValueChange={(value) =>
|
onValueChange={(value) =>
|
||||||
update(index, { item: value as DType })
|
update(index, { dtype: value as DType })
|
||||||
}
|
}
|
||||||
>
|
>
|
||||||
<SelectTrigger
|
<SelectTrigger
|
||||||
className="!h-8 w-[92px] text-sm"
|
className="!h-8 w-[104px] text-sm"
|
||||||
aria-label="Item type"
|
aria-label="Type"
|
||||||
title="What each item of the list is"
|
|
||||||
>
|
>
|
||||||
<SelectValue />
|
<SelectValue />
|
||||||
</SelectTrigger>
|
</SelectTrigger>
|
||||||
<SelectContent>
|
<SelectContent>
|
||||||
{ITEM_DTYPES.map((dtype) => (
|
{DTYPES.map((dtype) => (
|
||||||
<SelectItem key={dtype} value={dtype}>
|
<SelectItem key={dtype} value={dtype}>
|
||||||
{dtype}
|
{dtype}
|
||||||
</SelectItem>
|
</SelectItem>
|
||||||
))}
|
))}
|
||||||
</SelectContent>
|
</SelectContent>
|
||||||
</Select>
|
</Select>
|
||||||
) : null}
|
{spec.dtype === "list" ? (
|
||||||
<Input
|
<Select
|
||||||
type="number"
|
value={spec.item ?? "record"}
|
||||||
min={0}
|
onValueChange={(value) =>
|
||||||
step="any"
|
update(index, { item: value as DType })
|
||||||
value={spec.interval ? String(spec.interval) : ""}
|
}
|
||||||
placeholder="∞"
|
>
|
||||||
aria-label="Deliver at most every n seconds"
|
<SelectTrigger
|
||||||
title="Deliver at most every n seconds; empty is every time"
|
className="!h-8 w-[92px] text-sm"
|
||||||
className="h-8 w-14 text-sm"
|
aria-label="Item type"
|
||||||
onChange={(event) =>
|
title="What each item of the list is"
|
||||||
update(index, { interval: Number(event.target.value) || 0 })
|
>
|
||||||
}
|
<SelectValue />
|
||||||
/>
|
</SelectTrigger>
|
||||||
{streamable ? (
|
<SelectContent>
|
||||||
|
{ITEM_DTYPES.map((dtype) => (
|
||||||
|
<SelectItem key={dtype} value={dtype}>
|
||||||
|
{dtype}
|
||||||
|
</SelectItem>
|
||||||
|
))}
|
||||||
|
</SelectContent>
|
||||||
|
</Select>
|
||||||
|
) : null}
|
||||||
<Button
|
<Button
|
||||||
variant={spec.stream ? "secondary" : "ghost"}
|
variant="ghost"
|
||||||
size="icon-sm"
|
size="icon-sm"
|
||||||
aria-label="Streaming output"
|
className="text-muted-foreground"
|
||||||
aria-pressed={spec.stream ?? false}
|
aria-label="Remove port"
|
||||||
title={
|
onClick={() => {
|
||||||
"Published repeatedly while the node runs: a curve rather than " +
|
onRemoved?.(spec)
|
||||||
"a result. A run keeps every value it takes."
|
onChange(specs.filter((_, i) => i !== index))
|
||||||
}
|
}}
|
||||||
className={cn(
|
|
||||||
"shrink-0",
|
|
||||||
!spec.stream && "text-muted-foreground",
|
|
||||||
)}
|
|
||||||
onClick={() => update(index, { stream: !spec.stream })}
|
|
||||||
>
|
>
|
||||||
<Activity />
|
<X />
|
||||||
</Button>
|
</Button>
|
||||||
|
</div>
|
||||||
|
<div className="flex min-w-0 items-center gap-1.5">
|
||||||
|
<CornerDownRight
|
||||||
|
aria-hidden
|
||||||
|
className="size-4 shrink-0 text-muted-foreground"
|
||||||
|
/>
|
||||||
|
<MessageNameInput
|
||||||
|
value={spec.name ?? ""}
|
||||||
|
suggestions={suggestions}
|
||||||
|
placeholder={`message in ${flow}`}
|
||||||
|
autoFocus={index === freshIndex}
|
||||||
|
onChange={(name) =>
|
||||||
|
update(index, {
|
||||||
|
name,
|
||||||
|
port: ownsName(spec) ? spec.port : "",
|
||||||
|
})
|
||||||
|
}
|
||||||
|
onRenamed={onRenamed}
|
||||||
|
/>
|
||||||
|
<Input
|
||||||
|
type="number"
|
||||||
|
min={0}
|
||||||
|
step="any"
|
||||||
|
value={spec.interval ? String(spec.interval) : ""}
|
||||||
|
placeholder="∞"
|
||||||
|
aria-label="Deliver at most every n seconds"
|
||||||
|
title="Deliver at most every n seconds; empty is every time"
|
||||||
|
className="h-8 w-14 text-sm"
|
||||||
|
onChange={(event) =>
|
||||||
|
update(index, { interval: Number(event.target.value) || 0 })
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
{streamable ? (
|
||||||
|
<Button
|
||||||
|
variant={spec.stream ? "secondary" : "ghost"}
|
||||||
|
size="icon-sm"
|
||||||
|
aria-label="Streaming output"
|
||||||
|
aria-pressed={spec.stream ?? false}
|
||||||
|
title={
|
||||||
|
"Published repeatedly while the node runs: a curve rather than " +
|
||||||
|
"a result. A run keeps every value it takes."
|
||||||
|
}
|
||||||
|
className={cn(
|
||||||
|
"shrink-0",
|
||||||
|
!spec.stream && "text-muted-foreground",
|
||||||
|
)}
|
||||||
|
onClick={() => update(index, { stream: !spec.stream })}
|
||||||
|
>
|
||||||
|
<Activity />
|
||||||
|
</Button>
|
||||||
|
) : null}
|
||||||
|
</div>
|
||||||
|
{problem ? (
|
||||||
|
<p className="text-xs text-destructive">{problem}</p>
|
||||||
|
) : null}
|
||||||
|
{spec.name ? (
|
||||||
|
<MessageSparkline
|
||||||
|
flow={flow}
|
||||||
|
name={spec.name}
|
||||||
|
dtype={spec.dtype ?? undefined}
|
||||||
|
/>
|
||||||
) : null}
|
) : null}
|
||||||
<Button
|
|
||||||
variant="ghost"
|
|
||||||
size="icon-sm"
|
|
||||||
className="text-muted-foreground"
|
|
||||||
aria-label="Remove port"
|
|
||||||
onClick={() => {
|
|
||||||
onRemoved?.(spec)
|
|
||||||
onChange(specs.filter((_, i) => i !== index))
|
|
||||||
}}
|
|
||||||
>
|
|
||||||
<X />
|
|
||||||
</Button>
|
|
||||||
</div>
|
</div>
|
||||||
{spec.name ? (
|
)
|
||||||
<MessageSparkline
|
})}
|
||||||
flow={flow}
|
|
||||||
name={spec.name}
|
|
||||||
dtype={spec.dtype ?? undefined}
|
|
||||||
/>
|
|
||||||
) : null}
|
|
||||||
</div>
|
|
||||||
))}
|
|
||||||
</div>
|
</div>
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
@@ -1129,6 +1197,13 @@ const SCAFFOLD_SHAPE = (() => {
|
|||||||
const portName = (spec: MessageSpec) =>
|
const portName = (spec: MessageSpec) =>
|
||||||
spec.port || (spec.name ?? "").split(".").pop() || ""
|
spec.port || (spec.name ?? "").split(".").pop() || ""
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether a port was named by hand rather than after its message. Nothing
|
||||||
|
* stores that: a port whose name is not the one its message gives it is one.
|
||||||
|
*/
|
||||||
|
const ownsName = (spec: MessageSpec) =>
|
||||||
|
Boolean(spec.port) && spec.port !== portName({ name: spec.name })
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* A `process` that takes this node's inputs and settings, and returns its
|
* A `process` that takes this node's inputs and settings, and returns its
|
||||||
* outputs.
|
* outputs.
|
||||||
@@ -1189,9 +1264,10 @@ function PanelBody({
|
|||||||
})
|
})
|
||||||
|
|
||||||
const [code, setCode] = useState<string | null>(null)
|
const [code, setCode] = useState<string | null>(null)
|
||||||
// The port the X is dropping, noted just before the shorter list arrives:
|
// The port the X is dropping or its name field renaming, noted just before
|
||||||
// both are one edit, and a second one would only overwrite the first.
|
// the list that says so arrives: both are one edit, and a second one would
|
||||||
const dropped = useRef<string | null>(null)
|
// only overwrite the first.
|
||||||
|
const portMove = useRef<[string, string | null] | null>(null)
|
||||||
const timer = useRef<ReturnType<typeof setTimeout> | null>(null)
|
const timer = useRef<ReturnType<typeof setTimeout> | null>(null)
|
||||||
const pending = useRef<string | null>(null)
|
const pending = useRef<string | null>(null)
|
||||||
const save = useRef(onSaveSource)
|
const save = useRef(onSaveSource)
|
||||||
@@ -1248,6 +1324,9 @@ function PanelBody({
|
|||||||
|
|
||||||
const renamePort = (previous: string, next: string) => {
|
const renamePort = (previous: string, next: string) => {
|
||||||
onRenameMessage(previous, next)
|
onRenameMessage(previous, next)
|
||||||
|
// A port named by hand keeps its name through a new message.
|
||||||
|
const spec = node.provides?.find((entry) => entry.name === next)
|
||||||
|
if (spec && ownsName(spec)) return
|
||||||
// Only a finished rename moves a value; per keystroke it would delete it
|
// Only a finished rename moves a value; per keystroke it would delete it
|
||||||
// on the first character typed.
|
// on the first character typed.
|
||||||
const moved = repoint(
|
const moved = repoint(
|
||||||
@@ -1309,16 +1388,19 @@ function PanelBody({
|
|||||||
emptyHint="Nothing yet. Add a message this node publishes."
|
emptyHint="Nothing yet. Add a message this node publishes."
|
||||||
suggestions={suggestions.provides}
|
suggestions={suggestions.provides}
|
||||||
onChange={(provides) => {
|
onChange={(provides) => {
|
||||||
const port = dropped.current
|
const [from, to] = portMove.current ?? ["", null]
|
||||||
dropped.current = null
|
portMove.current = null
|
||||||
editNode(repoint({ ...node, provides }, port ?? "", null))
|
editNode(repoint({ ...node, provides }, from, to))
|
||||||
}}
|
}}
|
||||||
streamable
|
streamable
|
||||||
// Only the publishing side names a message; an input is as often
|
// Only the publishing side names a message; an input is as often
|
||||||
// re-pointed at a different one as it is renamed.
|
// re-pointed at a different one as it is renamed.
|
||||||
onRenamed={renamePort}
|
onRenamed={renamePort}
|
||||||
|
onPortRenamed={(from, to) => {
|
||||||
|
portMove.current = [from, to]
|
||||||
|
}}
|
||||||
onRemoved={(spec) => {
|
onRemoved={(spec) => {
|
||||||
dropped.current = portName(spec)
|
portMove.current = [portName(spec), null]
|
||||||
}}
|
}}
|
||||||
/>
|
/>
|
||||||
<ParamsForm
|
<ParamsForm
|
||||||
|
|||||||
Reference in New Issue
Block a user