@prolibu-suite/cobalt-core 0.10.3 → 0.11.0

package/dist/collection/components/co-ref-field/co-ref-field.js

@@ -505,7 +505,7 @@ export class CoRefField {
     }
     // ── Main render ────────────────────────────────────────────
     render() {
-        return (h("div", { key: 'fa7de667cc9002d1a4a042b0d200524cbcb89b78', class: "co-ref-field" }, (this.label || this.secondaryLabel) && (h("div", { key: 'a6ddd5b71364e4f5bdf63b04faa09bfc0a32f6bc', class: "co-ref-field__labels" }, this.label && (h("label", { key: '766f803c8be77f72e52e4d3cdd7b6d7a363a146a', class: "co-ref-field__label" }, this.labelIcon && (h("co-icon", { key: 'a8b6c7f189af4b9f37de8c3cc96cb489fd9183e4', class: "co-ref-field__label-icon", name: this.labelIcon, size: 16 })), this.label, h(RequiredMark, { key: '643edcb040ef9a91040e8d52f628bc0af06c36ba', required: this.required }))), this.secondaryLabel && (h("span", { key: '7a107c578e003760423acc6d450f2a42a0868375', class: "co-ref-field__secondary-label" }, this.secondaryLabel)))), h("co-popover", { key: '9938ca629c5927156ea137adfefd1d927104312b', open: this.isOpen, placement: "bottom-start", matchWidth: !this.panelWidth, offset: 4, onCoOpen: this.handlePopoverOpen, onCoClose: this.handlePopoverClose }, h("div", { key: '7618ea5fb13e4944596fd728cf934b5c28bd29ab', slot: "trigger" }, this.renderTrigger()), this.isOpen && this.renderPanel()), this.helperText && (h("div", { key: '1dd9fc7659e8f8791bb4b785407b0e89b32107c8', class: `co-ref-field__helper co-ref-field__helper--${this.status}` }, this.status !== 'default' && (h("co-icon", { key: '399674b95ebcc91581f1f1cea54451f8ee33d9da', name: this.status === 'error' ? 'warning-circle' : this.status === 'success' ? 'check-circle' : 'info', size: 14 })), h("span", { key: '640adc4e5cd4cd742a171cac1319b75489cb7ef8' }, this.helperText)))));
+        return (h("div", { key: '67a5576b8bd40fce7ba99fd4cc32ea6666fc409c', class: "co-ref-field" }, (this.label || this.secondaryLabel) && (h("div", { key: 'e0a34e6913484e07d9b758ffb85969e1f5790603', class: "co-ref-field__labels" }, this.label && (h("label", { key: '7db53aa0ad57d8edbb4d745d52c9c6d6fa7697d1', class: "co-ref-field__label" }, this.labelIcon && (h("co-icon", { key: '220706f3a48453d84de18f8a12574560dcd33f16', class: "co-ref-field__label-icon", name: this.labelIcon, size: 16 })), this.label, h(RequiredMark, { key: 'fd1814aab65fadc89ae8bf8db4af9a7279761c23', required: this.required }))), this.secondaryLabel && (h("span", { key: '9d9292a8295a73536638718a67c97f326cece53a', class: "co-ref-field__secondary-label" }, this.secondaryLabel)))), h("co-popover", { key: '934f77e646fbe81f935415202884eead11b7044b', open: this.isOpen, placement: "bottom-start", matchWidth: !this.panelWidth, offset: 4, onCoOpen: this.handlePopoverOpen, onCoClose: this.handlePopoverClose }, h("div", { key: '840494a7ea54f4c58e77d90e1dc7c57713c26a25', slot: "trigger" }, this.renderTrigger()), this.isOpen && this.renderPanel()), this.helperText && (h("div", { key: '6ee3efb271c12356166e2980b521c31b3bda66ff', class: `co-ref-field__helper co-ref-field__helper--${this.status}` }, this.status !== 'default' && (h("co-icon", { key: '8889e534784663f5dabff0ffba4e7fa946916aa2', name: this.status === 'error' ? 'warning-circle' : this.status === 'success' ? 'check-circle' : 'info', size: 14 })), h("span", { key: 'a731a16b2bd53d83a7a0ed3c75d9cdb9ea3b5191' }, this.helperText)))));
     }
     static get is() { return "co-ref-field"; }
     static get encapsulation() { return "shadow"; }
@@ -1321,7 +1321,7 @@ export class CoRefField {
                     "references": {
                         "RefFieldOption": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-0.10.3/packages/core/src/components/co-ref-field/co-ref-field.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-ref-field/co-ref-field.tsx",
                             "id": "src/components/co-ref-field/co-ref-field.tsx::RefFieldOption"
                         }
                     }
@@ -1462,7 +1462,7 @@ export class CoRefField {
                     "references": {
                         "RefFieldOption": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-0.10.3/packages/core/src/components/co-ref-field/co-ref-field.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-ref-field/co-ref-field.tsx",
                             "id": "src/components/co-ref-field/co-ref-field.tsx::RefFieldOption"
                         }
                     }
