@univerjs/core 1.0.0-alpha.2 → 1.0.0-alpha.3

package/lib/cjs/facade.js

@@ -429,6 +429,42 @@ var FEnum = class FEnum {
 		return _univerjs_core.HorizontalAlign;
 	}
 	/**
+	* Paragraph line-height interpretation modes
+	*
+	* @example
+	* ```ts
+	* console.log(univerAPI.Enum.SpacingRule.EXACT);
+	* ```
+	*/
+	get SpacingRule() {
+		return _univerjs_core.SpacingRule;
+	}
+	/**
+	* Units accepted by document lengths such as paragraph indentation and spacing
+	*
+	* Agent-facing rich-text helpers accept plain numbers as document points, so this enum is only needed when an
+	* explicit alternative unit is required.
+	*
+	* @example
+	* ```ts
+	* console.log(univerAPI.Enum.NumberUnitType.POINT);
+	* ```
+	*/
+	get NumberUnitType() {
+		return _univerjs_core.NumberUnitType;
+	}
+	/**
+	* Preset ordered, unordered, and checklist styles used by rich-text list items
+	*
+	* @example
+	* ```ts
+	* console.log(univerAPI.Enum.PresetListType.BULLET_LIST);
+	* ```
+	*/
+	get PresetListType() {
+		return _univerjs_core.PresetListType;
+	}
+	/**
 	* Different text decoration styles
 	*
 	* @example
@@ -659,6 +695,17 @@ var FEnum = class FEnum {
 	get ThemeColorType() {
 		return _univerjs_core.ThemeColorType;
 	}
+	/**
+	* Image source types
+	*
+	* @example
+	* ```ts
+	* console.log(univerAPI.Enum.ImageSourceType.URL);
+	* ```
+	*/
+	get ImageSourceType() {
+		return _univerjs_core.ImageSourceType;
+	}
 };
 _defineProperty(FEnum, "_instance", void 0);
 
