types-nora-api 0.0.469 → 0.0.472

package/dist/menus/index.js

@@ -0,0 +1,279 @@
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Contratos de menus
+import { menuDinamico, menuGrupo, menuItem, menuVazio } from '../dtos';
+import { PAGINAS, decidirAcessoPagina } from '../paginas';
+function filtrarMenuPorAcesso(nodes, ctx) {
+    const out = [];
+    for (const node of nodes) {
+        if (node.tipo === 'item') {
+            const decisao = decidirAcessoPagina(node.destino.pagina, ctx, { resolverMenuInterno, redirectNaoAutenticado: PAGINAS.acessar, redirectSemCapacidade: PAGINAS.home });
+            if (decisao.permitido)
+                out.push(node);
+            continue;
+        }
+        const itensFiltrados = filtrarMenuPorAcesso(node.itens, ctx);
+        if (itensFiltrados.length > 0)
+            out.push({ tipo: 'grupo', titulo: node.titulo, itens: itensFiltrados });
+    }
+    return out;
+}
+const MENU_PRINCIPAL = [
+    menuItem('Minhas Páginas', { pagina: PAGINAS.minhasPaginas }),
+    menuItem('Fichas', { pagina: PAGINAS.fichas }),
+    menuItem('Personagens', { pagina: PAGINAS.personagens }),
+    menuItem('Jogue Agora!', { pagina: PAGINAS.jogo.jogador }),
+    menuItem('Assistir', { pagina: PAGINAS.assistir }),
+    menuItem('Sessão Ao Vivo', { pagina: PAGINAS.sessaoAovivo }),
+    menuItem('Hall', { pagina: PAGINAS.minhaPagina }),
+    menuItem('Definições', { pagina: PAGINAS.definicoes, params: { slug: [] } }),
+    menuItem('Dicas', { pagina: PAGINAS.dicas, params: { slug: [] } }),
+];
+const MENUS_INTERNOS = {
+    PAGINAS: {
+        jogo: [
+            menuGrupo('Administrador', [
+                menuItem('Salas', { pagina: PAGINAS.jogo.admin.gerenciarSalas }),
+            ]),
+            menuGrupo('Mestre', [
+                menuItem('Sessões', { pagina: PAGINAS.jogo.mestre.sessoesMestre }),
+            ]),
+            menuGrupo('Jogador', [
+                menuItem('Início', { pagina: PAGINAS.jogo.jogador }),
+            ]),
+        ],
+        minhasPaginas: {
+            menu: [
+                menuItem('Administrador', { pagina: PAGINAS.minhasPaginas.admin }),
+                menuItem('Moderador', { pagina: PAGINAS.minhasPaginas.moderador }),
+                menuItem('Mestre', { pagina: PAGINAS.minhasPaginas.mestre }),
+                menuItem('Artista', { pagina: PAGINAS.minhasPaginas.artista }),
+                menuItem('Jogador', { pagina: PAGINAS.minhasPaginas.jogador }),
+                menuItem('Disponibilidades', { pagina: PAGINAS.minhasPaginas.minhasDisponibilidades }),
+                menuItem('Configurações', { pagina: PAGINAS.minhasPaginas.minhasConfiguracoes }),
+            ],
+            admin: [
+                menuItem('Variáveis de Ambiente', { pagina: PAGINAS.minhasPaginas.admin.variaveisAmbiente }),
+                menuItem('Aventuras', { pagina: PAGINAS.minhasPaginas.admin.aventuras }),
+                menuItem('Dashboard WebSocket', { pagina: PAGINAS.minhasPaginas.admin.dashboardWs }),
+                menuGrupo('Permissões', [
+                    menuItem('Permissões', { pagina: PAGINAS.minhasPaginas.admin.dashboardPermissoes }),
+                    menuItem('Permissões de Usuários', { pagina: PAGINAS.minhasPaginas.admin.dashboardPermissoesUsuarios }),
+                ]),
+                menuGrupo('File Server', [
+                    menuItem('Deletar Arquivos por Caminho', { pagina: PAGINAS.minhasPaginas.admin.deletarArquivosAbsoluto }),
+                    menuItem('Deletar Arquivos', { pagina: PAGINAS.minhasPaginas.admin.deletarArquivosFileServer }),
+                    menuItem('Upload de Recursos Internos', { pagina: PAGINAS.minhasPaginas.admin.uploadRecursosInternos }),
+                ]),
+            ],
+            moderador: [
+                menuItem('Imagens pendentes de Aprovação', { pagina: PAGINAS.minhasPaginas.moderador.dashboardAprovacaoImagensArtista }),
+            ],
+            mestre: [
+                menuGrupo('Mestre', [
+                    menuItem('Início', { pagina: PAGINAS.minhasPaginas.mestre }),
+                ]),
+                menuGrupo('Relíquia', [
+                    menuGrupo('Aventuras', [
+                        menuItem('Minhas Aventuras', { pagina: PAGINAS.minhasPaginas.mestre.aventuras }),
+                        menuItem('Rascunhos de Aventuras', { pagina: PAGINAS.minhasPaginas.mestre.rascunhos.aventuras }),
+                    ]),
+                    menuItem('Personagens', { pagina: PAGINAS.minhasPaginas.mestre.personagens }),
+                ]),
+                menuGrupo('Criatura', [
+                    menuGrupo('Sessões Únicas', [
+                        menuItem('Minhas Sessões Únicas', { pagina: PAGINAS.minhasPaginas.mestre.sessoesUnicas }),
+                        menuItem('Rascunhos de Sessões Únicas', { pagina: PAGINAS.minhasPaginas.mestre.rascunhos.sessoesUnicas }),
+                    ]),
+                ]),
+                menuGrupo('Temporário', [
+                    menuItem('Consultar Disponibilidades', { pagina: PAGINAS.minhasPaginas.mestre.temporario.consultarDisponibilidades }),
+                    menuItem('Criar Sessões Únicas', { pagina: PAGINAS.minhasPaginas.mestre.temporario.criarSessaoUnica }),
+                ]),
+            ],
+            artista: [
+                menuItem('Minhas Imagens', { pagina: PAGINAS.minhasPaginas.artista.minhasImagens }),
+                menuItem('Adicionar Nova Imagem', { pagina: PAGINAS.minhasPaginas.artista.adicionarImagem }),
+                menuGrupo('Avatares', [
+                    menuItem('Gerenciar Avatares', { pagina: PAGINAS.minhasPaginas.artista.avatares.gerenciarAvatares }),
+                ]),
+                menuGrupo('Emblemas', [
+                    menuItem('Gerenciar Emblemas', { pagina: PAGINAS.minhasPaginas.artista.emblemas.gerenciarEmblemas }),
+                ]),
+            ],
+            jogador: [
+                menuGrupo('Jogador', [
+                    menuItem('Início', { pagina: PAGINAS.minhasPaginas.jogador }),
+                    menuItem('Meus Personagens', { pagina: PAGINAS.minhasPaginas.jogador.meusPersonagens }),
+                    menuItem('Minhas Fichas', { pagina: PAGINAS.minhasPaginas.jogador.minhasFichas }),
+                ]),
+            ],
+            minhasConfiguracoes: [
+                menuItem('Configurações', { pagina: PAGINAS.minhasPaginas.minhasConfiguracoes }),
+                menuItem('Passe de Jogador', { pagina: PAGINAS.minhasPaginas.minhasConfiguracoes.passeDeJogador }),
+            ],
+        },
+    },
+};
+const MENUS_INTERNOS_LAYOUTCONTEXTO = {
+    PAGINAS: {
+        assistir: menuDinamico(),
+        jogo: {
+            admin: {
+                gerenciarSalas: MENUS_INTERNOS.PAGINAS.jogo,
+            },
+            mestre: {
+                sessoesMestre: MENUS_INTERNOS.PAGINAS.jogo,
+            },
+            jogador: MENUS_INTERNOS.PAGINAS.jogo,
+        },
+        minhasPaginas: {
+            menu: MENUS_INTERNOS.PAGINAS.minhasPaginas.menu,
+            admin: {
+                menu: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+                aventura: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+                aventuras: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+                dashboardWs: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+                sessao: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+                variaveisAmbiente: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+                dashboardPermissoes: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+                dashboardPermissoesUsuarios: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+                deletarArquivosAbsoluto: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+                deletarArquivosFileServer: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+                uploadRecursosInternos: MENUS_INTERNOS.PAGINAS.minhasPaginas.admin,
+            },
+            moderador: {
+                menu: MENUS_INTERNOS.PAGINAS.minhasPaginas.moderador,
+                dashboardAprovacaoImagensArtista: MENUS_INTERNOS.PAGINAS.minhasPaginas.moderador,
+            },
+            mestre: {
+                menu: MENUS_INTERNOS.PAGINAS.minhasPaginas.mestre,
+                aventura: MENUS_INTERNOS.PAGINAS.minhasPaginas.mestre,
+                aventuras: MENUS_INTERNOS.PAGINAS.minhasPaginas.mestre,
+                sessoesUnicas: MENUS_INTERNOS.PAGINAS.minhasPaginas.mestre,
+                personagens: MENUS_INTERNOS.PAGINAS.minhasPaginas.mestre,
+                rascunhos: {
+                    aventuras: MENUS_INTERNOS.PAGINAS.minhasPaginas.mestre,
+                    sessoesUnicas: MENUS_INTERNOS.PAGINAS.minhasPaginas.mestre,
+                },
+                sessao: MENUS_INTERNOS.PAGINAS.minhasPaginas.mestre,
+                temporario: {
+                    consultarDisponibilidades: menuVazio(),
+                    criarSessaoUnica: menuVazio(),
+                },
+            },
+            artista: {
+                menu: MENUS_INTERNOS.PAGINAS.minhasPaginas.artista,
+                minhasImagens: MENUS_INTERNOS.PAGINAS.minhasPaginas.artista,
+                adicionarImagem: MENUS_INTERNOS.PAGINAS.minhasPaginas.artista,
+                avatares: {
+                    gerenciarAvatares: MENUS_INTERNOS.PAGINAS.minhasPaginas.artista,
+                },
+                emblemas: {
+                    gerenciarEmblemas: MENUS_INTERNOS.PAGINAS.minhasPaginas.artista,
+                },
+            },
+            jogador: {
+                menu: MENUS_INTERNOS.PAGINAS.minhasPaginas.jogador,
+                meusPersonagens: MENUS_INTERNOS.PAGINAS.minhasPaginas.jogador,
+                minhasFichas: MENUS_INTERNOS.PAGINAS.minhasPaginas.jogador,
+                criar: {
+                    ficha: menuVazio(),
+                    personagem: menuVazio(),
+                },
+            },
+            minhasDisponibilidades: menuVazio(),
+            minhasConfiguracoes: {
+                menu: MENUS_INTERNOS.PAGINAS.minhasPaginas.minhasConfiguracoes,
+                passeDeJogador: MENUS_INTERNOS.PAGINAS.minhasPaginas.minhasConfiguracoes,
+            },
+        },
+        fichas: menuDinamico(),
+        personagens: menuDinamico(),
+        sessoes: menuVazio(),
+    },
+};
+function isPaginaComLayout(node) { return 'layoutContextualizadoInicial' in node && 'template' in node; }
+function isMenuLeaf(node) {
+    if (Array.isArray(node))
+        return true;
+    if ('tipo' in node)
+        return true;
+    return false;
+}
+function getPaginaKey(pagina) { return String(pagina.template); }
+const MENUS_LAYOUTCONTEXTO_POR_PAGINA = (() => {
+    const out = new Map();
+    const rec = (paginasNode, menusNode) => {
+        if (isMenuLeaf(menusNode)) {
+            if (isPaginaComLayout(paginasNode))
+                out.set(getPaginaKey(paginasNode), menusNode);
+            return;
+        }
+        const menusObj = menusNode;
+        const paginasObj = paginasNode;
+        const menuDoProprioNo = menusObj.menu;
+        if (menuDoProprioNo && isMenuLeaf(menuDoProprioNo) && isPaginaComLayout(paginasNode))
+            out.set(getPaginaKey(paginasNode), menuDoProprioNo);
+        for (const k of Object.keys(menusObj)) {
+            if (k === 'menu')
+                continue;
+            const nextMenus = menusObj[k];
+            if (!nextMenus)
+                continue;
+            const nextPaginas = paginasObj[k];
+            if (!nextPaginas || typeof nextPaginas !== 'object')
+                continue;
+            rec(nextPaginas, nextMenus);
+        }
+    };
+    rec(PAGINAS, MENUS_INTERNOS_LAYOUTCONTEXTO.PAGINAS);
+    return out;
+})();
+function obterMenuInternoLayoutContexto(pagina) {
+    return MENUS_LAYOUTCONTEXTO_POR_PAGINA.get(getPaginaKey(pagina));
+}
+const MENUS_INTERNOS_POR_PAGINA = (() => {
+    const out = new Map();
+    function isObject(v) { return typeof v === 'object' && v !== null; }
+    function hasTemplate(v) { return isObject(v) && 'template' in v; }
+    function getKey(v, k) {
+        if (!isObject(v))
+            return undefined;
+        return v[k];
+    }
+    const rec = (paginasNode, menusNode) => {
+        if (Array.isArray(menusNode)) {
+            if (hasTemplate(paginasNode))
+                out.set(String(paginasNode.template), menusNode);
+            return;
+        }
+        if (!isObject(menusNode))
+            return;
+        for (const k of Object.keys(menusNode)) {
+            const nextPaginas = getKey(paginasNode, k);
+            const nextMenus = getKey(menusNode, k);
+            rec(nextPaginas ?? undefined, nextMenus ?? undefined);
+        }
+    };
+    rec(PAGINAS, MENUS_INTERNOS.PAGINAS);
+    return out;
+})();
+function obterMenuInterno(pagina) {
+    return MENUS_INTERNOS_POR_PAGINA.get(getPaginaKey(pagina));
+}
+function resolverMenuInterno(pagina) {
+    const nodes = obterMenuInterno(pagina);
+    if (!nodes)
+        return undefined;
+    const folhas = [];
+    const stack = [...nodes];
+    while (stack.length > 0) {
+        const cur = stack.pop();
+        if (cur.tipo === 'item')
+            folhas.push(cur.destino.pagina);
+        if (cur.tipo === 'grupo')
+            stack.push(...cur.itens);
+    }
+    return folhas;
+}
+export { MENUS_INTERNOS, MENUS_INTERNOS_LAYOUTCONTEXTO, MENUS_INTERNOS_POR_PAGINA, MENUS_LAYOUTCONTEXTO_POR_PAGINA, MENU_PRINCIPAL, filtrarMenuPorAcesso, getPaginaKey, isMenuLeaf, isPaginaComLayout, obterMenuInterno, obterMenuInternoLayoutContexto, resolverMenuInterno };

