@adea-ai/ui 0.140.0 → 0.142.0

package/dist/components/ui/field/number-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"number-field.js","names":["createEffect","createSignal","JSX","FormField","Input","NumberFieldProps","label","hint","value","min","max","step","integer","onChange","class","onBlur","EventHandler","HTMLInputElement","FocusEvent","NumberField","props","draft","setDraft","String","error","setError","undefined","Number","isInteger","validate","raw","next","isFinite","steps","Math","abs","round","_$createComponent","children","type","required","onInput","event","currentTarget","nextError","_$createComponent"],"sources":["../../../../src/components/ui/field/number-field.tsx"],"sourcesContent":["import { createEffect, createSignal, type JSX } from 'solid-js'\nimport { FormField } from './field'\nimport { Input } from '../input/input'\n\nexport type NumberFieldProps = {\n  label: string\n  hint?: string\n  value: number\n  min: number\n  max: number\n  /**\n   * The increment of the spinner and the arrow keys, and the grid a typed value\n   * must sit on: `min` plus a whole number of steps. Use it for stepped or\n   * fractional values (`0.05` for a 0-1 score, `5` for a percentage in fives).\n   * Without it a field steps by 1, or by `any` when `integer` is `false`, which\n   * accepts every decimal but leaves the spinner moving in whole numbers.\n   */\n  step?: number\n  /**\n   * Whether only whole numbers are valid. It defaults to `true`, or, when a\n   * `step` is given, to whether both the step and its base `min` are whole\n   * numbers, so `step={0.05}` accepts decimals without also saying\n   * `integer={false}`, and `min={0.5} step={1}` accepts 0.5, 1.5, 2.5.\n   */\n  integer?: boolean\n  onChange: (value: number) => void\n  class?: string\n  onBlur?: JSX.EventHandler<HTMLInputElement, FocusEvent>\n}\n\n/**\n * A controlled numeric field that keeps an editable draft while validating\n * range, integer and step constraints. Invalid drafts are announced and restored\n * to the latest controlled value when focus leaves the input, so `onChange`\n * only ever receives a value the field accepts — a caller never needs a\n * `Number(value) || fallback` of its own.\n */\nexport function NumberField(props: NumberFieldProps) {\n  const [draft, setDraft] = createSignal(String(props.value))\n  const [error, setError] = createSignal('')\n  // Whole numbers only when nothing on the grid is fractional: a whole step from\n  // a fractional `min` (0.5, 1.5, 2.5) puts the spinner's own values off the\n  // integers, so inference needs the step and its base to both be whole.\n  const integer = () =>\n    props.integer ??\n    (props.step === undefined || (Number.isInteger(props.step) && Number.isInteger(props.min)))\n\n  createEffect(() => {\n    setDraft(String(props.value))\n  })\n\n  const validate = (raw: string) => {\n    if (!raw) return `${props.label} is required.`\n    const next = Number(raw)\n    if (!Number.isFinite(next)) return `${props.label} must be a valid number.`\n    if (integer() && !Number.isInteger(next)) {\n      return `${props.label} must be a whole number.`\n    }\n    if (next < props.min || next > props.max) {\n      return `${props.label} must be between ${props.min} and ${props.max}.`\n    }\n    if (props.step !== undefined && props.step > 0) {\n      // Compare in whole steps with a tolerance: 0.15 / 0.05 is 3.0000000000000004,\n      // and rejecting it would make the spinner's own values invalid.\n      const steps = (next - props.min) / props.step\n      if (Math.abs(steps - Math.round(steps)) > 1e-9) {\n        return props.min === 0\n          ? `${props.label} must be a multiple of ${props.step}.`\n          : `${props.label} must be ${props.min} plus a multiple of ${props.step}.`\n      }\n    }\n    return ''\n  }\n\n  return (\n    <FormField label={props.label} hint={props.hint} error={error()} class={props.class}>\n      <Input\n        type=\"number\"\n        value={draft()}\n        min={props.min}\n        max={props.max}\n        step={props.step ?? (integer() ? 1 : 'any')}\n        required\n        onInput={(event) => {\n          const raw = event.currentTarget.value\n          setDraft(raw)\n          const nextError = validate(raw)\n          setError(nextError)\n          if (!nextError) props.onChange(Number(raw))\n        }}\n        onBlur={(event) => {\n          const nextError = validate(draft())\n          if (nextError) {\n            setDraft(String(props.value))\n            setError('')\n          }\n          props.onBlur?.(event)\n        }}\n      />\n    </FormField>\n  )\n}\n"],"mappings":";;;;;;;;;;;;AAqCA,SAAgBmB,YAAYC,OAAyB;CACnD,MAAM,CAACC,OAAOC,YAAYrB,aAAasB,OAAOH,MAAMZ,KAAK,CAAC;CAC1D,MAAM,CAACgB,OAAOC,YAAYxB,aAAa,EAAE;CAIzC,MAAMW,gBACJQ,MAAMR,YACLQ,MAAMT,SAASe,KAAAA,KAAcC,OAAOC,UAAUR,MAAMT,IAAI,KAAKgB,OAAOC,UAAUR,MAAMX,GAAG;CAE1FT,mBAAmB;EACjBsB,SAASC,OAAOH,MAAMZ,KAAK,CAAC;CAC9B,CAAC;CAED,MAAMqB,YAAYC,QAAgB;EAChC,IAAI,CAACA,KAAK,OAAO,GAAGV,MAAMd,MAAK;EAC/B,MAAMyB,OAAOJ,OAAOG,GAAG;EACvB,IAAI,CAACH,OAAOK,SAASD,IAAI,GAAG,OAAO,GAAGX,MAAMd,MAAK;EACjD,IAAIM,QAAQ,KAAK,CAACe,OAAOC,UAAUG,IAAI,GACrC,OAAO,GAAGX,MAAMd,MAAK;EAEvB,IAAIyB,OAAOX,MAAMX,OAAOsB,OAAOX,MAAMV,KACnC,OAAO,GAAGU,MAAMd,MAAK,mBAAoBc,MAAMX,IAAG,OAAQW,MAAMV,IAAG;EAErE,IAAIU,MAAMT,SAASe,KAAAA,KAAaN,MAAMT,OAAO,GAAG;GAG9C,MAAMsB,SAASF,OAAOX,MAAMX,OAAOW,MAAMT;GACzC,IAAIuB,KAAKC,IAAIF,QAAQC,KAAKE,MAAMH,KAAK,CAAC,IAAI,MACxC,OAAOb,MAAMX,QAAQ,IACjB,GAAGW,MAAMd,MAAK,yBAA0Bc,MAAMT,KAAI,KAClD,GAAGS,MAAMd,MAAK,WAAYc,MAAMX,IAAG,sBAAuBW,MAAMT,KAAI;EAE5E;EACA,OAAO;CACT;CAEA,OAAA0B,gBACGlC,WAAS;EAAA,IAACG,QAAK;GAAA,OAAEc,MAAMd;EAAK;EAAA,IAAEC,OAAI;GAAA,OAAEa,MAAMb;EAAI;EAAA,IAAEiB,QAAK;GAAA,OAAEA,MAAM;EAAC;EAAA,KAAA,WAAA;GAAA,OAASJ,MAAMN;EAAK;EAAA,IAAAwB,WAAA;GAAA,OAAAD,gBAChFjC,OAAK;IACJmC,MAAI;IAAA,IACJ/B,QAAK;KAAA,OAAEa,MAAM;IAAC;IAAA,IACdZ,MAAG;KAAA,OAAEW,MAAMX;IAAG;IAAA,IACdC,MAAG;KAAA,OAAEU,MAAMV;IAAG;IAAA,IACdC,OAAI;KAAA,OAAES,MAAMT,SAASC,QAAQ,IAAI,IAAI;IAAM;IAC3C4B,UAAQ;IACRC,UAAUC,UAAU;KAClB,MAAMZ,MAAMY,MAAMC,cAAcnC;KAChCc,SAASQ,GAAG;KACZ,MAAMc,YAAYf,SAASC,GAAG;KAC9BL,SAASmB,SAAS;KAClB,IAAI,CAACA,WAAWxB,MAAMP,SAASc,OAAOG,GAAG,CAAC;IAC5C;IACAf,SAAS2B,UAAU;KAEjB,IADkBb,SAASR,MAAM,CAC7BuB,GAAW;MACbtB,SAASC,OAAOH,MAAMZ,KAAK,CAAC;MAC5BiB,SAAS,EAAE;KACb;KACAL,MAAML,SAAS2B,KAAK;IACtB;GAAC,CAAA;EAAA;CAAA,CAAA;AAIT"}
+{"version":3,"file":"number-field.js","names":["createEffect","createSignal","JSX","FormField","Input","NumberFieldBaseProps","label","hint","min","max","step","integer","disabled","class","onBlur","EventHandler","HTMLInputElement","FocusEvent","NumberFieldProps","optional","value","onChange","text","String","NumberField","props","draft","setDraft","error","setError","undefined","Number","isInteger","validate","raw","badInput","next","isFinite","steps","Math","abs","round","_$createComponent","children","type","required","onInput","event","currentTarget","validity","nextError","_$createComponent"],"sources":["../../../../src/components/ui/field/number-field.tsx"],"sourcesContent":["import { createEffect, createSignal, type JSX } from 'solid-js'\nimport { FormField } from './field'\nimport { Input } from '../input/input'\n\ntype NumberFieldBaseProps = {\n  label: string\n  hint?: string\n  min: number\n  max: number\n  /**\n   * The increment of the spinner and the arrow keys, and the grid a typed value\n   * must sit on: `min` plus a whole number of steps. Use it for stepped or\n   * fractional values (`0.05` for a 0-1 score, `5` for a percentage in fives).\n   * Without it a field steps by 1, or by `any` when `integer` is `false`, which\n   * accepts every decimal but leaves the spinner moving in whole numbers.\n   */\n  step?: number\n  /**\n   * Whether only whole numbers are valid. It defaults to `true`, or, when a\n   * `step` is given, to whether both the step and its base `min` are whole\n   * numbers, so `step={0.05}` accepts decimals without also saying\n   * `integer={false}`, and `min={0.5} step={1}` accepts 0.5, 1.5, 2.5.\n   */\n  integer?: boolean\n  /** Locks the input; a locked field keeps its value and reports nothing. */\n  disabled?: boolean\n  class?: string\n  onBlur?: JSX.EventHandler<HTMLInputElement, FocusEvent>\n}\n\nexport type NumberFieldProps = NumberFieldBaseProps &\n  (\n    | {\n        optional?: false\n        value: number\n        onChange: (value: number) => void\n      }\n    | {\n        /**\n         * Lets the field be left blank: a blank field is valid and reports `null`,\n         * and a `null` value shows a blank field. Use it for a limit that falls\n         * back to a default when unset, so a caller never maps `''` to\n         * `undefined` of its own.\n         */\n        optional: true\n        value: number | null\n        onChange: (value: number | null) => void\n      }\n  )\n\nconst text = (value: number | null) => (value === null ? '' : String(value))\n\n/**\n * A controlled numeric field that keeps an editable draft while validating\n * range, integer and step constraints. Invalid drafts are announced and restored\n * to the latest controlled value when focus leaves the input, so `onChange`\n * only ever receives a value the field accepts — a caller never needs a\n * `Number(value) || fallback` of its own. With `optional`, blank is accepted and\n * reported as `null`.\n */\nexport function NumberField(props: NumberFieldProps) {\n  const [draft, setDraft] = createSignal(text(props.value))\n  const [error, setError] = createSignal('')\n  // Whole numbers only when nothing on the grid is fractional: a whole step from\n  // a fractional `min` (0.5, 1.5, 2.5) puts the spinner's own values off the\n  // integers, so inference needs the step and its base to both be whole.\n  const integer = () =>\n    props.integer ??\n    (props.step === undefined || (Number.isInteger(props.step) && Number.isInteger(props.min)))\n\n  createEffect(() => {\n    setDraft(text(props.value))\n  })\n\n  // A number input reports '' both when it is empty and when it holds text it cannot parse\n  // (\"abc\", \"-\", \"1e\"); only `validity.badInput` tells them apart, and a bad draft must never\n  // count as blank (it would report `null` and clear the limit).\n  const validate = (raw: string, badInput: boolean) => {\n    if (badInput) return `${props.label} must be a valid number.`\n    if (!raw) return props.optional ? '' : `${props.label} is required.`\n    const next = Number(raw)\n    if (!Number.isFinite(next)) return `${props.label} must be a valid number.`\n    if (integer() && !Number.isInteger(next)) {\n      return `${props.label} must be a whole number.`\n    }\n    if (next < props.min || next > props.max) {\n      return `${props.label} must be between ${props.min} and ${props.max}.`\n    }\n    if (props.step !== undefined && props.step > 0) {\n      // Compare in whole steps with a tolerance: 0.15 / 0.05 is 3.0000000000000004,\n      // and rejecting it would make the spinner's own values invalid.\n      const steps = (next - props.min) / props.step\n      if (Math.abs(steps - Math.round(steps)) > 1e-9) {\n        return props.min === 0\n          ? `${props.label} must be a multiple of ${props.step}.`\n          : `${props.label} must be ${props.min} plus a multiple of ${props.step}.`\n      }\n    }\n    return ''\n  }\n\n  return (\n    <FormField label={props.label} hint={props.hint} error={error()} class={props.class}>\n      <Input\n        type=\"number\"\n        value={draft()}\n        min={props.min}\n        max={props.max}\n        step={props.step ?? (integer() ? 1 : 'any')}\n        required={!props.optional}\n        disabled={props.disabled}\n        onInput={(event) => {\n          const raw = event.currentTarget.value\n          // Read before touching the draft: writing '' back to the input would clear the entry and\n          // with it `badInput`. An unparsable entry keeps the last draft and the text on screen, so\n          // the user can correct it; blur restores the last good value.\n          const badInput = event.currentTarget.validity.badInput\n          if (!badInput) setDraft(raw)\n          const nextError = validate(raw, badInput)\n          setError(nextError)\n          if (nextError) return\n          // `optional` narrows the callback to `number | null`; a required field never sees `''`.\n          ;(props.onChange as (value: number | null) => void)(raw ? Number(raw) : null)\n        }}\n        onBlur={(event) => {\n          const nextError = validate(draft(), event.currentTarget.validity.badInput)\n          if (nextError) {\n            setDraft(text(props.value))\n            setError('')\n            // The draft of an unparsable entry is '' and so is the restored blank value: the signal\n            // does not change, so the DOM has to be reset by hand to drop the leftover text.\n            event.currentTarget.value = text(props.value)\n          }\n          props.onBlur?.(event)\n        }}\n      />\n    </FormField>\n  )\n}\n"],"mappings":"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"}

