fpx · inventory_ui

Texto compacto del slot VACÍO en el paperdoll (greybox hasta E1-ART).

Raíles del paperdoll (izquierda/derecha del personaje, como la referencia).

Paginación v5 (pedido del diseñador): 50 huecos por página + scroll.

Filtro por categoría del catálogo: &"" = todas.

Orden del catálogo: &"slots" = los 20 huecos tal cual (con vacíos).

P-28 (sistemas_core §15.6) + v9: en combate NADA se cambia ni se consume (la ventana es consulta pura); la escena de combate lo activa.

Tecla de abrir/cerrar: Callable(InputEventKey) -> bool que INYECTA el juego (en el ejemplar, Keymap.matches(&"open_inventory", key)); sin ella, solo ESC.

Enlaza el panel a su fuente de datos (ver cabecera). layout null = el paperdoll por defecto del componente inventory.

FK-7 (Funpix Kit): el menú NO conoce al personaje del juego. Recibe el inventory (stock para «Destruir ×N»; null = 0) y un catálogo TOLERANTE de acciones: {&"equip": Callable(), &"use": Callable(), &"destroy": Callable(item) -> int, &"destroyed": Callable(count)}. Acción ausente o inválida = entrada apagada (equip/use) u oculta (destroy).

Etiquetas de los bonos §3 (GearBonus.FIELD_KEYS) y atributos §2 — en minúscula, estilo "341 vitalidad" de la referencia.

Rarezas del catálogo v2 (P-56 Fase B; escalafón del diseñador 2026-07-19: normal > poco común > raro > épico > legendario > mítico > angelical > trascendente). Cada tier: etiqueta, color propio del tema (UiThemeDefinition §Rareza de ítems) y rank — el peldaño del escalafón que gradúa los ornamentos del marco (RarityFrame). El ORDEN del diccionario ES el escalafón. &"comun" sigue sin teñir el nombre — compat con lo existente.

Clave de color semántico (UiTheme.color) de la rareza del ítem.

Peldaño del escalafón (0=común … 7=trascendente): decide cuánta filigrana dibuja el marco de la ficha. Rareza desconocida cae al peldaño 0.

Línea de tipo de la cabecera: "Arma", "Botas", "Consumible", "Recurso"…

Líneas de EFECTOS: [{"text": "+20 ATK de arma", "positive": bool}]. Para consumibles es su efecto (v1: heal, P-27); los bonos a cero se omiten.

--- Ficha mockup 2026-08-31 (DELTA kit-first, ver SYNC.md) ---------------- Icono de stat por clave de modifier (catálogo §4 del addendum del mockup): {shape, color} — shape es un glifo del catálogo SVG de ItemTooltip y color una clave semántica del tema. Placeholders procedurales hasta que exista arte (plan §4.4); clave desconocida cae a punto neutro.

Filas de efectos DESGLOSADAS para la ficha mockup: icono + valor + etiqueta, de modo que ItemTooltip coloree SOLO el valor (regla del mockup: valor en success/danger según signo, etiqueta en blanco). El valor va sin «+» (los positivos se leen por el color, como en la referencia); los negativos llevan «-». Consumibles: una fila sin valor (batería verde + texto del efecto).

Header de la sección de efectos: EFECTO en singular para no-equipo con un único efecto (consumibles/contenedores de la referencia), EFECTOS si no.

Set al que pertenece la pieza, buscándola por id en los sets INYECTADOS (SetCatalog.load_all() en el ejemplar; la ficha no escanea disco). null si ninguna lo lista o el ítem no es equipo.

Líneas de ESTADO de la ficha (forjamagia, nivel de mascota… del addendum): el campo status del esquema, saneado (vacías fuera). Vacío = sin sección.

Líneas del BANNER DE AVISO (bloque condicional del mockup, disponible para todos los tipos): el aviso libre del esquema (warning) + las restricciones de vínculo/economía ED-1 — que en la ficha mockup dejan de tener sección propia «VÍNCULO» y suben al banner.

Elementos del daño de arma (EFECTOS DEL ARMA): etiqueta de la línea + icono del catálogo §4. Elemento desconocido cae a etiqueta genérica con su nombre.

Características del arma (bloque sin header, addendum §1.2): filas {label, value, icon, icon_color} de las líneas con dato (> 0), en el orden de la referencia. El «Bonus de críticos» NO va aquí: es la columna derecha (weapon_crit_bonus_line). Vacío = el bloque se colapsa.

Columna derecha del bloque de arma: "Bonus de críticos +N" ("" si no hay).

