@univerjs-pro/shape-editor-ui 1.0.1 → 1.0.3

package/lib/types/controllers/shape-text-hyper-link-hover.controller.d.ts

@@ -0,0 +1,31 @@
+import type { IDisposable, Nullable, UnitModel } from '@univerjs/core';
+import type { BaseObject, IMouseEvent, IPointerEvent, IRenderContext } from '@univerjs/engine-render';
+import type { Observable } from 'rxjs';
+import type { IShapeTextHyperLinkInfo } from '../commands/shape-text-hyper-link.command';
+import type { ShapeTextHyperLinkPopupService } from '../services/shape-text-hyper-link-popup.service';
+import { Disposable } from '@univerjs/core';
+export interface IShapeTextHyperLinkTarget {
+    object: BaseObject;
+    info: IShapeTextHyperLinkInfo;
+    attachPopup: () => IDisposable;
+}
+export interface IShapeTextHyperLinkHost {
+    resolve: (event: IPointerEvent | IMouseEvent) => IShapeTextHyperLinkTarget | null;
+    editing$: Observable<Nullable<{
+        visible?: boolean;
+    }>>;
+}
+/** Shared hover lifetime; hosts own picking, coordinates, permissions and popup anchors. */
+export declare class ShapeTextHyperLinkHoverController extends Disposable {
+    private readonly _context;
+    private readonly _popup;
+    private _target;
+    private _targetLifetime;
+    private _ownsCursor;
+    private _editing;
+    constructor(_context: IRenderContext<UnitModel>, _popup: ShapeTextHyperLinkPopupService, host: IShapeTextHyperLinkHost);
+    clear(): void;
+    private _ownsPopup;
+    private _restoreCursor;
+    dispose(): void;
+}

package/lib/types/index.d.ts

@@ -4,6 +4,7 @@ export { OpenShapeTextHyperLinkOperation } from './commands/shape-text-hyper-lin
 export { FillStyleTabsEditor } from './components/fill-style-tabs-editor/FillStyleTabsEditor';
 export { SHAPE_EDITOR_UI_PLUGIN_CONFIG_KEY } from './config/config';
 export type { IFormulaBindingEditorResult, IFormulaBindingEditorValue, IFormulaBindingHost, IUniverShapeEditorUIConfig, } from './config/config';
+export { ShapeTextHyperLinkHoverController } from './controllers/shape-text-hyper-link-hover.controller';
 export { ShapeFloatingToolbarToggleFactory } from './menu/shape-floating-toolbar.menu';
 export { UniverShapeEditorMobileUIPlugin } from './mobile-plugin';
 export { UniverShapeEditorUIPlugin } from './plugin';
@@ -24,6 +25,8 @@ export { bindRenderTransformerLifecycle } from './utils/render-transformer-lifec
 export type { RenderTransformer } from './utils/render-transformer-lifecycle';
 export { resolveShapeContextualRibbonHostMode } from './utils/shape-contextual-ribbon-host';
 export { SHAPE_FLOATING_TOOLBAR_TOP_OFFSET, SHEET_DOC_SHAPE_FLOATING_TOOLBAR_TOP_OFFSET } from './utils/shape-floating-toolbar-config';
+export { createShapeTextHyperLinkRegions, resolveShapeTextHyperLinkAt, resolveShapeTextHyperLinkObject } from './utils/shape-text-hyper-link-hit';
+export type { IShapeTextHyperLinkRegion } from './utils/shape-text-hyper-link-hit';
 export { SHAPE_EDITOR_TRANSFORMER_CONFIG } from './utils/shape-transformer-config';
 export { getTextModel, getTextStyle, normalizeShapeTextModel } from './utils/util';
 export { getFormulaBindingCurrencyFormatOptions, getFormulaBindingCurrencyType, getFormulaBindingDateFormatOptions, getFormulaBindingDecimalFromPattern, getFormulaBindingNumberFormatOptions, setFormulaBindingPatternDecimal, } from './views/formula-binding-number-format-utils';

package/lib/types/services/formula-binding-unit-viewer.service.d.ts

