Registro de cambios

Este registro cubre el conjunto de documentación alojado en Arcanum y su acoplamiento al tema Liquid. Los cambios de comportamiento del tema siguen publicándose como versiones de tema en Shopify; revisa shopify/themes/studio-arcana/README.md para las comprobaciones manuales.

1.8.10 — Guías de comerciante placeholder completadas

• Documentación EN/ES completa para Ajustes del tema (resumen, marca, movimiento, SEO, forma, edad), superficies de bloques de apps, Ritual Builder, email/formularios, tipografía, esquemas de color, iconos/badges, transiciones de página, espaciado/densidad y CSS/personalizaciones avanzadas.
• Ritual Builder y Superficies de bloques de apps pasan a `blocks` estructurados (mismo renderizador que el resto de guías).
• PLACEHOLDER_ARTICLE_KEYS vacío — las guías críticas de puesta en marcha ya no son stubs. Docs: https://www.arcanumhollow.com/es/shops/docs/studio-arcana

Guías de producto, reservas y retail

• Guía Páginas de producto (EN/ES): buy box que prioriza Reservar, bloqueo de acciones retail, estado de galería, apilado fijo y datos estructurados.
• Configurar enlaces de reserva (EN/ES): montaje de app en el PDP de servicio, URL alternativa, etiqueta de consulta y pistas de programador externo.
• Conversión retail (EN/ES): checklist del PDP retail, emparejamientos de aftercare, Añadir al carrito fijo frente al cajón, y alcance del aviso de disponibilidad.

Lanzamiento en una tarde — prioridades, estados y detección honesta

• En el editor, Lanzamiento en una tarde muestra Siguiente (unas tres acciones) y Ver lista completa.
• Estados: Obligatorio, Recomendado, Completo, Verificación manual — siempre como texto; las filas incompletas explican qué falta, por qué importa y dónde corregirlo.
• Las reservas solo se completan con URL base o página booking — el proveedor por defecto no basta.
• Guía de lista completa de lanzamiento (EN/ES) actualizada al nuevo panel.

1.8.9 — Orden de ajustes en el editor del tema

• Los ajustes de sección y de bloque siguen un orden coherente: Contenido → Origen de datos → Acciones y enlaces → Diseño → Medios → Colores → Espaciado → Comportamiento avanzado.
• Las secciones grandes muestran encabezados de grupo; las pequeñas pueden omitirlos para acortar el panel.
• Los valores guardados no cambian: se conservaron los ID y los valores predeterminados. Consulta el resumen de ajustes del tema.

1.8.8 — Antes/después por servicio en plantillas de servicio

• Galería antes/después: origen Theme Editor (bloques, homepage) o producto actual (`custom.transformations` → metaobjetos `studio_transformation`) para resultados por servicio.
• Sin transformaciones en el producto, la sección se oculta en la tienda; el editor muestra una pista de configuración.
• product.service usa producto actual por defecto. Tras un push solo de código, configura Content source una vez en el editor si la plantilla remota sigue en bloques.

1.8.7 — Medios de Studio locations, tarjetas de paquetes, tokens de espacio

• Studio locations: Media type Map o Image, Media position Left o Right; campo Image opcional en studio_location (clave image) documentado para Custom data.
• Packages & memberships: imagen destacada del producto, misma presentación de tarjetas (estilo, hover, inclinación, sombra); CTAs con primary/contraste del esquema de color.
• Espaciado tipográfico compartido: --sa-eyebrow-heading-gap, --sa-heading-desc-gap, --sa-title-desc-gap y utilidades .sa-section-intro / .sa-title-desc.

1.8.6 — Rendimiento de la tienda (sin quitar funciones)

• Movimiento y engagement decorativos diferidos en idle (portafolio, lookbook, marquesinas, quiz, CTAs magnéticos, inclinación) para que la primera interacción sea más rápida sin eliminar funciones.
• Carga de scripts: el JS de producto ya no se carga en páginas genéricas (wishlist/compare sí); engagement también en blog, artículo y búsqueda para la búsqueda predictiva del header.
• Medios: banners de imagen a mitad de página con lazy-load; prioridad before/after solo si la sección es la primera del template.
• Comparar omite el trabajo de hidratación sin marcadores; productos vistos recientemente se inician en idle.

