@epilot/spark-ui 0.26.0 → 0.27.0

package/dist/components/entity-card.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"entity-card.cjs","names":[],"sources":["../../src/components/entity-card.tsx"],"sourcesContent":["import type { SparkIcon } from '@epilot/spark-icons'\nimport { cva } from 'class-variance-authority'\nimport * as React from 'react'\nimport type { Tone } from '../lib/tones'\nimport { cn } from '../utils/cn'\n\nconst EntityCard = ({ className, ...rest }: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex flex-col overflow-hidden rounded-lg border border-gray bg-(--spark-background)',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardBody = ({\n  className,\n  active,\n  ...rest\n}: React.ComponentProps<'button'> & { active?: boolean }) => (\n  <button\n    type=\"button\"\n    className={cn(\n      'flex w-full cursor-pointer flex-col gap-3 p-4 text-left transition-colors hover:bg-gray-a2 focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent-focus',\n      active && 'bg-linear-to-br from-spark-9/10 to-spark-1/5 to-20%',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardHeader = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div className={cn('flex w-full items-center gap-3', className)} {...rest} />\n)\n\nconst EntityCardMeters = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn('flex flex-col gap-2 border-t border-gray pt-3', className)}\n    {...rest}\n  />\n)\n\nconst iconToneVariants = cva(\n  // max() pill escape (matches Icon): a tile stays rounded-md at low Roundness but\n  // becomes a circle at large/full, same as it did pre-harmonization via clamping.\n  'flex size-11 shrink-0 items-center justify-center rounded-[max(var(--spark-rounded-md),var(--spark-rounded-full))]',\n  {\n    variants: {\n      tone: {\n        success: 'bg-success-soft text-success-soft-foreground',\n        warning: 'bg-warning-soft text-warning-soft-foreground',\n        error: 'bg-error-soft text-error-soft-foreground',\n        accent: 'bg-primary-soft text-primary-soft-foreground',\n        neutral: 'bg-base-gray-soft text-gray',\n      },\n    },\n    defaultVariants: { tone: 'neutral' },\n  },\n)\n\nconst EntityCardIcon = ({\n  className,\n  icon: Glyph,\n  tone,\n  ...rest\n}: React.ComponentProps<'span'> & {\n  icon: SparkIcon\n  tone?: Tone\n}) => (\n  <span className={iconToneVariants({ tone, className })} {...rest}>\n    <Glyph className=\"[--spark-icon-size:18px]\" />\n  </span>\n)\n\nconst EntityCardTitleColumn = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn('flex min-w-0 flex-1 flex-col gap-0.5', className)}\n    {...rest}\n  />\n)\n\nconst EntityCardTitle = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn('truncate text-sm font-bold text-gray', className)}\n    {...rest}\n  />\n)\n\nconst stateToneVariants = cva(\n  'inline-flex items-center gap-1.5 text-xs font-medium',\n  {\n    variants: {\n      tone: {\n        success: 'text-success',\n        warning: 'text-warning',\n        error: 'text-error',\n        accent: 'text-accent',\n        neutral: 'text-gray-light',\n      },\n    },\n    defaultVariants: { tone: 'neutral' },\n  },\n)\n\nconst dotToneVariants = cva('size-1.5 shrink-0 rounded-full', {\n  variants: {\n    tone: {\n      success: 'bg-base-success-solid',\n      warning: 'bg-base-warning-solid',\n      error: 'bg-base-error-solid',\n      accent: 'bg-primary',\n      neutral: 'bg-base-gray-solid',\n    },\n  },\n  defaultVariants: { tone: 'neutral' },\n})\n\nconst EntityCardState = ({\n  className,\n  tone,\n  children,\n  ...rest\n}: React.ComponentProps<'span'> & { tone?: Tone }) => (\n  <span className={stateToneVariants({ tone, className })} {...rest}>\n    <span className={dotToneVariants({ tone })} />\n    <span className=\"truncate\">{children}</span>\n  </span>\n)\n\nconst EntityCardDetail = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn('truncate text-xs text-gray-light tabular-nums', className)}\n    {...rest}\n  />\n)\n\nconst EntityCardValue = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn(\n      'ms-2 shrink-0 self-center text-lg leading-tight font-bold text-gray tabular-nums',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardControls = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex items-center gap-3 border-t border-gray bg-base-gray-surface px-4 py-3',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardFooter = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex items-center justify-center gap-1.5 border-t border-gray bg-base-gray-surface px-4 py-2 text-xs text-gray-light',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nexport {\n  EntityCard,\n  EntityCardBody,\n  EntityCardControls,\n  EntityCardDetail,\n  EntityCardFooter,\n  EntityCardHeader,\n  EntityCardIcon,\n  EntityCardMeters,\n  EntityCardState,\n  EntityCardTitle,\n  EntityCardTitleColumn,\n  EntityCardValue,\n}\n"],"mappings":"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"}
+{"version":3,"file":"entity-card.cjs","names":[],"sources":["../../src/components/entity-card.tsx"],"sourcesContent":["import type { SparkIcon } from '@epilot/spark-icons'\nimport { cva } from 'class-variance-authority'\nimport * as React from 'react'\nimport type { Tone } from '../lib/tones'\nimport { cn } from '../utils/cn'\n\nconst EntityCard = ({ className, ...rest }: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex flex-col overflow-hidden rounded-lg border border-gray bg-(--spark-background)',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardBody = ({\n  className,\n  active,\n  ...rest\n}: React.ComponentProps<'button'> & { active?: boolean }) => (\n  <button\n    type=\"button\"\n    className={cn(\n      'flex w-full cursor-pointer flex-col gap-3 p-4 text-left transition-colors hover:bg-gray-a2 focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent-focus',\n      active && 'bg-linear-to-br from-spark-9/10 to-spark-1/5 to-20%',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardHeader = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div className={cn('flex w-full items-center gap-3', className)} {...rest} />\n)\n\nconst EntityCardMeters = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn('flex flex-col gap-2 border-t border-gray pt-3', className)}\n    {...rest}\n  />\n)\n\nconst iconToneVariants = cva(\n  // max() pill escape (matches Icon): a tile stays rounded-md at low Roundness but\n  // becomes a circle at large/full, same as it did pre-harmonization via clamping.\n  'flex size-11 shrink-0 items-center justify-center rounded-[max(var(--spark-rounded-md),var(--spark-rounded-full))]',\n  {\n    variants: {\n      tone: {\n        success: 'bg-success-soft text-success-soft-foreground',\n        warning: 'bg-warning-soft text-warning-soft-foreground',\n        error: 'bg-error-soft text-error-soft-foreground',\n        accent: 'bg-primary-soft text-primary-soft-foreground',\n        neutral: 'bg-base-gray-soft text-gray',\n      },\n    },\n    defaultVariants: { tone: 'neutral' },\n  },\n)\n\nconst EntityCardIcon = ({\n  className,\n  icon: Glyph,\n  tone,\n  ...rest\n}: React.ComponentProps<'span'> & {\n  icon: SparkIcon\n  tone?: Tone\n}) => (\n  <span className={iconToneVariants({ tone, className })} {...rest}>\n    <Glyph className=\"[--spark-icon-size:18px]\" />\n  </span>\n)\n\nconst EntityCardTitleColumn = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn('flex min-w-0 flex-1 flex-col gap-1', className)}\n    {...rest}\n  />\n)\n\nconst EntityCardTitle = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn('truncate text-sm font-bold text-gray', className)}\n    {...rest}\n  />\n)\n\nconst stateToneVariants = cva(\n  'inline-flex items-center gap-1.5 text-xs font-medium',\n  {\n    variants: {\n      tone: {\n        success: 'text-success',\n        warning: 'text-warning',\n        error: 'text-error',\n        accent: 'text-accent',\n        neutral: 'text-gray-light',\n      },\n    },\n    defaultVariants: { tone: 'neutral' },\n  },\n)\n\nconst dotToneVariants = cva('size-1.5 shrink-0 rounded-full', {\n  variants: {\n    tone: {\n      success: 'bg-base-success-solid',\n      warning: 'bg-base-warning-solid',\n      error: 'bg-base-error-solid',\n      accent: 'bg-primary',\n      neutral: 'bg-base-gray-solid',\n    },\n  },\n  defaultVariants: { tone: 'neutral' },\n})\n\nconst EntityCardState = ({\n  className,\n  tone,\n  children,\n  ...rest\n}: React.ComponentProps<'span'> & { tone?: Tone }) => (\n  <span className={stateToneVariants({ tone, className })} {...rest}>\n    <span className={dotToneVariants({ tone })} />\n    <span className=\"truncate\">{children}</span>\n  </span>\n)\n\nconst EntityCardDetail = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn('truncate text-xs text-gray-light tabular-nums', className)}\n    {...rest}\n  />\n)\n\nconst EntityCardValue = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn(\n      'ms-2 shrink-0 self-center text-lg leading-tight font-bold text-gray tabular-nums',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardControls = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex items-center gap-3 border-t border-gray bg-base-gray-surface px-4 py-3',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardFooter = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex items-center justify-center gap-1.5 border-t border-gray bg-base-gray-surface px-4 py-2 text-xs text-gray-light',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nexport {\n  EntityCard,\n  EntityCardBody,\n  EntityCardControls,\n  EntityCardDetail,\n  EntityCardFooter,\n  EntityCardHeader,\n  EntityCardIcon,\n  EntityCardMeters,\n  EntityCardState,\n  EntityCardTitle,\n  EntityCardTitleColumn,\n  EntityCardValue,\n}\n"],"mappings":"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"}

