Skip to content

About

Suite com 8 Scripts Profissionais ES3 para Adobe Illustrator: Grid Brockmann, BentoGrid, Color Shuffler, QR Pro (PIX), Nuvem de Palavras, Halftone, Block Text e Guias de Margem

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🎨 Suíte de Scripts Profissionais para Adobe Illustrator (Gold Standard Edition)

ExtendScript ES3 Compatibilidade TDD Suite Pre-Press Ready Release

Ecossistema de 8 ferramentas avançadas em ExtendScript (ES3 puro) desenvolvido para estúdios de branding, design editorial, interfaces digitais (UI), padronagens vetoriais generativas e pré-impressão gráfica no Adobe Illustrator — sem dependências externas, com Live Preview em tempo real, preservação de Pantone (SpotColor), CMYK K:100 e reversibilidade atômica (Ctrl + Z).


⬇️ Downloads Diretos (1 Clique)

Pacote / Script Versão O que inclui Download Direto
📦 Suíte Completa (.zip) Gold Edition Todos os 8 scripts .jsx, instalador automático Windows (.bat), exemplos CSV e documentação Baixar Pacote Completo (.zip)
1. Universal Grid Brockmann v6.5.0 Gold Grid suíço modular, Snap to Baseline, Modo Estúdio e rótulos editoriais Baixar .jsx
2. BentoGrid Generator v4.5.0 Gold Layouts Bento UI (Apple/Linear), Fit to Selection, borda 1pt e exportador CSS/Tailwind Baixar .jsx
3. Color Shuffler Ultra v3.0.0 Master Roda cromática, gradientes $0^\circ\text{–}360^\circ$, Anti-Clumping, morfologia 3D e SpotColor Baixar .jsx
4. Gerador QR Pro v4.5.0 Gold Vetor puro ISO 18004, PIX EMVCo/CRC16, 11 formatos, CMYK K:100, Pantone e Lote CSV Baixar .jsx
5. Nuvem de Palavras Pro v2.0.0 Master Espiral de Arquimedes, Modo Logo Central, fontes do doc (★), Re-Seed e curvas Baixar .jsx
6. Halftone Pro v2.0.0 Studio Retícula hexagonal equilátera, 6 geometrias, luminância SpotColor e CompoundPath Baixar .jsx
7. Block Text v3.0.0 Master Alinhamento tipográfico por largura, auto-encaixe em caixa guia, Swatches e curvas Baixar .jsx
8. Guias de Margem Pro v3.0.0 Master Margens, sangria, marcas de corte reais (0.5pt K:100), Spreads e Van de Graaf Baixar .jsx

Para navegar pelos arquivos diretamente no repositório ou ver todas as versões, acesse Releases.


🧭 Arquitetura do Ecossistema

flowchart TD
    ROOT["🎨 SUÍTE DE SCRIPTS ILLUSTRATOR\n(Gold Standard Edition)"]
    ROOT --> UB["1. Universal Grid Brockmann v6.5 Gold\n(Grid Suíço, Snap to Baseline, Modo Estúdio & Rótulos)"]
    ROOT --> BG["2. BentoGrid Generator v4.5 Gold\n(Layouts Bento, Fit to Selection, Borda 1pt & CSS/Tailwind)"]
    ROOT --> CS["3. Color Shuffler Ultra v3.0 Master\n(Harmonias, Gradientes 0°-360°, Anti-Clumping & SpotColor)"]
    ROOT --> QR["4. Gerador QR Pro v4.5 Gold\n(Vetor ISO 18004, PIX EMVCo/CRC16, Pantone & Lote CSV)"]
    ROOT --> NP["5. Nuvem de Palavras Pro v2.0 Master\n(Live Preview, Modo Logo Central, Fontes do Doc & Curvas)"]
    ROOT --> HT["6. Halftone Pro v2.0 Studio\n(Grade Hexagonal Real, 6 Geometrias, SpotColor & CompoundPath)"]
    ROOT --> BT["7. Block Text v3.0 Master\n(Alinhamento por Largura, Caixa Guia, Swatches & Outlines)"]
    ROOT --> GM["8. Guias de Margem Pro v3.0 Master\n(Margens, Sangria, Marcas de Corte Reais & Spreads)"]
Loading

🛠️ O que cada ferramenta faz (Descrição Detalhada)

1. Universal Grid Brockmann (v6.5.0 Gold)

