@r2digisolutions/components 0.15.4 → 0.16.1

package/dist/components/molecules/Popover/Popover.svelte

@@ -10,6 +10,8 @@
 		align?: PopoverAlign;
 		strategy?: 'fixed' | 'absolute';
 		offset?: number;
+		/** Solo ancla/posiciona; sin fondo, borde ni padding (el contenido aporta el chrome). */
+		unstyled?: boolean;
 		class?: string;
 		panelClass?: string;
 		trigger?: Snippet;
@@ -23,6 +25,7 @@
 		align = 'center',
 		strategy = 'fixed',
 		offset = 8,
+		unstyled = false,
 		class: className = '',
 		panelClass = '',
 		trigger,
@@ -230,7 +233,10 @@
 			ontoggle={onToggle}
 			style={panelStyle}
 			class={[
-				'popover-panel m-0 rounded-xl border-border bg-surface-elevated p-3 shadow-xl max-w-[min(20rem,calc(100vw-1rem))] border outline-none',
+				'popover-panel m-0 outline-none',
+				unstyled
+					? 'border-0 bg-transparent p-0 shadow-none'
+					: 'rounded-xl border border-border bg-surface-elevated p-3 shadow-xl max-w-[min(26rem,calc(100vw-1rem))]',
 				panelClass
 			]}
 		>
