feedscout 1.4.0 → 1.5.0

package/dist/common/uris/index.js

@@ -4,22 +4,25 @@ import { discoverUrisFromHtml } from "./html/index.js";
 import { discoverUrisFromPlatform } from "./platform/index.js";
 
 //#region src/common/uris/index.ts
-const discoverUris = (config, stopOnFirstMethod = false) => {
-	const uris = /* @__PURE__ */ new Set();
+const discoverUris = (config) => {
+	const result = {};
 	if (config.platform) {
-		for (const uri of discoverUrisFromPlatform(config.platform.html, config.platform.options)) uris.add(uri);
-		if (stopOnFirstMethod && uris.size > 0) return Array.from(uris);
+		const uris = discoverUrisFromPlatform(config.platform.html, config.platform.options);
+		if (uris.length > 0) result.platform = uris;
 	}
 	if (config.html) {
-		for (const uri of discoverUrisFromHtml(config.html.html, config.html.options)) uris.add(uri);
-		if (stopOnFirstMethod && uris.size > 0) return Array.from(uris);
+		const uris = discoverUrisFromHtml(config.html.html, config.html.options);
+		if (uris.length > 0) result.html = uris.map((uri) => ({ uri }));
 	}
 	if (config.headers) {
-		for (const uri of discoverUrisFromHeaders(config.headers.headers, config.headers.options)) uris.add(uri);
-		if (stopOnFirstMethod && uris.size > 0) return Array.from(uris);
+		const uris = discoverUrisFromHeaders(config.headers.headers, config.headers.options);
+		if (uris.length > 0) result.headers = uris.map((uri) => ({ uri }));
 	}
-	if (config.guess) for (const uri of discoverUrisFromGuess(config.guess.options)) uris.add(uri);
-	return Array.from(uris);
+	if (config.guess) {
+		const uris = discoverUrisFromGuess(config.guess.options);
+		if (uris.length > 0) result.guess = uris.map((uri) => ({ uri }));
+	}
+	return result;
 };
 
 //#endregion

package/dist/common/uris/platform/types.d.cts

@@ -1,7 +1,9 @@
+import { DiscoverUriEntry } from "../../types.cjs";
+
 //#region src/common/uris/platform/types.d.ts
 type PlatformHandler = {
   match: (url: string) => boolean;
-  resolve: (url: string, content?: string) => Array<string>;
+  resolve: (url: string, content?: string) => Array<DiscoverUriEntry>;
 };
 type PlatformMethodOptions = {
   baseUrl: string;

package/dist/common/uris/platform/types.d.ts

@@ -1,7 +1,9 @@
+import { DiscoverUriEntry } from "../../types.js";
+
 //#region src/common/uris/platform/types.d.ts
 type PlatformHandler = {
   match: (url: string) => boolean;
-  resolve: (url: string, content?: string) => Array<string>;
+  resolve: (url: string, content?: string) => Array<DiscoverUriEntry>;
 };
 type PlatformMethodOptions = {
   baseUrl: string;

package/dist/common/utils.cjs

@@ -1,5 +1,10 @@
+const require_locales = require('./locales.cjs');
 
 //#region src/common/utils.ts
+const composeHint = (key) => ({
+	key,
+	label: require_locales.hints[key]
+});
 const normalizeMimeType = (type) => {
 	return type.split(";")[0].trim().toLowerCase();
 };
@@ -57,6 +62,7 @@ const processConcurrently = async (items, processFn, options) => {
 
 //#endregion
 exports.anyWordMatchesAnyOf = anyWordMatchesAnyOf;
+exports.composeHint = composeHint;
 exports.endsWithAnyOf = endsWithAnyOf;
 exports.includesAnyOf = includesAnyOf;
 exports.isAnyOf = isAnyOf;

package/dist/common/utils.js

@@ -1,4 +1,10 @@
+import { hints } from "./locales.js";
+
 //#region src/common/utils.ts
+const composeHint = (key) => ({
+	key,
+	label: hints[key]
+});
 const normalizeMimeType = (type) => {
 	return type.split(";")[0].trim().toLowerCase();
 };
@@ -55,4 +61,4 @@ const processConcurrently = async (items, processFn, options) => {
 };
 
 //#endregion
-export { anyWordMatchesAnyOf, endsWithAnyOf, includesAnyOf, isAnyOf, isHostOf, isSubdomainOf, matchesAnyOfLinkSelectors, normalizeUrl, processConcurrently };
+export { anyWordMatchesAnyOf, composeHint, endsWithAnyOf, includesAnyOf, isAnyOf, isHostOf, isSubdomainOf, matchesAnyOfLinkSelectors, normalizeUrl, processConcurrently };

package/dist/feeds/defaults.cjs

@@ -17,6 +17,7 @@ const require_soundcloud = require('./platform/handlers/soundcloud.cjs');
 const require_substack = require('./platform/handlers/substack.cjs');
 const require_tumblr = require('./platform/handlers/tumblr.cjs');
 const require_wordpress = require('./platform/handlers/wordpress.cjs');
+const require_wpengine = require('./platform/handlers/wpengine.cjs');
 const require_youtube = require('./platform/handlers/youtube.cjs');
 
 //#region src/feeds/defaults.ts
@@ -59,19 +60,13 @@ const urisComprehensive = [
 	"/feed.atom",
 	"/feed.rss.xml",
 	"/feed.atom.xml",
-	"/feed/atom/",
-	"/feed/rss/",
-	"/feed/rss2/",
-	"/feed/rdf",
-	"/feed/rdf/",
+	["/feed/atom/", "?feed=atom"],
+	["/feed/rss/", "?feed=rss"],
+	["/feed/rss2/", "?feed=rss2"],
+	["/feed/rdf", "?feed=rdf"],
+	["/feed/rdf/", "?feed=rdf"],
 	"/index.rss.xml",
 	"/index.atom.xml",
-	"?feed=rss",
-	"?feed=rss2",
-	"?feed=atom",
-	"?feed=rdf",
-	"?feed=comments-rss2",
-	"?feed=comments-atom",
 	"?format=rss",
 	"?format=atom",
 	"?rss=1",
@@ -81,7 +76,10 @@ const urisComprehensive = [
 	"/f.rss",
 	"/json",
 	"/.feed",
-	"/comments/feed",
+	["/comments/feed", "?feed=comments-rss2"],
+	["/comments/feed/rss2/", "?feed=comments-rss2"],
+	["/comments/feed/rdf/", "?feed=comments-rdf"],
+	["/comments/feed/atom/", "?feed=comments-atom"],
 	"/feeds/posts/default",
 	"/feeds/posts/default?alt=rss",
 	"/feeds/comments/default"
@@ -102,7 +100,7 @@ const linkSelectors = [{
 }, { rel: "feed" }];
 const defaultHtmlOptions = {
 	linkSelectors,
-	anchorUris: urisComprehensive,
+	anchorUris: urisComprehensive.flat(),
 	anchorIgnoredUris: ignoredUris,
 	anchorLabels
 };
@@ -128,6 +126,7 @@ const defaultPlatformOptions = { handlers: [
 	require_substack.substackHandler,
 	require_tumblr.tumblrHandler,
 	require_wordpress.wordpressHandler,
+	require_wpengine.wpengineHandler,
 	require_youtube.youtubeHandler
 ] };
 

package/dist/feeds/defaults.d.cts

@@ -2,13 +2,13 @@ import { GuessMethodOptions } from "../common/uris/guess/types.cjs";
 import { HeadersMethodOptions } from "../common/uris/headers/types.cjs";
 import { HtmlMethodOptions } from "../common/uris/html/types.cjs";
 import { PlatformMethodOptions } from "../common/uris/platform/types.cjs";
-import { LinkSelector } from "../common/types.cjs";
+import { LinkSelector, UriEntry } from "../common/types.cjs";
 
 //#region src/feeds/defaults.d.ts
 declare const mimeTypes: string[];
 declare const urisMinimal: string[];
 declare const urisBalanced: string[];
-declare const urisComprehensive: string[];
+declare const urisComprehensive: Array<UriEntry>;
 declare const ignoredUris: string[];
 declare const anchorLabels: string[];
 declare const linkSelectors: Array<LinkSelector>;

package/dist/feeds/defaults.d.ts

@@ -2,13 +2,13 @@ import { GuessMethodOptions } from "../common/uris/guess/types.js";
 import { HeadersMethodOptions } from "../common/uris/headers/types.js";
 import { HtmlMethodOptions } from "../common/uris/html/types.js";
 import { PlatformMethodOptions } from "../common/uris/platform/types.js";
-import { LinkSelector } from "../common/types.js";
+import { LinkSelector, UriEntry } from "../common/types.js";
 
 //#region src/feeds/defaults.d.ts
 declare const mimeTypes: string[];
 declare const urisMinimal: string[];
 declare const urisBalanced: string[];
-declare const urisComprehensive: string[];
+declare const urisComprehensive: Array<UriEntry>;
 declare const ignoredUris: string[];
 declare const anchorLabels: string[];
 declare const linkSelectors: Array<LinkSelector>;

package/dist/feeds/defaults.js

@@ -17,6 +17,7 @@ import { soundcloudHandler } from "./platform/handlers/soundcloud.js";
 import { substackHandler } from "./platform/handlers/substack.js";
 import { tumblrHandler } from "./platform/handlers/tumblr.js";
 import { wordpressHandler } from "./platform/handlers/wordpress.js";
+import { wpengineHandler } from "./platform/handlers/wpengine.js";
 import { youtubeHandler } from "./platform/handlers/youtube.js";
 
 //#region src/feeds/defaults.ts
@@ -59,19 +60,13 @@ const urisComprehensive = [
 	"/feed.atom",
 	"/feed.rss.xml",
 	"/feed.atom.xml",
-	"/feed/atom/",
-	"/feed/rss/",
-	"/feed/rss2/",
-	"/feed/rdf",
-	"/feed/rdf/",
+	["/feed/atom/", "?feed=atom"],
+	["/feed/rss/", "?feed=rss"],
+	["/feed/rss2/", "?feed=rss2"],
+	["/feed/rdf", "?feed=rdf"],
+	["/feed/rdf/", "?feed=rdf"],
 	"/index.rss.xml",
 	"/index.atom.xml",
-	"?feed=rss",
-	"?feed=rss2",
-	"?feed=atom",
-	"?feed=rdf",
-	"?feed=comments-rss2",
-	"?feed=comments-atom",
 	"?format=rss",
 	"?format=atom",
 	"?rss=1",
@@ -81,7 +76,10 @@ const urisComprehensive = [
 	"/f.rss",
 	"/json",
 	"/.feed",
-	"/comments/feed",
+	["/comments/feed", "?feed=comments-rss2"],
+	["/comments/feed/rss2/", "?feed=comments-rss2"],
+	["/comments/feed/rdf/", "?feed=comments-rdf"],
+	["/comments/feed/atom/", "?feed=comments-atom"],
 	"/feeds/posts/default",
 	"/feeds/posts/default?alt=rss",
 	"/feeds/comments/default"
@@ -102,7 +100,7 @@ const linkSelectors = [{
 }, { rel: "feed" }];
 const defaultHtmlOptions = {
 	linkSelectors,
-	anchorUris: urisComprehensive,
+	anchorUris: urisComprehensive.flat(),
 	anchorIgnoredUris: ignoredUris,
 	anchorLabels
 };
@@ -128,6 +126,7 @@ const defaultPlatformOptions = { handlers: [
 	substackHandler,
 	tumblrHandler,
 	wordpressHandler,
+	wpengineHandler,
 	youtubeHandler
 ] };
 

package/dist/feeds/platform/handlers/behance.cjs

@@ -33,8 +33,14 @@ const behanceHandler = {
 			const username = userMatch[1];
 			const subpage = userMatch[2];
 			if (!require_utils.isAnyOf(username, excludedPaths)) {
-				if (subpage === "appreciated") return [`https://www.behance.net/feeds/user?username=${username}&content=appreciated`];
-				return [`https://www.behance.net/feeds/user?username=${username}`];
+				if (subpage === "appreciated") return [{
+					uri: `https://www.behance.net/feeds/user?username=${username}&content=appreciated`,
+					hint: require_utils.composeHint("behance:appreciated")
+				}];
+				return [{
+					uri: `https://www.behance.net/feeds/user?username=${username}`,
+					hint: require_utils.composeHint("behance:portfolio")
+				}];
 			}
 		}
 		return [];

package/dist/feeds/platform/handlers/behance.js

@@ -1,4 +1,4 @@
-import { isAnyOf, isHostOf } from "../../../common/utils.js";
+import { composeHint, isAnyOf, isHostOf } from "../../../common/utils.js";
 
 //#region src/feeds/platform/handlers/behance.ts
 const hosts = ["behance.net", "www.behance.net"];
@@ -33,8 +33,14 @@ const behanceHandler = {
 			const username = userMatch[1];
 			const subpage = userMatch[2];
 			if (!isAnyOf(username, excludedPaths)) {
-				if (subpage === "appreciated") return [`https://www.behance.net/feeds/user?username=${username}&content=appreciated`];
-				return [`https://www.behance.net/feeds/user?username=${username}`];
+				if (subpage === "appreciated") return [{
+					uri: `https://www.behance.net/feeds/user?username=${username}&content=appreciated`,
+					hint: composeHint("behance:appreciated")
+				}];
+				return [{
+					uri: `https://www.behance.net/feeds/user?username=${username}`,
+					hint: composeHint("behance:portfolio")
+				}];
 			}
 		}
 		return [];

package/dist/feeds/platform/handlers/blogspot.cjs

@@ -1,3 +1,4 @@
+const require_utils = require('../../../common/utils.cjs');
 
 //#region src/feeds/platform/handlers/blogspot.ts
 const blogspotDomainRegex = /^.+\.blogspot\.(?:com|co\.[a-z]{2}|com\.[a-z]{2}|[a-z]{2,3})$/;
@@ -12,10 +13,19 @@ const blogspotHandler = {
 		const labelMatch = pathname.match(/^\/search\/label\/([^/]+)/);
 		if (labelMatch?.[1]) {
 			const label = labelMatch[1];
-			uris.push(`${origin}/feeds/posts/default/-/${label}`);
+			uris.push({
+				uri: `${origin}/feeds/posts/default/-/${label}`,
+				hint: require_utils.composeHint("blogspot:label")
+			});
 		}
-		uris.push(`${origin}/feeds/posts/default`);
-		uris.push(`${origin}/feeds/posts/default?alt=rss`);
+		uris.push({
+			uri: `${origin}/feeds/posts/default`,
+			hint: require_utils.composeHint("blogspot:posts-atom")
+		});
+		uris.push({
+			uri: `${origin}/feeds/posts/default?alt=rss`,
+			hint: require_utils.composeHint("blogspot:posts-rss")
+		});
 		return uris;
 	}
 };

package/dist/feeds/platform/handlers/blogspot.js

@@ -1,3 +1,5 @@
+import { composeHint } from "../../../common/utils.js";
+
 //#region src/feeds/platform/handlers/blogspot.ts
 const blogspotDomainRegex = /^.+\.blogspot\.(?:com|co\.[a-z]{2}|com\.[a-z]{2}|[a-z]{2,3})$/;
 const blogspotHandler = {
@@ -11,10 +13,19 @@ const blogspotHandler = {
 		const labelMatch = pathname.match(/^\/search\/label\/([^/]+)/);
 		if (labelMatch?.[1]) {
 			const label = labelMatch[1];
-			uris.push(`${origin}/feeds/posts/default/-/${label}`);
+			uris.push({
+				uri: `${origin}/feeds/posts/default/-/${label}`,
+				hint: composeHint("blogspot:label")
+			});
 		}
-		uris.push(`${origin}/feeds/posts/default`);
-		uris.push(`${origin}/feeds/posts/default?alt=rss`);
+		uris.push({
+			uri: `${origin}/feeds/posts/default`,
+			hint: composeHint("blogspot:posts-atom")
+		});
+		uris.push({
+			uri: `${origin}/feeds/posts/default?alt=rss`,
+			hint: composeHint("blogspot:posts-rss")
+		});
 		return uris;
 	}
 };

package/dist/feeds/platform/handlers/bluesky.cjs

@@ -10,7 +10,10 @@ const blueskyHandler = {
 		const { pathname } = new URL(url);
 		const handle = pathname.match(/^\/profile\/([^/]+)/)?.[1];
 		if (!handle) return [];
-		return [`https://bsky.app/profile/${handle}/rss`];
+		return [{
+			uri: `https://bsky.app/profile/${handle}/rss`,
+			hint: require_utils.composeHint("bluesky:posts")
+		}];
 	}
 };
 

package/dist/feeds/platform/handlers/bluesky.js

@@ -1,4 +1,4 @@
-import { isHostOf } from "../../../common/utils.js";
+import { composeHint, isHostOf } from "../../../common/utils.js";
 
 //#region src/feeds/platform/handlers/bluesky.ts
 const hosts = ["bsky.app"];
@@ -10,7 +10,10 @@ const blueskyHandler = {
 		const { pathname } = new URL(url);
 		const handle = pathname.match(/^\/profile\/([^/]+)/)?.[1];
 		if (!handle) return [];
-		return [`https://bsky.app/profile/${handle}/rss`];
+		return [{
+			uri: `https://bsky.app/profile/${handle}/rss`,
+			hint: composeHint("bluesky:posts")
+		}];
 	}
 };
 

package/dist/feeds/platform/handlers/dailymotion.cjs

@@ -52,11 +52,17 @@ const dailymotionHandler = {
 	resolve: (url) => {
 		const { pathname } = new URL(url);
 		const playlistMatch = pathname.match(playlistPathRegex);
-		if (playlistMatch?.[1]) return [`https://www.dailymotion.com/rss/playlist/${playlistMatch[1]}`];
+		if (playlistMatch?.[1]) return [{
+			uri: `https://www.dailymotion.com/rss/playlist/${playlistMatch[1]}`,
+			hint: require_utils.composeHint("dailymotion:playlist")
+		}];
 		const userMatch = pathname.match(userPathRegex);
 		if (userMatch?.[1]) {
 			const username = userMatch[1];
-			if (!require_utils.isAnyOf(username, excludedPaths)) return [`https://www.dailymotion.com/rss/${username}`];
+			if (!require_utils.isAnyOf(username, excludedPaths)) return [{
+				uri: `https://www.dailymotion.com/rss/${username}`,
+				hint: require_utils.composeHint("dailymotion:videos")
+			}];
 		}
 		return [];
 	}

package/dist/feeds/platform/handlers/dailymotion.js

@@ -1,4 +1,4 @@
-import { isAnyOf, isHostOf } from "../../../common/utils.js";
+import { composeHint, isAnyOf, isHostOf } from "../../../common/utils.js";
 
 //#region src/feeds/platform/handlers/dailymotion.ts
 const hosts = ["dailymotion.com", "www.dailymotion.com"];
@@ -52,11 +52,17 @@ const dailymotionHandler = {
 	resolve: (url) => {
 		const { pathname } = new URL(url);
 		const playlistMatch = pathname.match(playlistPathRegex);
-		if (playlistMatch?.[1]) return [`https://www.dailymotion.com/rss/playlist/${playlistMatch[1]}`];
+		if (playlistMatch?.[1]) return [{
+			uri: `https://www.dailymotion.com/rss/playlist/${playlistMatch[1]}`,
+			hint: composeHint("dailymotion:playlist")
+		}];
 		const userMatch = pathname.match(userPathRegex);
 		if (userMatch?.[1]) {
 			const username = userMatch[1];
-			if (!isAnyOf(username, excludedPaths)) return [`https://www.dailymotion.com/rss/${username}`];
+			if (!isAnyOf(username, excludedPaths)) return [{
+				uri: `https://www.dailymotion.com/rss/${username}`,
+				hint: composeHint("dailymotion:videos")
+			}];
 		}
 		return [];
 	}

package/dist/feeds/platform/handlers/deviantart.cjs

@@ -26,23 +26,35 @@ const deviantartHandler = {
 		const tagMatch = pathname.match(/^\/tag\/([^/]+)/);
 		if (tagMatch?.[1]) {
 			const tag = tagMatch[1];
-			return [`${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`tag:${tag}`)}`];
+			return [{
+				uri: `${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`tag:${tag}`)}`,
+				hint: require_utils.composeHint("deviantart:tag")
+			}];
 		}
 		const favMatch = pathname.match(/^\/([a-zA-Z0-9_-]+)\/favourites\/?$/);
 		if (favMatch?.[1]) {
 			const username = favMatch[1];
-			if (!require_utils.isAnyOf(username, excludedPaths)) return [`${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`favby:${username}`)}`];
+			if (!require_utils.isAnyOf(username, excludedPaths)) return [{
+				uri: `${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`favby:${username}`)}`,
+				hint: require_utils.composeHint("deviantart:favorites")
+			}];
 		}
 		const folderMatch = pathname.match(/^\/([a-zA-Z0-9_-]+)\/gallery\/(\d+)(?:\/|$)/);
 		if (folderMatch?.[1] && folderMatch?.[2]) {
 			const username = folderMatch[1];
 			const folderId = folderMatch[2];
-			if (!require_utils.isAnyOf(username, excludedPaths)) return [`${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`gallery:${username}/${folderId}`)}`];
+			if (!require_utils.isAnyOf(username, excludedPaths)) return [{
+				uri: `${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`gallery:${username}/${folderId}`)}`,
+				hint: require_utils.composeHint("deviantart:gallery")
+			}];
 		}
 		const username = pathname.match(/^\/([a-zA-Z0-9_-]+)(?:\/gallery(?:\/all)?)?(?:\/|$)/)?.[1];
 		if (!username || require_utils.isAnyOf(username, excludedPaths)) return [];
 		const query = `by:${username} sort:time meta:all`;
-		return [`${feedBaseUrl}?type=deviation&q=${encodeURIComponent(query)}`];
+		return [{
+			uri: `${feedBaseUrl}?type=deviation&q=${encodeURIComponent(query)}`,
+			hint: require_utils.composeHint("deviantart:deviations")
+		}];
 	}
 };
 

package/dist/feeds/platform/handlers/deviantart.js

@@ -1,4 +1,4 @@
-import { isAnyOf, isHostOf } from "../../../common/utils.js";
+import { composeHint, isAnyOf, isHostOf } from "../../../common/utils.js";
 
 //#region src/feeds/platform/handlers/deviantart.ts
 const hosts = ["deviantart.com", "www.deviantart.com"];
@@ -26,23 +26,35 @@ const deviantartHandler = {
 		const tagMatch = pathname.match(/^\/tag\/([^/]+)/);
 		if (tagMatch?.[1]) {
 			const tag = tagMatch[1];
-			return [`${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`tag:${tag}`)}`];
+			return [{
+				uri: `${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`tag:${tag}`)}`,
+				hint: composeHint("deviantart:tag")
+			}];
 		}
 		const favMatch = pathname.match(/^\/([a-zA-Z0-9_-]+)\/favourites\/?$/);
 		if (favMatch?.[1]) {
 			const username = favMatch[1];
-			if (!isAnyOf(username, excludedPaths)) return [`${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`favby:${username}`)}`];
+			if (!isAnyOf(username, excludedPaths)) return [{
+				uri: `${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`favby:${username}`)}`,
+				hint: composeHint("deviantart:favorites")
+			}];
 		}
 		const folderMatch = pathname.match(/^\/([a-zA-Z0-9_-]+)\/gallery\/(\d+)(?:\/|$)/);
 		if (folderMatch?.[1] && folderMatch?.[2]) {
 			const username = folderMatch[1];
 			const folderId = folderMatch[2];
-			if (!isAnyOf(username, excludedPaths)) return [`${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`gallery:${username}/${folderId}`)}`];
+			if (!isAnyOf(username, excludedPaths)) return [{
+				uri: `${feedBaseUrl}?type=deviation&q=${encodeURIComponent(`gallery:${username}/${folderId}`)}`,
+				hint: composeHint("deviantart:gallery")
+			}];
 		}
 		const username = pathname.match(/^\/([a-zA-Z0-9_-]+)(?:\/gallery(?:\/all)?)?(?:\/|$)/)?.[1];
 		if (!username || isAnyOf(username, excludedPaths)) return [];
 		const query = `by:${username} sort:time meta:all`;
-		return [`${feedBaseUrl}?type=deviation&q=${encodeURIComponent(query)}`];
+		return [{
+			uri: `${feedBaseUrl}?type=deviation&q=${encodeURIComponent(query)}`,
+			hint: composeHint("deviantart:deviations")
+		}];
 	}
 };
 

package/dist/feeds/platform/handlers/devto.cjs

@@ -32,10 +32,16 @@ const devtoHandler = {
 		const userMatch = pathname.match(userPathRegex);
 		if (userMatch?.[1]) {
 			const username = userMatch[1];
-			if (!require_utils.isAnyOf(username, excludedPaths)) return [`https://dev.to/feed/${username}`];
+			if (!require_utils.isAnyOf(username, excludedPaths)) return [{
+				uri: `https://dev.to/feed/${username}`,
+				hint: require_utils.composeHint("devto:posts")
+			}];
 		}
 		const tagMatch = pathname.match(tagPathRegex);
-		if (tagMatch?.[1]) return [`https://dev.to/feed/tag/${tagMatch[1]}`];
+		if (tagMatch?.[1]) return [{
+			uri: `https://dev.to/feed/tag/${tagMatch[1]}`,
+			hint: require_utils.composeHint("devto:tag")
+		}];
 		return [];
 	}
 };

package/dist/feeds/platform/handlers/devto.js

@@ -1,4 +1,4 @@
-import { isAnyOf, isHostOf } from "../../../common/utils.js";
+import { composeHint, isAnyOf, isHostOf } from "../../../common/utils.js";
 
 //#region src/feeds/platform/handlers/devto.ts
 const hosts = ["dev.to", "www.dev.to"];
@@ -32,10 +32,16 @@ const devtoHandler = {
 		const userMatch = pathname.match(userPathRegex);
 		if (userMatch?.[1]) {
 			const username = userMatch[1];
-			if (!isAnyOf(username, excludedPaths)) return [`https://dev.to/feed/${username}`];
+			if (!isAnyOf(username, excludedPaths)) return [{
+				uri: `https://dev.to/feed/${username}`,
+				hint: composeHint("devto:posts")
+			}];
 		}
 		const tagMatch = pathname.match(tagPathRegex);
-		if (tagMatch?.[1]) return [`https://dev.to/feed/tag/${tagMatch[1]}`];
+		if (tagMatch?.[1]) return [{
+			uri: `https://dev.to/feed/tag/${tagMatch[1]}`,
+			hint: composeHint("devto:tag")
+		}];
 		return [];
 	}
 };

package/dist/feeds/platform/handlers/github.cjs

@@ -56,30 +56,50 @@ const githubHandler = {
 		const { pathname } = new URL(url);
 		const uris = [];
 		const userMatch = pathname.match(/^\/([^/]+)\/?$/);
-		if (userMatch?.[1] && !require_utils.isAnyOf(userMatch[1], excludedPaths)) {
-			const user = userMatch[1];
-			uris.push(`https://github.com/${user}.atom`);
-			return uris;
-		}
+		if (userMatch?.[1] && !require_utils.isAnyOf(userMatch[1], excludedPaths)) return [{
+			uri: `https://github.com/${userMatch[1]}.atom`,
+			hint: require_utils.composeHint("github:activity")
+		}];
 		const repoMatch = pathname.match(/^\/([^/]+)\/([^/]+)/);
 		const owner = repoMatch?.[1];
 		const repo = repoMatch?.[2];
 		if (!owner || !repo || require_utils.isAnyOf(owner, excludedPaths)) return [];
-		uris.push(`https://github.com/${owner}/${repo}/releases.atom`);
-		uris.push(`https://github.com/${owner}/${repo}/commits.atom`);
-		uris.push(`https://github.com/${owner}/${repo}/tags.atom`);
-		if (/\/wiki(\/|$)/.test(pathname)) uris.push(`https://github.com/${owner}/${repo}/wiki.atom`);
-		if (/\/discussions(\/|$)/.test(pathname)) uris.push(`https://github.com/${owner}/${repo}/discussions.atom`);
+		uris.push({
+			uri: `https://github.com/${owner}/${repo}/releases.atom`,
+			hint: require_utils.composeHint("github:releases")
+		});
+		uris.push({
+			uri: `https://github.com/${owner}/${repo}/commits.atom`,
+			hint: require_utils.composeHint("github:commits")
+		});
+		uris.push({
+			uri: `https://github.com/${owner}/${repo}/tags.atom`,
+			hint: require_utils.composeHint("github:tags")
+		});
+		if (/\/wiki(\/|$)/.test(pathname)) uris.push({
+			uri: `https://github.com/${owner}/${repo}/wiki.atom`,
+			hint: require_utils.composeHint("github:wiki")
+		});
+		if (/\/discussions(\/|$)/.test(pathname)) uris.push({
+			uri: `https://github.com/${owner}/${repo}/discussions.atom`,
+			hint: require_utils.composeHint("github:discussions")
+		});
 		const branchMatch = pathname.match(/^\/[^/]+\/[^/]+\/tree\/([^/]+)\/?$/);
 		if (branchMatch?.[1]) {
 			const branch = branchMatch[1];
-			uris.push(`https://github.com/${owner}/${repo}/commits/${branch}.atom`);
+			uris.push({
+				uri: `https://github.com/${owner}/${repo}/commits/${branch}.atom`,
+				hint: require_utils.composeHint("github:branch-commits")
+			});
 		}
 		const fileMatch = pathname.match(/^\/[^/]+\/[^/]+\/(?:blob|commits)\/([^/]+)\/(.+)/);
 		if (fileMatch?.[1] && fileMatch?.[2]) {
 			const branch = fileMatch[1];
 			const filePath = fileMatch[2];
-			uris.push(`https://github.com/${owner}/${repo}/commits/${branch}/${filePath}.atom`);
+			uris.push({
+				uri: `https://github.com/${owner}/${repo}/commits/${branch}/${filePath}.atom`,
+				hint: require_utils.composeHint("github:file-history")
+			});
 		}
 		return uris;
 	}