Skip to Content
Diseño

Integración de componentes

Contrato de integración pública para componentes compartidos, Patrones, Skin y Tokens de estilo de Qokit.

Integración de componentes

Qokit utiliza un modelo de "esqueleto compartido + receta Skin". Los integradores externos dependen del contrato semántico e interactivo de los componentes, completando la adaptación visual a través de Skin y Token.

2026-10-20 · Acciones independientes en tarjetas de selección visual

Las opciones de EditorVisualChoiceGroup admiten un accessory opcional para menús o editores de nombre independientes. El RadioGroup compartido lo coloca junto a la etiqueta nativa, de modo que gestionar una tarjeta no activa su opción. afterOptions permite añadir una acción de catálogo, como crear una tarjeta, después de las opciones. El anfitrión controla la persistencia, los permisos, la validación y el foco tras sustituir o eliminar tarjetas. Las opciones sin accesorios conservan su estructura y comportamiento.

2026-10-17 · Movimiento compartido del panel del banco de trabajo

EditorWorkbenchChrome renderiza carriles inyectados de inicio/fin a través de BuilderWorkbenchFrame, el mismo esqueleto de panel utilizado por Creator y la edición de contenido. Los hosts proporcionan contenido, visibilidad y preferencias de ancho. Desktop rastrea y la opacidad/translación del panel comparten --qk-sidebar-motion-duration y --qk-sidebar-motion-easing; arrastrar desactiva transiciones y el modo de movimiento reducido cambia inmediatamente.

Los paneles colapsados permanecen montados para retener borradores. El marco compartido aplica inmediatamente inert y aria-hidden, mientras que la piel de la plataforma completa la salida antes de ocultar la visibilidad. Los paneles compactos retienen su geometría de superposición durante toda la salida; los hosts no deben añadir hidden ni display: none a la carcasa del panel. Los paneles de inspección explícitos retienen su comportamiento de revelación interactivo existente. Las opciones de encabezado siguen estando disponibles en estados abiertos/cerrados; utiliza EditorPanelChoiceShortcuts.mobileMenu cuando los destinos telefónicos deban compartir un menú.

2026-10-17 · Valores predeterminados medidos del editor

useWorkspaceResponsiveProfile acepta onWidthChange(width) opcional, informando del mismo ancho disponible del área de trabajo utilizado para perfiles responsivos después de deducir el relleno inline. Utiliza una devolución de llamada estable para derivar valores predeterminados proporcionales sin añadir otro observador. useEditorLayout aplica sharedWidths.limits a las preferencias del host así como al almacenamiento de ancho compartido; readEditorLayout acepta los mismos límites como su cuarto argumento opcional. Los llamadores existentes conservan sus límites y comportamiento predeterminados.

2026-09-30 · Accesibilidad de SelectionToolbar

SelectionToolbar.ariaLabel permite nombrar la barra como una región. El recuento sigue siendo un mensaje de estado en vivo. El anfitrión proporciona etiquetas localizadas y puede usar actionContent para combinar EditorToolGroup y ActionMenu compartidos; conserva las comprobaciones de permisos y los manejadores de acciones.

2026-09-10 · Insignias de identidad del espacio de trabajo

ProjectSwitcherProject.badge acepta contenido React opcional y no interactivo. Se muestra junto al nombre de cada elemento, en la fila de contexto actual que no figure en la lista y junto al nombre actual en un activador de texto. Los activadores de solo icono siguen siendo compactos; los activadores de texto de la plataforma ocultan la insignia en anchos de teléfono para conservar el nombre del espacio. El menú abierto sigue mostrando la insignia. El host aporta datos con el ámbito correcto, etiquetas localizadas y estilos de presentación; omitir el campo conserva la apariencia existente.

2026-09-08 · EmptyState

EmptyState centra el icon decorativo opcional, title, description opcional y action sobre una superficie transparente. layout="section" es compacto por defecto; layout="workspace" reserva más espacio. Coloque las acciones en action, con un fragment para varios botones; el contenedor gestiona espacios y etiquetas largas. El título es h2: use el slot title en lugar de strong. Se conservan las clases raíz y se admiten skin.vars y style. El anfitrión conserva textos localizados, permisos, navegación y creación; búsquedas y errores mantienen sus mensajes y acciones.

2026-09-08 · SidebarNavigation

SidebarNavigation precarga rutas del mismo origen tras 180 ms de pausa del ratón o al recibir foco de teclado. La navegación fija y emergente comparte un límite de 8 destinos cada 30 segundos. No precarga sin conexión, en pestañas ocultas, con Save-Data o 2G; excluye descargas, enlaces desactivados, ventanas nuevas y anclas de la misma página. La navegación y la protección de cambios se mantienen.

2026-09-07 - AccountDropdown / SidebarProfile

AccountDropdown admite compact y preferences opcionales: el modo compacto oculta identificadores e historial de creación; el contenido anterior se conserva por defecto. Appearance y Language aceptan triggerRole="menuitem" en el menú de cuenta. La navegación por teclado restaura el foco y los diálogos de idioma anidados gestionan Escape. SidebarNavigation.searchEnabled vale true por defecto; use false para una navegación breve y fija. SidebarProfile con href y sin menú abre el mismo destino en ambos modos.

2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace

Los formularios comparten escala tipográfica y ajustan textos largos; conservan formas de píldora y colores de marca. FormField nombra grupos: controlId y la id interior conectan la etiqueta. SearchField devuelve el foco tras borrar. Segmented y ControlMenu admiten opciones desactivadas; los elementos desactivados de ActionMenu no tienen enlace. Los botones ocupados conservan tamaño e indicador. AdminEntityDialog valida campos obligatorios, correo y JSON, enfoca errores, evita guardados duplicados y conserva datos ante fallos. EditorWorkspace ofrece ref.focusControl(element) para revelar paneles ocultos antes de enfocar. El movimiento reducido desactiva transiciones de controles. WorkspaceDialog desplaza el contenido largo manteniendo visibles cabecera y acciones; los diálogos móviles cortos se ajustan al contenido.

2026-09-07 · WorkspaceLocationSync / ProjectSwitcher

Al completar un cambio de ruta, WorkspaceLocationSync cierra el selector temporal de espacios y muestra las herramientas del destino. Se conservan las preferencias de búsqueda y secciones. El nombre del ámbito y su contexto aparecen en líneas separadas; los nombres largos de la cabecera se truncan dentro del botón.

2026-09-07 · Navegación unificada y superficies redondeadas Qokit

WorkspaceNavigationDock reutiliza la navegación y los permisos del anfitrión con items, fallback, className y onClickCapture, sin cargar otra sesión. Conserva la preferencia de vista expandida, iconos u oculta; hasta 860px utiliza el panel de navegación. PlatformHeader.leadingContext también aparece en EditorHeader. Se mantienen los botones de cápsula y las superficies redondeadas, eliminando bordes repetidos.

En escritorio, pulsar el menú oculta la barra lateral o restaura su último modo visible. Arrastrar el menú o el borde de la barra alterna entre oculta, solo iconos y expandida. Las flechas izquierda/derecha siguen la dirección de lectura. Cancelar el arrastre conserva la preferencia guardada; en móvil se mantiene el panel de navegación.

Montar WorkspaceLocationSync una vez bajo Suspense en el layout Next. useWorkspaceQueryState(key, defaultValue, validate) devuelve [value, setValue, ready]; useWorkspaceQueryRecord(key, defaults, validators) solo restaura filtros planos declarados. No guardar credenciales ni borradores en URL. WorkspacePage recupera posiciones de desplazamiento de sesión limitadas; las zonas internas usan data-workspace-scroll-region y WorkspaceScrollRestoration. La navegación nativa atrás/adelante cancelable reutiliza la protección de salida sin añadir historial. AdminEntityDialog conserva entradas tras errores y nuevos renderizados; el anfitrión controla versiones y resultados.

La gestión usa tamaños fijos: título de página 20px/650, sección 16px/600, texto y navegación 14px, etiquetas 13px y notas 12px. --qk-workspace-body-ink y --qk-workspace-active-ink derivan de los colores existentes.

