@qilin-agent/client-ui-primitives 3.1.7 → 3.1.9

package/lib/types/index.d.ts

@@ -13,6 +13,10 @@ export { StateDot } from './StateDot.tsx';
 export type { StateDotState } from './StateDot.tsx';
 export { DisclosureRow } from './DisclosureRow.tsx';
 export type { DisclosureRowProps } from './DisclosureRow.tsx';
+export { AnimatedRows } from './AnimatedRows.tsx';
+export type { AnimatedRowsProps } from './AnimatedRows.tsx';
+export { prefersReducedMotion } from './motion.ts';
+export { useRowDragPreview } from './useRowDragPreview.ts';
 export { Button } from './Button.tsx';
 export type { ButtonVariant } from './Button.tsx';
 export { Pill } from './Pill.tsx';
@@ -53,7 +57,11 @@ export type { LinkIconKind, LinkIconProps } from './LinkIcon.tsx';
 export { FileTypeIcon, classifyFileType, fileExtension } from './FileTypeIcon.tsx';
 export type { CodeFileType, FileType, FileTypeIconProps, FileTypeKind, FileTypeProjectContext, } from './FileTypeIcon.tsx';
 export { PathLabel } from './PathLabel.tsx';
-export { projectUserText, type UserTextReferences, type UserTextSecretLabels } from './user-text.tsx';
+export { projectUserText, type UserTextQuotes, type UserTextReferences, type UserTextSecretLabels, } from './user-text.tsx';
+export { QuotePreview } from './QuotePreview.tsx';
+export type { QuotePreviewLabels, QuotePreviewProps } from './QuotePreview.tsx';
+export { QUOTE_WIRE_SCHEME, messageQuoteRanges, quoteBlockTextOf, quoteInsertionOf, quoteTextOf, quotedExcerptOf, } from './quote-text.ts';
+export type { MessageQuoteRange, QuoteFragment, QuotedExcerpt } from './quote-text.ts';
 export { Tooltip } from './Tooltip.tsx';
 export type { TooltipSide } from './Tooltip.tsx';
 export { pointerModality } from './input-modality.ts';
@@ -63,8 +71,10 @@ export { closeTopModal, isBehindModal, modalSelector, useModalLayer } from './us
 export { Toast } from './Toast.tsx';
 export { fileSizeText, fileSizeRoundedText } from './file-size.ts';
 export { writeClipboard } from './clipboard.ts';
-export { useCopyFeedback } from './use-copy-feedback.ts';
-export type { CopyFeedback } from './use-copy-feedback.ts';
+export { useClipboardCopy } from './use-clipboard-copy.ts';
+export type { ClipboardCopyState } from './use-clipboard-copy.ts';
+export { UserMessageBubble } from './UserMessageBubble.tsx';
+export type { UserMessageBubbleProps } from './UserMessageBubble.tsx';
 export { relativeTime } from './relative-time.ts';
 export { rankByName } from './rank-by-name.ts';
 export { isDarwinDesktop, watchDarwinDesktop } from './darwin-desktop.ts';
@@ -81,6 +91,8 @@ export { SearchBlock, DEFAULT_SEARCH_MAX_LINES } from './SearchBlock.tsx';
 export type { SearchBlockProps, SearchMatchesBlockProps, SearchPathsBlockProps, SearchFileGroup, SearchBlockLineMatch, SearchBlockLabels, } from './SearchBlock.tsx';
 export { WebBlock } from './WebBlock.tsx';
 export type { WebBlockProps, WebSearchBlockProps, WebFetchBlockProps, WebSourceView, WebBlockLabels, } from './WebBlock.tsx';
+export { DetailDocument, detailDocumentState, useDetailDocumentLabels } from './DetailDocument.tsx';
+export type { DetailDocumentCopy, DetailDocumentLabels, DetailDocumentRead, DetailDocumentState, } from './DetailDocument.tsx';
 export { CodeBlock } from './markdown/CodeBlock.tsx';
 export type { CodeBlockProps } from './markdown/CodeBlock.tsx';
 export { JsonBlock } from './markdown/JsonBlock.tsx';