Sistema de grades modulares suíças fundamentado em Josef Müller-Brockmann (Grid Systems in Graphic Design, 1981).

  • Código: GRIDS/src/Universal Grid Brockmann.jsx · Manual: GRIDS/README.md · Download: Baixar .jsx
  • O que ela tem:
    • Snap to Baseline matemático: calibra altura dos módulos, Gutter V e margem inferior em múltiplos exatos do leading tipográfico.
    • Modo Estúdio vs. Guias Nativas: preserva cores temáticas (Ciano, Magenta, Laranja, Dark Mode) e hierarquia de espessuras (0.35pt / 0.20pt) em camada travada não-imprimível (printable = false).
    • Presets editoriais e digitais (6 col Suíço, 12 col Avançado, Revista 2/3 colunas, Mobile/Desktop, Regra dos Terços), aplicação em múltiplas pranchetas, rótulos ilimitados (A..Z, AA...) e proteção anti-freeze (máx. 600 linhas de baseline).

2. BentoGrid Generator (v4.5.0 Gold)

Gerador algorítmico de layouts Bento Grid estilo Apple, Linear UI e Raycast com exportação para código.

  • Código: BENTO GRID/src/BENTOGRID.jsx · Manual: BENTO GRID/README.md · Download: Baixar .jsx
  • O que ela tem:
    • Presets prontos (Hero 3×3, Apple Showcase 4×3, Linear Dashboard 4×2, Raycast Modular 3×2, Instagram 2×2) e editor compacto para até 16 células.
    • Fit to Selection: encaixa o grid exatamente nas coordenadas e dimensões da seleção ativa.
    • Borda fina calibrada de 1pt em qualquer unidade (px, pt, mm, cm, in), camada não destrutiva "BentoGrid" (BentoGrid_CxL), suporte a amostras Pantone (SpotColor) e janela copiável de CSS Grid & Tailwind (col-start / row-start).

3. Color Shuffler Ultra (v3.0.0 Master)

Motor cromático matemático com harmonias automáticas, gradientes contínuos, coloração de grafos e morfologia 3D.

  • Código: COLOR SHUFFLER/src/Color-Shuffler.jsx · Manual: COLOR SHUFFLER/README.md · Download: Baixar .jsx
  • O que ela tem:
    • Motor Cromático: roda de cores (Análogas, Complementares, Split-Complementary, Tríade, Tétrada), rampa monocromática perceptual (3 a 12 degraus), importador rápido de códigos HEX/Coolors, leitura de Swatches com preservação de SpotColor e exportador direto para o painel Amostras.
    • Arranjo Espacial: aleatório Fisher-Yates, Anti-Clumping (Graph-Coloring 2D que impede objetos encostados de repetirem cor), gradiente linear em ângulo livre ($0^\circ\text{–}360^\circ$), gradiente radial e dispersão orgânica (Jitter 0%–100%).
    • Morfologia 3D & Preview: jitter de rotação ($\pm 5^\circ\text{–}180^\circ$), escala ($\pm 5%\text{–}50%$), opacidade variável, Smart Stroke (contorno automático 30% mais escuro), navegador de sementes (← Anterior / Próximo →) e snapshot atômico.

4. Gerador QR Pro (v4.5.0 Gold)

Gerador de QR Codes vetoriais puros (ISO/IEC 18004) projetado para pré-impressão offset, embalagens e crachás em lote.

  • Código: QR ILUSTRATOR/src/gerador_qr_illustrator.jsx · Manual: QR ILUSTRATOR/README.md · Exemplo CSV: exemplo_lote.csv · Download: Baixar .jsx
  • O que ela tem:
    • 11 tipos de dados: PIX (EMVCo BACEN com sanitização ASCII e CRC16-CCITT), WhatsApp, URL, Wi-Fi, vCard 3.0, Evento iCalendar, E-mail, SMS, Telefone, Localização GPS e Texto Livre.
    • Rigor de Gráfica: preto puro CMYK (C:0 M:0 Y:0 K:100), preservação nativa de amostras Pantone (SpotColor) e unificação em CompoundPath para corte/plotter.
    • Estilos & Produtividade: módulos quadrados, arredondados ou pontos; reserva central de logotipo com ECC H (30%); Fit to Selection; Modo Lote CSV UTF-8 com QR_Lote_Master e legendas automáticas.

5. Nuvem de Palavras Pro (v2.0.0 Master)