package/dist/paginas/index.d.ts

@@ -0,0 +1,172 @@
+import type { CtxAcesso } from '../acessos';
+import type { PaginaDef, PaginaTemplate, ParamsProps } from '../dtos';
+import type { AcessoPagina } from '../shared';
+type DecisaoAcessoPagina = {
+    permitido: true;
+} | {
+    permitido: false;
+    motivo: 'NAO_AUTENTICADO';
+    redirecionarPara: PaginaFolha;
+} | {
+    permitido: false;
+    motivo: 'SEM_CAPACIDADE';
+    redirecionarPara: PaginaFolha;
+};
+type ResolverMenuInterno = (pagina: PaginaFolha) => readonly PaginaFolha[] | undefined;
+type Opts = {
+    resolverMenuInterno?: ResolverMenuInterno;
+    redirectNaoAutenticado: PaginaFolha;
+    redirectSemCapacidade: PaginaFolha;
+};
+declare function decidirAcessoPagina(pagina: PaginaFolha, ctx: CtxAcesso, opts: Opts): DecisaoAcessoPagina;
+declare function decidirAcessoPagina_Rec(pagina: PaginaFolha, ctx: CtxAcesso, opts: Opts, visitados: Set<string>): DecisaoAcessoPagina;
+declare const PAGINAS: {
+    readonly home: PaginaDef<"/", import("../dtos").PaginaInfoBase>;
+    readonly acessar: PaginaDef<"/acessar", import("../dtos").PaginaInfoBase>;
+    readonly cadastrar: PaginaDef<"/cadastrar", import("../dtos").PaginaInfoBase>;
+    readonly definicoes: PaginaDef<"/definicoes/[[...slug]]", import("../dtos").PaginaInfoBase>;
+    readonly dicas: PaginaDef<"/dicas/[[...slug]]", import("../dtos").PaginaInfoBase>;
+    readonly jogo: {
+        readonly admin: {
+            readonly gerenciarSalas: PaginaDef<"/jogo/admin/gerenciar-salas", import("../dtos").PaginaInfoComLayoutContextualizado>;
+        };
+        readonly mestre: {
+            readonly sessoesMestre: PaginaDef<"/jogo/mestre/sessoes-mestre", import("../dtos").PaginaInfoComLayoutContextualizado>;
+        };
+        readonly jogador: PaginaDef<"/jogo/jogador", import("../dtos").PaginaInfoComLayoutContextualizado>;
+        readonly emJogo: PaginaDef<"/jogo/em-jogo", import("../dtos").PaginaInfoBase>;
+    };
+    readonly linhaDoTempo: PaginaDef<"/linha-do-tempo", import("../dtos").PaginaInfoBase>;
+    readonly minhaPagina: PaginaDef<"/minha-pagina", import("../dtos").PaginaInfoBase>;
+    readonly minhasPaginas: {
+        readonly admin: {
+            readonly aventura: PaginaDef<"/minhas-paginas/admin/aventura/[id]", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly aventuras: PaginaDef<"/minhas-paginas/admin/aventuras", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly dashboardWs: PaginaDef<"/minhas-paginas/admin/dashboard-ws", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly sessao: PaginaDef<"/minhas-paginas/admin/sessao/[id]", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly variaveisAmbiente: PaginaDef<"/minhas-paginas/admin/variaveis-ambiente", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly dashboardPermissoes: PaginaDef<"/minhas-paginas/admin/permissoes", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly dashboardPermissoesUsuarios: PaginaDef<"/minhas-paginas/admin/permissoes-usuarios", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly deletarArquivosAbsoluto: PaginaDef<"/minhas-paginas/admin/deletar-arquivos-absoluto", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly deletarArquivosFileServer: PaginaDef<"/minhas-paginas/admin/deletar-arquivos-file-server", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly uploadRecursosInternos: PaginaDef<"/minhas-paginas/admin/uploads-recursos-internos", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly label: string;
+            readonly comCabecalho?: true;
+            readonly acesso?: AcessoPagina;
+            readonly acessoPorMenuInterno?: true;
+            readonly layoutContextualizadoInicial: import("../dtos").LayoutContextualizadoInicial;
+            readonly template: PaginaTemplate<"/minhas-paginas/admin">;
+            readonly hrefTemplate: "/minhas-paginas/admin";
+            readonly href: "/minhas-paginas/admin";
+        };
+        readonly moderador: {
+            readonly dashboardAprovacaoImagensArtista: PaginaDef<"/minhas-paginas/moderador/aprovar-imagens-artista", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly label: string;
+            readonly comCabecalho?: true;
+            readonly acesso?: AcessoPagina;
+            readonly acessoPorMenuInterno?: true;
+            readonly layoutContextualizadoInicial: import("../dtos").LayoutContextualizadoInicial;
+            readonly template: PaginaTemplate<"/minhas-paginas/moderador">;
+            readonly hrefTemplate: "/minhas-paginas/moderador";
+            readonly href: "/minhas-paginas/moderador";
+        };
+        readonly mestre: {
+            readonly aventura: PaginaDef<"/minhas-paginas/mestre/aventura/[id]", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly aventuras: PaginaDef<"/minhas-paginas/mestre/aventuras", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly sessoesUnicas: PaginaDef<"/minhas-paginas/mestre/sessoes-unicas", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly personagens: PaginaDef<"/minhas-paginas/mestre/personagens", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly rascunhos: {
+                readonly aventuras: PaginaDef<"/minhas-paginas/mestre/rascunhos/aventuras", import("../dtos").PaginaInfoComLayoutContextualizado>;
+                readonly sessoesUnicas: PaginaDef<"/minhas-paginas/mestre/rascunhos/sessoes-unicas", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            };
+            readonly temporario: {
+                readonly consultarDisponibilidades: PaginaDef<"/minhas-paginas/mestre/consultar-disponibilidades", import("../dtos").PaginaInfoComLayoutContextualizado>;
+                readonly criarSessaoUnica: PaginaDef<"/minhas-paginas/mestre/criar-sessao-unica", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            };
+            readonly sessao: PaginaDef<"/minhas-paginas/mestre/sessao/[id]", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly label: string;
+            readonly comCabecalho?: true;
+            readonly acesso?: AcessoPagina;
+            readonly acessoPorMenuInterno?: true;
+            readonly layoutContextualizadoInicial: import("../dtos").LayoutContextualizadoInicial;
+            readonly template: PaginaTemplate<"/minhas-paginas/mestre">;
+            readonly hrefTemplate: "/minhas-paginas/mestre";
+            readonly href: "/minhas-paginas/mestre";
+        };
+        readonly artista: {
+            readonly minhasImagens: PaginaDef<"/minhas-paginas/artista/minhas-imagens", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly adicionarImagem: PaginaDef<"/minhas-paginas/artista/adicionar-imagem", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly avatares: {
+                readonly gerenciarAvatares: PaginaDef<"/minhas-paginas/artista/avatares", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            };
+            readonly emblemas: {
+                readonly gerenciarEmblemas: PaginaDef<"/minhas-paginas/artista/emblemas", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            };
+            readonly label: string;
+            readonly comCabecalho?: true;
+            readonly acesso?: AcessoPagina;
+            readonly acessoPorMenuInterno?: true;
+            readonly layoutContextualizadoInicial: import("../dtos").LayoutContextualizadoInicial;
+            readonly template: PaginaTemplate<"/minhas-paginas/artista">;
+            readonly hrefTemplate: "/minhas-paginas/artista";
+            readonly href: "/minhas-paginas/artista";
+        };
+        readonly jogador: {
+            readonly meusPersonagens: PaginaDef<"/minhas-paginas/jogador/meus-personagens", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly minhasFichas: PaginaDef<"/minhas-paginas/jogador/minhas-fichas", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly criar: {
+                readonly ficha: PaginaDef<"/minhas-paginas/jogador/criar/ficha", import("../dtos").PaginaInfoComLayoutContextualizado>;
+                readonly personagem: PaginaDef<"/minhas-paginas/jogador/criar/personagem", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            };
+            readonly label: string;
+            readonly comCabecalho?: true;
+            readonly acesso?: AcessoPagina;
+            readonly acessoPorMenuInterno?: true;
+            readonly layoutContextualizadoInicial: import("../dtos").LayoutContextualizadoInicial;
+            readonly template: PaginaTemplate<"/minhas-paginas/jogador">;
+            readonly hrefTemplate: "/minhas-paginas/jogador";
+            readonly href: "/minhas-paginas/jogador";
+        };
+        readonly minhasDisponibilidades: PaginaDef<"/minhas-paginas/minhas-disponibilidades", import("../dtos").PaginaInfoComLayoutContextualizado>;
+        readonly minhasConfiguracoes: {
+            readonly passeDeJogador: PaginaDef<"/minhas-paginas/minhas-configuracoes/passe-de-jogador", import("../dtos").PaginaInfoComLayoutContextualizado>;
+            readonly label: string;
+            readonly comCabecalho?: true;
+            readonly acesso?: AcessoPagina;
+            readonly acessoPorMenuInterno?: true;
+            readonly layoutContextualizadoInicial: import("../dtos").LayoutContextualizadoInicial;
+            readonly template: PaginaTemplate<"/minhas-paginas/minhas-configuracoes">;
+            readonly hrefTemplate: "/minhas-paginas/minhas-configuracoes";
+            readonly href: "/minhas-paginas/minhas-configuracoes";
+        };
+        readonly label: string;
+        readonly comCabecalho?: true;
+        readonly acesso?: AcessoPagina;
+        readonly acessoPorMenuInterno?: true;
+        readonly layoutContextualizadoInicial: import("../dtos").LayoutContextualizadoInicial;
+        readonly template: PaginaTemplate<"/minhas-paginas">;
+        readonly hrefTemplate: "/minhas-paginas";
+        readonly href: "/minhas-paginas";
+    };
+    readonly fichas: PaginaDef<"/fichas", import("../dtos").PaginaInfoComLayoutContextualizado>;
+    readonly personagens: PaginaDef<"/personagens", import("../dtos").PaginaInfoComLayoutContextualizado>;
+    readonly sessoes: PaginaDef<"/sessoes", import("../dtos").PaginaInfoComLayoutContextualizado>;
+    readonly sessaoAovivo: PaginaDef<"/sessao-aovivo", import("../dtos").PaginaInfoBase>;
+    readonly assistir: PaginaDef<"/assistir", import("../dtos").PaginaInfoComLayoutContextualizado>;
+};
+type Folhas<T> = T extends PaginaDef<string> ? T | Folhas<Omit<T, keyof PaginaDef<string>>> : T extends readonly (infer U)[] ? Folhas<U> : T extends object ? {
+    [K in keyof T]-?: Folhas<NonNullable<T[K]>>;
+}[keyof T] : never;
+type PaginaFolha = Folhas<typeof PAGINAS>;
+type PaginaTemplateFolha = PaginaFolha['template'];
+type PaginaDestino = PaginaFolha extends infer P ? P extends PaginaFolha ? {
+    pagina: P;
+} & ParamsProps<P> : never : never;
+type PaginaDestinoPagina<P extends PaginaFolha> = {
+    pagina: P;
+} & ParamsProps<P>;
+type PaginaHrefTemplate = PaginaFolha['hrefTemplate'];
+type PaginaHref = PaginaFolha['href'];
+type PaginaDefAny = PaginaDef<string>;
+type PaginaTemplateAny = PaginaTemplate<string>;
+export { DecisaoAcessoPagina, Folhas, Opts, PAGINAS, PaginaDefAny, PaginaDestino, PaginaDestinoPagina, PaginaFolha, PaginaHref, PaginaHrefTemplate, PaginaTemplateAny, PaginaTemplateFolha, ResolverMenuInterno, decidirAcessoPagina, decidirAcessoPagina_Rec };

