@nocobase/app-plugin-projects 0.0.0-stage → 0.1.0-beta.2

package/dist/shared/issues.d.ts

@@ -0,0 +1,246 @@
+import type { ApprovalRequest } from './approvals.js';
+import type { Attachment } from './attachments.js';
+import type { IssueChecklist } from './checklists.js';
+import type { CommentThread } from './comments.js';
+import type { Color, Page, Priority, UserRef } from './common.js';
+import type { Label } from './labels.js';
+import type { ActivityVia } from './plans.js';
+import type { IssueSubscriber } from './subscriptions.js';
+import type { Blocker, IssueDependency, SubtaskSummary } from './subtasks.js';
+import type { RuleMessage } from './workflows.js';
+/** Every status belongs to one category; rules and reports read the category, never the status key. */
+export type StatusCategory = 'unstarted' | 'started' | 'done' | 'closed';
+export interface StatusDefinition {
+    readonly key: string;
+    readonly name: string;
+    readonly category: StatusCategory;
+    readonly color: Color;
+}
+/**
+ * Who works on an issue: a principal of a kind that may execute issues (`shared/kinds.ts`), a member (`user`) unless
+ * another plugin registered more. The owner is always a member.
+ */
+export interface Executor {
+    /** A kind's key. */
+    readonly type: string;
+    readonly id: string;
+}
+export interface Issue {
+    readonly id: string;
+    readonly number: number;
+    /** `PREFIX-number`, fixed when the issue is created. */
+    readonly identifier: string;
+    readonly title: string;
+    /** Markdown. */
+    readonly description: string;
+    readonly statusKey: string;
+    readonly priority: Priority;
+    /** The accountable person; never empty. */
+    readonly ownerUserId: string;
+    /** Nobody works on it yet when null. */
+    readonly executor: Executor | null;
+    readonly parentIssueId: string | null;
+    /**
+     * The batch among its siblings (0 to 1000): a sub-issue waits until every sibling of a lower stage is finished.
+     * Only sub-issues have one; null takes no part in the ordering.
+     */
+    readonly stage: number | null;
+    readonly projectId: string | null;
+    readonly startDate: string | null;
+    readonly dueDate: string | null;
+    /** Increases with every change; a write must name the revision it read. */
+    readonly revision: number;
+    readonly createdById: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly lastActivityAt: string;
+    /** Set when an administrator deleted the issue; such issues appear only in the deleted list. */
+    readonly deletedAt: string | null;
+}
+export interface IssueRef {
+    readonly id: string;
+    readonly identifier: string;
+    readonly title: string;
+}
+export interface IssueProject {
+    readonly id: string;
+    readonly name: string;
+    readonly leadUserId: string | null;
+}
+export interface IssueListItem extends Issue {
+    readonly owner: UserRef | null;
+    /** The executor's display name. */
+    readonly executorName: string | null;
+    /** With its lead, who may close the issue and change its owner. */
+    readonly project: IssueProject | null;
+    readonly labels: readonly Label[];
+    /** Live sub-issues. */
+    readonly subtaskCount: number;
+    /** Unfinished issues it waits for, those the viewer cannot see included. */
+    readonly blockedCount: number;
+}
+export interface Activity {
+    readonly id: string;
+    /** A kind's key (`shared/kinds.ts`). */
+    readonly actorType: string;
+    readonly actorId: string | null;
+    readonly actorName: string | null;
+    readonly action: string;
+    readonly details: Readonly<Record<string, unknown>>;
+    /** How the person made the change when not by hand in the browser: an agent, a plan, the CLI or an API key. */
+    readonly via: ActivityVia | null;
+    readonly createdAt: string;
+}
+export interface IssueDetail extends IssueListItem {
+    readonly parent: IssueRef | null;
+    /** The statuses of the issue's workflow, in order. */
+    readonly statuses: readonly StatusDefinition[];
+    /** The newest activities, oldest first; `activitiesNextCursor` is the `pageToken` of older ones. */
+    readonly activities: readonly Activity[];
+    readonly activitiesNextCursor: string | null;
+    /** The newest threads, oldest first; `threadsNextCursor` is the `pageToken` of older ones. */
+    readonly threads: readonly CommentThread[];
+    readonly threadsNextCursor: string | null;
+    /** Who follows the issue, in the order they started. */
+    readonly subscribers: readonly IssueSubscriber[];
+    /** The issue's own files, oldest first (its comments carry theirs). */
+    readonly attachments: readonly Attachment[];
+    /** The checklist of the current status, if it has one. */
+    readonly checklist: IssueChecklist | null;
+    /** The status change waiting for approval, if any (one at a time). */
+    readonly pendingApproval: ApprovalRequest | null;
+    /** The last `RECENT_DECIDED_APPROVALS` decided requests, the most recently decided first. */
+    readonly recentApprovals: readonly ApprovalRequest[];
+    /** Live sub-issues, by number. */
+    readonly subtasks: readonly SubtaskSummary[];
+    /** What it waits for, what waits for it, and what is only linked to it; issues the viewer cannot see are left out. */
+    readonly blockedBy: readonly IssueDependency[];
+    readonly blocks: readonly IssueDependency[];
+    readonly relatedTo: readonly IssueDependency[];
+    /** What holds it now, dependencies first, then earlier stages; only issues the viewer can see. */
+    readonly blockers: readonly Blocker[];
+    /** Blockers the viewer cannot see. */
+    readonly hiddenBlockerCount: number;
+}
+/**
+ * `PATCH /api/projects/issues/{issueId}` answers `{ data: UpdateIssueResult }`: with 200, the issue after the change
+ * and no `pendingApproval`; with 202, the issue unchanged and the request that holds the status change for approval
+ * (nothing else in the request is applied then).
+ */
+export interface UpdateIssueResult {
+    readonly issue: Issue;
+    readonly pendingApproval: ApprovalRequest | null;
+}
+export interface BoardColumn {
+    readonly status: StatusDefinition;
+    readonly issues: readonly IssueListItem[];
+    readonly nextCursor: string | null;
+}
+export interface IssueBoard {
+    readonly columns: readonly BoardColumn[];
+}
+export type IssuePage = Page<IssueListItem>;
+export type ActivityPage = Page<Activity>;
+export declare const ISSUE_SORTS: readonly ["updated", "created", "number", "priority"];
+export type IssueSort = (typeof ISSUE_SORTS)[number];
+/**
+ * The issues a service lists. `GET /api/projects/issues` takes the same filters, `deleted=true`, `orderBy` (such as
+ * `updatedAt desc`; see `server/routes/schemas.ts`) for `sort` and `direction`, and `pageSize` and `pageToken` for
+ * `limit` and `cursor`. `GET /api/projects/issues/board` takes the filters and `pageSize` per column.
+ */
+export interface IssueListQuery {
+    readonly statusKey?: string;
+    readonly projectId?: string;
+    readonly ownerUserId?: string;
+    readonly executorId?: string;
+    readonly labelId?: string;
+    /** An issue id, or `none` for top-level issues only. */
+    readonly parentIssueId?: string;
+    /** Matches the title or the identifier. */
+    readonly q?: string;
+    /** Deleted issues instead of live ones (those who may delete issues only). */
+    readonly deleted?: boolean;
+    /** What the list is ordered by; `updated` by default. */
+    readonly sort?: IssueSort;
+    /** `desc` by default: the newest, the highest number, or the most urgent first. */
+    readonly direction?: 'asc' | 'desc';
+    readonly cursor?: string;
+    readonly limit?: number;
+}
+/**
+ * One way to start a new issue (`GET /api/projects/issues/starts`): a status of the workflow, with the label and hint of its
+ * `startOption` rule, or none for the workflow's initial status when no rule offers it.
+ */
+export interface IssueStartOption {
+    readonly status: StatusDefinition;
+    readonly label: RuleMessage | null;
+    readonly hint: RuleMessage | null;
+}
+/**
+ * The ways a new issue may start in a project's workflow: empty while the workflow offers none (the issue starts in
+ * `initialStatus`); otherwise the initial status first, then every status carrying a `startOption` rule, in order.
+ */
+export interface IssueStarts {
+    readonly initialStatus: string;
+    readonly options: readonly IssueStartOption[];
+}
+export interface CreateIssueRequest {
+    readonly title: string;
+    readonly description?: string;
+    /** Defaults to `todo`; a done or closed status is refused. */
+    readonly statusKey?: string;
+    readonly priority?: Priority;
+    /** Defaults to the creator. */
+    readonly ownerUserId?: string;
+    readonly executor?: Executor | null;
+    readonly parentIssueId?: string | null;
+    /** Only with a parent. */
+    readonly stage?: number | null;
+    /** Issues it waits for, by id or identifier (at most `BLOCKED_BY_ON_CREATE_MAX`). */
+    readonly blockedBy?: readonly string[];
+    /** Defaults to the parent's project. */
+    readonly projectId?: string | null;
+    readonly startDate?: string | null;
+    readonly dueDate?: string | null;
+    readonly labelIds?: readonly string[];
+    /** False: an executor of another kind (an agent) is set, but asked not to start work now. */
+    readonly start?: boolean;
+    /**
+     * True: the issue sets its project up (`Project.setupIssueId`), so every issue created in the project after it waits
+     * for it until it is finished. Only in a project the creator manages that has no unfinished setup issue.
+     */
+    readonly projectSetup?: boolean;
+}
+export interface UpdateIssueRequest {
+    /** The revision the change is based on. */
+    readonly revision: number;
+    readonly title?: string;
+    readonly description?: string;
+    readonly statusKey?: string;
+    readonly priority?: Priority;
+    readonly ownerUserId?: string;
+    readonly executor?: Executor | null;
+    /** Removing the parent clears the stage too. */
+    readonly parentIssueId?: string | null;
+    /** Only for a sub-issue. */
+    readonly stage?: number | null;
+    /** A status the new project's workflow lacks must be replaced in the same request. */
+    readonly projectId?: string | null;
+    readonly startDate?: string | null;
+    readonly dueDate?: string | null;
+    /** Replaces the whole set. */
+    readonly labelIds?: readonly string[];
+    /** False: a new executor of another kind (an agent) is set, but asked not to start work now. */
+    readonly start?: boolean;
+}
+export declare const ISSUE_TITLE_MAX = 500;
+export declare const ISSUE_DESCRIPTION_MAX = 200000;
+export declare const ISSUE_PAGE_LIMIT: {
+    readonly default: 50;
+    readonly max: 100;
+};
+export declare const ACTIVITY_PAGE_LIMIT: {
+    readonly default: 50;
+    readonly max: 200;
+};
+//# sourceMappingURL=issues.d.ts.map

