@enbox/gitd 0.0.1

package/dist/esm/indexer/store.js

@@ -0,0 +1,334 @@
+/**
+ * In-memory indexer store — maintains materialized views of data
+ * crawled from distributed DWN records.
+ *
+ * Each entity is keyed by a unique composite identifier (DID + recordId
+ * or similar) and stored in a Map.  Aggregation methods compute star
+ * counts, trending scores, search results, etc. on the fly.
+ *
+ * A production deployment would back this with PostgreSQL or similar,
+ * but the in-memory implementation keeps the MVP dependency-free and
+ * testable.
+ *
+ * @module
+ */
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+const DEFAULT_LIMITS = {
+    maxDids: 100000,
+    maxRepos: 100000,
+    maxStars: 500000,
+    maxFollows: 500000,
+};
+// ---------------------------------------------------------------------------
+// Store
+// ---------------------------------------------------------------------------
+/** In-memory indexer store with configurable size limits. */
+export class IndexerStore {
+    constructor(limits) {
+        /** Repos keyed by `did:recordId`. */
+        this._repos = new Map();
+        /** Stars keyed by `starrerDid:repoDid:repoRecordId`. */
+        this._stars = new Map();
+        /** Follows keyed by `followerDid:targetDid`. */
+        this._follows = new Map();
+        /** Known DIDs to crawl. */
+        this._dids = new Set();
+        /** Per-DID crawl cursors. */
+        this._cursors = new Map();
+        this._limits = Object.assign(Object.assign({}, DEFAULT_LIMITS), limits);
+    }
+    // -----------------------------------------------------------------------
+    // DID management
+    // -----------------------------------------------------------------------
+    /** Register a DID for crawling. Evicts oldest entry if at capacity. */
+    addDid(did) {
+        if (this._dids.has(did)) {
+            this._dids.add(did);
+            return;
+        }
+        if (this._dids.size >= this._limits.maxDids) {
+            const oldest = this._dids.values().next().value;
+            if (oldest !== undefined) {
+                this._dids.delete(oldest);
+            }
+        }
+        this._dids.add(did);
+    }
+    /** Remove a DID from the crawl list. */
+    removeDid(did) {
+        this._dids.delete(did);
+    }
+    /** Get all registered DIDs. */
+    getDids() {
+        return [...this._dids];
+    }
+    /** Get the crawl cursor for a DID. */
+    getCursor(did) {
+        return this._cursors.get(did);
+    }
+    /** Update the crawl cursor for a DID. */
+    setCursor(did, lastCrawled) {
+        this._cursors.set(did, { did, lastCrawled });
+    }
+    // -----------------------------------------------------------------------
+    // Repo operations
+    // -----------------------------------------------------------------------
+    /** Upsert an indexed repo. Evicts oldest entry if at capacity. */
+    putRepo(repo) {
+        const key = `${repo.did}:${repo.recordId}`;
+        if (!this._repos.has(key) && this._repos.size >= this._limits.maxRepos) {
+            const oldest = this._repos.keys().next().value;
+            if (oldest !== undefined) {
+                this._repos.delete(oldest);
+            }
+        }
+        this._repos.set(key, repo);
+        this.addDid(repo.did);
+    }
+    /** Get an indexed repo by DID (returns first match). */
+    getRepo(did) {
+        for (const repo of this._repos.values()) {
+            if (repo.did === did) {
+                return repo;
+            }
+        }
+        return undefined;
+    }
+    /** Get all indexed repos. */
+    getAllRepos() {
+        return [...this._repos.values()];
+    }
+    // -----------------------------------------------------------------------
+    // Star operations
+    // -----------------------------------------------------------------------
+    /** Upsert an indexed star. Evicts oldest entry if at capacity. */
+    putStar(star) {
+        const key = `${star.starrerDid}:${star.repoDid}:${star.repoRecordId}`;
+        if (!this._stars.has(key) && this._stars.size >= this._limits.maxStars) {
+            const oldest = this._stars.keys().next().value;
+            if (oldest !== undefined) {
+                this._stars.delete(oldest);
+            }
+        }
+        this._stars.set(key, star);
+        this.addDid(star.starrerDid);
+    }
+    /** Remove a star. */
+    removeStar(starrerDid, repoDid, repoRecordId) {
+        this._stars.delete(`${starrerDid}:${repoDid}:${repoRecordId}`);
+    }
+    /** Get star count for a repo. */
+    getStarCount(repoDid, repoRecordId) {
+        let count = 0;
+        for (const star of this._stars.values()) {
+            if (star.repoDid === repoDid && star.repoRecordId === repoRecordId) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /** Get all stars for a repo. */
+    getStarsForRepo(repoDid, repoRecordId) {
+        const result = [];
+        for (const star of this._stars.values()) {
+            if (star.repoDid === repoDid && star.repoRecordId === repoRecordId) {
+                result.push(star);
+            }
+        }
+        return result;
+    }
+    /** Get all repos starred by a user. */
+    getStarredByUser(did) {
+        const result = [];
+        for (const star of this._stars.values()) {
+            if (star.starrerDid === did) {
+                result.push(star);
+            }
+        }
+        return result;
+    }
+    // -----------------------------------------------------------------------
+    // Follow operations
+    // -----------------------------------------------------------------------
+    /** Upsert an indexed follow. Evicts oldest entry if at capacity. */
+    putFollow(follow) {
+        const key = `${follow.followerDid}:${follow.targetDid}`;
+        if (!this._follows.has(key) && this._follows.size >= this._limits.maxFollows) {
+            const oldest = this._follows.keys().next().value;
+            if (oldest !== undefined) {
+                this._follows.delete(oldest);
+            }
+        }
+        this._follows.set(key, follow);
+        this.addDid(follow.followerDid);
+        this.addDid(follow.targetDid);
+    }
+    /** Remove a follow. */
+    removeFollow(followerDid, targetDid) {
+        this._follows.delete(`${followerDid}:${targetDid}`);
+    }
+    /** Get follower count for a user. */
+    getFollowerCount(did) {
+        let count = 0;
+        for (const f of this._follows.values()) {
+            if (f.targetDid === did) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /** Get following count for a user. */
+    getFollowingCount(did) {
+        let count = 0;
+        for (const f of this._follows.values()) {
+            if (f.followerDid === did) {
+                count++;
+            }
+        }
+        return count;
+    }
+    // -----------------------------------------------------------------------
+    // Aggregation queries
+    // -----------------------------------------------------------------------
+    /** Get repos with star counts, sorted by star count descending. */
+    getReposWithStars() {
+        return this.getAllRepos()
+            .map((r) => (Object.assign(Object.assign({}, r), { starCount: this.getStarCount(r.did, r.recordId) })))
+            .sort((a, b) => b.starCount - a.starCount);
+    }
+    /**
+     * Trending repos — sorted by recent star activity.
+     *
+     * Trending is computed as the number of stars received within
+     * `windowMs` (default: 7 days), weighted by recency.
+     */
+    getTrending(limit = 20, windowMs = 7 * 24 * 60 * 60 * 1000) {
+        var _a;
+        const now = Date.now();
+        const cutoff = new Date(now - windowMs).toISOString();
+        // Count recent stars per repo.
+        const recentStars = new Map();
+        for (const star of this._stars.values()) {
+            if (star.dateCreated >= cutoff) {
+                const key = `${star.repoDid}:${star.repoRecordId}`;
+                recentStars.set(key, ((_a = recentStars.get(key)) !== null && _a !== void 0 ? _a : 0) + 1);
+            }
+        }
+        return this.getReposWithStars()
+            .map((r) => {
+            var _a;
+            const key = `${r.did}:${r.recordId}`;
+            const recent = (_a = recentStars.get(key)) !== null && _a !== void 0 ? _a : 0;
+            return Object.assign(Object.assign({}, r), { _trending: recent });
+        })
+            .sort((a, b) => b._trending - a._trending || b.starCount - a.starCount)
+            .slice(0, limit)
+            .map((_a) => { var r = __rest(_a, []); delete r._trending; return r; });
+    }
+    /**
+     * Search repos by name, description, topics, or language.
+     *
+     * Returns results sorted by relevance score.  Scoring:
+     *   - Name exact match: 10
+     *   - Name prefix match: 5
+     *   - Name substring match: 3
+     *   - Topic match: 4
+     *   - Language match: 2
+     *   - Description substring match: 1
+     *   - Star count bonus: 0.1 per star (capped at 5)
+     */
+    search(query, limit = 50) {
+        const q = query.toLowerCase();
+        const results = [];
+        for (const r of this.getReposWithStars()) {
+            let score = 0;
+            const name = r.name.toLowerCase();
+            const desc = r.description.toLowerCase();
+            if (name === q) {
+                score += 10;
+            }
+            else if (name.startsWith(q)) {
+                score += 5;
+            }
+            else if (name.includes(q)) {
+                score += 3;
+            }
+            if (r.topics.some((t) => t.toLowerCase() === q)) {
+                score += 4;
+            }
+            if (r.language.toLowerCase() === q) {
+                score += 2;
+            }
+            if (desc.includes(q)) {
+                score += 1;
+            }
+            // Star bonus.
+            score += Math.min(r.starCount * 0.1, 5);
+            if (score > 0) {
+                results.push(Object.assign(Object.assign({}, r), { score }));
+            }
+        }
+        return results
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit);
+    }
+    /** Get user profile summary. */
+    getUserProfile(did) {
+        const repos = this.getAllRepos().filter((r) => r.did === did);
+        let totalStars = 0;
+        for (const r of repos) {
+            totalStars += this.getStarCount(r.did, r.recordId);
+        }
+        return {
+            did,
+            repoCount: repos.length,
+            starCount: totalStars,
+            followerCount: this.getFollowerCount(did),
+            followingCount: this.getFollowingCount(did),
+        };
+    }
+    /**
+     * List repos by language, sorted by star count.
+     */
+    getReposByLanguage(language) {
+        const lang = language.toLowerCase();
+        return this.getReposWithStars()
+            .filter((r) => r.language.toLowerCase() === lang);
+    }
+    /**
+     * List repos by topic, sorted by star count.
+     */
+    getReposByTopic(topic) {
+        const t = topic.toLowerCase();
+        return this.getReposWithStars()
+            .filter((r) => r.topics.some((tp) => tp.toLowerCase() === t));
+    }
+    /** Get store statistics. */
+    getStats() {
+        return {
+            dids: this._dids.size,
+            repos: this._repos.size,
+            stars: this._stars.size,
+            follows: this._follows.size,
+        };
+    }
+    /** Clear all data. */
+    clear() {
+        this._repos.clear();
+        this._stars.clear();
+        this._follows.clear();
+        this._dids.clear();
+        this._cursors.clear();
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/esm/indexer/store.js.map

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

package/dist/esm/issues.js

@@ -0,0 +1,133 @@
+/**
+ * Forge Issues Protocol — issue tracking with comments, labels, and status changes.
+ *
+ * Composes with the Forge Repo protocol via `uses` for role-based authorization.
+ * Only users with a contributor, triager, or maintainer role can create issues
+ * directly on the repo owner's DWN. External issue reports live on the reporter's
+ * own DWN and are surfaced via indexers.
+ *
+ * @module
+ */
+import { defineProtocol } from '@enbox/api';
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+export const ForgeIssuesDefinition = {
+    protocol: 'https://enbox.org/protocols/forge/issues',
+    published: true,
+    uses: {
+        repo: 'https://enbox.org/protocols/forge/repo',
+    },
+    types: {
+        issue: {
+            schema: 'https://enbox.org/schemas/forge/issue',
+            dataFormats: ['application/json'],
+        },
+        comment: {
+            schema: 'https://enbox.org/schemas/forge/comment',
+            dataFormats: ['application/json'],
+        },
+        reaction: {
+            schema: 'https://enbox.org/schemas/forge/reaction',
+            dataFormats: ['application/json'],
+        },
+        label: {
+            schema: 'https://enbox.org/schemas/forge/label',
+            dataFormats: ['application/json'],
+        },
+        statusChange: {
+            schema: 'https://enbox.org/schemas/forge/status-change',
+            dataFormats: ['application/json'],
+        },
+        assignment: {
+            schema: 'https://enbox.org/schemas/forge/assignment',
+            dataFormats: ['application/json'],
+        },
+    },
+    structure: {
+        repo: {
+            $ref: 'repo:repo',
+            issue: {
+                $actions: [
+                    { role: 'repo:repo/contributor', can: ['create', 'read'] },
+                    { role: 'repo:repo/maintainer', can: ['create', 'read', 'update', 'delete'] },
+                    { role: 'repo:repo/triager', can: ['create', 'read', 'co-update'] },
+                    { who: 'author', of: 'repo/issue', can: ['create', 'update'] },
+                ],
+                $tags: {
+                    $requiredTags: ['status'],
+                    $allowUndefinedTags: false,
+                    status: { type: 'string', enum: ['open', 'closed'] },
+                    number: { type: 'string' },
+                    priority: { type: 'string', enum: ['low', 'medium', 'high', 'critical'] },
+                    milestone: { type: 'string' },
+                },
+                comment: {
+                    $actions: [
+                        { role: 'repo:repo/contributor', can: ['create', 'read'] },
+                        { role: 'repo:repo/maintainer', can: ['create', 'read', 'delete'] },
+                        { who: 'author', of: 'repo/issue/comment', can: ['create', 'update', 'delete'] },
+                    ],
+                    reaction: {
+                        $actions: [
+                            { role: 'repo:repo/contributor', can: ['create', 'read', 'delete'] },
+                            { role: 'repo:repo/maintainer', can: ['create', 'read', 'delete'] },
+                        ],
+                        $tags: {
+                            $requiredTags: ['emoji'],
+                            $allowUndefinedTags: false,
+                            emoji: { type: 'string', maxLength: 10 },
+                        },
+                    },
+                },
+                label: {
+                    $immutable: true,
+                    $actions: [
+                        { role: 'repo:repo/contributor', can: ['read'] },
+                        { role: 'repo:repo/maintainer', can: ['create', 'delete'] },
+                        { role: 'repo:repo/triager', can: ['create', 'delete'] },
+                    ],
+                    $tags: {
+                        $requiredTags: ['name', 'color'],
+                        $allowUndefinedTags: false,
+                        name: { type: 'string' },
+                        color: { type: 'string' },
+                    },
+                },
+                statusChange: {
+                    $immutable: true,
+                    $actions: [
+                        { role: 'repo:repo/contributor', can: ['read'] },
+                        { role: 'repo:repo/maintainer', can: ['create'] },
+                        { role: 'repo:repo/triager', can: ['create'] },
+                        { who: 'author', of: 'repo/issue', can: ['create'] },
+                    ],
+                    $tags: {
+                        $requiredTags: ['from', 'to'],
+                        $allowUndefinedTags: false,
+                        from: { type: 'string', enum: ['open', 'closed'] },
+                        to: { type: 'string', enum: ['open', 'closed'] },
+                    },
+                },
+                assignment: {
+                    $actions: [
+                        { role: 'repo:repo/contributor', can: ['read'] },
+                        { role: 'repo:repo/maintainer', can: ['create', 'delete'] },
+                        { role: 'repo:repo/triager', can: ['create', 'delete'] },
+                    ],
+                    $tags: {
+                        $requiredTags: ['assigneeDid'],
+                        $allowUndefinedTags: false,
+                        assigneeDid: { type: 'string' },
+                    },
+                },
+            },
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+/** Typed Forge Issues protocol for use with `dwn.using()`. */
+export const ForgeIssuesProtocol = defineProtocol(ForgeIssuesDefinition, {});
+//# sourceMappingURL=issues.js.map

package/dist/esm/issues.js.map

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

package/dist/esm/notifications.js

@@ -0,0 +1,47 @@
+/**
+ * Forge Notifications Protocol — private notification inbox.
+ *
+ * Notifications are private (`published: false`). Only the DWN owner can
+ * read, update (mark as read), or delete. Notification senders (e.g., repo
+ * maintainers, CI bots) need a scoped permission grant to create.
+ *
+ * @module
+ */
+import { defineProtocol } from '@enbox/api';
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+export const ForgeNotificationsDefinition = {
+    protocol: 'https://enbox.org/protocols/forge/notifications',
+    published: false,
+    types: {
+        notification: {
+            schema: 'https://enbox.org/schemas/forge/notification',
+            dataFormats: ['application/json'],
+        },
+    },
+    structure: {
+        notification: {
+            // Owner-only read/update/delete.
+            // Senders need a permission grant to create.
+            $tags: {
+                $requiredTags: ['type', 'read'],
+                $allowUndefinedTags: true,
+                type: {
+                    type: 'string',
+                    enum: ['mention', 'review_request', 'assignment', 'ci_failure', 'patch_merged', 'issue_comment', 'review'],
+                },
+                read: { type: 'boolean' },
+                repoDid: { type: 'string' },
+                repoRecordId: { type: 'string' },
+                sourceRecordId: { type: 'string' },
+            },
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+/** Typed Forge Notifications protocol for use with `dwn.using()`. */
+export const ForgeNotificationsProtocol = defineProtocol(ForgeNotificationsDefinition, {});
+//# sourceMappingURL=notifications.js.map

package/dist/esm/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA0B5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,QAAQ,EAAI,iDAAiD;IAC7D,SAAS,EAAG,KAAK;IACjB,KAAK,EAAO;QACV,YAAY,EAAE;YACZ,MAAM,EAAQ,8CAA8C;YAC5D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,YAAY,EAAE;YACZ,iCAAiC;YACjC,6CAA6C;YAC7C,KAAK,EAAE;gBACL,aAAa,EAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBACtC,mBAAmB,EAAG,IAAI;gBAC1B,IAAI,EAAkB;oBACpB,IAAI,EAAG,QAAQ;oBACf,IAAI,EAAG,CAAC,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,CAAC;iBAC5G;gBACD,IAAI,EAAa,EAAE,IAAI,EAAE,SAAS,EAAE;gBACpC,OAAO,EAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACnC,YAAY,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACnC,cAAc,EAAG,EAAE,IAAI,EAAE,QAAQ,EAAE;aACpC;SACF;KACF;CACoC,CAAC;AAExC,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,qEAAqE;AACrE,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CACtD,4BAA4B,EAC5B,EAAiC,CAClC,CAAC"}

package/dist/esm/org.js

@@ -0,0 +1,90 @@
+/**
+ * Forge Organization Protocol — organization and team management.
+ *
+ * Organizations are DIDs themselves. An org DID installs the forge protocols
+ * and manages repos. Organization members and teams provide sub-organization
+ * grouping with their own role scoping.
+ *
+ * @module
+ */
+import { defineProtocol } from '@enbox/api';
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+export const ForgeOrgDefinition = {
+    protocol: 'https://enbox.org/protocols/forge/org',
+    published: true,
+    types: {
+        org: {
+            schema: 'https://enbox.org/schemas/forge/org',
+            dataFormats: ['application/json'],
+        },
+        owner: {
+            schema: 'https://enbox.org/schemas/forge/org-member',
+            dataFormats: ['application/json'],
+        },
+        member: {
+            schema: 'https://enbox.org/schemas/forge/org-member',
+            dataFormats: ['application/json'],
+        },
+        team: {
+            schema: 'https://enbox.org/schemas/forge/team',
+            dataFormats: ['application/json'],
+        },
+        teamMember: {
+            schema: 'https://enbox.org/schemas/forge/team-member',
+            dataFormats: ['application/json'],
+        },
+    },
+    structure: {
+        org: {
+            $recordLimit: { max: 1, strategy: 'reject' },
+            $actions: [{ who: 'anyone', can: ['read'] }],
+            owner: {
+                $role: true,
+                $actions: [{ who: 'anyone', can: ['read'] }],
+                $tags: {
+                    $requiredTags: ['did'],
+                    $allowUndefinedTags: false,
+                    did: { type: 'string' },
+                },
+            },
+            member: {
+                $role: true,
+                $actions: [
+                    { who: 'anyone', can: ['read'] },
+                    { role: 'org/owner', can: ['create', 'delete'] },
+                ],
+                $tags: {
+                    $requiredTags: ['did'],
+                    $allowUndefinedTags: false,
+                    did: { type: 'string' },
+                },
+            },
+            team: {
+                $actions: [
+                    { who: 'anyone', can: ['read'] },
+                    { role: 'org/owner', can: ['create', 'update', 'delete'] },
+                ],
+                teamMember: {
+                    $role: true,
+                    $actions: [
+                        { who: 'anyone', can: ['read'] },
+                        { role: 'org/owner', can: ['create', 'delete'] },
+                    ],
+                    $tags: {
+                        $requiredTags: ['did'],
+                        $allowUndefinedTags: false,
+                        did: { type: 'string' },
+                    },
+                },
+            },
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+/** Typed Forge Org protocol for use with `dwn.using()`. */
+export const ForgeOrgProtocol = defineProtocol(ForgeOrgDefinition, {});
+//# sourceMappingURL=org.js.map

package/dist/esm/org.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org.js","sourceRoot":"","sources":["../../src/org.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA8C5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAI,uCAAuC;IACnD,SAAS,EAAG,IAAI;IAChB,KAAK,EAAO;QACV,GAAG,EAAE;YACH,MAAM,EAAQ,qCAAqC;YACnD,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,KAAK,EAAE;YACL,MAAM,EAAQ,4CAA4C;YAC1D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,MAAM,EAAE;YACN,MAAM,EAAQ,4CAA4C;YAC1D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,IAAI,EAAE;YACJ,MAAM,EAAQ,sCAAsC;YACpD,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,UAAU,EAAE;YACV,MAAM,EAAQ,6CAA6C;YAC3D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,GAAG,EAAE;YACH,YAAY,EAAG,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE;YAC7C,QAAQ,EAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YAEjD,KAAK,EAAE;gBACL,KAAK,EAAM,IAAI;gBACf,QAAQ,EAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7C,KAAK,EAAM;oBACT,aAAa,EAAS,CAAC,KAAK,CAAC;oBAC7B,mBAAmB,EAAG,KAAK;oBAC3B,GAAG,EAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACzC;aACF;YAED,MAAM,EAAE;gBACN,KAAK,EAAM,IAAI;gBACf,QAAQ,EAAG;oBACT,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;oBAChC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE;iBACjD;gBACD,KAAK,EAAE;oBACL,aAAa,EAAS,CAAC,KAAK,CAAC;oBAC7B,mBAAmB,EAAG,KAAK;oBAC3B,GAAG,EAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACzC;aACF;YAED,IAAI,EAAE;gBACJ,QAAQ,EAAE;oBACR,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;oBAChC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE;iBAC3D;gBAED,UAAU,EAAE;oBACV,KAAK,EAAM,IAAI;oBACf,QAAQ,EAAG;wBACT,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;wBAChC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE;qBACjD;oBACD,KAAK,EAAE;wBACL,aAAa,EAAS,CAAC,KAAK,CAAC;wBAC7B,mBAAmB,EAAG,KAAK;wBAC3B,GAAG,EAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;qBACzC;iBACF;aACF;SACF;KACF;CACoC,CAAC;AAExC,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAC5C,kBAAkB,EAClB,EAAuB,CACxB,CAAC"}