@univerjs/core 1.0.0-beta.1 → 1.0.0-beta.2

package/lib/types/docs/data-model/rich-text-builder.d.ts

@@ -1558,6 +1558,24 @@ export declare class RichTextBuilder extends RichTextValue {
      * ```
      */
     code(text: string): RichTextBuilder;
+    /**
+     * Appends linked text.
+     *
+     * This is the agent-friendly alias of `insertLink(text, url)`. Use `setLink(start, end, url)` only when applying a
+     * link to text that is already present and numeric offsets are unavoidable.
+     *
+     * @param text Visible link text to append. An empty string is ignored.
+     * @param url Link destination.
+     * @returns The current builder for chaining.
+     * @example
+     * ```ts
+     * const richText = univerAPI.newRichText()
+     *   .text('Read ')
+     *   .link('Univer documentation', 'https://docs.univer.ai')
+     *   .text(' for details.');
+     * ```
+     */
+    link(text: string, url: string): RichTextBuilder;
     /**
      * Appends one ordered, unordered, or checklist paragraph.
      *
@@ -1745,6 +1763,28 @@ export declare class RichTextBuilder extends RichTextValue {
      * ```
      */
     cancelLink(start: number, end: number): RichTextBuilder;
+    /**
+     * Removes a link while preserving its visible text.
+     *
+     * Link ids are available from `getLinks()`. This readable alias avoids exposing text offsets for the common case.
+     * Use `cancelLink(start, end)` only when removing every link in a known text range.
+     *
+     * @param id Link range id returned by `getLinks()`.
+     * @returns The current builder for chaining.
+     * @example
+     * ```ts
+     * const richText = univerAPI.newRichText().link('Univer', 'https://univer.ai');
+     * const [link] = richText.getLinks();
+     * if (link) richText.removeLink(link.rangeId);
+     * ```
+     */
+    removeLink(id: string): RichTextBuilder;
+    /**
+     * Updates a link destination while preserving its visible text.
+     * @param id Link range id returned by `getLinks()`.
+     * @param url New link destination.
+     * @returns The current builder for chaining.
+     */
     updateLink(id: string, url: string): RichTextBuilder;
     /**
      * Inserts a new paragraph to the end
@@ -1770,10 +1810,14 @@ export declare class RichTextBuilder extends RichTextValue {
      */
     insertParagraph(start: number, paragraphStyle: ParagraphStyleBuilder): RichTextBuilder;
     /**
-     * Inserts a new link
-     * @param text
-     * @param url
-     * @returns
+     * Inserts linked text at the end of the builder or at an explicit text offset.
+     *
+     * Application and agent code should prefer `link(text, url)` for left-to-right construction. The positional
+     * overload remains available for advanced document-model integrations.
+     *
+     * @param text Visible link text to insert.
+     * @param url Link destination.
+     * @returns The current builder for chaining.
      */
     insertLink(text: string, url: string): RichTextBuilder;
     insertLink(start: number, text: string, url: string): RichTextBuilder;

package/lib/types/docs/data-model/text-x/build-utils/drawings.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import type { ITextRange, ITextRangeParam } from '../../../../sheets/typedef';
-import type { IDocumentBody, IDrawingParam } from '../../../../types/interfaces';
+import type { IDocumentBody, IDocumentData, IDrawingParam } from '../../../../types/interfaces';
 import type { DocumentDataModel } from '../../document-data-model';
 import type { JSONXActions } from '../../json-x/json-x';
 export interface IAddDrawingParam {
@@ -23,4 +23,5 @@ export interface IAddDrawingParam {
     drawings: IDrawingParam[];
 }
 export declare function getCustomBlockIdsInSelections(body: IDocumentBody, selections: ITextRange[]): string[];
+export declare function removeDrawingReferences(documentData: Pick<IDocumentData, 'body' | 'drawings' | 'drawingsOrder'>, selections: ITextRange[], body?: IDocumentBody | undefined): JSONXActions[];
 export declare const addDrawing: (param: IAddDrawingParam) => false | JSONXActions;

package/lib/types/docs/data-model/text-x/build-utils/index.d.ts

@@ -15,6 +15,7 @@
  */
 import { addCustomDecorationTextX, deleteCustomDecorationTextX } from './custom-decoration';
 import { copyCustomRange, getCustomRangesInterestsWithSelection, isIntersecting } from './custom-range';
+import { removeDrawingReferences } from './drawings';
 import { getParagraphsInRange, getParagraphsInRanges, isSegmentIntersects, makeSelection, normalizeSelection, transformParagraphs } from './selection';
 import { addCustomRangeTextX, deleteCustomRangeTextX, deleteSelectionTextX, retainSelectionTextX } from './text-x-utils';
 export declare class BuildTextUtils {
@@ -65,6 +66,7 @@ export declare class BuildTextUtils {
     };
     static drawing: {
         add: (param: import("./drawings").IAddDrawingParam) => false | import("ot-json1").JSONOp;
+        remove: typeof removeDrawingReferences;
     };
 }
 export { getSingleDataStreamChange } from './data-stream-change';

package/lib/types/facade/f-univer.d.ts

@@ -279,9 +279,9 @@ export declare class FUniver extends Disposable {
      * @example
      * ```ts
      * const richText = univerAPI.newRichText()
-     *   .align({ horizontal: univerAPI.Enum.HorizontalAlign.CENTER })
-     *   .text('Status: ')
-     *   .span('Ready', { bold: true, color: '#16a34a' });
+     *   .text('Read ')
+     *   .link('Univer documentation', 'https://docs.univer.ai')
+     *   .text(' for details.');
      * ```
      */
     newRichText(): RichTextBuilder;

package/lib/types/sheets/typedef.d.ts

@@ -266,6 +266,8 @@ export interface IFontRenderExtension {
 export interface ICellDataForSheetInterceptor extends ICellData {
     interceptorStyle?: Nullable<IStyleData>;
     isInArrayFormulaRange?: Nullable<boolean>;
+    /** Marks intercepted cell data prepared for percentage editing. */
+    isPercentFormat?: boolean;
     markers?: ICellMarks;
     customRender?: Nullable<ICellCustomRender[]>;
     interceptorAutoHeight?: () => number | undefined;