@@ -90,9 +102,13 @@ export { MarkdownText } from './markdown/MarkdownText.tsx';
 export type { MarkdownCodeLabels, MarkdownFileMentions, MarkdownLabels, MarkdownPathImages } from './markdown/MarkdownText.tsx';
 export { extractMarkdownPlainText } from './markdown/plain-text.ts';
 export type { MarkdownPlainTextMode, MarkdownPlainTextOptions } from './markdown/plain-text.ts';
+export { CODE_HIGHLIGHT_EXTENSIONS, languageForPath, useCodeHighlighter } from './code-highlighting.ts';
+export type { CodeHighlighter, HighlightSpan } from './code-highlighting.ts';
 export * from './icons/index.tsx';
 export { ImageLightbox } from './ImageLightbox.tsx';
 export type { ImageLightboxLabels } from './ImageLightbox.tsx';
 export { MenuGroup, observeStickyMenuGroups } from './MenuGroup.tsx';
-export { MenuSurface } from './MenuSurface.tsx';
+export { MenuSurface, MENU_TRANSITION_MS } from './MenuSurface.tsx';
+export { isMobileDevice } from './focus.ts';
+export type { MarkdownMenuTarget } from './markdown/MarkdownDelegate.tsx';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/markdown/MarkdownDelegate.d.ts

@@ -1,12 +1,29 @@
-import type { ReactNode } from 'react';
+import type { HTMLAttributes, ReactNode } from 'react';
 import type { ImageLightboxLabels } from '../ImageLightbox.tsx';
 /**
  * Handle one sanitized absolute HTTP(S) URL selected from Markdown.
  * @param href - destination URL.
  */
 export type MarkdownExternalLinkHandler = (href: string) => void;
