@atproto-ui/core 0.13.0

package/dist/client.js

@@ -0,0 +1,118 @@
+import { Client, simpleFetchHandler } from "@atcute/client";
+import { CompositeDidDocumentResolver, PlcDidDocumentResolver, WebDidDocumentResolver, XrpcHandleResolver } from "@atcute/identity-resolver";
+var DEFAULT_PLC = "https://plc.directory", DEFAULT_IDENTITY_SERVICE = "https://public.api.bsky.app", DEFAULT_SLINGSHOT = "https://slingshot.microcosm.blue", DEFAULT_APPVIEW = "https://public.api.bsky.app", DEFAULT_BLUESKY_APP = "https://bsky.app", DEFAULT_TANGLED = "https://tangled.org", DEFAULT_CONSTELLATION = "https://constellation.microcosm.blue", ABSOLUTE_URL_RE = /^[a-zA-Z][a-zA-Z\d+\-.]*:/, SUPPORTED_DID_METHODS = ["plc", "web"];
+const DEFAULT_CONFIG = {
+	plcDirectory: DEFAULT_PLC,
+	identityService: DEFAULT_IDENTITY_SERVICE,
+	slingshotBaseUrl: DEFAULT_SLINGSHOT,
+	blueskyAppviewService: DEFAULT_APPVIEW,
+	blueskyAppBaseUrl: DEFAULT_BLUESKY_APP,
+	tangledBaseUrl: DEFAULT_TANGLED,
+	constellationBaseUrl: DEFAULT_CONSTELLATION
+}, SLINGSHOT_BASE_URL = DEFAULT_SLINGSHOT, normalizeBaseUrl = (e) => {
+	let d = e.trim();
+	if (!d) throw Error("Service URL cannot be empty");
+	let f = ABSOLUTE_URL_RE.test(d) ? d : `https://${d.replace(/^\/+/, "")}`, p = new URL(f), m = p.pathname.replace(/\/+$/, "");
+	return m ? `${p.origin}${m}` : p.origin;
+};
+var ServiceResolver = class {
+	constructor(e = {}) {
+		let d = e.plcDirectory && e.plcDirectory.trim() ? e.plcDirectory : DEFAULT_PLC, v = e.identityService && e.identityService.trim() ? e.identityService : DEFAULT_IDENTITY_SERVICE, y = e.slingshotBaseUrl && e.slingshotBaseUrl.trim() ? e.slingshotBaseUrl : DEFAULT_SLINGSHOT;
+		this.plc = normalizeBaseUrl(d);
+		let b = normalizeBaseUrl(v);
+		this.slingshot = normalizeBaseUrl(y), this.fetchImpl = bindFetch(e.fetch);
+		let x = new PlcDidDocumentResolver({
+			apiUrl: this.plc,
+			fetch: this.fetchImpl
+		}), S = new WebDidDocumentResolver({ fetch: this.fetchImpl });
+		this.didResolver = new CompositeDidDocumentResolver({ methods: {
+			plc: x,
+			web: S
+		} }), this.handleResolver = new XrpcHandleResolver({
+			serviceUrl: b,
+			fetch: this.fetchImpl
+		});
+	}
+	async resolveDidDoc(e) {
+		let d = e.trim();
+		if (!d.startsWith("did:")) throw Error(`Invalid DID ${e}`);
+		let f = d.indexOf(":", 4), p = f === -1 ? d.slice(4) : d.slice(4, f);
+		if (!SUPPORTED_DID_METHODS.includes(p)) throw Error(`Unsupported DID method ${p ?? "<unknown>"}`);
+		return this.didResolver.resolve(d);
+	}
+	async pdsEndpointForDid(e) {
+		let d = (await this.resolveDidDoc(e)).service?.find((e) => e.type === "AtprotoPersonalDataServer");
+		if (!d || !d.serviceEndpoint || typeof d.serviceEndpoint != "string") throw Error(`No PDS endpoint in DID doc for ${e}`);
+		return d.serviceEndpoint.replace(/\/$/, "");
+	}
+	getSlingshotUrl() {
+		return this.slingshot;
+	}
+	async resolveHandle(e) {
+		let d = e.trim().toLowerCase();
+		if (!d) throw Error("Handle cannot be empty");
+		let f;
+		try {
+			let e = new URL("/xrpc/com.atproto.identity.resolveHandle", this.slingshot);
+			e.searchParams.set("handle", d);
+			let p = await this.fetchImpl(e);
+			if (p.ok) {
+				let e = await p.json();
+				if (e?.did) return e.did;
+				f = /* @__PURE__ */ Error("Slingshot resolveHandle response missing DID");
+			} else {
+				f = /* @__PURE__ */ Error(`Slingshot resolveHandle failed with status ${p.status}`);
+				let e = p.body;
+				e && e.cancel().catch(() => {});
+			}
+		} catch (e) {
+			if (e instanceof DOMException && e.name === "AbortError") throw e;
+			f = e instanceof Error ? e : Error(String(e));
+		}
+		try {
+			return await this.handleResolver.resolve(d);
+		} catch (e) {
+			throw f && e instanceof Error && (e.message = `${e.message}; Slingshot resolveHandle failed: ${f.message}`), e;
+		}
+	}
+};
+async function createAtprotoClient(d = {}) {
+	let f = bindFetch(d.fetch), p = d.service, m = new ServiceResolver({
+		...d,
+		fetch: f
+	});
+	if (!p && d.did && (p = await m.pdsEndpointForDid(d.did)), !p) throw Error("service or did required");
+	let h = normalizeBaseUrl(p), g = m.getSlingshotUrl(), _ = createSlingshotAwareHandler(h, g, f);
+	return {
+		rpc: new Client({ handler: _ }),
+		service: h,
+		resolver: m
+	};
+}
+var SLINGSHOT_RETRY_PATHS = ["/xrpc/com.atproto.repo.getRecord", "/xrpc/com.atproto.identity.resolveHandle"];
+function createSlingshotAwareHandler(e, f, p) {
+	let m = simpleFetchHandler({
+		service: e,
+		fetch: p
+	}), h = simpleFetchHandler({
+		service: f,
+		fetch: p
+	});
+	return async (e, d) => {
+		if (SLINGSHOT_RETRY_PATHS.find((d) => e === d || e.startsWith(`${d}?`))) try {
+			let f = await h(e, d);
+			if (f.ok) return f;
+			let p = f.body;
+			p && p.cancel().catch(() => {});
+		} catch (e) {
+			if (e instanceof DOMException && e.name === "AbortError") throw e;
+		}
+		return m(e, d);
+	};
+}
+function bindFetch(e) {
+	let d = e ?? globalThis.fetch;
+	if (typeof d != "function") throw Error("fetch implementation not available");
+	return d.bind(globalThis);
+}
+export { DEFAULT_CONFIG, SLINGSHOT_BASE_URL, ServiceResolver, createAtprotoClient, normalizeBaseUrl };