package/dist/shared/issues.d.ts.map

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

package/dist/shared/issues.js

@@ -0,0 +1,11 @@
+export const ISSUE_SORTS = [
+    'updated',
+    'created',
+    'number',
+    'priority',
+];
+export const ISSUE_TITLE_MAX = 500;
+export const ISSUE_DESCRIPTION_MAX = 200_000;
+export const ISSUE_PAGE_LIMIT = { default: 50, max: 100 };
+export const ACTIVITY_PAGE_LIMIT = { default: 50, max: 200 };
+//# sourceMappingURL=issues.js.map

package/dist/shared/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../shared/issues.ts"],"names":[],"mappings":"AA6JA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,SAAS;IACT,QAAQ;IACR,UAAU;CACF,CAAC;AAkGX,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AACnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAW,CAAC;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAW,CAAC"}

package/dist/shared/kinds.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Kinds of principal that act on issues or are named in them: `user` (people) and `system` (the plugin's own rules)
+ * are built in; other plugins register more (`projectsKindsToken`), such as an agent runtime registering `agent`.
+ * Executors, activity, mentions, approval requesters and workflow transitions all name a kind by its key.
+ */
+export declare const USER_KIND = "user";
+export declare const SYSTEM_KIND = "system";
+export declare const BUILTIN_KINDS: readonly string[];
+/** Plain text, or an i18n key in a namespace. */
+export type KindTitle = string | {
+    readonly key: string;
+    readonly ns: string;
+};
+/** A kind as the browser sees it (`GET /api/projects/me`). Built-in kinds are titled by the client's own locale. */
+export interface KindInfo {
+    readonly key: string;
+    readonly title: KindTitle | null;
+    /** It may be an issue's executor. */
+    readonly executor: boolean;
+    /** It may be mentioned in Markdown text (`mention://<key>/<id>`). */
+    readonly mentionable: boolean;
+}
+/** A name as an i18n key in a namespace, shown in the viewer's language with `name` as its fallback. */
+export interface NameText {
+    readonly key: string;
+    readonly ns: string;
+}
+/** An executor of another kind the signed-in user may choose (`GET /api/projects/executors`). */
+export interface ExecutorCandidate {
+    /** Its kind's key. */
+    readonly type: string;
+    readonly id: string;
+    readonly name: string;
+    /** Its name in the viewer's language, when its kind ships one (a built-in agent). */
+    readonly nameText?: NameText;
+    /** Something can run its work now (for an agent: a fitting runner is online); unknown when left out. */
+    readonly online?: boolean;
+    /** Work it is doing or has queued. */
+    readonly busy?: number;
+}
+//# sourceMappingURL=kinds.d.ts.map

package/dist/shared/kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../shared/kinds.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,SAAS,SAAS,CAAC;AAChC,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAA6B,CAAC;AAEzE,iDAAiD;AACjD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,oHAAoH;AACpH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,wGAAwG;AACxG,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,iGAAiG;AACjG,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,wGAAwG;IACxG,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/shared/kinds.js

@@ -0,0 +1,9 @@
+/**
+ * Kinds of principal that act on issues or are named in them: `user` (people) and `system` (the plugin's own rules)
+ * are built in; other plugins register more (`projectsKindsToken`), such as an agent runtime registering `agent`.
+ * Executors, activity, mentions, approval requesters and workflow transitions all name a kind by its key.
+ */
+export const USER_KIND = 'user';
+export const SYSTEM_KIND = 'system';
+export const BUILTIN_KINDS = [USER_KIND, SYSTEM_KIND];
+//# sourceMappingURL=kinds.js.map

package/dist/shared/kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.js","sourceRoot":"","sources":["../../shared/kinds.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC;AAChC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAsB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC"}

package/dist/shared/labels.d.ts

@@ -0,0 +1,13 @@
+import type { Color } from './common.js';
+export interface Label {
+    readonly id: string;
+    readonly name: string;
+    readonly color: Color;
+}
+export interface CreateLabelRequest {
+    readonly name: string;
+    readonly color?: Color;
+}
+export type UpdateLabelRequest = Partial<CreateLabelRequest>;
+export declare const LABEL_NAME_MAX = 64;
+//# sourceMappingURL=labels.d.ts.map

package/dist/shared/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../shared/labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE7D,eAAO,MAAM,cAAc,KAAK,CAAC"}

package/dist/shared/labels.js

@@ -0,0 +1,2 @@
+export const LABEL_NAME_MAX = 64;
+//# sourceMappingURL=labels.js.map

package/dist/shared/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../shared/labels.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC"}

package/dist/shared/locales/access.en-US.d.ts

@@ -0,0 +1,189 @@
+/**
+ * The titles this plugin registers with the authorization plugin (`{ key, ns }` descriptors under `access.*`) and the
+ * built-in roles' titles (`roles.*`). The server and the client locales both spread them: the server translates them
+ * for its own messages, and the permission pages translate them in the browser.
+ */
+declare const accessEnUS: {
+    roles: {
+        owner: string;
+        admin: string;
+        member: string;
+    };
+    access: {
+        sections: {
+            projects: string;
+            issues: string;
+            settings: string;
+            members: string;
+        };
+        businesses: {
+            projects: {
+                title: string;
+                description: string;
+                actions: {
+                    view: {
+                        title: string;
+                        description: string;
+                        related: string;
+                        relatedLabel: string;
+                        relatedHint: string;
+                        all: string;
+                    };
+                    create: {
+                        title: string;
+                        description: string;
+                        all: string;
+                    };
+                    manage: {
+                        title: string;
+                        description: string;
+                        related: string;
+                        relatedLabel: string;
+                        relatedHint: string;
+                        all: string;
+                    };
+                    delete: {
+                        title: string;
+                        description: string;
+                        all: string;
+                    };
+                };
+            };
+            issues: {
+                title: string;
+                description: string;
+                actions: {
+                    view: {
+                        title: string;
+                        description: string;
+                        related: string;
+                        relatedLabel: string;
+                        relatedHint: string;
+                        all: string;
+                    };
+                    create: {
+                        title: string;
+                        description: string;
+                        related: string;
+                        relatedLabel: string;
+                        relatedHint: string;
+                        all: string;
+                    };
+                    edit: {
+                        title: string;
+                        description: string;
+                        related: string;
+                        relatedLabel: string;
+                        relatedHint: string;
+                        all: string;
+                    };
+                    comment: {
+                        title: string;
+                        description: string;
+                        related: string;
+                        relatedLabel: string;
+                        relatedHint: string;
+                        all: string;
+                    };
+                    moderateComments: {
+                        title: string;
+                        description: string;
+                        related: string;
+                        relatedLabel: string;
+                        relatedHint: string;
+                        all: string;
+                    };
+                    close: {
+                        title: string;
+                        description: string;
+                        related: string;
+                        relatedLabel: string;
+                        relatedHint: string;
+                        all: string;
+                    };
+                    changeOwner: {
+                        title: string;
+                        description: string;
+                        related: string;
+                        relatedLabel: string;
+                        relatedHint: string;
+                        all: string;
+                    };
+                    delete: {
+                        title: string;
+                        description: string;
+                        all: string;
+                    };
+                };
+            };
+            attachments: {
+                title: string;
+                description: string;
+                actions: {
+                    upload: {
+                        title: string;
+                        description: string;
+                        related: string;
+                        relatedLabel: string;
+                        relatedHint: string;
+                        all: string;
+                    };
+                };
+            };
+        };
+        collections: {
+            pmProjects: string;
+            pmIssues: string;
+        };
+        recordAccess: {
+            visible: string;
+            managed: string;
+        };
+        settings: {
+            pm: {
+                general: string;
+                labels: string;
+                workflows: string;
+                members: string;
+            };
+        };
+        keyScopes: {
+            projects: {
+                title: string;
+                description: string;
+                objects: string;
+            };
+            issues: {
+                title: string;
+                description: string;
+            };
+            settings: {
+                title: string;
+                description: string;
+            };
+        };
+        actions: {
+            view: string;
+            create: string;
+            manage: string;
+            edit: string;
+            close: string;
+            comment: string;
+            moderateComments: string;
+            changeOwner: string;
+            delete: string;
+            upload: string;
+            read: string;
+            update: string;
+            invite: string;
+            assign: string;
+            'define-roles': string;
+        };
+    };
+};
+type Shape<T> = {
+    readonly [K in keyof T]: T[K] extends string ? string : Shape<T[K]>;
+};
+export type AccessLocale = Shape<typeof accessEnUS>;
+export default accessEnUS;
+//# sourceMappingURL=access.en-US.d.ts.map

package/dist/shared/locales/access.en-US.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.en-US.d.ts","sourceRoot":"","sources":["../../../shared/locales/access.en-US.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuLf,CAAC;AAEF,KAAK,KAAK,CAAC,CAAC,IAAI;IACd,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACpE,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAe,UAAU,CAAC"}