Crear un anim
Un anim es un archivo, <nombre-en-kebab>@<major>.<minor>.yaml, con exactamente cuatro claves: t (el literal c), j (un módulo ES), s (CSS), h (HTML/SVG). Un reproductor anfitrión lo ejecuta con una API global G que proporciona las sílabas, palabras, líneas, secciones y tiempos de la canción. Tu trabajo: convertir una breve descripción en un archivo que sea correcto bajo búsqueda/pausa/redimensión/tema, legible y hermoso. Las rutas a continuación son relativas a este directorio skill/.
Las reglas más importantes
- Un fotograma es una función pura del tiempo de reproducción.
render(t)debe dibujar la misma imagen tanto si la reproducción llegó atcomo si el usuario se desplazó hasta él. SinMath.random,Date.now, integración acumulada o estado de "lo que pasó en el fotograma anterior" que un salto omitiría. Deriva todo de los datos de la canción, la semilla yt. - Dos mitades. Una mitad pura exportada, sin DOM (
buildPlan,frameAt, ayudantes; comprobable mediante pruebas unitarias) encima de un comentario de banner, luego una mitad fina para el navegador (export default function (G, shadowRoot, config)) que solo conecta y dibuja. Consultaguides/architecture.md. - Regístrate en
default, lee los datos de la canción enINIT.G.on/G.off/G.onFramesolo dentro dedefault.G.map/forEach/lookup/iterator/relayoutsolo una vez que se haya disparadoINIT(un manejador deINIT, o devoluciones de llamada posteriores comorender), nunca en el propiodefault. SuscríbeteG.on(G.TYPE.TICK, render)para la reproducción;G.onFrame({ render, reset })cubre SEEK/PLAY/PAUSE/RESIZE y UNINIT. - Limpia con
G.dispose/G.listen. Una función devuelta pordefaultse ignora. Libera WebGL (forceContextLoss), oyentes, temporizadores, cámara. - Los colores viven en CSS, no en
c.v. Valores claros en:host, anulaciones oscuras en[data-bs-theme=dark] { }; el lienzo los lee con la librería g-libcssColors. Ambos temas deben verse intencionales. - Nunca implementes manualmente lo que g-lib ya tiene (clamp, lerp, easing, RNG con semilla, ajuste de lienzo, resortes, diseño de texto, grupos...). Importa desde el pin de etiqueta exacta; consulta
pitfalls/dont-hand-roll.mdyspec/g-lib.mdantes de escribir cualquier ayudante. - La legibilidad prima sobre el efecto. La sílaba activa es legible en claro y oscuro, en teléfono y portátil, para líneas largas, CJK, RTL y Myanmar. Los destellos grandes se mantienen por debajo de 3 Hz (
guides/accessibility.md). - Pocas opciones escritas.
cycSchemason literales simples; cada opción hace algo visible.
Flujo de trabajo (con las herramientas del repositorio)
- Descripción. Escribe la descripción de diseño a partir de
guides/design-brief.md: una imagen física fuerte; el mecanismo; qué eventos impulsan qué (el mapa de sincronización); la estructura (estrofa/estribillo/ritmo); el plan de legibilidad; las opciones; las trampas. Elige el backend con su tabla de selección. Rechaza ideas que no puedan mantenerse legibles. - Andamiaje.
npm run new -- <nombre> --backend canvas2d|svg|dom|three(o copiatemplates/<backend>.yamlmanualmente y reemplaza__NAME__). - Lee una vez:
spec/module-format.md,pitfalls/general.md, la sección de tu backend enpitfalls/backends.md,pitfalls/dont-hand-roll.md. Abre cualquier otra cosa solo a través de la tabla de enrutamiento a continuación. - Implementa primero la mitad pura (de tiempo a estado), luego la mitad fina del navegador.
- Valida.
npm run validate -- anims/<archivo>.yaml. Corrige cada error; justifica cada advertencia en el bloque de documentación o corrígelo. - Verifica.
npm run check -- anims/<archivo>.yamlmonta 13 canciones de casos extremos sin cabeza, puntúa la tabla de conformidad y escribe PNG enout/<nombre>/. Abre los PNG (teléfono/portátil, claro/oscuro). Una tabla verde sobre un fotograma feo o ilegible es un fallo. Una ADVERTENCIA en una fila de pureza de búsqueda significa que la imagen depende del historial: corrígelo o justifícalo en el bloque de documentación (una simulación deliberada). - Vista previa (opcional).
npm run preview -- anims/<archivo>.yamlpara reproducir, desplazarse, cambiar de tema y ajustar opciones. - Revisa contra
guides/quality-rubric.md(20 preguntas), luego entrega el único archivo YAML y un informe breve (nombre del archivo, tabla de verificación final, decisiones que la descripción dejó abiertas, qué hiciste deliberadamente no hacer). No envíesout/o el arnés.
Modo sin herramientas (modelos de chat, sin shell)
Omite los pasos 2, 5-7. Comienza desde el texto de la plantilla correspondiente, escribe la descripción de diseño en tu razonamiento, luego revisa pitfalls/general.md, la sección del backend y la rúbrica de 20 preguntas línea por línea contra tu propio código antes de responder. Genera solo el archivo YAML en un bloque delimitado, y menciona qué elementos de la rúbrica no pudiste verificar sin ejecutarlo (pureza de búsqueda, cambio de tema, redimensión).
Tabla de enrutamiento: abre un documento solo cuando su desencadenante aplica
| Cuando estés a punto de... | Lee |
|---|---|
| decidir qué construir; elegir un backend | guides/design-brief.md |
| diseñar el archivo; nombrar etapas; escribir el bloque de documentación | guides/architecture.md |
usar cualquier llamada G.*, opción de evento o rango de id | spec/events.md, spec/event-shapes.md, spec/g.d.ts |
| añadir opciones, colores, temas | spec/config.md |
| usar utilidades de tiempo, medición de texto, ayudantes de lienzo, ciclo de vida | spec/utilities.md |
| dividir líneas en líneas de visualización, ajustar texto | spec/relayout.md, guides/patterns-text.md |
| activar cosas en sílabas/líneas/ritmos; pre-generar; pausa; resortes | guides/patterns-timing.md |
| ajustar, resaltar o estilizar texto; escrituras no latinas | guides/patterns-text.md |
| escribir código de renderizado (DOM, SVG, canvas, three, simulación, capas) | guides/patterns-render.md, pitfalls/backends.md |
| cámara, terreno, enjambres, empaquetado, 3D procedural | guides/techniques.md, pitfalls/techniques.md |
| usar una foto o cámara | spec/image-input.md |
| construir un juego (autoPlay falso, puntuación, estados) | guides/games.md |
| usar cualquier ayudante de g-lib | spec/g-lib.md |
| sentirte inseguro sobre destellos, movimiento, contraste | guides/accessibility.md |
| terminar | guides/quality-rubric.md |
Forma mínima (no envíes esto; comienza desde una plantilla)
"t": |-
c
"j": |
import { hash01 } from 'https://cdn.jsdelivr.net/gh/prjctg/[email protected]/index.js';
/* [email protected]: <una línea>
* 1. <afirmación de diseño numerada: el mecanismo y la respuesta incorrecta tentadora que rechaza> */
export function frameAt(plan, t) { /* puro */ }
/* Mitad del navegador. Todo lo que está encima de esta línea no tiene DOM a propósito. */
export default function (G, shadowRoot, config) {
const cfg = G.cfg(config, { canal: G.cfg.int(0) });
let listo = falso;
const render = (t) => { si (!listo) return; /* dibuja frameAt(plan, t) */ };
G.on(G.TYPE.INIT, () => { listo = verdadero; /* G.map(...) es válido aquí */ });
G.on(G.TYPE.TICK, render);
G.onFrame({ render, reset() { listo = falso; } });
}
export const c = { v: { fadeMs: 150 }, m: [{ s: 'fadeMs', t: 'fadeMs' }] };
export const cSchema = [{ i: 'fadeMs', n: 'Fundido (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 contienen texto sin formato (nunca envuelto en comillas invertidas o comillas). t usa |-. El nombre del archivo lleva la versión; nunca edites una versión publicada en su lugar.