Los botones principales de píldora conservan el azul del Logo #4695D8 y usan texto, iconos e indicadores de carga blancos en ambos temas. Se mantiene el ligero aclarado al pasar el cursor. Los botones secundarios y de peligro conservan sus colores semánticos.

Los desplegables y selectores de espacio comparten --menu-option-font-size (14px) y --menu-option-font-weight (500), con interlineado 1.45; la selección usa 600 y los metadatos 12px/400. WorkspaceNavigationDock precarga destinos del mismo origen al pasar el ratón o recibir foco de teclado, con deduplicación limitada. Se mantienen las protecciones al salir y las rutas del host.

2026-09-07 - ColumnLayout

ColumnLayout ocupa la ventana de gestión con navegación anclada, desplazamiento independiente y una barra de página fija. WorkspacePage usa secciones planas y Tokens de radio compartidos. Hasta 860px, la navegación sigue siendo un panel lateral, inactivo al cerrarse. Las propiedades y el comportamiento de negocio no cambian. Elimine márgenes exteriores duplicados y limite el ancho dentro de los formularios.

Punto de entrada

import { Button, Card, Dialog, IconButton } from '@qokit/components/ui';
import { PlatformHeader, SiteFooter } from '@qokit/components/patterns';
import { platformButtonSkin } from '@qokit/components/skins/platform';
import { siteCardSkin } from '@qokit/components/skins/site';
EntradaUso
@qokit/components/uiComponentes básicos como Button, Card, Dialog, Menu, Pill
@qokit/components/patternsCombinaciones como Header, Footer, área de trabajo, tabla, recursos y asistente IA
@qokit/components/skins/platformReceta visual de la plataforma y área de trabajo
@qokit/components/skins/adminReceta visual de Admin
@qokit/components/skins/siteGenerar receta visual del sitio

Límites de responsabilidad pública

PromptPanel acepta una propiedad referenceReader opcional y una propiedad referenceCopy localizada. El lector devuelve los contentExcerpt y las marcas truncated extraídos mediante file(File, AbortSignal) y website(url, AbortSignal) asíncronos; la autenticación y el acceso a la API son responsabilidad del host. El componente gestiona la lectura, la vista previa, el reintento y la eliminación; si una URL válida no tiene texto de aviso, referenceCopy.websitePrompt realiza la solicitud de forma suplementaria, y un formato incorrecto utiliza referenceCopy.errors.url y bloquea la lectura. Si la URL aún no se ha leído o está en proceso de lectura, el envío esperará al contenido más reciente y solo se enviará una vez; los cambios en la entrada o los fallos de lectura cancelan las acciones de envío pendientes, y el reintento no restaura los envíos anteriores. Los archivos deben estar listos antes de poder enviarlos. La URL completa se lee automáticamente al pegar, al perder el foco o al presionar Enter; la URL inicial también se lee y reutiliza los resultados en curso o completados; los fallos ofrecen un reintento claro. Editar o eliminar una URL cancela las lecturas anteriores y borra los resultados. Si no se proporciona un lector, se continúa con el envío nativo, sin procesamiento asíncrono de referencias.

La ingesta de referencias se añadió en septiembre de 2026 como una capacidad opcional y compatible hacia atrás del componente.

El componente esqueleto garantiza:

  • Etiquetas DOM y semánticas;
  • Comportamiento de ARIA, teclado, foco y disabled;
  • Estado e interacción básica;
  • Clase predeterminada estable;
  • Ranuras Skin nombradas.

Skin puede:

  • Añadir clases a ranuras como root, header, body, item y action;
  • Transmitir variables CSS a través de vars;
  • Utilizar los interruptores de tono, capa o adaptación visual ya publicados por el componente.

Skin no debe solicitar datos, cambiar el DOM, retener reglas de negocio o eludir el comportamiento de accesibilidad.

Generación de contenido de elementos

Los bloques personalizados generados siguen utilizando los elementos html-* registrados en Schema v2, sin usar HTML ejecutable ni nuevos tipos de bloque. Desde septiembre de 2026, @qokit/site-schema ofrece bindSiteModuleContent, updateSiteModuleBoundContent y forkSiteModuleContentBindings para el vinculado de contenido por idioma. Las rutas de contenido se guardan en los módulos, el texto para visitantes se guarda en el mapa de contenido por idioma, y las actualizaciones siguen las transacciones de deshacer y guardar; al copiar o mover elementos entre bloques, se deben derivar las vinculaciones para evitar alterar el origen.

El extensionRequirements opcional registra los requisitos de ejecución no resueltos, y no es un manifiesto de instalación ni una concesión de permisos. createSiteExtensionHandoff exporta solicitudes de desarrollo v1 no ejecutables; antes de publicar un sitio ejecutable, estos requisitos deben resolverse o excluirse explícitamente tras una revisión.

Controles de formulario

Los formularios compartidos utilizan FormField para asociar etiquetas, descripciones, metadatos de obligatoriedad, errores e ID de control. Los controles de texto utilizan Input, el contenido multilínea utiliza Textarea, y los controles de selección utilizan Checkbox, RadioGroup y Switch; los existentes Select y SearchField utilizan el mismo contrato de tamaño y estado.

import { FormField, Input } from '@qokit/components/ui';

<FormField label="Site name" description="Up to 60 characters" error={errors.name} required>
  <Input name="name" value={name} onChange={handleChange} />
</FormField>;

FormField asocia etiquetas, descripciones y errores con el único subcontrol mediante id, aria-describedby, aria-invalid y required. No envuelvas los controles compartidos con <label> adicionales.

Input, Textarea, Select y SearchField admiten tres tamaños: sm, md y lg, correspondientes a 40px, 44px y 48px. Los controles de una sola línea usan por defecto la forma pill; Textarea usa siempre el redondeo multilínea compartido. Los distintos estados de interacción y error provienen de los Tokens compartidos.

Durante la migración, sigue siendo posible usar el contrato antiguo .qk-field; las nuevas integraciones deben usar componentes compartidos y slots de Skin con nombre.

Selección en listas

Desde septiembre de 2026, las listas pueden usar useWorkspaceSelectionMode({ enabled, resetKey, onClear }) junto con WorkspaceFilterToolbar.selection. Este Hook comienza inactivo, se restablece cuando cambian el ámbito o los permisos, y distingue entre limpiar los ID seleccionados y salir del modo por lotes; la clave de ámbito debe incluir colección, idioma, paginación y filtros.

Pasa WorkspaceDataTable.selection solo cuando el modo por lotes está activo; la cuadrícula y los controles de casilla de verificación móviles usan el mismo modo. La barra de herramientas gestiona las operaciones de selección generales, y el usuario proporciona textos localizados, ID opcionales y operaciones de dominio verificadas por permisos. El opcional actionContent puede albergar semántica ARIA adicional, pero no sustituye a los controles generales ni a las confirmaciones. Las listas de solo lectura no muestran el modo por lotes, y los selectores de archivos y las revisiones de propuestas conservan su propia semántica.

Estas nuevas capacidades son opcionales y compatibles hacia atrás; la selección en tablas sigue siendo controlada explícitamente por el usuario.

Tarjetas de métricas

Nueva referencia de API (inglés; traducción pendiente) · 2026-10

DataCard provides a title and optional headerAction, body content with an optional emphasized value, and optional footerText and footerAction. Pass other body content as children. density="default" has a 144px minimum height and 20px padding; density="compact" has a 112px minimum height and 16px padding. Cards grow when content needs more room. variant selects the shared Card surface: surface, muted, or state. Choose these shared sizes instead of overriding height, padding, or value typography in route CSS.

Use shared UI controls in action slots. Keep the card root non-interactive when it has actions; a whole-card action cannot contain nested buttons or links. MetricCard composes the same skeleton and retains label, detail, semantic tone, and optional visuals.

import { DataCard, MetricCard } from '@qokit/components/patterns';
import { Button } from '@qokit/components/ui';

<DataCard
  title="Published"
  value={24}
  headerAction={<Button size="sm" variant="ghost">View</Button>}
  footerText="Up 3 from last week"
  footerAction={<Button size="sm" variant="secondary">Details</Button>}
  density="compact"
