@dowel-ui/react 0.3.0 → 0.5.0

package/dist/components/ai-extraction-review/ai-extraction-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-extraction-review.js","names":[],"sources":["../../../src/components/ai-extraction-review/ai-extraction-review.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n  type ComponentPropsWithRef,\n  type KeyboardEvent,\n  type ReactNode,\n} from \"react\";\n\nimport { disabledStyles, focusRing } from \"@/lib/styles\";\nimport { cn } from \"@/lib/utils\";\n\nimport {\n  evidenceOf,\n  isSourced,\n  segmentSource,\n  summarizeReview,\n  type ExtractionField,\n  type FieldDecision,\n  type SourceRun,\n} from \"./extraction-model\";\n\n/**\n * The check after extraction: the document on one side, what the model read\n * out of it on the other, and a decision about every field.\n *\n * Every extraction demo shows the filled object and stops. The products that\n * run extraction for a living — invoice capture, KYC onboarding, claims intake —\n * all have this screen, each built from scratch, because a value that cannot\n * be checked can only be trusted, and nobody who is paying an invoice trusts a\n * model that far. No component library ships it.\n *\n * The link is the component. Each field carries where in the source it was\n * read from, quoted in text under the value as well as highlighted in the\n * document, so a reviewer who cannot see the highlight still has the evidence.\n * And a value with no evidence is said outright — \"the model supplied this\n * without evidence\" — because that is the case a review exists to catch, and\n * the one every filled-object view renders identically to a good value.\n *\n * Evidence is a text offset, not a bounding box. A language model reads text,\n * and a text layer with offsets is what every OCR pipeline already yields.\n * Boxes over a rendered page need page rendering, zoom and geometry, and are a\n * different component; this one does not pretend at them.\n *\n * Decisions are controlled and the component writes nothing. It reports that\n * a field was accepted as proposed, corrected from what was proposed, or\n * rejected — a richer record than a form's submitted values, and the one an\n * audit later needs — and leaves what to do with it to the application.\n */\n\nexport interface ExtractionReviewProps extends Omit<\n  ComponentPropsWithRef<\"section\">,\n  \"children\"\n> {\n  /** What the model read. Every span indexes into it. */\n  source: string;\n  /** Names the source — \"Invoice 4471.pdf, page 1\". */\n  sourceLabel?: string;\n  /** What is being reviewed, as the heading. */\n  heading: string;\n  fields: ExtractionField[];\n  /** Per-field decisions, keyed by field name. Controlled. */\n  decisions?: Record<string, FieldDecision>;\n  /** Omit to render the review as a record rather than something to operate. */\n  onDecision?: (name: string, decision: FieldDecision) => void;\n  /** True while fields are still arriving. Missing values wait instead of reading as not found. */\n  streaming?: boolean;\n  /** Confidence below this is called low, in words. */\n  lowConfidenceBelow?: number;\n  children?: ReactNode;\n}\n\nexport function ExtractionReview({\n  className,\n  source,\n  sourceLabel = \"Source\",\n  heading,\n  fields,\n  decisions = {},\n  onDecision,\n  streaming = false,\n  lowConfidenceBelow = 0.7,\n  children,\n  ...props\n}: ExtractionReviewProps) {\n  const headingId = useId();\n  const [activeField, setActiveField] = useState<string | null>(null);\n\n  const runs = useMemo(() => segmentSource(source, fields), [source, fields]);\n  const summary = useMemo(\n    () => summarizeReview(source, fields, decisions),\n    [source, fields, decisions],\n  );\n\n  return (\n    <section\n      data-slot=\"extraction-review\"\n      data-complete={summary.complete || undefined}\n      aria-labelledby={headingId}\n      aria-busy={streaming || undefined}\n      className={cn(\"flex flex-col gap-3\", className)}\n      {...props}\n    >\n      <div className=\"flex flex-wrap items-baseline justify-between gap-2\">\n        <h3 id={headingId} className=\"text-sm font-medium\">\n          {heading}\n        </h3>\n        {/* Live from the start and short, so each decision is followed by\n            where the review stands rather than by silence. Evidence gaps are\n            counted here too: they are the reason to read carefully, and worth\n            knowing before starting rather than discovering on field six. */}\n        <p\n          data-slot=\"extraction-review-summary\"\n          aria-live=\"polite\"\n          className=\"text-xs text-muted-foreground\"\n        >\n          {streaming\n            ? \"Fields are still arriving\"\n            : `${String(summary.reviewed)} of ${String(summary.total)} reviewed`}\n          {summary.unsourced.length > 0\n            ? ` · ${String(summary.unsourced.length)} without evidence`\n            : null}\n        </p>\n      </div>\n\n      {children}\n\n      <div className=\"grid gap-4 md:grid-cols-2\">\n        <SourcePanel\n          label={sourceLabel}\n          runs={runs}\n          active={activeField}\n          decisions={decisions}\n        />\n\n        <ol data-slot=\"extraction-fields\" className=\"m-0 flex list-none flex-col gap-3 p-0\">\n          {fields.map((field) => (\n            <ReviewField\n              key={field.name}\n              field={field}\n              source={source}\n              decision={decisions[field.name]}\n              streaming={streaming}\n              lowConfidenceBelow={lowConfidenceBelow}\n              active={activeField === field.name}\n              onActivate={() => {\n                setActiveField(field.name);\n              }}\n              onDecision={onDecision}\n            />\n          ))}\n        </ol>\n      </div>\n    </section>\n  );\n}\n\nfunction SourcePanel({\n  label,\n  runs,\n  active,\n  decisions,\n}: {\n  label: string;\n  runs: SourceRun[];\n  active: string | null;\n  decisions: Record<string, FieldDecision>;\n}) {\n  const ref = useRef<HTMLDivElement>(null);\n\n  // Bring the active field's evidence into view. Focus stays where it is —\n  // in the field — so a keyboard user is shown the source without being\n  // moved into it.\n  useEffect(() => {\n    if (!active || !ref.current) return;\n    const mark = ref.current.querySelector(`mark[data-active]`);\n    mark?.scrollIntoView({ block: \"nearest\" });\n  }, [active]);\n\n  return (\n    <div\n      ref={ref}\n      data-slot=\"extraction-source\"\n      // A scrolling box has to be focusable to be scrolled by keyboard, and a\n      // focusable box needs a name.\n      role=\"region\"\n      aria-label={label}\n      tabIndex={0}\n      // Sticks beside the fields on a wide screen, so the evidence for field\n      // nine is still in view when the reviewer reaches it.\n      className={cn(\n        \"max-h-96 overflow-auto rounded-lg border border-border bg-muted/30 p-3 md:sticky md:top-0 md:self-start\",\n        focusRing,\n      )}\n    >\n      {runs.length === 0 ? (\n        <p className=\"text-xs text-muted-foreground\">No source text.</p>\n      ) : (\n        <pre className=\"m-0 font-sans text-sm leading-relaxed break-words whitespace-pre-wrap\">\n          {runs.map((run, index) =>\n            run.fields.length === 0 ? (\n              <span key={index}>{run.text}</span>\n            ) : (\n              // A mark element, so the evidence survives as structure rather\n              // than only as a tint. No label is inserted into the text: a\n              // document read aloud with field names spliced into it is not\n              // the document, and the field already quotes its evidence.\n              <mark\n                key={index}\n                data-fields={run.fields.join(\" \")}\n                data-active={active !== null && run.fields.includes(active) ? \"\" : undefined}\n                className={cn(\n                  \"rounded-[2px] text-inherit\",\n                  run.fields.every((name) => decisions[name]?.kind === \"rejected\")\n                    ? \"bg-muted line-through decoration-muted-foreground\"\n                    : \"bg-primary/15\",\n                  active !== null &&\n                    run.fields.includes(active) &&\n                    \"bg-primary/30 ring-1 ring-primary ring-inset\",\n                )}\n              >\n                {run.text}\n              </mark>\n            ),\n          )}\n        </pre>\n      )}\n    </div>\n  );\n}\n\n/** Whitespace collapsed and cut short, for quoting evidence under a field. */\nfunction quote(text: string, limit = 80): string {\n  const collapsed = text.replace(/\\s+/g, \" \").trim();\n  return collapsed.length > limit ? `${collapsed.slice(0, limit - 1)}…` : collapsed;\n}\n\nfunction ReviewField({\n  field,\n  source,\n  decision,\n  streaming,\n  lowConfidenceBelow,\n  active,\n  onActivate,\n  onDecision,\n}: {\n  field: ExtractionField;\n  source: string;\n  decision?: FieldDecision;\n  streaming: boolean;\n  lowConfidenceBelow: number;\n  active: boolean;\n  onActivate: () => void;\n  onDecision?: (name: string, decision: FieldDecision) => void;\n}) {\n  const inputId = useId();\n  const evidenceId = useId();\n  const statusId = useId();\n  const confidenceId = useId();\n\n  // The reviewer's typing, kept apart from the model's value so the decision\n  // can say which is which.\n  const [draft, setDraft] = useState<string | null>(null);\n\n  const proposed = field.value ?? \"\";\n  const decided = decision && decision.kind !== \"rejected\" ? decision.value : undefined;\n  const current = draft ?? decided ?? proposed;\n  const edited = current !== proposed;\n  const changedSince = decided !== undefined && current !== decided;\n\n  const arriving = streaming && field.value === undefined;\n  const sourced = isSourced(source, field);\n  const evidence = sourced ? evidenceOf(source, field.span) : \"\";\n  const unsourced = !arriving && field.value !== undefined && !sourced;\n\n  const accept = () => {\n    onDecision?.(\n      field.name,\n      edited\n        ? { kind: \"corrected\", value: current, proposed }\n        : { kind: \"accepted\", value: current },\n    );\n  };\n\n  const onKeyDown = (event: KeyboardEvent<HTMLInputElement | HTMLTextAreaElement>) => {\n    if (event.key !== \"Enter\") return;\n    // Enter confirms an IME candidate before it means anything else. Without\n    // this, a reviewer typing a Japanese correction accepts a fragment of it.\n    if (event.nativeEvent.isComposing) return;\n    if (field.multiline && !(event.ctrlKey || event.metaKey)) return;\n    event.preventDefault();\n    accept();\n  };\n\n  const status = arriving\n    ? \"Arriving\"\n    : !decision\n      ? \"Not reviewed\"\n      : decision.kind === \"rejected\"\n        ? \"Rejected\"\n        : changedSince\n          ? `Changed since it was ${decision.kind}`\n          : decision.kind === \"accepted\"\n            ? \"Accepted\"\n            : decision.proposed\n              ? `Corrected from “${quote(decision.proposed, 40)}”`\n              : \"Supplied by the reviewer\";\n\n  const low = field.confidence !== undefined && field.confidence < lowConfidenceBelow;\n  const percent =\n    field.confidence === undefined\n      ? null\n      : new Intl.NumberFormat(undefined, { style: \"percent\", maximumFractionDigits: 0 }).format(\n          field.confidence,\n        );\n\n  const describedBy = [evidenceId, statusId, percent !== null ? confidenceId : null]\n    .filter(Boolean)\n    .join(\" \");\n\n  const controlClass = cn(\n    \"w-full rounded-md border border-input bg-background px-2 py-1.5 text-sm\",\n    edited && \"border-warning\",\n    focusRing,\n  );\n\n  return (\n    <li\n      data-slot=\"extraction-field\"\n      data-field={field.name}\n      data-state={arriving ? \"arriving\" : (decision?.kind ?? \"undecided\")}\n      data-active={active || undefined}\n      data-unsourced={unsourced || undefined}\n      // Focus anywhere in the field — value, either button — is the reviewer\n      // looking at it, so the source follows without a separate step.\n      onFocus={onActivate}\n      className={cn(\n        \"flex flex-col gap-1 rounded-lg border p-3\",\n        active ? \"border-primary\" : \"border-border\",\n        decision?.kind === \"rejected\" && \"bg-muted/40\",\n      )}\n    >\n      <div className=\"flex flex-wrap items-baseline justify-between gap-2\">\n        {onDecision && !arriving ? (\n          <label htmlFor={inputId} className=\"text-xs font-medium text-muted-foreground\">\n            {field.label}\n          </label>\n        ) : (\n          <span className=\"text-xs font-medium text-muted-foreground\">{field.label}</span>\n        )}\n        {/* Status as a word, outside the label so editing never renames the\n            control under a screen reader user. */}\n        <span\n          id={statusId}\n          data-slot=\"extraction-field-status\"\n          className={cn(\n            \"text-xs\",\n            decision?.kind === \"rejected\" ? \"text-destructive\" : \"text-muted-foreground\",\n            changedSince && \"text-warning\",\n          )}\n        >\n          {status}\n        </span>\n      </div>\n\n      {arriving ? (\n        <span\n          aria-hidden=\"true\"\n          className=\"block h-8 w-full animate-pulse-soft rounded-md bg-muted\"\n        />\n      ) : !onDecision ? (\n        <p className=\"rounded-md bg-muted px-2 py-1.5 text-sm break-words\">\n          {current || <span className=\"text-muted-foreground\">Empty</span>}\n        </p>\n      ) : field.multiline ? (\n        <textarea\n          id={inputId}\n          rows={3}\n          value={current}\n          aria-describedby={describedBy}\n          onChange={(event) => {\n            setDraft(event.target.value);\n          }}\n          onKeyDown={onKeyDown}\n          className={cn(controlClass, \"resize-none\")}\n        />\n      ) : (\n        <input\n          id={inputId}\n          type=\"text\"\n          value={current}\n          aria-describedby={describedBy}\n          onChange={(event) => {\n            setDraft(event.target.value);\n          }}\n          onKeyDown={onKeyDown}\n          className={controlClass}\n        />\n      )}\n\n      {/* The evidence in text. This is the accessible path to the source, and\n          for a sighted reviewer it is the comparison itself — \"1 March 2026\"\n          beside \"2026-03-01\" is a normalisation, not an error, and only reads\n          that way with both in view. */}\n      <p\n        id={evidenceId}\n        data-slot=\"extraction-field-evidence\"\n        className={cn(\"text-xs\", unsourced ? \"text-warning\" : \"text-muted-foreground\")}\n      >\n        {arriving\n          ? \"Waiting for the model\"\n          : sourced\n            ? `In the source: “${quote(evidence)}”`\n            : field.value === undefined\n              ? \"The model found nothing for this field.\"\n              : \"Not in the source — the model supplied this without evidence.\"}\n      </p>\n\n      {percent !== null ? (\n        <p\n          id={confidenceId}\n          data-slot=\"extraction-field-confidence\"\n          data-low={low || undefined}\n          className={cn(\"text-xs\", low ? \"text-warning\" : \"text-muted-foreground\")}\n        >\n          {low ? `Low confidence, ${percent} — worth checking` : `${percent} confidence`}\n        </p>\n      ) : null}\n\n      {onDecision && !arriving ? (\n        <div className=\"mt-1 flex flex-wrap items-center gap-2\">\n          <FieldButton\n            variant=\"primary\"\n            aria-label={`${edited ? \"Accept correction\" : \"Accept\"} — ${field.label}`}\n            aria-pressed={\n              decision !== undefined && decision.kind !== \"rejected\" && !changedSince\n            }\n            onClick={accept}\n          >\n            {edited ? \"Accept correction\" : \"Accept\"}\n          </FieldButton>\n          <FieldButton\n            aria-label={`Reject — ${field.label}`}\n            aria-pressed={decision?.kind === \"rejected\"}\n            onClick={() => {\n              onDecision(field.name, { kind: \"rejected\" });\n            }}\n          >\n            Reject\n          </FieldButton>\n          {sourced ? (\n            <FieldButton\n              aria-label={`Show in source — ${field.label}`}\n              className=\"ml-auto\"\n              onClick={onActivate}\n            >\n              Show in source\n            </FieldButton>\n          ) : null}\n        </div>\n      ) : null}\n    </li>\n  );\n}\n\nfunction FieldButton({\n  className,\n  variant = \"default\",\n  ...props\n}: ComponentPropsWithRef<\"button\"> & { variant?: \"default\" | \"primary\" }) {\n  return (\n    <button\n      type=\"button\"\n      className={cn(\n        \"rounded-md border px-2.5 py-1 text-xs font-medium transition-colors\",\n        variant === \"primary\" &&\n          \"border-primary bg-primary text-primary-foreground hover:bg-primary-hover aria-pressed:bg-primary-active\",\n        variant === \"default\" &&\n          \"border-input bg-background hover:bg-accent hover:text-accent-foreground aria-pressed:bg-secondary aria-pressed:text-secondary-foreground\",\n        focusRing,\n        disabledStyles,\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n"],"mappings":"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"}

