@efolusi/meridian 1.5.0

package/ai/RichComposer.js

@@ -0,0 +1,247 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import React from 'react';
+import { injectEfCss } from "../forms/Button.js";
+import { Icon } from "../icons/Icon.js";
+const CSS = `
+.ef-richcomposer{position:relative;border:1px solid var(--border-strong);border-radius:var(--radius-lg,14px);background:var(--surface-card);transition:border-color var(--dur-fast) var(--ease-out),box-shadow var(--dur-fast) var(--ease-out)}
+.ef-richcomposer:focus-within{border-color:var(--text-muted);box-shadow:var(--focus-ring)}
+.ef-richcomposer__input{min-height:44px;max-height:200px;overflow-y:auto;padding:12px 14px 4px;font-family:var(--font-sans);font-size:14px;line-height:1.6;color:var(--text-primary);outline:none;white-space:pre-wrap;word-break:break-word}
+.ef-richcomposer__input:empty::before{content:attr(data-placeholder);color:var(--text-muted);pointer-events:none}
+.ef-richcomposer__chip{display:inline-flex;align-items:center;gap:4px;margin:0 1px;padding:1px 7px;border-radius:var(--radius-sm);background:var(--accent-subtle);border:1px solid var(--accent-subtle-border);color:var(--text-primary);font-size:13px;white-space:nowrap;user-select:none}
+.ef-richcomposer__bar{display:flex;align-items:center;gap:8px;padding:8px 10px 10px}
+.ef-richcomposer__hint{font-size:12px;color:var(--text-muted)}
+.ef-richcomposer__send{margin-left:auto;display:inline-flex;align-items:center;justify-content:center;width:32px;height:32px;border:none;border-radius:var(--radius-full);background:var(--accent);color:var(--accent-contrast);cursor:pointer;transition:background var(--dur-fast) var(--ease-out),opacity var(--dur-fast) var(--ease-out)}
+.ef-richcomposer__send:hover{background:var(--accent-hover)}
+.ef-richcomposer__send:disabled{opacity:.35;cursor:default}
+.ef-richcomposer__send:focus-visible{outline:none;box-shadow:var(--focus-ring)}
+.ef-richcomposer__pop{position:absolute;bottom:calc(100% + 6px);left:0;right:0;z-index:40;max-height:260px;overflow-y:auto;padding:4px;border:1px solid var(--border-default);border-radius:var(--radius-md);background:var(--surface-card);box-shadow:var(--shadow-lg,0 8px 24px rgba(0,0,0,.12))}
+.ef-richcomposer__group{padding:7px 10px 3px;font-size:11px;font-weight:var(--weight-semibold);letter-spacing:.04em;text-transform:uppercase;color:var(--text-muted)}
+.ef-richcomposer__item{display:flex;align-items:center;gap:9px;width:100%;padding:7px 10px;border:none;background:none;cursor:pointer;text-align:left;border-radius:var(--radius-sm);font-family:var(--font-sans);font-size:13.5px;color:var(--text-primary)}
+.ef-richcomposer__item--hi{background:var(--surface-sunken)}
+.ef-richcomposer__itemicon{display:inline-flex;flex:none;color:var(--text-muted)}
+.ef-richcomposer__itemdesc{margin-left:auto;font-size:12px;color:var(--text-muted);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.ef-richcomposer__empty{padding:8px 10px;font-size:13px;color:var(--text-muted)}
+`;
+function findTrigger(root) {
+  const s = window.getSelection();
+  if (!s || !s.rangeCount || !s.isCollapsed) return null;
+  const node = s.anchorNode;
+  if (!node || node.nodeType !== 3 || !root.contains(node)) return null;
+  const before = node.textContent.slice(0, s.anchorOffset);
+  const m = before.match(/(^|\s)([@\/])([\w./-]*)$/);
+  if (!m) return null;
+  return {
+    node,
+    offset: s.anchorOffset,
+    char: m[2],
+    query: m[3]
+  };
+}
+export function RichComposer({
+  placeholder = 'Message… use @ to mention, / for commands',
+  mentions = [],
+  commands = [],
+  hint,
+  actions,
+  disabled,
+  autoFocus,
+  onSubmit,
+  onCommand,
+  style,
+  className,
+  ...rest
+}) {
+  injectEfCss('ef-css-richcomposer', CSS);
+  const edRef = React.useRef(null);
+  const [pop, setPop] = React.useState(null);
+  const [empty, setEmpty] = React.useState(true);
+  const items = React.useMemo(() => {
+    if (!pop) return [];
+    const src = pop.char === '@' ? mentions : commands;
+    const q = pop.query.toLowerCase();
+    return src.filter(it => !q || it.label.toLowerCase().includes(q) || (it.keywords || []).some(k => k.toLowerCase().includes(q)));
+  }, [pop, mentions, commands]);
+  const refresh = () => {
+    const ed = edRef.current;
+    if (!ed) return;
+    setEmpty(ed.textContent.trim().length === 0 && !ed.querySelector('[data-chip-id]'));
+    const t = findTrigger(ed);
+    setPop(t ? {
+      char: t.char,
+      query: t.query,
+      hi: 0
+    } : null);
+  };
+  const removeTrigger = () => {
+    const ed = edRef.current;
+    const t = findTrigger(ed);
+    if (!t) return null;
+    const range = document.createRange();
+    range.setStart(t.node, t.offset - t.query.length - 1);
+    range.setEnd(t.node, t.offset);
+    range.deleteContents();
+    return range;
+  };
+  const pick = it => {
+    const ed = edRef.current;
+    if (!ed || !pop) return;
+    const range = removeTrigger();
+    if (pop.char === '/') {
+      setPop(null);
+      refresh();
+      if (onCommand) onCommand(it);
+      return;
+    }
+    if (!range) return;
+    const chip = document.createElement('span');
+    chip.className = 'ef-richcomposer__chip';
+    chip.contentEditable = 'false';
+    chip.setAttribute('data-chip-id', it.id);
+    chip.textContent = '@' + it.label;
+    range.insertNode(chip);
+    const space = document.createTextNode('\u00A0');
+    chip.after(space);
+    const sel = window.getSelection();
+    const r = document.createRange();
+    r.setStartAfter(space);
+    r.collapse(true);
+    sel.removeAllRanges();
+    sel.addRange(r);
+    setPop(null);
+    refresh();
+  };
+  const serialize = () => {
+    const ed = edRef.current;
+    const found = [];
+    let text = '';
+    const walk = n => {
+      n.childNodes.forEach(c => {
+        if (c.nodeType === 3) text += c.textContent;else if (c.getAttribute && c.getAttribute('data-chip-id')) {
+          found.push({
+            id: c.getAttribute('data-chip-id'),
+            label: c.textContent.replace(/^@/, '')
+          });
+          text += c.textContent;
+        } else if (c.nodeName === 'BR') text += '\n';else {
+          if (text && (c.nodeName === 'DIV' || c.nodeName === 'P')) text += '\n';
+          walk(c);
+        }
+      });
+    };
+    walk(ed);
+    return {
+      text: text.replace(/\u00A0/g, ' ').trim(),
+      mentions: found
+    };
+  };
+  const submit = () => {
+    const v = serialize();
+    if (!v.text) return;
+    if (onSubmit) onSubmit(v);
+    edRef.current.innerHTML = '';
+    setEmpty(true);
+    setPop(null);
+    edRef.current.focus();
+  };
+  const onKey = e => {
+    if (pop && items.length) {
+      if (e.key === 'ArrowDown') {
+        e.preventDefault();
+        setPop(p => ({
+          ...p,
+          hi: Math.min(items.length - 1, p.hi + 1)
+        }));
+        return;
+      }
+      if (e.key === 'ArrowUp') {
+        e.preventDefault();
+        setPop(p => ({
+          ...p,
+          hi: Math.max(0, p.hi - 1)
+        }));
+        return;
+      }
+      if (e.key === 'Enter' || e.key === 'Tab') {
+        e.preventDefault();
+        pick(items[pop.hi]);
+        return;
+      }
+      if (e.key === 'Escape') {
+        e.preventDefault();
+        setPop(null);
+        return;
+      }
+    }
+    if (e.key === 'Enter' && !e.shiftKey && !e.nativeEvent.isComposing) {
+      e.preventDefault();
+      submit();
+    }
+  };
+  React.useEffect(() => {
+    if (autoFocus && edRef.current) edRef.current.focus();
+  }, [autoFocus]);
+  let lastGroup = null;
+  return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    className: `ef-richcomposer${className ? ' ' + className : ''}`,
+    style: style
+  }), pop ? /*#__PURE__*/React.createElement("div", {
+    className: "ef-richcomposer__pop",
+    role: "listbox"
+  }, !items.length ? /*#__PURE__*/React.createElement("div", {
+    className: "ef-richcomposer__empty"
+  }, "No matches for ", pop.char, pop.query) : null, items.map((it, i) => {
+    const head = it.group && it.group !== lastGroup ? /*#__PURE__*/React.createElement("div", {
+      key: 'g' + it.group,
+      className: "ef-richcomposer__group"
+    }, it.group) : null;
+    lastGroup = it.group;
+    return /*#__PURE__*/React.createElement(React.Fragment, {
+      key: it.id
+    }, head, /*#__PURE__*/React.createElement("button", {
+      type: "button",
+      role: "option",
+      "aria-selected": i === pop.hi,
+      className: `ef-richcomposer__item${i === pop.hi ? ' ef-richcomposer__item--hi' : ''}`,
+      onMouseEnter: () => setPop(p => ({
+        ...p,
+        hi: i
+      })),
+      onMouseDown: e => e.preventDefault(),
+      onClick: () => pick(it)
+    }, it.icon ? /*#__PURE__*/React.createElement("span", {
+      className: "ef-richcomposer__itemicon"
+    }, /*#__PURE__*/React.createElement(Icon, {
+      name: it.icon,
+      size: 14
+    })) : null, /*#__PURE__*/React.createElement("span", null, pop.char === '/' ? '/' + it.label : it.label), it.description ? /*#__PURE__*/React.createElement("span", {
+      className: "ef-richcomposer__itemdesc"
+    }, it.description) : null));
+  })) : null, /*#__PURE__*/React.createElement("div", {
+    ref: edRef,
+    className: "ef-richcomposer__input",
+    contentEditable: !disabled,
+    suppressContentEditableWarning: true,
+    "data-placeholder": placeholder,
+    role: "textbox",
+    "aria-multiline": "true",
+    spellCheck: false,
+    onInput: refresh,
+    onKeyUp: refresh,
+    onClick: refresh,
+    onKeyDown: onKey,
+    onBlur: () => setTimeout(() => setPop(null), 120)
+  }), /*#__PURE__*/React.createElement("div", {
+    className: "ef-richcomposer__bar"
+  }, actions, hint ? /*#__PURE__*/React.createElement("span", {
+    className: "ef-richcomposer__hint"
+  }, hint) : null, /*#__PURE__*/React.createElement("button", {
+    type: "button",
+    className: "ef-richcomposer__send",
+    "aria-label": "Send",
+    disabled: empty || disabled,
+    onClick: submit
+  }, /*#__PURE__*/React.createElement(Icon, {
+    name: "send",
+    size: 14
+  }))));
+}

