@openrails/contentkit-ui 0.0.0-placeholder → 0.68.0

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","names":[],"sources":["../src/provider.tsx"],"sourcesContent":["import { useEffect, useMemo, useState, type ReactNode } from \"react\";\nimport type { ContentKitUiAppearance } from \"./appearance.js\";\nimport { DEFAULT_DENSITY, type DensityRange } from \"./client/rendition.js\";\nimport { DensityContext } from \"./components/rendition-img.js\";\nimport { MessagesContext } from \"./i18n/context.js\";\nimport { createTranslator, resolveMessages, type ContentKitUiMessageBundle, type ContentKitUiTranslate } from \"./i18n/messages.js\";\nimport { InlinePreviewContext } from \"./react/inline-preview.js\";\nimport { AppearanceContext } from \"./scope.js\";\n\n/** Built-in bundles besides English, loaded on demand. */\nconst BUNDLES: Record<string, () => Promise<ContentKitUiMessageBundle>> = {\n  de: () => import(\"./locales/de.js\").then((m) => m.de),\n  es: () => import(\"./locales/es.js\").then((m) => m.es),\n  ja: () => import(\"./locales/ja.js\").then((m) => m.ja),\n  ko: () => import(\"./locales/ko.js\").then((m) => m.ko),\n  zh: () => import(\"./locales/zh.js\").then((m) => m.zh),\n};\n\n/** The built-in bundle's language for a BCP 47 tag (\"ja-JP\" → \"ja\"); undefined for English or one we lack. */\nexport function bundleLanguage(language: string | null | undefined): string | undefined {\n  const primary = language?.toLowerCase().split(/[-_]/)[0];\n  return primary && primary in BUNDLES ? primary : undefined;\n}\n\nexport interface ContentKitUiProviderProps {\n  appearance?: ContentKitUiAppearance;\n  /** BCP 47 tag; its built-in bundle loads under `messages`. English until it arrives. */\n  language?: string;\n  /** Bundle(s) layered over English and the language's bundle; later entries win. */\n  messages?: ContentKitUiMessageBundle | readonly ContentKitUiMessageBundle[];\n  /** Host translation hook, consulted before the bundles. */\n  t?: ContentKitUiTranslate;\n  /** Device-pixel density range images and covers are picked for. Default [2, 3]. */\n  density?: DensityRange;\n  /** Playable videos preview muted inline (hover, or in view on touch). Default true. */\n  inlinePreview?: boolean;\n  children?: ReactNode;\n}\n\n/** Look and language for every component below. Renders no DOM; components create their own `.ckui` roots. */\nexport function ContentKitUiProvider({ appearance, language, messages, t, density = DEFAULT_DENSITY, inlinePreview = true, children }: ContentKitUiProviderProps) {\n  const lang = bundleLanguage(language);\n  const [loaded, setLoaded] = useState<{ lang: string; bundle: ContentKitUiMessageBundle } | null>(null);\n  useEffect(() => {\n    if (!lang) return;\n    let live = true;\n    BUNDLES[lang]!().then(\n      (bundle) => live && setLoaded({ lang, bundle }),\n      () => {},\n    );\n    return () => {\n      live = false;\n    };\n  }, [lang]);\n  const bundle = lang && loaded?.lang === lang ? loaded.bundle : undefined;\n  const translator = useMemo(() => {\n    const own = messages ? (Array.isArray(messages) ? messages : [messages]) : [];\n    return createTranslator(resolveMessages(bundle ? [bundle, ...own] : own), t, language);\n  }, [bundle, messages, t, language]);\n  return (\n    <AppearanceContext.Provider value={appearance}>\n      <MessagesContext.Provider value={translator}>\n        <DensityContext.Provider value={density}>\n          <InlinePreviewContext.Provider value={inlinePreview}>{children}</InlinePreviewContext.Provider>\n        </DensityContext.Provider>\n      </MessagesContext.Provider>\n    </AppearanceContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;AAUA,IAAM,IAAoE;CACxE,UAAU,OAAO,kBAAkB,CAAC,MAAM,MAAM,EAAE,EAAE;CACpD,UAAU,OAAO,kBAAkB,CAAC,MAAM,MAAM,EAAE,EAAE;CACpD,UAAU,OAAO,kBAAkB,CAAC,MAAM,MAAM,EAAE,EAAE;CACpD,UAAU,OAAO,kBAAkB,CAAC,MAAM,MAAM,EAAE,EAAE;CACpD,UAAU,OAAO,kBAAkB,CAAC,MAAM,MAAM,EAAE,EAAE;AACtD;AAGA,SAAgB,EAAe,GAAyD;CACtF,IAAM,IAAU,GAAU,YAAY,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC;CACtD,OAAO,KAAW,KAAW,IAAU,IAAU,KAAA;AACnD;AAkBA,SAAgB,EAAqB,EAAE,eAAY,aAAU,aAAU,MAAG,aAAU,GAAiB,mBAAgB,IAAM,eAAuC;CAChK,IAAM,IAAO,EAAe,CAAQ,GAC9B,CAAC,GAAQ,KAAa,EAAqE,IAAI;CACrG,QAAgB;EACd,IAAI,CAAC,GAAM;EACX,IAAI,IAAO;EAKX,OAJA,EAAQ,EAAK,CAAE,CAAC,CAAC,MACd,MAAW,KAAQ,EAAU;GAAE;GAAM;EAAO,CAAC,SACxC,CAAC,CACT,SACa;GACX,IAAO;EACT;CACF,GAAG,CAAC,CAAI,CAAC;CACT,IAAM,IAAS,KAAQ,GAAQ,SAAS,IAAO,EAAO,SAAS,KAAA,GACzD,IAAa,QAAc;EAC/B,IAAM,IAAM,IAAY,MAAM,QAAQ,CAAQ,IAAI,IAAW,CAAC,CAAQ,IAAK,CAAC;EAC5E,OAAO,EAAiB,EAAgB,IAAS,CAAC,GAAQ,GAAG,CAAG,IAAI,CAAG,GAAG,GAAG,CAAQ;CACvF,GAAG;EAAC;EAAQ;EAAU;EAAG;CAAQ,CAAC;CAClC,OACE,kBAAC,EAAkB,UAAnB;EAA4B,OAAO;EACjC,UAAA,kBAAC,EAAgB,UAAjB;GAA0B,OAAO;GAC/B,UAAA,kBAAC,EAAe,UAAhB;IAAyB,OAAO;IAC9B,UAAA,kBAAC,EAAqB,UAAtB;KAA+B,OAAO;KAAgB;IAAwC,CAAA;GACvE,CAAA;EACD,CAAA;CACA,CAAA;AAEhC"}

package/dist/react/canonical.d.ts

@@ -0,0 +1,33 @@
+import { ContentLink } from '../urls/index.js';
+export interface CanonicalContentOptions {
+    /** og:title. */
+    title?: string;
+    /** og:image, an absolute URL. */
+    image?: string;
+    /**
+     * The current location (pathname, search, hash). Default
+     * window.location; pass the router's so a navigation checks again.
+     */
+    location?: string;
+    /** Languages the content exists in, for hreflang; default every configured language. */
+    languages?: readonly string[];
+    /** The language hreflang x-default points at. */
+    defaultLanguage?: string;
+}
+export interface CanonicalContent {
+    /** The canonical path in the page's language; undefined until link arrives. */
+    path?: string;
+    /** Its absolute URL. */
+    url?: string;
+    /** hreflang alternates by language (and x-default). */
+    alternates: Record<string, string>;
+}
+/**
+ * A content page's canonical URL once its data (link) arrives: replaces the
+ * address with the canonical path (code spelling, merged code, current slug)
+ * through the provider's navigate (else history.replaceState), and keeps
+ * `<link rel=canonical>`, og:url, og:title, og:image and hreflang alternates
+ * (each language's own slug) in the head while mounted. Needs the
+ * provider's `urls`.
+ */
+export declare function useCanonicalContent(content: ContentLink | null | undefined, o?: CanonicalContentOptions): CanonicalContent;

package/dist/react/canonical.js

@@ -0,0 +1,88 @@
+import { ContentKitContext as e, useContentURLs as t } from "./context.js";
+import { useContext as n, useEffect as r, useMemo as i } from "react";
+//#region src/react/canonical.ts
+var a = (e, t) => ({
+	selector: `meta[property="${e}"]`,
+	create: () => o(document.createElement("meta"), "property", e),
+	attr: "content",
+	value: t
+});
+function o(e, t, n) {
+	return e.setAttribute(t, n), e;
+}
+var s = (e, t, n) => ({
+	selector: n ? `link[rel="${e}"][hreflang="${n}"]` : `link[rel="${e}"]:not([hreflang])`,
+	create: () => {
+		let t = o(document.createElement("link"), "rel", e);
+		return n && t.setAttribute("hreflang", n), t;
+	},
+	attr: "href",
+	value: t
+});
+function c(c, l = {}) {
+	let u = t(), d = n(e)?.navigate, f = l.location ?? (typeof location > "u" ? "" : location.pathname + location.search + location.hash), p = c?.content_kind, m = c?.code, h = c?.slug, g = JSON.stringify(c?.slugs ?? {}), _ = l.languages?.join(","), v = i(() => p && m ? {
+		content_kind: p,
+		code: m,
+		slug: h ?? "",
+		slugs: JSON.parse(g)
+	} : null, [
+		p,
+		m,
+		h,
+		g
+	]), y = i(() => {
+		if (!v) return { alternates: {} };
+		let e = u.origin ?? (typeof location > "u" ? void 0 : location.origin), t = f.includes("#") ? f.slice(f.indexOf("#")) : "", n = u.canonical(f, v), r = n?.path ?? u.path(v), i = e ? u.hreflang(v, {
+			origin: e,
+			languages: _?.split(","),
+			defaultLanguage: l.defaultLanguage
+		}) : {};
+		return {
+			path: r,
+			url: e ? e + r : void 0,
+			alternates: i,
+			redirect: n?.redirect ? n.location + t : void 0
+		};
+	}, [
+		v,
+		f,
+		u,
+		_,
+		l.defaultLanguage
+	]), { redirect: b } = y;
+	r(() => {
+		b && (d ? d(b, { replace: !0 }) : history.replaceState(history.state, "", b));
+	}, [b, d]);
+	let { url: x, alternates: S } = y, { title: C, image: w } = l, T = JSON.stringify(S);
+	return r(() => {
+		if (!x || typeof document > "u") return;
+		let e = [s("canonical", x), a("og:url", x)];
+		C && e.push(a("og:title", C)), w && e.push(a("og:image", w));
+		for (let [t, n] of Object.entries(JSON.parse(T))) e.push(s("alternate", n, t));
+		let t = [];
+		for (let n of e) {
+			let e = document.head.querySelector(n.selector);
+			if (e) {
+				let r = e.getAttribute(n.attr);
+				e.setAttribute(n.attr, n.value), t.push(() => r === null ? e.removeAttribute(n.attr) : e.setAttribute(n.attr, r));
+			} else {
+				let e = o(n.create(), n.attr, n.value);
+				document.head.appendChild(e), t.push(() => e.remove());
+			}
+		}
+		return () => t.forEach((e) => e());
+	}, [
+		x,
+		C,
+		w,
+		T
+	]), {
+		path: y.path,
+		url: y.url,
+		alternates: y.alternates
+	};
+}
+//#endregion
+export { c as useCanonicalContent };
+
+//# sourceMappingURL=canonical.js.map

package/dist/react/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","names":[],"sources":["../../src/react/canonical.ts"],"sourcesContent":["import { useContext, useEffect, useMemo } from \"react\";\nimport type { ContentLink } from \"../urls/index.js\";\nimport { ContentKitContext, useContentURLs } from \"./context.js\";\n\nexport interface CanonicalContentOptions {\n  /** og:title. */\n  title?: string;\n  /** og:image, an absolute URL. */\n  image?: string;\n  /**\n   * The current location (pathname, search, hash). Default\n   * window.location; pass the router's so a navigation checks again.\n   */\n  location?: string;\n  /** Languages the content exists in, for hreflang; default every configured language. */\n  languages?: readonly string[];\n  /** The language hreflang x-default points at. */\n  defaultLanguage?: string;\n}\n\nexport interface CanonicalContent {\n  /** The canonical path in the page's language; undefined until link arrives. */\n  path?: string;\n  /** Its absolute URL. */\n  url?: string;\n  /** hreflang alternates by language (and x-default). */\n  alternates: Record<string, string>;\n}\n\ntype Tag = { selector: string; create: () => HTMLElement; attr: string; value: string };\n\nconst meta = (property: string, value: string): Tag => ({\n  selector: `meta[property=\"${property}\"]`,\n  create: () => withAttr(document.createElement(\"meta\"), \"property\", property),\n  attr: \"content\",\n  value,\n});\n\nfunction withAttr<E extends HTMLElement>(el: E, name: string, value: string): E {\n  el.setAttribute(name, value);\n  return el;\n}\n\nconst link = (rel: string, value: string, hreflang?: string): Tag => ({\n  selector: hreflang ? `link[rel=\"${rel}\"][hreflang=\"${hreflang}\"]` : `link[rel=\"${rel}\"]:not([hreflang])`,\n  create: () => {\n    const el = withAttr(document.createElement(\"link\"), \"rel\", rel);\n    if (hreflang) el.setAttribute(\"hreflang\", hreflang);\n    return el;\n  },\n  attr: \"href\",\n  value,\n});\n\n/**\n * A content page's canonical URL once its data (link) arrives: replaces the\n * address with the canonical path (code spelling, merged code, current slug)\n * through the provider's navigate (else history.replaceState), and keeps\n * `<link rel=canonical>`, og:url, og:title, og:image and hreflang alternates\n * (each language's own slug) in the head while mounted. Needs the\n * provider's `urls`.\n */\nexport function useCanonicalContent(content: ContentLink | null | undefined, o: CanonicalContentOptions = {}): CanonicalContent {\n  const urls = useContentURLs();\n  const navigate = useContext(ContentKitContext)?.navigate;\n  const at = o.location ?? (typeof location === \"undefined\" ? \"\" : location.pathname + location.search + location.hash);\n  const kind = content?.content_kind;\n  const code = content?.code;\n  const slug = content?.slug;\n  const slugs = JSON.stringify(content?.slugs ?? {});\n  const languages = o.languages?.join(\",\");\n  const lnk = useMemo(\n    () => (kind && code ? ({ content_kind: kind, code, slug: slug ?? \"\", slugs: JSON.parse(slugs) as Record<string, string> } satisfies ContentLink) : null),\n    [kind, code, slug, slugs],\n  );\n\n  const result = useMemo((): CanonicalContent & { redirect?: string } => {\n    if (!lnk) return { alternates: {} };\n    const origin = urls.origin ?? (typeof location === \"undefined\" ? undefined : location.origin);\n    const hash = at.includes(\"#\") ? at.slice(at.indexOf(\"#\")) : \"\";\n    const c = urls.canonical(at, lnk);\n    const path = c?.path ?? urls.path(lnk);\n    const alternates = origin ? urls.hreflang(lnk, { origin, languages: languages?.split(\",\"), defaultLanguage: o.defaultLanguage }) : {};\n    return { path, url: origin ? origin + path : undefined, alternates, redirect: c?.redirect ? c.location + hash : undefined };\n  }, [lnk, at, urls, languages, o.defaultLanguage]);\n\n  const { redirect } = result;\n  useEffect(() => {\n    if (!redirect) return;\n    if (navigate) navigate(redirect, { replace: true });\n    else history.replaceState(history.state, \"\", redirect);\n  }, [redirect, navigate]);\n\n  const { url, alternates } = result;\n  const { title, image } = o;\n  const alternatesKey = JSON.stringify(alternates);\n  useEffect(() => {\n    if (!url || typeof document === \"undefined\") return;\n    const tags: Tag[] = [link(\"canonical\", url), meta(\"og:url\", url)];\n    if (title) tags.push(meta(\"og:title\", title));\n    if (image) tags.push(meta(\"og:image\", image));\n    for (const [lang, href] of Object.entries(JSON.parse(alternatesKey) as Record<string, string>)) tags.push(link(\"alternate\", href, lang));\n    const undo: (() => void)[] = [];\n    for (const t of tags) {\n      const found = document.head.querySelector<HTMLElement>(t.selector);\n      if (found) {\n        const before = found.getAttribute(t.attr);\n        found.setAttribute(t.attr, t.value);\n        undo.push(() => (before === null ? found.removeAttribute(t.attr) : found.setAttribute(t.attr, before)));\n      } else {\n        const el = withAttr(t.create(), t.attr, t.value);\n        document.head.appendChild(el);\n        undo.push(() => el.remove());\n      }\n    }\n    return () => undo.forEach((u) => u());\n  }, [url, title, image, alternatesKey]);\n\n  return { path: result.path, url: result.url, alternates: result.alternates };\n}\n"],"mappings":"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"}

package/dist/react/comments.d.ts

@@ -0,0 +1,82 @@
+import { ContentKitClient } from '../client/client.js';
+import { BanScope, Decision, HeldKind, Reaction, Sort } from '../client/content/types.js';
+import { AdminComment, BanInput, Comment, CommentBan, CommentStanding, FeedItem, HeldItem, ReactionCounts, RefBody } from '../client/generated/wire.js';
+import { UseList } from './use-resource.js';
+/** Counts after the caller's reaction changes from counts.mine to value. */
+export declare function withReaction(counts: ReactionCounts, value: Reaction): ReactionCounts;
+export interface UseCommentsOptions {
+    sort?: Sort;
+    /** Top-level comments per page. Default 20. */
+    pageSize?: number;
+    client?: ContentKitClient;
+}
+export interface UseComments extends UseList<Comment> {
+    /** Comments on the item, or replies to a top-level comment (replyTo); anonymous callers give anonName. */
+    post: (body: string, o?: {
+        replyTo?: string;
+        anonName?: string;
+    }) => Promise<Comment>;
+    edit: (id: string, body: string) => Promise<Comment>;
+    /** Leaves a tombstone. */
+    remove: (id: string) => Promise<void>;
+    /** Sets the caller's reaction at once, rolled back if the server refuses it. */
+    react: (comment: Comment, value: Reaction) => Promise<void>;
+    /** Restores a deleted comment (moderators). */
+    restore: (id: string) => Promise<void>;
+}
+/** An item's top-level comments, a page at a time, with every write; new comments and replies land in place. */
+export declare function useComments(ref: RefBody, o?: UseCommentsOptions): UseComments;
+/** A top-level comment's replies, oldest first, a page at a time; enabled false defers the first read. */
+export declare function useCommentReplies(id: string, o?: {
+    pageSize?: number;
+    enabled?: boolean;
+    client?: ContentKitClient;
+}): UseList<Comment>;
+/** Whether the caller may comment on the item, the ban that stops it, and what it may do to others' comments. */
+export declare function useCanComment(ref: RefBody, o?: {
+    client?: ContentKitClient;
+}): {
+    standing: CommentStanding | null;
+    loading: boolean;
+    error: import('../client/errors.js').ContentKitError | undefined;
+    reload: () => void;
+};
+/** The newest published comments across the site, with their items (the host shows titles). */
+export declare function useLatestComments(o?: {
+    pageSize?: number;
+    client?: ContentKitClient;
+}): UseList<FeedItem>;
+export interface UseAdminComments extends UseList<AdminComment> {
+    remove: (id: string) => Promise<void>;
+    restore: (id: string) => Promise<void>;
+    react: (comment: Comment, value: Reaction) => Promise<void>;
+}
+/** Staff: every comment, newest first, deleted, held and rejected ones with their bodies (CommentModerate). */
+export declare function useAdminComments(o?: {
+    contentKind?: string;
+    pageSize?: number;
+    client?: ContentKitClient;
+}): UseAdminComments;
+export interface UseModerationQueue extends UseList<HeldItem> {
+    /** Approves (publishes) or rejects at the revision the queue listed; the item leaves the queue. */
+    resolve: (item: HeldItem, decision: Decision, reason?: string) => Promise<void>;
+}
+/** Staff: held comments or posts awaiting review, oldest first (ModerationReview). */
+export declare function useModerationQueue(o?: {
+    kind?: HeldKind;
+    pageSize?: number;
+    client?: ContentKitClient;
+}): UseModerationQueue;
+export interface UseCommentBans extends UseList<CommentBan & {
+    id: string;
+}> {
+    ban: (user: string, input?: BanInput) => Promise<CommentBan>;
+    lift: (user: string) => Promise<void>;
+}
+/** The bans of one scope: the caller's own ("owner") or the site's ("global", CommentBan), newest first. */
+export declare function useCommentBans(o?: {
+    scope?: BanScope;
+    pageSize?: number;
+    enabled?: boolean;
+    client?: ContentKitClient;
+}): UseCommentBans;

package/dist/react/comments.js

@@ -0,0 +1,147 @@
+import { keyOf as e, offsetPages as t, useContentScope as n, useList as r, useResource as i } from "./use-resource.js";
+import { useCallback as a } from "react";
+//#region src/react/comments.ts
+function o(e, t) {
+	return {
+		likes: e.likes - +(e.mine === 1) + +(t === 1),
+		dislikes: e.dislikes - +(e.mine === -1) + +(t === -1),
+		mine: t
+	};
+}
+var s = [
+	"comments",
+	"replies",
+	"latest",
+	"admin-comments"
+], c = /* @__PURE__ */ new WeakMap();
+async function l(e, t, n, r) {
+	let i = c.get(t);
+	i || c.set(t, i = /* @__PURE__ */ new Map());
+	let a = (i.get(n.id) ?? 0) + 1;
+	i.set(n.id, a);
+	let l = (e) => t.patch((e) => s.includes(e.type), (t) => ({
+		...t,
+		items: t.items.map((t) => t.id === n.id ? {
+			...t,
+			...e
+		} : t)
+	}));
+	l(o({
+		likes: n.likes,
+		dislikes: n.dislikes,
+		mine: n.mine
+	}, r));
+	try {
+		await e.comments.react(n.id, r);
+	} catch (e) {
+		throw i.get(n.id) === a && l({
+			likes: n.likes,
+			dislikes: n.dislikes,
+			mine: n.mine
+		}), e;
+	}
+}
+function u(i, o = {}) {
+	let { client: s, store: c, viewer: u } = n(o.client), d = o.pageSize ?? 20, f = o.sort ?? "newest", p = e("comments", u, i.kind, i.id, f, d), m = r(c, p, {
+		type: "comments",
+		ref: {
+			kind: i.kind,
+			id: i.id
+		}
+	}, t(d, (e, t) => s.comments.list(i, {
+		...e,
+		sort: f
+	}, t))), { kind: h, id: g } = i, _ = a((e, t = {}) => s.comments.create({
+		kind: h,
+		id: g
+	}, {
+		body: e,
+		reply_to_id: t.replyTo,
+		anon_name: t.anonName
+	}), [
+		s,
+		h,
+		g
+	]), v = a((e, t) => s.comments.edit(e, t), [s]), y = a((e) => s.comments.delete(e), [s]), b = a((e) => s.comments.restore(e), [s]), x = a((e, t) => l(s, c, e, t), [s, c]);
+	return {
+		...m,
+		post: _,
+		edit: v,
+		remove: y,
+		react: x,
+		restore: b
+	};
+}
+function d(i, a = {}) {
+	let { client: o, store: s, viewer: c } = n(a.client), l = a.pageSize ?? 10, u = a.enabled === !1 ? null : e("replies", c, i, l);
+	return r(s, u, {
+		type: "replies",
+		id: i
+	}, t(l, (e, t) => o.comments.replies(i, e, t)));
+}
+function f(t, r = {}) {
+	let { client: a, store: o, viewer: s } = n(r.client), c = i(o, e("standing", s, t.kind, t.id), {
+		type: "standing",
+		ref: {
+			kind: t.kind,
+			id: t.id
+		}
+	}, (e) => a.comments.standing(t, e));
+	return {
+		standing: c.data ?? null,
+		loading: c.loading || !c.loaded,
+		error: c.error,
+		reload: c.reload
+	};
+}
+function p(i = {}) {
+	let { client: a, store: o, viewer: s } = n(i.client), c = i.pageSize ?? 20;
+	return r(o, e("latest", s, c), { type: "latest" }, t(c, (e, t) => a.comments.latest(e, t), !0));
+}
+function m(i = {}) {
+	let { client: o, store: s, viewer: c } = n(i.client), u = i.pageSize ?? 25, d = i.contentKind || void 0, f = r(s, e("admin-comments", c, d, u), { type: "admin-comments" }, t(u, (e, t) => o.comments.adminList({
+		...e,
+		contentKind: d
+	}, t))), p = a((e) => o.comments.delete(e), [o]), m = a((e) => o.comments.restore(e), [o]), h = a((e, t) => l(o, s, e, t), [o, s]);
+	return {
+		...f,
+		remove: p,
+		restore: m,
+		react: h
+	};
+}
+function h(t = {}) {
+	let { client: i, store: o, viewer: s } = n(t.client), c = t.kind ?? "comment", l = t.pageSize ?? 20, u = r(o, e("held", s, c, l), { type: "held" }, async (e, t) => {
+		let n = await i.moderation.held({
+			kind: c,
+			cursor: typeof e == "string" ? e : void 0,
+			limit: l
+		}, t);
+		return {
+			items: n.items,
+			next: n.next ?? null
+		};
+	}), d = a(async (e, t, n) => void await i.moderation.resolve(e, t, n), [i]);
+	return {
+		...u,
+		resolve: d
+	};
+}
+function g(i = {}) {
+	let { client: o, store: s, viewer: c } = n(i.client), l = i.scope ?? "global", u = i.pageSize ?? 25, d = r(s, i.enabled === !1 ? null : e("bans", c, l, u), {
+		type: "bans",
+		scope: l
+	}, t(u, async (e, t) => (await o.bans.list(l, e, t)).map((e) => ({
+		...e,
+		id: e.user_id
+	})))), f = a((e, t) => o.bans.ban(l, e, t), [o, l]), p = a((e) => o.bans.lift(l, e), [o, l]);
+	return {
+		...d,
+		ban: f,
+		lift: p
+	};
+}
+//#endregion
+export { m as useAdminComments, f as useCanComment, g as useCommentBans, d as useCommentReplies, u as useComments, p as useLatestComments, h as useModerationQueue, o as withReaction };
+
+//# sourceMappingURL=comments.js.map

package/dist/react/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","names":[],"sources":["../../src/react/comments.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { BanScope, Decision, HeldKind, Reaction, Sort } from \"../client/content/types.js\";\nimport type { AdminComment, BanInput, Comment, CommentBan, CommentStanding, FeedItem, HeldItem, ReactionCounts, RefBody } from \"../client/generated/wire.js\";\nimport type { ResourceStore } from \"./resources.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\n/** Counts after the caller's reaction changes from counts.mine to value. */\nexport function withReaction(counts: ReactionCounts, value: Reaction): ReactionCounts {\n  const likes = counts.likes - (counts.mine === 1 ? 1 : 0) + (value === 1 ? 1 : 0);\n  const dislikes = counts.dislikes - (counts.mine === -1 ? 1 : 0) + (value === -1 ? 1 : 0);\n  return { likes, dislikes, mine: value };\n}\n\nconst commentLists = [\"comments\", \"replies\", \"latest\", \"admin-comments\"];\nconst tokens = new WeakMap<ResourceStore, Map<string, number>>();\n\n/** Sets the caller's reaction to a comment in every list showing it at once; rolls back on failure unless a newer one started. */\nasync function reactToComment(client: ContentKitClient, store: ResourceStore, c: Pick<Comment, \"id\" | \"likes\" | \"dislikes\" | \"mine\">, value: Reaction) {\n  let t = tokens.get(store);\n  if (!t) tokens.set(store, (t = new Map()));\n  const token = (t.get(c.id) ?? 0) + 1;\n  t.set(c.id, token);\n  const put = (counts: ReactionCounts) =>\n    store.patch<{ items: Comment[]; next: unknown }>(\n      (tag) => commentLists.includes(tag.type),\n      (page) => ({ ...page, items: page.items.map((x) => (x.id === c.id ? { ...x, ...counts } : x)) }),\n    );\n  put(withReaction({ likes: c.likes, dislikes: c.dislikes, mine: c.mine }, value));\n  try {\n    await client.comments.react(c.id, value);\n  } catch (e) {\n    if (t.get(c.id) === token) put({ likes: c.likes, dislikes: c.dislikes, mine: c.mine });\n    throw e;\n  }\n}\n\nexport interface UseCommentsOptions {\n  sort?: Sort;\n  /** Top-level comments per page. Default 20. */\n  pageSize?: number;\n  client?: ContentKitClient;\n}\n\nexport interface UseComments extends UseList<Comment> {\n  /** Comments on the item, or replies to a top-level comment (replyTo); anonymous callers give anonName. */\n  post: (body: string, o?: { replyTo?: string; anonName?: string }) => Promise<Comment>;\n  edit: (id: string, body: string) => Promise<Comment>;\n  /** Leaves a tombstone. */\n  remove: (id: string) => Promise<void>;\n  /** Sets the caller's reaction at once, rolled back if the server refuses it. */\n  react: (comment: Comment, value: Reaction) => Promise<void>;\n  /** Restores a deleted comment (moderators). */\n  restore: (id: string) => Promise<void>;\n}\n\n/** An item's top-level comments, a page at a time, with every write; new comments and replies land in place. */\nexport function useComments(ref: RefBody, o: UseCommentsOptions = {}): UseComments {\n  const { client, store, viewer } = useContentScope(o.client);\n  const size = o.pageSize ?? 20;\n  const sort = o.sort ?? \"newest\";\n  const key = keyOf(\"comments\", viewer, ref.kind, ref.id, sort, size);\n  const list = useList(store, key, { type: \"comments\", ref: { kind: ref.kind, id: ref.id } }, offsetPages(size, (q, signal) => client.comments.list(ref, { ...q, sort }, signal)));\n  const { kind, id } = ref;\n  const post = useCallback<UseComments[\"post\"]>(\n    (body, p = {}) => client.comments.create({ kind, id }, { body, reply_to_id: p.replyTo, anon_name: p.anonName }),\n    [client, kind, id],\n  );\n  const edit = useCallback((cid: string, body: string) => client.comments.edit(cid, body), [client]);\n  const remove = useCallback((cid: string) => client.comments.delete(cid), [client]);\n  const restore = useCallback((cid: string) => client.comments.restore(cid), [client]);\n  const react = useCallback((c: Comment, v: Reaction) => reactToComment(client, store, c, v), [client, store]);\n  return { ...list, post, edit, remove, react, restore };\n}\n\n/** A top-level comment's replies, oldest first, a page at a time; enabled false defers the first read. */\nexport function useCommentReplies(id: string, o: { pageSize?: number; enabled?: boolean; client?: ContentKitClient } = {}): UseList<Comment> {\n  const { client, store, viewer } = useContentScope(o.client);\n  const size = o.pageSize ?? 10;\n  const key = o.enabled === false ? null : keyOf(\"replies\", viewer, id, size);\n  return useList(store, key, { type: \"replies\", id }, offsetPages(size, (q, signal) => client.comments.replies(id, q, signal)));\n}\n\n/** Whether the caller may comment on the item, the ban that stops it, and what it may do to others' comments. */\nexport function useCanComment(ref: RefBody, o: { client?: ContentKitClient } = {}) {\n  const { client, store, viewer } = useContentScope(o.client);\n  const r = useResource<CommentStanding>(store, keyOf(\"standing\", viewer, ref.kind, ref.id), { type: \"standing\", ref: { kind: ref.kind, id: ref.id } }, (s) =>\n    client.comments.standing(ref, s),\n  );\n  return { standing: r.data ?? null, loading: r.loading || !r.loaded, error: r.error, reload: r.reload };\n}\n\n/** The newest published comments across the site, with their items (the host shows titles). */\nexport function useLatestComments(o: { pageSize?: number; client?: ContentKitClient } = {}): UseList<FeedItem> {\n  const { client, store, viewer } = useContentScope(o.client);\n  const size = o.pageSize ?? 20;\n  return useList(store, keyOf(\"latest\", viewer, size), { type: \"latest\" }, offsetPages(size, (q, signal) => client.comments.latest(q, signal), true));\n}\n\nexport interface UseAdminComments extends UseList<AdminComment> {\n  remove: (id: string) => Promise<void>;\n  restore: (id: string) => Promise<void>;\n  react: (comment: Comment, value: Reaction) => Promise<void>;\n}\n\n/** Staff: every comment, newest first, deleted, held and rejected ones with their bodies (CommentModerate). */\nexport function useAdminComments(o: { contentKind?: string; pageSize?: number; client?: ContentKitClient } = {}): UseAdminComments {\n  const { client, store, viewer } = useContentScope(o.client);\n  const size = o.pageSize ?? 25;\n  const kind = o.contentKind || undefined;\n  const list = useList(\n    store,\n    keyOf(\"admin-comments\", viewer, kind, size),\n    { type: \"admin-comments\" },\n    offsetPages(size, (q, signal) => client.comments.adminList({ ...q, contentKind: kind }, signal)),\n  );\n  const remove = useCallback((id: string) => client.comments.delete(id), [client]);\n  const restore = useCallback((id: string) => client.comments.restore(id), [client]);\n  const react = useCallback((c: Comment, v: Reaction) => reactToComment(client, store, c, v), [client, store]);\n  return { ...list, remove, restore, react };\n}\n\nexport interface UseModerationQueue extends UseList<HeldItem> {\n  /** Approves (publishes) or rejects at the revision the queue listed; the item leaves the queue. */\n  resolve: (item: HeldItem, decision: Decision, reason?: string) => Promise<void>;\n}\n\n/** Staff: held comments or posts awaiting review, oldest first (ModerationReview). */\nexport function useModerationQueue(o: { kind?: HeldKind; pageSize?: number; client?: ContentKitClient } = {}): UseModerationQueue {\n  const { client, store, viewer } = useContentScope(o.client);\n  const kind = o.kind ?? \"comment\";\n  const size = o.pageSize ?? 20;\n  const list = useList<HeldItem>(store, keyOf(\"held\", viewer, kind, size), { type: \"held\" }, async (cursor, signal) => {\n    const page = await client.moderation.held({ kind, cursor: typeof cursor === \"string\" ? cursor : undefined, limit: size }, signal);\n    return { items: page.items, next: page.next ?? null };\n  });\n  const resolve = useCallback(async (item: HeldItem, d: Decision, reason?: string) => void (await client.moderation.resolve(item, d, reason)), [client]);\n  return { ...list, resolve };\n}\n\nexport interface UseCommentBans extends UseList<CommentBan & { id: string }> {\n  ban: (user: string, input?: BanInput) => Promise<CommentBan>;\n  lift: (user: string) => Promise<void>;\n}\n\n/** The bans of one scope: the caller's own (\"owner\") or the site's (\"global\", CommentBan), newest first. */\nexport function useCommentBans(o: { scope?: BanScope; pageSize?: number; enabled?: boolean; client?: ContentKitClient } = {}): UseCommentBans {\n  const { client, store, viewer } = useContentScope(o.client);\n  const scope = o.scope ?? \"global\";\n  const size = o.pageSize ?? 25;\n  const list = useList(\n    store,\n    o.enabled === false ? null : keyOf(\"bans\", viewer, scope, size),\n    { type: \"bans\", scope },\n    offsetPages(size, async (q, signal) => (await client.bans.list(scope, q, signal)).map((b) => ({ ...b, id: b.user_id }))),\n  );\n  const ban = useCallback((user: string, input?: BanInput) => client.bans.ban(scope, user, input), [client, scope]);\n  const lift = useCallback((user: string) => client.bans.lift(scope, user), [client, scope]);\n  return { ...list, ban, lift };\n}\n"],"mappings":";;;AAQA,SAAgB,EAAa,GAAwB,GAAiC;CAGpF,OAAO;EAAE,OAFK,EAAO,QAAS,IAAO,SAAS,KAAc,QAAU;EAEtD,UADC,EAAO,WAAY,IAAO,SAAS,MAAe,QAAU;EACnD,MAAM;CAAM;AACxC;AAEA,IAAM,IAAe;CAAC;CAAY;CAAW;CAAU;AAAgB,GACjE,oBAAS,IAAI,QAA4C;AAG/D,eAAe,EAAe,GAA0B,GAAsB,GAAwD,GAAiB;CACrJ,IAAI,IAAI,EAAO,IAAI,CAAK;CACxB,AAAK,KAAG,EAAO,IAAI,GAAQ,oBAAI,IAAI,IAAI,CAAE;CACzC,IAAM,KAAS,EAAE,IAAI,EAAE,EAAE,KAAK,KAAK;CACnC,EAAE,IAAI,EAAE,IAAI,CAAK;CACjB,IAAM,KAAO,MACX,EAAM,OACH,MAAQ,EAAa,SAAS,EAAI,IAAI,IACtC,OAAU;EAAE,GAAG;EAAM,OAAO,EAAK,MAAM,KAAK,MAAO,EAAE,OAAO,EAAE,KAAK;GAAE,GAAG;GAAG,GAAG;EAAO,IAAI,CAAE;CAAE,EAChG;CACF,EAAI,EAAa;EAAE,OAAO,EAAE;EAAO,UAAU,EAAE;EAAU,MAAM,EAAE;CAAK,GAAG,CAAK,CAAC;CAC/E,IAAI;EACF,MAAM,EAAO,SAAS,MAAM,EAAE,IAAI,CAAK;CACzC,SAAS,GAAG;EAEV,MADI,EAAE,IAAI,EAAE,EAAE,MAAM,KAAO,EAAI;GAAE,OAAO,EAAE;GAAO,UAAU,EAAE;GAAU,MAAM,EAAE;EAAK,CAAC,GAC/E;CACR;AACF;AAsBA,SAAgB,EAAY,GAAc,IAAwB,CAAC,GAAgB;CACjF,IAAM,EAAE,WAAQ,UAAO,cAAW,EAAgB,EAAE,MAAM,GACpD,IAAO,EAAE,YAAY,IACrB,IAAO,EAAE,QAAQ,UACjB,IAAM,EAAM,YAAY,GAAQ,EAAI,MAAM,EAAI,IAAI,GAAM,CAAI,GAC5D,IAAO,EAAQ,GAAO,GAAK;EAAE,MAAM;EAAY,KAAK;GAAE,MAAM,EAAI;GAAM,IAAI,EAAI;EAAG;CAAE,GAAG,EAAY,IAAO,GAAG,MAAW,EAAO,SAAS,KAAK,GAAK;EAAE,GAAG;EAAG;CAAK,GAAG,CAAM,CAAC,CAAC,GACzK,EAAE,SAAM,UAAO,GACf,IAAO,GACV,GAAM,IAAI,CAAC,MAAM,EAAO,SAAS,OAAO;EAAE;EAAM;CAAG,GAAG;EAAE;EAAM,aAAa,EAAE;EAAS,WAAW,EAAE;CAAS,CAAC,GAC9G;EAAC;EAAQ;EAAM;CAAE,CACnB,GACM,IAAO,GAAa,GAAa,MAAiB,EAAO,SAAS,KAAK,GAAK,CAAI,GAAG,CAAC,CAAM,CAAC,GAC3F,IAAS,GAAa,MAAgB,EAAO,SAAS,OAAO,CAAG,GAAG,CAAC,CAAM,CAAC,GAC3E,IAAU,GAAa,MAAgB,EAAO,SAAS,QAAQ,CAAG,GAAG,CAAC,CAAM,CAAC,GAC7E,IAAQ,GAAa,GAAY,MAAgB,EAAe,GAAQ,GAAO,GAAG,CAAC,GAAG,CAAC,GAAQ,CAAK,CAAC;CAC3G,OAAO;EAAE,GAAG;EAAM;EAAM;EAAM;EAAQ;EAAO;CAAQ;AACvD;AAGA,SAAgB,EAAkB,GAAY,IAAyE,CAAC,GAAqB;CAC3I,IAAM,EAAE,WAAQ,UAAO,cAAW,EAAgB,EAAE,MAAM,GACpD,IAAO,EAAE,YAAY,IACrB,IAAM,EAAE,YAAY,KAAQ,OAAO,EAAM,WAAW,GAAQ,GAAI,CAAI;CAC1E,OAAO,EAAQ,GAAO,GAAK;EAAE,MAAM;EAAW;CAAG,GAAG,EAAY,IAAO,GAAG,MAAW,EAAO,SAAS,QAAQ,GAAI,GAAG,CAAM,CAAC,CAAC;AAC9H;AAGA,SAAgB,EAAc,GAAc,IAAmC,CAAC,GAAG;CACjF,IAAM,EAAE,WAAQ,UAAO,cAAW,EAAgB,EAAE,MAAM,GACpD,IAAI,EAA6B,GAAO,EAAM,YAAY,GAAQ,EAAI,MAAM,EAAI,EAAE,GAAG;EAAE,MAAM;EAAY,KAAK;GAAE,MAAM,EAAI;GAAM,IAAI,EAAI;EAAG;CAAE,IAAI,MACrJ,EAAO,SAAS,SAAS,GAAK,CAAC,CACjC;CACA,OAAO;EAAE,UAAU,EAAE,QAAQ;EAAM,SAAS,EAAE,WAAW,CAAC,EAAE;EAAQ,OAAO,EAAE;EAAO,QAAQ,EAAE;CAAO;AACvG;AAGA,SAAgB,EAAkB,IAAsD,CAAC,GAAsB;CAC7G,IAAM,EAAE,WAAQ,UAAO,cAAW,EAAgB,EAAE,MAAM,GACpD,IAAO,EAAE,YAAY;CAC3B,OAAO,EAAQ,GAAO,EAAM,UAAU,GAAQ,CAAI,GAAG,EAAE,MAAM,SAAS,GAAG,EAAY,IAAO,GAAG,MAAW,EAAO,SAAS,OAAO,GAAG,CAAM,GAAG,EAAI,CAAC;AACpJ;AASA,SAAgB,EAAiB,IAA4E,CAAC,GAAqB;CACjI,IAAM,EAAE,WAAQ,UAAO,cAAW,EAAgB,EAAE,MAAM,GACpD,IAAO,EAAE,YAAY,IACrB,IAAO,EAAE,eAAe,KAAA,GACxB,IAAO,EACX,GACA,EAAM,kBAAkB,GAAQ,GAAM,CAAI,GAC1C,EAAE,MAAM,iBAAiB,GACzB,EAAY,IAAO,GAAG,MAAW,EAAO,SAAS,UAAU;EAAE,GAAG;EAAG,aAAa;CAAK,GAAG,CAAM,CAAC,CACjG,GACM,IAAS,GAAa,MAAe,EAAO,SAAS,OAAO,CAAE,GAAG,CAAC,CAAM,CAAC,GACzE,IAAU,GAAa,MAAe,EAAO,SAAS,QAAQ,CAAE,GAAG,CAAC,CAAM,CAAC,GAC3E,IAAQ,GAAa,GAAY,MAAgB,EAAe,GAAQ,GAAO,GAAG,CAAC,GAAG,CAAC,GAAQ,CAAK,CAAC;CAC3G,OAAO;EAAE,GAAG;EAAM;EAAQ;EAAS;CAAM;AAC3C;AAQA,SAAgB,EAAmB,IAAuE,CAAC,GAAuB;CAChI,IAAM,EAAE,WAAQ,UAAO,cAAW,EAAgB,EAAE,MAAM,GACpD,IAAO,EAAE,QAAQ,WACjB,IAAO,EAAE,YAAY,IACrB,IAAO,EAAkB,GAAO,EAAM,QAAQ,GAAQ,GAAM,CAAI,GAAG,EAAE,MAAM,OAAO,GAAG,OAAO,GAAQ,MAAW;EACnH,IAAM,IAAO,MAAM,EAAO,WAAW,KAAK;GAAE;GAAM,QAAQ,OAAO,KAAW,WAAW,IAAS,KAAA;GAAW,OAAO;EAAK,GAAG,CAAM;EAChI,OAAO;GAAE,OAAO,EAAK;GAAO,MAAM,EAAK,QAAQ;EAAK;CACtD,CAAC,GACK,IAAU,EAAY,OAAO,GAAgB,GAAa,MAAoB,KAAM,MAAM,EAAO,WAAW,QAAQ,GAAM,GAAG,CAAM,GAAI,CAAC,CAAM,CAAC;CACrJ,OAAO;EAAE,GAAG;EAAM;CAAQ;AAC5B;AAQA,SAAgB,EAAe,IAA2F,CAAC,GAAmB;CAC5I,IAAM,EAAE,WAAQ,UAAO,cAAW,EAAgB,EAAE,MAAM,GACpD,IAAQ,EAAE,SAAS,UACnB,IAAO,EAAE,YAAY,IACrB,IAAO,EACX,GACA,EAAE,YAAY,KAAQ,OAAO,EAAM,QAAQ,GAAQ,GAAO,CAAI,GAC9D;EAAE,MAAM;EAAQ;CAAM,GACtB,EAAY,GAAM,OAAO,GAAG,OAAY,MAAM,EAAO,KAAK,KAAK,GAAO,GAAG,CAAM,EAAA,CAAG,KAAK,OAAO;EAAE,GAAG;EAAG,IAAI,EAAE;CAAQ,EAAE,CAAC,CACzH,GACM,IAAM,GAAa,GAAc,MAAqB,EAAO,KAAK,IAAI,GAAO,GAAM,CAAK,GAAG,CAAC,GAAQ,CAAK,CAAC,GAC1G,IAAO,GAAa,MAAiB,EAAO,KAAK,KAAK,GAAO,CAAI,GAAG,CAAC,GAAQ,CAAK,CAAC;CACzF,OAAO;EAAE,GAAG;EAAM;EAAK;CAAK;AAC9B"}

package/dist/react/config.d.ts

@@ -0,0 +1,13 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { Config } from '../client/generated/wire.js';
+export interface UseContentConfig {
+    /** null until it loads (or when it fails). */
+    config: Config | null;
+    loading: boolean;
+    error?: ContentKitError;
+}
+/** What the content module allows (client.config()): one read per client, whoever the viewer is. */
+export declare function useContentConfig(o?: {
+    client?: ContentKitClient;
+}): UseContentConfig;

package/dist/react/config.js

@@ -0,0 +1,14 @@
+import { keyOf as e, useContentScope as t, useResource as n } from "./use-resource.js";
+//#region src/react/config.ts
+function r(r = {}) {
+	let { client: i, store: a } = t(r.client), o = n(a, e("config"), { type: "config" }, (e) => i.config(e));
+	return {
+		config: o.data ?? null,
+		loading: o.loading || !o.loaded,
+		error: o.error
+	};
+}
+//#endregion
+export { r as useContentConfig };
+
+//# sourceMappingURL=config.js.map

package/dist/react/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../src/react/config.ts"],"sourcesContent":["import type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { Config } from \"../client/generated/wire.js\";\nimport { keyOf, useContentScope, useResource } from \"./use-resource.js\";\n\nexport interface UseContentConfig {\n  /** null until it loads (or when it fails). */\n  config: Config | null;\n  loading: boolean;\n  error?: ContentKitError;\n}\n\n/** What the content module allows (client.config()): one read per client, whoever the viewer is. */\nexport function useContentConfig(o: { client?: ContentKitClient } = {}): UseContentConfig {\n  const { client, store } = useContentScope(o.client);\n  const r = useResource<Config>(store, keyOf(\"config\"), { type: \"config\" }, (s) => client.config(s));\n  return { config: r.data ?? null, loading: r.loading || !r.loaded, error: r.error };\n}\n"],"mappings":";;AAaA,SAAgB,EAAiB,IAAmC,CAAC,GAAqB;CACxF,IAAM,EAAE,WAAQ,aAAU,EAAgB,EAAE,MAAM,GAC5C,IAAI,EAAoB,GAAO,EAAM,QAAQ,GAAG,EAAE,MAAM,SAAS,IAAI,MAAM,EAAO,OAAO,CAAC,CAAC;CACjG,OAAO;EAAE,QAAQ,EAAE,QAAQ;EAAM,SAAS,EAAE,WAAW,CAAC,EAAE;EAAQ,OAAO,EAAE;CAAM;AACnF"}

package/dist/react/context.d.ts

@@ -0,0 +1,48 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { ContentURLs } from '../urls/index.js';
+import { ReadStore } from './store.js';
+/** What failed: a component's or hook's save, load or render step. */
+export type ContentKitOperation = "poster.load" | "poster.frame" | "poster.save" | "slot.load" | "slot.decode" | "slot.save" | "slot.remove" | "upload" | "folder.load" | "folder.commit" | "folder.update" | "folder.process" | "crop.load" | "crop.save" | SocialOperation;
+/** What failed in a content component: a load or a write. */
+export type SocialOperation = "comment.load" | "comment.post" | "comment.edit" | "comment.delete" | "comment.react" | "comment.restore" | "ban.save" | "ban.lift" | "reaction.save" | "favorite.save" | "poll.load" | "poll.vote" | "poll.answer" | "poll.save" | "post.load" | "post.save" | "moderation.load" | "moderation.resolve";
+/** The failure's context: the operation and, for one file, its name. */
+export interface ContentKitErrorInfo {
+    operation: ContentKitOperation;
+    file?: string;
+}
+/**
+ * Every failure a component shows is also reported here (aborts excepted), so
+ * the host can toast or log it. Components still show it in place.
+ */
+export type ContentKitErrorHandler = (error: ContentKitError, info: ContentKitErrorInfo) => void;
+/** The host router: in-app navigation, e.g. a canonical replace. */
+export type Navigate = (to: string, options?: {
+    replace?: boolean;
+}) => void;
+export interface ContentKitContextValue {
+    client: ContentKitClient;
+    /**
+     * The signed-in user's id as ContentKit sees it, null when signed out,
+     * undefined when the host does not say. Content reads are kept per viewer.
+     */
+    viewer?: string | null;
+    /** Asks the visitor to sign in; with it, signed-out visitors are prompted instead of acting anonymously. */
+    onSignIn?: () => void;
+    /** The host's content URL config (createContentURLs). */
+    urls?: ContentURLs;
+    navigate?: Navigate;
+    onError?: ContentKitErrorHandler;
+    /** The reads hooks share. */
+    store: ReadStore;
+}
+export declare const ContentKitContext: import('react').Context<ContentKitContextValue | null>;
+/** The ContentKitProvider's value; throws outside one. */
+export declare function useContentKit(): ContentKitContextValue;
+/** The client a hook or component uses: its own, else the provider's; throws without either. */
+export declare function useContentKitClient(own?: ContentKitClient | null): ContentKitClient;
+export declare function useOptionalContentKitClient(own?: ContentKitClient | null): ContentKitClient | null;
+/** The provider's content URL helpers; throws when none were given. */
+export declare function useContentURLs(): ContentURLs;
+/** A stable reporter: the component's own `onError`, else the provider's. */
+export declare function useErrorReporter(own?: ContentKitErrorHandler): (e: unknown, operation: ContentKitOperation, file?: string) => void;

package/dist/react/context.js

@@ -0,0 +1,37 @@
+import { toContentKitError as e } from "../client/errors.js";
+import { createContext as t, useCallback as n, useContext as r, useRef as i } from "react";
+//#region src/react/context.ts
+var a = t(null);
+function o() {
+	let e = r(a);
+	if (!e) throw Error("contentkit-ui: wrap the tree in <ContentKitProvider client>");
+	return e;
+}
+function s(e) {
+	let t = c(e);
+	if (!t) throw Error("contentkit-ui: pass `client` or render inside <ContentKitProvider client>");
+	return t;
+}
+function c(e) {
+	let t = r(a);
+	return e ?? t?.client ?? null;
+}
+function l() {
+	let e = r(a)?.urls;
+	if (!e) throw Error("contentkit-ui: pass `urls` to <ContentKitProvider>");
+	return e;
+}
+function u(t) {
+	let o = r(a)?.onError, s = i(t ?? o);
+	return s.current = t ?? o, n((t, n, r) => {
+		let i = e(t);
+		i.code !== "aborted" && s.current?.(i, r === void 0 ? { operation: n } : {
+			operation: n,
+			file: r
+		});
+	}, []);
+}
+//#endregion
+export { a as ContentKitContext, o as useContentKit, s as useContentKitClient, l as useContentURLs, u as useErrorReporter, c as useOptionalContentKitClient };
+
+//# sourceMappingURL=context.js.map

