@invana/blocks 0.0.32 → 0.0.33

package/dist/index.d.cts

@@ -754,6 +754,13 @@ interface MultistepOptions {
     /** Show the answers for a last look, each with Edit, before they are sent. */
     review?: boolean;
 }
+/** One choice of a form field's `select` or `radio`. */
+interface FormOption {
+    value: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}
 interface FormOptions extends AskText {
     /**
      * `side` sets each label in a column at the left; `top` sets it over its
@@ -764,9 +771,28 @@ interface FormOptions extends AskText {
     fields: {
         name: string;
         label: string;
-        type: "number" | "text" | "date" | "select";
+        /**
+         * `textarea` is several lines of text; `checkbox` a yes/no with its label
+         * beside the box; `radio` one of `options` drawn as a list, `select` one
+         * of them in a menu.
+         */
+        type: "number" | "text" | "date" | "select" | "textarea" | "checkbox" | "radio";
         unit?: string;
-        default?: string | number;
+        /** A `checkbox` takes `true`/`false`; `select` and `radio` an option's `value`. */
+        default?: string | number | boolean;
+        /**
+         * The choices of a `select` or `radio`. A `description` is a muted line
+         * under a radio's label; a `disabled` choice shows but can't be picked.
+         */
+        options?: FormOption[];
+        /** A `textarea`'s visible lines. */
+        rows?: number;
+        /** Text shown in an empty `text` or `textarea`. */
+        placeholder?: string;
+        /** Must be answered — for a `checkbox`, ticked. Holds the submit back until it is. */
+        required?: boolean;
+        /** Shown with its value but not changeable; the value is still sent. */
+        disabled?: boolean;
         /** Shown beside the value — `quoted 14 d`. */
         aside?: string;
         /** A line under the field — `From last year's promotions`. */
@@ -2043,7 +2069,9 @@ declare function FilesBlock({ spec, onAction }: BlockProps<"files">): React.JSX.
  * set — scenario inputs. The fields render through the form generator: with
  * `labels: "side"` in a column on the left, with `"top"` over each field, two
  * to a row where the card is wide enough; a field's `group` sets it under a
- * small caps name. A number out of its `above`/`below` bounds says so under
+ * small caps name. A `textarea` and a list of described `radio` choices take
+ * the row; a `checkbox` sits beside its label. A number out of its
+ * `above`/`below` bounds, or a `required` field left empty, says so under
  * itself and holds the submit back. The submit sends a `reply` keyed by field
  * name.
  *
@@ -2242,4 +2270,4 @@ declare function TimeseriesBlock({ spec }: BlockProps<"timeseries">): React.JSX.
  */
 declare function TraceBlock({ spec, onAction }: BlockProps<"trace">): React.JSX.Element;
 
-export { ANSWER_KINDS, ASK_KINDS, type ActionOption, ActionRow, ActivityBlock, type ActivityLane, type ActivityOptions, type ActivityPin, type AnswerKind, type AnswerOptionsByKind, type ApprovalOptions, type AskKind, type AskOptionsByKind, type AskSpec, type AskState, type AskText, type AskValueByKind, BADGE_TONE, BLOCKS, BLOCK_RENDERERS, BarsBlock, Block, type BlockComponentProps, type BlockKind, type BlockOptionsByKind, type BlockPatch, BlockPatchError, type BlockPatchOp, type BlockProps, type BlockRenderers, type BlockSpec, CAPTION_TONE, CannotBlock, type CannotOptions, CaveatBlock, type CaveatNoteOptions, type CaveatOptions, type CaveatTone, type Cell, type ChoiceFigure, type ChoiceOption, type CitationSource, CitationsBlock, type CitationsBlockProps, type CitationsOptions, type Column, ConfirmAsk, ConfirmCard, type ConfirmCardProps, type ConfirmCost, type ConfirmOptions, type CostFigure, type EntityOptions, type EventSourceOptions, type Figure, type FileItem, FilesBlock, type ForkOptions, FormAsk, type FormOptions, GanttBlock, type GanttOptions, type GanttSpecBar, type GanttSpecRow, type GanttSpecSeam, type GanttSpecStatus, GridBlock, HeatStripBlock, type HeatStripCell, type HeatStripOptions, type HeatStripRowOptions, type HeatStripState, type HypothesisOptions, type InterpretationOptions, type LongOptions, MethodBlock, type MethodOptions, MetricBlock, type MetricOptions, type ModelSpecOptions, MultiAsk, type MultiOptions, MultistepAsk, type MultistepOptions, NarrativeBlock, type NarrativeBlockProps, type NarrativeOptions, type NumberOptions, Page, type PageProps, type PageSection, type PageSpec, type PatchChunk, type PatchPath, type PatchScript, type PatchSource, type PeriodOptions, Placeholder, type PlaceholderProps, type PlanOptions, type PlayOptions, ProposalBlock, type ProposalOptions, QuickAsk, type QuickOptions, type QuickPick, type RangeOptions, RankedBlock, RecordBlock, type RecordRow, type ScaleOptions, ScopeBlock, type ScopeBlockProps, type ScopeOptions, type ScopePart, type ScriptStep, type ShortOptions, SingleAsk, type SingleOptions, type SpecStream, type StreamOptions, SuggestionChips, type SuggestionChipsProps, SuggestionsAsk, type SuggestionsOptions, TableBlock, TimelineBlock, type TimelineEvent, TimeseriesBlock, type Tone, TraceBlock, type TraceIoRow, type TraceOptions, type TraceStep, type TypedValue, VALUE_TYPES, type ValueTypeId, type WeightsOptions, applyBlockPatch, applyBlockPatches, figureText, fromEventSource, fromNdjson, metricValue, offsetScript, patchesOf, playScript, prose, scriptFrames, scriptLength, strong, useBlockStream, useStreamedSpec };
+export { ANSWER_KINDS, ASK_KINDS, type ActionOption, ActionRow, ActivityBlock, type ActivityLane, type ActivityOptions, type ActivityPin, type AnswerKind, type AnswerOptionsByKind, type ApprovalOptions, type AskKind, type AskOptionsByKind, type AskSpec, type AskState, type AskText, type AskValueByKind, BADGE_TONE, BLOCKS, BLOCK_RENDERERS, BarsBlock, Block, type BlockComponentProps, type BlockKind, type BlockOptionsByKind, type BlockPatch, BlockPatchError, type BlockPatchOp, type BlockProps, type BlockRenderers, type BlockSpec, CAPTION_TONE, CannotBlock, type CannotOptions, CaveatBlock, type CaveatNoteOptions, type CaveatOptions, type CaveatTone, type Cell, type ChoiceFigure, type ChoiceOption, type CitationSource, CitationsBlock, type CitationsBlockProps, type CitationsOptions, type Column, ConfirmAsk, ConfirmCard, type ConfirmCardProps, type ConfirmCost, type ConfirmOptions, type CostFigure, type EntityOptions, type EventSourceOptions, type Figure, type FileItem, FilesBlock, type ForkOptions, FormAsk, type FormOption, type FormOptions, GanttBlock, type GanttOptions, type GanttSpecBar, type GanttSpecRow, type GanttSpecSeam, type GanttSpecStatus, GridBlock, HeatStripBlock, type HeatStripCell, type HeatStripOptions, type HeatStripRowOptions, type HeatStripState, type HypothesisOptions, type InterpretationOptions, type LongOptions, MethodBlock, type MethodOptions, MetricBlock, type MetricOptions, type ModelSpecOptions, MultiAsk, type MultiOptions, MultistepAsk, type MultistepOptions, NarrativeBlock, type NarrativeBlockProps, type NarrativeOptions, type NumberOptions, Page, type PageProps, type PageSection, type PageSpec, type PatchChunk, type PatchPath, type PatchScript, type PatchSource, type PeriodOptions, Placeholder, type PlaceholderProps, type PlanOptions, type PlayOptions, ProposalBlock, type ProposalOptions, QuickAsk, type QuickOptions, type QuickPick, type RangeOptions, RankedBlock, RecordBlock, type RecordRow, type ScaleOptions, ScopeBlock, type ScopeBlockProps, type ScopeOptions, type ScopePart, type ScriptStep, type ShortOptions, SingleAsk, type SingleOptions, type SpecStream, type StreamOptions, SuggestionChips, type SuggestionChipsProps, SuggestionsAsk, type SuggestionsOptions, TableBlock, TimelineBlock, type TimelineEvent, TimeseriesBlock, type Tone, TraceBlock, type TraceIoRow, type TraceOptions, type TraceStep, type TypedValue, VALUE_TYPES, type ValueTypeId, type WeightsOptions, applyBlockPatch, applyBlockPatches, figureText, fromEventSource, fromNdjson, metricValue, offsetScript, patchesOf, playScript, prose, scriptFrames, scriptLength, strong, useBlockStream, useStreamedSpec };

package/dist/index.d.ts

@@ -754,6 +754,13 @@ interface MultistepOptions {
     /** Show the answers for a last look, each with Edit, before they are sent. */
     review?: boolean;
 }
+/** One choice of a form field's `select` or `radio`. */
+interface FormOption {
+    value: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}
 interface FormOptions extends AskText {
     /**
      * `side` sets each label in a column at the left; `top` sets it over its
@@ -764,9 +771,28 @@ interface FormOptions extends AskText {
     fields: {
         name: string;
         label: string;
-        type: "number" | "text" | "date" | "select";
+        /**
+         * `textarea` is several lines of text; `checkbox` a yes/no with its label
+         * beside the box; `radio` one of `options` drawn as a list, `select` one
+         * of them in a menu.
+         */
+        type: "number" | "text" | "date" | "select" | "textarea" | "checkbox" | "radio";
         unit?: string;
-        default?: string | number;
+        /** A `checkbox` takes `true`/`false`; `select` and `radio` an option's `value`. */
+        default?: string | number | boolean;
+        /**
+         * The choices of a `select` or `radio`. A `description` is a muted line
+         * under a radio's label; a `disabled` choice shows but can't be picked.
+         */
+        options?: FormOption[];
+        /** A `textarea`'s visible lines. */
+        rows?: number;
+        /** Text shown in an empty `text` or `textarea`. */
+        placeholder?: string;
+        /** Must be answered — for a `checkbox`, ticked. Holds the submit back until it is. */
+        required?: boolean;
+        /** Shown with its value but not changeable; the value is still sent. */
+        disabled?: boolean;
         /** Shown beside the value — `quoted 14 d`. */
         aside?: string;
         /** A line under the field — `From last year's promotions`. */
@@ -2043,7 +2069,9 @@ declare function FilesBlock({ spec, onAction }: BlockProps<"files">): React.JSX.
  * set — scenario inputs. The fields render through the form generator: with
  * `labels: "side"` in a column on the left, with `"top"` over each field, two
  * to a row where the card is wide enough; a field's `group` sets it under a
- * small caps name. A number out of its `above`/`below` bounds says so under
+ * small caps name. A `textarea` and a list of described `radio` choices take
+ * the row; a `checkbox` sits beside its label. A number out of its
+ * `above`/`below` bounds, or a `required` field left empty, says so under
  * itself and holds the submit back. The submit sends a `reply` keyed by field
  * name.
  *
@@ -2242,4 +2270,4 @@ declare function TimeseriesBlock({ spec }: BlockProps<"timeseries">): React.JSX.
  */
 declare function TraceBlock({ spec, onAction }: BlockProps<"trace">): React.JSX.Element;
 
-export { ANSWER_KINDS, ASK_KINDS, type ActionOption, ActionRow, ActivityBlock, type ActivityLane, type ActivityOptions, type ActivityPin, type AnswerKind, type AnswerOptionsByKind, type ApprovalOptions, type AskKind, type AskOptionsByKind, type AskSpec, type AskState, type AskText, type AskValueByKind, BADGE_TONE, BLOCKS, BLOCK_RENDERERS, BarsBlock, Block, type BlockComponentProps, type BlockKind, type BlockOptionsByKind, type BlockPatch, BlockPatchError, type BlockPatchOp, type BlockProps, type BlockRenderers, type BlockSpec, CAPTION_TONE, CannotBlock, type CannotOptions, CaveatBlock, type CaveatNoteOptions, type CaveatOptions, type CaveatTone, type Cell, type ChoiceFigure, type ChoiceOption, type CitationSource, CitationsBlock, type CitationsBlockProps, type CitationsOptions, type Column, ConfirmAsk, ConfirmCard, type ConfirmCardProps, type ConfirmCost, type ConfirmOptions, type CostFigure, type EntityOptions, type EventSourceOptions, type Figure, type FileItem, FilesBlock, type ForkOptions, FormAsk, type FormOptions, GanttBlock, type GanttOptions, type GanttSpecBar, type GanttSpecRow, type GanttSpecSeam, type GanttSpecStatus, GridBlock, HeatStripBlock, type HeatStripCell, type HeatStripOptions, type HeatStripRowOptions, type HeatStripState, type HypothesisOptions, type InterpretationOptions, type LongOptions, MethodBlock, type MethodOptions, MetricBlock, type MetricOptions, type ModelSpecOptions, MultiAsk, type MultiOptions, MultistepAsk, type MultistepOptions, NarrativeBlock, type NarrativeBlockProps, type NarrativeOptions, type NumberOptions, Page, type PageProps, type PageSection, type PageSpec, type PatchChunk, type PatchPath, type PatchScript, type PatchSource, type PeriodOptions, Placeholder, type PlaceholderProps, type PlanOptions, type PlayOptions, ProposalBlock, type ProposalOptions, QuickAsk, type QuickOptions, type QuickPick, type RangeOptions, RankedBlock, RecordBlock, type RecordRow, type ScaleOptions, ScopeBlock, type ScopeBlockProps, type ScopeOptions, type ScopePart, type ScriptStep, type ShortOptions, SingleAsk, type SingleOptions, type SpecStream, type StreamOptions, SuggestionChips, type SuggestionChipsProps, SuggestionsAsk, type SuggestionsOptions, TableBlock, TimelineBlock, type TimelineEvent, TimeseriesBlock, type Tone, TraceBlock, type TraceIoRow, type TraceOptions, type TraceStep, type TypedValue, VALUE_TYPES, type ValueTypeId, type WeightsOptions, applyBlockPatch, applyBlockPatches, figureText, fromEventSource, fromNdjson, metricValue, offsetScript, patchesOf, playScript, prose, scriptFrames, scriptLength, strong, useBlockStream, useStreamedSpec };
+export { ANSWER_KINDS, ASK_KINDS, type ActionOption, ActionRow, ActivityBlock, type ActivityLane, type ActivityOptions, type ActivityPin, type AnswerKind, type AnswerOptionsByKind, type ApprovalOptions, type AskKind, type AskOptionsByKind, type AskSpec, type AskState, type AskText, type AskValueByKind, BADGE_TONE, BLOCKS, BLOCK_RENDERERS, BarsBlock, Block, type BlockComponentProps, type BlockKind, type BlockOptionsByKind, type BlockPatch, BlockPatchError, type BlockPatchOp, type BlockProps, type BlockRenderers, type BlockSpec, CAPTION_TONE, CannotBlock, type CannotOptions, CaveatBlock, type CaveatNoteOptions, type CaveatOptions, type CaveatTone, type Cell, type ChoiceFigure, type ChoiceOption, type CitationSource, CitationsBlock, type CitationsBlockProps, type CitationsOptions, type Column, ConfirmAsk, ConfirmCard, type ConfirmCardProps, type ConfirmCost, type ConfirmOptions, type CostFigure, type EntityOptions, type EventSourceOptions, type Figure, type FileItem, FilesBlock, type ForkOptions, FormAsk, type FormOption, type FormOptions, GanttBlock, type GanttOptions, type GanttSpecBar, type GanttSpecRow, type GanttSpecSeam, type GanttSpecStatus, GridBlock, HeatStripBlock, type HeatStripCell, type HeatStripOptions, type HeatStripRowOptions, type HeatStripState, type HypothesisOptions, type InterpretationOptions, type LongOptions, MethodBlock, type MethodOptions, MetricBlock, type MetricOptions, type ModelSpecOptions, MultiAsk, type MultiOptions, MultistepAsk, type MultistepOptions, NarrativeBlock, type NarrativeBlockProps, type NarrativeOptions, type NumberOptions, Page, type PageProps, type PageSection, type PageSpec, type PatchChunk, type PatchPath, type PatchScript, type PatchSource, type PeriodOptions, Placeholder, type PlaceholderProps, type PlanOptions, type PlayOptions, ProposalBlock, type ProposalOptions, QuickAsk, type QuickOptions, type QuickPick, type RangeOptions, RankedBlock, RecordBlock, type RecordRow, type ScaleOptions, ScopeBlock, type ScopeBlockProps, type ScopeOptions, type ScopePart, type ScriptStep, type ShortOptions, SingleAsk, type SingleOptions, type SpecStream, type StreamOptions, SuggestionChips, type SuggestionChipsProps, SuggestionsAsk, type SuggestionsOptions, TableBlock, TimelineBlock, type TimelineEvent, TimeseriesBlock, type Tone, TraceBlock, type TraceIoRow, type TraceOptions, type TraceStep, type TypedValue, VALUE_TYPES, type ValueTypeId, type WeightsOptions, applyBlockPatch, applyBlockPatches, figureText, fromEventSource, fromNdjson, metricValue, offsetScript, patchesOf, playScript, prose, scriptFrames, scriptLength, strong, useBlockStream, useStreamedSpec };

package/dist/index.js

@@ -737,12 +737,17 @@ var FIELD_TYPE = {
   number: "number",
   text: "text",
   date: "text",
-  select: "select"
+  select: "select",
+  textarea: "textarea",
+  checkbox: "boolean",
+  radio: "radio"
 };
-function boundsRule(f) {
-  if (f.above == null && f.below == null) return void 0;
+var blank = (v) => v == null || typeof v === "string" && v.trim() === "";
+function rules(f) {
+  if (!f.required && f.above == null && f.below == null) return void 0;
   return {
     validate: (v) => {
+      if (f.required && (f.type === "checkbox" ? v !== true : blank(v))) return "Required";
       const n = Number(v);
       if (f.above != null && !(n > f.above)) return `Must be above ${f.above}`;
       if (f.below != null && !(n < f.below)) return `Must be below ${f.below}`;
@@ -750,22 +755,41 @@ function boundsRule(f) {
     }
   };
 }
+function optionsOf(f) {
+  if (f.options) return f.options;
+  if (f.type === "select" && f.default != null) {
+    return [{ value: String(f.default), label: String(f.default) }];
+  }
+  return void 0;
+}
 var toField = (f) => ({
   name: f.name,
   type: FIELD_TYPE[f.type],
+  control: f.type === "checkbox" ? "checkbox" : void 0,
   label: f.label,
   unit: f.unit,
   aside: f.aside,
   description: f.hint,
   group: f.group,
-  rules: boundsRule(f),
-  placeholder: ""
+  options: optionsOf(f),
+  rows: f.rows,
+  disabled: f.disabled,
+  rules: rules(f),
+  placeholder: f.placeholder ?? "",
+  // A long answer takes the row; so does a list of described choices.
+  colSpan: f.type === "textarea" || f.type === "radio" && f.options?.some((o) => o.description) ? 2 : void 0
 });
+var initial = (f) => f.type === "checkbox" ? f.default ?? false : f.default;
 function withUnit(value, unit) {
   if (value == null || value === "") return "\u2014";
   if (!unit) return String(value);
   return /^[A-Za-z]/.test(unit) ? `${value} ${unit}` : `${value}${unit}`;
 }
+function answerOf(f, value) {
+  if (f.type === "checkbox") return value === true ? "Yes" : "No";
+  const picked = f.options?.find((o) => o.value === value);
+  return picked ? picked.label : withUnit(value, f.unit);
+}
 function FormAsk({ spec, state = "pending", value: given, onAction }) {
   const auto = React18.useId();
   const pending = state === "pending";
@@ -773,14 +797,14 @@ function FormAsk({ spec, state = "pending", value: given, onAction }) {
   const current = given ?? {};
   const top = spec.labels === "top";
   const defaults = Object.fromEntries(
-    spec.fields.map((f) => [f.name, pending ? f.default : current[f.name]])
+    spec.fields.map((f) => [f.name, pending ? initial(f) : current[f.name]])
   );
   const form = useForm({ defaultValues: { values: defaults }, mode: "onChange" });
   if (!pending && !editing) {
     return /* @__PURE__ */ jsx(
       AskSummary,
       {
-        rows: spec.fields.map((f) => ({ label: f.label, value: withUnit(current[f.name], f.unit) })),
+        rows: spec.fields.map((f) => ({ label: f.label, value: answerOf(f, current[f.name]) })),
         change: state === "answered" ? "Change inputs" : void 0,
         onChange: () => setEditing(true)
       }
@@ -1215,7 +1239,7 @@ function MultistepAsk({ spec, state = "pending", value: given, onAction }) {
     setEditing(false);
     setReview(null);
   };
-  const initial = (step2) => editing ? current[step2.id] : "default" in step2 ? step2.default : void 0;
+  const initial2 = (step2) => editing ? current[step2.id] : "default" in step2 ? step2.default : void 0;
   const index = Math.max(0, steps.findIndex((s) => s.id === item));
   const step = steps[index];
   const last = index === steps.length - 1;
@@ -1238,7 +1262,7 @@ function MultistepAsk({ spec, state = "pending", value: given, onAction }) {
             StepItem,
             {
               step: s,
-              value: initial(s),
+              value: initial2(s),
               onStatusChange: (st) => setStatus((now) => ({ ...now, [s.id]: st }))
             },
             s.id