package/ai/Sandbox.d.ts

@@ -0,0 +1,20 @@
+export interface SandboxTab {
+  id: string;
+  label: string;
+  icon?: string;
+  content: React.ReactNode;
+}
+export interface SandboxProps {
+  /** Command or filename, mono */
+  title: React.ReactNode;
+  /** 'running' | 'success' | 'error' */
+  state?: 'running' | 'success' | 'error';
+  /** Right-side meta, e.g. duration */
+  meta?: React.ReactNode;
+  tabs: SandboxTab[];
+  defaultOpen?: boolean;
+  defaultTab?: string;
+  style?: React.CSSProperties;
+  className?: string;
+}
+export declare function Sandbox(props: SandboxProps): React.JSX.Element;

package/ai/Sandbox.js

@@ -0,0 +1,96 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import React from 'react';
+import { injectEfCss } from "../forms/Button.js";
+import { Icon } from "../icons/Icon.js";
+const CSS = `
+.ef-sandbox{border:1px solid var(--border-default);border-radius:var(--radius-md);background:var(--surface-card);overflow:hidden;font-family:var(--font-sans);transition:border-color var(--dur-fast) var(--ease-out),box-shadow var(--dur-fast) var(--ease-out)}
+.ef-sandbox--running{border-color:var(--accent-subtle-border);box-shadow:0 0 0 3px var(--accent-subtle)}
+.ef-sandbox--error{border-color:var(--danger-300);box-shadow:0 0 0 3px var(--danger-100)}
+.ef-sandbox__head{display:flex;align-items:center;gap:9px;width:100%;padding:10px 14px;border:none;background:none;cursor:pointer;text-align:left;font-family:inherit}
+.ef-sandbox__head:focus-visible{outline:none;box-shadow:var(--focus-ring)}
+.ef-sandbox__chev{display:inline-flex;color:var(--text-muted);transition:transform var(--dur-med) var(--ease-out)}
+.ef-sandbox--open .ef-sandbox__chev{transform:rotate(90deg)}
+.ef-sandbox__title{flex:1;min-width:0;font-family:var(--font-mono);font-size:12.5px;color:var(--text-primary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.ef-sandbox--error .ef-sandbox__title{color:var(--danger-600)}
+.ef-sandbox__meta{font-size:12px;color:var(--text-muted);display:inline-flex;align-items:center;gap:6px}
+.ef-sandbox__spin{display:inline-flex;color:var(--text-secondary);animation:ef-sandbox-spin 1s linear infinite}
+@keyframes ef-sandbox-spin{to{transform:rotate(360deg)}}
+.ef-sandbox__body{display:grid;grid-template-rows:0fr;transition:grid-template-rows var(--dur-med) var(--ease-out)}
+.ef-sandbox--open .ef-sandbox__body{grid-template-rows:1fr}
+.ef-sandbox__clip{overflow:hidden;min-height:0}
+.ef-sandbox__inner{border-top:1px solid var(--border-default)}
+.ef-sandbox__tabs{display:flex;gap:18px;padding:0 14px;border-bottom:1px solid var(--border-default)}
+.ef-sandbox__tab{display:inline-flex;align-items:center;gap:6px;height:36px;border:none;background:none;cursor:pointer;font-family:var(--font-sans);font-size:12.5px;font-weight:var(--weight-semibold);color:var(--text-muted);border-bottom:2px solid transparent;margin-bottom:-1px;transition:color var(--dur-fast) var(--ease-out),border-color var(--dur-fast) var(--ease-out)}
+.ef-sandbox__tab:hover{color:var(--text-primary)}
+.ef-sandbox__tab--on{color:var(--text-primary);border-bottom-color:var(--accent)}
+.ef-sandbox__tab:focus-visible{outline:none;box-shadow:var(--focus-ring)}
+.ef-sandbox__panel{padding:12px 14px;font-family:var(--font-mono);font-size:12.5px;line-height:1.7;color:var(--text-secondary);overflow-x:auto}
+.ef-sandbox__panel pre{margin:0;white-space:pre-wrap;word-break:break-word}
+`;
+const STATES = {
+  running: 'Running',
+  success: 'Done',
+  error: 'Failed'
+};
+export function Sandbox({
+  title,
+  state = 'success',
+  meta,
+  tabs = [],
+  defaultOpen,
+  defaultTab,
+  style,
+  className,
+  ...rest
+}) {
+  injectEfCss('ef-css-sandbox', CSS);
+  const [open, setOpen] = React.useState(defaultOpen !== undefined ? !!defaultOpen : state === 'error');
+  const [tab, setTab] = React.useState(defaultTab || tabs[0] && tabs[0].id);
+  const active = tabs.find(t => t.id === tab) || tabs[0];
+  return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    className: `ef-sandbox ef-sandbox--${state}${open ? ' ef-sandbox--open' : ''}${className ? ' ' + className : ''}`,
+    style: style,
+    "data-state": state
+  }), /*#__PURE__*/React.createElement("button", {
+    type: "button",
+    className: "ef-sandbox__head",
+    "aria-expanded": open,
+    onClick: () => setOpen(!open)
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "ef-sandbox__chev"
+  }, /*#__PURE__*/React.createElement(Icon, {
+    name: "chevron-right",
+    size: 14
+  })), /*#__PURE__*/React.createElement("span", {
+    className: "ef-sandbox__title"
+  }, title), /*#__PURE__*/React.createElement("span", {
+    className: "ef-sandbox__meta"
+  }, state === 'running' ? /*#__PURE__*/React.createElement("span", {
+    className: "ef-sandbox__spin"
+  }, /*#__PURE__*/React.createElement(Icon, {
+    name: "loader-circle",
+    size: 13
+  })) : null, meta || STATES[state])), /*#__PURE__*/React.createElement("div", {
+    className: "ef-sandbox__body"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "ef-sandbox__clip"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "ef-sandbox__inner"
+  }, tabs.length > 1 ? /*#__PURE__*/React.createElement("div", {
+    className: "ef-sandbox__tabs",
+    role: "tablist"
+  }, tabs.map(t => /*#__PURE__*/React.createElement("button", {
+    key: t.id,
+    type: "button",
+    role: "tab",
+    "aria-selected": t.id === (active && active.id),
+    className: `ef-sandbox__tab${t.id === (active && active.id) ? ' ef-sandbox__tab--on' : ''}`,
+    onClick: () => setTab(t.id)
+  }, t.icon ? /*#__PURE__*/React.createElement(Icon, {
+    name: t.icon,
+    size: 13
+  }) : null, t.label))) : null, /*#__PURE__*/React.createElement("div", {
+    className: "ef-sandbox__panel",
+    role: "tabpanel"
+  }, active ? active.content : null)))));
+}