package/dist/components/entity-card.js

@@ -40,7 +40,7 @@ const EntityCardIcon = ({ className, icon: Glyph, tone, ...rest }) => /* @__PURE
 	children: /* @__PURE__ */ jsx(Glyph, { className: "[--spark-icon-size:18px]" })
 });
 const EntityCardTitleColumn = ({ className, ...rest }) => /* @__PURE__ */ jsx("div", {
-	className: cn("flex min-w-0 flex-1 flex-col gap-0.5", className),
+	className: cn("flex min-w-0 flex-1 flex-col gap-1", className),
 	...rest
 });
 const EntityCardTitle = ({ className, ...rest }) => /* @__PURE__ */ jsx("span", {

package/dist/components/entity-card.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-card.js","names":[],"sources":["../../src/components/entity-card.tsx"],"sourcesContent":["import type { SparkIcon } from '@epilot/spark-icons'\nimport { cva } from 'class-variance-authority'\nimport * as React from 'react'\nimport type { Tone } from '../lib/tones'\nimport { cn } from '../utils/cn'\n\nconst EntityCard = ({ className, ...rest }: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex flex-col overflow-hidden rounded-lg border border-gray bg-(--spark-background)',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardBody = ({\n  className,\n  active,\n  ...rest\n}: React.ComponentProps<'button'> & { active?: boolean }) => (\n  <button\n    type=\"button\"\n    className={cn(\n      'flex w-full cursor-pointer flex-col gap-3 p-4 text-left transition-colors hover:bg-gray-a2 focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent-focus',\n      active && 'bg-linear-to-br from-spark-9/10 to-spark-1/5 to-20%',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardHeader = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div className={cn('flex w-full items-center gap-3', className)} {...rest} />\n)\n\nconst EntityCardMeters = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn('flex flex-col gap-2 border-t border-gray pt-3', className)}\n    {...rest}\n  />\n)\n\nconst iconToneVariants = cva(\n  // max() pill escape (matches Icon): a tile stays rounded-md at low Roundness but\n  // becomes a circle at large/full, same as it did pre-harmonization via clamping.\n  'flex size-11 shrink-0 items-center justify-center rounded-[max(var(--spark-rounded-md),var(--spark-rounded-full))]',\n  {\n    variants: {\n      tone: {\n        success: 'bg-success-soft text-success-soft-foreground',\n        warning: 'bg-warning-soft text-warning-soft-foreground',\n        error: 'bg-error-soft text-error-soft-foreground',\n        accent: 'bg-primary-soft text-primary-soft-foreground',\n        neutral: 'bg-base-gray-soft text-gray',\n      },\n    },\n    defaultVariants: { tone: 'neutral' },\n  },\n)\n\nconst EntityCardIcon = ({\n  className,\n  icon: Glyph,\n  tone,\n  ...rest\n}: React.ComponentProps<'span'> & {\n  icon: SparkIcon\n  tone?: Tone\n}) => (\n  <span className={iconToneVariants({ tone, className })} {...rest}>\n    <Glyph className=\"[--spark-icon-size:18px]\" />\n  </span>\n)\n\nconst EntityCardTitleColumn = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn('flex min-w-0 flex-1 flex-col gap-0.5', className)}\n    {...rest}\n  />\n)\n\nconst EntityCardTitle = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn('truncate text-sm font-bold text-gray', className)}\n    {...rest}\n  />\n)\n\nconst stateToneVariants = cva(\n  'inline-flex items-center gap-1.5 text-xs font-medium',\n  {\n    variants: {\n      tone: {\n        success: 'text-success',\n        warning: 'text-warning',\n        error: 'text-error',\n        accent: 'text-accent',\n        neutral: 'text-gray-light',\n      },\n    },\n    defaultVariants: { tone: 'neutral' },\n  },\n)\n\nconst dotToneVariants = cva('size-1.5 shrink-0 rounded-full', {\n  variants: {\n    tone: {\n      success: 'bg-base-success-solid',\n      warning: 'bg-base-warning-solid',\n      error: 'bg-base-error-solid',\n      accent: 'bg-primary',\n      neutral: 'bg-base-gray-solid',\n    },\n  },\n  defaultVariants: { tone: 'neutral' },\n})\n\nconst EntityCardState = ({\n  className,\n  tone,\n  children,\n  ...rest\n}: React.ComponentProps<'span'> & { tone?: Tone }) => (\n  <span className={stateToneVariants({ tone, className })} {...rest}>\n    <span className={dotToneVariants({ tone })} />\n    <span className=\"truncate\">{children}</span>\n  </span>\n)\n\nconst EntityCardDetail = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn('truncate text-xs text-gray-light tabular-nums', className)}\n    {...rest}\n  />\n)\n\nconst EntityCardValue = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn(\n      'ms-2 shrink-0 self-center text-lg leading-tight font-bold text-gray tabular-nums',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardControls = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex items-center gap-3 border-t border-gray bg-base-gray-surface px-4 py-3',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardFooter = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex items-center justify-center gap-1.5 border-t border-gray bg-base-gray-surface px-4 py-2 text-xs text-gray-light',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nexport {\n  EntityCard,\n  EntityCardBody,\n  EntityCardControls,\n  EntityCardDetail,\n  EntityCardFooter,\n  EntityCardHeader,\n  EntityCardIcon,\n  EntityCardMeters,\n  EntityCardState,\n  EntityCardTitle,\n  EntityCardTitleColumn,\n  EntityCardValue,\n}\n"],"mappings":";;;;;;AAMA,MAAM,cAAc,EAAE,WAAW,GAAG,WAClC,oBAAC,OAAD;CACE,WAAW,GACT,uFACA,SACF;CACA,GAAI;AACL,CAAA;AAGH,MAAM,kBAAkB,EACtB,WACA,QACA,GAAG,WAEH,oBAAC,UAAD;CACE,MAAK;CACL,WAAW,GACT,yLACA,UAAU,uDACV,SACF;CACA,GAAI;AACL,CAAA;AAGH,MAAM,oBAAoB,EACxB,WACA,GAAG,WAEH,oBAAC,OAAD;CAAK,WAAW,GAAG,kCAAkC,SAAS;CAAG,GAAI;AAAO,CAAA;AAG9E,MAAM,oBAAoB,EACxB,WACA,GAAG,WAEH,oBAAC,OAAD;CACE,WAAW,GAAG,iDAAiD,SAAS;CACxE,GAAI;AACL,CAAA;AAGH,MAAM,mBAAmB,IAGvB,sHACA;CACE,UAAU,EACR,MAAM;EACJ,SAAS;EACT,SAAS;EACT,OAAO;EACP,QAAQ;EACR,SAAS;CACX,EACF;CACA,iBAAiB,EAAE,MAAM,UAAU;AACrC,CACF;AAEA,MAAM,kBAAkB,EACtB,WACA,MAAM,OACN,MACA,GAAG,WAKH,oBAAC,QAAD;CAAM,WAAW,iBAAiB;EAAE;EAAM;CAAU,CAAC;CAAG,GAAI;WAC1D,oBAAC,OAAD,EAAO,WAAU,2BAA4B,CAAA;AACzC,CAAA;AAGR,MAAM,yBAAyB,EAC7B,WACA,GAAG,WAEH,oBAAC,OAAD;CACE,WAAW,GAAG,wCAAwC,SAAS;CAC/D,GAAI;AACL,CAAA;AAGH,MAAM,mBAAmB,EACvB,WACA,GAAG,WAEH,oBAAC,QAAD;CACE,WAAW,GAAG,wCAAwC,SAAS;CAC/D,GAAI;AACL,CAAA;AAGH,MAAM,oBAAoB,IACxB,wDACA;CACE,UAAU,EACR,MAAM;EACJ,SAAS;EACT,SAAS;EACT,OAAO;EACP,QAAQ;EACR,SAAS;CACX,EACF;CACA,iBAAiB,EAAE,MAAM,UAAU;AACrC,CACF;AAEA,MAAM,kBAAkB,IAAI,kCAAkC;CAC5D,UAAU,EACR,MAAM;EACJ,SAAS;EACT,SAAS;EACT,OAAO;EACP,QAAQ;EACR,SAAS;CACX,EACF;CACA,iBAAiB,EAAE,MAAM,UAAU;AACrC,CAAC;AAED,MAAM,mBAAmB,EACvB,WACA,MACA,UACA,GAAG,WAEH,qBAAC,QAAD;CAAM,WAAW,kBAAkB;EAAE;EAAM;CAAU,CAAC;CAAG,GAAI;WAA7D,CACE,oBAAC,QAAD,EAAM,WAAW,gBAAgB,EAAE,KAAK,CAAC,EAAI,CAAA,GAC7C,oBAAC,QAAD;EAAM,WAAU;EAAY;CAAe,CAAA,CACvC;;AAGR,MAAM,oBAAoB,EACxB,WACA,GAAG,WAEH,oBAAC,QAAD;CACE,WAAW,GAAG,iDAAiD,SAAS;CACxE,GAAI;AACL,CAAA;AAGH,MAAM,mBAAmB,EACvB,WACA,GAAG,WAEH,oBAAC,QAAD;CACE,WAAW,GACT,oFACA,SACF;CACA,GAAI;AACL,CAAA;AAGH,MAAM,sBAAsB,EAC1B,WACA,GAAG,WAEH,oBAAC,OAAD;CACE,WAAW,GACT,+EACA,SACF;CACA,GAAI;AACL,CAAA;AAGH,MAAM,oBAAoB,EACxB,WACA,GAAG,WAEH,oBAAC,OAAD;CACE,WAAW,GACT,wHACA,SACF;CACA,GAAI;AACL,CAAA"}
+{"version":3,"file":"entity-card.js","names":[],"sources":["../../src/components/entity-card.tsx"],"sourcesContent":["import type { SparkIcon } from '@epilot/spark-icons'\nimport { cva } from 'class-variance-authority'\nimport * as React from 'react'\nimport type { Tone } from '../lib/tones'\nimport { cn } from '../utils/cn'\n\nconst EntityCard = ({ className, ...rest }: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex flex-col overflow-hidden rounded-lg border border-gray bg-(--spark-background)',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardBody = ({\n  className,\n  active,\n  ...rest\n}: React.ComponentProps<'button'> & { active?: boolean }) => (\n  <button\n    type=\"button\"\n    className={cn(\n      'flex w-full cursor-pointer flex-col gap-3 p-4 text-left transition-colors hover:bg-gray-a2 focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent-focus',\n      active && 'bg-linear-to-br from-spark-9/10 to-spark-1/5 to-20%',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardHeader = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div className={cn('flex w-full items-center gap-3', className)} {...rest} />\n)\n\nconst EntityCardMeters = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn('flex flex-col gap-2 border-t border-gray pt-3', className)}\n    {...rest}\n  />\n)\n\nconst iconToneVariants = cva(\n  // max() pill escape (matches Icon): a tile stays rounded-md at low Roundness but\n  // becomes a circle at large/full, same as it did pre-harmonization via clamping.\n  'flex size-11 shrink-0 items-center justify-center rounded-[max(var(--spark-rounded-md),var(--spark-rounded-full))]',\n  {\n    variants: {\n      tone: {\n        success: 'bg-success-soft text-success-soft-foreground',\n        warning: 'bg-warning-soft text-warning-soft-foreground',\n        error: 'bg-error-soft text-error-soft-foreground',\n        accent: 'bg-primary-soft text-primary-soft-foreground',\n        neutral: 'bg-base-gray-soft text-gray',\n      },\n    },\n    defaultVariants: { tone: 'neutral' },\n  },\n)\n\nconst EntityCardIcon = ({\n  className,\n  icon: Glyph,\n  tone,\n  ...rest\n}: React.ComponentProps<'span'> & {\n  icon: SparkIcon\n  tone?: Tone\n}) => (\n  <span className={iconToneVariants({ tone, className })} {...rest}>\n    <Glyph className=\"[--spark-icon-size:18px]\" />\n  </span>\n)\n\nconst EntityCardTitleColumn = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn('flex min-w-0 flex-1 flex-col gap-1', className)}\n    {...rest}\n  />\n)\n\nconst EntityCardTitle = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn('truncate text-sm font-bold text-gray', className)}\n    {...rest}\n  />\n)\n\nconst stateToneVariants = cva(\n  'inline-flex items-center gap-1.5 text-xs font-medium',\n  {\n    variants: {\n      tone: {\n        success: 'text-success',\n        warning: 'text-warning',\n        error: 'text-error',\n        accent: 'text-accent',\n        neutral: 'text-gray-light',\n      },\n    },\n    defaultVariants: { tone: 'neutral' },\n  },\n)\n\nconst dotToneVariants = cva('size-1.5 shrink-0 rounded-full', {\n  variants: {\n    tone: {\n      success: 'bg-base-success-solid',\n      warning: 'bg-base-warning-solid',\n      error: 'bg-base-error-solid',\n      accent: 'bg-primary',\n      neutral: 'bg-base-gray-solid',\n    },\n  },\n  defaultVariants: { tone: 'neutral' },\n})\n\nconst EntityCardState = ({\n  className,\n  tone,\n  children,\n  ...rest\n}: React.ComponentProps<'span'> & { tone?: Tone }) => (\n  <span className={stateToneVariants({ tone, className })} {...rest}>\n    <span className={dotToneVariants({ tone })} />\n    <span className=\"truncate\">{children}</span>\n  </span>\n)\n\nconst EntityCardDetail = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn('truncate text-xs text-gray-light tabular-nums', className)}\n    {...rest}\n  />\n)\n\nconst EntityCardValue = ({\n  className,\n  ...rest\n}: React.ComponentProps<'span'>) => (\n  <span\n    className={cn(\n      'ms-2 shrink-0 self-center text-lg leading-tight font-bold text-gray tabular-nums',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardControls = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex items-center gap-3 border-t border-gray bg-base-gray-surface px-4 py-3',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nconst EntityCardFooter = ({\n  className,\n  ...rest\n}: React.ComponentProps<'div'>) => (\n  <div\n    className={cn(\n      'flex items-center justify-center gap-1.5 border-t border-gray bg-base-gray-surface px-4 py-2 text-xs text-gray-light',\n      className,\n    )}\n    {...rest}\n  />\n)\n\nexport {\n  EntityCard,\n  EntityCardBody,\n  EntityCardControls,\n  EntityCardDetail,\n  EntityCardFooter,\n  EntityCardHeader,\n  EntityCardIcon,\n  EntityCardMeters,\n  EntityCardState,\n  EntityCardTitle,\n  EntityCardTitleColumn,\n  EntityCardValue,\n}\n"],"mappings":";;;;;;AAMA,MAAM,cAAc,EAAE,WAAW,GAAG,WAClC,oBAAC,OAAD;CACE,WAAW,GACT,uFACA,SACF;CACA,GAAI;AACL,CAAA;AAGH,MAAM,kBAAkB,EACtB,WACA,QACA,GAAG,WAEH,oBAAC,UAAD;CACE,MAAK;CACL,WAAW,GACT,yLACA,UAAU,uDACV,SACF;CACA,GAAI;AACL,CAAA;AAGH,MAAM,oBAAoB,EACxB,WACA,GAAG,WAEH,oBAAC,OAAD;CAAK,WAAW,GAAG,kCAAkC,SAAS;CAAG,GAAI;AAAO,CAAA;AAG9E,MAAM,oBAAoB,EACxB,WACA,GAAG,WAEH,oBAAC,OAAD;CACE,WAAW,GAAG,iDAAiD,SAAS;CACxE,GAAI;AACL,CAAA;AAGH,MAAM,mBAAmB,IAGvB,sHACA;CACE,UAAU,EACR,MAAM;EACJ,SAAS;EACT,SAAS;EACT,OAAO;EACP,QAAQ;EACR,SAAS;CACX,EACF;CACA,iBAAiB,EAAE,MAAM,UAAU;AACrC,CACF;AAEA,MAAM,kBAAkB,EACtB,WACA,MAAM,OACN,MACA,GAAG,WAKH,oBAAC,QAAD;CAAM,WAAW,iBAAiB;EAAE;EAAM;CAAU,CAAC;CAAG,GAAI;WAC1D,oBAAC,OAAD,EAAO,WAAU,2BAA4B,CAAA;AACzC,CAAA;AAGR,MAAM,yBAAyB,EAC7B,WACA,GAAG,WAEH,oBAAC,OAAD;CACE,WAAW,GAAG,sCAAsC,SAAS;CAC7D,GAAI;AACL,CAAA;AAGH,MAAM,mBAAmB,EACvB,WACA,GAAG,WAEH,oBAAC,QAAD;CACE,WAAW,GAAG,wCAAwC,SAAS;CAC/D,GAAI;AACL,CAAA;AAGH,MAAM,oBAAoB,IACxB,wDACA;CACE,UAAU,EACR,MAAM;EACJ,SAAS;EACT,SAAS;EACT,OAAO;EACP,QAAQ;EACR,SAAS;CACX,EACF;CACA,iBAAiB,EAAE,MAAM,UAAU;AACrC,CACF;AAEA,MAAM,kBAAkB,IAAI,kCAAkC;CAC5D,UAAU,EACR,MAAM;EACJ,SAAS;EACT,SAAS;EACT,OAAO;EACP,QAAQ;EACR,SAAS;CACX,EACF;CACA,iBAAiB,EAAE,MAAM,UAAU;AACrC,CAAC;AAED,MAAM,mBAAmB,EACvB,WACA,MACA,UACA,GAAG,WAEH,qBAAC,QAAD;CAAM,WAAW,kBAAkB;EAAE;EAAM;CAAU,CAAC;CAAG,GAAI;WAA7D,CACE,oBAAC,QAAD,EAAM,WAAW,gBAAgB,EAAE,KAAK,CAAC,EAAI,CAAA,GAC7C,oBAAC,QAAD;EAAM,WAAU;EAAY;CAAe,CAAA,CACvC;;AAGR,MAAM,oBAAoB,EACxB,WACA,GAAG,WAEH,oBAAC,QAAD;CACE,WAAW,GAAG,iDAAiD,SAAS;CACxE,GAAI;AACL,CAAA;AAGH,MAAM,mBAAmB,EACvB,WACA,GAAG,WAEH,oBAAC,QAAD;CACE,WAAW,GACT,oFACA,SACF;CACA,GAAI;AACL,CAAA;AAGH,MAAM,sBAAsB,EAC1B,WACA,GAAG,WAEH,oBAAC,OAAD;CACE,WAAW,GACT,+EACA,SACF;CACA,GAAI;AACL,CAAA;AAGH,MAAM,oBAAoB,EACxB,WACA,GAAG,WAEH,oBAAC,OAAD;CACE,WAAW,GACT,wHACA,SACF;CACA,GAAI;AACL,CAAA"}

package/dist/components/field.cjs

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../chunk-DY84GLCh.cjs");
 const require_components_theme = require("./theme.cjs");
+const require_components_callout = require("./callout.cjs");
 const require_components_separator = require("./separator.cjs");
 const require_components_skeleton = require("./skeleton.cjs");
 let react = require("react");
@@ -35,19 +36,96 @@ function useFieldControl(options) {
 		inputColor
 	};
 }
-function FieldSet({ className, ...props }) {
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("fieldset", {
-		"data-slot": "field-set",
-		className: (0, cn.cn)("flex flex-col gap-[calc(var(--spark-layout-gap)*4)]", className),
-		...props
+const FieldSetContext = react.createContext(null);
+/** True when the nearest enclosing FieldSet has an error; ignores outer sets. */
+function useFieldSetInvalid() {
+	return react.useContext(FieldSetContext)?.invalid || void 0;
+}
+function useSlotCount() {
+	const [count, setCount] = react.useState(0);
+	const setHas = react.useCallback((has) => setCount((n) => n + (has ? 1 : -1)), []);
+	return [count > 0, setHas];
+}
+function FieldSet({ className, indicator, indicatorLabel, "aria-describedby": ariaDescribedByProp, ...props }) {
+	const id = (0, react.useId)();
+	const [hasDescription, setHasDescription] = useSlotCount();
+	const [hasError, setHasError] = useSlotCount();
+	const [hasUnlinkedError, setHasUnlinkedError] = useSlotCount();
+	const invalid = hasError || hasUnlinkedError;
+	const fieldSetId = `field-set-${id}`;
+	const descriptionId = `${fieldSetId}-description`;
+	const errorId = `${fieldSetId}-error`;
+	const value = react.useMemo(() => ({
+		descriptionId,
+		hasDescription,
+		setHasDescription,
+		errorId,
+		hasError,
+		setHasError,
+		setHasUnlinkedError,
+		invalid,
+		indicator,
+		indicatorLabel
+	}), [
+		descriptionId,
+		hasDescription,
+		setHasDescription,
+		errorId,
+		hasError,
+		setHasError,
+		setHasUnlinkedError,
+		invalid,
+		indicator,
+		indicatorLabel
+	]);
+	const ariaDescribedBy = [
+		hasError && errorId,
+		hasDescription && descriptionId,
+		ariaDescribedByProp
+	].filter(Boolean).join(" ") || void 0;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FieldSetContext.Provider, {
+		value,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("fieldset", {
+			"data-slot": "field-set",
+			"data-invalid": invalid || void 0,
+			"aria-describedby": ariaDescribedBy,
+			className: (0, cn.cn)("group/field-set 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", {
+function FieldLegend({ className, variant = "legend", children, ...props }) {
+	const fieldSet = react.useContext(FieldSetContext);
+	const indicator = fieldSet?.indicator;
+	const indicatorLabel = fieldSet?.indicatorLabel ?? indicator;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("legend", {
+		"data-invalid": fieldSet?.invalid || void 0,
 		"data-slot": "field-legend",
 		"data-variant": variant,
-		className: (0, cn.cn)("mb-1.5 font-medium text-gray data-[variant=label]:text-sm data-[variant=legend]:text-base", className),
-		...props
+		className: (0, cn.cn)("mb-1.5 font-medium text-gray data-[invalid=true]:text-error-active! data-[variant=label]:text-sm data-[variant=legend]:text-base", className),
+		...props,
+		children: [
+			children,
+			indicator === "required" && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				" ",
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					"aria-hidden": "true",
+					children: "*"
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "sr-only",
+					children: indicatorLabel
+				})
+			] }),
+			indicator === "optional" && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [" ", /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+				className: "font-normal text-gray-light",
+				children: [
+					"(",
+					indicatorLabel,
+					")"
+				]
+			})] })
+		]
 	});
 }
 function FieldGroup({ className, ...props }) {
@@ -190,7 +268,7 @@ function Field({ className, children, labelPosition: labelPositionProp, inputSty
 function FieldContent({ className, ...props }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		"data-slot": "field-content",
-		className: (0, cn.cn)("flex min-w-0 flex-1 flex-col gap-0.5 leading-snug", className),
+		className: (0, cn.cn)("flex min-w-0 flex-1 flex-col gap-1 leading-snug", className),
 		...props
 	});
 }
@@ -246,7 +324,9 @@ function FieldTitle({ className, ...props }) {
 }
 function FieldDescription({ className, id, ...props }) {
 	const field = useFieldContext();
-	const setHasDescription = field?.setHasDescription;
+	const fieldSet = react.useContext(FieldSetContext);
+	const owner = field ?? fieldSet;
+	const setHasDescription = owner?.setHasDescription;
 	react.useEffect(() => {
 		if (!setHasDescription) return;
 		setHasDescription(true);
@@ -254,8 +334,8 @@ function FieldDescription({ className, id, ...props }) {
 	}, [setHasDescription]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		"data-slot": "field-description",
-		id: id ?? field?.descriptionId,
-		className: (0, cn.cn)("mt-0.5 text-sm leading-normal text-gray-light", className),
+		id: id ?? owner?.descriptionId,
+		className: (0, cn.cn)("text-sm leading-normal text-gray-light", className),
 		...props
 	});
 }
@@ -274,7 +354,8 @@ function FieldSeparator({ children, className, ...props }) {
 }
 function FieldError({ className, children, errors, id, ...props }) {
 	const field = useFieldContext();
-	const setHasError = field?.setHasError;
+	const fieldSet = react.useContext(FieldSetContext);
+	const setHasError = (field ?? fieldSet)?.setHasError;
 	const content = react.useMemo(() => {
 		if (children) return children;
 		if (!errors?.length) return null;
@@ -287,21 +368,34 @@ function FieldError({ className, children, errors, id, ...props }) {
 	}, [children, errors]);
 	const hasContent = Boolean(content);
 	const hasCustomId = id != null;
+	const setSetUnlinked = !field ? fieldSet?.setHasUnlinkedError : void 0;
 	react.useEffect(() => {
-		if (!setHasError || !hasContent || hasCustomId) return;
-		setHasError(true);
-		return () => setHasError(false);
+		if (!hasContent) return;
+		const set = hasCustomId ? setSetUnlinked : setHasError;
+		if (!set) return;
+		set(true);
+		return () => set(false);
 	}, [
 		setHasError,
+		setSetUnlinked,
 		hasContent,
 		hasCustomId
 	]);
 	if (!content) return null;
+	if (!field && fieldSet) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_callout.Callout, {
+		variant: "error",
+		role: "alert",
+		"data-slot": "field-error",
+		id: id ?? fieldSet.errorId,
+		className,
+		...props,
+		children: content
+	});
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		role: "alert",
 		"data-slot": "field-error",
 		id: id ?? field?.errorId,
-		className: (0, cn.cn)("mt-0.5 text-sm font-normal text-error", className),
+		className: (0, cn.cn)("text-sm font-normal text-error", className),
 		...props,
 		children: content
 	});
@@ -321,5 +415,6 @@ exports.FieldTitle = FieldTitle;
 exports.FieldValue = FieldValue;
 exports.useFieldContext = useFieldContext;
 exports.useFieldControl = useFieldControl;
+exports.useFieldSetInvalid = useFieldSetInvalid;
 
 //# sourceMappingURL=field.cjs.map

package/dist/components/field.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"field.cjs","names":["React","useTheme","Skeleton","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 { Skeleton } from './skeleton'\nimport { useTheme } from './theme'\n\ntype FieldContextValue = {\n  id: string\n  labelId: string\n  descriptionId: string\n  hasDescription: boolean\n  setHasDescription: (has: boolean) => void\n  errorId: string\n  hasError: boolean\n  setHasError: (has: boolean) => void\n  readOnly: boolean\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 errorId = field?.hasError ? field.errorId : undefined\n  const descriptionId = field?.hasDescription ? field.descriptionId : undefined\n  // error before hint: the actionable message should be announced first\n  const ariaDescribedBy =\n    [errorId, descriptionId, options?.ariaDescribedBy]\n      .filter(Boolean)\n      .join(' ') || undefined\n  const inputStyle =\n    options?.variant ?? field?.inputStyle ?? theme.inputStyle ?? 'soft'\n  const inputColor = field?.inputColor ?? theme.inputColor ?? 'brand'\n  const ariaInvalid = field?.hasError || undefined\n  return { field, id, ariaDescribedBy, ariaInvalid, 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 input's box —\n        // rounded-md tracks Input/Select/etc.'s own control radius, not the container one.\n        // focus inside inset is the classic underline cue, not a shell ring\n        inset: 'gap-y-1 rounded-md 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  readOnly?: boolean\n  'data-invalid'?: boolean | 'true' | 'false'\n}\n\nfunction Field({\n  className,\n  children,\n  labelPosition: labelPositionProp,\n  inputStyle: inputStyleProp,\n  inputColor: inputColorProp,\n  readOnly = false,\n  'data-invalid': dataInvalid,\n  ...props\n}: FieldProps) {\n  const id = useId()\n  const [descriptionCount, setDescriptionCount] = React.useState(0)\n  const [errorCount, setErrorCount] = React.useState(0)\n  // counts, not flags: one slot unmounting must not clear what siblings still need\n  const setHasDescription = React.useCallback(\n    (has: boolean) => setDescriptionCount((n) => n + (has ? 1 : -1)),\n    [],\n  )\n  const setHasError = React.useCallback(\n    (has: boolean) => setErrorCount((n) => n + (has ? 1 : -1)),\n    [],\n  )\n  const hasDescription = descriptionCount > 0\n  const hasError = errorCount > 0\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 fieldId = `field-${id}`\n  const labelId = `${fieldId}-label`\n  const value = React.useMemo<FieldContextValue>(\n    () => ({\n      id: fieldId,\n      labelId,\n      descriptionId: `${fieldId}-description`,\n      hasDescription,\n      setHasDescription,\n      errorId: `${fieldId}-error`,\n      hasError,\n      setHasError,\n      readOnly,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    }),\n    [\n      fieldId,\n      labelId,\n      hasDescription,\n      setHasDescription,\n      hasError,\n      setHasError,\n      readOnly,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    ],\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        data-invalid={dataInvalid ?? (hasError || undefined)}\n        aria-labelledby={readOnly ? labelId : undefined}\n        className={cn(\n          fieldVariants({ labelPosition, inputStyle, inputColor }),\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </div>\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\nconst fieldLabelClassName =\n  'text-sm leading-5 font-normal text-gray transition-all group-data-[invalid=true]/field:text-error-active! motion-reduce:transition-none'\n\nfunction FieldLabel({\n  className,\n  htmlFor,\n  srOnly,\n  children,\n  ...props\n}: React.ComponentProps<'label'> & { srOnly?: boolean }) {\n  const field = useFieldContext()\n  const classNames = cn(\n    // labels stay full-contrast even when disabled — the control itself\n    // (dimmed text, gray shell) signals the state\n    fieldLabelClassName,\n    // visually hidden but kept in the a11y tree (still names + focuses the control)\n    srOnly && 'sr-only',\n    className,\n  )\n\n  if (field?.readOnly) {\n    return (\n      <div data-slot=\"field-label\" id={field.labelId} className={classNames}>\n        {children}\n      </div>\n    )\n  }\n\n  return (\n    <label\n      data-slot=\"field-label\"\n      className={classNames}\n      htmlFor={htmlFor ?? field?.id}\n      {...props}\n    >\n      {children}\n    </label>\n  )\n}\n\nfunction FieldValue({\n  className,\n  id,\n  title,\n  truncate,\n  children,\n  ...props\n}: React.ComponentProps<'div'> & { truncate?: boolean }) {\n  return (\n    <div\n      data-slot=\"field-value\"\n      id={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 FieldSkeleton({\n  className,\n  labelClassName,\n  valueClassName,\n  truncate,\n  ...props\n}: React.ComponentProps<'div'> & {\n  truncate?: boolean\n  labelClassName?: string\n  valueClassName?: string\n}) {\n  return (\n    <div\n      data-slot=\"field-skeleton\"\n      aria-hidden=\"true\"\n      className={cn('flex w-full flex-col gap-y-1', className)}\n      {...props}\n    >\n      <Skeleton\n        data-slot=\"field-skeleton-label\"\n        className={cn('h-5 w-24', labelClassName)}\n      />\n      <Skeleton\n        data-slot=\"field-skeleton-value\"\n        className={cn(\n          'h-8 min-h-8 w-full',\n          truncate && 'max-w-full truncate',\n          valueClassName,\n        )}\n      />\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  id,\n  ...props\n}: React.ComponentProps<'div'> & {\n  errors?: Array<{ message?: string } | undefined>\n}) {\n  const field = useFieldContext()\n  const setHasError = field?.setHasError\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) =>\n            error?.message && <li key={error.message}>{error.message}</li>,\n        )}\n      </ul>\n    )\n  }, [children, errors])\n\n  const hasContent = Boolean(content)\n  // a custom id means no element carries field.errorId, so don't advertise it\n  const hasCustomId = id != null\n\n  // must run before the empty-content early return to keep hook order stable\n  React.useEffect(() => {\n    if (!setHasError || !hasContent || hasCustomId) return\n    setHasError(true)\n    return () => setHasError(false)\n  }, [setHasError, hasContent, hasCustomId])\n\n  if (!content) return null\n\n  return (\n    <div\n      role=\"alert\"\n      data-slot=\"field-error\"\n      id={id ?? field?.errorId}\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  FieldSkeleton,\n  FieldTitle,\n  FieldValue,\n}\nexport type { FieldProps }\n"],"mappings":"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"}
+{"version":3,"file":"field.cjs","names":["React","useTheme","Skeleton","Separator","Callout"],"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 { Callout } from './callout'\nimport { Separator } from './separator'\nimport { Skeleton } from './skeleton'\nimport { useTheme } from './theme'\n\ntype FieldContextValue = {\n  id: string\n  labelId: string\n  descriptionId: string\n  hasDescription: boolean\n  setHasDescription: (has: boolean) => void\n  errorId: string\n  hasError: boolean\n  setHasError: (has: boolean) => void\n  readOnly: boolean\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 errorId = field?.hasError ? field.errorId : undefined\n  const descriptionId = field?.hasDescription ? field.descriptionId : undefined\n  // error before hint: the actionable message should be announced first\n  const ariaDescribedBy =\n    [errorId, descriptionId, options?.ariaDescribedBy]\n      .filter(Boolean)\n      .join(' ') || undefined\n  const inputStyle =\n    options?.variant ?? field?.inputStyle ?? theme.inputStyle ?? 'soft'\n  const inputColor = field?.inputColor ?? theme.inputColor ?? 'brand'\n  const ariaInvalid = field?.hasError || undefined\n  return { field, id, ariaDescribedBy, ariaInvalid, inputStyle, inputColor }\n}\n\ntype FieldSetIndicator = 'required' | 'optional'\n\ntype FieldSetContextValue = {\n  descriptionId: string\n  hasDescription: boolean\n  setHasDescription: (has: boolean) => void\n  errorId: string\n  hasError: boolean\n  setHasError: (has: boolean) => void\n  /** Marks the set invalid without linking `errorId` (error has a custom id). */\n  setHasUnlinkedError: (has: boolean) => void\n  invalid: boolean\n  indicator?: FieldSetIndicator\n  indicatorLabel?: string\n}\n\nconst FieldSetContext = React.createContext<FieldSetContextValue | null>(null)\n\n/** True when the nearest enclosing FieldSet has an error; ignores outer sets. */\nfunction useFieldSetInvalid() {\n  return React.useContext(FieldSetContext)?.invalid || undefined\n}\n\nfunction useSlotCount() {\n  const [count, setCount] = React.useState(0)\n  const setHas = React.useCallback(\n    (has: boolean) => setCount((n) => n + (has ? 1 : -1)),\n    [],\n  )\n  return [count > 0, setHas] as const\n}\n\ninterface FieldSetProps extends React.ComponentProps<'fieldset'> {\n  /** Marks the legend: `*` plus hidden text, or a visible \"(optional)\". */\n  indicator?: FieldSetIndicator\n  /** Text for the mark; defaults to `'required'` or `'optional'`. */\n  indicatorLabel?: string\n}\n\nfunction FieldSet({\n  className,\n  indicator,\n  indicatorLabel,\n  'aria-describedby': ariaDescribedByProp,\n  ...props\n}: FieldSetProps) {\n  const id = useId()\n  const [hasDescription, setHasDescription] = useSlotCount()\n  const [hasError, setHasError] = useSlotCount()\n  const [hasUnlinkedError, setHasUnlinkedError] = useSlotCount()\n  const invalid = hasError || hasUnlinkedError\n  const fieldSetId = `field-set-${id}`\n  const descriptionId = `${fieldSetId}-description`\n  const errorId = `${fieldSetId}-error`\n  const value = React.useMemo<FieldSetContextValue>(\n    () => ({\n      descriptionId,\n      hasDescription,\n      setHasDescription,\n      errorId,\n      hasError,\n      setHasError,\n      setHasUnlinkedError,\n      invalid,\n      indicator,\n      indicatorLabel,\n    }),\n    [\n      descriptionId,\n      hasDescription,\n      setHasDescription,\n      errorId,\n      hasError,\n      setHasError,\n      setHasUnlinkedError,\n      invalid,\n      indicator,\n      indicatorLabel,\n    ],\n  )\n  const ariaDescribedBy =\n    [hasError && errorId, hasDescription && descriptionId, ariaDescribedByProp]\n      .filter(Boolean)\n      .join(' ') || undefined\n\n  return (\n    <FieldSetContext.Provider value={value}>\n      <fieldset\n        data-slot=\"field-set\"\n        data-invalid={invalid || undefined}\n        aria-describedby={ariaDescribedBy}\n        className={cn(\n          'group/field-set flex flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n          className,\n        )}\n        {...props}\n      />\n    </FieldSetContext.Provider>\n  )\n}\n\nfunction FieldLegend({\n  className,\n  variant = 'legend',\n  children,\n  ...props\n}: React.ComponentProps<'legend'> & { variant?: 'legend' | 'label' }) {\n  const fieldSet = React.useContext(FieldSetContext)\n  const indicator = fieldSet?.indicator\n  const indicatorLabel = fieldSet?.indicatorLabel ?? indicator\n  return (\n    <legend\n      data-invalid={fieldSet?.invalid || undefined}\n      data-slot=\"field-legend\"\n      data-variant={variant}\n      className={cn(\n        'mb-1.5 font-medium text-gray data-[invalid=true]:text-error-active! data-[variant=label]:text-sm data-[variant=legend]:text-base',\n        className,\n      )}\n      {...props}\n    >\n      {children}\n      {indicator === 'required' && (\n        <>\n          {' '}\n          <span aria-hidden=\"true\">*</span>\n          <span className=\"sr-only\">{indicatorLabel}</span>\n        </>\n      )}\n      {indicator === 'optional' && (\n        <>\n          {' '}\n          <span className=\"font-normal text-gray-light\">\n            ({indicatorLabel})\n          </span>\n        </>\n      )}\n    </legend>\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 input's box —\n        // rounded-md tracks Input/Select/etc.'s own control radius, not the container one.\n        // focus inside inset is the classic underline cue, not a shell ring\n        inset: 'gap-y-1 rounded-md 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  readOnly?: boolean\n  'data-invalid'?: boolean | 'true' | 'false'\n}\n\nfunction Field({\n  className,\n  children,\n  labelPosition: labelPositionProp,\n  inputStyle: inputStyleProp,\n  inputColor: inputColorProp,\n  readOnly = false,\n  'data-invalid': dataInvalid,\n  ...props\n}: FieldProps) {\n  const id = useId()\n  const [descriptionCount, setDescriptionCount] = React.useState(0)\n  const [errorCount, setErrorCount] = React.useState(0)\n  // counts, not flags: one slot unmounting must not clear what siblings still need\n  const setHasDescription = React.useCallback(\n    (has: boolean) => setDescriptionCount((n) => n + (has ? 1 : -1)),\n    [],\n  )\n  const setHasError = React.useCallback(\n    (has: boolean) => setErrorCount((n) => n + (has ? 1 : -1)),\n    [],\n  )\n  const hasDescription = descriptionCount > 0\n  const hasError = errorCount > 0\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 fieldId = `field-${id}`\n  const labelId = `${fieldId}-label`\n  const value = React.useMemo<FieldContextValue>(\n    () => ({\n      id: fieldId,\n      labelId,\n      descriptionId: `${fieldId}-description`,\n      hasDescription,\n      setHasDescription,\n      errorId: `${fieldId}-error`,\n      hasError,\n      setHasError,\n      readOnly,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    }),\n    [\n      fieldId,\n      labelId,\n      hasDescription,\n      setHasDescription,\n      hasError,\n      setHasError,\n      readOnly,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    ],\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        data-invalid={dataInvalid ?? (hasError || undefined)}\n        aria-labelledby={readOnly ? labelId : undefined}\n        className={cn(\n          fieldVariants({ labelPosition, inputStyle, inputColor }),\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </div>\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-1 leading-snug',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nconst fieldLabelClassName =\n  'text-sm leading-5 font-normal text-gray transition-all group-data-[invalid=true]/field:text-error-active! motion-reduce:transition-none'\n\nfunction FieldLabel({\n  className,\n  htmlFor,\n  srOnly,\n  children,\n  ...props\n}: React.ComponentProps<'label'> & { srOnly?: boolean }) {\n  const field = useFieldContext()\n  const classNames = cn(\n    // labels stay full-contrast even when disabled — the control itself\n    // (dimmed text, gray shell) signals the state\n    fieldLabelClassName,\n    // visually hidden but kept in the a11y tree (still names + focuses the control)\n    srOnly && 'sr-only',\n    className,\n  )\n\n  if (field?.readOnly) {\n    return (\n      <div data-slot=\"field-label\" id={field.labelId} className={classNames}>\n        {children}\n      </div>\n    )\n  }\n\n  return (\n    <label\n      data-slot=\"field-label\"\n      className={classNames}\n      htmlFor={htmlFor ?? field?.id}\n      {...props}\n    >\n      {children}\n    </label>\n  )\n}\n\nfunction FieldValue({\n  className,\n  id,\n  title,\n  truncate,\n  children,\n  ...props\n}: React.ComponentProps<'div'> & { truncate?: boolean }) {\n  return (\n    <div\n      data-slot=\"field-value\"\n      id={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 FieldSkeleton({\n  className,\n  labelClassName,\n  valueClassName,\n  truncate,\n  ...props\n}: React.ComponentProps<'div'> & {\n  truncate?: boolean\n  labelClassName?: string\n  valueClassName?: string\n}) {\n  return (\n    <div\n      data-slot=\"field-skeleton\"\n      aria-hidden=\"true\"\n      className={cn('flex w-full flex-col gap-y-1', className)}\n      {...props}\n    >\n      <Skeleton\n        data-slot=\"field-skeleton-label\"\n        className={cn('h-5 w-24', labelClassName)}\n      />\n      <Skeleton\n        data-slot=\"field-skeleton-value\"\n        className={cn(\n          'h-8 min-h-8 w-full',\n          truncate && 'max-w-full truncate',\n          valueClassName,\n        )}\n      />\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 fieldSet = React.useContext(FieldSetContext)\n  const owner = field ?? fieldSet\n  const setHasDescription = owner?.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 ?? owner?.descriptionId}\n      className={cn('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  id,\n  ...props\n}: React.ComponentProps<'div'> & {\n  errors?: Array<{ message?: string } | undefined>\n}) {\n  const field = useFieldContext()\n  const fieldSet = React.useContext(FieldSetContext)\n  const owner = field ?? fieldSet\n  const setHasError = owner?.setHasError\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) =>\n            error?.message && <li key={error.message}>{error.message}</li>,\n        )}\n      </ul>\n    )\n  }, [children, errors])\n\n  const hasContent = Boolean(content)\n  // a custom id means no element carries owner.errorId, so don't advertise it\n  const hasCustomId = id != null\n  const setSetUnlinked = !field ? fieldSet?.setHasUnlinkedError : undefined\n\n  // must run before the empty-content early return to keep hook order stable\n  React.useEffect(() => {\n    if (!hasContent) return\n    const set = hasCustomId ? setSetUnlinked : setHasError\n    if (!set) return\n    set(true)\n    return () => set(false)\n  }, [setHasError, setSetUnlinked, hasContent, hasCustomId])\n\n  if (!content) return null\n\n  if (!field && fieldSet) {\n    // straight into Callout: CalloutDescription's <p> cannot hold the <ul> above\n    return (\n      <Callout\n        variant=\"error\"\n        role=\"alert\"\n        data-slot=\"field-error\"\n        id={id ?? fieldSet.errorId}\n        className={className}\n        {...props}\n      >\n        {content}\n      </Callout>\n    )\n  }\n\n  return (\n    <div\n      role=\"alert\"\n      data-slot=\"field-error\"\n      id={id ?? field?.errorId}\n      className={cn('text-sm font-normal text-error', className)}\n      {...props}\n    >\n      {content}\n    </div>\n  )\n}\n\nexport {\n  useFieldSetInvalid,\n  Field,\n  FieldContent,\n  FieldDescription,\n  FieldError,\n  FieldGroup,\n  FieldLabel,\n  FieldLegend,\n  FieldSeparator,\n  FieldSet,\n  FieldSkeleton,\n  FieldTitle,\n  FieldValue,\n}\nexport type { FieldProps, FieldSetProps }\n"],"mappings":"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"}

