> ## 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.

# Full example

> Every file in the starter template, exactly as it is created.

Below are **all the files** DoglyTdc creates for a Tampermonkey script called "Meu Script", with free access and protection on. It is exactly what you see in the repository right after creating it. The template files are written in Portuguese.

### `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.