svelte-kit-vice/src/uix/eidos/components/tooltip/README.md

# Eidos Tooltip

Fecha de revision: 2026-05-17.

## Baseline

Air no tenia `tooltip` en `glm-5:src/uix/air/components`; este componente es
una envoltura visual sobre Soma/Morfo, no un port de Air.

## Comparativa

| Referencia | Superficie relevante | Estado Eidos |
| --- | --- | --- |
| Air `glm-5` | No existe `tooltip` en Air. | Sin baseline Air. La referencia local es Soma/Morfo. |
| Soma actual | `Group`, `Provider`, `Trigger`, `Content`, `Arrow`; delay/skip-delay, hover/focus, hoverable content, disabled, side/align/collision, Floating CSS vars, `aria-describedby`, `role="tooltip"`. | Cubierto por passthrough. Eidos solo anade receta visual. |
| Radix Tooltip | Provider global, Root, Trigger, Portal, Content, Arrow; abre en hover/focus, cierra en activacion del trigger o Escape, custom timings, collision, CSS vars para transform-origin/available size/trigger size. | Cubierto. Se alinea Soma para cerrar al click de trigger por defecto y Eidos consume vars de Floating para medidas/animacion. |
| Ark UI Tooltip | Root, Trigger, Positioner, Arrow/ArrowTip, Content; control, root provider, delay, positioning, fixed containers, context. | Cubierto salvo `Positioner`/`ArrowTip` explicitos: en UIX viven dentro de Soma Floating/Arrow. |
| Bits UI / shadcn-svelte | Provider recomendado en layout, Root, Trigger, Portal, Content, Arrow; delayDuration, skipDelayDuration, disableHoverableContent, forceMount, Floating vars, nested providers. | Cubierto. `disableCloseOnTriggerClick` se soporta en Soma como escape hatch. |

Fuentes externas consultadas:

- Radix Tooltip: https://www.radix-ui.com/primitives/docs/components/tooltip
- Ark UI Tooltip: https://ark-ui.com/docs/components/tooltip
- Bits UI Tooltip: https://bits-ui.com/docs/components/tooltip
- shadcn-svelte Tooltip: https://www.shadcn-svelte.com/docs/components/tooltip

## Decisiones

- No se crea `Tooltip.Positioner`. La posicion pertenece a Soma Floating;
  Eidos consume `data-side`, `data-align` y variables CSS publicadas por Soma.
- No se crea `Tooltip.ArrowTip`. Soma Arrow ya encapsula la geometria del
  arrow; la receta solo pinta fill/stroke.
- `Tooltip.Content` mantiene `size` y `variant`, y anade `matchAnchorWidth`,
  `width`, `minWidth`, `maxWidth`, `height`, `minHeight`, `maxHeight` como
  props visuales responsivas.
- Las medidas se serializan como variables privadas del recipe
  (`--_tooltip-content-*`); el contrato publico de tokens sigue siendo la
  recipe.
- La receta usa `--floating-transform-origin` para animaciones
  origin-aware y `--floating-available-height` como max-height por
  defecto cuando Floating ya lo conoce.
- Soma cierra al activar/clicar el trigger por defecto, alineado con Radix. Si
  se necesita mantenerlo abierto, usar `disableCloseOnTriggerClick`.

## Eventos Sema

El morfo declara tres eventos `emerge` minimos para que Sema pueda emitir
percepcion en hover/focus reveal: `emerge-present`, `emerge-dismiss` y
`emerge-dismiss-escape` (Escape) — verbos del libro cap. 26 §8/§9: el tooltip
se OFRECE (present), no se invoca como lugar (open).
Ninguno carga intent — la aparicion de un tooltip no tiene peso evaluativo
propio. Si una experiencia necesita reforzar percepcion al mostrar ayuda
contextual con un tinte concreto, esa politica debe vivir en el componente
que dispara el tooltip, no en Tooltip por defecto.

## Gaps

