doglytdc.json
{
"name": "Meu Script",
"description": "Exemplo de script",
"category": "tampermonkey",
"platforms": [],
"access": "free",
"protection": true,
"logo": null,
"entry": "src/script.js",
"version": "0.1.0"
}
src/script.js
// ==UserScript==
// @name Meu Script
// @version 0.1.0
// @match *://*/*
// @grant none
// ==/UserScript==
// Meu Script — entrada do script (DoglyTdc Scripts).
// Monta botão + popup + card dentro de um Shadow DOM, usando o tema de ./ui/theme.js.
const css = require("./ui/styles.js");
const createButton = require("./ui/button.js");
const createPopup = require("./ui/popup.js");
const createCard = require("./ui/card.js");
(function start() {
if (window.__DTS_MEU_SCRIPT__) return; // não monta duas vezes
window.__DTS_MEU_SCRIPT__ = true;
const host = document.createElement("div");
host.setAttribute("data-doglytdc-script", "Meu Script");
const root = host.attachShadow({ mode: "open" });
const style = document.createElement("style");
style.textContent = css;
root.appendChild(style);
(document.body || document.documentElement).appendChild(host);
const ds = window.DoglyScript || {}; // versão, configuração remota e envio de erros (vem do DoglyTdc)
const popup = createPopup(root, { title: "Meu Script" });
popup.body.appendChild(createCard({
title: "Pronto para usar",
text: (ds.config && ds.config.welcome) || "Edite src/script.js para colocar a função do seu script.",
actions: [{ label: "Executar", onClick: () => run(popup) }],
}));
createButton(root, popup.toggle);
function run(p) {
try {
// >>> coloque aqui o que o script faz <<<
p.body.appendChild(createCard({ title: "Feito", text: "Ação executada em " + location.hostname }));
} catch (e) {
if (ds.reportError) ds.reportError(e);
throw e;
}
}
})();
src/ui/theme.js
// Tema do card, do popup e do botão. Único lugar para trocar cores e formatos.
// O editor visual do painel grava este arquivo num commit.
module.exports = {
"radius": 16,
"font": "system-ui, sans-serif",
"card": {
"style": "glass"
},
"popup": {
"position": "center",
"width": 380
},
"button": {
"shape": "pill",
"position": "bottom-right",
"label": "Abrir"
},
"preset": "doglytdc",
"colors": {
"bg": "#0b0712",
"surface": "#171022",
"text": "#f5f3ff",
"muted": "#a59fb8",
"accent": "#8b5cf6",
"accent2": "#c084fc",
"border": "#2c2240"
}
};
src/ui/styles.js
// CSS do card/popup/botão gerado a partir do tema. Fica dentro de um Shadow DOM: não vaza para o site.
const t = require("./theme.js");
const c = t.colors;
const surface = t.card.style === "glass" ? c.surface + "cc" : t.card.style === "outline" ? "transparent" : c.surface;
const radius = { pill: "999px", rounded: t.radius + "px", square: "4px" }[t.button.shape];
const pos = { "bottom-right": "right:20px;bottom:20px", "bottom-left": "left:20px;bottom:20px", "top-right": "right:20px;top:20px" }[t.button.position];
const place = { center: "align-items:center;justify-content:center", right: "align-items:stretch;justify-content:flex-end", bottom: "align-items:flex-end;justify-content:center" }[t.popup.position];
module.exports = `
:host{all:initial}
*{box-sizing:border-box;font-family:${t.font}}
.dts-button{position:fixed;${pos};z-index:2147483646;padding:10px 18px;border:1px solid ${c.border};border-radius:${radius};background:linear-gradient(135deg,${c.accent},${c.accent2});color:${c.bg};font-weight:700;cursor:pointer;box-shadow:0 8px 24px ${c.accent}55;transition:transform .2s}
.dts-button:hover{transform:translateY(-2px)}
.dts-button:focus-visible,.dts-action:focus-visible,.dts-close:focus-visible{outline:2px solid ${c.accent2};outline-offset:2px}
.dts-overlay{position:fixed;inset:0;z-index:2147483647;display:flex;${place};padding:16px;background:#0008}
.dts-overlay[hidden]{display:none}
.dts-popup{width:min(${t.popup.width}px,100%);max-height:85vh;overflow:auto;background:${c.bg};color:${c.text};border:1px solid ${c.border};border-radius:${t.radius}px;box-shadow:0 24px 64px #000a}
.dts-popup__head{display:flex;align-items:center;justify-content:space-between;padding:14px 16px;border-bottom:1px solid ${c.border}}
.dts-close{width:32px;height:32px;border:0;border-radius:8px;background:transparent;color:${c.muted};font-size:20px;cursor:pointer}
.dts-popup__body{display:grid;gap:12px;padding:16px}
.dts-card{padding:14px;border:1px solid ${c.border};border-radius:${Math.max(4, t.radius - 4)}px;background:${surface}}
.dts-card__title{margin:0 0 6px;font-size:15px;color:${c.text}}
.dts-card__text{margin:0;font-size:13px;line-height:1.5;color:${c.muted}}
.dts-card__actions{display:flex;gap:8px;margin-top:12px}
.dts-action{padding:8px 12px;border:1px solid ${c.border};border-radius:10px;background:${c.accent};color:${c.bg};font-weight:600;cursor:pointer}
@media (prefers-reduced-motion:reduce){.dts-button{transition:none}}
`;
src/ui/button.js
// Botão flutuante que abre o popup. Usa só o tema (./theme.js).
const theme = require("./theme.js");
module.exports = function createButton(root, onClick) {
const b = document.createElement("button");
b.type = "button";
b.className = "dts-button dts-button--" + theme.button.shape + " dts-pos--" + theme.button.position;
b.textContent = theme.button.label;
b.setAttribute("aria-label", theme.button.label);
b.addEventListener("click", onClick);
root.appendChild(b);
return b;
};
src/ui/popup.js
// Popup: janela do script. Fecha no X, no Esc e clicando fora.
const theme = require("./theme.js");
module.exports = function createPopup(root, { title }) {
const overlay = document.createElement("div");
overlay.className = "dts-overlay dts-overlay--" + theme.popup.position;
overlay.hidden = true;
const box = document.createElement("div");
box.className = "dts-popup";
box.setAttribute("role", "dialog");
box.setAttribute("aria-modal", "true");
box.setAttribute("aria-label", title);
const head = document.createElement("header");
head.className = "dts-popup__head";
const h = document.createElement("strong");
h.textContent = title;
const close = document.createElement("button");
close.type = "button";
close.className = "dts-close";
close.setAttribute("aria-label", "Fechar");
close.textContent = "×";
head.append(h, close);
const body = document.createElement("div");
body.className = "dts-popup__body";
box.append(head, body);
overlay.appendChild(box);
root.appendChild(overlay);
const api = {
body,
open() { overlay.hidden = false; close.focus(); },
close() { overlay.hidden = true; },
toggle() { overlay.hidden ? api.open() : api.close(); },
};
close.addEventListener("click", api.close);
overlay.addEventListener("click", (e) => { if (e.target === overlay) api.close(); });
root.addEventListener("keydown", (e) => { if (e.key === "Escape") api.close(); });
return api;
};
src/ui/card.js
// Card: bloco de conteúdo dentro do popup (título, texto e ações).
module.exports = function createCard({ title, text, actions }) {
const card = document.createElement("section");
card.className = "dts-card";
const h = document.createElement("h3");
h.className = "dts-card__title";
h.textContent = title;
const p = document.createElement("p");
p.className = "dts-card__text";
p.textContent = text || "";
card.append(h, p);
if (actions && actions.length) {
const row = document.createElement("div");
row.className = "dts-card__actions";
for (const a of actions) {
const btn = document.createElement("button");
btn.type = "button";
btn.className = "dts-action";
btn.textContent = a.label;
btn.addEventListener("click", a.onClick);
row.appendChild(btn);
}
card.appendChild(row);
}
return card;
};
docs/CARD.md
# Card, popup e botão
O script já nasce com três peças, todas em `src/ui/` e todas pintadas pelo tema `src/ui/theme.js`:
| Peça | Arquivo | O que faz |
|---|---|---|
| Botão | `button.js` | Botão flutuante que abre e fecha o popup |
| Popup | `popup.js` | Janela do script (fecha no X, Esc e clique fora) |
| Card | `card.js` | Bloco com título, texto e ações dentro do popup |
| Estilo | `styles.js` | CSS gerado do tema, dentro de um Shadow DOM |
## Tema (formato)
```js
{ preset, colors: { bg, surface, text, muted, accent, accent2, border },
radius, font,
card: { style: "glass" | "solid" | "outline" },
popup: { position: "center" | "right" | "bottom", width: 280..640 },
button: { shape: "pill" | "rounded" | "square", position: "bottom-right" | "bottom-left" | "top-right", label } }
```
Troque cores e formatos só em `theme.js` (ou no editor visual do painel). As outras peças leem dele.
## Criar um card novo
```js
popup.body.appendChild(createCard({ title: "Título", text: "Texto", actions: [{ label: "Ok", onClick() {} }] }));
```
## Não quebre
- Mantenha tudo dentro do Shadow DOM (`root`): o CSS do site não entra e o seu não vaza.
- Use `textContent`, nunca `innerHTML` com texto do site.
- Classes começam com `dts-`.
docs/POPUP.md
# Popup
- `createPopup(root, { title })` devolve `{ body, open(), close(), toggle() }`.
- Posição e largura vêm de `theme.popup`.
- Acessível: `role="dialog"`, `aria-modal`, foco no botão Fechar ao abrir, Esc fecha.
- Para várias telas, limpe `popup.body` (`popup.body.replaceChildren()`) e monte os cards de novo.
SKILL.md
# Skill: criar scripts no DoglyTdc Scripts
## Estrutura
- `doglytdc.json`: nome, categoria, plataformas, acesso, proteção, entrada.
- `src/script.js`: entrada. Módulos com `require("./arquivo.js")` e `module.exports`; o DoglyTdc junta tudo na publicação.
- `src/ui/`: botão, popup, card, estilo e tema (veja docs/CARD.md e docs/POPUP.md).
- `supabase/functions/<nome>.js`: funções do script (`function handler(request)`, síncrona; use `doglytdc.respond(status, body)`, `doglytdc.db.collection(n)`, `doglytdc.ai.chat`, `doglytdc.fetch`).
- `supabase/collections.json`: coleções e regras.
## Categorias aceitas (só estas)
| Categoria | Onde roda | Limites |
|---|---|---|
| Bookmark/Console (`bookmark`) | Favorito do navegador ou colado no console (F12). | Sites com CSP rígida podem bloquear; não roda sozinho ao abrir a página. |
| Tampermonkey (`tampermonkey`) | Userscript no Tampermonkey/Violentmonkey; roda sozinho nos sites do @match. | Precisa da extensão instalada; GM_* só com @grant. |
| Extensão (`extension`) | Extensão Chrome/Edge (Manifest V3). | Sem código remoto nem eval; a instalação é descompactada ou pela loja. |
| Terminal (`terminal`) | Comando de terminal (bash/PowerShell). | Roda com as permissões de quem executa; sem card na página. |
| App (`app`) | Aplicativo para baixar: Windows, Linux, Android ou iOS. | Cada plataforma tem pacote próprio; iOS exige assinatura da Apple. |
| Bot Discord (`discord_bot`) | Bot hospedado no DoglyTdc: comandos /, seletores, botões e formulários no seu servidor. | Responde a comandos, seletores e botões; não fica lendo todas as mensagens do chat. Precisa de um aplicativo no Discord Developer Portal. |
## Aplicar o tema
1. Leia `src/ui/theme.js`.
2. Mude só esse arquivo para cores/formatos; nunca escreva cores fixas nos outros arquivos.
3. Novos elementos usam classes `dts-*` declaradas em `styles.js` com as variáveis do tema.
## Ambiente em tempo de execução
`window.DoglyScript = { version, config, reportError(err) }`: `config` é a configuração remota do painel.
## Fluxo de trabalho
1. Crie uma branch, faça commits pequenos com mensagem clara.
2. Peça a mesclagem para a main (o servidor recusa conflitos).
3. Publique uma versão (número x.y.z + notas). Com proteção ligada, o pacote é entregue só criptografado e só para quem tem acesso.
## Modelos de função
- `hello`: Resposta simples
- `save`: Salvar dado
- `ai`: Chamar IA
- `access`: Verificar acesso
## Regras
- Nunca use `eval` com texto do site, nunca `innerHTML` com dados externos.
- Não colete senhas ou tokens da página.
- Respeite `prefers-reduced-motion`.
README.md
# Meu Script
Exemplo de script
Categoria: Tampermonkey
Veja SKILL.md e docs/.
supabase/functions/hello.js
function handler(request) {
return doglytdc.respond(200, { ok: true, message: "Olá do DoglyTdc", method: request.method });
}

