@openrails/contentkit-ui 0.85.1 → 0.87.0-rc.1

package/dist/components/content/grid.js

@@ -1,62 +1,62 @@
 import { useMessages as e } from "../../i18n/context.js";
 import { ContentKitUiRoot as t } from "../../scope.js";
 import { ContentKitContext as n } from "../../react/context.js";
-import { Button as r } from "../../ui/button.js";
-import { useNearViewport as i } from "../../react/viewport.js";
-import { Skeleton as a } from "../../ui/skeleton.js";
-import { contentError as o, useAction as s } from "../social/parts.js";
-import { useKinds as c } from "../../react/groups.js";
-import { useContents as l, useExposure as u, useHistory as d, useRecommendations as f, useSearch as p, useSimilar as m } from "../../react/discovery.js";
-import { ContentCard as h } from "./card.js";
-import { useContext as g, useEffect as _, useMemo as v } from "react";
-import { jsx as y, jsxs as b } from "react/jsx-runtime";
-import { cn as x } from "cn";
+import { useKinds as r } from "../../react/groups.js";
+import { Button as i } from "../../ui/button.js";
+import { useNearViewport as a } from "../../react/viewport.js";
+import { Skeleton as o } from "../../ui/skeleton.js";
+import { contentError as s, useAction as c } from "../social/parts.js";
+import { useContents as l, useExposure as u, useHistory as d, useLockedCount as f, useRecommendations as p, useSearch as m, useSimilar as h } from "../../react/discovery.js";
+import { ContentCard as g } from "./card.js";
+import { useContext as _, useEffect as v, useMemo as y, useState as b } from "react";
+import { Fragment as x, jsx as S, jsxs as C } from "react/jsx-runtime";
+import { cn as w } from "cn";
 //#region src/components/content/grid.tsx
-var S = "grid grid-cols-[repeat(auto-fill,minmax(min(100%,10rem),1fr))] gap-x-4 gap-y-6";
-function C({ list: n, render: s, ...l }) {
-	let d = e(), { t: f } = d, { kinds: p } = c({ client: l.client }), m = u(n.items, {
+var T = "grid grid-cols-[repeat(auto-fill,minmax(min(100%,10rem),1fr))] gap-x-4 gap-y-6";
+function E({ list: n, render: c, ...l }) {
+	let d = e(), { t: f } = d, { kinds: p } = r({ client: l.client }), m = u(n.items, {
 		surface: l.surface ?? "list",
-		render: s,
+		render: c,
 		client: l.client
-	}), [g, v] = i({
+	}), [h, _] = a({
 		margin: "600px 0px",
 		leaveMargin: "1200px 0px"
-	}), { hasMore: C, loadingMore: w, loadMore: T } = n;
-	_(() => {
-		l.infinite && v && C && !w && T();
+	}), { hasMore: y, loadingMore: b, loadMore: x } = n;
+	v(() => {
+		l.infinite && _ && y && !b && x();
 	}, [
 		l.infinite,
-		v,
-		C,
-		w,
-		T
+		_,
+		y,
+		b,
+		x
 	]);
 	let E = l.tiers ?? p?.tiers;
-	return /* @__PURE__ */ b(t, {
+	return /* @__PURE__ */ C(t, {
 		appearance: l.appearance,
-		className: x("grid gap-4 text-sm", l.className),
+		className: w("grid gap-4 text-sm", l.className),
 		"data-ckui": "content-grid",
 		"aria-busy": n.loading,
-		children: [n.loading && !n.items.length ? /* @__PURE__ */ y("div", {
-			className: S,
-			children: Array.from({ length: 8 }, (e, t) => /* @__PURE__ */ y(a, { className: l.shape === "landscape" ? "aspect-video w-full" : "aspect-[3/4] w-full" }, t))
-		}) : n.error && !n.items.length ? /* @__PURE__ */ b("div", {
+		children: [n.loading && !n.items.length ? /* @__PURE__ */ S("div", {
+			className: T,
+			children: Array.from({ length: 8 }, (e, t) => /* @__PURE__ */ S(o, { className: l.shape === "landscape" ? "aspect-video w-full" : "aspect-[3/4] w-full" }, t))
+		}) : n.error && !n.items.length ? /* @__PURE__ */ C("div", {
 			role: "alert",
 			className: "grid justify-items-start gap-2",
-			children: [/* @__PURE__ */ y("p", {
+			children: [/* @__PURE__ */ S("p", {
 				className: "text-destructive",
-				children: o(d, n.error)
-			}), /* @__PURE__ */ y(r, {
+				children: s(d, n.error)
+			}), /* @__PURE__ */ S(i, {
 				size: "sm",
 				variant: "outline",
 				onClick: n.reload,
 				children: f("common.retry")
 			})]
-		}) : n.items.length ? /* @__PURE__ */ y("ol", {
-			className: S,
-			children: n.items.map((e, t) => /* @__PURE__ */ y("li", {
+		}) : n.items.length ? /* @__PURE__ */ S("ol", {
+			className: T,
+			children: n.items.map((e, t) => /* @__PURE__ */ S("li", {
 				ref: m.track(e.id, t + 1),
-				children: l.renderCard ? l.renderCard(e, t + 1) : /* @__PURE__ */ y(h, {
+				children: l.renderCard ? l.renderCard(e, t + 1) : /* @__PURE__ */ S(g, {
 					card: e,
 					href: l.href,
 					shape: l.shape,
@@ -66,17 +66,18 @@ function C({ list: n, render: s, ...l }) {
 					labels: l.labels,
 					owner: l.owner,
 					ownerHref: l.ownerHref,
+					decorate: l.decorate,
 					onOpen: () => m.click(e.id, t + 1)
 				})
 			}, e.id))
-		}) : /* @__PURE__ */ y("div", {
+		}) : /* @__PURE__ */ S("div", {
 			className: "text-muted-foreground",
 			role: "status",
 			children: l.empty ?? f("contents.empty")
-		}), n.hasMore && /* @__PURE__ */ y("div", {
-			ref: g,
+		}), n.hasMore && /* @__PURE__ */ S("div", {
+			ref: h,
 			className: "grid justify-items-center",
-			children: /* @__PURE__ */ y(r, {
+			children: /* @__PURE__ */ S(i, {
 				variant: "outline",
 				size: "sm",
 				disabled: n.loadingMore,
@@ -86,23 +87,69 @@ function C({ list: n, render: s, ...l }) {
 		})]
 	});
 }
-function w({ query: e, ...t }) {
-	let n = v(() => ({
+var D = [
+	"tier",
+	"group",
+	"ppv",
+	"group_ppv"
+];
+function O({ query: e, locked: t = "show", ...n }) {
+	let r = y(() => ({
 		...e,
-		limit: e.limit ?? t.pageSize
-	}), [e, t.pageSize]), r = l(n, { client: t.client });
-	return /* @__PURE__ */ y(C, {
-		...t,
-		list: r,
-		render: JSON.stringify(n)
-	});
+		limit: e.limit ?? n.pageSize,
+		...t === "show" ? {} : { mode: "hide" }
+	}), [
+		e,
+		n.pageSize,
+		t
+	]), i = l(r, { client: n.client });
+	return /* @__PURE__ */ C(x, { children: [t === "collapse" && /* @__PURE__ */ S(k, {
+		...n,
+		query: e
+	}), /* @__PURE__ */ S(E, {
+		...n,
+		list: i,
+		render: JSON.stringify(r)
+	})] });
 }
-function T({ query: t, ...n }) {
-	let { t: r } = e(), i = v(() => ({
+function k({ query: n, ...r }) {
+	let a = e(), [o, s] = b(!1), { count: c } = f(n, { client: r.client }), u = y(() => o ? {
+		...n,
+		mode: "lock",
+		access: n.access ?? D,
+		limit: n.limit ?? r.pageSize
+	} : null, [
+		o,
+		n,
+		r.pageSize
+	]), d = l(u, { client: r.client }), p = y(() => d.items.filter((e) => !e.access.allowed), [d.items]);
+	return c ? /* @__PURE__ */ C(t, {
+		appearance: r.appearance,
+		className: "grid gap-3 text-sm",
+		"data-ckui": "locked-cards",
+		children: [/* @__PURE__ */ S(i, {
+			variant: "outline",
+			size: "sm",
+			className: "justify-self-start",
+			"aria-expanded": o,
+			onClick: () => s(!o),
+			children: o ? a.t("contents.lockedHide") : a.plural("contents.lockedShow", c)
+		}), o && /* @__PURE__ */ S(E, {
+			...r,
+			list: {
+				...d,
+				items: p
+			},
+			render: JSON.stringify(u)
+		})]
+	}) : null;
+}
+function A({ query: t, ...n }) {
+	let { t: r } = e(), i = y(() => ({
 		...t,
 		limit: t.limit ?? n.pageSize
-	}), [t, n.pageSize]), a = p(i, { client: n.client });
-	return t.q.trim() ? /* @__PURE__ */ y(C, {
+	}), [t, n.pageSize]), a = m(i, { client: n.client });
+	return t.q.trim() ? /* @__PURE__ */ S(E, {
 		surface: "search",
 		empty: r("contents.noResults", { q: t.q.trim() }),
 		...n,
@@ -110,41 +157,42 @@ function T({ query: t, ...n }) {
 		render: JSON.stringify(i)
 	}) : null;
 }
-function E({ query: t = {}, ...i }) {
-	let { t: a } = e(), o = g(n), c = v(() => ({
+function j({ query: t = {}, ...r }) {
+	let { t: a } = e(), o = _(n), s = y(() => ({
 		...t,
-		limit: t.limit ?? i.pageSize
-	}), [t, i.pageSize]), l = d(c, { client: i.client }), u = s("history.forget");
-	return o?.viewer === null ? /* @__PURE__ */ y("p", {
+		limit: t.limit ?? r.pageSize
+	}), [t, r.pageSize]), l = d(s, { client: r.client }), u = c("history.forget");
+	return o?.viewer === null ? /* @__PURE__ */ S("p", {
 		className: "text-muted-foreground",
 		children: a("contents.historySignedOut")
-	}) : /* @__PURE__ */ b("div", {
+	}) : /* @__PURE__ */ C("div", {
 		className: "grid gap-3",
 		"data-ckui": "content-history",
-		children: [l.items.length > 0 && /* @__PURE__ */ y(r, {
+		children: [l.items.length > 0 && /* @__PURE__ */ S(i, {
 			size: "sm",
 			variant: "outline",
 			className: "justify-self-end",
 			disabled: u.pending,
 			onClick: () => void u.run(() => l.forget(t.kind ? { kind: t.kind } : {})),
 			children: a("contents.clearHistory")
-		}), /* @__PURE__ */ y(C, {
+		}), /* @__PURE__ */ S(E, {
 			surface: "history",
 			empty: a("contents.historyEmpty"),
-			...i,
+			...r,
 			list: l,
-			render: JSON.stringify(c),
-			renderCard: i.renderCard ?? ((e) => /* @__PURE__ */ y(h, {
+			render: JSON.stringify(s),
+			renderCard: r.renderCard ?? ((e) => /* @__PURE__ */ S(g, {
 				card: e,
-				href: i.href,
-				shape: i.shape,
-				groupKinds: i.groupKinds,
-				chips: i.chips,
-				tiers: i.tiers,
-				labels: i.labels,
-				owner: i.owner,
-				ownerHref: i.ownerHref,
-				children: /* @__PURE__ */ y(r, {
+				href: r.href,
+				shape: r.shape,
+				groupKinds: r.groupKinds,
+				chips: r.chips,
+				tiers: r.tiers,
+				labels: r.labels,
+				owner: r.owner,
+				ownerHref: r.ownerHref,
+				decorate: r.decorate,
+				children: /* @__PURE__ */ S(i, {
 					size: "xs",
 					variant: "ghost",
 					className: "justify-self-start",
@@ -156,26 +204,26 @@ function E({ query: t = {}, ...i }) {
 		})]
 	});
 }
-function D({ title: e, similar: n, recommendations: r, history: i, group: o, list: s, query: p = {}, more: g, ..._ }) {
-	let S = p.limit ?? _.pageSize ?? 12, C = v(() => ({
-		...p,
-		limit: S
-	}), [p, S]), w = v(() => s ? {
-		...s,
-		limit: s.limit ?? S
-	} : o ? {
-		groups: [o],
+function M({ title: e, similar: n, recommendations: i, history: a, group: s, list: c, query: f = {}, more: m, ..._ }) {
+	let v = f.limit ?? _.pageSize ?? 12, b = y(() => ({
+		...f,
+		limit: v
+	}), [f, v]), x = y(() => c ? {
+		...c,
+		limit: c.limit ?? v
+	} : s ? {
+		groups: [s],
 		sort: "position",
-		limit: S
+		limit: v
 	} : null, [
+		c,
 		s,
-		o,
-		S
-	]), T = m(r || i || w ? null : n, C, { client: _.client }), E = f(r ? C : null, { client: _.client }), D = d(i ? {
-		...i,
-		limit: i.limit ?? S
-	} : null, { client: _.client }), O = l(w, { client: _.client }), k = r ? E : i || w ? (() => {
-		let e = i ? D : O;
+		v
+	]), T = h(i || a || x ? null : n, b, { client: _.client }), E = p(i ? b : null, { client: _.client }), D = d(a ? {
+		...a,
+		limit: a.limit ?? v
+	} : null, { client: _.client }), O = l(x, { client: _.client }), k = i ? E : a || x ? (() => {
+		let e = a ? D : O;
 		return {
 			items: e.items,
 			loading: e.loading,
@@ -183,35 +231,35 @@ function D({ title: e, similar: n, recommendations: r, history: i, group: o, lis
 			unavailable: e.error?.code === "not_configured",
 			reload: e.reload
 		};
-	})() : T, { kinds: A } = c({ client: _.client }), j = _.surface ?? (r ? "recommendations" : i ? "history" : o ? "featured" : w ? "list" : "similar"), M = u(k.items, {
+	})() : T, { kinds: A } = r({ client: _.client }), j = _.surface ?? (i ? "recommendations" : a ? "history" : s ? "featured" : x ? "list" : "similar"), M = u(k.items, {
 		surface: j,
 		render: JSON.stringify([
 			n,
-			r,
 			i,
-			o,
-			w,
-			C
+			a,
+			s,
+			x,
+			b
 		]),
 		client: _.client
 	});
-	return !(n || r || i || o || w) || k.unavailable || !k.loading && !k.items.length ? null : /* @__PURE__ */ b(t, {
+	return !(n || i || a || s || x) || k.unavailable || !k.loading && !k.items.length ? null : /* @__PURE__ */ C(t, {
 		appearance: _.appearance,
-		className: x("grid gap-3 text-sm", _.className),
+		className: w("grid gap-3 text-sm", _.className),
 		"data-ckui": "content-rail",
 		"data-surface": j,
-		children: [/* @__PURE__ */ b("div", {
+		children: [/* @__PURE__ */ C("div", {
 			className: "flex items-baseline justify-between gap-2",
-			children: [/* @__PURE__ */ y("h2", {
+			children: [/* @__PURE__ */ S("h2", {
 				className: "text-base font-semibold",
 				children: e
-			}), g]
-		}), /* @__PURE__ */ y("ol", {
+			}), m]
+		}), /* @__PURE__ */ S("ol", {
 			className: "flex snap-x gap-4 overflow-x-auto pb-2",
-			children: (k.loading && !k.items.length ? Array.from({ length: 6 }, () => null) : k.items).map((e, t) => /* @__PURE__ */ y("li", {
+			children: (k.loading && !k.items.length ? Array.from({ length: 6 }, () => null) : k.items).map((e, t) => /* @__PURE__ */ S("li", {
 				className: "w-36 shrink-0 snap-start sm:w-44",
 				ref: e ? M.track(e.id, t + 1) : void 0,
-				children: e ? _.renderCard ? _.renderCard(e, t + 1) : /* @__PURE__ */ y(h, {
+				children: e ? _.renderCard ? _.renderCard(e, t + 1) : /* @__PURE__ */ S(g, {
 					card: e,
 					href: _.href,
 					shape: _.shape,
@@ -221,13 +269,14 @@ function D({ title: e, similar: n, recommendations: r, history: i, group: o, lis
 					labels: _.labels,
 					owner: _.owner,
 					ownerHref: _.ownerHref,
+					decorate: _.decorate,
 					onOpen: () => M.click(e.id, t + 1)
-				}) : /* @__PURE__ */ y(a, { className: _.shape === "landscape" ? "aspect-video w-full" : "aspect-[3/4] w-full" })
+				}) : /* @__PURE__ */ S(o, { className: _.shape === "landscape" ? "aspect-video w-full" : "aspect-[3/4] w-full" })
 			}, e?.id ?? t))
 		})]
 	});
 }
 //#endregion
-export { C as CardGrid, w as ContentGrid, E as ContentHistory, D as ContentRail, T as SearchResults };
+export { E as CardGrid, O as ContentGrid, j as ContentHistory, M as ContentRail, A as SearchResults };
 
 //# sourceMappingURL=grid.js.map

package/dist/components/content/grid.js.map

@@ -1 +1 @@
-{"version":3,"file":"grid.js","names":[],"sources":["../../../src/components/content/grid.tsx"],"sourcesContent":["import { cn } from \"cn\";\nimport { useContext, useEffect, useMemo, type ReactNode } from \"react\";\nimport type { ContentKitUiAppearance } from \"../../appearance.js\";\nimport type { ContentKitClient } from \"../../client/client.js\";\nimport type { ContentQuery, HistoryQuery, RailQuery, SearchQuery } from \"../../client/discovery.js\";\nimport type { Card } from \"../../client/generated/wire.js\";\nimport { useMessages } from \"../../i18n/context.js\";\nimport { ContentKitContext } from \"../../react/context.js\";\nimport { useContents, useExposure, useHistory, useRecommendations, useSearch, useSimilar, type UseRail } from \"../../react/discovery.js\";\nimport { useKinds } from \"../../react/groups.js\";\nimport type { UseList } from \"../../react/use-resource.js\";\nimport { useNearViewport } from \"../../react/viewport.js\";\nimport { ContentKitUiRoot } from \"../../scope.js\";\nimport { Button } from \"#ckui/ui/button\";\nimport { Skeleton } from \"#ckui/ui/skeleton\";\nimport { contentError, useAction } from \"../social/parts.js\";\nimport { ContentCard, type ContentCardProps } from \"./card.js\";\n\nexport interface CardListProps extends Omit<ContentCardProps, \"card\" | \"onOpen\" | \"children\" | \"className\"> {\n  /** Where the list is, for exposures and click attribution: \"home\", \"search\", \"similar\". */\n  surface?: string;\n  /** Loads the next page as the end nears, instead of a button. */\n  infinite?: boolean;\n  /** A card's entry instead of ContentCard. */\n  renderCard?: (card: Card, position: number) => ReactNode;\n  /** Shown when nothing matches. */\n  empty?: ReactNode;\n  pageSize?: number;\n  client?: ContentKitClient;\n  className?: string;\n  appearance?: ContentKitUiAppearance;\n}\n\nconst GRID = \"grid grid-cols-[repeat(auto-fill,minmax(min(100%,10rem),1fr))] gap-x-4 gap-y-6\";\n\n/** A list's cards in a responsive grid, paged, with exposures and click signals. */\nexport function CardGrid({ list, render, ...p }: CardListProps & { list: UseList<Card>; render: string }) {\n  const m = useMessages();\n  const { t } = m;\n  const { kinds } = useKinds({ client: p.client });\n  const exposure = useExposure(list.items, { surface: p.surface ?? \"list\", render, client: p.client });\n  const [sentinel, near] = useNearViewport({ margin: \"600px 0px\", leaveMargin: \"1200px 0px\" });\n  const { hasMore, loadingMore, loadMore } = list;\n  useEffect(() => {\n    if (p.infinite && near && hasMore && !loadingMore) void loadMore();\n  }, [p.infinite, near, hasMore, loadingMore, loadMore]);\n  const tiers = p.tiers ?? kinds?.tiers;\n  return (\n    <ContentKitUiRoot appearance={p.appearance} className={cn(\"grid gap-4 text-sm\", p.className)} data-ckui=\"content-grid\" aria-busy={list.loading}>\n      {list.loading && !list.items.length ? (\n        <div className={GRID}>\n          {Array.from({ length: 8 }, (_, i) => (\n            <Skeleton key={i} className={p.shape === \"landscape\" ? \"aspect-video w-full\" : \"aspect-[3/4] w-full\"} />\n          ))}\n        </div>\n      ) : list.error && !list.items.length ? (\n        <div role=\"alert\" className=\"grid justify-items-start gap-2\">\n          <p className=\"text-destructive\">{contentError(m, list.error)}</p>\n          <Button size=\"sm\" variant=\"outline\" onClick={list.reload}>\n            {t(\"common.retry\")}\n          </Button>\n        </div>\n      ) : !list.items.length ? (\n        <div className=\"text-muted-foreground\" role=\"status\">\n          {p.empty ?? t(\"contents.empty\")}\n        </div>\n      ) : (\n        <ol className={GRID}>\n          {list.items.map((card, i) => (\n            <li key={card.id} ref={exposure.track(card.id, i + 1)}>\n              {p.renderCard ? (\n                p.renderCard(card, i + 1)\n              ) : (\n                <ContentCard\n                  card={card}\n                  href={p.href}\n                  shape={p.shape}\n                  groupKinds={p.groupKinds}\n                  chips={p.chips}\n                  tiers={tiers}\n                  labels={p.labels}\n                  owner={p.owner}\n                  ownerHref={p.ownerHref}\n                  onOpen={() => exposure.click(card.id, i + 1)}\n                />\n              )}\n            </li>\n          ))}\n        </ol>\n      )}\n      {list.hasMore && (\n        <div ref={sentinel} className=\"grid justify-items-center\">\n          <Button variant=\"outline\" size=\"sm\" disabled={list.loadingMore} onClick={() => void list.loadMore()}>\n            {list.loadingMore ? t(\"contents.loading\") : t(\"contents.loadMore\")}\n          </Button>\n        </div>\n      )}\n    </ContentKitUiRoot>\n  );\n}\n\n/** Contents as cards (GET /v1/contents): any sort and filter, paged. */\nexport function ContentGrid({ query, ...p }: CardListProps & { query: ContentQuery }) {\n  const q = useMemo(() => ({ ...query, limit: query.limit ?? p.pageSize }), [query, p.pageSize]);\n  const list = useContents(q, { client: p.client });\n  return <CardGrid {...p} list={list} render={JSON.stringify(q)} />;\n}\n\n/** Search results as cards; nothing until the query has text. */\nexport function SearchResults({ query, ...p }: CardListProps & { query: SearchQuery }) {\n  const { t } = useMessages();\n  const q = useMemo(() => ({ ...query, limit: query.limit ?? p.pageSize }), [query, p.pageSize]);\n  const list = useSearch(q, { client: p.client });\n  if (!query.q.trim()) return null;\n  return <CardGrid surface=\"search\" empty={t(\"contents.noResults\", { q: query.q.trim() })} {...p} list={list} render={JSON.stringify(q)} />;\n}\n\n/** The signed-in reader's history as cards, each removable, with a clear-all. */\nexport function ContentHistory({ query = {}, ...p }: CardListProps & { query?: HistoryQuery }) {\n  const { t } = useMessages();\n  const ctx = useContext(ContentKitContext);\n  const q = useMemo(() => ({ ...query, limit: query.limit ?? p.pageSize }), [query, p.pageSize]);\n  const list = useHistory(q, { client: p.client });\n  const forget = useAction(\"history.forget\");\n  if (ctx?.viewer === null) return <p className=\"text-muted-foreground\">{t(\"contents.historySignedOut\")}</p>;\n  return (\n    <div className=\"grid gap-3\" data-ckui=\"content-history\">\n      {list.items.length > 0 && (\n        <Button size=\"sm\" variant=\"outline\" className=\"justify-self-end\" disabled={forget.pending} onClick={() => void forget.run(() => list.forget(query.kind ? { kind: query.kind } : {}))}>\n          {t(\"contents.clearHistory\")}\n        </Button>\n      )}\n      <CardGrid\n        surface=\"history\"\n        empty={t(\"contents.historyEmpty\")}\n        {...p}\n        list={list}\n        render={JSON.stringify(q)}\n        renderCard={\n          p.renderCard ??\n          ((card) => (\n            <ContentCard\n              card={card}\n              href={p.href}\n              shape={p.shape}\n              groupKinds={p.groupKinds}\n              chips={p.chips}\n              tiers={p.tiers}\n              labels={p.labels}\n              owner={p.owner}\n              ownerHref={p.ownerHref}\n            >\n              <Button size=\"xs\" variant=\"ghost\" className=\"justify-self-start\" disabled={forget.pending} onClick={() => void forget.run(() => list.forget({ content_id: card.id }))}>\n                {t(\"contents.removeFromHistory\")}\n              </Button>\n            </ContentCard>\n          ))\n        }\n      />\n    </div>\n  );\n}\n\nexport interface ContentRailProps extends Omit<CardListProps, \"infinite\" | \"empty\"> {\n  /** The rail's heading. */\n  title: ReactNode;\n  /** Contents like this one. */\n  similar?: string;\n  /** For the signed-in reader. */\n  recommendations?: boolean;\n  /** The reader's history: { status: \"in_progress\" } is a continue-watching rail. */\n  history?: HistoryQuery;\n  /** An ordered group's members in its order: a featured rail (its windows apply). */\n  group?: string;\n  /** Any list: a sort and filters. */\n  list?: ContentQuery;\n  /** Filters and reader options of a similar or recommended rail. */\n  query?: RailQuery;\n  /** A link beside the heading, e.g. to the whole list. */\n  more?: ReactNode;\n}\n\n/**\n * A horizontal row of contents: similar, recommended, the reader's history,\n * an ordered group's members or any list. It hides itself when it has none or\n * the site runs without what it needs.\n */\nexport function ContentRail({ title, similar, recommendations, history, group, list: listQuery, query = {}, more, ...p }: ContentRailProps) {\n  const limit = query.limit ?? p.pageSize ?? 12;\n  const q = useMemo(() => ({ ...query, limit }), [query, limit]);\n  const listing = useMemo(\n    () => (listQuery ? { ...listQuery, limit: listQuery.limit ?? limit } : group ? { groups: [group], sort: \"position\" as const, limit } : null),\n    [listQuery, group, limit],\n  );\n  const like = useSimilar(recommendations || history || listing ? null : similar, q, { client: p.client });\n  const mine = useRecommendations(recommendations ? q : null, { client: p.client });\n  const seen = useHistory(history ? { ...history, limit: history.limit ?? limit } : null, { client: p.client });\n  const listed = useContents(listing, { client: p.client });\n  const rail: UseRail = recommendations\n    ? mine\n    : history || listing\n      ? (() => {\n          const l = history ? seen : listed;\n          return { items: l.items, loading: l.loading, error: l.error, unavailable: l.error?.code === \"not_configured\", reload: l.reload };\n        })()\n      : like;\n  const { kinds } = useKinds({ client: p.client });\n  const surface = p.surface ?? (recommendations ? \"recommendations\" : history ? \"history\" : group ? \"featured\" : listing ? \"list\" : \"similar\");\n  const exposure = useExposure(rail.items, { surface, render: JSON.stringify([similar, recommendations, history, group, listing, q]), client: p.client });\n  const source = similar || recommendations || history || group || listing;\n  if (!source || rail.unavailable || (!rail.loading && !rail.items.length)) return null;\n  return (\n    <ContentKitUiRoot appearance={p.appearance} className={cn(\"grid gap-3 text-sm\", p.className)} data-ckui=\"content-rail\" data-surface={surface}>\n      <div className=\"flex items-baseline justify-between gap-2\">\n        <h2 className=\"text-base font-semibold\">{title}</h2>\n        {more}\n      </div>\n      <ol className=\"flex snap-x gap-4 overflow-x-auto pb-2\">\n        {(rail.loading && !rail.items.length ? Array.from({ length: 6 }, () => null) : rail.items).map((card, i) => (\n          <li key={card?.id ?? i} className=\"w-36 shrink-0 snap-start sm:w-44\" ref={card ? exposure.track(card.id, i + 1) : undefined}>\n            {!card ? (\n              <Skeleton className={p.shape === \"landscape\" ? \"aspect-video w-full\" : \"aspect-[3/4] w-full\"} />\n            ) : p.renderCard ? (\n              p.renderCard(card, i + 1)\n            ) : (\n              <ContentCard\n                card={card}\n                href={p.href}\n                shape={p.shape}\n                groupKinds={p.groupKinds}\n                chips={p.chips}\n                tiers={p.tiers ?? kinds?.tiers}\n                labels={p.labels}\n                owner={p.owner}\n                ownerHref={p.ownerHref}\n                onOpen={() => exposure.click(card.id, i + 1)}\n              />\n            )}\n          </li>\n        ))}\n      </ol>\n    </ContentKitUiRoot>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"grid.js","names":[],"sources":["../../../src/components/content/grid.tsx"],"sourcesContent":["import { cn } from \"cn\";\nimport { useContext, useEffect, useMemo, useState, type ReactNode } from \"react\";\nimport type { ContentKitUiAppearance } from \"../../appearance.js\";\nimport type { ContentKitClient } from \"../../client/client.js\";\nimport type { ContentQuery, HistoryQuery, RailQuery, SearchQuery } from \"../../client/discovery.js\";\nimport type { Card } from \"../../client/generated/wire.js\";\nimport { useMessages } from \"../../i18n/context.js\";\nimport { ContentKitContext } from \"../../react/context.js\";\nimport { useContents, useExposure, useHistory, useLockedCount, useRecommendations, useSearch, useSimilar, type UseRail } from \"../../react/discovery.js\";\nimport { useKinds } from \"../../react/groups.js\";\nimport type { UseList } from \"../../react/use-resource.js\";\nimport { useNearViewport } from \"../../react/viewport.js\";\nimport { ContentKitUiRoot } from \"../../scope.js\";\nimport { Button } from \"#ckui/ui/button\";\nimport { Skeleton } from \"#ckui/ui/skeleton\";\nimport { contentError, useAction } from \"../social/parts.js\";\nimport { ContentCard, type ContentCardProps } from \"./card.js\";\n\nexport interface CardListProps extends Omit<ContentCardProps, \"card\" | \"onOpen\" | \"children\" | \"className\"> {\n  /** Where the list is, for exposures and click attribution: \"home\", \"search\", \"similar\". */\n  surface?: string;\n  /** Loads the next page as the end nears, instead of a button. */\n  infinite?: boolean;\n  /** A card's entry instead of ContentCard. */\n  renderCard?: (card: Card, position: number) => ReactNode;\n  /** Shown when nothing matches. */\n  empty?: ReactNode;\n  pageSize?: number;\n  client?: ContentKitClient;\n  className?: string;\n  appearance?: ContentKitUiAppearance;\n}\n\nconst GRID = \"grid grid-cols-[repeat(auto-fill,minmax(min(100%,10rem),1fr))] gap-x-4 gap-y-6\";\n\n/** A list's cards in a responsive grid, paged, with exposures and click signals. */\nexport function CardGrid({ list, render, ...p }: CardListProps & { list: UseList<Card>; render: string }) {\n  const m = useMessages();\n  const { t } = m;\n  const { kinds } = useKinds({ client: p.client });\n  const exposure = useExposure(list.items, { surface: p.surface ?? \"list\", render, client: p.client });\n  const [sentinel, near] = useNearViewport({ margin: \"600px 0px\", leaveMargin: \"1200px 0px\" });\n  const { hasMore, loadingMore, loadMore } = list;\n  useEffect(() => {\n    if (p.infinite && near && hasMore && !loadingMore) void loadMore();\n  }, [p.infinite, near, hasMore, loadingMore, loadMore]);\n  const tiers = p.tiers ?? kinds?.tiers;\n  return (\n    <ContentKitUiRoot appearance={p.appearance} className={cn(\"grid gap-4 text-sm\", p.className)} data-ckui=\"content-grid\" aria-busy={list.loading}>\n      {list.loading && !list.items.length ? (\n        <div className={GRID}>\n          {Array.from({ length: 8 }, (_, i) => (\n            <Skeleton key={i} className={p.shape === \"landscape\" ? \"aspect-video w-full\" : \"aspect-[3/4] w-full\"} />\n          ))}\n        </div>\n      ) : list.error && !list.items.length ? (\n        <div role=\"alert\" className=\"grid justify-items-start gap-2\">\n          <p className=\"text-destructive\">{contentError(m, list.error)}</p>\n          <Button size=\"sm\" variant=\"outline\" onClick={list.reload}>\n            {t(\"common.retry\")}\n          </Button>\n        </div>\n      ) : !list.items.length ? (\n        <div className=\"text-muted-foreground\" role=\"status\">\n          {p.empty ?? t(\"contents.empty\")}\n        </div>\n      ) : (\n        <ol className={GRID}>\n          {list.items.map((card, i) => (\n            <li key={card.id} ref={exposure.track(card.id, i + 1)}>\n              {p.renderCard ? (\n                p.renderCard(card, i + 1)\n              ) : (\n                <ContentCard\n                  card={card}\n                  href={p.href}\n                  shape={p.shape}\n                  groupKinds={p.groupKinds}\n                  chips={p.chips}\n                  tiers={tiers}\n                  labels={p.labels}\n                  owner={p.owner}\n                  ownerHref={p.ownerHref}\n                  decorate={p.decorate}\n                  onOpen={() => exposure.click(card.id, i + 1)}\n                />\n              )}\n            </li>\n          ))}\n        </ol>\n      )}\n      {list.hasMore && (\n        <div ref={sentinel} className=\"grid justify-items-center\">\n          <Button variant=\"outline\" size=\"sm\" disabled={list.loadingMore} onClick={() => void list.loadMore()}>\n            {list.loadingMore ? t(\"contents.loading\") : t(\"contents.loadMore\")}\n          </Button>\n        </div>\n      )}\n    </ContentKitUiRoot>\n  );\n}\n\n/**\n * What a list does with cards the reader doesn't open: shows them marked\n * (show), leaves them out (hide), or lists them apart, counted, behind a\n * toggle that loads them when opened (collapse).\n */\nexport type LockedCards = \"show\" | \"hide\" | \"collapse\";\n\nconst LOCKED_LEVELS = [\"tier\", \"group\", \"ppv\", \"group_ppv\"] as const;\n\n/** Contents as cards (GET /v1/contents): any sort and filter, paged. */\nexport function ContentGrid({ query, locked = \"show\", ...p }: CardListProps & { query: ContentQuery; locked?: LockedCards }) {\n  const q = useMemo<ContentQuery>(\n    () => ({ ...query, limit: query.limit ?? p.pageSize, ...(locked === \"show\" ? {} : { mode: \"hide\" }) }),\n    [query, p.pageSize, locked],\n  );\n  const list = useContents(q, { client: p.client });\n  return (\n    <>\n      {locked === \"collapse\" && <LockedSection {...p} query={query} />}\n      <CardGrid {...p} list={list} render={JSON.stringify(q)} />\n    </>\n  );\n}\n\n/** A list's locked cards, counted, loaded and shown on opening. */\nfunction LockedSection({ query, ...p }: CardListProps & { query: ContentQuery }) {\n  const m = useMessages();\n  const [open, setOpen] = useState(false);\n  const { count } = useLockedCount(query, { client: p.client });\n  const q = useMemo<ContentQuery | null>(\n    () => (open ? { ...query, mode: \"lock\", access: query.access ?? LOCKED_LEVELS, limit: query.limit ?? p.pageSize } : null),\n    [open, query, p.pageSize],\n  );\n  const list = useContents(q, { client: p.client });\n  const items = useMemo(() => list.items.filter((c) => !c.access.allowed), [list.items]);\n  if (!count) return null;\n  return (\n    <ContentKitUiRoot appearance={p.appearance} className=\"grid gap-3 text-sm\" data-ckui=\"locked-cards\">\n      <Button variant=\"outline\" size=\"sm\" className=\"justify-self-start\" aria-expanded={open} onClick={() => setOpen(!open)}>\n        {open ? m.t(\"contents.lockedHide\") : m.plural(\"contents.lockedShow\", count)}\n      </Button>\n      {open && <CardGrid {...p} list={{ ...list, items }} render={JSON.stringify(q)} />}\n    </ContentKitUiRoot>\n  );\n}\n\n/** Search results as cards; nothing until the query has text. */\nexport function SearchResults({ query, ...p }: CardListProps & { query: SearchQuery }) {\n  const { t } = useMessages();\n  const q = useMemo(() => ({ ...query, limit: query.limit ?? p.pageSize }), [query, p.pageSize]);\n  const list = useSearch(q, { client: p.client });\n  if (!query.q.trim()) return null;\n  return <CardGrid surface=\"search\" empty={t(\"contents.noResults\", { q: query.q.trim() })} {...p} list={list} render={JSON.stringify(q)} />;\n}\n\n/** The signed-in reader's history as cards, each removable, with a clear-all. */\nexport function ContentHistory({ query = {}, ...p }: CardListProps & { query?: HistoryQuery }) {\n  const { t } = useMessages();\n  const ctx = useContext(ContentKitContext);\n  const q = useMemo(() => ({ ...query, limit: query.limit ?? p.pageSize }), [query, p.pageSize]);\n  const list = useHistory(q, { client: p.client });\n  const forget = useAction(\"history.forget\");\n  if (ctx?.viewer === null) return <p className=\"text-muted-foreground\">{t(\"contents.historySignedOut\")}</p>;\n  return (\n    <div className=\"grid gap-3\" data-ckui=\"content-history\">\n      {list.items.length > 0 && (\n        <Button size=\"sm\" variant=\"outline\" className=\"justify-self-end\" disabled={forget.pending} onClick={() => void forget.run(() => list.forget(query.kind ? { kind: query.kind } : {}))}>\n          {t(\"contents.clearHistory\")}\n        </Button>\n      )}\n      <CardGrid\n        surface=\"history\"\n        empty={t(\"contents.historyEmpty\")}\n        {...p}\n        list={list}\n        render={JSON.stringify(q)}\n        renderCard={\n          p.renderCard ??\n          ((card) => (\n            <ContentCard\n              card={card}\n              href={p.href}\n              shape={p.shape}\n              groupKinds={p.groupKinds}\n              chips={p.chips}\n              tiers={p.tiers}\n              labels={p.labels}\n              owner={p.owner}\n              ownerHref={p.ownerHref}\n              decorate={p.decorate}\n            >\n              <Button size=\"xs\" variant=\"ghost\" className=\"justify-self-start\" disabled={forget.pending} onClick={() => void forget.run(() => list.forget({ content_id: card.id }))}>\n                {t(\"contents.removeFromHistory\")}\n              </Button>\n            </ContentCard>\n          ))\n        }\n      />\n    </div>\n  );\n}\n\nexport interface ContentRailProps extends Omit<CardListProps, \"infinite\" | \"empty\"> {\n  /** The rail's heading. */\n  title: ReactNode;\n  /** Contents like this one. */\n  similar?: string;\n  /** For the signed-in reader. */\n  recommendations?: boolean;\n  /** The reader's history: { status: \"in_progress\" } is a continue-watching rail. */\n  history?: HistoryQuery;\n  /** An ordered group's members in its order: a featured rail (its windows apply). */\n  group?: string;\n  /** Any list: a sort and filters. */\n  list?: ContentQuery;\n  /** Filters and reader options of a similar or recommended rail. */\n  query?: RailQuery;\n  /** A link beside the heading, e.g. to the whole list. */\n  more?: ReactNode;\n}\n\n/**\n * A horizontal row of contents: similar, recommended, the reader's history,\n * an ordered group's members or any list. It hides itself when it has none or\n * the site runs without what it needs.\n */\nexport function ContentRail({ title, similar, recommendations, history, group, list: listQuery, query = {}, more, ...p }: ContentRailProps) {\n  const limit = query.limit ?? p.pageSize ?? 12;\n  const q = useMemo(() => ({ ...query, limit }), [query, limit]);\n  const listing = useMemo(\n    () => (listQuery ? { ...listQuery, limit: listQuery.limit ?? limit } : group ? { groups: [group], sort: \"position\" as const, limit } : null),\n    [listQuery, group, limit],\n  );\n  const like = useSimilar(recommendations || history || listing ? null : similar, q, { client: p.client });\n  const mine = useRecommendations(recommendations ? q : null, { client: p.client });\n  const seen = useHistory(history ? { ...history, limit: history.limit ?? limit } : null, { client: p.client });\n  const listed = useContents(listing, { client: p.client });\n  const rail: UseRail = recommendations\n    ? mine\n    : history || listing\n      ? (() => {\n          const l = history ? seen : listed;\n          return { items: l.items, loading: l.loading, error: l.error, unavailable: l.error?.code === \"not_configured\", reload: l.reload };\n        })()\n      : like;\n  const { kinds } = useKinds({ client: p.client });\n  const surface = p.surface ?? (recommendations ? \"recommendations\" : history ? \"history\" : group ? \"featured\" : listing ? \"list\" : \"similar\");\n  const exposure = useExposure(rail.items, { surface, render: JSON.stringify([similar, recommendations, history, group, listing, q]), client: p.client });\n  const source = similar || recommendations || history || group || listing;\n  if (!source || rail.unavailable || (!rail.loading && !rail.items.length)) return null;\n  return (\n    <ContentKitUiRoot appearance={p.appearance} className={cn(\"grid gap-3 text-sm\", p.className)} data-ckui=\"content-rail\" data-surface={surface}>\n      <div className=\"flex items-baseline justify-between gap-2\">\n        <h2 className=\"text-base font-semibold\">{title}</h2>\n        {more}\n      </div>\n      <ol className=\"flex snap-x gap-4 overflow-x-auto pb-2\">\n        {(rail.loading && !rail.items.length ? Array.from({ length: 6 }, () => null) : rail.items).map((card, i) => (\n          <li key={card?.id ?? i} className=\"w-36 shrink-0 snap-start sm:w-44\" ref={card ? exposure.track(card.id, i + 1) : undefined}>\n            {!card ? (\n              <Skeleton className={p.shape === \"landscape\" ? \"aspect-video w-full\" : \"aspect-[3/4] w-full\"} />\n            ) : p.renderCard ? (\n              p.renderCard(card, i + 1)\n            ) : (\n              <ContentCard\n                card={card}\n                href={p.href}\n                shape={p.shape}\n                groupKinds={p.groupKinds}\n                chips={p.chips}\n                tiers={p.tiers ?? kinds?.tiers}\n                labels={p.labels}\n                owner={p.owner}\n                ownerHref={p.ownerHref}\n                decorate={p.decorate}\n                onOpen={() => exposure.click(card.id, i + 1)}\n              />\n            )}\n          </li>\n        ))}\n      </ol>\n    </ContentKitUiRoot>\n  );\n}\n"],"mappings":"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"}

package/dist/components/content/index.d.ts

@@ -1,8 +1,10 @@
 export { ContentCard, OwnerChip, PostCard, lockLabel, type ContentCardProps, type PostCardProps } from './card.js';
-export { CardGrid, ContentGrid, ContentHistory, ContentRail, SearchResults, type CardListProps, type ContentRailProps } from './grid.js';
+export { CardGrid, ContentGrid, ContentHistory, ContentRail, SearchResults, type CardListProps, type ContentRailProps, type LockedCards } from './grid.js';
 export { SearchBox, type SearchBoxProps } from './search.js';
 export { ContentFilterSettings, ReleaseDateIndex, type ContentFilterSettingsProps, type ReleaseDateIndexProps } from './filters.js';
 export { ContentListing, sortLabel, type ContentListingProps } from './listing.js';
-export { Paywall, VersionPicker, priceLabel, useVersionMenuItems, type PaywallProps, type VersionPickerProps } from './paywall.js';
+export { Paywall, VersionPicker, priceLabel, useVersionMenuItems, type PaywallProps, type VersionMenuOptions, type VersionPickerProps } from './paywall.js';
 export { AccessEditor, ContentDetailsEditor, ContentSections, SegmentsEditor, VersionsEditor, versionLabel } from './editors.js';
 export { OfferFields } from './offer-fields.js';
+export { ReaderStats, type ReaderStatsProps } from './reader-stats.js';
+export { VersionDownloadButton, type VersionDownloadButtonProps } from './download-button.js';

package/dist/components/content/listing.d.ts

@@ -1,6 +1,6 @@
 import { ContentQuery, ListSort } from '../../client/discovery.js';
 import { Translator } from '../../i18n/messages.js';
-import { CardListProps } from './grid.js';
+import { CardListProps, LockedCards } from './grid.js';
 /** A sort's name: "Newest", "Popular, this week". */
 export declare function sortLabel(m: Translator, sort: ListSort): string;
 export interface ContentListingProps extends CardListProps {
@@ -11,6 +11,8 @@ export interface ContentListingProps extends CardListProps {
     onQueryChange?: (query: ContentQuery) => void;
     /** The sorts offered; default newest, popular (week, month, all time), top rated, most favorited, title, oldest. */
     sorts?: readonly ListSort[];
+    /** Cards the reader doesn't open: show (default), hide or collapse. */
+    locked?: LockedCards;
     /** Offer a language filter; default when the site has several languages. */
     languages?: boolean;
     /** The traits and attributes offered; default every trait and filterable attribute of the kind. */