package/dist/fetch-and-cache-handler.d.ts

@@ -0,0 +1,84 @@
+import { type FetchHandler } from "@atcute/client";
+import type { AtprotoCaches } from "./cache";
+import { primeBlueskyFeedCache } from "./records";
+export interface FetchAndCacheHandlerOptions {
+    /**
+     * Service URL passed through to atcute's `simpleFetchHandler`.
+     */
+    service: string | URL;
+    /**
+     * Optional fetch implementation. Useful for tests, benchmarks, and request
+     * counters.
+     */
+    fetch?: typeof fetch;
+    /**
+     * Cache instances to prime. Defaults to atproto-ui's shared caches.
+     */
+    caches?: AtprotoCaches;
+}
+export interface FetchAndCacheResult {
+    dids: number;
+    profiles: number;
+    records: number;
+}
+type FeedItemLike = Parameters<typeof primeBlueskyFeedCache>[0]["feed"][number];
+interface PostViewLike {
+    uri?: string;
+    record?: unknown;
+    author?: {
+        did?: string;
+        handle?: string;
+        displayName?: string;
+        description?: string;
+        avatar?: string;
+        createdAt?: string;
+        pronouns?: string;
+        website?: string;
+    };
+    reply?: {
+        parent?: {
+            uri?: string;
+            author?: {
+                did?: string;
+                handle?: string;
+            };
+        };
+    };
+}
+interface AppviewPayloadLike {
+    feed?: FeedItemLike[];
+    posts?: PostViewLike[];
+    thread?: ThreadViewLike;
+    did?: string;
+    handle?: string;
+    displayName?: string;
+    description?: string;
+    avatar?: string;
+    banner?: string;
+    createdAt?: string;
+    pronouns?: string;
+    website?: string;
+    profiles?: Array<AppviewPayloadLike>;
+}
+interface ThreadViewLike {
+    post?: PostViewLike;
+    parent?: ThreadViewLike | {
+        post?: PostViewLike;
+    };
+    replies?: Array<ThreadViewLike | {
+        post?: PostViewLike;
+    }>;
+}
+/**
+ * Creates an atcute-compatible fetch handler that automatically primes
+ * atproto-ui's shared caches from Bluesky appview responses.
+ *
+ * Use this in an atcute `Client` when an app fetches feed/profile data itself
+ * and then passes records into atproto-ui components. The response still flows
+ * through atcute unchanged; the handler only clones successful JSON responses
+ * and stores the DID/profile/post data appview already returned.
+ */
+export declare function createFetchAndCacheHandler(options: FetchAndCacheHandlerOptions): FetchHandler;
+export declare function primeResponseFromAppview(pathname: string, response: Response, caches?: AtprotoCaches): Promise<FetchAndCacheResult | undefined>;
+export declare function primeBlueskyAppviewPayload(payload: AppviewPayloadLike, caches?: AtprotoCaches): FetchAndCacheResult;
+export {};