/>;

<MetricCard density="compact" label="Published" value={24} tone="success" />;

Logo muestra una imagen estática por defecto. motion="breathe" reserva su espacio mientras está oculto y lo revela una sola vez con una animación de respiración de 4,8 segundos cuando la página está cargada y al menos la mitad es visible. Cabecera y pie no añaden espera. motionVisibilityDelayMs permite exigir visibilidad continua adicional y vale cero por defecto. motionOnceKey comparte el registro de reproducción entre montajes del mismo documento; cabecera y pie usan claves distintas. Navegar, cambiar el tema o volver a desplazar no repite la animación; una recarga completa la restablece. Con movimiento reducido, JavaScript desactivado o sin observación de visibilidad se muestra el logo estático. motion="reveal" sigue siendo un alias.

PlatformHeader.autoHideOnScroll vale false por defecto; PublicPlatformHeader lo activa. La cabecera se oculta al bajar y vuelve al subir o cerca del inicio. Los menús abiertos y el foco dentro de la cabecera la mantienen visible. Las cabeceras del espacio de trabajo y del editor permanecen fijas.

PlatformHeader es el esqueleto del Header sin estado de negocio. PublicPlatformHeader combina sobre él entradas de marca, navegación pública, idioma, tema, inicio de sesión, "Prueba ahora" y menú móvil; el estado anónimo de la plataforma y el sitio de documentación reutilizan directamente esta combinación.

La navegación pública genera uniformemente "Recursos / Precios / Noticias" a través de buildPublicHeaderNavItems(copy, links). Los integradores solo deben analizar las URL internas del sitio, del sitio de documentación y de la plataforma de la aplicación actual, no deben redefinir el orden o el texto del menú. El Header de la plataforma después de iniciar sesión también utiliza la misma función de generación.

<PublicPlatformHeader
  copy={headerCopy}
  links={{
    brandHref: '/',
    resourceCenterHref: '/resources',
    userManualHref: 'https://docs.qokit.com/manual',
    developerDocsHref: 'https://docs.qokit.com/developers',
    changelogHref: 'https://docs.qokit.com/changelog',
    pricingHref: '/pricing',
    newsHref: '/news',
    loginHref: '/login',
    studioHref: '/studio'
  }}
/>

El navItems subyacente aún soporta link, scroll y menu. menu soporta cierre por clic, teclado, Escape y clic externo en escritorio, mientras que en móvil MobileHeaderMenu se expande en grupos de enlaces.

SiteFooter es el esqueleto del Footer; la plataforma y el sitio de documentación utilizan PublicPlatformFooter para combinar uniformemente el Shell exterior, entradas de marca, enlaces, controles de tema e idioma. La integración entre dominios convierte enlaces relativos de la plataforma en direcciones absolutas a través de resolveCompanyHref.

<PublicPlatformFooter
  brandHref="https://qokit.com"
  copy={footerCopy}
  resolveCompanyHref={(href) => `https://qokit.com${href}`}
/>

Las aplicaciones de negocio no deben copiar el DOM del Header/Footer ni el array de navegación pública; si se requiere una presentación visual diferente, utilice PlatformHeaderSkin, SiteFooterSkin o el Skin de la plataforma correspondiente.

Estrategia de compatibilidad

  • Añadir propiedades opcionales y ranuras Skin constituye un cambio compatible hacia atrás;
  • Eliminar propiedades, modificar la semántica predeterminada o cambiar el comportamiento de DOM/teclado constituye un cambio destructivo;
  • Los cambios destructivos deben entrar en el Changelog y proporcionar ejemplos de migración;
  • No dependa de clases internas, directorios o estructuras de ruta no publicadas;
  • Cuando dos o más puntos de integración requieren la misma sobrescritura, deben elevarse a Skin o Token público.

Edición a pantalla completa

EditorWorkspace reúne un diálogo a pantalla completa, gestión del foco y paneles adaptables. dirty confirma si se descartan los cambios, busy impide cerrar durante el guardado y onSave responde a Ctrl/Cmd+S. La aplicación gestiona permisos, datos, guardado y publicación.

view / onViewChange alternan entre edit, focus y preview sin sustituir el editor. preview aporta la vista previa; previewPanel reutiliza un panel. layout admite writing, structure y canvas. storageKey recuerda anchos y paneles contraídos, nunca el documento.

onSaveAndClose devuelve true tras confirmar el guardado, false si falla, handled si el anfitrión ya navegó o pending si la validación necesita una decisión. Un fallo mantiene abierto el editor. Usa closeBehavior="collapse" solo si el anfitrión conserva el borrador. EditorSaveStatus refleja estados confirmados. También pueden componerse EditorViewControls, EditorLeaveDialog y useEditorLayout.

Migración del teclado: Segmented ocupa una sola parada de Tab y cambia con flechas / Home / End. Dialog respeta Escape consumido por una capa secundaria; después el editor sale del enfoque o la vista previa antes de cerrarse. LivePreviewToolbar.exitControl acepta los controles compartidos. El guardado, la publicación y los permisos siguen a cargo del anfitrión.

import { EditorWorkspace } from '@qokit/components/patterns';

<EditorWorkspace
  open={open}
  title={title}
  dirty={dirty}
  busy={saving}
  onClose={closeEditor}
  onSave={saveDraft}
  onSaveAndClose={saveDraft}
  saveState={saveState}
  layout="writing"
  storageKey="article"
  preview={preview}
  navigation={structure}
  inspector={properties}
  actions={saveActions}
>
  {editor}
</EditorWorkspace>

SidebarToggleSlot

SidebarToggleSlot sitúa el control de la barra lateral en la cabecera. Usa un único espacio con una barra lateral izquierda. SidebarNavigation conserva el estado, los atajos y el panel móvil; sin este espacio mantiene los controles originales. El botón de la cabecera también cierra el panel móvil; al cerrarlo, el foco vuelve a ese mismo botón.

EditorHeader

EditorHeader conserva el logo, la cuenta y el menú global del anfitrión en el editor activo. startControl y endControl controlan los paneles laterales; center, las vistas; y actions, el guardado. PlatformHeader.editorActions reutiliza la navegación adaptable, el idioma y el tema. onNavigate debe resolver los cambios sin guardar antes de ejecutar su callback. En pantallas estrechas, la cabecera usa dos filas; los submenús procesan Escape primero.

WorkspaceHeaderPortal.startControl y endControl colocan alternancias de panel de página gestionada en las ranuras coincidentes del host. Los hosts exponen startTarget y endTarget opcionales junto con título, estado y acciones. La biblioteca de archivos y el espacio de trabajo de un solo activo utilizan workAreaControls; la vista previa de activos mantiene el encabezado completo para que su identidad, acción de retorno y destinos de panel sigan estando disponibles. ProjectWorkspace posee las elecciones de navegación/conversación izquierda compartidas para Contenido y Archivos. Archivos registra sus dimensiones recordadas del panel de recursos a través de useProjectResourcePanel, portaliza la navegación a través de ProjectContentTools, y proporciona únicamente su control inspector derecho a través de ProjectToolbar.endControl. La conversación utiliza la misma carril izquierdo y compositor integrado entre áreas de proyecto; las tareas compactas de recursos, conversación e inspector son mutuamente excluyentes.

EditorNavigationMenu

EditorNavigationMenu reutiliza toda la SidebarNavigation del anfitrión en un panel superpuesto, conservando permisos y contexto del proyecto sin desplazar el lienzo. Idioma y tema quedan abajo; los submenús procesan Escape primero. Concentración y pantalla completa del navegador son independientes. La navegación espera los guardados en curso y protege los borradores.

WorkspaceNavigationMenu / WorkspacePageHeader

La navegación global usa Command+\ en Mac o Control+\ en Windows/Linux, también de forma independiente dentro de Creator. T y Shift+T conservan el control del diseño del editor. Se ignoran los campos editables, la composición de texto, las repeticiones y los eventos ya procesados. Las indicaciones del botón y aria-keyshortcuts muestran la combinación; la navegación global ya no utiliza T por sí sola.