package/dist/components/ai-extraction-review/extraction-model.d.ts

@@ -0,0 +1,94 @@
+//#region src/components/ai-extraction-review/extraction-model.d.ts
+/**
+ * The model behind a review of extracted fields: where each value was read
+ * from, what the reviewer decided about it, and how far through the review
+ * they are.
+ *
+ * Pure, so overlap handling and the completion rule are tested without
+ * rendering anything — and so an application can answer "is this review
+ * finished" on the server from the same decisions the component reports,
+ * rather than trusting a flag the client sent.
+ */
+interface SourceSpan {
+  /** Offset into the source text in UTF-16 code units. Inclusive. */
+  start: number;
+  /** Exclusive. */
+  end: number;
+}
+interface ExtractionField {
+  /** Key in the extracted object. */
+  name: string;
+  label: string;
+  /**
+   * What the model extracted. Absent while streaming means it has not arrived;
+   * absent once streaming has ended means the model found nothing.
+   */
+  value?: string;
+  /**
+   * Where in the source the value was read from. Absent means the model
+   * supplied the value without evidence, which the review says outright.
+   */
+  span?: SourceSpan;
+  /** 0 to 1. Shown as a number, never only as a colour. */
+  confidence?: number;
+  /** A textarea instead of a single line. For addresses and descriptions. */
+  multiline?: boolean;
+}
+type FieldDecision =
+/** The model's value, taken as it was. */
+{
+  kind: "accepted";
+  value: string;
+} |
+/** The reviewer's value, with the model's kept so a record can tell them apart. */
+{
+  kind: "corrected";
+  value: string;
+  proposed: string;
+} |
+/** Wrong and not corrected — the field does not apply, or cannot be known. */
+{
+  kind: "rejected";
+};
+/** A run of source text and the fields whose evidence covers it. */
+interface SourceRun {
+  text: string;
+  /** Field names, in declaration order. Empty for text nobody cites. */
+  fields: string[];
+}
+/**
+ * A span brought within the source, or null if nothing of it is.
+ *
+ * Offsets come from a model or an OCR layer and are wrong often enough that
+ * refusing to render on a bad one would leave the whole review blank. A span
+ * past the end is clamped; an inverted or empty one is treated as no evidence,
+ * which is what it is.
+ */
+declare function clampSpan(span: SourceSpan, length: number): SourceSpan | null;
+/** The text a span points at, or an empty string if it points at nothing. */
+declare function evidenceOf(source: string, span: SourceSpan | undefined): string;
+/** Whether a field's value can be checked against the source at all. */
+declare function isSourced(source: string, field: ExtractionField): boolean;
+/**
+ * Cuts the source into runs at every span boundary, so overlapping evidence —
+ * a total that sits inside the line that contains it — renders as nested
+ * coverage rather than as two marks fighting over the same characters.
+ */
+declare function segmentSource(source: string, fields: ExtractionField[]): SourceRun[];
+interface ReviewSummary {
+  total: number;
+  reviewed: number;
+  accepted: number;
+  corrected: number;
+  rejected: number;
+  /** Fields with a value the model could not point to in the source. */
+  unsourced: string[];
+  /** Fields still awaiting a decision. */
+  remaining: string[];
+  /** Every field has a decision. The only completion signal worth trusting. */
+  complete: boolean;
+}
+declare function summarizeReview(source: string, fields: ExtractionField[], decisions?: Record<string, FieldDecision>): ReviewSummary;
+//#endregion
+export { ExtractionField, FieldDecision, ReviewSummary, SourceRun, SourceSpan, clampSpan, evidenceOf, isSourced, segmentSource, summarizeReview };
+//# sourceMappingURL=extraction-model.d.ts.map

