@majapisoftwares/ui 6.10.0 → 6.11.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
|
@@ -64,7 +64,7 @@ Base do shadcn AI Elements (Base UI) instalada pelo CLI: `message-scroller` (o c
|
|
|
64
64
|
|
|
65
65
|
- `patterns/chat`: `Chat` (layout em `AppShell fillHeight`), `ChatMessages` (Message Scroller com `autoScroll` e `defaultScrollPosition="last-anchor"`; cada linha em `MessageScrollerItem`, turnos da pessoa com `scrollAnchor`), `ChatComposer` (alinhado à transcrição mesmo com a calha da barra de rolagem, como na Numa), `ChatMessage` (pessoa em Bubble `muted` no fim; agente sem caixa; o rodapé de ações e hora aparece no hover/foco, sempre visível no toque), `MessageActions`/`MessageAction`/`CopyMessageAction`/`ReplyMessageAction` (ícones com tooltip; feedback com `aria-pressed`), `ChatQuote` (resposta a uma mensagem, como nos apps de mensagem: autor e início do texto; em `ChatMessage quote` com `messageId` rola até a original, em `PromptInput quote` com `onDismiss` cancela; o campo ganha foco quando a citação aparece ou muda de `key`), `TypingIndicator` (Orb com texto) e `Suggestions`.
|
|
66
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.
|
|
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
|
+
- `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; aberto enquanto roda, `defaultOpen={false}` o mantém fechado quando a mesma execução aparece aberta mais adiante), `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).
|
|
68
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).
|
|
69
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".
|
|
70
70
|
- `hooks/use-streamed-text`: revela progressivamente uma resposta que chega inteira (Numa), respeitando movimento reduzido.
|
|
@@ -91,4 +91,4 @@ Uma página tem um jeito só de subir: o breadcrumb do `AppShell`. Nunca dois co
|
|
|
91
91
|
|
|
92
92
|
## Dados ao vivo
|
|
93
93
|
|
|
94
|
-
Listas e telas com dados se atualizam sozinhas: `useLiveRefresh(load, ms)` (`hooks/use-live-refresh`) chama `load` a cada `ms` (5 s por padrão) com a página visível e logo que a pessoa volta para ela. Não há botão de atualizar. Leituras caras usam um intervalo maior (um scan na nuvem a cada minutos, não segundos), nunca um botão. Tentar de novo depois de uma falha (`onRetry`) continua, porque é outra coisa.
|
|
94
|
+
Listas e telas com dados se atualizam sozinhas: `useLiveRefresh(load, ms)` (`hooks/use-live-refresh`) chama `load` a cada `ms` (5 s por padrão) com a página visível e logo que a pessoa volta para ela. `load` devolve a promise da carga (`useLiveRefresh(load)`, não `() => void load()`): enquanto ela roda, os próximos ticks esperam, e um servidor lento não recebe a mesma requisição empilhada. `npm run test:live-refresh` verifica. Não há botão de atualizar. Leituras caras usam um intervalo maior (um scan na nuvem a cada minutos, não segundos), nunca um botão. Tentar de novo depois de uma falha (`onRetry`) continua, porque é outra coisa.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@majapisoftwares/ui",
|
|
3
|
-
"version": "6.
|
|
3
|
+
"version": "6.11.0",
|
|
4
4
|
"description": "Shared Majapi UI and UX standards based on shadcn/ui",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
@@ -47,6 +47,7 @@
|
|
|
47
47
|
"test:chat-markdown": "tsx --test scripts/chat-markdown.test.tsx",
|
|
48
48
|
"test:ai-elements": "tsx --test scripts/ai-elements.test.tsx",
|
|
49
49
|
"test:navigation": "tsx --test scripts/navigation.test.tsx",
|
|
50
|
+
"test:live-refresh": "tsx --test scripts/live-refresh.test.tsx",
|
|
50
51
|
"verify": "node scripts/verify.mjs"
|
|
51
52
|
},
|
|
52
53
|
"peerDependencies": {
|
|
@@ -32,6 +32,9 @@ export function navigationViolations(text) {
|
|
|
32
32
|
found.push("the breadcrumb names the page; keep its h1 for screen readers (sr-only)");
|
|
33
33
|
if (refreshButton(text))
|
|
34
34
|
found.push("no refresh buttons; keep the screen current with useLiveRefresh (@majapisoftwares/ui/hooks/use-live-refresh)");
|
|
35
|
+
// `() => void load()` drops the promise: the hook can't hold the next ticks while it runs.
|
|
36
|
+
if (/\buseLiveRefresh\(\s*\(\)\s*=>\s*void\b/.test(text))
|
|
37
|
+
found.push("useLiveRefresh: return the load's promise (useLiveRefresh(load) or () => load()), so a slow load isn't requested again while it runs");
|
|
35
38
|
return found;
|
|
36
39
|
}
|
|
37
40
|
|
|
@@ -6,15 +6,29 @@ import { useEffect, useRef } from "react";
|
|
|
6
6
|
* Keeps a screen current, so it never needs a refresh button: calls `refresh`
|
|
7
7
|
* every `ms` while the page is visible, and right away when the person comes
|
|
8
8
|
* back to it (focus or a visible tab). The first load stays with the caller.
|
|
9
|
+
*
|
|
10
|
+
* Return the load's promise (`useLiveRefresh(load)` or `() => load()`): while
|
|
11
|
+
* it runs, the next ticks are skipped, so a slow server never gets the same
|
|
12
|
+
* request piled up. A refresh that returns nothing runs on every tick.
|
|
9
13
|
*/
|
|
10
|
-
export function useLiveRefresh(refresh: () =>
|
|
14
|
+
export function useLiveRefresh(refresh: () => unknown, ms = 5000) {
|
|
11
15
|
const latest = useRef(refresh);
|
|
12
16
|
useEffect(() => {
|
|
13
17
|
latest.current = refresh;
|
|
14
18
|
});
|
|
15
19
|
useEffect(() => {
|
|
20
|
+
let running = false;
|
|
16
21
|
const run = () => {
|
|
17
|
-
if (
|
|
22
|
+
if (document.hidden || running) return;
|
|
23
|
+
const result = latest.current();
|
|
24
|
+
if (result && typeof (result as PromiseLike<unknown>).then === "function") {
|
|
25
|
+
running = true;
|
|
26
|
+
Promise.resolve(result)
|
|
27
|
+
.catch(() => undefined)
|
|
28
|
+
.finally(() => {
|
|
29
|
+
running = false;
|
|
30
|
+
});
|
|
31
|
+
}
|
|
18
32
|
};
|
|
19
33
|
const timer = setInterval(run, ms);
|
|
20
34
|
document.addEventListener("visibilitychange", run);
|
|
@@ -247,10 +247,10 @@ function StatusIcon({ status }: { status: StepStatus }) {
|
|
|
247
247
|
return <CircleCheckIcon />;
|
|
248
248
|
}
|
|
249
249
|
|
|
250
|
-
/** Open while running and closed when done, unless the person toggled it (as Reasoning). */
|
|
251
|
-
function useRunningOpen(running: boolean) {
|
|
250
|
+
/** Open while running and closed when done (or as `defaultOpen` says), unless the person toggled it (as Reasoning). */
|
|
251
|
+
function useRunningOpen(running: boolean, defaultOpen?: boolean) {
|
|
252
252
|
const [open, setOpen] = useState<boolean>();
|
|
253
|
-
return { open: open ?? running, onOpenChange: setOpen };
|
|
253
|
+
return { open: open ?? defaultOpen ?? running, onOpenChange: setOpen };
|
|
254
254
|
}
|
|
255
255
|
|
|
256
256
|
export interface StepProps {
|
|
@@ -612,6 +612,11 @@ export interface SubagentProps {
|
|
|
612
612
|
children?: ReactNode;
|
|
613
613
|
/** What it found, once done. */
|
|
614
614
|
result?: ReactNode;
|
|
615
|
+
/**
|
|
616
|
+
* Open until the person toggles it. Defaults to open while it runs; `false`
|
|
617
|
+
* keeps it closed, e.g. when a later message shows the same run open.
|
|
618
|
+
*/
|
|
619
|
+
defaultOpen?: boolean;
|
|
615
620
|
}
|
|
616
621
|
|
|
617
622
|
/**
|
|
@@ -628,8 +633,9 @@ export function Subagent({
|
|
|
628
633
|
tools,
|
|
629
634
|
children,
|
|
630
635
|
result,
|
|
636
|
+
defaultOpen,
|
|
631
637
|
}: SubagentProps) {
|
|
632
|
-
const state = useRunningOpen(status === "running");
|
|
638
|
+
const state = useRunningOpen(status === "running", defaultOpen);
|
|
633
639
|
return (
|
|
634
640
|
<TraceCollapsible {...state}>
|
|
635
641
|
<TraceCollapsibleTrigger>
|