package/dist/fetch-and-cache-handler.js

@@ -0,0 +1,63 @@
+import { getSharedCaches } from "./cache.js";
+import { primeBlueskyFeedCache, primeBlueskyProfileCache } from "./records.js";
+import { simpleFetchHandler } from "@atcute/client";
+function createFetchAndCacheHandler(a) {
+	let o = simpleFetchHandler({
+		service: a.service,
+		fetch: a.fetch
+	}), c = a.caches ?? getSharedCaches();
+	return async (e, a) => {
+		let s = await o(e, a);
+		return await primeResponseFromAppview(e, s, c), s;
+	};
+}
+async function primeResponseFromAppview(a, o, s = getSharedCaches()) {
+	if (!(!o.ok || !isBlueskyAppviewPath(a))) try {
+		let e = await o.clone().json();
+		return primeBlueskyAppviewPayload(e, s);
+	} catch {
+		return;
+	}
+}
+function primeBlueskyAppviewPayload(s, c = getSharedCaches()) {
+	let l = {
+		dids: 0,
+		profiles: 0,
+		records: 0
+	};
+	Array.isArray(s.feed) && addPrimeResult(l, primeBlueskyFeedCache({
+		feed: s.feed,
+		...c
+	})), Array.isArray(s.posts) && addPrimeResult(l, primeBlueskyFeedCache({
+		feed: s.posts.map((e) => ({ post: e })),
+		...c
+	}));
+	let u = collectThreadPosts(s.thread);
+	u.length > 0 && addPrimeResult(l, primeBlueskyFeedCache({
+		feed: u.map((e) => ({ post: e })),
+		...c
+	}));
+	for (let e of [s, ...Array.isArray(s.profiles) ? s.profiles : []]) e.did && addPrimeResult(l, primeBlueskyProfileCache({
+		profile: e,
+		...c
+	}));
+	return l;
+}
+function isBlueskyAppviewPath(e) {
+	return xrpcNsid(e)?.startsWith("app.bsky.") ?? !1;
+}
+function xrpcNsid(e) {
+	let a = e.split("?")[0] ?? e;
+	if (a.startsWith("/xrpc/")) return decodeURIComponent(a.slice(6));
+}
+function collectThreadPosts(e) {
+	if (!e) return [];
+	let a = [], o = (e) => {
+		if (e && (e.post && a.push(e.post), "parent" in e && o(e.parent), "replies" in e && Array.isArray(e.replies))) for (let a of e.replies) o(a);
+	};
+	return o(e), a;
+}
+function addPrimeResult(e, a) {
+	e.dids += a.dids, e.profiles += a.profiles, e.records += a.records;
+}
+export { createFetchAndCacheHandler, primeBlueskyAppviewPayload, primeResponseFromAppview };

package/dist/grain.d.ts

@@ -0,0 +1,22 @@
+import type { ServiceResolver } from "./client";
+import type { GrainPhotoRecord } from "./types/grain";
+export declare const GRAIN_GALLERY_COLLECTION = "social.grain.gallery";
+export declare const GRAIN_GALLERY_ITEM_COLLECTION = "social.grain.gallery.item";
+export declare const GRAIN_PHOTO_COLLECTION = "social.grain.photo";
+export interface GrainGalleryPhoto {
+    record: GrainPhotoRecord;
+    did: string;
+    rkey: string;
+    position?: number;
+}
+export interface GalleryBacklink {
+    did: string;
+    rkey: string;
+}
+/**
+ * Resolves grain.social gallery photos from gallery-item backlinks: for each
+ * backlink it loads the gallery-item record, follows its `item` URI to the photo
+ * record, and returns the photos sorted by position. Network/resolution only —
+ * framework hooks just feed in the backlinks and render the result.
+ */
+export declare function fetchGrainGalleryPhotos(backlinks: GalleryBacklink[], resolver: ServiceResolver): Promise<GrainGalleryPhoto[]>;

package/dist/grain.js

