> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Ejemplo completo

> Todos los archivos de la plantilla inicial, exactamente como se crean.

Abajo están **todos los archivos** que DoglyTdc crea para un script de tipo Tampermonkey llamado "Meu Script", con acceso gratis y protección activada. Es exactamente lo que ves en el repositorio justo después de crearlo. Los archivos de la plantilla están en portugués.

### `doglytdc.json`

```json theme={null}
{
  "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`

```js theme={null}
// ==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`

```js theme={null}
// 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`

```js theme={null}
// 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`

```js theme={null}
// 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`

```js theme={null}
// 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`

```js theme={null}
// 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`

````markdown theme={null}
# 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`

```markdown theme={null}
# 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`

```markdown theme={null}
# 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`

```markdown theme={null}
# Meu Script

Exemplo de script

Categoria: Tampermonkey

Veja SKILL.md e docs/.
```

### `supabase/functions/hello.js`

```js theme={null}
function handler(request) {
  return doglytdc.respond(200, { ok: true, message: "Olá do DoglyTdc", method: request.method });
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.