package/dist/components/ai-extraction-review/extraction-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-model.d.ts","names":[],"sources":["../../../src/components/ai-extraction-review/extraction-model.ts"],"mappings":";;;;;;;;;;;UAWiB;;EAEf;;EAEA;;UAGe;;EAEf;EACA;;;;;EAKA;;;;;EAKA,OAAO;;EAEP;;EAEA;;KAGU;;;EAEN;EAAkB;;;;EAElB;EAAmB;EAAe;;;;EAElC;;;UAGW;EACf;;EAEA;;;;;;;;;;iBAWc,UAAU,MAAM,YAAY,iBAAiB;;iBAO7C,WAAW,gBAAgB,MAAM;;iBAOjC,UAAU,gBAAgB,OAAO;;;;;;iBASjC,cAAc,gBAAgB,QAAQ,oBAAoB;UA6BzD;EACf;EACA;EACA;EACA;EACA;;EAEA;;EAEA;;EAEA;;iBAGc,gBACd,gBACA,QAAQ,mBACR,YAAW,eAAe,iBACzB"}

package/dist/components/ai-extraction-review/extraction-model.js

@@ -0,0 +1,91 @@
+//#region src/components/ai-extraction-review/extraction-model.ts
+/**
+* A span brought within the source, or null if nothing of it is.
+*
+* Offsets come from a model or an OCR layer and are wrong often enough that
+* refusing to render on a bad one would leave the whole review blank. A span
+* past the end is clamped; an inverted or empty one is treated as no evidence,
+* which is what it is.
+*/
+function clampSpan(span, length) {
+	const start = Math.max(0, Math.min(span.start, length));
+	const end = Math.max(0, Math.min(span.end, length));
+	return end > start ? {
+		start,
+		end
+	} : null;
+}
+/** The text a span points at, or an empty string if it points at nothing. */
+function evidenceOf(source, span) {
+	if (!span) return "";
+	const clamped = clampSpan(span, source.length);
+	return clamped ? source.slice(clamped.start, clamped.end) : "";
+}
+/** Whether a field's value can be checked against the source at all. */
+function isSourced(source, field) {
+	return field.span !== void 0 && clampSpan(field.span, source.length) !== null;
+}
+/**
+* Cuts the source into runs at every span boundary, so overlapping evidence —
+* a total that sits inside the line that contains it — renders as nested
+* coverage rather than as two marks fighting over the same characters.
+*/
+function segmentSource(source, fields) {
+	const spans = fields.flatMap((field) => {
+		const clamped = field.span ? clampSpan(field.span, source.length) : null;
+		return clamped ? [{
+			name: field.name,
+			...clamped
+		}] : [];
+	});
+	if (source.length === 0) return [];
+	if (spans.length === 0) return [{
+		text: source,
+		fields: []
+	}];
+	const cuts = /* @__PURE__ */ new Set([0, source.length]);
+	for (const span of spans) {
+		cuts.add(span.start);
+		cuts.add(span.end);
+	}
+	const points = [...cuts].sort((a, b) => a - b);
+	const runs = [];
+	for (let index = 0; index < points.length - 1; index += 1) {
+		const start = points[index] ?? 0;
+		const end = points[index + 1] ?? start;
+		if (end <= start) continue;
+		runs.push({
+			text: source.slice(start, end),
+			fields: spans.filter((span) => span.start <= start && span.end >= end).map((s) => s.name)
+		});
+	}
+	return runs;
+}
+function summarizeReview(source, fields, decisions = {}) {
+	const summary = {
+		total: fields.length,
+		reviewed: 0,
+		accepted: 0,
+		corrected: 0,
+		rejected: 0,
+		unsourced: [],
+		remaining: [],
+		complete: false
+	};
+	for (const field of fields) {
+		if (field.value !== void 0 && !isSourced(source, field)) summary.unsourced.push(field.name);
+		const decision = decisions[field.name];
+		if (!decision) {
+			summary.remaining.push(field.name);
+			continue;
+		}
+		summary.reviewed += 1;
+		summary[decision.kind] += 1;
+	}
+	summary.complete = fields.length > 0 && summary.remaining.length === 0;
+	return summary;
+}
+//#endregion
+export { clampSpan, evidenceOf, isSourced, segmentSource, summarizeReview };
+
+//# sourceMappingURL=extraction-model.js.map