Los espacios con sesión iniciada usan PlatformHeader.workspaceActions para compartir cuenta y navegación en cualquier ancho. WorkspacePageHeader unifica títulos y acciones. WorkspaceNavigationMenu muestra la barra lateral actual con sus permisos y contexto; EditorNavigationMenu sigue como alias compatible. Studio conserva su barra de herramientas. Las cabeceras públicas mantienen su presentación.

WorkspaceNavigationGuard protege la navegación global con dirty, busy, error y onSave opcional. Solo un guardado confirmado que devuelve true permite salir; los errores conservan el borrador. Language.onBeforeChange(apply) permite aplicar la misma protección al cambiar de idioma. Desactiva los campos mientras se guarda.

La navegación de escritorio conserva la barra expandida y los iconos, y añade ocultación automática. La barra y el panel comparten búsqueda y grupos abiertos. Con un puntero preciso, el borde abre una vista temporal tras 300ms y la cierra 320ms después de salir; un clic la mantiene abierta. Se conservan los controles táctiles y de teclado. Dialog usa por defecto modal={true} y autoFocus={true}; la vista temporal establece ambos en false para conservar el foco y el desplazamiento.

EditorViewControls

Un botón cambia en ambos sentidos: al editar muestra Concentración y al concentrarse muestra Editar. Haz clic o pulsa T; E vuelve directamente a editar. En cabeceras estrechas, el botón sigue visible y la vista previa, pantalla completa y acciones adicionales están en Más.

EditorViewControls separa Edición/Concentración de la pantalla completa nativa. La vista previa es un control independiente que vuelve al modo anterior; useEditorWorkMode conserva ese modo para salidas personalizadas. Los valores edit/focus/preview siguen siendo válidos. La vista previa usa ahora un button con aria-pressed en lugar de un radio del grupo de modos. La pantalla completa requiere un clic e incluye navegación y diálogos en la raíz de la aplicación; se oculta si no está disponible.

Language / Appearance

Language y Appearance variant="menu" admiten layout="row" para mostrar etiqueta, valor actual y flecha. Se mantienen el diseño compacto predeterminado y la protección al cambiar de idioma. SiteHeaderCopy.helpResources y contactSupport permiten nombrar los enlaces de ayuda del espacio de trabajo.

requestWorkspaceNavigation

Las páginas con un control de barra lateral omiten el botón de menú adicional del encabezado, también en diseños contraídos y móviles. Los editores y las páginas sin barra lateral lo conservan. Importe requestWorkspaceNavigation(returnFocusTarget?) y useWorkspaceNavigationState() desde @qokit/components/patterns/WorkspaceNavigation: la solicitud alterna el panel registrado y devuelve false si no existe. El elemento opcional recupera el foco al cerrar. Compruebe .available antes de mostrar otro acceso. Use el control existente o esta API en lugar de la posición DOM del botón eliminado.

WorkspacePanelReveal

La navegación global usa un icono de menú y las herramientas iconos de panel direccionales. useWorkspacePanelReveal({ temporary: true }) abre herramientas temporalmente con clic o teclado en Concentración. toggle(trigger?) y close(true) conservan el diseño y el modo, y devuelven el foco. El borde abre la navegación global; las herramientas responden junto a sus botones. La vista previa oculta los controles de panel y ofrece volver explícitamente al modo de edición anterior.

EditorViewControls / Modo de visualización

EDITOR_VIEW_SHORTCUTS → Tooltip + aria-keyshortcuts

EditorHeader también gestiona EDITOR_TOOLBAR_SHORTCUTS: Command/Control+S activa el EditorSaveButton visible, Shift+P abre EditorStatusAction shortcut="publish" y Shift+M abre el menú de herramientas. Se usan los mismos controles habilitados que al hacer clic; publicar requiere una acción explícita en el panel. Solo responde la cabecera visible activa. Los menús, diálogos, la composición y los eventos repetidos bloquean los atajos; en campos editables solo se permite guardar. Las indicaciones comparten las definiciones de aria-keyshortcuts. Un toolsControl personalizado añade aria-keyshortcuts={EDITOR_TOOLBAR_SHORTCUTS.tools.aria} a su botón. ActionMenu.triggerKeyShortcuts añade el atributo y la indicación, sin registrar un comando global.

Los paneles usan Shift+A (añadir), Shift+L (páginas/capas), Shift+K (conversación), Shift+C (contenido), Shift+D (diseño) y Shift+G (estilo global). CMS añade Shift+S (ajustes), Shift+E (SEO) y Shift+H (historial) cuando están disponibles. Los metadatos shortcut de EditorChoiceControl, EditorViewTabs y ActionMenu comparten indicaciones. EditorPanelChoiceShortcuts y EditorViewControls.compactActions conservan las acciones al plegarlas en menús, también en teléfonos. EditorPanelShortcuts.commands registra acciones existentes sin duplicar controles. Se respetan los estados oculto, inert, deshabilitado, vista previa y las superposiciones. Las barras móviles no modales del mismo espacio permiten cambiar paneles; los menús y diálogos modales bloquean los atajos. Las teclas sin modificador conservan su comportamiento.

Modo de visualización
EEditar
TEditar ↔ Concentración
VVista previa / Volver a editar
FEntrar en pantalla completa / Salir de pantalla completa

Solo responde el editor activo. La escritura, la composición IME, las teclas mantenidas y los diálogos o menús secundarios abiertos no cambian el modo.

PlatformHeader.workspaceNavigation

PlatformHeader.workspaceNavigation sitúa la navegación global antes del logotipo; workspaceActions y editorActions mantienen las acciones de cuenta. Los espacios reutilizan el control de la barra lateral y los editores colocan el control del panel derecho antes del avatar. En pantallas estrechas, navegación, marca, título y avatar aparecen sobre las herramientas y Guardar. El orden del DOM sigue la disposición y se conserva el efecto esmerilado sin bordes.

2026-09-06 - EditorHeader.preview / EditorViewControls.returnView

EditorHeader.preview muestra solo center como barra de vista previa compacta sin bordes; logotipo, cuenta, guardado y paneles siguen montados pero ocultos. Con una LivePreviewToolbar independiente se puede ocultar la cabecera del editor y usar EditorViewControls.returnView (edit o focus) para recuperar el modo anterior. Mantenga accesibles el regreso y la pantalla completa independiente; la cabecera del sitio sigue visible.

2026-09-06 · Builder / CMS

Builder y CMS comparten BuilderWorkspace, EditorCatalog y EditorComponentSettings para paneles, gráficos de inserción y ajustes visuales. Los preajustes aplican juntos los ajustes relacionados y conservan el contenido; cada aplicación gestiona el guardado y el deshacer. Los controles usan el tema de la plataforma y el contenido usa el del sitio.

Pie de página renderizado en el servidor · 2026-09-07

SiteFooterLayout recibe un locale explícito y un copy de un solo idioma. Los componentes de servidor renderizan la estructura compartida del pie de página; los controles de tema e idioma y el diálogo QR siguen siendo componentes de cliente. Las interfaces existentes SiteFooter y PublicPlatformFooter siguen siendo compatibles.

import { SiteFooterLayout } from '@qokit/components/patterns/SiteFooter';

<div className="qk-platform-footer-shell">
  <SiteFooterLayout locale={locale} copy={footerCopy} />
</div>

Resuelve los enlaces entre dominios en copy.companyLinks en el servidor. Usa controls para personalizar el espacio de controles interactivos.

EditorHeader.titleControl / FloatingAssistant.presentation

EditorHeader.titleControl y EditorWorkspace.titleControl permiten sustituir el título por el menú compartido del proyecto. Conserve un title descriptivo y la protección de cambios sin guardar al navegar. FloatingAssistant.presentation="embedded" muestra una región con nombre dentro del panel anfitrión, sin botón flotante ni fondo superpuesto; el valor predeterminado sigue siendo floating. El anfitrión controla posición y visibilidad; el asistente conserva el estado de conversación y los permisos.

2026-09-07 · WorkspaceAssembly