package/dist/paginas/index.js

@@ -0,0 +1,137 @@
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Contratos de páginas
+import { temSudoBurlarCapacidades } from '../acessos';
+import { CAPACIDADES } from '../dominio';
+import { pagina, paginaComLayoutContextualizado } from '../dtos';
+/*
+  SSOT: regra de acesso única, usada por:
+  - ControladorSlot (bloqueio/redirect)
+  - Menu principal (filtrar itens antes de render)
+  - Menus internos (filtrar itens antes de render)
+*/
+function decidirAcessoPagina(pagina, ctx, opts) {
+    const visitados = new Set();
+    return decidirAcessoPagina_Rec(pagina, ctx, opts, visitados);
+}
+function decidirAcessoPagina_Rec(pagina, ctx, opts, visitados) {
+    const key = String(pagina.template);
+    if (visitados.has(key))
+        return { permitido: true };
+    visitados.add(key);
+    const acesso = pagina.acesso;
+    if (acesso != null && 'cadastroPermitido' in acesso) {
+        if (!ctx.cadastroPermitido)
+            return { permitido: false, motivo: 'NAO_AUTENTICADO', redirecionarPara: opts.redirectNaoAutenticado };
+    }
+    if (acesso != null && 'listaDeCapacidadesNecessarias' in acesso) {
+        if (!ctx.estaAutenticado)
+            return { permitido: false, motivo: 'NAO_AUTENTICADO', redirecionarPara: opts.redirectNaoAutenticado };
+        if (temSudoBurlarCapacidades(ctx))
+            return { permitido: true };
+        const lista = acesso.listaDeCapacidadesNecessarias;
+        const permitido = Array.isArray(lista) && lista.length > 0 && lista.every((cap) => ctx.verificarCapacidade(cap));
+        if (!permitido)
+            return { permitido: false, motivo: 'SEM_CAPACIDADE', redirecionarPara: opts.redirectSemCapacidade };
+    }
+    if (acesso != null && 'autenticado' in acesso) {
+        if (!ctx.estaAutenticado)
+            return { permitido: false, motivo: 'NAO_AUTENTICADO', redirecionarPara: opts.redirectNaoAutenticado };
+    }
+    if (pagina.acessoPorMenuInterno === true) {
+        if (!ctx.estaAutenticado)
+            return { permitido: false, motivo: 'NAO_AUTENTICADO', redirecionarPara: opts.redirectNaoAutenticado };
+        if (temSudoBurlarCapacidades(ctx))
+            return { permitido: true };
+        const folhas = (opts.resolverMenuInterno?.(pagina) ?? []).filter((p) => String(p.template) !== String(pagina.template));
+        const permitido = folhas.some((p) => decidirAcessoPagina_Rec(p, ctx, opts, visitados).permitido);
+        if (!permitido)
+            return { permitido: false, motivo: 'SEM_CAPACIDADE', redirecionarPara: opts.redirectSemCapacidade };
+    }
+    return { permitido: true };
+}
+const PAGINAS = {
+    home: pagina('/', { label: 'Página Inicial', comCabecalho: true }),
+    acessar: pagina('/acessar', { label: 'Acessar' }),
+    cadastrar: pagina('/cadastrar', { label: 'Cadastrar', acesso: { cadastroPermitido: true } }),
+    definicoes: pagina('/definicoes/[[...slug]]', { label: 'Definições', comCabecalho: true }),
+    dicas: pagina('/dicas/[[...slug]]', { label: 'Dicas', comCabecalho: true }),
+    jogo: {
+        admin: {
+            gerenciarSalas: paginaComLayoutContextualizado('/jogo/admin/gerenciar-salas', { label: 'Admin - Gerenciar Salas', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__ACOMPANHAMENTO__SESSAO_DE_JOGO] } }, { titulo: 'Gerenciar Salas', proporcaoConteudo: 84 }),
+        },
+        mestre: {
+            sessoesMestre: paginaComLayoutContextualizado('/jogo/mestre/sessoes-mestre', { label: 'Mestre - Sessões', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MESTRE__CRIACAO__SESSAO_DE_JOGO] } }, { titulo: 'Criação de Sala', proporcaoConteudo: 84 }),
+        },
+        jogador: paginaComLayoutContextualizado('/jogo/jogador', { label: 'Jogo - Jogador', acesso: { autenticado: true } }, { titulo: null, proporcaoConteudo: 84 }),
+        emJogo: pagina('/jogo/em-jogo', { label: 'Em Jogo', acesso: { autenticado: true } }),
+    },
+    linhaDoTempo: pagina('/linha-do-tempo', { label: 'Linha do Tempo' }),
+    minhaPagina: pagina('/minha-pagina', { label: 'Minha Página', acesso: { autenticado: true } }),
+    minhasPaginas: {
+        ...paginaComLayoutContextualizado('/minhas-paginas', { label: 'Minhas Paginas', acesso: { autenticado: true } }, { titulo: 'Minhas Paginas', proporcaoConteudo: 84 }),
+        admin: {
+            ...paginaComLayoutContextualizado('/minhas-paginas/admin', { label: 'Administração', acesso: { autenticado: true }, acessoPorMenuInterno: true }, { titulo: 'Página de Administrador', proporcaoConteudo: 84 }),
+            aventura: paginaComLayoutContextualizado('/minhas-paginas/admin/aventura/[id]', { label: 'Admin - Aventura', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__GERENCIAMENTO__AVENTURAS_E_SESSOES] } }, { titulo: 'TROCA', proporcaoConteudo: 84 }),
+            aventuras: paginaComLayoutContextualizado('/minhas-paginas/admin/aventuras', { label: 'Admin - Aventuras', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__GERENCIAMENTO__AVENTURAS_E_SESSOES] } }, { titulo: 'Gerenciamento de Aventuras', proporcaoConteudo: 84 }),
+            dashboardWs: paginaComLayoutContextualizado('/minhas-paginas/admin/dashboard-ws', { label: 'Admin - Dashboard WS', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__ACOMPANHAMENTO__WEBSOCKET] } }, { titulo: 'Dashboard: WebSocket', proporcaoConteudo: 84 }),
+            sessao: paginaComLayoutContextualizado('/minhas-paginas/admin/sessao/[id]', { label: 'Admin - Sessão', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__GERENCIAMENTO__AVENTURAS_E_SESSOES] } }, { titulo: 'Gerenciamento de Sessão', proporcaoConteudo: 84 }),
+            variaveisAmbiente: paginaComLayoutContextualizado('/minhas-paginas/admin/variaveis-ambiente', { label: 'Admin - Variáveis de Ambiente', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__GERENCIAMENTO__VARIAVEIS_DE_AMBIENTE] } }, { titulo: 'Variáveis de Ambiente', proporcaoConteudo: 84 }),
+            dashboardPermissoes: paginaComLayoutContextualizado('/minhas-paginas/admin/permissoes', { label: 'Admin - Permissões', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__PERMISSOES__CRIACAO_CAPACIDADES] } }, { titulo: 'Gerenciamento de Permissões', proporcaoConteudo: 84 }),
+            dashboardPermissoesUsuarios: paginaComLayoutContextualizado('/minhas-paginas/admin/permissoes-usuarios', { label: 'Admin - Permissões de Usuários', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__PERMISSOES__ALTERACAO_CAPACIDADES_GERAIS_USUARIOS] } }, { titulo: 'Permissões de Usuário', proporcaoConteudo: 84 }),
+            deletarArquivosAbsoluto: paginaComLayoutContextualizado('/minhas-paginas/admin/deletar-arquivos-absoluto', { label: 'Admin - Deletar Arquivos SUDO', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__SUDO__DELETAR_ARQUIVOS_FILE_SERVER] } }, { titulo: 'Deletar Arquivos', proporcaoConteudo: 84 }),
+            deletarArquivosFileServer: paginaComLayoutContextualizado('/minhas-paginas/admin/deletar-arquivos-file-server', { label: 'Admin - Deletar Arquivos', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__SUDO__DELETAR_ARQUIVOS_FILE_SERVER] } }, { titulo: 'Deletar Arquivos', proporcaoConteudo: 84 }),
+            uploadRecursosInternos: paginaComLayoutContextualizado('/minhas-paginas/admin/uploads-recursos-internos', { label: 'Admin - Uploads', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ADMINISTRADOR__GERENCIAMENTO__UPLOAD_RECURSOS_INTERNOS] } }, { titulo: 'Upload de Recursos Internos', proporcaoConteudo: 84 }),
+        },
+        moderador: {
+            ...paginaComLayoutContextualizado('/minhas-paginas/moderador', { label: 'Área do Moderador', acesso: { autenticado: true }, acessoPorMenuInterno: true }, { titulo: 'Página de Moderador', proporcaoConteudo: 84 }),
+            dashboardAprovacaoImagensArtista: paginaComLayoutContextualizado('/minhas-paginas/moderador/aprovar-imagens-artista', { label: 'Aprovar Imagens de Artistas', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MODERADOR__IMAGENS] } }, { titulo: 'Aprovar Imagens de Artistas', proporcaoConteudo: 84 }),
+        },
+        mestre: {
+            ...paginaComLayoutContextualizado('/minhas-paginas/mestre', { label: 'Área do Mestre', acessoPorMenuInterno: true }, { titulo: 'Página de Mestre', proporcaoConteudo: 84 }),
+            aventura: paginaComLayoutContextualizado('/minhas-paginas/mestre/aventura/[id]', { label: 'Mestre - Aventura', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MESTRE__CRIACAO__AVENTURA] } }, { titulo: 'TROCAR', proporcaoConteudo: 84 }),
+            aventuras: paginaComLayoutContextualizado('/minhas-paginas/mestre/aventuras', { label: 'Mestre - Aventuras', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MESTRE__CRIACAO__AVENTURA] } }, { titulo: 'Minhas Aventuras', proporcaoConteudo: 84 }),
+            sessoesUnicas: paginaComLayoutContextualizado('/minhas-paginas/mestre/sessoes-unicas', { label: 'Mestre - Sessões Únicas', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MESTRE__CRIACAO__SESSAO_DE_JOGO] } }, { titulo: 'Minhas Sessões Únicas', proporcaoConteudo: 84 }),
+            personagens: paginaComLayoutContextualizado('/minhas-paginas/mestre/personagens', { label: 'Mestre - Personagens', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MESTRE__CRIACAO__AVENTURA] } }, { titulo: 'Meus Personagens de Mestre', proporcaoConteudo: 84 }),
+            rascunhos: {
+                aventuras: paginaComLayoutContextualizado('/minhas-paginas/mestre/rascunhos/aventuras', { label: 'Rascunhos - Aventuras', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MESTRE__CRIACAO__RASCUNHO_AVENTURA] } }, { titulo: 'Meus Rascunhos de Aventuras', proporcaoConteudo: 84 }),
+                sessoesUnicas: paginaComLayoutContextualizado('/minhas-paginas/mestre/rascunhos/sessoes-unicas', { label: 'Rascunhos - Sessões Únicas', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MESTRE__CRIACAO__RASCUNHO_SESSAO_UNICA] } }, { titulo: 'Meus Rascunhos de Sessões Únicas', proporcaoConteudo: 84 }),
+            },
+            temporario: {
+                consultarDisponibilidades: paginaComLayoutContextualizado('/minhas-paginas/mestre/consultar-disponibilidades', { label: 'Consultando Disponibilidades', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MESTRE__CRIACAO__SESSAO_DE_JOGO] } }, { titulo: 'Consultando Disponibilidades', proporcaoConteudo: 100 }),
+                criarSessaoUnica: paginaComLayoutContextualizado('/minhas-paginas/mestre/criar-sessao-unica', { label: 'Criando Sessão Única', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MESTRE__CRIACAO__SESSAO_DE_JOGO] } }, { titulo: 'Criando Sessão Única', proporcaoConteudo: 100 }),
+            },
+            sessao: paginaComLayoutContextualizado('/minhas-paginas/mestre/sessao/[id]', { label: 'Mestre - Sessão', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.MESTRE__CRIACAO__SESSAO_DE_JOGO] } }, { titulo: 'TROCAR', proporcaoConteudo: 84 }),
+        },
+        artista: {
+            ...paginaComLayoutContextualizado('/minhas-paginas/artista', { label: 'Área do Artista', acesso: { autenticado: true }, acessoPorMenuInterno: true }, { titulo: 'Página de Artista', proporcaoConteudo: 84 }),
+            minhasImagens: paginaComLayoutContextualizado('/minhas-paginas/artista/minhas-imagens', { label: 'Minhas Imagens', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ARTISTA__CRIACAO__UPLOAD_IMAGEM] } }, { titulo: 'Minhas Imagens', proporcaoConteudo: 84 }),
+            adicionarImagem: paginaComLayoutContextualizado('/minhas-paginas/artista/adicionar-imagem', { label: 'Adicionar Imagem', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ARTISTA__CRIACAO__UPLOAD_IMAGEM] } }, { titulo: 'Adicionar Nova Imagem', proporcaoConteudo: 84 }),
+            avatares: {
+                gerenciarAvatares: paginaComLayoutContextualizado('/minhas-paginas/artista/avatares', { label: 'Gerenciar Avatares', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ARTISTA__CRIACAO__RESPONSABILIDADES__AVATARES] } }, { titulo: 'Gerenciar Avatares', proporcaoConteudo: 84 }),
+            },
+            emblemas: {
+                gerenciarEmblemas: paginaComLayoutContextualizado('/minhas-paginas/artista/emblemas', { label: 'Gerenciar Emblemas', acesso: { listaDeCapacidadesNecessarias: [CAPACIDADES.ARTISTA__CRIACAO__RESPONSABILIDADES__EMBLEMAS] } }, { titulo: 'Gerenciar Emblemas', proporcaoConteudo: 84 }),
+            },
+        },
+        jogador: {
+            ...paginaComLayoutContextualizado('/minhas-paginas/jogador', { label: 'Área do Jogador', acesso: { autenticado: true }, acessoPorMenuInterno: true }, { titulo: 'Página de Jogador', proporcaoConteudo: 84 }),
+            meusPersonagens: paginaComLayoutContextualizado('/minhas-paginas/jogador/meus-personagens', { label: 'Meus Personagens', acesso: { autenticado: true } }, { titulo: 'Meus Personagens', proporcaoConteudo: 84 }),
+            minhasFichas: paginaComLayoutContextualizado('/minhas-paginas/jogador/minhas-fichas', { label: 'Minhas Fichas', acesso: { autenticado: true } }, { titulo: 'Minhas Fichas', proporcaoConteudo: 84 }),
+            criar: {
+                ficha: paginaComLayoutContextualizado('/minhas-paginas/jogador/criar/ficha', { label: 'Criando Ficha', acesso: { autenticado: true } }, { titulo: 'Criando Ficha', proporcaoConteudo: 100 }),
+                personagem: paginaComLayoutContextualizado('/minhas-paginas/jogador/criar/personagem', { label: 'Criando Personagem', acesso: { autenticado: true } }, { titulo: 'Criando Personagem', proporcaoConteudo: 100 }),
+            },
+        },
+        minhasDisponibilidades: paginaComLayoutContextualizado('/minhas-paginas/minhas-disponibilidades', { label: 'Minhas Disponibilidades', acesso: { autenticado: true } }, { titulo: 'Minhas Disponibilidades', proporcaoConteudo: 100 }),
+        minhasConfiguracoes: {
+            ...paginaComLayoutContextualizado('/minhas-paginas/minhas-configuracoes', { label: 'Minhas Configurações', acesso: { autenticado: true } }, { titulo: 'Minhas Configurações', proporcaoConteudo: 84 }),
+            passeDeJogador: paginaComLayoutContextualizado('/minhas-paginas/minhas-configuracoes/passe-de-jogador', { label: 'Meu Passe de Jogador', acesso: { autenticado: true } }, { titulo: 'Meu Passe de Jogador', proporcaoConteudo: 84 }),
+        }
+    },
+    fichas: paginaComLayoutContextualizado('/fichas', { label: 'Fichas', acesso: { autenticado: true } }, { titulo: 'Minhas Fichas', proporcaoConteudo: 84 }),
+    personagens: paginaComLayoutContextualizado('/personagens', { label: 'Personagens', acesso: { autenticado: true } }, { titulo: 'Meus Personagens', proporcaoConteudo: 84 }),
+    sessoes: paginaComLayoutContextualizado('/sessoes', { label: 'Sessões' }, { titulo: 'TROCA', proporcaoConteudo: 100 }),
+    sessaoAovivo: pagina('/sessao-aovivo', { label: 'Sessão Ao Vivo', acesso: { autenticado: true } }),
+    assistir: paginaComLayoutContextualizado('/assistir', { label: 'Assistir' }, { titulo: 'Assistir', proporcaoConteudo: 80 }),
+};
+export { PAGINAS, decidirAcessoPagina, decidirAcessoPagina_Rec };