package/dist/components/ai-extraction-review/extraction-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-model.js","names":[],"sources":["../../../src/components/ai-extraction-review/extraction-model.ts"],"sourcesContent":["/**\n * The model behind a review of extracted fields: where each value was read\n * from, what the reviewer decided about it, and how far through the review\n * they are.\n *\n * Pure, so overlap handling and the completion rule are tested without\n * rendering anything — and so an application can answer \"is this review\n * finished\" on the server from the same decisions the component reports,\n * rather than trusting a flag the client sent.\n */\n\nexport interface SourceSpan {\n  /** Offset into the source text in UTF-16 code units. Inclusive. */\n  start: number;\n  /** Exclusive. */\n  end: number;\n}\n\nexport interface ExtractionField {\n  /** Key in the extracted object. */\n  name: string;\n  label: string;\n  /**\n   * What the model extracted. Absent while streaming means it has not arrived;\n   * absent once streaming has ended means the model found nothing.\n   */\n  value?: string;\n  /**\n   * Where in the source the value was read from. Absent means the model\n   * supplied the value without evidence, which the review says outright.\n   */\n  span?: SourceSpan;\n  /** 0 to 1. Shown as a number, never only as a colour. */\n  confidence?: number;\n  /** A textarea instead of a single line. For addresses and descriptions. */\n  multiline?: boolean;\n}\n\nexport type FieldDecision =\n  /** The model's value, taken as it was. */\n  | { kind: \"accepted\"; value: string }\n  /** The reviewer's value, with the model's kept so a record can tell them apart. */\n  | { kind: \"corrected\"; value: string; proposed: string }\n  /** Wrong and not corrected — the field does not apply, or cannot be known. */\n  | { kind: \"rejected\" };\n\n/** A run of source text and the fields whose evidence covers it. */\nexport interface SourceRun {\n  text: string;\n  /** Field names, in declaration order. Empty for text nobody cites. */\n  fields: string[];\n}\n\n/**\n * A span brought within the source, or null if nothing of it is.\n *\n * Offsets come from a model or an OCR layer and are wrong often enough that\n * refusing to render on a bad one would leave the whole review blank. A span\n * past the end is clamped; an inverted or empty one is treated as no evidence,\n * which is what it is.\n */\nexport function clampSpan(span: SourceSpan, length: number): SourceSpan | null {\n  const start = Math.max(0, Math.min(span.start, length));\n  const end = Math.max(0, Math.min(span.end, length));\n  return end > start ? { start, end } : null;\n}\n\n/** The text a span points at, or an empty string if it points at nothing. */\nexport function evidenceOf(source: string, span: SourceSpan | undefined): string {\n  if (!span) return \"\";\n  const clamped = clampSpan(span, source.length);\n  return clamped ? source.slice(clamped.start, clamped.end) : \"\";\n}\n\n/** Whether a field's value can be checked against the source at all. */\nexport function isSourced(source: string, field: ExtractionField): boolean {\n  return field.span !== undefined && clampSpan(field.span, source.length) !== null;\n}\n\n/**\n * Cuts the source into runs at every span boundary, so overlapping evidence —\n * a total that sits inside the line that contains it — renders as nested\n * coverage rather than as two marks fighting over the same characters.\n */\nexport function segmentSource(source: string, fields: ExtractionField[]): SourceRun[] {\n  const spans = fields.flatMap((field) => {\n    const clamped = field.span ? clampSpan(field.span, source.length) : null;\n    return clamped ? [{ name: field.name, ...clamped }] : [];\n  });\n\n  if (source.length === 0) return [];\n  if (spans.length === 0) return [{ text: source, fields: [] }];\n\n  const cuts = new Set<number>([0, source.length]);\n  for (const span of spans) {\n    cuts.add(span.start);\n    cuts.add(span.end);\n  }\n  const points = [...cuts].sort((a, b) => a - b);\n\n  const runs: SourceRun[] = [];\n  for (let index = 0; index < points.length - 1; index += 1) {\n    const start = points[index] ?? 0;\n    const end = points[index + 1] ?? start;\n    if (end <= start) continue;\n    runs.push({\n      text: source.slice(start, end),\n      fields: spans.filter((span) => span.start <= start && span.end >= end).map((s) => s.name),\n    });\n  }\n  return runs;\n}\n\nexport interface ReviewSummary {\n  total: number;\n  reviewed: number;\n  accepted: number;\n  corrected: number;\n  rejected: number;\n  /** Fields with a value the model could not point to in the source. */\n  unsourced: string[];\n  /** Fields still awaiting a decision. */\n  remaining: string[];\n  /** Every field has a decision. The only completion signal worth trusting. */\n  complete: boolean;\n}\n\nexport function summarizeReview(\n  source: string,\n  fields: ExtractionField[],\n  decisions: Record<string, FieldDecision> = {},\n): ReviewSummary {\n  const summary: ReviewSummary = {\n    total: fields.length,\n    reviewed: 0,\n    accepted: 0,\n    corrected: 0,\n    rejected: 0,\n    unsourced: [],\n    remaining: [],\n    complete: false,\n  };\n\n  for (const field of fields) {\n    if (field.value !== undefined && !isSourced(source, field)) {\n      summary.unsourced.push(field.name);\n    }\n    const decision = decisions[field.name];\n    if (!decision) {\n      summary.remaining.push(field.name);\n      continue;\n    }\n    summary.reviewed += 1;\n    summary[decision.kind] += 1;\n  }\n\n  summary.complete = fields.length > 0 && summary.remaining.length === 0;\n  return summary;\n}\n"],"mappings":";;;;;;;;;AA6DA,SAAgB,UAAU,MAAkB,QAAmC;CAC7E,MAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,OAAO,MAAM,CAAC;CACtD,MAAM,MAAM,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC;CAClD,OAAO,MAAM,QAAQ;EAAE;EAAO;CAAI,IAAI;AACxC;;AAGA,SAAgB,WAAW,QAAgB,MAAsC;CAC/E,IAAI,CAAC,MAAM,OAAO;CAClB,MAAM,UAAU,UAAU,MAAM,OAAO,MAAM;CAC7C,OAAO,UAAU,OAAO,MAAM,QAAQ,OAAO,QAAQ,GAAG,IAAI;AAC9D;;AAGA,SAAgB,UAAU,QAAgB,OAAiC;CACzE,OAAO,MAAM,SAAS,KAAA,KAAa,UAAU,MAAM,MAAM,OAAO,MAAM,MAAM;AAC9E;;;;;;AAOA,SAAgB,cAAc,QAAgB,QAAwC;CACpF,MAAM,QAAQ,OAAO,SAAS,UAAU;EACtC,MAAM,UAAU,MAAM,OAAO,UAAU,MAAM,MAAM,OAAO,MAAM,IAAI;EACpE,OAAO,UAAU,CAAC;GAAE,MAAM,MAAM;GAAM,GAAG;EAAQ,CAAC,IAAI,CAAC;CACzD,CAAC;CAED,IAAI,OAAO,WAAW,GAAG,OAAO,CAAC;CACjC,IAAI,MAAM,WAAW,GAAG,OAAO,CAAC;EAAE,MAAM;EAAQ,QAAQ,CAAC;CAAE,CAAC;CAE5D,MAAM,uBAAO,IAAI,IAAY,CAAC,GAAG,OAAO,MAAM,CAAC;CAC/C,KAAK,MAAM,QAAQ,OAAO;EACxB,KAAK,IAAI,KAAK,KAAK;EACnB,KAAK,IAAI,KAAK,GAAG;CACnB;CACA,MAAM,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC;CAE7C,MAAM,OAAoB,CAAC;CAC3B,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,SAAS,GAAG,SAAS,GAAG;EACzD,MAAM,QAAQ,OAAO,UAAU;EAC/B,MAAM,MAAM,OAAO,QAAQ,MAAM;EACjC,IAAI,OAAO,OAAO;EAClB,KAAK,KAAK;GACR,MAAM,OAAO,MAAM,OAAO,GAAG;GAC7B,QAAQ,MAAM,QAAQ,SAAS,KAAK,SAAS,SAAS,KAAK,OAAO,GAAG,CAAC,CAAC,KAAK,MAAM,EAAE,IAAI;EAC1F,CAAC;CACH;CACA,OAAO;AACT;AAgBA,SAAgB,gBACd,QACA,QACA,YAA2C,CAAC,GAC7B;CACf,MAAM,UAAyB;EAC7B,OAAO,OAAO;EACd,UAAU;EACV,UAAU;EACV,WAAW;EACX,UAAU;EACV,WAAW,CAAC;EACZ,WAAW,CAAC;EACZ,UAAU;CACZ;CAEA,KAAK,MAAM,SAAS,QAAQ;EAC1B,IAAI,MAAM,UAAU,KAAA,KAAa,CAAC,UAAU,QAAQ,KAAK,GACvD,QAAQ,UAAU,KAAK,MAAM,IAAI;EAEnC,MAAM,WAAW,UAAU,MAAM;EACjC,IAAI,CAAC,UAAU;GACb,QAAQ,UAAU,KAAK,MAAM,IAAI;GACjC;EACF;EACA,QAAQ,YAAY;EACpB,QAAQ,SAAS,SAAS;CAC5B;CAEA,QAAQ,WAAW,OAAO,SAAS,KAAK,QAAQ,UAAU,WAAW;CACrE,OAAO;AACT"}

package/dist/components/ai-extraction-review/index.d.ts

@@ -0,0 +1,3 @@
+import { ExtractionField, FieldDecision, ReviewSummary, SourceRun, SourceSpan, clampSpan, evidenceOf, isSourced, segmentSource, summarizeReview } from "./extraction-model.js";
+import { ExtractionReview, ExtractionReviewProps } from "./ai-extraction-review.js";
+export { type ExtractionField, ExtractionReview, type ExtractionReviewProps, type FieldDecision, type ReviewSummary, type SourceRun, type SourceSpan, clampSpan, evidenceOf, isSourced, segmentSource, summarizeReview };

package/dist/components/ai-extraction-review/index.js

@@ -0,0 +1,3 @@
+import { clampSpan, evidenceOf, isSourced, segmentSource, summarizeReview } from "./extraction-model.js";
+import { ExtractionReview } from "./ai-extraction-review.js";
+export { ExtractionReview, clampSpan, evidenceOf, isSourced, segmentSource, summarizeReview };

package/dist/components/ai-extraction-review/meta.js

@@ -0,0 +1,17 @@
+import { defineMeta } from "../../registry/schema.js";
+//#region src/components/ai-extraction-review/meta.ts
+const meta = defineMeta({
+	name: "ai-extraction-review",
+	title: "AI Extraction Review",
+	description: "Check extracted fields against the document they came from, and decide each one.",
+	category: "ai",
+	status: "stable",
+	dependencies: [],
+	registryDependencies: [],
+	files: ["extraction-model.ts", "ai-extraction-review.tsx"],
+	a11y: "Every field quotes its evidence in text under the value, so a reviewer who cannot see the highlight in the source still has what the model read. A value with no evidence is said in words — never left to look like a good one. The source is a focusable named region because it scrolls, and its highlights are mark elements with nothing spliced into the text, since a document read aloud with field names inserted is no longer the document. Focus anywhere in a field brings its evidence into view without moving focus, so a keyboard user is shown the source rather than sent into it. Each control's name carries the field it belongs to, so ten Accept buttons are ten different buttons. Status is a word, outside the label so editing never renames the control, and the running count is a polite live region present from the start. Enter accepts, except while an IME is composing."
+});
+//#endregion
+export { meta };
+
+//# sourceMappingURL=meta.js.map

package/dist/components/ai-extraction-review/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","names":[],"sources":["../../../src/components/ai-extraction-review/meta.ts"],"sourcesContent":["import { defineMeta } from \"@/registry/schema\";\n\nexport const meta = defineMeta({\n  name: \"ai-extraction-review\",\n  title: \"AI Extraction Review\",\n  description:\n    \"Check extracted fields against the document they came from, and decide each one.\",\n  category: \"ai\",\n  status: \"stable\",\n  dependencies: [],\n  registryDependencies: [],\n  files: [\"extraction-model.ts\", \"ai-extraction-review.tsx\"],\n  a11y:\n    \"Every field quotes its evidence in text under the value, so a reviewer who cannot see the \" +\n    \"highlight in the source still has what the model read. A value with no evidence is said in \" +\n    \"words — never left to look like a good one. The source is a focusable named region because \" +\n    \"it scrolls, and its highlights are mark elements with nothing spliced into the text, since a \" +\n    \"document read aloud with field names inserted is no longer the document. Focus anywhere in a \" +\n    \"field brings its evidence into view without moving focus, so a keyboard user is shown the \" +\n    \"source rather than sent into it. Each control's name carries the field it belongs to, so \" +\n    \"ten Accept buttons are ten different buttons. Status is a word, outside the label so editing \" +\n    \"never renames the control, and the running count is a polite live region present from the \" +\n    \"start. Enter accepts, except while an IME is composing.\",\n});\n"],"mappings":";;AAEA,MAAa,OAAO,WAAW;CAC7B,MAAM;CACN,OAAO;CACP,aACE;CACF,UAAU;CACV,QAAQ;CACR,cAAc,CAAC;CACf,sBAAsB,CAAC;CACvB,OAAO,CAAC,uBAAuB,0BAA0B;CACzD,MACE;AAUJ,CAAC"}

package/dist/components/ai-suggested-value/ai-suggested-value.d.ts

@@ -0,0 +1,72 @@
+import { ComponentPropsWithRef, ReactElement } from "react";
+//#region src/components/ai-suggested-value/ai-suggested-value.d.ts
+/**
+ * An AI-proposed value for a form control, offered beside it rather than
+ * written into it.
+ *
+ * Autofill is the most common shape AI takes inside ordinary software —
+ * enrich this contact, fill this form from the upload, guess the category —
+ * and nearly every implementation writes the value straight into the field
+ * as if the person had typed it. Two things go wrong. A plausible, wrong
+ * value rides through on the person's own Submit, because nothing marked it
+ * as needing a look. And once submitted, the record cannot tell a value the
+ * model supplied from one a human typed, which is the one fact an audit later
+ * needs.
+ *
+ * So the suggestion stays pending until it is accepted, and acceptance is
+ * reported rather than performed: the component hands the value to `onAccept`
+ * and never touches the control. That is also what lets it wrap any control —
+ * a select, a date, a number, a combobox — where ghost text can only complete
+ * a string. Afterwards the field says it was filled by AI, says if it was
+ * edited since, and offers to put back what was there.
+ *
+ * Deliberately no "accept all". A button that takes every suggestion at once
+ * is the review deleting itself, and every product that ships one watches its
+ * users press it without reading.
+ */
+interface Suggestion<T = string> {
+  value: T;
+  /** How the value reads — a select's option text, a formatted date. Defaults to the value. */
+  label?: string;
+  /** Where it came from, in the reader's language: "from the invoice header". */
+  source?: string;
+  /** 0 to 1. Shown as a number, never only as a colour. */
+  confidence?: number;
+}
+type SuggestionStatus = "pending" | "accepted" | "dismissed";
+interface SuggestedValueProps<T = string> extends Omit<ComponentPropsWithRef<"div">, "children" | "id" | "aria-describedby" | "aria-invalid"> {
+  /** The field, for the buttons' names: "Accept suggestion — Company". */
+  label: string;
+  /** Null or undefined offers nothing. A different suggestion starts pending again. */
+  suggestion?: Suggestion<T> | null;
+  /**
+   * The control's current value. Lets the marker say the fill was edited
+   * since, and lets Undo restore what the field held before.
+   */
+  value?: T;
+  /** Supply to own the status; otherwise it is kept here. */
+  status?: SuggestionStatus;
+  onAccept: (value: T, suggestion: Suggestion<T>) => void;
+  onDismiss?: (suggestion: Suggestion<T>) => void;
+  /** Called with the value the field held before the fill, so it can be put back. */
+  onRevert?: (previous: T | undefined) => void;
+  /** How to compare values. Object.is by default. */
+  equals?: (a: T, b: T) => boolean;
+  /** Confidence below this is called low, in words. */
+  lowConfidenceBelow?: number;
+  /**
+   * Announce a suggestion when it arrives. Off by default: a form that fills
+   * twenty fields at once would narrate all twenty, and the description on
+   * the control already tells a reader when they reach the field.
+   */
+  announce?: boolean;
+  /** The control. Receives the description, and any id or ARIA a FormControl passes down. */
+  children: ReactElement<Record<string, unknown>>;
+  id?: string;
+  "aria-describedby"?: string;
+  "aria-invalid"?: ComponentPropsWithRef<"input">["aria-invalid"];
+}
+declare function SuggestedValue<T = string>({ className, label, suggestion, value, status: controlledStatus, onAccept, onDismiss, onRevert, equals, lowConfidenceBelow, announce, children, id, "aria-describedby": describedByProp, "aria-invalid": ariaInvalid, ...props }: SuggestedValueProps<T>): import("react").JSX.Element;
+//#endregion
+export { SuggestedValue, SuggestedValueProps, Suggestion, SuggestionStatus };
+//# sourceMappingURL=ai-suggested-value.d.ts.map

package/dist/components/ai-suggested-value/ai-suggested-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-suggested-value.d.ts","names":[],"sources":["../../../src/components/ai-suggested-value/ai-suggested-value.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;UAwCiB,WAAW;EAC1B,OAAO;;EAEP;;EAEA;;EAEA;;KAGU;UAEK,oBAAoB,oBAAoB,KACvD;;EAIA;;EAEA,aAAa,WAAW;;;;;EAKxB,QAAQ;;EAER,SAAS;EACT,WAAW,OAAO,GAAG,YAAY,WAAW;EAC5C,aAAa,YAAY,WAAW;;EAEpC,YAAY,UAAU;;EAEtB,UAAU,GAAG,GAAG,GAAG;;EAEnB;;;;;;EAMA;;EAEA,UAAU,aAAa;EAEvB;EACA;EACA,iBAAiB;;iBAqBH,eAAe,cAC7B,WACA,OACA,YACA,OACA,QAAQ,kBACR,UACA,WACA,UACA,QACA,oBACA,UACA,UACA,wBACoB,iCACJ,gBACb,SACF,oBAAoB,qBAAE,IAAA"}

package/dist/components/ai-suggested-value/ai-suggested-value.js

@@ -0,0 +1,126 @@
+"use client";
+import { disabledStyles, focusRing } from "../../lib/styles.js";
+import { cn } from "../../lib/utils.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { cloneElement, isValidElement, useId, useState } from "react";
+//#region src/components/ai-suggested-value/ai-suggested-value.tsx
+function defaultLabel(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "bigint") return String(value);
+	if (typeof value === "boolean") return value ? "Yes" : "No";
+	if (value instanceof Date) return value.toLocaleDateString();
+	return JSON.stringify(value);
+}
+function sameSuggestion(a, b, equals) {
+	if (!a || !b) return a === b;
+	return equals(a.value, b.value) && a.label === b.label && a.source === b.source;
+}
+function SuggestedValue({ className, label, suggestion, value, status: controlledStatus, onAccept, onDismiss, onRevert, equals = Object.is, lowConfidenceBelow = .7, announce = false, children, id, "aria-describedby": describedByProp, "aria-invalid": ariaInvalid, ...props }) {
+	const descriptionId = useId();
+	const [internalStatus, setInternalStatus] = useState("pending");
+	const [previous, setPrevious] = useState(void 0);
+	const [seen, setSeen] = useState(suggestion);
+	if (!sameSuggestion(seen, suggestion, equals)) {
+		setSeen(suggestion);
+		setInternalStatus("pending");
+	}
+	const status = controlledStatus ?? internalStatus;
+	const offered = suggestion ?? null;
+	const pending = offered !== null && status === "pending";
+	const accepted = offered !== null && status === "accepted";
+	const edited = accepted && value !== void 0 && !equals(value, offered.value);
+	const low = offered?.confidence !== void 0 && offered.confidence < lowConfidenceBelow;
+	const percent = offered?.confidence === void 0 ? null : new Intl.NumberFormat(void 0, {
+		style: "percent",
+		maximumFractionDigits: 0
+	}).format(offered.confidence);
+	const source = offered?.source ? ` ${offered.source}` : "";
+	let description = null;
+	if (pending) description = /* @__PURE__ */ jsxs(Fragment, { children: [
+		"Suggested:",
+		" ",
+		/* @__PURE__ */ jsx("strong", {
+			className: "font-medium text-foreground",
+			children: offered.label ?? defaultLabel(offered.value)
+		}),
+		source ? `,${source}` : null,
+		percent !== null ? /* @__PURE__ */ jsx("span", {
+			className: cn(low && "text-warning"),
+			children: low ? `. Low confidence, ${percent} — worth checking` : `. ${percent} confidence`
+		}) : null
+	] });
+	else if (accepted) description = edited ? `Filled by AI${source ? `,${source}` : ""}, then edited` : `Filled by AI${source ? `,${source}` : ""}`;
+	const describedBy = [
+		isValidElement(children) ? children.props["aria-describedby"] : void 0,
+		describedByProp,
+		description !== null ? descriptionId : null
+	].filter(Boolean).join(" ") || void 0;
+	const control = isValidElement(children) ? cloneElement(children, {
+		id: id ?? children.props.id,
+		"aria-describedby": describedBy,
+		"aria-invalid": ariaInvalid ?? children.props["aria-invalid"]
+	}) : children;
+	const accept = () => {
+		if (!offered) return;
+		setPrevious(value);
+		setInternalStatus("accepted");
+		onAccept(offered.value, offered);
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		"data-slot": "suggested-value",
+		"data-status": offered ? status : void 0,
+		"data-filled-by": accepted ? "ai" : void 0,
+		"data-edited": edited || void 0,
+		className: cn("flex flex-col gap-1.5", className),
+		...props,
+		children: [control, /* @__PURE__ */ jsxs("div", {
+			"data-slot": "suggested-value-row",
+			"aria-live": announce ? "polite" : void 0,
+			className: cn("flex flex-wrap items-center gap-x-3 gap-y-1 text-xs", pending && "rounded-md border border-primary/40 bg-primary/5 px-2.5 py-1.5"),
+			children: [
+				description !== null ? /* @__PURE__ */ jsx("p", {
+					id: descriptionId,
+					"data-slot": "suggested-value-description",
+					className: "m-0 flex-1 text-muted-foreground",
+					children: description
+				}) : null,
+				pending ? /* @__PURE__ */ jsxs("span", {
+					className: "flex items-center gap-2",
+					children: [/* @__PURE__ */ jsx(RowButton, {
+						variant: "primary",
+						"aria-label": `Accept suggestion — ${label}`,
+						onClick: accept,
+						children: "Accept"
+					}), /* @__PURE__ */ jsx(RowButton, {
+						"aria-label": `Dismiss suggestion — ${label}`,
+						onClick: () => {
+							setInternalStatus("dismissed");
+							onDismiss?.(offered);
+						},
+						children: "Dismiss"
+					})]
+				}) : null,
+				accepted && onRevert ? /* @__PURE__ */ jsx(RowButton, {
+					"aria-label": `Undo — ${label}`,
+					onClick: () => {
+						setInternalStatus("pending");
+						onRevert(previous);
+					},
+					children: "Undo"
+				}) : null
+			]
+		})]
+	});
+}
+function RowButton({ className, variant = "default", ...props }) {
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		className: cn("rounded-md border px-2 py-0.5 text-xs font-medium transition-colors", variant === "primary" ? "border-primary bg-primary text-primary-foreground hover:bg-primary-hover" : "border-input bg-background hover:bg-accent hover:text-accent-foreground", focusRing, disabledStyles, className),
+		...props
+	});
+}
+//#endregion
+export { SuggestedValue };
+
+//# sourceMappingURL=ai-suggested-value.js.map

