BINKSY LOGONEXT — MODE D'EMPLOI POUR AGENTS IA

Ce document s'adresse aux agents IA (Claude Code, Codex, ou tout agent qui pilote un navigateur via Playwright / CDP, ou qui exécute du JavaScript dans la page). Il couvre tout l'outil : import d'un logo SVG ou d'un projet .binksy, réglages (marque, palette, variantes, formats, versions, QR code), export du ZIP et du projet .binksynext, et l'API publique window.multiformats.

Il existe en trois endroits, toujours identiques : /AGENTS.md (Markdown, français puis anglais), la page /agent et l'écran Agents IA de l'outil (#/agents, pied de l'accueil, barre latérale).

Points d'entrée découvrables sans JavaScript : la page / déclare <link rel="alternate" type="text/markdown" href="AGENTS.md">, <link rel="help" href="agent/"> et <link rel="alternate" type="text/plain" href="llms.txt">, affiche un <noscript> qui renvoie ici, et écrit une seule ligne console.info au chargement. /robots.txt autorise tout et cite /llms.txt et /AGENTS.md.

1. RÈGLE FONDAMENTALE

Binksy LogoNext est un outil de déclinaison pour graphistes, pas un générateur de logos.

Après chaque opération : vérifie la valeur réellement enregistrée (await multiformats.state()), puis le résultat (export → files, kit.read). Un appel ou un clic n'est pas une preuve de réussite.

2. DÉMARRER

Lancer l'outil

Deux façons de piloter

  1. API JavaScript (recommandé) : window.multiformats dans la page, aussi accessible sous window.logonext (même objet ; l'outil s'appelle désormais Binksy LogoNext, le nom multiformats reste pour la compatibilité). Chaque méthode agit par les mêmes fonctions que l'interface et renvoie du JSON.
  2. Clics : les commandes clés portent un attribut stable data-agent (voir § 8).
await multiformats.ready();          // attend la démo AVORA ou la session
multiformats.version;                // "2.4"
multiformats.help();                 // [{path, signature, description}]
multiformats.help('load');           // un groupe
await multiformats.state();          // tout l'état
await multiformats.catalog();        // groupes, formats, tailles, modes, règle des noms

Conventions de l'API

3. PARCOURS TYPE

await multiformats.ready();
// 1. le logo (1 à 8 versions) — ou load.binksy(…)
await multiformats.load.svg([
  { svg: iconeSvgText, name: 'avora-icone', type: 'icone' },
  { svg: horizontalSvgText, name: 'avora-horizontal', type: 'horizontal' },
], { brand: 'AVORA' });
// 2. palette (facultative), mode, formats
await multiformats.setPalette([{ hex: '#ff5500', name: 'Orange', role: 'accent' }, { hex: '#111111', name: 'Noir', role: 'text' }]);
await multiformats.setMode('essentiel');
await multiformats.preset('site');                                   // ou setFormats({...})
await multiformats.setFormats({ 'g:ticket': true, webm: false });
// 3. QR (seulement avec un lien donné par le graphiste)
await multiformats.setQR({ url: 'https://avora.studio', logo: true, modules: 'arrondi', eyes: 'arrondi' });
// 4. contrôle avant export
const plan = await multiformats.plan();                              // {mode, tasks, folders[]}
// 5. export
const kit = await multiformats.export({ base64: true });             // {name, size, count, files[], base64}
const readme = await multiformats.kit.read('avora-kit/LISEZMOI.txt', { text: true });
const bx = await multiformats.exportBinksynext({ base64: true });   // avora.binksynext, réouvrable ici (renommé .binksy : LogoKit)

Avec Playwright (Python), le contenu d'un fichier local se passe en base64 :

import base64
svg = open('logo.svg').read()
page.goto('http://127.0.0.1:8792/#/outil')
page.wait_for_function('window.multiformats')
page.evaluate('multiformats.ready()')
page.evaluate('(s) => multiformats.load.svg(s, {brand: "AVORA"})', svg)
bx = base64.b64encode(open('projet.binksy', 'rb').read()).decode()
page.evaluate('(b) => multiformats.load.binksy(b, {name: "projet.binksy"})', bx)
r = page.evaluate('multiformats.export({base64: true, list: false})')
open(r['name'], 'wb').write(base64.b64decode(r['base64']))

Ou par l'interface : page.set_input_files('#file', 'logo.svg') (SVG) et page.set_input_files('#bxFile', 'projet.binksy') (accepte .binksy et .binksynext).

4. RÉFÉRENCE DE L'API

MéthodeRôleRetour
ready({timeout?})Attend que l'outil soit prêt{version, api, route, hasLogo}
help(prefix?)Signatures (synchrone)[{path, signature, description}]
state()État completvoir ci-dessous
catalog()Groupes et formats (usage, où, tailles, dossier, couleurs Essentiel), modes, préréglages, types de version, rôles, règle des nomsobjet
plan({mode?})Ce que l'export produira, sans rien rendre{mode, tasks, folders:[{format, group, version, versionName, color, colorName, folder}]}
route(name?)Lit ou change la page (accueil, outil, docs, agents)route
load.svg(input, {replace=true, brand?, palette?, name?, type?})Charge 1 à 8 versions. input : un SVG ou une liste ; un élément peut être {svg, name, type}versions
load.binksy(data, {name?})Ouvre un .binksy (LogoKit, v2 ZIP ou ancien JSON) ou un .binksynext (cet outil) ; le contenu est détecté, l'extension ne compte pas{brand, versions, palette, source, restored?, state}
load.demo()Démo AVORA : 4 versions (Horizontal, Vertical, Icône, Logotype) et palette nommée de 4 couleurs (Noir/Texte, Orange/Accent, Craie/Fond, Marron/Texte secondaire), comme l'import de son .binksy ; state().isDemo = true. Le prochain load.svg (remplacement) ou load.binksy la remplace, palette compriseversions
addVersions(input, {name?, type?})Ajoute des versionsversions
setVersion(id, {name?, type?}) / removeVersion(id)Renomme, retype, retireversion / versions
setBrand(name)Nom de la marque (préfixe des fichiers){brand, slug}
setMode('essentiel' | 'complet')Contenu du ZIPmode
setPalette(list)Palette, 8 max : ["#hex"] ou [{hex, name?, role?}]palette
setVariants({cle: bool})Coche / décoche des variantes de couleurvariants
preset(id)site, shop, app, allids des formats actifs
setFormats({id | "g:groupe": bool})Active / coupe formats et groupes[{id, on, available}]
setFormatVersions(formatId, ids | null)Versions d'un format ; null = conseil{format, versions, custom}
setQR({url?, fg?, bg?, logo?, modules?, eyes?, quiet?})QR codeqr
setSettings({bg?, size?, gradMode?, knock?, darkMode?, thermal?})Réglagessettings
export({mode?, base64?, download?, list?})Fabrique le ZIP{name, type, size, mode, count, ms, errors, files, base64?}
exportBinksynext({base64?, download?})Projet marque.binksynext (format .binksy v2, type application/x-binksynext){name, type, size, base64?}
exportBinksy(…)Ancien nom de exportBinksynext (même fichier .binksynext)idem
kit.list() / kit.read(path, {text?})Fichiers du dernier ZIP[{path, size}] / {path, name, type, size, base64 | text}
files.list() / get / base64 / downloadFichiers produits (ZIP, .binksynext)

Valeurs autorisées :

state() renvoie : {app, version, api, route, ready, brand, slug, isDemo, mode, preset, versions:[{id, name, type, folder, kind, width, height, colors, warnings, legibleAt16px}], palette:[{hex, name, role}], variants:[{key, name, folder, group, on, locked, background, ink}], groups:[{id, name, folder, on}], formats:[{id, group, name, on, available, folder, versions, customVersions, essentiel}], qr:{url, text, active, fg, bg, logo, modules, eyes, quiet, contrast, safe}, settings:{…}, webm, binksyImport}.

5. LE FORMAT .binksy ET modules.multiformats

Le .binksy est le fichier projet de Binksy LogoKit. Cet outil enregistre le même format sous l'extension .binksynext (pour le distinguer d'un projet LogoKit) ; à l'import, .binksy et .binksynext sont acceptés tous les deux (y compris les anciens .binksy enregistrés ici). Pour ouvrir un .binksynext dans LogoKit, renomme-le en .binksy. Version 2 = archive ZIP :

