@openrails/contentkit-ui 0.0.0-placeholder → 0.68.0

package/dist/react/polls.d.ts

@@ -0,0 +1,74 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { Poll, PollInput, PollOption, PollUpdate } from '../client/generated/wire.js';
+import { UseList } from './use-resource.js';
+/** The poll after the caller votes for option; a vote is final. */
+export declare function withVote(p: Poll, option: string): Poll;
+export interface UsePoll {
+    /** null: no such poll (or no live one). */
+    poll: Poll | null;
+    loading: boolean;
+    error?: ContentKitError;
+    reload: () => void;
+    /** A vote or answer is in flight. */
+    pending: boolean;
+    /** Votes at once (a vote is final); rolled back if the server refuses it. */
+    vote: (option: string) => Promise<void>;
+    /** Stores or replaces the signed-in caller's free-text answer. */
+    answer: (text: string) => Promise<void>;
+}
+/**
+ * A poll with the caller's vote or answer. Without an id it is the newest
+ * live poll (in language): the one a home page shows.
+ */
+export declare function usePoll(id?: string | null, o?: {
+    initial?: Poll;
+    language?: string;
+    client?: ContentKitClient;
+}): UsePoll;
+export interface PollFilter {
+    language?: string;
+    /** YYYY-MM */
+    month?: string;
+    /** YYYY-MM-DD */
+    date?: string;
+    /** Staff: every poll, scheduled and inactive ones included (PollWrite). */
+    admin?: boolean;
+    pageSize?: number;
+}
+/** Polls, newest first, a page at a time. */
+export declare function usePolls(f?: PollFilter, o?: {
+    client?: ContentKitClient;
+}): UseList<Poll>;
+/** Images for a new poll, uploaded once it exists: the question's, and each option's by index. */
+export interface PollImages {
+    question?: Blob | null;
+    options?: readonly (Blob | null | undefined)[];
+}
+export interface UsePollEditor {
+    /** null before create (or while loading). */
+    poll: Poll | null;
+    loading: boolean;
+    error?: ContentKitError;
+    /** Writes in flight. */
+    saving: boolean;
+    /** Creates the poll, then uploads its images; the editor then edits it. Image failures are returned, not thrown. */
+    create: (input: PollInput, images?: PollImages) => Promise<{
+        poll: Poll;
+        imageErrors: ContentKitError[];
+    }>;
+    update: (patch: PollUpdate) => Promise<Poll>;
+    remove: () => Promise<void>;
+    addOption: (label: string, image?: Blob | null) => Promise<PollOption>;
+    renameOption: (option: string, label: string) => Promise<void>;
+    /** Removes an option and its votes; a poll keeps at least two. */
+    removeOption: (option: string) => Promise<void>;
+    /** Moves an option to index to, at once; refetched if a write fails. */
+    moveOption: (option: string, to: number) => Promise<void>;
+    setImage: (file: Blob | null) => Promise<void>;
+    setOptionImage: (option: string, file: Blob | null) => Promise<void>;
+}
+/** Staff: one poll's editor (PollWrite); null creates a new poll. */
+export declare function usePollEditor(id: string | null | undefined, o?: {
+    client?: ContentKitClient;
+}): UsePollEditor;

package/dist/react/polls.js

@@ -0,0 +1,176 @@
+import { toContentKitError as e } from "../client/errors.js";
+import { keyOf as t, offsetPages as n, useContentScope as r, useList as i, useResource as a } from "./use-resource.js";
+import { useCallback as o, useState as s } from "react";
+//#region src/react/polls.ts
+function c(e, t) {
+	return e.voted ? e : {
+		...e,
+		voted: !0,
+		my_option: t,
+		total_votes: e.total_votes + 1,
+		options: e.options.map((e) => e.id === t ? {
+			...e,
+			vote_count: e.vote_count + 1
+		} : e)
+	};
+}
+function l(n, i = {}) {
+	let { client: l, store: u, viewer: d } = r(i.client), f = n ? t("poll", d, n) : t("poll", d, "latest", i.language ?? ""), p = a(u, f, {
+		type: "poll",
+		id: n ?? void 0
+	}, async (e) => n ? l.polls.get(n, e) : (await l.polls.list({
+		language: i.language,
+		limit: 1
+	}, e))[0] ?? null, { initial: i.initial }), [m, h] = s(!1), g = p.data ?? null, _ = o(async (t) => {
+		let n = u.snapshot(f).data ?? g;
+		if (!n) return;
+		let r = u.mark(f);
+		u.set(f, c(n, t)), h(!0);
+		try {
+			await l.polls.vote(n.id, t);
+		} catch (t) {
+			throw u.rollback(f, r, n), e(t);
+		} finally {
+			h(!1);
+		}
+	}, [
+		l,
+		u,
+		f,
+		g
+	]), v = o(async (e) => {
+		if (g) {
+			h(!0);
+			try {
+				await l.polls.answer(g.id, e);
+			} finally {
+				h(!1);
+			}
+		}
+	}, [l, g]);
+	return {
+		poll: g,
+		loading: p.loading || !p.loaded && i.initial === void 0,
+		error: p.error,
+		reload: p.reload,
+		pending: m,
+		vote: _,
+		answer: v
+	};
+}
+function u(e = {}, a = {}) {
+	let { client: o, store: s, viewer: c } = r(a.client), l = e.pageSize ?? 20, u = {
+		language: e.language,
+		month: e.month,
+		date: e.date
+	};
+	return i(s, t("polls", c, !!e.admin, u.language, u.month, u.date, l), { type: "polls" }, n(l, (t, n) => e.admin ? o.polls.adminList({
+		...u,
+		...t
+	}, n) : o.polls.list({
+		...u,
+		...t
+	}, n)));
+}
+function d(n, i = {}) {
+	let { client: c, store: l, viewer: u } = r(i.client), [d, f] = s(null), p = n ?? d, m = p ? t("poll", u, p) : null, h = a(l, m, {
+		type: "poll",
+		id: p ?? void 0
+	}, (e) => c.polls.get(p, e)), g = h.data ?? null, [_, v] = s(0), y = o(async (e) => {
+		v((e) => e + 1);
+		try {
+			return await e();
+		} finally {
+			v((e) => e - 1);
+		}
+	}, []), b = o(() => {
+		if (!p) throw Error("contentkit-ui: create the poll first");
+		return p;
+	}, [p]), x = o((t, n = {}) => y(async () => {
+		let r = await c.polls.create(t), i = [], a = [];
+		n.question && a.push(c.polls.uploadImage(r.id, n.question));
+		let o = [...r.options].sort((e, t) => e.position - t.position);
+		(t.options ?? []).forEach((e, t) => {
+			let i = n.options?.[t], s = o.find((t) => t.position === e.position) ?? o[t];
+			i && s && a.push(c.polls.uploadOptionImage(r.id, s.id, i));
+		});
+		for (let t of await Promise.allSettled(a)) t.status === "rejected" && i.push(e(t.reason));
+		return f(r.id), {
+			poll: a.length ? await c.polls.get(r.id) : r,
+			imageErrors: i
+		};
+	}), [c, y]), S = o((e) => y(() => c.polls.update(b(), e)), [
+		c,
+		y,
+		b
+	]), C = o(() => y(() => c.polls.delete(b())), [
+		c,
+		y,
+		b
+	]), w = o((e, t) => y(async () => {
+		let n = await c.polls.addOption(b(), { label: e });
+		return t && (n.image_url = await c.polls.uploadOptionImage(b(), n.id, t) ?? void 0), n;
+	}), [
+		c,
+		y,
+		b
+	]), T = o((e, t) => y(async () => void await c.polls.updateOption(b(), e, { label: t })), [
+		c,
+		y,
+		b
+	]), E = o((e) => y(() => c.polls.deleteOption(b(), e)), [
+		c,
+		y,
+		b
+	]), D = o((e, t) => y(async () => {
+		let n = l.snapshot(m).data;
+		if (!n) return;
+		let r = [...n.options].sort((e, t) => e.position - t.position), i = r.findIndex((t) => t.id === e);
+		if (!(i < 0 || t < 0 || t >= r.length || i === t)) {
+			r.splice(t, 0, ...r.splice(i, 1)), l.set(m, {
+				...n,
+				options: r.map((e, t) => ({
+					...e,
+					position: t
+				}))
+			});
+			try {
+				await c.polls.reorderOptions(n.id, r);
+			} catch (e) {
+				throw l.load(m, !0), e;
+			}
+		}
+	}), [
+		c,
+		l,
+		m,
+		y
+	]), O = o((e) => y(async () => void await c.polls.uploadImage(b(), e)), [
+		c,
+		y,
+		b
+	]), k = o((e, t) => y(async () => void await c.polls.uploadOptionImage(b(), e, t)), [
+		c,
+		y,
+		b
+	]);
+	return {
+		poll: g,
+		loading: !!m && (h.loading || !h.loaded),
+		error: h.error,
+		saving: _ > 0,
+		create: x,
+		update: S,
+		remove: C,
+		addOption: w,
+		renameOption: T,
+		removeOption: E,
+		moveOption: D,
+		setImage: O,
+		setOptionImage: k
+	};
+}
+//#endregion
+export { l as usePoll, d as usePollEditor, u as usePolls, c as withVote };
+
+//# sourceMappingURL=polls.js.map