Línea(s) de la sección EFECTOS DEL ARMA: mismo desglose que effect_parts (icono + rango en bold + etiqueta blanca). Sin daño (max <= 0) = sin sección.

Footer COMPLETO (3 filas con Ctrl teóricos y \ comparar) solo para lo equipable/comparable; el resto lleva el reducido (fila de Opciones + Alt).

Una línea de bono con signo: "+12 % de crítico" / "-10 iniciativa".

Ficha COMPARATIVA (UI-2, P-43 · P-56 §7.2): Δ de stats del ítem frente a la pieza equipada del MISMO slot. Devuelve [{"text": "+5 PV", "sign": 1|0|-1}] recorriendo el vocabulario §3 (GearBonus.FIELD_KEYS) y luego los atributos §2 (StatBlock.ATTRS). REUSA GearBonus para el diff — no reinventa el cálculo de stats (mismo agregado que entra al pipeline de StatBlock). equipped == null (slot vacío) → el ítem es todo-positivo: cada bono suyo se muestra como ganancia; un stat que solo tiene lo equipado sale como pérdida; delta 0 con ambos presentes = "=".

Una línea de diff con signo: "+5 PV" (verde), "-2 iniciativa" (rojo) o "= % de crítico" (sin cambio). sign es 1/-1/0 para que el tooltip elija el color semántico (success/danger/text_muted).

Efecto del consumible (v1: curación y otorga-misión; crece en F3, P-27).

Condiciones §8 para equipar (vacío = sin requisitos que mostrar).

Líneas de VÍNCULO y economía de la ficha (ED-1): ligadura, unicidad y no-venta — mismo estilo que condition_lines (vacío = nada que mostrar).

Miles con puntos ("2.157.835") para oro y precios.

Iniciales para slots SIN icono (greybox hasta E1-ART, P-34): "Espada de recluta" → "ER", "Chatarra" → "Ch".

Iniciales CRUDAS de un nombre cualquiera (slots de hotbar y fichas de skill): "Golpe Certero" → "GC", "Tajo" → "TA".

Tamaño del hueco del catálogo del inventario (InventoryPanel.SLOT_SIZE).

Margen del icono dentro del hueco: el arte no toca el marco del slot.

Pinta el CONTENIDO de un botón-hueco YA creado (el llamador pone el skin, el tamaño y la interacción). Idempotencia: no limpia — se llama sobre botones recién construidos, como en el refresh del inventario.

Hueco COMPLETO de solo lectura: skin de slot, tamaño, pintado y ficha rica cableada al hover. item == null devuelve el hueco vacío ("·", inerte).

Contador de stack en MINIATURA (abajo a la derecha): el MISMO look en el inventario, el botín y la barra de objetos (FK-7: antes vivía en HotbarSlot; la inversión de dependencia se corrige — la barra lo llama de aquí).

Ancho total de la ficha (mockup ~558 px de captura → ~340 a resolución de juego; plan de adaptación §4.1).

FIX-F evolucionado (mockup): las bandas de sección van EDGE-TO-EDGE, así que el aire lateral ya no lo pone el stylebox del panel sino el margen de cada bloque de texto. El stylebox del panel solo reserva el ancho del borde.

Ancho útil de una fila de texto: CONTENT_WIDTH - borde (2×2) - H_PAD (2×14). Los labels con autowrap lo llevan como ancho EXPLÍCITO — sin él, su altura mínima se infla antes del primer layout y reset_size() deja el panel gigante.

Glifos SVG 16×16 de los iconos de stat (catálogo §4 del addendum del mockup) — placeholders procedurales desde los colores semánticos hasta que exista arte (plan §4.4). {f} = fill, {s} = stroke del color del icono.

Cablea la ficha al hover de control. Los grids del inventario se reconstruyen enteros en cada refresh, así que basta conectar al crearlos; tree_exiting cubre el caso "el botón murió con el cursor encima".

Muestra la ficha pegada al Control (a su derecha; si no cabe, refleja a la izquierda). Descartar la anterior evita fichas huérfanas al mover rápido.

Construye la ficha SIN capa ni anclaje, para EMBEBERLA en un layout (una preview fija, la demo del kit): el llamador la añade donde quiera.

Icono de stat procedural (SVG desde el color pedido), cacheado por forma+color+tamaño. Forma desconocida cae al punto neutro.

Constructor.

Radio de esquina del marco de rareza (ItemTooltip lo aplica al stylebox): debe ser <= PATTERN_INSET para que ninguna diagonal del patrón asome por fuera de la esquina redondeada del panel.

Constructor.