WorkspaceAssembly marca las tarjetas salientes y las secciones entrantes sin añadir un contenedor. Aplica workspaceAssemblyAttributes(part, index, phase) al DOM existente cuando el diseño exige hijos directos. EditorHeader.assemble y BuilderWorkspacePanels.assemble proporcionan estas marcas al editor.

Llama a await startWorkspaceAssembly(navigate, destinationPathname) solo tras crear correctamente: captura las piezas visibles, navega una vez y compone el destino o su esqueleto en un máximo de 720 ms. El destino requiere una marca entrante canvas; useWorkspaceAssemblyPending() mantiene la carga montada hasta completar las capturas mientras se precargan datos y código. Con movimiento reducido o sin soporte, navega directamente. Las transiciones lentas o interrumpidas liberan las capturas y continúan. Las marcas no animan ediciones, recargas ni navegación del historial. El patrón limpia los estilos temporales; el host conserva errores, idempotencia y carga.

2026-09 · Espacios de administración

WorkspacePage y WorkspaceLayout aceptan variant: overview, list, detail, settings o editor. WorkspaceFormFooter organiza actions, message, tone y busy del anfitrión; este conserva la responsabilidad de guardar.

Las tablas estrechas (WorkspaceDataTable, AdminDataTable) muestran registros etiquetados con selección, cabeceras personalizadas y acciones. Use mobileLayout="scroll" para matrices comparativas. WorkspaceFilterToolbar coloca búsqueda y filtros antes de orden y vista. La barra lateral usa h2; la página usa h1.

2026-09-08 · Task focus

useSidebarTaskFocus(active) oculta temporalmente la navegación durante una tarea de concentración. Al salir restaura la vista anterior, salvo que el usuario cambie el modo. La ocultación automática no modifica la preferencia guardada.

Nueva referencia de API (inglés; traducción pendiente)

EditorHeader.contextMode="title" displays the editor's own titleControl instead of the host workspace picker. The default "host" behavior is unchanged; navigation, brand, account controls and leave guards retain their existing ownership. Hosts supply responsive placement for their title control.

EditorViewControls.focusInMenu shows a labelled preview action and moves focus mode into the shared menu. Its default remains false; view shortcuts and returning from preview keep the existing behavior.

EditorViewControls.toolsControl replaces the fallback menu with a host-owned tools control. Hosts retain its accessible trigger, menu state and actions; view buttons and keyboard shortcuts keep their existing behavior. Creator uses this slot for its complete editor tools menu beside Add, Layers and Preview.

EditorViewControls.responsiveLabels displays text beside focus and preview icons above 720px, reserving space for both focus labels. At phone widths the labels are hidden while accessible names and tooltips remain. EditorSaveButton.showStatusLabel displays saved/saving status or a retry action when state is provided; it reserves label space across states. Both options default to false.

ResizablePanels.middlePanelProps forwards section attributes such as inert to the middle panel, matching the existing side-panel attribute slots. An editor can keep its canvas mounted while preventing keyboard and pointer interaction when a compact conversation view covers it. Hosts still control panel visibility and restore focus when switching views; the prop does not unmount content.

ProjectSwitcher.currentWorkspaceId optionally marks the parent workspace independently of currentProjectId; only the current location receives the selected surface. IDs must match the supplied projects items. onActionSelect(action, event) lets the host guard shortcut navigation after the menu closes; omitted callbacks retain normal link behavior. Creation shortcuts use ordinary menu surfaces. Optional SiteHeaderCopy.projectSwitcherCreate and projectSwitcherWebsites label creation and the current workspace's website group without renaming the Creator product.

AccountDropdown.usageSummary is an optional slot below the account identity for host-supplied credit balances, plan usage and links to details. It also accepts ({ environmentInfo }) => ReactNode to place the shared ID disclosure and copy controls in the summary without duplicating them below. Links use role="menuitem" and retain menu keyboard behavior and navigation guards. The platform header shows credits and plan usage in two columns, with ID details expanding below; the sidebar account retains appearance and language. Failed reads never appear as zero, and reopening the menu refreshes the data.

PublicPlatformHeader.workspaceAction optionally supplies { href, label } for an authenticated visitor's return link. It replaces the desktop login icon and stays visible beside the mobile menu; the mobile menu then omits anonymous account actions. Session detection belongs to the host. The platform home uses a lightweight local session check, updates after focus/storage changes, and keeps ?view=public on its brand link so explicit website visits survive refresh.

contextAfter places editor-specific scope controls after the host project picker, preserving their DOM and keyboard order. The host retains project navigation and leave guards; the editor owns page and content-language selection. Hosts may adapt the responsive layout to put this context on its own row.

WorkspaceNavigationMenu.footerLinks supplies direct icon links alongside the sidebar display control. footerMenus accepts ordered WorkspaceNavigationFooterMenu entries, each with a label, icon and link items (with optional separatorBefore). The platform uses one menu for Website Home, Pricing, Templates and News, and a book-icon Help & Support menu for the user manual and contact support. The single footerMenu prop remains supported when footerMenus is omitted. Desktop menus open upward with ActionMenu placement="top" portal; mobile uses bottom sheets. The controls form one row when expanded and a column in icon mode; on mobile the sidebar control closes the navigation drawer. Each icon retains an accessible name and tooltip. profile adds the user name, plan and account menu without duplicating an existing sidebar account. Omitting footer links and menus retains the existing preferences and fullscreen actions.

Set a footer menu item's newTab to open a reference destination with target="_blank" and rel="noopener noreferrer". The skeleton adds a trailing arrow and localized screen-reader notice; other items keep current-page navigation. Website Home, Pricing, Templates, News, the manual and contact support use new tabs so the workspace stays open. An explicit public-home visit preserves ?view=public to bypass the signed-in landing redirect, including after refresh.

Editor tool palettes can use Dialog with keepMounted to preserve search and form state while closed. Closed dialogs immediately become inert, hidden from assistive technology, and leave the focus stack, including during a visual exit transition; the default still unmounts their content. Pair nonmodal palettes with DialogPanel to reuse the global overlay surface. Toolbar accepts a DOM ref for bounded positioning while retaining its shared arrow-key navigation.

useFloatingSurface from @qokit/components/patterns/FloatingTools supports defaultHeight: 'auto' for content-sized palettes. Keep the host body shrinkable with internal scrolling; the hook caps the surface to its workspace bounds and observes size changes. Moving an automatic palette stores its position without freezing the measured height. Resizing explicitly stores a fixed height, including across reloads; reset() or Home on a movement/resize handle restores automatic sizing. Numeric defaultHeight retains the existing fixed-height behavior.

FloatingToolPanel composes the shared DialogPanel, TreeToggle, pin button, tooltip and close button. Place it inside a nonmodal Dialog; the host controls pinned, collapsed, their callbacks and document operations. Pinning keeps the palette open after an operation; it does not lock its position. The title and header whitespace accept useFloatingSurface().dragHandle, while buttons, menus and inputs never initiate dragging or folding. Double-click the title or whitespace to fold; the explicit fold button supports keyboard and touch. Folding hides the body without unmounting it, preserving searches and tree state. Pass the same collapsed value to useFloatingSurface to retain the expanded height while moving the folded header. Optional actions and skin slots reuse the same structure; styles stay in the shared stylesheet.

Optional FloatingToolPanel.viewKey adds a short opacity transition when the active tool changes, without replacing its body instance. Ordinary parameter updates do not animate. Opening, closing, unfolding and pin feedback share the existing motion Tokens and respect reduced motion. Dragging stays direct; useFloatingSurface coalesces pointer movement to one geometry update per animation frame and saves the final position on release. Browsers without discrete display transitions close immediately.

Unified editors pass focus={false} to omit the separate Focus control. primaryActions accepts shared tool buttons before Preview; onTogglePanels handles T, and onToggleAllPanels handles Shift+T. Creator uses T to cycle from visible panels to floating launchers to fully hidden and back to the last visible layout; ordinary launcher clicks still open their panel. Shift+T directly hides everything and restores the exact preceding state. Both sidebar shortcuts are inactive in Preview and respect editable targets and active overlays. Existing hosts keep Edit/Focus behavior by default.