package/dist/react/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../src/react/context.ts"],"sourcesContent":["import { createContext, useCallback, useContext, useRef } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { ContentURLs } from \"../urls/index.js\";\nimport type { ReadStore } from \"./store.js\";\n\n/** What failed: a component's or hook's save, load or render step. */\nexport type ContentKitOperation =\n  | \"poster.load\"\n  | \"poster.frame\"\n  | \"poster.save\"\n  | \"slot.load\"\n  | \"slot.decode\"\n  | \"slot.save\"\n  | \"slot.remove\"\n  | \"upload\"\n  | \"folder.load\"\n  | \"folder.commit\"\n  | \"folder.update\"\n  | \"folder.process\"\n  | \"crop.load\"\n  | \"crop.save\"\n  | SocialOperation;\n\n/** What failed in a content component: a load or a write. */\nexport type SocialOperation =\n  | \"comment.load\"\n  | \"comment.post\"\n  | \"comment.edit\"\n  | \"comment.delete\"\n  | \"comment.react\"\n  | \"comment.restore\"\n  | \"ban.save\"\n  | \"ban.lift\"\n  | \"reaction.save\"\n  | \"favorite.save\"\n  | \"poll.load\"\n  | \"poll.vote\"\n  | \"poll.answer\"\n  | \"poll.save\"\n  | \"post.load\"\n  | \"post.save\"\n  | \"moderation.load\"\n  | \"moderation.resolve\";\n\n/** The failure's context: the operation and, for one file, its name. */\nexport interface ContentKitErrorInfo {\n  operation: ContentKitOperation;\n  file?: string;\n}\n\n/**\n * Every failure a component shows is also reported here (aborts excepted), so\n * the host can toast or log it. Components still show it in place.\n */\nexport type ContentKitErrorHandler = (error: ContentKitError, info: ContentKitErrorInfo) => void;\n\n/** The host router: in-app navigation, e.g. a canonical replace. */\nexport type Navigate = (to: string, options?: { replace?: boolean }) => void;\n\nexport interface ContentKitContextValue {\n  client: ContentKitClient;\n  /**\n   * The signed-in user's id as ContentKit sees it, null when signed out,\n   * undefined when the host does not say. Content reads are kept per viewer.\n   */\n  viewer?: string | null;\n  /** Asks the visitor to sign in; with it, signed-out visitors are prompted instead of acting anonymously. */\n  onSignIn?: () => void;\n  /** The host's content URL config (createContentURLs). */\n  urls?: ContentURLs;\n  navigate?: Navigate;\n  onError?: ContentKitErrorHandler;\n  /** The reads hooks share. */\n  store: ReadStore;\n}\n\nexport const ContentKitContext = createContext<ContentKitContextValue | null>(null);\n\n/** The ContentKitProvider's value; throws outside one. */\nexport function useContentKit(): ContentKitContextValue {\n  const ctx = useContext(ContentKitContext);\n  if (!ctx) throw new Error(\"contentkit-ui: wrap the tree in <ContentKitProvider client>\");\n  return ctx;\n}\n\n/** The client a hook or component uses: its own, else the provider's; throws without either. */\nexport function useContentKitClient(own?: ContentKitClient | null): ContentKitClient {\n  const c = useOptionalContentKitClient(own);\n  if (!c) throw new Error(\"contentkit-ui: pass `client` or render inside <ContentKitProvider client>\");\n  return c;\n}\n\nexport function useOptionalContentKitClient(own?: ContentKitClient | null): ContentKitClient | null {\n  const ctx = useContext(ContentKitContext);\n  return own ?? ctx?.client ?? null;\n}\n\n/** The provider's content URL helpers; throws when none were given. */\nexport function useContentURLs(): ContentURLs {\n  const urls = useContext(ContentKitContext)?.urls;\n  if (!urls) throw new Error(\"contentkit-ui: pass `urls` to <ContentKitProvider>\");\n  return urls;\n}\n\n/** A stable reporter: the component's own `onError`, else the provider's. */\nexport function useErrorReporter(own?: ContentKitErrorHandler): (e: unknown, operation: ContentKitOperation, file?: string) => void {\n  const ctx = useContext(ContentKitContext)?.onError;\n  const handler = useRef(own ?? ctx);\n  handler.current = own ?? ctx;\n  return useCallback((e: unknown, operation: ContentKitOperation, file?: string) => {\n    const error = toContentKitError(e);\n    if (error.code !== \"aborted\") handler.current?.(error, file === undefined ? { operation } : { operation, file });\n  }, []);\n}\n"],"mappings":";;;AA6EA,IAAa,IAAoB,EAA6C,IAAI;AAGlF,SAAgB,IAAwC;CACtD,IAAM,IAAM,EAAW,CAAiB;CACxC,IAAI,CAAC,GAAK,MAAU,MAAM,6DAA6D;CACvF,OAAO;AACT;AAGA,SAAgB,EAAoB,GAAiD;CACnF,IAAM,IAAI,EAA4B,CAAG;CACzC,IAAI,CAAC,GAAG,MAAU,MAAM,2EAA2E;CACnG,OAAO;AACT;AAEA,SAAgB,EAA4B,GAAwD;CAClG,IAAM,IAAM,EAAW,CAAiB;CACxC,OAAO,KAAO,GAAK,UAAU;AAC/B;AAGA,SAAgB,IAA8B;CAC5C,IAAM,IAAO,EAAW,CAAiB,CAAC,EAAE;CAC5C,IAAI,CAAC,GAAM,MAAU,MAAM,oDAAoD;CAC/E,OAAO;AACT;AAGA,SAAgB,EAAiB,GAAmG;CAClI,IAAM,IAAM,EAAW,CAAiB,CAAC,EAAE,SACrC,IAAU,EAAO,KAAO,CAAG;CAEjC,OADA,EAAQ,UAAU,KAAO,GAClB,GAAa,GAAY,GAAgC,MAAkB;EAChF,IAAM,IAAQ,EAAkB,CAAC;EACjC,AAAI,EAAM,SAAS,aAAW,EAAQ,UAAU,GAAO,MAAS,KAAA,IAAY,EAAE,aAAU,IAAI;GAAE;GAAW;EAAK,CAAC;CACjH,GAAG,CAAC,CAAC;AACP"}

package/dist/react/crop.d.ts

@@ -0,0 +1,49 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { Edit, FileInfo, RefBody } from '../client/generated/wire.js';
+import { CropSource } from '../client/image.js';
+import { ContentKitErrorHandler } from './context.js';
+export interface EditorCropOptions {
+    /** save() also waits until the worker rendered the edit. Default false (an editor read shows it processing). */
+    wait?: boolean;
+    /** With the item's uploads after each save. */
+    onSaved?: (files: FileInfo[]) => void;
+    /** Every failed load or save; default the provider's. */
+    onError?: ContentKitErrorHandler;
+    /** Overrides the provider's client. */
+    client?: ContentKitClient;
+}
+/** source is the upload's editor view and its oriented size; edit its current edit. */
+export type EditorCropState = {
+    status: "idle";
+} | {
+    status: "loading";
+} | {
+    status: "cropping";
+    source: CropSource;
+    edit: Edit | null;
+} | {
+    status: "saving";
+    source: CropSource;
+    edit: Edit | null;
+} | {
+    status: "done";
+    files: FileInfo[];
+} | {
+    status: "error";
+    error: ContentKitError;
+    source?: CropSource;
+    edit?: Edit | null;
+};
+export type UseEditorCrop = EditorCropState & {
+    /** Commits the edit (null removes it); resolves with the item's uploads, or undefined on failure. */
+    save: (edit: Edit | null) => Promise<FileInfo[] | undefined>;
+    /** Loads the editor view again after a failure. */
+    retry: () => void;
+};
+/**
+ * Re-crops a kept upload: while path is set, its editor view (the original,
+ * oriented, unedited) loads for a cropper; save() commits an edit op. Nothing
+ * is uploaded. Clear path to close.
+ */
+export declare function useEditorCrop(ref: RefBody, path: string | null | undefined, o?: EditorCropOptions): UseEditorCrop;