import type { ScopedThreadRef, ServerProviderSkill } from "@t3tools/contracts";
import { formatProviderSkillDisplayName } from "@t3tools/shared/inlineSkills";
import { Children, cloneElement, isValidElement, type ReactNode } from "react";
import { matchInlineSkills } from "@t3tools/shared/inlineSkills";
import { useRightPanelStore } from "~/rightPanelStore";
import { SKILL_CHIP_ICON_SVG } from "../composerInlineChip";
import { ContextChipPopover } from "../contextChipParts";
import { Button } from "../ui/button";
function SkillInlineText(props: {
text: string;
skills: ReadonlyArray<ServerProviderSkill>;
threadRef: ScopedThreadRef | undefined;
}) {
const nodes: ReactNode[] = [];
let cursor = 0;
for (const { start, end, skill, rawText } of matchInlineSkills(props.text, props.skills)) {
if (start > cursor) {
nodes.push(props.text.slice(cursor, start));
}
nodes.push(
<SkillChipPopover
key={`${start}:${skill.name}`}
label={formatProviderSkillDisplayName(skill)}
description={skillPopoverDescription(skill)}
copyMarkdown={rawText}
onViewInstructions={skillInstructionsOpener(props.threadRef, skill)}
/>,
);
cursor = end;
}
if (cursor === 0) {
return <>{props.text}</>;
}
if (cursor < props.text.length) {
nodes.push(props.text.slice(cursor));
}
return <>{nodes}</>;
}
export function renderSkillInlineMarkdownChildren(
children: ReactNode,
skills: ReadonlyArray<ServerProviderSkill>,
threadRef: ScopedThreadRef | undefined,
): ReactNode {
return Children.map(children, (child) => {
if (typeof child === "string") {
return <SkillInlineText text={child} skills={skills} threadRef={threadRef} />;
}
if (!isValidElement<{ children?: ReactNode; node?: { tagName?: string } }>(child)) {
return child;
}
// Custom markdown components replace intrinsic types; check their hast tags.
const markdownTagName = typeof child.type === "string" ? child.type : child.props.node?.tagName;
if (markdownTagName === "code" || markdownTagName === "a") {
return child;
}
if (!("children" in child.props)) {
return child;
}
return cloneElement(
child,
undefined,
renderSkillInlineMarkdownChildren(child.props.children, skills, threadRef),
);
});
}
export function skillPopoverDescription(
skill: Pick<ServerProviderSkill, "description" | "shortDescription">,
) {
return skill.description?.trim() || skill.shortDescription?.trim() || null;
}
export function skillInstructionsOpener(
threadRef: ScopedThreadRef | null | undefined,
skill: Pick<ServerProviderSkill, "path"> | undefined,
) {
if (!threadRef || !skill?.path) return undefined;
return () => useRightPanelStore.getState().openFile(threadRef, skill.path);
}
export function SkillChipPopover(props: {
label: string;
description: string | null | undefined;
copyMarkdown?: string | undefined;
onViewInstructions: (() => void) | undefined;
}) {
return (
<ContextChipPopover
kind="skill"
icon={<SkillChipIcon />}
label={props.label}
accessibleLabel={`Skill ${props.label}`}
copyMarkdown={props.copyMarkdown}
>
<div className="space-y-3 p-2 text-sm">
<p className="font-medium">{props.label}</p>
<p>{props.description || "No description is available for this skill."}</p>
{props.onViewInstructions ? (
<Button variant="outline" size="sm" onClick={props.onViewInstructions}>
View instructions
</Button>
) : null}
</div>
</ContextChipPopover>
);
}
function SkillChipIcon() {
return (
<span
aria-hidden="true"
className="contents"
dangerouslySetInnerHTML={{ __html: SKILL_CHIP_ICON_SVG }}
/>
);
}