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.

Talla y tema

23 clave(s) pública(s) en lib/recipes/base.ts (bloque tooltip), con sus pasos por talla y el nombre RESUELTO que consume la receta. Es el contrato vivo: la pestaña Tokens de su demo lista estas mismas claves y las resuelve sobre el escenario.

Token (--tooltip-…)	Valor por defecto
content-z	var(--z-index-overlay-tooltip)
max-width	22rem
padding-block-sm	var(--space-1)
padding-inline-sm	var(--space-2)
padding-block-md	var(--space-1-5)
padding-inline-md	var(--space-2-5)
padding-block-lg	var(--space-2)
padding-inline-lg	var(--space-3)
font-size-sm	var(--size-sm-font-size)
font-size-md	var(--size-md-font-size)
font-size-lg	var(--size-lg-font-size)
font-family	var(--style-label-font-family)
font-weight	var(--font-weight-regular)
line-height	var(--leading-text)
radius	var(--radius-md)
border-width	var(--border-width)
bg	var(--color-surface-overlay)
fg	var(--color-content-primary)
border	color-mix( in srgb, var(--color-border-default) 84%, var(--tooltip-bg) )
shadow	var(--depth-overlay-shadow), var(--depth-overlay-halo)
ghost-blur	var(--blur-md)
outline-arrow-bg	var(--color-surface-default)
outline-arrow-border	var(--color-border-strong)

Lo que el guard R-5.4 da por silencioso, con su razón medida (scripts/theming-sentinel-exceptions.ts):

• content-z — it lands on the floating WRAPPER, which carries no data-tooltip-* attr and so is outside the measured set; read on the wrapper -> reaches (90 -> 4321)
• bg — SUPERSEDED by the overlay plane: [data-depth=overlay] declares background at the same specificity and later in the cascade, so the recipe loses. Measured: --tooltip-bg moves nothing, --depth…
• border — same supersession: --depth-overlay-border repaints it, --tooltip-border does not
• shadow — same supersession: --depth-overlay-shadow repaints it, --tooltip-shadow does not
• font-family — same plane, the typography half of it (PLAN 12.9, unsigned)
• line-height — same plane, same open decision
• outline-arrow-bg — the arrow is painted through a SIBLING selector that needs the content carrying data-variant=outline AND the panel open; measured with the demo switch -> reaches (oklch(0.9911 0 0) -> rgb(1,…

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.