| ID | Disposicion | Detalle |
| --- | --- | --- |
| `ignoreNonKeyboardFocus` (Bits UI) | **diferir** | Sin caso real en accesibilidad/focus management. No debe vivir en Eidos hasta que aparezca el patron concreto. |
| `customAnchor` (Bits UI) | **diferir** | Popover ya cubre panel flotante anclado a otro elemento. Si Tooltip lo necesita, anadir primero a Soma. |
| `data-disabled` aplicado a `Trigger` | **implementar** | Morfo declara `data-disabled` opcional; soma debe propagar la prop del wrapped element. La receta ya estiliza el estado disabled. |
| Tinte sema configurable por `intent` prop | **descartar** | Reveal asistivo no carga intent; forzar uno duplica responsabilidades con el componente que dispara el tooltip. |
Add Eidos tooltip reference comparison 5 months ago			`# Eidos Tooltip`

			`Fecha de revision: 2026-05-17.`

			`## Baseline`

			Air no tenia `tooltip` en `glm-5:src/uix/air/components`; este componente es
			`una envoltura visual sobre Soma/Morfo, no un port de Air.`

			`## Comparativa`

			`\| Referencia \| Superficie relevante \| Estado Eidos \|`
			`\| --- \| --- \| --- \|`
			\| Air `glm-5` \| No existe `tooltip` en Air. \| Sin baseline Air. La referencia local es Soma/Morfo. \|
			\| Soma actual \| `Group`, `Provider`, `Trigger`, `Content`, `Arrow`; delay/skip-delay, hover/focus, hoverable content, disabled, side/align/collision, Floating CSS vars, `aria-describedby`, `role="tooltip"`. \| Cubierto por passthrough. Eidos solo anade receta visual. \|
			`\| Radix Tooltip \| Provider global, Root, Trigger, Portal, Content, Arrow; abre en hover/focus, cierra en activacion del trigger o Escape, custom timings, collision, CSS vars para transform-origin/available size/trigger size. \| Cubierto. Se alinea Soma para cerrar al click de trigger por defecto y Eidos consume vars de Floating para medidas/animacion. \|`
			\| Ark UI Tooltip \| Root, Trigger, Positioner, Arrow/ArrowTip, Content; control, root provider, delay, positioning, fixed containers, context. \| Cubierto salvo `Positioner`/`ArrowTip` explicitos: en UIX viven dentro de Soma Floating/Arrow. \|
			\| Bits UI / shadcn-svelte \| Provider recomendado en layout, Root, Trigger, Portal, Content, Arrow; delayDuration, skipDelayDuration, disableHoverableContent, forceMount, Floating vars, nested providers. \| Cubierto. `disableCloseOnTriggerClick` se soporta en Soma como escape hatch. \|

			`Fuentes externas consultadas:`

			`- Radix Tooltip: https://www.radix-ui.com/primitives/docs/components/tooltip`
			`- Ark UI Tooltip: https://ark-ui.com/docs/components/tooltip`
			`- Bits UI Tooltip: https://bits-ui.com/docs/components/tooltip`
			`- shadcn-svelte Tooltip: https://www.shadcn-svelte.com/docs/components/tooltip`

			`## Decisiones`

			- No se crea `Tooltip.Positioner`. La posicion pertenece a Soma Floating;
			Eidos consume `data-side`, `data-align` y variables CSS publicadas por Soma.
			- No se crea `Tooltip.ArrowTip`. Soma Arrow ya encapsula la geometria del
			`arrow; la receta solo pinta fill/stroke.`
			- `Tooltip.Content` mantiene `size` y `variant`, y anade `matchAnchorWidth`,
			`width`, `minWidth`, `maxWidth`, `height`, `minHeight`, `maxHeight` como
			`props visuales responsivas.`
			`- Las medidas se serializan como variables privadas del recipe`
			(`--_tooltip-content-*`); el contrato publico de tokens sigue siendo la
			`recipe.`
Advance Eidos component migration 5 months ago			- La receta usa `--floating-transform-origin` para animaciones
			origin-aware y `--floating-available-height` como max-height por
Add Eidos tooltip reference comparison 5 months ago			`defecto cuando Floating ya lo conoce.`
			`- Soma cierra al activar/clicar el trigger por defecto, alineado con Radix. Si`
			se necesita mantenerlo abierto, usar `disableCloseOnTriggerClick`.

