@invana/forms 0.0.25 → 0.0.27

package/dist/index.d.cts

@@ -371,6 +371,63 @@ declare function FieldError({ className, children, errors, ...props }: React.Com
     } | undefined>;
 }): React$1.JSX.Element | null;
 
+/**
+ * Where a parameter's value comes from.
+ *
+ * The three are not styles of the same thing — they decide *when* the value is
+ * known. A literal is known now; an argument is known when a run is started; a
+ * binding is known only once an earlier task has produced it.
+ */
+type ParamSource = "literal" | "argument" | "binding";
+declare const PARAM_SOURCES: ParamSource[];
+interface ParamRowProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** The parameter's name, as the contract spells it — `batch_size`, `map_over`. */
+    name: string;
+    /** Its type and obligation, from the contract — `str · required`, `int · optional`. */
+    type?: React$1.ReactNode;
+    /** Which of the three the current value is. */
+    source: ParamSource;
+    onSourceChange?: (source: ParamSource) => void;
+    /** The value itself — a literal, `${args.model}`, `${steps.x.rows}`. */
+    value: string;
+    onValueChange?: (value: string) => void;
+    /**
+     * What the reader needs to know that the value does not say — what a binding
+     * will resolve to, which alternatives an enum allows, why a default was left
+     * alone. Rendered as the error when `invalid` is set.
+     */
+    note?: React$1.ReactNode;
+    /** The value does not resolve, or the contract refuses it. Reddens the control and the note. */
+    invalid?: boolean;
+    /**
+     * The parameter is not in play — a `when` on a task that always runs. Shown
+     * rather than hidden, because a contract's full surface is the point of the
+     * form.
+     */
+    disabled?: boolean;
+    /** Replaces the value control entirely, for a parameter that needs its own editor. */
+    children?: React$1.ReactNode;
+}
+/**
+ * One parameter of a task, as a row: what it is called, where its value comes
+ * from, what the value is, and what that means.
+ *
+ * The form these rows make **is** the catalogue contract — the fields, their
+ * types and their obligations are read off the entry, never authored here. So a
+ * row takes a descriptor rather than children, and a parameter the contract
+ * does not declare has no way to appear.
+ *
+ * `source` and `value` are one control, joined, because they are one decision.
+ * Split into two fields they read as two questions, and a reader can end up
+ * with `literal` selected beside a value that is plainly a binding.
+ *
+ * Not a `Field`. That one lays out a label, a control and a description for a
+ * form a person fills in from nothing; this lays out a *contract* — the label
+ * column carries a type, and the description usually explains a value the
+ * person did not type.
+ */
+declare const ParamRow: React$1.ForwardRefExoticComponent<ParamRowProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare function InputGroup({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
 declare const inputGroupAddonVariants: (props?: ({
     align?: "inline-end" | "inline-start" | "block-end" | "block-start" | null | undefined;
@@ -384,4 +441,4 @@ declare function InputGroupText({ className, ...props }: React$1.ComponentProps<
 declare function InputGroupInput({ className, ...props }: React$1.ComponentProps<"input">): React$1.JSX.Element;
 declare function InputGroupTextarea({ className, ...props }: React$1.ComponentProps<"textarea">): React$1.JSX.Element;
 
-export { type BooleanControl, BooleanField, Checkbox, CheckboxGroupField, ColorField, type ColorPreset, ColorSwatches, Field, type FieldBadge, type FieldConfig, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldOrientation, FieldSeparator, FieldSet, type FieldSize, FieldTitle, type FieldType, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, type GroupConfig, IconField, IconInput, Input, InputField, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, type InputSize, Label, type LabelPosition, NumberField, ObjectField, type ObjectFieldProps, PasswordField, PasswordInput, type PasswordInputProps, RadioField, RadioGroup, RadioGroupItem, type RowConfig, Select, SelectContent, SelectField, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SettingsPanel, type SettingsPanelProps, Slider, SliderNumber, Switch, Textarea, TextareaField, useFormField };
+export { type BooleanControl, BooleanField, Checkbox, CheckboxGroupField, ColorField, type ColorPreset, ColorSwatches, Field, type FieldBadge, type FieldConfig, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldOrientation, FieldSeparator, FieldSet, type FieldSize, FieldTitle, type FieldType, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, type GroupConfig, IconField, IconInput, Input, InputField, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, type InputSize, Label, type LabelPosition, NumberField, ObjectField, type ObjectFieldProps, PARAM_SOURCES, ParamRow, type ParamRowProps, type ParamSource, PasswordField, PasswordInput, type PasswordInputProps, RadioField, RadioGroup, RadioGroupItem, type RowConfig, Select, SelectContent, SelectField, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SettingsPanel, type SettingsPanelProps, Slider, SliderNumber, Switch, Textarea, TextareaField, useFormField };

package/dist/index.d.ts

@@ -371,6 +371,63 @@ declare function FieldError({ className, children, errors, ...props }: React.Com
     } | undefined>;
 }): React$1.JSX.Element | null;
 
+/**
+ * Where a parameter's value comes from.
+ *
+ * The three are not styles of the same thing — they decide *when* the value is
+ * known. A literal is known now; an argument is known when a run is started; a
+ * binding is known only once an earlier task has produced it.
+ */
+type ParamSource = "literal" | "argument" | "binding";
+declare const PARAM_SOURCES: ParamSource[];
+interface ParamRowProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** The parameter's name, as the contract spells it — `batch_size`, `map_over`. */
+    name: string;
+    /** Its type and obligation, from the contract — `str · required`, `int · optional`. */
+    type?: React$1.ReactNode;
+    /** Which of the three the current value is. */
+    source: ParamSource;
+    onSourceChange?: (source: ParamSource) => void;
+    /** The value itself — a literal, `${args.model}`, `${steps.x.rows}`. */
+    value: string;
+    onValueChange?: (value: string) => void;
+    /**
+     * What the reader needs to know that the value does not say — what a binding
+     * will resolve to, which alternatives an enum allows, why a default was left
+     * alone. Rendered as the error when `invalid` is set.
+     */
+    note?: React$1.ReactNode;
+    /** The value does not resolve, or the contract refuses it. Reddens the control and the note. */
+    invalid?: boolean;
+    /**
+     * The parameter is not in play — a `when` on a task that always runs. Shown
+     * rather than hidden, because a contract's full surface is the point of the
+     * form.
+     */
+    disabled?: boolean;
+    /** Replaces the value control entirely, for a parameter that needs its own editor. */
+    children?: React$1.ReactNode;
+}
+/**
+ * One parameter of a task, as a row: what it is called, where its value comes
+ * from, what the value is, and what that means.
+ *
+ * The form these rows make **is** the catalogue contract — the fields, their
+ * types and their obligations are read off the entry, never authored here. So a
+ * row takes a descriptor rather than children, and a parameter the contract
+ * does not declare has no way to appear.
+ *
+ * `source` and `value` are one control, joined, because they are one decision.
+ * Split into two fields they read as two questions, and a reader can end up
+ * with `literal` selected beside a value that is plainly a binding.
+ *
+ * Not a `Field`. That one lays out a label, a control and a description for a
+ * form a person fills in from nothing; this lays out a *contract* — the label
+ * column carries a type, and the description usually explains a value the
+ * person did not type.
+ */
+declare const ParamRow: React$1.ForwardRefExoticComponent<ParamRowProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare function InputGroup({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
 declare const inputGroupAddonVariants: (props?: ({
     align?: "inline-end" | "inline-start" | "block-end" | "block-start" | null | undefined;
@@ -384,4 +441,4 @@ declare function InputGroupText({ className, ...props }: React$1.ComponentProps<
 declare function InputGroupInput({ className, ...props }: React$1.ComponentProps<"input">): React$1.JSX.Element;
 declare function InputGroupTextarea({ className, ...props }: React$1.ComponentProps<"textarea">): React$1.JSX.Element;
 
-export { type BooleanControl, BooleanField, Checkbox, CheckboxGroupField, ColorField, type ColorPreset, ColorSwatches, Field, type FieldBadge, type FieldConfig, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldOrientation, FieldSeparator, FieldSet, type FieldSize, FieldTitle, type FieldType, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, type GroupConfig, IconField, IconInput, Input, InputField, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, type InputSize, Label, type LabelPosition, NumberField, ObjectField, type ObjectFieldProps, PasswordField, PasswordInput, type PasswordInputProps, RadioField, RadioGroup, RadioGroupItem, type RowConfig, Select, SelectContent, SelectField, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SettingsPanel, type SettingsPanelProps, Slider, SliderNumber, Switch, Textarea, TextareaField, useFormField };
+export { type BooleanControl, BooleanField, Checkbox, CheckboxGroupField, ColorField, type ColorPreset, ColorSwatches, Field, type FieldBadge, type FieldConfig, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldOrientation, FieldSeparator, FieldSet, type FieldSize, FieldTitle, type FieldType, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, type GroupConfig, IconField, IconInput, Input, InputField, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, type InputSize, Label, type LabelPosition, NumberField, ObjectField, type ObjectFieldProps, PARAM_SOURCES, ParamRow, type ParamRowProps, type ParamSource, PasswordField, PasswordInput, type PasswordInputProps, RadioField, RadioGroup, RadioGroupItem, type RowConfig, Select, SelectContent, SelectField, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SettingsPanel, type SettingsPanelProps, Slider, SliderNumber, Switch, Textarea, TextareaField, useFormField };

package/dist/index.js

@@ -1386,6 +1386,86 @@ function FieldError({
     }
   );
 }
+var PARAM_SOURCES = ["literal", "argument", "binding"];
+var ParamRow = React2.forwardRef(
+  ({
+    name,
+    type,
+    source,
+    onSourceChange,
+    value,
+    onValueChange,
+    note,
+    invalid,
+    disabled,
+    className,
+    children,
+    ...props
+  }, ref) => /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ref,
+      "data-invalid": invalid || void 0,
+      "data-disabled": disabled || void 0,
+      className: cn("flex items-start gap-3 py-1.5", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: "w-[118px] shrink-0 pt-1", children: [
+          /* @__PURE__ */ jsx("div", { className: "truncate font-mono text-meta", children: name }),
+          type != null ? /* @__PURE__ */ jsx("div", { className: "truncate text-meta text-muted-foreground", children: type }) : null
+        ] }),
+        /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1", children: [
+          children ?? /* @__PURE__ */ jsxs("div", { className: "flex min-w-0", children: [
+            /* @__PURE__ */ jsxs(
+              Select,
+              {
+                value: source,
+                onValueChange: (v) => onSourceChange?.(v),
+                disabled,
+                children: [
+                  /* @__PURE__ */ jsx(
+                    SelectTrigger,
+                    {
+                      triggerSize: "sm",
+                      "aria-label": `${name} source`,
+                      className: "w-auto shrink-0 rounded-r-none border-r-0 text-meta text-muted-foreground",
+                      children: /* @__PURE__ */ jsx(SelectValue, {})
+                    }
+                  ),
+                  /* @__PURE__ */ jsx(SelectContent, { children: PARAM_SOURCES.map((s) => /* @__PURE__ */ jsx(SelectItem, { value: s, children: s }, s)) })
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx(
+              Input,
+              {
+                inputSize: "sm",
+                value,
+                onChange: (e) => onValueChange?.(e.target.value),
+                disabled,
+                "aria-invalid": invalid || void 0,
+                "aria-label": name,
+                style: invalid ? { borderColor: "var(--color-destructive)" } : void 0,
+                className: "min-w-0 flex-1 rounded-l-none font-mono"
+              }
+            )
+          ] }),
+          note != null ? /* @__PURE__ */ jsx(
+            "div",
+            {
+              className: cn(
+                "text-meta",
+                invalid ? "text-destructive" : "text-muted-foreground"
+              ),
+              children: note
+            }
+          ) : null
+        ] })
+      ]
+    }
+  )
+);
+ParamRow.displayName = "ParamRow";
 function InputGroup({ className, ...props }) {
   return /* @__PURE__ */ jsx(
     "div",
@@ -1527,6 +1607,6 @@ function InputGroupTextarea({
   );
 }
 
-export { BooleanField, Checkbox, CheckboxGroupField, ColorField, ColorSwatches, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel2 as FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, Form, FormControl, FormDescription, FormField2 as FormField, FormItem, FormLabel, FormMessage, IconField, IconInput, Input, InputField, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, Label, NumberField, ObjectField, PasswordField, PasswordInput, RadioField, RadioGroup, RadioGroupItem, Select, SelectContent, SelectField, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SettingsPanel, Slider, SliderNumber, Switch, Textarea, TextareaField, useFormField };
+export { BooleanField, Checkbox, CheckboxGroupField, ColorField, ColorSwatches, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel2 as FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, Form, FormControl, FormDescription, FormField2 as FormField, FormItem, FormLabel, FormMessage, IconField, IconInput, Input, InputField, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, Label, NumberField, ObjectField, PARAM_SOURCES, ParamRow, PasswordField, PasswordInput, RadioField, RadioGroup, RadioGroupItem, Select, SelectContent, SelectField, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SettingsPanel, Slider, SliderNumber, Switch, Textarea, TextareaField, useFormField };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map