@@ -0,0 +1,67 @@
+import type { BaseDataModel } from '@univerjs/core';
+import type { FormulaSequenceNode, IFormulaRefSelection } from '@univerjs/engine-formula';
+import type { IFormulaBindingHost, IFormulaBindingUnitResource } from '../config/config';
+import type { IFormulaBindingReferenceSelectionChange } from './formula-binding-editor';
+import { Disposable, IConfigService, IUniverInstanceService, LocaleService, ThemeService, Workbook } from '@univerjs/core';
+export type FormulaBindingViewerUnit = Workbook | BaseDataModel;
+export interface IFormulaBindingViewerFormulaContext {
+    formula: string;
+    sequenceNodes: FormulaSequenceNode[];
+    refSelections: IFormulaRefSelection[];
+    selectionStart: number;
+    selectionEnd: number;
+}
+/** Owns the real, isolated Univer rendered inside the cross-unit formula editor. */
+export declare class FormulaBindingUnitViewerService extends Disposable {
+    private readonly _configService;
+    private readonly _instanceService;
+    private readonly _localeService;
+    private readonly _themeService;
+    private _univer;
+    private _activeUnitId;
+    private _container;
+    private _generation;
+    private _selectionDisposables;
+    private _formulaContext;
+    private _host;
+    private _resource;
+    private _onSelectReferences;
+    private _activeWorkbook;
+    private _activeBase;
+    private _visibleReferenceIndexes;
+    private _isApplyingBaseHighlight;
+    private _pointerCtrlKey;
+    private _pointerListener;
+    private _selectionChangingDisposable;
+    private _controlDisposables;
+    private _isDraggingFormulaSelection;
+    private _closeRequest;
+    constructor(_configService: IConfigService, _instanceService: IUniverInstanceService, _localeService: LocaleService, _themeService: ThemeService);
+    listUnits(): Promise<IFormulaBindingUnitResource[]>;
+    mount(container: HTMLElement): void;
+    switchUnit(resource: IFormulaBindingUnitResource, host: IFormulaBindingHost, onSelectReferences: (change: IFormulaBindingReferenceSelectionChange) => void): Promise<FormulaBindingViewerUnit | null>;
+    private _makeBaseSnapshotReadOnly;
+    private _setBasePermissionsReadOnly;
+    updateFormulaContext(context: IFormulaBindingViewerFormulaContext): void;
+    close(): void;
+    /** Defers nested Univer disposal until the owning React tree has finished unmounting. */
+    scheduleClose(): void;
+    private _closeNow;
+    dispose(): void;
+    private _createUniver;
+    private _observeSheetSelection;
+    private _observeBaseSelection;
+    private _handleBaseSelectionChange;
+    private _getBaseReferenceSource;
+    private _emitSheetSelectionChange;
+    private _refreshFormulaSelections;
+    private _refreshSheetFormulaSelections;
+    private _refreshBaseFormulaSelection;
+    private _bindFormulaSelectionControls;
+    private _getEditingContext;
+    private _canSelectFormulaReference;
+    private _matchesSheetReference;
+    private _matchesUnitQualifier;
+    private _createExternalReference;
+    private _listLoadedUnits;
+}

package/lib/types/services/shape-formula-editor.d.ts

@@ -0,0 +1,20 @@
+import type { FormulaSequenceNode, IFormulaRefSelection } from '@univerjs/engine-formula';
+export interface IShapeFormulaReferenceSelectionChange {
+    references: string[];
+    visibleReferenceIndexes: number[];
+    activeReferenceIndex?: number;
+    isCtrlAddMode: boolean;
+}
+export interface IShapeFormulaReferenceEditResult {
+    formula: string;
+    selectionStart: number;
+    selectionEnd: number;
+}
+export declare function applyShapeFormulaReferenceSelection(options: {
+    formula: string;
+    sequenceNodes: FormulaSequenceNode[];
+    referenceSelections?: IFormulaRefSelection[];
+    selectionStart: number;
+    selectionEnd: number;
+    change: IShapeFormulaReferenceSelectionChange;
+}): IShapeFormulaReferenceEditResult | null;

package/lib/types/services/shape-formula-reference.d.ts