@@ -1483,7 +1483,7 @@ export class CoRefField {
                     "references": {
                         "RefFieldOption": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-0.10.3/packages/core/src/components/co-ref-field/co-ref-field.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-ref-field/co-ref-field.tsx",
                             "id": "src/components/co-ref-field/co-ref-field.tsx::RefFieldOption"
                         }
                     }
@@ -1522,7 +1522,7 @@ export class CoRefField {
                         },
                         "RefFieldOption": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-0.10.3/packages/core/src/components/co-ref-field/co-ref-field.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-ref-field/co-ref-field.tsx",
                             "id": "src/components/co-ref-field/co-ref-field.tsx::RefFieldOption"
                         }
                     },

package/dist/collection/components/co-rich-text-editor/co-rich-text-editor.js

@@ -1,6 +1,7 @@
 import { h } from "@stencil/core";
 import * as RichText from "@prolibu-suite/cobalt-rich-text";
 import { getRichTextStrings } from "../../utils/richTextI18n";
+import { applyExternalValue, buildOutput, EchoGuard, parseEditorValue, parseFeatures, syncImageLayouts, syncToolbarEditor } from "../../utils/rich-text-host";
 /**
  * Rich text editor backed by Tiptap v3.
  *
@@ -63,10 +64,8 @@ export class CoRichTextEditor {
         this._loadedAccountFonts = [];
         this._fontLoaderCalled = false;
         this._fontLoaderLoading = false;
-        /** Last emitted JSON string — guards the value Watch against feedback loops. */
-        this.lastEmittedJson = null;
-        /** Last emitted HTML string — parents often send HTML back via value prop. */
-        this.lastEmittedHtml = '';
+        /** Guarda anti-eco compartida (utils/rich-text-host). */
+        this.echo = new EchoGuard();
         /** True while applying an external value (suppresses emit). */
         this.applyingExternal = false;
         this.rt = RichText;
@@ -76,15 +75,10 @@ export class CoRichTextEditor {
             if (this.applyingExternal)
                 return;
             const out = this.buildOutput(editor);
-            // Track both JSON and HTML forms to prevent feedback loops.
-            // The parent may send back either format via the value prop.
-            this.lastEmittedJson = out.json ? JSON.stringify(out.json) : null;
-            this.lastEmittedHtml = out.html;
-            // Do NOT set this.value here — it triggers unnecessary Stencil re-renders
-            // and the Watch cycle. The parent is the source of truth for the value prop.
+            this.echo.markEmitted(out);
+            // No se asigna this.value: dispararía re-renders y el Watch. El padre es la fuente de verdad.
             this.coInput.emit(out);
-            // In readonly mode there's no blur cycle, so commit immediately
-            // (e.g. task-list checkbox toggled by onReadOnlyChecked).
+            // En readonly no hay ciclo de blur: se confirma en el acto (p. ej. checkbox de task-list).
             if (this.readonly)
                 this.coChange.emit(out);
         };
