import { IServiceID } from "../../../types/kernel.js"; import "../../../types/index.js"; import { LinkBlockCardNode } from "../node/LinkBlockCardNode.js"; import { LinkCardNode } from "../node/LinkCardNode.js"; import { LinkIframeNode } from "../node/LinkIframeNode.js"; import { LinkNode } from "../node/LinkNode.js"; import { SchemaNode } from "../node/SchemaNode.js"; import EventEmitter from "eventemitter3"; import { LexicalEditor, LexicalNode } from "lexical"; interface ParsedSchemaUrl { hash: string; host: string; params: Record; pathname: string; protocol: string; raw: string; search: string; } interface LinkRuleContext { editor: LexicalEditor; text: string; title: string; } interface LinkCardPayload { description?: string; icon?: string; openTarget?: null | string; title?: string; url?: string; } interface LinkIframePayload { src?: string; title?: string; url?: string; } interface SchemaPayload { payload?: unknown; schemaType?: string; title?: string; url?: string; } interface LinkEmbedRule { allowBlockCard?: boolean; allowCard?: boolean; allowIframe?: boolean; getCardPayload?: (url: string, context: LinkRuleContext) => LinkCardPayload | Promise; getIframePayload?: (url: string, context: LinkRuleContext) => LinkIframePayload; id: string; match: (url: string, context: LinkRuleContext) => boolean; } interface SchemaRule { id: string; match: (url: string, context: LinkRuleContext & { schema: ParsedSchemaUrl | null; }) => boolean; parse?: (url: string, schema: ParsedSchemaUrl | null) => SchemaPayload | unknown; } interface LinkLabels { convertToBlockCard: string; convertToCard: string; convertToIframe: string; convertToLink: string; convertToSchema: string; } type LinkToolbarNode = LinkNode | LinkCardNode | LinkBlockCardNode | LinkIframeNode | SchemaNode; interface LinkToolbarActionContext { editor: LexicalEditor; node: LinkToolbarNode; } interface LinkToolbarAction { icon?: unknown; key: string; label: string; onClick: (context: LinkToolbarActionContext) => void; visible?: (context: LinkToolbarActionContext) => boolean; } /** @deprecated Use schemaRules with SchemaNode instead. React rendering lives in the React plugin. */ interface SchemaLinkRendererConfig { protocol: string; } interface LinkServiceConfig { allowedProtocols?: string[]; labels?: Partial; linkEmbedRules?: LinkEmbedRule[]; schemaLinkRenderers?: SchemaLinkRendererConfig[]; schemaRules?: SchemaRule[]; toolbarActions?: LinkToolbarAction[]; } type LinkToolbarItemIcon = 'copy' | 'edit' | 'open' | 'unlink'; interface LinkToolbarRenderContext { close: () => void; editor: LexicalEditor; linkDom: HTMLElement | null; linkNode: LinkNode; } interface LinkToolbarItem { icon: LinkToolbarItemIcon; key: string; label: string | ((context: LinkToolbarRenderContext) => string); onClick: (context: LinkToolbarRenderContext) => void | Promise; order?: number; when?: (context: LinkToolbarRenderContext) => boolean; } interface ILinkService { readonly enableLinkToolbar: boolean; getAllowedProtocols(): Set; getEmbedRule(url: string, context: LinkRuleContext): LinkEmbedRule | null; getLabels(): LinkLabels; getSchemaRule(url: string, context: LinkRuleContext & { schema?: ParsedSchemaUrl | null; }): SchemaRule | null; getToolbarActions(context: LinkToolbarActionContext): LinkToolbarAction[]; getToolbarItems(context: LinkToolbarRenderContext): LinkToolbarItem[]; hasSchemaLinkRenderer(url: string): boolean; isCardMetadataLoading(nodeKey: string): boolean; parseSchemaUrl(url: string): ParsedSchemaUrl | null; registerToolbarItem(item: LinkToolbarItem): () => void; restoreLinkToolbar(token: symbol): void; setLinkToolbar(enable: boolean): void; subscribe(listener: () => void): () => void; subscribeCardMetadata(listener: () => void): () => void; suppressLinkToolbar(reason?: string): symbol; updateConfig(config?: LinkServiceConfig): void; } declare const ILinkService: IServiceID; declare class LinkService extends EventEmitter<'cardMetadataChange' | 'change' | 'linkToolbarChange'> implements ILinkService { private cardMetadataLoadingKeys; private protocolPolicy; private legacySchemaLinkRegistry; private ruleRegistry; private toolbarController; private toolbarItems; get enableLinkToolbar(): boolean; getAllowedProtocols(): Set; getEmbedRule(url: string, context: LinkRuleContext): LinkEmbedRule | null; getLabels(): LinkLabels; hasSchemaLinkRenderer(url: string): boolean; isCardMetadataLoading(nodeKey: string): boolean; setCardMetadataLoading(nodeKey: string, loading: boolean): void; getSchemaRule(url: string, context: LinkRuleContext & { schema?: ParsedSchemaUrl | null; }): SchemaRule | null; getToolbarActions(context: LinkToolbarActionContext): LinkToolbarAction[]; parseSchemaUrl(url: string): ParsedSchemaUrl | null; updateConfig(config?: LinkServiceConfig): void; setAllowedProtocols(protocols: string[]): void; setEmbedRules(rules?: LinkEmbedRule[]): void; setLabels(labels?: Partial): void; setSchemaLinkRenderers(renderers?: SchemaLinkRendererConfig[]): void; setSchemaRules(rules?: SchemaRule[]): void; setToolbarActions(actions?: LinkToolbarAction[]): void; getToolbarItems(context: LinkToolbarRenderContext): LinkToolbarItem[]; registerToolbarItem(item: LinkToolbarItem): () => void; setLinkToolbar(enable: boolean): void; suppressLinkToolbar(reason?: string): symbol; restoreLinkToolbar(token: symbol): void; subscribe(listener: () => void): () => void; subscribeCardMetadata(listener: () => void): () => void; } declare function normalizeProtocol(protocol: string): string; declare function getNodeUrl(node: LexicalNode): string; declare function getNodeTitle(node: LexicalNode): string; export { ILinkService, LinkCardPayload, LinkEmbedRule, LinkIframePayload, LinkLabels, LinkRuleContext, LinkService, LinkServiceConfig, LinkToolbarAction, LinkToolbarActionContext, LinkToolbarItem, LinkToolbarItemIcon, LinkToolbarNode, LinkToolbarRenderContext, ParsedSchemaUrl, SchemaLinkRendererConfig, SchemaPayload, SchemaRule, getNodeTitle, getNodeUrl, normalizeProtocol };