Créer un anim
Un anim est un fichier unique, <nom-kebab>@<majeur>.<mineur>.yaml, avec exactement quatre clés : t (le littéral c), j (un module ES), s (CSS), h (HTML/SVG). Un lecteur hôte l'exécute avec une API globale G qui fournit les syllabes, mots, lignes, sections et temps de la chanson. Votre tâche : transformer un brief en un tel fichier qui soit correct en cas de seek/pause/redimensionnement/changement de thème, lisible et beau. Les chemins ci-dessous sont relatifs à ce répertoire skill/.
Les règles les plus importantes
- Une frame est une fonction pure du temps de lecture.
render(t)doit dessiner la même image que la lecture ait atteinttou que l'utilisateur y ait cherché. Pas deMath.random,Date.now, d'intégration accumulée ou d'état « ce qui s'est passé dans la frame précédente » qu'un seek pourrait sauter. Dérivez tout des données de la chanson, de la graine et det. - Deux moitiés. Une moitié pure exportée, sans DOM (
buildPlan,frameAt, helpers ; testable unitairement) au-dessus d'un commentaire de séparation, puis une moitié navigateur fine (export default function (G, shadowRoot, config)) qui ne fait que câbler et dessiner. Voirguides/architecture.md. - Enregistrer dans
default, lire les données de la chanson dansINIT.G.on/G.off/G.onFrameuniquement à l'intérieur dedefault.G.map/forEach/lookup/iterator/relayoutuniquement après queINITa été déclenché (un gestionnaireINIT, ou des callbacks ultérieurs commerender), jamais dansdefaultlui-même. Abonnez-vousG.on(G.TYPE.TICK, render)pour la lecture ;G.onFrame({ render, reset })couvre SEEK/PLAY/PAUSE/RESIZE et UNINIT. - Nettoyer avec
G.dispose/G.listen. Une fonction retournée pardefaultest ignorée. Libérez WebGL (forceContextLoss), les écouteurs, les timers, la caméra. - Les couleurs vivent dans le CSS, pas dans
c.v. Valeurs claires sur:host, surcharges sombres dans[data-bs-theme=dark] { }; le canvas les relit avec g-libcssColors. Les deux thèmes doivent être intentionnels. - Ne jamais réinventer ce que g-lib a (clamp, lerp, easing, RNG basé sur graine, ajustement du canvas, ressorts, disposition du texte, pools...). Importez depuis l'épingle exact-tag ; consultez
pitfalls/dont-hand-roll.mdetspec/g-lib.mdavant d'écrire un helper. - La lisibilité prime sur l'effet. La syllabe active est lisible en clair et en sombre, sur téléphone et ordinateur portable, pour les longues lignes, le CJK, le RTL et le birman. Les flashs amples restent sous 3 Hz (
guides/accessibility.md). - Peu d'options typées.
cetcSchemasont des littéraux simples ; chaque option fait quelque chose de visible.
Workflow (avec les outils du dépôt)
- Brief. Rédigez le brief de conception à partir de
guides/design-brief.md: une image physique forte ; le mécanisme ; quels événements déclenchent quoi (la carte de synchronisation) ; la structure (couplet/refrain/beat) ; le plan de lisibilité ; les options ; les pièges. Choisissez le backend avec sa table de sélection. Rejetez les idées qui ne peuvent pas rester lisibles. - Scaffolding.
npm run new -- <nom> --backend canvas2d|svg|dom|three(ou copieztemplates/<backend>.yamlà la main et remplacez__NAME__). - Lire une fois :
spec/module-format.md,pitfalls/general.md, la section de votre backend danspitfalls/backends.md,pitfalls/dont-hand-roll.md. N'ouvrez autre chose que via la table de routage ci-dessous. - Implémentez d'abord la moitié pure (du temps à l'état), puis la moitié navigateur fine.
- Validez.
npm run validate -- anims/<fichier>.yaml. Corrigez chaque erreur ; justifiez chaque avertissement dans le docblock ou corrigez-le. - Vérifiez.
npm run check -- anims/<fichier>.yamlmonte 13 chansons aux cas limites en mode headless, note la table de conformité et écrit des PNG dansout/<nom>/. Ouvrez les PNG (téléphone/ordinateur portable, clair/sombre). Un tableau vert sur une image moche ou illisible est un échec. Un AVERTISSEMENT sur une ligne de pureté du seek signifie que l'image dépend de l'historique : corrigez-le ou justifiez-le dans le docblock (une simulation délibérée). - Prévisualisation (optionnelle).
npm run preview -- anims/<fichier>.yamlpour jouer, scruter, changer de thème et ajuster les options. - Revue selon
guides/quality-rubric.md(20 questions), puis fournissez le seul fichier YAML et un court rapport (nom du fichier, tableau final de vérification, décisions laissées ouvertes par le brief, ce que vous avez délibérément omis de faire). N'envoyez pasout/ou le harnais.
Mode sans outils (modèles de chat, pas de shell)
Sautez les étapes 2, 5-7. Partez du texte du modèle correspondant, rédigez le brief de conception dans votre raisonnement, puis passez en revue pitfalls/general.md, la section du backend et la grille des 20 questions ligne par ligne par rapport à votre propre code avant de répondre. Produisez uniquement le fichier YAML dans un bloc délimité, et mentionnez quels éléments de la grille vous n'avez pas pu vérifier sans l'exécuter (pureté du seek, changement de thème, redimensionnement).
Table de routage : ouvrir un document seulement lorsque son déclencheur s'applique
| Quand vous êtes sur le point de... | Lisez |
|---|---|
| décider quoi construire ; choisir un backend | guides/design-brief.md |
| organiser le fichier ; nommer les étapes ; écrire le docblock | guides/architecture.md |
utiliser un appel G.*, une option d'événement ou une plage d'ID | spec/events.md, spec/event-shapes.md, spec/g.d.ts |
| ajouter des options, des couleurs, du thème | spec/config.md |
| utiliser des utilitaires de temps, de mesure de texte, des helpers canvas, le cycle de vie | spec/utilities.md |
| diviser des lignes en lignes d'affichage, envelopper le texte | spec/relayout.md, guides/patterns-text.md |
| déclencher des choses sur des syllabes/lignes/beats ; pré-générer ; pause ; ressorts | guides/patterns-timing.md |
| ajuster, mettre en évidence ou styliser du texte ; écritures non latines | guides/patterns-text.md |
| écrire du code de rendu (DOM, SVG, canvas, three, simulation, couches) | guides/patterns-render.md, pitfalls/backends.md |
| caméra, terrain, essaims, conditionnement, 3D procédural | guides/techniques.md, pitfalls/techniques.md |
| utiliser une photo ou une caméra | spec/image-input.md |
| construire un jeu (autoPlay false, score, états) | guides/games.md |
| utiliser un helper g-lib | spec/g-lib.md |
| ne pas être sûr des flashs, du mouvement, du contraste | guides/accessibility.md |
| terminer | guides/quality-rubric.md |
Forme minimale (ne pas livrer ceci ; partir d'un modèle)
"t": |-
c
"j": |
import { hash01 } from 'https://cdn.jsdelivr.net/gh/prjctg/[email protected]/index.js';
/* [email protected]: <une ligne>
* 1. <revendication de conception numérotée : le mécanisme et la tentation erronée qu'il rejette> */
export function frameAt(plan, t) { /* pure */ }
/* Moitié navigateur. Tout ce qui est au-dessus de cette ligne est intentionnellement sans DOM. */
export default function (G, shadowRoot, config) {
const cfg = G.cfg(config, { canal: G.cfg.int(0) });
let ready = false;
const render = (t) => { if (!ready) return; /* dessiner frameAt(plan, t) */ };
G.on(G.TYPE.INIT, () => { ready = true; /* G.map(...) est valide ici */ });
G.on(G.TYPE.TICK, render);
G.onFrame({ render, reset() { ready = false; } });
}
export const c = { v: { fadeMs: 150 }, m: [{ s: 'fadeMs', t: 'fadeMs' }] };
export const cSchema = [{ i: 'fadeMs', n: 'Fondu (ms)', t: 'int', mn: 0, mx: 2000 }];
"s": |
:host { display: block; --ink: var(--inkColor, #111); }
[data-bs-theme=dark] { --ink: var(--inkColor, #eee); }
"h": |
<canvas id="c"></canvas>
j, s, h contiennent du texte brut (jamais entouré de backticks ou de guillemets). t utilise |-. Le nom du fichier porte la version ; ne modifiez jamais une version publiée sur place.