@openrails/contentkit-ui 0.79.0 → 0.81.0

package/README.md

@@ -15,7 +15,7 @@ pnpm add @openrails/contentkit-ui@X.Y.Z
 | `@openrails/contentkit-ui/react` | `ContentKitProvider` and every hook | `react` |
 | `@openrails/contentkit-ui/client` | `createContentKitClient`, `ContentKitError`, generated wire types, crop/aspect/rendition/ABR/gallery math | nothing |
 | `@openrails/contentkit-ui/urls` | content codes, `[/{lang}]/{route}/{CODE}[/{slug}]` paths, `canonical` | nothing |
-| `@openrails/contentkit-ui/editor` | `RichTextEditor`, `richTextEditor` (PostManager's body editor) | the optional peers `@tiptap/core`, `@tiptap/pm`, `@tiptap/react`, `@tiptap/starter-kit`, `@tiptap/extension-image`, `@tiptap/extensions` (3.31+) |
+| `@openrails/contentkit-ui/editor` | `RichTextEditor`, `richTextEditor` (ContentManager's body editor) | the optional peers `@tiptap/core`, `@tiptap/pm`, `@tiptap/react`, `@tiptap/starter-kit`, `@tiptap/extension-image`, `@tiptap/extensions` (3.31+) |
 | `@openrails/contentkit-ui/locales/{de,es,ja,ko,zh}` | message bundles (English is built in) | |
 | `@openrails/contentkit-ui/styles.css` | the stylesheet, scoped under `.ckui` (the root entry also installs it) | |
 
@@ -31,7 +31,7 @@ import { ContentKitUiProvider } from "@openrails/contentkit-ui";
 import { createContentURLs } from "@openrails/contentkit-ui/urls";
 
 const contentkit = createContentKitClient({
-  baseUrl: "/api/v1/contentkit",            // where the host mounts ContentKit
+  baseUrl: "/api/contentkit",               // the host's contentkit.Routes.Prefix
   mounts: { upload: "/api/v1/user-uploads" }, // optional: modules mounted elsewhere (a string, or (ref) => string)
   fetch: auth.authFetch,                    // an authenticating transport
   token: () => auth.getAccessToken(),       // HLS playlists on the API origin (hls.js uses XHR)
@@ -72,8 +72,9 @@ The framework-free client exposes `setReadScope(key)` and passes that key as
 the second `subscribe` / `onChange` argument, or `null` when the scope changed during the
 operation. This does not change the operation's result or its authentication.
 
-- **Mounts.** Without `mounts`, modules live under `baseUrl`: content at the
-  root, `/media` (reads, HLS), `/media/upload`, `/codes`, `/taxonomy`.
+- **Mounts.** Without `mounts`, modules live under `{baseUrl}/v1`: content,
+  groups and the content model at its root, `/media` (reads, HLS),
+  `/media/upload`, `/codes`. A mount is a module's full base URL.
 - **`client.media`**: `upload`, `put` (upload, commit, wait), `commit`, `read`,
   `waitFor`, `editorView`, `getFrame`, `hlsBase(ref, dir)`, `discard`, and
   `xhrSetup` for players (`<MediaGallery xhrSetup={contentkit.media.xhrSetup} />`).
@@ -81,23 +82,25 @@ operation. This does not change the operation's result or its authentication.
   resumable multipart above (`onState`/`resume`). The bucket must allow CORS
   `PUT` from the app's origin with `Content-Type` and `x-amz-checksum-sha256`.
 - **Content modules**, one per resource, each method one route of the
-  generated route table with its generated types: `posts`, `comments`,
+  generated route table with its generated types: `contents`, `catalog`, `comments`,
   `reactions`, `favorites`, `polls`, `bans` (`"owner"` or `"global"`; `get("global", user)`),
-  `moderation`, `taxonomy`, `codes`. Lists take `limit`/`offset` (the review
-  queue a `cursor`); staff lists are `posts.adminList` (`q` searches,
-  `deleted: true` lists deleted posts for `posts.restore`), `polls.adminList` (`state`, `q`),
-  `comments.adminList` (`contentKind`, `author`); `taxonomy.nodeAssignments(id)`
-  pages a node's contents.
-- **Images of posts and polls** go to the item's server-named upload path:
-  `media.uploadNamed(ref, file)` resolves the name content routes take;
-  `media.uploadInline(postId, file)` resolves a body image's reference
-  (`ref`, `contentkit:i-{uuid}`, what the body stores: `imageRef(name)`) and
-  a URL that shows it now; `posts.uploadCover`, `polls.uploadImage` and
+  `moderation`, `groups`, `codes`. Lists take `limit`/`offset` (the review
+  queue and group listings a `cursor`); `contents.manage` lists what the caller
+  manages (`kind`, `state` incl. `deleted` for `contents.restore`, `q`); `catalog.totals({kinds, languages})`
+  counts what is open; staff lists are `polls.adminList` (`state`, `q`),
+  `comments.adminList` (`contentKind`, `author`); `groups.members(id)` pages
+  a group's memberships, `groups.ofContent(id)` / `setOfContent` a content's,
+  `groups.uploadCover(group, file)` its cover; `client.kinds()` the content model.
+- **Images of content and polls** go to the item's server-named upload path:
+  `media.uploadNamed(ref, file)` resolves the name content routes take
+  (`contents.setCover`); `media.uploadInline({kind, id}, file)` resolves a
+  body image's reference (`ref`, `contentkit:i-{uuid}`, what the body stores:
+  `imageRef(name)`) and a URL that shows it now; `polls.uploadImage` and
   `polls.uploadOptionImage` do both steps. Reads resolve references: a
-  post's `body` shows the images' current public files and `images` maps
-  each name to its URL. `folders` renames the post and poll media kinds. A
-  post's public image files exist only while it is published; `usePost`
-  shows an unpublished post's images to its editors (below).
+  content's `body` shows the images' current public files and `images` maps
+  each name to its URL. `folders` renames the poll media kind. Public image
+  files exist only while the item is live; `useContent` shows an unpublished
+  item's images to its editors (below).
 - **`client.config()`** says what the content module allows: which
   interactions signed-out visitors may make (`content.Options.Anonymous`,
   none by default) and the longest comment (`CommentMaxLength`, 2,200 by
@@ -145,23 +148,23 @@ const { poll, vote } = usePoll(null, { language }); // the newest live poll
 const editor = usePollEditor(pollId);                // staff
 ```
 
-A post editor puts `editorBody` in its rich-text field and inserts what
+A content editor puts `text.body` in its rich-text field and inserts what
 `uploadImage(file)` resolves: URLs that show the images now (the file for a
-fresh upload, public files, signed editor views of an unpublished post's
-images, read and refreshed as needed). `update({ body })` stores each of
-those URLs as the image's reference (`storedBody(html)` does the same for a
-host's own save); `coverSrc` shows the cover, `imageSrc(name)` any image.
+fresh upload, public files, signed editor views of an unpublished item's
+images, read and refreshed as needed). `putText({ title, body })` stores each
+of those URLs as the image's reference (`storedBody(html)` does the same for
+a host's own save); `coverSrc` shows the cover, `imageSrc(name)` any image.
 
 ```tsx
-const editor = usePost(postId);
-<RichText value={editor.editorBody} onImage={editor.uploadImage} onSave={(html) => editor.update({ body: html })} />
+const editor = useContent(id, "blog", "en");
+<RichText value={editor.text?.body} onImage={editor.uploadImage} onSave={(html) => editor.putText({ title, body: html })} />
 <img src={editor.coverSrc} alt="" />
 ```
 
 Also `useContentConfig` (`client.config()`, read once), `useCommentReplies`,
 `useCanComment` (may the caller comment, may signed-out visitors, the ban
 that stops it, and what it may do to others' comments), `useLatestComments`,
-`usePolls`, `usePosts` (staff: `admin`, `deleted`, `q`), `usePost` (with `restore`), and for staff `useAdminComments`
+`usePolls`, `useManagedContents` (`kind`, `state`, `q`), `useContent` (with `publish`, `restore`), and for staff `useAdminComments`
 (`contentKind`, `author`), `useModerationQueue`, `useCommentBans`, `useGlobalCommentBan` (one user's), and
 `useStaffAccess`, `useAdminLocation`, `useFlowClient` and `usePaged`, which the admin flows are built from.
 
@@ -226,7 +229,7 @@ op. Nothing is uploaded.
 ### usePublicImage
 
 ```tsx
-const { image, rule, isDefault } = usePublicImage("user", userId, "avatar");
+const { image, rule, isDefault } = usePublicImage({ kind: "user", id: userId }, "avatar");
 <SlotImage image={image} fallback={<Initials name={name} />} />
 ```
 
@@ -415,6 +418,37 @@ Staff building blocks: `CommentBans` (paged) with `CommentBanDialog`, and
 <Poll language={lang} />
 ```
 
+## Groups
+
+Tags, artists, series, characters, channels and rails: the kinds the site's
+content model declares. `useKinds()` reads it (`GET /v1/kinds`); until that
+route is served, pass the host's model as `initial` (and `kinds` to the
+components below).
+
+```tsx
+const { items, hasMore, loadMore } = useGroups({ kind: "artist", letter: "a", sort: "count" }); // parent, scope, contentKind, language
+const g = useGroup(id);           // g.group: names, text, attributes, parent, scope, children, edges, counts
+await g.update({ attributes: { artist_type: "circle" } }); // staff: create, names, edges, merge, remove, restore
+await g.uploadCover(file);         // into the group kind's folder (cover/{name}), then selected
+const members = useGroupMembers(id);       // add, remove, reorder
+const content = useContentGroups(contentId); // content.set(memberships, kinds)
+```
+
+- **`GroupDirectory`**: one kind's groups with A–Z buckets (`letter` and
+  `onLetterChange` to keep it in the URL), content counts, `layout` list or
+  grid, paged. **`GroupHeader`**: a group page's cover, names, description,
+  typed attributes, parent, scope and sub-groups. Links go to each group's
+  canonical path (`href` overrides) through the provider's `navigate`.
+- **`GroupEditor`** (staff): create, or edit slug, parent, scope, declared
+  attributes, names and aliases per language, description and sort key per
+  language, cover, related groups; `GroupMergeDialog`; delete and restore.
+- **`MembershipEditor`** (staff): a content's groups per group kind, with the
+  version (`versions`), role, position and window each kind allows; one save.
+  **`GroupMembers`**: a group's members, reordered, windowed, used as cover.
+- `labels` names kinds, attributes, roles and values by identifier; others
+  show humanized. Covers render `cover.renditions`; `renderCover` stands in
+  until group reads carry them.
+
 ## Admin flows
 
 Drop-in staff screens for a host's own admin area: each makes its own reads
@@ -448,7 +482,7 @@ const nav = useMemo(() => ({ pathname: location.pathname, search: location.searc
   `userHref`, `sections`, `pageSize`. `useCommentModerationAccess()`.
 
   ```tsx
-  <CommentModeration client={contentkit} basePath="/admin/comments" navigation={nav} contentKinds={["video", "post"]} />
+  <CommentModeration client={contentkit} basePath="/admin/comments" navigation={nav} contentKinds={["video", "blog"]} />
   ```
 
 - **`PollManager`**: every poll by language, month or day, state (live,
@@ -461,39 +495,23 @@ const nav = useMemo(() => ({ pathname: location.pathname, search: location.searc
   <PollManager client={contentkit} basePath="/admin/polls" navigation={nav} languages={["en", "ja"]} />
   ```
 
-- **`PostManager`**: every post by language, draft state and text, deleted
-  ones to restore; title, slug, language, excerpt, schedule, cover and body
-  with inline images; draft or publish; the moderation state. Props:
-  `languages`, `renderEditor` (`richTextEditor` from `/editor`, or the
-  host's; a plain HTML field without it), `postHref`, `pageSize`.
-  `usePostManagerAccess()`.
+- **`ContentManager`**: the items of one `kind` the caller manages, by
+  state and text, deleted ones to restore; title, slug, description,
+  schedule, cover and body with inline images per language; publish or
+  unpublish; the moderation state. Props: `kind`, `languages`,
+  `renderEditor` (`richTextEditor` from `/editor`, or the host's; a plain
+  HTML field without it), `contentHref`, `pageSize`.
+  `useContentManagerAccess()`.
 
   ```tsx
   import { richTextEditor } from "@openrails/contentkit-ui/editor";
-  <PostManager client={contentkit} basePath="/admin/posts" navigation={nav} renderEditor={richTextEditor} />
+  <ContentManager kind="blog" client={contentkit} basePath="/admin/blog" navigation={nav} renderEditor={richTextEditor} />
   ```
 
   `RichTextEditor` (`value`, `onChange`, `uploadImage`) is Tiptap: headings,
   emphasis, lists, quotes, links and images picked, pasted or dropped. Its
   HTML keeps to that schema, so bodies stay a small, predictable subset.
 
-- **`TaxonomyManager`**: the taxonomy per kind (`kinds`: `kind`, `label`,
-  `relations` such as a character `member_of` a series, `cover` in a media
-  kind). Each kind's nodes by name, state, language, minimum count and order
-  at `basePath/{kind}`; a node at `basePath/{kind}/{id}`: slug, names and
-  aliases per language, host fields (`renderFields`), relations with a
-  typeahead (both directions), cover, counts and assigned contents
-  (`renderContent`); create, delete, restore, and merge with a typed
-  confirmation. Props: `kinds`, `languages`, `contentKind`, `renderFields`,
-  `renderContent`, `pageSize`. `useTaxonomyManagerAccess()`. Host-owned
-  fields stay in host tables.
-
-  ```tsx
-  <TaxonomyManager client={contentkit} basePath="/admin/taxonomy" navigation={nav} languages={["en", "ja"]}
-    kinds={[{ kind: "tag", label: "Tags" }, { kind: "series", label: "Series", cover: { kind: "series" } },
-      { kind: "character", label: "Characters", relations: [{ relation: "member_of", to: "series", label: "Series" }] }]} />
-  ```
-
 - **`MediaItemPanel`**: one video item for its editors: encode state and
   progress, failures with their reason, replace the source, subtitle
   sidecars (language, label, forced), the poster from a frame or an image,
@@ -518,6 +536,16 @@ const nav = useMemo(() => ({ pathname: location.pathname, search: location.searc
   The per-item queue engine behind `useUploadQueue` is `ItemUploadQueue` in
   `/client`.
 
+- **`GroupManager`**: groups per kind (tabs at `basePath/{kind}`): by
+  letter, order and language; a new group at `basePath/{kind}/new`; a group
+  at `basePath/{kind}/{id}` with `GroupEditor` and `GroupMembers`. Props:
+  `groupKinds` (default the model's site-owned ones), `kinds`, `labels`,
+  `contentKind`, `renderContent`, `pageSize`. `useGroupManagerAccess()`.
+
+  ```tsx
+  <GroupManager client={contentkit} basePath="/admin/groups" navigation={nav} labels={{ artist: "Artists" }} />
+  ```
+
 - **`UserCommentStanding`**: for a user page, the person's site-wide comment
   ban (ban, replace, lift) and their recent comments (delete, restore). Props:
   `user` (their id), `name`, `itemHref`, `pageSize`.
@@ -569,7 +597,7 @@ pnpm demo                 # the stack with seeded demo pages, until Ctrl-C
 ```
 
 The suites need Docker, Go and ffmpeg. `e2e/server` composes the real
-`contentkit.Runtime` (content, taxonomy, codes, media upload and read) with
+ContentKit's engine (content, groups, codes, media upload and read) with
 AuthKit for identity over PGroonga PostgreSQL 18, MinIO, and media-worker and
 media-gateway built from this checkout (`e2e/compose.yaml`). Each run brings
 the stack up under its own project name and takes it down; the server exits

package/dist/client/beacons.d.ts

@@ -0,0 +1,53 @@
+import { DiscoveryClient } from './discovery.js';
+import { ExposureInput } from './generated/wire.js';
+export interface BeaconOptions {
+    /** A signed-out visitor's session; default one per browser tab. */
+    session?: () => string | undefined;
+    /** How long events gather before they are sent, ms. Default 2000. */
+    delay?: number;
+}
+/** Where a click or a view came from: the list render it was shown in. */
+export interface Attribution {
+    render_id?: string;
+    surface?: string;
+    /** 1-based position in that render. */
+    position?: number;
+}
+export interface ViewSession {
+    /** Reports the view so far: pages read, seconds watched or percent scrolled; resume is where to pick up. */
+    update(o: {
+        progress?: number;
+        duration_s?: number;
+        resume?: string;
+    }): void;
+}
+export declare const eventId: () => string;
+/** A signed-out reader's session: one per browser tab, kept across reloads. */
+export declare function readerSession(): string;
+/**
+ * Batched, best-effort signals and exposures: gathered for `delay`, sent in
+ * one request each, flushed with keepalive when the page hides. A site
+ * without the signal plane (not_configured) turns them off.
+ */
+export declare class Beacons {
+    private readonly discovery;
+    private signals;
+    private exposures;
+    private timer;
+    private off;
+    private readonly session;
+    private readonly delay;
+    constructor(discovery: DiscoveryClient, o?: BeaconOptions);
+    /** A click on a listed card. */
+    click(content: string, a?: Attribution & {
+        version_id?: string;
+    }): void;
+    /** A consumption session of a content (or one version): each update a revision of one event. */
+    view(content: string, version?: string, a?: Attribution): ViewSession;
+    /** A result list served, rendered or shown. */
+    exposure(e: ExposureInput): void;
+    /** Sends what has gathered now. */
+    flush(keepalive?: boolean): Promise<void>;
+    private signal;
+    private schedule;
+}

package/dist/client/beacons.js

@@ -0,0 +1,72 @@
+import { toContentKitError as e } from "./errors.js";
+//#region src/client/beacons.ts
+var t = 100, n = "contentkit.session", r = () => typeof crypto < "u" && "randomUUID" in crypto ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`, i;
+function a() {
+	try {
+		let e = sessionStorage.getItem(n);
+		if (e) return e;
+		let t = r();
+		return sessionStorage.setItem(n, t), t;
+	} catch {
+		return i ??= r();
+	}
+}
+var o = class {
+	discovery;
+	signals = [];
+	exposures = [];
+	timer;
+	off = !1;
+	session;
+	delay;
+	constructor(e, t = {}) {
+		this.discovery = e, this.session = t.session ?? a, this.delay = t.delay ?? 2e3, typeof addEventListener == "function" && (addEventListener("pagehide", () => void this.flush(!0)), addEventListener("visibilitychange", () => {
+			typeof document < "u" && document.visibilityState === "hidden" && this.flush(!0);
+		}));
+	}
+	click(e, t = {}) {
+		this.signal({
+			content_id: e,
+			type: "click",
+			event_id: r(),
+			occurred_at: (/* @__PURE__ */ new Date()).toISOString(),
+			...t
+		});
+	}
+	view(e, t, n = {}) {
+		let i = r(), a = 0;
+		return { update: (r) => this.signal({
+			content_id: e,
+			version_id: t,
+			type: "view",
+			event_id: i,
+			revision: ++a,
+			occurred_at: (/* @__PURE__ */ new Date()).toISOString(),
+			...n,
+			...r
+		}) };
+	}
+	exposure(e) {
+		!this.off && e.shown.length && (this.exposures.push(e), this.schedule());
+	}
+	async flush(n = !1) {
+		clearTimeout(this.timer), this.timer = void 0;
+		let r = this.signals.splice(0), i = this.exposures.splice(0);
+		if (this.off) return;
+		let a = this.session(), o = [];
+		for (let e = 0; e < r.length; e += t) o.push(this.discovery.signals(r.slice(e, e + t), a, { keepalive: n }));
+		for (let e = 0; e < i.length; e += t) o.push(this.discovery.exposures(i.slice(e, e + t), a, { keepalive: n }));
+		(await Promise.allSettled(o)).some((t) => t.status === "rejected" && e(t.reason).code === "not_configured") && (this.off = !0);
+	}
+	signal(e) {
+		this.off || (e.type === "view" && (this.signals = this.signals.filter((t) => t.event_id !== e.event_id)), this.signals.push(e), this.schedule());
+	}
+	schedule() {
+		if (this.signals.length + this.exposures.length >= t) return void this.flush();
+		this.timer ??= setTimeout(() => void this.flush(), this.delay);
+	}
+};
+//#endregion
+export { o as Beacons, r as eventId, a as readerSession };
+
+//# sourceMappingURL=beacons.js.map

package/dist/client/beacons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacons.js","names":[],"sources":["../../src/client/beacons.ts"],"sourcesContent":["import type { DiscoveryClient } from \"./discovery.js\";\nimport { toContentKitError } from \"./errors.js\";\nimport type { ExposureInput, SignalInput } from \"./generated/wire.js\";\n\nexport interface BeaconOptions {\n  /** A signed-out visitor's session; default one per browser tab. */\n  session?: () => string | undefined;\n  /** How long events gather before they are sent, ms. Default 2000. */\n  delay?: number;\n}\n\n/** Where a click or a view came from: the list render it was shown in. */\nexport interface Attribution {\n  render_id?: string;\n  surface?: string;\n  /** 1-based position in that render. */\n  position?: number;\n}\n\nexport interface ViewSession {\n  /** Reports the view so far: pages read, seconds watched or percent scrolled; resume is where to pick up. */\n  update(o: { progress?: number; duration_s?: number; resume?: string }): void;\n}\n\nconst MAX = 100;\nconst SESSION_KEY = \"contentkit.session\";\nexport const eventId = () => (typeof crypto !== \"undefined\" && \"randomUUID\" in crypto ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`);\n\nlet unstored: string | undefined;\n\n/** A signed-out reader's session: one per browser tab, kept across reloads. */\nexport function readerSession(): string {\n  try {\n    const kept = sessionStorage.getItem(SESSION_KEY);\n    if (kept) return kept;\n    const made = eventId();\n    sessionStorage.setItem(SESSION_KEY, made);\n    return made;\n  } catch {\n    return (unstored ??= eventId());\n  }\n}\n\n/**\n * Batched, best-effort signals and exposures: gathered for `delay`, sent in\n * one request each, flushed with keepalive when the page hides. A site\n * without the signal plane (not_configured) turns them off.\n */\nexport class Beacons {\n  private signals: SignalInput[] = [];\n  private exposures: ExposureInput[] = [];\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private off = false;\n  private readonly session: () => string | undefined;\n  private readonly delay: number;\n\n  constructor(\n    private readonly discovery: DiscoveryClient,\n    o: BeaconOptions = {},\n  ) {\n    this.session = o.session ?? readerSession;\n    this.delay = o.delay ?? 2000;\n    if (typeof addEventListener === \"function\") {\n      addEventListener(\"pagehide\", () => void this.flush(true));\n      addEventListener(\"visibilitychange\", () => {\n        if (typeof document !== \"undefined\" && document.visibilityState === \"hidden\") void this.flush(true);\n      });\n    }\n  }\n\n  /** A click on a listed card. */\n  click(content: string, a: Attribution & { version_id?: string } = {}): void {\n    this.signal({ content_id: content, type: \"click\", event_id: eventId(), occurred_at: new Date().toISOString(), ...a });\n  }\n\n  /** A consumption session of a content (or one version): each update a revision of one event. */\n  view(content: string, version?: string, a: Attribution = {}): ViewSession {\n    const event = eventId();\n    let revision = 0;\n    return {\n      update: (o) => this.signal({ content_id: content, version_id: version, type: \"view\", event_id: event, revision: ++revision, occurred_at: new Date().toISOString(), ...a, ...o }),\n    };\n  }\n\n  /** A result list served, rendered or shown. */\n  exposure(e: ExposureInput): void {\n    if (this.off || !e.shown.length) return;\n    this.exposures.push(e);\n    this.schedule();\n  }\n\n  /** Sends what has gathered now. */\n  async flush(keepalive = false): Promise<void> {\n    clearTimeout(this.timer);\n    this.timer = undefined;\n    const signals = this.signals.splice(0);\n    const exposures = this.exposures.splice(0);\n    if (this.off) return;\n    const session = this.session();\n    const sends: Promise<void>[] = [];\n    for (let i = 0; i < signals.length; i += MAX) sends.push(this.discovery.signals(signals.slice(i, i + MAX), session, { keepalive }));\n    for (let i = 0; i < exposures.length; i += MAX) sends.push(this.discovery.exposures(exposures.slice(i, i + MAX), session, { keepalive }));\n    const done = await Promise.allSettled(sends);\n    if (done.some((r) => r.status === \"rejected\" && toContentKitError(r.reason).code === \"not_configured\")) this.off = true;\n  }\n\n  private signal(s: SignalInput): void {\n    if (this.off) return;\n    // A view's later revision replaces its earlier one still waiting.\n    if (s.type === \"view\") this.signals = this.signals.filter((x) => x.event_id !== s.event_id);\n    this.signals.push(s);\n    this.schedule();\n  }\n\n  private schedule(): void {\n    if (this.signals.length + this.exposures.length >= MAX) return void this.flush();\n    this.timer ??= setTimeout(() => void this.flush(), this.delay);\n  }\n}\n"],"mappings":"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"}

package/dist/client/catalog.d.ts

@@ -1,6 +1,6 @@
 import { Totals } from './generated/wire.js';
 import { Http } from './http.js';
-/** GET /catalog/totals filters: kinds to total (every listed kind when empty), languages to break them down by (every counted one when empty). */
+/** GET /catalog/totals filters: kinds to total (every kind when empty), languages to break them down by (every counted one when empty). */
 export interface CatalogTotalsQuery {
     kinds?: readonly string[];
     languages?: readonly string[];
@@ -9,6 +9,6 @@ export interface CatalogTotalsQuery {
 export declare class CatalogClient {
     private readonly http;
     constructor(http: Http);
-    /** Works per kind, in all and per language: how many anyone opens and how many each tier's holders open. */
+    /** Content items per kind, in all and per language: how many anyone's listing shows and opens, and how many each tier's holders open. */
     totals(q?: CatalogTotalsQuery, signal?: AbortSignal): Promise<Totals>;
 }

package/dist/client/catalog.js

@@ -6,7 +6,7 @@ var t = class {
 		this.http = e;
 	}
 	totals(t = {}, n) {
-		return e(this.http, "GET", "/totals", {
+		return e(this.http, "GET", "/catalog/totals", {
 			query: {
 				kinds: t.kinds?.join(","),
 				languages: t.languages?.join(",")

package/dist/client/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","names":[],"sources":["../../src/client/catalog.ts"],"sourcesContent":["import type { Totals } from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call } from \"./route.js\";\n\n/** GET /catalog/totals filters: kinds to total (every listed kind when empty), languages to break them down by (every counted one when empty). */\nexport interface CatalogTotalsQuery {\n  kinds?: readonly string[];\n  languages?: readonly string[];\n}\n\n/** The public catalog. */\nexport class CatalogClient {\n  constructor(private readonly http: Http) {}\n\n  /** Works per kind, in all and per language: how many anyone opens and how many each tier's holders open. */\n  totals(q: CatalogTotalsQuery = {}, signal?: AbortSignal): Promise<Totals> {\n    return call(this.http, \"GET\", \"/totals\", { query: { kinds: q.kinds?.join(\",\"), languages: q.languages?.join(\",\") }, signal });\n  }\n}\n"],"mappings":";;AAWA,IAAa,IAAb,MAA2B;CACI;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,OAAO,IAAwB,CAAC,GAAG,GAAuC;EACxE,OAAO,EAAK,KAAK,MAAM,OAAO,WAAW;GAAE,OAAO;IAAE,OAAO,EAAE,OAAO,KAAK,GAAG;IAAG,WAAW,EAAE,WAAW,KAAK,GAAG;GAAE;GAAG;EAAO,CAAC;CAC9H;AACF"}
+{"version":3,"file":"catalog.js","names":[],"sources":["../../src/client/catalog.ts"],"sourcesContent":["import type { Totals } from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call } from \"./route.js\";\n\n/** GET /catalog/totals filters: kinds to total (every kind when empty), languages to break them down by (every counted one when empty). */\nexport interface CatalogTotalsQuery {\n  kinds?: readonly string[];\n  languages?: readonly string[];\n}\n\n/** The public catalog. */\nexport class CatalogClient {\n  constructor(private readonly http: Http) {}\n\n  /** Content items per kind, in all and per language: how many anyone's listing shows and opens, and how many each tier's holders open. */\n  totals(q: CatalogTotalsQuery = {}, signal?: AbortSignal): Promise<Totals> {\n    return call(this.http, \"GET\", \"/catalog/totals\", { query: { kinds: q.kinds?.join(\",\"), languages: q.languages?.join(\",\") }, signal });\n  }\n}\n"],"mappings":";;AAWA,IAAa,IAAb,MAA2B;CACI;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,OAAO,IAAwB,CAAC,GAAG,GAAuC;EACxE,OAAO,EAAK,KAAK,MAAM,OAAO,mBAAmB;GAAE,OAAO;IAAE,OAAO,EAAE,OAAO,KAAK,GAAG;IAAG,WAAW,EAAE,WAAW,KAAK,GAAG;GAAE;GAAG;EAAO,CAAC;CACtI;AACF"}

package/dist/client/client.d.ts

@@ -1,21 +1,24 @@
 import { CatalogClient } from './catalog.js';
 import { CodesClient } from './codes.js';
+import { ContentsClient } from './contents.js';
 import { BansClient } from './content/bans.js';
 import { CommentsClient } from './content/comments.js';
 import { FavoritesClient } from './content/favorites.js';
 import { ModerationClient } from './content/moderation.js';
 import { PollsClient } from './content/polls.js';
-import { PostsClient } from './content/posts.js';
 import { ReactionsClient } from './content/reactions.js';
-import { Config, RefBody } from './generated/wire.js';
+import { Batch, Config, ContentModel, RefBody, Result } from './generated/wire.js';
+import { DiscoveryClient } from './discovery.js';
+import { GroupsClient } from './groups.js';
+import { OffersClient } from './offers.js';
+import { VersionsClient } from './versions.js';
 import { ContentKitChange, ContentKitModule, HttpOptions } from './http.js';
 import { MediaClient, ContentFolders, MediaOptions } from './media/client.js';
 import { NotificationsClient } from './notifications.js';
-import { TaxonomyClient } from './taxonomy.js';
 export interface ContentKitClientOptions extends HttpOptions {
     /** Upload tuning (transport, part concurrency, retries). */
     media?: MediaOptions;
-    /** The media kinds of post and poll folders, when the host renamed them (content.Media). */
+    /** The media kind of poll folders, when the host renamed it (content.Media). */
     folders?: ContentFolders;
 }
 /**
@@ -25,8 +28,10 @@ export interface ContentKitClientOptions extends HttpOptions {
 export interface ContentKitClient {
     /** Uploads, multipart, commits, reads, frames, HLS bases, hls.js `xhrSetup` and inline images. */
     readonly media: MediaClient;
-    /** Published posts, staff CRUD, reactions, cover and body images. */
-    readonly posts: PostsClient;
+    /** Content items: reads, and writes for their creators, owner-group editors and staff. */
+    readonly contents: ContentsClient;
+    /** The catalog's totals by kind, language and audience. */
+    readonly catalog: CatalogClient;
     /** Threads, replies, edits, tombstones, reactions, standing, the latest feed, moderation. */
     readonly comments: CommentsClient;
     /** Likes and dislikes of an item. */
@@ -37,18 +42,26 @@ export interface ContentKitClient {
     readonly polls: PollsClient;
     /** Comment bans, owner and global. */
     readonly bans: BansClient;
-    /** The review queue of held comments and posts. */
+    /** The review queue of held comments and content. */
     readonly moderation: ModerationClient;
-    /** The taxonomy admin API. */
-    readonly taxonomy: TaxonomyClient;
+    /** Groups: listings, pages, staff writes and memberships. */
+    readonly groups: GroupsClient;
+    /** Lists, search, typeahead, rails, release dates, content filters, history, signals and exposures. */
+    readonly discovery: DiscoveryClient;
+    /** Content versions: reader plans, reader metadata, forks and downloads. */
+    readonly versions: VersionsClient;
+    /** Offers on contents, versions and groups; group joins; the reader's library. */
+    readonly offers: OffersClient;
     /** Content-code lookup. */
     readonly codes: CodesClient;
-    /** The public catalog: listing totals by kind and audience. */
-    readonly catalog: CatalogClient;
     /** The signed-in person's native and imported notifications. */
     readonly notifications: NotificationsClient;
     /** What the content module allows: which interactions signed-out visitors may make. */
     config(signal?: AbortSignal): Promise<Config>;
+    /** The site's content model: languages, tiers, kinds, group kinds and content filters. */
+    kinds(signal?: AbortSignal): Promise<ContentModel>;
+    /** Staff bulk import (root:import:write): groups, contents, memberships, offers and aliases, idempotent per source. */
+    import(batch: Batch): Promise<Result>;
     /** A module's base URL as configured (no trailing slash). */
     url(module: ContentKitModule, ref?: RefBody): string;
     /** Cache context only, not authentication. The React provider keeps this in sync. */

package/dist/client/client.js

@@ -2,39 +2,47 @@ import { call as e } from "./route.js";
 import { MediaClient as t } from "./media/client.js";
 import { CatalogClient as n } from "./catalog.js";
 import { CodesClient as r } from "./codes.js";
-import { BansClient as i } from "./content/bans.js";
-import { CommentsClient as a } from "./content/comments.js";
-import { FavoritesClient as o } from "./content/favorites.js";
-import { ModerationClient as s } from "./content/moderation.js";
-import { PollsClient as c } from "./content/polls.js";
-import { PostsClient as l } from "./content/posts.js";
-import { ReactionsClient as u } from "./content/reactions.js";
-import { Http as d } from "./http.js";
-import { NotificationsClient as f } from "./notifications.js";
-import { TaxonomyClient as p } from "./taxonomy.js";
+import { ContentsClient as i } from "./contents.js";
+import { BansClient as a } from "./content/bans.js";
+import { CommentsClient as o } from "./content/comments.js";
+import { DiscoveryClient as s } from "./discovery.js";
+import { FavoritesClient as c } from "./content/favorites.js";
+import { ModerationClient as l } from "./content/moderation.js";
+import { PollsClient as u } from "./content/polls.js";
+import { ReactionsClient as d } from "./content/reactions.js";
+import { GroupsClient as f } from "./groups.js";
+import { OffersClient as p } from "./offers.js";
+import { VersionsClient as m } from "./versions.js";
+import { Http as h } from "./http.js";
+import { NotificationsClient as g } from "./notifications.js";
 //#region src/client/client.ts
-function m(m) {
-	let { media: h, folders: g, ..._ } = m, v = new d(_), y = new t(v, h, g);
+function _(_) {
+	let { media: v, folders: y, ...b } = _, x = new h(b), S = new t(x, v, y);
 	return {
-		media: y,
-		posts: new l(v, y),
-		comments: new a(v),
-		reactions: new u(v),
-		favorites: new o(v),
-		polls: new c(v, y),
-		bans: new i(v),
-		moderation: new s(v),
-		taxonomy: new p(v),
-		codes: new r(v),
-		catalog: new n(v),
-		notifications: new f(v),
-		config: (t) => e(v, "GET", "/config", { signal: t }),
-		url: (e, t) => v.mount(e, t),
-		setReadScope: (e) => v.setReadScope(e),
-		subscribe: (e) => v.subscribe(e)
+		media: S,
+		contents: new i(x),
+		catalog: new n(x),
+		comments: new o(x),
+		reactions: new d(x),
+		favorites: new c(x),
+		polls: new u(x, S),
+		bans: new a(x),
+		moderation: new l(x),
+		groups: new f(x, S),
+		discovery: new s(x),
+		versions: new m(x),
+		offers: new p(x),
+		codes: new r(x),
+		notifications: new g(x),
+		config: (t) => e(x, "GET", "/config", { signal: t }),
+		kinds: (t) => e(x, "GET", "/kinds", { signal: t }),
+		import: (t) => e(x, "POST", "/import", { body: t }),
+		url: (e, t) => x.mount(e, t),
+		setReadScope: (e) => x.setReadScope(e),
+		subscribe: (e) => x.subscribe(e)
 	};
 }
 //#endregion
-export { m as createContentKitClient };
+export { _ as createContentKitClient };
 
 //# sourceMappingURL=client.js.map

package/dist/client/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../src/client/client.ts"],"sourcesContent":["import { CatalogClient } from \"./catalog.js\";\nimport { CodesClient } from \"./codes.js\";\nimport { BansClient } from \"./content/bans.js\";\nimport { CommentsClient } from \"./content/comments.js\";\nimport { FavoritesClient } from \"./content/favorites.js\";\nimport { ModerationClient } from \"./content/moderation.js\";\nimport { PollsClient } from \"./content/polls.js\";\nimport { PostsClient } from \"./content/posts.js\";\nimport { ReactionsClient } from \"./content/reactions.js\";\nimport type { Config, RefBody } from \"./generated/wire.js\";\nimport { Http, type ContentKitChange, type ContentKitModule, type HttpOptions } from \"./http.js\";\nimport { MediaClient, type ContentFolders, type MediaOptions } from \"./media/client.js\";\nimport { call } from \"./route.js\";\nimport { NotificationsClient } from \"./notifications.js\";\nimport { TaxonomyClient } from \"./taxonomy.js\";\n\nexport interface ContentKitClientOptions extends HttpOptions {\n  /** Upload tuning (transport, part concurrency, retries). */\n  media?: MediaOptions;\n  /** The media kinds of post and poll folders, when the host renamed them (content.Media). */\n  folders?: ContentFolders;\n}\n\n/**\n * One ContentKit deployment as the browser sees it. Each module is a property\n * over one shared transport (mounts, auth, language, errors, change events).\n */\nexport interface ContentKitClient {\n  /** Uploads, multipart, commits, reads, frames, HLS bases, hls.js `xhrSetup` and inline images. */\n  readonly media: MediaClient;\n  /** Published posts, staff CRUD, reactions, cover and body images. */\n  readonly posts: PostsClient;\n  /** Threads, replies, edits, tombstones, reactions, standing, the latest feed, moderation. */\n  readonly comments: CommentsClient;\n  /** Likes and dislikes of an item. */\n  readonly reactions: ReactionsClient;\n  /** The signed-in caller's favorites. */\n  readonly favorites: FavoritesClient;\n  /** Polls: votes, free-text answers and the staff editor. */\n  readonly polls: PollsClient;\n  /** Comment bans, owner and global. */\n  readonly bans: BansClient;\n  /** The review queue of held comments and posts. */\n  readonly moderation: ModerationClient;\n  /** The taxonomy admin API. */\n  readonly taxonomy: TaxonomyClient;\n  /** Content-code lookup. */\n  readonly codes: CodesClient;\n  /** The public catalog: listing totals by kind and audience. */\n  readonly catalog: CatalogClient;\n  /** The signed-in person's native and imported notifications. */\n  readonly notifications: NotificationsClient;\n\n  /** What the content module allows: which interactions signed-out visitors may make. */\n  config(signal?: AbortSignal): Promise<Config>;\n  /** A module's base URL as configured (no trailing slash). */\n  url(module: ContentKitModule, ref?: RefBody): string;\n  /** Cache context only, not authentication. The React provider keeps this in sync. */\n  setReadScope(scope: string): void;\n  /** Every successful mutation; a null scope means its data predates a context change. */\n  subscribe(listener: (change: ContentKitChange, scope: string | null) => void): () => void;\n}\n\nexport function createContentKitClient(options: ContentKitClientOptions): ContentKitClient {\n  const { media: mediaOptions, folders, ...http } = options;\n  const h = new Http(http);\n  const media = new MediaClient(h, mediaOptions, folders);\n  return {\n    media,\n    posts: new PostsClient(h, media),\n    comments: new CommentsClient(h),\n    reactions: new ReactionsClient(h),\n    favorites: new FavoritesClient(h),\n    polls: new PollsClient(h, media),\n    bans: new BansClient(h),\n    moderation: new ModerationClient(h),\n    taxonomy: new TaxonomyClient(h),\n    codes: new CodesClient(h),\n    catalog: new CatalogClient(h),\n    notifications: new NotificationsClient(h),\n    config: (signal) => call(h, \"GET\", \"/config\", { signal }),\n    url: (module, ref) => h.mount(module, ref),\n    setReadScope: (scope) => h.setReadScope(scope),\n    subscribe: (listener) => h.subscribe(listener),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AA+DA,SAAgB,EAAuB,GAAoD;CACzF,IAAM,EAAE,OAAO,GAAc,YAAS,GAAG,MAAS,GAC5C,IAAI,IAAI,EAAK,CAAI,GACjB,IAAQ,IAAI,EAAY,GAAG,GAAc,CAAO;CACtD,OAAO;EACL;EACA,OAAO,IAAI,EAAY,GAAG,CAAK;EAC/B,UAAU,IAAI,EAAe,CAAC;EAC9B,WAAW,IAAI,EAAgB,CAAC;EAChC,WAAW,IAAI,EAAgB,CAAC;EAChC,OAAO,IAAI,EAAY,GAAG,CAAK;EAC/B,MAAM,IAAI,EAAW,CAAC;EACtB,YAAY,IAAI,EAAiB,CAAC;EAClC,UAAU,IAAI,EAAe,CAAC;EAC9B,OAAO,IAAI,EAAY,CAAC;EACxB,SAAS,IAAI,EAAc,CAAC;EAC5B,eAAe,IAAI,EAAoB,CAAC;EACxC,SAAS,MAAW,EAAK,GAAG,OAAO,WAAW,EAAE,UAAO,CAAC;EACxD,MAAM,GAAQ,MAAQ,EAAE,MAAM,GAAQ,CAAG;EACzC,eAAe,MAAU,EAAE,aAAa,CAAK;EAC7C,YAAY,MAAa,EAAE,UAAU,CAAQ;CAC/C;AACF"}
+{"version":3,"file":"client.js","names":[],"sources":["../../src/client/client.ts"],"sourcesContent":["import { CatalogClient } from \"./catalog.js\";\nimport { CodesClient } from \"./codes.js\";\nimport { ContentsClient } from \"./contents.js\";\nimport { BansClient } from \"./content/bans.js\";\nimport { CommentsClient } from \"./content/comments.js\";\nimport { FavoritesClient } from \"./content/favorites.js\";\nimport { ModerationClient } from \"./content/moderation.js\";\nimport { PollsClient } from \"./content/polls.js\";\nimport { ReactionsClient } from \"./content/reactions.js\";\nimport type { Batch, Config, ContentModel, RefBody, Result } from \"./generated/wire.js\";\nimport { DiscoveryClient } from \"./discovery.js\";\nimport { GroupsClient } from \"./groups.js\";\nimport { OffersClient } from \"./offers.js\";\nimport { VersionsClient } from \"./versions.js\";\nimport { Http, type ContentKitChange, type ContentKitModule, type HttpOptions } from \"./http.js\";\nimport { MediaClient, type ContentFolders, type MediaOptions } from \"./media/client.js\";\nimport { call } from \"./route.js\";\nimport { NotificationsClient } from \"./notifications.js\";\n\nexport interface ContentKitClientOptions extends HttpOptions {\n  /** Upload tuning (transport, part concurrency, retries). */\n  media?: MediaOptions;\n  /** The media kind of poll folders, when the host renamed it (content.Media). */\n  folders?: ContentFolders;\n}\n\n/**\n * One ContentKit deployment as the browser sees it. Each module is a property\n * over one shared transport (mounts, auth, language, errors, change events).\n */\nexport interface ContentKitClient {\n  /** Uploads, multipart, commits, reads, frames, HLS bases, hls.js `xhrSetup` and inline images. */\n  readonly media: MediaClient;\n  /** Content items: reads, and writes for their creators, owner-group editors and staff. */\n  readonly contents: ContentsClient;\n  /** The catalog's totals by kind, language and audience. */\n  readonly catalog: CatalogClient;\n  /** Threads, replies, edits, tombstones, reactions, standing, the latest feed, moderation. */\n  readonly comments: CommentsClient;\n  /** Likes and dislikes of an item. */\n  readonly reactions: ReactionsClient;\n  /** The signed-in caller's favorites. */\n  readonly favorites: FavoritesClient;\n  /** Polls: votes, free-text answers and the staff editor. */\n  readonly polls: PollsClient;\n  /** Comment bans, owner and global. */\n  readonly bans: BansClient;\n  /** The review queue of held comments and content. */\n  readonly moderation: ModerationClient;\n  /** Groups: listings, pages, staff writes and memberships. */\n  readonly groups: GroupsClient;\n  /** Lists, search, typeahead, rails, release dates, content filters, history, signals and exposures. */\n  readonly discovery: DiscoveryClient;\n  /** Content versions: reader plans, reader metadata, forks and downloads. */\n  readonly versions: VersionsClient;\n  /** Offers on contents, versions and groups; group joins; the reader's library. */\n  readonly offers: OffersClient;\n  /** Content-code lookup. */\n  readonly codes: CodesClient;\n  /** The signed-in person's native and imported notifications. */\n  readonly notifications: NotificationsClient;\n\n  /** What the content module allows: which interactions signed-out visitors may make. */\n  config(signal?: AbortSignal): Promise<Config>;\n  /** The site's content model: languages, tiers, kinds, group kinds and content filters. */\n  kinds(signal?: AbortSignal): Promise<ContentModel>;\n  /** Staff bulk import (root:import:write): groups, contents, memberships, offers and aliases, idempotent per source. */\n  import(batch: Batch): Promise<Result>;\n  /** A module's base URL as configured (no trailing slash). */\n  url(module: ContentKitModule, ref?: RefBody): string;\n  /** Cache context only, not authentication. The React provider keeps this in sync. */\n  setReadScope(scope: string): void;\n  /** Every successful mutation; a null scope means its data predates a context change. */\n  subscribe(listener: (change: ContentKitChange, scope: string | null) => void): () => void;\n}\n\nexport function createContentKitClient(options: ContentKitClientOptions): ContentKitClient {\n  const { media: mediaOptions, folders, ...http } = options;\n  const h = new Http(http);\n  const media = new MediaClient(h, mediaOptions, folders);\n  return {\n    media,\n    contents: new ContentsClient(h),\n    catalog: new CatalogClient(h),\n    comments: new CommentsClient(h),\n    reactions: new ReactionsClient(h),\n    favorites: new FavoritesClient(h),\n    polls: new PollsClient(h, media),\n    bans: new BansClient(h),\n    moderation: new ModerationClient(h),\n    groups: new GroupsClient(h, media),\n    discovery: new DiscoveryClient(h),\n    versions: new VersionsClient(h),\n    offers: new OffersClient(h),\n    codes: new CodesClient(h),\n    notifications: new NotificationsClient(h),\n    config: (signal) => call(h, \"GET\", \"/config\", { signal }),\n    kinds: (signal) => call(h, \"GET\", \"/kinds\", { signal }),\n    import: (batch) => call(h, \"POST\", \"/import\", { body: batch }),\n    url: (module, ref) => h.mount(module, ref),\n    setReadScope: (scope) => h.setReadScope(scope),\n    subscribe: (listener) => h.subscribe(listener),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA4EA,SAAgB,EAAuB,GAAoD;CACzF,IAAM,EAAE,OAAO,GAAc,YAAS,GAAG,MAAS,GAC5C,IAAI,IAAI,EAAK,CAAI,GACjB,IAAQ,IAAI,EAAY,GAAG,GAAc,CAAO;CACtD,OAAO;EACL;EACA,UAAU,IAAI,EAAe,CAAC;EAC9B,SAAS,IAAI,EAAc,CAAC;EAC5B,UAAU,IAAI,EAAe,CAAC;EAC9B,WAAW,IAAI,EAAgB,CAAC;EAChC,WAAW,IAAI,EAAgB,CAAC;EAChC,OAAO,IAAI,EAAY,GAAG,CAAK;EAC/B,MAAM,IAAI,EAAW,CAAC;EACtB,YAAY,IAAI,EAAiB,CAAC;EAClC,QAAQ,IAAI,EAAa,GAAG,CAAK;EACjC,WAAW,IAAI,EAAgB,CAAC;EAChC,UAAU,IAAI,EAAe,CAAC;EAC9B,QAAQ,IAAI,EAAa,CAAC;EAC1B,OAAO,IAAI,EAAY,CAAC;EACxB,eAAe,IAAI,EAAoB,CAAC;EACxC,SAAS,MAAW,EAAK,GAAG,OAAO,WAAW,EAAE,UAAO,CAAC;EACxD,QAAQ,MAAW,EAAK,GAAG,OAAO,UAAU,EAAE,UAAO,CAAC;EACtD,SAAS,MAAU,EAAK,GAAG,QAAQ,WAAW,EAAE,MAAM,EAAM,CAAC;EAC7D,MAAM,GAAQ,MAAQ,EAAE,MAAM,GAAQ,CAAG;EACzC,eAAe,MAAU,EAAE,aAAa,CAAK;EAC7C,YAAY,MAAa,EAAE,UAAU,CAAQ;CAC/C;AACF"}