package/dist/react/polls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polls.js","names":[],"sources":["../../src/react/polls.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Poll, PollInput, PollOption, PollUpdate } from \"../client/generated/wire.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\n/** The poll after the caller votes for option; a vote is final. */\nexport function withVote(p: Poll, option: string): Poll {\n  if (p.voted) return p;\n  return { ...p, voted: true, my_option: option, total_votes: p.total_votes + 1, options: p.options.map((o) => (o.id === option ? { ...o, vote_count: o.vote_count + 1 } : o)) };\n}\n\nexport interface UsePoll {\n  /** null: no such poll (or no live one). */\n  poll: Poll | null;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n  /** A vote or answer is in flight. */\n  pending: boolean;\n  /** Votes at once (a vote is final); rolled back if the server refuses it. */\n  vote: (option: string) => Promise<void>;\n  /** Stores or replaces the signed-in caller's free-text answer. */\n  answer: (text: string) => Promise<void>;\n}\n\n/**\n * A poll with the caller's vote or answer. Without an id it is the newest\n * live poll (in language): the one a home page shows.\n */\nexport function usePoll(id?: string | null, o: { initial?: Poll; language?: string; client?: ContentKitClient } = {}): UsePoll {\n  const { client, store, viewer } = useContentScope(o.client);\n  const key = id ? keyOf(\"poll\", viewer, id) : keyOf(\"poll\", viewer, \"latest\", o.language ?? \"\");\n  const r = useResource<Poll | null>(\n    store,\n    key,\n    { type: \"poll\", id: id ?? undefined },\n    async (s) => (id ? client.polls.get(id, s) : ((await client.polls.list({ language: o.language, limit: 1 }, s))[0] ?? null)),\n    { initial: o.initial },\n  );\n  const [pending, setPending] = useState(false);\n  const poll = r.data ?? null;\n  const vote = useCallback(\n    async (option: string) => {\n      const prev = store.snapshot<Poll | null>(key).data ?? poll;\n      if (!prev) return;\n      const token = store.mark(key);\n      store.set(key, withVote(prev, option));\n      setPending(true);\n      try {\n        await client.polls.vote(prev.id, option);\n      } catch (e) {\n        store.rollback(key, token, prev);\n        throw toContentKitError(e);\n      } finally {\n        setPending(false);\n      }\n    },\n    [client, store, key, poll],\n  );\n  const answer = useCallback(\n    async (text: string) => {\n      if (!poll) return;\n      setPending(true);\n      try {\n        await client.polls.answer(poll.id, text);\n      } finally {\n        setPending(false);\n      }\n    },\n    [client, poll],\n  );\n  return { poll, loading: r.loading || (!r.loaded && o.initial === undefined), error: r.error, reload: r.reload, pending, vote, answer };\n}\n\nexport interface PollFilter {\n  language?: string;\n  /** YYYY-MM */\n  month?: string;\n  /** YYYY-MM-DD */\n  date?: string;\n  /** Staff: every poll, scheduled and inactive ones included (PollWrite). */\n  admin?: boolean;\n  pageSize?: number;\n}\n\n/** Polls, newest first, a page at a time. */\nexport function usePolls(f: PollFilter = {}, o: { client?: ContentKitClient } = {}): UseList<Poll> {\n  const { client, store, viewer } = useContentScope(o.client);\n  const size = f.pageSize ?? 20;\n  const q = { language: f.language, month: f.month, date: f.date };\n  return useList(\n    store,\n    keyOf(\"polls\", viewer, !!f.admin, q.language, q.month, q.date, size),\n    { type: \"polls\" },\n    offsetPages(size, (page, signal) => (f.admin ? client.polls.adminList({ ...q, ...page }, signal) : client.polls.list({ ...q, ...page }, signal))),\n  );\n}\n\n/** Images for a new poll, uploaded once it exists: the question's, and each option's by index. */\nexport interface PollImages {\n  question?: Blob | null;\n  options?: readonly (Blob | null | undefined)[];\n}\n\nexport interface UsePollEditor {\n  /** null before create (or while loading). */\n  poll: Poll | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Writes in flight. */\n  saving: boolean;\n  /** Creates the poll, then uploads its images; the editor then edits it. Image failures are returned, not thrown. */\n  create: (input: PollInput, images?: PollImages) => Promise<{ poll: Poll; imageErrors: ContentKitError[] }>;\n  update: (patch: PollUpdate) => Promise<Poll>;\n  remove: () => Promise<void>;\n  addOption: (label: string, image?: Blob | null) => Promise<PollOption>;\n  renameOption: (option: string, label: string) => Promise<void>;\n  /** Removes an option and its votes; a poll keeps at least two. */\n  removeOption: (option: string) => Promise<void>;\n  /** Moves an option to index to, at once; refetched if a write fails. */\n  moveOption: (option: string, to: number) => Promise<void>;\n  setImage: (file: Blob | null) => Promise<void>;\n  setOptionImage: (option: string, file: Blob | null) => Promise<void>;\n}\n\n/** Staff: one poll's editor (PollWrite); null creates a new poll. */\nexport function usePollEditor(id: string | null | undefined, o: { client?: ContentKitClient } = {}): UsePollEditor {\n  const { client, store, viewer } = useContentScope(o.client);\n  const [created, setCreated] = useState<string | null>(null);\n  const pid = id ?? created;\n  const key = pid ? keyOf(\"poll\", viewer, pid) : null;\n  const r = useResource<Poll | null>(store, key, { type: \"poll\", id: pid ?? undefined }, (s) => client.polls.get(pid!, s));\n  const poll = r.data ?? null;\n  const [inflight, setInflight] = useState(0);\n  const run = useCallback(async <T>(fn: () => Promise<T>): Promise<T> => {\n    setInflight((n) => n + 1);\n    try {\n      return await fn();\n    } finally {\n      setInflight((n) => n - 1);\n    }\n  }, []);\n  const need = useCallback(() => {\n    if (!pid) throw new Error(\"contentkit-ui: create the poll first\");\n    return pid;\n  }, [pid]);\n\n  const create = useCallback<UsePollEditor[\"create\"]>(\n    (input, images = {}) =>\n      run(async () => {\n        const made = await client.polls.create(input);\n        const imageErrors: ContentKitError[] = [];\n        const tries: Promise<unknown>[] = [];\n        if (images.question) tries.push(client.polls.uploadImage(made.id, images.question));\n        const byPosition = [...made.options].sort((a, b) => a.position - b.position);\n        (input.options ?? []).forEach((opt, i) => {\n          const file = images.options?.[i];\n          const target = byPosition.find((x) => x.position === opt.position) ?? byPosition[i];\n          if (file && target) tries.push(client.polls.uploadOptionImage(made.id, target.id, file));\n        });\n        for (const res of await Promise.allSettled(tries)) if (res.status === \"rejected\") imageErrors.push(toContentKitError(res.reason));\n        setCreated(made.id);\n        return { poll: tries.length ? await client.polls.get(made.id) : made, imageErrors };\n      }),\n    [client, run],\n  );\n  const update = useCallback((patch: PollUpdate) => run(() => client.polls.update(need(), patch)), [client, run, need]);\n  const remove = useCallback(() => run(() => client.polls.delete(need())), [client, run, need]);\n  const addOption = useCallback(\n    (label: string, image?: Blob | null) =>\n      run(async () => {\n        const opt = await client.polls.addOption(need(), { label });\n        if (image) opt.image_url = (await client.polls.uploadOptionImage(need(), opt.id, image)) ?? undefined;\n        return opt;\n      }),\n    [client, run, need],\n  );\n  const renameOption = useCallback((option: string, label: string) => run(async () => void (await client.polls.updateOption(need(), option, { label }))), [client, run, need]);\n  const removeOption = useCallback((option: string) => run(() => client.polls.deleteOption(need(), option)), [client, run, need]);\n  const moveOption = useCallback(\n    (option: string, to: number) =>\n      run(async () => {\n        const current = store.snapshot<Poll | null>(key!).data;\n        if (!current) return;\n        const order = [...current.options].sort((a, b) => a.position - b.position);\n        const from = order.findIndex((x) => x.id === option);\n        if (from < 0 || to < 0 || to >= order.length || from === to) return;\n        order.splice(to, 0, ...order.splice(from, 1));\n        store.set<Poll | null>(key!, { ...current, options: order.map((x, position) => ({ ...x, position })) });\n        try {\n          await client.polls.reorderOptions(current.id, order);\n        } catch (e) {\n          store.load(key!, true);\n          throw e;\n        }\n      }),\n    [client, store, key, run],\n  );\n  const setImage = useCallback((file: Blob | null) => run(async () => void (await client.polls.uploadImage(need(), file))), [client, run, need]);\n  const setOptionImage = useCallback(\n    (option: string, file: Blob | null) => run(async () => void (await client.polls.uploadOptionImage(need(), option, file))),\n    [client, run, need],\n  );\n  return {\n    poll,\n    loading: !!key && (r.loading || !r.loaded),\n    error: r.error,\n    saving: inflight > 0,\n    create,\n    update,\n    remove,\n    addOption,\n    renameOption,\n    removeOption,\n    moveOption,\n    setImage,\n    setOptionImage,\n  };\n}\n"],"mappings":"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"}

package/dist/react/posts.d.ts

@@ -0,0 +1,59 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { Sort } from '../client/content/types.js';
+import { Post, PostInput } from '../client/generated/wire.js';
+import { UseList } from './use-resource.js';
+export interface PostFilter {
+    language?: string;
+    sort?: Sort;
+    /** Staff: every post, drafts and scheduled ones included (PostWrite). */
+    admin?: boolean;
+    /** With admin: true only drafts, false no drafts. */
+    draft?: boolean;
+    /** With admin: the deleted posts instead of the live ones. */
+    deleted?: boolean;
+    /** With admin: only posts whose title, excerpt or body contains this text. */
+    q?: string;
+    pageSize?: number;
+}
+/** Posts, a page at a time: the published ones, or every one for staff. */
+export declare function usePosts(f?: PostFilter, o?: {
+    client?: ContentKitClient;
+}): UseList<Post>;
+export interface UsePost {
+    /** null before create (or while loading). */
+    post: Post | null;
+    loading: boolean;
+    error?: ContentKitError;
+    /** Writes in flight. */
+    saving: boolean;
+    /** Creates the post; the hook then edits it. */
+    create: (input: PostInput) => Promise<Post>;
+    /** Updates the given fields; a body from the editor is stored with its images' public URLs (storedBody). */
+    update: (patch: PostInput) => Promise<Post>;
+    remove: () => Promise<void>;
+    /** Restores the deleted post (PostWrite). */
+    restore: () => Promise<Post>;
+    /** Uploads the cover (null clears it); resolves with a URL that shows it now. */
+    setCover: (file: Blob | null) => Promise<string | null>;
+    /** Uploads an image for the body; resolves with a URL that shows it now, to place in the editor. */
+    uploadImage: (file: Blob) => Promise<string>;
+    /**
+     * A URL that shows one of the post's images now (the cover, a body image):
+     * an unpublished post's images are not public yet, so its editors see them
+     * through signed URLs of an editor read; a fresh upload shows from the
+     * file itself. Any other URL is returned as is.
+     */
+    imageSrc: (url: string | null | undefined) => string | undefined;
+    /** post.body with its images through imageSrc: what a rich-text editor shows. */
+    editorBody: string | undefined;
+    /** HTML from the editor with the URLs imageSrc gave back to the images' public URLs. */
+    storedBody: (html: string) => string;
+}
+/** Whether readers see the post, and so its images' public files exist. */
+export declare function isPublished(post: Post, now?: number): boolean;
+/** One post: read, and for staff (PostWrite) create, update, delete, restore, cover and body images. null creates a new post. */
+export declare function usePost(id: string | null | undefined, o?: {
+    initial?: Post;
+    client?: ContentKitClient;
+}): UsePost;

package/dist/react/posts.js

@@ -0,0 +1,149 @@
+import { useMediaRead as e } from "./read.js";
+import { keyOf as t, offsetPages as n, useContentScope as r, useList as i, useResource as a } from "./use-resource.js";
+import { useCallback as o, useEffect as s, useMemo as c, useRef as l, useState as u } from "react";
+//#region src/react/posts.ts
+function d(e = {}, a = {}) {
+	let { client: o, store: s, viewer: c } = r(a.client), l = e.pageSize ?? 20;
+	return i(s, t("posts", c, !!e.admin, e.language, e.sort, e.draft, e.deleted, e.q, l), {
+		type: "posts",
+		scope: e.admin && e.deleted ? "deleted" : void 0
+	}, n(l, (t, n) => e.admin ? o.posts.adminList({
+		...t,
+		language: e.language,
+		draft: e.draft,
+		deleted: e.deleted,
+		q: e.q
+	}, n) : o.posts.list({
+		...t,
+		language: e.language,
+		sort: e.sort
+	}, n)));
+}
+var f = "i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}", p = (e) => e.match(new RegExp(f))?.[0], m = RegExp(`[^\\s"'()<>]*${f}[^\\s"'()<>]*`, "g");
+function h(e, t = Date.now()) {
+	return !e.is_draft && !e.moderation && (!e.live_at || Date.parse(e.live_at) <= t);
+}
+function g(n, i = {}) {
+	let { client: d, store: f, viewer: g } = r(i.client), [_, v] = u(null), y = n ?? _, b = y ? t("post", g, y) : null, x = a(f, b, {
+		type: "post",
+		id: y ?? void 0
+	}, (e) => d.posts.get(y, e), { initial: i.initial }), S = x.data ?? null, [C, w] = u(0), T = o(async (e) => {
+		w((e) => e + 1);
+		try {
+			return await e();
+		} finally {
+			w((e) => e - 1);
+		}
+	}, []), E = o(() => {
+		if (!y) throw Error("contentkit-ui: create the post first");
+		return y;
+	}, [y]), [D, O] = u(/* @__PURE__ */ new Map()), k = l(/* @__PURE__ */ new Map());
+	s(() => {
+		let e = k.current;
+		return () => {
+			for (let t of e.keys()) t.startsWith("blob:") && URL.revokeObjectURL(t);
+		};
+	}, []);
+	let A = c(() => {
+		let e = /* @__PURE__ */ new Map();
+		for (let t of [...S?.body.match(m) ?? [], S?.cover_url ?? ""]) {
+			let n = p(t);
+			n && !e.has(n) && e.set(n, t);
+		}
+		return e;
+	}, [S?.body, S?.cover_url]), j = !!S && !h(S) && [...A.keys()].some((e) => !D.has(e)), M = c(() => d.media.postRef(y ?? "none"), [d, y]), N = e(M, {
+		editor: !0,
+		read: j ? void 0 : null,
+		client: d
+	}), P = c(() => {
+		let e = /* @__PURE__ */ new Map();
+		for (let t of N.read?.files ?? []) {
+			let n = t.upload && t.editor_url ? p(t.path) : void 0;
+			n && e.set(n, t.editor_url);
+		}
+		return e;
+	}, [N.read]), F = j && !!N.read && [...A.keys()].some((e) => !D.has(e) && !P.has(e) && !N.read.files.some((t) => t.failed && p(t.path) === e)), I = l(0), { reload: L } = N;
+	s(() => {
+		if (!F) {
+			I.current = 0;
+			return;
+		}
+		if (I.current >= 6) return;
+		let e = setTimeout(() => {
+			I.current++, L();
+		}, 1e3 * 2 ** I.current);
+		return () => clearTimeout(e);
+	}, [
+		F,
+		N.read,
+		L
+	]);
+	let R = o((e) => {
+		if (!e) return;
+		let t = p(e), n = t ? D.get(t) ?? P.get(t) : void 0;
+		return n ? (k.current.set(n, e), n) : e;
+	}, [D, P]), z = c(() => S?.body.replace(m, (e) => R(e) ?? e), [S?.body, R]), B = o((e) => {
+		let t = e;
+		for (let [e, n] of k.current) t = t.split(e).join(n).split(e.replaceAll("&", "&amp;")).join(n);
+		return t;
+	}, []), V = o((e, t, n) => {
+		if (typeof URL.createObjectURL != "function") return t;
+		let r = URL.createObjectURL(n);
+		return k.current.set(r, t), O((t) => new Map(t).set(e, r)), r;
+	}, []), H = o((e) => T(async () => {
+		let t = await d.posts.create(e);
+		return v(t.id), t;
+	}), [d, T]), U = o((e) => T(() => d.posts.update(E(), e.body === void 0 ? e : {
+		...e,
+		body: B(e.body)
+	})), [
+		d,
+		T,
+		E,
+		B
+	]), W = o(() => T(() => d.posts.delete(E())), [
+		d,
+		T,
+		E
+	]), G = o(() => T(() => d.posts.restore(E())), [
+		d,
+		T,
+		E
+	]), K = o((e) => T(async () => {
+		if (!e) return d.posts.setCover(E(), null);
+		let t = await d.media.uploadNamed(d.media.postRef(E()), e), n = await d.posts.setCover(E(), t.name);
+		return n && V(t.name, n, e);
+	}), [
+		d,
+		T,
+		E,
+		V
+	]), q = o((e) => T(async () => {
+		let t = await d.media.uploadInline(E(), e);
+		return V(t.name, t.url, e);
+	}), [
+		d,
+		T,
+		E,
+		V
+	]);
+	return {
+		post: S,
+		loading: !!b && (x.loading || !x.loaded && i.initial === void 0),
+		error: x.error,
+		saving: C > 0,
+		create: H,
+		update: U,
+		remove: W,
+		restore: G,
+		setCover: K,
+		uploadImage: q,
+		imageSrc: R,
+		editorBody: z,
+		storedBody: B
+	};
+}
+//#endregion
+export { h as isPublished, g as usePost, d as usePosts };
+
+//# sourceMappingURL=posts.js.map

package/dist/react/posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.js","names":[],"sources":["../../src/react/posts.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { Sort } from \"../client/content/types.js\";\nimport type { Post, PostInput } from \"../client/generated/wire.js\";\nimport { useMediaRead } from \"./read.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\nexport interface PostFilter {\n  language?: string;\n  sort?: Sort;\n  /** Staff: every post, drafts and scheduled ones included (PostWrite). */\n  admin?: boolean;\n  /** With admin: true only drafts, false no drafts. */\n  draft?: boolean;\n  /** With admin: the deleted posts instead of the live ones. */\n  deleted?: boolean;\n  /** With admin: only posts whose title, excerpt or body contains this text. */\n  q?: string;\n  pageSize?: number;\n}\n\n/** Posts, a page at a time: the published ones, or every one for staff. */\nexport function usePosts(f: PostFilter = {}, o: { client?: ContentKitClient } = {}): UseList<Post> {\n  const { client, store, viewer } = useContentScope(o.client);\n  const size = f.pageSize ?? 20;\n  return useList(\n    store,\n    keyOf(\"posts\", viewer, !!f.admin, f.language, f.sort, f.draft, f.deleted, f.q, size),\n    { type: \"posts\", scope: f.admin && f.deleted ? \"deleted\" : undefined },\n    offsetPages(size, (q, signal) =>\n      f.admin\n        ? client.posts.adminList({ ...q, language: f.language, draft: f.draft, deleted: f.deleted, q: f.q }, signal)\n        : client.posts.list({ ...q, language: f.language, sort: f.sort }, signal),\n    ),\n  );\n}\n\nexport interface UsePost {\n  /** null before create (or while loading). */\n  post: Post | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Writes in flight. */\n  saving: boolean;\n  /** Creates the post; the hook then edits it. */\n  create: (input: PostInput) => Promise<Post>;\n  /** Updates the given fields; a body from the editor is stored with its images' public URLs (storedBody). */\n  update: (patch: PostInput) => Promise<Post>;\n  remove: () => Promise<void>;\n  /** Restores the deleted post (PostWrite). */\n  restore: () => Promise<Post>;\n  /** Uploads the cover (null clears it); resolves with a URL that shows it now. */\n  setCover: (file: Blob | null) => Promise<string | null>;\n  /** Uploads an image for the body; resolves with a URL that shows it now, to place in the editor. */\n  uploadImage: (file: Blob) => Promise<string>;\n  /**\n   * A URL that shows one of the post's images now (the cover, a body image):\n   * an unpublished post's images are not public yet, so its editors see them\n   * through signed URLs of an editor read; a fresh upload shows from the\n   * file itself. Any other URL is returned as is.\n   */\n  imageSrc: (url: string | null | undefined) => string | undefined;\n  /** post.body with its images through imageSrc: what a rich-text editor shows. */\n  editorBody: string | undefined;\n  /** HTML from the editor with the URLs imageSrc gave back to the images' public URLs. */\n  storedBody: (html: string) => string;\n}\n\nconst NAME = \"i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\";\nconst nameIn = (url: string) => url.match(new RegExp(NAME))?.[0];\n// An image URL in HTML: everything around a name up to a quote, a space or a bracket.\nconst imageURLs = new RegExp(`[^\\\\s\"'()<>]*${NAME}[^\\\\s\"'()<>]*`, \"g\");\n\n/** Whether readers see the post, and so its images' public files exist. */\nexport function isPublished(post: Post, now = Date.now()): boolean {\n  return !post.is_draft && !post.moderation && (!post.live_at || Date.parse(post.live_at) <= now);\n}\n\n/** One post: read, and for staff (PostWrite) create, update, delete, restore, cover and body images. null creates a new post. */\nexport function usePost(id: string | null | undefined, o: { initial?: Post; client?: ContentKitClient } = {}): UsePost {\n  const { client, store, viewer } = useContentScope(o.client);\n  const [created, setCreated] = useState<string | null>(null);\n  const pid = id ?? created;\n  const key = pid ? keyOf(\"post\", viewer, pid) : null;\n  const r = useResource<Post | null>(store, key, { type: \"post\", id: pid ?? undefined }, (s) => client.posts.get(pid!, s), { initial: o.initial });\n  const post = r.data ?? null;\n  const [inflight, setInflight] = useState(0);\n  const run = useCallback(async <T>(fn: () => Promise<T>): Promise<T> => {\n    setInflight((n) => n + 1);\n    try {\n      return await fn();\n    } finally {\n      setInflight((n) => n - 1);\n    }\n  }, []);\n  const need = useCallback(() => {\n    if (!pid) throw new Error(\"contentkit-ui: create the post first\");\n    return pid;\n  }, [pid]);\n\n  // Images: fresh uploads show from their file; an unpublished post's from an editor read.\n  const [previews, setPreviews] = useState<ReadonlyMap<string, string>>(new Map());\n  const given = useRef(new Map<string, string>()); // each URL imageSrc gave -> the image's public URL\n  useEffect(() => {\n    const urls = given.current;\n    return () => {\n      for (const u of urls.keys()) if (u.startsWith(\"blob:\")) URL.revokeObjectURL(u);\n    };\n  }, []);\n  const names = useMemo(() => {\n    const out = new Map<string, string>();\n    for (const u of [...(post?.body.match(imageURLs) ?? []), post?.cover_url ?? \"\"]) {\n      const n = nameIn(u);\n      if (n && !out.has(n)) out.set(n, u);\n    }\n    return out;\n  }, [post?.body, post?.cover_url]);\n  const unread = !!post && !isPublished(post) && [...names.keys()].some((n) => !previews.has(n));\n  const folder = useMemo(() => client.media.postRef(pid ?? \"none\"), [client, pid]);\n  const read = useMediaRead(folder, { editor: true, read: unread ? undefined : null, client });\n  const views = useMemo(() => {\n    const out = new Map<string, string>();\n    for (const f of read.read?.files ?? []) {\n      const n = f.upload && f.editor_url ? nameIn(f.path) : undefined;\n      if (n) out.set(n, f.editor_url!);\n    }\n    return out;\n  }, [read.read]);\n  // Editor views render on the first editor read that misses them: read again, backing off.\n  const missing = unread && !!read.read && [...names.keys()].some((n) => !previews.has(n) && !views.has(n) && !read.read!.files.some((f) => f.failed && nameIn(f.path) === n));\n  const tries = useRef(0);\n  const { reload } = read;\n  useEffect(() => {\n    if (!missing) {\n      tries.current = 0;\n      return;\n    }\n    if (tries.current >= 6) return;\n    const t = setTimeout(() => {\n      tries.current++;\n      reload();\n    }, 1000 * 2 ** tries.current);\n    return () => clearTimeout(t);\n  }, [missing, read.read, reload]);\n\n  const imageSrc = useCallback(\n    (url: string | null | undefined) => {\n      if (!url) return undefined;\n      const n = nameIn(url);\n      const shown = n ? (previews.get(n) ?? views.get(n)) : undefined;\n      if (!shown) return url;\n      given.current.set(shown, url);\n      return shown;\n    },\n    [previews, views],\n  );\n  const editorBody = useMemo(() => post?.body.replace(imageURLs, (u) => imageSrc(u) ?? u), [post?.body, imageSrc]);\n  const storedBody = useCallback((html: string) => {\n    let out = html;\n    for (const [shown, url] of given.current) out = out.split(shown).join(url).split(shown.replaceAll(\"&\", \"&amp;\")).join(url);\n    return out;\n  }, []);\n  const preview = useCallback((name: string, url: string, file: Blob) => {\n    if (typeof URL.createObjectURL !== \"function\") return url;\n    const shown = URL.createObjectURL(file);\n    given.current.set(shown, url);\n    setPreviews((m) => new Map(m).set(name, shown));\n    return shown;\n  }, []);\n\n  const create = useCallback(\n    (input: PostInput) =>\n      run(async () => {\n        const post = await client.posts.create(input);\n        setCreated(post.id);\n        return post;\n      }),\n    [client, run],\n  );\n  const update = useCallback(\n    (patch: PostInput) => run(() => client.posts.update(need(), patch.body === undefined ? patch : { ...patch, body: storedBody(patch.body) })),\n    [client, run, need, storedBody],\n  );\n  const remove = useCallback(() => run(() => client.posts.delete(need())), [client, run, need]);\n  const restore = useCallback(() => run(() => client.posts.restore(need())), [client, run, need]);\n  const setCover = useCallback(\n    (file: Blob | null) =>\n      run(async () => {\n        if (!file) return client.posts.setCover(need(), null);\n        const up = await client.media.uploadNamed(client.media.postRef(need()), file);\n        const url = await client.posts.setCover(need(), up.name);\n        return url && preview(up.name, url, file);\n      }),\n    [client, run, need, preview],\n  );\n  const uploadImage = useCallback(\n    (file: Blob) =>\n      run(async () => {\n        const up = await client.media.uploadInline(need(), file);\n        return preview(up.name, up.url, file);\n      }),\n    [client, run, need, preview],\n  );\n  return {\n    post,\n    loading: !!key && (r.loading || (!r.loaded && o.initial === undefined)),\n    error: r.error,\n    saving: inflight > 0,\n    create,\n    update,\n    remove,\n    restore,\n    setCover,\n    uploadImage,\n    imageSrc,\n    editorBody,\n    storedBody,\n  };\n}\n"],"mappings":";;;;AAuBA,SAAgB,EAAS,IAAgB,CAAC,GAAG,IAAmC,CAAC,GAAkB;CACjG,IAAM,EAAE,WAAQ,UAAO,cAAW,EAAgB,EAAE,MAAM,GACpD,IAAO,EAAE,YAAY;CAC3B,OAAO,EACL,GACA,EAAM,SAAS,GAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAI,GACnF;EAAE,MAAM;EAAS,OAAO,EAAE,SAAS,EAAE,UAAU,YAAY,KAAA;CAAU,GACrE,EAAY,IAAO,GAAG,MACpB,EAAE,QACE,EAAO,MAAM,UAAU;EAAE,GAAG;EAAG,UAAU,EAAE;EAAU,OAAO,EAAE;EAAO,SAAS,EAAE;EAAS,GAAG,EAAE;CAAE,GAAG,CAAM,IACzG,EAAO,MAAM,KAAK;EAAE,GAAG;EAAG,UAAU,EAAE;EAAU,MAAM,EAAE;CAAK,GAAG,CAAM,CAC5E,CACF;AACF;AAiCA,IAAM,IAAO,kEACP,KAAU,MAAgB,EAAI,MAAM,IAAI,OAAO,CAAI,CAAC,CAAC,GAAG,IAExD,IAAgB,OAAO,gBAAgB,EAAK,gBAAgB,GAAG;AAGrE,SAAgB,EAAY,GAAY,IAAM,KAAK,IAAI,GAAY;CACjE,OAAO,CAAC,EAAK,YAAY,CAAC,EAAK,eAAe,CAAC,EAAK,WAAW,KAAK,MAAM,EAAK,OAAO,KAAK;AAC7F;AAGA,SAAgB,EAAQ,GAA+B,IAAmD,CAAC,GAAY;CACrH,IAAM,EAAE,WAAQ,UAAO,cAAW,EAAgB,EAAE,MAAM,GACpD,CAAC,GAAS,KAAc,EAAwB,IAAI,GACpD,IAAM,KAAM,GACZ,IAAM,IAAM,EAAM,QAAQ,GAAQ,CAAG,IAAI,MACzC,IAAI,EAAyB,GAAO,GAAK;EAAE,MAAM;EAAQ,IAAI,KAAO,KAAA;CAAU,IAAI,MAAM,EAAO,MAAM,IAAI,GAAM,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,GACzI,IAAO,EAAE,QAAQ,MACjB,CAAC,GAAU,KAAe,EAAS,CAAC,GACpC,IAAM,EAAY,OAAU,MAAqC;EACrE,GAAa,MAAM,IAAI,CAAC;EACxB,IAAI;GACF,OAAO,MAAM,EAAG;EAClB,UAAU;GACR,GAAa,MAAM,IAAI,CAAC;EAC1B;CACF,GAAG,CAAC,CAAC,GACC,IAAO,QAAkB;EAC7B,IAAI,CAAC,GAAK,MAAU,MAAM,sCAAsC;EAChE,OAAO;CACT,GAAG,CAAC,CAAG,CAAC,GAGF,CAAC,GAAU,KAAe,kBAAsC,IAAI,IAAI,CAAC,GACzE,IAAQ,kBAAO,IAAI,IAAoB,CAAC;CAC9C,QAAgB;EACd,IAAM,IAAO,EAAM;EACnB,aAAa;GACX,KAAK,IAAM,KAAK,EAAK,KAAK,GAAG,AAAI,EAAE,WAAW,OAAO,KAAG,IAAI,gBAAgB,CAAC;EAC/E;CACF,GAAG,CAAC,CAAC;CACL,IAAM,IAAQ,QAAc;EAC1B,IAAM,oBAAM,IAAI,IAAoB;EACpC,KAAK,IAAM,KAAK,CAAC,GAAI,GAAM,KAAK,MAAM,CAAS,KAAK,CAAC,GAAI,GAAM,aAAa,EAAE,GAAG;GAC/E,IAAM,IAAI,EAAO,CAAC;GAClB,AAAI,KAAK,CAAC,EAAI,IAAI,CAAC,KAAG,EAAI,IAAI,GAAG,CAAC;EACpC;EACA,OAAO;CACT,GAAG,CAAC,GAAM,MAAM,GAAM,SAAS,CAAC,GAC1B,IAAS,CAAC,CAAC,KAAQ,CAAC,EAAY,CAAI,KAAK,CAAC,GAAG,EAAM,KAAK,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,EAAS,IAAI,CAAC,CAAC,GACvF,IAAS,QAAc,EAAO,MAAM,QAAQ,KAAO,MAAM,GAAG,CAAC,GAAQ,CAAG,CAAC,GACzE,IAAO,EAAa,GAAQ;EAAE,QAAQ;EAAM,MAAM,IAAS,KAAA,IAAY;EAAM;CAAO,CAAC,GACrF,IAAQ,QAAc;EAC1B,IAAM,oBAAM,IAAI,IAAoB;EACpC,KAAK,IAAM,KAAK,EAAK,MAAM,SAAS,CAAC,GAAG;GACtC,IAAM,IAAI,EAAE,UAAU,EAAE,aAAa,EAAO,EAAE,IAAI,IAAI,KAAA;GACtD,AAAI,KAAG,EAAI,IAAI,GAAG,EAAE,UAAW;EACjC;EACA,OAAO;CACT,GAAG,CAAC,EAAK,IAAI,CAAC,GAER,IAAU,KAAU,CAAC,CAAC,EAAK,QAAQ,CAAC,GAAG,EAAM,KAAK,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,EAAS,IAAI,CAAC,KAAK,CAAC,EAAM,IAAI,CAAC,KAAK,CAAC,EAAK,KAAM,MAAM,MAAM,MAAM,EAAE,UAAU,EAAO,EAAE,IAAI,MAAM,CAAC,CAAC,GACrK,IAAQ,EAAO,CAAC,GAChB,EAAE,cAAW;CACnB,QAAgB;EACd,IAAI,CAAC,GAAS;GACZ,EAAM,UAAU;GAChB;EACF;EACA,IAAI,EAAM,WAAW,GAAG;EACxB,IAAM,IAAI,iBAAiB;GAEzB,AADA,EAAM,WACN,EAAO;EACT,GAAG,MAAO,KAAK,EAAM,OAAO;EAC5B,aAAa,aAAa,CAAC;CAC7B,GAAG;EAAC;EAAS,EAAK;EAAM;CAAM,CAAC;CAE/B,IAAM,IAAW,GACd,MAAmC;EAClC,IAAI,CAAC,GAAK;EACV,IAAM,IAAI,EAAO,CAAG,GACd,IAAQ,IAAK,EAAS,IAAI,CAAC,KAAK,EAAM,IAAI,CAAC,IAAK,KAAA;EAGtD,OAFK,KACL,EAAM,QAAQ,IAAI,GAAO,CAAG,GACrB,KAFY;CAGrB,GACA,CAAC,GAAU,CAAK,CAClB,GACM,IAAa,QAAc,GAAM,KAAK,QAAQ,IAAY,MAAM,EAAS,CAAC,KAAK,CAAC,GAAG,CAAC,GAAM,MAAM,CAAQ,CAAC,GACzG,IAAa,GAAa,MAAiB;EAC/C,IAAI,IAAM;EACV,KAAK,IAAM,CAAC,GAAO,MAAQ,EAAM,SAAS,IAAM,EAAI,MAAM,CAAK,CAAC,CAAC,KAAK,CAAG,CAAC,CAAC,MAAM,EAAM,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAG;EACzH,OAAO;CACT,GAAG,CAAC,CAAC,GACC,IAAU,GAAa,GAAc,GAAa,MAAe;EACrE,IAAI,OAAO,IAAI,mBAAoB,YAAY,OAAO;EACtD,IAAM,IAAQ,IAAI,gBAAgB,CAAI;EAGtC,OAFA,EAAM,QAAQ,IAAI,GAAO,CAAG,GAC5B,GAAa,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,GAAM,CAAK,CAAC,GACvC;CACT,GAAG,CAAC,CAAC,GAEC,IAAS,GACZ,MACC,EAAI,YAAY;EACd,IAAM,IAAO,MAAM,EAAO,MAAM,OAAO,CAAK;EAE5C,OADA,EAAW,EAAK,EAAE,GACX;CACT,CAAC,GACH,CAAC,GAAQ,CAAG,CACd,GACM,IAAS,GACZ,MAAqB,QAAU,EAAO,MAAM,OAAO,EAAK,GAAG,EAAM,SAAS,KAAA,IAAY,IAAQ;EAAE,GAAG;EAAO,MAAM,EAAW,EAAM,IAAI;CAAE,CAAC,CAAC,GAC1I;EAAC;EAAQ;EAAK;EAAM;CAAU,CAChC,GACM,IAAS,QAAkB,QAAU,EAAO,MAAM,OAAO,EAAK,CAAC,CAAC,GAAG;EAAC;EAAQ;EAAK;CAAI,CAAC,GACtF,IAAU,QAAkB,QAAU,EAAO,MAAM,QAAQ,EAAK,CAAC,CAAC,GAAG;EAAC;EAAQ;EAAK;CAAI,CAAC,GACxF,IAAW,GACd,MACC,EAAI,YAAY;EACd,IAAI,CAAC,GAAM,OAAO,EAAO,MAAM,SAAS,EAAK,GAAG,IAAI;EACpD,IAAM,IAAK,MAAM,EAAO,MAAM,YAAY,EAAO,MAAM,QAAQ,EAAK,CAAC,GAAG,CAAI,GACtE,IAAM,MAAM,EAAO,MAAM,SAAS,EAAK,GAAG,EAAG,IAAI;EACvD,OAAO,KAAO,EAAQ,EAAG,MAAM,GAAK,CAAI;CAC1C,CAAC,GACH;EAAC;EAAQ;EAAK;EAAM;CAAO,CAC7B,GACM,IAAc,GACjB,MACC,EAAI,YAAY;EACd,IAAM,IAAK,MAAM,EAAO,MAAM,aAAa,EAAK,GAAG,CAAI;EACvD,OAAO,EAAQ,EAAG,MAAM,EAAG,KAAK,CAAI;CACtC,CAAC,GACH;EAAC;EAAQ;EAAK;EAAM;CAAO,CAC7B;CACA,OAAO;EACL;EACA,SAAS,CAAC,CAAC,MAAQ,EAAE,WAAY,CAAC,EAAE,UAAU,EAAE,YAAY,KAAA;EAC5D,OAAO,EAAE;EACT,QAAQ,IAAW;EACnB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/react/provider.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitChange } from '../client/http.js';
+import { ContentURLs } from '../urls/index.js';
+import { ContentKitErrorHandler, Navigate } from './context.js';
+export interface ContentKitProviderProps {
+    client: ContentKitClient;
+    /** The signed-in user's id as ContentKit sees it (the actor id), or null when signed out. */
+    viewer?: string | null;
+    /** Asks the visitor to sign in: comments, reactions, favorites and votes prompt with it rather than act anonymously. */
+    onSignIn?: () => void;
+    /** Content URL helpers (createContentURLs from `/urls`). */
+    urls?: ContentURLs;
+    /** Host router for in-app navigation (a canonical replace). */
+    navigate?: Navigate;
+    /** Fires after each successful mutation: the host's cache-invalidation hook. */
+    onChange?: (change: ContentKitChange) => void;
+    /** Receives every failure the components show (a component's own `onError` wins). */
+    onError?: ContentKitErrorHandler;
+    children?: ReactNode;
+}
+/** Client, URL config, callbacks and the shared read store for every hook below. Renders no DOM. */
+export declare function ContentKitProvider({ client, viewer, onSignIn, urls, navigate, onChange, onError, children }: ContentKitProviderProps): import('react').JSX.Element;