1.8.5 — Esquemas del diario, imágenes y pulido de modales

• Main blog, Main article y Featured blog: los esquemas de color pintan superficies, bordes, texto atenuado y acentos; divisores de sección disponibles.
• Imágenes y tarjetas: máscara de galería, línea fina, proporción, posición de recorte, inclinación y estándar vs editorial offset vía sa-article-card.
• El hero del artículo usa la misma máscara / proporción / posición que las tarjetas relacionadas.
• Vista rápida: se cierra tras un add to cart correcto, atrapa el foco y lo restaura al disparador, y abre/cierra con fundido y cambio de altura suave al cargar el contenido.
• Tabla de tallas, zoom de imagen y lightbox de portafolio usan el mismo patrón de atrapar/restaurar foco; los diálogos respetan reducción de movimiento y Animaciones desactivadas.
• Editor del tema: barra de Ajustes del tema reordenada (diseño antes que operaciones); Galerías y divisores sacados de Motion; Header, barra de anuncios y Main product reagrupados.

1.8.4 — Velo de capas modales

• Ajustes del tema → Colores: Color del velo y Desenfoque del velo para cajones, diálogos y ventanas emergentes.
• Tokens CSS compartidos (--sa-modal-scrim-color, --sa-modal-scrim-blur) en carrito, menú, vista rápida, tabla de tallas, galerías, boletín, verificación de edad, filtros y búsqueda predictiva.

1.8.3 — Diario / blog de primera clase

• Índice Main blog: entrada destacada, filtros por etiqueta y tarjetas paginadas.
• Main article: fecha, autor, etiquetas, compartir, progreso de lectura y relacionados.
• Sección Featured blog (Studio journal) para la portada, con estado vacío en el editor.
• Seeds con etiquetas aftercare / first-visit / policies / featured en los verticales.

1.8.2 — Utilidades del header, profundidad promo y evidencia de lanzamiento

• Header: coloca búsqueda, cuenta, carrito y otras utilidades en una franja fina encima del header principal, con orden y alineación propios.
• Ubicación del botón Book: con utilidades, al final del menú principal (estilo botón), o en ambos.
• Sección Baldosas promocionales: rejilla de campaña con insignias, CTAs y ventanas de programación opcionales (los descuentos siguen en el Admin de Shopify).
• Insignias en tarjetas: Oferta, agotado, Nuevo (badge:new / new), custom.product_badge o etiquetas badge:…; eyebrow opcional custom.card_label.
• Pruebas ampliadas para filtros/orden AJAX, mega menú, lookbook, carrito AJAX, booking dual-path, preset Beauty y metaobjetos vacíos.
• CI en modo secretos de staging para Playwright, visual y Lighthouse (PR sigue suave sin secretos).
• Docs: matriz de gaps competitivos, guías de conversión retail y búsqueda/descubrimiento, notas honestas de paridad.

1.8.1 — Social links desde metaobjetos

• Social links: modos Combinar / Metaobjeto / Manual; coincidencia automática de Studio specialist (profile_page) o Studio location (location_page), más selector opcional; los bloques manuales sustituyen la misma red.
• studio_specialist y studio_location ganan campos URL sociales opcionales y location_page; seeds y sync de definiciones actualizados.
• Las plantillas specialist-profile y studio-locations incluyen Social links (combinar) por defecto.

1.8.0 — Lanzamiento de excelencia para merchants