+/** Explicit object and viewport coordinates from the element owning a context gesture. */
+export type MarkdownMenuTarget = {
+    kind: 'file';
+    path: string;
+    line?: number;
+} | {
+    kind: 'url';
+    url: string;
+} | {
+    kind: 'image';
+    url: string;
+    path?: string;
+    name?: string;
+    mediaType?: string;
+};
 /** Navigation capabilities supplied by the nearest Markdown owner. */
 export interface MarkdownDelegate {
+    /** Open an object menu without executing its normal activation. */
+    readonly getTriggerProps?: ((target: MarkdownMenuTarget) => Pick<HTMLAttributes<HTMLElement>, 'onContextMenu' | 'onKeyDown' | 'tabIndex'>) | undefined;
     /** Image previews for decoded local paths in this owner's workspace. */
     readonly fileImages?: {
         resolve: (path: string) => string | undefined;
@@ -37,7 +54,7 @@ export interface MarkdownDelegateProviderProps extends MarkdownDelegate {
  * @param props - Child tree and its file and HTTP(S) link handlers.
  * @returns the scoped child tree.
  */
-export declare function MarkdownDelegateProvider({ children, openExternalLink, openFile, fileImages, }: MarkdownDelegateProviderProps): ReactNode;
+export declare function MarkdownDelegateProvider({ children, openExternalLink, openFile, fileImages, getTriggerProps, }: MarkdownDelegateProviderProps): ReactNode;
 /**
  * Read the nearest Markdown navigation capabilities.
  * @returns Owner callbacks, or an empty delegate outside a provider.

package/lib/types/markdown/MarkdownText.d.ts

@@ -36,7 +36,9 @@ export type { MarkdownCodeLabels, MarkdownFileMentions, MarkdownHtmlRenderer, Ma
  * text sizing, uniform bold headings, and tight block spacing; the default
  * `body` variant uses the full document typography.
  * The provider's `openFile` enables local Markdown links in settled messages,
- * including `#L24` and `#L24-L30` destinations (ranges open at their first line).
+ * including `#L24` / `#L24-L30` fragments and `:24` / `:24-30` / `:24:5` suffixes
+ * (ranges open at their first line, columns are ignored, and invalid locations
+ * open only the file; see the README for URL/path classification).
  * @returns A GFM document with TeX math rendered through KaTeX; raw HTML
  * stays literal unless `html` supplies a renderer, and unsafe protocols are
  * disabled. Local links without an opener remain text; absolute HTTP(S)

package/lib/types/markdown/file-link.d.ts

@@ -1,10 +1,20 @@
 /** Local Markdown destinations accepted by the file-preview callback. */
 /**
- * Decode a file destination and its optional GitHub-style line fragment.
- * Literal `?` and `#` in filenames must be percent-encoded.
+ * Recognize a relative, rooted, or absolute Windows path before URL parsing.
+ * @param value - A decoded or URI-normalized destination.
+ * @returns Whether a filesystem prefix makes the destination unambiguous.
+ */
+export declare function isExplicitFilePath(value: string): boolean;
+/**
+ * Decode a file destination with a fragment, line range, or line/column suffix.
+ * Explicit relative, slash/backslash-rooted, and Windows drive paths take
+ * precedence over URLs. Other parseable absolute URLs are not file links.
+ * Fragments take precedence over colon suffixes; invalid locations open the
+ * file without selecting a line. Columns are consumed but not selected.
+ * Percent-encode literal `?`, `#`, and numeric colon suffixes in filenames.
  * @param value - Parsed Markdown link destination.
  * @returns A local path and optional first line, or undefined for URLs,
- * fragment-only links, queries, malformed escapes, or invalid line ranges.
+ * fragment-only links, queries, malformed escapes, or control characters.
  */
 export declare function parseFileLink(value: string): {
     path: string;

package/lib/types/markdown/mathCompatibility.d.ts

@@ -1,10 +1,17 @@
-/** Extend upstream dollar-only math syntax with TeX delimiters while reusing its token vocabulary. */
+/**
+ * Extend upstream dollar-only math syntax with TeX delimiters while reusing its
+ * token vocabulary. The dollar construct claims every `$$` flow fence, so text
+ * on the opening line is math content instead of the upstream construct's fence
+ * meta, which the renderer does not read.
+ */
 import type { Extension } from 'micromark-util-types';
 /**
- * TeX backslash delimiters and same-line display-dollar blocks as a micromark
- * syntax extension reusing `micromark-extension-math`'s token vocabulary; the
- * caller must also register `math()` on the same parse so the emitted tokens
- * compile to standard math nodes.
+ * TeX backslash delimiters and display-dollar blocks as a micromark syntax
+ * extension reusing `micromark-extension-math`'s token vocabulary; the caller
+ * must also register `math()` on the same parse so the emitted tokens compile
+ * to standard math nodes. Both `$$<math>$$` on one line and a `$$<math>` block
+ * closed by a trailing `$$` parse as one math node, and a closing `$$` may sit
+ * at the end of a content line.
  * @returns The micromark syntax extension.
  */
 export declare function mathCompatibility(): Extension;

package/lib/types/markdown/render.d.ts

@@ -15,7 +15,7 @@
  * nothing) rather than ending in assertNever: grammars registered elsewhere
  * may add node types this renderer has no mapping for.
  */
-import type { ReactNode } from 'react';
+import type { HTMLAttributes, ReactNode } from 'react';
 import type * as Md from 'mdast';
 import type { PositionedBlock } from './incremental.ts';
 /** Copy-button labels forwarded to fence CodeBlocks (this package is cordis-free, so copy arrives via props). */
@@ -88,6 +88,7 @@ export interface MarkdownFileMentions {
      */
     resolve(value: string): {
         open: () => void;
+        contextMenuProps?: Pick<HTMLAttributes<HTMLElement>, 'onContextMenu' | 'onKeyDown' | 'tabIndex'>;
         label: string;
         title: string;
     } | undefined;

package/lib/types/markdown/windows-path-destinations.d.ts

@@ -0,0 +1,12 @@
+/** Keep backslash separators in Markdown destinations written as Windows paths. */
+import type { Extension } from 'mdast-util-from-markdown';
+/**
+ * CommonMark reads `\.` or `\_` in a destination as an escaped character, so
+ * `D:\repo\.github` would parse as `D:\repo.github`. For a destination that
+ * is a Windows path, this fromMarkdown extension keeps every backslash
+ * literally, including one before punctuation such as `\(`, while character
+ * references such as `&` still decode; other destinations parse unchanged.
+ * @returns The mdast extension to add to `mdastExtensions`.
+ */
+export declare function windowsPathDestinations(): Extension;
+//# sourceMappingURL=windows-path-destinations.d.ts.map

package/lib/types/motion.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Motion preference for the browser-driven animations in this package.
+ * Animation owners ask before starting movement, so one query decides the
+ * answer for list glides, fades, and marquees alike.
+ */
+/**
+ * Whether the platform asked for reduced motion.
+ * A platform without the query (Node, a test DOM that implements no matcher)
+ * has expressed no preference, so motion stays allowed.
+ * @returns true when the reader prefers reduced motion.
+ */
+export declare function prefersReducedMotion(): boolean;
+//# sourceMappingURL=motion.d.ts.map

package/lib/types/overlay-top-margin.d.ts

@@ -2,7 +2,15 @@
 /**
  * Resolve the top margin an overlay keeps from the viewport edge.
  * @param min - the overlay's own viewport margin in px, used as the floor.
- * @returns the larger of `min` and the frame clearance plus 20px; fullscreen keeps only the 20px gap.
+ * @param anchor - the overlay's anchor rect in viewport coordinates. While the
+ *   anchor's top edge is visible, the margin never exceeds `anchor.bottom + gap`,
+ *   so an overlay opened from a control inside the top strip stays next to it.
+ * @param gap - the distance the overlay keeps below `anchor`.
+ * @returns the larger of `min` and the frame clearance plus 20px (20px in
+ *   fullscreen), capped by a visible `anchor`, but never below `min`.
  */
-export declare function overlayTopMargin(min: number): number;
+export declare function overlayTopMargin(min: number, anchor?: {
+    readonly top: number;
+    readonly bottom: number;
+}, gap?: number): number;
 //# sourceMappingURL=overlay-top-margin.d.ts.map

package/lib/types/quote-text.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Explicit Markdown blockquote recognition and its source token, shared by the
+ * user-text projection and any composer-side quote gesture.
+ *
+ * A quote is ordinary message text: consecutive lines that start with up to
+ * three spaces and one `>` marker, plus one optional trailing space or tab.
+ * Inline greater-than signs stay ordinary text. The first decoded line may name
+ * the message the quote came from as `[quoted](qilin-quote:<node-key>)`, which
+ * the projection consumes for a jump control and never shows as excerpt text.
+ * Line endings normalize to `\n` on decode, so a message sent from any editor
+ * prints the same excerpt.
+ *
+ * This module is the single home for both directions of that form: the
+ * projection's scanner and decoder, and the serializer a quote gesture hands
+ * the composer. Adding the composer's insertion seat needs no second copy.
+ */
+/** One blockquote span in the original UTF-16 text, excluding its trailing line break. */
+export interface MessageQuoteRange {
+    readonly start: number;
+    readonly end: number;
+}
+/** Scheme of the optional first line naming the quoted message's Chat node key. */
+export declare const QUOTE_WIRE_SCHEME = "qilin-quote:";
+/** One decoded quote block: its excerpt text and the source it names, when any. */
+export interface QuotedExcerpt {
+    /** Excerpt shown and copied, without the source marker line. */
+    readonly text: string;
+    /** Chat node key the quote names, when its first line carries one. */
+    readonly source: string | undefined;
+}
+/**
+ * Remove one blockquote marker from each line and normalize line endings.
+ * @param text - consecutive blockquote lines, with up to three leading spaces.
+ * @returns excerpt text with original line endings normalized.
+ */
+export declare function quoteTextOf(text: string): string;
+/**
+ * Recognize consecutive explicitly marked Markdown blockquote lines.
+ * @param text - complete original message text.
+ * @returns ordered nonblank quote spans; inline greater-than signs remain ordinary text.
+ */
+export declare function messageQuoteRanges(text: string): readonly MessageQuoteRange[];
+/**
+ * Split one decoded quote block into the source it names and its excerpt.
+ * @param decoded - block text already stripped of its quote markers.
+ * @returns the excerpt shown to the reader and the named source, if present.
+ */
+export declare function quotedExcerptOf(decoded: string): QuotedExcerpt;
+/**
+ * Serialize one excerpt as the blockquote text a quote gesture inserts.
+ * @param text - excerpt to quote, as selected.
+ * @param source - Chat node key of the quoted message, when the caller knows it.
+ * @returns blockquote lines, one per excerpt line, with the source marker first.
+ */
+export declare function quoteBlockTextOf(text: string, source?: string): string;
+/** One quoted excerpt as a selection gesture hands it over. */
+export interface QuoteFragment {
+    /** Excerpt text as selected, without quote markers. */
+    readonly text: string;
+    /** Chat node key of the quoted message, when the caller knows it. */
+    readonly source?: string | undefined;
+}
+/**
+ * Serialize one selected excerpt into the message text a quote gesture inserts.
+ * @param fragment - excerpt text and the source it names, if any.
+ * @returns blockquote lines the composer receives as ordinary draft text.
+ */
+export declare function quoteInsertionOf(fragment: QuoteFragment): string;
+//# sourceMappingURL=quote-text.d.ts.map

package/lib/types/use-clipboard-copy.d.ts

@@ -0,0 +1,14 @@
+/** Clipboard action and its temporary success state. */
+export interface ClipboardCopyState {
+    /** True for one second after an accepted clipboard write. */
+    readonly copied: boolean;
+    /** Write the current text unless a write or success indication is already active. */
+    readonly onCopy: () => void;
+}
+/**
+ * Keep clipboard feedback local to the mounted control and release its reset timer on unmount.
+ * @param text - Exact text to copy when the action is invoked.
+ * @returns Success feedback and a callback stable while text and feedback are unchanged.
+ */
+export declare function useClipboardCopy(text: string): ClipboardCopyState;
+//# sourceMappingURL=use-clipboard-copy.d.ts.map

package/lib/types/useAnchoredPosition.d.ts

@@ -1,36 +1,49 @@
 /**
- * Keep a fixed-position floating element anchored to a trigger.
+ * Synchronous placement for body-portaled panels fixed to the visual viewport.
  *
- * A portaled panel is positioned from its anchor's viewport rect, which stops
- * being true the moment anything scrolls or the window resizes. This owns that
- * one concern: measure the anchor, offset the panel below or above it, clamp
- * the result inside the viewport, and re-run on scroll (capture phase, so
- * scrollers nested inside the page are caught too), on resize, and on the
- * panel's own size changes while the element is open.
+ * A panel is placed from its anchor's current client rect, and that fact stops
+ * being true on scroll, resize, browser zoom, the on-screen keyboard, or an
+ * ancestor transform. This owns the whole placement concern: it measures the
+ * anchor, keeps the panel inside the visible viewport, publishes the panel's
+ * size limits as CSS variables, and tracks the anchor while the panel is open.
+ * The placement runs in a layout effect before paint, so the first open frame
+ * already carries the final coordinates.
  * @module @qilin-agent/client-ui-primitives/useAnchoredPosition
  */
 import { type CSSProperties, type RefObject } from 'react';
 /** Inputs for {@link useAnchoredPosition}. */
 export interface AnchoredPositionOptions {
-    /** Whether the floating element is mounted and should track its anchor. */
+    /** Whether the panel is mounted and should track its anchor. */
     open: boolean;
-    /** The element the panel is placed from. */
+    /** Element whose viewport rect anchors the panel. */
     anchorRef: RefObject<HTMLElement | null>;
-    /** The floating element, measured so the clamp uses real dimensions. */
+    /** Body-portaled, fixed-position panel; its ancestors must not establish a containing block. */
     panelRef: RefObject<HTMLElement | null>;
-    /** Which anchor edge the panel hangs from: below it (`bottom`, the default) or above it (`top`). */
-    side?: 'top' | 'bottom';
-    /** Which anchor edge the panel lines up with: its left edge (`start`, the default) or its right edge (`end`). */
+    /** Preferred anchor edge; right-side panels align their top edges. */
+    side?: 'top' | 'bottom' | 'right';
+    /** Horizontal alignment for panels above or below the anchor. */
     align?: 'start' | 'end';
-    /** Distance kept between the anchor edge named by `side` and the panel. */
+    /** Distance from the preferred anchor edge in CSS pixels. */
     gap: number;
-    /** Distance kept between the panel and each viewport edge. */
+    /** Minimum viewport inset; desktop frame clearance can increase the top inset. */
     margin: number;
+    /** Reserve desktop frame clearance in addition to the margin; false keeps only the viewport margin. Defaults to true. */
+    frameClearance?: boolean;
+    /** Host-supplied client rect; null hides the panel until the anchor is available. */
+    getAnchorRect?: () => DOMRect | null;
+    /** Re-measure a committed content change before paint. */
+    layoutKey?: string | number;
+    /** Minimum panel width follows the anchor, bounded by the visible viewport. */
+    minWidthFromAnchor?: boolean;
 }
 /**
- * Track an anchor and return the panel's fixed coordinates.
- * @param options - the open state, the two refs, the placement side and alignment, and the gap/margin distances.
- * @returns `left`/`top` for the panel, or `null` before the first measurement.
+ * Keep a fixed panel aligned and constrained to the visible viewport.
+ * Panel CSS consumes `--qilin-anchored-max-width` and
+ * `--qilin-anchored-max-height` for its size limits; the legacy
+ * `--dsh-anchored-*` names are mirrored while open, so sheets that still read
+ * the earlier contract keep their caps.
+ * @param options - Open state, element refs, placement, and optional host rect or content change key.
+ * @returns Fixed left/top coordinates, or null while closed or awaiting an anchor; the first measurement completes before paint.
  */
 export declare function useAnchoredPosition(options: AnchoredPositionOptions): CSSProperties | null;
 //# sourceMappingURL=useAnchoredPosition.d.ts.map

package/lib/types/useRowDragPreview.d.ts

@@ -0,0 +1,20 @@
+import type { DragEvent } from 'react';
+/**
+ * Own a row's inert drag preview until drag end, replacement, or unmount.
+ * The offscreen copy keeps WebKit snapshots separate from overlapping panels.
+ * The wrapper copies only explicitly requested computed custom properties.
+ * Its cloned slot DOM remains in document.body for that lifetime; query live rows
+ * within their list to exclude duplicate text and element IDs.
+ * @param className - preview background matching the row's surface; WebKit fills
+ * transparent snapshot pixels white, including rounded corners.
+ * @param inheritedProperties - custom-property names whose computed values the preview needs.
+ * Omit to copy none. Keep the list reference stable; replacing it clears the active preview.
+ * @returns preview callbacks; cleanup reports whether this row started a drag,
+ * even when its preview failed or the row became non-draggable before drag end.
+ * Start accepts the source row when a child handle owns the drag event.
+ */
+export declare function useRowDragPreview(className: string, inheritedProperties?: readonly `--${string}`[]): {
+    start: (event: DragEvent<HTMLElement>, row?: HTMLElement) => void;
+    clear: () => boolean;
+};
+//# sourceMappingURL=useRowDragPreview.d.ts.map

package/lib/types/user-text.d.ts

@@ -16,14 +16,35 @@
  * always draws masked, ahead of every reference decoration, and only the display
  * changes: the logged text, the copied text, and the model input keep the original
  * characters.
+ *
+ * Blockquote spans carry one more decoration: with quote presentation enabled, a
+ * consecutive `> ` run renders as one quote surface, and its own inline
+ * references and credentials stay literal excerpt text. Disabled, the same
+ * characters stay plain, so a caller that offers no quotes loses nothing.
  */
-import type { ReactNode } from 'react';
+import type { HTMLAttributes, ReactNode } from 'react';
+import type { QuotePreviewLabels } from './QuotePreview.tsx';
+/** Quote presentation a caller offers for blockquoted text. */
+export interface UserTextQuotes {
+    /** Localized copy and jump names for each excerpt surface. */
+    readonly labels: QuotePreviewLabels;
+    /** Reveal one quoted source by its Chat node key; omission hides jump controls. */
+    readonly onJump?: ((source: string) => void) | undefined;
+}
 /** Optional navigation supplied by consumers that can preview references. */
 export interface UserTextReferences {
     /** Open a file path decoded from an `@` mention. */
     openFile: (path: string) => void;
     /** Open the source of a skill loaded for this message. */
     openSkill: (name: string) => void;
+    /**
+     * Gesture bindings for one reference chip's object menu; absent leaves the
+     * chip's native behavior and adds no menu trigger.
+     */
+    contextMenuProps?: (reference: {
+        readonly kind: 'file' | 'folder' | 'session' | 'skill' | 'command' | undefined;
+        readonly label: string;
+    }) => Pick<HTMLAttributes<HTMLElement>, 'onContextMenu' | 'onKeyDown' | 'tabIndex'> | undefined;
 }
 /** Accessible names of the control that reveals one masked credential. */
 export interface UserTextSecretLabels {
@@ -42,7 +63,8 @@ export interface UserTextSecretLabels {
  * @param slashKind - the chip kind those tokens render as.
  * @param references - optional file and skill preview actions; session and command tokens stay labels.
  * @param secretLabels - reveal-control copy for credentials; absent in text that stays masked.
+ * @param quotes - quote presentation for blockquoted spans; absent renders those characters as plain text.
  * @returns inline nodes covering the whole text.
  */
-export declare function projectUserText(text: string, sessionLabels: readonly string[], slashNames?: readonly string[], slashKind?: 'skill' | 'command', references?: UserTextReferences, secretLabels?: UserTextSecretLabels): ReactNode;
+export declare function projectUserText(text: string, sessionLabels: readonly string[], slashNames?: readonly string[], slashKind?: 'skill' | 'command', references?: UserTextReferences, secretLabels?: UserTextSecretLabels, quotes?: UserTextQuotes): ReactNode;
 //# sourceMappingURL=user-text.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-primitives",
   "description": "Pure React atoms for the qilin web UI: controls, icons, markdown, and JSON inspectors (zero cordis)",
-  "version": "3.1.7",
+  "version": "3.1.9",
   "publishConfig": {
     "access": "public"
   },
@@ -26,6 +26,10 @@
   },
   "license": "MIT",
   "devDependencies": {
+    "@qilin-agent/client-store": "3.1.9",
+    "@qilin-agent/kylin": "~4.0.7",
+    "@qilin-agent/util-code-language": "3.1.9",
+    "@qilin-agent/util-workspace-path": "3.1.9",
     "@shikijs/langs": "^4.3.1",
     "@types/mdast": "^4.0.4",
     "@types/react": "~18.3.1",
@@ -44,16 +48,14 @@
     "micromark-factory-space": "^2.0.1",
     "micromark-util-character": "^2.1.1",
     "micromark-util-classify-character": "^2.0.1",
+    "micromark-util-decode-string": "^2.0.1",
     "micromark-util-sanitize-uri": "^2.0.1",
     "micromark-util-symbol": "^2.0.1",
     "micromark-util-types": "^2.0.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "shiki": "^4.3.1",
-    "simple-icons": "16.31.0",
-    "@qilin-agent/kylin": "~4.0.5",
-    "@qilin-agent/util-workspace-path": "3.1.7",
-    "@qilin-agent/client-store": "3.1.7"
+    "simple-icons": "16.31.0"
   },
   "files": [
     "lib/index.js",
@@ -61,6 +63,6 @@
     "lib/types/**/*.d.ts"
   ],
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.5"
+    "@qilin-agent/kylin": "~4.0.7"
   }
 }

package/lib/types/use-copy-feedback.d.ts

@@ -1,14 +0,0 @@
-/** The copy-feedback hook's return: the transient flag and the copy handler. */
-export interface CopyFeedback {
-    /** True for {@link COPIED_FEEDBACK_MS} after a successful write; render the success label off it. */
-    copied: boolean;
-    /** Copy the hook's text; no-op while `copied` is still true, silent on a refused write. */
-    onCopy: () => void;
-}
-/**
- * Copy `text` to the clipboard with one-second success feedback.
- * @param text - the text to write on copy.
- * @returns the `copied` flag and the `onCopy` handler.
- */
-export declare function useCopyFeedback(text: string): CopyFeedback;
-//# sourceMappingURL=use-copy-feedback.d.ts.map