@geekity/cms 0.3.0 → 0.4.0

package/dist/web/conversation.js

@@ -0,0 +1,557 @@
+import { actorHandle, replyFrom, REPLY_ACTIVITY_TYPE } from '../federation/replies.js';
+import { activityStreamsId, isPublicDocument } from './documents.js';
+import { absoluteUrl } from './negotiate.js';
+import { sanitizeCommentHtml } from './sanitize.js';
+/**
+ * The reader over one site's two indexes.
+ *
+ * The methods are properties rather than prototype methods so that one of them
+ * can be handed out on its own — the renderer is given `conversation.thread`
+ * and nothing else — without anybody having to wrap it in a closure to keep
+ * `this`.
+ */
+export function createConversation(context) {
+    return {
+        thread: (document) => postConversation(context, document),
+        counts: (documents) => commentCounts(context, documents),
+        latest: (limit) => siteConversation(context, limit),
+    };
+}
+/** A conversation with nothing in it, which is what most posts have. */
+const NOTHING = {
+    replies: [],
+    likes: [],
+    boosts: [],
+    mentions: [],
+    counts: { replies: 0, likes: 0, boosts: 0, mentions: 0, total: 0 },
+};
+/**
+ * The conversation under one post: everything said about it, from every source
+ * the site has, threaded into one.
+ *
+ * A post that has never been delivered has no ActivityStreams id and so can
+ * have no fediverse replies — nothing out there has a name for it yet — but it
+ * can still have native comments, which hang off its permalink instead.
+ */
+function postConversation(context, document) {
+    const objectId = activityStreamsId(document, context.baseUrl);
+    // What a top-level answer names. The object id when the post has one, and
+    // the permalink otherwise: a post that has never been delivered can still
+    // have native comments, and they have to hang off something.
+    const root = objectId ?? document.permalink;
+    const activities = objectId === undefined ? [] : activitiesAround(context.admin, objectId);
+    const native = approvedComments(context.admin, document);
+    if (activities.length === 0 && native.length === 0)
+        return NOTHING;
+    const naming = authorNaming(context.admin);
+    const withdrawn = withdrawnBy(activities);
+    const written = [];
+    const likes = [];
+    const boosts = [];
+    const mentions = [];
+    const reacted = new Set();
+    for (const activity of activities) {
+        const kind = REACTIONS[activity.activityType];
+        if (kind !== undefined) {
+            // Only a reaction to the post itself: a like of one of the replies
+            // belongs to that reply's own conversation, wherever it is shown.
+            if (activity.objectId !== objectId)
+                continue;
+            // One like per actor, however many times it was delivered, and none at
+            // all once its actor has taken it back.
+            const key = `${kind}\0${activity.actorId}`;
+            if (reacted.has(key))
+                continue;
+            if (activity.activityId !== null && withdrawn.has(activity.activityId))
+                continue;
+            reacted.add(key);
+            const author = naming(activity.actorId);
+            (kind === 'like' ? likes : boosts).push({
+                id: activity.activityId ?? `${activity.actorId}#${kind}`,
+                source: 'activitypub',
+                kind,
+                author,
+                url: author.url,
+                content: '',
+                published: new Date(activity.receivedAt),
+                inReplyTo: null,
+                status: 'published',
+                replies: [],
+            });
+            continue;
+        }
+        const reply = replyFrom(activity);
+        if (reply === undefined)
+            continue;
+        written.push(federatedInteraction(reply, naming(activity.actorId)));
+    }
+    for (const comment of native) {
+        // A repost joins the boosts, because a reader looking at the page is being
+        // told the same thing by both; a mention is its own group, because it is
+        // neither an answer nor a reaction.
+        const group = comment.kind === 'reply'
+            ? written
+            : comment.kind === 'like'
+                ? likes
+                : comment.kind === 'mention'
+                    ? mentions
+                    : boosts;
+        group.push({ ...comment, replies: [] });
+    }
+    // Sorted before threading rather than after, because a thread is built by
+    // walking this list: two sources' entries would otherwise interleave in the
+    // order the code happened to read them rather than in the order they were
+    // written.
+    written.sort(byPublished);
+    const replies = threadOf(written, root, withdrawn);
+    sortThread(replies);
+    likes.sort(byPublished);
+    boosts.sort(byPublished);
+    mentions.sort(byPublished);
+    const counted = countReplies(replies);
+    return {
+        replies,
+        likes,
+        boosts,
+        mentions,
+        counts: {
+            replies: counted,
+            likes: likes.length,
+            boosts: boosts.length,
+            mentions: mentions.length,
+            total: counted + likes.length + boosts.length + mentions.length,
+        },
+    };
+}
+/**
+ * The whole site's latest answers, newest first, each with its post.
+ *
+ * Read per source and merged rather than threaded: a site-wide list is a list
+ * of what has just been said, and an answer to an answer is as much news as an
+ * answer to a post. Both sides are over-read for the same reason — one about a
+ * post that has since been unpublished is dropped after the index has already
+ * counted it — and the merged list is cut to size at the end.
+ */
+function siteConversation(context, limit) {
+    const naming = authorNaming(context.admin);
+    const posts = new PostsByObjectId(context);
+    const said = [];
+    for (let offset = 0; said.length < limit;) {
+        const page = context.admin.listReplies({ limit: limit * OVERSCAN, offset });
+        if (page.length === 0)
+            break;
+        offset += page.length;
+        for (const activity of page) {
+            const reply = replyFrom(activity);
+            if (reply === undefined)
+                continue;
+            const post = posts.get(reply.inReplyTo);
+            if (post === undefined)
+                continue;
+            said.push({ ...federatedInteraction(reply, naming(activity.actorId)), post });
+            if (said.length === limit)
+                break;
+        }
+    }
+    for (const stored of context.admin.listComments({
+        status: 'approved',
+        limit: limit * OVERSCAN,
+    })) {
+        const post = context.store.getBySlug(stored.slug);
+        if (post === undefined || !isPublicDocument(post, context.store.now()))
+            continue;
+        said.push({ ...interactionOf(stored, post.permalink), post });
+    }
+    return newestFirst(said, limit);
+}
+/** How many answers each of these posts has, by permalink. */
+function commentCounts(context, documents) {
+    const counts = new Map();
+    for (const document of documents) {
+        const objectId = activityStreamsId(document, context.baseUrl);
+        const federated = objectId === undefined ? 0 : context.admin.countRepliesTo(objectId);
+        counts.set(document.permalink, federated + context.admin.countCommentsFor(document.slug, 'approved'));
+    }
+    return counts;
+}
+/**
+ * How many candidates a site-wide page reads for each one it keeps.
+ *
+ * Answers to a post that has since been unpublished are dropped after the
+ * index has already counted them, so the query has to over-read. Four is
+ * generous for a site whose posts mostly stay published and bounded for one
+ * whose posts do not.
+ */
+const OVERSCAN = 4;
+/** One logged fediverse reply as the thread's own shape. */
+function federatedInteraction(reply, author) {
+    return {
+        id: reply.id,
+        source: 'activitypub',
+        kind: 'reply',
+        author,
+        url: reply.url,
+        // Sanitised here, at the edge of the site, so the page and the feed
+        // republish the same checked markup rather than each checking for itself.
+        content: sanitizeCommentHtml(reply.html),
+        published: reply.published,
+        inReplyTo: reply.inReplyTo,
+        status: 'published',
+        replies: [],
+    };
+}
+/**
+ * The approved native comments on a post, as interactions, oldest first.
+ *
+ * Only approved ones. A comment waiting for a moderator and one filed as spam
+ * are both in the file and both in the index, and neither is anything a reader
+ * should be shown — which is the whole difference between this and what the
+ * moderation screen asks for.
+ */
+function approvedComments(admin, document) {
+    return admin
+        .listCommentsFor(document.slug)
+        .filter((comment) => comment.status === 'approved')
+        .map((comment) => interactionOf(comment, document.permalink));
+}
+/** One stored comment as the thread's own shape. */
+function interactionOf(comment, permalink) {
+    return {
+        id: comment.id,
+        source: comment.source,
+        kind: comment.kind,
+        author: {
+            name: comment.author.name,
+            // A commenter has no fediverse identity: they gave a name, maybe a
+            // website, and nothing that names them anywhere else.
+            handle: null,
+            url: comment.author.url,
+            // Only a webmention has one: it came out of the source page's `h-card`,
+            // and a form asks nobody for a picture.
+            avatar: comment.author.avatar,
+            actorId: null,
+        },
+        // Where it can be read. A comment written here lives here, at its own
+        // anchor; a webmention lives on the page it was sent from, and its `url`
+        // says so. A theme that prints `url` for a fediverse reply prints a
+        // working link for either, and so does a feed.
+        url: comment.url ?? `${permalink}#${commentAnchor(comment.id)}`,
+        content: comment.content.html,
+        published: new Date(comment.submitted),
+        inReplyTo: comment.inReplyTo,
+        status: comment.status,
+        replies: [],
+    };
+}
+/**
+ * The `id` a comment is anchored at on the page.
+ *
+ * Prefixed rather than bare so a comment can never collide with a heading
+ * anchor the post's own Markdown produced.
+ */
+export function commentAnchor(id) {
+    return `comment-${id}`;
+}
+/**
+ * Everything said in a conversation, at every depth and in no order: the
+ * replies and the mentions.
+ *
+ * The likes and the boosts are left out because they say nothing. A feed item
+ * is somebody's words, and "@ada liked this" has none to carry — a reader
+ * polling a comments feed would get an entry with an empty body and no way to
+ * tell what it was for.
+ */
+export function spokenIn(conversation) {
+    const said = [...conversation.mentions];
+    const walk = (replies) => {
+        for (const reply of replies) {
+            said.push(reply);
+            walk(reply.replies);
+        }
+    };
+    walk(conversation.replies);
+    return said;
+}
+/**
+ * Interactions as a comments feed carries them: newest first, at most `limit`,
+ * and every link absolute.
+ *
+ * The one place an interaction becomes a feed item, so the post's feed and the
+ * site's cannot disagree about what a comment's `guid` or `link` is. The HTML
+ * is handed over as it stands and sanitised by the feed itself, at the last
+ * moment before it becomes bytes this site publishes.
+ */
+export function feedComments(said, options) {
+    return newestFirst([...said], options.limit).map((entry) => ({
+        id: entry.id,
+        url: absoluteUrl(entry.url ?? '/', options.baseUrl),
+        author: entry.author.name,
+        published: entry.published,
+        html: entry.content,
+        ...(entry.post === undefined
+            ? {}
+            : { post: { title: entry.post.title, permalink: entry.post.permalink } }),
+    }));
+}
+/** The newest `limit` of a mixed list, which is the order every feed shows. */
+function newestFirst(said, limit) {
+    return said
+        .sort((left, right) => right.published.getTime() - left.published.getTime())
+        .slice(0, limit);
+}
+/**
+ * The public post an ActivityStreams object id names, memoised.
+ *
+ * Almost every id is the post's permalink (decision-13), so the permalink is
+ * looked up first and the answer is checked against the document's own id — a
+ * post that is no longer public has no id at all. Only when that fails is the
+ * whole index read, once, to find the post whose file names this id: a post
+ * migrated from WordPress keeps the `?p=813` its followers already hold, and
+ * no permalink spells that.
+ */
+class PostsByObjectId {
+    #context;
+    #found = new Map();
+    #all;
+    constructor(context) {
+        this.#context = context;
+    }
+    get(objectId) {
+        if (!this.#found.has(objectId))
+            this.#found.set(objectId, this.#resolve(objectId));
+        return this.#found.get(objectId);
+    }
+    #resolve(objectId) {
+        const permalink = permalinkOfObjectId(objectId, this.#context.baseUrl);
+        if (permalink !== undefined) {
+            const document = this.#context.store.getByPermalink(permalink);
+            if (document !== undefined &&
+                activityStreamsId(document, this.#context.baseUrl) === objectId) {
+                return document;
+            }
+        }
+        return this.#everything().get(objectId);
+    }
+    #everything() {
+        if (this.#all === undefined) {
+            this.#all = new Map();
+            for (const document of this.#context.store.listPosts()) {
+                const id = activityStreamsId(document, this.#context.baseUrl);
+                if (id !== undefined)
+                    this.#all.set(id, document);
+            }
+        }
+        return this.#all;
+    }
+}
+/**
+ * The permalink an object id names, when it is one this site would have
+ * minted: the path, with the base URL's own directory taken off it.
+ *
+ * An id from another host belongs to no post here however it is spelled, and
+ * neither does one carrying a query string — a permalink has none, so an id
+ * like `?p=813` is a stored one and is found by the walk instead.
+ */
+function permalinkOfObjectId(objectId, baseUrl) {
+    let url;
+    let base;
+    try {
+        url = new URL(objectId);
+        base = new URL(baseUrl);
+    }
+    catch {
+        return undefined;
+    }
+    if (url.origin !== base.origin || url.search !== '')
+        return undefined;
+    const directory = base.pathname === '/' ? '' : base.pathname.replace(/\/$/, '');
+    if (directory !== '' && !url.pathname.startsWith(`${directory}/`))
+        return undefined;
+    const pathname = url.pathname.slice(directory.length);
+    try {
+        return decodeURIComponent(pathname);
+    }
+    catch {
+        return pathname;
+    }
+}
+/**
+ * The replies as a thread: those answering the post at the top, each carrying
+ * the replies that answer it, oldest first at every level.
+ *
+ * Three things decide where a reply goes, and all three are what somebody
+ * reading the page would expect:
+ *
+ * - A reply whose target is gone — deleted by its author — is shown under
+ *   whatever *that* was answering, rather than disappearing with it. The
+ *   conversation stays readable and only the withdrawn note is missing.
+ * - A reply answering something that is no part of this conversation is left
+ *   out. The log holds it because it named something this walk asked about — a
+ *   note answering the like of a post is the shape of that — but the post is
+ *   not what it is talking about.
+ * - A note the site was told about twice is one reply, because the map is
+ *   keyed by the note's own id.
+ */
+function threadOf(written, objectId, withdrawn) {
+    const byId = new Map();
+    const targets = new Map();
+    for (const reply of written) {
+        targets.set(reply.id, reply.inReplyTo ?? objectId);
+        if (!withdrawn.has(reply.id))
+            byId.set(reply.id, reply);
+    }
+    const top = [];
+    for (const reply of byId.values()) {
+        const parent = surviving(reply, targets, byId, objectId);
+        if (parent === undefined)
+            continue;
+        (parent === null ? top : parent.replies).push(reply);
+    }
+    return top;
+}
+/**
+ * The reply a reply hangs under: `null` for the post itself, the nearest
+ * surviving ancestor for one whose own target was deleted, and `undefined` for
+ * a note that is answering something else entirely.
+ *
+ * The walk is bounded by the number of notes, so a log carrying a cycle — two
+ * notes each claiming to answer the other, which nothing stops a remote server
+ * from sending — ends rather than hangs.
+ */
+function surviving(reply, targets, byId, objectId) {
+    let target = targets.get(reply.id);
+    for (let step = 0; step <= targets.size; step += 1) {
+        if (target === undefined)
+            return undefined;
+        if (target === objectId)
+            return null;
+        const parent = byId.get(target);
+        if (parent !== undefined)
+            return parent === reply ? undefined : parent;
+        // The target is not a reply the site is showing: either a note its author
+        // deleted, whose own target this reply moves to, or nothing to do with the
+        // post at all.
+        target = targets.get(target);
+    }
+    return undefined;
+}
+/** Oldest first, which is the order a conversation reads in. */
+function byPublished(left, right) {
+    return left.published.getTime() - right.published.getTime();
+}
+/** Put every level of a thread in time order, all the way down. */
+function sortThread(replies) {
+    replies.sort(byPublished);
+    for (const reply of replies)
+        sortThread(reply.replies);
+}
+/** How many replies a thread holds, counting all the way down. */
+function countReplies(replies) {
+    let total = 0;
+    for (const reply of replies)
+        total += 1 + countReplies(reply.replies);
+    return total;
+}
+/** The two reactions, as the activity types they arrive as. */
+const REACTIONS = {
+    Like: 'like',
+    Announce: 'boost',
+};
+/**
+ * Every logged activity that has anything to do with a post, oldest first.
+ *
+ * The log is walked outwards rather than queried once: a reply names the post,
+ * a reply to that reply names the reply, and a `Delete` or an `Undo` names the
+ * activity it takes back. Each round asks about everything the last round
+ * turned up — the object an activity carried and the activity's own id — and
+ * stops when a round finds nothing new, which it must, because a row is
+ * collected once and there are finitely many.
+ */
+function activitiesAround(admin, objectId) {
+    const collected = new Map();
+    const asked = new Set([objectId]);
+    let frontier = [objectId];
+    while (frontier.length > 0) {
+        const next = [];
+        for (const activity of admin.listActivitiesAbout(frontier)) {
+            if (collected.has(activity.id))
+                continue;
+            collected.set(activity.id, activity);
+            for (const id of [activity.objectId, activity.activityId]) {
+                if (id === null || asked.has(id))
+                    continue;
+                asked.add(id);
+                next.push(id);
+            }
+        }
+        frontier = next;
+    }
+    // Row ids are the order things arrived in, and the rounds above return them
+    // out of that order.
+    return [...collected.values()].sort((left, right) => left.id - right.id);
+}
+/**
+ * The ids of everything an actor has taken back: the likes and boosts undone,
+ * and the notes deleted.
+ *
+ * Only by the actor that did it in the first place. Without that check any
+ * signed actor could delete somebody else's comment off this page, since the
+ * activity carrying the instruction is signed by its sender and says nothing
+ * about who the thing it names belonged to — which is the rule the inbox
+ * already applies to an `Undo(Follow)`.
+ */
+function withdrawnBy(activities) {
+    const owners = new Map();
+    for (const activity of activities) {
+        if (activity.activityId !== null)
+            owners.set(activity.activityId, activity.actorId);
+        if (activity.objectId !== null && activity.activityType === REPLY_ACTIVITY_TYPE) {
+            owners.set(activity.objectId, activity.actorId);
+        }
+    }
+    const withdrawn = new Set();
+    for (const activity of activities) {
+        if (activity.activityType !== 'Undo' && activity.activityType !== 'Delete')
+            continue;
+        if (activity.objectId === null)
+            continue;
+        if (owners.get(activity.objectId) !== activity.actorId)
+            continue;
+        withdrawn.add(activity.objectId);
+    }
+    return withdrawn;
+}
+/**
+ * How an actor is named, memoised for the length of one conversation.
+ *
+ * A follower is named from the profile it published when it followed; everyone
+ * else is named by the handle their actor URL implies, which is a guess and
+ * deliberately so — naming them properly would mean dereferencing the actor,
+ * a network round trip per comment on the page.
+ */
+function authorNaming(admin) {
+    const known = new Map();
+    // Read once, on the first unknown actor, rather than per actor: the
+    // followers are one row per (user, actor) now (decision-14), so the same
+    // stranger may be on the list several times and any of those rows names them
+    // the same way — the columns read here are the actor's own name and picture.
+    let profiles;
+    return (actorId) => {
+        const held = known.get(actorId);
+        if (held !== undefined)
+            return held;
+        profiles ??= new Map(admin.listFollowers().map((entry) => [entry.actorId, entry]));
+        const follower = profiles.get(actorId);
+        const handle = follower?.handle ?? actorHandle(actorId) ?? null;
+        const author = {
+            name: follower?.name ?? handle ?? actorId,
+            handle,
+            url: follower?.url ?? actorId,
+            avatar: follower?.iconUrl ?? null,
+            actorId,
+        };
+        known.set(actorId, author);
+        return author;
+    };
+}
+//# sourceMappingURL=conversation.js.map

package/dist/web/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../src/web/conversation.ts"],"names":[],"mappings":"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"}

package/dist/web/documents.d.ts

@@ -3,11 +3,17 @@ import type { ContentStore } from '../content/store.ts';
 /**
  * Whether the public site may show a document.
  *
- * Two things hide one: `draft: true` in the front matter, and living under
- * `_trash/`. Both stay indexed so the admin can find them; neither is ever
- * served, listed, or fed.
+ * Three things hide one: `draft: true` in the front matter, living under
+ * `_trash/`, and a date that has not arrived yet. All three stay indexed so
+ * the admin can find them; none is ever served, listed, or fed.
+ *
+ * This is the predicate the index answers in SQL, so anything that has to
+ * decide about a single document in hand — a permalink, a View link, the
+ * sitemap — asks it here rather than deriving the rule again. The clock
+ * defaults to the system one; a caller with a store should pass
+ * {@link ContentStore.now} so the answer matches the listings it came from.
  */
-export declare function isPublicDocument(document: Document): boolean;
+export declare function isPublicDocument(document: Document, now?: Date): boolean;
 /**
  * The document a public URL resolves to, or `undefined`.
  *
@@ -16,13 +22,37 @@ export declare function isPublicDocument(document: Document): boolean;
  * same document found the same way, so they cannot disagree about what exists.
  */
 export declare function publicDocumentAt(store: ContentStore, permalink: string): Document | undefined;
+/**
+ * A post's ActivityStreams object id: its permalink, absolute on the site's
+ * base URL, or the id its file already names.
+ *
+ * decision-13. A permalink is by name permanent, and the fediverse id is the
+ * same promise made to a different audience, so one URL answers both: a
+ * browser gets the page and a peer gets the `Article`, by content negotiation.
+ * There is no second URL to mint and none to keep in step.
+ *
+ * A stored `activitypub.id` wins, for the life of the post. That is not a
+ * cache: it is what lets a post migrated from WordPress keep the
+ * `https://example.com/?p=813` id its followers, its replies and its RSS
+ * subscribers already hold (decision-14), so the CMS serves the object there
+ * too and names it in every `Update` and `Delete`. A hand-written
+ * `activitypub.id` that is not a URL is not an id, and the permalink is used
+ * instead.
+ *
+ * Unlike {@link activityStreamsId} this answers for any post, published or
+ * not: a draft that was announced before it was withdrawn still has the name
+ * its followers filed it under, and a `Delete` has to say it.
+ */
+export declare function postObjectId(document: Document, baseUrl: string): string;
 /**
  * The ActivityStreams id of a document, or `undefined` when it has none.
  *
  * Only a published post federates (doc-4), so only a published post has an id
  * to advertise. This is what the theme's `<link rel="alternate">` points at,
- * and it is deliberately the same string the object dispatcher answers under:
- * the page and the object agree about the post's name in the fediverse.
+ * what every feed keys the post by (decision-12) and what the permalink
+ * answers an ActivityStreams request with: the page, the feed item and the
+ * object all agree about the post's name in the fediverse, because after
+ * decision-13 they are the same URL.
  */
 export declare function activityStreamsId(document: Document, baseUrl: string): string | undefined;
 //# sourceMappingURL=documents.d.ts.map

package/dist/web/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/web/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAI7F;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzF"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/web/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAEpF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAI7F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzF"}