useWorkspacePanelVisibility().togglePanels hides the visible editor panels or restores their preceding layout. Desktop and compact layouts are remembered independently, and forceCollapsed (for example during Preview) does not overwrite that memory. The host owns global navigation visibility and any edge launchers.

For floating editor panels, pass skin: platformWorkspacePanelRevealSkin from @qokit/components/skins/platform and spread the returned panelProps onto the existing panel. The skin applies only while revealed; the docked panel and its mounted content remain intact. ResizablePanels merges startPanelProps, middlePanelProps, and endPanelProps class names with its own skin slots. Pair focus controls with Toolbar and platformFloatingToolbarSkin for shared keyboard navigation and compact spacing. Both skins share the global DialogPanel surface (background, shadow and blur); panel corners use the card radius and toolbar corners use the control radius. Hosts own positioning and available space, not a separate overlay palette.

useWorkspacePanelEdgeDrag is an opt-in hook for an existing workspace root ref. Mark its focusable borders with data-workspace-panel-edge="start" or "end"; ResizablePanels supplies these attributes on its own separators. The host provides each side's mode (expanded, icons, hidden), saved width and bounds through getState, applies onChange, and returns a rollback callback from onBegin. onResizing should suspend layout transitions; onFinish restores focus to the resulting control, and onReset restores the host's default width. One captured mouse or touch gesture crosses all three states, with RTL direction handling and cancellation on Escape, pointer cancellation or window changes. Arrow keys resize or step states, Shift increases the step, Home/double-click resets, and End expands to the allowed maximum. This hook adds no visual controls or stored content. Hosts can pair hidden borders with useWorkspacePanelReveal for temporary shortcut access while retaining their normal click actions; hosts without the hook keep existing resizer behavior.

FloatingAssistant.headerActionsTarget optionally accepts an HTMLElement in the host heading. The assistant portals its existing conversation history and new-conversation controls into that element and omits its internal header. Without a target, the original header remains. The host owns the heading and placement; the assistant retains action handlers, accessibility labels and conversation state. The Web adapter forwards this slot.

FeatureHint is exported from @qokit/components/patterns/FeatureHint. Use it for contextual first-use guidance attached to a real control. Provide a versioned id, a stable user scopeKey, an anchor: HTMLElement, an active eligibility signal, localized title, description, dismissLabel, and action: { label, onClick }. Set completed when the user discovers the capability independently. A null scope or unavailable anchor suppresses the hint.

The shared component allows one hint at a time, waits briefly for a visible target, follows scrolling and resizing, supports RTL, and keeps content inside the viewport. It does not add a backdrop, steal focus, or perform the action automatically. Escape, the close button, or clicking elsewhere dismisses it; Tab from the target reaches the action. The target receives a temporary highlight and accessible description. Seen hints are remembered in the current browser per scope and version, with an in-memory fallback if storage is unavailable; this is not cross-device progress. Hosts own permissions, review-state suppression and the actual action. skin, className and style adapt presentation.

AssistantContextCard is exported from @qokit/components/patterns/FloatingAssistant. Place it in composerContext to summarize the current editing target. Its typed contract includes title, description, scope, preview, parameters: { id, label, value }[], optional controls, status and notice, plus actions, onLocate and clearAction. Pass localized labels and formatted values, including units, from the host.

The card renders a read-only definition list, an optional controls slot for a few common adjustments, and a live status region. Reuse the host’s existing editing controls and commands in this slot; keep complete settings behind an explicit action that opens the existing inspector. Hosts retain ownership of selection, permissions, save, undo and AI requests. Conversation, canvas editing and inspector editing can operate together, with independent panel visibility. Selecting an object updates the card and an already open inspector without opening a closed panel or moving focus. Removing a conversation reference preserves canvas selection and direct editing; keep the conversation entry independent of this card and of floating-tool visibility. Changing the target or a parameter updates this live card without appending chat messages. Both draft and project conversations can use the same component. className, style and AssistantContextCardSkin support visual adaptation; styles are loaded with the component.

FloatingAssistantPanel.composerContext 接收输入框上方的实时上下文区域。提供此插槽时,顶部旧的 activeContext 摘要隐藏,activeContext.promptPlaceholder 仍供输入框使用。实时参数属于当前编辑状态,不应追加到历史消息列表;Web 适配器透传此插槽。

Hosts can set hoverReveal={false} to disable navigation previews from the trigger and window edge while retaining explicit controls and drag resizing; the default remains true.

WorkspaceNavigationDock prefetches same-origin destinations on mouse hover or keyboard focus, with bounded deduplication.

El adaptador Web también transmite FloatingAssistantPanel.composerAttachments. Este espacio muestra adjuntos gestionados por el anfitrión dentro del formulario, antes del campo de texto. El anfitrión controla la posición y el envío: soltar prepara el adjunto, el éxito elimina solo el enviado y los errores lo conservan para reintentar.

Conversación compartida (referencia en inglés; traducción pendiente)

@qokit/components/patterns/Conversation exports ConversationPanel, ConversationMessages, ConversationMessage, ConversationSuggestions and ConversationComposer. Creator generation, draft refinement and the embedded project assistant use these structures and the same token-based stylesheet. Hosts own requests, history, permissions, selected objects and review/apply actions.

ConversationFeedback combina InlineNotice para mostrar de forma compacta estados de tareas, errores, alternativas y confirmaciones de guardado en las conversaciones. Proporciona un title localizado y, opcionalmente, description, tone y action. Ambas líneas usan el tamaño de texto de leyenda, un espacio reducido y una superficie transparente; el tono destaca el estado y el texto de apoyo permanece atenuado. Los valores predeterminados role="status" y aria-atomic="true" anuncian toda la actualización junta; usa role="alert" para errores que requieren una acción. El texto del asistente permanece en ConversationText.

Place the scrollable ConversationMessages and the fixed ConversationComposer directly inside the panel. Supply a localized label for the messages region and inputProps for the controlled textarea. The composer accepts attachments, notice and actions slots, plus formProps and formRef; it creates the form, so do not nest it in another form. Enter inserts a newline; Cmd/Ctrl+Enter requests submission with composition and disabled/busy guards. Preserve user input while a request is running when the host supports it.

PromptPanel.presentation="conversation" reuses the composer while retaining reference reading, upload/menu controls and serialized form fields. The default "prompt" preserves the landing-page prompt behavior. FloatingAssistant.presentation="embedded" uses the shared panel, messages, suggestions and composer; floating assistants retain their compact presentation.

Nueva referencia de API (inglés; traducción pendiente) · 2026-10

2026-10-10 · Pagination dot display

Pagination from @qokit/components/ui accepts pageDisplay="dots" for compact visual choosers. Combine it with layout="centered" for centered arrows and 6px indicators with 32px-wide click targets. Dot colors, hover and keyboard focus use shared theme Tokens; PaginationSkin.dot adapts the indicator slot. Hosts supply currentPage, totalPages, onPageChange and localized navigation labels. pageLabel names each dot; its fallback combines ariaLabel with the page and total. Browsing pages only invokes the host callback. The default "numbers" display retains numeric pagination and formatPageNumber.

2026-10-10 · ActionMenu search header

ActionMenu.dropdownHeader accepts host-owned content before the actions in both dropdown and mobile sheet presentations. onOpenChange reports opening and dismissal so hosts can reset transient search state. Search hosts supply localized copy, filtering and initial input focus; ArrowDown from the input should focus the first enabled result, then the shared menu handles result navigation, selection and Escape.

2026-10-09 · Inline ColorPicker

ColorPicker from @qokit/components/ui/ColorPicker accepts presentation="inline" to expand its editor beneath the field trigger. It renders a named group in the document flow, keeps the surrounding workspace available, and retains palette, HEX, opacity, gradient and reset capabilities. Hosts should reserve a full row for the field. Changes to the controlled value, including undo and reset, update the open inline editor; leaving the field finishes the current edit. The default "popover" presentation retains its portal, outside-click dismissal and Escape behavior.

2026-10-07 · WorkspacePanelGrid

