@clevertask/scribe 0.1.13 → 0.1.14

package/dist/components/Menu/LinkEditor.js

@@ -1,132 +1,185 @@
-import { normalizeLinkUrl as e } from "./linkUrl.js";
-import { Box as t, Button as n, Flex as r, Text as i, TextField as a } from "@radix-ui/themes";
-import { useCallback as o, useEffect as s, useId as c, useState as l } from "react";
-import { jsx as u, jsxs as d } from "react/jsx-runtime";
+import e from "./ExternalLinkDisplayOptions.js";
+import { normalizeLinkUrl as t } from "./linkUrl.js";
+import { Box as n, Button as r, Flex as i, Text as a, TextField as o } from "@radix-ui/themes";
+import { useCallback as s, useEffect as c, useId as l, useState as u } from "react";
+import { jsx as d, jsxs as f } from "react/jsx-runtime";
 //#region lib/components/Menu/LinkEditor.tsx
-var f = ({ editor: f, existingHref: p, inputRef: m, onClose: h, onValueChange: g, selectTextblockEndAfterSave: _ = !1, value: v }) => {
-	let [y, b] = l(null), x = c(), S = e(v), C = o(() => {
-		b(null), h();
-	}, [h]);
-	s(() => {
-		b(null);
-	}, [p]);
-	let w = o((e) => {
-		b(null), g(e);
-	}, [g]), T = o((t) => {
-		t.preventDefault();
-		let n = e(v);
+var p = ({ canRefreshPreview: p = !1, currentDisplay: m = "plain", editor: h, existingHref: g, inputRef: _, onClose: v, onRefreshPreview: y, onValueChange: b, previewStatus: x = "idle", previewStatusLabel: S, resetToken: C, selectTextblockEndAfterSave: w = !1, targetPosition: T, value: E }) => {
+	let [D, O] = u(null), k = l(), A = t(E), j = s(() => {
+		O(null), v();
+	}, [v]);
+	c(() => {
+		O(null);
+	}, [g, C]);
+	let M = s((e) => {
+		O(null), b(e);
+	}, [b]), N = s((e) => {
+		e.preventDefault();
+		let n = m !== "plain" && E === g ? g : t(E);
 		if (!n) {
-			b("Enter a valid web address or root-relative path.");
+			O("Enter a valid web address or root-relative path.");
 			return;
 		}
-		let r = f.chain().focus().extendMarkRange("link").setLink({ href: n });
-		if (_ && r.selectTextblockEnd(), !r.run()) {
-			b("Scribe could not save this link.");
+		if (m !== "plain") {
+			if (!(h.can().updateExternalLinkPreview({ href: n }, T) && h.chain().focus().updateExternalLinkPreview({ href: n }, T).run())) {
+				O("This URL can't be used as a preview. Choose Plain link to keep this destination.");
+				return;
+			}
+			j();
 			return;
 		}
-		C();
+		let r = h.chain().focus().extendMarkRange("link").setLink({ href: n });
+		if (w && r.selectTextblockEnd(), !r.run()) {
+			O("Scribe could not save this link.");
+			return;
+		}
+		j();
 	}, [
-		f,
-		C,
-		_,
-		v
-	]), E = o(() => {
-		if (!f.chain().focus().extendMarkRange("link").unsetLink().run()) {
-			b("Scribe could not remove this link.");
+		m,
+		h,
+		g,
+		j,
+		w,
+		T,
+		E
+	]), P = s(() => {
+		if (!h.chain().focus().extendMarkRange("link").unsetLink().run()) {
+			O("Scribe could not remove this link.");
 			return;
 		}
-		C();
-	}, [f, C]), D = o((e) => {
-		e.key === "Escape" && (e.preventDefault(), e.stopPropagation(), C());
-	}, [C]);
-	return /* @__PURE__ */ u("form", {
-		onKeyDown: D,
-		onSubmit: T,
-		children: /* @__PURE__ */ d(r, {
+		j();
+	}, [h, j]), F = E !== g, I = x === "loading" || F, L = s(() => {
+		I || y?.();
+	}, [I, y]), R = s((e) => {
+		let n = t(E);
+		if (!n) return O("Enter a valid external web address before changing its display."), !1;
+		let r = !1;
+		return r = m === "plain" ? h.chain().focus().extendMarkRange("link").setLink({ href: n }).setExternalLinkDisplay(e).run() : e === "plain" ? h.commands.convertExternalLinkPreviewToPlain(n, T) : h.can().updateExternalLinkPreview({ href: n }, T) && h.chain().focus().updateExternalLinkPreview({ href: n }, T).setExternalLinkDisplay(e, T).run(), r ? !0 : (O(e === "plain" ? "Scribe could not update this link." : "This link can't use Compact or Preview card."), !1);
+	}, [
+		m,
+		h,
+		T,
+		E
+	]), z = s((e) => {
+		e.key === "Escape" && (e.preventDefault(), e.stopPropagation(), j());
+	}, [j]);
+	return /* @__PURE__ */ d("form", {
+		onKeyDown: z,
+		onSubmit: N,
+		children: /* @__PURE__ */ f(i, {
 			direction: "column",
 			gap: "4",
 			children: [
-				/* @__PURE__ */ d(t, { children: [/* @__PURE__ */ u(i, {
+				/* @__PURE__ */ f(n, { children: [/* @__PURE__ */ d(a, {
 					as: "p",
 					size: "3",
 					weight: "medium",
 					children: "Link"
-				}), /* @__PURE__ */ u(i, {
+				}), /* @__PURE__ */ d(a, {
 					as: "p",
 					size: "2",
 					color: "gray",
 					children: "Add or update a link for the current selection."
 				})] }),
-				/* @__PURE__ */ u("label", { children: /* @__PURE__ */ d(r, {
+				/* @__PURE__ */ d("label", { children: /* @__PURE__ */ f(i, {
 					direction: "column",
 					gap: "2",
-					children: [/* @__PURE__ */ u(i, {
+					children: [/* @__PURE__ */ d(a, {
 						as: "span",
 						size: "2",
 						weight: "medium",
 						children: "URL"
-					}), /* @__PURE__ */ u(a.Root, {
-						ref: m,
-						"aria-describedby": y ? x : void 0,
-						"aria-invalid": !!y,
-						autoFocus: !m,
+					}), /* @__PURE__ */ d(o.Root, {
+						ref: _,
+						"aria-describedby": D ? k : void 0,
+						"aria-invalid": !!D,
+						autoFocus: !_,
 						placeholder: "https://example.com",
-						value: v,
-						onChange: (e) => w(e.target.value)
+						value: E,
+						onChange: (e) => M(e.target.value)
 					})]
 				}) }),
-				y ? /* @__PURE__ */ u(i, {
-					id: x,
+				D ? /* @__PURE__ */ d(a, {
+					id: k,
 					as: "p",
 					role: "alert",
 					size: "2",
 					color: "red",
-					children: y
+					children: D
 				}) : null,
-				/* @__PURE__ */ d(r, {
+				/* @__PURE__ */ d(e, {
+					currentDisplay: m,
+					editor: h,
+					executeDisplayChange: F ? R : void 0,
+					onDisplayChange: j,
+					targetPosition: T
+				}),
+				m === "plain" ? null : /* @__PURE__ */ f(i, {
+					align: "center",
+					justify: "between",
+					gap: "2",
+					wrap: "wrap",
+					children: [/* @__PURE__ */ d(a, {
+						as: "span",
+						role: "status",
+						"aria-live": "polite",
+						size: "1",
+						color: x === "error" ? "red" : "gray",
+						children: x === "loading" ? "Loading preview…" : x === "error" ? "Preview unavailable" : S
+					}), p && y ? /* @__PURE__ */ d(r, {
+						type: "button",
+						color: "gray",
+						variant: "soft",
+						"aria-disabled": I,
+						"data-disabled": I ? "" : void 0,
+						onClick: L,
+						children: "Refresh preview"
+					}) : null]
+				}),
+				/* @__PURE__ */ f(i, {
 					justify: "between",
 					gap: "3",
 					wrap: "wrap",
-					children: [/* @__PURE__ */ u(n, {
+					children: [m === "plain" ? /* @__PURE__ */ d(r, {
 						type: "button",
 						color: "red",
 						variant: "soft",
-						disabled: !p,
-						onClick: E,
+						disabled: !g,
+						onClick: P,
 						children: "Remove link"
-					}), /* @__PURE__ */ d(r, {
+					}) : null, /* @__PURE__ */ f(i, {
 						gap: "2",
 						justify: "end",
 						style: { marginLeft: "auto" },
 						wrap: "wrap",
 						children: [
-							S ? /* @__PURE__ */ u(n, {
+							A ? /* @__PURE__ */ d(r, {
 								asChild: !0,
 								variant: "soft",
 								color: "gray",
-								children: /* @__PURE__ */ u("a", {
-									href: S,
+								children: /* @__PURE__ */ d("a", {
+									href: A,
 									target: "_blank",
 									rel: "noopener noreferrer",
 									children: "Open link"
 								})
-							}) : /* @__PURE__ */ u(n, {
+							}) : /* @__PURE__ */ d(r, {
 								type: "button",
 								variant: "soft",
 								color: "gray",
 								disabled: !0,
 								children: "Open link"
 							}),
-							/* @__PURE__ */ u(n, {
+							/* @__PURE__ */ d(r, {
 								type: "button",
 								variant: "soft",
 								color: "gray",
-								onClick: C,
+								onClick: j,
 								children: "Cancel"
 							}),
-							/* @__PURE__ */ u(n, {
+							/* @__PURE__ */ d(r, {
 								type: "submit",
-								disabled: v.trim().length === 0,
+								disabled: E.trim().length === 0,
 								children: "Save"
 							})
 						]
@@ -137,4 +190,4 @@ var f = ({ editor: f, existingHref: p, inputRef: m, onClose: h, onValueChange: g
 	});
 };
 //#endregion
-export { f as default };
+export { p as default };

package/dist/components/Menu/Mobile/ListOptionBar.js

@@ -1,4 +1,4 @@
-import { a as e } from "../../../dist-BoYfa2nz.js";
+import { s as e } from "../../../dist-DDjaA1Pn.js";
 import { Button as t, Flex as n } from "@radix-ui/themes";
 import { useCallback as r } from "react";
 import { jsx as i, jsxs as a } from "react/jsx-runtime";

package/dist/components/Menu/TableBubbleMenu.js

@@ -1,6 +1,6 @@
-import { a as e } from "../../dist-BoYfa2nz.js";
+import { s as e } from "../../dist-DDjaA1Pn.js";
 import { getPopupMountTarget as t } from "../Scribe/extension/getPopupMountTarget.js";
-import { t as n } from "../../menus-B1Zz0GjH.js";
+import { t as n } from "../../menus-U2HdvQnu.js";
 import { getSelectionTableContext as r, tableBubbleMenuPluginKey as i } from "./tableBubbleMenuPlugin.js";
 import { getSelectionContextualMenuOwner as a } from "./contextualMenuOwner.js";
 import { Flex as o, IconButton as s, Separator as c } from "@radix-ui/themes";

package/dist/components/Menu/contextualMenuOwner.d.ts

@@ -1,4 +1,4 @@
 import type { EditorState } from "@tiptap/pm/state";
-export type ContextualMenuOwner = "callout" | "table";
+export type ContextualMenuOwner = "callout" | "link" | "table";
 export declare const getSelectionContextualMenuOwner: (state: EditorState) => ContextualMenuOwner | null;
 //# sourceMappingURL=contextualMenuOwner.d.ts.map

package/dist/components/Menu/contextualMenuOwner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contextualMenuOwner.d.ts","sourceRoot":"","sources":["../../../lib/components/Menu/contextualMenuOwner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD,eAAO,MAAM,+BAA+B,UAAW,WAAW,KAAG,mBAAmB,GAAG,IAa1F,CAAC"}
+{"version":3,"file":"contextualMenuOwner.d.ts","sourceRoot":"","sources":["../../../lib/components/Menu/contextualMenuOwner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAKpD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/D,eAAO,MAAM,+BAA+B,UAAW,WAAW,KAAG,mBAAmB,GAAG,IAyB1F,CAAC"}

package/dist/components/Menu/contextualMenuOwner.js

@@ -1,9 +1,12 @@
-import { getSelectionCalloutContext as e } from "./calloutBubbleMenuPlugin.js";
-import { getSelectionTableContext as t } from "./tableBubbleMenuPlugin.js";
+import { getSelectionLinkContext as e } from "./linkBubbleMenuPlugin.js";
+import { getSelectionCalloutContext as t } from "./calloutBubbleMenuPlugin.js";
+import { getSelectionTableContext as n } from "./tableBubbleMenuPlugin.js";
 //#region lib/components/Menu/contextualMenuOwner.ts
-var n = (n) => {
-	let r = e(n), i = t(n);
-	return r ? i ? r.position > i.position ? "callout" : "table" : "callout" : i ? "table" : null;
+var r = (r) => {
+	let i = e(r);
+	if (i?.kind === "preview" || i?.kind === "plain" && !r.selection.empty && r.selection.from === i.from && r.selection.to === i.to) return "link";
+	let a = t(r), o = n(r);
+	return a ? o ? a.position > o.position ? "callout" : "table" : "callout" : o ? "table" : null;
 };
 //#endregion
-export { n as getSelectionContextualMenuOwner };
+export { r as getSelectionContextualMenuOwner };

package/dist/components/Menu/linkBubbleMenuPlugin.d.ts

@@ -1,6 +1,29 @@
+import type { EditorState } from "@tiptap/pm/state";
 import { PluginKey } from "@tiptap/pm/state";
 import { Editor } from "@tiptap/react";
+import type { ExternalLinkPreviewAttributes, ExternalLinkPreviewDisplay } from "../Scribe/extension/external-link-preview/types";
+export type LinkBubbleMenuFocusTarget = "dialog" | "url";
+export type LinkBubbleMenuContext = {
+    display: "plain";
+    from: number;
+    href: string;
+    kind: "plain";
+    to: number;
+} | {
+    attributes: ExternalLinkPreviewAttributes;
+    display: ExternalLinkPreviewDisplay;
+    from: number;
+    href: string;
+    kind: "preview";
+    position: number;
+    to: number;
+};
 export declare const linkBubbleMenuPluginKey: PluginKey<any>;
-export declare const showLinkBubbleMenu: (editor: Editor) => void;
+export declare const getPlainLinkContextAtPosition: (state: EditorState, position: number) => Extract<LinkBubbleMenuContext, {
+    kind: "plain";
+}> | null;
+export declare const getSelectionLinkContext: (state: EditorState) => LinkBubbleMenuContext | null;
+export declare const consumeLinkBubbleMenuFocusTarget: (editor: Editor) => LinkBubbleMenuFocusTarget;
+export declare const showLinkBubbleMenu: (editor: Editor, focusTarget?: LinkBubbleMenuFocusTarget) => void;
 export declare const hideLinkBubbleMenu: (editor: Editor) => void;
 //# sourceMappingURL=linkBubbleMenuPlugin.d.ts.map

package/dist/components/Menu/linkBubbleMenuPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linkBubbleMenuPlugin.d.ts","sourceRoot":"","sources":["../../../lib/components/Menu/linkBubbleMenuPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,eAAO,MAAM,uBAAuB,gBAAwC,CAAC;AAE7E,eAAO,MAAM,kBAAkB,WAAY,MAAM,SAahD,CAAC;AAEF,eAAO,MAAM,kBAAkB,WAAY,MAAM,SAMhD,CAAC"}
+{"version":3,"file":"linkBubbleMenuPlugin.d.ts","sourceRoot":"","sources":["../../../lib/components/Menu/linkBubbleMenuPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAiB,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAKvC,OAAO,KAAK,EACV,6BAA6B,EAC7B,0BAA0B,EAC3B,MAAM,iDAAiD,CAAC;AAEzD,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzD,MAAM,MAAM,qBAAqB,GAC7B;IACE,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,UAAU,EAAE,6BAA6B,CAAC;IAC1C,OAAO,EAAE,0BAA0B,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEN,eAAO,MAAM,uBAAuB,gBAAwC,CAAC;AAG7E,eAAO,MAAM,6BAA6B,UACjC,WAAW,YACR,MAAM,KACf,OAAO,CAAC,qBAAqB,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,IAqCtD,CAAC;AAEF,eAAO,MAAM,uBAAuB,UAAW,WAAW,KAAG,qBAAqB,GAAG,IAiCpF,CAAC;AAEF,eAAO,MAAM,gCAAgC,WAAY,MAAM,8BAM9D,CAAC;AAEF,eAAO,MAAM,kBAAkB,WACrB,MAAM,gBACD,yBAAyB,SAevC,CAAC;AAEF,eAAO,MAAM,kBAAkB,WAAY,MAAM,SAMhD,CAAC"}

package/dist/components/Menu/linkBubbleMenuPlugin.js

@@ -1,9 +1,46 @@
-import { PluginKey as e } from "@tiptap/pm/state";
+import { v as e } from "../../dist-tNcpTcFT.js";
+import { normalizeExternalLinkPreviewAttributes as t } from "../Scribe/extension/external-link-preview/attributes.js";
+import { NodeSelection as n, PluginKey as r } from "@tiptap/pm/state";
 //#region lib/components/Menu/linkBubbleMenuPlugin.ts
-var t = new e("scribeLinkBubbleMenu"), n = (e) => {
-	e.isDestroyed || (e.view.dispatch(e.state.tr.setMeta(t, "show")), !e.isDestroyed && e.view.dispatch(e.state.tr.setMeta(t, "updatePosition")));
-}, r = (e) => {
-	e.isDestroyed || e.view.dispatch(e.state.tr.setMeta(t, "hide"));
+var i = new r("scribeLinkBubbleMenu"), a = /* @__PURE__ */ new WeakMap(), o = (t, n) => {
+	let r = t.schema.marks.link;
+	if (!r || !Number.isInteger(n) || n < 0 || n > t.doc.content.size) return null;
+	let i = t.doc.resolve(n);
+	if (!i.parent.isTextblock) return null;
+	let a = e(i, r);
+	if (!a) return null;
+	let o = t.doc.nodeAt(a.from)?.marks.find((e) => e.type === r), s = typeof o?.attrs.href == "string" ? o.attrs.href : "";
+	return s ? {
+		display: "plain",
+		from: a.from,
+		href: s,
+		kind: "plain",
+		to: a.to
+	} : null;
+}, s = (e) => {
+	let { selection: r } = e;
+	if (r instanceof n && r.node.type.name === "externalLinkPreview") {
+		let e = t(r.node.attrs);
+		return e ? {
+			attributes: e,
+			display: e.display,
+			from: r.from,
+			href: e.href,
+			kind: "preview",
+			position: r.from,
+			to: r.to
+		} : null;
+	}
+	if (!r.$from.sameParent(r.$to)) return null;
+	let i = o(e, r.from);
+	return !i || r.from < i.from || r.to > i.to ? null : i;
+}, c = (e) => {
+	let t = a.get(e) ?? "url";
+	return a.delete(e), t;
+}, l = (e, t = "url") => {
+	e.isDestroyed || (a.set(e, t), e.view.dispatch(e.state.tr.setMeta(i, "show")), !e.isDestroyed && e.view.dispatch(e.state.tr.setMeta(i, "updatePosition")));
+}, u = (e) => {
+	e.isDestroyed || e.view.dispatch(e.state.tr.setMeta(i, "hide"));
 };
 //#endregion
-export { r as hideLinkBubbleMenu, t as linkBubbleMenuPluginKey, n as showLinkBubbleMenu };
+export { c as consumeLinkBubbleMenuFocusTarget, o as getPlainLinkContextAtPosition, s as getSelectionLinkContext, u as hideLinkBubbleMenu, i as linkBubbleMenuPluginKey, l as showLinkBubbleMenu };

package/dist/components/Scribe/extension/callout.js

@@ -1,4 +1,4 @@
-import { O as e, P as t, a as n } from "../../../dist-W9E-K577.js";
+import { A as e, L as t, a as n } from "../../../dist-tNcpTcFT.js";
 import { TextSelection as r } from "@tiptap/pm/state";
 //#region lib/components/Scribe/extension/callout.ts
 var i = [

package/dist/components/Scribe/extension/emoji/suggest.js

@@ -1,4 +1,4 @@
-import { n as e } from "../../../../dist-BoYfa2nz.js";
+import { i as e } from "../../../../dist-DDjaA1Pn.js";
 import { getPopupMountTarget as t } from "../getPopupMountTarget.js";
 import { t as n } from "../../../../tippy.esm-DOXqN1Qm.js";
 import { EmojiList as r } from "./EmojiList.js";

package/dist/components/Scribe/extension/extension-link.js

@@ -1,2 +1,2 @@
-import { t as e } from "../../../extension-link-D8Zi7OSa.js";
+import { t as e } from "../../../extension-link-RYtPpHwt.js";
 export { e as default };

package/dist/components/Scribe/extension/extension-markdown-paste.js

@@ -1,5 +1,5 @@
-import { n as e } from "../../../dist-W9E-K577.js";
-import { n as t, t as n } from "../../../markdown-to-html-CW0Nb9Ye.js";
+import { n as e } from "../../../dist-tNcpTcFT.js";
+import { n as t, t as n } from "../../../markdown-to-html-B-KKCZRs.js";
 import { Plugin as r, PluginKey as i } from "@tiptap/pm/state";
 //#region lib/components/Scribe/extension/extension-markdown-paste.ts
 var a = new i("markdownPaste"), o = /* @__PURE__ */ new Set([

package/dist/components/Scribe/extension/extension-selectedText.js

@@ -1,4 +1,4 @@
-import { n as e } from "../../../dist-W9E-K577.js";
+import { n as e } from "../../../dist-tNcpTcFT.js";
 //#region lib/components/Scribe/extension/extension-selectedText.ts
 var t = e.create({
 	name: "SelectedText",

package/dist/components/Scribe/extension/external-link-preview/attributes.d.ts

@@ -0,0 +1,18 @@
+import { type ExternalLinkPreviewAttributes, type ExternalLinkPreviewDisplay, type ExternalLinkPreviewMetadata } from "./types";
+/** @experimental Part of Scribe's evolving external-link-preview contract. */
+export declare const EXTERNAL_LINK_PREVIEW_NODE_NAME = "externalLinkPreview";
+export declare const EXTERNAL_LINK_PREVIEW_SELECTOR = "span[data-type=\"external-link-preview\"]";
+export declare const EXTERNAL_LINK_PREVIEW_TARGET_SELECTOR = "a[data-link-preview-target]";
+export declare const isExternalLinkPreviewDisplay: (value: unknown) => value is ExternalLinkPreviewDisplay;
+export declare const normalizeExternalLinkPreviewLinkText: (value: unknown) => string | null;
+/** Validate an authored preview destination without canonicalizing or removing query parameters. */
+export declare const normalizeExternalLinkPreviewHref: (value: unknown) => string | null;
+/** Preview media may be proxied by a consumer through a strict root-relative path. */
+export declare const normalizeExternalLinkPreviewMediaUrl: (value: unknown) => string | null;
+export declare const normalizeExternalLinkPreviewMetadata: (metadata: ExternalLinkPreviewMetadata | Record<string, unknown> | null | undefined) => Required<ExternalLinkPreviewMetadata>;
+/** Normalize only metadata fields that a resolver deliberately returned. */
+export declare const normalizeExternalLinkPreviewMetadataPatch: (metadata: ExternalLinkPreviewMetadata) => Partial<Required<ExternalLinkPreviewMetadata>>;
+export declare const normalizeExternalLinkPreviewAttributes: (input: Partial<Record<keyof ExternalLinkPreviewAttributes, unknown>>) => ExternalLinkPreviewAttributes | null;
+export declare const getExternalLinkPreviewHostname: (href: string) => string;
+export declare const getExternalLinkPreviewTitle: (attributes: Pick<ExternalLinkPreviewAttributes, "href" | "pageTitle" | "siteName">) => string;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/components/Scribe/extension/external-link-preview/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../../../lib/components/Scribe/extension/external-link-preview/attributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EACjC,MAAM,SAAS,CAAC;AA8CjB,8EAA8E;AAC9E,eAAO,MAAM,+BAA+B,wBAAwB,CAAC;AACrE,eAAO,MAAM,8BAA8B,8CAA4C,CAAC;AACxF,eAAO,MAAM,qCAAqC,gCAAgC,CAAC;AAEnF,eAAO,MAAM,4BAA4B,UAAW,OAAO,KAAG,KAAK,IAAI,0BAC2B,CAAC;AAwBnG,eAAO,MAAM,oCAAoC,UAAW,OAAO,KAAG,MAAM,GAAG,IACE,CAAC;AAElF,oGAAoG;AACpG,eAAO,MAAM,gCAAgC,UAAW,OAAO,KAAG,MAAM,GAAG,IAuB1E,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,oCAAoC,UAAW,OAAO,KAAG,MAAM,GAAG,IAwB9E,CAAC;AAcF,eAAO,MAAM,oCAAoC,aACrC,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KACjF,QAAQ,CAAC,2BAA2B,CAOrC,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,yCAAyC,aAC1C,2BAA2B,KACpC,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAW/C,CAAC;AAEF,eAAO,MAAM,sCAAsC,UAC1C,OAAO,CAAC,MAAM,CAAC,MAAM,6BAA6B,EAAE,OAAO,CAAC,CAAC,KACnE,6BAA6B,GAAG,IAgBlC,CAAC;AAEF,eAAO,MAAM,8BAA8B,SAAU,MAAM,WAM1D,CAAC;AAEF,eAAO,MAAM,2BAA2B,eAC1B,IAAI,CAAC,6BAA6B,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC,WACe,CAAC"}

package/dist/components/Scribe/extension/external-link-preview/attributes.js

@@ -0,0 +1,82 @@
+import { EXTERNAL_LINK_PREVIEW_DISPLAYS as e } from "./types.js";
+//#region lib/components/Scribe/extension/external-link-preview/attributes.ts
+var t = /^\/(?![\\/])/, n = /^https?:\/\//i, r = 16384, i = 16384, a = 512, o = 2048, s = 256, c = 16384, l = 128, u = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/, d = [
+	"pageTitle",
+	"description",
+	"siteName",
+	"faviconUrl",
+	"imageUrl",
+	"fetchedAt"
+], f = (e) => {
+	for (let t of e) {
+		let e = t.charCodeAt(0);
+		if (e <= 31 || e === 127) return !0;
+	}
+	return !1;
+}, p = (e) => {
+	let t = e.indexOf("//") + 2, n = [
+		"/",
+		"?",
+		"#"
+	].map((n) => e.indexOf(n, t)).filter((e) => e >= 0), r = n.length ? Math.min(...n) : e.length;
+	return e.slice(t, r).includes("@");
+}, m = "externalLinkPreview", h = "span[data-type=\"external-link-preview\"]", g = "a[data-link-preview-target]", _ = (t) => typeof t == "string" && e.some((e) => e === t), v = (e, t, { preserveWhitespace: n = !1 } = {}) => {
+	if (typeof e != "string") return null;
+	let r = n ? e : e.trim();
+	return !r.trim() || r.length > t || f(r) ? null : r;
+}, y = (e) => v(e, i, { preserveWhitespace: !0 }), b = (e) => {
+	let t = v(e, r);
+	if (!t || t.includes("\\") || !n.test(t) || p(t)) return null;
+	try {
+		let e = new URL(t);
+		return e.protocol !== "http:" && e.protocol !== "https:" || e.username || e.password ? null : t;
+	} catch {
+		return null;
+	}
+}, x = (e) => {
+	let r = v(e, c);
+	if (!r || r.includes("\\")) return null;
+	if (t.test(r)) return r;
+	if (!n.test(r) || p(r)) return null;
+	try {
+		let e = new URL(r);
+		return (e.protocol === "http:" || e.protocol === "https:") && !e.username && !e.password ? r : null;
+	} catch {
+		return null;
+	}
+}, S = (e) => {
+	let t = v(e, l);
+	if (!t || !u.test(t)) return null;
+	let n = new Date(t);
+	return Number.isNaN(n.getTime()) ? null : n.toISOString();
+}, C = (e) => ({
+	pageTitle: v(e?.pageTitle, a),
+	description: v(e?.description, o),
+	siteName: v(e?.siteName, s),
+	faviconUrl: x(e?.faviconUrl),
+	imageUrl: x(e?.imageUrl),
+	fetchedAt: S(e?.fetchedAt)
+}), w = (e) => {
+	let t = C(e), n = {};
+	return d.forEach((r) => {
+		Object.prototype.hasOwnProperty.call(e, r) && e[r] !== void 0 && (n[r] = t[r]);
+	}), n;
+}, T = (e) => {
+	let t = b(e.href);
+	if (!t) return null;
+	let n = C(e);
+	return {
+		href: t,
+		linkText: y(e.linkText) ?? t,
+		display: _(e.display) ? e.display : "compact",
+		...n
+	};
+}, E = (e) => {
+	try {
+		return new URL(e).hostname;
+	} catch {
+		return e;
+	}
+}, D = (e) => e.pageTitle || e.siteName || E(e.href);
+//#endregion
+export { m as EXTERNAL_LINK_PREVIEW_NODE_NAME, h as EXTERNAL_LINK_PREVIEW_SELECTOR, g as EXTERNAL_LINK_PREVIEW_TARGET_SELECTOR, E as getExternalLinkPreviewHostname, D as getExternalLinkPreviewTitle, _ as isExternalLinkPreviewDisplay, T as normalizeExternalLinkPreviewAttributes, b as normalizeExternalLinkPreviewHref, y as normalizeExternalLinkPreviewLinkText, x as normalizeExternalLinkPreviewMediaUrl, C as normalizeExternalLinkPreviewMetadata, w as normalizeExternalLinkPreviewMetadataPatch };

package/dist/components/Scribe/extension/external-link-preview/commands.d.ts

@@ -0,0 +1,53 @@
+import type { Node as ProseMirrorNode } from "@tiptap/pm/model";
+import type { Transaction } from "@tiptap/pm/state";
+import type { ExternalLinkDisplay, ExternalLinkPreviewAttributes, InsertExternalLinkPreviewOptions, UpdateExternalLinkPreviewOptions } from "./types";
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        externalLinkPreview: {
+            /** Insert an enhanced external link at the current selection. */
+            insertExternalLinkPreview: (options: InsertExternalLinkPreviewOptions) => ReturnType;
+            /** Convert the selected enhanced link or full-line Link mark to another presentation. */
+            setExternalLinkDisplay: (display: ExternalLinkDisplay, targetPosition?: number) => ReturnType;
+            /** Atomically convert a preview to a Plain link while applying its edited destination. */
+            convertExternalLinkPreviewToPlain: (href: string, targetPosition?: number) => ReturnType;
+            /** Explicitly refresh metadata for the selected enhanced link. */
+            refreshExternalLinkPreview: (targetPosition?: number) => ReturnType;
+            /** Safely update the selected preview's destination, fallback text, or metadata. */
+            updateExternalLinkPreview: (options: UpdateExternalLinkPreviewOptions, targetPosition?: number) => ReturnType;
+        };
+    }
+}
+interface PreviewContext {
+    attributes: ExternalLinkPreviewAttributes;
+    node: ProseMirrorNode;
+    position: number;
+    isSoleTextblockContent: boolean;
+}
+export declare const getSelectedExternalLinkPreview: (transaction: Transaction, targetPosition?: number) => PreviewContext | null;
+export declare const createExternalLinkPreviewCommands: ({ resolveMetadata, shouldPreview, }: {
+    resolveMetadata: boolean;
+    shouldPreview?: (href: string) => boolean;
+}) => {
+    insertExternalLinkPreview: (options: InsertExternalLinkPreviewOptions) => ({ dispatch, tr }: {
+        dispatch?: (args?: unknown) => unknown;
+        tr: Transaction;
+    }) => boolean;
+    setExternalLinkDisplay: (display: ExternalLinkDisplay, targetPosition?: number) => ({ dispatch, tr }: {
+        dispatch?: (args?: unknown) => unknown;
+        tr: Transaction;
+    }) => boolean;
+    convertExternalLinkPreviewToPlain: (requestedHref: string, targetPosition?: number) => ({ dispatch, tr }: {
+        dispatch?: (args?: unknown) => unknown;
+        tr: Transaction;
+    }) => boolean;
+    refreshExternalLinkPreview: (targetPosition?: number) => ({ dispatch, tr }: {
+        dispatch?: (args?: unknown) => unknown;
+        tr: Transaction;
+    }) => boolean;
+    updateExternalLinkPreview: (options: UpdateExternalLinkPreviewOptions, targetPosition?: number) => ({ dispatch, tr }: {
+        dispatch?: (args?: unknown) => unknown;
+        tr: Transaction;
+    }) => boolean;
+};
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/components/Scribe/extension/external-link-preview/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../../lib/components/Scribe/extension/external-link-preview/commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAQ,IAAI,IAAI,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AASpD,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAE7B,gCAAgC,EAChC,gCAAgC,EACjC,MAAM,SAAS,CAAC;AAEjB,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,QAAQ,CAAC,UAAU;QAC3B,mBAAmB,EAAE;YACnB,iEAAiE;YACjE,yBAAyB,EAAE,CAAC,OAAO,EAAE,gCAAgC,KAAK,UAAU,CAAC;YACrF,yFAAyF;YACzF,sBAAsB,EAAE,CAAC,OAAO,EAAE,mBAAmB,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;YAC9F,0FAA0F;YAC1F,iCAAiC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;YACzF,kEAAkE;YAClE,0BAA0B,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;YACpE,oFAAoF;YACpF,yBAAyB,EAAE,CACzB,OAAO,EAAE,gCAAgC,EACzC,cAAc,CAAC,EAAE,MAAM,KACpB,UAAU,CAAC;SACjB,CAAC;KACH;CACF;AAED,UAAU,cAAc;IACtB,UAAU,EAAE,6BAA6B,CAAC;IAC1C,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAWD,eAAO,MAAM,8BAA8B,gBAC5B,WAAW,mBACP,MAAM,KACtB,cAAc,GAAG,IAyCnB,CAAC;AAkHF,eAAO,MAAM,iCAAiC,wCAG3C;IACD,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3C;IACC,yBAAyB,YACb,gCAAgC,wBACvB;QAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;QAAC,EAAE,EAAE,WAAW,CAAA;KAAE;IA4ChF,sBAAsB,YACV,mBAAmB,mBAAmB,MAAM,wBACnC;QAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;QAAC,EAAE,EAAE,WAAW,CAAA;KAAE;IAiFhF,iCAAiC,kBACf,MAAM,mBAAmB,MAAM,wBAC5B;QAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;QAAC,EAAE,EAAE,WAAW,CAAA;KAAE;IA+BhF,0BAA0B,oBACN,MAAM,wBACL;QAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;QAAC,EAAE,EAAE,WAAW,CAAA;KAAE;IAqBhF,yBAAyB,YACb,gCAAgC,mBAAmB,MAAM,wBAChD;QAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;QAAC,EAAE,EAAE,WAAW,CAAA;KAAE;CAsEhF,CAAC"}