package/ai/SelectionQuote.d.ts

@@ -0,0 +1,15 @@
+export interface SelectionAction {
+  id: string;
+  label: string;
+  icon?: string;
+}
+export interface SelectionQuoteProps {
+  /** The selectable content */
+  children: React.ReactNode;
+  /** Toolbar buttons. Default: one "Quote" action */
+  actions?: SelectionAction[];
+  onAction?: (id: string, text: string) => void;
+  style?: React.CSSProperties;
+  className?: string;
+}
+export declare function SelectionQuote(props: SelectionQuoteProps): React.JSX.Element;

package/ai/SelectionQuote.js

@@ -0,0 +1,123 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import React from 'react';
+import { injectEfCss } from "../forms/Button.js";
+import { Icon } from "../icons/Icon.js";
+const CSS = `
+.ef-selq{position:relative}
+.ef-selq__bar{position:absolute;z-index:30;display:inline-flex;align-items:center;gap:2px;padding:4px;border:1px solid var(--border-default);border-radius:var(--radius-md);background:var(--surface-card);box-shadow:var(--shadow-lg,0 8px 24px rgba(0,0,0,.12));user-select:none}
+.ef-selq__btn{display:inline-flex;align-items:center;gap:6px;padding:5px 10px;border:none;background:none;cursor:pointer;border-radius:var(--radius-sm);font-family:var(--font-sans);font-size:12.5px;font-weight:var(--weight-semibold);color:var(--text-secondary);transition:color var(--dur-fast) var(--ease-out),background var(--dur-fast) var(--ease-out)}
+.ef-selq__btn:hover{color:var(--text-primary);background:var(--surface-subtle)}
+.ef-selq__btn:focus-visible{outline:none;box-shadow:var(--focus-ring)}
+.ef-selq__sep{width:1px;height:16px;background:var(--border-default);margin:0 3px}
+`;
+export function SelectionQuote({
+  children,
+  actions = [{
+    id: 'quote',
+    label: 'Quote',
+    icon: 'corner-up-left'
+  }],
+  onAction,
+  style,
+  className,
+  ...rest
+}) {
+  injectEfCss('ef-css-selq', CSS);
+  const contRef = React.useRef(null);
+  const barRef = React.useRef(null);
+  const [sel, setSel] = React.useState(null);
+  const [pos, setPos] = React.useState(null);
+  const read = () => {
+    const s = window.getSelection();
+    const cont = contRef.current;
+    if (!s || s.isCollapsed || !s.rangeCount || !cont) return null;
+    const r = s.getRangeAt(0);
+    if (!cont.contains(r.startContainer) || !cont.contains(r.endContainer)) return null;
+    const rects = r.getClientRects();
+    if (!rects.length) return null;
+    const text = s.toString();
+    if (!text.trim()) return null;
+    return {
+      text,
+      rect: rects[0]
+    };
+  };
+  React.useEffect(() => {
+    const up = e => {
+      if (barRef.current && barRef.current.contains(e.target)) return;
+      requestAnimationFrame(() => {
+        const r = read();
+        if (r) setSel(r);
+      });
+    };
+    const change = () => {
+      const s = window.getSelection();
+      if (!s || s.isCollapsed) {
+        setSel(null);
+        setPos(null);
+      }
+    };
+    const key = e => {
+      if (e.key === 'Escape') {
+        setSel(null);
+        setPos(null);
+      }
+    };
+    document.addEventListener('pointerup', up);
+    document.addEventListener('selectionchange', change);
+    document.addEventListener('keydown', key);
+    return () => {
+      document.removeEventListener('pointerup', up);
+      document.removeEventListener('selectionchange', change);
+      document.removeEventListener('keydown', key);
+    };
+  }, []);
+  React.useLayoutEffect(() => {
+    if (!sel || !barRef.current || !contRef.current) return;
+    const bar = barRef.current.getBoundingClientRect();
+    const cont = contRef.current.getBoundingClientRect();
+    let top = sel.rect.top - cont.top - bar.height - 8;
+    if (top < 4) top = sel.rect.bottom - cont.top + 8;
+    let left = sel.rect.left - cont.left;
+    left = Math.max(4, Math.min(left, cont.width - bar.width - 4));
+    setPos({
+      top,
+      left
+    });
+  }, [sel]);
+  return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    ref: contRef,
+    className: `ef-selq${className ? ' ' + className : ''}`,
+    style: style
+  }), children, sel ? /*#__PURE__*/React.createElement("div", {
+    ref: barRef,
+    className: "ef-selq__bar",
+    role: "toolbar",
+    style: pos ? {
+      top: pos.top,
+      left: pos.left
+    } : {
+      top: 0,
+      left: 0,
+      visibility: 'hidden'
+    },
+    onMouseDown: e => e.preventDefault()
+  }, actions.map((a, i) => /*#__PURE__*/React.createElement(React.Fragment, {
+    key: a.id || i
+  }, i > 0 ? /*#__PURE__*/React.createElement("span", {
+    className: "ef-selq__sep",
+    "aria-hidden": "true"
+  }) : null, /*#__PURE__*/React.createElement("button", {
+    type: "button",
+    className: "ef-selq__btn",
+    onClick: () => {
+      if (onAction) onAction(a.id, sel.text);
+      window.getSelection().removeAllRanges();
+      setSel(null);
+      setPos(null);
+    }
+  }, a.icon ? /*#__PURE__*/React.createElement(Icon, {
+    name: a.icon,
+    size: 13
+  }) : null, a.label)))) : null);
+}

