@promovaweb/specsfy 0.7.0

package/dist/tui.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Dashboard terminal do Specsfy.
+ *
+ * Mantém as seis áreas públicas, navegação por teclado e mouse, polling dos
+ * arquivos do projeto e confirmação explícita antes de alterar skills.
+ */
+import blessed from "neo-blessed";
+import { Catalog, type CatalogEntryValue } from "./catalog.js";
+import { type TestRun } from "./project-testing.js";
+/** Descrições do framework exibidas quando o catálogo remoto não as fornece. */
+export declare const BASE_DESCRIPTIONS: Readonly<Record<string, string>>;
+/** Atalhos globais preservados entre as versões Python e Node.js. */
+export declare const TUI_BINDINGS: {
+    readonly "C-q": "Sair";
+    readonly escape: "Voltar";
+    readonly "C-u": "Atualizar";
+    readonly "C-b": "Framework";
+    readonly "C-d": "Detectar";
+    readonly "C-e": "Alternar";
+    readonly space: "Abrir/alternar";
+    readonly "C-a": "Aplicar";
+    readonly "C-r": "Atualizar skills";
+    readonly "C-v": "Marcar";
+    readonly "C-l": "Limpar";
+    readonly "C-t": "Todas";
+    readonly "C-n": "Instaladas";
+    readonly "C-c": "Recomendadas";
+    readonly "C-h": "Home";
+    readonly "C-g": "Backlogs";
+    readonly "C-s": "Specs";
+    readonly "C-j": "Testes";
+    readonly "C-x": "Executar testes";
+    readonly "C-k": "Skills";
+    readonly "C-o": "Sobre";
+};
+/** Abas públicas na ordem fixa apresentada no dashboard. */
+export declare const TUI_TABS: readonly [{
+    readonly id: "home";
+    readonly label: "Home";
+    readonly key: "C-h";
+}, {
+    readonly id: "backlogs";
+    readonly label: "Backlogs";
+    readonly key: "C-g";
+}, {
+    readonly id: "specs";
+    readonly label: "Specs";
+    readonly key: "C-s";
+}, {
+    readonly id: "tests";
+    readonly label: "Testes";
+    readonly key: "C-j";
+}, {
+    readonly id: "skills";
+    readonly label: "Skills";
+    readonly key: "C-k";
+}, {
+    readonly id: "about";
+    readonly label: "Sobre";
+    readonly key: "C-o";
+}];
+/** Identificador válido de uma área principal do dashboard. */
+export type Tab = (typeof TUI_TABS)[number]["id"];
+/** Filtro aplicado sobre as opções de skill disponíveis. */
+export type SkillFilter = "all" | "installed" | "detected";
+/** Opções de montagem usadas pelo executável e por integrações da TUI. */
+export interface TuiStartOptions {
+    screen?: blessed.Widgets.Screen;
+    catalog?: Catalog;
+    watch?: boolean;
+}
+/** Linha normalizada do seletor de skills. */
+export interface SkillOption {
+    name: string;
+    description: string;
+    kind: string;
+    installed: boolean;
+}
+/** Dashboard terminal principal. */
+export declare class SpecsfyTui {
+    #private;
+    project: string;
+    constructor(project?: string);
+    /** Aba atualmente exibida, útil para integrações e testes de acessibilidade. */
+    get activeTab(): Tab;
+    /** Monta a aplicação e resolve depois do encerramento da tela. */
+    run(): Promise<void>;
+    /**
+     * Monta a TUI em um screen existente.
+     *
+     * A separação permite embutir a interface e exercitar o mesmo renderer em
+     * terminais virtuais, sem manter um processo pendurado durante os testes.
+     */
+    start(options?: TuiStartOptions): Promise<void>;
+    private mountShell;
+    private bindKeys;
+    private showTab;
+    /**
+     * Retorna um nível por vez: fecha modal, limpa busca e volta ao Home.
+     *
+     * Essa ordem reproduz a ação `back` do Textual e evita que Escape descarte
+     * o contexto da aba enquanto o usuário fecha uma visualização.
+     */
+    private goBack;
+    private renderHome;
+    private renderBacklogs;
+    private renderSpecs;
+    private openSpec;
+    private renderTests;
+    private runTests;
+    private renderSkills;
+    private renderAbout;
+    private refreshAll;
+    private refreshIfChanged;
+    private skillOptions;
+    private visibleSkills;
+    private setSkillFilter;
+    private selectFramework;
+    private detectSkills;
+    private toggleSelectedSkill;
+    private selectVisible;
+    private clearVisible;
+    private applySkills;
+    private updateSkills;
+    private showStatus;
+}
+/** Cria as opções base, especialistas e instalações fora do catálogo atual. */
+export declare function buildSkillOptions(catalogEntries: CatalogEntryValue[], installed: Set<string>): SkillOption[];
+/** Retorna o plano explícito de uma skill sem executar mudanças. */
+export declare function skillPlanLabel(name: string, installed: Set<string>, selected: Set<string>): "Manter" | "Instalar" | "Remover" | "Ignorar";
+/** Filtra o catálogo com a mesma regra usada pela busca e pelos botões. */
+export declare function filterSkillOptions(options: SkillOption[], filter: SkillFilter, queryValue: string, installed: Set<string>, detected: Set<string>): SkillOption[];
+/** Formata o painel lateral da skill selecionada. */
+export declare function formatSkillDetail(option: SkillOption, installed: Set<string>, selected: Set<string>, detected: Set<string>): string;
+/** Formata o resumo estável de uma execução de testes. */
+export declare function formatTestRun(result: TestRun): string;
+/** Constrói a barra de progresso textual usada nos cards e tabelas. */
+export declare function progressBar(percent: number, width?: number): string;
+/** Preserva cada metainformação do backlog em sua própria linha no Markdown. */
+export declare function formatBacklogPreview(content: string): string;
+//# sourceMappingURL=tui.d.ts.map

package/dist/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"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"}