@@ -0,0 +1,15 @@
+import type { IShapeFormulaIdentity } from '@univerjs-pro/shape-editor';
+import type { IBaseSnapshot, IRange, Workbook, Worksheet } from '@univerjs/core';
+export declare function buildSheetShapeFormulaReference(options: {
+    host: IShapeFormulaIdentity;
+    range: IRange;
+    workbook: Workbook;
+    worksheet: Worksheet;
+}): string;
+export declare function buildBaseShapeFormulaReference(options: {
+    fieldIds: string[];
+    hostUnitId: string;
+    snapshot: IBaseSnapshot;
+    sourceUnitId: string;
+    tableId: string;
+}): string | null;

package/lib/types/services/shape-formula-unit-viewer.service.d.ts

@@ -0,0 +1,67 @@
+import type { IShapeFormulaIdentity } from '@univerjs-pro/shape-editor';
+import type { BaseDataModel } from '@univerjs/core';
+import type { FormulaSequenceNode, IFormulaRefSelection } from '@univerjs/engine-formula';
+import type { IShapeFormulaUnitResource } from '../config/config';
+import type { IShapeFormulaReferenceSelectionChange } from './shape-formula-editor';
+import { Disposable, IConfigService, IUniverInstanceService, LocaleService, ThemeService, Workbook } from '@univerjs/core';
+export type ShapeFormulaViewerUnit = Workbook | BaseDataModel;
+export interface IShapeFormulaViewerFormulaContext {
+    formula: string;
+    sequenceNodes: FormulaSequenceNode[];
+    refSelections: IFormulaRefSelection[];
+    selectionStart: number;
+    selectionEnd: number;
+}
+/** Owns the real, isolated Univer rendered inside the cross-unit formula editor. */
+export declare class ShapeFormulaUnitViewerService extends Disposable {
+    private readonly _configService;
+    private readonly _instanceService;
+    private readonly _localeService;
+    private readonly _themeService;
+    private _univer;
+    private _activeUnitId;
+    private _container;
+    private _generation;
+    private _selectionDisposables;
+    private _formulaContext;
+    private _host;
+    private _resource;
+    private _onSelectReferences;
+    private _activeWorkbook;
+    private _activeBase;
+    private _visibleReferenceIndexes;
+    private _isApplyingBaseHighlight;
+    private _pointerCtrlKey;
+    private _pointerListener;
+    private _selectionChangingDisposable;
+    private _controlDisposables;
+    private _isDraggingFormulaSelection;
+    private _closeRequest;
+    constructor(_configService: IConfigService, _instanceService: IUniverInstanceService, _localeService: LocaleService, _themeService: ThemeService);
+    listUnits(): Promise<IShapeFormulaUnitResource[]>;
+    mount(container: HTMLElement): void;
+    switchUnit(resource: IShapeFormulaUnitResource, host: IShapeFormulaIdentity, onSelectReferences: (change: IShapeFormulaReferenceSelectionChange) => void): Promise<ShapeFormulaViewerUnit | null>;
+    private _makeBaseSnapshotReadOnly;
+    private _setBasePermissionsReadOnly;
+    updateFormulaContext(context: IShapeFormulaViewerFormulaContext): void;
+    close(): void;
+    /** Defers nested Univer disposal until the owning React tree has finished unmounting. */
+    scheduleClose(): void;
+    private _closeNow;
+    dispose(): void;
+    private _createUniver;
+    private _observeSheetSelection;
+    private _observeBaseSelection;
+    private _handleBaseSelectionChange;
+    private _getBaseReferenceSource;
+    private _emitSheetSelectionChange;
+    private _refreshFormulaSelections;
+    private _refreshSheetFormulaSelections;
+    private _refreshBaseFormulaSelection;
+    private _bindFormulaSelectionControls;
+    private _getEditingContext;
+    private _canSelectFormulaReference;
+    private _matchesSheetReference;
+    private _matchesUnitQualifier;
+    private _listLoadedUnits;
+}

package/lib/types/services/shape-text-hyper-link-popup.service.d.ts

