@majapisoftwares/ui 6.8.1 → 6.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/docs/STANDARDS.md
CHANGED
|
@@ -52,6 +52,7 @@ AGENTS.md nos apps exige contribuição upstream antes de uso. O verificador est
|
|
|
52
52
|
- Imports internos relativos e `"use client"` são aplicados por `npm run normalize:ui` após o CLI do shadcn.
|
|
53
53
|
- Sheet traduz o nome acessível do fechamento pelo idioma ativo.
|
|
54
54
|
- Sidebar: três modos (open/compact/closed), largura redimensionável (208–448px) com troca de modo por largura, menu de clique direito, tooltip que fecha ao clicar e textos traduzidos.
|
|
55
|
+
- Tabelas nunca alargam a página: `SidebarInset` tem `min-w-0` (sem ele, um conteúdo largo mantinha o inset na largura inteira e a página rolava para o lado pela largura da sidebar) e o contêiner de `Table` usa `contain-inline-size`, então a largura das linhas não entra no tamanho de nenhum ancestral (flex ou grid): a tabela rola dentro do próprio contêiner. O contêiner ocupa a largura que o pai dá; dentro de um pai que encolhe ao conteúdo (`w-fit`, inline, trilha `auto` de grid), dê largura ao pai. Não remova nenhum dos dois.
|
|
55
56
|
- use-mobile usa useSyncExternalStore (compatível com SSR e com a regra de hooks).
|
|
56
57
|
- Field usa imports relativos. Button assume type=button para evitar submissões acidentais; formulários declaram type=submit. Badge inclui variantes success e warning reutilizadas por StatusBadge.
|
|
57
58
|
- Tokens de identidade, estados semânticos e padrões compostos são mantidos aqui.
|
|
@@ -65,7 +66,7 @@ Base do shadcn AI Elements (Base UI) instalada pelo CLI: `message-scroller` (o c
|
|
|
65
66
|
- `patterns/prompt-input`: InputGroup com Enter envia e Shift+Enter quebra linha (respeitando IME), anexar/colar/soltar arquivos com Attachment, foco preservado ao enviar, botão Parar durante `submitted`/`streaming` e rascunho restaurado quando o envio rejeita (Numa). Com `sendWhileBusy`, a pessoa envia enquanto o agente trabalha (direcionar uma execução, como no Workbench e na Numa): com texto o botão envia, com o campo vazio ele para.
|
|
66
67
|
- `patterns/chat-trace`: `ChatTrace`, `Reasoning` (abre enquanto pensa, fecha ao terminar salvo se a pessoa alternou; vários passos são várias linhas), `Tool` (estados pending/running/done/error/denied, saída sob demanda num `CodeBlock` pequeno), `Confirmation` (Aprovar/Negar; depois de respondida vira `Tool`), `Step` (uma ação do agente; abre para a saída ou para os resultados de busca em `badges`; `render` vira link), `ChainOfThought` (resumo "Pesquisou em N passos" que abre para os `Step`s, aberto enquanto roda), `Plan` (passos decididos antes, com "N de M feitos"), `Queue` (a fazer aberto, concluídos fechados), `Task` (passos que surgem do trabalho; aberta enquanto roda), `Sources` (links usados, fechado), `Subagent` (execução delegada: tarefa, modelo e ferramentas como Badge, chamadas e resultado), `Terminal` (comando e saída; abre quando chega saída, código diferente de 0 é erro), `TestResults` (contagens, suítes por arquivo, falhas abrem o erro) e `StackTrace` (`parseStack`; seus quadros primeiro, os do framework dobrados).
|
|
67
68
|
- `patterns/chat-citation` `InlineCitation` (hostname no meio do texto, hover com título e link), `patterns/chat-context` `ContextUsage` (porcentagem do contexto com contagens no hover, para as `actions` do PromptInput), `patterns/model-selector` `ModelSelector`/`EffortSelector` (menus de modelo por provedor e de esforço, nas `actions`), `patterns/chat-checkpoint` `Checkpoint` (separador com Restaurar) e `patterns/file-tree` `FileTree`/`fileTree` (pastas que abrem e arquivos a escolher, montados de caminhos).
|
|
68
|
-
- `patterns/chat-markdown`: `ChatMarkdown` com Streamdown (sanitiza a saída do modelo, completa markdown incompleto durante o streaming e traduz os controles). Substitui o react-markdown da Numa.
|
|
69
|
+
- `patterns/chat-markdown`: `ChatMarkdown` com Streamdown (sanitiza a saída do modelo, completa markdown incompleto durante o streaming e traduz os controles). Substitui o react-markdown da Numa. Links externos abrem um Dialog da biblioteca (copiar, abrir este link, sempre abrir o host); `TrustedLinksProvider` recebe os hosts que abrem direto e `onTrust`, e o app guarda a lista. Sem o provider, todo link pergunta e não há "sempre abrir".
|
|
69
70
|
- `hooks/use-streamed-text`: revela progressivamente uma resposta que chega inteira (Numa), respeitando movimento reduzido.
|
|
70
71
|
|
|
71
72
|
Erros de resposta aparecem na própria mensagem (Bubble `destructive`) com Tentar novamente; erros de ações fora da conversa vão para o toast (`toastError`). O catálogo demonstra em `/chat` (conversa com raciocínio, ferramentas, aprovação, erro e retry) e `/chat/new` (vazio com sugestões); `/chat/elements` mostra cada AI Element.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@majapisoftwares/ui",
|
|
3
|
-
"version": "6.
|
|
3
|
+
"version": "6.9.0",
|
|
4
4
|
"description": "Shared Majapi UI and UX standards based on shadcn/ui",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
@@ -44,6 +44,7 @@
|
|
|
44
44
|
"test:preferences": "tsx --test scripts/preferences.test.tsx",
|
|
45
45
|
"test:data-table": "tsx --test scripts/data-table.test.tsx",
|
|
46
46
|
"test:chat-quote": "tsx --test scripts/chat-quote.test.tsx",
|
|
47
|
+
"test:chat-markdown": "tsx --test scripts/chat-markdown.test.tsx",
|
|
47
48
|
"test:ai-elements": "tsx --test scripts/ai-elements.test.tsx",
|
|
48
49
|
"verify": "node scripts/verify.mjs"
|
|
49
50
|
},
|
|
@@ -615,12 +615,14 @@ function SidebarRail({ className, ...props }: React.ComponentProps<"div">) {
|
|
|
615
615
|
);
|
|
616
616
|
}
|
|
617
617
|
|
|
618
|
+
// Majapi UI: `min-w-0` lets the inset shrink beside the sidebar; without it a
|
|
619
|
+
// wide child (a table) keeps it at full width and the page scrolls sideways.
|
|
618
620
|
function SidebarInset({ className, ...props }: React.ComponentProps<"main">) {
|
|
619
621
|
return (
|
|
620
622
|
<main
|
|
621
623
|
data-slot="sidebar-inset"
|
|
622
624
|
className={cn(
|
|
623
|
-
"relative flex w-full flex-1 flex-col bg-background md:peer-data-[variant=inset]:m-2 md:peer-data-[variant=inset]:ml-0 md:peer-data-[variant=inset]:rounded-2xl md:peer-data-[variant=inset]:shadow-sm md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2",
|
|
625
|
+
"relative flex w-full min-w-0 flex-1 flex-col bg-background md:peer-data-[variant=inset]:m-2 md:peer-data-[variant=inset]:ml-0 md:peer-data-[variant=inset]:rounded-2xl md:peer-data-[variant=inset]:shadow-sm md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2",
|
|
624
626
|
className,
|
|
625
627
|
)}
|
|
626
628
|
{...props}
|
|
@@ -4,7 +4,10 @@ import * as React from "react";
|
|
|
4
4
|
import { cn } from "cn";
|
|
5
5
|
|
|
6
6
|
// Majapi UI: `containerClassName` styles the scroll container (e.g. to fill
|
|
7
|
-
// the available height and scroll vertically).
|
|
7
|
+
// the available height and scroll vertically). `contain-inline-size` keeps the
|
|
8
|
+
// table's width out of every ancestor's sizing: however wide the rows, the
|
|
9
|
+
// table scrolls inside its own container and never widens the page, in any
|
|
10
|
+
// flex or grid layout. The container takes the width its parent gives it.
|
|
8
11
|
function Table({
|
|
9
12
|
className,
|
|
10
13
|
containerClassName,
|
|
@@ -13,7 +16,7 @@ function Table({
|
|
|
13
16
|
return (
|
|
14
17
|
<div
|
|
15
18
|
data-slot="table-container"
|
|
16
|
-
className={cn("relative w-full overflow-x-auto", containerClassName)}
|
|
19
|
+
className={cn("relative w-full overflow-x-auto contain-inline-size", containerClassName)}
|
|
17
20
|
>
|
|
18
21
|
<table
|
|
19
22
|
data-slot="table"
|
package/src/lib/utils.ts
CHANGED
|
@@ -15,3 +15,18 @@ export function quoteText(markdown: string) {
|
|
|
15
15
|
.replace(/\s+/g, " ")
|
|
16
16
|
.trim();
|
|
17
17
|
}
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* The host an "always open" choice for a link applies to (lowercase, no port),
|
|
21
|
+
* or null for anything but an absolute http(s) URL.
|
|
22
|
+
*/
|
|
23
|
+
export function linkHost(url: string) {
|
|
24
|
+
try {
|
|
25
|
+
const parsed = new URL(url);
|
|
26
|
+
return parsed.protocol === "https:" || parsed.protocol === "http:"
|
|
27
|
+
? parsed.hostname.toLowerCase()
|
|
28
|
+
: null;
|
|
29
|
+
} catch {
|
|
30
|
+
return null;
|
|
31
|
+
}
|
|
32
|
+
}
|
|
@@ -1,7 +1,35 @@
|
|
|
1
1
|
"use client";
|
|
2
2
|
|
|
3
|
-
import {
|
|
4
|
-
|
|
3
|
+
import {
|
|
4
|
+
createContext,
|
|
5
|
+
useContext,
|
|
6
|
+
useEffect,
|
|
7
|
+
useMemo,
|
|
8
|
+
useRef,
|
|
9
|
+
useState,
|
|
10
|
+
type ReactNode,
|
|
11
|
+
} from "react";
|
|
12
|
+
import {
|
|
13
|
+
CheckIcon,
|
|
14
|
+
CopyIcon,
|
|
15
|
+
ExternalLinkIcon,
|
|
16
|
+
ShieldCheckIcon,
|
|
17
|
+
} from "lucide-react";
|
|
18
|
+
import {
|
|
19
|
+
Streamdown,
|
|
20
|
+
type LinkSafetyModalProps,
|
|
21
|
+
type StreamdownProps,
|
|
22
|
+
} from "streamdown";
|
|
23
|
+
import { Button } from "../components/ui/button";
|
|
24
|
+
import {
|
|
25
|
+
Dialog,
|
|
26
|
+
DialogContent,
|
|
27
|
+
DialogDescription,
|
|
28
|
+
DialogFooter,
|
|
29
|
+
DialogHeader,
|
|
30
|
+
DialogTitle,
|
|
31
|
+
} from "../components/ui/dialog";
|
|
32
|
+
import { cn, linkHost } from "../lib/utils";
|
|
5
33
|
import { defineMessages, useMessages } from "../lib/i18n";
|
|
6
34
|
|
|
7
35
|
// Streamdown ships English labels; the rest follow the active locale.
|
|
@@ -36,8 +64,124 @@ const translations = defineMessages<StreamdownProps["translations"]>({
|
|
|
36
64
|
},
|
|
37
65
|
});
|
|
38
66
|
|
|
39
|
-
|
|
40
|
-
|
|
67
|
+
const linkMessages = defineMessages({
|
|
68
|
+
en: {
|
|
69
|
+
title: "Open external link?",
|
|
70
|
+
description: "You're about to open an external site.",
|
|
71
|
+
copy: "Copy link",
|
|
72
|
+
copied: "Copied",
|
|
73
|
+
openOnce: "Open this link",
|
|
74
|
+
alwaysOpen: (host: string) => `Always open ${host}`,
|
|
75
|
+
},
|
|
76
|
+
"pt-BR": {
|
|
77
|
+
title: "Abrir link externo?",
|
|
78
|
+
description: "Você vai abrir um site externo.",
|
|
79
|
+
copy: "Copiar link",
|
|
80
|
+
copied: "Copiado",
|
|
81
|
+
openOnce: "Abrir este link",
|
|
82
|
+
alwaysOpen: (host: string) => `Sempre abrir ${host}`,
|
|
83
|
+
},
|
|
84
|
+
});
|
|
85
|
+
|
|
86
|
+
export interface TrustedLinks {
|
|
87
|
+
/** Hosts (such as "github.com") whose links open without asking. */
|
|
88
|
+
hosts: readonly string[];
|
|
89
|
+
/** The person chose to always open links to this host. */
|
|
90
|
+
onTrust: (host: string) => void;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
const TrustedLinksContext = createContext<TrustedLinks | null>(null);
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* The sites a person always opens from ChatMarkdown links. Without it, every
|
|
97
|
+
* external link asks first and the dialog has no "always open" choice.
|
|
98
|
+
* Persisting the list (per person, per device) is up to the app.
|
|
99
|
+
*/
|
|
100
|
+
export function TrustedLinksProvider({
|
|
101
|
+
hosts,
|
|
102
|
+
onTrust,
|
|
103
|
+
children,
|
|
104
|
+
}: TrustedLinks & { children: ReactNode }) {
|
|
105
|
+
const value = useMemo(() => ({ hosts, onTrust }), [hosts, onTrust]);
|
|
106
|
+
return (
|
|
107
|
+
<TrustedLinksContext.Provider value={value}>
|
|
108
|
+
{children}
|
|
109
|
+
</TrustedLinksContext.Provider>
|
|
110
|
+
);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
function LinkDialog({
|
|
114
|
+
url,
|
|
115
|
+
isOpen,
|
|
116
|
+
onClose,
|
|
117
|
+
onConfirm,
|
|
118
|
+
onTrust,
|
|
119
|
+
}: LinkSafetyModalProps & { onTrust?: (host: string) => void }) {
|
|
120
|
+
const t = useMessages(linkMessages);
|
|
121
|
+
const [copied, setCopied] = useState(false);
|
|
122
|
+
const host = onTrust ? linkHost(url) : null;
|
|
123
|
+
const open = () => {
|
|
124
|
+
onConfirm();
|
|
125
|
+
onClose();
|
|
126
|
+
};
|
|
127
|
+
const copy = async () => {
|
|
128
|
+
try {
|
|
129
|
+
await navigator.clipboard.writeText(url);
|
|
130
|
+
setCopied(true);
|
|
131
|
+
setTimeout(() => setCopied(false), 2000);
|
|
132
|
+
} catch {
|
|
133
|
+
// The URL stays on screen to copy by hand.
|
|
134
|
+
}
|
|
135
|
+
};
|
|
136
|
+
return (
|
|
137
|
+
<Dialog open={isOpen} onOpenChange={(next) => !next && onClose()}>
|
|
138
|
+
<DialogContent>
|
|
139
|
+
<DialogHeader>
|
|
140
|
+
<DialogTitle className="flex items-center gap-2">
|
|
141
|
+
<ExternalLinkIcon className="size-4" aria-hidden="true" />
|
|
142
|
+
{t.title}
|
|
143
|
+
</DialogTitle>
|
|
144
|
+
<DialogDescription>{t.description}</DialogDescription>
|
|
145
|
+
</DialogHeader>
|
|
146
|
+
<div className="max-h-32 overflow-y-auto rounded-2xl bg-muted p-3 font-mono text-xs break-all">
|
|
147
|
+
{url}
|
|
148
|
+
</div>
|
|
149
|
+
<DialogFooter className="grid grid-cols-2">
|
|
150
|
+
<Button variant="outline" onClick={() => void copy()}>
|
|
151
|
+
{copied ? (
|
|
152
|
+
<CheckIcon aria-hidden="true" />
|
|
153
|
+
) : (
|
|
154
|
+
<CopyIcon aria-hidden="true" />
|
|
155
|
+
)}
|
|
156
|
+
{copied ? t.copied : t.copy}
|
|
157
|
+
</Button>
|
|
158
|
+
<Button variant={host ? "outline" : "default"} onClick={open}>
|
|
159
|
+
<ExternalLinkIcon aria-hidden="true" />
|
|
160
|
+
{t.openOnce}
|
|
161
|
+
</Button>
|
|
162
|
+
{host ? (
|
|
163
|
+
<Button
|
|
164
|
+
className="col-span-2 min-w-0"
|
|
165
|
+
title={t.alwaysOpen(host)}
|
|
166
|
+
onClick={() => {
|
|
167
|
+
onTrust?.(host);
|
|
168
|
+
open();
|
|
169
|
+
}}
|
|
170
|
+
>
|
|
171
|
+
<ShieldCheckIcon aria-hidden="true" />
|
|
172
|
+
<span className="truncate">{t.alwaysOpen(host)}</span>
|
|
173
|
+
</Button>
|
|
174
|
+
) : null}
|
|
175
|
+
</DialogFooter>
|
|
176
|
+
</DialogContent>
|
|
177
|
+
</Dialog>
|
|
178
|
+
);
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
export interface ChatMarkdownProps extends Omit<
|
|
182
|
+
StreamdownProps,
|
|
183
|
+
"children" | "isAnimating"
|
|
184
|
+
> {
|
|
41
185
|
children: string;
|
|
42
186
|
/** True while the text is still arriving: unfinished markdown is completed and new words fade in. */
|
|
43
187
|
streaming?: boolean;
|
|
@@ -46,7 +190,8 @@ export interface ChatMarkdownProps
|
|
|
46
190
|
/**
|
|
47
191
|
* Agent reply as markdown (Streamdown, as in shadcn AI Elements Message).
|
|
48
192
|
* Sanitizes model output, renders GFM tables and code with copy controls, and
|
|
49
|
-
* tolerates half-streamed syntax.
|
|
193
|
+
* tolerates half-streamed syntax. External links ask before opening, unless
|
|
194
|
+
* their host is in TrustedLinksProvider.
|
|
50
195
|
*/
|
|
51
196
|
export function ChatMarkdown({
|
|
52
197
|
children,
|
|
@@ -55,11 +200,37 @@ export function ChatMarkdown({
|
|
|
55
200
|
...props
|
|
56
201
|
}: ChatMarkdownProps) {
|
|
57
202
|
const t = useMessages(translations);
|
|
203
|
+
const trusted = useContext(TrustedLinksContext);
|
|
204
|
+
// Read at click time, so a growing list doesn't re-render every link.
|
|
205
|
+
const trustedRef = useRef(trusted);
|
|
206
|
+
useEffect(() => {
|
|
207
|
+
trustedRef.current = trusted;
|
|
208
|
+
}, [trusted]);
|
|
209
|
+
const canTrust = trusted !== null;
|
|
210
|
+
const linkSafety = useMemo<StreamdownProps["linkSafety"]>(
|
|
211
|
+
() => ({
|
|
212
|
+
enabled: true,
|
|
213
|
+
onLinkCheck: (url) => {
|
|
214
|
+
const host = linkHost(url);
|
|
215
|
+
return !!host && !!trustedRef.current?.hosts.includes(host);
|
|
216
|
+
},
|
|
217
|
+
renderModal: (modal) => (
|
|
218
|
+
<LinkDialog
|
|
219
|
+
{...modal}
|
|
220
|
+
onTrust={
|
|
221
|
+
canTrust ? (host) => trustedRef.current?.onTrust(host) : undefined
|
|
222
|
+
}
|
|
223
|
+
/>
|
|
224
|
+
),
|
|
225
|
+
}),
|
|
226
|
+
[canTrust],
|
|
227
|
+
);
|
|
58
228
|
return (
|
|
59
229
|
<Streamdown
|
|
60
230
|
isAnimating={streaming}
|
|
61
231
|
animated
|
|
62
232
|
translations={t}
|
|
233
|
+
linkSafety={linkSafety}
|
|
63
234
|
className={cn(
|
|
64
235
|
"min-w-0 text-sm leading-relaxed wrap-break-word *:first:mt-0 *:last:mb-0",
|
|
65
236
|
className,
|