Estação de tipografia generativa e nuvens de palavras vetorizadas com zona de exclusão para logotipos.

  • Código: NUVEM DE PALAVRAS/src/Nuvem-de-Palavras.jsx · Manual: NUVEM DE PALAVRAS/README.md · Download: Baixar .jsx
  • O que ela tem:
    • Modo Logo Central: detecta um logotipo ou ícone selecionado, ancora a Espiral de Arquimedes ao centroide e cria barreira AABB impenetrável com margem configurável.
    • Live Preview & Re-Seed: pré-visualização instantânea na camada autolimpante __Nuvem_Preview_Temp__ e botão [ 🎲 Nova Distribuição ].
    • Tipografia & Linguagem: fontes ativas do documento destacadas com ★, dicionário com +250 stop words PT-BR preservando acentos, escala logarítmica/linear, profundidade por opacidade, rotação ortogonal e conversão automática em curvas (Create Outlines).

6. Halftone Pro (v2.0.0 Studio)

Gerador de retículas e meio-tom (halftone) vetorial puro a partir de vetores planos, gradientes ou imagens raster.

  • Código: HALFTONE/src/Halftone.jsx · Manual: HALFTONE/README.md · Download: Baixar .jsx
  • O que ela tem:
    • Grade Hexagonal Equilátera Real ($dy = \text{step} \times \frac{\sqrt{3}}{2}$) além de grade ortogonal e ângulo de rotação configurável.
    • 6 Geometrias Vetoriais: Círculos, Quadrados, Losangos (Diamonds), Linhas (Scanlines), Anéis Vazados (Rings) e Cruzes Técnicas.
    • Cálculo fiel de luminância em SpotColor (Pantone + fator de tint), canvas interativo de preview na janela + preview na prancheta e unificação automática em CompoundPath para serigrafia, plotter e corte a laser.

7. Block Text (v3.0.0 Master)

Alinhador e escalonador tipográfico modular por largura com auto-encaixe em caixa guia.

  • Código: TEXTO BLOCADO/src/BLOCK TEXT.jsx · Manual: TEXTO BLOCADO/README.md · Download: Baixar .jsx
  • O que ela tem:
    • Escala múltiplos Point Text frames para a mesma largura horizontal com ritmo vertical rígido sem distorcer a proporção tipográfica.
    • Auto-Encaixe em Caixa Guia (Fit to Bounding Box): inclua um retângulo na seleção para preencher altura e largura exatas automaticamente.
    • Alternância cromática por linha usando paletas editoriais (Editorial Dark & Gold, Swiss Modern, Cyberpunk Neon, etc.) ou Swatches do documento (preservando SpotColor), remoção opcional da guia e conversão em curvas (Create Outlines).

8. Guias de Margem Pro (v3.0.0 Master)

Gerador profissional de margens, sangria (bleed), marcas de corte reais e páginas espelhadas (spreads).

  • Código: MARGENS/src/Guias-de-Margem.jsx · Manual: MARGENS/README.md · Download: Baixar .jsx
  • O que ela tem:
    • Marcas de Corte Reais (Crop Marks): traços de 0.5pt em preto puro CMYK (K:100%) nos 4 cantos com recuo técnico, mesmo com guias de sangria ocultas.
    • Páginas Espelhadas (Spreads / Facing Pages): inverte automaticamente margens interna (lombada) e externa entre pranchetas pares e ímpares.
    • Presets clássicos (Cânone Editorial Van de Graaf 2:3:4:6, Proporção Áurea $\phi = 1.618$, Revista A4, Cartão de Visita, 10mm, 5mm, Web 10%), conversão exata entre mm, cm, pt, px, in e pc, modo acumulativo ou substitutivo e Live Preview não-imprimível.

🚀 Instalação e Uso Rápido

Opção 1 — Instalador Automático no Menu do Illustrator (Windows)

  1. Baixe e extraia o Pacote Completo (.zip).
  2. Clique com o botão direito em INSTALAR_SCRIPTS_NO_ILLUSTRATOR.bat e selecione Executar como Administrador.
  3. O instalador detecta automaticamente sua pasta Presets\*\Scripts do Adobe Illustrator e copia os 8 scripts.
  4. No Illustrator, acesse todos eles em Arquivo → Scripts.

Opção 2 — Execução Direta (Windows & macOS)

  1. Baixe qualquer script individual na tabela acima.
  2. Abra o Adobe Illustrator e pressione Ctrl + F12 (Windows) ou Cmd + F12 (macOS), ou acesse Arquivo → Scripts → Outro Script....
  3. Selecione o arquivo .jsx baixado.