À l'import, l'outil lit : brand (sinon name), variants[] sinon roles (+ extras), sinon l'ancien modules.logokit ; palette[] (8 max) ; les anciens .binksy JSON V1–V5 (versions recomposées comme LogoKit). Le lecteur ZIP ne lit que l'index central et les fichiers utiles (deflate via DecompressionStream), ZIP64 compris.

modules.multiformats

Ajouté par « Exporter en .binksynext » ; LogoKit le conserve tel quel. S'il est présent à l'import, tout l'état revient (et seules les versions sont lues dans assets).

{
  "app": "Binksy LogoNext", "v": 1, "savedAt": "2026-10-29T10:00:00.000Z",
  "session": {
    "v": 2,
    "shapes": [{ "name": "Icône", "type": "icone", "file": "avora-icone", "asset": "a1b2c3…" }],
    "kitName": "AVORA", "isDemo": false, "mode": "essentiel", "preset": "custom",
    "palette": ["#ff5500", "#111111"],
    "palLabels": { "#ff5500": { "name": "Orange", "role": "Accent" } },
    "map": {}, "mapTouched": false,
    "off": ["gris"], "fmtOff": ["g:video", "webm"], "fmtShapes": { "banners": [1] },
    "ctxVar": "auto", "gradMode": "keep", "knock": true, "darkMode": "plate",
    "bg": "auto", "size": 0.8, "thermal": { "mode": "atkinson", "thr": 128 },
    "qr": { "url": "https://avora.studio", "fg": "#111111", "bg": "#ffffff", "logo": true, "modules": "carre", "eyes": "carre", "quiet": 4 }
  }
}