@@ -241,7 +247,10 @@
 			bind:this={panelEl}
 			role="dialog"
 			class={[
-				'min-w-48 rounded-xl border-border bg-surface-elevated p-3 shadow-xl absolute z-50 border',
+				'absolute z-50 outline-none',
+				unstyled
+					? 'border-0 bg-transparent p-0 shadow-none'
+					: 'min-w-48 rounded-xl border border-border bg-surface-elevated p-3 shadow-xl',
 				absolutePos[placement],
 				absoluteAlign[align][placement],
 				panelClass

package/dist/components/molecules/Popover/Popover.svelte.d.ts

@@ -7,6 +7,8 @@ interface PopoverProps {
     align?: PopoverAlign;
     strategy?: 'fixed' | 'absolute';
     offset?: number;
+    /** Solo ancla/posiciona; sin fondo, borde ni padding (el contenido aporta el chrome). */
+    unstyled?: boolean;
     class?: string;
     panelClass?: string;
     trigger?: Snippet;

package/dist/components/organisms/AssistantChat/AssistantChat.svelte

@@ -0,0 +1,307 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import IconButton from '../../atoms/IconButton/IconButton.svelte';
+	import {
+		Sparkles,
+		X,
+		Send,
+		Mic,
+		MicOff,
+		Volume2,
+		VolumeX,
+		LoaderCircle,
+		RotateCcw
+	} from '@lucide/svelte';
+
+	export interface AssistantMessage {
+		id: string;
+		role: 'user' | 'assistant';
+		content: string;
+	}
+
+	interface AssistantChatProps {
+		open?: boolean;
+		title?: string;
+		statusLabel?: string;
+		placeholder?: string;
+		emptyHint?: string;
+		suggestions?: string[];
+		messages?: AssistantMessage[];
+		draft?: string;
+		loading?: boolean;
+		error?: string | null;
+		voiceEnabled?: boolean;
+		voiceOutput?: boolean;
+		listening?: boolean;
+		newChatLabel?: string;
+		closeLabel?: string;
+		sendLabel?: string;
+		micLabel?: string;
+		stopMicLabel?: string;
+		voiceOnLabel?: string;
+		voiceOffLabel?: string;
+		class?: string;
+		result?: Snippet<[AssistantMessage]>;
+		footerExtra?: Snippet;
+		onsend?: () => void;
+		onclose?: () => void;
+		onnewchat?: () => void;
+		onmicclick?: () => void;
+		onvoiceoutputchange?: (on: boolean) => void;
+		onsuggestion?: (text: string) => void;
+	}
+
+	let {
+		open = $bindable(false),
+		title = 'Asistente',
+		statusLabel,
+		placeholder = 'Escribe un mensaje…',
+		emptyHint = '¿En qué puedo ayudarte?',
+		suggestions = [],
+		messages = [],
+		draft = $bindable(''),
+		loading = false,
+		error = null,
+		voiceEnabled = true,
+		voiceOutput = $bindable(true),
+		listening = false,
+		newChatLabel = 'Nueva conversación',
+		closeLabel = 'Cerrar',
+		sendLabel = 'Enviar',
+		micLabel = 'Activar micrófono',
+		stopMicLabel = 'Detener micrófono',
+		voiceOnLabel = 'Voz activada',
+		voiceOffLabel = 'Voz desactivada',
+		class: className = '',
+		result,
+		footerExtra,
+		onsend,
+		onclose,
+		onnewchat,
+		onmicclick,
+		onvoiceoutputchange,
+		onsuggestion
+	}: AssistantChatProps = $props();
+
+	let scrollEl = $state<HTMLDivElement | null>(null);
+
+	const isEmpty = $derived(messages.length === 0 && !loading);
+	const canSend = $derived(draft.trim().length > 0 && !loading);
+
+	$effect(() => {
+		void messages.length;
+		void loading;
+		const el = scrollEl;
+		if (!el) return;
+		const raf = requestAnimationFrame(() => {
+			if (el) el.scrollTop = el.scrollHeight;
+		});
+		return () => cancelAnimationFrame(raf);
+	});
+
+	function handleClose() {
+		open = false;
+		onclose?.();
+	}
+
+	function handleSend() {
+		if (!canSend) return;
+		onsend?.();
+	}
+
+	function handleKeydown(e: KeyboardEvent) {
+		if (e.key === 'Enter' && !e.shiftKey) {
+			e.preventDefault();
+			handleSend();
+		}
+	}
+
+	function handleSuggestion(text: string) {
+		draft = text;
+		onsuggestion?.(text);
+	}
+
+	function toggleVoice() {
+		voiceOutput = !voiceOutput;
+		onvoiceoutputchange?.(voiceOutput);
+	}
+</script>
+
+<div
+	class={[
+		'flex flex-col overflow-hidden rounded-2xl border border-border bg-surface-elevated shadow-xl',
+		'h-[min(560px,70vh)] w-full min-w-[320px] max-w-[420px]',
+		className
+	]}
+	role="complementary"
+	aria-label={title}
+>
+	<!-- Header -->
+	<header class="flex shrink-0 items-center gap-2 border-b border-border px-3 py-2.5">
+		<span
+			class="flex h-7 w-7 shrink-0 items-center justify-center rounded-lg bg-brand-100 text-brand-600 dark:bg-brand-900/40 dark:text-brand-400"
+			aria-hidden="true"
+		>
+			<Sparkles size={15} strokeWidth={2} />
+		</span>
+		<div class="min-w-0 flex-1">
+			<p class="truncate text-sm font-semibold text-primary">{title}</p>
+			{#if statusLabel}
+				<p class="truncate text-xs text-muted">{statusLabel}</p>
+			{/if}
+		</div>
+		<IconButton variant="ghost" size="xs" label={newChatLabel} onclick={() => onnewchat?.()}>
+			<RotateCcw size={14} strokeWidth={2} />
+		</IconButton>
+		<IconButton variant="ghost" size="xs" label={closeLabel} onclick={handleClose}>
+			<X size={14} strokeWidth={2} />
+		</IconButton>
+	</header>
+
+	<!-- Body -->
+	<div bind:this={scrollEl} class="min-h-0 flex-1 overflow-y-auto px-3 py-3">
+		{#if isEmpty}
+			<div class="flex flex-col items-center justify-center gap-4 py-8 text-center">
+				<span
+					class="flex h-12 w-12 items-center justify-center rounded-2xl bg-brand-50 text-brand-500 dark:bg-brand-950/30 dark:text-brand-400"
+					aria-hidden="true"
+				>
+					<Sparkles size={24} strokeWidth={1.5} />
+				</span>
+				<p class="text-sm text-muted">{emptyHint}</p>
+				{#if suggestions.length}
+					<div class="flex flex-wrap justify-center gap-2">
+						{#each suggestions as suggestion (suggestion)}
+							<button
+								type="button"
+								class="rounded-full border border-border bg-surface px-3 py-1.5 text-xs text-secondary transition-colors hover:border-brand-400 hover:text-brand-600 dark:hover:text-brand-400"
+								onclick={() => handleSuggestion(suggestion)}
+							>
+								{suggestion}
+							</button>
+						{/each}
+					</div>
+				{/if}
+			</div>
+		{:else}
+			<div class="flex flex-col gap-3">
+				{#each messages as message (message.id)}
+					{#if message.role === 'user'}
+						<div class="flex justify-end">
+							<div
+								class="max-w-[80%] rounded-2xl rounded-br-sm bg-brand-600 px-3.5 py-2.5 text-sm leading-relaxed text-white"
+							>
+								{message.content}
+							</div>
+						</div>
+					{:else}
+						<div class="flex flex-col gap-1.5">
+							<div class="flex items-start gap-2">
+								<span
+									class="mt-0.5 flex h-6 w-6 shrink-0 items-center justify-center rounded-full bg-brand-100 text-brand-600 dark:bg-brand-900/40 dark:text-brand-400"
+									aria-hidden="true"
+								>
+									<Sparkles size={12} strokeWidth={2} />
+								</span>
+								<div
+									class="max-w-[calc(100%-2rem)] rounded-2xl rounded-bl-sm bg-surface-overlay px-3.5 py-2.5 text-sm leading-relaxed text-primary"
+								>
+									{message.content}
+								</div>
+							</div>
+							{#if result}
+								<div class="ml-8">
+									{@render result(message)}
+								</div>
+							{/if}
+						</div>
+					{/if}
+				{/each}
+
+				{#if loading}
+					<div class="flex items-center gap-2">
+						<span
+							class="flex h-6 w-6 shrink-0 items-center justify-center rounded-full bg-brand-100 text-brand-600 dark:bg-brand-900/40 dark:text-brand-400"
+							aria-hidden="true"
+						>
+							<Sparkles size={12} strokeWidth={2} />
+						</span>
+						<div
+							class="flex items-center gap-2 rounded-2xl rounded-bl-sm bg-surface-overlay px-3.5 py-2.5"
+						>
+							<LoaderCircle size={14} strokeWidth={2} class="animate-spin text-muted" />
+							<span class="text-xs text-muted">Procesando…</span>
+						</div>
+					</div>
+				{/if}
+
+				{#if error}
+					<div
+						class="rounded-xl border border-red-200 bg-red-50 px-3 py-2 text-xs text-red-600 dark:border-red-800/40 dark:bg-red-950/20 dark:text-red-400"
+					>
+						{error}
+					</div>
+				{/if}
+			</div>
+		{/if}
+	</div>
+
+	<!-- Footer -->
+	<footer class="shrink-0 border-t border-border px-3 py-2.5">
+		<div class="flex items-center gap-1.5">
+			<input
+				type="text"
+				bind:value={draft}
+				{placeholder}
+				class="h-9 min-w-0 flex-1 rounded-xl border border-border bg-surface px-3 text-sm text-primary outline-none transition-shadow placeholder:text-muted focus:border-brand-400 focus:ring-2 focus:ring-brand-500/20"
+				disabled={loading}
+				onkeydown={handleKeydown}
+				aria-label={placeholder}
+			/>
+
+			<div class="flex shrink-0 items-center gap-0.5">
+				{#if voiceEnabled}
+					<IconButton
+						variant="ghost"
+						size="sm"
+						label={listening ? stopMicLabel : micLabel}
+						onclick={() => onmicclick?.()}
+						class={listening ? 'text-red-500 hover:text-red-600' : ''}
+					>
+						{#if listening}
+							<MicOff size={16} strokeWidth={2} />
+						{:else}
+							<Mic size={16} strokeWidth={2} />
+						{/if}
+					</IconButton>
+					<IconButton
+						variant="ghost"
+						size="sm"
+						label={voiceOutput ? voiceOnLabel : voiceOffLabel}
+						onclick={toggleVoice}
+					>
+						{#if voiceOutput}
+							<Volume2 size={16} strokeWidth={2} />
+						{:else}
+							<VolumeX size={16} strokeWidth={2} />
+						{/if}
+					</IconButton>
+				{/if}
+
+				<IconButton
+					variant={canSend ? 'primary' : 'ghost'}
+					size="sm"
+					label={sendLabel}
+					disabled={!canSend}
+					onclick={handleSend}
+				>
+					<Send size={16} strokeWidth={2} />
+				</IconButton>
+			</div>
+		</div>
+
+		{#if footerExtra}
+			{@render footerExtra()}
+		{/if}
+	</footer>
+</div>

package/dist/components/organisms/AssistantChat/AssistantChat.svelte.d.ts

@@ -0,0 +1,40 @@
+import type { Snippet } from 'svelte';
+export interface AssistantMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+}
+interface AssistantChatProps {
+    open?: boolean;
+    title?: string;
+    statusLabel?: string;
+    placeholder?: string;
+    emptyHint?: string;
+    suggestions?: string[];
+    messages?: AssistantMessage[];
+    draft?: string;
+    loading?: boolean;
+    error?: string | null;
+    voiceEnabled?: boolean;
+    voiceOutput?: boolean;
+    listening?: boolean;
+    newChatLabel?: string;
+    closeLabel?: string;
+    sendLabel?: string;
+    micLabel?: string;
+    stopMicLabel?: string;
+    voiceOnLabel?: string;
+    voiceOffLabel?: string;
+    class?: string;
+    result?: Snippet<[AssistantMessage]>;
+    footerExtra?: Snippet;
+    onsend?: () => void;
+    onclose?: () => void;
+    onnewchat?: () => void;
+    onmicclick?: () => void;
+    onvoiceoutputchange?: (on: boolean) => void;
+    onsuggestion?: (text: string) => void;
+}
+declare const AssistantChat: import("svelte").Component<AssistantChatProps, {}, "open" | "draft" | "voiceOutput">;
+type AssistantChat = ReturnType<typeof AssistantChat>;
+export default AssistantChat;

package/dist/components/organisms/AssistantFab/AssistantFab.svelte

@@ -0,0 +1,27 @@
+<script lang="ts">
+	import IconButton from '../../atoms/IconButton/IconButton.svelte';
+	import { Sparkles } from '@lucide/svelte';
+
+	interface AssistantFabProps {
+		label?: string;
+		onclick?: () => void;
+		class?: string;
+	}
+
+	let {
+		label = 'Abrir asistente',
+		onclick,
+		class: className = ''
+	}: AssistantFabProps = $props();
+</script>
+
+<IconButton
+	variant="primary"
+	size="xl"
+	rounded
+	{label}
+	onclick={() => onclick?.()}
+	class={['shadow-lg shadow-brand-500/30', className].filter(Boolean).join(' ')}
+>
+	<Sparkles size={22} strokeWidth={2} />
+</IconButton>

package/dist/components/organisms/AssistantFab/AssistantFab.svelte.d.ts

@@ -0,0 +1,8 @@
+interface AssistantFabProps {
+    label?: string;
+    onclick?: () => void;
+    class?: string;
+}
+declare const AssistantFab: import("svelte").Component<AssistantFabProps, {}, "">;
+type AssistantFab = ReturnType<typeof AssistantFab>;
+export default AssistantFab;

package/dist/index.d.ts

@@ -698,6 +698,9 @@ export { default as RegisterForm } from './components/organisms/RegisterForm/Reg
 export { default as ForgotPasswordForm } from './components/organisms/ForgotPasswordForm/ForgotPasswordForm.svelte';
 export { default as OtpVerify } from './components/organisms/OtpVerify/OtpVerify.svelte';
 export { default as ChatWindow } from './components/organisms/ChatWindow/ChatWindow.svelte';
+export { default as AssistantChat } from './components/organisms/AssistantChat/AssistantChat.svelte';
+export type { AssistantMessage } from './components/organisms/AssistantChat/AssistantChat.svelte';
+export { default as AssistantFab } from './components/organisms/AssistantFab/AssistantFab.svelte';
 export { default as CommentThread } from './components/organisms/CommentThread/CommentThread.svelte';
 export type { CommentItem } from './components/organisms/CommentThread/CommentThread.svelte';
 export { default as ActivityFeed } from './components/organisms/ActivityFeed/ActivityFeed.svelte';

package/dist/index.js

@@ -483,6 +483,8 @@ export { default as RegisterForm } from './components/organisms/RegisterForm/Reg
 export { default as ForgotPasswordForm } from './components/organisms/ForgotPasswordForm/ForgotPasswordForm.svelte';
 export { default as OtpVerify } from './components/organisms/OtpVerify/OtpVerify.svelte';
 export { default as ChatWindow } from './components/organisms/ChatWindow/ChatWindow.svelte';
+export { default as AssistantChat } from './components/organisms/AssistantChat/AssistantChat.svelte';
+export { default as AssistantFab } from './components/organisms/AssistantFab/AssistantFab.svelte';
 export { default as CommentThread } from './components/organisms/CommentThread/CommentThread.svelte';
 export { default as ActivityFeed } from './components/organisms/ActivityFeed/ActivityFeed.svelte';
 export { default as SettingsLayout } from './components/organisms/SettingsLayout/SettingsLayout.svelte';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@r2digisolutions/components",
-	"version": "0.15.4",
+	"version": "0.16.1",
 	"private": false,
 	"description": "R2DigiSolutions Svelte 5 component library — Atomic Design, Tailwind 4, Light/Dark mode",
 	"license": "MIT",