package/dist/components/ui/marker/index.d.ts

@@ -0,0 +1,2 @@
+export { Marker, markerVariants, type MarkerProps } from './marker';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/ui/marker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/marker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA"}

package/dist/components/ui/marker/index.js

@@ -0,0 +1,2 @@
+import { Marker, markerVariants } from "./marker.js";
+export { Marker, markerVariants };

package/dist/components/ui/marker/marker.d.ts

@@ -0,0 +1,35 @@
+import { type ComponentProps, type JSX } from 'solid-js';
+import { type VariantProps } from '#lib/variants';
+/**
+ * Marker.
+ *
+ * A note or divider *between* turns: a day change, a reconnect, a cancelled run,
+ * an event the transcript does not recognise. It is deliberately the quietest
+ * element in the column — a hairline with a label — because the transcript has
+ * dozens of these and any one that shouts teaches the reader to stop looking.
+ *
+ * `variant="rule"` draws the hairline either side (a boundary: "Today",
+ * "Reconnected"); `variant="note"` is a bare line of text with its mark (an
+ * observation that sits inside the flow). `tone` colours the mark and label and
+ * is never the only signal — the `label` always says it in words.
+ *
+ * A marker is static by default. Pass `live` for one that reports a change the
+ * reader must not miss (connection lost): it becomes a status region (`polite`)
+ * or an alert (`assertive`). A divider is not an ARIA separator, because
+ * `separator` is defined to carry no content.
+ */
+export declare const markerVariants: (props?: ({
+    tone?: "success" | "warning" | "info" | "neutral" | "danger" | null | undefined;
+    variant?: "note" | "rule" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type MarkerProps = Omit<ComponentProps<'div'>, 'children'> & VariantProps<typeof markerVariants> & {
+    label: JSX.Element;
+    icon?: JSX.Element;
+    /** Secondary text after the label: a time, a count. */
+    description?: JSX.Element;
+    /** A control that belongs to the note: Retry, Reconnect. */
+    action?: JSX.Element;
+    live?: 'polite' | 'assertive';
+};
+export declare function Marker(props: MarkerProps): JSX.Element;
+//# sourceMappingURL=marker.d.ts.map

package/dist/components/ui/marker/marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/marker/marker.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,GAAG,EAAE,MAAM,UAAU,CAAA;AAE1E,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc;;;8EAezB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAC/D,YAAY,CAAC,OAAO,cAAc,CAAC,GAAG;IACpC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IAClB,uDAAuD;IACvD,WAAW,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACzB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACpB,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAA;CAC9B,CAAA;AAEH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,eAuCxC"}

package/dist/components/ui/marker/marker.js

@@ -0,0 +1,123 @@
+import { cn } from "../../../lib/utils.js";
+import { cva } from "../../../lib/variants.js";
+import { createComponent, insert, memo, mergeProps, spread, template } from "solid-js/web";
+import { Show, splitProps } from "solid-js";
+//#region src/components/ui/marker/marker.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<span aria-hidden=true class="h-px min-w-4 flex-1 bg-border">`);
+var _tmpl$2 = /*#__PURE__*/ template(`<span aria-hidden=true class="grid shrink-0 place-items-center [&amp;_svg]:size-3.5">`);
+var _tmpl$3 = /*#__PURE__*/ template(`<span class="text-muted-foreground [overflow-wrap:anywhere]">`);
+var _tmpl$4 = /*#__PURE__*/ template(`<div data-slot=marker><span class="flex min-w-0 items-center gap-1.5"><span class="font-medium [overflow-wrap:anywhere]">`);
+/**
+* Marker.
+*
+* A note or divider *between* turns: a day change, a reconnect, a cancelled run,
+* an event the transcript does not recognise. It is deliberately the quietest
+* element in the column — a hairline with a label — because the transcript has
+* dozens of these and any one that shouts teaches the reader to stop looking.
+*
+* `variant="rule"` draws the hairline either side (a boundary: "Today",
+* "Reconnected"); `variant="note"` is a bare line of text with its mark (an
+* observation that sits inside the flow). `tone` colours the mark and label and
+* is never the only signal — the `label` always says it in words.
+*
+* A marker is static by default. Pass `live` for one that reports a change the
+* reader must not miss (connection lost): it becomes a status region (`polite`)
+* or an alert (`assertive`). A divider is not an ARIA separator, because
+* `separator` is defined to carry no content.
+*/
+var markerVariants = cva("flex min-w-0 items-center gap-3 text-xs", {
+	variants: {
+		tone: {
+			neutral: "text-muted-foreground",
+			info: "text-info",
+			success: "text-success",
+			warning: "text-warning",
+			danger: "text-destructive"
+		},
+		variant: {
+			rule: "w-full",
+			note: "w-full justify-start"
+		}
+	},
+	defaultVariants: {
+		tone: "neutral",
+		variant: "rule"
+	}
+});
+function Marker(props) {
+	const [local, rest] = splitProps(props, [
+		"class",
+		"tone",
+		"variant",
+		"label",
+		"icon",
+		"description",
+		"action",
+		"live"
+	]);
+	const rule = () => (local.variant ?? "rule") === "rule";
+	return (() => {
+		var _el$ = _tmpl$4(), _el$3 = _el$.firstChild, _el$5 = _el$3.firstChild;
+		spread(_el$, mergeProps({
+			get role() {
+				return memo(() => local.live === "assertive")() ? "alert" : local.live === "polite" ? "status" : void 0;
+			},
+			get ["class"]() {
+				return cn(markerVariants({
+					tone: local.tone,
+					variant: local.variant
+				}), local.class);
+			}
+		}, rest), false, true);
+		insert(_el$, createComponent(Show, {
+			get when() {
+				return rule();
+			},
+			get children() {
+				return _tmpl$();
+			}
+		}), _el$3);
+		insert(_el$3, createComponent(Show, {
+			get when() {
+				return local.icon;
+			},
+			get children() {
+				var _el$4 = _tmpl$2();
+				insert(_el$4, () => local.icon);
+				return _el$4;
+			}
+		}), _el$5);
+		insert(_el$5, () => local.label);
+		insert(_el$3, createComponent(Show, {
+			get when() {
+				return local.description;
+			},
+			get children() {
+				var _el$6 = _tmpl$3();
+				insert(_el$6, () => local.description);
+				return _el$6;
+			}
+		}), null);
+		insert(_el$3, createComponent(Show, {
+			get when() {
+				return local.action;
+			},
+			get children() {
+				return local.action;
+			}
+		}), null);
+		insert(_el$, createComponent(Show, {
+			get when() {
+				return rule();
+			},
+			get children() {
+				return _tmpl$();
+			}
+		}), null);
+		return _el$;
+	})();
+}
+//#endregion
+export { Marker, markerVariants };
+
+//# sourceMappingURL=marker.js.map

package/dist/components/ui/marker/marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.js","names":["Show","splitProps","ComponentProps","JSX","cn","cva","VariantProps","markerVariants","variants","tone","neutral","info","success","warning","danger","variant","rule","note","defaultVariants","MarkerProps","Omit","label","Element","icon","description","action","live","Marker","props","local","rest","_el$","_tmpl$4","_el$3","firstChild","_el$5","_$spread","_$mergeProps","role","_$memo","undefined","class","_$insert","_$createComponent","when","children","_tmpl$","_el$4","_tmpl$2","_el$6","_tmpl$3","_$mergeProps","_$memo","_$createComponent"],"sources":["../../../../src/components/ui/marker/marker.tsx"],"sourcesContent":["import { Show, splitProps, type ComponentProps, type JSX } from 'solid-js'\nimport { cn } from '#lib/utils'\nimport { cva, type VariantProps } from '#lib/variants'\n\n/**\n * Marker.\n *\n * A note or divider *between* turns: a day change, a reconnect, a cancelled run,\n * an event the transcript does not recognise. It is deliberately the quietest\n * element in the column — a hairline with a label — because the transcript has\n * dozens of these and any one that shouts teaches the reader to stop looking.\n *\n * `variant=\"rule\"` draws the hairline either side (a boundary: \"Today\",\n * \"Reconnected\"); `variant=\"note\"` is a bare line of text with its mark (an\n * observation that sits inside the flow). `tone` colours the mark and label and\n * is never the only signal — the `label` always says it in words.\n *\n * A marker is static by default. Pass `live` for one that reports a change the\n * reader must not miss (connection lost): it becomes a status region (`polite`)\n * or an alert (`assertive`). A divider is not an ARIA separator, because\n * `separator` is defined to carry no content.\n */\nexport const markerVariants = cva('flex min-w-0 items-center gap-3 text-xs', {\n  variants: {\n    tone: {\n      neutral: 'text-muted-foreground',\n      info: 'text-info',\n      success: 'text-success',\n      warning: 'text-warning',\n      danger: 'text-destructive',\n    },\n    variant: {\n      rule: 'w-full',\n      note: 'w-full justify-start',\n    },\n  },\n  defaultVariants: { tone: 'neutral', variant: 'rule' },\n})\n\nexport type MarkerProps = Omit<ComponentProps<'div'>, 'children'> &\n  VariantProps<typeof markerVariants> & {\n    label: JSX.Element\n    icon?: JSX.Element\n    /** Secondary text after the label: a time, a count. */\n    description?: JSX.Element\n    /** A control that belongs to the note: Retry, Reconnect. */\n    action?: JSX.Element\n    live?: 'polite' | 'assertive'\n  }\n\nexport function Marker(props: MarkerProps) {\n  const [local, rest] = splitProps(props, [\n    'class',\n    'tone',\n    'variant',\n    'label',\n    'icon',\n    'description',\n    'action',\n    'live',\n  ])\n  const rule = () => (local.variant ?? 'rule') === 'rule'\n  return (\n    <div\n      data-slot=\"marker\"\n      role={local.live === 'assertive' ? 'alert' : local.live === 'polite' ? 'status' : undefined}\n      class={cn(markerVariants({ tone: local.tone, variant: local.variant }), local.class)}\n      {...rest}\n    >\n      <Show when={rule()}>\n        <span aria-hidden=\"true\" class=\"h-px min-w-4 flex-1 bg-border\" />\n      </Show>\n      <span class=\"flex min-w-0 items-center gap-1.5\">\n        <Show when={local.icon}>\n          <span aria-hidden=\"true\" class=\"grid shrink-0 place-items-center [&_svg]:size-3.5\">\n            {local.icon}\n          </span>\n        </Show>\n        <span class=\"font-medium [overflow-wrap:anywhere]\">{local.label}</span>\n        <Show when={local.description}>\n          <span class=\"text-muted-foreground [overflow-wrap:anywhere]\">{local.description}</span>\n        </Show>\n        <Show when={local.action}>{local.action}</Show>\n      </span>\n      <Show when={rule()}>\n        <span aria-hidden=\"true\" class=\"h-px min-w-4 flex-1 bg-border\" />\n      </Show>\n    </div>\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAaO,iBAAiBF,IAAI,2CAA2C;CAC3EG,UAAU;EACRC,MAAM;GACJC,SAAS;GACTC,MAAM;GACNC,SAAS;GACTC,SAAS;GACTC,QAAQ;EACV;EACAC,SAAS;GACPC,MAAM;GACNC,MAAM;EACR;CACF;CACAC,iBAAiB;EAAET,MAAM;EAAWM,SAAS;CAAO;AACtD,CAAC;AAaD,SAAgBY,OAAOC,OAAoB;CACzC,MAAM,CAACC,OAAOC,QAAQ7B,WAAW2B,OAAO;EACtC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAAM,CACP;CACD,MAAMZ,cAAca,MAAMd,WAAW,YAAY;CACjD,cAAA;EAAA,IAAAgB,OAAAC,QAAA,GAAAC,QAAAF,KAAAG,YAAAC,QAAAF,MAAAC;EAAAE,OAAAL,MAAAM,WAAA;GAAA,IAGIC,OAAI;IAAA,OAAEC,WAAAV,MAAMH,SAAS,WAAW,CAAA,CAAA,IAAG,UAAUG,MAAMH,SAAS,WAAW,WAAWc,KAAAA;GAAS;GAAA,KAAA,WAAA;IAAA,OACpFpC,GAAGG,eAAe;KAAEE,MAAMoB,MAAMpB;KAAMM,SAASc,MAAMd;IAAQ,CAAC,GAAGc,MAAMY,KAAK;GAAC;EAAA,GAChFX,IAAI,GAAA,OAAA,IAAA;EAAAY,OAAAX,MAAAY,gBAEP3C,MAAI;GAAA,IAAC4C,OAAI;IAAA,OAAE5B,KAAK;GAAC;GAAA,IAAA6B,WAAA;IAAA,OAAAC,OAAA;GAAA;EAAA,CAAA,GAAAb,KAAA;EAAAS,OAAAT,OAAAU,gBAIf3C,MAAI;GAAA,IAAC4C,OAAI;IAAA,OAAEf,MAAMN;GAAI;GAAA,IAAAsB,WAAA;IAAA,IAAAE,QAAAC,QAAA;IAAAN,OAAAK,aAEjBlB,MAAMN,IAAI;IAAA,OAAAwB;GAAA;EAAA,CAAA,GAAAZ,KAAA;EAAAO,OAAAP,aAGqCN,MAAMR,KAAK;EAAAqB,OAAAT,OAAAU,gBAC9D3C,MAAI;GAAA,IAAC4C,OAAI;IAAA,OAAEf,MAAML;GAAW;GAAA,IAAAqB,WAAA;IAAA,IAAAI,QAAAC,QAAA;IAAAR,OAAAO,aACmCpB,MAAML,WAAW;IAAA,OAAAyB;GAAA;EAAA,CAAA,GAAA,IAAA;EAAAP,OAAAT,OAAAU,gBAEhF3C,MAAI;GAAA,IAAC4C,OAAI;IAAA,OAAEf,MAAMJ;GAAM;GAAA,IAAAoB,WAAA;IAAA,OAAGhB,MAAMJ;GAAM;EAAA,CAAA,GAAA,IAAA;EAAAiB,OAAAX,MAAAY,gBAExC3C,MAAI;GAAA,IAAC4C,OAAI;IAAA,OAAE5B,KAAK;GAAC;GAAA,IAAA6B,WAAA;IAAA,OAAAC,OAAA;GAAA;EAAA,CAAA,GAAA,IAAA;EAAA,OAAAf;CAAA,EAAA,CAAA;AAKxB"}

package/dist/components/ui/message/cite-ranges.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Citations that arrive as positions in the text, placed as markers.
+ *
+ * A producer that cites a passage says *where*: a half-open span of the exact
+ * text and the sources behind it. `MessageText` binds `[^n]` markers, so this
+ * turns the one into the other without ever changing what the text says:
+ *
+ * - A marker goes at the **end** of the span, nowhere else, and only for numbers
+ *   within `count`. Several spans ending at one place share one marker.
+ * - **The parser is the judge of where a marker may go.** The text is parsed
+ *   without the markers and again with them; a marker is kept only if everything
+ *   that is not a marker reads exactly as before. A position inside a code
+ *   block, an inline code span, a link target or anything else the parser reads
+ *   as something other than prose changes that reading, so it is dropped (the
+ *   source still belongs in `Sources`; it just has no badge there). No second
+ *   copy of the Markdown rules exists to drift from the real one.
+ * - **Text that already has footnote marks gets none.** `[^1]` typed by a model
+ *   would otherwise be indistinguishable from a marker placed here, and a
+ *   citation must never come from the text alone.
+ *
+ * The result's `text` is for display only. Copy the original.
+ */
+export type CitationPlacement = Readonly<{
+    /** Offset into the text after which the marker goes (the span's end). */
+    end: number;
+    /** 1-based positions in the host's source list. */
+    numbers: readonly number[];
+}>;
+export type PlacedCitations = Readonly<{
+    /** The text with markers, for `MessageText` with `citations`. */
+    text: string;
+    /** Distinct end positions that received a marker. */
+    placed: number;
+    /** Those positions, ascending: a span is represented exactly when its end is among them. */
+    ends: readonly number[];
+    /** Distinct end positions left without one, for any reason. */
+    skipped: number;
+    /** The text had footnote marks of its own, so nothing was placed. */
+    collision: boolean;
+}>;
+export declare function placeCitationMarkers(text: string, citations: readonly CitationPlacement[], count: number): PlacedCitations;
+//# sourceMappingURL=cite-ranges.d.ts.map

package/dist/components/ui/message/cite-ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cite-ranges.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/message/cite-ranges.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAA;IACX,mDAAmD;IACnD,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B,CAAC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAA;IACd,4FAA4F;IAC5F,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAA;CACnB,CAAC,CAAA;AA2CF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,iBAAiB,EAAE,EACvC,KAAK,EAAE,MAAM,GACZ,eAAe,CAsDjB"}

package/dist/components/ui/message/cite-ranges.js

@@ -0,0 +1,105 @@
+import { parseMessageText } from "./parse-message-text.js";
+//#region src/components/ui/message/cite-ranges.ts
+var FOOTNOTE = /\[\^\d/;
+var PER_MARKER = 6;
+function marker(numbers) {
+	const parts = [];
+	for (let index = 0; index < numbers.length; index += PER_MARKER) parts.push(`[^${numbers.slice(index, index + PER_MARKER).join(",")}]`);
+	return parts.join("");
+}
+function normalise(nodes) {
+	const out = [];
+	for (const node of nodes) {
+		if (node.kind === "cite") continue;
+		if (node.kind === "strong" || node.kind === "em" || node.kind === "link") {
+			out.push({
+				...node,
+				children: normalise(node.children)
+			});
+			continue;
+		}
+		const last = out.at(-1);
+		if (node.kind === "text" && last?.kind === "text") out[out.length - 1] = {
+			kind: "text",
+			text: `${last.text}${node.text}`
+		};
+		else out.push(node);
+	}
+	return out;
+}
+/** What the blocks say with the markers and every `raw` slice taken out. */
+function reading(blocks) {
+	return JSON.stringify(blocks.map((block) => {
+		const { raw: _raw, ...rest } = block;
+		if (block.kind === "list") return {
+			...rest,
+			items: block.items.map(normalise)
+		};
+		if (block.kind === "code") return rest;
+		return {
+			...rest,
+			inline: normalise(block.inline)
+		};
+	}));
+}
+function placeCitationMarkers(text, citations, count) {
+	const byEnd = /* @__PURE__ */ new Map();
+	for (const { end, numbers } of citations) {
+		if (!Number.isInteger(end) || end <= 0 || end > text.length) continue;
+		for (const number of numbers) {
+			if (!Number.isInteger(number) || number < 1 || number > count) continue;
+			const set = byEnd.get(end) ?? /* @__PURE__ */ new Set();
+			set.add(number);
+			byEnd.set(end, set);
+		}
+	}
+	const candidates = [...byEnd.entries()].toSorted(([left], [right]) => left - right).map(([end, numbers]) => ({
+		end,
+		marker: marker([...numbers].toSorted((a, b) => a - b))
+	}));
+	if (candidates.length === 0) return {
+		text,
+		placed: 0,
+		ends: [],
+		skipped: 0,
+		collision: false
+	};
+	if (FOOTNOTE.test(text)) return {
+		text,
+		placed: 0,
+		ends: [],
+		skipped: candidates.length,
+		collision: true
+	};
+	const insert = (chosen) => {
+		let out = "";
+		let cursor = 0;
+		for (const item of chosen) {
+			out += text.slice(cursor, item.end) + item.marker;
+			cursor = item.end;
+		}
+		return out + text.slice(cursor);
+	};
+	const baseline = reading(parseMessageText(text));
+	const holds = (chosen) => reading(parseMessageText(insert(chosen), { citations: count })) === baseline;
+	if (holds(candidates)) return {
+		text: insert(candidates),
+		placed: candidates.length,
+		ends: candidates.map((candidate) => candidate.end),
+		skipped: 0,
+		collision: false
+	};
+	const accepted = [];
+	for (const candidate of candidates) if (holds([...accepted, candidate])) accepted.push(candidate);
+	return {
+		text: insert(accepted),
+		placed: accepted.length,
+		ends: accepted.map((candidate) => candidate.end),
+		skipped: candidates.length - accepted.length,
+		collision: false
+	};
+}
+//#endregion
+export { placeCitationMarkers };
+
+//# sourceMappingURL=cite-ranges.js.map

package/dist/components/ui/message/cite-ranges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cite-ranges.js","names":[],"sources":["../../../../src/components/ui/message/cite-ranges.ts"],"sourcesContent":["import { parseMessageText, type MessageBlock, type MessageInline } from './parse-message-text'\n\n/**\n * Citations that arrive as positions in the text, placed as markers.\n *\n * A producer that cites a passage says *where*: a half-open span of the exact\n * text and the sources behind it. `MessageText` binds `[^n]` markers, so this\n * turns the one into the other without ever changing what the text says:\n *\n * - A marker goes at the **end** of the span, nowhere else, and only for numbers\n *   within `count`. Several spans ending at one place share one marker.\n * - **The parser is the judge of where a marker may go.** The text is parsed\n *   without the markers and again with them; a marker is kept only if everything\n *   that is not a marker reads exactly as before. A position inside a code\n *   block, an inline code span, a link target or anything else the parser reads\n *   as something other than prose changes that reading, so it is dropped (the\n *   source still belongs in `Sources`; it just has no badge there). No second\n *   copy of the Markdown rules exists to drift from the real one.\n * - **Text that already has footnote marks gets none.** `[^1]` typed by a model\n *   would otherwise be indistinguishable from a marker placed here, and a\n *   citation must never come from the text alone.\n *\n * The result's `text` is for display only. Copy the original.\n */\nexport type CitationPlacement = Readonly<{\n  /** Offset into the text after which the marker goes (the span's end). */\n  end: number\n  /** 1-based positions in the host's source list. */\n  numbers: readonly number[]\n}>\n\nexport type PlacedCitations = Readonly<{\n  /** The text with markers, for `MessageText` with `citations`. */\n  text: string\n  /** Distinct end positions that received a marker. */\n  placed: number\n  /** Those positions, ascending: a span is represented exactly when its end is among them. */\n  ends: readonly number[]\n  /** Distinct end positions left without one, for any reason. */\n  skipped: number\n  /** The text had footnote marks of its own, so nothing was placed. */\n  collision: boolean\n}>\n\nconst FOOTNOTE = /\\[\\^\\d/\nconst PER_MARKER = 6\n\nfunction marker(numbers: readonly number[]): string {\n  const parts: string[] = []\n  for (let index = 0; index < numbers.length; index += PER_MARKER) {\n    parts.push(`[^${numbers.slice(index, index + PER_MARKER).join(',')}]`)\n  }\n  return parts.join('')\n}\n\nfunction normalise(nodes: readonly MessageInline[]): unknown[] {\n  const out: unknown[] = []\n  for (const node of nodes) {\n    if (node.kind === 'cite') continue\n    if (node.kind === 'strong' || node.kind === 'em' || node.kind === 'link') {\n      out.push({ ...node, children: normalise(node.children) })\n      continue\n    }\n    const last = out.at(-1) as { kind?: string; text?: string } | undefined\n    if (node.kind === 'text' && last?.kind === 'text') {\n      out[out.length - 1] = { kind: 'text', text: `${last.text}${node.text}` }\n    } else {\n      out.push(node)\n    }\n  }\n  return out\n}\n\n/** What the blocks say with the markers and every `raw` slice taken out. */\nfunction reading(blocks: readonly MessageBlock[]): string {\n  return JSON.stringify(\n    blocks.map((block) => {\n      const { raw: _raw, ...rest } = block\n      if (block.kind === 'list') return { ...rest, items: block.items.map(normalise) }\n      if (block.kind === 'code') return rest\n      return { ...rest, inline: normalise(block.inline) }\n    })\n  )\n}\n\nexport function placeCitationMarkers(\n  text: string,\n  citations: readonly CitationPlacement[],\n  count: number\n): PlacedCitations {\n  const byEnd = new Map<number, Set<number>>()\n  for (const { end, numbers } of citations) {\n    if (!Number.isInteger(end) || end <= 0 || end > text.length) continue\n    for (const number of numbers) {\n      if (!Number.isInteger(number) || number < 1 || number > count) continue\n      const set = byEnd.get(end) ?? new Set<number>()\n      set.add(number)\n      byEnd.set(end, set)\n    }\n  }\n  const candidates = [...byEnd.entries()]\n    .toSorted(([left], [right]) => left - right)\n    .map(([end, numbers]) => ({ end, marker: marker([...numbers].toSorted((a, b) => a - b)) }))\n  if (candidates.length === 0) return { text, placed: 0, ends: [], skipped: 0, collision: false }\n  if (FOOTNOTE.test(text)) {\n    return { text, placed: 0, ends: [], skipped: candidates.length, collision: true }\n  }\n\n  const insert = (chosen: readonly { end: number; marker: string }[]): string => {\n    let out = ''\n    let cursor = 0\n    for (const item of chosen) {\n      out += text.slice(cursor, item.end) + item.marker\n      cursor = item.end\n    }\n    return out + text.slice(cursor)\n  }\n\n  const baseline = reading(parseMessageText(text))\n  const holds = (chosen: readonly { end: number; marker: string }[]) =>\n    reading(parseMessageText(insert(chosen), { citations: count })) === baseline\n\n  // Usual case: every position is prose, one check covers all of them.\n  if (holds(candidates)) {\n    return {\n      text: insert(candidates),\n      placed: candidates.length,\n      ends: candidates.map((candidate) => candidate.end),\n      skipped: 0,\n      collision: false,\n    }\n  }\n  const accepted: { end: number; marker: string }[] = []\n  for (const candidate of candidates) {\n    if (holds([...accepted, candidate])) accepted.push(candidate)\n  }\n  return {\n    text: insert(accepted),\n    placed: accepted.length,\n    ends: accepted.map((candidate) => candidate.end),\n    skipped: candidates.length - accepted.length,\n    collision: false,\n  }\n}\n"],"mappings":"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"}

package/dist/components/ui/message/index.d.ts

@@ -0,0 +1,4 @@
+export { Message, MessageActions, MessageContent, MessageFooter, MessageHeader, MessageText, type MessageCitations, type MessageCodeBlockInfo, type MessageCodeBlockProps, type MessageProps, type MessageRole, type MessageTextProps, } from './message';
+export { placeCitationMarkers, type CitationPlacement, type PlacedCitations } from './cite-ranges';
+export { parseInline, parseMessageText, safeHref, type MessageBlock, type MessageInline, type ParseInlineOptions, } from './parse-message-text';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/ui/message/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/message/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAClG,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAA"}

package/dist/components/ui/message/index.js

@@ -0,0 +1,4 @@
+import { parseInline, parseMessageText, safeHref } from "./parse-message-text.js";
+import { Message, MessageActions, MessageContent, MessageFooter, MessageHeader, MessageText } from "./message.js";
+import { placeCitationMarkers } from "./cite-ranges.js";
+export { Message, MessageActions, MessageContent, MessageFooter, MessageHeader, MessageText, parseInline, parseMessageText, placeCitationMarkers, safeHref };

package/dist/components/ui/message/message.d.ts

@@ -0,0 +1,95 @@
+import { type ComponentProps, type JSX } from 'solid-js';
+import { type CodeBlockProps } from '../code-block';
+/**
+ * Message.
+ *
+ * One turn. The two speakers are laid out differently on purpose, and that is
+ * the whole design:
+ *
+ * - **The person's turn is a bubble on the trailing edge** — short, bounded, and
+ *   easy to find when scrolling back through a long session.
+ * - **The assistant's turn is the page.** It has no surface, spans the reading
+ *   column, and holds everything the agent did *for that request* — activity
+ *   (a `Trace`), prose, code, a pending decision — in one place, so a turn
+ *   reads as an answer with its working underneath it rather than as a chain of
+ *   unrelated cards.
+ *
+ * `label` is the turn's accessible name ("You", "Assistant"): the avatar and
+ * name are not drawn for every turn, because a transcript that repeats a speaker
+ * on every line is one nobody reads, but the name must still be announced.
+ * `streaming` sets `aria-busy`, which tells assistive technology to wait for the
+ * turn to settle before reading it instead of announcing every token.
+ *
+ * `anchorId` is the stable identity `MessageScroller` uses to keep the reader's
+ * place when older turns are inserted above it.
+ */
+export type MessageRole = 'user' | 'assistant' | 'system';
+export type MessageProps = Omit<ComponentProps<'article'>, 'role'> & {
+    role: MessageRole;
+    /** The turn's accessible name. */
+    label: string;
+    streaming?: boolean;
+    anchorId?: string;
+};
+export declare function Message(props: MessageProps): JSX.Element;
+/** The speaker's mark and name, for the turns that draw one. */
+export declare function MessageHeader(props: ComponentProps<'header'> & {
+    avatar?: JSX.Element;
+    time?: JSX.Element;
+}): JSX.Element;
+/** The turn's parts, stacked. Gap is the rhythm between prose, activity and code. */
+export declare function MessageContent(props: ComponentProps<'div'>): JSX.Element;
+/**
+ * Actions that belong to the turn (copy, retry). Hidden until the turn is hovered
+ * or focused so the column is not a wall of buttons, but never `display: none`:
+ * a control that only exists under the pointer cannot be reached by keyboard,
+ * and on a touch screen there is no hover, so coarse pointers always see them.
+ */
+export declare function MessageActions(props: ComponentProps<'div'>): JSX.Element;
+export declare function MessageFooter(props: ComponentProps<'footer'>): JSX.Element;
+/** The props of a fenced block the host may set. */
+export type MessageCodeBlockProps = Pick<CodeBlockProps, 'loadHighlight' | 'maxHeight' | 'wrap' | 'showLineNumbers' | 'lineMarks' | 'lineLimit'>;
+/** What the host is told about a fenced block when it chooses that block's props. */
+export type MessageCodeBlockInfo = Readonly<{
+    /** Position among the text's fenced blocks, from 0. */
+    index: number;
+    language: string | undefined;
+    code: string;
+    complete: boolean;
+}>;
+/**
+ * How `MessageText` draws citation markers. `count` is how many sources the host
+ * has; a `[^n]` marker is a citation only when every `n` is within it. `render`
+ * receives the 1-based source numbers and draws the marker, so the host decides
+ * what a number means (`messageCitations` in the inline-citation composite does
+ * this for a `Source` list).
+ */
+export type MessageCitations = Readonly<{
+    count: number;
+    render: (numbers: readonly number[]) => JSX.Element;
+}>;
+export type MessageTextProps = Omit<ComponentProps<'div'>, 'children'> & {
+    text: string;
+    /** True while text may still arrive: a trailing open fence renders as partial code. */
+    streaming?: boolean;
+    /**
+     * Forwarded to each fenced block, e.g. to supply a lazy highlighter. A function
+     * chooses per block, which is how line marks reach a block: marks belong to the
+     * host's knowledge of the code (a diff, a failing line), never to the text.
+     */
+    codeBlockProps?: MessageCodeBlockProps | ((block: MessageCodeBlockInfo) => MessageCodeBlockProps);
+    /** Without it, `[^1]` stays the literal text it was written as. */
+    citations?: MessageCitations;
+};
+/**
+ * Text, read safely.
+ *
+ * Renders `parseMessageText`'s blocks as elements: nothing is interpreted as
+ * HTML and a link only becomes an anchor when its scheme is http, https or
+ * mailto. Blocks are kept by *position* and reuse their previous parsed object
+ * when unchanged, so a streaming turn updates the block that is growing and
+ * leaves every earlier paragraph and code block — and any selection or focus
+ * inside them — untouched.
+ */
+export declare function MessageText(props: MessageTextProps): JSX.Element;
+//# sourceMappingURL=message.d.ts.map

package/dist/components/ui/message/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/message/message.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,cAAc,EACnB,KAAK,GAAG,EACT,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAG1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEzD,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,GAAG;IACnE,IAAI,EAAE,WAAW,CAAA;IACjB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,eAgC1C;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;CAAE,eAgB/E;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,eAc1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,eAc1D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,eAW5D;AAED,oDAAoD;AACpD,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,cAAc,EACd,eAAe,GAAG,WAAW,GAAG,MAAM,GAAG,iBAAiB,GAAG,WAAW,GAAG,WAAW,CACvF,CAAA;AAED,qFAAqF;AACrF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,GAAG,CAAC,OAAO,CAAA;CACpD,CAAC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IACvE,IAAI,EAAE,MAAM,CAAA;IACZ,uFAAuF;IACvF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,qBAAqB,GAAG,CAAC,CAAC,KAAK,EAAE,oBAAoB,KAAK,qBAAqB,CAAC,CAAA;IACjG,mEAAmE;IACnE,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAC7B,CAAA;AAWD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,eAsDlD"}