6. LE ZIP

Nom : <marque>-kit-<mode>.zip (ex. avora-kit-essentiel.zip). Racine : <marque>-kit/.

<marque>-kit/
  LISEZMOI.txt                                    UTF-8 avec BOM, CRLF
  1-web/favicons/[<version>/]<couleur>/           favicon.ico, <m>_favicon_<c>.svg, apple-touch-icon.png,
                                                  <m>_android-chrome-192x192_<c>.png, …-512x512…, <m>_maskable-192x192_<c>.png,
                                                  …-512x512…, site.webmanifest, <m>_a-coller-dans-head_<c>.html
  1-web/image-de-partage/…                        <m>_og-image-1200x630_<c>.png
  2-apps/ios/…/AppIcon.appiconset/                AppIcon-1024.png, AppIcon-1024-dark.png, AppIcon-1024-tinted.png, Contents.json
  2-apps/android/…/res/                           mipmap-{mdpi…xxxhdpi}/ic_launcher{,_round,_foreground,_background,_monochrome}.png,
                                                  mipmap-anydpi-v26/ic_launcher{,_round}.xml, values/ic_launcher_background.xml
  2-apps/google-play/…  macos/…  windows/…        <m>_google-play-512_<c>.png, <m>_macos_<c>.icns, <m>_macos-1024_<c>.png, <m>_windows_<c>.ico
  3-ticket/ticket-58mm|ticket-80mm/…/noir/        <m>_ticket-58mm-384px_noir.bmp (+ -apercu .png), 80 mm = 576px
  3-ticket/etiquette-zebra/…/noir/                <m>_etiquette-zebra-203dpi_noir.zpl
  4-fabrication/decoupe|eps/<version>/<couleur>/  <m>_decoupe[_<version>]_<c>.svg, <m>_logo[_<version>]_<c>.eps
  5-reseaux/photos-de-profil/…                    instagram-320, instagram-1080, linkedin-400, x-400, whatsapp-business-640,
                                                  youtube-800, facebook-720, google-business-720 (.png)
  5-reseaux/bannieres/…                           youtube-banniere-2560x1440, linkedin-banniere-1584x396, x-banniere-1500x500,
                                                  facebook-couverture-1640x624, twitch-banniere-1200x480, google-business-couverture-1024x576
  5-reseaux/discord|slack|fond-visio/…            discord-512, slack-emoji-128, fond-visio-1920x1080
  5-reseaux/signature-email/…                     <m>_signature-email-<L>px_<c>.png + <m>_signature-email_<c>.html
  5-reseaux/bimi/…                                <m>_bimi-tiny-ps_<c>.svg
  6-qr-code/qr-code/<style>/                      <m>_qr-code_<s>.svg, <m>_qr-code-1024_<s>.png, <m>_qr-code-2048_<s>.png
  7-video/filigrane|animation/…                   <m>_filigrane-1920x1080_<c>.png, <m>_animation-fondu-1920x1080_<c>.webm

7. VÉRIFIER UN EXPORT

8. SÉLECTEURS STABLES (data-agent)

AttributÉlément
home-open-tool, home-start-toolOuvrir l'outil (accueil)
home-import-binksy, home-start-binksyImporter un .binksy / .binksynext (accueil)
home-import-svg, home-start-svg, home-demo, home-docs, home-resumeAccueil
nav-home, nav-docs, nav-agents, nav-toolEn-tête du site
tool-import (#file), tool-import-binksy (#bxFile), tool-export-binksy, tool-demoBarre latérale de l'outil
tool-mode-essentiel, tool-mode-complet, tool-exportEn-tête de l'outil
tool-view-variants, tool-view-context, tool-view-filesVues
side-home, side-docs, side-agentsLiens du site dans l'outil

9. LIMITES