🛡️ Engenharia Defensiva & Padrões de Qualidade (/ub-mode)

Todos os scripts desta suíte seguem rigorosamente os princípios de engenharia defensiva especificados em GEMINI.md:

  • Compatibilidade Universal ES3 Puro: Zero dependências externas, sem let, const, arrow functions ou template literals, garantindo execução nativa do Illustrator CS6 ao CC 2026 / Beta.
  • Boundary Discipline (Parse, don't validate): Todos os campos numéricos aceitam separador decimal com vírgula ou ponto ("12,5" ou "12.5") e são normalizados na fronteira da UI.
  • Reversibilidade Atômica & Camadas Não-Imprimíveis:
    • Snapshots completos pré-execução restauram 100% da arte original caso o usuário cancele ou feche a janela (Esc / [X]).
    • Camadas temporárias de Live Preview possuem printable = false obrigatório e são autolimpas no w.onClose.
  • Rigor de Pré-Impressão (CMYK K:100 & SpotColor):
    • Preservação integral de amostras Pantone / Cores Globais (SpotColor) sem achatamento involuntário para CMYK/RGB.
    • Códigos QR e marcas de corte utilizam preto puro de canal único (C:0 M:0 Y:0 K:100) em documentos CMYK.

🧪 Suíte de Testes Automatizados (TDD & Auditoria Estática)

O repositório inclui uma suíte de verificação em Node.js na pasta scratch/ que valida a sintaxe ES3, o comportamento em VM com Mock completo do DOM do Illustrator e métricas de complexidade/duplicação:

# 1. Validador Estático de Sintaxe ES3 (8/8 scripts)
node scratch/test_syntax.js

# 2. Suíte Comportamental TDD com Mock DOM do Illustrator (15/15 testes)
node scratch/ub_test_runner.js

# 3. Auditoria Estrutural (Boundary Discipline, Dead Code, Dryer & Crapper)
node scratch/ub_audit.js

📂 Estrutura do Repositório

illustrator-scripts-suite/
├── .agent/skills/illustrator-mcp/  # Skill de integração com o Adobe Illustrator Beta MCP
├── BENTO GRID/                     # BentoGrid Generator v4.5 Gold Standard
│   ├── src/BENTOGRID.jsx
│   └── README.md
├── COLOR SHUFFLER/                 # Color Shuffler Ultra v3.0 Master Edition
│   ├── src/Color-Shuffler.jsx
│   └── README.md
├── GRIDS/                          # Universal Grid Brockmann v6.5 Gold Standard
│   ├── src/Universal Grid Brockmann.jsx
│   └── README.md
├── HALFTONE/                       # Halftone Pro v2.0 Studio Edition
│   ├── src/Halftone.jsx
│   └── README.md
├── MARGENS/                        # Guias de Margem Pro v3.0 Master Edition
│   ├── src/Guias-de-Margem.jsx
│   └── README.md
├── NUVEM DE PALAVRAS/              # Nuvem de Palavras Pro v2.0 Master Edition
│   ├── src/Nuvem-de-Palavras.jsx
│   └── README.md
├── QR ILUSTRATOR/                  # Gerador QR Pro v4.5 Gold Standard
│   ├── src/gerador_qr_illustrator.jsx
│   ├── exemplos/exemplo_lote.csv
│   └── README.md
├── TEXTO BLOCADO/                  # Block Text v3.0 Master Edition
│   ├── src/BLOCK TEXT.jsx
│   └── README.md
├── scratch/                        # Runners de TDD, Mock DOM e Auditoria Estática ES3
│   ├── test_syntax.js
│   ├── ub_test_runner.js
│   ├── ub_audit.js
│   └── install_scripts.ps1
├── INSTALAR_SCRIPTS_NO_ILLUSTRATOR.bat
├── GEMINI.md                       # Documentação Técnica Mestre & Regras de Negócio
└── README.md                       # Catálogo Principal da Suíte

👤 Autor

Ramon Cavalcanti (@Ramonzitooo)

About

Suite com 8 Scripts Profissionais ES3 para Adobe Illustrator: Grid Brockmann, BentoGrid, Color Shuffler, QR Pro (PIX), Nuvem de Palavras, Halftone, Block Text e Guias de Margem

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages