@epilot/spark-ui 0.10.0

package/dist/components/feed-in-hero.js

@@ -0,0 +1,51 @@
+"use client";
+import { cn } from "../utils/cn.js";
+import { jsx } from "react/jsx-runtime";
+import { cva } from "class-variance-authority";
+//#region src/components/feed-in-hero.tsx
+const FeedInHero = ({ className, ...rest }) => {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("flex flex-col items-center gap-1 rounded-2xl border border-gray p-5 text-center", className),
+		...rest
+	});
+};
+/**
+* Label row above the value. Lays out children in a flex row with a small
+* gap so a tooltip / icon can sit alongside the label text.
+*/
+const FeedInHeroLabel = ({ className, ...rest }) => {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("flex items-center gap-1.5 text-xs font-medium text-gray-light", className),
+		...rest
+	});
+};
+const valueToneVariants = cva("text-4xl font-bold tabular-nums", {
+	variants: { tone: {
+		success: "text-success",
+		warning: "text-warning",
+		error: "text-error",
+		accent: "text-accent",
+		neutral: "text-gray"
+	} },
+	defaultVariants: { tone: "neutral" }
+});
+const FeedInHeroValue = ({ className, tone, ...rest }) => {
+	return /* @__PURE__ */ jsx("span", {
+		className: valueToneVariants({
+			tone,
+			className
+		}),
+		...rest
+	});
+};
+/** Smaller-weight unit suffix that sits inline with the value (e.g. "W"). */
+const FeedInHeroValueUnit = ({ className, ...rest }) => {
+	return /* @__PURE__ */ jsx("span", {
+		className: cn("text-2xl font-semibold", className),
+		...rest
+	});
+};
+//#endregion
+export { FeedInHero, FeedInHeroLabel, FeedInHeroValue, FeedInHeroValueUnit };
+
+//# sourceMappingURL=feed-in-hero.js.map

package/dist/components/feed-in-hero.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed-in-hero.js","names":[],"sources":["../../src/components/feed-in-hero.tsx"],"sourcesContent":["import { cva } from 'class-variance-authority'\nimport type { Tone } from '../lib/tones'\nimport { cn } from '../utils/cn'\n\nconst FeedInHero = ({ className, ...rest }: React.ComponentProps<'div'>) => {\n  return (\n    <div\n      className={cn(\n        'flex flex-col items-center gap-1 rounded-2xl border border-gray p-5 text-center',\n        className,\n      )}\n      {...rest}\n    />\n  )\n}\n\n/**\n * Label row above the value. Lays out children in a flex row with a small\n * gap so a tooltip / icon can sit alongside the label text.\n */\nconst FeedInHeroLabel = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => {\n  return (\n    <div\n      className={cn(\n        'flex items-center gap-1.5 text-xs font-medium text-gray-light',\n        className,\n      )}\n      {...rest}\n    />\n  )\n}\n\nconst valueToneVariants = cva('text-4xl font-bold tabular-nums', {\n  variants: {\n    tone: {\n      success: 'text-success',\n      warning: 'text-warning',\n      error: 'text-error',\n      accent: 'text-accent',\n      neutral: 'text-gray',\n    },\n  },\n  defaultVariants: {\n    tone: 'neutral',\n  },\n})\n\nconst FeedInHeroValue = ({\n  className,\n  tone,\n  ...rest\n}: React.ComponentProps<'span'> & { tone?: Tone }) => {\n  return <span className={valueToneVariants({ tone, className })} {...rest} />\n}\n\n/** Smaller-weight unit suffix that sits inline with the value (e.g. \"W\"). */\nconst FeedInHeroValueUnit = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => {\n  return <span className={cn('text-2xl font-semibold', className)} {...rest} />\n}\n\nexport { FeedInHero, FeedInHeroLabel, FeedInHeroValue, FeedInHeroValueUnit }\n"],"mappings":";;;;;AAIA,MAAM,cAAc,EAAE,WAAW,GAAG,WAAwC;CAC1E,OACE,oBAAC,OAAD;EACE,WAAW,GACT,mFACA,SACF;EACA,GAAI;CACL,CAAA;AAEL;;;;;AAMA,MAAM,mBAAmB,EACvB,WACA,GAAG,WAC8B;CACjC,OACE,oBAAC,OAAD;EACE,WAAW,GACT,iEACA,SACF;EACA,GAAI;CACL,CAAA;AAEL;AAEA,MAAM,oBAAoB,IAAI,mCAAmC;CAC/D,UAAU,EACR,MAAM;EACJ,SAAS;EACT,SAAS;EACT,OAAO;EACP,QAAQ;EACR,SAAS;CACX,EACF;CACA,iBAAiB,EACf,MAAM,UACR;AACF,CAAC;AAED,MAAM,mBAAmB,EACvB,WACA,MACA,GAAG,WACiD;CACpD,OAAO,oBAAC,QAAD;EAAM,WAAW,kBAAkB;GAAE;GAAM;EAAU,CAAC;EAAG,GAAI;CAAO,CAAA;AAC7E;;AAGA,MAAM,uBAAuB,EAC3B,WACA,GAAG,WAC+B;CAClC,OAAO,oBAAC,QAAD;EAAM,WAAW,GAAG,0BAA0B,SAAS;EAAG,GAAI;CAAO,CAAA;AAC9E"}

package/dist/components/field.cjs

@@ -0,0 +1,257 @@
+"use client";
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_chunk = require("../chunk-DY84GLCh.cjs");
+const require_components_separator = require("./separator.cjs");
+const require_components_theme = require("./theme.cjs");
+let react = require("react");
+react = require_chunk.__toESM(react);
+let react_jsx_runtime = require("react/jsx-runtime");
+let class_variance_authority = require("class-variance-authority");
+let cnfast = require("cnfast");
+//#region src/components/field.tsx
+const FieldContext = react.createContext(null);
+function useFieldContext() {
+	return react.useContext(FieldContext);
+}
+function useFieldControl(options) {
+	const field = useFieldContext();
+	const theme = require_components_theme.useTheme();
+	return {
+		field,
+		id: options?.id ?? field?.id,
+		ariaDescribedBy: [field?.hasDescription ? field.descriptionId : void 0, options?.ariaDescribedBy].filter(Boolean).join(" ") || void 0,
+		inputStyle: options?.variant ?? field?.inputStyle ?? theme.inputStyle ?? "soft",
+		inputColor: field?.inputColor ?? theme.inputColor ?? "brand"
+	};
+}
+function FieldSet({ className, ...props }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("fieldset", {
+		"data-slot": "field-set",
+		className: (0, cnfast.cn)("flex flex-col gap-[calc(var(--spark-layout-gap)*4)]", className),
+		...props
+	});
+}
+function FieldLegend({ className, variant = "legend", ...props }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("legend", {
+		"data-slot": "field-legend",
+		"data-variant": variant,
+		className: (0, cnfast.cn)("mb-1.5 font-medium text-gray data-[variant=label]:text-sm data-[variant=legend]:text-base", className),
+		...props
+	});
+}
+function FieldGroup({ className, ...props }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		"data-slot": "field-group",
+		className: (0, cnfast.cn)("group/field-group flex w-full flex-col gap-[calc(var(--spark-layout-gap)*4)]", className),
+		...props
+	});
+}
+const fieldVariants = (0, class_variance_authority.cva)("group/field relative flex w-full flex-col data-[invalid=true]:text-error-active", {
+	variants: {
+		labelPosition: {
+			inset: "gap-y-1 rounded-lg px-4 py-3",
+			outset: "gap-y-2"
+		},
+		inputStyle: {
+			soft: "",
+			surface: "",
+			outlined: "",
+			ghost: ""
+		},
+		inputColor: {
+			brand: "",
+			gray: ""
+		}
+	},
+	compoundVariants: [
+		{
+			labelPosition: "inset",
+			inputStyle: "soft",
+			inputColor: "brand",
+			class: "bg-input-base has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-input-base-hover"
+		},
+		{
+			labelPosition: "inset",
+			inputStyle: "soft",
+			inputColor: "gray",
+			class: "bg-base-gray-soft has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-gray-a4"
+		},
+		{
+			labelPosition: "inset",
+			inputStyle: "surface",
+			inputColor: "brand",
+			class: "border border-input bg-base-accent-surface"
+		},
+		{
+			labelPosition: "inset",
+			inputStyle: "surface",
+			inputColor: "gray",
+			class: "border border-input-gray bg-base-gray-surface"
+		},
+		{
+			labelPosition: "inset",
+			inputStyle: "outlined",
+			inputColor: "brand",
+			class: "border border-input"
+		},
+		{
+			labelPosition: "inset",
+			inputStyle: "outlined",
+			inputColor: "gray",
+			class: "border border-input-gray"
+		},
+		{
+			labelPosition: "inset",
+			inputStyle: "ghost",
+			class: "rounded-none px-0"
+		},
+		{
+			labelPosition: "inset",
+			inputStyle: ["soft", "surface"],
+			class: "data-[disabled=true]:bg-base-gray-soft data-[invalid=true]:bg-base-error-soft data-[invalid=true]:has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-red-a4"
+		},
+		{
+			labelPosition: "inset",
+			inputStyle: ["surface", "outlined"],
+			class: "data-[disabled=true]:border-input-disabled data-[invalid=true]:border-input-invalid"
+		}
+	]
+});
+function Field({ className, labelPosition: labelPositionProp, inputStyle: inputStyleProp, inputColor: inputColorProp, ...props }) {
+	const id = (0, react.useId)();
+	const [hasDescription, setHasDescription] = react.useState(false);
+	const theme = require_components_theme.useTheme();
+	const labelPosition = labelPositionProp ?? theme.labelPosition ?? "inset";
+	const inputStyle = inputStyleProp ?? theme.inputStyle ?? "soft";
+	const inputColor = inputColorProp ?? theme.inputColor ?? "brand";
+	const value = react.useMemo(() => ({
+		id: `field-${id}`,
+		descriptionId: `field-${id}-description`,
+		hasDescription,
+		setHasDescription,
+		labelPosition,
+		inputStyle,
+		inputColor
+	}), [
+		id,
+		hasDescription,
+		labelPosition,
+		inputStyle,
+		inputColor
+	]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FieldContext.Provider, {
+		value,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			role: "group",
+			"data-slot": "field",
+			"data-label-position": labelPosition,
+			"data-input-style": inputStyle,
+			"data-input-color": inputColor,
+			className: (0, cnfast.cn)(fieldVariants({
+				labelPosition,
+				inputStyle,
+				inputColor
+			}), className),
+			...props
+		})
+	});
+}
+function FieldContent({ className, ...props }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		"data-slot": "field-content",
+		className: (0, cnfast.cn)("flex min-w-0 flex-1 flex-col gap-0.5 leading-snug", className),
+		...props
+	});
+}
+function FieldLabel({ className, htmlFor, srOnly, ...props }) {
+	const field = useFieldContext();
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+		"data-slot": "field-label",
+		className: (0, cnfast.cn)("text-sm leading-5 font-normal text-gray-light transition-all group-data-[invalid=true]/field:text-error-active! motion-reduce:transition-none", srOnly && "sr-only", className),
+		htmlFor: htmlFor ?? field?.id,
+		...props
+	});
+}
+function FieldValue({ className, id, title, truncate, children, ...props }) {
+	const field = useFieldContext();
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		"data-slot": "field-value",
+		id: id ?? field?.id,
+		title: title ?? (truncate && typeof children === "string" ? children : void 0),
+		className: (0, cnfast.cn)("min-h-8 w-full text-base text-gray tabular-nums group-data-[disabled=true]/field:opacity-70", truncate ? "block truncate leading-8" : "inline-flex items-center wrap-anywhere whitespace-pre-wrap", className),
+		...props,
+		children
+	});
+}
+function FieldTitle({ className, ...props }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		"data-slot": "field-title",
+		className: (0, cnfast.cn)("flex w-fit items-center gap-2 text-sm font-medium text-gray", className),
+		...props
+	});
+}
+function FieldDescription({ className, id, ...props }) {
+	const field = useFieldContext();
+	const setHasDescription = field?.setHasDescription;
+	react.useEffect(() => {
+		if (!setHasDescription) return;
+		setHasDescription(true);
+		return () => setHasDescription(false);
+	}, [setHasDescription]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		"data-slot": "field-description",
+		id: id ?? field?.descriptionId,
+		className: (0, cnfast.cn)("mt-0.5 text-sm leading-normal text-gray-light", className),
+		...props
+	});
+}
+function FieldSeparator({ children, className, ...props }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		"data-slot": "field-separator",
+		"data-content": !!children,
+		className: (0, cnfast.cn)("relative -my-2 h-5 text-sm", className),
+		...props,
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_separator.Separator, { className: "absolute inset-0 top-1/2" }), children && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+			className: "relative mx-auto block w-fit bg-(--spark-background) px-2 text-gray-light",
+			"data-slot": "field-separator-content",
+			children
+		})]
+	});
+}
+function FieldError({ className, children, errors, ...props }) {
+	const content = react.useMemo(() => {
+		if (children) return children;
+		if (!errors?.length) return null;
+		const unique = [...new Map(errors.map((error) => [error?.message, error])).values()];
+		if (unique.length === 1) return unique[0]?.message;
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+			className: "ml-4 flex list-disc flex-col gap-1",
+			children: unique.map((error, index) => error?.message && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: error.message }, index))
+		});
+	}, [children, errors]);
+	if (!content) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		role: "alert",
+		"data-slot": "field-error",
+		className: (0, cnfast.cn)("mt-0.5 text-sm font-normal text-error", className),
+		...props,
+		children: content
+	});
+}
+//#endregion
+exports.Field = Field;
+exports.FieldContent = FieldContent;
+exports.FieldDescription = FieldDescription;
+exports.FieldError = FieldError;
+exports.FieldGroup = FieldGroup;
+exports.FieldLabel = FieldLabel;
+exports.FieldLegend = FieldLegend;
+exports.FieldSeparator = FieldSeparator;
+exports.FieldSet = FieldSet;
+exports.FieldTitle = FieldTitle;
+exports.FieldValue = FieldValue;
+exports.useFieldContext = useFieldContext;
+exports.useFieldControl = useFieldControl;
+
+//# sourceMappingURL=field.cjs.map

package/dist/components/field.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.cjs","names":["React","useTheme","Separator"],"sources":["../../src/components/field.tsx"],"sourcesContent":["'use client'\n\nimport { cva } from 'class-variance-authority'\nimport * as React from 'react'\nimport { useId } from 'react'\nimport type {\n  SparkInputColor,\n  SparkInputStyle,\n  SparkLabelPosition,\n} from '../lib/theme-types'\nimport { cn } from '../utils/cn'\nimport { Separator } from './separator'\nimport { useTheme } from './theme'\n\ntype FieldContextValue = {\n  id: string\n  descriptionId: string\n  hasDescription: boolean\n  setHasDescription: (has: boolean) => void\n  labelPosition: SparkLabelPosition\n  inputStyle: SparkInputStyle\n  inputColor: SparkInputColor\n}\n\nconst FieldContext = React.createContext<FieldContextValue | null>(null)\n\nexport function useFieldContext() {\n  return React.useContext(FieldContext)\n}\n\n// Field→Theme→default resolution + id/aria-describedby wiring, shared by every\n// control that can sit inside a Field (Input, SelectTrigger, …) so they can't\n// drift on how a style/color/id resolves. `variant` is the control's own\n// per-instance override (already normalized — e.g. Input maps its 'none' to\n// undefined before calling this).\nexport function useFieldControl(options?: {\n  id?: string\n  ariaDescribedBy?: string\n  variant?: SparkInputStyle\n}) {\n  const field = useFieldContext()\n  const theme = useTheme()\n  const id = options?.id ?? field?.id\n  const descriptionId = field?.hasDescription ? field.descriptionId : undefined\n  const ariaDescribedBy =\n    [descriptionId, options?.ariaDescribedBy].filter(Boolean).join(' ') ||\n    undefined\n  const inputStyle =\n    options?.variant ?? field?.inputStyle ?? theme.inputStyle ?? 'soft'\n  const inputColor = field?.inputColor ?? theme.inputColor ?? 'brand'\n  return { field, id, ariaDescribedBy, inputStyle, inputColor }\n}\n\nfunction FieldSet({ className, ...props }: React.ComponentProps<'fieldset'>) {\n  return (\n    <fieldset\n      data-slot=\"field-set\"\n      className={cn(\n        'flex flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldLegend({\n  className,\n  variant = 'legend',\n  ...props\n}: React.ComponentProps<'legend'> & { variant?: 'legend' | 'label' }) {\n  return (\n    <legend\n      data-slot=\"field-legend\"\n      data-variant={variant}\n      className={cn(\n        'mb-1.5 font-medium text-gray data-[variant=label]:text-sm data-[variant=legend]:text-base',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldGroup({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-group\"\n      className={cn(\n        'group/field-group flex w-full flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nconst fieldVariants = cva(\n  'group/field relative flex w-full flex-col data-[invalid=true]:text-error-active',\n  {\n    variants: {\n      labelPosition: {\n        // inset puts label + input inside one shell, so the shell is the box\n        // focus inside inset is the classic underline cue, not a shell ring\n        inset: 'gap-y-1 rounded-lg px-4 py-3',\n        outset: 'gap-y-2',\n      },\n      inputStyle: { soft: '', surface: '', outlined: '', ghost: '' },\n      inputColor: { brand: '', gray: '' },\n    },\n    compoundVariants: [\n      {\n        labelPosition: 'inset',\n        inputStyle: 'soft',\n        inputColor: 'brand',\n        class:\n          'bg-input-base has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-input-base-hover',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'soft',\n        inputColor: 'gray',\n        class:\n          'bg-base-gray-soft has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-gray-a4',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'surface',\n        inputColor: 'brand',\n        class: 'border border-input bg-base-accent-surface',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'surface',\n        inputColor: 'gray',\n        class: 'border border-input-gray bg-base-gray-surface',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'outlined',\n        inputColor: 'brand',\n        class: 'border border-input',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'outlined',\n        inputColor: 'gray',\n        class: 'border border-input-gray',\n      },\n      // ghost inset = bare label + underlined input; the input carries the line\n      {\n        labelPosition: 'inset',\n        inputStyle: 'ghost',\n        class: 'rounded-none px-0',\n      },\n      // shared inset states: filled shells swap bg, bordered shells swap border\n      // invalid hover deepens the error tint instead of falling back to accent\n      {\n        labelPosition: 'inset',\n        inputStyle: ['soft', 'surface'],\n        class:\n          'data-[disabled=true]:bg-base-gray-soft data-[invalid=true]:bg-base-error-soft data-[invalid=true]:has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-red-a4',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: ['surface', 'outlined'],\n        class:\n          'data-[disabled=true]:border-input-disabled data-[invalid=true]:border-input-invalid',\n      },\n    ],\n  },\n)\n\ninterface FieldProps extends React.ComponentProps<'div'> {\n  labelPosition?: SparkLabelPosition\n  inputStyle?: SparkInputStyle\n  inputColor?: SparkInputColor\n}\n\nfunction Field({\n  className,\n  labelPosition: labelPositionProp,\n  inputStyle: inputStyleProp,\n  inputColor: inputColorProp,\n  ...props\n}: FieldProps) {\n  const id = useId()\n  const [hasDescription, setHasDescription] = React.useState(false)\n  // knobs are structural (they move the label / pick the box carrier), so they\n  // resolve here via the <Theme> context; props override per instance\n  const theme = useTheme()\n  const labelPosition = labelPositionProp ?? theme.labelPosition ?? 'inset'\n  const inputStyle = inputStyleProp ?? theme.inputStyle ?? 'soft'\n  const inputColor = inputColorProp ?? theme.inputColor ?? 'brand'\n  const value = React.useMemo<FieldContextValue>(\n    () => ({\n      id: `field-${id}`,\n      descriptionId: `field-${id}-description`,\n      hasDescription,\n      setHasDescription,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    }),\n    [id, hasDescription, labelPosition, inputStyle, inputColor],\n  )\n\n  return (\n    <FieldContext.Provider value={value}>\n      <div\n        role=\"group\"\n        data-slot=\"field\"\n        data-label-position={labelPosition}\n        data-input-style={inputStyle}\n        data-input-color={inputColor}\n        className={cn(\n          fieldVariants({ labelPosition, inputStyle, inputColor }),\n          className,\n        )}\n        {...props}\n      />\n    </FieldContext.Provider>\n  )\n}\n\nfunction FieldContent({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-content\"\n      className={cn(\n        'flex min-w-0 flex-1 flex-col gap-0.5 leading-snug',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldLabel({\n  className,\n  htmlFor,\n  srOnly,\n  ...props\n}: React.ComponentProps<'label'> & { srOnly?: boolean }) {\n  const field = useFieldContext()\n  return (\n    <label\n      data-slot=\"field-label\"\n      className={cn(\n        // labels stay full-contrast even when disabled — the control itself\n        // (dimmed text, gray shell) signals the state\n        'text-sm leading-5 font-normal text-gray-light transition-all group-data-[invalid=true]/field:text-error-active! motion-reduce:transition-none',\n        // visually hidden but kept in the a11y tree (still names + focuses the control)\n        srOnly && 'sr-only',\n        className,\n      )}\n      htmlFor={htmlFor ?? field?.id}\n      {...props}\n    />\n  )\n}\n\nfunction FieldValue({\n  className,\n  id,\n  title,\n  truncate,\n  children,\n  ...props\n}: React.ComponentProps<'div'> & { truncate?: boolean }) {\n  const field = useFieldContext()\n  return (\n    <div\n      data-slot=\"field-value\"\n      id={id ?? field?.id}\n      // truncated string values keep the full text reachable on hover\n      title={\n        title ??\n        (truncate && typeof children === 'string' ? children : undefined)\n      }\n      className={cn(\n        // values are content, not controls — disabled dims but stays ≥4.5:1\n        'min-h-8 w-full text-base text-gray tabular-nums group-data-[disabled=true]/field:opacity-70',\n        truncate\n          ? 'block truncate leading-8'\n          : 'inline-flex items-center wrap-anywhere whitespace-pre-wrap',\n        className,\n      )}\n      {...props}\n    >\n      {children}\n    </div>\n  )\n}\n\nfunction FieldTitle({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-title\"\n      className={cn(\n        'flex w-fit items-center gap-2 text-sm font-medium text-gray',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldDescription({\n  className,\n  id,\n  ...props\n}: React.ComponentProps<'div'>) {\n  const field = useFieldContext()\n  const setHasDescription = field?.setHasDescription\n\n  React.useEffect(() => {\n    if (!setHasDescription) return\n    setHasDescription(true)\n    return () => setHasDescription(false)\n  }, [setHasDescription])\n\n  return (\n    <div\n      data-slot=\"field-description\"\n      id={id ?? field?.descriptionId}\n      className={cn('mt-0.5 text-sm leading-normal text-gray-light', className)}\n      {...props}\n    />\n  )\n}\n\nfunction FieldSeparator({\n  children,\n  className,\n  ...props\n}: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-separator\"\n      data-content={!!children}\n      className={cn('relative -my-2 h-5 text-sm', className)}\n      {...props}\n    >\n      <Separator className=\"absolute inset-0 top-1/2\" />\n      {children && (\n        <span\n          className=\"relative mx-auto block w-fit bg-(--spark-background) px-2 text-gray-light\"\n          data-slot=\"field-separator-content\"\n        >\n          {children}\n        </span>\n      )}\n    </div>\n  )\n}\n\nfunction FieldError({\n  className,\n  children,\n  errors,\n  ...props\n}: React.ComponentProps<'div'> & {\n  errors?: Array<{ message?: string } | undefined>\n}) {\n  const content = React.useMemo(() => {\n    if (children) return children\n    if (!errors?.length) return null\n    const unique = [\n      ...new Map(errors.map((error) => [error?.message, error])).values(),\n    ]\n    if (unique.length === 1) return unique[0]?.message\n    return (\n      <ul className=\"ml-4 flex list-disc flex-col gap-1\">\n        {unique.map(\n          (error, index) =>\n            error?.message && <li key={index}>{error.message}</li>,\n        )}\n      </ul>\n    )\n  }, [children, errors])\n\n  if (!content) return null\n\n  return (\n    <div\n      role=\"alert\"\n      data-slot=\"field-error\"\n      className={cn('mt-0.5 text-sm font-normal text-error', className)}\n      {...props}\n    >\n      {content}\n    </div>\n  )\n}\n\nexport {\n  Field,\n  FieldContent,\n  FieldDescription,\n  FieldError,\n  FieldGroup,\n  FieldLabel,\n  FieldLegend,\n  FieldSeparator,\n  FieldSet,\n  FieldTitle,\n  FieldValue,\n}\nexport type { FieldProps }\n"],"mappings":"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"}

package/dist/components/field.d.cts

@@ -0,0 +1,103 @@
+"use client";
+
+import { a as SparkLabelPosition, i as SparkInputStyle, r as SparkInputColor } from "../theme-types-8wjgiNA_.cjs";
+import * as React$1 from "react";
+
+//#region src/components/field.d.ts
+type FieldContextValue = {
+  id: string;
+  descriptionId: string;
+  hasDescription: boolean;
+  setHasDescription: (has: boolean) => void;
+  labelPosition: SparkLabelPosition;
+  inputStyle: SparkInputStyle;
+  inputColor: SparkInputColor;
+};
+declare function useFieldContext(): FieldContextValue | null;
+declare function useFieldControl(options?: {
+  id?: string;
+  ariaDescribedBy?: string;
+  variant?: SparkInputStyle;
+}): {
+  field: FieldContextValue | null;
+  id: string | undefined;
+  ariaDescribedBy: string | undefined;
+  inputStyle: SparkInputStyle;
+  inputColor: SparkInputColor;
+};
+declare function FieldSet({
+  className,
+  ...props
+}: React$1.ComponentProps<'fieldset'>): import("react/jsx-runtime").JSX.Element;
+declare function FieldLegend({
+  className,
+  variant,
+  ...props
+}: React$1.ComponentProps<'legend'> & {
+  variant?: 'legend' | 'label';
+}): import("react/jsx-runtime").JSX.Element;
+declare function FieldGroup({
+  className,
+  ...props
+}: React$1.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+interface FieldProps extends React$1.ComponentProps<'div'> {
+  labelPosition?: SparkLabelPosition;
+  inputStyle?: SparkInputStyle;
+  inputColor?: SparkInputColor;
+}
+declare function Field({
+  className,
+  labelPosition: labelPositionProp,
+  inputStyle: inputStyleProp,
+  inputColor: inputColorProp,
+  ...props
+}: FieldProps): import("react/jsx-runtime").JSX.Element;
+declare function FieldContent({
+  className,
+  ...props
+}: React$1.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+declare function FieldLabel({
+  className,
+  htmlFor,
+  srOnly,
+  ...props
+}: React$1.ComponentProps<'label'> & {
+  srOnly?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+declare function FieldValue({
+  className,
+  id,
+  title,
+  truncate,
+  children,
+  ...props
+}: React$1.ComponentProps<'div'> & {
+  truncate?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+declare function FieldTitle({
+  className,
+  ...props
+}: React$1.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+declare function FieldDescription({
+  className,
+  id,
+  ...props
+}: React$1.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+declare function FieldSeparator({
+  children,
+  className,
+  ...props
+}: React$1.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+declare function FieldError({
+  className,
+  children,
+  errors,
+  ...props
+}: React$1.ComponentProps<'div'> & {
+  errors?: Array<{
+    message?: string;
+  } | undefined>;
+}): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldTitle, FieldValue, useFieldContext, useFieldControl };
+//# sourceMappingURL=field.d.cts.map

package/dist/components/field.d.ts

@@ -0,0 +1,103 @@
+"use client";
+
+import { a as SparkLabelPosition, i as SparkInputStyle, r as SparkInputColor } from "../theme-types-8wjgiNA_.js";
+import * as React$1 from "react";
+
+//#region src/components/field.d.ts
+type FieldContextValue = {
+  id: string;
+  descriptionId: string;
+  hasDescription: boolean;
+  setHasDescription: (has: boolean) => void;
+  labelPosition: SparkLabelPosition;
+  inputStyle: SparkInputStyle;
+  inputColor: SparkInputColor;
+};
+declare function useFieldContext(): FieldContextValue | null;
+declare function useFieldControl(options?: {
+  id?: string;
+  ariaDescribedBy?: string;
+  variant?: SparkInputStyle;
+}): {
+  field: FieldContextValue | null;
+  id: string | undefined;
+  ariaDescribedBy: string | undefined;
+  inputStyle: SparkInputStyle;
+  inputColor: SparkInputColor;
+};
+declare function FieldSet({
+  className,
+  ...props
+}: React$1.ComponentProps<'fieldset'>): import("react/jsx-runtime").JSX.Element;
+declare function FieldLegend({
+  className,
+  variant,
+  ...props
+}: React$1.ComponentProps<'legend'> & {
+  variant?: 'legend' | 'label';
+}): import("react/jsx-runtime").JSX.Element;
+declare function FieldGroup({
+  className,
+  ...props
+}: React$1.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+interface FieldProps extends React$1.ComponentProps<'div'> {
+  labelPosition?: SparkLabelPosition;
+  inputStyle?: SparkInputStyle;
+  inputColor?: SparkInputColor;
+}
+declare function Field({
+  className,
+  labelPosition: labelPositionProp,
+  inputStyle: inputStyleProp,
+  inputColor: inputColorProp,
+  ...props
+}: FieldProps): import("react/jsx-runtime").JSX.Element;
+declare function FieldContent({
+  className,
+  ...props
+}: React$1.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+declare function FieldLabel({
+  className,
+  htmlFor,
+  srOnly,
+  ...props
+}: React$1.ComponentProps<'label'> & {
+  srOnly?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+declare function FieldValue({
+  className,
+  id,
+  title,
+  truncate,
+  children,
+  ...props
+}: React$1.ComponentProps<'div'> & {
+  truncate?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+declare function FieldTitle({
+  className,
+  ...props
+}: React$1.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+declare function FieldDescription({
+  className,
+  id,
+  ...props
+}: React$1.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+declare function FieldSeparator({
+  children,
+  className,
+  ...props
+}: React$1.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+declare function FieldError({
+  className,
+  children,
+  errors,
+  ...props
+}: React$1.ComponentProps<'div'> & {
+  errors?: Array<{
+    message?: string;
+  } | undefined>;
+}): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldTitle, FieldValue, useFieldContext, useFieldControl };
+//# sourceMappingURL=field.d.ts.map