@@ -0,0 +1,30 @@
+import { callGetRecord } from "./rpc.js";
+import { parseAtUri } from "./utils/at-uri.js";
+const GRAIN_GALLERY_COLLECTION = "social.grain.gallery", GRAIN_GALLERY_ITEM_COLLECTION = "social.grain.gallery.item", GRAIN_PHOTO_COLLECTION = "social.grain.photo";
+async function getRecordValue(t, n, r, i) {
+	try {
+		let a = await callGetRecord(i.getSlingshotUrl(), t, n, r);
+		if (a.ok) return a.data.value;
+	} catch {}
+	try {
+		let a = await i.pdsEndpointForDid(t), o = await callGetRecord(a, t, n, r);
+		if (o.ok) return o.data.value;
+	} catch {}
+	return null;
+}
+async function fetchGrainGalleryPhotos(e, n) {
+	return !e || e.length === 0 ? [] : (await Promise.all(e.map(async (e) => {
+		let i = await getRecordValue(e.did, GRAIN_GALLERY_ITEM_COLLECTION, e.rkey, n);
+		if (!i) return null;
+		let o = parseAtUri(i.item);
+		if (!o) return null;
+		let s = await getRecordValue(o.did, o.collection, o.rkey, n);
+		return s ? {
+			record: s,
+			did: o.did,
+			rkey: o.rkey,
+			position: i.position
+		} : null;
+	}))).filter((e) => e !== null).sort((e, t) => (e.position ?? 0) - (t.position ?? 0));
+}
+export { GRAIN_GALLERY_COLLECTION, GRAIN_GALLERY_ITEM_COLLECTION, GRAIN_PHOTO_COLLECTION, fetchGrainGalleryPhotos };

package/dist/icons.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared SVG icon data so every framework renders identical icons.
+ * Each entry is the inner `<path>` data plus the SVG viewBox.
+ */
+export interface IconData {
+    viewBox: string;
+    path: string;
+}
+export declare const tangledIcon: IconData;
+export declare const githubIcon: IconData;
+export declare const starIcon: IconData;

package/dist/icons.js

