@4djs/assistant 0.0.0

package/src/react/lib/prompt-icons.ts

@@ -0,0 +1,40 @@
+import type { LucideIcon } from "lucide-react";
+import {
+	Code,
+	Database,
+	Layers,
+	Search,
+	Sparkles,
+	Table,
+	Terminal,
+	Wrench,
+	Zap,
+} from "lucide-react";
+
+const PROMPT_ICONS: Record<string, LucideIcon> = {
+	database: Database,
+	db: Database,
+	search: Search,
+	find: Search,
+	terminal: Terminal,
+	shell: Terminal,
+	wrench: Wrench,
+	tool: Wrench,
+	sparkles: Sparkles,
+	magic: Sparkles,
+	table: Table,
+	grid: Table,
+	code: Code,
+	layers: Layers,
+	stack: Layers,
+	zap: Zap,
+	lightning: Zap,
+};
+
+export function resolvePromptIcon(name?: string): LucideIcon | undefined {
+	if (!name) return undefined;
+	const key = name.trim().toLowerCase();
+	return PROMPT_ICONS[key];
+}
+
+export { Sparkles as DEFAULT_PROMPT_ICON };

package/src/react/types.ts

@@ -0,0 +1,83 @@
+import type { LucideIcon } from "lucide-react";
+import type { ReactNode } from "react";
+import type { AssistantStore } from "../core/create-assistant-store.ts";
+import type {
+	AssistantStoreDependencies,
+	AssistantSuggestedPrompt,
+	AssistantToolDefinition,
+} from "../core/types.ts";
+
+export interface AssistantSuggestedPromptWithIcon
+	extends Omit<AssistantSuggestedPrompt, "icon"> {
+	icon?: LucideIcon;
+	hint?: string;
+}
+
+export interface AssistantEmptyStateConfig {
+	title: string;
+	description: string;
+	/** Static fallback prompts when LLM is disabled or fetch fails */
+	suggestedPrompts?: AssistantSuggestedPromptWithIcon[];
+	/** Allow fetching contextual prompts via LLM (manual trigger; default: true) */
+	dynamicSuggestedPrompts?: boolean;
+}
+
+export interface AssistantHeaderConfig {
+	title?: string;
+	subtitle?: string;
+	icon?: LucideIcon;
+	showClearButton?: boolean;
+	/** Show button to generate LLM suggested prompts (default: true when fetchSuggestedPrompts is set) */
+	showSuggestionsButton?: boolean;
+}
+
+export interface AssistantUiConfig {
+	composerPlaceholder?: string;
+	showModelSelector?: boolean;
+	/** Show LLM settings button in the composer footer (default: true) */
+	showLlmSettings?: boolean;
+	maxWidth?: string;
+	className?: string;
+}
+
+export interface AssistantConfig extends AssistantStoreDependencies {
+	emptyState?: AssistantEmptyStateConfig;
+	header?: AssistantHeaderConfig;
+	ui?: AssistantUiConfig;
+	/** Load LLM config on mount (default: true) */
+	autoLoadLlmStatus?: boolean;
+	/** Optional hook to fetch contextual empty-state prompts via the configured LLM */
+	fetchSuggestedPrompts?: (ctx: {
+		llmEnabled: boolean;
+		model: string | null;
+		tools: AssistantToolDefinition[];
+	}) => Promise<
+		Array<{
+			id: string;
+			label: string;
+			description?: string;
+			prompt: string;
+			icon?: string;
+		}>
+	>;
+}
+
+export interface AssistantContextValue {
+	store: AssistantStore;
+	config: AssistantConfig;
+}
+
+export interface AssistantProviderProps {
+	config: AssistantConfig;
+	children: ReactNode;
+}
+
+export interface AssistantProps {
+	className?: string;
+	/** Override header from provider config */
+	header?: AssistantHeaderConfig;
+	/** Override empty state from provider config */
+	emptyState?: AssistantEmptyStateConfig;
+	/** Override UI options from provider config */
+	ui?: AssistantUiConfig;
+}

package/src/react/utils/cn.ts

@@ -0,0 +1,5 @@
+export function cn(
+	...classes: Array<string | false | null | undefined>
+): string {
+	return classes.filter(Boolean).join(" ");
+}