package/ai/SourceCard.d.ts

@@ -0,0 +1,17 @@
+export interface SourceCardProps {
+  href?: string;
+  title: React.ReactNode;
+  description?: React.ReactNode;
+  /** e.g. 'stripe.com' */
+  domain?: string;
+  /** Favicon URL; falls back to icon */
+  favicon?: string;
+  icon?: string;
+  thumbnail?: string;
+  /** 'card' | 'plain' */
+  variant?: 'card' | 'plain';
+  onClick?: (e: React.MouseEvent) => void;
+  style?: React.CSSProperties;
+  className?: string;
+}
+export declare function SourceCard(props: SourceCardProps): React.JSX.Element;

package/ai/SourceCard.js

@@ -0,0 +1,57 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import React from 'react';
+import { injectEfCss } from "../forms/Button.js";
+import { Icon } from "../icons/Icon.js";
+const CSS = `
+.ef-sourcecard{display:flex;flex-direction:column;gap:6px;padding:12px;border:1px solid var(--border-default);border-radius:var(--radius-md);background:var(--surface-card);text-decoration:none;color:inherit;transition:border-color var(--dur-fast) var(--ease-out),background var(--dur-fast) var(--ease-out)}
+a.ef-sourcecard{cursor:pointer}
+a.ef-sourcecard:hover{border-color:var(--border-strong);background:var(--surface-subtle)}
+a.ef-sourcecard:focus-visible{outline:none;box-shadow:var(--focus-ring)}
+.ef-sourcecard--plain{border-color:transparent;background:transparent;padding:8px 10px}
+.ef-sourcecard__thumb{width:100%;aspect-ratio:16/9;border-radius:var(--radius-sm);object-fit:cover;background:var(--surface-sunken);margin-bottom:4px}
+.ef-sourcecard__domain{display:inline-flex;align-items:center;gap:6px;font-size:11.5px;color:var(--text-muted)}
+.ef-sourcecard__domain img{width:14px;height:14px;border-radius:var(--radius-full)}
+.ef-sourcecard__title{font-size:13.5px;font-weight:var(--weight-semibold);color:var(--text-primary);line-height:1.4}
+.ef-sourcecard__desc{font-size:12.5px;color:var(--text-muted);line-height:1.55;display:-webkit-box;-webkit-line-clamp:3;-webkit-box-orient:vertical;overflow:hidden}
+`;
+export function SourceCard({
+  href,
+  title,
+  description,
+  domain,
+  favicon,
+  icon = 'globe',
+  thumbnail,
+  variant = 'card',
+  onClick,
+  style,
+  className,
+  ...rest
+}) {
+  injectEfCss('ef-css-sourcecard', CSS);
+  const Tag = href || onClick ? 'a' : 'div';
+  return /*#__PURE__*/React.createElement(Tag, _extends({}, rest, {
+    className: `ef-sourcecard${variant === 'plain' ? ' ef-sourcecard--plain' : ''}${className ? ' ' + className : ''}`,
+    style: style,
+    href: href,
+    target: href ? '_blank' : undefined,
+    rel: href ? 'noreferrer noopener' : undefined,
+    onClick: onClick
+  }), thumbnail ? /*#__PURE__*/React.createElement("img", {
+    className: "ef-sourcecard__thumb",
+    src: thumbnail,
+    alt: ""
+  }) : null, domain ? /*#__PURE__*/React.createElement("span", {
+    className: "ef-sourcecard__domain"
+  }, favicon ? /*#__PURE__*/React.createElement("img", {
+    src: favicon,
+    alt: ""
+  }) : /*#__PURE__*/React.createElement(Icon, {
+    name: icon,
+    size: 13
+  }), domain) : null, /*#__PURE__*/React.createElement("span", {
+    className: "ef-sourcecard__title"
+  }, title), description ? /*#__PURE__*/React.createElement("span", {
+    className: "ef-sourcecard__desc"
+  }, description) : null);
+}

