@prolibu-suite/cobalt-core 0.10.4 → 0.11.1

package/dist/collection/components/co-document-editor/document-props.js

@@ -0,0 +1,40 @@
+export const DEFAULT_MARGINS = { top: 38, right: 38, bottom: 38, left: 38 };
+const NAMED = new Set(['letter', 'a4', 'legal']);
+/** `true` o `'true'`. Un `'false'` que dejó el multipart de V1 cuenta como falso (spec §3.6). */
+export function toBoolIntent(v) {
+    return v === true || v === 'true';
+}
+export function parsePageSize(v) {
+    if (typeof v === 'string') {
+        if (NAMED.has(v))
+            return v;
+        try {
+            return parsePageSize(JSON.parse(v));
+        }
+        catch (_a) {
+            return 'letter';
+        }
+    }
+    if (v && typeof v === 'object') {
+        const { width, height } = v;
+        if (Number(width) > 0 && Number(height) > 0)
+            return { width: Number(width), height: Number(height) };
+    }
+    return 'letter';
+}
+export function parseMargins(v) {
+    let raw = v;
+    if (typeof v === 'string') {
+        try {
+            raw = JSON.parse(v);
+        }
+        catch (_a) {
+            return Object.assign({}, DEFAULT_MARGINS);
+        }
+    }
+    if (!raw || typeof raw !== 'object')
+        return Object.assign({}, DEFAULT_MARGINS);
+    const m = raw;
+    const pick = (k) => (Number.isFinite(Number(m[k])) && m[k] !== undefined ? Number(m[k]) : DEFAULT_MARGINS[k]);
+    return { top: pick('top'), right: pick('right'), bottom: pick('bottom'), left: pick('left') };
+}

package/dist/collection/components/co-document-editor/header-tools.js

@@ -0,0 +1,11 @@
+/**
+ * Herramientas de la banda del encabezado en edición (interruptor de número de
+ * página + ✓). La fila cuelga ENCIMA de la banda, dentro del margen superior de la
+ * hoja, y el papel tiene `overflow: clip`: tiene que entrar en el margen mínimo
+ * (10 mm = 38 px) o se recorta. `co-icon-button size="sm"` mide 48 px: el tamaño va
+ * por `box-size`. Fila = max(✓, switch de 24) + padding + borde (ver la prueba).
+ */
+export const HEADER_TOOL_BOX_PX = 28;
+export const HEADER_TOOL_ICON_PX = 16;
+/** Margen superior más chico que se admite (10 mm a 96 dpi, el default del componente). */
+export const MIN_TOP_MARGIN_PX = 38;

package/dist/collection/components/co-document-editor/image-bar.js

@@ -0,0 +1,66 @@
+/**
+ * Barra de diseño de imagen (4 modos de V1). Vive DENTRO del papel, que tiene
+ * `overflow: clip`: su posición se decide acá para que nunca quede recortada.
+ * Las medidas son las del CSS (`.co-doc-editor__image-bar` / `__image-mode`,
+ * ver la prueba): se calculan sin medir el DOM porque la barra todavía no existe
+ * cuando se decide dónde va.
+ */
+export const IMAGE_MODE_ICONS = {
+    inline: 'image-square',
+    'wrap-left': 'text-align-left',
+    'wrap-right': 'text-align-right',
+    break: 'rows',
+};
+/** Botón de modo (ancho = alto). */
+export const IMAGE_MODE_BUTTON_PX = 28;
+export const IMAGE_MODE_ICON_PX = 16;
+/** 4 botones × 28 + 3 separaciones de 2 + relleno 2 × 2 + borde 1 × 2. */
+export const IMAGE_BAR_SIZE = { width: 124, height: 34 };
+/** Aire entre la imagen y la barra. */
+export const IMAGE_BAR_GAP_PX = 4;
+/**
+ * Debajo de la imagen (por defecto: una imagen pegada al margen superior no la
+ * saca por arriba); si no entra debajo (final del papel), encima; si tampoco,
+ * dentro de la imagen, sobre su borde inferior. En horizontal se acota al papel.
+ * Un papel sin medidas (0) no acota.
+ */
+export function imageBarPosition(img, sheet, bar = IMAGE_BAR_SIZE, gap = IMAGE_BAR_GAP_PX) {
+    const below = img.top + img.height + gap;
+    const above = img.top - gap - bar.height;
+    let top = below;
+    let placement = 'below';
+    if (sheet.height > 0 && below + bar.height > sheet.height) {
+        if (above >= 0) {
+            top = above;
+            placement = 'above';
+        }
+        else {
+            top = Math.max(0, Math.min(img.top + img.height - gap - bar.height, sheet.height - bar.height));
+            placement = 'inside';
+        }
+    }
+    let left = img.left;
+    if (sheet.width > 0)
+        left = Math.max(0, Math.min(left, sheet.width - bar.width));
+    return { top, left, placement };
+}
+/** `offsetLeft` acumulado hasta `root` (par de `layoutBox`, que da el top). */
+export function layoutLeft(el, root) {
+    let left = 0;
+    let node = el;
+    while (node && node !== root) {
+        left += node.offsetLeft;
+        node = node.offsetParent;
+    }
+    return left;
+}
+/**
+ * Ancho con el que nace una imagen insertada (nota T8 / plan B §6.4): sin `width`,
+ * V1 la abre a 800 px, más que la columna (≈740 en carta). Nunca pasa de la columna.
+ */
+export function defaultImageWidth(naturalWidth, columnWidth) {
+    const natural = naturalWidth > 0 ? naturalWidth : 0;
+    const column = columnWidth > 0 ? columnWidth : 0;
+    const w = natural && column ? Math.min(natural, column) : natural || column;
+    return w ? Math.max(1, Math.round(w)) : null;
+}