• Avisos de configuración en el buybox para productos de servicio, URLs de reserva faltantes e iconos de pago no disponibles en el editor de temas.
• Sección de reserva de configuración alternativa en /pages/booking con guía paso a paso para el merchant.
• Sección de insignias de confianza para bloques de licencias, esterilización y prueba de políticas.
• CTAs de recuperación del carrito: navegar servicios, reservar consulta y comprar productos post-servicio desde estados de carrito vacío.
• La lista de verificación de lanzamiento detecta automáticamente proveedores de pago y productos type:service.
• Las tarjetas de servicio muestran la duración desde metaobjetos o metafields del producto; las listas de metaobjetos muestran orientación de estado vacío.
• Nuevo evento analítico: studio-arcana:booking:click.
• Presupuestos de transferencia de rendimiento aplicados en el preflight del tema; matriz de Playwright ampliada a Chromium, móvil, WebKit y Firefox.
• Puente Reserve: ajuste de proveedor de reserva (Hollow Reserve recomendado, externo como alternativa), CTAs duales, handoff hollow-reserve:open y refresco de aftercare con hollow-reserve:booked.
• Estilo de tarjeta Full image background: la foto llena la tarjeta con texto superpuesto (opacidad de overlay, texto claro/oscuro sobre medios, altura del banner) en servicios, especialistas, productos, rituales, aftercare y before/after — la misma idea que Image banner, adaptada a rejillas.
• Hero service con imagen/video: el esquema de color sigue controlando texto, botones y el tinte de la superposición (Texto sobre medios por defecto = Esquema de color; Claro/Oscuro siguen como contraste forzado).
• Image banner (sección + bloque de columna): el esquema de color controla texto, botones y tinte de superposición; los botones usan el radio global de Theme settings.
• Vista rápida: se corrigió el estado de carga interminable por helpers de URL compartidos que faltaban en los bundles del tema.
• Buy it now / checkout acelerado: los botones de wallet usan el radio global; Buy it now sin marca usa los colores primary del esquema de la sección.
• THEME_VERSION alineado a 1.8.0 para la documentación RC de Theme Store en https://www.arcanumhollow.com.
• Lookbook: hasta cuatro hotspots por look con X/Y independientes, filtros/cargar más y máscaras de galería distintas.
• Portfolio gallery: carga progresiva (mostrar todo, cargar más o al hacer scroll) con lightbox limitado a las fotos reveladas.
• Studio locations: tarjetas compartidas, chips de especialistas, layout tabs/cards, cómo llegar, open-now, deep links y JSON-LD LocalBusiness por ubicación.
• Column splitter: columnas anidadas (títulos opcionales por columna) con bloques Image banner, FAQ y Studio locations para layouts lado a lado.
• Booking setup fallback: la etiqueta del botón ya no pasa texto del comerciante por | t (corrige Translation missing de Open booking); en blanco usa booking_setup.cta.
• Local trust: posición de imagen de insignias de certificación arriba, izquierda o abajo respecto al texto.
• Fila plegable (buy box): borde ninguno, solo inferior o completo, más radio de esquina opcional.
• Sección Social links: iconos de perfil colocables (Instagram, TikTok y más) en cualquier plantilla o grupo header/footer/aside.
• Carrito vacío: diseño destacado con ilustración bolsa/destello/personalizada, título/mensaje/apoyo compartidos y CTAs de recuperación en Ajustes del tema → Carrito.
• Pase de fiabilidad: precedencia de URL Continuar de sección, checkout del cajón con locale, MutationObserver del fallback de booking, enlaces padre en menú móvil, trampa de foco en filtros de colección, LQIP diferido, precarga de fuente de títulos desactivada por defecto, model-viewer diferido y presupuestos Lighthouse/rendimiento más estrictos.
• Guía de tallas (retail): contenido de tabla de ejemplo en el bloque (editable); página / custom.size_chart opcionales; título/intro/imagen de medida; tablas pulidas; oculto en PDPs de servicio.

1.7.0 — Documentación lista para marketplace

• Lista completa de lanzamiento ampliada: tienda/cuenta, marca, navegación, catálogo, servicios/especialistas/ubicaciones, reservas, recorrido de inicio, carrito/retail, SEO/privacidad, accesibilidad/rendimiento, analítica y publicación/entrega.
• Nuevas guías: Ubicaciones, Búsqueda y descubrimiento, Conversión retail, Retención y cuentas, Privacidad y consentimiento — más una guía de Rendimiento más profunda.
• Capacidades del tema: comparación opcional de productos (/pages/compare), aviso de disponibilidad en variantes agotadas, sección de recordatorio de reserva, presets Conversion Starter por vertical, filtros de especialidad en Equipo de especialistas y añadir todo al carrito para rituales.
• Resumen, Enlaces de reserva, Configuración de ingresos, Accesibilidad y Solución de problemas actualizados para capacidades listas para marketplace y los próximos presets Conversion Starter / Full Editorial.
• THEME_VERSION actualizado a 1.7.0 para marcar esta narrativa de documentación y preparación en https://www.arcanumhollow.com.