WorkspacePanelGrid from @qokit/components/patterns/WorkspaceLayout places independent detail panels below the shortest available column. It responds to content and container size changes without moving or remounting child nodes; DOM and keyboard order remain unchanged. Narrow containers use one column. Keep continuous panels in one grid rather than separate rows. Metrics, tables, paired fields and ordered workflows retain their own layouts.

Each direct child is a panel. Use data-workspace-panel-span="full" or a numeric column span on that child's root for wider panels. The optional skin has a root slot and variables; --qk-workspace-panel-grid-gap controls shared spacing, and --qk-workspace-panel-grid-max-columns defaults to 2. Without JavaScript or ResizeObserver, panels retain the responsive ordinary grid.

2026-10-08 · Shared list toolbar groups

WorkspaceFilterToolbar now has one container-responsive contract across Projects, CMS and Admin:

  • query: search, filters de estado, sort, controls del dominio, opciones advanced, reset condicional, result del recurso y summary auxiliar.
  • presentation: view, muestra controls y options como columnas visibles y tamaño de página. La personalización de widgets de página pertenece a las acciones de encabezado de página.
  • actions: persistent operations, followed by the optional selection control at the logical end. Use ToolbarButtons with icon and localized compactLabel for refresh and other familiar actions.

The shared component measures its own available width. Controls show icons with labels above 960px and accessible icon buttons at or below 960px. At or below 640px, search occupies the first row and tool groups wrap in query → presentation → actions order. Routes must not override group widths or hide individual labels. ControlMenu and ViewMenu inherit this presentation without a route-specific responsive flag.

Use query.result={{ label, count, total?, locale? }} para el nombre del recurso y el número de resultados. WorkspaceResultSummary muestra «Nombre · cantidad» y añade «/ total» solo si un total fiable sin filtrar es distinto; formatea y aísla los números bidireccionales según el idioma de la interfaz. Omita result hasta conocer la cantidad; cero es válido. No añada otra fila de nombre y cantidad sobre la misma lista. AdminFilterBar.result acepta el mismo objeto. Mantenga títulos, secciones relevantes, paginación y cantidades seleccionadas en sus funciones; use query.summary para otras unidades, contexto o actualización.

Give overflow a localized label to move advanced and display options into More when compact. query.compactItems and presentation.compactItems supply complete menu choices replacing their corresponding controls; controlled values and callbacks remain in the host. Permanent menu actions use overflow.items. Selection and refresh stay outside More. Select and Done share the end slot, hit target and reserved idle toolbar height, including wrapped mobile rows.

This replaces the old flat toolbar API: migrate search, filters, sort, reset and secondaryControls into query; migrate view and display controls into presentation; move persistent endActions to actions. The former adaptive / inline-wrap CSS modes and WorkspaceFilterControlGroup capsule are removed; use these three semantic groups rather than compatibility aliases.

2026-10-10 · EditorItemDisclosure

EditorItemDisclosure from @qokit/components/patterns/EditorItemCollection accepts title, summary, open, onOpenChange, leading, actions and children for editing within a list. Sibling items remain visible. Escape collapses the item and restores trigger focus; opening does not scroll or autofocus. useEditorItemDisclosure scopes single-item expansion with scopeKey and restores adjacent focus after deletion. EditorItemCollection uses the same interaction; hosts still own content, ordering, persistence and undo. The existing EditorFocusedItem export remains available for flows that require a separate detail view.

Referencia adicional de API (inglés; traducción pendiente) · 2026-10

2026-10-15 · Shared inspector choices

EditorStyleChoice uses the shared EditorChoiceControl for finite settings. In auto mode, two or three illustrated options use a segmented group; larger illustrated sets use a portalled ControlMenu showing the current icon and name. Text-only choices retain a native Select. Existing custom values remain selectable.

Las opciones de selección y menú admiten annotation para añadir un punto del tema e incluir su significado localizado en el nombre accesible. El activador de ControlMenu también muestra el punto de la opción activa; triggerAnnotation: null lo limita al menú. Al volver a elegir una opción habilitada ya seleccionada, el menú llama a onReselect. Las opciones nativas muestran la anotación junto a la etiqueta; hidden excluye un marcador de posición de la lista. El anfitrión decide qué valor se anota y qué ocurre al elegirlo; el control no deduce la herencia ni escribe datos.

Use presentation="visual" for labeled diagram choices and presentation="toolbar" for familiar tools such as four-way text alignment. The toolbar has separate targets without a shared capsule. Native radios, shared menu keyboard handling, visible focus, disabled states and theme Tokens are retained. Hosts own labels, allowed values, persistence and undo. id identifies the control; ControlMenu also accepts triggerId and disabled.

Inspector menus, inputs, collapsed summaries and reset actions share a 32px mouse field height, restored to 40px on narrow screens and coarse pointers. Field icons use 16px and diagram choices keep an 8px gap. EditorComponentSettings reuses these choices for columns, density, image fit and aspect ratio, while composition layouts retain detailed previews. If saving briefly disables native radios, the shared skeleton restores focus to the selected option for continuous arrow-key editing.

Inspector labels and diagram captions use the 12px caption scale; values, actions and section titles use the 13px field scale. Visual choices have no decorative outer border: a soft selected surface and centered caption identify the current option, while keyboard focus retains its ring. Font specimens in the inspector use a compact, bounded scale.

2026-10-15 · Responsive workspace tables

WorkspaceDataTable reflows mobileLayout="records" into two columns of labeled facts, with the primary identity and sticky end actions spanning the record. Names and identifiers can use two lines. Column labels and selection remain accessible. Comparison tables using mobileLayout="scroll" retain their columns.

When a host toolbar already provides sorting or other header actions, set mobileHeader="labels" to remove duplicate header controls from the mobile layout and tab order. Column names remain available to assistive technology; desktop headers are unchanged. The default "controls" preserves custom header controls on mobile.

2026-10-14 · Independent editor panels

resolveWorkspaceResponsiveProfile and useWorkspaceResponsiveProfile from WorkspacePanels, and EditorWorkbenchChrome, accept the optional panelPolicy="independent". With BuilderWorkbenchFrame and the platform editor skin, both panels remain docked above the mobile threshold. Shared styles temporarily compress displayed widths while retaining remembered sizes, and the canvas fits the remaining space. Effective work areas at or below 720px retain mobile task switching.

Hosts own panel visibility. When supplying a measured profile, use the same policy for the measurement hook and Chrome. Omitting panelPolicy retains the default "adaptive" policy with its existing desktop, two-column and overlay layouts.

Editor workspace integration

workspaceNavigation connects the host's shared business navigation through EditorWorkbenchChrome: desktop navigation reserves space beside the content, while mobile uses the shared drawer. It is separate from the document structure panel navigation and retains the host's permissions and unsaved-change protection.

EditorSaveButton.showIcon keeps the save glyph beside its label. iconOnly reduces the control to an icon while retaining an accessible action and status name and tooltip. Editor hosts can use useCompactWorkspaceHeader() to show icons and labels in roomy layouts and icons alone in compact layouts. EditorStatusAction.iconOnly follows the same rule while retaining its issue count.

2026-10-15 · EditorControlGroup title actions

The headerActions slot on EditorControlGroup remains visible in both expanded and collapsed groups, for actions such as content visibility beside a group title. Pointer and keyboard interactions with these actions do not toggle the group. summaryActions still appears only when collapsed. Hosts own action names, state and persistence; icon actions must use the shared IconButton with a localized accessible name.

2026-10-14 · Management groups and summaries

WorkspaceSectionGroup, WorkspaceSection, WorkspaceFieldGrid and WorkspaceFacts are exported from @qokit/components/patterns/WorkspaceLayout. Headings and descriptions sit above their content panels on both desktop and mobile, sharing the starting edge. Use the default stacked layout; legacy layout="split" callers also render stacked. Apply qk-workspace-section-group__form to forms within a group to share spacing and save-area alignment. WorkspaceSection accepts optional icon, actions and description slots, keeping headings outside the content panel.