@@ -0,0 +1,11 @@
+const tangledIcon = {
+	viewBox: "0 0 25 25",
+	path: "m 16.208435,23.914069 c -0.06147,-0.02273 -0.147027,-0.03034 -0.190158,-0.01691 -0.197279,0.06145 -1.31068,-0.230493 -1.388819,-0.364153 -0.01956,-0.03344 -0.163274,-0.134049 -0.319377,-0.223561 -0.550395,-0.315603 -1.010951,-0.696643 -1.428383,-1.181771 -0.264598,-0.307509 -0.597257,-0.785384 -0.597257,-0.857979 0,-0.0216 -0.02841,-0.06243 -0.06313,-0.0907 -0.04977,-0.04053 -0.160873,0.0436 -0.52488,0.397463 -0.479803,0.466432 -0.78924,0.689475 -1.355603,0.977118 -0.183693,0.0933 -0.323426,0.179989 -0.310516,0.192658 0.02801,0.02748 -0.7656391,0.270031 -1.209129,0.369517 -0.5378332,0.120647 -1.6341809,0.08626 -1.9721503,-0.06186 C 6.7977157,23.031391 6.56735,22.957551 6.3371134,22.889782 4.9717169,22.487902 3.7511914,21.481518 3.1172396,20.234838 2.6890391,19.392772 2.5582276,18.827446 2.5610489,17.831154 2.5639589,16.802192 2.7366641,16.125844 3.2142117,15.273187 3.3040457,15.112788 3.3713143,14.976533 3.3636956,14.9704 3.3560756,14.9643 3.2459634,14.90305 3.1189994,14.834381 1.7582586,14.098312 0.77760984,12.777439 0.44909837,11.23818 0.33531456,10.705039 0.33670119,9.7067968 0.45195381,9.1778795 0.72259241,7.9359287 1.3827188,6.8888436 2.4297498,6.0407205 2.6856126,5.8334648 3.2975489,5.4910878 3.6885849,5.3364049 L 4.0584319,5.190106 4.2333984,4.860432 C 4.8393906,3.7186139 5.8908314,2.7968028 7.1056396,2.3423025 7.7690673,2.0940921 8.2290216,2.0150935 9.01853,2.0137575 c 0.9625627,-0.00163 1.629181,0.1532762 2.485864,0.5776514 l 0.271744,0.1346134 0.42911,-0.3607688 c 1.082666,-0.9102346 2.185531,-1.3136811 3.578383,-1.3090327 0.916696,0.00306 1.573918,0.1517893 2.356121,0.5331927 1.465948,0.7148 2.54506,2.0625628 2.865177,3.57848 l 0.07653,0.362429 0.515095,0.2556611 c 1.022872,0.5076874 1.756122,1.1690944 2.288361,2.0641468 0.401896,0.6758594 0.537303,1.0442682 0.675505,1.8378683 0.288575,1.6570823 -0.266229,3.3548023 -1.490464,4.5608743 -0.371074,0.36557 -0.840205,0.718265 -1.203442,0.904754 -0.144112,0.07398 -0.271303,0.15826 -0.282647,0.187269 -0.01134,0.02901 0.02121,0.142764 0.07234,0.25279 0.184248,0.396467 0.451371,1.331823 0.619371,2.168779 0.463493,2.30908 -0.754646,4.693707 -2.92278,5.721632 -0.479538,0.227352 -0.717629,0.309322 -1.144194,0.39393 -0.321869,0.06383 -1.850573,0.09139 -2.000174,0.03604 z M 12.25443,18.636956 c 0.739923,-0.24652 1.382521,-0.718922 1.874623,-1.37812 0.0752,-0.100718 0.213883,-0.275851 0.308198,-0.389167 0.09432,-0.113318 0.210136,-0.271056 0.257381,-0.350531 0.416347,-0.700389 0.680936,-1.176102 0.766454,-1.378041 0.05594,-0.132087 0.114653,-0.239607 0.130477,-0.238929 0.01583,6.79e-4 0.08126,0.08531 0.145412,0.188069 0.178029,0.285173 0.614305,0.658998 0.868158,0.743878 0.259802,0.08686 0.656158,0.09598 0.911369,0.02095 0.213812,-0.06285 0.507296,-0.298016 0.645179,-0.516947 0.155165,-0.246374 0.327989,-0.989595 0.327989,-1.410501 0,-1.26718 -0.610975,-3.143405 -1.237774,-3.801045 -0.198483,-0.2082486 -0.208557,-0.2319396 -0.208557,-0.4904655 0,-0.2517771 -0.08774,-0.5704927 -0.258476,-0.938956 C 16.694963,8.50313 16.375697,8.1377479 16.135846,7.9543702 L 15.932296,7.7987471 15.683004,7.9356529 C 15.131767,8.2383821 14.435638,8.1945733 13.943459,7.8261812 L 13.782862,7.7059758 13.686773,7.8908012 C 13.338849,8.5600578 12.487087,8.8811064 11.743178,8.6233891 11.487199,8.5347109 11.358897,8.4505994 11.063189,8.1776138 L 10.69871,7.8411436 10.453484,8.0579255 C 10.318608,8.1771557 10.113778,8.3156283 9.9983037,8.3656417 9.7041488,8.4930449 9.1808299,8.5227884 8.8979004,8.4281886 8.7754792,8.3872574 8.6687415,8.3537661 8.6607053,8.3537661 c -0.03426,0 -0.3092864,0.3066098 -0.3791974,0.42275 -0.041935,0.069664 -0.1040482,0.1266636 -0.1380294,0.1266636 -0.1316419,0 -0.4197402,0.1843928 -0.6257041,0.4004735 -0.1923125,0.2017571 -0.6853701,0.9036038 -0.8926582,1.2706578 -0.042662,0.07554 -0.1803555,0.353687 -0.3059848,0.618091 -0.1256293,0.264406 -0.3270073,0.686768 -0.4475067,0.938581 -0.1204992,0.251816 -0.2469926,0.519654 -0.2810961,0.595199 -0.2592829,0.574347 -0.285919,1.391094 -0.057822,1.77304 0.1690683,0.283105 0.4224039,0.480895 0.7285507,0.568809 0.487122,0.139885 0.9109638,-0.004 1.6013422,-0.543768 l 0.4560939,-0.356568 0.0036,0.172041 c 0.01635,0.781837 0.1831084,1.813183 0.4016641,2.484154 0.1160449,0.356262 0.3781448,0.83968 0.5614081,1.035462 0.2171883,0.232025 0.7140951,0.577268 1.0100284,0.701749 0.121485,0.0511 0.351032,0.110795 0.510105,0.132647 0.396966,0.05452 1.2105,0.02265 1.448934,-0.05679 z"
+}, githubIcon = {
+	viewBox: "0 0 16 16",
+	path: "M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"
+}, starIcon = {
+	viewBox: "0 0 16 16",
+	path: "M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25Z"
+};
+export { githubIcon, starIcon, tangledIcon };

package/dist/identity.d.ts

@@ -0,0 +1,28 @@
+import type { DidCache } from "./cache";
+import type { ServiceResolver } from "./client";
+export interface DidResolutionSnapshot {
+    did?: string;
+    handle?: string;
+    loading: boolean;
+    promise?: Promise<{
+        did?: string;
+        handle?: string;
+    }>;
+}
+export interface PdsEndpointSnapshot {
+    endpoint?: string;
+    loading: boolean;
+    promise?: Promise<string | undefined>;
+}
+export declare function normalizeAtIdentifier(value: string | null | undefined): string | undefined;
+export declare function normalizeHandle(value: string | null | undefined): string | undefined;
+export declare function resolveDidInput(options: {
+    input: string | null | undefined;
+    resolver: ServiceResolver;
+    didCache: DidCache;
+}): DidResolutionSnapshot;
+export declare function resolvePdsEndpoint(options: {
+    did: string | null | undefined;
+    resolver: ServiceResolver;
+    didCache: DidCache;
+}): PdsEndpointSnapshot;

package/dist/identity.js