package/dist/components/field.d.cts

@@ -1,6 +1,6 @@
 "use client";
 
-import { a as SparkInputStyle, i as SparkInputColor, o as SparkLabelPosition } from "../theme-types-Bn5E15-P.cjs";
+import { c as SparkInputColor, l as SparkInputStyle, u as SparkLabelPosition } from "../theme-types-CKZzOmSa.cjs";
 import * as React$1 from "react";
 
 //#region src/components/field.d.ts
@@ -31,13 +31,26 @@ declare function useFieldControl(options?: {
   inputStyle: SparkInputStyle;
   inputColor: SparkInputColor;
 };
+type FieldSetIndicator = 'required' | 'optional';
+/** True when the nearest enclosing FieldSet has an error; ignores outer sets. */
+declare function useFieldSetInvalid(): true | undefined;
+interface FieldSetProps extends React$1.ComponentProps<'fieldset'> {
+  /** Marks the legend: `*` plus hidden text, or a visible "(optional)". */
+  indicator?: FieldSetIndicator;
+  /** Text for the mark; defaults to `'required'` or `'optional'`. */
+  indicatorLabel?: string;
+}
 declare function FieldSet({
   className,
+  indicator,
+  indicatorLabel,
+  'aria-describedby': ariaDescribedByProp,
   ...props
-}: React$1.ComponentProps<'fieldset'>): import("react/jsx-runtime").JSX.Element;
+}: FieldSetProps): import("react/jsx-runtime").JSX.Element;
 declare function FieldLegend({
   className,
   variant,
+  children,
   ...props
 }: React$1.ComponentProps<'legend'> & {
   variant?: 'legend' | 'label';
@@ -123,5 +136,5 @@ declare function FieldError({
   } | undefined>;
 }): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
-export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldSkeleton, FieldTitle, FieldValue, useFieldContext, useFieldControl };
+export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, type FieldSetProps, FieldSkeleton, FieldTitle, FieldValue, useFieldContext, useFieldControl, useFieldSetInvalid };
 //# sourceMappingURL=field.d.cts.map