package/dist/components/ai-suggested-value/ai-suggested-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-suggested-value.js","names":[],"sources":["../../../src/components/ai-suggested-value/ai-suggested-value.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  cloneElement,\n  isValidElement,\n  useId,\n  useState,\n  type ComponentPropsWithRef,\n  type ReactElement,\n  type ReactNode,\n} from \"react\";\n\nimport { disabledStyles, focusRing } from \"@/lib/styles\";\nimport { cn } from \"@/lib/utils\";\n\n/**\n * An AI-proposed value for a form control, offered beside it rather than\n * written into it.\n *\n * Autofill is the most common shape AI takes inside ordinary software —\n * enrich this contact, fill this form from the upload, guess the category —\n * and nearly every implementation writes the value straight into the field\n * as if the person had typed it. Two things go wrong. A plausible, wrong\n * value rides through on the person's own Submit, because nothing marked it\n * as needing a look. And once submitted, the record cannot tell a value the\n * model supplied from one a human typed, which is the one fact an audit later\n * needs.\n *\n * So the suggestion stays pending until it is accepted, and acceptance is\n * reported rather than performed: the component hands the value to `onAccept`\n * and never touches the control. That is also what lets it wrap any control —\n * a select, a date, a number, a combobox — where ghost text can only complete\n * a string. Afterwards the field says it was filled by AI, says if it was\n * edited since, and offers to put back what was there.\n *\n * Deliberately no \"accept all\". A button that takes every suggestion at once\n * is the review deleting itself, and every product that ships one watches its\n * users press it without reading.\n */\n\nexport interface Suggestion<T = string> {\n  value: T;\n  /** How the value reads — a select's option text, a formatted date. Defaults to the value. */\n  label?: string;\n  /** Where it came from, in the reader's language: \"from the invoice header\". */\n  source?: string;\n  /** 0 to 1. Shown as a number, never only as a colour. */\n  confidence?: number;\n}\n\nexport type SuggestionStatus = \"pending\" | \"accepted\" | \"dismissed\";\n\nexport interface SuggestedValueProps<T = string> extends Omit<\n  ComponentPropsWithRef<\"div\">,\n  \"children\" | \"id\" | \"aria-describedby\" | \"aria-invalid\"\n> {\n  /** The field, for the buttons' names: \"Accept suggestion — Company\". */\n  label: string;\n  /** Null or undefined offers nothing. A different suggestion starts pending again. */\n  suggestion?: Suggestion<T> | null;\n  /**\n   * The control's current value. Lets the marker say the fill was edited\n   * since, and lets Undo restore what the field held before.\n   */\n  value?: T;\n  /** Supply to own the status; otherwise it is kept here. */\n  status?: SuggestionStatus;\n  onAccept: (value: T, suggestion: Suggestion<T>) => void;\n  onDismiss?: (suggestion: Suggestion<T>) => void;\n  /** Called with the value the field held before the fill, so it can be put back. */\n  onRevert?: (previous: T | undefined) => void;\n  /** How to compare values. Object.is by default. */\n  equals?: (a: T, b: T) => boolean;\n  /** Confidence below this is called low, in words. */\n  lowConfidenceBelow?: number;\n  /**\n   * Announce a suggestion when it arrives. Off by default: a form that fills\n   * twenty fields at once would narrate all twenty, and the description on\n   * the control already tells a reader when they reach the field.\n   */\n  announce?: boolean;\n  /** The control. Receives the description, and any id or ARIA a FormControl passes down. */\n  children: ReactElement<Record<string, unknown>>;\n  /* Passed through to the control, so this can sit inside a FormControl. */\n  id?: string;\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: ComponentPropsWithRef<\"input\">[\"aria-invalid\"];\n}\n\nfunction defaultLabel(value: unknown): string {\n  if (value === null || value === undefined) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"bigint\") return String(value);\n  if (typeof value === \"boolean\") return value ? \"Yes\" : \"No\";\n  if (value instanceof Date) return value.toLocaleDateString();\n  return JSON.stringify(value);\n}\n\nfunction sameSuggestion<T>(\n  a: Suggestion<T> | null | undefined,\n  b: Suggestion<T> | null | undefined,\n  equals: (x: T, y: T) => boolean,\n): boolean {\n  if (!a || !b) return a === b;\n  return equals(a.value, b.value) && a.label === b.label && a.source === b.source;\n}\n\nexport function SuggestedValue<T = string>({\n  className,\n  label,\n  suggestion,\n  value,\n  status: controlledStatus,\n  onAccept,\n  onDismiss,\n  onRevert,\n  equals = Object.is,\n  lowConfidenceBelow = 0.7,\n  announce = false,\n  children,\n  id,\n  \"aria-describedby\": describedByProp,\n  \"aria-invalid\": ariaInvalid,\n  ...props\n}: SuggestedValueProps<T>) {\n  const descriptionId = useId();\n\n  const [internalStatus, setInternalStatus] = useState<SuggestionStatus>(\"pending\");\n  const [previous, setPrevious] = useState<T | undefined>(undefined);\n\n  // A new suggestion starts pending, whatever happened to the last one.\n  // Compared by content rather than identity, so a parent that rebuilds the\n  // object on every keystroke does not reopen a suggestion already accepted.\n  const [seen, setSeen] = useState(suggestion);\n  if (!sameSuggestion(seen, suggestion, equals)) {\n    setSeen(suggestion);\n    setInternalStatus(\"pending\");\n  }\n\n  const status = controlledStatus ?? internalStatus;\n  const offered = suggestion ?? null;\n  const pending = offered !== null && status === \"pending\";\n  const accepted = offered !== null && status === \"accepted\";\n  const edited = accepted && value !== undefined && !equals(value, offered.value);\n\n  const low = offered?.confidence !== undefined && offered.confidence < lowConfidenceBelow;\n  const percent =\n    offered?.confidence === undefined\n      ? null\n      : new Intl.NumberFormat(undefined, { style: \"percent\", maximumFractionDigits: 0 }).format(\n          offered.confidence,\n        );\n\n  const source = offered?.source ? ` ${offered.source}` : \"\";\n\n  // What the control's description says. This is how a reader who lands on\n  // the field learns there is a suggestion, without any announcement.\n  let description: ReactNode = null;\n  if (pending) {\n    description = (\n      <>\n        Suggested:{\" \"}\n        <strong className=\"font-medium text-foreground\">\n          {offered.label ?? defaultLabel(offered.value)}\n        </strong>\n        {source ? `,${source}` : null}\n        {percent !== null ? (\n          <span className={cn(low && \"text-warning\")}>\n            {low ? `. Low confidence, ${percent} — worth checking` : `. ${percent} confidence`}\n          </span>\n        ) : null}\n      </>\n    );\n  } else if (accepted) {\n    description = edited\n      ? `Filled by AI${source ? `,${source}` : \"\"}, then edited`\n      : `Filled by AI${source ? `,${source}` : \"\"}`;\n  }\n\n  // Merged with whatever already describes the control — a FormControl's\n  // description and message, or the child's own — rather than replacing it.\n  const childDescribedBy = isValidElement(children)\n    ? (children.props[\"aria-describedby\"] as string | undefined)\n    : undefined;\n  const describedBy =\n    [childDescribedBy, describedByProp, description !== null ? descriptionId : null]\n      .filter(Boolean)\n      .join(\" \") || undefined;\n\n  const control = isValidElement(children)\n    ? cloneElement(children, {\n        id: id ?? children.props.id,\n        \"aria-describedby\": describedBy,\n        \"aria-invalid\": ariaInvalid ?? children.props[\"aria-invalid\"],\n      })\n    : children;\n\n  const accept = () => {\n    if (!offered) return;\n    setPrevious(value);\n    setInternalStatus(\"accepted\");\n    onAccept(offered.value, offered);\n  };\n\n  return (\n    <div\n      data-slot=\"suggested-value\"\n      data-status={offered ? status : undefined}\n      data-filled-by={accepted ? \"ai\" : undefined}\n      data-edited={edited || undefined}\n      className={cn(\"flex flex-col gap-1.5\", className)}\n      {...props}\n    >\n      {control}\n\n      {/* Present from the start and never display:none, so that with `announce`\n          a suggestion arriving after mount is heard — a region that enters the\n          accessibility tree at the same moment as its content announces\n          nothing. Empty, it has no height. */}\n      <div\n        data-slot=\"suggested-value-row\"\n        aria-live={announce ? \"polite\" : undefined}\n        className={cn(\n          \"flex flex-wrap items-center gap-x-3 gap-y-1 text-xs\",\n          pending && \"rounded-md border border-primary/40 bg-primary/5 px-2.5 py-1.5\",\n        )}\n      >\n        {description !== null ? (\n          <p\n            id={descriptionId}\n            data-slot=\"suggested-value-description\"\n            className=\"m-0 flex-1 text-muted-foreground\"\n          >\n            {description}\n          </p>\n        ) : null}\n\n        {pending ? (\n          <span className=\"flex items-center gap-2\">\n            <RowButton\n              variant=\"primary\"\n              aria-label={`Accept suggestion — ${label}`}\n              onClick={accept}\n            >\n              Accept\n            </RowButton>\n            <RowButton\n              aria-label={`Dismiss suggestion — ${label}`}\n              onClick={() => {\n                setInternalStatus(\"dismissed\");\n                onDismiss?.(offered);\n              }}\n            >\n              Dismiss\n            </RowButton>\n          </span>\n        ) : null}\n\n        {accepted && onRevert ? (\n          <RowButton\n            aria-label={`Undo — ${label}`}\n            onClick={() => {\n              setInternalStatus(\"pending\");\n              onRevert(previous);\n            }}\n          >\n            Undo\n          </RowButton>\n        ) : null}\n      </div>\n    </div>\n  );\n}\n\nfunction RowButton({\n  className,\n  variant = \"default\",\n  ...props\n}: ComponentPropsWithRef<\"button\"> & { variant?: \"default\" | \"primary\" }) {\n  return (\n    <button\n      type=\"button\"\n      className={cn(\n        \"rounded-md border px-2 py-0.5 text-xs font-medium transition-colors\",\n        variant === \"primary\"\n          ? \"border-primary bg-primary text-primary-foreground hover:bg-primary-hover\"\n          : \"border-input bg-background hover:bg-accent hover:text-accent-foreground\",\n        focusRing,\n        disabledStyles,\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n"],"mappings":"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"}

