4 Commits (0aa0e8997db592db74c80361a06e3b70b290ab29)

Author	SHA1	Message	Date
dev	49362d89e9	feat(sema,sound): un pack se entrega como quieras — y un `data:` no se pide, se descodifica ... La entrega deja de ser parte del contrato. Un pack de ficheros puede llegar como quince URLs o como UN JSON de base64 (`packFromBase64`): mismo tipo, mismo intercambio en caliente, misma reserva sintética por entrada, y un nombre que no existe sigue sin compilar. Medido sobre `static/sounds/ui-inline.json`: una petición en vez de quince, y 69.082 B con brotli frente a 79.332 B de los ficheros sueltos — el +33 % del base64 lo deshace la compresión, y el JSON gana además porque nadie comprime `audio/mpeg` y todos comprimen `application/json`. ## `step` no se oía Era a la vez el MÁS CORTO (18 ms) y el MÁS FLOJO (gain 0.025), y esas dos cosas se multiplican: el oído integra energía durante ~100-200 ms, así que un tono corto necesita MÁS amplitud, no menos. Medido, rendía a −29,8 dBFS con la novena parte de la energía de `touch`. Ahora 0.06 a los mismos 18 ms. Lo que no había era el guard: la distinguibilidad es una RELACIÓN, y dos sonidos pueden ser perfectamente distintos entre sí y ser los dos inaudibles. `sound-names.test.ts` gana un suelo absoluto sobre `gain² × duración`. ## El precalentamiento no precalentaba - `preload` pedía el contexto con `getOrCreateContext()`, que hace `await resume()` — y antes del primer gesto esa promesa se queda PENDIENTE en Chrome, no se rechaza. No descargaba nada hasta que el usuario ya había pulsado, que es justo la latencia que el preload existe para quitar. `decodeAudioData` funciona en un contexto suspendido. - Aplicar un pack en caliente no calentaba la caché: cada nombre pagaba su viaje la primera vez que sonaba. Ahora `rebuildMap()` llama a `warmSamples()`. - Con `preferences.sound === 'off'` no se descarga NADA — un pack que no se puede oír son bytes gastados en silencio. Pero la petición se RECUERDA en vez de tirarse: el nivel se lee en el dispatch, así que la primera reproducción audible vacía la cola y encender el sonido no devuelve una caché fría. ## Un `data:` se descodifica en el sitio `connect-src 'self'` BLOQUEA `fetch('data:…')` — la directiva casa por ESQUEMA y `'self'` no cubre `data:` — mientras deja pasar una ruta del mismo origen. Un pack inline enrutado por `fetch` caía a síntesis EN SILENCIO justo en el entorno que llevó a alguien a hacerlo inline. Y es ~6x más lento. `bytesFor()` lo resuelve con `atob`. ## De la revisión adversarial - Las claves del JSON se validan: una que no sea `SoundName` LANZA, igual que una ruta mala en `assertMapPaths` y por la misma razón — tragarse la errata da el síntoma «parte de mi pack no se aplicó» sin nada a lo que apuntar. - `isSoundName` preguntaba `name in SEMA_MAP.sounds`, y `in` recorre el prototipo: `isSoundName('toString')` devolvía `true`. Inofensivo mientras todos los llamantes tecleaban el nombre; nada inofensivo al validar red. - `warmSamples` sólo tenía una de las dos ramas que sí tiene el constructor, así que una app con canal de sonido propio se calentaba al arrancar y nunca más; y esa rama leía la preferencia UNA vez, en construcción. Las dos se caían por lo mismo: ahora comparten `warmUrls()` en vez de duplicarse. - El demo del catálogo cancela su fetch: elegir `inline` y saltar a `synth` antes de que llegara reinstalaba el pack sobre un `clearMap()` ya hecho. - `fallbackFor(name)` borra los dos casts que copiaba todo el que autorase un pack de ficheros. ## Documentación `architecture/sema.md` gana la sección de las dos formas de entrega y el párrafo de `preloadSamples` reescrito — describía un precalentamiento que ya no es el que ocurre. El README del arte conoce la ruta `data:`. La página de packs gana su sección equivalente y deja de señalar unos `.wav` sueltos como «el ejemplo». Y un fantasma: `soft` no existe — es un nombre del catálogo viejo que quedaba como ejemplo en ocho sitios, incluido el docstring de `applySounds`, cuyo ejemplo copiado literalmente LANZABA. `static/sounds/ui-inline.json` se genera desde `packs/ui-mp3.ts`; el comando está documentado ahí y reproduce el fichero byte a byte. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	11b54025d4	feat(sema): pack de ejemplo con ficheros mp3, recortados y normalizados ... El autor dejo una biblioteca de 35 mp3 en `static/sounds/ui` y pidio recortarlos y normalizarlos para usarlos como pack alternativo. Medidos ANTES de tocar nada, los originales tenian tres problemas que habrian hecho parecer roto al sistema: · LATENCIA DE ARRANQUE. `button_hard` no empezaba a sonar hasta los 347 ms. Un sonido de pulsacion que llega un tercio de segundo despues no confirma nada: se lee como eco. `button_squishy` 148 ms, `blocked` 78 ms, y varios mas con 25 ms de silencio de cabeza. · DURACIONES FUERA DE ESCALA. `item_select` 862 ms para seleccionar en una lista donde puedes recorrer cinco elementos por segundo — se solapan tres a la vez. `success_chime` 1591 ms. · NIVELES SIN NORMALIZAR, factor 14x entre picos (0.066 … 0.961): unos inaudibles al lado de otros. PROCESADO con ffmpeg: recorte de silencio en ambos extremos + loudnorm a −20 LUFS / pico real −1.5 dB, mono 44.1 kHz. Resultado medido en el navegador: TODOS arrancan en 0 ms, y las duraciones se desploman — `button_soft` de 862 ms a 28 ms, que resulta ser la longitud ideal para un toque; `copy` a 78 ms, casi exacto al `tick` sintetico. 292 KB en total. ⚠️ Los originales NO estaban en git y el procesado los reemplaza. Copia de seguridad de esta sesion en /tmp/ui-originales (efimera): si los quieres conservar, guardalos tu. EL PACK (`src/uix/sema/packs/ui-mp3.ts`) mapea 16 nombres a 16 ficheros. Es una TRADUCCION, no una busqueda: la biblioteca esta nombrada por componente (`button_`, `tab_`, `panel_`, `window_`) que es justo el eje que el vocabulario rechaza, asi que cuatro ficheros compiten por el nombre `open` y sobran quince. Cada entrada conserva como reserva el sonido sintetico del framework, de modo que un 404 degrada a la voz por defecto en vez de enmudecer. Lo imperfecto queda ESCRITO en el fichero, no escondido: `tick.fulfill` dura 425 ms y `tick.loss` 723 ms, muy por encima de la ventana perceptual que persigue el pack sintetico. Es el precio de usar material encontrado — suena mas rico y se comporta peor. Un pack grabado PARA este sistema se grabaria a sus duraciones. `engine.applySoundPack(pack)` instala entradas enteras (frente a `applySounds`, que retunea valores de las que ya hay); `clearMap()` revierte tambien el pack. Y el catalogo de la documentacion estrena conmutador: mismo nombre, otra voz, para comparar A OIDO. VERIFICADO en el navegador espiando el grafo de audio: con el pack por defecto `tick` crea dos osciladores a 850/1275 Hz; con `ui-mp3` crea un buffer de 78 ms y CERO osciladores. El cambio funciona de punta a punta. sema+morfo+soma 1075/1075 · uix sin errores de tipos nuevos. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	b30092dd06	Refactor air architecture: clean dependency boundaries, enrich Behavior/Dom, fix AudioContext ... - getAir() is now the single entry point — returns behavior, dom, translator, logger - behavior.play() encapsulates soundEnabled check + preset resolution - dom.resolve() resolves ResponsiveProp using current viewport/breakpoints - internal/ has no knowledge of config/ (correct dependency direction) - internal/ types stripped of Air prefix; public barrel re-exports with prefix - context.ts defines TranslatorService locally (structurally compatible with TerraTranslator) - button/text components updated to use only getAir(), no direct terra/config imports - AudioContext fix: withRunningContext() resumes on first user gesture before playing - AIR_IMPLEMENTATION_GUIDE updated: 12 semantics, correct APIs, current patterns Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	6 months ago
dev	9a9c4d4f14	Add air sound/motion/behavior systems, refactor responsive, update terra config and tokens	6 months ago