@@ -14,6 +14,8 @@ export declare class ShapeTextHyperLinkPopupService extends Disposable {
     private _editPopup;
     private _editPopupUnitId;
     private _infoPopup;
+    private _infoPopupHovered;
+    private _infoPopupHideTimer;
     private _infoPopupSuppressed;
     private _infoPopupSuppressionTimer;
     constructor(_docCanvasPopupManagerService: DocCanvasPopManagerService, _docSelectionManagerService: DocSelectionManagerService, _univerInstanceService: IUniverInstanceService);
@@ -25,5 +27,8 @@ export declare class ShapeTextHyperLinkPopupService extends Disposable {
     hideEditPopup(unitId?: string): void;
     showInfoPopup(info: IShapeTextHyperLinkInfo, attachPopup?: () => IDisposable): Nullable<IDisposable>;
     hideInfoPopup(): void;
+    setInfoPopupHovered(hovered: boolean): void;
+    scheduleHideInfoPopup(): void;
+    private _cancelScheduledHideInfoPopup;
     hideInfoPopupOnPointerDown(): void;
 }

package/lib/types/utils/shape-text-hyper-link-hit.d.ts

@@ -0,0 +1,21 @@
+import type { BaseObject, Documents, IBoundRectNoAngle, Scene, Vector2 } from '@univerjs/engine-render';
+export interface IShapeTextHyperLinkHit {
+    linkId: string;
+    url: string;
+    startIndex: number;
+    endIndex: number;
+}
+export interface IShapeTextHyperLinkRegion extends IShapeTextHyperLinkHit {
+    rects: IBoundRectNoAngle[];
+}
+/** Capture rendered geometry before temporary document resources are disposed. */
+export declare function createShapeTextHyperLinkRegions(documents: Documents, offset: {
+    left: number;
+    top: number;
+}, clip?: IBoundRectNoAngle): IShapeTextHyperLinkRegion[];
+export declare function resolveShapeTextHyperLinkAt(regions: readonly IShapeTextHyperLinkRegion[], point: {
+    x: number;
+    y: number;
+}): IShapeTextHyperLinkHit | null;
+/** Descend only into the picked group, retaining the first visible object as an occlusion boundary. */
+export declare function resolveShapeTextHyperLinkObject(picked: BaseObject | Scene | null | undefined, point: Vector2): BaseObject | Scene | null;

package/lib/types/views/formula-shape/FormulaShapeNumberFormat.d.ts

@@ -0,0 +1,24 @@
+import type * as ReactTypes from "react";
+export type FormulaShapeNumberFormatType = 'general' | 'accounting' | 'currency' | 'date' | 'number' | 'custom';
+export type FormulaShapeNumberFormatMenuEntry = {
+    kind: 'format';
+    key: string;
+    pattern: string;
+} | {
+    kind: 'separator';
+    key: string;
+} | {
+    kind: 'more';
+};
+export declare function createFormulaShapeNumberFormatMenuEntries(currencySymbol: string): FormulaShapeNumberFormatMenuEntry[];
+export declare function resolveFormulaShapeNumberFormatType(pattern: string): FormulaShapeNumberFormatType;
+export declare function FormulaShapeNumberFormatMenu(props: {
+    onSelect: (pattern: string) => void;
+    onMore: () => void;
+}): ReactTypes.JSX.Element;
+export declare function FormulaShapeNumberFormatDialog(props: {
+    open: boolean;
+    pattern: string;
+    onClose: () => void;
+    onConfirm: (pattern: string) => void;
+}): ReactTypes.JSX.Element;

package/lib/types/views/formula-shape/formula-shape-number-format-utils.d.ts

@@ -0,0 +1,17 @@
+export declare function getFormulaShapeCurrencyType(pattern: string): string | undefined;
+export declare function getFormulaShapeDecimalFromPattern(pattern: string, defaultValue?: number): number;
+export declare function setFormulaShapePatternDecimal(patterns: string, decimalLength: number): string;
+export declare function getFormulaShapeCurrencyFormatOptions(symbol: string): {
+    label: string;
+    value: string;
+    color: string | undefined;
+}[];
+export declare function getFormulaShapeDateFormatOptions(): {
+    label: string;
+    value: string;
+}[];
+export declare function getFormulaShapeNumberFormatOptions(): {
+    label: string;
+    value: string;
+    color: string | undefined;
+}[];