tooltip: expand morfo + recipe states → PASS audit Closes the second BROKEN component from the audit (after date-range-picker). Five errors collapse to zero: - Morfo declares the three `emerge` events the recipe animations were already keying off (`open`, `close`, `close-dismiss`) plus a `texts.label` slot. `data-disabled` is now declared on `Trigger` (with optional severity) so the recipe rule has a real contract to land on. `aria-disabled` and `texts.label` round out the surface; the new `tooltip.label` catalog entry ships under `src/uix/langs/components/tooltip.ts`. - Recipe CSS: explicit `[data-tooltip-trigger][data-disabled]` and `[data-tooltip-trigger]:focus-visible` rules. The disabled rule suppresses pointer events; the focus rule provides a defensive outline so a focusable trigger shell is at least keyboard-visible. - README: convert the old `## Pendiente deliberado` section into a proper `## Gaps` table with explicit dispositions (implementar/diferir/descartar), and update `## Eventos Sema` to reflect that tooltip now declares its three emerge events instead of claiming zero. Comparativa was already complete; the regex fix from the previous commit picked it up. Audit: tooltip BROKEN → PASS. Project-wide goes from 1/64/2 to 3/64/0 (PASS / NEEDS-WORK / BROKEN). No more BROKEN components. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> 5 months ago			`## Eventos Sema`
Add Eidos tooltip reference comparison 5 months ago
tooltip: expand morfo + recipe states → PASS audit Closes the second BROKEN component from the audit (after date-range-picker). Five errors collapse to zero: - Morfo declares the three `emerge` events the recipe animations were already keying off (`open`, `close`, `close-dismiss`) plus a `texts.label` slot. `data-disabled` is now declared on `Trigger` (with optional severity) so the recipe rule has a real contract to land on. `aria-disabled` and `texts.label` round out the surface; the new `tooltip.label` catalog entry ships under `src/uix/langs/components/tooltip.ts`. - Recipe CSS: explicit `[data-tooltip-trigger][data-disabled]` and `[data-tooltip-trigger]:focus-visible` rules. The disabled rule suppresses pointer events; the focus rule provides a defensive outline so a focusable trigger shell is at least keyboard-visible. - README: convert the old `## Pendiente deliberado` section into a proper `## Gaps` table with explicit dispositions (implementar/diferir/descartar), and update `## Eventos Sema` to reflect that tooltip now declares its three emerge events instead of claiming zero. Comparativa was already complete; the regex fix from the previous commit picked it up. Audit: tooltip BROKEN → PASS. Project-wide goes from 1/64/2 to 3/64/0 (PASS / NEEDS-WORK / BROKEN). No more BROKEN components. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> 5 months ago			El morfo declara tres eventos `emerge` minimos para que Sema pueda emitir
feat(morfo,sema,eidos): todo evento dice de que familia es, y el cruce por fin se ve El framework llamaba a la misma cosa de dos maneras: `open` pelado en ocho componentes y `emerge-open` en tres. No era estetica — un preset de movimiento engancha el nombre con `^=`, asi que el dialecto pelado no casaba con ninguna firma y simplemente no animaba, sin romper una sola prueba. Los 40 nombres sin prefijo pasan a `{familia}-{verbo}[-{matiz}]`: 256 eventos, 256 con prefijo, 0 ambiguos. El plan decia 36 y decia `handle-drag-start`; eran 40, y el canon (c25) dice que esos verbos son `pick` y `drop` — `handle-pick` y `handle-drop` ya existian en 10 y 4 componentes. `validateMorfo` cierra la puerta: un `events[].name` que no empiece por su familia ahora lanza. Visto fallar antes con un nombre pelado inyectado. Lo que el renombrado destapo, y va aqui tambien: - La receta del splitter enganchaba `commit-resize`, muerto desde `bd2e40366`. No casaba desde mayo y nadie chillo. Reescrita por FAMILIA, como slider y knob, y `eidos-lint` valida ahora el VALOR de `data-event*` contra el catalogo de morfos — el guard que lo habria cazado en su dia. - La familia `shift` era muda en el canal visual, contra su propia doctrina (c27: el cruce debe percibirse; c34 tipifica el «shift invisible»). Su mapa ya describia la firma que le faltaba y su sonido por defecto es `slide`. Ahora tiene firma direccional: sexto atributo del sello (`data-event-direction`, `forward`\|`backward`, por emision) y deslizamiento de 320ms RTL-safe por `:dir()`. Medido: LTR -30px/+30px, RTL los invierte. - El sello de `shift-navigate` pasa del BOTON al `grid` en los cuatro calendarios. Medido: el boton recibia `contact-activate` y 8,5 ms despues —media trama— el `shift-navigate` pisaba la misma ranura y el `press-squeeze` moria sin pintar un fotograma. Una superficie, una ranura (A-36). - 101 contradicciones docs<->morfo adjudicadas con evidencia (git log, docs de decision, el componente vivo). Las docs desfasadas, corregidas; los nueve DEFECTOS de codigo obsoleto quedan abiertos y sin tocar. - `SoundDirection` -> `SoundContour`: era un contorno de tono, no un sentido, y habia tres cosas distintas deletreadas «direction». check en su linea base con 0 errores nuevos por diferencia de conjuntos · docs:check 0/0 · eidos-lint invalid 0 · el censo y las escenas de navegador medidas con raton real y rAF vivo. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> 2 months ago			percepcion en hover/focus reveal: `emerge-present`, `emerge-dismiss` y
			`emerge-dismiss-escape` (Escape) — verbos del libro cap. 26 §8/§9: el tooltip
			`se OFRECE (present), no se invoca como lugar (open).`