@@ -854,6 +901,7 @@ let FHooks = class FHooks extends FBase {
 	}
 	/**
 	* @param callback
+	* @returns {IDisposable} A disposable used to remove the listener.
 	* @deprecated use `univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {})` as instead
 	*/
 	onStarting(callback) {
@@ -861,6 +909,7 @@ let FHooks = class FHooks extends FBase {
 	}
 	/**
 	* @param callback
+	* @returns {IDisposable} A disposable used to remove the listener.
 	* @deprecated use `univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {})` as instead
 	*/
 	onReady(callback) {
@@ -868,6 +917,7 @@ let FHooks = class FHooks extends FBase {
 	}
 	/**
 	* @param callback
+	* @returns {IDisposable} A disposable used to remove the listener.
 	* @deprecated use `univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {})` as instead
 	*/
 	onRendered(callback) {
@@ -875,6 +925,7 @@ let FHooks = class FHooks extends FBase {
 	}
 	/**
 	* @param callback
+	* @returns {IDisposable} A disposable used to remove the listener.
 	* @deprecated use `univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {})` as instead
 	*/
 	onSteady(callback) {
@@ -882,6 +933,7 @@ let FHooks = class FHooks extends FBase {
 	}
 	/**
 	* @param callback
+	* @returns {IDisposable} A disposable used to remove the listener.
 	* @deprecated use `univerAPI.addEvent(univerAPI.Event.BeforeUndo, (event) => {})` as instead
 	*/
 	onBeforeUndo(callback) {
@@ -894,6 +946,7 @@ let FHooks = class FHooks extends FBase {
 	}
 	/**
 	* @param callback
+	* @returns {IDisposable} A disposable used to remove the listener.
 	* @deprecated use `univerAPI.addEvent(univerAPI.Event.Undo, (event) => {})` as instead
 	*/
 	onUndo(callback) {
@@ -906,6 +959,7 @@ let FHooks = class FHooks extends FBase {
 	}
 	/**
 	* @param callback
+	* @returns {IDisposable} A disposable used to remove the listener.
 	* @deprecated use `univerAPI.addEvent(univerAPI.Event.BeforeRedo, (event) => {})` as instead
 	*/
 	onBeforeRedo(callback) {
@@ -918,6 +972,7 @@ let FHooks = class FHooks extends FBase {
 	}
 	/**
 	* @param callback
+	* @returns {IDisposable} A disposable used to remove the listener.
 	* @deprecated use `univerAPI.addEvent(univerAPI.Event.Redo, (event) => {})` as instead
 	*/
 	onRedo(callback) {
@@ -1537,50 +1592,53 @@ let FUniver = _FUniver = class FUniver extends _univerjs_core.Disposable {
 	}
 	/**
 	* Create a new rich text.
-	* @param {IDocumentData} data
 	* @returns {RichTextBuilder} The new rich text instance
 	* @example
 	* ```ts
-	* const richText = univerAPI.newRichText({ body: { dataStream: 'Hello World\r\n' } });
-	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
-	* if (!fWorksheet) return;
-	* const range = fWorksheet.getRange('A1');
-	* range.setRichTextValueForCell(richText);
+	* const richText = univerAPI.newRichText()
+	*   .align({ horizontal: univerAPI.Enum.HorizontalAlign.CENTER })
+	*   .text('Status: ')
+	*   .span('Ready', { bold: true, color: '#16a34a' });
 	* ```
 	*/
-	newRichText(data) {
+	newRichText() {
+		return _univerjs_core.RichTextBuilder.create();
+	}
+	/**
+	* Create a rich-text builder from raw Univer document data.
+	*
+	* This is an advanced integration escape hatch for importers and adapters. Application and agent code should use
+	* the fluent builder returned by `newRichText()`.
+	*
+	* @param data Raw Univer document data.
+	* @returns A rich-text builder initialized with the supplied document data.
+	* @advanced
+	*/
+	newRichTextFromDocumentData(data) {
 		return _univerjs_core.RichTextBuilder.create(data);
 	}
 	/**
 	* Create a new rich text value.
-	* @param {IDocumentData} data - The rich text data
+	*
+	* This is an advanced integration escape hatch for callers that already own Univer document data. Application and
+	* agent code should prefer the fluent value returned by `newRichText()`.
+	*
+	* @param {IDocumentData} data The raw Univer document data.
 	* @returns {RichTextValue} The new rich text value instance
-	* @example
-	* ```ts
-	* const richTextValue = univerAPI.newRichTextValue({ body: { dataStream: 'Hello World\r\n' } });
-	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
-	* if (!fWorksheet) return;
-	* const range = fWorksheet.getRange('A1');
-	* range.setRichTextValueForCell(richTextValue);
-	* ```
+	* @advanced
 	*/
 	newRichTextValue(data) {
 		return _univerjs_core.RichTextValue.create(data);
 	}
 	/**
 	* Create a new paragraph style.
-	* @param {IParagraphStyle} style - The paragraph style
+	*
+	* This is an advanced document-model API. Application and agent code should normally use
+	* `newRichText().paragraph({ ... })`.
+	*
+	* @param {IParagraphStyle} style The paragraph style
 	* @returns {ParagraphStyleBuilder} The new paragraph style instance
-	* @example
-	* ```ts
-	* const richText = univerAPI.newRichText({ body: { dataStream: 'Hello World\r\n' } });
-	* const paragraphStyle = univerAPI.newParagraphStyle({ textStyle: { ff: 'Arial', fs: 12, it: univerAPI.Enum.BooleanNumber.TRUE, bl: univerAPI.Enum.BooleanNumber.TRUE } });
-	* richText.insertParagraph(paragraphStyle);
-	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
-	* if (!fWorksheet) return;
-	* const range = fWorksheet.getRange('A1');
-	* range.setRichTextValueForCell(richText);
-	* ```
+	* @advanced
 	*/
 	newParagraphStyle(style) {
 		return _univerjs_core.ParagraphStyleBuilder.create(style);