1.6.1 — Indicador y fondo en FAQ

• Preguntas frecuentes y políticas: **Posición del indicador** (borde izquierdo o derecho de cada pregunta).
• Preguntas frecuentes y políticas: **Fondo de la pregunta** — color de superficie o transparente (solo borde).

1.6.0 — Diferenciadores de página de producto de servicio

• Chips de servicio (duración, días de cicatrización, consulta), línea de tiempo de sesión, tarjeta de artista, contraindicaciones, nota de depósito y puerta de consentimiento (etiqueta **requires_consent**).
• Modos de barra de compra fija: Auto, Comprar, Reservar o Dual.
• Bloque de nota de ubicación; la plantilla **product.service** incluye galería antes/después opcional.

1.5.0 — Diseño de página de producto y bloques del buy-box

• Cuadrícula de escritorio medios | buy-box con posición de medios, tamaño y diseños de galería (carrusel, apilado, miniaturas, collage).
• Ocultar medios de otras variantes; diálogo de guía de tallas; filas plegables; icono con texto; iconos de pago en botones de compra.
• Modos de urgencia de inventario; franja de confianza; nota de disponibilidad; sección de productos relacionados; plantillas **product.service**, **product.retail**, **product.gift**.
• Nueva guía para comerciantes: Páginas de producto.

1.4.9 — UX de cantidad en el cajón del carrito

• Cajón del carrito: al cambiar la cantidad ya no aparece el esqueleto completo — un estado ocupado suave mantiene el panel visible.
• Tras actualizar la cantidad se restauran el scroll y el foco en el campo de cantidad de esa línea.
• El botón **Actualizar** por línea se oculta con JavaScript activo (la cantidad ya se guarda sola; Quitar sigue visible). El botón permanece sin JavaScript.

1.4.8 — Estilo del cajón del carrito

• Cajón del carrito: se corrigió CSS roto en líneas del carrito tras mover ajustes a Tema → Carrito.
• CTA de continuar, campos y paneles de upsell usan radio, superficie de tarjeta y botones primarios del tema para que el cajón coincida con Studio Arcana.

1.4.7 — Alineación del contenido en FAQ

• Preguntas frecuentes y políticas: **Alineación del contenido** (izquierda, centro o derecha) para el título y las respuestas en una misma columna.
• El título y la lista del acordeón comparten el mismo ancho para que centro y derecha queden alineados.

1.4.6 — Ajustes del tema: Carrito

• Ajustes del tema → Carrito: tipo (Cajón / Página), abrir al añadir, proveedor, pago acelerado, meta compartida, descuento, notas, CTA de vacío.
• Interruptores de upsells de servicio, reserva y recomendaciones retail en cajón y /cart.
• Las secciones Cajón y Carrito principal guardan título y mensaje vacío; el resto lee los ajustes del tema.

1.4.5 — Iconos y alineación en tarjetas de servicio

• Menú de servicios: cada tarjeta puede mostrar un icono predefinido o personalizado.
• Ajustes de sección: **Posición del icono** (arriba o izquierda del texto) y **Alineación del texto** (izquierda o centro).

1.4.4 — Sombra de tarjetas en reposo

• Ajustes del tema → Forma y espaciado: **Sombra de tarjetas en reposo** — Desactivado (plana), Sutil, Suave, o igual que el carácter del tema.
• Quita la sombra por defecto (sin hover). El lift al pasar el cursor no cambia.

1.4.3 — Color de descripciones cortas en esquemas

• Ajustes del tema → Esquemas de color: **Descripciones cortas** es un segundo color de texto para el copy de tarjetas (servicio, equipo, aftercare, ritual).
• Los títulos siguen usando **Texto**. Las tiendas existentes conservan la mezcla suave de Texto hasta que elijas un color.

1.4.2 — Menú secundario encima del encabezado principal

