sanity-plugin-jev-fields 0.1.0 → 0.2.0

package/dist/index.js

@@ -39,7 +39,7 @@ function JevFormProvider({ config, children }) {
 }
 function useJevForm() {
 	let context = useContext(Context);
-	if (!context) throw Error("Jev signals need the jev() plugin in sanity.config.");
+	if (!context) throw Error("Jev questions need the jev() plugin in sanity.config.");
 	return context;
 }
 /**
@@ -137,12 +137,12 @@ function rangeViolation(value, rule, format) {
 	if (rule?.atLeast !== void 0 && value < rule.atLeast) return `below ${format(rule.atLeast)}`;
 	if (rule?.atMost !== void 0 && value > rule.atMost) return `above ${format(rule.atMost)}`;
 }
-/** Why a choice signal can't be asked, if it can't. */
-function choiceProblem(signal, options) {
-	if (options.length < 2) return "A choice signal needs at least two options.";
-	if (options.length > 255) return "A choice signal allows at most 255 options.";
+/** Why a choice question can't be asked, if it can't. */
+function choiceProblem(question, options) {
+	if (options.length < 2) return "A choice question needs at least two options.";
+	if (options.length > 255) return "A choice question allows at most 255 options.";
 	for (let level of ["warn", "require"]) {
-		let rule = signal[level];
+		let rule = question[level];
 		if (!rule) continue;
 		if (!Array.isArray(rule.oneOf) || rule.oneOf.length === 0) return `\`${level}.oneOf\` must list at least one option.`;
 		let unknown = rule.oneOf.find((option) => !options.includes(option));
@@ -150,9 +150,9 @@ function choiceProblem(signal, options) {
 	}
 }
 /** One option from a named set. @public */
-const choice = (signal) => ({
+const choice = (question) => ({
 	type: "choice",
-	...signal
+	...question
 }), choiceSchemaTypes = [defineType({
 	name: TYPE_NAMES.choiceProbability,
 	title: "Jev choice probability",
@@ -189,14 +189,14 @@ const choice = (signal) => ({
 		...bookkeepingFields
 	]
 })];
-function bindChoice(signal) {
-	let criteria = signal.criteria ?? {}, problem = choiceProblem(signal, Object.keys(criteria));
+function bindChoice(question) {
+	let criteria = question.criteria ?? {}, problem = choiceProblem(question, Object.keys(criteria));
 	return {
 		typeName: TYPE_NAMES.choice,
-		question: problem ? void 0 : {
+		gatewayQuestion: problem ? void 0 : {
 			type: "choice",
-			instructions: signal.instructions,
-			criteria: signal.criteria
+			instructions: question.instructions,
+			criteria: question.criteria
 		},
 		problem,
 		toStored(answer) {
@@ -235,17 +235,17 @@ function bindChoice(signal) {
 				},
 				tone: "default",
 				aside: meaning ? { note: meaning } : void 0,
-				body: <ChoiceBody signal={signal} choice={record.choice} probabilities={probabilities} />
+				body: <ChoiceBody question={question} choice={record.choice} probabilities={probabilities} />
 			};
 		},
 		check(level, stored, title) {
-			let record = storedOf(stored, TYPE_NAMES.choice), rule = signal[level];
+			let record = storedOf(stored, TYPE_NAMES.choice), rule = question[level];
 			if (record && typeof record.choice == "string" && rule?.oneOf && !rule.oneOf.includes(record.choice)) return `${title} is "${record.choice}", not ${rule.oneOf.map((option) => `"${option}"`).join(" or ")}.`;
 		}
 	};
 }
-function ChoiceBody({ signal, choice, probabilities }) {
-	let options = Object.keys(signal.criteria), nameWidth = `${Math.max(...options.map((name) => name.length), 4) + 2}ch`;
+function ChoiceBody({ question, choice, probabilities }) {
+	let options = Object.keys(question.criteria), nameWidth = `${Math.max(...options.map((name) => name.length), 4) + 2}ch`;
 	return <Stack gap={3}>
       {options.map((option) => {
 		let probability = probabilities.find((entry) => entry.option === option)?.probability ?? 0, winner = option === choice, percent = Math.round(probability * 100);
@@ -275,7 +275,7 @@ const JEV_NAMESPACE = "jev", jevLocaleBundle = defineLocaleResourceBundle({
 	resources: {
 		"strip.label": "Jev",
 		"strip.set-up": "Set up Jev",
-		"strip.evaluate-all": "Evaluate all signals now",
+		"strip.evaluate-all": "Evaluate all questions now",
 		"chip.empty": "–",
 		"chip.error": "Error",
 		"chip.out-of-date": "Out of date",
@@ -305,7 +305,7 @@ const JEV_NAMESPACE = "jev", jevLocaleBundle = defineLocaleResourceBundle({
 		"key-dialog.saving": "Saving…",
 		"key-dialog.save-failed": "Could not save the key: {{error}}",
 		"tool.title": "Jev",
-		"tool.intro": "Jev signals are answered by TypeSafe’s Jev model through Vercel AI Gateway.",
+		"tool.intro": "Jev questions are answered by TypeSafe’s Jev model through Vercel AI Gateway.",
 		"tool.key.heading": "AI Gateway API key",
 		"tool.key.status.config": "From plugin config",
 		"tool.key.status.checking": "Checking",
@@ -316,11 +316,11 @@ const JEV_NAMESPACE = "jev", jevLocaleBundle = defineLocaleResourceBundle({
 		"tool.key.ends-with": "Key ending in <Code>{{last4}}</Code>",
 		"tool.key.changed": "Last changed {{date}}",
 		"tool.key.checking": "Checking for a stored key…",
-		"tool.key.none": "No key is stored, so Jev signals cannot evaluate yet.",
+		"tool.key.none": "No key is stored, so Jev questions can’t be evaluated yet.",
 		"tool.key.set": "Set key",
 		"tool.key.change": "Change key",
 		"tool.key.remove": "Remove key",
-		"tool.key.remove-confirm": "Remove the key? Jev signals stop evaluating until a new one is set.",
+		"tool.key.remove-confirm": "Remove the key? Jev questions stop being evaluated until a new one is set.",
 		"tool.key.remove-cancel": "Cancel",
 		"tool.key.remove-confirm-button": "Remove",
 		"tool.key.remove-failed": "Could not remove the key: {{error}}",
@@ -330,9 +330,9 @@ const JEV_NAMESPACE = "jev", jevLocaleBundle = defineLocaleResourceBundle({
 		"tool.visibility.heading": "Who can see the key",
 		"tool.visibility.body": "The key is stored in this dataset in the document <Code>secrets.jev</Code>. It is not public, but anyone who can read the dataset can see it: every Studio user, and every API token with read access, such as a frontend’s read or preview token. It is also included in dataset exports and backups. Use a dedicated key with a spend limit. If editors and tokens must never see the key, set a <Code>transport</Code> that sends requests through your own server."
 	}
-}), noul = (signal) => ({
+}), noul = (question) => ({
 	type: "noul",
-	...signal
+	...question
 }), noulSchemaTypes = [defineType({
 	name: TYPE_NAMES.noul,
 	title: "Jev yes/no",
@@ -348,16 +348,16 @@ const JEV_NAMESPACE = "jev", jevLocaleBundle = defineLocaleResourceBundle({
 	caution: "medium",
 	positive: "high"
 };
-function bindNoul(signal) {
-	let problem = !signal.true?.trim() || !signal.false?.trim() ? "A noul signal needs both `true` and `false` text." : rangeRuleProblem(signal, 0, 1);
+function bindNoul(question) {
+	let problem = !question.true?.trim() || !question.false?.trim() ? "A noul question needs both `true` and `false` text." : rangeRuleProblem(question, 0, 1);
 	return {
 		typeName: TYPE_NAMES.noul,
-		question: problem ? void 0 : {
+		gatewayQuestion: problem ? void 0 : {
 			type: "boolean",
-			instructions: signal.instructions,
+			instructions: question.instructions,
 			criteria: {
-				true: signal.true,
-				false: signal.false
+				true: question.true,
+				false: question.false
 			}
 		},
 		problem,
@@ -386,38 +386,38 @@ function bindNoul(signal) {
 					level: LEVELS$1[tone] ?? "medium",
 					tone
 				},
-				body: <NoulBody signal={signal} probability={probability} />
+				body: <NoulBody question={question} probability={probability} />
 			};
 		},
 		check(level, stored, title) {
 			let record = storedOf(stored, TYPE_NAMES.noul);
 			if (!record || typeof record.probability != "number") return;
-			let percent = (value) => `${Math.round(value * 100)}%`, broken = rangeViolation(record.probability, signal[level], percent);
+			let percent = (value) => `${Math.round(value * 100)}%`, broken = rangeViolation(record.probability, question[level], percent);
 			return broken && `${title} is ${percent(record.probability)}, ${broken}.`;
 		}
 	};
 }
-function NoulBody({ signal, probability }) {
+function NoulBody({ question, probability }) {
 	let { t } = useTranslation("jev"), percent = Math.round(probability * 100);
 	return <Stack gap={4}>
       <Flex align="baseline" gap={2}>
         <Text size={4} weight="medium">
           {percent}%
         </Text>
-        {signal.label && <Text size={1} muted>
-            {signal.label}
+        {question.label && <Text size={1} muted>
+            {question.label}
           </Text>}
       </Flex>
-      <Bar fraction={probability} color={trafficColor(probability)} label={`${signal.title ?? t("noul.yes")}: ${percent}%`} />
+      <Bar fraction={probability} color={trafficColor(probability)} label={`${question.title ?? t("noul.yes")}: ${percent}%`} />
       <Text size={1} muted>
-        {probability >= .5 ? signal.true : signal.false}
+        {probability >= .5 ? question.true : question.false}
       </Text>
     </Stack>;
 }
 /** A position on an ordered scale. @public */
-const score = (signal) => ({
+const score = (question) => ({
 	type: "score",
-	...signal
+	...question
 }), scoreSchemaTypes = [defineType({
 	name: TYPE_NAMES.score,
 	title: "Jev score",
@@ -461,24 +461,24 @@ function segmentFills(score, count) {
 	return Array.from({ length: count }, (_, index) => Math.min(1, Math.max(0, score - index + 1)));
 }
 /** Colour and tone of a score, from the criterion it is nearest to. */
-function scoreLook(signal, value, max) {
-	if (signal.colors === "neutral") return {
+function scoreLook(question, value, max) {
+	if (question.colors === "neutral") return {
 		color: NEUTRAL_COLOR,
 		tone: "primary"
 	};
-	let fraction = max > 0 ? Math.round(value) / max : 0, good = signal.colors === "reverse" ? 1 - fraction : fraction;
+	let fraction = max > 0 ? Math.round(value) / max : 0, good = question.colors === "reverse" ? 1 - fraction : fraction;
 	return {
 		color: trafficColor(good),
 		tone: trafficTone(good)
 	};
 }
-function bindScore(signal) {
-	let { criteria } = signal, problem = !Array.isArray(criteria) || criteria.length < 2 ? "A score signal needs at least two criteria." : criteria.length > 10 ? "A score signal allows at most ten criteria." : rangeRuleProblem(signal, 0, criteria.length - 1);
+function bindScore(question) {
+	let { criteria } = question, problem = !Array.isArray(criteria) || criteria.length < 2 ? "A score question needs at least two criteria." : criteria.length > 10 ? "A score question allows at most ten criteria." : rangeRuleProblem(question, 0, criteria.length - 1);
 	return {
 		typeName: TYPE_NAMES.score,
-		question: problem ? void 0 : {
+		gatewayQuestion: problem ? void 0 : {
 			type: "score",
-			instructions: signal.instructions,
+			instructions: question.instructions,
 			criteria
 		},
 		problem,
@@ -496,7 +496,7 @@ function bindScore(signal) {
 		read(stored) {
 			let record = storedOf(stored, TYPE_NAMES.score);
 			if (!record || typeof record.score != "number" || typeof record.max != "number") return;
-			let { score: value, max } = record, label = text(record.label), look = scoreLook(signal, value, max);
+			let { score: value, max } = record, label = text(record.label), look = scoreLook(question, value, max);
 			return {
 				value: {
 					...bookkeepingOf(record),
@@ -515,7 +515,7 @@ function bindScore(signal) {
 					badge: capitalize(label ?? shortLabel(criteria?.[Math.round(value)])),
 					tone: look.tone
 				},
-				body: <ScoreBody signal={signal} score={value} max={max} color={look.color} />
+				body: <ScoreBody question={question} score={value} max={max} color={look.color} />
 			};
 		},
 		check(level, stored, title) {
@@ -524,16 +524,16 @@ function bindScore(signal) {
 			let describe = (position) => {
 				let label = shortLabel(criteria[Math.round(position)]), number = Number.isInteger(position) ? String(position) : position.toFixed(1);
 				return label ? `${number} (${label})` : number;
-			}, broken = rangeViolation(record.score, signal[level], describe);
+			}, broken = rangeViolation(record.score, question[level], describe);
 			return broken && `${title} is ${describe(record.score)}, ${broken}.`;
 		}
 	};
 }
-function ScoreBody({ signal, score, max, color }) {
-	let { t } = useTranslation("jev"), nearest = Math.round(score), fills = segmentFills(score, signal.criteria.length), next = signal.criteria[nearest + 1];
+function ScoreBody({ question, score, max, color }) {
+	let { t } = useTranslation("jev"), nearest = Math.round(score), fills = segmentFills(score, question.criteria.length), next = question.criteria[nearest + 1];
 	return <Stack gap={4}>
       <Flex gap={1}>
-        {signal.criteria.map((criterion, index) => <Stack key={index} gap={2} flex={1}>
+        {question.criteria.map((criterion, index) => <Stack key={index} gap={2} flex={1}>
             <Bar fraction={fills[index]} color={color} label={`${index}: ${shortLabel(criterion)}`} />
             <Text size={1} weight={index === nearest ? "medium" : "regular"} muted={index > nearest} style={index < nearest ? { color } : void 0} textOverflow="ellipsis">
               {index} · {capitalize(shortLabel(criterion))}
@@ -542,7 +542,7 @@ function ScoreBody({ signal, score, max, color }) {
       </Flex>
       <Text size={1} muted>
         {t("score.summary", {
-		meaning: capitalize(meaningOf(signal.criteria[nearest])),
+		meaning: capitalize(meaningOf(question.criteria[nearest])),
 		score: score.toFixed(1),
 		max
 	})}
@@ -556,23 +556,23 @@ const KIND_SCHEMA_TYPES = [
 	...scoreSchemaTypes,
 	...choiceSchemaTypes
 ];
-/** Binds a signal to its kind. The one place that tells Noul, Score and Choice apart. */
-function kindOf(signal) {
-	let kind = bind(signal);
-	return signal.instructions?.trim() ? kind : {
+/** Binds a question to its kind. The one place that tells Noul, Score and Choice apart. */
+function kindOf(question) {
+	let kind = bind(question);
+	return question.instructions?.trim() ? kind : {
 		...kind,
-		question: void 0,
-		problem: "Add instructions to this signal."
+		gatewayQuestion: void 0,
+		problem: "Add instructions to this question."
 	};
 }
-function bind(signal) {
-	switch (signal.type) {
-		case "noul": return bindNoul(signal);
-		case "score": return bindScore(signal);
-		case "choice": return bindChoice(signal);
+function bind(question) {
+	switch (question.type) {
+		case "noul": return bindNoul(question);
+		case "score": return bindScore(question);
+		case "choice": return bindChoice(question);
 		default: return {
 			typeName: "unknown",
-			problem: "Unknown signal type.",
+			problem: "Unknown question type.",
 			toStored: mismatch,
 			read: () => void 0,
 			check: () => void 0
@@ -580,19 +580,19 @@ function bind(signal) {
 	}
 }
 /** `readable` → `Readable`, `readingLevel` → `Reading level`. */
-function titleOf(key, signal) {
-	if (signal.title) return signal.title;
+function titleOf(key, question) {
+	if (question.title) return question.title;
 	let words = key.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ");
 	return words.charAt(0).toUpperCase() + words.slice(1).toLowerCase();
 }
 const isRecord = (value) => !!value && typeof value == "object" && !Array.isArray(value);
-function signalsOf(definition) {
+function questionsOf(definition) {
 	if (!isRecord(definition) || !isRecord(definition.options)) return;
 	let { jev } = definition.options;
 	return isRecord(jev) ? jev : void 0;
 }
 /**
-* Adds a field that stores each signal's answer next to every field with `options.jev`.
+* Adds a field that stores each question's answer next to every field with `options.jev`.
 * Plugins can't see the Studio's own schema types, so wrap them in `sanity.config`:
 *
 * ```ts
@@ -612,8 +612,8 @@ function withAnswerFields(definition) {
 		of: definition.of.map(withAnswerFields)
 	}), Array.isArray(definition.fields)) {
 		let existing = new Map(definition.fields.filter(isRecord).map((field) => [field.name, field.type])), fields = definition.fields.flatMap((field) => {
-			let rewritten = withAnswerFields(field), signals = signalsOf(field);
-			return !signals || !isRecord(field) || !isRecord(rewritten) ? [rewritten] : [withRules(rewritten, signals), ...answerFieldsFor(field, signals, existing)];
+			let rewritten = withAnswerFields(field), questions = questionsOf(field);
+			return !questions || !isRecord(field) || !isRecord(rewritten) ? [rewritten] : [withRules(rewritten, questions), ...answerFieldsFor(field, questions, existing)];
 		});
 		result = {
 			...result,
@@ -622,14 +622,14 @@ function withAnswerFields(definition) {
 	}
 	return result;
 }
-function answerFieldsFor(field, signals, existing) {
-	return Object.entries(signals).flatMap(([key, signal]) => {
-		let type = TYPE_NAMES[signal.type];
+function answerFieldsFor(field, questions, existing) {
+	return Object.entries(questions).flatMap(([key, question]) => {
+		let type = TYPE_NAMES[question.type];
 		if (existing.get(key) === type) return [];
-		if (existing.has(key)) throw Error(`Jev: the signal "${key}" on "${String(field.name)}" needs a field called "${key}" to store its answer, but that name is already taken. Rename the signal.`);
+		if (existing.has(key)) throw Error(`Jev: the question "${key}" on "${String(field.name)}" needs a field called "${key}" to store its answer, but that name is already taken. Rename the question.`);
 		return existing.set(key, type), [defineField({
 			name: key,
-			title: titleOf(key, signal),
+			title: titleOf(key, question),
 			type,
 			group: typeof field.group == "string" || Array.isArray(field.group) ? field.group : void 0,
 			fieldset: typeof field.fieldset == "string" ? field.fieldset : void 0
@@ -638,14 +638,14 @@ function answerFieldsFor(field, signals, existing) {
 }
 const LEVELS = ["warn", "require"];
 /**
-* Adds a validation rule to the attached field for each signal's `warn` and `require`, after
+* Adds a validation rule to the attached field for each question's `warn` and `require`, after
 * the field's own validation. Rules judge the stored answer, so they say nothing until there is
 * one.
 */
-function withRules(field, signals) {
-	let checks = Object.entries(signals).flatMap(([key, signal]) => LEVELS.filter((level) => signal[level]).map((level) => ({
+function withRules(field, questions) {
+	let checks = Object.entries(questions).flatMap(([key, question]) => LEVELS.filter((level) => question[level]).map((level) => ({
 		key,
-		signal,
+		question,
 		level
 	})));
 	if (checks.length === 0) return field;
@@ -653,8 +653,8 @@ function withRules(field, signals) {
 		let ownRules = (Array.isArray(own) ? own : own ? [own] : []).flatMap((entry) => {
 			let result = typeof entry == "function" ? entry(rule) : entry;
 			return Array.isArray(result) ? result : result ? [result] : [];
-		}), jevRules = checks.map(({ key, signal, level }) => {
-			let kind = kindOf(signal), title = titleOf(key, signal), custom = rule.custom((_value, context) => {
+		}), jevRules = checks.map(({ key, question, level }) => {
+			let kind = kindOf(question), title = titleOf(key, question), custom = rule.custom((_value, context) => {
 				let stored = isRecord(context.parent) ? context.parent[key] : void 0;
 				return kind.check(level, stored, title) ?? !0;
 			});
@@ -768,12 +768,12 @@ const pulse = keyframes`
   background: ${({ $color }) => $color};
   animation: ${({ $pulse }) => $pulse ? pulse : "none"} 1s ease-in-out infinite;
 `;
-function Chip({ signal, selected, onSelect }) {
-	let { t } = useTranslation("jev"), { text, color } = signal.reading?.chip ?? {
+function Chip({ question, selected, onSelect }) {
+	let { t } = useTranslation("jev"), { text, color } = question.reading?.chip ?? {
 		text: t("chip.empty"),
 		color: void 0
-	}, failed = !!signal.error || !!signal.problem;
-	return <Card as="button" type="button" radius={2} paddingX={2} paddingY={2} onClick={onSelect} aria-pressed={selected} title={signal.stale ? t("chip.out-of-date") : void 0} style={{
+	}, failed = !!question.error || !!question.problem;
+	return <Card as="button" type="button" radius={2} paddingX={2} paddingY={2} onClick={onSelect} aria-pressed={selected} title={question.stale ? t("chip.out-of-date") : void 0} style={{
 		display: "inline-flex",
 		flex: "none",
 		width: "auto",
@@ -782,15 +782,15 @@ function Chip({ signal, selected, onSelect }) {
 		background: selected ? "rgba(128, 128, 128, 0.16)" : void 0
 	}}>
       <Flex align="center" gap={2}>
-        <Dot aria-hidden $color={failed ? "#f03e2f" : color ?? "hsl(215 12% 55%)"} $pulse={signal.loading} />
+        <Dot aria-hidden $color={failed ? "#f03e2f" : color ?? "hsl(215 12% 55%)"} $pulse={question.loading} />
         {}
         <Text size={1}>
-          {signal.title}
+          {question.title}
           <span style={{
 		marginLeft: "0.6em",
 		fontFamily: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
 		color: failed ? "#f03e2f" : color,
-		opacity: signal.stale ? .5 : 1
+		opacity: question.stale ? .5 : 1
 	}}>
             {failed ? t("chip.error") : text}
           </span>
@@ -798,8 +798,8 @@ function Chip({ signal, selected, onSelect }) {
       </Flex>
     </Card>;
 }
-/** The row of signal chips under an attached field. */
-function SignalStrip({ signals, selected, onSelect, setup, canRun, loading, onRunAll, onSetUp }) {
+/** The row of question chips under an attached field. */
+function QuestionStrip({ questions, selected, onSelect, setup, canRun, loading, onRunAll, onSetUp }) {
 	let { t } = useTranslation("jev");
 	return <Card border padding={1} style={{
 		borderTop: 0,
@@ -809,7 +809,7 @@ function SignalStrip({ signals, selected, onSelect, setup, canRun, loading, onRu
 	}}>
       <Flex align="center" gap={2}>
         <Flex flex={1} align="center" gap={1} wrap="wrap">
-          {signals.map((signal) => <Chip key={signal.key} signal={signal} selected={selected === signal.key} onSelect={() => onSelect(selected === signal.key ? null : signal.key)} />)}
+          {questions.map((question) => <Chip key={question.key} question={question} selected={selected === question.key} onSelect={() => onSelect(selected === question.key ? null : question.key)} />)}
         </Flex>
         {setup === "missing" ? <Button text={t("strip.set-up")} mode="ghost" tone="primary" fontSize={1} padding={2} onClick={onSetUp} /> : <Flex align="center" gap={1}>
             <Text size={0} muted>
@@ -823,32 +823,32 @@ function SignalStrip({ signals, selected, onSelect, setup, canRun, loading, onRu
     </Card>;
 }
 /** Expanded view of the selected chip. */
-function SignalDetail({ signal, empty, onRetry, onUpdateKey }) {
-	let { t } = useTranslation("jev"), { reading } = signal, body = signal.problem ? <Text size={1}>{signal.problem}</Text> : reading ? reading.body : <Text size={1} muted>
+function QuestionDetail({ question, empty, onRetry, onUpdateKey }) {
+	let { t } = useTranslation("jev"), { reading } = question, body = question.problem ? <Text size={1}>{question.problem}</Text> : reading ? reading.body : <Text size={1} muted>
       {t(empty ? "detail.empty-field" : "detail.not-evaluated")}
     </Text>, aside = reading?.aside ? "badge" in reading.aside ? <Badge tone={reading.aside.tone}>{reading.aside.badge}</Badge> : "level" in reading.aside ? <Badge tone={reading.aside.tone}>{t(`noul.level.${reading.aside.level}`)}</Badge> : <Text size={1} muted>
       {reading.aside.note}
     </Text> : null;
-	return <Card padding={4} radius={2} border tone={signal.problem ? "critical" : reading?.tone ?? "default"}>
+	return <Card padding={4} radius={2} border tone={question.problem ? "critical" : reading?.tone ?? "default"}>
       <Stack gap={4}>
         <Flex align="center" gap={3}>
           <Box flex={1}>
             <Text size={1} weight="semibold">
-              {signal.title}
+              {question.title}
             </Text>
           </Box>
           {aside}
         </Flex>
         {body}
-        {signal.stale && !signal.loading && <Text size={0} muted>
+        {question.stale && !question.loading && <Text size={0} muted>
             {t("detail.out-of-date")}
           </Text>}
-        {signal.error && <Card padding={3} radius={2} tone="critical" border>
+        {question.error && <Card padding={3} radius={2} tone="critical" border>
             <Flex align="center" gap={3} wrap="wrap">
               <Box flex={1}>
-                <Text size={1}>{errorText(t, signal.error)}</Text>
+                <Text size={1}>{errorText(t, question.error)}</Text>
               </Box>
-              {signal.keyRejected && onUpdateKey ? <Button text={t("detail.update-key")} mode="ghost" fontSize={1} onClick={onUpdateKey} /> : <Button text={t("detail.try-again")} mode="ghost" fontSize={1} onClick={onRetry} />}
+              {question.keyRejected && onUpdateKey ? <Button text={t("detail.update-key")} mode="ghost" fontSize={1} onClick={onUpdateKey} /> : <Button text={t("detail.try-again")} mode="ghost" fontSize={1} onClick={onRetry} />}
             </Flex>
           </Card>}
       </Stack>
@@ -972,13 +972,13 @@ const realClock = {
 		return () => clearTimeout(timeout);
 	}
 }, EMPTY = {
-	signals: [],
+	questions: [],
 	canRun: !1,
 	empty: !0,
 	loading: !1
 };
 /**
-* The Evaluation lifecycle of the signals on one attached field. Signals evaluate on their own
+* The Evaluation lifecycle of the questions on one attached field. Questions evaluate on their own
 * shortly after a local edit, only while the field's state is one this Studio produced; work for
 * a fingerprint that has since changed is cancelled and its answer dropped.
 */
@@ -986,16 +986,16 @@ function createLifecycle(clock = realClock) {
 	let inputs, entries = [], localState, expectLocal = !1, requests = /* @__PURE__ */ new Map(), statuses = /* @__PURE__ */ new Map(), attempted = /* @__PURE__ */ new Map(), scheduled, snapshot = EMPTY, dirty = !0, listeners = /* @__PURE__ */ new Set(), canRun = (current) => !!current.transport && !current.readOnly && current.state.trim() !== "";
 	function update(next) {
 		let previous = inputs;
-		inputs = next, next.state !== previous?.state && (localState = expectLocal ? next.state : void 0, expectLocal = !1), (!previous || next.signals !== previous.signals || next.state !== previous.state || next.model !== previous.model) && (entries = Object.entries(next.signals).map(([key, signal]) => {
-			let kind = kindOf(signal);
+		inputs = next, next.state !== previous?.state && (localState = expectLocal ? next.state : void 0, expectLocal = !1), (!previous || next.questions !== previous.questions || next.state !== previous.state || next.model !== previous.model) && (entries = Object.entries(next.questions).map(([key, question]) => {
+			let kind = kindOf(question);
 			return {
 				key,
-				signal,
+				question,
 				kind,
-				title: titleOf(key, signal),
+				title: titleOf(key, question),
 				hash: fingerprint([
 					next.state,
-					kind.question ?? null,
+					kind.gatewayQuestion ?? null,
 					next.model
 				])
 			};
@@ -1007,11 +1007,11 @@ function createLifecycle(clock = realClock) {
 		for (let [key, status] of statuses) hashes.get(key) !== status.hash && statuses.delete(key);
 		for (let [key, hash] of attempted) hashes.get(key) !== hash && attempted.delete(key);
 	}
-	/** Signals that would evaluate on their own: unanswered or stale, and not tried yet. */
+	/** Questions that would evaluate on their own: unanswered or stale, and not tried yet. */
 	function pendingKeys(current, views) {
 		return !canRun(current) || localState !== current.state ? [] : entries.filter((entry, index) => {
 			let view = views[index];
-			return entry.kind.question && (!view.reading || view.stale) && attempted.get(entry.key) !== entry.hash;
+			return entry.kind.gatewayQuestion && (!view.reading || view.stale) && attempted.get(entry.key) !== entry.hash;
 		}).map(({ key }) => key);
 	}
 	/** Rebuilds the snapshot and the debounce after anything they depend on changed. */
@@ -1023,7 +1023,7 @@ function createLifecycle(clock = realClock) {
 			let reading = entry.kind.read(current.answers[entry.key]), status = statuses.get(entry.key);
 			return {
 				key: entry.key,
-				signal: entry.signal,
+				question: entry.question,
 				title: entry.title,
 				problem: entry.kind.problem,
 				reading,
@@ -1035,7 +1035,7 @@ function createLifecycle(clock = realClock) {
 		}), pending = pendingKeys(current, views);
 		for (let view of views) pending.includes(view.key) && (view.loading = !0);
 		snapshot = {
-			signals: views,
+			questions: views,
 			canRun: canRun(current),
 			empty: current.state.trim() === "",
 			loading: views.some((view) => view.loading)
@@ -1057,8 +1057,8 @@ function createLifecycle(clock = realClock) {
 		if (!current?.transport || !canRun(current)) return;
 		let { transport, model, state } = current;
 		for (let entry of entries) {
-			let question = entry.kind.question;
-			if (keys && !keys.includes(entry.key) || !question) continue;
+			let gatewayQuestion = entry.kind.gatewayQuestion;
+			if (keys && !keys.includes(entry.key) || !gatewayQuestion) continue;
 			requests.get(entry.key)?.controller.abort();
 			let controller = new AbortController();
 			requests.set(entry.key, {
@@ -1074,7 +1074,7 @@ function createLifecycle(clock = realClock) {
 						transport,
 						model,
 						state,
-						question,
+						question: gatewayQuestion,
 						tags: [...current.tags, tag],
 						signal: controller.signal
 					});
@@ -1123,7 +1123,7 @@ function createLifecycle(clock = realClock) {
 }
 const NO_ANSWERS = {};
 /** Connects the Evaluation lifecycle of one attached field to the Studio's form. */
-function useSignals({ signals, path, state, readOnly }) {
+function useQuestions({ questions, path, state, readOnly }) {
 	let { config, writers } = useJevForm(), parentPath = useMemo(() => path.slice(0, -1), [path]), keySource = useKeySource(config), apiKey = keySource.apiKey, transport = useMemo(() => config.transport ?? (apiKey ? gatewayTransport(apiKey, config.endpoint) : void 0), [
 		config.transport,
 		apiKey,
@@ -1135,7 +1135,7 @@ function useSignals({ signals, path, state, readOnly }) {
 	}, [writers, parentPath]), tagPath = useMemo(() => [typeof documentType == "string" ? documentType : "", ...parentPath.map((segment) => typeof segment == "string" ? segment : "[]")], [documentType, parentPath]), [lifecycle] = useState(() => createLifecycle());
 	return useLayoutEffect(() => {
 		lifecycle.update({
-			signals,
+			questions,
 			state,
 			answers: isRecord$1(parent) ? parent : NO_ANSWERS,
 			transport,
@@ -1156,10 +1156,10 @@ function useSignals({ signals, path, state, readOnly }) {
 		localEdit: lifecycle.localEdit
 	};
 }
-/** Renders a field with `options.jev` as usual, with its signal strip and details below. */
-function AttachedInput({ signals, ...props }) {
-	let { t } = useTranslation("jev"), parentOnChange = props.onChange, { value } = props, state = toText(value), jev = useSignals({
-		signals,
+/** Renders a field with `options.jev` as usual, with its question strip and details below. */
+function AttachedInput({ questions, ...props }) {
+	let { t } = useTranslation("jev"), parentOnChange = props.onChange, { value } = props, state = toText(value), jev = useQuestions({
+		questions,
 		path: props.path,
 		state,
 		readOnly: !!props.readOnly
@@ -1168,11 +1168,11 @@ function AttachedInput({ signals, ...props }) {
 	}, inputProps = {
 		...props,
 		onChange
-	}, [selected, setSelected] = useState(null), [keyDialogOpen, setKeyDialogOpen] = useState(!1), selectedSignal = jev.signals.find((signal) => signal.key === selected);
+	}, [selected, setSelected] = useState(null), [keyDialogOpen, setKeyDialogOpen] = useState(!1), selectedQuestion = jev.questions.find((question) => question.key === selected);
 	return <Stack gap={2}>
       <div>
         {props.renderDefault(inputProps)}
-        <SignalStrip signals={jev.signals} selected={selected} onSelect={setSelected} setup={jev.setup} canRun={jev.canRun} loading={jev.loading} onRunAll={jev.runAll} onSetUp={() => setKeyDialogOpen(!0)} />
+        <QuestionStrip questions={jev.questions} selected={selected} onSelect={setSelected} setup={jev.setup} canRun={jev.canRun} loading={jev.loading} onRunAll={jev.runAll} onSetUp={() => setKeyDialogOpen(!0)} />
       </div>
       {nearTokenLimit(state) && <Card padding={3} radius={2} tone="caution" border>
           <Text size={1}>
@@ -1182,7 +1182,7 @@ function AttachedInput({ signals, ...props }) {
 	})}
           </Text>
         </Card>}
-      {selectedSignal && <SignalDetail signal={selectedSignal} empty={jev.empty} onRetry={() => jev.run(selectedSignal.key)} onUpdateKey={jev.keyInSecrets ? () => setKeyDialogOpen(!0) : void 0} />}
+      {selectedQuestion && <QuestionDetail question={selectedQuestion} empty={jev.empty} onRetry={() => jev.run(selectedQuestion.key)} onUpdateKey={jev.keyInSecrets ? () => setKeyDialogOpen(!0) : void 0} />}
       {keyDialogOpen && <JevKeyDialog onClose={() => setKeyDialogOpen(!1)} />}
     </Stack>;
 }
@@ -1190,7 +1190,7 @@ const Code = ({ children }) => <code>{children}</code>, CONNECTION_TEST = kindOf
 	instructions: "Is this text a connection test?",
 	true: "It is a test",
 	false: "It is not a test"
-})).question, asSignalError = (error) => error instanceof JevError ? {
+})).gatewayQuestion, asQuestionError = (error) => error instanceof JevError ? {
 	message: error.message,
 	kind: error.kind,
 	status: error.status,
@@ -1217,7 +1217,7 @@ function JevTool({ config }) {
 			} catch (error) {
 				setTest({
 					state: "failed",
-					error: asSignalError(error)
+					error: asQuestionError(error)
 				});
 			}
 		}
@@ -1311,7 +1311,7 @@ function KeyStatus({ fromConfig, loading, stored }) {
 	return fromConfig ? <Badge tone="primary">{t("tool.key.status.config")}</Badge> : loading ? <Badge>{t("tool.key.status.checking")}</Badge> : stored ? <Badge tone="positive">{t("tool.key.status.set")}</Badge> : <Badge tone="caution">{t("tool.key.status.not-set")}</Badge>;
 }
 /**
-* Jev signals for Sanity Studio: yes/no, score and choice questions attached to a field with
+* Jev questions for Sanity Studio: yes/no, score and choice questions attached to a field with
 * `options.jev`, answered by TypeSafe's Jev model through Vercel AI Gateway. Pair it with
 * `withJevAnswers(schemaTypes)` in `schema.types`.
 * @public
@@ -1328,8 +1328,8 @@ const jev = definePlugin((config) => {
 		}],
 		form: { components: { input: (props) => {
 			if (props.path.length === 0) return <JevFormProvider config={pluginConfig}>{props.renderDefault(props)}</JevFormProvider>;
-			let signals = signalsOf(props.schemaType);
-			return signals ? <AttachedInput {...props} signals={signals} /> : props.renderDefault(props);
+			let questions = questionsOf(props.schemaType);
+			return questions ? <AttachedInput {...props} questions={questions} /> : props.renderDefault(props);
 		} } },
 		schema: { types: KIND_SCHEMA_TYPES },
 		i18n: { bundles: [jevLocaleBundle] }