package/dist/components/field.d.ts

@@ -1,6 +1,6 @@
 "use client";
 
-import { a as SparkInputStyle, i as SparkInputColor, o as SparkLabelPosition } from "../theme-types-Bn5E15-P.js";
+import { c as SparkInputColor, l as SparkInputStyle, u as SparkLabelPosition } from "../theme-types-CKZzOmSa.js";
 import * as React$1 from "react";
 
 //#region src/components/field.d.ts
@@ -31,13 +31,26 @@ declare function useFieldControl(options?: {
   inputStyle: SparkInputStyle;
   inputColor: SparkInputColor;
 };
+type FieldSetIndicator = 'required' | 'optional';
+/** True when the nearest enclosing FieldSet has an error; ignores outer sets. */
+declare function useFieldSetInvalid(): true | undefined;
+interface FieldSetProps extends React$1.ComponentProps<'fieldset'> {
+  /** Marks the legend: `*` plus hidden text, or a visible "(optional)". */
+  indicator?: FieldSetIndicator;
+  /** Text for the mark; defaults to `'required'` or `'optional'`. */
+  indicatorLabel?: string;
+}
 declare function FieldSet({
   className,
+  indicator,
+  indicatorLabel,
+  'aria-describedby': ariaDescribedByProp,
   ...props
-}: React$1.ComponentProps<'fieldset'>): import("react/jsx-runtime").JSX.Element;
+}: FieldSetProps): import("react/jsx-runtime").JSX.Element;
 declare function FieldLegend({
   className,
   variant,
+  children,
   ...props
 }: React$1.ComponentProps<'legend'> & {
   variant?: 'legend' | 'label';
@@ -123,5 +136,5 @@ declare function FieldError({
   } | undefined>;
 }): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
-export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldSkeleton, FieldTitle, FieldValue, useFieldContext, useFieldControl };
+export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, type FieldSetProps, FieldSkeleton, FieldTitle, FieldValue, useFieldContext, useFieldControl, useFieldSetInvalid };
 //# sourceMappingURL=field.d.ts.map