package/dist/components/ai-suggested-value/index.d.ts

@@ -0,0 +1,2 @@
+import { SuggestedValue, SuggestedValueProps, Suggestion, SuggestionStatus } from "./ai-suggested-value.js";
+export { SuggestedValue, type SuggestedValueProps, type Suggestion, type SuggestionStatus };

package/dist/components/ai-suggested-value/index.js

@@ -0,0 +1,2 @@
+import { SuggestedValue } from "./ai-suggested-value.js";
+export { SuggestedValue };

package/dist/components/ai-suggested-value/meta.js

@@ -0,0 +1,17 @@
+import { defineMeta } from "../../registry/schema.js";
+//#region src/components/ai-suggested-value/meta.ts
+const meta = defineMeta({
+	name: "ai-suggested-value",
+	title: "AI Suggested Value",
+	description: "An AI-proposed value for any form control, pending until accepted and marked afterwards.",
+	category: "ai",
+	status: "stable",
+	dependencies: [],
+	registryDependencies: [],
+	files: ["ai-suggested-value.tsx"],
+	a11y: "The suggestion is the control's description, so a reader who lands on the field hears it without any announcement — and announcing is opt-in, because a form filling twenty fields at once would narrate all twenty. The row that holds it is rendered from the start and never display:none, so when announcing is on, a suggestion arriving after mount is actually heard. Each button's name carries the field it belongs to, so a page of Accepts is a page of different buttons. Provenance and confidence are words with a number, never a colour. Acceptance is reported, not performed: the control is the consumer's, so its value, its label and its own keyboard behaviour are untouched — there is no shortcut hijacked from a select or a date field. The id and ARIA a FormControl passes down are forwarded to the control, and an existing aria-describedby is merged rather than replaced."
+});
+//#endregion
+export { meta };
+
+//# sourceMappingURL=meta.js.map

package/dist/components/ai-suggested-value/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","names":[],"sources":["../../../src/components/ai-suggested-value/meta.ts"],"sourcesContent":["import { defineMeta } from \"@/registry/schema\";\n\nexport const meta = defineMeta({\n  name: \"ai-suggested-value\",\n  title: \"AI Suggested Value\",\n  description:\n    \"An AI-proposed value for any form control, pending until accepted and marked afterwards.\",\n  category: \"ai\",\n  status: \"stable\",\n  dependencies: [],\n  registryDependencies: [],\n  files: [\"ai-suggested-value.tsx\"],\n  a11y:\n    \"The suggestion is the control's description, so a reader who lands on the field hears it \" +\n    \"without any announcement — and announcing is opt-in, because a form filling twenty fields at \" +\n    \"once would narrate all twenty. The row that holds it is rendered from the start and never \" +\n    \"display:none, so when announcing is on, a suggestion arriving after mount is actually heard. \" +\n    \"Each button's name carries the field it belongs to, so a page of Accepts is a page of \" +\n    \"different buttons. Provenance and confidence are words with a number, never a colour. \" +\n    \"Acceptance is reported, not performed: the control is the consumer's, so its value, its \" +\n    \"label and its own keyboard behaviour are untouched — there is no shortcut hijacked from a \" +\n    \"select or a date field. The id and ARIA a FormControl passes down are forwarded to the \" +\n    \"control, and an existing aria-describedby is merged rather than replaced.\",\n});\n"],"mappings":";;AAEA,MAAa,OAAO,WAAW;CAC7B,MAAM;CACN,OAAO;CACP,aACE;CACF,UAAU;CACV,QAAQ;CACR,cAAc,CAAC;CACf,sBAAsB,CAAC;CACvB,OAAO,CAAC,wBAAwB;CAChC,MACE;AAUJ,CAAC"}

package/dist/components/alert/alert.d.ts

@@ -2,7 +2,7 @@ import { VariantProps } from "class-variance-authority";
 import { ComponentPropsWithRef } from "react";
 //#region src/components/alert/alert.d.ts
 declare const alertVariants: (props?: ({
-  variant?: "default" | "destructive" | "success" | "warning" | "info" | null | undefined;
+  variant?: "success" | "warning" | "destructive" | "default" | "info" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 /**
  * How urgently the alert should interrupt a screen reader.

package/dist/components/avatar/avatar.d.ts

@@ -3,7 +3,7 @@ import { VariantProps } from "class-variance-authority";
 import { ComponentPropsWithRef } from "react";
 //#region src/components/avatar/avatar.d.ts
 declare const avatarVariants: (props?: ({
-  size?: "sm" | "md" | "lg" | "xs" | "xl" | null | undefined;
+  size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 interface AvatarProps extends ComponentPropsWithRef<typeof Avatar.Root>, VariantProps<typeof avatarVariants> {}
 /** Image representation of a user or entity, with a text fallback. */

package/dist/components/badge/badge.d.ts

@@ -2,7 +2,7 @@ import { VariantProps } from "class-variance-authority";
 import { ComponentPropsWithRef } from "react";
 //#region src/components/badge/badge.d.ts
 declare const badgeVariants: (props?: ({
-  variant?: "default" | "secondary" | "outline" | "destructive" | "success" | "warning" | "info" | null | undefined;
+  variant?: "success" | "warning" | "destructive" | "default" | "secondary" | "outline" | "info" | null | undefined;
   size?: "sm" | "md" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 interface BadgeProps extends ComponentPropsWithRef<"span">, VariantProps<typeof badgeVariants> {

package/dist/components/button/button.d.ts

@@ -2,7 +2,7 @@ import { VariantProps } from "class-variance-authority";
 import { ComponentPropsWithRef } from "react";
 //#region src/components/button/button.d.ts
 declare const buttonVariants: (props?: ({
-  variant?: "link" | "secondary" | "outline" | "destructive" | "primary" | "ghost" | null | undefined;
+  variant?: "link" | "primary" | "destructive" | "secondary" | "outline" | "ghost" | null | undefined;
   size?: "sm" | "md" | "lg" | "icon" | "icon-sm" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 interface ButtonProps extends ComponentPropsWithRef<"button">, VariantProps<typeof buttonVariants> {