tooltip: expand morfo + recipe states → PASS audit Closes the second BROKEN component from the audit (after date-range-picker). Five errors collapse to zero: - Morfo declares the three `emerge` events the recipe animations were already keying off (`open`, `close`, `close-dismiss`) plus a `texts.label` slot. `data-disabled` is now declared on `Trigger` (with optional severity) so the recipe rule has a real contract to land on. `aria-disabled` and `texts.label` round out the surface; the new `tooltip.label` catalog entry ships under `src/uix/langs/components/tooltip.ts`. - Recipe CSS: explicit `[data-tooltip-trigger][data-disabled]` and `[data-tooltip-trigger]:focus-visible` rules. The disabled rule suppresses pointer events; the focus rule provides a defensive outline so a focusable trigger shell is at least keyboard-visible. - README: convert the old `## Pendiente deliberado` section into a proper `## Gaps` table with explicit dispositions (implementar/diferir/descartar), and update `## Eventos Sema` to reflect that tooltip now declares its three emerge events instead of claiming zero. Comparativa was already complete; the regex fix from the previous commit picked it up. Audit: tooltip BROKEN → PASS. Project-wide goes from 1/64/2 to 3/64/0 (PASS / NEEDS-WORK / BROKEN). No more BROKEN components. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> 5 months ago			`Ninguno carga intent — la aparicion de un tooltip no tiene peso evaluativo`
			`propio. Si una experiencia necesita reforzar percepcion al mostrar ayuda`
			`contextual con un tinte concreto, esa politica debe vivir en el componente`
			`que dispara el tooltip, no en Tooltip por defecto.`
Advance Eidos demos and form validation docs 5 months ago
tooltip: expand morfo + recipe states → PASS audit Closes the second BROKEN component from the audit (after date-range-picker). Five errors collapse to zero: - Morfo declares the three `emerge` events the recipe animations were already keying off (`open`, `close`, `close-dismiss`) plus a `texts.label` slot. `data-disabled` is now declared on `Trigger` (with optional severity) so the recipe rule has a real contract to land on. `aria-disabled` and `texts.label` round out the surface; the new `tooltip.label` catalog entry ships under `src/uix/langs/components/tooltip.ts`. - Recipe CSS: explicit `[data-tooltip-trigger][data-disabled]` and `[data-tooltip-trigger]:focus-visible` rules. The disabled rule suppresses pointer events; the focus rule provides a defensive outline so a focusable trigger shell is at least keyboard-visible. - README: convert the old `## Pendiente deliberado` section into a proper `## Gaps` table with explicit dispositions (implementar/diferir/descartar), and update `## Eventos Sema` to reflect that tooltip now declares its three emerge events instead of claiming zero. Comparativa was already complete; the regex fix from the previous commit picked it up. Audit: tooltip BROKEN → PASS. Project-wide goes from 1/64/2 to 3/64/0 (PASS / NEEDS-WORK / BROKEN). No more BROKEN components. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> 5 months ago			`## Gaps`
Advance Eidos demos and form validation docs 5 months ago
tooltip: expand morfo + recipe states → PASS audit Closes the second BROKEN component from the audit (after date-range-picker). Five errors collapse to zero: - Morfo declares the three `emerge` events the recipe animations were already keying off (`open`, `close`, `close-dismiss`) plus a `texts.label` slot. `data-disabled` is now declared on `Trigger` (with optional severity) so the recipe rule has a real contract to land on. `aria-disabled` and `texts.label` round out the surface; the new `tooltip.label` catalog entry ships under `src/uix/langs/components/tooltip.ts`. - Recipe CSS: explicit `[data-tooltip-trigger][data-disabled]` and `[data-tooltip-trigger]:focus-visible` rules. The disabled rule suppresses pointer events; the focus rule provides a defensive outline so a focusable trigger shell is at least keyboard-visible. - README: convert the old `## Pendiente deliberado` section into a proper `## Gaps` table with explicit dispositions (implementar/diferir/descartar), and update `## Eventos Sema` to reflect that tooltip now declares its three emerge events instead of claiming zero. Comparativa was already complete; the regex fix from the previous commit picked it up. Audit: tooltip BROKEN → PASS. Project-wide goes from 1/64/2 to 3/64/0 (PASS / NEEDS-WORK / BROKEN). No more BROKEN components. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> 5 months ago			`\| ID \| Disposicion \| Detalle \|`
			`\| --- \| --- \| --- \|`
			\| `ignoreNonKeyboardFocus` (Bits UI) \| diferir \| Sin caso real en accesibilidad/focus management. No debe vivir en Eidos hasta que aparezca el patron concreto. \|
			\| `customAnchor` (Bits UI) \| diferir \| Popover ya cubre panel flotante anclado a otro elemento. Si Tooltip lo necesita, anadir primero a Soma. \|
			\| `data-disabled` aplicado a `Trigger` \| implementar \| Morfo declara `data-disabled` opcional; soma debe propagar la prop del wrapped element. La receta ya estiliza el estado disabled. \|
			\| Tinte sema configurable por `intent` prop \| descartar \| Reveal asistivo no carga intent; forzar uno duplica responsabilidades con el componente que dispara el tooltip. \|