@harbour-enterprises/superdoc 1.3.0-next.6 → 1.3.0-next.8

package/dist/chunks/{index-CEDW4NYV.cjs → index-B2Aynj2f.cjs}

@@ -1,6 +1,6 @@
 "use strict";
-const index = require("./index-C4RVDXKX.cjs");
-require("./SuperConverter-BdOf8skU.cjs");
+const index = require("./index-DzCJy9Bf.cjs");
+require("./SuperConverter-d7nvQrVD.cjs");
 const blankDocx = require("./blank-docx-DfW3Eeh2.cjs");
 const eventemitter3 = require("./eventemitter3-BQuRcMPI.cjs");
 const provider = require("@hocuspocus/provider");
@@ -7461,7 +7461,7 @@ const _sfc_main = {
   __name: "SuperDoc",
   emits: ["selection-update"],
   setup(__props, { emit: __emit }) {
-    const PdfViewer = vue.defineAsyncComponent(() => Promise.resolve().then(() => require("./PdfViewer-0pJuKd1x.cjs")));
+    const PdfViewer = vue.defineAsyncComponent(() => Promise.resolve().then(() => require("./PdfViewer-fF1B6H-9.cjs")));
     const superdocStore = useSuperdocStore();
     const commentsStore = useCommentsStore();
     const {
@@ -8367,7 +8367,7 @@ class SuperDoc extends eventemitter3.EventEmitter {
     this.config.colors = shuffleArray(this.config.colors);
     this.userColorMap = /* @__PURE__ */ new Map();
     this.colorIndex = 0;
-    this.version = "1.3.0-next.6";
+    this.version = "1.3.0-next.8";
     this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
     this.superdocId = config.superdocId || uuid.v4();
     this.colors = this.config.colors;

package/dist/chunks/{index-CqbujvlE.es.js → index-DoZiv8EQ.es.js}

@@ -1,6 +1,6 @@
 import { B as Buffer$2 } from "./jszip-B1fkPkPJ.es.js";
 import { t as twipsToInches, i as inchesToTwips, p as ptToTwips, l as linesToTwips, a as twipsToLines, b as pixelsToTwips, h as halfPointToPoints, c as twipsToPixels$2, d as convertSizeToCSS, e as inchesToPixels } from "./helpers-C8e9wR5l.es.js";
-import { g as generateDocxRandomId, T as TextSelection$1, o as objectIncludes, w as wrapTextsInRuns, D as DOMParser$1, c as createDocFromMarkdown, a as createDocFromHTML, b as chainableEditorState, d as convertMarkdownToHTML, f as findParentNode, e as findParentNodeClosestToPos, h as generateRandom32BitHex, i as generateRandomSigned32BitIntStrId, P as PluginKey, j as Plugin, M as Mapping, N as NodeSelection, k as Selection, l as Slice, m as DOMSerializer, F as Fragment, n as Mark$1, p as dropPoint, A as AllSelection, q as Schema$1, s as canSplit, t as resolveRunProperties, u as encodeMarksFromRPr, v as liftTarget, x as canJoin, y as joinPoint, z as replaceStep$1, R as ReplaceAroundStep$1, B as htmlHandler, C as ReplaceStep, E as getResolvedParagraphProperties, G as changeListLevel, H as isList$1, I as updateNumberingProperties, L as ListHelpers, J as inputRulesPlugin, K as TrackDeleteMarkName$1, O as TrackInsertMarkName$1, Q as TrackFormatMarkName$1, U as AddMarkStep, V as RemoveMarkStep, W as CommandService, S as SuperConverter, X as EditorState, Y as unflattenListsInHtml, Z as SelectionRange, _ as Transform, $ as createOoxmlResolver, a0 as translator, a1 as translator$1, a2 as resolveDocxFontFamily, a3 as _getReferencedTableStyles, a4 as decodeRPrFromMarks, a5 as calculateResolvedParagraphProperties, a6 as encodeCSSFromPPr, a7 as encodeCSSFromRPr, a8 as generateOrderedListIndex, a9 as docxNumberingHelpers, aa as InputRule, ab as insertNewRelationship, ac as kebabCase$1, ad as getUnderlineCssString } from "./SuperConverter-S9b1fFw5.es.js";
+import { g as generateDocxRandomId, T as TextSelection$1, o as objectIncludes, w as wrapTextsInRuns, D as DOMParser$1, c as createDocFromMarkdown, a as createDocFromHTML, b as chainableEditorState, d as convertMarkdownToHTML, f as findParentNode, e as findParentNodeClosestToPos, h as generateRandom32BitHex, i as generateRandomSigned32BitIntStrId, P as PluginKey, j as Plugin, M as Mapping, N as NodeSelection, k as Selection, l as Slice, m as DOMSerializer, F as Fragment, n as Mark$1, p as dropPoint, A as AllSelection, q as Schema$1, s as canSplit, t as resolveRunProperties, u as encodeMarksFromRPr, v as liftTarget, x as canJoin, y as joinPoint, z as replaceStep$1, R as ReplaceAroundStep$1, B as htmlHandler, C as ReplaceStep, E as getResolvedParagraphProperties, G as changeListLevel, H as isList$1, I as updateNumberingProperties, L as ListHelpers, J as inputRulesPlugin, K as TrackDeleteMarkName$1, O as TrackInsertMarkName$1, Q as TrackFormatMarkName$1, U as AddMarkStep, V as RemoveMarkStep, W as CommandService, S as SuperConverter, X as EditorState, Y as unflattenListsInHtml, Z as SelectionRange, _ as Transform, $ as createOoxmlResolver, a0 as translator, a1 as translator$1, a2 as resolveDocxFontFamily, a3 as _getReferencedTableStyles, a4 as decodeRPrFromMarks, a5 as calculateResolvedParagraphProperties, a6 as encodeCSSFromPPr, a7 as encodeCSSFromRPr, a8 as generateOrderedListIndex, a9 as docxNumberingHelpers, aa as InputRule, ab as insertNewRelationship, ac as kebabCase$1, ad as getUnderlineCssString } from "./SuperConverter-DwLhA2mM.es.js";
 import { p as process$1, r as ref, C as global$1, c as computed, E as createElementBlock, F as Fragment$1, S as renderList, O as withModifiers, G as openBlock, P as normalizeClass, M as createCommentVNode, H as toDisplayString, K as createBaseVNode, U as createApp, f as onMounted, X as onUnmounted, R as withDirectives, v as unref, Y as vModelText, y as nextTick, L as normalizeStyle, u as watch, Z as withKeys, _ as createTextVNode, I as createVNode, h, $ as readonly, s as getCurrentInstance, o as onBeforeUnmount, j as reactive, b as onBeforeMount, i as inject, a0 as onActivated, a1 as onDeactivated, a2 as Comment, d as defineComponent, a as provide, g as Teleport, t as toRef, a3 as renderSlot, a4 as isVNode, D as shallowRef, w as watchEffect, T as Transition, a5 as mergeProps, a6 as vShow, a7 as cloneVNode, a8 as Text$2, m as markRaw, N as createBlock, J as withCtx, a9 as useCssVars, V as resolveDynamicComponent, aa as normalizeProps, ab as guardReactiveProps } from "./vue-BnBKJwCW.es.js";
 import "./jszip.min-DCl8qkFO.es.js";
 import { E as EventEmitter$1 } from "./eventemitter3-CwrdEv8r.es.js";
@@ -15334,7 +15334,7 @@ const canUseDOM = () => {
     return false;
   }
 };
-const summaryVersion = "1.3.0-next.6";
+const summaryVersion = "1.3.0-next.8";
 const nodeKeys = ["group", "content", "marks", "inline", "atom", "defining", "code", "tableRole", "summary"];
 const markKeys = ["group", "inclusive", "excludes", "spanning", "code"];
 function mapAttributes(attrs) {
@@ -17967,7 +17967,7 @@ class Editor extends EventEmitter {
    * Process collaboration migrations
    */
   processCollaborationMigrations() {
-    console.debug("[checkVersionMigrations] Current editor version", "1.3.0-next.6");
+    console.debug("[checkVersionMigrations] Current editor version", "1.3.0-next.8");
     if (!this.options.ydoc) return;
     const metaMap = this.options.ydoc.getMap("meta");
     let docVersion = metaMap.get("version");
@@ -25551,7 +25551,28 @@ class DomPainter {
       section: kind,
       pageNumberText: page.numberText
     };
-    data.fragments.forEach((fragment) => {
+    const behindDocFragments = [];
+    const normalFragments = [];
+    for (const fragment of data.fragments) {
+      const isBehindDoc = (fragment.kind === "image" || fragment.kind === "drawing") && "zIndex" in fragment && fragment.zIndex === 0;
+      if (isBehindDoc) {
+        behindDocFragments.push(fragment);
+      } else {
+        normalFragments.push(fragment);
+      }
+    }
+    const behindDocSelector = `[data-behind-doc-section="${kind}"]`;
+    pageEl.querySelectorAll(behindDocSelector).forEach((el) => el.remove());
+    behindDocFragments.forEach((fragment) => {
+      const fragEl = this.renderFragment(fragment, context);
+      const pageY = effectiveOffset + fragment.y + (kind === "footer" ? footerYOffset : 0);
+      fragEl.style.top = `${pageY}px`;
+      fragEl.style.left = `${marginLeft + fragment.x}px`;
+      fragEl.style.zIndex = "0";
+      fragEl.dataset.behindDocSection = kind;
+      pageEl.insertBefore(fragEl, pageEl.firstChild);
+    });
+    normalFragments.forEach((fragment) => {
       const fragEl = this.renderFragment(fragment, context);
       if (footerYOffset > 0) {
         const currentTop = parseFloat(fragEl.style.top) || fragment.y;
@@ -33879,10 +33900,6 @@ function layoutHeaderFooter(blocks, measures, constraints) {
   if (!Number.isFinite(height) || height <= 0) {
     return { pages: [], height: 0 };
   }
-  const overflowBase = typeof constraints.overflowBaseHeight === "number" && Number.isFinite(constraints.overflowBaseHeight) && constraints.overflowBaseHeight > 0 ? constraints.overflowBaseHeight : height;
-  const maxBehindDocOverflow = Math.max(192, overflowBase * 4);
-  const minBehindDocY = -maxBehindDocOverflow;
-  const maxBehindDocY = height + maxBehindDocOverflow;
   const marginLeft = constraints.margins?.left ?? 0;
   const transformedBlocks = marginLeft > 0 ? blocks.map((block) => {
     const hasPageRelativeAnchor = (block.kind === "image" || block.kind === "drawing") && block.anchor?.hRelativeFrom === "page" && block.anchor.offsetH != null;
@@ -33921,7 +33938,7 @@ function layoutHeaderFooter(blocks, measures, constraints) {
           );
         }
         const anchoredBlock = block;
-        if (anchoredBlock.anchor?.behindDoc && (fragment.y < minBehindDocY || fragment.y > maxBehindDocY)) {
+        if (anchoredBlock.anchor?.behindDoc) {
           continue;
         }
       }
@@ -44836,6 +44853,12 @@ const applyBaseRunDefaults = (run, defaults, uiDisplayFallbackFont, fallbackSize
     run.letterSpacing = defaults.letterSpacing;
   }
 };
+const applyInlineRunProperties = (run, runProperties) => {
+  if (!runProperties) return;
+  if (runProperties?.letterSpacing != null) {
+    run.letterSpacing = twipsToPx$1(runProperties.letterSpacing);
+  }
+};
 function paragraphToFlowBlocks$1(para, nextBlockId, positions, defaultFont, defaultSize, styleContext, listCounterContext, trackedChanges, bookmarks, hyperlinkConfig = DEFAULT_HYPERLINK_CONFIG$1, themeColors, converters, converterContext) {
   const baseBlockId = nextBlockId("paragraph");
   const paragraphProps = typeof para.attrs?.paragraphProperties === "object" && para.attrs.paragraphProperties !== null ? para.attrs.paragraphProperties : {};
@@ -44988,7 +45011,7 @@ function paragraphToFlowBlocks$1(para, nextBlockId, positions, defaultFont, defa
       runStyleId
     });
   };
-  const visitNode = (node, inheritedMarks = [], activeSdt, activeRunStyleId = null) => {
+  const visitNode = (node, inheritedMarks = [], activeSdt, activeRunStyleId = null, activeRunProperties) => {
     if (node.type === "text" && node.text) {
       const run = textNodeToRun(
         node,
@@ -45004,6 +45027,7 @@ function paragraphToFlowBlocks$1(para, nextBlockId, positions, defaultFont, defa
       const inlineStyleId = getInlineStyleId(inheritedMarks);
       applyRunStyles2(run, inlineStyleId, activeRunStyleId);
       applyBaseRunDefaults(run, baseRunDefaults, defaultFont, defaultSize);
+      applyInlineRunProperties(run, activeRunProperties);
       applyMarksToRun(
         run,
         [...node.marks ?? [], ...inheritedMarks ?? []],
@@ -45016,14 +45040,16 @@ function paragraphToFlowBlocks$1(para, nextBlockId, positions, defaultFont, defa
     }
     if (node.type === "run" && Array.isArray(node.content)) {
       const mergedMarks = [...node.marks ?? [], ...inheritedMarks ?? []];
-      const nextRunStyleId = extractRunStyleId(node.attrs?.runProperties) ?? activeRunStyleId;
-      node.content.forEach((child) => visitNode(child, mergedMarks, activeSdt, nextRunStyleId));
+      const runProperties = typeof node.attrs?.runProperties === "object" && node.attrs.runProperties !== null ? node.attrs.runProperties : null;
+      const nextRunStyleId = extractRunStyleId(runProperties) ?? activeRunStyleId;
+      const nextRunProperties = runProperties ?? activeRunProperties;
+      node.content.forEach((child) => visitNode(child, mergedMarks, activeSdt, nextRunStyleId, nextRunProperties));
       return;
     }
     if (node.type === "structuredContent" && Array.isArray(node.content)) {
       const inlineMetadata = resolveNodeSdtMetadata(node, "structuredContent");
       const nextSdt = inlineMetadata ?? activeSdt;
-      node.content.forEach((child) => visitNode(child, inheritedMarks, nextSdt, activeRunStyleId));
+      node.content.forEach((child) => visitNode(child, inheritedMarks, nextSdt, activeRunStyleId, activeRunProperties));
       return;
     }
     if (node.type === "fieldAnnotation") {
@@ -45077,6 +45103,7 @@ function paragraphToFlowBlocks$1(para, nextBlockId, positions, defaultFont, defa
         const inlineStyleId = getInlineStyleId(mergedMarks);
         applyRunStyles2(tokenRun, inlineStyleId, activeRunStyleId);
         applyBaseRunDefaults(tokenRun, baseRunDefaults, defaultFont, defaultSize);
+        applyInlineRunProperties(tokenRun, activeRunProperties);
         if (pageRefPos) {
           tokenRun.pmStart = pageRefPos.start;
           tokenRun.pmEnd = pageRefPos.end;
@@ -45091,7 +45118,9 @@ function paragraphToFlowBlocks$1(para, nextBlockId, positions, defaultFont, defa
         }
         currentRuns.push(tokenRun);
       } else if (Array.isArray(node.content)) {
-        node.content.forEach((child) => visitNode(child, mergedMarks, activeSdt));
+        node.content.forEach(
+          (child) => visitNode(child, mergedMarks, activeSdt, activeRunStyleId, activeRunProperties)
+        );
       }
       return;
     }
@@ -45105,7 +45134,9 @@ function paragraphToFlowBlocks$1(para, nextBlockId, positions, defaultFont, defa
         }
       }
       if (Array.isArray(node.content)) {
-        node.content.forEach((child) => visitNode(child, inheritedMarks, activeSdt));
+        node.content.forEach(
+          (child) => visitNode(child, inheritedMarks, activeSdt, activeRunStyleId, activeRunProperties)
+        );
       }
       return;
     }
@@ -45157,6 +45188,7 @@ function paragraphToFlowBlocks$1(para, nextBlockId, positions, defaultFont, defa
           runStyleId: activeRunStyleId,
           mergedMarksCount: mergedMarks.length
         });
+        applyInlineRunProperties(tokenRun, activeRunProperties);
         currentRuns.push(tokenRun);
       }
       return;
@@ -48333,6 +48365,7 @@ async function measureParagraphBlock(block, maxWidth) {
   let lastFontSize = 12;
   let tabStopCursor = 0;
   let pendingTabAlignment = null;
+  let pendingRunSpacing = 0;
   let lastAppliedTabAlign = null;
   const warnedTabVals = /* @__PURE__ */ new Set();
   let activeTabGroup = null;
@@ -48343,6 +48376,10 @@ async function measureParagraphBlock(block, maxWidth) {
     }
     return true;
   };
+  const resolveBoundarySpacing = (lineWidth, isRunStart, run) => {
+    if (lineWidth <= 0) return 0;
+    return isRunStart ? pendingRunSpacing : run.letterSpacing ?? 0;
+  };
   const alignPendingTabForWidth = (segmentWidth, beforeDecimalWidth) => {
     if (!pendingTabAlignment || !currentLine) return void 0;
     if (segmentWidth < 0) {
@@ -48470,6 +48507,7 @@ async function measureParagraphBlock(block, maxWidth) {
       tabStopCursor = 0;
       pendingTabAlignment = null;
       lastAppliedTabAlign = null;
+      pendingRunSpacing = 0;
       continue;
     }
     if (isLineBreakRun(run)) {
@@ -48512,6 +48550,7 @@ async function measureParagraphBlock(block, maxWidth) {
       tabStopCursor = 0;
       pendingTabAlignment = null;
       lastAppliedTabAlign = null;
+      pendingRunSpacing = 0;
       continue;
     }
     if (isTabRun(run)) {
@@ -48577,6 +48616,7 @@ async function measureParagraphBlock(block, maxWidth) {
       } else {
         pendingTabAlignment = null;
       }
+      pendingRunSpacing = 0;
       continue;
     }
     if (isImageRun(run)) {
@@ -48615,6 +48655,7 @@ async function measureParagraphBlock(block, maxWidth) {
             }
           ]
         };
+        pendingRunSpacing = 0;
         if (activeTabGroup && runIndex + 1 >= activeTabGroup.measure.endRunIndex) {
           activeTabGroup = null;
         }
@@ -48676,6 +48717,7 @@ async function measureParagraphBlock(block, maxWidth) {
         currentLine.width = roundValue(tabAlign.target);
       }
       lastAppliedTabAlign = null;
+      pendingRunSpacing = 0;
       continue;
     }
     if (isFieldAnnotationRun(run)) {
@@ -48715,6 +48757,7 @@ async function measureParagraphBlock(block, maxWidth) {
             }
           ]
         };
+        pendingRunSpacing = 0;
         continue;
       }
       if (currentLine.width + annotationWidth > currentLine.maxWidth && currentLine.width > 0) {
@@ -48767,9 +48810,11 @@ async function measureParagraphBlock(block, maxWidth) {
         currentLine.width = roundValue(tabAlign.target);
       }
       lastAppliedTabAlign = null;
+      pendingRunSpacing = 0;
       continue;
     }
     if (!("text" in run) || !("fontSize" in run)) {
+      pendingRunSpacing = 0;
       continue;
     }
     lastFontSize = run.fontSize;
@@ -48780,6 +48825,7 @@ async function measureParagraphBlock(block, maxWidth) {
       const segment = tabSegments[segmentIndex];
       const isLastSegment = segmentIndex === tabSegments.length - 1;
       if (/^[ ]+$/.test(segment)) {
+        const isRunStart = charPosInRun === 0 && segmentIndex === 0;
         const spacesLength = segment.length;
         const spacesStartChar = charPosInRun;
         const spacesEndChar = charPosInRun + spacesLength;
@@ -48798,7 +48844,7 @@ async function measureParagraphBlock(block, maxWidth) {
             spaceCount: spacesLength
           };
         } else {
-          const boundarySpacing = currentLine.width > 0 ? run.letterSpacing ?? 0 : 0;
+          const boundarySpacing = resolveBoundarySpacing(currentLine.width, isRunStart, run);
           if (currentLine.width + boundarySpacing + spacesWidth > currentLine.maxWidth - WIDTH_FUDGE_PX2 && currentLine.width > 0) {
             trimTrailingWrapSpaces(currentLine);
             const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing, currentLine.maxFontInfo);
@@ -48862,6 +48908,7 @@ async function measureParagraphBlock(block, maxWidth) {
           const spaceStartChar = charPosInRun;
           const spaceEndChar = charPosInRun + 1;
           const singleSpaceWidth = measureRunWidth(" ", font, ctx2, run, spaceStartChar);
+          const isRunStart2 = charPosInRun === 0 && segmentIndex === 0 && wordIndex === 0;
           if (!currentLine) {
             currentLine = {
               fromRun: runIndex,
@@ -48876,7 +48923,7 @@ async function measureParagraphBlock(block, maxWidth) {
               spaceCount: 1
             };
           } else {
-            const boundarySpacing2 = currentLine.width > 0 ? run.letterSpacing ?? 0 : 0;
+            const boundarySpacing2 = resolveBoundarySpacing(currentLine.width, isRunStart2, run);
             if (currentLine.width + boundarySpacing2 + singleSpaceWidth > currentLine.maxWidth - WIDTH_FUDGE_PX2 && currentLine.width > 0) {
               trimTrailingWrapSpaces(currentLine);
               const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing, currentLine.maxFontInfo);
@@ -49061,7 +49108,8 @@ async function measureParagraphBlock(block, maxWidth) {
           continue;
         }
         const isTocEntry = block.attrs?.isTocEntry;
-        const boundarySpacing = currentLine.width > 0 ? run.letterSpacing ?? 0 : 0;
+        const isRunStart = charPosInRun === 0 && segmentIndex === 0 && wordIndex === 0;
+        const boundarySpacing = resolveBoundarySpacing(currentLine.width, isRunStart, run);
         const justifyAlignment = block.attrs?.alignment === "justify";
         const totalWidthWithWord = currentLine.width + boundarySpacing + wordCommitWidth + // Safe cast: only TextRuns produce word segments from split(), other run types are handled earlier
         (shouldIncludeDelimiterSpace ? run.letterSpacing ?? 0 : 0);
@@ -49229,6 +49277,7 @@ async function measureParagraphBlock(block, maxWidth) {
         }
       }
     }
+    pendingRunSpacing = run.letterSpacing ?? 0;
   }
   if (!currentLine && lines.length === 0) {
     const uiDisplayFallbackFontSize = (block.runs[0]?.kind === "text" ? block.runs[0].fontSize : void 0) ?? 12;
@@ -50032,6 +50081,7 @@ class PresentationEditor extends EventEmitter {
   #dragLastPointer = null;
   #dragLastRawHit = null;
   #dragUsedPageNotMountedFallback = false;
+  #suppressFocusInFromDraggable = false;
   // Cell selection drag state
   // Tracks cell-specific context when drag starts in a table for multi-cell selection
   #cellAnchor = null;
@@ -52015,6 +52065,7 @@ class PresentationEditor extends EventEmitter {
       return;
     }
     const isDraggableAnnotation = target?.closest?.('[data-draggable="true"]') != null;
+    this.#suppressFocusInFromDraggable = isDraggableAnnotation;
     if (!this.#layoutState.layout) {
       if (!isDraggableAnnotation) {
         event.preventDefault();
@@ -52771,6 +52822,10 @@ class PresentationEditor extends EventEmitter {
     if (isInRegisteredSurface(event)) {
       return;
     }
+    if (this.#suppressFocusInFromDraggable) {
+      this.#suppressFocusInFromDraggable = false;
+      return;
+    }
     const target = event.target;
     const activeTarget = this.#getActiveDomTarget();
     if (!activeTarget) {
@@ -52797,6 +52852,7 @@ class PresentationEditor extends EventEmitter {
     }
   };
   #handlePointerUp = (event) => {
+    this.#suppressFocusInFromDraggable = false;
     if (!this.#isDragging) return;
     if (typeof this.#viewportHost.hasPointerCapture === "function" && typeof this.#viewportHost.releasePointerCapture === "function" && this.#viewportHost.hasPointerCapture(event.pointerId)) {
       this.#viewportHost.releasePointerCapture(event.pointerId);
@@ -60544,16 +60600,7 @@ const Table = Node$1.create({
        * @param {import("./tableHelpers/createTableBorders.js").TableBorders} [borders] - Border styling for this table
        */
       borders: {
-        default: {},
-        renderDOM({ borders }) {
-          if (!borders) return {};
-          const style2 = Object.entries(borders).reduce((acc, [key2, { size: size2, color }]) => {
-            return `${acc}border-${key2}: ${Math.ceil(size2)}px solid ${color || "black"};`;
-          }, "");
-          return {
-            style: style2
-          };
-        }
+        default: {}
       },
       /**
        * @category Attribute