@@ -0,0 +1,55 @@
+function normalizeAtIdentifier(e) {
+	if (typeof e != "string") return;
+	let t = e.trim();
+	if (!t) return;
+	let n = t.toLowerCase();
+	if (!(n === "null" || n === "undefined" || n.startsWith("null.") || n.startsWith("undefined."))) return t;
+}
+function normalizeHandle(t) {
+	let n = normalizeAtIdentifier(t);
+	if (!(!n || n.startsWith("did:"))) return n.toLowerCase();
+}
+function resolveDidInput(n) {
+	let r = normalizeAtIdentifier(n.input);
+	if (!r) return {
+		did: void 0,
+		handle: void 0,
+		loading: !1
+	};
+	let i = r.startsWith("did:"), a = i ? void 0 : normalizeHandle(r), o = i ? n.didCache.getByDid(r) : n.didCache.getByHandle(a), s = o?.did ?? (i ? r : void 0), c = o?.handle ?? (i ? void 0 : a), l = !i && !!a && !o?.did, u = i && (!o?.doc || o.handle === void 0);
+	if (!l && !u) return {
+		did: s,
+		handle: c,
+		loading: !1
+	};
+	let d = (async () => {
+		let e = o;
+		return !i && a && l && (e = await n.didCache.ensureHandle(n.resolver, a)), i && (e = await n.didCache.ensureDidDoc(n.resolver, r)), {
+			did: e?.did ?? (i ? r : void 0),
+			handle: e?.handle ?? (i ? void 0 : a)
+		};
+	})();
+	return {
+		did: s,
+		handle: c,
+		loading: !0,
+		promise: d
+	};
+}
+function resolvePdsEndpoint(t) {
+	let n = normalizeAtIdentifier(t.did);
+	if (!n) return {
+		endpoint: void 0,
+		loading: !1
+	};
+	let r = t.didCache.getByDid(n);
+	return r?.pdsEndpoint ? {
+		endpoint: r.pdsEndpoint,
+		loading: !1
+	} : {
+		endpoint: void 0,
+		loading: !0,
+		promise: t.didCache.ensurePdsEndpoint(t.resolver, n).then((e) => e.pdsEndpoint)
+	};
+}
+export { normalizeAtIdentifier, normalizeHandle, resolveDidInput, resolvePdsEndpoint };

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export * from "./cache";
+export * from "./client";
+export * from "./fetch-and-cache-handler";
+export * from "./identity";
+export * from "./rpc";
+export * from "./records";
+export * from "./blob-fetch";
+export * from "./backlinks";
+export * from "./tangled-fetch";
+export * from "./types/blob";
+export * from "./types/bluesky";
+export * from "./types/grain";
+export * from "./types/leaflet";
+export * from "./types/record";
+export * from "./types/tangled";
+export * from "./types/teal";
+export * from "./utils/at-uri";
+export * from "./utils/blob";
+export * from "./utils/profile";
+export * from "./utils/richtext";
+export * from "./styles";
+export * from "./paginated";
+export * from "./icons";
+export * from "./music";
+export * from "./utils/time";
+export * from "./grain";
+export * from "./leaflet";

package/dist/index.js