package/dist/react/provider.js

@@ -0,0 +1,35 @@
+import { ContentKitContext as e } from "./context.js";
+import { storeFor as t } from "./store.js";
+import { useEffect as n, useMemo as r, useRef as i } from "react";
+import { jsx as a } from "react/jsx-runtime";
+//#region src/react/provider.tsx
+function o({ client: o, viewer: s, onSignIn: c, urls: l, navigate: u, onChange: d, onError: f, children: p }) {
+	let m = i(d);
+	n(() => {
+		m.current = d;
+	}), n(() => o.subscribe((e) => m.current?.(e)), [o]);
+	let h = r(() => ({
+		client: o,
+		viewer: s,
+		onSignIn: c,
+		urls: l,
+		navigate: u,
+		onError: f,
+		store: t(o)
+	}), [
+		o,
+		s,
+		c,
+		l,
+		u,
+		f
+	]);
+	return /* @__PURE__ */ a(e.Provider, {
+		value: h,
+		children: p
+	});
+}
+//#endregion
+export { o as ContentKitProvider };
+
+//# sourceMappingURL=provider.js.map

package/dist/react/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","names":[],"sources":["../../src/react/provider.tsx"],"sourcesContent":["import { useEffect, useMemo, useRef, type ReactNode } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitChange } from \"../client/http.js\";\nimport type { ContentURLs } from \"../urls/index.js\";\nimport { ContentKitContext, type ContentKitErrorHandler, type Navigate } from \"./context.js\";\nimport { storeFor } from \"./store.js\";\n\nexport interface ContentKitProviderProps {\n  client: ContentKitClient;\n  /** The signed-in user's id as ContentKit sees it (the actor id), or null when signed out. */\n  viewer?: string | null;\n  /** Asks the visitor to sign in: comments, reactions, favorites and votes prompt with it rather than act anonymously. */\n  onSignIn?: () => void;\n  /** Content URL helpers (createContentURLs from `/urls`). */\n  urls?: ContentURLs;\n  /** Host router for in-app navigation (a canonical replace). */\n  navigate?: Navigate;\n  /** Fires after each successful mutation: the host's cache-invalidation hook. */\n  onChange?: (change: ContentKitChange) => void;\n  /** Receives every failure the components show (a component's own `onError` wins). */\n  onError?: ContentKitErrorHandler;\n  children?: ReactNode;\n}\n\n/** Client, URL config, callbacks and the shared read store for every hook below. Renders no DOM. */\nexport function ContentKitProvider({ client, viewer, onSignIn, urls, navigate, onChange, onError, children }: ContentKitProviderProps) {\n  const changed = useRef(onChange);\n  useEffect(() => {\n    changed.current = onChange;\n  });\n  useEffect(() => client.subscribe((c) => changed.current?.(c)), [client]);\n  const value = useMemo(() => ({ client, viewer, onSignIn, urls, navigate, onError, store: storeFor(client) }), [client, viewer, onSignIn, urls, navigate, onError]);\n  return <ContentKitContext.Provider value={value}>{children}</ContentKitContext.Provider>;\n}\n"],"mappings":";;;;;AAyBA,SAAgB,EAAmB,EAAE,WAAQ,WAAQ,aAAU,SAAM,aAAU,aAAU,YAAS,eAAqC;CACrI,IAAM,IAAU,EAAO,CAAQ;CAI/B,AAHA,QAAgB;EACd,EAAQ,UAAU;CACpB,CAAC,GACD,QAAgB,EAAO,WAAW,MAAM,EAAQ,UAAU,CAAC,CAAC,GAAG,CAAC,CAAM,CAAC;CACvE,IAAM,IAAQ,SAAe;EAAE;EAAQ;EAAQ;EAAU;EAAM;EAAU;EAAS,OAAO,EAAS,CAAM;CAAE,IAAI;EAAC;EAAQ;EAAQ;EAAU;EAAM;EAAU;CAAO,CAAC;CACjK,OAAO,kBAAC,EAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AACzF"}