package/ai/Suggestions.d.ts

@@ -0,0 +1,10 @@
+export interface SuggestionItem { label: string; /** Lucide icon */ icon?: string; }
+export interface SuggestionsProps {
+  /** Strings or { label, icon } */
+  items: Array<string | SuggestionItem>;
+  /** Fires with the picked label */
+  onPick?: (label: string, index: number) => void;
+  style?: React.CSSProperties;
+  className?: string;
+}
+export declare function Suggestions(props: SuggestionsProps): React.JSX.Element;

package/ai/Suggestions.js

@@ -0,0 +1,38 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import React from 'react';
+import { injectEfCss } from "../forms/Button.js";
+import { Icon } from "../icons/Icon.js";
+const CSS = `
+.ef-suggestions{display:flex;flex-wrap:wrap;gap:8px}
+.ef-suggestion{display:inline-flex;align-items:center;gap:7px;padding:7px 13px;border:1px solid var(--border-strong);border-radius:var(--radius-full);background:var(--surface-card);cursor:pointer;font-family:var(--font-sans);font-size:13.5px;color:var(--text-secondary);transition:color var(--dur-fast) var(--ease-out),border-color var(--dur-fast) var(--ease-out),background var(--dur-fast) var(--ease-out)}
+.ef-suggestion:hover{color:var(--text-primary);border-color:var(--text-muted);background:var(--surface-subtle)}
+.ef-suggestion:focus-visible{outline:none;box-shadow:var(--focus-ring)}
+.ef-suggestion__icon{display:inline-flex;color:var(--text-muted)}
+`;
+export function Suggestions({
+  items = [],
+  onPick,
+  style,
+  className,
+  ...rest
+}) {
+  injectEfCss('ef-css-suggestions', CSS);
+  return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    className: `ef-suggestions${className ? ' ' + className : ''}`,
+    style: style
+  }), items.map((it, i) => {
+    const label = typeof it === 'string' ? it : it.label;
+    const icon = typeof it === 'string' ? null : it.icon;
+    return /*#__PURE__*/React.createElement("button", {
+      key: i,
+      type: "button",
+      className: "ef-suggestion",
+      onClick: () => onPick && onPick(label, i)
+    }, icon ? /*#__PURE__*/React.createElement("span", {
+      className: "ef-suggestion__icon"
+    }, /*#__PURE__*/React.createElement(Icon, {
+      name: icon,
+      size: 14
+    })) : null, label);
+  }));
+}

package/ai/Task.d.ts

@@ -0,0 +1,15 @@
+export interface TaskItem {
+  /** Lucide icon name; omit for a dot */
+  icon?: string;
+  label: React.ReactNode;
+  /** Muted inline detail after the label */
+  detail?: React.ReactNode;
+}
+export interface TaskProps {
+  items: TaskItem[];
+  /** Pulses the last row while the agent works */
+  streaming?: boolean;
+  style?: React.CSSProperties;
+  className?: string;
+}
+export declare function Task(props: TaskProps): React.JSX.Element;