@@ -0,0 +1,22 @@
+import { BlobCache, DidCache, PaginatedRecordsCache, RecordCache, clearSharedCaches, getSharedCacheStats, getSharedCaches, resetSharedCacheStats, sharedBlobCache, sharedDidCache, sharedPaginatedRecordsCache, sharedRecordCache } from "./cache.js";
+import { DEFAULT_CONFIG, SLINGSHOT_BASE_URL, ServiceResolver, createAtprotoClient, normalizeBaseUrl } from "./client.js";
+import { callAppviewRpc, callGetRecord, callListRecords } from "./rpc.js";
+import { extractCidFromBlob, extractCidFromCdnUrl, getBlobImageUrl, isBlobWithCdn } from "./utils/blob.js";
+import { ensureCachedRecord, extractRkey, fetchBlueskyRecord, fetchBlueskyRecordUncached, fetchLatestRecord, fetchPaginatedRecordsPage, fetchRepositoryRecord, getBlueskyRecord, isValidTimestamp, primeBlueskyFeedCache, primeBlueskyProfileCache } from "./records.js";
+import { createFetchAndCacheHandler, primeBlueskyAppviewPayload, primeResponseFromAppview } from "./fetch-and-cache-handler.js";
+import { normalizeAtIdentifier, normalizeHandle, resolveDidInput, resolvePdsEndpoint } from "./identity.js";
+import { fetchBlob, getBlob } from "./blob-fetch.js";
+import { fetchBacklinks } from "./backlinks.js";
+import { fetchRepoLanguages } from "./tangled-fetch.js";
+import { DEFAULT_LATEST_RECORD_COLLECTION, DEFAULT_RECORD_COLLECTION, resolveRecordCollection } from "./types/record.js";
+import { formatDidForLabel, leafletRkeyUrl, normalizeLeafletBasePath, parseAtUri, toBlueskyPostUrl } from "./utils/at-uri.js";
+import { getAvatarCid } from "./utils/profile.js";
+import { createRichTextSegments, createTextSegments } from "./utils/richtext.js";
+import { blueskyPostListStyles, cardStyles, grainGalleryStyles, grainStyles, leafletDocStyles, leafletStyles, mergeStyles, postStyles, profileStyles, songHistoryStyles, styleString, tangledStringStyles, tangledStyles, tealStatusStyles, tealStyles } from "./styles.js";
+import { PaginatedRecordsController, paginatedControllerKey } from "./paginated.js";
+import { githubIcon, starIcon, tangledIcon } from "./icons.js";
+import { availableMusicPlatforms, fetchTrackArtwork, musicPlatforms } from "./music.js";
+import { formatRelativeTime } from "./utils/time.js";
+import { GRAIN_GALLERY_COLLECTION, GRAIN_GALLERY_ITEM_COLLECTION, GRAIN_PHOTO_COLLECTION, fetchGrainGalleryPhotos } from "./grain.js";
+import { createLeafletSegments, leafletAlignment } from "./leaflet.js";
+export { BlobCache, DEFAULT_CONFIG, DEFAULT_LATEST_RECORD_COLLECTION, DEFAULT_RECORD_COLLECTION, DidCache, GRAIN_GALLERY_COLLECTION, GRAIN_GALLERY_ITEM_COLLECTION, GRAIN_PHOTO_COLLECTION, PaginatedRecordsCache, PaginatedRecordsController, RecordCache, SLINGSHOT_BASE_URL, ServiceResolver, availableMusicPlatforms, blueskyPostListStyles, callAppviewRpc, callGetRecord, callListRecords, cardStyles, clearSharedCaches, createAtprotoClient, createFetchAndCacheHandler, createLeafletSegments, createRichTextSegments, createTextSegments, ensureCachedRecord, extractCidFromBlob, extractCidFromCdnUrl, extractRkey, fetchBacklinks, fetchBlob, fetchBlueskyRecord, fetchBlueskyRecordUncached, fetchGrainGalleryPhotos, fetchLatestRecord, fetchPaginatedRecordsPage, fetchRepoLanguages, fetchRepositoryRecord, fetchTrackArtwork, formatDidForLabel, formatRelativeTime, getAvatarCid, getBlob, getBlobImageUrl, getBlueskyRecord, getSharedCacheStats, getSharedCaches, githubIcon, grainGalleryStyles, grainStyles, isBlobWithCdn, isValidTimestamp, leafletAlignment, leafletDocStyles, leafletRkeyUrl, leafletStyles, mergeStyles, musicPlatforms, normalizeAtIdentifier, normalizeBaseUrl, normalizeHandle, normalizeLeafletBasePath, paginatedControllerKey, parseAtUri, postStyles, primeBlueskyAppviewPayload, primeBlueskyFeedCache, primeBlueskyProfileCache, primeResponseFromAppview, profileStyles, resetSharedCacheStats, resolveDidInput, resolvePdsEndpoint, resolveRecordCollection, sharedBlobCache, sharedDidCache, sharedPaginatedRecordsCache, sharedRecordCache, songHistoryStyles, starIcon, styleString, tangledIcon, tangledStringStyles, tangledStyles, tealStatusStyles, tealStyles, toBlueskyPostUrl };

package/dist/leaflet.d.ts

@@ -0,0 +1,22 @@
+import type { LeafletRichTextFacet, LeafletAlignmentValue } from "./types/leaflet";
+/** A run of text with resolved rich-text styling flags. */
+export interface LeafletSegment {
+    text: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strike?: boolean;
+    code?: boolean;
+    highlight?: boolean;
+    link?: string;
+    id?: string;
+}
+export type LeafletTextAlign = "left" | "center" | "right" | "justify" | undefined;
+/** Resolves a leaflet alignment lex value to a CSS text-align. */
+export declare function leafletAlignment(value?: LeafletAlignmentValue): LeafletTextAlign;
+/**
+ * Splits leaflet block plaintext into styled segments using its rich-text facets.
+ * Facet byte ranges are converted to char ranges; overlapping facets are merged
+ * into flat style flags per run, so any framework can render them simply.
+ */
+export declare function createLeafletSegments(plaintext: string, facets?: LeafletRichTextFacet[]): LeafletSegment[];

package/dist/leaflet.js