package/dist/react/public.d.ts

@@ -0,0 +1,39 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { ReadResult, PresetRule } from '../client/generated/wire.js';
+import { PublicPreset } from '../client/public.js';
+export interface UsePresets {
+    /** Every kind's public presets; empty until they load (or when the server has none). */
+    presets: PresetRule[];
+    loaded: boolean;
+    error?: ContentKitError;
+}
+/** The public presets (`GET /media/presets`), fetched once per client. */
+export declare function usePresets(o?: {
+    client?: ContentKitClient | null;
+}): UsePresets;
+export interface PublicImageOptions {
+    /** The host's listing of the item's image (its API's): shown without a read. */
+    image?: PublicPreset | null;
+    /** A read of the item the host already has. */
+    read?: ReadResult | null;
+    /** Overrides the provider's client. */
+    client?: ContentKitClient | null;
+}
+export interface UsePublicImage {
+    /** The item's current renditions; the kind's default image when it has none; null while unknown. */
+    image: PublicPreset | null;
+    /** The preset's rules (aspect, widths, min_width) once the presets load. */
+    rule?: PresetRule;
+    /** image is the kind's default, not the item's own. */
+    isDefault: boolean;
+    loading: boolean;
+    error?: ContentKitError;
+    reload: () => void;
+}
+/**
+ * An item's public image for a preset ("avatar", "cover"): the exact
+ * renditions from a read's `public` (or the host's listing), else the kind's
+ * default image. Reads refresh after commits through the same client.
+ */
+export declare function usePublicImage(kind: string, id: string, preset: string, o?: PublicImageOptions): UsePublicImage;