• Header: la ubicación del menú secundario incluye **Encima del encabezado principal** (y cajón + encima). Alineación izquierda, centro o derecha.
• Alineación de esa fila: izquierda, centro o derecha.
• Guía de navegación del encabezado actualizada (en + es). THEME_VERSION 1.4.2.

1.4.1 — Tamaños de padding de sección en Ajustes del tema

• Ajustes del tema → Forma y espaciado: píxeles Extra pequeño / Pequeño / Mediano / Grande / Extra grande para el padding de secciones.
• Padding superior/inferior por sección puede elegir Extra pequeño; los tamaños escalan con la densidad y el carácter del tema.
• Guías de comerciante: Forma y espaciado + referencia de densidad actualizadas (en + es).

1.4.0 — Epic standout: PDP modular, Markets, merchandising, locales

• Buy-box modular en PDP (precio, payment terms, vendor/SKU/inventario, destinatario de gift card, pickup, compartir, dynamic checkout).
• Selector de Markets en cabecera/pie; página gift-card promo; paridad AJAX del carrito y selling plans en el drawer.
• Secciones: featured product, collection list, image banner; hotspots de lookbook; ajuste micro-interactions.
• Ubicaciones, paquetes/membresías, especialista preferido en cuenta, corrección de productos del quiz, booking con location=.
• Locales fr/de/pt-BR (+ schema); dir RTL; paridad de guías en español.
• THEME_VERSION 1.4.0.

1.3.0 — Pulido de entrega: velocidad, bucle de ingresos, Theme Store

• La tienda carga JS minificado; Motion por defecto más ligero.
• Upsells de aftercare con Recomendado + También te puede interesar; el quiz puede enlazar a perfiles de especialista.
• Lista de lanzamiento con primera reserva y primera venta de aftercare.
• Plantillas service-detail por vertical; cuentas de cliente clásicas; list-collections; es.schema.json.
• Guías de comerciante reescritas en pasos simples (en + es).
• THEME_VERSION 1.3.0.

Announcement bar — programación (documentación)

• La página de la sección Announcement Bar documenta la programación de bloques Mensaje (ventana de fechas, días, zona horaria de la tienda, caché).
• Las páginas profundas de sección admiten scheduling_title, scheduling_lead y scheduling_bullets opcionales en JSON de theme-docs.

1.2.0 — Mejora de navegación del encabezado

• Modos de visualización de utilidades del encabezado (texto, iconos, iconos con etiquetas) con valores predeterminados móviles separados.
• Componente de cuenta Shopify (shopify-account) para cuentas de cliente nuevas; ajuste de menú de cuenta.
• Estilos de búsqueda: modal con icono, barra en escritorio o solo cajón; fila de búsqueda en el cajón.
• Opciones de diseño de escritorio incluyendo logo centrado en línea; menú móvil opcional separado.
• Enlace de teléfono, menú secundario, ubicación de utilidades en móvil y orden de utilidades.
• Nueva guía: Header navigation (en + es). THEME_VERSION 1.2.0.

1.1.0 — Lista de lanzamiento, paridad retail, guías de ingresos

• Panel Launch checklist en Theme settings con overlay en la vista previa del editor (sa-launch-checklist.liquid).
• Paridad Quick view: galería, selling plans y productos complementarios.
• Icono wishlist en header con badge de conteo localStorage; recomendaciones de producto en resultados del quiz.
• Nuevas guías: Launch checklist y Revenue setup (en + es).
• THEME_VERSION 1.1.0; filas D2 para quick view, wishlist y launch checklist.

1.0.0 — IA de documentación de primer nivel

• Navegación por categorías (instalación, guías, ajustes, secciones, referencia, avanzado, vídeos, actualizaciones, comentarios).
• Páginas de documentación por sección basadas en section-schemas.json generado.
• Bloques JSON estructurados (figuras, Looms, tablas de ajustes) y DocVersionBadge ligado a THEME_VERSION.
• Guías de ajustes del tema por área y mapa de plantillas y URLs para desarrolladores.
• Comprobador de paridad i18n (pnpm check:theme-docs) y script bootstrap para artículos nuevos.