@@ -0,0 +1,85 @@
+function leafletAlignment(e) {
+	if (!e) return;
+	let t = e.startsWith("#") ? e.slice(1) : e;
+	switch (t.includes("#") && (t = t.split("#").pop() ?? t), t.startsWith("lex:") && (t = t.split(":").pop() ?? t), t) {
+		case "textAlignLeft": return "left";
+		case "textAlignCenter": return "center";
+		case "textAlignRight": return "right";
+		case "textAlignJustify": return "justify";
+		default: return;
+	}
+}
+function buildBytePrefix(e) {
+	let t = new TextEncoder(), n = [0], r = 0;
+	for (let i = 0; i < e.length;) {
+		let a = e.codePointAt(i), o = t.encode(String.fromCodePoint(a));
+		r += o.length, n.push(r), i += a > 65535 ? 2 : 1;
+	}
+	return n;
+}
+function byteOffsetToCharIndex(e, t) {
+	for (let n = 0; n < e.length; n++) {
+		if (e[n] === t) return n;
+		if (e[n] > t) return Math.max(0, n - 1);
+	}
+	return e.length - 1;
+}
+function sliceByCharRange(e, t, n) {
+	if (t <= 0 && n >= e.length) return e;
+	let r = "", i = 0;
+	for (let a = 0; a < e.length && i < n;) {
+		let o = e.codePointAt(a);
+		i >= t && i < n && (r += String.fromCodePoint(o)), a += o > 65535 ? 2 : 1, i++;
+	}
+	return r;
+}
+function applyFeatures(e, t) {
+	for (let n of t) switch (n.$type) {
+		case "pub.leaflet.richtext.facet#link":
+			e.link = n.uri;
+			break;
+		case "pub.leaflet.richtext.facet#code":
+			e.code = !0;
+			break;
+		case "pub.leaflet.richtext.facet#highlight":
+			e.highlight = !0;
+			break;
+		case "pub.leaflet.richtext.facet#underline":
+			e.underline = !0;
+			break;
+		case "pub.leaflet.richtext.facet#strikethrough":
+			e.strike = !0;
+			break;
+		case "pub.leaflet.richtext.facet#bold":
+			e.bold = !0;
+			break;
+		case "pub.leaflet.richtext.facet#italic":
+			e.italic = !0;
+			break;
+		case "pub.leaflet.richtext.facet#id":
+			e.id = n.id;
+			break;
+	}
+	return e;
+}
+function createLeafletSegments(e, a) {
+	if (!a?.length) return [{ text: e }];
+	let o = buildBytePrefix(e), s = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Map(), l = new Set([0, o.length - 1]);
+	for (let e of a) {
+		let { byteStart: t, byteEnd: r } = e.index ?? {};
+		if (typeof t != "number" || typeof r != "number" || t >= r) continue;
+		let i = byteOffsetToCharIndex(o, t), a = byteOffsetToCharIndex(o, r);
+		i >= a || (l.add(i), l.add(a), e.features?.length && (s.set(i, [...s.get(i) ?? [], ...e.features]), c.set(a, [...c.get(a) ?? [], ...e.features])));
+	}
+	let u = Array.from(l).sort((e, t) => e - t), d = [], f = [];
+	for (let t = 0; t < u.length - 1; t++) {
+		let n = u[t], a = u[t + 1], o = c.get(n);
+		o?.length && (f = f.filter((e) => !o.includes(e)));
+		let l = s.get(n);
+		if (l?.length && (f = [...f, ...l]), n === a) continue;
+		let p = sliceByCharRange(e, n, a);
+		d.push(applyFeatures({ text: p }, f));
+	}
+	return d;
+}
+export { createLeafletSegments, leafletAlignment };

package/dist/music.d.ts

@@ -0,0 +1,35 @@
+import type { TealPlayItem } from "./types/teal";
+export interface SonglinkPlatform {
+    url: string;
+    entityUniqueId: string;
+    nativeAppUriMobile?: string;
+    nativeAppUriDesktop?: string;
+}
+export interface SonglinkResponse {
+    entityUniqueId?: string;
+    linksByPlatform: Record<string, SonglinkPlatform>;
+    entitiesByUniqueId: Record<string, {
+        thumbnailUrl?: string;
+        title?: string;
+        artistName?: string;
+    }>;
+}
+export interface TrackArtwork {
+    albumArt?: string;
+    songlink?: SonglinkResponse;
+}
+/** Music streaming platforms recognised in Songlink results, with brand icon + colour. */
+export interface MusicPlatform {
+    name: string;
+    svg: string;
+    color: string;
+}
+export declare const musicPlatforms: Record<string, MusicPlatform>;
+/** Platforms (in display order) that have a link in the given Songlink response. */
+export declare function availableMusicPlatforms(songlink?: SonglinkResponse): string[];
+/**
+ * Resolves album artwork + cross-platform streaming links for a teal.fm play item.
+ * Tries Songlink-by-ISRC, then iTunes search (+ Songlink by iTunes id), then
+ * Songlink-by-originUrl. Network-only; safe to call from any framework.
+ */
+export declare function fetchTrackArtwork(item: TealPlayItem, signal?: AbortSignal): Promise<TrackArtwork>;