WorkspaceFieldGrid arranges independent short fields in at most two columns according to available width. WorkspaceFacts renders a semantic definition list with stable id, label, value, and optional unit, description, emphasis and tone. columns supports 2, 3 or 4 columns and adapts to narrow containers. Set mobileColumns={2} for short numeric summaries that should retain two columns on phones; the default is one. It is unboxed so summaries can share an existing content panel. Each component supports its named Skin, className and style. Hosts retain form state, permissions, submission, conflicts and recovery; these components do not make requests.

2026-10-14 · Management content panels and disclosures

WorkspaceContentPanel and WorkspaceSection.kind support summary, form, records, and actions. Section toolbar stays outside the content surface; supporting and footer provide compact metadata and end operations. titleId preserves existing heading anchors. The default panel container does not override a host's named container.

Use WorkspacePanelBlock, WorkspacePanelMeta, and WorkspaceRecordRow for subordinate groups, metadata, and repeated records. A record accepts title, description, meta, status, actions, and full-width detail children. Facts always align at the top. Hosts retain business fields, permissions, table columns, and submission boundaries.

WorkspaceActionRow accepts an optional action label or quiet empty/loading status, alongside description and actions. Action identity uses 14px semibold text, status uses 14px regular text, and descriptions use 12px. Copy and controls share a center line on desktop and stack at narrow widths. Card surfaces do not override descendant strong typography or spacing.

WorkspaceDisclosure accepts title, optional status, and children; WorkspaceDisclosureGroup accepts Accordion items and controlled expansion props. They start closed unless the host specifies an initial item, and open at most one sibling. Enter/Space toggles; Escape closes and returns focus to its trigger, handling inner disclosures before their parent. Hidden panels retain their DOM and input state. Optional headingLevel supplies section heading semantics; Skin and class slots only adapt appearance. Import these components from @qokit/components/patterns/WorkspaceLayout.

CustomizableWidgetLayoutControls / CustomizableWidgetLibrary

Coloca CustomizableWidgetLayoutControls en las acciones de encabezado de página después de la ayuda contextual y antes de la acción principal, incluyendo en móvil. Usa copy.customize localizado para nombrar la acción explícitamente (por ejemplo, "Personalizar widgets"). La misma entrada solo con icono expone aria-pressed y aria-expanded, y se convierte en copy.done mientras se edita. customizeButtonRef expone opcionalmente el activador para la restauración de enfoque del host; disabledCustomize desactiva la entrada sin cambiar su geometría. Suministra onCollapseToggle y areWidgetsCollapsed solo para hosts que admitan widgets colapsables; omitirlos renderiza solo la entrada de personalización.

CustomizableWidgetLibrary posee el encabezado común de la biblioteca, acciones de restablecer/cerrar, diseño de desplazamiento responsivo, enfoque inicial del botón cerrar y manejo de Escape. Cerrar devuelve el enfoque al control invocante cuando el enfoque aún está dentro de la biblioteca; los clics externos mantienen su destino de enfoque. Los hosts mantienen definiciones de widgets, comandos de añadir/quitar/ordenar/redimensionar, persistencia y semánticas de restablecimiento. Las ranclas de clase CMS y Admin siguen estando disponibles para hooks de dominio, pero no deben definir superficies de biblioteca separadas ni diseños móviles.

2026-10-17 · Activadores de ActionMenu enriquecidos

ActionMenu.renderTrigger puede reutilizar un control enriquecido como SelectableTile. Recibe aria-expanded, aria-haspopup, disabled y onClick; propáguelos sobre el activador real. El host conserva la semántica de selección y la apariencia del control. El posicionamiento del portal, la navegación por teclado del menú, el cierre, el retorno del foco y las hojas móviles opcionales siguen siendo responsabilidad de ActionMenu. Los activadores predeterminados de botón e icono permanecen sin cambios.

Controles de radio y rango

RangeNumber, de @qokit/components/ui/RangeNumber, combina un deslizador nativo con un Input numérico exacto. Recibe label, value, min, max, los opcionales step y unit, y onChange. Un valor indefinido muestra un guion de valor mixto; cambiar cualquiera de las entradas establece un número limitado al rango. onCommit permite agrupar cambios continuos en el historial de deshacer del anfitrión. Se comparten disabled, navegación por teclado, densidad compacta, RTL y estilos de foco; el anfitrión conserva la persistencia. RangeNumberSkin ofrece ranuras para raíz, deslizador, entrada y unidad.

EditorRadiusControl, de @qokit/components/patterns/EditorRadiusControl, combina una vista previa de la forma, cuatro entradas de esquinas físicas, RangeNumber y formas predefinidas opcionales. value y onChange usan la sintaxis abreviada CSS border-radius; el anfitrión traduce cornerLabels y las etiquetas de los ajustes. El orden en RTL sigue siendo superior izquierda, superior derecha, inferior derecha, inferior izquierda. max limita la edición a píxeles acotados; omitirlo conserva unidades CSS y esquinas elípticas. Un radio mixto no muestra un único valor hasta ajustar las cuatro esquinas juntas. EditorRadiusControlSkin adapta las ranuras de raíz, diagrama, vista previa y ajustes sin cambiar estado ni persistencia.

2026-10-22 · Pestañas activas en pantallas estrechas

PillTabs acepta scrollActiveTabIntoView opcional, con valor predeterminado false. En pestañas horizontales, muestra el hijo activo directo PillTabLink o PillTabButton al seleccionar o cambiar el tamaño. Solo se desplaza la tira de pestañas; la posición de la página y el foco no cambian. Admite LTR y RTL con corrección inmediata, también con movimiento reducido. Las pestañas verticales y los usos que omiten la opción conservan su comportamiento.

En esta página

Integración de componentes2026-10-20 · Acciones independientes en tarjetas de selección visual2026-10-17 · Movimiento compartido del panel del banco de trabajo2026-10-17 · Valores predeterminados medidos del editor2026-09-30 · Accesibilidad de SelectionToolbar2026-09-10 · Insignias de identidad del espacio de trabajo2026-09-08 · EmptyState2026-09-08 · SidebarNavigation2026-09-07 - AccountDropdown / SidebarProfile2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace2026-09-07 · WorkspaceLocationSync / ProjectSwitcher2026-09-07 · Navegación unificada y superficies redondeadas Qokit2026-09-07 - ColumnLayoutPunto de entradaLímites de responsabilidad públicaGeneración de contenido de elementosControles de formularioSelección en listasTarjetas de métricasNueva referencia de API (inglés; traducción pendiente) · 2026-10Header y Footer de la plataformaEstrategia de compatibilidadEdición a pantalla completaSidebarToggleSlotEditorHeaderEditorNavigationMenuWorkspaceNavigationMenu / WorkspacePageHeaderEditorViewControlsLanguage / AppearancerequestWorkspaceNavigationWorkspacePanelRevealEditorViewControls / Modo de visualizaciónPlatformHeader.workspaceNavigation2026-09-06 - EditorHeader.preview / EditorViewControls.returnView2026-09-06 · Builder / CMSPie de página renderizado en el servidor · 2026-09-07EditorHeader.titleControl / FloatingAssistant.presentation2026-09-07 · WorkspaceAssembly2026-09 · Espacios de administración2026-09-08 · Task focusNueva referencia de API (inglés; traducción pendiente)Conversación compartida (referencia en inglés; traducción pendiente)Nueva referencia de API (inglés; traducción pendiente) · 2026-102026-10-10 · Pagination dot display2026-10-10 · ActionMenu search header2026-10-09 · Inline ColorPicker2026-10-07 · WorkspacePanelGrid2026-10-08 · Shared list toolbar groups2026-10-10 · EditorItemDisclosureReferencia adicional de API (inglés; traducción pendiente) · 2026-102026-10-15 · Shared inspector choices2026-10-15 · Responsive workspace tables2026-10-14 · Independent editor panelsEditor workspace integration2026-10-15 · EditorControlGroup title actions2026-10-14 · Management groups and summaries2026-10-14 · Management content panels and disclosuresCustomizableWidgetLayoutControls / CustomizableWidgetLibrary2026-10-17 · Activadores de ActionMenu enriquecidosControles de radio y rango2026-10-22 · Pestañas activas en pantallas estrechas