@@ -123,7 +117,7 @@ export class CoRichTextEditor {
         this.editor = this.rt.createEditor({
             preset: this.preset,
             element: this.contentEl,
-            content: this.parseValue(this.value),
+            content: parseEditorValue(this.value),
             editable: !this.disabled && !this.readonly,
             placeholder: this.placeholder,
             maxLength: this.maxLength,
@@ -176,7 +170,7 @@ export class CoRichTextEditor {
                 this.suppressBubble(!!open);
             });
         }
-        this.lastEmittedJson = (_b = this.value) !== null && _b !== void 0 ? _b : null;
+        this.echo.seed((_b = this.value) !== null && _b !== void 0 ? _b : null);
         this.ready = true;
         this.refreshCharCount();
         this.syncToolbar();
@@ -218,24 +212,17 @@ export class CoRichTextEditor {
         if (!this.editor || this.applyingExternal)
             return;
         const incoming = next !== null && next !== void 0 ? next : null;
-        // Skip if this value matches what we last emitted (JSON or HTML form).
-        // This prevents the destructive feedback loop where the parent sends
-        // back our own output and setContent resets the editor on every keystroke.
-        if (incoming === this.lastEmittedJson || incoming === this.lastEmittedHtml)
+        // El padre suele devolver nuestro propio output (JSON o HTML): re-aplicarlo
+        // reinicia el editor en cada tecla.
+        if (this.echo.isEcho(incoming))
             return;
         this.applyingExternal = true;
         try {
-            if (incoming === '' || incoming === null) {
-                this.editor.commands.clearContent(false);
-            }
-            else {
-                this.editor.commands.setContent(this.parseValue(next), { emitUpdate: false });
-            }
+            applyExternalValue(this.editor, incoming);
         }
         finally {
             this.applyingExternal = false;
-            this.lastEmittedJson = incoming;
-            this.lastEmittedHtml = '';
+            this.echo.seed(incoming);
             this.refreshCharCount();
         }
     }
@@ -280,27 +267,7 @@ export class CoRichTextEditor {
         return (_a = f === null || f === void 0 ? void 0 : f.image) !== null && _a !== void 0 ? _a : this.preset === 'document';
     }
     get parsedFeatures() {
-        if (!this.features)
-            return undefined;
-        if (typeof this.features === 'string') {
-            try {
-                return JSON.parse(this.features);
-            }
-            catch (_a) {
-                return undefined;
-            }
-        }
-        return this.features;
-    }
-    parseValue(v) {
-        if (!v)
-            return '';
-        try {
-            return JSON.parse(v);
-        }
-        catch (_a) {
-            return v; // tolerate an HTML string
-        }
+        return parseFeatures(this.features);
     }
     sanitizeHtml(html) {
         // Con las MISMAS features que cargaron el schema: sin ellas, un <img> con
@@ -309,12 +276,7 @@ export class CoRichTextEditor {
         return this.rt.sanitize(html, this.preset, this.parsedFeatures);
     }
     buildOutput(editor) {
-        const empty = editor.isEmpty;
-        return {
-            json: empty ? null : editor.getJSON(),
-            html: empty ? '' : this.sanitizeHtml(editor.getHTML()),
-            text: editor.getText(),
-        };
+        return buildOutput(editor, (html) => this.sanitizeHtml(html));
     }
     /** Lock the bubble position so floating-ui doesn't reposition it. */
     lockBubblePosition(durationMs = 1000) {
@@ -423,12 +385,7 @@ export class CoRichTextEditor {
         }
     }
     syncToolbar() {
-        if (this.toolbarEl && this.editor && this.toolbarEl.editor !== this.editor) {
-            this.toolbarEl.editor = this.editor;
-        }
-        if (this.toolbarEl) {
-            this.toolbarEl.imageUpload = this.imageUpload;
-        }
+        syncToolbarEditor(this.toolbarEl, this.editor, this.imageUpload);
     }
     get resolvedToolbar() {
         if (this.toolbar !== 'auto')
@@ -1986,32 +1943,8 @@ export class CoRichTextEditor {
      * from state and write the attribute imperatively to the container.
      */
     syncImageLayouts() {
-        if (!this.editor)
-            return;
-        const view = this.editor.view;
-        this.editor.state.doc.descendants((node, pos) => {
-            var _a;
-            if (node.type.name !== 'image')
-                return true;
-            const dom = view.nodeDOM(pos);
-            const c = (((_a = dom === null || dom === void 0 ? void 0 : dom.closest) === null || _a === void 0 ? void 0 : _a.call(dom, '[data-resize-container]')) || dom);
-            if (!c)
-                return true;
-            const layout = node.attrs.imageLayout || 'inline';
-            c.dataset.imageLayout = layout;
-            // Neutralise any absolute positioning baked by the old fixed-page model.
-            c.style.position = '';
-            c.style.left = '';
-            c.style.top = '';
-            c.style.zIndex = '';
-            // The resize NodeView pins `display: inline-flex` INLINE on the container, which
-            // beats the stylesheet's `display: block` for `center` / `full-width`: the editor
-            // showed those images inline-left while the viewer (and the sent email) centred
-            // them (2026-09-17). Clear it for block layouts so the CSS rule can apply; the
-            // inline value is restored for flow layouts so the resize handles keep working.
-            c.style.display = layout === 'center' || layout === 'full-width' ? '' : 'inline-flex';
-            return true;
-        });
+        if (this.editor)
+            syncImageLayouts(this.editor);
     }
     /** Reposition only the layout bar (used during drag for performance). */
     updateImageLayoutBarPosition() {
@@ -2052,11 +1985,11 @@ export class CoRichTextEditor {
         const showToolbar = this.resolvedToolbar !== 'none' && !this.readonly && !this.disabled;
         const showCount = this.showCharacterCount || this.maxLength != null;
         const bottom = this.toolbarPosition === 'bottom';
-        const toolbar = showToolbar && (h("co-rich-text-toolbar", { key: '0df30a57a843cbcd967ffd254ae0e54bee448902', class: "co-rich-text-editor__toolbar", part: "toolbar", variant: this.resolvedToolbar, position: this.toolbarPosition, disabled: this.disabled || this.readonly, locale: this.locale, attachmentsEnabled: this.attachmentsEnabled, attachmentAccept: this.attachmentAccept, onCoAttachmentsSelected: (e) => {
+        const toolbar = showToolbar && (h("co-rich-text-toolbar", { key: '8d13314a23cc3b290d5a2ac8a2ef1b68f55b9574', class: "co-rich-text-editor__toolbar", part: "toolbar", variant: this.resolvedToolbar, position: this.toolbarPosition, disabled: this.disabled || this.readonly, locale: this.locale, attachmentsEnabled: this.attachmentsEnabled, attachmentAccept: this.attachmentAccept, onCoAttachmentsSelected: (e) => {
                 e.stopPropagation();
                 this.coAttachmentsSelected.emit(e.detail);
             }, ref: (el) => (this.toolbarEl = el) }));
-        return (h("div", { key: '03be9df0d50d00a3cf889b3404c4f347626aa27c', class: {
+        return (h("div", { key: '65401af712fa511cf2f30761d4b2ff753dc75a6f', class: {
                 'co-rich-text-editor': true,
                 'co-rich-text-editor--focused': this.hasFocus,
                 'co-rich-text-editor--disabled': this.disabled,
@@ -2065,7 +1998,7 @@ export class CoRichTextEditor {
                 [`co-rich-text-editor--${this.status}`]: this.status !== 'default',
                 'co-rich-text-editor--flat': this.variant === 'flat',
                 'co-rich-text-editor--toolbar-bottom': bottom,
-            }, part: "wrapper" }, (this.label || this.secondaryLabel) && (h("div", { key: 'ae732219465a376af19e771e63589c955be37c4b', class: "co-rich-text-editor__labels" }, this.label && h("label", { key: 'd316724c4f4bcbf55adf582b8ad40c6c45fba407', class: "co-rich-text-editor__label", part: "label" }, this.label), this.secondaryLabel && (h("span", { key: '3cca63f6dfa2335dcd7122eb734205d4fd86a90f', class: "co-rich-text-editor__secondary-label" }, this.secondaryLabel)))), h("div", { key: '620bd101dd94684f7b2d533401717eeb7421593c', class: "co-rich-text-editor__frame" }, !bottom && toolbar, h("div", { key: 'a20f163022dd1c6e23dfc222786ddf0fc6f9b3ac', class: "co-rich-text-editor__box" }, h("div", { key: 'd678e095ae36610895cb466c1a15c722b46d4483', class: "co-rte-content", part: "content", role: "textbox", "aria-multiline": "true", "aria-label": this.label, "aria-required": this.required ? 'true' : undefined, "aria-invalid": this.status === 'error' ? 'true' : undefined, ref: (el) => (this.contentEl = el) })), h("slot", { key: '62127cb0a34e7f43ceadcb20ef724aba0524fa69', name: "content-end" }), bottom && (h("div", { key: '99d574e7cbb2a115a243288b770cb03f1892ff93', class: "co-rich-text-editor__toolbar-row", part: "toolbar-row" }, toolbar, h("slot", { key: 'b9b971930ddda8d118c8b6d204fad8d41d25468e', name: "toolbar-end" })))), h("div", { key: 'caafa3f153192eee6efa7679dafa376dea69b150', class: "co-rich-text-editor__footer" }, this.helperText && (h("div", { key: '8d2ab21ababab2c14c912f8ffd6945001fca62f7', class: `co-rich-text-editor__helper co-rich-text-editor__helper--${this.status}`, part: "helper" }, h("co-icon", { key: 'b60df4c320b9356a87df39179c75360f91e858bf', name: this.helperIcon, size: 14 }), h("span", { key: 'd56108257c9bba2332e434d6240f4f387e2411f6' }, this.helperText))), showCount && (h("span", { key: '7973c2996e24ec991115fe4932915a9aefc1b495', class: "co-rich-text-editor__count", ref: (el) => (this.charCountEl = el) }, this.charCount, this.maxLength != null ? ` / ${this.maxLength}` : '')))));
+            }, part: "wrapper" }, (this.label || this.secondaryLabel) && (h("div", { key: '012dc50c67d9ca53896a8ffc329a32909685994e', class: "co-rich-text-editor__labels" }, this.label && h("label", { key: '23b54b1f9556bc1e6ad1a3b3dd0ed9e26a5e7500', class: "co-rich-text-editor__label", part: "label" }, this.label), this.secondaryLabel && (h("span", { key: '534941598c650f1262f046c16a3f30817b0c2d88', class: "co-rich-text-editor__secondary-label" }, this.secondaryLabel)))), h("div", { key: 'f14dbd62014625638da4b209d6f083d3ca16e184', class: "co-rich-text-editor__frame" }, !bottom && toolbar, h("div", { key: '98d5e7aa68b73a51da6a74512ac8a08e6dbb9df0', class: "co-rich-text-editor__box" }, h("div", { key: '16b7aaa9773290a58122595ad188ab6f9db3354b', class: "co-rte-content", part: "content", role: "textbox", "aria-multiline": "true", "aria-label": this.label, "aria-required": this.required ? 'true' : undefined, "aria-invalid": this.status === 'error' ? 'true' : undefined, ref: (el) => (this.contentEl = el) })), h("slot", { key: '0f90fc0c30ee03ec2023f229348debab6e734ade', name: "content-end" }), bottom && (h("div", { key: '68d646dbe5d37c7ebebe105b8ada3584684340e1', class: "co-rich-text-editor__toolbar-row", part: "toolbar-row" }, toolbar, h("slot", { key: '48ec89359f8a6957bf0451384602cabd37a99019', name: "toolbar-end" })))), h("div", { key: '932083b9360e7abbede76a10a3a7eeec1dc88a84', class: "co-rich-text-editor__footer" }, this.helperText && (h("div", { key: '6be15e0e151e9548e2d5a964f864992687113393', class: `co-rich-text-editor__helper co-rich-text-editor__helper--${this.status}`, part: "helper" }, h("co-icon", { key: '456f73c7afec3eb8bd88dc13c2b6942021d31b78', name: this.helperIcon, size: 14 }), h("span", { key: '666d8db7d19a1559f392b2cfea76c393080c2d98' }, this.helperText))), showCount && (h("span", { key: '2d561825e0bc7790407750de52242c87b1515e8c', class: "co-rich-text-editor__count", ref: (el) => (this.charCountEl = el) }, this.charCount, this.maxLength != null ? ` / ${this.maxLength}` : '')))));
     }
     static get is() { return "co-rich-text-editor"; }
     static get originalStyleUrls() {
@@ -2105,7 +2038,7 @@ export class CoRichTextEditor {
                 "mutable": false,
                 "complexType": {
                     "original": "RichTextPreset",
-                    "resolved": "\"block-email\" | \"comment\" | \"document\" | \"email\" | \"notes\" | \"task\"",
+                    "resolved": "\"block-email\" | \"comment\" | \"document\" | \"email\" | \"notes\" | \"print\" | \"print-header\" | \"task\"",
                     "references": {
                         "RichTextPreset": {
                             "location": "import",
@@ -2368,7 +2301,7 @@ export class CoRichTextEditor {
                 "mutable": false,
                 "complexType": {
                     "original": "ToolbarVariant",
-                    "resolved": "\"auto\" | \"basic\" | \"compact\" | \"compact-assets\" | \"email\" | \"full\" | \"none\" | \"notes\"",
+                    "resolved": "\"auto\" | \"basic\" | \"compact\" | \"compact-assets\" | \"document\" | \"email\" | \"full\" | \"none\" | \"notes\"",
                     "references": {
                         "ToolbarVariant": {
                             "location": "import",

package/dist/collection/components/co-rich-text-toolbar/co-rich-text-toolbar.css

@@ -895,3 +895,15 @@
   margin-top: 0;
   margin-bottom: var(--co-spacing-xs, 4px);
 }
+
+/* Botones del host (extraItems): llevan texto visible, así que no son icon-only. */
+.co-rich-text-toolbar__btn--extra {
+  width: auto;
+  gap: var(--co-spacing-xs);
+  padding-inline: var(--co-spacing-sm2);
+}
+
+.co-rich-text-toolbar__extra-label {
+  font-size: var(--co-font-size-13);
+  white-space: nowrap;
+}

package/dist/collection/components/co-rich-text-toolbar/co-rich-text-toolbar.js

@@ -23,6 +23,8 @@ export class CoRichTextToolbar {
         /** Shows the attachment button (compact-assets variant). The editor never
          *  owns the attachment list — it only emits the picked files. */
         this.attachmentsEnabled = false;
+        /** Muestra «Encabezado» (variante document). co-document-editor lo apaga mientras se edita la banda. */
+        this.documentHeaderEnabled = false;
         this.items = [];
         /** Bumped on every editor transaction to refresh active state. */
         this.tick = 0;
@@ -176,10 +178,18 @@ export class CoRichTextToolbar {
                         chain.outdent().run();
                     }
                     break;
+                case 'signature':
+                    chain.insertSignatureSlot().run();
+                    break;
+                case 'documentHeader':
+                    // El editor de documento abre la banda: la barra solo avisa.
+                    this.coAction.emit({ action: 'documentHeader' });
+                    return;
                 case 'attachment':
                     this.triggerAttachmentFileUpload();
                     return; // no editor command — the host owns the files
                 case 'link':
+                case 'field':
                 case 'image':
                 case 'youtube':
                 case 'iframe':
@@ -226,6 +236,7 @@ export class CoRichTextToolbar {
             addRowBefore: s.addRowBefore, deleteRow: s.deleteRow,
             deleteTable: s.deleteTable, mergeCells: s.mergeCells,
             splitCell: s.splitCell, toggleHeaderRow: s.headerRow,
+            field: s.field, signature: s.signature, documentHeader: s.documentHeader,
         };
         return (_a = map[item.action]) !== null && _a !== void 0 ? _a : item.label;
     }
@@ -244,6 +255,8 @@ export class CoRichTextToolbar {
                 return s.subtitle;
             if (level === 3)
                 return s.heading3;
+            if (level === 4)
+                return s.heading4;
         }
         if (opt.action === 'bulletStyle') {
             const m = { disc: s.disc, circle: s.circle, square: s.square };
@@ -280,6 +293,9 @@ export class CoRichTextToolbar {
         document.addEventListener('click', this.handleDocumentClick, true);
     }
     componentWillLoad() {
+        // H3: el harness de specs no aplica los defaults de clase de @State; en
+        // producción es neutro (mismo valor inicial).
+        this.tableContextItems = [];
         this.items = this.resolveItems(this.variant);
         this.colorPalette = COLOR_PALETTE;
         this._tableContextItems = TABLE_CONTEXT_ITEMS;
@@ -290,6 +306,23 @@ export class CoRichTextToolbar {
     onAttachmentsEnabledChange() {
         this.items = this.resolveItems(this.variant);
     }
+    onDocumentHeaderEnabledChange() {
+        this.items = this.resolveItems(this.variant);
+    }
+    get parsedExtraItems() {
+        const raw = this.extraItems;
+        if (!raw)
+            return [];
+        if (typeof raw !== 'string')
+            return raw;
+        try {
+            const v = JSON.parse(raw);
+            return Array.isArray(v) ? v : [];
+        }
+        catch (_a) {
+            return [];
+        }
+    }
     onEditorChange(next, prev) {
         prev === null || prev === void 0 ? void 0 : prev.off('transaction', this.onTransaction);
         next === null || next === void 0 ? void 0 : next.on('transaction', this.onTransaction);
@@ -320,13 +353,16 @@ export class CoRichTextToolbar {
             }
         };
         const kept = base.filter((entry) => {
+            var _a;
             if (this.isSeparator(entry))
                 return true;
             const action = entry.action;
             // attachment has no editor command — visibility is host opt-in.
             if (action === 'attachment')
                 return this.attachmentsEnabled;
-            const cmd = CoRichTextToolbar.ITEM_COMMAND[action];
+            if (action === 'documentHeader')
+                return this.documentHeaderEnabled;
+            const cmd = (_a = CoRichTextToolbar.ITEM_COMMAND[action]) !== null && _a !== void 0 ? _a : (variant === 'document' ? CoRichTextToolbar.DOCUMENT_ITEM_COMMAND[action] : undefined);
             return cmd ? available(cmd) : true;
         });
         // Drop separators that ended up leading, trailing, or doubled-up.
@@ -451,6 +487,9 @@ export class CoRichTextToolbar {
             case 'link':
                 chain.setLink({ href: url }).run();
                 break;
+            case 'field':
+                chain.insertField(url).run();
+                break;
             case 'image':
                 chain.setImage({ src: url }).run();
                 break;
@@ -596,6 +635,7 @@ export class CoRichTextToolbar {
         }
     }
     getDropdownLabel(item) {
+        var _a, _b;
         if (!this.editor)
             return null;
         const s = this.s;
@@ -606,12 +646,15 @@ export class CoRichTextToolbar {
                 return s.subtitle;
             if (this.editor.isActive('heading', { level: 3 }))
                 return s.headingAbbr3;
+            if (this.editor.isActive('heading', { level: 4 }))
+                return s.headingAbbr4;
             return s.normal;
         }
         if (item.action === 'fontSize') {
-            const attrs = this.editor.getAttributes('textStyle');
-            const fs = attrs === null || attrs === void 0 ? void 0 : attrs.fontSize;
-            return fs ? fs.replace('px', '') : '16';
+            // Preset print: el tamaño es la marca `printFontSize` (forma de V1); el resto lo guarda en textStyle.
+            const printSize = (_a = this.editor.getAttributes('printFontSize')) === null || _a === void 0 ? void 0 : _a.size;
+            const fs = printSize !== null && printSize !== void 0 ? printSize : (_b = this.editor.getAttributes('textStyle')) === null || _b === void 0 ? void 0 : _b.fontSize;
+            return fs ? String(fs).replace('px', '') : '16';
         }
         if (item.action === 'fontFamily') {
             const attrs = this.editor.getAttributes('textStyle');
@@ -773,16 +816,19 @@ export class CoRichTextToolbar {
         const isLink = item.action === 'link';
         const isIframe = item.action === 'iframe';
         const hasExisting = (isLink && ((_a = this.editor) === null || _a === void 0 ? void 0 : _a.isActive('link'))) || (isIframe && ((_b = this.editor) === null || _b === void 0 ? void 0 : _b.isActive('iframe')));
-        const placeholder = item.action === 'iframe'
-            ? this.s.iframeUrlPlaceholder
-            : item.action === 'link'
-                ? 'https://...'
-                : this.s.youtubeUrlPlaceholder;
+        const isField = item.action === 'field';
+        const placeholder = isField
+            ? this.s.fieldNamePlaceholder
+            : item.action === 'iframe'
+                ? this.s.iframeUrlPlaceholder
+                : item.action === 'link'
+                    ? 'https://...'
+                    : this.s.youtubeUrlPlaceholder;
         return (h("div", { class: "co-rich-text-toolbar__popover", onMouseDown: (e) => {
                 if (e.target.tagName !== 'INPUT')
                     e.preventDefault();
                 e.stopPropagation();
-            } }, h("input", { type: "url", class: "co-rich-text-toolbar__popover-input", placeholder: placeholder, value: this.popoverInput, onInput: (e) => { this.popoverInput = e.target.value; }, onKeyDown: (e) => {
+            } }, h("input", { type: isField ? 'text' : 'url', class: "co-rich-text-toolbar__popover-input", placeholder: placeholder, "aria-label": placeholder, value: this.popoverInput, onInput: (e) => { this.popoverInput = e.target.value; }, onKeyDown: (e) => {
                 if (e.key === 'Enter')
                     this.submitPopover(item.action);
                 if (e.key === 'Escape') {
@@ -1097,12 +1143,9 @@ export class CoRichTextToolbar {
             return null;
         // reference tick so Stencil re-renders on selection changes
         void this.tick;
-        return (h("div", { class: "co-rich-text-toolbar", role: "toolbar", "aria-label": "Formatting", part: "toolbar" }, this.items.map((entry) => {
-            if (this.isSeparator(entry)) {
-                return h("span", { class: "co-rich-text-toolbar__sep" });
-            }
-            return this.renderButton(entry);
-        })));
+        const extras = this.parsedExtraItems;
+        const renderEntry = (entry) => this.isSeparator(entry) ? h("span", { class: "co-rich-text-toolbar__sep" }) : this.renderButton(entry);
+        return (h("div", { class: "co-rich-text-toolbar", role: "toolbar", "aria-label": "Formatting", part: "toolbar" }, this.items.map(renderEntry), this.variant === 'document' && this.tableContextItems.map(renderEntry), extras.length > 0 && h("span", { class: "co-rich-text-toolbar__sep" }), extras.map((x) => (h("button", { type: "button", key: `extra-${x.id}`, class: "co-rich-text-toolbar__btn co-rich-text-toolbar__btn--extra", part: "button", disabled: this.disabled, onMouseDown: (e) => e.preventDefault(), onClick: () => this.coAction.emit({ action: x.id, payload: { extra: true } }) }, x.icon && h("co-icon", { name: x.icon, size: 18 }), h("span", { class: "co-rich-text-toolbar__extra-label" }, x.label))))));
     }
     static get is() { return "co-rich-text-toolbar"; }
     static get encapsulation() { return "shadow"; }
@@ -1146,8 +1189,8 @@ export class CoRichTextToolbar {
                 "type": "string",
                 "mutable": false,
                 "complexType": {
-                    "original": "'none' | 'compact' | 'compact-assets' | 'basic' | 'notes' | 'email' | 'full'",
-                    "resolved": "\"basic\" | \"compact\" | \"compact-assets\" | \"email\" | \"full\" | \"none\" | \"notes\"",
+                    "original": "'none' | 'compact' | 'compact-assets' | 'basic' | 'notes' | 'email' | 'full' | 'document'",
+                    "resolved": "\"basic\" | \"compact\" | \"compact-assets\" | \"document\" | \"email\" | \"full\" | \"none\" | \"notes\"",
                     "references": {}
                 },
                 "required": false,
@@ -1286,6 +1329,52 @@ export class CoRichTextToolbar {
                 "setter": false,
                 "reflect": false,
                 "attribute": "attachment-accept"
+            },
+            "documentHeaderEnabled": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Muestra \u00ABEncabezado\u00BB (variante document). co-document-editor lo apaga mientras se edita la banda."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "document-header-enabled",
+                "defaultValue": "false"
+            },
+            "extraItems": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "ToolbarExtraItem[] | string",
+                    "resolved": "ToolbarExtraItem[] | string | undefined",
+                    "references": {
+                        "ToolbarExtraItem": {
+                            "location": "import",
+                            "path": "@prolibu-suite/cobalt-rich-text",
+                            "id": "../rich-text/dist/index.d.ts::ToolbarExtraItem",
+                            "referenceLocation": "ToolbarExtraItem"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Botones del host al final de la barra (propiedad JS o JSON): `[{ id, label, icon? }]`.\nSu clic emite `coAction` con `{ action: id, payload: { extra: true } }` y no toca el editor."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "extra-items"
             }
         };
     }
@@ -1369,6 +1458,9 @@ export class CoRichTextToolbar {
             }, {
                 "propName": "attachmentsEnabled",
                 "methodName": "onAttachmentsEnabledChange"
+            }, {
+                "propName": "documentHeaderEnabled",
+                "methodName": "onDocumentHeaderEnabledChange"
             }, {
                 "propName": "editor",
                 "methodName": "onEditorChange"
@@ -1404,3 +1496,16 @@ CoRichTextToolbar.ITEM_COMMAND = {
     bulletListMenu: 'toggleBulletList',
     orderedListMenu: 'toggleOrderedList',
 };
+/**
+ * Filtro por schema SOLO de la variante `document` (co-document-editor): el editor
+ * del encabezado (preset print-header) no tiene links, títulos, listas ni firmas.
+ * Las demás variantes resuelven exactamente como antes (spec: el RTE no cambia).
+ */
+CoRichTextToolbar.DOCUMENT_ITEM_COMMAND = {
+    link: 'setLink',
+    headingStyle: 'toggleHeading',
+    bulletList: 'toggleBulletList',
+    orderedList: 'toggleOrderedList',
+    field: 'insertField',
+    signature: 'insertSignatureSlot',
+};

package/dist/collection/components/co-rich-text-viewer/co-rich-text-viewer.js

@@ -20,6 +20,13 @@ const ALLOWED_TAGS = {
     email: ['p', 'br', 'strong', 'em', 'a', 'span', 'u', 's', 'code', 'ul', 'ol', 'li', 'blockquote', 'h2', 'h3', 'div', 'img'],
     document: ['p', 'br', 'strong', 'em', 'a', 'span', 'u', 's', 'code', 'ul', 'ol', 'li', 'blockquote', 'h1', 'h2', 'h3', 'h4', 'hr', 'div', 'mark', 'img', 'table', 'thead', 'tbody', 'tr', 'th', 'td', 'iframe'],
     'block-email': ['p', 'br', 'strong', 'em', 'a', 'span', 'u', 's', 'code', 'ul', 'ol', 'li', 'blockquote', 'h2', 'h3', 'div', 'img'],
+    // Espejo de SANITIZE_CONFIGS.print / 'print-header' (rich-text/sanitizer.ts).
+    // Solo TAGS: la lista de atributos del viewer (sin class, containerstyle,
+    // wrapperstyle ni data-*) no se amplió, así que un HTML de impresión pintado
+    // acá pierde campos, firmas y modos de imagen. Nadie lo consume hoy (H14);
+    // para pintarlo fiel hay que completar también los atributos.
+    print: ['p', 'br', 'strong', 'em', 's', 'code', 'a', 'span', 'mark', 'h1', 'h2', 'h3', 'h4', 'ul', 'ol', 'li', 'blockquote', 'pre', 'hr', 'img', 'div', 'table', 'colgroup', 'col', 'thead', 'tbody', 'tr', 'th', 'td'],
+    'print-header': ['p', 'br', 'strong', 'em', 's', 'code', 'span', 'mark', 'img'],
 };
 /** iframes are permitted only with an https: source (blocks javascript:/data:/http:). */
 const SAFE_IFRAME_SRC_RE = /^https:\/\/[^\s"'<>]+$/i;
@@ -198,7 +205,7 @@ export class CoRichTextViewer {
                 "mutable": false,
                 "complexType": {
                     "original": "RichTextPreset",
-                    "resolved": "\"block-email\" | \"comment\" | \"document\" | \"email\" | \"notes\" | \"task\"",
+                    "resolved": "\"block-email\" | \"comment\" | \"document\" | \"email\" | \"notes\" | \"print\" | \"print-header\" | \"task\"",
                     "references": {
                         "RichTextPreset": {
                             "location": "import",

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

@@ -13,11 +13,11 @@ export class CoRow {
         this.size = 'sm';
     }
     render() {
-        return (h("div", { key: '415d9d352b0129f2e05182f0a928843fdb6b6321', class: {
+        return (h("div", { key: 'd82c1b834c4c6825da02a0112d78a8e5a6d12219', class: {
                 'co-row': true,
                 [`co-row--${this.position}`]: true,
                 [`co-row--${this.size}`]: true,
-            }, part: "row" }, h("div", { key: 'af23c875f523e15a4891a7897ae76853d358f692', class: "co-row__prefix" }, h("slot", { key: 'fd3a54d31942ecd10e889f2691c1f6e2d94d2cf3', name: "prefix" })), h("div", { key: '884cad8bde957327b7814b03084da51bfeedb1e4', class: "co-row__content" }, h("slot", { key: 'aedd965fd4ef93597b02e5714fec0b19837544c8' })), h("div", { key: '228cb0a116920be271cc8969591cbe0c1ca8f9b9', class: "co-row__suffix" }, h("slot", { key: 'dee6339445cfe8fdb7a1adf82d795c16e7a16be3', name: "suffix" }))));
+            }, part: "row" }, h("div", { key: '33ae6da740cd01f7b81ed2b76cdba355a9e3e3d2', class: "co-row__prefix" }, h("slot", { key: '9f646baf5b45b931042504b18bc683332f000f6a', name: "prefix" })), h("div", { key: '3c5648a7b0b326ad4c5a547a4ce6f158b85150ec', class: "co-row__content" }, h("slot", { key: '56384849d661312ffd659de530ffb4735fb943c2' })), h("div", { key: 'bf8d524a890d724db01d3216d9128bb00aa9011d', class: "co-row__suffix" }, h("slot", { key: '41aa4471ed0d20f925944e2ef850c0b8f8ec8607', name: "suffix" }))));
     }
     static get is() { return "co-row"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/co-segmented-bar/co-segmented-bar.js

@@ -43,13 +43,13 @@ export class CoSegmentedBar {
     render() {
         const segments = this.parsedSegments;
         const total = this.total > 0 ? this.total : 100;
-        return (h("div", { key: '3f4538a2c701799531b586e0b039fb952e5d11ba', class: "co-segmented-bar", part: "segmented-bar" }, h("div", { key: '45c3baf87d073835bc9954ba5ab9c847e5da7fa8', class: {
+        return (h("div", { key: 'f7301a9d7e31e6b3fbf6037fb2425b1701af171e', class: "co-segmented-bar", part: "segmented-bar" }, h("div", { key: '22f3063c1db26411e6c0b5e18f1d9249fcf05ca5', class: {
                 'co-segmented-bar__track': true,
                 [`co-segmented-bar__track--radius-${this.radius}`]: true,
             }, part: "track", style: { height: `${this.thickness}px`, background: this.trackColor } }, segments.map((seg, i) => (h("span", { key: i, class: "co-segmented-bar__segment", part: "segment", title: seg.label, style: {
                 width: `${(seg.value / total) * 100}%`,
                 background: seg.color,
-            } })))), h("slot", { key: 'a6e865f76ff83ff47eb459721c1958f0b431f02d', name: "legend" })));
+            } })))), h("slot", { key: '3eb6275c7f248d3f93d24f5e44c1c30e6eb4f019', name: "legend" })));
     }
     static get is() { return "co-segmented-bar"; }
     static get encapsulation() { return "shadow"; }
@@ -154,7 +154,7 @@ export class CoSegmentedBar {
                     "references": {
                         "CoSegment": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-0.10.3/packages/core/src/components/co-segmented-bar/co-segmented-bar.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-segmented-bar/co-segmented-bar.tsx",
                             "id": "src/components/co-segmented-bar/co-segmented-bar.tsx::CoSegment"
                         }
                     }