package/dist/collection/components/co-document-editor/page-styles.js

@@ -0,0 +1,90 @@
+/**
+ * Acota el CSS de impresión del host (SharedContractUtils: editorCss + defaultCss)
+ * a UNA hoja: cada selector queda bajo `:where(scope)`; `*`, `html`, `body` y `:root`
+ * pasan a ser la hoja (el `*` global de defaultCss no puede escapar a la página).
+ * Se entra en @media/@supports, se conserva @keyframes y se descartan las
+ * reglas que no aplican a pantalla o traerían red (@page, @font-face, @import).
+ */
+const DROP_STATEMENTS = /@(import|charset|namespace)[^;]*;/gi;
+export function scopePageStyles(css, scope) {
+    if (!css)
+        return '';
+    const src = css.replace(/\/\*[\s\S]*?\*\//g, '').replace(DROP_STATEMENTS, '');
+    return scopeBlock(src, scope).trim();
+}
+function matchingBrace(src, open) {
+    let depth = 0;
+    let quote = null;
+    for (let i = open; i < src.length; i += 1) {
+        const c = src[i];
+        if (quote) {
+            if (c === quote && src[i - 1] !== '\\')
+                quote = null;
+            continue;
+        }
+        if (c === '"' || c === "'")
+            quote = c;
+        else if (c === '{')
+            depth += 1;
+        else if (c === '}') {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+/**
+ * El scope va dentro de `:where()`: especificidad 0. Cada regla del host conserva la
+ * especificidad que tenía en el PDF, y la geometría propia de la hoja (clases del
+ * componente, ≥ (0,1,0)) le gana a sus resets (`* { padding: 0 }`, `.tiptap table td`…).
+ *
+ * Excepción del `*`: en el PDF es CSS de autor y le gana a la UA de `pre`/`code`
+ * (`font-family: monospace`). En la app, el normalize global (Quasar: `code, kbd, pre, samp
+ * { font-family: monospace }`, (0,0,1)) es de autor y le ganaba al `:where(scope) *` (0,0,0):
+ * un bloque de código medía distinto en la hoja que en el PDF. `:where(scope) :is(pre, code)`
+ * sube el reset a (0,0,1): empata con el normalize y gana por orden (el `<style>` de la hoja
+ * vive dentro del documento, después de las hojas globales del `<head>`), y sigue perdiendo
+ * contra cualquier regla del host más específica o posterior (`.tiptap pre`, `pre {…}`), como en
+ * el PDF. `inherit` desde la hoja no sirve: un `pre` hijo directo de `.ProseMirror` heredaría la
+ * fuente del contenedor (Geist) y no la del `*` (Roboto) que ve el PDF.
+ */
+function scopeSelector(sel, scope) {
+    const s = sel.trim();
+    if (!s)
+        return '';
+    const root = `:where(${scope})`;
+    if (s === '*')
+        return `${root}, ${root} *, ${root} :is(pre, code)`;
+    const rest = s.replace(/^(?:(?:html|body|:root)(?=$|[\s>+~.#:[])\s*)+/i, '').trim();
+    return rest ? `${root} ${rest}` : root;
+}
+function scopeBlock(src, scope) {
+    let out = '';
+    let i = 0;
+    while (i < src.length) {
+        const open = src.indexOf('{', i);
+        if (open === -1)
+            break;
+        const close = matchingBrace(src, open);
+        if (close === -1)
+            break;
+        const prelude = src.slice(i, open).trim();
+        const body = src.slice(open + 1, close);
+        i = close + 1;
+        if (!prelude)
+            continue;
+        if (prelude.startsWith('@')) {
+            const at = prelude.slice(1).split(/[\s(]/)[0].toLowerCase();
+            if (at === 'media' || at === 'supports')
+                out += `${prelude}{${scopeBlock(body, scope)}}`;
+            else if (at.endsWith('keyframes'))
+                out += `${prelude}{${body}}`;
+            continue; // @page, @font-face y cualquier otra at-rule: fuera
+        }
+        const selectors = prelude.split(',').map((x) => scopeSelector(x, scope)).filter(Boolean);
+        if (selectors.length)
+            out += `${selectors.join(', ')}{${body}}`;
+    }
+    return out;
+}

package/dist/collection/components/co-document-editor/zoom.js

@@ -0,0 +1,45 @@
+/** Aire lateral que se descuenta del lienzo al ajustar al ancho (2 × --co-spacing-lg). */
+export const ZOOM_GUTTER_PX = 32;
+/** Escala para que la hoja entre en el ancho disponible: nunca agranda, nunca baja de 25 %. */
+export function fitScale(available, pageWidth) {
+    if (!(available > 0) || !(pageWidth > 0))
+        return 1;
+    const s = Math.min(1, Math.max(0.25, available / pageWidth));
+    return Math.round(s * 1000) / 1000;
+}
+/** Tope del zoom libre (pinza / ctrl+rueda). El piso es el mismo de «Ajustar al ancho». */
+export const ZOOM_MIN = 0.25;
+export const ZOOM_MAX = 3;
+/** Acota la escala a [ZOOM_MIN, ZOOM_MAX] y la redondea a milésimas (NaN → 1). */
+export function clampScale(scale) {
+    if (!Number.isFinite(scale))
+        return 1;
+    return Math.round(Math.min(ZOOM_MAX, Math.max(ZOOM_MIN, scale)) * 1000) / 1000;
+}
+/**
+ * Nueva escala para un evento `wheel` con ctrlKey (la pinza del trackpad llega así en Chrome,
+ * Edge y Firefox; también ctrl+rueda del mouse). Exponencial: acercar y alejar el mismo delta
+ * vuelve al punto de partida, y la velocidad se siente igual a cualquier escala.
+ */
+export function pinchScale(current, deltaY) {
+    if (!Number.isFinite(deltaY))
+        return current;
+    return clampScale(current * Math.exp(-deltaY * 0.01));
+}
+/**
+ * Punto del papel (px de layout, sin escala) bajo el cursor: `stageStart` es el borde de la hoja
+ * escalada en pantalla (getBoundingClientRect), `scale` la escala que el DOM refleja HOY.
+ */
+export function paperPoint(client, stageStart, scale) {
+    if (!(scale > 0))
+        return 0;
+    return (client - stageStart) / scale;
+}
+/**
+ * Cuánto hay que correr el scroll para que el punto `paper` vuelva a quedar bajo el cursor,
+ * medido DESPUÉS del render con la escala nueva (la hoja está centrada y el lienzo tiene
+ * relleno fijo: predecir la posición falla, medirla no).
+ */
+export function anchorCorrection(stageStart, paper, scale, client) {
+    return stageStart + paper * scale - client;
+}

package/dist/collection/components/co-drawer/co-drawer.css

@@ -83,6 +83,11 @@
 }
 
 
+/**
+ * @prop --co-shell-r: Radio del panel; es el mismo knob que usa `co-app-shell` (default `--co-border-radius-md`, 14px).
+ * @prop --co-drawer-r: Radio del panel, asignado en el propio panel a partir de `--co-shell-r`; se sobrescribe vía `co-drawer::part(drawer) { --co-drawer-r: … }`.
+ */
+
 :host {
   display: contents;
 }

package/dist/collection/components/co-drawer/co-drawer.js

@@ -2,6 +2,19 @@ import { h } from "@stencil/core";
 import { afterEventFor } from "../co-overlay/overlayAfterClose";
 import { slotHasContent } from "../../utils/slotContent";
 /**
+ * Panel lateral (derecha, izquierda o abajo) sobre un scrim, con header, pestañas,
+ * cuerpo scrolleable y footer. Es controlado: la ✕, el scrim y Escape emiten
+ * `coClose` y quien lo usa pone `open` en `false`. Wrapper Vue: `CoDrawer` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part drawer - El panel completo (posición, sombra y animación).
+ * @part card - Superficie interna del panel.
+ * @part header - Header (título o slot `header`, y la ✕).
+ * @part tabs - Fila del slot `tabs`.
+ * @part body - Cuerpo scrolleable (slot por defecto).
+ * @part loader - Loader superpuesto al cuerpo (`loading`).
+ * @part footer - Footer de acciones (slot `footer`).
+ *
  * @slot header  - Custom header content (overrides `heading` prop). Receives close button next to it.
  * @slot tabs    - Optional row under the header (e.g. <co-tab-group>).
  * @slot         - Drawer body (scrollable).

package/dist/collection/components/co-drive-card/co-drive-card.js

@@ -15,6 +15,19 @@ import { h } from "@stencil/core";
  *                  <co-file-type-tile> when `ext` is set.
  * @slot trailing - (folder) Trailing content after the star (e.g. a dots menu).
  * @slot actions  - (file) The fading action affordance in the foot row.
+ *
+ * Wrapper Vue: `CoDriveCard` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part card - Tarjeta completa.
+ * @part select - Chip de selección de la esquina.
+ * @part tile - (carpeta) Ícono de la carpeta.
+ * @part name - Nombre del ítem.
+ * @part meta - Texto secundario (fecha, tamaño…).
+ * @part trailing - (carpeta) Contenido final después de la estrella.
+ * @part thumb - (archivo) Zona de miniatura.
+ * @part star - Botón de favorito.
+ * @part foot - (archivo) Fila inferior con tipo, nombre y acciones.
+ * @part actions - (archivo) Acciones que aparecen en hover.
  */
 export class CoDriveCard {
     constructor() {
@@ -74,7 +87,7 @@ export class CoDriveCard {
     }
     render() {
         const isFile = this.variant === 'file';
-        return (h("div", { key: 'd21cc658d8a825973bf2662166792e2645cb7919', class: {
+        return (h("div", { key: '35d58b53bd6f000c2c0e6fb4f16cc4914bd8ece9', class: {
                 'co-drive-card': true,
                 [`co-drive-card--${this.variant}`]: true,
                 [`co-drive-card--${this.density}`]: true,

package/dist/collection/components/co-drop-zone/co-drop-zone.js

@@ -8,7 +8,12 @@ import { Host, h } from "@stencil/core";
  *  2. Self-managed — the host listens for native dragenter/over/leave/drop and
  *     flips `active` itself, emitting `coDragStateChange` and `coDrop`.
  *
- * Report ref: 3.17 (446–449); drag overlay spec: report lines 135–136.
+ * Wrapper Vue: `CoDropZone` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part host - El propio elemento (envuelve el contenido del slot).
+ * @part overlay - Capa que aparece al arrastrar archivos encima.
+ * @part badge - Círculo con el ícono dentro de la capa.
+ * @part label - Texto de la capa (`label`).
  */
 export class CoDropZone {
     constructor() {
@@ -58,7 +63,7 @@ export class CoDropZone {
         this.coDragStateChange.emit(next);
     }
     render() {
-        return (h(Host, { key: '8c054ca976730d2a6d31026a7da431e38fb61d9d', class: { 'co-drop-zone': true, 'co-drop-zone--active': this.active }, part: "host", style: { '--co-drop-zone-accent': this.accent }, onDragEnter: this.handleDragEnter, onDragOver: this.handleDragOver, onDragLeave: this.handleDragLeave, onDrop: this.handleDrop }, h("slot", { key: '478ff353fc8c88d719a054bdd302ffeeec06a238' }), this.active && (h("div", { key: '64310825f2556838d525541f6dba33af521f1c2f', class: "co-drop-zone__overlay", part: "overlay" }, h("div", { key: '5567646e887cfd23a4c5e987cc0f9b7cbcda247e', class: "co-drop-zone__badge", part: "badge" }, h("co-icon", { key: '8b50b8e1615d13efaad52ef03ede3afdc4dd7869', name: this.icon, size: 34 })), h("span", { key: '10209ab792204eff4ddc86c08aac950cfae50ec1', class: "co-drop-zone__label", part: "label" }, this.label)))));
+        return (h(Host, { key: '5c7232e2bc5fe0f1cc24181d1758fcd0369c47cb', class: { 'co-drop-zone': true, 'co-drop-zone--active': this.active }, part: "host", style: { '--co-drop-zone-accent': this.accent }, onDragEnter: this.handleDragEnter, onDragOver: this.handleDragOver, onDragLeave: this.handleDragLeave, onDrop: this.handleDrop }, h("slot", { key: 'efdf82946b7396ddf88e7f440aa6c460cb15821b' }), this.active && (h("div", { key: '3b9a9f2e78275fbf4a4fb240beafd6725b06f36f', class: "co-drop-zone__overlay", part: "overlay" }, h("div", { key: '3a540d077413199f63904a3b8f2a82d01306927a', class: "co-drop-zone__badge", part: "badge" }, h("co-icon", { key: '224941558e33dddb16ae7d98b63f63a0f4d41c5e', name: this.icon, size: 34 })), h("span", { key: '256aa058549937ab0cf0bdc31337d22fa860da75', class: "co-drop-zone__label", part: "label" }, this.label)))));
     }
     static get is() { return "co-drop-zone"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/co-emoji-picker/co-emoji-picker.css

@@ -1,3 +1,7 @@
+/**
+ * @prop --co-emoji-picker-cell: Lado de cada celda de emoji (default 36px); también define el ancho del panel.
+ * @prop --co-emoji-picker-height: Alto de la grilla (default 8 filas).
+ */
 :host {
   display: block;
   font-family: var(--co-font-family-primary);

package/dist/collection/components/co-emoji-picker/co-emoji-picker.js

@@ -19,6 +19,15 @@ const NAV_KEYS = [
  *
  * @event coSelect - El emoji elegido: `{ emoji, name }`.
  * @event coClose - Escape con el buscador vacío (el host decide si cierra).
+ *
+ * Wrapper Vue: `CoEmojiPicker` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part panel - Contenedor del panel.
+ * @part search - Fila del buscador.
+ * @part input - El `<input>` de búsqueda.
+ * @part tones - Selector de tono de piel.
+ * @part categories - Barra de categorías.
+ * @part grid - Grilla virtualizada de emoji.
  */
 export class CoEmojiPicker {
     constructor() {
@@ -383,14 +392,14 @@ export class CoEmojiPicker {
         const stripCategories = hasRecent
             ? [RECENT_CATEGORY, ...EMOJI_CATEGORIES]
             : [...EMOJI_CATEGORIES];
-        return (h("div", { key: '7c7dfc4be7b8f8ea44df0f6c988cd2462b5fbdab', class: "co-emoji-picker", part: "panel", role: "group", "aria-label": this.label || s.pickerLabel, style: { '--co-emoji-picker-columns': String(Math.max(1, this.columns)) }, onKeyDown: this.handleKeyDown }, this.searchable && (h("div", { key: 'd25a0e16ced7efd0bc92b2dd104e60ea926ae042', class: "co-emoji-picker__search", part: "search" }, h("co-icon", { key: '72d9381c9e5375e2a1f7c8a01ca4d5e9d9c69b5c', name: "magnifying-glass", size: 16 }), h("input", { key: '5dc6d956f35f8497e35915faf1eb6bec424e0978', class: "co-emoji-picker__input", part: "input", type: "text", value: this.term, placeholder: this.searchPlaceholder || s.searchPlaceholder, onInput: this.handleInput, ref: (el) => (this.inputEl = el), role: "combobox", "aria-expanded": "true", "aria-autocomplete": "list", "aria-controls": CoEmojiPicker.GRID_ID, "aria-activedescendant": activeCellId }), this.renderTones())), this.showCategories && (h("div", { key: 'f590a30901ad79dffe872381ac7d19f3bb8e4185', class: "co-emoji-picker__categories", part: "categories", "aria-label": s.categoriesLabel }, !this.searchable && this.renderTones(), stripCategories.map((category) => {
+        return (h("div", { key: '3f45e20684cb31d39feabb1e9a431001153badc4', class: "co-emoji-picker", part: "panel", role: "group", "aria-label": this.label || s.pickerLabel, style: { '--co-emoji-picker-columns': String(Math.max(1, this.columns)) }, onKeyDown: this.handleKeyDown }, this.searchable && (h("div", { key: 'e7e0345d77fc03813f87c2cc119b205f2da67807', class: "co-emoji-picker__search", part: "search" }, h("co-icon", { key: '631f7a147601969961941f0f63a080e75a4ade41', name: "magnifying-glass", size: 16 }), h("input", { key: 'e216e1bf3898d4c747c247aa86df348eca1eb906', class: "co-emoji-picker__input", part: "input", type: "text", value: this.term, placeholder: this.searchPlaceholder || s.searchPlaceholder, onInput: this.handleInput, ref: (el) => (this.inputEl = el), role: "combobox", "aria-expanded": "true", "aria-autocomplete": "list", "aria-controls": CoEmojiPicker.GRID_ID, "aria-activedescendant": activeCellId }), this.renderTones())), this.showCategories && (h("div", { key: '0d212f4c661651e51503e82ad2e4c81af9e89d55', class: "co-emoji-picker__categories", part: "categories", "aria-label": s.categoriesLabel }, !this.searchable && this.renderTones(), stripCategories.map((category) => {
             var _a, _b;
             const name = (_a = s.categories[category]) !== null && _a !== void 0 ? _a : category;
             return (h("button", { type: "button", key: category, class: {
                     'co-emoji-picker__category': true,
                     'co-emoji-picker__category--active': category === activeCategory,
                 }, "aria-label": name, "aria-current": category === activeCategory ? 'true' : undefined, title: name, onClick: () => this.jumpToCategory(category) }, h("co-icon", { name: (_b = EMOJI_CATEGORY_ICONS[category]) !== null && _b !== void 0 ? _b : 'circle', size: 16 })));
-        }))), h("div", { key: 'e2d0322703aef9efdf8b0aeec6b5021fbfaa15f8', class: "co-emoji-picker__scroll", part: "grid", id: CoEmojiPicker.GRID_ID, role: "listbox", "aria-label": s.gridLabel, ref: (el) => (this.scrollEl = el), onScroll: this.handleScroll }, isEmpty ? (h("div", { class: "co-emoji-picker__empty" }, h("co-icon", { name: "magnifying-glass", size: 20 }), h("span", null, this.emptyMessage || s.emptyMessage))) : (this.renderRows(rows)))));
+        }))), h("div", { key: '9d75f1c71e8162708bff7ff3d3e8ac50d2ae8506', class: "co-emoji-picker__scroll", part: "grid", id: CoEmojiPicker.GRID_ID, role: "listbox", "aria-label": s.gridLabel, ref: (el) => (this.scrollEl = el), onScroll: this.handleScroll }, isEmpty ? (h("div", { class: "co-emoji-picker__empty" }, h("co-icon", { name: "magnifying-glass", size: 20 }), h("span", null, this.emptyMessage || s.emptyMessage))) : (this.renderRows(rows)))));
     }
     static get is() { return "co-emoji-picker"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/co-empty-state/co-empty-state.js

@@ -1,7 +1,9 @@
 import { h } from "@stencil/core";
 /**
  * Empty state placeholder — icon, title, description, and action buttons.
+ * Wrapper Vue: `CoEmptyState` de `@prolibu-suite/cobalt-vue`.
  * @slot - Action buttons
+ * @part empty-state - Contenedor del estado vacío.
  */
 export class CoEmptyState {
     constructor() {
@@ -13,11 +15,11 @@ export class CoEmptyState {
     render() {
         var _a;
         const iconWeight = (_a = this.iconWeight) !== null && _a !== void 0 ? _a : (this.variant === 'card' ? 'regular' : 'light');
-        return (h("div", { key: '4011b99b59671ad38cf5c90b5adc1b42a0353817', class: {
+        return (h("div", { key: '419da2f8dee690bb65956debb4a1d9aad3319906', class: {
                 'co-empty-state': true,
                 [`co-empty-state--${this.variant}`]: true,
                 [`co-empty-state--${this.size}`]: true,
-            }, part: "empty-state" }, this.icon && (h("div", { key: 'a6899c6690bb8b9fcdd858fb63a30644b7094672', class: "co-empty-state__icon" }, h("co-icon", { key: '312945448815ae5be78074e03840909b04e5f3c4', name: this.icon, size: 40, weight: iconWeight }))), this.heading && (h("div", { key: '7fd7fdb5fc4922bf2c7d6aab5200bc80947c20ba', class: "co-empty-state__heading" }, this.heading)), this.description && (h("div", { key: 'da5cddc1aa7afc32ee30f59293f66f1e30507614', class: "co-empty-state__description" }, this.description)), h("div", { key: '940a1b9ffa4022a3ee2623b7a6892000c63abfd4', class: "co-empty-state__actions" }, h("slot", { key: 'b6b9fbd93e79890193500d5c3bbbe72d32fa1e20' }))));
+            }, part: "empty-state" }, this.icon && (h("div", { key: '5fd70dd13d10ad6e76f4c73ed43c7a4aca9c4fa1', class: "co-empty-state__icon" }, h("co-icon", { key: '75882f8eed9f64ffbe8b1163ea9d0a7666372ab2', name: this.icon, size: 40, weight: iconWeight }))), this.heading && (h("div", { key: '514ee7eb7b29867aa0d95088c03d6d24a1805f32', class: "co-empty-state__heading" }, this.heading)), this.description && (h("div", { key: '2e004a9bacf1094c0c1ee5ad697862b13d05241b', class: "co-empty-state__description" }, this.description)), h("div", { key: '4e78c8ce7a8169e4afabc9fbce485f40175ee1cb', class: "co-empty-state__actions" }, h("slot", { key: '519d8af5d16b2f3382044d3ee098207b97e1bbf4' }))));
     }
     static get is() { return "co-empty-state"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/co-event-calendar/co-event-calendar.js

@@ -2,6 +2,16 @@ import { h, } from "@stencil/core";
 import { addDays, addMonths, getMonthLabel, getMonthMatrix, parseISO, todayYMD, } from "@prolibu-suite/cobalt-date-utils";
 import { normalizeEvents, getLocalTimeZone, } from "@prolibu-suite/cobalt-calendar-utils";
 import { getDateStrings } from "../../utils/dateI18n";
+/**
+ * Calendario de eventos completo: vistas Mes, Semana y Día con barra de
+ * navegación. Es controlado: emite pedidos (`coEventDrop`, `coDateSelect`) y el
+ * host los aplica actualizando `events`. Los instantes son strings ISO-8601 con
+ * zona (o `YYYY-MM-DD` para todo el día); `timeZone` define el reloj en que se
+ * pintan. Wrapper Vue: `CoEventCalendar` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part toolbar - Barra de navegación (vista, fecha, hoy).
+ * @part body - Contenedor de la vista activa.
+ */
 export class CoEventCalendar {
     constructor() {
         /** Active view. `month`/`week`/`day` are implemented; `agenda` is pending. */
@@ -26,9 +36,11 @@ export class CoEventCalendar {
         this.allDaySlot = true;
         /** Visible-hours window for week/day (minutes-of-day bounds as "HH:mm"). */
         this.minTime = '00:00';
+        /** Última hora visible `HH:mm` en Semana/Día (default 24:00). */
         this.maxTime = '24:00';
         /** Slot/snap granularity (minutes) for week/day. */
         this.slotMinutes = 15;
+        /** Minutos a los que se ajustan arrastres y selecciones en Semana/Día (default 15). */
         this.snapMinutes = 15;
         /** Initial scroll position for week/day ("HH:mm"). */
         this.scrollTime = '07:00';
@@ -223,10 +235,10 @@ export class CoEventCalendar {
         const t = getDateStrings(this.locale);
         const views = this.viewsList;
         const a = parseISO(this.anchor);
-        return (h("div", { key: 'eb07a859a28ba0d09a3880a77a5b122c1ae063fb', class: "cal" }, h("div", { key: '693683cddfad9a1aed4be0bf3651cfff8b2ba1c7', class: "cal__toolbar", part: "toolbar" }, h("button", { key: '48f8fc44179b2950ea0498205f8f8a5d91d33e04', type: "button", class: "cal__btn", onClick: this.goToday }, (_a = t.today) !== null && _a !== void 0 ? _a : 'Today'), h("div", { key: '387a1cee67da85bf72e791ca2adc67f7482eb629', class: "cal__title-group" }, h("button", { key: '24d316422fb98f7d7c66ed6154a90f54a56cab12', type: "button", class: "cal__icon-btn", "aria-label": t.prevMonth, onClick: this.goPrev }, h("co-icon", { key: 'd0c575fce693943e91de8c578bb3371bfdb6425a', name: "caret-left", size: 16 })), h("h2", { key: '1bc26dd2c49d67854a1fc922cffc519485437f6a', class: "cal__title", "aria-live": "polite" }, this.title()), h("button", { key: '0e152157ed337011d00699b450b6a5cd10016b97', type: "button", class: "cal__icon-btn", "aria-label": t.nextMonth, onClick: this.goNext }, h("co-icon", { key: 'c821a72abc278e325cadfeae54b4d2b05984d3ba', name: "caret-right", size: 16 }))), views.length > 1 ? (h("div", { class: "cal__views", role: "tablist" }, views.map((v) => {
+        return (h("div", { key: '523b25e47b0d586ead40867d0c496b6d8fd1a21b', class: "cal" }, h("div", { key: '4943440f6f492be23a23f8820b1d638a0d292902', class: "cal__toolbar", part: "toolbar" }, h("button", { key: 'a6d890434149f15ef770db851e70e4d93646571b', type: "button", class: "cal__btn", onClick: this.goToday }, (_a = t.today) !== null && _a !== void 0 ? _a : 'Today'), h("div", { key: 'a617c5087b9055bc4f8530eafe619cca49c0930e', class: "cal__title-group" }, h("button", { key: '1b2f1ba3972d815be76a4527711e887066a994a1', type: "button", class: "cal__icon-btn", "aria-label": t.prevMonth, onClick: this.goPrev }, h("co-icon", { key: '918828dec396d69678618d40c8aeb3793c6aa620', name: "caret-left", size: 16 })), h("h2", { key: 'c099fc2e18fa07f79fe0a0e72e372e71b658c553', class: "cal__title", "aria-live": "polite" }, this.title()), h("button", { key: '52c2ad1d1a06955f892ac6d179d905270df3a967', type: "button", class: "cal__icon-btn", "aria-label": t.nextMonth, onClick: this.goNext }, h("co-icon", { key: '9b4becd4d18465a86d42491291166ccad94973d3', name: "caret-right", size: 16 }))), views.length > 1 ? (h("div", { class: "cal__views", role: "tablist" }, views.map((v) => {
             var _a;
             return (h("button", { type: "button", role: "tab", "aria-selected": this.view === v ? 'true' : 'false', class: { 'cal__view-btn': true, 'cal__view-btn--active': this.view === v }, onClick: () => this.switchView(v) }, (_a = t[v]) !== null && _a !== void 0 ? _a : v));
-        }))) : (h("span", { class: "cal__views-spacer" }))), h("div", { key: '2472ed0d314a489f41f2f46dc7988ce8860a64c2', class: "cal__body", part: "body" }, this.view === 'month' ? (h("co-calendar-month", { loading: this.loading, events: this.normalized, year: a.year, month: a.month, locale: this.locale, firstDayOfWeek: this.firstDayOfWeek, timeZone: this.tz, minDate: this.minDate, maxDate: this.maxDate, editable: this.editable, selectable: this.selectable, maxLanes: this.dayMaxEvents, onCoDaySelect: this.handleDaySelect, onCoEventClick: this.handleEventClick, onCoEventDblClick: this.handleEventDblClick, onCoEventDrop: this.handleEventDrop, onCoMoreClick: this.handleMoreClick })) : this.view === 'week' || this.view === 'day' ? (h("co-calendar-timegrid", { loading: this.loading, events: this.normalized, dates: this.visibleDates, locale: this.locale, timeZone: this.tz, editable: this.editable, selectable: this.selectable, minDate: this.minDate, maxDate: this.maxDate, onCoRangeSelect: this.handleRangeSelect, onCoEventClick: this.handleEventClick, onCoEventDblClick: this.handleEventDblClick, onCoEventDrop: this.handleEventDrop, defaultDurationMinutes: this.defaultDurationMinutes, allDaySlot: this.allDaySlot, minTime: this.minTime, maxTime: this.maxTime, slotMinutes: this.slotMinutes, snapMinutes: this.snapMinutes, scrollTime: this.scrollTime, nowIndicator: this.nowIndicator })) : (h("div", { class: "cal__placeholder" }, h("co-icon", { name: "calendar-dots", size: 32 }), h("p", null, `${this.view} view — coming soon`))))));
+        }))) : (h("span", { class: "cal__views-spacer" }))), h("div", { key: '266dc8d6f4b490559eaa648970328e0861d44ec8', class: "cal__body", part: "body" }, this.view === 'month' ? (h("co-calendar-month", { loading: this.loading, events: this.normalized, year: a.year, month: a.month, locale: this.locale, firstDayOfWeek: this.firstDayOfWeek, timeZone: this.tz, minDate: this.minDate, maxDate: this.maxDate, editable: this.editable, selectable: this.selectable, maxLanes: this.dayMaxEvents, onCoDaySelect: this.handleDaySelect, onCoEventClick: this.handleEventClick, onCoEventDblClick: this.handleEventDblClick, onCoEventDrop: this.handleEventDrop, onCoMoreClick: this.handleMoreClick })) : this.view === 'week' || this.view === 'day' ? (h("co-calendar-timegrid", { loading: this.loading, events: this.normalized, dates: this.visibleDates, locale: this.locale, timeZone: this.tz, editable: this.editable, selectable: this.selectable, minDate: this.minDate, maxDate: this.maxDate, onCoRangeSelect: this.handleRangeSelect, onCoEventClick: this.handleEventClick, onCoEventDblClick: this.handleEventDblClick, onCoEventDrop: this.handleEventDrop, defaultDurationMinutes: this.defaultDurationMinutes, allDaySlot: this.allDaySlot, minTime: this.minTime, maxTime: this.maxTime, slotMinutes: this.slotMinutes, snapMinutes: this.snapMinutes, scrollTime: this.scrollTime, nowIndicator: this.nowIndicator })) : (h("div", { class: "cal__placeholder" }, h("co-icon", { name: "calendar-dots", size: 32 }), h("p", null, `${this.view} view — coming soon`))))));
     }
     static get is() { return "co-event-calendar"; }
     static get encapsulation() { return "shadow"; }
@@ -581,7 +593,7 @@ export class CoEventCalendar {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "\u00DAltima hora visible `HH:mm` en Semana/D\u00EDa (default 24:00)."
                 },
                 "getter": false,
                 "setter": false,
@@ -621,7 +633,7 @@ export class CoEventCalendar {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Minutos a los que se ajustan arrastres y selecciones en Semana/D\u00EDa (default 15)."
                 },
                 "getter": false,
                 "setter": false,

package/dist/collection/components/co-event-popover/co-event-popover.js

@@ -6,14 +6,26 @@ import { computePosition } from "../../utils/positioning";
  * getBoundingClientRect), promotes to the top-layer (the calendar shell has
  * contain:layout ancestors that re-anchor position:fixed), and closes on Escape /
  * outside-click. Content is slotted by the host (suite-v2 fills the meeting fields).
+ *
+ * Wrapper Vue: `CoEventPopover` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot actions - Botones de acción de la esquina (editar, borrar, cerrar…).
+ * @slot - Contenido del detalle del evento.
+ *
+ * @part actions - Fila de acciones (slot `actions`).
+ * @part body - Cuerpo del detalle (slot por defecto).
  */
 export class CoEventPopover {
     constructor() {
+        /** Visible (reflejado); el componente lo pone en `false` al cerrarse por Escape o click afuera. */
         this.open = false;
+        /** Lado y alineación respecto de `anchorRect` (default `right-start`); voltea si no cabe. */
         this.placement = 'right-start';
         /** Render the leading color dot. Set false for dot-less content (quick-create). */
         this.dot = true;
+        /** Cierra con Escape (default `true`). */
         this.closeOnEscape = true;
+        /** Cierra con un click fuera del panel (default `true`). */
         this.closeOnClickOutside = true;
         this.position = () => {
             if (!this.open || !this.panelEl || !this.anchorRect)
@@ -118,7 +130,7 @@ export class CoEventPopover {
         this.coClose.emit();
     }
     render() {
-        return (h(Host, { key: '8febb91e9c26e67bdd8edde9bd95e24b9a6f4b04' }, h("div", { key: '1311c574b0bae76fb85952da3b5e8531d77e1b25', class: "pop", popover: "manual", role: "dialog", "aria-modal": "false", "aria-label": this.popoverLabel, tabIndex: -1, ref: (el) => (this.panelEl = el) }, h("div", { key: '9d275e1b245f0bd4f95ba13743d6a9080b3d581a', class: "pop__actions", part: "actions" }, h("slot", { key: '322fefefddfe8ba575185fa093a980197f267311', name: "actions" })), h("div", { key: '22243bc4a6d4723843c490b9fa41796f31f401f8', class: "pop__head" }, this.dot && h("span", { key: '09d3e746f133432f0946e023e93aa92bcf5f9952', class: "pop__dot", style: this.color ? { background: this.color } : {} }), h("div", { key: '27d6f3ca1896ea02e08515db3fc8a7a58a51daeb', class: "pop__body", part: "body" }, h("slot", { key: 'd098bfca183fe303f6cb85f496f7ed1914b5e26b' }))))));
+        return (h(Host, { key: '9796ba38e83610ddb390dcab0818baf6bededc72' }, h("div", { key: 'e08bba8ebefb5206cbdd7a554e25ff9f4fcf9541', class: "pop", popover: "manual", role: "dialog", "aria-modal": "false", "aria-label": this.popoverLabel, tabIndex: -1, ref: (el) => (this.panelEl = el) }, h("div", { key: '185e30ed1640cbfb04e056d7a3433df2f5b94e06', class: "pop__actions", part: "actions" }, h("slot", { key: 'db04986cc1b63d52c5f1cc6579b5d00dbd46e476', name: "actions" })), h("div", { key: '89bbdc2a255e18d180183dbb127ce05a72ff262d', class: "pop__head" }, this.dot && h("span", { key: '6819901baff501958c8214dd7546a90a108c45f5', class: "pop__dot", style: this.color ? { background: this.color } : {} }), h("div", { key: '1111598f3ee886a0f2d9360c57278f1d71b76ddc', class: "pop__body", part: "body" }, h("slot", { key: '82c5eb8ff0e7752993d8b25b6d33a4d15d7edd25' }))))));
     }
     static get is() { return "co-event-popover"; }
     static get encapsulation() { return "shadow"; }
@@ -146,7 +158,7 @@ export class CoEventPopover {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Visible (reflejado); el componente lo pone en `false` al cerrarse por Escape o click afuera."
                 },
                 "getter": false,
                 "setter": false,
@@ -190,7 +202,7 @@ export class CoEventPopover {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Lado y alineaci\u00F3n respecto de `anchorRect` (default `right-start`); voltea si no cabe."
                 },
                 "getter": false,
                 "setter": false,
@@ -249,7 +261,7 @@ export class CoEventPopover {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cierra con Escape (default `true`)."
                 },
                 "getter": false,
                 "setter": false,
@@ -269,7 +281,7 @@ export class CoEventPopover {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cierra con un click fuera del panel (default `true`)."
                 },
                 "getter": false,
                 "setter": false,
@@ -307,7 +319,7 @@ export class CoEventPopover {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se cerr\u00F3 (Escape o click afuera). No burbujea."
                 },
                 "complexType": {
                     "original": "void",

package/dist/collection/components/co-fab/co-fab.css

@@ -1,5 +1,13 @@
 /* co-fab — floating action button */
 
+/**
+ * @prop --co-fab-bg: Fondo de la variante `primary` (default negro sólido).
+ * @prop --co-fab-offset-bottom: Distancia al borde inferior con `position` bottom-* (default 24px).
+ * @prop --co-fab-offset-top: Distancia al borde superior con `position` top-* (default 24px).
+ * @prop --co-fab-offset-right: Distancia al borde derecho con `position` *-right (default 24px).
+ * @prop --co-fab-offset-left: Distancia al borde izquierdo con `position` *-left (default 24px).
+ */
+
 :host {
   display: inline-flex;
   font-family: var(--co-font-family-primary);