@prolibu-suite/cobalt-core 0.11.0 → 0.11.1

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

@@ -25,7 +25,8 @@ let instanceSeq = 0;
  * @part toolbar - Barra de formato
  * @part canvas - Superficie donde se centran las hojas
  * @part sheet - El papel
- * @part header-band - Banda del encabezado de la primera hoja
+ * @part header-band - Banda del encabezado de la primera hoja *
+ * Wrapper Vue: `CoDocumentEditor` de `@prolibu-suite/cobalt-vue`.
  */
 export class CoDocumentEditor {
     constructor() {
@@ -41,6 +42,7 @@ export class CoDocumentEditor {
         this.headerHeight = 45;
         /** CSS de impresión del host; se acota a la hoja. */
         this.pageStyles = '';
+        /** Solo lectura: sin barra ni edición (el encabezado tampoco se puede editar). */
         this.readonly = false;
         /** BCP-47 para los textos de la UI ('es', 'en', 'pt-BR'…). */
         this.locale = 'en';
@@ -500,6 +502,7 @@ export class CoDocumentEditor {
     async getHeaderHtml() {
         return this.currentHeaderHtml;
     }
+    /** Cuerpo como JSON de ProseMirror, o `null` si todavía no montó. */
     async getJSON() {
         return this.editor ? this.editor.getJSON() : null;
     }
@@ -544,18 +547,22 @@ export class CoDocumentEditor {
             forceUpdate(this);
         }
     }
+    /** Inserta un campo `[[name]]` en el cursor; `opts`: `required`, `type`, `enum`, `value`. */
     async insertField(name, opts) {
         var _a;
         (_a = this.editor) === null || _a === void 0 ? void 0 : _a.chain().focus().insertField(name, opts).run();
     }
+    /** Inserta el siguiente marcador de firma libre (`⟦sig:N⟧`) en el cursor. */
     async insertSignatureSlot() {
         var _a;
         (_a = this.editor) === null || _a === void 0 ? void 0 : _a.chain().focus().insertSignatureSlot().run();
     }
+    /** Enfoca el cuerpo del documento. */
     async focusEditor() {
         var _a;
         (_a = this.editor) === null || _a === void 0 ? void 0 : _a.commands.focus();
     }
+    /** Instancia Tiptap del cuerpo (escape hatch), o `null` antes de montar. */
     async getEditorInstance() {
         var _a;
         return (_a = this.editor) !== null && _a !== void 0 ? _a : null;
@@ -844,8 +851,8 @@ export class CoDocumentEditor {
             width: `${page.width * this.scale}px`,
             height: this.stageHeight ? `${this.stageHeight * this.scale}px` : 'auto',
         };
-        const zoomButton = (mode, label) => (h("button", { key: '3a2671fec095ced83d7c345f817770833a3ea2c3', type: "button", class: { 'co-doc-editor__zoom-btn': true, 'co-doc-editor__zoom-btn--active': this.zoomMode === mode }, "aria-pressed": String(this.zoomMode === mode), onClick: () => this.setZoom(mode) }, label));
-        return (h(Host, { key: '9f52b22003b54313cf5231804a476690778b22b6' }, h("div", { key: '88184e065b0f6184c3d06097c4243d1ebe7bc6c5', class: { 'co-doc-editor': true, 'co-doc-editor--readonly': this.readonly, 'co-doc-editor--loading': !this.ready }, part: "wrapper" }, h("div", { key: 'a1cf9f2eb7c23f8a4ca9b2f5098222f54d0168a8', class: "co-doc-editor__bar", part: "bar" }, !this.readonly && (h("co-rich-text-toolbar", { key: '889ae86009703a14bec362608e2e81770f963ff0', class: "co-doc-editor__toolbar", part: "toolbar", variant: "document", position: "top", disabled: false, locale: this.locale, attachmentsEnabled: false, documentHeaderEnabled: this.documentHeaderEnabled, extraItems: this.parsedExtraItems, onCoAction: this.handleToolbarAction, ref: (el) => (this.toolbarEl = el) })), h("div", { key: 'ed349a7dd902fa1569e9efb4e77611835bfa4236', class: "co-doc-editor__zoom", role: "group", "aria-label": s.zoom }, this.zoomMode === 'custom' && h("span", { key: 'a80bfe10a8fea8822084935ed8dbf6b7c0835b2c', class: "co-doc-editor__zoom-level" }, `${Math.round(this.scale * 100)} %`), zoomButton('fit', s.zoomFit), zoomButton('actual', s.zoomActual))), h("div", { key: 'dd283d50eb5712d34e5568727be504aa972a3b2a', class: "co-doc-editor__body" }, h("div", { key: '972162fb86e9b560bcf9d86e50a548cb8fea1d7b', class: "co-doc-editor__canvas", part: "canvas", ref: (el) => (this.canvasEl = el) }, h("div", { key: '409e773a4ba786ea867816a8715585dce000d618', class: "co-doc-editor__zoom-frame", style: frameStyle }, h("div", { key: '0ad67ae01d7aebb0f7f7fd1cacbddc2db3c7c7cc', class: "co-doc-editor__stage", style: { transform: `scale(${this.scale})` }, ref: (el) => (this.stageEl = el) }, h("div", { key: 'e8ca10170b25ff5bd4ebf9382205c1b84bae844a', class: "co-doc-editor__sheet", part: "sheet", "data-co-doc": this.instanceId, style: sheetVars }, h("style", { key: "page-styles", "data-co-doc-page-styles": "", ref: (el) => (this.styleEl = el) }), h("div", { key: "paper", class: "co-doc-editor__paper", "data-theme": "light" }, this.renderHeaderBand(), h("div", { key: "content", class: "co-doc-editor__content", ref: (el) => (this.contentEl = el) }), this.renderOverlays()))))), h("slot", { key: '9a3f5af0b445a56513ac894ac7a6ff67314e611d', name: "aside" })))));
+        const zoomButton = (mode, label) => (h("button", { key: 'da1c68e89c973899e18720d3cf25b861d158f7c1', type: "button", class: { 'co-doc-editor__zoom-btn': true, 'co-doc-editor__zoom-btn--active': this.zoomMode === mode }, "aria-pressed": String(this.zoomMode === mode), onClick: () => this.setZoom(mode) }, label));
+        return (h(Host, { key: '254d9df102441f867dc46eb71039df92d99ad102' }, h("div", { key: '29723bbee5dd3eae004c6df4c330e8589388636d', class: { 'co-doc-editor': true, 'co-doc-editor--readonly': this.readonly, 'co-doc-editor--loading': !this.ready }, part: "wrapper" }, h("div", { key: '9257d370d8547f08402fbaaed2d4a6aa30d94e70', class: "co-doc-editor__bar", part: "bar" }, !this.readonly && (h("co-rich-text-toolbar", { key: '8fff97e80464889cb0e6e60d8d9f69308f987e9f', class: "co-doc-editor__toolbar", part: "toolbar", variant: "document", position: "top", disabled: false, locale: this.locale, attachmentsEnabled: false, documentHeaderEnabled: this.documentHeaderEnabled, extraItems: this.parsedExtraItems, onCoAction: this.handleToolbarAction, ref: (el) => (this.toolbarEl = el) })), h("div", { key: '00ff09c93887815f84bbb9c68e9485fd64c3c0b6', class: "co-doc-editor__zoom", role: "group", "aria-label": s.zoom }, this.zoomMode === 'custom' && h("span", { key: '956f0fa4e803a0e27fa32a28116d1e397a2dc402', class: "co-doc-editor__zoom-level" }, `${Math.round(this.scale * 100)} %`), zoomButton('fit', s.zoomFit), zoomButton('actual', s.zoomActual))), h("div", { key: '4a44bc41d6a641a5f4543422bd7263f2bd962f99', class: "co-doc-editor__body" }, h("div", { key: '467491e684b9487d507861d54c37b06b752216f4', class: "co-doc-editor__canvas", part: "canvas", ref: (el) => (this.canvasEl = el) }, h("div", { key: '66653efbda8e0dffb7bc1fdb07d0be31b4f5c8a9', class: "co-doc-editor__zoom-frame", style: frameStyle }, h("div", { key: '06407fc5177c21f4edc60b900a17a8c44ef193ab', class: "co-doc-editor__stage", style: { transform: `scale(${this.scale})` }, ref: (el) => (this.stageEl = el) }, h("div", { key: '440f1ced158d76650618bc0f153c3201503550a1', class: "co-doc-editor__sheet", part: "sheet", "data-co-doc": this.instanceId, style: sheetVars }, h("style", { key: "page-styles", "data-co-doc-page-styles": "", ref: (el) => (this.styleEl = el) }), h("div", { key: "paper", class: "co-doc-editor__paper", "data-theme": "light" }, this.renderHeaderBand(), h("div", { key: "content", class: "co-doc-editor__content", ref: (el) => (this.contentEl = el) }), this.renderOverlays()))))), h("slot", { key: '1478889436471ed2707db4e361d878faf7c56f2e', name: "aside" })))));
     }
     static get is() { return "co-document-editor"; }
     static get originalStyleUrls() {
@@ -929,7 +936,7 @@ export class CoDocumentEditor {
                     "references": {
                         "DocumentPageSize": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-document-editor/co-document-editor.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-document-editor/co-document-editor.tsx",
                             "id": "src/components/co-document-editor/co-document-editor.tsx::DocumentPageSize"
                         }
                     }
@@ -955,7 +962,7 @@ export class CoDocumentEditor {
                     "references": {
                         "DocumentMargins": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-document-editor/co-document-editor.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-document-editor/co-document-editor.tsx",
                             "id": "src/components/co-document-editor/co-document-editor.tsx::DocumentMargins"
                         }
                     }
@@ -1020,7 +1027,7 @@ export class CoDocumentEditor {
                     "references": {
                         "DocumentFeatures": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-document-editor/co-document-editor.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-document-editor/co-document-editor.tsx",
                             "id": "src/components/co-document-editor/co-document-editor.tsx::DocumentFeatures"
                         }
                     }
@@ -1072,7 +1079,7 @@ export class CoDocumentEditor {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Solo lectura: sin barra ni edici\u00F3n (el encabezado tampoco se puede editar)."
                 },
                 "getter": false,
                 "setter": false,
@@ -1213,7 +1220,7 @@ export class CoDocumentEditor {
                     "references": {
                         "DocumentHeaderDetail": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-document-editor/co-document-editor.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-document-editor/co-document-editor.tsx",
                             "id": "src/components/co-document-editor/co-document-editor.tsx::DocumentHeaderDetail"
                         }
                     }
@@ -1249,7 +1256,7 @@ export class CoDocumentEditor {
                     "references": {
                         "DocumentActionDetail": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-document-editor/co-document-editor.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-document-editor/co-document-editor.tsx",
                             "id": "src/components/co-document-editor/co-document-editor.tsx::DocumentActionDetail"
                         }
                     }
@@ -1262,7 +1269,7 @@ export class CoDocumentEditor {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "El editor termin\u00F3 de montar. No burbujea."
                 },
                 "complexType": {
                     "original": "void",
@@ -1320,7 +1327,7 @@ export class CoDocumentEditor {
                     "return": "Promise<object | null>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Cuerpo como JSON de ProseMirror, o `null` si todav\u00EDa no mont\u00F3.",
                     "tags": []
                 }
             },
@@ -1439,7 +1446,7 @@ export class CoDocumentEditor {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Inserta un campo `[[name]]` en el cursor; `opts`: `required`, `type`, `enum`, `value`.",
                     "tags": []
                 }
             },
@@ -1456,7 +1463,7 @@ export class CoDocumentEditor {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Inserta el siguiente marcador de firma libre (`\u27E6sig:N\u27E7`) en el cursor.",
                     "tags": []
                 }
             },
@@ -1473,7 +1480,7 @@ export class CoDocumentEditor {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Enfoca el cuerpo del documento.",
                     "tags": []
                 }
             },
@@ -1496,7 +1503,7 @@ export class CoDocumentEditor {
                     "return": "Promise<Editor | null>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Instancia Tiptap del cuerpo (escape hatch), o `null` antes de montar.",
                     "tags": []
                 }
             }

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: 'fba210f4eb2629fdbc599cacd37bb547b43f01a7', 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: 'ae0d0449a7c0057dcdf527bb67196745b9173852', 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: '28e0b0232514e4d936eb6c4a5e5096a9eb9b20eb' }), this.active && (h("div", { key: '21f78c6c91184f1e6f8ef0f8d37f4ce0f2db73a6', class: "co-drop-zone__overlay", part: "overlay" }, h("div", { key: '1e413d3eb21b4425d7b47834fdc23e84b35c890d', class: "co-drop-zone__badge", part: "badge" }, h("co-icon", { key: '7d3f145bdf6fae71b31ee8e77ac9243d2101c740', name: this.icon, size: 34 })), h("span", { key: '1ed93eabef61c01cedfcf94cd4a31c8a1968ce90', 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: '75eb6f07186ba466fa831f35d3a1d4c0283276bc', 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: 'd785f750db7b96d40bc4d48f8110f355dd25ddc2', class: "co-emoji-picker__search", part: "search" }, h("co-icon", { key: 'c2f74a0cae224a5ad92dfe79cd88c39324004531', name: "magnifying-glass", size: 16 }), h("input", { key: '98221cd4dea82d03dc652c7db4b4ee19bb44c722', 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: '7124c7d0fb624678207c409254eb0514346447f8', 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: '5e941a4ec0594953dcc5bac59d0bef1f3ce53712', 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: '191c38c574ecf961bbeffc83783e820e5dfdde0c', 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: '4e6c36922ed59f5d65f5ce73f261eb3ccdc72e35', class: "co-empty-state__icon" }, h("co-icon", { key: '5dc6b8fb6c67539ea16e2171676e2b5de96ca194', name: this.icon, size: 40, weight: iconWeight }))), this.heading && (h("div", { key: '4be3d32fda76c0e603651507cc1bd1c3b2d6fad9', class: "co-empty-state__heading" }, this.heading)), this.description && (h("div", { key: 'ee920e1eb636a1a55a0f9d32145f69c16d072b52', class: "co-empty-state__description" }, this.description)), h("div", { key: 'eb22109eab803e58eec32d8603aefa783b1e2d17', class: "co-empty-state__actions" }, h("slot", { key: '14f7583ee7ef6db2e0e5d38eb336d3d4469e7fd7' }))));
+            }, 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: '21a10260d591309d68ecb02004ea1160fa8eab8b', class: "cal" }, h("div", { key: '4d4038feb333d2da935dd46bf058b876b0ca7657', class: "cal__toolbar", part: "toolbar" }, h("button", { key: '79e01f296686ade3bd8c8598fd26e0e304122d7f', type: "button", class: "cal__btn", onClick: this.goToday }, (_a = t.today) !== null && _a !== void 0 ? _a : 'Today'), h("div", { key: '9f4e4fb351b96bad31dbd6cb7628bd4171434709', class: "cal__title-group" }, h("button", { key: '511837460816d0ebbe542995c72fcc6d08ec4671', type: "button", class: "cal__icon-btn", "aria-label": t.prevMonth, onClick: this.goPrev }, h("co-icon", { key: 'cb7cd8b28e0502c9da1611f4e28d6ff3bee86652', name: "caret-left", size: 16 })), h("h2", { key: '7892530164e755daba2c8f1ea39661fc40ecf852', class: "cal__title", "aria-live": "polite" }, this.title()), h("button", { key: '56297f90364a3628bac3d2e1d3080339ba8b27e1', type: "button", class: "cal__icon-btn", "aria-label": t.nextMonth, onClick: this.goNext }, h("co-icon", { key: '2576d8083c47024e243e7de7019433de80ec6126', 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: '48b98ddc4835df8bfa3b3654e197983966002b10', 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: 'a646f722530e2198c0a0b082de540021be9cc9c0' }, h("div", { key: 'b9937d848335d6d5e21ac34d392a842815c51ffe', class: "pop", popover: "manual", role: "dialog", "aria-modal": "false", "aria-label": this.popoverLabel, tabIndex: -1, ref: (el) => (this.panelEl = el) }, h("div", { key: '81b409086819ab1623fc2759742795bd9b3fca28', class: "pop__actions", part: "actions" }, h("slot", { key: '21080d17fc497bcc7d0f537397686ddb03e0cd60', name: "actions" })), h("div", { key: '1a6e0ab2801ae963579e4f50b8132fe3f26d84f9', class: "pop__head" }, this.dot && h("span", { key: '04abf696922f1a93b15ab3b9066782bc9b08a89d', class: "pop__dot", style: this.color ? { background: this.color } : {} }), h("div", { key: '659f842611275562d4617d2f1f6ecbc73920d914', class: "pop__body", part: "body" }, h("slot", { key: 'b5606cdff567ae0f16bb2dcf228987de3b376d34' }))))));
+        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);

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

@@ -1,9 +1,18 @@
 import { h } from "@stencil/core";
+/**
+ * Botón de acción flotante para la acción principal de una pantalla: círculo
+ * con ícono o, con `label`, pastilla extendida. `position` lo fija a una esquina
+ * de la ventana. Wrapper Vue: `CoFab` de `@prolibu-suite/cobalt-vue`.
+ */
 export class CoFab {
     constructor() {
+        /** Ícono Phosphor (default `plus`). */
         this.icon = 'plus';
+        /** Estilo: `primary` (negro sólido), `secondary` o `stroke`. */
         this.variant = 'primary';
+        /** Diámetro: `xl` 64 · `l` 56 · `m` 48 (default) · `s` 40 px. */
         this.size = 'm';
+        /** Deshabilita el botón: no emite `coClick`. */
         this.disabled = false;
         /** Fixed position on screen */
         this.position = 'none';
@@ -28,7 +37,7 @@ export class CoFab {
         const iconSize = this.size === 'xl' ? 24 : this.size === 'l' ? 24 : this.size === 's' ? 18 : 20;
         const hasLabel = !!this.label;
         const hoverExpand = hasLabel && this.expandOnHover;
-        return (h("button", { key: '5ac75328c6505b000c84e5f5365abfabad1dc831', class: {
+        return (h("button", { key: 'cae304a87d9ad88c7ea2f1d2f926d018250e6128', class: {
                 'co-fab': true,
                 [`co-fab--${this.variant}`]: true,
                 [`co-fab--${this.size}`]: true,
@@ -36,7 +45,7 @@ export class CoFab {
                 'co-fab--hover-expand': hoverExpand,
                 'co-fab--disabled': this.disabled,
                 [`co-fab--${this.position}`]: this.position !== 'none',
-            }, type: "button", disabled: this.disabled, onClick: this.handleClick, onPointerEnter: this.handleExpandMeasure, onFocusin: this.handleExpandMeasure, "aria-label": this.ariaLabelText || this.label || this.icon }, h("co-icon", { key: '9bde6e77c635eb64bca7cc7e129eb2ebe4f8a004', name: this.icon, size: iconSize }), this.label && (h("span", { key: '412f43091a9ba740b1ceddbe1539f60e3d1c27d1', class: "co-fab__label", ref: (el) => (this.labelEl = el) }, this.label))));
+            }, type: "button", disabled: this.disabled, onClick: this.handleClick, onPointerEnter: this.handleExpandMeasure, onFocusin: this.handleExpandMeasure, "aria-label": this.ariaLabelText || this.label || this.icon }, h("co-icon", { key: 'a1384ce9899fb2cbf5f4917cca49fb41480d82f6', name: this.icon, size: iconSize }), this.label && (h("span", { key: 'c5d7370d87478218dcce73c3c1d3edbf1c5c4a01', class: "co-fab__label", ref: (el) => (this.labelEl = el) }, this.label))));
     }
     static get is() { return "co-fab"; }
     static get encapsulation() { return "shadow"; }
@@ -64,7 +73,7 @@ export class CoFab {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "\u00CDcono Phosphor (default `plus`)."
                 },
                 "getter": false,
                 "setter": false,
@@ -84,7 +93,7 @@ export class CoFab {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto: convierte el c\u00EDrculo en una pastilla extendida (o se revela con `expandOnHover`)."
                 },
                 "getter": false,
                 "setter": false,
@@ -103,7 +112,7 @@ export class CoFab {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Estilo: `primary` (negro s\u00F3lido), `secondary` o `stroke`."
                 },
                 "getter": false,
                 "setter": false,
@@ -123,7 +132,7 @@ export class CoFab {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Di\u00E1metro: `xl` 64 \u00B7 `l` 56 \u00B7 `m` 48 (default) \u00B7 `s` 40 px."
                 },
                 "getter": false,
                 "setter": false,
@@ -162,7 +171,7 @@ export class CoFab {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita el bot\u00F3n: no emite `coClick`."
                 },
                 "getter": false,
                 "setter": false,
@@ -221,7 +230,7 @@ export class CoFab {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Click en el bot\u00F3n (no se emite con `disabled`). Sin `detail`."
                 },
                 "complexType": {
                     "original": "void",